OO docs 4 - last
| From: | Andr� L F S Bacci | Date: | Sat, 03 Jan 2004 19:55:26 +0000 |
| Subject: | OO docs 4 - last | ||
| References: | 1 2 3 4 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969357896@lists.php.net to get a copy of this message | ||
Gabor Hojtsy wrote:
>> Which the great problem with OO after all? Render, search, filenames?
>> http://www.docbook.org/tdg/en/html/classsynopsis.html
>
> Rendering, what to put into a file, crosslinks, relating OO docs to
> functional docs, etc...
>
> Goba
As all have read, I am proposing great modifications in the structure of the
documentation to contain the OO things.
Beyond those that already I spoke, it was lacking one, that I only perceived
now.
André Æ wrote:
> The important thing here is that now the methodsynopsis
> appear inside of an classsynopsys! (but between then
> appear refentry and others ref* tags).
This obviously isn't valid inside DocBook.
Then, to make my idea work, it would have another BIG change.
Remove <ref*> from individual function files AND change the ID of refentry
to methodsynopsis, at least, of that exclusive documentation of the OO
methods, constructors and propertys.
So, as says Goba and ~we can play with context~, its possible to render
global functions (refsect1/methodsynopsis) differently from object methods
(classsynopsis/methodsynopsis).
I go stopping for here.
Happy new year for all!
[]s
André Æ