#!/bin/bash
# echo "$0 $*" ; set -x ; set -v
# cp ~/bin/manedit ~/man/man1/manedit.1 ~/man/man5/mantemplate.5   ~/public_html/extras/manedit.


if [  ${#*} = 0 -o "x$1" = "x-h" ] ; then 
cat <<EOusage;

$0 [-f] programname

This program is for creating and finding simple documentation
It looks for a man page, and an info page, and runs them if possible,
but if they are not, it tries to create a new man page using your editor

OPTIONS

 -f     force an edit on the private man page


EOusage
exit 1
fi


if [ ! -d ${PRIVATEMANPATH:=${HOME}/man} -a  \
      -f ${MANTEMPLATEFILE:=${PRIVATEMANPATH}/man5/mantemplate.5} ]
then 
 echo "$PRIVATEMANPATH or $MANTEMPLATEFILE does not exist"
 exit 1
fi

fEdit=FALSE
fExist=FALSE
if [ $1 = '-f' ]; then
 fEdit=TRUE
 shift
fi
MANNAME="${1}.1"
FULLMANNAME=${PRIVATEMANPATH}/man1/$MANNAME


# look for or create a man page
 if man -W $1 >/dev/null 2>&1 ; then
 # $1 has a man page
  echo "$1 has a  man page in MANPATH"
  fExist=TRUE
  
# else
#  echo "$1 has no man page in MANPATH"
 fi
 info $1 -output=/tmp/manedit$$ >/dev/null 2>&1 
 if [ -f /tmp/manedit$$ ] ; then
  echo "$1 has an info page in INFOPATH"
  fExist=TRUE
# else
#  echo "$1 has no info page in INFOPATH"
 fi

 
 if [ ! -d ${PRIVATEMANPATH} ];then
   echo $PRIVATEMANPATH does not exist 
   exit 2
 fi
 if [ ! -d ${PRIVATEMANPATH}/man1 ];then
   echo $PRIVATEMANPATH/man1 does not exist 
   exit 2
 fi
 if [ ! -w ${PRIVATEMANPATH} ];then
   echo "$PRIVATEMANPATH is not writable: chmod u+w $PRIVATEMANPATH" 
   exit 2
 fi
 if [ -f ${FULLMANNAME} ] ; then
  echo "$1 has an info page in $FULLMANNAME}"
  fExist=TRUE
 fi



if [ $fExist = TRUE -a $fEdit = FALSE ] ; then
  cat <<EOF
There seems to be existing man or info pages.  If you would really like to
create $FULLMANNAME, then use the -f option:

       $0 -f $1

but you may need to use 

       man -a $1

EOF
  exit 1
fi

if [ ! -e ${FULLMANNAME} ] ; then
 cat ${MANTEMPLATEFILE} >${FULLMANNAME}
fi
# make a manpage:
${EDITOR:=vi} ${FULLMANNAME}