3. Peculiarities

3.1 Cross links

Since ca65html is able to generate links between modules, the best way to use it is to supply all modules to it in one run, instead of running each file separately through it.

3.2 Include files

For now, ca65html will not read files included with .include. Specifying the include files as normal input files on the command line works in many cases.

3.3 Conversion errors

Since ca65html does not really parse the input, but does most of its work applying text patterns, it doesn't know anything about scoping and advanced features of the assembler. This means that it may miss a label may choose the wrong color for an item in rare cases. Since it's just a tool for displaying sources in a nice form, I think that's ok. Anyway, if you find a conversion problem, you can send me a short piece of example input code. If possible, I will fix it.

3.4 Colorization

While having colors in the output looks really nice, it has two drawbacks:

1. The output is not standard compliant HTML, because <font> tags are use in a <pre> environment. This works with all browsers I've tested, but it may not work with the one you're using.
2. Since lots of <font> tags are created in the output, the size of the output file will literally explode. This seems to be the price, you have to pay for color...