diff --git a/system/isextract/README b/system/isextract/README index 81d4c5fbe3..fd926c9a20 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 318ac7fabd..3886f5742a 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 1c8bb79d3f..67c3124eaa 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 aaa4622681..83aa429a2f 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 to current directory. +**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). + +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)