shtoolize

Langue: en

Version: shtool 2.0.8 (fedora - 04/07/09)

Section: 1 (Commandes utilisateur)

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