On Tue, Apr 25, 2006 at 03:02:59PM +0200, jdd wrote:
> but a man mapge is just that: a remainder of commands
For me `an interface to the on-line reference manuals` is more then just a
list of -v, -h, -l and so on.
> all other is a true documentation.
OK. What should be at least added are some usable examples and more
explanation then what the -h gives you. If you have that, then you have
almost true documentation *for the use of the program*.
Other documentation can talk about the history, the future, the people or
worldpeace and should not be part of the manpage.
One of the best manpages is, I think, fetchmail. Especially the part
"CONFIGURATION EXAMPLES". I learned more from that chapter on how to use
it then from any other part of the manpage.
Once I had it running (did not took too long) I could look into the rest
of the parameters and learn to use it.
> you know the thing who lacks the more in big apps is the
> goal of the app.
>
> try to figure out what is the goal of Xen...
Perhaps a mission and vision statement is more apropriate for large apps.
;-)
houghi
--
Nutze die Zeit. Sie ist das Kostbarste, was wir haben, denn es
ist unwiederbringliche Lebenszeit. Leben ist aber mehr als Werk
und Arbeit, und das Sein wichtiger als das Tun
- Johannes Müller-Elmau
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
