Difference between revisions of "Submitting Patches"
From GeeklogWiki
m (GUI equivalence) |
(Added title and fixed typo) |
||
| Line 1: | Line 1: | ||
If you want to submit a patch for Geeklog, please check out the current development version from our [[Using Mercurial|Mercurial]] repository. You can also submit patches against released versions by checking out that version's code using the <tt>..._stable</tt> [[Tags and Branches|tag]]. | If you want to submit a patch for Geeklog, please check out the current development version from our [[Using Mercurial|Mercurial]] repository. You can also submit patches against released versions by checking out that version's code using the <tt>..._stable</tt> [[Tags and Branches|tag]]. | ||
| + | ==Checklist== | ||
* check out the source code | * check out the source code | ||
* make the necessary changes to the source | * make the necessary changes to the source | ||
| Line 7: | Line 8: | ||
** export the changeset using <tt>hg export REV</tt> where <tt>REV</tt> is the revision number of the changeset | ** export the changeset using <tt>hg export REV</tt> where <tt>REV</tt> is the revision number of the changeset | ||
*** to export the latest changeset from your repository, simply use <pre>hg export tip</pre> | *** to export the latest changeset from your repository, simply use <pre>hg export tip</pre> | ||
| − | *** The TortoiseHg GUI equivalence is: ''' | + | *** The TortoiseHg GUI equivalence is: '''Hg Repository Explorer=>choose Changeset=>Export Patch''' |
* if your patch consists of more than one changeset, please export them individually into separate files with consecutive numbers so we know in which order they need to be applied (Note: while <tt>hg export</tt> can export multiple changesets into one file, the equivalent <tt>hg import</tt> currently only accepts one changeset per file, so we're asking for separate files.) | * if your patch consists of more than one changeset, please export them individually into separate files with consecutive numbers so we know in which order they need to be applied (Note: while <tt>hg export</tt> can export multiple changesets into one file, the equivalent <tt>hg import</tt> currently only accepts one changeset per file, so we're asking for separate files.) | ||
* Diff files: | * Diff files: | ||
Revision as of 10:32, 5 April 2010
If you want to submit a patch for Geeklog, please check out the current development version from our Mercurial repository. You can also submit patches against released versions by checking out that version's code using the ..._stable tag.
Checklist
- check out the source code
- make the necessary changes to the source
- commit changes into your local repository
- Exporting:
- export the changeset using hg export REV where REV is the revision number of the changeset
- to export the latest changeset from your repository, simply use
hg export tip
- The TortoiseHg GUI equivalence is: Hg Repository Explorer=>choose Changeset=>Export Patch
- to export the latest changeset from your repository, simply use
- export the changeset using hg export REV where REV is the revision number of the changeset
- if your patch consists of more than one changeset, please export them individually into separate files with consecutive numbers so we know in which order they need to be applied (Note: while hg export can export multiple changesets into one file, the equivalent hg import currently only accepts one changeset per file, so we're asking for separate files.)
- Diff files:
- if you are not using hg export please send unified diff files and make sure you list the files in the correct order, i.e.
diff -u original-file modified-file > patch.diff
- The TortoiseHg GUI equivalence is: Hg Commit=>Diff (?)
- if you are not using hg export please send unified diff files and make sure you list the files in the correct order, i.e.
- add the patch (or zipped/gzipped set of patches) as an attachment to the bug or feature request in question on our bugtracker
- if there is no bug or feature request for your patch, send the patch (with an explanation) to the geeklog-devel mailing list (if the patch is really huge, you may want to upload it somewhere and only send the URL)
Thank you!
diff vs. hg export
You may be wondering why we're asking you to use hg export instead of the more common diff files. That is because export files
- include the checkin comment
- give proper attribution to the person who created the patch (i.e. you)
