dh_installmanpages.1

   1 .TH DH_INSTALLDOCS 1
   2 .SH NAME
   3 dh_installmanpages \- install man pages into package build directories
   4 .SH SYNOPSIS
   5 .B dh_installmanpages
   6 .I "[-v] [-a] [-i] [-ppackage] [file ...]"
   7 .SH "DESCRIPTION"
   8 dh_installmanpages is a debhelper program that is responsible for
   9 automatically installing man pages into usr/man/ and usr/X11R6/man/ in
  10 package build directories.
  11 .P
  12 dh_installmanpages scans the current directory and all subdirectories for
  13 filenames that look like man pages. It uses
  14 .BR file (1)
  15 to verify that the files are in the correct format. Then, based on the
  16 files' extentions, it installs them into the correct man directory.
  17 .P
  18 All filenames specified as parameters will be skipped by dh_installmanpages.
  19 This is useful if by default it installs some man pages that you do not want
  20 to be installed.
  21 .SH OPTIONS
  22 .TP
  23 .B \-v
  24 Verbose mode; show all commands that modify the package build directory.
  25 .TP
  26 .B \-a
  27 Install man pages into all architecture dependent packages.
  28 .TP
  29 .B \-i
  30 Install man pages into all architecture independent packages.
  31 .TP
  32 .B \-ppackage
  33 Install man pages into the package named "package".
  34 .TP
  35 .B file ...
  36 Do not install these files as man pages, even if they look like valid man
  37 pages.
  38 .SH NOTES
  39 The
  40 .B \-a
  41 .B \-i
  42 and
  43 .B \-p
  44 arguments are cumulative. If none are specified, then all packages listed in
  45 the control file will be effected.
  46 .P
  47 dh_installmanpages will install the man pages it finds into
  48 .B all
  49 packages you tell it to act on, since it can't tell what package the man
  50 pages belong in.
  51 .SH ENVIRONMENT
  52 .TP
  53 .I DH_VERBOSE
  54 Enables verbose mode
  55 .SH "SEE ALSO"
  56 .BR /usr/doc/debhelper/README
  57 .SH BUGS
  58 Man pages with the extention
  59 .B .man
  60 are not automatically installed.
  61 .P
  62 Files specified as parameters that contain spaces in their filenames will
  63 not be processed properly.
  64 .P
  65 This is a "Do what I Mean" type program - you have been warned!
  66 .SH AUTHOR
  67 Joey Hess <joeyh@master.debian.org>