dh_installwm(1)

dh_installwm1

Register a window manager

Usage

dh_installwm [debhelper options] [-n] [--priority=n] [wm ...]

Overview

dh_installwm is a debhelper program that is responsible for generating the postinst and prerm commands that register a window manager with update-alternatives(8). The window manager's man page is also registered as a slave symlink (in v6 mode and up). It must be installed in usr/share/man/man1/ in the package build directory prior to calling dh_installwm. In compat 9 and earlier, the manpage was optional.

Files

debian/package.wm

List window manager programs to register.

Supports substitution variables in compat 13 and later as documented in debhelper(7).

Options

--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.

-n, --no-scripts

Do not modify postinst/prerm scripts. Turns this command into a no-op.

-A, --all

Modify scripts for window managers specified by command line parameters in ALL packages acted on, not just the first.

wm ...

Window manager programs to register.

Notes

Note that this command is not idempotent. dh_prep(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.

Releases

14 releases since Debian 2.1 (Slink); the text changed 13 times.

  1. 2.1
  2. 2.2
  3. 3.0
  4. 3.1
  5. 4.0
  6. 5.0
  7. 6.0
  8. 7
  9. 8
  10. 9
  11. 10
  12. 11
  13. 12
  14. 13

--all since Debian 10 (Buster); --no-scripts since Debian 9 (Stretch); --priority since Debian 3.0 (Woody); -A since Debian 10 (Buster).

--noscripts until Debian 8 (Jessie).

Author

Joey Hess <[email protected]>

From debhelper 13.24.2 in Debian 13 (Trixie). Parsed by carta from the page's man source.