Missing documentatin for KERNAL APIs

This is the starting place for reporting bugs to the team. We will pass bug reports on to the developers after validating the reports.

You can report bugs in hardware, operating system (KERNAL or BASIC ROMs), the emulator, or the Demo library. For bugs specific to downloaded programs, use the download forum.
Post Reply
SolarSurfer
Posts: 29
Joined: Sun Nov 26, 2023 2:18 am

Missing documentatin for KERNAL APIs

Post by SolarSurfer »

This isn't necessarily a "bug" but rather an inconsistency in the documentation.

In this document: https://github.com/X16Community/x16-doc ... 0KERNAL.md as of this posting, the "Compatibility Considerations" section states that we can rely upon the KERNAL API calls at $FF81-$FFF3 being stable.

It then proceeds to document all KERNAL routines within that range except for the first five: FF81, FF84, FF87, FF8A, FF8D

If these are meant to be stable, please document them. If they are not yet stable, please update the stability range in the compatibility section.
DragWx
Posts: 309
Joined: Tue Mar 07, 2023 9:07 pm

Re: Missing documentatin for KERNAL APIs

Post by DragWx »

Good news, there's an issue open for this on Github, if you'd like to keep track of progress.

...but in the meantime, the calls at $FF81-FFF3 are indeed stable, it's just that you have to look up a C64 reference for them right now. This goes both for API functions which are named but not explained (like CHRIN/BASIN), and for API functions not listed at all (like CINT).
Post Reply