DOCBOOK: option description in reference pages

[Johannes Zellner <johannes@zellner.org>]

Hi,

what is the recommended way (tag sequence) of describing
program switches in <refentry> pages?

I'd like to have output like

    OPTIONS

    -r, --some-option=[fred]

        option description text

    --another-option

        more text

is it:

    <refsynopsisdiv><title>OPTIONS</title>
      <cmdsynopsis>

        <arg><option>-r</option>, <option>--some-option=</option><replaceable>fred</replaceable></arg>
        <para>
          option description text
        </para>

        <arg><option>--another-option</arg>
        <para>
          more text
        </para>

      </cmdsynopsis>
    </refsynopsisdiv>

or is there another recommended way?

-- 
   Johannes