Tortoise SVN
AmyStephen (Talk | contribs) (→Create a patch (after you fixed a bug)) |
(→Create a local testing environment) |
||
| (14 intermediate revisions by 3 users not shown) | |||
| Line 2: | Line 2: | ||
'''Tortoise SVN''' is a simple solution for Windows users working with Joomla!'s SVN environment. You can use it to download a current copy of the development repository and to create, apply, and revert patches for testing with the Joomla Bug Squad. | '''Tortoise SVN''' is a simple solution for Windows users working with Joomla!'s SVN environment. You can use it to download a current copy of the development repository and to create, apply, and revert patches for testing with the Joomla Bug Squad. | ||
| − | '''Prerequisites:''' A local web host environment, such as [http://docs.joomla.org/Setting_up_your_workstation_for_Joomla!_development#Install_XAMPP XAMPP] and | + | '''Prerequisites:''' A local web host environment, such as [http://docs.joomla.org/Setting_up_your_workstation_for_Joomla!_development#Install_XAMPP XAMPP] and administrator privileges on a Windows environment. |
| − | If you are using an IDE, you can | + | If you are using an IDE, you can usually perform these functions in that environment. [http://docs.joomla.org/Setting_up_your_workstation_for_Joomla!_development_--_Part_2#Check_Out_Joomla.21_Source_Code Instructions for Eclipse are available.] If you use Eclipse, '''Tortoise SVN''' is not required (although it can still be used along side Eclipse.) |
== Install Tortoise SVN == | == Install Tortoise SVN == | ||
| Line 10: | Line 10: | ||
Navigate to the [http://tortoisesvn.net/downloads Tortoise SVN Site]. | Navigate to the [http://tortoisesvn.net/downloads Tortoise SVN Site]. | ||
| + | |||
[[Image:tortoise_download_1.jpg]] | [[Image:tortoise_download_1.jpg]] | ||
| Line 19: | Line 20: | ||
In order to create and test patches, you need a current copy of the development code repository. Tortoise SVN can be used to connect to the development environment, download the current code base, and place it in your local development environment. | In order to create and test patches, you need a current copy of the development code repository. Tortoise SVN can be used to connect to the development environment, download the current code base, and place it in your local development environment. | ||
| + | |||
[[Image:tortoise_newsite_1.jpg]] | [[Image:tortoise_newsite_1.jpg]] | ||
Create an empty folder for a new Web site within the Web sites folder (usually named htdocs) of your localhost environment. | Create an empty folder for a new Web site within the Web sites folder (usually named htdocs) of your localhost environment. | ||
| + | |||
[[Image:Tortoise svn checkout.jpg]] | [[Image:Tortoise svn checkout.jpg]] | ||
Right-click the name of the empty folder and select '''SVN Checkout''' from the popup list. | Right-click the name of the empty folder and select '''SVN Checkout''' from the popup list. | ||
| + | |||
[[Image:tortoise_checkout_1.jpg]] | [[Image:tortoise_checkout_1.jpg]] | ||
| − | Enter '''http:// | + | Enter '''http://svn.github.com/joomla/joomla-cms''' for URL of repository and press OK. |
Wait while all files are downloaded from Joomlacode. | Wait while all files are downloaded from Joomlacode. | ||
| − | == Update for the latest | + | == Update for the latest commits == |
[[Image:Tortoise_svn_update1.jpg]] | [[Image:Tortoise_svn_update1.jpg]] | ||
Right-click the repository created above. Click SVN-Update. | Right-click the repository created above. Click SVN-Update. | ||
| + | |||
[[Image:tortoise_svn_update.jpg]] | [[Image:tortoise_svn_update.jpg]] | ||
| Line 52: | Line 57: | ||
[[Image:tortoise_apply_patch.jpg]] | [[Image:tortoise_apply_patch.jpg]] | ||
| − | Right click-the repository folder and select '''Apply Patch''' from the Pop-up menu. | + | Right click-the repository folder and select '''TortoiseSVN-Apply Patch''' from the Pop-up menu. |
[[Image:tortoise_locate_patch.jpg]] | [[Image:tortoise_locate_patch.jpg]] | ||
| Line 68: | Line 73: | ||
[[Image:Tortoise_revert_patch1.jpg]] | [[Image:Tortoise_revert_patch1.jpg]] | ||
| − | Right-click the repository where you applied the patch. Click | + | Right-click the repository where you applied the patch. Click '''TortoiseSVN-Revert'''. |
[[Image:Tortoise_revert_patch2.jpg]] | [[Image:Tortoise_revert_patch2.jpg]] | ||
| Line 76: | Line 81: | ||
[[Image:Tortoise_revert_patch3.jpg]] | [[Image:Tortoise_revert_patch3.jpg]] | ||
| − | Wait until the Revert action is complete, then press | + | Wait until the Revert action is complete, then press OK. |
== Create a patch (after you fixed a bug) == | == Create a patch (after you fixed a bug) == | ||
| Line 90: | Line 95: | ||
[[Image:tortoise_create_patch3.jpg]] | [[Image:tortoise_create_patch3.jpg]] | ||
| − | Save the patch file | + | Save the patch file to your local environment. There is no standard naming convention; many times developesr will named the patch NNNN.patch where NNNN is the issue number and 'patch' is the file extension. |
[[Image:tortoise_create_patch4.jpg]] | [[Image:tortoise_create_patch4.jpg]] | ||
| Line 96: | Line 101: | ||
Upload the file as an attachment to the Issue. | Upload the file as an attachment to the Issue. | ||
| − | '''Note:''' always delete old patch files so that it's clear to testers which file to use. | + | '''Note:''' always delete old patch files so that it's clear to testers which file to use.<!-- For most users, there is no option to delete old patches in the user interface --> |
Document your issue to include clear testing instructions. | Document your issue to include clear testing instructions. | ||
| − | [[Category: | + | <noinclude>[[Category:Development Working Group]][[Category:Bug Squad]]</noinclude> |
| − | [[Category: | + | |
Latest revision as of 13:40, 10 February 2013
Contents |
[edit] Tortoise SVN
Tortoise SVN is a simple solution for Windows users working with Joomla!'s SVN environment. You can use it to download a current copy of the development repository and to create, apply, and revert patches for testing with the Joomla Bug Squad.
Prerequisites: A local web host environment, such as XAMPP and administrator privileges on a Windows environment.
If you are using an IDE, you can usually perform these functions in that environment. Instructions for Eclipse are available. If you use Eclipse, Tortoise SVN is not required (although it can still be used along side Eclipse.)
[edit] Install Tortoise SVN
Navigate to the Tortoise SVN Site.
Download and install either the 32 or 64-bit option, depending upon your operating system requirements.
[edit] Create a local testing environment
Prerequisite:XAMPP or another local host environment.
In order to create and test patches, you need a current copy of the development code repository. Tortoise SVN can be used to connect to the development environment, download the current code base, and place it in your local development environment.
Create an empty folder for a new Web site within the Web sites folder (usually named htdocs) of your localhost environment.
Right-click the name of the empty folder and select SVN Checkout from the popup list.
Enter http://svn.github.com/joomla/joomla-cms for URL of repository and press OK.
Wait while all files are downloaded from Joomlacode.
[edit] Update for the latest commits
Right-click the repository created above. Click SVN-Update.
Wait until all necessary changes have been made. Click OK to close the dialog box.
[edit] Apply a patch
Download the patch file from an Issue report on Joomlacode. (File tab on bottom of an issue report page.) Save it to your local environment.
Right click-the repository folder and select TortoiseSVN-Apply Patch from the Pop-up menu.
Locate the patch saved above, click open.
When "File patches" dialog box to appear, right click and select "Patch all."
Close the Dialog boxes and test the patch.
[edit] Revert a patch (remove it after testing)
Right-click the repository where you applied the patch. Click TortoiseSVN-Revert.
Select specific files or all files (bottom) to revert the patch changes. Press OK.
Wait until the Revert action is complete, then press OK.
[edit] Create a patch (after you fixed a bug)
Right-click the repository where you made changes to the code. Click TortoiseSVN-Create patch....
On the Create Patch Dialog box, select the specific file(s), or all files (bottom) that apply to the patch changes. Press OK.
Save the patch file to your local environment. There is no standard naming convention; many times developesr will named the patch NNNN.patch where NNNN is the issue number and 'patch' is the file extension.
Upload the file as an attachment to the Issue.
Note: always delete old patch files so that it's clear to testers which file to use.
Document your issue to include clear testing instructions.
