docbook docs: changing features section headings into headers, and fixing the example

manual/docbook/doctrine.xml

@@ -88,7 +88,7 @@
 
     // create a new user
     $user = new User();
-    $user->username = "Pookey";
+    $user->username = "pookey";
     $user->password = "a password!";
     $user->created = time();
 
@@ -151,12 +151,14 @@
         <listitem>LIMIT / OFFSET emulation </listitem>
       </itemizedlist>
 
-      <para>
+      <sect3 id="features-orm">
+        <title>
         Object Relational Mapping
-      </para>
-      <para>
+        </title>
+        <sect4 id="features-orm-general">
+          <title>
             General Features
-      </para>
+          </title>
           <itemizedlist>
             <listitem>Validators</listitem>
             <listitem>Transactional errorStack for easy retrieval of all errors</listitem>
@@ -167,10 +169,11 @@
             <listitem>Importing existing database schemas to Doctrine ActiveRecord objects</listitem>
             <listitem>Exporting Doctrine ActiveRecords to database (= automatic table creation)</listitem>
           </itemizedlist>
-      
-      <para>
+        </sect4>
+        <sect4 id="features-orm-mapping">
+          <title>
             Mapping
-      </para>
+          </title>
           <itemizedlist>
             <listitem>Composite, Natural, Autoincremented and Sequential identifiers</listitem>
             <listitem>PHP Array / Object data types for columns (automatic serialization/unserialization)</listitem>
@@ -183,10 +186,12 @@
             <listitem>Self-referencing relations even for association table relations</listitem>
             <listitem>Relation aliases</listitem>
           </itemizedlist>
+        </sect4>
 
-      <para>
+        <sect4 id="features-orm-population">
+          <title>
             Object population
-      </para>
+          </title>
           <itemizedlist>
             <listitem>DQL (Doctrine Query Language), an EJB 3 spec compliant OQL</listitem>
             <listitem>The limit-subquery-algorithm</listitem>
@@ -194,15 +199,19 @@
             <listitem>Object population from database views</listitem>
             <listitem>Object population through raw SQL</listitem>
           </itemizedlist>
+        </sect4>
 
-      <para>
+        <sect4 id="features-orm-locking">
+          <title>
             Transactions and locking
-      </para>
+          </title>
           <itemizedlist>
             <listitem>Pessimistic offline locking</listitem>
             <listitem>Savepoints, transaction isolation levels and nested transactions</listitem>
             <listitem>Transactional query optimization (gathering of DELETE statements) </listitem>
           </itemizedlist>
+        </sect4>
+      </sect3>
     </sect1>
 
     <sect1 id="requirements">