NAME    [Toc]    [Back]

       dh_installexamples - install example files into package build directories

SYNOPSIS    [Toc]    [Back]

       dh_installexamples [debhelper options] [-A] [-Xitem] [file ...]

DESCRIPTION    [Toc]    [Back]

       dh_installexamples is a debhelper program that is responsible for
       installing examples into usr/share/doc/package/examples in package
       build directories.

       Any file names specified as parameters will be installed into the first
       package dh_installexamples is told to act on. By default, this is the
       first binary package in debian/control, but if you use -p, -i, or -a
       flags, it will be the first package specified by those flags.

       Files named debian/package.examples can list other files to be
       installed.

OPTIONS    [Toc]    [Back]

       -A, --all
	   Install any files specified by command line parameters in ALL packages
 acted on.

       file ...
	   Install these files as examples into the first package acted on.
	   (Or into all packages if -A is specified.)

       -Xitem, --exclude=item
	   Exclude files that contain "item" anywhere in their filename from
	   being installed.

NOTES    [Toc]    [Back]

       Note that dh_installexamples will happily copy entire directory hierarchies
 if you ask it to (similar to cp -a). If it is asked to install a
       directory, it will install the complete contents of the directory.

SEE ALSO    [Toc]    [Back]

       debhelper(1)

       This program is a part of debhelper.

AUTHOR    [Toc]    [Back]

       Joey Hess <joeyh@debian.org>



3rd Berkeley Distribution	  2002-02-28		 DH_INSTALLEXAMPLES(1)