On Mon, Nov 15, 2021 at 09:00:43PM +0100, Dominik Vogt wrote:
> Now, about the contents of the new man pages:  Splitting has not
> bought us that much yet.  75% of the contents are now in the
> commands man page.  It's difficult to remove more things from that
> because the command list also contains general topics like menus,
> session management and coloursets.  Moving these parts to
> different pages would also remove them from the command list.  The
> original man page just has a bad structure.

I suppose another way of looking at it might be to trying to convey things in
terms of functional areas, almost looking at things that a user might want as
they're configuring fvwm.   Right now, we're trying to lump together a lot of
similar things.  We could go further and have something like:

* An overview section explaining the anatomy/role of the window manager,
  explaining things such as:

  - Windows (decorations, anatomy, etc.)
  - Menus
  - Core functionality
  - Extending functionality (modules)

For explaining windows, we could enumerate the styles which are specific to
manipulating windows.  Grouping them by EWMH, window movement, etc.  Then we
would need an "fvwmallstyles" man page which aggregates these together.

> It's not obvious how to move the Style command (a subsection of
> the commands page) to a different file without cluttering the
> source with ifdefs.

That's a small price to pay for trying to increase readability, IMO.


Reply via email to