[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Manual Pages

From: Nadav Har'El <nyh_at_math.technion.ac.il>
Date: 2007-01-24 12:37:54 CET

On Wed, Jan 24, 2007, Adrian Howard wrote about "Re: Manual Pages":
> On 24 Jan 2007, at 11:15, Nadav Har'El wrote:
> >Hi, I've been wondering why the Subversion commands do not have manual
> >pages. Why can't I run "man svn" or "man svn-checkout" and expect
> >to see
> >something useful?
>
> Is there anything that man pages would give you that
>
> svk help <command>
>
> wouldn't?

The example that bothered me was the "info" command. Compare "svn help info"
to http://svnbook.red-bean.com/en/1.1/re13.html

"svn help info" is way too short and is missing a lot of information. What
kinds of details can "svn info" print? Does it access the repository, or
just the working files? All this information (and no useless "cruft") is
in the aforementioned Web page, which could make a very good manpage, so
why not?

Other pages on the svnbook site have different advantages over the
corresponding "svn help" result. Some have examples of typical usage,
information on what happens in exceptional cases, and more.

-- 
Nadav Har'El                        |    Wednesday, Jan 24 2007, 5 Shevat 5767
nyh@math.technion.ac.il             |-----------------------------------------
Phone +972-523-790466, ICQ 13349191 |Life's a bitch, but god forbid the bitch
http://nadav.harel.org.il           |divorce me -- Nas
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Wed Jan 24 12:38:45 2007

This is an archived mail posted to the Subversion Users mailing list.