www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - DDoc - odd output for param descriptions

If I have the following code:

/**
 Summary: The main function of the program.

 Synopsis: This is the entry point of the executable and where the program 
execution begins.
 Actually, there is another function called before this, but we won't
 talk about that one.

 Params:
  args = The list of arguments passed to the program on the command line or
    by the OS.  The first argument is always the name of the program.
*/

void main(char[][] args)
{

}

The params section in the generated code looks like:

Params:
char[][]args The list of arguments passed to the program on the command line 
or
char[][]args The list of arguments passed to the program on the command line 
or by the OS. The first argument is always the name of the program.


Scary.  I've tried messing with the indenting of the param description, 
using tabs vs. spaces, etc.  to no avail.  It only looks right if the param 
description is on one line.

Can't wait for the DDoc to use stylesheets for everything.  :) 
Sep 20 2005