Community
Participate
Working Groups
For example the type description with any short or long description like this: --- -- @type typename The generated html will be: <h2>Type <code>typename</code></h2> <p> </p> <p> </p> The first <p> usually contains the short description and the second one the long description, but in this case, there are no descriptions at all. The empty <p> tags are useless and can add blank space in the browser (depend of the browser). Theses p tags may be removed when empty. It the same way, when a function is declared without any description the html generated is : <h3>Field(s)</h3> <dl class="function"> <dt> <a id="#(modulename).functionname" > <strong>modulename.functionname()</strong> </a> </dt> <dd> <br /> </dd> </dl> Where the <br/> tag is useless and can be removed.
An useless <br/> tag can be seen when a module doesn't have a long description. Useless <p> tags can be also seen when a function have more than one @return without type and description.
fixed in HEAD : a14d5303edc63353373af1e9c30538641f811232