How To Create Patch For Stendhal
If you want to contribute to Stendhal with some changes to some files you can ease us integrating the changes if you create a patch file for your changes. There are two neat ways to do that. We are going to describe here how to create a patch on each of this ways.
As a prerequisite for both ways of creating a patch is a checked out version of Stendhal.
Common best practices for patches and CVS
- Keep your local copy of Stendhal regularly up to date with CVS Head to avoid merge conflicts
- Discuss your plans with the team at #arianne
- Test your changes locally
TODO: list more best practice tips
Eclipse way
When you use Eclipse it is quite easy for you to create a patch against current head version in CVS. Before creating a patch you should update your local copy of the sources to the most recent version.
After updating your Stendhal project you can start the patch creation by right clicking on the project. In the appearing context menu select Team and Create Patch in the team submenu. This will open up a wizard for creating patches.
The first wizard page asks you where to create the patch. For submitting a patch to our patches tracker you should choose file as selected in the next screenshot. For creating a patch file you also have to select a file name and location for the patch. You can easily select a target folder and file name by clicking on Browse. The last thing you have to choose on this windows are the changes. If you want to bring all current differences to CVS into the patch file just tick the root node of the shown project tree in the Changes area of the window.
In the next step which is also the final step you need to specify two other options. Just select the options as shown in the screenshot and click on Finish.
After clicking on finish you will not get any further notice but the patch file should now be available in the previously selected folder.
Command line way
TODO: describe how to create a patch via CLI