--- Begin Message ---
Subject: |
A bug in guile's newest documentation. |
Date: |
Fri, 8 Mar 2013 16:39:41 +0800 |
6.9.8 Procedures with Setters
A procedure with setter is a special kind of procedure which normally
behaves like any
accessor procedure, that is a procedure which accesses a data
structure. The difference is
that this kind of procedure has a so-called setter attached, which is
a procedure for storing
something into a data structure.
Procedures with setters are treated specially when the procedure
appears in the special
form set! (REFFIXME). How it works is best shown by example.
Suppose we have a procedure called foo-ref, which accepts two
arguments, a value of
type foo and an integer. The procedure returns the value stored at the
given index in the
foo object. Let f be a variable containing such a foo data structure.
Mind the 'REFFIXME'.
Thank you for your time and GREAT JOB.
Best,
Patrick.
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#13904: A bug in guile's newest documentation. |
Date: |
Sat, 09 Mar 2013 12:24:40 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.2 (gnu/linux) |
On Sat 09 Mar 2013 01:52, Daniel Hartwig <address@hidden> writes:
>> Mind the 'REFFIXME'.
>
> Is that the issue you are reporting?
>
> Marks such as this (e.g. ‘FIXME’, ‘TODO’) appear in many places as a
> reminder to fix or work on something in the future. I suppose in this
> case it is to cross-reference with the definition of ‘set!’, which
> appears absent except for a brief note under _rnrs base_, and informal
> definition in _Hello Scheme!_
>
> Generally, I don't think we also need bug reports to track this.
Yeah I agree -- I just took a look at this and it seems that someone
just needs to write the docs. It's a bit ugly to look at in the
documentation but on the other hand maybe we can see it as just a sign
that the document is an ongoing human production, and that more help is
appreciated :)
Andy
--
http://wingolog.org/
--- End Message ---