Submitting Patches
From BattletechMUX
For those without Subversion access, the best way to get changes to us is by submitting a patch. This is done by checking out a copy of the source with Subversion (see the Subversion How-To), making your modifications, and creating/sending a patch to us.
A Step-by-Step Guide to Creating and Submitting Patches
- First, check out a copy of the source by following these instructions. You'll want to check out the latest development branch (the trunk).
- Make your modifications. Try to keep your patches as small as possible. For example, only do one feature change/bugfix/addition per patch. You will need to patch against the unmodified latest source for the branch for each patch.
- From the root btmux directory, issue a svn diff > mypatch, replace mypatch with the name of the file you'd like your patch to be contained in. If you've modified the game directory or any of the subdirectories, you'll need to issue the svn diff > mypatch command from the directory of the file you modified instead since they are under different projects than the btmux root directory.
- Send the patch to us via the SourceForge Patch Tracker.
From there, your patch is reviewed and either accepted as is, accepted with modifications, or rejected. If your patch is outright rejected, we will let you know what you need to do to get it in shape for acceptance.
Patches? But I want Commit Access!
It is the policy of the development team to require each potential developer to submit a handful of patches so we can evaluate the skill and style of the submitter. Virtually anyone can eventually be granted commit access given they are consistent and willing to learn. Do not be discouraged!
