shtoolize(1)

1SHTOOLIZE.TMP(1)            GNU Portable Shell Tool           SHTOOLIZE.TMP(1)
2
3
4

NAME

6       shtoolize - Build individual GNU shtool scripts
7

VERSION

9       GNU shtool 2.0.8 (18-Jul-2008)
10

SYNOPSIS

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

DESCRIPTION

15       The shtoolize program builds individual GNU shtool scripts (written to
16       the default output file "shtool" or to the specified script) out of one
17       or more shtool ingredient modules.  Available modules are:
18
19        echo       Print string with optional construct expansion
20        mdate      Pretty-print modification time of a file or dir
21        table      Pretty print a field-separated list as a table
22        prop       Display progress with a running propeller
23        move       Move files with simultan substitution
24        install    Install a program, script or datafile
25        mkdir      Make one or more directories
26        mkln       Make link with calculation of relative paths
27        mkshadow   Make a shadow tree
28        fixperm    Fix file permissions inside a source tree
29        rotate     Rotate a logfile
30        tarball    Roll distribution tarballs
31        subst      Apply sed(1) substitution operations
32        platform   Platform identification utility
33        arx        Extended archive command
34        slo        Separate linker options by library class
35        scpp       Sharing C Pre-Processor
36        version    Generate and maintain a version information file
37        path       Deal with program paths
38
39       Additionally there is a pseudo-module ``"all"'' which can be used as a
40       short-hand for ``"echo mdate table prop move install mkdir mkln
41       mkshadow fixperm platform arx slo scpp version path"'', i.e. to build a
42       shtool script with all modules in the standard order. An installed
43       shtool is usually built this way via ``"shtoolize -o shtool all"''.
44
45       Use the shtoolize program to build individual shtool scripts in case
46       you want a smaller sized script and you don't need all of the available
47       shtool functionality.  For instance for the classical Autoconf based
48       free software package a "shtool" script build via ``"shtoolize -o
49       shtool install mkdir"'' might be sufficient.
50

OPTIONS

52       The following command line options exist:
53
54       -h  Displays a short help page describing the usage of shtoolize.
55
56       -v  Displays the version number of shtoolize/shtool.
57
58       -q  Displays no processing information.
59
60       -o script
61           Writes the output to file script instead to file ``"shtool"''.
62

EXAMPLE

64       The typical free software package which is based on GNU libtool and GNU
65       shtool one uses a "Makefile" entry like the following:
66
67        #   Makefile entry for upgrading GNU tools
68        upgrade-tools:
69            libtoolize -f -c
70            shtoolize -q all
71
72       This upgrades the three files "ltmain.sh", "ltconfig" and "shtool" in
73       the current source tree to the latest versions.
74

AUTHOR

79        Ralf S. Engelschall
80        rse@engelschall.com
81        www.engelschall.com
82
83
84
8518-Jul-2008                      shtool 2.0.8                 SHTOOLIZE.TMP(1)