NAME
shtoolize - Build individual GNU shtool scripts
VERSION
GNU shtool 2.0.8 (18-Jul-2008)
SYNOPSIS
shtoolize [-h] [-v] [-q] [-o script] module [ module ... ]
DESCRIPTION
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.
OPTIONS
The following command line options exist:
-h Displays a short help page describing the usage of shtoolize.
-v Displays the version number of shtoolize/shtool.
-q Displays no processing information.
-o script
Writes the output to file script instead to file ‘‘"shtool"’’.
EXAMPLE
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
upgrade-tools:
libtoolize -f -c
shtoolize -q all
This upgrades the three files "ltmain.sh", "ltconfig" and "shtool" in
the current source tree to the latest versions.
SEE ALSO
shtool(1).
AUTHOR
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com