[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: Branko Čibej <brane_at_xbc.nu>
Date: 2002-02-04 23:56:43 CET

Bruce Atherton wrote:

> At 10:39 PM 2/4/2002 +0100, Branko =?UTF-8?B?xIxpYmVq?= wrote:
>> Now really, this belongs to the Neon documentation. You should just
>> point people to that. The last thing you want to do is update the
>> docs for building neon every time a new version is released.
> I take your point. If the versions required are specified by Neon, we
> then have to track the Neon changes in our own documentation.
> 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, I want to know about the --with-ssl option
> and what to pass into it. The same if I want a server that supports
> compression. The fact that these end up getting passed to the Neon
> build is completely incidental to me. To the person building the
> system, Neon is just a black box that Subversion uses to do its thing
> somehow.

Heh heh heh. Neon is used by the client, not by the server. :-)
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?

> What isn't incidental is the other libraries I have to have on my
> system so that my Subversion server will have the feature I asked for.
> Now, Neon probably defines what versions of these are required, making
> this a dependency of a dependency. But I still need that information
> if I want to build an SSL-capable Subversion server.
> So although there is some overhead in doing so, I think it makes sense
> to include that information in the INSTALL file.

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.

The Win32 case is a bit specific, because there's nothing remotely as
flexible as autoconf widely available to Windows developers.

Brane Čibej   <brane_at_xbc.nu>   http://www.xbc.nu/brane/
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.