=head1 SYNOPSIS
- dh_installinfo [debhelper options] [-A] [-n] [file ...]
+B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [B<-n>] [S<I<file ...>>]
=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.
+Note that install-info 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
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<dh_installdeb(1)> for an
-explanation of how this works.
+needed to interface with install-info, updating the info dir. These
+commands are inserted into the maintainer scripts by dh_installdeb.
+See L<dh_installdeb(1)> for an explanation of how this works.
=head1 OPTIONS
=head1 NOTES
-Note that this command is not idempotent. "dh_clean -k" should be called
+Note that this command is not idempotent. L<dh_prep(1)> should be called
between invocations of this command. Otherwise, it may cause multiple
instances of the same text to be added to maintainer scripts.
# Only register with install-info if this is a head file in
# a tree of info files.
if ($file !~ /-\d+$/ && ! $dh{NOSCRIPTS}) {
- # Figure out what section this file goes in.
- my $section='';
- open (IN, "<$file") || die "$file: $!";
- while (<IN>) {
- if (/INFO-DIR-SECTION\s+(.*)/) {
- $section=$1;
- last;
- }
- }
- close IN;
-
my $fn="/usr/share/info/".basename($file);
- if ($section ne '') {
- $section=~s:/:\\/:g; # allow / in section.
- autoscript($package,"postinst","postinst-info",
- "s/#SECTION#/$section/g;s:#FILE#:$fn:");
- }
- else {
- autoscript($package,"postinst","postinst-info-nosection",
- "s:#FILE#:$fn:");
- }
+ autoscript($package,"postinst","postinst-info",
+ "s:#FILE#:$fn:");
autoscript($package,"prerm","prerm-info", "s:#FILE#:$fn:");
}
}
=head1 SEE ALSO
-L<debhelper(1)>
+L<debhelper(7)>
This program is a part of debhelper.