collaboration-world » projects » GNUMail » faq

faq

1 Compilation

1.1 How to compile GNUMail.app under GNUstep or Mac OS X?
(Linux/MacOS X)
First of all, you need to download the sources of Pantomime and GNUMail.app. Secondly, uncompress the archives in a directory and see the detailed build instructions for Pantomime (Pantomime/README) and for GNUMail.app (GNUMail/docs/README).
1.2 Some of the files have the wrong names.
(MacOS X)
This occurs when you use Stuffit Expander to extract the source code. Insted, make sure to extract the archive with either OpenUp or from the terminal with the following command:
% tar -zxvf GNUMail-X.Y.Z.tar.gz
1.3 When I type make I get:
GNUmakefile:23: /common.make: No such file or directory
GNUmakefile:27: /aggregate.make: No such file or directory
make: *** No rule to make target `/aggregate.make'. Stop.
(Linux)
Install GNUstep and make sure to load the development configuration file before attempting to compile GNUMail:
% . /usr/GNUstep/System/Makefiles/GNUstep.sh

2 Download

2.1 All files I downloaded are named download.cgi or mirror.cgi.
(MacOS X)
Some browsers have problems with our CGI scripts (or is it the opposite? ;). You have two solutions:
  • You use Netscape/Mozilla or Internet Explorer to download the releases or
  • You rename the file with the proper extension (either .tar.gz or .dmg)
2.2 What does the Mac OS X binary version of GNUMail contains? Does it requires any additionnal files?
(MacOS X)
In the disk image of GNUMail, you'll find an application bundle that includes everything required to run GNUMail. There's no special installation procedure; you only have to drag and drop GNUMail in your applications folder and you're ready to go!

3 Runtime

3.1 GNUMail launches but dies immediately.
(Linux/MacOS X)
This happens when you used a previous version of GNUMail. You must remove your old preferences files.
To solve this problem, simply remove all files associated to GNUMail found in your ~/Library/Preferences directory.
3.2 How do I get PGP/GPG working?
(MacOS X)
To get PGP/GPG working, you must first install GnuPG. If you are using Apple Mac OS X, you can download a dmg here (click on GNU Privacy Guard 1.0.7r2 or 1.2.3).
Once you've installed and configured GnuPG (generated your keys, etc.), you can download the PGP bundle for GNUMail.app/Mac OS X here.

Mount the image and copy the PGP.bundle to your ~/Library/GNUMail/ directory. Restart GNUMail.app and everything should be fine.

Note that those instructions currently only work under OS X. GNUstep users must compile themselves the bundle and install it in ~/GNUstep/Library/GNUMail/
3.3 How do I import my mailboxes from Mail.app to GNUMail.app?
(MacOS X)
The easiest way is to drag the desired mailboxes to the desktop. For every file exported to the desktop, control-click (or right-click) on it and choose "Show Package Contents". Renamed the file "mbox" to the mailbox name and move it to your GNUMail folder (~/Library/GNUMail/Mailboxes).
3.4 How do I integrate Bogofilter with GNUMail.app?
(Linux/MacOS X)
  1. Download and install Bogofilter
    • Precompiled? versions for OS X with fink
    • Bogofilter Homepage link
  2. Train Bogofilter with Spam and Ham (approx. 100 Mails each)
  3. In GNUMail create a folder for spam mails
  4. Set up a filter for Bogofilter
    • Process with external program
    • full path of the bogofilter like: /sw/bin/bogofilter
    • parameters -p (passthrough), -e (embedded), don't know if needed, -u (update), only if already trained well
    • "Expert" criteria string: X-Bogosity which must contain the string "Yes"
    • Transfer to spam mailbox
  5. False Positive/Negative handling
    • Additional mailboxes like SpamIsHam and HamIsSpam
    • HamIsSpam: mail that is spam but was delivered to the Inbox
    • SpamIsHam: mail that is ham but was pushed to the spam mailbox
    • Train HamIsSpam with "bogofilter -Ns -M < HamIsSpam", delete mails from HamIsSpam mailbox or move them to Spam, compact folder HamIsSpam
    • Train SpamIsHam with "bogofilter -Sn -M < SpamIsHam", move mails from SpamIsHam to Inbox, compact folder SpamIsHam
    • If spam mailboxes and Inbox are in Maildir format I provide a Shell-Skript for training

For detailed information, see this link.

3.5 How do I use SpamAssassin with GNUMail.app?
(Linux/MacOS X)
First of all, download and install SpamAssassin. You can find detailed instructions on how to install it here. For detailed instructions on how to install it under Mac OS X, click here. Once you have installed SpamAssassin, you can add a new filter rule by doing:
  • Select the Filtering Preferences Panel
  • Add a new Filter
  • Click on the checkbox "Process with external program"
  • In the text field, specify the full path of the spamassassin like:
    /usr/bin/spamassassin
  • Add an "Expert..." criteria string. You should add the header name:
    X-Spam-Flag
  • Specify that this criteria must
    Contains
    the string
    YES
  • Specify any other criterias (if you want to)
  • Finally, select the action. It is recommanded to select the "Transfer to mailbox" action (you could have a "spam" mailbox, where all the messages flagged as spam by SpamAssassin will be save to)
3.6 How to specify an other ~/gnumail directory?
(Linux/MacOS X)
First of all, quit GNUMail.app. It must not be running.
If for example, you want to move /Users/Bob/gnumail to /Users/Bob/Mailboxes, type the following from a terminal session:
defaults write GNUMail LOCALMAILDIR "/Users/Bob/Mailboxes"
You need version 1.1.0 pre1 or above for this to work.
3.7 I can't seem to be able to add an IMAP account properly in 1.1.0pre2. What can I do?
(MacOS X)
First of all, we are sorry for this bug. We produced a fixed dmg version of GNUMail.app 1.1.0pre2. You can download it here.
3.8 Under Mac OS X, how do I enable the Emoticon and the Face bundles?
(MacOS X)
First of all, you must download the bundles. You can get the Emoticon bundle here and the Face bundle here. Once you've downloaded the bundles, you must mount the disk images (dmg) and copy the Emoticon.bundle and Face.bundle folders to your ~/Library/GNUMail/ folder. Finally, restart GNUMail.app and enjoy those added bundles!
3.9 When I start GNUMail.app, I get: Could not open LocalStore.
(Linux/MacOS X)
This message is due to the fact that you used a previous version of GNUMail.app but you removed your ~/gnumail (under GNUstep, or ~/Library/GNUMail/Mailboxes under Mac OS X) directory.
To solve this problem, simply do:
% mkdir ~/gnumail (or ~/Library/GNUMail/Mailboxes under Mac OS X)
% cd ~/gnumail (or ~/Library/GNUMail/Mailboxes under Mac OS X)
% touch Inbox
% touch Oubox
% touch Trash
% touch Drafts
and restart GNUMail.app.