Difference between revisions of "OtfSubversion"

From emotive
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:Open Test Framework - Subversion}}Category:OTF ==Overview== {{Question|This page will give you a short introduction of the '''Subversion''' feature in the...")
 
Line 1: Line 1:
−
{{DISPLAYTITLE:Open Test Framework - Subversion}}[[Category:OTF]]
+
{{DISPLAYTITLE:Open Test Framework - Subversion (Version Control)}}[[Category:OTF]]
  
 
==Overview==
 
==Overview==
−
{{Question|This page will give you a short introduction of the '''Subversion''' feature in the OTF. The OTX documents may be shared and used by many people. The version control may be the most suitable solution for managing the changes. It is really a critical tool for people who use and revise the same documents. They can make small changes to them and then revert the changes or check the changes to those documents in the next day. With this tool the users may avoid problems when working concurrently - and perhaps even simultaneously on the very same documents. In the OTF, the Subversion manages OTX documents and even a project or the whole solution ect., 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.}}
+
{{Question|This page will give you a short introduction of the '''Subversion''' feature in the OTF. The OTX documents may be shared, 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, or performing subversion tasks with the files in the 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).
  
−
==Adding a solution or a project to Subversion==
+
{{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==
 
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").
+
# 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.
Line 25: Line 27:
 
# 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 the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-checkout.html here] for details).
 
# Click "OK" button
 
# Click "OK" button
−
# After the check out dialog box finished the process, click "OK" button.
+
# After the Progress dialog box finished the process, click "OK" button.
 +
# Now you can load and use the svn solution (or project) in the OTF.
  
−
{{Question|Hoi Thuan xem khi cai OTF co can phai cai TortoiseSVN de xai subversion khong}}
+
==Updating the changes==
 +
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]]).
 +
# 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.
 +
# After the Progress dialog box finished the process, click "OK" button.
  
 +
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.
 +
# 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).
 +
# You can adjust the other settings as you want (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-update.html here] for details).
 +
# Click "OK" button.
 +
# After the Progress dialog box finished the process, click "OK" button.
  
 
==Committing the changes==
 
==Committing the changes==
−
After you have
+
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 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]]).
 +
# 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.
 +
# 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).
 +
# You can adjust the other settings as you want (see [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-commit.html here] for details).
 +
# 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.
 +
 
 +
==Undoing 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:
 +
 
 +
# Right-click on the node you want to undo changes e.g. a package node.
 +
# Select "Revert..." menu entry.
 +
# 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/nightly/TortoiseSVN_en/tsvn-dug-revert.html#tsvn-dug-revert-dia-1 here] for details).
 +
# Click "OK" button.
 +
# After the Progress dialog box finished the process, click "OK" button.
 +
 
 +
==Subversion commands summary==
 +
Below are the short descriptions for the other Subversion commands in the OTF:
 +
 
 +
{|{{TableHeader}}
 +
|- style="background: gray; color: white; vertical-align:top;"
 +
| '''Operator''' || '''Description'''
 +
|-{{TableRow2}}
 +
| '''Update to lastest version''' || Updates the node and all sub-nodes to the lastest revision.
 +
|-{{TableRow1}}
 +
| '''Commit...''' || Commits the changes of the node to the Subversion.
 +
|-{{TableRow2}}
 +
| '''Diff...''' || Opens the WinMerge dialog box look at the code differences between two revisions of the same file (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-diff.html#tsvn-dug-diff-tools here] for details).
 +
|-{{TableRow1}}
 +
| '''Revert...''' || Reverts all the changes of the node back to last update.
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Show log''' || Opens the Revision Log dialog box to show the revision log of the node (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-showlog.html here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Repository browser''' || Open the Repository Browser dialog box, locates the node in the repository (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-repobrowser.html here] for details).
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Check for modifications...''' || Shows log about which files have been changed and committed (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-wcstatus.html#tsvn-dug-wcstatus-dia-2 here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Revision graph...''' || Shows where branches and tags were taken from the trunk in a graph or tree structure (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-revgraph.html2 here] for details).
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Update to revision...''' || Updates the node and all sub-nodes to a specific revision (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-update.html. here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Branch...''' || Opens the Branch/Tag dialog box to isolate changes onto a separate branch (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-branchtag.html here] for details).
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Switch...''' || Opens the Switch dialog box to transfer the changed data from the desired branch (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-branchtag.html#tsvn-dug-switch-1 here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Merge...''' || Opens the Merge dialog box to merge range of revision or merge two different trees (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-merge.html here] for details).
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Export...'''{{TooltipIcon2|(Note: This command is for the package, project and solution only)}} || Copy the node and sub-nodes to a new location without the .svn directory.
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Relocate...'''{{TooltipIcon2|(Note: This command is for the package, project and solution only) || 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/nightly/TortoiseSVN_en/tsvn-dug-relocate.html here] for details).
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Lock...'''{{TooltipIcon2|(Note: This command is for the document only) || Opens the Locking dialog box to acquire a lock to the node (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-locking.html#tsvn-dug-locking-lock here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Blame...'''{{TooltipIcon2|(Note: This command is for the document only) || Opens the Blame dialog box to find what lines have changed and who changed specific lines in the document (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-blame.html#tsvn-dug-blame-dia-1 here] for details).
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Create patch...''' || Opens the Create Patch dialog box to submit a patch file (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-patch.html#tsvn-dug-patch-dia-1 here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> Help...''' || Opens the TortoiseSVN's help file.
 +
|-{{TableRow2}}
 +
| '''Version Control (Subversion) >> Setting...''' || Opens the TortoiseSVN's Settings dialog box (see [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-settings.html here] for details).
 +
|-{{TableRow1}}
 +
| '''Version Control (Subversion) >> About...''' || Displays the TortoiseSVN's current version and other information.
 +
|}

Revision as of 09:22, 1 September 2014


Overview

This page will give you a short introduction of the Subversion feature in the OTF. The OTX documents may be shared, 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 sothat 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 the file system. Note that the folder should have no content.
  4. It is recommended to leave the other settings the same but you can also adjust the other settings as you want (see here for details).
  5. Click "OK" button
  6. After the Progress dialog box finished the process, click "OK" button.
  7. Now you can load and use the svn solution (or project) in the OTF.

Updating the 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 details).
  5. Click "OK" button.
  6. After the Progress dialog box finished the process, click "OK" button.

Committing the 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 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 details).
  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.

Undoing 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:

  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 details).
  5. Click "OK" button.
  6. After the Progress dialog box finished the process, click "OK" button.

Subversion commands summary

Below are the short descriptions for the other Subversion commands in the OTF:

Operator 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 WinMerge dialog box look at the code differences between two revisions of the same file (see here for details).
Revert... Reverts all the changes of the node back to last update.
Version Control (Subversion) >> Show log Opens the Revision Log dialog box to show the revision log of the node (see here for details).
Version Control (Subversion) >> Repository browser Open the Repository Browser dialog box, locates the node in the repository (see here for details).
Version Control (Subversion) >> Check for modifications... Shows log about which files have been changed and committed (see here for details).
Version Control (Subversion) >> Revision graph... Shows where branches and tags were taken from the trunk in a graph or tree structure (see here for details).
Version Control (Subversion) >> Update to revision... Updates the node and all sub-nodes to a specific revision (see here for details).
Version Control (Subversion) >> Branch... Opens the Branch/Tag dialog box to isolate changes onto a separate branch (see here for details).
Version Control (Subversion) >> Switch... Opens the Switch dialog box to transfer the changed data from the desired branch (see here for details).
Version Control (Subversion) >> Merge... Opens the Merge dialog box to merge range of revision or merge two different trees (see here for details).
Version Control (Subversion) >> Export...Exclamation.png Copy the node and sub-nodes to a new location without the .svn directory.
(Note: This command is for the package, project and solution only) Opens the Relocating dialog box to rewrite all URLs that are associated with each file and folder with the new URL (see here for details).
(Note: This command is for the document only) Opens the Locking dialog box to acquire a lock to the node (see here for details).
(Note: This command is for the document only) Opens the Blame dialog box to find what lines have changed and who changed specific lines in the document (see here for details).
Version Control (Subversion) >> Create patch... Opens the Create Patch dialog box to submit a patch file (see here for details).
Version Control (Subversion) >> Help... Opens the TortoiseSVN's help file.
Version Control (Subversion) >> Setting... Opens the TortoiseSVN's Settings dialog box (see here for details).
Version Control (Subversion) >> About... Displays the TortoiseSVN's current version and other information.
Retrieved from "http://emotive.de/wiki/index.php?title=OtfSubversion&oldid=1636"