From 333b605b2afd472b823aeda0adf0e8b1ea9843c0 Mon Sep 17 00:00:00 2001
From: fishsoupisgood <github@madingley.org>
Date: Mon, 27 May 2019 02:41:51 +0100
Subject: initial commit from asl-1.41r8.tar.gz

---
 plist.1 | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 plist.1

(limited to 'plist.1')

diff --git a/plist.1 b/plist.1
new file mode 100644
index 0000000..180de5f
--- /dev/null
+++ b/plist.1
@@ -0,0 +1,84 @@
+.TH plist 1
+
+.SH NAME
+.B plist \- list contents of output files generated by AS
+
+.SH SYNTAX
+.B plist
+[ file name ]
+
+.SH DESCRIPTION
+
+PLIST is a program to list the contents of code output files generated by
+AS, a cross assembler for a variety of microprocessors and -controllers.
+PLIST takes only one argument: the name of the file to list.  If [ name ]
+does not have an extension, the default extension '.p' will be added
+automatically.  The output consists of a single line for each record in 
+the file, listing the target processor, target address space, number of 
+code/data bytes, and start/stop address.  Note that the difference between 
+the start and stop address need not equal the number of bytes, since there
+are target processors whose memory is not bytewise-organized.  The records
+that specify entry address and file creator have a different layout and
+therefore have a little bit different look in PLIST's output.
+
+PLIST does not accept multiple file arguments; processing of several files
+must be done with individual calls.
+
+.SH COMMAND-LINE PARAMETERS
+
+none.
+
+.SH NATIONAL LANGUAGE SUPPORT
+
+plist supports national languages in the same way as AS.  See the manual
+page for asl(1) for maore information about this.
+
+.SH RETURN CODES
+
+.B plist
+may return with the following codes:
+.TP
+.B 0
+no errors.
+.TP
+.B 1
+incorrect command line parameters.
+.TP
+.B 2
+I/O-error.
+.TP
+.B 3
+An input file had an incorrect format.
+
+.SH EXAMPLES
+
+To list the contents of a code file
+.B file1.p,
+use:
+.PP
+.B plist file1
+.PP
+There aren't more meaningful examples, as PLIST does not have
+any command line parameters.
+
+.SH TIPS
+
+If PLIST is started without any argument, it will prompt for a file's name.
+
+.SH SEE ALSO
+
+asl(1), pbind(1), p2hex(1), p2bin(1)
+
+.SH HISTORY
+
+PLIST originally appeared as an AS tool in 1992, written in
+Borland-Pascal, and was ported to C and UNIX in 1996.
+
+.SH BUGS
+
+There are too few options.
+
+.SH AUTHOR(S)
+
+Alfred Arnold (a.arnold@kfa-juelich.de)
+
-- 
cgit v1.2.3