3 |
Here is a short list of suggestions to anybody working with lwIP and |
Here is a short list of suggestions to anybody working with lwIP and |
4 |
trying to contribute bugreports, fixes, enhancements, platform ports etc. |
trying to contribute bugreports, fixes, enhancements, platform ports etc. |
5 |
First of all as you may already know lwIP is a volunteer project so feedback |
First of all as you may already know lwIP is a volunteer project so feedback |
6 |
to fixes or questions might often come late.Hopefully the bug and patch tracking |
to fixes or questions might often come late. Hopefully the bug and patch tracking |
7 |
features of savannah help us not lose users' input. |
features of Savannah help us not lose users' input. |
8 |
|
|
9 |
|
|
10 |
The suggestions: |
The suggestions: |
11 |
|
|
12 |
- if you think you found a bug make sure it's not already filed in the bugtracker at savannah |
- If you think you found a bug make sure it's not already filed in the bugtracker at savannah |
13 |
- if you have a fix put the patch on savannah.If it's a patch that affects both core and arch specific |
- If you have a fix put the patch on Savannah. If it's a patch that affects both core and arch specific |
14 |
stuff please separate them so that the core can be applied separately while leaving the other patch 'open' |
stuff please separate them so that the core can be applied separately while leaving the other patch 'open' |
15 |
The preffered way is to NOT touch archs you can't test and let maintainers take care of them.This is a good |
The prefered way is to NOT touch archs you can't test and let maintainers take care of them. This is a good |
16 |
way to see if they are used at all - the same goes for unix netifs except tapif. |
way to see if they are used at all - the same goes for unix netifs except tapif. |
17 |
- 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. |
- 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. |
18 |
If you correct an existing bug then attach the patch to the bug rather than creating a new entry in the patch area. |
If you correct an existing bug then attach the patch to the bug rather than creating a new entry in the patch area. |
19 |
- trivial patches (compiler warning, indentation and spelling fixes or anything obvious which takes a line or two) |
- Trivial patches (compiler warning, indentation and spelling fixes or anything obvious which takes a line or two) |
20 |
can go to the lwip-users list.This is still the fastest way of interaction and the list is not so crowded |
can go to the lwip-users list. This is still the fastest way of interaction and the list is not so crowded |
21 |
as to allow for loss of fixes.Putting bugs on savannah and subsequently closing them is too much an overhead |
as to allow for loss of fixes. Putting bugs on Savannah and subsequently closing them is too much an overhead |
22 |
for repoting a compiler warning fix. |
for reporting a compiler warning fix. |
23 |
|
|
24 |
For platform porters: |
For platform porters: |
25 |
|
|
26 |
- if you've ported lwIP to a platform (an OS, a uC/processor or a combination of these) and you think it |
- If you've ported lwIP to a platform (an OS, a uC/processor or a combination of these) and you think it |
27 |
could benefit others[1] you might want to post an url to a tarball or zip from which it can be imported |
could benefit others[1] you might want to post an url to a tarball or zip from which it can be imported |
28 |
to the contrib CVS module.Then you get CVS access and have to maintain your port :) |
to the contrib CVS module. Then you get CVS access and have to maintain your port :) |
|
|
|
29 |
|
|
30 |
[1] - lwIP CVS should not be just a place to keep your port so you don't have to set up your own CVS :) |
[1] - lwIP CVS should not be just a place to keep your port so you don't have to set up your own CVS :) |
31 |
Especially welcome are ports to common enough OS/hardware that others can have access too. |
Especially welcome are ports to common enough OS/hardware that others can have access too. |