shtoolize man page

shtoolize — Build individual GNU shtool scripts


GNU shtool 2.0.8 (18-Jul-2008)


shtoolize [-h] [-v] [-q] [-o script] module [ module ... ]


The shtoolize program builds individual GNU shtool scripts (written to the default output file "shtool" or to the specified script) out of one or more shtool ingredient modules. Available modules are:

echo       Print string with optional construct expansion
mdate      Pretty-print modification time of a file or dir
table      Pretty print a field-separated list as a table
prop       Display progress with a running propeller
move       Move files with simultan substitution
install    Install a program, script or datafile
mkdir      Make one or more directories
mkln       Make link with calculation of relative paths
mkshadow   Make a shadow tree
fixperm    Fix file permissions inside a source tree
rotate     Rotate a logfile
tarball    Roll distribution tarballs
subst      Apply sed(1) substitution operations
platform   Platform identification utility
arx        Extended archive command
slo        Separate linker options by library class
scpp       Sharing C Pre-Processor
version    Generate and maintain a version information file
path       Deal with program paths

Additionally there is a pseudo-module “"all"” which can be used as a short-hand for “"echo mdate table prop move install mkdir mkln mkshadow fixperm platform arx slo scpp version path"”, i.e. to build a shtool script with all modules in the standard order. An installed shtool is usually built this way via “"shtoolize -o shtool all"”.

Use the shtoolize program to build individual shtool scripts in case you want a smaller sized script and you don't need all of the available shtool functionality. For instance for the classical Autoconf based free software package a "shtool" script build via “"shtoolize -o shtool install mkdir"” might be sufficient.


The following command line options exist:

Displays a short help page describing the usage of shtoolize.
Displays the version number of shtoolize/shtool.
Displays no processing information.
-o script
Writes the output to file script instead to file “"shtool"”.


The typical free software package which is based on GNU libtool and GNU shtool one uses a "Makefile" entry like the following:

#   Makefile entry for upgrading GNU tools
    libtoolize -f -c
    shtoolize -q all

This upgrades the three files "", "ltconfig" and "shtool" in the current source tree to the latest versions.

See Also



Ralf S. Engelschall

Referenced By


shtool 2.0.8 18-Jul-2008 GNU Portable Shell Tool