]> git.eshelyaron.com Git - emacs.git/commitdiff
(Syntax Class Table): Add the missing designator for
authorStefan Monnier <monnier@iro.umontreal.ca>
Tue, 8 May 2001 20:13:03 +0000 (20:13 +0000)
committerStefan Monnier <monnier@iro.umontreal.ca>
Tue, 8 May 2001 20:13:03 +0000 (20:13 +0000)
comment and string fences.
(Syntax Properties): Add a xref to syntax table internals.
(Syntax Table Internals): Document string-to-syntax.

lispref/ChangeLog
lispref/syntax.texi

index fe71283edfc84c3ce1dff1b3b4a829fe3e58e8d4..c3f467e7741b6870cd5c4e8a07c0b0bd2f32bb05 100644 (file)
@@ -1,3 +1,10 @@
+2001-05-08  Stefan Monnier  <monnier@cs.yale.edu>
+
+       * syntax.texi (Syntax Class Table): Add the missing designator for
+       comment and string fences.
+       (Syntax Properties): Add a xref to syntax table internals.
+       (Syntax Table Internals): Document string-to-syntax.
+
 2001-05-07  Gerd Moellmann  <gerd@gnu.org>
 
        * Makefile.in (install): Use install-info command line options
@@ -127,9 +134,9 @@ Wed Jun  7 17:04:59 1995  Karl Heuer  <kwzh@nutrimat.gnu.ai.mit.edu>
 
 Tue Nov 23 19:59:40 1993  Noah Friedman  (friedman@nutrimat.gnu.ai.mit.edu)
 
-        * Makefile (VERSION): New variable.
-        (dist): Make packaged directory name `elisp-manual-19-$(VERSION)'.
-        Compressed file suffix should be `.gz', not `.z'. 
+       * Makefile (VERSION): New variable.
+       (dist): Make packaged directory name `elisp-manual-19-$(VERSION)'.
+       Compressed file suffix should be `.gz', not `.z'.
 
 Mon Nov 22 15:06:19 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
 
@@ -137,7 +144,7 @@ Mon Nov 22 15:06:19 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
 
 Fri Nov 19 02:29:33 1993  Noah Friedman  (friedman@gnu.ai.mit.edu)
 
-        * Makefile (srcs): Add anti.texi.
+       * Makefile (srcs): Add anti.texi.
 
 Fri May 28 18:04:53 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
 
@@ -168,7 +175,7 @@ Fri Mar 26 21:14:54 1993  Eric S. Raymond  (eric@geech.gnu.ai.mit.edu)
 
 Wed Mar 17 08:48:24 1993  Eric S. Raymond  (eric@mole.gnu.ai.mit.edu)
 
-       * variables.texi: document nil initial value of buffer-local variables.
+       * variables.texi: Document nil initial value of buffer-local variables.
 
        * tips.texi: Add new section on standard library headers.
 
@@ -185,7 +192,7 @@ Tue Feb 23 10:50:25 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)
 
 Fri Feb 12 16:54:38 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)
 
-        * Makefile (dist): Don't include backup files or autosave files in
+       * Makefile (dist): Don't include backup files or autosave files in
        the distribution tar file.
 
 Tue Nov 26 21:10:34 1991  Richard Stallman  (rms at mole.gnu.ai.mit.edu)
@@ -225,7 +232,7 @@ Wed May 10 18:01:17 1989  Robert J. Chassell  (bob at rice-chex.ai.mit.edu)
        and @error{} are the terms now being used.  The files in the
        directory have been changed to reflect this.
 
-        * All instances of @indentedresultt{} have been changed to 
+       * All instances of @indentedresultt{} have been changed to
        `     @result{}', using 5 spaces at the begining of the line.
 
 Mon Apr 24 21:02:55 1989  Robert J. Chassell  (bob at rice-chex.ai.mit.edu)
@@ -238,7 +245,7 @@ Mon Apr 24 21:02:55 1989  Robert J. Chassell  (bob at rice-chex.ai.mit.edu)
 Mon Apr 17 18:56:50 1989  Robert J. Chassell  (bob at rice-chex.ai.mit.edu)
 
        * texinfo.tex:  temporarily added
-               \let\result=\dblarrow  
+               \let\result=\dblarrow
                \def\error{{\it ERROR} \longdblarrow}
        We need to do this better soon.
 
index 9ac397afb3f9ee293ef1065fe81c906891e78411..d1cb99f2f60c9dd26a8f53adcfa8470ba1c193cf 100644 (file)
@@ -259,11 +259,11 @@ designator for this syntax code is @samp{@@}.
 @end deffn
 
 @deffn {Syntax class} @w{generic comment delimiter}
-A @dfn{generic comment delimiter} character starts or ends a special
-kind of comment.  @emph{Any} generic comment delimiter matches
-@emph{any} generic comment delimiter, but they cannot match a comment
-starter or comment ender; generic comment delimiters can only match each
-other.
+A @dfn{generic comment delimiter} (designated by @samp{!}) starts
+or ends a special kind of comment.  @emph{Any} generic comment delimiter
+matches @emph{any} generic comment delimiter, but they cannot match
+a comment starter or comment ender; generic comment delimiters can only
+match each other.
 
 This syntax class is primarily meant for use with the
 @code{syntax-table} text property (@pxref{Syntax Properties}).  You can
@@ -273,10 +273,10 @@ identifying them as generic comment delimiters.
 @end deffn
 
 @deffn {Syntax class} @w{generic string delimiter}
-A @dfn{generic string delimiter} character starts or ends a string.
-This class differs from the string quote class in that @emph{any}
-generic string delimiter can match any other generic string delimiter;
-but they do not match ordinary string quote characters.
+A @dfn{generic string delimiter} (designated by @samp{|}) starts or ends
+a string.  This class differs from the string quote class in that @emph{any}
+generic string delimiter can match any other generic string delimiter; but
+they do not match ordinary string quote characters.
 
 This syntax class is primarily meant for use with the
 @code{syntax-table} text property (@pxref{Syntax Properties}).  You can
@@ -539,7 +539,7 @@ occurrence of the character.
 
 @item @code{(@var{syntax-code} . @var{matching-char})}
 A cons cell of this format specifies the syntax for this
-occurrence of the character.
+occurrence of the character.  (@pxref{Syntax Table Internals})
 
 @item @code{nil}
 If the property is @code{nil}, the character's syntax is determined from
@@ -788,7 +788,8 @@ function.)
   Lisp programs don't usually work with the elements directly; the
 Lisp-level syntax table functions usually work with syntax descriptors
 (@pxref{Syntax Descriptors}).  Nonetheless, here we document the
-internal format.
+internal format.  This format is used mostly when manipulating
+syntax properties.
 
   Each element of a syntax table is a cons cell of the form
 @code{(@var{syntax-code} . @var{matching-char})}.  The @sc{car},
@@ -881,6 +882,10 @@ corresponds to each syntax flag.
 @samp{3} @ @  @code{(lsh 1 18)}
 @end multitable
 
+@defun string-to-syntax @var{desc}
+This function returns the internal form @code{(@var{syntax-code} .
+@var{matching-char})} corresponding to the syntax descriptor @var{desc}.
+
 @node Categories
 @section Categories
 @cindex categories of characters