diff options
Diffstat (limited to 'development/pli/plic.1')
| -rw-r--r-- | development/pli/plic.1 | 216 |
1 files changed, 216 insertions, 0 deletions
diff --git a/development/pli/plic.1 b/development/pli/plic.1 new file mode 100644 index 0000000000..6e2bd2a6d9 --- /dev/null +++ b/development/pli/plic.1 @@ -0,0 +1,216 @@ +.\" 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 "PLIC" 1 "2022-01-17" "0.9.10d" "SlackBuilds.org" +.SH NAME +plic \- Iron Spring PL/I Compiler for x86 Linux +.\" RST source for plic(1) man page. Convert with: +. +.\" rst2man.py plic.rst > plic.1 +. +.\" rst2man.py comes from the SBo development/docutils package. +. +.\" This is mostly copypasta from prog_guide.html, with a bit +. +.\" of commentary explaining things that aren't entirely clear. +. +.SH SYNOPSIS +.sp +plic [\fIoptions\fP] <input\-files> [\fI\-o\fP output\-file] +.SH DESCRIPTION +.sp +\fBplic\fP is a compiler for the PL/I language. +.sp +This man page doesn\(aqt attempt to fully document \fBplic\fP\&. It\(aqs just +intended as a reference for the command\-line options and arguments. +For full documentation, see: /usr/doc/pli\-0.9.10d/prog_guide.html +.sp +\&...and the other HTML and PDF documents found in the same directory. +.sp +One major difference between \fBplic\fP and other compilers for other +languages you may have used: \fBplic\fP doesn\(aqt link executables +nor call \fBld\fP(1) to link them as e.g. \fBgcc\fP(1) does. \fBplic\fP +produces object files (named with \fI\&.o\fP extension), which must then be +linked with a separate \fBld\fP command. The full documentation explains +this, and there is also a sample Makefile for building a simple +PL/I application, found in: /usr/doc/pli\-0.9.10d/samples/SA_make +.sp +The \fBpli\fP SlackBuilds.org package also includes a \fBplicl\fP wrapper +script, which does compiling and linking in one step, at least for +simple PL/I programs. It has its own man page. +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-V +Print version and copyright info to stderr (not stdout!) and exit. +.TP +.B \-S +Generate assembler (symbolic) output. Default output filename is +the input filename with the extension changed to \fI\&.asm\fP (use \fB\-o\fP to +change it). +.TP +.B \-C +Generate compiled (object code) output. Default object filename is +the input filename with the extension changed to \fI\&.o\fP (use \fB\-o\fP to +change it). A listing file (extension \fI\&.lst\fP) is also created. This +option should always be used when compiling; without it, \fBplic\fP +still generates an object file, but confusingly, its extension will +be \fI\&.exe\fP, and no \fI\&.lst\fP file will be created. +.TP +.B \-N +Generate statement number tables to provide information for run\-time +error messages. +.UNINDENT +.INDENT 0.0 +.TP +.B \fB\-o\fP \fIfile\fP +Set the output filename. The space between the option and argument +is optional. +.TP +.B \fB\-i\fP \fIdirectory\fP +Use \fIdirectory\fP as the absolute or relative path to a directory to +be searched for %INCLUDE files. This option may be used more than once on the +command line, and directories will be searched in the order listed. +The space between the option and argument is optional. Note that +you must use \fB\-i .\fP if you want to search for include files in the +current directory. +.TP +.B \fB\-l[saxgmov]\fP +Listing options. One or more of [saxgmov] may be entered, in any +order, e.g. \fB\-lsx\fP\&. +.INDENT 7.0 +.TP +.BI \-l\fB s +list source +.TP +.BI \-l\fB a +list attributes +.TP +.BI \-l\fB x +list cross\-reference +.TP +.BI \-l\fB g +list aggregates +.TP +.BI \-l\fB m +list generated code in a format similar to a disassembly. +.TP +.BI \-l\fB o +list procedure map (statement offset table) +.TP +.BI \-l\fB v +list additional warning messages +.UNINDENT +.TP +.B \fB\-m(start[,end])\fP +This option defines the first and last positions of each +input line that contain input for the compiler. If this +option is omitted the source is assumed to be the entire line. +This option is included for compatibility with mainframe compilers +which would use, for example, \-m(2,72). +.TP +.B \fB\-cn(<list>)\fP, \fB\-co(<list>)\fP +These options define up to four characters each to be used as +substitutions for the NOT(¬) [\-cn()] and/or OR(|) [\-co()] +operator IN ADDITION TO the defaults. Parentheses are metacharacters +in most Linux shells, so quote these options with either single\- or +double\-quotes. +.TP +.B \fB\-e[wsd]\fP +Error options. Can be combined, e.g. \-ewd. Normally, the compiler\(aqs +exit status is 4 if only warnings were issued, and 8 for any errors +in the code [but, exit status is 0 for errors like "Input file not found"]. +These options are useful when the compiler is run from a script or Makefile. +.INDENT 7.0 +.TP +.BI \-e\fB w +Tells the compiler to exit with 0 status if only warning messages +were issued. +.TP +.BI \-e\fB s +Tells the compiler to exit with 0 status if any errors \fIor\fP +warnings were issued. +.TP +.BI \-e\fB d +Display messages on stderr, as well as stdout. Normally, stdout +is the .lst file, so this option allows you to see any compile +errors/warnings immediately, without scrolling through the +listing. +.UNINDENT +.TP +.B \fB\-d<option>\fP +<options> is a character string, with or without enclosing quotes. +.INDENT 7.0 +.TP +.BI \-d\fB LIB +Tells the compiler it is compiling a standard run\-time library procedure. +.TP +.BI \-d\fB ELF +Causes the compiler to generate ELF object files (already the default, on Linux). +.TP +.BI \-d\fB OMF +Causes the compiler to generate OMF object files (this is the default on OS/2). +.UNINDENT +.UNINDENT +.\" FILES +. +.\" ===== +. +.\" ENVIRONMENT +. +.\" =========== +. +.\" EXIT STATUS +. +.\" =========== +. +.\" BUGS +. +.\" ==== +. +.\" EXAMPLES +. +.\" ======== +. +.SH COPYRIGHT +.sp +See the file /usr/doc/pli\-0.9.10d/readme_linux.html for license information. +.SH AUTHORS +.sp +plic is copyright Iron Spring Software. +.sp +This man page written for the SlackBuilds.org project +by B. Watson, and is licensed under the WTFPL. +.SH SEE ALSO +.sp +\fBplicl\fP(1), \fBld\fP(1) +.sp +\fI\%http://www.iron\-spring.com/\fP +.\" Generated by docutils manpage writer. +. |