Annotation of gas/README, revision 1.1.1.5

1.1.1.3   root        1: This is the beta-test version of the GNU assembler.  (Probably
1.1.1.5 ! root        2: around Version 1.35, but check version.c which gets updated more
        !             3: often than this readme.)
1.1.1.3   root        4: 
                      5: The assembler has been modified to support a feature that is
                      6: potentially useful when assembling compiler output, but which may
                      7: confuse assembly language programmers.  If assembler encounters a
                      8: .word pseudo-op of the form symbol1-symbol2 (the difference of two
                      9: symbols), and the difference of those two symbols will not fit in 16
                     10: bits, the assembler will create a branch around a long jump to
                     11: symbol1, and insert this into the output directly before the next
                     12: label:  The .word will (instead of containing garbage, or giving an
                     13: error message) contain (the address of the long jump)-symbol2.  This
                     14: allows the assembler to assemble jump tables that jump to locations
                     15: very far away into code that works properly.  If the next label is
                     16: more than 32K away from the .word, you lose (silently) RMS claims
                     17: this will never happen.  If the -k option is given, you will get a
                     18: warning message when this happens.
1.1       root       19: 
1.1.1.3   root       20: These files are currently set up to allow you to compile all of the
                     21: versions of the assembler (68020, VAX, ns32k, and i386) on the same
                     22: machine.  To compile the 68020 version, type 'make a68'.  To compile
                     23: the VAX version, type 'make avax'.  To compile the ns32k version,
                     24: type 'make a32k'.  To compile the Intel 80386 version, type 'make
                     25: a386'.  The Makefile contains instructions on how to make one of the
                     26: assemblers compile as the default.
                     27: 
                     28: Before you can compile the 68020 version of the assembler, you must
                     29: make m68k.h be a link to m-sun3.h , m-hpux.h or m-generic.h .  If
                     30: you are on a SUN-3 (or other machine that uses a magic number of
                     31: (2 << 16) | OMAGIC type 'ln -s m-sun3.h m68k.h' else if you are on a
                     32: machine running HP-UX, type 'ln m-hpux.h m689k.h' else type
                     33: 'ln -s m-generic.h m68k.h' If your machine does not support symbolic
                     34: links, omit the '-s'.
1.1       root       35: 
1.1.1.4   root       36: See the instructions in the Makefile for compiling gas for the Sequent
                     37: Symmetry (dynix 3.0.12 + others?) or for the HP 9000/300
                     38: 
1.1.1.3   root       39: If your machine does not have both varargs.h and vfprintf(), but does have
1.1       root       40: _doprnt() add -DNO_VARARGS to the CFLAGS line in the makefile.  If your
1.1.1.3   root       41: machine has neither vfprintf() or _doprnt(), you will have to change
                     42: messages.c in order to get readable error messages from the assembler.
                     43: 
                     44: 
                     45:        REPORTING BUGS IN GAS
                     46: 
1.1.1.5 ! root       47: Bugs in gas should be reported to [email protected]  If you can't
        !            48: get through to prep, try [email protected] or [email protected]
1.1.1.4   root       49: 
1.1.1.3   root       50: If you report a bug in GAS, please remember to include:
                     51: 
                     52: A description of exactly what went wrong.
                     53: 
                     54: The type of machine GAS was running on (VAX, 68020, etc),
                     55: 
                     56: The Operating System GAS was running under.
                     57: 
                     58: The options given to GAS.
                     59: 
                     60: The actual input file that caused the problem.
                     61: 
                     62: It is silly to report a bug in GAS without including an input file for
                     63: GAS.  Don't ask us to generate the file just because you made it from
                     64: files you think we have access to.
                     65: 
                     66: 1. You might be mistaken.
                     67: 2. It might take us a lot of time to install things to regenerate that file.
                     68: 3. We might get a different file from the one you got, and might not see any
                     69: bug.
                     70: 
                     71: To save us these delays and uncertainties, always send the input file
                     72: for the program that failed.
                     73: 
                     74: If the input file is very large, and you are on the internet, you may
                     75: want to make it avaliable for anonymous FTP instead of mailing it.  If you
1.1.1.4   root       76: do, include instructions for FTP'ing it in your bug report.
1.1.1.5 ! root       77: 
        !            78: ------------------------------ README.APOLLO ---------------------------------
        !            79: 
        !            80: The changes required to get the GNU C compiler running on
        !            81: Apollo 68K platforms are available via anonymous ftp from
        !            82: labrea.stanford.edu (36.8.0.47) in the form of a compressed
        !            83: tar file named "/pub/gnu/apollo-gcc-1.37.tar.Z".
        !            84: The size of the file is 84145 bytes.
        !            85: 
        !            86: To build GCC for the Apollo you'll need the virgin FSF
        !            87: distributions of bison-1.03, gas-1.34, and gcc-1.37. They
        !            88: are also on labrea.stanford.edu as well as prep.ai.mit.edu.
        !            89: My changes are to enable gas to produce Apollo COFF object
        !            90: files and allow gcc to parse some of the syntax extensions
        !            91: which appear in Apollo C header files. Note that the
        !            92: COFF encapsulation technique cannot be used on the Apollo.
        !            93:                                                              
        !            94: The tar file should be unpacked in the directory containing
        !            95: the gas-1.34 and gcc-1.37 directories; a few files will be overlaid,
        !            96: and an APOLLO-GCC-README file will appear in the top directory.
        !            97: This file contains detailed instructions on how to proceed.
        !            98: 
        !            99: These changes will only work for SR10.1 or later systems, using
        !           100: the 6.6 or later version of the Apollo C compiler.
        !           101: 
        !           102: If you do not have ftp access, I can mail you the changes in the
        !           103: form of diffs; they are approximately 40K in length. If you request
        !           104: them, be sure to give me a voice phone number so I can contact you
        !           105: in case I can't send you mail; I've had several requests in the
        !           106: past from people I can't contact.
        !           107: 
        !           108: By the way, I'm working on getting the GNU C++ compiler running;
        !           109: there are a couple problems to solve. I hope to be able to announce
        !           110: the Apollo version shortly after the 1.37 version is released.
        !           111: 
        !           112: John Vasta                Hewlett-Packard Apollo Systems Division
        !           113: [email protected]       M.S. CHA-01-LT
        !           114: (508) 256-6600 x6362      300 Apollo Drive, Chelmsford, MA 01824
        !           115: UUCP: {decwrl!decvax, mit-eddie, attunix}!apollo!vasta
        !           116: 
        !           117: ------------------------------------
        !           118: 
        !           119: You might refer others who are interested in a similar thing.
        !           120: 
        !           121: Kevin Buchs    [email protected]
        !           122: 
        !           123: 
        !           124: ------------------------------ README.COFF -----------------------------------
        !           125: 
        !           126: If you have a COFF system, you may wish to aquire
        !           127: 
        !           128:        UUCP: osu-cis!~/gnu/coff/gnu-coff.tar.Z
        !           129:        or
        !           130:        FTP:  tut.cis.ohio-state.edu:/pub/gnu/coff/gnu-coff.tar.Z
        !           131: 
        !           132: These contain patches for gas that will make it produce COFF output.
        !           133: I have never seen these patches, so I don't know how well they work.

unix.superglobalmegacorp.com

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