dh_installdocs.1

   1 .TH DH_INSTALLDOCS 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_installdocs \- install documentation into package build directories
   4 .SH SYNOPSIS
   5 .B dh_installdocs
   6 .I "[debhelper options] [-A] [-n] [file ...]"
   7 .SH "DESCRIPTION"
   8 dh_installdocs is a debhelper program that is responsible for installing
   9 documentation into usr/share/doc/package in package build directories.
  10 .P
  11 dh_installdocs automatically installs debian/copyright if it exists. If
  12 dh_installdocs is acting on multiple packages, debian/copyright files will be
  13 installed into all packages. However, if you need to have seperate copyright
  14 files for different binary packages, you can use files named
  15 debian/package.copyright.
  16 .P
  17 Any filenames specified as parameters will be installed into the first
  18 package dh_installdocs is told to act on. By default, this is the first
  19 binary package in debian/control, but if you use -p, -i, or -a flags, it
  20 will be the first package specified by those flags.
  21 .P
  22 Also, debian/README.Debian (or debian/README.debian) and debian/TODO, if
  23 they exist, will be installed into the first binary package listed in
  24 debian/control, if dh_installdocs is acting on that package. Note that
  25 debian/TODO will be installed named TODO.Debian, if the package is not a
  26 debian native package. Also note that README.debian is installed as
  27 README.Debian, for consitency. Note that debian/package.README.Debian and
  28 debian/package.TODO can be used to specify files for subpackages.
  29 .P
  30 A file named debian/package.docs (debian/docs may be used for the first
  31 binary package in debian/control) can list other files to be installed.
  32 .P
  33 This program will automatically generate postinst and prerm commands to
  34 maintain a compatability symlink, /usr/doc/package, to the documentation in
  35 /usr/share/doc/package. See
  36 .BR dh_installdeb (1)
  37 for an explanation of how this works.
  38 .P
  39 A file named debian/package.doc-base (debian/doc-base may be used for the
  40 first binary package in debian/control), if it exists, will be installed as
  41 a doc-base control file, and will make this program automatically generate the
  42 postinst and prerm commands needed to interface with the doc-base package. See
  43 .BR dh_installdeb (1)
  44 for an explanation of how this works.
  45 Note that the doc-id will be determined from the "Document:" entry in the
  46 doc-base control file in question.
  47 .PP
  48 If your package needs to register more
  49 than one document, you need multiple files. To accomplish this, you can use
  50 files named debian/package.doc-base.*
  51 .SH OPTIONS
  52 .TP
  53 .B debhelper options
  54 See
  55 .BR debhelper (1)
  56 for a list of options common to all debhelper commands.
  57 .TP
  58 .B \-A, \--all
  59 Install all files specified by command line parameters in ALL packages
  60 acted on.
  61 .TP
  62 .B \-n, \--noscripts
  63 Do not modify postinst/prerm scripts.
  64 .TP
  65 .B file ...
  66 Install these files as documentation into the first package acted on. (Or in
  67 all packages if -A is specified).
  68 .SH NOTES
  69 Note that dh_installdocs will happily copy entire directory hierarchies if
  70 you ask it to (it uses cp -a internally). If it is asked to install a
  71 directory, it will install the complete contents of the directory.
  72 .SH ENVIRONMENT
  73 See
  74 .BR debhelper (1)
  75 for a list of environment variables that affect all debhelper commands.
  76 .SH "SEE ALSO"
  77 .BR debhelper (1)
  78 .TP
  79 .BR install-docs (8)
  80 .SH BUGS
  81 It's impossible to specify filenames with spaces or other whitespace in them
  82 in debian/docs file. This is more a historical design flaw than a bug.
  83 .SH "CONFORMS TO"
  84 Debian policy, version 3.0.1
  85 .SH AUTHOR
  86 Joey Hess <joeyh@master.debian.org>