Improved doxygen documentation. #672

src/main/kc/include/6502.h

@@ -1,5 +1,5 @@
 /// @file 
-/// @brief Simple functions wrapping 6502 instructions
+/// Simple functions wrapping 6502 instructions
 
 /// Set the processor interrupt flag - disabling IRQ's.
 /// Uses the SEI instruction

src/main/kc/include/atari-gtia.h

@@ -1,5 +1,6 @@
 /// @file
 /// ATARI Graphic Television Interface Adaptor (GTIA)
+///
 /// Used in Atari 5200 and the 8-bit series (400, 800, XL, XE)
 /// https://en.wikipedia.org/wiki/CTIA_and_GTIA
 

src/main/kc/include/atari-pokey.h

@@ -1,5 +1,6 @@
 /// @file
 /// ATARI Graphic Television Interface Adaptor (GTIA)
+///
 /// Used in Atari 5200 and the 8-bit series (400, 800, XL, XE)
 /// https://en.wikipedia.org/wiki/CTIA_and_GTIA
 

src/main/kc/include/atari-tia.h

@@ -1,5 +1,6 @@
 /// @file
 /// Atari Television Interface Adaptor (TIA)
+///
 /// https://en.wikipedia.org/wiki/Television_Interface_Adaptor
 /// http://www.qotile.net/minidig/docs/stella.pdf
 /// Based on https://github.com/munsie/dasm/blob/master/machines/atari2600/vcs.h

src/main/kc/include/atari-xl.h

@@ -1,5 +1,6 @@
 /// @file
 /// Atari 8-bit 400/800/XL/XE Registers and Constants
+///
 /// https://en.wikipedia.org/wiki/Atari_8-bit_family
 
 #ifndef __ATARIXL__

src/main/kc/include/atari2600.h

@@ -1,5 +1,6 @@
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
 
 #ifndef __ATARI2600__

src/main/kc/include/c64-basic-floats.h

@@ -1,5 +1,6 @@
 /// @file
 /// Library wrapping the BASIC floating point functions
+///
 /// See https://www.c64-wiki.com/wiki/Floating_point_arithmetic
 /// See http://www.pagetable.com/c64rom/c64rom_sc.html
 

src/main/kc/include/c64-bitmap.h

@@ -1,5 +1,6 @@
 /// @file
 /// Simple single-color (320x200) bitmap routines
+
 /// Initialize bitmap plotting tables
 void bitmap_init(char* gfx, char* screen);
 

src/main/kc/include/c64-keyboard.h

@@ -1,5 +1,6 @@
 /// @file
 /// Simple Keyboard Input Library
+///
 /// C64 Keyboard Matrix Reference - from http://codebase64.org/doku.php?id=base:reading_the_keyboard
 /// Keyboard Codes are %00rrrccc, where rrr is the row ID (0-7) and ccc is the column ID (0-7)
 /// +----+----------------------+-------------------------------------------------------------------------------------------------------+

src/main/kc/include/c64-multiplexer.h

@@ -1,5 +1,6 @@
 /// @file
 /// A flexible sprite multiplexer routine for 32 sprites.
+///
 /// Usage:
 /// - Once:
 /// - plexInit(screen): Initialize the data structures and set the screen address

src/main/kc/include/c64-print.h

@@ -1,5 +1,6 @@
 /// @file
 /// A lightweight library for printing on the C64.
+///
 /// Printing with this library is done by calling print_ function for each element
 
 /// Print a number of zero-terminated strings, each followed by a newline.

src/main/kc/include/c64-time.h

@@ -1,6 +1,7 @@
 /// @file
 /// C standard library time.h
-///  Functions to get and manipulate date and time information.
+///
+/// Functions to get and manipulate date and time information.
 
 /// Type suitable for storing the processor time.
 typedef unsigned long clock_t;

src/main/kc/include/c64-tod.h

@@ -1,5 +1,6 @@
 /// @file
 /// Time-of-day helper
+///
 /// Uses the MOS6526 CIA#1 on Commodore 64
 
 /// Time-of-day 24 hour format

src/main/kc/include/c64dtv.h

@@ -1,6 +1,6 @@
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/main/kc/include/cbm.h

@@ -1,5 +1,6 @@
 /// @file
 /// Commodore Kernal functions
+///
 /// See http://www.c64os.com/post/c64kernalrom#iec_acptr
 /// Compatible with https://github.com/cc65/cc65/blob/master/include/cbm.h
 

src/main/kc/include/conio-lines.h

@@ -1,6 +1,7 @@
 /// @file
 /// Provides provide simple horisontal/vertical lines routines on top of conio.h
-///  For compatibility with CC65 https://github.com/cc65/cc65/blob/master/include/conio.h
+///
+/// For compatibility with CC65 https://github.com/cc65/cc65/blob/master/include/conio.h
 
 #include <conio.h>
 

src/main/kc/include/conio.h

@@ -1,5 +1,6 @@
 /// @file
 /// Provides provide console input/output
+///
 /// Implements similar functions as conio.h from CC65 for compatibility
 /// See https://github.com/cc65/cc65/blob/master/include/conio.h
 //

src/main/kc/include/cx16-bitmap.h

@@ -1,5 +1,6 @@
 /// @file
 /// Plot and line drawing routines for HIRES bitmaps
+///
 /// Currently it can only plot on the first 256 x-positions.
 
 /// Initialize the bitmap plotter tables for a specific bitmap

src/main/kc/include/cx16-kernal.h

@@ -1,4 +1,6 @@
 /// @file
+
+
 /// Kernal SETNAM function
 /// SETNAM. Set file name parameters.
 void setnam(char* filename);

src/main/kc/include/cx16-vera.h

@@ -1,5 +1,6 @@
 /// @file
 /// Commander X16 VERA (Versatile Embedded Retro Adapter) Video and Audio Processor
+///
 /// https://github.com/commanderx16/x16-docs/blob/master/VERA%20Programmer's%20Reference.md
 
 /// The colors of the CX16

src/main/kc/include/cx16-veralib.h

@@ -1,7 +1,7 @@
 /// @file
 /// Commander X16 VERA (Versatile Embedded Retro Adapter) Video and Audio Processor
+///
 /// https://github.com/commanderx16/x16-docs/blob/master/VERA%20Programmer's%20Reference.md
-
 /// Author: Sven Van de Velde
 
 #include <cx16-vera.h>

src/main/kc/include/cx16.h

@@ -1,5 +1,6 @@
 /// @file
 /// Commander X16
+///
 /// https://www.commanderx16.com/forum/index.php?/about-faq/
 /// https://github.com/commanderx16/x16-docs/blob/master/Commander%20X16%20Programmer's%20Reference%20Guide.md
 #ifndef __CX16__
@@ -49,66 +50,66 @@ char * const DEFAULT_SCREEN_VBANK = (char*)0;
 
 /// Put a single byte into VRAM.
 /// Uses VERA DATA0
-/// - vbank: Which 64K VRAM bank to put data into (0/1)
-/// - vaddr: The address in VRAM
-/// - data: The data to put into VRAM
+/// @param vbank Which 64K VRAM bank to put data into (0/1)
+/// @param vaddr The address in VRAM
+/// @param data The data to put into VRAM
 void vpoke(char vbank, char* vaddr, char data);
 
 /// Read a single byte from VRAM.
 /// Uses VERA DATA0
-/// - bank: Which 64K VRAM bank to put data into (0/1)
-/// - addr: The address in VRAM
-/// - returns: The data to put into VRAM
+/// @param bank Which 64K VRAM bank to put data into (0/1)
+/// @param addr The address in VRAM
+/// @param returns The data to put into VRAM
 char vpeek(char vbank, char* vaddr);
 
 /// Copy block of memory (from RAM to VRAM)
 /// Copies the values of num bytes from the location pointed to by source directly to the memory block pointed to by destination in VRAM.
-/// - vbank: Which 64K VRAM bank to put data into (0/1)
-/// - vdest: The destination address in VRAM
-/// - src: The source address in RAM
-/// - num: The number of bytes to copy
+/// @param vbank Which 64K VRAM bank to put data into (0/1)
+/// @param vdest The destination address in VRAM
+/// @param src The source address in RAM
+/// @param num The number of bytes to copy
 void memcpy_to_vram(char vbank, void* vdest, void* src, unsigned int num );
 
 /// Copy block of memory (from banked RAM to VRAM)
 /// Copies the values of num bytes from the location pointed to by source directly to the memory block pointed to by destination in VRAM.
-/// - vdest: absolute address in VRAM
-/// - src: absolute address in the banked RAM  of the CX16.
-/// - num: dword of the number of bytes to copy
+/// @param vdest absolute address in VRAM
+/// @param src absolute address in the banked RAM  of the CX16.
+/// @param num dword of the number of bytes to copy
 /// Note: This function can switch RAM bank during copying to copy data from multiple RAM banks.
 void memcpy_bank_to_vram(unsigned long vdest, unsigned long src, unsigned long num );
 
 /// Copy block of memory (from VRAM to VRAM)
 /// Copies the values from the location pointed by src to the location pointed by dest.
 /// The method uses the VERA access ports 0 and 1 to copy data from and to in VRAM.
-/// - src_bank:  64K VRAM bank number to copy from (0/1).
-/// - src: pointer to the location to copy from. Note that the address is a 16 bit value!
-/// - src_increment: the increment indicator, VERA needs this because addressing increment is automated by VERA at each access.
-/// - dest_bank:  64K VRAM bank number to copy to (0/1).
-/// - dest: pointer to the location to copy to. Note that the address is a 16 bit value!
-/// - dest_increment: the increment indicator, VERA needs this because addressing increment is automated by VERA at each access.
-/// - num: The number of bytes to copy
+/// @param src_bank  64K VRAM bank number to copy from (0/1).
+/// @param src pointer to the location to copy from. Note that the address is a 16 bit value!
+/// @param src_increment the increment indicator, VERA needs this because addressing increment is automated by VERA at each access.
+/// @param dest_bank  64K VRAM bank number to copy to (0/1).
+/// @param dest pointer to the location to copy to. Note that the address is a 16 bit value!
+/// @param dest_increment the increment indicator, VERA needs this because addressing increment is automated by VERA at each access.
+/// @param num The number of bytes to copy
 void memcpy_in_vram(char dest_bank, void *dest, char dest_increment, char src_bank, void *src, char src_increment, unsigned int num );
 
 /// Set block of memory in VRAM to a value .
 /// Sets num bytes to a value to the memory block pointed to by destination in VRAM.
-/// - vbank: Which 64K VRAM bank to put data into (0/1)
-/// - vdest: The destination address in VRAM
-/// - data: The value to set the vram with.
-/// - num: The number of bytes to set
+/// @param vbank Which 64K VRAM bank to put data into (0/1)
+/// @param vdest The destination address in VRAM
+/// @param data The value to set the vram with.
+/// @param num The number of bytes to set
 void memset_vram(char vbank, void* vdest, char data, unsigned long num );
 
 /// Set block of memory in VRAM to a word value .
 /// Sets num words  to a value to the memory block pointed to by destination in VRAM.
-/// - vbank: Which 64K VRAM bank to put data into (0/1)
-/// - vdest: The destination address in VRAM
-/// - data: The value to set the vram with.
-/// - num: The number of bytes to set
+/// @param vbank Which 64K VRAM bank to put data into (0/1)
+/// @param vdest The destination address in VRAM
+/// @param data The value to set the vram with.
+/// @param num The number of bytes to set
 void memset_vram_word(char vbank, void* vdest, unsigned int data, unsigned long num );
 
 /// Load a file into one of the 256 8KB RAM banks.
-/// - device: The device to load from
-/// - filename: The file name
-/// - address: The absolute address in banked memory to load the file too
-/// - returns: 0xff: Success, other: Kernal Error Code (https://commodore.ca/manuals/pdfs/commodore_error_messages.pdf)
+/// @param device The device to load from
+/// @param filename The file name
+/// @param address: The absolute address in banked memory to load the file too
+/// @return 0xff: Success, other: Kernal Error Code (https://commodore.ca/manuals/pdfs/commodore_error_messages.pdf)
 /// Note: This function only works if the entire file fits within the selected bank. The function cannot load to multiple banks.
 char load_to_bank( char device, char* filename, unsigned long address);

src/main/kc/include/division.h

@@ -1,5 +1,6 @@
 /// @file
 /// Simple binary division implementation
+///
 /// Follows the C99 standard by truncating toward zero on negative results.
 /// See http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1124.pdf section 6.5.5
 

src/main/kc/include/fastmultiply.h

@@ -1,5 +1,6 @@
 /// @file
 /// Library Implementation of the Seriously Fast Multiplication
+///
 /// See http://codebase64.org/doku.php?id=base:seriously_fast_multiplication
 /// Utilizes the fact that a*b = ((a+b)/2)^2 - ((a-b)/2)^2
 

src/main/kc/include/mega65-dma.h

@@ -4,43 +4,43 @@
 
 /// Copy a memory block within the first 64K memory space using MEGA65 DMagic DMA
 /// Copies the values of num bytes from the location pointed to by source directly to the memory block pointed to by destination.
-/// - dest The destination address (within the MB and bank)
-/// - src The source address (within the MB and bank)
-/// - num The number of bytes to copy
+/// @param dest The destination address (within the MB and bank)
+/// @param src The source address (within the MB and bank)
+/// @param num The number of bytes to copy
 void memcpy_dma(void* dest, void* src, unsigned int num);
 
 /// Copy a memory block anywhere in first 4MB memory space using MEGA65 DMagic DMA
 /// Copies the values of num bytes from the location pointed to by source directly to the memory block pointed to by destination.
-/// - dest_bank The 64KB bank for the destination (0-63)
-/// - dest The destination address (within the MB and bank)
-/// - src_bank The 64KB bank for the source (0-63)
-/// - src The source address (within the MB and bank)
-/// - num The number of bytes to copy
+/// @param dest_bank The 64KB bank for the destination (0-63)
+/// @param dest The destination address (within the MB and bank)
+/// @param src_bank The 64KB bank for the source (0-63)
+/// @param src The source address (within the MB and bank)
+/// @param num The number of bytes to copy
 void memcpy_dma4(char dest_bank, void* dest, char src_bank, void* src, unsigned int num);
 
 /// Copy a memory block anywhere in the entire 256MB memory space using MEGA65 DMagic DMA
 /// Copies the values of num bytes from the location pointed to by source directly to the memory block pointed to by destination.
-/// - dest_mb The MB value for the destination (0-255)
-/// - dest_bank The 64KB bank for the destination (0-15)
-/// - dest The destination address (within the MB and bank)
-/// - src_mb The MB value for the source (0-255)
-/// - src_bank The 64KB bank for the source (0-15)
-/// - src The source address (within the MB and bank)
-/// - num The number of bytes to copy
+/// @param dest_mb The MB value for the destination (0-255)
+/// @param dest_bank The 64KB bank for the destination (0-15)
+/// @param dest The destination address (within the MB and bank)
+/// @param src_mb The MB value for the source (0-255)
+/// @param src_bank The 64KB bank for the source (0-15)
+/// @param src The source address (within the MB and bank)
+/// @param num The number of bytes to copy
 void memcpy_dma256(char dest_mb, char dest_bank, void* dest, char src_mb, char src_bank, void* src, unsigned int num);
 
 /// Fill a memory block within the first 64K memory space using MEGA65 DMagic DMA
 /// Fills the values of num bytes at the destination with a single byte value.
-/// - dest The destination address (within the MB and bank)
-/// - fill The char to fill with
-/// - num The number of bytes to copy
+/// @param dest The destination address (within the MB and bank)
+/// @param fill The char to fill with
+/// @param num The number of bytes to copy
 void memset_dma(void* dest, char fill, unsigned int num);
 
 /// Set a memory block anywhere in the entire 256MB memory space using MEGA65 DMagic DMA
 /// Sets the values of num bytes to the memory block pointed to by destination.
-/// - dest_mb The MB value for the destination (0-255)
-/// - dest_bank The 64KB bank for the destination (0-15)
-/// - dest The destination address (within the MB and bank)
-/// - fill The byte to fill into the memory
-/// - num The number of bytes to copy
+/// @param dest_mb The MB value for the destination (0-255)
+/// @param dest_bank The 64KB bank for the destination (0-15)
+/// @param dest The destination address (within the MB and bank)
+/// @param fill The byte to fill into the memory
+/// @param num The number of bytes to copy
 void memset_dma256(char dest_mb, char dest_bank, void* dest, char fill, unsigned int num);

src/main/kc/include/mega65-f018.h

@@ -1,5 +1,6 @@
 /// @file
 /// MEGA65 DMA
+///
 /// Appendix J in https://mega.scryptos.com/sharefolder-link/MEGA/MEGA65+filehost/Docs/MEGA65-Book_draft.pdf
 /// C65 Manual http://www.zimmers.net/cbmpics/cbm/c65/c65manual.txt
 /// DMA lists https://raw.githubusercontent.com/MEGA65/c65-specifications/master/c65manualupdated.txt

src/main/kc/include/mega65-math.h

@@ -1,5 +1,6 @@
 /// @file
 /// MEGA65 CPU MATHS ACCELERATION REGISTERS
+///
 /// Every MEGA65 contains a combined 32-bit hardware multiplier and divider. This device
 /// takes two 32-bit inputs, MULTINA and MULTINB, and simultaneously calculates:
 /// • the 64-bit product of MULTINA and MULTINB

src/main/kc/include/mega65-memorymapper.h

@@ -1,5 +1,6 @@
 /// @file
 /// MEGA65 Memory Mapper allows the 6502 CPU to access up to 256MB of memory by remapping where the eight 8K blocks point in real memory.
+///
 /// The memory mapping is configured through the new MAP instruction of the MOS 4510.
 /// https://mega65.org/
 /// https://mega.scryptos.com/sharefolder-link/MEGA/MEGA65+filehost/Docs/MEGA65-Book_draft.pdf

src/main/kc/include/mega65-viciv.h

@@ -1,5 +1,6 @@
 /// @file
 /// MEGA65 Video Interface Chip (VIC IV)
+///
 /// https://mega65.org/
 /// https://github.com/MEGA65/mega65-core/blob/master/src/vhdl/viciv.vhdl
 struct MEGA65_VICIV {

src/main/kc/include/mos6522.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 6522 Versatile Interface Adapter (VIA)
+///
 /// Used in VIC 20 and 1541
 /// https://en.wikipedia.org/wiki/MOS_Technology_6522
 /// http://archive.6502.org/datasheets/mos_6522_preliminary_nov_1977.pdf

src/main/kc/include/mos6523.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 6523 TRI-PORT INTERFACE (TPI)
+///
 /// It has three dedicated 8-bit I/O ports which provide 24 individually programmable I/O lines
 /// Used in the Commodore 1551 disk drive
 /// http://archive.6502.org/datasheets/mos_6523_tpi_preliminary_nov_1980.pdf

src/main/kc/include/mos6526.h

@@ -1,5 +1,6 @@
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 
 /// The MOS 6526 Complex Interface Adapter (CIA)

src/main/kc/include/mos6529.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 6529 Single Port Interface (SPI aka PIO)
+///
 /// I/O controller providing a single 8-bit digital bidirectional parallel I/O port.
 /// http://archive.6502.org/datasheets/mos_6529_spi.pdf
 

src/main/kc/include/mos6532.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 6532 RAM-I/O-Timer (RIOT)
+///
 /// http://www.ionpool.net/arcade/gottlieb/technical/datasheets/R6532_datasheet.pdf
 /// http://www.qotile.net/minidig/docs/stella.pdf
 /// https://en.wikipedia.org/wiki/MOS_Technology_6532

src/main/kc/include/mos6551.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 6551 6551 ASYNCHRONOUS COMMUNICATION INTERFACE ADAPTER
+///
 /// used for RS232
 /// http://archive.6502.org/datasheets/mos_6551_acia.pdf
 ///  https://en.wikipedia.org/wiki/MOS_Technology_6551

src/main/kc/include/mos6561.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 6560/6561 VIDEO INTERFACE CHIP
+///
 /// Used in VIC 20
 /// http://archive.6502.org/datasheets/mos_6560_6561_vic.pdf
 

src/main/kc/include/mos6569.h

@@ -1,8 +1,11 @@
 /// @file
 /// MOS 6567 / 6569 Video Interface Chip (VIC II)
+///
 ///  http://archive.6502.org/datasheets/mos_6567_vic_ii_preliminary.pdf
 ///  https://dustlayer.com/vic-ii/2013/4/22/when-visibility-matters
 ///  http://www.zimmers.net/cbmpics/cbm/c64/vic-ii.txt
+
+/// MOS 6567 / 6569 Video Interface Chip (VIC II)
 struct MOS6569_VICII {
     /// $D000 X-Coordinate Sprite#0
     char SPRITE0_X;

src/main/kc/include/mos6581.h

@@ -1,6 +1,9 @@
 /// @file
 /// The MOS 6581/8580 SID (Sound Interface Device)
+/// MOS 6567 / 6569 Video Interface Chip (VIC II)
 /// http://archive.6502.org/datasheets/mos_6581_sid.pdf
+
+/// The MOS 6581/8580 SID (Sound Interface Device)
 struct MOS6581_SID {
     /// Channel 1 Frequency
     unsigned int CH1_FREQ;

src/main/kc/include/mos7360.h

@@ -1,8 +1,10 @@
 /// @file
 /// The MOS 7360/8360 TED chip used for graphics and sound in Plus/4 and Commodore 16
+///
 /// https://www.karlstechnology.com/commodore/TED7360-datasheet.pdf
 /// http://mclauchlan.site.net.au/scott/C=Hacking/C-Hacking12/gfx.html
 
+/// The MOS 7360/8360 TED chip used for graphics and sound in Plus/4 and Commodore 16
 struct MOS7360_TED {
     /// Counter #01. It always starts to decrement from the last written value into it.
     unsigned int COUNTER1;

src/main/kc/include/mos7501.h

@@ -1,5 +1,6 @@
 /// @file
 /// MOS 7501/8501 MICROPROCESSOR
+///
 /// https://en.wikipedia.org/wiki/MOS_Technology_6510
 
 /// The processor port of the MOS 7501 CPU

src/main/kc/include/nes.h

@@ -1,5 +1,6 @@
 /// @file
 /// Nintendo Entertainment System (NES
+///
 /// https://en.wikipedia.org/wiki/Nintendo_Entertainment_System_(Model_NES-101)
 /// https://github.com/gregkrsak/first_nes
 #ifndef __NES__
@@ -80,7 +81,7 @@ const char JOY_B =      0b01000000;
 const char JOY_A =      0b10000000;
 
 /// Prepare for transferring data from the CPU to the PPU
-/// - ppuData : Pointer in the PPU memory
+/// @param ppuData Pointer in the PPU memory
 void ppuDataPrepare(void* const ppuData);
 
 /// Put one byte into PPU memory
@@ -92,32 +93,32 @@ void ppuDataPut(char val);
 char ppuDataRead();
 
 /// Fill a number of bytes in the PPU memory
-/// - ppuData : Pointer in the PPU memory
-/// - size : The number of bytes to transfer
+/// @param ppuData Pointer in the PPU memory
+/// @param size The number of bytes to transfer
 void ppuDataFill(void* const ppuData, char val, unsigned int size);
 
 /// Transfer a number of bytes from the CPU memory to the PPU memory
-/// - ppuData : Pointer in the PPU memory
-/// - cpuData : Pointer to the CPU memory (RAM of ROM)
-/// - size : The number of bytes to transfer
+/// @param ppuData Pointer in the PPU memory
+/// @param cpuData Pointer to the CPU memory (RAM of ROM)
+/// @param size The number of bytes to transfer
 void ppuDataTransfer(void* const ppuData, void* const cpuData, unsigned int size);
 
 /// Transfer a number of bytes from the PPU memory to the CPU memory
-/// - cpuData : Pointer to the CPU memory (RAM of ROM)
-/// - ppuData : Pointer in the PPU memory
-/// - size : The number of bytes to transfer
+/// @param cpuData Pointer to the CPU memory (RAM of ROM)
+/// @param ppuData Pointer in the PPU memory
+/// @param size The number of bytes to transfer
 void ppuDataFetch(void* const cpuData, void* const ppuData, unsigned int size);
 
 /// Transfer a 2x2 tile into the PPU memory
-/// - ppuData : Pointer in the PPU memory
-/// - tile : The tile to transfer
+/// @param ppuData Pointer in the PPU memory
+/// @param tile The tile to transfer
 void ppuDataPutTile(void* const ppuData, char* tile);
 
 /// Set one byte in PPU memory
-/// - ppuData : Pointer in the PPU memory
-/// - val : The value to set
+/// @param ppuData Pointer in the PPU memory
+/// @param val The value to set
 void ppuDataSet(void* const ppuData, char val);
 
 /// Get one byte from PPU memory
-/// - ppuData : Pointer in the PPU memory
+/// @param ppuData Pointer in the PPU memory
 char ppuDataGet(void* const ppuData);

src/main/kc/include/peekpoke.h

@@ -1,5 +1,6 @@
 /// @file
 /// PEEK and POKE macros for those who want to write BASIC code in C
+///
 /// Based on https://github.com/cc65/cc65/blob/master/include/peekpoke.h
 
 /// Read the absolute memory given by addr and return the value read.

src/main/kc/include/plus4.h

@@ -1,5 +1,6 @@
 /// @file
 /// Plus/4 / Commodore 16 registers and memory layout
+///
 /// http://zimmers.net/anonftp/pub/cbm/schematics/computers/plus4/264_Hardware_Spec.pdf
 /// http://www.zimmers.net/anonftp/pub/cbm/schematics/computers/plus4/Plus_4_Technical_Docs.pdf
 /// http://personalpages.tds.net/~rcarlsen/cbm/c16/C16_Service_Manual_314001-03_(1984_Oct).pdf

src/main/kc/include/ricoh_2a03.h

@@ -1,5 +1,6 @@
 /// @file
 /// Ricoh 2A03 Nintendo Entertainment System CPU and audio processing unit (APU)
+///
 /// Ricoh 2A03 or RP2A03 (NTSC version) / Ricoh 2A07 or RP2A07 (PAL version)
 /// https://en.wikipedia.org/wiki/Ricoh_2A03
 /// https://www.nesdev.com/2A03%20technical%20reference.txt

src/main/kc/include/ricoh_2c02.h

@@ -1,5 +1,6 @@
 /// @file
 /// Ricoh 2C02 - NES Picture Processing Unit (PPU)
+///
 /// Ricoh RP2C02 (NTSC version) / RP2C07 (PAL version),
 /// https://en.wikipedia.org/wiki/Picture_Processing_Unit
 /// https://wiki.nesdev.com/w/index.php/PPU_registers

src/main/kc/include/sine.h

@@ -1,5 +1,6 @@
 /// @file
 /// Sine Generator functions using only multiplication, addition and bit shifting
+///
 /// Uses a single division for converting the wavelength to a reciprocal.
 /// Generates sine using the series sin(x) = x - x^/3! + x^-5! - x^7/7! ...
 /// Uses the approximation sin(x) = x - x^/6 + x^/128
@@ -20,28 +21,28 @@ extern const unsigned int PI_u4f12;
 extern const unsigned int PI_HALF_u4f12;
 
 /// Generate signed (large) unsigned int sine table - on the full -$7fff - $7fff range
-/// sintab - the table to generate into
-/// wavelength - the number of sine points in a total sine wavelength (the size of the table)
+/// @param sintab the table to generate into
+/// @param wavelength the number of sine points in a total sine wavelength (the size of the table)
 void sin16s_gen(int* sintab, unsigned int wavelength);
 
 /// Generate signed int sine table - with values in the range min-max.
-/// sintab - the table to generate into
-/// wavelength - the number of sine points in a total sine wavelength (the size of the table)
+/// @param sintab the table to generate into
+/// @param wavelength the number of sine points in a total sine wavelength (the size of the table)
 void sin16s_gen2(int* sintab, unsigned int wavelength, int min, int max);
 
 /// Generate signed char sine table - on the full -$7f - $7f range
-/// sintab - the table to generate into
-/// wavelength - the number of sine points in a total sine wavelength (the size of the table)
+/// @param sintab the table to generate into
+/// @param wavelength the number of sine points in a total sine wavelength (the size of the table)
 void sin8s_gen(signed char*  sintab, unsigned int wavelength);
 
 /// Calculate signed int sine sin(x)
-/// x: unsigned long input u[4.28] in the interval $00000000 - PI2_u4f28
-/// result: signed int sin(x) s[0.15] - using the full range  -$7fff - $7fff
+/// @param x unsigned long input u[4.28] in the interval $00000000 - PI2_u4f28
+/// @return signed int sin(x) s[0.15] - using the full range  -$7fff - $7fff
 int sin16s(unsigned long x);
 
 /// Calculate signed char sine sin(x)
-/// x: unsigned int input u[4.12] in the interval $0000 - PI2_u4f12
-/// result: signed char sin(x) s[0.7] - using the full range  -$7f - $7f
+/// @param x unsigned int input u[4.12] in the interval $0000 - PI2_u4f12
+/// @return signed char sin(x) s[0.7] - using the full range  -$7f - $7f
 signed char sin8s(unsigned int x);
 
 /// Calculate val*val for two unsigned int values - the result is 16 selected bits of the 32-bit result.

src/main/kc/include/stdint.h

@@ -1,5 +1,6 @@
 /// @file
 /// C standard library stdint.h
+///
 /// Defines a set of integral type aliases with specific width requirements, along with macros specifying their limits and macro functions to create values of these types.
 
 /// Unsigned integer type with a width of exactly 8 bits

src/main/kc/include/stdlib.h

@@ -1,5 +1,6 @@
 /// @file
 /// C standard library stdlib.h
+///
 /// Implementation of functions found int C stdlib.h / stdlib.c
 #include <string.h>
 
@@ -12,15 +13,15 @@ void* malloc(unsigned int size);
 void free(void* ptr);
 
 /// Allocates memory and returns a pointer to it. Sets allocated memory to zero.
-/// - nitems − This is the number of elements to be allocated.
-/// - size − This is the size of elements.
+/// @param nitems This is the number of elements to be allocated.
+/// @param size This is the size of elements.
 void *calloc(size_t nitems, size_t size);
 
 /// Searches an array of nitems unsigned ints, the initial member of which is pointed to by base, for a member that matches the value key.
-/// - key - The value to look for
-/// - items - Pointer to the start of the array to search in
-/// - num - The number of items in the array
-/// Returns pointer to an entry in the array that matches the search key
+/// @param key The value to look for
+/// @param items Pointer to the start of the array to search in
+/// @param num The number of items in the array
+/// @return pointer to an entry in the array that matches the search key
 unsigned int* bsearch16u(unsigned int key, unsigned int* items, char num);
 
 /// The different supported radix
@@ -28,16 +29,16 @@ enum RADIX { BINARY=2, OCTAL=8, DECIMAL=10, HEXADECIMAL=16 };
 
 /// Converts unsigned number value to a string representing it in RADIX format.
 /// If the leading digits are zero they are not included in the string.
-/// - value : The number to be converted to RADIX
-/// - buffer : receives the string representing the number and zero-termination.
-/// - radix : The radix to convert the number to (from the enum RADIX)
+/// @param value The number to be converted to RADIX
+/// @param buffer receives the string representing the number and zero-termination.
+/// @param radix The radix to convert the number to (from the enum RADIX)
 void utoa(unsigned int value, char* buffer, enum RADIX radix);
 
 /// Converts unsigned number value to a string representing it in RADIX format.
 /// If the leading digits are zero they are not included in the string.
-/// - value : The number to be converted to RADIX
-/// - buffer : receives the string representing the number and zero-termination.
-/// - radix : The radix to convert the number to (from the enum RADIX)
+/// @param value The number to be converted to RADIX
+/// @param buffer receives the string representing the number and zero-termination.
+/// @param radix The radix to convert the number to (from the enum RADIX)
 void ultoa(unsigned long value, char* buffer, enum RADIX radix);
 
 /// Converts the string argument str to an integer.

src/main/kc/include/string.h

@@ -1,5 +1,6 @@
 /// @file
 /// C standard library string.h
+///
 /// Functions to manipulate C strings and arrays.
 
 typedef unsigned int size_t ;
@@ -22,8 +23,8 @@ char* strcpy( char* destination, char*  source );
 size_t strlen(char *str);
 
 /// Searches for the first occurrence of the character c (an unsigned char) in the first n bytes of the string pointed to, by the argument str.
-/// - str: The memory to search
-/// - c: A character to search for
-/// - n: The number of bytes to look through
-/// Return: A pointer to the matching byte or NULL if the character does not occur in the given memory area.
+/// @param str The memory to search
+/// @param c A character to search for
+/// @param n  The number of bytes to look through
+/// @return A pointer to the matching byte or NULL if the character does not occur in the given memory area.
 void *memchr(const void *str, char c, size_t n);

src/main/kc/include/vic20.h

@@ -1,5 +1,6 @@
 /// @file
 /// Commodore VIC 20 registers and memory layout
+///
 /// http://sleepingelephant.com/denial/wiki/index.php?title=Memory_Map
 /// http://www.zimmers.net/anonftp/pub/cbm/vic20/manuals/VIC-20_Programmers_Reference_Guide_1st_Edition_6th_Printing.pdf
 #include <mos6561.h>

src/test/ref/bitmap-circle-2.asm

@@ -2,6 +2,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="bitmap-circle-2.prg", type="prg", segments="Program"]

src/test/ref/bitmap-circle-2.log

@@ -1274,6 +1274,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -2012,11 +2013,11 @@ Removing instruction __b3:
 Removing instruction __b2:
 Removing instruction __b1:
 Succesful ASM optimization Pass5UnusedLabelElimination
-Fixing long branch [154] bmi __b3 to bpl
-Fixing long branch [351] bmi __breturn to bpl
-Fixing long branch [361] bmi __breturn to bpl
-Fixing long branch [365] bmi __breturn to bpl
-Fixing long branch [375] bpl __breturn to bmi
+Fixing long branch [155] bmi __b3 to bpl
+Fixing long branch [352] bmi __breturn to bpl
+Fixing long branch [362] bmi __breturn to bpl
+Fixing long branch [366] bmi __breturn to bpl
+Fixing long branch [376] bpl __breturn to bmi
 
 FINAL SYMBOL TABLE
 constant byte* const BITMAP = (byte*) 8192
@@ -2129,6 +2130,7 @@ Score: 51752
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/bitmap-plot-0.asm

@@ -4,6 +4,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="bitmap-plot-0.prg", type="prg", segments="Program"]

src/test/ref/bitmap-plot-0.log

@@ -1641,6 +1641,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -2443,6 +2444,7 @@ Score: 3200
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/bitmap-plot-3.asm

@@ -4,6 +4,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="bitmap-plot-3.prg", type="prg", segments="Program"]

src/test/ref/bitmap-plot-3.log

@@ -2502,6 +2502,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -3460,7 +3461,7 @@ Removing instruction __b2:
 Removing instruction __breturn:
 Removing instruction __breturn:
 Succesful ASM optimization Pass5UnusedLabelElimination
-Fixing long branch [200] beq __b4 to bne
+Fixing long branch [201] beq __b4 to bne
 
 FINAL SYMBOL TABLE
 constant byte* BITMAP = (byte*) 8192
@@ -3660,6 +3661,7 @@ Score: 26875
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/c64dtv-8bppcharstretch.asm

@@ -1,7 +1,7 @@
 // C64DTV 8bpp charmode stretcher
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/test/ref/c64dtv-8bppcharstretch.log

@@ -1256,7 +1256,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 // C64DTV 8bpp charmode stretcher
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt
@@ -2054,7 +2054,7 @@ Score: 75355
 // C64DTV 8bpp charmode stretcher
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/test/ref/c64dtv-8bppchunkystretch.asm

@@ -1,7 +1,7 @@
 // C64DTV 8bpp charmode stretcher
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/test/ref/c64dtv-8bppchunkystretch.log

@@ -799,7 +799,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 // C64DTV 8bpp charmode stretcher
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt
@@ -1372,7 +1372,7 @@ Score: 19882
 // C64DTV 8bpp charmode stretcher
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/test/ref/c64dtv-blittermin.asm

@@ -1,6 +1,6 @@
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/test/ref/c64dtv-blittermin.log

@@ -416,7 +416,7 @@ ASSEMBLER BEFORE OPTIMIZATION
   // File Comments
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt
@@ -737,7 +737,7 @@ Score: 1553
   // File Comments
 /// @file
 /// C64 DTV version 2 Registers and Constants
-//
+///
 /// Sources
 /// (J) https://www.c64-wiki.com/wiki/C64DTV_Programming_Guide
 /// (H) http://dtvhacking.cbm8bit.com/dtv_wiki/images/d/d9/Dtv_registers_full.txt

src/test/ref/constants.asm

@@ -1,5 +1,6 @@
 /// @file
 /// A lightweight library for printing on the C64.
+///
 /// Printing with this library is done by calling print_ function for each element
   // Commodore 64 PRG executable file
 .file [name="constants.prg", type="prg", segments="Program"]

src/test/ref/constants.log

@@ -1638,6 +1638,7 @@ ASSEMBLER BEFORE OPTIMIZATION
   // File Comments
 /// @file
 /// A lightweight library for printing on the C64.
+///
 /// Printing with this library is done by calling print_ function for each element
   // Upstart
   // Commodore 64 PRG executable file
@@ -2426,6 +2427,7 @@ Score: 1783
   // File Comments
 /// @file
 /// A lightweight library for printing on the C64.
+///
 /// Printing with this library is done by calling print_ function for each element
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/atari2600/atari2600-demo.asm

@@ -2,6 +2,7 @@
 // Source: https://atariage.com/forums/blogs/entry/11109-step-1-generate-a-stable-display/
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
   // Atari 2600 VCS 2K ROM in A26 executable file
 .file [name="atari2600-demo.a26", type="bin", segments="Code, Data, Vectors"]

src/test/ref/examples/atari2600/atari2600-demo.log

@@ -466,6 +466,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 // Source: https://atariage.com/forums/blogs/entry/11109-step-1-generate-a-stable-display/
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
   // Upstart
   // Atari 2600 VCS 2K ROM in A26 executable file
@@ -723,6 +724,7 @@ Score: 8279
 // Source: https://atariage.com/forums/blogs/entry/11109-step-1-generate-a-stable-display/
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
   // Upstart
   // Atari 2600 VCS 2K ROM in A26 executable file

src/test/ref/examples/atari2600/atari2600-sprites.asm

@@ -2,6 +2,7 @@
 // Source: https://atariage.com/forums/blogs/entry/11109-step-1-generate-a-stable-display/
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
   // Atari 2600 VCS 2K ROM in A26 executable file
 .file [name="atari2600-sprites.a26", type="bin", segments="Code, Data, Vectors"]

src/test/ref/examples/atari2600/atari2600-sprites.log

@@ -812,6 +812,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 // Source: https://atariage.com/forums/blogs/entry/11109-step-1-generate-a-stable-display/
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
   // Upstart
   // Atari 2600 VCS 2K ROM in A26 executable file
@@ -1227,6 +1228,7 @@ Score: 10892
 // Source: https://atariage.com/forums/blogs/entry/11109-step-1-generate-a-stable-display/
 /// @file
 /// Atari 2600 Registers and Constants
+///
 /// https://web.archive.org/web/20170215054248/http://www.atariguide.com/pdfs/Atari_2600_VCS_Domestic_Field_Service_Manual.pdf
   // Upstart
   // Atari 2600 VCS 2K ROM in A26 executable file

src/test/ref/examples/c64/3d/perspective.asm

@@ -6,6 +6,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="perspective.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/3d/perspective.log

@@ -1733,6 +1733,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -2726,6 +2727,7 @@ Score: 3117
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/bresenham/bitmap-bresenham.asm

@@ -2,6 +2,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="bitmap-bresenham.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/bresenham/bitmap-bresenham.log

@@ -2345,6 +2345,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -3346,7 +3347,7 @@ Removing instruction __b2:
 Removing instruction __breturn:
 Removing instruction __breturn:
 Succesful ASM optimization Pass5UnusedLabelElimination
-Fixing long branch [247] beq __b4 to bne
+Fixing long branch [248] beq __b4 to bne
 
 FINAL SYMBOL TABLE
 constant byte* const BITMAP = (byte*) 8192
@@ -3538,6 +3539,7 @@ Score: 246362
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/irq/irq-hyperscreen.asm

@@ -3,6 +3,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="irq-hyperscreen.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/irq/irq-hyperscreen.log

@@ -235,6 +235,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -446,6 +447,7 @@ Score: 424
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/multiplexer/simple-multiplexer.asm

@@ -3,6 +3,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="simple-multiplexer.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/multiplexer/simple-multiplexer.log

@@ -1598,6 +1598,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -2493,6 +2494,7 @@ Score: 58107
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/music/music.asm

@@ -3,6 +3,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="music.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/music/music.log

@@ -124,6 +124,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -208,6 +209,7 @@ Score: 1066
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/music/music_irq.asm

@@ -3,6 +3,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="music_irq.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/music/music_irq.log

@@ -163,6 +163,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -302,6 +303,7 @@ Score: 110
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/rasterbars/raster-bars.asm

@@ -2,6 +2,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="raster-bars.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/rasterbars/raster-bars.log

@@ -207,6 +207,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -378,6 +379,7 @@ Score: 8340
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/scroll/scroll.asm

@@ -2,6 +2,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="scroll.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/scroll/scroll.log

@@ -493,6 +493,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -775,6 +776,7 @@ Score: 6262
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/scrollbig/scrollbig.asm

@@ -3,6 +3,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="scrollbig.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/scrollbig/scrollbig.log

@@ -1440,6 +1440,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -2015,6 +2016,7 @@ Score: 20884
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/c64/showlogo/showlogo.asm

@@ -2,6 +2,7 @@
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Commodore 64 PRG executable file
 .file [name="showlogo.prg", type="prg", segments="Program"]

src/test/ref/examples/c64/showlogo/showlogo.log

@@ -569,6 +569,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file
@@ -833,6 +834,7 @@ Score: 3324
 /// Commodore 64 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
   // Commodore 64 PRG executable file

src/test/ref/examples/mega65/dma-test.asm

@@ -4,6 +4,7 @@
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 .cpu _45gs02
   // MEGA65 platform PRG executable starting in MEGA65 mode.

src/test/ref/examples/mega65/dma-test.log

@@ -380,6 +380,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02
@@ -562,6 +563,7 @@ Score: 85
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02

src/test/ref/examples/mega65/dma-test2.asm

@@ -6,6 +6,7 @@
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 .cpu _45gs02
   // MEGA65 platform PRG executable starting in MEGA65 mode.

src/test/ref/examples/mega65/dma-test2.log

@@ -503,6 +503,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02
@@ -746,6 +747,7 @@ Score: 135
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02

src/test/ref/examples/mega65/dma-test3.asm

@@ -6,6 +6,7 @@
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 .cpu _45gs02
   // MEGA65 platform PRG executable starting in MEGA65 mode.

src/test/ref/examples/mega65/dma-test3.log

@@ -537,6 +537,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02
@@ -798,6 +799,7 @@ Score: 147
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02

src/test/ref/examples/mega65/dma-test4.asm

@@ -6,6 +6,7 @@
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 .cpu _45gs02
   // MEGA65 platform PRG executable starting in MEGA65 mode.

src/test/ref/examples/mega65/dma-test4.log

@@ -646,6 +646,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02
@@ -933,6 +934,7 @@ Score: 159
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02

src/test/ref/examples/mega65/dma-test5.asm

@@ -6,6 +6,7 @@
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 .cpu _45gs02
   // MEGA65 platform PRG executable starting in MEGA65 mode.

src/test/ref/examples/mega65/dma-test5.log

@@ -499,6 +499,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02
@@ -742,6 +743,7 @@ Score: 135
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02

src/test/ref/examples/mega65/dma-test6.asm

@@ -6,6 +6,7 @@
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
 .cpu _45gs02
   // MEGA65 platform PRG executable starting in MEGA65 mode.

src/test/ref/examples/mega65/dma-test6.log

@@ -595,6 +595,7 @@ ASSEMBLER BEFORE OPTIMIZATION
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02
@@ -863,6 +864,7 @@ Score: 147
 /// MEGA65 Registers and Constants
 /// @file
 /// The MOS 6526 Complex Interface Adapter (CIA)
+///
 /// http://archive.6502.org/datasheets/mos_6526_cia_recreated.pdf
   // Upstart
 .cpu _45gs02