<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.1 1998/12/18 16:08:19 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.2 1999/01/07 03:00:43 thomas Exp $
CVS code repository
Thomas Lockhart
$Log: cvs.sgml,v $
+Revision 1.2 1999/01/07 03:00:43 thomas
+Put in more markup. Not done yet though.
+
Revision 1.1 1998/12/18 16:08:19 thomas
Information on the CVS tree and remote access.
Not yet complete, integrated, or marked up.
<para>
The <productname>Postgres</productname> source code is stored and managed using the
<productname>CVS</productname> code management system.
+</para>
At least two options,
anonymous CVS and <productname>CVSup</productname>,
If you are <emphasis>only</emphasis> working on the <literal>CURRENT</literal>
source tree, you just do
everything as before we started tagging release branches.
+</para>
<para>
After you've done the initial checkout on a branch
a <filename>tar.gz</filename> file; expect it to take 40 minutes or so if you
have a 28.8K modem. The advantage of <productname>CVS</productname> doesn't show up until you
want to update the file set later on.
+</para>
</step>
<step>
This will fetch only the changes since the last time you updated.
You can update in just a couple of minutes, typically, even over
a modem-speed line.
+</para>
</step>
<step>
cvs update
</programlisting>
to update your files.
+</para>
</step>
</procedure>
to set the permissions properly.
This bug is fixed as of <productname>CVS</productname> version 1.9.28.
</caution>
+</para>
<para>
<productname>CVS</productname> can do a lot of other things, such as fetching prior revisions
of the <productname>Postgres</productname> sources rather than the latest development version.
For more info consult the manual that comes with <productname>CVS</productname>, or see the online
documentation at <ulink url="http://www.cyclic.com/">http://www.cyclic.com/</ulink>.
+</para>
+</sect1>
<sect1>
<title>Getting The Source Via <productname>CVSup</productname></title>
<para>
-An alternative to using anonymous CVS for retrieving the <productname>Postgres</productname> source tree
+An alternative to using anonymous CVS for retrieving
+the <productname>Postgres</productname> source tree
is <productname>CVSup</productname>. The major advantage to using
-<productname>CVSup</productname> is that it can replicate the <emphasis>entire</emphasis>
-CVS repository on your local system,
+<productname>CVSup</productname> is that it can reliably
+replicate the <emphasis>entire</emphasis> CVS repository on your local system,
allowing fast local access to cvs operations such as <option>log</option>
and <option>diff</option>. Other advantages include fast synchronization to
the <productname>Postgres</productname> server due to an efficient
streaming transfer protocol which only sends the changes since the last update.
+</para>
+
+<procedure>
+<title>Installation from Binaries</title>
+
+<para>
+Instructions for installing <productname>CVSup</productname> from sources
+are in a subsequent section. You can instead use pre-built binaries
+if you have a platform for which binaries
+are posted on
+<ulink url="ftp://postgresql.org/pub">the <productname>Postgres</productname> ftp site</ulink>,
+or if you are running FreeBSD, for which <productname>CVSup</productname> is available
+as a port.
+</para>
+
+<step>
+<para>
+Retrieve the binary tar file appropriate for your platform.
+
+<substeps>
+<step performance="optional">
+<para>
+If you are running FreeBSD, install the <productname>CVSup</productname> port.
+</para>
+</step>
+
+<step performance="optional">
+<para>
+If you have another platform, check for and download the appropriate binary from
+<ulink url="ftp://postgresql.org/pub">the <productname>Postgres</productname> ftp site</ulink>,
+</para>
+</step>
+</substeps>
+</para>
+
+<step>
+<para>
+</para>
+
+</procedure>
+
+<sect2>
+<title>Installation from Binaries</title>
+
+<para>
+Instructions for installing <productname>CVSup</productname> from sources
+are in a subsequent section. If you have a platform for which static binaries
+are posted on
+<ulink url="ftp://postgresql.org/pub">the <productname>Postgres</productname> ftp site</ulink>.
+</para>
+
+<sect2>
+<title>Client Configuration</title>
+
+<para>
+</para>
<sect2>
<title>Background</title>