summaryrefslogtreecommitdiff
path: root/doc/ref
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ref')
-rw-r--r--doc/ref/api-options.texi22
1 files changed, 13 insertions, 9 deletions
diff --git a/doc/ref/api-options.texi b/doc/ref/api-options.texi
index 0c5edd4eb..3c25b196d 100644
--- a/doc/ref/api-options.texi
+++ b/doc/ref/api-options.texi
@@ -495,18 +495,22 @@ Here is the list of reader options generated by typing
values.
@smalllisp
-keywords #f Style of keyword recognition: #f, 'prefix or 'postfix
-case-insensitive no Convert symbols to lower case.
-positions yes Record positions of source code expressions.
-copy no Copy source code expressions.
-r6rs-hex-escapes no Use R6RS-style string hex escapes
+copy no Copy source code expressions.
+positions yes Record positions of source code expressions.
+case-insensitive no Convert symbols to lower case.
+keywords #f Style of keyword recognition: #f, 'prefix or 'postfix.
+r6rs-hex-escapes no Use R6RS variable-length character and string hex escapes.
+square-brackets yes Treat `[' and `]' as parentheses, for R6RS compatibility.
@end smalllisp
-Notice that while Standard Scheme is case insensitive, to ease
-translation of other Lisp dialects, notably Emacs Lisp, into Guile,
-Guile is case-sensitive by default.
+Historically, many Scheme implementations have been case-insensitive,
+treating @code{foo} and @code{FOO} as the same symbol. Guile has always
+defaulted to case-sensitivity, as allowed since the R4RS and codified in
+the R6RS.
-To make Guile case insensitive, you can type
+Guile also has a reader option to fold all symbols to their lower
+case. To enable this option, perhaps for compatibility with older Scheme
+code, you can enter
@lisp
(read-enable 'case-insensitive)