DH_UNDOCUMENTED(D)          Debhelper          DH_UNDOCUMENTED(D)



NAME
       dh_undocumented - make symlinks to undocumented.7.gz man
       page

SYNOPSIS
       dh_undocumented [debhelper options] [-A] [manpage ...]

DESCRIPTION
       dh_undocumented is a debhelper program that is responsible
       for making symlinks to undocumented(d) for man pages that
       are not present in your package.

       The program takes a list of man pages that should be sym-
       linked to undocumented(d). It examines the extension to
       see what section the man page belongs in. After figuring
       this out, it generates the necessary symlinks.

       The lists of man pages that need symlinks can be specified
       in two ways. Any man page names specified as parameters
       will be set up in the first package dh_undocumented is
       told to act on. By default, this is the first binary pack-
       age in debian/control, but if you use -p, -i, or -a flags,
       it will be the first package specified by those flags.

       Also, a file named debian/package.undocumented can list
       other man page names to set up.

OPTIONS
       -A, --all
           Install undocumented man page symlinks for any man
           pages specified by command line parameters in ALL
           packages acted on. I doubt anyone will find this use-
           ful, it's here for consitency with other debhelper
           programs.

       manpage ...
           Install undocumented man page symlinks for each of
           these man pages into the first package acted on. (Or
           in all packages acted on if -A is specified.)

       Note that Debian policy prohibits links to undocumented(d)
       unless the package has an open bug report stating that it
       has no man page. You should really just write a man page
       instead; this program is an easy way out.

SEE ALSO
       debhelper(r)

       This program is a part of debhelper.

AUTHOR
       Joey Hess <joeyh@debian.org>



4.0.2                       2001-11-17         DH_UNDOCUMENTED(D)