]> Shamusworld >> Repos - rmac/commitdiff
Documentation changes missing from last commit. :-P
authorShamus Hammons <jlhamm@acm.org>
Mon, 30 May 2022 18:17:20 +0000 (13:17 -0500)
committerShamus Hammons <jlhamm@acm.org>
Mon, 30 May 2022 18:17:20 +0000 (13:17 -0500)
docs/rmac.rst

index e8ba296f2ad46db79b85d8620f9c7a08697237b7..d46f9c5712603f9b73a36a059022415817b25219 100644 (file)
@@ -153,9 +153,9 @@ Switch               Description
                       `jerry - Jaguar DSP JRISC`
 
                       -o\ *file[.o]*       Direct object code output to the specified file.
-+/~oall              Turn all optimisations on/off
-+o\ *0-10*/*p*       Enable specific optimisation
-~o\ *0-10*/*p*       Disable specific optimisation
++/~oall               Turn all optimisations on/off
++o\ *0-30*/*p*        Enable specific optimisation
+~o\ *0-30*/*p*        Disable specific optimisation
 
                       `0: Absolute long adddresses to word (on by default)`
 
@@ -177,7 +177,12 @@ Switch               Description
 
                       `9: Convert adda.w/l #x,Dy to lea x(Dy),Dy`
 
-                      `p: Force PC-Relative mode (alternative: o10)`
+                      `10: 56001 Use short format for immediate values if possible`
+
+                      `11: 56001 Auto convert short addressing mode to long (default: on)`
+
+                      `o30: Enforce PC relative (alternative name: op)`
+
 -p                   Produce an executable (**.prg**) output file.
 -ps                  Produce an executable (**.prg**) output file with symbols.
 -px                  Produce an executable (**.prg**) output file with extended symbols.
@@ -628,7 +633,7 @@ and may not be used as symbols (e.g. labels, equates, or the names of macros):
       a0 a1 a2 a3 a4 a5 a6 a7
       Tom/Jerry:
       r0 r1 r2 r3 r4 r5 r6 r7
-      r8 r9 r10 r11 r12 rl3 r14 ri5
+      r8 r9 r10 r11 r12 rl3 r14 r15
       6502:
       x y a
       DSP56001:
@@ -925,7 +930,7 @@ symbol **debug** external, instead of including another source file).
 Assembler directives may be any mix of upper- or lowercase. The leading periods
 are optional, though they are shown here and their use is encouraged. Directives
 may be preceeded by a label; the label is defined before the directive is executed.
-Some directives accept size suffixes (**.b**, **.s**, **.w**, **.1**, **.d**, **.x**, **.p**, or  **.q**); 
+Some directives accept size suffixes (**.b**, **.s**, **.w**, **.1**, **.d**, **.x**, **.p**, or  **.q**);
 the default is word (**.w**) if no size is specified. The **.s** suffix is identical to **.b**,
 with the exception of being used in a **dc** statement. In that case the **.s**
 refers to single precision floating point numbers.
@@ -1066,7 +1071,6 @@ Directives relating to the 6502 are described in the chapter on `6502 Support`_.
    Start an absolute section, beginning with the specified location (or zero, if
    no location is specified). An absolute section is much like BSS, except that
    locations declared with .ds are based absolute. This directive is useful for
-
    declaring structures or hardware locations.
    For example, the following equates:
 
@@ -1572,16 +1576,14 @@ The assembler provides "creature comforts" when it processes 68000 mnemonics:
  * All optimisations are turned off for any source line that has an exclamation mark
    (*!*) on their first column.
 
- * Optimisation switches 0, 1 and 2 are turned on by default for legacy reasons.
+ * Optimisation switch 11 is turned on by default for compatibility with the
+   Motorola reference 56001 DSP assembler.
    All other levels are off by default. (refer to section `The Command Line`_
    for a description of all the switches).
 
  * Optimisation warnings are off by default. Invoke RMAC with the *-s* switch to
    turn on warnings in console and listing output.
 
- * In DSP56001 mode size optimisations are on by default. Currently there is no
-   way to disable this behaviour.
-
  * In GPU/DSP code sections, you can use JUMP (Rx) in place of JUMP T, (Rx) and JR
    (Rx) in place of JR T,(Rx).
 
@@ -2023,7 +2025,7 @@ Atari Falcon XBIOS) and *.p56* (binary equivalent of *.lod*)
 
 `6502 Support`_
 ===============
-RMAC will generate code for the Motorola 6502 microprocessor. This chapter
+RMAC will generate code for the MOS 6502 microprocessor. This chapter
 describes extra addressing modes and directives used to support the 6502.
 
 As the 6502 object code is not linkable (currently there is no linker) external
@@ -2181,10 +2183,6 @@ order, along with a short description of what may have caused the problem.
 
     You tried to ``.comm`` a symbol that was already defined.
 
-**.ds permitted only in BSS**
-
-    You tried to use ``.ds`` in the text or data section.
-
 **.init not permitted in BSS or ABS**
 
     You tried to use ``.init`` in the BSS or ABS section.
@@ -2450,11 +2448,6 @@ order, along with a short description of what may have caused the problem.
   You followed a ^^ with something other than one of the names defined, referenced
   or streq.
 
-**unsupported 68020 addressing mode**
-
-  The assembler saw a 68020-type addressing mode. RMAC does not assemble
-  code for the 68020 or 68010.
-
 **unterminated string**
 
   You specified a string starting with a single or double quote, but forgot to type