slackbuilds/development/rmac/rmac.1

.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "RMAC" 1 "2023-01-03" "2.2.14_20221221" "SlackBuilds.org"
.SH NAME
rmac \- 68000 and 6502 cross assembler
.\" RST source for rmac(1) man page. Convert with:
.
.\" rst2man.py rmac.rst > rmac.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
rmac [\fI\-options\fP] \fIsource\-file\fP [\fIsource\-file ...\fP]
.SH DESCRIPTION
.sp
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\(aqt 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!
.SH OPTIONS
.sp
\-dname\fI[=value]\fP   Define symbol, with optional value.
.sp
\-e\fI[file[.err]]\fP   Direct error messages to the specified file.
.INDENT 0.0
.TP
.BI \-f\fB a
ALCYON output object file format (implied when \fB\-p\fP or \fB\-ps\fP is enabled).
.TP
.BI \-f\fB b
BSD COFF output object file format.
.TP
.BI \-f\fB e
ELF output object file format.
.TP
.BI \-f\fB r
Absolute address. Source is required to have only one \fB\&.org\fP\&.
.TP
.BI \-f\fB x
Atari 800 com/exe/xex output object file format.
.TP
.B  \-g
Generate source level debug info. Requires BSD COFF object file format.
.UNINDENT
.INDENT 0.0
.TP
.B \-i\fIpath\fP           Set include\-file directory search path. \fINote\fP this is a
\fBsemicolon\fP separated list of directories.
.UNINDENT
.sp
\-l\fI[file[prn]]\fP    Construct and direct assembly listing to the specified file.
.sp
\-l\fI*[filename]\fP   Create an output listing file without pagination.
.INDENT 0.0
.TP
.B \-m\fIcpu\fP            Set default CPU type. Choices are: \fB68000\fP \fB68020\fP
\fB68030\fP \fB68040\fP \fB68060\fP \fB68881\fP \fB68882\fP
\fB56001\fP \fB6502\fP \fBtom\fP \fBjerry\fP
.UNINDENT
.INDENT 0.0
.TP
.B  \-n
Don\(aqt do things behind your back in RISC assembler.
.UNINDENT
.sp
\-o\fIfile[.o]\fP       Direct object code output to the specified file.
.sp
+/~oall              Turn all optimisations on/off
.sp
+o\fI0\-30\fP           Enable specific optimisation
.sp
~o\fI0\-30\fP           Disable specific optimisation
.INDENT 0.0
.INDENT 3.5
\fI0: Absolute long adddresses to word (default: on)\fP
.sp
\fI1: move.l #x,dn/an to moveq (default: on)\fP
.sp
\fI2: Word branches to short (default: on)\fP
.sp
\fI3: Outer displacement 0(an) to (an) (default: on)\fP
\fI4: lea size(An),An to addq #size,An (default: off)\fP
\fI5: 68020+ Absolute long base displacement to word (default: off)\fP
.sp
\fI6: Convert null short branches to NOP\fP
.sp
\fI7: Convert clr.l Dn to moveq #0,Dn\fP
.sp
\fI8: Convert adda.w/l #x,Dy to addq.w/l #x,Dy\fP
.sp
\fI9: Convert adda.w/l #x,Dy to lea x(Dy),Dy\fP
.sp
\fI10: 56001 Use short format for immediate values if possible\fP
.sp
\fI11: 56001 Auto convert short addressing mode to long (default: on)\fP
.sp
\fI30: Enforce PC relative (alternative name: op)\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B  \-p
Produce an executable (\fB\&.prg\fP) output file.
.TP
.BI \-p\fB s
Produce an executable (\fB\&.prg\fP) output file with symbols.
.TP
.B  \-q
Make RMAC resident in memory (Atari ST only).
.UNINDENT
.INDENT 0.0
.TP
.B \-r \fIsize\fP            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.
.INDENT 7.0
.INDENT 3.5
\fI\-rw Word (2 bytes, default alignment)\fP
.sp
\fI\-rl Long (4 bytes)\fP
.sp
\fI\-rp Phrase (8 bytes)\fP
.sp
\fI\-rd Double Phrase (16 bytes)\fP
.sp
\fI\-rq Quad Phrase (32 bytes)\fP
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B  \-s
Warn about unoptimized long branches and applied optimisations.
.TP
.B  \-u
Force referenced and undefined symbols global.
.TP
.B  \-v
Verbose mode (print running dialogue).
.TP
.B  \-x
Turn on debugging mode
.TP
.BI \-y\fB n
Set listing page size to n lines.
.TP
.B  \-4
Use C style operator precedence.
.UNINDENT
.sp
file\fI[s]\fP          Assemble the specified file.
.SH FILES
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B /usr/share/rmac/atari.s
Atari ST system equates.
.UNINDENT
.UNINDENT
.UNINDENT
.SH ENVIRONMENT
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B RMACPATH
Semicolon\-separated list of directories to search for include files.
.UNINDENT
.UNINDENT
.UNINDENT
.SH AUTHORS
.sp
rmac is Copyright (C) 199x Landon Dyer, 2011\-2017 Reboot.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
\fIhatari\fP(1)
.sp
The full \fBrmac\fP documentation: /usr/doc/rmac\-2.2.14_20221221/rmac.html
.\" Generated by docutils manpage writer.
.