1 .TH DH_INSTALLEXAMPLES 1 "" "Debhelper Commands" "Debhelper Commands"
3 dh_installexamples \- install example files into package build directories
6 .I "[debhelper options] [-A] [file ...]"
8 dh_installexamples is a debhelper program that is responsible for installing
9 examples into usr/share/doc/package/examples in package build directories.
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.
16 A file named debian/package.examples (debian/examples may be used for the
17 first binary package in debian/control) can list other files to be installed.
23 for a list of options common to all debhelper commands.
26 Install any files specified by command line parameters in ALL packages
30 Install these files as examples into the first package acted on. (Or into all
31 packages if -A is specified.)
33 Note that dh_installexamples will happily copy entire directory hierarchies if
34 you ask it to (it uses cp -a internally). If it is asked to install a
35 directory, it will install the complete contents of the directory.
39 for a list of environment variables that affect all debhelper commands.
43 It's impossible to specify filenames with spaces or other whitespace in them
44 in debian/examples file. This is more a historical design flaw than a bug.
46 Debian policy, version 3.0.1
48 Joey Hess <joeyh@debian.org>