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

man pages for Subversion

From: James K. Lowden <jklowden_at_schemamania.org>
Date: Wed, 7 Aug 2013 00:07:08 -0400

e.g. http://www.schemamania.org/svn/man1/svn-propset.pdf

I offer the above mdoc man pages to the Subversion project as a token
of my appreciation, and in the hope they'll be included in future

I find using any command-line tool more convenient when it's documented
with proper man pages, so that "man foo" instantly displays the
reference manual. That's especially true of a complex tool like
subversion. The "svn help foo | less" feature is OK, but it's not as
convenient and lacks the boldface and underscores that assist in
scanning the text. HTML is better-looking, but many clicks away.

I hope you agree that the man pages are easier to read than plain
text, and the PDFs just stunning.

The pages represent perhaps 30 hours of work. The --help text was
processed through the bin/manualize Perl script to create a rough
mdoc draft. Then individual sections were edited by hand, sometimes to
put finishing touches on the formatting, sometimes to clarify the text.

The final result is surely a derived work, but it's not clear to me if
the --help text is copyrighted. I am prepare to assign it as befits
the project, if need be.

You can generate your own man pages from whatever version of Subversion
you have installed by unpacking the tarball and running "make".


Received on 2013-08-07 07:07:01 CEST

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