From 04834a5cea640ef444264195a7c6aefa2caf8c3f Mon Sep 17 00:00:00 2001
From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Sun, 21 Apr 2002 20:12:06 +0000
Subject: [PATCH] Start to describe the FILES and FORMAT sections

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

diff --git a/doc/ld65.sgml b/doc/ld65.sgml
index 02ba5307f..76416d745 100644
--- a/doc/ld65.sgml
+++ b/doc/ld65.sgml
@@ -605,6 +605,55 @@ name="-S"></tt> option).
 
 
 
+<sect1>The FILES section<p>
+
+The <tt/FILES/ section is used to support other formats than straight binary
+(which is the default, so binary output files do not need an explicit entry
+in the <tt/FILES/ section).
+
+The <tt/FILES/ section lists output files and as only attribute the format of
+each output file. Assigning binary format to the default output file would
+look like this:
+
+<tscreen><verb>
+     	FILES {
+     	    %O: format = bin;
+     	}
+</verb></tscreen>
+
+The only other available output format is the o65 format specified by Andre
+Fachat. It is defined like this:
+
+<tscreen><verb>
+     	FILES {
+     	    %O: format = o65;
+     	}
+</verb></tscreen>
+
+The necessary o65 attributes are defined in a special section labeled
+<tt/FORMAT/.
+
+
+
+<sect1>The FORMAT section<p>
+
+The <tt/FORMAT/ section is used to describe file formats. The default (binary)
+format has currently no attributes, so, while it may be listed in this
+section, the attribute list is empty. The second supported format, o65, has
+several attributes that may be defined here.
+
+<tscreen><verb>
+    FORMATS {
+        o65: os = lunix, version = 0, type = small,
+             import = LUNIXKERNEL,
+             export = _main;
+    }
+</verb></tscreen>
+
+
+
+
+
 <sect1>Features<p>
 
 In addition to the <tt/MEMORY/ and <tt/SEGMENTS/ sections described above, the