[svnbook] r4327 committed - Finish issue 170 ("In Subversion 1.8, libsvn_ra_neon has been...
svnbook at googlecode.com
svnbook at googlecode.com
Wed Jan 16 14:26:04 CST 2013
Revision: 4327
Author: cmpilato at gmail.com
Date: Wed Jan 16 12:25:46 2013
Log: Finish issue 170 ("In Subversion 1.8, libsvn_ra_neon has been
removed."), save for a small bit regarding library dependencies that
I'll pick up in a subsequent revision.
* en/book/appc-webdav.xml,
* en/book/ch07-customizing-svn.xml
* en/book/ch08-embedding-svn.xml
Make neon go (mostly) away. *Poof!*
http://code.google.com/p/svnbook/source/detail?r=4327
Modified:
/trunk/en/book/appc-webdav.xml
/trunk/en/book/ch07-customizing-svn.xml
/trunk/en/book/ch08-embedding-svn.xml
=======================================
--- /trunk/en/book/appc-webdav.xml Tue Aug 30 07:04:43 2011
+++ /trunk/en/book/appc-webdav.xml Wed Jan 16 12:25:46 2013
@@ -410,12 +410,11 @@
<title>cadaver, DAV Explorer</title>
<para>cadaver is a bare-bones Unix command-line program for
- browsing and changing WebDAV shares. Like the Subversion
- client, it uses the neon HTTP library—not
- surprisingly, since both neon and cadaver are written by the
- same author. cadaver is free software (GPL license) and is
- available at
- <ulink url="http://www.webdav.org/cadaver/"/>.</para>
+ browsing and changing WebDAV shares. It uses the neon HTTP
+ library—not surprisingly, since both neon and cadaver
+ are written by the same author. cadaver is free software (GPL
+ license) and is available at <ulink
+ url="http://www.webdav.org/cadaver/"/>.</para>
<para>Using cadaver is similar to using a command-line FTP
program, and thus it's extremely useful for basic WebDAV
=======================================
--- /trunk/en/book/ch07-customizing-svn.xml Thu Nov 3 12:47:55 2011
+++ /trunk/en/book/ch07-customizing-svn.xml Wed Jan 16 12:25:46 2013
@@ -347,25 +347,23 @@
<varlistentry>
<term><literal>http-library</literal></term>
<listitem>
- <para>Subversion provides a pair of repository access
- modules that understand its WebDAV network protocol.
- The original one, which shipped with Subversion 1.0, is
- <literal>libsvn_ra_neon</literal> (though back then it
- was called <literal>libsvn_ra_dav</literal>). Newer
- Subversion versions also provide
- <literal>libsvn_ra_serf</literal>, which uses a
- different underlying implementation and aims to
- support some of the newer HTTP concepts.</para>
-
- <para>At this point, <literal>libsvn_ra_serf</literal>
- is still considered experimental, though it appears to
- work in the common cases quite well. To encourage
- experimentation, Subversion provides the
- <literal>http-library</literal> runtime configuration
- option to allow users to specify (generally, or in a
- per-server-group fashion) which WebDAV access module
- they'd prefer to use—<literal>neon</literal> or
- <literal>serf</literal>.</para>
+ <para>The <literal>http-library</literal> runtime
+ configuration option allows users to specify
+ (generally, or in a per-server-group fashion) which of
+ the available WebDAV access modules they'd prefer to
+ use. Prior to version 1.8, Subversion offered a pair
+ of such modules: its original implementiation
+ <literal>libsvn_ra_neon</literal> (selected by
+ using the value <literal>neon</literal> for this
+ option) and the newer <literal>libsvn_ra_serf</literal>
+ (selected using the value <literal>serf</literal>).
+ As of Subversion 1.8, only
<literal>libsvn_ra_serf</literal>
+ is supported. This configuration option remains,
+ though, because the runtime configuration area is
+ version-agnostic. Users with multiple versions of
+ Subversion installed may still wish to enable the use
+ of <literal>libsvn_ra_neon</literal> for sites which
+ they access with an older version of Subversion.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -427,12 +425,17 @@
<varlistentry>
<term><literal>neon-debug-mask</literal></term>
<listitem>
- <para>This is an integer mask that the underlying HTTP
- library, Neon, uses for choosing what type of
- debugging output to yield. The default value is
- <literal>0</literal>, which will silence all debugging
- output. For more information about how Subversion
- makes use of Neon, see <xref linkend="svn.developer"
/>.</para>
+ <para>This is an integer mask that the Neon HTTP library
+ uses for choosing what type of debugging output to
+ yield. The default value is <literal>0</literal>,
+ which will silence all debugging output. Prior to
+ version 1.8, most Subversion clients used Neon (via
+ the <literal>libsvn_ra_neon</literal> repository
+ access module) for WebDAV/HTTP communications between
+ the Subversion client and server. Support
+ for <literal>libsvn_ra_neon</literal> was dropped in
+ Subversion 1.8, though, making this option obsolete
+ for newer Subversion installations.</para>
</listitem>
</varlistentry>
<varlistentry>
=======================================
--- /trunk/en/book/ch08-embedding-svn.xml Fri Sep 9 12:15:11 2011
+++ /trunk/en/book/ch08-embedding-svn.xml Wed Jan 16 12:25:46 2013
@@ -82,11 +82,6 @@
module</para></listitem>
</varlistentry>
<varlistentry>
- <term>libsvn_ra_neon</term>
- <listitem><para>The WebDAV Repository Access
- module</para></listitem>
- </varlistentry>
- <varlistentry>
<term>libsvn_ra_serf</term>
<listitem><para>Another (experimental) WebDAV Repository
Access module</para></listitem>
@@ -137,14 +132,13 @@
API without affecting the rest of the code base. In some sense,
this happens within Subversion already. The
<filename>libsvn_ra_local</filename>,
- <filename>libsvn_ra_neon</filename>,
<filename>libsvn_ra_serf</filename>, and
<filename>libsvn_ra_svn</filename> libraries each implement the
same interface, all working as plug-ins to
- <filename>libsvn_ra</filename>. And all four communicate with
- the Repository layer—<filename>libsvn_ra_local</filename>
connects to the
- repository directly; the other three do so over a network. The
- <filename>libsvn_fs_base</filename> and
+ <filename>libsvn_ra</filename>. And all three communicate with
+ the Repository layer—<filename>libsvn_ra_local</filename>
+ connects to the repository directly; the others do so over a
+ network. The <filename>libsvn_fs_base</filename> and
<filename>libsvn_fs_fs</filename> libraries are another pair of
libraries that implement the same functionality in different
ways—both are plug-ins to the common
@@ -409,7 +403,6 @@
client libraries and the repository, this layer includes the
<filename>libsvn_ra</filename> module loader library, the RA
modules themselves (which currently includes
- <filename>libsvn_ra_neon</filename>,
<filename>libsvn_ra_local</filename>,
<filename>libsvn_ra_serf</filename>, and
<filename>libsvn_ra_svn</filename>), and any additional
@@ -434,19 +427,16 @@
<informalexample>
<screen>
$ svn --version
-svn, version 1.7.0
- compiled Nov 15 2011, 10:10:24
+svn, version 1.8.0-dev (under development)
+ compiled Jan 8 2013, 11:45:25 on i686-pc-linux-gnu
-Copyright (C) 2011 The Apache Software Foundation.
-This software consists of contributions made by many people; see the NOTICE
-file for more information.
+Copyright (C) 2013 The Apache Software Foundation.
+This software consists of contributions made by many people;
+see the NOTICE file for more information.
Subversion is open source software, see http://subversion.apache.org/
The following repository access (RA) modules are available:
-* ra_neon : Module for accessing a repository via WebDAV protocol using
Neon.
- - handles 'http' scheme
- - handles 'https' scheme
* ra_svn : Module for accessing a repository using the svn network
protocol.
- with Cyrus SASL authentication
- handles 'svn' scheme
@@ -464,8 +454,7 @@
functionality necessary for sending and receiving versioned
data to and from the repository. And each of the available RA
plug-ins is able to perform that task using a specific
- protocol—<filename>libsvn_ra_neon</filename>
- and <filename>libsvn_ra_serf</filename> speak HTTP/WebDAV
+ protocol—<filename>libsvn_ra_serf</filename> speaks
HTTP/WebDAV
(optionally using SSL encryption) with an Apache HTTP Server
that is running the <filename>mod_dav_svn</filename>
Subversion server module; <filename>libsvn_ra_svn</filename>
More information about the svnbook-dev
mailing list