Mercurial > hg > index.cgi
comparison docs/manual/manual.html @ 533:543b5d1341d2
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 |