annotate lisp/fontl-hooks.el @ 563:183866b06e0b

[xemacs-hg @ 2001-05-24 07:50:48 by ben] Makefile.in.in, abbrev.c, alloc.c, buffer.c, bytecode.c, callint.c, callproc.c, casetab.c, chartab.c, cmdloop.c, cmds.c, console-msw.c, console-msw.h, console-stream.c, console-tty.c, console-x.c, console.c, data.c, database.c, debug.c, device-gtk.c, device-msw.c, device-tty.c, device-x.c, device.c, dialog-gtk.c, dialog-msw.c, dialog-x.c, dialog.c, dired-msw.c, dired.c, doc.c, doprnt.c, dragdrop.c, editfns.c, eldap.c, eldap.h, elhash.c, emacs-widget-accessors.c, emacs.c, emodules.c, esd.c, eval.c, event-Xt.c, event-gtk.c, event-msw.c, event-stream.c, events.c, extents.c, faces.c, file-coding.c, fileio.c, filelock.c, floatfns.c, fns.c, font-lock.c, frame-gtk.c, frame-x.c, frame.c, general-slots.h, glade.c, glyphs-gtk.c, glyphs-msw.c, glyphs-widget.c, glyphs-x.c, glyphs.c, glyphs.h, gpmevent.c, gui-gtk.c, gui-x.c, gui.c, gutter.c, hpplay.c, indent.c, input-method-xlib.c, insdel.c, intl.c, keymap.c, libsst.c, libsst.h, linuxplay.c, lisp.h, lread.c, lstream.c, lstream.h, macros.c, marker.c, md5.c, menubar-gtk.c, menubar-msw.c, menubar-x.c, menubar.c, minibuf.c, miscplay.c, miscplay.h, mule-ccl.c, mule-charset.c, mule-wnnfns.c, mule.c, nas.c, ntplay.c, ntproc.c, objects-gtk.c, objects-msw.c, objects-x.c, objects.c, postgresql.c, print.c, process-nt.c, process-unix.c, process.c, ralloc.c, rangetab.c, redisplay.c, scrollbar.c, search.c, select-gtk.c, select-x.c, select.c, sgiplay.c, sheap.c, sound.c, specifier.c, sunplay.c, symbols.c, symeval.h, symsinit.h, syntax.c, sysdep.c, toolbar-msw.c, toolbar.c, tooltalk.c, ui-byhand.c, ui-gtk.c, undo.c, unexaix.c, unexapollo.c, unexconvex.c, unexec.c, widget.c, win32.c, window.c: -- defsymbol -> DEFSYMBOL. -- add an error type to all errors. -- eliminate the error functions in eval.c that let you just use Qerror as the type. -- redo the error API to be more consistent, sensibly named, and easier to use. -- redo the error hierarchy somewhat. create new errors: structure-formation-error, gui-error, invalid-constant, stack-overflow, out-of-memory, process-error, network-error, sound-error, printing-unreadable-object, base64-conversion- error; coding-system-error renamed to text-conversion error; some others. -- fix Mule problems in error strings in emodules.c, tooltalk.c. -- fix error handling in mswin open-network-stream. -- Mule-ize all sound files and clean up the headers. -- nativesound.h -> sound.h and used for all sound files. -- move some shared stuff into glyphs-shared.c: first attempt at eliminating some of the massive GTK code duplication. xemacs.mak: add glyphs-shared.c. xemacs-faq.texi: document how to debug X errors subr.el: fix doc string to reflect reality
author ben
date Thu, 24 May 2001 07:51:33 +0000
parents d44af0c54775
children 308d34e9f07d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
217
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
1 ;;; fontl-hooks.el --- pre-loaded stuff for font-lock.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
2
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
3 ;; Copyright (C) 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
4 ;; Copyright (C) 1995 Amdahl Corporation.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
5 ;; Copyright (C) 1996 Ben Wing.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
6
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
7 ;; This file is part of XEmacs.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
8
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
9 ;; XEmacs is free software; you can redistribute it and/or modify it
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
10 ;; under the terms of the GNU General Public License as published by
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
11 ;; the Free Software Foundation; either version 2, or (at your option)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
12 ;; any later version.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
13
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
14 ;; XEmacs is distributed in the hope that it will be useful, but
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
15 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
17 ;; General Public License for more details.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
18
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
19 ;; You should have received a copy of the GNU General Public License
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
20 ;; along with XEmacs; see the file COPYING. If not, write to the
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
22 ;; Boston, MA 02111-1307, USA.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
23
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
24 ;;; Synched up with: FSF 19.30. (font-lock.el)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
25
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
26 ;;; Commentary:
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
27
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
28 ;; The reason for the existence of this file is so that modes can
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
29 ;; call `font-lock-set-defaults' without worrying about whether
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
30 ;; font-lock is loaded. We don't autoload this from font-lock.el
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
31 ;; because loading font-lock.el automatically turns font-lock on.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
32
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
33 ;;; Code:
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
34
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
35 (defun font-lock-set-defaults (&optional explicit-defaults)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
36 "Set fontification defaults appropriately for this mode.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
37 Sets `font-lock-keywords', `font-lock-keywords-only', `font-lock-syntax-table',
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
38 `font-lock-beginning-of-syntax-function' and
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
39 `font-lock-keywords-case-fold-search'.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
40
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
41 If `font-lock-defaults' is currently set, it is used. Otherwise, the
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
42 symbol naming the major mode is examined for a `font-lock-defaults'
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
43 property. If that is not present, but a variable `foo-mode-font-lock-keywords'
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
44 is, the value of that variable is used as the default for
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
45 `font-lock-keywords'. Various other backward-compatible behaviors also
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
46 exist -- if you're curious, look at the source.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
47
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
48 The value of `font-lock-maximum-decoration' is used to determine which
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
49 set of keywords applies, if more than one exists.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
50
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
51 This will also put the buffer into Font Lock mode if any keywords exist
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
52 and if auto-fontification is called for, as determined by
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
53 `font-lock-auto-fontify', `font-lock-mode-enable-list', and
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
54 `font-lock-mode-disable-list'.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
55
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
56 Calling this function multiple times in the same buffer is safe -- this
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
57 function keeps track of whether it has already been called in this
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
58 buffer, and does nothing if so. This allows for multiple ways of getting
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
59 Font Lock properly initialized in a buffer, to deal with existing major
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
60 modes that do not call this function. (For example, Font Lock adds this
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
61 function to `find-file-hooks'.)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
62
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
63 Major modes that have any font-lock defaults specified should call this
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
64 function during their initialization process, after they have set
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
65 the variable `major-mode'.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
66
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
67 If EXPLICIT-DEFAULTS is t, this function will not check whether it
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
68 has already been run in this buffer, and will always do the full
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
69 computation.
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
70
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
71 If EXPLICIT-DEFAULTS is not nil and not t, it should be something
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
72 that is allowable as a value for `font-lock-defaults' and will be
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
73 used to initialize the Font Lock variables."
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
74
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
75 (when
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
76 (and
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
77 (featurep 'font-lock)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
78 (if font-lock-auto-fontify
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
79 (not (memq major-mode font-lock-mode-disable-list))
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
80 (memq major-mode font-lock-mode-enable-list))
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
81 (font-lock-set-defaults-1 explicit-defaults)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
82 font-lock-keywords)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
83 (turn-on-font-lock)))
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
84
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
85 (provide 'fontl-hooks)
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
86
d44af0c54775 Import from CVS: tag r20-4b7
cvs
parents:
diff changeset
87 ;;; fontl-hooks.el ends here