Contributing Source Code to the LimeWire Project
As developers become familiar with the LimeWire code base and fix minor annoyances, it is natural wonder how to contribute code so that others can benefit from it. Your work can be incorporated into the release version of LimeWire in two easy steps. First, you will create a patch file, and then you will submit that patch to us.
PATCH CREATION
The patch should be created by "diffing" the original file(s) with the modified software file(s). For example:
diff -u Main.java.orig Main.java >> patchfile.txt
Note that diffing files is easy if one is working with code that is checked out of CVS:
cvs diff -BbuN Main.java >> patchfile.txt
PATCH SUBMISSION
Send your patch files to codepatch@lists.limewire.org. Please provide a concise explanation of your work in the body of the email, and include patch files as email attachments.
You do not need to subscribe to the list in order to submit patches. However, for reference:
- To subscribe or unsubscribe via the web: http://www.limewire.org/mailman/listinfo/codepatch
- To subscribe via email, send to: codepatch-subscribe@lists.limewire.org
- To unsubscribe via email, send to: codepatch-unsubscribe@lists.limewire.org
PATCH APPLICATION
You can apply a patch file by executing the following:
patch -p0 < patchfile.txt
Note that you need to execute this command in the appropriate working directory. This directory can be deduced from the first line of the patch file. For instance, if the first line reads:
Index: com/limegroup/gnutella/gui/GUIMediator.java
The file com/limegroup/gnutella/gui/GUIMediator.java must exist in the current working directory. Therefore, the patch must be applied wherever the gui module is checked out.
