Switched to maven-thymeleaf-skin 1.0.0
[hibernate4-maven-plugin] / src / site / xhtml / pitfalls.xhtml
index 90e0924..a64712f 100644 (file)
@@ -4,6 +4,7 @@
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  </head>
  <body>
+  <header><h1>Known Pitfalls (FAQ)</h1></header>
   <h2>Annotated classes in dependencies are not found.</h2>
   <p>
   hibernate4-maven-plugin by default scans dependencies in the scope
@@ -179,5 +180,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>