From 53e160a7713f73f14a9fc0e400c2304f7e91ae5f Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Fri, 1 Jun 2001 17:03:52 +0000 Subject: added questions about KDE, redid other questions. svn path=/trunk/; revision=10081 --- doc/C/evolution-faq.sgml | 960 +++++++++++++++++++++++++---------------------- 1 file changed, 516 insertions(+), 444 deletions(-) (limited to 'doc/C') diff --git a/doc/C/evolution-faq.sgml b/doc/C/evolution-faq.sgml index a497b98da2..dcee6b5b07 100644 --- a/doc/C/evolution-faq.sgml +++ b/doc/C/evolution-faq.sgml @@ -3,19 +3,347 @@ --> Frequently Asked Questions About Ximian Evolution - - Here are some frequently asked questions about the - Evolution groupware suite from - Ximian. - - + + Here are some frequently asked questions about the + Evolution groupware suite from + Ximian. If you have a question that's not listed, you can + contact us at evolve@ximian.com. + + + + Features + + + + + + + How can I use Evolution with Microsoft Exchange or Lotus Notes? + + + + + If your server uses standard open protocols like IMAP, + POP, and SMTP, you can use Evolution with it. You can + share addresses with vCards and calendar items with iCal + appointments. We hope to have support for the + proprietary segments of Exchange and Notes severs + eventually, but this will come after Evolution 1.0. + + + + + + + + Can I use Evolution with KDE? + + + + + Evolution will work fine in KDE. You will need to + install all of the GNOME libraries that it depends on. + Also, certain configuration options, such as default + fonts and the message editor keybinding behavior, must be + changed using the GNOME Control Center application (this + will also run from within KDE). + + + + + + + + How can I remove or rename a folder? + + + + + We're going to add a good way to do this soon. In the + mean time, you have to remove it by hand. + + + + All the folders are stored in + ~/evolution/local. Each folder is a + directory containing the data files, as well as a + subfolders directory that contains + all its subfolders. So for example if you have a + subfolder of the Inbox called + Foo, you can run the following + command to get rid of it (and all it subfolders): + + + +rm -rf ~/evolution/local/Inbox/subfolders/Foo + + + + You should do this after exiting Evolution. + + + + + + + + Why doesn't drag and drop between folders seem to work? + + + + + The implementation isn't finished, although it's planned + to be finished soon. + + + + In the meantime, you can copy the folders' contents by + hand from the shell (please do this after quitting + Evolution). For example: + + + +cp -r ~/evolution/local/Inbox/subfolders/Foo ~/evolution/local/Inbox/subfolders/Bar + + + + Likewise, you can use mv to rename or + move folders. + + + + + + + + Can I read mail from a mailbox file created by some other + application (e.g. Mutt) without importing mail from it? + + + + + No, but it's a planned feature. + + + + + + + + Can Evolution sync with my Palm OS (tm) device? + + + + + Yes. However, it is not yet stable enough for general + release and we do not yet ship Evolution with Palm + synchronization enabled default. Until we do, you will + need to compile this in yourself. Check the + README file for additional + information on the requirements. Full compatibility and + synchronization for calendar and addressbook applications + on Palm devices will be implemented and shipped soon. + + + + + + + What is the difference between a virtual folder (vfolder) + and a regular folder? + + + + + 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. + + + + + + + Can Evolution spell-check messages while I compose them? + + + + + 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 + gnome-spell component, which is not + shipped with Ximian GNOME yet. + + + + If you are brave enough, you can check out module + gnome-spell from the GNOME CVS and + compile it yourself. Check out its README file for a list + of gnome-spell's requirements for + compilation. + + + + Note that you don't need to recompile Evolution after + installing gnome-spell; it will be + picked up automatically. + + + + + + + + Why can't I see the images that are contained in some HTML + mail messages. + + + + + 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. + + + + + + + + Can I change the font that Evolution uses to compose and + display mail messages? + + + + + 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. + + + + + + + How do I import my Outlook .pst files into Evolution? + + + + + You cannot import these files directly into Evolution + because the .pst format is a + proprietary format. However, Mozilla Mail on Windows can + convert them into the mbox format, which can + then be imported by Evolution. + + + + To start importing your Outlook mail to Evolution, run + Mozilla Mail on Windows and select the + FileImport... + to begin. Then select that you wish to import Mail from + Outlook. Once Mozilla has imported all your mail, reboot + your computer into Linux. + + + + Mount your Windows partition in Linux and run Evolution to + begin importing your mail. Select + FileImport + File... to start importing. Set + the file type to MBox (mbox) and click on + Browse to select the mail you want + to import. + + + + If you are the only user on Windows, the mail files will + be stored in /mnt/c/windows/Application + Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/ + where /mnt/c/ is your windows + partition mount point and XXXX is some collection of + numbers and digits ending in .slt. + + + + If there is more than one user, the file will be in + /mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/ + where USERNAME is your Windows username. + + + + 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 .msf + extension. + + + + + + + + If Mozilla can import .pst files, why can't Evolution? + + + + + Mozilla on Windows accesses the .pst + files through the MAPI.DLL, which is + only avaliable on Windows. MAPI.DLL + is the only way to access .pst files + and Evolution cannot use this DLL in Linux. + + + + + + + Will there be a server? How about a text-based or web-based front end? + + + + + Of course, we can't comment on unannounced future product + plans, but Evolution's architecture would permit the + existence of that kind of software. If there is enough + demand for such software we will consider moving in that + direction. + + + + + + + + Will Evolution make a good mocha? + + + + + Only espresso is planned, but you can easily plug in a chocolate component. + + + + + + + + Getting and Compiling Evolution - + @@ -125,6 +453,24 @@ + + + + + If Mozilla can import .pst files, why can't Evolution? + + + + + Mozilla on Windows accesses the .pst + files through the MAPI.DLL, which is + only available on Windows. MAPI.DLL + is the only way to access .pst files + and Evolution cannot use this DLL in Linux. + + + + @@ -169,7 +515,8 @@ - I get make: *** No rule to make target + I get the error message: make: *** No rule + to make target `all-no-@BUILD_INCLUDED_LIBINTL@' @@ -185,59 +532,77 @@ - - Troubleshooting + + Troubleshooting - - - I get Cannot initialize the Evolution - shell. - - - - - Check that: - - - - - - oafd is listen in your PATH - environment variable. - - - - - - GNOME_Evolution_Shell.oaf and - the other       - GNOME_Evolution_*.oaf files are - readable and installed in - $prefix/share/oaf, where - $prefix is one of the prefixes - listed in GNOME_PATH or - OAF_INFO_PATH.  (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. - - - - - - evolution, - evolution-mail and the other - evolution-* executables are in your - $PATH. - - - - + + + I get Cannot initialize the Evolution + shell. + + + + + There are a number of things that can cause this error. + Check that: + + + + + + oafd is listen in your PATH + environment variable. + + + + + + GNOME_Evolution_Shell.oaf and + the other       + GNOME_Evolution_*.oaf files are + readable and installed in + $prefix/share/oaf, where + $prefix is one of the prefixes + listed in GNOME_PATH or + OAF_INFO_PATH.  (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. + + + + + + evolution, + evolution-mail and the other + evolution-* executables are in your + $PATH. + + + + - + + + + + I get Cannot open composer window. + + + + + 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 + gnome-gtkhtml-editor is in your + PATH. + + + + @@ -258,8 +623,8 @@ - I updated my Evolution, but my addressbook contacts are no - longer there, what should I do? + I updated Evolution and now my addressbook information is gone! + What should I do? @@ -369,7 +734,7 @@ - Yes, we know this is a problem. It will be fixed eventually. + We're working on a solution to this problem now. @@ -391,7 +756,7 @@ - So, if this occurs to you, make sure all the components + If you run into this problem, 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 @@ -440,13 +805,6 @@ as all the active components on the system. - - Normally, you shouldn't need to run - oaf-slay, unless oafd - gets stuck or confused. For example, it might help in case - Evolution cannot activate components. - - Using oaf-slay oaf-slay is quite drastic and can cause @@ -500,394 +858,108 @@ - - What is a stack trace (backtrace) and how do I get one? - + What is a stack trace (backtrace) and how do I get one? + - 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 bug-buddy working - with our bug database, it will be much easier to do - this. Until then, here's how: + 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 + bug-buddy working with our + bug database, it will be much easier to do this. Until + then, here's how: - - First of all, in order to get a stack trace, your executable - (and possibly the libraries) must be compiled with debugging - symbols. Debugging symbols are created by default if you - compile from CVS, and are included in the snapshot builds. - If you decide to compile by yourself with some custom CFLAGS - value, make sure -g is included in them. + First of all, in order to get a stack trace, your + executable (and possibly the libraries) must be compiled + with debugging symbols. Debugging symbols are created by + default if you compile from CVS, and are included in the + snapshot builds. If you decide to compile by yourself + with some custom CFLAGS value, make sure -g is included + in them. - Finally, you must put the component that crashes through - gdb. Make sure all the components are - dead (exit Evolution and killev), then - run the following command: - - - - gdb name-of-component - - - - Then, at the gdb prompt, type r (for - "run") and wait a few seconds to make sure the component has - registered with the name service. Then start Evolution - normally from a different terminal. - - - - Then, reproduce the crash, and go back to the terminal where - you ran gdb. If the component crashed, - you should have a prompt there; otherwise, just hit - - Control - C - . - At the prompt, type: - - - - info threads - - - - This will give you a list of the current running threads, - e.g. - - - - (gdb) info threads - 8 Thread 6151 (LWP 14908) 0x409778fe in sigsuspend () from /lib/libc.so.6 - 7 Thread 5126 (LWP 14907) 0x409778fe in sigsuspend () from /lib/libc.so.6 - 6 Thread 4101 (LWP 1007) 0x409778fe in sigsuspend () from /lib/libc.so.6 - 5 Thread 3076 (LWP 1006) 0x409778fe in sigsuspend () from /lib/libc.so.6 - 4 Thread 2051 (LWP 1005) 0x409778fe in sigsuspend () from /lib/libc.so.6 - 3 Thread 1026 (LWP 1004) 0x409778fe in sigsuspend () from /lib/libc.so.6 - 2 Thread 2049 (LWP 1003) 0x40a10d90 in poll () from /lib/libc.so.6 - 1 Thread 1024 (LWP 995) 0x40a10d90 in poll () from /lib/libc.so.6 - - - - (Notice that, normally, only - evolution-mail will have more than one - thread.) - - - - Now, for each of the thread listed, type the following - commands: - - - - thread N - bt - - - - Where `N' is the thread number. (In this example, you would - have to do it with N as 1, 2, 3... 8.) Then cut and paste - all the output into some text file, and quit - gdb by typing - quit. - - - - You can also get a stack trace from a running component or a - component that has just crashed. Just start - gdb normally and, instead of using the - r command, use - attach to attach to the running - process: - - - - attach PID - - - - Where PID 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". - - - - - - - - Features - - Following is a list of questions about the features in - Evolution. - - - - - - - How can I remove a folder? - - - - - Currently there is no command in Evolution to remove a - folder, so you have to remove it by hand. - - - - All the folders are stored in - ~/evolution/local. Each folder is a - directory containing the data files, as well as a - subfolders directory that contains - all its subfolders. So for example if you have a - subfolder of the Inbox called - Foo, you can run the following - command to get rid of it (and all it subfolders): - - - - rm -rf ~/evolution/local/Inbox/subfolders/Foo - - - - You should do this after exiting Evolution. - - - - - - - - Why doesn't drag and drop between folders seem to work? - - - - - The implementation isn't finished, although it's planned - to be finished soon. - - - - In the meantime, you can copy the folders' contents by - hand from the shell (please do this after quitting - Evolution). For example: - - - - cp -r ~/evolution/local/Inbox/subfolders/Foo ~/evolution/local/Inbox/subfolders/Bar - - - - Likewise, you can use mv to rename or - move folders. - - - - - - - - Can I read mail from a mailbox file created by some other - application (e.g. Mutt) without importing mail from it? - - - - - No, but it's a planned feature. - - - - - - - - Can Evolution sync to my Palm OS (tm) device? - - - - - Yes. Evolution needs to be compiled with Palm syncing - support for this to work though. Please refer to the - README file for additional - information on the requirements. - - - - - - - What is the difference between a virtual folder (vfolder) - and a regular folder? - - - - - 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. - - - - - - - Can Evolution spell-check the messages while I compose them? - - - - - 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 - gnome-spell component, which is not - shipped with Ximian GNOME yet. - - - - If you are brave enough, you can check out module - gnome-spell from the GNOME CVS and - compile it yourself. Check out its README file for a list - of gnome-spell's requirements for - compilation. - - - - Note that you don't need to recompile Evolution after - installing gnome-spell; it will be - picked up automatically. + gdb, the GNU debugging tool. + To do so, make sure all the components are dead (exit + Evolution and run killev), then run the + following command: + + gdb name-of-component + + + Where "name-of-component" is the name of the component that + crashed. + + + Then, at the gdb prompt, type r (for "run") and wait a + few seconds to make sure the component has registered + with the name service. Then start + Evolution normally from a + different terminal. + + + When you have started + Evolution, reproduce the + crash, and go back to the terminal where you ran gdb. If + the component crashed, you should have a prompt there; + otherwise, just hit Control+C. At the prompt, type + info threads. This will give you a + screen that looks like this: + + + +(gdb) info threads + 8 Thread 6151 (LWP 14908) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 7 Thread 5126 (LWP 14907) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 6 Thread 4101 (LWP 1007) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 5 Thread 3076 (LWP 1006) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 4 Thread 2051 (LWP 1005) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 3 Thread 1026 (LWP 1004) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 2 Thread 2049 (LWP 1003) 0x40a10d90 in poll () from /lib/libc.so.6 + 1 Thread 1024 (LWP 995) 0x40a10d90 in poll () from /lib/libc.so.6 + + + For the most part, only + evolution-mail will have more + than one thread. + + + Now, for each of the threads listed, type the following commands: + +thread N +bt + + Where 'N' is the number of the thread (in this example, 1 + through 8). + + + Cut and paste all the output gdb gives you into a text + file. You can quit gdb by typing + quit + + + If you prefer, you can start gdb while a process is + running. You'll want to do this right after a crash dialog + appears, but before hitting "OK" or "Submit bug report". + Start gdb as above, but instead + of using r, type attach + PID where PID is the process ID of the + component you want to debug. - - - - - I cannot see the images that are contained in some HTML - mail message I am getting. Why? - - - - - 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. - - - - - - - - Can I change the font that Evolution uses for compose and - displaying mail messages? - - - - - 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. - - - - - - - How do I import my Outlook .pst files into Evolution? - - - - - You cannot import these files directly into Evolution - because the .pst format is a - proprietry format. However, Mozilla Mail on Windows can - convert them into the mbox format, which can - then be imported by Evolution. - - - - To start importing your Outlook mail to Evolution, run - Mozilla Mail on Windows and select the - FileImport... - to begin. Then select that you wish to import Mail from - Outlook. Once Mozilla has imported all your mail, reboot - your computer into Linux. - - - - Mount your Windows partition in Linux and run Evolution to - begin importing your mail. Select - FileImport - File... to start importing. Set - the file type to MBox (mbox) and click on - Browse to select the mail you want - to import. - - - - If you are the only user on Windows, the mail files will - be stored in /mnt/c/windows/Application - Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/ - where /mnt/c/ is your windows - partition mount point and XXXX is some collection of - numbers and digits ending in .slt. - - - - If there is more than one user, the file will be in - /mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/ - where USERNAME is your Windows username. - - - - 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 .msf - extension. - - - - - - - - If Mozilla can import .pst files, why can't Evolution? - - - - - Mozilla on Windows accesses the .pst - files through the MAPI.DLL, which is - only avaliable on Windows. MAPI.DLL - is the only way to access .pst files - and Evolution cannot use this DLL in Linux. - - - - - + + - - - \ No newline at end of file + -- cgit v1.2.3