|Help TOC > Instructions for DEX developers > Software > WinCVS|
|WinCVS||Date: 2008/02/26 10:50:31
WinCVS is a graphical front end tool for accessing CVS repositories. It runs on the Microsoft Windows platform. WinCvs is an advanced CVS client that provides an expert level of control over CVS operations.
Below, descriptions for two different versions of WinCVS is provided.
CVS, Concurrent Versions System, is a centralized Revision Control System (RCS).
SourceForge.net provides CVS service to all hosted projects.
In order to access the CVS service, a CVS client (like WinCVS) is needed.
CVS allows developers to keep a historical record of changes made to their source code tree,
and to allow multiple developers to work on a single set of files at the same time
without accidentally overwriting changes made by other developers.
Sourceforge CVS does not work as an ordinary CAD system where you check out a file, modify it, and checks it back in for others to modify. In Sourceforge CVS, files are never being checked out. Instead the CVS system allows concurrent editing. This means that if two different users edit the same file at the same time, a conflict will occur when the second file is being uploaded ("committed"). If this happens, Sourceforge CVS returns a message notifying the user of the conflict, and then merges the two new editions into one. It's advised to look into this file afterwards because the merging process isn't always perfect.
When you check in changes to a file, Sourceforge CVS puts a lock on that file for the duration of the check in. This is to prevent someone else checking in the file at the exact same time. As soon as the CVS system has successfully committed the changes, it removes the lock and allows others access to the file.
Sometimes the removal of the lock fails. This stops others from accessing that file. The message displayed by Sourceforge CVS when trying to access a locked file is shown below.
cvs checkout: Updating dexlib/data/dex/work_package_definition cvs checkout: [11:43:42] waiting for tim's lock in /cvsroot/dexlib/dexlib/data/dex/work_package_definition
To remove the lock on a file you need administrator access to the CVS repository. Therefore a support request must be sent to SourceForge.net team for assistance. It could take a couple of days before the request is being addressed, but given that SourceForge.net are supporting over 100,000 projects and over 1 million users (https://sourceforge.net/docs/about) with no costs, this waiting time must be considered reasonable.
Further useful information about WinCVS is found on
If you'd like to know what the mystical letters shown during update mean, have a look at (http://www.thathost.com/wincvs-howto/cvsdoc/cvs_16.html#SEC152).
The DEXlib source files are manged by the Sourceforge CVS. There is an open browsable copy of DEXlib accessible on the web (http://dexlib.cvs.sourceforge.net/dexlib/dexlib/). Here you can view each individual file, and also see its development over time (its different revisions) and the change logs describing the difference between two revisions. Be aware that it can take up to 24 hours before an update to a CVS managed file is viewable in the browable copy!
A CVS id tag can be included in the documents. This is achieved by adding;
<!-- $id $ -->
to the code where ever the string is wanted. The result will be something like;
<!-- $Id: sw_wincvs.xml,v 1.14 2008/02/26 10:50:31 mikeward Exp $ -->
This older version of WinCVS is still usable...
WinCVS is a graphical front-end for CVS (Concurrent Versions System). CVS is an open-source version control system mainly used be software developers. The instructions in step 9 below are written for version 18.104.22.168 of WinCVS. The first three bullets describe how to download the most recent version of WinCVS. If you wish to use the older 22.214.171.124 version, you can download it from (...here...), and skip these first three bullets.
WinCVS should now be installed on your computer, and an icon (a yellow fish) should be present on your desktop. (Install python?)
No setup guidence for non-developers is written for this version of WinCVS.
When the installation is completed and your computer has been restarted, WinCVS needs to be configured for access to DEXlib or STEPmod. These instructions for are valid for WinCvs 126.96.36.199.
WinCVS 188.8.131.52 was the latest available version at the time of this writing (2005-11-08).
This installation description has been copied from the Sorceforge.net document F05. To install WinCvs, first read these instructions through, then do the following:
When the installation is completed and your computer has been restarted, WinCVS needs to setup for anonymous access to the prefererred CVS module, e.g. DEXlib or STEPmod. Anonymous access will only allow you to download a module and view it, not to take part in the development process. If you instead is interested in becoming a developer, have a look at the Developers Information section.
No setup guidence for developers is written for this version of WinCVS.
See the instructions written for
If you are using WinCVS 184.108.40.206 as a developer, you're more than welcome to write a developer setup guidence document.