Hi,
While working with index I noticed that we have two different rules for describing objects and their methods - one with the "->" construction and one with "::". For example look at ArrayObject and DOMDocument. For me ArrayObject with :: is more appropriate. What do you think? Another issue, that ArrayObject has mixed-case id's. While it is clear that all id's for functions are lowercase should be lowercase as it stated in HOWTO that is not true for class methods and it should be mentioned too.
There is no consensus here. Some extension are using the class->method() form and other are using class::method() form.
PEAR uses the last form.
Wo, the whole fun is that there are pairs of similar methods in
DOM and DOM XML which are differ only by case. For example
int DOMDocument->xinclude ( ) with id function.dom-domdocument-xinclude.html
int DomDocument->xinclude ( ) with id function.domdocument-xinclude.html
(probably a well-known issue, but anyways)
Thats a know issue, yes. One extension is for PHP 4 and the other is for PHP 5.
Which id should be generated from a <function>domdocument->xinclude</function>
block?
Thats a good question :) Livedocs is still waiting for an answer for this, too.
We can only decide with sure when the link comes from the same extension (DOM XML will only link to DOM XML).
Otherwise... we can link to the newer extension :)
Since ArrayObject id's are case-sensitive you will have to reference them in a proper case from <function> block to correctly transform <function> text to id. So perhaps all id's for methods should be in mixed case and DOM reference need to be updated?
Another good question :) There are several OO function which are currently using mixed case.
I can't really thing in a good reason why they should be lowercased or not... I would keep as-is.
Also there is no way to reference just a class.
A simple link/xref?
Nuno
