diff 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
line wrap: on
line diff
--- a/docs/manual.docbook.sgml	Wed Nov 27 16:01:26 2013 -0700
+++ b/docs/manual.docbook.sgml	Wed Nov 27 16:08:02 2013 -0700
@@ -2114,6 +2114,25 @@
 </varlistentry>
 
 <varlistentry>
+<term>section <parameter>name</parameter> high <parameter>addr</parameter></term>
+<listitem><para>
+
+This causes the section <parameter>name</parameter> to load with its end
+address just below <parameter>addr</parameter>.  Subsequent sections are
+loaded at progressively lower addresses.  This may lead to inefficient file
+encoding for some targets.  As of this writing, it will also almost
+certainly do the wrong thing for a raw target.
+
+</para><para>
+
+This is useful for aligning a block of code with high memory.  As an
+example, if the total size of a section is $100 bytes and a high address of
+$FE00 is specified, the section will actually load at $FD00.
+
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
 <term>section <parameter>name</parameter></term>
 <listitem><para>