From: Kai Moritz <kai@juplo.de>
Date: Wed, 9 Oct 2013 19:30:28 +0000 (+0200)
Subject: Reworked APT-Documentation: page-titles were missing
X-Git-Tag: hibernate4-maven-plugin-1.0.3~5
X-Git-Url: http://juplo.de/gitweb/?a=commitdiff_plain;h=84e8517be79d88d7e2bec2688a8f965f591394bf;p=hibernate-maven-plugin
Reworked APT-Documentation: page-titles were missing
---
diff --git a/src/site/apt/configuration.apt b/src/site/apt/configuration.apt
index a0934138..98fad3bc 100644
--- a/src/site/apt/configuration.apt
+++ b/src/site/apt/configuration.apt
@@ -1,6 +1,10 @@
-Configuration Examples
+ ---
+ Configuration Examples
+ ---
+ Kai Moritz
+ ---
-* Configuration through a hibernate.properties-File
+Configuration through a hibernate.properties-File
The most simple way to configure the plugin is, to put all the
hibernate-configuration in a <<hibernate.properties>>-file on your
@@ -59,7 +63,7 @@ Configuration Examples
You never can overwrite them by accident when specifying a property on
the commandline or in your <<<settings.xml>>>.
-* Configuration through maven-properties
+Configuration through maven-properties
Alternatively, it is possible, to configure the plugin via maven-properties.
Each relevant configuration-option has a corresponding maven-property
@@ -120,7 +124,7 @@ Configuration Examples
<plugins>
---------------
-* Configuration through the plugin-configuration
+Configuration through the plugin-configuration
A third way for configuring the plugin is the plugin-configuration.
The relevant configuration-parameters are:
diff --git a/src/site/apt/debugging.apt b/src/site/apt/debugging.apt
index 5e3d5ab6..37e81186 100644
--- a/src/site/apt/debugging.apt
+++ b/src/site/apt/debugging.apt
@@ -1,4 +1,8 @@
-Enabling Debug-Output
+ ---
+ Enabling Debug-Output
+ ---
+ Kai Moritz
+ ---
If you are new to <<<hibernate4-maven-plugin>>>, in many cases, the
{Configuration-Method-Precedence} may be the source of configuration
diff --git a/src/site/apt/force.apt b/src/site/apt/force.apt
index 566811ae..bff87d87 100644
--- a/src/site/apt/force.apt
+++ b/src/site/apt/force.apt
@@ -1,4 +1,8 @@
-Force execution
+ ---
+ Force execution
+ ---
+ Kai Moritz
+ ---
The hibernate4-maven-plugin computes MD5-sums for all found annotated
classes and stores them together with the generated schema.
diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
index 63116846..76af6732 100644
--- a/src/site/apt/index.apt
+++ b/src/site/apt/index.apt
@@ -1,4 +1,8 @@
-A simple Plugin for generating a Database-Schema from Hibernate 4 Mapping-Annotations.
+ ---
+ A simple Plugin for generating a Database-Schema from Hibernate 4 Mapping-Annotations.
+ ---
+ Kai Moritz
+ ---
<<hibernate4-maven-plugin>> is a plugin for generating a database-schema
from your Hibernate-4-Mappings and create or update your database
@@ -31,7 +35,7 @@ A simple Plugin for generating a Database-Schema from Hibernate 4 Mapping-Annota
For more information about the inspiration to write this tiny plugin,
{{{/hibernate4-maven-plugin-a-simple-plugin-for-generating-a-database-schema-from-hibernate-4-mapping-annotations/} read our blog-article about the hibernate4-maven-plugin}}.
-* Documentation
+Documentation
* See {{{./configuration.html} Configuration Examples}} for Usage-Explanations
and simple examples of how to use this plugin.
@@ -42,7 +46,7 @@ A simple Plugin for generating a Database-Schema from Hibernate 4 Mapping-Annota
of the Hibernate-Tools <<<SchemaExport>>> and <<<SchemaUpdate>>>, that do
the work in the background.
-* Releases
+Releases
* {{{http://juplo.de/hibernate4-maven-plugin} current version}}
diff --git a/src/site/apt/issue-tracking.apt b/src/site/apt/issue-tracking.apt
index 8edcb435..42292e1a 100644
--- a/src/site/apt/issue-tracking.apt
+++ b/src/site/apt/issue-tracking.apt
@@ -1,4 +1,8 @@
-Issue Tracking
+ ---
+ Issue Tracking
+ ---
+ Kai Moritz
+ ----
<<There is no bug-tracking system set up for this project!>>
diff --git a/src/site/apt/mail-lists.apt b/src/site/apt/mail-lists.apt
index f55b6207..e8c17ec5 100644
--- a/src/site/apt/mail-lists.apt
+++ b/src/site/apt/mail-lists.apt
@@ -1,4 +1,8 @@
-Mailing Lists
+ ---
+ Mailing Lists
+ ---
+ Kai Moritz
+ ---
<<There are no mailinglists defined for this project!>>
diff --git a/src/site/apt/pitfalls.apt b/src/site/apt/pitfalls.apt
index 24909a5c..33c40cfa 100644
--- a/src/site/apt/pitfalls.apt
+++ b/src/site/apt/pitfalls.apt
@@ -1,6 +1,10 @@
-Known Pitfalls
+ ---
+ Known Pitfalls
+ ---
+ Kai Moritz
+ ---
-* hibernate4-maven-plugin always needs a database-connection
+hibernate4-maven-plugin always needs a database-connection
The default-configuration uses the EXPORT-target of the SchemaExport-Tool.
If you do not need to create a database with the evaluated schema, you can
@@ -17,7 +21,7 @@ Known Pitfalls
But even when no database is to be created, hibernate always needs to know
the dialect. Hence, the plugin will fail if this parameter is missing!
-* Dependency for driver-class XYZ is missing
+Dependency for driver-class XYZ is missing
One regular problem is the scope of the jdbc-driver-dependency.
It is very unlikely, that this dependency is needed at compile-time.
@@ -81,7 +85,7 @@ Known Pitfalls
Because otherwise, this dependency will unnecessarily bloat the
runtime-dependencies of your project.
-* DBUnit {fails} after execution of hibernate4 was skipped because nothing has changed
+DBUnit {fails} after execution of hibernate4 was skipped because nothing has changed
If hibernate4-maven-plugin skips its excecution, this may lead to errors in
other plugins.
@@ -113,7 +117,7 @@ Known Pitfalls
</plugin>
------------
-* The database will not be recreated after a manual drop/clean
+The database will not be recreated after a manual drop/clean
If one manually drops the database or removes the hsqldb-files, it will not
be recreated by the hibernate4-maven-plugin, because it cannot detect, that
@@ -135,7 +139,7 @@ Known Pitfalls
mvn hibernate4:export -Dhibernate.export.force=true
-------------
-* The hibernate4:export goal is not executed, when tests are skipped
+The hibernate4:export goal is not executed, when tests are skipped
The hibernate4-maven-plugin automatically skips its execution, when
<<<maven.test.skip>>> is set to <<<true>>>. If you need it to be always
@@ -153,4 +157,4 @@ mvn hibernate4:export -Dhibernate.export.force=true
------------
Background-information for this design-decission can be found on the extra
- page {{{./skip.html}To skip or not to skip: that is the question}}...
\ No newline at end of file
+ page {{{./skip.html}To skip or not to skip: that is the question}}...