From d08a5233d9e40a97789243cd563c5090b1736721 Mon Sep 17 00:00:00 2001 From: Per Bothner Date: Mon, 18 Nov 1991 20:06:48 +0000 Subject: [PATCH] Various improvements. --- binutils/ChangeLog | 4 +++ binutils/README | 73 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 77 insertions(+) create mode 100644 binutils/README diff --git a/binutils/ChangeLog b/binutils/ChangeLog index 86027725e3..234c12fb4f 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -1,3 +1,7 @@ +Mon Nov 18 12:05:37 1991 Per Bothner (bothner at cygnus.com) + + * README: Various improvements. + Sun Nov 17 23:40:59 1991 Per Bothner (bothner at cygnus.com) * Makefile.in: Bump to version 1.92. diff --git a/binutils/README b/binutils/README new file mode 100644 index 0000000000..7482e0b91d --- /dev/null +++ b/binutils/README @@ -0,0 +1,73 @@ +This is a BETA release of a completely rewritten binutils distribution. +The linker (ld) has been moved into a separate directory, +which should be ../ld. Linker-specific notes are in ../ld/README. + +These programs have been tested on various architectures. +Most recently tested are sun3 and sun4s running sunos4, +as well as Sony News running newsos3. +However, since this is a beta release taken directly from an +evolving source tree, there might be some problems. In particular, +the programs have not been ported to as many machines as the +old binutils. There are also features of the old versions +that are missing on the new programs. We would appreciate +patches to make things run on other machines; especially welcome +are fixes for what used to work on the old programs! + +Unpacking and Installation -- quick overview +========================== + +In this release, the binary utilities, the linker, the generic GNU include +files, the BFD ("binary file description") library, and getopt all have +directories of their own underneath the binutils-2.0 directory. +The idea is that a variety of GNU tools can +share a common copy of these things. Configuration scripts and +makefiles exist to cruise up and down this directory tree and +automatically build all the pieces in the right order. + +When you unpack the binutils-2.0.tar.Z file, you'll get a directory called +something like `binutils-2.0', which contains: + + DOC.configure README config/ configure* ld/ + Makefile bfd/ config.status* configure.in libiberty/ + Makefile.in binutils/ config.sub include/ texinfo/ + +To build binutils, you can just do: + + cd binutils-2.0 + ./configure HOSTTYPE (e.g. sun4, decstation) + make + make install # copies the programs files into /usr/local/bin by default. + +This will configure and build all the libraries as well as binutils +and the linker. + +The binutils can be used in a cross-development environment. +The file DOC.configure contains more information. + +Porting +======= +Binutils-2.0 supports many different architectures, but there +are many more not supported, including some that were supported +by earlier versions. We are hoping for volunteers to +improve this situation. + +The major effort in porting binutils to a new host and/or target +architecture involves the BFD library. There is some documentation +in ../bfd/doc. The file ../gdb/doc/gdbint.texinfo (distributed +with gdb-3.2) may also be of help. + +If your system uses some variant of old-style a.out-format, +you can start with a copy of bfd/newsos3.c, and edit it to fit. +(You may also need to tweak bfd/aout-target.h.) +Alternatively, you could use the host-aout.c target. This is a +special kludge that only works for native (non-cross) configurations. + +Reporting bugs +============== +If you can't track down a bug and send suggestions/patches +for fixes, you should probably *not* be using this release. +I cannot work on finding bugs at this stage (except for +Cygnus-supported configurations). But if you have suggestions +or patches, send them to bothner@cygnus.com, for now. +(After the official release, the correct address will +be bug-gnu-utils@ai.mit.edu.)