Bug#184064: debian-policy: [PROPOSAL] Every window manager should provide an alternative to the x-window-manager.1 manpage

[Josip Rodin <joy@srce.hr>]

On Sun, Mar 09, 2003 at 02:53:10PM +0100, Jérôme Marant wrote:
> >> Currently, some window managers like IceWM or Sawfish, provide an
> >> alternative to x-window-manager.1. It would be consistent to add this
> >> to the policy since window managers provide an alternative to
> >> x-window-manager as well.
> >
> > Since the policy already requires a manual page for any program, and
> > since "x-window-manager" is in the $PATH and is used as any other program,
> > it makes sense for it to have a manual page.
> >
> > On the other hand, we could do it smarter and write manual pages for our
> > common alternatives, so that when a user looks them up in the manual system
> > they see the whole story.
> 
> Well, if running x-window-manager runs a given window manager, then
> the x-window-manager manpage should point to the manpage of the
> window manager which is run through x-window-manager.
> 
> Isn't it logical?

Think harder. :) A user runs man x-window-manager once, sees something,
later the alternative gets changes to another WM for whatever reason, they
run man x-window-manager again, see another thing, confusion ensues.

-- 
     2. That which causes joy or happiness.