139 lines
4.0 KiB
ReStructuredText
139 lines
4.0 KiB
ReStructuredText
.. 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.
|