CTR: docs
Change formatting of the Realm configuration reference.
<h3> -> <subsection>, so that they are listed in Table of contents.
git-svn-id: https://svn.apache.org/repos/asf/tomcat/tc5.5.x/trunk@1351656 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/container/webapps/docs/config/realm.xml b/container/webapps/docs/config/realm.xml
index 621c01e..a249d97 100644
--- a/container/webapps/docs/config/realm.xml
+++ b/container/webapps/docs/config/realm.xml
@@ -98,17 +98,15 @@
</attributes>
- </subsection>
-
-
- <subsection name="Standard Implementation">
-
<p>Unlike most Catalina components, there are several standard
<strong>Realm</strong> implementations available. As a result,
the <code>className</code> attribute MUST be used to select the
implementation you wish to use.</p>
- <h3>JDBC Database Realm (org.apache.catalina.realm.JDBCRealm)</h3>
+ </subsection>
+
+
+ <subsection name="JDBC Database Realm - org.apache.catalina.realm.JDBCRealm">
<p>The <strong>JDBC Database Realm</strong> connects Catalina to
a relational database, accessed through an appropriate JDBC driver,
@@ -195,10 +193,10 @@
information on setting up container managed security using the
JDBC Database Realm component.</p>
+ </subsection>
- <h3>
- DataSource Database Realm (org.apache.catalina.realm.DataSourceRealm)
- </h3>
+
+ <subsection name="DataSource Database Realm - org.apache.catalina.realm.DataSourceRealm">
<p>The <strong>DataSource Database Realm</strong> connects Catalina to
a relational database, accessed through a JNDI named JDBC DataSource
@@ -292,9 +290,10 @@
DataSource Realm HOW-TO</a> for more information on setting up container
managed security using the DataSource Database Realm component.</p>
+ </subsection>
- <h3>JNDI Directory Realm (org.apache.catalina.realm.JNDIRealm)</h3>
+ <subsection name="JNDI Directory Realm - org.apache.catalina.realm.JNDIRealm">
<p>The <strong>JNDI Directory Realm</strong> connects Catalina to
an LDAP Directory, accessed through an appropriate JNDI driver,
@@ -498,8 +497,10 @@
information on setting up container managed security using the
JNDI Directory Realm component.</p>
+ </subsection>
- <h3>UserDatabase Realm (org.apache.catalina.realm.UserDatabaseRealm)</h3>
+
+ <subsection name="UserDatabase Realm - org.apache.catalina.realm.UserDatabaseRealm">
<p>The <strong>UserDatabase Realm</strong> is a Realm implementation
that is based on a UserDatabase resource made available through the global
@@ -537,7 +538,10 @@
<a href="../jndi-resources-howto.html">JNDI resources how-to</a> for more
information on how to configure a UserDatabase resource.</p>
- <h3>Memory Based Realm (org.apache.catalina.realm.MemoryRealm)</h3>
+ </subsection>
+
+
+ <subsection name="Memory Based Realm - org.apache.catalina.realm.MemoryRealm">
<p>The <strong>Memory Based Realm</strong> is a simple Realm implementation
that reads user information from an XML format, and represents it as a
@@ -597,8 +601,10 @@
information on setting up container managed security using the
Memory Based Realm component.</p>
+ </subsection>
- <h3>User Database Realm (org.apache.catalina.realm.UserDatabaseRealm)</h3>
+
+ <subsection name="User Database Realm - org.apache.catalina.realm.UserDatabaseRealm">
<p>The <strong>User Database Realm</strong> is Realm implementation
that is based on an implementation of the <code>UserDatabase</code>
@@ -621,7 +627,10 @@
information on setting up container managed security using the
UserDatabase Realm component.</p>
- <h3>JAAS Realm (org.apache.catalina.realm.JAASRealm)</h3>
+ </subsection>
+
+
+ <subsection name="JAAS Realm - org.apache.catalina.realm.JAASRealm">
<p>The JAAS Realm implementation supports the following additional
attributes:</p>