Mercurial > hg > index.cgi
annotate docs/manual/x893.html @ 326:d399df78e1ab
Allow trailing ' or " on ascii constants
Allow for 'c' or "cc" instead of just 'c and "cc for ascii constants. This
adds additional compatibility for some unusual source files while not
causing well formed files to fail.
author | Tom LeMense <tlemense@yahoo.com> |
---|---|
date | Fri, 11 Apr 2014 21:50:47 -0600 |
parents | b30091890d62 |
children |
rev | line source |
---|---|
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <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"> |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
2 <HTML |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
3 ><HEAD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
4 ><TITLE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
5 >Format Specific Linking Notes</TITLE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
6 ><META |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
7 NAME="GENERATOR" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
9 REL="HOME" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
10 TITLE="LW Tool Chain" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
11 HREF="index.html"><LINK |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
12 REL="UP" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
13 TITLE="LWLINK" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
14 HREF="c713.html"><LINK |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
15 REL="PREVIOUS" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
16 TITLE="Linking Scripts" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
17 HREF="x827.html"><LINK |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
18 REL="NEXT" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
19 TITLE="Libraries and LWAR" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
20 HREF="c908.html"></HEAD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
21 ><BODY |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
22 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
23 BGCOLOR="#FFFFFF" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
24 TEXT="#000000" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
25 LINK="#0000FF" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
26 VLINK="#840084" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
27 ALINK="#0000FF" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
28 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
29 CLASS="NAVHEADER" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
30 ><TABLE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
31 SUMMARY="Header navigation table" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
32 WIDTH="100%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
33 BORDER="0" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
34 CELLPADDING="0" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
35 CELLSPACING="0" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
36 ><TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
37 ><TH |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
38 COLSPAN="3" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
39 ALIGN="center" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
40 >LW Tool Chain</TH |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
41 ></TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
42 ><TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
43 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
44 WIDTH="10%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
45 ALIGN="left" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
46 VALIGN="bottom" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
47 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
48 HREF="x827.html" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
49 ACCESSKEY="P" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
50 >Prev</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
51 ></TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
52 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
53 WIDTH="80%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
54 ALIGN="center" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
55 VALIGN="bottom" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
56 >Chapter 4. LWLINK</TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
57 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
58 WIDTH="10%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
59 ALIGN="right" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
60 VALIGN="bottom" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
61 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
62 HREF="c908.html" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
63 ACCESSKEY="N" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
64 >Next</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
65 ></TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
66 ></TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
67 ></TABLE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
68 ><HR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
69 ALIGN="LEFT" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
70 WIDTH="100%"></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
71 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
72 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
73 ><H1 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
74 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
75 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
76 NAME="AEN893" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
77 >4.4. Format Specific Linking Notes</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
78 ></H1 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
79 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
80 >Some formats require special information to be able to generate actual |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
81 binaries. If the specific format you are interested in is not listed in |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
82 this section, then there is nothing special you need to know about to create |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
83 a final binary.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
84 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
85 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
86 ><H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
87 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
88 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
89 NAME="AEN896" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
90 >4.4.1. OS9 Modules</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
91 ></H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
92 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
93 >OS9 modules need to embed several items into the module header. These |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
94 items are the type of module, the langauge of the module, the module |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
95 attributes, the module revision number, the data size (bss), and the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
96 execution offset. These are all either calculated or default to reasonable |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
97 values.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
98 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
99 >The data size is calcuated as the sum of all sections named "bss" or |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
100 ".bss" in all object files that are linked together.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
101 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
102 >The execution offset is calculated from the address of the special |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
103 symbol "__start" which must be an exported (external) symbol in one of the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
104 objects to be linked.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
105 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
106 >The type defaults to "Prgrm" or "Program module". The language |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
107 defaults to "Objct" or "6809 object code". Attributes default to enabling |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
108 the re-entrant flag. And finally, the revision defaults to zero.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
109 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
110 >The embedded module name is the output filename. If the output |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
111 filename includes more than just the filename, this will probably not be |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
112 what you want.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
113 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
114 >The type, language, attributes, revision, and module name can all be |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
115 overridden by providing a special section in exactly one of the object files |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
116 to be linked. This section is called "__os9" (note the two underscores). |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
117 To override the type, language, attributes, or revision values, define a |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
118 non-exported symbol in this section called "type", "lang", "attr", or "rev" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
119 respectively. Any other symbols defined are ignored. To override the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
120 module name, include as the only actual code in the section a NUL terminated |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
121 string (the FCN directive is useful for this). If there is no code in the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
122 section or it beings with a NUL, the default name will be used. Any of the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
123 preceeding that are not defined in the special section will retain their |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
124 default values.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
125 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
126 >The built-in link script for OS9 modules will place the following |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
127 sections, in order, in the module: "code", ".text", "data", ".data". It |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
128 will merge all sections with the name "bss" or ".bss" into the "data" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
129 section. All other section names are ignored. What this means is that you |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
130 must define your data variables in the a section called "bss" or ".bss" even |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
131 though you will be refencing them all as offsets from U. This does have the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
132 unpleasant side effect that all BSS references will end up being 16 bit |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
133 offsets because the assembler cannot know what the offset will be once the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
134 linker is finished its work. Thus, if the tightest possible code is |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
135 required, having LWASM directly output the module is a better choice.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
136 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
137 >While the built-in link script is probably sufficient for most |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
138 purposes, you can provide your own script. If you provide a custom link |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
139 script, you must start your code and data sections at location 000D to |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
140 accommodate the module header. Otherwise, you will have an incorrect |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
141 location for the execution offset. You must use the ENTRY directive in the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
142 script to define the entry point for the module.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
143 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
144 >It should also be obvious from the above that you cannot mix the bss |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
145 (rmb) definitions with the module code when linking separately. Those |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
146 familiar with typical module creation will probably find this an unpleasant |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
147 difference but it is unavoidable.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
148 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
149 >It should also be noted that direct page references should also be |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
150 avoided because you cannot know ahead of time whether the linker is going to |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
151 end up putting a particular variable in the first 256 bytes of the module's |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
152 data space. If, however, you know for certain you will have less than 256 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
153 bytes of defined data space across all of the object files that will be |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
154 linked, you can instead use forced DP addressing for your data addresses |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
155 instead of the ,u notation. When linking with 3rd party libraries, this |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
156 practice should be avoided. Also, when creating libraries, always use the |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
157 offset from U technique.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
158 ></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
159 ></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
160 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
161 CLASS="NAVFOOTER" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
162 ><HR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
163 ALIGN="LEFT" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
164 WIDTH="100%"><TABLE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
165 SUMMARY="Footer navigation table" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
166 WIDTH="100%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
167 BORDER="0" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
168 CELLPADDING="0" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
169 CELLSPACING="0" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
170 ><TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
171 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
172 WIDTH="33%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
173 ALIGN="left" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
174 VALIGN="top" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
175 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
176 HREF="x827.html" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
177 ACCESSKEY="P" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
178 >Prev</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
179 ></TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
180 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
181 WIDTH="34%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
182 ALIGN="center" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
183 VALIGN="top" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
184 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
185 HREF="index.html" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
186 ACCESSKEY="H" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
187 >Home</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
188 ></TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
189 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
190 WIDTH="33%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
191 ALIGN="right" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
192 VALIGN="top" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
193 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
194 HREF="c908.html" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
195 ACCESSKEY="N" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
196 >Next</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
197 ></TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
198 ></TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
199 ><TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
200 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
201 WIDTH="33%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
202 ALIGN="left" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
203 VALIGN="top" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
204 >Linking Scripts</TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
205 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
206 WIDTH="34%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
207 ALIGN="center" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
208 VALIGN="top" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
209 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
210 HREF="c713.html" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
211 ACCESSKEY="U" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
212 >Up</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
213 ></TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
214 ><TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
215 WIDTH="33%" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
216 ALIGN="right" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
217 VALIGN="top" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
218 >Libraries and LWAR</TD |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
219 ></TR |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
220 ></TABLE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
221 ></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
222 ></BODY |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
223 ></HTML |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
224 > |