system/isextract: Update man page.

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

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

4 files changed, 56 insertions, 31 deletions

diff --git a/system/isextract/README b/system/isextract/README
index 81d4c5fbe35d..fd926c9a20e2 100644
--- a/system/isextract/README
+++ b/system/isextract/README
@@ -7,4 +7,7 @@ The files isextract supports are identified by the file command as
 "InstallShield Z archive Data", and begin with a hex signature of 13 5d
 65 8c 3a 01 02.
 
-See also: unshield, for other types of InstallShield files.
+See also:
+- unshield, for other types of InstallShield files.
+- unshieldv3, for another v3 extractor.
+- cabextract, for cabinet (.cab) files.
diff --git a/system/isextract/isextract.1 b/system/isextract/isextract.1
index 318ac7fabd19..3886f5742a9f 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.
 .
diff --git a/system/isextract/isextract.SlackBuild b/system/isextract/isextract.SlackBuild
index 1c8bb79d3fd0..67c3124eaabf 100644
--- a/system/isextract/isextract.SlackBuild
+++ b/system/isextract/isextract.SlackBuild
@@ -6,11 +6,13 @@
 
 # Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
 
+# 20220112 bkw: BUILD=2, update man page.
+
 cd $(dirname $0) ; CWD=$(pwd)
 
 PRGNAM=isextract
 VERSION=${VERSION:-20141107_5adb0af}
-BUILD=${BUILD:-1}
+BUILD=${BUILD:-2}
 TAG=${TAG:-_SBo}
 PKGTYPE=${PKGTYPE:-tgz}
 
diff --git a/system/isextract/isextract.rst b/system/isextract/isextract.rst
index aaa462268184..83aa429a2f8f 100644
--- a/system/isextract/isextract.rst
+++ b/system/isextract/isextract.rst
@@ -5,10 +5,6 @@
 .. |version| replace:: 20141107_5adb0af
 .. |date| date::
 
-.. converting from pod:
-.. s/B<\([^>]*\)>/**\1**/g
-.. s/I<\([^>]*\)>/*\1*/g
-
 =========
 isextract
 =========
@@ -25,16 +21,18 @@ Extract InstallShield v3 archives
 SYNOPSIS
 ========
 
-isextract [*l|x*] file.z
+isextract [*l*] *file.z*
+
+isextract [*x*] *file.z* [*output-dir*]
 
 DESCRIPTION
 ===========
 
-isextract is a command line tool to extract the .z InstallShield v3
+**isextract** is a command line tool to extract the .Z InstallShield v3
 packages many old windows games were distributed as.
 
-The files isextract supports normally have a **.z** extension, and can be
-idenfified by the file command:
+The files **isextract** supports normally have a **.Z** extension, and can be
+idenfified by the **file**\(1) command:
 
 ::
 
@@ -51,14 +49,26 @@ idenfified by the file command:
 OPTIONS
 =======
 
-**l**       List contents of archive.
+**l**
+  List contents of archive.
+
+**x**
+  Extract archive. If an *output-dir* is given, extracted files will be written
+  there (the *output-dir* must already exist). Without *output-dir*, the current
+  directory is used.
+
+If **file** says "compress'd data" or similar, your file isn't an
+InstallShield archive; it's compressed with the old UNIX compress
+command, and can be extracted with **uncompress**\(1) or **gzip**\(1).
 
-**x**       Extract archive to current directory.
+When extracting, **isextract** *DOES NOT* preserve the directory structure
+inside the archive. All files are written to the same directory. If you
+need the directories, use **unshieldv3** instead.
 
 COPYRIGHT
 =========
 
-See the file /usr/doc/PRGNAM-|version|/LICENSE for license information.
+See the file /usr/doc/isextract-|version|/LICENSE for license information.
 
 AUTHORS
 =======
@@ -71,4 +81,4 @@ by B. Watson, and is licensed under the WTFPL.
 SEE ALSO
 ========
 
-unshield(1), cabextract(1)
+**unshieldv3**\(1), **unshield**\(1), **cabextract**\(1)