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 Files named debian/package.examples can list other files to be installed.
22 for a list of options common to all debhelper commands.
25 Install any files specified by command line parameters in ALL packages
29 Install these files as examples into the first package acted on. (Or into all
30 packages if -A is specified.)
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.
38 for a list of environment variables that affect all debhelper commands.
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
46 Debian policy, version 3.0.1
48 Joey Hess <joeyh@debian.org>