freebsd-src/gnu/usr.bin/cvs

$CVSid: @(#)README 1.32 94/10/22 $

			CVS Kit, Version 1.4 Alpha

		  Copyright (c) 1993-1994 Brian Berliner
	      Copyright (c) 1992 Brian Berliner and Jeff Polk
		  Copyright (c) 1989-1992, Brian Berliner
			    All Rights Reserved

    This program 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.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

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

Welcome to the CVS 1.4 Alpha release!  We thank you for taking the time to
test this (potentially unstable) release and report bugs (ideally, with
fixes).  To report bugs, run the "cvsbug" program and fill out the template:

	$ cvsbug

The "cvsbug" program is installed in the same location as the "cvs"
program.  If your installation failed, you may need to run "cvsbug"
directly out of the "src" directory as "src/cvsbug.sh".

While we cannot promise to be responsive to said bugs, we do appreciate
your support through this Alpha process.  Please consult the INSTALL file
for information on tested configurations.  If you have a comment about an
already tested configuration, or have tried CVS on a new configuration,
please write to the above address and let us know!  Free software only
works if we all help out.

Finally, we cannot guarantee that this release will not completely wipe out
all of your work from your system.  We do some simple testing before each
release, but you are completely on your own.  We recommend testing this
release on a source repository that is not critical to your work.  THIS
SOFTWARE IS SUPPLIED COMPLETELY "AS IS".  NO WARRANTY....

Thanks for your support!

	-The CVS Alpha Team

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

CVS is a freely available collection of programs that provide for software
release and revision control functions in a UNIX environment.  It is
designed to work on top of the RCS distribution, V4 and later.  CVS does
understand how to parse older RCS formats, but cannot do any of the fancier
features (like vendor branch support) without RCS branch support.

Short blurb from the manual page (larger blurb is included there):
     cvs is a front end to the  rcs(1)  revision  control  system
     which  extends the notion of revision control from a collec-
     tion of files in a single directory to a  hierarchical  col-
     lection  of  directories  consisting  of revision controlled
     files.  These directories and files can be combined together
     to  form  a  software  release.   cvs provides the functions
     necessary to manage these software releases and  to  control
     the  concurrent  editing  of  source  files  among  multiple
     software developers.

And a whole lot more.  See the man/cvs.1 file for more information.

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

Special note to current CVS 1.3 users:

--> You can skip this section and go straight to "Installation" if you  <--
--> have not been running any previous releases of CVS.                 <--

See the ChangeLog file in this directory to find out what has changed from
CVS 1.3.

Some files have been renamed from the CVS 1.3 distribution.  If you're not
careful, this can cause your build of CVS 1.4 to fail in strange ways.  In
particular, be sure to remove the src/config.h file (which is now
src/options.h), as the correct config.h file is generated automatically by
the "configure" stage of installation (and installed in this directory).

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

Installation:

Please read the INSTALL file for installation instructions.  Brief summary:

	$ ./configure
	$ make
	$ make install
	$ cvsinit

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

Mailing Lists:

I have setup the following mailing list for CVS users and other interested
parties.  I have no idea what kind of volume will be generated on this
list.  Nor can I guarantee to personally respond to questions posted to the
list.  Anyway, the mailing list is:

	info-cvs-request@prep.ai.mit.edu
		Requests for addition to or removal from the mailing list
		must be sent to this address.  Problems with the list
		(like bounced mail) should also be sent here.  Please be
		specific about your email address.

	info-cvs@prep.ai.mit.edu
		Questions, bugs, porting problems, hints, or whatever
		can be sent to this address.  A Frequently Asked Questions
		(FAQ) my be available from host "think.com" in the
		"/pub/cvs" directory.  Please consult the FAQ before
		sending questions to info-cvs.  DO NOT SEND ADDITION AND
		REMOVAL REQUESTS TO THIS ALIAS.

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

Credits:

The conflict-resolution algorithms and much of the administrative file
definitions of CVS were based on the original package written by Dick Grune
at Vrije Universiteit in Amsterdam <dick@cs.vu.nl>, and posted to
comp.sources.unix in the volume 6 release sometime in 1986.  This original
version was a collection of shell scripts.  I am thankful that Dick made
his work available.

Brian Berliner from Prisma, Inc. (now at Sun Microsystems, Inc.)
<berliner@sun.com> converted the original CVS shell scripts into reasonably
fast C and added many, many features to support software release control
functions.  See the manual page in the "man" directory.  A copy of the
USENIX article presented at the Winter 1990 USENIX Conference, Washington
D.C., is included in the "doc" directory.

Jeff Polk from BSDI <polk@bsdi.com> converted the CVS 1.2
sources into much more readable and maintainable C code.  He also added a
whole lot of functionality and modularity to the code in the process.
See the ChangeLog file.

david d `zoo' zuhn <zoo@armadillo.com> contributed the working base code
for CVS 1.4 Alpha.  His work carries on from work done by K. Richard Pixley
and others at Cygnus Support.  The CVS 1.4 upgrade is due in large part to
Zoo's efforts.

David G. Grubbs <dgg@odi.com> contributed the CVS "history" and "release"
commands.  As well as the ever-so-useful "-n" option of CVS which tells CVS
to show what it would do, without actually doing it.  He also contributed
support for the .cvsignore file.

The Free Software Foundation (GNU) contributed most of the portability
framework that CVS now uses.  This can be found in the "configure" script,
the Makefile's, and basically most of the "lib" directory.

K. Richard Pixley, Cygnus Support <rich@cygnus.com> contributed many bug
fixes/enhancement as well as completing early reviews of the CVS 1.3 manual
pages.

Roland Pesch, then of Cygnus Support <roland@wrs.com> contributed brand new
cvs(1) and cvs(5) manual pages.  We should all thank him for saving us from
my poor use of our language!

Paul Sander, HaL Computer Systems, Inc. <paul@hal.com> wrote and
contributed the code in lib/sighandle.c.  I added support for POSIX, BSD,
and non-POSIX/non-BSD systems.

In addition to the above contributors, the following Beta testers deserve
special mention for their support.  If I have left off your name, I
apologize.  Just write to me and let me know!

	Mark D. Baushke <mdb@cisco.com>
	Per Cederqvist <ceder@signum.se>
	J.T. Conklin (jtc@cygnus.com>
	Vince DeMarco <vdemarco@fdcsrvr.cs.mci.com>
	Paul Eggert <eggert@twinsun.com>
	Lal George <george@research.att.com>
	Dean E. Hardi <Dean.E.Hardi@ccmail.jpl.nasa.gov>
	Mike Heath <mike@pencom.com>
	Jim Kingdon <kingdon@cygnus.com>
	Bernd Leibing <bernd.leibing@rz.uni-ulm.de>
	Benedict Lofstedt <benedict@tusc.com.au>
	Dave Love <d.love@dl.ac.uk>
	Robert Lupton the Good <rhl@astro.princeton.edu>
	Tom McAliney <tom@hilco.com>
	Eberhard Mattes <mattes@azu.informatik.uni-stuttgart.de>
	Jim Meyering <meyering@comco.com>
	Thomas Mohr <mohr@lts.sel.alcatel.de>
	Thomas Nilsson <thoni@softlab.se>
	Raye Raskin <raye.raskin@lia.com>
	Harlan Stenn <harlan@landmark.com>
	Gunnar Tornblom <gunnar.tornblom@senet.abb.se>
	Greg A. Woods <woods@kuma.web.net>

Many contributors have added code to the "contrib" directory.  See the
README file there for a list of what is available.  There is also a
contributed GNU Emacs CVS-mode in contrib/pcl-cvs.

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

					Brian Berliner
					berliner@sun.com