From 8b279cf1269c6771cd1d3a359e18e0c97236ca8f Mon Sep 17 00:00:00 2001
From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Thu, 22 May 2003 22:35:20 +0000
Subject: [PATCH] Added info about the new OPTIONAL segment attribute.

git-svn-id: svn://svn.cc65.org/cc65/trunk@2166 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/ld65.sgml | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/doc/ld65.sgml b/doc/ld65.sgml
index 24f5082cf..c8e001158 100644
--- 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