comparison docs/manual/c1001.html @ 394:fc166b3bbae3

Update manual for recent additions. Document recent feature additions in the manual. Thanks to Erik G <erik@6809.org> for the text for most of these manual additions.
author William Astle <lost@l-w.ca>
date Wed, 15 Jul 2015 19:54:57 -0600
parents
children
comparison
equal deleted inserted replaced
393:f2decd9b276d 394:fc166b3bbae3
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="x986.html"><LINK
15 REL="NEXT"
16 TITLE="Object Files"
17 HREF="c1063.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="x986.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="c1063.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="AEN1001"
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="AEN1005"
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="x986.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="c1063.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 >&nbsp;</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 >