CVS Instructions

From Kietzman.org

Contents 1 Introduction 2 Profile Settings 3 Import (create new application) 4 Check out 5 Check out (previous release version) 6 Update 7 Add 8 Remove 9 Commit 10 Tag (version control)

Introduction

Concurrent Versions System (CVS) is the standard source code versioning software for the Champs team. It is a robust versioning software with many features. The CVS web tool is used to view source code changes between versions.

The following instructions are for a Unix environment.

Profile Settings

Edit the /home/<userid>/.profile file.

CVS_RSH=ssh
CVSROOT=:ext:kietzman.org:/usr/local/cvsroot
CVS_SERVER=/usr/local/bin/cvs
export CVS_RSH CVSROOT CVS_SERVER

Import (create new application)

This command will create a new application in the repository. It will do the initial creation of the relative path along with all sub-directories and files within it. The relative-app-path refers to the location that files will be placed within the CVS repository.

cvs import –m "Imported <app-name>." <relative-app-path> <app-name> start

Check out

cvs co <relative-app-path>

-- OR --

cvs co -d <local-path> <relative-app-path>

Check out (previous release version)

This will check out release version 1.0.0 of the application. It is usually best to run this command in a seperate directory. Otherwise, if run out of the real application directory it will overwrite all existing files with the release version of those files, therefore losing your current work which could be a later version.

WARNING: This will load the version into the current directory which will overwrite all existing files.

cvs co -r rel-1-0-0

Update

This will update your copy of the application with any committed changes to the repository from other users.

cvs update

Add

This command will prep an add of the file in your local copy of the application. The commit command will add it permanently to the repository.

cvs add filename

Remove

This command will prep a remove of the file in your local copy of the application. The commit command will remove it permanently from the repository.

cvs rm -f filename

Commit

This command will commit the differences between your local copy of the application and the repository copy.

cvs commit –m “<Some useful comment goes here.>”

Tag (version control)

This command will allow you to mark the current revisions of source code under one release version number.

cvs tag rel-1-0-0

NOTES

• This would mark a release version of 1.0.0 for all files associated with the application.
• The rel- should precede the version number since a release tag cannot start with a digit.
• Hyphens must be used since periods are an illegal character in a release tag.