[net.sources] Manual page for previously posted 6809 assembler.

jack@vu44.UUCP (Jack Jansen) (04/25/85)

: 'This is a shell archive. Run with the real shell,'
: 'not the seashell. It should extract the following:'
: ' Read_Me_2 a6809.1 a6809.man '
echo x - Read_Me_2
sed 's/^X//' <<'EndOfFile' >Read_Me_2
XSorry, in my previous distribution of the 6809 assembler
Xin Pascal I forgot to include the manual page. Here it is,
Xin -man format as well as formatted (for all those who don't
Xrun unix).
X
XComments, fixes, requests, letters of thanks, flames, etc
Xto a6809-list@htsa.UUCP (or mcvax!vu44!htsa!a6809-list) please.
EndOfFile
echo x - a6809.1
sed 's/^X//' <<'EndOfFile' >a6809.1
X.TH A6809 1 local
X.SH NAME
Xa6809 \- Motorola MC6809 cross-assembler
X.SH SYNOPSIS
X.B a6809
X[
X.B -s
X] [
X.B -nl
X] [
X.B -nh
X] [
X.B -d
X] source
X.SH DESCRIPTION
X.I a6809
Xis a cross-assembler for the Motorola MC6809 microprocessor.
XIt accepts standard Motorola format assembly language as input,
Xand produces Motorola object format (also known as
X.B S1
Xformat) output.
X.br
XAlso, a listing of statements plus generated code is produced.
X.PP
X.I a6809
Xappends the suffix
X.B .src
Xto the name, and checks whether this file exists. If it doesn't,
Xthe given filename is supposed to contain the source.
X.br
XThe object file and listing file are placed on the files
X.IB source .hex
Xand
X.IB source .list ,
Xrespectively.
X.PP
XWith the
X.B -s
Xoption,
X.I a6809
Xproduces an alphabetically sorted symbol table after the
Xlisting.
X.br
XWith the
X.B -nh
Xand
X.B -nl
Xoptions, the hex-output and the listing can be suppressed,
Xrespectively.
X.br
XThe
X.B -d
Xoption is primarily meant for debugging, but can be of general
Xuse in the case of phase errors between pass 1 and 2.
XIf it is specified, a listing is also produced during pass 1.
X.SH DIAGNOSTICS
XErrors are marked by one or more characters printed
X.B before
Xthe line number, on the listing file.
X.br
XThe following codes are defined :
X.nf
X+	Error in increment or decrement.
X/	Divide by zero.
X?	Internal error. This should not occur. Notify jack or
X	haper if it does.
XA	Index register expected after accumulator.
XC	Syntax error in index expression.
XE	Not enough operands.
XG	Number operand expected.
XI	Syntax error in immedeate operand.
XL	Error in label field.
XM	Multiple defined symbol, or phase error.
XN	Error in expression.
XO	Unknown mnemonic.
XQ	Non-terminated string.
XR	Branch-label out of range.
XS	Superfluous information.
XU	Undefined label.
XV	Error in register operand.
X]	Unmatched [ or ].
X.fi
X.SH BUGS
XThe error codes are not very understandable, which is partly due
Xto the fact that the assembler was written in Holland.
X.br
XPC and PCR are synonyms, while Motorola standard is to use PCR for
XPC relative, and PC for PSH and PUL.
X.br
XIf your source filename is 14 characters, some *very* nasty things
Xwill happen to it......
X.br
XProbably other, only they didn't bite us yet.
X.SH FILES
X/usr/lib/a6809prg	The *real* assembler.
X.br
X/usr/etc/a6809:mnemtab	Table with mnemonics and their codes.
X.br
X$BIN/aserr		A (simple) program to show erronuous lines.
X.SH AUTHORS
XJack Jansen (mcvax!vu44!htsa!jack) and
X.br
XHans Pronk (mcvax!vu44!htsa!haper),
X.br
XHogere Technische School "Amsterdam".
EndOfFile
echo x - a6809.man
sed 's/^X//' <<'EndOfFile' >a6809.man
X
X
X
XA6809(1)            UNIX Programmer's Manual             A6809(1)
X
X
X
XNAME
X     a6809 - Motorola MC6809 cross-assembler
X
XSYNOPSIS
X     a6809 [ -s ] [ -nl ] [ -nh ] [ -d ] source
X
XDESCRIPTION
X     a6809 is a cross-assembler for the Motorola MC6809 micropro-
X     cessor.  It accepts standard Motorola format assembly
X     language as input, and produces Motorola object format (also
X     known as S1 format) output.
X     Also, a listing of statements plus generated code is pro-
X     duced.
X
X     a6809 appends the suffix .src to the name, and checks
X     whether this file exists. If it doesn't, the given filename
X     is supposed to contain the source.
X     The object file and listing file are placed on the files
X     _s_o_u_r_c_e.hex and _s_o_u_r_c_e.list, respectively.
X
X     With the -s option, a6809 produces an alphabetically sorted
X     symbol table after the listing.
X     With the -nh and -nl options, the hex-output and the listing
X     can be suppressed, respectively.
X     The -d option is primarily meant for debugging, but can be
X     of general use in the case of phase errors between pass 1
X     and 2.  If it is specified, a listing is also produced dur-
X     ing pass 1.
X
XDIAGNOSTICS
X     Errors are marked by one or more characters printed before
X     the line number, on the listing file.
X     The following codes are defined :
X     +       Error in increment or decrement.
X     /       Divide by zero.
X     ?       Internal error. This should not occur. Notify jack or
X             haper if it does.
X     A       Index register expected after accumulator.
X     C       Syntax error in index expression.
X     E       Not enough operands.
X     G       Number operand expected.
X     I       Syntax error in immedeate operand.
X     L       Error in label field.
X     M       Multiple defined symbol, or phase error.
X     N       Error in expression.
X     O       Unknown mnemonic.
X     Q       Non-terminated string.
X     R       Branch-label out of range.
X     S       Superfluous information.
X     U       Undefined label.
X     V       Error in register operand.
X     ]       Unmatched [ or ].
X
X
X
XPrinted 2/11/85               local                             1
X
X
X
X
X
X
XA6809(1)            UNIX Programmer's Manual             A6809(1)
X
X
X
XBUGS
X     The error codes are not very understandable, which is partly
X     due to the fact that the assembler was written in Holland.
X     PC and PCR are synonyms, while Motorola standard is to use
X     PCR for PC relative, and PC for PSH and PUL.
X     If your source filename is 14 characters, some *very* nasty
X     things will happen to it......
X     Probably other, only they didn't bite us yet.
X
XFILES
X     /usr/lib/a6809prg       The *real* assembler.
X     /usr/etc/a6809:mnemtab  Table with mnemonics and their
X     codes.
X     $BIN/aserr              A (simple) program to show erronuous
X     lines.
X
XAUTHORS
X     Jack Jansen (mcvax!vu44!htsa!jack) and
X     Hans Pronk (mcvax!vu44!htsa!haper),
X     Hogere Technische School "Amsterdam".
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
XPrinted 2/11/85               local                             2
X
X
X
EndOfFile
exit
-- 
	Jack Jansen,     {seismo|philabs|decvax}!mcvax!jack
Notice new, improved, shorter and faster address ^^^^^