From: John Cowan <xxxxxx@ccil.org>
Date: Friday, August 14, 2020 11:17 AM

Everything I agreed with and (hopefully) fixed has been removed without comment.

On Fri, Aug 14, 2020 at 9:02 AM <xxxxxx@ancell-ent.com> wrote:

This SRFI recommends that in multi-threaded programs the mask be set in the primordial thread before any other threads are created and never changed again.

The above and its repeat for set-current-directory! would be more clear with an Oxford comma at the end, "are created, and never changed again."  That helps to emphasize the very important last clause.

Oxford commas are of the form "A, B, and C".  They don't justify "A, and B", which is what you're asking for here.  Instead, I put the last three words in italics.

Ah, thanks, Oxford commas are a pretty new thing to me.  However, the italicizations didn't make it into the commit.  Nor did the following:

(user-info uid/name)    →    record       (procedure)       POSIX getpwuid/getpwnam() 

Return a user-info record giving the recorded information for a particular user. The uid/name argument is either an exact integer uid or a string user name.

Rather than repeat "uid" in the description, spell out "exact integer user id or....", words of art that are also used in the getter description?  Ditto for the group version.

Everything else including your additional fixes looks fine.

- Harold