Let's suppose that I have this extract in the Skool file
Code: Select all
$F5E6 DEFB $FF,$FF,$FF,$FF,$FF,$FF,$FF,$FF ;
$F5EE DEFB $FF,$FF,$FF,$FF,$FF,$FF,$FF,$FF ;
$F5F6 DEFB $FF,$FF,$FF,$FF,$FF,$FF,$FF,$FF ; }
; Pit Garage SCR attributes data
@label=PIT_GARAGE_ATTR
$F5FE DEFB $78,$79,$7A,$79,$79,$79,$78,$47
$F606 DEFB $47,$47,$47,$47,$47,$47,$47,$47
$F60E DEFB $47,$47,$47,$47,$47,$47,$4F,$4F
Since I want both the Pixels and Attributes to be on the same HTML page, I don't add a breaking line between the 2 sections.
However, by looking at a generated ASM listing, only the values that have an associated page are provided with an appropriate link.
Code: Select all
DrawPitGarage B54A LD A,($83A5)
B54D CP $00
B54F JR Z,DrawPitGarage_0 Skip next block if variable_0_8bit is ZERO
B551 LD A,($6C14)
B554 INC A
B555 CALL $A718
B558 CALL $A691
B55B CALL $A65B
DrawPitGarage_0 B55E LD HL,$4000 Clear entire screen pixels to $00
B561 LD DE,$4001
B564 XOR A
B565 LD BC,$17FF
B568 LD (HL),A
B569 LDIR
B56B LD HL,$5800 Clear entire screen attributes to (White PAPER, Black INK) = $38
B56E LD DE,$5801
B571 LD BC,$02FF
B574 LD (HL),$38
B576 LDIR
B578 LD HL,$EDFE Set pixel data to PIT_GARAGE_PX
B57B LD DE,$4000 Screen Pixel addr
B57E LD BC,$0800 Copy a full screen third
B581 LDIR
All the CALLs have an HTML link on the address being called ($A718, $A691, $A65B), which works great.
But even though the variable (
$EDFE) I defined as PIT_GARAGE_PX is on the start of a page and has a label defined (PIT_GARAGE_PX), the asm instructions where the variable is used, don't get a proper link on the variable address.
However, using the reference
#R$EDFE in the comments, correctly names de variable.
What am I missing ?
Also, to better support references into labels that are within an ASM page, like "DrawPitGarage_0" (code) or "PIT_GARAGE_PX" (data), it would be nice to have support for HTML links with anchors (like: "
.../page.html#label") to the inner labels, defined or contained within a specific page.
NOTE: Assuming this is not supported yet, since I haven't seen it anywhere yet.
This is specially useful, for functions that have several entry points, but which the global function we want it to be on a single page, with all the several entry points it might have, while still being able to highlight all those calls with the proper label name and pointing to the proper HTML page and anchor.