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