Small VC doc fixes
[bpt/emacs.git] / etc / NEWS
1 GNU Emacs NEWS -- history of user-visible changes.
2
3 Copyright (C) 2010-2012 Free Software Foundation, Inc.
4 See the end of the file for license conditions.
5
6 Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
7 If possible, use M-x report-emacs-bug.
8
9 This file is about changes in Emacs version 24.
10
11 See files NEWS.23, NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18,
12 and NEWS.1-17 for changes in older Emacs versions.
13
14 You can narrow news to a specific version by calling `view-emacs-news'
15 with a prefix argument or by typing C-u C-h C-n.
16
17
18 Temporary note:
19 +++ indicates that the appropriate manual has already been updated.
20 --- means no change in the manuals is called for.
21 When you add a new item, please add it without either +++ or ---
22 so we will look at it and add it to the manual.
23
24 \f
25 * Installation Changes in Emacs 24.1
26
27 ---
28 ** Emacs can be compiled with Gtk+ 3.0 if you pass --with-x-toolkit=gtk3
29 to configure. Note that other libraries used by Emacs, RSVG and GConf,
30 also depend on Gtk+. You can disable them with --without-rsvg and
31 --without-gconf.
32
33 ---
34 ** Emacs can be compiled with GnuTLS support.
35 This happens by default if a suitably recent version of the library is
36 found at build time. To prevent this, use the configure option
37 `--without-gnutls'. See below for GnuTLS features.
38
39 ---
40 ** Emacs can be compiled with SELinux support.
41 This happens by default if a suitably recent version of the library is
42 found at build time. To prevent this, use the configure option
43 `--without-selinux'. See below for SELinux features.
44
45 ---
46 ** Emacs can be compiled with ImageMagick support.
47 This happens by default if a suitably recent version of the library is
48 found at build time. To prevent this, use the configure option
49 `--without-imagemagick'. See below for ImageMagick features.
50 This feature is not available for the Nextstep or MS ports.
51
52 ---
53 ** Emacs can be compiled with libxml2 support.
54 This happens by default if a suitably recent version of the library is
55 found at build time. To prevent this, use the configure option
56 `--without-xml2'. See below for libxml2 features.
57
58 ---
59 ** There is a new configure option --with-wide-int.
60 With it, Emacs integers typically have 62 bits, even on 32-bit machines.
61 On 32-bit hosts, this raises the limit on buffer sizes from about 512 MiB
62 to about 2 GiB.
63
64 ---
65 ** By default, the installed Info and man pages are compressed.
66 You can disable this by configuring --without-compress-info.
67
68 ---
69 ** There are new configure options:
70 --with-mmdf, --with-mail-unlink, --with-mailhost.
71 These provide no new functionality, they just remove the need to edit
72 lib-src/Makefile by hand in order to use the associated features.
73
74 ---
75 ** There is a new configure option --enable-use-lisp-union-type.
76 This is only useful for Emacs developers to debug certain types of bugs.
77 This is not a new feature; only the configure flag is new.
78
79 ---
80 ** The standalone programs digest-doc and sorted-doc are removed.
81 Emacs now uses Lisp commands `doc-file-to-man' and `doc-file-to-info'.
82
83 ---
84 ** The standalone program `fakemail' is removed.
85 If you need it, feedmail.el provides a superset of the functionality.
86
87 \f
88 * Startup Changes in Emacs 24.1
89
90 ---
91 ** The --unibyte, --multibyte, --no-multibyte, and --no-unibyte
92 command line arguments, and the EMACS_UNIBYTE environment variable, no
93 longer have any effect. (They were declared obsolete in Emacs 23.)
94
95 +++
96 ** New command line option `--no-site-lisp' removes site-lisp directories
97 from load-path. -Q now implies this. This option does not affect the
98 EMACSLOADPATH environment variable (and hence has no effect for
99 Nextstep builds.)
100
101 \f
102 * Changes in Emacs 24.1
103
104 +++
105 ** auto-mode-case-fold is now enabled by default.
106
107 ** Completion
108
109 *** shell-mode uses pcomplete rules, with the standard completion UI.
110 +++
111 *** Many packages have been changed to use `completion-at-point'
112 rather than their own completion code.
113 +++
114 *** `completion-at-point' now handles tags and semantic completion.
115 ---
116 *** Completion in a non-minibuffer now tries to detect the end of completion
117 and pops down the *Completions* buffer accordingly.
118 +++
119 *** Completion can cycle, depending on completion-cycle-threshold.
120 +++
121 *** New completion style `substring'.
122 +++
123 *** Completion style can be set per-category `completion-category-overrides'.
124 +++
125 *** Completion of buffers now uses substring completion by default.
126
127 ** Mail changes
128
129 +++
130 *** The default of `send-mail-function' is now `sendmail-query-once',
131 which asks the user (once) whether to use the smtpmail package to send
132 email, or to use the old defaults that rely on external mail
133 facilities (`sendmail-send-it' on GNU/Linux and other Unix-like
134 systems, and `mailclient-send-it' on Windows).
135
136 *** smtpmail changes
137
138 **** smtpmail now uses encrypted connections (via STARTTLS) if the
139 mail server supports them. It also uses the auth-source framework for
140 getting credentials.
141
142 **** The variable `smtpmail-auth-credentials' has been removed.
143 That variable used to have the default value "~/.authinfo", in which
144 case you won't see any difference. But if you changed it to be a list
145 of user names and passwords, that setting is now ignored; you will be
146 prompted for the user name and the password, which will then be saved
147 to ~/.authinfo. (To control where and how the credentials are stored,
148 see the auth-source manual. You may want to change the auth-source
149 preferences if you want to store the credentials encrypted, for
150 instance.)
151
152 You can also manually copy the credentials to your ~/.authinfo file.
153 For example, if you had
154
155 (setq smtpmail-auth-credentials
156 '(("mail.example.org" 25 "jim" "s!cret")))
157
158 then the equivalent line in ~/.authinfo would be
159
160 machine mail.example.org port 25 login jim password s!cret
161
162 **** The variable `smtpmail-starttls-credentials' has been removed.
163
164 If you had that set, then you need to put
165
166 machine smtp.whatever.foo port 25 key "~/.my_smtp_tls.key" cert "~/.my_smtp_tls.cert"
167
168 in your ~/.authinfo file instead.
169
170 *** Mail mode changes (this is the old Mail mode, not Message mode)
171 +++
172 **** New command `mail-add-attachment' for adding MIME attachments
173 ---
174 **** The command `mail-attach-file' was renamed to `mail-insert-file'.
175 The old name is now an obsolete alias to the new name.
176
177 +++
178 *** You can type C-c m from M-x report-emacs-bug if you prefer, and if
179 your system supports it, to transfer your report to your desktop's
180 preferred mail client. This uses either the "xdg-email" utility, or
181 OS X's "open" command.
182
183 ** Emacs server and client changes
184 +++
185 *** New option `server-port' specifies the port on which the Emacs
186 server should listen.
187 +++
188 *** New emacsclient argument -q/--quiet suppresses some status messages.
189 +++
190 *** New emacsclient argument --frame-parameters can be used to set the
191 frame parameters of a newly-created graphical frame.
192 +++
193 *** If emacsclient shuts down as a result of Emacs signaling an
194 error, its exit status is 1.
195 +++
196 *** New emacsclient argument --parent-id ID.
197 This opens a client frame in parent X window ID, via XEmbed, similar
198 to the --parent-id argument to Emacs.
199
200 ** Internationalization changes
201
202 +++
203 *** Emacs now supports display and editing of bidirectional text.
204
205 Text that includes characters from right-to-left (RTL) scripts, such
206 as Arabic, Farsi, or Hebrew, is displayed in the correct visual order
207 as expected by users of those scripts. This display reordering is a
208 "Full bidirectionality" class implementation of the Unicode
209 Bidirectional Algorithm. Buffers with no RTL text should look exactly
210 the same as before.
211
212 For more information, see the node "Bidirectional Editing" in the
213 Emacs Manual.
214
215 +++
216 **** New buffer-local variable `bidi-display-reordering'.
217 To disable display reordering in any given buffer, change this to nil.
218
219 +++
220 **** New buffer-local variable `bidi-paragraph-direction'.
221 If nil (the default), Emacs determines the base direction of each
222 paragraph from its text, as specified by the Unicode Bidirectional
223 Algorithm.
224
225 Setting this to `right-to-left' or `left-to-right' forces a particular
226 base direction on each paragraph in the buffer.
227
228 Paragraphs whose base direction is right-to-left are displayed
229 starting at the right margin of the window.
230
231 +++
232 *** Enhanced support for characters with no glyphs in available fonts.
233 If a character has no glyphs in any of the available fonts, Emacs
234 normally displays it either as a hexadecimal code in a box or as a
235 thin 1-pixel space. In addition to these two methods, Emacs can
236 display these characters as empty box, as an acronym, or not display
237 them at all. To change how these characters are displayed, customize
238 the variable `glyphless-char-display-control'.
239
240 On character terminals, these methods are used for characters that
241 cannot be encoded by the `terminal-coding-system'.
242
243 ---
244 *** New input methods for Farsi: farsi and farsi-translit.
245
246 +++
247 *** `nobreak-char-display' now also highlights Unicode hyphen chars
248 (U+2010 and U+2011).
249
250 ---
251 *** New translation of the Emacs Tutorial in Hebrew is available.
252 Type `C-u C-h t' to choose it in case your language setup doesn't
253 automatically select it.
254
255 ** Improved GTK integration
256 +++
257 *** GTK scroll-bars are now placed on the right by default.
258 Use `set-scroll-bar-mode' to change this.
259 +++
260 *** GTK tool bars can have just text, just images or images and text.
261 Customize `tool-bar-style' to choose style. On a Gnome desktop, the default
262 is taken from the desktop settings.
263 ---
264 *** GTK tool bars can be placed on the left/right or top/bottom of the frame.
265 The frame-parameter tool-bar-position controls this. It takes the values
266 top, left, right or bottom. The Options => Show/Hide menu has entries
267 for this.
268 +++
269 *** The colors for selected text (the `region' face) are taken from
270 the GTK theme when Emacs is built with GTK.
271 +++
272 *** Emacs uses GTK tooltips by default if built with GTK. You can turn that
273 off by customizing x-gtk-use-system-tooltips.
274
275 +++
276 ** New basic faces `error', `warning', `success' are available to
277 highlight strings that indicate failure, caution or successful operation.
278
279 ---
280 ** Lucid menus and dialogs can display antialiased fonts if Emacs is built
281 with Xft. To change font, use the X resource font, for example:
282 Emacs.pane.menubar.font: Courier-12
283
284 +++
285 ** On graphical displays, the mode-line no longer ends in dashes.
286 Also, the first dash (which does not indicate anything) is just
287 displayed as a space.
288
289 +++
290 ** Basic SELinux support has been added.
291 This requires Emacs to be linked with libselinux at build time.
292
293 +++
294 *** Emacs preserves the SELinux file context when backing up, and
295 optionally when copying files. To this end, copy-file has an extra
296 optional argument, and backup-buffer and friends include the SELinux
297 context in their return values.
298
299 +++
300 *** The new functions file-selinux-context and set-file-selinux-context
301 get and set the SELinux context of a file.
302 ---
303 *** Tramp offers handlers for file-selinux-context and set-file-selinux-context
304 for remote machines which support SELinux.
305
306 ** Changes for exiting Emacs
307 +++
308 *** The function kill-emacs is now run upon receipt of the signals
309 SIGTERM and SIGHUP, and upon SIGINT in batch mode.
310 +++
311 *** kill-emacs-hook is now also run in batch mode.
312 If you have code that adds something to kill-emacs-hook, you should
313 consider if it is still appropriate to add it in the noninteractive case.
314
315 ** Scrolling changes
316 +++
317 *** New scrolling commands `scroll-up-command' and `scroll-down-command'
318 (bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
319 of buffer at first key-press (instead move to top/bottom of buffer)
320 when `scroll-error-top-bottom' is non-nil.
321 +++
322 *** New variable `scroll-error-top-bottom' (see above).
323 +++
324 *** New scrolling commands `scroll-up-line' and `scroll-down-line'
325 scroll a line instead of full screen.
326 +++
327 *** New property `scroll-command' should be set on a command's symbol to
328 define it as a scroll command affected by `scroll-preserve-screen-position'.
329 +++
330 *** If you customize `scroll-conservatively' to a value greater than 100,
331 Emacs will never recenter point in the window when it scrolls due to
332 cursor motion commands or commands that move point (e.f., `M-g M-g').
333 Previously, you needed to use `most-positive-fixnum' as the value of
334 `scroll-conservatively' to achieve the same effect.
335 ---
336 *** ``Aggressive'' scrolling now honors the scroll margins.
337 If you customize `scroll-up-aggressively' or
338 `scroll-down-aggressively' and move point off the window, Emacs now
339 scrolls the window so as to avoid positioning point inside the scroll
340 margin.
341
342 ** Trash changes
343 +++
344 *** `delete-by-moving-to-trash' now only affects commands that specify
345 trashing. This avoids inadvertently trashing temporary files.
346 +++
347 *** Calling `delete-file' or `delete-directory' with a prefix argument
348 now forces true deletion, regardless of `delete-by-moving-to-trash'.
349
350 +++
351 ** New option `list-colors-sort' defines the color sort order
352 for `list-colors-display'.
353
354 ** An Emacs Lisp package manager is now included.
355 This is a convenient way to download and install additional packages,
356 from a package repository at http://elpa.gnu.org.
357 +++
358 *** `M-x list-packages' shows a list of packages, which can be
359 selected for installation.
360 +++
361 *** New command `describe-package', bound to `C-h P'.
362 +++
363 *** By default, all installed packages are loaded and activated
364 automatically when Emacs starts up. To disable this, set
365 `package-enable-at-startup' to nil. To change which packages are
366 loaded, customize `package-load-list'.
367
368 ** Custom Themes
369 +++
370 *** `M-x customize-themes' lists Custom themes which can be enabled.
371 +++
372 *** New option `custom-theme-load-path' is the load path for themes.
373 Emacs no longer looks for custom themes in `load-path'. The default
374 is to search in `custom-theme-directory', followed by a built-in theme
375 directory named "themes/" in `data-directory'.
376 +++
377 *** New option `custom-safe-themes' records known-safe theme files.
378 If a theme is not in this list, Emacs queries before loading it, and
379 offers to save the theme to `custom-safe-themes' automatically. By
380 default, all themes included in Emacs are treated as safe.
381
382 ** The user option `remote-file-name-inhibit-cache' controls whether
383 the remote file-name cache is used for read access.
384
385 ** File- and directory-local variable changes
386 +++
387 *** You can stop directory local vars from applying to subdirectories.
388 Add an element (subdirs . nil) to the alist portion of any variables
389 settings to indicate that the section should not apply to
390 subdirectories.
391 +++
392 *** Directory local variables can apply to some file-less buffers.
393 Affected modes include dired, vc-dir, and log-edit. For example,
394 adding "(diff-mode . ((mode . whitespace)))" to .dir-locals.el will
395 turn on `whitespace-mode' for *vc-diff* buffers. Modes should call
396 `hack-dir-local-variables-non-file-buffer' to support this.
397 +++
398 *** Using "mode: MINOR-MODE" to enable a minor mode is deprecated.
399 Instead, use "eval: (minor-mode 1)".
400
401 +++
402 *** The variable `inhibit-first-line-modes-regexps' has been renamed
403 to `inhibit-local-variables-regexps'. As the name suggests, it now
404 applies to ALL file local variables, not just -*- mode ones.
405 The associated `inhibit-first-line-modes-suffixes' has been renamed
406 in the corresponding way.
407
408 +++
409 ** The variable `focus-follows-mouse' now always defaults to nil.
410
411 ** New primitive `secure-hash' that supports many secure hash algorithms
412 including md5, sha-1 and sha-2 (sha-224, sha-256, sha-384 and sha-512).
413 The elisp implementation sha1.el is removed. Feature sha1 is provided
414 by default.
415
416 ** Menu-bar changes
417 ---
418 *** `menu-bar-select-buffer-function' lets you choose another operation
419 instead of `switch-to-buffer' when selecting an item in the Buffers menu.
420
421 ** Window changes
422
423 +++
424 *** Resizing an Emacs frame now preserves proportional window sizes,
425 modulo restrictions like window minimum sizes and fixed-size windows.
426
427 *** The behavior of `display-buffer' is now customizable in detail.
428 +++
429 **** New option `display-buffer-base-action' specifies a list of
430 user-determined display "actions" (functions and optional arguments
431 for choosing the displaying window).
432
433 This takes precedence over the default display action, which is
434 specified by `display-buffer-fallback-action'.
435
436 +++
437 **** New option `display-buffer-alist' maps buffer name regexps to
438 display actions, taking precedence over `display-buffer-base-action'.
439
440 +++
441 *** New option `window-combination-limit'.
442 The new option `window-combination-limit' allows to return the space
443 obtained for resizing or creating a window more reliably to the window
444 from which such space was obtained.
445
446 +++
447 *** New option `window-combination-resize'.
448 The new option `window-combination-resize' allows to split a window that
449 otherwise cannot be split because it's too small by stealing space from
450 other windows in the same combination. Subsequent resizing or deletion
451 of the window will resize all windows in the same combination as well.
452
453 +++
454 *** New commands `maximize-window' and `minimize-window'.
455 These maximize and minimize the size of a window within its frame.
456
457 +++
458 *** New commands `switch-to-prev-buffer' and `switch-to-next-buffer'.
459 These functions allow to navigate through the live buffers that have
460 been shown in a specific window.
461
462 ** The inactive minibuffer has its own major mode `minibuffer-inactive-mode'.
463 This is handy for minibuffer-only frames, and is also used for the "mouse-1
464 pops up *Messages*" feature, which can now easily be changed.
465
466 \f
467 * Editing Changes in Emacs 24.1
468
469 ** Search changes
470 +++
471 *** C-y in Isearch is now bound to isearch-yank-kill, instead of
472 isearch-yank-line.
473 +++
474 *** M-y in Isearch is now bound to isearch-yank-pop, instead of
475 isearch-yank-kill.
476 +++
477 *** M-s C-e in Isearch is now bound to isearch-yank-line.
478
479 +++
480 ** New commands `count-words-region' and `count-words'.
481
482 *** `count-lines-region' is now an alias for `count-words-region',
483 bound to M-=, which shows the number of lines, words, and characters.
484
485 +++
486 ** The default value of `backup-by-copying-when-mismatch' is now t.
487
488 +++
489 ** The command `just-one-space' (M-SPC), if given a negative argument,
490 also deletes newlines around point.
491
492 ** Deletion changes
493 +++
494 *** New option `delete-active-region'.
495 If non-nil, [delete] and DEL delete the region if it is active and no
496 prefix argument is given. If set to `kill', these commands kill
497 instead.
498 +++
499 *** New command `delete-forward-char', bound to [delete].
500 This is meant for interactive use, and obeys `delete-active-region'.
501 The command `delete-char' does not obey `delete-active-region'.
502 ---
503 *** `delete-backward-char' is now a Lisp function.
504 Apart from obeying `delete-active-region', its behavior is unchanged.
505 However, the byte compiler now warns if it is called from Lisp; you
506 should use delete-char with a negative argument instead.
507 ---
508 *** The option `mouse-region-delete-keys' has been deleted.
509
510 ** Selection changes.
511
512 The default handling of clipboard and primary selections was changed
513 to conform with modern X applications. In short, most commands for
514 killing and yanking text now use the clipboard, while mouse commands
515 use the primary selection.
516
517 In the following, we provide a list of these changes, followed by a
518 list of steps to get the old behavior back if you prefer that.
519
520 +++
521 *** `select-active-regions' now defaults to t.
522 Merely selecting text (e.g. with drag-mouse-1) no longer puts it in
523 the kill ring. The selected text is put in the primary selection, if
524 the system possesses a separate primary selection facility (e.g. X).
525
526 +++
527 **** `select-active-regions' also accepts a new value, `only'.
528 This means to only set the primary selection for temporarily active
529 regions (usually made by mouse-dragging or shift-selection);
530 "ordinary" active regions, such as those made with C-SPC followed by
531 point motion, do not alter the primary selection.
532
533 ---
534 **** `mouse-drag-copy-region' now defaults to nil.
535
536 +++
537 *** mouse-2 is now bound to `mouse-yank-primary'.
538 This pastes from the primary selection, ignoring the kill-ring.
539 Previously, mouse-2 was bound to `mouse-yank-at-click'.
540
541 +++
542 *** `x-select-enable-clipboard' now defaults to t on all platforms.
543 +++
544 *** `x-select-enable-primary' now defaults to nil.
545 Thus, commands that kill text or copy it to the kill-ring (such as
546 M-w, C-w, and C-k) also use the clipboard---not the primary selection.
547
548 ---
549 **** The "Copy", "Cut", and "Paste" items in the "Edit" menu are now
550 exactly equivalent to, respectively M-w, C-w, and C-y.
551
552 ---
553 **** Note that on MS-Windows, `x-select-enable-clipboard' was already
554 non-nil by default, as Windows does not support the primary selection
555 between applications.
556
557 ---
558 *** To return to the previous behavior, do the following:
559 **** Change `select-active-regions' to nil.
560 **** Change `mouse-drag-copy-region' to t.
561 **** Change `x-select-enable-primary' to t (on X only).
562 **** Change `x-select-enable-clipboard' to nil.
563 **** Bind `mouse-yank-at-click' to mouse-2.
564
565 +++
566 *** Support for X cut buffers has been removed.
567
568 *** X clipboard managers are now supported.
569 To inhibit this, change `x-select-enable-clipboard-manager' to nil.
570
571 +++
572 ** New command `rectangle-number-lines', bound to `C-x r N', numbers
573 the lines in the current rectangle. With a prefix argument, this
574 prompts for a number to count from and for a format string.
575
576 +++
577 ** The default value of redisplay-dont-pause is now t
578 This makes Emacs feel more responsive to editing commands that arrive
579 at high rate, e.g. if you lean on some key, because stopping redisplay
580 in the middle (when this variable is nil) forces more expensive
581 updates later on, and Emacs appears to be unable to keep up.
582
583 +++
584 ** The behavior of <TAB> for active regions in Text mode has changed.
585 In Text and related modes, typing <TAB> (`indent-for-tab-command')
586 when the region is active causes Emacs to indent all the lines in the
587 region, aligning them with the line previous to the first line in the
588 region (or with the left margin if there is no previous line).
589
590 \f
591 * Changes in Specialized Modes and Packages in Emacs 24.1
592
593 +++
594 ** Archive Mode has basic support for browsing and updating 7z archives.
595
596 ---
597 ** BibTeX mode
598
599 *** BibTeX mode now supports biblatex.
600 Use the variable bibtex-dialect to select support for different BibTeX
601 dialects. bibtex-entry-field-alist is now an obsolete alias for
602 bibtex-BibTeX-entry-alist.
603
604 *** New command `bibtex-search-entries' bound to C-c C-a.
605
606 *** New `bibtex-entry-format' option `sort-fields', disabled by default.
607
608 *** New variable `bibtex-search-entry-globally'.
609
610 ** Calendar, Diary, and Appt
611
612 +++
613 *** Diary entries can contain non-printing `comments'.
614 See the variable `diary-comment-start'.
615
616 +++
617 *** Appointments can specify their individual warning times.
618 See the variable `appt-warning-time-regexp'.
619
620 ---
621 *** The function specified by `appt-disp-window-function' may be passed
622 lists of arguments if multiple appointments are due at similar times.
623 If you are using a custom function for this, you should update it.
624
625 +++
626 *** New function `diary-hebrew-birthday'.
627
628 ---
629 *** Elements of `calendar-day-abbrev-array' and `calendar-month-abbrev-array'
630 may no longer be nil, but must all be strings.
631
632 ---
633 *** The obsolete (since Emacs 22.1) method of enabling the appt package
634 by adding appt-make-list to diary-hook has been removed. Use appt-activate.
635
636 ---
637 *** Some appt variables (obsolete since Emacs 22.1) have been removed:
638 appt-issue-message (use the function appt-activate)
639 appt-visible/appt-msg-window (use the variable appt-display-format)
640
641 ---
642 *** Some diary function aliases (obsolete since Emacs 22.1) have been removed:
643 view-diary-entries, list-diary-entries, show-all-diary-entries
644
645 ** Browse-url
646
647 +++
648 *** New option `browse-url-mailto-function' specifies how to handle "mailto:"s.
649
650 ---
651 *** The default browser used by the package is now the "xdg-open" program,
652 on platforms that support it. This calls your desktop's preferred browser.
653
654 ** CC Mode (C, C++, etc.)
655
656 *** New feature to "guess" the style in an existing buffer.
657
658 ** comint and modes derived from it use the generic completion code.
659
660 ** Compilation mode
661 ---
662 *** Compilation mode can be used without font-lock-mode.
663 `compilation-parse-errors-function' is now obsolete.
664
665 *** `compilation-filter-start' is let-bound to the start of the text
666 inserted by the compilation filter function, when calling
667 compilation-filter-hook.
668
669 *** `compilation-error-screen-columns' and `compilation-first-column'
670 are obeyed in the editing buffer. So programming language modes can
671 set them, whereas previously only the value in the *compilation* buffer
672 was used.
673
674 ** Customize
675
676 +++
677 *** Customize buffers now contain a search field.
678 The search is performed using `customize-apropos'.
679 To turn off the search field, set custom-search-field to nil.
680
681 +++
682 *** Custom options now start out hidden if at their default values.
683 Use the arrow to the left of the option name to toggle visibility.
684
685 ---
686 *** custom-buffer-sort-alphabetically now defaults to t.
687
688 +++
689 *** The color widget now has a "Choose" button, which allows you to
690 choose a color via list-colors-display.
691
692 ** D-Bus
693
694 *** It is possible now, to access alternative buses than the default
695 system or session bus.
696
697 *** dbus-register-{service,method,property}
698 The -method and -property functions do not automatically register
699 names anymore.
700
701 The new function dbus-register-service registers a service known name
702 on a D-Bus without simultaneously registering a property or a method.
703
704 ** Dired-x
705 ---
706 *** dired-jump and dired-jump-other-window called with a prefix argument
707 read a file name from the minibuffer instead of using buffer-file-name.
708
709 +++
710 *** The `dired local variables' feature provided by Dired-x is obsolete.
711 The standard directory local variables feature replaces it.
712
713 ** ERC changes
714
715 ---
716 *** New options `erc-autojoin-timing' and `erc-autojoin-delay',
717 controlling attempts to autojoin a channel.
718
719 *** New variable `erc-coding-system-precedence': If we use `undecided'
720 as the server coding system, this variable will then be consulted.
721 The default is to decode strings that can be decoded as utf-8 as
722 utf-8, and do the normal `undecided' decoding for the rest.
723
724 ** Eshell changes
725
726 ---
727 *** The default value of `eshell-directory-name' has changed
728 to be an "eshell" directory in `user-emacs-directory'.
729 The old "~/.eshell/" directory is still used if it exists, though.
730
731 ** gdb-mi
732 +++
733 *** The GDB User Interface has been migrated to GDB Machine Interface.
734 It now supports multithread non-stop debugging and simultaneous
735 debugging of several threads.
736
737 ** Image mode
738
739 +++
740 *** RET (`image-toggle-animation') toggles animation, if applicable.
741 Animation plays once, unless the option `image-animate-loop' is non-nil.
742
743 ** Info
744
745 *** New command `info-display-manual' displays an Info manual
746 specified by its name. If that manual is already visited in some Info
747 buffer within the current session, the command will display that
748 buffer. Otherwise, it will load the manual and display it. This is
749 handy if you have many manuals in many Info buffers, and don't
750 remember the name of the buffer visiting the manual you want to
751 consult.
752
753 +++
754 *** `e' is now bound to `end-of-buffer' rather than to `Info-edit'.
755 This is for compatibility with the stand-alone Info reader program,
756 and also because `Info-edit' is a rarely used command that is disabled
757 by default.
758
759 +++
760 ** MH-E has been upgraded to MH-E version 8.3.1.
761 See MH-E-NEWS for details.
762
763 ---
764 ** Modula-2 mode provides auto-indentation.
765
766 ---
767 ** mpc.el: Can use pseudo tags of the form tag1|tag2 as a union of two tags.
768
769 ---
770 ** Prolog mode has been completely revamped, with lots of additional
771 functionality such as more intelligent indentation, electricity, support for
772 more variants, including Mercury, and a lot more.
773
774 ** Rmail
775
776 +++
777 *** The command `rmail-epa-decrypt' decrypts OpenPGP data
778 in the Rmail incoming message.
779
780 ---
781 *** The variable `rmail-message-filter' no longer has any effect.
782 This change was made in Emacs 23.1 but was not advertised at the time.
783 Try using `rmail-show-message-hook' instead.
784
785 ** Shell mode
786 +++
787 *** Shell mode uses pcomplete rules, with the standard completion UI.
788 +++
789 *** The `shell' command prompts for the shell path name if the default
790 directory is a remote file name and neither the environment variable
791 $ESHELL nor the variable `explicit-shell-file-name' is set.
792
793 ---
794 ** SQL mode
795
796 ---
797 *** New options `sql-port', `sql-connection-alist', `sql-send-terminator',
798 and `sql-oracle-scan-on'.
799
800 ---
801 *** New custom variables control prompting for login parameters.
802 Each supported product has a custom variable `sql-*-login-params',
803 which is a list of the parameters to be prompted for before a
804 connection is established.
805
806 ---
807 *** The command `sql-product-interactive' now takes a prefix argument,
808 which causes it to prompt for an SQL product.
809
810 ---
811 *** Product-specific SQL interactive commands now take prefix arguments.
812 These commands (`sql-sqlite', `sql-postgres', `sql-mysql', etc.),
813 given a prefix argument, prompt for a name for the SQL interactive
814 buffer. This reduces the need for calling `sql-rename-buffer'.
815
816 ---
817 *** SQL interactive modes suppress command continuation prompts, and
818 replace tabs with spaces. The first change impacts multiple line SQL
819 statements entered with C-j between each line, statements yanked into
820 the buffer and statements sent with `sql-send-*' functions. The
821 second prevents the MySQL and Postgres interpreters from listing
822 object name completions when sent text via `sql-send-*' functions.
823
824 ---
825 *** New command `sql-connect' starts a predefined SQLi session,
826 using the login parameters from `sql-connection-alist'.
827
828 ---
829 *** New "Save Connection" menu item in SQLi buffers.
830 This gathers the login params specified for the SQLi session, if it
831 was not started by a connection, and saves them as a new connection.
832
833 ---
834 *** New commands for listing database objects and details:
835 sql-list-all and sql-list-table.
836
837 ---
838 *** An API for manipulating SQL product definitions has been added.
839
840 ** TeX modes
841
842 +++
843 *** latex-electric-env-pair-mode keeps \begin..\end matched on the fly.
844
845 ** Tramp
846 ---
847 *** There exists a new inline access method "ksu" (kerberized su).
848 ---
849 *** The following access methods are discontinued: "ssh1_old",
850 "ssh2_old", "scp1_old", "scp2_old", "imap", "imaps" and "fish".
851 ---
852 *** The option `ange-ftp-binary-file-name-regexp' has changed its
853 default value to "".
854
855 ** `url-queue-retrieve' downloads web pages asynchronously, but allow
856 controlling the degree of parallelism.
857
858 ** VC and related modes
859
860 +++
861 *** Support for pulling on distributed version control systems.
862 `C-x v +' (`vc-pull') runs a "pull" operation, if it is supported
863 (currently with Bzr, Git, and Mercurial), to update the current branch
864 and working tree. A prefix argument means to prompt the user for
865 specifics, e.g. a pull location.
866
867 ---
868 *** `vc-update' is now an alias for `vc-pull'.
869
870 +++
871 *** Support for merging on distributed version control systems.
872 The vc-merge command now runs a "merge" operation, if it is supported
873 (currently with Bzr, Git, and Mercurial), to merge changes from
874 another branch into the current one. It prompts for specifics, e.g. a
875 merge source.
876
877 +++
878 *** New option `vc-revert-show-diff' controls whether `vc-revert'
879 shows a diff while querying the user. It defaults to t.
880
881 +++
882 *** Log entries in some Log View buffers can be toggled to display a
883 longer description by typing RET (log-view-toggle-entry-display).
884 This is currently supported for Bzr, Git, and Mercurial (to support
885 another backend, define a `log-view-expanded-log-entry-function').
886 In the Log View buffers made by `C-x v L' (vc-print-root-log), you can
887 use this to display the full log entry for the revision at point.
888
889 +++
890 *** New command `vc-ediff' allows visual comparison of two revisions
891 of a file similar to `vc-diff', but using ediff backend.
892
893 +++
894 *** The option `vc-initial-comment' was removed in Emacs 23.2, but
895 this was not advertised at the time.
896
897 +++
898 *** `vc-toggle-read-only' is an obsolete alias for `toggle-read-only'.
899 Since Emacs 23, it has done the same thing as `toggle-read-only', but
900 this was not advertised at the time.
901
902 ** Obsolete modes
903
904 ---
905 *** abbrevlist.el
906
907 ---
908 *** erc-hecomplete.el (use erc-pcomplete.el instead)
909
910 *** partial-completion-mode (complete.el) is obsolete.
911 You can get a comparable behavior with:
912 (setq completion-styles '(partial-completion initials))
913 (setq completion-pcm-complete-word-inserts-delimiters t)
914
915 ---
916 *** pc-mode.el is obsolete (CUA mode is much more comprehensive).
917
918 *** pgg is obsolete (use EasyPG instead)
919
920 ---
921 *** sregex.el is obsolete, since rx.el is a strict superset.
922
923 ---
924 *** s-region.el and pc-select.el are obsolete.
925 They are superseded by shift-select-mode, enabled by default since 23.1.
926
927 +++
928 *** vc-mcvs.el is obsolete (for lack of a maintainer)
929
930 ** Miscellaneous
931
932 +++
933 *** The Landmark game is now invoked with `landmark', not `lm'.
934
935 ---
936 *** In `ido-file-completion-map', C-v is no longer bound to ido-toggle-vc.
937 (This interfered with cua-mode.)
938
939 +++
940 *** f90.el has some support for Fortran 2008 syntax.
941
942 ---
943 *** `copyright-fix-years' can optionally convert consecutive years to ranges.
944
945 +++
946 *** New command `nato-region' converts text to NATO phonetic alphabet.
947
948 \f
949 * New Modes and Packages in Emacs 24.1
950
951 +++
952 ** Occur Edit mode applies edits made in *Occur* buffers to the
953 original buffers. It is bound to "e" in Occur mode.
954
955 ** New global minor mode electric-pair-mode.
956 When enabled, typing an open parenthesis automatically inserts the
957 matching closing one.
958
959 ** New global minor mode electric-indent-mode.
960 When enabled, typing certain characters triggers reindentation.
961
962 ** New global minor mode electric-layout-mode.
963 When enabled, typing certain characters automatically inserts newlines.
964
965 ** tabulated-list.el provides a generic major mode for tabulated data,
966 from which other modes can be derived.
967
968 ** pcase.el provides the ML-style pattern matching macro `pcase'.
969
970 ** secrets.el is an implementation of the Secret Service API, an
971 interface to password managers like GNOME Keyring or KDE Wallet. The
972 Secret Service API requires D-Bus for communication. The command
973 `secrets-show-secrets' offers a buffer with a visualization of the
974 secrets.
975
976 ** notifications.el provides an implementation of the Desktop
977 Notifications API. It requires D-Bus for communication.
978
979 ** soap-client.el supports access to SOAP web services from Emacs.
980 soap-inspect.el is an interactive inspector for SOAP WSDL structures.
981
982 ---
983 ** New generic mode, xmodmap-generic-mode, for xmodmap files.
984
985 ---
986 ** New emacs-lock.el package.
987 (The previous version has been moved to obsolete/old-emacs-lock.el.)
988 Now, there is a proper minor mode `emacs-lock-mode'.
989 Protection against exiting Emacs and killing the buffer can be set
990 separately. The mechanism for automatically turning off protection
991 for buffers with dead inferior processes has been generalized.
992
993 \f
994 * Incompatible Lisp Changes in Emacs 24.1
995
996 ---
997 ** `char-direction-table' and the associated function `char-direction'
998 were deleted. They were buggy and inferior to the new support of
999 bidirectional editing introduced in Emacs 24. If you need the
1000 bidirectional properties of a character, use `get-char-code-property'
1001 with the last argument `bidi-class'.
1002
1003 +++
1004 ** `copy-directory' now copies the source directory as a subdirectory
1005 of the target directory, if the latter is an existing directory. The
1006 new optional arg COPY-CONTENTS, if non-nil, makes the function copy
1007 the contents directly into a pre-existing target directory.
1008
1009 ** `compose-mail' now accepts an optional 8th arg, RETURN-ACTION, and
1010 passes it to the mail user agent function. This argument specifies an
1011 action for returning to the caller after finishing with the mail.
1012 This is currently used by Rmail to delete a mail window.
1013
1014 ** For mouse click input events in the text area, the Y pixel
1015 coordinate in the POSITION list now counts from the top of the text
1016 area, excluding any header line. Previously, it counted from the top
1017 of the header line.
1018
1019 ---
1020 ** Support for "old-style" backquotes, which have been obsolete for
1021 more than 10 years, has been further reduced. Now a backquote not
1022 followed by a space is always treated as a "new-style" backquote.
1023 Please consider completely removing all "old-style" backquotes from
1024 your code as a matter of some urgency. If your code uses backquotes
1025 as documented in the Elisp manual, and compiles without warning, then
1026 you have nothing to do in this regard. Code not following the
1027 appropriate conventions may fail to compile. The most common cause of
1028 trouble seems to be an old-style backquote followed by a newline.
1029
1030 ---
1031 ** view-buffer now treats special mode-class in the same way that
1032 view-file has since Emacs 22 (ie, it won't enable View mode if the
1033 major-mode is special).
1034
1035 +++
1036 ** Passing a nil argument to a minor mode defined by define-minor-mode
1037 now turns the mode ON unconditionally. This is so that you can write, e.g.
1038 (add-hook 'text-mode-hook 'foo-minor-mode)
1039 to enable foo-minor-mode in Text mode buffers, thus removing the need
1040 for `turn-on-foo-minor-mode' style functions.
1041
1042 +++
1043 ** During startup, Emacs no longer adds entries for `menu-bar-lines'
1044 and `tool-bar-lines' to `default-frame-alist' and `initial-frame-alist'.
1045 With these alist entries omitted, `make-frame' checks the value of the
1046 variable `menu-bar-mode'/`tool-bar-mode' to determine whether to create
1047 a menu-bar or tool-bar, respectively. If the alist entries are added,
1048 they override the value of `menu-bar-mode'/`tool-bar-mode'.
1049
1050 +++
1051 ** Regions created by mouse dragging are now normal active regions,
1052 similar to the ones created by shift-selection. In previous Emacs
1053 versions, these regions were delineated by `mouse-drag-overlay', which
1054 has now been removed.
1055
1056 +++
1057 ** The fourth argument of filter-buffer-substring, which says to remove
1058 text properties from the final result, has been removed.
1059 Eg simply pass the result through substring-no-properties if you need this.
1060
1061 ---
1062 ** cl.el no longer provides `cl-19'.
1063
1064 ** The menu bar bindings's caches are not used any more.
1065 Use (where-is-internal <def> nil t) instead.
1066
1067 +++
1068 ** The following obsolete (mostly since at least 21.1) functions and aliases
1069 have been removed (the appropriate new function is given in parentheses):
1070 comint-kill-output (comint-delete-output),
1071 decompose-composite-char (char-to-string),
1072 outline-visible (outline-invisible-p),
1073 internal-find-face (facep), internal-get-face (facep and check-face),
1074 frame-update-faces (not needed),
1075 frame-update-face-colors (frame-set-background-mode),
1076 x-frob-font-weight and x-frob-font-slant (appropriate make-face-* function),
1077 x-make-font-bold and x-make-font-demibold (make-face-bold),
1078 x-make-font-italic and x-make-font-oblique (make-face-italic),
1079 x-make-font-bold-italic (make-face-bold-italic),
1080 x-make-font-unbold (make-face-unbold),
1081 x-make-font-unitalic (make-face-unitalic),
1082 mldrag-drag-mode-line (mouse-drag-mode-line),
1083 mldrag-drag-vertical-line (mouse-drag-vertical-line),
1084 iswitchb-default-keybindings (iswitchb-mode), char-bytes (== 1),
1085 isearch-return-char (isearch-printing-char), make-local-hook (not needed)
1086
1087 +++
1088 ** The following obsolete (mostly since at least 21.1) variables and varaliases
1089 have been removed (the appropriate new variable is given in parentheses):
1090 checkdoc-minor-keymap (checkdoc-minor-mode-map),
1091 vc-header-alist (vc-BACKEND-header), directory-sep-char (== ?/)
1092 font-lock-defaults-alist (font-lock-defaults), and e (float-e).
1093
1094 ---
1095 ** The following obsolete files were removed:
1096 sc.el, x-menu.el, rnews.el, rnewspost.el
1097
1098 ** FIXME finder-inf.el changes.
1099
1100 \f
1101 * Lisp changes in Emacs 24.1
1102
1103 +++
1104 ** Code can now use lexical scoping by default instead of dynamic scoping.
1105 The `lexical-binding' variable lets code use lexical scoping for local
1106 variables. It is typically set via a file-local variable in the first
1107 line of the file, in which case it applies to all the code in that file.
1108 +++
1109 *** `eval' takes a new optional argument `lexical' to choose the new lexical
1110 binding instead of the old dynamic binding mode.
1111 +++
1112 *** Lexically scoped interpreted functions are represented with a new form
1113 of function value which looks like (closure ENV ARGS &rest BODY).
1114
1115 *** New macro `letrec' to define recursive local functions.
1116 +++
1117 *** New function `special-variable-p' to check whether a variable is
1118 declared as dynamically bound.
1119
1120 +++
1121 ** An Emacs Lisp testing tool is now included.
1122 Emacs Lisp developers can use this tool to write automated tests for
1123 their code. See the ERT info manual for details.
1124
1125 ** Changes for bidirectional display and editing
1126
1127 +++
1128 *** New function `current-bidi-paragraph-direction'.
1129 This returns the actual value of base direction of the paragraph at
1130 point.
1131
1132 +++
1133 *** New function `bidi-string-mark-left-to-right'.
1134 Given a string containing characters from right-to-left (RTL) scripts,
1135 this function returns another string which can be safely inserted into
1136 a buffer, such that any following text will be always displayed to the
1137 right of that string. (This works by appending the Unicode
1138 "LEFT-TO-RIGHT MARK" character when the argument string might need that.)
1139
1140 This is useful when the buffer has overall left-to-right (LTR)
1141 paragraph direction and you need to insert a string whose contents and
1142 directionality are not known in advance, without disrupting the layout
1143 of the line.
1144
1145 ** Window changes
1146 +++
1147 *** Window tree functions are accessible in Elisp.
1148 Functions are provided to return the parent, siblings or child windows
1149 of any window including internal windows (windows not associated with a
1150 buffer) in the window tree.
1151 +++
1152 **** New function `window-valid-p' gives non-nil for live and internal
1153 windows.
1154 +++
1155 **** Window manipulation can deal with internal windows.
1156 Many window handling functions like `split-window', `delete-window', or
1157 `delete-other-windows' as well as the window resizing functions can now
1158 act on any window including internal ones.
1159 +++
1160 *** window-total-height/-width vs window-body-height/-width.
1161 The function `window-height' has been renamed to `window-total-height'
1162 and `window-width' has been renamed to `window-body-width'. The old
1163 names are provided as aliases. Two new functions `window-total-width'
1164 and `window-body-height' are provided.
1165 +++
1166 *** Window parameters specific to window handling functions.
1167 For each window you can specify a parameter to override the default
1168 behavior of a number of functions like `split-window', `delete-window'
1169 and `delete-other-windows'. The variable `ignore-window-parameters'
1170 allows to ignore processing such parameters.
1171 +++
1172 *** New semantics of third argument of `split-window'.
1173 The third argument of `split-window' has been renamed to SIDE and can be
1174 set to any of the values 'below, 'right, 'above, or 'left to make the
1175 new window appear on the corresponding side of the window that shall be
1176 split. Any other value of SIDE will cause `split-window' to split the
1177 window into two side-by-side windows as before.
1178 +++
1179 *** Window resizing functions.
1180 A new standard function for resizing windows called `window-resize' has
1181 been introduced. This and all other functions for resizing windows no
1182 longer delete any windows when they become too small.
1183 +++
1184 *** Deleting the selected window now selects the most recently selected
1185 live window on that frame instead.
1186 +++
1187 *** `adjust-window-trailing-edge' adjustments.
1188 `adjust-window-trailing-edge' can now deal with fixed-size windows and
1189 is able to resize other windows if a window adjacent to the trailing
1190 edge cannot be shrunk any more. This makes its behavior more similar to
1191 that of Emacs 21 without compromising, however, its inability to delete
1192 windows which was introduced in Emacs 22.
1193 +++
1194 *** Window-local buffer lists.
1195 Windows now have local buffer lists. This means that removing a buffer
1196 from display in a window will preferably show the buffer previously
1197 shown in that window with its previous window-start and window-point
1198 positions. This also means that the same buffer may be automatically
1199 shown twice even if it already appears in another window.
1200 +++
1201 *** `switch-to-buffer' has a new optional argument FORCE-SAME-WINDOW,
1202 which if non-nil requires the buffer to be displayed in the currently
1203 selected window, signaling an error otherwise. If nil, another window
1204 can be used, e.g. if the selected one is strongly dedicated.
1205 +++
1206 *** `split-window-vertically' and `split-window-horizontally' renamed
1207 to `split-window-below' and `split-window-right' respectively.
1208 The old names are kept as aliases.
1209 +++
1210 *** Display actions
1211
1212 **** The second arg to `display-buffer' and `pop-to-buffer' is now
1213 named ACTION, and takes a display action of the same form as
1214 `display-buffer-base-action' (see Changes, above). A non-nil,
1215 non-list value is treated specially, as the old meaning.
1216
1217 **** New variable `display-buffer-overriding-action'.
1218
1219 **** The procedure of `display-buffer' etc. to choose a window is
1220 determined by combining `display-buffer-overriding-action',
1221 `display-buffer-alist', the ACTION arg, `display-buffer-base-action',
1222 and `display-buffer-fallback-action'. The second and fourth of these
1223 are user-customizable variables.
1224
1225 See the docstring of `display-buffer' for details.
1226
1227 +++
1228 *** New behavior of `quit-window'.
1229 The behavior of `quit-window' has been changed in order to restore the
1230 state before the last buffer display operation in that window.
1231
1232 +++
1233 *** The new option `frame-auto-hide-function' lets you choose between
1234 iconifying or deleting a frame when burying a buffer shown in a dedicated
1235 frame or quitting a window showing a buffer in a frame of its own.
1236
1237 +++
1238 *** New functions `window-state-get' and `window-state-put'.
1239 These functions allow to save and restore the state of an arbitrary
1240 frame or window as an Elisp object.
1241
1242 ** Completion
1243
1244 *** New variable completion-extra-properties used to specify extra properties
1245 of the current completion:
1246 - :annotate-function, same as the old completion-annotate-function.
1247 - :exit-function, function to call after completion took place.
1248
1249 *** Functions on completion-at-point-functions can return any of the properties
1250 valid for completion-extra-properties.
1251
1252 *** completion-annotate-function is obsolete.
1253
1254 *** New `metadata' method for completion tables. The metadata thus returned
1255 can specify various details of the data returned by `all-completions':
1256 - `category' is the kind of objects returned (e.g., `buffer', `file', ...),
1257 used to select a style in completion-category-overrides.
1258 - `annotation-function' to add annotations in *Completions*.
1259 - `display-sort-function' to specify how to sort entries in *Completions*.
1260 - `cycle-sort-function' to specify how to sort entries when cycling.
1261
1262 *** minibuffer-local-filename-must-match-map is not used any more.
1263 Instead, the bindings in minibuffer-local-filename-completion-map are
1264 combined with minibuffer-local-must-match-map.
1265
1266 *** New variable `completing-read-function' allows overriding the
1267 behavior of `completing-read'.
1268
1269 +++
1270 ** `glyphless-char-display' can now distinguish between graphical and
1271 text terminal display, via a char-table entry that is a cons cell.
1272
1273 ** `open-network-stream' can now be used to open an encrypted stream.
1274 It now accepts an optional `:type' parameter for initiating a TLS
1275 connection, directly or via STARTTLS. To do STARTTLS, additional
1276 parameters (`:end-of-command', `:success', `:capabilities-command')
1277 must also be supplied.
1278
1279 +++
1280 ** pre/post-command-hook are not reset to nil upon error.
1281 Instead, the offending function is removed.
1282
1283 ** New hook types
1284
1285 +++
1286 *** New function `run-hook-wrapped' for running an abnormal hook by
1287 passing the hook functions as arguments to a "wrapping" function.
1288 Like `run-hook-with-args-until-success', it stops at the first
1289 non-nil return value.
1290
1291 +++
1292 *** New macro `with-wrapper-hook' for running an abnormal hook as a
1293 set of "wrapping" filters, similar to around advice.
1294 (A version of this macro was actually added in Emacs 23.2 but was not
1295 advertised at the time.)
1296
1297 +++
1298 ** The macros `condition-case-no-debug' and `with-demoted-errors' were
1299 added in Emacs 23.1, but not advertised.
1300
1301 +++
1302 ** The new function `server-eval-at' allows evaluation of Lisp forms on
1303 named Emacs server instances, using TCP sockets.
1304
1305 +++
1306 ** `call-process' and `call-process-region' allow a `(:file "file")' spec
1307 to redirect STDOUT to a file.
1308
1309 ---
1310 ** Variable `stack-trace-on-error' removed.
1311 Also the debugger can now "continue" from an error, which means it will jump
1312 to the error handler as if the debugger had not been invoked instead of
1313 jumping all the way to the top-level.
1314
1315 +++
1316 ** The function format-time-string now supports the %N directive, for
1317 higher-resolution time stamps.
1318
1319 +++
1320 ** New function `read-char-choice' reads a restricted set of characters,
1321 discarding any inputs not inside the set.
1322
1323 +++
1324 ** `image-library-alist' is renamed to `dynamic-library-alist'.
1325 The variable is now used to load all kind of supported dynamic libraries,
1326 not just image libraries. The previous name is still available as an
1327 obsolete alias.
1328
1329 ** New variable `syntax-propertize-function'.
1330 This replaces `font-lock-syntactic-keywords' which is now obsolete.
1331 This allows syntax-table properties to be set independently from font-lock:
1332 just call syntax-propertize to make sure the text is propertized.
1333 Together with this new variable come a new hook
1334 syntax-propertize-extend-region-functions, as well as two helper functions:
1335 syntax-propertize-via-font-lock to reuse old font-lock-syntactic-keywords
1336 as-is; and syntax-propertize-rules which provides a new way to specify
1337 syntactic rules.
1338
1339 +++
1340 ** New hook post-self-insert-hook run at the end of self-insert-command.
1341
1342 +++
1343 ** Syntax tables support a new "comment style c" additionally to style b.
1344
1345 ---
1346 ** frame-local variables cannot be let-bound any more.
1347
1348 ** Major and minor mode changes
1349 +++
1350 *** `prog-mode' is a new major mode from which programming modes
1351 should be derived.
1352
1353 +++
1354 **** `prog-mode-hook' can be used to enable features for programming
1355 modes, e.g. (add-hook 'prog-mode-hook 'flyspell-prog-mode) to enable
1356 on-the-fly spell checking for comments and strings.
1357
1358 +++
1359 *** New hook `change-major-mode-after-body-hook', run by
1360 `run-mode-hooks' just before any other mode hooks.
1361
1362 +++
1363 *** Enabled globalized minor modes can be disabled in specific major modes.
1364 If the global mode is global-FOO-mode, then run (FOO-mode -1) in the
1365 major mode's hook, where FOO-mode toggles the mode on a per-buffer basis.
1366
1367 +++
1368 *** `define-minor-mode' accepts a new keyword :variable.
1369
1370 +++
1371 ** `delete-file' and `delete-directory' now accept optional arg TRASH.
1372 Trashing is performed if TRASH and `delete-by-moving-to-trash' are
1373 both non-nil. Interactively, TRASH defaults to t, unless a prefix
1374 argument is supplied (see Trash changes, above).
1375
1376 ---
1377 ** `facemenu-read-color' is now an alias for `read-color'.
1378
1379 +++
1380 ** The command `read-color' now requires a match for a color name
1381 or RGB triplet, instead of signaling an error if the user provides
1382 invalid input.
1383
1384 +++
1385 ** Tool-bars can display separators.
1386 Tool-bar separators are handled like menu separators in menu-bar maps,
1387 i.e. via menu entries of the form `(menu-item "--")'.
1388
1389 ** Image API
1390
1391 +++
1392 *** Animated images support (currently animated gifs only).
1393
1394 +++
1395 **** `image-animated-p' returns non-nil if an image can be animated.
1396
1397 +++
1398 **** `image-animate' animates a supplied image spec.
1399
1400 +++
1401 **** `image-animate-timer' returns the timer object for an image that
1402 is being animated.
1403
1404 ---
1405 *** `image-extension-data' has been renamed to `image-metadata'.
1406 The old name is an obsolete alias to the new one.
1407
1408 +++
1409 *** Image mode can view any image type that ImageMagick supports.
1410 This requires Emacs to be built with ImageMagick support.
1411 Then the function `imagemagick-types' returns a list of image file
1412 extensions that your installation of ImageMagick supports. The
1413 function `imagemagick-register-types' enables ImageMagick support for
1414 these image types, minus those listed in `imagemagick-types-inhibit'.
1415 Visiting one of these file types will then use Image mode.
1416
1417 ---
1418 *** New commands to resize and rotate images in Image mode.
1419 These require Emacs to be built with ImageMagick support.
1420 image-transform-fit-to-height, image-transform-fit-to-width,
1421 image-transform-set-rotation, image-transform-set-scale.
1422
1423 ** XML and HTML parsing
1424 If Emacs is compiled with libxml2 support, there are two new functions:
1425 `libxml-parse-html-region' (which parses "real world" HTML) and
1426 `libxml-parse-xml-region' (which parses XML). Both return an Emacs
1427 Lisp parse tree.
1428
1429 FIXME: These should be front-ended by xml.el.
1430
1431 ** GnuTLS
1432
1433 *** New library `gnutls.el'.
1434 This requires Emacs to have been built with GnuTLS support.
1435 The main functions are `open-gnutls-stream' and `gnutls-negotiate'.
1436 It's easiest to use these functions through `open-network-stream'
1437 because it can upgrade connections through STARTTLS opportunistically
1438 or use plain SSL, depending on your needs. For debugging, set
1439 `gnutls-log-level' greater than 0.
1440
1441 ** Isearch
1442
1443 ---
1444 *** New hook `isearch-update-post-hook' that runs in `isearch-update'.
1445
1446 +++
1447 ** Progress reporters can now "spin".
1448 The MIN-VALUE and MAX-VALUE arguments of `make-progress-reporter' can
1449 now be nil, or omitted. This makes a "non-numeric" reporter. Each
1450 time you call `progress-reporter-update' on that progress reporter,
1451 with a nil or omitted VALUE argument, the reporter message is
1452 displayed with a "spinning bar".
1453
1454 +++
1455 ** New variable `revert-buffer-in-progress-p' is true while a buffer is
1456 being reverted, even if the buffer has a local `revert-buffer-function'.
1457
1458 ---
1459 ** New variables `delayed-warnings-list' and `delayed-warnings-hook'.
1460 If delayed-warnings-list is non-nil, the command loop calls
1461 delayed-warnings-hook after post-command-hook. At present, this is
1462 only used by Emacs on some platforms to display warnings during
1463 startup, which might otherwise not be noticed. This uses the functions
1464 display-delayed-warnings and collapse-delayed-warnings.
1465
1466
1467 +++
1468 ** `set-auto-mode' now respects mode: local variables at the end of files,
1469 as well as those in the -*- line.
1470
1471 ---
1472 ** rx.el has a new `group-n' construct for explicitly numbered groups.
1473
1474 +++
1475 ** New function `make-composed-keymap' that constructs a new keymap
1476 from multiple input maps. You can use this to make a keymap that
1477 inherits from multiple maps, eg:
1478 (set-keymap-parent newmap (make-composed-keymap othermap parent))
1479
1480 +++
1481 ** Set `debug-on-event' to make Emacs enter the debugger e.g. on receipt
1482 of SIGUSR1. This can be useful when `inhibit-quit' is set.
1483
1484 +++
1485 ** New reader macro ## that stands for the empty symbol.
1486 This means that the empty symbol can now be read back. Also, #: by itself
1487 (when not immediately followed by a possible symbol character) stands for
1488 an empty uninterned symbol.
1489
1490 +++
1491 ** New math functions `isnan', `copysign', `frexp', `ldexp'.
1492
1493 ** Obsolete functions and variables
1494
1495 ---
1496 *** `tooltip-use-echo-area' is obsolete.
1497 Rather than setting this to t, disable Tooltip mode instead.
1498
1499 +++
1500 *** buffer-substring-filters is obsolete.
1501 Use `filter-buffer-substring-functions' instead.
1502
1503 ---
1504 *** `byte-compile-disable-print-circle' is obsolete.
1505
1506 ---
1507 *** `deferred-action-list' and `deferred-action-function' are obsolete.
1508 Use `post-command-hook' instead.
1509
1510 +++
1511 *** `font-lock-maximum-size' is obsolete.
1512
1513 \f
1514 * Changes in Emacs 24.1 on non-free operating systems
1515
1516 ---
1517 ** On MS Windows, Emacs warns when using the obsolete init file _emacs,
1518 and also when HOME is set to C:\ by default.
1519
1520 ** New configure.bat options
1521
1522 +++
1523 *** --enable-checking builds Emacs with extra runtime checks.
1524
1525 +++
1526 *** --distfiles specifies files to be included in binary distribution.
1527
1528 +++
1529 *** --without-gnutls disables automatic GnuTLS detection.
1530
1531 +++
1532 *** --lib for general library linkage, works with the USER_LIBS build variable.
1533
1534 +++
1535 ** New make target `dist' to create binary distribution for MS Windows.
1536
1537 ---
1538 ** The Lisp function `w32-default-color-map' is now obsolete.
1539 (It is only used internally in the Emacs C code.)
1540
1541 +++
1542 ** Customize ns-auto-hide-menu-bar to have the menu-bar hidden, but
1543 reappear on mouse-over. (Requires OS X 10.6 or later.)
1544
1545 \f
1546 ----------------------------------------------------------------------
1547 This file is part of GNU Emacs.
1548
1549 GNU Emacs is free software: you can redistribute it and/or modify
1550 it under the terms of the GNU General Public License as published by
1551 the Free Software Foundation, either version 3 of the License, or
1552 (at your option) any later version.
1553
1554 GNU Emacs is distributed in the hope that it will be useful,
1555 but WITHOUT ANY WARRANTY; without even the implied warranty of
1556 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1557 GNU General Public License for more details.
1558
1559 You should have received a copy of the GNU General Public License
1560 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
1561
1562 \f
1563 Local variables:
1564 mode: outline
1565 paragraph-separate: "[ \f]*$"
1566 end: