From: Richard M. Stallman <rms@gnu.org>
Date: Sat, 12 Oct 1996 16:10:09 +0000 (+0000)
Subject: Explain what major modes can do for imenu and font-lock.
X-Git-Tag: emacs-20.1~3512
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=be9345cf6f4477fa4a92a95d00e586cc603ba848;p=emacs.git

Explain what major modes can do for imenu and font-lock.
---

diff --git a/lispref/modes.texi b/lispref/modes.texi
index 10c71d00993..dda63c9c0e5 100644
--- a/lispref/modes.texi
+++ b/lispref/modes.texi
@@ -152,6 +152,11 @@ related modes.  If it has its own syntax table, it should store this in
 a variable named @code{@var{modename}-mode-syntax-table}.  @xref{Syntax
 Tables}.
 
+@item
+If the mode handles a language that has a syntax for comments, it should
+set the variables that define the comment syntax.  @xref{Options for
+Comments,, Options Controlling Comments, emacs, The GNU Emacs Manual}.
+
 @item
 @cindex abbrev tables in modes
 The mode may have its own abbrev table or may share one with other
@@ -159,6 +164,20 @@ related modes.  If it has its own abbrev table, it should store this in
 a variable named @code{@var{modename}-mode-abbrev-table}.  @xref{Abbrev
 Tables}.
 
+@item
+@vindex font-lock-defaults
+The mode should specify how to do highlighting for Font Lock mode, by
+setting up a buffer-local value for the variable
+@code{font-lock-defaults}.
+
+@item
+@vindex imenu-generic-expression
+@vindex imenu-create-index-function
+The mode should specify how Imenu should find the definitions or
+sections of a buffer, by setting up a buffer-local value for the
+variable @code{imenu-generic-expression} or
+@code{imenu-create-index-function}.
+
 @item
 Use @code{defvar} to set mode-related variables, so that they are not
 reinitialized if they already have a value.  (Such reinitialization