annotate etc/NEWS @ 97:498bf5da1c90

Added tag r20-0final for changeset dbb370e3c29e
author cvs
date Mon, 13 Aug 2007 09:12:43 +0200
parents 99da576a67e7
children cf808b4c4290
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 -*- mode:outline; minor-mode:outl-mouse -*-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 * Introduction
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 ==============
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6 This file presents some general information about XEmacs. It is primarily
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 about the evolution of XEmacs and its release history.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 There are five sections.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 Introduction................(this section) provides an introduction
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 Using Outline Mode..........briefly explains how to use outline mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 The History of XEmacs.......some historical notes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
17 What's Different?...........new or changed capabilities
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
18
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
19 XEmacs Release Notes........details of the changes between releases
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
20
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
21 New users should look at the next section on "Using Outline Mode". You will
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
22 be more efficient when you can navigate quickly through this file. Users
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
23 interested in some of the details of how XEmacs differs from FSF GNU Emacs
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
24 should read the section "What's Different?". Users who would to know which
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
25 capabilities have been introduced in each release should look at the
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
26 appropriate subsection of the "XEmacs Release Notes."
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
27
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
28 N.B. The term "FSF GNU Emacs" refers to any release of Emacs Version 19
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
29 from the Free Software Foundation's GNU Project. (We do not say just
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
30 "GNU Emacs" because Richard M. Stallman ["RMS"] thinks that this term
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
31 is too generic; although we sometimes say e.g. "GNU Emacs 19.30" to refer
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
32 to a specific version of FSF GNU Emacs. We do not say merely "Emacs", as
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
33 RMS prefers, because that is clearly an even more generic term.) The term
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
34 "XEmacs" refers to this program or to its predecessors "Era" and
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
35 "Lucid Emacs". The predecessor of all these program is called "Emacs 18".
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
36 When no particular version is implied, "Emacs" will be used.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39 * Using Outline Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 ====================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 This file is in outline mode, a major mode for viewing (or editing)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43 outlines. It allows you to make parts of the text temporarily invisible so
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 that you can see just the overall structure of the outline.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 There are two ways of using outline mode: with keys or with menus. Using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 outline mode with menus is the simplest and is just as effective as using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48 keystrokes. There are menus for outline mode on the menubar as well as in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 popup menus activated by pressing mouse button 3.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
51 Experiment with the menu commands. Menu items under "Headings" allow
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
52 you to navigate from heading to heading. Menu items under "Show" make
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
53 visible portions of the outline while menu items under "Hide" do the
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
54 opposite.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
55
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
56 A special minor mode called "outl-mouse" has been automatically enabled. In
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
57 this minor mode, glyphs appear which, when clicked on, will alternately hide
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
58 or show sections of the outline.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
59
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60 You may at any time press `C-h m' to get a listing of the outline mode key
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
61 bindings. They are reproduced here:
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
62
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
63 Commands:
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
64 C-c C-n outline-next-visible-heading move by visible headings
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
65 C-c C-p outline-previous-visible-heading
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
66 C-c C-f outline-forward-same-level similar but skip subheadings
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
67 C-c C-b outline-backward-same-level
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
68 C-c C-u outline-up-heading move from subheading to heading
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
69
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
70 C-c C-t make all text invisible (not headings).
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
71 M-x show-all make everything in buffer visible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
72
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
73 The remaining commands are used when point is on a heading line.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
74 They apply to some of the body or subheadings of that heading.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
75 C-c C-d hide-subtree make body and subheadings invisible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
76 C-c C-s show-subtree make body and subheadings visible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
77 C-c tab show-children make direct subheadings visible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
78 No effect on body, or subheadings 2 or more levels down.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
79 With arg N, affects subheadings N levels down.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
80 C-c C-c make immediately following body invisible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
81 C-c C-e make it visible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
82 C-c C-l make body under heading and under its subheadings invisible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
83 The subheadings remain visible.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
84 C-c C-k make all subheadings at all levels visible.x1
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
85
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87 * The History of XEmacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 =======================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 This product is an extension of GNU Emacs, previously known to some as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91 "Lucid Emacs" or "ERA". It was initially based on an early version of Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 Version 19 from the Free Software Foundation and has since been kept
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 up-to-date with recent versions of that product. It stems from a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 collaboration of Lucid, Inc. with SunSoft DevPro (a division of Sun
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95 Microsystems, Inc.; formerly called SunPro) and the University of Illinois.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
97 NOTE: Lucid, Inc. is currently out of business but development on XEmacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
98 continues strong. Recently, Amdahl Corporation and INS Engineering have
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
99 both contributed significantly to the development of XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
100
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
101
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
102 * What's Different?
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
103 ===================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
104
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
105
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
106 ** Differences between XEmacs and FSF GNU Emacs 19
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
107 ==================================================
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
108 In XEmacs 20, characters are first-class objects. Characters can be
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
109 converted to integers, but are not integers. FSF 19, XEmacs 19, and Mule
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
110 represent them as integers.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
111
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
112 In XEmacs, events are first-class objects. FSF 19 represents them as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
113 integers, which obscures the differences between a key gesture and the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
114 ancient ASCII code used to represent a particular overlapping subset of them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
115
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
116 In XEmacs, keymaps are first-class opaque objects. FSF 19 represents them as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
117 complicated combinations of association lists and vectors. If you use the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
118 advertised functional interface to manipulation of keymaps, the same code
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
119 will work in XEmacs, Emacs 18, and FSF GNU Emacs 19; if your code depends
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
120 on the underlying implementation of keymaps, it will not.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
121
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
122 XEmacs uses "extents" to represent all non-textual aspects of buffers;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
123 FSF 19 uses two distinct objects, "text properties" and "overlays",
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
124 which divide up the functionality between them. Extents are a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
125 superset of the functionality of the two FSF data types. The full FSF
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
126 19 interface to text properties is supported in XEmacs (with extents
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
127 being the underlying representation).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
128
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
129 Extents can be made to be copied into strings, and thus restored by kill
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
130 and yank. Thus, one can specify this behavior on either "extents" or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
131 "text properties", whereas in FSF 19 text properties always have this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
132 behavior and overlays never do.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
133
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
134 Many more packages are provided standard with XEmacs than with FSF 19.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
135
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
136 Pixmaps of arbitrary size can be embedded in a buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
137
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
138 Variable width fonts work.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
139
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
140 The height of a line is the height of the tallest font on that line, instead
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
141 of all lines having the same height.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
142
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
143 XEmacs uses the MIT "Xt" toolkit instead of raw Xlib calls, which
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
144 makes it be a more well-behaved X citizen (and also improves
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
145 portability). A result of this is that it is possible to include
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
146 other Xt "Widgets" in the XEmacs window. Also, XEmacs understands the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
147 standard Xt command-line arguments.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
148
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
149 XEmacs provides support for ToolTalk on systems that have it.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
150
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
151 XEmacs can ask questions using popup dialog boxes. Any command executed from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
152 a menu will ask yes/no questions with dialog boxes, while commands executed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
153 via the keyboard will use the minibuffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
154
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
155 XEmacs has a built-in toolbar. Four toolbars can actually be configured:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
156 top, bottom, left, and right toolbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
157
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
158 XEmacs has vertical and horizontal scrollbars. Unlike in FSF 19 (which
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
159 provides a primitive form of vertical scrollbar), these are true toolkit
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
160 scrollbars. A look-alike Motif scrollbar is provided for those who
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
161 don't have Motif. (Even for those who do, the look-alike may be preferable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
162 as it is faster.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
163
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
164 If you're running on a machine with audio hardware, you can specify sound
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
165 files for XEmacs to play instead of the default X beep. See the documentation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
166 of the function load-sound-file and the variable sound-alist.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
167
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
168 An XEmacs frame can be placed within an "external client widget" managed by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
169 another application. This allows an application to use an XEmacs frame as its
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
170 text pane rather than the standard Text widget that is provided with Motif or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
171 Athena. XEmacs supports Motif applications, generic Xt (e.g. Athena)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
172 applications, and raw Xlib applications.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
173
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
174 Here are some more specifics about the XEmacs implementation:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
175
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
176 *** The Input Model
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
177 -------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
178
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
179 The fundamental unit of input is an "event" instead of a character. An
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
180 event is a new data type that contains several pieces of information.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
181 There are several kinds of event, and corresponding accessor and utility
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
182 functions. We tried to abstract them so that they would apply equally
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
183 well to a number of window systems.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
184
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
185 NOTE: All timestamps are measured as milliseconds since Emacs started.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
186
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
187 key_press_event
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
188 event_channel A token representing which keyboard generated it.
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
189 For this kind of event, this is a console object.
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
190 timestamp When it happened
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
191 key What keysym this is; a character or a symbol.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
192 If it is a character, it will be a printing
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
193 ASCII character.
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
194 modifiers Bucky-bits on that key: control, meta, etc.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
195 For most keys, Shift is not a bit; that is implicit
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
196 in the keyboard layout.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
197
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
198 button_press_event
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
199 button_release_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
200 event_channel A token representing which mouse generated it.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
201 For this kind of event, this is a frame object.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
202 timestamp When it happened
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
203 button What button went down or up.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
204 modifiers Bucky-bits on that button: shift, control, meta, etc.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
205 x, y Where it was at the button-state-change (in pixels).
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
206
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
207 pointer_motion_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
208 event_channel A token representing which mouse generated it.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
209 For this kind of event, this is a frame object.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
210 timestamp When it happened
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
211 x, y Where it was after it moved (in pixels).
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
212 modifiers Bucky-bits down when the motion was detected.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
213 (Possibly not all window systems will provide this?)
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
214
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
215 process_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
216 timestamp When it happened
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
217 process the emacs "process" object in question
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
218
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
219 timeout_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
220 timestamp Now (really, when the timeout was signaled)
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
221 interval_id The ID returned when the associated call to
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
222 add_timeout_cb() was made
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
223 ------ the rest of the fields are filled in by Emacs -----
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
224 id_number The Emacs timeout ID for this timeout (more
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
225 than one timeout event can have the same value
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
226 here, since Emacs timeouts, as opposed to
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
227 add_timeout_cb() timeouts, can resignal
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
228 themselves)
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
229 function An elisp function to call when this timeout is
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
230 processed.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
231 object The object passed to that function.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
232
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
233 eval_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
234 timestamp When it happened
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
235 function An elisp function to call with this event object.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
236 object Anything.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
237 This kind of event is used internally; sometimes the
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
238 window system interface would like to inform emacs of
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
239 some user action (such as focusing on another frame)
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
240 but needs that to happen synchronously with the other
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
241 user input, like keypresses. This is useful when
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
242 events are reported through callbacks rather
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
243 than in the standard event stream.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
244
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
245 misc_user_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
246 timestamp When it happened
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
247 function An elisp function to call with this event object.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
248 object Anything.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
249 This is similar to an eval_event, except that it is
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
250 generated by user actions: selections in the
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
251 menubar or scrollbar actions. It is a "command"
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
252 event, like key and mouse presses (and unlike mouse
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
253 motion, process output, and enter and leave window
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
254 hooks). In many ways, eval_events are not the same
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
255 as keypresses or misc_user_events.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
256
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
257 magic_event
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
258 No user-serviceable parts within. This is for things
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
259 like KeymapNotify and ExposeRegion events and so on
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
260 that emacs itself doesn't care about, but which it
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
261 must do something with for proper interaction with
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
262 the window system.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
263
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
264 Magic_events are handled somewhat asynchronously, just
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
265 like subprocess filters. However, occasionally a
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
266 magic_event needs to be handled synchronously; in that
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
267 case, the asynchronous handling of the magic_event will
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
268 push an eval_event back onto the queue, which will be
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
269 handled synchronously later. This is one of the
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
270 reasons why eval_events exist; I'm not entirely happy
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
271 with this aspect of this event model.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
272
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
273
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
274 The function `next-event' blocks and returns one of the above-described
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
275 event objects. The function `dispatch-event' takes an event and processes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
276 it in the appropriate way.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
277
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
278 For a process-event, dispatch-event calls the process's handler; for a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
279 mouse-motion event, the mouse-motion-handler hook is called, and so on.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
280 For magic-events, dispatch-event does window-system-dependent things,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
281 including calling some non-window-system-dependent hooks: map-frame-hook,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
282 unmap-frame-hook, mouse-enter-frame-hook, and mouse-leave-frame-hook.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
283
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
284 The function `next-command-event' calls `next-event' until it gets a key or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
285 button from the user (that is, not a process, motion, timeout, or magic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
286 event). If it gets an event that is not a key or button, it calls
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
287 `dispatch-event' on it immediately and reads another one. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
288 next-command-event function could be implemented in Emacs Lisp, though it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
289 isn't. Generally one should call `next-command-event' instead of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
290 `next-event'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
291
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
292 read-char calls next-command-event; if it doesn't get an event that can be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
293 converted to an ASCII character, it signals an error. Otherwise it returns
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
294 an integer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
295
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
296 The variable `last-command-char' always contains an integer, or nil (if the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
297 last read event has no ASCII equivalent, as when it is a mouse-click or a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
298 non-ASCII character chord.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
299
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
300 The new variable `last-command-event' holds an event object, that could be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
301 a non-ASCII character, a button click, a menu selection, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
302
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
303 The variable `unread-command-char' no longer exists, and has been replaced
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
304 by `unread-command-events'. With the new event model, it is incorrect for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
305 code to do (setq unread-command-char (read-char)), because all user-input
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
306 can't be represented as ASCII characters. *** This is an incompatible
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
307 change. Code which sets `unread-command-char' must be updated to use the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
308 combination of `next-command-event' and `unread-command-events' instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
309
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
310 The functions `this-command-keys' and `recent-keys' return a vector of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
311 event objects, instead of a string of ASCII characters. *** This also
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
312 is an incompatible change.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
313
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
314 Almost nothing happens at interrupt level; the SIGIO handler simply sets a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
315 flag, and later, the X event queue is scanned for KeyPress events which map
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
316 to ^G. All redisplay happens in the main thread of the process.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
317
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
318
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
319 *** Keymaps
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
320 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
321
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
322 Instead of keymaps being alists or obarrays, they are a new primary data
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
323 type. The only user access to the contents of a keymap is through the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
324 existing keymap-manipulation functions, and a new function, map-keymap.
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
325 This means that existing code that manipulates keymaps may need to
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
326 be changed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
327
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
328 One of our goals with the new input and keymap code was to make more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
329 character combinations available for binding, besides just ASCII and
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
330 function keys. We want to be able bind different commands to Control-a
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
331 and Control-Shift-a; we also want it to be possible for the keys Control-h
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
332 and Backspace (and Control-M and Return, and Control-I and Tab, etc) to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
333 be distinct.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
334
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
335 One of the most common complaints that new Emacs users have is that backspace
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
336 is help. The answer is to play around with the keyboard-translate-table, or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
337 be lucky enough to have a system administrator who has done this for you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
338 already; but if it were possible to bind backspace and C-h to different
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
339 things, then (under a window manager at least) both backspace and delete
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
340 would delete a character, and ^H would be help. There's no need to deal
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
341 with xmodmap, kbd-translate-table, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
342
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
343 Here are some more examples: suppose you want to bind one function to Tab,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
344 and another to Control-Tab. This can't be done if Tab and Control-I are the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
345 same thing. What about control keys that have no ASCII equivalent, like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
346 Control-< ? One might want that to be bound to set-mark-at-point-min. We
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
347 want M-C-Backspace to be kill-backward-sexp. But we want M-Backspace to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
348 kill-backward-word. Again, this can't be done if Backspace and C-h are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
349 indistinguishable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
350
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
351 The user represents keys as a string of ASCII characters (when possible and
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
352 convenient), or as a vector of event objects, or as a vector of "key
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
353 description lists", that looks like (control a), or (control meta delete)
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
354 or (shift f1). The order of the modifier-names is not significant, so
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
355 (meta control x) and (control meta x) are the same.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
356
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
357 `define-key' knows how to take any of the above representations and store them
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
358 into a keymap. When Emacs wants to return a key sequence (this-command-keys,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
359 recent-keys, keyboard-macros, and read-key-sequence, for example) it returns
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
360 a vector of event objects. Keyboard macros can also be represented as ASCII
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
361 strings or as vectors of key description lists.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
362
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
363 This is an incompatible change: code which calls `this-command-keys',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
364 `recent-keys', `read-key-sequence', or manipulates keyboard-macros probably
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
365 needs to be changed so that it no longer assumes that the returned value is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
366 string.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
367
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
368 Control-Shift-a is specified as (control A), not (control shift a), since A
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
369 is a two-case character. But for keys that don't have an upper case
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
370 version, like F1, Backspace, and Escape, you use the (shift backspace) syntax.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
371
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
372 See the doc string for our version of define-key, reproduced below in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
373 `Changed Functions' section. Note that when the KEYS argument is a string,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
374 it has the same semantics as the v18 define-key.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
375
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
376
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
377 *** Xt Integration
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
378 ------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
379
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
380 The heart of the event loop is implemented in terms of the Xt event functions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
381 (specifically XtAppProcessEvent), and uses Xt's concept of timeouts and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
382 file-descriptor callbacks, eliminating a large amount of system-dependent code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
383 (Xt does it for you.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
384
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
385 If Emacs is compiled with support for X, it uses the Xt event loop even when
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
386 Emacs is not running on an X display (the Xt event loop supports this). This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
387 makes it possible to run Emacs on a dumb TTY, and later connect it to one or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
388 more X servers. It should also be possible to later connect an existing Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
389 process to additional TTY's, although this code is still experimental. (Our
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
390 intent at this point is not to have an Emacs that is being used by multiple
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
391 people at the same time: it is to make it possible for someone to go home, log
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
392 in on a dialup line, and connect to the same Emacs process that is running
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
393 under X in their office without having to recreate their buffer state and so
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
394 on.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
395
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
396 If Emacs is not compiled with support for X, then it instead uses more general
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
397 code, something like what v18 does; but this way of doing things is a lot more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
398 modular.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
399
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
400 (Linking Emacs with Xt seems to only add about 300k to the executable size,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
401 compared with an Emacs linked with Xlib only.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
402
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
403
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
404 *** Region Highlighting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
405 -----------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
406
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
407 If the variable `zmacs-regions' is true, then the region between point and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
408 mark will be highlighted when "active". Those commands which push a mark
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
409 (such as C-SPC, and C-x C-x) make the region become "active" and thus
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
410 highlighted. Most commands (all non-motion commands, basically) cause it to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
411 become non-highlighted (non-"active"). Commands that operate on the region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
412 (such as C-w, C-x C-l, etc.) only work if the region is in the highlighted
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
413 state.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
414
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
415 zmacs-activate-region-hook and zmacs-deactivate-region-hook are run at the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
416 appropriate times; under X, zmacs-activate-region-hook makes the X selection
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
417 be the region between point and mark, thus doing two things at once: making
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
418 the region and the X selection be the same; and making the region highlight
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
419 in the same way as the X selection.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
420
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
421 If `zmacs-regions' is true, then the `mark-marker' command returns nil unless
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
422 the region is currently in the active (highlighted) state. With an argument
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
423 of t, this returns the mark (if there is one) regardless of the active-region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
424 state. You should *generally* not use the mark unless the region is active,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
425 if the user has expressed a preference for the active-region model. Watch
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
426 out! Moving this marker changes the mark position. If you set the marker not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
427 to point anywhere, the buffer will have no mark.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
428
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
429 In this way, the primary selection is a fairly transitory entity; but
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
430 when something is copied to the kill ring, it is made the Clipboard
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
431 selection. It is also stored into CUT_BUFFER0, for compatibility with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
432 X applications that don't understand selections (like Emacs18).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
433
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
434 Compatibility note: if you have code which uses (mark) or (mark-marker),
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
435 then you need to either: change those calls to (mark t) or (mark-marker t);
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
436 or simply bind `zmacs-regions' to nil around the call to mark or mark-marker.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
437 This is probably the best solution, since it will work in Emacs 18 as well.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
438
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
439
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
440 *** Menubars and Dialog Boxes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
441 -----------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
442
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
443 Here is an example of a menubar definition:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
444
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
445 (defvar default-menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
446 '(("File" ["Open File..." find-file t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
447 ["Save Buffer" save-buffer t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
448 ["Save Buffer As..." write-file t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
449 ["Revert Buffer" revert-buffer t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
450 "-----"
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
451 ["Print Buffer" lpr-buffer t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
452 "-----"
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
453 ["Delete Frame" delete-frame t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
454 ["Kill Buffer..." kill-buffer t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
455 ["Exit Emacs" save-buffers-kill-emacs t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
456 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
457 ("Edit" ["Undo" advertised-undo t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
458 ["Cut" kill-primary-selection t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
459 ["Copy" copy-primary-selection t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
460 ["Paste" yank-clipboard-selection t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
461 ["Clear" delete-primary-selection t]
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
462 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
463 ...))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
464
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
465 The first element of each menu item is the string to print on the menu.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
466
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
467 The second element is the callback function; if it is a symbol, it is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
468 invoked with `call-interactively.' If it is a list, it is invoked with
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
469 `eval'.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
470
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
471 If the second element is a symbol, then the menu also displays the key that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
472 is bound to that command (if any).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
473
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
474 The third element of the menu items determines whether the item is selectable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
475 It may be t, nil, or a form to evaluate. Also, a hook is run just before a
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
476 menu is exposed, which can be used to change the value of these slots.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
477 For example, there is a hook that makes the "undo" menu item be selectable
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
478 only in the cases when `advertised-undo' would not signal an error.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
479
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
480 Menus may have other menus nested within them; they will cascade.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
481
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
482 There are utility functions for adding items to menus, deleting items,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
483 disabling them, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
484
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
485 The function `popup-menu' takes a menu description and pops it up.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
486
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
487 The function `popup-dialog-box' takes a dialog-box description and pops
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
488 it up. Dialog box descriptions look a lot like menu descriptions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
489
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
490 The menubar, menu, and dialog-box code is implemented as a library,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
491 with an interface which hides the toolkit that implements it.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
492
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
493
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
494 *** Isearch Changes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
495 -------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
496
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
497 Isearch has been reimplemented in a different way, adding some new features,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
498 and causing a few incompatible changes.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
499
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
500 - the old isearch-*-char variables are no longer supported. In the old
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
501 system, one could make ^A mean "repeat the search" by doing something
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
502 like (setq search-repeat-char ?C-a). In the new system, this is
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
503 accomplished with
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
504
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
505 (define-key isearch-mode-map "\C-a" 'isearch-repeat-forward)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
506
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
507 - The advantage of using the normal keymap mechanism for this is that you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
508 can bind more than one key to an isearch command: for example, both C-a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
509 and C-s could do the same thing inside isearch mode. You can also bind
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
510 multi-key sequences inside of isearch mode, and bind non-ASCII keys.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
511 For example, to use the F1 key to terminate a search:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
512
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
513 (define-key isearch-mode-map 'f1 'isearch-exit)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
514
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
515 or to make ``C-c C-c'' terminate a search:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
516
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
517 (define-key isearch-mode-map "\C-c\C-c" 'isearch-exit)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
518
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
519 - If isearch is behaving case-insensitively (the default) and you type an
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
520 upper case character, then the search will become case-sensitive. This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
521 can be disabled by setting `search-caps-disable-folding' to nil.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
522
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
523 - There is a history ring of the strings previously searched for; typing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
524 M-p or M-n while searching will cycle through this ring. Typing M-TAB
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
525 will do completion across the set of items in the history ring.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
526
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
527 - The ESC key is no longer used to terminate an incremental search. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
528 RET key should be used instead. This change is necessary for it to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
529 possible to bind "meta" characters to isearch commands.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
530
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
531
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
532 *** Startup Code Changes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
533 ------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
534
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
535 The initial X frame is mapped before the user's .emacs file is executed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
536 Without this, there is no way for the user to see any error messages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
537 generated by their .emacs file, any windows created by the .emacs file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
538 don't show up, and the copyleft notice isn't shown.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
539
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
540 The default values for load-path, exec-path, lock-directory, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
541 Info-directory-list are not (necessarily) built into Emacs, but are
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
542 computed at startup time.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
543
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
544 First, Emacs looks at the directory in which its executable file resides:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
545
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
546 o If that directory contains subdirectories named "lisp" and "lib-src",
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
547 then those directories are used as the lisp library and exec directory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
548
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
549 o If the parent of the directory in which the emacs executable is located
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
550 contains "lisp" and "lib-src" subdirectories, then those are used.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
551
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
552 o If ../lib/xemacs-<version> (starting from the directory in which the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
553 emacs executable is located) contains a "lisp" subdirectory and either
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
554 a "lib-src" subdirectory or a <configuration-name> subdirectory, then
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
555 those are used.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
556
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
557 o If the emacs executable that was run is a symbolic link, then the link
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
558 is chased, and the resultant directory is checked as above.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
559
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
560 (Actually, it doesn't just look for "lisp/", it looks for "lisp/prim/",
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
561 which reduces the chances of a false positive.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
562
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
563 If the lisp directory contains subdirectories, they are added to the default
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
564 load-path as well. If the site-lisp directory exists and contains
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
565 subdirectories, they are then added. Subdirectories whose names begin with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
566 a dot or a hyphen are not added to the load-path.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
567
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
568 These heuristics fail if the Emacs binary was copied from the main Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
569 tree to some other directory, and links for the lisp directory were not put
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
570 in. This isn't much of a restriction: either make there be subdirectories
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
571 (or symbolic links) of the directory of the emacs executable, or make the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
572 "installed" emacs executable be a symbolic link to an executable in a more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
573 appropriate directory structure. For example, this setup works:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
574
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
575 /usr/local/xemacs/xemacs* ; The executable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
576 /usr/local/xemacs/lisp/ ; The associated directories.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
577 /usr/local/xemacs/etc/ ; Any of the files in this list
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
578 /usr/local/xemacs/lock/ ; could be symbolic links as well.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
579 /usr/local/xemacs/info/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
580
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
581 As does this:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
582
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
583 /usr/local/bin/xemacs -> ../xemacs/src/xemacs-19.14 ; A link...
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
584 /usr/local/xemacs/src/xemacs-19.14* ; The executable,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
585 /usr/local/xemacs/lisp/ ; and the rest of
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
586 /usr/local/xemacs/etc/ ; the source tree
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
587 /usr/local/xemacs/lock/
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
588 /usr/local/xemacs/info/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
589
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
590 This configuration might be used for a multi-architecture installation; assume
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
591 that $LOCAL refers to a directory which contains only files specific to a
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
592 particular architecture (i.e., executables) and $SHARED refers to those files
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
593 which are not machine specific (i.e., lisp code and documentation.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
594
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
595 $LOCAL/bin/xemacs@ -> $LOCAL/xemacs-19.14/xemacs*
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
596 $LOCAL/xemacs-19.14/lisp@ -> $SHARED/xemacs-19.14/lisp/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
597 $LOCAL/xemacs-19.14/etc@ -> $SHARED/xemacs-19.14/etc/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
598 $LOCAL/xemacs-19.14/info@ -> $SHARED/xemacs-19.14/info/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
599
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
600 The following would also work, but the above is probably more attractive:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
601
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
602 $LOCAL/bin/xemacs*
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
603 $LOCAL/bin/lisp@ -> $SHARED/xemacs-19.14/lisp/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
604 $LOCAL/bin/etc@ -> $SHARED/xemacs-19.14/etc/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
605 $LOCAL/bin/info@ -> $SHARED/xemacs-19.14/info/
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
606
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
607 If Emacs can't find the requisite directories, it writes a message like this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
608 (or some appropriate subset of it) to stderr:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
609
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
610 WARNING:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
611 couldn't find an obvious default for load-path, exec-directory, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
612 lock-directory, and there were no defaults specified in paths.h when
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
613 Emacs was built. Perhaps some directories don't exist, or the Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
614 executable, /cadillac-th/jwz/somewhere/xemacs is in a strange place?
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
615
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
616 Without both exec-directory and load-path, Emacs will be very broken.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
617 Consider making a symbolic link from /cadillac-th/jwz/somewhere/etc
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
618 to wherever the appropriate Emacs etc/ directory is, and from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
619 /cadillac-th/jwz/somewhere/lisp/ to wherever the appropriate Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
620 lisp library is.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
621
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
622 Without lock-directory set, file locking won't work. Consider
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
623 creating /cadillac-th/jwz/somewhere/lock as a directory or symbolic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
624 link for use as the lock directory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
625
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
626 The default installation tree is the following:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
627
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
628 /usr/local/bin/b2m ;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
629 ctags ; executables that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
630 emacsclient ; should be in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
631 etags ; user's path
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
632 xemacs -> xemacs-<version> ;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
633 xemacs ;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
634 /usr/local/lib/xemacs/site-lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
635 /usr/local/lib/xemacs/lock
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
636 /usr/local/lib/xemacs-<version>/etc ; architecture ind. files
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
637 /usr/local/lib/xemacs-<version>/info
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
638 /usr/local/lib/xemacs-<version>/lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
639 /usr/local/lib/xemacs-<version>/<configuration> ; binaries emacs may run
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
640
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
641
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
642 *** X Resources
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
643 ---------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
644
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
645 (Note: This section is copied verbatim from the XEmacs Reference Manual.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
646
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
647 The Emacs resources are generally set per-frame. Each Emacs frame
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
648 can have its own name or the same name as another, depending on the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
649 name passed to the `make-frame' function.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
650
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
651 You can specify resources for all frames with the syntax:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
652
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
653 Emacs*parameter: value
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
654
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
655 or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
656
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
657 Emacs*EmacsFrame.parameter:value
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
658
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
659 You can specify resources for a particular frame with the syntax:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
660
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
661 Emacs*FRAME-NAME.parameter: value
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
662
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
663
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
664 **** Geometry Resources
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
665 -----------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
666
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
667 To make the default size of all Emacs frames be 80 columns by 55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
668 lines, do this:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
669
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
670 Emacs*EmacsFrame.geometry: 80x55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
671
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
672 To set the geometry of a particular frame named `fred', do this:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
673
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
674 Emacs*fred.geometry: 80x55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
675
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
676 Important! Do not use the following syntax:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
677
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
678 Emacs*geometry: 80x55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
679
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
680 You should never use `*geometry' with any X application. It does not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
681 say "make the geometry of Emacs be 80 columns by 55 lines." It really
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
682 says, "make Emacs and all subwindows thereof be 80x55 in whatever units
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
683 they care to measure in." In particular, that is both telling the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
684 Emacs text pane to be 80x55 in characters, and telling the menubar pane
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
685 to be 80x55 pixels, which is surely not what you want.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
686
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
687 As a special case, this geometry specification also works (and sets
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
688 the default size of all Emacs frames to 80 columns by 55 lines):
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
689
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
690 Emacs.geometry: 80x55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
691
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
692 since that is the syntax used with most other applications (since most
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
693 other applications have only one top-level window, unlike Emacs). In
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
694 general, however, the top-level shell (the unmapped ApplicationShell
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
695 widget named `Emacs' that is the parent of the shell widgets that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
696 actually manage the individual frames) does not have any interesting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
697 resources on it, and you should set the resources on the frames instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
698
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
699 The `-geometry' command-line argument sets only the geometry of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
700 initial frame created by Emacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
701
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
702 A more complete explanation of geometry-handling is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
703
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
704 * The `-geometry' command-line option sets the `Emacs.geometry'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
705 resource, that is, the geometry of the ApplicationShell.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
706
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
707 * For the first frame created, the size of the frame is taken from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
708 the ApplicationShell if it is specified, otherwise from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
709 geometry of the frame.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
710
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
711 * For subsequent frames, the order is reversed: First the frame, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
712 then the ApplicationShell.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
713
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
714 * For the first frame created, the position of the frame is taken
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
715 from the ApplicationShell (`Emacs.geometry') if it is specified,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
716 otherwise from the geometry of the frame.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
717
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
718 * For subsequent frames, the position is taken only from the frame,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
719 and never from the ApplicationShell.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
720
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
721 This is rather complicated, but it does seem to provide the most
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
722 intuitive behavior with respect to the default sizes and positions of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
723 frames created in various ways.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
724
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
725
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
726 **** Iconic Resources
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
727 ---------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
728
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
729 Analogous to `-geometry', the `-iconic' command-line option sets the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
730 iconic flag of the ApplicationShell (`Emacs.iconic') and always applies
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
731 to the first frame created regardless of its name. However, it is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
732 possible to set the iconic flag on particular frames (by name) by using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
733 the `Emacs*FRAME-NAME.iconic' resource.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
734
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
735
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
736 **** Resource List
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
737 ------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
738
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
739 Emacs frames accept the following resources:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
740
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
741 `geometry' (class `Geometry'): string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
742 Initial geometry for the frame. *Note Geometry Resources:: for a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
743 complete discussion of how this works.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
744
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
745 `iconic' (class `Iconic'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
746 Whether this frame should appear in the iconified state.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
747
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
748 `internalBorderWidth' (class `InternalBorderWidth'): int
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
749 How many blank pixels to leave between the text and the edge of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
750 window.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
751
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
752 `interline' (class `Interline'): int
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
753 How many pixels to leave between each line (may not be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
754 implemented).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
755
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
756 `menubar' (class `Menubar'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
757 Whether newly-created frames should initially have a menubar. Set
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
758 to true by default.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
759
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
760 `initiallyUnmapped' (class `InitiallyUnmapped'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
761 Whether XEmacs should leave the initial frame unmapped when it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
762 starts up. This is useful if you are starting XEmacs as a server
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
763 (e.g. in conjunction with gnuserv or the external client widget).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
764 You can also control this with the `-unmapped' command-line option.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
765
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
766 `barCursor' (class `BarColor'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
767 Whether the cursor should be displayed as a bar, or the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
768 traditional box.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
769
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
770 `textPointer' (class `Cursor'): cursor-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
771 The cursor to use when the mouse is over text. This resource is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
772 used to initialize the variable `x-pointer-shape'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
773
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
774 `selectionPointer' (class `Cursor'): cursor-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
775 The cursor to use when the mouse is over a selectable text region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
776 (an extent with the `highlight' property; for example, an Info
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
777 cross-reference). This resource is used to initialize the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
778 `x-selection-pointer-shape'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
779
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
780 `spacePointer' (class `Cursor'): cursor-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
781 The cursor to use when the mouse is over a blank space in a buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
782 (that is, after the end of a line or after the end-of-file). This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
783 resource is used to initialize the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
784 `x-nontext-pointer-shape'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
785
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
786 `modeLinePointer' (class `Cursor'): cursor-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
787 The cursor to use when the mouse is over a mode line. This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
788 resource is used to initialize the variable `x-mode-pointer-shape'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
789
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
790 `gcPointer' (class `Cursor'): cursor-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
791 The cursor to display when a garbage-collection is in progress.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
792 This resource is used to initialize the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
793 `x-gc-pointer-shape'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
794
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
795 `scrollbarPointer' (class `Cursor'): cursor-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
796 The cursor to use when the mouse is over the scrollbar. This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
797 resource is used to initialize the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
798 `x-scrollbar-pointer-shape'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
799
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
800 `pointerColor' (class `Foreground'): color-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
801 `pointerBackground' (class `Background'): color-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
802 The foreground and background colors of the mouse cursor. These
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
803 resources are used to initialize the variables
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
804 `x-pointer-foreground-color' and `x-pointer-background-color'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
805
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
806 `scrollBarWidth' (class `ScrollBarWidth'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
807 How wide the vertical scrollbars should be, in pixels; 0 means no
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
808 vertical scrollbars. You can also use a resource specification of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
809 the form `*scrollbar.width', or the usual toolkit scrollbar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
810 resources: `*XmScrollBar.width' (Motif), `*XlwScrollBar.width'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
811 (Lucid), or `*Scrollbar.thickness' (Athena). We don't recommend
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
812 that you use the toolkit resources, though, because they're
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
813 dependent on how exactly your particular build of XEmacs was
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
814 configured.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
815
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
816 `scrollBarHeight' (class `ScrollBarHeight'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
817 How high the horizontal scrollbars should be, in pixels; 0 means no
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
818 horizontal scrollbars. You can also use a resource specification
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
819 of the form `*scrollbar.height', or the usual toolkit scrollbar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
820 resources: `*XmScrollBar.height' (Motif), `*XlwScrollBar.height'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
821 (Lucid), or `*Scrollbar.thickness' (Athena). We don't recommend
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
822 that you use the toolkit resources, though, because they're
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
823 dependent on how exactly your particular build of XEmacs was
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
824 configured.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
825
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
826 `scrollBarPlacement' (class `ScrollBarPlacement'): string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
827 Where the horizontal and vertical scrollbars should be positioned.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
828 This should be one of the four strings `bottom-left',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
829 `bottom-right', `top-left', and `top-right'. Default is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
830 `bottom-right' for the Motif and Lucid scrollbars and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
831 `bottom-left' for the Athena scrollbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
832
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
833 `topToolBarHeight' (class `TopToolBarHeight'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
834 `bottomToolBarHeight' (class `BottomToolBarHeight'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
835 `leftToolBarWidth' (class `LeftToolBarWidth'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
836 `rightToolBarWidth' (class `RightToolBarWidth'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
837 Height and width of the four possible toolbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
838
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
839 `topToolBarShadowColor' (class `TopToolBarShadowColor'): color-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
840 `bottomToolBarShadowColor' (class `BottomToolBarShadowColor'): color-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
841 Color of the top and bottom shadows for the toolbars. NOTE: These
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
842 resources do *not* have anything to do with the top and bottom
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
843 toolbars (i.e. the toolbars at the top and bottom of the frame)!
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
844 Rather, they affect the top and bottom shadows around the edges of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
845 all four kinds of toolbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
846
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
847 `topToolBarShadowPixmap' (class `TopToolBarShadowPixmap'): pixmap-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
848 `bottomToolBarShadowPixmap' (class `BottomToolBarShadowPixmap'): pixmap-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
849 Pixmap of the top and bottom shadows for the toolbars. If set,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
850 these resources override the corresponding color resources. NOTE:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
851 These resources do *not* have anything to do with the top and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
852 bottom toolbars (i.e. the toolbars at the top and bottom of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
853 frame)! Rather, they affect the top and bottom shadows around the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
854 edges of all four kinds of toolbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
855
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
856 `toolBarShadowThickness' (class `ToolBarShadowThickness'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
857 Thickness of the shadows around the toolbars, in pixels.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
858
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
859 `visualBell' (class `VisualBell'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
860 Whether XEmacs should flash the screen rather than making an
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
861 audible beep.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
862
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
863 `bellVolume' (class `BellVolume'): integer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
864 Volume of the audible beep.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
865
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
866 `useBackingStore' (class `UseBackingStore'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
867 Whether XEmacs should set the backing-store attribute of the X
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
868 windows it creates. This increases the memory usage of the X
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
869 server but decreases the amount of X traffic necessary to update
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
870 the screen, and is useful when the connection to the X server goes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
871 over a low-bandwidth line such as a modem connection.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
872
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
873
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
874 **** Face Resources
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
875 -------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
876
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
877 The attributes of faces are also per-frame. They can be specified as:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
878
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
879 Emacs.FACE_NAME.parameter: value
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
880
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
881 (*do not* use `Emacs*FACE_NAME...')
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
882
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
883 or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
884
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
885 Emacs*FRAME_NAME.FACE_NAME.parameter: value
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
886
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
887 Faces accept the following resources:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
888
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
889 `attributeFont' (class `AttributeFont'): font-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
890 The font of this face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
891
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
892 `attributeForeground' (class `AttributeForeground'): color-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
893 `attributeBackground' (class `AttributeBackground'): color-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
894 The foreground and background colors of this face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
895
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
896 `attributeBackgroundPixmap' (class `AttributeBackgroundPixmap'): file-name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
897 The name of an XBM file (or XPM file, if your version of Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
898 supports XPM), to use as a background stipple.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
899
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
900 `attributeUnderline' (class `AttributeUnderline'): boolean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
901 Whether text in this face should be underlined.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
902
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
903 All text is displayed in some face, defaulting to the face named
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
904 `default'. To set the font of normal text, use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
905 `Emacs*default.attributeFont'. To set it in the frame named `fred', use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
906 `Emacs*fred.default.attributeFont'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
907
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
908 These are the names of the predefined faces:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
909
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
910 `default'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
911 Everything inherits from this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
912
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
913 `bold'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
914 If this is not specified in the resource database, Emacs tries to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
915 find a bold version of the font of the default face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
916
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
917 `italic'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
918 If this is not specified in the resource database, Emacs tries to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
919 find an italic version of the font of the default face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
920
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
921 `bold-italic'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
922 If this is not specified in the resource database, Emacs tries to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
923 find a bold-italic version of the font of the default face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
924
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
925 `modeline'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
926 This is the face that the modeline is displayed in. If not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
927 specified in the resource database, it is determined from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
928 default face by reversing the foreground and background colors.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
929
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
930 `highlight'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
931 This is the face that highlighted extents (for example, Info
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
932 cross-references and possible completions, when the mouse passes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
933 over them) are displayed in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
934
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
935 `left-margin'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
936 `right-margin'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
937 These are the faces that the left and right annotation margins are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
938 displayed in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
939
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
940 `zmacs-region'
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
941 This is the face that mouse selections are displayed in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
942
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
943 `text-cursor'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
944 This is the face that the cursor is displayed in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
945
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
946 `isearch'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
947 This is the face that the matched text being searched for is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
948 displayed in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
949
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
950 `info-node'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
951 This is the face of info menu items. If unspecified, it is copied
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
952 from `bold-italic'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
953
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
954 `info-xref'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
955 This is the face of info cross-references. If unspecified, it is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
956 copied from `bold'. (Note that, when the mouse passes over a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
957 cross-reference, the cross-reference's face is determined from a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
958 combination of the `info-xref' and `highlight' faces.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
959
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
960 Other packages might define their own faces; to see a list of all
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
961 faces, use any of the interactive face-manipulation commands such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
962 `set-face-font' and type `?' when you are prompted for the name of a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
963 face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
964
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
965 If the `bold', `italic', and `bold-italic' faces are not specified
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
966 in the resource database, then XEmacs attempts to derive them from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
967 font of the default face. It can only succeed at this if you have
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
968 specified the default font using the XLFD (X Logical Font Description)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
969 format, which looks like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
970
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
971 *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
972
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
973 If you use any of the other, less strict font name formats, some of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
974 which look like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
975
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
976 lucidasanstypewriter-12
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
977 fixed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
978 9x13
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
979
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
980 then XEmacs won't be able to guess the names of the bold and italic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
981 versions. All X fonts can be referred to via XLFD-style names, so you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
982 should use those forms. See the man pages for `X(1)', `xlsfonts(1)',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
983 and `xfontsel(1)'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
984
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
985
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
986 **** Widgets
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
987 ------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
988
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
989 There are several structural widgets between the terminal EmacsFrame
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
990 widget and the top level ApplicationShell; the exact names and types of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
991 these widgets change from release to release (for example, they changed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
992 in 19.9, 19.10, 19.12, and 19.13) and are subject to further change in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
993 the future, so you should avoid mentioning them in your resource database.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
994 The above-mentioned syntaxes should be forward-compatible. As of 19.14,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
995 the exact widget hierarchy is as follows:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
996
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
997 INVOCATION-NAME "shell" "container" FRAME-NAME
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
998 x-emacs-application-class "TopLevelEmacsShell" "EmacsManager" "EmacsFrame"
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
999
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1000 (for normal frames)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1001
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1002 or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1003
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1004 INVOCATION-NAME "shell" "container" FRAME-NAME
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1005 x-emacs-application-class "TransientEmacsShell" "EmacsManager" "EmacsFrame"
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1006
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1007 (for popup/dialog-box frames)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1008
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1009 where INVOCATION-NAME is the terminal component of the name of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1010 XEmacs executable (usually `xemacs'), and `x-emacs-application-class'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1011 is generally `Emacs'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1012
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1013
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1014 **** Menubar Resources
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1015 ----------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1016
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1017 As the menubar is implemented as a widget which is not a part of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1018 XEmacs proper, it does not use the face mechanism for specifying fonts
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1019 and colors: It uses whatever resources are appropriate to the type of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1020 widget which is used to implement it.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1021
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1022 If Emacs was compiled to use only the Motif-lookalike menu widgets,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1023 then one way to specify the font of the menubar would be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1024
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1025 Emacs*menubar*font: *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1026
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1027 If the Motif library is being used, then one would have to use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1028
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1029 Emacs*menubar*fontList: *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1030
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1031 because the Motif library uses the `fontList' resource name instead
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1032 of `font', which has subtly different semantics.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1033
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1034 The same is true of the scrollbars: They accept whichever resources
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1035 are appropriate for the toolkit in use.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1036
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1037
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1038 *** Source Code Highlighting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1039 ----------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1040
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1041 It's possible to have your buffers "decorated" with fonts or colors
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1042 indicating syntactic structures (such as strings, comments, function names,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1043 "reserved words", etc.). In XEmacs, the preferred way to do this is with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1044 font-lock-mode; activate it by adding the following code to your .emacs file:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1045
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1046 (add-hook 'emacs-lisp-mode-hook 'turn-on-font-lock)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1047 (add-hook 'c-mode-hook 'turn-on-font-lock)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1048 (add-hook 'c++-mode-hook 'turn-on-font-lock)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1049 (add-hook 'dired-mode-hook 'turn-on-font-lock)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1050 ...etc...
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1051
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1052 To customize it, see the descriptions of the function `font-lock-mode' and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1053 the variables `font-lock-keywords', `c-font-lock-keywords', etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1054
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1055 There exist several other source code highlighting packages, but font-lock
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
1056 does one thing that most others don't do: highlights as you type new text;
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
1057 and one thing that no others do: bases part of its decoration on the
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1058 syntax table of the major mode. Font-lock has C-level support to do this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1059 efficiently, so it should also be significantly faster than the others.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1060
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1061 If there's something that another highlighting package does that you can't
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1062 make font-lock do, let us know. We would prefer to consolidate all of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1063 desired functionality into one package rather than ship several different
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1064 packages which do essentially the same thing in different ways.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1065
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1066
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1067 ** Differences Between XEmacs and Emacs 18
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1068 ==========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1069
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1070 Auto-configure support has been added, so it should be fairly easy to compile
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1071 XEmacs on different systems. If you have any problems or feedback about
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1072 compiling on your system, please let us know.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1073
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1074 We have reimplemented the basic input model in a more general way; instead of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1075 X input being a special-case of the normal ASCII input stream, XEmacs has a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1076 concept of "input events", and ASCII characters are a subset of that. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1077 events that XEmacs knows about are not X events, but are a generalization of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1078 them, so that XEmacs can eventually be ported to different window systems.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1079
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1080 We have reimplemented keymaps so that sequences of events can be stored into
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1081 them instead of just ASCII codes; it is possible to, for example, bind
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1082 different commands to each of the chords Control-h, Control-H, Backspace,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1083 Control-Backspace, and Super-Shift-Backspace. Key bindings, function key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1084 bindings, and mouse bindings live in the same keymaps.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1085
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1086 Input and display of all ISO-8859-1 characters is supported.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1087
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1088 You can have multiple X windows ("frames" in XEmacs terminology).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1089
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1090 XEmacs has objects called "extents" and "faces", which are roughly
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1091 analogous to Epoch's "buttons," "zones," and "styles." An extent is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1092 region of text (a start position and an end position) and a face is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1093 collection of textual attributes like fonts and colors. Every extent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1094 is displayed in some "face", so changing the properties of a face
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1095 immediately updates the display of all associated extents. Faces can
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1096 be frame-local: you can have a region of text which displays with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1097 completely different attributes when its buffer is viewed from a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1098 different X window.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1099
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1100 The display attributes of faces may be specified either in lisp or through
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1101 the X resource manager.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1102
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1103 Pixmaps of arbitrary size can be embedded in a buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1104
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1105 Variable width fonts work.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1106
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1107 The height of a line is the height of the tallest font on that line, instead
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1108 of all lines having the same height.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1109
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1110 XEmacs uses the MIT "Xt" toolkit instead of raw Xlib calls, which
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1111 makes it be a more well-behaved X citizen (and also improves
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1112 portability). A result of this is that it is possible to include
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1113 other Xt "Widgets" in the XEmacs window. Also, XEmacs understands the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1114 standard Xt command-line arguments.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1115
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1116 XEmacs understands the X11 "Selection" mechanism; it's possible to define
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1117 and customize selection converter functions and new selection types from
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1118 Emacs Lisp, without having to recompile XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1119
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1120 XEmacs provides support for ToolTalk on systems that have it.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1121
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1122 XEmacs supports the Zmacs/Lispm style of region highlighting, where the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1123 region between the point and mark is highlighted when in its "active" state.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1124
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1125 XEmacs has a menubar, whose contents are customizable from emacs-lisp.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1126 This menubar looks Motif-ish, but does not require Motif. If you already
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1127 own Motif, however, you can configure XEmacs to use a *real* Motif menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1128 instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1129
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1130 XEmacs can ask questions using popup dialog boxes. Any command executed from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1131 a menu will ask yes/no questions with dialog boxes, while commands executed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1132 via the keyboard will use the minibuffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1133
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1134 XEmacs has vertical and horizontal scrollbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1135
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1136 The initial load-path is computed at run-time, instead of at compile-time.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1137 This means that if you move the XEmacs executable and associated directories
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1138 to somewhere else, you don't have to recompile anything.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1139
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1140 You can specify what the title of the XEmacs windows and icons should be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1141 with the variables `frame-title-format' and `frame-icon-title-format',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1142 which have the same syntax as `mode-line-format'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1143
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1144 XEmacs now supports floating-point numbers.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1145
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1146 XEmacs now knows about timers directly, instead of them being simulated by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1147 a subprocess.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1148
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1149 XEmacs understands truenames, and can be configured to notice when you are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1150 visiting two names of the same file. See the variables find-file-use-truenames
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1151 and find-file-compare-truenames.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1152
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1153 If you're running on a machine with audio hardware, you can specify sound
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1154 files for XEmacs to play instead of the default X beep. See the documentation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1155 of the function load-sound-file and the variable sound-alist.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1156
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1157 An XEmacs frame can be placed within an "external client widget" managed by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1158 another application. This allows an application to use an XEmacs frame as its
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1159 text pane rather than the standard Text widget that is provided with Motif or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1160 Athena. XEmacs supports Motif applications, generic Xt (e.g. Athena)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1161 applications, and raw Xlib applications.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1162
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1163 Random changes to the emacs-lisp library: (some of this was not written by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1164 us, but is included because it's free software and we think it's good stuff)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1165
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1166 - there is a new optimizing byte-compiler
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1167 - there is a new abbrev-based mail-alias mechanism
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1168 - the -*- line can contain local-variable settings
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1169 - there is a new TAGS package
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1170 - there is a new VI-emulation mode (viper)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1171 - there is a new implementation of Dired
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1172 - there is a new implementation of Isearch
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1173 - the VM package for reading mail is provided
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1174 - the W3 package for browsing the World Wide Web hypertext information
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1175 system is provided
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1176 - the Hyperbole package, a programmable information management and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1177 hypertext system
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1178 - the OO-Browser package, a multi-language object-oriented browser
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1179
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1180 There are many more specifics in the "Miscellaneous Changes" section, below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1181
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1182 The online Emacs Manual and Emacs-Lisp Manual are now both relatively
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1183 up-to-date.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1184
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1185 * XEmacs Release Notes
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1186 ======================
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1187
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1188 ** Future Plans for XEmacs
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1189 ==========================
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1190
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1191 For the curious, the biggest changes in 19.15 will include integration
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1192 of TM (a MIME package for VM and GNUS), EFS (the next generation of
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1193 ange-ftp), and Auc-TeX, and a "lite" distribution that includes a
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1194 minimal base and a set of optional packages (which will include TM,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1195 EFS, and Auc-TeX, as well as all of the large packages currently
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1196 distributed with XEmacs). There will also still be a full distribution
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1197 that includes all the optional packages.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1198
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1199 We are working on improving the Mule support in future releases:
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1200
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1201 -- Other input methods, such as wnn, will be supported.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1202
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1203 -- More user-level documentation on using Mule.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1204
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1205 ** Major Differences Between 19.14 and 20.0
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1206
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1207 XEmacs 20.0 is the first public release to have support for MULE
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1208 (Multi-Lingual Emacs). The --with-mule configuration flag must be
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1209 used to enable Mule support.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1210
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1211 Many bugs have been fixed. An effort has been made to eradicate all
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1212 XEmacs crashes, although we are not quite done yet. The overall
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1213 quality of XEmacs should be higher than any previous release. XEmacs
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1214 now compiles with nary a warning with some compilers.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1215
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1216 -- Multiple character sets can be displayed in a buffer. The file
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1217 mule-doc/demo in the distribution contains a greeting in many
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1218 different languages.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1219
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1220 -- Although the Mule work is for all languages, particular effort has
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1221 been invested in Japanese, with particular focus on Japanese users
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1222 of Sun WorkShop. Many menubar labels have been translated into
90
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1223 Japanese. Martin Buchholz, the maintainer of MULE features within
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1224 XEmacs normaly runs XEmacs in a Japanese language environment.
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1225 Some of the other contributors are Japanese, most importantly
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1226 Morioka Tomohiko, author of the TM package, providing MIME support
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1227 for Mail and News.
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1228
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1229 -- Input for complex Asian languages is supported via XIM, a mechanism
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1230 introduced in X11R5 to allow applications to get localized input
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1231 without knowledge of the language. The way XIM works is that when
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1232 the locale has a complex character set, such as Japanese, and extra
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1233 minibuffer-like status window appears attached to various
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1234 application windows, and indicates the status of the input method.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1235 Composed input in XEmacs should work the same as with other
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1236 applications. If Motif and Mule support is configured into XEmacs,
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1237 then XIM support is automatically configured in as well.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1238
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1239 -- TM (Tools for Mime) now comes with XEmacs. This provides MIME
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1240 (Multi-purpose Internet Multi-media Extensions?) support for Mail
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1241 and News. The primary author is Morioka Tomohiko.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1242
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1243 -- Japanese input can also be input using the `canna' input method.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1244 This support was contributed by Morioka Tomohiko. Setting up canna
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1245 usually requires more user effort (and better knowledge of Japanese!)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1246 than XIM, but provides a better-integrated input method.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1247
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1248 -- A mini-tutorial on using Mule:
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1249
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1250 -- Every time data passes between XEmacs and the rest of the
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1251 environment, via file or process input or output, XEmacs must
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1252 convert between its internal multi-character representation and
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1253 the external representation (`coding system'). Many
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1254 difficulties with Mule are related to controlling these coding
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1255 system conversions.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1256
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1257 -- file-coding-system, file-coding-system-for-read,
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1258 overriding-file-coding-system, and file-coding-system-alist
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1259 are used to determine the coding systems used on file input
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1260 and output.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1261
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1262 -- For each process, (set-process-input-coding-system) and
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1263 (set-process-output-coding-system) determine the coding
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1264 system used for I/O from the process.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1265
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1266 -- Many other things are encoded using pathname-coding-system:
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1267 -- file and directory names
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1268 -- window manager properties: window title, icon name
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1269 -- process names and process arguments
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1270 -- XIM input.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1271
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1272 -- In many cases, you will want to have the same values for all
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1273 the above variables in many cases. For example, in a
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1274 Japanese environment, you will want to use the 'euc-japan
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1275 coding system consistently, except when running certain
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1276 processes that do byte-oriented, rather than
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1277 character-oriented I/O, such as gzip, or when processing Mail
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1278 or News, where ISO2022-based coding systems are the norm,
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1279 since they support multiple character sets.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1280
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1281 -- To add support for a new language or character set, start by
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1282 trying to copy code in japanese-hooks.el.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1283
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1284 -- The traditional pre-Mule data conversion is equivalent to the
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1285 'binary coding system under Mule. In this case all characters
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1286 are treated as iso8859-1 (i.e. characters for English + Western
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1287 European languages).
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1288
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1289 -- many fileio-related commands such as find-file and write-file
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1290 take an extra argument, coding-system, which specifies the
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1291 encoding to be used with the file on disk. For example, here is
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1292 a command that converts from the Japanese EUC to ISO2022 format:
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1293
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1294 xemacs -batch -eval '(progn (find-file
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1295 "locale-start.el.euc" (quote euc-japan)) (write-file
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1296 "locale-start.el" nil (quote iso-2022-8-unix)))'
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1297
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1298 Interactively, you can be prompted for a coding system by
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1299 providing a prefix argument to the fileio command. In
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1300 particular, C-u C-x C-f is a useful sequence to edit a file
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1301 using a particular coding system.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1302
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1303 -- In an Asian locale (i.e. if $LANG is set to ja, ko, or zh),
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1304 XEmacs automatically sets up a language environment assuming
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1305 that the operating system encodes information in the national
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1306 version of EUC, which supports English and the national
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1307 language, but typically no other character sets.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1308
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1309 -- Command line processing should work much better now - no more order
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1310 dependencies.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1311
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1312 -- Many many package upgraded (thanks go to countless maintainers):
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1313
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1314 -- ediff 2.64 (Michael Kifer)
90
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1315 -- Gnus 5.2.40 (Lars Magne Ingebrigtsen)
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1316 -- w3 3.0.51 (Bill Perry)
90
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1317 -- ilisp 5.8 (Chris McConnell, Ivan Vasquez, Marco Antoniotti, Rick
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1318 Campbell)
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1319 -- VM 5.97 (Kyle Jones)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1320 -- etags 11.78 (Francesco Potorti`)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1321 -- ksh-mode.el 2.9
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1322 -- vhdl-mode.el 2.73 (Rod Whitby)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1323 -- id-select.el (Bob Weiner)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1324 -- EDT/TPU emulation modes should work now for the first time.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1325 -- viper 2.92 (Michael Kifer) is now the `official' vi emulator for XEmacs.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1326 -- big-menubar should work much better now.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1327 -- mode-motion+.el 3.16
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1328 -- backup-dir 2.0 (Greg Klanderman)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1329 -- ps-print.el-3.05 (Jacques Duthen Prestataire)
90
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1330 -- lazy-lock-1.15 (Simon Marshall)
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1331 -- reporter 3.3 (Barry Warsaw)
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1332 -- hm--html-menus 5.0 (Heiko Muenkel)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1333 -- cc-mode 4.322 (Barry Warsaw)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1334 -- elp 2.37 (Barry Warsaw)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1335
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1336
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1337 -- Many new packages have been added:
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1338 -- m4-mode 1.8 (Andrew Csillag)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1339 -- crisp.el - crisp/brief emulation (Gary D. Foster)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1340 -- Johan Vroman's iso-acc.el has been ported to XEmacs by Alexandre Oliva
90
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1341 -- psgml-1.01 (Lennart Staflin, James Clark)
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1342 -- python-mode.el 2.83 (Barry Warsaw)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1343 -- vrml-mode.el (Ben Wing)
90
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1344 -- enriched.el, face-menu.el (Boris Goldowsky, Michael Sperber)
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1345 -- sh-script.el (Daniel Pfeiffer)
99da576a67e7 Import from CVS: tag xemacs-20-0
cvs
parents: 88
diff changeset
1346 -- decipher.el (Christopher J. Madsen)
88
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1347
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1348 -- New function x-keysym-on-keyboard-p helps determine keyboard
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1349 characteristics for key rebinding:
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1350
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1351 x-keysym-on-keyboard-p: (KEYSYM &optional DEVICE)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1352 -- a built-in function.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1353 Return true if KEYSYM names a key on the keyboard of DEVICE.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1354 More precisely, return true if pressing a physical key
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1355 on the keyboard of DEVICE without any modifier keys generates KEYSYM.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1356 Valid keysyms are listed in the files /usr/include/X11/keysymdef.h and in
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1357 /usr/lib/X11/XKeysymDB, or whatever the equivalents are on your system.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1358
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1359 -- Installed info files are now compressed (support courtesy of Joseph J Nuspl)
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1360
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1361 -- (load-average) works on Solaris, even if you're not root. Thanks to
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1362 Hrvoje Niksic.
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1363
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1364 -- OffiX drag-and-drop support added
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1365
821dec489c24 Import from CVS: tag r20-0
cvs
parents: 70
diff changeset
1366 -- lots of syncing with 19.34 elisp files, most by Steven Baur
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1367
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1368
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1369 ** Major Differences Between 19.13 and 19.14
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1370 ============================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1371
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1372 XEmacs has a new address! The canonical ftp site is now
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1373 ftp.xemacs.org:/pub/xemacs and the Web page is now at
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1374 http://www.xemacs.org/. All mailing lists now have @xemacs.org
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1375 addresses. For the time being the @cs.uiuc.edu addresses will
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1376 continue to function.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1377
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1378 This is a major new release. Many features have been added, as well
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1379 as many bugs fixed. The Motif menubar has still _NOT_ been fixed for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1380 19.14. You should use the Lucid menubar instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1381
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1382
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1383
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1384 Major user-visible changes:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1385 ---------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1386
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1387 -- Color support in TTY mode is provided. You have to have a TTY capable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1388 of displaying them, such as color xterm or the console under Linux.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1389 If your terminal type supports colors (e.g. `xterm-color'), XEmacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1390 will automatically notice this and start using color.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1391
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1392 -- blink-cursor-mode enables a blinking text cursor. There is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1393 menubar option for this also.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1394
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1395 -- auto-show-mode is turned on by default; this means that XEmacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1396 will automatically scroll a window horizontally as necessary to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1397 keep point in view.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1398
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1399 -- a file dialog box is provided and will be used whenever you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1400 are prompted for a filename as a result of a menubar selection.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1401
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1402 -- XEmacs can be compiled with built-in GIF, JPEG, and PNG support.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1403 The GIF libraries are supplied with XEmacs; for JPEG and PNG,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1404 you have to obtain the appropriate libraries (this is well-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1405 documented). This makes image display much easier and faster under
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1406 W3 (the web browser) and TM (adds MIME support to VM and GNUS;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1407 not yet included with XEmacs but will be in 19.15).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1408
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1409 -- XEmacs provides a really nice mode (PSGML with "Wing improvements")
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1410 for editing HTML and other SGML documents. It parses the document,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1411 and as a result it does proper indentation, can show you the context
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1412 you're in, the allowed tags at a particular position, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1413
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1414 -- XEmacs comes standard with modes for editing Java and VRML code,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1415 including font-lock support.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1416
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1417 -- GNUS 5.2 comes standard with XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1418
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1419 -- You can now embed colors in the modeline, with different sections
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1420 of the modeline responding appropriately to various mouse gestures:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1421 For example, clicking on the "read-only" indicator toggles the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1422 read-only status of a buffer, and clicking on the buffer name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1423 cycles to the next buffer. Pressing button3 on these areas brings
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1424 up a popup menu of appropriate commands.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1425
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1426 -- There is a much nicer mode for completion lists and such.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1427 At the minibuffer prompt, if you hit page-up or Meta-V, the completion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1428 buffer will be displayed (if it wasn't already), you're moved into
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1429 it, and can move around and select filenames using the arrow keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1430 and the return key. Rather than a cursor, a filename is highlighted,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1431 and the arrow keys change which filename is highlighted.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1432
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1433 -- The edit-faces subsystem has also been much improved, in somewhat
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1434 similar ways to the completion list improvements.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1435
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1436 -- Many improvements were made to the multi-device support.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1437 We now provide an auxiliary utility called "gnuattach" that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1438 lets you connect to an existing XEmacs process and display
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1439 a TTY frame on the current TTY connection, and commands
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1440 `make-frame-on-display' (with a corresponding menubar entry)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1441 and `make-frame-on-tty' for more easily creating frames on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1442 new TTY or X connections.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1443
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1444 -- We have incorporated nearly all of the functionality of GNU Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1445 19.30 into XEmacs. This includes support for lazy-loaded
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1446 byte code and documentation strings, improved paragraph filling,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1447 better support for margins within documents, v19 regular expression
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1448 routines (including caching of compiled regexps), etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1449
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1450 -- In accordance with GNU Emacs 19.30, the following key binding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1451 changes have been made:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1452
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1453 C-x ESC -> C-x ESC ESC
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1454 ESC ESC -> ESC :
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1455 ESC ESC ESC is "abort anything" (keyboard-escape-quit).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1456
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1457 -- All major packages have been updated to their latest-released
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1458 versions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1459
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1460 -- XEmacs now gracefully handles a full colormap (such as typically
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1461 results when running Netscape). The nearest available color
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1462 is automatically substituted.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1463
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1464 -- Many bug fixes to the subprocess/PTY code, ps-print, menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1465 functions, `set-text-properties', DEC Alpha support, toolbar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1466 resizing (the "phantom VM toolbar" bug), and lots and lots
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1467 of other things were made.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1468
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1469 -- The ncurses library (a replacement for curses, found especially
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1470 under Linux) is supported, and will be automatically used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1471 if it can be found.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1472
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1473 -- You can now undo in the minibuffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1474
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1475 -- Surrogate minibuffers now work. These are also sometimes referred
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1476 to as "global" minibuffers.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1477
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1478 -- font-lock has been merged with GNU Emacs 19.30, improved defaults
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1479 have been added, and changes have been made to the way it is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1480 configured.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1481
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1482 -- Many, many modes have menubar entries for them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1483
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1484 -- `recover-session' lets you recover whatever files can be recovered
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1485 after your XEmacs process has died unexpectedly.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1486
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1487 -- C-h k followed by a toolbar button press correctly reports
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1488 the binding of the toolbar button.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1489
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1490 -- `function-key-map', `key-translation-map', and `keyboard-translate-table'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1491 are now correctly implemented.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1492
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1493 -- `show-message-log' (and its menubar entry under Edit) have been
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1494 removed; instead use `view-lossage' (and its menubar entry under
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1495 Help).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1496
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1497 -- There is a standard menubar entry for specifying which browser
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1498 (Netscape, W3, Mosaic, etc.) to use when dispatching URL's
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1499 in mail, Usenet news, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1500
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1501 -- Improved native sound support under Linux.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1502
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1503 -- Lots of other things we forgot to mention.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1504
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1505
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1506
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1507 Significant Lisp-level changes:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1508 -------------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1509
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1510 -- Many improvements to the E-Lisp documentation have been made;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1511 it should now be up-to-date and complete in nearly all cases.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1512
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1513 -- XEmacs has extensive documentation on its internals, for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1514 would-be C hackers.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1515
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1516 -- Common-Lisp support (the CL package) is now dumped standard
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1517 into XEmacs. No more need for (require 'cl) or anything
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1518 like that.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1519
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1520 -- Full support for extents and text properties over strings is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1521 provided.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1522
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1523 -- The extent properties `start-open', `end-open', `start-closed',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1524 and `end-closed' now work correctly w.r.t. text properties.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1525
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1526 -- The `face' property of extents and text properties can now
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1527 be a list.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1528
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1529 -- The `mouse-face' property from FSF GNU Emacs is now supported.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1530 It supersedes the `highlight' property.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1531
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1532 -- `enriched' and `facemenu' packages from FSF GNU Emacs have been ported.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1533
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1534 -- New functions for easier creation of dialog boxes:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1535 `get-dialog-box-response', `message-box', and `message-or-box'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1536
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1537 -- `function-min-args' and `function-max-args' allow you to determine
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1538 the minimum and maximum allowed arguments for any type of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1539 function (i.e. subr, lambda expression, byte-compiled function, etc.).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1540
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1541 -- Some C-level support for doing E-Lisp profiling is provided.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1542 See `start-profiling', `stop-profiling', and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1543 `pretty-print-profiling-info'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1544
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1545 -- `current-process-time' reports the user, system, and real times
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1546 for the currently running XEmacs process.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1547
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1548 -- `next-window', `previous-window', `next-frame', `previous-frame',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1549 `other-window', `get-lru-window', etc. have an extra device
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1550 argument that allows you to restrict which devices it includes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1551 (normally all devices). Some functions that incorrectly ignored
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1552 frames on different devices (e.g. C-x 0) are fixed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1553
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1554 -- new functions `run-hook-with-args-until-success',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1555 `run-hook-with-args-until-failure'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1556
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1557 -- generalized facility for local vs. global hooks. See `make-local-hook',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1558 `add-hook'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1559
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1560 -- New functions for querying the window tree: `frame-leftmost-window',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1561 `frame-rightmost-window', `window-first-hchild', `window-first-vchild',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1562 `window-next-child', `window-previous-child', and `window-parent'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1563
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1564 -- Epoch support works. This gets you direct access to some X events
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1565 and objects (e.g. properties and property-notify events).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1566
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1567 -- The multi-device support has been majorly revamped. There is now
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1568 a new concept of "consoles" (devices grouped together under a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1569 common keyboard/mouse), console-local variables, and a generalized
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1570 concept of device/console connection.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1571
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1572 -- `display-buffer' synched with GNU Emacs 19.30, giving you lots of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1573 wondrous cruft such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1574 -- unsplittable frames
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1575 -- pop-up-frames, pop-up-frame-function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1576 -- special-display-buffer-names, special-display-regexps,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1577 special-display-function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1578 -- same-window-buffer-names, same-window-regexps
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1579
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1580 -- XEmacs has support for accessing DBM- and/or DB-format databases,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1581 provided that you have the appropriate libraries on your system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1582
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1583 -- There is a new font style: "strikethru" fonts.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1584
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1585 -- New data type "weak list", which is a list with special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1586 garbage-collection properties, similar to weak hash tables.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1587
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1588 -- `set-face-parent' makes one face inherit all properties from another.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1589
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1590 -- The junky frame parameters mechanism has been revamped as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1591 frame properties, which a standard property-list interface.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1592
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1593 -- Lots and lots of functions for working with property lists have
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1594 been added.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1595
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1596 -- New functions `push-window-configuration', `pop-window-configuration',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1597 `unpop-window-configuration' for maintain a stack of window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1598 configurations.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1599
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1600 -- Many fixups to the glyph code; icons and mouse pointers are now
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1601 properly merged into the glyph mechanism.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1602
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1603 -- `set-specifier' works more sensibly, like `set-face-property'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1604
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1605 -- Many new specifiers for individually controlling toolbar height/width
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1606 and visibility and text cursor visibility.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1607
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1608 -- New face `text-cursor' controls the colors of the text cursor.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1609
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1610 -- Many new variables for turning on debug information about the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1611 inner workings of XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1612
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1613 -- Hash tables can now compare their keys using `equal' or `eql'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1614 as well as `eq'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1615
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1616 -- Other things too numerous to mention.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1617
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1618
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1619
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1620 Significant configuration/build changes:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1621 ----------------------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1622
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1623 -- You can disable TTY support, toolbar support, scrollbar support,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1624 menubar support, and/or dialog box support at configure time
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1625 to save memory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1626
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1627 -- New configure option `--extra-verbose' shows the diagnostic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1628 output from feature testing; this should help track down
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1629 problems with incorrect feature detection.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1630
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1631 -- `dont-have-xmu' is now `with-xmu', with the reversed sense.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1632 (It defaults to `yes'.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1633
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1634 -- `with-mocklisp' lets you add Mocklisp support if you really
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1635 need this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1636
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1637 -- `with-term' for adding TERM support for Linux users.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1638
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1639
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1640
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1641 ** Major Differences Between 19.12 and 19.13
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1642 ============================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1643
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1644 This is primarily a bug-fix release. Lots of bugs have been fixed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1645 Hopefully only a few have been introduced. The most noteworthy bug
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1646 fixes are:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1647
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1648 -- There should be no more problems connecting XEmacs to an X
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1649 server over SLIP or other slow connections.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1650 -- Periodic crashes when using the Buffers menu should be gone.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1651 -- etags would sometimes erase the current buffer; it doesn't
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1652 any more.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1653 -- XEmacs will correctly exit if the X server dies.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1654 -- uniconified frames are displayed properly under TVTWM.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1655 -- Breakage in `add-menu-item' / `add-menu-button' is fixed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1656
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1657 The Motif menubar has _NOT_ been fixed for 19.13. You should use the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1658 Lucid menubar instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1659
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1660 Multi-device support should now be working properly. You can now open
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1661 an X device after having started out on a TTY device.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1662
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1663 Background pixmaps now work. See `set-face-background-pixmap'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1664
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1665 Echo area messages are now saved to a buffer, " *Message Log*". To
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1666 see this buffer, use the command `show-message-log'. It is possible
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1667 to filter the message which are actually included by modifying the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1668 variables `log-message-ignore-regexps' and `log-message-ignore-labels'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1669
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1670 You can now control which warnings you want to see. See
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1671 `display-warning-suppressed-classes' and friends.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1672
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1673 You can now set the default location of an "other window" from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1674 Options menu.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1675
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1676 "Save Options" now saves the state of all faces.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1677
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1678 You can choose which file "Save Options" writes into; see
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1679 `save-options-file'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1680
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1681 XPM support is no longer required for the toolbar.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1682
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1683 The relocating allocator is now enabled by default whenever possible.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1684 This allows buffer memory to be returned to the system when no longer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1685 in use which helps keep XEmacs process size down.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1686
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1687 The ability to have captioned toolbars has been added. Currently only
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1688 the default toolbar actually has a captioned version provided. A new
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1689 specifier variable, `toolbar-buttons-captioned-p' controls whether the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1690 toolbar is captioned.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1691
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1692 A copy of the XEmacs FAQ is now included and is available through info.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1693
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1694 The on-line E-Lisp reference manual has been significantly updated.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1695
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1696 There is now audio support under Linux.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1697
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1698 Modifier keys can now be sticky. This is controlled by the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1699 `modifier-keys-are-sticky'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1700
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1701 manual-entry should now work correctly under Irix with the penalty of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1702 a longer startup time the first time it is invoked. If you are having
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1703 problems with this on another system try setting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1704 `Manual-use-subdirectory-list' to t.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1705
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1706 make-tty-device no longer automatically creates the first frame.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1707
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1708 Rectangular regions now work correctly.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1709
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1710 ediff no longer sets synchronize-minibuffers to t unless you first set
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1711 ediff-synchronize-minibuffers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1712
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1713 keyboard-translate-table has been implemented. This means that the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1714 `enable-flow-control' command for dealing with TTY connections that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1715 filter out ^S and ^Q now works.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1716
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1717 You can now create frames that are initially unmapped and frames that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1718 are "transient for another frame", meaning that they behave more like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1719 dialog-box frames.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1720
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1721 Other E-Lisp changes:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1722
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1723 -- Specifier `menubar-visible-p' for controlling menubar visibility
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1724 -- Local command hooks should be set using `local-pre-command-hook'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1725 and `local-post-command-hook' instead of making the global
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1726 equivalents be buffer-local.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1727 -- `quit-char', `help-char', `meta-prefix-char' can be any key specifier
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1728 instead of just an integer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1729 -- new functions `add-async-timeout' and `disable-async-timeout'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1730 These let you create asynchronous timeouts, which are like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1731 normal timeouts except that they're executed even during
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1732 running Lisp code. Use this with care!
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1733 -- `debug-on-error' and `stack-trace-on-error' now enter the debugger
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1734 only when an *unhandled* error occurs. If you want the old
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1735 behavior, use `debug-on-signal' and `stack-trace-on-signal'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1736 -- \U, \L, \u, \l, \E recognized specially in `replace-match'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1737 These are standard ex/perl commands for changing the case of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1738 replaced text.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1739 -- New function event-matches-key-specifier-p. This provides
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1740 a clean way of comparing keypress events with key specifiers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1741 such as 65, (shift home), etc. without having to resort
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1742 to ugly `character-to-event' / `event-to-character' hacks.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1743 -- New function `add-to-list'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1744 -- New Common-Lisp functions `some', `every', `notevery', `notany',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1745 `adjoin', `union', `intersection', `set-difference',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1746 `set-exclusive-or', `subsetp'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1747 -- `remove-face-property' provides a clean way of removing a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1748 face property.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1749
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1750 Many of the Emacs Lisp packages have been updated. Some of the new
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1751 Emacs Lisp packages ---
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1752
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1753 ada-mode: major mode for editing Ada source
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1754
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1755 arc-mode: simple editing of archives
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1756
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1757 auto-show-mode: automatically scrolls horizontally to keep point on-screen
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1758
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1759 completion: dynamic word completion mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1760
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1761 dabbrev: the dynamic abbrev package has been rewritten and is much
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1762 more powerful -- e.g. it searches in other buffers as well
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1763 as the current one
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1764
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1765 easymenu: menu support package
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1766
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1767 live-icon: makes frame icons represent the current frame contents
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1768
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1769 mailcrypt 3.2: mail encryption with PGP; included but v2.4 is still
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1770 the default
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1771
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
1772 two-column: for editing two-column text
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1773
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1774
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1775 ** Major Differences Between 19.11 and 19.12
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1776 ============================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1777
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1778 This is a huge new release. Almost every aspect of XEmacs has been changed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1779 at least somewhat. The highlights are:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1780
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1781 -- TTY support (includes face support)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1782 -- new redisplay engine; should be faster, less buggy, and more powerful
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1783 -- terminology change from "screen" to "frame"
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1784 -- built-in toolbar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1785 -- toolbar support added to many packages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1786 -- multiple device support (still in beta; improvements to come in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1787 19.13)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1788 -- Purify used to ensure that there are no memory leaks or memory corruption
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1789 problems
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1790 -- horizontal and vertical scrollbars in all windows
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1791 -- new Lucid (i.e. look-alike Motif) scrollbar widget
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1792 -- stay-up menus in the Lucid (look-alike Motif) menubar widget
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1793 -- 3-d modeline
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1794 -- new extents engine; should be faster, less buggy, and more powerful
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1795 -- much more powerful control over faces
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1796 -- expanded menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1797 -- more work on synching with GNU Emacs 19.28
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1798 -- new packages: Hyperbole, OOBR (object browser), hm--html-menus, viper,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1799 lazy-lock.el, ksh-mode.el, rsz-minibuf.el
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1800 -- package updates for all major packages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1801 -- dynodump package for Solaris: provides proper undumping and portable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1802 binaries across different OS versions and machine types
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1803 -- Greatly expanded concept of "glyphs" (pixmaps etc. in a buffer)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1804 -- built-in support for displaying X-Faces, if the X-Face library is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1805 available
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1806 -- built-in support for SOCKS if the SOCKS library is available
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1807 -- graceful behavior when the colormap is full (e.g. Netscape ate
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1808 all the colors)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1809 -- built-in MD5 (secure hashing function) support
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1810
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1811
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1812 More specific information:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1813
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1814 *** TTY Support
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1815 ---------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1816
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1817 The long-awaited TTY support is now available. XEmacs will start up
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1818 in TTY mode (using the tty you started XEmacs from) if the DISPLAY
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1819 environment variable is not set or if you use the `-nw' option.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1820
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1821 Faces are available on TTY's. For a demonstration, try editing a C
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1822 file and turning on font-lock-mode.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1823
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1824 You can also connect to additional TTY's using `make-tty-device',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1825 whether your first frame was a TTY or an X window. This ability is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1826 not yet completely finished.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1827
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1828 The full event-loop capabilities (processes, timeouts, etc.) are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1829 available on TTY's.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1830
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1831
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1832
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1833 *** New Redisplay Engine
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1834 ------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1835
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1836 The redisplay engine has been rewritten to improve its efficiency and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1837 to increase its functionality. It should also be significantly more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1838 bug-free than the previous redisplay engine.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1839
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1840 A line that is not big enough to display at the bottom of the window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1841 will normally be clipped (so that it is partially visible) rather than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1842 not displayed at all. The variable `pixel-vertical-clip-threshold'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1843 can be used to control the minimum space that must be available for a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1844 line to be clipped rather than not displayed at all.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1845
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1846 Tabs are displayed in such a way that things line up fairly well even
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1847 in the presence of variable-width fonts and/or lines with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1848 multiply-sized fonts.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1849
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1850 Display tables are implemented, through the specifier variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1851 `current-display-table'. They can be buffer-local, window-local,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1852 frame-local, or device-local. See below for info about specifiers.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1853
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1854
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1855
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1856 *** Toolbar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1857 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1858
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1859 There is now built-in support for a toolbar. A sample toolbar is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1860 visible by default at the top of the frame. Four separate toolbars
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1861 can be configured (at the top, bottom, left, and right of the frame).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1862 The toolbar specification is similar to the menubar specification.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1863 The up, down, and disabled glyphs of a toolbar button can be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1864 separately controlled. Explanatory text can be echoed in the echo
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1865 area when the mouse passes over a toolbar button. The size, contents,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1866 and visibility of the various toolbars can be controlled on a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1867 per-buffer, per-window, per-frame, and per-device basis through the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1868 use of specifiers. See the chapter on toolbars in the Lisp Reference
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1869 Manual (included with XEmacs) for more information.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1870
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1871 The toolbar color and shadow thicknesses are currently controlled only
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1872 through `modify-frame-parameters' and through X resources. We are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1873 planning on making these controllable through specifiers as well. (Our
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1874 hope is to make `modify-frame-parameters' obsolete, as it is a clunky
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1875 and not very powerful mechanism.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1876
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1877 Info, GNUS, VM, W3, and various other packages include custom toolbars
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1878 with them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1879
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1880
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1881
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1882 *** Menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1883 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1884
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1885 Stay-up menus are implemented in the look-alike Motif menubar.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1886
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1887 The default menubar has been expanded to include most commonly-used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1888 functions in XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1889
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1890 The options menu has been greatly expanded to include many more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1891 options.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1892
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1893 The menubar specification format has been greatly expanded. Per-menu
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1894 activation hooks can be specified through the :filter keyword (thus
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1895 obsoleting `activate-menubar-hook'); this allows for fast response
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1896 time when you have a large and complex menu. You can dynamically
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1897 control whether menu items are present through the :included and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1898 :config keywords. (The latter keyword implements a simple menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1899 configuration scheme, in conjunction with the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1900 `menubar-configuration'.) Many different menu-item separators (single
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1901 or double line; solid or dashed; flat, etched-in, or etched-out) are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1902 available. See the chapter on menus in the Lisp Reference Manual for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1903 more information about all of this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1904
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1905 New functions `add-submenu' and `add-menu-button' are available.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1906 These supersede the older `add-menu' and `add-menu-item' functions,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1907 and provide a more powerful and consistent interface.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1908
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1909 New convenience functions for popping up the part or all of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1910 menubar in a pop-up menu are available: `popup-menubar-menu' and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1911 `popup-buffer-menu'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1912
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1913 Menus are now incrementally constructed greatly improving menubar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1914 response time.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1915
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1916
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1917
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1918 *** Scrollbars
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1919 --------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1920
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1921 A look-alike Motif scrollbar is now included with XEmacs. No longer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1922 will you have to suffer with ugly Athena scrollbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1923
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1924 Windows can now have horizontal scrollbars. Normally they are visible
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1925 when the window's buffer is set to truncate lines rather than wrap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1926 them (e.g. `(setq truncate-lines t)').
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1927
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1928 All windows, not only the right-most ones, can have vertical
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1929 scrollbars.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1930
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1931 The functions to change a scrollbar's width have been superseded by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1932 the specifier variables `scrollbar-width' and `scrollbar-height'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1933 This allows their values to be controlled on a buffer-local,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1934 window-local, frame-local, and device-local basis. See below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1935
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1936 The scrollbars interact better with the event loop (for example, you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1937 can type `C-h k', do a scrollbar action, and see a description of this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1938 scrollbar action printed as if you had pressed a key sequence or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1939 selected a menu item).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1940
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1941 The scrollbar behavior can be reprogrammed, by advising the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1942 `scrollbar-*' functions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1943
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1944
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1945
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1946 *** Key Bindings
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1947 ----------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1948
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1949 The oft-used function `goto-line' now has its own binding: M-g.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1950
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1951 New bindings are available for scrolling the "other" window: M-next,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1952 M-prior, M-home, M-end. (On many keyboards, `next' and `prior'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1953 labelled `PgUp' and `PgDn'.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1954
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1955 You can reactivate a deactivated Zmacs region, without having any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1956 other effects, with the binding M-C-z.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1957
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1958 The bindings `M-u', `M-l', and `M-c' now work on the region (if a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1959 region is active) or work on a word, as before.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1960
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1961 Shift-Control-G forces a "critical quit", which drops immediately into
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1962 the debugger; see below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1963
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1964
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1965
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1966 *** Modeline
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1967 ------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1968
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1969 The modeline can now have a 3-d look; this is enabled by default. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1970 specifier variable `modeline-shadow-thickness' controls the size.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1971
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1972 The modeline can now be turned off on a per-buffer, per-window,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1973 per-frame, or per-device basis. The specifier variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1974 `has-modeline-p' controls whether the modeline is visible. See below
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1975 for details about the vastly powerful specifier mechanism.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1976
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1977 The modeline functions and variables have been renamed to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1978 `*-modeline-*' rather than `*-mode-line-*'. Aliases are provided for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1979 all the old names.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1980
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1981 Variable width fonts now work correctly when used in the modeline.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1982
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1983
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1984
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1985 *** Minibuffer, Echo Area
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1986 -------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1987
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1988 The minibuffer is no longer constrained to be one line high. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1989 package rsz-minibuf.el is included to automatically resize the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1990 minibuffer when its contents are too big; enable this with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1991 `resize-minibuffer-mode'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1992
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1993 The echo area is now a true buffer, called " *Echo Area*". This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1994 allows you to customize the echo area behavior through
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1995 before-change-functions and after-change-functions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1996
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1997
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1998
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1999 *** Specifiers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2000 --------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2001
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2002 XEmacs has a new concept called "specifiers", used to configure most
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2003 display options (toolbar size and contents, scrollbar size, face
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2004 properties, modeline visibility and shadow-thickness, glyphs, display
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2005 tables, etc.). We are planning on converting all display
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2006 characteristics to use specifiers, and obsoleting the clunky functions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2007 `frame-parameters' and `modify-frame-parameters'. Specifically:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2008
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2009 -- You can specify values (called "instantiators") for particular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2010 "locales" (i.e. buffers, windows, frames, devices, or a global value).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2011 When determining what the actual value (or "instance") of a specifier
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2012 is, the specifications that are provided are searched from most
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2013 specific (i.e. buffer-local) to most general (i.e. global), looking
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2014 for a matching one.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2015
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2016 -- You can specify multiple instantiators for a particular locale.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2017 For example, when specifying what the foreground color of a face
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2018 is in a particular buffer, you could specify two instantiators:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2019 "dark sea green" and "green". The color would then be dark sea
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2020 green on devices that recognize that color, and green on other
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2021 devices. You have effectively provided a fallback value to make
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2022 sure you get reasonable behavior on all devices.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2023
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2024 -- You can add one or more tags to an instantiator, where a tag
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2025 is a symbol that has been previously registered with XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2026 This allows you to identify your instantiators for later
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2027 removal in a way that won't interfere with other applications
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2028 using the same specifier. Furthermore, particular tags can
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2029 be restricted to match only particular sorts of devices.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2030 Any tagged instantiator will be ignored if the device over which
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2031 it is being instanced does not match any of its tags. This
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2032 allows you, for example, to restrict an instantiator to a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2033 particular device type (X or TTY) and/or class (color, grayscale,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2034 or mono). (You might want to specify, for example, that a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2035 particular face is displayed in green on color devices and is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2036 underlined on mono devices.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2037
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2038 -- A full API is provided for manipulating specifiers, and full
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2039 documentation is provided in the Lisp Reference Manual.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2040
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2041
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2042
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2043 *** Basic Lisp Stuff
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2044 --------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2045
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2046 Common-Lisp backquote syntax is recognized. For example, the old
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2047 expression
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2048
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2049 (` (a b (, c)))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2050
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2051 can now be written
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2052
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2053 `(a b ,c)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2054
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2055 The old backquote syntax is still accepted.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2056
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2057 The new function `type-of' returns a symbol describing the type of a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2058 Lisp object (`integer', `string', `symbol', etc.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2059
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2060 Symbols beginning with a colon (called "keywords") are treated
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2061 specially in that they are automatically made self-evaluating when
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2062 they are interned into `obarray'. The new function `keywordp' returns
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2063 whether a symbol begins with a colon.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2064
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2065 `get', `put', and `remprop' have been generalized to allow you to set
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2066 and retrieve properties on many different kinds of objects: symbols,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2067 strings, faces, glyphs, and extents (for extents, however, this is not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2068 yet implemented). They are joined by a new function `object-props'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2069 that returns all of the properties that have been set on an object.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2070
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2071 New functions `plists-eq' and `plists-equal' are provided for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2072 comparing property lists (a property list is an alternating list
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2073 of keys and values).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2074
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2075 The Common-Lisp functions `caar', `cadr', `cdar', `cddr', `caaar', etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2076 (up to four a's and/or d's), `first', `second', `third', etc. (up to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2077 `tenth'), `last', `rest', and `endp' have been added, for more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2078 convenient manipulation of lists.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2079
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2080 New function `mapvector' maps over a sequence and returns a vector
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2081 of the results, analogous to `mapcar'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2082
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2083 New functions `rassoc', `remassoc', `remassq', `remrassoc', and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2084 `remrassq' are provided for working with alists.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2085
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2086 New functions `defvaralias', `variable-alias' and `indirect-variable'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2087 are provided for creating variable aliases.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2088
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2089 Strings have a modified-tick that is bumped every time a string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2090 is modified in-place with `aset' or `fillarray'. This is retrieved
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2091 with the new function `string-modified-tick'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2092
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2093 New macro `push' destructively adds an element to the beginning of a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2094 list. New macro `pop' destructively removes and returns the first
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2095 element of a list.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2096
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2097
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2098
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2099 *** Buffers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2100 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2101
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2102 Most functions that operate on buffer text now take an optional BUFFER
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2103 argument, specifying which buffer they operate on. (Previously, they
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2104 always operated on the current buffer.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2105
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2106 The new function `transpose-regions' is provided, ported from GNU
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2107 Emacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2108
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2109 The new function `save-current-buffer' works like `save-excursion'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2110 but only saves the current buffer, not the location of point in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2111 that buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2112
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2113
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2114
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2115 *** Devices
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2116 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2117
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2118 XEmacs has a new concept of "device", which is represents a particular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2119 X display or TTY connection. `make-frame' has a new, optional device
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2120 parameter that allows you to specify which device the frame is to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2121 created on.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2122
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2123 Multiple simultaneous TTY and/or X connections may be made. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2124 specifier mechanism provides reasonable behavior of glyphs, faces,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2125 etc. over heterogeneous device types and over devices whose individual
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2126 capabilities may vary.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2127
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2128 There is also a device type called "stream" that represents a STDIO
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2129 device that has no redisplay or cursor-motion capabilities, such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2130 the "glass terminal" that XEmacs uses when it is run noninteractively.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2131 There is not all that much you can do with stream devices currently;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2132 please let us know if there are good uses you can think of for this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2133 capability. (For example, log files?)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2134
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2135 A new device API is provided. Functions are provided such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2136 `device-name' (the name of the device, which generally is based on the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2137 X display or TTY file name), `device-type' (X, TTY, or stream),
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2138 `device-class' (color, grayscale, or mono), etc. See the Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2139 Reference Manual.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2140
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2141 Many functions have been extended to contain an additional, optional
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2142 device argument, where such an extension makes sense. In general, if
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2143 the argument is omitted, it is equivalent to specifying
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2144 `(selected-device)'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2145
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2146 Many previous functions and variables are obsoleted in favor of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2147 device API. For example, `window-system' is obsoleted by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2148 `device-type', and `x-color-display-p' and friends are obsoleted by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2149 `device-class'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2150
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2151 ** NOTE **: The obsolete variable `window-system' is going
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2152 to be deleted soon, probably in 19.14. Please correct all
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2153 your code to use `device-type'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2154
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2155 ** INCOMPATIBLE CHANGE **: The function `x-display-visual-class'
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2156 returns different values from previous versions of XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2157
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2158
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2159
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2160 *** Errors, Warnings, C-g
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2161 -------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2162
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2163 There is a new warnings system implemented. Many warnings that were
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2164 formerly displayed in various ad-hoc ways (e.g. warnings about screwy
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2165 modifier mappings, messages about failures handling the mouse cursor
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2166 and errors in a gc-hook) have been regularized through this system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2167 The new function `warn' displays a warning before the next redisplay
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2168 (the actually display of the warning messages is accomplished through
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2169 `display-warning-buffer'). Both `warn' and `display-warning-buffer'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2170 are Lisp functions (the C code calls out to them as necessary), and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2171 thus you can customize the warning system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2172
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2173 Under an X display, you can press Shift-Control-G to force a "critical
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2174 quit". This will immediately display a backtrace and pop you into the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2175 debugger, regardless of the settings of `inhibit-quit' and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2176 `debug-on-quit'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2177
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2178 C-g now works properly even on systems that don't implement SIGIO or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2179 for which SIGIO is broken (e.g. IRIX 5.3 and older versions of Linux).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2180 In addition, the SIGIO support has been fixed for many systems on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2181 which it didn't always work properly before (e.g. HPUX and Solaris).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2182
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2183
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2184
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2185 *** Events
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2186 ----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2187
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2188 ** INCOMPATIBLE CHANGE **: Many event functions have been changed to
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2189 accept and return windows instead of frames.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2190
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2191 New function: `event-live-p', specifying whether `deallocate-event'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2192 has been called on an event.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2193
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2194 The "menu event" type has been renamed to "misc-user event", and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2195 encompasses scrollbar events as well as menu events. We are planning
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2196 on making it also encompass toolbar events in a future release.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2197
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2198 New functions are provided for determining whether an particular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2199 sections of a frame: `event-over-border-p', `event-over-glyph-p',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2200 `event-over-modeline-p', `event-over-text-area-p', and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2201 `event-over-toolbar-p'. The old, kludgey methods of checking the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2202 window-height, the internal-border-width, etc. are unreliable and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2203 should not be used.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2204
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2205 New functions `event-window-x-pixel' and `event-window-y-pixel' are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2206 provided for determining where in a particular window an event
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2207 happened.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2208
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2209 New functions `event-glyph-x-pixel' and `event-glyph-y-pixel' are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2210 provided for determining where in a particular glyph an event
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2211 happened.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2212
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2213 New function `event-closest-point', which returns the closest buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2214 position to the event even if the event did not occur over any text.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2215
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2216 New variable `unread-command-events', superseding the older
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2217 `unread-command-event'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2218
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2219 Many event-loop bugs have been fixed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2220
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2221
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2222
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2223 *** Extents
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2224 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2225
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2226 The extent code has been largely rewritten. It should be faster and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2227 more reliable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2228
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2229 The text-property implementation has been greatly improved.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2230
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2231 Some new extent primitives are provided to return the position of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2232 next or previous property change in a buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2233
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2234 Extents can now have a parent specified; then all of its properties
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2235 (except for the buffer it's in and its position in that buffer) come
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2236 from that extent. Hierarchies of such extents can be created.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2237
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2238 Extents now have a `detachable' property that controls what happens
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2239 (they either get detached or shrink down to zero-length) when their
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2240 text is deleted. Previously, such extents would always be detached.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2241
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2242 The `invisible' property on extents now works.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2243
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2244 `map-extents' has three additional parameters that provide more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2245 control over which extents are mapped.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2246
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2247 `map-extents' deals better with changes made to extents in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2248 buffer being mapped over.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2249
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2250 A new function `mapcar-extents' (an alternative to `map-extents') has
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2251 been provided and should be easier to use than `map-extents'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2252
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2253
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2254
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2255 *** Faces
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2256 ---------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2257
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2258 Faces can now be buffer-local, window-local, and device-local as well
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2259 as frame-local, and can be further restricted to a particular device
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2260 type or class. The way in which faces can be controlled is now based
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2261 on the general and powerful specifier mechanism; see above.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2262
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2263 The new function `set-face-property' generalizes `set-face-font',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2264 `set-face-foreground', etc. and takes many new optional arguments, in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2265 accordance with the new specifier mechanism.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2266
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2267 The new functions `face-property' and `face-property-instance'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2268 generalize `face-font', `face-foreground', etc. and take many new
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2269 optional arguments, in accordance with the new specifier mechanism.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2270 (`face-property' returns the value, if any, that was specified for a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2271 particular locale, and `face-property-instance' returns the actual
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2272 value that will be used for display. See the section on specifiers.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2273
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2274 The functions `face-font', `face-foreground', `face-background',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2275 `set-face-font', `set-face-foreground', `set-face-background',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2276 etc. are now convenience functions, trivially implemented using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2277 `face-property' and `set-face-property' and take new optioanl
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2278 arguments in accordance with those functions. New convenience
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2279 functions `face-font-instance', `face-foreground-instance',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2280 `face-background-instance', etc. are provided and are trivially
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2281 implemented using `face-property-instance'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2282
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2283 Inheritance of face properties can now be specified. Each individual
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2284 face property can inherit differently from other properties, or not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2285 inherit at all.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2286
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2287 You can set user-defined properties on faces using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2288 `set-face-property'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2289
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2290 You can create "temporary" faces, which are faces that disappear
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2291 when they are no longer in use. This is as opposed to normal
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2292 faces, which stay around forever.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2293
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2294 The function `make-face' takes a new optional argument specifying
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2295 whether a face should be permanent or temporary, and returns the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2296 actual face object rather than the face symbol, as in previous
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2297 versions of XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2298
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2299 The function `face-list' takes a new optional argument specifying
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2300 whether permanent, temporary, or both kinds of faces should be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2301 returned.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2302
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2303 Faces have new TTY-specific properties: `highlight', `reverse',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2304 `alternate', `blinking', and `dim'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2305
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2306 Redisplay is smarter about dealing with face changes: changes to a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2307 particular face no longer cause all frames to be cleared and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2308 redisplayed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2309
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2310 The Edit-Faces package is provided for interactively changing faces.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2311 A menu item on the options menu is provided for this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2312
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2313 New functions are provided for retrieving the ascent, descent, height,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2314 and width of a character in a particular face.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2315
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2316
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2317
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2318 *** Fonts, Colors
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2319 -----------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2320
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2321 ** INCOMPATIBLE CHANGE **: The old "font" and "pixel" objects are gone.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2322 In place are new objects "font specifier", "font instance", "color
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2323 specifier", and "color instance". Functions `font-name', `pixel-name'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2324 (an obsolete alias for `color-name'), etc. are now convenience
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2325 functions for working with font and color specifiers. Old code that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2326 is not too sophisticated about working with font and pixel objects may
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2327 still work, though. (For example, the idiom `(font-name (face-font
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2328 'default))' still works.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2329
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2330 You can now extract the RGB components of a color-instance object
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2331 (similar to the old pixel object) with the function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2332 `color-instance-rgb-components'. There is also a convenience function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2333 `color-rgb-components' for working with color specifiers.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2334
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2335 If there are no more colors available in the colormap, the nearest
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2336 existing color will be used when allocating a new color.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2337
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2338
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2339
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2340 *** Frames
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2341 ----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2342
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2343 What used to be called "screens" are now called "frames", for clarity
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2344 and consistency with GNU Emacs. Aliases are provided for all the old
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2345 screen functions and variables, to avoid introducing a huge E-Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2346 incompatibility.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2347
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2348 The frame code has been merged with GNU Emacs 19.28, providing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2349 improved functionality for many functions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2350
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2351
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2352
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2353 *** Glyphs, Images, and Pixmaps
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2354 -------------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2355
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2356 Glyphs (used in various places, i.e. as begin-glyphs and end-glyphs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2357 attached to extents and appearing in a buffer or in marginal
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2358 annotations; as the truncator and continuor glyphs marking line wrap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2359 or truncation; as an overlay at the beginning of a line; as the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2360 displayable element in a toolbar button; etc.) can now be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2361 buffer-local, window-local, frame-local, and device-local, and can be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2362 further restricted to a particular device type or class. The way in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2363 which faces can be controlled is now based on the general and powerful
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2364 specifier mechanism; see above.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2365
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2366 ** INCOMPATIBLE CHANGE **: The glyph and pixmap API has been completely
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2367 overhauled. A new Lisp object "glyph" is provided and should be used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2368 where the old "pixmap" object would have been used. The pixmap object
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2369 exists no longer. There are also new Lisp objects "image specifier"
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2370 and "image instance" (an image-instance is the closest equivalent to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2371 what a pixmap object was). More work on glyphs and images is slated
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2372 for 19.13. The glyph and image docs in the Lisp Reference Manual are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2373 incomplete and will be finished in 19.13.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2374
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2375 The new function `set-glyph-property' allows setting of all the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2376 glyph properties (`baseline', `contrib-p', etc.). Convenience
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2377 functions for particular properties are also provided, just like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2378 for faces.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2379
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2380 You can set user-defined properties on glyphs using the new function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2381 `set-glyph-property'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2382
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2383 When displaying pixmaps, existing, closest-matching colors will be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2384 used if the colormap is full.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2385
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2386 If the compface library is compiled into XEmacs, there is built-in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2387 support for displaying X-Face bitmaps. (These are typically small
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2388 pictures of people's faces, included in a mail message through the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2389 X-Face: header.) VM and highlight-headers will automatically use the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2390 built-in X-Face support if it is available.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2391
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2392 Annotations in the right margin (as well as the left margin) are now
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2393 implemented. The left and right margin width functions have been
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2394 superseded by the specifier variables `left-margin-width' and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2395 `right-margin-width', allowing much more flexible control through the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2396 specifier mechanism.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2397
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2398 ** INCOMPATIBLE CHANGE **: The variable `use-left-overflow',
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2399 for controlling annotations in the left margin, is now a specifier
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2400 variable instead of a buffer-local variable. (There is also a new
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2401 variable `use-right-overflow', that is complementary.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2402
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2403
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2404
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2405 *** Hashing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2406 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2407
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2408 Two new types of weak hashtables can be created: key-weak and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2409 value-weak. In a key-weak hashtable, an entry remains around
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2410 if its key is referenced elsewhere, regardless of whether this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2411 is also the case for the value. Value-weak hashtables are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2412 complementary. (This is as opposed to the traditional weak
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2413 hashtables, where an entry remains around only if both the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2414 key and value are referenced elsewhere.) New functions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2415 `make-key-weak-hashtable' and `make-value-weak-hashtable'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2416 are provided for creating these hashtables.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2417
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2418 The new function `md5' is provided for performing an MD5
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2419 hash of an object. MD5 is a secure message digest algorithm
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2420 developed by RSA, inc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2421
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2422
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2423
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2424 *** Keymaps
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2425 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2426
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2427 The FSF GNU Emacs concept of `function-key-map' is now partially
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2428 implemented. This allows conversion of function-key escape sequences
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2429 such as `ESC [ 1 1 ~' into an equivalent human-readable keysym such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2430 `F1'. This work will be completed in 19.14. The function-key map is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2431 device-local and controllable through the functions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2432 `device-function-key-map' and `set-device-function-key-map'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2433
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2434 `where-is-internal' now correctly searches minor-mode keymaps,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2435 extent-local keymaps, etc. As a side effect of this, menu items will
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2436 now correctly show the keyboard equivalent for commands that are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2437 available through a minor-mode keymap, extent-local keymap, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2438
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2439 ** INCOMPATIBLE CHANGE **: The modifier key "Symbol" has
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2440 been renamed to "Alt", for compatibility with the rest of the world.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2441 Keep in mind that on many keyboards, the key labelled "Alt" actually
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2442 generates the "Meta" modifier. (On Sun keyboards, however, the key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2443 labelled "Alt" does indeed generate the "Alt" modifier, and the key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2444 labelled with a diamond generates the "Meta" modifier.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2445
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2446
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2447
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2448 *** Mouse, Active Region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2449 ------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2450
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2451 The mouse internals in mouse.el have been rewritten. Hooks have been
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2452 provided for easier customization of mouse behavior. For example, you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2453 can now easily specify an action to be invoked on single-click
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2454 (i.e. down-up without appreciable motion), double-click, drag-up, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2455
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2456 Some code from FSF GNU Emacs has been ported over, generalizing some of
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2457 the X-specific mouse stuff.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2458
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2459 ** INCOMPATIBLE CHANGE **: The function `set-mouse-position' accepts
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2460 a window instead of a frame.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2461
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2462 New function `mouse-position' that obsoletes and is more powerful than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2463 `read-mouse-position'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2464
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2465 New functions `mouse-pixel-positon' and `set-mouse-pixel-position' for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2466 working with pixels instead of characters.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2467
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2468 The active (Zmacs) region is now highlighted using the `zmacs-region-face'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2469 instead of the `primary-selection-face'; this generalizes what used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2470 to be X-specific.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2471
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2472 New functions `region-active-p', `region-exists-p', and `activate-region'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2473 provide a uniform API for dealing with the region irrespective of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2474 whether the variable `zmacs-regions' is set.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2475
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2476 XEmacs is now a better X citizen with respect to the primary selection:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2477 it does not stomp on the primary selection quite so much. This makes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2478 things more manageable if you set `zmacs-regions' to nil.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2479
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2480
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2481
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2482 *** Processes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2483 -------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2484
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2485 Various process race conditions and bugs have been fixed. Problems
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2486 with process termination not getting noticed until much later (if at
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2487 all) should be gone now, as well as problems with zombie processes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2488 under some systems.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2489
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2490 SOCKS support is now included. SOCKS is a package that allows hosts
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2491 behind a firewall to gain full access to the Internet without
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2492 requiring direct IP reachability.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2493
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2494
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2495
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2496 *** Windows
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2497 -----------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2498
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2499 Windows 95 is still not out yet.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2500
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2501 ** INCOMPATIBLE CHANGE **: The functions `locate-window-from-coordinates'
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2502 and `window-edges' have been eliminated. It no longer makes sense to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2503 work with windows in terms of character positions, because windows can
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2504 (and often do) have many differently-sized fonts in them, because the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2505 3-D modeline is not exactly one line high, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2506
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2507 The new functions `window-pixel-edges', `window-highest-p',
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2508 `window-lowest-p', `frame-highest-window', and `frame-lowest-window'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2509 are provided as substitutes for the above-mentioned, deleted
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2510 functions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2511
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2512 The function `window-end' now takes an optional GUARANTEE argument
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2513 that will ensure that the value is actually correct as of the next
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2514 redisplay.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2515
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2516 The window code has been merged with GNU Emacs 19.28, providing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2517 improved functionality for many functions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2518
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2519
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2520
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2521 *** System-Specific Information
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2522 -------------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2523
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2524 Georg Nikodym's dynodump package is provided, for proper unexec()ing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2525 on Solaris systems. Executables built on Solaris 2.3 can now run on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2526 Solaris 2.4 without crashing; similarly with executables built on one
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2527 type of Sun machine and run on another.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2528
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2529 AIX 4.x is supported.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2530
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2531 The NeXTstep operating system is supported in TTY mode (this is still
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2532 in beta). There are plans to port XEmacs to the NeXTstep window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2533 system, but it may be awhile before this is complete.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2534
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2535 Problems with the `round' function causing arithmetic errors on HPUX 9
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2536 have been fixed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2537
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2538 You can now build XEmacs as an ELF executable on Linux systems that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2539 support ELF.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2540
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2541 Various other new system configurations are supported.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2542
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2543
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2544
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2545 *** Packages
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2546 ------------
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2547
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2548 Most packages have been updated to the latest available versions.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2549
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2550
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2551 Some of the new Emacs Lisp packages ---
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2552
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2553 Hyperbole: the everyday information manager. Provides a Rolodex,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2554 allows links to be embedded in text, etc.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2555
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2556 OOBR: a sophisticated class browser for object-oriented languages.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2557
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2558 viper: a better VI emulator that allows Emacs and VI features
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2559 to coexist happily.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2560
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2561 hm--html-menus: a sophisticated package for editing HTML code,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2562 from Heiko Muenkel.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2563
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2564 ksh-mode.el: for editing shell scripts.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2565
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2566 lazy-lock.el: a lazy, on-the-fly fontifier.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2567
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2568 paren.el: an improved matching paren highlighter
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2569
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2570
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2571
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2572 Major changes to existing packages --
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2573
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2574 VM: has a toolbar, many other nice features.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2575
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2576 w3: has a toolbar, many other nice features.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2577
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2578 ediff: provides three-way merging, has a better user interface.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2579
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2580 info: has a toolbar.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2581
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2582 highlight-headers.el: now highlights URL's and makes them active so
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2583 that when clicked either Netscape 1.1 is called
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2584 or Emacs W3 is run.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2585
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2586
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2587 ** Major Differences Between 19.10 and 19.11
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2588 ============================================
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2589
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2590 The name has changed from "Lucid Emacs" to "XEmacs". Along with this is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2591 new canonical ftp site: cs.uiuc.edu:/pub/xemacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2592
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2593 XEmacs now has its very own World Wide Web page! It contains a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2594 complete list of the FTP distribution sites, the most recent FAQ,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2595 pointers to Emacs Lisp packages not included with the distribution, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2596 other useful stuff. Check it out at http://xemacs.cs.uiuc.edu/.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2597
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2598 A preliminary New Users Guide.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2599
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2600 cc-mode.el now provides the default C, C++ and Objective-C modes.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2601
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2602 The primary goal of this release is stability. Very few new features have
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2603 been introduced but lots of bugs have been fixed. Many of the Emacs Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2604 packages have been updated.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2605
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2606 Some of the new Emacs Lisp packages ---
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2607
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2608 tcl-mode.el: major mode for editing TCL code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2609
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2610 fast-lock.el: saves and restores font-lock highlighting, greatly
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2611 reducing the time necessary for loading a font-lock'ed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2612 file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2613
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2614 ps-print.el: prints buffers to Postscript printers preserving the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2615 buffer's bold and italic text attributes
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2616
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2617 toolbar.el: provides a "fake" toolbar for use with XEmacs (an
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2618 integrated one will be included with 19.12)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2619
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2620
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2621 ** Major Differences Between 19.9 and 19.10
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2622 ===========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2623
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2624 The GNU `configure' system is now used to build lemacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2625
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2626 The Emacs Manual and Emacs Lisp Reference Manual now document version 19.10.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2627 If you notice any errors, please let us know.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2628
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2629 When pixmaps are displayed in a buffer, they contribute to the line height -
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2630 that is, if the glyph is taller than the rest of the text on the line, the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2631 line will be as tall as necessary to display the glyph.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2632
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2633 In addition to using arbitrary sound files as emacs beeps, one can control
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2634 the pitch and duration of the standard X beep, on X servers which allow that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2635 (Note: most don't.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2636
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2637 There is support for playing sounds on systems with NetAudio servers.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2638
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2639 Minor modes may have mode-specific key bindings; keymaps may have an arbitrary
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2640 number of parent maps.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2641
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2642 Menus can have toggle and radio buttons in them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2643
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2644 There is a font selection menu.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2645
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2646 Some default key bindings have changed to match FSF19; the new bindings are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2647
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2648 Screen-related commands:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2649 C-x 5 2 make-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2650 C-x 5 0 delete-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2651 C-x 5 b switch-to-buffer-other-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2652 C-x 5 f find-file-other-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2653 C-x 5 C-f find-file-other-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2654 C-x 5 m mail-other-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2655 C-x 5 o other-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2656 C-x 5 r find-file-read-only-other-screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2657 Abbrev-related commands:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2658 C-x a l add-mode-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2659 C-x a C-a add-mode-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2660 C-x a g add-global-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2661 C-x a + add-mode-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2662 C-x a i g inverse-add-global-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2663 C-x a i l inverse-add-mode-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2664 C-x a - inverse-add-global-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2665 C-x a e expand-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2666 C-x a ' expand-abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2667 Register-related commands:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2668 C-x r C-SPC point-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2669 C-x r SPC point-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2670 C-x r j jump-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2671 C-x r s copy-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2672 C-x r x copy-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2673 C-x r i insert-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2674 C-x r g insert-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2675 C-x r r copy-rectangle-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2676 C-x r c clear-rectangle
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2677 C-x r k kill-rectangle
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2678 C-x r y yank-rectangle
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2679 C-x r o open-rectangle
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2680 C-x r t string-rectangle
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2681 C-x r w window-configuration-to-register
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2682 Narrowing-related commands:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2683 C-x n n narrow-to-region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2684 C-x n w widen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2685 Other changes:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2686 C-x 3 split-window-horizontally (was undefined)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2687 C-x - shrink-window-if-larger-than-buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2688 C-x + balance-windows
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2689
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2690 The variable allow-deletion-of-last-visible-screen has been removed, since
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2691 it was widely hated. You can now always delete the last visible screen if
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2692 there are other iconified screens in existence.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2693
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2694 ToolTalk support is provided.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2695
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2696 An Emacs screen can be placed within an "external client widget" managed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2697 by another application. This allows an application to use an Emacs screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2698 as its text pane rather than the standard Text widget that is provided
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2699 with Motif or Athena.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2700
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2701 Additional compatibility with Epoch is provided (though this is not yet
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2702 complete.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2703
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2704
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2705 ** Major Differences Between 19.8 and 19.9
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2706 ==========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2707
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2708 Scrollbars! If you have Motif, these are real Motif scrollbars; otherwise,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2709 Athena scrollbars are used. They obey all the usual resources of their
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2710 respective toolkits.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2711
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
2712 There is now an implementation of dialog boxes based on the Athena
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2713 widgets, as well as the existing Motif implementation.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2714
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2715 This release works with Motif 1.2 as well as 1.1. If you link with Motif,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2716 you do not also need to link with Athena.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2717
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2718 If you compile lwlib with both USE_MOTIF and USE_LUCID defined (which is the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2719 recommended configuration) then the Lucid menus will draw text using the Motif
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2720 string-drawing library, instead of the Xlib one. The reason for this is that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2721 one can take advantage of the XmString facilities for including non-Latin1
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2722 characters in resource specifications. However, this is a user-visible change
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2723 in that, in this configuration, the menubar will use the "*fontList" resource
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2724 in preference to the "*font" resource, if it is set.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2725
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2726 It's possible to make extents which are copied/pasted by kill and undo.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2727 There is an implementation of FSF19-style text properties based on this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2728
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2729 There is a new variable, minibuffer-max-depth, which is intended to circumvent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2730 a common source of confusion among new Emacs users. Since, under a window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2731 system, it's easy to jump out of the minibuffer (by doing M-x, then getting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2732 distracted, and clicking elsewhere) many, many novice users have had the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2733 problem of having multiple minibuffers build up, even to the point of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2734 exhausting the lisp stack. So the default behavior is to disallow the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2735 minibuffer to ever be reinvoked while active; if you attempt to do so, you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2736 will be prompted about it.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2737
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2738 There is a new variable, teach-extended-commands-p, which if set, will cause
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2739 `M-x' to remind you of any key bindings of the command you just invoked the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2740 "long way."
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2741
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2742 There are menus in Dired, Tar, Comint, Compile, and Grep modes.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2743
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2744 There is a menu of window management commands on the right mouse button over
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2745 the modelines.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2746
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2747 Popup menus now have titles at the top; this is controlled by the new
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2748 variable `popup-menu-titles'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2749
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2750 The `Find' key on Sun keyboards will search for the next (or previous)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2751 occurrence of the selected text, as in OpenWindows programs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2752
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2753 The `timer' package has been renamed to `itimer' to avoid a conflict with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2754 a different package called `timer'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2755
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2756 VM 5.40 is included.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2757
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2758 W3, the emacs interface to the World Wide Web, is included.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2759
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2760 Felix Lee's GNUS speedups have been installed, including his new version of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2761 nntp.el which makes GNUS efficiently utilize the NNTP XOVER command if
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2762 available (which is much faster.)
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2763
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2764 GNUS should also be much friendlier to new users: it starts up much faster,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2765 and doesn't (necessarily) subscribe you to every single newsgroup.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2766
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2767 The byte-compiler issues a new class of warnings: variables which are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2768 bound but not used. This is merely an advisory, and does not mean the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2769 code is incorrect; you can disable these warnings in the usual way with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2770 the `byte-compiler-options' macro.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2771
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2772 the `start-open' and `end-open' extent properties, for specifying whether
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2773 characters inserted exactly at a boundary of an extent should go into the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2774 extent or out of it, now work correctly.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2775
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2776 The `extent-data' slot has been generalized/replaced with a property list,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2777 so it's easier to attach arbitrary data to extent objects.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2778
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2779 The `event-modifiers' and `event-modifier-bits' functions work on motion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2780 events as well as other mouse and keyboard events.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2781
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2782 Forms-mode uses fonts and read-only regions.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2783
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2784 The behavior of the -geometry command line option should be correct now.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2785
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2786 The `iconic' screen parameter works when passed to x-create-screen.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2787
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2788 The user's manual now documents Lucid Emacs 19.9.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2789
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2790 The relocating buffer allocator is turned on by default; this means that when
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2791 buffers are killed, their storage will be returned to the operating system,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2792 and the size of the emacs process will shrink.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2793
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2794 CAVEAT: code which contains calls to certain `face' accessor functions will
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2795 need to be recompiled by version 19.9 before it will work. The functions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2796 whose callers must be recompiled are: face-font, face-foreground,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2797 face-background, face-background-pixmap, and face-underline-p. The symptom
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2798 of this problem is the error "Wrong type argument, arrayp, #<face ... >".
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2799 The .elc files generated by version 19.9 will work in 19.6 and 19.8, but
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2800 older .elc files which contain calls to these functions will not work in 19.9.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2801
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2802 Work In Progress:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2803
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2804 - We have been in the process of internationalizing Lucid Emacs. This code is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2805 ***not*** ready for general use yet. However, the code is included (and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2806 turned off by default) in this release.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2807
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2808 - If you define I18N2 at compile-time, then sorting/collation will be done
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2809 according to the locale returned by setlocale().
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2810
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2811 - If you define I18N3 at compile-time, then all messages printed by lemacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2812 will be filtered through the gettext() library routine, to enable the use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2813 of locale-specific translation catalogues. The current implementation of
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2814 this is quite dependent on Solaris 2, and has a very large impact on
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2815 existing code, therefore we are going to be making major changes soon.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2816 (You'll notice calls to `gettext' and `GETTEXT' scattered around much of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2817 the lisp and C code; ignore it, this will be going away.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2818
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2819 - If you define I18N4 at compile-time, then lemacs will internally use a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2820 wide representation of characters, enabling the use of large character
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2821 sets such as Kanji. This code is very OS dependent: it requires X11R5,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2822 and several OS-supplied library routines for reading and writing wide
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2823 characters (getwc(), putwc(), and a few others.) Performance is also a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2824 problem. This code is also scheduled for a major overhaul, with the
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2825 intent of improving performance and portability.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2826
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2827 Our eventual goal is to merge with MULE, or at least provide the same base
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2828 level of functionality. If you would like to help out with this, let us
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2829 know.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2830
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2831 - Other work-in-progress includes Motif drag-and-drop support, ToolTalk
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2832 support, and support for embedding an Emacs widget inside another
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2833 application (where it can function as that other application's text-entry
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2834 area). This code has not been extensively tested, and may (or may not)
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2835 have portability problems, but it's there for the adventurous. Comments,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2836 suggestions, bug reports, and especially fixes are welcome. But have no
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2837 expectations that this experimental code will work at all.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2838
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2839
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2840 ** Major Differences Between 19.6 and 19.8
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2841 ==========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2842
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2843 There were almost no differences between versions 19.6 and 19.7; version 19.7
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2844 was a bug-fix release that was distributed with Energize 2.1.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2845
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2846 Lucid Emacs 19.8 represents the first stage of the Lucid Emacs/Epoch merger.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2847 The redisplay engine now in lemacs is an improved descendant of the Epoch
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2848 redisplay. As a result, many bugs have been eliminated, and several disabled
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2849 features have been re-enabled. Notably:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2850
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2851 Selective display (and outline-mode) work.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2852
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2853 Horizontally split windows work.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2854
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2855 The height of a line is the height of the tallest font displayed on that line;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2856 it is possible for a screen to display lines of differing heights. (Previously,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2857 the height of all lines was the height of the tallest font loaded.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2858
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2859 There is lisp code to scale fonts up and down, for example, to load the next-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2860 taller version of a font.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2861
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2862 There is a new internal representation for lisp objects, giving emacs-lisp 28
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2863 bit integers and a 28 bit address space, up from the previous maximum of 26.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2864 We expect eventually to increase this to 30 bit integers and a 32 bit address
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2865 space, eliminating the need for DATA_SEG_BITS on some architectures. (On 64
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2866 bit machines, add 32 to all of these numbers.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2867
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2868 GC performance is improved.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2869
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2870 Various X objects (fonts, colors, cursors, pixmaps) are accessible as first-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2871 class lisp objects, with finalization.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2872
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2873 An alternate interface to embedding images in the text is provided, called
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2874 "annotations." You may create an "annotation margin" which is whitespace at
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2875 the left side of the screen that contains only annotations, not buffer text.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2876
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2877 When using XPM files, one can specify the values of logical color names to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2878 used when loading the files.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2879
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2880 It is possible to resize windows by dragging their modelines up and down. More
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2881 generally, it is possible to add bindings for mouse gestures on the modelines.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2882
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2883 There is support for playing sound files on HP machines.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2884
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2885 ILISP version 5.5 is included.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2886
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2887 The Common Lisp #' read syntax is supported (#' is to "function" as ' is to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2888 "quote".)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2889
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2890 The `active-p' slot of menu items is now evaluated, so one can put arbitrary
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2891 lisp code in a menu to decide whether that item should be selectable, rather
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2892 than doing this with an `activate-menubar-hook'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2893
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2894 The X resource hierarchy has changed slightly, to be more consistent. It used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2895 to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2896 argv[0] SCREEN-NAME pane screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2897 ApplicationShell EmacsShell Paned EmacsFrame
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2898
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2899 now it is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2900
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2901 argv[0] shell pane SCREEN-NAME
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2902 ApplicationShell EmacsShell Paned EmacsFrame
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2903
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2904 The Lucid Emacs sources have been largely merged with FSF version 19; this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2905 means that the lisp library contains the most recent releases of various
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2906 packages, and many new features of FSF 19 have been incorporated.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2907
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2908 Because of this, the lemacs sources should also be substantially more portable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2909
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2910
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2911 ** Major Differences Between 19.4 and 19.6
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2912 ==========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2913
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2914 There were almost no differences between versions 19.4 and 19.5; we fixed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2915 a few minor bugs and repacked 19.4 as 19.5 for a CD-ROM that we gave away
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2916 as a trade show promotion.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2917
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2918 The primary goal of the 19.6 release is stability, rather than improved
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2919 functionality, so there aren't many user-visible changes. The most notable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2920 changes are:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2921
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2922 - The -geometry command-line option now correctly overrides geometry
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2923 specifications in the resource database.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2924 - The `width' and `height' screen-parameters work.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2925 - Font-lock-mode considers the comment start and end characters to be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2926 a part of the comment.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2927 - The lhilit package has been removed. Use font-lock-mode instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2928 - vm-isearch has been fixed to work with isearch-mode.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2929 - new versions of ispell and calendar.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2930 - sccs.el has menus.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2931
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2932 Lots of bugs were fixed, including the problem that lemacs occasionally
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2933 grabbed the keyboard focus.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2934
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2935 Also, as of Lucid Emacs 19.6 and Energize 2.0 (shipping now) it is possible
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2936 to compile the public release of Lucid Emacs with support for Energize; so
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2937 now Energize users will be able to build their own Energize-aware versions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2938 of lemacs, and will be able to use newer versions of lemacs as they are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2939 released to the net. (Of course, this is not behavior covered by your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2940 Energize support contract; you do it at your own risk.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2941
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2942 I have not incorporated all portability patches that I have been sent since
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2943 19.4; I will try to get to them soon. However, if you need to make any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2944 changes to lemacs to get it to compile on your system, it would be quite
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2945 helpful if you would send me context diffs (diff -c) against version 19.6.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2946
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2947
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2948 ** Major Differences Between 19.3 and 19.4
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2949 ==========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2950
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2951 Prototypes have been added for all functions. Emacs compiles in the strict
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2952 ANSI modes of lcc and gcc, so portability should be vastly improved.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2953
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2954 Many many many many core leaks have been plugged, especially in screen
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2955 creation and deletion.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2956
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2957 The float support reworked to be more portable and ANSI conformant. This
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2958 resulted in these new configuration parameters: HAVE_INVERSE_HYPERBOLIC,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2959 HAVE_CBRT, HAVE_RINT, FLOAT_CHECK_ERRNO, FLOAT_CATCH_SIGILL,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2960 FLOAT_CHECK_DOMAIN. Let us know if you had to change the defaults on your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2961 architecture.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2962
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2963 The SunOS unexec has been rewritten, and now works with either static or
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2964 dynamic libraries, depending on whether -Bstatic or -Bdynamic were specified
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2965 at link-time.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2966
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2967 Small (character-sized) bitmaps can be mixed in with buffer text via the new
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2968 functions set-extent-begin-glyph and set-extent-end-glyph. (This is actually
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2969 a piece of functionality that Energize has been using for a while, but we've
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2970 just gotten around to making it possible to use it without Energize. See how
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2971 nice we are? Go buy our product.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2972
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2973 If compiled with Motif support, one can pop up dialog boxes from emacs lisp.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2974 We encourage someone to contribute Athena an version of this code; it
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2975 shouldn't be much work.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2976
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2977 If dialog boxes are available, then y-or-n-p and yes-or-no-p use dialog boxes
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2978 instead of the minibuffer if invoked as a result of a command that was
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2979 executed from a menu instead of from the keyboard.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2980
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2981 Multiple screen support works better; check out doc of get-screen-for-buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2982
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2983 The default binding of backspace is the same as delete. (C-h is still help.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2984
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
2985 A middle click while the minibuffer is active does completion if you click on
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2986 a highlighted completion, otherwise it executes the global binding of button2.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2987
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2988 New versions of Barry Warsaw's c++-mode and syntax.c. Font-lock-mode works
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2989 with C++ mode now.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2990
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2991 The semantics of activate-menubar-hook has changed; the functions are called
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2992 with no arguments now.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2993
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2994 `truename' no longer hacks the automounter; use directory-abbrev-alist instead.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2995
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2996 Most minibuffer handling has been reimplemented in emacs-lisp.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2997
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2998 There is now a builtin minibuffer history mechanism which replaces gmhist.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2999
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3000
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3001 ** Major Differences Between 19.2 and 19.3
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3002 ==========================================
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3003
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3004 The ISO characters have correct case and syntax tables now, so the word-motion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3005 and case-converting commands work sensibly on them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3006
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3007 If you set ctl-arrow to an integer, you can control exactly which characters
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3008 are printable. (There will be a less crufty way to do this eventually.)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3009
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3010 Menubars can now be buffer local; the function set-screen-menubar no longer
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
3011 exists. Look at GNUS and VM for examples of how to do this, or read
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3012 menubar.el.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3013
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3014 When emacs is reading from the minibuffer with completions, any completions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3015 which are visible on the screen will highlight when the mouse moves over them;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3016 clicking middle on a completion is the same as typing it at the minibuffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3017 Some implications of this: The *Completions* buffer is always mousable. If
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3018 you're using the completion feature of find-tag, your source code will be
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
3019 mousable when you type M-. Dired buffers will be mousable as soon as you
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3020 type ^X^F. And so on.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3021
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3022 The old isearch code has been replaced with a descendant of Dan LaLiberte's
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3023 excellent isearch-mode; it is more customizable, and generally less bogus.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3024 You can search for "composed" characters. There are new commands, too; see
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3025 the doc for ^S, or the NEWS file.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3026
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3027 A patched GNUS 3.14 is included.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3028
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3029 The user's manual now documents Lucid Emacs 19.3.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3030
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3031 A few more modes have mouse and menu support.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3032
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3033 The startup code should be a little more robust, and give you more reasonable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3034 error messages when things aren't installed quite right (instead of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3035 ubiquitous "cannot open DISPLAY"...)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3036
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3037 Subdirectories of the lisp directory whose names begin with a hyphen or dot
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3038 are not automatically added to the load-path, so you can use this to avoid
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3039 accidentally inflicting experimental software on your users.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3040
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3041 I've tried to incorporate all of the portability patches that were sent to
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
3042 me; I tried to solve some of the problems in different ways than the
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3043 patches did, so let me know if I missed something.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3044
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3045 Some systems will need to define NEED_STRDUP, NEED_REALPATH, HAVE_DREM, or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3046 HAVE_REMAINDER in config.h. Really this should be done in the appropriate
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3047 s- or m- files, but I don't know which systems need these and which don't.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3048 If yours does, let me know which file it should be in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3049
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3050 Check out these new packages:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3051
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3052 blink-paren.el: causes the matching parenthesis to flash on and off whenever
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3053 the cursor is sitting on a paren-syntax character.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3054
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3055 pending-del.el: Certain commands implicitly delete the highlighted region:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3056 Typing a character when there is a highlighted region replaces
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3057 that region with the typed character.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3058
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3059 font-lock.el: A code-highlighting package, driven off of syntax tables, so
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 56
diff changeset
3060 that it understands block comments, strings, etc. The
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3061 insertion hook is used to fontify text as you type it in.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3062
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3063 shell-font.el: Displays your shell-buffer prompt in boldface.