dh_installexamples.1

   1 .TH DH_INSTALLEXAMPLES 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_installexamples \- install example files into package build directories
   4 .SH SYNOPSIS
   5 .B dh_installexamples
   6 .I "[debhelper options] [-A] [file ...]"
   7 .SH "DESCRIPTION"
   8 dh_installexamples is a debhelper program that is responsible for installing
   9 examples into usr/share/doc/package/examples in package build directories.
  10 .P
  11 Any file names specified as parameters will be installed into the first
  12 package dh_installexamples is told to act on. By default, this is the first
  13 binary package in debian/control, but if you use -p, -i, or -a flags, it
  14 will be the first package specified by those flags.
  15 .P
  16 Files named debian/package.examples can list other files to be installed.
  17 .SH OPTIONS
  18 .TP
  19 .B debhelper options
  20 See
  21 .BR debhelper (1)
  22 for a list of options common to all debhelper commands.
  23 .TP
  24 .B \-A, \--all
  25 Install any files specified by command line parameters in ALL packages
  26 acted on.
  27 .TP
  28 .B file ...
  29 Install these files as examples into the first package acted on. (Or into all
  30 packages if -A is specified.)
  31 .SH NOTES
  32 Note that dh_installexamples will happily copy entire directory hierarchies if
  33 you ask it to (it uses cp -a internally). If it is asked to install a
  34 directory, it will install the complete contents of the directory.
  35 .SH ENVIRONMENT
  36 See
  37 .BR debhelper (1)
  38 for a list of environment variables that affect all debhelper commands.
  39 .SH "SEE ALSO"
  40 .BR debhelper (1)
  41 .SH BUGS
  42 It's impossible to specify filenames with spaces or other whitespace in them
  43 in debian/package.examples file. This is more a historical design flaw than a
  44 bug.
  45 .SH "CONFORMS TO"
  46 Debian policy, version 3.0.1
  47 .SH AUTHOR
  48 Joey Hess <joeyh@debian.org>