changeset 45774:71755f1fa5a4

(font-lock-beginning-of-syntax-function): Doc fix.
author Richard M. Stallman <rms@gnu.org>
date Wed, 12 Jun 2002 12:16:08 +0000
parents f51c8245cf98
children 25c330bebee4
files lisp/font-lock.el
diffstat 1 files changed, 10 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/lisp/font-lock.el	Wed Jun 12 09:37:43 2002 +0000
+++ b/lisp/font-lock.el	Wed Jun 12 12:16:08 2002 +0000
@@ -519,12 +519,17 @@
 This is normally set via `font-lock-defaults'.")
 
 (defvar font-lock-beginning-of-syntax-function nil
-  "*Non-nil means use this function to move back outside of a syntactic block.
-When called with no args it should leave point at the beginning of any
-enclosing syntactic block.
-If this is nil, the beginning of the buffer is used (in the worst case).
+  "*Non-nil means use this function to move back outside all constructs.
+When called with no args it should move point backward to a place which
+is not in a string or comment and not within any bracket-pairs (or else,
+a place such that any bracket-pairs outside it can be ignored for Emacs
+syntax analysis and fontification).
+
+If this is nil, the beginning of the buffer is used, which is
+always correct but tends to be slow.
 This is normally set via `font-lock-defaults'.
-It is preferable to set `syntax-begin-function' instead.")
+This variable is semi-obsolete; we recommend setting
+`syntax-begin-function' instead.")
 
 (defvar font-lock-mark-block-function nil
   "*Non-nil means use this function to mark a block of text.