Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

shtoolize(1) [linux man page]

SHTOOLIZE.TMP(1)					      GNU Portable Shell Tool						  SHTOOLIZE.TMP(1)

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

18-Jul-2008							   shtool 2.0.8 						  SHTOOLIZE.TMP(1)

Check Out this Related Man Page

SHTOOL-SLO.TMP(1)					      GNU Portable Shell Tool						 SHTOOL-SLO.TMP(1)

NAME

       shtool-slo - GNU shtool separate linker options by library class

SYNOPSIS

       shtool slo [-p|--prefix str] -- -Ldir -llib [-Ldir -llib ...]

DESCRIPTION

       This command separates the linker options ``-L'' and ``-l'' by library class. It's argument line can actually be an arbitrary command line
       where those options are contained. slo parses these two options only and ignores the remaining contents. The result is a trivial shell
       script on "stdout" which defines six variables containing the ``-L'' and ``-l'' options sorted by class:

       ``"SLO_DIRS_OBJ"'' and ``"SLO_LIBS_OBJ"'' contains the ``-L'' and ``-l'' options of static libraries,  ``"SLO_DIRS_PIC"'' and
       ``"SLO_LIBS_PIC"'' contains the ``-L'' and ``-l'' options of static libraries containing PIC ("Position Independent Code") and
       ``"SLO_DIRS_DSO"'' and ``"SLO_LIBS_DSO"'' contains the ``-L'' and ``-l'' options of shared libraries. The -p option can be used to change
       the default variable prefix from ""SLO_"" to str.

       The intent of this separation is to provide a way between static and shared libraries which is important if one wants to link custom DSOs
       against libraries, because not all platforms all one to link these DSOs against shared libraries. So one first has to separate out the
       shared libraries and link the DSO only against the static libraries.  One can use this command also to just sort the options.

OPTIONS

       The following command line options are available.

       -p, --prefix str
	       FIXME

       -Ldir
	   Directory where libraries are searched in.

       -llib
	   Library to search for.

EXAMPLE

	#   configure.in
	LINK_STD="$LDFLAGS $LIBS"
	eval `shtool slo $LINK_STD`
	LINK_DSO="$SLO_DIRS_OBJ $SLO_LIBS_OBJ $SLO_DIRS_PIC $SLO_LIBS_PIC"
	  :

HISTORY

       The GNU shtool slo command was originally written by Ralf S.  Engelschall <rse@engelschall.com> in 1998 for Apache.  It was later taken
       over into GNU shtool.

SEE ALSO

       shtool(1), ld(1).

18-Jul-2008							   shtool 2.0.8 						 SHTOOL-SLO.TMP(1)
Man Page