README revision 303975
133965Sjdp		   README for GNU development tools
261843Sobrien
338889SjdpThis directory contains various GNU compilers, assemblers, linkers, 
433965Sjdpdebuggers, etc., plus their support routines, definitions, and documentation.
533965Sjdp
633965SjdpIf you are receiving this as part of a GDB release, see the file gdb/README.
733965SjdpIf with a binutils release, see binutils/README;  if with a libg++ release,
833965Sjdpsee libg++/README, etc.  That'll give you info about this
933965Sjdppackage -- supported targets, how to use it, how to report bugs, etc.
1033965Sjdp
1133965SjdpIt is now possible to automatically configure and build a variety of
1233965Sjdptools with one command.  To build all of the tools contained herein,
1333965Sjdprun the ``configure'' script here, e.g.:
1433965Sjdp
1533965Sjdp	./configure 
1633965Sjdp	make
1733965Sjdp
1833965SjdpTo install them (by default in /usr/local/bin, /usr/local/lib, etc),
1933965Sjdpthen do:
2033965Sjdp	make install
2133965Sjdp
2238889Sjdp(If the configure script can't determine your type of computer, give it
2338889Sjdpthe name as an argument, for instance ``./configure sun4''.  You can
2438889Sjdpuse the script ``config.sub'' to test whether a name is recognized; if
2533965Sjdpit is, config.sub translates it to a triplet specifying CPU, vendor,
2633965Sjdpand OS.)
2733965Sjdp
2833965SjdpIf you have more than one compiler on your system, it is often best to
2938889Sjdpexplicitly set CC in the environment before running configure, and to
3038889Sjdpalso set CC when running make.  For example (assuming sh/bash/ksh):
3138889Sjdp
3238889Sjdp	CC=gcc ./configure
3338889Sjdp	make
3438889Sjdp
3538889SjdpA similar example using csh:
3638889Sjdp
3738889Sjdp	setenv CC gcc
3838889Sjdp	./configure
3938889Sjdp	make
4038889Sjdp
4138889SjdpMuch of the code and documentation enclosed is copyright by
4238889Sjdpthe Free Software Foundation, Inc.  See the file COPYING or
4338889SjdpCOPYING.LIB in the various directories, for a description of the
4438889SjdpGNU General Public License terms under which you can copy the files.
4538889Sjdp
4638889SjdpREPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info
4760484Sobrienon where and how to report problems.
4838889Sjdp