diff options
author | Ludovic Courtès <ludo@gnu.org> | 2009-10-19 22:38:34 +0200 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2009-10-19 22:40:01 +0200 |
commit | 620c89651ae54f8f35c3d0926f8c2c36c3fdd174 (patch) | |
tree | 534c09fcdc42fdeba146ba5d32326c38b1b0f0d2 /doc/ref/api-evaluation.texi | |
parent | cbeb479c6e4da67ef37efa2548713fd6eadc71f3 (diff) | |
download | guile-620c89651ae54f8f35c3d0926f8c2c36c3fdd174.tar.gz |
Add support for R6RS/SRFI-30 nested block comments.
Suggested by Andreas Rottmann <a.rottmann@gmx.at>.
* libguile/read.c (flush_ws, scm_read_sharp): Add support for
R6RS/SRFI-30 block comments.
(scm_read_r6rs_block_comment): New function.
* test-suite/tests/reader.test (exception:unterminated-block-comment):
Adjust to match both block comment styles.
("reading")["R6RS/SRFI-30 block comment", "R6RS/SRFI-30 nested block
comment", "R6RS/SRFI-30 block comment syntax overridden"]: New tests.
("exceptions")["R6RS/SRFI-30 unterminated nested block comment"]: New
test.
* doc/ref/api-evaluation.texi (Block Comments): Mention SRFI-30/R6RS
block comments.
* doc/ref/srfi-modules.texi (SRFI-30): New node.
Diffstat (limited to 'doc/ref/api-evaluation.texi')
-rw-r--r-- | doc/ref/api-evaluation.texi | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/ref/api-evaluation.texi b/doc/ref/api-evaluation.texi index 8abd9f9cf..e50a51546 100644 --- a/doc/ref/api-evaluation.texi +++ b/doc/ref/api-evaluation.texi @@ -230,6 +230,21 @@ Thus a Guile script often starts like this. More details on Guile scripting can be found in the scripting section (@pxref{Guile Scripting}). +@cindex R6RS block comments +@cindex SRFI-30 block comments +Similarly, Guile (starting from version 2.0) supports nested block +comments as specified by R6RS and +@url{http://srfi.schemers.org/srfi-30/srfi-30.html, SRFI-30}: + +@lisp +(+ #| this is a #| nested |# block comment |# 2) +@result{} 3 +@end lisp + +For backward compatibility, this syntax can be overridden with +@code{read-hash-extend} (@pxref{Reader Extensions, +@code{read-hash-extend}}). + There is one special case where the contents of a comment can actually affect the interpretation of code. When a character encoding declaration, such as @code{coding: utf-8} appears in one of the first |