typo/bug in guile-bf08e10/doc/ref/api-control.texi

typo/bug in guile-bf08e10/doc/ref/api-control.texi

[ebuy]

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

Hi,

maybe I'm wrong, but I consider the order  "(PROC CONT)" in the
documentation of the procedure 

"call-with-current-continuation" 

in file guile-bf08e10/doc/ref/api-control.texi of the git-repository   a
bug

Shouldn't that be transposed? "(CONT PROC)" ?

I originally found this studying the documentation of my current 1.8.7
release of guile and wondered, if its still present in the development
branch. 

Bye - 
Some Admiring Guile-User and Enlgisch Non-Native speaker:)



[-- Attachment #2: diff-c.txt --]
[-- Type: text/plain, Size: 975 bytes --]

*** api-control.texi.new	2010-09-03 23:09:44.671311883 +0200
--- guile-bf08e10/doc/ref/api-control.texi	2010-09-03 16:23:02.000000000 +0200
***************
*** 488,495 ****
  @deffn {Scheme Procedure} call-with-current-continuation proc
  @deffnx {Scheme Procedure} call/cc proc
  @rnindex call-with-current-continuation
! Capture the current continuation and call @code{(@var{cont} @var{proc})} 
! with it.  The return value is the value returned by
  @var{proc}, or when @code{(@var{cont} @var{value})} is later invoked,
  the return is the @var{value} passed.
  
--- 488,495 ----
  @deffn {Scheme Procedure} call-with-current-continuation proc
  @deffnx {Scheme Procedure} call/cc proc
  @rnindex call-with-current-continuation
! Capture the current continuation and call @code{(@var{proc}
! @var{cont})} with it.  The return value is the value returned by
  @var{proc}, or when @code{(@var{cont} @var{value})} is later invoked,
  the return is the @var{value} passed.
  

Re: typo/bug in guile-bf08e10/doc/ref/api-control.texi

[Andy Wingo]

Hi,

On Fri 03 Sep 2010 14:47, ebuy <rtfds@online.de> writes:

> consider the order "(PROC CONT)" in the documentation of the procedure
>
> "call-with-current-continuation" 
>
> Shouldn't that be transposed? "(CONT PROC)" ?

Nope! The point is to reify the continuation as a *value*; thus it is
passed as a value to the procedure.

  (call/cc foo) = (foo CONT)

Have fun with Guile,

Andy
-- 
http://wingolog.org/