diff options
Diffstat (limited to 'development/rmac/rmac.1')
| -rw-r--r-- | development/rmac/rmac.1 | 188 |
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. +. |