home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cvs1929.zip / cvs / README < prev   
Text File  |  1998-08-02  |  4KB  |  134 lines
  1.  
  2. 1. Contents.
  3.  
  4.     .\
  5.         README            - You're just reading it.
  6.         COPYING            - The GNU public license.
  7.  
  8.     bin\
  9.         cvs.exe            - The CVS executable (client/server).
  10.         rxrun.exe        - Runs Rexx scripts without a shell.
  11.         rshd.exe        - An RSHD replacement.
  12.         cvspw.exe        - Manipulates the passwd file.
  13.         cvs2log.cmd        - (Semi-)Automatically maintains ChangeLogs.
  14.         tokenize.cmd    - Tokenizes read-only Rexx scripts in your
  15.                           repositories CVSROOT directory.
  16.  
  17.     book\
  18.         intro.inf        - An introduction to CVS.
  19.         cvs.inf            - The CVS reference manual.
  20.         cvs-client.inf    - The client/server protocol reference.
  21.         install.cmd        - Creates a folder with book objects for
  22.                           the manuals.
  23.  
  24.     scripts\
  25.         README            - Read this first.
  26.         commitinfo.cmd    - Performs repository access control.
  27.         loginfo.cmd        - Creates and distributes commit messages.
  28.         verifymsg.cmd    - Just a template at this point.
  29.         .cvsauthors        - Describes each committer.
  30.         avail            - Describes repository access control.
  31.         maildist        - Describes commit message distribution.
  32.  
  33.     src\
  34.         BUILD            - Read this if you want to build CVS
  35.                           yourself.
  36.         diffs            - Patches to the Cyclic CVS 1.9.29 release.
  37.         emx-new.zip        - The new EMX port.
  38.  
  39.     jCVS\
  40.         README            - Read this if you want to use jCVS.
  41.         diffs            - Patches for jCVS 4.7.2.
  42.  
  43. 2. Installation.
  44.  
  45.     - Edit CONFIG.SYS to add X:\CVS\BIN to your PATH. Make sure you
  46.       have the EMX 0.9c runtime (Fix 4) installed.
  47.  
  48.     The following two steps are only required for server and local
  49.     installations. They are NOT required for client only installations.
  50.  
  51.     - Create a new directory that will serve as your repository.
  52.  
  53.     - Add the CVSROOT environment variable to your CONFIG.SYS:
  54.  
  55.         set CVSROOT=<your repository>
  56.  
  57.       Path components are separated by forward slashes.
  58.  
  59.     - If you don't want to use TEDIT to edit your commit messages
  60.       and ChangeLogs, add "set CVSEDITOR=<your favorite editor>" to
  61.       CONFIG.SYS. Be sure to include any options and arguments your
  62.       editor might require. To use EPM, add "set CVSEDITOR=epm /m".
  63.  
  64.     - Add the following environment variable to your CONFIG.SYS, if it
  65.       doesn't already exist:
  66.  
  67.         set LOGNAME=<your login name>
  68.       
  69.     - Reboot.
  70.  
  71.     - To create book objects for the CVS documentation on your desktop
  72.       run the install script in the BOOK directory (change to the BOOK
  73.       directory first).
  74.  
  75.     - For server and local installations, initialize your repository:
  76.  
  77.         cvs init
  78.  
  79.     - If you want repository access control, commit messages emailed
  80.       and/or ChangeLogs (semi-)automatically maintained, take a look
  81.       at the SCRIPTS directory.
  82.  
  83.     - You are now ready to use CVS in client and local modes.
  84.  
  85.     - To setup a server or pserver, go to the 'Autostart' page in your
  86.       TCP/IP configuration notebook and enable inetd.
  87.  
  88.     - Edit %ETC%\inetd.lst to add the line
  89.  
  90.         cmd tcp X:\CVS\BIN\RSHD
  91.  
  92.       for a server and/or the line
  93.  
  94.         cvspserver tcp cvs --allow-root=<your repository> pserver
  95.  
  96.       for a pserver. You also need to add the line
  97.  
  98.         cvspserver 2401/tcp
  99.  
  100.       to %ETC%\services.
  101.  
  102.       Note: You have re-do this step each time your TCP/IP configuration
  103.       is updated. A backup of %ETC%\inetd.lst is saved to %ETC%\inetd.bk?.
  104.  
  105.     - If you are using RSHD, go to the second 'Security' page in your
  106.       TCP/IP configuration notebook and add each host/user you want to
  107.       serve.
  108.  
  109.     - If you are setting up a pserver, you have to setup a passwd file:
  110.  
  111.         md work
  112.         cd work
  113.         cvs co CVSROOT
  114.         cd CVSROOT
  115.         cvspw -add <login name> <password>
  116.  
  117.       Repeat the last line for each login name.
  118.  
  119.       Edit the file checkoutlist to add the line:
  120.  
  121.         passwd
  122.  
  123.       In file config uncomment the line "SystemAuth=no".
  124.  
  125.     - Finally add the file passwd to the repository and commit:
  126.  
  127.         cvs add passwd
  128.         cvs commit -m "<your log message>"
  129.  
  130.       You can now remove work\CVSROOT.
  131.  
  132.     - Reboot. Your server should now be able to accept requests.
  133.  
  134.