Retrieve/update recent source/document files using with CVS

Introduction

CVS is 'Concurrent Versions System'. CVS manages version of files.

CVS keeps a single copy of the master files. This copy is called the "repository"; It contains all the information of all files and revision history.

All source/document files of FreeSC/SCDIS are maintained by CVS. And the repository is maintained by sourceforge.net. The repository is public opened, so you can retrieve all files and view the revision history by accessing the repository.

How to use CVS (for Windows)

Install WinCVS

First, you need install CVS. There are some GUI tools for CVS and I recommend 'WinCVS'. You can get it from http://www.wincvs.org/. Get it and install.

Specify the repository

When startup the WinCVS, you see following dialog. (This dialog can be displayed from 'Admin' - 'Preferences'.)

Click the General tab, and enter the repository position.

Enter the following string in 'Enter the CVSROOT'. This is repository position. 

anonymous@cvs.freesc.sourceforge.net:/cvsroot/freesc
And select '"passwd" file on the cvs server' for 'Authentication'.

Check-out files

Next, check out files from repository. Specify folder into which extract files.

Select 'Create' - 'Checkout module' and click OK.

Following dialog is displayed.

Enter module name in 'Enter the module name and path on the server'.

Click the OK button, and all files will be extracted.

Update files

The repository is frequently updated. You can updated your extracted files.

For example, update source codes of FreeSC. Select folder and right click.

Then click 'Update selection'.

View file log

To view the file log (revision history), select file and right click the mouse button. Then select 'Log selection'.

View difference between two revisions

To view difference between two revisions, right click the file and select 'Diff selection'.

Select 'Compare two revisions/tag/branches/dates', and enter revision or date and click OK.

Use with UNIX

First set CVSROOT environment variable. 

setenv CVSROOT :pserver:anonymous@cvs.freesc.sourceforge.net:/cvsroot/freesc
Next, long the CVS server. 
cvs login
Password is not needed.

To checkout the files, 

cvs checkout fsc
To update the files, 
cvs update

Commit files to repository

Committing files to the repository is permitted only repository administrator.

If you satisfy all following check list, and want to commit the repository directly, please apply me for access permission by mail. I will decide that you are appropriate for administrator, then I give you permission.

  1. I wrote/modified more than one source/document files and sent them to author.
  2. That files were adopted officially.
  3. Subscribes mailing-list and sometimes post mail to it.
  4. I can use (or learn to use) SSH (Secure Shell) by myself.
Takuya Murakami - tmurakam@freesc.org