Re: [PATCH] : tiny manpages for svndumpfilter, svnserve, svnversion

C. Michael Pilato wrote:
> Julian Foad <julianfoad@btopenworld.com> writes:
>
>>David Kimdon wrote:
>>
>>>Any objections or seconds to the following?
>>
>>+1 (minor comments below). I like man pages. Mind you, I like them
>>even better when they have the manual in them, but that was proving
>>to be too difficult for us to maintain.
>>
>>As we now have about six man pages sharing a sizeable block of text,
>>it would be nice to factor out that block and build the man pages at
>>build time from mostly shared source text.
>
> I think the idea here is that these man pages should never need to be
> edited again. So, while I'm +1 on adding the pages, I think
> factorizing them is probably premature at this point.

I know ... but it's very easy to think that that block of text is never going to need to change, but then you realise that it says "svn", "svnadmin" and "svnlook" are described in the book, but doesn't mention "svnserve", and it is perverse for "man svnserve" not to mention explicitly that there is more information about it in the book, so the never-going-to-change text already needs to change ... Get my point?

But I'm not insisting that somebody makes it happen right now.

- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Mon Oct 13 03:09:42 2003