X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installinfo;h=814c831b58cf1cd0a19c6c64a8929283d23e5f42;hb=refs%2Ftags%2Fversion_3.4.6;hp=702f4ee8af78fecbc99dfaf12bbdbaf7f24eae17;hpb=053f6f8b4e7431d32511aef209188a084e8c7e79;p=debhelper.git diff --git a/dh_installinfo b/dh_installinfo index 702f4ee..814c831 100755 --- a/dh_installinfo +++ b/dh_installinfo @@ -1,10 +1,66 @@ #!/usr/bin/perl -w -# -# Reads debian/info, installs all files listed there into /usr/share/info -# and puts appropriate commands into the postinst. + +=head1 NAME + +dh_installinfo - install and register info files + +=cut use strict; use Debian::Debhelper::Dh_Lib; + +=head1 SYNOPSIS + +B [S>] [B<-A>] [B<-n>] [S>] + +=head1 DESCRIPTION + +dh_installinfo is a debhelper program that is responsible for installing +info files and registering the files it installs with install-info. + +It determines some information about the info files by parsing them, in +particular, it looks at the INFO-DIR-SECTION line to determine what section +the info file belongs in. + +Any filenames specified as parameters will be installed into the first +package dh_installinfo 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.info can list other files to be installed. + +dh_installinfo will automatically generate the postinst and prerm commands +needed to interface with install-info, updating the info . See L for an +explanation of how this works. + +=head1 OPTIONS + +=over 4 + +=item B<-A>, B<--all> + +Install all files specified by command line parameters in ALL packages +acted on. + +=item B<-n>, B<--noscripts> + +Do not modify postinst/prerm scripts. + +=item I + +Install these info files into the first package acted on. (Or in +all packages if -A is specified). + +=back + +=head1 NOTES + +Note that this command is not idempotent. "dh_clean -k" should be called +between invocations of this command. Otherwise, it may cause multiple +instances of the same text to be added to maintainer scripts. + +=cut + init(); foreach my $package (@{$dh{DOPACKAGES}}) { @@ -60,3 +116,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } } } + +=head1 SEE ALSO + +L + +This program is a part of debhelper. + +=head1 AUTHOR + +Joey Hess + +=cut