Re: Re: <void> rendering, multi-proto's

On Mon, Aug 13, 2001 at 12:34:33AM +0200, Jeroen van Wolffelaar wrote: > > <void/> is wrong. > > Why? See the docbook documentation: > > Void -- An empty element in a function synopsis indicating that the > function in question takes no arguments I know the DocBook probably better then you. > > > (void) to indicate no-args is really ugly, IMO, and wrong too. void as > > > return-value is okay, but to indicate no-args?? it is common to have a > list > > > of arguments, there are no arguments -> empty list. > > > > No, it means there is no argument type or return value. > > "_it_ means", to what are you referring? I don't get this. To nothing. > If you mean (void), I disagree, as I argumented in that paragraph. > > > > Anyway, _IF_ (void) would be the correct rendering, change the > > > html-common.dsl to output " (void)" in stead of " ()". > > > That's the > > > appropriate way, this <parameter>void</parameter> thing is an ugly hack > > > (IMHO uglier than Jani's/Tom's rand() hack). > > > > Examples? I will look for it tomorrow. > > > > > > > > > > > + 14. In a prototype, if there are multiple - really distinct - > > > > > + possibilities, simply make it two! See math.xml:min() for an > > > example. > > > > > > > > mixed? > > > > > > See min() for example, mixed is not appropriate there. min()s is correct, exept the missing brackets for the optional arguments. > > Simply make it two is IMHO nonsense. But we can agree if there is a "!" > > separator between the arguments, with no spaces between the separator. > > This rates quite high on the WTF-scale... Have you seen how it is rendered > anyway? There are two possible syntaxes for that min() function, and they > should both be named. It isn't for nothing that there are multiple > prototypes allowed in XML, within one funcsynopsis. Again, see the > docbook-docs. I render or validate the PHP docs daily. So I don't see your problem. Multiple prototypes are posible with Hartmut's patch. -Egon -- All known books about PHP and related books: http://php.net/books.php Concert Band of the University of Hohenheim: http://www.concert-band.de/ First and second bestselling book in German: http://www.php-buch.de/