#! /usr/bin/perl -w

# Set the environment variables AUTHOR (e.g., Bill Wohler) and ORGANIZATION
# (e.g., Newt Software) before running this script.

my $VERSION = '$Revision: 5305 $';

my ($year) = (localtime)[5]+1900;
my $organization = $ENV{ORGANIZATION};
my $author = $ENV{AUTHOR};

unless (defined($organization)) {
    die("The ORGANIZATION environment variable must be set.\n");
}
unless (defined($author)) {
    die("The AUTHOR environment variable must be set.\n");
}

print <<EOTEMPLATE;
#! /bin/sh
#
# \$Id\$
#
# NAME
#   name - one line description
#
# SYNOPSIS
#   name [optional args in square brackets]
#
# DESCRIPTION
#
# OPTIONS
#   --debug
#     Turn on debugging messages.
#
#   --help
#     Display the usage of this command.
#
#   --version
#     Display program version.
#
# RETURN VALUE
#
# EXAMPLES
#
# ENVIRONMENT
#
# FILES
#
# SEE ALSO
#
# VERSION
#   \$Revision\$
#
# AUTHOR
#   Copyright (C) $year $author. All rights reserved.
#   
#   This program is free software; you can redistribute it and/or
#   modify it under the terms of the GNU General Public License
#   as published by the Free Software Foundation; either version 2
#   of the License, or (at your option) any later version.
#   
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
#   
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, you can find it at
#   http://www.gnu.org/copyleft/gpl.html or write to the Free Software
#   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

# Initializations.

# Constants.
cmd=`basename \$0`                       # name by which command called

# Program version: start with CVS version, strip dollar signs, CVS keyword
# and whitespace.
ver=`echo \'$VERSION\' | sed -e 's/\\\\\$//g' -e 's/Revision://' -e 's/ //g'`

# Variables (may be overridden by arguments).
debug=0                                 # verbose mode

exitstatus=0                            # upon error, set to non-zero and exit
interrupt=0                             # upon interrupt, set to 1

# Functions.

# Display usage information and exit.
usage() {
    cat <<EOF
Usage: \$cmd [options]
--debug                 print actions that program takes
--help                  display this message
--version               display program version
EOF
    bye 1;
}

# Exit gracefully.
# Usage: bye [(status [message]]
bye() {
    if [ \$# -gt 0 ]; then
        exitstatus=\$1
        shift
    fi
    if [ \$# -gt 0 ]; then
        echo "\$*"
    elif [ \$interrupt -eq 1 ]; then
        echo ""
    fi
    exit \$exitstatus
}

# Handle an interrupt.
intr() {
    echo ""
    interrupt=1
    bye 1
}

# Display version information and exit.
show_version() {
    cat <<EOF
\$cmd version \$ver
Copyright (C) $year $author

\$cmd comes with ABSOLUTELY NO WARRANTY.

This is free software, and you are welcome
to redistribute it under certain conditions.

See http://www.gnu.org/copyleft/gpl.html for details.
EOF
    exit 0;
}

# Parse command line.
while [ \$# != 0 ]; do
    case "\$1" in
    --d*)       debug=1;;
    --h*)       usage;;
    --v*)       show_version;;
    -*)         usage;;
    *)          break;;
    esac
    shift
done

trap intr 2

# ADD CODE HERE

bye

EOTEMPLATE

