X-Git-Url: http://juplo.de/gitweb/?p=hibernate4-maven-plugin;a=blobdiff_plain;f=src%2Fsite%2Fapt%2Fdebugging.apt;fp=src%2Fsite%2Fapt%2Fdebugging.apt;h=5e3d5ab6bb124d367c36844fde8215048bfd4032;hp=0000000000000000000000000000000000000000;hb=4b507b15b0122ac180e44b8418db8d9143ae9c3a;hpb=65bbbdbaa7df1edcc92a3869122ff06a3895fe57

diff --git a/src/site/apt/debugging.apt b/src/site/apt/debugging.apt
new file mode 100644
index 00000000..5e3d5ab6
--- /dev/null
+++ b/src/site/apt/debugging.apt
@@ -0,0 +1,21 @@
+Enabling Debug-Output
+
+  If you are new to <<<hibernate4-maven-plugin>>>, in many cases, the
+  {Configuration-Method-Precedence} may be the source of configuration
+  errors.
+  To solve this problem, you should run maven with the debugging output
+  enabled.
+  For example, by executing:
+
+-------------
+mvn -X compile hibernate4:export 
+-------------
+
+  (The <<<compile>>> might be necessary, because <<<hibernate4-maven-plugin>>>
+  has to scan the compiled classes for annotations!)
+
+  Unlike the majority of the maven-plugins, <<<hibernate4-maven-plugin>>> was
+  designed to give a good many hints, when debugging is enabled.
+  Because, if you do not know, what went wrong, you can't fix it!
+
+  <<But be warned:>> <<<hibernate4-maven-plugin>>> tends to be very chatty ;)