_
Using CVS: Getting the latest source
Last modified: Sun Jun 18 07:19:47 EST 2000
How do I get the latest source for HPComm using CVS?

For read-only access to the very latest HPComm source, you can use CVS. This is development code; it may contain new features, bugs, and incompatibilities with older versions.

Please note that if you are behind a firewall, it may not be possible for you to access CVS in this manner. You might try asking your system administrator to "pass through TCP port 2401". If this still doesn't help, please get in touch with us.

To use CVS under Unix:

  1. Obtain, compile and install CVS on your Unix machine. You can get CVS from CVShome.

  2. Set your CVSROOT environment variable:

    • If you're using Bourne shell (or bash), do it like this:
             CVSROOT=:pserver:cvs@cvs.hpcomm.org:/home/hpcomm/CVS-Repository
             export CVSROOT
      Your shell might allow you to combine these two lines like this:
             export CVSROOT=:pserver:cvs@cvs.hpcomm.org:/home/hpcomm/CVS-Repository

    • If you're using the C shell (or tcsh), do it like this:
             setenv CVSROOT :pserver:cvs@cvs.hpcomm.org:/home/hpcomm/CVS-Repository

  3. Tell the CVS server who you are:
           cvs login     (the password is cvs)

  4. Grab yourself the source! (Note, do this once only)
           cvs co HPComm
    or
           cvs co HPComm38

    This creates a subdirectory called HPComm or HPComm38, with the latest source.

  5. If you want to update your source code with changes from the CVS repository, cd into the subdirectory, then use this:
           cvs update
    (If you add a filename to this, only that file will be updated.)

  6. Another useful cvs command is:
           cvs diff -u
    This shows you the changes you've made to the source.

Note: For HPComm, the main branch is what will become HPComm 3.1. Only bug-fixes will be made to 3.0. These have been most recently released as HPComm 3.0r3. The main branch may not be compilable for a while, so if you want to get the source to what has been shipped in the HP PC Connectivity Kit, it's probably best to add "-rR3_0_R2_FIX" just after the "cvs co" and "cvs update" commands. This will give you the stable, HPComm 3.0r3 branch.

Also, to speed things up over the network, add a -z9 flag immediately after the cvs command. This causes all network traffic to be compressed. You can also create a file in your home directory called .cvsrc containing the line "cvs -z9". This will have the same effect.

To use CVS under Windows:

  1. Obtain, and install WinCVS on your Windows machine. You can get WinCVS from the WinCVS homepage. (We have tested this with version 1.1b12).

  2. In WinCVS, open the preferences dialog box (under the Admin->Preferences menu) and change the following settings:

    In section "General":

    • For CVSROOT enter:
      :pserver:cvs@cvs.hpcomm.org:/home/hpcomm/CVS-Repository
    • In the "Authentication" box choose:
      "passwd" file on the cvs server
    • In the "Use version" box choose:
      cvs 1.10 (Standard)
    In section "Globals":

    • Select "Checkout text file with Unix LF (0x10)"

    • To enable compressed data-transfer (especially useful for modem users), check "Use TCP/IP compression" and set the value to 9.

  3. Now you can grab the source.

    • Using the directory tree and list, choose a directory where the source should be downloaded. A subdirectory (either HPComm or HPComm38) will be created for the source files.

    • Choose "Checkout module..." in the Create menu:
      (If the entry is grayed out, you haven't selected a directory).

    • Confirm the directory where the sources should be downloaded to. It should already be correct.

    • Enter the name of the module you want to check out (= download). This will be either HPComm or HPComm38.

    • After pressing OK the download should start and you will see the progress in the output window.

  4. To see the differences between your version and the version in the CVS repository, right-click on a file and choose Diff selection. You'll see the changes in the ouput window.

  5. If you want to merge your source file with the one in the CVS repository, right-click on the file and choose Query update. CVS then tries to merge your changes and the changes in the CVS repository and puts the result back in this file.

We really suggest becoming familiar with CVS, as it's a very powerful tool! If you'd like to know more about CVS, try here .

Home | Development | Development setup