X-Git-Url: https://git.donarmstrong.com/?p=debhelper.git;a=blobdiff_plain;f=dh_installexamples;h=a39aa59359e29c859b768eba6f42cc824e34a66d;hp=1e10e65b3af915d96a83db4886b871438ebf7924;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hpb=e1975ed51b11061aeacd35886869ebbfc8d84683 diff --git a/dh_installexamples b/dh_installexamples index 1e10e65..a39aa59 100755 --- a/dh_installexamples +++ b/dh_installexamples @@ -11,20 +11,23 @@ use Debian::Debhelper::Dh_Lib; =head1 SYNOPSIS -B [S>] [B<-A>] [B<-X>I] [S>] +B [S>] [B<-A>] [B<-X>I] [S ...>] =head1 DESCRIPTION -dh_installexamples is a debhelper program that is responsible for -installing examples into usr/share/doc/package/examples in package +B is a debhelper program that is responsible for +installing examples into F 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. +=head1 FILES -Files named debian/package.examples can list other files to be installed. +=over 4 + +=item debian/I.examples + +Lists example files or directories to be installed. + +=back =head1 OPTIONS @@ -35,22 +38,22 @@ Files named debian/package.examples can list other files to be installed. Install any files specified by command line parameters in ALL packages acted on. -=item I +=item B<-X>I, B<--exclude=>I -Install these files as examples into the first package acted on. (Or into -all packages if -A is specified.) +Exclude files that contain I anywhere in their filename from +being installed. -=item B<-Xitem>, B<--exclude=item> +=item I ... -Exclude files that contain "item" anywhere in their filename from -being installed. +Install these files (or directories) as examples into the first package +acted on. (Or into all packages if B<-A> is specified.) =back =head1 NOTES -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 +Note that B will happily copy entire directory hierarchies +if you ask it to (similar to B). If it is asked to install a directory, it will install the complete contents of the directory. =cut @@ -90,8 +93,8 @@ foreach my $package (@{$dh{DOPACKAGES}}) { my $dir = ($basename eq '.') ? $example : "$example/.."; my $pwd=`pwd`; chomp $pwd; - $exclude = '-type f'.$exclude; - complex_doit("cd '$dir' && find '$basename' $exclude -exec cp --parents -dp {} $pwd/$tmp/usr/share/doc/$package/examples \\;"); + my $exclude2 = '-type f'.$exclude; + complex_doit("cd '$dir' && find '$basename' -type f$exclude -exec cp --parents -dp {} $pwd/$tmp/usr/share/doc/$package/examples \\;"); } else { doit("cp", "-a", $example, "$tmp/usr/share/doc/$package/examples");