* minibuffer.el (completion-table-with-terminator): Properly implement
[bpt/emacs.git] / etc / NEWS
CommitLineData
29b7722a 1GNU Emacs NEWS -- history of user-visible changes.
5b87ad55 2
bb65542c 3Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc.
5b87ad55 4See the end of the file for license conditions.
a933dad1 5
3f7194ed 6Please send Emacs bug reports to emacs-pretest-bug@gnu.org.
9a21d88b
KS
7If possible, use M-x report-emacs-bug.
8
0bfd685e 9This file is about changes in Emacs version 23.
9a21d88b 10
0bfd685e
GM
11See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17
12for changes in older Emacs versions.
9a21d88b
KS
13
14You can narrow news to a specific version by calling `view-emacs-news'
15with a prefix argument or by typing C-u C-h C-n.
3f7194ed 16
adce950d
CY
17
18Temporary note:
19 +++ indicates that the appropriate manual has already been updated.
20 --- means no change in the manuals is called for.
21When you add a new item, please add it without either +++ or ---
22so we will look at it and add it to the manual.
23
24\f
aa701ce8
CY
25* Installation Changes in Emacs 23.2
26
27** New configure options for Emacs developers
28These are not new features; only the configure flags are new.
29
30*** --enable-profiling builds Emacs with profiling enabled.
31This might not work on all platforms.
32
33*** --enable-checking[=OPTIONS] builds emacs with extra runtime checks.
34
45980501
GM
35---
36** `make install' now consistently ignores umask, creating a
37world-readable install.
38
f9245b5d 39* Startup Changes in Emacs 23.2
adce950d 40
8686ac71 41** Command-line option -Q (--quick) now also disables loading X resources.
8aed8fa9
GM
42Note however that this does not affect Lucid or Motif widgets, if you
43are using those toolkits. On Windows, this option causes Emacs to
44ignore Registry settings, though environment variables set on the
45Registry are still honored.
f9245b5d
CY
46
47*** The new variable `inhibit-x-resources' shows whether X resources
48were loaded.
8686ac71 49
f9245b5d 50* Changes in Emacs 23.2
fcb68f70 51
1659ada0
JB
52** Function arguments in *Help* buffers are now in uppercase by default.
53You can customize the new variable `help-downcase-arguments' to change it.
54
f9245b5d 55** Unibyte sessions are now considered obsolete.
82e98df4
SM
56I.e. the use of the environment variable EMACS_UNIBYTE, or command line
57arguments --unibyte, --multibyte, --no-multibyte, and --no-unibyte
58is deprecated. Similarly for custom-izing enable-multibyte-characters, or
59setting default-enable-multibyte-characters.
60
d63a01ef
CY
61** The default value of `trash-directory' has changed to nil, which
62means that `move-file-to-trash' trashes files according to
63freedesktop.org specifications, the same method used by the Gnome,
64KDE, and XFCE desktops. (This change has no effect on Windows, which
65uses `system-move-file-to-trash' for trashing.)
66
3f1c6666
JD
67+++
68** Emacs frames can be maximized.
69The command line arguments -mm/--maximized and the value maximized to the
70frame parameter fullscreen makes the Emacs frame maximized.
71
7f1681d9
JD
72+++
73** New frame parameter sticky makes Emacs frames sticky in virtual desktops.
74
e044e4fc
JD
75** The pointer now becomes invisible when typing.
76Customize make-pointer-invisible to turn it off.
77
f4fcbe98
JL
78** Killing a buffer with a running process now asks a confirmation.
79You can remove this query in two ways: either removing
80`process-kill-buffer-query-function' from `kill-buffer-query-functions' or
81setting the appropriate process flag with `set-process-query-on-exit-flag'.
82
100b6355
KR
83** The variable `load-in-progress' won't get corrupted by binding it
84with `let'. In certain situations, loading an Emacs Lisp file from
85source while in the midst of loading another file (e.g., with
86`require' or `autoload') could cause the value of `load-in-progress'
87to be corrupted once the outer load completed. Most code doesn't care
88about this, but some (like c-mode) may check it.
89
34481ea1
CY
90** File-local variable changes
91
92*** Specifying a minor mode as a local variables enables that mode,
93unconditionally. The previous behavior, toggling the mode, was
94neither reliable nor generally desirable.
95
96*** New commands for adding and removing file-local variables:
97`add-file-local-variable', `delete-file-local-variable',
98`add-file-local-variable-prop-line', and
99`delete-file-local-variable-prop-line'.
100
101*** New commands for adding and removing directory-local variables,
102and copying them to and from file-local variable lists:
103`add-dir-local-variable', `delete-dir-local-variable',
104`copy-dir-locals-to-file-locals',
82941b5e
JL
105`copy-dir-locals-to-file-locals-prop-line' and
106`copy-file-locals-to-dir-locals'.
107
3c736e33
KH
108** New coding system `utf-8-hfs' is available in
109international/ucs-normalize.el. It is suitable for
110default-file-name-coding-system on Mac OS X.
111
05197f40 112\f
0badeef4
GM
113* Editing Changes in Emacs 23.2
114
f9245b5d
CY
115** Selection changes
116+++
117*** If `select-active-regions' is t, any active region automatically
118becomes the primary selection (for interaction with other window
119applications). If you enable this, you might want to bind
120`mouse-yank-primary' to Mouse-2.
121
122*** When `save-interprogram-paste-before-kill' is non-nil, emacs will
123not clobber the the interprogram paste when something is killed in it
124by saving the former in the `kill-ring' before the latter.
125
126** When `kill-do-not-save-duplicates' is non-nil, identical subsequent
127kills are not duplicated in the `kill-ring'.
128
0badeef4
GM
129+++
130** The default value for `blink-matching-paren-distance' has been increased.
131
f9245b5d
CY
132** The new completion-style `initials' is available.
133For instance, this can complete M-x lch to list-command-history.
134
0badeef4 135\f
009c963c
MA
136* Changes in Specialized Modes and Packages in Emacs 23.2
137
2aa0e5bf
SM
138** .calc.el and .abbrev_defs obey user-emacs-directory.
139
d10c031a
EZ
140** Calc graphing commands (`g f' etc.) now work on MS-Windows,
141if you have the native Windows port of Gnuplot version 3.8 or later
142installed.
143
f9245b5d
CY
144** Calendar and diary
145
146*** Fancy diary display is now the default.
147If you prefer the simple display, customize `diary-display-function'.
148
149*** The diary's fancy display now enables view-mode.
150
151---
152*** The command `calendar-current-date' accepts an optional argument
153giving an offset from today.
154
155** Desktop
156---
157*** The default value for `desktop-buffers-not-to-save' is nil.
158This means Desktop will try restoring all buffers, when you restart
159your Emacs session. Also, `desktop-buffers-not-to-save' is only
160effective for buffers that have no associated file. If you want to
161exempt buffers that do correspond to files, customize the value of
162`desktop-files-not-to-save' instead.
163
fecbcdcb
GM
164** FIXME mail-user-agent change
165This probably affects a lot of documentation.
166
ee047ec4
GM
167** FIXME gdb-mi
168
9f18817f
JL
169** Info
170
171*** The new command `Info-virtual-index' bound to "I" displays a menu of
172matched topics found in the index.
173
f38fd73d
JL
174*** The new command `info-finder' replaces finder.el with a virtual Info
175manual that generates an Info file which gives the same information
176through a menu structure.
177
009c963c
MA
178+++
179** New connection methods in Tramp.
8b15e920
MA
180The new connection methods "rsyncc", "imap" and "imaps" have been
181introduced. On systems which support GVFS-Fuse, Tramp offers also the
182new connection methods "dav", "davs", "obex" and "synce".
009c963c 183
f9245b5d 184** nXML mode is now the default for editing XML files.
8525a1d6 185
3c3bf6ce
DN
186** VC and related modes
187
b4e813ca
DN
188*** When using C-x v v or C-x v i on a unregistered file that is in a
189directory not controlled by any VCS, ask the user what VC backend to
190use to create a repository, create a new repository and register the
191file.
192
32ba3abc
DN
193*** FIXME: add info about the new VC functions: vc-root-diff and
194vc-root-print-log once they stabilize.
195
d1e4c403
DN
196*** vc-annotate supports annotations through file copies and renames,
197it displays the old names for the files and it can show logs/diffs for
198the corresponding lines. Currently only Git and Mercurial take
199advantage of this feature.
200
3c3bf6ce
DN
201*** When a file is not found, VC will not try to check it out of RCS anymore.
202
e05b6a4e
DN
203*** vc-git changes
204
205**** The new variable vc-git-add-signoff can be used to add a
291bc6bd
DN
206Signed-off-by line when committing.
207
6b4df8a6
DN
208**** Support for operating with stashes has been added to vc-dir: the stash list is
209displayed in the *vc-dir* header, stashes can be created, removed and
210their content displayed.
211
e05b6a4e
DN
212**** vc-dir displays the stash status
213
31764e15
SM
214*** log-edit-strip-single-file-name controls whether or not single filenames
215are stripped when copying text from the ChangeLog to the *VC-Log* buffer.
216
49b289c0
GM
217** Elint
218
219---
220*** Elint now uses compilation-mode.
221
222---
223*** Elint can now scan individual files and whole directories,
224and can be run in batch mode.
225
226---
227*** Elint does a more thorough initialization, and recognizes more built-in
228functions and variables. Customize `elint-scan-preloaded' if you want
229to sacrifice some accuracy for a faster startup.
230
231---
232*** Elint attempts some basic understanding of featurep and (f)boundp tests.
233
234---
235*** Customize `elint-ignored-warnings' to suppress some warnings.
236
9f18817f
JL
237** Miscellaneous
238
239*** The new command `async-shell-command' bound globally to `M-&' executes
240the command asynchronously without the need to manually add ampersand to
241the end of the command. Its output appears in the buffer `*Async Shell
242Command*'.
0badeef4 243
f9245b5d
CY
244+++
245*** Autorevert Tail mode now works now for remote files.
246
af077012
SY
247\f
248* New Modes and Packages in Emacs 23.2
249
b9de0a46
CY
250** FIXME CEDET
251
304fe7fa 252** js.el is a new major mode for JavaScript files.
0822135e 253
3d994264
TZ
254** imap-hash.el is a new library to address IMAP mailboxes as hashtables.
255
0822135e
CY
256\f
257* Lisp changes in Emacs 23.2
258
528c56e2
SM
259** read-file-name-predicate is obsolete. It was used to pass the predicate
260to read-file-name-internal because read-file-name-internal abused its `pred'
261argument to pass the current directory, but this hack is not needed
262any more.
263
d5e63715
SM
264** completion-base-size is obsoleted by completion-base-position.
265This change causes a few backward incompatibilities, mostly with
266choose-completion-string-functions where the `mini-p' argument has
267been replaced by a `base-position' argument, and where the `base-size'
268argument is now always nil.
269
9d28c33e
SM
270** called-interactively-p now takes one argument and replaces interactive-p
271which is now marked obsolete.
ced10a4c
SM
272** New function set-advertised-calling-convention makes it possible
273to obsolete arguments as well as make some arguments mandatory.
0ee98606 274** eval-next-after-load is obsolete.
838ff458
SM
275** New hook `after-load-functions' run after loading an Elisp file.
276
8cb95edf
SM
277** You can control which binding is preferentially shown in menus and
278docstrings by adding a `:advertised-binding' property to the corresponding
279command's symbol. That property can hold a single binding or a list
280of bindings.
281
83a5aac5
SM
282** New macro with-silent-modifications to tweak text properties without
283affecting the buffer's modification state.
4e3b4528
SM
284** All the default-FOO variables that hold the default value of the FOO
285variable, are now declared obsolete.
286
03a74b84
SM
287** read-key is a function halfway between read-event and read-key-sequence.
288It reads a single key, but obeys input and escape sequence decoding.
7284d47a 289
a126db16
GM
290** start-process-shell-command and start-file-process-shell-command
291now only take a single `command' argument.
7284d47a
MA
292
293** The variable `process-file-side-effects' shall be bound to nil, if
294a `process-file' call does not change a remote file. By this, file
295name handlers like Tramp can apply optimizations.
296
0822135e
CY
297** Hash tables have a new printed representation that is readable.
298The feature `hashtable-print-readable' identifies this new
299functionality.
3c736e33
KH
300
301** Functions performing Unicode normalization are added. They are:
302ucs-normalize-NFD-region, ucs-normalize-NFD-string,
303ucs-normalize-NFC-region, ucs-normalize-NFC-string,
304ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,
305ucs-normalize-NFKC-region, ucs-normalize-NFKC-string,
306ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string,
307ucs-normalize-HFS-NFC-region, ucs-normalize-HFS-NFC-string.
94862c1b
SM
308
309** completion-annotate-function specifies how to compute annotations
310for completions displayed in *Completions*.
197b67b1 311
d7fbf3f0 312+++
197b67b1
GM
313** Face aliases can now be marked as obsolete, using the macro
314`define-obsolete-face-alias'.
14ad89e1
GM
315
316---
317** Changing the file-names generated by byte-compilation by redefining
318the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
319Instead, customize byte-compile-dest-file-function.
f9245b5d 320
83f83a98
CY
321** Several obsolete functions removed.
322The functions have been obsolete since Emacs 19, and are unlikely to
323be in use:
324
325 time-stamp-month-dd-yyyy, time-stamp-dd/mm/yyyy, time-stamp-mon-dd-yyyy
326 time-stamp-dd-mon-yy, time-stamp-yy/mm/dd, time-stamp-yyyy/mm/dd,
327 time-stamp-yyyy-mm-dd, time-stamp-yymmdd, time-stamp-hh:mm:ss,
328 time-stamp-hhmm, baud-rate
329
d3080264
MA
330** `delete-directory' has an optional parameter RECURSIVE.
331
9a03b2e1
MA
332** New function `copy-directory', which copies a directory recursively.
333
9976fe82 334+++
72030c76
GM
335** New function `window-full-height-p', analogous to the full-width version.
336
d3080264 337\f
f9245b5d
CY
338* Changes in Emacs 23.2 on non-free operating systems
339
340---
341** On MS-Windows, `display-time' now displays the system load average
342as well as the time, as it does on GNU and Unix.
9f18817f 343
009c963c 344\f
0bfd685e 345* Installation Changes in Emacs 23.1
c58dccad 346
3f7194ed 347** The default X toolkit is now Gtk+, rather than Lucid.
09e18d03
CY
348The configure option `--with-gtk' has been removed. Gtk is now the
349default toolkit, but you can use --with-x-toolkit=gtk if necessary.
3f7194ed 350
09e18d03
CY
351** New font code.
352Fonts are handled by new code capable of dealing with multiple font
de9efca0 353backends. This uses the freetype and fontconfig libraries.
16e82271 354
09e18d03
CY
355*** Emacs now accepts font names supplied in the fontconfig format
356(e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
1abe3a1e 357
09e18d03
CY
358*** Added support for local fonts (fonts installed on the machine
359where Emacs is running).
360
361*** Added support for the Xft library for antialiasing.
362
363*** Added support for the otf library for complex text layout by
364OpenType fonts.
365
366*** Added support for the m17n library for text shaping.
15f02f65 367
09e18d03 368** Changes to image support
16e82271 369
09e18d03 370*** configure now checks for libgif before libungif when searching for
9d3cc9b2 371a GIF library.
16e82271 372
09e18d03
CY
373*** Emacs now supports the SVG image format through librsvg2.
374
fab17942
JR
375*** Emacs now supports multi-page TIFF images.
376
006a2cde 377** New NeXTSTEP-based port
3dcdb6ea 378This provides support for GNUstep (via the GNUstep libraries) and Mac
1e9b0fb2 379OS X (via the Cocoa libraries).
043023ca 380
2e538385 381Specify --with-ns to configure for this. By default, a self-contained
043023ca
CY
382app will be built (containing all lisp). To install/share lisp with
383other emacsen (e.g. X11 build) use --disable-ns-self-contained. See
384nextstep/README and nextstep/INSTALL in the Emacs source directory.
006a2cde
CY
385
386** Mac OS X is no longer supported via Carbon.
387Use the NeXTSTEP port, described above.
36e625ec 388
09e18d03
CY
389** The new configuration option "--with-dbus" enables D-Bus language
390bindings for Emacs.
07e5c0b0 391
bb9f7948
EZ
392** Support for many obsolete platforms has been removed.
393See the list at the end of etc/MACHINES for details.
16e82271 394
09e18d03 395*** Support for systems without alloca has been removed.
16e82271 396
09e18d03 397*** Support for Sun windows has been removed.
16e82271 398
2e0ef05b 399*** The `emacstool' utility has been removed.
09e18d03 400
006a2cde 401** The following platforms will be removed in a future Emacs version:
9bc072cc
CY
402If you are still using Emacs on one of these platforms, please email
403emacs-devel@gnu.org to inform the Emacs developers.
006a2cde 404
9bc072cc 405*** Old GNU/Linux systems based on libc version 5.
006a2cde 406
9bc072cc
CY
407*** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
408 executable format.
006a2cde
CY
409
410*** Solaris versions 2.6 and below.
411
32847230
CY
412*** Solaris on IBM RS6000 machines.
413
414*** UNIX System V (the original SysV, not later platforms based on it).
415
9bc072cc
CY
416*** Unixware on non-x86 machines.
417
32847230
CY
418*** Platforms not supporting shared libraries (i.e., requiring the
419NO_SHARED_LIBS compilation flag).
006a2cde 420
a46ee55c
GM
421** The configure options `--with-gcc', `--without-gcc' have been removed.
422Configure will use gcc by default. Set the CC environment variable if
423you need control over which C compiler is used.
424
09e18d03
CY
425** The refcards are now shipped as PDF files.
426
3b75ca8b
GM
427** The manuals are now licensed under the GNU Free Documentation License v1.3,
428or any later version.
429
09e18d03
CY
430** Emacs 23 comes with a new set of default icons.
431Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
432The Emacs 22 icon is available as `emacs22.png' in the same location.
4e5cdb4f 433\f
6dadd99f
NR
434* Changes in Emacs 23.1
435
09e18d03 436** Improved X Window System support
16e82271 437
09e18d03
CY
438*** Emacs now supports using both X displays and ttys in one session.
439With an Emacs server active (M-x server-start), `emacsclient -t'
440creates a tty frame connected to the running emacs server. You can
441use any number of different ttys. `emacsclient -c' creates a new X11
442frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
e390f3a3
JD
443There may be problems if a display exits unexpectedly and Emacs is compiled
444with Gtk+, see etc/PROBLEMS.
780d7bb9
RS
445
446You can test for the presence of this feature in your Lisp code by
447testing for the `multi-tty' feature.
16e82271
CY
448
449*** Emacs starts in the background, as a daemon, when given the
eab2ee89
DN
450--daemon command line argument. It disconnects from the terminal and
451starts the server. Clients can connect and create graphical or
452terminal frames using emacsclient.
16e82271 453
c569485c 454**** emacsclient starts emacs in daemon mode and connects to it when
82d0a250
DN
455--alternate-editor="" is used (or when the evironment variable
456ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an
c569485c
DN
457emacs server.
458
09e18d03 459*** The new command close-display-connection closes a connection to a
717c97e5 460remote display. There are some bugs for Gtk+. See etc/PROBLEMS.
d82c3d44 461
09e18d03
CY
462*** Emacs now supports the XEmbed specification.
463You can embed Emacs in another application on X11. The new command line
464option --parent-id is used to pass the parent window id to Emacs. See
7b476dbe
JD
465http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
466for details about XEmbed.
16e82271 467
09e18d03
CY
468*** Emacs can now set the frame opacity.
469The opacity of a frame can be controlled by setting the `alpha' frame
470parameter. This only takes effect on a compositing window manager for
920ab46c
SZ
471the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac
472OS X, or on Windows 2000 and later versions of Windows.
55f9bad5
GM
473
474The alpha parameter should be an integer between 0 (transparent) and
09e18d03
CY
475100 (opaque), or a float number between 0.0 and 1.0. It can also be a
476cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
540f3092 477active frame and INACTIVE is the opacity of non-active frames.
55f9bad5 478
09e18d03
CY
479The variable `frame-alpha-lower-limit' defines a lower bound for the
480opacity; the default is 20.
55f9bad5 481
09e18d03 482** Internationalization changes
16e82271 483
09e18d03
CY
484*** The Emacs character set is now a superset of Unicode.
485(It has about four times the code space, which should be plenty).
0a963185 486
09e18d03 487The internal encoding used for buffers and strings is now
16e82271
CY
488Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias
489for this). This encoding is backward-compatible with Unicode's UTF-8
490encoding. The internal encoding previously used by Emacs,
491`emacs-mule', is still available for reading and writing files.
6dadd99f 492
09e18d03
CY
493During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
494As a result, byte-compiled files containing non-ASCII characters can't
495be read by earlier versions of Emacs. Files compiled by Emacs 20, 21,
16e82271
CY
496or 22 are loaded correctly as `emacs-mule' (whether or not they
497contain multibyte characters). This takes somewhat more time, so it
498may be worth recompiling existing .elc files which don't need to be
499shared with older Emacsen.
3ae459e5 500
09e18d03 501*** There are new coding systems/aliases; see M-x list-coding-systems.
c2e8590b 502
09e18d03
CY
503*** There is a new charset implementation with many new charsets.
504See M-x list-character-sets. New charsets can be defined conveniently
505as tables of unicodes.
1abe3a1e 506
09e18d03
CY
507*** There are new language environments for Chinese-GBK,
508Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
509Sinhala, and TaiViet.
16e82271 510
09e18d03
CY
511*** The minor modes unify-8859-on-encoding-mode and
512unify-8859-on-decoding-mode are obsolete.
16e82271 513
e94d0645
JL
514*** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
515accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
516decimal). It also accepts Unicode character names with completion.
16e82271 517
6d496c76
TZ
518*** The `cyrillic-translit' input method supports many new characters.
519Common typographical characters available from Unicode were added to
520`cyrillic-translit': punctuation marks, accented characters, fractions,
521and others.
522
09e18d03 523** Emacs now supports serial port access on GNU/Linux, Unix, and
81efacf9
CY
524Windows. The new command `serial-term' starts an interactive terminal
525on a serial port. The serial port can be configured at runtime with
526the mode-line mouse menu.
6c5d503f 527
09e18d03 528** Menu Bar changes
16e82271 529
09e18d03
CY
530*** In the Options menu, the "Set Default Font" item applies the
531selected font to the `default' face on all frames, not just the
532current frame. Furthermore, if Emacs is compiled with both GTK and
533Fontconfig support, the "Set Default Font" item uses the GTK font
534selection dialog instead of an Emacs pop-up menu.
16e82271 535
09e18d03
CY
536*** The font setting chosen by "Set Default Font" is saved if the
537"Save Options" item is used.
1b21ee06 538
b350bdf2
CY
539*** The Tools menu contains a new Encryption/Decryption submenu.
540This contains commands provided by EasyPG, the newly-included
541interface to GnuPG (see New Modes and Packages).
16e82271 542
81efacf9
CY
543*** In the Options menu, the "Truncate Long Lines in the Buffer" entry
544has been replaced with a submenu offering three different ways to
545handle long lines: truncation, continuation at the window edge, and
697f6b43 546the new word wrapping behavior (see Editing Changes, below).
16e82271 547
c1337511
DN
548*** Improvements to menus for major and minor modes
549More major and minor modes now have a mode specific menu, and existing
550mode menus have been improved to include more functionality.
551
09e18d03 552** Mode-line changes
16e82271 553
09e18d03
CY
554*** The mode-line displays a `@', instead of `-', if the
555default-directory for the current buffer is on a remote machine.
16e82271 556
09e18d03
CY
557*** The mode-line displays a mode menu when mouse-1 is clicked on a
558minor mode, in the same way as it already did for major modes.
16e82271 559
09e18d03
CY
560*** The `mode-line-emphasis' face is used to highlight certain
561mode-line information (e.g. waiting for a VC command to finish).
16e82271 562
c1337511 563*** The mode-line tooltips have been improved to provide more details.
16e82271 564
c1337511
DN
565*** The VC, line/colum number and minor mode indicators on the mode
566line are now interactive: mouse-1 can be used on them to pop up a menu.
567
b798e26a
GM
568** File deletion can make use of the Recycle Bin or system Trash folder.
569Set `delete-by-moving-to-trash' non-nil to use this. Deleted files
0956be4f 570and directories will then be sent to the Recycle Bin on Windows, and
b798e26a
GM
571to `trash-directory' on other systems.
572
09e18d03 573** Directory-local variables can now be defined.
fc0318c6
JL
574By default, Emacs looks in .dir-locals.el for directory-local
575variables. For more information, see `dir-locals-set-directory-class'
576and `dir-locals-set-class-variables'.
307f3501 577
b798e26a
GM
578** Emacs can now use `auth-source' for authentication.
579`smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
580login names and passwords. The match, if found, is reported
581in *Messages* with the password blanked out.
582
583** `where-is-preferred-modifier' can specify your favorite modifier.
584
6dadd99f 585\f
0bfd685e 586* Startup Changes in Emacs 23.1
21f7b9d8 587
3063e326
JL
588** The option `inhibit-startup-screen' (with aliases to old names
589`inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
590display of the initial message in the *scratch* buffer. If you don't
591want to display the initial message in the *scratch* buffer at startup,
592you can set the option `initial-scratch-message' to nil.
593
56e1896b
JL
594** New user option `initial-buffer-choice' specifies what to display
595after starting Emacs: startup screen, *scratch* buffer, visiting a
596file or directory.
597
aa5310e4
DK
598** New alias `argv' for `command-line-args-left'
599This is a convenience alias, so that one can write `(pop argv)'
600inside of --eval command line arguments in order to access
601following arguments.
f8fd7ed3
GM
602
603** The abbrev file is no longer read at startup in batch mode.
f36acfd9
EZ
604
605** Emacs now supports invocation by an X session manager.
606It can save a session and restore it later. See the documentation of
607the functions `emacs-session-save' and `emacs-session-restore'.
608(Actually, this feature was introduced with Emacs 22, but it was not
609documented.)
c44da964 610\f
0bfd685e 611* Incompatible Editing Changes in Emacs 23.1
b58cb59f 612
d1949cd5
JL
613** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
614on the regexp command prefix map.
615
117907d4
JL
616** In Dired-x, all command guesses for ! are now added to the default
617list accessible by M-n instead of pushing all guesses temporarily into
618the history list.
619
e94d0645
JL
620** In Isearch mode, a special case of typing `C-w' at the beginning of
621the minibuffer that toggles word search (i.e. using key sequences
622`C-s RET C-w' or `C-s M-e C-w') is obsolete. You can use the global key
623`M-s w' to start word search, or type `M-s w' in Isearch mode to
fd4c2a39
JL
624toggle word search. To start nonincremental word search you can now use
625`M-s w RET' and `M-s w C-r RET' instead of `C-s RET C-w' and `C-r RET C-w'.
e94d0645 626
45ad1cc5
JL
627** In Info, `Info-search' is unbound from `M-s' to allow using `M-s w'
628for word search as well as other search commands from the global prefix
629key `M-s'. `Info-search' is still bound to `s', and also incremental
630search commands `C-s', `C-M-s', `C-r', `C-M-r' are available for searching
631through multiple Info nodes, together with their nonincremental versions
632`C-s RET', `C-r RET', `C-M-s RET', `C-M-r RET', `M-s w RET'.
633
16e82271
CY
634** In Text mode, `center-line' and `center-paragraph' are rebound from
635`M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the global
636prefix map `M-o', which is intended for such formatting commands.
4e14951f 637
e405fa5f 638** The following input methods were removed in Emacs 22.2, but this was
9a930d75 639not advertised: danish-alt-postfix, esperanto-alt-postfix,
e405fa5f
RS
640finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
641norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
642and swedish-alt-postfix. Use the versions without "alt-", which are
643identical.
0b0914ae 644
406c0f12 645\f
0bfd685e 646* Editing Changes in Emacs 23.1
406c0f12 647
0c8b58e9
CY
648** The C-n and C-p line-motion commands now move by screen lines,
649taking continued lines and variable-width characters into account.
650Setting `line-move-visual' to nil reverts this to the previous
16e82271
CY
651behavior (i.e., motion by logical lines based on buffer contents
652alone).
0c8b58e9 653
09e18d03 654** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
16e82271 655invokes `suspend-frame'. These changes are for compatibility with the
09e18d03 656new multi-tty support (see `Improved X Window System support' above).
3ae459e5 657
09e18d03 658** Mark changes
16e82271 659
3ae459e5 660*** Transient Mark mode is now on by default.
16e82271 661
3ae459e5 662*** mark-even-if-inactive now defaults to t
16e82271 663
b350bdf2
CY
664*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
665activating it.
16e82271 666
3ae459e5
CY
667*** When Transient Mark mode is on, M-q now fills the region if the
668region is active. Otherwise, it fills the current paragraph.
16e82271 669
3ae459e5
CY
670*** When Transient Mark mode is on, M-$ now checks spelling of the
671region if the region is active. Otherwise, it checks spelling of the
dc868f13 672word at point.
16e82271 673
3ae459e5
CY
674*** When Transient Mark mode is on, TAB now indents the region if the
675region is active.
16e82271
CY
676
677*** The variable `use-empty-active-region' controls whether an empty
678active region in Transient Mark mode should make commands operate on
679that empty region.
3ae459e5
CY
680
681** Temporarily active regions
16e82271 682
3ae459e5
CY
683*** The new variable shift-select-mode, non-nil by default, controls
684shift-selection. When Shift Select mode is on, shift-translated
685motion keys (e.g. S-left and S-down) activate and extend a temporary
686region, similar to mouse-selection.
16e82271 687
3ae459e5
CY
688*** Temporarily active regions, created using shift-selection or
689mouse-selection, are not necessarily deactivated in the next command.
690They are only deactivated after point motion commands that are not
691shift-translated, or after commands that would ordinarily deactivate
692the mark in Transient Mark mode (e.g., any command that modifies the
693buffer).
694
3307af6c 695** Minibuffer and completion changes
16e82271 696
206faa92
CY
697*** Emacs may ask for confirmation before opening a non-existent file
698or buffer. By default, Emacs requests confirmation if you type RET
699immediately after TAB, and the resulting input is not an existing file
700or buffer; this usually happens when the minibuffer input did not
701complete far enough and you entered RET by mistake. In that case,
702Emacs puts the message "[Confirm]" in the minibuffer; type RET again
703to create the file or buffer.
704
705The new variable confirm-nonexistent-file-or-buffer determines whether
706Emacs asks for confirmation. The default value is `after-completion'.
707If you change it to t, Emacs always asks for confirmation; if you
708change it to nil, Emacs never asks for confirmation.
16e82271 709
aea75a87
CY
710*** The rules for performing completion have been changed.
711When generating completion alternatives, Emacs now takes the
712minibuffer text after point, if any, into account: this text is
713treated as a substring of the remaining part of the completion
714alternative (i.e., the part not matched by the minibuffer text before
715point). If no completion alternatives are found this way, Emacs
716attempts to perform partial-completion. If still no completion
717alternatives are found, we fall back on the Emacs 22 rules for
718performing completion.
719
720The new variable `completion-styles' can be customized to choose your
721favorite completion style.
16e82271 722
d47a29c1
JL
723*** When M-n in the minibuffer reaches the end of the list of defaults,
724it adds the completion list to the end, so next M-n continues putting
725completion items to the minibuffer. The same principle applies to
726incremental search commands as well: C-s or C-M-s starts searching
727the default values and after the end of defaults they continue
728searching minibuffer completion items.
16e82271 729
09e18d03 730*** Minibuffer input of shell commands now comes with completion.
16e82271 731
09e18d03
CY
732*** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
733name of the current buffer.
dc2f6c05 734
09e18d03
CY
735*** In the M-! (shell-command) prompt, M-n provides some default commands.
736These are guessed using the file extension of the current file, based
737on the file-handlers specified in the operating system's `mailcap'
738file. The ! command in Dired (dired-do-shell-command) works
739similarly, using the file displayed on the current line.
117907d4
JL
740
741*** A list of regexp default values is available via M-n for `occur',
742`keep-lines', `flush-lines' and `how-many'. This list includes the active
4f75e082
JL
743region in transient-mark-mode, the word under the cursor, the last Isearch
744regexp, the last Isearch string and the last replacement regexp.
16e82271 745
3353f870
CY
746*** When enable-recursive-minibuffers is non-nil, operations which use
747switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
748used in a minibuffer or a dedicated window. Instead, they fallback on
749using pop-to-buffer, which will use some other window. This change
750has no effect when enable-recursive-minibuffers is nil (the default).
16e82271 751
4f75e082
JL
752*** Isearch started in the minibuffer searches in the minibuffer history.
753Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer
754history elements, and forward Isearch commands (C-s, C-M-s) search in
297b8ccd
JL
755next history elements. When the reverse search reaches the first history
756element, it wraps to the last history element, and the forward search
757wraps to the first history element. When the search is terminated, the
758history element containing the search string becomes the current.
16e82271 759
6c897494
CY
760*** The variable read-file-name-completion-ignore-case overrides
761completion-ignore-case for file name completion.
16e82271 762
6c897494
CY
763*** The variable read-buffer-completion-ignore-case overrides
764completion-ignore-case for buffer name completion.
16e82271 765
3307af6c
CY
766*** The new command `minibuffer-force-complete' chooses one of the
767possible completions, rather than stopping at the common prefix.
16e82271 768
3307af6c
CY
769*** If `completion-auto-help' is `lazy', Emacs shows the completions
770buffer only on the second attempt to complete. This was already
771supported in `partial-completion-mode'.
6c897494 772
505d8756 773** Face changes
16e82271 774
b350bdf2
CY
775*** S-down-mouse-1 now pops up a menu for changing the font and text
776size of the default face in the current buffer. The face is changed
133c4dc5 777via face remapping (see Lisp changes, below).
16e82271 778
5f9e21a9
CY
779*** New commands to change the default face size in the current buffer.
780To increase it, type `C-x C-+' or `C-x C-='. To decrease it, type
781`C-x C--'. To restore the default (global) face size, type `C-x C-0'.
d59f7c45
CY
782These work via Text Scale mode, a new minor mode.
783
784The final key in the above commands may be repeated without the
785leading `C-x', e.g. `C-x C-= C-= C-=' increases the face height by
786three steps. Each step scales the height of the default face by the
787value of the variable `text-scale-mode-step'.
788
60959d23
CY
789*** The commands buffer-face-mode and buffer-face-set can be used to
790remap the default face in the current buffer. See "Buffer Face mode",
791under New Modes and Packages.
f20186fd 792
09e18d03 793** Primary selection changes
16e82271 794
b350bdf2
CY
795*** You can disable kill ring commands from accessing the primary
796selection by setting `x-select-enable-primary' to nil.
2e282009 797
697f6b43
CY
798** Continuation lines can now be wrapped at word boundaries
799(word-wrapping). This is controlled by the new per-buffer variable
800`word-wrap'. Word wrapping does not take place if continuation lines
801are not shown, e.g. if truncate-lines is non-nil. The most convenient
802way to enable word-wrapping is using the new minor mode Visual Line
803mode; in addition to setting `word-wrap' to t, this rebinds some
804editing commands to work on screen lines rather than text lines. See
805New Modes and Packages, below.
85b1de32 806
463c6766 807** Window management changes
16e82271 808
463c6766
CY
809*** truncate-partial-width-windows now accepts integer values, which
810specify a minimum window width for partial-width windows, below which
7d09b7a6 811lines are truncated. The default has been changed to 50.
463c6766
CY
812
813*** The new command balance-windows-area balances windows both
814vertically and horizontally.
16e82271 815
8f5cee6a
MR
816*** pop-to-buffer now always sets input focus when the popped-to window
817is on a different frame.
818
09e18d03 819** Miscellaneous changes:
16e82271 820
09e18d03
CY
821*** C-l is bound to the new command recenter-top-bottom, rather than recenter.
822This moves the current line to window center, top and bottom on
cdc0338e 823successive invocations.
16e82271 824
09e18d03 825*** scroll-preserve-screen-position also preserves the column position.
16e82271 826
09e18d03
CY
827*** If `yank-pop-change-selection' is t, rotating the kill ring also
828updates the selection or clipboard to the current yank, just as M-w
829would do so with the text it copies to the kill ring.
16e82271 830
09e18d03
CY
831*** C-M-% now shows replacement as it would look in the buffer, with
832`\N' and `\&' substituted according to the match. Old behavior can be
833restored by customizing `query-replace-show-replacement'.
834
835*** The command shell prompts for the default directory, when it is
836called with a prefix and the default directory is a remote file name.
837This is because some file name handlers (like ange-ftp) are not able to
838run processes remotely.
16e82271 839
09e18d03
CY
840*** The new command kill-matching-buffers kills buffers whose name
841matches a regexp.
16e82271 842
ae98e41f
CY
843*** The value of comment-style now defaults to `indent'.
844Thefore, comment-start markers are inserted at the current indentation
845of the region to comment, rather than the leftmost column.
16e82271 846
b350bdf2
CY
847*** The new commands `pp-macroexpand-expression' and
848`pp-macroexpand-last-sexp' pretty-print macro expansions.
16e82271 849
018a960d
EZ
850*** The new command `set-file-modes' allows to set file's mode bits.
851The mode bits can be specified in symbolic notation, like with GNU
e6979067
DN
852Coreutils, in addition to an octal number. `chmod' is a new
853convenience alias for this function.
d334fa1e 854
d2c52e26
EZ
855*** `next-error-recenter' specifies how next-error should recenter the
856visited source file. Its value can be a number (for example, 0 for
857top line, -1 for bottom line), or nil for no recentering.
16e82271 858
c594dbfa
CY
859*** When typing in a password in the echo area, C-y yanks the current
860kill into the password.
16e82271 861
e02ec85e
EZ
862*** Tooltip frame parameters `font' and `color' in `tooltip-frame-parameters'
863are ignored. Customize the `tooltip' face instead.
16e82271 864
53374291 865*** `mkdir' is a new convenience alias for `make-directory'.
09e18d03
CY
866\f
867* New Modes and Packages in Emacs 23.1
e11910e2
GM
868
869** Auto Composition Mode is a minor mode that composes characters
870automatically when they are displayed. It is globally on by default.
871It uses `auto-composition-function' (default `auto-compose-chars').
872
09e18d03 873** Bubbles, a new game, is similar to SameGame.
60959d23
CY
874
875** Buffer Face mode is a minor mode for remapping the default face in
876the current buffer. The variable `buffer-face-mode-face' specifies
877the face to remap to. The command `buffer-face-set' prompts for a
878face name, sets `buffer-face-mode-face' to it, and enables
879buffer-face-mode. See "Face changes", under Editing Changes, for a
880description of face remapping.
881
18e4b9bd
JL
882** butterfly flips the desired bit on the drive platter.
883See http://xkcd.com/378/
f6b26818 884
7ef39c6e
GM
885** bug-reference.el provides clickable links to bug reports.
886
09e18d03
CY
887** dbus.el provides D-Bus language bindings.
888D-Bus is an inter-process communication mechanism for applications
b350bdf2 889residing on the same host. See the manual for details.
09e18d03 890
85c78c0f 891** DocView mode allows viewing of PDF, PostScript and DVI documents.
b350bdf2
CY
892One can also search for a regular expression in the document. For
893details, see the commentary in doc-view.el.
09e18d03 894
4545a339
CY
895PDF and DVI files are now opened in Doc View mode by default.
896
897In Postcript mode, C-c C-c launches Doc View minor mode for viewing
898the postscript file.
5ed3edfa 899
b350bdf2
CY
900** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
901It includes a GnuPG keyring browser, cryptographic operations on
902regions and files, and automatic encryption of *.gpg files. For
903details, see the EasyPG Assistant User's Manual.
09e18d03
CY
904
905** json.el is a library for parsing and generating JSON
906(JavaScript Object Notation), a lightweight data-interchange format.
907
908** linum.el is a new minor mode to display line numbers for the
909current buffer.
910
4b4eb083
CY
911** mairix.el is an interface to mairix, a free tool for indexing and
912searching locally stored mail. It allows you to query mairix and
913display the search results with Rmail, Gnus and VM. Note that there
914is an existing Gnus back end, nnmairix.el, which should be used with
915Maildir/MH setups.
916
e94d0645 917** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
09e18d03
CY
918
919** nXML Mode
920This is a new mode for editing XML documents. It allows a schema to
921be associated with the XML document being edited, using Relax NG as
922the schema language. The schema is used to provide two key features:
923
924*** Continuous validation. nXML validates as you type, highlighting
925any invalid parts of your document.
926
927*** Completion. nXML can assist you in entering an element name,
928attribute name or data value by using information about what is
929allowed by the schema in that context.
930
efdd80c6
DN
931** proced.el provides a Dired-like interface for operating on
932processes. Proced makes an Emacs buffer containing a listing of the
933current processes. You can use the normal Emacs commands to move
934around in this buffer, and special Proced commands to operate on the
935processes listed. It is currently only functional on GNU/Linux,
936MS-Windows and Solaris.
09e18d03
CY
937
938** Remember Mode is a mode for jotting down things to remember.
939Notes can be saved to a Diary file. For details, see the Remember
940Manual.
941
b1c3a827 942** RST mode is a major mode for editing reStructuredText files.
c2d0b538 943
17a937cc
CY
944** Ruby mode is a major mode for Ruby files.
945
12f165e9
CY
946** Visual Line mode provides support for editing by visual lines.
947It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
948and C-k to commands that operate by visual lines instead of logical
949lines. This is a more reliable replacement for longlines-mode.
697f6b43
CY
950This can also be turned on using the menu bar, via
951Options -> Line Wrapping in this Buffer -> Word Wrap
12f165e9 952
0c68a24b
MA
953** xesam.el is an implementation of Xesam, an interface to (desktop)
954search engines like Beagle, Strigi, and Tracker. The Xesam API
955requires D-Bus for communication.
956
09e18d03
CY
957** zeroconf.el offers service discovery and service publishing
958interfaces according to the zeroconf specification. It communicates
959with Avahi, a zeroconf implementation, via D-Bus messages on systems
960which have installed this software.
961
d332a7a4
GM
962** There is a new `whitespace' package.
963(The pre-existing one has been renamed to `old-whitespace'.)
964Now, besides reporting bogus blanks, the whitespace package has a
965minor mode and a global minor mode to visualize blanks (TAB, (HARD)
966SPACE and NEWLINE). The visualization is made via faces and/or display
967table. It can also indicate lines that extend beyond a given column,
968trailing blanks, and empty lines at the start or end of a buffer.
969See `whitespace-style' for more details. The `whitespace-action' option
970specifies what to do when a buffer is visited, killed, or written.
4e5a8be9 971
09e18d03
CY
972\f
973* Changes in Specialized Modes and Packages in Emacs 23.1
974
975** Abbrev has been rewritten in Elisp and extended with more flexibility.
16e82271 976
e047f448 977*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
a3709a8c 978 abbrev-table-p, abbrev-insert, abbrev-table-menu.
16e82271 979
e047f448 980*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
16e82271 981
e047f448
SM
982*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
983 extra arguments for arbitrary properties.
16e82271 984
e047f448 985*** New variable `abbrev-minor-mode-table-alist'.
16e82271 986
e047f448 987*** `local-abbrev-table' can hold a list of abbrev-tables.
16e82271 988
e047f448 989*** Abbrevs have now the following special properties:
79415279 990 `:count', `:system', `:enable-function', `:case-fixed'.
16e82271 991
e047f448
SM
992*** Abbrev-tables have now the following special properties:
993 `:parents', `:case-fixed', `:enable-function', `:regexp',
994 `abbrev-table-modiff'.
995
09e18d03 996** Apropos
16e82271 997
09e18d03 998*** `apropos-library' describes the elements defined in a given library.
16e82271 999
09e18d03 1000*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
0253fffa 1001
09e18d03 1002** Archive Mode has basic support to browse Rar archives.
dfa2fb2a
CY
1003Note, however, that the free version of the unrar command only handles
1004versions 1 and 2 of the Rar format.
0253fffa 1005
09e18d03 1006** BibTeX mode
bafbec39 1007
09e18d03 1008*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
bafbec39 1009
09e18d03
CY
1010*** New `bibtex-entry-format' options `whitespace', `braces', and
1011`string', disabled by default.
12bbb989 1012
09e18d03
CY
1013*** New variable `bibtex-cite-matcher-alist' contains rules to
1014identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
9097e8af 1015
09e18d03 1016*** Command `bibtex-url' allows multiple URLs per entry.
4c24d241 1017
3aa8040c
KF
1018** Bookmarks
1019
1020*** bookmark.el saves bookmarks in a pre-Emacs-23-incompatible file format
1021bookmark.el can read a .emacs.bmk file saved by an older Emacs, but an
1022older Emacs cannot read one saved by Emacs 23.
1023
09e18d03 1024** Calendar and diary
320bc739 1025
09e18d03
CY
1026*** There is a new date style, `iso', essentially year/month/day.
1027The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
1028Similarly, the commands `american-calendar' and `european-calendar'
1029should be replaced by `calendar-set-date-style'.
c3bb6fdb 1030
09e18d03
CY
1031*** The calendar namespace has been rationalized.
1032All functions and variables now begin with a `calendar-', `diary-', or
1033`holiday-' prefix. The various calendar systems have secondary
1034prefixes, eg `calendar-french-'. The old names you are likely to use
1035directly still exist, for the time being, as aliases, but please start
1036using the new names.
1037
e889393b
GM
1038*** The whitespace in the calendar layout can be customized.
1039See the variables:
1040calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
1041calendar-day-header-width, and calendar-day-digit-width.
1042
1043*** Text (e.g. ISO weeks) can be displayed between the calendar months.
1044See the variables calendar-intermonth-header and calendar-intermonth-text.
1045
09e18d03
CY
1046*** The function `holiday-chinese' computes holidays on the Chinese calendar.
1047It has been used to add items to the list `holiday-oriental-holidays'.
1048
1049*** `diary-remind' accepts a negative number -DAYS as a shorthand for
1050the list (1 2 ... DAYS).
24cdde13 1051
a6b85944
CY
1052** Change Log mode
1053
1054*** The new command C-c C-f (change-log-find-file) finds the file
1055associated with the current log entry.
1056
1057*** The new command C-c C-c (change-log-goto-source) goes to the
1058source code associated with a log entry.
1059
76be286d 1060** Compile and grep modes
16e82271 1061
76be286d
DN
1062*** The mode-line entry for the *compilation* and *grep* buffer is color coded.
1063It has different colors for to show that: (a) the command is still
1064running, (b) successful completion, (c) error.
16e82271 1065
76be286d 1066*** compilation-auto-jump-to-first-error tells `compile' to jump to
813fb3fe 1067the first error encountered during compilations.
16e82271 1068
194894cb
CY
1069*** compilation-scroll-output accepts a new value, `first-error', which
1070says to stop auto scrolling at the first error that occurs.
16e82271 1071
0b22a5e1 1072*** The `cc' alias for C++ files in `grep-file-aliases' has been
2e538385 1073improved. `hh' can be used to match C++ header files and `cchh' both
0b22a5e1
DN
1074C++ sources and headers.
1075
d332a7a4
GM
1076** Copyright
1077
1078*** You can specify your copyright holders' names.
1079Only copyright lines with holders matching `copyright-names-regexp' are
1080considered for update.
1081
1082*** Copyrights can be at the end of the buffer.
1083This is controlled by `copyright-at-end-flag' (used by, e.g., change-log-mode).
1084
09e18d03 1085** Custom
16e82271 1086
09e18d03 1087*** defcustom accepts new keyword arguments, `:safe' and `:risky', which
b68769f2
GM
1088set a variable's `safe-local-variable' and `risky-local-variable' property.
1089
09e18d03 1090** Diff mode
16e82271 1091
09e18d03
CY
1092*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
1093It's used automatically as you move through hunks, see
7381be9d 1094diff-auto-refine-mode. It is bound to `C-c C-b'.
16e82271 1095
09e18d03
CY
1096*** diff-add-change-log-entries-other-window iterates through the diff
1097buffer and tries to create ChangeLog entries for each change.
1098It is bound to `C-x 4 A'.
16e82271 1099
ac7020b3
DN
1100*** Turning on `whitespace-mode' in a diff buffer will show trailing
1101whitespace problems in the modified lines.
d332a7a4 1102
71554a21 1103** Dired
16e82271 1104
71554a21
JL
1105*** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
1106and C-x C-q in wdired-mode exits it with asking a question about
1107saving changes.
16e82271 1108
d1949cd5
JL
1109*** `&' runs the command `dired-do-async-shell-command' that executes
1110the command asynchronously without the need to manually add ampersand
1111to the end of the command. Its output appears in the buffer `*Async Shell
1112Command*'.
16e82271 1113
6d9f0d00 1114*** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names.
2cb5f8ed
JL
1115When a new user option `dired-isearch-filenames' is t, then even ordinary
1116Isearch started with `C-s' and `C-M-s' matches only at file names in the
1117Dired buffer. When `dired-isearch-filenames' is `dwim' then activation of
1118file name Isearch depends on the position of point - if point is on a file
1119name initially, then Isearch matches only file names, otherwise it matches
1120everywhere in the Dired buffer. You can toggle file names matching on or
1121off by typing `M-s f' in Isearch mode.
16e82271 1122
cc3236e1
JL
1123*** `M-s a C-s' and `M-s a M-C-s' run multi-file Isearch on the marked files.
1124They visit the first marked file in the sequence and display the usual Isearch
1125prompt for a string or a regexp where all Isearch commands are available.
16e82271 1126
71554a21
JL
1127*** `Q' in Dired provides two new keys for multi-file replacement.
1128The upper case key `Y' replaces all remaining matches in all remaining files
1129with no more questions. The upper case key `N' stops doing replacements
1130in the current file and skips to the next file. These multi-file keys
1131are available for all commands that use `tags-query-replace'
1132including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
1133`reftex-query-replace-document'.
1134
09e18d03 1135** Fortran
16e82271 1136
77a00355
GM
1137*** The line length of fixed-form Fortran is not fixed at 72 any more.
1138Customize the variable `fortran-line-length' to change it.
117d3cc5 1139
09e18d03
CY
1140*** In Fortran mode, M-; is now bound to the standard comment-dwim,
1141rather than fortran-indent-comment.
76be286d 1142
09e18d03 1143*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
b592c357 1144
09e18d03 1145** Gnus
6653c6b7 1146
09e18d03
CY
1147*** The Gnus package has been updated
1148There are many news features, bug fixes and improvements; see the file
1149GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
db86064f 1150
09e18d03
CY
1151*** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
1152saving articles drafts and ~/.newsrc.eld. These file may not be read
1153correctly in Emacs 22 and below. If you want to Gnus across different Emacs
1154versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
15947a44 1155
540f3092 1156*** Passwords are consistently loaded through `auth-source'
6d496c76
TZ
1157Gnus can use `auth-source' for POP and IMAP passwords. Also see that
1158`smtpmail' and `url' support `auth-source' for SMTP and HTTP/HTTPS/RSS
1159authentication respectively.
1160
09e18d03 1161** Help mode
16e82271 1162
09e18d03
CY
1163*** New macro `with-help-window' should set up help windows better
1164than `with-output-to-temp-buffer' with `print-help-return-message'.
8f5cee6a 1165
09e18d03
CY
1166*** New option `help-window-select' permits to customize whether help
1167window shall be automatically selected when invoking help.
8f5cee6a 1168
540f3092
GM
1169*** New variable `help-window-point-marker' permits one to specify a new
1170position for point in help window (for example in `view-lossage').
15947a44 1171
09e18d03 1172** Isearch
16e82271 1173
4f75e082
JL
1174*** New command `isearch-forward-word' bound globally to `M-s w' starts
1175incremental word search. New command `isearch-toggle-word' bound to the
1176same key `M-s w' in Isearch mode toggles word searching on or off
1177while Isearch is active.
1178
1179*** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch
1180mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current
1181search string as its regexp argument. The same key `M-s h r' and
1182other keys on the `M-s h' prefix are bound globally to the command
1183`highlight-regexp' and other hi-lock commands.
16e82271 1184
4f75e082
JL
1185*** New command `isearch-occur' bound to `M-s o' in Isearch mode
1186runs `occur' with the current search string. The same key `M-s o'
1187is bound globally to the command `occur'.
16e82271 1188
4f75e082
JL
1189*** Isearch can now search through multiple ChangeLog files.
1190When running Isearch in a ChangeLog file, if the search fails,
09e18d03 1191then another C-s tries searching the previous ChangeLog,
540f3092 1192if there is one (e.g. going from ChangeLog to ChangeLog.12).
babc4609 1193This is enabled if multi-isearch-search is non-nil.
93a142e1 1194
babc4609 1195*** Two new commands to start Isearch on a list of marked buffers
cc3236e1
JL
1196for buff-menu.el and ibuffer.el are bound to the keys `M-s a C-s' and
1197`M-s a M-C-s'.
16e82271 1198
3c241617
CY
1199*** The part of an Isearch that failed to match is highlighted in
1200`isearch-fail' face.
5d503af9 1201
4f75e082
JL
1202*** `C-h C-h' in Isearch mode displays isearch-specific Help screen,
1203`C-h b' displays all Isearch key bindings, `C-h k' displays the full
1204documentation of the given Isearch key sequence, `C-h m' displays
1205documentation of Isearch mode. All the rest Help commands exit Isearch mode
09e18d03 1206and execute their global definitions.
16e82271 1207
09e18d03
CY
1208*** When started in the minibuffer, Isearch searches in the minibuffer
1209history. See `Minibuffer changes', above.
2793c9bb 1210
66863844 1211** MH-E
1e9b0fb2 1212
d1d87851 1213*** Upgraded to MH-E version 8.2. See MH-E-NEWS for details.
66863844 1214
09e18d03
CY
1215** Python
1216*** The file etc/emacs.py now supports both Python 2 and 3, meaning
1217that either version can be used as inferior Python by python.el.
c5578d5f 1218
09e18d03
CY
1219*** Python mode now has `pdbtrack' functionality. When using pdb to
1220debug a Python program, pdbtrack notices the pdb prompt and displays
1221the source file and line that the program is stopped at, much the same
1222way as gud-mode does for debugging C programs with gdb.
2793c9bb 1223
1e9b0fb2
MA
1224** Recentf
1225
1226*** The default value of `recentf-keep' prevents from checking of
1227remote files, if there is no established connection to the
1228corresponding remote host.
1229
2d51ab64
GM
1230** Rmail
1231
b55b134f 1232*** Rmail no longer converts the messages to Babyl format.
33b43245
GM
1233Instead, it uses UNIX mbox format, both on disk and in Rmail buffers,
1234and does conversion and decoding when a message is displayed.
b55b134f 1235
33b43245 1236The first time you visit an Rmail file in Babyl format, Rmail
b55b134f
EZ
1237automatically converts it to mbox format. This is a one-time
1238conversion, but it can take a few minutes, depending on how fast is
1239your machine and on the size of the file. You should find the rest of
1240Rmail usage unaltered.
1241
80d634b8
RS
1242However, M-x set-rmail-inbox-list now lasts only for one session
1243because there is no way to save the list of inbox files in an
1244mbox-format file.
1245
329a643c
GM
1246Also, whereas with Babyl format M-x find-file would switch to Rmail
1247mode, with mbox format this is no longer the case (there being no way
bcf3f1f5
GM
1248to add an "-*- rmail-*-" cookie to an mbox file). Use C-u M-x rmail
1249instead.
329a643c 1250
33b43245
GM
1251If you have written any extensions to Rmail, they are likely to need
1252updating. Conceptually, the Rmail buffer that you see is no longer
1253just a narrowed portion of the whole. So you cannot access the whole
1254of a message (or message collection) by a simple save-restriction and
1255widen. Instead, there are two buffers: the rmail-buffer, and the
2e538385 1256rmail-view-buffer. The former is the buffer that you see, the latter
33b43245
GM
1257is invisible. Most of the time, the invisible `view' buffer contains
1258the full contents of the Rmail file, and the Rmail buffer contains a
1259decoded copy of the current message (with only a subset of the
2e538385 1260headers). In this state, Rmail is said to be `swapped'.
2d51ab64 1261
33b43245
GM
1262You may find the following functions useful:
1263
1264`rmail-get-header' and `rmail-set-header' get or set the value of a
1265message header, whether or not it is currently visible.
1266
1267`rmail-apply-in-message' is a general purpose function that calls a
1268function (with arguments) which you specify on the full text of a given
1269message. To further narrow to just the headers, search forward for "\n\n".
1270
33b43245 1271*** The new command `rmail-mime' displays MIME messages.
2e538385 1272It is bound to `v' in Rmail buffers and summaries. It displays plain
33b43245
GM
1273text and multipart messages in a temporary buffer, and offers buttons
1274to save attachments.
1275
763e01c4
EZ
1276*** The command `rmail-redecode-body' no longer accepts the optional arg RAW.
1277Since Rmail now holds messages in their original undecoded form in a
1278separate buffer, `rmail-redecode-body' no longer encodes the original
1279message, and therefore there should be no need to avoid encoding it.
1280
80d634b8
RS
1281*** The o command is now `rmail-output'. It is an all-purpose command
1282for copying messages from Rmail and appending them to files. It
1283handles Babyl-format files as well as mbox-format files, and it
1284handles both kinds properly when they are visited in Emacs. It always
1285copies the full headers of the message.
1286
80d634b8
RS
1287*** The C-o command is now `rmail-output-as-seen'. It uses
1288the message as displayed, appending it to an mbox file.
1289
2e538385
GM
1290*** The modified status of the Rmail buffer is reported in the mode-line.
1291Previously, this information was hidden.
1292
9721264a 1293** TeX modes
16e82271 1294
9721264a
MR
1295*** New option latex-indent-within-escaped-parens
1296permits to customize indentation of LaTeX environments delimited
1297by escaped parens.
1298
09e18d03 1299** T-mouse Mode
16e82271 1300
09e18d03
CY
1301*** If the gpm mouse server is running and t-mouse-mode is enabled,
1302Emacs uses a Unix socket in a GNU/Linux console to talk to server,
1303rather than faking events using the client program mev. This C level
1304approach provides mouse highlighting and help echoing in the
1305minibuffer.
2793c9bb 1306
cc213f24
MA
1307** Tramp
1308
1309*** New connection methods.
1310The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
1311been introduced. There are also new so-called gateway methods
1312"tunnel" and "socks".
1313
cc2fc5a2
MA
1314*** IPv6 addresses.
1315IPv6 addresses are supported now as host names. They must be embedded
1316in square brackets, like in "/ssh:[::1]:".
1317
cc213f24 1318*** Multihop syntax has been removed.
540f3092 1319The pseudo-method "multi" has been removed. Instead, multi hops
cc213f24
MA
1320can be specified by the new variable `tramp-default-proxies-alist'.
1321
1322*** More default settings.
1323Default values can be set via the variables `tramp-default-user',
1324`tramp-default-user-alist' and `tramp-default-host'.
1325
1326*** Connection information is cached.
1327In order to reduce connection setup, information about used
540f3092 1328connections is kept persistently in a file. The name of this file is
cc213f24
MA
1329defined in the variable `tramp-persistency-file-name'.
1330
1331*** Control of remote processes.
1332Running processes on a remote host can be controlled by settings in
1333`tramp-remote-path' and `tramp-remote-process-environment'.
1334
1335*** Success of remote copy is checked.
1336When the variable `file-precious-flag' is set, the success of a remote
1337file copy is checked via the file's checksum.
1338
7cba69f2
MA
1339*** Passwords can be read from an authentification file.
1340Tramp uses the package `auth-source' to read passwords from a file, if
1341necessary.
1342
289aee1c 1343** VC and related modes
16e82271 1344
09e18d03
CY
1345*** VC now supports applying VC operations to a set of files at a time.
1346This enables VC to work much more effectively with changeset-oriented
1347version-control systems such as Subversion, GNU Arch, Mercurial, Git
1348and Bzr. VC will now pass a multiple-file commit to these systems as
1349a single changeset.
16e82271 1350
09e18d03 1351*** vc-dir is a new command that displays file names and their VC
289aee1c
DN
1352status. It allows to apply various VC operations to a file, a
1353directory or a set of files/directories.
16e82271 1354
614677a0
GM
1355*** VC switches are no longer appended, rather the first non-nil value is used.
1356(This was for the most part true in Emacs 22, but was not advertised).
1357This is because there is an increasing variety of VC systems, and they
1358do not all accept the same "common" options. For example, a CVS diff
1359command used to append the values of `vc-cvs-diff-switches',
1360`vc-diff-switches', and `diff-switches'. Now the first non-nil value
1361from that sequence is used. The special value `t' means "no switches".
16e82271 1362
09e18d03 1363*** Clicking on the VC mode-line entry now pops the VC menu.
16e82271 1364
09e18d03 1365*** The VC mode-line entry now has a tooltip that explains the VC file status.
2b69181c
DN
1366
1367*** In VC Annotate mode, the key bindings have changed to use lower
1368case keys instead of the upper case keys used in the past.
16e82271 1369
09e18d03
CY
1370*** In VC Annotate mode, for VC systems that support changesets, you can
1371see the diff for the whole changeset (not only for the current file)
ee0f0556
CY
1372by typing the D key. Using the "Show changeset diff of revision at
1373line" menu entry does the same thing.
16e82271 1374
e86fa02b 1375*** In VC Annotate mode, you can type v to toggle the annotation visibility.
16e82271 1376
09e18d03
CY
1377*** In VC Annotate mode, you can type f to show the file revision on
1378the current line.
16e82271 1379
09e18d03
CY
1380*** Asynchronous VC commands display [Waiting...] in the mode-line
1381of the corresponding buffer as long as the asynchronous process is
1382active.
16e82271 1383
09e18d03
CY
1384*** Log entries can be modified using the key "e" in log-view.
1385For now only CVS, RCS, SCCS and SVN support this functionality.
1386This is done by the `modify-change-comment' backend function.
16e82271 1387
09e18d03
CY
1388*** In log-view-mode, for VC systems that support changesets, you can
1389see the diff for the whole changeset (not only for the current file)
1390by typing the D key or using the "Changeset Diff" menu entry.
16e82271 1391
289aee1c
DN
1392*** In Log Edit mode, C-c C-d now shows the diff for the files involved.
1393
1394*** vc-git supports the "git grep" command.
16e82271 1395
540f3092 1396*** VC Support for Meta-CVS has been removed for lack of a maintainer able
09e18d03 1397to update it to the new VC.
cf944fa4 1398
d15f7b68
GM
1399** Miscellaneous
1400
1401*** comint-mode uses `start-file-process' now (see Lisp Changes).
cc213f24
MA
1402If `default-directory' is a remote file name, subprocesses are started
1403on the corresponding remote system.
16e82271 1404
09e18d03
CY
1405*** Eldoc highlights the function argument under point
1406with the face `eldoc-highlight-function-argument'.
16e82271 1407
09e18d03 1408*** In Etags, the --members option is now the default.
fffa137c 1409Use --no-members if you want the old default behavior of not tagging
09e18d03 1410struct members in C, members variables in C++ and variables in PHP.
16e82271 1411
09e18d03
CY
1412*** The `gdb' command only works with the graphical interface now.
1413Use `gud-gdb' if you want the (old) text command mode.
1414
1415*** goto-address.el provides two new minor modes, goto-address-mode and
1416goto-address-prog-mode, which buttonize URLS and email addresses.
1417
1418*** The new command `eshell/info' runs info in an eshell buffer.
3cf86f00 1419
4d1e89e3
GM
1420*** The new variable `ffap-rfc-directories' specifies a list of local
1421directories in which `ffap-rfc' will first search for RFCs.
16e82271 1422
09e18d03
CY
1423*** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
1424See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
1425
1426*** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
1427
1428*** Info displays breadcrumbs in the header of the page.
1429See Info-breadcrumbs-depth to control it.
1430
d2c98acc 1431*** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
b7bfcc8a 1432It is used to configure wireless interfaces.
d2c98acc 1433
09e18d03
CY
1434*** The pcmpl-unix package supports hostname completion for ssh and scp.
1435
1436*** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
1437
1438*** smerge-refine highlights word-level details of changes in conflict.
7381be9d
TTN
1439It's used automatically as you move through conflicts, see
1440smerge-auto-refine-mode.
09e18d03
CY
1441
1442*** talk.el has been extended for multiple tty support.
1443
1444*** A new command `display-time-world' has been added to the Time
1445package. It creates a buffer with an updating time display using
1446several time zones.
1447
1448*** The appearance of superscript and subscript in TeX is more customizable.
1449See the documentation of the variables: tex-fontify-script,
1450tex-font-script-display, tex-suscript-height-ratio, and
1451tex-suscript-height-minimum.
1452
1453*** view-remove-frame-by-deleting is now by default t
1454since users found iconification of view-mode frames distracting.
16e82271 1455
09e18d03
CY
1456*** WoMan tries to add locale-specific manual page directories to the
1457search path. This can be disabled by setting `woman-locale' to nil.
1458
0bfd685e
GM
1459\f
1460* Changes in Emacs 23.1 on non-free operating systems
8ab314f9 1461
203553fd
JPW
1462** Case is now considered significant in completion on MS-Windows.
1463The default value of `completion-ignore-case' is now nil on
1464MS-Windows, the same as it is for other operating systems. The
1465variable doesn't apply to reading a file name -- in that case Emacs
1466heeds `read-file-name-completion-ignore-case' instead.
1467
672f99b6
JR
1468** IPv6 is supported on MS-Windows.
1469Emacs now supports IPv6 on Windows XP and later, and earlier versions
2660a9da 1470of Windows with third party IPv6 stacks installed. In Emacs 22, IPv6 was
672f99b6
JR
1471supported on other platforms, but not on Windows due to using the winsock
14721.1 header file, even though Emacs was linking to the winsock 2 library.
1473
6e344060
JR
1474** Busy cursor (hourglass) now displays on MS-Windows.
1475When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
2660a9da
JR
1476In Emacs 22 only X supported the busy cursor.
1477
2660a9da
JR
1478** Battery status is available on MS-Windows
1479Emacs can now display the battery status in the mode-line when enabled with
1480display-battery-mode or from the Options menu. More verbose battery
1481information is also available with the command `battery'. In Emacs 22
1482battery status was supported only on GNU/Linux and Mac.
6e344060 1483
3280c5c5
JR
1484** More keys available on MS-Windows.
1485Keys normally associated with IMEs, and some exotic keys not normally found
1486on standard keyboards have been given names so they can be bound to functions
1487inside Emacs. If there are keys on your keyboard that have not been exposed
1488to Emacs in the past, try C-h k to see if they are available now.
1489
1490Emacs can now bind functions to the extra buttons for media player and
1491browser control present on some keyboards. These buttons are disabled
1492by default, since enabling them prevents their system-wide use when
1493Emacs has focus. To enable them, set the variable
0caa490b 1494w32-pass-multimedia-buttons to nil. See the doc string of that variable
3280c5c5 1495for the list of extra keys that are available.
2660a9da 1496
4a263588 1497** BDF fonts no longer supported on MS-Windows.
2e538385 1498The font backend was completely rewritten for this release. The focus
4a263588
JR
1499on Windows has been getting acceptable performance and full unicode
1500support, including complex script shaping for native Windows fonts. A
1501rewrite of the BDF font support has not happened due to lack of time
1502and developers. If demand still exists for such a backend even with
1503the improved language support for native Windows fonts, future
1504development in this direction will most likely be based on the
1505freetype library, giving access to a wider range of font formats.
1506
0bfd685e
GM
1507\f
1508* Incompatible Lisp Changes in Emacs 23.1
8ec65cd7 1509
fd9440c5 1510** Variables cannot be both buffer-local and frame-local any more.
a9b08254 1511
fc944cd4 1512** `functionp' returns nil for special forms.
65f81a0b 1513I.e., it only returns t for objects that can be passed to `funcall'.
fc944cd4 1514
d82c3d44
GM
1515** The behavior of map-char-table has changed. It may call the
1516specified function with a cons (FROM . TO) as a key if characters in
1517that range have the same value.
1518
b350bdf2 1519** Process changes
16e82271 1520
b350bdf2 1521*** The function `dired-call-process' has been removed.
16e82271 1522
b350bdf2
CY
1523*** The multibyteness of process filters is now determined by the
1524coding-system used for decoding. The functions
1525`process-filter-multibyte-p' and `set-process-filter-multibyte' are
1526obsolete.
03605a28 1527
777ea444 1528** The variable `byte-compile-warnings' can now be a list starting with `not',
0caa490b 1529meaning to disable the specified warnings. The meaning of this list
777ea444 1530may therefore be the reverse of what you expect (of course, this is
0caa490b 1531only an issue if you make use of the new `not' syntax). Rather than
777ea444
GM
1532checking/manipulating elements directly, use the new functions
1533`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
1534`byte-compile-enable-warning.'
1535
69df9d6d
GM
1536** `mode-name' is no longer guaranteed to be a string.
1537Use `(format-mode-line mode-name)' to ensure a string value.
1538
53ed745a
CY
1539** The function x-font-family-list has been removed.
1540Use the new function font-family-list (see Lisp Changes, below).
1541
b350bdf2
CY
1542** Internationalization changes
1543
1544*** The value of the function `charset-id' is now always 0.
16e82271 1545
b350bdf2
CY
1546*** The functions `register-char-codings' and `coding-system-spec'
1547have been removed.
16e82271 1548
b350bdf2
CY
1549*** The cpXXX coding systems are now supported automatically.
1550The functions cp-...-codepage, which you had to use in Emacs 22 to
1551enable support for these coding systems, have been deleted.
16e82271 1552
b350bdf2 1553*** The following features have been removed. They were used for
85a1f98d
GM
1554displaying various scripts with specific fonts, and are no longer
1555needed now that OpenType font support is available:
1556
b350bdf2 1557**** `devanagari' and `devan-util', and all associated devanagari-* and
85a1f98d
GM
1558dev-* functions and variables (formerly used for Devanagari script).
1559
b350bdf2 1560**** `kannada' and `knd-util', and all associated kannada-* and knd-*
85a1f98d
GM
1561functions and variables (formerly used for Kannada script).
1562
b350bdf2 1563**** `malayalam' and `mlm-util', and all associated malayalam-* and
85a1f98d
GM
1564mlm-* functions and variables (formerly used for Malayalam script).
1565
b350bdf2 1566**** `tamil' and `tml-util, and all associated tamil-* and tml-*
85a1f98d 1567functions and variables (formerly used for Tamil script).
6a6b4d7d 1568
2d2db320
KH
1569*** The meaning of NAME argument of `set-fontset-font' is changed.
1570Previously nil is accepted as the default fontset. Now, nil is for
1571the fontset of the selected frame and t is for the default fontset.
1572
1573*** The meaning of FONTSET argument of `print-fontset' is changed.
1574Now, nil is for the fontset of the selected frame and t is for the
1575default fontset.
1576
16e82271
CY
1577** If a function in write-region-annotate-functions returns with a
1578different buffer current, Emacs no longer kills that buffer
1579automatically. This behavior existed in previous versions of Emacs,
1580but was undocumented. To kill a buffer after write-region, give the
1581variable `write-region-post-annotation-function' a buffer-local value
1582of `kill-buffer'.
1583
55504ada 1584** The variable temp-file-name-pattern has been removed.
f4150f61
CY
1585This variable was only used by call-process-region, which now uses
1586temporary-file-directory instead.
1587
52456e59
CY
1588** The COUNT and SYSTEM-FLAG arguments to define-abbrev have been
1589removed. The function now takes extra arguments for specifying
1590arbitrary abbrev properties.
1591
7841339b
AM
1592** end-of-defun-function is now guaranteed to work only when called
1593from the start of a defun. It must now leave point exactly at the end
1594of defun, since `end-of-defun' now itself moves forward over
1595whitespace after calling it.
1596
0bfd685e
GM
1597\f
1598* Lisp Changes in Emacs 23.1
8ab314f9 1599
b8afe7e4
EZ
1600** The new variable `generate-autoload-cookie' controls the magic comment
1601string used by `update-file-autoloads' to find autoloaded forms. The
1602variable `generated-autoload-file' similarly controls the name of the
1603file where `update-file-autoloads' writes the calls to `autoload'.
1604The default values are ";;;###autoload" and `loaddefs.el',
1605respectively.
1606
a20878b6 1607** New primitives `list-system-processes' and `process-attributes'
5d692341
EZ
1608let Lisp programs access the processes that are running on the local
1609machine. See the doc strings of these functions for more details.
1610Not all platforms support accessing this information; on those that
1611don't, these primitives will return nil.
1612
b350bdf2
CY
1613** New variable `user-emacs-directory'.
1614Use this instead of "~/.emacs.d".
43f8b275 1615
b350bdf2
CY
1616** If a local hook function has a non-nil `permanent-local-hook'
1617property, `kill-all-local-variables' does not remove it from the local
1618value of the hook variable; it remains even if you change major modes.
09e18d03 1619
b350bdf2
CY
1620** `frame-inherited-parameters' lets new frames inherit parameters from
1621the selected frame.
09e18d03 1622
b350bdf2
CY
1623** New keymap `input-decode-map' overrides like key-translation-map, but
1624applies before function-key-map. Also it is terminal-local contrary to
1625key-translation-map. Terminal-specific key-sequences are generally added to
1626this map rather than to function-key-map now.
09e18d03 1627
b350bdf2 1628** `ignore-errors' is now a standard macro (does not require the CL package).
09e18d03 1629
b350bdf2
CY
1630** `interprogram-paste-function' can now return one string or a list
1631of strings. In the latter case, Emacs puts the second and following
1632strings on the kill ring.
09e18d03 1633
b350bdf2
CY
1634** In `condition-case', a handler can specify "let the debugger run first".
1635You do this by writing `debug' in the list of conditions to be handled,
1636like this:
09e18d03 1637
b350bdf2
CY
1638 (condition-case nil
1639 (foo bar)
1640 ((debug error) nil))
09e18d03 1641
b350bdf2 1642** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
09e18d03 1643
7841339b
AM
1644** `beginning-of-defun-function' now takes one argument, the count given to
1645`beginning-of-defun'. (N.B. `end-of-defun-function' doesn't take any
1646arguments.)
09e18d03 1647
b350bdf2
CY
1648** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
1649IDENTIFICATION specifies which part of the remote identifier has to be
1650returned. With CONNECTED passed non-nil, it is checked whether a
1651remote connection has been established already.
09e18d03 1652
b350bdf2
CY
1653** The new macro `declare-function' suppresses compiler warnings about
1654undefined functions.
a1562258 1655
b350bdf2 1656** Changes to interactive function handling
8ba31f36 1657
b350bdf2
CY
1658*** The new interactive spec code ^ says to first call
1659handle-shift-selection if shift-select-mode is non-nil, before reading
1660the command arguments. This is used for shift-selection (see above).
e2947429 1661
b350bdf2
CY
1662*** Built-in functions can now have an interactive specification that
1663is not a prompt string. If the `intspec' parameter of a `DEFUN'
1664starts with a `(', the string is evaluated as a Lisp form.
e2947429 1665
b350bdf2
CY
1666*** The interactive-form of a function can be added post-facto via the
1667`interactive-form' symbol property. Mostly useful to add complex
1668interactive forms to subroutines.
d87be1df 1669
b350bdf2 1670** Region changes
3ae459e5 1671
b350bdf2
CY
1672*** Commands should use `use-region-p' to test whether there is
1673an active region that they should operate on.
3ae459e5 1674
b350bdf2 1675*** `region-active-p' returns non-nil when Transient Mark mode is
71b605b8
CY
1676enabled and the mark is active. Most commands that act specially on
1677the active region in Transient Mark mode should use `use-region-p'
1678instead of `region-active-p', because `use-region-p' obeys the new
1679user option `use-empty-active-region' (see Editing Changes, above).
58555d81 1680
b350bdf2
CY
1681*** If a command sets `transient-mark-mode' to (only . OLDVAL), that
1682means to activate transient-mark-mode temporarily, until the next
1683unshifted point motion command or mark deactivation. Afterwards,
1684reset transient-mark-mode to the value OLDVAL. The values `only' and
1685`identity', introduced in Emacs 22, are now deprecated.
e5c4079c 1686
b350bdf2 1687** Emacs session information
13cda5f9 1688
b350bdf2
CY
1689*** The new variables `before-init-time' and `after-init-time' record the
1690value of `current-time' before and after Emacs loads the init files.
a2bc5bdd 1691
b350bdf2 1692*** The new function `emacs-uptime' returns the uptime of an Emacs instance.
d82c3d44 1693
b350bdf2
CY
1694*** The new function `emacs-init-time' returns the duration of the
1695Emacs initialization.
50bfa18a 1696
b350bdf2 1697** Changes affecting display-buffer
16e82271 1698
abe8f306
MR
1699*** display-buffer tries to be smarter when splitting windows.
1700The new option split-window-preferred-function lets you specify your own
1701function to pop up new windows. Its default value split-window-sensibly
1702can split a window either vertically or horizontally, whichever seems
1703more suitable in the current configuration. You can tune the behavior
1704of split-window-sensibly by customizing split-height-threshold and the
1705new option split-width-threshold. Both options now take the value nil
1706to inhibit splitting in one direction. Setting split-width-threshold to
1707nil inhibits horizontal splitting and gets you the behavior of Emacs 22
1708in this respect. In any case, display-buffer may now split the largest
1709window vertically even when it is not as wide as the containing frame.
2d105adf 1710
f691c216
CY
1711*** If pop-up-frames has the value `graphic-only', display-buffer only
1712makes a separate frame on graphic displays.
1713
abe8f306 1714*** select-frame and set-frame-selected-window have a new optional
ee434cb1
MR
1715argument NORECORD. If non-nil, this will avoid messing with the order
1716of recently selected windows and the buffer list.
205f3a3b 1717
781459a4
CY
1718** Window parameters can now be defined.
1719These are analogous to frame parameters, but are associated with
1720individual windows.
16e82271 1721
781459a4
CY
1722*** The new functions window-parameters, window-parameter, and
1723set-window-parameter are used to query and set window parameters.
1724
b350bdf2 1725** Minibuffer and completion changes
16e82271 1726
b350bdf2 1727*** A list of default values can be specified for the DEFAULT argument of
b9694062
JL
1728functions `read-from-minibuffer', `read-string', `read-command',
1729`read-variable', `read-buffer', `completing-read'. Elements of this list
1730are available for inserting into the minibuffer by typing `M-n'.
1731For empty input these functions return the first element of this list.
1732
90993beb 1733*** New function `read-regexp' uses the regexp history and some useful
4f75e082 1734regexp defaults (string at point, last Isearch/replacement regexp/string)
90993beb
JL
1735via M-n when reading a regexp in the minibuffer.
1736
b350bdf2
CY
1737*** minibuffer-local-must-match-filename-map is now named
1738minibuffer-local-filename-must-match-map.
66dc1ca2 1739
206faa92
CY
1740*** The `require-match' argument to `completing-read' accepts the new
1741values `confirm-only' and `confirm-after-completion'.
d03b9b31 1742
b350bdf2 1743** Search and replacement changes
16e82271 1744
b350bdf2 1745*** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
16e82271 1746
b350bdf2
CY
1747*** New function `match-substitute-replacement' returns the result of
1748`replace-match' without actually using it in the buffer.
c60d543d 1749
b350bdf2 1750*** The new variable `replace-search-function' determines the function
80120f13
EZ
1751to use for searching in query-replace and replace-string. The
1752function it specifies is called by `perform-replace' when its 4th
1753argument is nil.
3ae459e5 1754
b350bdf2
CY
1755*** The new variable `replace-re-search-function' determines the
1756function to use for searching in `query-replace-regexp',
1757`replace-regexp', `query-replace-regexp-eval', and
80120f13
EZ
1758`map-query-replace-regexp'. The function it specifies is called by
1759`perform-replace' when its 4th argument is non-nil.
4f4a84ec 1760
4f75e082
JL
1761*** New keymap `search-map' bound to `M-s' provides global bindings
1762for search related commands.
1763
1764*** New keymap `multi-query-replace-map' contains additonal keys bound
71554a21
JL
1765to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
1766
b350bdf2
CY
1767*** The variable `inhibit-changing-match-data', if non-nil, prevents
1768the search and match primitives from changing the match data.
967b2682 1769
3c241617
CY
1770*** New functions `word-search-forward-lax' and `word-search-backward-lax'.
1771These are like `word-search-forward and `word-search-backward', except
1772that the end of the search string need not match a word boundary,
1773unless it ends in whitespace.
1774
b350bdf2 1775** File handling changes
8bf5c8a6 1776
b350bdf2
CY
1777*** set-file-modes is now interactive and can take the mode value in
1778symbolic notation thanks to auxiliary functions.
16e82271 1779
291703b5
EZ
1780*** file-local-variables-alist stores an alist of file-local
1781variables defined in the current buffer.
1782
d59f7c45 1783** Face-remapping
16e82271 1784
d59f7c45
CY
1785*** Each face can be remapped to a different face definition using the
1786variable `face-remapping-alist'. This is an alist that maps faces to
1787replacement definitions (which can be face names, lists of face names,
1788or attribute/value plists. If this variable is buffer-local, the
1789remapping occurs only in that buffer.
1790
1791*** text-scale-mode remaps the default face to a larger or smaller
2e538385 1792size in the current buffer. This feature is used by the Buffer Face
d59f7c45
CY
1793menu and the new `C-x C-+', `C-x C--', and `C-x C-0' commands (see
1794Editing Changes, above).
1795
1796*** New functions:
16e82271 1797
d59f7c45
CY
1798**** `face-remap-add-relative' adds a face remapping entry to the
1799current buffer.
16e82271 1800
d59f7c45
CY
1801**** ``face-remap-remove-relative' removes a face remapping entry from
1802the current buffer.
16e82271 1803
d59f7c45 1804**** `face-remap-reset-base' restores a face to its global definition.
16e82271 1805
d59f7c45
CY
1806**** `face-remap-set-base' sets the base remapping of a face.
1807
85c78c0f 1808** Process changes
16e82271 1809
b350bdf2
CY
1810*** The new function `start-file-process' is similar to `start-process',
1811but obeys file handlers. The file handler is chosen based on
1812`default-directory'. The functions `start-file-process-shell-command'
1813and `process-file-shell-command' are also new; they call internally
1814`start-file-process' and `process-file', respectively.
1815
1816*** The new function `process-lines' executes an external program and
1817returns its output as a list of lines.
63571b5a 1818
d82c3d44
GM
1819** Character code, representation, and charset changes.
1820
16e82271
CY
1821*** In multibyte buffers and strings, characters are represented by
1822UTF-8 byte sequences. The character code space is now 0x0..0x3FFFFF
1823with no gap; code points 0x0..0x10FFFF are Unicode characters of the
1824same code points, while code points 0x3FFF80..0x3FFFFF are raw 8-bit
1825bytes.
d82c3d44 1826
16e82271 1827*** Generic characters no longer exist.
d82c3d44 1828
16e82271
CY
1829*** The concept of a charset has changed. A single character may
1830belong to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
b350bdf2 1831unicode, iso-8859-1, iso-8859-3, etc).
d82c3d44 1832
16e82271
CY
1833**** The dimension of a charset is now 1, 2, 3, or 4, and the size of
1834each dimension is no longer limited to 94 or 96.
1835
1836**** A dynamic charset priority list is used to infer the charset of
1837characters for display.
1838
c9a1876d
EZ
1839*** The functions `split-char' and `make-char' now accept up to 4
1840positional codes instead of just 2.
1841
d82c3d44
GM
1842*** The functions `encode-char' and `decode-char' now accept any character sets.
1843
1844*** The function `define-charset' now accepts a completely different
1845form of arguments (old-style arguments still work).
1846
d82c3d44
GM
1847*** The value of the function `char-charset' depends on the current
1848priorities of charsets.
1849
d82c3d44
GM
1850*** The function get-char-code-property now accepts many Unicode base
1851character properties. They are `name', `general-category',
1852`canonical-combining-class', `bidi-class', `decomposition',
1853`decimal-digit-value', `digit-value', `numeric-value', `mirrored',
1854`old-name', `iso-10646-comment', `uppercase', `lowercase', and
1855`titlecase'.
1856
b350bdf2
CY
1857*** The functions `modify-syntax-entry' and `modify-category-entry' now
1858accept a cons of characters as the first argument, and modify all
1859entries in that range of characters.
d82c3d44 1860
8434d0b8
EZ
1861*** Use of `translation-table-for-input' for character code unification
1862is now obsolete, since Emacs 23.1 and later uses Unicode as basis for
1863internal representation of characters.
d82c3d44 1864
b350bdf2 1865*** New functions:
d82c3d44 1866
b350bdf2
CY
1867**** `characterp' returns t if and only if the argument is a character.
1868This replaces `char-valid-p', which is now obsolete.
d82c3d44 1869
b350bdf2 1870**** `max-char' returns the maximum character code (currently #x3FFFFF).
d82c3d44 1871
b350bdf2
CY
1872**** `define-charset-alias' defines an alias of a charset.
1873
1874**** `set-charset-priority' sets priorities of charsets.
1875
1876**** `charset-priority-list' returns a prioritized list of charsets.
1877
1878**** `unibyte-string' makes a unibyte string from bytes.
1879
1880**** `define-char-code-property' defines a character code property.
1881
1882**** `char-code-property-description' returns the description string of
1883a character code property.
1884
1885*** New variables:
1886
1887**** `find-word-boundary-function-table' is a char-table of functions to
1888search for a word boundary.
1889
1890**** `char-script-table' is a char-table of script names.
1891
1892**** `char-width-table' is a char-table of character widths.
1893
1894**** `print-charset-text-property' controls how to handle `charset' text
1895property on printing a string.
1896
1897**** `printable-chars' is a char-table of printable characters.
d82c3d44 1898
505d8756 1899** Code conversion changes
d82c3d44
GM
1900
1901*** The new function `define-coding-system' should be used to define a
1902coding system instead of `make-coding-system' (which is now obsolete).
1903
1904*** The functions `encode-coding-region' and `decode-coding-region'
1905have an optional 4th argument to specify where the result of
1906conversion should go.
1907
1908*** The functions `encode-coding-string' and `decode-coding-string'
1909have an optional 4th argument specifying a buffer to store the result
1910of conversion.
1911
b0caa7fb
EZ
1912*** The new variable `inhibit-null-byte-detection' controls whether to
1913consider text with null bytes as binary data. By default, it is
1914`nil', and Emacs uses `no-conversion' for any text containing null
1915bytes.
1916
b350bdf2 1917*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
d82c3d44 1918
b350bdf2 1919*** New functions:
d82c3d44 1920
b350bdf2
CY
1921**** `with-coding-priority' executes Lisp code using the specified
1922coding system priority order.
d82c3d44 1923
b350bdf2
CY
1924**** `check-coding-systems-region' checks if the text in the region is
1925encodable by the specified coding systems.
d82c3d44 1926
b350bdf2 1927**** `coding-system-aliases' returns a list of aliases of a coding system.
d82c3d44 1928
b350bdf2
CY
1929**** `coding-system-charset-list' returns a list of charsets supported
1930by a coding system.
d82c3d44 1931
b350bdf2
CY
1932**** `coding-system-priority-list' returns a list of coding systems
1933ordered by their priorities.
1934
1935**** `set-coding-system-priority' sets priorities of coding systems.
d82c3d44 1936
f4017dc5
KH
1937**** `coding-system-from-name' returns a coding system matching with
1938the argument name.
1939
1940
d82c3d44 1941** There is a new input method, Robin, different from Quail.
0caa490b 1942It has three functionalities:
d82c3d44
GM
1943 i) a simple input method (converts an ASCII sequence into a string).
1944ii) converts an existing buffer substring into another string
1945iii) reverse conversion (each character produced by a
1946robin rule can hold the original ASCII sequence as a char-code-property)
1947
1948*** The new function `robin-define-package' defines a Robin package.
1949
1950*** The new function `robin-modify-package' modifies an existing Robin package.
1951
1952*** The new function `robin-use-package' starts using a Robin package
1953as an input method.
1954
888d7d86
KH
1955*** The new function `string-to-unibyte' is like `string-as-unibyte'
1956but signals an error if STRING contains a non-ASCII, non-eight-bit
1957character.
1958
505d8756 1959** Changes related to the new font backend
16e82271 1960
0c1e3f0d
CY
1961*** Which font backends to use can be specified by the X resource
1962"FontBackend". For instance, to use both X core fonts and Xft fonts:
2b7a2553 1963
b19aa6dd 1964Emacs.FontBackend: x,xft
2b7a2553 1965
b19aa6dd
GM
1966If this resource is not set, Emacs tries to use all font backends
1967available on your graphic device.
16e82271 1968
d82c3d44
GM
1969*** New frame parameter `font-backend' specifies a list of
1970font-backends supported by the frame's graphic device. On X, they are
1971currently `x' and `xft'.
1972
b350bdf2
CY
1973*** The function `set-fontset-font' now accepts a script name as the
1974second argument, and has an optional 5th argument to control how to
1975set the font.
bd9d28f7 1976
b350bdf2 1977*** New functions:
16e82271 1978
b350bdf2 1979**** `fontp' checks if the argument is a font-spec or font-entity.
16e82271 1980
b350bdf2 1981**** `font-spec' creates a new font-spec object.
16e82271 1982
b350bdf2 1983**** `font-get' returns a font property value.
16e82271 1984
b350bdf2 1985**** `font-put' sets a font property value.
16e82271 1986
b350bdf2 1987**** `font-face-attributes' returns a plist of face attributes set by a font.
16e82271 1988
b350bdf2 1989**** `list-fonts' returns a list of font-entities matching a font spec.
16e82271 1990
543e6d09 1991**** `find-font' returns the font-entity best matching the given font spec.
16e82271 1992
ae525471 1993**** `font-family-list' returns a list of family names of available fonts.
16e82271 1994
b350bdf2
CY
1995**** `font-xlfd-name' returns an XLFD name of a given font spec, font
1996entity, or font object.
16e82271 1997
b350bdf2 1998**** `clear-font-cache' clears all font caches.
d82c3d44 1999
b350bdf2 2000** Changes related to multiple-terminal (multi-tty) support
24cdde13 2001
b12f6e85
SM
2002*** $TERM is now set to `dumb' for subprocesses. If you want to know the
2003$TERM inherited by Emacs you will have to look inside initial-environment.
2004
6168122d
SM
2005*** $DISPLAY is now dynamically inherited from the frame's `display'.
2006
b350bdf2 2007*** The `window-system' variable is now frame-local. The new
24cdde13 2008`initial-window-system' variable contains the `window-system' value
bbe3eb99
GM
2009for the first frame. `window-system' is also now a function that
2010takes a frame argument.
24cdde13 2011
b350bdf2
CY
2012*** The `keyboard-translate-table' variable and the terminal and
2013keyboard coding systems are now terminal-local.
2014
24cdde13
GM
2015*** You can specify a terminal device (`tty' parameter) and a terminal
2016type (`tty-type' parameter) to `make-terminal-frame'.
2017
24cdde13 2018*** The function `make-frame-on-display' now works during a tty
4e598d29 2019session.
24cdde13 2020
1e637a9f
EZ
2021*** A new `terminal' data type.
2022The functions `get-device-terminal', `terminal-parameters',
765980a4 2023`terminal-parameter', `set-terminal-parameter' use this data type.
24cdde13 2024
b350bdf2
CY
2025*** Function key sequences are now mapped using `local-function-key-map',
2026a new variable. This inherits from the global variable function-key-map,
2027which is not used directly any more.
92cd6a7c 2028
b350bdf2 2029*** New hooks:
da406961 2030
7082ceb2
CY
2031**** before-hack-local-variables-hook is called after setting new
2032variable file-local-variables-alist, and before actually applying the
2033file-local variables.
2034
b350bdf2
CY
2035**** `suspend-tty-functions' and `resume-tty-functions' are called
2036after a tty frame has been suspended or resumed, respectively. The
2037functions are called with the terminal id of the frame being
2038suspended/resumed as a parameter.
da406961 2039
b350bdf2
CY
2040**** The special hook `delete-terminal-functions' is called before
2041deleting a terminal.
82866ad5 2042
b350bdf2 2043*** New functions:
24cdde13 2044
490f1197 2045**** `delete-terminal'
9f44d41a 2046
b350bdf2 2047**** `suspend-tty'
ea2e3ef4 2048
b350bdf2 2049**** `resume-tty'.
8d371994 2050
b350bdf2 2051*** `initial-environment' holds the environment inherited from Emacs's parent.
8d371994 2052
b350bdf2 2053** Redisplay changes
16e82271 2054
b350bdf2
CY
2055*** For underlined characters, the distance between the underline and
2056the baseline is controlled by a new variable, `underline-minimum-offset'.
16e82271 2057
b350bdf2
CY
2058*** You can now pass the value of the `invisible' property to
2059invisible-p to check whether it would cause the text to be invisible.
540f3092
GM
2060This is convenient when checking invisibility of text with no buffer
2061position (e.g. in before/after-strings).
16e82271 2062
b350bdf2 2063*** `clear-image-cache' can be told to flush only images of a specific file.
16e82271 2064
0c8b58e9
CY
2065*** `vertical-motion' can now be given a goal column.
2066It now accepts a cons cell (COLS . LINES) in its first argument, which
2067says to stop, where possible, at a pixel x-position equal to COLS
2068times the default column width.
16e82271 2069
e589455f
MR
2070*** redisplay-end-trigger-functions, set-window-redisplay-end-trigger,
2071and window-redisplay-end-trigger are obsolete. Use `jit-lock-register'
2072instead.
16e82271 2073
605bfcb3
CY
2074*** The new variables `wrap-prefix' and `line-prefix' specify display
2075specs which are appended at display-time to every continuation line
2076and non-continuation line, respectively. In addition, Emacs
2077recognizes the `wrap-prefix' and `line-prefix' text or overlay
2078properties; these have the same effects as the variables of the same
2079name, but take precedence.
e589455f 2080
9ac64acd
CY
2081** The Lisp interpreter now treats non-breaking space as whitespace.
2082
b350bdf2 2083** Miscellaneous new functions
9f44d41a 2084
b350bdf2 2085*** `apply-partially' performs a "curried" application of a function.
abf13a8b 2086
b350bdf2
CY
2087*** `buffer-swap-text' swaps text between two buffers. This can be
2088useful for modes such as tar-mode, archive-mode, RMAIL.
967b2682 2089
6880f6db
CY
2090*** `combine-and-quote-strings' produces a single string from a list of strings
2091sticking a separator string in between each pair, and quoting those
2092strings that include the separator as their substring. Useful for
2093consing shell command lines from the individual arguments.
2094
2095*** `custom-note-var-changed' tells Custom to treat the change in a
2096certain variable as having been made within Custom.
b350bdf2
CY
2097
2098*** `face-all-attributes' returns an alist describing all the basic
2099attributes of a given face.
2100
6880f6db
CY
2101*** `format-seconds' converts a number of seconds into a readable
2102string of days, hours, etc.
b350bdf2
CY
2103
2104*** `image-refresh' refreshes all images associated with a given image
2105specification.
64639e26 2106
6880f6db
CY
2107*** `locate-user-emacs-file' helps packages to select the appropriate
2108place to save user-specific files. It defaults to `user-emacs-directory'
2109unless the file already exists at $HOME.
2110
6880f6db
CY
2111*** `read-color' reads a color name using the minibuffer.
2112
6880f6db
CY
2113*** `read-shell-command' does what its name says, with completion. It
2114uses the minibuffer-local-shell-command-map for that.
2115
6880f6db
CY
2116*** `split-string-and-unquote' splits a string into a list of substrings
2117on the boundaries of a given delimiter, and unquotes the substrings that
2118are quoted. Useful for taking apart shell commands.
2119
b350bdf2 2120*** The two new functions `looking-at-p' and `string-match-p' can do
45595a4f
RS
2121the same matching as `looking-at' and `string-match' without changing
2122the match data.
89835619 2123
81efacf9
CY
2124*** The two new functions `make-serial-process' and
2125`serial-process-configure' provide a Lisp interface to the new serial
2126port support (see Emacs changes, above).
2127
b350bdf2
CY
2128** Miscellaneous new variables
2129
28aaa255
CY
2130*** `auto-save-include-big-deletions', if non-nil, means auto-save is
2131not turned off automatically after a big deletion.
2132
91f68422
CY
2133*** `read-circle', if nil, disables the reading of recursive Lisp
2134structures using the #N= and #N# syntax.
2135
b350bdf2
CY
2136*** `this-command-keys-shift-translated' is non-nil if the key
2137sequence invoking the current command was found by shift-translation.
2138
2139*** `window-point-insertion-type' determines the insertion-type of the
2140marker used for window-point.
2141
2142*** bookmark provides `bookmark-make-record-function' so special major
2143modes like Info can teach bookmark.el how to save and restore the
2144relevant data.
2145
b350bdf2
CY
2146*** `fill-forward-paragraph-function' specifies which function the
2147filling code should use to find paragraph boundaries.
2148
9bae34bf 2149\f
0bfd685e 2150* New Packages for Lisp Programming in Emacs 23.1
efeb796b 2151
b350bdf2
CY
2152** The new package avl-tree.el deals with the AVL tree data structure.
2153
2154** The new package check-declare.el verifies the accuracy of
2155declare-function macros (see Lisp Changes, above).
d445b3f8 2156
20202f5e 2157** find-cmd.el can build `find' commands using lisp syntax.
6dfcbe31 2158
babc4609
JL
2159** The package misearch.el has been added. It allows Isearch to search
2160through multiple buffers. A variable `multi-isearch-next-buffer-function'
2161defines the function to call to get the next buffer to search in the series
b0d6136e 2162of multiple buffers. Top-level functions `multi-isearch-buffers',
babc4609
JL
2163`multi-isearch-buffers-regexp', `multi-isearch-files' and
2164`multi-isearch-files-regexp' accept a single argument that specifies
2165a list of buffers/files to search for a string/regexp.
9097e8af 2166
b350bdf2
CY
2167** The new major mode `special-mode' is intended as a parent for
2168major modes such as those that set the "'mode-class 'special" property.
d53a60a6 2169
05197f40 2170\f
a933dad1 2171----------------------------------------------------------------------
5b87ad55 2172This file is part of GNU Emacs.
a933dad1 2173
ab73e885 2174GNU Emacs is free software: you can redistribute it and/or modify
5b87ad55 2175it under the terms of the GNU General Public License as published by
ab73e885
GM
2176the Free Software Foundation, either version 3 of the License, or
2177(at your option) any later version.
5b87ad55
GM
2178
2179GNU Emacs is distributed in the hope that it will be useful,
2180but WITHOUT ANY WARRANTY; without even the implied warranty of
2181MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2182GNU General Public License for more details.
a933dad1 2183
5b87ad55 2184You should have received a copy of the GNU General Public License
ab73e885 2185along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
a933dad1 2186
05197f40 2187\f
a933dad1
DL
2188Local variables:
2189mode: outline
2190paragraph-separate: "[ \f]*$"
2191end:
ab5796a9 2192
a533413c 2193arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2