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