[PHP-DOC] Manual conventions From: jeroen <email protected>
Date: 08/13/01

Hi,

I agree with Hojtsy, that in XML we should express the _meaning_ of things.

It is then to the stylesheets etc etc to process it correctly.

Egon:
I don't understand you fully, since you prefer

<paramdef>void</paramdef>

in stead of

<void/>

i.e. a hack to get the rendering correct (to your opinion),

but at the same time, you prefer a correct XML with rand(), and don't want
Jani's patch, which was a hack to get the rendering correct.

Agreed, I'm ambigious too, since I prefer correct XML in the former case,
and a hack in the latter. But that's because the stylesheets are not
rendering it right in the correct XML-way. And because it is _really_ wrong
with rand([min, [max]]), and with void, it is a matter of taste (both can be
considered correct)

Greetz
Jeroen