xref: /openbsd/gnu/usr.bin/binutils-2.17/README (revision 3d8817e4)
1*3d8817e4Smiod		   README for GNU development tools
2*3d8817e4Smiod
3*3d8817e4SmiodThis directory contains various GNU compilers, assemblers, linkers,
4*3d8817e4Smioddebuggers, etc., plus their support routines, definitions, and documentation.
5*3d8817e4Smiod
6*3d8817e4SmiodIf you are receiving this as part of a GDB release, see the file gdb/README.
7*3d8817e4SmiodIf with a binutils release, see binutils/README;  if with a libg++ release,
8*3d8817e4Smiodsee libg++/README, etc.  That'll give you info about this
9*3d8817e4Smiodpackage -- supported targets, how to use it, how to report bugs, etc.
10*3d8817e4Smiod
11*3d8817e4SmiodIt is now possible to automatically configure and build a variety of
12*3d8817e4Smiodtools with one command.  To build all of the tools contained herein,
13*3d8817e4Smiodrun the ``configure'' script here, e.g.:
14*3d8817e4Smiod
15*3d8817e4Smiod	./configure
16*3d8817e4Smiod	make
17*3d8817e4Smiod
18*3d8817e4SmiodTo install them (by default in /usr/local/bin, /usr/local/lib, etc),
19*3d8817e4Smiodthen do:
20*3d8817e4Smiod	make install
21*3d8817e4Smiod
22*3d8817e4Smiod(If the configure script can't determine your type of computer, give it
23*3d8817e4Smiodthe name as an argument, for instance ``./configure sun4''.  You can
24*3d8817e4Smioduse the script ``config.sub'' to test whether a name is recognized; if
25*3d8817e4Smiodit is, config.sub translates it to a triplet specifying CPU, vendor,
26*3d8817e4Smiodand OS.)
27*3d8817e4Smiod
28*3d8817e4SmiodIf you have more than one compiler on your system, it is often best to
29*3d8817e4Smiodexplicitly set CC in the environment before running configure, and to
30*3d8817e4Smiodalso set CC when running make.  For example (assuming sh/bash/ksh):
31*3d8817e4Smiod
32*3d8817e4Smiod	CC=gcc ./configure
33*3d8817e4Smiod	make
34*3d8817e4Smiod
35*3d8817e4SmiodA similar example using csh:
36*3d8817e4Smiod
37*3d8817e4Smiod	setenv CC gcc
38*3d8817e4Smiod	./configure
39*3d8817e4Smiod	make
40*3d8817e4Smiod
41*3d8817e4SmiodMuch of the code and documentation enclosed is copyright by
42*3d8817e4Smiodthe Free Software Foundation, Inc.  See the file COPYING or
43*3d8817e4SmiodCOPYING.LIB in the various directories, for a description of the
44*3d8817e4SmiodGNU General Public License terms under which you can copy the files.
45*3d8817e4Smiod
46*3d8817e4SmiodREPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info
47*3d8817e4Smiodon where and how to report problems.
48