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