system/isextract: Update man page.

Signed-off-by: B. Watson <yalhcru@gmail.com>

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

1 files changed, 27 insertions, 17 deletions

diff --git a/system/isextract/isextract.1 b/system/isextract/isextract.1
index 318ac7fabd19b..3886f5742a9fb 100644
--- a/system/isextract/isextract.1
+++ b/system/isextract/isextract.1
@@ -1,8 +1,5 @@
 .\" Man page generated from reStructuredText.
 .
-.TH ISEXTRACT 1 "2020-04-29" "20141107_5adb0af" "SlackBuilds.org"
-.SH NAME
-isextract \- Extract InstallShield v3 archives
 .
 .nr rst2man-indent-level 0
 .
@@ -30,28 +27,27 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
+.TH "ISEXTRACT" 1 "2022-01-12" "20141107_5adb0af" "SlackBuilds.org"
+.SH NAME
+isextract \- Extract InstallShield v3 archives
 .\" RST source for isextract(1) man page. Convert with:
 .
 .\" rst2man.py isextract.rst > isextract.1
 .
 .\" rst2man.py comes from the SBo development/docutils package.
 .
-.\" converting from pod:
-.
-.\" s/B<\([^>]*\)>/**\1**/g
-.
-.\" s/I<\([^>]*\)>/*\1*/g
-.
 .SH SYNOPSIS
 .sp
-isextract [\fIl|x\fP] file.z
+isextract [\fIl\fP] \fIfile.z\fP
+.sp
+isextract [\fIx\fP] \fIfile.z\fP [\fIoutput\-dir\fP]
 .SH DESCRIPTION
 .sp
-isextract is a command line tool to extract the .z InstallShield v3
+\fBisextract\fP is a command line tool to extract the .Z InstallShield v3
 packages many old windows games were distributed as.
 .sp
-The files isextract supports normally have a \fB\&.z\fP extension, and can be
-idenfified by the file command:
+The files \fBisextract\fP supports normally have a \fB\&.Z\fP extension, and can be
+idenfified by the \fBfile\fP(1) command:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -77,13 +73,27 @@ $ head \-c6 data.z | xxd
 .UNINDENT
 .UNINDENT
 .SH OPTIONS
+.INDENT 0.0
+.TP
+.B \fBl\fP
+List contents of archive.
+.TP
+.B \fBx\fP
+Extract archive. If an \fIoutput\-dir\fP is given, extracted files will be written
+there (the \fIoutput\-dir\fP must already exist). Without \fIoutput\-dir\fP, the current
+directory is used.
+.UNINDENT
 .sp
-\fBl\fP       List contents of archive.
+If \fBfile\fP says "compress\(aqd data" or similar, your file isn\(aqt an
+InstallShield archive; it\(aqs compressed with the old UNIX compress
+command, and can be extracted with \fBuncompress\fP(1) or \fBgzip\fP(1).
 .sp
-\fBx\fP       Extract archive to current directory.
+When extracting, \fBisextract\fP \fIDOES NOT\fP preserve the directory structure
+inside the archive. All files are written to the same directory. If you
+need the directories, use \fBunshieldv3\fP instead.
 .SH COPYRIGHT
 .sp
-See the file /usr/doc/PRGNAM\-20141107_5adb0af/LICENSE for license information.
+See the file /usr/doc/isextract\-20141107_5adb0af/LICENSE for license information.
 .SH AUTHORS
 .sp
 isextract was written by OmniBlade.
@@ -92,6 +102,6 @@ This man page written for the SlackBuilds.org project
 by B. Watson, and is licensed under the WTFPL.
 .SH SEE ALSO
 .sp
-unshield(1), cabextract(1)
+\fBunshieldv3\fP(1), \fBunshield\fP(1), \fBcabextract\fP(1)
 .\" Generated by docutils manpage writer.
 .