From: cuz Date: Sat, 23 Aug 2003 21:32:23 +0000 (+0000) Subject: Alphabetical attribute sort and more additions X-Git-Tag: V2.12.0~1351 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=f0f5fb8d11d507b4957b68581b35aec8928af909;p=cc65 Alphabetical attribute sort and more additions git-svn-id: svn://svn.cc65.org/cc65/trunk@2413 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- diff --git a/doc/da65.sgml b/doc/da65.sgml index 343bbee83..5eff77538 100644 --- a/doc/da65.sgml +++ b/doc/da65.sgml @@ -233,6 +233,13 @@ anything). Each attribute is terminated by a semicolon. +Comments

+ +Comments start with a hash mark (Specifying global options

Global options may be specified in a group with the name COMMENTS - This attribute may be used instead of the option on the command line. It takes a numerical parameter between 0 and 4. Higher values increase the amount of information @@ -249,34 +255,29 @@ following attributes are recognized: CPU - This attribute may be used instead of the option on the command line. It takes a string parameter. INPUTNAME - The attribute is followed by a string value, which gives the name of the input file to read. If it is present, the disassembler does not accept an input file name on the command line. INPUTOFFS - The attribute is followed by a numerical value that gives an offset into the input file which is skipped before reading data. The attribute may be used to skip headers or unwanted code sections in the input file. INPUTSIZE - OUTPUTNAME - The attribute is followed by string value, which gives the name of the output file to write. If it is present, specification of an output file on the command line using the option is @@ -287,7 +288,6 @@ following attributes are recognized: PAGELENGTH - This attribute may be used instead of the option on the command line. It takes a numerical parameter. Using zero as page length (which is the default) means that no @@ -295,7 +295,6 @@ following attributes are recognized: STARTADDR - This attribute may be used instead of the option on the command line. It takes a numerical parameter. The default for the start address is $10000 minus the size of @@ -312,48 +311,45 @@ following attributes are recognized: - START - - This gives the start address of the range. - - END - This gives the end address of the range. The end address is inclusive, that means, it is part of the range. Of course, it may not be smaller than the start address. + NAME + This is a convenience attribute. It takes a string argument and will cause + the disassembler to define a label for the start of the range with the + given name. So a separate + directive is not needed. - TYPE + START + This gives the start address of the range. + TYPE This attribute specifies the type of data within the range. The attribute value is one of the following keywords: - CODE - The range consists of code. + ADDRTABLE + The range consists of data and is disassembled as a table of words + (16 bit values). The difference to the BYTETABLE The range consists of data and is disassembled as a byte table. + CODE + The range consists of code. + DBYTETABLE The range consists of data and is disassembled as a table of dbytes (double byte values, 16 bit values with the low byte containing the most significant byte of the 16 bit value). - WORDTABLE - The range consists of data and is disassembled as a table of words - (16 bit values). - DWORDTABLE The range consists of data and is disassembled as a table of double words (32 bit values). - ADDRTABLE - The range consists of data and is disassembled as a table of words - (16 bit values). The difference to the RTSTABLE The range consists of data and is disassembled as a table of words (16 bit values). The values are interpreted as words that are pushed onto the @@ -361,41 +357,40 @@ following attributes are recognized: TEXTTABLE - The range consists of readable text. - SKIP - The range is simply ignored when generating the output file. Please note + The range is simply ignored when generating the output file. Please note that this means that reassembling the output file will TEXTTABLE + The range consists of readable text. + + WORDTABLE + The range consists of data and is disassembled as a table of words + (16 bit values). + -Specifying Labels

+Specifying Labels

The - NAME - - The attribute is followed by a string value which gives the name of the - label. - - ADDR - Followed by a numerical value. Specifies the value of the label. + NAME + The attribute is followed by a string value which gives the name of the + label. SIZE - This attribute is optional and may be used to specifiy the size of the data that follows. If a size greater than 1 is specified, the disassembler will create labels in the form + # This is a comment. It extends to the end of the line GLOBAL { - OUTPUTNAME "kernal.s"; - INPUTNAME "kernal.bin"; - STARTADDR $E000; - PAGELENGTH 0; # No paging - CPU "6502"; + OUTPUTNAME "kernal.s"; + INPUTNAME "kernal.bin"; + STARTADDR $E000; + PAGELENGTH 0; # No paging + CPU "6502"; };