summaryrefslogtreecommitdiff
path: root/development/rmac/rmac.1
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2017-09-08 00:19:33 +0100
committerDavid Spencer <idlemoor@slackbuilds.org>2017-09-08 00:19:33 +0100
commit8c0ffd397b35cadfca32308acb17fb137e307f10 (patch)
tree0e5d6c99336dd5c46d74c9d98c289f65fc22fef0 /development/rmac/rmac.1
parentb5365b1f400b9e17b1281b9f885543abe1477894 (diff)
downloadslackbuilds-8c0ffd397b35cadfca32308acb17fb137e307f10.tar.gz
development/rmac: Added (cross assembler for 6502 and 68000).
Signed-off-by: David Spencer <idlemoor@slackbuilds.org>
Diffstat (limited to 'development/rmac/rmac.1')
-rw-r--r--development/rmac/rmac.1188
1 files changed, 188 insertions, 0 deletions
diff --git a/development/rmac/rmac.1 b/development/rmac/rmac.1
new file mode 100644
index 0000000000..bf28056a44
--- /dev/null
+++ b/development/rmac/rmac.1
@@ -0,0 +1,188 @@
+.\" Man page generated from reStructuredText.
+.
+.TH RMAC 1 "2017-09-01" "1.8.6" "SlackBuilds.org"
+.SH NAME
+RMAC \- 68000 and 6502 cross assembler
+.
+.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
+..
+.\" 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 x
+Atari 800 com/exe/xex output 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 \-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\-3\fP Enable specific optimisation
+.sp
+~o\fI0\-3\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
+.sp
+\fI4: lea size(An),An to addq #size,An (default: off)\fP
+.sp
+\fI5: Absolute long base displacement to word (default: off)\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.
+.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 in /usr/doc/rmac\-1.8.6/rmac.rst.
+.\" Generated by docutils manpage writer.
+.