home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cvs110.zip / cvs / README < prev   
Text File  |  1998-08-21  |  6KB  |  183 lines
  1.  
  2. 0. What is it?
  3.  
  4.     This is an EMX port of the Concurrent Versions System (CVS)
  5.     Version 1.10 'Halibut' (client/server).
  6.  
  7.     Features include:
  8.         * Full client (:ext:, :server: and :pserver:).
  9.         * Full server (via rshd) and pserver (via inetd).
  10.         * Documentation in .INF format.
  11.         * Utility to maintain the password file (for
  12.           pserver authentication).
  13.         * Rshd replacement for use with the server.
  14.         * Direct execution of shell scripts, Rexx
  15.           scripts, #! scripts (including perl and sh) and
  16.           PM applications (e.g. PM editors).
  17.         * Rexx scripts to control access to the repository,
  18.           to distribute commit messages, and to semi-
  19.           automatically maintain ChangeLogs.
  20.         * Includes Murray Bishop's <mbishop@acnielsen.com.au>
  21.           patches.
  22.         * Passes both local and remote sanity tests.
  23.         * Patches for jCVS-4.7.2.
  24.  
  25. 1. Contents.
  26.  
  27.     .\
  28.         README            - You're just reading it.
  29.         COPYING            - The GNU public license.
  30.  
  31.     bin\
  32.         cvs.exe            - The CVS executable (client/server).
  33.         rxrun.exe        - Runs Rexx scripts without a shell.
  34.         rshd.exe        - An RSHD replacement.
  35.         cvspw.exe        - Manipulates the passwd file.
  36.         cvs2log.cmd        - (Semi-)Automatically maintains ChangeLogs.
  37.         tokenize.cmd    - Tokenizes read-only Rexx scripts in your
  38.                           repositories CVSROOT directory.
  39.  
  40.     book\
  41.         intro.inf        - An introduction to CVS.
  42.         cvs.inf            - The CVS reference manual.
  43.         cvs-client.inf    - The client/server protocol reference.
  44.         install.cmd        - Creates a folder with book objects for
  45.                           the manuals.
  46.  
  47.     scripts\
  48.         README            - Read this first.
  49.         commitinfo.cmd    - Performs repository access control.
  50.         loginfo.cmd        - Creates and distributes commit messages.
  51.         verifymsg.cmd    - Just a template at this point.
  52.         .cvsauthors        - Describes each committer.
  53.         avail            - Describes repository access control.
  54.         maildist        - Describes commit message distribution.
  55.         fix-diff.awk    - Awk script to fix 'cvs diff -c' generated
  56.                           diffs.
  57.  
  58.     src\
  59.         BUILD            - Read this if you want to build CVS
  60.                           yourself.
  61.         diffs            - Patches to the Cyclic CVS 1.10 release.
  62.         emx-new.zip        - The new EMX port.
  63.  
  64.     jCVS-4.7.2\
  65.         INSTALL            - Read this first if you want to use jCVS.
  66.         install.cmd        - Creates a jCVS folder and install the program
  67.                           object and the HTML documentation.
  68.         diffs            - Patches for jCVS 4.7.2.
  69.  
  70. 2. Installation.
  71.  
  72.     - Edit CONFIG.SYS to add X:\CVS\BIN to your PATH. Make sure you
  73.       have the EMX 0.9c runtime (Fix 4) installed.
  74.  
  75.     The following two steps are only required for server and local
  76.     installations. They are NOT required for client only installations.
  77.  
  78.     - Create a new directory that will serve as your repository.
  79.  
  80.     - Add the CVSROOT environment variable to your CONFIG.SYS:
  81.  
  82.         set CVSROOT=<your repository>
  83.  
  84.       Path components are separated by forward slashes.
  85.  
  86.     - If you don't want to use TEDIT to edit your commit messages
  87.       and ChangeLogs, add "set CVSEDITOR=<your favorite editor>" to
  88.       CONFIG.SYS. Be sure to include any options and arguments your
  89.       editor might require. To use EPM, add "set CVSEDITOR=epm /m".
  90.       If you are using emacsclient, add "set CVSEDITOR=emacsclient".
  91.       Type C-x # to continue the commit.
  92.  
  93.     - Add the following environment variable to your CONFIG.SYS, if it
  94.       doesn't already exist:
  95.  
  96.         set LOGNAME=<your login name>
  97.       
  98.     - Reboot.
  99.  
  100.     - To create book objects for the CVS documentation on your desktop
  101.       run the install script in the BOOK directory (change to the BOOK
  102.       directory first).
  103.  
  104.     - For server and local installations, initialize your repository:
  105.  
  106.         cvs init
  107.  
  108.     - If you want repository access control, commit messages emailed
  109.       and/or ChangeLogs (semi-)automatically maintained, take a look
  110.       at the SCRIPTS directory.
  111.  
  112.     - You are now ready to use CVS in client and local modes.
  113.  
  114.     - To setup a server or pserver, go to the 'Autostart' page in your
  115.       TCP/IP configuration notebook and enable inetd.
  116.  
  117.     - Edit %ETC%\inetd.lst to add the line
  118.  
  119.         cmd tcp X:\CVS\BIN\RSHD
  120.  
  121.       for a server and/or the line
  122.  
  123.         cvspserver tcp cvs --allow-root=<your repository> pserver
  124.  
  125.       for a pserver. You also need to add the line
  126.  
  127.         cvspserver 2401/tcp
  128.  
  129.       to %ETC%\services.
  130.  
  131.       Note: You have re-do this step each time your TCP/IP configuration
  132.       is updated. A backup of %ETC%\inetd.lst is saved to %ETC%\inetd.bk?.
  133.  
  134.     - If you are using RSHD, go to the second 'Security' page in your
  135.       TCP/IP configuration notebook and add each host/user you want to
  136.       serve.
  137.  
  138.     - If you are setting up a pserver, you have to setup a passwd file:
  139.  
  140.         md work
  141.         cd work
  142.         cvs co CVSROOT
  143.         cd CVSROOT
  144.         cvspw -add <login name> <password>
  145.  
  146.       Repeat the last line for each login name.
  147.  
  148.       Edit the file checkoutlist to add the line:
  149.  
  150.         passwd
  151.  
  152.       In file config uncomment the line "SystemAuth=no".
  153.  
  154.     - Finally add the file passwd to the repository and commit:
  155.  
  156.         cvs add passwd
  157.         cvs commit -m "<your log message>"
  158.  
  159.       You can now remove work\CVSROOT.
  160.  
  161.     - Reboot. Your server should now be able to accept requests.
  162.  
  163. 3. Contacting the author.
  164.  
  165.     If you have any questions/suggestions/bug reports that are specific
  166.     to this EMX port, send email to "Andreas Huber" <ahuber@ping.at>.
  167.     For any questions about CVS in general, subscribe to the CVS mailing
  168.     list (see http://www.cyclic.com for details).
  169.  
  170. 4. Availability.
  171.  
  172.     The most recent version is usually available at the ftp sites below:
  173.  
  174.     ftp://hobbes.nmsu.edu/pub/incoming/cvs110.zip
  175.     ftp://hobbes.nmsu.edu/pub/os2/unix/dev/cvs110.zip
  176.     ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/devtools/cvs110.zip
  177.  
  178.     It will also be made available on CIS:
  179.  
  180.     Forum: OS2CDEV    Section: Development Tools    File: cvs110.zip
  181.     Forum: GEROS2    Section: SW Engineering        File: cvs110.zip
  182.  
  183.