TortoiseCVS

From Audacity Wiki
Jump to: navigation, search
Audacity used to use CVS  to manage its source code . This has changed and we now use SVN. This page is of historical interest.
 
Related article(s):

Using Tortoise CVS to commit source code (official SourceForge documentation):


WIP.png Audacity is of course now hosted on GitHub, not SVN or CVS and this page needs revision to reflect that.


Description

TortoiseCVS context menu in Windows Explorer
TortoiseCVS works under Windows 95, 98, ME (although these are no longer officially supported), NT, 2000, XP and Server 2003. Vista is also not officially supported but works generally speaking, although some users report problems with Vista's User Account Control.

TortoiseCVS works with CVS files directly within Windows Explorer, including checking out, updating and committing modules, and viewing differences. The client is accessed in Explorer via a context menu when you right-click over a file or folder, or with File > Open. The current state of a file is displayed as an overlay on top of your normal icons in Explorer.


Tutorials

Checking out Audacity as anonymous

  • Download TortoiseCVS and install it. On Vista, choose the installer option to close Explorer windows manually, and close all such windows before proceeding, otherwise Tortoise may not install properly.
  • Create a new folder to store Audacity files.
  • Right-click it and choose CVS Checkout....
  • Copy and paste the following string to the CVSROOT field.
:pserver:[email protected]:/cvsroot/audacity
  • Press the Fetch list... button on the right-bottom corner to get the available modules from the server.
  • Double click audacity (starting with a lowercase) module from the list.
  • If you want to checkout the latest version (1.2) instead of the latest development source code, these additional steps are required:
    • Go to the Revision tab and under Branch or tag, select Choose branch or tag
    • Press the Update list... button.
    • Point to the dropdown box and choose AUDACITY_1_2
  • Press OK.

Committing Audacity code changes

This tutorial was left incomplete by the author : please help us finish it!


These are one user's steps using TortoiseCVS 1.8.22 to commit changes to Audacity source code. There are more security implications in revising the source code than simply doing a read-only Checkout and Update with an anonymous login.

The following assumptions apply:

  • You have a SourceForge  ID which for the purposes of this tutorial is newbie_sandbox
  • Your SourceForge password is newbiepassword
  • You have requested and received write permission as a developer to the audacious cvs repository (granted by Project Manager). This is an inactive stub project that was part of a temporary fork of the Audacity project for specialized preparation of mono speech files.
  • You want to make changes to the relatively harmless file sandbox.txt and want to 'commit' the changes.
  • You are reasonably proficient with Windows Explorer and on setting Windows environment variables .
  • You have a reasonably standard Windows XP or 2000 installation with the environment variable TEMP defined to be C:\Temp


These steps worked for me...

  1. Install TortoiseCVS 
  2. Open Explorer (for example by right-clicking over the Windows Start button and hitting "Explore")
  3. Create a subdirectory in your Temp directory called C:\Temp\audacious

to be completed.....

Advanced Tips

Update Special

Right-click on a CVS file or folder and CVS > Update Special to fetch that file or folder to match with a particular tag/branch/revision, or before a specific date/time. So if you enter or choose a date without specifying a time (such as "22 Nov 2009"), it retrieves the latest version as at 23:59 on 21 November 2009.

Warning icon Note: Once you retrieve a version of a file or folder with a specific tag or date, that is "stickied". This means that even if you delete the file or folder and use the normal right-click CVS Update command, you will still always retrieve that specific version. To reset the sticky and get the latest version again, right-click and choose CVS > Command, enter "update -A" (without quotes) and hit OK.