[Home | FAQ | Big Picture | Architecture]

Mailpuccino: The Source

This is the development homepage.
Click here if you want to go to Mailpuccino's homepage instead.
My current email address is konget@kingkongs.org, please DO NOT use konget@cheerful.com anymore

Usage

I would expect that people downloading the source code will use it for educational purposes or because you'll like to work on the source code and add some new feature(s) or fix some bugs (and subsequently submit the changes to me for inclusion in the next version of Mailpuccino). If you are using the source code for purposes other than those stated above, please do send me an email and tell me what you're using the source code for! I'll appreciate it very much - Thanks!


Mailpuccino Open Source Development

Because development is collaborative and multiple people are involved, some coordination is required to avoid conflicts. So, please do read the following instructions on how make you own contribution to Mailpuccino:

  1. Join the Mailpuccino-Dev Mailing List if you're serious about contributing.
  2. Look at the Big Picture and decide on what features/bugs you might be interested to work on.
  3. Download the source code and understand it first; or at least understand the portions you're interested to work on. The Architecture document will help.
  4. Once you've decided on what feature/bug to work on, email me and I'll change the "Big Picture". =)
  5. Feel free to ask questions on the Mailpuccino-Dev Mailing List if you have any problems or uncertainties. Don't forget to checkout the FAQ first though.
  6. Once you're done, mail me the corrected code, which I will add to the main distribution.

Working on the Source

Mailpuccino does not no rely very much on external class libraries so far, with the only exception being Sun's JNDI/LDAP class libraries. So you'll need these libraries to compile the source. Because of the size of the source, plus the fact that Sun's Javac compiler is quite very slow, I recommend using IBM Alphaworks' Jikes Compiler. It's lightning fast - I use it for all my Java development.

For your convenience, you can obtain Sun's JNDI/LDAP JAR files from here:

Remember to add these JAR files to your CLASSPATH when compiling/running Mailpuccino.

When running Mailpuccino, remember that it must be run from the same directory as where the "*.prefs" files are stored (and "default" is a subdirectory, etc.). Mailpuccino's main class (where the "public static void main" method is) is "mailpuccino.Mailpuccino". Lastly, Mailpuccino should be developed for JDK 1.2 (there is no longer any effort to be backward compatible with JDK 1.1.x)


Joining the Mailpuccino-Dev Mailing List

You are highly encouraged to join the Mailpuccino-Dev Mailing List if you're serious about contributing to Mailpuccino's development. To subscribe, just send an email to: mailp-dev-subscribe@onelist.com. Message archives are can be found here.


Yeah Yeah Yeah, so where's the source?

On last thing: Mailpuccino and its source code is distributed under the terms of the GNU General Public License. Make sure you understand it before you start working on the source. Ok, here's the download page.


beijing tourist attractions · shanghai tourist attractions
hong kong tourist attractions · tourist attractions ·china tech blog