Re: New skeletons
| From: | Hannes Magnusson | Date: | Sun, 28 Oct 2007 12:52:04 +0000 |
| Subject: | Re: New skeletons | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969378251@lists.php.net to get a copy of this message | ||
On 10/27/07, Hannes Magnusson <hannes.magnusson@gmail.com> wrote:
> The new manual.xml.in can be found in CVS (the REF_STRUCT_DEV branch)
> and the new (normal extension) skeleton on
> http://doc.php.net/wiki/skeletons.
Class reference skeleton: http://doc.php.net/wiki/skeletons/oo
The reason for the xincludes there is to build a readable overview of
the methods and its properties.
Since the property usage in various extensions is very inconsistent
its impossibly to create one-skeleton-fits-all.
If the property has an equal function counterpart the property should
be documented above the function synopsis.
Class constants use the same markup as properties, with the exception
of added "<modifier>const</modifier>" in the fieldsynopsis
Basic "class usage examples" should use the "extension example
chapter" (xml:id=extname.examples).
Questions? Comments? Dislikes? Love? :)
-Hannes