CVS Access

Note that this section is now obsolete. As of February 2006, DC++ uses SVN rather than CVS. A new "SVN Access" page is being created, but this page is left for reference.

Introduction

This page shows how to access the DC++ source code directly from the CVS repository (ie. "checking it out"). The repository can be accessed using any CVS client. The specific steps for a number of them are shown below.

The exact steps may vary slightly depending on what client is used, but there are some pieces of information that are constant, and will be referred to throughout this document. They are:

VariableValue
User nameanonymous
Connection methodpserver
CVS servercvs.sf.net
Repository/cvsroot/dcplusplus
Moduledcplusplus
CVSROOT (a combination of the above) :pserver:anonymous@cvs.sf.net:/cvsroot/dcplusplus

The instructions given below cover the following pieces of software. The specific versions used are given in parentheses.

Note that installation of these pieces of software are not covered as they are beyond the scope of this page.

If there is a piece of software that you would like me to cover, please let me know.

Command line CVS client

The command line CVS client can usually be found on most Linux (and other unix like) systems. Under Windows it can be installed as part of the Cygwin environment.

The first step is to log in to the CVS server using the following command:

cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/dcplusplus login

You will be prompted for a CVS password. The anonymous account has no password so just press Enter. This step only needs to be carried out once. Subsequent CVS related actions will not prompt you for a password.

$ cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/dcplusplus login
Logging in to :pserver:anonymous@cvs.sf.net:2401/cvsroot/dcplusplus
CVS password:

The next step is to actually carry out the checkout.

cvs -z3 -d:pserver:anonymous@cvs.sf.net:/cvsroot/dcplusplus co dcplusplus

The -z3 enables compression of transmitted data. The -d specifies the cvs root directory. The co is short for "checkout". You should see output similar to the following:

$ cvs -z3 -d:pserver:anonymous@cvs.sf.net:/cvsroot/dcplusplus co dcplusplus
cvs checkout: Updating dcplusplus
U dcplusplus/Compile.txt
U dcplusplus/DCPlusPlus.nsi
U dcplusplus/DCPlusPlus.opt
U dcplusplus/DCPlusPlus.rc
U dcplusplus/DCPlusPlus.sln
U dcplusplus/DCPlusPlus.vcproj
U dcplusplus/Example.xml
U dcplusplus/Extensions.txt
...

Once this has completed, the source is checked out and ready for use.

TortoiseCVS

TortoiseCVS is an open source CVS client for Windows which tightly integrates with the Windows Explorer shell. This tight integration means that there is no actual application that you need to explicitly start. Everything is initiated from Explorer context menus.

Once you have installed TortoiseCVS, right click inside a folder and select "CVS Checkout..."

CVS Checkout menu item

This will bring up the checkout screen. Fill in all the relevant values as mentioned in the table above. The CVSROOT field does not need to be entered as it will be automatically constructed from the other pieces of information. The two other tabs should be left with their default values.

Checkout window

When you click on OK the checkout will begin. The progress will be displayed in the following window:

Checkout in progress

When you see the message "Success, CVS operation completed", the checkout has completed. Click on OK to dismiss the window. The source is now ready for use.

WinCVS

WinCVS is an open source CVS client for Windows, Linux and MacOS X. This piece of software has many features and can therefore be a bit overwhelming at first.

Once you have installed WinCVS, start it up. Then go to Remote --> Checkout module ...

This will bring out the Checkout Settings window. Enter the CVSROOT and the module name as shown. The other three tabs should be left at their default values.

WinCVS Checkout Settings

When you click on OK the checkout will begin. The progress will be displayed in the output window at the bottom of the application, as shown below:

WinCVS Checkout Results

When you see the message "***** CVS exited normally with code 0 *****", the checkout has completed. The source is now ready for use.