[PATCH] Small fixes in doc/ref/srfi-modules.texi; a couple other questions

[Stephen Compall]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

See the patch at
http://csserver.evansville.edu/~sc87/dist/guile-man-4S11.patch

First, a changelog.  Then, some things I'm not clear on from reading
the manual:

2003-05-02  Stephen Compall  <address@hidden>

        * srfi-modules.texi (reduce): changed equivalent fold code to
        match srfi-1.scm.

        (filter): tied up hanging sentence.

        (alist-copy): Emphasized difference with "normal" list-copy.

        Various grammar fixes and a couple parenthesis closings.

Now, my questions, which you may or may not consider documentation
bugs:
^L
srfi-1: for-each: "each pair"...of what?  You can pass more than two
lists.
^L
Documentation for access?: correct me if I'm wrong, but the subr
appears to use the libc `access' function.  Here's what the GNU libc
manual says about that function:

       `access' is _only_ only appropriate to use in setuid programs.
    A non-setuid program will always use the effective ID rather than
    the real ID.

See libc.info, node "Testing File Access", for the full story.  This
is a caveat for the usage, if it really is only only appropriate for
setuid programs.  But since the ruid == euid etc. in non-set?id
programs, I don't see the problem at first glance (though it could
conceivably cause problems in set?id programs :).  It's just something
I remember.
^L
It looks like read (scm_read) should return eof-object if at
end-of-file.  I believe the documentation should say that, and that
read-error occurs if there's another problem (though this may seem
obvious).

- -- 
Stephen Compall - Also known as S11001001
DotGNU `Contributor' -- http://dotgnu.org
Jabber ID: address@hidden

Developing non-free software is mistreating other people. So don't
make a living that way. Find some other way to make a living. A way
that involves ethical behavior.
        -- RMS

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (GNU/Linux)

iD8DBQE+szG12AceYinZ4EgRAqdyAJ98BLI4ehXz10ZMwv3ETXPNdHR4JQCfeIXn
0YbytHbve6EIorZON58OvsY=
=IUqr
-----END PGP SIGNATURE-----