diff options
Diffstat (limited to 'faq/en/faq_002.xml')
| -rw-r--r-- | faq/en/faq_002.xml | 271 |
1 files changed, 115 insertions, 156 deletions
diff --git a/faq/en/faq_002.xml b/faq/en/faq_002.xml index 6a3be09..4a0da77 100644 --- a/faq/en/faq_002.xml +++ b/faq/en/faq_002.xml @@ -5,66 +5,74 @@ <title>Installation and Configuration</title> <qandaentry> <question> - <para> -Q01 What does it take to compile Sylpheed? + <para>What does it take to compile Sylpheed? </para> </question> <answer> - <para>Any POSIX compliant UNIX or similar OS eg. Linux, -FreeBSD, Solaris -GTK+ 1.2.6 or later + <para>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) +work). Note: it is reported that Sun C will not compile Sylpheed. Optionally:</para> <itemizedlist> <listitem> - <para>Imlib or gdk-pixbuf (for built-in image view)</para> + <para>compface (for X-Face)</para> </listitem> <listitem> - <para>libcompface (for X-Face)</para> + <para>GPGME (for GnuPG)</para> </listitem> <listitem> - <para>libjconv (for I18N)</para> + <para>OpenSSL for SSL support</para> </listitem> <listitem> - <para>GPGME (for GnuPG)</para> + <para>GtkSpell for a spell checking feature</para> + </listitem> + <listitem> + <para>JPilot</para> + </listitem> + <listitem> + <para>LDAP</para> </listitem> <listitem> - <para>the equivalent of GTK+-devel and Xfree86-devel.</para> + <para>the equivalent of GTK+-devel and Xfree86-devel</para> + </listitem> + <listitem> + <para>you may also require flex (lex) and bison +(yacc).</para> </listitem> </itemizedlist> <para>Otherwise ./configure will fail. -</para> +See also the <filename>INSTALL</filename> file that is being distributed with the Sylpheed tarball.</para> + <para>Note that as Sylpheed now supports the Windows platform, you can also compile it using <ulink url="http://www.mingw.org/">MinGW</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q02 How do I set up Sylpheed? + <para>How do I set up Sylpheed? </para> </question> <answer> <para>When you run Sylpheed for the first time, it will ask you where you want to store your mailboxes. The -default is <homedir>/Mail. You can change this to +default is <filename>$HOME/Mail</filename>. You can change this to anything you like as long as it is a valid directory name.</para> - <para> -Please note: When Sylpheed is executed for the first time, it automatically creates the configuration files under $HOME/.sylpheed/, and asks you the location of mailbox. The default is $HOME/Mail. If some files which are non-MH format already exist on the directory, you will have to specify another location. + <para>Please note: When Sylpheed is executed for the first time, it automatically creates the configuration files under <filename>$HOME/.sylpheed-2.0/</filename>, and asks you the location of mailbox. The default is <filename>$HOME/Mail</filename>. If some files which are non-MH format already exist on the directory, you will have to specify another location. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q03 Why did the creation of the mailbox fail? + <para>Why did the creation of the mailbox fail? </para> </question> <answer> <para>Sylpheed reports such an error if it can't create the default -mailboxes (inbox, outbox, etc ...). This can be because <homedir>/Mail +mailboxes (inbox, outbox, etc ...). This can be because <filename><homedir>/Mail</filename> 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. @@ -73,22 +81,19 @@ directory or use another name for the Sylpheed mail directory. </qandaentry> <qandaentry> <question> - <para> -Q04 How do I set up an account? + <para>How do I set up an account? </para> </question> <answer> <para>After loading Sylpheed for the first time, you can add an e-mail account by clicking the -"Configuration" menu. Select the option "Create new -account" and fill in the appropriate fields. +"<guimenu>Configuration</guimenu>" menu. Select the option "<guimenuitem>Create new account</guimenuitem>" and fill in the appropriate fields. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q05 How many accounts can I set up in Sylpheed? + <para>How many accounts can I set up in Sylpheed? </para> </question> <answer> @@ -99,22 +104,20 @@ your computer stops responding. </qandaentry> <qandaentry> <question> - <para> -Q06 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. + <para>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. </para> </question> <answer> - <para>You have to click the "execute" button. + <para>You have to click the "<guiicon>Execute</guiicon>" button. The other solution: in the configuration settings -(common preferences -> interface tab) you have to -check the "execute commands immediately" box. +(<guimenuitem>Common preferences</guimenuitem> -> <guimenuitem>Details</guimenuitem> tab -> <guimenuitem>Interface</guimenuitem> tab) you have to +check the "<guilabel>Execute immediately when moving or deleting messages</guilabel>" box. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q07 Can I set up special addresses/ports for my mailserver / newsserver? + <para>Can I set up special addresses/ports for my mailserver/newsserver? </para> </question> <answer> @@ -125,20 +128,18 @@ can specify the exact port addresses you want to use. </qandaentry> <qandaentry> <question> - <para> -Q08 Does Sylpheed have options for threading messages? + <para>Does Sylpheed have options for threading messages? </para> </question> <answer> - <para>Yes. You can switch it on and off in the Summary - Menu, just select "Thread View" or press Ctrl+T. + <para>Yes. You can switch it on and off in the <guimenu>View</guimenu> + menu, just select "<guimenuitem>Thread view</guimenuitem>" or press <keycap>Ctrl+T</keycap>. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q09 Can I create multiple levels of subfolders to store mail? + <para>Can I create multiple levels of subfolders to store mail? </para> </question> <answer> @@ -148,8 +149,7 @@ Q09 Can I create multiple levels of subfolders to store mail? </qandaentry> <qandaentry> <question> - <para> -Q10 Why isn't Sylpheed sending my mail out? + <para>Why isn't Sylpheed sending my mail out? </para> </question> <answer> @@ -161,46 +161,43 @@ Q10 Why isn't Sylpheed sending my mail out? </qandaentry> <qandaentry> <question> - <para> -Q11 How do I apply a patch after downloading it? + <para>How do I apply a patch after downloading it? </para> </question> <answer> - <para>Copy patch to sylpheed directory - Apply the patch:</para> + <para>Copy patch to sylpheed directory. + Apply the patch as follows:</para> <para> - <computeroutput>% patch -p0 < some.patch</computeroutput></para> + <command>% patch -p0 < some.patch</command></para> <para> Or, if it's gzipped:</para> <para> - <computeroutput>% gzip -dc some.patch.gz | patch -p0</computeroutput></para> + <command>% gzip -dc some.patch.gz | patch -p0</command></para> <para> - Run <computeroutput>./autogen.sh</computeroutput>, remove the generated <computeroutput>/config.cache</computeroutput> + Run <filename>./autogen.sh</filename>, remove the generated <filename>/config.cache</filename> file (unless you want to install in prefix - <computeroutput>/usr/local</computeroutput>). - Run <computeroutput>./configure</computeroutput> with the appropriate options and - then <computeroutput>make</computeroutput>. - (Text as found on the Sylpheed patches page.) + <filename>/usr/local</filename>). + Run <filename>./configure</filename> with the appropriate options and + then <filename>make</filename>. + (Text as found on the former Sylpheed patches page.) </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q12 How do I compile in support for compface pictures? + <para>How do I compile in support for compface pictures? </para> </question> <answer> <para>You have to have a package called <computeroutput>libcompface</computeroutput> installed, so this is available for compiling into - Sylpheed. + Sylpheed. Note that the exact name of the package depends on OS or distribution you use. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q13 How do I make my own compface image? + <para>How do I make my own compface image? </para> </question> <answer> @@ -212,8 +209,7 @@ Q13 How do I make my own compface image? </qandaentry> <qandaentry> <question> - <para> -Q14 How can I tell my browser/newsclient/other program to use Sylpheed as e-mail program? + <para>How can I tell my browser/newsclient/other program to use Sylpheed as e-mail program? </para> </question> <answer> @@ -233,28 +229,28 @@ Specific options for typical browsers:</para> </qandaentry> <qandaentry> <question> - <para>Q15 How do I enable GPG support in Sylpheed? + <para>How do I enable GPG support in Sylpheed? </para> </question> <answer> <para> When compiling Sylpheed, make sure you add <computeroutput>--enable-gpgme</computeroutput> in the ./configure command. -When that completes successfully, there is a "privacy" section in the Common preferences. +When that completes successfully, there is a <guimenuitem>Privacy</guimenuitem> section in the <guimenuitem>Common Preferences</guimenuitem>. </para> </answer> </qandaentry> <qandaentry> <question> - <para>Q16 Mutt does not recognize Sylpheed's MH structure + <para>Mutt does not recognize Sylpheed's MH structure </para> </question> <answer> - <para>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. + <para>For this to work you need to use the <command>touch</command> command in every MH folder. "<command>touch</command>" the file <filename>.xmhcache</filename> and Mutt should do just fine. </para> </answer> </qandaentry> <qandaentry> <question> - <para>Q17 Viewing a GIF file within Sylpheed causes a segmentation fault. + <para>Viewing a GIF file within Sylpheed causes a segmentation fault. </para> </question> <answer> @@ -266,68 +262,59 @@ When that completes successfully, there is a "privacy" section in the </qandaentry> <qandaentry> <question> - <para>Q18 How can I make Sylpheed notify me when new mail arrives? + <para>How can I make Sylpheed notify me when new mail arrives? </para> </question> <answer> - <para>For this you can do several things:</para> - <para> -* Look at the Sylpheed patch page at <ulink url="http://www.thewildbeast.co.uk/sylpheed/">http://www.thewildbeast.co.uk/sylpheed/</ulink> for a new mail patch.</para> - <para> -* Download Gkrellm or a similar program that is able to notify you of new incoming mail. Gkrellm is available at <ulink url="http://www.gkrellm.net">the Gkrellm page</ulink> -</para> + <para>Download Gkrellm or a similar program that is able to notify you of new incoming mail. Gkrellm is available at <ulink url="http://www.gkrellm.net">the Gkrellm page</ulink>.</para> </answer> </qandaentry> <qandaentry> <question> - <para>Q19 Can I use a spell checker with Sylpheed? + <para>Can I use a spell checker with Sylpheed? </para> </question> <answer> - <para>Yes. You can use ispell for this. In Common Preferences, in the spot where you can define an alternative editor (as long as you do not use that, of course), you enter "xterm -e ispell %s". Do not enter the quotes. -With this set up, you can have spell checked when writing an e-mail by hitting the "Editor" button in the compose window.</para> - <para> -Note that you can enter the xterm type of your choice, so wterm, eterm and aterm should also work, as long as they are installed on your system.</para> + <para>Yes. You need to have GtkSpell installed prior to Sylpheed compilation. The support for GtkSpell is enabled by default in <computeroutput>configure</computeroutput>. (If you want to disable it, make sure you add <computeroutput>--disable-gtkspell</computeroutput> in the <command>./configure</command> command.)</para> + <para>The GtkSpell option is not supported in Sylpheed for Windows (yet), so you will have no spell checking under this OS.</para> </answer> </qandaentry> <qandaentry> <question> - <para>Q20 How can I make Sylpheed send my compface image in the mails? + <para>How can I make Sylpheed send my compface image in the mails? </para> </question> <answer> - <para>In the Configuration menu, Preferences for current account, Send tab, 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.</para> + <para>In the <guimenu>Configuration</guimenu> menu, <guimenuitem>Preferences for current account...</guimenuitem>, <guimenuitem>Send</guimenuitem> tab, check <guilabel>Add user-defined header</guilabel> and press <guibutton>Edit</guibutton> 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.</para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q21 I checked out the sources using cvs and cant find any configure script. + <para>I checked out the sources using SVN and can't find any configure script. </para> </question> <answer> - <para>The cvs versions are meant to be used by developers rather than "normal" + <para>The SVN versions are meant to be used by developers rather than "normal" users, so the source (or binary) distributions are easier to use.</para> <para> - - Yeah, but the latest features from cvs really look sexy...</para> + - Yeah, but the latest features from SVN really look sexy...</para> <para> - You need to generate the configure script by running "autgen.sh". + You need to generate the configure script by running <filename>autogen.sh</filename>. Be sure to have autoconf and automake packages installed for this. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q22 Running "autogen.sh" gives errormessages that "AM_PATH_GDK_PIXBUF" or + <para>Running "autogen.sh" gives error messages that "AM_PATH_GDK_PIXBUF" or "AM_PATH_(whatever)" is not found. </para> </question> <answer> - <para>There are some *.m4 files in the "ac/missing" directory. Try to copy - them into the "ac" directory and run "autogen.sh" again.</para> + <para>There are some *.m4 files in the <filename>ac/missing</filename> directory. Try to copy + them into the <filename>ac</filename> directory and run <filename>autogen.sh</filename> again.</para> <para> - If there are still some .m4 files not found (e.g. those from Gtk), try + If there are still some <filename>.m4</filename> files not found (e.g. those from GTK+), try to run </para> <literallayout> % locate m4 | less @@ -338,8 +325,8 @@ Q22 Running "autogen.sh" gives errormessages that "AM_PATH_GDK_P % locate aclocal | less </literallayout> <para>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</para> + <filename>gtk.m4</filename> in <filename>/opt/gnome/share/aclocal</filename>, change following line in + <filename>autogen.sh</filename> from</para> <literallayout> aclocal -I ac \ </literallayout> @@ -353,69 +340,63 @@ Q22 Running "autogen.sh" gives errormessages that "AM_PATH_GDK_P </qandaentry> <qandaentry> <question> - <para> -Q23 I dont want to compile in support for ... any longer, but after running + <para>I don't want to compile in support for ... any longer, but after running "configure", those libraries are still used. </para> </question> <answer> - <para>Remove the "config.cache" file and run "configure" again. You should + <para>Remove the <filename>config.cache</filename> file and run <command>./configure</command> again. You should also use "make clean" to avoid undefined references. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q24 How can I select different applications to open with specific MIME types? + <para>How can I select different applications to open with specific MIME types? </para> </question> <answer> - <para>The MIME-type->application associations are kept in /etc/mailcap. + <para>The MIME-type->application associations are kept in <filename>/etc/mailcap</filename>. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q25 How can I change the suggested mimetype for attachments? + <para>How can I change the suggested mimetype for attachments? </para> </question> <answer> - <para>The extension->MIME-type associations are kept in /etc/mime.types + <para>The extension->MIME-type associations are kept in <filename>/etc/mime.types</filename> </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q26 The folderlist is not updated after I manually moved/copied folders. + <para>The folderlist is not updated after I manually moved/copied folders. </para> </question> <answer> <para>You need to update Sylpheeds cache. Right click on the mailbox and choose - "rescan folder tree". + "<guimenuitem>Rebuild folder tree</guimenuitem>". </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q27 How can I revert original settings, e.g. for fonts, keybindings, etc.? + <para>How can I revert original settings, e.g. for fonts, keybindings, etc.? </para> </question> <answer> - <para>Sylpheed keeps its configuration files in $HOME/.sylpheed/sylpheedrc and creates default - entries, if none are found. So the easiest way is to quit sylpheed, - temporarily renaming your $HOME/.sylpheed e.g. to *.bak and restarting - sylpheed in order to get default entries. + <para>Sylpheed keeps its configuration files in <filename>$HOME/.sylpheed-2.0/sylpheedrc</filename> and creates default + entries, if none are found. So the easiest way is to quit Sylpheed, + temporarily renaming your <filename>$HOME/.sylpheed-2.0</filename> e.g. to <filename>*.bak</filename> and restarting + Sylpheed in order to get default entries. </para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q28 What environment variables have effect on Sylpheed? + <para>What environment variables have effect on Sylpheed? </para> </question> <answer> @@ -423,7 +404,7 @@ Q28 What environment variables have effect on Sylpheed? <itemizedlist> <listitem> <para>HOME - - location of .sylpheed (config directory) and default folder for Mailboxes.</para> + - location of <filename>.sylpheed-2.0</filename> (config directory) and default folder for Mailboxes.</para> <para>LANG,</para> </listitem> <listitem> @@ -433,48 +414,34 @@ Q28 What environment variables have effect on Sylpheed? <para>LC_CTYPE,</para> </listitem> <listitem> - <para>LC_MESSAGES</para> - <para>- locale settings, e.g. language and date format.</para> + <para>LC_MESSAGES - locale settings, e.g. language and date format.</para> </listitem> </itemizedlist> </answer> </qandaentry> <qandaentry> <question> - <para> -Q29 Special characters (e.g. umlauts) are not displayed correctly. + <para>Special characters (e.g. umlauts) are not displayed correctly. </para> </question> <answer> - <para>In most cases, this is caused by fonts, that use an unsuitable encoding.</para> - <para> - Standard Sylpheed currently doesnt offer all font settings in the settings - window, so if you take a look into your $HOME/.sylpheedrc, you will find some - more font entries in the following form:</para> - <literallayout> - bold_font=-unknown-Helvetica-bold-r-normal-*-*-110-*-*-p-*-iso8859-1 -</literallayout> - <para>The last two entries ("iso8859" and "1") define the encodig. You can try to - use wildcards ("*") or force a specific encoding.</para> - <literallayout> - bold_font=-unknown-Helvetica-bold-r-normal-*-*-110-*-*-p-*-*-* -</literallayout> + <para>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.)</para> + <para>Choose <guimenu>Configuration</guimenu> -> <guimenuitem>Common preferences</guimenuitem> -> <guimenuitem>Display</guimenuitem> tab -> <guimenuitem>General</guimenuitem> tab, and click the button right to <guilabel>Text font</guilabel>. Now, a special dialog appears that allows you to pick a desirable font family, style, and size.</para> <para>You should also make sure that your environment variables regarding locale settings have sensible values.</para> </answer> </qandaentry> <qandaentry> <question> - <para> -Q30 How can I convert my old mailbox / adressbook from (some mailclient). + <para>How can I convert my old mailbox/adressbook from (some mailclient). </para> </question> <answer> - <para>In the source distribution, you can find some scripts in the "tools" + <para>In the source distribution, you can find some scripts in the "<filename>tools</filename>" subdirectory, maybe your application is supported. You can also try to - export your old mailbox to MH or MBOX format.</para> + export your old mailbox to MH, MBOX or EML format.</para> <para> - Tip: Take a look at the "harvest addresses" function from the "tools" + Tip: Take a look at the <guimenuitem>Add sender to address book...</guimenuitem> item from the <guimenu>Tools</guimenu> menu, it could be a useful alternative or addition, when importing your old contacts. </para> @@ -482,62 +449,54 @@ Q30 How can I convert my old mailbox / adressbook from (some mailclient). </qandaentry> <qandaentry> <question> - <para> -Q31 What config files are there, and what are they used for? + <para>What config files are there, and what are they used for? </para> </question> <answer> - <para>Sylpheeds config files can be found in $HOME/.sylpheed. They are in plain - text format and quite easy to understand, so dont fear to take a look + <para>Sylpheeds config files can be found in <filename>$HOME/.sylpheed-2.0</filename>. They are in plain + text format and quite easy to understand, so don't fear to take a look into them using a texteditor.</para> <itemizedlist> <listitem> - <para>sylpheedrc - main configuration: nearly all options from the + <para><filename>sylpheedrc</filename> - main configuration: nearly all options from the settings window, e.g. mailbox location, font entries, etc.</para> </listitem> <listitem> - <para>accountrc - settings for pop/imap/nntp accounts</para> - </listitem> - <listitem> - <para>actionsrc - user defined actions</para> - </listitem> - <listitem> - <para>customheaderrc - contains user defined header lines</para> + <para><filename>accountrc</filename> - settings for POP/IMAP/NNTP accounts</para> </listitem> <listitem> - <para>dispheaderrc - headers to display above the mail body</para> + <para><filename>actionsrc</filename> - user-defined actions</para> </listitem> <listitem> - <para>filterrc - traditional filter settings</para> + <para><filename>addrbook-*.xml</filename> - contents of your addressbook</para> </listitem> <listitem> - <para>folderitemrc - folder specific settings, e.g. default outbox</para> + <para><filename>customheaderrc</filename> - contains user-defined header lines</para> </listitem> <listitem> - <para>matcherrc - new filtering and scoring settings</para> + <para><filename>dispheaderrc</filename> - headers to display above the mail body</para> </listitem> <listitem> - <para>menurc - Key bindings</para> + <para><filename>filter.xml</filename> - filter settings</para> </listitem> <listitem> - <para>addrbook-*.xml - contents of your addressbook</para> + <para><filename>folderlist.xml</filename> - folder specific settings, e.g. hiding + read messages, sort order, etc.</para> </listitem> <listitem> - <para>folderlist.xml - additional folder specific settings, e.g. hiding - read messages, sort order, etc.</para> + <para><filename>menurc</filename> - Key bindings</para> </listitem> </itemizedlist> </answer> </qandaentry> <qandaentry> <question> - <para> -Q32 What to do when printing an e-mail prints off the paper? + <para>What to do when printing an e-mail prints off the paper? </para> </question> <answer> - <para>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. + <para>You can use enscript for this. Use <command>enscript %s</command> to print everything on one page, or <command>enscript -U2 %s</command> for printing two logical pages on one physical page. </para> </answer> </qandaentry> |