Mercurial > hg > index.cgi

annotate docs/manual/c662.html @ 226:7c2c2239ec9c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Make unicorns grok errors and warnings. Added unicorn formatted error and warning output and also a framework to handle errors which know which character position in the line they occurred in.
author William Astle <lost@l-w.ca>
date Sun, 15 Jul 2012 21:19:43 -0600
parents 1e0a0e6cd918
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
168
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
2 <HTML
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
3 ><HEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
4 ><TITLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
5 >LWLINK</TITLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
6 ><META
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
7 NAME="GENERATOR"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
9 REL="HOME"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
10 TITLE="LW Tool Chain"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
11 HREF="index.html"><LINK
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
12 REL="PREVIOUS"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
13 TITLE="Assembler Modes and Pragmas"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
14 HREF="x584.html"><LINK
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
15 REL="NEXT"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
16 TITLE="Linker Operation"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
17 HREF="x762.html"></HEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
18 ><BODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
19 CLASS="CHAPTER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
20 BGCOLOR="#FFFFFF"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
21 TEXT="#000000"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
22 LINK="#0000FF"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
23 VLINK="#840084"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
24 ALINK="#0000FF"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
25 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
26 CLASS="NAVHEADER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
27 ><TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
28 SUMMARY="Header navigation table"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
29 WIDTH="100%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
30 BORDER="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
31 CELLPADDING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
32 CELLSPACING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
33 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
34 ><TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
35 COLSPAN="3"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
36 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
37 >LW Tool Chain</TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
38 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
39 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
40 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
41 WIDTH="10%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
42 ALIGN="left"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
43 VALIGN="bottom"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
44 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
45 HREF="x584.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
46 ACCESSKEY="P"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
47 >Prev</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
48 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
49 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
50 WIDTH="80%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
51 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
52 VALIGN="bottom"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
53 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
54 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
55 WIDTH="10%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
56 ALIGN="right"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
57 VALIGN="bottom"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
58 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
59 HREF="x762.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
60 ACCESSKEY="N"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
61 >Next</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
62 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
63 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
64 ></TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
65 ><HR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
66 ALIGN="LEFT"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
67 WIDTH="100%"></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
68 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
69 CLASS="CHAPTER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
70 ><H1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
71 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
72 NAME="AEN662"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
73 ></A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
74 >Chapter 4. LWLINK</H1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
75 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
76 >The LWTOOLS linker is called LWLINK. This chapter documents the various features
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
77 of the linker.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
78 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
79 CLASS="SECTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
80 ><H1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
81 CLASS="SECTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
82 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
83 NAME="AEN665"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
84 >4.1. Command Line Options</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
85 ></H1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
86 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
87 >The binary for LWLINK is called "lwlink". Note that the binary is in lower
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
88 case. lwlink takes the following command line arguments.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
89 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
90 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
91 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
92 CLASS="VARIABLELIST"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
93 ><DL
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
94 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
95 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
96 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
97 >--decb</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
98 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
99 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
100 >-b</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
101 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
102 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
103 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
104 >Selects the DECB output format target. This is equivalent to <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
105 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
106 >--format=decb</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
107 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
108 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
109 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
110 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
111 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
112 >--output=FILE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
113 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
114 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
115 >-o FILE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
116 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
117 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
118 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
119 >This option specifies the name of the output file. If not specified, the
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
120 default is <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
121 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
122 >a.out</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
123 >.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
124 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
125 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
126 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
127 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
128 >--format=TYPE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
129 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
130 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
131 >-f TYPE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
132 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
133 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
134 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
135 >This option specifies the output format. Valid values are <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
136 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
137 >decb</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
138 >
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
139 and <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
140 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
141 >raw</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
142 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
143 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
144 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
145 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
146 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
147 >--raw</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
148 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
149 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
150 >-r</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
151 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
152 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
153 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
154 >This option specifies the raw output format.
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
155 It is equivalent to <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
156 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
157 >--format=raw</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
158 >
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
159 and <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
160 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
161 >-f raw</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
162 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
163 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
164 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
165 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
166 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
167 >--script=FILE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
168 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
169 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
170 >-s</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
171 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
172 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
173 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
174 >This option allows specifying a linking script to override the linker's
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
175 built in defaults.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
176 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
177 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
178 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
179 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
180 >--section-base=SECT=BASE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
181 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
182 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
183 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
184 >Cause section SECT to load at base address BASE. This will be prepended
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
185 to the built-in link script. It is ignored if a link script is provided.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
186 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
187 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
188 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
189 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
190 >--map=FILE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
191 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
192 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
193 >-m FILE</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
194 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
195 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
196 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
197 >This will output a description of the link result to FILE.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
198 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
199 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
200 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
201 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
202 >--library=LIBSPEC</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
203 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
204 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
205 >-l LIBSPEC</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
206 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
207 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
208 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
209 >Load a library using the library search path. LIBSPEC will have "lib" prepended
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
210 and ".a" appended.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
211 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
212 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
213 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
214 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
215 >--library-path=DIR</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
216 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
217 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
218 >-L DIR</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
219 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
220 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
221 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
222 >Add DIR to the library search path.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
223 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
224 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
225 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
226 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
227 >--debug</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
228 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
229 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
230 >-d</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
231 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
232 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
233 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
234 >This option increases the debugging level. It is only useful for LWTOOLS
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
235 developers.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
236 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
237 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
238 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
239 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
240 >--help</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
241 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
242 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
243 >-?</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
244 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
245 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
246 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
247 >This provides a listing of command line options and a brief description
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
248 of each.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
249 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
250 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
251 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
252 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
253 >--usage</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
254 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
255 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
256 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
257 >This will display a usage summary
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
258 of each command line option.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
259 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
260 ><DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
261 ><CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
262 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
263 >--version</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
264 >, <CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
265 CLASS="OPTION"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
266 >-V</CODE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
267 ></DT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
268 ><DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
269 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
270 >This will display the version of LWLINK.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
271 ></DD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
272 ></DL
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
273 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
274 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
275 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
276 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
277 CLASS="NAVFOOTER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
278 ><HR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
279 ALIGN="LEFT"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
280 WIDTH="100%"><TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
281 SUMMARY="Footer navigation table"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
282 WIDTH="100%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
283 BORDER="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
284 CELLPADDING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
285 CELLSPACING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
286 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
287 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
288 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
289 ALIGN="left"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
290 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
291 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
292 HREF="x584.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
293 ACCESSKEY="P"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
294 >Prev</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
295 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
296 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
297 WIDTH="34%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
298 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
299 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
300 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
301 HREF="index.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
302 ACCESSKEY="H"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
303 >Home</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
304 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
305 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
306 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
307 ALIGN="right"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
308 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
309 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
310 HREF="x762.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
311 ACCESSKEY="N"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
312 >Next</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
313 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
314 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
315 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
316 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
317 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
318 ALIGN="left"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
319 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
320 >Assembler Modes and Pragmas</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
321 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
322 WIDTH="34%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
323 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
324 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
325 >&nbsp;</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
326 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
327 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
328 ALIGN="right"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
329 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
330 >Linker Operation</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
331 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
332 ></TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
333 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
334 ></BODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
335 ></HTML
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
336 >