Re: FVWM: [2.0.44] Bugs in the fvwm2.man page

From: David Kennedy <D.Kennedy_at_Queens-Belfast.AC.UK>
Date: Fri, 17 Jan 1997 00:17:01 GMT

Andrew said:
> On Thu, 16 Jan 1997, Paul D. Smith wrote:
>
> > And some examples of good uses of decors, title styles, etc. is
> > imperative. I'm not necessarily saying all these should go in the man
> > page, of course, but some comments somewhere to help one wade through
> > the myriad features is mandatory. I'm lost!
>
> Well, the problem is that examples need to be created. Chuck mentioned
> that he's looking for donations of RC examples (hint, hint :-). It's
> difficult for one person to come up with many examples, the best ones are
> usually picked out from posts.

Fair enough. The problem is that if you're trying to find out how these
things work from the man pages as they stand, you haven't got a hope!
It may even be worthwhile having a separate man page for the various
'decor' items now, there are many keywords involved and in the mainly
alphabetical listing in the (huge) main man page its hard to put them
together. A more organic approach showing a typical set up and then
a tree like structure of options for BorderStyle, ButtonStyle, TitleStyle,
etc.

Under the manual entry for 'ButtonStyle' at the moment there is even
a TitleStyle example! (Its about VGradient but still...)

It'd be much easier to read if all these 'cosmetic' decor commands
were grouped together. After all their syntax is quite similar.
And the syntax isn't as easy as it used to me, its harder to read
until you figure out where you are. Ever see a new fvwm user's
face looking at a UseDecor statement (well, neither had I until
today obviously...but it was 'Uh? Whats this? I thought I was
getting used to this ..rc stuff')

(It doesn't help that there are degenerate manual entries too...
        TitleStyle [justification] [height num]
        TitleStyle [state] [style] [ -- [!]flag ...] )

Note, no-ones complaining about the functionality, just about
to use _all_ of the features. Lets face it, I want as many different
effects on the screen at once as I can get!



-- 
David Kennedy, The Queen's University of Belfast.
--
Visit the official FVWM web page at <URL:http://www.hpc.uh.edu/fvwm/>.
To unsubscribe from the list, send "unsubscribe fvwm" in the body of a
message to majordomo_at_hpc.uh.edu.
To report problems, send mail to fvwm-owner_at_hpc.uh.edu.
Received on Thu Jan 16 1997 - 18:14:18 GMT

This archive was generated by hypermail 2.3.0 : Mon Aug 29 2016 - 19:37:59 BST