From de7677ea16da146c4a7a1ca8c684681215f0adf0 Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 16:33:52 +0200 Subject: [PATCH 1/7] add sort-as IDs to 2F.4310 --- .../Memory/INT 2F4310 Cloaking REALMODE API.txt | 4 ++-- ...XTENDED MEMORY SPECIFICATION XMS v2 GET DRIVER ADDRESS.txt | 4 ++-- .../INT 2F4310 Helix Netroom RM386 v600 XMS EXTENSIONS.txt | 4 ++-- .../Memory/INT 2F4310 NEC PC9800 XMZ PRIVATE API.txt | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Cloaking REALMODE API.txt b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Cloaking REALMODE API.txt index 2cc0fac8e..652131f77 100644 --- a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Cloaking REALMODE API.txt +++ b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Cloaking REALMODE API.txt @@ -1,5 +1,5 @@ -------------------------------------------------------------------------------- - Unique ID: 2F4310 + Unique ID: 2F4310-sort-as-2F4310Cloaking Category: m memory management Flag: n/a -------------------------------------------------------------------------------- @@ -74,4 +74,4 @@ Return: via 32-bit FAR return Note: the initialization function may call any protected-mode Cloaking service; it should store the values of DS, ES, and GS for future reference - + diff --git a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 EXTENDED MEMORY SPECIFICATION XMS v2 GET DRIVER ADDRESS.txt b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 EXTENDED MEMORY SPECIFICATION XMS v2 GET DRIVER ADDRESS.txt index 7bdcb8d5c..ff7d31b53 100644 --- a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 EXTENDED MEMORY SPECIFICATION XMS v2 GET DRIVER ADDRESS.txt +++ b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 EXTENDED MEMORY SPECIFICATION XMS v2 GET DRIVER ADDRESS.txt @@ -1,5 +1,5 @@ -------------------------------------------------------------------------------- - Unique ID: 2F4310 + Unique ID: 2F4310-sort-as-2F4310++ Category: m memory management Flag: n/a -------------------------------------------------------------------------------- @@ -357,4 +357,4 @@ Offset Size Description (Table 02777) 02h DWORD handle size 06h DWORD handle physical address (only valid if lock count nonzero) SeeAlso: #02747,#02762 - + diff --git a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Helix Netroom RM386 v600 XMS EXTENSIONS.txt b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Helix Netroom RM386 v600 XMS EXTENSIONS.txt index 7269da9a7..6d25cb5a3 100644 --- a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Helix Netroom RM386 v600 XMS EXTENSIONS.txt +++ b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 Helix Netroom RM386 v600 XMS EXTENSIONS.txt @@ -1,5 +1,5 @@ -------------------------------------------------------------------------------- - Unique ID: 2F4310 + Unique ID: 2F4310-sort-as-2F4310HelixNetroom Category: m memory management Flag: n/a -------------------------------------------------------------------------------- @@ -51,4 +51,4 @@ Call the Netroom RM386 v6.00 "Get all XMS handles info" function with: Return: AX = 0001h (success) DX = current number of allocated XMS handles SeeAlso: #02785,#02771 - + diff --git a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 NEC PC9800 XMZ PRIVATE API.txt b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 NEC PC9800 XMZ PRIVATE API.txt index b477ee9c0..4bfee97ac 100644 --- a/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 NEC PC9800 XMZ PRIVATE API.txt +++ b/source/Interrupt List/INT 2F Multiplex/Memory/INT 2F4310 NEC PC9800 XMZ PRIVATE API.txt @@ -1,5 +1,5 @@ -------------------------------------------------------------------------------- - Unique ID: 2F4310 + Unique ID: 2F4310-sort-as-2F4310NEC-PC9800 Category: m memory management Flag: n/a -------------------------------------------------------------------------------- @@ -42,4 +42,4 @@ Offset Size Description (Table 02789) 02h WORD block start address (1K increments) 04h WORD block length (1K increments) SeeAlso: #02788 - + From 751ca4c5cddc2555f1d8c0a00ffe906a4ea9a3ec Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 17:02:28 +0200 Subject: [PATCH 2/7] Contributing.md: update, typos, describe list item contents --- Contributing.md | 157 ++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 137 insertions(+), 20 deletions(-) diff --git a/Contributing.md b/Contributing.md index d0ad023f5..c43797814 100644 --- a/Contributing.md +++ b/Contributing.md @@ -1,46 +1,163 @@ ## Contributing to _The List_ -Interested in helping improve _The List_, then this is the document for you. It will help you understand how the project is structered and maintaned. Along with any rules or guidelines, you will need to know. +If you're interested in helping improve _The List_, then this is the document for you. It will help you understand how the project is structured and maintained. Along with any rules or guidelines that you will need to know. ## Project structure -There are two main directories in the root of the project called [utilities](utilities) and [source](source). +There are two main directories in the root of the project called [utilities](utilities) and [source](source). -* [utilities](utilities) - contains the source files for the programs we use to manage _The List_. -* [source](source) - contains the many bits and pieces of _The List_ broken down for editing on _GitHub_. +* [utilities](utilities) - contains the source text files for the programs we use to manage _The List_. +* [source](source) - contains the many bits and pieces of _The List_ broken down for editing using _git_. ## The source directory -Under this path, there are a couple configuration files and some **group** directories. The [_Release.txt](source/_Release.txt) file simply contains version of the release we are working towards. The [_Mapping.txt](source/_Mapping.txt) file contains settings and other information needed for [makelist](utilities/makelist) to compile _The List_ into is release format. +Under this path, there are a couple configuration files and some **group** directories. The [_Release.txt](source/_Release.txt) file simply contains the version of the release we are working towards. The [_Mapping.txt](source/_Mapping.txt) file contains settings and other information needed for [makelist](utilities/makelist) to compile _The List_ into its release format. -With the exception of the [Miscellaneous](source/Miscellaneous) directory, the other sub-directories are _groups_ which contain the files that become a _LST_ file as defined in the [_Mapping.txt](source/_Mapping.txt) file when _The List_ is compiled. The files in the [Miscellaneous](source/Miscellaneous) are not processed and are simply copied into a release. +With the exception of the [Miscellaneous](source/Miscellaneous) directory, the other sub-directories are _groups_ which contain the files that become a _LST_ file as defined in the [_Mapping.txt](source/_Mapping.txt) file when _The List_ is compiled. The files in the [Miscellaneous](source/Miscellaneous) directory are not processed and are simply copied into a release. ## Group sub-directories -Every _group_ sub-directory contains at least one _Comment Section_ file. These files always start with an **underscore** character. Generally, these files are included as-is into the appropriate _LST_ file based on the order as defined in the [_Mapping.txt](source/_Mapping.txt). +Every _group_ sub-directory contains at least one _Comment Section_ file. These files always start with an **underscore** character. Generally, these files are included as-is into the appropriate _LST_ file based on the order as defined in the [_Mapping.txt](source/_Mapping.txt) file. -Most _groups_ _(like [Interrupt List](source/Interrupt%20List) and [Ports List](source/Ports%20List))_ can contain numerious sub-directories and files used for the items in a _LST_ file. The directory and file names for those items is not important to the program that compiles _The List_. Their names are only for our convience when finding and editing an entry for _The List_. Those items can be broken down into any level of sub-paths which we find suitable to our needs in maintaning the project. +Most _groups_ _(like [Interrupt List](source/Interrupt%20List) and [Ports List](source/Ports%20List))_ can contain numerous sub-directories and files used for the items in a _LST_ file. The directory and file names for those items are not important to the program that compiles _The List_. Their names are only for our convience when finding and editing an entry for _The List_. Those items can be broken down into any level of sub-paths which we find suitable to our needs in maintaining the project. -_Note: All files are required to have a `.txt` file extention and must be encoded in standard ASCII using code page 437. UTF-8 and other text encoding schemes are not supported at this time._ +_Note: All files are required to have a `.txt` filename extension and must be encoded in standard ASCII using code page 437. UTF-8 and other text encoding schemes are not supported at this time._ ## List item entries -The individual list item entry files each contain a header that has important information that is needed when compiling the list files. The header starts end ends with two vertical bars comprised of 80 dashes (minus characters). While there are several possible fields, only the **Unique ID** field is absolutely mandatory. +### List item headers -* **Unique ID** - Manditory field. It contains the ID which will be used for the section break in the compiled _LST_ file. For example, _Interrupt 21h function 4Ch_ has a _Unique ID_ of `214C`. - - However, sometimes there is insufficient uniqueness for an ID to distinguish it from another entry. For such items, -the ID can be suffixed with a **sort-as** to better identify the entry and guarantee the order in a _LST_ file. +The individual list item entry files each contain a header that has important information that is needed when compiling the list files. The header starts and ends with two horizontal bars comprised of 80 dashes (minus characters). While there are several possible fields, only the **Unique ID** field is absolutely mandatory. - For example, there are be multiple entries for _Interrupt 21h function 40h_. These entries have _Unique IDs_ like `2140-sort-as-2140++` and `2140-sort-as-2140PC/TCP` to always maintain their the same order in _The List_. Additional text after the _Unique ID_ is prohibited. +* **Unique ID** - Mandatory field. It contains the ID which will be used for the section break in the compiled _LST_ file. For example, +[Interrupt 21h function 4Ch](source/Interrupt%20List/INT%2021%20DOS%20Function%20Calls/INT%20214C%20DOS%202%20EXIT%20TERMINATE%20WITH%20RETURN%20CODE.txt) +has a _Unique ID_ of `214C`. An entry has to have exactly one _Unique ID_. -* **Sort As** - Optional field. This is an alternative method to the _sort-as_ suffix for providing additional uniqueness. Using one of the previously mentioned entries as an example, you could enter `Unique ID: 2140` and `Sort as: 2140PC/TCP`. Additional text after the _Sorting ID_ is prohibited. + However, sometimes there is insufficient uniqueness for an ID to distinguish it from another entry. For such items, +the ID can be suffixed with a **-sort-as-** ID to better identify the entry and guarantee the order in a _LST_ file. - Either method of providing a _Sorting ID_ is equally acceptable. However, do not use both the `-sort-as-` suffix and the `Sort As` field in the same entry. + For example, there are multiple entries for _Interrupt 21h function 40h_. These entries have _Unique IDs_ like `2140-sort-as-2140++` and `2140-sort-as-2140PC/TCP` to always maintain the same order in _The List_. Additional text after the _Unique ID_ is prohibited. -* **Category** - Recommended field. This is a single character field as listed in the [_Categories.txt](source/Interrupt%20List/_Categories.txt) file or `n/a`. While not required, additional text is recommended after the _category identifier_ in order to ease identification of the category. Entries are restricted to only a single _category_ per file. +* **Sort As** - Optional field. This is an alternative method to the _-sort-as-_ suffix for providing additional uniqueness. Using one of the previously mentioned entries as an example, you could enter `Unique ID: 2140` and `Sort As: 2140PC/TCP`. Additional text after the _Sort As ID_ is prohibited. -* **Flag** - Recommended field. Like the _Category_ field, this is a single character field as listed in the [_Flags.txt](source/Interrupt%20List/_Flags.txt) file or `n/a`. While not required, additional text is recommended after the _flag identifier_ in order to ease identification of the flag. You may include several _Flag_ fields in the header if needed. + Either method of providing a _Sort As ID_ is equally acceptable. However, do not use both the `-sort-as-` suffix and the `Sort As` field in the same entry. -### _(tbd)_ +* **Category** - Recommended field. This is a single character field as listed in the [_Categories.txt](source/Interrupt%20List/_Categories.txt) file or `-` if no category is used. Note that the _category identifier_ is case-sensitive. While not required, additional text is recommended after the _category identifier_ in order to ease identification of the category. Entries are restricted to only a single _category_ per file. The _category identifier_ is entered into the section break line of the compiled _LST_ file, after the first 8 dashes. After the _category identifier_ another dash follows, then the list-as ID (from the _Unique ID_). +* **Flag** - Recommended field. Like the _Category_ field, this is a single character field as listed in the [_Flags.txt](source/Interrupt%20List/_Flags.txt) file or `n/a` if no flag is applicable. Like the _category identifier_, the _flag identifier_ is case-sensitive. While not required, additional text is recommended after the _flag identifier_ in order to ease identification of the flag. You may include several _Flag_ fields in the header if needed. + +### List item contents + +After the second 80-dash separator line that ends the header, +the contents of the list item follow. +All contents are copied exactly into the _LST_ file during compilation, +except that leading and trailing empty lines are skipped +and linebreaks are normalised to CR LF. +Content lines should always fit in fewer than 80 columns. +Tab stops are expected at every 8th column. + +#### Summary base line + +The first non-empty line is known as the summary base. + +For an entry like [INT 21/AH=4Ch](source/Interrupt%20List/INT%2021%20DOS%20Function%20Calls/INT%20214C%20DOS%202%20EXIT%20TERMINATE%20WITH%20RETURN%20CODE.txt), +the summary starts with `INT 21`. +After this there may be a blank-separated field listing +all flag letters, if any. +(If multiple flags are used, there are no blanks +between the individual flag letters.) +Note that all used flags must be listed here again +because the header _Flag_ fields do not affect the compiled _LST_ file. + +After this there's a blank and a dash and another blank. +The remainder of the line is the _Name_ of the entry. +It may start with one or multiple component or system identifiers separated +from the remaining _Name_ by another dash each. +Words other than proper nouns or identifiers are typically in all-caps. + +The summary base does not include register values for the entry. + +#### Input conditions + +After the summary base line, input conditions may follow, +mostly listing register values to set up to call this entry's function. +All input conditions are indented with a tab +at the very beginning of the line. +ecm's IntList expects input registers to be in one of the following formats +to pick them up for its dynamic summary +and as register states for hyperlink destinations: + + * ` = ` for a single value + * ` = subfn ` for register value and subfunction value + * ` = ('')` for magic values, where the letters match the ASCII interpretation of the hexadecimal value in NASM or MASM order + * ` = / ` for multiple values + * ` = ..| to |-` for a value range + * ` = subfunction|type of load|what to return in BH|origin of move` for a type register + * Line starting with `---`: Skipped + * Line starting with ``: End of dynamic summary buildup + +Type registers enter a sub-mode where matches occur as follows: + + * `<4 BLANKs>...` (trail ignored) gives one value for the type register + * Line starting with `` followed by different whitespace than exactly `<4 BLANKs>`: Skipped + * Line starting with ``: End of type register sub-mode + * Line starting with ``: End of dynamic summary buildup + +#### Indented sections + +After the input conditions, indented sections may follow. +These start with section names that are not indented with contents +indented by one tab or more. +Typically, sentences or paragraphs start with a 1-tab indentation +and continued paragraph parts use `<2 BLANKs>` indentation. +The section names are: + + * Return: + * Desc: + * Note: + * Notes: + * MORE: + * BUG: + * BUGS: + * Program: + * InstallCheck: + * Range: + +There is a special section name _SeeAlso:_. +Every line belonging to this section type starts with `SeeAlso:` followed +by one blank. +This section lists only references to other entries or tables. + +#### Tables + +After the named sections, tables may be listed. +Tables are always started by an empty line then an unindented line. +Near the beginning of a table definition, +the text `(Table Annnn)` always is used, +in which `A` is alphanumeric (all-caps) and `n` are decimal digits. + +#### Hyperlinks + +IntList uses the following patterns to match references as hyperlinks +within entries after the summary base line: + + * Name matches are matched as `""`, name matches are allowed after all references except for tables. Note that there must not be any whitespace before the opening doublequote. + * Register values are matched as `=` without any whitespace + * Multiple register values are chained with slashes `/` + +The following patterns are turned into references: + + * Interrupts are matched as `INT` + * Interrupts with registers are matched as `INT/` + * Register-only references (only valid in INTERRUP.LST) are matched as `` where the first register must be one of AH, AL, or AX + * Tables are matched as `#<1 all-caps ALPHANUM><4 DECIMAL DIGITs>` + * Memory is matched as `MEM:` or `MEM` + * Far calls are matched as `@:` + * Port ranges are matched as `PORT-` + * Single ports are matched as `PORT` + +After an interrupt with registers or register-only reference match, +an immediately following `,` +(with the comma not preceeded or followed by any whitespace) +is matched as a reference to the same call as the prior match +except the last register's value is replaced by the specified number. From 926ca18535d7683c47a7391836ff8d927e68c082 Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 17:22:35 +0200 Subject: [PATCH 3/7] 21.71: add sort-as IDs to put LFN API before a virus --- .../INT 2171 Windows95 LONG FILENAME FUNCTIONS.txt | 2 +- .../INT 2171 VIRUS 1205 INSTALLATION CHECK.txt | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/source/Interrupt List/INT 21 DOS Function Calls/INT 2171 Windows95 LONG FILENAME FUNCTIONS.txt b/source/Interrupt List/INT 21 DOS Function Calls/INT 2171 Windows95 LONG FILENAME FUNCTIONS.txt index 3a9882eb7..900178900 100644 --- a/source/Interrupt List/INT 21 DOS Function Calls/INT 2171 Windows95 LONG FILENAME FUNCTIONS.txt +++ b/source/Interrupt List/INT 21 DOS Function Calls/INT 2171 Windows95 LONG FILENAME FUNCTIONS.txt @@ -1,5 +1,5 @@ -------------------------------------------------------------------------------- - Unique ID: 2171 + Unique ID: 2171-sort-as-2171++ Category: D DOS kernel Flag: n/a -------------------------------------------------------------------------------- diff --git a/source/Interrupt List/INT 21 DOS Function Calls/Virus Installation Checks/INT 2171 VIRUS 1205 INSTALLATION CHECK.txt b/source/Interrupt List/INT 21 DOS Function Calls/Virus Installation Checks/INT 2171 VIRUS 1205 INSTALLATION CHECK.txt index a8cd38fb3..b8d5a638a 100644 --- a/source/Interrupt List/INT 21 DOS Function Calls/Virus Installation Checks/INT 2171 VIRUS 1205 INSTALLATION CHECK.txt +++ b/source/Interrupt List/INT 21 DOS Function Calls/Virus Installation Checks/INT 2171 VIRUS 1205 INSTALLATION CHECK.txt @@ -1,5 +1,5 @@ -------------------------------------------------------------------------------- - Unique ID: 2171 + Unique ID: 2171-sort-as-2171Virus Category: v virus/antivirus Flag: n/a -------------------------------------------------------------------------------- @@ -8,4 +8,4 @@ INT 21 - VIRUS - "1205" - INSTALLATION CHECK AH = 71h Return: AH = 17h if "1205" is resident SeeAlso: AX=6969h"VIRUS",AH=76h"VIRUS" - + From 2d05089d1e6037d395227b3605d3f190db9b6aec Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 19:17:00 +0200 Subject: [PATCH 4/7] add Disk Transfer Area to glossary --- source/Glossary/Disk Transfer Address.txt | 3 +-- source/Glossary/Disk Transfer Area.txt | 4 ++++ 2 files changed, 5 insertions(+), 2 deletions(-) create mode 100644 source/Glossary/Disk Transfer Area.txt diff --git a/source/Glossary/Disk Transfer Address.txt b/source/Glossary/Disk Transfer Address.txt index 05b6d8761..cb58da2ed 100644 --- a/source/Glossary/Disk Transfer Address.txt +++ b/source/Glossary/Disk Transfer Address.txt @@ -4,5 +4,4 @@ Disk Transfer Address not take an explicit data address will read or store data. Although the name implies that only disk accesses use this address, other functions use it as well. See INT 21h Function 4Eh for an example of -the DTA's use. - +the DTA's use. (Also known as Disk Transfer Area.) diff --git a/source/Glossary/Disk Transfer Area.txt b/source/Glossary/Disk Transfer Area.txt new file mode 100644 index 000000000..5967270b2 --- /dev/null +++ b/source/Glossary/Disk Transfer Area.txt @@ -0,0 +1,4 @@ +Disk Transfer Area + + see Disk Transfer Address + From d3c6f5206478276e2482c193ea12cc61eb2d4479 Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 19:18:18 +0200 Subject: [PATCH 5/7] 21.14,.15,.21: fix Tranfer typo --- .../INT 2114 DOS 1 SEQUENTIAL READ FROM FCB FILE.txt | 4 ++-- .../INT 2115 DOS 1 SEQUENTIAL WRITE TO FCB FILE.txt | 4 ++-- .../INT 2121 DOS 1 READ RANDOM RECORD FROM FCB FILE.txt | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/source/Interrupt List/INT 21 DOS Function Calls/INT 2114 DOS 1 SEQUENTIAL READ FROM FCB FILE.txt b/source/Interrupt List/INT 21 DOS Function Calls/INT 2114 DOS 1 SEQUENTIAL READ FROM FCB FILE.txt index de48379f0..78b4496ed 100644 --- a/source/Interrupt List/INT 21 DOS Function Calls/INT 2114 DOS 1 SEQUENTIAL READ FROM FCB FILE.txt +++ b/source/Interrupt List/INT 21 DOS Function Calls/INT 2114 DOS 1 SEQUENTIAL READ FROM FCB FILE.txt @@ -12,11 +12,11 @@ Return: AL = status 01h end of file (no data) 02h segment wrap in DTA 03h end of file, partial record read - Disk Tranfer Area filled with record read from file + Disk Transfer Area filled with record read from file Notes: reads a record of the size specified in the FCB beginning at the current file position, then updates the current block and current record fields in the FCB if a partial record was read, it is zero-padded to the full size not supported by MS Windows 3.0 DOSX.EXE DOS extender SeeAlso: AH=0Fh,AH=15h,AH=1Ah,AH=3Fh"DOS",INT 2F/AX=1108h - + diff --git a/source/Interrupt List/INT 21 DOS Function Calls/INT 2115 DOS 1 SEQUENTIAL WRITE TO FCB FILE.txt b/source/Interrupt List/INT 21 DOS Function Calls/INT 2115 DOS 1 SEQUENTIAL WRITE TO FCB FILE.txt index 06c87a49c..44cc6d9c3 100644 --- a/source/Interrupt List/INT 21 DOS Function Calls/INT 2115 DOS 1 SEQUENTIAL WRITE TO FCB FILE.txt +++ b/source/Interrupt List/INT 21 DOS Function Calls/INT 2115 DOS 1 SEQUENTIAL WRITE TO FCB FILE.txt @@ -7,7 +7,7 @@ INT 21 - DOS 1+ - SEQUENTIAL WRITE TO FCB FILE AH = 15h DS:DX -> opened FCB (see #01345) - Disk Tranfer Area contains record to be written + Disk Transfer Area contains record to be written Return: AL = status 00h successful 01h disk full @@ -19,4 +19,4 @@ Notes: writes a record of the size specified in the FCB beginning at the buffer to be written out at a later time not supported by MS Windows 3.0 DOSX.EXE DOS extender SeeAlso: AH=0Fh,AH=14h,AH=1Ah,AH=40h,INT 2F/AX=1109h - + diff --git a/source/Interrupt List/INT 21 DOS Function Calls/INT 2121 DOS 1 READ RANDOM RECORD FROM FCB FILE.txt b/source/Interrupt List/INT 21 DOS Function Calls/INT 2121 DOS 1 READ RANDOM RECORD FROM FCB FILE.txt index 5a6376172..ba9eafeb7 100644 --- a/source/Interrupt List/INT 21 DOS Function Calls/INT 2121 DOS 1 READ RANDOM RECORD FROM FCB FILE.txt +++ b/source/Interrupt List/INT 21 DOS Function Calls/INT 2121 DOS 1 READ RANDOM RECORD FROM FCB FILE.txt @@ -12,11 +12,11 @@ Return: AL = status 01h end of file, no data read 02h segment wrap in DTA, no data read 03h end of file, partial record read - Disk Tranfer Area filled with record read from file + Disk Transfer Area filled with record read from file Notes: the record is read from the current file position as specified by the random record and record size fields of the FCB the file position is not updated after reading the record if a partial record is read, it is zero-padded to the full size not supported by MS Windows 3.0 DOSX.EXE DOS extender SeeAlso: AH=14h,AH=22h,AH=27h,AH=3Fh"DOS" - + From 635dea770eda563a0ed4a76b40864c61c2a5057d Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 19:18:56 +0200 Subject: [PATCH 6/7] 62.0042: fix typo se --- ...20042 FGDRIVER v402 FGGETENTRY GET PAGE TYPE AND ADDRESS.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/Interrupt List/INT 62 reserved for user interrupt multiple purposes/INT 620042 FGDRIVER v402 FGGETENTRY GET PAGE TYPE AND ADDRESS.txt b/source/Interrupt List/INT 62 reserved for user interrupt multiple purposes/INT 620042 FGDRIVER v402 FGGETENTRY GET PAGE TYPE AND ADDRESS.txt index 36e3745f4..4970582df 100644 --- a/source/Interrupt List/INT 62 reserved for user interrupt multiple purposes/INT 620042 FGDRIVER v402 FGGETENTRY GET PAGE TYPE AND ADDRESS.txt +++ b/source/Interrupt List/INT 62 reserved for user interrupt multiple purposes/INT 620042 FGDRIVER v402 FGGETENTRY GET PAGE TYPE AND ADDRESS.txt @@ -19,7 +19,7 @@ Format of FGDRIVER GETENTRY variable pointer record: Offset Size Description (Table 03483) 00h WORD segment of WORD buffer for page address 02h WORD offset of WORD buffer for page address - 04h WORD segment of WORD buffer for page type (se #03484) + 04h WORD segment of WORD buffer for page type (see #03484) 06h WORD offset of WORD buffer for page type (Table 03484) From c099f4edb059c6377c68ea93ffe62627c3e8c65f Mon Sep 17 00:00:00 2001 From: "E. C. Masloch" Date: Thu, 16 Apr 2026 19:58:17 +0200 Subject: [PATCH 7/7] Contributing.md: update for IntList 1396393e2554, non-accu reg only links --- Contributing.md | 1 + 1 file changed, 1 insertion(+) diff --git a/Contributing.md b/Contributing.md index c43797814..e5fc7be0f 100644 --- a/Contributing.md +++ b/Contributing.md @@ -150,6 +150,7 @@ The following patterns are turned into references: * Interrupts are matched as `INT` * Interrupts with registers are matched as `INT/` * Register-only references (only valid in INTERRUP.LST) are matched as `` where the first register must be one of AH, AL, or AX + * In SeeAlso: lines, register-only references may occur for other first registers too * Tables are matched as `#<1 all-caps ALPHANUM><4 DECIMAL DIGITs>` * Memory is matched as `MEM:` or `MEM` * Far calls are matched as `@:`