WindowsXpToolsSetup

Setting Up Software Development Tools on Windows XP

Software Version Control

This project is using a Distributed Version Control System (DVCS) name Mercurial. The Mercurial code repository may be accessed from the command line or using a graphical user interface. In either case you must install the same tools.

We'll assume you have already created an account on Sourceforge and can log in. We'll also assume you have been added to the frc3748 project as a developer.

We'll be installing and using these tools on the 32-bit version of Windows XP, with the latest Microsoft updates.

Download the following two files and install them:

1. TortoiseHG - tortoisehg-2.6.1-hg-2.4.1-x86.msi - http://mercurial.selenic.com/downloads/
2. Putty - putty-0.62-installer.exe - http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

The first installer provides both command line and the file explorer access and control. The second installer is required for generating the SHH key.

SSH

Generate an SSH key by running PuTTYgen from the Start menu. Use your Sourceforge username and the mercurial server as the comment, as in myname@hg.code.sf.net. You may leave the passphrase blank but you should set a password. If you set a password this will be used to encrypt your public key file on this computer (it is not your sourceforge account password). Follow the instructions for starting Pageant (installed with PuTTY) every time you log into Windows.

Save the public and private keys to your computer, then select and copy the public key from the "Public key for pasting" window.

Go to the SSH key posting page to add this key to your account at https://sourceforge.net/account/ssh.

For help on these steps look at

• https://sourceforge.net/apps/trac/sourceforge/wiki/SSH%20keys
• http://mercurial.selenic.com/wiki/AccessingSshRepositoriesFromWindows

TortoiseHG

Create a new text file named Mercurial.ini in your profile or home directory. On Windows XP this is located at "C:\Documents and Settings\myname" (substituting your account name appropriately).

Add the following lines to this file:

[ui]
# Set the user name
username = First Last <myname@example.com>
# Configure the SSH client
ssh = tortoiseplink.exe -ssh -2 -i "C:\path\to\private\key.ppk"

Graphical User Interface

Browse to a directory where you'll keep and edit your copy of the code. Right click and select Clone from the TortoiseHG menu item.

In the dialog box enter the source "ssh://myname@hg.code.sf.net/p/frc3748/code" inserting your user name for "myname".

You now have a full copy of the repository on your local drive and can edit our code. You won't be able to share your code until you push the changes back to our shared Sourceforge repository.

Command Line Interface

Open a command line and make sure Mercurial is in your path. You can test this by entering "hg help".

Browse to a directory where you'll keep and edit your copy of the code. Enter the following command, substituting your sourceforge user name for "myname".

hg clone ssh://myname@hg.code.sf.net/p/frc3748/code C:\frc3748

You now have a full copy of the repository on your local drive and can edit our code. You won't be able to share your code until you push the changes back to our shared Sourceforge repository.