From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andy Wingo Newsgroups: gmane.lisp.guile.bugs Subject: Re: and-map and or-map not documented in the manual Date: Wed, 08 Oct 2008 21:16:07 +0200 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1223496441 17720 80.91.229.12 (8 Oct 2008 20:07:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 8 Oct 2008 20:07:21 +0000 (UTC) Cc: bug-guile@gnu.org To: Gregory Marton Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Wed Oct 08 22:08:18 2008 Return-path: Envelope-to: guile-bugs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1KnfKS-0003gR-EQ for guile-bugs@m.gmane.org; Wed, 08 Oct 2008 22:08:16 +0200 Original-Received: from localhost ([127.0.0.1]:34809 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KnfJO-0002IR-Lz for guile-bugs@m.gmane.org; Wed, 08 Oct 2008 16:07:10 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KnfJK-0002Hu-50 for bug-guile@gnu.org; Wed, 08 Oct 2008 16:07:06 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KnfJH-0002H2-G4 for bug-guile@gnu.org; Wed, 08 Oct 2008 16:07:05 -0400 Original-Received: from [199.232.76.173] (port=36606 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KnfJH-0002Gz-9l for bug-guile@gnu.org; Wed, 08 Oct 2008 16:07:03 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]:63085) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KnfJH-0005Jm-6O for bug-guile@gnu.org; Wed, 08 Oct 2008 16:07:03 -0400 Original-Received: from a-sasl-fastnet.sasl.smtp.pobox.com ([207.106.133.19] helo=sasl.smtp.pobox.com) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Knec0-00087I-B9 for bug-guile@gnu.org; Wed, 08 Oct 2008 15:22:20 -0400 Original-Received: from localhost.localdomain (localhost [127.0.0.1]) by a-sasl-fastnet.sasl.smtp.pobox.com (Postfix) with ESMTP id 9B7D96BB18; Wed, 8 Oct 2008 15:16:36 -0400 (EDT) Original-Received: from unquote (54.Red-81-38-190.dynamicIP.rima-tde.net [81.38.190.54]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-sasl-fastnet.sasl.smtp.pobox.com (Postfix) with ESMTPSA id AA4B56BB12; Wed, 8 Oct 2008 15:16:34 -0400 (EDT) In-Reply-To: (Gregory Marton's message of "Wed, 8 Oct 2008 12:19:27 -0400 (EDT)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) X-Pobox-Relay-ID: A0696E00-956D-11DD-9CB5-9364E785EAEE-02397024!a-sasl-fastnet.pobox.com X-detected-kernel: by mx20.gnu.org: Solaris 10 (beta) X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. X-BeenThere: bug-guile@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.bugs:4038 Archived-At: Hey Gregory, On Wed 08 Oct 2008 18:19, Gregory Marton writes: > Hi Folks, > > A colleague just noticed that and-map and or-map, defined in boot-9.scm > with some helpful comments above them, are not actually documented in > the Guile Manual. How might I go about adding them? Good question. The thing is, they are the same as SRFI-1's `every' and `any', which have a longer heritage; Common Lisp appears to call `any' `some'. I think the SRFI names are clearer[1], so you should use them. We have a problem that we provide less general implementations[2] under strange names[3]. So ideally instead of documenting them, if you're with me, we should deprecate them, replacing them with their srfi-1 counterparts. What do you think? Andy 1. `and-map' implies that you can map syntax, which you cannot. 2. `and-map' doesn't handle multiple lists as `map' and `every' do. 3. I think only Chicken has and-map, and calls it `andmap'. -- http://wingolog.org/