Add some representative nodes.
[chise/xemacs-chise.git-] / etc / NEWS
1 -*- mode:outline -*-
2 \f
3 * Introduction
4 ==============
5
6 This file presents the changes in recent XEmacs versions.  It
7 primarily documents user-visible (interface) changes, but also
8 includes internal changes of possible interest to the users.  When
9 describing new features, we try to also document ways of reverting to
10 the old behavior, where applicable.  If you dislike a recent change in
11 how XEmacs behaves, this file might contain a remedy.
12
13 Use `C-c C-f' to move to the next equal level of outline, and
14 `C-c C-b' to move to previous equal level.  `C-h m' will give more
15 info about the Outline mode.  Many commands are also available through
16 the menubar.
17
18 Users who would like to know which capabilities have been introduced
19 in each release should look at the appropriate section of this file.
20 Starting with version 20.0, XEmacs includes ChangeLogs, which can be
21 consulted for a more detailed list of changes.
22
23     N.B.  The term "GNU Emacs" refers to any release of Emacs Version
24     19 from the Free Software Foundation's GNU Project.  (We do not
25     say just "Emacs" as Richard M. Stallman ["RMS"] prefers, because
26     it is clearly a more generic term.)  The term "XEmacs" refers to
27     this program or sometimes to its predecessors "Era" and "Lucid
28     Emacs".  The predecessor of all these program is called "Emacs
29     18".  When no particular version is implied, "Emacs" will be used.
30
31 \f
32 * Changes in XEmacs 21.4
33 ========================
34
35 ** Summary of user-visible changes:
36   -- Motif is now deprecated on linux and cygwin.
37   -- On UNIX and linux, '--with-widgets=no' is now the default.  If
38      you want buffer tabs or the progress bar, you must run configure
39      with the option '--with-widgets=lucid' or a different toolkit.
40   -- PUI related changes (Package User Interface)
41     - A minor rearrangement of the "Tools -> Packages" menu.
42     - Only a single package download site can be selected.
43     - Managing packages via the `customize' interface is no longer
44       supported. 
45     - Non-Mule XEmacsen can not install Mule packages.
46     - The "mule-base" package is not needed to "bootstrap" PUI for
47       Mule enabled XEmacsen.
48     - The default for PGP verifying the package-index file is "off" in
49       21.4.
50     - The default package-index filename has changed to
51       `package-index.LATEST.gpg'.
52     - The location of the local index file is customisable.  See
53       `package-get-package-index-file-location'. 
54     - `pui-add-install-directory' has been obsoleted and replaced by
55       `pui-set-local-package-get-directory'.  
56   -- The delete key now deletes forward by default.
57   -- Shifted motion keys now select text by default.
58   -- You can now build XEmacs with support for GTK+ widget set.
59   -- ~/.xemacs/init.el is now the preferred location for the init file.
60     - XEmacs now supports a `~/.xemacs/init.el' startup file.
61     - Custom file will move to ~/.xemacs/custom.el.
62   -- Much-improved sample init.el, showing how to use many useful features.
63   -- XEmacs support for menu accelerators has been much improved.
64   -- Default menubar improvements.
65     - Default menubar has many new commands and better organization.
66     - The font-menu is now available under MS Windows.
67   -- Dialog box improvements, including a real file dialog box.
68     - XEmacs now has a proper file dialog box under MS Windows (and GTK)!
69     - The old clunky file dialog box is improved.
70     - Keyboard traversal now works correctly in MS Windows dialog boxes.
71     - There is a Search dialog box available from Edit->Find...
72   -- New buffer tabs.
73   -- There is a new MS Windows installer, netinstall, ported from Cygwin.
74   -- The subprocess quote-handling mechanism under Windows is much improved.
75   -- Printing support now available under MS Windows.
76   -- Selection improvements.
77     - Kill and yank now interact with the clipboard under Windows.
78     - MS Windows support for selection is now much more robust.
79     - Motif selection support is now more correct (but slower).
80   -- Mail spool locking now works correctly.
81   -- International support changes.
82     - The default coding-priority-list is now safer.
83     - International keysyms are now supported under X.
84     - MS Windows 1251 code page now supported.
85     - Czech, Thai, Cyrillic-KOI8, Vietnamese, Ethiopic now supported.
86     - Proper support for words in Latin 3 and Latin 4.
87   -- Help buffers contain hyperlinks, and other changes.
88   -- The modeline's text is now scrollable.
89   -- The mouse wheel under MS Windows now functions correctly.
90   -- Interactive searching and matching case improvements.
91     - Incremental search will now highlight all visible matches.
92     - Interactive searches always respect uppercase characters.
93   -- Rectangle functions rewritten to avoid inserting extra spaces.
94   -- New command `kill-entire-line' that always kills the entire line.
95   -- Default values correctly stored in minibuffer histories.
96   -- You can now create "indirect buffers", like in GNU Emacs.
97   -- Pixel-based scrolling has been implemented.
98   -- Operation progress can be displayed using graphical widgets.
99   -- User names following a tilde can now be completed at file name prompts.
100   -- XEmacs can now play sound using Enlightenment Sound Daemon (ESD).
101   -- X-Face support is now available under MS Windows.
102   -- The PostgreSQL Relational Database Management System is now supported.
103   -- Indentation no longer indents comments that begin at column zero.
104   -- Face and variable settings can have comments in Customize.
105   -- New locations for early package hierarchies.
106   -- The `auto-save' library has been greatly improved.
107   -- New variable `mswindows-alt-by-itself-activates-menu'.
108   -- Other init-file-related changes.
109     - Init file in your home directory may be called `.emacs.el'.
110     - New command-line switches -user-init-file and -user-init-directory.
111   -- Etags changes.
112     - In DOS, etags looks for file.cgz if it cannot find file.c.
113     - New option --ignore-case-regex is an alternative to --regex.
114     - New option --declarations, for C-type languages.
115     - In C++, tags are created for "operator".
116     - Ada now supported.
117     - In Fortran, procedure is no longer tagged.
118     - In Java, tags are created for "interface".
119     - In Lisp, def-type constructs are now tagged.
120     - In Perl, the --globals option tags global variables.
121     - Python now supported.
122     - New file extensions recognized: .ss, .pdb, .psw.
123   -- Fixed ldap libraries configuration.
124   -- Fixed `LDAP_OPT_ON' libraries configuration.
125
126 ** The delete key now deletes forward by default.
127
128 This is regulated by the variable `delete-key-deletes-forward', which
129 now defaults to t.  `delete-key-deletes-forward' takes effect only on
130 the systems that offer both a backspace and a delete key.  If set to
131 nil, the key labeled "Delete" will always delete backward.  If set to
132 non-nil, the "Delete" key will delete forward, except on keyboards
133 where a "Backspace" key is not provided (e.g. old DEC keyboards).
134
135 Unless our implementation has bugs, the only reason why you would want
136 to set `delete-key-deletes-forward' to nil is if you want to use the
137 Delete key to delete backwards, despite the presence (according to
138 Xlib) of a BackSpace key on the keyboard.
139
140 ** Shifted motion keys now select text by default.
141
142 You can turn this off by setting `shifted-motion-keys-select-region'
143 to nil.  This works based off of particular keys, not particular
144 commands: Thus, the arrow keys will normally trigger selection when
145 the Shift key is held down regardless of their bindings, and non-arrow
146 keys with the same bindings (e.g. C-f) will not work this way.  You
147 can control which keys trigger shifted motion using
148 `motion-keys-for-shifted-motion'.  See also
149 `unshifted-motion-keys-deselect-region'.
150
151 ** You can now build XEmacs with support for GTK+ widget set.
152
153 XEmacs built that way uses GTK+ to draw menubars, scrollbars, and
154 other GUI components, as well GDK for drawing text, choosing fonts,
155 allocating colors, etc.  Additionally, GTK-XEmacs supports Lisp
156 functions for writing your own GTK programs in Emacs Lisp!
157
158 To use this, build XEmacs with the `--with-gtk' configure flag.  (Of
159 course, you'll need to have the GTK+ libraries and header files on the
160 system.)  Gnome widgets and functionality are supported where
161 available, and can be turned off.
162
163 ** ~/.xemacs/init.el is now the preferred location for the init file.
164
165 *** XEmacs now supports a `~/.xemacs/init.el' startup file.
166 If it exists, XEmacs will prefer it over `.emacs' and `.emacs.el'.
167 The file may be byte-compiled as `~/.xemacs/init.elc'.
168
169 If present, the `~/.xemacs/' directory may contain startup files for
170 XEmacs packages that support it.
171
172 The first time you start up XEmacs, it will ask you if you would like
173 to migrate your `.emacs' to the new location. (Your custom settings
174 will also be moved, to `~/.xemacs/custom.el' -- see below.) If so, you
175 will also be asked whether you would like to create a compatibility
176 `.emacs' for backward compatibility with previous versions of XEmacs
177 and with GNU Emacs. (This compatibility `.emacs' simply loads the new
178 init and custom files.) Doing this is generally a good idea -- new
179 versions of XEmacs will prefer `~/.xemacs/init.el' over `~/.emacs' in
180 any case.
181
182 You can manually migrate at any time with `migrate-user-init-file',
183 and undo any migration with `unmigrate-user-init-file'.  The function
184 `create-compatibility-dot-emacs' also lets you manually create a
185 compatibility `.emacs'.
186
187 NOTE: Under MS Windows, your home directory (i.e. the directory named
188 `~') is specified by the HOME environment variable, and defaults to
189 C:\.  To set this variable, modify AUTOEXEC.BAT under Windows 95/98,
190 or select Control Panel->System->Advanced->Environment Variables...
191 under Windows NT/2000.
192
193 *** Custom file will move to ~/.xemacs/custom.el.
194
195 Whereas customize settings were formerly stored in the regular init
196 file, XEmacs now prefers them to be in a separate file
197 `~/.xemacs/custom.el', completely under automatic control.  This
198 change goes with the migration of the init file, and XEmacs offers
199 automatic migration upon startup.
200
201 ** Much-improved sample init.el, showing how to use many useful features.
202
203 The sample init file, located in the `etc/' directory of the XEmacs
204 installation, has been renamed from `sample.emacs' to `sample.init.el',
205 and pretty much rewritten from scratch. (You can view it by selecting
206 the menu item Help->Samples->Sample init.el.)  Many of the most-useful
207 optional features in XEmacs have been enabled, and other features that
208 are useful but may be annoying to some are present but commented out.
209 There is also extensive documentation on how to add your own
210 improvements to the init file and where to find more documentation
211 elsewhere in XEmacs.  The file has been specifically designed so that
212 most people can simply make it their own init file by copying it to
213 ~/.xemacs/init.el, and they will be satisfied with the results.
214
215 ** XEmacs support for menu accelerators has been much improved.
216
217 It now works properly under MS Windows, for example.  To enable
218 accelerators, set `menu-accelerator-enabled' to `menu-force'.  Menus
219 now have accelerators by default, currently on the first letter of the
220 menu item unless another letter was indicated as the accelerator using
221 %_ in the menu string.  These %_ specifications are automatically
222 removed when displaying the menu item, and are handled correctly in
223 functions such as `normalize-menu-item-name'.  Some auto-generated
224 menus will have accelerators added dynamically, using numbers 1-9 and
225 letters; to add this feature yourself, use the Lisp command
226 `submenu-generate-accelerator-spec' in a menu filter.  The feature
227 `menu-accelerator-support' has been added so that packages can check
228 whether this support exists.
229
230 ** Default menubar improvements.
231
232 *** Default menubar has many new commands and better organization.
233
234 The default menubar has been extensively reorganized.  Many more
235 commands are available, and they are more logically organized.  The
236 Options menu, in particular, has been significantly expanded, and almost
237 everything on the new Cmds menu is new. (Much of the useful
238 functionality from the `big-menubar' package has been imported.)
239
240 *** The font-menu is now available under MS Windows.
241
242 ** Dialog box improvements, including a real file dialog box.
243
244 *** XEmacs now has a proper file dialog box under MS Windows (and GTK)!
245 This will appear whenever you select a menu item that requires a file
246 as an argument.
247
248 *** The old clunky file dialog box is improved.
249 The in-buffer file dialog box (visible on non-MS-Windows, non-GTK
250 systems) is still clunky but has had many improvements to make it work
251 significantly better.
252
253 *** Keyboard traversal now works correctly in MS Windows dialog boxes.
254
255 *** There is a Search dialog box available from Edit->Find...
256 However, it's very experimental and needs a lot of work.
257
258 ** New buffer tabs.
259
260 You can now use buffer tabs to switch between buffers.
261
262 The tabs are located between the toolbar and the uppermost window, in
263 a location called the "gutter".  If you dislike the buffer tabs, you can
264 disable them using the menu item `Options->Display->Buffers Tab Visible'
265 by customizing `gutter-buffers-tab-visible-p', or by placing this in
266 your .xemacs/init.el:
267
268    (custom-set-variables '(gutter-buffers-tab-visible-p nil))
269
270 You can change the location of the gutter using the menu item
271 `Options->Display->Default Gutter Location' or with (e.g.)
272
273    (custom-set-variables '(default-gutter-position 'left))
274
275 However, currently only MS Windows supports tab widgets with
276 orientations other than vertical, and it doesn't currently support
277 gutters on the bottom of the frame.
278
279 ** There is a new MS Windows installer, netinstall, ported from Cygwin.
280
281 Nearly complete automation of the XEmacs install process from
282 ftp.xemacs.org.  Includes selection of Lisp packages to install, etc.
283
284 ** The subprocess quote-handling mechanism under Windows is much improved.
285
286 Specifically, the quote-handling mechanism has been completely rewritten,
287 and you should now be able to use single or double quotes to quote arguments
288 just like under Unix, and expect to get correct results regardless of the
289 shell you are using (e.g. CMD.EXE, bash from Cygwin, etc.).  For example,
290 the following command:
291
292 M-x grep '<<<<<<<' *.c
293
294 should work as intended.
295
296 ** Printing support now available under MS Windows.
297
298 The File->Print... menu item pretty-prints using the standard MS
299 Windows printing facilities.  Unfortunately it's still rather
300 experimental.  There is a separate `msprinter' device tag for MS
301 Windows printers, and so you can control the way that faces appear on
302 the printer by using this tag to specify device-specific face
303 settings.
304
305 ** Selection improvements.
306
307 *** Kill and yank now interact with the clipboard under Windows.
308
309 This was done by changing the default value of `interprogram-cut-function'
310 and `interprogram-paste-function'.  You can get the old behavior by
311 setting these to nil, and there is an option on the options menu to do
312 this.
313
314 *** MS Windows support for selection is now much more robust.
315
316 Generally selection should now do what you would expect under
317 MS Windows: the middle mouse button will paste your current selection
318 or the clipboard; conversions from different types of selection to the
319 clipboard can be made; the kill-ring and friends will be updated as
320 per X.
321
322 The only thing selection doesn't do is set the clipboard automatically
323 as this would break the MS Windows model.  If you want this behavior
324 then set `selection-sets-clipboard' to t.
325
326 *** Motif selection support is now more correct (but slower).
327
328 Changes have been made to allow correct operation of cut/copy/paste
329 operations between native widgets and XEmacs buffers.  However, this
330 can lead to a lot of X traffic which slows down the performance of
331 `C-k'. If you want the old behaviour then set
332 `x-selection-strict-motif-ownership' to nil.
333
334 ** Mail spool locking now works correctly.
335
336 XEmacs has always come with a little auxiliary program, movemail,
337 which moves mail out of the system's spool area into user storage.  To
338 coordinate between XEmacs, the mail delivery agent, and other mail
339 user agents, movemail needs to properly lock the spool file before
340 moving it.  Movemail now correctly respects the --mail-locking option
341 to configure.  Moreover, movemail's locking behavior can be specified
342 at run-time, via a new command-line option -m to movemail, or through
343 the environment variable EMACSLOCKMETHOD.
344
345 When installing XEmacs, make sure you configure it according to your
346 environment's mail spool locking conventions.  When you're using a
347 binary kit, set the `mail-lock-method' variable at startup, or the
348 EMACSLOCKMETHOD environment variable.
349
350 ** International support changes.
351
352 *** The default coding-priority-list is now safer.
353
354 This means that if you have no language environment set, Mule no
355 longer automatically recognizes ISO 2022 escapes in your files.  This
356 makes editing binary files safe.
357
358 *** International keysyms are now supported under X.
359
360 This means that XEmacs running under Mule will automatically recognize
361 the keysym `scaron' to be the lower-case `s' with caron in the Latin 2
362 character set.  (Specifically, it will bind the keysym to
363 `self-insert' and augment its `ascii-character' property.)  This is
364 very useful with XFree under European locales as shipped by recent
365 Linux distributions.  If XEmacs is compiled without Mule support, the
366 feature still works, but it is unaware of different character sets --
367 it unconditionally sets the `ascii-character' property to values in
368 the [160, 256) range.
369
370 *** MS Windows 1251 code page now supported.
371
372 It's available as coding system `windows-1251'.
373
374 *** Czech, Thai, Cyrillic-KOI8, Vietnamese, Ethiopic now supported.
375
376 *** Proper support for words in Latin 3 and Latin 4.
377
378 The appropriate characters in Latin 3 and Latin 4 character sets are
379 correctly defined as words.
380
381 ** Help buffers contain hyperlinks, and other changes.
382
383 The help buffers created by C-h commands now contain hyperlinks to
384 other commands, functions and variables mentioned in the documentation.
385 Use button2 to follow a link.  Use button3 to bring up a context menu
386 that lets you follow the link, find the source for the item, do a tag
387 search, etc.  The buffers are also syntax-highlighted.
388
389 Help functions (e.g. `C-h f') now know how to print macro argument
390 lists.  If your macro definition included an argument list for the sake
391 of help output, you no longer need to do that.
392
393 ** The modeline's text is now scrollable.
394
395 This is controlled by the variable `modeline-scrolling-method', which
396 you need to set to a non-nil value.  You can also choose scrolling
397 types; see the docstring of `modeline-scrolling-method' for more
398 information.
399
400 ** The mouse wheel under MS Windows now functions correctly.
401
402 It scrolls the XEmacs window under the pointer, not the selected
403 window.
404
405 ** Interactive searching and matching case improvements.
406
407 *** Incremental search will now highlight all visible matches.
408
409 This makes it easier to anticipate where consecutive C-s or C-r will
410 place the point.  If you want to disable the feature, set
411 `isearch-highlight-all-matches' to nil.
412
413 *** Interactive searches always respect uppercase characters.
414
415 Case sensitiveness in searching operations is normally controlled
416 by the variable `case-fold-search' (if non-nil, case is ignored while
417 searching).  This mechanism has now been slightly improved for
418 interactive searches: if the search string (or regexp) contains
419 uppercase characters, the searching is forced to be case-sensitive,
420 `case-fold-search'.
421
422 The new behavior affects all functions performing interactive
423 searches, like `zap-to-char', `list-matching-lines', `tags-search'
424 etc.  The incremental search facility has always behaved that way.
425
426 ** Rectangle functions rewritten to avoid inserting extra spaces.
427
428 The rectangle functions have been almost completely rewritten in
429 order to avoid inserting undesirable spaces, notably at the end of
430 lines.  Two typical examples of the old behavior were
431 `string-rectangle', which filled all lines up to the right side of the
432 rectangle, and `clear-rectangle', which filled even empty lines up to
433 the left side.  All functions have been rewritten to avoid inserting
434 unwanted spaces, and an optional prefix now allows them to behave the
435 old way.
436
437 Also, the behavior of `string-rectangle' is now compliant with
438 `pending-delete-mode': if this mode is active, then the string
439 replaces the region rectangle.  Otherwise, the command does not delete
440 or overwrite any existing text.  For those who want that feature but do
441 not use pending-delete-mode, a new function, `replace-rectangle', is
442 available.
443
444 As a side effect, the FORCE argument to `move-to-column' now
445 understands the special value `coerce', which means that the line
446 should not be filled if it is too short to reach the desired column.
447
448 ** New command `kill-entire-line' that always kills the entire line.
449
450 This kills the entire line at point, regardless of whether the point
451 is at the beginning of line, and regardless of the setting of
452 `kill-whole-line'.
453
454 ** Default values correctly stored in minibuffer histories.
455
456 When you press RET at a minibuffer prompt that provides a default
457 value, the value is stored in history instead of an empty line.  Also,
458 you can now edit the default value by pressing the down arrow,
459 accessing the logical "future" value.  Not all minibuffer prompts have
460 yet been converted to support this feature.
461
462 ** You can now create "indirect buffers", like in GNU Emacs.
463
464 An indirect buffer shares its text with another buffer ("base
465 buffer"), but has its own major mode, local variables, extents, and
466 narrowing.  An indirect buffer has a name of its own, distinct from
467 those of the base buffer and all other buffers.  An indirect buffer
468 cannot itself be visiting a file (though its base buffer can be).
469 The base buffer cannot itself be indirect.
470
471 Use (make-indirect-buffer BASE-BUFFER NAME) to make an indirect buffer
472 named NAME whose base is BASE-BUFFER.  If BASE-BUFFER is itself an
473 indirect buffer, its base buffer is used as the base for the new
474 buffer.
475
476 You can make an indirect buffer current, or switch to it in a window,
477 just as you would a non-indirect buffer.
478
479 The function `buffer-base-buffer' returns a buffer's base buffer or
480 nil, if given an ordinary (non-indirect) buffer.  The function
481 `buffer-indirect-children' returns a list of the indirect children of
482 a base buffer.
483
484 ** Pixel-based scrolling has been implemented.
485 By default this will attempt to scroll in increments equal to the
486 height of the default face.  Set `window-pixel-scroll-increment' to
487 modify this behavior.
488
489 ** Operation progress can be displayed using graphical widgets.
490 See `progress-feedback' for details.  This support has been switched
491 on by default for font-lock and some web browsing functions.  If you
492 do not like this behavior, set `progress-feedback-use-echo-area' to
493 nil.
494
495 ** User names following a tilde can now be completed at file name prompts.
496 e.g. `C-x C-f ~hni<TAB>' will complete to `~hniksic/'.  To make this
497 operation faster, a cache of user names is maintained internally.
498
499 The new primitives available for this purpose are functions named
500 `user-name-completion' and `user-name-all-completions'.
501
502 ** XEmacs can now play sound using Enlightenment Sound Daemon (ESD).
503 It will try NAS first, then ESD, then playing native sound directly.
504
505 ** X-Face support is now available under MS Windows.
506 If an X-Face library built under MS Windows is available then XEmacs
507 will use this at build time.
508
509 ** The PostgreSQL Relational Database Management System is now supported.
510 It is now possible to build XEmacs so that the programming interface
511 to the PostgreSQL RDBMS (libpq) is available in XEmacs Lisp.
512 Supported versions of PostgreSQL are 6.5.3 (earlier versions may work,
513 but have not been tested) and 7.0-beta1.
514
515 ** Indentation no longer indents comments that begin at column zero.
516 This makes it easy to deal with commented out regions of code.
517
518 ** Face and variable settings can have comments in Customize.
519 Customize now supports adding comments about your face and variable
520 settings using a new menu entry.  Comments for variables can also be
521 assigned by calling `customize-set-(value|variable)' with a prefix
522 argument.
523
524 ** New locations for early package hierarchies.
525 XEmacs now locates the early package hierarchies at
526 ~/.xemacs/mule-packages/ and ~/.xemacs/xemacs-packages/.  Previously,
527 the early packages were located in ~/.xemacs/.
528
529 ** The `auto-save' library has been greatly improved.
530 (This lets you group all your auto-save files into one directory, and
531 is provided standardly with XEmacs.  See `etc/sample.init.el',
532 available on the Help menu, for more info on how to set it up.)
533 Specifically, it now works under MS Windows, and it uses a completely
534 reversible encoding (basically quoted-printable), so that all
535 filenames (as well as non-filename buffers) are successfully handled
536 regardless of any special characters in their names.
537
538 ** New variable `mswindows-alt-by-itself-activates-menu'.
539 If you set this variable to nil then pressing and releasing the Alt
540 key under MS Windows will no longer activate the menubar.  The default
541 is t.  This is not to be confused with `menu-accelerator-enabled',
542 which enables the use of Alt+<Letter> accelerators to invoke the
543 menus.
544
545 ** Other init-file-related changes.
546
547 *** Init file in your home directory may be called `.emacs.el'.
548
549 Like in GNU Emacs 20.4 and on, you can now name the XEmacs init file
550 located in your home directory `.emacs.el'.  Formerly the name had to
551 be `.emacs'.  If you use the name `.emacs.el', you can byte-compile
552 the file in the usual way.
553
554 If both `.emacs' and `.emacs.el' exist, the latter file is the one
555 that is used.
556
557 *** New command-line switches -user-init-file and -user-init-directory.
558
559 These can be used to specify alternate locations for what is normally
560 ~/.emacs and ~/.xemacs.
561
562 Moreover, the `-user <user>' command-line option (which used to only
563 work in unpredictable ways) is now equivalent to `-user-init-file
564 ~<user>/.xemacs/init.el -user-init-directory ~<user>/.xemacs', or
565 `-user-init-file ~<user>/.emacs -user-init-directory ~<user>/.xemacs',
566 whichever init file comes first.
567
568 ** Etags changes.
569
570 *** In DOS, etags looks for file.cgz if it cannot find file.c.
571
572 *** New option --ignore-case-regex is an alternative to --regex.
573 It is now possible to bind a regexp to a language, by prepending the
574 regexp with {lang}, where lang is one of the languages that `etags
575 --help' prints out.  This feature is useful especially for regex
576 files, where each line contains a regular expression.  The manual
577 contains details.
578
579 *** New option --declarations, for C-type languages.
580 In C and derived languages, etags creates tags for function
581 declarations when given the --declarations option.
582
583 *** In C++, tags are created for "operator".
584 The tags have the form "operator+", without spaces between the
585 keyword and the operator.
586
587 *** Ada now supported.
588 Tags are functions, procedures, packages, tasks, and types.
589
590 *** In Fortran, procedure is no longer tagged.
591
592 *** In Java, tags are created for "interface".
593
594 *** In Lisp, def-type constructs are now tagged.
595 This includes "(defstruct (foo", "(defun (operator" and similar constructs.
596
597 *** In Perl, the --globals option tags global variables.
598 my and local variables are tagged.
599
600 *** Python now supported.
601 def and class at the beginning of a line are tags.
602
603 *** New file extensions recognized: .ss, .pdb, .psw.
604 .ss files are Scheme files, .pdb is Postscript with C syntax, .psw is
605 for PSWrap.
606
607 ** Fixed ldap libraries configuration.
608
609 It used to fail when `-lldap' requires `-llber'.  Introduced in
610 upstream `configure.in' revision 1.151.2.31 (2005/01/31 02:54:47 +0).
611
612 *** Fixed `LDAP_OPT_ON' libraries configuration.
613
614 The original fix of local `configure.in' revision 1.19 (2004/12/19
615 21:10:02 +0) introduced lossage on another class of systems.  In some
616 openldap versions `ldap_*' functions may link successfully without
617 `-lber', but compiling and linking program with `LDAP_OPT_ON' may
618 require `-lber'.  When configuring ldap libraries, check for such
619 systems, and in a cleaner way than in upstream.
620
621 \f
622 * Lisp and internal changes in XEmacs 21.4
623 ==========================================
624
625 ** A new portable dumper is available.
626
627 Olivier Galibert has written a portable dumper for XEmacs, based on
628 initial work by Kyle Jones.  To perform even the most basic editor
629 functions, XEmacs requires some amount of Lisp code to be loaded.  To
630 avoid repeating the expensive loading process at every startup, XEmacs
631 is built in a special way.  Its C sources link into an executable
632 called `temacs', which loads the bootstrap Lisp code and uses a
633 special "unexec" call to dump the resulting memory image into a proper
634 `xemacs' executable on disk.  The unexec() process is hard to
635 implement correctly and makes XEmacs very hard to port to new
636 operating systems, or even to new releases of old systems.
637
638 The new portable dumper uses a different approach to dumping: instead
639 of dumping full-fledged executable, it only dumps out the initialized
640 data structures (both Lisp and C) into an external file.  A normally
641 running XEmacs only needs to mmap that file and relocate a bit to get
642 to the initialized data.  In that scheme, there is no difference
643 between `temacs' and `xemacs'.
644
645 The portable dumper will not be used by default in this release,
646 however, if you wish to experiment with it, or if you need to compile
647 XEmacs on a new and unsupported platform, you can test it by
648 configuring XEmacs using the `--pdump' flag.
649
650 ** Much effort has been invested to make XEmacs Lisp faster:
651
652 *** Many basic lisp operations are now faster.
653 This is especially the case when running a Mule-enabled XEmacs.
654
655 A general overhaul of the lisp engine should produce a speedup of 1.4
656 in a non-Mule XEmacs, and 2.1 in a Mule XEmacs.  These numbers were
657 obtained running `(byte-compile "simple.el")', which should be a
658 pretty typical test of "pure" Lisp.
659
660 *** Lisp hash tables have been re-implemented.  The Common Lisp style
661 hash table interface has been made standard, and moved from cl.el into
662 fast C code (See the section on hash tables in the XEmacs Lisp
663 Reference).  A speedup factor of 3 can be expected with code that
664 makes intensive use of hash tables.
665
666 *** The garbage collector has been tuned, leading to a speedup of
667 1.16.
668
669 *** The byte-compiler and the byte-optimizer have been tuned to
670 produce better code in many small ways.
671
672 *** The family of functions that iterate over lists, like `memq', and
673 `rassq', have been made a little faster (typically 1.3).
674
675 *** Lisp function calls are faster, by approximately a factor of two.
676 However, defining inline functions (via defsubst) still makes sense
677 for tight loops.
678
679 *** Finally, a few functions have had dramatic performance
680 improvements.  For example, `(last long-list)' is now 30 times faster.
681
682 Of course, your mileage will vary.
683
684 Many operations do not see any improvement.  Surprisingly, running
685 (font-lock-fontify-buffer) does not use the Lisp engine much at all.
686 Speeding up your favorite slow operation is an excellent project to
687 improve XEmacs.  Don't forget to profile!
688
689 ** Native widgets can be displayed in buffers.
690
691 The glyph system has been extended to allow the display of glyphs that
692 are implemented as native window-system widgets.  Thus you can embed
693 buttons, scrollbars, combo boxes, edit fields and progress gauges in a
694 buffer.  As a side effect subwindow support now works once again.
695
696 All of this is still fairly experimental and there is no
697 documentation.  The current APIs might change in a future version of
698 XEmacs.  Some widgets are only available under MS Windows.  See the
699 file glyphs-test.el in the XEmacs src distribution for examples of
700 usage.
701
702 The buffers-tab functionality and progress gauge have been implemented
703 using this feature.
704
705 ** Case translation now supports international characters.
706
707 *** Instead of being lists of 256-character strings, case tables are
708 now opaque objects.  The interface to access them is almost the same,
709 except it now works for international characters, and you can set the
710 case pairs using `put-case-table-pair'.  `set-case-table' and friends
711 still support the old list/string based interface for backward
712 compatibility.
713
714 *** As a consequence of this change, functions `downcase' and `upcase'
715 as well as all the case-transformation commands now work with
716 non-ASCII characters.  Built-in tables cover all the Latin character
717 sets that we support.  If your language has a distinction between
718 upper and lower case that is not handled by XEmacs/Mule, please let us
719 know.
720
721 *** The code that implements case-insensitive search has been modified
722 to respect the case table settings.  This also applies to regexp
723 search.
724
725 ** Syntax tables may now be specified for a part of a buffer by
726 attaching the `syntax-table' property to an extent.  For compatibility
727 with GNU Emacs, you may use the text-property interface to achieve the
728 same result.
729
730 ** Values of variables `user-init-file' and `user-init-directory' are
731 now absolute file/directory names.  Previously, both variables used to
732 be relative to `(concat "~" init-file-user)'.  This turned out to be
733 too complicated for most packages (and some core Lisp files) to use
734 correctly.  Also, the `init-file-user' variable has been obsoleted in
735 the process.
736
737 The user-visible options like `-u' have not changed their behavior.
738
739 ** XEmacs finally has an automated test suite!
740 Although this is not yet very sophisticated, it is already responsible
741 for several important bug fixes in XEmacs.  To try it out, simply use
742 the makefile target `make check' after building XEmacs.
743
744 ** Hash tables have been reimplemented.
745 As was pointed out above, the standard interface to hash tables is now
746 the Common Lisp interface, as described in Common Lisp, the Language
747 (CLtL2, by Steele).  The older interface (functions with names
748 containing the phrase `hashtable') will continue to work, but the
749 preferred interface now has names containing the phrase `hash-table'.
750
751 Here's the executive overview: create hash tables using
752 make-hash-table, and use gethash, puthash, remhash, maphash and
753 clrhash to manipulate entries in the hash table.  See the (updated)
754 Lisp Reference Manual for details.
755
756 ** Lisp code handles circular lists much more robustly.
757 Many basic lisp functions used to loop forever when given a circular
758 list, expecting you to C-g (quit) out of the loop.  Now this is more
759 likely to trigger a `circular-list' error.  Printing a circular list
760 now results in something like this:
761
762     (let ((x (cons 'foo 'foo)))
763       (setcdr x x)
764       x)
765       => (foo ... <circular list>)
766
767 An extra bonus is that checking for circularities is not just
768 friendlier, but actually faster than checking for C-g.
769
770 ** Functions for decoding base64 encoding are now available; see
771 `base64-encode-region', `base64-encode-string', `base64-decode-region'
772 and `base64-decode-string'.
773
774 ** The functions `read-string', `read-expression', `eval-minibuffer',
775 `read-variable', `read-command', `read-function', `read-number',
776 `read-shell-command', `read-from-minibuffer', and `completing-read'
777 now take an additional argument which specifies the default value.  If
778 this argument is non-nil, it should be a string; that string is used
779 in two ways:
780
781  * It is returned if the user enters empty input.
782  * It is available as the logical "future" entry, by pressing the down
783    arrow.
784
785 ** LDAP changes.
786
787 *** The LDAP interface now consists of two layers, a low-level layer
788 that closely matches the LDAP C API, and a more convenient
789 higher-level set of functions.
790
791 *** The low-level functions that used to be named *-internal are now
792 named more simply: `ldap-open', `ldap-close', `ldap-search-basic',
793 `ldap-add', and `ldap-modify'.  They should be used directly for very
794 specific purposes (such as multiple operations on a connection) only.
795
796 *** The higher-level functions provide a more convenient way to access
797 LDAP directories hiding the subtleties of handling the connection,
798 translating arguments and ensuring compliance with LDAP
799 internationalization rules and formats (currently partly implemented
800 only.)  This layer provides atomic operations for searches,
801 modification, addition and deletion of multiple entries at once:
802 `ldap-search-entries', `ldap-add-entries', `ldap-delete-entries', and
803 `ldap-modify-entries'.
804
805 *** To maintain compatibility with previous code, the now obsolete
806 function `ldap-search' is now merely a wrapper that calls either
807 `ldap-search-basic' or `ldap-search-entries'.  Please don't use the
808 `ldap-search' function in your new programs -- a direct call to one of
809 the two replacements is more efficient and unambiguous.
810
811 ** The arguments to `locate-file' are now more Lisp-like.  As before,
812 the usage is:
813
814     (locate-file FILENAME PATH-LIST &optional SUFFIXES MODE)
815
816 Except that SUFFIXES are now a list of strings instead of a single,
817 colon-separated string.  MODE is now a symbol or a list of symbols
818 (symbols `exists', `executable', `writable', and `readable' are
819 supported) instead of an integer code.  See the documentation for
820 details.  Of course, the old form is still accepted for backward
821 compatibility.
822
823 Several bugs in locate-file have been fixed, most notably its failure
824 to call expand-file-name on elements of PATH-LIST.  Because of that
825 elements of load-path of the form "~/..." used to not work.
826 locate-file is now guaranteed to expand files during its course of
827 operation.
828
829 ** `translate-region' has been improved in several ways.  Its TABLE
830 argument used to be a 256-character string.  In addition to this, it
831 can now also be a vector or a char-table, which makes the function
832 useful for Mule, which it wasn't.  If TABLE is a vector or a generic
833 char-table, you can map characters to strings instead of to other
834 characters.  For instance:
835
836     (let ((table (make-char-table 'generic)))
837       (put-char-table ?a "the letter a" table)
838       (put-char-table ?b "" table)
839       (put-char-table ?c ?\n table)
840       (translate-region (point-min) (point-max) table))
841
842 ** The new form `ignore-file-errors', similar to `ignore-errors' may
843 be used as a short-hand for condition-case when you wish to ignore
844 file-related error.  For example:
845
846     (ignore-file-errors (delete-file "foo"))
847
848 ** The first argument to `intern-soft' may now also be a symbol, like
849 with `unintern'.  If given a symbol, `intern-soft' will look for that
850 exact symbol rather than for any string.  This is useful when you want
851 to check whether a specific symbol is interned in an obarray, e.g.:
852
853     (intern "foo")
854     (intern-soft "foo")
855       => foo
856     (intern-soft (make-symbol "foo"))
857       => nil
858
859 ** The `keywordp' function now returns non-nil only on symbols
860 interned in the global obarray.  For example:
861
862     (keywordp (intern ":foo" [0]))
863       => nil
864     (keywordp (intern ":foo"))       ; The same as (keywordp :foo)
865       => t
866
867 This behavior is compatible with other code which treats symbols
868 beginning with colon as keywords only if they are interned in the
869 global obarray.  `keywordp' used to wrongly return t in both above
870 cases.
871
872 ** The function `replace-in-string' has been rewritten to use
873 `replace-match'.  This not only makes it much faster, but adds all the
874 features of `replace-match'.
875
876 ** New variables `this-command-properties' and
877 `last-command-properties' are now available for communication between
878 consecutive commands.  Commands should use these to communicate with
879 the pre/post-command hooks, subsequent commands, wrapping commands,
880 etc. in preference to looking at and/or setting `this-command'.
881
882 ** New functions `add-one-shot-hook' and `add-local-one-shot-hook' make
883 it possible to add a "one-shot" hook, which is to say a hook that runs
884 only once, and automatically removes itself after the first time it
885 has run.
886
887 ** The descriptor that specifies the text of a menu item can now be an
888 evaluated expression.  This makes it parallel with other descriptors,
889 which can also be expressions.
890
891 \f
892 * Changes in XEmacs 21.0
893 ========================
894
895 ** XEmacs has been unbundled into constituent installable packages.
896 See the Info documentation under "Packages" for more information.
897 See the file `etc/PACKAGES' in the distribution for a partial list of
898 packages available at the time of the 21.0 release.
899
900 ** XEmacs is now supported under Microsoft Windows 95/98 and Windows
901 NT operating systems.  For starters, look at the XEmacs on Windows FAQ
902 at <URL:http://jagor.srce.hr/~hniksic/xemacs-on-windows-faq.txt>.  To
903 discuss Windows-specific issues, subscribe to the mailing list at
904 <xemacs-nt-request@xemacs.org>.
905
906 ** XEmacs will now use `XEmacs' as its application class if it finds
907 any `XEmacs' resources in the resource database.  Otherwise, it will
908 continue to use the `Emacs' class.
909
910 ** The options menu has been ported to Custom.
911 This means that each entry in the options menu acts as if you had customized
912 the corresponding variable by hand.  ### WARNING: there is currently no
913 upgrading function to help you port your old options settings to the new
914 format. Consequently, if you want to modify the options for XEmacs 21, you
915 will have to set them all again through the menu, and remove the code loading
916 .xemacs-options from your .emacs.
917
918 ** When the Zmacs region is active, `M-x query-replace' and the other
919 replace commands now operate on the region contents only.
920
921 ** XEmacs now is able to choose X visuals and use private colormaps.
922 The '-visual <visualStr>' command line option or the '.EmacsVisual'
923 Xresource controls which visual XEmacs will use, and
924 '-privateColormap' or '.privateColormap' will force XEmacs to create a
925 private colormap for use.  The syntax for the visual string is
926 "<visual><bitdepth>" where <visual> is one of 'StaticColor',
927 'TrueColor', 'GrayScale', 'PseudoColor' or 'DirectColor' and
928 <bitdepth> is the appropriate number of bits per pixel.  If an invalid
929 or non-supported combination is entered, XEmacs attempts to find a happy
930 medium.  The X creation mechanism will then determine if it needs to
931 create a colormap for use, or the presence of the private flags will
932 force it to create it.
933
934 ** The `imenu' package has been ported to XEmacs and is available as a
935 package.
936
937 ** `echo-keystrokes' can now be a floating-point number, so that you
938 can set it to intervals shorter than one second.
939
940    (setq echo-keystrokes 0.1)
941
942 ** The new command `center-to-window-line' works like `recenter'
943 (bound to `C-l'), only it does not redisplay the whole display area.
944
945 ** The M-. command will now first search through exact tags matches,
946 and then through inexact matches, as one would expect.
947
948 ** The new variable `user-full-name' can be used to customize one's
949 name when using the Emacs mail and news reading facilities.
950
951 Normally, `user-full-name' is a function that returns the full name of
952 a user or UID, as specified by the system -- for instance,
953 (user-full-name "root") returns something like "Super-User".  However,
954 when the function is called without arguments, it will return the
955 value of the `user-full-name' variable.  The `user-full-name' variable
956 is initialized using the environment variable NAME and (failing that)
957 the user's system name.
958
959 The behavior of the `user-full-name' function with an argument
960 specified is unchanged.
961
962 ** The new command `M-x customize-changed-options' lets you customize
963 all the options whose default values have changed in recent Emacs
964 versions.  You specify a previous Emacs version number as argument,
965 and the command creates a customization buffer showing all the
966 customizable options whose default values were changed since that
967 version.
968
969 If you don't specify a particular version number argument, then the
970 customization buffer shows all the customizable options for which
971 Emacs versions of changes are recorded.
972
973 ** The new command `add-log-convert' can be used to convert the
974 old-style (pre-20.3) ChangeLog buffers to new style, for
975 consistency.  A reminder: if you wish to revert to old-style
976 ChangeLogs instead, customize the value of `add-log-time-format'
977 variable.
978
979 ** The new command `zap-up-to-char' is now available.  It is similar
980 to `zap-to-char', except that it does not delete the searched-for
981 character.  It is not bound to a key by default.
982
983 ** You can now store a number into a register with `C-u NUMBER C-x r n'
984 REG, increment it by INC with `C-u INC C-x r + REG' (to increment by
985 one, omit C-u INC), and insert it in the buffer with `C-x r g REG'.
986 This is useful for writing keyboard macros.
987
988 ** The M-: command, when given a prefix argument, will now insert its
989 result to the current buffer.
990
991 ** The `C-h c' command, when given a prefix argument, will now insert
992 the message into the current buffer.
993
994 ** Horizontally split windows may now be dragged using the mouse.
995 Because of this, the dividers between vertical windows are always
996 visible.  To turn it off, set `vertical-divider-always-visible-p' to
997 nil.
998
999 ** XEmacs/Mule (internationalization) changes.
1000
1001 *** Mule support now works on TTY's.  Use `set-terminal-coding-system'
1002 and `set-keyboard-coding-system' to specify the coding system of your
1003 display and keyboard.
1004
1005 *** Egg/SJ3 input method is now officially supported.  Quail and
1006 Egg/Skk have been available through the generalized Leim since 20.3.
1007
1008 *** Localized Japanese menubars are available if XEmacs is built with
1009 XFONTSET and either the X11 libraries are built with X_LOCALE defined
1010 or the native C libraries support Japanese localization.  This has
1011 been available since 20.3, only it hasn't been announced before.
1012
1013 ** Jamie Zawinski's `gdb-highlight' extension is now distributed with
1014 the `debug' package.  gdb-highlight makes most objects printed in a
1015 gdb buffer be mouse-sensitive: as text shows up in the buffer, it is
1016 parsed, and objects which are recognized have context-sensitive
1017 commands attached to them.  To use it, add the following to `.emacs':
1018
1019   (add-hook 'gdb-mode-hook (lambda () (require 'gdb-highlight)))
1020
1021 ** The package popper.el is now included in the edit-utils package.
1022 It has been greatly enhanced with respect to the one once included
1023 with the ilisp package and should work well under XEmacs 21.0.
1024
1025 ** Gnuserv changes
1026
1027 *** Like the old 'gnudoit' program. Gnuclient -batch now can read from stdin.
1028
1029 *** Gnuclient -batch no longer breaks off the output at the first LF.
1030
1031 ** C mode changes
1032
1033 *** Multiline macros are now handled, both as they affect indentation,
1034 and as recognized syntax.  New syntactic symbol cpp-macro-cont is
1035 assigned to second and subsequent lines of a multiline macro
1036 definition.
1037
1038 *** A new style "user" which captures all non-hook-ified
1039 (i.e. top-level) .emacs file variable setings and customizations.
1040 Style "cc-mode" is an alias for "user" and is deprecated.  "gnu" style
1041 is still the default however.
1042
1043 *** "java" style now conforms to Sun's JDK coding style.
1044
1045 *** There are new commands c-beginning-of-defun, c-end-of-defun which
1046 are alternatives which you could bind to C-M-a and C-M-e if you prefer
1047 them.  They do not have key bindings by default.
1048
1049 *** New and improved implementations of M-a (c-beginning-of-statement)
1050 and M-e (c-end-of-statement).
1051
1052 *** C++ namespace blocks are supported, with new syntactic symbols
1053 namespace-open, namespace-close, and innamespace.
1054
1055 *** File local variable settings of c-file-style and c-file-offsets
1056 makes the style variables local to that buffer only.
1057
1058 *** New indentation functions c-lineup-close-paren,
1059 c-indent-one-line-block, c-lineup-dont-change.
1060
1061 *** Improvements (hopefully!) to the way CC Mode is loaded.  You
1062 should now be able to do a (require 'cc-mode) to get the entire
1063 package loaded properly for customization in your .emacs file.  A new
1064 variable c-initialize-on-load controls this and is t by default.
1065
1066 ** In Text mode, now only blank lines separate paragraphs.
1067 This makes it possible to get the full benefit of Adaptive Fill mode
1068 in Text mode, and other modes derived from it (such as Mail mode).
1069 TAB in Text mode now runs the command indent-relative; this makes a
1070 practical difference only when you use indented paragraphs.
1071
1072 As a result, the old Indented Text mode is now identical to Text mode,
1073 and is an alias for it.
1074
1075 If you want spaces at the beginning of a line to start a paragraph,
1076 use the new mode, Paragraph Indent Text mode.
1077
1078 ** Changes to Gnus, the XEmacs newsreader.
1079
1080 *** New functionality for using Gnus as an offline newsreader has been
1081 added.  A plethora of new commands and modes have been added.  See the
1082 Gnus manual for the full story.
1083
1084 *** The nndraft backend has returned, but works differently than
1085 before.  All Message buffers are now also articles in the nndraft
1086 group, which is created automatically.
1087
1088 *** `gnus-alter-header-function' can now be used to alter header
1089 values.
1090
1091 *** `gnus-summary-goto-article' now accept Message-ID's.
1092
1093 *** A new Message command for deleting text in the body of a message
1094 outside the region: `C-c C-v'.
1095
1096 *** You can now post to component group in nnvirtual groups with
1097 `C-u C-c C-c'.
1098
1099 *** `nntp-rlogin-program' -- new variable to ease customization.
1100
1101 *** `C-u C-c C-c' in `gnus-article-edit-mode' will now inhibit
1102 re-highlighting of the article buffer.
1103
1104 *** New element in `gnus-boring-article-headers' -- `long-to'.
1105
1106 *** `M-i' symbolic prefix command.  See the section "Symbolic
1107 Prefixes" in the Gnus manual for details.
1108
1109 *** `L' and `I' in the summary buffer now take the symbolic prefix
1110 `a' to add the score rule to the "all.SCORE" file.
1111
1112 *** `gnus-simplify-subject-functions' variable to allow greater
1113 control over simplification.
1114
1115 *** `A T' -- new command for fetching the current thread.
1116
1117 *** `/ T' -- new command for including the current thread in the
1118 limit.
1119
1120 *** `M-RET' is a new Message command for breaking cited text.
1121
1122 *** \\1-expressions are now valid in `nnmail-split-methods'.
1123
1124 *** The `custom-face-lookup' function has been removed.
1125 If you used this function in your initialization files, you must
1126 rewrite them to use `face-spec-set' instead.
1127
1128 *** Cancelling now uses the current select method.  Symbolic prefix
1129 `a' forces normal posting method.
1130
1131 *** New command to translate M******** sm*rtq**t*s into proper text
1132 -- `W d'.
1133
1134 *** For easier debugging of nntp, you can set `nntp-record-commands'
1135 to a non-nil value.
1136
1137 *** nntp now uses ~/.authinfo, a .netrc-like file, for controlling
1138 where and how to send AUTHINFO to NNTP servers.
1139
1140 *** A command for editing group parameters from the summary buffer
1141 has been added.
1142
1143 *** A history of where mails have been split is available.
1144
1145 *** A new article date command has been added -- `article-date-iso8601'.
1146
1147 *** Subjects can be simplified when threading by setting
1148 `gnus-score-thread-simplify'.
1149
1150 *** A new function for citing in Message has been added --
1151 `message-cite-original-without-signature'.
1152
1153 *** `article-strip-all-blank-lines' -- new article command.
1154
1155 *** A new Message command to kill to the end of the article has
1156 been added.
1157
1158 *** A minimum adaptive score can be specified by using the
1159 `gnus-adaptive-word-minimum' variable.
1160
1161 *** The "lapsed date" article header can be kept continually
1162 updated by the `gnus-start-date-timer' command.
1163
1164 *** Web listserv archives can be read with the nnlistserv backend.
1165
1166 *** Old dejanews archives can now be read by nnweb.
1167
1168 *** Byte-compilation of user-specs now works under XEmacs.
1169
1170 ** The `dir' files are no longer essential for functioning of the Info
1171 subsystem.  If the `dir' file does not exist in an Info directory, the
1172 relevant information will be generated on-the-fly.
1173
1174 This behavior can be customized, look for `Info-auto-generate-directory'
1175 and `Info-save-auto-generated-dir' in the `info' customization group.
1176
1177 \f
1178 * Lisp and internal changes in XEmacs 21.0
1179 ==========================================
1180
1181 ** It is now possible to build XEmacs with support for 31-bit Lisp
1182 integers (normally, Lisp integers are only 28 bits wide on 32-bit
1183 machines.)  Configure with --use-minimal-tagbits to test.  With this
1184 change, the maximum buffer size on 32-bit machines is increased from
1185 128M to 1G.  This setting will be made default in a future XEmacs
1186 version.
1187
1188 ** Specifier changes.
1189
1190 *** When instantiating a specifier, the window locale now has a higher
1191 precedence than the buffer locale.  This is because the window locale
1192 is more specific than the buffer locale.
1193
1194 *** The new macro `let-specifier' can be used to temporarily add
1195 specifications to specifiers.  See the documentation for details.
1196
1197 *** The new specifiers `vertical-scrollbar-visible-p' and
1198 `horizontal-scrollbar-visible-p' may be used to control scrollbar
1199 visibility.  Previously, the only way to remove a scrollbar was to set
1200 its size to 0.  This method is still supported for backward
1201 compatibility.
1202
1203 *** The new specifiers `scrollbar-on-left-p' and `scrollbar-on-top-p'
1204 may be used to control the position of the vertical and horizontal
1205 toolbar.  Previously, their position could be changed only through the
1206 use of X resources.
1207
1208 *** The new draggable vertical dividers between windows may be turned
1209 off using the `vertical-divider-always-visible-p' specifier.  When
1210 this is set to nil, the vertical dividers between windows are shown
1211 only when needed, and they are not draggable.
1212
1213 Other properties of the vertical dividers may be controlled using
1214 `vertical-divider-shadow-thickness', `vertical-divider-line-width' and
1215 `vertical-divider-spacing' specifiers, which see.
1216
1217 ** Frame focus management changes.
1218
1219 *** When the variable focus-follows-mouse is non-nil, `select-frame'
1220 no longer permanently selects a different frame.  The frame selection
1221 is temporary and is reverted when the current command terminates, much
1222 like the buffer selected by `set-buffer'.  This is the same as in FSF
1223 Emacs.
1224
1225 *** The new function `focus-frame' sets the window system focus to
1226 FRAME (and selects it), regardless of the value of
1227 `focus-follows-mouse'.  Doing this is not well behaved, so be
1228 absolutely sure that you want this.
1229
1230 The code that uses `select-frame' only to get the window manager focus
1231 should be changed to use `set-frame-focus' instead, so that they keep
1232 working when `focus-follows-mouse' is non-nil.
1233
1234 *** The special forms `save-selected-frame' and `with-selected-frame'
1235 can now be used to temporarily change selected frame.
1236
1237 *** The behavior of `other-frame' command (`C-x 5 o') is unaffected by
1238 these changes.
1239
1240 ** The function `select-window' now has an optional second argument
1241 NORECORD which if non-nil inhibits the recording of a buffer change.
1242
1243 ** The function `vertical-motion' now correctly handles the second,
1244 optional WINDOW argument.  A new third argument PIXELS, if non-nil,
1245 indicates that the returned motion should be in pixels.
1246
1247 ** The new function `vertical-motion-pixels' is similar to
1248 vertical-motion but takes as input a vertical motion in pixels.
1249
1250 ** The new functions window-text-area-pixel-{width,height,edges} can
1251 be used to obtain information about the text-displaying area of a
1252 window.
1253
1254 ** The new functions `shrink-window-pixels' and `enlarge-window-pixels'
1255 can be used to adjust the size of a window by a pixel amount.
1256
1257 ** The new function `window-displayed-text-pixel-height' can be used
1258 to determine the height of the text actually displayed in a window.
1259
1260 ** The arithmetic comparison functions <, >, =, /= now accept a
1261 variable number of arguments.
1262
1263 This means that if you want to test whether A < B < C, you can write
1264 it as (< A B C) instead of (and (< A B) (< B C)).  Likewise,
1265 (apply #'> LIST) now tests if LIST is monotonously increasing -- and
1266 so on.
1267
1268 ** The XEmacs hashtables now have a consistent read/print syntax.
1269 This means that a hashtable will be readably printed in a
1270 structure-like form:
1271
1272    #s(hashtable size 2 data (key1 value1 key2 value2))
1273
1274 When XEmacs reads this form, it will create a new hashtable according
1275 to description.  This allows you to easily dump hashtables to files
1276 using `prin1', and read them back in using `read'.
1277
1278 If `print-readably' is non-nil, a more relaxed syntax is used; for
1279 instance:
1280
1281    #<hashtable size 2/13 data (key1 value1 key2 value2) 0x874d>
1282
1283 ** It is now possible to build XEmacs with LDAP support.
1284 You will need to install a LDAP library first.  The following have
1285 been tested:
1286   - LDAP 3.3 from the University of Michigan
1287     (get it from <URL:http://www.umich.edu/~dirsvcs/ldap/>)
1288   - OpenLDAP 1.0.3 from the OpenLDAP Foundation
1289     (get it from <URL:http://www.openldap.org/>)
1290   - LDAP SDK 1.0 from Netscape Corp.
1291     (get it from <URL:http://developer.netscape.com/>)
1292
1293 ** When profiling is in effect, a call-count of all recorded functions
1294 is now calculated.  This information is stored in
1295 `call-count-profile-table', and is utilized by `profile-results' as
1296 well as the new command `profile-call-count-results'.
1297
1298 ** It is now an error to change the value of a symbol whose name
1299 starts with a colon, if it is interned in the standard obarray.
1300
1301 However, setting such a symbol to its proper value, which is that
1302 symbol itself, is not an error.  This is for the sake of programs that
1303 support pre-19.12 XEmacs and pre-20 GNU Emacs by explicitly setting
1304 these variables to themselves.
1305
1306 ** The `concat' function no longer accepts integer arguments.
1307
1308 ** The new function `string' concatenates all its argument characters
1309 and returns the resulting string.  This is consistent with other
1310 functions, like `list', `vector', etc.
1311
1312 ** The function `temp-directory' is now available to return the
1313 directory to store temporary files.  On Unix this will be obtained
1314 from TMPDIR, defaulting to `/tmp'.
1315
1316 ** The function load-average now accepts an optional argument
1317 USE-FLOATS.  If it is non-nil, the load average values are returned as
1318 floating point numbers, rather than as integers to be divided by 100.
1319
1320 ** The `make-event' function now supports the TYPE and PLIST
1321 arguments, which can be used to create various events from Lisp.  See
1322 the documentation for details.
1323
1324 ** `function-interactive' is a new function that returns the
1325 interactive specification of a funcallable object.
1326
1327 ** The new `lmessage' function allows printing of a formatted message
1328 with a particular label.
1329
1330    (lmessage 'progress "Processing... %d" counter)
1331
1332 This function is more convenient than `display-message' because it
1333 automatically applies `format' to its arguments.
1334
1335 ** The new `lwarn' function, analogous to `lmessage', allows printing
1336 a formatted warning, with a non-default CLASS or LABEL.
1337
1338 ** The new function `split-path' can now be used to explode the
1339 components of a colon-separated search path into a list.
1340
1341    (split-path "foo:bar")
1342      => ("foo" "bar")
1343
1344 ** Specifiers and symbols whose value is a specifier are now allowed
1345 as modeline specifications.
1346
1347 ** defcustom now accepts the keyword `:version'.  Use this to specify
1348 in which version of Emacs a certain variable's default value changed.
1349 For example,
1350
1351    (defcustom foo-max 34 "*Maximum number of foo's allowed."
1352      :type 'integer
1353      :group 'foo
1354      :version "21.0")
1355
1356 This information is used to control the customize-changed-options
1357 command.
1358
1359 ** The line number tracking in modeline is now efficient, even for
1360 very large buffers.  This is achieved by caching the line numbers of
1361 recent buffer positions, and reusing them.  This cache is used only in
1362 the buffers where `line-number-mode' is in effect.
1363
1364 ** When the new GNU Malloc aka Doug Lea Malloc is available, it will
1365 be used.  This should result in better performance on Linux systems
1366 with libc6.
1367
1368 ** The code XEmacs uses to assemble its various paths into the
1369 directory hierarchy has been rewritten to support the package system.
1370 Look under "Startup Paths" in the Info documentation for more
1371 information.
1372
1373 *** site-lisp is no longer part of the load-path by default.
1374 Its use is deprecated, but you can specify --with-site-lisp=yes at the
1375 configure command line to get it back.
1376
1377 *** `Info-default-directory-list' is now obsolete.  If you want to
1378 change the path which XEmacs uses to search for info files, set
1379 `Info-directory-list' instead.
1380
1381 \f
1382 * For older news, see the file ONEWS.