Submitting Patches

From Bandit-project.org

Contents

Submitting Patches

If you submit a patch, it's always best to create the patch against the current snapshot version of the code. To do it:

  1. Check out the source code from the repository (see Download).
  2. Make the changes you want to make.
  3. Follow the bandit best practices.
  4. Run 'svn diff > change.patch' at the directory of the componant you changed.

If you cannot use this, then make sure you have the source for the latest release, and do the following:

  1. Copy the file before you edit it.
  2. Make the changes you want to make and save the file.
  3. Follow the bandit best practices.
  4. On the command line type diff -u oldfile.cs newfile.cs > vardec.patch. The name of the patch should be something quick which describes what you fixed.

If the patch fixes a bug, it's better to create a bug attach the patch to the bug. If you're patching against a pre-existing bug, just attach to the bug. Otherwise you can just send the patch to the Mailing List.

Best Practices

  • All changes and new features should follow generally accepted best practices for development including:
    • Code follows the coding guidelines.
    • All targets build.
    • Code has be peer reviewed.
    • Existing junit tests pass and for new features there are new unit tests.
    • Notification and cordination of the change/upload.
    • It is also nice if static code analysis tools have been run (lint4j or others)


Coding Guidelines


A Note on Licensing

Please do not submit any work copyrighted by others.