Return to README CVS log

Up to [GNU Assembler] / gas

Annotation of gas/README, revision 1.1.1.3

1.1.1.3 ! root        1: This is the beta-test version of the GNU assembler.  (Probably
        !             2: around Version 1.34, but check version.c which gets updated more
        !             3: often than this readme.)  Please report bugs, missing features, etc
        !             4: to [email protected] (Jay Fenlason) If that address doesn't work,
        !             5: try [email protected] or [email protected] (ONE of
        !             6: them should work.  If you get *REALLY* desparate, try
        !             7: [email protected] )
        !             8: 
        !             9: The assembler has been modified to support a feature that is
        !            10: potentially useful when assembling compiler output, but which may
        !            11: confuse assembly language programmers.  If assembler encounters a
        !            12: .word pseudo-op of the form symbol1-symbol2 (the difference of two
        !            13: symbols), and the difference of those two symbols will not fit in 16
        !            14: bits, the assembler will create a branch around a long jump to
        !            15: symbol1, and insert this into the output directly before the next
        !            16: label:  The .word will (instead of containing garbage, or giving an
        !            17: error message) contain (the address of the long jump)-symbol2.  This
        !            18: allows the assembler to assemble jump tables that jump to locations
        !            19: very far away into code that works properly.  If the next label is
        !            20: more than 32K away from the .word, you lose (silently) RMS claims
        !            21: this will never happen.  If the -k option is given, you will get a
        !            22: warning message when this happens.
1.1       root       23: 
1.1.1.3 ! root       24: These files are currently set up to allow you to compile all of the
        !            25: versions of the assembler (68020, VAX, ns32k, and i386) on the same
        !            26: machine.  To compile the 68020 version, type 'make a68'.  To compile
        !            27: the VAX version, type 'make avax'.  To compile the ns32k version,
        !            28: type 'make a32k'.  To compile the Intel 80386 version, type 'make
        !            29: a386'.  The Makefile contains instructions on how to make one of the
        !            30: assemblers compile as the default.
        !            31: 
        !            32: Before you can compile the 68020 version of the assembler, you must
        !            33: make m68k.h be a link to m-sun3.h , m-hpux.h or m-generic.h .  If
        !            34: you are on a SUN-3 (or other machine that uses a magic number of
        !            35: (2 << 16) | OMAGIC type 'ln -s m-sun3.h m68k.h' else if you are on a
        !            36: machine running HP-UX, type 'ln m-hpux.h m689k.h' else type
        !            37: 'ln -s m-generic.h m68k.h' If your machine does not support symbolic
        !            38: links, omit the '-s'.
1.1       root       39: 
1.1.1.3 ! root       40: If your machine does not have both varargs.h and vfprintf(), but does have
1.1       root       41: _doprnt() add -DNO_VARARGS to the CFLAGS line in the makefile.  If your
1.1.1.3 ! root       42: machine has neither vfprintf() or _doprnt(), you will have to change
        !            43: messages.c in order to get readable error messages from the assembler.
        !            44: 
        !            45: 
        !            46:        REPORTING BUGS IN GAS
        !            47: 
        !            48: If you report a bug in GAS, please remember to include:
        !            49: 
        !            50: A description of exactly what went wrong.
        !            51: 
        !            52: The type of machine GAS was running on (VAX, 68020, etc),
        !            53: 
        !            54: The Operating System GAS was running under.
        !            55: 
        !            56: The options given to GAS.
        !            57: 
        !            58: The actual input file that caused the problem.
        !            59: 
        !            60: It is silly to report a bug in GAS without including an input file for
        !            61: GAS.  Don't ask us to generate the file just because you made it from
        !            62: files you think we have access to.
        !            63: 
        !            64: 1. You might be mistaken.
        !            65: 2. It might take us a lot of time to install things to regenerate that file.
        !            66: 3. We might get a different file from the one you got, and might not see any
        !            67: bug.
        !            68: 
        !            69: To save us these delays and uncertainties, always send the input file
        !            70: for the program that failed.
        !            71: 
        !            72: If the input file is very large, and you are on the internet, you may
        !            73: want to make it avaliable for anonymous FTP instead of mailing it.  If you
        !            74: do, include instructions for FTP'ing it in our bug report.

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