annotate info/dir @ 1268:fffe735e63ee

[xemacs-hg @ 2003-02-07 11:50:50 by ben] fixes for menu crashes + better preemption behavior This contains two related changes: (1) Fix problems with reentrant calling of lwlib and associated crashes when selecting menu items. (2) Improve redisplay handling of preemption. Turn on lazy lock and hold down page-down or page-up and you'll see what I mean. They are related because they both touch on the code that retrieves events and handles the internal queues. console-msw.h, event-msw.c, event-stream.c, events.h, menubar-msw.c, menubar-x.c, menubar.h: mswindows_protect_modal_loop() has been generalized to event_stream_protect_modal_loop(), and moved to event-stream.c. mswindows_in_modal_loop ->in_modal_loop likewise. Changes in event-msw.c and menubar-msw.c for the new names and calling format (use structures instead of static variables in menubar-msw.c). Delete former in_menu_callback and use in_modal_loop in its place. Remove emacs_mswindows_quit_check_disallowed_p(), superseded by in_modal_loop. Use event_stream_protect_modal_loop() in pre_activate_callback() so that we get no lwlib reentrancy. Rearrange some of the code in event-msw.c to be grouped better. Make mswindows_drain_windows_queue() respect in_modal_loop and do nothing if so. cmdloop.c, event-stream.c: Don't conditionalize on LWLIB_MENUBARS_LUCID when giving error when in_modal_loop, and give better error. event-Xt.c, event-gtk.c: If in_modal_loop, only retrieve process and timeout events. Don't retrieve any X events because processing them can lead to reentrancy in lwlib -> death. event-stream.c: Remove unused parameter to check_event_stream_ok() and change all callers. lisp.h, event-stream.c: Rearrange some functions for increased clarity -- in particular, group all the input-pending/QUIT-related stuff together, and put right next to next-event stuff, to which it's related. Add the concept of "HOW_MANY" -- when asking whether user input is pending, you can ask if at least HOW_MANY events are pending, not just if any are. Add parameter to detect_input_pending() for this. Change recursive_sit_for from a Lisp_Object (which could only be Qt or Qnil) to an int, like it should be. event-Xt.c, event-gtk.c, event-xlike-inc.c: New file. Abstract out similar code in event_{Xt/gtk}_pending_p() and write only once, using include-file tricks. Rewrite this function to implement HOW_MANY and only process events when not in_modal_loop. event-msw.c: Implement HOW_MANY and only process events when not in_modal_loop. event-tty.c: Implement HOW_MANY. redisplay.c: Add var `max-preempts' to control maximum number of preempts. (#### perhaps not useful) Rewrite preemption check so that, rather than preempting when any user events are available, only preempt when a certain number (currently 4) of them are backed up. This effectively allows redisplay to proceed to completion in the presence of a fast auto-repeat (usually the auto-repeating is generated dynamically as necessary), and you get much better display behavior with lazy-lock active. event-unixoid.c: Comment changes. event-stream.c: Rewrite discard-input much more simply and safely using the drain-queue functions. I think the old version might loop forever if called when in_modal_loop. SEMI-UNRELATED CHANGES: ----------------------- event-stream.c: Turn QUIT-checking back on when running the pre-idle hook so it can be quit out of. indent.c: Document exact functioning of `vertical-motion' better, and its differences from GNU Emacs.
author ben
date Fri, 07 Feb 2003 11:50:54 +0000
parents f5d8712231af
children c2580215c222
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1 -*- Text -*-
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3 This is the file .../info/dir, which contains the topmost node of the Info
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4 hierarchy. The first time you invoke Info you start off looking at that node,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5 which is (dir)Top.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 Rather than adding new nodes to this directory (and this file) it is a better
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 idea to put them in a site-local directory, and then configure info to search
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9 in that directory as well. That way, you won't have to re-edit this file when
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10 a new release of the editor comes out.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 For example, you could add this code to .../lisp/site-start.el, which is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13 loaded before ~/.emacs each time the editor starts up:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 ;; find local info nodes
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16 (setq Info-directory-list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 (append Info-directory-list '("/private/info/")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 Then, when you enter info, a dir file like this one will be automatically
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 created and saved (provided you have write access to the directory). The
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21 contents of that file "/private/info/dir" will be appended to the contents of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 this file.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 File: dir Node: Top This is the top of the INFO tree
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27 This is Info, the online documentation browsing system.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28 This page (the Directory node) gives a menu of major topics.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29
1092
f5d8712231af [xemacs-hg @ 2002-11-11 14:19:07 by stephent]
stephent
parents: 721
diff changeset
30 button2 on a highlighted word follows that cross-reference.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 button3 anywhere brings up a menu of commands.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 ? lists additional keyboard commands.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 h invokes the Info tutorial.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 * Menu:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36
697
7a42cc017e59 [xemacs-hg @ 2001-12-16 10:26:55 by adrian]
adrian
parents: 462
diff changeset
37 XEmacs 21.5
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
38 ===========
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
39 * XEmacs:: XEmacs User's Manual.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
40 * Lispref:: XEmacs Lisp Reference Manual.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
41 * New-Users-Guide:: Getting Started with XEmacs.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
42 * XEmacs-FAQ:: XEmacs Frequently Asked Questions for 21.4.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
43 * Info:: Guide to Info, the XEmacs online documentation system.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
44 * Internals:: Guide to the internals of XEmacs.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
45
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
46 Other Documentation:
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
47
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
48 * CL:: A Common Lisp compatibility package for Emacs-Lisp.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
49 * Custom:: Customization Library for Emacs.
721
f72a191f8ecf [xemacs-hg @ 2002-01-02 20:56:32 by adrian]
adrian
parents: 697
diff changeset
50 * Emodules:: XEmacs dynamically loadable module support.
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
51 * External-Widget:: Use XEmacs as a text widget inside of another program.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
52 * Standards:: GNU coding standards.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
53 * Term:: A mode to control inferior processes (a comint replacement)
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
54 * Termcap:: The termcap library, which enables application programs
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
55 to handle all types of character-display terminals.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
56 * Texinfo:: The GNU documentation format.
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
57 * Widget:: An Emacs Lisp widget library.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58