GNU bug report logs - #72347
Mismatch between documentation and real implementation of list-index

Previous Next

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Marius <mariusgr <at> disroot.org>
To: bug-guile <at> gnu.org
Subject: Mismatch between documentation and real implementation of list-index
Date: Mon, 29 Jul 2024 00:34:14 +0000

[Message part 1 (text/plain, inline)]

Good evening,

I don't know if this is actually a Guile bug or a documentation bug, but I'm currently learning Guile from the "Guile reference manual" and I've found a mismatch between what the documentation says and what "my" guile does. I use Guile 3.0.9.

In my Guile instance (from what I can deduce), last-index is a procedure that returns the index of the first element of a list that matches with a s-expresion.

For example:

(list-index '(1 2 3) 3) -> 2
(list-index '(height width) 'width) -> 1

But the documentation says otherwise (<https://www.gnu.org/software/guile//manual/guile.html#SRFI_002d1-Filtering-and-Partitioning>):

list-index pred lst1 lst2 ...

Returns the index of the first set of elements, one from each of lst1 lst2 ..., which satisfies pred.


If I try to run list-index examples (from the documentation) I get an error because it doesn't know how to deal with a procedure as the first argument.


I'm missing something? I understand that list-index it's defined in SRFI-1 and maybe a Guile definition is shadowing the SRFI-1 definition. But where is the Guile documentation for this shadowing list-index? In the Guile Reference Manual list-index it's only described inside SRFI-1 module.



Thank you for your help.

Forgive me for any inconvenience,
Marius.

[Message part 2 (text/html, inline)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.