= Version Control =

== Subversion ==

=== About Subversion ===
From [http://http://en.wikipedia.org/wiki/Subversion_(software) Wikipedia]:

  '''Subversion''' ('''SVN''') is a [http://en.wikipedia.org/wiki/Revision_control version control] system initiated in 2000 by [http://en.wikipedia.org/wiki/CollabNet CollabNet] Inc. It is used to maintain current and historical versions of files such as [http://en.wikipedia.org/wiki/Source_code source code], web pages, and documentation. Its goal is to be a mostly-compatible successor to the widely used [http://en.wikipedia.org/wiki/Concurrent_Versions_System Concurrent Versions System] (CVS).

  Subversion is well-known in the open source community and is used on many open source projects, including [http://en.wikipedia.org/wiki/Apache_Software_Foundation Apache Software Foundation], [http://en.wikipedia.org/wiki/KDE KDE], [http://en.wikipedia.org/wiki/GNOME GNOME], [http://en.wikipedia.org/wiki/Free_Pascal Free Pascal], [http://en.wikipedia.org/wiki/FreeBSD FreeBSD], [http://en.wikipedia.org/wiki/GNU_Compiler_Collection GCC], [http://en.wikipedia.org/wiki/Python_(programming_language) Python], [http://en.wikipedia.org/wiki/Django_(web_framework) Django],[http://en.wikipedia.org/wiki/Ruby_(programming_language) Ruby], [http://en.wikipedia.org/wiki/Mono_(software) Mono], [http://en.wikipedia.org/wiki/SourceForge.net SourceForge.net], [http://en.wikipedia.org/wiki/ExtJS ExtJS] and [http://en.wikipedia.org/wiki/Tigris.org Tigris.org]. [http://en.wikipedia.org/wiki/Google_Code Google Code] also provides Subversion hosting for their open source projects. [http://en.wikipedia.org/wiki/BountySource BountySource] systems use it exclusively. [http://en.wikipedia.org/wiki/Codeplex Codeplex] offers access to both subversion as well as other types of clients.

  Subversion is also being adopted in the corporate world. In a 2007 report by [http://en.wikipedia.org/wiki/Forrester_Research Forrester Research], Subversion was recognized as the sole leader in the Standalone Software Configuration Management (SCM) category and a strong performer in the Software Configuration and Change Management (SCCM) category.^[http://en.wikipedia.org/wiki/Subversion_(software)#cite_note-0 "[1]"]^

  Subversion is released under the [http://en.wikipedia.org/wiki/Apache_License Apache License], making it [http://en.wikipedia.org/wiki/Free_software free software].

=== Subclipse for Eclipse ===
Subclipse is an Eclipse Team Provider plug-in providing support for Subversion within the Eclipse IDE. The software is released under the Eclipse Public License (EPL) 1.0 open source license. Using Subclipse we can fully integrate a subversion client in Eclipse.

If you are using the Cardinal provided VMWare development environment Subclipse is already installed.

==== Installing Subclipse ====
1. Start Eclipse and choose '''Help -> Software Updates -> Find and Install'''.

  [[Image(screenshot.1.jpeg)]]

2. Choose Search for new features to install and press '''Next >'''.

  [[Image(screenshot.3.jpeg)]]

3. Click '''New Remote Site...''', enter the data in the screenshot, and press '''OK'''.

  [[Image(screenshot.2.jpeg)]]

4. Press '''Finish'''.

  [[Image(screenshot.4.jpeg)]]

5. Eclipse will search for updates.

  [[Image(screenshot.5.jpeg)]]

6. Choose the selections shown in the screenshot and press '''Next >'''.

  [[Image(screenshot.7.jpeg)]]

7. Click '''I accept the terms in the license agreement''' and press '''Next >'''.

  [[Image(screenshot.6.jpeg)]]

8. Press '''Finish'''.

  [[Image(screenshot.8.jpeg)]]

9. Eclipse will download and install Subclipse.

  [[Image(screenshot.9.jpeg)]]

10. Choose '''Install All''' when the dialog appears.

  [[Image(screenshot.10.jpeg)]]

11. Choose '''Yes''' when the dialog appears.

  [[Image(screenshot.11.jpeg)]]

12. Eclipse will restart and Subclipse is now installed.

===== Importing Projects Using Subclipse =====
1. Right-click in the Project Explorer and choose '''New -> Other'''

  [[Image(co_screenshot.1.jpeg)]]

2. Choose '''Checkout Projects from SVN''' under the '''SVN''' folder and press '''Next >'''.

  [[Image(co_screenshot.2.jpeg)]]

3. Choose '''Create a new repository location''' and press '''Next >'''.

  [[Image(co_screenshot.3.jpeg)]]

4. Enter the SVN url in the '''Url:''' box. The screenshot shows a checkout of the lib825 project.

  [[Image(co_screenshot.4.jpeg)]]

5. Choose the '''trunk''' folder which is the folder that contains the latest source and press '''Finish'''. Alternatively, you could choose a sub-folder of '''tags''' which has previous release versions.

  [[Image(co_screenshot.5.jpeg)]]

6. The project will be checked out and imported into Eclipse.

  [[Image(co_screenshot.6.jpeg)]]

  [[Image(co_screenshot.7.jpeg)]]

  [[Image(co_screenshot.8.jpeg)]]