Am I missing something or the lists of class properties are non-existent in API docs? This is pretty annoying difference comparing to what we had on Qcodo site before...
Yes, attributes. Let me give an example: QDateTime_Object->Timestamp
As far as I remember Qcodo API menu used to have three sub-levels: methods, attributes (properties? - not sure about the name) and probably a separate list of private variables (attributes?) within class. I spent several minutes trying to find "timestamp" property today within QCubed docs and without success. I started using QCubed docs today since Qcodo's API site is down but it looks like properties' lists are shorter (not complete?) than they were in Qcodo's version.
The QCubed docs are a work in progress. There will be some new ones coming out shortly, in a new layout and with more information.
However, the method used to create QCodo docs is entirely different than what is being used for QCubed, in creation and display. The next version of QCubed docs will be created with phpDocumentor as the docblocks used by that program are pretty standard across the board for PHP projects.
The problem though is that the properties you are talking about are "Magic" properties. That is they are called through _get and _set. phpDocumentor requires that these properties be declared in a docblock in order for them to be used. fcool has started doing some work to that end. But there are MANY more to go. And I am still working on the best way to present them in the new docs.
The qcodo docs are nice in the way you speak of, but they are very lacking in descriptive information. They are very much just a skeleton of names and types; this is something we wish to rectify with better descriptions and examples. But it takes time to do so.
I apologize for the difference and ask you to bear with us as we build the API docs. I think you will find the end result is much better.
Note that any time you see a missing property like this, please create a ticket, and, if you're so inclined, provide some text you'd like to see in the manual, or even a patch to supply the missing docblock.
Do you mean attributes? If so they are present.
Yes, attributes. Let me give an example: QDateTime_Object->Timestamp
As far as I remember Qcodo API menu used to have three sub-levels: methods, attributes (properties? - not sure about the name) and probably a separate list of private variables (attributes?) within class. I spent several minutes trying to find "timestamp" property today within QCubed docs and without success. I started using QCubed docs today since Qcodo's API site is down but it looks like properties' lists are shorter (not complete?) than they were in Qcodo's version.
The QCubed docs are a work in progress. There will be some new ones coming out shortly, in a new layout and with more information.
However, the method used to create QCodo docs is entirely different than what is being used for QCubed, in creation and display. The next version of QCubed docs will be created with phpDocumentor as the docblocks used by that program are pretty standard across the board for PHP projects.
The problem though is that the properties you are talking about are "Magic" properties. That is they are called through _get and _set. phpDocumentor requires that these properties be declared in a docblock in order for them to be used. fcool has started doing some work to that end. But there are MANY more to go. And I am still working on the best way to present them in the new docs.
The qcodo docs are nice in the way you speak of, but they are very lacking in descriptive information. They are very much just a skeleton of names and types; this is something we wish to rectify with better descriptions and examples. But it takes time to do so.
I apologize for the difference and ask you to bear with us as we build the API docs. I think you will find the end result is much better.
Note that any time you see a missing property like this, please create a ticket, and, if you're so inclined, provide some text you'd like to see in the manual, or even a patch to supply the missing docblock.