NAME

shtoolize - Build individual GNU shtool scripts

VERSION

GNU shtool .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