From 579870abbc5cce00793933a9ab81b93e138f68da Mon Sep 17 00:00:00 2001 From: Andy Wingo Date: Thu, 4 Mar 2021 21:41:28 +0100 Subject: Update documentation to incorporate read-syntax * NEWS: Update a bit. * doc/ref/api-debug.texi (Source Properties): Mention read-syntax. * doc/ref/api-evaluation.texi (Annotated Scheme Read): New section. * doc/ref/api-macros.texi (Syntax Case): Update for source vectors. --- NEWS | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) (limited to 'NEWS') diff --git a/NEWS b/NEWS index 54cee9af8..917679189 100644 --- a/NEWS +++ b/NEWS @@ -43,16 +43,19 @@ documentation for a full discussion. ** New `read' implementation in Scheme -The new `(ice-9 read)' module implements a reader, in Scheme. Compared -to the C reader (which still exists for bootstrapping reasons), the new +Guile's `read' procedure has been rewritten in Scheme. Compared to the +C reader (which still exists for bootstrapping reasons), the new implementation is more maintainable, more secure, more debuggable, all -while faithfully reproducing all quirks from Guile's legacy reader +while faithfully reproducing all quirks from Guile's previous reader implemented in C. Also, the Scheme reader is finally compatible with suspendable ports, allowing REPL implementations to be built with lightweight concurrency packages such as the third-party "Fibers" -library. The Scheme implementation is currently about 60% as fast as -the C implementation, and we hope to close the gap over time. Bug -reports very welcome. +library. Calls to `read' from Scheme as well as calls to `scm_read' +from C use the new reader. + +The Scheme implementation is currently about 60% as fast as the +now-inaccessible C implementation, and we hope to close the gap over +time. Bug reports very welcome. ** Scheme compiler uses `read-syntax' for better debugging @@ -110,10 +113,12 @@ These new interfaces replace `dynamic-link', `dynamic-pointer' and similar, which will eventually be deprecated. ** `read-syntax' + +See "Annotated Scheme Read" in the manual. + ** `syntax-sourcev' ** `quote-syntax' - ** Optimized "eof-object?" * Bug fixes -- cgit v1.2.1