-<faqs xmlns="http://maven.apache.org/FML/1.0.1"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
- title="Frequently Asked Questions"
- toplink="false">
-
- <part id="general">
- <title>General</title>
-
- <faq id="whats-foo">
- <question>
- What is Foo?
- </question>
- <answer>
- <p>some markup goes here</p>
-
- <source>some source code</source>
-
- <p>some markup goes here</p>
- </answer>
- </faq>
-
- <faq id="whats-bar">
- <question>
- What is Bar?
- </question>
- <answer>
- <p>some markup goes here</p>
- </answer>
- </faq>
- </part>
-
- <part id="install">
-
- <title>Installation</title>
-
- <faq id="how-install">
- <question>
- How do I install Foo?
- </question>
- <answer>
- <p>some markup goes here</p>
- </answer>
- </faq>
-
- </part>
-
-</faqs>
\ No newline at end of file
+<faqs xmlns="http://maven.apache.org/FML/1.0.1"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
+ title="Troubleshooting"
+ toplink="true">
+ <part id="general">
+ <title>General</title>
+ <faq id="How_can_I_configure_logging_in_the_editor">
+ <question>How can I configure logging in the editor?</question>
+ <answer>
+ <p>To get log4j to read your own configuration when developing the editor or
+ anything that has to do with cdmLibrary eclipse plugin you have to tell
+ log4j explicitly what configuration it should use. Otherwise it will scan
+ the classpath and use the first log4j.xml/log4j.properties file it finds
+ (which is mostly the log4j.properties in cdmlib-commons as it will be the
+ first one it encounters).</p>
+ <p>Passing the following argument to the Virtual Machine however does the trick:</p>
+ <source>-Dlog4j.configuration=file:///<path to your personal>/log4j.properties</source>
+ <p>If you run into trouble , you can debug log4j's startup sequence by passing
+ another argument to the VM.</p>
+ <source>-Dlog4j.debug</source>
+ </answer>
+ </faq>
+ <faq id="taxeditor_projects_have_errors">
+ <question>Some of the taxeditor projects have errors</question>
+ <answer>
+ <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#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 -> Update Classpath...</em>. Click <Select All> in the dialog and confirm.</p>
+ </li>
+ </ol>
+ </answer>
+ </faq>
+ <faq id="Launching_the_editor_from_eclipse_is_simply_not_working">
+ <question>Launching the editor from eclipse is simply not working for me.</question>
+ <answer>
+ <p>This could be due to many reasons. Please have a look at the <a href="http://dev.e-taxonomy.eu/trac/wiki/TroubleshootingEditorLaunches">Troubleshooting Editor Launches</a> document on the developers wiki.</p>
+ </answer>
+ </faq>
+ <faq id="No_application_id_has_been_found">
+ <question>I get a "RuntimeException: No application id has been found." preceded by lots of "Missing required bundle" errors when launching my run/debug configuration</question>
+ <answer>
+ <p>Whenever you change something in the plguin dependency hirarchy, i.e. adding, (re)moving, or renaming a dependant plugin your run configuration does not know about that automatically. To solve this:</p>
+ <ul>
+ <li>In eclipse, open the <em>Run Configurations</em> wizard</li>
+ <li>Choose the run configuration in question</li>
+ <li>Select the <em>Plug-ins</em> tab</li>
+ <li>Click <em>Deselect All</em> from the buttons on the right</li>
+ <li>Click <em>Add Required Plug-ins</em></li>
+ <li>Apply your changes</li>
+ </ul>
+ <p>The editor should launch again.</p>
+ </answer>
+ </faq>
+ </part>
+</faqs>