From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.lisp.guile.devel Subject: doco primitive-property-ref Date: Mon, 21 Jul 2003 08:46:31 +1000 Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Message-ID: <87ispw95q0.fsf@zip.com.au> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: main.gmane.org 1058741348 4815 80.91.224.249 (20 Jul 2003 22:49:08 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sun, 20 Jul 2003 22:49:08 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Jul 21 00:49:07 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19eMzL-0001FQ-00 for ; Mon, 21 Jul 2003 00:49:07 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.20) id 19eMzD-0000e5-Rd for guile-devel@m.gmane.org; Sun, 20 Jul 2003 18:48:59 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19eMz4-0000YM-3e for guile-devel@gnu.org; Sun, 20 Jul 2003 18:48:50 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19eMyL-0008Qp-U7 for guile-devel@gnu.org; Sun, 20 Jul 2003 18:48:06 -0400 Original-Received: from snoopy.pacific.net.au ([61.8.0.36]) by monty-python.gnu.org with esmtp (Exim 4.20) id 19eMx8-0006qh-34 for guile-devel@gnu.org; Sun, 20 Jul 2003 18:46:50 -0400 Original-Received: from sunny.pacific.net.au (sunny.pacific.net.au [203.2.228.40]) by snoopy.pacific.net.au (8.12.3/8.12.3/Debian-6.4) with ESMTP id h6KMkfiI008596 for ; Mon, 21 Jul 2003 08:46:41 +1000 Original-Received: from wisma.pacific.net.au (wisma.pacific.net.au [210.23.129.72]) by sunny.pacific.net.au with ESMTP id h6KMkfQg013915 for ; Mon, 21 Jul 2003 08:46:41 +1000 (EST) Original-Received: from localhost (ppp61.dyn228.pacific.net.au [203.143.228.61]) by wisma.pacific.net.au (8.12.9/8.12.9) with ESMTP id h6KMkd8E007401 for ; Mon, 21 Jul 2003 08:46:39 +1000 (EST) Original-Received: from gg by localhost with local (Exim 3.35 #1 (Debian)) id 19eMwq-0000gj-00; Mon, 21 Jul 2003 08:46:32 +1000 Original-To: guile-devel@gnu.org Mail-Copies-To: never User-Agent: Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.2 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Developers list for Guile, the GNU extensibility library List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.devel:2637 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:2637 --=-=-= Following up on something I noticed a while ago, * scheme-utility.texi (Property Primitives): In primitive-property-ref, note parameters to not-found-proc, use hyphens rather than underscores for that parameter name. In primitive-property-set!, VAL is the value parameter not CODE. - Scheme Procedure: primitive-property-ref prop obj - C Function: scm_primitive_property_ref (prop, obj) Return the property PROP of OBJ. When no value has yet been associated with PROP and OBJ, the NOT-FOUND-PROC from PROP is used. A call `(NOT-FOUND-PROC PROP OBJ)' is made and the result set as the property value. If NOT-FOUND-PROC is `#f' then `#f' is the property value. - Scheme Procedure: primitive-property-set! prop obj val - C Function: scm_primitive_property_set_x (prop, obj, val) Set the property PROP of OBJ to VAL. --=-=-= Content-Disposition: attachment; filename=scheme-utility.texi.primitive-prop.diff --- scheme-utility.texi.~1.9.~ 2003-06-12 08:49:30.000000000 +1000 +++ scheme-utility.texi 2003-07-20 12:01:46.000000000 +1000 @@ -147,28 +147,28 @@ @node Property Primitives @subsection Low Level Property Implementation. -@deffn {Scheme Procedure} primitive-make-property not_found_proc +@deffn {Scheme Procedure} primitive-make-property not-found-proc @deffnx {C Function} scm_primitive_make_property (not_found_proc) Create a @dfn{property token} that can be used with @code{primitive-property-ref} and @code{primitive-property-set!}. See @code{primitive-property-ref} for the significance of -@var{not_found_proc}. +@var{not-found-proc}. @end deffn @deffn {Scheme Procedure} primitive-property-ref prop obj @deffnx {C Function} scm_primitive_property_ref (prop, obj) -Return the property @var{prop} of @var{obj}. When no value -has yet been associated with @var{prop} and @var{obj}, call -@var{not-found-proc} instead (see @code{primitive-make-property}) -and use its return value. That value is also associated with -@var{obj} via @code{primitive-property-set!}. When -@var{not-found-proc} is @code{#f}, use @code{#f} as the -default value of @var{prop}. +Return the property @var{prop} of @var{obj}. + +When no value has yet been associated with @var{prop} and @var{obj}, +the @var{not-found-proc} from @var{prop} is used. A call +@code{(@var{not-found-proc} @var{prop} @var{obj})} is made and the +result set as the property value. If @var{not-found-proc} is +@code{#f} then @code{#f} is the property value. @end deffn @deffn {Scheme Procedure} primitive-property-set! prop obj val @deffnx {C Function} scm_primitive_property_set_x (prop, obj, val) -Associate @var{code} with @var{prop} and @var{obj}. +Set the property @var{prop} of @var{obj} to @var{val}. @end deffn @deffn {Scheme Procedure} primitive-property-del! prop obj --=-=-= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://mail.gnu.org/mailman/listinfo/guile-devel --=-=-=--