Re: Manual Pages

On Tue, Feb 13, 2007, Jeff Smith wrote about "Re: Manual Pages":
> I'm not good at leaving old threads alone, but...
>
> I don't think the reason was explained well enough, why we don't need
> to install man pages. I don't see that anyone mentioned the
> documentation that is _more_ convenient than man pages:
>
> svn --help
>
> Does that not provide just as much as should the man pages? If not, it
> needs to. Sometimes man page installation is more confusing or memory
> consuming, but if I'm using `svn add` then I'd rather be able to just
> say `svn --help add`, and that's just what I do.

You still didn't convince me that we don't need man pages.
I can understand why you do not want to do this yourself (no free time, and no
personal interest), but I can't understand while you'd be against someone
else doing this (which appears to be your position on the subject).

The "svn help" is not bad, but like I and other people on this thread
mentioned, it is only a short summary of the command line options, and is
(deliberately!) missing explanations on what happens in various cases,
examples, and other things which are normally placed in Unix "manual pages".

And the interesting point that I was trying to make in this thread is that
the writers of the "svn book" basically agree with me that "manual pages"
(a reference manual of each command, between the short "svn --help" and a
long book-like tutorial) are useful, and such manual pages are already
included as a section of the SVN book, so I suggested making the same text
available as standard Unix man pages.

-- 
Nadav Har'El                        |      Sunday, Feb 18 2007, 30 Shevat 5767
nyh@math.technion.ac.il             |-----------------------------------------
Phone +972-523-790466, ICQ 13349191 |Experience is what causes a person to
http://nadav.harel.org.il           |make new mistakes instead of old ones.
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org