NAME
shtoolize - Build individual GNU shtool scripts
VERSION
\s-1GNU\s0 shtool \s-12.0.7 (19-May-2007)\s0
SYNOPSIS
shtoolize
[-h]
[-v]
[-q]
[-o script]
module
[ module ... ]
DESCRIPTION
The shtoolize program builds individual \s-1GNU\s0 shtool scripts (written to
the default output file CWshtool 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 ``CWall'' which can be used as a
short-hand for ``CWecho 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 ``CWshtoolize -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 CWshtool script build via ``CWshtoolize -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
Writes the output to file script instead to file ``CWshtool''.
EXAMPLE
The typical free software package which is based on \s-1GNU\s0 libtool and \s-1GNU\s0
shtool one uses a CWMakefile entry like the following:
# Makefile entry for upgrading GNU tools
upgrade-tools:
libtoolize -f -c
shtoolize -q all
This upgrades the three files CWltmain.sh, CWltconfig and CWshtool in the
current source tree to the latest versions.
SEE ALSO
shtool(1).
AUTHOR
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
