Re: man pages out of date [was internal/external diff docs and usage]

Paul Lussier <pll@lanminds.com> writes:

> So, should I look at updating the static man pages now, or would it
> be better to wait until Rafael has time to add the necessary code to
> the C sources to automagically generate man pages at build time?

To be honest, I hate seeing all this duplication of documentation:

  * all our binaries are already self-documenting ('svn help foo')

  * the man pages potentially contain the same information

  * chapter 8 of the book has the same information, plus some
    discussion.

If it were up to me, I'd make our man pages *really* short: they
would simply tell people to run 'svn help', and contain links to the
website and/or book.

Voila, no more needing to keep the man pages in sync with the
binaries. :-)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Mar 14 16:33:25 2003