Added info about the new OPTIONAL segment attribute.

git-svn-id: svn://svn.cc65.org/cc65/trunk@2166 b7a2c559-68d2-44c3-8de9-860c34a00d81

diff --git a/doc/ld65.sgml b/doc/ld65.sgml
index 24f5082cfeddc3e443ee7388deda5ce078e5215d..c8e0011587bca3ab99811f34118df243eda9c410 100644 (file)
--- a/doc/ld65.sgml
+++ b/doc/ld65.sgml
@@ -373,10 +373,10 @@ segment, where this attribute is true, the linker will export three symbols.
 
 <tscreen><verb>
        __NAME_LOAD__   This is set to the address where the
-                       segment is loaded.
+                       segment is loaded.
        __NAME_RUN__    This is set to the run address of the
-                       segment. We will cover run addresses
-                       later.
+                       segment. We will cover run addresses
+                       later.
        __NAME_SIZE__   This is set to the segment size.
 </verb></tscreen>
 
@@ -486,10 +486,10 @@ external symbols for the data segment that may be accessed from your code:
 
 <tscreen><verb>
                __DATA_LOAD__   This is set to the address where the segment
-                       is loaded, in this case, it is an address in
-                       ROM2.
+                       is loaded, in this case, it is an address in
+                       ROM2.
        __DATA_RUN__    This is set to the run address of the segment,
-                       in this case, it is an address in RAM2.
+                       in this case, it is an address in RAM2.
        __DATA_SIZE__   This is set to the segment size.
 </verb></tscreen>
 
@@ -594,6 +594,12 @@ or (for the segment definitions from above)
        }
 </verb></tscreen>
 
+To suppress the warning, the linker issues if it encounters a segment that is
+not found in any of the input files, use "<tt/optional=yes/" as additional
+segment attribute. Be careful when using this attribute, because a missing
+segment may be a sign of a problem, and if you're suppressing the warning,
+there is no one left to tell you about it.
+
 File names may be empty, data from segments assigned to a memory area with
 an empty file name is discarded. This is useful, if the a memory area has
 segments assigned that are empty (for example because they are of type