xref: /dragonfly/contrib/binutils-2.27/README (revision a9fa9459)
1*a9fa9459Szrj		   README for GNU development tools
2*a9fa9459Szrj
3*a9fa9459SzrjThis directory contains various GNU compilers, assemblers, linkers,
4*a9fa9459Szrjdebuggers, etc., plus their support routines, definitions, and documentation.
5*a9fa9459Szrj
6*a9fa9459SzrjIf you are receiving this as part of a GDB release, see the file gdb/README.
7*a9fa9459SzrjIf with a binutils release, see binutils/README;  if with a libg++ release,
8*a9fa9459Szrjsee libg++/README, etc.  That'll give you info about this
9*a9fa9459Szrjpackage -- supported targets, how to use it, how to report bugs, etc.
10*a9fa9459Szrj
11*a9fa9459SzrjIt is now possible to automatically configure and build a variety of
12*a9fa9459Szrjtools with one command.  To build all of the tools contained herein,
13*a9fa9459Szrjrun the ``configure'' script here, e.g.:
14*a9fa9459Szrj
15*a9fa9459Szrj	./configure
16*a9fa9459Szrj	make
17*a9fa9459Szrj
18*a9fa9459SzrjTo install them (by default in /usr/local/bin, /usr/local/lib, etc),
19*a9fa9459Szrjthen do:
20*a9fa9459Szrj	make install
21*a9fa9459Szrj
22*a9fa9459Szrj(If the configure script can't determine your type of computer, give it
23*a9fa9459Szrjthe name as an argument, for instance ``./configure sun4''.  You can
24*a9fa9459Szrjuse the script ``config.sub'' to test whether a name is recognized; if
25*a9fa9459Szrjit is, config.sub translates it to a triplet specifying CPU, vendor,
26*a9fa9459Szrjand OS.)
27*a9fa9459Szrj
28*a9fa9459SzrjIf you have more than one compiler on your system, it is often best to
29*a9fa9459Szrjexplicitly set CC in the environment before running configure, and to
30*a9fa9459Szrjalso set CC when running make.  For example (assuming sh/bash/ksh):
31*a9fa9459Szrj
32*a9fa9459Szrj	CC=gcc ./configure
33*a9fa9459Szrj	make
34*a9fa9459Szrj
35*a9fa9459SzrjA similar example using csh:
36*a9fa9459Szrj
37*a9fa9459Szrj	setenv CC gcc
38*a9fa9459Szrj	./configure
39*a9fa9459Szrj	make
40*a9fa9459Szrj
41*a9fa9459SzrjMuch of the code and documentation enclosed is copyright by
42*a9fa9459Szrjthe Free Software Foundation, Inc.  See the file COPYING or
43*a9fa9459SzrjCOPYING.LIB in the various directories, for a description of the
44*a9fa9459SzrjGNU General Public License terms under which you can copy the files.
45*a9fa9459Szrj
46*a9fa9459SzrjREPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info
47*a9fa9459Szrjon where and how to report problems.
48