WinCvs and Cvs file structure
This text gives a short instruction how the configuration of the file
structure and WinCvs will be in the projects (for instructions how to use WinCvs
see documentation at the WinCvs homepage). For any news according to the cvs, see the faq on this page. It is possible to use WinCVS from you home computer (if you have an internet connection of course).
NEWS & FAC:
How to run WinCvs:
- >2002-03-07WinCvs is now installed in the lab room (v403, Lab1). There is an older version of WinCvs installed in Lab9 and Lab10. You can also download the program for free from wincvs.org.
- Set preferences (Admin->Preferences):
- General -
|CVSROOT: :pserver:"username"@bilbo.mdh.se:/export/users/se/gri (i=group number)|
|Authentication: choose "passwd"-file|
- WinCvs -
|HOME Folder: select the local working folder|
You will not necessarily see your HOME folder in the browser, since this is not the same as the current folder in the browser. To browse a directory you can, for example, click on the binoculars (SWE: kikaren).
- Login (Admin->Login) - use your group password (not your usual bilbo password).
- If the browser window do not updates try to press F5.
- Checkout whole structure (Create->Checkout):
If you want to checkout the whole structure, checkout the top catalogue "project".
- Update (Select a catalogue/file and rightclick):
When you update you can in "Update Settings" select the option "Create missing directories that exist in the repository", if you want a exact copy of the structure on the repository make sure this option is selected (make also sure that the "prune option" desribed next is deselected).
When you checkout or update you can in "Globals" select or deselect the option "Prune (remove) empty directories", by selecting this you can remove empty directories from your local folder and make them non cvs files on the repository (you cannot delete them from the actual file structure, but this will not be any problem for you).
To receive the latest version of a file, right-click on it, for instance, and select
update. To checkout, for example the doc directory, you have to write the relatively
path from your root, which is project/doc.
- Checkout a previous version:
To checkout another version than the most recent version of a file:
choose checkout-checkout options-by revision/tag/branch and enter the version/branch
number. The tag-feature seems not to work properly (a bug?). However, it could be
useful to use tags, because if you right-click on a file and selects "Status
selection" you will receive a list of all versions with tags.
To checkin a file, righ-click on it and select "checkin selection" or "checkin binary" (if it is a binary file, like an executable or a doc file). Then you have to do a commit.
To commit a change, select a file, righ-click on it and select "commit selection".
- Delete a file:
Select a file and select Modify->Remove selection. Then you have to do a commit to actualy remove it.
Each group's file structure is organized in the following way (below the group root,
which is 'gr666' if you for instance are group 666):
| project/ |
The reason for this uniform structure for each group, is that is much easier for us
to verify that you are using the version control properly if all groups have the same
structure. Please follow this structure when you save files on the cvs. It should be
obvious which kinds of files that are to be stored in each directory. You are of
course allowed to create sub-structures below these directories.
The best way is to checkout the root directory 'project' and use a exactly copy of the
struture on your local directory. (Notice that, if you checkout an empty directory
in WinCvs, you do not see the directory in the browser).