Initial revision

diff --git a/ld/README b/ld/README
new file mode 100644 (file)
index 0000000..f6da828
--- /dev/null
+++ b/ld/README
@@ -0,0 +1,51 @@
+This is a BETA release of a completely rewritten GNU linker.
+It is distributed with other "binary utilities" which should
+be in ../binutils.  See ../binutils/README for more general notes,
+including where to send bug reports.
+
+There are many new features of the linker:
+
+* The linker uses a Binary File Descriptor library (../bfd)
+that it uses to read and write object files.  This helps
+insulate the linker itself from the format of object files.
+
+* The linker support a number of different object file
+formats.  It can even handle multiple formats at once:
+Read two input formats and write a third.
+
+* The linker can be configured for cross-linking.
+
+* The linker contains a control language.
+
+* There is a manual.
+
+Installation
+============
+
+See ../binutils/README.
+If you want to make a cross-linker, you may want to specify
+a different search path of -lfoo libraries than the default.
+You can do this by setting the LIB_PATH variable in ./Makefile.
+
+Porting to a new target
+=======================
+
+A new target configuration may need a new linker script (.sc file)
+to specify linker actions (such as the layout of the output).
+See if one of the existing ones are suitable.
+Note that the Makefile generates variants of the standard script
+that are used when ld is passed -r -Ur -N or -n options.
+These variant default scripts are generated from the "master"
+script using sed scripts that may not work in all cases.
+Look at the rules and comments in ld/Makefile.in to make sure
+you stay with the rules.
+
+Otherwise, you may need to add a new "emulation" (a sample of a
+recently added target and emulation is for the SOny 68k News
+family - look for files named *news*).
+
+Also see the notes in ../binutils/README.
+
+Reporting bugs etc
+===========================
+See ../binutils/README.