[DOCPATCH]Revamp of doc/ref/scheme-control.texi

[Stephen Compall]

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  <address@hidden>

        * 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  <address@hidden>

        * 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  <address@hidden>

        * 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  <address@hidden>

        * 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  <address@hidden>

        * 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.