dh_installman.1

   1 .TH DH_INSTALLMAN 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_installman \- install man pages into package build directories
   4 .SH SYNOPSIS
   5 .B dh_installman
   6 .I "[debhelper options] [manpage ...]"
   7 .SH "DESCRIPTION"
   8 dh_installman is a debhelper program that is responsible for installing
   9 man pages into the correct locations in package build directories. You tell
  10 it what man pages go in your package(s), and it figures out where to install
  11 them based on the section field in their .TH line and their filename
  12 extention.
  13 .P
  14 Any man page filenames specified as parameters will be installed into the
  15 first package dh_installman is told to act on. By default, this is the
  16 first binary package in debian/control, but if you use -p, -i, or -a flags,
  17 it will be the first package specified by those flags.
  18 .P
  19 Files named debian/package.manpages can list other man pages to be installed.
  20 .P
  21 After the man page installation step, dh_installman will check to see if
  22 any of the man pages in the temporary directories of any of the packages it
  23 is acting on contain ".so" links. If so, it changes them to symlinks.
  24 .SH OPTIONS
  25 .TP
  26 .B debhelper options
  27 See
  28 .BR debhelper (1)
  29 for a list of options common to all debhelper commands.
  30 .TP
  31 .B \-A, \--all
  32 Install all files specified by command line parameters in ALL packages
  33 acted on.
  34 .TP
  35 .B manpage ...
  36 Install these man pages into the first package acted on. (Or in all packages
  37 if -A is specified).
  38 .SH NOTES
  39 An older version of this program,
  40 .BR dh_installmanpages (1)
  41 , is still used by some packages, and so is still included in debhelper.
  42 It is, however, deprecated, due to its counterintuiitive and inconsistent
  43 interface. Use this program instead.
  44 .SH ENVIRONMENT
  45 See
  46 .BR debhelper (1)
  47 for a list of environment variables that affect all debhelper commands.
  48 .SH "SEE ALSO"
  49 .BR debhelper (1)
  50 .SH BUGS
  51 It's impossible to specify filenames with spaces or other whitespace in
  52 them in debian/package.manpages file. This is more a historical design
  53 flaw than a bug.
  54 .SH AUTHOR
  55 Joey Hess <joeyh@debian.org>