--- Imre Vida <[EMAIL PROTECTED]> 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 @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 [EMAIL PROTECTED] To report problems, send mail to [EMAIL PROTECTED]
