Mercurial > hg > index.cgi
comparison docs/manual/c1022.html @ 489:52af0aa54fe5
Update html and pdf documentation in preparation for release
author | William Astle <lost@l-w.ca> |
---|---|
date | Fri, 03 May 2019 20:06:17 -0600 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
488:94bbdb2890b7 | 489:52af0aa54fe5 |
---|---|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> | |
2 <HTML | |
3 ><HEAD | |
4 ><TITLE | |
5 >Libraries and LWAR</TITLE | |
6 ><META | |
7 NAME="GENERATOR" | |
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK | |
9 REL="HOME" | |
10 TITLE="LW Tool Chain" | |
11 HREF="index.html"><LINK | |
12 REL="PREVIOUS" | |
13 TITLE="Format Specific Linking Notes" | |
14 HREF="x1007.html"><LINK | |
15 REL="NEXT" | |
16 TITLE="Object Files" | |
17 HREF="c1084.html"></HEAD | |
18 ><BODY | |
19 CLASS="CHAPTER" | |
20 BGCOLOR="#FFFFFF" | |
21 TEXT="#000000" | |
22 LINK="#0000FF" | |
23 VLINK="#840084" | |
24 ALINK="#0000FF" | |
25 ><DIV | |
26 CLASS="NAVHEADER" | |
27 ><TABLE | |
28 SUMMARY="Header navigation table" | |
29 WIDTH="100%" | |
30 BORDER="0" | |
31 CELLPADDING="0" | |
32 CELLSPACING="0" | |
33 ><TR | |
34 ><TH | |
35 COLSPAN="3" | |
36 ALIGN="center" | |
37 >LW Tool Chain</TH | |
38 ></TR | |
39 ><TR | |
40 ><TD | |
41 WIDTH="10%" | |
42 ALIGN="left" | |
43 VALIGN="bottom" | |
44 ><A | |
45 HREF="x1007.html" | |
46 ACCESSKEY="P" | |
47 >Prev</A | |
48 ></TD | |
49 ><TD | |
50 WIDTH="80%" | |
51 ALIGN="center" | |
52 VALIGN="bottom" | |
53 ></TD | |
54 ><TD | |
55 WIDTH="10%" | |
56 ALIGN="right" | |
57 VALIGN="bottom" | |
58 ><A | |
59 HREF="c1084.html" | |
60 ACCESSKEY="N" | |
61 >Next</A | |
62 ></TD | |
63 ></TR | |
64 ></TABLE | |
65 ><HR | |
66 ALIGN="LEFT" | |
67 WIDTH="100%"></DIV | |
68 ><DIV | |
69 CLASS="CHAPTER" | |
70 ><H1 | |
71 ><A | |
72 NAME="AEN1022" | |
73 ></A | |
74 >Chapter 5. Libraries and LWAR</H1 | |
75 ><P | |
76 >LWTOOLS also includes a tool for managing libraries. These are analogous to | |
77 the static libraries created with the "ar" tool on POSIX systems. Each library | |
78 file contains one or more object files. The linker will treat the object | |
79 files within a library as though they had been specified individually on | |
80 the command line except when resolving external references. External references | |
81 are looked up first within the object files within the library and then, if | |
82 not found, the usual lookup based on the order the files are specified on | |
83 the command line occurs.</P | |
84 ><P | |
85 >The tool for creating these libary files is called LWAR.</P | |
86 ><DIV | |
87 CLASS="SECTION" | |
88 ><H1 | |
89 CLASS="SECTION" | |
90 ><A | |
91 NAME="AEN1026" | |
92 >5.1. Command Line Options</A | |
93 ></H1 | |
94 ><P | |
95 >The binary for LWAR is called "lwar". Note that the binary is in lower | |
96 case. The options lwar understands are listed below. For archive manipulation | |
97 options, the first non-option argument is the name of the archive. All other | |
98 non-option arguments are the names of files to operate on.</P | |
99 ><P | |
100 ></P | |
101 ><DIV | |
102 CLASS="VARIABLELIST" | |
103 ><DL | |
104 ><DT | |
105 ><CODE | |
106 CLASS="OPTION" | |
107 >--add</CODE | |
108 >, <CODE | |
109 CLASS="OPTION" | |
110 >-a</CODE | |
111 ></DT | |
112 ><DD | |
113 ><P | |
114 >This option specifies that an archive is going to have files added to it. | |
115 If the archive does not already exist, it is created. New files are added | |
116 to the end of the archive.</P | |
117 ></DD | |
118 ><DT | |
119 ><CODE | |
120 CLASS="OPTION" | |
121 >--create</CODE | |
122 >, <CODE | |
123 CLASS="OPTION" | |
124 >-c</CODE | |
125 ></DT | |
126 ><DD | |
127 ><P | |
128 >This option specifies that an archive is going to be created and have files | |
129 added to it. If the archive already exists, it is truncated.</P | |
130 ></DD | |
131 ><DT | |
132 ><CODE | |
133 CLASS="OPTION" | |
134 >--merge</CODE | |
135 >, <CODE | |
136 CLASS="OPTION" | |
137 >-m</CODE | |
138 ></DT | |
139 ><DD | |
140 ><P | |
141 >If specified, any files specified to be added to an archive will be checked | |
142 to see if they are archives themselves. If so, their constituent members are | |
143 added to the archive. This is useful for avoiding archives containing archives.</P | |
144 ></DD | |
145 ><DT | |
146 ><CODE | |
147 CLASS="OPTION" | |
148 >--list</CODE | |
149 >, <CODE | |
150 CLASS="OPTION" | |
151 >-l</CODE | |
152 ></DT | |
153 ><DD | |
154 ><P | |
155 >This will display a list of the files contained in the archive.</P | |
156 ></DD | |
157 ><DT | |
158 ><CODE | |
159 CLASS="OPTION" | |
160 >--debug</CODE | |
161 >, <CODE | |
162 CLASS="OPTION" | |
163 >-d</CODE | |
164 ></DT | |
165 ><DD | |
166 ><P | |
167 >This option increases the debugging level. It is only useful for LWTOOLS | |
168 developers.</P | |
169 ></DD | |
170 ><DT | |
171 ><CODE | |
172 CLASS="OPTION" | |
173 >--help</CODE | |
174 >, <CODE | |
175 CLASS="OPTION" | |
176 >-?</CODE | |
177 ></DT | |
178 ><DD | |
179 ><P | |
180 >This provides a listing of command line options and a brief description | |
181 of each.</P | |
182 ></DD | |
183 ><DT | |
184 ><CODE | |
185 CLASS="OPTION" | |
186 >--usage</CODE | |
187 ></DT | |
188 ><DD | |
189 ><P | |
190 >This will display a usage summary | |
191 of each command line option.</P | |
192 ></DD | |
193 ><DT | |
194 ><CODE | |
195 CLASS="OPTION" | |
196 >--version</CODE | |
197 >, <CODE | |
198 CLASS="OPTION" | |
199 >-V</CODE | |
200 ></DT | |
201 ><DD | |
202 ><P | |
203 >This will display the version of LWLINK. | |
204 of each.</P | |
205 ></DD | |
206 ></DL | |
207 ></DIV | |
208 ></DIV | |
209 ></DIV | |
210 ><DIV | |
211 CLASS="NAVFOOTER" | |
212 ><HR | |
213 ALIGN="LEFT" | |
214 WIDTH="100%"><TABLE | |
215 SUMMARY="Footer navigation table" | |
216 WIDTH="100%" | |
217 BORDER="0" | |
218 CELLPADDING="0" | |
219 CELLSPACING="0" | |
220 ><TR | |
221 ><TD | |
222 WIDTH="33%" | |
223 ALIGN="left" | |
224 VALIGN="top" | |
225 ><A | |
226 HREF="x1007.html" | |
227 ACCESSKEY="P" | |
228 >Prev</A | |
229 ></TD | |
230 ><TD | |
231 WIDTH="34%" | |
232 ALIGN="center" | |
233 VALIGN="top" | |
234 ><A | |
235 HREF="index.html" | |
236 ACCESSKEY="H" | |
237 >Home</A | |
238 ></TD | |
239 ><TD | |
240 WIDTH="33%" | |
241 ALIGN="right" | |
242 VALIGN="top" | |
243 ><A | |
244 HREF="c1084.html" | |
245 ACCESSKEY="N" | |
246 >Next</A | |
247 ></TD | |
248 ></TR | |
249 ><TR | |
250 ><TD | |
251 WIDTH="33%" | |
252 ALIGN="left" | |
253 VALIGN="top" | |
254 >Format Specific Linking Notes</TD | |
255 ><TD | |
256 WIDTH="34%" | |
257 ALIGN="center" | |
258 VALIGN="top" | |
259 > </TD | |
260 ><TD | |
261 WIDTH="33%" | |
262 ALIGN="right" | |
263 VALIGN="top" | |
264 >Object Files</TD | |
265 ></TR | |
266 ></TABLE | |
267 ></DIV | |
268 ></BODY | |
269 ></HTML | |
270 > |