Return to README CVS log

Up to [Early binutils] / binutils

Annotation of binutils/README, revision 1.1.1.2

1.1       root        1: These files are some GNU utilities for operating on binary files.
                      2: Note that GNU make, which used to be included here, is now distributed
                      3: in a separate tar file.
                      4: 
1.1.1.2 ! root        5: Report bugs in these programs to [email protected] and use
        !             6: the date of the main source file as a "version number" for the
        !             7: program.
        !             8: 
        !             9: Define USG with `-DUSG' when compiling these programs to run on system V.
        !            10: 
        !            11: COFF is not supported, but we do support a way of encapsulating GNU
        !            12: executable files with COFF headers.  Use -DCOFF_ENCAPSULATE when you
        !            13: compile, to enable this feature.
        !            14: 
        !            15: In order to use encapsulation, you must use entirely GNU tools,
        !            16: including these plus GAS, GCC and GDB.  You will need to convert the
        !            17: system libraries to BSD object file format.  Use the shell script
        !            18: libconvert (which uses robotussin) for that.
        !            19: 
        !            20: The GNU version of ld has some interesting features:
1.1       root       21: 
                     22: 1. Undefined and multiply-defined global symbol errors
                     23: are now associated with specific source files and line numbers,
                     24: and printed in a format M-x next-error can parse.
                     25: 
                     26: 2. Normally no output is written if there are serious errors.
                     27: Use the option `-noinhibit-exec' if you want an output file anyway.
                     28: 
                     29: 3. Global symbols can be defined by indirection to other symbols.
                     30: See comments at definition of N_INDR in ld.c
                     31: 
                     32: 4. LD can accumulate sets of related values from all the object files
                     33: that are being linked together, and put them into a vector that can
                     34: be accessed at run time.  Thus, you can arrange for each file to have
                     35: initializations to be run when your `main' function sees fit, without
                     36: having to know the names of all the files that are linked together.
                     37: See comments at definition of N_SETA, etc., in ld.c.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.