[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: r6rs library documentation
From: |
Ludovic Courtès |
Subject: |
Re: r6rs library documentation |
Date: |
Tue, 22 Jun 2010 14:15:00 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) |
Hi Julian,
Julian Graham <address@hidden> writes:
>> Sounds great to me, though Brian & Neil can always come in to correct me
>> :)
>
> Done! See commit ea28e981342fd1d381e489e57cddde97eb390442. In
> addition to the main .texi payload, I adjusted the formatting on some
> of your initial paragraphs and removed the descriptions of the base
> and composite libraries -- let me know if those changes are
> problematic.
Great work! I find it nice and convenient to have all this in the
manual.
Random remarks:
address@hidden {Scheme Procedure} fold f lst1 lst2 ...
address@hidden {Scheme Procedure} for-each f lst1 lst2 ...
address@hidden Fold and Map}, for documentation.
address@hidden deffn
There’s no ‘fold’ in R6RS-lib; it’s called ‘fold-left’.
address@hidden {Scheme Procedure} remq obj list
address@hidden, @code{remv}, and @code{remq} are identical to the
address@hidden, @code{delv}, and @code{delq} procedures provided by
+Guile's core library; (@pxref{List Modification}) for their
Should be “Guile’s core library (@pxref{List Modification}).”
address@hidden {Scheme Procedure} div x1 x2
address@hidden {Scheme Procedure} mod x1 x2
address@hidden {Scheme Procedure} div-and-mod x1 x2
+These procedures implement number-theoretic division.
How about this instead:
@code{div} is an alias for Guile’s @code{quotient} and @code{mod} is
an alias for @code{modulo} (@pxref{Integer Operations}).
+The manual sections below describe Guile's implementation of R6RS
+records, which provide support for user-defined data types. The R6RS
+records API provides a superset of the features provided by Guile's
+``native'' records, as well as those of the SRFI-9 records API;
+(@pxref{Records}) and (@pxref{SRFI-9}) for a description of those
+interfaces.
This use of @pxref is incorrect and leads to broken rendering with all
back-ends (info "(texinfo) pxref"). The same problem appears in other
places. Could you look into it?
address@hidden rnrs conditions
address@hidden rnrs conditions
Perhaps add an xref to SRFI-35, in pure TIMTOWTDI spirit. ;-)
+Compound conditions do not ``nest'' --- constructing a new compound
The ‘---’ should not be surrounded by spaces. Though according to
https://secure.wikimedia.org/wikipedia/en/wiki/Dash#Em_dash you could
argue that you’re following the /The New York Times Manual of Style and
Usage/. ;-)
address@hidden rnrs arithmetic bitwise
address@hidden rnrs arithmetic bitwise
Add link to SRFI-60?
Thanks!
Ludo’.