[Emacs-diffs] Changes to emacs/lispref/modes.texi

[Lute Kamstra]

Index: emacs/lispref/modes.texi
diff -c emacs/lispref/modes.texi:1.108 emacs/lispref/modes.texi:1.109
*** emacs/lispref/modes.texi:1.108      Sat May 21 22:24:04 2005
--- emacs/lispref/modes.texi    Mon May 23 12:01:08 2005
***************
*** 2368,2374 ****
  resulting syntax table is stored in @code{font-lock-syntax-table}.
  
  The fifth element, @var{syntax-begin}, specifies the value of
! @code{font-lock-beginning-of-syntax-function}.
  
  All the remaining elements (if any) are collectively called
  @var{other-vars}.  Each of these elements should have the form
--- 2368,2376 ----
  resulting syntax table is stored in @code{font-lock-syntax-table}.
  
  The fifth element, @var{syntax-begin}, specifies the value of
! @code{font-lock-beginning-of-syntax-function}.  We recommend setting
! this variable to @code{nil} and using @code{syntax-begin-function}
! instead.
  
  All the remaining elements (if any) are collectively called
  @var{other-vars}.  Each of these elements should have the form
***************
*** 2880,2889 ****
  @code{font-lock-defaults}.
  @end defvar
  
- @c ???
- @c The docstring says that font-lock-syntax-table is semi-obsolete.
- @c How the alternative should be used is not clear.  --lute
- 
  @defvar font-lock-beginning-of-syntax-function
  If this variable is address@hidden, it should be a function to move
  point back to a position that is syntactically at ``top level'' and
--- 2882,2887 ----
***************
*** 2896,2904 ****
  be outside a syntactic block), or @code{beginning-of-defun} for
  programming modes, or @code{backward-paragraph} for textual modes.
  
! If the value is @code{nil}, the beginning of the buffer is used as a
! position outside of a syntactic block.  This cannot be wrong, but it
! can be slow.
  
  Specify this variable using @var{syntax-begin} in
  @code{font-lock-defaults}.
--- 2894,2903 ----
  be outside a syntactic block), or @code{beginning-of-defun} for
  programming modes, or @code{backward-paragraph} for textual modes.
  
! If the value is @code{nil}, Font Lock uses
! @code{syntax-begin-function} to move back outside of any comment,
! string, or sexp.  This variable is semi-obsolete; we recommend setting
! @code{syntax-begin-function} instead.
  
  Specify this variable using @var{syntax-begin} in
  @code{font-lock-defaults}.