[PHP-DOC] Representing classes in PHP doc

[Damien Seguy]

Hi all,

I'm working on the future Ming extension's documentation, and I
encountered troubles for structuring information.

Ming provide functionnalities through objects. In dir.xml,
all method of dir class are also functions, and thus, they
get a id="function.chroot" in refentry.

It won't be that easy for Ming, as I already noticed that
some methods have the same name in two differents classes.
getWidth() is used in both SWFFont et SWFBitmap.

I would like to use id="function.swffont.getwidth"
and id="function.swfbitmap.getwidth" as method's name.
This would be quite readable, and may prevent name spaces
from interfering (some class may have an already defined
function as method).

Is there any trouble with that? I'm afraid this will confuse
the <function> tag, unless docbook is flexible enough to
convert <function>SWFFont->getwidth</function> to
id="function.swffont.getwidth", which would be great!

Egon? Jim? Jouni? Anyone with higher experience in PHP Doc and/or
docbook might correct me, please.

Best regards,
Damien Seguy
====================================
http://www.nexen.net/
l'hebergement dynamique !
Docs PHP/MySQL en Francais, scripts
====================================