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

Re: svn command line tool man page

From: <kfogel_at_collab.net>
Date: 2001-10-12 19:19:57 CEST

"B. W. Fitzpatrick" <fitz@red-bean.com> writes:
> Groovy. Before I check it in, I'd like some general feedback from the
> list:
>
> 1. Do we want to keep this in nroff format? If not, do you have any
> suggestions for a format we can use to generate a man page?
>
> 2. Does anyone object to keeping this in
> subversion/clients/cmdline/man? Should we keep it in the doc tree?
>
> Anything else?

I think either there or doc tree is okay; there are good arguments in
favor of both and against either, so I follow Mike's lead and wash my
hands of the matter. :-)

Just as a side note, I started out wondering "Gosh, do we really want
to maintain a separate man page, when a lot of its content will be
duplicated in the main user manual?" But then I thought, yes, we do.
The `man' system is still a standard, people expect to get basic usage
information from running `man svn', and it can always point to the
main documentation for more in-depth explanations. So that's a sort
of preemptive justification for having a man page, in case anyone was
about to raise that particular objection.

Don't know anything about generating nroff/man format from some other
master format. Perhaps someone else on the list has experience with
this?

-K

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sat Oct 21 14:36:44 2006

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