OPENDJ-1144: Document recognized control names

Mark Craig

23.39.2013 2e2be1e27a820308b7cf904e0e20aa4677b3d731

 opendj3/src/main/docbkx/dev-guide/man-ldapsearch.xml

@@ -30,7 +30,7 @@
 xsi:schemaLocation='http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd'
 xmlns:xlink='http://www.w3.org/1999/xlink'
 xmlns:xinclude='http://www.w3.org/2001/XInclude'>
 <info><copyright><year>2011-2012</year><holder>ForgeRock AS</holder></copyright></info>
 <info><copyright><year>2011-2013</year><holder>ForgeRock AS</holder></copyright></info>
 <refmeta>
  <refentrytitle>ldapsearch</refentrytitle><manvolnum>1</manvolnum>
  <refmiscinfo class="software">OpenDJ</refmiscinfo>
@@ -128,6 +128,87 @@
    <term><option>-J, --control {controloid[:criticality[:value|::b64value|:&lt;filePath]]}</option></term>
    <listitem>
     <para>Use a request control with the provided information</para>

      <para>
       For some <replaceable>controloid</replaceable> values,
       you can replace object identifiers with user-friendly strings.

       The strings are listed here in lower case, but the case is not important.
       You can use camelCase if you prefer, for example.
      </para>

     <variablelist>
      <varlistentry>
       <term><literal>accountusable</literal></term>
       <term><literal>accountusability</literal></term>
       <listitem>
        <para>Account Usability Control, Object Identifier: 1.3.6.1.4.1.42.2.27.9.5.8</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>authzid</literal></term>
       <term><literal>authorizationidentity</literal></term>
       <listitem>
        <para>Authorization Identity Request Control, Object Identifier: 2.16.840.1.113730.3.4.16</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>effectiverights</literal></term>
       <term><literal>geteffectiverights</literal></term>
       <listitem>
        <para>Get Effective Rights Request Control, Object Identifier: 1.3.6.1.4.1.42.2.27.9.5.2</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>managedsait</literal></term>
       <listitem>
        <para>Manage DSAIT Request Control, Object Identifier: 2.16.840.1.113730.3.4.2</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>noop</literal></term>
       <term><literal>no-op</literal></term>
       <listitem>
        <para>No-Op Control, Object Identifier: 1.3.6.1.4.1.4203.1.10.2</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>pwpolicy</literal></term>
       <term><literal>passwordpolicy</literal></term>
       <listitem>
        <para>Password Policy Control, Object Identifier: 1.3.6.1.4.1.42.2.27.8.5.1</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>realattrsonly</literal></term>
       <term><literal>realattributesonly</literal></term>
       <listitem>
        <para>Real Attributes Only Request Control, Object Identifier: 2.16.840.1.113730.3.4.17</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>subtreedelete</literal></term>
       <term><literal>treedelete</literal></term>
       <listitem>
        <para>Subtree Delete Request Control, Object Identifier: 1.2.840.113556.1.4.805</para>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term><literal>virtualattrsonly</literal></term>
       <term><literal>virtualattributesonly</literal></term>
       <listitem>
        <para>Virtual Attributes Only Request Control, Object Identifier: 2.16.840.1.113730.3.4.19</para>
       </listitem>
      </varlistentry>
     </variablelist>
    </listitem>
   </varlistentry>
   <varlistentry>