Manual conventions
| From: | jeroen@php.net | Date: | Mon, 13 Aug 2001 11:02:12 +0000 |
| Subject: | Manual conventions | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969337062@lists.php.net to get a copy of this message | ||
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