diff options
Diffstat (limited to 'development/rmac/rmac.rst')
| -rw-r--r-- | development/rmac/rmac.rst | 138 |
1 files changed, 138 insertions, 0 deletions
diff --git a/development/rmac/rmac.rst b/development/rmac/rmac.rst new file mode 100644 index 0000000000..aeb8d8eaf7 --- /dev/null +++ b/development/rmac/rmac.rst @@ -0,0 +1,138 @@ +.. RST source for rmac(1) man page. Convert with: +.. rst2man.py rmac.rst > rmac.1 +.. rst2man.py comes from the SBo development/docutils package. + +.. |version| replace:: 1.8.6 +.. |date| date:: + +==== +RMAC +==== + +------------------------------ +68000 and 6502 cross assembler +------------------------------ + +:Manual section: 1 +:Manual group: SlackBuilds.org +:Date: |date| +:Version: |version| + +SYNOPSIS +======== + +rmac [*-options*] *source-file* [*source-file ...*] + +DESCRIPTION +=========== + +RMAC began its life as MADMAC. It was initially written at Atari +Corporation by programmers who needed a high performance assembler for +their work. Then, more than 20 years later, because there was still a need +for such an assembler and what was available wasn't up to expectations, +Subqmod and eventually Reboot continued work on the freely released +source, adding Jaguar extensions and fixing bugs. And of course recently +6502 support was added back! + +OPTIONS +======= + +-dname\ *[=value]* Define symbol, with optional value. + +-e\ *[file[.err]]* Direct error messages to the specified file. + +-fa ALCYON output object file format (implied when **-p** or **-ps** is enabled). + +-fb BSD COFF output object file format. + +-fe ELF output object file format. + +-fx Atari 800 com/exe/xex output object file format. + +-i\ *path* Set include-file directory search path. *Note* this is a + **semicolon** separated list of directories. + +-l\ *[file[prn]]* Construct and direct assembly listing to the specified file. + +-l\ *\*[filename]* Create an output listing file without pagination + +-n Don't do things behind your back in RISC assembler + +-o\ *file[.o]* Direct object code output to the specified file. + ++/~oall Turn all optimisations on/off + ++o\ *0-3* Enable specific optimisation + +~o\ *0-3* Disable specific optimisation + + `0: Absolute long adddresses to word (default: on)` + + `1: move.l #x,dn/an to moveq (default: on)` + + `2: Word branches to short (default: on)` + + `3: Outer displacement 0(an) to (an) (default: on)` + + `4: lea size(An),An to addq #size,An (default: off)` + + `5: Absolute long base displacement to word (default: off)` + +-p Produce an executable (**.prg**) output file. + +-ps Produce an executable (**.prg**) output file with symbols. + +-q Make RMAC resident in memory (Atari ST only). + +-r *size* automatically pad the size of each + segment in the output file until the size is an integral multiple of the + specified boundary. Size is a letter that specifies the desired boundary. + + `-rw Word (2 bytes, default alignment)` + + `-rl Long (4 bytes)` + + `-rp Phrase (8 bytes)` + + `-rd Double Phrase (16 bytes)` + + `-rq Quad Phrase (32 bytes)` + +-s Warn about unoptimized long branches and applied optimisations. + +-u Force referenced and undefined symbols global. + +-v Verbose mode (print running dialogue). + +-x Turn on debugging mode + +-yn Set listing page size to n lines. + +file\ *[s]* Assemble the specified file. + +FILES +===== + + /usr/share/rmac/atari.s + Atari ST system equates. + +ENVIRONMENT +=========== + + RMACPATH + Semicolon-separated list of directories to search for include files. + +AUTHORS +======= + +rmac is Copyright (C) 199x Landon Dyer, 2011-2017 Reboot. + +This man page written for the SlackBuilds.org project +by B. Watson, and is licensed under the WTFPL. + +SEE ALSO +======== + +*hatari*\ (1) + +The full **rmac** documentation in /usr/doc/rmac-|version|/rmac.rst. |