Re: and-map and or-map not documented in the manual

[Sebastian Tennant <sebyte@smolny.plus.com>]

Quoth ludo@gnu.org (Ludovic Courtès):
> Andy Wingo <wingo@pobox.com> writes:
>
>> So ideally instead of documenting them, if you're with me, we should
>> deprecate them, replacing them with their srfi-1 counterparts.
>
> I'm with you, but I think the status quo is safer, so that code from the
> late 90's can run forever with Guile (hmm, how convincing is that?).

How about deprecating them in the documentation only.

Dare I say that if it exists, it should be documented, (if only to
direct the user elsewhere).

Something like this maybe:

  -- Scheme Procedure: and-map pred lst1 lst2 ... lstN

  Please see <info-xref to 'every'>.

  Note: The reason for having two procedures that do the same thing is
        primarily historical. 'and-map' only exists in Guile whereas
        'every' can be found in most (if not all) Scheme
        implementations.  It will not be removed (for the sake of
        backwards compatiblity) but there's no reason to use it unless
        you want your code to be non-portable.

Seb