Sanitize slip
[external/binutils.git] / INSTALL
1
2
3                         GNU Development Tools
4                        A Cygnus Support Release
5
6
7 This is the procedure for installing the a29k cross compiler on a
8 sun4.
9
10
11 0. Load the tape.
12
13         If you haven't already done so, load the tape with:
14
15                 tar xvf /dev/rst8
16
17         It doesn't really matter where, so long as the hard disk space
18         is available.  The source for the tools will be loaded into
19         ./devo.
20
21         The installed portion of the tools will take about 4 Mbytes of
22         disk space.  Simply loading the source from tape will require
23         about 32 Mbytes.  Loading the source from tape, building, and
24         installing the tools will need about 46 Mbytes.
25
26         Once loaded:
27
28                 cd devo
29
30 1. Create destdir.
31
32         The default location for all installed files and programs is
33         /usr/local.  We refer to this directory as $(destdir).  You
34         can change $(destdir) only at configuration time.  This is
35         because some tools have hard coded pathnames.
36
37         If you change destdir after the tools are built, you will need
38         to "make clean" and then rebuild.  If you don't understand
39         this, you should probably be using the defaults for now.
40
41         User visible programs are installed in $(destdir)/bin.  All
42         other files and programs are installed in $(destdir)/lib/gcc.
43
44         If $(destdir) does not already exist, create it now.
45
46 2. Configure the source.
47
48         If you use the default $(destdir):
49
50                 configure +host=sun4 a29k
51
52         Otherwise:
53
54                 configure +host=sun4 a29k +destdir=yourdestdir
55
56         where "yourdestdir" should be the name of the $(destdir) that
57         you've chosen.
58
59 3. Build and install the tools.
60
61         Use:
62                 make install
63
64         This will take about 20 minutes on an otherwise unloaded
65         SparcStation 2 with a quick, sync, SCSI hard disk.
66
67 That's it.  You're done.  If you don't plan to hack these sources in
68 the near future, you'll probably want to also:
69
70 4. Remove intermediate object files.
71
72                 make clean
73
74         and perhaps even:
75
76                 cd .. ; rm -rf devo
77
78
79 To use these tools, you will probably want to add $(destdir)/bin to
80 your path.  The tools are named with the standard UNIX(tm) names with
81 "-a29k" appended so as to avoid conflict with native development
82 tools.  That is, nm-a29k, etc.
83
84 For more information on usage, please refer to {LOTS OF VERY PRETTY
85 HARD COPY} (sic) that you should have received with your tape.