X-Git-Url: https://dev.e-taxonomy.eu/gitweb/taxeditor.git/blobdiff_plain/ddd13af9fba5ff455de8b9cdcb826ce384b1a218..0fe7b5fedabe7507630b04f0817fb1d549241345:/src/site/fml/troubleshooting.fml

diff --git a/src/site/fml/troubleshooting.fml b/src/site/fml/troubleshooting.fml
index e9b0eb6e7..a27c259c6 100644
--- a/src/site/fml/troubleshooting.fml
+++ b/src/site/fml/troubleshooting.fml
@@ -23,12 +23,12 @@
 			</answer>
 		</faq>
 		<faq id="taxeditor_projects_have_errors">
-			<question>All taxeditor projects have errors and it seems like they can't see the cdmlib dependecies.</question>
+			<question>Some of the taxeditor projects have errors</question>
 			<answer>
-				<p>There are two possible solutions for this problem.</p>
+				<p>And the errors do look like the cdmlib dependecies can not be resolved, there are two possible solutions for this problem.</p>
 				<ol>
 					<li><em>cdmlib-plugin</em> does not contain the cdmlib dependencies
-						<p>Please follow the instructions on <a href="./getting-started.html#Initializing_the_cdmlib_plugin">how to initialize the cdmlib-plugin</a></p>
+						<p>Please follow the instructions on <a href="./getting-started.html#Dependencies">how to initialize the cdmlib-plugin</a></p>
 					</li>
 					<li>Your classpath is outdated
 						<p>Update your classpath by right-clicking any of the <em>taxeditor-*</em> projects and choose <em>PDE Tools -&gt; Update Classpath...</em>. Click &lt;Select All&gt; in the dialog and confirm.</p>
@@ -57,5 +57,26 @@
 				<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>