From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: first last Newsgroups: gmane.lisp.guile.bugs Subject: minor proposed changed to guile doc Date: Wed, 1 Sep 2004 08:49:37 -0700 (PDT) Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Message-ID: <20040901154937.84224.qmail@web10904.mail.yahoo.com> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1094053972 26010 80.91.224.253 (1 Sep 2004 15:52:52 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 1 Sep 2004 15:52:52 +0000 (UTC) Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Wed Sep 01 17:52:27 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1C2XPO-0001km-00 for ; Wed, 01 Sep 2004 17:52:26 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1C2XUJ-0006x8-Gc for guile-bugs@m.gmane.org; Wed, 01 Sep 2004 11:57:31 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1C2XS3-0004Xw-Oh for bug-guile@gnu.org; Wed, 01 Sep 2004 11:55:11 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1C2XS0-0004Wn-Ok for bug-guile@gnu.org; Wed, 01 Sep 2004 11:55:10 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1C2XS0-0004WQ-92 for bug-guile@gnu.org; Wed, 01 Sep 2004 11:55:08 -0400 Original-Received: from [216.136.131.40] (helo=web10904.mail.yahoo.com) by monty-python.gnu.org with smtp (Exim 4.34) id 1C2XMh-0007Kg-91 for bug-guile@gnu.org; Wed, 01 Sep 2004 11:49:39 -0400 Original-Received: from [207.2.57.7] by web10904.mail.yahoo.com via HTTP; Wed, 01 Sep 2004 08:49:37 PDT Original-To: bug-guile@gnu.org 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: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.bugs:1638 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.bugs:1638 I propose that the following section replace the current documentation for the DO function. It essentially replaces "test" with "terminate" and "expr" with "result". The motiviation is to make it more obvious that the loop ends on a true value for the test. (as opposed to "continue on true"). If I should make the change to a CVS working version directly, please let me know (directly to me as I don't check this list regularly). Otherwise I will assume/hope someone else makes the change if its acceptable. -sp- ------------ - syntax: do ((variable1 init1 step1) ...) (terminate result1 ...) command ... The INIT expressions are evaluated and the VARIABLES are bound to their values. Then looping starts with testing the TERMINATE expression. If TERMINATE evaluates to a true value, the RESULT following the TERMINATE are evaluated and the value of the last RESULT is returned as the value of the `do' expression. If TERMINATE evaluates to false, the COMMANDs are evaluated in order, the STEPs are evaluated and stored into the VARIABLES and the next iteration starts. Any of the STEP expressions may be omitted, so that the corresponding variable is not changed during looping. _______________________________ Do you Yahoo!? Win 1 of 4,000 free domain names from Yahoo! Enter now. http://promotions.yahoo.com/goldrush _______________________________________________ Bug-guile mailing list Bug-guile@gnu.org http://lists.gnu.org/mailman/listinfo/bug-guile