From d1f08d85033a1e9ef07ac7f2887f64bff27834f4 Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Tue, 8 May 2001 20:13:03 +0000 Subject: [PATCH] (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. --- lispref/ChangeLog | 23 +++++++++++++++-------- lispref/syntax.texi | 27 ++++++++++++++++----------- 2 files changed, 31 insertions(+), 19 deletions(-) diff --git a/lispref/ChangeLog b/lispref/ChangeLog index fe71283edfc..c3f467e7741 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,10 @@ +2001-05-08 Stefan Monnier + + * 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 * Makefile.in (install): Use install-info command line options @@ -127,9 +134,9 @@ Wed Jun 7 17:04:59 1995 Karl Heuer 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. diff --git a/lispref/syntax.texi b/lispref/syntax.texi index 9ac397afb3f..d1cb99f2f60 100644 --- a/lispref/syntax.texi +++ b/lispref/syntax.texi @@ -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