=head1 SYNOPSIS
-B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [S<I<wm ...>>]
+B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [S<I<wm> ...>]
=head1 DESCRIPTION
-dh_installwm is a debhelper program that is responsible for
-generating the postinst and postrm commands that register a window manager
+B<dh_installwm> is a debhelper program that is responsible for
+generating the F<postinst> and F<prerm> commands that register a window manager
with L<update-alternatives(8)>. The window manager's man page is also
registered as a slave symlink (in v6 mode and up), if it is found in
-usr/share/man/man1/ in the package build directory.
+F<usr/share/man/man1/> in the package build directory.
-Any window manager programs 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.
+=head1 FILES
-Files named debian/package.wm can list other window manager programs to
-register.
+=over 4
+
+=item debian/I<package>.wm
+
+List window manager programs to register.
+
+=back
=head1 OPTIONS
=item B<-n>, B<--noscripts>
-Do not modify postinst/postrm scripts. Turns this command into a no-op.
+Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op.
-=item I<wm ...>
+=item I<wm> ...
-The commands used to run the window manager or window managers you want to
-register.
+Window manager programs to register.
+
+=back
=head1 NOTES
-Note that this command is not idempotent. "dh_clean -k" should be called
+Note that this command is not idempotent. L<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.
-=back
-
=cut
init();