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