This is NASM V2.0 from 1.Dez.1992



   NASM is a cross-development package for 6502 computers.
   It's target machinery is the Atari 8-bit line, but if I
   understand the AppleII and C64 fileformat correctly. NASM
   ought to be useable for them as well (with some limitations),
   with the use of the the XTRCTBIN program.
   
   Binaries for Atari ST computers ought to be supplied with this
   README file. This development system runs on UNIX, MSDOS (?) 
   and AMIGA as well. (UNIX, as tested on HPUX)

   Read INSTALL for further installation hints. Read CHANGES.TXT for
   info, what has happened since last time.
   Please do also read COPYRITE. 
   If your having problems, cause there are little ^Ms everywhere, 
   then "make -f makefile.nix to_us" first. 
   To get rid of the ^Ms in crlf155.c use gnuemacs or somesuch and
   type the following

   [META]-[X] replace-string [CTRL]-[Q] [CTRL]-[M] [RETURN] [RETURN]

   IF you have lost "localdef.h" somehow, possibly 'coz `make' or
   `portable' killed it use this:
      #define _WORD short
      #define _LONG long
      #define _BYTE char
   as a starting point.

   If you want to port this to some other machine, please
   read HACK.TXT. 
   
   At run-time NASM65 needs at least 300K of RAM. If you
   don't have that much room to spare recompile NASM65
   with smaller parameters in NMALLOC (won't help you
   very much though, excepting the I/O buffer) or a smaller 
   stack size.

   Sorry about the lack of quality in the documentation,
   but you should consider yourself lucky to get anything
   at all (har har). Actually as it now stands NASM65.TXT
   is pretty good for my standards, the rest of the manuals
   are still preliminary.
   The information is not terribly well organized,some
   problems you might encounter may be dealt with somewhere in
   the documentation, where you least expect it. Some
   basic knowledge about compiler/assembler construction may
   not be entirely useless.

   Also my apologies for the less than perfect way the archives
   are put together, but I rather use a dumb make script then
   doing everything by hand.
   
   NASM65 hasn't been as rigidly tested as commercial soft-
   ware (hell I'am doing this alone). I did assemble MYDOS
   f.i. with it (in the runnable mode) and the object files did
   match (except that NASM doesn't generate superflous
   headers). Bugs were mostly found, while writing code and
   wondering, why perfectly reasonable programs crashed. Oh
   well, there are probably some techniques & features, that I
   haven't thought off, which NASM may not handle correctly..
   in this case, please send me a BUG report. A good bug
   report should include:

   Version/Revision[/Platform (porter if possible)]
   .S65 Source, which didn't work. (on DISK or via EMAIL)
   Some comments, why you think this is a BUG. (Like: "it bombed")
   Pricey gifts... (har har)

   The library contains up till now only some coding examples for
   library routines. Some routines may not yet WORK!! 
   The libraries are *primarily* included to show you how to possibly 
   setup your own libraries. If they are of any use to you -fine-, but 
   these are more of a bonus than anything else.

   Please do tell me what you would like to see improved with NASM,
   use the address in the copyrite notice. Some feedback is also very
   helpful to increase likeliness of further improvements.

   I hope you don't mind the occasional rather unconventional
   error message. Take it with humor...

   For those who have a non-language dependent preprocessor, you might
   take a look at NASM.C, which contains an enveloping program for
   one preprocessor and the NASM65 assembler. This hasn't been really
   finished, but should work nevertheless.
   
              Nat!




   A P P E N D I X      ( random thoughts )
   

   P.S.  If there are TABs in the source, they are set at three spaces not
         eight. Output TABs are assumed to be eight!
   

   Documentation is missing for the following files.

   1. CHKFFFF  shows segmentation of regular 8-Bit binaries

   2. XTRCTBIN extracts the raw binary data from  " " "
               with the -f option it fills in the gaps. 
               Non Atari users take note (har har :
                ú With the -c option XTRCTBIN oughta convert the
                  Atari binary into C64 format
                ú With the -a option XTRCTBIN oughta convert the
                  Atari binary into ProDOS AppleII format

   3. DEMAC65  converts a MAC65 tokenized file into ASCII

   4. DISASM65 (uncleverly) disassembles binary load files (.COM),
               bootsectors, SDX drivers and NASM65 object files.

   5. CRLF155  converts ATASCII files to ASCII and backwards and more...
   

   All of the above have a built in verbose help, type f.e.
        CHKFFFF -help.
   Some programs give their version number with -v.
   All of the programs show their compile date with -: