Gmail FAQ


This is a list of the most frequently asked questions for Gmail, a Mysql based Gnome mail client.

1. General
Q:
2. Installation
Q:
Q:
3. Running Gmail
Q:
Q:
Q:
Q:
Q:
Q:
4. Supporting the Gmail project.
Q:
Q:

1. General

Q:

What is Gmail?

A:

Gmail is a Gnome mail client, that uses a MySQL database for data storage, allowing for a very powerful vfolder query system.

2. Installation

Q:

The Gmail druid keeps telling me the database it wants to create already exists. Why?

A:

You will need to pick a different database name if this is the case. The Gmail druid cannot currently reuse an existing database. To do that you will need to create a dummy database, and then change back to the database you want once you get gmail running.

Q:

How can I import all my old mbox style mailboxes? Or how can I make gmail read the mail in /var/spool/mail/user?

A:

The simplest way to import all your mbox style mailboxes is to use the pop3 server that is currently running on your system.

Simply copy your mbox file to /var/spool/mail/username, and then use Gmail to download the mail via POP3 from your localhost.

Most modern Unix distributions come with a running POP3 server.

3. Running Gmail

Q:

Can I make Gmail make cool sounds?

A:

Yes, simply go to the Sound->Sound_Events window in your Gnome control-center and you can configure as many different sounds as you like for a number of different events withing Gmail.

Q:

How can I configure what programs are launched when I double click on attachments?

A:

The program chosen is via the gnome MIME types. You can configure these via the Gnome control panel.

Q:

I can't download attachments bigger than 50k?

A:

This is due to a limitation in the database design from Gmail 0.6.0 and earlier. The best way to fix it is to go into the mysql command line client (using mysql -p) and typing: use dbname (press enter) ALTER TABLE details CHANGE message message LONGTEXT NOT NULL;

The details.message field now defaults to LONGTEXT in all gmail versions 0.6.5 and higher.

Q:

I can't download attachments bigger than around 1 MB?

A:

This is due to a limitation in the MySQL client communications buffer. It defaults in most installations to around 1MB. The server variable you need to change is called: 'max_allowed_packet'. Increase this to anything up to 24MB and you will be fine.

To change the default the best way is to create an /etc/my.cnf file with the following text:

[mysqld]
set-variable = max_allowed_packet=5M
	

Q:

How can I backup my Gmail mail?

A:

You simply need to backup the directory containing the MySQL database. This is usually '/var/lib/mysql', but it may depend on your distribution. If you database name is 'gmail', then you will need to backup the folder '/var/lib/mysql/gmail/'. See your MySQL documentation for complete information.

Q:

Will you be supporting APOP, and other mail protocols?

A:

Not in a hurry. The best solution is to use the excellent fetchmail program to fetch the mail to your local system then use gmail and basic POP3 from there. Fetchmail supports a wide range of mail protocols (inluding POP3 over SSL). If you find a bug with the basic gmail POP3 support, please report a bug.

4. Supporting the Gmail project.

Q:

How can I support the Gmail project?

A:

You can support the Gmail project by participating in the mailing list, giving bug reports and general feedback about how you think the project is going. It is really helpful when someone posts and says something like: "I've been using Gmail for 1 month now and I really like A, B, C and I really hate X, Y, Z.".

Information about the Gmail mailing list can be found at the Gmail web page.

If you really like the project you should promote it to your friends, mailing lists, posts to Slashdot etc.

Q:

How do I report a bug?

A:

Firstly decide if it is a feature request or a bug. If it is a feature request then check the TODO file first. If you want to make a feature request at least give a good explanation of why you think that feature is important.

If you want to make a bug report, make it to the gmail mailing list. Try and make sure you can narrow down very specificly the steps involved in reproducting the bug. If the bug isn't reproducable, it is difficult for anyone to do anything about it.

If the bug is a core-dump, it can be helpful to send a backtrace. Fortunately you can use the neat bug-buddy tool to do this for you. But please don't send a backtrace unless you have found a cleary reproducable bug and have explained how to make it crash very clearly.

This FAQ was written primarily by Wayne Schuller. (). Please send all comments and suggestions regarding this manual to the author.