Imported Debian patch 2.9.0-5

[debian/cc1111] / debian / manpages / asxxxx.1

diff --git a/debian/manpages/asxxxx.1 b/debian/manpages/asxxxx.1
new file mode 100644 (file)
index 0000000..d0e7ee9
--- /dev/null
+++ b/debian/manpages/asxxxx.1
@@ -0,0 +1,111 @@
+.TH ASxxxx 1 
+.SH NAME
+ASxxxx \- Series of microprocessor cross assemblers for SDCC.
+.SH SYNOPSIS
+.B asx8051
+.I "[options] file1 [file2 file3 ... file6]"
+.br
+.B as-gbz80
+.I "[options] file1 [file2 file3 ... file6]"
+.br
+.B as-z80
+.I "[options] file1 [file2 file3 ... file6]"
+.br
+.SH WARNING
+The information in this man page is an extract from the full
+documentation of 
+.B SDCC\c
+\&, and is limited to the meaning of the options.
+.PP
+For complete and current documentation, refer to the
+.B
+ASxxxx Cross Assembler Documentation\c
+\&, available in /usr/share/doc/sdcc-doc/aslink.
+.SH "DESCRIPTION"
+The
+.B ASxxxx\c
+\& assemblers are a series of microprocessor assemblers. Each assembler has
+a device specific section. 
+.PP
+.B MCS51\c
+\& family is supported by 
+.B asx8051\c
+\&.
+.br
+.B Z80\c 
+\&family is supported by
+.B as-z80\c
+\&.
+.br
+.B GBZ80\c
+\& (GameBoy Z80-like CPU) is supported by
+.B as-gbz80\c
+\&.
+.SH OPTIONS
+The  ASxxxx assemblers are command line oriented. The PC assemblers are 
+started with the appropriate option(s) and file(s) to assemble following 
+the assembler name.
+.TP
+.BI "\-d"
+decimal listing.
+.TP
+.BI "\-q"
+octal listing.
+.TP
+.BI "\-x"
+hex listing (default)
+.PP
+The listing radix affects the .lst, .rel, and .sym files.
+.TP
+.BI "\-j"
+add line number and debug information to file.
+.TP
+.BI "\-g"
+undefined symbols made global.
+.TP
+.BI "\-a"
+all user symbols made global.
+.TP
+.BI "\-l"
+create list output file1.lst.
+.TP
+.BI "\-o"
+create object output file1.rel.
+.TP
+.BI "\-s"
+create symbol output file1.sym.
+.TP
+.BI "\-p"
+disable listing pagination.
+.TP
+.BI "\-w"
+wide listing format for symbol table.
+.TP
+.BI "\-z"
+enable case sensitivity for symbols.
+.TP
+.BI "\-f"
+flag relocatable references by ` in the listing file.
+.TP
+.BI "\-ff"
+flag relocatable reference by mode in the listing file.
+.PP
+The file name for the .lst, .rel, and .sym files is the first file name 
+specified in the command line. All output files are ascii text files which 
+may be edited, copied, etc. The output files are the concatenation of all 
+the input files, if files are to be assembled independently invoke the 
+assembler for each file.  
+.PP
+The .rel file contains a radix directive so that the linker will use the 
+proper conversion for this file. Linked files may have different radices.  
+.PP
+If the list 
+.B (l)\c
+\& option is specified without the symbol table
+.B (s)\c
+\& option, the symbol table is placed at the end of the listing file.  
+.SH SEE ALSO
+sdcc(1), aslink(1), asx8051, as-z80(1), as-gbz80(1).
+.SH AUTHOR
+This manual page was written by Aurelien Jarno <aurel32@debian.org>,
+for the Debian GNU/Linux system (but may be used by others).