126
|
1 -*- mode:outline -*-
|
|
2
|
0
|
3 * Introduction
|
|
4 ==============
|
|
5
|
223
|
6 This file presents some general information about XEmacs. It is
|
276
|
7 primarily about the changes in recent XEmacs versions and its release
|
|
8 history.
|
223
|
9
|
|
10 Use `C-c C-f' to move to the next equal level of outline, and
|
|
11 `C-c C-b' to move to previous equal level. `C-h m' will give more
|
|
12 info about the Outline mode. Many commands are also available through
|
|
13 the menubar.
|
126
|
14
|
|
15 Users who would like to know which capabilities have been introduced
|
223
|
16 in each release should look at the appropriate section of this file.
|
|
17 Starting with version 20.0, XEmacs includes ChangeLogs, which can be
|
|
18 consulted for a more detailed list of changes.
|
|
19
|
|
20 Users interested in some of the details of how XEmacs differs from GNU
|
|
21 Emacs should read the section "What's Different?" near the end of this
|
|
22 file.
|
|
23
|
225
|
24 N.B. The term "GNU Emacs" refers to any release of Emacs Version
|
|
25 19 from the Free Software Foundation's GNU Project. (We do not
|
|
26 say just "Emacs" as Richard M. Stallman ["RMS"] prefers, because
|
|
27 it is clearly a more generic term.) The term "XEmacs" refers to
|
223
|
28 this program or to its predecessors "Era" and "Lucid Emacs". The
|
|
29 predecessor of all these program is called "Emacs 18". When no
|
|
30 particular version is implied, "Emacs" will be used.
|
126
|
31
|
|
32
|
274
|
33 * Changes in XEmacs 21.0
|
209
|
34 ========================
|
|
35
|
219
|
36 ** XEmacs has been unbundled into constituent installable packages.
|
298
|
37 See the Info documentation under "Packages" for more information.
|
|
38 See the file `etc/PACKAGES' in the distribution for a partial list of
|
|
39 packages available at the time of the 21.0 release.
|
219
|
40
|
290
|
41 ** XEmacs is now supported under Microsoft Windows 95/98 and Windows
|
|
42 NT operating systems. For starters, look at the XEmacs on Windows FAQ
|
294
|
43 at <URL:http://jagor.srce.hr/~hniksic/xemacs-on-windows-faq.txt>. To
|
290
|
44 discuss Windows-specific issues, subscribe to the mailing list at
|
|
45 <xemacs-nt-request@xemacs.org>.
|
|
46
|
|
47 ** XEmacs will now use `XEmacs' as its application class if it finds
|
|
48 any `XEmacs' resources in the resource database. Otherwise, it will
|
|
49 continue to use the `Emacs' class.
|
|
50
|
294
|
51 ** The options menu has been ported to Custom.
|
|
52 This means that each entry in the options menu acts as if you had customized
|
|
53 the corresponding variable by hand. ### WARNING: there is currently no
|
|
54 upgrading function to help you port your old options settings to the new
|
|
55 format. Consequently, if you want to modify the options for XEmacs 21, you
|
|
56 will have to set them all again through the menu, and remove the code loading
|
|
57 .xemacs-options from your .emacs.
|
|
58
|
278
|
59 ** When the Zmacs region is active, `M-x query-replace' and the other
|
|
60 replace commands now operate on the region contents only.
|
|
61
|
223
|
62 ** Using the new `-private' option, you can make XEmacs use a private
|
|
63 colormap.
|
|
64
|
284
|
65 ** The `imenu' package has been ported to XEmacs and is available as a
|
|
66 package.
|
|
67
|
219
|
68 ** `echo-keystrokes' can now be a floating-point number, so that you
|
276
|
69 can set it to intervals shorter than one second.
|
219
|
70
|
|
71 (setq echo-keystrokes 0.1)
|
|
72
|
280
|
73 ** The new command `center-to-window-line' works like `recenter'
|
|
74 (bound to `C-l'), only it does not redisplay the whole display area.
|
|
75
|
284
|
76 ** The M-. command will now first search through exact tags matches,
|
219
|
77 and then through inexact matches, as one would expect.
|
|
78
|
223
|
79 ** The new variable `user-full-name' can be used to customize one's
|
|
80 name when using the Emacs mail and news reading facilities.
|
|
81
|
|
82 Normally, `user-full-name' is a function that returns the full name of
|
|
83 a user or UID, as specified by the system -- for instance,
|
|
84 (user-full-name "root") returns something like "Super-User". However,
|
|
85 when the function is called without arguments, it will return the
|
|
86 value of the `user-full-name' variable. The `user-full-name' variable
|
|
87 is initialized using the environment variable NAME and (failing that)
|
|
88 the user's system name.
|
|
89
|
225
|
90 The behaviour of the `user-full-name' function with an argument
|
|
91 specified is unchanged.
|
223
|
92
|
|
93 ** The new command `M-x customize-changed-options' lets you customize
|
|
94 all the options whose default values have changed in recent Emacs
|
|
95 versions. You specify a previous Emacs version number as argument,
|
|
96 and the command creates a customization buffer showing all the
|
|
97 customizable options whose default values were changed since that
|
|
98 version.
|
|
99
|
|
100 If you don't specify a particular version number argument, then the
|
|
101 customization buffer shows all the customizable options for which
|
|
102 Emacs versions of changes are recorded.
|
|
103
|
249
|
104 ** The new command `add-log-convert' can be used to convert the
|
|
105 old-style (pre-20.3) ChangeLog buffers to new style, for
|
|
106 consistency. A reminder: if you wish to revert to old-style
|
|
107 ChangeLogs instead, customize the value of `add-log-time-format'
|
|
108 variable.
|
|
109
|
284
|
110 ** The new command `zap-up-to-char' is now available. It is similar
|
|
111 to `zap-to-char', except that it does not delete the searched-for
|
|
112 character. It is not bound to a key by default.
|
|
113
|
|
114 ** You can now store a number into a register with `C-u NUMBER C-x r n'
|
|
115 REG, increment it by INC with `C-u INC C-x r + REG' (to increment by
|
|
116 one, omit C-u INC), and insert it in the buffer with `C-x r g REG'.
|
|
117 This is useful for writing keyboard macros.
|
|
118
|
|
119 ** The M-: command, when given a prefix argument, will now insert its
|
|
120 result to the current buffer.
|
|
121
|
|
122 ** The `C-h c' command, when given a prefix argument, will now insert
|
|
123 the message into the current buffer.
|
|
124
|
298
|
125 ** Horizontally split windows may now be dragged using the mouse.
|
|
126 Because of this, the dividers between vertical windows are always
|
|
127 visible. To turn it off, set `vertical-divider-always-visible-p' to
|
|
128 nil.
|
286
|
129
|
223
|
130 ** XEmacs/Mule (internationalization) changes.
|
|
131
|
284
|
132 *** Mule support now works on TTY's. Use `set-terminal-coding-system'
|
|
133 and `set-keyboard-coding-system' to specify the coding system of your
|
|
134 display and keyboard.
|
274
|
135
|
225
|
136 *** Egg/SJ3 input method is now officially supported. Quail and
|
|
137 Egg/Skk have been available through the generalized Leim since 20.3.
|
223
|
138
|
|
139 *** Localized Japanese menubars are available if XEmacs is built with
|
|
140 XFONTSET and either the X11 libraries are built with X_LOCALE defined
|
|
141 or the native C libraries support Japanese localization. This has
|
|
142 been available since 20.3, only it hasn't been announced before.
|
219
|
143
|
290
|
144 ** Jamie Zawinski's `gdb-highlight' extension is now distributed with
|
284
|
145 the `debug' package. gdb-highlight makes most objects printed in a
|
|
146 gdb buffer be mouse-sensitive: as text shows up in the buffer, it is
|
|
147 parsed, and objects which are recognized have context-sensitive
|
|
148 commands attached to them. To use it, add the following to `.emacs':
|
|
149
|
286
|
150 (add-hook 'gdb-mode-hook (lambda () (require 'gdb-highlight)))
|
284
|
151
|
290
|
152 ** The package popper.el is now included in the edit-utils package.
|
|
153 It has been greatly enhanced with respect to the one once included
|
|
154 with the ilisp package and should work well under XEmacs 21.0.
|
|
155
|
278
|
156 ** C mode changes
|
|
157
|
|
158 *** Multiline macros are now handled, both as they affect indentation,
|
|
159 and as recognized syntax. New syntactic symbol cpp-macro-cont is
|
|
160 assigned to second and subsequent lines of a multiline macro
|
|
161 definition.
|
|
162
|
|
163 *** A new style "user" which captures all non-hook-ified
|
|
164 (i.e. top-level) .emacs file variable setings and customizations.
|
|
165 Style "cc-mode" is an alias for "user" and is deprecated. "gnu" style
|
|
166 is still the default however.
|
|
167
|
|
168 *** "java" style now conforms to Sun's JDK coding style.
|
|
169
|
|
170 *** There are new commands c-beginning-of-defun, c-end-of-defun which
|
|
171 are alternatives which you could bind to C-M-a and C-M-e if you prefer
|
|
172 them. They do not have key bindings by default.
|
|
173
|
|
174 *** New and improved implementations of M-a (c-beginning-of-statement)
|
|
175 and M-e (c-end-of-statement).
|
|
176
|
|
177 *** C++ namespace blocks are supported, with new syntactic symbols
|
|
178 namespace-open, namespace-close, and innamespace.
|
|
179
|
|
180 *** File local variable settings of c-file-style and c-file-offsets
|
|
181 makes the style variables local to that buffer only.
|
|
182
|
|
183 *** New indentation functions c-lineup-close-paren,
|
|
184 c-indent-one-line-block, c-lineup-dont-change.
|
|
185
|
|
186 *** Improvements (hopefully!) to the way CC Mode is loaded. You
|
|
187 should now be able to do a (require 'cc-mode) to get the entire
|
|
188 package loaded properly for customization in your .emacs file. A new
|
|
189 variable c-initialize-on-load controls this and is t by default.
|
|
190
|
251
|
191 ** In Text mode, now only blank lines separate paragraphs.
|
|
192 This makes it possible to get the full benefit of Adaptive Fill mode
|
|
193 in Text mode, and other modes derived from it (such as Mail mode).
|
278
|
194 TAB in Text mode now runs the command indent-relative; this makes a
|
|
195 practical difference only when you use indented paragraphs.
|
251
|
196
|
|
197 As a result, the old Indented Text mode is now identical to Text mode,
|
|
198 and is an alias for it.
|
|
199
|
|
200 If you want spaces at the beginning of a line to start a paragraph,
|
|
201 use the new mode, Paragraph Indent Text mode.
|
|
202
|
298
|
203 ** Changes to Gnus, the XEmacs newsreader.
|
|
204
|
|
205 *** New functionality for using Gnus as an offline newsreader has been
|
|
206 added. A plethora of new commands and modes have been added. See the
|
|
207 Gnus manual for the full story.
|
|
208
|
|
209 *** The nndraft backend has returned, but works differently than
|
|
210 before. All Message buffers are now also articles in the nndraft
|
|
211 group, which is created automatically.
|
|
212
|
|
213 *** `gnus-alter-header-function' can now be used to alter header
|
|
214 values.
|
|
215
|
|
216 *** `gnus-summary-goto-article' now accept Message-ID's.
|
|
217
|
|
218 *** A new Message command for deleting text in the body of a message
|
|
219 outside the region: `C-c C-v'.
|
|
220
|
|
221 *** You can now post to component group in nnvirtual groups with
|
|
222 `C-u C-c C-c'.
|
|
223
|
|
224 *** `nntp-rlogin-program' -- new variable to ease customization.
|
|
225
|
|
226 *** `C-u C-c C-c' in `gnus-article-edit-mode' will now inhibit
|
|
227 re-highlighting of the article buffer.
|
|
228
|
|
229 *** New element in `gnus-boring-article-headers' -- `long-to'.
|
|
230
|
|
231 *** `M-i' symbolic prefix command. See the section "Symbolic
|
|
232 Prefixes" in the Gnus manual for details.
|
|
233
|
|
234 *** `L' and `I' in the summary buffer now take the symbolic prefix
|
|
235 `a' to add the score rule to the "all.SCORE" file.
|
|
236
|
|
237 *** `gnus-simplify-subject-functions' variable to allow greater
|
|
238 control over simplification.
|
|
239
|
|
240 *** `A T' -- new command for fetching the current thread.
|
|
241
|
|
242 *** `/ T' -- new command for including the current thread in the
|
|
243 limit.
|
|
244
|
|
245 *** `M-RET' is a new Message command for breaking cited text.
|
|
246
|
|
247 *** \\1-expressions are now valid in `nnmail-split-methods'.
|
|
248
|
|
249 *** The `custom-face-lookup' function has been removed.
|
|
250 If you used this function in your initialization files, you must
|
|
251 rewrite them to use `face-spec-set' instead.
|
|
252
|
|
253 *** Cancelling now uses the current select method. Symbolic prefix
|
|
254 `a' forces normal posting method.
|
|
255
|
|
256 *** New command to translate M******** sm*rtq**t*s into proper text
|
|
257 -- `W d'.
|
|
258
|
|
259 *** For easier debugging of nntp, you can set `nntp-record-commands'
|
|
260 to a non-nil value.
|
|
261
|
|
262 *** nntp now uses ~/.authinfo, a .netrc-like file, for controlling
|
|
263 where and how to send AUTHINFO to NNTP servers.
|
|
264
|
|
265 *** A command for editing group parameters from the summary buffer
|
|
266 has been added.
|
|
267
|
|
268 *** A history of where mails have been split is available.
|
|
269
|
|
270 *** A new article date command has been added -- `article-date-iso8601'.
|
|
271
|
|
272 *** Subjects can be simplified when threading by setting
|
|
273 `gnus-score-thread-simplify'.
|
|
274
|
|
275 *** A new function for citing in Message has been added --
|
|
276 `message-cite-original-without-signature'.
|
|
277
|
|
278 *** `article-strip-all-blank-lines' -- new article command.
|
|
279
|
|
280 *** A new Message command to kill to the end of the article has
|
|
281 been added.
|
|
282
|
|
283 *** A minimum adaptive score can be specified by using the
|
|
284 `gnus-adaptive-word-minimum' variable.
|
|
285
|
|
286 *** The "lapsed date" article header can be kept continually
|
|
287 updated by the `gnus-start-date-timer' command.
|
|
288
|
|
289 *** Web listserv archives can be read with the nnlistserv backend.
|
|
290
|
|
291 *** Old dejanews archives can now be read by nnweb.
|
|
292
|
|
293 *** Byte-compilation of user-specs now works under XEmacs.
|
|
294
|
290
|
295 ** The `dir' files are no longer essential for functioning of the Info
|
|
296 subsystem. If the `dir' file does not exist in an Info directory, the
|
|
297 relevant information will be generated on-the-fly.
|
278
|
298
|
292
|
299 This behaviour can be customized, look for `Info-auto-generate-directory'
|
|
300 and `Info-save-auto-generated-dir' in the `info' customization group.
|
278
|
301
|
304
|
302 ** Version Control is no longer automatically loaded. Users must
|
|
303 add:
|
|
304
|
|
305 (require 'vc-hooks)
|
|
306
|
|
307 to their .emacs file to get version control functionality.
|
|
308
|
308
|
309 ** The EDiff menus are no longer included in the default menubar.
|
|
310 Users must add:
|
|
311
|
|
312 (require 'ediff-hook)
|
|
313
|
|
314 to their .emacs file to get the menus.
|
|
315
|
306
|
316 ** An experimental version of dynamic linking is supported.
|
|
317
|
|
318 There is no documentation and we are making no guarantees about what
|
|
319 might change in the future with the "C" level API. Examples of how to
|
|
320 make DLLs are in the modules subdirectory of the XEmacs source
|
|
321 distribution.
|
|
322
|
|
323 Please note that XEmacs is a GPL'ed program and there are restrictions
|
|
324 on what kinds of binaries can be distributed with it. In particular,
|
|
325 proprietary DLLs without source cannot be distributed. See the file
|
|
326 COPYING for more detail.s
|
219
|
327
|
274
|
328 * Lisp and internal changes in XEmacs 21.0
|
219
|
329 ==========================================
|
|
330
|
274
|
331 ** It is now possible to build XEmacs with support for 31-bit Lisp
|
|
332 integers (normally, Lisp integers are only 28 bits wide on 32-bit
|
|
333 machines.) Configure with --use-minimal-tagbits to test. With this
|
284
|
334 change, the maximum buffer size on 32-bit machines is increased from
|
|
335 128M to 1G. This setting will be made default in a future XEmacs
|
|
336 version.
|
|
337
|
286
|
338 ** Specifier changes.
|
|
339
|
|
340 *** When instantiating a specifier, the window locale now has a higher
|
|
341 precedence than the buffer locale. This is because the window locale
|
|
342 is more specific than the buffer locale.
|
|
343
|
290
|
344 *** The new macro `let-specifier' can be used to temporarily add
|
|
345 specifications to specifiers. See the documentation for details.
|
|
346
|
286
|
347 *** The new specifiers `vertical-scrollbar-visible-p' and
|
|
348 `horizontal-scrollbar-visible-p' may be used to control scrollbar
|
290
|
349 visibility. Previously, the only way to remove a scrollbar was to set
|
|
350 its size to 0. This method is still supported for backward
|
|
351 compatibility.
|
286
|
352
|
|
353 *** The new specifiers `scrollbar-on-left-p' and `scrollbar-on-top-p'
|
|
354 may be used to control the position of the vertical and horizontal
|
|
355 toolbar. Previously, their position could be changed only through the
|
|
356 use of X resources.
|
|
357
|
|
358 *** The new draggable vertical dividers between windows may be turned
|
298
|
359 off using the `vertical-divider-always-visible-p' specifier. When
|
|
360 this is set to nil, the vertical dividers between windows are shown
|
|
361 only when needed, and they are not draggable.
|
286
|
362
|
|
363 Other properties of the vertical dividers may be controlled using
|
|
364 `vertical-divider-shadow-thickness', `vertical-divider-line-width' and
|
|
365 `vertical-divider-spacing' specifiers, which see.
|
|
366
|
284
|
367 ** Frame focus management changes.
|
|
368
|
|
369 *** When the variable focus-follows-mouse is non-nil, `select-frame'
|
|
370 no longer permanently selects a different frame. The frame selection
|
|
371 is temporary and is reverted when the current command terminates, much
|
|
372 like the buffer selected by `set-buffer'. This is the same as in FSF
|
|
373 Emacs.
|
|
374
|
|
375 *** The new function `focus-frame' sets the window system focus to
|
|
376 FRAME (and selects it), regardless of the value of
|
|
377 `focus-follows-mouse'. Doing this is not well behaved, so be
|
|
378 absolutely sure that you want this.
|
|
379
|
|
380 The code that uses `select-frame' only to get the window manager focus
|
|
381 should be changed to use `set-frame-focus' instead, so that they keep
|
|
382 working when `focus-follows-mouse' is non-nil.
|
|
383
|
|
384 *** The special forms `save-selected-frame' and `with-selected-frame'
|
|
385 can now be used to temporarily change selected frame.
|
|
386
|
|
387 *** The behavior of `other-frame' command (`C-x 5 o') is unaffected by
|
|
388 these changes.
|
280
|
389
|
290
|
390 ** The function `select-window' now has an optional second argument
|
|
391 NORECORD which if non-nil inhibits the recording of a buffer change.
|
|
392
|
|
393 ** The function `vertical-motion' now correctly handles the second,
|
|
394 optional WINDOW argument. A new third argument PIXELS, if non-nil,
|
|
395 indicates that the returned motion should be in pixels.
|
|
396
|
|
397 ** The new function `vertical-motion-pixels' is similar to
|
|
398 vertical-motion but takes as input a vertical motion in pixels.
|
|
399
|
|
400 ** The new functions window-text-area-pixel-{width,height,edges} can
|
|
401 be used to obtain information about the text-displaying area of a
|
|
402 window.
|
|
403
|
|
404 ** The new functions `shrink-window-pixels' and `enlarge-window-pixels'
|
|
405 can be used to adjust the size of a window by a pixel amount.
|
|
406
|
|
407 ** The new function `window-displayed-text-pixel-height' can be used
|
|
408 to determine the height of the text actually displayed in a window.
|
|
409
|
284
|
410 ** The arithmetic comparison functions <, >, =, /= now accept a
|
|
411 variable number of arguments.
|
280
|
412
|
|
413 This means that if you want to test whether A < B < C, you can write
|
|
414 it as (< A B C) instead of (and (< A B) (< B C)). Likewise,
|
|
415 (apply #'> LIST) now tests if LIST is monotonously increasing -- and
|
|
416 so on.
|
|
417
|
223
|
418 ** The XEmacs hashtables now have a consistent read/print syntax.
|
|
419 This means that a hashtable will be readably printed in a
|
|
420 structure-like form:
|
|
421
|
|
422 #s(hashtable size 2 data (key1 value1 key2 value2))
|
|
423
|
|
424 When XEmacs reads this form, it will create a new hashtable according
|
|
425 to description. This allows you to easily dump hashtables to files
|
|
426 using `prin1', and read them back in using `read'.
|
|
427
|
|
428 If `print-readably' is non-nil, a more relaxed syntax is used; for
|
|
429 instance:
|
|
430
|
|
431 #<hashtable size 2/13 data (key1 value1 key2 value2) 0x874d>
|
|
432
|
286
|
433 ** It is now possible to build XEmacs with LDAP support.
|
|
434 You will need to install a LDAP library first. The following have
|
|
435 been tested:
|
|
436 - LDAP 3.3 from the University of Michigan
|
|
437 (get it from <URL:http://www.umich.edu/~dirsvcs/ldap/>)
|
|
438 - LDAP SDK 1.0 from Netscape Corp.
|
|
439 (get it from <URL:http://developer.netscape.com/>)
|
284
|
440
|
241
|
441 ** When profiling is in effect, a call-count of all recorded functions
|
|
442 is now calculated. This information is stored in
|
|
443 `call-count-profile-table', and is utilized by `profile-results' as
|
286
|
444 well as the new command `profile-call-count-results'.
|
241
|
445
|
284
|
446 ** It is now an error to change the value of a symbol whose name
|
|
447 starts with a colon, if it is interned in the standard obarray.
|
|
448
|
|
449 However, setting such a symbol to its proper value, which is that
|
|
450 symbol itself, is not an error. This is for the sake of programs that
|
|
451 support pre-19.12 XEmacs and pre-20 GNU Emacs by explicitly setting
|
|
452 these variables to themselves.
|
|
453
|
|
454 ** The `concat' function no longer accepts integer arguments.
|
|
455
|
278
|
456 ** The new function `string' concatenates all its argument characters
|
|
457 and returns the resulting string. This is consistent with other
|
|
458 functions, like `list', `vector', etc.
|
|
459
|
290
|
460 ** The function `temp-directory' is now available to return the
|
|
461 directory to store temporary files. On Unix this will be obtained
|
|
462 from TMPDIR, defaulting to `/tmp'.
|
|
463
|
284
|
464 ** The function load-average now accepts an optional argument
|
|
465 USE-FLOATS. If it is non-nil, the load average values are returned as
|
|
466 floating point numbers, rather than as integers to be divided by 100.
|
278
|
467
|
223
|
468 ** The `make-event' function now supports the TYPE and PLIST
|
276
|
469 arguments, which can be used to create various events from Lisp. See
|
|
470 the documentation for details.
|
223
|
471
|
219
|
472 ** `function-interactive' is a new function that returns the
|
|
473 interactive specification of a funcallable object.
|
|
474
|
|
475 ** The new `lmessage' function allows printing of a formatted message
|
|
476 with a particular label.
|
|
477
|
223
|
478 (lmessage 'progress "Processing... %d" counter)
|
219
|
479
|
|
480 This function is more convenient than `display-message' because it
|
|
481 automatically applies `format' to its arguments.
|
|
482
|
|
483 ** The new `lwarn' function, analogous to `lmessage', allows printing
|
|
484 a formatted warning, with a non-default CLASS or LABEL.
|
|
485
|
284
|
486 ** The new function `split-path' can now be used to explode the
|
|
487 components of a colon-separated search path into a list.
|
|
488
|
|
489 (split-path "foo:bar")
|
|
490 => ("foo" "bar")
|
|
491
|
274
|
492 ** Specifiers and symbols whose value is a specifier are now allowed
|
276
|
493 as modeline specifications.
|
274
|
494
|
|
495 ** defcustom now accepts the keyword `:version'. Use this to specify
|
|
496 in which version of Emacs a certain variable's default value changed.
|
|
497 For example,
|
|
498
|
|
499 (defcustom foo-max 34 "*Maximum number of foo's allowed."
|
|
500 :type 'integer
|
|
501 :group 'foo
|
276
|
502 :version "21.0")
|
274
|
503
|
|
504 This information is used to control the customize-changed-options
|
|
505 command.
|
|
506
|
225
|
507 ** The line number tracking in modeline is now efficient, even for
|
|
508 very large buffers. This is achieved by caching the line numbers of
|
|
509 recent buffer positions, and reusing them. This cache is used only in
|
|
510 the buffers where `line-number-mode' is in effect.
|
259
|
511
|
274
|
512 ** When the new GNU Malloc aka Doug Lea Malloc is available, it will
|
|
513 be used. This should result in better performance on Linux systems
|
|
514 with libc6.
|
|
515
|
276
|
516 ** The code XEmacs uses to assemble its various paths into the
|
|
517 directory hierarchy has been rewritten to support the package system.
|
298
|
518 Look under "Startup Paths" in the Info documentation for more
|
|
519 information.
|
276
|
520
|
304
|
521 *** site-lisp is no longer part of the load-path by default.
|
276
|
522 Its use is deprecated, but you can specify --with-site-lisp=yes at the
|
|
523 configure command line to get it back.
|
|
524
|
|
525 *** `Info-default-directory-list' is now obsolete. If you want to
|
|
526 change the path which XEmacs uses to search for info files, set
|
|
527 `Info-directory-list' instead.
|
259
|
528
|
241
|
529
|
|
530 * Changes in XEmacs 20.4
|
|
531 ========================
|
|
532
|
|
533 ** XEmacs 20.4 is a bugfix release with no user-visible changes.
|
225
|
534
|
219
|
535
|
153
|
536 * Changes in XEmacs 20.3
|
|
537 ========================
|
|
538
|
163
|
539 ** Quail input method is now available.
|
|
540
|
193
|
541 Quail is a simple key-translation system that allows users to input
|
165
|
542 any multilingual text from normal ASCII keyboard. This means that
|
|
543 XEmacs with Mule now supports a number of European languages.
|
163
|
544
|
215
|
545 ** More Windows NT support.
|
|
546
|
|
547 Thanks to efforts of many people, coordinated by David Hobley
|
|
548 <davidh@wr.com.au> and Marc Paquette <marcpa@cam.org>, beta versions
|
|
549 of XEmacs now run on 32-bit Windows platforms (Windows NT and Windows
|
|
550 95). The current betas require having an X server to run XEmacs;
|
|
551 however, a native NT/95 port is in alpha, thanks to Jonathan Harris
|
|
552 <jhar@tardis.ed.ac.uk>.
|
|
553
|
|
554 The NT development is now coordinated by a mailing list at
|
|
555 <xemacs-nt@xemacs.org>. Mail to <xemacs-nt-request@xemacs.org> to
|
|
556 subscribe.
|
153
|
557
|
|
558 ** Multiple TTY frames are now available.
|
|
559
|
|
560 On consoles that display only one frame at a time (e.g. TTY consoles),
|
|
561 creating a new frame with `C-x 5 2' also raises and selects that
|
|
562 frame. The behavior of window system frames is unchanged.
|
|
563
|
207
|
564 ** Package starting changes.
|
|
565
|
|
566 State of Emacs should never be changed with loading a package. The
|
|
567 following XEmacs packages that used to break this have been changed.
|
|
568
|
|
569 *** Loading `paren' no longer enables paren-blinking. Use
|
|
570 `paren-set-mode' explicitly, or customize `paren-mode'.
|
|
571
|
|
572 *** Loading `uniquify' no longer enables uniquify. Set
|
|
573 `uniquify-buffer-name-style' to a legal value.
|
|
574
|
|
575 *** Loading `time' no longer enables display time. Invoke
|
|
576 `display-time' explicitly.
|
|
577
|
|
578 *** Loading `jka-compr' no longer enables on-the-fly compression. Use
|
|
579 `toggle-auto-compression' instead.
|
|
580
|
|
581 *** Loading `id-select' no longer enables its behaviour. Use
|
|
582 `id-select-install' instead.
|
|
583
|
173
|
584 ** Zmacs region is not deactivated when an error is signaled.
|
|
585
|
|
586 The behavior of the zmacs region can now be controlled in the event of
|
|
587 a signaled error. The new variable `errors-deactivate-region' may be
|
|
588 set to nil to revert to the old behaviour. As before, typing C-g
|
193
|
589 deactivates the region.
|
173
|
590
|
207
|
591 ** Multiple Info `dir' functionality has been merged with GNU Emacs
|
|
592 19.34.
|
|
593
|
|
594 XEmacs will now correctly merge all the `dir' files in
|
243
|
595 `Info-directory-list' (initialized from either the `INFOPATH'
|
207
|
596 env. variable or `Info-default-directory-list'.) These files may be
|
|
597 full-fledged info files containing subnodes or menus. Previously
|
|
598 supported `localdir' files are looked for also, secondary to `dir's.
|
|
599 See the manual for details.
|
169
|
600
|
167
|
601 ** Abbreviations can now contain non-word characters.
|
|
602
|
|
603 This means that it is finally possible to do such simple things as
|
193
|
604 define `#in' to expand to `#include' in C mode, `s-c-b' to
|
167
|
605 `save-current-buffer' in Lisp mode, `call/cc' to
|
|
606 `call-with-current-continuation' in Scheme mode, etc.
|
|
607
|
159
|
608 ** `C-x n d' now runs the new command `narrow-to-defun',
|
157
|
609 which narrows the accessible parts of the buffer to just
|
|
610 the current defun.
|
|
611
|
159
|
612 ** The new command `C-x 4 0' (kill-buffer-and-window) kills the
|
157
|
613 current buffer and deletes the selected window. It asks for
|
|
614 confirmation first.
|
|
615
|
207
|
616 ** `ESC ESC ESC' (keyboard-escape-quit) will now correctly abort
|
|
617 recursive edits (as documented.)
|
|
618
|
165
|
619 ** arc-mode has a new function called `archive-quit' bound to q, which
|
|
620 quits archive mode in the same fashion dired-quit works.
|
207
|
621
|
|
622 ** A `tetris' clone is now available within XEmacs, written by Glynn
|
|
623 Clements. Try it out with `M-x tetris'.
|
165
|
624
|
167
|
625 ** The feature to teach the key bindings of extended commands now
|
|
626 prints the message after the command finishes. After some time, the
|
193
|
627 previous echo area contents are restored (in case the command prints
|
|
628 something useful).
|
165
|
629
|
195
|
630 ** If you set scroll-conservatively to a small number, then when you
|
|
631 move point a short distance off the screen, XEmacs will scroll the
|
|
632 screen just far enough to bring point back on screen, provided that
|
|
633 does not exceed `scroll-conservatively' lines.
|
|
634
|
197
|
635 ** Face background colors now take precedence over the default face
|
|
636 background pixmap, which means that background pixmaps no longer clash
|
|
637 with zmacs-regions, or clickable buttons.
|
|
638
|
207
|
639 ** Regexps can now contain additional Perl-like constructs.
|
|
640
|
|
641 ** Modifiers can be added to a keystroke by preceding it with a `C-x @
|
|
642 <x>' sequence where <x> is one of letters `S', `c', `m', `a', `h', `s'
|
|
643 corresponding to shift, control, meta, alt, hyper, and super modifiers,
|
|
644 respectively. It is possible to add several modifiers by repeating this
|
|
645 sequence. This feature is especially useful on text terminals where it
|
|
646 allows one to enter keystrokes like, e.g., `M-home'.
|
|
647
|
209
|
648 ** An arbitrary keystroke can be generated by entering `C-x @ k
|
|
649 <keysym-name> RET'. For example a sequence:
|
|
650
|
|
651 C-x @ c C-x @ k b a c k s p a c e RET
|
|
652
|
|
653 will result in a `C-backspace' keystroke even on text terminals.
|
|
654
|
195
|
655 ** Customize changes.
|
|
656
|
|
657 *** Customize has undergone a massive speedup, and should now operate
|
|
658 acceptably fast. Slowness of the interface used to be the biggest
|
|
659 gripe.
|
|
660
|
|
661 *** Many more packages have been modified to use the facility, so
|
207
|
662 almost all of XEmacs options can now be examined through the Customize
|
195
|
663 groups.
|
|
664
|
|
665 *** There is a new `browser' mode of traversing customizations, in
|
|
666 many ways easier to follow than the standard one. Try it out with
|
|
667 `M-x customize-browse'.
|
|
668
|
189
|
669 ** Pending-delete changes.
|
|
670
|
|
671 *** Pending-delete is now a minor mode, with the normal minor-mode
|
|
672 semantics and toggle functions. Old functions are left for
|
|
673 compatibility.
|
|
674
|
|
675 *** Loading pending-del no longer turns on pending-delete mode. In
|
|
676 fact, it is no longer necessary to explicitly load pending-del. All
|
|
677 you need to do to turn on pending-delete is run the pending-delete
|
|
678 function:
|
|
679
|
|
680 Within XEmacs: Type M-x pending-delete <ret>
|
|
681 not M-x load-library <ret> pending-delete <ret>
|
|
682
|
|
683 In .emacs: Use (turn-on-pending-delete)
|
|
684 not (load "pending-del")
|
|
685
|
157
|
686 ** XEmacs can now save the minibuffer histories from various
|
|
687 minibuffers. To use this feature, add the line:
|
|
688
|
|
689 (savehist-load)
|
|
690
|
|
691 to your .emacs. This will load the minibuffer histories (if any) at
|
|
692 startup, as well as instruct XEmacs to save them before exiting. You
|
|
693 can use Customize to add or remove the histories being saved.
|
|
694
|
163
|
695 ** The default format for ChangeLog entries (as created by `C-x 4 a')
|
|
696 is now the international ISO 8601 format.
|
|
697
|
|
698 To revert to the old behaviour, use:
|
|
699
|
|
700 (setq add-log-time-format 'current-time-string)
|
|
701
|
197
|
702 Or `M-x customize RET add-log RET'.
|
|
703
|
207
|
704 ** In ChangeLog mode, you can now press `C-c C-c' to save the file
|
|
705 and restore old window configuration, or `C-c C-k' to abandon the
|
|
706 changes.
|
|
707
|
197
|
708 ** The key `C-x m' no longer runs the `mail' command directly.
|
195
|
709 Instead, it runs the command `compose-mail', which invokes the mail
|
|
710 composition mechanism you have selected with the variable
|
|
711 `mail-user-agent'. The default choice of user agent is
|
|
712 `sendmail-user-agent', which gives behavior compatible with the old
|
|
713 behavior.
|
|
714
|
|
715 C-x 4 m now runs compose-mail-other-window, and C-x 5 m runs
|
|
716 compose-mail-other-frame.
|
|
717
|
|
718 ** When you kill a buffer that visits a file, if there are any
|
|
719 registers that save positions in the file, these register values no
|
|
720 longer become completely useless. If you try to go to such a register
|
|
721 with `C-x j', then you are asked whether to visit the file again. If
|
|
722 you say yes, it visits the file and then goes to the same position.
|
|
723
|
|
724 ** When you visit a file that changes frequently outside Emacs--for
|
|
725 example, a log of output from a process that continues to run--it may
|
|
726 be useful for Emacs to revert the file without querying you whenever
|
|
727 you visit the file afresh with `C-x C-f'.
|
|
728
|
|
729 You can request this behavior for certain files by setting the
|
|
730 variable revert-without-query to a list of regular expressions. If a
|
|
731 file's name matches any of these regular expressions, find-file and
|
|
732 revert-buffer revert the buffer without asking for permission--but
|
|
733 only if you have not edited the buffer text yourself.
|
163
|
734
|
157
|
735 ** Gnuserv changes
|
|
736
|
|
737 *** The Lisp part of gnuserv has been rewritten to allow for more
|
|
738 flexibility and features.
|
|
739
|
|
740 *** Many new options and variables are now customizable. Try
|
207
|
741 `M-x customize RET gnuserv RET'.
|
|
742
|
|
743 *** The functionality of `gnuattach' and `gnudoit' programs is
|
|
744 provided by `gnuclient', which now accepts the standard `-nw',
|
163
|
745 `-display', `-eval' and `-f' options.
|
157
|
746
|
155
|
747 ** Etags changes.
|
|
748
|
|
749 *** In C, C++, Objective C and Java, Etags tags global variables by
|
|
750 default. The resulting tags files are inflated by 30% on average.
|
|
751 Use --no-globals to turn this feature off. Etags can also tag
|
193
|
752 variables that are members of structure-like constructs, but it does
|
155
|
753 not by default. Use --members to turn this feature on.
|
|
754
|
|
755 *** C++ member functions are now recognized as tags.
|
|
756
|
|
757 *** Java is tagged like C++. In addition, "extends" and "implements"
|
|
758 constructs are tagged. Files are recognised by the extension .java.
|
|
759
|
|
760 *** Etags can now handle programs written in Postscript. Files are
|
|
761 recognised by the extensions .ps and .pdb (Postscript with C syntax).
|
|
762 In Postscript, tags are lines that start with a slash.
|
|
763
|
|
764 *** Etags now handles Objective C and Objective C++ code. The usual C and
|
|
765 C++ tags are recognized in these languages; in addition, etags
|
|
766 recognizes special Objective C syntax for classes, class categories,
|
|
767 methods and protocols.
|
|
768
|
|
769 *** Etags also handles Cobol. Files are recognised by the extension
|
|
770 .cobol. The tagged lines are those containing a word that begins in
|
|
771 column 8 and ends in a full stop, i.e. anything that could be a
|
|
772 paragraph name.
|
|
773
|
|
774 *** Regexps in Etags now support intervals, as in ed or grep. The syntax of
|
|
775 an interval is \{M,N\}, and it means to match the preceding expression
|
|
776 at least M times and as many as N times.
|
|
777
|
189
|
778 ** Ada mode changes.
|
|
779
|
|
780 *** There is now better support for using find-file.el with Ada mode.
|
|
781 If you switch between spec and body, the cursor stays in the same
|
|
782 procedure (modulo overloading). If a spec has no body file yet, but
|
|
783 you try to switch to its body file, Ada mode now generates procedure
|
|
784 stubs.
|
|
785
|
|
786 *** There are two new commands:
|
|
787 - `ada-make-local' : invokes gnatmake on the current buffer
|
|
788 - `ada-check-syntax' : check syntax of current buffer.
|
|
789
|
|
790 The user options `ada-compiler-make', `ada-make-options',
|
|
791 `ada-language-version', `ada-compiler-syntax-check', and
|
|
792 `ada-compile-options' are used within these commands.
|
|
793
|
|
794 *** Ada mode can now work with Outline minor mode. The outline level
|
193
|
795 is calculated from the indenting, not from syntactic constructs.
|
189
|
796 Outlining does not work if your code is not correctly indented.
|
|
797
|
|
798 *** The new function `ada-gnat-style' converts the buffer to the style of
|
|
799 formatting used in GNAT. It places two blanks after a comment start,
|
|
800 places one blank between a word end and an opening '(', and puts one
|
|
801 space between a comma and the beginning of a word.
|
|
802
|
207
|
803 ** New demand based locking implementation
|
|
804
|
|
805 A faster, but experimental replacement for lazy-lock (called lazy-shot) is
|
|
806 provided. Like lazy-lock it provides demand based and idle time
|
|
807 font-lock-ing. However the lazy-lock versions that came with previous
|
|
808 versions slowed down XEmacs (possibly quite a lot). Lazy-shot solves
|
|
809 this problem by relying on new support from the C code part of XEmacs.
|
|
810 The support however is experimental and will cause some flashing as
|
|
811 parts of the buffer are colored. This likely to change in the future
|
|
812 as the C support is completed.
|
|
813
|
|
814 The current lazy-shot implementation is mostly interface compatible
|
|
815 with lazy-lock v2.06 (the version shipped with XEmacs is v1.x).
|
|
816
|
|
817 *** To enable:
|
|
818 1. Despite the flashing, lazy-shot was deemed such an improvement by
|
|
819 the majority of beta testers that it is now the standard method
|
|
820 provided by the options menu. Alternatively add
|
|
821
|
|
822 (add-hook 'font-lock-mode-hook 'turn-on-lazy-shot)
|
|
823
|
|
824 to '.emacs'.
|
|
825 2. If you were using lazy-lock before, just replace all occurrences of
|
|
826 "lazy-lock" by "lazy-shot" in your '.emacs' file.
|
|
827
|
|
828 *** To disable:
|
|
829
|
|
830 If prefer to use lazy-lock in stead of lazy-shot, put
|
|
831
|
|
832 (remove-hook 'font-lock-mode-hook 'turn-on-lazy-shot)
|
|
833 (add-hook 'font-lock-mode-hook 'turn-on-lazy-lock)
|
|
834
|
|
835 at the END of `.emacs'.
|
|
836
|
|
837 ** RefTeX mode
|
|
838
|
|
839 RefTeX mode is a new minor mode with special support for \label{}, \ref{}
|
|
840 and \cite{} macros in LaTeX documents. RefTeX distinguishes labels of
|
|
841 different environments (equation, figure, ...) and has full support for
|
|
842 multifile documents. To use it, select a buffer with a LaTeX document and
|
|
843 turn the mode on with M-x reftex-mode. Here are the main user commands:
|
|
844
|
|
845 C-c ( reftex-label
|
|
846 Creates a label semi-automatically. RefTeX is context sensitive and
|
|
847 knows which kind of label is needed.
|
|
848
|
|
849 C-c ) reftex-reference
|
|
850 Offers in a menu all labels in the document, along with context of the
|
|
851 label definition. The selected label is referenced as \ref{LABEL}.
|
|
852
|
|
853 C-c [ reftex-citation
|
|
854 Prompts for a regular expression and displays a list of matching BibTeX
|
|
855 database entries. The selected entry is cited with a \cite{KEY} macro.
|
|
856
|
|
857 C-c & reftex-view-crossref
|
|
858 Views the cross reference of a \ref{} or \cite{} command near point.
|
|
859
|
|
860 C-c = reftex-toc
|
|
861 Shows a table of contents of the (multifile) document. From there you
|
|
862 can quickly jump to every section.
|
|
863
|
|
864 Under X, RefTeX installs a "Ref" menu in the menu bar, with additional
|
|
865 commands. Full documentation and customization examples are in the file
|
|
866 reftex.el. You can use the finder to view this information:
|
|
867 C-h p --> tex --> reftex.el
|
155
|
868
|
153
|
869
|
|
870 * Lisp and internal changes in XEmacs 20.3
|
|
871 ==========================================
|
|
872
|
157
|
873 ** Autoconf 2 is supported, making XEmacs more conforming to
|
|
874 conventions used by other free software.
|
|
875
|
159
|
876 ** `tty-erase-char' is a new variable that reports which character
|
193
|
877 was set up as the terminal's erase character at the time Emacs was
|
159
|
878 started.
|
|
879
|
207
|
880 ** It is now possible to attach the menubar accelerator keys to menu
|
|
881 entries. Look at the Lispref under Menus->Menu Accelerators for
|
|
882 details.
|
|
883
|
173
|
884 ** `insert-file-contents' can now read from a special file,
|
|
885 as long as the arguments VISIT and REPLACE are nil.
|
|
886
|
193
|
887 ** `string-to-number' now accepts an optional BASE argument that
|
169
|
888 specifies which base to use. The default base is 10.
|
|
889
|
159
|
890 ** The TIME argument to `format-time-string' is now optional and
|
|
891 defaults to the current time.
|
|
892
|
|
893 ** The PATTERN argument to `split-string' is now optional and defaults
|
|
894 to whitespace ("[ \f\t\n\r\v]+").
|
157
|
895
|
195
|
896 ** `set-extent-properties' is a new function that can be used to
|
|
897 change properties of an extent at once, and is analogous to
|
|
898 `set-frame-properties'.
|
|
899
|
207
|
900 ** If a format field width is specified as `*', the field width is
|
|
901 now assumed to have been specified as an argument (as in C.)
|
|
902
|
|
903 (format "%*s" 10 "abc")
|
|
904 => " abc"
|
|
905
|
161
|
906 ** The new macro `with-current-buffer' lets you evaluate an expression
|
|
907 conveniently with a different current buffer. It looks like this:
|
|
908
|
|
909 (with-current-buffer BUFFER BODY-FORMS...)
|
|
910
|
|
911 BUFFER is the expression that says which buffer to use.
|
|
912 BODY-FORMS say what to do in that buffer.
|
197
|
913 The old `eval-in-buffer' macro is obsoleted by `with-current-buffer'.
|
161
|
914
|
|
915 ** The new primitive `save-current-buffer' saves and restores the
|
|
916 choice of current buffer, like `save-excursion', but without saving or
|
|
917 restoring the value of point or the mark. `with-current-buffer'
|
|
918 works using `save-current-buffer'.
|
|
919
|
|
920 ** The new macro `with-temp-file' lets you do some work in a new buffer and
|
|
921 write the output to a specified file. Like `progn', it returns the value
|
|
922 of the last form.
|
|
923
|
165
|
924 ** The variable `debug-ignored-errors' now works in XEmacs. It allows
|
|
925 one to ignore the debugger for some common errors, even when
|
|
926 `debug-on-error' is t. It has no effect when `debug-on-signal' is
|
|
927 non-nil.
|
|
928
|
197
|
929 ** The new function `current-message' returns the message currently
|
|
930 displayed in the echo area, or nil if there is none.
|
189
|
931
|
|
932 ** File-access primitive functions no longer discard an extra redundant
|
|
933 directory name from the beginning of the file name. In other words,
|
|
934 they no longer do anything special with // or /~. The same goes for
|
|
935 `expand-file-name'. That conversion is now done only in
|
|
936 `substitute-in-file-name'.
|
|
937
|
|
938 This makes it possible for a Lisp program to open a file whose name
|
|
939 begins with ~.
|
|
940
|
207
|
941 ** The regexp matcher has been extended to recognize the following
|
|
942 constructs, borrowed from Perl:
|
|
943
|
|
944 *** Additional quantifiers.
|
|
945
|
|
946 In addition to `*', `+' and `?', XEmacs now recognizes the following
|
|
947 quantifiers:
|
|
948
|
|
949 \{n\} Match exactly n times
|
|
950 \{n,\} Match at least n times
|
|
951 \{n,m\} Match at least n but not more than m times
|
|
952
|
|
953 *** Non-greedy quantifiers.
|
|
954
|
|
955 Any of the standard quantifiers (`*', `+' and others) can now be
|
|
956 followed by an optional `?', which will make them become "non-greedy",
|
|
957 i.e. they will match as little text as possible. Note that the
|
|
958 meanings don't change, just the "gravity."
|
|
959
|
|
960 *** Shy groups.
|
|
961
|
|
962 The \(?: ... \) groups things like \( ... \), but doesn't record the
|
|
963 context for backreferences or future use. This is useful when you
|
|
964 need a lot of groups for the sake of priorities, but actually want to
|
|
965 record only one or two.
|
|
966
|
197
|
967 ** The new function `regexp-opt' returns an efficient regexp to match
|
|
968 a string. The arguments are STRINGS and (optionally) PAREN. This
|
189
|
969 function can be used where regexp matching or searching is intensively
|
|
970 used and speed is important, e.g., in Font Lock mode.
|
|
971
|
207
|
972 ** The featurep syntax has been extended to resemble the Common Lisp
|
|
973 one, as suggested by Erik Naggum.
|
|
974
|
|
975 *** The `xemacs' feature is defined in XEmacs by default.
|
|
976
|
|
977 *** The expression `#+fexp form' is equivalent to
|
|
978 (when (featurep fexp) form), only it is evaluated at read-time. Also,
|
|
979 `#-fexp form' is equivalent to (unless (featurep fexp) form).
|
|
980
|
|
981 *** In addition to symbols, a FEXP can also be a number, or a logical
|
|
982 operator. Here are some examples:
|
|
983 ;; evaluates to non-nil on XEmacs:
|
|
984 (featurep 'xemacs)
|
|
985 ;; evaluates to non-nil on XEmacs 20.3 or later:
|
|
986 (featurep '(and xemacs 20.03))
|
|
987 ;; evaluates to non-nil either on Emacs, or on XEmacs built without
|
|
988 ;; X support:
|
|
989 (featurep '(or emacs (and xemacs (not x))))
|
|
990
|
157
|
991
|
153
|
992
|
136
|
993 * Changes in XEmacs 20.2
|
126
|
994 ========================
|
|
995
|
140
|
996 ** Why XEmacs 20.1 is called 20.2
|
|
997
|
138
|
998 Testing of XEmacs 20.1 revealed a number of showstopping bugs at the
|
|
999 very final moment. Instead of confusing the version numbers further,
|
|
1000 the `20.1' designation was abandoned, and the release was renamed to
|
|
1001 `20.2'.
|
|
1002
|
140
|
1003 ** Delete/backspace keysyms have been separated
|
|
1004
|
|
1005 The Delete and Backspace keysyms are now no longer identical. A better
|
|
1006 version of delbackspace.el has been added called delbs.el.
|
138
|
1007
|
153
|
1008 ** XEmacs 20.0 MULE API supported for backwards compatibility
|
138
|
1009
|
|
1010 XEmacs 20.2 primarily supports the MULE 3 API. It now also supports
|
|
1011 the XEmacs 20.0 MULE API.
|
|
1012
|
126
|
1013 ** The logo has been changed, and the default background color is
|
|
1014 now a shade of gray instead of the eye-burning white.
|
|
1015
|
|
1016 The sample .Xdefaults and .emacs files contain examples of how to
|
|
1017 revert to the old background color.
|
|
1018
|
|
1019 ** Default modeline colors are now less of a color-salad.
|
|
1020
|
146
|
1021 ** The `C-z' key now iconifies only the current X frame. You can use
|
|
1022 `C-x C-z' to get the old behavior.
|
|
1023
|
|
1024 On the tty frames `C-z' behaves as before.
|
|
1025
|
126
|
1026 ** The command `display-time' now draws a pretty image in the modeline
|
|
1027 when new mail arrives. It also supports balloon-help messages.
|
|
1028
|
|
1029 ** Various commands that were previously disabled are now enabled, like
|
|
1030 eval-expression (`M-:') and upcase-region (`C-x C-u')/downcase-region
|
|
1031 (`C-x C-l').
|
|
1032
|
|
1033 ** It is now possible to customize the functions called by XEmacs toolbar.
|
|
1034
|
|
1035 Type `M-x customize RET toolbar RET' to customize it. Customizations
|
|
1036 include the choice of functions for the buttons to invoke, as well as
|
|
1037 a wide choice of mailers and newsreaders to invoked by the respective
|
|
1038 functions.
|
|
1039
|
|
1040 ** `temp-buffer-shrink-to-fit' now defaults to nil.
|
|
1041
|
|
1042 There are unresolved issues regarding this feature, which is why the
|
|
1043 XEmacs developers decided to disable it by default.
|
|
1044
|
|
1045 ** `ps-print-color-p' now defaults to nil.
|
|
1046
|
|
1047 This is because the new default background color is non-white. The
|
|
1048 `Printing Options' in the `Options' menu now include an item that
|
|
1049 enables color printing, and sets the white background.
|
|
1050
|
|
1051 ** `line-number-mode' should be used to get line numbers in the
|
|
1052 modeline, and `column-number-mode' to get column numbers. Line
|
|
1053 numbers now number from 1 by default.
|
|
1054
|
|
1055 ** font-lock-mode will now correctly fontify `int a, b, c;'
|
|
1056 expressions in C mode.
|
|
1057
|
|
1058 ** The blinking cursor is always "on" during movement.
|
|
1059
|
146
|
1060 ** The XEmacs build process has been changed to make site
|
|
1061 administration easier. See lisp/site-load.el for details.
|
|
1062
|
|
1063 ** Numerous causes of crashes have been fixed. XEmacs should now be
|
|
1064 even more stable than before.
|
|
1065
|
|
1066 ** configure no longer defaults to using --with-xim=motif if Motif libraries
|
|
1067 are linked.
|
|
1068
|
|
1069 There are many bugs in the Xlib XIM support in X11R6.3.
|
|
1070
|
126
|
1071 ** A number of new packages are added, and many packages were
|
|
1072 updated.
|
|
1073
|
144
|
1074 ** Gnus-5.4.52, courtesy of Lars Magne Ingebrigtsen
|
126
|
1075
|
|
1076 *** nntp.el has been totally rewritten in an asynchronous fashion.
|
|
1077
|
|
1078 *** Article prefetching functionality has been moved up into
|
124
|
1079 Gnus.
|
|
1080
|
126
|
1081 *** Scoring can now be performed with logical operators like
|
124
|
1082 `and', `or', `not', and parent redirection.
|
|
1083
|
|
1084 *** Article washing status can be displayed in the
|
|
1085 article mode line.
|
|
1086
|
126
|
1087 *** gnus.el has been split into many smaller files.
|
|
1088
|
|
1089 *** Suppression of duplicate articles based on Message-ID.
|
124
|
1090
|
|
1091 (setq gnus-suppress-duplicates t)
|
|
1092
|
126
|
1093 *** New variables for specifying what score and adapt files
|
124
|
1094 are to be considered home score and adapt files. See
|
|
1095 `gnus-home-score-file' and `gnus-home-adapt-files'.
|
|
1096
|
126
|
1097 *** Groups can inherit group parameters from parent topics.
|
|
1098
|
|
1099 *** Article editing has been revamped and is now usable.
|
|
1100
|
|
1101 *** Signatures can be recognized in more intelligent fashions.
|
124
|
1102 See `gnus-signature-separator' and `gnus-signature-limit'.
|
|
1103
|
126
|
1104 *** Summary pick mode has been made to look more nn-like.
|
124
|
1105 Line numbers are displayed and the `.' command can be
|
|
1106 used to pick articles.
|
|
1107
|
126
|
1108 *** Commands for moving the .newsrc.eld from one server to
|
124
|
1109 another have been added.
|
|
1110
|
|
1111 `M-x gnus-change-server'
|
|
1112
|
126
|
1113 *** A way to specify that "uninteresting" fields be suppressed when
|
124
|
1114 generating lines in buffers.
|
|
1115
|
126
|
1116 *** Several commands in the group buffer can be undone with
|
124
|
1117 `M-C-_'.
|
|
1118
|
126
|
1119 *** Scoring can be done on words using the new score type `w'.
|
|
1120
|
|
1121 *** Adaptive scoring can be done on a Subject word-by-word basis:
|
124
|
1122
|
|
1123 (setq gnus-use-adaptive-scoring '(word))
|
|
1124
|
126
|
1125 *** Scores can be decayed.
|
124
|
1126
|
|
1127 (setq gnus-decay-scores t)
|
|
1128
|
126
|
1129 *** Scoring can be performed using a regexp on the Date header. The
|
124
|
1130 Date is normalized to compact ISO 8601 format first.
|
|
1131
|
126
|
1132 *** A new command has been added to remove all data on articles from
|
124
|
1133 the native server.
|
|
1134
|
|
1135 `M-x gnus-group-clear-data-on-native-groups'
|
|
1136
|
126
|
1137 *** A new command for reading collections of documents
|
124
|
1138 (nndoc with nnvirtual on top) has been added -- `M-C-d'.
|
|
1139
|
126
|
1140 *** Process mark sets can be pushed and popped.
|
|
1141
|
|
1142 *** A new mail-to-news backend makes it possible to post
|
124
|
1143 even when the NNTP server doesn't allow posting.
|
|
1144
|
126
|
1145 *** A new backend for reading searches from Web search engines
|
124
|
1146 (DejaNews, Alta Vista, InReference) has been added.
|
|
1147
|
|
1148 Use the `G w' command in the group buffer to create such
|
|
1149 a group.
|
|
1150
|
126
|
1151 *** Groups inside topics can now be sorted using the standard
|
124
|
1152 sorting functions, and each topic can be sorted independently.
|
|
1153
|
|
1154 See the commands under the `T S' submap.
|
|
1155
|
126
|
1156 *** Subsets of the groups can be sorted independently.
|
124
|
1157
|
|
1158 See the commands under the `G P' submap.
|
|
1159
|
126
|
1160 *** Cached articles can be pulled into the groups.
|
124
|
1161
|
|
1162 Use the `Y c' command.
|
|
1163
|
126
|
1164 *** Score files are now applied in a more reliable order.
|
|
1165
|
|
1166 *** Reports on where mail messages end up can be generated.
|
124
|
1167
|
|
1168 `M-x nnmail-split-history'
|
|
1169
|
126
|
1170 *** More hooks and functions have been added to remove junk
|
124
|
1171 from incoming mail before saving the mail.
|
|
1172
|
|
1173 See `nnmail-prepare-incoming-header-hook'.
|
|
1174
|
126
|
1175 *** The nnml mail backend now understands compressed article files.
|
|
1176
|
136
|
1177 ** Custom 1.86, courtesy of Per Abrahamsen
|
124
|
1178
|
|
1179 The Customize library enables Emacs Lisp programmers to specify types
|
126
|
1180 of their variables, so that the users can customize them.
|
|
1181
|
|
1182 Invoke the customizations buffer using the menus (Customize is at the
|
|
1183 top of the Options menu), or using commands `M-x customize',
|
|
1184 `M-x customize-variable' and `M-x customize-face'. Customize can save
|
|
1185 the changed settings to your `.emacs' file.
|
|
1186
|
|
1187 Customize is now the preferred way to change XEmacs settings. Tens of
|
|
1188 packages have been converted to take advantage of the Customize
|
|
1189 features, including Gnus, Message, Supercite, Psgml, Comint, W3,
|
|
1190 cc-mode (and many other programming language modes), ispell.el,
|
|
1191 ps-print.el, id-select.el, most of the programming language modes, and
|
|
1192 many many more.
|
|
1193
|
|
1194 See the "Lisp Changes" section later for a short description of why
|
|
1195 and how to add custom support to your Lisp packages. Custom is also
|
|
1196 documented in the XEmacs info manuals.
|
|
1197
|
144
|
1198 ** W3-3.0.86, courtesy of William Perry
|
126
|
1199
|
|
1200 Version 3 of Emacs/W3, the Emacs World Wide Web browser, has been
|
|
1201 included. It is significantly faster than any of the previous
|
|
1202 versions, and contains numerous new features.
|
|
1203
|
|
1204 ** AUCTeX-9.7k, courtesy of Per Abrahamsen
|
|
1205
|
|
1206 AUC TeX is a comprehensive customizable integrated environment for
|
146
|
1207 writing input files for LaTeX using Emacs.
|
126
|
1208
|
|
1209 AUC TeX lets you run TeX/LaTeX and other LaTeX-related tools, such as
|
|
1210 a output filters or post processor from inside Emacs. Especially
|
|
1211 `running LaTeX' is interesting, as AUC TeX lets you browse through the
|
|
1212 errors TeX reported, while it moves the cursor directly to the
|
|
1213 reported error, and displays some documentation for that particular
|
|
1214 error. This will even work when the document is spread over several
|
|
1215 files.
|
|
1216
|
|
1217 AUC TeX automatically indents your `LaTeX-source', not only as you
|
|
1218 write it -- you can also let it indent and format an entire document.
|
|
1219 It has a special outline feature, which can greatly help you `getting
|
|
1220 an overview' of a document.
|
|
1221
|
|
1222 Apart from these special features, AUC TeX provides an large range of
|
|
1223 handy Emacs macros, which in several different ways can help you write
|
|
1224 your LaTeX documents fast and painless.
|
|
1225
|
|
1226 ** redo.el-1.01, courtesy of Kyle Jones
|
|
1227
|
|
1228 redo.el is a package that implements true redo mechanism in XEmacs
|
|
1229 buffers. Once you load it from your `.emacs', you can bind the `redo'
|
|
1230 command to a convenient key to use it.
|
|
1231
|
|
1232 Emacs' normal undo system allows you to undo an arbitrary number of
|
|
1233 buffer changes. These undos are recorded as ordinary buffer changes
|
|
1234 themselves. So when you break the chain of undos by issuing some
|
|
1235 other command, you can then undo all the undos. The chain of recorded
|
|
1236 buffer modifications therefore grows without bound, truncated only at
|
|
1237 garbage collection time.
|
|
1238
|
|
1239 The redo/undo system is different in two ways:
|
|
1240
|
|
1241 *** The undo/redo command chain is only broken by a buffer modification.
|
|
1242
|
|
1243 You can move around the buffer or switch buffers and still come back
|
|
1244 and do more undos or redos.
|
|
1245
|
|
1246 *** The `redo' command rescinds the most recent undo without
|
|
1247 recording the change as a _new_ buffer change.
|
|
1248
|
|
1249 It completely reverses the effect of the undo, which includes making
|
|
1250 the chain of buffer modification records shorter by one, to counteract
|
|
1251 the effect of the undo command making the record list longer by one.
|
|
1252
|
136
|
1253 ** edmacro.el-3.10, courtesy of Dave Gillespie, ported to XEmacs by
|
126
|
1254 Hrvoje Niksic.
|
|
1255
|
|
1256 Edmacro is a utility that provides easy editing of keyboard macros.
|
|
1257 Originally written by Dave Gillespie, it has been mostly rewritten by
|
|
1258 Hrvoje Niksic, in order to make it distinguish characters and integer,
|
|
1259 as well as to adapt it to XEmacs keysyms.
|
|
1260
|
|
1261 Press `C-x C-k' to invoke the `edit-kbd-macro' command that lets you
|
|
1262 edit old as well as define new keyboard macros. You can also edit the
|
|
1263 last 100 keystrokes and insert them into a macro to be bound to a key
|
|
1264 or named as a command. The recorded/edited macros can be dumped to
|
|
1265 `.emacs' file.
|
|
1266
|
140
|
1267 ** xmine.el-1.8, courtesy of Jens Lautenbacher
|
126
|
1268
|
|
1269 XEmacs now includes a minesweeper game with a full-featured graphics
|
|
1270 and mouse interface. Invoke with `M-x xmine'.
|
|
1271
|
140
|
1272 ** efs-1.15-x5 courtesy of Andy Norman and Michael Sperber
|
126
|
1273
|
|
1274 EFS is now integrated with XEmacs, and replaces the old ange-ftp. It
|
|
1275 has many more features, including info documentation, support for many
|
|
1276 different FTP servers, and integration with dired.
|
|
1277
|
|
1278 ** mic-paren.el-1.3.1, courtesy of Mikael Sjödin
|
|
1279 ** hyperbole-4.022, courtesy of Bob Weiner
|
|
1280 ** hm--html-menus-5.3, courtesy of Heiko Muenkel
|
|
1281 ** python-mode.el-2.90, courtesy of Barry Warsaw
|
140
|
1282 ** balloon-help-1.06, courtesy of Kyle Jones
|
126
|
1283 ** xrdb-mode.el-1.21, courtesy of Barry Warsaw
|
|
1284 ** igrep.el-2.56, courtesy of Kevin Rodgers
|
|
1285 ** frame-icon.el, courtesy of Michael Lamoureux and Bob Weiner
|
|
1286 ** itimer.el-1.05, courtesy of Kyle Jones
|
140
|
1287 ** VM-6.30, courtesy of Kyle Jones
|
126
|
1288 ** OO-Browser-2.10, courtesy of Bob Weiner
|
|
1289 ** viper-2.93, courtesy of Michael Kifer
|
144
|
1290 ** ediff-2.65, courtesy of Michael Kifer
|
126
|
1291 ** detached-minibuf-1.1, courtesy of Alvin Shelton
|
|
1292 ** whitespace-mode.el, courtesy of Heiko Muenkel
|
|
1293 ** winmgr-mode.el, courtesy of David Konerding, Stefan Strobel & Barry Warsaw
|
|
1294 ** fast-lock.el-3.11.01, courtesy of Simon Marshall
|
|
1295 ** lazy-lock.el-1.16, courtesy of Simon Marshall
|
|
1296 ** browse-cltl2.el-1.1, courtesy of Holger Schauer
|
|
1297 ** eldoc.el-1.10, courtesy of Noah Friedman
|
|
1298 ** tm-7.105, courtesy of MORIOKA Tomohiko
|
140
|
1299 ** verilog-mode.el-2.25, courtesy of Michael McNamara & Adrian Aichner
|
126
|
1300 ** overlay.el, courtesy of Joseph Nuspl
|
140
|
1301 ** live-icon.el-1.3, fixes courtesy of Karl Hegbloom
|
|
1302 ** tpu-edt.el, fixes courtesy of R. Kevin Oberman
|
144
|
1303 ** etags.c-11.86 Courtesy of F. Potortì
|
140
|
1304
|
126
|
1305
|
136
|
1306 * Lisp and internal changes in XEmacs 20.2
|
126
|
1307 ==========================================
|
|
1308
|
|
1309 ** `defcustom' and `defgroup' can now be used to specify types and
|
|
1310 placement of the user-settable variables.
|
|
1311
|
|
1312 You can now specify the types of user-settable variables in your Lisp
|
|
1313 packages to be customized by users. To do so, use `defcustom' as a
|
|
1314 replacement for `defvar'.
|
|
1315
|
|
1316 For example, the old declaration:
|
124
|
1317
|
|
1318 (defvar foo-blurgoze nil
|
|
1319 "*non-nil means that foo will act very blurgozely.")
|
|
1320
|
126
|
1321 can be rewritten as:
|
124
|
1322
|
|
1323 (defcustom foo-blurgoze nil
|
|
1324 "*non-nil means that foo will act very blurgozely."
|
126
|
1325 :type 'boolean
|
|
1326 :group 'foo)
|
|
1327
|
|
1328 From a package writer's point of view, nothing has been changed
|
|
1329 However, the user can now type `M-x customize RET foo-blurgoze RET' to
|
|
1330 customize the variable.
|
|
1331
|
|
1332 Other, more complex data structures can be described with `defcustom'
|
|
1333 too, for instance:
|
124
|
1334
|
|
1335 (defcustom foo-hairy-alist '((somekey . "somestring")
|
|
1336 (otherkey . (foo-doit))
|
|
1337 (thirdkey . [1 2 3]))
|
126
|
1338 "*Alist describing the hairy options of the foo package.
|
124
|
1339 The CAR of each element is a symbol, whereas the CDR can be either a
|
126
|
1340 string, a form to evaluate, or a vector of integers.
|
|
1341 New Emacs users simply adore alists like this one."
|
124
|
1342 :type '(repeat (cons (symbol :tag "Key")
|
|
1343 (choice string
|
|
1344 (vector (repeat :inline t integer))
|
126
|
1345 sexp)))
|
|
1346 :group 'foo)
|
|
1347
|
|
1348 The user will be able to add and remove the entries to the list in a
|
|
1349 visually appealing way, as well as save the settings to his/her
|
|
1350 `.emacs'.
|
|
1351
|
|
1352 Note that `defcustom' will also be included in GNU Emacs 19.35, and
|
|
1353 that both XEmacs and GNU Emacs will be using it in the future.
|
|
1354 Although the user-interface of customize may change, the Lisp
|
|
1355 interface will remain the same. This is why we recommend that you use
|
|
1356 `defcustom' for user-settable variables in your new Lisp packages.
|
|
1357
|
|
1358 ** The `read-kbd-macro' function is now available.
|
|
1359
|
136
|
1360 The `read-kbd-macro' function (as well as the read-time evaluated
|
|
1361 `kbd' macro) from the edmacro package is now available in XEmacs. For
|
|
1362 example:
|
126
|
1363
|
|
1364 (define-key foo-mode-map (kbd "C-c <up>") 'foo-up)
|
|
1365
|
136
|
1366 is completely equivalent to
|
126
|
1367
|
|
1368 (define-key foo-mode-map [(control ?c) up] 'foo-up)
|
|
1369
|
136
|
1370 The `kbd' macro is preferred over `read-kbd-macro' function , as it
|
|
1371 evaluates before compiling, thus having no loading overhead.
|
|
1372
|
|
1373 Using `kbd' is not necessary for GNU Emacs compatibility (GNU Emacs
|
|
1374 supports the XEmacs-style keysyms), but adds to clarity. For example,
|
|
1375 (kbd "C-?") is usually easier to read than [(control ??)]. The full
|
|
1376 description of the syntax of keybindings accepted by `read-kbd-macro'
|
|
1377 is documented in the docstring of `edmacro-mode'.
|
126
|
1378
|
|
1379 ** Overlay compatibility is implemented.
|
|
1380
|
|
1381 The overlay support in XEmacs is now functional. Written by Joe
|
|
1382 Nuspl, the overlay compatibility library overlay.el is implemented on
|
|
1383 top of the native XEmacs extents, and can be used as a GNU
|
124
|
1384 Emacs-compatible way of changing display properties.
|
|
1385
|
126
|
1386 ** You should use keysyms kp-* (kp-1, kp-2, ..., kp-enter etc.)
|
136
|
1387 rather than the old form kp_*. The new form is also compatible with
|
|
1388 GNU Emacs.
|
126
|
1389
|
|
1390 ** The keysyms mouse-1, mouse-2, mouse-3 and down-mouse-1,
|
|
1391 down-mouse-2, and down-mouse-3 have been added for GNU Emacs
|
|
1392 compatibility.
|
|
1393
|
|
1394 ** A new user variable `signal-error-on-buffer-boundary' has been
|
|
1395 added.
|
|
1396
|
|
1397 Set this to variable to nil to avoid XEmacs usual lossage of zmacs
|
|
1398 region when moving up against a buffer boundary.
|
|
1399
|
146
|
1400 ** lib-complete.el was MULE-ized.
|
|
1401
|
|
1402 The commands `find-library', `find-library-other-window' and
|
|
1403 `find-library-other-frame' now take an optional coding system
|
|
1404 argument.
|
|
1405
|
|
1406 ** Experimental support for Lisp reader macros #-, #+.
|
|
1407
|
|
1408 The Common Lisp reader macros for feature test are now supported. This
|
|
1409 feature is present for evaluation purposes and is subject to change.
|
|
1410
|
|
1411 ** `values' now has a setf method
|
|
1412
|
126
|
1413 ** The `eval-after-load' and `eval-next-after-load' functions are
|
|
1414 now available.
|
|
1415
|
|
1416 ** A bug that prevented `current-display-table' to be correctly set
|
|
1417 with `set-specifier' has been fixed.
|
|
1418
|
|
1419 ** The bug in easymenu which prevented multiple menus from being
|
|
1420 accessible through button3 has been fixed.
|
|
1421
|
|
1422 You can now safely use easymenu to define multiple menu entries in a
|
|
1423 compatible way, with the added menus accessible via button3 as local
|
|
1424 submenus.
|
|
1425
|
|
1426 ** Many bugs in the scrollbar code have been fixed.
|
|
1427
|
|
1428 ** First alpha level support of MS Windows NT is available, courtesy
|
140
|
1429 of David Hobley and Marc Paquette.
|
126
|
1430
|
|
1431 ** Wnn/egg now has initial support Courtesy of Jareth Hein.
|
|
1432
|
|
1433 ** Some old non-working code has been removed until someone chooses
|
|
1434 to work on it.
|
|
1435
|
|
1436 This includes much of the NeXTStep stuff. The VMS support is also
|
|
1437 likely to be removed in the future.
|
|
1438
|
|
1439 ** Many files have been purged out of the etc/ directory.
|
|
1440
|
|
1441 If you still need the purged files, look for them in the GNU Emacs
|
|
1442 distribution.
|
|
1443
|
|
1444
|
|
1445 * Major Differences Between 19.14 and 20.0
|
|
1446 ===========================================
|
88
|
1447
|
|
1448 XEmacs 20.0 is the first public release to have support for MULE
|
|
1449 (Multi-Lingual Emacs). The --with-mule configuration flag must be
|
|
1450 used to enable Mule support.
|
|
1451
|
|
1452 Many bugs have been fixed. An effort has been made to eradicate all
|
|
1453 XEmacs crashes, although we are not quite done yet. The overall
|
|
1454 quality of XEmacs should be higher than any previous release. XEmacs
|
|
1455 now compiles with nary a warning with some compilers.
|
|
1456
|
|
1457 -- Multiple character sets can be displayed in a buffer. The file
|
|
1458 mule-doc/demo in the distribution contains a greeting in many
|
|
1459 different languages.
|
|
1460
|
|
1461 -- Although the Mule work is for all languages, particular effort has
|
|
1462 been invested in Japanese, with particular focus on Japanese users
|
|
1463 of Sun WorkShop. Many menubar labels have been translated into
|
90
|
1464 Japanese. Martin Buchholz, the maintainer of MULE features within
|
153
|
1465 XEmacs normally runs XEmacs in a Japanese language environment.
|
90
|
1466 Some of the other contributors are Japanese, most importantly
|
|
1467 Morioka Tomohiko, author of the TM package, providing MIME support
|
|
1468 for Mail and News.
|
88
|
1469
|
|
1470 -- Input for complex Asian languages is supported via XIM, a mechanism
|
|
1471 introduced in X11R5 to allow applications to get localized input
|
|
1472 without knowledge of the language. The way XIM works is that when
|
|
1473 the locale has a complex character set, such as Japanese, and extra
|
|
1474 minibuffer-like status window appears attached to various
|
|
1475 application windows, and indicates the status of the input method.
|
|
1476 Composed input in XEmacs should work the same as with other
|
|
1477 applications. If Motif and Mule support is configured into XEmacs,
|
|
1478 then XIM support is automatically configured in as well.
|
|
1479
|
|
1480 -- TM (Tools for Mime) now comes with XEmacs. This provides MIME
|
243
|
1481 (Multipurpose Internet Mail Extensions) support for Mail and News.
|
|
1482 The primary author is Morioka Tomohiko.
|
88
|
1483
|
|
1484 -- Japanese input can also be input using the `canna' input method.
|
|
1485 This support was contributed by Morioka Tomohiko. Setting up canna
|
|
1486 usually requires more user effort (and better knowledge of Japanese!)
|
|
1487 than XIM, but provides a better-integrated input method.
|
|
1488
|
|
1489 -- A mini-tutorial on using Mule:
|
|
1490
|
|
1491 -- Every time data passes between XEmacs and the rest of the
|
|
1492 environment, via file or process input or output, XEmacs must
|
|
1493 convert between its internal multi-character representation and
|
|
1494 the external representation (`coding system'). Many
|
|
1495 difficulties with Mule are related to controlling these coding
|
|
1496 system conversions.
|
|
1497
|
|
1498 -- file-coding-system, file-coding-system-for-read,
|
|
1499 overriding-file-coding-system, and file-coding-system-alist
|
|
1500 are used to determine the coding systems used on file input
|
|
1501 and output.
|
|
1502
|
|
1503 -- For each process, (set-process-input-coding-system) and
|
|
1504 (set-process-output-coding-system) determine the coding
|
|
1505 system used for I/O from the process.
|
|
1506
|
|
1507 -- Many other things are encoded using pathname-coding-system:
|
|
1508 -- file and directory names
|
|
1509 -- window manager properties: window title, icon name
|
|
1510 -- process names and process arguments
|
|
1511 -- XIM input.
|
|
1512
|
|
1513 -- In many cases, you will want to have the same values for all
|
|
1514 the above variables in many cases. For example, in a
|
|
1515 Japanese environment, you will want to use the 'euc-japan
|
|
1516 coding system consistently, except when running certain
|
|
1517 processes that do byte-oriented, rather than
|
|
1518 character-oriented I/O, such as gzip, or when processing Mail
|
|
1519 or News, where ISO2022-based coding systems are the norm,
|
|
1520 since they support multiple character sets.
|
|
1521
|
|
1522 -- To add support for a new language or character set, start by
|
|
1523 trying to copy code in japanese-hooks.el.
|
|
1524
|
|
1525 -- The traditional pre-Mule data conversion is equivalent to the
|
|
1526 'binary coding system under Mule. In this case all characters
|
|
1527 are treated as iso8859-1 (i.e. characters for English + Western
|
|
1528 European languages).
|
|
1529
|
|
1530 -- many fileio-related commands such as find-file and write-file
|
|
1531 take an extra argument, coding-system, which specifies the
|
|
1532 encoding to be used with the file on disk. For example, here is
|
|
1533 a command that converts from the Japanese EUC to ISO2022 format:
|
|
1534
|
|
1535 xemacs -batch -eval '(progn (find-file
|
|
1536 "locale-start.el.euc" (quote euc-japan)) (write-file
|
|
1537 "locale-start.el" nil (quote iso-2022-8-unix)))'
|
|
1538
|
|
1539 Interactively, you can be prompted for a coding system by
|
|
1540 providing a prefix argument to the fileio command. In
|
|
1541 particular, C-u C-x C-f is a useful sequence to edit a file
|
|
1542 using a particular coding system.
|
|
1543
|
|
1544 -- In an Asian locale (i.e. if $LANG is set to ja, ko, or zh),
|
|
1545 XEmacs automatically sets up a language environment assuming
|
|
1546 that the operating system encodes information in the national
|
|
1547 version of EUC, which supports English and the national
|
|
1548 language, but typically no other character sets.
|
|
1549
|
|
1550 -- Command line processing should work much better now - no more order
|
|
1551 dependencies.
|
|
1552
|
|
1553 -- Many many package upgraded (thanks go to countless maintainers):
|
|
1554
|
|
1555 -- ediff 2.64 (Michael Kifer)
|
90
|
1556 -- Gnus 5.2.40 (Lars Magne Ingebrigtsen)
|
88
|
1557 -- w3 3.0.51 (Bill Perry)
|
90
|
1558 -- ilisp 5.8 (Chris McConnell, Ivan Vasquez, Marco Antoniotti, Rick
|
|
1559 Campbell)
|
88
|
1560 -- VM 5.97 (Kyle Jones)
|
|
1561 -- etags 11.78 (Francesco Potorti`)
|
|
1562 -- ksh-mode.el 2.9
|
|
1563 -- vhdl-mode.el 2.73 (Rod Whitby)
|
|
1564 -- id-select.el (Bob Weiner)
|
|
1565 -- EDT/TPU emulation modes should work now for the first time.
|
|
1566 -- viper 2.92 (Michael Kifer) is now the `official' vi emulator for XEmacs.
|
|
1567 -- big-menubar should work much better now.
|
|
1568 -- mode-motion+.el 3.16
|
|
1569 -- backup-dir 2.0 (Greg Klanderman)
|
|
1570 -- ps-print.el-3.05 (Jacques Duthen Prestataire)
|
90
|
1571 -- lazy-lock-1.15 (Simon Marshall)
|
|
1572 -- reporter 3.3 (Barry Warsaw)
|
88
|
1573 -- hm--html-menus 5.0 (Heiko Muenkel)
|
|
1574 -- cc-mode 4.322 (Barry Warsaw)
|
|
1575 -- elp 2.37 (Barry Warsaw)
|
|
1576
|
|
1577
|
|
1578 -- Many new packages have been added:
|
|
1579 -- m4-mode 1.8 (Andrew Csillag)
|
|
1580 -- crisp.el - crisp/brief emulation (Gary D. Foster)
|
|
1581 -- Johan Vroman's iso-acc.el has been ported to XEmacs by Alexandre Oliva
|
90
|
1582 -- psgml-1.01 (Lennart Staflin, James Clark)
|
88
|
1583 -- python-mode.el 2.83 (Barry Warsaw)
|
|
1584 -- vrml-mode.el (Ben Wing)
|
90
|
1585 -- enriched.el, face-menu.el (Boris Goldowsky, Michael Sperber)
|
|
1586 -- sh-script.el (Daniel Pfeiffer)
|
|
1587 -- decipher.el (Christopher J. Madsen)
|
88
|
1588
|
|
1589 -- New function x-keysym-on-keyboard-p helps determine keyboard
|
|
1590 characteristics for key rebinding:
|
|
1591
|
|
1592 x-keysym-on-keyboard-p: (KEYSYM &optional DEVICE)
|
|
1593 -- a built-in function.
|
|
1594 Return true if KEYSYM names a key on the keyboard of DEVICE.
|
|
1595 More precisely, return true if pressing a physical key
|
|
1596 on the keyboard of DEVICE without any modifier keys generates KEYSYM.
|
|
1597 Valid keysyms are listed in the files /usr/include/X11/keysymdef.h and in
|
|
1598 /usr/lib/X11/XKeysymDB, or whatever the equivalents are on your system.
|
|
1599
|
|
1600 -- Installed info files are now compressed (support courtesy of Joseph J Nuspl)
|
|
1601
|
|
1602 -- (load-average) works on Solaris, even if you're not root. Thanks to
|
|
1603 Hrvoje Niksic.
|
|
1604
|
|
1605 -- OffiX drag-and-drop support added
|
|
1606
|
|
1607 -- lots of syncing with 19.34 elisp files, most by Steven Baur
|
70
|
1608
|
|
1609
|
0
|
1610 ** Major Differences Between 19.13 and 19.14
|
|
1611 ============================================
|
|
1612
|
|
1613 XEmacs has a new address! The canonical ftp site is now
|
|
1614 ftp.xemacs.org:/pub/xemacs and the Web page is now at
|
|
1615 http://www.xemacs.org/. All mailing lists now have @xemacs.org
|
|
1616 addresses. For the time being the @cs.uiuc.edu addresses will
|
|
1617 continue to function.
|
|
1618
|
|
1619 This is a major new release. Many features have been added, as well
|
|
1620 as many bugs fixed. The Motif menubar has still _NOT_ been fixed for
|
|
1621 19.14. You should use the Lucid menubar instead.
|
|
1622
|
|
1623
|
|
1624
|
|
1625 Major user-visible changes:
|
|
1626 ---------------------------
|
|
1627
|
|
1628 -- Color support in TTY mode is provided. You have to have a TTY capable
|
|
1629 of displaying them, such as color xterm or the console under Linux.
|
|
1630 If your terminal type supports colors (e.g. `xterm-color'), XEmacs
|
|
1631 will automatically notice this and start using color.
|
|
1632
|
|
1633 -- blink-cursor-mode enables a blinking text cursor. There is a
|
|
1634 menubar option for this also.
|
|
1635
|
|
1636 -- auto-show-mode is turned on by default; this means that XEmacs
|
|
1637 will automatically scroll a window horizontally as necessary to
|
|
1638 keep point in view.
|
|
1639
|
|
1640 -- a file dialog box is provided and will be used whenever you
|
|
1641 are prompted for a filename as a result of a menubar selection.
|
|
1642
|
|
1643 -- XEmacs can be compiled with built-in GIF, JPEG, and PNG support.
|
|
1644 The GIF libraries are supplied with XEmacs; for JPEG and PNG,
|
|
1645 you have to obtain the appropriate libraries (this is well-
|
|
1646 documented). This makes image display much easier and faster under
|
|
1647 W3 (the web browser) and TM (adds MIME support to VM and GNUS;
|
|
1648 not yet included with XEmacs but will be in 19.15).
|
|
1649
|
|
1650 -- XEmacs provides a really nice mode (PSGML with "Wing improvements")
|
|
1651 for editing HTML and other SGML documents. It parses the document,
|
|
1652 and as a result it does proper indentation, can show you the context
|
|
1653 you're in, the allowed tags at a particular position, etc.
|
|
1654
|
|
1655 -- XEmacs comes standard with modes for editing Java and VRML code,
|
|
1656 including font-lock support.
|
|
1657
|
|
1658 -- GNUS 5.2 comes standard with XEmacs.
|
|
1659
|
|
1660 -- You can now embed colors in the modeline, with different sections
|
|
1661 of the modeline responding appropriately to various mouse gestures:
|
|
1662 For example, clicking on the "read-only" indicator toggles the
|
|
1663 read-only status of a buffer, and clicking on the buffer name
|
|
1664 cycles to the next buffer. Pressing button3 on these areas brings
|
|
1665 up a popup menu of appropriate commands.
|
|
1666
|
|
1667 -- There is a much nicer mode for completion lists and such.
|
|
1668 At the minibuffer prompt, if you hit page-up or Meta-V, the completion
|
|
1669 buffer will be displayed (if it wasn't already), you're moved into
|
|
1670 it, and can move around and select filenames using the arrow keys
|
|
1671 and the return key. Rather than a cursor, a filename is highlighted,
|
|
1672 and the arrow keys change which filename is highlighted.
|
|
1673
|
|
1674 -- The edit-faces subsystem has also been much improved, in somewhat
|
|
1675 similar ways to the completion list improvements.
|
|
1676
|
|
1677 -- Many improvements were made to the multi-device support.
|
|
1678 We now provide an auxiliary utility called "gnuattach" that
|
|
1679 lets you connect to an existing XEmacs process and display
|
|
1680 a TTY frame on the current TTY connection, and commands
|
|
1681 `make-frame-on-display' (with a corresponding menubar entry)
|
|
1682 and `make-frame-on-tty' for more easily creating frames on
|
|
1683 new TTY or X connections.
|
|
1684
|
|
1685 -- We have incorporated nearly all of the functionality of GNU Emacs
|
|
1686 19.30 into XEmacs. This includes support for lazy-loaded
|
|
1687 byte code and documentation strings, improved paragraph filling,
|
|
1688 better support for margins within documents, v19 regular expression
|
|
1689 routines (including caching of compiled regexps), etc.
|
|
1690
|
|
1691 -- In accordance with GNU Emacs 19.30, the following key binding
|
|
1692 changes have been made:
|
|
1693
|
|
1694 C-x ESC -> C-x ESC ESC
|
|
1695 ESC ESC -> ESC :
|
|
1696 ESC ESC ESC is "abort anything" (keyboard-escape-quit).
|
|
1697
|
|
1698 -- All major packages have been updated to their latest-released
|
|
1699 versions.
|
|
1700
|
|
1701 -- XEmacs now gracefully handles a full colormap (such as typically
|
|
1702 results when running Netscape). The nearest available color
|
|
1703 is automatically substituted.
|
|
1704
|
|
1705 -- Many bug fixes to the subprocess/PTY code, ps-print, menubar
|
|
1706 functions, `set-text-properties', DEC Alpha support, toolbar
|
|
1707 resizing (the "phantom VM toolbar" bug), and lots and lots
|
|
1708 of other things were made.
|
|
1709
|
|
1710 -- The ncurses library (a replacement for curses, found especially
|
|
1711 under Linux) is supported, and will be automatically used
|
|
1712 if it can be found.
|
|
1713
|
|
1714 -- You can now undo in the minibuffer.
|
|
1715
|
|
1716 -- Surrogate minibuffers now work. These are also sometimes referred
|
|
1717 to as "global" minibuffers.
|
|
1718
|
|
1719 -- font-lock has been merged with GNU Emacs 19.30, improved defaults
|
|
1720 have been added, and changes have been made to the way it is
|
|
1721 configured.
|
|
1722
|
|
1723 -- Many, many modes have menubar entries for them.
|
|
1724
|
|
1725 -- `recover-session' lets you recover whatever files can be recovered
|
|
1726 after your XEmacs process has died unexpectedly.
|
|
1727
|
|
1728 -- C-h k followed by a toolbar button press correctly reports
|
|
1729 the binding of the toolbar button.
|
|
1730
|
|
1731 -- `function-key-map', `key-translation-map', and `keyboard-translate-table'
|
|
1732 are now correctly implemented.
|
|
1733
|
|
1734 -- `show-message-log' (and its menubar entry under Edit) have been
|
|
1735 removed; instead use `view-lossage' (and its menubar entry under
|
|
1736 Help).
|
|
1737
|
|
1738 -- There is a standard menubar entry for specifying which browser
|
|
1739 (Netscape, W3, Mosaic, etc.) to use when dispatching URL's
|
|
1740 in mail, Usenet news, etc.
|
|
1741
|
|
1742 -- Improved native sound support under Linux.
|
|
1743
|
|
1744 -- Lots of other things we forgot to mention.
|
|
1745
|
|
1746
|
|
1747
|
|
1748 Significant Lisp-level changes:
|
|
1749 -------------------------------
|
|
1750
|
|
1751 -- Many improvements to the E-Lisp documentation have been made;
|
|
1752 it should now be up-to-date and complete in nearly all cases.
|
|
1753
|
|
1754 -- XEmacs has extensive documentation on its internals, for
|
|
1755 would-be C hackers.
|
|
1756
|
|
1757 -- Common-Lisp support (the CL package) is now dumped standard
|
|
1758 into XEmacs. No more need for (require 'cl) or anything
|
|
1759 like that.
|
|
1760
|
|
1761 -- Full support for extents and text properties over strings is
|
|
1762 provided.
|
|
1763
|
|
1764 -- The extent properties `start-open', `end-open', `start-closed',
|
|
1765 and `end-closed' now work correctly w.r.t. text properties.
|
|
1766
|
|
1767 -- The `face' property of extents and text properties can now
|
|
1768 be a list.
|
|
1769
|
116
|
1770 -- The `mouse-face' property from GNU Emacs is now supported.
|
0
|
1771 It supersedes the `highlight' property.
|
|
1772
|
116
|
1773 -- `enriched' and `facemenu' packages from GNU Emacs have been ported.
|
0
|
1774
|
|
1775 -- New functions for easier creation of dialog boxes:
|
|
1776 `get-dialog-box-response', `message-box', and `message-or-box'.
|
|
1777
|
|
1778 -- `function-min-args' and `function-max-args' allow you to determine
|
|
1779 the minimum and maximum allowed arguments for any type of
|
|
1780 function (i.e. subr, lambda expression, byte-compiled function, etc.).
|
|
1781
|
|
1782 -- Some C-level support for doing E-Lisp profiling is provided.
|
|
1783 See `start-profiling', `stop-profiling', and
|
|
1784 `pretty-print-profiling-info'.
|
|
1785
|
|
1786 -- `current-process-time' reports the user, system, and real times
|
|
1787 for the currently running XEmacs process.
|
|
1788
|
|
1789 -- `next-window', `previous-window', `next-frame', `previous-frame',
|
|
1790 `other-window', `get-lru-window', etc. have an extra device
|
|
1791 argument that allows you to restrict which devices it includes
|
|
1792 (normally all devices). Some functions that incorrectly ignored
|
|
1793 frames on different devices (e.g. C-x 0) are fixed.
|
|
1794
|
|
1795 -- new functions `run-hook-with-args-until-success',
|
|
1796 `run-hook-with-args-until-failure'.
|
|
1797
|
|
1798 -- generalized facility for local vs. global hooks. See `make-local-hook',
|
|
1799 `add-hook'.
|
|
1800
|
|
1801 -- New functions for querying the window tree: `frame-leftmost-window',
|
|
1802 `frame-rightmost-window', `window-first-hchild', `window-first-vchild',
|
|
1803 `window-next-child', `window-previous-child', and `window-parent'.
|
|
1804
|
|
1805 -- Epoch support works. This gets you direct access to some X events
|
|
1806 and objects (e.g. properties and property-notify events).
|
|
1807
|
|
1808 -- The multi-device support has been majorly revamped. There is now
|
|
1809 a new concept of "consoles" (devices grouped together under a
|
|
1810 common keyboard/mouse), console-local variables, and a generalized
|
|
1811 concept of device/console connection.
|
|
1812
|
|
1813 -- `display-buffer' synched with GNU Emacs 19.30, giving you lots of
|
|
1814 wondrous cruft such as
|
|
1815 -- unsplittable frames
|
|
1816 -- pop-up-frames, pop-up-frame-function
|
|
1817 -- special-display-buffer-names, special-display-regexps,
|
|
1818 special-display-function
|
|
1819 -- same-window-buffer-names, same-window-regexps
|
|
1820
|
|
1821 -- XEmacs has support for accessing DBM- and/or DB-format databases,
|
|
1822 provided that you have the appropriate libraries on your system.
|
|
1823
|
|
1824 -- There is a new font style: "strikethru" fonts.
|
|
1825
|
|
1826 -- New data type "weak list", which is a list with special
|
|
1827 garbage-collection properties, similar to weak hash tables.
|
|
1828
|
|
1829 -- `set-face-parent' makes one face inherit all properties from another.
|
|
1830
|
|
1831 -- The junky frame parameters mechanism has been revamped as
|
|
1832 frame properties, which a standard property-list interface.
|
|
1833
|
|
1834 -- Lots and lots of functions for working with property lists have
|
|
1835 been added.
|
|
1836
|
|
1837 -- New functions `push-window-configuration', `pop-window-configuration',
|
|
1838 `unpop-window-configuration' for maintain a stack of window
|
|
1839 configurations.
|
|
1840
|
|
1841 -- Many fixups to the glyph code; icons and mouse pointers are now
|
|
1842 properly merged into the glyph mechanism.
|
|
1843
|
|
1844 -- `set-specifier' works more sensibly, like `set-face-property'.
|
|
1845
|
|
1846 -- Many new specifiers for individually controlling toolbar height/width
|
|
1847 and visibility and text cursor visibility.
|
|
1848
|
|
1849 -- New face `text-cursor' controls the colors of the text cursor.
|
|
1850
|
|
1851 -- Many new variables for turning on debug information about the
|
|
1852 inner workings of XEmacs.
|
|
1853
|
|
1854 -- Hash tables can now compare their keys using `equal' or `eql'
|
|
1855 as well as `eq'.
|
|
1856
|
|
1857 -- Other things too numerous to mention.
|
|
1858
|
|
1859
|
|
1860
|
|
1861 Significant configuration/build changes:
|
|
1862 ----------------------------------------
|
|
1863
|
|
1864 -- You can disable TTY support, toolbar support, scrollbar support,
|
|
1865 menubar support, and/or dialog box support at configure time
|
|
1866 to save memory.
|
|
1867
|
|
1868 -- New configure option `--extra-verbose' shows the diagnostic
|
|
1869 output from feature testing; this should help track down
|
|
1870 problems with incorrect feature detection.
|
|
1871
|
|
1872 -- `dont-have-xmu' is now `with-xmu', with the reversed sense.
|
|
1873 (It defaults to `yes'.)
|
|
1874
|
|
1875 -- `with-mocklisp' lets you add Mocklisp support if you really
|
|
1876 need this.
|
|
1877
|
|
1878 -- `with-term' for adding TERM support for Linux users.
|
|
1879
|
|
1880
|
|
1881
|
|
1882 ** Major Differences Between 19.12 and 19.13
|
|
1883 ============================================
|
|
1884
|
|
1885 This is primarily a bug-fix release. Lots of bugs have been fixed.
|
|
1886 Hopefully only a few have been introduced. The most noteworthy bug
|
|
1887 fixes are:
|
|
1888
|
|
1889 -- There should be no more problems connecting XEmacs to an X
|
|
1890 server over SLIP or other slow connections.
|
|
1891 -- Periodic crashes when using the Buffers menu should be gone.
|
|
1892 -- etags would sometimes erase the current buffer; it doesn't
|
|
1893 any more.
|
|
1894 -- XEmacs will correctly exit if the X server dies.
|
|
1895 -- uniconified frames are displayed properly under TVTWM.
|
|
1896 -- Breakage in `add-menu-item' / `add-menu-button' is fixed.
|
|
1897
|
|
1898 The Motif menubar has _NOT_ been fixed for 19.13. You should use the
|
|
1899 Lucid menubar instead.
|
|
1900
|
|
1901 Multi-device support should now be working properly. You can now open
|
|
1902 an X device after having started out on a TTY device.
|
|
1903
|
|
1904 Background pixmaps now work. See `set-face-background-pixmap'.
|
|
1905
|
|
1906 Echo area messages are now saved to a buffer, " *Message Log*". To
|
|
1907 see this buffer, use the command `show-message-log'. It is possible
|
|
1908 to filter the message which are actually included by modifying the
|
|
1909 variables `log-message-ignore-regexps' and `log-message-ignore-labels'.
|
|
1910
|
|
1911 You can now control which warnings you want to see. See
|
|
1912 `display-warning-suppressed-classes' and friends.
|
|
1913
|
|
1914 You can now set the default location of an "other window" from the
|
|
1915 Options menu.
|
|
1916
|
|
1917 "Save Options" now saves the state of all faces.
|
|
1918
|
|
1919 You can choose which file "Save Options" writes into; see
|
|
1920 `save-options-file'.
|
|
1921
|
|
1922 XPM support is no longer required for the toolbar.
|
|
1923
|
|
1924 The relocating allocator is now enabled by default whenever possible.
|
|
1925 This allows buffer memory to be returned to the system when no longer
|
|
1926 in use which helps keep XEmacs process size down.
|
|
1927
|
|
1928 The ability to have captioned toolbars has been added. Currently only
|
|
1929 the default toolbar actually has a captioned version provided. A new
|
|
1930 specifier variable, `toolbar-buttons-captioned-p' controls whether the
|
|
1931 toolbar is captioned.
|
|
1932
|
|
1933 A copy of the XEmacs FAQ is now included and is available through info.
|
|
1934
|
|
1935 The on-line E-Lisp reference manual has been significantly updated.
|
|
1936
|
|
1937 There is now audio support under Linux.
|
|
1938
|
|
1939 Modifier keys can now be sticky. This is controlled by the variable
|
|
1940 `modifier-keys-are-sticky'.
|
|
1941
|
|
1942 manual-entry should now work correctly under Irix with the penalty of
|
|
1943 a longer startup time the first time it is invoked. If you are having
|
|
1944 problems with this on another system try setting
|
|
1945 `Manual-use-subdirectory-list' to t.
|
|
1946
|
|
1947 make-tty-device no longer automatically creates the first frame.
|
|
1948
|
|
1949 Rectangular regions now work correctly.
|
|
1950
|
|
1951 ediff no longer sets synchronize-minibuffers to t unless you first set
|
|
1952 ediff-synchronize-minibuffers
|
|
1953
|
|
1954 keyboard-translate-table has been implemented. This means that the
|
|
1955 `enable-flow-control' command for dealing with TTY connections that
|
|
1956 filter out ^S and ^Q now works.
|
|
1957
|
|
1958 You can now create frames that are initially unmapped and frames that
|
|
1959 are "transient for another frame", meaning that they behave more like
|
|
1960 dialog-box frames.
|
|
1961
|
|
1962 Other E-Lisp changes:
|
|
1963
|
|
1964 -- Specifier `menubar-visible-p' for controlling menubar visibility
|
|
1965 -- Local command hooks should be set using `local-pre-command-hook'
|
|
1966 and `local-post-command-hook' instead of making the global
|
|
1967 equivalents be buffer-local.
|
|
1968 -- `quit-char', `help-char', `meta-prefix-char' can be any key specifier
|
|
1969 instead of just an integer.
|
|
1970 -- new functions `add-async-timeout' and `disable-async-timeout'.
|
|
1971 These let you create asynchronous timeouts, which are like
|
|
1972 normal timeouts except that they're executed even during
|
|
1973 running Lisp code. Use this with care!
|
|
1974 -- `debug-on-error' and `stack-trace-on-error' now enter the debugger
|
|
1975 only when an *unhandled* error occurs. If you want the old
|
|
1976 behavior, use `debug-on-signal' and `stack-trace-on-signal'.
|
|
1977 -- \U, \L, \u, \l, \E recognized specially in `replace-match'.
|
|
1978 These are standard ex/perl commands for changing the case of
|
|
1979 replaced text.
|
|
1980 -- New function event-matches-key-specifier-p. This provides
|
|
1981 a clean way of comparing keypress events with key specifiers
|
|
1982 such as 65, (shift home), etc. without having to resort
|
|
1983 to ugly `character-to-event' / `event-to-character' hacks.
|
|
1984 -- New function `add-to-list'
|
|
1985 -- New Common-Lisp functions `some', `every', `notevery', `notany',
|
|
1986 `adjoin', `union', `intersection', `set-difference',
|
|
1987 `set-exclusive-or', `subsetp'
|
|
1988 -- `remove-face-property' provides a clean way of removing a
|
|
1989 face property.
|
|
1990
|
|
1991 Many of the Emacs Lisp packages have been updated. Some of the new
|
|
1992 Emacs Lisp packages ---
|
|
1993
|
|
1994 ada-mode: major mode for editing Ada source
|
|
1995
|
|
1996 arc-mode: simple editing of archives
|
|
1997
|
70
|
1998 auto-show-mode: automatically scrolls horizontally to keep point on-screen
|
0
|
1999
|
|
2000 completion: dynamic word completion mode
|
|
2001
|
|
2002 dabbrev: the dynamic abbrev package has been rewritten and is much
|
|
2003 more powerful -- e.g. it searches in other buffers as well
|
|
2004 as the current one
|
|
2005
|
|
2006 easymenu: menu support package
|
|
2007
|
|
2008 live-icon: makes frame icons represent the current frame contents
|
|
2009
|
|
2010 mailcrypt 3.2: mail encryption with PGP; included but v2.4 is still
|
70
|
2011 the default
|
|
2012
|
|
2013 two-column: for editing two-column text
|
0
|
2014
|
|
2015
|
|
2016 ** Major Differences Between 19.11 and 19.12
|
|
2017 ============================================
|
|
2018
|
|
2019 This is a huge new release. Almost every aspect of XEmacs has been changed
|
|
2020 at least somewhat. The highlights are:
|
|
2021
|
|
2022 -- TTY support (includes face support)
|
|
2023 -- new redisplay engine; should be faster, less buggy, and more powerful
|
|
2024 -- terminology change from "screen" to "frame"
|
|
2025 -- built-in toolbar
|
|
2026 -- toolbar support added to many packages
|
|
2027 -- multiple device support (still in beta; improvements to come in
|
|
2028 19.13)
|
|
2029 -- Purify used to ensure that there are no memory leaks or memory corruption
|
|
2030 problems
|
|
2031 -- horizontal and vertical scrollbars in all windows
|
|
2032 -- new Lucid (i.e. look-alike Motif) scrollbar widget
|
|
2033 -- stay-up menus in the Lucid (look-alike Motif) menubar widget
|
|
2034 -- 3-d modeline
|
|
2035 -- new extents engine; should be faster, less buggy, and more powerful
|
|
2036 -- much more powerful control over faces
|
|
2037 -- expanded menubar
|
|
2038 -- more work on synching with GNU Emacs 19.28
|
|
2039 -- new packages: Hyperbole, OOBR (object browser), hm--html-menus, viper,
|
|
2040 lazy-lock.el, ksh-mode.el, rsz-minibuf.el
|
|
2041 -- package updates for all major packages
|
|
2042 -- dynodump package for Solaris: provides proper undumping and portable
|
|
2043 binaries across different OS versions and machine types
|
|
2044 -- Greatly expanded concept of "glyphs" (pixmaps etc. in a buffer)
|
|
2045 -- built-in support for displaying X-Faces, if the X-Face library is
|
|
2046 available
|
|
2047 -- built-in support for SOCKS if the SOCKS library is available
|
|
2048 -- graceful behavior when the colormap is full (e.g. Netscape ate
|
|
2049 all the colors)
|
|
2050 -- built-in MD5 (secure hashing function) support
|
|
2051
|
|
2052
|
|
2053 More specific information:
|
|
2054
|
|
2055 *** TTY Support
|
|
2056 ---------------
|
|
2057
|
|
2058 The long-awaited TTY support is now available. XEmacs will start up
|
|
2059 in TTY mode (using the tty you started XEmacs from) if the DISPLAY
|
|
2060 environment variable is not set or if you use the `-nw' option.
|
|
2061
|
|
2062 Faces are available on TTY's. For a demonstration, try editing a C
|
|
2063 file and turning on font-lock-mode.
|
|
2064
|
|
2065 You can also connect to additional TTY's using `make-tty-device',
|
|
2066 whether your first frame was a TTY or an X window. This ability is
|
|
2067 not yet completely finished.
|
|
2068
|
|
2069 The full event-loop capabilities (processes, timeouts, etc.) are
|
|
2070 available on TTY's.
|
|
2071
|
|
2072
|
|
2073
|
|
2074 *** New Redisplay Engine
|
|
2075 ------------------------
|
|
2076
|
|
2077 The redisplay engine has been rewritten to improve its efficiency and
|
|
2078 to increase its functionality. It should also be significantly more
|
|
2079 bug-free than the previous redisplay engine.
|
|
2080
|
|
2081 A line that is not big enough to display at the bottom of the window
|
|
2082 will normally be clipped (so that it is partially visible) rather than
|
|
2083 not displayed at all. The variable `pixel-vertical-clip-threshold'
|
|
2084 can be used to control the minimum space that must be available for a
|
|
2085 line to be clipped rather than not displayed at all.
|
|
2086
|
|
2087 Tabs are displayed in such a way that things line up fairly well even
|
|
2088 in the presence of variable-width fonts and/or lines with
|
|
2089 multiply-sized fonts.
|
|
2090
|
|
2091 Display tables are implemented, through the specifier variable
|
|
2092 `current-display-table'. They can be buffer-local, window-local,
|
|
2093 frame-local, or device-local. See below for info about specifiers.
|
|
2094
|
|
2095
|
|
2096
|
|
2097 *** Toolbar
|
|
2098 -----------
|
|
2099
|
|
2100 There is now built-in support for a toolbar. A sample toolbar is
|
|
2101 visible by default at the top of the frame. Four separate toolbars
|
|
2102 can be configured (at the top, bottom, left, and right of the frame).
|
|
2103 The toolbar specification is similar to the menubar specification.
|
|
2104 The up, down, and disabled glyphs of a toolbar button can be
|
|
2105 separately controlled. Explanatory text can be echoed in the echo
|
|
2106 area when the mouse passes over a toolbar button. The size, contents,
|
|
2107 and visibility of the various toolbars can be controlled on a
|
|
2108 per-buffer, per-window, per-frame, and per-device basis through the
|
|
2109 use of specifiers. See the chapter on toolbars in the Lisp Reference
|
|
2110 Manual (included with XEmacs) for more information.
|
|
2111
|
|
2112 The toolbar color and shadow thicknesses are currently controlled only
|
|
2113 through `modify-frame-parameters' and through X resources. We are
|
|
2114 planning on making these controllable through specifiers as well. (Our
|
|
2115 hope is to make `modify-frame-parameters' obsolete, as it is a clunky
|
|
2116 and not very powerful mechanism.)
|
|
2117
|
|
2118 Info, GNUS, VM, W3, and various other packages include custom toolbars
|
|
2119 with them.
|
|
2120
|
|
2121
|
|
2122
|
|
2123 *** Menubar
|
|
2124 -----------
|
|
2125
|
|
2126 Stay-up menus are implemented in the look-alike Motif menubar.
|
|
2127
|
|
2128 The default menubar has been expanded to include most commonly-used
|
|
2129 functions in XEmacs.
|
|
2130
|
|
2131 The options menu has been greatly expanded to include many more
|
|
2132 options.
|
|
2133
|
|
2134 The menubar specification format has been greatly expanded. Per-menu
|
|
2135 activation hooks can be specified through the :filter keyword (thus
|
|
2136 obsoleting `activate-menubar-hook'); this allows for fast response
|
|
2137 time when you have a large and complex menu. You can dynamically
|
|
2138 control whether menu items are present through the :included and
|
|
2139 :config keywords. (The latter keyword implements a simple menubar
|
|
2140 configuration scheme, in conjunction with the variable
|
|
2141 `menubar-configuration'.) Many different menu-item separators (single
|
|
2142 or double line; solid or dashed; flat, etched-in, or etched-out) are
|
|
2143 available. See the chapter on menus in the Lisp Reference Manual for
|
|
2144 more information about all of this.
|
|
2145
|
|
2146 New functions `add-submenu' and `add-menu-button' are available.
|
|
2147 These supersede the older `add-menu' and `add-menu-item' functions,
|
|
2148 and provide a more powerful and consistent interface.
|
|
2149
|
|
2150 New convenience functions for popping up the part or all of the
|
|
2151 menubar in a pop-up menu are available: `popup-menubar-menu' and
|
|
2152 `popup-buffer-menu'.
|
|
2153
|
|
2154 Menus are now incrementally constructed greatly improving menubar
|
|
2155 response time.
|
|
2156
|
|
2157
|
|
2158
|
|
2159 *** Scrollbars
|
|
2160 --------------
|
|
2161
|
|
2162 A look-alike Motif scrollbar is now included with XEmacs. No longer
|
|
2163 will you have to suffer with ugly Athena scrollbars.
|
|
2164
|
|
2165 Windows can now have horizontal scrollbars. Normally they are visible
|
|
2166 when the window's buffer is set to truncate lines rather than wrap
|
|
2167 them (e.g. `(setq truncate-lines t)').
|
|
2168
|
|
2169 All windows, not only the right-most ones, can have vertical
|
|
2170 scrollbars.
|
|
2171
|
|
2172 The functions to change a scrollbar's width have been superseded by
|
|
2173 the specifier variables `scrollbar-width' and `scrollbar-height'.
|
|
2174 This allows their values to be controlled on a buffer-local,
|
|
2175 window-local, frame-local, and device-local basis. See below.
|
|
2176
|
|
2177 The scrollbars interact better with the event loop (for example, you
|
|
2178 can type `C-h k', do a scrollbar action, and see a description of this
|
|
2179 scrollbar action printed as if you had pressed a key sequence or
|
|
2180 selected a menu item).
|
|
2181
|
|
2182 The scrollbar behavior can be reprogrammed, by advising the
|
|
2183 `scrollbar-*' functions.
|
|
2184
|
|
2185
|
|
2186
|
|
2187 *** Key Bindings
|
|
2188 ----------------
|
|
2189
|
|
2190 The oft-used function `goto-line' now has its own binding: M-g.
|
|
2191
|
|
2192 New bindings are available for scrolling the "other" window: M-next,
|
|
2193 M-prior, M-home, M-end. (On many keyboards, `next' and `prior'
|
|
2194 labelled `PgUp' and `PgDn'.)
|
|
2195
|
|
2196 You can reactivate a deactivated Zmacs region, without having any
|
|
2197 other effects, with the binding M-C-z.
|
|
2198
|
|
2199 The bindings `M-u', `M-l', and `M-c' now work on the region (if a
|
|
2200 region is active) or work on a word, as before.
|
|
2201
|
|
2202 Shift-Control-G forces a "critical quit", which drops immediately into
|
|
2203 the debugger; see below.
|
|
2204
|
|
2205
|
|
2206
|
|
2207 *** Modeline
|
|
2208 ------------
|
|
2209
|
|
2210 The modeline can now have a 3-d look; this is enabled by default. The
|
|
2211 specifier variable `modeline-shadow-thickness' controls the size.
|
|
2212
|
|
2213 The modeline can now be turned off on a per-buffer, per-window,
|
|
2214 per-frame, or per-device basis. The specifier variable
|
|
2215 `has-modeline-p' controls whether the modeline is visible. See below
|
|
2216 for details about the vastly powerful specifier mechanism.
|
|
2217
|
|
2218 The modeline functions and variables have been renamed to be
|
|
2219 `*-modeline-*' rather than `*-mode-line-*'. Aliases are provided for
|
|
2220 all the old names.
|
|
2221
|
|
2222 Variable width fonts now work correctly when used in the modeline.
|
|
2223
|
|
2224
|
|
2225
|
|
2226 *** Minibuffer, Echo Area
|
|
2227 -------------------------
|
|
2228
|
|
2229 The minibuffer is no longer constrained to be one line high. The
|
|
2230 package rsz-minibuf.el is included to automatically resize the
|
|
2231 minibuffer when its contents are too big; enable this with
|
|
2232 `resize-minibuffer-mode'.
|
|
2233
|
|
2234 The echo area is now a true buffer, called " *Echo Area*". This
|
|
2235 allows you to customize the echo area behavior through
|
|
2236 before-change-functions and after-change-functions.
|
|
2237
|
|
2238
|
|
2239
|
|
2240 *** Specifiers
|
|
2241 --------------
|
|
2242
|
|
2243 XEmacs has a new concept called "specifiers", used to configure most
|
|
2244 display options (toolbar size and contents, scrollbar size, face
|
|
2245 properties, modeline visibility and shadow-thickness, glyphs, display
|
|
2246 tables, etc.). We are planning on converting all display
|
|
2247 characteristics to use specifiers, and obsoleting the clunky functions
|
|
2248 `frame-parameters' and `modify-frame-parameters'. Specifically:
|
|
2249
|
|
2250 -- You can specify values (called "instantiators") for particular
|
|
2251 "locales" (i.e. buffers, windows, frames, devices, or a global value).
|
|
2252 When determining what the actual value (or "instance") of a specifier
|
|
2253 is, the specifications that are provided are searched from most
|
|
2254 specific (i.e. buffer-local) to most general (i.e. global), looking
|
|
2255 for a matching one.
|
|
2256
|
|
2257 -- You can specify multiple instantiators for a particular locale.
|
|
2258 For example, when specifying what the foreground color of a face
|
|
2259 is in a particular buffer, you could specify two instantiators:
|
|
2260 "dark sea green" and "green". The color would then be dark sea
|
|
2261 green on devices that recognize that color, and green on other
|
|
2262 devices. You have effectively provided a fallback value to make
|
|
2263 sure you get reasonable behavior on all devices.
|
|
2264
|
|
2265 -- You can add one or more tags to an instantiator, where a tag
|
|
2266 is a symbol that has been previously registered with XEmacs.
|
|
2267 This allows you to identify your instantiators for later
|
|
2268 removal in a way that won't interfere with other applications
|
|
2269 using the same specifier. Furthermore, particular tags can
|
|
2270 be restricted to match only particular sorts of devices.
|
|
2271 Any tagged instantiator will be ignored if the device over which
|
|
2272 it is being instanced does not match any of its tags. This
|
|
2273 allows you, for example, to restrict an instantiator to a
|
|
2274 particular device type (X or TTY) and/or class (color, grayscale,
|
|
2275 or mono). (You might want to specify, for example, that a
|
|
2276 particular face is displayed in green on color devices and is
|
|
2277 underlined on mono devices.)
|
|
2278
|
|
2279 -- A full API is provided for manipulating specifiers, and full
|
|
2280 documentation is provided in the Lisp Reference Manual.
|
|
2281
|
|
2282
|
|
2283
|
|
2284 *** Basic Lisp Stuff
|
|
2285 --------------------
|
|
2286
|
|
2287 Common-Lisp backquote syntax is recognized. For example, the old
|
|
2288 expression
|
|
2289
|
|
2290 (` (a b (, c)))
|
|
2291
|
|
2292 can now be written
|
|
2293
|
|
2294 `(a b ,c)
|
|
2295
|
|
2296 The old backquote syntax is still accepted.
|
|
2297
|
|
2298 The new function `type-of' returns a symbol describing the type of a
|
|
2299 Lisp object (`integer', `string', `symbol', etc.)
|
|
2300
|
|
2301 Symbols beginning with a colon (called "keywords") are treated
|
|
2302 specially in that they are automatically made self-evaluating when
|
|
2303 they are interned into `obarray'. The new function `keywordp' returns
|
|
2304 whether a symbol begins with a colon.
|
|
2305
|
|
2306 `get', `put', and `remprop' have been generalized to allow you to set
|
|
2307 and retrieve properties on many different kinds of objects: symbols,
|
|
2308 strings, faces, glyphs, and extents (for extents, however, this is not
|
|
2309 yet implemented). They are joined by a new function `object-props'
|
|
2310 that returns all of the properties that have been set on an object.
|
|
2311
|
|
2312 New functions `plists-eq' and `plists-equal' are provided for
|
|
2313 comparing property lists (a property list is an alternating list
|
|
2314 of keys and values).
|
|
2315
|
|
2316 The Common-Lisp functions `caar', `cadr', `cdar', `cddr', `caaar', etc.
|
|
2317 (up to four a's and/or d's), `first', `second', `third', etc. (up to
|
|
2318 `tenth'), `last', `rest', and `endp' have been added, for more
|
|
2319 convenient manipulation of lists.
|
|
2320
|
|
2321 New function `mapvector' maps over a sequence and returns a vector
|
|
2322 of the results, analogous to `mapcar'.
|
|
2323
|
|
2324 New functions `rassoc', `remassoc', `remassq', `remrassoc', and
|
|
2325 `remrassq' are provided for working with alists.
|
|
2326
|
|
2327 New functions `defvaralias', `variable-alias' and `indirect-variable'
|
|
2328 are provided for creating variable aliases.
|
|
2329
|
|
2330 Strings have a modified-tick that is bumped every time a string
|
|
2331 is modified in-place with `aset' or `fillarray'. This is retrieved
|
|
2332 with the new function `string-modified-tick'.
|
|
2333
|
|
2334 New macro `push' destructively adds an element to the beginning of a
|
|
2335 list. New macro `pop' destructively removes and returns the first
|
|
2336 element of a list.
|
|
2337
|
|
2338
|
|
2339
|
|
2340 *** Buffers
|
|
2341 -----------
|
|
2342
|
|
2343 Most functions that operate on buffer text now take an optional BUFFER
|
|
2344 argument, specifying which buffer they operate on. (Previously, they
|
|
2345 always operated on the current buffer.)
|
|
2346
|
|
2347 The new function `transpose-regions' is provided, ported from GNU
|
|
2348 Emacs.
|
|
2349
|
|
2350 The new function `save-current-buffer' works like `save-excursion'
|
|
2351 but only saves the current buffer, not the location of point in
|
|
2352 that buffer.
|
|
2353
|
|
2354
|
|
2355
|
|
2356 *** Devices
|
|
2357 -----------
|
|
2358
|
|
2359 XEmacs has a new concept of "device", which is represents a particular
|
|
2360 X display or TTY connection. `make-frame' has a new, optional device
|
|
2361 parameter that allows you to specify which device the frame is to be
|
|
2362 created on.
|
|
2363
|
|
2364 Multiple simultaneous TTY and/or X connections may be made. The
|
|
2365 specifier mechanism provides reasonable behavior of glyphs, faces,
|
|
2366 etc. over heterogeneous device types and over devices whose individual
|
|
2367 capabilities may vary.
|
|
2368
|
|
2369 There is also a device type called "stream" that represents a STDIO
|
|
2370 device that has no redisplay or cursor-motion capabilities, such as
|
|
2371 the "glass terminal" that XEmacs uses when it is run noninteractively.
|
|
2372 There is not all that much you can do with stream devices currently;
|
|
2373 please let us know if there are good uses you can think of for this
|
|
2374 capability. (For example, log files?)
|
|
2375
|
|
2376 A new device API is provided. Functions are provided such as
|
|
2377 `device-name' (the name of the device, which generally is based on the
|
|
2378 X display or TTY file name), `device-type' (X, TTY, or stream),
|
|
2379 `device-class' (color, grayscale, or mono), etc. See the Lisp
|
|
2380 Reference Manual.
|
|
2381
|
|
2382 Many functions have been extended to contain an additional, optional
|
|
2383 device argument, where such an extension makes sense. In general, if
|
|
2384 the argument is omitted, it is equivalent to specifying
|
|
2385 `(selected-device)'.
|
|
2386
|
|
2387 Many previous functions and variables are obsoleted in favor of the
|
|
2388 device API. For example, `window-system' is obsoleted by
|
|
2389 `device-type', and `x-color-display-p' and friends are obsoleted by
|
|
2390 `device-class'.
|
|
2391
|
70
|
2392 ** NOTE **: The obsolete variable `window-system' is going
|
0
|
2393 to be deleted soon, probably in 19.14. Please correct all
|
|
2394 your code to use `device-type'.
|
|
2395
|
70
|
2396 ** INCOMPATIBLE CHANGE **: The function `x-display-visual-class'
|
0
|
2397 returns different values from previous versions of XEmacs.
|
|
2398
|
|
2399
|
|
2400
|
|
2401 *** Errors, Warnings, C-g
|
|
2402 -------------------------
|
|
2403
|
|
2404 There is a new warnings system implemented. Many warnings that were
|
|
2405 formerly displayed in various ad-hoc ways (e.g. warnings about screwy
|
|
2406 modifier mappings, messages about failures handling the mouse cursor
|
|
2407 and errors in a gc-hook) have been regularized through this system.
|
|
2408 The new function `warn' displays a warning before the next redisplay
|
|
2409 (the actually display of the warning messages is accomplished through
|
|
2410 `display-warning-buffer'). Both `warn' and `display-warning-buffer'
|
|
2411 are Lisp functions (the C code calls out to them as necessary), and
|
|
2412 thus you can customize the warning system.
|
|
2413
|
|
2414 Under an X display, you can press Shift-Control-G to force a "critical
|
|
2415 quit". This will immediately display a backtrace and pop you into the
|
|
2416 debugger, regardless of the settings of `inhibit-quit' and
|
|
2417 `debug-on-quit'.
|
|
2418
|
|
2419 C-g now works properly even on systems that don't implement SIGIO or
|
|
2420 for which SIGIO is broken (e.g. IRIX 5.3 and older versions of Linux).
|
|
2421 In addition, the SIGIO support has been fixed for many systems on
|
|
2422 which it didn't always work properly before (e.g. HPUX and Solaris).
|
|
2423
|
70
|
2424
|
0
|
2425
|
|
2426 *** Events
|
|
2427 ----------
|
|
2428
|
70
|
2429 ** INCOMPATIBLE CHANGE **: Many event functions have been changed to
|
0
|
2430 accept and return windows instead of frames.
|
|
2431
|
|
2432 New function: `event-live-p', specifying whether `deallocate-event'
|
|
2433 has been called on an event.
|
|
2434
|
|
2435 The "menu event" type has been renamed to "misc-user event", and
|
|
2436 encompasses scrollbar events as well as menu events. We are planning
|
|
2437 on making it also encompass toolbar events in a future release.
|
|
2438
|
|
2439 New functions are provided for determining whether an particular
|
|
2440 sections of a frame: `event-over-border-p', `event-over-glyph-p',
|
|
2441 `event-over-modeline-p', `event-over-text-area-p', and
|
|
2442 `event-over-toolbar-p'. The old, kludgey methods of checking the
|
|
2443 window-height, the internal-border-width, etc. are unreliable and
|
|
2444 should not be used.
|
|
2445
|
|
2446 New functions `event-window-x-pixel' and `event-window-y-pixel' are
|
|
2447 provided for determining where in a particular window an event
|
|
2448 happened.
|
|
2449
|
|
2450 New functions `event-glyph-x-pixel' and `event-glyph-y-pixel' are
|
|
2451 provided for determining where in a particular glyph an event
|
|
2452 happened.
|
|
2453
|
|
2454 New function `event-closest-point', which returns the closest buffer
|
|
2455 position to the event even if the event did not occur over any text.
|
|
2456
|
|
2457 New variable `unread-command-events', superseding the older
|
|
2458 `unread-command-event'.
|
|
2459
|
|
2460 Many event-loop bugs have been fixed.
|
|
2461
|
|
2462
|
|
2463
|
|
2464 *** Extents
|
|
2465 -----------
|
|
2466
|
|
2467 The extent code has been largely rewritten. It should be faster and
|
|
2468 more reliable.
|
|
2469
|
|
2470 The text-property implementation has been greatly improved.
|
|
2471
|
|
2472 Some new extent primitives are provided to return the position of the
|
|
2473 next or previous property change in a buffer.
|
|
2474
|
|
2475 Extents can now have a parent specified; then all of its properties
|
|
2476 (except for the buffer it's in and its position in that buffer) come
|
|
2477 from that extent. Hierarchies of such extents can be created.
|
|
2478
|
|
2479 Extents now have a `detachable' property that controls what happens
|
|
2480 (they either get detached or shrink down to zero-length) when their
|
|
2481 text is deleted. Previously, such extents would always be detached.
|
|
2482
|
|
2483 The `invisible' property on extents now works.
|
|
2484
|
|
2485 `map-extents' has three additional parameters that provide more
|
|
2486 control over which extents are mapped.
|
|
2487
|
|
2488 `map-extents' deals better with changes made to extents in the
|
|
2489 buffer being mapped over.
|
|
2490
|
|
2491 A new function `mapcar-extents' (an alternative to `map-extents') has
|
|
2492 been provided and should be easier to use than `map-extents'.
|
|
2493
|
|
2494
|
|
2495
|
|
2496 *** Faces
|
|
2497 ---------
|
|
2498
|
|
2499 Faces can now be buffer-local, window-local, and device-local as well
|
|
2500 as frame-local, and can be further restricted to a particular device
|
|
2501 type or class. The way in which faces can be controlled is now based
|
|
2502 on the general and powerful specifier mechanism; see above.
|
|
2503
|
|
2504 The new function `set-face-property' generalizes `set-face-font',
|
|
2505 `set-face-foreground', etc. and takes many new optional arguments, in
|
|
2506 accordance with the new specifier mechanism.
|
|
2507
|
|
2508 The new functions `face-property' and `face-property-instance'
|
|
2509 generalize `face-font', `face-foreground', etc. and take many new
|
|
2510 optional arguments, in accordance with the new specifier mechanism.
|
|
2511 (`face-property' returns the value, if any, that was specified for a
|
|
2512 particular locale, and `face-property-instance' returns the actual
|
|
2513 value that will be used for display. See the section on specifiers.)
|
|
2514
|
|
2515 The functions `face-font', `face-foreground', `face-background',
|
|
2516 `set-face-font', `set-face-foreground', `set-face-background',
|
|
2517 etc. are now convenience functions, trivially implemented using
|
153
|
2518 `face-property' and `set-face-property' and take new optional
|
0
|
2519 arguments in accordance with those functions. New convenience
|
|
2520 functions `face-font-instance', `face-foreground-instance',
|
|
2521 `face-background-instance', etc. are provided and are trivially
|
|
2522 implemented using `face-property-instance'.
|
|
2523
|
|
2524 Inheritance of face properties can now be specified. Each individual
|
|
2525 face property can inherit differently from other properties, or not
|
|
2526 inherit at all.
|
|
2527
|
|
2528 You can set user-defined properties on faces using
|
|
2529 `set-face-property'.
|
|
2530
|
|
2531 You can create "temporary" faces, which are faces that disappear
|
|
2532 when they are no longer in use. This is as opposed to normal
|
|
2533 faces, which stay around forever.
|
|
2534
|
|
2535 The function `make-face' takes a new optional argument specifying
|
|
2536 whether a face should be permanent or temporary, and returns the
|
|
2537 actual face object rather than the face symbol, as in previous
|
|
2538 versions of XEmacs.
|
|
2539
|
|
2540 The function `face-list' takes a new optional argument specifying
|
|
2541 whether permanent, temporary, or both kinds of faces should be
|
|
2542 returned.
|
|
2543
|
|
2544 Faces have new TTY-specific properties: `highlight', `reverse',
|
|
2545 `alternate', `blinking', and `dim'.
|
|
2546
|
|
2547 Redisplay is smarter about dealing with face changes: changes to a
|
|
2548 particular face no longer cause all frames to be cleared and
|
|
2549 redisplayed.
|
|
2550
|
|
2551 The Edit-Faces package is provided for interactively changing faces.
|
|
2552 A menu item on the options menu is provided for this.
|
|
2553
|
|
2554 New functions are provided for retrieving the ascent, descent, height,
|
|
2555 and width of a character in a particular face.
|
|
2556
|
|
2557
|
|
2558
|
|
2559 *** Fonts, Colors
|
|
2560 -----------------
|
|
2561
|
70
|
2562 ** INCOMPATIBLE CHANGE **: The old "font" and "pixel" objects are gone.
|
0
|
2563 In place are new objects "font specifier", "font instance", "color
|
|
2564 specifier", and "color instance". Functions `font-name', `pixel-name'
|
|
2565 (an obsolete alias for `color-name'), etc. are now convenience
|
|
2566 functions for working with font and color specifiers. Old code that
|
|
2567 is not too sophisticated about working with font and pixel objects may
|
|
2568 still work, though. (For example, the idiom `(font-name (face-font
|
|
2569 'default))' still works.)
|
|
2570
|
|
2571 You can now extract the RGB components of a color-instance object
|
|
2572 (similar to the old pixel object) with the function
|
|
2573 `color-instance-rgb-components'. There is also a convenience function
|
|
2574 `color-rgb-components' for working with color specifiers.
|
|
2575
|
|
2576 If there are no more colors available in the colormap, the nearest
|
|
2577 existing color will be used when allocating a new color.
|
|
2578
|
|
2579
|
|
2580
|
|
2581 *** Frames
|
|
2582 ----------
|
|
2583
|
|
2584 What used to be called "screens" are now called "frames", for clarity
|
|
2585 and consistency with GNU Emacs. Aliases are provided for all the old
|
|
2586 screen functions and variables, to avoid introducing a huge E-Lisp
|
|
2587 incompatibility.
|
|
2588
|
|
2589 The frame code has been merged with GNU Emacs 19.28, providing
|
|
2590 improved functionality for many functions.
|
|
2591
|
|
2592
|
|
2593
|
|
2594 *** Glyphs, Images, and Pixmaps
|
|
2595 -------------------------------
|
|
2596
|
|
2597 Glyphs (used in various places, i.e. as begin-glyphs and end-glyphs
|
|
2598 attached to extents and appearing in a buffer or in marginal
|
|
2599 annotations; as the truncator and continuor glyphs marking line wrap
|
|
2600 or truncation; as an overlay at the beginning of a line; as the
|
|
2601 displayable element in a toolbar button; etc.) can now be
|
|
2602 buffer-local, window-local, frame-local, and device-local, and can be
|
|
2603 further restricted to a particular device type or class. The way in
|
|
2604 which faces can be controlled is now based on the general and powerful
|
|
2605 specifier mechanism; see above.
|
|
2606
|
70
|
2607 ** INCOMPATIBLE CHANGE **: The glyph and pixmap API has been completely
|
0
|
2608 overhauled. A new Lisp object "glyph" is provided and should be used
|
|
2609 where the old "pixmap" object would have been used. The pixmap object
|
|
2610 exists no longer. There are also new Lisp objects "image specifier"
|
|
2611 and "image instance" (an image-instance is the closest equivalent to
|
|
2612 what a pixmap object was). More work on glyphs and images is slated
|
|
2613 for 19.13. The glyph and image docs in the Lisp Reference Manual are
|
|
2614 incomplete and will be finished in 19.13.
|
|
2615
|
|
2616 The new function `set-glyph-property' allows setting of all the
|
|
2617 glyph properties (`baseline', `contrib-p', etc.). Convenience
|
|
2618 functions for particular properties are also provided, just like
|
|
2619 for faces.
|
|
2620
|
|
2621 You can set user-defined properties on glyphs using the new function
|
|
2622 `set-glyph-property'.
|
|
2623
|
|
2624 When displaying pixmaps, existing, closest-matching colors will be
|
|
2625 used if the colormap is full.
|
|
2626
|
|
2627 If the compface library is compiled into XEmacs, there is built-in
|
|
2628 support for displaying X-Face bitmaps. (These are typically small
|
|
2629 pictures of people's faces, included in a mail message through the
|
|
2630 X-Face: header.) VM and highlight-headers will automatically use the
|
|
2631 built-in X-Face support if it is available.
|
|
2632
|
|
2633 Annotations in the right margin (as well as the left margin) are now
|
|
2634 implemented. The left and right margin width functions have been
|
|
2635 superseded by the specifier variables `left-margin-width' and
|
|
2636 `right-margin-width', allowing much more flexible control through the
|
|
2637 specifier mechanism.
|
|
2638
|
70
|
2639 ** INCOMPATIBLE CHANGE **: The variable `use-left-overflow',
|
0
|
2640 for controlling annotations in the left margin, is now a specifier
|
|
2641 variable instead of a buffer-local variable. (There is also a new
|
|
2642 variable `use-right-overflow', that is complementary.)
|
|
2643
|
|
2644
|
|
2645
|
|
2646 *** Hashing
|
|
2647 -----------
|
|
2648
|
|
2649 Two new types of weak hashtables can be created: key-weak and
|
|
2650 value-weak. In a key-weak hashtable, an entry remains around
|
|
2651 if its key is referenced elsewhere, regardless of whether this
|
|
2652 is also the case for the value. Value-weak hashtables are
|
|
2653 complementary. (This is as opposed to the traditional weak
|
|
2654 hashtables, where an entry remains around only if both the
|
|
2655 key and value are referenced elsewhere.) New functions
|
|
2656 `make-key-weak-hashtable' and `make-value-weak-hashtable'
|
|
2657 are provided for creating these hashtables.
|
|
2658
|
|
2659 The new function `md5' is provided for performing an MD5
|
|
2660 hash of an object. MD5 is a secure message digest algorithm
|
|
2661 developed by RSA, inc.
|
|
2662
|
|
2663
|
|
2664
|
|
2665 *** Keymaps
|
|
2666 -----------
|
|
2667
|
116
|
2668 The GNU Emacs concept of `function-key-map' is now partially
|
0
|
2669 implemented. This allows conversion of function-key escape sequences
|
|
2670 such as `ESC [ 1 1 ~' into an equivalent human-readable keysym such as
|
|
2671 `F1'. This work will be completed in 19.14. The function-key map is
|
|
2672 device-local and controllable through the functions
|
|
2673 `device-function-key-map' and `set-device-function-key-map'.
|
|
2674
|
|
2675 `where-is-internal' now correctly searches minor-mode keymaps,
|
|
2676 extent-local keymaps, etc. As a side effect of this, menu items will
|
|
2677 now correctly show the keyboard equivalent for commands that are
|
|
2678 available through a minor-mode keymap, extent-local keymap, etc.
|
|
2679
|
70
|
2680 ** INCOMPATIBLE CHANGE **: The modifier key "Symbol" has
|
0
|
2681 been renamed to "Alt", for compatibility with the rest of the world.
|
|
2682 Keep in mind that on many keyboards, the key labelled "Alt" actually
|
|
2683 generates the "Meta" modifier. (On Sun keyboards, however, the key
|
|
2684 labelled "Alt" does indeed generate the "Alt" modifier, and the key
|
|
2685 labelled with a diamond generates the "Meta" modifier.)
|
|
2686
|
|
2687
|
|
2688
|
|
2689 *** Mouse, Active Region
|
|
2690 ------------------------
|
|
2691
|
|
2692 The mouse internals in mouse.el have been rewritten. Hooks have been
|
|
2693 provided for easier customization of mouse behavior. For example, you
|
|
2694 can now easily specify an action to be invoked on single-click
|
|
2695 (i.e. down-up without appreciable motion), double-click, drag-up, etc.
|
|
2696
|
116
|
2697 Some code from GNU Emacs has been ported over, generalizing some of
|
0
|
2698 the X-specific mouse stuff.
|
|
2699
|
70
|
2700 ** INCOMPATIBLE CHANGE **: The function `set-mouse-position' accepts
|
0
|
2701 a window instead of a frame.
|
|
2702
|
|
2703 New function `mouse-position' that obsoletes and is more powerful than
|
|
2704 `read-mouse-position'.
|
|
2705
|
153
|
2706 New functions `mouse-pixel-position' and `set-mouse-pixel-position' for
|
0
|
2707 working with pixels instead of characters.
|
|
2708
|
|
2709 The active (Zmacs) region is now highlighted using the `zmacs-region-face'
|
|
2710 instead of the `primary-selection-face'; this generalizes what used
|
|
2711 to be X-specific.
|
|
2712
|
|
2713 New functions `region-active-p', `region-exists-p', and `activate-region'
|
|
2714 provide a uniform API for dealing with the region irrespective of
|
|
2715 whether the variable `zmacs-regions' is set.
|
|
2716
|
|
2717 XEmacs is now a better X citizen with respect to the primary selection:
|
|
2718 it does not stomp on the primary selection quite so much. This makes
|
|
2719 things more manageable if you set `zmacs-regions' to nil.
|
|
2720
|
|
2721
|
|
2722
|
|
2723 *** Processes
|
|
2724 -------------
|
|
2725
|
|
2726 Various process race conditions and bugs have been fixed. Problems
|
|
2727 with process termination not getting noticed until much later (if at
|
|
2728 all) should be gone now, as well as problems with zombie processes
|
|
2729 under some systems.
|
|
2730
|
|
2731 SOCKS support is now included. SOCKS is a package that allows hosts
|
|
2732 behind a firewall to gain full access to the Internet without
|
|
2733 requiring direct IP reachability.
|
|
2734
|
|
2735
|
|
2736
|
|
2737 *** Windows
|
|
2738 -----------
|
|
2739
|
|
2740 Windows 95 is still not out yet.
|
|
2741
|
70
|
2742 ** INCOMPATIBLE CHANGE **: The functions `locate-window-from-coordinates'
|
0
|
2743 and `window-edges' have been eliminated. It no longer makes sense to
|
|
2744 work with windows in terms of character positions, because windows can
|
|
2745 (and often do) have many differently-sized fonts in them, because the
|
|
2746 3-D modeline is not exactly one line high, etc.
|
|
2747
|
|
2748 The new functions `window-pixel-edges', `window-highest-p',
|
|
2749 `window-lowest-p', `frame-highest-window', and `frame-lowest-window'
|
|
2750 are provided as substitutes for the above-mentioned, deleted
|
|
2751 functions.
|
|
2752
|
|
2753 The function `window-end' now takes an optional GUARANTEE argument
|
|
2754 that will ensure that the value is actually correct as of the next
|
|
2755 redisplay.
|
|
2756
|
|
2757 The window code has been merged with GNU Emacs 19.28, providing
|
|
2758 improved functionality for many functions.
|
|
2759
|
|
2760
|
|
2761
|
|
2762 *** System-Specific Information
|
|
2763 -------------------------------
|
|
2764
|
|
2765 Georg Nikodym's dynodump package is provided, for proper unexec()ing
|
|
2766 on Solaris systems. Executables built on Solaris 2.3 can now run on
|
|
2767 Solaris 2.4 without crashing; similarly with executables built on one
|
|
2768 type of Sun machine and run on another.
|
|
2769
|
|
2770 AIX 4.x is supported.
|
|
2771
|
|
2772 The NeXTstep operating system is supported in TTY mode (this is still
|
|
2773 in beta). There are plans to port XEmacs to the NeXTstep window
|
|
2774 system, but it may be awhile before this is complete.
|
|
2775
|
|
2776 Problems with the `round' function causing arithmetic errors on HPUX 9
|
|
2777 have been fixed.
|
|
2778
|
|
2779 You can now build XEmacs as an ELF executable on Linux systems that
|
|
2780 support ELF.
|
|
2781
|
|
2782 Various other new system configurations are supported.
|
|
2783
|
|
2784
|
|
2785
|
70
|
2786 *** Packages
|
|
2787 ------------
|
|
2788
|
|
2789 Most packages have been updated to the latest available versions.
|
|
2790
|
|
2791
|
|
2792 Some of the new Emacs Lisp packages ---
|
|
2793
|
|
2794 Hyperbole: the everyday information manager. Provides a Rolodex,
|
|
2795 allows links to be embedded in text, etc.
|
|
2796
|
|
2797 OOBR: a sophisticated class browser for object-oriented languages.
|
|
2798
|
|
2799 viper: a better VI emulator that allows Emacs and VI features
|
|
2800 to coexist happily.
|
|
2801
|
|
2802 hm--html-menus: a sophisticated package for editing HTML code,
|
|
2803 from Heiko Muenkel.
|
|
2804
|
|
2805 ksh-mode.el: for editing shell scripts.
|
|
2806
|
|
2807 lazy-lock.el: a lazy, on-the-fly fontifier.
|
|
2808
|
|
2809 paren.el: an improved matching paren highlighter
|
|
2810
|
|
2811
|
|
2812
|
|
2813 Major changes to existing packages --
|
|
2814
|
|
2815 VM: has a toolbar, many other nice features.
|
|
2816
|
|
2817 w3: has a toolbar, many other nice features.
|
|
2818
|
|
2819 ediff: provides three-way merging, has a better user interface.
|
|
2820
|
|
2821 info: has a toolbar.
|
|
2822
|
|
2823 highlight-headers.el: now highlights URL's and makes them active so
|
|
2824 that when clicked either Netscape 1.1 is called
|
|
2825 or Emacs W3 is run.
|
|
2826
|
0
|
2827
|
|
2828 ** Major Differences Between 19.10 and 19.11
|
|
2829 ============================================
|
70
|
2830
|
0
|
2831 The name has changed from "Lucid Emacs" to "XEmacs". Along with this is a
|
|
2832 new canonical ftp site: cs.uiuc.edu:/pub/xemacs.
|
|
2833
|
|
2834 XEmacs now has its very own World Wide Web page! It contains a
|
|
2835 complete list of the FTP distribution sites, the most recent FAQ,
|
|
2836 pointers to Emacs Lisp packages not included with the distribution, and
|
|
2837 other useful stuff. Check it out at http://xemacs.cs.uiuc.edu/.
|
|
2838
|
|
2839 A preliminary New Users Guide.
|
|
2840
|
|
2841 cc-mode.el now provides the default C, C++ and Objective-C modes.
|
|
2842
|
|
2843 The primary goal of this release is stability. Very few new features have
|
|
2844 been introduced but lots of bugs have been fixed. Many of the Emacs Lisp
|
|
2845 packages have been updated.
|
|
2846
|
|
2847 Some of the new Emacs Lisp packages ---
|
|
2848
|
|
2849 tcl-mode.el: major mode for editing TCL code
|
|
2850
|
|
2851 fast-lock.el: saves and restores font-lock highlighting, greatly
|
|
2852 reducing the time necessary for loading a font-lock'ed
|
|
2853 file
|
|
2854
|
|
2855 ps-print.el: prints buffers to Postscript printers preserving the
|
|
2856 buffer's bold and italic text attributes
|
|
2857
|
|
2858 toolbar.el: provides a "fake" toolbar for use with XEmacs (an
|
|
2859 integrated one will be included with 19.12)
|
|
2860
|
|
2861
|
|
2862 ** Major Differences Between 19.9 and 19.10
|
|
2863 ===========================================
|
|
2864
|
|
2865 The GNU `configure' system is now used to build lemacs.
|
|
2866
|
|
2867 The Emacs Manual and Emacs Lisp Reference Manual now document version 19.10.
|
|
2868 If you notice any errors, please let us know.
|
|
2869
|
|
2870 When pixmaps are displayed in a buffer, they contribute to the line height -
|
|
2871 that is, if the glyph is taller than the rest of the text on the line, the
|
|
2872 line will be as tall as necessary to display the glyph.
|
|
2873
|
|
2874 In addition to using arbitrary sound files as emacs beeps, one can control
|
|
2875 the pitch and duration of the standard X beep, on X servers which allow that
|
|
2876 (Note: most don't.)
|
|
2877
|
|
2878 There is support for playing sounds on systems with NetAudio servers.
|
|
2879
|
|
2880 Minor modes may have mode-specific key bindings; keymaps may have an arbitrary
|
|
2881 number of parent maps.
|
|
2882
|
|
2883 Menus can have toggle and radio buttons in them.
|
|
2884
|
|
2885 There is a font selection menu.
|
|
2886
|
|
2887 Some default key bindings have changed to match FSF19; the new bindings are
|
|
2888
|
|
2889 Screen-related commands:
|
|
2890 C-x 5 2 make-screen
|
|
2891 C-x 5 0 delete-screen
|
|
2892 C-x 5 b switch-to-buffer-other-screen
|
|
2893 C-x 5 f find-file-other-screen
|
|
2894 C-x 5 C-f find-file-other-screen
|
|
2895 C-x 5 m mail-other-screen
|
|
2896 C-x 5 o other-screen
|
|
2897 C-x 5 r find-file-read-only-other-screen
|
|
2898 Abbrev-related commands:
|
|
2899 C-x a l add-mode-abbrev
|
|
2900 C-x a C-a add-mode-abbrev
|
|
2901 C-x a g add-global-abbrev
|
|
2902 C-x a + add-mode-abbrev
|
|
2903 C-x a i g inverse-add-global-abbrev
|
|
2904 C-x a i l inverse-add-mode-abbrev
|
|
2905 C-x a - inverse-add-global-abbrev
|
|
2906 C-x a e expand-abbrev
|
|
2907 C-x a ' expand-abbrev
|
|
2908 Register-related commands:
|
|
2909 C-x r C-SPC point-to-register
|
|
2910 C-x r SPC point-to-register
|
|
2911 C-x r j jump-to-register
|
|
2912 C-x r s copy-to-register
|
|
2913 C-x r x copy-to-register
|
|
2914 C-x r i insert-register
|
|
2915 C-x r g insert-register
|
|
2916 C-x r r copy-rectangle-to-register
|
|
2917 C-x r c clear-rectangle
|
|
2918 C-x r k kill-rectangle
|
|
2919 C-x r y yank-rectangle
|
|
2920 C-x r o open-rectangle
|
|
2921 C-x r t string-rectangle
|
|
2922 C-x r w window-configuration-to-register
|
|
2923 Narrowing-related commands:
|
|
2924 C-x n n narrow-to-region
|
|
2925 C-x n w widen
|
|
2926 Other changes:
|
|
2927 C-x 3 split-window-horizontally (was undefined)
|
|
2928 C-x - shrink-window-if-larger-than-buffer
|
|
2929 C-x + balance-windows
|
|
2930
|
70
|
2931 The variable allow-deletion-of-last-visible-screen has been removed, since
|
0
|
2932 it was widely hated. You can now always delete the last visible screen if
|
|
2933 there are other iconified screens in existence.
|
|
2934
|
|
2935 ToolTalk support is provided.
|
|
2936
|
|
2937 An Emacs screen can be placed within an "external client widget" managed
|
|
2938 by another application. This allows an application to use an Emacs screen
|
|
2939 as its text pane rather than the standard Text widget that is provided
|
|
2940 with Motif or Athena.
|
|
2941
|
|
2942 Additional compatibility with Epoch is provided (though this is not yet
|
|
2943 complete.)
|
|
2944
|
|
2945
|
|
2946 ** Major Differences Between 19.8 and 19.9
|
|
2947 ==========================================
|
|
2948
|
|
2949 Scrollbars! If you have Motif, these are real Motif scrollbars; otherwise,
|
|
2950 Athena scrollbars are used. They obey all the usual resources of their
|
|
2951 respective toolkits.
|
|
2952
|
2
|
2953 There is now an implementation of dialog boxes based on the Athena
|
0
|
2954 widgets, as well as the existing Motif implementation.
|
|
2955
|
70
|
2956 This release works with Motif 1.2 as well as 1.1. If you link with Motif,
|
0
|
2957 you do not also need to link with Athena.
|
|
2958
|
|
2959 If you compile lwlib with both USE_MOTIF and USE_LUCID defined (which is the
|
|
2960 recommended configuration) then the Lucid menus will draw text using the Motif
|
|
2961 string-drawing library, instead of the Xlib one. The reason for this is that
|
|
2962 one can take advantage of the XmString facilities for including non-Latin1
|
|
2963 characters in resource specifications. However, this is a user-visible change
|
70
|
2964 in that, in this configuration, the menubar will use the "*fontList" resource
|
0
|
2965 in preference to the "*font" resource, if it is set.
|
|
2966
|
|
2967 It's possible to make extents which are copied/pasted by kill and undo.
|
|
2968 There is an implementation of FSF19-style text properties based on this.
|
|
2969
|
|
2970 There is a new variable, minibuffer-max-depth, which is intended to circumvent
|
|
2971 a common source of confusion among new Emacs users. Since, under a window
|
|
2972 system, it's easy to jump out of the minibuffer (by doing M-x, then getting
|
|
2973 distracted, and clicking elsewhere) many, many novice users have had the
|
|
2974 problem of having multiple minibuffers build up, even to the point of
|
|
2975 exhausting the lisp stack. So the default behavior is to disallow the
|
|
2976 minibuffer to ever be reinvoked while active; if you attempt to do so, you
|
|
2977 will be prompted about it.
|
|
2978
|
|
2979 There is a new variable, teach-extended-commands-p, which if set, will cause
|
|
2980 `M-x' to remind you of any key bindings of the command you just invoked the
|
|
2981 "long way."
|
|
2982
|
|
2983 There are menus in Dired, Tar, Comint, Compile, and Grep modes.
|
|
2984
|
|
2985 There is a menu of window management commands on the right mouse button over
|
|
2986 the modelines.
|
|
2987
|
70
|
2988 Popup menus now have titles at the top; this is controlled by the new
|
0
|
2989 variable `popup-menu-titles'.
|
|
2990
|
|
2991 The `Find' key on Sun keyboards will search for the next (or previous)
|
|
2992 occurrence of the selected text, as in OpenWindows programs.
|
|
2993
|
|
2994 The `timer' package has been renamed to `itimer' to avoid a conflict with
|
|
2995 a different package called `timer'.
|
|
2996
|
|
2997 VM 5.40 is included.
|
|
2998
|
|
2999 W3, the emacs interface to the World Wide Web, is included.
|
|
3000
|
|
3001 Felix Lee's GNUS speedups have been installed, including his new version of
|
|
3002 nntp.el which makes GNUS efficiently utilize the NNTP XOVER command if
|
70
|
3003 available (which is much faster.)
|
0
|
3004
|
|
3005 GNUS should also be much friendlier to new users: it starts up much faster,
|
|
3006 and doesn't (necessarily) subscribe you to every single newsgroup.
|
|
3007
|
|
3008 The byte-compiler issues a new class of warnings: variables which are
|
|
3009 bound but not used. This is merely an advisory, and does not mean the
|
|
3010 code is incorrect; you can disable these warnings in the usual way with
|
|
3011 the `byte-compiler-options' macro.
|
|
3012
|
|
3013 the `start-open' and `end-open' extent properties, for specifying whether
|
|
3014 characters inserted exactly at a boundary of an extent should go into the
|
|
3015 extent or out of it, now work correctly.
|
|
3016
|
|
3017 The `extent-data' slot has been generalized/replaced with a property list,
|
|
3018 so it's easier to attach arbitrary data to extent objects.
|
|
3019
|
|
3020 The `event-modifiers' and `event-modifier-bits' functions work on motion
|
|
3021 events as well as other mouse and keyboard events.
|
|
3022
|
|
3023 Forms-mode uses fonts and read-only regions.
|
|
3024
|
|
3025 The behavior of the -geometry command line option should be correct now.
|
|
3026
|
|
3027 The `iconic' screen parameter works when passed to x-create-screen.
|
|
3028
|
|
3029 The user's manual now documents Lucid Emacs 19.9.
|
|
3030
|
|
3031 The relocating buffer allocator is turned on by default; this means that when
|
70
|
3032 buffers are killed, their storage will be returned to the operating system,
|
0
|
3033 and the size of the emacs process will shrink.
|
|
3034
|
|
3035 CAVEAT: code which contains calls to certain `face' accessor functions will
|
|
3036 need to be recompiled by version 19.9 before it will work. The functions
|
|
3037 whose callers must be recompiled are: face-font, face-foreground,
|
|
3038 face-background, face-background-pixmap, and face-underline-p. The symptom
|
|
3039 of this problem is the error "Wrong type argument, arrayp, #<face ... >".
|
|
3040 The .elc files generated by version 19.9 will work in 19.6 and 19.8, but
|
|
3041 older .elc files which contain calls to these functions will not work in 19.9.
|
|
3042
|
|
3043 Work In Progress:
|
|
3044
|
|
3045 - We have been in the process of internationalizing Lucid Emacs. This code is
|
|
3046 ***not*** ready for general use yet. However, the code is included (and
|
|
3047 turned off by default) in this release.
|
|
3048
|
|
3049 - If you define I18N2 at compile-time, then sorting/collation will be done
|
|
3050 according to the locale returned by setlocale().
|
|
3051
|
|
3052 - If you define I18N3 at compile-time, then all messages printed by lemacs
|
|
3053 will be filtered through the gettext() library routine, to enable the use
|
|
3054 of locale-specific translation catalogues. The current implementation of
|
70
|
3055 this is quite dependent on Solaris 2, and has a very large impact on
|
0
|
3056 existing code, therefore we are going to be making major changes soon.
|
|
3057 (You'll notice calls to `gettext' and `GETTEXT' scattered around much of
|
|
3058 the lisp and C code; ignore it, this will be going away.)
|
|
3059
|
|
3060 - If you define I18N4 at compile-time, then lemacs will internally use a
|
|
3061 wide representation of characters, enabling the use of large character
|
70
|
3062 sets such as Kanji. This code is very OS dependent: it requires X11R5,
|
0
|
3063 and several OS-supplied library routines for reading and writing wide
|
|
3064 characters (getwc(), putwc(), and a few others.) Performance is also a
|
|
3065 problem. This code is also scheduled for a major overhaul, with the
|
70
|
3066 intent of improving performance and portability.
|
0
|
3067
|
|
3068 Our eventual goal is to merge with MULE, or at least provide the same base
|
70
|
3069 level of functionality. If you would like to help out with this, let us
|
0
|
3070 know.
|
|
3071
|
70
|
3072 - Other work-in-progress includes Motif drag-and-drop support, ToolTalk
|
|
3073 support, and support for embedding an Emacs widget inside another
|
0
|
3074 application (where it can function as that other application's text-entry
|
|
3075 area). This code has not been extensively tested, and may (or may not)
|
70
|
3076 have portability problems, but it's there for the adventurous. Comments,
|
0
|
3077 suggestions, bug reports, and especially fixes are welcome. But have no
|
|
3078 expectations that this experimental code will work at all.
|
|
3079
|
|
3080
|
|
3081 ** Major Differences Between 19.6 and 19.8
|
|
3082 ==========================================
|
|
3083
|
|
3084 There were almost no differences between versions 19.6 and 19.7; version 19.7
|
|
3085 was a bug-fix release that was distributed with Energize 2.1.
|
|
3086
|
|
3087 Lucid Emacs 19.8 represents the first stage of the Lucid Emacs/Epoch merger.
|
|
3088 The redisplay engine now in lemacs is an improved descendant of the Epoch
|
|
3089 redisplay. As a result, many bugs have been eliminated, and several disabled
|
|
3090 features have been re-enabled. Notably:
|
|
3091
|
|
3092 Selective display (and outline-mode) work.
|
|
3093
|
|
3094 Horizontally split windows work.
|
|
3095
|
|
3096 The height of a line is the height of the tallest font displayed on that line;
|
|
3097 it is possible for a screen to display lines of differing heights. (Previously,
|
|
3098 the height of all lines was the height of the tallest font loaded.)
|
|
3099
|
|
3100 There is lisp code to scale fonts up and down, for example, to load the next-
|
|
3101 taller version of a font.
|
|
3102
|
|
3103 There is a new internal representation for lisp objects, giving emacs-lisp 28
|
|
3104 bit integers and a 28 bit address space, up from the previous maximum of 26.
|
|
3105 We expect eventually to increase this to 30 bit integers and a 32 bit address
|
|
3106 space, eliminating the need for DATA_SEG_BITS on some architectures. (On 64
|
|
3107 bit machines, add 32 to all of these numbers.)
|
|
3108
|
|
3109 GC performance is improved.
|
|
3110
|
|
3111 Various X objects (fonts, colors, cursors, pixmaps) are accessible as first-
|
|
3112 class lisp objects, with finalization.
|
|
3113
|
|
3114 An alternate interface to embedding images in the text is provided, called
|
|
3115 "annotations." You may create an "annotation margin" which is whitespace at
|
|
3116 the left side of the screen that contains only annotations, not buffer text.
|
|
3117
|
|
3118 When using XPM files, one can specify the values of logical color names to be
|
|
3119 used when loading the files.
|
|
3120
|
|
3121 It is possible to resize windows by dragging their modelines up and down. More
|
|
3122 generally, it is possible to add bindings for mouse gestures on the modelines.
|
|
3123
|
|
3124 There is support for playing sound files on HP machines.
|
|
3125
|
|
3126 ILISP version 5.5 is included.
|
|
3127
|
|
3128 The Common Lisp #' read syntax is supported (#' is to "function" as ' is to
|
|
3129 "quote".)
|
|
3130
|
|
3131 The `active-p' slot of menu items is now evaluated, so one can put arbitrary
|
|
3132 lisp code in a menu to decide whether that item should be selectable, rather
|
|
3133 than doing this with an `activate-menubar-hook'.
|
|
3134
|
|
3135 The X resource hierarchy has changed slightly, to be more consistent. It used
|
|
3136 to be
|
|
3137 argv[0] SCREEN-NAME pane screen
|
|
3138 ApplicationShell EmacsShell Paned EmacsFrame
|
|
3139
|
|
3140 now it is
|
|
3141
|
|
3142 argv[0] shell pane SCREEN-NAME
|
|
3143 ApplicationShell EmacsShell Paned EmacsFrame
|
|
3144
|
|
3145 The Lucid Emacs sources have been largely merged with FSF version 19; this
|
|
3146 means that the lisp library contains the most recent releases of various
|
|
3147 packages, and many new features of FSF 19 have been incorporated.
|
|
3148
|
|
3149 Because of this, the lemacs sources should also be substantially more portable.
|
|
3150
|
|
3151
|
|
3152 ** Major Differences Between 19.4 and 19.6
|
|
3153 ==========================================
|
|
3154
|
|
3155 There were almost no differences between versions 19.4 and 19.5; we fixed
|
|
3156 a few minor bugs and repacked 19.4 as 19.5 for a CD-ROM that we gave away
|
|
3157 as a trade show promotion.
|
|
3158
|
|
3159 The primary goal of the 19.6 release is stability, rather than improved
|
|
3160 functionality, so there aren't many user-visible changes. The most notable
|
|
3161 changes are:
|
|
3162
|
|
3163 - The -geometry command-line option now correctly overrides geometry
|
|
3164 specifications in the resource database.
|
|
3165 - The `width' and `height' screen-parameters work.
|
|
3166 - Font-lock-mode considers the comment start and end characters to be
|
|
3167 a part of the comment.
|
|
3168 - The lhilit package has been removed. Use font-lock-mode instead.
|
|
3169 - vm-isearch has been fixed to work with isearch-mode.
|
|
3170 - new versions of ispell and calendar.
|
|
3171 - sccs.el has menus.
|
|
3172
|
|
3173 Lots of bugs were fixed, including the problem that lemacs occasionally
|
|
3174 grabbed the keyboard focus.
|
|
3175
|
|
3176 Also, as of Lucid Emacs 19.6 and Energize 2.0 (shipping now) it is possible
|
|
3177 to compile the public release of Lucid Emacs with support for Energize; so
|
|
3178 now Energize users will be able to build their own Energize-aware versions
|
|
3179 of lemacs, and will be able to use newer versions of lemacs as they are
|
|
3180 released to the net. (Of course, this is not behavior covered by your
|
|
3181 Energize support contract; you do it at your own risk.)
|
|
3182
|
|
3183 I have not incorporated all portability patches that I have been sent since
|
|
3184 19.4; I will try to get to them soon. However, if you need to make any
|
|
3185 changes to lemacs to get it to compile on your system, it would be quite
|
|
3186 helpful if you would send me context diffs (diff -c) against version 19.6.
|
|
3187
|
|
3188
|
|
3189 ** Major Differences Between 19.3 and 19.4
|
|
3190 ==========================================
|
|
3191
|
|
3192 Prototypes have been added for all functions. Emacs compiles in the strict
|
|
3193 ANSI modes of lcc and gcc, so portability should be vastly improved.
|
|
3194
|
70
|
3195 Many many many many core leaks have been plugged, especially in screen
|
0
|
3196 creation and deletion.
|
|
3197
|
|
3198 The float support reworked to be more portable and ANSI conformant. This
|
70
|
3199 resulted in these new configuration parameters: HAVE_INVERSE_HYPERBOLIC,
|
|
3200 HAVE_CBRT, HAVE_RINT, FLOAT_CHECK_ERRNO, FLOAT_CATCH_SIGILL,
|
0
|
3201 FLOAT_CHECK_DOMAIN. Let us know if you had to change the defaults on your
|
|
3202 architecture.
|
|
3203
|
70
|
3204 The SunOS unexec has been rewritten, and now works with either static or
|
0
|
3205 dynamic libraries, depending on whether -Bstatic or -Bdynamic were specified
|
|
3206 at link-time.
|
|
3207
|
|
3208 Small (character-sized) bitmaps can be mixed in with buffer text via the new
|
|
3209 functions set-extent-begin-glyph and set-extent-end-glyph. (This is actually
|
|
3210 a piece of functionality that Energize has been using for a while, but we've
|
|
3211 just gotten around to making it possible to use it without Energize. See how
|
|
3212 nice we are? Go buy our product.)
|
|
3213
|
|
3214 If compiled with Motif support, one can pop up dialog boxes from emacs lisp.
|
|
3215 We encourage someone to contribute Athena an version of this code; it
|
70
|
3216 shouldn't be much work.
|
0
|
3217
|
|
3218 If dialog boxes are available, then y-or-n-p and yes-or-no-p use dialog boxes
|
70
|
3219 instead of the minibuffer if invoked as a result of a command that was
|
0
|
3220 executed from a menu instead of from the keyboard.
|
|
3221
|
|
3222 Multiple screen support works better; check out doc of get-screen-for-buffer.
|
|
3223
|
|
3224 The default binding of backspace is the same as delete. (C-h is still help.)
|
|
3225
|
70
|
3226 A middle click while the minibuffer is active does completion if you click on
|
0
|
3227 a highlighted completion, otherwise it executes the global binding of button2.
|
|
3228
|
|
3229 New versions of Barry Warsaw's c++-mode and syntax.c. Font-lock-mode works
|
|
3230 with C++ mode now.
|
|
3231
|
|
3232 The semantics of activate-menubar-hook has changed; the functions are called
|
|
3233 with no arguments now.
|
|
3234
|
|
3235 `truename' no longer hacks the automounter; use directory-abbrev-alist instead.
|
|
3236
|
|
3237 Most minibuffer handling has been reimplemented in emacs-lisp.
|
|
3238
|
|
3239 There is now a builtin minibuffer history mechanism which replaces gmhist.
|
|
3240
|
|
3241
|
|
3242 ** Major Differences Between 19.2 and 19.3
|
|
3243 ==========================================
|
|
3244
|
|
3245 The ISO characters have correct case and syntax tables now, so the word-motion
|
|
3246 and case-converting commands work sensibly on them.
|
|
3247
|
|
3248 If you set ctl-arrow to an integer, you can control exactly which characters
|
|
3249 are printable. (There will be a less crufty way to do this eventually.)
|
|
3250
|
|
3251 Menubars can now be buffer local; the function set-screen-menubar no longer
|
70
|
3252 exists. Look at GNUS and VM for examples of how to do this, or read
|
0
|
3253 menubar.el.
|
|
3254
|
|
3255 When emacs is reading from the minibuffer with completions, any completions
|
|
3256 which are visible on the screen will highlight when the mouse moves over them;
|
|
3257 clicking middle on a completion is the same as typing it at the minibuffer.
|
|
3258 Some implications of this: The *Completions* buffer is always mousable. If
|
|
3259 you're using the completion feature of find-tag, your source code will be
|
70
|
3260 mousable when you type M-. Dired buffers will be mousable as soon as you
|
0
|
3261 type ^X^F. And so on.
|
|
3262
|
|
3263 The old isearch code has been replaced with a descendant of Dan LaLiberte's
|
|
3264 excellent isearch-mode; it is more customizable, and generally less bogus.
|
|
3265 You can search for "composed" characters. There are new commands, too; see
|
|
3266 the doc for ^S, or the NEWS file.
|
|
3267
|
|
3268 A patched GNUS 3.14 is included.
|
|
3269
|
|
3270 The user's manual now documents Lucid Emacs 19.3.
|
|
3271
|
|
3272 A few more modes have mouse and menu support.
|
|
3273
|
|
3274 The startup code should be a little more robust, and give you more reasonable
|
|
3275 error messages when things aren't installed quite right (instead of the
|
|
3276 ubiquitous "cannot open DISPLAY"...)
|
|
3277
|
|
3278 Subdirectories of the lisp directory whose names begin with a hyphen or dot
|
|
3279 are not automatically added to the load-path, so you can use this to avoid
|
|
3280 accidentally inflicting experimental software on your users.
|
|
3281
|
|
3282 I've tried to incorporate all of the portability patches that were sent to
|
70
|
3283 me; I tried to solve some of the problems in different ways than the
|
0
|
3284 patches did, so let me know if I missed something.
|
|
3285
|
|
3286 Some systems will need to define NEED_STRDUP, NEED_REALPATH, HAVE_DREM, or
|
|
3287 HAVE_REMAINDER in config.h. Really this should be done in the appropriate
|
|
3288 s- or m- files, but I don't know which systems need these and which don't.
|
|
3289 If yours does, let me know which file it should be in.
|
|
3290
|
|
3291 Check out these new packages:
|
|
3292
|
|
3293 blink-paren.el: causes the matching parenthesis to flash on and off whenever
|
|
3294 the cursor is sitting on a paren-syntax character.
|
|
3295
|
|
3296 pending-del.el: Certain commands implicitly delete the highlighted region:
|
|
3297 Typing a character when there is a highlighted region replaces
|
|
3298 that region with the typed character.
|
|
3299
|
|
3300 font-lock.el: A code-highlighting package, driven off of syntax tables, so
|
70
|
3301 that it understands block comments, strings, etc. The
|
0
|
3302 insertion hook is used to fontify text as you type it in.
|
|
3303
|
|
3304 shell-font.el: Displays your shell-buffer prompt in boldface.
|
124
|
3305
|
|
3306 * The History of XEmacs
|
|
3307 =======================
|
|
3308
|
|
3309 This product is an extension of GNU Emacs, previously known to some as
|
|
3310 "Lucid Emacs" or "ERA". It was initially based on an early version of Emacs
|
|
3311 Version 19 from the Free Software Foundation and has since been kept
|
|
3312 up-to-date with recent versions of that product. It stems from a
|
|
3313 collaboration of Lucid, Inc. with SunSoft DevPro (a division of Sun
|
|
3314 Microsystems, Inc.; formerly called SunPro) and the University of Illinois.
|
|
3315
|
|
3316 NOTE: Lucid, Inc. is currently out of business but development on XEmacs
|
|
3317 continues strong. Recently, Amdahl Corporation and INS Engineering have
|
|
3318 both contributed significantly to the development of XEmacs.
|
|
3319
|
|
3320
|
|
3321 * What's Different?
|
|
3322 ===================
|
|
3323
|
|
3324
|
|
3325 ** Differences between XEmacs and GNU Emacs 19
|
|
3326 ==================================================
|
|
3327 In XEmacs 20, characters are first-class objects. Characters can be
|
|
3328 converted to integers, but are not integers. FSF 19, XEmacs 19, and Mule
|
|
3329 represent them as integers.
|
|
3330
|
|
3331 In XEmacs, events are first-class objects. FSF 19 represents them as
|
|
3332 integers, which obscures the differences between a key gesture and the
|
|
3333 ancient ASCII code used to represent a particular overlapping subset of them.
|
|
3334
|
|
3335 In XEmacs, keymaps are first-class opaque objects. FSF 19 represents them as
|
|
3336 complicated combinations of association lists and vectors. If you use the
|
|
3337 advertised functional interface to manipulation of keymaps, the same code
|
|
3338 will work in XEmacs, Emacs 18, and GNU Emacs 19; if your code depends
|
|
3339 on the underlying implementation of keymaps, it will not.
|
|
3340
|
|
3341 XEmacs uses "extents" to represent all non-textual aspects of buffers;
|
|
3342 FSF 19 uses two distinct objects, "text properties" and "overlays",
|
|
3343 which divide up the functionality between them. Extents are a
|
|
3344 superset of the functionality of the two FSF data types. The full FSF
|
223
|
3345 19 interface to text properties and overlays is supported in XEmacs
|
|
3346 (with extents being the underlying representation).
|
124
|
3347
|
|
3348 Extents can be made to be copied into strings, and thus restored by kill
|
|
3349 and yank. Thus, one can specify this behavior on either "extents" or
|
|
3350 "text properties", whereas in FSF 19 text properties always have this
|
|
3351 behavior and overlays never do.
|
|
3352
|
|
3353 Many more packages are provided standard with XEmacs than with FSF 19.
|
|
3354
|
223
|
3355 Images of arbitrary size can be embedded in a buffer.
|
124
|
3356
|
|
3357 Variable width fonts work.
|
|
3358
|
|
3359 The height of a line is the height of the tallest font on that line, instead
|
|
3360 of all lines having the same height.
|
|
3361
|
|
3362 XEmacs uses the MIT "Xt" toolkit instead of raw Xlib calls, which
|
|
3363 makes it be a more well-behaved X citizen (and also improves
|
|
3364 portability). A result of this is that it is possible to include
|
|
3365 other Xt "Widgets" in the XEmacs window. Also, XEmacs understands the
|
|
3366 standard Xt command-line arguments.
|
|
3367
|
|
3368 XEmacs provides support for ToolTalk on systems that have it.
|
|
3369
|
|
3370 XEmacs can ask questions using popup dialog boxes. Any command executed from
|
|
3371 a menu will ask yes/no questions with dialog boxes, while commands executed
|
|
3372 via the keyboard will use the minibuffer.
|
|
3373
|
|
3374 XEmacs has a built-in toolbar. Four toolbars can actually be configured:
|
|
3375 top, bottom, left, and right toolbars.
|
|
3376
|
|
3377 XEmacs has vertical and horizontal scrollbars. Unlike in FSF 19 (which
|
|
3378 provides a primitive form of vertical scrollbar), these are true toolkit
|
|
3379 scrollbars. A look-alike Motif scrollbar is provided for those who
|
|
3380 don't have Motif. (Even for those who do, the look-alike may be preferable
|
|
3381 as it is faster.)
|
|
3382
|
|
3383 If you're running on a machine with audio hardware, you can specify sound
|
|
3384 files for XEmacs to play instead of the default X beep. See the documentation
|
|
3385 of the function load-sound-file and the variable sound-alist.
|
|
3386
|
|
3387 An XEmacs frame can be placed within an "external client widget" managed by
|
|
3388 another application. This allows an application to use an XEmacs frame as its
|
|
3389 text pane rather than the standard Text widget that is provided with Motif or
|
|
3390 Athena. XEmacs supports Motif applications, generic Xt (e.g. Athena)
|
|
3391 applications, and raw Xlib applications.
|
|
3392
|
|
3393 Here are some more specifics about the XEmacs implementation:
|
|
3394
|
|
3395 *** The Input Model
|
|
3396 -------------------
|
|
3397
|
|
3398 The fundamental unit of input is an "event" instead of a character. An
|
|
3399 event is a new data type that contains several pieces of information.
|
|
3400 There are several kinds of event, and corresponding accessor and utility
|
|
3401 functions. We tried to abstract them so that they would apply equally
|
|
3402 well to a number of window systems.
|
|
3403
|
|
3404 NOTE: All timestamps are measured as milliseconds since Emacs started.
|
|
3405
|
|
3406 key_press_event
|
|
3407 event_channel A token representing which keyboard generated it.
|
|
3408 For this kind of event, this is a console object.
|
|
3409 timestamp When it happened
|
|
3410 key What keysym this is; a character or a symbol.
|
|
3411 If it is a character, it will be a printing
|
|
3412 ASCII character.
|
|
3413 modifiers Bucky-bits on that key: control, meta, etc.
|
|
3414 For most keys, Shift is not a bit; that is implicit
|
|
3415 in the keyboard layout.
|
|
3416
|
|
3417 button_press_event
|
|
3418 button_release_event
|
|
3419 event_channel A token representing which mouse generated it.
|
|
3420 For this kind of event, this is a frame object.
|
|
3421 timestamp When it happened
|
|
3422 button What button went down or up.
|
|
3423 modifiers Bucky-bits on that button: shift, control, meta, etc.
|
|
3424 x, y Where it was at the button-state-change (in pixels).
|
|
3425
|
|
3426 pointer_motion_event
|
|
3427 event_channel A token representing which mouse generated it.
|
|
3428 For this kind of event, this is a frame object.
|
|
3429 timestamp When it happened
|
|
3430 x, y Where it was after it moved (in pixels).
|
|
3431 modifiers Bucky-bits down when the motion was detected.
|
|
3432 (Possibly not all window systems will provide this?)
|
|
3433
|
|
3434 process_event
|
|
3435 timestamp When it happened
|
|
3436 process the emacs "process" object in question
|
|
3437
|
|
3438 timeout_event
|
|
3439 timestamp Now (really, when the timeout was signaled)
|
|
3440 interval_id The ID returned when the associated call to
|
|
3441 add_timeout_cb() was made
|
|
3442 ------ the rest of the fields are filled in by Emacs -----
|
|
3443 id_number The Emacs timeout ID for this timeout (more
|
|
3444 than one timeout event can have the same value
|
|
3445 here, since Emacs timeouts, as opposed to
|
|
3446 add_timeout_cb() timeouts, can resignal
|
|
3447 themselves)
|
|
3448 function An elisp function to call when this timeout is
|
|
3449 processed.
|
|
3450 object The object passed to that function.
|
|
3451
|
|
3452 eval_event
|
|
3453 timestamp When it happened
|
|
3454 function An elisp function to call with this event object.
|
|
3455 object Anything.
|
|
3456 This kind of event is used internally; sometimes the
|
|
3457 window system interface would like to inform emacs of
|
|
3458 some user action (such as focusing on another frame)
|
|
3459 but needs that to happen synchronously with the other
|
|
3460 user input, like keypresses. This is useful when
|
|
3461 events are reported through callbacks rather
|
|
3462 than in the standard event stream.
|
|
3463
|
|
3464 misc_user_event
|
|
3465 timestamp When it happened
|
|
3466 function An elisp function to call with this event object.
|
|
3467 object Anything.
|
|
3468 This is similar to an eval_event, except that it is
|
|
3469 generated by user actions: selections in the
|
|
3470 menubar or scrollbar actions. It is a "command"
|
|
3471 event, like key and mouse presses (and unlike mouse
|
|
3472 motion, process output, and enter and leave window
|
|
3473 hooks). In many ways, eval_events are not the same
|
|
3474 as keypresses or misc_user_events.
|
|
3475
|
|
3476 magic_event
|
|
3477 No user-serviceable parts within. This is for things
|
|
3478 like KeymapNotify and ExposeRegion events and so on
|
|
3479 that emacs itself doesn't care about, but which it
|
|
3480 must do something with for proper interaction with
|
|
3481 the window system.
|
|
3482
|
|
3483 Magic_events are handled somewhat asynchronously, just
|
|
3484 like subprocess filters. However, occasionally a
|
|
3485 magic_event needs to be handled synchronously; in that
|
|
3486 case, the asynchronous handling of the magic_event will
|
|
3487 push an eval_event back onto the queue, which will be
|
|
3488 handled synchronously later. This is one of the
|
|
3489 reasons why eval_events exist; I'm not entirely happy
|
|
3490 with this aspect of this event model.
|
|
3491
|
|
3492
|
|
3493 The function `next-event' blocks and returns one of the above-described
|
|
3494 event objects. The function `dispatch-event' takes an event and processes
|
|
3495 it in the appropriate way.
|
|
3496
|
|
3497 For a process-event, dispatch-event calls the process's handler; for a
|
|
3498 mouse-motion event, the mouse-motion-handler hook is called, and so on.
|
|
3499 For magic-events, dispatch-event does window-system-dependent things,
|
|
3500 including calling some non-window-system-dependent hooks: map-frame-hook,
|
|
3501 unmap-frame-hook, mouse-enter-frame-hook, and mouse-leave-frame-hook.
|
|
3502
|
|
3503 The function `next-command-event' calls `next-event' until it gets a key or
|
|
3504 button from the user (that is, not a process, motion, timeout, or magic
|
|
3505 event). If it gets an event that is not a key or button, it calls
|
|
3506 `dispatch-event' on it immediately and reads another one. The
|
|
3507 next-command-event function could be implemented in Emacs Lisp, though it
|
|
3508 isn't. Generally one should call `next-command-event' instead of
|
|
3509 `next-event'.
|
|
3510
|
|
3511 read-char calls next-command-event; if it doesn't get an event that can be
|
|
3512 converted to an ASCII character, it signals an error. Otherwise it returns
|
|
3513 an integer.
|
|
3514
|
|
3515 The variable `last-command-char' always contains an integer, or nil (if the
|
|
3516 last read event has no ASCII equivalent, as when it is a mouse-click or a
|
|
3517 non-ASCII character chord.)
|
|
3518
|
|
3519 The new variable `last-command-event' holds an event object, that could be
|
|
3520 a non-ASCII character, a button click, a menu selection, etc.
|
|
3521
|
|
3522 The variable `unread-command-char' no longer exists, and has been replaced
|
|
3523 by `unread-command-events'. With the new event model, it is incorrect for
|
|
3524 code to do (setq unread-command-char (read-char)), because all user-input
|
|
3525 can't be represented as ASCII characters. *** This is an incompatible
|
|
3526 change. Code which sets `unread-command-char' must be updated to use the
|
|
3527 combination of `next-command-event' and `unread-command-events' instead.
|
|
3528
|
|
3529 The functions `this-command-keys' and `recent-keys' return a vector of
|
|
3530 event objects, instead of a string of ASCII characters. *** This also
|
|
3531 is an incompatible change.
|
|
3532
|
|
3533 Almost nothing happens at interrupt level; the SIGIO handler simply sets a
|
|
3534 flag, and later, the X event queue is scanned for KeyPress events which map
|
|
3535 to ^G. All redisplay happens in the main thread of the process.
|
|
3536
|
|
3537
|
|
3538 *** Keymaps
|
|
3539 -----------
|
|
3540
|
|
3541 Instead of keymaps being alists or obarrays, they are a new primary data
|
|
3542 type. The only user access to the contents of a keymap is through the
|
|
3543 existing keymap-manipulation functions, and a new function, map-keymap.
|
|
3544 This means that existing code that manipulates keymaps may need to
|
|
3545 be changed.
|
|
3546
|
|
3547 One of our goals with the new input and keymap code was to make more
|
|
3548 character combinations available for binding, besides just ASCII and
|
|
3549 function keys. We want to be able bind different commands to Control-a
|
|
3550 and Control-Shift-a; we also want it to be possible for the keys Control-h
|
|
3551 and Backspace (and Control-M and Return, and Control-I and Tab, etc) to
|
|
3552 be distinct.
|
|
3553
|
|
3554 One of the most common complaints that new Emacs users have is that backspace
|
|
3555 is help. The answer is to play around with the keyboard-translate-table, or
|
|
3556 be lucky enough to have a system administrator who has done this for you
|
|
3557 already; but if it were possible to bind backspace and C-h to different
|
|
3558 things, then (under a window manager at least) both backspace and delete
|
|
3559 would delete a character, and ^H would be help. There's no need to deal
|
|
3560 with xmodmap, kbd-translate-table, etc.
|
|
3561
|
|
3562 Here are some more examples: suppose you want to bind one function to Tab,
|
|
3563 and another to Control-Tab. This can't be done if Tab and Control-I are the
|
|
3564 same thing. What about control keys that have no ASCII equivalent, like
|
|
3565 Control-< ? One might want that to be bound to set-mark-at-point-min. We
|
|
3566 want M-C-Backspace to be kill-backward-sexp. But we want M-Backspace to be
|
|
3567 kill-backward-word. Again, this can't be done if Backspace and C-h are
|
|
3568 indistinguishable.
|
|
3569
|
|
3570 The user represents keys as a string of ASCII characters (when possible and
|
|
3571 convenient), or as a vector of event objects, or as a vector of "key
|
|
3572 description lists", that looks like (control a), or (control meta delete)
|
|
3573 or (shift f1). The order of the modifier-names is not significant, so
|
|
3574 (meta control x) and (control meta x) are the same.
|
|
3575
|
|
3576 `define-key' knows how to take any of the above representations and store them
|
|
3577 into a keymap. When Emacs wants to return a key sequence (this-command-keys,
|
|
3578 recent-keys, keyboard-macros, and read-key-sequence, for example) it returns
|
|
3579 a vector of event objects. Keyboard macros can also be represented as ASCII
|
|
3580 strings or as vectors of key description lists.
|
|
3581
|
|
3582 This is an incompatible change: code which calls `this-command-keys',
|
|
3583 `recent-keys', `read-key-sequence', or manipulates keyboard-macros probably
|
|
3584 needs to be changed so that it no longer assumes that the returned value is a
|
|
3585 string.
|
|
3586
|
|
3587 Control-Shift-a is specified as (control A), not (control shift a), since A
|
|
3588 is a two-case character. But for keys that don't have an upper case
|
|
3589 version, like F1, Backspace, and Escape, you use the (shift backspace) syntax.
|
|
3590
|
|
3591 See the doc string for our version of define-key, reproduced below in the
|
|
3592 `Changed Functions' section. Note that when the KEYS argument is a string,
|
|
3593 it has the same semantics as the v18 define-key.
|
|
3594
|
|
3595
|
|
3596 *** Xt Integration
|
|
3597 ------------------
|
|
3598
|
|
3599 The heart of the event loop is implemented in terms of the Xt event functions
|
|
3600 (specifically XtAppProcessEvent), and uses Xt's concept of timeouts and
|
|
3601 file-descriptor callbacks, eliminating a large amount of system-dependent code
|
|
3602 (Xt does it for you.)
|
|
3603
|
|
3604 If Emacs is compiled with support for X, it uses the Xt event loop even when
|
|
3605 Emacs is not running on an X display (the Xt event loop supports this). This
|
|
3606 makes it possible to run Emacs on a dumb TTY, and later connect it to one or
|
|
3607 more X servers. It should also be possible to later connect an existing Emacs
|
|
3608 process to additional TTY's, although this code is still experimental. (Our
|
|
3609 intent at this point is not to have an Emacs that is being used by multiple
|
|
3610 people at the same time: it is to make it possible for someone to go home, log
|
|
3611 in on a dialup line, and connect to the same Emacs process that is running
|
|
3612 under X in their office without having to recreate their buffer state and so
|
|
3613 on.)
|
|
3614
|
|
3615 If Emacs is not compiled with support for X, then it instead uses more general
|
|
3616 code, something like what v18 does; but this way of doing things is a lot more
|
|
3617 modular.
|
|
3618
|
|
3619 (Linking Emacs with Xt seems to only add about 300k to the executable size,
|
|
3620 compared with an Emacs linked with Xlib only.)
|
|
3621
|
|
3622
|
|
3623 *** Region Highlighting
|
|
3624 -----------------------
|
|
3625
|
|
3626 If the variable `zmacs-regions' is true, then the region between point and
|
|
3627 mark will be highlighted when "active". Those commands which push a mark
|
|
3628 (such as C-SPC, and C-x C-x) make the region become "active" and thus
|
|
3629 highlighted. Most commands (all non-motion commands, basically) cause it to
|
|
3630 become non-highlighted (non-"active"). Commands that operate on the region
|
|
3631 (such as C-w, C-x C-l, etc.) only work if the region is in the highlighted
|
|
3632 state.
|
|
3633
|
|
3634 zmacs-activate-region-hook and zmacs-deactivate-region-hook are run at the
|
|
3635 appropriate times; under X, zmacs-activate-region-hook makes the X selection
|
|
3636 be the region between point and mark, thus doing two things at once: making
|
|
3637 the region and the X selection be the same; and making the region highlight
|
|
3638 in the same way as the X selection.
|
|
3639
|
|
3640 If `zmacs-regions' is true, then the `mark-marker' command returns nil unless
|
|
3641 the region is currently in the active (highlighted) state. With an argument
|
|
3642 of t, this returns the mark (if there is one) regardless of the active-region
|
|
3643 state. You should *generally* not use the mark unless the region is active,
|
|
3644 if the user has expressed a preference for the active-region model. Watch
|
|
3645 out! Moving this marker changes the mark position. If you set the marker not
|
|
3646 to point anywhere, the buffer will have no mark.
|
|
3647
|
|
3648 In this way, the primary selection is a fairly transitory entity; but
|
|
3649 when something is copied to the kill ring, it is made the Clipboard
|
|
3650 selection. It is also stored into CUT_BUFFER0, for compatibility with
|
|
3651 X applications that don't understand selections (like Emacs18).
|
|
3652
|
|
3653 Compatibility note: if you have code which uses (mark) or (mark-marker),
|
|
3654 then you need to either: change those calls to (mark t) or (mark-marker t);
|
|
3655 or simply bind `zmacs-regions' to nil around the call to mark or mark-marker.
|
|
3656 This is probably the best solution, since it will work in Emacs 18 as well.
|
|
3657
|
|
3658
|
|
3659 *** Menubars and Dialog Boxes
|
|
3660 -----------------------------
|
|
3661
|
|
3662 Here is an example of a menubar definition:
|
|
3663
|
|
3664 (defvar default-menubar
|
|
3665 '(("File" ["Open File..." find-file t]
|
|
3666 ["Save Buffer" save-buffer t]
|
|
3667 ["Save Buffer As..." write-file t]
|
|
3668 ["Revert Buffer" revert-buffer t]
|
|
3669 "-----"
|
|
3670 ["Print Buffer" lpr-buffer t]
|
|
3671 "-----"
|
|
3672 ["Delete Frame" delete-frame t]
|
|
3673 ["Kill Buffer..." kill-buffer t]
|
|
3674 ["Exit Emacs" save-buffers-kill-emacs t]
|
|
3675 )
|
|
3676 ("Edit" ["Undo" advertised-undo t]
|
|
3677 ["Cut" kill-primary-selection t]
|
|
3678 ["Copy" copy-primary-selection t]
|
|
3679 ["Paste" yank-clipboard-selection t]
|
|
3680 ["Clear" delete-primary-selection t]
|
|
3681 )
|
|
3682 ...))
|
|
3683
|
|
3684 The first element of each menu item is the string to print on the menu.
|
|
3685
|
|
3686 The second element is the callback function; if it is a symbol, it is
|
|
3687 invoked with `call-interactively.' If it is a list, it is invoked with
|
|
3688 `eval'.
|
|
3689
|
|
3690 If the second element is a symbol, then the menu also displays the key that
|
|
3691 is bound to that command (if any).
|
|
3692
|
|
3693 The third element of the menu items determines whether the item is selectable.
|
|
3694 It may be t, nil, or a form to evaluate. Also, a hook is run just before a
|
|
3695 menu is exposed, which can be used to change the value of these slots.
|
|
3696 For example, there is a hook that makes the "undo" menu item be selectable
|
|
3697 only in the cases when `advertised-undo' would not signal an error.
|
|
3698
|
|
3699 Menus may have other menus nested within them; they will cascade.
|
|
3700
|
|
3701 There are utility functions for adding items to menus, deleting items,
|
|
3702 disabling them, etc.
|
|
3703
|
|
3704 The function `popup-menu' takes a menu description and pops it up.
|
|
3705
|
|
3706 The function `popup-dialog-box' takes a dialog-box description and pops
|
|
3707 it up. Dialog box descriptions look a lot like menu descriptions.
|
|
3708
|
|
3709 The menubar, menu, and dialog-box code is implemented as a library,
|
|
3710 with an interface which hides the toolkit that implements it.
|
|
3711
|
|
3712
|
|
3713 *** Isearch Changes
|
|
3714 -------------------
|
|
3715
|
|
3716 Isearch has been reimplemented in a different way, adding some new features,
|
|
3717 and causing a few incompatible changes.
|
|
3718
|
|
3719 - the old isearch-*-char variables are no longer supported. In the old
|
|
3720 system, one could make ^A mean "repeat the search" by doing something
|
|
3721 like (setq search-repeat-char ?C-a). In the new system, this is
|
|
3722 accomplished with
|
|
3723
|
|
3724 (define-key isearch-mode-map "\C-a" 'isearch-repeat-forward)
|
|
3725
|
|
3726 - The advantage of using the normal keymap mechanism for this is that you
|
|
3727 can bind more than one key to an isearch command: for example, both C-a
|
|
3728 and C-s could do the same thing inside isearch mode. You can also bind
|
|
3729 multi-key sequences inside of isearch mode, and bind non-ASCII keys.
|
|
3730 For example, to use the F1 key to terminate a search:
|
|
3731
|
|
3732 (define-key isearch-mode-map 'f1 'isearch-exit)
|
|
3733
|
|
3734 or to make ``C-c C-c'' terminate a search:
|
|
3735
|
|
3736 (define-key isearch-mode-map "\C-c\C-c" 'isearch-exit)
|
|
3737
|
|
3738 - If isearch is behaving case-insensitively (the default) and you type an
|
|
3739 upper case character, then the search will become case-sensitive. This
|
|
3740 can be disabled by setting `search-caps-disable-folding' to nil.
|
|
3741
|
|
3742 - There is a history ring of the strings previously searched for; typing
|
|
3743 M-p or M-n while searching will cycle through this ring. Typing M-TAB
|
|
3744 will do completion across the set of items in the history ring.
|
|
3745
|
|
3746 - The ESC key is no longer used to terminate an incremental search. The
|
|
3747 RET key should be used instead. This change is necessary for it to be
|
|
3748 possible to bind "meta" characters to isearch commands.
|
|
3749
|
|
3750
|
|
3751 *** Startup Code Changes
|
|
3752 ------------------------
|
|
3753
|
|
3754 The initial X frame is mapped before the user's .emacs file is executed.
|
|
3755 Without this, there is no way for the user to see any error messages
|
|
3756 generated by their .emacs file, any windows created by the .emacs file
|
|
3757 don't show up, and the copyleft notice isn't shown.
|
|
3758
|
|
3759 The default values for load-path, exec-path, lock-directory, and
|
|
3760 Info-directory-list are not (necessarily) built into Emacs, but are
|
|
3761 computed at startup time.
|
|
3762
|
|
3763 First, Emacs looks at the directory in which its executable file resides:
|
|
3764
|
|
3765 o If that directory contains subdirectories named "lisp" and "lib-src",
|
|
3766 then those directories are used as the lisp library and exec directory.
|
|
3767
|
|
3768 o If the parent of the directory in which the emacs executable is located
|
|
3769 contains "lisp" and "lib-src" subdirectories, then those are used.
|
|
3770
|
|
3771 o If ../lib/xemacs-<version> (starting from the directory in which the
|
|
3772 emacs executable is located) contains a "lisp" subdirectory and either
|
|
3773 a "lib-src" subdirectory or a <configuration-name> subdirectory, then
|
|
3774 those are used.
|
|
3775
|
|
3776 o If the emacs executable that was run is a symbolic link, then the link
|
|
3777 is chased, and the resultant directory is checked as above.
|
|
3778
|
|
3779 (Actually, it doesn't just look for "lisp/", it looks for "lisp/prim/",
|
|
3780 which reduces the chances of a false positive.)
|
|
3781
|
|
3782 If the lisp directory contains subdirectories, they are added to the default
|
|
3783 load-path as well. If the site-lisp directory exists and contains
|
|
3784 subdirectories, they are then added. Subdirectories whose names begin with
|
|
3785 a dot or a hyphen are not added to the load-path.
|
|
3786
|
|
3787 These heuristics fail if the Emacs binary was copied from the main Emacs
|
|
3788 tree to some other directory, and links for the lisp directory were not put
|
|
3789 in. This isn't much of a restriction: either make there be subdirectories
|
|
3790 (or symbolic links) of the directory of the emacs executable, or make the
|
|
3791 "installed" emacs executable be a symbolic link to an executable in a more
|
|
3792 appropriate directory structure. For example, this setup works:
|
|
3793
|
|
3794 /usr/local/xemacs/xemacs* ; The executable.
|
|
3795 /usr/local/xemacs/lisp/ ; The associated directories.
|
|
3796 /usr/local/xemacs/etc/ ; Any of the files in this list
|
|
3797 /usr/local/xemacs/lock/ ; could be symbolic links as well.
|
|
3798 /usr/local/xemacs/info/
|
|
3799
|
|
3800 As does this:
|
|
3801
|
|
3802 /usr/local/bin/xemacs -> ../xemacs/src/xemacs-19.14 ; A link...
|
|
3803 /usr/local/xemacs/src/xemacs-19.14* ; The executable,
|
|
3804 /usr/local/xemacs/lisp/ ; and the rest of
|
|
3805 /usr/local/xemacs/etc/ ; the source tree
|
|
3806 /usr/local/xemacs/lock/
|
|
3807 /usr/local/xemacs/info/
|
|
3808
|
|
3809 This configuration might be used for a multi-architecture installation; assume
|
|
3810 that $LOCAL refers to a directory which contains only files specific to a
|
|
3811 particular architecture (i.e., executables) and $SHARED refers to those files
|
|
3812 which are not machine specific (i.e., lisp code and documentation.)
|
|
3813
|
|
3814 $LOCAL/bin/xemacs@ -> $LOCAL/xemacs-19.14/xemacs*
|
|
3815 $LOCAL/xemacs-19.14/lisp@ -> $SHARED/xemacs-19.14/lisp/
|
|
3816 $LOCAL/xemacs-19.14/etc@ -> $SHARED/xemacs-19.14/etc/
|
|
3817 $LOCAL/xemacs-19.14/info@ -> $SHARED/xemacs-19.14/info/
|
|
3818
|
|
3819 The following would also work, but the above is probably more attractive:
|
|
3820
|
|
3821 $LOCAL/bin/xemacs*
|
|
3822 $LOCAL/bin/lisp@ -> $SHARED/xemacs-19.14/lisp/
|
|
3823 $LOCAL/bin/etc@ -> $SHARED/xemacs-19.14/etc/
|
|
3824 $LOCAL/bin/info@ -> $SHARED/xemacs-19.14/info/
|
|
3825
|
|
3826 If Emacs can't find the requisite directories, it writes a message like this
|
|
3827 (or some appropriate subset of it) to stderr:
|
|
3828
|
|
3829 WARNING:
|
|
3830 couldn't find an obvious default for load-path, exec-directory, and
|
|
3831 lock-directory, and there were no defaults specified in paths.h when
|
|
3832 Emacs was built. Perhaps some directories don't exist, or the Emacs
|
|
3833 executable, /cadillac-th/jwz/somewhere/xemacs is in a strange place?
|
|
3834
|
|
3835 Without both exec-directory and load-path, Emacs will be very broken.
|
|
3836 Consider making a symbolic link from /cadillac-th/jwz/somewhere/etc
|
|
3837 to wherever the appropriate Emacs etc/ directory is, and from
|
|
3838 /cadillac-th/jwz/somewhere/lisp/ to wherever the appropriate Emacs
|
|
3839 lisp library is.
|
|
3840
|
|
3841 Without lock-directory set, file locking won't work. Consider
|
|
3842 creating /cadillac-th/jwz/somewhere/lock as a directory or symbolic
|
|
3843 link for use as the lock directory.
|
|
3844
|
|
3845 The default installation tree is the following:
|
|
3846
|
|
3847 /usr/local/bin/b2m ;
|
|
3848 ctags ; executables that
|
|
3849 emacsclient ; should be in
|
|
3850 etags ; user's path
|
|
3851 xemacs -> xemacs-<version> ;
|
|
3852 xemacs ;
|
|
3853 /usr/local/lib/xemacs/site-lisp
|
|
3854 /usr/local/lib/xemacs/lock
|
|
3855 /usr/local/lib/xemacs-<version>/etc ; architecture ind. files
|
|
3856 /usr/local/lib/xemacs-<version>/info
|
|
3857 /usr/local/lib/xemacs-<version>/lisp
|
|
3858 /usr/local/lib/xemacs-<version>/<configuration> ; binaries emacs may run
|
|
3859
|
|
3860
|
|
3861 *** X Resources
|
|
3862 ---------------
|
|
3863
|
|
3864 (Note: This section is copied verbatim from the XEmacs Reference Manual.)
|
|
3865
|
|
3866 The Emacs resources are generally set per-frame. Each Emacs frame
|
|
3867 can have its own name or the same name as another, depending on the
|
|
3868 name passed to the `make-frame' function.
|
|
3869
|
|
3870 You can specify resources for all frames with the syntax:
|
|
3871
|
|
3872 Emacs*parameter: value
|
|
3873
|
|
3874 or
|
|
3875
|
|
3876 Emacs*EmacsFrame.parameter:value
|
|
3877
|
|
3878 You can specify resources for a particular frame with the syntax:
|
|
3879
|
|
3880 Emacs*FRAME-NAME.parameter: value
|
|
3881
|
|
3882
|
|
3883 **** Geometry Resources
|
|
3884 -----------------------
|
|
3885
|
|
3886 To make the default size of all Emacs frames be 80 columns by 55
|
|
3887 lines, do this:
|
|
3888
|
|
3889 Emacs*EmacsFrame.geometry: 80x55
|
|
3890
|
|
3891 To set the geometry of a particular frame named `fred', do this:
|
|
3892
|
|
3893 Emacs*fred.geometry: 80x55
|
|
3894
|
|
3895 Important! Do not use the following syntax:
|
|
3896
|
|
3897 Emacs*geometry: 80x55
|
|
3898
|
|
3899 You should never use `*geometry' with any X application. It does not
|
|
3900 say "make the geometry of Emacs be 80 columns by 55 lines." It really
|
|
3901 says, "make Emacs and all subwindows thereof be 80x55 in whatever units
|
|
3902 they care to measure in." In particular, that is both telling the
|
|
3903 Emacs text pane to be 80x55 in characters, and telling the menubar pane
|
|
3904 to be 80x55 pixels, which is surely not what you want.
|
|
3905
|
|
3906 As a special case, this geometry specification also works (and sets
|
|
3907 the default size of all Emacs frames to 80 columns by 55 lines):
|
|
3908
|
|
3909 Emacs.geometry: 80x55
|
|
3910
|
|
3911 since that is the syntax used with most other applications (since most
|
|
3912 other applications have only one top-level window, unlike Emacs). In
|
|
3913 general, however, the top-level shell (the unmapped ApplicationShell
|
|
3914 widget named `Emacs' that is the parent of the shell widgets that
|
|
3915 actually manage the individual frames) does not have any interesting
|
|
3916 resources on it, and you should set the resources on the frames instead.
|
|
3917
|
|
3918 The `-geometry' command-line argument sets only the geometry of the
|
|
3919 initial frame created by Emacs.
|
|
3920
|
|
3921 A more complete explanation of geometry-handling is
|
|
3922
|
|
3923 * The `-geometry' command-line option sets the `Emacs.geometry'
|
|
3924 resource, that is, the geometry of the ApplicationShell.
|
|
3925
|
|
3926 * For the first frame created, the size of the frame is taken from
|
|
3927 the ApplicationShell if it is specified, otherwise from the
|
|
3928 geometry of the frame.
|
|
3929
|
|
3930 * For subsequent frames, the order is reversed: First the frame, and
|
|
3931 then the ApplicationShell.
|
|
3932
|
|
3933 * For the first frame created, the position of the frame is taken
|
|
3934 from the ApplicationShell (`Emacs.geometry') if it is specified,
|
|
3935 otherwise from the geometry of the frame.
|
|
3936
|
|
3937 * For subsequent frames, the position is taken only from the frame,
|
|
3938 and never from the ApplicationShell.
|
|
3939
|
|
3940 This is rather complicated, but it does seem to provide the most
|
|
3941 intuitive behavior with respect to the default sizes and positions of
|
|
3942 frames created in various ways.
|
|
3943
|
|
3944
|
|
3945 **** Iconic Resources
|
|
3946 ---------------------
|
|
3947
|
|
3948 Analogous to `-geometry', the `-iconic' command-line option sets the
|
|
3949 iconic flag of the ApplicationShell (`Emacs.iconic') and always applies
|
|
3950 to the first frame created regardless of its name. However, it is
|
|
3951 possible to set the iconic flag on particular frames (by name) by using
|
|
3952 the `Emacs*FRAME-NAME.iconic' resource.
|
|
3953
|
|
3954
|
|
3955 **** Resource List
|
|
3956 ------------------
|
|
3957
|
|
3958 Emacs frames accept the following resources:
|
|
3959
|
|
3960 `geometry' (class `Geometry'): string
|
|
3961 Initial geometry for the frame. *Note Geometry Resources:: for a
|
|
3962 complete discussion of how this works.
|
|
3963
|
|
3964 `iconic' (class `Iconic'): boolean
|
|
3965 Whether this frame should appear in the iconified state.
|
|
3966
|
|
3967 `internalBorderWidth' (class `InternalBorderWidth'): int
|
|
3968 How many blank pixels to leave between the text and the edge of the
|
|
3969 window.
|
|
3970
|
|
3971 `interline' (class `Interline'): int
|
|
3972 How many pixels to leave between each line (may not be
|
|
3973 implemented).
|
|
3974
|
|
3975 `menubar' (class `Menubar'): boolean
|
|
3976 Whether newly-created frames should initially have a menubar. Set
|
|
3977 to true by default.
|
|
3978
|
|
3979 `initiallyUnmapped' (class `InitiallyUnmapped'): boolean
|
|
3980 Whether XEmacs should leave the initial frame unmapped when it
|
|
3981 starts up. This is useful if you are starting XEmacs as a server
|
|
3982 (e.g. in conjunction with gnuserv or the external client widget).
|
|
3983 You can also control this with the `-unmapped' command-line option.
|
|
3984
|
|
3985 `barCursor' (class `BarColor'): boolean
|
|
3986 Whether the cursor should be displayed as a bar, or the
|
|
3987 traditional box.
|
|
3988
|
|
3989 `textPointer' (class `Cursor'): cursor-name
|
|
3990 The cursor to use when the mouse is over text. This resource is
|
|
3991 used to initialize the variable `x-pointer-shape'.
|
|
3992
|
|
3993 `selectionPointer' (class `Cursor'): cursor-name
|
|
3994 The cursor to use when the mouse is over a selectable text region
|
|
3995 (an extent with the `highlight' property; for example, an Info
|
|
3996 cross-reference). This resource is used to initialize the variable
|
|
3997 `x-selection-pointer-shape'.
|
|
3998
|
|
3999 `spacePointer' (class `Cursor'): cursor-name
|
|
4000 The cursor to use when the mouse is over a blank space in a buffer
|
|
4001 (that is, after the end of a line or after the end-of-file). This
|
|
4002 resource is used to initialize the variable
|
|
4003 `x-nontext-pointer-shape'.
|
|
4004
|
|
4005 `modeLinePointer' (class `Cursor'): cursor-name
|
|
4006 The cursor to use when the mouse is over a mode line. This
|
|
4007 resource is used to initialize the variable `x-mode-pointer-shape'.
|
|
4008
|
|
4009 `gcPointer' (class `Cursor'): cursor-name
|
|
4010 The cursor to display when a garbage-collection is in progress.
|
|
4011 This resource is used to initialize the variable
|
|
4012 `x-gc-pointer-shape'.
|
|
4013
|
|
4014 `scrollbarPointer' (class `Cursor'): cursor-name
|
|
4015 The cursor to use when the mouse is over the scrollbar. This
|
|
4016 resource is used to initialize the variable
|
|
4017 `x-scrollbar-pointer-shape'.
|
|
4018
|
|
4019 `pointerColor' (class `Foreground'): color-name
|
|
4020 `pointerBackground' (class `Background'): color-name
|
|
4021 The foreground and background colors of the mouse cursor. These
|
|
4022 resources are used to initialize the variables
|
|
4023 `x-pointer-foreground-color' and `x-pointer-background-color'.
|
|
4024
|
|
4025 `scrollBarWidth' (class `ScrollBarWidth'): integer
|
|
4026 How wide the vertical scrollbars should be, in pixels; 0 means no
|
|
4027 vertical scrollbars. You can also use a resource specification of
|
|
4028 the form `*scrollbar.width', or the usual toolkit scrollbar
|
|
4029 resources: `*XmScrollBar.width' (Motif), `*XlwScrollBar.width'
|
|
4030 (Lucid), or `*Scrollbar.thickness' (Athena). We don't recommend
|
|
4031 that you use the toolkit resources, though, because they're
|
|
4032 dependent on how exactly your particular build of XEmacs was
|
|
4033 configured.
|
|
4034
|
|
4035 `scrollBarHeight' (class `ScrollBarHeight'): integer
|
|
4036 How high the horizontal scrollbars should be, in pixels; 0 means no
|
|
4037 horizontal scrollbars. You can also use a resource specification
|
|
4038 of the form `*scrollbar.height', or the usual toolkit scrollbar
|
|
4039 resources: `*XmScrollBar.height' (Motif), `*XlwScrollBar.height'
|
|
4040 (Lucid), or `*Scrollbar.thickness' (Athena). We don't recommend
|
|
4041 that you use the toolkit resources, though, because they're
|
|
4042 dependent on how exactly your particular build of XEmacs was
|
|
4043 configured.
|
|
4044
|
|
4045 `scrollBarPlacement' (class `ScrollBarPlacement'): string
|
|
4046 Where the horizontal and vertical scrollbars should be positioned.
|
|
4047 This should be one of the four strings `bottom-left',
|
|
4048 `bottom-right', `top-left', and `top-right'. Default is
|
|
4049 `bottom-right' for the Motif and Lucid scrollbars and
|
|
4050 `bottom-left' for the Athena scrollbars.
|
|
4051
|
|
4052 `topToolBarHeight' (class `TopToolBarHeight'): integer
|
|
4053 `bottomToolBarHeight' (class `BottomToolBarHeight'): integer
|
|
4054 `leftToolBarWidth' (class `LeftToolBarWidth'): integer
|
|
4055 `rightToolBarWidth' (class `RightToolBarWidth'): integer
|
|
4056 Height and width of the four possible toolbars.
|
|
4057
|
|
4058 `topToolBarShadowColor' (class `TopToolBarShadowColor'): color-name
|
|
4059 `bottomToolBarShadowColor' (class `BottomToolBarShadowColor'): color-name
|
|
4060 Color of the top and bottom shadows for the toolbars. NOTE: These
|
|
4061 resources do *not* have anything to do with the top and bottom
|
|
4062 toolbars (i.e. the toolbars at the top and bottom of the frame)!
|
|
4063 Rather, they affect the top and bottom shadows around the edges of
|
|
4064 all four kinds of toolbars.
|
|
4065
|
|
4066 `topToolBarShadowPixmap' (class `TopToolBarShadowPixmap'): pixmap-name
|
|
4067 `bottomToolBarShadowPixmap' (class `BottomToolBarShadowPixmap'): pixmap-name
|
|
4068 Pixmap of the top and bottom shadows for the toolbars. If set,
|
|
4069 these resources override the corresponding color resources. NOTE:
|
|
4070 These resources do *not* have anything to do with the top and
|
|
4071 bottom toolbars (i.e. the toolbars at the top and bottom of the
|
|
4072 frame)! Rather, they affect the top and bottom shadows around the
|
|
4073 edges of all four kinds of toolbars.
|
|
4074
|
|
4075 `toolBarShadowThickness' (class `ToolBarShadowThickness'): integer
|
|
4076 Thickness of the shadows around the toolbars, in pixels.
|
|
4077
|
|
4078 `visualBell' (class `VisualBell'): boolean
|
|
4079 Whether XEmacs should flash the screen rather than making an
|
|
4080 audible beep.
|
|
4081
|
|
4082 `bellVolume' (class `BellVolume'): integer
|
|
4083 Volume of the audible beep.
|
|
4084
|
|
4085 `useBackingStore' (class `UseBackingStore'): boolean
|
|
4086 Whether XEmacs should set the backing-store attribute of the X
|
|
4087 windows it creates. This increases the memory usage of the X
|
|
4088 server but decreases the amount of X traffic necessary to update
|
|
4089 the screen, and is useful when the connection to the X server goes
|
|
4090 over a low-bandwidth line such as a modem connection.
|
|
4091
|
|
4092
|
|
4093 **** Face Resources
|
|
4094 -------------------
|
|
4095
|
|
4096 The attributes of faces are also per-frame. They can be specified as:
|
|
4097
|
|
4098 Emacs.FACE_NAME.parameter: value
|
|
4099
|
|
4100 (*do not* use `Emacs*FACE_NAME...')
|
|
4101
|
|
4102 or
|
|
4103
|
|
4104 Emacs*FRAME_NAME.FACE_NAME.parameter: value
|
|
4105
|
|
4106 Faces accept the following resources:
|
|
4107
|
|
4108 `attributeFont' (class `AttributeFont'): font-name
|
|
4109 The font of this face.
|
|
4110
|
|
4111 `attributeForeground' (class `AttributeForeground'): color-name
|
|
4112 `attributeBackground' (class `AttributeBackground'): color-name
|
|
4113 The foreground and background colors of this face.
|
|
4114
|
|
4115 `attributeBackgroundPixmap' (class `AttributeBackgroundPixmap'): file-name
|
|
4116 The name of an XBM file (or XPM file, if your version of Emacs
|
|
4117 supports XPM), to use as a background stipple.
|
|
4118
|
|
4119 `attributeUnderline' (class `AttributeUnderline'): boolean
|
|
4120 Whether text in this face should be underlined.
|
|
4121
|
|
4122 All text is displayed in some face, defaulting to the face named
|
|
4123 `default'. To set the font of normal text, use
|
|
4124 `Emacs*default.attributeFont'. To set it in the frame named `fred', use
|
|
4125 `Emacs*fred.default.attributeFont'.
|
|
4126
|
|
4127 These are the names of the predefined faces:
|
|
4128
|
|
4129 `default'
|
|
4130 Everything inherits from this.
|
|
4131
|
|
4132 `bold'
|
|
4133 If this is not specified in the resource database, Emacs tries to
|
|
4134 find a bold version of the font of the default face.
|
|
4135
|
|
4136 `italic'
|
|
4137 If this is not specified in the resource database, Emacs tries to
|
|
4138 find an italic version of the font of the default face.
|
|
4139
|
|
4140 `bold-italic'
|
|
4141 If this is not specified in the resource database, Emacs tries to
|
|
4142 find a bold-italic version of the font of the default face.
|
|
4143
|
|
4144 `modeline'
|
|
4145 This is the face that the modeline is displayed in. If not
|
|
4146 specified in the resource database, it is determined from the
|
|
4147 default face by reversing the foreground and background colors.
|
|
4148
|
|
4149 `highlight'
|
|
4150 This is the face that highlighted extents (for example, Info
|
|
4151 cross-references and possible completions, when the mouse passes
|
|
4152 over them) are displayed in.
|
|
4153
|
|
4154 `left-margin'
|
|
4155 `right-margin'
|
|
4156 These are the faces that the left and right annotation margins are
|
|
4157 displayed in.
|
|
4158
|
|
4159 `zmacs-region'
|
|
4160 This is the face that mouse selections are displayed in.
|
|
4161
|
|
4162 `text-cursor'
|
|
4163 This is the face that the cursor is displayed in.
|
|
4164
|
|
4165 `isearch'
|
|
4166 This is the face that the matched text being searched for is
|
|
4167 displayed in.
|
|
4168
|
|
4169 `info-node'
|
|
4170 This is the face of info menu items. If unspecified, it is copied
|
|
4171 from `bold-italic'.
|
|
4172
|
|
4173 `info-xref'
|
|
4174 This is the face of info cross-references. If unspecified, it is
|
|
4175 copied from `bold'. (Note that, when the mouse passes over a
|
|
4176 cross-reference, the cross-reference's face is determined from a
|
|
4177 combination of the `info-xref' and `highlight' faces.)
|
|
4178
|
|
4179 Other packages might define their own faces; to see a list of all
|
|
4180 faces, use any of the interactive face-manipulation commands such as
|
|
4181 `set-face-font' and type `?' when you are prompted for the name of a
|
|
4182 face.
|
|
4183
|
|
4184 If the `bold', `italic', and `bold-italic' faces are not specified
|
|
4185 in the resource database, then XEmacs attempts to derive them from the
|
|
4186 font of the default face. It can only succeed at this if you have
|
|
4187 specified the default font using the XLFD (X Logical Font Description)
|
|
4188 format, which looks like
|
|
4189
|
|
4190 *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
|
|
4191
|
|
4192 If you use any of the other, less strict font name formats, some of
|
|
4193 which look like
|
|
4194
|
|
4195 lucidasanstypewriter-12
|
|
4196 fixed
|
|
4197 9x13
|
|
4198
|
|
4199 then XEmacs won't be able to guess the names of the bold and italic
|
|
4200 versions. All X fonts can be referred to via XLFD-style names, so you
|
|
4201 should use those forms. See the man pages for `X(1)', `xlsfonts(1)',
|
|
4202 and `xfontsel(1)'.
|
|
4203
|
|
4204
|
|
4205 **** Widgets
|
|
4206 ------------
|
|
4207
|
|
4208 There are several structural widgets between the terminal EmacsFrame
|
|
4209 widget and the top level ApplicationShell; the exact names and types of
|
|
4210 these widgets change from release to release (for example, they changed
|
|
4211 in 19.9, 19.10, 19.12, and 19.13) and are subject to further change in
|
|
4212 the future, so you should avoid mentioning them in your resource database.
|
|
4213 The above-mentioned syntaxes should be forward-compatible. As of 19.14,
|
|
4214 the exact widget hierarchy is as follows:
|
|
4215
|
|
4216 INVOCATION-NAME "shell" "container" FRAME-NAME
|
|
4217 x-emacs-application-class "TopLevelEmacsShell" "EmacsManager" "EmacsFrame"
|
|
4218
|
|
4219 (for normal frames)
|
|
4220
|
|
4221 or
|
|
4222
|
|
4223 INVOCATION-NAME "shell" "container" FRAME-NAME
|
|
4224 x-emacs-application-class "TransientEmacsShell" "EmacsManager" "EmacsFrame"
|
|
4225
|
|
4226 (for popup/dialog-box frames)
|
|
4227
|
|
4228 where INVOCATION-NAME is the terminal component of the name of the
|
|
4229 XEmacs executable (usually `xemacs'), and `x-emacs-application-class'
|
|
4230 is generally `Emacs'.
|
|
4231
|
|
4232
|
|
4233 **** Menubar Resources
|
|
4234 ----------------------
|
|
4235
|
|
4236 As the menubar is implemented as a widget which is not a part of
|
|
4237 XEmacs proper, it does not use the face mechanism for specifying fonts
|
|
4238 and colors: It uses whatever resources are appropriate to the type of
|
|
4239 widget which is used to implement it.
|
|
4240
|
|
4241 If Emacs was compiled to use only the Motif-lookalike menu widgets,
|
|
4242 then one way to specify the font of the menubar would be
|
|
4243
|
|
4244 Emacs*menubar*font: *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
|
|
4245
|
|
4246 If the Motif library is being used, then one would have to use
|
|
4247
|
|
4248 Emacs*menubar*fontList: *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
|
|
4249
|
|
4250 because the Motif library uses the `fontList' resource name instead
|
|
4251 of `font', which has subtly different semantics.
|
|
4252
|
|
4253 The same is true of the scrollbars: They accept whichever resources
|
|
4254 are appropriate for the toolkit in use.
|
|
4255
|
|
4256
|
|
4257 *** Source Code Highlighting
|
|
4258 ----------------------------
|
|
4259
|
|
4260 It's possible to have your buffers "decorated" with fonts or colors
|
|
4261 indicating syntactic structures (such as strings, comments, function names,
|
|
4262 "reserved words", etc.). In XEmacs, the preferred way to do this is with
|
|
4263 font-lock-mode; activate it by adding the following code to your .emacs file:
|
|
4264
|
|
4265 (add-hook 'emacs-lisp-mode-hook 'turn-on-font-lock)
|
|
4266 (add-hook 'c-mode-hook 'turn-on-font-lock)
|
|
4267 (add-hook 'c++-mode-hook 'turn-on-font-lock)
|
|
4268 (add-hook 'dired-mode-hook 'turn-on-font-lock)
|
|
4269 ...etc...
|
|
4270
|
|
4271 To customize it, see the descriptions of the function `font-lock-mode' and
|
|
4272 the variables `font-lock-keywords', `c-font-lock-keywords', etc.
|
|
4273
|
|
4274 There exist several other source code highlighting packages, but font-lock
|
|
4275 does one thing that most others don't do: highlights as you type new text;
|
|
4276 and one thing that no others do: bases part of its decoration on the
|
|
4277 syntax table of the major mode. Font-lock has C-level support to do this
|
|
4278 efficiently, so it should also be significantly faster than the others.
|
|
4279
|
|
4280 If there's something that another highlighting package does that you can't
|
|
4281 make font-lock do, let us know. We would prefer to consolidate all of the
|
|
4282 desired functionality into one package rather than ship several different
|
|
4283 packages which do essentially the same thing in different ways.
|
|
4284
|
|
4285
|
|
4286 ** Differences Between XEmacs and Emacs 18
|
|
4287 ==========================================
|
|
4288
|
|
4289 Auto-configure support has been added, so it should be fairly easy to compile
|
|
4290 XEmacs on different systems. If you have any problems or feedback about
|
|
4291 compiling on your system, please let us know.
|
|
4292
|
|
4293 We have reimplemented the basic input model in a more general way; instead of
|
|
4294 X input being a special-case of the normal ASCII input stream, XEmacs has a
|
|
4295 concept of "input events", and ASCII characters are a subset of that. The
|
|
4296 events that XEmacs knows about are not X events, but are a generalization of
|
|
4297 them, so that XEmacs can eventually be ported to different window systems.
|
|
4298
|
|
4299 We have reimplemented keymaps so that sequences of events can be stored into
|
|
4300 them instead of just ASCII codes; it is possible to, for example, bind
|
|
4301 different commands to each of the chords Control-h, Control-H, Backspace,
|
|
4302 Control-Backspace, and Super-Shift-Backspace. Key bindings, function key
|
|
4303 bindings, and mouse bindings live in the same keymaps.
|
|
4304
|
|
4305 Input and display of all ISO-8859-1 characters is supported.
|
|
4306
|
|
4307 You can have multiple X windows ("frames" in XEmacs terminology).
|
|
4308
|
|
4309 XEmacs has objects called "extents" and "faces", which are roughly
|
|
4310 analogous to Epoch's "buttons," "zones," and "styles." An extent is a
|
|
4311 region of text (a start position and an end position) and a face is a
|
|
4312 collection of textual attributes like fonts and colors. Every extent
|
|
4313 is displayed in some "face", so changing the properties of a face
|
|
4314 immediately updates the display of all associated extents. Faces can
|
|
4315 be frame-local: you can have a region of text which displays with
|
|
4316 completely different attributes when its buffer is viewed from a
|
|
4317 different X window.
|
|
4318
|
|
4319 The display attributes of faces may be specified either in lisp or through
|
|
4320 the X resource manager.
|
|
4321
|
|
4322 Pixmaps of arbitrary size can be embedded in a buffer.
|
|
4323
|
|
4324 Variable width fonts work.
|
|
4325
|
|
4326 The height of a line is the height of the tallest font on that line, instead
|
|
4327 of all lines having the same height.
|
|
4328
|
|
4329 XEmacs uses the MIT "Xt" toolkit instead of raw Xlib calls, which
|
|
4330 makes it be a more well-behaved X citizen (and also improves
|
|
4331 portability). A result of this is that it is possible to include
|
|
4332 other Xt "Widgets" in the XEmacs window. Also, XEmacs understands the
|
|
4333 standard Xt command-line arguments.
|
|
4334
|
|
4335 XEmacs understands the X11 "Selection" mechanism; it's possible to define
|
|
4336 and customize selection converter functions and new selection types from
|
|
4337 Emacs Lisp, without having to recompile XEmacs.
|
|
4338
|
|
4339 XEmacs provides support for ToolTalk on systems that have it.
|
|
4340
|
|
4341 XEmacs supports the Zmacs/Lispm style of region highlighting, where the
|
|
4342 region between the point and mark is highlighted when in its "active" state.
|
|
4343
|
|
4344 XEmacs has a menubar, whose contents are customizable from emacs-lisp.
|
|
4345 This menubar looks Motif-ish, but does not require Motif. If you already
|
|
4346 own Motif, however, you can configure XEmacs to use a *real* Motif menubar
|
|
4347 instead.
|
|
4348
|
|
4349 XEmacs can ask questions using popup dialog boxes. Any command executed from
|
|
4350 a menu will ask yes/no questions with dialog boxes, while commands executed
|
|
4351 via the keyboard will use the minibuffer.
|
|
4352
|
|
4353 XEmacs has vertical and horizontal scrollbars.
|
|
4354
|
|
4355 The initial load-path is computed at run-time, instead of at compile-time.
|
|
4356 This means that if you move the XEmacs executable and associated directories
|
|
4357 to somewhere else, you don't have to recompile anything.
|
|
4358
|
|
4359 You can specify what the title of the XEmacs windows and icons should be
|
|
4360 with the variables `frame-title-format' and `frame-icon-title-format',
|
|
4361 which have the same syntax as `mode-line-format'.
|
|
4362
|
|
4363 XEmacs now supports floating-point numbers.
|
|
4364
|
|
4365 XEmacs now knows about timers directly, instead of them being simulated by
|
|
4366 a subprocess.
|
|
4367
|
|
4368 XEmacs understands truenames, and can be configured to notice when you are
|
|
4369 visiting two names of the same file. See the variables find-file-use-truenames
|
|
4370 and find-file-compare-truenames.
|
|
4371
|
|
4372 If you're running on a machine with audio hardware, you can specify sound
|
|
4373 files for XEmacs to play instead of the default X beep. See the documentation
|
|
4374 of the function load-sound-file and the variable sound-alist.
|
|
4375
|
|
4376 An XEmacs frame can be placed within an "external client widget" managed by
|
|
4377 another application. This allows an application to use an XEmacs frame as its
|
|
4378 text pane rather than the standard Text widget that is provided with Motif or
|
|
4379 Athena. XEmacs supports Motif applications, generic Xt (e.g. Athena)
|
|
4380 applications, and raw Xlib applications.
|
|
4381
|
|
4382 Random changes to the emacs-lisp library: (some of this was not written by
|
|
4383 us, but is included because it's free software and we think it's good stuff)
|
|
4384
|
|
4385 - there is a new optimizing byte-compiler
|
|
4386 - there is a new abbrev-based mail-alias mechanism
|
|
4387 - the -*- line can contain local-variable settings
|
|
4388 - there is a new TAGS package
|
|
4389 - there is a new VI-emulation mode (viper)
|
|
4390 - there is a new implementation of Dired
|
|
4391 - there is a new implementation of Isearch
|
|
4392 - the VM package for reading mail is provided
|
|
4393 - the W3 package for browsing the World Wide Web hypertext information
|
|
4394 system is provided
|
|
4395 - the Hyperbole package, a programmable information management and
|
|
4396 hypertext system
|
|
4397 - the OO-Browser package, a multi-language object-oriented browser
|
|
4398
|
|
4399 There are many more specifics in the "Miscellaneous Changes" section, below.
|
|
4400
|
|
4401 The online Emacs Manual and Emacs-Lisp Manual are now both relatively
|
|
4402 up-to-date.
|