aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--binutils/ChangeLog4
-rw-r--r--binutils/README73
2 files changed, 77 insertions, 0 deletions
diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index 8602772..234c12f 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 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.)