Labels included to your original source will help Disark to know if a “region” or “area” contains code, bytes, words, or pointers.<\/p>\n\n\n\n
You can also specify more semantics, please check the examples below.<\/p>\n\n\n\n
The labels are spotted by Disark via their inner tag. The tag can <\/em>have a prefix, and must <\/em>have a postfix:<\/p>\n\n\n\n Correct:<\/strong><\/p>\n\n\n\n Incorrect:<\/strong><\/p>\n\n\n\n One opened region must also have an end. They can overlap!<\/p>\n\n\n\n Disark tries to link pointers to the best\/closest reference it knows. However, it only tries to match references that are +\/- 10 bytes in vicinity<\/strong>, as it appears to be what is the most practical. If this behavior does not suit you, you can use the “force reference” labels below.<\/p>\n\n\n\n These are default and you shouldn’t really have to use them.<\/p>\n\n\n\n To be used for declaring bytes (DB 1, 2, 3, etc.).<\/p>\n <\/p>\n\n\n Use this to declare words (DW 1, 2, 3, etc.). Reference will not<\/strong> be inferred for such regions. So they will not be modified in case of relocation.<\/p>\n\n\n Use these to declare an array of pointers. References will<\/strong> be found if possible.<\/p>\n\n\n When used, this will force a reference to be used. For example, if you want a Word or a Pointer to use a reference, you can use such labels. Even if a label is far away, it will<\/strong> be used because you forced a reference!<\/p>\n\n\n On the opposite, this forces the non-use of a reference. For example, your code is addressing an input\/ouput port<\/strong> (out (#a0),a or ld bc,#7f00)). This must not be changed when the code is relocated! (for a simpler use, check the next labels).<\/p>\n <\/p>\n <\/p>\n\n\n Forces the referencing for an area composed of X bytes. X must be between 1 and 9, inclusive. Simpler than declaring an area like above! An example:<\/p>\n\n\n Normally, the LD instruction should not be referencing LABEL because too far from it. By forcing the reference, Disark will use the closed label, no matter how far it is. On the opposite, this forces the non-use of a reference during X bytes (from 1 to 9 inclusive). Example:<\/p>\n\n\n The following Word will be using a reference, no matter how far it is. No need to declare a Word Region, which can be bothersome! Example:<\/p>\n\n\n The following Word will not<\/strong> be using a reference. No need to declare a Word Region. Example:<\/p>\n\n\n Some assemblers (to my knowledge, only SDCC) will require some labels to be marked in a special way for C code to be able to reach Z80 labels. This is doable with Disark! Duplicate your external label and mark it with a special tag:<\/p>\n\n\n\nMyCode_DisarkCodeRegionStart_Stuff\nDisarkCodeRegionStart1\nDisarkCodeRegionEnd1<\/code><\/pre>\n\n\n\nYeahDisarkCodeRegionStart ;No postfix!<\/code><\/pre>\n\n\n\n ld hl,0\nMyGame_DisarkByteRegionStart_1\n db ...\nMyGame_DisarkByteRegionEnd_1 ;Closing the Byte region \"_1\".\n\nMyGame_DisarkWordRegionStart_1\n dw ...\n\n;Error! MyGame_DisarkWordRegionStart_1 was not closed! <\/code><\/pre>\n\n\n\nReferences distance<\/h2>\n\n\n\n
Labels understood by Disark <\/h2>\n\n\n\n
Code region<\/h3>\n\n\n\n
...DisarkCodeRegionStart...\n...DisarkCodeRegionEnd...<\/code><\/pre>\n\n\n\nByte region<\/h3>\n\n\n\n
...DisarkByteRegionStart...\n...DisarkByteRegionEnd...<\/code><\/pre>\n\n\nWord region<\/h3>\n\n\n\n
...DisarkWordRegionStart...\n...DisarkWordRegionEnd...<\/code><\/pre>\n\n\nPointer region<\/h3>\n\n\n\n
...DisarkPointerRegionStart...\n...DisarkPointerRegionEnd...<\/code><\/pre>\n\n\nForce-reference area<\/h3>\n\n\n\n
...DisarkForceReferenceAreaStart...\n...DisarkForceReferenceAreaEnd...<\/code><\/pre>\n\n\nForce-non-reference area <\/h3>\n\n\n\n
...DisarkForceNonReferenceAreaStart...\n...DisarkForceNonReferenceAreaEnd...<\/code><\/pre>\n\n\nForce-reference during…<\/h3>\n\n\n\n
...DisarkForceReferenceDuring<X>...<\/code><\/pre>\n\n\nLABEL equ #1000\nDisarkForceReferenceDuring3_Hello ;ld hl,xxxx takes 3 bytes.\n ld hl,LABEL + #3000<\/code><\/pre>\n\n\n
<\/p>\n\n\nForce-non-reference during… <\/h3>\n\n\n\n
...DisarkForceNonReferenceDuring<X>...<\/code><\/pre>\n\n\n org #7f00\nSTART\n ld hl,#7f00 ;This is an IO port on CPC! We don't want it to be changed by relocation!\n out (c),c\n\nSo...\n\nDisarkForceNonReferenceDuring3_1 ld hl,#7f00 ;Safe! Will not be using the START reference.\n out (c),c<\/code><\/pre>\n\n\n\nForce reference for next word<\/h3>\n\n\n\n
...DisarkWordForceReference...<\/code><\/pre>\n\n\n org #1000\nLabel1 ld hl,0\n ...\n ret\nDisarkWordForceReference_HiMum dw Label1 ;This declares a Word Region, using a reference.<\/code><\/pre>\n\n\n\nForce-non-reference for next word<\/h3>\n\n\n\n
...DisarkWordForceNonReference...<\/code><\/pre>\n\n\n org #1000\nLabel1 ld hl,0\n ...\n ret\nDisarkWordForceNonReference_HiDad dw #7f00 ;This declares a Word Region, and it will never reference any label.<\/code><\/pre>\n\n\n\nExternal labels<\/h3>\n\n\n\n
MyLabelDisarkGenerateExternalLabel<\/strong>\nMyLabel\n ld hl,0\n ... <\/pre>\n\n\n\n