Bug report from Willi: FARCALL.LST

[shidel]

Here is the technical analysis of the Far Call Interface section (covering Eagle MS-DOS, ATI Video BIOS, BIOS32, PnP BIOS, and PMM) of the Interrupt List update, prepared for an American developer.

1. [TYPO] – Spelling & Grammar

Eagle MS-DOS Section:

Table F0004 (CALL 0060h:000Ch): "AL = character to be printed"

    Consistency: Most other entries use "output." Consider changing to "output" for uniformity.

Plug-and-Play (PnP) BIOS Section:

Table F0024 (Offset 09h): "...when a system even occurs"

    Correction: "...when a system event occurs"

Table F0025 (Function 0042h): "Read Extended SYstem Configuration Data"

    Correction: "Read Extended System Configuration Data" (Lowercase 'y').

Table F0025 (Function 0050h): "...Management I'face"

    Correction: "...Management Interface" (Avoid contractions in headers).

Table F0030 (Function 0004h): "...detected while atempting to add..."

    Correction: "...detected while attempting to add..."

Table F0048 (Description): "BYTE padding"

    Note: The table describes 10 bytes of arguments on the stack, but the "padding" byte is usually to maintain word alignment. It is correct, but check if it should be marked as "reserved."

Table F0050 (Value 02h): "...change a DWORD (four byets)..."

    Correction: "...change a DWORD (four bytes)..."

POST Memory Manager (PMM) Section:

Table F0093 (Notes): "...instead of just validating parametes"

    Correction: "...instead of just validating parameters"

Contact Info Section:

Error: "The List Project is in not affiliated..."

    Correction: "The List Project is not affiliated..." (This error persists across multiple files).

2. [TECH] – Technical Inconsistencies & Verifications

   PnP Expansion Header (Table F0083):

    Offset 18h (Line 792): "...far-called by system BIOS is boot attempt failed"
   
    Correction: "...far-called by system BIOS if boot attempt failed" (Logic error).
   

   BIOS32 Service Directory (Table F0022):

    Line 1078: "service identifier 54435724h ("SDW
   
            
    ")???WDS
    ")???WDS
   
          
   
    "
   
    Verification: The hex 54435724h actually translates to "
   
            
    WTC∗∗"inlittle−endianASCII(or"∗∗TCW
    WTC∗∗"inlittle−endianASCII(or"∗∗TCW
   
          
   
    "). If the identifier is meant to be "WDS$", the hex should be 24534457h. Please have the developer verify the hex-to-string mapping for these Phoenix-specific IDs.
   

   PnP Device Types (Table F0085):

    Value 0Bh/03h (Line 866): Lists "Pentium-Pro (P6)".
   
    Update Suggestion: Since this is a 2026 update, adding "Pentium II/III" or "K6/Athlon" equivalents based on PnP IDs would be beneficial.
   

   Eagle MS-DOS v1.25 (CALL 0060h:0015h):

    Note (Line 132): "drive number in AL is not the logical DOS drive number".
   
    Context: This is a vital architectural note for Eagle DOS. Ensure this remains highlighted as it differs from the standard INT 25h/26h logic.
   

3. [FORMAT] – Layout, Alignment & Structure

   Stub Consistency:

    Many entries (e.g., CALL xxxxh:xxxxh - Borland TKERNEL) are listed as stubs.
   
    Suggestion: For readability, ensure there is a consistent empty line between the SeeAlso line of one stub and the -------- divider of the next. Some stubs are "bunched" together (Lines 1110–1140).
   

   C Declarations (PnP Functions):

    The inclusion of int (*entry)(...) declarations is excellent.
   
    Consistency: In Table F0046, the return type is short. In Table F0026, it is int.
   
    Verification: PnP BIOS functions usually return a 16-bit status in AX. In a 16-bit compiler (OpenWatcom/Turbo C), int and short are both 16-bit. However, for clarity, using unsigned short or uint16_t (conceptual) is often safer for modern developers.
   

   Table Numbers:

    The file correctly continues the numbering (F0001, F0021, etc.).
   
    Note: Ensure no overlap with "C" (CMOS) or "T" (Standard Table) prefixes from other files.
   

[SUMMARY OVERVIEW FOR THIS BLOCK]

This is an impressive documentation of the Eagle MS-DOS IO.SYS entry points, which were historically poorly documented. The PnP BIOS and SMBIOS tables are extensive and high-quality.

Critical Fixes Needed:

The "is" vs "if" logic error in the Disconnect Vector description.

The hex identifier mismatch in the BIOS32 Directory (

        
WTCvsWDS
WTCvsWDS

      

).

The "byets" and "parametes" typos in technical tables.