GNU shtool 2.0.7 (19-May-2007)
shtool [ global_options ] command [ command_options ] [ command_args ]
GNU shtool is a compilation of small but very stable and portable shell
scripts into a single shell tool. All ingredients were in successful
use over many years in various free software projects. The compiled
shtool script is intended to be used inside the source tree of those
free software packages. There it can take over various (usually
non-portable) tasks related to the building and installation of such
The following global options are available for shtool. Any commands are
ignored if one of them is present on the shtool command line.
Displays a short help page describing the usage of shtool and it's
ingredient commands in a compact way.
Displays the version number of shtool.
Displays shell trace messages for debugging purposes.
Recreate the shtool script with its own individual shtoolize(1)
The following commands are provided by shtool. They are all called via
""shtool" command". Any command options command_opts and arguments com-
mand_args are specific to the particular command and are described in
the corresponding manual page shtool_command(1). The commands are
listed here sorted by topic, i.e., related commands are listed
echo echo(1) style print command providing special expansion
constructs (terminal bold mode, environment details,
date) and newline control.
mdate Pretty-printing of the last modification time of a file
table Pretty-printing a field-separated list as a two-dimen-
prop Displaying of a processing indication though a running
terminal character propeller.
mkln ln(1) style command providing automatic calculation and
usage of relative links if possible.
mkshadow Creation of a shadow filesystem tree by the help of
fixperm Fixing of file permissions in a source tree by cleaning
up the permission bits.
rotate Rotate a logfile.
tarball Roll standardized distribution tarballs.
subst Apply sed(1) substitution operations.
platform Determines platform identification information.
arx Extended archive command which can even put existing
archives into an archive.
slo Separate linker options by library class.
scpp An additional C source file pre-processor for sharing
cpp(1) code, internal variables and internal functions.
version Maintain a version information file in either Text,
C/C++, Perl or Python. format.
path Deal with shell path variables.
shtoolize(1), shtool-arx(1), shtool-echo(1), shtool-fixperm(1),
shtool-install(1), shtool-mdate(1), shtool-mkdir(1), shtool-mkln(1),
shtool-mkshadow(1), shtool-move(1), shtool-path(1), shtool-platform(1),
shtool-prop(1), shtool-rotate(1), shtool-scpp(1), shtool-slo(1),
shtool-subst(1), shtool-table(1), shtool-tarball(1), shtool-version(1).
Some scripts contained in GNU shtool were already written in 1994 by
Ralf S. Engelschall for use inside some private source trees. Then they
evolved into more elaborated versions over the years and were used in
various free software projects like ePerl, WML, iSelect, gFONT, etc.
They were complemented with other scripts from the author which he
wrote in March 1998 for the ``Apache Autoconf-style Interface'' (APACI)
for Apache 1.3. In April 1999 the shtool package was created out of the
accumulated master versions of the scripts and in June 1999 it entered
the status of an official GNU program and this way finally joined the
group of GNU autoconf, GNU automake and GNU libtool.
Ralf S. Engelschall
Man Pages Copyright Respective Owners. Site Copyright (C) 1993 - 2020
All Rights Reserved.