--- binutils/README	2018/04/24 16:07:00	1.1.1.1
+++ binutils/README	2018/04/24 16:07:01	1.1.1.2
@@ -2,7 +2,22 @@ These files are some GNU utilities for o
 Note that GNU make, which used to be included here, is now distributed
 in a separate tar file.
 
-The GNU version of ld has some interesting features you will notice:
+Report bugs in these programs to bug-gnu-utils@prep.ai.mit.edu and use
+the date of the main source file as a "version number" for the
+program.
+
+Define USG with `-DUSG' when compiling these programs to run on system V.
+
+COFF is not supported, but we do support a way of encapsulating GNU
+executable files with COFF headers.  Use -DCOFF_ENCAPSULATE when you
+compile, to enable this feature.
+
+In order to use encapsulation, you must use entirely GNU tools,
+including these plus GAS, GCC and GDB.  You will need to convert the
+system libraries to BSD object file format.  Use the shell script
+libconvert (which uses robotussin) for that.
+
+The GNU version of ld has some interesting features:
 
 1. Undefined and multiply-defined global symbol errors
 are now associated with specific source files and line numbers,