| $Id$ |
| |
| __________ __ ___. |
| Open \______ \ ____ ____ | | _\_ |__ _______ ___ |
| Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / |
| Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < |
| Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ |
| \/ \/ \/ \/ \/ |
| Contribution Policies |
| |
| |
| In order for the project to run as smoothly as possible, it's best if all |
| contributors adhere to a few simple conventions: |
| |
| Language |
| -------- |
| Write all code in C. Sometimes assembly is faster, but C is always more |
| readable and maintainable. |
| |
| Language features |
| ----------------- |
| Write normal C code. Don't redefine the language. No new types (structs are |
| structs, not typedefs), no C++isms or Javaisms. Also, avoid using "const". |
| |
| Names |
| ----- |
| Variables and function names should be all lower case. |
| Preprocessor symbols should be all uppercase. |
| |
| Comments |
| -------- |
| We only use plain old /* C standard comments */. |
| |
| Style |
| ----- |
| When changing code, follow the code style of the file you are editing. |
| |
| When writing new files, you may use the brace placement style of your choice. |
| |
| Always indent your code with four spaces. Don't use TAB characters, as that |
| will mess up code display in CVS, printing, and a zillion other places. |
| |
| Keep lines below 80 columns length. Use whitespace and newlines to make the |
| code easy to browse/read. |
| |
| Text format |
| ----------- |
| Use "unix style" line feeds: "LF" only. Do not use "CR+LF". |
| |
| Patches |
| ------- |
| Create a patch using 'cvs diff -ub'. |
| Trim your patches so they only contain relevant changes. |
| |
| Submit your patch to the project via Sourceforge's patch tracker: |
| http://sourceforge.net/tracker/?group_id=44306&atid=439120 |