Welcome to the revised 8051 assembler README file.

This project was originally written by Ken Stauffer and "Theo".  OSU has
not had any contact with these two origional authors, so it was revised
by Paul Stoffergen in the late 1994 to be more compatable with the
PsudoSam compiler in syntax.

   (added Thursday Jul 13 00:10:49 PDT 1995 -- Paul)
Since yacc  can cause problems, and lots of people are now
using linux, I've included a linux binary and the .c and .h files
made during the build on my system.  Also, object code for paulmon1,
produced from the assembler is now provided, so you can make sure
you get the same results when it runs on your system.  I hope this
helps.  --Paul  <paulece.orst.edu>  http://www.ece.orst.edu/~paul

   (added Thu Oct  5 19:25:35 GMT 1995 -- Paul)
Created a binary for msdos using the go32 package available
from sunsite.unc.edu.  A different makefile (Makefile.msdos) is
included to build the msdos .exe file.  Seems to build ok on linux
using go32... your milage may vary.

To make the assembler, just edit the makefile to uncomment the archecture
that you desire (Linux/Solaris/HPUX) There aren't any big dependancies on
compiler flags, so just use something that works OK. Then just type make.

The executeable is as31. Give it a test by typing

as31 paulmon1.asm

Which should assemble fine.  The paulmon1.obj file produced should
match the paulmon1.hex file included with as31.  BE SURE TO CHECK
that the paulmon1.obj it produces on your system is identical to
the paulmon1.hex that is supplied.

You might want to install the executable somewhere like /usr/local/bin and
the man page in /usr/local/man/man1.

For the msdos version, the .exe file should work like most others.  It
is a 32 bit program and will not run on a 80286 or 8086, and may not
run on some machines for other reasons I'm not aware of.  Please report
any problems to me (paulece.orst.edu).

This code is now distributed from
http://www.ece.orst.edu/~paul/8051-goodies/goodies-index.html

-----------------------------------------------------------------------------
(README written by Mike Miller, millermece.orst.edu)
last updated 5-Oct-95, Paul Stoffregen, paulece.orst.edu

Adopted for Amiga by Jan Uerpmann
The archive contains three executables:
The original as31.linux (linux i386) and as31.exe (MSDOS)
and as31 (AmigaOS).

In the Makefile you will see my rudimentary effort to compile
it for PPC, but libppc-amigaos-bfd.a is not yet as advanced
as I hoped. (I even do not know if it is meant to work as
I thought ;-)

Well, the assembler works quite fast on 68k and 8051 programs
mostly are not that long, are they?

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                18287   36208  50.5% -lh5- 1355 Sep  8  1998 as31/as31
[generic]                 3818   10018  38.1% -lh5- 2a6f Sep  2  1995 as31/as31.1
[generic]                11177   55603  20.1% -lh5- 72ae Oct  5  1995 as31/as31.c
[generic]                65609  138318  47.4% -lh5- 0f7b Oct  5  1995 as31/as31.exe
[generic]                  384     811  47.3% -lh5- eb0d Oct  5  1995 as31/as31.files
[generic]                 1200    3549  33.8% -lh5- ea36 Jul 13  1994 as31/as31.h
[generic]                12407   33796  36.7% -lh5- 6a96 Oct  5  1995 as31/as31.linux
[generic]                 5156   22468  22.9% -lh5- 04f8 Sep  2  1995 as31/as31.y
[generic]                 1490    2907  51.3% -lh5- b2ab Sep  8  1998 as31/as31IntHex.readme
[generic]                 3017    9642  31.3% -lh5- 927a Sep  2  1995 as31/emitter.c
[generic]                 2436    6911  35.2% -lh5- 4df4 Sep 18  1994 as31/lexer.c
[generic]                 1683    4905  34.3% -lh5- ca1a Sep  8  1998 as31/main.c
[generic]                  812    1752  46.3% -lh5- 2d86 Sep  8  1998 as31/Makefile
[generic]                  488     861  56.7% -lh5- a67b Sep  8  1998 as31/Makefile.i386
[generic]                  512     907  56.4% -lh5- c648 Oct  5  1995 as31/Makefile.msdos
[generic]                12330   56894  21.7% -lh5- e22a Aug  9  1994 as31/paulmon1.asm
[generic]                 7951   21356  37.2% -lh5- c137 Sep  2  1995 as31/paulmon1.hex
[generic]                 1128    2198  51.3% -lh5- f532 Oct  5  1995 as31/README
[generic]                  249     378  65.9% -lh5- f8bf Sep  8  1998 as31/README.amiga
[generic]                 3397   11093  30.6% -lh5- 3c4e Aug  9  1994 as31/symbol.c
[generic]                  381    1116  34.1% -lh5- 984f Oct  5  1995 as31/y.tab.h
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        21 files  153912  421691  36.5%            Sep 10  1998