bug#71300: [PATCH v4] doc: Document SRFI 64.

Maxim Cournoyer <[email protected]> writes:

> This is an import of the 'Abstract', 'Rationale', and 'Specification'
> sections from the upstream specification text, with some manual
> adjustment.
>
> * doc/ref/srfi-modules.texi (SRFI 64): New subsection.

I think important question to ask here is whether this manual section
documents SRFI-64 or what Guile ships as SRFI-64.  Current
implementation shipped by Guile has many quirks that do not conform to
the specification.

> +@c This SRFI 64 documentation was "snarfed" from upstream specification
> +@c HTML document using the 'snarfi' script.

Based on this I believe it describes the specification.

I think either of those is fine (albeit describing the Guile's flavor
would be preferred), but is should be stated (that the behavior
described by the manual does not match the implementation shipped).

Have a nice day,
Tomas

-- 
There are only two hard things in Computer Science:
cache invalidation, naming things and off-by-one errors.

-----BEGIN PGP SIGNATURE-----

iQJCBAEBCgAsFiEEt4NJs4wUfTYpiGikL7/ufbZ/wakFAmbwDdgOHH5Ad29sZnNk
ZW4uY3oACgkQL7/ufbZ/wakEiA/+ObTsNxHZ1tSqFvkrthq1b00NwLo/DvGSyAXP
YUxqocrJhmSLlWUW7UqvXbqe8bb4naC8AjtP1ZT/HUKRU7heUEafFVDDx/1WQGzB
pMBbLbyfaEEm5GSG31w2E1pDugrKlwPfLsiAgjCF28QOb0VaMcdIfg98xZYTq2sL
sJPVG12Km7RrMjiMUxqozWhZ+AHh5brpK7w9xM6klOGCmJyJc/69sORfbIK0DTkV
citwxI9DvmNAuSOCG14Qqf8ok6dq0CC0Q/7BG1k61AJpmyoVDxW1kV9n8gwfqJ/a
pT0XPjNDC4ABhdzR1RX7hOIryhlA65bFeleIeDy7gXssMiNhSkzzsKjAeMJP7ruo
y9sdg3eyGWc4cSkTxOvInnPQVWN2z5udwX55NCJeMBaprTUWcEqOiyZ1ZwizzLFU
bCQ/YZmH/8MJluMxaGpaGxWCLOBNvXA6aJ3WSG0I8RPm9CPMqugD+Wbi5QLHElqZ
7tqJtwN+LKzJmPJlcLDWVm78xoKn2LQD/do79lNBio6rPq8iW2Q43ctmNJiGXYO2
4tSgMESQ4RMZGhatiLMycpPjSP99ReZd4cDqCbMInk/lhi2Md3ujtBxWpxzwRMu/
pDh4fHTSINcWF3WCkCkJHAhGX4aXm0RLkvLH4pAmeMybddbFUYbfIjw243Hpekgw
HlxBxnc=
=kWWR
-----END PGP SIGNATURE-----