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

document the undocumented test/asm/listing behaviours

Browse Source
This commit is contained in:
bbbradsmith
2023-02-24 19:35:38 -05:00
parent da150aeeac
commit 230230819e
1 changed files with 23 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
test/asm/listing/readme.txt
View File

@@ -6,22 +6,38 @@ The name of a test is everything in the form <test>.s.
The following reference files can be added: The following reference files can be added:
- <test>.bin-ref: - ref/<test>.bin-ref:
This is a reference for the resulting binary. This is a reference for the resulting binary.
The binary as binary tested against this file. The binary as binary tested against this file.
If they are not equal, the test fails. If they are not equal, the test fails.
- <test>.list-ref - ref/<test>.list-ref
This is a reference for the resulting listing output This is a reference for the resulting listing output
This file *must* have the first line of the listing removed, as that This file *must* have the first line of the listing removed, as that
contains a ca65 version string, and almost always this will be changed! contains a ca65 version string, and almost always this will be changed!
- ref/<test>.err-ref
This is a reference for the resulting ca65 stdout (>) output.
- ref/<test>.err2-ref
This is a reference for the resulting ca65 stderr (2>) output.
- ref/<test>.ld65err-ref
This is a reference for the resutling ld65 stdout (>) output.
- ref/<test>.ld65err2-ref
This is a reference for the resulting ld65 stderr (2>) output.
The following control files can be added to control the tests.
These files are empty (contents ignored), and only the filename is used:
- control/<test>.err
Test is expected to produce an error.
- control/<test>.no-ld65
Skip the ld65 step.
Note that the resulting .bin file is generated twice: Once with no listing Note that the resulting .bin file is generated twice: Once with no listing
file, and once with listing file. This way, one can find out if the listing file, and once with listing file. This way, one can find out if the listing
file generation changes anything with the resulting binary output. file generation changes anything with the resulting binary output.
TODO:
- add the possibility to test for specific error output that are to be
expected