dh_scrollkeeper

   1 #!/usr/bin/perl -w
   2
   3 =head1 NAME
   4
   5 dh_scrollkeeper - generate ScrollKeeper registration scripts
   6
   7 =cut
   8
   9 use strict;
  10 use Debian::Debhelper::Dh_Lib;
  11
  12 =head1 SYNOPSIS
  13
  14 B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]
  15
  16 =head1 DESCRIPTION
  17
  18 B<dh_scrollkeeper> is a debhelper program that handles correctly
  19 registering OMF files that it finds in package build trees with
  20 ScrollKeeper.
  21
  22 This command automatically adds maintainer script snippets for registering
  23 and unregistering files with ScrollKeeper (unless B<-n> is used). A
  24 dependency on scrollkeeper will be added to C<${misc:Depends}>, so be sure
  25 your package uses that variable in F<debian/control>. See
  26 L<dh_installdeb(1)> for an explantion of Debhelper maintainer script
  27 snippets.
  28
  29 It will also change any DTD declarations in the OMF and DocBook files
  30 to refer to local files instead of remote URLs. This change does not
  31 modify the source files, but the files in the package build tree.
  32
  33 =head1 OPTIONS
  34
  35 =over 4
  36
  37 =item B<-n>, B<--noscripts>
  38
  39 Do not modify F<postinst>/F<postrm> scripts.
  40
  41 =back
  42
  43 =head1 NOTES
  44
  45 Note that this command is not idempotent. "dh_clean -k" should be
  46 called between invocations of this command. Otherwise, it may cause
  47 multiple instances of the same text to be added to maintainer scripts.
  48
  49 =cut
  50
  51 init();
  52
  53 # This is a list of paths where DocBook files might be stored.
  54 my @xml_paths = (
  55         'usr/share/gnome/help' # GNOME Help
  56 );
  57
  58 # Append the remaining command line arguments
  59 push @xml_paths, @ARGV if @ARGV;
  60
  61 foreach my $package (@{$dh{DOPACKAGES}}) {
  62         my $tmp=tmpdir($package);
  63
  64         # Only run if there have been OMF files installed
  65         if (-d "$tmp/usr/share/omf") {
  66                 # Get a list of the OMF files
  67                 my @omf_files = `find $tmp/usr/share/omf -type f -printf '%p\n'`;
  68                 if (@omf_files) {
  69                         if (! $dh{NOSCRIPTS}) {
  70                                 autoscript($package,"postinst","postinst-scrollkeeper");
  71                                 autoscript($package,"postrm","postrm-scrollkeeper");
  72                         }
  73                         # scrollkeeper use xml catalogs so we require 0.3.14-5+.
  74                         addsubstvar($package, "misc:Depends", "scrollkeeper", ">= 0.3.14-5");
  75                 }
  76         }
  77 }
  78
  79 =head1 SEE ALSO
  80
  81 L<debhelper>
  82
  83 This program is a part of debhelper.
  84
  85 =head1 AUTHOR
  86
  87 Ross Burton <ross@burtonini.com>
  88
  89 =cut