bslathi19/cc65
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Some minor clarifications.

Browse Source
This commit is contained in:
Oliver Schmidt
2021-04-05 23:50:07 +02:00
parent 39700c77ee
commit 0ed41db478
2 changed files with 10 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/apple2.sgml
View File

@@ -575,15 +575,13 @@ url="ca65.html" name="assembler manual">.
<tag>Explanation of File Types</tag> <tag>Explanation of File Types</tag>
ProDOS associates a file type and an auxiliary type with each file. ProDOS 8 associates a file type and an auxiliary type with each file.
These type specifications are separate from the file's name, unlike These type specifications are separate from the file's name, unlike
Windows which uses the file name's suffix (a.k.a. Windows which uses the file name's suffix (a.k.a.
extension) to specify the file type. For example, <tt/.exe/, extension) to specify the file type. For example, <tt/.exe/,
<tt/.doc/, or <tt/.bat/. <tt/.doc/, or <tt/.bat/.
The ProDOS low-level The ProDOS 8 Machine-Language Interface (MLI) function for creating a
Machine-Language Interface (MLI) functions for creating and opening file require these types to be specified.
files require these types to be specified. And if they don't match
with the file being opened, the operation may fail.
In contrast, the ISO C function <tt/fopen()/ and the POSIX function In contrast, the ISO C function <tt/fopen()/ and the POSIX function
<tt/open()/ have no parameter to specify either a file type or an <tt/open()/ have no parameter to specify either a file type or an
@@ -606,8 +604,6 @@ url="ca65.html" name="assembler manual">.
The header file <tt/apple2_filetype.h/ also defines many values The header file <tt/apple2_filetype.h/ also defines many values
that can be used to set these variables. It is included in that can be used to set these variables. It is included in
<tt/apple2.h/, which is in turn included in <tt/apple2enh.h/. <tt/apple2.h/, which is in turn included in <tt/apple2enh.h/.
So it isn't necessary to include it directly. Just
include one of <tt/apple2.h/ or <tt/apple2enh.h/.
<tag>Example</tag> <tag>Example</tag>
@@ -624,8 +620,8 @@ url="ca65.html" name="assembler manual">.
carriage return instead of a line-feed (Linux/BSD/MacOS) or carriage return instead of a line-feed (Linux/BSD/MacOS) or
carriage return, line-feed pair (Windows). carriage return, line-feed pair (Windows).
The "sequential" text file terminology is in contrast to a The 'sequential' text file terminology is in contrast to a
"random-access" text file which would 'random-access' text file which would
have a fixed-length, non-zero record length, so that the have a fixed-length, non-zero record length, so that the
file position of any individual record can be calculated. file position of any individual record can be calculated.

14
doc/apple2enh.sgml
View File

@@ -580,15 +580,13 @@ url="ca65.html" name="assembler manual">.
<tag>Explanation of File Types</tag> <tag>Explanation of File Types</tag>
ProDOS associates a file type and an auxiliary type with each file. ProDOS 8 associates a file type and an auxiliary type with each file.
These type specifications are separate from the file's name, unlike These type specifications are separate from the file's name, unlike
Windows which uses the file name's suffix (a.k.a. Windows which uses the file name's suffix (a.k.a.
extension) to specify the file type. For example, <tt/.exe/, extension) to specify the file type. For example, <tt/.exe/,
<tt/.doc/, or <tt/.bat/. <tt/.doc/, or <tt/.bat/.
The ProDOS low-level The ProDOS 8 Machine-Language Interface (MLI) function for creating a
Machine-Language Interface (MLI) functions for creating and opening file require these types to be specified.
files require these types to be specified. And if they don't match
with the file being opened, the operation may fail.
In contrast, the ISO C function <tt/fopen()/ and the POSIX function In contrast, the ISO C function <tt/fopen()/ and the POSIX function
<tt/open()/ have no parameter to specify either a file type or an <tt/open()/ have no parameter to specify either a file type or an
@@ -611,8 +609,6 @@ url="ca65.html" name="assembler manual">.
The header file <tt/apple2_filetype.h/ also defines many values The header file <tt/apple2_filetype.h/ also defines many values
that can be used to set these variables. It is included in that can be used to set these variables. It is included in
<tt/apple2.h/, which is in turn included in <tt/apple2enh.h/. <tt/apple2.h/, which is in turn included in <tt/apple2enh.h/.
So it isn't necessary to include it directly. Just
include one of <tt/apple2.h/ or <tt/apple2enh.h/.
<tag>Example</tag> <tag>Example</tag>
@@ -629,8 +625,8 @@ url="ca65.html" name="assembler manual">.
carriage return instead of a line-feed (Linux/BSD/MacOS) or carriage return instead of a line-feed (Linux/BSD/MacOS) or
carriage return, line-feed pair (Windows). carriage return, line-feed pair (Windows).
The "sequential" text file terminology is in contrast to a The 'sequential' text file terminology is in contrast to a
"random-access" text file which would 'random-access' text file which would
have a fixed-length, non-zero record length, so that the have a fixed-length, non-zero record length, so that the
file position of any individual record can be calculated. file position of any individual record can be calculated.