Difference between revisions of "Source Code"

Revision as of 19:52, 8 November 2010

Source code, scripts, and configuration files for the Houpt Lab's software, servers and meta-cortex are all stored in the Houpt Lab Source Code Repository. The repository uses the Subversion version control system, and associated software. The Subversion Book is a good introduction and reference to the world of Subversion.

Houpt Lab Repository Access

The Houpt Lab Subversion server is accessed with the following URL:

svn+ssh://houptlab.org/svnroot/

Browsing the Repository

The repository can be viewed from any web browser using the WebSVN interface at:

Houpt Lab Source Code Repository

Mac OS X Client Setup (10.6+)

All the software and scripts for setting up an Subversion client are available on LabDisk in the Software/Subversion folder.

Subversion Setup

Subversion is included with XCode, so install XCode.

Basic Operations with XCode

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

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

Consult the XCode section on Version Control for details on using XCode with Subversion.

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

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

Run the Create SSH Key script to generate public and private keys for the current user.

Run the Install Public SSH Key script to copy the public key to the Subversion server (houptlab.org).

Server Setup

The sever is currently running 10.4, which doesn't ship with Subversion. The 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.

@@ Line 13: / Line 13: @@
 [{{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.
@@ Line 19: / Line 19: @@
 ===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.
-Run the [{{SERVER}}/LabDisk/CEHoupt/Software/Subversion/Install%20usr-local-bin%20on%20PATH.command Install usr-local-bin on PATH] script to ensure that /usr/local/bin is placed on the PATH environment variable by modifying the account's .bash_profile.
+==Basic Operations with 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.
-===Importing Projects===
+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).
-To import a project folder into the Subversion repository, drag the project folder from the Finder and drop it in the ZigVersion browser window at the desired location (typically under the repository root).
+==Server Setup==
-==Basic Operations with XCode==
+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.
-==Server Setup==
-A test to see if Wiki can be updated with mediawiki 1.13.3.