Before proceeding you should probably have a good read of the introduction to CVS by Jim Blandy. Reading this document should save you a lot of confusion later on.
To use the CVS server you first need to get a copy of the CVS client software for your operating system:
See http://www.cyclic.com/cvs/windows.html for more details.
See the DOS section at http://www.cyclic.com/cvs/other.html.
Many GNU/Linux distributions come with the cvs client packaged as part of the distribution. If you don't have it installed check your install CDs or check the ftp site for the distribution in question.
See http://www.cyclic.com/cvs/mac.html for more details.
If you are building Harbour with an operating system not listed then please contact the FAQ maintainer with full details so that this list can be updated.
Once you have got your CVS client installed you can gain anonymous access to
the Harbour CVS server. Depending on platform, the first thing you need to
do is set the CVSROOT
environment variable to:
:pserver:anonymous@cvs.harbour-project.sourceforge.net:/cvsroot/harbour-project
In addition to the above some environments might require extra information.
For example, the DOS, Windows and OS/2 CVS clients need to be given two
extra environment variables, HOMEDRIVE
and HOMEPATH
. These two
environment variables tell the CVS client where the source will live
locally. For example, if your Harbour development directory is at
S:\FREESOFT\HARBOUR you'd set:
SET HOMEDRIVE=S
SET HOMEPATH=\FREESOFT\HARBOUR\
Users of the Windows client have reported that the HOMEPATH
environment
variable must start with and finish with a directory separator. Users of the
DOS client have reported that the HOMEDRIVE
environment variable must
end with a colon.
Ensure that your harbour directory is created and change into it. Then run:
cvs login
and press enter when prompted for a password. Now run:
cvs extract -P harbour
to get a copy of the Harbour CVS repository (users of the DOS client have
reported that it doesn't have the extract
command and that the
checkout
command should be used instead, I'm also told that the cvs
client on GNU/Linux requires that you use checkout
).
Note: The CVS commands and directories are case sensitive: harbour
must be in all lower case (also note that on SourceForge Harbour is known as
"harbour-project").
Later, when you want to get changes from the CVS, you can do one of two things:
extract
command from your Harbour directory.cvs update
'.If you have problems after reading the above please consider reading the CVS introduction and also the documentation for the CVS client you've installed. If, after reading both those documents, you are still having problems you should drop a polite message into the developer's mailing list detailing your platform, environment, all the steps you performed and the exact nature of the problem.