.TH DH_INSTALLWM 1 "" "Debhelper Commands" "Debhelper Commands"
.SH NAME
dh_installwm \- register a window manager
.SH SYNOPSIS
.B dh_installwm
.I "[debhelper options] [-n] [--priority=n] [wm ...]"
.SH "DESCRIPTION"
dh_installwm is a debhelper program that is responsible for
generating the postinst and postrm commands that register a window manager
with
.BR update-alternatives (8)
.P
Any windowmanager filenames specified as parameters will be registered in
the first package dh_installwm 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.
.P
Files named debian/package.wm can list other window managers programs to
register.
.SH OPTIONS
.TP
.B debhelper options
See
.BR debhelper (1)
for a list of options common to all debhelper commands.
.TP
.B \--priority=n
Set the priority of the window manager. Default is 20, which is too low for
most window managers; see the Debian Policy document for instructions on
calculating the correct value.
.TP
.B \-n, \--noscripts
Do not modify postinst/postrm scripts. Turns this command into a no-op.
.TP
.B wmfilename
The filename of the window manager you wish to register.
.SH ENVIRONMENT
See
.BR debhelper (1)
for a list of environment variables that affect all debhelper commands.
.SH 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.
.SH "SEE ALSO"
.TP
.BR debhelper (1)
.TP
.BR update-alternatives (8)
.SH AUTHOR
Joey Hess <joeyh@debian.org>