Tunnel from CVS

From Fs_wiki

Jump to: navigation, search

Using a system called CVS (Concurrent Version System) allows you to update to the latest version of Tunnel without any effort. More importantly, CVS is very effective for backing up and sharing the work for drawing up caves, so it is something good to know.

The most effective way to use CVS under Windows is to download and install TortoiseCVS. Please do so now.

Once you have installed TortoiseCVS (and rebooted) it is now time to download Tunnel from Sourceforge, a massive repository for free software. You control TortoiseCVS using the "Windows Explorer" (not "Internet Explorer"), which is thing you use to see the directories in your file system. It's usually hidden under Start | Programs | Accessories | Windows Explorer. Find or make a directory somewhere on your system, (call it "caving" or something). Now right mouse click on it, and you will see a couple of new entries on the list of commands. One of them is called CVS Checkout. (You need to be on-line to do this, by the way.) This brings up a dialog box as follows.

Dialog box of TortoiseCVS. Only the entries from the line "Protocol:" on down need to be filled in.
Dialog box of TortoiseCVS. Only the entries from the line "Protocol:" on down need to be filled in.


Fill in (or use the drop-down box) to set the following entries
Protocol
Password server (:pserver)
This is for downloading without a password. The other kind does uploading as well
Server
tunnelx.cvs.sourceforge.net
This is the website that holds most of the free software projects in the world, including Tunnel.
Repository folder
/cvsroot/tunnelx
This is the home area for Tunnel at sourceforge.
User name
anonymous
No login or password required.
Module
tunnelx
This is the main module containing the software. Other modules include example cave data, and web pages under development.

Hit Okay and the whole of Tunnel should download in a jiffy. You can repeat for updates by right mouse clicking on the "tunnelx" directory inside the "caving" directory (it should be coloured green or marked with some other unusual notation to show that it is part of a CVS repository) and selecting the command CVS Update. This, as will be explained later, is how cave data should be shared.