Generate man pages in the AsciiDoc format (#418)

Maxim Thomas

01.20.2024 c19cb1ec29359a2f63f32753c54b837cb6998187

 opendj-cli/src/main/resources/templates/optionsRefSect1.ftl

@@ -1,51 +1,43 @@
<#--
 # The contents of this file are subject to the terms of the Common Development and
 # Distribution License (the License). You may not use this file except in compliance with the
 # License.
 #
 # You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the
 # specific language governing permission and limitations under the License.
 #
 # When distributing Covered Software, include this CDDL Header Notice in each file and include
 # the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL
 # Header, with the fields enclosed by brackets [] replaced by your own identifying
 # information: "Portions Copyright [year] [name of copyright owner]".
 #
 # Copyright 2015 ForgeRock AS.
 #-->
<refsect1 xml:id="${name}-options">
  <title>${title}</title>
# The contents of this file are subject to the terms of the Common Development and
# Distribution License (the License). You may not use this file except in compliance with the
# License.
#
# You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the
# specific language governing permission and limitations under the License.
#
# When distributing Covered Software, include this CDDL Header Notice in each file and include
# the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL
# Header, with the fields enclosed by brackets [] replaced by your own identifying
# information: "Portions Copyright [year] [name of copyright owner]".
#
# Copyright 2015 ForgeRock AS.
# Portions Copyright 2024 3A Systems LLC.
#-->

  <para>
   ${intro}
  </para>
[#${name}-options]
== ${title}

  <#list groups as group>
    <variablelist>
${intro}

<#list groups as group>
    <#if group.description??>
      <para>
       ${group.description}
      </para>
.${group.description}
    </#if>

    <#list group.options as option>
      <varlistentry>
        <term><option>${option.synopsis?xml}</option></term>
        <listitem>
          <para>
            ${option.description?ensure_ends_with(".")}
          </para>

          <#if option.default??>
            <para>
              ${option.default}
            </para>
          </#if>

          <#if option.info??>${option.info}</#if>
        </listitem>
      </varlistentry>
    </#list>
    </variablelist>
--
  <#list group.options as option>
`${option.synopsis?xml}`::
${option.description?ensure_ends_with(".")}
    <#if option.default??>
+
${option.default}
    </#if>
    <#if option.info??>
+
${option.info}
    </#if>
  </#list>
</refsect1>

--
</#list>