Various improvements.

diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index 8602772..234c12f 100644 (file)
--- 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 (file)
index 0000000..7482e0b
--- /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.)