home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / cvsdos / readme < prev    next >
Text File  |  1993-11-20  |  10KB  |  235 lines
  1. @(#)README 1.23 92/04/10
  2.  
  3.                CVS Kit, Version 1.3
  4.  
  5.           Copyright (c) 1992 Brian Berliner and Jeff Polk
  6.           Copyright (c) 1989-1992, Brian Berliner
  7.                 All Rights Reserved
  8.  
  9.     This program is free software; you can redistribute it and/or modify
  10.     it under the terms of the GNU General Public License as published by
  11.     the Free Software Foundation; either version 1, or (at your option)
  12.     any later version.
  13.  
  14.     This program is distributed in the hope that it will be useful,
  15.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  16.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17.     GNU General Public License for more details.
  18.  
  19.     You should have received a copy of the GNU General Public License
  20.     along with this program; if not, write to the Free Software
  21.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22.  
  23. -------------------------------------------------------------------------------
  24.  
  25. CVS is a freely available collection of programs that provide for software
  26. release and revision control functions in a UNIX environment.  It is
  27. designed to work on top of the RCS distribution, V4 and later.  CVS does
  28. understand how to parse older RCS formats, but cannot do any of the fancier
  29. features (like vendor branch support) without RCS branch support.
  30.  
  31. Short blurb from the manual page (larger blurb is included there):
  32.      cvs is a front end to the  rcs(1)  revision  control  system
  33.      which  extends the notion of revision control from a collec-
  34.      tion of files in a single directory to a  hierarchical  col-
  35.      lection  of  directories  consisting  of revision controlled
  36.      files.  These directories and files can be combined together
  37.      to  form  a  software  release.   cvs provides the functions
  38.      necessary to manage these software releases and  to  control
  39.      the  concurrent  editing  of  source  files  among  multiple
  40.      software developers.
  41.  
  42. And a whole lot more.  See the man/cvs.1 file for more information.
  43.  
  44. -------------------------------------------------------------------------------
  45.  
  46. Special note to current CVS 1.0 and CVS 1.2 users:
  47.  
  48. --> You can skip this section and go straight to "Installation" if you  <--
  49. --> have not been running any previous releases of CVS.                 <--
  50.  
  51. The location of CVS administrative files has changed both for checked out
  52. files and administrative files in the $CVSROOT.  For checked out files the
  53. old directory created was named "CVS.adm".  The new directory is now named
  54. "CVS".  This release will take care to convert your old CVS.adm directories
  55. into CVS directories when you first execute CVS 1.3 within the directory.
  56.  
  57. Also, the CVS/Entries file has changed format with this release, to support
  58. the added functionality.  The format is changed automagically when CVS
  59. notices that your Entries file is in the old format.  No tools are provided
  60. for going back to the old formats, though.  So, be sure that CVS 1.3 is
  61. working at your site before you unleash it on your unsuspecting users!
  62. Remember, this is an unsupported product, after all :-).
  63.  
  64. Within the source repository ($CVSROOT) the administrative files were kept
  65. in the "CVSROOT.adm" directory.  They are now kept within the "CVSROOT"
  66. directory.  Again, CVS 1.3 will attempt to rename the directory to CVSROOT
  67. when it is first run.  If you wish to run with CVS 1.3 and older CVS
  68. releases for some time, you can make a symbolic link (after the rename has
  69. occurred) so that the older CVS binaries will continue to work:
  70.  
  71.     $ ln -s CVSROOT $CVSROOT/CVSROOT.adm
  72.  
  73. While CVS automagically renames the directory within $CVSROOT, it does *not*
  74. rename any CVS/Repository pointers for checked out files.  So, if you
  75. had the modules file checked out based on CVS 1.2, you will need to
  76. fix the CVS/Repository file by hand for CVS 1.3.
  77.  
  78. The file formats within $CVSROOT/CVSROOT are the same right now.  But, CVS
  79. 1.3 has extended the modules format, which will break CVS 1.2 if you are
  80. running them both.  I suggest upgrading your entire network to CVS 1.3 as
  81. soon as possible (once you have tested it, of course).
  82.  
  83. ==> See the ChangeLog file in this directory to get a feel for what has
  84. ==> changed since the CVS 1.2 release.  There is a lot there.
  85.  
  86. Finally, I do NOT recommend importing this CVS release on top of your
  87. existing CVS 1.0 or CVS 1.2 release.  There have been too many changes
  88. to even bother with trying to use CVS for the merge.  Instead, if you
  89. have made local hacks to CVS, do:
  90.  
  91.     $ cvs patch -rCVS1_2 cvs > cvs.local.hacks
  92.  
  93. Then move your CVS 1.0 or CVS 1.2 sources to a backup area with:
  94.  
  95.     $ mv $CVSROOT/cvs $CVSROOT/cvs.old
  96.  
  97. Then follow the instructions below.  When you are done installing the
  98. new CVS, you can merge your hacks in (with patch or by hand) into your
  99. new CVS 1.3 sources.
  100.  
  101. If you have already imported the CVS 1.3 ALPHA or CVS 1.3 BETA release, you
  102. are welcome to import this CVS 1.3 release on top of that.
  103.  
  104. -------------------------------------------------------------------------------
  105.  
  106. Please read the INSTALL file for installation instructions.  Brief summary:
  107.  
  108.     $ ./configure
  109.     $ make
  110.     $ make install
  111.     $ ./cvsinit
  112.  
  113. -------------------------------------------------------------------------------
  114.  
  115. Mailing Lists:
  116.  
  117. I have setup the following mailing list for CVS users and other interested
  118. parties.  I have no idea what kind of volume will be generated on this
  119. list.  Nor can I guarantee to personally respond to questions posted to the
  120. list.  Anyway, the mailing list is:
  121.  
  122.     info-cvs-request@prep.ai.mit.edu    Requests for addition to or
  123.                         removal from the mailing
  124.                         list must be sent to this
  125.                         address.  Problems with the
  126.                         list (like bounced mail)
  127.                         should also be sent here.
  128.                         Please be specific about
  129.                         your email address.
  130.  
  131.     info-cvs@prep.ai.mit.edu        Questions, bugs, porting
  132.                         problems, hints, or whatever
  133.                         can be sent to this address.
  134.  
  135. -------------------------------------------------------------------------------
  136.  
  137. Credits:
  138.  
  139. The conflict-resolution algorithms and much of the administrative file
  140. definitions of CVS were based on the original package written by Dick Grune
  141. at Vrije Universiteit in Amsterdam <dick@cs.vu.nl>, and posted to
  142. comp.sources.unix in the volume 6 release sometime in 1986.  This original
  143. version was a collection of shell scripts.  I am thankful that Dick made
  144. his work available.
  145.  
  146. Brian Berliner from Prisma, Inc. (now at Sun Microsystems, Inc.)
  147. <berliner@sun.com> converted the original CVS shell scripts into reasonably
  148. fast C and added many, many features to support software release control
  149. functions.  See the manual page in the "man" directory.  A copy of the
  150. USENIX article presented at the Winter 1990 USENIX Conference, Washington
  151. D.C., is included in the "doc" directory.
  152.  
  153. Jeff Polk from BSDI <polk@bsdi.com> converted the CVS 1.2
  154. sources into much more readable and maintainable C code.  He also added a
  155. whole lot of functionality and modularity to the code in the process.
  156. See the ChangeLog file.
  157.  
  158. David G. Grubbs <dgg@ksr.com> contributed the CVS "history" and "release"
  159. commands.  As well as the ever-so-useful "-n" option of CVS which tells CVS
  160. to show what it would do, without actually doing it.  He also contributed
  161. support for the .cvsignore file.
  162.  
  163. The Free Software Foundation (GNU) contributed most of the portability
  164. framework that CVS now uses.  This can be found in the "configure" script,
  165. the Makefile's, and basically most of the "lib" directory.
  166.  
  167. K. Richard Pixley, Cygnus Support <rich@cygnus.com> contributed many bug
  168. fixes/enhancement as well as completing early reviews of the CVS 1.3 manual
  169. pages.
  170.  
  171. Roland Pesch, Cygnus Support <pesch@cygnus.com> contributed brand new
  172. cvs(1) and cvs(5) manual pages.  We should all thank him for saving us from
  173. my poor use of our language!
  174.  
  175. Paul Sander, HaL Computer Systems, Inc. <paul@hal.com> wrote and
  176. contributed the code in lib/sighandle.c.  I added support for POSIX, BSD,
  177. and non-POSIX/non-BSD systems.
  178.  
  179. In addition to the above contributors, the following Beta testers deserve
  180. special mention for their support.  If I have left off your name, I
  181. apologize.  Just write to me and let me know.
  182.     Adam Stoller <ghoti+@andrew.cmu.edu>
  183.     Al Gaspar <gaspar@stlouis-emh2.army.mil>
  184.     Arnold Goldberg <ajg@ccd.harris.com>
  185.     Bob Forrest <forrest@gdc.com>
  186.     Brett Bergquist <bergquis@nms.gdc.com>
  187.     Carl Schaefer <schaefer@cisco.com>
  188.     Charlie Xiaoli Huang <epic!mimi!hxl@uunet.UU.NET>
  189.     Chris Moran <cjm@iris.mincom.oz.au>
  190.     Christopher C. Powell <powell@chevron.com>
  191.     D. Jason Penney <penneyj@servio.SLC.COM>
  192.     David C. Martin <dcmartin@fascet.msi.com>
  193.     David C. Martin <dcmartin@fascet.msi.com>
  194.     David Hampton <hampton@cisco.com>
  195.     David Keaton <dmk@craycos.com>
  196.     Francois Felix Ingrand <felix@vega.laas.fr>
  197.     George C. Hwa <hwa@Cadence.COM>
  198.     Greg Onufer <greg.onufer@eng.sun.com>,
  199.     Jeffrey P. Bakke <bakke@plains.NoDak.edu>
  200.     Jeffry Scott <pvi!jeffry@ncar.ucar.edu>,
  201.     John Clyne <clyne@redcloud.scd.ucar.EDU>
  202.     John Lagrue <John_Lagrue.Wgc-e@rx.xerox.com>
  203.     John P. Rouillard <rouilj@cs.umb.ed>
  204.     Josh Siegel <josh@rad.com>
  205.     Kent Williams <williams@herky.cs.uiowa.edu>
  206.     Lee E. Busby <busby@phoenix.ocf.llnl.gov>
  207.     Lee Iverson <leei@mcrcim.mcgill.edu>
  208.     Les Pennington <les@cac.washington.edu>
  209.     Matthew Kwan <mkwan@cs.mu.OZ.AU>
  210.     Michael Batchelor <michaelb@wshb.csms.com>
  211.     Patrick Smith <bnrmtl!pat@larry.mcrcim.mcgill.edu>
  212.     Paul Eggert <eggert@twinsun.com>
  213.     Per Cederqvist <ceder@LYSATOR.LiU.SE>
  214.     Ray Essick <essick@i88.isc.com>
  215.     Rich Mayfield <deltam!dm!rich@uunet.UU.NET>
  216.     Rob Savoye <rips!rob@solbourne.com>
  217.     Robert A. Osborne <isgtec!robert@uunet.uu.net>
  218.     Rusty Carruth <rusty%anasaz.uucp@asuvax.eas.asu.edu>
  219.     Sam Drake <drake@almaden.ibm.com>
  220.     Stephan Fruehauf <sfr%dasburo.UUCP%TUB.BITNET@mitvma.mit.edu>
  221.     Teemu Torma <Teemu.Torma@frend.fi>
  222.     Walter F. Hartheimer <walter@pins.com>
  223.  
  224. Many contributors have added code to the "contrib" directory.  See the
  225. README file there for a list of what is available.  There is also a
  226. contributed GNU Emacs CVS-mode in contrib/pcl-cvs.
  227.  
  228. -------------------------------------------------------------------------------
  229.  
  230.                     Jeff Polk
  231.                     polk@BSDI.COM
  232.  
  233.                     Brian Berliner
  234.                     berliner@Sun.COM
  235.