Permalink
Browse files

[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.



git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk@1335337 13f79535-47bb-0310-9956-ffa450edef68
  • Loading branch information...
1 parent b81a939 commit d3d78ef97a76a64f9ce83ba65223520bcebede79 Barrie Treloar committed May 8, 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}}.
@@ -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>

0 comments on commit d3d78ef

Please sign in to comment.