git.gag.com Git - debian/cc1111/blob - debian/manpages/asxxxx.1

   1 .TH ASxxxx 1
   2 .SH NAME
   3 ASxxxx \- Series of microprocessor cross assemblers for SDCC.
   4 .SH SYNOPSIS
   5 .B asx8051
   6 .I "[options] file1 [file2 file3 ... file6]"
   7 .br
   8 .B as-gbz80
   9 .I "[options] file1 [file2 file3 ... file6]"
  10 .br
  11 .B as-z80
  12 .I "[options] file1 [file2 file3 ... file6]"
  13 .br
  14 .SH WARNING
  15 The information in this man page is an extract from the full
  16 documentation of
  17 .B SDCC\c
  18 \&, and is limited to the meaning of the options.
  19 .PP
  20 For complete and current documentation, refer to the
  21 .B
  22 ASxxxx Cross Assembler Documentation\c
  23 \&, available in /usr/share/doc/sdcc-doc/aslink.
  24 .SH "DESCRIPTION"
  25 The
  26 .B ASxxxx\c
  27 \& assemblers are a series of microprocessor assemblers. Each assembler has
  28 a device specific section.
  29 .PP
  30 .B MCS51\c
  31 \& family is supported by
  32 .B asx8051\c
  33 \&.
  34 .br
  35 .B Z80\c
  36 \&family is supported by
  37 .B as-z80\c
  38 \&.
  39 .br
  40 .B GBZ80\c
  41 \& (GameBoy Z80-like CPU) is supported by
  42 .B as-gbz80\c
  43 \&.
  44 .SH OPTIONS
  45 The  ASxxxx assemblers are command line oriented. The PC assemblers are
  46 started with the appropriate option(s) and file(s) to assemble following
  47 the assembler name.
  48 .TP
  49 .BI "\-d"
  50 decimal listing.
  51 .TP
  52 .BI "\-q"
  53 octal listing.
  54 .TP
  55 .BI "\-x"
  56 hex listing (default)
  57 .PP
  58 The listing radix affects the .lst, .rel, and .sym files.
  59 .TP
  60 .BI "\-j"
  61 add line number and debug information to file.
  62 .TP
  63 .BI "\-g"
  64 undefined symbols made global.
  65 .TP
  66 .BI "\-a"
  67 all user symbols made global.
  68 .TP
  69 .BI "\-l"
  70 create list output file1.lst.
  71 .TP
  72 .BI "\-o"
  73 create object output file1.rel.
  74 .TP
  75 .BI "\-s"
  76 create symbol output file1.sym.
  77 .TP
  78 .BI "\-p"
  79 disable listing pagination.
  80 .TP
  81 .BI "\-w"
  82 wide listing format for symbol table.
  83 .TP
  84 .BI "\-z"
  85 enable case sensitivity for symbols.
  86 .TP
  87 .BI "\-f"
  88 flag relocatable references by ` in the listing file.
  89 .TP
  90 .BI "\-ff"
  91 flag relocatable reference by mode in the listing file.
  92 .PP
  93 The file name for the .lst, .rel, and .sym files is the first file name
  94 specified in the command line. All output files are ascii text files which
  95 may be edited, copied, etc. The output files are the concatenation of all
  96 the input files, if files are to be assembled independently invoke the
  97 assembler for each file.
  98 .PP
  99 The .rel file contains a radix directive so that the linker will use the
 100 proper conversion for this file. Linked files may have different radices.
 101 .PP
 102 If the list
 103 .B (l)\c
 104 \& option is specified without the symbol table
 105 .B (s)\c
 106 \& option, the symbol table is placed at the end of the listing file.
 107 .SH SEE ALSO
 108 sdcc(1), aslink(1), asx8051, as-z80(1), as-gbz80(1).
 109 .SH AUTHOR
 110 This manual page was written by Aurelien Jarno <aurel32@debian.org>,
 111 for the Debian GNU/Linux system (but may be used by others).