Merge with CEDET upstream (rev. 8499).
[bpt/emacs.git] / etc / NEWS
CommitLineData
29b7722a 1GNU Emacs NEWS -- history of user-visible changes.
5b87ad55 2
ab422c4d 3Copyright (C) 2010-2013 Free Software Foundation, Inc.
5b87ad55 4See the end of the file for license conditions.
a933dad1 5
893db5bc 6Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
9a21d88b
KS
7If possible, use M-x report-emacs-bug.
8
eb199145 9This file is about changes in Emacs version 24.
9a21d88b 10
eb199145
GM
11See files NEWS.23, NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18,
12and NEWS.1-17 for 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
a1ed8b05
GM
17Temporary note:
18+++ indicates that the appropriate manual has already been updated.
19--- means no change in the manuals is called for.
20When you add a new item, please add it without either +++ or ---
21so we will look at it and add it to the manual.
22
23\f
95a32efb 24* Installation Changes in Emacs 24.4
7c3d167f
RF
25
26** Emacs can be compiled with POSIX ACL support.
27This happens by default if a suitable support library is found at
28build time, like libacl on GNU/Linux. To prevent this, use the
29configure option `--without-acl'.
30
aec32f66
PE
31** The configure option --with-crt-dir has been removed.
32It is no longer needed, as the crt*.o files are no longer linked specially.
33
c57b2d76 34\f
95a32efb 35* Startup Changes in Emacs 24.4
c57b2d76
GM
36
37\f
95a32efb 38* Changes in Emacs 24.4
c6c08d3f 39
61a5bb85
BG
40+++
41** `apropos-variable' is now `apropos-user-option'
42`apropos-user-option' shows all user options while `apropos-variable'
43shows all variables. When called with a universal prefix argument,
44the two commands swap their behaviors. When `apropos-do-all' is
45non-nil, they output the same results.
46
c6c08d3f
GM
47+++
48** `eval-defun' on an already defined defcustom calls the :set function,
49if there is one.
50
97a1cd9d
GM
51** If the new variable `enable-dir-local-variables' is nil,
52directory local variables are ignored. May be useful for some modes
53that want to ignore directory-locals while still respecting file-locals.
54
5dea55d2
CY
55** The option `set-mark-default-inactive' has been deleted.
56This unfinished feature was introduced by accident in Emacs 23.1;
57simply disabling Transient Mark mode does the same thing.
58
dc646358
CK
59** `initial-buffer-choice' can now specify a function to set up the
60initial buffer.
61
7c3d167f
RF
62** ACL support has been added.
63+++
64*** Emacs preserves the ACL entries of files when backing up.
65+++
66*** New functions `file-acl' and `set-file-acl' get and set the ACL
66447e07
EZ
67entries of a file. On GNU/Linux, the POSIX ACL interface is used via
68libacl. On MS-Windows, the NT Security APIs are used to emulate the
69POSIX ACL interfaces.
7c3d167f 70
99548339 71** New option `scroll-bar-adjust-thumb-portion'.
a219080b
EZ
72Available only on X, this option allows to control over-scrolling
73using the scroll bar (i.e. dragging the thumb down even when the end
74of the buffer is visible).
99548339 75
c57b2d76 76\f
95a32efb 77* Editing Changes in Emacs 24.4
4f0552c2 78
a45b7647
JL
79** New commands `toggle-frame-fullscreen' and `toggle-frame-maximized',
80bound to <f11> and M-<f10>, respectively.
37f38bca 81
958614cf
GM
82** In keymaps where SPC scrolls, S-SPC now scrolls in the reverse direction.
83Eg View mode, etc.
84
4f0552c2 85\f
95a32efb 86* Changes in Specialized Modes and Packages in Emacs 24.4
4f0552c2 87
940e5099
SM
88** More packages look for ~/.emacs.d/<foo> additionally to ~/.<foo>.
89Affected files:
90~/.emacs.d/timelog replaces ~/.timelog
91~/.emacs.d/todo-do replaces ~/.todo-do
92~/.emacs.d/todo-done replaces ~/.todo-done
93~/.emacs.d/todo-top replaces ~/.todo-top
94~/.emacs.d/vip replaces ~/.vip
95~/.emacs.d/viper replaces ~/.viper
96~/.emacs.d/ido.last replaces ~/.ido.last
97~/.emacs.d/kkcrc replaces ~/.kkcrc
98~/.emacs.d/quickurls replaces ~/.quickurls
99~/.emacs.d/idlwave replaces ~/.idlwave
100~/.emacs.d/bdfcache.el replaces ~/.bdfcache.el
101~/.emacs.d/places replaces ~/.emacs-places
102~/.emacs.d/shadows replaces ~/.shadows
103~/.emacs.d/shadow_todo replaces ~/.shadow_todo
104~/.emacs.d/strokes replaces ~/.strokes
105~/.emacs.d/notes replaces ~/.notes
106~/.emacs.d/type-break replaces ~/.type-break
e56221d5 107
c4f268a1
SM
108** Delphi mode is now called OPascal mode.
109*** All delphi-* variables and functions have been renamed to opascal-*.
110*** `delphi-newline-always-indents' is not supported any more
111use `electric-indent-mode' instead.
112*** `delphi-tab' is gone, replaced by `indent-for-tab-command'.
113
e5b5a34d
SM
114** jit-lock-debug-mode lets you use the debuggers on code run via jit-lock.
115
b14abca9
RW
116** completing-read-multiple's separator can now be a regexp.
117The default separator is changed to allow surrounding spaces around the comma.
118
19b748ad
TM
119** Battery
120
121*** Battery information via the BSD `apm' utility is now supported.
122
ba30c70f
GM
123** cl-lib
124
125*** New macro cl-tagbody.
126
127+++
128*** letf is now just an alias for cl-letf.
129
0e70ce93
PE
130** Calc
131
132*** Calc by default now uses the Gregorian calendar for all dates, and
133uses January 1, 1 AD as its day number 1. Previously Calc used the
134Julian calendar for dates before September 14, 1752, and it used
135December 31, 1 BC as its day number 1; the new scheme is more
136consistent with Calendar's calendrical system and day numbering.
137
138*** The new variable `calc-gregorian-switch' lets you configure the
139date when Calc switches from the Julian to the Gregorian calendar.
140Nil, the default value, means to always use the Gregorian calendar.
141The value (YEAR MONTH DAY) means to start using the Gregorian calendar
142on the given date.
143
86e100a6
GM
144*** Support for ISO 8601 dates.
145
a2a538b1
CS
146** Dired
147
148*** New minor mode `dired-hide-details-mode' hides details.
149
21859ebc
EH
150** ERC
151
152*** New option `erc-accidental-paste-threshold-seconds'.
153If set to a number, this can be used to avoid accidentally paste large
154amounts of data into the ERC input.
155
156** Icomplete is a bit more like IDO.
157*** key bindings to navigate through and select the completions.
158*** The icomplete-separator is customizable, and its default has changed.
159*** Removed icomplete-show-key-bindings.
160
2a43515a 161** Image mode
20de6ab6
CW
162
163*** New commands `n' (`image-next-file') and `p' (`image-previous-file')
164visit the next image file and the previous image file in the same
165directory, respectively.
166
c0211c4e
GM
167*** New commands to show specific frames of multi-frame images.
168`f' (`image-next-frame') and `b' (`image-previous-frame') visit the
169next or previous frame. `F' (`image-goto-frame') shows a specific frame.
170
2a43515a
CY
171---
172*** The command `image-mode-fit-frame' deletes other windows.
173When toggling, it restores the frame's previous window configuration.
174It also has an optional frame argument, which can be used by Lisp
175callers to fit the image to a frame other than the selected frame.
176
279f9b06
JL
177** Isearch
178
179*** `C-x 8 RET' in Isearch mode reads a character by its Unicode name
180and adds it to the search string.
181
5a3cbc03 182** MH-E has been updated to MH-E version 8.5.
6827cac1
BW
183See MH-E-NEWS for details.
184
13a40633
GM
185---
186** The unrmail command converts from BABYL to mboxrd rather than mboxo.
187Customize `unrmail-mbox-format' to change this.
188
189---
190** Similarly, customize `rmail-mbox-format' to influence some minor aspects
191of how Rmail displays non-MIME messages.
192
4f0552c2
GM
193+++
194** New function `ses-rename-cell' to give SES cells arbitrary names.
195
8b62d742
SM
196** trace-function was largely rewritten.
197New features include:
198- no prompting for the destination buffer, unless a prefix-arg was used.
199- additionally to prompting for a destination buffer, when a prefix-arg is
200 used, the user can enter a "context", i.e. Lisp expression whose value at the
201 time the function is entered/exited will be printed along with the function
202 name and arguments. Useful to trace the value of (current-buffer) or
203 (point) when the function is invoked.
204
c38a186c
JL
205** New command `delete-duplicate-lines' has two types of operation:
206when its arg ADJACENT is non-nil (when called interactively with C-u C-u)
207it works like the utility `uniq'. Otherwise by default it deletes
208duplicate lines everywhere in the region without regard to adjacency.
209
ad4de702
MN
210** New `cycle-spacing' command allows cycling between having just one
211space, no spaces, or reverting to the original spacing. Like
212`just-one-space' command it can handle or ignore newlines and
213leave different number of spaces.
214
aefa2ead 215** Tramp
26280467 216
aefa2ead
MA
217+++
218*** New connection method "adb", which allows to access Android
19dc8b9e
MA
219devices by the Android Debug Bridge. The variable `tramp-adb-program'
220can be used to adapt the path of the "adb" program, if needed.
26280467 221
19dc8b9e
MA
222*** The connection methods "plink1", "ssh1", "ssh2", "scp1", "scp2",
223"scpc" and "rsyncc" are discontinued. The ssh option
224"ControlMaster=auto" is set automatically in all ssh-based methods,
225when possible.
26280467 226
ed7367b1
MA
227+++
228*** Handlers for `file-acl' and `set-file-acl' for remote machines
229which support POSIX ACLs.
aefa2ead 230
433212bf
CY
231** Woman
232
233*** The commands `woman-default-faces' and `woman-monochrome-faces'
234are obsolete. Customize the `woman-* faces instead.
235
770de7cf
CY
236** Obsolete packages:
237
238*** longlines.el is obsolete; use visual-line-mode instead.
239
ce3e7725
CY
240*** terminal.el is obsolete; use term.el instead.
241
4e16ddf4
GM
242+++
243*** yow.el is obsolete; use fortune.el or cookie1.el instead.
244
5313bbc7
GM
245---
246*** The Info-edit command is obsolete. Editing Info nodes by hand
247has not been relevant for some time.
248
4f0552c2 249\f
95a32efb 250* New Modes and Packages in Emacs 24.4
231d8498
SM
251** New nadvice.el package offering lighter-weight advice facilities.
252It is layered as:
253- add-function/remove-function which can be used to add/remove code on any
254 function-carrying place, such as process-filters or `<foo>-function' hooks.
255- advice-add/advice-remove to add/remove a piece of advice on a named function,
256 much like `defadvice' does.
257
c57b2d76 258\f
95a32efb 259* Incompatible Lisp Changes in Emacs 24.4
da03ef8a 260
25c09217
SM
261** `read-event' does not return decoded chars in ttys any more.
262Just as was the case in Emacs-22 and before, decoding of tty input according to
263keyboard-coding-system is not performed in read-event any more. But contrary
264to that past, it is still done before input-decode-map/function-key-map/...
265
99d0d6dc
SM
266** Removed inhibit-local-menu-bar-menus.
267
e02230bf
SM
268** frame-local variables that affect redisplay do not work any more.
269More specifically, the redisplay does not bother to check for a frame-local
270value when looking up variables.
271
eadf1faa
SM
272** nil and "unbound" are indistinguishable in symbol-function.
273`symbol-function' never signals `void-function' any more.
274`fboundp' returns non-nil if the symbol was `fset' to nil.
275
3c442f8b
SM
276** `defadvice' does not honor the `freeze' flag and cannot advise
277special-forms any more.
7db1bda8 278
da03ef8a
SM
279** `dolist' in lexical-binding mode does not bind VAR in RESULT any more.
280VAR was bound to nil which was not tremendously useful and just lead to
281spurious warnings about an unused var.
282
7c3d167f
RF
283** The return value of `backup-buffer' has changed.
284The second argument is no longer an SELinux context, instead it is an
285alist of extended attributes as returned by the new function
286`file-extended-attributes'. The attributes can be applied to another
287file using `set-file-extended-attributes'.
288
c57b2d76 289\f
97a1cd9d 290* Lisp Changes in Emacs 24.4
57618ecf 291
d3e9f3a8
SM
292** `dont-compile' is declared obsolete.
293
81606b10
RS
294** Support for filesystem notifications.
295Emacs now supports notifications of filesystem changes, such as
296creation, modification, and deletion of files. This requires the
f282b9f7
EZ
297'inotify' API on GNU/Linux systems. On MS-Windows systems, this is
298supported for Windows XP and newer versions.
81606b10 299
add89f61
MA
300** Changes in autorevert.el
301
302---
303*** If Emacs is compiled with file notification support, notifications
304are used instead of checking the time stamp of the files. You can
305disable this by setting the user option `auto-revert-use-notify' to
306nil. Alternatively, a regular expression of directories to be
307excluded from file notifications can be specified by
308`auto-revert-notify-exclude-dir-regexp'.
309
310---
311*** The new user option `auto-revert-remote-files' enables reversion
312of remote files when set to non-nil.
313
1c4f115d
CY
314** Face changes
315
316*** The `face-spec-set' is now analogous to `setq' for face specs.
317Its third arg now accepts values specifying exactly which face spec to
318set (defface, custom, or user spec), and it directly sets the relevant
319property using the supplied face spec.
320
321*** Face specs set via Custom themes now replace the `defface' spec
322rather than inheriting from it (as do face specs set via Customize).
323
073ca75b
JL
324*** New face characteristic (supports :underline (:style wave))
325specifies whether or not the terminal can display a wavy line.
326
f0c954fa
GM
327** Image API
328
329+++
330*** `image-animated-p' is now `image-multi-frame-p'.
331It returns non-nil for any image that contains multiple frames,
332whether or not it specifies a frame delay.
333
334+++
335*** When animating images that do not specify a frame delay,
336Emacs uses `image-default-frame-delay'.
337
338+++
339*** New functions `image-current-frame' and `image-show-frame' for getting
340and setting the current frame of a multi-frame image.
341
855b17af 342** time-to-seconds is not obsolete any more.
231d8498 343** New function special-form-p.
57618ecf
SM
344** Docstrings can be made dynamic by adding a `dynamic-docstring-function'
345text-property on the first char.
346
32e5c58c
SM
347** The `defalias-fset-function' property lets you catch calls to defalias
348and redirect them to your own function instead of `fset'.
349
70743157 350** The lock for 'DIR/FILE' is now 'DIR/.#FILE' and may be a regular file.
b5029e23
PE
351When you edit DIR/FILE, Emacs normally creates a symbolic link
352DIR/.#FILE as a lock that warns other instances of Emacs that DIR/FILE
353is being edited. Formerly, if there was already a non-symlink file
354named DIR/.#FILE, Emacs fell back on the lock names DIR/.#FILE.0
355through DIR/.#FILE.9. These fallbacks have been removed, so that
356Emacs now no longer locks DIR/FILE in that case.
357
70743157
PE
358On file systems that do not support symbolic links, the lock is now a
359regular file with contents being what would have been in the symlink.
b5029e23 360
97976f9f
PE
361** The 9th element returned by `file-attributes' is now unspecified.
362Formerly, it was t if the file's gid would change if file were deleted
363and recreated. This value has been inaccurate for years on many
364platforms, and nobody seems to have noticed or cared.
365
366** The function `file-ownership-preserved-p' now has an optional
367argument GROUP which causes it check for file group too. This can be
368used in place of the 9th element of `file-attributes'.
369
370** New functions `group-gid' and `group-real-gid'.
371
7c3d167f
RF
372** The 6th argument to `copy-file' has been renamed to
373`preserve-extended-attributes' as it now handles both SELinux context
374and ACL entries.
375
c57b2d76 376\f
97a1cd9d 377* Changes in Emacs 24.4 on Non-Free Operating Systems
95a32efb 378
5248293f
GM
379+++
380** The "generate a backtrace on fatal error" feature now works on MS Windows.
381The backtrace is written to the 'emacs_backtrace.txt' file in the
382directory where Emacs was running.
383
8549f9e8
EZ
384+++
385** The variable `buffer-file-type' is no longer supported.
386Setting it has no effect, and %t in the mode-line format is ignored.
387Likewise, `file-name-buffer-file-type-alist' is now obsolete, and
388modifying it has no effect.
389
343a2aef
EZ
390---
391** Lock files now work on MS-Windows.
392This allows to avoid losing your edits if the same file is being
393edited in another Emacs session or by another user. See the node
394"Interlocking" in the Emacs User Manual for the details. To disable
395file locking, customize `create-lockfiles' to nil.
396
c57b2d76
GM
397** Improved fullscreen support on Mac OS X.
398Both native (>= OSX 10.7) and "old style" fullscreen are supported.
399Customize `ns-use-native-fullscreen' to change style. For >= 10.7
400native is the default.
401
95a32efb 402\f
2a1e2476 403* Installation Changes in Emacs 24.3
b8df54ff 404
6bc66c10 405** The default X toolkit is now Gtk+ version 3.
823b2fb6
GM
406If you don't pass `--with-x-toolkit' to configure, or if you use
407`--with-x-toolkit=gtk' or `--with-x-toolkit=yes', configure will try
408to build with Gtk+ version 3, and if that fails, try Gtk+ version 2.
d71a6517 409You can explicitly require a specific version by passing
823b2fb6 410`--with-x-toolkit=gtk2' or `--with-x-toolkit=gtk3' to configure.
da3d2105 411
6bc66c10 412** New configure option `--enable-link-time-optimization', to utilize
da3d2105
DA
413an appropriate feature provided by GCC since version 4.5.0.
414
33cb2043
GM
415** New configure option `--without-all' to disable most of the optional
416features (image support, etc.) that are normally enabled by default.
b8df54ff 417
33cb2043
GM
418** New configure option `--enable-gcc-warnings' (for developing/debugging
419Emacs). If building with GCC, this enables compile-time checks that
64420fcd
GM
420warn/give errors about possibly-questionable C code. On a recent GNU
421system there should be no warnings; on older and on non-GNU systems
422the results may be useful to developers.
b8df54ff 423
823b2fb6 424** The configure option `--enable-use-lisp-union-type' has been
6bc66c10 425renamed to `--enable-check-lisp-object-type', as the resulting
d71a6517
GM
426Lisp_Object type no longer uses a union to implement the compile time
427check that this option enables.
428
823b2fb6 429** The configure option `--disable-maintainer-mode' has been removed,
501390c5
PE
430as it was confusingly-named and rarely useful.
431
f14a4380
GM
432** The configure options `--program-prefix', `--program-suffix', and
433`--program-transform-name' apply to more than just the installed
434binaries. Now they also affect the man pages, icons, and the
435etc/emacs.desktop file; but not the info pages, since this would break
436links between the various manuals.
1a9c6830 437
823b2fb6
GM
438** You can use `NO_BIN_LINK=t make install' to prevent the installation
439overwriting "emacs" in the installation bin/ directory with a link
6bc66c10 440to "emacs-VERSION".
823b2fb6 441
a4a18b8b
GM
442** Emacs uses libtinfo in preference to libncurses, if available.
443
187e9b90
GM
444** On FreeBSD and NetBSD, configure no longer adds /usr/local/lib and
445/usr/pkg/lib to the linker search path. You must add them yourself if
446you want them.
447
6bc66c10 448** The standalone scripts `rcs-checkin' and `vcdiff' have been removed
276d5f5d
GM
449(from the bin and libexec directories, respectively). The former is
450no longer relevant, the latter is replaced by lisp (in vc-sccs.el).
451
a1ed8b05 452\f
2a1e2476 453* Startup Changes in Emacs 24.3
e5fcdb5e
GM
454
455** Emacs no longer searches for `leim-list.el' files beneath the standard
456lisp/ directory. There should not be any there anyway. If you have
823b2fb6 457been adding them there, put them somewhere else; e.g., site-lisp.
e5fcdb5e 458
4107c81e
GM
459** The `--no-site-lisp' command line option now works for Nextstep builds.
460
a1ed8b05 461\f
2a1e2476 462* Changes in Emacs 24.3
a1ed8b05 463
6bc66c10 464** Help
c89926a5 465
6bc66c10 466*** `C-h f' (`describe-function') can now perform autoloading.
c89926a5
CY
467When this command is called for an autoloaded function whose docstring
468contains a key substitution construct, that function's library is
469automatically loaded, so that the documentation can be shown
470correctly. To disable this, set `help-enable-auto-load' to nil.
471
472*** `C-h f' now reports previously-autoloaded functions as "autoloaded",
473even after their associated libraries have been loaded (and the
474autoloads have been redefined as functions).
475
6bc66c10 476** ImageMagick
cd996018 477
6bc66c10
GM
478*** Images displayed via ImageMagick now support transparency and the
479:background image specification property.
cd996018 480
6bc66c10 481*** When available, ImageMagick support is automatically enabled.
c505aaeb
CY
482It is no longer necessary to call `imagemagick-register-types'
483explicitly to install ImageMagick image types; that function is called
7d806bfe 484automatically at startup, or when customizing an imagemagick- option.
2f940384 485
c505aaeb 486*** Setting `imagemagick-types-inhibit' to t now disables the use of
823b2fb6
GM
487ImageMagick to view images. (You must call `imagemagick-register-types'
488afterwards if you do not use customize to change this.)
2f940384 489
7afbaca4 490*** The new variable `imagemagick-enabled-types' also affects which
60b5f187
GM
491ImageMagick types are treated as images. The function
492`imagemagick-filter-types' returns the list of types that will be
493treated as images.
c505aaeb 494
6bc66c10
GM
495** Minibuffer
496
497*** In minibuffer filename prompts, `C-M-f' and `C-M-b' now move to the
498next and previous path separator, respectively.
c505aaeb 499
6bc66c10
GM
500*** `minibuffer-electric-default-mode' can shorten "(default ...)" to "[...]"
501in minibuffer prompts. Just set `minibuffer-eldef-shorten-default'
502non-nil before enabling the mode.
503
504** Mode line
505
506*** New option `mode-line-default-help-echo' specifies the help text
507(shown in a tooltip or in the echo area) for any part of the mode line
508that does not have its own specialized help text.
509
510*** You can now click mouse-3 in the coding system indicator to invoke
511`set-buffer-file-coding-system'.
512
513** Server and client
2f940384 514
f938eda9
CY
515*** emacsclient now obeys string values for `initial-buffer-choice',
516if it is told to open a new frame without specifying any file to visit
517or expression to evaluate.
db80bdc8 518
f938eda9 519*** New option `server-auth-key' specifies a shared server key.
f938eda9
CY
520
521** Emacs now generates backtraces on fatal errors.
522On encountering a fatal error, Emacs now outputs a textual description
523of the fatal signal, and a short backtrace on platforms like glibc
5248293f 524that support backtraces.
2e2d2a13 525
6bc66c10
GM
526** `C-x C-q' is now bound to the new minor mode `read-only-mode'.
527This minor mode replaces `toggle-read-only', which is now obsolete.
528
529** Most `y-or-n' prompts now allow you to scroll the selected window.
530Typing `C-v' or `M-v' at a y-or-n prompt scrolls forward or backward
531respectively, without exiting from the prompt.
532
533** In the Package Menu, newly-available packages are listed as "new",
534and sorted above the other "available" packages by default.
535
f938eda9
CY
536** If your Emacs was built from a bzr checkout, the new variable
537`emacs-bzr-version' contains information about the bzr revision used.
de6ff46d 538
6bc66c10 539** New option `create-lockfiles' specifies usage of lockfiles.
f938eda9
CY
540It defaults to t. Changing it to nil inhibits the creation of lock
541files (use this with caution).
dc0f75c8 542
6bc66c10
GM
543** New option `enable-remote-dir-locals', if non-nil, allows directory-local
544variables on remote hosts.
21ffb35a 545
f85f636a
CY
546** The entry for PCL-CVS has been removed from the Tools menu.
547The PCL-CVS commands are still available via the keyboard.
548
6bc66c10
GM
549** Using "unibyte: t" in Lisp source files is obsolete.
550Use "coding: raw-text" instead.
551
e78e7e48
CY
552** In the buffer made by `M-x report-emacs-bug', the `C-c m' binding
553has been changed to `C-c M-i' (`report-emacs-bug-insert-to-mailer').
554The previous binding, introduced in Emacs 24.1, was a mistake, because
555`C-c LETTER' bindings are reserved for user customizations.
556
6bc66c10 557** Internationalization
2f940384 558
f938eda9 559*** New language environment: Persian.
2f940384 560
f938eda9
CY
561*** New input method `vietnamese-vni'.
562
6bc66c10 563** Nextstep (GNUstep / Mac OS X) port
2f940384 564
823b2fb6 565*** Support for fullscreen and the frame parameter fullscreen.
2f940384 566
1a9c6830
GM
567*** A file dialog is used for open/save operations initiated from the
568menu/toolbar.
569
a1ed8b05 570\f
2a1e2476 571* Editing Changes in Emacs 24.3
c25df26e 572
6bc66c10 573** Search and Replace
d39d3c8e 574
f938eda9
CY
575*** Non-regexp Isearch now performs "lax" space matching.
576Each sequence of spaces in the supplied search string may match any
577sequence of one or more whitespace characters, as specified by the
578variable `search-whitespace-regexp'. (This variable is also used by a
823b2fb6 579similar existing feature for regexp Isearch.)
2f940384 580
f938eda9
CY
581*** New Isearch command `M-s SPC' toggles lax space matching.
582This applies to both ordinary and regexp Isearch.
2f940384 583
f938eda9
CY
584*** New option `replace-lax-whitespace'.
585If non-nil, `query-replace' uses flexible whitespace matching too.
586The default is nil.
2f940384 587
b9cb2387
JL
588*** Global `M-s _' starts a symbol (identifier) incremental search,
589and `M-s _' in Isearch toggles symbol search mode.
590`M-s c' in Isearch toggles search case-sensitivity.
591
6bc66c10 592** Navigation commands
48de8b12 593
6bc66c10
GM
594*** New binding `M-g c' for `goto-char'.
595
596*** New binding `M-g TAB' for `move-to-column'.
597
598*** `M-g TAB' (`move-to-column') prompts for a column number if called
599interactively with no prefix arg. Previously, it moved to column 1.
600
601** New option `yank-handled-properties' allows processing of text
602properties on yanked text, in ways that are more general than just
603removing them (as is done by `yank-excluded-properties').
48de8b12 604
48de8b12
CY
605** New option `delete-trailing-lines' specifies whether
606M-x delete-trailing-whitespace should delete trailing lines at the end
607of the buffer. It defaults to t.
608
f938eda9 609** `C-u M-=' now counts lines/words/characters in the entire buffer.
826b3235 610
48de8b12
CY
611** `C-x 8 RET' is now bound to `insert-char', which is now a command.
612`ucs-insert' is now an obsolete alias for `insert-char'.
b2459884 613
48de8b12
CY
614** The `z' key no longer has a binding in most special modes.
615It used to be bound to `kill-this-buffer', but `z' is too easy to
616accidentally type.
f938eda9 617
6bc66c10
GM
618** New command `C-x r M-w' (`copy-rectangle-as-kill').
619It copies the region-rectangle as the last rectangle kill.
f938eda9 620
6bc66c10 621** Registers
f938eda9 622
823b2fb6 623*** `C-x r +' is now overloaded to invoke `append-to-register'.
f938eda9 624
f938eda9 625*** New option `register-separator' specifies the register containing
823b2fb6
GM
626the text to put between collected texts for use with
627M-x append-to-register and M-x prepend-to-register.
f1f4dba0 628
a1ed8b05 629\f
2a1e2476 630* Changes in Specialized Modes and Packages in Emacs 24.3
ae4969c2 631
6bc66c10 632** Common Lisp emulation (CL)
f938eda9 633
89660017 634*** CL's main entry is now (require 'cl-lib).
823b2fb6
GM
635`cl-lib' is like the old `cl' except that it uses the namespace cleanly;
636i.e., all its definitions have the "cl-" prefix (and internal definitions
637use the "cl--" prefix).
7c1898a7 638
823b2fb6
GM
639If `cl' provided a feature under the name `foo', then `cl-lib'
640provides it under the name `cl-foo' instead; with the exceptions of the
641few `cl' definitions that had to use `foo*' to avoid conflicts with
642pre-existing Elisp entities. These have been renamed to `cl-foo'
643rather than `cl-foo*'.
7c1898a7 644
92246540 645The old `cl' is now deprecated and is mainly just a bunch of aliases that
823b2fb6 646provide the old, non-prefixed names. Some exceptions are listed below:
7c1898a7 647
89660017
SM
648*** `cl-flet' is not like `flet' (which is deprecated).
649Instead it obeys the behavior of Common-Lisp's `flet'.
e8693c96
GM
650In particular, in cl-flet function definitions are lexically scoped,
651whereas in flet the scoping is dynamic.
89660017
SM
652
653*** `cl-labels' is slightly different from `labels'.
823b2fb6
GM
654The difference is that it relies on the `lexical-binding' machinery
655(as opposed to the `lexical-let' machinery used previously) to capture
656definitions in closures, so such closures will only work if `lexical-binding'
657is in use.
89660017 658
f94b04fc 659*** `cl-letf' is not exactly like `letf'.
4ddedf94
GM
660The only difference is in details that relate to some deprecated usage
661of `symbol-function' in place forms.
f94b04fc 662
89660017 663*** `progv' was rewritten to use the `let' machinery.
823b2fb6
GM
664A side effect is that variables without corresponding values are bound
665to nil rather than being made unbound.
89660017 666
9512f820
GM
667*** The following methods of extending `setf' are obsolete
668(use features from gv.el instead):
669`define-modify-macro' (use `gv-letplace')
031b2ea7
GM
670`defsetf' (use `gv-define-simple-setter' or `gv-define-setter')
671`define-setf-expander' (use `gv-define-setter' or `gv-define-expander')
2b4da3ff 672`get-setf-method' no longer exists (see "Incompatible Lisp Changes")
f94b04fc 673
6bc66c10 674** Diff mode
f938eda9 675
6bc66c10
GM
676*** Changes are now highlighted using the same color scheme as in
677modern VCSes. Deletions are displayed in red (new faces
678`diff-refine-removed' and `smerge-refined-removed', and new definition
679of `diff-removed'), insertions in green (new faces `diff-refine-added'
680and `smerge-refined-added', and new definition of `diff-added').
f938eda9 681
6bc66c10
GM
682*** The variable `diff-use-changed-face' defines whether to use the
683face `diff-changed', or `diff-removed' and `diff-added' to highlight
684changes in context diffs.
2f940384 685
6bc66c10
GM
686*** The new command `diff-delete-trailing-whitespace' removes trailing
687whitespace introduced by a diff.
f938eda9 688
6bc66c10
GM
689** Ediff now uses the same color scheme as Diff mode.
690
691** Python mode
692
693A new version of python.el, which provides several new features, including:
694per-buffer shells, better indentation, Python 3 support, and improved
695shell-interaction compatible with iPython (and virtually any other
696text based shell).
697
698*** Some user options have been replaced/renamed, including (old -> new):
699**** python-indent -> python-indent-offset
700**** python-guess-indent -> python-indent-guess-indent-offset
701**** python-pdbtrack-do-tracking-p -> python-pdbtrack-activate
702**** python-use-skeletons -> python-skeleton-autoinsert
703
704*** Some user options have been removed, including:
705
706**** `python-indent-string-contents': Strings are never indented.
707
708**** `python-honour-comment-indentation':
d5b1b1aa 709Comments are always considered as indentation markers.
6bc66c10
GM
710
711**** `python-continuation-offset': Indentation is automatically
712calculated in a pep8 compliant way depending on the context.
713
714**** `python-shell-prompt-alist', `python-shell-continuation-prompt-alist':
715Have no direct mapping as the shell interaction is completely different.
716
717**** `python-python-command', `python-jython-command':
718Replaced by `python-shell-interpreter'.
719
720**** `inferior-python-filter-regexp', `python-remove-cwd-from-path',
721`python-pdbtrack-minor-mode-string', `python-source-modes':
722No longer relevant.
723
724*** Some commands have been replaced (old -> new):
725**** python-insert-class -> python-skeleton-class
726**** python-insert-def -> python-skeleton-def
727**** python-insert-for -> python-skeleton-for
728**** python-insert-if -> python-skeleton-if
729**** python-insert-try/except -> python-skeleton-try
730**** python-insert-try/finally -> python-skeleton-try
731**** python-insert-while -> python-skeleton-while
732**** python-find-function -> python-nav-jump-to-defun
733**** python-next-statement -> python-nav-forward-sentence
734**** python-previous-statement -> python-nav-backward-sentence
735**** python-beginning-of-defun-function -> python-nav-beginning-of-defun
736**** python-end-of-defun-function -> python-nav-end-of-defun
737**** python-send-buffer -> python-shell-send-buffer
738**** python-send-defun -> python-shell-send-defun
739**** python-send-region -> python-shell-send-region
740**** python-send-region-and-go -> emulate with python-shell-send-region
741and python-shell-switch-to-shell
742**** python-send-string -> python-shell-send-string
743**** python-switch-to-python -> python-shell-switch-to-shell
744**** python-describe-symbol -> python-eldoc-at-point
e76f0800 745
f938eda9
CY
746** D-Bus
747
f938eda9
CY
748*** New variables `dbus-compiled-version' and `dbus-runtime-version'.
749
f938eda9
CY
750*** The D-Bus object manager interface is implemented.
751
f938eda9
CY
752*** Variables of type :(u)int32 and :(u)int64 accept floating points,
753if their value does not fit into Emacs's integer range.
754
823b2fb6
GM
755*** The function `dbus-call-method' is now non-blocking.
756It can be interrupted by `C-g'. `dbus-call-method-non-blocking' is obsolete.
f938eda9 757
823b2fb6 758*** Signals can also be sent as unicast messages.
f938eda9 759
f938eda9 760*** The argument list of `dbus-register-signal' has been extended,
6bc66c10 761according to the new match rule types of D-Bus.
f938eda9 762
f938eda9
CY
763*** `dbus-init-bus' supports private connections.
764
f938eda9
CY
765*** There is a new function `dbus-setenv'.
766
6bc66c10
GM
767** `desktop-path' no longer includes the "." directory.
768Desktop files are now located in ~/.emacs.d by default.
f938eda9
CY
769
770** Dired
2f940384 771
f938eda9
CY
772*** `dired-do-async-shell-command' executes each file sequentially
773if the command ends in `;' (when operating on multiple files).
774Otherwise, it executes the command on each file in parallel.
2f940384 775
823b2fb6
GM
776*** Typing `M-n' in the minibuffer of `dired-do-chmod', `dired-do-chgrp',
777`dired-do-chown', and `dired-do-touch' yanks the attributes of the
f938eda9 778file at point.
2f940384 779
f938eda9 780*** When the region is active, `m' (`dired-mark'), `u' (`dired-unmark'),
823b2fb6 781`DEL' (`dired-unmark-backward'), and `d' (`dired-flag-file-deletion')
f938eda9 782mark/unmark/flag all files in the active region.
2f940384 783
f938eda9
CY
784*** The minibuffer default for `=' (`dired-diff) has changed.
785It is now the backup file for the file at point, if one exists.
786In Transient Mark mode the default is the file at the active mark.
2f940384 787
f938eda9
CY
788*** `M-=' is no longer bound to `dired-backup-diff' in Dired buffers.
789The global binding for `M-=', `count-words-region' is in effect.
790
02969baf
GM
791** ERC
792
6e5e9b70
GM
793*** New module "notifications", which can send a notification when you
794receive a private message or your nickname is mentioned.
02969baf
GM
795
796*** ERC will look up server/channel names via auth-source and use any
797channel keys found.
f938eda9 798
274f5de6
GM
799*** New option `erc-lurker-hide-list', similar to `erc-hide-list', but
800only applies to messages sent by lurkers.
f925b109 801
6bc66c10 802** reStructuredText mode
f938eda9 803
6bc66c10
GM
804*** Keybindings (see `C-c C-h'), TAB indentation, filling and auto-filling,
805fontification, comment handling, and customization have all been revised
806and improved.
f938eda9 807
6bc66c10 808*** Support for `imenu' and `which-function-mode'.
f938eda9 809
6bc66c10
GM
810*** The reStructuredText syntax is more closely covered.
811Sphinx support has been improved.
f938eda9 812
6bc66c10 813*** `rst-insert-list' inserts new list or continues existing lists.
f938eda9 814
6bc66c10 815*** A negative prefix argument always works for `rst-adjust'.
f938eda9 816
6bc66c10 817*** The window configuration is reset after displaying a TOC.
bc7be45d 818
6bc66c10 819*** The constant `rst-version' describes the rst.el package version.
358c19d9 820
dba3cda3
GM
821** Ruby mode
822
823*** Support for percent literals and recognition of regular expressions
824in method calls without parentheses with more methods, including Cucumber
825steps definitions.
826
827*** Improved syntax highlighting and indentation.
828
829*** New command `ruby-toggle-block', bound to `C-c {'.
830
831*** Some non-standard keybindings/commands have been removed:
832
833**** `ruby-electric-brace'; use `electric-indent-mode' instead.
834
835**** `ruby-mark-defun'; use `mark-defun'.
836
837**** `ruby-beginning-of-defun' and `ruby-end-of-defun' are replaced by
838appropriate settings for the variables `beginning-of-defun-function'
839and `end-of-defun-function'.
840
841**** Non-standard keybindings for `backward-kill-word', `comment-region',
842`reindent-then-newline-and-indent' and `newline' have been removed.
843
6bc66c10 844** Shell Script mode
40d8bcb8 845
6bc66c10 846*** Pairing of parens/quotes uses `electric-pair-mode' instead of skeleton-pair.
40d8bcb8 847
6bc66c10 848*** `sh-electric-here-document-mode' now controls auto-insertion of here-docs.
40d8bcb8 849
6bc66c10 850*** `sh-use-smie' lets you choose a new indentation and navigation code.
40d8bcb8 851
6bc66c10 852** VHDL mode
40d8bcb8 853
6bc66c10 854*** The free software compiler GHDL is supported (and now the default).
40d8bcb8 855
6bc66c10 856*** Support for the VHDL-AMS packages has been added/updated.
40d8bcb8 857
6bc66c10 858*** Updated to the 2002 revision of the VHDL standard.
40d8bcb8 859
6bc66c10 860*** Accepts \r and \f as whitespace.
40d8bcb8 861
6bc66c10 862** Apropos
40d8bcb8 863
6bc66c10
GM
864*** The faces used by Apropos are now directly customizable.
865These faces are named `apropos-symbol', `apropos-keybinding', and so on;
866see the `apropos' Custom group for details.
d13c8be6 867
6bc66c10
GM
868*** The old options whose values specified faces to use have been removed
869(i.e. `apropos-symbol-face', `apropos-keybinding-face', etc.).
d13c8be6 870
6bc66c10 871** Buffer Menu
d13c8be6 872
6bc66c10 873*** This package has been rewritten to use Tabulated List mode.
d13c8be6 874
6bc66c10
GM
875*** Option `Buffer-menu-buffer+size-width' is now obsolete.
876Use `Buffer-menu-name-width' and `Buffer-menu-size-width' instead.
d13c8be6 877
86e100a6
GM
878** Calc
879
880*** Algebraic simplification mode is now the default.
881To restrict to the limited simplifications given by the former
882default simplification mode, use `m I'.
883
6bc66c10 884** Calendar
d13c8be6 885
6bc66c10
GM
886*** You can customize the header text that appears above each calendar month.
887See the variable `calendar-month-header'.
d13c8be6 888
6bc66c10 889*** New LaTeX calendar style, produced by `cal-tex-cursor-week2-summary'.
ee97deee 890
6bc66c10
GM
891*** The calendars produced by cal-html include holidays.
892Customize `cal-html-holidays' to change this.
8b0823d6 893
0058cae2
GM
894** CEDET
895
896*** The major modes from the parser generators "Bovine" and "Wisent"
897are now properly integrated in Emacs. The file suffixes ".by" and ".wy"
898are in `auto-mode-alist', and the corresponding manuals are included.
899
900*** EDE
901
902**** Menu support for the "Configuration" feature. This allows users to
903choose the active configuration (such as debug or install) from the menu.
904
905**** New command `ede-set' to interactively set project-local variables.
906
907**** Support for compiling, debugging, and running in "generic" projects.
908
909**** Autoconf editing support for M4 macros with complex arguments.
910
911**** Compilation support for the "linux" project type.
912
913**** "simple" projects have been removed; use "generic" projects instead.
914
915*** Semantic
916
917**** Support for parsing #include statements inside a namespace in C/C++.
918
919**** Improved support for 'extern "C"' declarations in C/C++.
920
921**** The ability to ignore more common special C/C++ preprocessor symbols,
922such as '__nonnull' and '__asm'. Add '__cplusplus' macro when parsing C++.
923If available, include cdefs.h as an additional source of preprocessor symbols.
924
925**** Improved C/C++ function pointer parsing.
926
927**** In Python, support for converting imports to include file names.
928
929**** Ability to dynamically determine the Python load path.
930
931**** Support for the Python 'WITH' and 'AT' keywords.
932
933**** Improved tooltip completion.
934
935*** SRecode
936
937**** The SRecode manual is now included.
938
939**** Tag generation supports constructor/destructor settings and system
940include differentiation.
941
942**** Addition of 'Framework' support: Frameworks are specified when a
943particular kind of library (such as Android) is needed in a common language
944mode (like Java).
945
946**** Support for nested templates and let variables override based on priority.
947
948**** Support for merging tables from multiple related modes, such as
949default -> c++ -> arduino.
950
6bc66c10 951** Compile has a new option `compilation-always-kill'.
42917e79 952
6bc66c10 953** Customize
35d98877 954
6bc66c10 955*** `custom-reset-button-menu' now defaults to t.
35d98877 956
6bc66c10
GM
957*** Non-option variables are never matched in `customize-apropos' and
958`customize-apropos-options' (i.e., the prefix argument does nothing for
959these commands now).
782fbf2a 960
f938eda9 961** Term
782fbf2a 962
823b2fb6
GM
963*** The variables `term-default-fg-color' and `term-default-bg-color'
964are now deprecated in favor of the customizable face `term'.
fc72b15c 965
02969baf
GM
966*** You can customize how to display ANSI terminal colors and styles
967by customizing the corresponding `term-color-<COLOR>',
968`term-color-underline' and `term-color-bold' faces.
cf20dee0 969
05ecb497 970** Tramp
2f940384 971
02969baf 972*** The syntax has been extended in order to allow ad-hoc proxy definitions.
05ecb497 973
823b2fb6 974*** Remote processes are now also supported on remote MS-Windows hosts.
05ecb497 975
ce7b18ec 976** URL
2f940384 977
ce7b18ec
CY
978*** Structs made by `url-generic-parse-url' have nil `attributes' slot.
979Previously, this slot stored semicolon-separated attribute-value pairs
980appended to some imap URLs, but this is not compatible with RFC 3986.
823b2fb6 981So now the `filename' slot stores the entire path and query components,
ce7b18ec 982and the `attributes' slot is always nil.
2f940384 983
ce7b18ec
CY
984*** New function `url-encode-url' for encoding a URI string.
985The `url-retrieve' function now uses this to encode its URL argument,
986in case that is not properly encoded.
987
6bc66c10
GM
988** notifications.el supports now version 1.2 of the Notifications API.
989The function `notifications-get-capabilities' returns the supported
990server properties.
f938eda9 991
6bc66c10
GM
992** Flymake uses fringe bitmaps to indicate errors and warnings.
993See `flymake-fringe-indicator-position', `flymake-error-bitmap' and
994`flymake-warning-bitmap'.
f938eda9 995
6bc66c10
GM
996** The FFAP option `ffap-url-unwrap-remote' can now be a list of strings,
997specifying URL types that should be converted to remote file names at
998the FFAP prompt. The default is now '("ftp").
f938eda9 999
6bc66c10
GM
1000** New Ibuffer `derived-mode' filter, bound to `/ M'.
1001The old binding for `/ M' (filter by used-mode) is now bound to `/ m'.
f938eda9 1002
6bc66c10
GM
1003** New option `mouse-avoidance-banish-position' specifies where the
1004`banish' mouse avoidance setting moves the mouse.
ce7b18ec 1005
6bc66c10
GM
1006** In Perl mode, new option `perl-indent-parens-as-block' causes non-block
1007closing brackets to be aligned with the line of the opening bracket.
f938eda9 1008
6bc66c10 1009** In Proced mode, new command `proced-renice' renices marked processes.
f938eda9 1010
6bc66c10
GM
1011** New option `async-shell-command-buffer' specifies the buffer to use
1012for a new asynchronous `shell-command' when the default output buffer
1013`*Async Shell Command*' is already in use.
f938eda9 1014
6bc66c10
GM
1015** SQL mode has a new option `sql-db2-escape-newlines'.
1016If non-nil, newlines sent to the command interpreter will be escaped
1017by a backslash. The default does not escape the newlines and assumes
1018that the sql statement will be terminated by a semicolon.
f938eda9 1019
6bc66c10
GM
1020** New command `tabulated-list-sort', bound to `S' in Tabulated List mode
1021(and modes that derive from it), sorts the column at point, or the Nth
1022column if a numeric prefix argument is given.
f938eda9 1023
02969baf 1024** `which-func-modes' now defaults to t, so Which Function mode, when
05b621a6 1025enabled, applies to all applicable major modes.
f938eda9 1026
6bc66c10 1027** `winner-mode-hook' now runs when the mode is disabled, as well as when
823b2fb6 1028it is enabled.
f938eda9 1029
6bc66c10
GM
1030** Follow mode no longer works by using advice.
1031The option `follow-intercept-processes' has been removed.
1032
1033** `javascript-generic-mode' is now an obsolete alias for `js-mode'.
f938eda9 1034
d1069532
SM
1035** Hooks renamed to avoid obsolete "-hooks" suffix:
1036*** semantic-lex-reset-hooks -> semantic-lex-reset-functions
1037*** semantic-change-hooks -> semantic-change-functions
1038*** semantic-edits-new-change-hooks -> semantic-edits-new-change-functions
1039*** semantic-edits-delete-change-hooks -> semantic-edits-delete-change-functions
1040*** semantic-edits-reparse-change-hooks -> semantic-edits-reparse-change-functions
1041*** semanticdb-save-database-hooks -> semanticdb-save-database-functions
1042*** c-prepare-bug-report-hooks -> c-prepare-bug-report-hook
1043*** rcirc-sentinel-hooks -> rcirc-sentinel-functions
1044*** rcirc-receive-message-hooks -> rcirc-receive-message-functions
1045*** rcirc-activity-hooks -> rcirc-activity-functions
1046*** rcirc-print-hooks -> rcirc-print-functions
1047*** dbus-event-error-hooks -> dbus-event-error-functions
1048*** eieio-pre-method-execution-hooks -> eieio-pre-method-execution-functions
1049*** checkdoc-style-hooks -> checkdoc-style-functions
1050*** checkdoc-comment-style-hooks -> checkdoc-comment-style-functions
1051*** archive-extract-hooks -> archive-extract-hook
1052*** filesets-cache-fill-content-hooks -> filesets-cache-fill-content-hook
1053*** hfy-post-html-hooks -> hfy-post-html-hook
1054*** nndiary-request-create-group-hooks -> nndiary-request-create-group-functions
1055*** nndiary-request-update-info-hooks -> nndiary-request-update-info-functions
1056*** nndiary-request-accept-article-hooks -> nndiary-request-accept-article-functions
1057*** gnus-subscribe-newsgroup-hooks -> gnus-subscribe-newsgroup-functions
f938eda9 1058
6bc66c10 1059** Obsolete packages
2f940384 1060
797e6e88
SM
1061*** assoc.el
1062In most cases, assoc+member+push+delq work just as well.
1063And in any case it's just a terrible package: ugly semantics, terrible
1064inefficiency, and not namespace-clean.
3c74813a 1065*** bruce.el
b4617547 1066*** cust-print.el
daed4003 1067*** ledit.el
82f289a4 1068*** mailpost.el
d57de7fe 1069*** mouse-sel.el
3c74813a 1070*** patcomp.el
1a9c6830 1071
a1ed8b05 1072\f
2a1e2476 1073* Incompatible Lisp Changes in Emacs 24.3
b4d3bc10 1074
6bc66c10
GM
1075** Docstrings starting with `*' no longer indicate user options.
1076Only variables defined using `defcustom' are considered user options.
1077The function `user-variable-p' is now an obsolete alias for
1078`custom-variable-p'.
090cf9db 1079
6bc66c10
GM
1080** The return values of `defalias', `defun' and `defmacro' have changed,
1081and are now undefined. For backwards compatibility, `defun' and
1082`defmacro' currently return the name of the newly defined
1083function/macro, but this should not be relied upon.
090cf9db 1084
823b2fb6
GM
1085** `random' by default now returns a different random sequence in
1086every Emacs run. Use `(random S)', where S is a string, to set the
0e23ef9d
PE
1087random seed to a value based on S, in order to get a repeatable
1088sequence in later calls.
1089
d32e47af
LM
1090** If the NEWTEXT arg to `replace-match' contains a substring "\?",
1091that substring is inserted literally even if the LITERAL arg is
1092non-nil, instead of causing an error to be signaled.
1093
2cec368c
MR
1094** `select-window' now always makes the window's buffer current.
1095It does so even if the window was selected before.
1096
6bc66c10
GM
1097** The function `x-select-font' can return a font spec, instead of a
1098font name as a string. Whether it returns a font spec or a font name
1099depends on the graphical library.
bbf908bc 1100
eeddc531
CY
1101** `face-spec-set' no longer sets frame-specific attributes when the
1102third argument is a frame (that usage was obsolete since Emacs 22.2).
1103
6bc66c10 1104** `set-buffer-multibyte' now signals an error in narrowed buffers.
a59d531e 1105
ab7f1c43
GM
1106** The CL package's `get-setf-method' function no longer exists.
1107Generalized variables are now part of core Emacs Lisp, and implemented
1108differently to the way cl.el used to do it. It is not possible to
1109define a compatible replacement for `get-setf-method'. See the file
1110gv.el for internal details of the new implementation.
1111
6bc66c10
GM
1112** The arguments of `dbus-register-signal' are no longer just strings,
1113but keywords or keyword-string pairs. The old argument list will
1114still be supported for Emacs 24.x.
72b255c7 1115
6bc66c10 1116** Miscellaneous name changes
823b2fb6
GM
1117Some Lisp symbols have been renamed to correct their spelling,
1118or to be more consistent with standard Emacs terminology.
72b255c7 1119
72b255c7 1120*** Renamed functions
72b255c7
PE
1121**** hangul-input-method-inactivate -> hangul-input-method-deactivate
1122**** inactivate-input-method -> deactivate-input-method
1123**** quail-inactivate -> quail-deactivate
1124**** robin-inactivate -> robin-deactivate
1125**** viper-inactivate-input-method -> viper-deactivate-input-method
1126**** viper-inactivate-input-method-action ->
1127 viper-deactivate-input-method-action
1128**** ucs-input-inactivate -> ucs-input-deactivate
1129
1130*** Renamed hooks
1131The old hooks are still supported for backward compatibility, but they
1132are deprecated and will be removed eventually.
72b255c7
PE
1133**** input-method-inactivate-hook -> input-method-deactivate-hook
1134**** robin-inactivate-hook -> robin-deactivate-hook
1135**** quail-inactivate-hook -> quail-deactivate-hook
1136
6bc66c10 1137*** Renamed variables
72b255c7
PE
1138**** follow-deactive-menu -> follow-inactive-menu
1139**** inactivate-current-input-method-function ->
1140 deactivate-current-input-method-function
1141
02969baf
GM
1142** Some obsolete functions, variables, and faces have been removed:
1143*** `last-input-char', `last-command-char', `unread-command-char'
78f3273a
CY
1144*** `facemenu-unlisted-faces'
1145*** `rmail-decode-mime-charset'
a5f2b6ec
CY
1146*** `iswitchb-read-buffer'
1147*** `sc-version', `sc-submit-bug-report'
1148*** `set-char-table-default'
02969baf 1149*** `string-to-sequence' (use `string-to-list' or `string-to-vector')
a5f2b6ec 1150*** `compile-internal'
02969baf 1151*** `modeline'
59f7af81 1152*** `mode-line-inverse-video'
02969baf 1153*** `follow-mode-off-hook'
a5f2b6ec 1154*** `cvs-commit-buffer-require-final-newline'
63820c5c 1155(use `log-edit-require-final-newline' instead)
a5f2b6ec
CY
1156*** `cvs-changelog-full-paragraphs'
1157(use `log-edit-changelog-full-paragraphs' instead)
1158*** `cvs-diff-ignore-marks', `cvs-diff-buffer-name'
1159*** `vc-ignore-vc-files' (use `vc-handled-backends' instead)
1160*** `vc-master-templates' (use `vc-handled-backends' instead)
1161*** `vc-checkout-carefully'
78f3273a 1162
a1ed8b05 1163\f
93e0bed6 1164* Lisp Changes in Emacs 24.3
ef24141c 1165
2ee3d7f0 1166** CL-style generalized variables are now in core Elisp.
f938eda9 1167`setf' is autoloaded; `push' and `pop' accept generalized variables.
ebdbfb95
GM
1168You can define your own generalized variables using `gv-define-simple-setter',
1169`gv-define-setter', etc.
2ee3d7f0 1170
6bc66c10
GM
1171** Emacs tries to macroexpand interpreted (non-compiled) files during load.
1172This can significantly speed up execution of non-byte-compiled code,
1173but can also bump into previously unnoticed cyclic dependencies.
1174These are generally harmless: they will simply cause the macro calls
1175to be left for later expansion (as before), but will result in a
1176warning ("Eager macro-expansion skipped due to cycle") describing the cycle.
1177You may wish to restructure your code so this does not happen.
1178
1179** New sampling-based Elisp profiler.
1180Try M-x profiler-start, do some work, and then call M-x profiler-report.
1181When finished, use M-x profiler-stop. The sampling rate can be based on
1182CPU time or memory allocations.
1183
500fcedc
SM
1184** `defun' also accepts a (declare DECLS) form, like `defmacro'.
1185The interpretation of the DECLS is determined by `defun-declarations-alist'.
1186
6bc66c10
GM
1187** New macros `setq-local' and `defvar-local'.
1188
1189** Face underlining can now use a wave.
2f940384 1190
6bc66c10 1191** `read-regexp' has a new argument HISTORY; the first argument PROMPT
cd996018 1192of `read-regexp' accepts a string ending with a colon and space, and its
823b2fb6 1193second argument DEFAULTS can be a list of strings accessible via `M-n'
cd996018
CY
1194in the minibuffer ahead of other hard-coded useful regexp-related values.
1195More commands use `read-regexp' now to read their regexp arguments.
1196
f938eda9 1197** Completion
500fcedc 1198
f938eda9
CY
1199*** New function `completion-table-with-quoting' to handle completion
1200in the presence of quoting, such as file completion in shell buffers.
f95e9344 1201
f938eda9
CY
1202*** New function `completion-table-subvert' to use an existing completion
1203table, but with a different prefix.
1204
6bc66c10 1205** Debugger
f95e9344 1206
f938eda9
CY
1207*** New error type and new function `user-error'.
1208These do not trigger the debugger.
f95e9344 1209
57fc0fee
GM
1210*** New option `debugger-bury-or-kill', saying what to do with the
1211debugger buffer when exiting debug.
45b82ad0
SM
1212
1213*** Set `debug-on-message' to enter the debugger when a certain
1214message is displayed in the echo area. This can be useful when trying
1215to work out which code is doing something.
2f940384 1216
45b82ad0
SM
1217*** New var `inhibit-debugger', automatically set to prevent accidental
1218recursive invocations.
fa2bcf43 1219
6bc66c10 1220** Window handling
2f940384 1221
6bc66c10
GM
1222*** New command `fit-frame-to-buffer' adjusts the frame height to
1223fit the contents.
2f940384 1224
6bc66c10
GM
1225*** The command `fit-window-to-buffer' can adjust the frame height
1226if the new option `fit-frame-to-buffer' is non-nil.
8e17c9ba 1227
7fe37cfc
GM
1228*** New macro `with-temp-buffer-window', similar to
1229`with-output-to-temp-buffer'.
fa2bcf43 1230
8e17c9ba
MR
1231*** `temp-buffer-resize-mode' no longer resizes windows that have been
1232reused.
c5e28e39 1233
823b2fb6 1234*** New option `switch-to-buffer-preserve-window-point' to restore a
43bcfda6 1235window's point when switching buffers.
7c82753d 1236
6bc66c10
GM
1237*** New display action alist entries `window-height' and `window-width'
1238specify the size of new windows created by `display-buffer'.
1239
1240*** New display action alist entry `pop-up-frame-parameters', if
1241non-nil, specifies frame parameters to give any newly-created frame.
7c82753d 1242
fa2bcf43
MR
1243*** New display action alist entry `inhibit-switch-frame', if non-nil,
1244tells display action functions to avoid changing which frame is
1245selected.
2f940384 1246
fa2bcf43
MR
1247*** New display action alist entry `previous-window', if non-nil,
1248specifies window to reuse in `display-buffer-in-previous-window'.
2f940384 1249
6bc66c10
GM
1250*** New display action functions `display-buffer-below-selected',
1251and `display-buffer-in-previous-window'.
1252
1253*** The functions `get-lru-window', `get-mru-window' and `get-largest-window'
1254now accept a third argument to avoid choosing the selected window.
1255
1256*** Additional values recognized for option `window-combination-limit'.
5938d519 1257
77f1f99c
CY
1258*** The following variables are obsolete, as they can be replaced by
1259appropriate entries in the `display-buffer-alist' function introduced
1260in Emacs 24.1:
823b2fb6 1261**** `dired-shrink-to-fit'
77f1f99c 1262**** `display-buffer-reuse-frames'
823b2fb6 1263**** `display-buffer-function'
77f1f99c 1264**** `special-display-buffer-names'
823b2fb6 1265**** `special-display-frame-alist'
77f1f99c 1266**** `special-display-function'
823b2fb6 1267**** `special-display-regexps'
77f1f99c 1268
ab0fa4e4 1269** Time
2f940384 1270
ab0fa4e4
PE
1271*** `current-time-string' no longer requires that its argument's year
1272must be in the range 1000..9999. It now works with any year supported
1273by the underlying C implementation.
2f940384 1274
f938eda9
CY
1275*** `current-time' now returns extended-format time stamps
1276(HIGH LOW USEC PSEC), where the new PSEC slot specifies picoseconds.
1277PSEC is typically a multiple of 1000 on current machines. Other
823b2fb6
GM
1278functions that use this format, such as `file-attributes' and
1279`format-time-string', have been changed accordingly. Old-format time
f938eda9 1280stamps are still accepted.
2f940384 1281
823b2fb6 1282*** The format of timers in `timer-list' and `timer-idle-list' is now
f938eda9
CY
1283[TRIGGERED-P HI-SECS LO-SECS USECS REPEAT-DELAY FUNCTION ARGS IDLE-DELAY PSECS].
1284The PSECS slot is new, and uses picosecond resolution. It can be
823b2fb6 1285accessed via the new `timer--psecs' accessor.
2f940384 1286
c4132fd4
PE
1287*** Last-modified time stamps in undo lists now are of the form
1288(t HI-SECS LO-SECS USECS PSECS) instead of (t HI-SECS . LO-SECS).
1289
0058cae2
GM
1290** EIEIO
1291
1292*** Improved security when handling persistent objects:
1293
1294**** `eieio-persistent-read' now features optional arguments for specifying
1295the class to load, as well as a flag stating whether subclasses are allowed;
1296if provided, other classes will be rejected by the reader. For
1297compatibility with existing code, if the class is omitted only a
1298warning is issued.
1299
1300**** New specialized reader for pulling in classes and signaling errors
1301without evaluation of suspicious code.
1302
1303**** All slots that contain objects must have a :type. Slots with lists
1304of objects must use a new type predicate for a list of an object type.
1305
1306*** Support for `find-function' and similar utilities, through the addition
1307of filename support to generated symbols.
1308
f938eda9 1309** Floating point functions now always return special values like NaN,
823b2fb6 1310instead of signaling errors, if given invalid args; e.g., (log -1.0).
f938eda9
CY
1311Previously, they returned NaNs on some platforms but signaled errors
1312on others. The affected functions are acos, asin, tan, exp, expt,
1313log, log10, sqrt, and mod.
1314
6bc66c10 1315** New fringe bitmap `exclamation-mark'.
f938eda9 1316
6bc66c10
GM
1317** Miscellaneous changes to special forms and macros
1318
1319*** `defun' and `defmacro' are now macros rather than special forms.
1320
1321*** `kbd' is now a function rather than a macro.
1322
1323** Miscellaneous new functions
1324
1325*** `set-temporary-overlay-map' sets up a temporary keymap that
1326takes precedence over most other maps for a short while (normally one key).
f938eda9 1327
847a0561 1328*** `autoloadp' tests if its argument is an autoloaded object.
2f940384 1329
847a0561 1330*** `autoload-do-load' performs the autoloading operation.
2f940384 1331
f938eda9 1332*** `buffer-narrowed-p' tests if the buffer is narrowed.
2f940384 1333
f938eda9 1334*** `file-name-base' returns a file name sans directory and extension.
2f940384 1335
f938eda9 1336*** `function-get' fetches a function property, following aliases.
c990426a 1337
f938eda9 1338*** `posnp' tests if an object is a `posn'.
f938eda9 1339
f938eda9 1340*** `system-users' returns the user names on the system.
547d6865 1341
f938eda9 1342*** `system-groups' returns the group names on the system.
f938eda9 1343
f938eda9 1344*** `tty-top-frame' returns the topmost frame of a text terminal.
c990426a 1345
f938eda9 1346** The following functions and variables are obsolete:
847a0561 1347*** `automount-dir-prefix' (use `directory-abbrev-alist')
f938eda9 1348*** `buffer-has-markers-at'
1a9c6830 1349*** `macro-declaration-function' (use `macro-declarations-alist')
847a0561 1350*** `window-system-version' (provides no useful information)
93cacb6d 1351*** `dired-pop-to-buffer' (use `dired-mark-pop-up')
0e2ae83d 1352*** `query-replace-interactive'
49238e7f 1353*** `font-list-limit' (has had no effect since Emacs < 23)
86aa551c 1354
adce950d 1355\f
93e0bed6 1356* Changes in Emacs 24.3 on Non-Free Operating Systems
9078ead6 1357
4e98ad15 1358** Cygwin builds can use the native MS Windows user interface.
823b2fb6 1359Pass `--with-w32' to configure. The default remains the X11 interface.
53a63be6 1360
1a9c6830 1361** Two new functions are available in Cygwin builds:
6e9f7997
DC
1362`cygwin-convert-file-name-from-windows' and
1363`cygwin-convert-file-name-to-windows'. These functions allow Lisp
1364code to access the Cygwin file-name mapping machinery to convert
1365between Cygwin and Windows-native file and directory names.
de6e3a60 1366
4e98ad15 1367** When invoked with the -nw switch to run on the Windows text-mode terminal,
1ab0c851 1368Emacs now supports `mouse-highlight', help-echo (in the echo area), and
4e98ad15
GM
1369`mouse-autoselect-window'.
1370
1a9c6830 1371** On MS Windows Vista and later Emacs now supports symbolic links.
4e98ad15 1372
823b2fb6 1373** On MS Windows, you can pass `--without-libxml2' to configure.bat to omit
4e98ad15
GM
1374support for libxml2, even if its presence is detected.
1375
4e98ad15
GM
1376** On Mac OS X, the Nextstep port requires OS X 10.4 or later.
1377
823b2fb6 1378** On Mac OS X, configure no longer automatically adds the Fink "/sw"
4e98ad15
GM
1379directories to the search path. You must add them yourself if you want them.
1380
2a1e2476
GM
1381\f
1382* Changes in Emacs 24.2
1383
5190da91 1384** This is mainly a bug-fix release.
6dad7178 1385
9078ead6 1386\f
eb199145 1387* Installation Changes in Emacs 24.1
09e18d03 1388
31fd3586
GM
1389** Emacs can be compiled with Gtk+ 3.0 if you pass --with-x-toolkit=gtk3
1390to configure. Note that other libraries used by Emacs, RSVG and GConf,
1391also depend on Gtk+. You can disable them with --without-rsvg and
1392--without-gconf.
338648ad 1393
31fd3586
GM
1394** Emacs can be compiled with GnuTLS support.
1395This happens by default if a suitably recent version of the library is
1396found at build time. To prevent this, use the configure option
1397`--without-gnutls'. See below for GnuTLS features.
338648ad 1398
31fd3586
GM
1399** Emacs can be compiled with SELinux support.
1400This happens by default if a suitably recent version of the library is
1401found at build time. To prevent this, use the configure option
1402`--without-selinux'. See below for SELinux features.
aded53ff 1403
31fd3586
GM
1404** Emacs can be compiled with ImageMagick support.
1405This happens by default if a suitably recent version of the library is
1406found at build time. To prevent this, use the configure option
1407`--without-imagemagick'. See below for ImageMagick features.
c1f10868 1408This feature is not available for the Nextstep or MS ports.
d9170db5 1409
043efd56
GM
1410** Emacs can be compiled with libxml2 support.
1411This happens by default if a suitably recent version of the library is
1412found at build time. To prevent this, use the configure option
1413`--without-xml2'. See below for libxml2 features.
1414
7d301ae6
CY
1415** By default, the installed Info and man pages are compressed.
1416You can disable this by configuring --without-compress-info.
1417
7d301ae6 1418** New configure option --with-wide-int.
81eafe29 1419With it, Emacs integers typically have 62 bits, even on 32-bit machines.
0a768890
PE
1420On 32-bit hosts, this raises the limit on buffer sizes from about 512 MiB
1421to about 2 GiB.
81eafe29 1422
7d301ae6 1423** New configure options: --with-mmdf, --with-mail-unlink, --with-mailhost.
31fd3586
GM
1424These provide no new functionality, they just remove the need to edit
1425lib-src/Makefile by hand in order to use the associated features.
1426
7d301ae6 1427** New configure option --enable-use-lisp-union-type.
31fd3586
GM
1428This is only useful for Emacs developers to debug certain types of bugs.
1429This is not a new feature; only the configure flag is new.
041d709f
CY
1430
1431** The standalone programs digest-doc and sorted-doc are removed.
1432Emacs now uses Lisp commands `doc-file-to-man' and `doc-file-to-info'.
1433
041d709f
CY
1434** The standalone program `fakemail' is removed.
1435If you need it, feedmail.el provides a superset of the functionality.
1436
0bfd685e 1437\f
eb199145 1438* Startup Changes in Emacs 24.1
4a263588 1439
198a7a97 1440** The --unibyte, --multibyte, --no-multibyte, and --no-unibyte
adbf62ff
GM
1441command line arguments, and the EMACS_UNIBYTE environment variable, no
1442longer have any effect. (They were declared obsolete in Emacs 23.)
198a7a97 1443
66b7b0fe 1444** New command line option `--no-site-lisp' removes site-lisp directories
1b5e5b0c
GM
1445from load-path. -Q now implies this. This option does not affect the
1446EMACSLOADPATH environment variable (and hence has no effect for
c8d59ba3 1447Nextstep builds).
66b7b0fe 1448
0bfd685e 1449\f
eb199145 1450* Changes in Emacs 24.1
7841339b 1451
a2a25d24 1452** Completion
fdeb32ec 1453
dfdb4cad
CY
1454*** Many packages now use the `completion-at-point' command,
1455rather than implementing separate completion commands.
1456
de0bde62 1457*** `completion-at-point' now handles tags and semantic completion.
dfdb4cad 1458
a2a25d24
SM
1459*** Completion in a non-minibuffer now tries to detect the end of completion
1460and pops down the *Completions* buffer accordingly.
dfdb4cad
CY
1461
1462*** New option `completion-cycle-threshold' allows completion cycling.
1463
1464*** New option `completion-category-overrides' for overriding the
2c719188 1465default completion style in certain circumstances.
dfdb4cad 1466
a2a25d24 1467*** New completion style `substring'.
dfdb4cad
CY
1468
1469*** Completion of buffer names uses `substring' completion by default.
1470
1471*** The option `widget-complete-field' has been removed.
620c53a6 1472
6870aaef 1473** Mail changes
dfdb4cad 1474
7d301ae6
CY
1475*** The first time you try sending mail, Emacs asks for a mail method.
1476This is implemented by a new default for `send-mail-function', which
1477is `sendmail-query-once'. This offers to use the smtpmail package, or
1478to use the old defaults relying on external mail facilities
1479(`sendmail-send-it' on GNU/Linux and other Unix-like systems, and
1480`mailclient-send-it' on Windows).
dfdb4cad 1481
e78e7e48
CY
1482*** Typing `C-c m' in the buffer made by `M-x report-emacs-bug'
1483transfers the report to your desktop's preferred mail client, if there
1484is one. This uses either the "xdg-email" utility, or Mac OS's "open"
1485command.
dfdb4cad 1486
7d301ae6
CY
1487*** See Changes in Specialized Modes and Packages for SMTPmail changes
1488and Mail mode changes
3f88cd72 1489
041d709f 1490** Emacs server and client changes
dfdb4cad 1491
7d301ae6 1492*** New option `server-port' specifies the port for TCP Emacs servers.
dfdb4cad 1493
041d709f 1494*** New emacsclient argument -q/--quiet suppresses some status messages.
dfdb4cad 1495
7d301ae6
CY
1496*** New emacsclient argument --frame-parameters specifies the frame
1497parameters of any newly-created graphical frame.
dfdb4cad
CY
1498
1499*** If emacsclient shuts down due to Emacs signaling an error,
1500its exit status is 1.
1501
041d709f
CY
1502*** New emacsclient argument --parent-id ID.
1503This opens a client frame in parent X window ID, via XEmbed, similar
1504to the --parent-id argument to Emacs.
1505
d0ce9f8c
MB
1506** Internationalization changes
1507
d0ce9f8c 1508*** Emacs now supports display and editing of bidirectional text.
7d301ae6
CY
1509Right-to-left (RTL) scripts, such as Arabic, Farsi, and Hebrew, are
1510displayed in the correct visual order as expected by users of those
dfdb4cad
CY
1511scripts. The display reordering is a "full bidirectionality" class
1512implementation of the Unicode Bidirectional Algorithm (UBA). Buffers
1513with no RTL text should look exactly the same as before.
f4b6ba46 1514
041d709f 1515**** New buffer-local variable `bidi-display-reordering'.
7d301ae6 1516To disable display reordering in a buffer, change this to nil.
d20e1419 1517
041d709f
CY
1518**** New buffer-local variable `bidi-paragraph-direction'.
1519If nil (the default), Emacs determines the base direction of each
dfdb4cad
CY
1520paragraph from its text, as specified by the UBA. Setting the value
1521to `right-to-left' or `left-to-right' forces a base direction on each
1522paragraph.
f4b6ba46 1523
7d301ae6
CY
1524Paragraphs with right-to-left base direction are displayed starting at
1525the right window edge.
f1816485 1526
dfdb4cad
CY
1527*** Enhanced support for characters with no glyphs in available fonts,
1528or, on text terminals, characters that cannot be encoded by the
1529terminal coding system. The new option `glyphless-char-display-control'
1530specifies how to display them: as a hexadecimal code in a box, a thin
15311-pixel space, an empty box, etc.
d0ce9f8c 1532
9702b7a1
GM
1533*** New input methods for Farsi and Bulgarian
1534(farsi-isiri-9147, farsi-transliterate-banan, bulgarian-alt-phonetic).
041d709f 1535
939db9ac
CY
1536*** `nobreak-char-display' now also highlights Unicode hyphen chars
1537(U+2010 and U+2011).
1538
7d301ae6 1539*** New Hebrew translation of the Emacs Tutorial.
31fd3586
GM
1540Type `C-u C-h t' to choose it in case your language setup doesn't
1541automatically select it.
1542
7d301ae6
CY
1543** An Emacs Lisp package manager is now included.
1544This is a convenient way to download and install additional packages,
1545from a package repository at http://elpa.gnu.org.
dfdb4cad 1546
7d301ae6
CY
1547*** M-x list-packages shows a list of packages, which can be
1548selected for installation.
dfdb4cad 1549
7d301ae6 1550*** New command `describe-package', bound to `C-h P'.
dfdb4cad 1551
7d301ae6
CY
1552*** By default, all installed packages are loaded automatically when
1553Emacs starts up. To disable this, set `package-enable-at-startup' to
1554nil. To specify the packages to load, customize `package-load-list'.
16a91140 1555
dfdb4cad
CY
1556** Custom theme changes
1557
7d301ae6
CY
1558*** New command `M-x customize-themes', which provides a convenient
1559interface for enabling and disabling Custom themes.
dfdb4cad 1560
7d301ae6 1561*** New option `custom-theme-load-path' is the load path for themes.
dfdb4cad
CY
1562Emacs no longer looks for Custom themes in `load-path'. The default
1563value of `custom-theme-load-path' says to look for themes in
1564`custom-theme-directory', followed by a subdirectory of
1565`data-directory' named "themes/", which contains a small selection of
1566built-in Custom themes.
1567
7d301ae6
CY
1568*** New option `custom-safe-themes' records known-safe theme files.
1569If a theme is not in this list, Emacs queries before loading it, and
1570offers to save the theme to `custom-safe-themes' automatically. By
1571default, all themes included in Emacs are treated as safe.
b7d65a5f 1572
7d301ae6 1573** Improved GTK integration
dfdb4cad 1574
7d301ae6 1575*** GTK scroll-bars are now placed on the right by default.
dfdb4cad
CY
1576The function `set-scroll-bar-mode' can change this.
1577
7d301ae6 1578*** GTK tool bars can have just text, just images or images and text.
dfdb4cad
CY
1579Customize `tool-bar-style' to choose the style. On a Gnome desktop,
1580the default is taken from desktop settings.
1581
1582*** GTK tool bars can be placed on any edge of the frame.
7d301ae6
CY
1583The frame-parameter tool-bar-position controls this. It takes the
1584values top, left, right or bottom. The Options => Show/Hide menu has
1585entries for this.
dfdb4cad 1586
7d301ae6
CY
1587*** The default colors for selected text (the `region' face) are taken
1588from the GTK theme when Emacs is built with GTK.
dfdb4cad 1589
7d301ae6
CY
1590*** Emacs uses GTK tooltips by default if built with GTK.
1591You can disable this by changing `x-gtk-use-system-tooltips' to nil.
a5bee597 1592
dfdb4cad
CY
1593** Graphical interface changes
1594
1595*** On graphical displays, the mode-line no longer ends in dashes.
1596Also, the first dash (which does not indicate anything) is just
1597displayed as a space.
1598
1599*** `menu-bar-select-buffer-function' lets you choose another operation
1600instead of `switch-to-buffer' when selecting an item in the Buffers menu.
1601
1602*** Lucid menus and dialogs can display antialiased fonts if Emacs is
1603built with Xft. These fonts can be set via X resources, for example:
1604Emacs.pane.menubar.font: Courier-12
1605
7d301ae6 1606** Exiting changes
dfdb4cad 1607
7d301ae6 1608*** Emacs now calls `kill-emacs' if it receives SIGTERM or SIGHUP,
dfdb4cad
CY
1609or if it receives a SIGINT signal in batch mode.
1610
7d301ae6
CY
1611*** `kill-emacs-hook' is now also run in batch mode.
1612Third-party code which adds to `kill-emacs-hook' should check if they
1613do the right thing in batch mode.
9c524fcb 1614
041d709f 1615** Scrolling changes
dfdb4cad 1616
041d709f 1617*** New scrolling commands `scroll-up-command' and `scroll-down-command'
0a19a6f8 1618(bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
7d301ae6 1619of buffer at first key-press (instead they move to top/bottom of buffer)
550f41cd 1620when `scroll-error-top-bottom' is non-nil.
dfdb4cad
CY
1621
1622*** New option `scroll-error-top-bottom' (see above).
1623
041d709f 1624*** New scrolling commands `scroll-up-line' and `scroll-down-line'
5a97d2da 1625scroll a line instead of full screen.
dfdb4cad 1626
041d709f 1627*** New property `scroll-command' should be set on a command's symbol to
b2957ea8 1628define it as a scroll command affected by `scroll-preserve-screen-position'.
dfdb4cad 1629
041d709f 1630*** If you customize `scroll-conservatively' to a value greater than 100,
d0f69533
EZ
1631Emacs will never recenter point in the window when it scrolls due to
1632cursor motion commands or commands that move point (e.f., `M-g M-g').
1633Previously, you needed to use `most-positive-fixnum' as the value of
1634`scroll-conservatively' to achieve the same effect.
dfdb4cad 1635
7d301ae6 1636*** "Aggressive" scrolling now honors the scroll margins.
d0f69533
EZ
1637If you customize `scroll-up-aggressively' or
1638`scroll-down-aggressively' and move point off the window, Emacs now
1639scrolls the window so as to avoid positioning point inside the scroll
1640margin.
1641
7d301ae6
CY
1642** Basic SELinux support has been added.
1643This requires Emacs to be linked with libselinux at build time.
f1a5d776 1644
dfdb4cad
CY
1645*** Emacs preserves the SELinux file context when backing up.
1646Also, the function `copy-file' has an extra optional argument for
1647preserving SELinux context, and the return value of `backup-buffer'
1648now includes the SELinux context.
f0bf7c8e 1649
dfdb4cad 1650*** New functions `file-selinux-context' and `set-file-selinux-context'
7d301ae6 1651get and set the SELinux context of a file.
44198b6e 1652
7d301ae6 1653** Trash changes
dfdb4cad 1654
7d301ae6
CY
1655*** `delete-by-moving-to-trash' now only affects commands that specify
1656trashing. This avoids inadvertently trashing temporary files.
dfdb4cad 1657
7d301ae6
CY
1658*** Calling `delete-file' or `delete-directory' with a prefix argument
1659now forces true deletion, regardless of `delete-by-moving-to-trash'.
278f6845 1660
041d709f 1661** File- and directory-local variable changes
dfdb4cad 1662
041d709f
CY
1663*** You can stop directory local vars from applying to subdirectories.
1664Add an element (subdirs . nil) to the alist portion of any variables
1665settings to indicate that the section should not apply to
1666subdirectories.
dfdb4cad 1667
041d709f
CY
1668*** Directory local variables can apply to some file-less buffers.
1669Affected modes include dired, vc-dir, and log-edit. For example,
1670adding "(diff-mode . ((mode . whitespace)))" to .dir-locals.el will
1671turn on `whitespace-mode' for *vc-diff* buffers. Modes should call
1672`hack-dir-local-variables-non-file-buffer' to support this.
dfdb4cad 1673
041d709f
CY
1674*** Using "mode: MINOR-MODE" to enable a minor mode is deprecated.
1675Instead, use "eval: (minor-mode 1)".
c136e5cd 1676
7b447e9b
GM
1677*** The variable `inhibit-first-line-modes-regexps' has been renamed
1678to `inhibit-local-variables-regexps'. As the name suggests, it now
dfdb4cad
CY
1679applies to ALL file local variables, not just -*- lines. The
1680associated `inhibit-first-line-modes-suffixes' has been renamed in the
1681corresponding way.
5d907d6c 1682
0a2132ba
CY
1683** Window changes
1684
91b65361
CY
1685*** The `quit-window' command now restores the last buffer displayed
1686in the quitted window.
1687
0a2132ba
CY
1688*** Resizing an Emacs frame now preserves proportional window sizes,
1689modulo restrictions like window minimum sizes and fixed-size windows.
1690
1691*** The behavior of `display-buffer' is now customizable in detail.
dfdb4cad 1692
0a2132ba
CY
1693**** New option `display-buffer-base-action' specifies a list of
1694user-determined display "actions" (functions and optional arguments
1695for choosing the displaying window).
1696
1697This takes precedence over the default display action, which is
1698specified by `display-buffer-fallback-action'.
1699
1700**** New option `display-buffer-alist' maps buffer name regexps to
1701display actions, taking precedence over `display-buffer-base-action'.
1702
a0c2d0ae
MR
1703*** New option `window-combination-limit'.
1704The new option `window-combination-limit' allows to return the space
1705obtained for resizing or creating a window more reliably to the window
1706from which such space was obtained.
0a2132ba 1707
a0c2d0ae
MR
1708*** New option `window-combination-resize'.
1709The new option `window-combination-resize' allows to split a window that
1710otherwise cannot be split because it's too small by stealing space from
1711other windows in the same combination. Subsequent resizing or deletion
1712of the window will resize all windows in the same combination as well.
0a2132ba 1713
91b65361
CY
1714*** New option `frame-auto-hide-function' lets you choose between
1715iconifying or deleting a frame when burying a buffer in a dedicated
1716frame, or quitting a window showing a buffer in a frame of its own.
1717
0a2132ba 1718*** New commands `maximize-window' and `minimize-window'.
53964682 1719These maximize and minimize the size of a window within its frame.
0a2132ba 1720
0a2132ba
CY
1721*** New commands `switch-to-prev-buffer' and `switch-to-next-buffer'.
1722These functions allow to navigate through the live buffers that have
1723been shown in a specific window.
1724
7d301ae6 1725** Minibuffer changes
dfdb4cad 1726
7d301ae6 1727*** The inactive minibuffer has its own major mode `minibuffer-inactive-mode'.
104dc9c6
GM
1728This is handy for minibuffer-only frames, and is also used for the feature
1729where mouse-1 pops up *Messages*"', which can now easily be changed.
041d709f 1730
7d301ae6 1731*** Minibuffers set `truncate-lines' to nil.
f66eca26 1732If you want to change the value to something else, you could use
7d301ae6
CY
1733for example `minibuffer-setup-hook'.
1734
7d301ae6
CY
1735** `auto-mode-case-fold' is now enabled by default.
1736
7d301ae6 1737** `backup-by-copying-when-mismatch' now defaults to t.
f66eca26 1738
dfdb4cad
CY
1739** New basic faces `error', `warning', `success'.
1740These are used to highlight text indicating failure, caution or
1741successful operation.
1742
1743** New option `list-colors-sort' defines the color sort order
1744for `list-colors-display'.
1745
1746** The variable `focus-follows-mouse' now always defaults to nil.
1747
0bfd685e 1748\f
eb199145 1749* Editing Changes in Emacs 24.1
b350bdf2 1750
892777ba 1751** Search changes
dfdb4cad
CY
1752
1753*** C-y in Isearch is now bound to `isearch-yank-kill', instead of
1754`isearch-yank-line'.
1755
1756*** M-y in Isearch is now bound to `isearch-yank-pop', instead of
1757`isearch-yank-kill'.
1758
1759*** M-s C-e in Isearch is now bound to `isearch-yank-line'.
1760
b2b0776e 1761** New commands `count-words-region' and `count-words'.
dfdb4cad 1762
10607bea
CY
1763*** M-= is bound to `count-words-region', not `count-lines-region'.
1764The `count-words-region' command, when called interactively, reports
1765the number of lines, words, and characters in the region. It is a
1766superset of the old `count-lines-region', which is now an obsolete
1767alias for it.
ea4f7750 1768
ec9da840 1769** The command `just-one-space' (M-SPC), if given a negative argument,
1c708c1a
CY
1770also deletes newlines around point.
1771
b9229673 1772** Deletion changes
dfdb4cad 1773
b9229673 1774*** New option `delete-active-region'.
ddb54206 1775If non-nil, [delete] and DEL delete the region if it is active and no
dfdb4cad 1776prefix argument is given. If set to `kill', those commands kill
ddb54206 1777instead.
dfdb4cad 1778
59ee0542 1779*** New command `delete-forward-char', bound to [delete].
42d9cffa
CY
1780This is meant for interactive use, and obeys `delete-active-region'.
1781The command `delete-char' does not obey `delete-active-region'.
dfdb4cad 1782
b9229673
CY
1783*** `delete-backward-char' is now a Lisp function.
1784Apart from obeying `delete-active-region', its behavior is unchanged.
7d301ae6
CY
1785However, the byte compiler now warns if it is called from Lisp; Lisp
1786callers should use delete-char with a negative argument instead.
dfdb4cad 1787
b9229673
CY
1788*** The option `mouse-region-delete-keys' has been deleted.
1789
f9d71b42
CY
1790** Selection changes.
1791
7d301ae6
CY
1792The default handling of clipboard and primary selections has been
1793changed to conform with modern X applications. In short, most
1794commands for killing and yanking text now use the clipboard, while
1795mouse commands use the primary selection.
b1ab31ae
CY
1796
1797In the following, we provide a list of these changes, followed by a
1798list of steps to get the old behavior back if you prefer that.
1799
b1ab31ae
CY
1800*** `select-active-regions' now defaults to t.
1801Merely selecting text (e.g. with drag-mouse-1) no longer puts it in
963578d3 1802the kill ring. The selected text is put in the primary selection, if
b1ab31ae
CY
1803the system possesses a separate primary selection facility (e.g. X).
1804
1805**** `select-active-regions' also accepts a new value, `only'.
1806This means to only set the primary selection for temporarily active
1807regions (usually made by mouse-dragging or shift-selection);
1808"ordinary" active regions, such as those made with C-SPC followed by
1809point motion, do not alter the primary selection.
1810
963578d3
CY
1811**** `mouse-drag-copy-region' now defaults to nil.
1812
b1ab31ae
CY
1813*** mouse-2 is now bound to `mouse-yank-primary'.
1814This pastes from the primary selection, ignoring the kill-ring.
1815Previously, mouse-2 was bound to `mouse-yank-at-click'.
dfdb4cad 1816
b1ab31ae 1817*** `x-select-enable-clipboard' now defaults to t on all platforms.
dfdb4cad 1818
b1ab31ae
CY
1819*** `x-select-enable-primary' now defaults to nil.
1820Thus, commands that kill text or copy it to the kill-ring (such as
1821M-w, C-w, and C-k) also use the clipboard---not the primary selection.
1822
1823**** The "Copy", "Cut", and "Paste" items in the "Edit" menu are now
dfdb4cad 1824exactly equivalent to M-w, C-w, and C-y respectively.
b1ab31ae
CY
1825
1826**** Note that on MS-Windows, `x-select-enable-clipboard' was already
1827non-nil by default, as Windows does not support the primary selection
1828between applications.
1829
1830*** To return to the previous behavior, do the following:
dfdb4cad 1831
104c2fe9 1832**** Change `select-active-regions' to nil.
b1ab31ae
CY
1833**** Change `mouse-drag-copy-region' to t.
1834**** Change `x-select-enable-primary' to t (on X only).
1835**** Change `x-select-enable-clipboard' to nil.
1836**** Bind `mouse-yank-at-click' to mouse-2.
f9d71b42 1837
084e6df3 1838*** Support for X cut buffers has been removed.
dfdb4cad 1839
3fd50d5c
CY
1840*** X clipboard managers are now supported.
1841To inhibit this, change `x-select-enable-clipboard-manager' to nil.
4b80f674 1842
dfdb4cad
CY
1843** New command `C-x r N' (`rectangle-number-lines') numbers the lines
1844in the current rectangle. With a prefix argument, this prompts for a
1845number to count from and for a format string.
99f053cf 1846
7d301ae6 1847** `redisplay-dont-pause' now defaults to t.
6bf7006f
EZ
1848This makes Emacs feel more responsive to editing commands that arrive
1849at high rate, e.g. if you lean on some key, because stopping redisplay
1850in the middle (when this variable is nil) forces more expensive
1851updates later on, and Emacs appears to be unable to keep up.
1852
e70b5064
CY
1853** The behavior of <TAB> for active regions in Text mode has changed.
1854In Text and related modes, typing <TAB> (`indent-for-tab-command')
1855when the region is active causes Emacs to indent all the lines in the
1856region, aligning them with the line previous to the first line in the
1857region (or with the left margin if there is no previous line).
1858
dfdb4cad
CY
1859** When `occur' is called with a prefix argument, matching strings are
1860collected into the `*Occur*' buffer without line numbers. If there
1861are parenthesized subexpressions in the specified regexp, `occur'
1862reads replacement text that may contain \\& and \\N whose convention
1863follows `replace-match'.
1864
9bae34bf 1865\f
eb199145 1866* Changes in Specialized Modes and Packages in Emacs 24.1
efeb796b 1867
041d709f 1868** Archive Mode has basic support for browsing and updating 7z archives.
d76674bb 1869
b7c3692a 1870** BibTeX mode
dfdb4cad 1871
2de69e00 1872*** BibTeX mode now supports biblatex.
7d301ae6
CY
1873Use the variable `bibtex-dialect' to select different BibTeX dialects.
1874`bibtex-entry-field-alist' is now an obsolete alias for
1875`bibtex-BibTeX-entry-alist'.
1876
dfdb4cad
CY
1877*** New command `bibtex-search-entries', bound to C-c C-a.
1878
b7c3692a 1879*** New `bibtex-entry-format' option `sort-fields', disabled by default.
dfdb4cad 1880
022fe7ce
RW
1881*** New variable `bibtex-search-entry-globally'.
1882
7d301ae6 1883** Browse-url
dfdb4cad 1884
7d301ae6 1885*** New option `browse-url-mailto-function' specifies how to handle "mailto:"s.
dfdb4cad 1886
7d301ae6
CY
1887*** The default browser used by the package is now the "xdg-open" program,
1888on platforms that support it. This calls your desktop's preferred browser.
1889
86e100a6
GM
1890** Calc
1891
1892*** Support for musical notes.
1893
1894*** Support for logarithmic units.
1895
1896*** No longer uses the tex prefix for TeX specific unit names when
1897using TeX or LaTeX mode.
1898
1899*** New option to highlight selections using faces.
1900
1901*** `calc-histogram' has the option of using a vector to determine the bins.
1902
1903*** New "O" option prefix.
1904
1905*** Use the "O" prefix to "d r" (`calc-radix') to turn on twos-complement mode.
1906
cf16af42
GM
1907** Calendar, Diary, and Appt
1908
7d301ae6 1909*** Diary entries can contain non-printing "comments".
548d0a63
GM
1910See the variable `diary-comment-start'.
1911
5006e634
GM
1912*** Appointments can specify their individual warning times.
1913See the variable `appt-warning-time-regexp'.
1914
0a2bb1a9
GM
1915*** The function specified by `appt-disp-window-function' may be passed
1916lists of arguments if multiple appointments are due at similar times.
1917If you are using a custom function for this, you should update it.
1918
7454f200
GM
1919*** New function `diary-hebrew-birthday'.
1920
e565dd37
GM
1921*** Elements of `calendar-day-abbrev-array' and `calendar-month-abbrev-array'
1922may no longer be nil, but must all be strings.
1923
7d301ae6
CY
1924*** The obsolete (since Emacs 22.1) method of enabling the appt
1925package by adding `appt-make-list' to `diary-hook' has been removed.
1926Use `appt-activate' instead.
cf16af42 1927
cf16af42
GM
1928*** Some appt variables (obsolete since Emacs 22.1) have been removed:
1929appt-issue-message (use the function appt-activate)
1930appt-visible/appt-msg-window (use the variable appt-display-format)
1931
cf16af42
GM
1932*** Some diary function aliases (obsolete since Emacs 22.1) have been removed:
1933view-diary-entries, list-diary-entries, show-all-diary-entries
1934
551b046f 1935** CC Mode
dfdb4cad 1936
551b046f 1937*** New feature to "guess" the style in an existing buffer.
7d301ae6 1938The main entry point is M-x c-guess.
041d709f 1939
551b046f
AM
1940*** Java Mode now supports Java 5.0 (Tiger) and 6 (Mustang).
1941
dfdb4cad 1942*** `c-beginning-of-defun' and `c-end-of-defun' now respect nested scopes.
551b046f
AM
1943Thus C-M-a will, by default, go to the beginning of the immediate function,
1944not the top level.
1945
dfdb4cad 1946*** "Macros with semicolons" can be registered for correct indentation.
551b046f
AM
1947Where such a macro ends a line (no semicolon) the next statement is no longer
1948parsed as a statement continuation.
1949
dfdb4cad 1950** Comint and modes derived from it use the standard completion code.
041d709f
CY
1951
1952** Compilation mode
dfdb4cad 1953
7d301ae6 1954*** Compilation mode can be used without Font Lock mode.
041d709f
CY
1955`compilation-parse-errors-function' is now obsolete.
1956
dfdb4cad 1957*** New variable `compilation-filter-start', which is bound while
7d301ae6
CY
1958`compilation-filter-hook' runs. It records the start position of the
1959text inserted by `compilation-filter'.
041d709f 1960
47a6a35f
GM
1961*** `compilation-error-screen-columns' and `compilation-first-column'
1962are obeyed in the editing buffer. So programming language modes can
7d301ae6
CY
1963set them, whereas previously only the value in the *Compilation*
1964buffer was used.
1dce7193 1965
52834b6b
CY
1966** Customize
1967
1968*** Customize buffers now contain a search field.
1969The search is performed using `customize-apropos'.
7d301ae6 1970To turn off the search field, set `custom-search-field' to nil.
52834b6b 1971
8d5dd370 1972*** Options in customize group buffers start out hidden if not customized.
52834b6b
CY
1973Use the arrow to the left of the option name to toggle visibility.
1974
1975*** custom-buffer-sort-alphabetically now defaults to t.
1976
1977*** The color widget now has a "Choose" button, which allows you to
7d301ae6 1978choose a color via `list-colors-display'.
52834b6b 1979
041d709f
CY
1980** D-Bus
1981
5da3be7f
GM
1982*** It is now possible to access buses other than the default system
1983or session bus.
041d709f 1984
7d301ae6 1985*** The `dbus-register-method' and `dbus-register-property' functions
5da3be7f 1986optionally do not register names.
041d709f 1987
7d301ae6 1988*** The new function `dbus-register-service' registers a known service
dfdb4cad 1989name on a D-Bus without also registering a property or a method.
041d709f 1990
f5d6548a 1991** Dired-x
425a25f1 1992
7d301ae6
CY
1993*** C-x C-j (`dired-jump') and C-x 4 C-j (`dired-jump-other-window'),
1994if called with a prefix argument, read a file name from the minibuffer
1995instead of using the current buffer.
f5d6548a 1996
7d301ae6 1997*** The "dired local variables" feature of Dired-x is obsolete.
817b48a7 1998The standard directory local variables feature replaces it.
8117868f 1999
041d709f 2000** ERC changes
7492acc9 2001
c4077254
GM
2002*** New options `erc-autojoin-timing' and `erc-autojoin-delay',
2003controlling attempts to autojoin a channel.
041d709f
CY
2004
2005*** New variable `erc-coding-system-precedence': If we use `undecided'
2006as the server coding system, this variable will then be consulted.
2007The default is to decode strings that can be decoded as utf-8 as
2008utf-8, and do the normal `undecided' decoding for the rest.
7492acc9 2009
041d709f 2010** Eshell changes
7492acc9 2011
05f77e38
GM
2012*** The default value of `eshell-directory-name' has changed
2013to be an "eshell" directory in `user-emacs-directory'.
2014The old "~/.eshell/" directory is still used if it exists, though.
041d709f
CY
2015
2016** gdb-mi
dfdb4cad
CY
2017
2018*** The M-x gdb command now uses the GDB Machine Interface protocol.
05f77e38
GM
2019It now supports multithread non-stop debugging and simultaneous
2020debugging of several threads.
7492acc9 2021
18af70d0
CY
2022** Image mode
2023
05f77e38
GM
2024*** RET (`image-toggle-animation') toggles animation, if applicable.
2025Animation plays once, unless the option `image-animate-loop' is non-nil.
18af70d0 2026
041d709f 2027** Info
723ee192 2028
7d301ae6 2029*** New command M-x info-display-manual displays a named Info manual.
2ebc3b94
GM
2030If that manual is already visited in some Info buffer, it displays
2031that buffer. (This is handy if you have many manuals in many *info*
2032buffers, and don't remember the name of the buffer visiting the manual
2033you want to consult.) Otherwise, it loads and displays the manual.
691cf4a0 2034
24ea72d3
EZ
2035*** `e' is now bound to `end-of-buffer' rather than to `Info-edit'.
2036This is for compatibility with the stand-alone Info reader program,
2037and also because `Info-edit' is a rarely used command that is disabled
2038by default.
2039
7d301ae6 2040** Mail mode changes (not Message mode)
dfdb4cad 2041
7d301ae6 2042*** New command M-x mail-add-attachment for adding MIME attachments
7d301ae6 2043
dfdb4cad
CY
2044*** The command M-x mail-attach-file was renamed to M-x mail-insert-file.
2045(Its name is misleading, since it has nothing to do with MIME
2046attachments.) The old name is now an obsolete alias to the new name.
2047
f2c3a9eb 2048** MH-E has been updated to MH-E version 8.3.1.
041d709f 2049See MH-E-NEWS for details.
37221432 2050
041d709f 2051** Modula-2 mode provides auto-indentation.
37221432 2052
041d709f 2053** mpc.el: Can use pseudo tags of the form tag1|tag2 as a union of two tags.
3c3d4f5b 2054
5d1ac394 2055** nXML mode no longer binds C-RET to `nxml-complete'.
dfdb4cad
CY
2056Completion is now performed via `completion-at-point', bound to C-M-i
2057or M-TAB. If `nxml-bind-meta-tab-to-complete-flag' is non-nil (the
2058default), this performs tag completion.
5d1ac394 2059
f2c3a9eb
CY
2060** Org mode has been updated to version 7.8.09.
2061See ORG-NEWS for details.
2062
041d709f 2063** Prolog mode has been completely revamped, with lots of additional
7d301ae6
CY
2064functionality such as more intelligent indentation, electricity,
2065support for more variants, including Mercury, and a lot more.
041d709f
CY
2066
2067** Rmail
2068
2069*** The command `rmail-epa-decrypt' decrypts OpenPGP data
2070in the Rmail incoming message.
2071
50419064
GM
2072*** The variable `rmail-message-filter' no longer has any effect.
2073This change was made in Emacs 23.1 but was not advertised at the time.
2074Try using `rmail-show-message-hook' instead.
2075
717a1362 2076** Shell mode
dfdb4cad
CY
2077
2078*** M-x shell prompts for the shell path name if the default directory
2079is a remote file name and neither the environment variable $ESHELL nor
2080the variable `explicit-shell-file-name' is set.
2081
2082*** TAB is now bound to the standard `completion-at-point' command,
2083which now implements the pcomplete rules for shell command completion.
717a1362 2084
7d301ae6
CY
2085** SMTPmail
2086
dfdb4cad 2087*** SMTPmail now uses encrypted connections (via STARTTLS) by default
7d301ae6
CY
2088if the mail server supports them. This uses either built-in GnuTLS
2089support, or the starttls.el library. Customize `smtpmail-stream-type'
2090to change this.
2091
7d301ae6
CY
2092*** The variable `smtpmail-auth-credentials' has been removed.
2093By default, the information is now stored in the file ~/.authinfo.
dfdb4cad
CY
2094This was the default value of smtpmail-auth-credentials. If you had
2095customized smtpmail-auth-credentials to a list of user names and
2096passwords, those settings are not used. During your first connection
2097to the smtp server, Emacs will prompt for the user name and password,
2098and offer to save them to ~/.authinfo. Or you can manually copy the
2099credentials to ~/.authinfo. For example, if you had
7d301ae6
CY
2100
2101 (setq smtpmail-auth-credentials
2102 '(("mail.example.org" 25 "jim" "s!cret")))
2103
2104then the equivalent line in ~/.authinfo would be
2105
2106 machine mail.example.org port 25 login jim password s!cret
2107
2108See the auth-source manual for more information, e.g. on encrypting
2109the credentials file.
2110
7d301ae6 2111*** The variable `smtpmail-starttls-credentials' has been removed.
dfdb4cad 2112If you had that set, you need to put
7d301ae6
CY
2113
2114 machine smtp.whatever.foo port 25 key "~/.my_smtp_tls.key" cert "~/.my_smtp_tls.cert"
2115
2116in your ~/.authinfo file instead.
2117
8ce192e3
LI
2118*** SMTPmail defaults to using the address in the From: header as the
2119SMTP MAIL FROM envelope. To override this, set `mail-envelope-from'
2120to the address you wish to use instead.
2121
34e8a2da 2122** SQL mode
041d709f 2123
34e8a2da
GM
2124*** New options `sql-port', `sql-connection-alist', `sql-send-terminator',
2125and `sql-oracle-scan-on'.
041d709f 2126
dfdb4cad 2127*** New options controlling prompting for login parameters.
34e8a2da
GM
2128Each supported product has a custom variable `sql-*-login-params',
2129which is a list of the parameters to be prompted for before a
2130connection is established.
041d709f
CY
2131
2132*** The command `sql-product-interactive' now takes a prefix argument,
34e8a2da 2133which causes it to prompt for an SQL product.
041d709f 2134
34e8a2da 2135*** Product-specific SQL interactive commands now take prefix arguments.
041d709f
CY
2136These commands (`sql-sqlite', `sql-postgres', `sql-mysql', etc.),
2137given a prefix argument, prompt for a name for the SQL interactive
2138buffer. This reduces the need for calling `sql-rename-buffer'.
2139
2140*** SQL interactive modes suppress command continuation prompts, and
2141replace tabs with spaces. The first change impacts multiple line SQL
2142statements entered with C-j between each line, statements yanked into
2143the buffer and statements sent with `sql-send-*' functions. The
34e8a2da
GM
2144second prevents the MySQL and Postgres interpreters from listing
2145object name completions when sent text via `sql-send-*' functions.
041d709f
CY
2146
2147*** New command `sql-connect' starts a predefined SQLi session,
2148using the login parameters from `sql-connection-alist'.
2149
2150*** New "Save Connection" menu item in SQLi buffers.
2151This gathers the login params specified for the SQLi session, if it
2152was not started by a connection, and saves them as a new connection.
2153
34e8a2da
GM
2154*** New commands for listing database objects and details:
2155sql-list-all and sql-list-table.
041d709f
CY
2156
2157*** An API for manipulating SQL product definitions has been added.
2158
2159** TeX modes
2160
2161*** latex-electric-env-pair-mode keeps \begin..\end matched on the fly.
412b9ee5 2162
459bba37 2163** Tramp
dfdb4cad 2164
7d301ae6 2165*** New inline access method "ksu" (kerberized su).
dfdb4cad 2166
459bba37 2167*** The following access methods are discontinued: "ssh1_old",
ea843702 2168"ssh2_old", "scp1_old", "scp2_old", "imap", "imaps" and "fish".
dfdb4cad 2169
b011fbfe
GM
2170*** The user option `remote-file-name-inhibit-cache' controls whether
2171remote file attributes are cached for better performance.
dfdb4cad 2172
58f74fe4
MA
2173*** The option `ange-ftp-binary-file-name-regexp' has changed its
2174default value to "".
dfdb4cad 2175
7d301ae6
CY
2176*** Handlers for `file-selinux-context' and `set-file-selinux-context'
2177for remote machines which support SELinux.
58f74fe4 2178
dfdb4cad 2179** New function `url-queue-retrieve', which behaves like url-retrieve,
a48ec60c
GM
2180but with limits (`url-queue-parallel-processes', `url-queue-timeout') on
2181the degree of parallelism.
177549d0 2182
0c32ce32
CY
2183** VC and related modes
2184
2185*** Support for pulling on distributed version control systems.
7d301ae6
CY
2186The command C-x v + (`vc-pull') runs a "pull" operation, if it is
2187supported (currently with Bzr, Git, and Mercurial), to update the
2188current branch and working tree. A prefix argument means to prompt
2189the user for specifics, e.g. a pull location.
0c32ce32 2190
dab3703d 2191*** `vc-update' is now an alias for `vc-pull'.
0c32ce32
CY
2192
2193*** Support for merging on distributed version control systems.
7d301ae6
CY
2194The command C-x v m (`vc-merge') now runs a "merge" operation, if it
2195is supported (currently with Bzr, Git, and Mercurial), to merge
2196changes from another branch into the current one. It prompts for
2197specifics, e.g. a merge source.
0c32ce32 2198
2afef60a 2199*** New option `vc-revert-show-diff' controls whether `vc-revert'
bbe43420 2200shows a diff while querying the user. It defaults to t.
2afef60a 2201
d4eb88c7
CY
2202*** Log entries in some Log View buffers can be toggled to display a
2203longer description by typing RET (log-view-toggle-entry-display).
dab3703d
GM
2204This is currently supported for Bzr, Git, and Mercurial (to support
2205another backend, define a `log-view-expanded-log-entry-function').
7d301ae6 2206In the Log View buffers made by C-x v L (`vc-print-root-log'), you can
d4eb88c7
CY
2207use this to display the full log entry for the revision at point.
2208
1c6c854e
CS
2209*** New command `vc-ediff' allows visual comparison of two revisions
2210of a file similar to `vc-diff', but using ediff backend.
2211
86c60681
CY
2212*** The option `vc-initial-comment' was removed in Emacs 23.2, but
2213this was not advertised at the time.
2214
86c60681
CY
2215*** `vc-toggle-read-only' is an obsolete alias for `toggle-read-only'.
2216Since Emacs 23, it has done the same thing as `toggle-read-only', but
80c6d77f
GM
2217this was not advertised at the time.
2218
041d709f
CY
2219** Obsolete modes
2220
23d70505
GM
2221*** abbrevlist.el
2222
f8ca9162 2223*** erc-hecomplete.el (use erc-pcomplete.el instead)
23d70505
GM
2224
2225*** partial-completion-mode (complete.el) is obsolete.
041d709f
CY
2226You can get a comparable behavior with:
2227(setq completion-styles '(partial-completion initials))
2228(setq completion-pcm-complete-word-inserts-delimiters t)
2229
23d70505
GM
2230*** pc-mode.el is obsolete (CUA mode is much more comprehensive).
2231
2c719188 2232*** pgg is obsolete (use EasyPG instead).
041d709f
CY
2233
2234*** sregex.el is obsolete, since rx.el is a strict superset.
2235
23d70505
GM
2236*** s-region.el and pc-select.el are obsolete.
2237They are superseded by shift-select-mode, enabled by default since 23.1.
2238
2c719188 2239*** vc-mcvs.el is obsolete (for lack of a maintainer).
ca5eed61 2240
0fe719e6
GM
2241** Miscellaneous
2242
05f77e38 2243*** The Landmark game is now invoked with `landmark', not `lm'.
c6ad2a4e 2244Its functions and variables have been similarly renamed.
05f77e38 2245
dfdb4cad 2246*** In `ido-file-completion-map', C-v is no longer bound to `ido-toggle-vc'.
05f77e38
GM
2247(This interfered with cua-mode.)
2248
9f678528
GM
2249*** f90.el has some support for Fortran 2008 syntax.
2250
0fe719e6
GM
2251*** `copyright-fix-years' can optionally convert consecutive years to ranges.
2252
5b3e6db8
GM
2253*** New command `nato-region' converts text to NATO phonetic alphabet.
2254
eb199145
GM
2255\f
2256* New Modes and Packages in Emacs 24.1
d445b3f8 2257
60e56523 2258** Occur Edit mode applies edits made in *Occur* buffers to the
8c0f49f0 2259original buffers. It is bound to "e" in Occur mode.
60e56523 2260
a075a2c5
GM
2261** New global minor mode electric-pair-mode.
2262When enabled, typing an open parenthesis automatically inserts the
2263matching closing one.
2264
2265** New global minor mode electric-indent-mode.
2266When enabled, typing certain characters triggers reindentation.
cd3308f3
GM
2267Major modes wishing to use this can set electric-indent-chars or
2268electric-indent-functions.
a075a2c5
GM
2269
2270** New global minor mode electric-layout-mode.
2271When enabled, typing certain characters automatically inserts newlines.
cd3308f3 2272Major modes wishing to use this can set electric-layout-rules.
3b843809 2273
a83ec3c9
CY
2274** tabulated-list.el provides a generic major mode for tabulated data,
2275from which other modes can be derived.
2276
d02c9bcd
SM
2277** pcase.el provides the ML-style pattern matching macro `pcase'.
2278
7725ebb7
MA
2279** secrets.el is an implementation of the Secret Service API, an
2280interface to password managers like GNOME Keyring or KDE Wallet. The
065f2743
MA
2281Secret Service API requires D-Bus for communication. The command
2282`secrets-show-secrets' offers a buffer with a visualization of the
2283secrets.
7725ebb7 2284
f9e78150
MA
2285** notifications.el provides an implementation of the Desktop
2286Notifications API. It requires D-Bus for communication.
2287
12fe5bcc
MA
2288** soap-client.el supports access to SOAP web services from Emacs.
2289soap-inspect.el is an interactive inspector for SOAP WSDL structures.
2290
ff1796f3 2291** New generic mode, xmodmap-generic-mode, for xmodmap files.
ad7d6ecb 2292
53bbe3ad 2293** New emacs-lock.el package.
7d301ae6
CY
2294The previous version has been moved to obsolete/old-emacs-lock.el.
2295Now, there is a proper minor mode `emacs-lock-mode'. Protection
2296against exiting Emacs and killing the buffer can be set separately.
2297The mechanism for automatically turning off protection for buffers
2298with dead inferior processes has been generalized.
53bbe3ad 2299
eb199145
GM
2300\f
2301* Incompatible Lisp Changes in Emacs 24.1
6dfcbe31 2302
7d301ae6
CY
2303** Passing a nil argument to a minor mode function call now ENABLES
2304the minor mode unconditionally. This is so that you can write e.g.
2305
dfdb4cad 2306 (add-hook 'text-mode-hook 'foo-mode)
7d301ae6 2307
dfdb4cad
CY
2308to enable foo-mode in Text mode buffers, removing the need for
2309`turn-on-foo-mode' style functions. This affects all mode commands
2310defined by `define-minor-mode'. If called interactively, the mode
2311command still toggles the minor mode.
7d301ae6 2312
d268b4fe
CY
2313** The return value of `backup-buffer' has changed.
2314It is now a list of three elements, where the second element is a list
2315describing the original file's SELinux context. If Emacs or the
f003f294 2316system lacks SELinux support, the context list is (nil nil nil nil).
7d301ae6 2317See "Basic SELinux support" above, under "Changes in Emacs 24.1".
d268b4fe 2318
dfdb4cad
CY
2319** `char-direction-table' and the `char-direction' function were deleted.
2320They were buggy and inferior to the new support of bidirectional
2321editing introduced in Emacs 24. If you need the bidirectional
2322properties of a character, use `get-char-code-property' with the last
2323argument `bidi-class'.
fa6996bc 2324
470d996d
TV
2325** `copy-directory' now copies the source directory as a subdirectory
2326of the target directory, if the latter is an existing directory. The
2327new optional arg COPY-CONTENTS, if non-nil, makes the function copy
2328the contents directly into a pre-existing target directory.
2329
9173a8fb
CY
2330** For mouse click input events in the text area, the Y pixel
2331coordinate in the POSITION list now counts from the top of the text
2332area, excluding any header line. Previously, it counted from the top
2333of the header line.
2334
7d301ae6
CY
2335** Support for "old-style" backquotes, obsolete for 10+ years, has
2336been further reduced. Now a backquote not followed by a space is
2337always treated as a "new-style" backquote. Please remove all
2338"old-style" backquotes from your code. If your code uses backquotes
2339as documented in the Elisp manual, and compiles without warning, then
2340you have nothing to do in this regard. Code not following the
2341appropriate conventions may fail to compile.
50ab02c5
CY
2342
2343The most common cause of trouble seems to be an old-style backquote
2344followed by a newline. Another cause of trouble is vector notation
2345for key sequence notation: instead of [(control ,)] and [(control ')],
2346you should write [(control ?,)] and [(control ?')], which will work in
7d301ae6 2347older Emacsen too.
288cf4e9 2348
520f2425
GM
2349** The macro `eval-at-startup' was removed in Emacs 23.2, but this
2350was not advertised at the time. The function `custom-initialize-delay'
2351replaced all known uses.
2352
7d301ae6
CY
2353** `view-buffer' now treats special mode-class in the same way that
2354`view-file' has since Emacs 22 (i.e. it won't enable View mode if the
2355major mode is special).
fd5c9dfa 2356
7d301ae6 2357** Menu and tool bar changes
6431f2e6 2358
7d301ae6 2359*** During startup, Emacs no longer adds entries for `menu-bar-lines'
0a19a6f8
JB
2360and `tool-bar-lines' to `default-frame-alist' and `initial-frame-alist'.
2361With these alist entries omitted, `make-frame' checks the value of the
2362variable `menu-bar-mode'/`tool-bar-mode' to determine whether to create
2363a menu-bar or tool-bar, respectively. If the alist entries are added,
2364they override the value of `menu-bar-mode'/`tool-bar-mode'.
6431f2e6 2365
7d301ae6
CY
2366*** The menu bar bindings's caches are not used any more.
2367Use (where-is-internal <def> nil t) instead.
2368
fe0aa820 2369** Regions created by mouse dragging are now normal active regions,
dfdb4cad 2370similar to those created by shift-selection (see Selection changes
7d301ae6
CY
2371above). In previous Emacs versions, these regions were delineated by
2372`mouse-drag-overlay'; that variable has been removed.
d6d8ee7a 2373
7d301ae6
CY
2374** The fourth argument of `filter-buffer-substring' has been removed.
2375If you want to remove text properties from the final result, simply
2376pass the result through substring-no-properties.
34c99998 2377
4583e796
GM
2378** cl.el no longer provides `cl-19'.
2379
7d301ae6
CY
2380** The following obsolete functions and aliases have been removed
2381(the appropriate new function is given in parentheses; "not needed"
2382means you can just remove all calls to the function in question):
2383
2384*** `comint-kill-output' (`comint-delete-output')
2385*** `decompose-composite-char' (`char-to-string')
2386*** `outline-visible' (`outline-invisible-p')
2387*** `internal-find-face' (`facep')
2388*** `internal-get-face' (`facep and check-face')
2389*** `frame-update-faces' (not needed)
2390*** `frame-update-face-colors' (`frame-set-background-mode')
2391*** `x-frob-font-weight' and `x-frob-font-slant' (`make-face-*' functions)
2c719188 2392*** `x-make-font-bold and x-make-font-demibold (`make-face-bold')
7d301ae6
CY
2393*** `x-make-font-italic' and `x-make-font-oblique' (`make-face-italic')
2394*** `x-make-font-bold-italic' (`make-face-bold-italic')
2395*** `x-make-font-unbold' (`make-face-unbold')
2396*** `x-make-font-unitalic' (`make-face-unitalic')
2397*** `mldrag-drag-mode-line' (`mouse-drag-mode-line')
2398*** `mldrag-drag-vertical-line' (`mouse-drag-vertical-line')
2399*** `iswitchb-default-keybindings' (`iswitchb-mode')
2400*** `char-bytes' (== 1)
2401*** `isearch-return-char' (`isearch-printing-char')
2402*** `make-local-hook' (not needed)
2403*** `set-screen-height' (`set-frame-height')
2404*** `set-screen-width' (`set-frame-width')
2405
7d301ae6
CY
2406** The following obsolete variables and varaliases have been removed
2407(the appropriate new variable is given in parentheses):
2408
2409*** `checkdoc-minor-keymap' (`checkdoc-minor-mode-map')
2410*** `vc-header-alist' (`vc-BACKEND-header')
2411*** `directory-sep-char' (== ?/)
2412*** `font-lock-defaults-alist' (`font-lock-defaults')
2413*** `e' (`float-e').
3226d6ca 2414
041d709f 2415** The following obsolete files were removed:
7b0e3048
GM
2416sc.el, x-menu.el, rnews.el, rnewspost.el
2417
7d301ae6
CY
2418** The format of the finder-inf.el file has changed, since the Finder
2419mechanism is now based on the package system. The variable
2420`finder-package-info' is replaced by `package--builtins' and
2421`finder-keywords-hash'.
33658d4e 2422
c2c79260
DE
2423** When generating autoloads, `update-directory-autoloads' no longer
2424assumes every inspected file is in your `load-path'. It instead
2425generates relative names according to the current `load-path'.
2426
eb199145 2427\f
93e0bed6 2428* Lisp Changes in Emacs 24.1
9097e8af 2429
041d709f 2430** Code can now use lexical scoping by default instead of dynamic scoping.
dfdb4cad 2431The `lexical-binding' variable enables lexical scoping for local
48da7392 2432variables. It is typically set via a file-local variable in the first
dfdb4cad
CY
2433line of the file, in which case it applies to all the code in that
2434file.
2435
041d709f
CY
2436*** `eval' takes a new optional argument `lexical' to choose the new lexical
2437binding instead of the old dynamic binding mode.
dfdb4cad 2438
041d709f
CY
2439*** Lexically scoped interpreted functions are represented with a new form
2440of function value which looks like (closure ENV ARGS &rest BODY).
2441
2442*** New macro `letrec' to define recursive local functions.
dfdb4cad
CY
2443
2444*** `defvar' and `defconst' now mark the variable as special (dynamic).
2445So do `defcustom' and other forms that call `defvar' as a subroutine.
2446
041d709f
CY
2447*** New function `special-variable-p' to check whether a variable is
2448declared as dynamically bound.
2449
88ed9e87
SM
2450*** The form ((lambda ...) ...) is deprecated.
2451
041d709f
CY
2452** An Emacs Lisp testing tool is now included.
2453Emacs Lisp developers can use this tool to write automated tests for
2454their code. See the ERT info manual for details.
2455
2456** Changes for bidirectional display and editing
f1816485 2457
041d709f 2458*** New function `current-bidi-paragraph-direction'.
7d301ae6 2459This returns the base direction of the paragraph at point.
041d709f 2460
041d709f 2461*** New function `bidi-string-mark-left-to-right'.
dfdb4cad
CY
2462Given a string containing characters from right-to-left scripts, this
2463function returns another string which can be safely inserted into a
2464buffer, such that any following text will be always displayed to the
7d301ae6
CY
2465right of that string. (This works by appending an invisible Unicode
2466"LEFT-TO-RIGHT MARK" character if the argument string might need it.)
041d709f 2467
7d301ae6 2468This is useful when the buffer has overall left-to-right paragraph
dfdb4cad
CY
2469direction and you need to insert a string whose contents are not known
2470in advance, without disrupting the layout of the line.
041d709f 2471
bee0fcef 2472** Window changes
dfdb4cad 2473
c4682d18
MR
2474*** Window tree functions are accessible in Elisp.
2475Functions are provided to return the parent, siblings or child windows
2476of any window including internal windows (windows not associated with a
2477buffer) in the window tree.
dfdb4cad 2478
24300f5f
CY
2479**** New function `window-valid-p' gives non-nil for live and internal
2480windows.
dfdb4cad 2481
24300f5f 2482**** Window manipulation can deal with internal windows.
c4682d18
MR
2483Many window handling functions like `split-window', `delete-window', or
2484`delete-other-windows' as well as the window resizing functions can now
2485act on any window including internal ones.
dfdb4cad 2486
c4682d18
MR
2487*** window-total-height/-width vs window-body-height/-width.
2488The function `window-height' has been renamed to `window-total-height'
2489and `window-width' has been renamed to `window-body-width'. The old
2490names are provided as aliases. Two new functions `window-total-width'
2491and `window-body-height' are provided.
dfdb4cad 2492
c4682d18
MR
2493*** Window parameters specific to window handling functions.
2494For each window you can specify a parameter to override the default
2495behavior of a number of functions like `split-window', `delete-window'
ed6235ea
MR
2496and `delete-other-windows'. The variable `ignore-window-parameters'
2497allows to ignore processing such parameters.
dfdb4cad 2498
c4682d18 2499*** New semantics of third argument of `split-window'.
c4682d18
MR
2500The third argument of `split-window' has been renamed to SIDE and can be
2501set to any of the values 'below, 'right, 'above, or 'left to make the
2502new window appear on the corresponding side of the window that shall be
2503split. Any other value of SIDE will cause `split-window' to split the
2504window into two side-by-side windows as before.
dfdb4cad 2505
c4682d18 2506*** Window resizing functions.
487ffd7a 2507A new standard function for resizing windows called `window-resize' has
c4682d18
MR
2508been introduced. This and all other functions for resizing windows no
2509longer delete any windows when they become too small.
dfdb4cad 2510
b3c0dbfd
MR
2511*** Deleting the selected window now selects the most recently selected
2512live window on that frame instead.
dfdb4cad 2513
c4682d18
MR
2514*** `adjust-window-trailing-edge' adjustments.
2515`adjust-window-trailing-edge' can now deal with fixed-size windows and
2516is able to resize other windows if a window adjacent to the trailing
2517edge cannot be shrunk any more. This makes its behavior more similar to
2518that of Emacs 21 without compromising, however, its inability to delete
2519windows which was introduced in Emacs 22.
dfdb4cad 2520
c4682d18
MR
2521*** Window-local buffer lists.
2522Windows now have local buffer lists. This means that removing a buffer
2523from display in a window will preferably show the buffer previously
2524shown in that window with its previous window-start and window-point
2525positions. This also means that the same buffer may be automatically
2526shown twice even if it already appears in another window.
dfdb4cad 2527
bee0fcef
CY
2528*** `switch-to-buffer' has a new optional argument FORCE-SAME-WINDOW,
2529which if non-nil requires the buffer to be displayed in the currently
2530selected window, signaling an error otherwise. If nil, another window
2531can be used, e.g. if the selected one is strongly dedicated.
dfdb4cad 2532
0a2132ba 2533*** `split-window-vertically' and `split-window-horizontally' renamed
2d197ffb
CY
2534to `split-window-below' and `split-window-right' respectively.
2535The old names are kept as aliases.
dfdb4cad 2536
0a2132ba
CY
2537*** Display actions
2538
2539**** The second arg to `display-buffer' and `pop-to-buffer' is now
2540named ACTION, and takes a display action of the same form as
2541`display-buffer-base-action' (see Changes, above). A non-nil,
2542non-list value is treated specially, as the old meaning.
2543
2544**** New variable `display-buffer-overriding-action'.
2545
2546**** The procedure of `display-buffer' etc. to choose a window is
2547determined by combining `display-buffer-overriding-action',
2548`display-buffer-alist', the ACTION arg, `display-buffer-base-action',
2549and `display-buffer-fallback-action'. The second and fourth of these
2550are user-customizable variables.
2551
2552See the docstring of `display-buffer' for details.
bee0fcef 2553
20d2304d
CY
2554*** New functions `window-state-get' and `window-state-put'.
2555These functions allow to save and restore the state of an arbitrary
2556frame or window as an Elisp object.
2557
a2a25d24 2558** Completion
041d709f 2559
7d301ae6
CY
2560*** New variable `completion-extra-properties' used to specify extra
2561properties of the current completion:
a2a25d24
SM
2562- :annotate-function, same as the old completion-annotate-function.
2563- :exit-function, function to call after completion took place.
2564
7d301ae6
CY
2565*** Functions on `completion-at-point-functions' can return any of the
2566properties valid for `completion-extra-properties'.
a2a25d24 2567
7d301ae6 2568*** `completion-annotate-function' is obsolete.
a2a25d24 2569
620c53a6
SM
2570*** New `metadata' method for completion tables. The metadata thus returned
2571can specify various details of the data returned by `all-completions':
2572- `category' is the kind of objects returned (e.g., `buffer', `file', ...),
2573 used to select a style in completion-category-overrides.
2574- `annotation-function' to add annotations in *Completions*.
2575- `display-sort-function' to specify how to sort entries in *Completions*.
2576- `cycle-sort-function' to specify how to sort entries when cycling.
2577
7d301ae6
CY
2578*** `minibuffer-local-filename-must-match-map' is not used any more.
2579Instead, the bindings in `minibuffer-local-filename-completion-map'
2580are combined with `minibuffer-local-must-match-map'.
de09aa52
CY
2581
2582*** New variable `completing-read-function' allows overriding the
2583behavior of `completing-read'.
2584
f042970d 2585** `glyphless-char-display' can now distinguish between graphical and
16a43933
CY
2586text terminal display, via a char-table entry that is a cons cell.
2587
7d301ae6 2588** `pre-command-hook'/`post-command-hook' are not reset to nil on error.
f6d62986
SM
2589Instead, the offending function is removed.
2590
b1f6fa26
CY
2591** New hook types
2592
2593*** New function `run-hook-wrapped' for running an abnormal hook by
2594passing the hook functions as arguments to a "wrapping" function.
e7bc51d0 2595Like `run-hook-with-args-until-success', it stops at the first
5385447f 2596non-nil return value.
e7bc51d0 2597
b1f6fa26
CY
2598*** New macro `with-wrapper-hook' for running an abnormal hook as a
2599set of "wrapping" filters, similar to around advice.
54521c99
GM
2600(A version of this macro was actually added in Emacs 23.2 but was not
2601advertised at the time.)
f6d62986 2602
0b19b281 2603** Debugger changes
dfdb4cad 2604
0b19b281 2605*** New macro `condition-case-unless-debug' (this was actually added in
1be3ca5a 2606Emacs 23.1 as condition-case-no-debug, but not advertised)
dfdb4cad 2607
0b19b281 2608*** The macro `with-demoted-errors' was added in Emacs 23.1, but not advertised.
dfdb4cad 2609
0b19b281 2610*** Variable `stack-trace-on-error' removed.
dfdb4cad 2611
0b19b281
CY
2612*** The debugger can now "continue" from an error, which means it will
2613jump to the error handler as if the debugger had not been invoked
2614instead of jumping all the way to the top-level.
dfdb4cad 2615
0b19b281
CY
2616*** Set `debug-on-event' to enter the debugger on events like SIGUSR1.
2617This can be useful when `inhibit-quit' is set.
d6b1d521 2618
953cebf5 2619** The new function `server-eval-at' allows evaluation of Lisp forms on
37576acd 2620named Emacs server instances.
7deebf1b 2621
1b9f60cc
GM
2622** `call-process' and `call-process-region' allow a `(:file "file")' spec
2623to redirect STDOUT to a file.
7deebf1b 2624
7d301ae6
CY
2625** The function `format-time-string' now supports the %N directive,
2626for higher-resolution time stamps.
da97a9e6 2627
0b19b281 2628** New input reading functions
dfdb4cad 2629
0b19b281
CY
2630*** New function `read-char-choice' reads a restricted set of
2631characters, discarding any inputs not inside the set.
dfdb4cad 2632
0b19b281
CY
2633*** The command `read-color' now requires a match for a color name
2634or RGB triplet, instead of signaling an error if the user provides
2635invalid input.
dfdb4cad 2636
0b19b281 2637**** `facemenu-read-color' is now an alias for `read-color'.
3ef01959 2638
2e288d54
JB
2639** `image-library-alist' is renamed to `dynamic-library-alist'.
2640The variable is now used to load all kind of supported dynamic libraries,
2641not just image libraries. The previous name is still available as an
2642obsolete alias.
2643
0b19b281 2644** Syntax parsing changes
dfdb4cad 2645
0b19b281 2646*** New variable `syntax-propertize-function'.
04e2ce72 2647This replaces `font-lock-syntactic-keywords' which is now obsolete.
cf38dd42
SM
2648This allows syntax-table properties to be set independently from font-lock:
2649just call syntax-propertize to make sure the text is propertized.
2650Together with this new variable come a new hook
2651syntax-propertize-extend-region-functions, as well as two helper functions:
2652syntax-propertize-via-font-lock to reuse old font-lock-syntactic-keywords
2653as-is; and syntax-propertize-rules which provides a new way to specify
2654syntactic rules.
dfdb4cad 2655
0b19b281 2656*** Syntax tables support a new "comment style c" additionally to style b.
a2e5caf7 2657
7d301ae6 2658** New hook `post-self-insert-hook', run after `self-insert-command'.
041d709f 2659
4e2db1fe 2660** frame-local variables cannot be let-bound any more.
041d709f 2661
15de15c6 2662** Major and minor mode changes
dfdb4cad 2663
0b19b281
CY
2664*** `set-auto-mode' now respects mode: local variables at the end of files,
2665as well as those in the -*- line.
dfdb4cad 2666
15de15c6
CY
2667*** `prog-mode' is a new major mode from which programming modes
2668should be derived.
dfdb4cad 2669
15de15c6
CY
2670**** `prog-mode-hook' can be used to enable features for programming
2671modes, e.g. (add-hook 'prog-mode-hook 'flyspell-prog-mode) to enable
2672on-the-fly spell checking for comments and strings.
dfdb4cad 2673
15de15c6
CY
2674*** New hook `change-major-mode-after-body-hook', run by
2675`run-mode-hooks' just before any other mode hooks.
dfdb4cad 2676
7a9a2fc6
GM
2677*** Enabled globalized minor modes can be disabled in specific major modes.
2678If the global mode is global-FOO-mode, then run (FOO-mode -1) in the
2679major mode's hook, where FOO-mode toggles the mode on a per-buffer basis.
dfdb4cad 2680
feb8a83a 2681*** `define-minor-mode' accepts new keywords :variable, :after-hook.
f44379e7 2682
7d301ae6
CY
2683** File-handling changes
2684
7d301ae6 2685*** `delete-file' and `delete-directory' now accept optional arg TRASH.
f1a5d776
CY
2686Trashing is performed if TRASH and `delete-by-moving-to-trash' are
2687both non-nil. Interactively, TRASH defaults to t, unless a prefix
2688argument is supplied (see Trash changes, above).
53967e09 2689
7d301ae6 2690*** New file predicates: `file-equal-p', `file-in-directory-p'.
ec70a47d 2691
4039c786
CY
2692** Tool-bars can display separators.
2693Tool-bar separators are handled like menu separators in menu-bar maps,
94975270 2694i.e. via menu entries of the form `(menu-item "--")'.
9317e499 2695
00fe2df1
JL
2696** Image API
2697
18af70d0
CY
2698*** Animated images support (currently animated gifs only).
2699
2700**** `image-animated-p' returns non-nil if an image can be animated.
2701
2702**** `image-animate' animates a supplied image spec.
2703
2704**** `image-animate-timer' returns the timer object for an image that
2705is being animated.
00fe2df1 2706
7cb76fe0
GM
2707*** `image-extension-data' has been renamed to `image-metadata'.
2708The old name is an obsolete alias to the new one.
1546c559 2709
b4ac6e8c
GM
2710*** Image mode can view any image type that ImageMagick supports.
2711This requires Emacs to be built with ImageMagick support.
7d301ae6
CY
2712
2713**** New function `imagemagick-types', defined if ImageMagick support
2714is enabled, returns a list of image file extensions that your
2715ImageMagick installation supports.
2716
2717**** New function `imagemagick-register-types' enables ImageMagick
2718image types in Image mode and in `create-image' and other helper
2719functions.
2720
2721**** New option `imagemagick-types-inhibit' excludes certain
2722ImageMagick image types from `imagemagick-register-types'.
2723
7d301ae6
CY
2724**** With ImageMagick support, there are extra Image mode commands to
2725resize and rotate images: `image-transform-fit-to-height',
2726`image-transform-fit-to-width', `image-transform-set-rotation', and
2727`image-transform-set-scale'.
041d709f 2728
7d301ae6
CY
2729** `compose-mail' now accepts an optional 8th arg, RETURN-ACTION, and
2730passes it to the mail user agent function. This argument specifies an
2731action for returning to the caller after finishing with the mail. For
2732example, this is used by Rmail to optionally delete a mail window.
b4ac6e8c 2733
71c17aec 2734** XML and HTML parsing
483ab230
CY
2735If Emacs is compiled with libxml2 support, there are two new
2736functions: `libxml-parse-html-region' (which parses "real world" HTML)
2737and `libxml-parse-xml-region' (which parses XML). Both return an
2738Emacs Lisp parse tree.
4b9832a6 2739
7d301ae6 2740** Networking and encryption changes
e2574f2c 2741
7d301ae6
CY
2742*** `open-network-stream' can now be used to open an encrypted stream.
2743It now accepts an optional `:type' parameter for initiating a TLS
2744connection, directly or via STARTTLS. To do STARTTLS, additional
2745parameters (`:end-of-command', `:success', `:capabilities-command')
2746must also be supplied.
2747
2748*** New library gnutls.el.
dfdb4cad
CY
2749The new function `gnutls-available-p' returns non-nil if Emacs is
2750built with GnuTLS support. The main entry points are
2751`open-gnutls-stream' and `gnutls-negotiate'. It's easiest to use
2752these functions through `open-network-stream', because that can
7d301ae6
CY
2753upgrade connections through STARTTLS opportunistically or use plain
2754SSL, depending on your needs. For debugging, set `gnutls-log-level'
2755greater than 0.
2756
7d301ae6
CY
2757*** New primitive `secure-hash' that supports many secure hash algorithms:
2758md5, sha1, sha2, sha224, sha256, sha384, and sha512. The lisp library
2759sha1.el has been removed. The `sha1' feature is provided by default.
71c17aec 2760
a6020335
MH
2761** Isearch
2762
2763*** New hook `isearch-update-post-hook' that runs in `isearch-update'.
2764
9326ba26
CY
2765** Progress reporters can now "spin".
2766The MIN-VALUE and MAX-VALUE arguments of `make-progress-reporter' can
2767now be nil, or omitted. This makes a "non-numeric" reporter. Each
2768time you call `progress-reporter-update' on that progress reporter,
2769with a nil or omitted VALUE argument, the reporter message is
2770displayed with a "spinning bar".
2771
3e214b50
JB
2772** New variable `revert-buffer-in-progress-p' is true while a buffer is
2773being reverted, even if the buffer has a local `revert-buffer-function'.
2774
001bf877
GM
2775** New variables `delayed-warnings-list' and `delayed-warnings-hook'.
2776If delayed-warnings-list is non-nil, the command loop calls
7d301ae6
CY
2777`delayed-warnings-hook' after `post-command-hook'. At present, this
2778is only used by Emacs on some platforms to display warnings during
2779startup, which might otherwise not be noticed. This uses the
2780functions `display-delayed-warnings' and `collapse-delayed-warnings'.
001bf877 2781
6420d28b
CY
2782** rx.el has a new `group-n' construct for explicitly numbered groups.
2783
dac86404
GM
2784** New function `make-composed-keymap' that constructs a new keymap
2785from multiple input maps. You can use this to make a keymap that
2786inherits from multiple maps, eg:
2787 (set-keymap-parent newmap (make-composed-keymap othermap parent))
43dc9f5b 2788
c8f6ec5c
GM
2789** New function `string-prefix-p'.
2790(This was actually added in Emacs 23.2 but was not advertised at the time.)
2791
27f7ef2f 2792** New reader macro ## that stands for the empty symbol.
43dc9f5b
AS
2793This means that the empty symbol can now be read back. Also, #: by itself
2794(when not immediately followed by a possible symbol character) stands for
2795an empty uninterned symbol.
041d709f 2796
fead402d
CY
2797** New math functions `isnan', `copysign', `frexp', `ldexp'.
2798
7d301ae6 2799** The following functions and variables are obsolete:
041d709f 2800
05f77e38
GM
2801*** `tooltip-use-echo-area' is obsolete.
2802Rather than setting this to t, disable Tooltip mode instead.
2803
041d709f
CY
2804*** buffer-substring-filters is obsolete.
2805Use `filter-buffer-substring-functions' instead.
2806
2807*** `byte-compile-disable-print-circle' is obsolete.
2808
2809*** `deferred-action-list' and `deferred-action-function' are obsolete.
f160676e
GM
2810Use `post-command-hook' instead.
2811
67e729a5
CY
2812*** `font-lock-maximum-size' is obsolete.
2813
eb199145 2814\f
93e0bed6 2815* Changes in Emacs 24.1 on Non-Free Operating Systems
d53a60a6 2816
7a22e700 2817** On MS Windows, Emacs warns when using the obsolete init file _emacs,
a2f0118c
GM
2818and also when HOME is set to C:\ by default.
2819
7a22e700 2820** New configure.bat options
04779484 2821
7a22e700 2822*** --enable-checking builds Emacs with extra runtime checks.
e3aef5c6 2823
7a22e700 2824*** --distfiles specifies files to be included in binary distribution.
e2574f2c 2825
7a22e700
OK
2826*** --without-gnutls disables automatic GnuTLS detection.
2827
a0d363f4 2828*** --lib for general library linkage, works with the USER_LIBS build variable.
e2574f2c 2829
0a19a6f8 2830** New make target `dist' to create binary distribution for MS Windows.
e3aef5c6 2831
1f5e1a16
GM
2832** The Lisp function `w32-default-color-map' is now obsolete.
2833(It is only used internally in the Emacs C code.)
5430d399 2834
1f5e1a16
GM
2835** Customize ns-auto-hide-menu-bar to have the menu-bar hidden, but
2836reappear on mouse-over. (Requires OS X 10.6 or later.)
04e2ce72 2837
ad7c802c
CY
2838** On Mac OS X, dragging a file into Emacs visits the file, like on
2839other platforms, rather than inserting its contents into the buffer.
2840
05197f40 2841\f
a933dad1 2842----------------------------------------------------------------------
5b87ad55 2843This file is part of GNU Emacs.
a933dad1 2844
ab73e885 2845GNU Emacs is free software: you can redistribute it and/or modify
5b87ad55 2846it under the terms of the GNU General Public License as published by
ab73e885
GM
2847the Free Software Foundation, either version 3 of the License, or
2848(at your option) any later version.
5b87ad55
GM
2849
2850GNU Emacs is distributed in the hope that it will be useful,
2851but WITHOUT ANY WARRANTY; without even the implied warranty of
2852MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2853GNU General Public License for more details.
a933dad1 2854
5b87ad55 2855You should have received a copy of the GNU General Public License
ab73e885 2856along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
a933dad1 2857
05197f40 2858\f
a933dad1
DL
2859Local variables:
2860mode: outline
2861paragraph-separate: "[ \f]*$"
2862end: