Tutorial #2 - OpenWebKitSharp's Development System (Updating, Commiting, Patches, Issues)

In this tutorial I am going to show you how to take the most out of the new development system of OpenWebKitSharp. The new system aims to make everybody able to help the development of OpenWebKitSharp either by source or by reporting bugs/issues.

Requirements:

TortoiseSVN: http://tortoisesvn.net/downloads.html - Used for downloading Source and updating it and for Commiting

If you don't want to download external software you can download the whole packs whenever a new build is available: http://code.google.com/p/open-webkit-sharp/downloads/list

Getting the source

If you have TortoiseSVN installed then it is very easy to get the source. Follow these steps:

1. Create a folder where you want to store OpenWebKitSharp's files
2. Right-Click on that folder and select SVN Update.
3. When prompted, enter the following URL: http://open-webkit-sharp.googlecode.com/svn/
4. OpenWebKitSharp requires Visual Studio 2008/2010/2011 to be built (support for earlier versions is uknown)

Being up-to-date

Whenever you want you can run the SVN Update command to download the latest OpenWebKitSharp files. When a newer version is available the folder where your OpenWebKitSharp files are stored will have an exclamation mark (this will also happen when you make changes to the files inside). If you see this icon then you can right-click on that folder and select SVN Update and enter this url: http://open-webkit-sharp.googlecode.com/svn/

When the files are downloaded you will see the correct icon to the folder.

Posting Patches and Commiting

If you think that OpenWebKitSharp needs some changes and you know how to make them then you can do so either by posting a patch or by using the SVN Commit method. To use the SVN Commit method you must firstly qualify as an OpenWebKitSharp Developer and then you will receive information on how to commit.

As for patches, adding a patch can be done in 2 ways:

1. (Recommended) Make the changes you want and then go to the folder where your OpenWebKitSharp files are stored and then right-click->TortoiseSVN->Create Patches. Then select the files that you want to update and save it to a local directory. Then, go again to the right-click menu of the OpenWebKitSharp directory, select TortoiseSVN->Apply Patch and select the file you previously saved. When TortoiseMerge pops up go to the window to the left and select Patch All to patch all the files or Patch Selected to patch the selected files.
2. If you don't want to use TortoiseSVN then you simply have to navigate here: http://code.google.com/p/open-webkit-sharp/source/browse/ and select the file that you want to edit. When you find the file you want click Edit File and make the changes you want.

Issues

By posting issues you can help the developer team to solve present bugs or add new features! Go to: http://code.google.com/p/open-webkit-sharp/issues/entry and fill in the form. Then click submit and you have completed the whole process!