adding faq entry on crashes in KDE and other ubunu desktop environments
authorAndreas Kohlbecker <a.kohlbecker@bgbm.org>
Tue, 4 Feb 2014 12:25:55 +0000 (12:25 +0000)
committerAndreas Kohlbecker <a.kohlbecker@bgbm.org>
Tue, 4 Feb 2014 12:25:55 +0000 (12:25 +0000)
src/site/fml/troubleshooting.fml

index 826ca7f..a27c259 100644 (file)
                                <p>The editor should launch again.</p>
                        </answer>
                </faq>
+               <faq id="ubuntu_gtk2_eclipse_rcp_crash">
+                       <question>The Taxonomic Editor crashes or freezes in recent Ubuntu versions</question>
+                       <answer>
+                               <p>In recent Ubuntu versions (13.04, 13.10) the Taxomomic Editor crashes frequently (KDE) or freezes for some time (GNOME). The crashes in KDE are due to a bug which affects all Eclipse indigo (3.7) RCP based applications. Even this bug is currently discussed in the affected developer communities: <a href="https://bugs.launchpad.net/ubuntu/+source/unity/+bug/1241101">launchpad bug 1241101</a>, <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=419729">eclipse bug 419729</a> the cause of this bug is still unclear.
+                           </p>
+                               <p>In KDE the crash occurs when the oxygene_gtk is being used. Therefore switching to another GTK2 theme is known as a  temporary solution. The GTK2 theme Raleigh has been sucessfully used as a replacement to the oxygen_gtk2. You can either configure it globally or set the environmanet variable GTK2_RC_FILES for the application to run.</p>
+                               <p>
+                               <code>GTK2_RC_FILES=/usr/share/themes/Raleigh/gtk-2.0/gtkrc "/path/to/EDIT Taxonomic Editor/TaxonomicEditor"</code>
+                       </p>
+                               <p>The font size is usually too big in the default configration of this theme. In order to have a nicer font, you can create a file named .gtkrc-eclipse in your user home folder with the following content:</p>
+<pre>style "eclipse" {
+        font_name = "Ubuntu 9"
+}
+class "GtkWidget" style "eclipse"
+</pre>
+                               <p>Finally, to launch the Editor, use following command line:</p>
+<p>
+                               <code>GTK2_RC_FILES=/usr/share/themes/Raleigh/gtk-2.0/gtkrc:~/.gtkrc-eclipse "/path/to/EDIT Taxonomic Editor/TaxonomicEditor"</code>
+                               </p>
+                       </answer>
+               </faq>
        </part>
 </faqs>