SHTOOL-ECHO.TMP(1) GNU Portable Shell Tool SHTOOL-ECHO.TMP(1)NAME
shtool-echo - GNU shtool echo(1) extensional command
SYNOPSIS
shtool echo [-n|--newline] [-e|--expand] string
DESCRIPTION
shtool echo is an echo(1) style command which prints string to stdout and optionally provides special expansion constructs (terminal bold
mode, environment details, date, etc) and newline control. The trick of this command is that it provides a portable -n option and hides the
gory details needed to find out the environment details under option -e.
OPTIONS
The following command line options are available.
-n, --newline
By default, output is written to stdout followed by a "newline" (ASCII character 0x0a). If option -n is used, this newline character is
omitted.
-e, --expand
If option -e is used, string can contain special "%x" constructs which are expanded before the output is written. Currently the
following constructs are recognized:
%B switch terminal mode to bold display mode.
%b switch terminal mode back to normal display mode.
%u the current user name.
%U the current user id (numerical).
%g the current group name.
%G the current group id (numerical).
%h the current hostname (without any domain extension).
%d the current domain name.
%D the current day of the month.
%M the current month (numerical).
%m the current month name.
%Y the current year.
EXAMPLE
# shell script
shtool echo -n -e "Enter your name [%B%u%b]: "; read name
shtool echo -e "Your Email address might be %u@%h%d"
shtool echo -e "The current date is %D-%m-%Y"
HISTORY
The GNU shtool echo command was originally written by Ralf S. Engelschall <rse@engelschall.com> in 1998 for Website META Language (WML)
under the name buildinfo. It was later taken over into GNU shtool.
SEE ALSO shtool(1), echo(1).
18-Jul-2008 shtool 2.0.8 SHTOOL-ECHO.TMP(1)
Check Out this Related Man Page
SHTOOL-VERSION.TMP(1) GNU Portable Shell Tool SHTOOL-VERSION.TMP(1)NAME
shtool-version - GNU shtool maintain version information file
SYNOPSIS
shtool version [-l|--language lang] [-n|--name name] [-p|--prefix prefix] [-s|--set version] [-e|--edit] [-i|--increase knob] [-d|--display
type] file
DESCRIPTION
This command displays and maintains version information in file.
The version is always described with a triple <version,revision,level> and is represented by a string which always matches the regular
expression ""[0-9]+.[0-9]+[sabp.][0-9]+"".
The hexadecimal format for a version "v.rtl" is "VVRRTLL" where "VV" and "RR" directly correspond to "v" and "r", "T" encodes the level
type as 9, 2, 1, 0 (representing "s", "p"/".", "b", "a" in this order) and "LL" is either directly corresponding to "l" or set to 99 if
level type is "s".
OPTIONS
The following command line options are available.
-v, --verbose
Print verbose information during processing.
-l, --language lang
Choose format of version file file. lang=""txt"", ANSI C (lang="c"), M4 (lang="m4"), Perl (lang="perl") or Python (lang="python").
Default is "txt".
-n, --name name
Name the program the version is maintained for. Default is "unknown".
-p, --prefix prefix =item -s, --set version
Set the version to version.
-e, --edit
Interactively enter a new version.
-i, --increase knob
When option ``-i'' is used, the current version in file is updated by increasing one element of the version where knob can be one of
the following: ``"v"'' for increasing the version by 1 (and resetting revision and level to 0), ``"r"'' for increasing the revision by
1 (and resetting level to 0) or ``"l"'' for increasing the level by 1.
-d, --display type
Control the display type: ""short"" for a short version display, ""long"" for a longer version display, ""hex"" for a hexadecimal
display of the version and ""libtool"" for a format suitable for use with GNU libtool.
EXAMPLE
# shell script
shtool version -l c -n FooBar -p foobar -s 1.2b3 version.c
# configure.in
V=`shtool version -l c -d long version.c`
echo "Configuring FooBar, Version $V"
HISTORY
The GNU shtool version command was originally written by Ralf S. Engelschall <rse@engelschall.com> in 1994 for OSSP eperl. It was later
rewritten from scratch for inclusion into GNU shtool.
SEE ALSO shtool(1).
18-Jul-2008 shtool 2.0.8 SHTOOL-VERSION.TMP(1)