[system-administrators-guide] Change resources section to new style

stephenw stephenw at fedoraproject.org
Sat Feb 28 09:08:27 UTC 2015


commit 72ddce3776fc96ee5927eb6b23ff586f6b3170a9
Author: Stephen Wadeley <swadeley at redhat.com>
Date:   Sat Feb 28 10:09:08 2015 +0100

    Change resources section to new style

 en-US/OpenLDAP.xml |   72 ++++++++++++++++++++++++---------------------------
 1 files changed, 34 insertions(+), 38 deletions(-)
---
diff --git a/en-US/OpenLDAP.xml b/en-US/OpenLDAP.xml
index 857030a..1d64149 100644
--- a/en-US/OpenLDAP.xml
+++ b/en-US/OpenLDAP.xml
@@ -420,7 +420,7 @@
         </tgroup>
       </table>
       <para>
-        For a detailed description of these utilities and their usage, see the corresponding manual pages as referred to in <xref linkend="s3-ldap-installed-docs" />.
+        For a detailed description of these utilities and their usage, see the corresponding manual pages as referred to in <xref linkend="bh-Installed_Documentation_OpenLDAP" />.
       </para>
       <important>
         <title>Make sure the files have correct owner</title>
@@ -1597,29 +1597,24 @@ $DEFAULT_BASE = "dc=example,dc=com";</programlisting>
     <para>
       The following resources offer additional information on the Lightweight Directory Access Protocol. Before configuring LDAP on your system, it is highly recommended that you review these resources, especially the <citetitle pubwork="book">OpenLDAP Software Administrator's Guide</citetitle>.
     </para>
-    <section id="s3-ldap-installed-docs">
-      <title>Installed Documentation</title>
+
+    <bridgehead id="bh-Installed_Documentation_OpenLDAP" renderas="sect2">Installed Documentation</bridgehead>
+
       <para>
         The following documentation is installed with the <package>openldap-servers</package> package:
       </para>
-      <variablelist>
-        <varlistentry>
-          <term><filename>/usr/share/doc/openldap-servers/guide.html</filename></term>
-          <listitem>
-            <para>
-              A copy of the <citetitle pubwork="book">OpenLDAP Software Administrator's Guide</citetitle>.
+      <itemizedlist>
+        <listitem>
+        <para>
+          <filename>/usr/share/doc/openldap-servers/guide.html</filename> &mdash; A copy of the <citetitle pubwork="book">OpenLDAP Software Administrator's Guide</citetitle>.
             </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><filename>/usr/share/doc/openldap-servers/README.schema</filename></term>
-          <listitem>
-            <para>
-              A README file containing the description of installed schema files.
+        </listitem>
+        <listitem>
+        <para>
+          <filename>/usr/share/doc/openldap-servers/README.schema</filename> &mdash; A README file containing the description of installed schema files.
             </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
+        </listitem>
+      </itemizedlist>
       <para>
        Additionally, there is also a number of manual pages that are installed with the <package>openldap</package>, <package>openldap-servers</package>, and <package>openldap-clients</package> packages:
       </para>
@@ -1630,42 +1625,42 @@ $DEFAULT_BASE = "dc=example,dc=com";</programlisting>
             <itemizedlist>
               <listitem>
                 <para>
-                  <command>man ldapadd</command> &#8212; Describes how to add entries to an LDAP directory.
+                  <citerefentry><refentrytitle>ldapadd</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; The manual page for the <command>ldapadd</command> command describes how to add entries to an LDAP directory.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldapdelete</command> &#8212; Describes how to delete entries within an LDAP directory.
+                  <citerefentry><refentrytitle>ldapdelete</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; The manual page for the <command>ldapdelete</command> command describes how to delete entries within an LDAP directory.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldapmodify</command> &#8212; Describes how to modify entries within an LDAP directory.
+                  <citerefentry><refentrytitle>ldapmodify</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; The manual page for the <command>ldapmodify</command> command describes how to modify entries within an LDAP directory.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldapsearch</command> &#8212; Describes how to search for entries within an LDAP directory.
+                  <citerefentry><refentrytitle>ldapsearch</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; The manual page for the <command>ldapsearch</command> command describes how to search for entries within an LDAP directory.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldappasswd</command> &#8212; Describes how to set or change the password of an LDAP user.
+                  <citerefentry><refentrytitle>ldappasswd</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; The manual page for the <command>ldappasswd</command> command describes how to set or change the password of an LDAP user.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldapcompare</command> &#8212; Describes how to use the <command>ldapcompare</command> tool.
+                  <citerefentry><refentrytitle>ldapcompare</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; Describes how to use the <command>ldapcompare</command> tool.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldapwhoami</command> &#8212; Describes how to use the <command>ldapwhoami</command> tool.
+                  <citerefentry><refentrytitle>ldapwhoami</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; Describes how to use the <command>ldapwhoami</command> tool.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man ldapmodrdn</command> &#8212; Describes how to modify the RDNs of entries.
+                  <citerefentry><refentrytitle>ldapmodrdn</refentrytitle><manvolnum>1</manvolnum></citerefentry> &mdash; Describes how to modify the RDNs of entries.
                 </para>
               </listitem>
             </itemizedlist>
@@ -1677,7 +1672,7 @@ $DEFAULT_BASE = "dc=example,dc=com";</programlisting>
             <itemizedlist>
               <listitem>
                 <para>
-                  <command>man slapd</command> &#8212; Describes command line options for the LDAP server.
+                  <citerefentry><refentrytitle>slapd</refentrytitle><manvolnum>8C</manvolnum></citerefentry> &mdash; Describes command line options for the LDAP server.
                 </para>
               </listitem>
             </itemizedlist>
@@ -1689,22 +1684,22 @@ $DEFAULT_BASE = "dc=example,dc=com";</programlisting>
             <itemizedlist>
               <listitem>
                 <para>
-                  <command>man slapadd</command> &#8212; Describes command line options used to add entries to a <command>slapd</command> database.
+                  <citerefentry><refentrytitle>slapadd</refentrytitle><manvolnum>8C</manvolnum></citerefentry> &mdash; Describes command line options used to add entries to a <command>slapd</command> database.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man slapcat</command> &#8212; Describes command line options used to generate an LDIF file from a <command>slapd</command> database.
+                  <citerefentry><refentrytitle>slapcat</refentrytitle><manvolnum>8C</manvolnum></citerefentry> &mdash; Describes command line options used to generate an LDIF file from a <command>slapd</command> database.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man slapindex</command> &#8212; Describes command line options used to regenerate an index based upon the contents of a <command>slapd</command> database.
+                  <citerefentry><refentrytitle>slapindex</refentrytitle><manvolnum>8C</manvolnum></citerefentry> &mdash; Describes command line options used to regenerate an index based upon the contents of a <command>slapd</command> database.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man slappasswd</command> &#8212; Describes command line options used to generate user passwords for LDAP directories.
+                  <citerefentry><refentrytitle>slappasswd</refentrytitle><manvolnum>8C</manvolnum></citerefentry> &mdash; Describes command line options used to generate user passwords for LDAP directories.
                 </para>
               </listitem>
             </itemizedlist>
@@ -1716,21 +1711,22 @@ $DEFAULT_BASE = "dc=example,dc=com";</programlisting>
             <itemizedlist>
               <listitem>
                 <para>
-                  <command>man ldap.conf</command> &#8212; Describes the format and options available within the configuration file for LDAP clients.
+                  <citerefentry><refentrytitle>ldap.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> &mdash; The manual page for the <filename>ldap.conf</filename> file describes the format and options available within the configuration file for LDAP clients.
                 </para>
               </listitem>
               <listitem>
                 <para>
-                  <command>man slapd-config</command> &#8212; Describes the format and options available within the configuration directory.
+                  <citerefentry><refentrytitle>slapd-config</refentrytitle><manvolnum>5</manvolnum></citerefentry> &mdash; Describes the format and options available within the <filename>/etc/openldap/slapd.d</filename> configuration directory.
                 </para>
               </listitem>
             </itemizedlist>
           </listitem>
         </varlistentry>
       </variablelist>
-    </section>
-    <section id="s3-ldap-additional-resources-web">
-      <title>Useful Websites</title>
+
+
+    <bridgehead id="bh-Online_Documentation_OpenLDAP" renderas="sect2">Online Documentation</bridgehead>
+      
       <variablelist>
         <varlistentry>
           <term><ulink url="http://www.openldap.org/doc/admin24/" /></term>
@@ -1794,6 +1790,6 @@ $DEFAULT_BASE = "dc=example,dc=com";</programlisting>
           </listitem>
         </varlistentry>
       </variablelist>
-    </section>
+
   </section>
 </section>


More information about the docs-commits mailing list