svn commit: r1335337 - in /maven/plugins/trunk/maven-eclipse-plugin/src/site: apt/trouble-shooting/index.apt fml/faq.fml

[ba...@apache.org]

Author: baerrach
Date: Tue May  8 04:53:30 2012
New Revision: 1335337

URL: http://svn.apache.org/viewvc?rev=1335337&view=rev
Log:
[MECLIPSE-721] Improve documentation to explain why Eclipse sometimes does not import projects with correct project names.

o Updated FAQ and trouble shooting to explain the problem with links to the Eclipse bugs and the steps to work around the issue.


Modified:
    maven/plugins/trunk/maven-eclipse-plugin/src/site/apt/trouble-shooting/index.apt
    maven/plugins/trunk/maven-eclipse-plugin/src/site/fml/faq.fml

Modified: maven/plugins/trunk/maven-eclipse-plugin/src/site/apt/trouble-shooting/index.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-eclipse-plugin/src/site/apt/trouble-shooting/index.apt?rev=1335337&r1=1335336&r2=1335337&view=diff
==============================================================================
--- maven/plugins/trunk/maven-eclipse-plugin/src/site/apt/trouble-shooting/index.apt (original)
+++ maven/plugins/trunk/maven-eclipse-plugin/src/site/apt/trouble-shooting/index.apt Tue May  8 04:53:30 2012
@@ -36,3 +36,6 @@ Trouble Shooting
 
   See {{{./jdk-being-used-is-different-than-expected.html}jdk being used is different than expected}}.
 
+* The Eclipse project is not named correctly
+
+  Please see the FAQ {{{../faq.html#import-project-incorrect-project-name}Eclipse is not using the correct project name and is using the directory name instead}}.

Modified: maven/plugins/trunk/maven-eclipse-plugin/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-eclipse-plugin/src/site/fml/faq.fml?rev=1335337&r1=1335336&r2=1335337&view=diff
==============================================================================
--- maven/plugins/trunk/maven-eclipse-plugin/src/site/fml/faq.fml (original)
+++ maven/plugins/trunk/maven-eclipse-plugin/src/site/fml/faq.fml Tue May  8 04:53:30 2012
@@ -37,6 +37,18 @@ under the License.
        <p>You may also need to import the project created by Maven Eclipse Plugin. More information can be found <a href="usage.html#Simple Project">here</a>.</p>
      </answer>
    </faq>
+   <faq id="import-project-incorrect-project-name">
+     <question>Eclipse is not using the correct project name and is using the directory name instead</question>
+     <answer>
+       <p>See the Eclipse bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=225754#c38">225754</a>.</p>
+       <p>Essentially if the folder:</p>
+          <ul>
+            <li>is directly below the default workspace then it IGNORES the .project/name element on the import and uses the directory name instead</li>
+            <li>is NOT directly below the default workspace then it correctly uses .project/name</li>
+          </ul>
+       <p>This may be why the current Eclipse recommendation is to create a workspace that has NO projects kept underneath it, which will mean correctly named projects.</p>
+     </answer>
+   </faq>
    <faq id="use-add-maven-repo">
      <question>After running <i>mvn eclipse:eclipse</i>, the generated dependencies are pointing to a non-existing file. What needs to be done?</question>
      <answer>