.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLWM 1"
.TH DH_INSTALLWM 1 2024-03-27 13.15.3 Debhelper
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_installwm \- register a window manager
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_installwm\fR [\fIdebhelper\ options\fR] [\fB\-n\fR] [\fB\-\-priority=\fR\fIn\fR] [\fIwm\fR\ ...]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdh_installwm\fR is a debhelper program that is responsible for
generating the \fIpostinst\fR and \fIprerm\fR commands that register a window manager
with \fBupdate\-alternatives\fR\|(8). The window manager's man page is also 
registered as a slave symlink (in v6 mode and up).  It must be installed in
\&\fIusr/share/man/man1/\fR in the package build directory prior to calling
\&\fBdh_installwm\fR.  In compat 9 and earlier, the manpage was optional.
.SH FILES
.IX Header "FILES"
.IP debian/\fIpackage\fR.wm 4
.IX Item "debian/package.wm"
List window manager programs to register.
.Sp
Supports substitution variables in compat 13 and later as
documented in \fBdebhelper\fR\|(7).
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-\-priority=\fR\fIn\fR 4
.IX Item "--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.
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
Do not modify \fIpostinst\fR/\fIprerm\fR scripts. Turns this command into a no-op.
.IP "\fB\-A\fR, \fB\-\-all\fR" 4
.IX Item "-A, --all"
Modify scripts for window managers specified by command line
parameters in ALL packages acted on, not just the first.
.IP "\fIwm\fR ..." 4
.IX Item "wm ..."
Window manager programs to register.
.SH NOTES
.IX Header "NOTES"
Note that this command is not idempotent. \fBdh_prep\fR\|(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.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.PP
This program is a part of debhelper.
.SH AUTHOR
.IX Header "AUTHOR"
Joey Hess <joeyh@debian.org>