development/pli: Added (Iron Spring PL/I Compiler).

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

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.
+.