1
1
<!--
2
- $Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.1 1998/12/18 16:08:19 thomas Exp $
2
+ $Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.2 1999/01/07 03:00:43 thomas Exp $
3
3
CVS code repository
4
4
Thomas Lockhart
5
5
6
6
$Log: cvs.sgml,v $
7
+ Revision 1.2 1999/01/07 03:00:43 thomas
8
+ Put in more markup. Not done yet though.
9
+
7
10
Revision 1.1 1998/12/18 16:08:19 thomas
8
11
Information on the CVS tree and remote access.
9
12
Not yet complete, integrated, or marked up.
@@ -27,6 +30,7 @@ Not yet included in a document (should go in the developer's doc?).
27
30
<para>
28
31
The <productname>Postgres</productname> source code is stored and managed using the
29
32
<productname>CVS</productname> code management system.
33
+ </para>
30
34
31
35
At least two options,
32
36
anonymous CVS and <productname>CVSup</productname>,
@@ -127,6 +131,7 @@ allow independent updates of either tree.
127
131
If you are <emphasis>only</emphasis> working on the <literal>CURRENT</literal>
128
132
source tree, you just do
129
133
everything as before we started tagging release branches.
134
+ </para>
130
135
131
136
<para>
132
137
After you've done the initial checkout on a branch
@@ -204,6 +209,7 @@ This initial checkout is a little slower than simply downloading
204
209
a <filename>tar.gz</filename> file; expect it to take 40 minutes or so if you
205
210
have a 28.8K modem. The advantage of <productname>CVS</productname> doesn't show up until you
206
211
want to update the file set later on.
212
+ </para>
207
213
</step>
208
214
209
215
<step>
@@ -217,6 +223,7 @@ cvs -z3 update -d -P
217
223
This will fetch only the changes since the last time you updated.
218
224
You can update in just a couple of minutes, typically, even over
219
225
a modem-speed line.
226
+ </para>
220
227
</step>
221
228
222
229
<step>
@@ -236,6 +243,7 @@ to say
236
243
cvs update
237
244
</programlisting>
238
245
to update your files.
246
+ </para>
239
247
</step>
240
248
</procedure>
241
249
@@ -250,26 +258,86 @@ chmod -R go-w pgsql
250
258
to set the permissions properly.
251
259
This bug is fixed as of <productname>CVS</productname> version 1.9.28.
252
260
</caution>
261
+ </para>
253
262
254
263
<para>
255
264
<productname>CVS</productname> can do a lot of other things, such as fetching prior revisions
256
265
of the <productname>Postgres</productname> sources rather than the latest development version.
257
266
For more info consult the manual that comes with <productname>CVS</productname>, or see the online
258
267
documentation at <ulink url="http://www.cyclic.com/">http://www.cyclic.com/</ulink>.
268
+ </para>
259
269
270
+ </sect1>
260
271
261
272
<sect1>
262
273
<title>Getting The Source Via <productname>CVSup</productname></title>
263
274
264
275
<para>
265
- An alternative to using anonymous CVS for retrieving the <productname>Postgres</productname> source tree
276
+ An alternative to using anonymous CVS for retrieving
277
+ the <productname>Postgres</productname> source tree
266
278
is <productname>CVSup</productname>. The major advantage to using
267
- <productname>CVSup</productname> is that it can replicate the <emphasis>entire</emphasis>
268
- CVS repository on your local system,
279
+ <productname>CVSup</productname> is that it can reliably
280
+ replicate the <emphasis>entire</emphasis> CVS repository on your local system,
269
281
allowing fast local access to cvs operations such as <option>log</option>
270
282
and <option>diff</option>. Other advantages include fast synchronization to
271
283
the <productname>Postgres</productname> server due to an efficient
272
284
streaming transfer protocol which only sends the changes since the last update.
285
+ </para>
286
+
287
+ <procedure>
288
+ <title>Installation from Binaries</title>
289
+
290
+ <para>
291
+ Instructions for installing <productname>CVSup</productname> from sources
292
+ are in a subsequent section. You can instead use pre-built binaries
293
+ if you have a platform for which binaries
294
+ are posted on
295
+ <ulink url="ftp://postgresql.org/pub">the <productname>Postgres</productname> ftp site</ulink>,
296
+ or if you are running FreeBSD, for which <productname>CVSup</productname> is available
297
+ as a port.
298
+ </para>
299
+
300
+ <step>
301
+ <para>
302
+ Retrieve the binary tar file appropriate for your platform.
303
+
304
+ <substeps>
305
+ <step performance="optional">
306
+ <para>
307
+ If you are running FreeBSD, install the <productname>CVSup</productname> port.
308
+ </para>
309
+ </step>
310
+
311
+ <step performance="optional">
312
+ <para>
313
+ If you have another platform, check for and download the appropriate binary from
314
+ <ulink url="ftp://postgresql.org/pub">the <productname>Postgres</productname> ftp site</ulink>,
315
+ </para>
316
+ </step>
317
+ </substeps>
318
+ </para>
319
+
320
+ <step>
321
+ <para>
322
+ </para>
323
+
324
+ </procedure>
325
+
326
+ <sect2>
327
+ <title>Installation from Binaries</title>
328
+
329
+ <para>
330
+ Instructions for installing <productname>CVSup</productname> from sources
331
+ are in a subsequent section. If you have a platform for which static binaries
332
+ are posted on
333
+ <ulink url="ftp://postgresql.org/pub">the <productname>Postgres</productname> ftp site</ulink>.
334
+ </para>
335
+
336
+ <sect2>
337
+ <title>Client Configuration</title>
338
+
339
+ <para>
340
+ </para>
273
341
274
342
<sect2>
275
343
<title>Background</title>
0 commit comments