File: ld86-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 (232 lines) | stat: -rw-r--r-- 6,023 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
Description: Fix various issues in the as86 man page
Author: Bjarni Ingi Gislason <bjarniig@simnet.is>

* .BY doesn't exist, add an AUTHORS section
* Use dashes where appropriate
* Trim trailing white space
* Structure line breaks for better change tracking
* Use italics for placeholders

--- a/man/ld86.1
+++ b/man/ld86.1
@@ -1,27 +1,26 @@
 .TH ld86 1 "Apr, 1997"
-.BY Bruce Evans
 .nh
 .SH NAME
 ld86 \- Linker for as86(1)
 .SH SYNOPSIS
-.BR ld86
-.RB [ -03MNdimrstyz [-]]
-.RB [ -llib_extension ]
-.RB [ -o\ outfile ]
-.RB [ -Ccrtfile ]
-.RB [ -Llibdir ]
-.RB [ -Olibfile ]
-.RB [ -Ttextaddr ]
-.RB [ -Hheapsize ]
-.RB [ -Ddataaddr ]
-.B infile...
+.B ld86
+.RB [ \-03MNdimrstyz [\-]]
+.RB [ \-l\fIlib_extension\fP ]
+.RB [ \-o\ \fIoutfile\fP ]
+.RB [ \-C\fIcrtfile\fP ]
+.RB [ \-L\fIlibdir\fP ]
+.RB [ \-O\fIlibfile\fP ]
+.RB [ \-T\fItextaddr\fP ]
+.RB [ \-H\fIheapsize\fP ]
+.RB [ \-D\fIdataaddr\fP ]
+.B infile ...
 
 .SH DESCRIPTION
 This linker understands only the object files produced by the as86 assembler,
 it can link them into either an impure or a separate I&D executable.
 
 The linking defaults are everything off or none except for
-.B -0
+.B \-0
 and the output file is
 .BR a.out .
 There is
@@ -30,80 +29,82 @@
 
 .SH OPTIONS
 .TP
-.B -0
+.B \-0
 produce header with 16-bit magic
-.\"and use library subdir i86 for -lx
+.\"and use library subdir i86 for \-lx
 .TP
-.B -3
+.B \-3
 produce header with 32-bit magic
-.\"and use library subdir i386 for -lx
+.\"and use library subdir i386 for \-lx
 .TP
-.B -7
+.B \-7
 produce Seventh Edition UNIX a.out header.
 .TP
-.B -d
+.B \-d
 delete the header from the output file, used for MSDOS COM files. As a side
-effect this also includes -s as there's nowhere to put a symbol table.
+effect this also includes \-s as there's nowhere to put a symbol table.
 .TP
-.B -Cx
+.BI \-C x
 add file libdir-from-search/crtx.o to list of files linked
 .TP
-.B -D
+.B \-D
 data base address follows (in format suitable for strtoul)
 .TP
-.B -H
+.B \-H
 the top of heap (initial stack) address (in format suitable for strtoul)
 .TP
-.B -Lx
-add dir name x to the head of the list of library dirs searched
+.BI \-L x
+add dir name
+.I x
+to the head of the list of library dirs searched
 .TP
-.B -M
+.B \-M
 print symbols linked on stdout
 .TP
-.B -N
+.B \-N
 Create a native Linux OMAGIC output file. If the contents are i386 code the
 binary can be either linked by GCC or executed by linux. If the
-.B -z
+.B \-z
 option is also included the linker can generate a QMAGIC executable.
 .TP
-.B -Ox
+.BI \-O x
 add library or object file libdir-from-search/x to list of files linked
 .TP
-.B -T
+.B \-T
 text base address follows (in format suitable for strtoul)
 .TP
-.B -i
+.B \-i
 separate I&D output
 .TP
-.B -lx
+.BI \-l x
 add library libdir-from-search/libx.a to list of files linked
 .TP
-.B -m
+.B \-m
 print modules linked on stdout
 .TP
-.B -o
+.B \-o
 output file name follows
 .TP
-.B -s
+.B \-s
 strip symbols
 .TP
-.B -r
+.B \-r
 Generate a relocatable object from one source object, if the linker is
-given the -N option also the output format will be the hosts native format
+given the \-N option also the output format will be the hosts native format
 if possible.
 .TP
-.B -t
+.B \-t
 trace modules being looked at on stdout
 .TP
-.B -y
+.B \-y
 Alter the symbol tables to add label 'extensions' so that labels with
 more than 8 characters can be stored in elks executables.
 .TP
-.B -z
+.B \-z
 produce "unmapped zero page" or "QMAGIC" executables
 .P
 All the options not taking an argument may be turned off by following the
-option letter by a '-', as for cc1.
+option letter by a '\-', as for cc1.
 .SH PREDEFINED LABELS
 The linker predefines several labels that can be imported into user programs.
 .TP
@@ -118,22 +119,28 @@
 .TP
 .B __segoff
 The offset within the executable file between the start of the text segment
-and the start of the data segment in 16 byte 'paragraphs'. Note this is
+and the start of the data segment in 16 byte 'paragraphs'.
+Note this is
 .B zero
-for impure (tiny model) executables and is adjusted for executables that
-don't start at offset 0 within the segment.
+for impure (tiny model) executables
+and is adjusted for executables
+that don't start at offset 0 within the segment.
 .TP
 .B __segXDL
-The lowest address with data in segment 'X'. (eg __seg0DL is for segment zero
-or the text segment, __seg3DL is for the data segment)
+The lowest address with data in segment 'X'.
+(e.g.\& __seg0DL is for segment zero
+or the text segment,
+__seg3DL is for the data segment)
 The value 'X' is a hex digit.
 .TP
 .B __segXDH
 The top of segment 'X's data area.
 .TP
 .B __segXCL
-The bottom of segment 'X's 'common data' or uninitialized data area. Each 
-segment has both an initialized and uninitialized data area.
+The bottom of segment 'X's 'common data'
+or uninitialized data area.
+Each segment has both an initialized
+and uninitialized data area.
 .TP
 .B __segXCH
 The top of segment 'X's common area.
@@ -144,18 +151,25 @@
 
 .SH HISTORY
 
-The 6809 version does not support -i.
+The 6809 version does not support \-i.
 
 The previous versions of the linker could produce an 8086 executable with
-segments of a size >64k, now only i386 executables may have segments
-this large.
+segments of a size >\~64\~KiB,
+now only i386 executables may have segments this large.
 
 .SH BUGS
 The linker cannot deal with reverse seeks caused by
 .B org
-instructions in the object file. Unlike previous versions the current one
-traps the error rather than trying to fill up the hard disk.
-
-The linker produces a broken a.out object file if given one input and the
-.B -r
+instructions in the object file.
+Unlike previous versions
+the current one traps the error
+rather than trying to fill up the hard disk.
+
+The linker produces a broken a.out object file
+if given one input and the
+.B \-r
 option this is so it is compatible with pre-dev86 versions.
+
+.SH AUTHOR
+.B ld86
+was written by Bruce Evans.