[Emacs-diffs] Changes to emacs/lispref/strings.texi,v

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      07/04/04 15:57:05

Index: strings.texi
===================================================================
RCS file: /sources/emacs/emacs/lispref/strings.texi,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -b -r1.54 -r1.55
--- strings.texi        30 Mar 2007 18:12:56 -0000      1.54
+++ strings.texi        4 Apr 2007 15:57:04 -0000       1.55
@@ -1108,6 +1108,29 @@
 This sets the current buffer's case table to @var{table}.
 @end defun
 
address@hidden with-case-table table address@hidden
+The @code{with-case-table} macro saves the current case table, makes
address@hidden the current case table, evaluates the @var{body} forms,
+and finally restores the case table.  The return value is the value of
+the last form in @var{body}.  The case table is restored even in case
+of an abnormal exit via @code{throw} or error (@pxref{Nonlocal
+Exits}).
address@hidden defmac
+
+  Some language environments may modify the case conversions of ASCII
+characters; for example, in the Turkish language environment, the
+ASCII character ``I'' is downcased into a Turkish ``dotless i''.  This
+can interfere with code that requires ordinary ASCII case conversion,
+such as implementations of ASCII-based network protocols.  In that
+case, use the @code{with-case-table} macro with the variable
address@hidden, which stores the unmodified case table for the
+ASCII character set.
+
address@hidden ascii-case-table
+The case table for the ASCII character set.  This should not be
+modified by any language environment settings.
address@hidden defvar
+
   The following three functions are convenient subroutines for packages
 that define address@hidden character sets.  They modify the specified
 case table @var{case-table}; they also modify the standard syntax table.