commit 72ddce3776fc96ee5927eb6b23ff586f6b3170a9 Author: Stephen Wadeley swadeley@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>