1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266
|
Description: Fix various issues in the as86 man page
Author: Stephen Kitt <skitt@debian.org>
* .BY doesn't exist, add an AUTHORS section
* Use dashes where appropriate
* Trim trailing white space
--- a/man/as86.1
+++ b/man/as86.1
@@ -1,17 +1,16 @@
.TH as86 1 "Mar, 1999"
-.BY Bruce Evans, Robert de Bath
.nh
.SH NAME
as86 \- Assembler for 8086..80386 processors
.SH SYNOPSIS
.B as86
-.RB [ -0123agjuw ]
-.RB [ -lm [ list ]]
-.RB [ -n\ name ]
-.RB [ -o\ obj ]
-.RB [ -b [ bin ]]
-.RB [ -s\ sym ]
-.RB [ -t\ textseg ]
+.RB [ \-0123agjuw ]
+.RB [ \-lm [ list ]]
+.RB [ \-n\ name ]
+.RB [ \-o\ obj ]
+.RB [ \-b [ bin ]]
+.RB [ \-s\ sym ]
+.RB [ \-t\ textseg ]
.B src
.B as86_encap\ prog.s\ prog.v
@@ -26,7 +25,7 @@
The
.B src
-file can be '-' to assemble the standard input.
+file can be '\-' to assemble the standard input.
This assembler can be compiled to support the 6809 cpu and may even work.
@@ -48,51 +47,51 @@
.B prog.s
and
.B prog.v
-arguments can be '-' for standard in/out.
+arguments can be '\-' for standard in/out.
-.\" The 'src' file can be '-' for stdin but ONLY on 'big' machines.
+.\" The 'src' file can be '\-' for stdin but ONLY on 'big' machines.
.SH OPTIONS
.\"defaults (off or none except for these; no output is produced without a flag):
-.\"-03 native
+.\"\-03 native
.\"list stdout (beware of clobbering next arg)
.\"name basename of the source name
.TP
-.B -0
+.B \-0
start with 16-bit code segment, warn for all instructions > 8086
.TP
-.B -1
+.B \-1
start with 16-bit code segment, warn for all instructions > 80186
.TP
-.B -2
+.B \-2
start with 16-bit code segment, warn for all instructions > 80286
.TP
-.B -3
+.B \-3
start with 32-bit code segment, don't warn for any instructions. (not even
486 or 586)
.TP
-.B -a
+.B \-a
enable partial compatibility with Minix asld. This swaps the interpretation
of round brackets and square brackets as well as making alterations to the
code generation and syntax for 16bit jumps and calls. ("jmp @(bx)" is then
a valid instruction)
.TP
-.B -g
+.B \-g
only put global symbols in object or symbol file
.TP
-.B -j
+.B \-j
replace all short jumps with similar 16 or 32 bit jumps, the 16 bit
conditional branches are encoded as a short conditional and a long
unconditional branch.
.TP
-.B -O
+.B \-O
this causes the assembler to add extra passes to try to use forward
-references to reduce the bytes needed for some instructions.
+references to reduce the bytes needed for some instructions.
If the labels move on the last pass the assembler will keep adding passes
until the labels all stabilise (to a maximum of 30 passes)
-It's probably not a good idea to use this with hand written assembler
+It's probably not a good idea to use this with hand written assembler
use the explicit
.B br\ bmi\ bcc
style opcodes for 8086 code or the
@@ -100,39 +99,39 @@
style for conditional i386 instructions and make sure all variables are
defined before they are used.
.TP
-.B -l
+.B \-l
produce list file, filename may follow
.TP
-.B -m
+.B \-m
print macro expansions in listing
.TP
-.B -n
+.B \-n
name of module follows (goes in object instead of source name)
.TP
-.B -o
+.B \-o
produce object file, filename follows
.TP
-.B -b
+.B \-b
produce a raw binary file, filename may follow.
This is a 'raw' binary file with no header, if there's no
-.B -s
+.B \-s
option the file starts at location 0.
.TP
-.B -s
+.B \-s
produce an ASCII symbol file, filename follows.
The format of this table is designed to be easy to parse for encapsulation
and related activities in relation to binary files created with the
-.B -b
+.B \-b
option. If a binary file doesn't start at location zero the first two
items in the table are the start and end addresses of the binary file.
.TP
-.B -u
+.B \-u
assume undefined symbols are imported-with-unspecified segment.
.TP
-.B -w-
+.B \-w\-
allow the assembler to print warning messages.
.TP
-.B -t n
+.B \-t n
move all text segment data in segment n+3.
.P
.SH AS86 SOURCE
@@ -221,7 +220,7 @@
.B .SECT
.TP
.B LOC
-Set numeric segment 0=TEXT, 3=DATA,ROM,BSS, 14=MAX.
+Set numeric segment 0=TEXT, 3=DATA,ROM,BSS, 14=MAX.
The segment order set by the linker is now 0,4,5,6,7,8,9,A,B,C,D,E,1,2,3.
Segment 0 and all segments above 3 are assumed to be text segment.
Note the 64k size restrictions are not imposed for segments 3-14.
@@ -350,7 +349,7 @@
.br
AH AL BH BL CH CL DH DL
.br
-CS DS ES FS GS SS
+CS DS ES FS GS SS
.br
CR0 CR2 CR3 DR0 DR1 DR2 DR3 DR6 DR7
.br
@@ -362,8 +361,8 @@
The 'near and 'far' do not allow multi-segment programming, all 'far'
operations are specified explicitly through the use of the instructions:
jmpi, jmpf, callf, retf, etc. The 'Near' operator can be used to force
-the use of 80386 16bit conditional branches. The 'Dword' and 'word'
-operators can control the size of operands on far jumps and calls.
+the use of 80386 16bit conditional branches. The 'Dword' and 'word'
+operators can control the size of operands on far jumps and calls.
.TP
General instructions.
These are in general the same as the instructions found in any 8086 assembler,
@@ -376,7 +375,7 @@
BR
.TP
Intersegment
-CALLI CALLF JMPI JMPF
+CALLI CALLF JMPI JMPF
.TP
Segment modifier instructions
ESEG FSEG GSEG SSEG
@@ -401,7 +400,7 @@
SETNA SETNAE SETNB SETNBE SETNC SETNE SETNG SETNGE SETNL SETNLE SETNO
SETNP SETNS SETNZ SETO SETP SETPE SETPO SETS SETZ SGDT SHL SHLD SHR SHRD
SIDT SLDT SMSW STC STD STI STOB STOS STOSB STOSD STOSW STOW STR SUB TEST
-VERR VERW WAIT WBINVD WRMSR XADD XCHG XLAT XLATB XOR
+VERR VERW WAIT WBINVD WRMSR XADD XCHG XLAT XLATB XOR
.TP
Floating point
F2XM1 FABS FADD FADDP FBLD FBSTP FCHS FCLEX FCOM FCOMP FCOMPP FCOS
@@ -421,21 +420,21 @@
It can be invoked in a form similar to:
.TP
.B gasp
-.RB [ -a... ]
+.RB [ \-a... ]
.B file.s
.RB [ file2.s ]
.B |
.br
.B as86
.RB [ ... ]
-.B -
-.RB [ -o\ obj ]\ [ -b\ bin ]
+.B \-
+.RB [ \-o\ obj ]\ [ \-b\ bin ]
.P
-Be aware though that Gasp generates an error for
+Be aware though that Gasp generates an error for
.B .org
-commands, if you're not using alternate syntax you can use
+commands, if you're not using alternate syntax you can use
.B org
-instead, otherwise use
+instead, otherwise use
.BR block
and
.BR endb .
@@ -444,18 +443,20 @@
is translated into
.BR .global ,
which forces an import, if you are making a file using
-.B -b
+.B \-b
use
.B public
-or
+or
.B .define
instead.
The GASP list options have no support in as86.
.SH SEE ALSO
-as(1), ld86(1), bcc(1)
+.BR as (1),
+.BR ld86 (1),
+.BR bcc (1)
.SH BUGS
-The 6809 version does not support -0, -3, -a or -j.
+The 6809 version does not support \-0, \-3, \-a or \-j.
If this assembler is compiled with BCC this is classed as a 'small'
compiler, so there is a maximum input line length of 256 characters
@@ -475,3 +476,6 @@
.B org
directive the assembler can generate object files that may break ld86(1).
+.SH AUTHORS
+.B as86
+was written by Bruce Evans and Robert de Bath.
|