head	1.2;
access;
symbols
	RELENG_8_4:1.1.1.15.0.18
	RELENG_9_1_0_RELEASE:1.1.1.15
	RELENG_9_1:1.1.1.15.0.16
	RELENG_9_1_BP:1.1.1.15
	RELENG_8_3_0_RELEASE:1.1.1.15
	RELENG_8_3:1.1.1.15.0.14
	RELENG_8_3_BP:1.1.1.15
	RELENG_9_0_0_RELEASE:1.1.1.15
	RELENG_9_0:1.1.1.15.0.12
	RELENG_9_0_BP:1.1.1.15
	RELENG_9:1.1.1.15.0.10
	RELENG_9_BP:1.1.1.15
	RELENG_7_4_0_RELEASE:1.1.1.13.18.1
	RELENG_8_2_0_RELEASE:1.1.1.15
	RELENG_7_4:1.1.1.13.18.1.0.8
	RELENG_7_4_BP:1.1.1.13.18.1
	RELENG_8_2:1.1.1.15.0.8
	RELENG_8_2_BP:1.1.1.15
	RELENG_8_1_0_RELEASE:1.1.1.15
	RELENG_8_1:1.1.1.15.0.6
	RELENG_8_1_BP:1.1.1.15
	RELENG_7_3_0_RELEASE:1.1.1.13.18.1
	RELENG_7_3:1.1.1.13.18.1.0.6
	RELENG_7_3_BP:1.1.1.13.18.1
	RELENG_8_0_0_RELEASE:1.1.1.15
	RELENG_8_0:1.1.1.15.0.4
	RELENG_8_0_BP:1.1.1.15
	RELENG_8:1.1.1.15.0.2
	RELENG_8_BP:1.1.1.15
	RELENG_7_2_0_RELEASE:1.1.1.13.18.1
	RELENG_7_2:1.1.1.13.18.1.0.4
	RELENG_7_2_BP:1.1.1.13.18.1
	RELENG_7_1_0_RELEASE:1.1.1.13.18.1
	RELENG_6_4_0_RELEASE:1.1.1.13
	RELENG_7_1:1.1.1.13.18.1.0.2
	RELENG_7_1_BP:1.1.1.13.18.1
	RELENG_6_4:1.1.1.13.0.24
	RELENG_6_4_BP:1.1.1.13
	v1_11_20080310:1.1.1.15
	RELENG_7_0_0_RELEASE:1.1.1.13
	RELENG_6_3_0_RELEASE:1.1.1.13
	v1_11_22:1.1.1.14
	PRE_1_11_22:1.1.1.13
	RELENG_7_0:1.1.1.13.0.22
	RELENG_7_0_BP:1.1.1.13
	RELENG_6_3:1.1.1.13.0.20
	RELENG_6_3_BP:1.1.1.13
	RELENG_7:1.1.1.13.0.18
	RELENG_7_BP:1.1.1.13
	RELENG_6_2_0_RELEASE:1.1.1.13
	RELENG_6_2:1.1.1.13.0.16
	RELENG_6_2_BP:1.1.1.13
	RELENG_5_5_0_RELEASE:1.1.1.13
	RELENG_5_5:1.1.1.13.0.14
	RELENG_5_5_BP:1.1.1.13
	RELENG_6_1_0_RELEASE:1.1.1.13
	RELENG_6_1:1.1.1.13.0.12
	RELENG_6_1_BP:1.1.1.13
	RELENG_6_0_0_RELEASE:1.1.1.13
	RELENG_6_0:1.1.1.13.0.10
	RELENG_6_0_BP:1.1.1.13
	RELENG_6:1.1.1.13.0.8
	RELENG_6_BP:1.1.1.13
	RELENG_5_4_0_RELEASE:1.1.1.13
	RELENG_5_4:1.1.1.13.0.6
	RELENG_5_4_BP:1.1.1.13
	RELENG_4_11_0_RELEASE:1.1.1.6.2.6
	RELENG_4_11:1.1.1.6.2.6.0.2
	RELENG_4_11_BP:1.1.1.6.2.6
	RELENG_5_3_0_RELEASE:1.1.1.13
	RELENG_5_3:1.1.1.13.0.4
	RELENG_5_3_BP:1.1.1.13
	RELENG_5:1.1.1.13.0.2
	RELENG_5_BP:1.1.1.13
	v1_11_17:1.1.1.13
	RELENG_4_10_0_RELEASE:1.1.1.6.2.5
	RELENG_4_10:1.1.1.6.2.5.0.6
	RELENG_4_10_BP:1.1.1.6.2.5
	v1_11_15:1.1.1.12
	RELENG_5_2_1_RELEASE:1.1.1.11
	RELENG_5_2_0_RELEASE:1.1.1.11
	RELENG_5_2:1.1.1.11.0.4
	RELENG_5_2_BP:1.1.1.11
	RELENG_4_9_0_RELEASE:1.1.1.6.2.5
	RELENG_4_9:1.1.1.6.2.5.0.4
	RELENG_4_9_BP:1.1.1.6.2.5
	RELENG_5_1_0_RELEASE:1.1.1.11
	RELENG_5_1:1.1.1.11.0.2
	RELENG_5_1_BP:1.1.1.11
	RELENG_4_8_0_RELEASE:1.1.1.6.2.5
	RELENG_4_8:1.1.1.6.2.5.0.2
	RELENG_4_8_BP:1.1.1.6.2.5
	v1_11_5:1.1.1.11
	RELENG_5_0_0_RELEASE:1.1.1.10
	RELENG_5_0:1.1.1.10.0.2
	RELENG_5_0_BP:1.1.1.10
	v1_11_2_1_20021201:1.1.1.10
	RELENG_4_7_0_RELEASE:1.1.1.6.2.2
	RELENG_4_7:1.1.1.6.2.2.0.6
	RELENG_4_7_BP:1.1.1.6.2.2
	v1_11_2:1.1.1.9
	RELENG_4_6_2_RELEASE:1.1.1.6.2.2
	RELENG_4_6_1_RELEASE:1.1.1.6.2.2
	RELENG_4_6_0_RELEASE:1.1.1.6.2.2
	RELENG_4_6:1.1.1.6.2.2.0.4
	RELENG_4_6_BP:1.1.1.6.2.2
	RELENG_4_5_0_RELEASE:1.1.1.6.2.2
	RELENG_4_5:1.1.1.6.2.2.0.2
	RELENG_4_5_BP:1.1.1.6.2.2
	RELENG_4_4_0_RELEASE:1.1.1.6.2.1
	RELENG_4_4:1.1.1.6.2.1.0.4
	RELENG_4_4_BP:1.1.1.6.2.1
	v1_11_1p1:1.1.1.8
	CVSHOME:1.1.1
	RELENG_4_3_0_RELEASE:1.1.1.6.2.1
	RELENG_4_3:1.1.1.6.2.1.0.2
	RELENG_4_3_BP:1.1.1.6.2.1
	RELENG_4_2_0_RELEASE:1.1.1.6.2.1
	v1_11:1.1.1.7
	RELENG_4_1_1_RELEASE:1.1.1.6
	PRE_SMPNG:1.1.1.6
	RELENG_4_1_0_RELEASE:1.1.1.6
	RELENG_3_5_0_RELEASE:1.1.1.4.2.2
	RELENG_4_0_0_RELEASE:1.1.1.6
	RELENG_4:1.1.1.6.0.2
	RELENG_4_BP:1.1.1.6
	RELENG_3_4_0_RELEASE:1.1.1.4.2.2
	v1_10_7:1.1.1.6
	RELENG_3_3_0_RELEASE:1.1.1.4.2.1
	RELENG_3_2_PAO:1.1.1.4.2.1.0.2
	RELENG_3_2_PAO_BP:1.1.1.4.2.1
	RELENG_3_2_0_RELEASE:1.1.1.4.2.1
	v1_10:1.1.1.5
	RELENG_3_1_0_RELEASE:1.1.1.4
	RELENG_3:1.1.1.4.0.2
	RELENG_3_BP:1.1.1.4
	RELENG_2_2_8_RELEASE:1.1.1.1.2.2
	RELENG_3_0_0_RELEASE:1.1.1.4
	RELENG_2_2_7_RELEASE:1.1.1.1.2.2
	RELENG_2_2_6_RELEASE:1.1.1.1.2.1
	v1_9_26:1.1.1.4
	v1_9_24:1.1.1.3
	v1_9_23_19980123:1.1.1.3
	RELENG_2_2_5_RELEASE:1.1.1.1.2.1
	v1_9_10:1.1.1.2
	v1_9_9_970523:1.1.1.2
	RELENG_2_2_2_RELEASE:1.1.1.1
	v1_9_9_970515:1.1.1.2
	RELENG_2_2_1_RELEASE:1.1.1.1
	RELENG_2_2_0_RELEASE:1.1.1.1
	RELENG_2_2:1.1.1.1.0.2
	RELENG_2_2_BP:1.1.1.1
	v1_8_1:1.1.1.1
	CYCLIC:1.1.1;
locks; strict;
comment	@# @;


1.2
date	2013.06.16.00.38.19;	author svnexp;	state dead;
branches;
next	1.1;

1.1
date	96.08.20.23.45.57;	author peter;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	96.08.20.23.45.57;	author peter;	state Exp;
branches
	1.1.1.1.2.1;
next	1.1.1.2;

1.1.1.2
date	97.05.15.22.45.02;	author peter;	state Exp;
branches;
next	1.1.1.3;

1.1.1.3
date	98.01.26.03.07.48;	author peter;	state Exp;
branches;
next	1.1.1.4;

1.1.1.4
date	98.03.10.13.38.17;	author peter;	state Exp;
branches
	1.1.1.4.2.1;
next	1.1.1.5;

1.1.1.5
date	99.03.18.09.21.21;	author peter;	state Exp;
branches;
next	1.1.1.6;

1.1.1.6
date	99.12.11.12.22.28;	author peter;	state Exp;
branches
	1.1.1.6.2.1;
next	1.1.1.7;

1.1.1.7
date	2000.10.02.06.30.41;	author peter;	state Exp;
branches;
next	1.1.1.8;

1.1.1.8
date	2001.08.10.09.43.19;	author peter;	state Exp;
branches;
next	1.1.1.9;

1.1.1.9
date	2002.09.02.05.49.33;	author peter;	state Exp;
branches;
next	1.1.1.10;

1.1.1.10
date	2002.12.02.03.13.37;	author peter;	state Exp;
branches;
next	1.1.1.11;

1.1.1.11
date	2003.01.21.21.53.02;	author peter;	state Exp;
branches;
next	1.1.1.12;

1.1.1.12
date	2004.04.15.01.01.55;	author peter;	state Exp;
branches;
next	1.1.1.13;

1.1.1.13
date	2004.06.10.19.05.36;	author peter;	state Exp;
branches
	1.1.1.13.18.1;
next	1.1.1.14;

1.1.1.14
date	2008.01.13.05.49.23;	author obrien;	state Exp;
branches;
next	1.1.1.15;

1.1.1.15
date	2008.03.19.14.46.51;	author obrien;	state Exp;
branches
	1.1.1.15.18.1;
next	;

1.1.1.1.2.1
date	97.06.28.03.21.22;	author peter;	state Exp;
branches;
next	1.1.1.1.2.2;

1.1.1.1.2.2
date	98.04.05.03.27.18;	author peter;	state Exp;
branches;
next	;

1.1.1.4.2.1
date	99.05.10.14.59.57;	author peter;	state Exp;
branches;
next	1.1.1.4.2.2;

1.1.1.4.2.2
date	99.12.13.20.56.22;	author peter;	state Exp;
branches;
next	;

1.1.1.6.2.1
date	2000.10.31.09.37.43;	author obrien;	state Exp;
branches;
next	1.1.1.6.2.2;

1.1.1.6.2.2
date	2001.10.28.21.31.58;	author peter;	state Exp;
branches;
next	1.1.1.6.2.3;

1.1.1.6.2.3
date	2002.10.15.20.24.31;	author peter;	state Exp;
branches;
next	1.1.1.6.2.4;

1.1.1.6.2.4
date	2002.12.19.21.17.51;	author peter;	state Exp;
branches;
next	1.1.1.6.2.5;

1.1.1.6.2.5
date	2003.01.21.22.26.42;	author peter;	state Exp;
branches;
next	1.1.1.6.2.6;

1.1.1.6.2.6
date	2004.06.29.16.10.44;	author des;	state Exp;
branches;
next	;

1.1.1.13.18.1
date	2008.07.28.16.52.28;	author obrien;	state Exp;
branches;
next	;

1.1.1.15.18.1
date	2008.03.19.14.46.51;	author svnexp;	state dead;
branches;
next	1.1.1.15.18.2;

1.1.1.15.18.2
date	2013.03.28.13.00.40;	author svnexp;	state Exp;
branches;
next	;


desc
@@


1.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/251794
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@#ident	"$CVSid$"

First, read the README file.  If you're still happy...

CVS has been tested on the following platforms.  The most recent
version of CVS reported to have been tested is indicated, but more
recent versions of CVS probably will work too.  Please send updates to
this list to bug-cvs@@prep.ai.mit.edu (doing so in the form of a diff
to this file is encouraged).

Alpha:
	DEC Alpha running OSF/1 version 1.3 using cc (about 1.4A2)
	DEC Alpha running OSF/1 version 2.0 (1.4.90)
	DEC Alpha running OSF/1 version 2.1 (about 1.4A2)
	DEC Alpha running OSF/1 version 3.0 (1.5.95) (footnote 7)
	DEC Alpha running OSF/1 version 3.2 (1.7+obvious patch)
HPPA:
	HP 9000/710 running HP-UX 8.07A using gcc (about 1.4A2)
	HP 9000/715 running HP-UX 9.01 (1.6)
	HPPA running HP-UX 10.01 (1.7)
        HPPA 1.1 running HP-UX A.09.03 (1.5.95) (footnote 8)
        HPPA 1.1 running HP-UX A.09.04 (1.7.1)
	NextSTEP 3.3 (1.6.86)
i386 family:
	Solaris 2.4 using gcc (about 1.4A2)
	UnixWare v1.1.1 using gcc (about 1.4A2)
	ISC 4.0.1 (1.5.94)
	Linux (kernel 1.2.x) (1.7.1)
	BSDI 2.0 (1.4.93) (footnote 5)
	FreeBSD 2.0.5, i486, gcc (1.5.95)
	NextSTEP 3.3 (1.6.86)
	NeXTSTEP 3.3 (1.7), (footnote 10)
	SCO Unix 3.2.4.2 (1.4.93) (footnote 4)
	SCO OpenServer 5.0.0, "CC='cc -b elf' configure"
	Lynx 2.3.0 080695 (1.6.86) (footnote 9)
	Windows NT 3.51 (1.7.87 client-only)
	QNX 4 (1.7 + obvious patches)
	OS/2 Version 3 using IBM C/C++ Tools 2.01 (1.7.86 with patches)
m68k:
	Sun 3 running SunOS 4.1.1_U1 w/ bundled K&R /usr/5bin/cc (1.6)
	NextSTEP 3.3 (1.6.86)
	NeXTSTEP 3.3 (1.7), (footnote 10)
	Lynx 2.3.0 062695 (1.6.86) (footnote 9)
m88k:
	Data General AViiON running dgux 5.4R2.10 (1.5)
	Data General AViiON running dgux 5.4R3.10 (1.7.1)
	Harris Nighthawk 5800 running CX/UX 7.1 (1.5) (footnote 6)
MIPS:
	DECstation running Ultrix 4.2a (1.4.90)
	DECstation running Ultrix 4.3 (1.6.86)
	SGI running Irix 4.0.5H using gcc and cc (about 1.4A2) (footnote 2)
	SGI running Irix 5.3 (1.7)
	SGI running Irix-6 (about 1.4.90) (footnote 3)
	Siemens-Nixdorf RM600 running SINIX-Y (1.6)
PowerPC or RS/6000:
	IBM RS/6000 running AIX 3.1 using gcc and cc (1.6.86)
	IBM RS/6000 running AIX 3.2.5 (1.7.87)
	IBM RS/6000 running AIX 4.1 using gcc and cc (about 1.4A2) (footnote 1)
	Lynx 2.3.1 120495 (1.6.86) (footnote 9)
SPARC:
	Sun SPARC running SunOS 4.1.x (1.6.86)
	Sun SPARCstation 10 running Solaris 2.3 using gcc and cc (about 1.4A2)
	Sun SPARCstation running Solaris 2.4 using gcc and cc (about 1.5.91)
	Sun SPARC running Solaris 2.5 (2.5 beta?) (1.6.4)
	NextSTEP 3.3 (1.6.86)
	NeXTSTEP 3.3 (1.7), (footnote 10)

(footnote 1)
	AIX 4.1 systems fail to run "configure" due to bugs in their
	"/bin/sh" implementation.  You might want to try feeding the
	configure script to "bash" ported to AIX 4.1.  (about 1.4A2).

(footnote 2)
	Some Irix 4.0 systems may core dump in malloc while running
	CVS.  We believe this is a bug in the Irix malloc.  You can
	workaround this bug by linking with "-lmalloc" if necessary.
	(about 1.4A2).

(footnote 3)
        There are some warnings about pointer casts which can safely be
        ignored.  (about 1.4.90).

(footnote 4) Comment out the include of sys/time.h in src/server.c. (1.4.93)
	You also may have to make sure TIME_WITH_SYS_TIME is undef'ed.

(footnote 5) Change /usr/tmp to /var/tmp in src/server.c (2 places) (1.4.93).

(footnote 6) Build in ucb universe with COFF compiler tools.  Put
	/usr/local/bin first in PATH while doing a configure, make
	and install of GNU diffutils-2.7, rcs-5.7, then cvs-1.5.

(footnote 7) Manoj Srivastava <srivasta@@pilgrim.umass.edu> reports
        success with this configure command:
  CC=cc CFLAGS='-O2 -Olimit 2000 -std1' ./configure --verbose alpha-dec-osf

(footnote 8) Manoj Srivastava <srivasta@@pilgrim.umass.edu> reports
        success with this configure command:
  CC=cc CFLAGS='+O2 -Aa -D_HPUX_SOURCE' ./configure --verbose hppa1.1-hp-hpux

(footnote 9) 
    Had to configure with ./configure --host=<arch>-lynx.

    In src/cvs.h, protected the waitpid prototype with ifdef _POSIX_SOURCE.
    (I might try building with gcc -mposix -D_POSIX_SOURCE.)

    LynxOS has <dirent.h>, but you don't want to use it.
    You want to use <sys/dir.h> instead.
    So after running configure I had to undef HAVE_DIRENT_H and
    define HAVE_SYS_DIR_H.

(footnote 10) Ralf E. Stranzenbach <ralf@@reswi.ruhr.de>
    I've made some modifications to "filesubr.c" to deal with NFS
    mounted directories (and those funny .nfs* files). This patch
    should be used whenever the programmers "sandbox" is located on
    a NFS mounted device --- at least on NeXTSTEP.

-------------------------------------------------------------------------------

Installation under Unix:

1)  Run "configure":

	$ ./configure

    You can specify an alternate destination to override the default with
    the --prefix option:

	$ ./configure --prefix=/usr/local/gnu

    or some path that is more appropriate for your site.  The default prefix
    value is "/usr/local", with binaries in sub-directory "bin", manual
    pages in sub-directory "man", and libraries in sub-directory "lib".

    If you are using server or local CVS, RCS needs to be installed in
    the user's PATH (or a path you have configured in src/options.h,
    or a path specified with the -b option).  If you don't have RCS,
    you will need to get it from GNU as well.  It is best to get the
    version 5.7 (or later) version of RCS, available from
    prep.ai.mit.edu in the file pub/gnu/rcs-5.7.tar.gz.

    If you want version control of files with binary data, make sure
    that the RCS configure script finds GNU diff 1.15 or later and
    notices that diff supports the -a option.  CVS itself is much less
    picky about which version of diff it uses, and you shouldn't need
    to worry about that.

    NOTE: The configure program will cache the results of the previous
    configure execution.  If you need to re-run configure from scratch, you
    may need to run "make distclean" first to remove the cached
    configuration information.

    If you are using gcc and are planning to modify CVS, you may want to
    configure with -Wall; see the file HACKING for details.

    Try './configure --help' for further information on its usage.

    NOTE ON CVS's USE OF NDBM:

	By default, CVS uses some built-in ndbm emulation code to allow
	CVS to work in a heterogeneous environment.  However, if you have
	a very large modules database, this may not work well.  You will
	need to edit src/options.h to turn off the MY_NDBM #define and
	re-run configure.  If you do this, the following comments apply.
	If not, you may safely skip these comments.

	If you configure CVS to use the real ndbm(3) libraries and
	you do not have them installed in a "normal" place, you will
	probably want to get the GNU version of ndbm (gdbm) and install
	that before running the CVS configure script.  Be aware that the
	GDBM 1.5 release does NOT install the <ndbm.h> header file included
	with the release automatically.  You may have to install it by hand.

	If you configure CVS to use the ndbm(3) libraries, you cannot
	compile CVS with GNU cc (gcc) on Sun-4 SPARC systems.  However, gcc
	2.0 may have fixed this limitation if -fpcc-struct-return is
	defined.  When using gcc on other systems to compile CVS, you *may*
	need to specify the -fpcc-struct-return option to gcc (you will
	*know* you have to if "cvs checkout" core dumps in some ndbm
	function).  You can do this as follows:

	    $ CC='gcc -fpcc-struct-return' ./configure

	for sh, bash, and ksh users and:

	    % setenv CC 'gcc -fpcc-struct-return'
	    % ./configure

	for csh and tcsh users.

    END OF NOTE FOR NDBM GUNK.

2)  Edit src/options.h.  Appropriate things to look at may be the
    invocation locations of programs like DIFF and GREP.
    Also glance at the default values for the environment variables
    that CVS uses, in particular, the RCSBIN variable, which holds the
    path to where the RCS programs live on your system.

3)  Try to build it:

	$ make

    This will (hopefully) make the needed CVS binaries within the
    "src" directory.  If something fails for your system, and you want
    to submit a bug report, you may wish to include your
    "config.status" file, your host type, operating system and
    compiler information, make output, and anything else you think
    will be helpful.

3a)  Run the regression tests (optional).

    You may also wish to validate the correctness of the new binary by
    running the regression tests:

	$ make check

    Note that if your /bin/sh doesn't support shell functions, you'll
    have to try something like this, where "/bin/sh5" is replaced by the
    pathname of a shell which handles normal shell functions:

	$ make SHELL=/bin/sh5 check

    WARNING:  This test can take quite a while to run, esp. if your
    disks are slow or over-loaded.

    If you receive any un-expected output from the regression tests,
    it may indicate a bug in CVS (or might just indicate a problem
    running the tests).  If you choose to submit a bug report,
    be aware that, as with all bug reports, you may or may not get a
    response, and your odds might be better if you include enough information
    to reproduce the bug, an analysis of what is going wrong (if you have
    the time and ability to provide one), etc.  The check.log file is the
    first place to look.

4)  Install the binaries/documentation:

	$ make install

    Depending on your installation's configuration, you may need to be
    root to do this.

5)  Take a look at the CVS documentation.

	$ man cvs

    and

	$ info cvs  

    See what it can do for you, and if it fits your environment (or can
    possibly be made to fit your environment).  If things look good,
    continue on...

6)  Set up the master source repository.  See the "Setting up the repository"
    section of cvs.texinfo for details; the one-line summary is (if you
    are putting the repository in /src/master):
    $ cvs -d /src/master init

7)  Have all users of the CVS system set the CVSROOT environment
    variable appropriately to reflect the placement of your source
    repository.  If the above example is used, the following commands
    can be placed in user's ~/.profile, ~/.bash_profile file; or in the
    site-wide /etc/profile:

	CVSROOT=/src/master; export CVSROOT

    for sh/bash/ksh users, or place the following commands in the user's
    ~/.cshrc, ~/.login, or /etc/chsrc file:

	setenv CVSROOT /src/master

    for csh/tcsh users.  If these environment variables are not already set
    in your current shell, set them now (or source the login script you
    just edited).  You will need to have the CVSROOT environment variable
    set to continue on to the next step.

8)  It might be a good idea to jump right in and put the CVS distribution
    directly under CVS control.  From within the top-level directory of the
    CVS distribution (the one that contains this README file) do the
    following commands:

	$ make distclean
	$ cvs import -m 'CVS 1.6 distribution' cvs CVS_DIST CVS-1_6

9)  Having done step 8, one should be able to checkout a fresh copy of the
    CVS distribution and hack away at the sources with the following command:

	$ cd
	$ cvs checkout cvs

    This will make the directory "cvs" in your current directory and
    populate it with the appropriate CVS files and directories.

10) You may wish to customize the various administrative files, in particular
    modules.  See cvs.texinfo for details.

11) Read the NEWS file to see what's new.

12) Hack away.

-------------------------------------------------------------------------------

Detailed information about your interaction with "configure":

The "configure" script and its interaction with its options and the
environment is described here.  For more detailed documentation about
"configure", please refer to the GNU Autoconf documentation.

Supported options are:

	--srcdir=DIR		Useful for compiling on many different
				machines sharing one source tree.
	--prefix=DIR		The root of where to install the
				various pieces of CVS (/usr/local).
	--exec_prefix=DIR	If you want executables in a
				host-dependent place and shared
				things in a host-independent place.

The following environment variables override configure's default
behaviour:

	CC			If not set, tries to use gcc first,
				then cc.  Also tries to use "-g -O"
				as options, backing down to -g
				alone if that doesn't work.
	INSTALL			If not set, tries to use "install", then
				"./install-sh" as a final choice.
	RANLIB			If not set, tries to determine if "ranlib"
				is available, choosing "echo" if it doesn't
				appear to be.
	YACC			If not set, tries to determine if "bison"
				is available, choosing "yacc" if it doesn't
				appear to be.

-------------------------------------------------------------------------------
Installation under Windows NT:

You may find interesting information in windows-NT/README.

1) Using Microsoft Visual C++ version 2.1, open the project `cvsnt.mak',
   in the top directory of the CVS distribution.
2) Choose "Build cvs.exe" from the "Project" menu.
3) MSVC will place the executable file cvs.exe in WinDebug, or whatever
   your target directory is.
-------------------------------------------------------------------------------
@


1.1
log
@Initial revision
@
text
@@


1.1.1.1
log
@Import of slightly trimmed cvs-1.8 distribution.  Generated files
and non-unix code has been left out.
@
text
@@


1.1.1.1.2.1
log
@Update 2.2 to cvs-1.9.10 from -current (fixes a security problem with
pserver mode)
@
text
@d1 2
d9 1
a9 4
to this file is encouraged).  "tested" means, at a minimum, that CVS
compiles and appears to work on simple (manual) testing.  In many
cases it also means "make check" and/or "make remotecheck" passes, but
we don't try to list the platforms for which that is true.
d13 1
a13 1
	DEC Alpha running OSF/1 version 2.0 (1.8)
d16 1
a16 5
	DEC Alpha running OSF/1 version 3.2 (1.9)
	DEC Alpha running VMS 6.2 (1.8.85 client-only)
Cray:
	J90 (CVS 970215 snapshot)
	T3E (CVS 970215 snapshot)
d19 1
a19 1
	HPPA running HP-UX 9 (1.8)
d23 1
a23 2
	HPPA 9000/735 running HP-UX A.09.05 (1.8.87)
	NextSTEP 3.3 (1.7)
d27 2
a28 3
	Unixware 2.1 (1.8.86)
	ISC 4.0.1 (1.8.87)
	Linux (kernel 1.2.x) (1.8.86)
d30 5
a34 4
	FreeBSD 2.1.5-stable (1.8.87)
	NextSTEP 3.3 (1.7)
	SCO Unix 3.2.4.2, gcc 2.7.2 (1.8.87) (footnote 4)
	SCO OpenServer 5 (1.8.86)
d36 1
a36 3
	Windows NT 3.51 (1.8.86 client; 1.8.3 local)
	Windows NT 4.0 (1.9 client and local)
	Windows 95 (1.8.86 client and local)
d38 1
a38 1
	OS/2 Version 3 using IBM C/C++ Tools 2.01 (1.8.86 + patches, client)
d40 3
a42 2
	Sun 3 running SunOS 4.1.1_U1 w/ bundled K&R /usr/5bin/cc (1.8.86+)
	NextSTEP 3.3p1 (1.8.87)
d50 1
a50 1
	DECstation running Ultrix 4.3 (1.8.85)
d52 2
a53 2
	SGI running Irix 5.3 using gcc 2.7.2 (1.8.87)
	SGI running Irix-6.2 (1.9.8)
d57 1
a57 1
	IBM RS/6000 running AIX 3.2.5 (1.8)
d61 1
a61 1
	Sun SPARC running SunOS 4.1.x (1.8.87)
d64 3
a66 6
	Sun SPARC running Solaris 2.5 (1.8.87)
	NextSTEP 3.3 (1.7)
	Sun SparcClassing running Linux 2.0.17, gcc 2.7.2 (1.8.87)
VAX:
	VAX running VMS 6.2 (1.9+patches, client-only)
	  (see README.VMS for information on necessary hacks).
d79 4
a86 3
	(This should no longer be needed; CVS doesn't have /usr/tmp in
	src/server.c any more.  Has anyone tried a more recent version
	on BSDI?  If so, please report it so we can update this file).
d111 6
d119 1
a119 3
Installation under Unix (if you got a binary distribution from
somewhere, install it according to procedure for that binary
distribution, then skip to step 5):
a133 12
    A normal build of CVS will create an executable which supports
    local, server, or client CVS (if you don't know the difference,
    it is described in the Repository chapter of doc/cvs.texinfo).  If
    you do not intend to use client or server CVS, you may want to
    prevent these features from being included in the executable you
    build. You can do this with the --disable-client and
    --disable-server options:

	$ ./configure --disable-client --disable-server

    Typically this can reduce the size of the executable by around 30%.

d139 1
a139 5
    prep.ai.mit.edu in the file pub/gnu/rcs-5.7.tar.gz.  If you do not
    have RCS version 5.x (for example, if you are using the old RCS
    shipped with some versions of HPUX), CVS will probably fail to work
    entirely.  To find out what version of RCS you have, invoke "co -V".
    If it fails to print a version number, it is an old version.
d145 1
a145 2
    to worry about that.  If you are using GNU diff 2.6 or 2.7, you may
    want to know about a (subtle) bug described in doc/DIFFUTILS-2.7-BUG.
a154 10
    If you have Kerberos 4 installed, you can specify the location of
    the header files and libraries using the --with-krb4=DIR option.
    DIR should be a directory with subdirectories include and lib
    holding the Kerberos 4 header files and libraries, respectively.
    The default value is /usr/kerberos.

    If you want to enable support for encryption over Kerberos, use
    the --enable-encryption option.  This option is disabled by
    default.

d193 1
a193 1
    invocation locations of programs like DIFF.
d212 3
a214 6
    running the regression tests.  If they succeed, that is nice to
    know.  However, if they fail, it doesn't tell you much.  Often it
    will just be a problem with running the tests on your machine,
    rather than a problem with CVS.  Unless you will have the time to
    determine which of the two it is in case of failure, you might
    want to save yourself the time and just not run the tests.
d216 17
a232 1
    If you want to run the tests, see the file TESTS for more information.
@


1.1.1.1.2.2
log
@Merge cvs from HEAD.
@
text
@a2 92
First you need to obtain and install the CVS executables.  If you got
a distribution which contains executables, consult the installation
instructions for that distribution.  If you got source code, do not
panic.  On many platforms building CVS from source code is a
straightforward process requiring no programming knowledge.  See the
section BUILDING FROM SOURCE CODE at the end of this file, which
includes a list of platforms which have been tested.

-------------------------------------------------------------------------------

1) Take a look at the CVS documentation, if desired.  For most
   purposes you want doc/cvs.texinfo, also known as _Version Management
   with CVS_ by Per Cederqvist et al.  Looking at it might be as simple
   as "info cvs" but this will depend on your installation; see README
   for more details.

   See what CVS can do for you, and if it fits your environment (or can
   possibly be made to fit your environment).  If things look good,
   continue on.  Alternately, just give CVS a try first then figure out
   what it is good for.

2) Set the CVSROOT environment variable to where you want to put your
   source repository.  See the "Setting up the repository" section of
   the Cederqvist manual for details, but the quick summary is just to
   pick some directory.  We'll use /src/master as an example.  For
   users of a POSIX shell (sh/bash/ksh) on unix, the following
   commands can be placed in user's ~/.profile, ~/.bash_profile file;
   or in the site-wide /etc/profile:

       CVSROOT=/src/master; export CVSROOT

   For C shell users on unix place the following commands in the
   user's ~/.cshrc, ~/.login, or /etc/chsrc file:

       setenv CVSROOT /src/master

   For Windows users, supposing the repository will be in
   d:\src\master, place the following line in c:\autoexec.bat.  On
   Windows 95, autoexec.bat might not already exist.  In that case,
   just create a new file containing the following line.

       set CVSROOT=:local:d:\src\master

   If these environment variables are not already set in your current
   shell, set them now by typing the above line at the command prompt
   (or source the login script you just edited).
   The instructions for the remaining steps assume that you have set
   the CVSROOT environment variable.

3) Create the master source repository.  Again, the details are in
   the "Setting up the repository" section of cvs.texinfo; the
   one-line summary is:

       $ cvs init

   In this and subsequent examples we use "$" to indicate the command
   prompt; do not type the "$".

4) It might be a good idea to jump right in and put some sources or
   documents directly under CVS control.  From within the top-level
   directory of your source tree, run the following commands:

       $ cvs import -m "test distribution" ccvs CVS_DIST CVS-TEST

   (Those last three items are, respectively, a repository location, a
   "vendor tag", and a "release tag".  You don't need to understand
   them yet, but read the section "Starting new projects" in the
   Cederqvist manual for details).

5) Having done step 4, one should be able to checkout a fresh copy of the
   sources you just imported and hack away at the sources with the
   following command:

      $ cd
      $ cvs checkout ccvs

   This will make the directory "ccvs" in your current directory and
   populate it with the appropriate files and directories.

6) You may wish to customize the various administrative files, in particular
   modules.  See the Cederqvist manual for details.

7) Read the NEWS file to see what's new.

8) Hack away.

-------------------------------------------------------------------------------

BUILDING FROM SOURCE CODE

Tested platforms

d6 5
a10 6
this list to bug-cvs@@gnu.org (doing so in the form of a diff
to this file, or at least exact suggested text, is encouraged).
"tested" means, at a minimum, that CVS compiles and appears to work on
simple (manual) testing.  In many cases it also means "make check"
and/or "make remotecheck" passes, but we don't try to list the
platforms for which that is true.
a17 1
	DEC Alpha running Digital UNIX v4.0C using gcc 2.7.2.2 (1.9.14)
d25 1
a28 2
	HPPA running HP-UX 10.01 (1.7)
	HPPA running HP-UX 10.20 using gcc 2.7.2.2 (1.9.14)
a35 1
	Linux (kernel 2.0.x, RedHat 4.2) (1.9)
a40 1
	Sequent Dynix/PTX 4.1.4 (1.9.20 or so + patches)
a42 2
	Windows NT 3.51 service pack 4 (1.9)
	Windows NT 3.51 service pack 5 (1.9) -- DOES NOT WORK (footnote 11)
d44 2
a45 2
	Windows 95 (1.9 client and local)
	QNX (1.9.1 + patches for strippath() and va_list)
a46 2
	OS/2 Version 3 using EMX 0.9c (1.9.22, client)
	OS/2 Version 3 using Watcom version ? (? - has this been tested?)
a59 1
	SGI running Irix 6.2 using SGI MIPSpro 6.2 and beta 7.2 compilers (1.9)
a66 1
	Lynx 2.5 (1.9) (footnote 10)
d68 1
a68 1
	Sun SPARC running SunOS 4.1.x using gcc 2.7.2.1 (1.9.14)
a71 1
	Sun SPARC running Solaris 2.5.1 using gcc 2.7.2.2 (1.9.14)
d73 1
a73 1
	Sun SPARC running Linux 2.0.17, gcc 2.7.2 (1.8.87)
a119 10
(footnote 10)
    Had to compile with "make LIBS=-lbsd" (to get gethostbyname
    and getservbyname).

(footnote 11)
    when I do a `cvs init' I get this message:
      ci: 'RCS/loginfo,v' is not a regular file
      ci:  RCS/loginfo,v: Invalid argument
      cvs [init aborted]: failed to checkin n:/safe/CVSROOT/loginfo

d122 3
a124 1
Building from source code under Unix:
d151 17
a167 2
    Unlike previous versions of CVS, you do not need to install RCS
    or GNU diff.  
d224 5
a228 2
2)  Edit src/options.h.  The defaults should be reasonable, and in fact
    if you are lazy you can safely skip this step.
d260 59
d354 1
a354 2

Building from source code under Windows NT/95:
d358 2
a359 3
1) Using Microsoft Visual C++ 5.x, open the project `cvsnt.dsp',
   in the top directory of the CVS distribution.  If you have an older
   version of Visual C++, take a look at windows-NT/README.
d361 1
a361 1
3) MSVC will place the executable file cvs.exe in WinRel, or whatever
a362 15

-------------------------------------------------------------------------------

Building from source code under other platforms:

For OS/2, see os2/README and emx/README.

For VMS, see README.VMS

For Macintosh, see macintosh/README.MacCVS

For a Java client, see jCVS (which is a separate package from CVS
itself, but which might be preferable to the Macintosh port mentioned
above, for example).

@


1.1.1.2
log
@Import of cvs-1.9.9-970515 onto vendor branch.

Obtained from: cyclic.com
@
text
@d1 2
d9 1
a9 4
to this file is encouraged).  "tested" means, at a minimum, that CVS
compiles and appears to work on simple (manual) testing.  In many
cases it also means "make check" and/or "make remotecheck" passes, but
we don't try to list the platforms for which that is true.
d13 1
a13 1
	DEC Alpha running OSF/1 version 2.0 (1.8)
d16 1
a16 5
	DEC Alpha running OSF/1 version 3.2 (1.9)
	DEC Alpha running VMS 6.2 (1.8.85 client-only)
Cray:
	J90 (CVS 970215 snapshot)
	T3E (CVS 970215 snapshot)
d19 1
a19 1
	HPPA running HP-UX 9 (1.8)
d23 1
a23 2
	HPPA 9000/735 running HP-UX A.09.05 (1.8.87)
	NextSTEP 3.3 (1.7)
d27 2
a28 3
	Unixware 2.1 (1.8.86)
	ISC 4.0.1 (1.8.87)
	Linux (kernel 1.2.x) (1.8.86)
d30 5
a34 4
	FreeBSD 2.1.5-stable (1.8.87)
	NextSTEP 3.3 (1.7)
	SCO Unix 3.2.4.2, gcc 2.7.2 (1.8.87) (footnote 4)
	SCO OpenServer 5 (1.8.86)
d36 1
a36 3
	Windows NT 3.51 (1.8.86 client; 1.8.3 local)
	Windows NT 4.0 (1.9 client and local)
	Windows 95 (1.8.86 client and local)
d38 1
a38 1
	OS/2 Version 3 using IBM C/C++ Tools 2.01 (1.8.86 + patches, client)
d40 3
a42 2
	Sun 3 running SunOS 4.1.1_U1 w/ bundled K&R /usr/5bin/cc (1.8.86+)
	NextSTEP 3.3p1 (1.8.87)
d50 1
a50 1
	DECstation running Ultrix 4.3 (1.8.85)
d52 2
a53 2
	SGI running Irix 5.3 using gcc 2.7.2 (1.8.87)
	SGI running Irix-6.2 (1.9.8)
d57 1
a57 1
	IBM RS/6000 running AIX 3.2.5 (1.8)
d61 1
a61 1
	Sun SPARC running SunOS 4.1.x (1.8.87)
d64 3
a66 6
	Sun SPARC running Solaris 2.5 (1.8.87)
	NextSTEP 3.3 (1.7)
	Sun SparcClassing running Linux 2.0.17, gcc 2.7.2 (1.8.87)
VAX:
	VAX running VMS 6.2 (1.9+patches, client-only)
	  (see README.VMS for information on necessary hacks).
d79 4
a86 3
	(This should no longer be needed; CVS doesn't have /usr/tmp in
	src/server.c any more.  Has anyone tried a more recent version
	on BSDI?  If so, please report it so we can update this file).
d111 6
d119 1
a119 3
Installation under Unix (if you got a binary distribution from
somewhere, install it according to procedure for that binary
distribution, then skip to step 5):
a133 12
    A normal build of CVS will create an executable which supports
    local, server, or client CVS (if you don't know the difference,
    it is described in the Repository chapter of doc/cvs.texinfo).  If
    you do not intend to use client or server CVS, you may want to
    prevent these features from being included in the executable you
    build. You can do this with the --disable-client and
    --disable-server options:

	$ ./configure --disable-client --disable-server

    Typically this can reduce the size of the executable by around 30%.

d139 1
a139 5
    prep.ai.mit.edu in the file pub/gnu/rcs-5.7.tar.gz.  If you do not
    have RCS version 5.x (for example, if you are using the old RCS
    shipped with some versions of HPUX), CVS will probably fail to work
    entirely.  To find out what version of RCS you have, invoke "co -V".
    If it fails to print a version number, it is an old version.
d145 1
a145 2
    to worry about that.  If you are using GNU diff 2.6 or 2.7, you may
    want to know about a (subtle) bug described in doc/DIFFUTILS-2.7-BUG.
a154 10
    If you have Kerberos 4 installed, you can specify the location of
    the header files and libraries using the --with-krb4=DIR option.
    DIR should be a directory with subdirectories include and lib
    holding the Kerberos 4 header files and libraries, respectively.
    The default value is /usr/kerberos.

    If you want to enable support for encryption over Kerberos, use
    the --enable-encryption option.  This option is disabled by
    default.

d193 1
a193 1
    invocation locations of programs like DIFF.
d212 3
a214 6
    running the regression tests.  If they succeed, that is nice to
    know.  However, if they fail, it doesn't tell you much.  Often it
    will just be a problem with running the tests on your machine,
    rather than a problem with CVS.  Unless you will have the time to
    determine which of the two it is in case of failure, you might
    want to save yourself the time and just not run the tests.
d216 17
a232 1
    If you want to run the tests, see the file TESTS for more information.
@


1.1.1.3
log
@Import cvs-1.9.23 as at 19980123.  There are a number of really nice
things fixed in here, including the '-ko' vs. -A problem with
remote cvs which caused all files with -ko to be resent each time
(which is damn painful over a modem, I can tell you).  It also found a
heap of stray empty directories that should have been pruned with the -P
flag to cvs update but were not for some reason.

It also has the fully integrated rcs and diff, so no more fork/exec
overheads for rcs,ci,patch,diff,etc.  This means that it parses the control
data in the rcs files only once rather than twice or more.

If the 'cvs diff' vs. Index thing is going to be fixed for future patch
compatability, this is the place to do it.
@
text
@a2 92
First you need to obtain and install the CVS executables.  If you got
a distribution which contains executables, consult the installation
instructions for that distribution.  If you got source code, do not
panic.  On many platforms building CVS from source code is a
straightforward process requiring no programming knowledge.  See the
section BUILDING FROM SOURCE CODE at the end of this file, which
includes a list of platforms which have been tested.

-------------------------------------------------------------------------------

1) Take a look at the CVS documentation, if desired.  For most
   purposes you want doc/cvs.texinfo, also known as _Version Management
   with CVS_ by Per Cederqvist et al.  Looking at it might be as simple
   as "info cvs" but this will depend on your installation; see README
   for more details.

   See what CVS can do for you, and if it fits your environment (or can
   possibly be made to fit your environment).  If things look good,
   continue on.  Alternately, just give CVS a try first then figure out
   what it is good for.

2) Set the CVSROOT environment variable to where you want to put your
   source repository.  See the "Setting up the repository" section of
   the Cederqvist manual for details, but the quick summary is just to
   pick some directory.  We'll use /src/master as an example.  For
   users of a POSIX shell (sh/bash/ksh) on unix, the following
   commands can be placed in user's ~/.profile, ~/.bash_profile file;
   or in the site-wide /etc/profile:

       CVSROOT=/src/master; export CVSROOT

   For C shell users on unix place the following commands in the
   user's ~/.cshrc, ~/.login, or /etc/chsrc file:

       setenv CVSROOT /src/master

   For Windows users, supposing the repository will be in
   d:\src\master, place the following line in c:\autoexec.bat.  On
   Windows 95, autoexec.bat might not already exist.  In that case,
   just create a new file containing the following line.

       set CVSROOT=:local:d:\src\master

   If these environment variables are not already set in your current
   shell, set them now by typing the above line at the command prompt
   (or source the login script you just edited).
   The instructions for the remaining steps assume that you have set
   the CVSROOT environment variable.

3) Create the master source repository.  Again, the details are in
   the "Setting up the repository" section of cvs.texinfo; the
   one-line summary is:

       $ cvs init

   In this and subsequent examples we use "$" to indicate the command
   prompt; do not type the "$".

4) It might be a good idea to jump right in and put some sources or
   documents directly under CVS control.  From within the top-level
   directory of your source tree, run the following commands:

       $ cvs import -m "test distribution" ccvs CVS_DIST CVS-TEST

   (Those last three items are, respectively, a repository location, a
   "vendor tag", and a "release tag".  You don't need to understand
   them yet, but read the section "Starting new projects" in the
   Cederqvist manual for details).

5) Having done step 4, one should be able to checkout a fresh copy of the
   sources you just imported and hack away at the sources with the
   following command:

      $ cd
      $ cvs checkout ccvs

   This will make the directory "ccvs" in your current directory and
   populate it with the appropriate files and directories.

6) You may wish to customize the various administrative files, in particular
   modules.  See the Cederqvist manual for details.

7) Read the NEWS file to see what's new.

8) Hack away.

-------------------------------------------------------------------------------

BUILDING FROM SOURCE CODE

Tested platforms

d6 5
a10 6
this list to bug-cvs@@gnu.org (doing so in the form of a diff
to this file, or at least exact suggested text, is encouraged).
"tested" means, at a minimum, that CVS compiles and appears to work on
simple (manual) testing.  In many cases it also means "make check"
and/or "make remotecheck" passes, but we don't try to list the
platforms for which that is true.
a17 1
	DEC Alpha running Digital UNIX v4.0C using gcc 2.7.2.2 (1.9.14)
d25 1
a28 2
	HPPA running HP-UX 10.01 (1.7)
	HPPA running HP-UX 10.20 using gcc 2.7.2.2 (1.9.14)
a35 1
	Linux (kernel 2.0.x, RedHat 4.2) (1.9)
a40 1
	Sequent Dynix/PTX 4.1.4 (1.9.20 or so + patches)
a42 2
	Windows NT 3.51 service pack 4 (1.9)
	Windows NT 3.51 service pack 5 (1.9) -- DOES NOT WORK (footnote 11)
d44 2
a45 2
	Windows 95 (1.9 client and local)
	QNX (1.9.1 + patches for strippath() and va_list)
a46 2
	OS/2 Version 3 using EMX 0.9c (1.9.10 + patches, client)
	OS/2 Version 3 using Watcom version ? (? - has this been tested?)
a59 1
	SGI running Irix 6.2 using SGI MIPSpro 6.2 and beta 7.2 compilers (1.9)
a66 1
	Lynx 2.5 (1.9) (footnote 10)
d68 1
a68 1
	Sun SPARC running SunOS 4.1.x using gcc 2.7.2.1 (1.9.14)
a71 1
	Sun SPARC running Solaris 2.5.1 using gcc 2.7.2.2 (1.9.14)
d73 1
a73 1
	Sun SPARC running Linux 2.0.17, gcc 2.7.2 (1.8.87)
a119 10
(footnote 10)
    Had to compile with "make LIBS=-lbsd" (to get gethostbyname
    and getservbyname).

(footnote 11)
    when I do a `cvs init' I get this message:
      ci: 'RCS/loginfo,v' is not a regular file
      ci:  RCS/loginfo,v: Invalid argument
      cvs [init aborted]: failed to checkin n:/safe/CVSROOT/loginfo

d122 3
a124 1
Building from source code under Unix:
d151 17
a167 2
    Unlike previous versions of CVS, you do not need to install RCS
    or GNU diff.  
d224 5
a228 2
2)  Edit src/options.h.  The defaults should be reasonable, and in fact
    if you are lazy you can safely skip this step.
d260 59
d354 1
a354 2

Building from source code under Windows NT/95:
d358 2
a359 3
1) Using Microsoft Visual C++ 5.x, open the project `cvsnt.dsp',
   in the top directory of the CVS distribution.  If you have an older
   version of Visual C++, take a look at windows-NT/README.
d361 1
a361 1
3) MSVC will place the executable file cvs.exe in WinRel, or whatever
a362 15

-------------------------------------------------------------------------------

Building from source code under other platforms:

For OS/2, see os2/README and emx/README.

For VMS, see README.VMS

For Macintosh, see macintosh/README.MacCVS

For a Java client, see jCVS (which is a separate package from CVS
itself, but which might be preferable to the Macintosh port mentioned
above, for example).

@


1.1.1.4
log
@Import cvs-1.9.26 onto vendor branch
@
text
@d146 1
a146 1
	OS/2 Version 3 using EMX 0.9c (1.9.22, client)
@


1.1.1.4.2.1
log
@MFC: cvs-1.10 + FreeBSD mods preserved.
@
text
@d121 1
a121 1
	HPPA running HP-UX 9.05 (1.9)
d123 1
a123 1
	HPPA running HP-UX 10.20 (1.9, 1.9.14)
a128 1
	Unixware 7 (1.9.29)
d136 1
a136 1
	SCO OpenServer 5 (1.9.29)
d167 1
a167 1
	IBM RS/6000 running AIX 4.1 (1.9)
d181 5
@


1.1.1.4.2.2
log
@MFC: cvs 1.10.7, as we run on freefall.

Approved by:	jkh
@
text
@a110 1
	Alpha running alpha-dec-osf4.0 (1.10)
a112 1
	Alpha running NetBSD 1.2E (1.10)
a126 1
	Solaris 2.6 (1.9)
d132 1
a132 2
	Linux (kernel 2.0.x, RedHat 4.2) (1.10)
	Linux (kernel 2.0.x, RedHat 5.x) (1.10)
d137 1
a137 2
	SCO OpenServer 5.0.5 (1.10.2)
	Sequent DYNIX/ptx4.0 (1.10 or so) (remove -linet)
a152 1
	NetBSD/mac68k (1.9.28)
d159 1
a159 1
	DECstation running Ultrix 4.3 (1.10)
d161 1
a161 1
	SGI running Irix 5.3 (1.10)
a163 1
	SGI running IRIX 6.4 (1.10)
a170 1
	MkLinux DR3 GENERIC #6 (1.10.5.1) (presumably LinuxPPC too)
d172 1
a172 1
	Sun SPARC running SunOS 4.1.x (1.10)
a176 1
	Sun UltraSPARC running Solaris 2.6 using gcc 2.8.1 (1.10)
@


1.1.1.5
log
@Import cvs-1.10 onto vendor branch.  Merge to follow shortly.

Obtained from:	cyclic.com
@
text
@d121 1
a121 1
	HPPA running HP-UX 9.05 (1.9)
d123 1
a123 1
	HPPA running HP-UX 10.20 (1.9, 1.9.14)
a128 1
	Unixware 7 (1.9.29)
d136 1
a136 1
	SCO OpenServer 5 (1.9.29)
d167 1
a167 1
	IBM RS/6000 running AIX 4.1 (1.9)
d181 5
@


1.1.1.6
log
@Import cvs-1.10.7.  There are a number of nasty bugs that have been fixed.

Obtained from:  cyclic.com
@
text
@a110 1
	Alpha running alpha-dec-osf4.0 (1.10)
a112 1
	Alpha running NetBSD 1.2E (1.10)
a126 1
	Solaris 2.6 (1.9)
d132 1
a132 2
	Linux (kernel 2.0.x, RedHat 4.2) (1.10)
	Linux (kernel 2.0.x, RedHat 5.x) (1.10)
d137 1
a137 2
	SCO OpenServer 5.0.5 (1.10.2)
	Sequent DYNIX/ptx4.0 (1.10 or so) (remove -linet)
a152 1
	NetBSD/mac68k (1.9.28)
d159 1
a159 1
	DECstation running Ultrix 4.3 (1.10)
d161 1
a161 1
	SGI running Irix 5.3 (1.10)
a163 1
	SGI running IRIX 6.4 (1.10)
a170 1
	MkLinux DR3 GENERIC #6 (1.10.5.1) (presumably LinuxPPC too)
d172 1
a172 1
	Sun SPARC running SunOS 4.1.x (1.10)
a176 1
	Sun UltraSPARC running Solaris 2.6 using gcc 2.8.1 (1.10)
@


1.1.1.6.2.1
log
@MFC: update to `cvs' version 1.11.

Approved by:	peter
@
text
@d125 1
a125 1
	HPPA running HP-UX 10.20 (1.10.7)
d137 1
a137 1
	BSDI 4.0 (1.10.7)
a170 1
	SGI running IRIX 6.5 (1.10.7)
a175 1
	IBM RS/6000 running AIX 4.3 (1.10.7)
a184 1
	Sun SPARC running Solaris 2.6 (1.10.7)
d200 5
@


1.1.1.6.2.2
log
@MFC: cvs-1.11.1-p1
@
text
@a136 2
	Linux (kernel 2.2.x, RedHat 6.x) (1.10.8)
	Linux (kernel 2.2.x, RedHat 7.x) (1.11)
a148 1
	Windows NT 4.0 (1.11 client and local - build & test, but no test suite)
a286 8
    If you want to disable automatic dependency tracking in the makefiles,
    use the '--disable-dependency-tracking' option:

	$ ./configure --disable-dependency-tracking

    This avoids problems on some platforms.  See the note at the end of this
    file on BSD.

d393 1
a393 1
Building from source code under Windows NT/95/98/2000:
a403 8
* From the top level directory, with MSVC++ 6.0 installed, something like the
following also works:

	C:\> vcvars32
	C:\> nmake /f cvsnt.mak CFG="cvsnt - Win32 Debug"

* You might also try http://wincvs.org & http://www.cvsnt.org

d412 1
a412 2
For Macintosh, see macintosh/README.MacCVS, or, since that file isn't there
anymore, you might try http://wincvs.org .
a416 14

                                  **** ****

Builds are breaking on some systems (notably,
BSD/OS thor.sdrc.com 4.0.1 BSDI BSD/OS 4.0.1 Kernel #3: Thu Mar  9 11:29:16 EST 2000
) due to Automake's dependency tracking code.  The work around for this is to
comile without it by passing the '--disable-dependency-tracking' option to
configure:

	$ ./configure --disable-dependency-tracking

This will allow a compile but make will no longer be tracking header
dependencies.  This means that if you make any changes to header files you may
have to run 'make clean' before running a 'make' to get everything to compile.
@


1.1.1.6.2.3
log
@MFC: cvs-1.11.2, plus client.c rev 1.7 (missing client upload)
@
text
@d244 1
a244 13
1)  Some combinations of Automake and Autoconf versions may break the CVS build
    if file timestamps aren't set correctly, so you may wish to run
    noautomake.sh to set the timestamps and avoid attempting to run the
    autotools on your system, especially if you are building from source
    checked out from CVS:

	$ ./noautomake.sh --noautoconf

    The CVS Makefiles and configure script were built using Automake 1.5 and
    Autoconf 2.13, respectively.  Other combinations of autotool versions may
    or may not work.

2)  Run "configure":
d335 1
a335 1
3)  Edit src/options.h.  The defaults should be reasonable, and in fact
d338 1
a338 1
4)  Try to build it:
d349 1
a349 1
4a)  Run the regression tests (optional).
d361 1
a361 1
5)  Install the binaries/documentation:
d374 1
a374 2
"configure", please run `./configure --help' or refer to the GNU Autoconf
documentation.
@


1.1.1.6.2.4
log
@MFC: 1.11.2.1-20021201  (this has been running on key cluster machines
for a while, including the repository server)
@
text
@d252 2
a253 2
    The CVS Makefiles and configure script were built using Automake 1.6.3 and
    Autoconf 2.53, respectively.  Other combinations of autotool versions may
a280 28
    If you are building CVS with the server enabled, you can disable
    server flow control using the --disable-server-flow-control
    If you are working with a large remote repository and a 'cvs
    checkout' is swamping your network and memory, enable flow control.
    You will end up with even less probability of a consistent checkout
    (see Concurrency in cvs.texinfo), but CVS doesn't try to guarantee
    that anyway.  The master server process will monitor how far it is
    getting behind, if it reaches the high water mark, it will signal
    the child process to stop generating data when convenient (ie: no
    locks are held, currently at the beginning of a new directory).
    Once the buffer has drained sufficiently to reach the low water
    mark, it will be signalled to start again.  You may override the
    default hi/low watermarks here too by passing
    '<lowwater>,<highwater>', in bytes, as an argument to
    --enable-server-flow-control.  The low water mark defaults to one
    megabyte and the high water mark defaults to two megabytes.

	$ ./configure --enable-server-flow-control=1M,2M

    The --with-tmpdir argument to configure may be used to set a
    specific directory for use as a default temporary directory.  If not
    set, configure will pick the first directory it finds which it has
    read, write, and execute permissions to from $TMPDIR, $TMP, $TEMP,
    /tmp, and /var/tmp, in that order.  Failing that, it will use /tmp.

    The --with-umask argument to configure can be used to change
    the default umask used by the CVS server executable.

d284 5
d434 1
a434 1
* You might also try http://cvsgui.org & http://www.cvsnt.org
d444 2
a445 3
Mac OS X: Builds fine, just like UNIX.

For older versions of Mac OS, you might try http://cvsgui.org .
@


1.1.1.6.2.5
log
@Insta-MFC: cvs-1.11.5
@
text
@a193 1
	Sun UltraSPARC running Solaris 2.8 using gcc 2.95.3
d340 3
a342 3
	need to supply the --disable-cvs-ndbm option to configure to
	accomplish this.  If you do this, the following comments apply.  If
	not, you may safely skip these comments.
@


1.1.1.6.2.6
log
@MFC: upgrade to 1.11.17.

Approved by:	peter
@
text
@a125 2
	HPPA running HP-UX 11.11 (1.11.13) (footnote 12)
	HPPA 2.0 running HP-UX 10.20 (1.10.9) (footnote 13)
a183 3
	Mac OS X Darwin 6.6 Darwin Kernel Version 6.6 (1.11.1p1)
	Mac OS X Darwin 5.5 Darwin Kernel Version 5.5 (1.11.6) (footnote 12)
	Mac OS X Darwin 5.5 Darwin Kernel Version 5.5 (1.12.1) (footnote 12)
a240 10
(footnote 12)
    Need to `configure --without-gssapi' unless you have installed Kerberos 5
    libraries on the system yourself.  For some reason Apple ships OS X with
    the Kerberos 5 headers installed and not the libraries, which confuses the
    current configure script.  Some HP, BSD, & Sun boxes have similar problems.

(footnote 13)
    A build under HP PA-RISC 2.0 will probably not run under PA-RISC 1.1
    unless "+DAportable" is added to the HP ANSI cc compiler flags.

d245 13
a257 1
1)  Run "configure":
d371 4
a374 1
2)  Try to build it:
d385 1
a385 1
3)  Run the regression tests (optional).
d397 1
a397 1
4)  Install the binaries/documentation:
d445 1
a445 5
* Using Microsoft Visual C++ 5.x (this is currently broken - someone with
  MVC++ 5.x needs to regenerate the project files, but the builds using `nmake'
  below will work).

1) Using Microsoft Visual C++ 5.x, open the project `cvsnt.dsw',
d458 1
a458 6
* Using the Cygwin development environment <http://cygwin.com>, Windows clients
  and servers can be built using the instructions for building on UNIX.  For
  deploying the CVS server on Windows NT, see the `cygrunsrv' executable that
  comes with Cygwin.

* You might also try <http://wincvs.org> & <http://www.cvsnt.org>.
d470 1
a470 1
For older versions of Mac OS, you might try <http://wincvs.org>.
d475 14
@


1.1.1.7
log
@Import cvs-1.11 onto vendor branch.
@
text
@d125 1
a125 1
	HPPA running HP-UX 10.20 (1.10.7)
d137 1
a137 1
	BSDI 4.0 (1.10.7)
a170 1
	SGI running IRIX 6.5 (1.10.7)
a175 1
	IBM RS/6000 running AIX 4.3 (1.10.7)
a184 1
	Sun SPARC running Solaris 2.6 (1.10.7)
d200 5
@


1.1.1.8
log
@Import cvs-1.11.1p1 onto vendor branch
@
text
@a136 2
	Linux (kernel 2.2.x, RedHat 6.x) (1.10.8)
	Linux (kernel 2.2.x, RedHat 7.x) (1.11)
a148 1
	Windows NT 4.0 (1.11 client and local - build & test, but no test suite)
a286 8
    If you want to disable automatic dependency tracking in the makefiles,
    use the '--disable-dependency-tracking' option:

	$ ./configure --disable-dependency-tracking

    This avoids problems on some platforms.  See the note at the end of this
    file on BSD.

d393 1
a393 1
Building from source code under Windows NT/95/98/2000:
a403 8
* From the top level directory, with MSVC++ 6.0 installed, something like the
following also works:

	C:\> vcvars32
	C:\> nmake /f cvsnt.mak CFG="cvsnt - Win32 Debug"

* You might also try http://wincvs.org & http://www.cvsnt.org

d412 1
a412 2
For Macintosh, see macintosh/README.MacCVS, or, since that file isn't there
anymore, you might try http://wincvs.org .
a416 14

                                  **** ****

Builds are breaking on some systems (notably,
BSD/OS thor.sdrc.com 4.0.1 BSDI BSD/OS 4.0.1 Kernel #3: Thu Mar  9 11:29:16 EST 2000
) due to Automake's dependency tracking code.  The work around for this is to
comile without it by passing the '--disable-dependency-tracking' option to
configure:

	$ ./configure --disable-dependency-tracking

This will allow a compile but make will no longer be tracking header
dependencies.  This means that if you make any changes to header files you may
have to run 'make clean' before running a 'make' to get everything to compile.
@


1.1.1.9
log
@Import cvs-1.11.2 onto vendor branch

Obtained from: http://www.cvshome.org/
@
text
@d244 1
a244 13
1)  Some combinations of Automake and Autoconf versions may break the CVS build
    if file timestamps aren't set correctly, so you may wish to run
    noautomake.sh to set the timestamps and avoid attempting to run the
    autotools on your system, especially if you are building from source
    checked out from CVS:

	$ ./noautomake.sh --noautoconf

    The CVS Makefiles and configure script were built using Automake 1.5 and
    Autoconf 2.13, respectively.  Other combinations of autotool versions may
    or may not work.

2)  Run "configure":
d335 1
a335 1
3)  Edit src/options.h.  The defaults should be reasonable, and in fact
d338 1
a338 1
4)  Try to build it:
d349 1
a349 1
4a)  Run the regression tests (optional).
d361 1
a361 1
5)  Install the binaries/documentation:
d374 1
a374 2
"configure", please run `./configure --help' or refer to the GNU Autoconf
documentation.
@


1.1.1.10
log
@Import cvs-1.11.2.1 as of 2002/12/01 onto vendor branch.  This fixes all
of the bugs that I know of.  We've been running a slightly older version
of this on freefall/repoman, where it was afflicted by a silly merge error
on my part (fixed).

Approved by:  re
@
text
@d252 2
a253 2
    The CVS Makefiles and configure script were built using Automake 1.6.3 and
    Autoconf 2.53, respectively.  Other combinations of autotool versions may
a280 28
    If you are building CVS with the server enabled, you can disable
    server flow control using the --disable-server-flow-control
    If you are working with a large remote repository and a 'cvs
    checkout' is swamping your network and memory, enable flow control.
    You will end up with even less probability of a consistent checkout
    (see Concurrency in cvs.texinfo), but CVS doesn't try to guarantee
    that anyway.  The master server process will monitor how far it is
    getting behind, if it reaches the high water mark, it will signal
    the child process to stop generating data when convenient (ie: no
    locks are held, currently at the beginning of a new directory).
    Once the buffer has drained sufficiently to reach the low water
    mark, it will be signalled to start again.  You may override the
    default hi/low watermarks here too by passing
    '<lowwater>,<highwater>', in bytes, as an argument to
    --enable-server-flow-control.  The low water mark defaults to one
    megabyte and the high water mark defaults to two megabytes.

	$ ./configure --enable-server-flow-control=1M,2M

    The --with-tmpdir argument to configure may be used to set a
    specific directory for use as a default temporary directory.  If not
    set, configure will pick the first directory it finds which it has
    read, write, and execute permissions to from $TMPDIR, $TMP, $TEMP,
    /tmp, and /var/tmp, in that order.  Failing that, it will use /tmp.

    The --with-umask argument to configure can be used to change
    the default umask used by the CVS server executable.

d284 5
d434 1
a434 1
* You might also try http://cvsgui.org & http://www.cvsnt.org
d444 2
a445 3
Mac OS X: Builds fine, just like UNIX.

For older versions of Mac OS, you might try http://cvsgui.org .
@


1.1.1.11
log
@Import cvs-1.11.5 onto vendor branch
@
text
@a193 1
	Sun UltraSPARC running Solaris 2.8 using gcc 2.95.3
d340 3
a342 3
	need to supply the --disable-cvs-ndbm option to configure to
	accomplish this.  If you do this, the following comments apply.  If
	not, you may safely skip these comments.
@


1.1.1.12
log
@Import cvs-1.11.15
@
text
@a125 2
	HPPA running HP-UX 11.11 (1.11.13) (footnote 12)
	HPPA 2.0 running HP-UX 10.20 (1.10.9) (footnote 13)
a183 3
	Mac OS X Darwin 6.6 Darwin Kernel Version 6.6 (1.11.1p1)
	Mac OS X Darwin 5.5 Darwin Kernel Version 5.5 (1.11.6) (footnote 12)
	Mac OS X Darwin 5.5 Darwin Kernel Version 5.5 (1.12.1) (footnote 12)
a240 10
(footnote 12)
    Need to `configure --without-gssapi' unless you have installed Kerberos 5
    libraries on the system yourself.  For some reason Apple ships OS X with
    the Kerberos 5 headers installed and not the libraries, which confuses the
    current configure script.  Some HP, BSD, & Sun boxes have similar problems.

(footnote 13)
    A build under HP PA-RISC 2.0 will probably not run under PA-RISC 1.1
    unless "+DAportable" is added to the HP ANSI cc compiler flags.

d245 11
a255 13
1)  Some combinations of Automake and Autoconf versions may break the
    CVS build if file timestamps aren't set correctly and people don't
    have the same versions the developers do, so the rules to run them
    automatically aren't included in the generated Makefiles unless you run
    configure with --enable-maintainer-mode.

    The CVS Makefiles and configure script were built using Automake 1.7.9 and
    Autoconf 2.58, respectively.

    There is a known bug in Autoconf 2.57 that will prevent the configure
    scripts it generates from working on some platforms.  Other combinations of
    autotool versions may or may not work.  If you get other versions to work,
    please send a report to <bug-cvs@@gnu.org>.
d371 4
a374 1
3)  Try to build it:
d385 1
a385 1
3a)  Run the regression tests (optional).
d397 1
a397 1
4)  Install the binaries/documentation:
d445 1
a445 5
* Using Microsoft Visual C++ 5.x (this is currently broken - someone with
  MVC++ 5.x needs to regenerate the project files, but the builds using `nmake'
  below will work).

1) Using Microsoft Visual C++ 5.x, open the project `cvsnt.dsw',
d458 1
a458 6
* Using the Cygwin development environment <http://cygwin.com>, Windows clients
  and servers can be built using the instructions for building on UNIX.  For
  deploying the CVS server on Windows NT, see the `cygrunsrv' executable that
  comes with Cygwin.

* You might also try <http://wincvs.org> & <http://www.cvsnt.org>.
d470 1
a470 1
For older versions of Mac OS, you might try <http://wincvs.org>.
d475 14
@


1.1.1.13
log
@Import cvs-1.11.17 onto vendor branch.
@
text
@d260 15
a274 1
1)  Run "configure":
d388 1
a388 1
2)  Try to build it:
d399 1
a399 1
3)  Run the regression tests (optional).
@


1.1.1.13.18.1
log
@SVN rev 180918 on 2008-07-28 16:52:28Z by obrien

MFC: CVS version 1.11.22.1 (almost 1.11.23).
@
text
@d1 1
a1 21
-------------------------------------------------------------------------------

CVS is Copyright (C) 1986-2006 The Free Software Foundation, Inc.

CVS is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 1, or (at your option)
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

-------------------------------------------------------------------------------

Now back to our regularly scheduled program:

Please read the README file before reading this INSTALL file.  Then, to
install CVS:

d98 1
a98 1
this list to bug-cvs@@nongnu.org (doing so in the form of a diff
d185 1
a185 2
	Linux DR3 GENERIC #6 (1.10.5.1) (presumably LinuxPPC too)
	Mac OS X ALL (footnote 14)
a255 11
(footnote 14)
    Because of the case-insensitive file system on Mac OS X, you cannot build
    CVS directly from a checkout from CVS.  The name of the built executable,
    `cvs', conflicts with name of the CVS administration directory, `CVS'.
    The work-around is to build the executable from a build directory separate
    from the source directory.  i.e.:

	cvs co ccvs; cd ccvs
	mkdir build; cd build
	../configure && make

@


1.1.1.14
log
@Import cvs-1.11.22 onto vendor branch.
@
text
@d1 1
a1 21
-------------------------------------------------------------------------------

CVS is Copyright (C) 1989-2005 The Free Software Foundation, Inc.

CVS is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 1, or (at your option)
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

-------------------------------------------------------------------------------

Now back to our regularly scheduled program:

Please read the README file before reading this INSTALL file.  Then, to
install CVS:

d98 1
a98 1
this list to bug-cvs@@nongnu.org (doing so in the form of a diff
d185 1
a185 2
	Linux DR3 GENERIC #6 (1.10.5.1) (presumably LinuxPPC too)
	Mac OS X ALL (footnote 14)
a255 11
(footnote 14)
    Because of the case-insensitive file system on Mac OS X, you cannot build
    CVS directly from a checkout from CVS.  The name of the built executable,
    `cvs', conflicts with name of the CVS administration directory, `CVS'.
    The work-around is to build the executable from a build directory separate
    from the source directory.  i.e.:

	cvs co ccvs; cd ccvs
	mkdir build; cd build
	../configure && make

@


1.1.1.15
log
@Import of 1.11 branch snapshot - using the 10-March-2008 code base.
@
text
@d3 1
a3 1
CVS is Copyright (C) 1986-2006 The Free Software Foundation, Inc.
@


1.1.1.15.18.1
log
@file INSTALL was added on branch RELENG_8_4 on 2013-03-28 13:00:40 +0000
@
text
@d1 517
@


1.1.1.15.18.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/248810
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@a0 517
-------------------------------------------------------------------------------

CVS is Copyright (C) 1986-2006 The Free Software Foundation, Inc.

CVS is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 1, or (at your option)
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

-------------------------------------------------------------------------------

Now back to our regularly scheduled program:

Please read the README file before reading this INSTALL file.  Then, to
install CVS:


First you need to obtain and install the CVS executables.  If you got
a distribution which contains executables, consult the installation
instructions for that distribution.  If you got source code, do not
panic.  On many platforms building CVS from source code is a
straightforward process requiring no programming knowledge.  See the
section BUILDING FROM SOURCE CODE at the end of this file, which
includes a list of platforms which have been tested.

-------------------------------------------------------------------------------

1) Take a look at the CVS documentation, if desired.  For most
   purposes you want doc/cvs.texinfo, also known as _Version Management
   with CVS_ by Per Cederqvist et al.  Looking at it might be as simple
   as "info cvs" but this will depend on your installation; see README
   for more details.

   See what CVS can do for you, and if it fits your environment (or can
   possibly be made to fit your environment).  If things look good,
   continue on.  Alternately, just give CVS a try first then figure out
   what it is good for.

2) Set the CVSROOT environment variable to where you want to put your
   source repository.  See the "Setting up the repository" section of
   the Cederqvist manual for details, but the quick summary is just to
   pick some directory.  We'll use /src/master as an example.  For
   users of a POSIX shell (sh/bash/ksh) on unix, the following
   commands can be placed in user's ~/.profile, ~/.bash_profile file;
   or in the site-wide /etc/profile:

       CVSROOT=/src/master; export CVSROOT

   For C shell users on unix place the following commands in the
   user's ~/.cshrc, ~/.login, or /etc/chsrc file:

       setenv CVSROOT /src/master

   For Windows users, supposing the repository will be in
   d:\src\master, place the following line in c:\autoexec.bat.  On
   Windows 95, autoexec.bat might not already exist.  In that case,
   just create a new file containing the following line.

       set CVSROOT=:local:d:\src\master

   If these environment variables are not already set in your current
   shell, set them now by typing the above line at the command prompt
   (or source the login script you just edited).
   The instructions for the remaining steps assume that you have set
   the CVSROOT environment variable.

3) Create the master source repository.  Again, the details are in
   the "Setting up the repository" section of cvs.texinfo; the
   one-line summary is:

       $ cvs init

   In this and subsequent examples we use "$" to indicate the command
   prompt; do not type the "$".

4) It might be a good idea to jump right in and put some sources or
   documents directly under CVS control.  From within the top-level
   directory of your source tree, run the following commands:

       $ cvs import -m "test distribution" ccvs CVS_DIST CVS-TEST

   (Those last three items are, respectively, a repository location, a
   "vendor tag", and a "release tag".  You don't need to understand
   them yet, but read the section "Starting new projects" in the
   Cederqvist manual for details).

5) Having done step 4, one should be able to checkout a fresh copy of the
   sources you just imported and hack away at the sources with the
   following command:

      $ cd
      $ cvs checkout ccvs

   This will make the directory "ccvs" in your current directory and
   populate it with the appropriate files and directories.

6) You may wish to customize the various administrative files, in particular
   modules.  See the Cederqvist manual for details.

7) Read the NEWS file to see what's new.

8) Hack away.

-------------------------------------------------------------------------------

BUILDING FROM SOURCE CODE

Tested platforms

CVS has been tested on the following platforms.  The most recent
version of CVS reported to have been tested is indicated, but more
recent versions of CVS probably will work too.  Please send updates to
this list to bug-cvs@@nongnu.org (doing so in the form of a diff
to this file, or at least exact suggested text, is encouraged).
"tested" means, at a minimum, that CVS compiles and appears to work on
simple (manual) testing.  In many cases it also means "make check"
and/or "make remotecheck" passes, but we don't try to list the
platforms for which that is true.

Alpha:
	DEC Alpha running OSF/1 version 1.3 using cc (about 1.4A2)
	DEC Alpha running OSF/1 version 2.0 (1.8)
	DEC Alpha running OSF/1 version 2.1 (about 1.4A2)
	DEC Alpha running OSF/1 version 3.0 (1.5.95) (footnote 7)
	DEC Alpha running OSF/1 version 3.2 (1.9)
	Alpha running alpha-dec-osf4.0 (1.10)
	DEC Alpha running Digital UNIX v4.0C using gcc 2.7.2.2 (1.9.14)
	DEC Alpha running VMS 6.2 (1.8.85 client-only)
	Alpha running NetBSD 1.2E (1.10)
Cray:
	J90 (CVS 970215 snapshot)
	T3E (CVS 970215 snapshot)
HPPA:
	HP 9000/710 running HP-UX 8.07A using gcc (about 1.4A2)
	HPPA running HP-UX 9 (1.8)
        HPPA 1.1 running HP-UX A.09.03 (1.5.95) (footnote 8)
        HPPA 1.1 running HP-UX A.09.04 (1.7.1)
	HPPA running HP-UX 9.05 (1.9)
	HPPA running HP-UX 10.01 (1.7)
	HPPA running HP-UX 10.20 (1.10.7)
	HPPA running HP-UX 11.11 (1.11.13) (footnote 12)
	HPPA 2.0 running HP-UX 10.20 (1.10.9) (footnote 13)
	NextSTEP 3.3 (1.7)
i386 family:
	Solaris 2.4 using gcc (about 1.4A2)
	Solaris 2.6 (1.9)
	UnixWare v1.1.1 using gcc (about 1.4A2)
	Unixware 2.1 (1.8.86)
	Unixware 7 (1.9.29)
	ISC 4.0.1 (1.8.87)
	Linux (kernel 1.2.x) (1.8.86)
	Linux (kernel 2.0.x, RedHat 4.2) (1.10)
	Linux (kernel 2.0.x, RedHat 5.x) (1.10)
	Linux (kernel 2.2.x, RedHat 6.x) (1.10.8)
	Linux (kernel 2.2.x, RedHat 7.x) (1.11)
	BSDI 4.0 (1.10.7)
	FreeBSD 2.1.5-stable (1.8.87)
	NextSTEP 3.3 (1.7)
	SCO Unix 3.2.4.2, gcc 2.7.2 (1.8.87) (footnote 4)
	SCO OpenServer 5.0.5 (1.10.2)
	Sequent DYNIX/ptx4.0 (1.10 or so) (remove -linet)
	Sequent Dynix/PTX 4.1.4 (1.9.20 or so + patches)
	Lynx 2.3.0 080695 (1.6.86) (footnote 9)
	Windows NT 3.51 (1.8.86 client; 1.8.3 local)
	Windows NT 3.51 service pack 4 (1.9)
	Windows NT 3.51 service pack 5 (1.9) -- DOES NOT WORK (footnote 11)
	Windows NT 4.0 (1.9 client and local)
	Windows NT 4.0 (1.11 client and local - build & test, but no test suite)
	Windows 95 (1.9 client and local)
	QNX (1.9.1 + patches for strippath() and va_list)
	OS/2 Version 3 using IBM C/C++ Tools 2.01 (1.8.86 + patches, client)
	OS/2 Version 3 using EMX 0.9c (1.9.22, client)
	OS/2 Version 3 using Watcom version ? (? - has this been tested?)
m68k:
	Sun 3 running SunOS 4.1.1_U1 w/ bundled K&R /usr/5bin/cc (1.8.86+)
	NextSTEP 3.3p1 (1.8.87)
	Lynx 2.3.0 062695 (1.6.86) (footnote 9)
	NetBSD/mac68k (1.9.28)
m88k:
	Data General AViiON running dgux 5.4R2.10 (1.5)
	Data General AViiON running dgux 5.4R3.10 (1.7.1)
	Harris Nighthawk 5800 running CX/UX 7.1 (1.5) (footnote 6)
MIPS:
	DECstation running Ultrix 4.2a (1.4.90)
	DECstation running Ultrix 4.3 (1.10)
	SGI running Irix 4.0.5H using gcc and cc (about 1.4A2) (footnote 2)
	SGI running Irix 5.3 (1.10)
	SGI running Irix 6.2 using SGI MIPSpro 6.2 and beta 7.2 compilers (1.9)
	SGI running Irix-6.2 (1.9.8)
	SGI running IRIX 6.4 (1.10)
	SGI running IRIX 6.5 (1.10.7)
	Siemens-Nixdorf RM600 running SINIX-Y (1.6)
PowerPC or RS/6000:
	IBM RS/6000 running AIX 3.1 using gcc and cc (1.6.86)
	IBM RS/6000 running AIX 3.2.5 (1.8)
	IBM RS/6000 running AIX 4.1 (1.9)
	IBM RS/6000 running AIX 4.3 (1.10.7)
	Lynx 2.3.1 120495 (1.6.86) (footnote 9)
	Lynx 2.5 (1.9) (footnote 10)
	Linux DR3 GENERIC #6 (1.10.5.1) (presumably LinuxPPC too)
	Mac OS X ALL (footnote 14)
	Mac OS X Darwin 6.6 Darwin Kernel Version 6.6 (1.11.1p1)
	Mac OS X Darwin 5.5 Darwin Kernel Version 5.5 (1.11.6) (footnote 12)
	Mac OS X Darwin 5.5 Darwin Kernel Version 5.5 (1.12.1) (footnote 12)
SPARC:
	Sun SPARC running SunOS 4.1.x (1.10)
	Sun SPARCstation 10 running Solaris 2.3 using gcc and cc (about 1.4A2)
	Sun SPARCstation running Solaris 2.4 using gcc and cc (about 1.5.91)
	Sun SPARC running Solaris 2.5 (1.8.87)
	Sun SPARC running Solaris 2.5.1 using gcc 2.7.2.2 (1.9.14)
	Sun SPARC running Solaris 2.6 (1.10.7)
	Sun UltraSPARC running Solaris 2.6 using gcc 2.8.1 (1.10)
	NextSTEP 3.3 (1.7)
	Sun SPARC running Linux 2.0.17, gcc 2.7.2 (1.8.87)
	Sun UltraSPARC running Solaris 2.8 using gcc 2.95.3
VAX:
	VAX running VMS 6.2 (1.9+patches, client-only)
	  (see README.VMS for information on necessary hacks).

(footnote 2)
	Some Irix 4.0 systems may core dump in malloc while running
	CVS.  We believe this is a bug in the Irix malloc.  You can
	workaround this bug by linking with "-lmalloc" if necessary.
	(about 1.4A2).

(footnote 4) Comment out the include of sys/time.h in src/server.c. (1.4.93)
	You also may have to make sure TIME_WITH_SYS_TIME is undef'ed.

(footnote 6) Build in ucb universe with COFF compiler tools.  Put
	/usr/local/bin first in PATH while doing a configure, make
	and install of GNU diffutils-2.7, rcs-5.7, then cvs-1.5.

(footnote 7) Manoj Srivastava <srivasta@@pilgrim.umass.edu> reports
        success with this configure command:
  CC=cc CFLAGS='-O2 -Olimit 2000 -std1' ./configure --verbose alpha-dec-osf

(footnote 8) Manoj Srivastava <srivasta@@pilgrim.umass.edu> reports
        success with this configure command:
  CC=cc CFLAGS='+O2 -Aa -D_HPUX_SOURCE' ./configure --verbose hppa1.1-hp-hpux

(footnote 9) 
    Had to configure with ./configure --host=<arch>-lynx.

    In src/cvs.h, protected the waitpid prototype with ifdef _POSIX_SOURCE.
    (I might try building with gcc -mposix -D_POSIX_SOURCE.)

    LynxOS has <dirent.h>, but you don't want to use it.
    You want to use <sys/dir.h> instead.
    So after running configure I had to undef HAVE_DIRENT_H and
    define HAVE_SYS_DIR_H.

(footnote 10)
    Had to compile with "make LIBS=-lbsd" (to get gethostbyname
    and getservbyname).

(footnote 11)
    when I do a `cvs init' I get this message:
      ci: 'RCS/loginfo,v' is not a regular file
      ci:  RCS/loginfo,v: Invalid argument
      cvs [init aborted]: failed to checkin n:/safe/CVSROOT/loginfo

(footnote 12)
    Need to `configure --without-gssapi' unless you have installed Kerberos 5
    libraries on the system yourself.  For some reason Apple ships OS X with
    the Kerberos 5 headers installed and not the libraries, which confuses the
    current configure script.  Some HP, BSD, & Sun boxes have similar problems.

(footnote 13)
    A build under HP PA-RISC 2.0 will probably not run under PA-RISC 1.1
    unless "+DAportable" is added to the HP ANSI cc compiler flags.

(footnote 14)
    Because of the case-insensitive file system on Mac OS X, you cannot build
    CVS directly from a checkout from CVS.  The name of the built executable,
    `cvs', conflicts with name of the CVS administration directory, `CVS'.
    The work-around is to build the executable from a build directory separate
    from the source directory.  i.e.:

	cvs co ccvs; cd ccvs
	mkdir build; cd build
	../configure && make

-------------------------------------------------------------------------------

Building from source code under Unix:

1)  Run "configure":

	$ ./configure

    You can specify an alternate destination to override the default with
    the --prefix option:

	$ ./configure --prefix=/usr/local/gnu

    or some path that is more appropriate for your site.  The default prefix
    value is "/usr/local", with binaries in sub-directory "bin", manual
    pages in sub-directory "man", and libraries in sub-directory "lib".

    A normal build of CVS will create an executable which supports
    local, server, or client CVS (if you don't know the difference,
    it is described in the Repository chapter of doc/cvs.texinfo).  If
    you do not intend to use client or server CVS, you may want to
    prevent these features from being included in the executable you
    build. You can do this with the --disable-client and
    --disable-server options:

	$ ./configure --disable-client --disable-server

    Typically this can reduce the size of the executable by around 30%.

    If you are building CVS with the server enabled, you can disable
    server flow control using the --disable-server-flow-control
    If you are working with a large remote repository and a 'cvs
    checkout' is swamping your network and memory, enable flow control.
    You will end up with even less probability of a consistent checkout
    (see Concurrency in cvs.texinfo), but CVS doesn't try to guarantee
    that anyway.  The master server process will monitor how far it is
    getting behind, if it reaches the high water mark, it will signal
    the child process to stop generating data when convenient (ie: no
    locks are held, currently at the beginning of a new directory).
    Once the buffer has drained sufficiently to reach the low water
    mark, it will be signalled to start again.  You may override the
    default hi/low watermarks here too by passing
    '<lowwater>,<highwater>', in bytes, as an argument to
    --enable-server-flow-control.  The low water mark defaults to one
    megabyte and the high water mark defaults to two megabytes.

	$ ./configure --enable-server-flow-control=1M,2M

    The --with-tmpdir argument to configure may be used to set a
    specific directory for use as a default temporary directory.  If not
    set, configure will pick the first directory it finds which it has
    read, write, and execute permissions to from $TMPDIR, $TMP, $TEMP,
    /tmp, and /var/tmp, in that order.  Failing that, it will use /tmp.

    The --with-umask argument to configure can be used to change
    the default umask used by the CVS server executable.

    Unlike previous versions of CVS, you do not need to install RCS
    or GNU diff.  

    If you are using gcc and are planning to modify CVS, you may want to
    configure with -Wall; see the file HACKING for details.

    If you have Kerberos 4 installed, you can specify the location of
    the header files and libraries using the --with-krb4=DIR option.
    DIR should be a directory with subdirectories include and lib
    holding the Kerberos 4 header files and libraries, respectively.
    The default value is /usr/kerberos.

    If you want to enable support for encryption over Kerberos, use
    the --enable-encryption option.  This option is disabled by
    default.

    If you want to disable automatic dependency tracking in the makefiles,
    use the '--disable-dependency-tracking' option:

	$ ./configure --disable-dependency-tracking

    This avoids problems on some platforms.  See the note at the end of this
    file on BSD.

    Try './configure --help' for further information on its usage.

    NOTE ON CVS's USE OF NDBM:

	By default, CVS uses some built-in ndbm emulation code to allow
	CVS to work in a heterogeneous environment.  However, if you have
	a very large modules database, this may not work well.  You will
	need to supply the --disable-cvs-ndbm option to configure to
	accomplish this.  If you do this, the following comments apply.  If
	not, you may safely skip these comments.

	If you configure CVS to use the real ndbm(3) libraries and
	you do not have them installed in a "normal" place, you will
	probably want to get the GNU version of ndbm (gdbm) and install
	that before running the CVS configure script.  Be aware that the
	GDBM 1.5 release does NOT install the <ndbm.h> header file included
	with the release automatically.  You may have to install it by hand.

	If you configure CVS to use the ndbm(3) libraries, you cannot
	compile CVS with GNU cc (gcc) on Sun-4 SPARC systems.  However, gcc
	2.0 may have fixed this limitation if -fpcc-struct-return is
	defined.  When using gcc on other systems to compile CVS, you *may*
	need to specify the -fpcc-struct-return option to gcc (you will
	*know* you have to if "cvs checkout" core dumps in some ndbm
	function).  You can do this as follows:

	    $ CC='gcc -fpcc-struct-return' ./configure

	for sh, bash, and ksh users and:

	    % setenv CC 'gcc -fpcc-struct-return'
	    % ./configure

	for csh and tcsh users.

    END OF NOTE FOR NDBM GUNK.

2)  Try to build it:

	$ make

    This will (hopefully) make the needed CVS binaries within the
    "src" directory.  If something fails for your system, and you want
    to submit a bug report, you may wish to include your
    "config.status" file, your host type, operating system and
    compiler information, make output, and anything else you think
    will be helpful.

3)  Run the regression tests (optional).

    You may also wish to validate the correctness of the new binary by
    running the regression tests.  If they succeed, that is nice to
    know.  However, if they fail, it doesn't tell you much.  Often it
    will just be a problem with running the tests on your machine,
    rather than a problem with CVS.  Unless you will have the time to
    determine which of the two it is in case of failure, you might
    want to save yourself the time and just not run the tests.

    If you want to run the tests, see the file TESTS for more information.

4)  Install the binaries/documentation:

	$ make install

    Depending on your installation's configuration, you may need to be
    root to do this.

-------------------------------------------------------------------------------

Detailed information about your interaction with "configure":

The "configure" script and its interaction with its options and the
environment is described here.  For more detailed documentation about
"configure", please run `./configure --help' or refer to the GNU Autoconf
documentation.

Supported options are:

	--srcdir=DIR		Useful for compiling on many different
				machines sharing one source tree.
	--prefix=DIR		The root of where to install the
				various pieces of CVS (/usr/local).
	--exec_prefix=DIR	If you want executables in a
				host-dependent place and shared
				things in a host-independent place.

The following environment variables override configure's default
behaviour:

	CC			If not set, tries to use gcc first,
				then cc.  Also tries to use "-g -O"
				as options, backing down to -g
				alone if that doesn't work.
	INSTALL			If not set, tries to use "install", then
				"./install-sh" as a final choice.
	RANLIB			If not set, tries to determine if "ranlib"
				is available, choosing "echo" if it doesn't
				appear to be.
	YACC			If not set, tries to determine if "bison"
				is available, choosing "yacc" if it doesn't
				appear to be.

-------------------------------------------------------------------------------

Building from source code under Windows NT/95/98/2000:

You may find interesting information in windows-NT/README.

* Using Microsoft Visual C++ 5.x (this is currently broken - someone with
  MVC++ 5.x needs to regenerate the project files, but the builds using `nmake'
  below will work).

1) Using Microsoft Visual C++ 5.x, open the project `cvsnt.dsw',
   in the top directory of the CVS distribution.  If you have an older
   version of Visual C++, take a look at windows-NT/README.
2) Choose "Build cvs.exe" from the "Project" menu.
3) MSVC will place the executable file cvs.exe in WinRel, or whatever
   your target directory is.

* From the top level directory, with MSVC++ 6.0 installed, something like the
following also works:

	C:\> vcvars32
	C:\> nmake /f cvsnt.mak CFG="cvsnt - Win32 Debug"

* Using the Cygwin development environment <http://cygwin.com>, Windows clients
  and servers can be built using the instructions for building on UNIX.  For
  deploying the CVS server on Windows NT, see the `cygrunsrv' executable that
  comes with Cygwin.

* You might also try <http://wincvs.org> & <http://www.cvsnt.org>.

-------------------------------------------------------------------------------

Building from source code under other platforms:

For OS/2, see os2/README and emx/README.

For VMS, see README.VMS

Mac OS X: Builds fine, just like UNIX.

For older versions of Mac OS, you might try <http://wincvs.org>.

For a Java client, see jCVS (which is a separate package from CVS
itself, but which might be preferable to the Macintosh port mentioned
above, for example).

-------------------------------------------------------------------------------
@


