From: Bill Chatfield <bill_chatfield@yahoo.com>
Date: Sat, 29 Jul 2017 05:25:07 +0000 (-0400)
Subject: Added documentation for setting the file type for fopen.
X-Git-Tag: V2.17~109^2~2
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=9d89613bb2d5f8817cd38886acdb92fa1f5395c5;p=cc65

Added documentation for setting the file type for fopen.
---

diff --git a/doc/apple2.sgml b/doc/apple2.sgml
index fe5c98767..4ed2af48c 100644
--- a/doc/apple2.sgml
+++ b/doc/apple2.sgml
@@ -511,11 +511,11 @@ url="ca65.html" name="assembler manual">.
 </descrip><p>
 
 
-<sect1>Specifying ProDOS File Types<p>
+<sect1>Specifying file types for fopen<p>
 
 <descrip>
 
-  <tag>Problem Explanation</tag>
+  <tag>Explanation of File Types</tag>
 
   ProDOS associates a file type and an auxiliary type with each file.
   These type specifications are separate from the file's name, unlike
@@ -531,18 +531,18 @@ url="ca65.html" name="assembler manual">.
   auxiliary type. Therefore, some additional mechanism for specifying
   the file types is needed. 
   
-  <tag>Solution</tag>
+  <tag>Specifying the File Type and Auxiliary Type</tag>
 
   There are two global variables provided that allow the file type
   and auxiliary type to be specified before a call to <tt/fopen()/
   or <tt/open/. They are defined in <tt/apple2_filetype.h/:
 
-  <quote>
+  <tscreen>
   <verb>
   extern unsigned char _filetype;  /* Default: PRODOS_T_BIN */
   extern unsigned int _auxtype;    /* Default: 0            */
   </verb>
-  </quote>  
+  </tscreen>  
 
   The header file <tt/apple2_filetype.h/ also defines many values
   that can be used to set these variables. It is included in
@@ -577,20 +577,25 @@ url="ca65.html" name="assembler manual">.
   <tt/_auxtype/ can also be set to <tt/PRODOS_AUX_T_TXT_SEQ/
   which is defined as zero.
 
-  <quote>
+  <tscreen>
   <verb>
-    #include <stdio.h>
-    #include <string.h>
-    #include <errno.h>
-    #include <apple2.h>
+    &num;include &lt;stdio.h&gt;
+    &num;include &lt;string.h&gt;
+    &num;include &lt;errno.h&gt;
+    &num;include &lt;apple2.h&gt;
+
     void main()
     {
         FILE *out;
         char *name = "MY.FAVS";
 
+        /*-----------------------------*/
+
         _filetype = PRODOS_T_TXT;
         _auxtype  = PRODOS_AUX_T_TXT_SEQ;
 
+        /*-----------------------------*/
+
         if ((out = fopen(name, "w")) != NULL) {
             fputs("Jorah Mormont\r", out);
             fputs("Brienne of Tarth\r", out);
@@ -605,7 +610,7 @@ url="ca65.html" name="assembler manual">.
         }
     }
   </verb>
-  </quote>  
+  </tscreen>  
 
 </descrip><p>
 
diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml
index 5e4626fbc..672f5d6aa 100644
--- a/doc/apple2enh.sgml
+++ b/doc/apple2enh.sgml
@@ -517,6 +517,14 @@ url="ca65.html" name="assembler manual">.
 </descrip><p>
 
 
+<sect1>Specifying file types for fopen<p>
+
+See section 
+<url url="apple2.html#ss9.4" name="Specifying file types for fopen">
+in the apple2 docoumentation.
+
+
+
 
 <sect>License<p>