Submitting code to OpenSim
From OpenSimulator
(Difference between revisions)
| Line 3: | Line 3: | ||
svn diff > my.patch | svn diff > my.patch | ||
| − | from the root OpenSim directory. This will package up all your changes into a nice easily appliable file. | + | from the root OpenSim directory. This will package up all your changes into a nice easily appliable file. If you are using [http://tortoisesvn.tigris.org/ TortoiseSVN] on Windows, you can right-click in the opensim directory and select "Create patch" to create a diff. |
* Please run the unit tests (via nant test on the command line) before submitting your patch. Patches that add new tests (either to test accompanying patch code or to test existing code) are very welcome. | * Please run the unit tests (via nant test on the command line) before submitting your patch. Patches that add new tests (either to test accompanying patch code or to test existing code) are very welcome. | ||
| Line 10: | Line 10: | ||
* In your Mantis, the title line should ideally start with [PATCH]. When you've opened it, change the state to patch included. Once you've put in on a Mantis, you may want to hop on the IRC channels and mention it someone there (though at the moment we're pretty good at getting round to these, since e-mails about newly opened mantis entries are sent to developers automatically). | * In your Mantis, the title line should ideally start with [PATCH]. When you've opened it, change the state to patch included. Once you've put in on a Mantis, you may want to hop on the IRC channels and mention it someone there (though at the moment we're pretty good at getting round to these, since e-mails about newly opened mantis entries are sent to developers automatically). | ||
| + | |||
| + | * Once you've submitted your patch you should move the Mantis entry into the '''Patch Included''' state to let us know there's a patch waiting to be applied. | ||
* If you're looking for an initial piece of code to do, the bugs in Mantis are a very good starting point. You may want to see if there's anybody on IRC to discuss the difficulty of a particular bug (they do vary, sometimes in unexpected ways). | * If you're looking for an initial piece of code to do, the bugs in Mantis are a very good starting point. You may want to see if there's anybody on IRC to discuss the difficulty of a particular bug (they do vary, sometimes in unexpected ways). | ||
Revision as of 06:00, 11 February 2009
Code is submitted to OpenSim via patches attached to our Mantis bug tracker. One way to generate these is by using the Subversion command line
svn diff > my.patch
from the root OpenSim directory. This will package up all your changes into a nice easily appliable file. If you are using TortoiseSVN on Windows, you can right-click in the opensim directory and select "Create patch" to create a diff.
- Please run the unit tests (via nant test on the command line) before submitting your patch. Patches that add new tests (either to test accompanying patch code or to test existing code) are very welcome.
- Please put only one logical change in a patch at a time. Patches that contain more than one logical change tend to be larger, more complex and hence take more time to be applied. At worse, developers will tend not to look at them because it's hard to disentangle all the possible effects.
- In your Mantis, the title line should ideally start with [PATCH]. When you've opened it, change the state to patch included. Once you've put in on a Mantis, you may want to hop on the IRC channels and mention it someone there (though at the moment we're pretty good at getting round to these, since e-mails about newly opened mantis entries are sent to developers automatically).
- Once you've submitted your patch you should move the Mantis entry into the Patch Included state to let us know there's a patch waiting to be applied.
- If you're looking for an initial piece of code to do, the bugs in Mantis are a very good starting point. You may want to see if there's anybody on IRC to discuss the difficulty of a particular bug (they do vary, sometimes in unexpected ways).
