Re: ref.dom

From: Date: Fri, 02 Jan 2004 13:21:34 +0000
Subject: Re: ref.dom
References: 1 2 3 4  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969365759@lists.php.net to get a copy of this message
Aidan Lister wrote:
Hi list, I think a new exceptions refsect1 is a better idea. The PEAR docs do this: see http://pear.php.net/manual/en/package.database.db.db-common.commit.php
Yep, this is definitely needed. I think we can use something like : (Nuno, the code is documented within the constants section, maybe it's better to hide it si that people use constants instead)
OK, if there are constants.
Also, I think we need another section for misc information. When documenting mysql_query in the new format, I really needed a place just to dump the rest of the information (I put the extra information in the Return section). Perhaps we can make a "Note" section (as in pear). see http://livedocs.homelinux.com/en/function.mysql-query.html
I don't know, for dom, I distributed the notes and warning where appropriated (parameters, description, returnvalues), it's more consistent IMHO. didou
Agreed. Nuno

« previous php.doc (#969365759) next »