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