From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Tue, 20 Mar 2001 10:24:05 +0000 (+0000)
Subject: Describe changed .incbin command
X-Git-Tag: V2.12.0~2923
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=9bf849151dc56657963c66dad154da105422bd3a;p=cc65

Describe changed .incbin command


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

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index 4377bea60..9d1872397 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -1465,11 +1465,22 @@ Here's a list of all control commands and a description, what they do:
 
   Include a file as binary data. The command expects a string argument
   that is the name of a file to include literally in the current segment.
+  In addition to that, a start offset and a size value may be specified,
+  separated by commas. If no size is specified, all of the file from the
+  start offset to end-of-file is used. If no start position is specified
+  either, zero is assume (which means that the whole file is inserted).
 
   Example:
 
   <tscreen><verb>
-   	.incbin		"sprites.dat"
+	; Include whole file
+   	.incbin	 	"sprites.dat"
+
+	; Include file starting at offset 256
+	.incbin		"music.dat", $100
+					     
+	; Read 100 bytes starting at offset 200
+	.incbin		"graphics.dat", 200, 100
   </verb></tscreen>