* </ul>
*
* <p>
- * See the <a href="#design-overview">design overview</a> for a an overview of the design.
+ * See also the <a href="#design-overview">design overview</a>.
* </p>
*
* <a name="db-basic">
* Database db = DatabaseBuilder.getDatabase();
* DataSource dataSource = db.start();
* </pre>
+ * <p>
* If nothing is specified in the user's environment, an inmemory database is started (derby).
- * Using the datasource is just standard JDBC now.
- * Stopping the database
+ * Using the datasource is just standard JDBC now.
+ * </p>
+ * <p>
+ * After a test it is good practice to stop the database:
+ * </p>
* <pre>
* db.stop();
* </pre>
* <p>
* However, the most convenient way to set the capabilities is usually to set a system property or environment
* variable see the javadocs of {@link DatabaseBuilder}. and
- * specifically {@link DatabaseBuilder#DB_CAPABILITIES_PROP}
+ * specifically <code>DatabaseBuilder.DB_CAPABILITIES_PROP</code>
* </p>
*
*
* <h2>Using DB Unit in your tests</h2>
* </a>
*
- * <p>To work with <a href="http://dbunit.org">DBUnit</a>, {@link DatabaseUtils#createDbTester(org.dbunit.dataset.filter.ITableFilterSimple)}
+ * <p>To work with <a href="http://dbunit.org">DBUnit</a>,
+ * <code>DatabaseUtils#createDbTester(org.dbunit.dataset.filter.ITableFilterSimple)</code>
* must be used passing it in the tables to use in the form of a {@link org.dbunit.dataset.filter.ITableFilterSimple}
* object. </p>
*
* want to test.
* </p>
* <p>Second step is to make sure that all entities are listed explicitly in your
- * <pre>persistence.xml</pre>. Currently, class path scanning appears to fail when
+ * <code>persistence.xml</code>. Currently, class path scanning appears to fail when
* run from junit.
* Specifying all entities explicitly is not necessarily a bad thing as it is also more efficient.
* </p>
* get them directly from the <code>JPATester</code> after initializing it:
* <pre>
* builder = jpaTester.getJpaBuilder();
- * dbtester = jpaTester.getDbUtils().createDbTester(new MyTables());
* dbutils = jpaTester.getDbUtils();
+ * dbtester = dbutils.createDbTester(new MyTables());
* </pre>
*
* <a name="db-jpa-services">