diff docs/manual.docbook.sgml @ 236:ce1fdc8d6568

Added ability to add padding after a section when linking. Added the ability for lwlink to automatically append padding bytes to the end of a section (once the section instances are merged). This behaviour is controlled by the link script. See the updated documentation for more information.
author William Astle <lost@l-w.ca>
date Sat, 11 Aug 2012 23:29:57 -0600
parents d389adbcc4ab
children 0bc1c88fe776
line wrap: on
line diff
--- a/docs/manual.docbook.sgml	Sat Aug 11 15:18:58 2012 -0600
+++ b/docs/manual.docbook.sgml	Sat Aug 11 23:29:57 2012 -0600
@@ -1984,6 +1984,30 @@
 <variablelist>
 
 <varlistentry>
+<term>sectopt <parameter>section</parameter> padafter <parameter>byte,...</parameter></term>
+<listitem>
+
+<para>
+
+This will cause the linker to append the specified list of byte values
+(specified in hexadecimal separated by commas) to the end of the named
+section.  This is done once all instances of the specified section are
+collected together.  This has no effect if the specified section does not
+appear anywhere in any of the objects specified for linking. 
+
+</para>
+
+<para>
+
+If code depends on the presence of this padding somewhere, it is sufficient
+to include an empty section of the specified name in the object that depends
+on it.
+
+</para>
+
+</listitem>
+
+<varlistentry>
 <term>define basesympat <parameter>string</parameter></term>
 <listitem>
 
@@ -1996,6 +2020,18 @@
 section have been collapsed together.
 
 </para>
+
+<para>
+
+It should be noted that if none of the objects to be linked contains a
+particular section name, there will be no base symbol defined for it, even
+if it is listed explicitly in the link script.  If code depends on the
+presence of these symbols, it is sufficient to include an empty section of
+the specified name in the object that depends on it.
+
+</para>
+
+
 <para>  If the pattern resolves to the same string for multiple
 sections, the results are undefined.
 
@@ -2015,6 +2051,18 @@
 collapsed together.
 
 </para>
+
+<para>
+
+It should be noted that if none of the objects to be linked contains a
+particular section name, there will be no length symbol defined for it, even
+if it is listed explicitly in the link script.  If code depends on the
+presence of these symbols, it is sufficient to include an empty section of
+the specified name in the object that depends on it.
+
+</para>
+
+
 <para>
 If the pattern resolves to the same string for multiple
 sections, the results are undefined.