John, I'm not quite sure what you intended there. Shall I restore "We add two new functions. The most frequently used is likely to be"
Replace the first sentence with "This SRFI provides two new procedures. The most frequently used is likely to be". Somehow that got lost.
in place of "This SRFI also provides two new convenience macros."? That appears to be where the edit went wrong.
That sentence should appear in the first paragraph in the "Macros" section. Moving and duplicating text got me into this mess.
(2) It might be worth explicitly mentioning that string-append! and string-replace!
are macro versions of the SRFI-118 procedures, and thus "mostly-compatible" with the latter.
Not sure where/how best to do that,
I will wait for John to suggest language for that.
Here's a third paragraph for the Rationale:
<p>The procedures and the macros of this SRFI together provide an approximation of the two SRFI 118 procedures. Direct calls to <code>string-append!</code> and <code>string-replace!</code> are compatible between the two SRFIs provided that the first argument is a valid place (see below). But calls made using <code>apply</code>, or where the first argument is not a place, are incompatible. In those cases, it is necessary to use the two linear procedures while being sure to appropriately capture the result.</p>