bug#13904: A bug in guile's newest documentation.

bug#13904: A bug in guile's newest documentation.

[Patrick Pan]

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.

bug#13904: A bug in guile's newest documentation.

[Daniel Hartwig]

Hello

On 8 March 2013 16:39, Patrick Pan <pyxchina92929@gmail.com> wrote:
> 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'.

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.

bug#13904: A bug in guile's newest documentation.

[Andy Wingo]

On Sat 09 Mar 2013 01:52, Daniel Hartwig <mandyke@gmail.com> 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/

bug#13904: A bug in guile's newest documentation.

[Patrick Pan]

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

Yeah. That’s cool. I am a newbie to Scheme. Guile is great. Good job every
one ! Happy hacking.
On Mar 9, 2013 7:24 PM, "Andy Wingo" <wingo@pobox.com> wrote:

> On Sat 09 Mar 2013 01:52, Daniel Hartwig <mandyke@gmail.com> 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/
>

[-- Attachment #2: Type: text/html, Size: 1501 bytes --]