debiandoc-sgml 1.2.28-1 / usr / bin / debiandoc2info

#!/bin/bash
## ----------------------------------------------------------------------

## ----------------------------------------------------------------------
## exit on erroneous subcommand
set -e

## ----------------------------------------------------------------------
## get script name
script=$(basename ${0})

## ----------------------------------------------------------------------
## print version and usage message
function usage_message
{
    cat >&2 <<'END'
debiandoc2info version 1.1

Copyright (C) 2005-2008 Osamu Aoki
Copyright (C) 1998-2004 Ardo van Rangelrooij
Copyright (C) 1996 Ian Jackson

This is free software; see the GNU General Public Licence
version 2 or later for copying conditions.  There is NO warranty.

usage: debiandoc2info [options] <filename>.sgml
options: -h               print this help message
         -b <basename>    basename to be used
         -c               use content-negotiation (w/  encoding suffix)
         -C               use content-negotiation (w/o encoding suffix)
	 -d <declaration> SGML declaration to be used
         -e <extension>   extension to be used
         -k               keep intermediate files
         -l <locale>      locale to be used
         -s <script>      apply script on intermediate texinfo source
         -n <options>     nsgmls options to be passed on
         -v               be verbose
         -X <custom_dir>  switch locale dependent format data tree
END
    exit 0;
}

## ----------------------------------------------------------------------
## print error message
function usage_error
{
    echo >&2 "${script}: ${@}";
    exit 2;
}

## ----------------------------------------------------------------------
## check for presence of makeinfo
if ! which makeinfo >/dev/null 2>&1
then
    echo >&2 "${script}: Texinfo documentation system not found"
    echo >&2 "${script}: please install the package 'texinfo'"
    exit 2
fi

## ----------------------------------------------------------------------
## set default values
basename=''
content=''
contentx=''
postprocessing=''
declaration='-d /usr/share/sgml/debiandoc/dtd/sgml/1.0/debiandoc.dcl'
extension=''
keep=false
keepopt=''
locale=''
nsgmls=''
stdout=false
verbose=false
custom_dir=''

## ----------------------------------------------------------------------
## get command line options
options=':'
options="${options}h"
options="${options}b:"
options="${options}c"
options="${options}C"
options="${options}s:"
options="${options}d:"
options="${options}e:"
options="${options}k"
options="${options}l:"
options="${options}n:"
options="${options}v"
options="${options}X:"
while getopts ${options} opt
do
    case ${opt}
    in
	h  ) usage_message
	     ;;
	b  ) basename="-${opt} ${OPTARG}"
	     ;;
	c  ) content="-${opt}"
	     ;;
	C  ) contentx="-${opt}"
	     ;;
	s  ) postprocessing="${OPTARG}"
	     ;;
	d  ) declaration="-${opt} ${OPTARG}"
	     ;;
	e  ) extension="-${opt} ${OPTARG}"
	     ;;
	k  ) keep=true
	     keepopt="-${opt}"
	     ;;
	l  ) locale="-${opt} ${OPTARG}"
	     ;;
	n  ) nsgmls="-${opt} ${OPTARG} ${nsgmls}"
	     ;;
	v  ) verbose=true
	     ;;
	X  ) custom_dir="${OPTARG}"
	     ;;
	\? ) usage_error "unknown option \`${OPTARG}'"
	     ;;
    esac
done
shift $((${OPTIND} - 1))

## ----------------------------------------------------------------------
## check remaining command line options
if [ ${#} -ne 1 ]
then
    usage_error "need exactly one input filename: $*"
fi

## ----------------------------------------------------------------------
## get basename
if [ -n "${basename}" ]
then
    bsn="$(echo ${basename} | cut -d' ' -f2- | cut -d'/' -f-1)"
else
    bsn="$(basename ${1} .sgml)"
fi
case "${bsn}"
in
    -* ) bsn="./${bsn}"
	 ;;
esac

## ----------------------------------------------------------------------
## get content-negotiation
cnt=''
if [ -n "${content}" ]
then
    if [ -n "${locale}" ]
    then
	cnt="$(echo ${locale} | cut -d' ' -f2-)"
    else
	cnt='en'
    fi
    cnt=".${cnt}"
fi
if [ -n "${contentx}" ]
then
    if [ -n "${locale}" ]
    then
	cnt="$(echo ${locale} | cut -d' ' -f2- |  sed -e 's/[@\.].*$//')"
    else
	cnt='en'
    fi
    cnt=".${cnt}"
fi

## ----------------------------------------------------------------------
## get extension
if [ -n "${extension}" ]
then
    ext="$(echo ${extension} | cut -d' ' -f2-)"
else
    ext='info'
fi
ext=".${ext}"

## ----------------------------------------------------------------------
## what needs to be passed on to the backend
passing_on=''
passing_on="${passing_on} ${basename}"
passing_on="${passing_on} ${declaration}"
passing_on="${passing_on} ${keepopt}"
passing_on="${passing_on} ${locale}"
passing_on="${passing_on} ${nsgmls}"
if [ -n "${postprocessing}" ]; then
  passing_on="${passing_on} -s ${postprocessing}"
fi
if [ -n "${custom_dir}" ]; then
  passing_on="${passing_on} -X ${custom_dir}"
fi
if [ -n "${cnt}" ]; then
  # Remove Largest Suffix Pattern if -C or -c is used.
  bsn="${bsn%%.*}"
fi
## ----------------------------------------------------------------------
## do the actual work
if [ -e ${bsn}.texinfo ]
then
    echo >&2 "${script}: WARNING: overwriting ${bsn}.texinfo"
fi
if ! debiandoc2texinfo ${passing_on} ${1}
then
    echo >&2 "${script}: ERROR: ${bsn}.texinfo could not be generated properly"
    exit 1
fi
if ! ( ${verbose} || exec >/dev/null 2>&1;
       makeinfo --no-validate -v -o ${bsn}${cnt}${ext} ${bsn}.texinfo )
then
    echo >&2 "${script}: ERROR: ${bsn}${cnt}${ext} could not be generated properly"
    if ! ${verbose}
    then
	echo >&2 "${script}: rerun with the -v option to find out why"
    fi
    exit 1
fi

## ----------------------------------------------------------------------
## remove temporary files
if ! ${keep}
then
    rm -f ${bsn}.texinfo-in ${bsn}.texinfo
fi

## ----------------------------------------------------------------------
exit 0

## ----------------------------------------------------------------------