-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi.
- --On 22.05.2002 18:17:04 +0400 Victor Kapustin wrote: >> Yes. How do you imagine the addition? > > Let me propose a draft text to be added to descriptions of ANY > ..._list_... [and, maybe ..._get_...] functions (with some comments > in brackets). > > == START DRAFT == > The object returned by the ..._list_... function is "truncated" (due > to obvious performance issues) and has only five properties [members? > terminology must be consistent with the body of the Manual; I prefer > "members" against "properties" not to mess with Midgard objects' > properties]: Five "members" would be right, from an OOP point of view. I'd prefer this name throughout the documentation. Also I'd name it "only five guranteed properties" since there are a couple of "hacks" for several Midgard objects where the fetch call returns more than the mentioned members (shouldn't be so though). Philipp, please mention explicitly that all other members that are there eventually will soon be marked as deprecated and should no longer be used. I will not remove them from the code of the 1.4 strain, but the 1.6 might very well no longer include this functions by default. > N > __res__ > __table__ > id > sitegroup > > Both "N" and "__res__" are specific only to this truncated form of > Midgard objects and are used internally <by fetch() method>. The > normal (<full?>) version of the object *must* be obtained with the > appropriate ..._get_... function. Those ..._get_... functions return > a fully fledged object without "N" and "__res__", but with all > properties described in the appropriate Manual chapter explaining the > object. Also add, that the __*__ Members are private per definition. No application should _ever_ modify or even access them. Live long and prosper! Torben Nehmer - -- Torben Nehmer, Munich, Germany http://www.nathan-syntronics.de, mailto:[EMAIL PROTECTED] PGP Public Key ID on wwwkeys.(de.)pgp.net: 0x7E9DE456 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (GNU/Linux) iD8DBQE867zwJPh4Kn6d5FYRAjmPAJ9EG1FwN/JiPALFjFlC1znVgsNj6ACfYV7l yPu/sgEzuCW+042x2s7Gabk= =PHSJ -----END PGP SIGNATURE----- --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
