[ SourceForge ] SylpheedDoc

Home

Documentation

Contribution

Sylpheed FAQ

Paul Kater

Jens Oberender

Francois Barriere

Olivier Delhomme

Petr Kovar

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

Revision History
Revision 1.9 2005/07/08 OD
Ported to DocBook XML.
Revision 2.0 2009/10/02 PK
Finished porting to DocBook XML, updated many questions across the document to conform with Sylpheed 2.7.1.
Revision 2.1 2010/04/14 PK
Updated with regard to Sylpheed 3.0.2.
Revision 2.2 2010/08/09 PK
Updates for the upcoming Sylpheed 3.1.

Abstract

This document contains answers to various questions, which are frequently asked by Sylpheed users. It consists of three sections providing general information, information on Sylpheed installation and configuration, and on Sylpheed interface.


Chapter 1. Sylpheed FAQ - General Information

1.1. Are there FAQ's in other languages?
1.2. What is Sylpheed?
1.3. Where can I get Sylpheed?
1.4. Who writes Sylpheed?
1.5. What does the name Sylpheed mean?
1.6. How does Sylpheed store mails?
1.7. Why does the auto collection of mail not work?
1.8. Does Sylpheed have mail filtering?
1.9. Can Sylpheed handle IMAP mail?
1.10. Can Sylpheed handle local unix mailboxes?
1.11. Can Sylpheed handle IPv6?
1.12. Does Sylpheed support encryption like GPG?
1.13. How does Sylpheed check for MIME types?
1.14. Does Sylpheed allow me to write HTML styled messages?
1.15. Does Sylpheed have automatic name completion in the address fields?
1.16. Fine, but when I hit the Tab key I either get an error message or nothing happens at all.
1.17. Why is Sylpheed so fast?
1.18. Where can I get the current patches for Sylpheed?
1.19. How can I send in patches, report bugs, talk about Sylpheed with others?
1.20. When I send mail, the Content-Type header says the mail is in US-ASCII, even when I specified ISO-8859-1?
1.21. Why does it look like word wrap is not working?
1.22. How do I copy my mail archive to another machine?
1.23. Can I import a mbox into Sylpheed's MH mailfolders?
1.24. Can I use procmail to sort my mails with the MH mail handling?
1.25. When I upgrade Sylpheed, are there things I should be aware of?
1.26. How can I quickly update the views in Sylpheed?
1.27. Why can't I use gvim as external editor?
1.28. Can I quote just parts of the original message when replying?
1.29. Can I reply without quoting at all?
1.30. Does Sylpheed provide an anti-spam feature?
1.31. Are there any plug-ins extending standard Sylpheed functionality?
1.32. Where I can find the latest Sylpheed FAQ and manual?
1.33. Where I can obtain source files for this document?
1.34. I have found an error and/or outdated information in this document!
1.35. Who are the members of the Sylpheed Documentation Project?
1.1.

Are there FAQ's in other languages?

Yes. Here are links to several translations:

You can always download this FAQ from the Sylpheed Documentation Project website.

Note

Did not find your language in the list? Would you like to contribute with a new translation to the Sylpheed Documentation Project? Then please contact the Project members at their website. Thanks in advance.

1.2.

What is Sylpheed?

Sylpheed is an email client (and news reader) based on GTK+, running on the X Window System or Microsoft Windows, and aiming for:

  • Quick response

  • Graceful, and sophisticated interface

  • Easy configuration, intuitive operation

  • High reliability

  • Internationalization and multilingualization support

  • Abundant features

As the Sylpheed README file reads: The appearance and interface are similar to some popular e-mail clients for Windows, such as Outlook Express or Becky!. Many commands are accessible with the keyboard like the Emacs-based mailers such as Mew and Wanderlust. So you will be able to migrate to Sylpheed without much discomfort, even if you are accustomed to other mailers.

1.3.

Where can I get Sylpheed?

You can download it from the download page on Sylpheed website. There are links to download tarball sources, patches to the previous version, and also links to the Sylpheed for Windows binaries, including the installer, the ZIP archive, and the patch to the previous Sylpheed for Windows version.

Depending on the state of the Sylpheed development cycle, you may be offered links to development versions such as beta and RC releases. These might not be suitable for everyday use, however, so you may want to stick with the stable release, anyway.

Also on the download page, you can download Sylph-Searcher (which is a program that enables fast full-text search of messages stored in mailboxes of Sylpheed, or normal MH folders), and LibSylph (which is a library that provides Sylpheed core features independent from the UI of Sylpheed).

1.4.

Who writes Sylpheed?

Hiroyuki Yamamoto .

1.5.

What does the name Sylpheed mean?

It means light weight, like air. This comes from the name of the wind spirits, the Sylphs.

1.6.

How does Sylpheed store mails?

Mails are stored in the MH mailfile format as used by MH and EMH. Maildir, mbox, and eml formats are not (yet) supported, although it is possible to import an mbox file or an eml file into a Sylpheed mailbox.

You can manage your mails just with Sylpheed, or together with another mailer based on the MH format (e.g. Mew). The MH format has less possibility of losing mails on failures since one file corresponds to one mail. You can also utilize fetchmail and/or procmail, and external programs on receiving (like inc or imget).

1.7.

Why does the auto collection of mail not work?

Auto collection works since version 0.5.1. If you need it or want it, you should upgrade.

1.8.

Does Sylpheed have mail filtering?

Yes. You can find it in Configuration -> Filter settings...

Please note that filtering is not yet implemented for IMAP accounts.

1.9.

Can Sylpheed handle IMAP mail?

Yes. As of version 0.4.99 IMAP is supported.

1.10.

Can Sylpheed handle local unix mailboxes?

Yes.

1.11.

Can Sylpheed handle IPv6?

Yes, IPv6 is fully supported in Sylpheed.

1.12.

Does Sylpheed support encryption like GPG?

Yes. GPG is implemented and works fine. For activating it in Sylpheed, see the appropriate question in the Installation section.

1.13.

How does Sylpheed check for MIME types?

Sylpheed uses the Mutt type of mime checking.

1.14.

Does Sylpheed allow me to write HTML styled messages?

No. A discussion has gone around over this topic, and the outcome was that HTML mail is not wanted. If you really need to send HTML, you can of course attach a web page to an email.

1.15.

Does Sylpheed have automatic name completion in the address fields?

Yes. When you search for a name that starts with "don", type "don" (without the quotes) and it will show you the correct name (when only one "don" exists in your address book. Otherwise a drop-down list appears, which allows you to select the name you want. E.g. Donald Duck, Don Johnson. But also email addresses starting with "don" will appear in the list (like "don.giovanni@maffia.org").

Prior to Sylpheed 3.1, users needed to press the Tab key before the search would start. If you still prefer the previous behavior, you can enable it by checking Configuration->Common preferences...->Details->Other->Address book+Address auto-completion:+Start with Tab.

1.16.

Fine, but when I hit the Tab key I either get an error message or nothing happens at all.

When you want to use name completion, make sure that there are names in your address book. If there are no names, even Sylpheed has a hard time completing something.

If nothing happens at all when typing text in the address fields, make sure that you have the address auto-completion enabled by checking that the following preference is not selected: Configuration->Common preferences...->Details->Other->Address book+Address auto-completion:+Disabled.

1.17.

Why is Sylpheed so fast?

That's what it is designed for!

1.18.

Where can I get the current patches for Sylpheed?

In most cases, current patches are being posted by Sylpheed users and contributors to the Sylpheed mailing list . (Also see the Installation section on how to install a patch.)

1.19.

How can I send in patches, report bugs, talk about Sylpheed with others?

To talk to others, you should join the Sylpheed mailing list at http://www.sraoss.jp/mailman/listinfo/sylpheed . Note that there is a Japanese and an English list, so pick the right one! If you have made a patch that you want the world to know of, please post it either to the mailing list, or contact the Sylpheed author, Hiroyuki Yamamoto .

Please supply the information of Tools->Log window, or the contents of sylpheed.log, which is located under the configuration folder, when reporting bugs.

1.20.

When I send mail, the Content-Type header says the mail is in US-ASCII, even when I specified ISO-8859-1?

If ISO-8859-1 characters (>= 0x80) are not used in the message body, Sylpheed will automatically set the charset value in the Content-Type header as US-ASCII.

1.21.

Why does it look like word wrap is not working?

Word wrapping is a bit peculiar perhaps. You can type lines as long as you like. By the time you send or queue a mail with long lines, Sylpheed will first wrap the lines to the line length you set up, and then the mail is queued. This is more convenient than you think. Once a line is wrapped (hard line breaks are inserted in the text) and you add something in a line there, the next line will move to a separate new line, leaving one or two words from the previous line "hanging there" alone. E.g.

           This is a long line that
           is wrapped.        

Now you add one word in the first line:

           This is a very long line
           that
           is wrapped        

This would cause you a lot of manual reformatting to get a presentable mail again.

Note

As of Sylpheed 0.8.0., active word wrap has been implemented. You can turn it on in Common Preferences->Compose->Editor+Wrap on input.

1.22.

How do I copy my mail archive to another machine?

You need to copy the sylpheed-2.0 directory with your user profile, and your entire local mail archive.

Under UNIX, the user profile is stored in $HOME/.sylpheed-2.0 by default, and your local mail archive is by default located in $HOME/Mail.

While under Windows 2000/XP, the user profile is stored in C:\Documents and Settings\(user name)\Application Data\Sylpheed by default, and your local mail archive is by default located in C:\Documents and Settings\(user name)\Application Data\Sylpheed\Mailboxes\Mail.

Under Windows Vista/Seven, the directory paths are C:\Users\(user name)\AppData\Roaming\Sylpheed, and C:\Users\(user name)\AppData\Roaming\Sylpheed\Mailboxes\Mail, respectively.

1.23.

Can I import a mbox into Sylpheed's MH mailfolders?

Yes, just create/select the folder you want your mails in, and select Import mbox file... in the File menu.

1.24.

Can I use procmail to sort my mails with the MH mail handling?

Yes. Just make sure that you add /. to the end of a rule so procmail knows you are filtering into an MH mail folder. Example:

0:
* ^Subject:.*sylpheed
sylpheedmail/.

Check man procmail for details.

1.25.

When I upgrade Sylpheed, are there things I should be aware of?

Yes!

  • Upgrade to 0.4.50: you should reconfigure your newsgroup settings

  • Upgrade to 0.4.63: you should set the URL string colors from the Configuration menu

  • Upgrade to 0.4.65: some menu items have been moved

  • Upgrade to 0.7.3: many key bindings have changed

  • Upgrade to 2.2.3 or former on Windows: all configuration files such as mailboxes or bsfilter files are removed when performing the upgrade and/or uninstallation, so please be careful and backup your data

You should always read the NEWS document (and also NEWS-x.0 if you are upgrading from a very old version) that is included in the release tarballs. The NEWS can also be viewed on the appropriate Sylpheed website page.

1.26.

How can I quickly update the views in Sylpheed?

Just press Alt-U or select Update summary from the View menu.

1.27.

Why can't I use gvim as external editor?

If one wishes to use gvim as an external editor it's necessary to start it with the no-fork option -f, i.e. in the configuration dialog box you need to enter gvim -f %s. If not the editor forks and open up a separate file and when one quits the editor the changes are lost and don't show up in the composer window. (Thanks, Ed Collins!)

1.28.

Can I quote just parts of the original message when replying?

Yes, select the part in the text view and choose Reply.

1.29.

Can I reply without quoting at all?

You need to disable quoting by editing the reply format under Configuration->Common preferences->Compose tab->Format tab (also works with forward format which you can see below the reply format in the configuration dialog).

1.30.

Does Sylpheed provide an anti-spam feature?

Yes. It has a bogofilter and a bsfilter support. Just go to Configuration->Common preferences...->Junk mail and check Enable Junk mail control. Then you can select a Learning command preset of your choice, or possibly use custom commands.

You can also use other spam filters thanks to the Actions functionality (available under Configuration->Actions...).

Note

You need to have bogofilter, bsfilter, or other spam filter properly installed on your system prior to the junk mail configuration in Sylpheed, unless you use Sylpheed for Windows, which comes with bsfilter included in the installation program (since version 2.7.0).

1.31.

Are there any plug-ins extending standard Sylpheed functionality?

As of Sylpheed 3.1, there is an Attachment Tool Plug-in distributed with the Sylpheed source code and available under plugin/attachment_tool/. Its only function is to remove attachments from selected messages and is provided more or less as a technology preview. More plug-ins are planned since Sylpheed 3.0, released in early 2010, and later supports a plug-in interface. In the future, some of the Sylpheed features will be re-implemented as plug-ins, and, moreover, various other plug-ins will be released.

There is a page on the Sylpheed website dedicated to the plug-in interface. Additionally, the PLUGIN.txt file distributed directly with Sylpheed can provide you with some basic information on the topic.

Note

If you are a developer interested in creating plug-ins for Sylpheed, see the plug-in specification on the Sylpheed wiki.

1.32.

Where I can find the latest Sylpheed FAQ and manual?

Go to http://sylpheeddoc.sourceforge.net and check out the FAQ and manual from the Sylpheed Documentation Project (sylpheeddoc). Both documents are available in multiple languages there and usually contain the latest updates. The direct links are as follows:

Also see the question about available language versions at the top of this section.

1.33.

Where I can obtain source files for this document?

The source DocBook XML files in which this document is written can be obtained from a public CVS repository that is part of the Sylpheed Documentation Project. The source files with all the necessary build system, XSL stylesheets or snapshots are stored under the "doc" module in the CVS repository and can be checked out through anonymous CVS with the following commands (simply press Enter when prompted for a password):

cvs -d:pserver:anonymous@sylpheeddoc.cvs.sourceforge.net:/cvsroot/sylpheeddoc login

cvs -z3 -d:pserver:anonymous@sylpheeddoc.cvs.sourceforge.net:/cvsroot/sylpheeddoc co -P doc

The source files are also included in .tar.gz and .zip archives made available with each documentation release, these can be downloaded from the appropriate project page. For more information on the used project infrastructure, please see the project website.

1.34.

I have found an error and/or outdated information in this document!

Please report any errors, misleading and/or outdated information to the Sylpheed Documentation Project. You can see the list of Project members in the following question, so you can also contact them directly.

1.35.

Who are the members of the Sylpheed Documentation Project?

The current members of the Sylpheed Documentation Project are:

Francois Barriere      fbarriere at users.sourceforge.net
Petr Kovar             pknbe at users.sourceforge.net

Below is the list of former members of the Sylpheed Documentation Project. Big thank you goes to all of them!

Martin   Bretschneider furbour at users.sourceforge.net
Olivier  Delhomme      dup at users.sourceforge.net
Doruk    Fisek         dobidik at users.sourceforge.net
Melvin   Hadasht       mhadasht at users.sourceforge.net
Nicolas  Kaiser        nikai at users.sourceforge.net
Paul     Kater         pkater at users.sourceforge.net
Ricardo  Mones Lastra  mones at users.sourceforge.net
Jens     Oberender     jobi at users.sourceforge.net
Marcelo  Ramos         hackpando at users.sourceforge.net
Guido    Rudolphi      malatesta at users.sourceforge.net
Frank    Weng          fweng at users.sourceforge.net

Chapter 2. Sylpheed FAQ - Installation and Configuration

2.1. What does it take to compile Sylpheed?
2.2. How do I set up Sylpheed?
2.3. Why did the creation of the mailbox fail?
2.4. How do I set up an account?
2.5. How many accounts can I set up in Sylpheed?
2.6. Can I set up an account for sending mail only?
2.7. Why does Sylpheed not delete my mails when I press "Delete"? I set a filter, and Sylpheed does not filter. I moved a mail to a different mailbox and it did not move.
2.8. Can I set up special addresses/ports for my mailserver/newsserver?
2.9. Does Sylpheed have options for threading messages?
2.10. Can I create multiple levels of subfolders to store mail?
2.11. Why isn't Sylpheed sending my mail out?
2.12. How do I apply a patch after downloading it?
2.13. How do I compile in support for compface pictures?
2.14. How do I make my own compface image?
2.15. How can I tell my browser/newsclient/other program to use Sylpheed as email program?
2.16. How do I enable GPG support in Sylpheed?
2.17. Mutt does not recognize Sylpheed's MH structure
2.18. Viewing a GIF file within Sylpheed causes a segmentation fault.
2.19. How Sylpheed checks for new mail?
2.20. How can I make Sylpheed notify me when new mail arrives?
2.21. Can I use a spell checker with Sylpheed?
2.22. How can I make Sylpheed send my compface image in the mails?
2.23. How can I get the newest source code from the Sylpheed Subversion (SVN) repository?
2.24. I checked out the sources using SVN and can't find any configure script.
2.25. Running "autogen.sh" gives error messages that "AM_PATH_GDK_PIXBUF" or "AM_PATH_(whatever)" is not found.
2.26. I don't want to compile in support for (...) any longer, but after running "configure", those libraries are still used.
2.27. How can I select different applications to open with specific MIME types?
2.28. How can I change the suggested mimetype for attachments?
2.29. The folder list is not updated after I manually moved/copied folders.
2.30. How can I revert original settings, e.g. for fonts, key bindings, etc.?
2.31. What environment variables have effect on Sylpheed?
2.32. Special characters (e.g. umlauts) are not displayed correctly.
2.33. How can I convert my old mailbox/address book from (some mail client).
2.34. What config files are there, and what are they used for?
2.35. How do I change the location of user profile directory under Windows?
2.36. Can I run multiple instances of Sylpheed?
2.37. What to do when printing an email prints off the paper?
2.1.

What does it take to compile Sylpheed?

Any POSIX compliant UNIX or similar OS, e.g. Linux, FreeBSD, Solaris. GTK+ 2.4.0 or later (GTK+ 2.6.0 or later is recommended). A recent ANSI C compiler (gcc 2.7.2.3 should also work).

Note

It is reported that Sun C will not compile Sylpheed.

Optionally:

  • compface (for X-Face)

  • GPGME (for GnuPG)

  • OpenSSL for SSL support

  • GtkSpell for a spell checking feature

  • cURL for allowing Sylpheed to check for updates

  • JPilot

  • LDAP

  • the equivalent of GTK+-devel and Xfree86-devel

  • you may also require flex (lex) and bison (yacc).

Otherwise ./configure will fail. See also the INSTALL file that is being distributed with the Sylpheed tarball.

Note that as Sylpheed now supports the Windows platform, you can also compile it using MinGW.

2.2.

How do I set up Sylpheed?

When you run Sylpheed for the first time, it will ask you where you want to store your mailboxes. The default is $HOME/Mail (or %APPDATA%\Sylpheed\Mailboxes\Mail under Windows). You can change this to anything you like as long as it is a valid directory name.

Note

When Sylpheed is executed for the first time, it automatically creates the configuration files under $HOME/.sylpheed-2.0/ (or %APPDATA%\Sylpheed\ under Windows), and asks you the location of mailbox. As stated above, the default is $HOME/Mail, or %APPDATA%\Sylpheed\Mailboxes\Mail under Windows. If some files, which are non-MH format, already exist on the directory, you will have to specify another location.

Furthermore, you need to create at least one account to be able to receive or send messages.

2.3.

Why did the creation of the mailbox fail?

Sylpheed reports such an error if it can't create the default mailboxes (inbox, outbox, etc.). This can be because $HOME/Mail (or %APPDATA%\Sylpheed\Mailboxes\Mail under Windows) already contains files with the same names. This occurs when switching from Kmail to Sylpheed, in this case backup and remove the existing Mail directory or use another name for the Sylpheed mail directory.

2.4.

How do I set up an account?

After loading Sylpheed for the first time, you can add an email account by clicking the Configuration menu. Select the option Create new account and let the configuration assistant help you with the initial setup. In a few easy steps, the assistant allows you to conveniently configure your POP3, IMAP4, or Gmail account.

Tip

If you want later to change your account configuration, just select Configuration->Preferences for current account..., or Configuration->Edit accounts...

2.5.

How many accounts can I set up in Sylpheed?

The number is unlimited. The limit is reached when your computer stops responding.

2.6.

Can I set up an account for sending mail only?

Yes, add a new account using Configuration->Edit accounts...+Add and set the Protocol to None (local).

2.7.

Why does Sylpheed not delete my mails when I press "Delete"? I set a filter, and Sylpheed does not filter. I moved a mail to a different mailbox and it did not move.

You have to click the Execute button. The other solution: in the configuration settings (Common preferences...->Details->Interface), you have to check the Execute immediately when moving or deleting messages box.

2.8.

Can I set up special addresses/ports for my mailserver/newsserver?

Yes, you can. Under Configuration->Preferences for current account...->Advanced, you can specify the exact port addresses you want to use.

2.9.

Does Sylpheed have options for threading messages?

Yes. You can switch it on and off in the View menu, just select Thread view or press Ctrl-T.

2.10.

Can I create multiple levels of subfolders to store mail?

Absolutely. This is no problem.

2.11.

Why isn't Sylpheed sending my mail out?

You need to create at least one account in order to send. (This is a wonderful gotcha on LAN installs with only a local mailbox feed).

2.12.

How do I apply a patch after downloading it?

Copy patch to sylpheed directory. Apply the patch as follows:

% patch -p0 < some.patch

Or, if it's gzipped:

% gzip -dc some.patch.gz | patch -p0

Run ./autogen.sh, remove the generated /config.cache file (unless you want to install in prefix /usr/local). Run ./configure with the appropriate options and then make. (Text as found on the former Sylpheed patches page.)

2.13.

How do I compile in support for compface pictures?

You have to have a package called libcompface installed, so this is available for compiling into Sylpheed. Note that the exact name of the package depends on OS or distribution you use.

2.14.

How do I make my own compface image?

The faces package contains a program called xbm2ikon script, which converts a 48x48 xbm to the format suitable for compface. Thanks to Jeff Dairiki, you can have a complete online course in this. Visit this page for the details.

2.15.

How can I tell my browser/newsclient/other program to use Sylpheed as email program?

In the settings part of the program, write sylpheed --compose

Specific options for typical browsers:

  • Opera: sylpheed --compose [mailto:%t][?subject=%s]

  • Galeon: sylpheed --compose "mailto:%t?subject=%s"

2.16.

How do I enable GPG support in Sylpheed?

When compiling Sylpheed, make sure you add --enable-gpgme in the ./configure command. When that completes successfully, there is a Privacy section in the Common Preferences.

2.17.

Mutt does not recognize Sylpheed's MH structure

For this to work you need to use the touch command in every MH folder. "touch" the file .xmhcache and Mutt should do just fine.

2.18.

Viewing a GIF file within Sylpheed causes a segmentation fault.

In case this happens, you can easily fix that by adding the following to /etc/mime.types:

image/gif gif
2.19.

How Sylpheed checks for new mail?

New mail can be retrieved either manually or automatically.

To check for new mail the manual way, you can:

  1. Either press the Get button on the toolbar to incorporate new mail for the current account only, or use the Get all button to incorporate new mail for all configured accounts.

  2. Or choose File->Mailbox->Check for new messages, or Check for new messages in all mailboxes.

  3. Or select Message->Receive->Get from current account, or Get from all accounts.

Tip

If you have a POP3 account and don't want to retrieve all the new messages stored on remote server to your computer, you can manage your account remotely (e.g. open or delete individual messages) by choosing Message->Receive->Remote mailbox...

If you prefer autochecking for new mail instead, first of all, make sure that you have checked Configuration->Common preferences...->Receive+Autocheck new mail every 10 minute(s). Optionally, you can adjust the interval value (in minutes) as well.

Also check your settings under Configuration->Edit accounts... You will find this at the top: Check the boxes on the 'G' column to enable message retrieval by 'Get all'. The setting applies on both manual and automatic mail checks.

2.20.

How can I make Sylpheed notify me when new mail arrives?

Download Gkrellm or a similar program that is able to notify you of new incoming mail. Gkrellm is available at the Gkrellm page.

2.21.

Can I use a spell checker with Sylpheed?

Yes. You need to have GtkSpell installed prior to Sylpheed compilation. The support for GtkSpell is enabled by default in configure. (If you want to disable it, make sure you add --disable-gtkspell in the ./configure command.)

The GtkSpell option is not supported in Sylpheed for Windows (yet), so you will have no spell checking under this OS.

2.22.

How can I make Sylpheed send my compface image in the mails?

In the Configuration->Preferences for current account...->Send check Add user-defined header and press Edit button. A dialog appears, add a header named "X-Face" and fill the value field with your face data. Note that if you paste the data from a terminal into the field, some spurious newlines can be added, and these can mangle your face, be careful.

2.23.

How can I get the newest source code from the Sylpheed Subversion (SVN) repository?

Move to an appropriate directory, and after you run the command specified below, a source tree named trunk will be created under that directory:

svn checkout svn://sylpheed.sraoss.jp/sylpheed/trunk

The subdirectories under the sylpheed directory are as follows:

  • trunk/ - main tree

  • branches/ - miscellaneous experimental branches

  • tags/ - release-tagged branches

To update to the newest source tree, run the following command in the target directory:

svn update

2.24.

I checked out the sources using SVN and can't find any configure script.

The SVN versions are meant to be used by developers rather than "normal" users, so the source (or binary) distributions are easier to use.

Yeah, but the latest features from SVN really look sexy...

You need to generate the configure script by running autogen.sh. Be sure to have autoconf and automake packages installed for this.

2.25.

Running "autogen.sh" gives error messages that "AM_PATH_GDK_PIXBUF" or "AM_PATH_(whatever)" is not found.

There are some *.m4 files in the ac/missing directory. Try to copy them into the ac directory and run autogen.sh again.

If there are still some .m4 files not found (e.g. those from GTK+), try to run % locate m4 | less or % locate aclocal | less to find additional directories containing those macros. If you find e.g. a gtk.m4 in /opt/gnome/share/aclocal, change following line in autogen.sh from

aclocal -I ac \

to

aclocal -I ac -I /opt/gnome/share/aclocal \

and run it again.

2.26.

I don't want to compile in support for (...) any longer, but after running "configure", those libraries are still used.

Remove the config.cache file and run ./configure again. You should also use make clean to avoid undefined references.

2.27.

How can I select different applications to open with specific MIME types?

The MIME-type to application associations are kept in /etc/mailcap.

2.28.

How can I change the suggested mimetype for attachments?

The extension to MIME-type associations are kept in /etc/mime.types

2.29.

The folder list is not updated after I manually moved/copied folders.

You need to update Sylpheed cache. Right click on the mailbox and choose Rebuild folder tree.

2.30.

How can I revert original settings, e.g. for fonts, key bindings, etc.?

Sylpheed keeps its configuration files in $HOME/.sylpheed-2.0/sylpheedrc (or %APPDATA%\Sylpheed\sylpheedrc under Windows) and creates default entries, if none are found. So the easiest way is to quit Sylpheed, temporarily renaming your $HOME/.sylpheed-2.0 (or %APPDATA%\Sylpheed\sylpheedrc) e.g. to *.bak and restarting Sylpheed in order to get default entries.

2.31.

What environment variables have effect on Sylpheed?

Here are the most common variables:

  • HOME - location of .sylpheed-2.0 (config directory) and default folder for Mailboxes.

  • LANG,

  • LC_ALL,

  • LC_CTYPE,

  • LC_MESSAGES - locale settings, e.g. language and date format.

For more information on how to make Sylpheed display your language, see the relevant question.

2.32.

Special characters (e.g. umlauts) are not displayed correctly.

In most cases, this is caused by fonts that use an unsuitable encoding on a not Unicode-based system. (On a Unicode-based system, fonts should support all thinkable characters for the vast majority of languages.)

Choose Configuration->Common preferences...->Display->General, and click the button right to Text font. Now, a special dialog appears that allows you to pick a desirable font family, style, and size.

You should also make sure that your environment variables regarding locale settings have sensible values.

2.33.

How can I convert my old mailbox/address book from (some mail client).

You can try to export your old mailbox to MH, MBOX or EML format.

Tip

Take a look at the Add sender to address book... item from the Tools menu, it could be a useful alternative or addition, when importing your old contacts.

2.34.

What config files are there, and what are they used for?

Sylpheed config files can be found in $HOME/.sylpheed-2.0 (under Windows, the path is %APPDATA%\Sylpheed). They are in plain text format and quite easy to understand, so don't fear to take a look into them using a text editor.

  • sylpheedrc - main configuration: nearly all options from the settings window, e.g. mailbox location, font entries, etc.

  • accountrc - settings for POP/IMAP/NNTP accounts

  • actionsrc - user-defined actions

  • addrbook-*.xml - contents of your address book

  • customheaderrc - contains user-defined header lines

  • dispheaderrc - headers to display above the mail body

  • filter.xml - filter settings

  • folderlist.xml - folder specific settings, e.g. hiding read messages, sort order, etc.

  • menurc - key bindings

2.35.

How do I change the location of user profile directory under Windows?

The configuration files and the mailboxes are saved under the following location (%APPDATA%\Sylpheed) by default:

  • Windows 2000/XP: C:\Documents and Settings\(user name)\Application Data\Sylpheed

  • Windows Vista/Seven: C:\Users\(user name)\AppData\Roaming\Sylpheed

If you want to change the location of the configuration files, you can specify it by the command line option --configdir "directory name". Create a shortcut of sylpheed.exe, and append the option to the link target like the following:

"C:\Program Files\Sylpheed\sylpheed.exe" --configdir "D:\Sylpheed"

If sylpheed.ini file exists at the same location as sylpheed.exe, it will be loaded at startup. With this approach, you can make Sylpheed completely portable independent of drive letters etc., and you can install it in removable media such as USB memory.

Note

The installer version, and GnuPG and GPGME use registry.

The sample INI file is included in the Sylpheed for Windows installation package as sample-sylpheed.ini. Please copy or rename it to use. ipcport specifies the port number of socket for IPC (default is 50215). configdir specifies the location of configuration files as a relative path from the folder in which sylpheed.exe is located, or an absolute path.

(The text above is a slightly modified excerpt from the README-win32.txt file, which you should find within the C:\Program Files\Sylpheed directory.)

2.36.

Can I run multiple instances of Sylpheed?

Yes, Sylpheed 3.1 adds support for this often requested feature. The format of the multiple instances command is as follows:

sylpheed --instance-id ID --configdir path-to-alternative-configdir

Default ID is set to sylpheed, so you can specify any other instance ID. The ID is used for the name of unix domain socket (under UNIX), or mutex name (under Windows). configdir specifies the configuration directory, i.e. the location of configuration files you want to use with the given instance.

Warning

Do not share same configuration directories or mailboxes across multiple instances as this may lead to an unexpected application behavior!

2.37.

What to do when printing an email prints off the paper?

You can use enscript for this. Use enscript %s to print everything on one page, or enscript -U2 %s for printing two logical pages on one physical page.

Chapter 3. Sylpheed FAQ - Interface

3.1. How do I make Sylpheed display my language?
3.2. I don't like the default font. Can I change that?
3.3. There are too many columns in the message list!
3.4. How do I disable or enable the alternating row colors in the message list?
3.5. Can I use a different editor to write my mails?
3.6. How to change the font size in the Sylpheed interface?
3.7. Sylpheed saves my outgoing mail (in Outbox). Can I make it stop doing that?
3.8. How can I change the key bindings (hotkeys) in Sylpheed?
3.9. Can I close windows without the mouse?
3.10. Can I change the way the date is displayed in the message summary?
3.11. Why can't I see the compface pictures?
3.12. I still can't see the pictures. Why not?
3.13. Why does the URL launcher not launch my web browser?
3.14. Attachments with spaces in the name won't open!
3.15. Execute command for my dynamic signature seems not to be working!
3.16. Where is the Bcc when I compose a mail?
3.17. How do I change the toolbar?
3.18. Why isn't the next message displayed when I delete a message?
3.19. How can I remove mailing list information from Subject headers?
3.1.

How do I make Sylpheed display my language?

You have to set some environment variables, such as LANG, LC_CTYPE, LC_MESSAGES to your local language. Usually LANG (or LC_ALL) is sufficient. Note that modern distributions and operating systems do this for you automatically.

Under UNIX, if you need to set e.g. the LANG environment variable manually, execute the following command (using sh or related shell):

export LANG=value

Replace value with a valid ISO language code (e.g. en_GB for British English).

If you intend to set the displayed language manually under Windows, you can do so by creating the LANG environment variable with a valid ISO language code value under Control Panel->System->Advanced+Environment Variables.

Also see the question regarding environment variables that have effect on Sylpheed.

3.2.

I don't like the default font. Can I change that?

Yes. In Configuration->Common preferences..., under the Display tab.

3.3.

There are too many columns in the message list!

In Configuration->Common preferences... under the Display tab, you can press the button Set display item of summary.... That pops up a screen with all the options you can show or leave out of the message list.

3.4.

How do I disable or enable the alternating row colors in the message list?

Under UNIX, you can directly edit the appropriate hidden setting stored in the $HOME/.sylpheed-2.0/sylpheedrc configuration file by changing the setting value to 0, or 1, respectively (default is on, i.e. 1):

enable_rules_hint=0

Tip

There are various other hidden settings that can be adjusted in your sylpheedrc configuration file, see the README file for details.

The above does not work under Windows, however, so you have to edit the C:\Program Files\Sylpheed\share\themes\MS-Windows\gtk-2.0\gtkrc file and set the following setting to 1, or 0, respectively (default is off under Windows, i.e. 0):

GtkTreeView::allow-rules = 1

Note

Since the hidden setting described above is not stored within your user profile under Windows, it may be overwritten when installing a new version of Sylpheed. To avoid this at least partially, keep a backup copy of the gtkrc file somewhere safe.

3.5.

Can I use a different editor to write my mails?

You can. In Configuration->Common preferences, under the Details and External commands tabs, you can define your editor of choice. Remember, if you want to use a command line editor like vi or emacs, to write the name of the shell (term, term, rxvt) with the -e parameter in front of the editor. E.g.: rxvt -e vi %s.

Also, make sure that you have checked Automatically launch the external editor in Common preferences->Compose->Editor, if you want the editor of your choice to be launched every time you begin composing a message.

3.6.

How to change the font size in the Sylpheed interface?

You can set the GTK+ font by $HOME/.gtkrc-2.0, or $HOME/.gtkrc-2.0.mine, (which is included by $HOME/.gtkrc-2.0). For example:

style "default" {
       font = "-adobe-helvetica-medium-r-normal--12-*-*-*-*-*-iso8859-1 "
}
widget_class "*" style "default"
3.7.

Sylpheed saves my outgoing mail (in Outbox). Can I make it stop doing that?

In Configuration->Common preferences..., there is a checkbox Save sent message to outbox. Uncheck it, and it's solved.

3.8.

How can I change the key bindings (hotkeys) in Sylpheed?

Unlike Sylpheed 1.x, Sylpheed 2.x and 3.x doesn't allow direct modification of the menu shortcuts by default. Nevertheless, you can use the following methods to configure them:

  1. Using GNOME 2.8 or later: run gconf-editor from Applications->System Tools->Configuration Editor. Select desktop->gnome->interface and check can-change-accels there.

  2. Using GNOME before 2.8, or other environments: add the following line to the file ~/.gtkrc-2.0 (or create a new one, if it doesn't exist):

    gtk-can-change-accels = 1
  3. When Sylpheed is not running, directly edit ~/.sylpheed-2.0/menurc with a text editor.

After that, the key binding change itself is very simple. Suppose you want to assign a shortcut key to a function, e.g. sending all mail out should start when you press Ctrl-Y. Click the Message menu and move the mouse over Send all messages. Now you press Ctrl-Y. Immediately the menu text is updated and the function is in place. Please note that a previous function that Ctrl-Y was assigned to, will no longer have a shortcut key. If you want to remove the key binding, do the same thing, but press the Delete key on the menu item. Then the key binding is removed.

Also see Configuration->Common preferences...->Details->Interface+Set key bindings... where you are able to reset the Default key bindings, or use other predefined key bindings.

3.9.

Can I close windows without the mouse?

Of course! Not all windows, but by pressing Escape, you can close the address book, the window of viewing a mail source (View->Message source), the window of viewing the headers, and several others. Just give it a try and you will find all of them.

3.10.

Can I change the way the date is displayed in the message summary?

As of 0.4.65 you can. The options are:

     %y = year in numbers     %m = month in number
     %d = day in numbers      %c = date/time for locale
     %A = full weekday name   %a = short month name
     %B = full month name     %b = short month name
     %H = hours in 24-clock   %I = hours in 12-clock

For more information, go to the Configuration->Common preferences->Display->General and choose the ... labeled button. For more options, see man 3 strftime.

3.11.

Why can't I see the compface pictures?

You need to enable displaying of the header pane in the general preferences.

3.12.

I still can't see the pictures. Why not?

You may not have compiled in Compface support. See the appropriate question in the Installation and Configuration section.

3.13.

Why does the URL launcher not launch my web browser?

You need to double click the URL. Also, check that you have configured your web browser correctly in Configuration->Common preferences...-> Details->External commands.

3.14.

Attachments with spaces in the name won't open!

When you try to launch a helper application, like an image viewer, with an attachment that has spaces in the name, put quotes around the %s parameter. Example: gedit '%s'

3.15.

Execute command for my dynamic signature seems not to be working!

Under Windows, if you have created e.g. a simple batch file to echo a line to be included in your dynamic signature, you need to execute the command (specified under Account preferences->Compose->Signature+Command output) using either forward slashes or double backslashes for paths, for example:

cmd /c 'c:\\signature.bat'

Note that it is also recommended to enclose paths with single quotes, as is illustrated above.

3.16.

Where is the Bcc when I compose a mail?

Open Configuration->Preferences for current account...->Compose. There you can check the Bcc checkbox and optionally enter an email address.

3.17.

How do I change the toolbar?

Go to View->Customize toolbar... and select items from the Available items list to be displayed on the toolbar. You can modify the order by using the Up or Down button. The customization dialog also offers you to revert your modifications to default.

3.18.

Why isn't the next message displayed when I delete a message?

Go to Configuration->Common preferences...->Details->Interface, and select Always open messages in summary when selected.

3.19.

How can I remove mailing list information from Subject headers?

Very often, when you are subscribed to a mailing list, you will store each message from that list in a folder dedicated to that list. Depending on remote software solution and configuration, mailing lists tend to include some words in the Subject header to identify the messages, optionally accompanied with a message number, for instance [sylpheed:33101]. These additions do not provide useful info if you have organized your folders as described, but Sylpheed allows you to disable displaying the additions in summary, and/or, if you wish, delete the additions on reply.

To do that, right-click on a folder from the folder tree, and select Properties... In the Folder properties dialog, check Don't display [...] or (...) at the beginning of subject in summary, or Delete [...] or (...) at the beginning of subject on reply, respectively.

GNU Free Documentation License

Version 1.2, November 2002

Free Software Foundation, Inc. 51 Franklin St, Fifth FloorBostonMA02110-1301USA

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Version 1.2, November 2002

A.1. PREAMBLE

The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.

This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.

We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.

A.2. APPLICABILITY AND DEFINITIONS

This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.

A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.

A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.

The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.

The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.

A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not "Transparent" is called "Opaque".

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.

The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.

A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition.

The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.

A.3. VERBATIM COPYING

You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and you may publicly display copies.

A.4. COPYING IN QUANTITY

If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.

If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.

It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.

A.5. MODIFICATIONS

You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:

GNU FDL Modification Conditions

  1. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
  2. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
  3. State on the Title page the name of the publisher of the Modified Version, as the publisher.
  4. Preserve all the copyright notices of the Document.
  5. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
  6. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
  7. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.
  8. Include an unaltered copy of this License.
  9. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
  10. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
  11. For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
  12. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
  13. Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version.
  14. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section.
  15. Preserve any Warranty Disclaimers.

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.

You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.

A.6. COMBINING DOCUMENTS

You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.

The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.

In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled "Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements".

A.7. COLLECTIONS OF DOCUMENTS

You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.

A.8. AGGREGATION WITH INDEPENDENT WORKS

A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.

A.9. TRANSLATION

Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.

If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.

A.10. TERMINATION

You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.

A.11. FUTURE REVISIONS OF THIS LICENSE

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/.

Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.

A.12. ADDENDUM: How to use this License for your documents

To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:

Sample Invariant Sections list

Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with...Texts." line with this:

Sample Invariant Sections list

with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.

If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation.

If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.