documentation on putp/getp

? ^Aputp

------------------------------------------------------------------------
(putp <anything> <name> <value>)              [DE](sysenv.lsh)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Every Lush object (atoms, cons, etc.) may be enriched by defining
properties identified by a symbolic name. Function putp is used to
define such properties. Its first argument is an arbitrary Lush object
anything . Function putp sets the property named by symbol name to value
value . Properties can be later retrieved using getp .


Something like this should be added to the documentation:

NOTE: Do not apply putp to temporary objects! putp increases
an object's reference counter, which will prevent a temporary
object ever to be garbage collected.


Ralf




-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click