Difference between revisions of "OtfSubversion"

From emotive
Jump to navigation Jump to search
 
Line 1: Line 1:
 
{{DISPLAYTITLE:Open Test Framework - Subversion (Version Control)}}[[Category:OTF]]
 
{{DISPLAYTITLE:Open Test Framework - Subversion (Version Control)}}[[Category:OTF]]
  
−
==Overview==
+
== Overview ==
−
This page will give you a short introduction of the '''Subversion''' feature in the OTF. The OTX documents may be used and revised by many people. The version control may be the most suitable solution for managing the changes. In the OTF, the Subversion manages OTX documents and packages, and even a project or the whole solution, and the changes made to them, over time. This allows you to recover older versions of your data or examine the history of how your data changed. With this tool the users may avoid problems when working concurrently - and perhaps even simultaneously on the very same documents.
+
This page will give you a short introduction of the '''Subversion''' (SVN) feature in the OTF. The OTX documents may be used and revised by many people. The version control may be the most suitable solution for managing the changes. In the OTF, the Subversion manages OTX documents and packages, and even a project or the whole solution, and the changes made to them, over time. This allows you to recover older versions of your data or examine the history of how your data changed. With this tool the users may avoid problems when working concurrently - and perhaps even simultaneously on the very same documents.
  
 
The OTF supports uploading your projects or solutions to a Subversion server (repository), or performing Subversion tasks with the files in a repository. This feature is supported by the [http://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html '''TortoiseSVN'''] (a free open-source Windows subversion client for the Apache™ Subversion® version control system).
 
The OTF supports uploading your projects or solutions to a Subversion server (repository), or performing Subversion tasks with the files in a repository. This feature is supported by the [http://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html '''TortoiseSVN'''] (a free open-source Windows subversion client for the Apache™ Subversion® version control system).
  
−
{{Note|The OTF setup files do not include the TortoiseSVN, you have to install it separately. See [http://tortoisesvn.net/downloads.html here] for the setup files.}}
+
{{Note|The OTF setup files do not include the TortoiseSVN, you have to install it separately. See [http://tortoisesvn.net/downloads.html '''here'''] for the setup files.}}
  
−
==Adding a solution (or a project) to Subversion==
+
== Adding a Solution (or a project) to Subversion ==
 
To add a solution (or a project) to Subversion, please proceed as follows:
 
To add a solution (or a project) to Subversion, please proceed as follows:
  
−
# Right-click on the solution node (or the project node).
+
# Right click on the solution node (or the project node).
 
# Select "'''Add Solution to Subversion'''" menu entry (or "'''Add Selected Project to Subversion'''" menu entry).
 
# Select "'''Add Solution to Subversion'''" menu entry (or "'''Add Selected Project to Subversion'''" menu entry).
−
# In the "'''URL of repository'''" combo-box, enter the URL of the repository or you can select from the combo-box if there already exists any URL.
+
# In the "'''URL of repository'''" combo box, enter the URL of the repository or you can select from the combo box if there already exists any URL.
−
# In the "'''Import message'''" text-box, Enter the messages.
+
# In the "'''Import message'''" text box, enter the messages.
 
# Click "'''OK'''" button.
 
# Click "'''OK'''" button.
−
# Enter the "'''Username'''" and the "'''Password'''" (You can also check the "'''Save authentication'''" check-box sothat you do not have to input the username and the password next time you perform svn tasks).
+
# Enter the "'''Username'''" and the "'''Password'''" (You can also check the "'''Save authentication'''" check box so that you do not have to input the username and the password next time you perform SVN tasks).
 
# Click "'''OK'''" button.
 
# Click "'''OK'''" button.
  
−
==Checking out a solution (or a project) from the Subversion==
+
== Checking-out a Solution (or a project) from the Subversion ==
 
To check out a solution (or a project), please proceed as follows:
 
To check out a solution (or a project), please proceed as follows:
  
 
# Click on the "'''Check out all'''" button in the "'''Version Control'''" tab of the [[OtfMenuBar|Ribbon]].
 
# Click on the "'''Check out all'''" button in the "'''Version Control'''" tab of the [[OtfMenuBar|Ribbon]].
−
# In the "'''URL of repository'''" combo-box, enter the URL of the solution folder (or project folder) in the repository. You can click on the "'''...'''" button on the right to open the "'''Repository Browser'''" (username and password may be required) where you can browse and select a solution folder (or project folder) in the repository.
+
# In the "'''URL of repository'''" combo box, enter the URL of the solution folder (or project folder) in the repository. You can click on the "'''...'''" button on the right to open the "'''Repository Browser'''" (username and password may be required) where you can browse and select a solution folder (or project folder) in the repository.
−
# In the "'''Check out directory'''" combo-box, enter the path of folder to check out files. You can click on the "'''...'''" button to browse and select folder in the file system. Note that the folder should have no content!
+
# In the "'''Check out directory'''" combo box, enter the path of folder to check out files. You can click on the "'''...'''" button to browse and select folder in your computer. Note that the folder should have no content!
−
# It is recommended to leave the other settings the same but you can also adjust the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-checkout.html here] for details).
+
# It is recommended to leave the other settings the same but you can also adjust them as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-checkout.html '''here'''] for more information).
 
# Click "'''OK'''" button.
 
# Click "'''OK'''" button.
−
# After the Progress dialog box finished the process, click "'''OK'''" button.
+
# After the Progress dialog box has finished, click "'''OK'''" button.
−
# Now you can load and use the svn solution (or project) in the OTF.
+
# Now you can load and use the SVN solution (or project) in the OTF.
  
 
{{Anchor|Update|}}
 
{{Anchor|Update|}}
−
==Updating the changes==
+
== Updating Changes ==
 
You can update a document, a package, a project or a solution to the lastest revision. Please proceed as follows:
 
You can update a document, a package, a project or a solution to the lastest revision. Please proceed as follows:
  
−
# Right-click on the node you want to update e.g. a package node (If you want to update all solution, you can also click on the button "'''Update all'''" in the "'''Version Control'''" tab of the [[OtfMenuBar|Ribbon]]).
+
# Right click on the node you want to update e.g. a package node (If you want to update all solution, you can also click on the button "'''Update all'''" in the "'''Version Control'''" tab of the [[OtfMenuBar|Ribbon]]).
 
# Select "'''Update to lastest version'''" menu entry.
 
# Select "'''Update to lastest version'''" menu entry.
 
# At this step the repository may require to input the username and password, input the required information and click "'''OK'''" button.
 
# At this step the repository may require to input the username and password, input the required information and click "'''OK'''" button.
Line 41: Line 41:
 
To update an element to a particular revision, please proceed as follows:
 
To update an element to a particular revision, please proceed as follows:
  
−
# Right-click on the node you want to update e.g. a package node.
+
# Right click on the node you want to update e.g. a package node.
 
# Select "'''Version Control (Subversion)'''" menu entry, and then select "'''Update to revision...'''" menu entry.
 
# Select "'''Version Control (Subversion)'''" menu entry, and then select "'''Update to revision...'''" menu entry.
 
# Enter the revision you want to update, or click on "'''Show log'''" button to select a revision (username and password may be required).
 
# Enter the revision you want to update, or click on "'''Show log'''" button to select a revision (username and password may be required).
−
# You can adjust the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html here] for details).
+
# You can adjust the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html '''here'''] for more information).
 
# Click "'''OK'''" button.
 
# Click "'''OK'''" button.
 
# After the Progress dialog box finished the process, click "'''OK'''" button.
 
# After the Progress dialog box finished the process, click "'''OK'''" button.
  
−
==Committing the changes==
+
== Committing Changes ==
 
You can commit the changes in a document, a package, a project or a solution to the repository. Please proceed as follows:
 
You can commit the changes in a document, a package, a project or a solution to the repository. Please proceed as follows:
  
−
# Before committing the changes, it is recommended to update the element to the lastest version, see [[#Update|above]].
+
# Before committing the changes, it is recommended to save the changes and update the element to the lastest version, see [[#Update|above]].
−
# Right-click on the node you want to commit changes e.g. a package node (If you want to commit all the changes in the solution, you can also click on the button "'''Check in all'''" in the "'''Version Control'''" tab of the [[OtfMenuBar|Ribbon]]).
+
# Right click on the node you want to commit changes e.g. a package node (If you want to commit all the changes in the solution, you can also click on the button "'''Check in all'''" in the "'''Version Control'''" tab of the [[OtfMenuBar|Ribbon]]).
 
# Select "'''Commit...'''" menu entry.
 
# Select "'''Commit...'''" menu entry.
 
# At this step the repository may require to input the username and password, input the required information and click "'''OK'''" button.
 
# At this step the repository may require to input the username and password, input the required information and click "'''OK'''" button.
−
# In the "'''Message'''" text-box, enter the message about the changes.
+
# In the "'''Message'''" text box, enter the message about the changes.
−
# In the "'''Changes made'''" pane, check the on the changed nodes which will be committed (You can see and modify the details of the changes by double-clicking on the node).
+
# In the "'''Changes made'''" pane, check the on the changed nodes which will be committed (You can see and modify the details of the changes by double clicking on the node).
−
# You can adjust the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-commit.html here] for details).
+
# You can adjust the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-commit.html '''here'''] for more information).
 
# Click "'''OK'''" button.
 
# Click "'''OK'''" button.
 
# At this step the repository may require to input the username and password, input the required information and click "'''OK'''" button.
 
# At this step the repository may require to input the username and password, input the required information and click "'''OK'''" button.
 
# After the Progress dialog box finished the process, click "'''OK'''" button.
 
# After the Progress dialog box finished the process, click "'''OK'''" button.
  
−
==Undoing changes==
+
== Reverting Changes ==
−
The Undo command in the OTF only supports to undo each single change and it can only undo the changes with elements within a document. With the Subversion, you can undo all the changes to a document, a package, a project or a solution since the last update. Please proceed as follows:
+
The Undo command in the OTF only supports to undo each single change and it can only undo the changes with elements within a document. With the Subversion, you can undo (revert) all the changes to a document, a package, a project or a solution in Subversion since the last update. Please proceed as follows:
  
−
# Right-click on the node you want to undo changes e.g. a package node.
+
# Right click on the node you want to undo changes e.g. a package node.
 
# Select "'''Revert...'''" menu entry.
 
# Select "'''Revert...'''" menu entry.
−
# In the "'''Message'''" text-box, enter the message about the changes.
+
# In the "'''Message'''" text box, enter the message about the changes.
−
# Select all the elements that you want to revert (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-revert.html#tsvn-dug-revert-dia-1 here] for details).
+
# Select all the elements that you want to revert (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-revert.html#tsvn-dug-revert-dia-1 '''here'''] for more information).
 
# Click "'''OK'''" button.
 
# Click "'''OK'''" button.
 
# After the Progress dialog box finished the process, click "'''OK'''" button.
 
# After the Progress dialog box finished the process, click "'''OK'''" button.
  
−
==Subversion commands summary==
+
== Subversion Commands Summary ==
−
To perform the Subversion tasks on a document, a package, a project or a solution, right-click on the corresponding node in the [[OtfSolutionExplorer|Solution Explorer]] and select the desired Subversion command in the context menu. Below are the short descriptions for the Subversion commands in the OTF:
+
To perform the Subversion tasks on a document, a package, a project or a solution in Subversion, right click on the corresponding node in the [[OtfSolutionExplorer|Solution Explorer]] and select the desired Subversion command in the context menu. Below are the short descriptions for the Subversion commands in the OTF:
  
 
{|{{TableHeader}}
 
{|{{TableHeader}}
 
|- style="background: gray; color: white; vertical-align:top;'''"  
 
|- style="background: gray; color: white; vertical-align:top;'''"  
 
| '''Command''' || style="width:660px;" | '''Description'''
 
| '''Command''' || style="width:660px;" | '''Description'''
 +
|-{{TableRow1}}
 +
| '''Update to lastest version''' || style="width:660px;" | Updates the node and all sub-nodes to the lastest revision.
 +
|-{{TableRow2}}
 +
| '''Commit...''' || style="width:660px;" | Commits the changes of the node to the Subversion.
 +
|-{{TableRow1}}
 +
| '''Diff...''' || style="width:660px;" | Opens the TortoiseMerge window look at the code differences between two revisions of the same file (see [https://tortoisesvn.net/docs/nightly/TortoiseMerge_en/help-onepage.html#tmerge-intro '''here'''] for more information).
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Update to lastest version''' || style="width:660px;" | Updates the node and all sub-nodes to the lastest revision.
+
| '''Revert...''' || style="width:660px;" | Reverts all the changes of the node back to last update.
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Commit...''' || style="width:660px;" | Commits the changes of the node to the Subversion.
+
| '''Version Control (Subversion) > Add...''' || style="width:660px;" | Adds the nodes and its sub-nodes to the version control.
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Diff...''' || style="width:660px;" | Opens the WinMerge dialog box look at the code differences between two revisions of the same file (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-diff.html#tsvn-dug-diff-tools here] for details).
+
| '''Version Control (Subversion) > Add to ignored list...''' || style="width:660px;" | Adds the node and its sub-nodes to the ignored list which will not be subject to version control (click [https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-ignore.html '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Revert...''' || style="width:660px;" | Reverts all the changes of the node back to last update.
+
| '''Version Control (Subversion) > Remove from ignored list...''' || style="width:660px;" | Removes the node and its sub-nodes from the ignored list.
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Show log''' || style="width:660px;" | Opens the Revision Log dialog box to show the revision log of the node (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-showlog.html here] for details).
+
| '''Version Control (Subversion) > Show log''' || style="width:660px;" | Opens the Revision Log dialog box to show the revision log of the node (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-showlog.html '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Repository browser''' || style="width:660px;" | Open the Repository Browser dialog box, locates the node in the repository (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-repobrowser.html here] for details). You can also view the current project (with the project node or sub-node selected in the [[OtfSolutionExplorer|solution explorer]]) in the Repository Browser by clicking the "SVN Project Manager" button in the "Version Control" tab of the [[OtfMenuBar|Ribbon]].
+
| '''Version Control (Subversion) > Repository browser''' || style="width:660px;" | Opens the Repository Browser dialog box, locates the node in the repository (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-repobrowser.html '''here'''] for more information). You can also view the current project (with the project node or sub-node selected in the [[OtfSolutionExplorer|solution explorer]]) in the Repository Browser by clicking the "SVN Project Manager" button in the "Version Control" tab of the [[OtfMenuBar|Ribbon]].
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Check for modifications...''' || style="width:660px;" | Shows log about which files have been changed and committed (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-wcstatus.html#tsvn-dug-wcstatus-dia-2 here] for details).
+
| '''Version Control (Subversion) > Check for modifications...''' || style="width:660px;" | Shows log about which files have been changed and committed (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-wcstatus.html#tsvn-dug-wcstatus-dia-2 '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Revision graph...''' || style="width:660px;" | Shows where branches and tags were taken from the trunk in a graph or tree structure (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-revgraph.html here] for details).
+
| '''Version Control (Subversion) > Revision graph...''' || style="width:660px;" | Shows where branches and tags were taken from the trunk in a graph or tree structure (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-revgraph.html '''here'''] for more information).
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Update to revision...''' || style="width:660px;" | Updates the node and all sub-nodes to a specific revision (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html here] for details).
+
| '''Version Control (Subversion) > Update to revision...''' || style="width:660px;" | Updates the node and all sub-nodes to a specific revision (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Branch...''' || style="width:660px;" | Opens the Branch/Tag dialog box to isolate changes onto a separate branch (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-branchtag.html here] for details).
+
| '''Version Control (Subversion) > Branch...''' || style="width:660px;" | Opens the Branch/Tag dialog box to isolate changes onto a separate branch (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-branchtag.html '''here'''] for more information).
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Switch...''' || style="width:660px;" | Opens the Switch dialog box to transfer the changed data from the desired branch (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-branchtag.html#tsvn-dug-switch-1 here] for details).
+
| '''Version Control (Subversion) > Switch...''' || style="width:660px;" | Opens the Switch dialog box to transfer the changed data from the desired branch (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-branchtag.html#tsvn-dug-switch-1 '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Merge...''' || style="width:660px;" | Opens the Merge dialog box to merge range of revision or merge two different trees (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-merge.html here] for details).
+
| '''Version Control (Subversion) > Merge...''' || style="width:660px;" | Opens the Merge dialog box to merge range of revision or merge two different trees (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-merge.html '''here'''] for more information).
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Export...'''{{TooltipIcon2|(Note: This command is for the package, project and solution only)}} || style="width:660px;" | Copy the node and sub-nodes to a new location without the .svn directory.
+
| '''Version Control (Subversion) > Export...'''{{TooltipIcon2|(Note: This command is for the package, project and solution only)}} || style="width:660px;" | Copies the node and sub-nodes to a new location without the .svn directory.
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Relocate...'''{{TooltipIcon2|(Note: This command is for the package, project and solution only)}} || style="width:660px;" | Opens the Relocating dialog box to rewrite all URLs that are associated with each file and folder with the new URL (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-relocate.html here] for details).
+
| '''Version Control (Subversion) > Relocate...'''{{TooltipIcon2|(Note: This command is for the package, project and solution only)}} || style="width:660px;" | Opens the Relocating dialog box to rewrite all URLs that are associated with each file and folder with the new URL (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-relocate.html '''here'''] for more information).
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Lock...'''{{TooltipIcon2|(Note: This command is for the document only)}} || style="width:660px;" | Opens the Locking dialog box to acquire a lock to the node (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-locking.html#tsvn-dug-locking-lock here] for details).
+
| '''Version Control (Subversion) > Lock...'''{{TooltipIcon2|(Note: This command is for the document only)}} || style="width:660px;" | Opens the Locking dialog box to acquire a lock to the node (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-locking.html#tsvn-dug-locking-lock '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Blame...'''{{TooltipIcon2|(Note: This command is for the document only)}} || style="width:660px;" | Opens the Blame dialog box to find what lines have changed and who changed specific lines in the document (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-blame.html#tsvn-dug-blame-dia-1 here] for details).
+
| '''Version Control (Subversion) > Blame...'''{{TooltipIcon2|(Note: This command is for the document only)}} || style="width:660px;" | Opens the Blame dialog box to find what lines have changed and who changed specific lines in the document (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-blame.html#tsvn-dug-blame-dia-1 '''here'''] for more information).
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Create patch...''' || style="width:660px;" | Opens the Create Patch dialog box to submit a patch file (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-patch.html#tsvn-dug-patch-dia-1 here] for details).
+
| '''Version Control (Subversion) > Create patch...''' || style="width:660px;" | Opens the Create Patch dialog box to submit a patch file (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-patch.html#tsvn-dug-patch-dia-1 '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> Help...''' || style="width:660px;" | Opens the TortoiseSVN's help file.
+
| '''Version Control (Subversion) > Help...''' || style="width:660px;" | Opens the TortoiseSVN's help file.
 
|-{{TableRow2}}
 
|-{{TableRow2}}
−
| '''Version Control (Subversion) >> Setting...''' || style="width:660px;" | Opens the TortoiseSVN's Settings dialog box (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-settings.html here] for details).
+
| '''Version Control (Subversion) > Setting...''' || style="width:660px;" | Opens the TortoiseSVN's Settings dialog box (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-settings.html '''here'''] for more information).
 
|-{{TableRow1}}
 
|-{{TableRow1}}
−
| '''Version Control (Subversion) >> About...''' || style="width:660px;" | Displays the TortoiseSVN's current version and other information.
+
| '''Version Control (Subversion) > About...''' || style="width:660px;" | Displays the TortoiseSVN's current version and other information.
 
|}
 
|}

Latest revision as of 10:11, 17 October 2018


Overview

This page will give you a short introduction of the Subversion (SVN) feature in the OTF. The OTX documents may be used and revised by many people. The version control may be the most suitable solution for managing the changes. In the OTF, the Subversion manages OTX documents and packages, and even a project or the whole solution, and the changes made to them, over time. This allows you to recover older versions of your data or examine the history of how your data changed. With this tool the users may avoid problems when working concurrently - and perhaps even simultaneously on the very same documents.

The OTF supports uploading your projects or solutions to a Subversion server (repository), or performing Subversion tasks with the files in a repository. This feature is supported by the TortoiseSVN (a free open-source Windows subversion client for the Apache™ Subversion® version control system).

Icons Note.png The OTF setup files do not include the TortoiseSVN, you have to install it separately. See here for the setup files.

Adding a Solution (or a project) to Subversion

To add a solution (or a project) to Subversion, please proceed as follows:

  1. Right click on the solution node (or the project node).
  2. Select "Add Solution to Subversion" menu entry (or "Add Selected Project to Subversion" menu entry).
  3. In the "URL of repository" combo box, enter the URL of the repository or you can select from the combo box if there already exists any URL.
  4. In the "Import message" text box, enter the messages.
  5. Click "OK" button.
  6. Enter the "Username" and the "Password" (You can also check the "Save authentication" check box so that you do not have to input the username and the password next time you perform SVN tasks).
  7. Click "OK" button.

Checking-out a Solution (or a project) from the Subversion

To check out a solution (or a project), please proceed as follows:

  1. Click on the "Check out all" button in the "Version Control" tab of the Ribbon.
  2. In the "URL of repository" combo box, enter the URL of the solution folder (or project folder) in the repository. You can click on the "..." button on the right to open the "Repository Browser" (username and password may be required) where you can browse and select a solution folder (or project folder) in the repository.
  3. In the "Check out directory" combo box, enter the path of folder to check out files. You can click on the "..." button to browse and select folder in your computer. Note that the folder should have no content!
  4. It is recommended to leave the other settings the same but you can also adjust them as you want (see here for more information).
  5. Click "OK" button.
  6. After the Progress dialog box has finished, click "OK" button.
  7. Now you can load and use the SVN solution (or project) in the OTF.

Updating Changes

You can update a document, a package, a project or a solution to the lastest revision. Please proceed as follows:

  1. Right click on the node you want to update e.g. a package node (If you want to update all solution, you can also click on the button "Update all" in the "Version Control" tab of the Ribbon).
  2. Select "Update to lastest version" menu entry.
  3. At this step the repository may require to input the username and password, input the required information and click "OK" button.
  4. After the Progress dialog box finished the process, click "OK" button.

To update an element to a particular revision, please proceed as follows:

  1. Right click on the node you want to update e.g. a package node.
  2. Select "Version Control (Subversion)" menu entry, and then select "Update to revision..." menu entry.
  3. Enter the revision you want to update, or click on "Show log" button to select a revision (username and password may be required).
  4. You can adjust the other settings as you want (see here for more information).
  5. Click "OK" button.
  6. After the Progress dialog box finished the process, click "OK" button.

Committing Changes

You can commit the changes in a document, a package, a project or a solution to the repository. Please proceed as follows:

  1. Before committing the changes, it is recommended to save the changes and update the element to the lastest version, see above.
  2. Right click on the node you want to commit changes e.g. a package node (If you want to commit all the changes in the solution, you can also click on the button "Check in all" in the "Version Control" tab of the Ribbon).
  3. Select "Commit..." menu entry.
  4. At this step the repository may require to input the username and password, input the required information and click "OK" button.
  5. In the "Message" text box, enter the message about the changes.
  6. In the "Changes made" pane, check the on the changed nodes which will be committed (You can see and modify the details of the changes by double clicking on the node).
  7. You can adjust the other settings as you want (see here for more information).
  8. Click "OK" button.
  9. At this step the repository may require to input the username and password, input the required information and click "OK" button.
  10. After the Progress dialog box finished the process, click "OK" button.

Reverting Changes

The Undo command in the OTF only supports to undo each single change and it can only undo the changes with elements within a document. With the Subversion, you can undo (revert) all the changes to a document, a package, a project or a solution in Subversion since the last update. Please proceed as follows:

  1. Right click on the node you want to undo changes e.g. a package node.
  2. Select "Revert..." menu entry.
  3. In the "Message" text box, enter the message about the changes.
  4. Select all the elements that you want to revert (see here for more information).
  5. Click "OK" button.
  6. After the Progress dialog box finished the process, click "OK" button.

Subversion Commands Summary

To perform the Subversion tasks on a document, a package, a project or a solution in Subversion, right click on the corresponding node in the Solution Explorer and select the desired Subversion command in the context menu. Below are the short descriptions for the Subversion commands in the OTF:

Command Description
Update to lastest version Updates the node and all sub-nodes to the lastest revision.
Commit... Commits the changes of the node to the Subversion.
Diff... Opens the TortoiseMerge window look at the code differences between two revisions of the same file (see here for more information).
Revert... Reverts all the changes of the node back to last update.
Version Control (Subversion) > Add... Adds the nodes and its sub-nodes to the version control.
Version Control (Subversion) > Add to ignored list... Adds the node and its sub-nodes to the ignored list which will not be subject to version control (click here for more information).
Version Control (Subversion) > Remove from ignored list... Removes the node and its sub-nodes from the ignored list.
Version Control (Subversion) > Show log Opens the Revision Log dialog box to show the revision log of the node (see here for more information).
Version Control (Subversion) > Repository browser Opens the Repository Browser dialog box, locates the node in the repository (see here for more information). You can also view the current project (with the project node or sub-node selected in the solution explorer) in the Repository Browser by clicking the "SVN Project Manager" button in the "Version Control" tab of the Ribbon.
Version Control (Subversion) > Check for modifications... Shows log about which files have been changed and committed (see here for more information).
Version Control (Subversion) > Revision graph... Shows where branches and tags were taken from the trunk in a graph or tree structure (see here for more information).
Version Control (Subversion) > Update to revision... Updates the node and all sub-nodes to a specific revision (see here for more information).
Version Control (Subversion) > Branch... Opens the Branch/Tag dialog box to isolate changes onto a separate branch (see here for more information).
Version Control (Subversion) > Switch... Opens the Switch dialog box to transfer the changed data from the desired branch (see here for more information).
Version Control (Subversion) > Merge... Opens the Merge dialog box to merge range of revision or merge two different trees (see here for more information).
Version Control (Subversion) > Export...Exclamation.png Copies the node and sub-nodes to a new location without the .svn directory.
Version Control (Subversion) > Relocate...Exclamation.png Opens the Relocating dialog box to rewrite all URLs that are associated with each file and folder with the new URL (see here for more information).
Version Control (Subversion) > Lock...Exclamation.png Opens the Locking dialog box to acquire a lock to the node (see here for more information).
Version Control (Subversion) > Blame...Exclamation.png Opens the Blame dialog box to find what lines have changed and who changed specific lines in the document (see here for more information).
Version Control (Subversion) > Create patch... Opens the Create Patch dialog box to submit a patch file (see here for more information).
Version Control (Subversion) > Help... Opens the TortoiseSVN's help file.
Version Control (Subversion) > Setting... Opens the TortoiseSVN's Settings dialog box (see here for more information).
Version Control (Subversion) > About... Displays the TortoiseSVN's current version and other information.
Retrieved from "http://emotive.de/wiki/index.php?title=OtfSubversion&oldid=7886"