6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2024-06-01 13:41:34 +00:00
Code Issues Projects Releases Wiki Activity

Added documentation for setting the file type for fopen.

Browse Source
This commit is contained in:
Bill Chatfield 2017-07-29 01:25:07 -04:00
parent 2c7b757b4c
commit 9d89613bb2
2 changed files with 24 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/apple2.sgml
View File

@ -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>

8
doc/apple2enh.sgml
View File

@ -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>