Added FAQ-entry for problem with whitespaces in the path under Windows

diff --git a/src/site/xhtml/pitfalls.xhtml b/src/site/xhtml/pitfalls.xhtml
index 90e0924..9b86800 100644 (file)
--- a/src/site/xhtml/pitfalls.xhtml
+++ b/src/site/xhtml/pitfalls.xhtml
@@ -179,5 +179,25 @@ mvn hibernate4:export -Dhibernate.export.force=true</pre>
     &lt;scanDependencies&gt;none&lt;/scanDependencies&gt;
   &lt;/configuration&gt;
 &lt;/plugin&gt;</pre>
+  <h2>No annotated classes found</h2>
+  <p>
+    If you are working under Windows and get the error-message
+    <code>No annotated classes found in directory C:\projects\X Y Z\path-to-project\target\classes</code>,
+    but you are really sure, that there are annotated classes in that
+    directory, you should try to rename your folders, so that their names
+    do not contain any whitespaces.
+  </p>
+  <p>
+    So fare, I got to bug-reports considering this.
+    In both cases, removing all whitespaces from the path solved the error.
+    In both cases, I was not able to reproduce the bug on my development
+    system, which is running under linux.
+  </p>
+  <p>
+    <strong>
+      Hence, I assume, this is a sublte bug in the way, the java-version for
+      Windows is handling paths, that contain whitespaces.
+    </strong>
+  </p>
  </body>
 </html>