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

Re: man pages for Subversion

From: Stefan Sperling <stsp_at_elego.de>
Date: Thu, 8 Aug 2013 08:42:14 +0200

On Thu, Aug 08, 2013 at 08:58:29AM +0300, Daniel Shahaf wrote:
> James K. Lowden wrote on Wed, Aug 07, 2013 at 20:13:16 -0400:
> > 1. Keep the man pages in mdoc format as the "souce code".
> > 2. Convert "svn foo --help" and "svn help foo" to invoke man(1), as
> > git does. Or use groff to generate plain text for static inclusion in
> > the the binary.
> As Bert said: not possible. We support Windows and that has no man(1)
> or nroff(1) binaries.

Please do not change the behaviour of 'svn help' for this.
It needs compiled-in strings so that it works on any platform.

I think man pages only matter on UNIX-like platforms. They shouldn't
even be generated during builds on other platforms. They should be an
alternative to 'svn help' so that UNIX users have a familiar interface
to this documentation.

If you manage to generate both the compiled-in strings and the man
pages (on UNIX only) from the same source format during the build,
I"m happy with that. If you manage to generate man pages from
'svn help' output during the build process on UNIX, then I'm happy, too.
Received on 2013-08-08 08:42:57 CEST

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