unofficial mirror of bug-guile@gnu.org 
 help / color / mirror / Atom feed
* Documentation of reduce in guile manual
@ 2011-04-12 12:00 David Kastrup
  2011-04-14  8:00 ` Andy Wingo
  0 siblings, 1 reply; 6+ messages in thread
From: David Kastrup @ 2011-04-12 12:00 UTC (permalink / raw)
  To: bug-guile


In the guile manual (listed as
ii  guile-1.6-doc                              1.6.8-10build1                             Reference and tutorial documentation for Guile 1.6
on my system)

in node
(info "(guile) SRFI-1 Fold and Map")

I read

 -- Scheme Procedure: reduce f ridentity lst
     `reduce' is a variant of `reduce'.  If LST is `()', RIDENTITY is
     returned.  Otherwise, `(fold (car LST) (cdr LST))' is returned.

The first and the last sentence look pretty much nonsensical to me.

-- 
David Kastrup



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Documentation of reduce in guile manual
  2011-04-12 12:00 Documentation of reduce in guile manual David Kastrup
@ 2011-04-14  8:00 ` Andy Wingo
  2011-04-14  8:18   ` David Kastrup
  0 siblings, 1 reply; 6+ messages in thread
From: Andy Wingo @ 2011-04-14  8:00 UTC (permalink / raw)
  To: David Kastrup; +Cc: bug-guile

On Tue 12 Apr 2011 14:00, David Kastrup <dak@gnu.org> writes:

> In the guile manual (listed as
> ii  guile-1.6-doc

For words that aren't ten years old, try Guile 2.0, which fixes this
issue, among others.

Happy hacking,

Andy
-- 
http://wingolog.org/



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Documentation of reduce in guile manual
  2011-04-14  8:00 ` Andy Wingo
@ 2011-04-14  8:18   ` David Kastrup
  2011-04-14  8:37     ` Andy Wingo
  0 siblings, 1 reply; 6+ messages in thread
From: David Kastrup @ 2011-04-14  8:18 UTC (permalink / raw)
  To: Andy Wingo; +Cc: bug-guile

Andy Wingo <wingo@pobox.com> writes:

> On Tue 12 Apr 2011 14:00, David Kastrup <dak@gnu.org> writes:
>
>> In the guile manual (listed as
>> ii  guile-1.6-doc
>
> For words that aren't ten years old, try Guile 2.0, which fixes this
> issue, among others.

It is the version of guile with the API used in the very latest versions
of Debian and Ubuntu (to be released), so the "10 year old words" will
stick around for at least a year.

-- 
David Kastrup



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Documentation of reduce in guile manual
  2011-04-14  8:18   ` David Kastrup
@ 2011-04-14  8:37     ` Andy Wingo
  2011-04-14 10:23       ` David Kastrup
  0 siblings, 1 reply; 6+ messages in thread
From: Andy Wingo @ 2011-04-14  8:37 UTC (permalink / raw)
  To: David Kastrup; +Cc: bug-guile

On Thu 14 Apr 2011 10:18, David Kastrup <dak@gnu.org> writes:

> Andy Wingo <wingo@pobox.com> writes:
>
>> On Tue 12 Apr 2011 14:00, David Kastrup <dak@gnu.org> writes:
>>
>>> In the guile manual (listed as
>>> ii  guile-1.6-doc
>>
>> For words that aren't ten years old, try Guile 2.0, which fixes this
>> issue, among others.
>
> It is the version of guile with the API used in the very latest versions
> of Debian and Ubuntu (to be released), so the "10 year old words" will
> stick around for at least a year.

I believe they also package guile-1.8-doc, which are merely 5 year old
words.

Andy
-- 
http://wingolog.org/



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Documentation of reduce in guile manual
  2011-04-14  8:37     ` Andy Wingo
@ 2011-04-14 10:23       ` David Kastrup
  2011-04-14 14:26         ` Andy Wingo
  0 siblings, 1 reply; 6+ messages in thread
From: David Kastrup @ 2011-04-14 10:23 UTC (permalink / raw)
  To: Andy Wingo; +Cc: bug-guile

Andy Wingo <wingo@pobox.com> writes:

> On Thu 14 Apr 2011 10:18, David Kastrup <dak@gnu.org> writes:
>
>> Andy Wingo <wingo@pobox.com> writes:
>>
>>> On Tue 12 Apr 2011 14:00, David Kastrup <dak@gnu.org> writes:
>>>
>>>> In the guile manual (listed as
>>>> ii  guile-1.6-doc
>>>
>>> For words that aren't ten years old, try Guile 2.0, which fixes this
>>> issue, among others.
>>
>> It is the version of guile with the API used in the very latest versions
>> of Debian and Ubuntu (to be released), so the "10 year old words" will
>> stick around for at least a year.
>
> I believe they also package guile-1.8-doc, which are merely 5 year old
> words.

Well, that explains some.  It would appear that

a) docs are not installed by default, one has to install them manually
b) there is no metapackage guile-doc, so one has to specify versions
   explicitly
c) once one installs guile-1.6-doc, dpkg is happy to keep it around even
   when one upgrades guile to 1.8
d) deinstalling guile-1.6-doc after installing guile-1.8-doc*,
   one needs to look for the file "guile-1.8" as info.  guile.info no
   longer is there, even after running dpkg-reconfigure on the
   guile-1.8-doc* packages.
e) the documentation for reduce indeed is quite better.

-- 
David Kastrup



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: Documentation of reduce in guile manual
  2011-04-14 10:23       ` David Kastrup
@ 2011-04-14 14:26         ` Andy Wingo
  0 siblings, 0 replies; 6+ messages in thread
From: Andy Wingo @ 2011-04-14 14:26 UTC (permalink / raw)
  To: David Kastrup; +Cc: bug-guile

Hi David,

On Thu 14 Apr 2011 12:23, David Kastrup <dak@gnu.org> writes:

> a) docs are not installed by default, one has to install them manually
> b) there is no metapackage guile-doc, so one has to specify versions
>    explicitly
> c) once one installs guile-1.6-doc, dpkg is happy to keep it around even
>    when one upgrades guile to 1.8
> d) deinstalling guile-1.6-doc after installing guile-1.8-doc*,
>    one needs to look for the file "guile-1.8" as info.  guile.info no
>    longer is there, even after running dpkg-reconfigure on the
>    guile-1.8-doc* packages.
> e) the documentation for reduce indeed is quite better.

Thanks!  I believe credit goes to Kevin Ryde, who has moved on to other
things.

With regards to the Debian packages, I'm afraid this is the wrong forum
:-)  I hear that 2.0 packages are in the works, so your feedback might
be useful, over that way:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=615479

Regards,

Andy
-- 
http://wingolog.org/



^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2011-04-14 14:26 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-04-12 12:00 Documentation of reduce in guile manual David Kastrup
2011-04-14  8:00 ` Andy Wingo
2011-04-14  8:18   ` David Kastrup
2011-04-14  8:37     ` Andy Wingo
2011-04-14 10:23       ` David Kastrup
2011-04-14 14:26         ` Andy Wingo

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