[Doxygen-users] Extra spacing between argument types and argument names in HTML output

[Geoff A. <gd...@us...>]

I've encountered a problem where there is large spacing between argument
types
and argument types in HTML output.  The problem occurs when there are
multiple
arguments and the text after the argument list is longer that the longest
argument type argument name pair.  Looking at the generated HTML, I believe
the
problem is due the use of colspan="2" for the text after the argument list.
Here is a example:

  /**
   * MyClass description.
   */
  class MyClass
  {
    /**
     * func1 description.
     */
  public:
    int func1( int a, int b, int c ) const
      throw( Exception1, Exception2, Exception3);
  };

The resulting table generated for func1 is

        <table cellpadding="0" cellspacing="0" border="0">
          <tr>
            <td class="md" nowrap valign="top">
  int MyClass::func1
            </td>
            <td class="md">(&nbsp</td>
            <td class="md">int          </td>
            <td class="mdname"> <em>a</em>,           </td>
          </tr>
          <tr>
            <td></td>
            <td></td>
            <td class="md">        <tr>
            <td></td>
            <td></td>
            <td class="md">int          </td>
            <td class="mdname"> <em>b</em>,           </td>
          </tr>
          <tr>
            <td></td>
            <td></td>
            <td class="md">        <tr>
            <td></td>
            <td></td>
            <td class="md">int          </td>
            <td class="mdname"> <em>c</em>          </td>
          </tr>
          <tr>
            <td></td>
            <td class="md">)&nbsp</td>
            <td class="md" colspan="2"> const  throw ( Exception1, Exception2, Exception3)          </td>
          </tr>

        </table>

One way to eliminate the extra spacing between the argument types and argument
names is to put the argument type and argument name pairs in a sub-table as
follows:

        <table cellpadding="0" cellspacing="0" border="0">
          <tr>
            <td class="md" nowrap valign="top">
  int MyClass::func1
            </td>
            <td class="md" valign="top">(&nbsp</td>
            <td>
              <table cellpadding="0" cellspacing="0" border="0">
                <td class="md">int          </td>
                <td class="mdname"> <em>a</em>,           </td>
              <tr>
                <td class="md">int          </td>
                <td class="mdname"> <em>b</em>,           </td>
              </tr>
              <tr>
                <td class="md">int          </td>
                <td class="mdname"> <em>c</em>          </td>
              </tr>
            </table>
          </td>
          <tr>
            <td></td>
            <td class="md">)&nbsp</td>
            <td class="md" colspan="2"> const  throw ( Exception1, Exception2, Exception3)          </td>
          </tr>

        </table>

BTW, I think that each argument other than the first has the following
unnecessary three lines of HTML:

              <td></td>
              <td></td>
              <td class="md">        <tr>

Geoff Alexander, Ph.D.
919/254-5216 T/L 444-5216
CMVC95 WebDAV Development
IBM Corporation
RTP, NC