dh_installwm.1

   1 .TH DH_INSTALLWM 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_installwm \- register a window manager
   4 .SH SYNOPSIS
   5 .B dh_installwm
   6 .I "[debhelper options] [-n] [--priority=n] [wm ...]"
   7 .SH "DESCRIPTION"
   8 dh_installwm is a debhelper program that is responsible for
   9 generating the postinst and postrm commands that register a window manager
  10 with
  11 .BR update-alternatives (8)
  12 .P
  13 Any windowmanager filenames specified as parameters will be registered in
  14 the first package dh_installwm is told to ast on. By default, this is the
  15 first binary package in debian/control, but if you use -p, -i, or -a flags, it
  16 will be the first package specified by those flags.
  17 .P
  18 A file named debian/package.wm (debian/wm may be used for the
  19 first binary package in debian/control) can list other window manager to
  20 register.
  21 .SH OPTIONS
  22 .TP
  23 .B debhelper options
  24 See
  25 .BR debhelper (1)
  26 for a list of options common to all debhelper commands.
  27 .TP
  28 .B \--priority=n
  29 Set the priority of the window manager. Default is 20, which is too low for
  30 most window managers; see the Debian Policy document for instructions on
  31 calculating the correct value.
  32 .TP
  33 .B \-n, \--noscripts
  34 Do not modify postinst/postrm scripts. Turns this command into a no-op.
  35 .TP
  36 .B wmfilename
  37 The filename of the window manager you wish to register.
  38 .SH NOTES
  39 Note that this command will set up postinst and postrm scripts for every
  40 package it acts on. It's wise to limit its action to a single package with,
  41 for example, the -p switch.
  42 .SH ENVIRONMENT
  43 See
  44 .BR debhelper (1)
  45 for a list of environment variables that affect all debhelper commands.
  46 .SH NOTES
  47 Note that this command is not idempotent. "dh_clean -k" should be called
  48 between invocations of this command. Otherwise, it may cause multiple
  49 instances of the same text to be added to maintainer scripts.
  50 .SH "SEE ALSO"
  51 .TP
  52 .BR debhelper (1)
  53 .TP
  54 .BR update-alternatives (8)
  55 .SH AUTHOR
  56 Joey Hess <joeyh@debian.org>