comparison docs/manual.docbook.sgml @ 316:c4853a54b4a1

Documented new "high" option for link scripts.
author William Astle <lost@l-w.ca>
date Wed, 27 Nov 2013 16:08:02 -0700
parents 155799f6cfa5
children b30091890d62
comparison
equal deleted inserted replaced
315:fcd103148aa6 316:c4853a54b4a1
2108 </para><para> 2108 </para><para>
2109 For the decb target, each "load" entry will cause a new "block" to be 2109 For the decb target, each "load" entry will cause a new "block" to be
2110 output to the binary which will contain the load address. It is legal for 2110 output to the binary which will contain the load address. It is legal for
2111 sections to overlap in this manner - the linker assumes the loader will sort 2111 sections to overlap in this manner - the linker assumes the loader will sort
2112 everything out. 2112 everything out.
2113 </para></listitem>
2114 </varlistentry>
2115
2116 <varlistentry>
2117 <term>section <parameter>name</parameter> high <parameter>addr</parameter></term>
2118 <listitem><para>
2119
2120 This causes the section <parameter>name</parameter> to load with its end
2121 address just below <parameter>addr</parameter>. Subsequent sections are
2122 loaded at progressively lower addresses. This may lead to inefficient file
2123 encoding for some targets. As of this writing, it will also almost
2124 certainly do the wrong thing for a raw target.
2125
2126 </para><para>
2127
2128 This is useful for aligning a block of code with high memory. As an
2129 example, if the total size of a section is $100 bytes and a high address of
2130 $FE00 is specified, the section will actually load at $FD00.
2131
2113 </para></listitem> 2132 </para></listitem>
2114 </varlistentry> 2133 </varlistentry>
2115 2134
2116 <varlistentry> 2135 <varlistentry>
2117 <term>section <parameter>name</parameter></term> 2136 <term>section <parameter>name</parameter></term>