Return to README CVS log

Up to [GNU Assembler] / gas

Annotation of gas/README, revision 1.1.1.4

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.4 ! root       40: See the instructions in the Makefile for compiling gas for the Sequent
        !            41: Symmetry (dynix 3.0.12 + others?) or for the HP 9000/300
        !            42: 
1.1.1.3   root       43: If your machine does not have both varargs.h and vfprintf(), but does have
1.1       root       44: _doprnt() add -DNO_VARARGS to the CFLAGS line in the makefile.  If your
1.1.1.3   root       45: machine has neither vfprintf() or _doprnt(), you will have to change
                     46: messages.c in order to get readable error messages from the assembler.
                     47: 
                     48: 
                     49:        REPORTING BUGS IN GAS
                     50: 
1.1.1.4 ! root       51: Bugs in gas should be reported to [email protected]
        !            52: 
1.1.1.3   root       53: If you report a bug in GAS, please remember to include:
                     54: 
                     55: A description of exactly what went wrong.
                     56: 
                     57: The type of machine GAS was running on (VAX, 68020, etc),
                     58: 
                     59: The Operating System GAS was running under.
                     60: 
                     61: The options given to GAS.
                     62: 
                     63: The actual input file that caused the problem.
                     64: 
                     65: It is silly to report a bug in GAS without including an input file for
                     66: GAS.  Don't ask us to generate the file just because you made it from
                     67: files you think we have access to.
                     68: 
                     69: 1. You might be mistaken.
                     70: 2. It might take us a lot of time to install things to regenerate that file.
                     71: 3. We might get a different file from the one you got, and might not see any
                     72: bug.
                     73: 
                     74: To save us these delays and uncertainties, always send the input file
                     75: for the program that failed.
                     76: 
                     77: If the input file is very large, and you are on the internet, you may
                     78: want to make it avaliable for anonymous FTP instead of mailing it.  If you
1.1.1.4 ! root       79: do, include instructions for FTP'ing it in your bug report.

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