doco srfi-1 iota

[Kevin Ryde <user42@zip.com.au>]

[-- Attachment #1: Type: text/plain, Size: 667 bytes --]

        * srfi-modules.texi (SRFI-1 Constructors): In iota, reword a bit for
        clarity and add a couple of examples.

I found the formula for each element less clear than it could be, and
thought a couple of examples would be enough to illustrate what
happens.


 - Scheme Procedure: iota count [start step]
     Return a list containing COUNT numbers, starting from START and
     adding STEP each time.  The default START is 0, the default STEP
     is 1.  For example,

          (iota 6)        => (0 1 2 3 4 5)
          (iota 4 2.5 -2) => (2.5 0.5 -1.5 -3.5)

     This function takes its name from the corresponding primitive in
     the APL language.



[-- Attachment #2: srfi-modules.texi.iota.diff --]
[-- Type: text/plain, Size: 807 bytes --]

--- srfi-modules.texi.~1.18.~	2003-06-05 01:47:08.000000000 +1000
+++ srfi-modules.texi	2003-07-06 11:53:08.000000000 +1000
@@ -220,12 +220,17 @@
 @end deffn
 
 @deffn {Scheme Procedure} iota count [start step]
-Return a list containing @var{count} elements, where each element is
-calculated as follows:
+Return a list containing @var{count} numbers, starting from
+@var{start} and adding @var{step} each time.  The default @var{start}
+is 0, the default @var{step} is 1.  For example,
 
-@var{start} + (@var{count} - 1) * @var{step}
+@example
+(iota 6)        @result{} (0 1 2 3 4 5)
+(iota 4 2.5 -2) @result{} (2.5 0.5 -1.5 -3.5)
+@end example
 
-@var{start} defaults to 0 and @var{step} defaults to 1.
+This function takes its name from the corresponding primitive in the
+APL language.
 @end deffn
 
 

[-- Attachment #3: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel