Mercurial > hg > index.cgi

comparison docs/manual/manual.html @ 533:543b5d1341d2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add note to manual about numeric entry addresses in scripts Link scripts require a numeric entry address to begin with a digit. Make a note about that in the manual since hex addresses starting with letters could be mistaken for symbols.
author William Astle <lost@l-w.ca>
date Sat, 14 May 2022 12:57:50 -0600
parents b530ff19f7c0
children 8c6c3363e18e
comparison
equal deleted inserted replaced
532:b8e9ac01deda 533:543b5d1341d2
227 HREF="#AEN942" 227 HREF="#AEN942"
228 >Linking Scripts</A 228 >Linking Scripts</A
229 ></DT 229 ></DT
230 ><DT 230 ><DT
231 >4.4. <A 231 >4.4. <A
232 HREF="#AEN1008" 232 HREF="#AEN1009"
233 >Format Specific Linking Notes</A 233 >Format Specific Linking Notes</A
234 ></DT 234 ></DT
235 ><DD 235 ><DD
236 ><DL 236 ><DL
237 ><DT 237 ><DT
238 >4.4.1. <A 238 >4.4.1. <A
239 HREF="#AEN1011" 239 HREF="#AEN1012"
240 >OS9 Modules</A 240 >OS9 Modules</A
241 ></DT 241 ></DT
242 ></DL 242 ></DL
243 ></DD 243 ></DD
244 ></DL 244 ></DL
245 ></DD 245 ></DD
246 ><DT 246 ><DT
247 >5. <A 247 >5. <A
248 HREF="#AEN1023" 248 HREF="#AEN1024"
249 >Libraries and LWAR</A 249 >Libraries and LWAR</A
250 ></DT 250 ></DT
251 ><DD 251 ><DD
252 ><DL 252 ><DL
253 ><DT 253 ><DT
254 >5.1. <A 254 >5.1. <A
255 HREF="#AEN1027" 255 HREF="#AEN1028"
256 >Command Line Options</A 256 >Command Line Options</A
257 ></DT 257 ></DT
258 ></DL 258 ></DL
259 ></DD 259 ></DD
260 ><DT 260 ><DT
272 ><B 272 ><B
273 >List of Tables</B 273 >List of Tables</B
274 ></DT 274 ></DT
275 ><DT 275 ><DT
276 >6-1. <A 276 >6-1. <A
277 HREF="#AEN1110" 277 HREF="#AEN1111"
278 >Object File Term Types</A 278 >Object File Term Types</A
279 ></DT 279 ></DT
280 ><DT 280 ><DT
281 >6-2. <A 281 >6-2. <A
282 HREF="#AEN1140" 282 HREF="#AEN1141"
283 >Object File Operator Numbers</A 283 >Object File Operator Numbers</A
284 ></DT 284 ></DT
285 ></DL 285 ></DL
286 ></DIV 286 ></DIV
287 ><DIV 287 ><DIV
3166 This has no effect for targets that do not encode the entry point into the 3166 This has no effect for targets that do not encode the entry point into the
3167 resulting file. If not specified, the entry point is assumed to be address 0 3167 resulting file. If not specified, the entry point is assumed to be address 0
3168 which is probably not what you want. The default link scripts for targets 3168 which is probably not what you want. The default link scripts for targets
3169 that support this directive automatically starts at the beginning of the 3169 that support this directive automatically starts at the beginning of the
3170 first section (usually "init" or "code") that is emitted in the binary.</P 3170 first section (usually "init" or "code") that is emitted in the binary.</P
3171 ><P
3172 >Note that if you use a numeric value here, you will need to ensure
3173 it starts with a digit. That may mean adding a leading zero.</P
3171 ></DD 3174 ></DD
3172 ><DT 3175 ><DT
3173 >pad <CODE 3176 >pad <CODE
3174 CLASS="PARAMETER" 3177 CLASS="PARAMETER"
3175 >size</CODE 3178 >size</CODE
3188 ><DIV 3191 ><DIV
3189 CLASS="SECTION" 3192 CLASS="SECTION"
3190 ><HR><H2 3193 ><HR><H2
3191 CLASS="SECTION" 3194 CLASS="SECTION"
3192 ><A 3195 ><A
3193 NAME="AEN1008" 3196 NAME="AEN1009"
3194 >4.4. Format Specific Linking Notes</A 3197 >4.4. Format Specific Linking Notes</A
3195 ></H2 3198 ></H2
3196 ><P 3199 ><P
3197 >Some formats require special information to be able to generate actual 3200 >Some formats require special information to be able to generate actual
3198 binaries. If the specific format you are interested in is not listed in 3201 binaries. If the specific format you are interested in is not listed in
3201 ><DIV 3204 ><DIV
3202 CLASS="SECTION" 3205 CLASS="SECTION"
3203 ><HR><H3 3206 ><HR><H3
3204 CLASS="SECTION" 3207 CLASS="SECTION"
3205 ><A 3208 ><A
3206 NAME="AEN1011" 3209 NAME="AEN1012"
3207 >4.4.1. OS9 Modules</A 3210 >4.4.1. OS9 Modules</A
3208 ></H3 3211 ></H3
3209 ><P 3212 ><P
3210 >OS9 modules need to embed several items into the module header. These 3213 >OS9 modules need to embed several items into the module header. These
3211 items are the type of module, the langauge of the module, the module 3214 items are the type of module, the langauge of the module, the module
3277 ></DIV 3280 ></DIV
3278 ><DIV 3281 ><DIV
3279 CLASS="CHAPTER" 3282 CLASS="CHAPTER"
3280 ><HR><H1 3283 ><HR><H1
3281 ><A 3284 ><A
3282 NAME="AEN1023" 3285 NAME="AEN1024"
3283 ></A 3286 ></A
3284 >Chapter 5. Libraries and LWAR</H1 3287 >Chapter 5. Libraries and LWAR</H1
3285 ><P 3288 ><P
3286 >LWTOOLS also includes a tool for managing libraries. These are analogous to 3289 >LWTOOLS also includes a tool for managing libraries. These are analogous to
3287 the static libraries created with the "ar" tool on POSIX systems. Each library 3290 the static libraries created with the "ar" tool on POSIX systems. Each library
3296 ><DIV 3299 ><DIV
3297 CLASS="SECTION" 3300 CLASS="SECTION"
3298 ><HR><H2 3301 ><HR><H2
3299 CLASS="SECTION" 3302 CLASS="SECTION"
3300 ><A 3303 ><A
3301 NAME="AEN1027" 3304 NAME="AEN1028"
3302 >5.1. Command Line Options</A 3305 >5.1. Command Line Options</A
3303 ></H2 3306 ></H2
3304 ><P 3307 ><P
3305 >The binary for LWAR is called "lwar". Note that the binary is in lower 3308 >The binary for LWAR is called "lwar". Note that the binary is in lower
3306 case. The options lwar understands are listed below. For archive manipulation 3309 case. The options lwar understands are listed below. For archive manipulation
3497 followed by any data required by the term. Then end of the list is flagged 3500 followed by any data required by the term. Then end of the list is flagged
3498 by a NULL expression (only an end of expression term).</P 3501 by a NULL expression (only an end of expression term).</P
3499 ><DIV 3502 ><DIV
3500 CLASS="TABLE" 3503 CLASS="TABLE"
3501 ><A 3504 ><A
3502 NAME="AEN1110" 3505 NAME="AEN1111"
3503 ></A 3506 ></A
3504 ><P 3507 ><P
3505 ><B 3508 ><B
3506 >Table 6-1. Object File Term Types</B 3509 >Table 6-1. Object File Term Types</B
3507 ></P 3510 ></P
3569 allows local symbols that are not exported to have the same names as 3572 allows local symbols that are not exported to have the same names as
3570 exported symbols or external references.</P 3573 exported symbols or external references.</P
3571 ><DIV 3574 ><DIV
3572 CLASS="TABLE" 3575 CLASS="TABLE"
3573 ><A 3576 ><A
3574 NAME="AEN1140" 3577 NAME="AEN1141"
3575 ></A 3578 ></A
3576 ><P 3579 ><P
3577 ><B 3580 ><B
3578 >Table 6-2. Object File Operator Numbers</B 3581 >Table 6-2. Object File Operator Numbers</B
3579 ></P 3582 ></P