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

Re: [PATCH] Documenting Win32 in INSTALL

From: Bruce Atherton <bruce_at_callenish.com>
Date: 2002-02-05 01:55:09 CET

At 11:56 PM 2/4/2002 +0100, Branko =?UTF-8?B?xIxpYmVq?= wrote:
>Bruce Atherton wrote:
>>But the Subversion documentation should let the user know how to build
>>Subversion in all its variations. If I want to build a Subversion server
>>that supports SSL...
>
>Heh heh heh. Neon is used by the client, not by the server. :-)

Arrgh. Chemo brain. Sorry about that.

>How to create an SSL-aware server, and how to automagically compress data
>sent over the wire, should be documented by Apache. Do you want to
>maintain a copy of the Apache docs?

Not a copy, but information relevant to Subversion. If mod_ssl is a
separate library, for example, with its own version numbers, then you
probably want to let the user know that they need to make sure it is
installed to get a working SSL Subversion server (and this time, I really
mean the server...I think...). Just enough so that they don't have to go
wading through the Apache docs trying to figure out which applies to their
situation.

>I didn't say you shouldn't mention those options at all; just that it's
>not necessary to go into details about which versions of what are
>supported. Simply saying that the neon config supports --with-ssl and
>--with-zlib, and to refer to the neon docs for details, should be quite
>enough, IMHO.

It wouldn't be my preference, but whatever. I still have to mention what
the specific libraries are so that I can explain what [=DIR] means. And if
doing that, it would probably still make sense to tell people where to get
the libraries from. I'd leave off pointing to the neon docs for version
info until they actually have some (other than in INSTALL.win32).

---------------------------------------------------------------------
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:37:04 2006

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

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.