====== Subversion ======

[[http://subversion.apache.org/|Subversion]] is a popular free [[http://en.wikipedia.org/wiki/Revision_control|revision control system]]. A revision control system lets you keep track of new versions of a file, to track changes and to revert back to earlier versions.

Using a revision control system has many advantages:

  * [[Project|Projects]] with many authors can be “shared” and worked on by several authors simultaneously.
  * When there are many users of a [[Project|project]], they can easily access the latest version.
  * The full revision history of a document is stored. That way all changes can be tracked and old revisions can be recovered.
  * The [[Project|project]] is stored in a single location, thus avoiding scattering different versions on different machines. Also, the [[Project|project]] is accessible from anywhere where there is internet.

===== Subversion support in Ecolego =====

Ecolego allows users to [[Checkout|checkout]] projects and [[Commit|commit]] projects directly from the [[File_menu|File menu]].

Before the Subversion functionality can be used you must [[Setting_up_a_Subversion_repository|set up the Subversion repository connection]].

===== Commit a project =====

==== Putting a fresh project under version control ====

To put a project under version control means that you register it with a Subversion repository and submit it’s data to the repository server. This is equivalent of the file system “Save As” operation.

  - Open the [[Project|project]]
  - Make sure that the [[Preferences|connection settings]] are set for the repository you wish to use.
  - Select **File | Subversion | Commit project** from the file menu. You will be asked if you want to add it to the repository.
  - Select a folder in the **Repository** file system.
  - Click **Ok**.
  - Enter a comment if you wish, and press **Ok**.

==== Subsequent commits ====

Once a [[Project|project]] has been registered with a Subversion repository, information about the Subversion repository is stored in the [[Project|project]]. After the initial commit (“Save As”), every subsequent commit corresponds to the file system “Save” operation.

That means that the second time you commit a [[Project|project]] you will not be prompted for a location in the repository.

Every time you commit to the repository it is highly recommended that you write a comment (when prompted) that describes the changes you have made to the [[Project|project]]. This will help others that work on the same [[Project|project]] see what has been changed and will also help you if you need to backtrack to an earlier version.

===== Checkout =====

To [[Checkout|checkout]] a [[Project|project]] corresponds to the file system “Open” operation.

  - Select **File | Subversion | Checkout** from the [[Menu_bar|main menu]].
  - A window appears which displays the different folders of the Subversion repository. Browse to the project file you wish to [[Checkout|checkout]] and click **Ok**.

==== Checkout of an earlier version ====

Underneath the **Repository** file system tree there is a list named **History**. When you select a [[Project|project]] file in the repository, every earlier version of the [[Project|project]] is listed here. Select the version that you wish to checkout from this list and click **Ok**.

===== See also =====

  * [[Setting_up_a_Subversion_repository|Setting up a Subversion repository]]
  * [[Checkout|Checkout a project]]
  * [[Commit|Commit a project]]

===== References =====

  * [[http://subversion.apache.org/|Subversion]]
  * [[http://tortoisesvn.tigris.org/|Turtoise SVN]]