From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stephen Compall Newsgroups: gmane.lisp.guile.bugs Subject: [DOCPATCH]Revamp of doc/ref/scheme-control.texi Date: Wed, 16 Jul 2003 12:37:37 -0500 Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Message-ID: <200307161737.h6GHbb200806@csserver.evansville.edu> NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1058377497 18270 80.91.224.249 (16 Jul 2003 17:44:57 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 16 Jul 2003 17:44:57 +0000 (UTC) Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Wed Jul 16 19:44:56 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19cqGC-0004Fa-00 for ; Wed, 16 Jul 2003 19:40:12 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.20) id 19cqFV-0006qt-FQ for guile-bugs@m.gmane.org; Wed, 16 Jul 2003 13:39:29 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19cqF0-0006eY-Rd for bug-guile@gnu.org; Wed, 16 Jul 2003 13:38:58 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19cqEn-0006I4-MJ for bug-guile@gnu.org; Wed, 16 Jul 2003 13:38:46 -0400 Original-Received: from [192.195.228.35] (helo=csserver.evansville.edu) by monty-python.gnu.org with esmtp (Exim 4.20) id 19cqDv-000593-LH for bug-guile@gnu.org; Wed, 16 Jul 2003 13:37:51 -0400 Original-Received: (from sc87@localhost) by csserver.evansville.edu (8.11.6/8.11.6) id h6GHbb200806; Wed, 16 Jul 2003 12:37:37 -0500 Original-To: bug-guile@gnu.org X-BeenThere: bug-guile@gnu.org X-Mailman-Version: 2.1.2 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:858 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.bugs:858 Well, the first half (or so) of it anyway. I was planning on saving this until I could get all the way through the file, but it's getting a little unwieldy, so please have a look. ChangeLog at the bottom of this email. A great deal of the diff is due to moving the named let description to the *beginning* of node `while do'. I felt this appropriate, as named let seems to be a more important and powerful construct than either while or do. COPYRIGHT! I have a request for assignment of past and future changes pending. Also, as far as I can see, an old patch on srfi-modules.texi from May (http://mail.gnu.org/archive/html/bug-guile/2003-05/msg00000.html) hasn't been acted upon, as I haven't seen it applied nor rejected by email. It conflicts now, so please let me know if you (being whoever applies patches nowadays) would like me to regenerate it from my (conflict resolved) version. I have some new updates for srfi-modules.texi since then anyway. 2003-07-16 Stephen Compall * scheme-control.texi (Dynamic Wind): Explain concept of dynamic context more fully. Cleaned up example text: reindented, appropriate @print and @result, @r for comments. Changed _ in variables to -. (Multiple Values): Removed redundant wording. (begin): Converted Yet Another passive text to active. (Exception Terminology): Reworked the guide to list all the terms in table form, along with their collective definitions. 2003-07-15 Stephen Compall * scheme-control.texi (while do): Continue converting to active voice. (Continuations): Tried to explain them, and created full, useful, working example. 2003-06-09 Stephen Compall * scheme-control.texi (if cond case): Summarized `cond' in one sentence. (and or): Eliminated redundant index entries. (while do): Added cross references to standard list mapping functions and SRFI-1, which contains many more. 2003-05-30 Stephen Compall * scheme-control.texi: More index entries. (while do): Changed some sentences from passive to active voice, as RMS recommends. (begin): Showed results of `begin'. (and or): Examples of using `and' and `or' as tests in `if'. 2003-05-13 Stephen Compall * scheme-control.texi (begin): Added note about begin's uselessness. (if cond case): Added note about else usage in cond. Referred to else as a literal symbol, not keyword. (while do): Moved named let to beginning of iteration mechanisms, to reflect its relative importance better. Added working example of named let to its section, and how to use it in place of the other provided iteration mechanisms. (Multiple Values): Changed @example blocks to use @lisp or @smalllisp. Fixed result indication in call-with-values example. (Exceptions): Defined non-local jump. Used @table instead of @example for program flow chart. (Exception Terminology): Added cross-reference. (Throw): Removed warning of nonexistent "difficulty". (Lazy Catch): Clarified similarity to catch. Untabified. Various English syntax fixes, such as fixing pluralities and closing parentheses. A conservative sprinkling of Concept Index entries. -- Stephen Compall or S11 or sirian Give a small boy a hammer and he will find that everything he encounters needs pounding. _______________________________________________ Bug-guile mailing list Bug-guile@gnu.org http://mail.gnu.org/mailman/listinfo/bug-guile