From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.lisp.guile.devel Subject: Re: rfc: (ice-9 accumulate) Date: Mon, 11 Jan 2010 15:34:58 +0100 Message-ID: <876378iub1.fsf@ambire.localdomain> References: <873a2fo8wc.fsf@ambire.localdomain> <874omt79gs.fsf@gnu.org> <87aawl9okb.fsf@ambire.localdomain> <87fx6cdb6x.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1263220810 9499 80.91.229.12 (11 Jan 2010 14:40:10 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 11 Jan 2010 14:40:10 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Jan 11 15:40:03 2010 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1NULQy-00006F-F1 for guile-devel@m.gmane.org; Mon, 11 Jan 2010 15:39:56 +0100 Original-Received: from localhost ([127.0.0.1]:50867 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NULQz-0002kD-47 for guile-devel@m.gmane.org; Mon, 11 Jan 2010 09:39:57 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NULQ7-0002fd-6z for guile-devel@gnu.org; Mon, 11 Jan 2010 09:39:03 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NULQ4-0002e2-7v for guile-devel@gnu.org; Mon, 11 Jan 2010 09:39:02 -0500 Original-Received: from [199.232.76.173] (port=43087 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NULQ4-0002dv-3v for guile-devel@gnu.org; Mon, 11 Jan 2010 09:39:00 -0500 Original-Received: from smtp-out13.alice.it ([85.33.2.18]:1266) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NULQ3-0006RM-LJ for guile-devel@gnu.org; Mon, 11 Jan 2010 09:38:59 -0500 Original-Received: from FBCMMO02.fbc.local ([192.168.68.196]) by smtp-out13.alice.it with Microsoft SMTPSVC(6.0.3790.3959); Mon, 11 Jan 2010 15:37:29 +0100 Original-Received: from FBCMCL01B09.fbc.local ([192.168.171.26]) by FBCMMO02.fbc.local with Microsoft SMTPSVC(6.0.3790.3959); Mon, 11 Jan 2010 15:37:25 +0100 Original-Received: from ambire.localdomain ([79.24.50.106]) by FBCMCL01B09.fbc.local with Microsoft SMTPSVC(6.0.3790.3959); Mon, 11 Jan 2010 15:37:24 +0100 Original-Received: from ttn by ambire.localdomain with local (Exim 4.63) (envelope-from ) id 1NULMA-0005yh-8H for guile-devel@gnu.org; Mon, 11 Jan 2010 15:34:58 +0100 In-Reply-To: <87fx6cdb6x.fsf@gnu.org> ("Ludovic =?utf-8?Q?Court=C3=A8s=22'?= =?utf-8?Q?s?= message of "Mon, 11 Jan 2010 14:26:46 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.91 (gnu/linux) X-OriginalArrivalTime: 11 Jan 2010 14:37:25.0091 (UTC) FILETIME=[977AE330:01CA92CB] X-detected-operating-system: by monty-python.gnu.org: Windows 2000 SP4, XP SP1+ X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:9857 Archived-At: () ludo@gnu.org (Ludovic Court=C3=A8s) () Mon, 11 Jan 2010 14:26:46 +0100 Would be nice, though I think it should be decided on a per-module basis. There are some modules that it may be worth deprecating and leaving undocumented, perhaps. Certainly each module will have it's own doc patch. However, i strongly discourage leaving things undocumented. For some, undocumented might mean "don't use". For others (who peruse source code), it might mean "implementation so stable, it's self-documenting". Better to be explicit: If you want to deprecate something, the documentation is ALSO a good place to make that clear. Another benefit to documenting stuff that you want to deprecate is that the sifting process may reveal bits or techniques you want to keep. > Besides, the first idiom at [0] is about as concise as the one > that uses this API; in addition, it is likely to be more widely > understood than the latter. This makes this API unappealing to > me. > > I'm sorry, i don't follow. What are you referring to as "the latter"? The =E2=80=98accumulate=E2=80=99 API doesn=E2=80=99t lead to more concis= e code, but it leads to =E2=80=9Cnon-standard=E2=80=9D code, which makes it unappealing to me. I can understand this point somewhat (what is unfamiliar often seems non-standard). However, i still fail to understand your sentence above; do you mean "the latter" =3D=3D "(ice-9 accumulate)"? In any case, the API does indeed lead to more concise code, if the original code that it replaces is `cons' plus `reverse!'. But that's neither here nor there... > Hmmm, would it be possible to install (ice-9 accumulate) as is, w/o > changes, somewhere under ${prefix}/share/guile (perhaps a site/ dir)? > Would Guile be able to locate and load it? Setting $GUILE_LOAD_PATH and $GUILE_LOAD_COMPILED_PATH appropriately should be enough. OK, i'll give moving the module to ttn-do a try. thi