Difference between revisions of "Patches"

From OdaWiki
(Benefits)
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
If you want to help out with the code and have made an improvement to odamex, or have already fixed a [[bugs|bug]], please send us your patches. Let the [[MAINTAINERS]] file guide you to the appropriate email address. Odamex needs your help!
+
==Overview==
 +
 
 +
A patch is a portion of source code (fix or addition) that can be directly applied to the main ODAMEX source code.
 +
 
 +
==Benefits==
 +
 
 +
There are some benefits for yourself and others to be gained from submitting a patch:
 +
* ODAMEX can be made more enjoyable to play and have its stability and robustness improved.
 +
* If you're a new developer, it can improve your programming language skills.
 +
* If you're an advanced developer, it can improve your knowledge of the doom source code.
 +
* If you submit several patches, you will be included on the credits/contributors list (and eventually gain developer [[svn]] write access)
 +
* If you submit big patches such as those that fix major crashes or add a feature that betters Odamex, you will be granted [[svn]] write access.
 +
 
 +
==Guidelines for patches==
 +
 
 +
* Be sure you have the latest [[svn]] revision to ensure that you aren't fixing something that has already been fixed.
 +
* Patches must comply with the [[Coding_standard|coding standard]]
 +
 
 +
==Sending us a patch==
 +
 
 +
Patch submissions can be made by e-mailing one of the [[MAINTAINERS]]
  
 
== External Links ==
 
== External Links ==
* [[http://en.wikipedia.org/wiki/Diff diff utility]]
+
* [http://en.wikipedia.org/wiki/Diff diff utility]
* [[http://en.wikipedia.org/wiki/Patch_%28Unix%29 patch utility]]
+
* [http://en.wikipedia.org/wiki/Patch_%28Unix%29 patch utility]

Latest revision as of 00:02, 7 August 2008

Overview

A patch is a portion of source code (fix or addition) that can be directly applied to the main ODAMEX source code.

Benefits

There are some benefits for yourself and others to be gained from submitting a patch:

  • ODAMEX can be made more enjoyable to play and have its stability and robustness improved.
  • If you're a new developer, it can improve your programming language skills.
  • If you're an advanced developer, it can improve your knowledge of the doom source code.
  • If you submit several patches, you will be included on the credits/contributors list (and eventually gain developer svn write access)
  • If you submit big patches such as those that fix major crashes or add a feature that betters Odamex, you will be granted svn write access.

Guidelines for patches

  • Be sure you have the latest svn revision to ensure that you aren't fixing something that has already been fixed.
  • Patches must comply with the coding standard

Sending us a patch

Patch submissions can be made by e-mailing one of the MAINTAINERS

External Links