2003-03-24 09:00:14 +00:00
|
|
|
How to contribute to lwIP
|
|
|
|
|
|
|
|
|
|
Here is a short list of suggestions to anybody working with lwIP and
|
|
|
|
|
trying to contribute bugreports, fixes, enhancements, platform ports etc.
|
|
|
|
|
First of all as you may already know lwIP is a volunteer project so feedback
|
2003-03-25 12:59:42 +00:00
|
|
|
to fixes or questions might often come late. Hopefully the bug and patch tracking
|
|
|
|
|
features of Savannah help us not lose users' input.
|
2003-03-24 09:00:14 +00:00
|
|
|
|
2003-03-30 22:57:52 +00:00
|
|
|
Source code style:
|
|
|
|
|
|
2003-05-01 13:24:01 +00:00
|
|
|
- do not use tabs.
|
|
|
|
|
- indentation is two spaces per level.
|
2003-04-01 13:34:56 +00:00
|
|
|
- end debug messages with a trailing newline (\n).
|
2003-03-30 22:57:52 +00:00
|
|
|
- one space between keyword and opening bracket.
|
2003-05-01 13:24:01 +00:00
|
|
|
- no space between function and opening bracket.
|
|
|
|
|
- one space and no newline before opening curly braces of a block.
|
2003-04-01 13:34:56 +00:00
|
|
|
- spaces surrounding assignment and comparisons.
|
|
|
|
|
- use current source code style as further reference.
|
|
|
|
|
|
2003-05-01 13:24:01 +00:00
|
|
|
Source code documentation style:
|
2003-03-30 22:57:52 +00:00
|
|
|
|
2003-04-01 13:34:56 +00:00
|
|
|
- JavaDoc compliant and Doxygen compatible.
|
|
|
|
|
- Function documentation above functions in .c files, not .h files.
|
2003-05-01 13:24:01 +00:00
|
|
|
(This forces you to synchronize documentation and behaviour.)
|
2003-04-01 13:34:56 +00:00
|
|
|
- Use current documentation style as further reference.
|
|
|
|
|
|
2003-03-30 22:57:52 +00:00
|
|
|
Bug reports and patches:
|
|
|
|
|
|
2003-05-01 13:24:01 +00:00
|
|
|
- Make sure you are reporting bugs or send patches against the latest
|
|
|
|
|
sources. (From the latest release and/or the current CVS sources.)
|
|
|
|
|
- If you think you found a bug make sure it's not already filed in the
|
|
|
|
|
bugtracker at Savannah.
|
|
|
|
|
- If you have a fix put the patch on Savannah. If it is a patch that affects
|
|
|
|
|
both core and arch specific stuff please separate them so that the core can
|
|
|
|
|
be applied separately while leaving the other patch 'open'. The prefered way
|
|
|
|
|
is to NOT touch archs you can't test and let maintainers take care of them.
|
|
|
|
|
This is a good way to see if they are used at all - the same goes for unix
|
|
|
|
|
netifs except tapif.
|
|
|
|
|
- Do not file a bug and post a fix to it to the patch area. Either a bug report
|
|
|
|
|
or a patch will be enough.
|
2003-03-25 12:59:42 +00:00
|
|
|
If you correct an existing bug then attach the patch to the bug rather than creating a new entry in the patch area.
|
|
|
|
|
- Trivial patches (compiler warning, indentation and spelling fixes or anything obvious which takes a line or two)
|
|
|
|
|
can go to the lwip-users list. This is still the fastest way of interaction and the list is not so crowded
|
|
|
|
|
as to allow for loss of fixes. Putting bugs on Savannah and subsequently closing them is too much an overhead
|
|
|
|
|
for reporting a compiler warning fix.
|
2003-03-26 10:36:00 +00:00
|
|
|
- Patches should be specific to a single change or to related changes.Do not mix bugfixes with spelling and other
|
|
|
|
|
trivial fixes unless the bugfix is trivial too.Do not reorganize code and rename identifiers in the same patch you
|
|
|
|
|
change behaviour if not necessary.A patch is easier to read and understand if it's to the point and short than
|
|
|
|
|
if it's not to the point and long :) so the chances for it to be applied are greater.
|
2003-03-24 09:00:14 +00:00
|
|
|
|
|
|
|
|
For platform porters:
|
|
|
|
|
|
2003-03-25 12:59:42 +00:00
|
|
|
- If you've ported lwIP to a platform (an OS, a uC/processor or a combination of these) and you think it
|
2003-03-24 09:00:14 +00:00
|
|
|
could benefit others[1] you might want to post an url to a tarball or zip from which it can be imported
|
2003-03-25 12:59:42 +00:00
|
|
|
to the contrib CVS module. Then you get CVS access and have to maintain your port :)
|
2003-03-24 09:00:14 +00:00
|
|
|
|
|
|
|
|
[1] - lwIP CVS should not be just a place to keep your port so you don't have to set up your own CVS :)
|
|
|
|
|
Especially welcome are ports to common enough OS/hardware that others can have access too.
|
