aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/C/apx-authors.sgml6
-rw-r--r--doc/C/evolution-faq.sgml1122
-rw-r--r--doc/C/evolution.sgml7
-rw-r--r--help/C/apx-authors.sgml6
-rw-r--r--help/C/evolution-faq.sgml1122
-rw-r--r--help/C/evolution.sgml7
6 files changed, 1196 insertions, 1074 deletions
diff --git a/doc/C/apx-authors.sgml b/doc/C/apx-authors.sgml
index 8ba08924b1..694e1158df 100644
--- a/doc/C/apx-authors.sgml
+++ b/doc/C/apx-authors.sgml
@@ -53,8 +53,10 @@ and other dedicated GNOME programmers.
</para>
<para>
This manual was written by Aaron Weber
- (<email>aaron@ximian.com</email>) and Kevin Breit
- (<email>battery841@mypad.com</email>) with the help of the
+ (<email>aaron@ximian.com</email>), Kevin Breit
+ (<email>battery841@mypad.com</email>) Duncan Mak
+ (<email>duncan@ximian.com</email>) and Ettore Perazzoli
+ (<email>ettore@ximian.com</email>) with the help of the
application programmers and the GNOME Documentation Project.
Please send all comments and suggestions regarding the manual to
the GNOME Documentation Project at
diff --git a/doc/C/evolution-faq.sgml b/doc/C/evolution-faq.sgml
index 4fdb3940c5..62621ba798 100644
--- a/doc/C/evolution-faq.sgml
+++ b/doc/C/evolution-faq.sgml
@@ -1,123 +1,114 @@
-<!doctype article PUBLIC "-//Davenport//DTD DocBook V3.0//EN" []>
-
- <article id="index">
- <artheader>
- <authorgroup>
- <author>
- <firstname>Ettore</firstname>
- <surname>Perazzoli</surname>
- </author>
- <author>
- <firstname>Duncan</firstname>
- <surname>Mak</surname>
- </author>
- </authorgroup>
-
- <title>Evolution Frequently Asked questions</title>
- <abstract>
- <para>
- This is a FAQ list and yadda yadda.
- </para>
- </abstract>
- </artheader>
-
-
+<!--
+<!DOCTYPE appendix PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
+-->
+ <appendix id="evolution-faq">
+ <title>Frequently Asked Questions About Ximian Evolution</title>
+ <para>
+ Here are some frequently asked questions about the
+ <application>Evolution</application> groupware suite from
+ Ximian.
+ </para>
+
<!-- Section: Getting and compiling -->
- <sect1>
+ <sect1 id="get-and-compile">
<title>
- Getting and compiling
+ Getting and Compiling Evolution
</title>
-
- <!-- -->
- <sect2>
- <title>
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
Where can I get the latest Evolution release?
- </title>
-
- <para>
- There are two main ways to install the latest Evolution
+ </para>
+ </question>
+ <answer>
+ <para>
+ There are two ways to install the latest Evolution
release:
- </para>
-
<itemizedlist>
- <listitem>
- <para>
- If you have Ximian GNOME installed, you can start Red
- Carpet, Ximian's software updating system, and subscribe
- to the Evolution channel. This will let you install a
- binary for the latest release, and will also warn you
- when a new version has been made available.
- </para>
- </listitem>
-
- <listitem>
- <para>
- If you want to compile from source, you can download the
- latest official Evolution tarball from:
- </para>
-
- <para>
- <ulink url="ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution">
- ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution
- </ulink>
- </para>
- </listitem>
- </itemizedlist>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- Are binary snapshots available?
- </title>
-
+ <listitem>
+ <para>
+ If you have Ximian GNOME installed, you can start
+ Red Carpet, Ximian's software updating system, and
+ subscribe to the Evolution channel. This will let
+ you install a binary for the latest release, and
+ will also warn you when a new version has been made
+ available.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ If you want to compile from source, you can
+ download the latest official Evolution tarball
+ from:
+ </para>
+
+ <para>
+ <ulink url="ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution">
+ ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ Are binary snapshots available?
+ </para>
+ </question>
+ <answer>
<para>
Yes, if you have Ximian GNOME installed. Just run Red
Carpet and subscribe to the Evolution Snapshot channel.
</para>
<para>
- The snapshot builds are logged at <ulink
+ You can check the status of snapshots at <ulink
url="http://primates.ximian.com/~snapshot">http://primates.ximian.com/~snapshot</ulink>.
</para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- Why isn't a new snapshot available today?
- </title>
-
- <para>
- Sometimes the build might fail because of problems with the
- source on CVS. In this case, just wait for next day's
- snapshot.
- </para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- How do I get Evolution from CVS?
- </title>
-
- <para>
- If you already have <ulink url="http://cvs.gnome.org">GNOME
- CVS</ulink> access, simply checkout the following modules:
- evolution, gtkhtml, gal.
- </para>
-
- <para>
- If you don't have a CVS account, you could use anoncvs
- instead. Bear in mind that anoncvs is only synchronized once a
- day, and code received from anoncvs may not be latest version
- available.
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ Why isn't a new snapshot available today?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Sometimes the build might fail because of problems with
+ the source on CVS. In this case, just wait for next day's
+ snapshot.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ How do I get Evolution from CVS?
+ </para>
+ </question>
+ <answer>
+ <para>
+ If you already have <ulink
+ url="http://cvs.gnome.org">GNOME CVS</ulink> access,
+ simply check out the following modules: evolution,
+ gtkhtml, gal.
+ </para>
+ <para>
+ If you don't have a CVS account, you can use anoncvs
+ instead. Bear in mind that anoncvs is only synchronized once
+ a day, and code received from anoncvs may not be latest
+ version available.
</para>
<para>
Before using the anoncvs server, you have to log into it.
- This only needs to be done once.
+ This only needs to be done once. Use this command:
</para>
<programlisting>
@@ -132,21 +123,22 @@ cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
<programlisting>
cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co evolution gtkhtml gal
</programlisting>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- How should I compile Evolution avoiding conflicts with my
- existing GNOME installation?
- </title>
-
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ How should I compile Evolution avoiding conflicts with my
+ existing GNOME installation?
+ </para>
+ </question>
+ <answer>
<para>
The best way is to install Evolution into a separate prefix.
- In order to specify a non-default installation prefix, you can
- pass the <parameter>--prefix</parameter> option to
- <filename>configure</filename> or <filename>autogen.sh</filename>. For
- example:
+ In order to specify a non-default installation prefix, you
+ can pass the <parameter>--prefix</parameter> option to
+ <filename>configure</filename> or
+ <filename>autogen.sh</filename>. For example:
</para>
<programlisting>
@@ -157,7 +149,7 @@ cd /cvs/evolution
<para>
If you install Evolution and the Evolution libraries in a
non-standard prefix, make sure you set the appropriate
- environment variables in your shell's startup script:
+ environment variables in the startup script for Evolution:
</para>
<programlisting>
@@ -168,102 +160,109 @@ export GNOME_PATH=/opt/gnome:/usr
<para>
You may also need to add <filename>$prefix/lib</filename>
(e.g. <filename>/opt/gnome/lib</filename>) to your
- <filename>/etc/ld.so.conf</filename>. <!-- FIXME portable? -->
- </para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- I get <computeroutput>make: *** No rule to make target
- `all-no-@BUILD_INCLUDED_LIBINTL@'</computeroutput>
- </title>
-
- <para>
- You probably have <filename>gettext</filename> 0.10.36 or
- later installed. Try downgrading to 0.10.35; unfortunately,
- 0.10.36 introduced some incompatibilities with the current
- <filename>xml-i18n-tools</filename>.
- </para>
- </sect2>
-
- </sect1> <!-- End Section: Getting and compiling -->
-
- <!-- Section: Troubleshooting -->
-
- <sect1>
+ <filename>/etc/ld.so.conf</filename>. Of course, this will
+ not work for systems which do not use ld.so.conf, such as
+ HP-UX.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ I get <computeroutput>make: *** No rule to make target
+ `all-no-@BUILD_INCLUDED_LIBINTL@'</computeroutput>
+ </para>
+ </question>
+ <answer>
+ <para>
+ You probably have <filename>gettext</filename> 0.10.36 or
+ later installed. Try downgrading to 0.10.35;
+ unfortunately, 0.10.36 introduced some incompatibilities
+ with the current <filename>xml-i18n-tools</filename>.
+ </para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
+
+ <sect1 id="faq-trouble">
<title>Troubleshooting</title>
-
- <!-- -->
- <sect2>
- <title>
- I get <computeroutput>Cannot initialize the Evolution
- shell</computeroutput>.
- </title>
-
- <para>
- Check that:
- </para>
-
- <itemizedlist>
- <listitem>
- <para>
- <filename>oafd</filename> is listen in your <envar>PATH</envar>
- environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <filename>GNOME_Evolution_Shell.oaf</filename> and
- the other      
- <filename>GNOME_Evolution_*.oaf</filename> files are
- readable and installed in
- <filename>$prefix/share/oaf</filename>, where
- <filename>$prefix</filename> is one of the prefixes
- listed in <envar>GNOME_PATH</envar> or
- <envar>OAF_INFO_PATH</envar>.  (These variables are
- supposed to contain $PATH-like colon-separated lists of
- paths.  If the installation prefix for Evolution is
- different from that). Run `oaf-slay' once before running
- `evolution' again if you change $GNOME_PATH or
- $OAF_INFO_PATH.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <filename>evolution</filename>,
- <filename>evolution-mail</filename> and the other
- <filename>evolution-*</filename> executables are in your
- $PATH.
- </para>
- </listitem>
- </itemizedlist>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- I get <computeroutput>Cannot open composer window</computeroutput>.
- </title>
-
- <para>
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
+ I get <computeroutput>Cannot initialize the Evolution
+ shell</computeroutput>.
+ </para>
+ </question>
+ <answer>
+ <para>
+ Check that:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>oafd</filename> is listen in your <envar>PATH</envar>
+ environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <filename>GNOME_Evolution_Shell.oaf</filename> and
+ the other      
+ <filename>GNOME_Evolution_*.oaf</filename> files are
+ readable and installed in
+ <filename>$prefix/share/oaf</filename>, where
+ <filename>$prefix</filename> is one of the prefixes
+ listed in <envar>GNOME_PATH</envar> or
+ <envar>OAF_INFO_PATH</envar>.  (These variables are
+ supposed to contain $PATH-like colon-separated lists of
+ paths.  If the installation prefix for Evolution is
+ different from that). Run `oaf-slay' once before running
+ `evolution' again if you change $GNOME_PATH or
+ $OAF_INFO_PATH.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <filename>evolution</filename>,
+ <filename>evolution-mail</filename> and the other
+ <filename>evolution-*</filename> executables are in your
+ $PATH.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ I get <computeroutput>Cannot open composer window</computeroutput>.
+ </para>
+ </question>
+ <answer>
+ <para>
This actually means that Evolution cannot activate the HTML
editor component from GtkHTML. The comments in the previous
answer still apply; also make sure that
<command>gnome-gtkhtml-editor</command> is in your
<envar>PATH</envar>.
</para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
I updated my Evolution, but my addressbook contacts are no
longer there, what should I do?
- </title>
-
+ </para>
+ </question>
+ <answer>
<para>
Evolution uses the <filename>libdb</filename> library to
handle the addressbook database. Two versions of
@@ -348,60 +347,66 @@ db_dump185 ~/evolution/local/Contacts/addressbook.db.backup | db_load ~/evolutio
</listitem>
</itemizedlist>
- </sect2>
+ </answer>
+ </qandaentry>
- <!-- -->
- <sect2>
- <title>
+ <qandaentry>
+ <question>
+ <para>
Evolution reported an error when trying to retrieve from my
local spool in <filename>/var/spool/mail/username</filename>. Why?
- </title>
-
- <para>
- Evolution doesn't have an external helper for moving mail,
- so <filename>/var/spool/mail/</filename> must be writable by you. Try this:
- </para>
-
- <programlisting>
+ </para>
+ </question>
+ <answer>
+ <para>
+ Evolution doesn't have an external helper for moving mail,
+ so <filename>/var/spool/mail/</filename> must be writable
+ by you. Try this:
+ </para>
+
+ <programlisting>
chmod 1777 /var/spool/mail
</programlisting>
- <para>
- Yes, we know this is a problem. It will be fixed eventually.
- </para>
- </sect2>
+ <para>
+ Yes, we know this is a problem. It will be fixed eventually.
+ </para>
+ </answer>
+ </qandaentry>
- <!-- -->
- <sect2>
- <title>
+ <qandaentry>
+ <question>
+ <para>
Evolution crashes reporting that it couldn't allocate N
billion bytes; how do I fix this?
- </title>
-
- <para>
- This usually happens when a component tries talking a
- certain version of a CORBA interface to another component
- that supports a different version. For example, this can
- happen when you recompile and install a single component
- without recompiling/installing the rest of Evolution.
</para>
-
+ </question>
+ <answer>
+ <para>
+ This usually happens when a component tries talking a
+ certain version of a CORBA interface to another component
+ that supports a different version. For example, this can
+ happen when you recompile and install a single component
+ without recompiling/installing the rest of Evolution.
+ </para>
+
+ <para>
+ So, if this occurs to you, make sure all the components
+ are compiled and installed at the same time. This also
+ applies to GtkHTML upgrades; after upgrading and
+ installing a newer GtkHTML, always re-compile and
+ re-install Evolution against it.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
<para>
- So, if this occurs to you, make sure all the components are
- compiled and installed at the same time. This also applies
- to GtkHTML upgrades; after upgrading and installing a newer
- GtkHTML, always re-compile and re-install Evolution against
- it.
- </para>
-
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
What is <command>killev</command> and why do I need to use it?
- </title>
-
+ </para>
+ </question>
+ <answer>
<para>
Evolution is actually made up of several components that run
as separate processes. Evolution's shell is not very good
@@ -417,19 +422,22 @@ chmod 1777 /var/spool/mail
should try to exit the shell cleanly first, so you give a
chance to the other components to clean things up properly.)
</para>
- </sect2>
-
- <sect2>
- <title>
- What is <command>oaf-slay</command> and why do I need to use it?
- </title>
+ </answer>
+ </qandaentry>
- <para>
- <command>oaf-slay</command> is an utility which comes with
- OAF, the Object Activation Framework that is used in the
- GNOME Desktop to activate components. It will kill the
- object activation daemon (<command>oafd</command>) as well
- as all the active components on the system.
+ <qandaentry>
+ <question>
+ <para>
+ What is <command>oaf-slay</command> and why do I need to use it?
+ </para>
+ </question>
+ <answer>
+ <para>
+ <command>oaf-slay</command> is an utility which comes with
+ OAF, the Object Activation Framework that is used in the
+ GNOME Desktop to activate components. It will kill the
+ object activation daemon (<command>oafd</command>) as well
+ as all the active components on the system.
</para>
<para>
@@ -446,64 +454,71 @@ chmod 1777 /var/spool/mail
<application>Nautilus</application>. To avoid problems, do
not run <command>oaf-slay</command> while you are in GNOME.
</para>
- </sect2>
-
- </sect1> <!-- End Section: Troubleshooting -->
-
-
- <!-- Section: Debugging -->
-
- <sect1>
- <title>
- Debugging
- </title>
-
- <!-- -->
- <sect2>
- <title>
- Where should I report bugs for Evolution?
- </title>
-
- <para>
- You should report bugs about Evolution into the Ximian bug
- reporting system (Bugzilla), located at <ulink
- url="http://bugzilla.ximian.com">http://bugzilla.ximian.com</ulink>.
- </para>
-
- <para>
- Please use the query function to check if a bug has been
- submitted already before submitting it.
- </para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- Can I just use Bug-Buddy?
- </title>
-
- <para>
- No. The Ximian bug tracker does not yet have an email-based
- interface, so Bug Buddy cannot talk to it. This will be
- fixed eventually.
- </para>
- </sect2>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
- <!-- -->
- <sect2>
- <title>
- What is a stack trace (backtrace) and how do I get one?
- </title>
-
- <para>
- A stack trace is a list of the chain of function calls that
- lead to some point in the program. Typically, you want to
- get a stack trace when Evolution crashes or hangs and you
- want to try to figure out where in the code that happened
- and why. For this reason, stack traces are extremely useful
- for the Evolution developers, so it's important that you
- learn how to get them, and always include them in crash
- reports.
+ <sect1 id="faq-debugging">
+ <title>Questions about Bugs and Debugging</title>
+ <para>
+ Find a bug? Here's how to help us fix it!
+ </para>
+
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
+ Where should I report bugs for Evolution?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You should report bugs about Evolution into the Ximian bug
+ reporting system (Bugzilla), located at <ulink
+ url="http://bugzilla.ximian.com">http://bugzilla.ximian.com</ulink>.
+ </para>
+
+ <para>
+ Please use the query function to check if a bug has been
+ submitted already before submitting it.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Can I just use Bug-Buddy?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Not yet. The Ximian bug tracker does not yet have an
+ email-based interface, so Bug Buddy cannot talk to it. This
+ will be fixed eventually.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ What is a stack trace (backtrace) and how do I get one?
+ </para>
+ </question>
+ <answer>
+ <para>
+ A stack trace is a list of the chain of function calls that
+ lead to some point in the program. Typically, you want to
+ get a stack trace when Evolution crashes or hangs and you
+ want to try to figure out where in the code that happened
+ and why. For this reason, stack traces are extremely
+ useful for the Evolution developers, so it's important that
+ you learn how to get them, and include them in crash
+ reports. Once we have <command>bug-buddy</command> working
+ with our bug database, it will be much easier to do
+ this. Until then, here's how:
</para>
<para>
@@ -602,247 +617,290 @@ bt
attach PID
</programlisting>
- <para>
- Where <userinput>PID</userinput> is the PID of the
- component. Notice that this also works if you attach right
- after a crash dialog appears, before hitting "OK" or "Submit
- bug report".
- </para>
- </sect2>
-
- </sect1> <!-- End Section: Debugging -->
-
-
- <!-- Section: Features -->
-
- <sect1>
- <title>
- Features
- </title>
-
- <!-- -->
- <sect2>
- <title>
- How can I remove a folder?
- </title>
-
- <para>
- Currently there is no command in Evolution to remove a
- folder, so you have to remove it by hand.
- </para>
-
- <para>
- All the folders are stored in
- <filename>~/evolution/local</filename>. Each folder is a
- directory containing the data files, as well as a
- <filename>subfolders</filename> directory that contains all
- its subfolders. So for example if you have a subfolder of
- the <filename>Inbox</filename> called
- <filename>Foo</filename>, you can run the following command
- to get rid of it (and all it subfolders):
- </para>
+ <para>
+ Where <userinput>PID</userinput> is the PID of the
+ component. Notice that this also works if you attach
+ right after a crash dialog appears, before hitting "OK" or
+ "Submit bug report".
+ </para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
+
+ <sect1 id="faq-features">
+ <title>Features</title>
+ <para>
+ Following is a list of questions about the features in
+ <application>Evolution</application>.
+ </para>
- <programlisting>
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
+ How can I remove a folder?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Currently there is no command in Evolution to remove a
+ folder, so you have to remove it by hand.
+ </para>
+
+ <para>
+ All the folders are stored in
+ <filename>~/evolution/local</filename>. Each folder is a
+ directory containing the data files, as well as a
+ <filename>subfolders</filename> directory that contains
+ all its subfolders. So for example if you have a
+ subfolder of the <filename>Inbox</filename> called
+ <filename>Foo</filename>, you can run the following
+ command to get rid of it (and all it subfolders):
+ </para>
+
+ <programlisting>
rm -rf ~/evolution/local/Inbox/subfolders/Foo
- </programlisting>
-
- <para>
- You should do this after exiting Evolution.
- </para>
- </sect2>
-
- <sect2>
- <title>
- Why doesn't drag and drop between folders seem to work?
- </title>
-
- <para>
- The implementation isn't finished, although it's planned to
- be finished soon.
- </para>
-
- <para>
- In the meantime, you can copy the folders' contents by hand
- from the shell (please do this after quitting Evolution).
- For example:
- </para>
-
- <programlisting>
+ </programlisting>
+
+ <para>
+ You should do this after exiting Evolution.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Why doesn't drag and drop between folders seem to work?
+ </para>
+ </question>
+ <answer>
+ <para>
+ The implementation isn't finished, although it's planned
+ to be finished soon.
+ </para>
+
+ <para>
+ In the meantime, you can copy the folders' contents by
+ hand from the shell (please do this after quitting
+ Evolution). For example:
+ </para>
+
+ <programlisting>
cp -r ~/evolution/local/Inbox/subfolders/Foo ~/evolution/local/Inbox/subfolders/Bar
- </programlisting>
+ </programlisting>
- <para>
- Likewise, you can use <command>mv</command> to rename or
- move folders.
- </para>
- </sect2>
+ <para>
+ Likewise, you can use <command>mv</command> to rename or
+ move folders.
+ </para>
+ </answer>
+ </qandaentry>
- <!-- -->
- <sect2>
- <title>
+ <qandaentry>
+ <question>
+ <para>
Can I read mail from a mailbox file created by some other
application (e.g. Mutt) without importing mail from it?
- </title>
-
- <para>
- No, but it's a planned feature.
</para>
- </sect2>
+ </question>
+ <answer>
+ <para>
+ No, but it's a planned feature.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Can Evolution sync to my Palm OS (tm) device?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Yes. Evolution needs to be compiled with Palm syncing
+ support for this to work though. Please refer to the
+ <filename>README</filename> file for additional
+ information on the requirements.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ What is the difference between a virtual folder (vfolder)
+ and a regular folder?
+ </para>
+ </question>
+ <answer>
+ <para>
+ A virtual folder is like a saved search: it is a view of
+ your mail. Regular folders actually contain the mail
+ messages. You can have one message be in multiple virtual
+ folders, but only in one regular folder. See the section
+ in the Evolution manual about virtual folders for more
+ information.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ Can Evolution spell-check the messages while I compose them?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Yes. The Evolution composer is able to highlight
+ mis-spelled word on the fly as you type them, and also
+ give you suggestions for possible corrections. In order
+ for this to work you need the
+ <filename>gnome-spell</filename> component, which is not
+ shipped with Ximian GNOME yet.
+ </para>
+
+ <para>
+ If you are brave enough, you can check out module
+ <filename>gnome-spell</filename> from the GNOME CVS and
+ compile it yourself. Check out its README file for a list
+ of <filename>gnome-spell</filename>'s requirements for
+ compilation.
+ </para>
+
+ <para>
+ Note that you don't need to recompile Evolution after
+ installing <filename>gnome-spell</filename>; it will be
+ picked up automatically.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ I cannot see the images that are contained in some HTML
+ mail message I am getting. Why?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Evolution currently doesn't support this, but it's a
+ planned feature. It will be an option: many people like
+ to turn off the images because they use up bandwidth and can
+ be used to spy on your email reading habits.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Can I change the font that Evolution uses for compose and
+ displaying mail messages?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You have to change the GtkHTML settings for that: in the
+ GNOME Control Center, go to the "HTML Viewer"
+ configuration page, which is under the "Document Handlers"
+ category.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ How do I import my Outlook <filename>.pst</filename> files into Evolution?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You cannot import these files directly into Evolution
+ because the <filename>.pst</filename> format is a
+ proprietry format. However, Mozilla Mail on Windows can
+ convert them into the <type>mbox</type> format, which can
+ then be imported by Evolution.
+ </para>
+
+ <para>
+ To start importing your Outlook mail to Evolution, run
+ Mozilla Mail on Windows and select the
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import...</guimenuitem></menuchoice>
+ to begin. Then select that you wish to import Mail from
+ Outlook. Once Mozilla has imported all your mail, reboot
+ your computer into Linux.
+ </para>
+
+ <para>
+ Mount your Windows partition in Linux and run Evolution to
+ begin importing your mail. Select
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import
+ File...</guimenuitem></menuchoice> to start importing. Set
+ the file type to MBox (mbox) and click on
+ <guibutton>Browse</guibutton> to select the mail you want
+ to import.
+ </para>
+
+ <para>
+ If you are the only user on Windows, the mail files will
+ be stored in <filename>/mnt/c/windows/Application
+ Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/</filename>
+ where <filename>/mnt/c/</filename> is your windows
+ partition mount point and XXXX is some collection of
+ numbers and digits ending in <filename>.slt</filename>.
+ </para>
+
+ <para>
+ If there is more than one user, the file will be in
+ <filename>/mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/</filename>
+ where USERNAME is your Windows username.
+ </para>
+
+ <para>
+ For each mail folder in Outlook, Mozilla will convert the
+ folder into one mbox file. To import all your mail, import
+ all the files without a <filename>.msf</filename>
+ extension.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ If Mozilla can import <filename>.pst</filename> files, why can't Evolution?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Mozilla on Windows accesses the <filename>.pst</filename>
+ files through the <filename>MAPI.DLL</filename>, which is
+ only avaliable on Windows. <filename>MAPI.DLL</filename>
+ is the only way to access <filename>.pst</filename> files
+ and Evolution cannot use this DLL in Linux.
+ </para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
+ </appendix>
- <!-- -->
- <sect2>
- <title>
- Can Evolution sync to my Palm OS (tm) device?
- </title>
- <para>
- Yes. Evolution needs to be compiled with Palm syncing
- support for this to work though. Please refer to the
- <filename>README</filename> file for additional information
- on the requirements.
- </para>
- </sect2>
- <!-- -->
- <sect2>
- <title>
- What is the difference between a virtual folder (vfolder)
- and a regular folder?
- </title>
- <para>
- A virtual folder is like a saved search: it is a view of
- your mail. Regular folders actually contain the mail
- messages. You can have one message be in multiple virtual
- folders, but only in one regular folder. See the section in
- the Evolution manual about virtual folders for more
- information.
- </para>
- </sect2>
- <!-- -->
- <sect2>
- <title>
- Can Evolution spell-check the messages while I compose them?
- </title>
- <para>
- Yes. The Evolution composer is able to highlight
- mis-spelled word on the fly as you type them, and also give
- you suggestions for possible corrections. In order for this
- to work you need the <filename>gnome-spell</filename>
- component, which is not shipped with Ximian GNOME yet.
- </para>
- <para>
- If you are brave enough, you can check out module
- <filename>gnome-spell</filename> from the GNOME CVS and
- compile it yourself. Check out its README file for a list
- of <filename>gnome-spell</filename>'s requirements for
- compilation.
- </para>
- <para>
- Note that you don't need to recompile Evolution after
- installing <filename>gnome-spell</filename>; it will be
- picked up automatically.
- </para>
- </sect2>
- <!-- -->
- <sect2>
- <title>
- I cannot see the images that are contained in some HTML mail
- message I am getting. Why?
- </title>
- <para>
- Evolution currently doesn't support this, but it's a planned
- feature.
- </para>
- </sect2>
- <sect2>
- <title>
- Can I change the font that Evolution uses for compose and
- displaying mail messages?
- </title>
- <para>
- You have to change the GtkHTML settings for that: in the
- GNOME Control Center, go to the "HTML Viewer" configuration
- page, which is under the "Document Handlers" category.
- </para>
- </sect2>
- <sect2>
- <title>
- How do I import my Outlook <filename>.pst</filename> files into Evolution?
- </title>
-
- <para>
- You cannot import these files directly into Evolution because the
- <filename>.pst</filename> format is a proprietry
- format. However, Mozilla Mail on Windows can convert them
- into the <type>mbox</type> format, which can then be imported by Evolution.
- </para>
-
- <para>
- To start importing your Outlook mail to Evolution, run Mozilla
- Mail on Windows and select the
- <menuchoice><guimenu>File</guimenu><guimenuitem>Import...</guimenuitem></menuchoice>
- to begin. Then select that you wish to import Mail from
- Outlook. Once Mozilla has imported all your mail, reboot your
- computer into Linux.
- </para>
-
- <para>
- Mount your Windows partition in Linux and run Evolution to
- begin importing your mail. Select
- <menuchoice><guimenu>File</guimenu><guimenuitem>Import
- File...</guimenuitem></menuchoice> to start importing. Set the
- file type to MBox (mbox) and click on
- <guibutton>Browse</guibutton> to select the mail you want to
- import.
- </para>
-
- <para>
- If you are the only user on Windows, the mail files will
- be stored in <filename>/mnt/c/windows/Application
- Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/</filename>
- where <filename>/mnt/c/</filename> is your windows partition
- mount point and XXXX is some collection of numbers and digits
- ending in <filename>.slt</filename>.
- </para>
-
- <para>
- If there is more than one user, the file will be in
- <filename>/mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/</filename>
- where USERNAME is your Windows username.
- </para>
- <para>
- For each mail folder in Outlook, Mozilla will convert the
- folder into one mbox file. To import all your mail, import all
- the files without a <filename>.msf</filename> extension.
- </para>
- </sect2>
-
- <sect2>
- <title>
- If Mozilla can import <filename>.pst</filename> files, why can't Evolution?
- </title>
-
- <para>
- Mozilla on Windows accesses the <filename>.pst</filename>
- files through the <filename>MAPI.DLL</filename>, which is only
- avaliable on Windows. <filename>MAPI.DLL</filename> is the
- only way to access <filename>.pst</filename> files and Evolution
- cannot use this DLL in Linux.
- </para>
- </sect2>
- </sect1> <!-- End Section: Features -->
- </article>
diff --git a/doc/C/evolution.sgml b/doc/C/evolution.sgml
index 70c076bb30..e794d4a325 100644
--- a/doc/C/evolution.sgml
+++ b/doc/C/evolution.sgml
@@ -12,6 +12,7 @@
<!ENTITY CONFIG-PREFS SYSTEM "config-prefs.sgml">
<!ENTITY CONFIG-SYNC SYSTEM "config-sync.sgml">
<!ENTITY MENUREF SYSTEM "menuref.sgml">
+<!ENTITY FAQ SYSTEM "evolution-faq.sgml">
<!ENTITY APX-GLOSS SYSTEM "apx-gloss.sgml">
<!ENTITY APX-BUGS SYSTEM "apx-bugs.sgml">
<!ENTITY APX-AUTHORS SYSTEM "apx-authors.sgml">
@@ -33,7 +34,7 @@ implemented. -->
<author><firstname>Kevin</firstname><surname>Breit</surname></author>
</authorgroup>
<copyright>
- <year>2000</year>
+ <year>2001</year>
<holder> Ximian, Inc., </holder>
</copyright>
@@ -63,7 +64,7 @@ implemented. -->
</legalnotice>
<releaseinfo>
- This is version 0.10 of the Evolution manual.
+ This is version 0.11 of the Evolution manual.
</releaseinfo>
</bookinfo>
@@ -126,7 +127,7 @@ implemented. -->
</partintro>
&MENUREF;
</part>
-
+ &FAQ;
&APX-GLOSS;
&APX-BUGS;
&APX-AUTHORS;
diff --git a/help/C/apx-authors.sgml b/help/C/apx-authors.sgml
index 8ba08924b1..694e1158df 100644
--- a/help/C/apx-authors.sgml
+++ b/help/C/apx-authors.sgml
@@ -53,8 +53,10 @@ and other dedicated GNOME programmers.
</para>
<para>
This manual was written by Aaron Weber
- (<email>aaron@ximian.com</email>) and Kevin Breit
- (<email>battery841@mypad.com</email>) with the help of the
+ (<email>aaron@ximian.com</email>), Kevin Breit
+ (<email>battery841@mypad.com</email>) Duncan Mak
+ (<email>duncan@ximian.com</email>) and Ettore Perazzoli
+ (<email>ettore@ximian.com</email>) with the help of the
application programmers and the GNOME Documentation Project.
Please send all comments and suggestions regarding the manual to
the GNOME Documentation Project at
diff --git a/help/C/evolution-faq.sgml b/help/C/evolution-faq.sgml
index 4fdb3940c5..62621ba798 100644
--- a/help/C/evolution-faq.sgml
+++ b/help/C/evolution-faq.sgml
@@ -1,123 +1,114 @@
-<!doctype article PUBLIC "-//Davenport//DTD DocBook V3.0//EN" []>
-
- <article id="index">
- <artheader>
- <authorgroup>
- <author>
- <firstname>Ettore</firstname>
- <surname>Perazzoli</surname>
- </author>
- <author>
- <firstname>Duncan</firstname>
- <surname>Mak</surname>
- </author>
- </authorgroup>
-
- <title>Evolution Frequently Asked questions</title>
- <abstract>
- <para>
- This is a FAQ list and yadda yadda.
- </para>
- </abstract>
- </artheader>
-
-
+<!--
+<!DOCTYPE appendix PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
+-->
+ <appendix id="evolution-faq">
+ <title>Frequently Asked Questions About Ximian Evolution</title>
+ <para>
+ Here are some frequently asked questions about the
+ <application>Evolution</application> groupware suite from
+ Ximian.
+ </para>
+
<!-- Section: Getting and compiling -->
- <sect1>
+ <sect1 id="get-and-compile">
<title>
- Getting and compiling
+ Getting and Compiling Evolution
</title>
-
- <!-- -->
- <sect2>
- <title>
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
Where can I get the latest Evolution release?
- </title>
-
- <para>
- There are two main ways to install the latest Evolution
+ </para>
+ </question>
+ <answer>
+ <para>
+ There are two ways to install the latest Evolution
release:
- </para>
-
<itemizedlist>
- <listitem>
- <para>
- If you have Ximian GNOME installed, you can start Red
- Carpet, Ximian's software updating system, and subscribe
- to the Evolution channel. This will let you install a
- binary for the latest release, and will also warn you
- when a new version has been made available.
- </para>
- </listitem>
-
- <listitem>
- <para>
- If you want to compile from source, you can download the
- latest official Evolution tarball from:
- </para>
-
- <para>
- <ulink url="ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution">
- ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution
- </ulink>
- </para>
- </listitem>
- </itemizedlist>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- Are binary snapshots available?
- </title>
-
+ <listitem>
+ <para>
+ If you have Ximian GNOME installed, you can start
+ Red Carpet, Ximian's software updating system, and
+ subscribe to the Evolution channel. This will let
+ you install a binary for the latest release, and
+ will also warn you when a new version has been made
+ available.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ If you want to compile from source, you can
+ download the latest official Evolution tarball
+ from:
+ </para>
+
+ <para>
+ <ulink url="ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution">
+ ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ Are binary snapshots available?
+ </para>
+ </question>
+ <answer>
<para>
Yes, if you have Ximian GNOME installed. Just run Red
Carpet and subscribe to the Evolution Snapshot channel.
</para>
<para>
- The snapshot builds are logged at <ulink
+ You can check the status of snapshots at <ulink
url="http://primates.ximian.com/~snapshot">http://primates.ximian.com/~snapshot</ulink>.
</para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- Why isn't a new snapshot available today?
- </title>
-
- <para>
- Sometimes the build might fail because of problems with the
- source on CVS. In this case, just wait for next day's
- snapshot.
- </para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- How do I get Evolution from CVS?
- </title>
-
- <para>
- If you already have <ulink url="http://cvs.gnome.org">GNOME
- CVS</ulink> access, simply checkout the following modules:
- evolution, gtkhtml, gal.
- </para>
-
- <para>
- If you don't have a CVS account, you could use anoncvs
- instead. Bear in mind that anoncvs is only synchronized once a
- day, and code received from anoncvs may not be latest version
- available.
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ Why isn't a new snapshot available today?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Sometimes the build might fail because of problems with
+ the source on CVS. In this case, just wait for next day's
+ snapshot.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ How do I get Evolution from CVS?
+ </para>
+ </question>
+ <answer>
+ <para>
+ If you already have <ulink
+ url="http://cvs.gnome.org">GNOME CVS</ulink> access,
+ simply check out the following modules: evolution,
+ gtkhtml, gal.
+ </para>
+ <para>
+ If you don't have a CVS account, you can use anoncvs
+ instead. Bear in mind that anoncvs is only synchronized once
+ a day, and code received from anoncvs may not be latest
+ version available.
</para>
<para>
Before using the anoncvs server, you have to log into it.
- This only needs to be done once.
+ This only needs to be done once. Use this command:
</para>
<programlisting>
@@ -132,21 +123,22 @@ cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
<programlisting>
cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co evolution gtkhtml gal
</programlisting>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- How should I compile Evolution avoiding conflicts with my
- existing GNOME installation?
- </title>
-
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ How should I compile Evolution avoiding conflicts with my
+ existing GNOME installation?
+ </para>
+ </question>
+ <answer>
<para>
The best way is to install Evolution into a separate prefix.
- In order to specify a non-default installation prefix, you can
- pass the <parameter>--prefix</parameter> option to
- <filename>configure</filename> or <filename>autogen.sh</filename>. For
- example:
+ In order to specify a non-default installation prefix, you
+ can pass the <parameter>--prefix</parameter> option to
+ <filename>configure</filename> or
+ <filename>autogen.sh</filename>. For example:
</para>
<programlisting>
@@ -157,7 +149,7 @@ cd /cvs/evolution
<para>
If you install Evolution and the Evolution libraries in a
non-standard prefix, make sure you set the appropriate
- environment variables in your shell's startup script:
+ environment variables in the startup script for Evolution:
</para>
<programlisting>
@@ -168,102 +160,109 @@ export GNOME_PATH=/opt/gnome:/usr
<para>
You may also need to add <filename>$prefix/lib</filename>
(e.g. <filename>/opt/gnome/lib</filename>) to your
- <filename>/etc/ld.so.conf</filename>. <!-- FIXME portable? -->
- </para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- I get <computeroutput>make: *** No rule to make target
- `all-no-@BUILD_INCLUDED_LIBINTL@'</computeroutput>
- </title>
-
- <para>
- You probably have <filename>gettext</filename> 0.10.36 or
- later installed. Try downgrading to 0.10.35; unfortunately,
- 0.10.36 introduced some incompatibilities with the current
- <filename>xml-i18n-tools</filename>.
- </para>
- </sect2>
-
- </sect1> <!-- End Section: Getting and compiling -->
-
- <!-- Section: Troubleshooting -->
-
- <sect1>
+ <filename>/etc/ld.so.conf</filename>. Of course, this will
+ not work for systems which do not use ld.so.conf, such as
+ HP-UX.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ I get <computeroutput>make: *** No rule to make target
+ `all-no-@BUILD_INCLUDED_LIBINTL@'</computeroutput>
+ </para>
+ </question>
+ <answer>
+ <para>
+ You probably have <filename>gettext</filename> 0.10.36 or
+ later installed. Try downgrading to 0.10.35;
+ unfortunately, 0.10.36 introduced some incompatibilities
+ with the current <filename>xml-i18n-tools</filename>.
+ </para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
+
+ <sect1 id="faq-trouble">
<title>Troubleshooting</title>
-
- <!-- -->
- <sect2>
- <title>
- I get <computeroutput>Cannot initialize the Evolution
- shell</computeroutput>.
- </title>
-
- <para>
- Check that:
- </para>
-
- <itemizedlist>
- <listitem>
- <para>
- <filename>oafd</filename> is listen in your <envar>PATH</envar>
- environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <filename>GNOME_Evolution_Shell.oaf</filename> and
- the other      
- <filename>GNOME_Evolution_*.oaf</filename> files are
- readable and installed in
- <filename>$prefix/share/oaf</filename>, where
- <filename>$prefix</filename> is one of the prefixes
- listed in <envar>GNOME_PATH</envar> or
- <envar>OAF_INFO_PATH</envar>.  (These variables are
- supposed to contain $PATH-like colon-separated lists of
- paths.  If the installation prefix for Evolution is
- different from that). Run `oaf-slay' once before running
- `evolution' again if you change $GNOME_PATH or
- $OAF_INFO_PATH.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <filename>evolution</filename>,
- <filename>evolution-mail</filename> and the other
- <filename>evolution-*</filename> executables are in your
- $PATH.
- </para>
- </listitem>
- </itemizedlist>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- I get <computeroutput>Cannot open composer window</computeroutput>.
- </title>
-
- <para>
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
+ I get <computeroutput>Cannot initialize the Evolution
+ shell</computeroutput>.
+ </para>
+ </question>
+ <answer>
+ <para>
+ Check that:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>oafd</filename> is listen in your <envar>PATH</envar>
+ environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <filename>GNOME_Evolution_Shell.oaf</filename> and
+ the other      
+ <filename>GNOME_Evolution_*.oaf</filename> files are
+ readable and installed in
+ <filename>$prefix/share/oaf</filename>, where
+ <filename>$prefix</filename> is one of the prefixes
+ listed in <envar>GNOME_PATH</envar> or
+ <envar>OAF_INFO_PATH</envar>.  (These variables are
+ supposed to contain $PATH-like colon-separated lists of
+ paths.  If the installation prefix for Evolution is
+ different from that). Run `oaf-slay' once before running
+ `evolution' again if you change $GNOME_PATH or
+ $OAF_INFO_PATH.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <filename>evolution</filename>,
+ <filename>evolution-mail</filename> and the other
+ <filename>evolution-*</filename> executables are in your
+ $PATH.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ I get <computeroutput>Cannot open composer window</computeroutput>.
+ </para>
+ </question>
+ <answer>
+ <para>
This actually means that Evolution cannot activate the HTML
editor component from GtkHTML. The comments in the previous
answer still apply; also make sure that
<command>gnome-gtkhtml-editor</command> is in your
<envar>PATH</envar>.
</para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
I updated my Evolution, but my addressbook contacts are no
longer there, what should I do?
- </title>
-
+ </para>
+ </question>
+ <answer>
<para>
Evolution uses the <filename>libdb</filename> library to
handle the addressbook database. Two versions of
@@ -348,60 +347,66 @@ db_dump185 ~/evolution/local/Contacts/addressbook.db.backup | db_load ~/evolutio
</listitem>
</itemizedlist>
- </sect2>
+ </answer>
+ </qandaentry>
- <!-- -->
- <sect2>
- <title>
+ <qandaentry>
+ <question>
+ <para>
Evolution reported an error when trying to retrieve from my
local spool in <filename>/var/spool/mail/username</filename>. Why?
- </title>
-
- <para>
- Evolution doesn't have an external helper for moving mail,
- so <filename>/var/spool/mail/</filename> must be writable by you. Try this:
- </para>
-
- <programlisting>
+ </para>
+ </question>
+ <answer>
+ <para>
+ Evolution doesn't have an external helper for moving mail,
+ so <filename>/var/spool/mail/</filename> must be writable
+ by you. Try this:
+ </para>
+
+ <programlisting>
chmod 1777 /var/spool/mail
</programlisting>
- <para>
- Yes, we know this is a problem. It will be fixed eventually.
- </para>
- </sect2>
+ <para>
+ Yes, we know this is a problem. It will be fixed eventually.
+ </para>
+ </answer>
+ </qandaentry>
- <!-- -->
- <sect2>
- <title>
+ <qandaentry>
+ <question>
+ <para>
Evolution crashes reporting that it couldn't allocate N
billion bytes; how do I fix this?
- </title>
-
- <para>
- This usually happens when a component tries talking a
- certain version of a CORBA interface to another component
- that supports a different version. For example, this can
- happen when you recompile and install a single component
- without recompiling/installing the rest of Evolution.
</para>
-
+ </question>
+ <answer>
+ <para>
+ This usually happens when a component tries talking a
+ certain version of a CORBA interface to another component
+ that supports a different version. For example, this can
+ happen when you recompile and install a single component
+ without recompiling/installing the rest of Evolution.
+ </para>
+
+ <para>
+ So, if this occurs to you, make sure all the components
+ are compiled and installed at the same time. This also
+ applies to GtkHTML upgrades; after upgrading and
+ installing a newer GtkHTML, always re-compile and
+ re-install Evolution against it.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
<para>
- So, if this occurs to you, make sure all the components are
- compiled and installed at the same time. This also applies
- to GtkHTML upgrades; after upgrading and installing a newer
- GtkHTML, always re-compile and re-install Evolution against
- it.
- </para>
-
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
What is <command>killev</command> and why do I need to use it?
- </title>
-
+ </para>
+ </question>
+ <answer>
<para>
Evolution is actually made up of several components that run
as separate processes. Evolution's shell is not very good
@@ -417,19 +422,22 @@ chmod 1777 /var/spool/mail
should try to exit the shell cleanly first, so you give a
chance to the other components to clean things up properly.)
</para>
- </sect2>
-
- <sect2>
- <title>
- What is <command>oaf-slay</command> and why do I need to use it?
- </title>
+ </answer>
+ </qandaentry>
- <para>
- <command>oaf-slay</command> is an utility which comes with
- OAF, the Object Activation Framework that is used in the
- GNOME Desktop to activate components. It will kill the
- object activation daemon (<command>oafd</command>) as well
- as all the active components on the system.
+ <qandaentry>
+ <question>
+ <para>
+ What is <command>oaf-slay</command> and why do I need to use it?
+ </para>
+ </question>
+ <answer>
+ <para>
+ <command>oaf-slay</command> is an utility which comes with
+ OAF, the Object Activation Framework that is used in the
+ GNOME Desktop to activate components. It will kill the
+ object activation daemon (<command>oafd</command>) as well
+ as all the active components on the system.
</para>
<para>
@@ -446,64 +454,71 @@ chmod 1777 /var/spool/mail
<application>Nautilus</application>. To avoid problems, do
not run <command>oaf-slay</command> while you are in GNOME.
</para>
- </sect2>
-
- </sect1> <!-- End Section: Troubleshooting -->
-
-
- <!-- Section: Debugging -->
-
- <sect1>
- <title>
- Debugging
- </title>
-
- <!-- -->
- <sect2>
- <title>
- Where should I report bugs for Evolution?
- </title>
-
- <para>
- You should report bugs about Evolution into the Ximian bug
- reporting system (Bugzilla), located at <ulink
- url="http://bugzilla.ximian.com">http://bugzilla.ximian.com</ulink>.
- </para>
-
- <para>
- Please use the query function to check if a bug has been
- submitted already before submitting it.
- </para>
- </sect2>
-
- <!-- -->
- <sect2>
- <title>
- Can I just use Bug-Buddy?
- </title>
-
- <para>
- No. The Ximian bug tracker does not yet have an email-based
- interface, so Bug Buddy cannot talk to it. This will be
- fixed eventually.
- </para>
- </sect2>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
- <!-- -->
- <sect2>
- <title>
- What is a stack trace (backtrace) and how do I get one?
- </title>
-
- <para>
- A stack trace is a list of the chain of function calls that
- lead to some point in the program. Typically, you want to
- get a stack trace when Evolution crashes or hangs and you
- want to try to figure out where in the code that happened
- and why. For this reason, stack traces are extremely useful
- for the Evolution developers, so it's important that you
- learn how to get them, and always include them in crash
- reports.
+ <sect1 id="faq-debugging">
+ <title>Questions about Bugs and Debugging</title>
+ <para>
+ Find a bug? Here's how to help us fix it!
+ </para>
+
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
+ Where should I report bugs for Evolution?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You should report bugs about Evolution into the Ximian bug
+ reporting system (Bugzilla), located at <ulink
+ url="http://bugzilla.ximian.com">http://bugzilla.ximian.com</ulink>.
+ </para>
+
+ <para>
+ Please use the query function to check if a bug has been
+ submitted already before submitting it.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Can I just use Bug-Buddy?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Not yet. The Ximian bug tracker does not yet have an
+ email-based interface, so Bug Buddy cannot talk to it. This
+ will be fixed eventually.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ What is a stack trace (backtrace) and how do I get one?
+ </para>
+ </question>
+ <answer>
+ <para>
+ A stack trace is a list of the chain of function calls that
+ lead to some point in the program. Typically, you want to
+ get a stack trace when Evolution crashes or hangs and you
+ want to try to figure out where in the code that happened
+ and why. For this reason, stack traces are extremely
+ useful for the Evolution developers, so it's important that
+ you learn how to get them, and include them in crash
+ reports. Once we have <command>bug-buddy</command> working
+ with our bug database, it will be much easier to do
+ this. Until then, here's how:
</para>
<para>
@@ -602,247 +617,290 @@ bt
attach PID
</programlisting>
- <para>
- Where <userinput>PID</userinput> is the PID of the
- component. Notice that this also works if you attach right
- after a crash dialog appears, before hitting "OK" or "Submit
- bug report".
- </para>
- </sect2>
-
- </sect1> <!-- End Section: Debugging -->
-
-
- <!-- Section: Features -->
-
- <sect1>
- <title>
- Features
- </title>
-
- <!-- -->
- <sect2>
- <title>
- How can I remove a folder?
- </title>
-
- <para>
- Currently there is no command in Evolution to remove a
- folder, so you have to remove it by hand.
- </para>
-
- <para>
- All the folders are stored in
- <filename>~/evolution/local</filename>. Each folder is a
- directory containing the data files, as well as a
- <filename>subfolders</filename> directory that contains all
- its subfolders. So for example if you have a subfolder of
- the <filename>Inbox</filename> called
- <filename>Foo</filename>, you can run the following command
- to get rid of it (and all it subfolders):
- </para>
+ <para>
+ Where <userinput>PID</userinput> is the PID of the
+ component. Notice that this also works if you attach
+ right after a crash dialog appears, before hitting "OK" or
+ "Submit bug report".
+ </para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
+
+ <sect1 id="faq-features">
+ <title>Features</title>
+ <para>
+ Following is a list of questions about the features in
+ <application>Evolution</application>.
+ </para>
- <programlisting>
+ <qandaset>
+ <qandaentry>
+ <question>
+ <para>
+ How can I remove a folder?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Currently there is no command in Evolution to remove a
+ folder, so you have to remove it by hand.
+ </para>
+
+ <para>
+ All the folders are stored in
+ <filename>~/evolution/local</filename>. Each folder is a
+ directory containing the data files, as well as a
+ <filename>subfolders</filename> directory that contains
+ all its subfolders. So for example if you have a
+ subfolder of the <filename>Inbox</filename> called
+ <filename>Foo</filename>, you can run the following
+ command to get rid of it (and all it subfolders):
+ </para>
+
+ <programlisting>
rm -rf ~/evolution/local/Inbox/subfolders/Foo
- </programlisting>
-
- <para>
- You should do this after exiting Evolution.
- </para>
- </sect2>
-
- <sect2>
- <title>
- Why doesn't drag and drop between folders seem to work?
- </title>
-
- <para>
- The implementation isn't finished, although it's planned to
- be finished soon.
- </para>
-
- <para>
- In the meantime, you can copy the folders' contents by hand
- from the shell (please do this after quitting Evolution).
- For example:
- </para>
-
- <programlisting>
+ </programlisting>
+
+ <para>
+ You should do this after exiting Evolution.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Why doesn't drag and drop between folders seem to work?
+ </para>
+ </question>
+ <answer>
+ <para>
+ The implementation isn't finished, although it's planned
+ to be finished soon.
+ </para>
+
+ <para>
+ In the meantime, you can copy the folders' contents by
+ hand from the shell (please do this after quitting
+ Evolution). For example:
+ </para>
+
+ <programlisting>
cp -r ~/evolution/local/Inbox/subfolders/Foo ~/evolution/local/Inbox/subfolders/Bar
- </programlisting>
+ </programlisting>
- <para>
- Likewise, you can use <command>mv</command> to rename or
- move folders.
- </para>
- </sect2>
+ <para>
+ Likewise, you can use <command>mv</command> to rename or
+ move folders.
+ </para>
+ </answer>
+ </qandaentry>
- <!-- -->
- <sect2>
- <title>
+ <qandaentry>
+ <question>
+ <para>
Can I read mail from a mailbox file created by some other
application (e.g. Mutt) without importing mail from it?
- </title>
-
- <para>
- No, but it's a planned feature.
</para>
- </sect2>
+ </question>
+ <answer>
+ <para>
+ No, but it's a planned feature.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Can Evolution sync to my Palm OS (tm) device?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Yes. Evolution needs to be compiled with Palm syncing
+ support for this to work though. Please refer to the
+ <filename>README</filename> file for additional
+ information on the requirements.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ What is the difference between a virtual folder (vfolder)
+ and a regular folder?
+ </para>
+ </question>
+ <answer>
+ <para>
+ A virtual folder is like a saved search: it is a view of
+ your mail. Regular folders actually contain the mail
+ messages. You can have one message be in multiple virtual
+ folders, but only in one regular folder. See the section
+ in the Evolution manual about virtual folders for more
+ information.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ Can Evolution spell-check the messages while I compose them?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Yes. The Evolution composer is able to highlight
+ mis-spelled word on the fly as you type them, and also
+ give you suggestions for possible corrections. In order
+ for this to work you need the
+ <filename>gnome-spell</filename> component, which is not
+ shipped with Ximian GNOME yet.
+ </para>
+
+ <para>
+ If you are brave enough, you can check out module
+ <filename>gnome-spell</filename> from the GNOME CVS and
+ compile it yourself. Check out its README file for a list
+ of <filename>gnome-spell</filename>'s requirements for
+ compilation.
+ </para>
+
+ <para>
+ Note that you don't need to recompile Evolution after
+ installing <filename>gnome-spell</filename>; it will be
+ picked up automatically.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ I cannot see the images that are contained in some HTML
+ mail message I am getting. Why?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Evolution currently doesn't support this, but it's a
+ planned feature. It will be an option: many people like
+ to turn off the images because they use up bandwidth and can
+ be used to spy on your email reading habits.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Can I change the font that Evolution uses for compose and
+ displaying mail messages?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You have to change the GtkHTML settings for that: in the
+ GNOME Control Center, go to the "HTML Viewer"
+ configuration page, which is under the "Document Handlers"
+ category.
+ </para>
+ </answer>
+ </qandaentry>
+ <qandaentry>
+ <question>
+ <para>
+ How do I import my Outlook <filename>.pst</filename> files into Evolution?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You cannot import these files directly into Evolution
+ because the <filename>.pst</filename> format is a
+ proprietry format. However, Mozilla Mail on Windows can
+ convert them into the <type>mbox</type> format, which can
+ then be imported by Evolution.
+ </para>
+
+ <para>
+ To start importing your Outlook mail to Evolution, run
+ Mozilla Mail on Windows and select the
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import...</guimenuitem></menuchoice>
+ to begin. Then select that you wish to import Mail from
+ Outlook. Once Mozilla has imported all your mail, reboot
+ your computer into Linux.
+ </para>
+
+ <para>
+ Mount your Windows partition in Linux and run Evolution to
+ begin importing your mail. Select
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import
+ File...</guimenuitem></menuchoice> to start importing. Set
+ the file type to MBox (mbox) and click on
+ <guibutton>Browse</guibutton> to select the mail you want
+ to import.
+ </para>
+
+ <para>
+ If you are the only user on Windows, the mail files will
+ be stored in <filename>/mnt/c/windows/Application
+ Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/</filename>
+ where <filename>/mnt/c/</filename> is your windows
+ partition mount point and XXXX is some collection of
+ numbers and digits ending in <filename>.slt</filename>.
+ </para>
+
+ <para>
+ If there is more than one user, the file will be in
+ <filename>/mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/</filename>
+ where USERNAME is your Windows username.
+ </para>
+
+ <para>
+ For each mail folder in Outlook, Mozilla will convert the
+ folder into one mbox file. To import all your mail, import
+ all the files without a <filename>.msf</filename>
+ extension.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ If Mozilla can import <filename>.pst</filename> files, why can't Evolution?
+ </para>
+ </question>
+ <answer>
+ <para>
+ Mozilla on Windows accesses the <filename>.pst</filename>
+ files through the <filename>MAPI.DLL</filename>, which is
+ only avaliable on Windows. <filename>MAPI.DLL</filename>
+ is the only way to access <filename>.pst</filename> files
+ and Evolution cannot use this DLL in Linux.
+ </para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+ </sect1>
+ </appendix>
- <!-- -->
- <sect2>
- <title>
- Can Evolution sync to my Palm OS (tm) device?
- </title>
- <para>
- Yes. Evolution needs to be compiled with Palm syncing
- support for this to work though. Please refer to the
- <filename>README</filename> file for additional information
- on the requirements.
- </para>
- </sect2>
- <!-- -->
- <sect2>
- <title>
- What is the difference between a virtual folder (vfolder)
- and a regular folder?
- </title>
- <para>
- A virtual folder is like a saved search: it is a view of
- your mail. Regular folders actually contain the mail
- messages. You can have one message be in multiple virtual
- folders, but only in one regular folder. See the section in
- the Evolution manual about virtual folders for more
- information.
- </para>
- </sect2>
- <!-- -->
- <sect2>
- <title>
- Can Evolution spell-check the messages while I compose them?
- </title>
- <para>
- Yes. The Evolution composer is able to highlight
- mis-spelled word on the fly as you type them, and also give
- you suggestions for possible corrections. In order for this
- to work you need the <filename>gnome-spell</filename>
- component, which is not shipped with Ximian GNOME yet.
- </para>
- <para>
- If you are brave enough, you can check out module
- <filename>gnome-spell</filename> from the GNOME CVS and
- compile it yourself. Check out its README file for a list
- of <filename>gnome-spell</filename>'s requirements for
- compilation.
- </para>
- <para>
- Note that you don't need to recompile Evolution after
- installing <filename>gnome-spell</filename>; it will be
- picked up automatically.
- </para>
- </sect2>
- <!-- -->
- <sect2>
- <title>
- I cannot see the images that are contained in some HTML mail
- message I am getting. Why?
- </title>
- <para>
- Evolution currently doesn't support this, but it's a planned
- feature.
- </para>
- </sect2>
- <sect2>
- <title>
- Can I change the font that Evolution uses for compose and
- displaying mail messages?
- </title>
- <para>
- You have to change the GtkHTML settings for that: in the
- GNOME Control Center, go to the "HTML Viewer" configuration
- page, which is under the "Document Handlers" category.
- </para>
- </sect2>
- <sect2>
- <title>
- How do I import my Outlook <filename>.pst</filename> files into Evolution?
- </title>
-
- <para>
- You cannot import these files directly into Evolution because the
- <filename>.pst</filename> format is a proprietry
- format. However, Mozilla Mail on Windows can convert them
- into the <type>mbox</type> format, which can then be imported by Evolution.
- </para>
-
- <para>
- To start importing your Outlook mail to Evolution, run Mozilla
- Mail on Windows and select the
- <menuchoice><guimenu>File</guimenu><guimenuitem>Import...</guimenuitem></menuchoice>
- to begin. Then select that you wish to import Mail from
- Outlook. Once Mozilla has imported all your mail, reboot your
- computer into Linux.
- </para>
-
- <para>
- Mount your Windows partition in Linux and run Evolution to
- begin importing your mail. Select
- <menuchoice><guimenu>File</guimenu><guimenuitem>Import
- File...</guimenuitem></menuchoice> to start importing. Set the
- file type to MBox (mbox) and click on
- <guibutton>Browse</guibutton> to select the mail you want to
- import.
- </para>
-
- <para>
- If you are the only user on Windows, the mail files will
- be stored in <filename>/mnt/c/windows/Application
- Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/</filename>
- where <filename>/mnt/c/</filename> is your windows partition
- mount point and XXXX is some collection of numbers and digits
- ending in <filename>.slt</filename>.
- </para>
-
- <para>
- If there is more than one user, the file will be in
- <filename>/mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/</filename>
- where USERNAME is your Windows username.
- </para>
- <para>
- For each mail folder in Outlook, Mozilla will convert the
- folder into one mbox file. To import all your mail, import all
- the files without a <filename>.msf</filename> extension.
- </para>
- </sect2>
-
- <sect2>
- <title>
- If Mozilla can import <filename>.pst</filename> files, why can't Evolution?
- </title>
-
- <para>
- Mozilla on Windows accesses the <filename>.pst</filename>
- files through the <filename>MAPI.DLL</filename>, which is only
- avaliable on Windows. <filename>MAPI.DLL</filename> is the
- only way to access <filename>.pst</filename> files and Evolution
- cannot use this DLL in Linux.
- </para>
- </sect2>
- </sect1> <!-- End Section: Features -->
- </article>
diff --git a/help/C/evolution.sgml b/help/C/evolution.sgml
index 70c076bb30..e794d4a325 100644
--- a/help/C/evolution.sgml
+++ b/help/C/evolution.sgml
@@ -12,6 +12,7 @@
<!ENTITY CONFIG-PREFS SYSTEM "config-prefs.sgml">
<!ENTITY CONFIG-SYNC SYSTEM "config-sync.sgml">
<!ENTITY MENUREF SYSTEM "menuref.sgml">
+<!ENTITY FAQ SYSTEM "evolution-faq.sgml">
<!ENTITY APX-GLOSS SYSTEM "apx-gloss.sgml">
<!ENTITY APX-BUGS SYSTEM "apx-bugs.sgml">
<!ENTITY APX-AUTHORS SYSTEM "apx-authors.sgml">
@@ -33,7 +34,7 @@ implemented. -->
<author><firstname>Kevin</firstname><surname>Breit</surname></author>
</authorgroup>
<copyright>
- <year>2000</year>
+ <year>2001</year>
<holder> Ximian, Inc., </holder>
</copyright>
@@ -63,7 +64,7 @@ implemented. -->
</legalnotice>
<releaseinfo>
- This is version 0.10 of the Evolution manual.
+ This is version 0.11 of the Evolution manual.
</releaseinfo>
</bookinfo>
@@ -126,7 +127,7 @@ implemented. -->
</partintro>
&MENUREF;
</part>
-
+ &FAQ;
&APX-GLOSS;
&APX-BUGS;
&APX-AUTHORS;