## NAME

         dogman.csh - UNIX C shell script to create formatted  manual
         pages and the windex database file

## SYNOPSIS

         dogman.csh <options> [directory]

## OPTIONS

         By default, dogman.csh will create the windex file, and  add
         the  missing  entries  for the current directory. Additional
         options can be added as:
           -u only update the missing windex file entries
           -c execute catman only
           -h print this help message
           directory : the directory to work on

## DESCRIPTION

         To enable the "man -k" or "appropos"  to  work,  the  windex
         database  file  must be present in the proper man directory,
         which is usually accomplished via  catman(1M).  One  problem
         is  that  if  a man page such as "foo" is referring man page
         "bar" through the standard ".so  manx/bar.x"  approach,  and
         "foo"  is not listed in the function name section on the man
         page of "bar", catman(1M) won't create the entry of "foo" in
         the windex file.

         dogman.csh  solves  the  problem  by  first   carrying   out
         catman(1M),  then  adding  up  all   the  missed entries. As
         recommended by catman(1M), the  original  catxx  directories
         are  removed first for consistency concern. The user can use
         catman(1M) and "dogman.csh -u" separately  to  expedite  the
         process.

         It is recommended to use addman.csh after changing or adding
         any  man  pages  to both verify and enhance the usability of
         the man pages.

## EXAMPLES

         dogman.csh -u
          The above command updates the missing windex file  entries,
         without running catman(1M).

## FILES

         $CVIPHOME/docs/Scripts/dogman.csh

## DIAGNOSTICS

         At the end of the command, dogman.csh will display the total
         number of man page entries added to the windex file. If any-
         thing goes wrong, it will also display  the  number  of  man
         pages can't be added to the windex file.

## BUGS

         NONE

## SEE ALSO

         catman(1M), htmlman(1)

## AUTHOR

         Copyright (C) 1996 SIUE - by Scott E. Umbaugh  and  Yansheng
         Wei.