Re: dom docs first attempt
| From: | Rob Richards | Date: | Fri, 07 May 2004 19:38:01 +0000 |
| Subject: | Re: dom docs first attempt | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969360547@lists.php.net to get a copy of this message | ||
On Friday 07 May 2004 07:29 pm, Nuno Lopes wrote:
> Firstly, you are using tabs for indentation and we don't use them.
So I take it this should be spaces (any particular number or does it really
matter?
> You shouldn't use <link> here. Just use
> <function>DOMDocument->createElement</function>. The linking of functions
> is done automatically (this was bogus in livedocs for OO funcs, like these,
> but I had commited a patch that solved this issue).
>
> You have append "dom-" to the refentry ids. This brokes livedocs, but don't
> worry! I've already a patch to definetly fix all this issues.
The reason why I went with link is due to having to append the "dom-" to the
ids. I had origionally used <function></function>, but the it wouldnt map to
the ids. And I was a bit worried about the livedocs, but there is no other
way due to the domxml functions. So how should the links actually be done?
> For properties, just check the MySQLi extension to see how George has
> documented properties.
Thanks was trying to find an extension that had documented properties.
> Oh, when you have some time, it would be great if you add an example for
> each function.
No problem. Just wanted to get the docs going on this, so haven't spent too
much time on the actual content yet.
Thanks,
Rob