xa65/xa/tests/README

This is a directory of test suites for complex or pathological cases that
have been repaired (?) in the current version. It is primarily for internal
testing, but is here for your interest.

Starting with 2.3.6, you should not normally need to run these directly
unless 'make test' fails. If you do, use harness:

./harness -cc=... -cflags=... -make=... -tests=testdir,testdir,testdir,...

If -tests is omitted, all tests are run.
Don't run the makefiles directly, if they exist; they may not work properly.
If a Makefile is not present, then the test harness assembles "test.s" and
compares it with "ok".

adrm/		Addressing mode test (especially the optimizer and quantity
		prefixes)
nonl/		Patryk's no-new-line-on-last-line cases ;)
fordef/		Optimizer warnings for forward defined labels
relocundef/  	Tests for the detection of undefined references during a
		reloc65 export
ldoreloc/ 	Test case for the relocation table reading of ldo when undef'd
		refs are involved
comcom/		Comments-with-comments-with-commands-etc. for testing -M
recmac/		Recursive macro evaluation testing
openpp/		Testing of open #if*s in pp
cpp/		Random preprocessor tests, mostly crap
incerr/		1) .xl/.al should error without -w 2) error should be in
		the correct file ('816)
binclude/	Binary include code with some weird casing
chppch/		Changing preprocessor characters (-p)
charset/	Tests of when charsets should be honoured and when not
mvnmvp/		Test MVN MVP unusual addressing mode ('816)
dos51/		Regression test, label scoping, "real world code"
cpktest/	Regression test, label listing, "real world code"
op816/		Regression test for '816 opcodes (thanks Alessandro Gatti)
branch/		Branch range test
masmcom/	Another test for -M that generates totally valid code
quotch/		Test quoting problematic characters (thanks Simon Rowe)
linkr/		Test linking using .dsb and generated code

Cameron Kaiser, André Fachat