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
|
|
|
|
|
|
|
|
|
|
|
The suggestions:
|
|
|
|
|
2003-03-25 12:59:42 +00:00
|
|
|
- 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's a patch that affects both core and arch specific
|
2003-03-24 09:00:14 +00:00
|
|
|
stuff please separate them so that the core can be applied separately while leaving the other patch 'open'
|
2003-03-25 12:59:42 +00:00
|
|
|
The prefered way is to NOT touch archs you can't test and let maintainers take care of them. This is a good
|
2003-03-24 09:00:14 +00:00
|
|
|
way to see if they are used at all - the same goes for unix netifs except tapif.
|
2003-03-25 12:59:42 +00:00
|
|
|
- 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.
|
|
|
|
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-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.
|