home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / cvs-1.8.7-src.tgz / tar.out / fsf / cvs / README < prev    next >
Text File  |  1996-09-28  |  10KB  |  223 lines
  1. $CVSid: @(#)README 1.32 94/10/22 $
  2.  
  3.                 CVS Kit
  4.  
  5.         Copyright (c) 1993-1994 Brian Berliner
  6.        Copyright (c) 1992 Brian Berliner and Jeff Polk
  7.            Copyright (c) 1989-1992, Brian Berliner
  8.              All Rights Reserved
  9.  
  10.     This program is free software; you can redistribute it and/or modify
  11.     it under the terms of the GNU General Public License as published by
  12.     the Free Software Foundation; either version 1, or (at your option)
  13.     any later version.
  14.  
  15.     This program is distributed in the hope that it will be useful,
  16.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  17.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18.     GNU General Public License for more details.
  19.  
  20.     You should have received a copy of the GNU General Public License
  21.     along with this program; if not, write to the Free Software
  22.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23.  
  24. -------------------------------------------------------------------------------
  25.  
  26. Welcome to CVS!
  27.  
  28. Bug reports are accepted, however note that someone may or may not
  29. feel like taking care of your bug report.  Support contracts are
  30. available from Cyclic Software (http://www.cyclic.com or
  31. info@cyclic.com).
  32.  
  33. To report bugs send mail to bug-cvs@prep.ai.mit.edu, or run the "cvsbug"
  34. program and fill out the template:
  35.  
  36.     $ cvsbug
  37.  
  38. The "cvsbug" program is installed in the same location as the "cvs"
  39. program.  If your installation failed, you may need to run "cvsbug"
  40. directly out of the "src" directory as "src/cvsbug.sh".  This is also
  41. the procedure for submitting suggested changes to CVS (see the file
  42. HACKING for more details).  Note that all submitted changes may be
  43. distributed under the terms of the GNU Public License, so if you don't
  44. like this, don't submit them.
  45.  
  46. Please consult the INSTALL file for information on tested
  47. configurations.  If you have a comment about an already tested
  48. configuration, or have tried CVS on a new configuration, please write
  49. to the above address and let us know!  Free software only works if we
  50. all help out.
  51.  
  52. Finally, we cannot guarantee that this release will not completely wipe out
  53. all of your work from your system.  We do some simple testing before each
  54. release, but you are completely on your own.  We recommend testing this
  55. release on a source repository that is not critical to your work.  THIS
  56. SOFTWARE IS SUPPLIED COMPLETELY "AS IS".  NO WARRANTY....
  57.  
  58. Thanks for your support!
  59.  
  60.     -The CVS Team
  61.  
  62. -------------------------------------------------------------------------------
  63.  
  64. CVS is a freely available collection of programs that provide for software
  65. release and revision control functions in a UNIX environment.  It is
  66. designed to work on top of the RCS distribution, V4 and later.  CVS does
  67. understand how to parse older RCS formats, but cannot do any of the fancier
  68. features (like vendor branch support) without RCS branch support.
  69.  
  70. Short blurb from the manual page (larger blurb is included there):
  71.      cvs is a front end to the  rcs(1)  revision  control  system
  72.      which  extends the notion of revision control from a collec-
  73.      tion of files in a single directory to a  hierarchical  col-
  74.      lection  of  directories  consisting  of revision controlled
  75.      files.  These directories and files can be combined together
  76.      to  form  a  software  release.   cvs provides the functions
  77.      necessary to manage these software releases and  to  control
  78.      the  concurrent  editing  of  source  files  among  multiple
  79.      software developers.
  80.  
  81. And a whole lot more.  See the doc/cvs.texinfo file for more information.
  82.  
  83. -------------------------------------------------------------------------------
  84.  
  85. Notes to people upgrading from a previous release of CVS:
  86.  
  87. See the NEWS file for a description of features new in this version.
  88.  
  89. The repository format is compatible going back to CVS 1.3.  But see
  90. the "Watches compatibility" section of doc/cvs.texinfo if you have
  91. copies of CVS 1.6 or older and you want to use the optional developer
  92. communication features.
  93.  
  94. The working directory format is compatible going back to CVS 1.5.  It
  95. did change between CVS 1.3 and CVS 1.5.  If you run CVS 1.5 or newer
  96. on a working directory checked out with CVS 1.3, CVS will convert it,
  97. but to go back to CVS 1.3 you need to check out a new working
  98. directory with CVS 1.3.
  99.  
  100. The remote protocol is interoperable going back to CVS 1.5.  Using a
  101. client or server older than 1.5 is deprecated and may fail to work at
  102. some point in the future (1.5 was the first official release with the
  103. remote protocol, but some older versions might still be floating
  104. around).  In many cases you need to upgrade both the client and the
  105. server to take advantage of new features and bugfixes, however.
  106.  
  107. -------------------------------------------------------------------------------
  108.  
  109. Installation:
  110.  
  111. Please read the INSTALL file for installation instructions.  Brief summary:
  112.  
  113.     $ ./configure
  114.     $ make
  115.     (run the regression tests if desired)
  116.     $ make install
  117.     (create a repository if you don't already have one)
  118.  
  119. The documentation is in the doc subdirectory.  cvs.texinfo is the main
  120. manual; cvs.info* and cvs.ps are the info and postscript versions,
  121. respectively, generated from cvs.texinfo.  The postscript version is
  122. for A4 paper; if you want US letter size, you need to remove the line
  123. @afourpaper from cvs.texinfo and re-generate cvs.ps using TeX.
  124.  
  125. -------------------------------------------------------------------------------
  126.  
  127. * How do I get up-to-date information and information about other
  128. versions of CVS?
  129.  
  130. On the web, http://www.loria.fr/~molli/cvs-index.html.
  131.  
  132. The mailing list for CVS is info-cvs@prep.ai.mit.edu.  Send
  133. subscription and removal requests for that list to
  134. info-cvs-request@prep.ai.mit.edu.
  135.  
  136. The newsgroup for CVS (and other configuration management systems) is
  137. comp.software.config-mgmt.  There is not yet a CVS-specific newsgroup,
  138. but perhaps if comp.software.config-mgmt gets enough CVS discussion,
  139. then it will be possible to create one.
  140.  
  141. -------------------------------------------------------------------------------
  142.  
  143. Credits:
  144.  
  145. The conflict-resolution algorithms and much of the administrative file
  146. definitions of CVS were based on the original package written by Dick Grune
  147. at Vrije Universiteit in Amsterdam <dick@cs.vu.nl>, and posted to
  148. comp.sources.unix in the volume 6 release sometime in 1986.  This original
  149. version was a collection of shell scripts.  I am thankful that Dick made
  150. his work available.
  151.  
  152. Brian Berliner from Prisma, Inc. (now at Sun Microsystems, Inc.)
  153. <berliner@sun.com> converted the original CVS shell scripts into reasonably
  154. fast C and added many, many features to support software release control
  155. functions.  See the manual page in the "man" directory.  A copy of the
  156. USENIX article presented at the Winter 1990 USENIX Conference, Washington
  157. D.C., is included in the "doc" directory.
  158.  
  159. Jeff Polk from BSDI <polk@bsdi.com> converted the CVS 1.2
  160. sources into much more readable and maintainable C code.  He also added a
  161. whole lot of functionality and modularity to the code in the process.
  162. See the ChangeLog file.
  163.  
  164. david d `zoo' zuhn <zoo@armadillo.com> contributed the working base code
  165. for CVS 1.4 Alpha.  His work carries on from work done by K. Richard Pixley
  166. and others at Cygnus Support.  The CVS 1.4 upgrade is due in large part to
  167. Zoo's efforts.
  168.  
  169. David G. Grubbs <dgg@odi.com> contributed the CVS "history" and "release"
  170. commands.  As well as the ever-so-useful "-n" option of CVS which tells CVS
  171. to show what it would do, without actually doing it.  He also contributed
  172. support for the .cvsignore file.
  173.  
  174. The Free Software Foundation (GNU) contributed most of the portability
  175. framework that CVS now uses.  This can be found in the "configure" script,
  176. the Makefile's, and basically most of the "lib" directory.
  177.  
  178. K. Richard Pixley, Cygnus Support <rich@cygnus.com> contributed many bug
  179. fixes/enhancement as well as completing early reviews of the CVS 1.3 manual
  180. pages.
  181.  
  182. Roland Pesch, then of Cygnus Support <roland@wrs.com> contributed brand new
  183. cvs(1) and cvs(5) manual pages.  We should all thank him for saving us from
  184. my poor use of our language!
  185.  
  186. Paul Sander, HaL Computer Systems, Inc. <paul@hal.com> wrote and
  187. contributed the code in lib/sighandle.c.  I added support for POSIX, BSD,
  188. and non-POSIX/non-BSD systems.
  189.  
  190. Jim Kingdon and others at Cygnus Support <info@cygnus.com> wrote the
  191. remote repository access code.
  192.  
  193. In addition to the above contributors, the following Beta testers deserve
  194. special mention for their support.  If I have left off your name, I
  195. apologize.  Just write to me and let me know!
  196.  
  197.     Mark D. Baushke <mdb@cisco.com>
  198.     Per Cederqvist <ceder@signum.se>
  199.     J.T. Conklin (jtc@cygnus.com>
  200.     Vince DeMarco <vdemarco@fdcsrvr.cs.mci.com>
  201.     Paul Eggert <eggert@twinsun.com>
  202.     Lal George <george@research.att.com>
  203.     Dean E. Hardi <Dean.E.Hardi@ccmail.jpl.nasa.gov>
  204.     Mike Heath <mike@pencom.com>
  205.     Jim Kingdon <kingdon@cygnus.com>
  206.     Bernd Leibing <bernd.leibing@rz.uni-ulm.de>
  207.     Benedict Lofstedt <benedict@tusc.com.au>
  208.     Dave Love <d.love@dl.ac.uk>
  209.     Robert Lupton the Good <rhl@astro.princeton.edu>
  210.     Tom McAliney <tom@hilco.com>
  211.     Eberhard Mattes <mattes@azu.informatik.uni-stuttgart.de>
  212.     Jim Meyering <meyering@comco.com>
  213.     Thomas Mohr <mohr@lts.sel.alcatel.de>
  214.     Thomas Nilsson <thoni@softlab.se>
  215.     Raye Raskin <raye.raskin@lia.com>
  216.     Harlan Stenn <harlan@landmark.com>
  217.     Gunnar Tornblom <gunnar.tornblom@senet.abb.se>
  218.     Greg A. Woods <woods@planix.com>
  219.  
  220. Many contributors have added code to the "contrib" directory.  See the
  221. README file there for a list of what is available.  There is also a
  222. contributed GNU Emacs CVS-mode in contrib/pcl-cvs.
  223.