dh_installwm

   1 #!/usr/bin/perl -w
   2
   3 =head1 NAME
   4
   5 dh_installwm - register a window manager
   6
   7 =cut
   8
   9 use strict;
  10 use Debian::Debhelper::Dh_Lib;
  11
  12 =head1 SYNOPSIS
  13
  14 B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [S<I<wm ...>>]
  15
  16 =head1 DESCRIPTION
  17
  18 dh_installwm is a debhelper program that is responsible for
  19 generating the postinst and postrm commands that register a window manager
  20 with L<update-alternatives(8)>. The window manager's man page is also
  21 registered as a slave symlink (in v6 mode and up), if it is found in
  22 usr/share/man/man1/ in the package build directory.
  23
  24 Any window manager programs specified as parameters will be registered in
  25 the first package dh_installwm is told to act on. By default, this is the
  26 first binary package in debian/control, but if you use -p, -i, or -a flags,
  27 it will be the first package specified by those flags.
  28
  29 Files named debian/package.wm can list other window manager programs to
  30 register.
  31
  32 =head1 OPTIONS
  33
  34 =over 4
  35
  36 =item B<--priority=>I<n>
  37
  38 Set the priority of the window manager. Default is 20, which is too low for
  39 most window managers; see the Debian Policy document for instructions on
  40 calculating the correct value.
  41
  42 =item B<-n>, B<--noscripts>
  43
  44 Do not modify postinst/postrm scripts. Turns this command into a no-op.
  45
  46 =item I<wm ...>
  47
  48 The commands used to run the window manager or window managers you want to
  49 register.
  50
  51 =head1 NOTES
  52
  53 Note that this command is not idempotent. "dh_clean -k" should be called
  54 between invocations of this command. Otherwise, it may cause multiple
  55 instances of the same text to be added to maintainer scripts.
  56
  57 =back
  58
  59 =cut
  60
  61 init();
  62
  63 if (! defined $dh{PRIORITY}) {
  64         $dh{PRIORITY}=20;
  65 }
  66
  67 if (@ARGV) {
  68         # This is here for backwards compatibility. If the filename doesn't
  69         # include a path, assume it's in /usr/bin.
  70         if ($ARGV[0] !~ m:/:) {
  71                 $ARGV[0]="/usr/bin/$ARGV[0]";
  72         }
  73 }
  74
  75 foreach my $package (@{$dh{DOPACKAGES}}) {
  76         my $tmp=tmpdir($package);
  77         my $file=pkgfile($package,"wm");
  78
  79         my @wm;
  80         if ($file) {
  81                 @wm=filearray($file, '.');
  82         }
  83
  84         if (($package eq $dh{FIRSTPACKAGE} || $dh{PARAMS_ALL}) && @ARGV) {
  85                 push @wm, @ARGV;
  86         }
  87
  88         if (! $dh{NOSCRIPTS}) {
  89 WM:             foreach my $wm (@wm) {
  90                         autoscript($package,"prerm","prerm-wm","s:#WM#:$wm:");
  91
  92                         my $wmman;
  93                         if (! compat(5)) {
  94                                 foreach my $ext (".1", ".1x") {
  95                                         $wmman="/usr/share/man/man1/".basename($wm).$ext;
  96                                         if (-e "$tmp$wmman" || -e "$tmp$wmman.gz") {
  97                                                 autoscript($package,"postinst","postinst-wm","s:#WM#:$wm:;s:#WMMAN#:$wmman.gz:;s/#PRIORITY#/$dh{PRIORITY}/",);
  98                                                 next WM;
  99                                         }
 100                                 }
 101                         }
 102                         autoscript($package,"postinst","postinst-wm-noman","s:#WM#:$wm:;s/#PRIORITY#/$dh{PRIORITY}/",);
 103                 }
 104         }
 105 }
 106
 107 =head1 SEE ALSO
 108
 109 L<debhelper(7)>
 110
 111 This program is a part of debhelper.
 112
 113 =head1 AUTHOR
 114
 115 Joey Hess <joeyh@debian.org>
 116
 117 =cut