[Installation] [Adding modules] [Downloading from CVS] [Deleting files] [Adding Files] [Updating files]

CVS Basics--for the new programer

CVS & Me

Who's this for?

    A programer new-ish to the OpenSource world
    that wants create their own project on SourceForge.net

You've just learned about OpenSource,
and Linux and others and your eager to take part.
So like many you go to SourceForge.net
and register a project with the highest of hopes.
But then after that waht do you do?

You start programing of coarse,
so off you go and a few hours later you come back to your project site
with some files to upload & share.

What now?

Well your going to have to learn to use a usefull,
but difficult OpenSource tool, CVS.



Installation


Well you first install CVS on your box,
I use Slackware Linux so mine already has CVS,
but here's a tutorial for Linux, MacOSX (must have XCode installed) , Windows.


Creating or Adding Modules into a new CVS

For SourceForge.net

start up a console/shell and on the command line type:

export CVSROOT=:ext:username@cvs.sourceforge.net:/cvsroot/projectDirectory
export CVS_RSH=ssh
Where username is YOUR own username given to you by SourceForge.net

Then cd to the directory of stuff you want to upload into a "module".

(tip: a module is simply a directory,or the same thing as)

Then to actually create the new module type:
cvs import module_name authorName start
Where module_name is the name youre giving  your module,
and your name is authorName.


For RubyForge.org

Should be the same as for SourceForge.net except for:
export CVSROOT=:ext:username@cvs.sourceforge.net:/cvsroot/projectDirectory

is now:
export CVSROOT=:ext:username@rubyforge.org:/var/cvs/projectName

Downloading from your CVS repositoy

cd to the dir u want the module to be
cvs checkout moduleName


Deleting files from your CVS repository

cd to the newly downloaded module directory.
type ls, this should show  CVS, file1, file2......
want to delete file1?
rm file1
cvs delete file1
cvs commit


Adding new files to your CVS repository

cd to the dir containing files
cvs add fileName
cvs add fileTwo...
cvs commit -m "enter your log info here"

Updating files in your CVS repository

save your changed file into the directory you opened it from,
(this dirctory should  be the one you downloaded from the CVS
 repository using checkout)
if the file had been added previously then save it AS the file that was opened.
Then:
cvs update
cvs commit -m "enter your log info here"

Tutorial provided by James McCarthy contact dublinclonarf@nospam.rubyforge.net
©James McCarthy 25/8/2004
My first exsperience of CVS was when I tried to start a project on SourceForge.Net,

I had the project registered, accepted, set up the home page, trove catagorisation etc.

Finally it came time to upload my first set of files into CVS............

After spending a whole day trying to figure it out I gave up, and my project died with it.

So here I am almost a year later, and so I tried again.

It took me over 10 hours  of trying and searching for solutions on the net but I cracked it this time.

So now my project has plenty of files, possibly too many

(I went a bit mad uploading files after finding that I could).