Changes

[{{SERVER}}/cortex/websvn/ Houpt Lab Source Code Repository]

[{{SERVER}}/cortex/websvn/ Houpt Lab Source Code Repository]

==Mac OS X Client Setup==

==Mac OS X Client Setup (10.6+)==

All the software and scripts for setting up an Subversion client are available on LabDisk in the [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/ Software/Subversion] folder.

All the software and scripts for setting up an Subversion client are available on LabDisk in the [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/ Software/Subversion] folder.

===Subversion Setup===

===Subversion Setup===

Install the [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/Subversion%201.4.4-2%20Universal.dmg Subversion client] package, which places the Subversion command line tools on the local Mac in /usr/local/bin.

Subversion is included with XCode, so install XCode.

To confirm that Subversion is correctly installed and available on the PATH, open a Terminal window and execute the follow command to display the version number.

In the XCode Preference, setup access to the HouptLab repository like this:

$ svn --version

[[Image:XCode-Subversion-Setup.png|XCode Repository Preferences for HouptLab]]

===Secure Shell (SSH) Public-Key Encryption Setup===

To import and checkout project directories, use the Repository window (SCM > Repositories):

Run the  [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/Create%20SSH%20Key.command Create SSH Key] script to generate public and private keys for the current user.

[[Image:XCode-Repository.png|XCode Repository Preferences for HouptLab]]

Run the [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/Install%20Public%20SSH%20Key.command Install Public SSH Key] script to copy the public key to the Subversion server (houptlab.org).

Consult the [http://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/XcodeSourceManagement/10-Introduction/introduction.html XCode section on Version Control] for details on using XCode with Subversion.

==Basic Operations with ZigVersion==

===Command-Line and Secure Shell (SSH) Public-Key Encryption Setup===

ZigVersion (zigzig.com is offline) is a well-designed Mac OS X Subversion client. A local copy of ZigVersion can be found on LabDisk in the [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/ Software/Subversion Folder]. ZIgVersion requires a License Code after the 30-day Demo.

To use Subversion over SSH from the command-line, it is useful to setup SSH keys for password-less login.

[{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/ZigVersion%20License%20Code.txt Houpt Lab Non-Commercial ZigVersion License Code]

Run the  [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/Create%20SSH%20Key.command Create SSH Key] script to generate public and private keys for the current user.

The sever is currently running 10.4, which doesn't ship with Subversion. The [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/Subversion%201.4.4-2%20Universal.dmg Subversion client] package is installed, which places the Subversion command line tools on the local Mac in /usr/local/bin. Symbolic links are setup in /usr/bin so that Subversion commands are available on the default path.

 

Although XCode supports many Subversion operation, it doesn't support checking out (or importing) a project directory. So, to checkout an existing project directory, use 'svn checkout' from a Terminal. For example, use the following to checkout the 'testproj' directory from the repository and place it in the 'testproj-work' folder in your home directory:

 

$ svn checkout svn+ssh://houptlab.org/svnroot/testproj ~/testproj-work

 

Now open ~/testproj-work/testproj.xcodeproj, and use it normally (change, add, delete, rename files, etc).

 

Consult the [http://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/XcodeSourceManagement/10-Introduction/introduction.html XCode section on Version Control] for details on using XCode with Subversion.

 

A test to see if Wiki can be updated with mediawiki 1.13.3.