File: as86-manpage.patch

package info (click to toggle)
linux86 0.16.21-2
  • links: PTS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,072 kB
  • sloc: ansic: 66,757; asm: 6,154; makefile: 1,374; sh: 703
file content (266 lines) | stat: -rw-r--r-- 7,060 bytes parent folder | download
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.