From: uz <uz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Sat, 20 Mar 2010 17:56:27 +0000 (+0000)
Subject: Document the new linker config file string behaviour.
X-Git-Tag: V2.13.3~794
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=38b0dbde849e604fd778333ea4febb54d16404a7;p=cc65

Document the new linker config file string behaviour.


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

diff --git a/doc/ld65.sgml b/doc/ld65.sgml
index 4afaef5c7..8e0b20eb3 100644
--- a/doc/ld65.sgml
+++ b/doc/ld65.sgml
@@ -598,6 +598,19 @@ empty (for example because they are of type bss). In that case, the linker
 will create an empty output file. This may be suppressed by assigning an empty
 file name to that memory area.
 
+The <tt/%O/ sequence is also allowed inside a string. So using
+
+<tscreen><verb>
+      	MEMORY {
+       	    ROM1:  start = $A000, size = $2000, file = "%O-1.bin";
+      	    ROM2:  start = $E000, size = $2000, file = "%O-2.bin";
+      	}
+</verb></tscreen>
+
+would write two files that start with the name of the output file specified on
+the command line, with "-1.bin" and "-2.bin" appended respectively. Because
+'%' is used as an escape char, the sequence "%%" has to be used if a single
+percent sign is required.
 
 <sect1>LOAD and RUN addresses (ROMable code)<p>