guile-srfi-123

commit e48caa3987a0f5d7ce04b1853eae485ff01ea406
parent 5ba2d3128983b980c0ed681abbd39db78e700900
Author: Taylan Ulrich Bayırlı/Kammer <taylanbayirli@gmail.com>
Date:   Tue, 18 Aug 2015 18:10:28 +0200

Clarify that the setter of ref is under-powered.

Diffstat:
M
srfi-123.html
 | 
2
+-
M
srfi-123.md
 | 
3
++-

2 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/srfi-123.html b/srfi-123.html
@@ -89,7 +89,7 @@ struct  ;=&gt; #(a (x y #u8(4 2 3)) c)</code></pre>
                            ;does something else.</code></pre>
 <p>Valid types for <code>object</code> are: bytevectors, hashtables, pairs, strings, vectors, non-opaque record types, and SRFI-4 vectors if present. Only hashtables are a sparse type. Implementations are encouraged to expand this list of types with any further types they support.</p>
 <p>Valid types for <code>field</code> depend on the type of <code>object</code>. For bytevectors, hashtables, strings, vectors, and SRFI-4 vectors, refer to their respective <code>*-ref</code> procedures. For pairs, refer to <code>list-ref</code>. For records, symbols that correspond with the record type's field names are allowed.</p>
-<p>The <code>ref</code> procedure has an associated SRFI-17 setter.</p>
+<p>The <code>ref</code> procedure has an associated SRFI-17 setter, although the one of <code>ref*</code> is strictly more powerful.</p>
 <pre><code>(define vec (vector 0 1 2))
 (set! (ref vec 0) 3)
 vec  ;=&gt; #(3 1 2)</code></pre>
diff --git a/srfi-123.md b/srfi-123.md
@@ -199,7 +199,8 @@ to their respective `*-ref` procedures.  For pairs, refer to
 `list-ref`.  For records, symbols that correspond with the record
 type's field names are allowed.
 
-The `ref` procedure has an associated SRFI-17 setter.
+The `ref` procedure has an associated SRFI-17 setter, although the one
+of `ref*` is strictly more powerful.
 
     (define vec (vector 0 1 2))
     (set! (ref vec 0) 3)