Man page - shtoolize(1)

Packages contains this manual

Package:  shtool
apt-get install shtool

Manuals in package:
• shtool-path(1)
• shtool-mkln(1)
• shtool-platform(1)
• shtool-tarball(1)
• shtool-arx(1)
• shtool-mkshadow(1)
• shtool(1)
• shtool-rotate(1)
• shtool-slo(1)
• shtool-mdate(1)
• shtool-echo(1)
• shtool-subst(1)
• shtool-scpp(1)
• shtool-install(1)
• shtool-mkdir(1)
• shtoolize(1)
• shtool-fixperm(1)
• shtool-prop(1)
• shtool-move(1)
• shtool-table(1)
• shtool-version(1)
Documentations in package:
• shtool

Manual

SHTOOLIZE.TMP

NAME
VERSION
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
AUTHOR

---

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 module s. Available module s 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

---