Add documentation for pulling the CVS repository using rsync, and

mention cvsup last.

1 files changed, 31 insertions, 13 deletions

diff --git a/doc/src/sgml/cvs.sgml b/doc/src/sgml/cvs.sgml
index b512a85d84..6e1c8c0e4c 100644
--- a/doc/src/sgml/cvs.sgml
+++ b/doc/src/sgml/cvs.sgml
@@ -27,8 +27,8 @@
  </para>
 
  <para>
-  At least two methods,
-  anonymous CVS and <productname>CVSup</productname>,
+  At least three methods, anonymous CVS, <productname>rsync</productname>,
+  and <productname>CVSup</productname>,
   are available to pull the <productname>CVS</productname> code tree from the
   <productname>PostgreSQL</productname> server to your local machine.
  </para>
@@ -270,11 +270,39 @@ cvs commit
   </para>
  </sect1>
 
+ <sect1 id="rsync">
+  <title>Getting The Source Via <productname>rsync</productname></title>
+
+  <para>
+   An alternative to using anonymous CVS for retrieving the
+   <productname>PostgreSQL</productname> source tree is
+   <productname>rsync</productname>, an incremental file transfer tool.
+   A major advantage to using <productname>rsync</productname> is that it
+   can reliably replicate the <emphasis>entire</emphasis> CVS repository
+   on your local system, allowing fast local access to <command>cvs</>
+   operations such as <option>log</option> and <option>diff</option>.
+   Other advantages include fast synchronization to the
+   <productname>PostgreSQL</productname> server due to an efficient
+   streaming transfer protocol which only sends the changes since the last
+   update.
+  </para>
+
+  <para>
+   You can download the CVS repository using this command:
+<programlisting>
+rsync -avzCH --delete rsync.postgresql.org::pgsql-cvs cvsroot/
+</programlisting>
+   For full instructions, see the "rsync" section in the 
+   <ulink url="http://pgfoundry.org/docman/view.php/1000040/4/PGBuildFarm-HOWTO.txt">
+   pgbuildfarm instructions</ulink>.
+  </para>
+ </sect1>
+
  <sect1 id="cvsup">
   <title>Getting The Source Via <productname>CVSup</productname></title>
 
   <para>
-   An alternative to using anonymous CVS for retrieving
+   Another alternative to using anonymous CVS for retrieving
    the <productname>PostgreSQL</productname> source tree
    is <productname>CVSup</productname>.
    <productname>CVSup</productname> was developed by
@@ -283,16 +311,6 @@ cvs commit
    <ulink url="http://www.freebsd.org">FreeBSD project</ulink>.
   </para>
 
-  <para>
-   A major advantage to using
-   <productname>CVSup</productname> is that it can reliably
-   replicate the <emphasis>entire</emphasis> CVS repository on your local system,
-   allowing fast local access to <command>cvs</> operations such as <option>log</option>
-   and <option>diff</option>. Other advantages include fast synchronization to
-   the <productname>PostgreSQL</productname> server due to an efficient
-   streaming transfer protocol which only sends the changes since the last update.
-  </para>
-
   <sect2>
    <title>Preparing A <productname>CVSup</productname> Client System</title>