--- Imre Vida <Imre.Vida_at_anat.uni-freiburg.de> a
écrit : > On Mon, Aug 26, 2002 at 05:28:28PM +0200,
szonyi
> calin wrote:
> > Welcome to *nix
>
> Well, thanks for the nice welcome.
>
:-)
>
> > I think the man page should remain as it is.
> > The man page format is standard.
> > Man page _is_ a reference. Man page _is not_ a
> > tutorial. Will never be.
>
> I was making a benevolent suggestion, what i
> thought would/could
> help some people.
> It was not about any kind of tutorial, but only
> about putting
> a piece of information (that is already in the
> manual) somewhere
> at the begining, where people reading the man the
> first time can
> easily spot it.
That's the problem with man pages: the references
are at the end, usually :-)
There was a good manual viewer (X11 based) which
was acting like a browser (i.e. you had a TOC at the
beginning and when you pressed the word on that TOC
the program took you right to the place where it was
in the manual.) but it seems it's not on the net
anymore.
> I was also not suggesting to change the (holy)
> Format either.
> But i can't fail to note here, that the standard
> does not seem to be
> that very strictly defined - see man of man:
>
> " A manual page consists of several parts.
> They may be labelled NAME, SYNOPSIS, DESCRIPTION,
> OPTIONS, FILES,
> SEE ALSO, BUGS, and AUTHOR."
>
> Please note: MAY be labelled.
>
Sorry. Next time i'll double check before saying
something
>
> So i don't really understand your rather harsh tone.
> Could you explain?
>
I saw some man pages which were written some kind
backwards: Name , Synopsys, Description (very long
-literature), Options (command options), real
description of options (after a couple of pages).
I don't want to read man pages where the options
of command are after ten pages of scrolling.
A tutorial has many literature (by literature
underestanding the part that tells to users
what's a pager, what's a taskbar and other similar
things.)
>
> > If you are impatient and newbie in the same time
> > the chances of screwing things up are big
>
> The "To the Impatient" was meant to have a pinch of
> irony/humor. Well, it seems i could not bring it
> through - sorry about that.
>
Sorry, i misunderestood that one :-(
My apologies.
>
>
> best
>
> imre
Calin
___________________________________________________________
Do You Yahoo!? -- Une adresse _at_yahoo.fr gratuite et en français !
Yahoo! Mail :
http://fr.mail.yahoo.com
--
Visit the official FVWM web page at <URL: http://www.fvwm.org/>.
To unsubscribe from the list, send "unsubscribe fvwm" in the body of a
message to majordomo_at_fvwm.org.
To report problems, send mail to fvwm-owner_at_fvwm.org.
Received on Tue Aug 27 2002 - 05:34:39 BST