unofficial mirror of guile-devel@gnu.org 
 help / color / mirror / Atom feed
From: Kevin Ryde <user42@zip.com.au>
Subject: doco primitive-property-ref
Date: Mon, 21 Jul 2003 08:46:31 +1000	[thread overview]
Message-ID: <87ispw95q0.fsf@zip.com.au> (raw)

[-- Attachment #1: Type: text/plain, Size: 888 bytes --]

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.



[-- Attachment #2: scheme-utility.texi.primitive-prop.diff --]
[-- Type: text/plain, Size: 1862 bytes --]

--- 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

[-- Attachment #3: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel

             reply	other threads:[~2003-07-20 22:46 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2003-07-20 22:46 Kevin Ryde [this message]
2003-07-28 23:29 ` doco primitive-property-ref Kevin Ryde

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/guile/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87ispw95q0.fsf@zip.com.au \
    --to=user42@zip.com.au \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).