Implement Isearch in comint input history. (Bug#3746)
[emacs.git] / etc / NEWS
blob27f3b9868d838284730fa556fd6036e085aaa7df
1 GNU Emacs NEWS -- history of user-visible changes.
3 Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc.
4 See the end of the file for license conditions.
6 Please send Emacs bug reports to emacs-pretest-bug@gnu.org.
7 If possible, use M-x report-emacs-bug.
9 This file is about changes in Emacs version 23.
11 See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17
12 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.
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.
25 * Installation Changes in Emacs 23.2
27 ** New configure options for Emacs developers
28 These are not new features; only the configure flags are new.
30 *** --enable-profiling builds Emacs with profiling enabled.
31 This might not work on all platforms.
33 *** --enable-checking[=OPTIONS] builds emacs with extra runtime checks.
35 ---
36 ** `make install' now consistently ignores umask, creating a
37 world-readable install.
39 * Startup Changes in Emacs 23.2
41 ** Command-line option -Q (--quick) now also disables loading X resources.
42 Note however that this does not affect Lucid or Motif widgets, if you
43 are using those toolkits.  On Windows, this option causes Emacs to
44 ignore Registry settings, though environment variables set on the
45 Registry are still honored.
47 *** The new variable `inhibit-x-resources' shows whether X resources
48 were loaded.
50 * Changes in Emacs 23.2
52 ** The maximum size of buffers (as well as the largest fixnum) is doubled.
53 On typical 32bit systems, buffers can now be up to 512MB.
55 ** Function arguments in *Help* buffers are now in uppercase by default.
56 You can customize the new variable `help-downcase-arguments' to change it.
58 ** Unibyte sessions are now considered obsolete.
59 I.e. the use of the environment variable EMACS_UNIBYTE, or command line
60 arguments --unibyte, --multibyte, --no-multibyte, and --no-unibyte
61 is deprecated.  Similarly for custom-izing enable-multibyte-characters, or
62 setting default-enable-multibyte-characters.
64 ** The default value of `trash-directory' has changed to nil, which
65 means that `move-file-to-trash' trashes files according to
66 freedesktop.org specifications, the same method used by the Gnome,
67 KDE, and XFCE desktops.  (This change has no effect on Windows, which
68 uses `system-move-file-to-trash' for trashing.)
70 +++
71 ** Emacs frames can be maximized.
72 The command line arguments -mm/--maximized and the value maximized to the
73 frame parameter fullscreen makes the Emacs frame maximized.
75 +++
76 ** New frame parameter sticky makes Emacs frames sticky in virtual desktops.
78 ** The pointer now becomes invisible when typing.
79 Customize make-pointer-invisible to turn it off.
81 ** Emacs can use the system default monospaced font in Gnome.
82 The use of the system default font can be turned on or off by customizing
83 the variable 'font-use-system-font'.  It is off by default.
84 If the system default is changed, Emacs changes also.
85 This requires that gconf-support is built in.  If configure finds the
86 gconf-libraries, that support is included. Gconf-support can be
87 turned off with the configure option --without-gconf.
89 ** Emacs now reacts to Xft-changes made by configuration tools on X11.
90 Changes to antialias, hinting, hintstyle, RGBA, DPI and lcdfilter are
91 handeled.  The XSETTINGS mechanism is used to implement this.
93 ** Killing a buffer with a running process now asks for confirmation.
94 You can remove this query in two ways: either remove
95 `process-kill-buffer-query-function' from `kill-buffer-query-functions',
96 or set the appropriate process flag with `set-process-query-on-exit-flag'.
98 ** The variable `load-in-progress' won't get corrupted by binding it
99 with `let'.  In certain situations, loading an Emacs Lisp file from
100 source while in the midst of loading another file (e.g., with
101 `require' or `autoload') could cause the value of `load-in-progress'
102 to be corrupted once the outer load completed.  Most code doesn't care
103 about this, but some (like c-mode) may check it.
105 ** File-local variable changes
107 *** Specifying a minor mode as a local variables enables that mode,
108 unconditionally.  The previous behavior, toggling the mode, was
109 neither reliable nor generally desirable.
111 *** New commands for adding and removing file-local variables:
112 `add-file-local-variable', `delete-file-local-variable',
113 `add-file-local-variable-prop-line', and
114 `delete-file-local-variable-prop-line'.
116 *** New commands for adding and removing directory-local variables,
117 and copying them to and from file-local variable lists:
118 `add-dir-local-variable', `delete-dir-local-variable',
119 `copy-dir-locals-to-file-locals',
120 `copy-dir-locals-to-file-locals-prop-line' and
121 `copy-file-locals-to-dir-locals'.
123 ** New coding system `utf-8-hfs' is available in
124 international/ucs-normalize.el.  It is suitable for
125 default-file-name-coding-system on Mac OS X.
128 * Editing Changes in Emacs 23.2
130 ** Selection changes
132 *** If `select-active-regions' is t, any active region automatically
133 becomes the primary selection (for interaction with other window
134 applications).  If you enable this, you might want to bind
135 `mouse-yank-primary' to Mouse-2.
137 *** When `save-interprogram-paste-before-kill' is non-nil, emacs will
138 not clobber the the interprogram paste when something is killed in it
139 by saving the former in the `kill-ring' before the latter.
141 ** When `kill-do-not-save-duplicates' is non-nil, identical subsequent
142 kills are not duplicated in the `kill-ring'.
145 ** The default value for `blink-matching-paren-distance' has been increased.
147 ** The new completion-style `initials' is available.
148 For instance, this can complete M-x lch to list-command-history.
150 ** Completions in the *Completions* buffer are sorted vertically
151 when the value of the new variable `completions-format' is `vertical'.
153 ** M-r is bound to the new `move-to-window-line-top-bottom'
154 to mirror the new behavior of C-l in Emacs-23.1.
157 * Changes in Specialized Modes and Packages in Emacs 23.2
159 ** The bookmark menu has a narrowing search via bookmark-bmenu-search.
161 ** LaTeX mode now provides completion via latex-complete and
162 latex-indent-or-complete.
164 ** lucid.el and levents.el are now declared obsolete.
166 ** pcomplete provides a new command `pcomplete-std-completion' which
167 is similar to `pcomplete' but using the standard completion UI code.
169 ** .calc.el and .abbrev_defs obey user-emacs-directory.
171 ** Calc graphing commands (`g f' etc.) now work on MS-Windows,
172 if you have the native Windows port of Gnuplot version 3.8 or later
173 installed.
175 ** Calendar and diary
177 *** Fancy diary display is now the default.
178 If you prefer the simple display, customize `diary-display-function'.
180 *** The diary's fancy display now enables view-mode.
183 *** The command `calendar-current-date' accepts an optional argument
184 giving an offset from today.
186 ** Desktop
188 *** The default value for `desktop-buffers-not-to-save' is nil.
189 This means Desktop will try restoring all buffers, when you restart
190 your Emacs session.  Also, `desktop-buffers-not-to-save' is only
191 effective for buffers that have no associated file.  If you want to
192 exempt buffers that do correspond to files, customize the value of
193 `desktop-files-not-to-save' instead.
195 ** FIXME mail-user-agent change
196 This probably affects a lot of documentation.
198 ** FIXME gdb-mi
200 ** Info
202 *** The new command `Info-virtual-index' bound to "I" displays a menu of
203 matched topics found in the index.
205 *** The new command `info-finder' replaces finder.el with a virtual Info
206 manual that generates an Info file which gives the same information
207 through a menu structure.
210 ** New connection methods in Tramp.
211 The new connection methods "rsyncc", "imap" and "imaps" have been
212 introduced.  On systems which support GVFS-Fuse, Tramp offers also the
213 new connection methods "dav", "davs", "obex" and "synce".
215 ** nXML mode is now the default for editing XML files.
217 ** VC and related modes
219 *** When using C-x v v or C-x v i on a unregistered file that is in a
220 directory not controlled by any VCS, ask the user what VC backend to
221 use to create a repository, create a new repository and register the
222 file.
224 *** FIXME: add info about the new VC functions: vc-root-diff and
225 vc-root-print-log once they stabilize.
227 *** The log functions (C-x v l and C-x v L) do not show the full log
228 by default anymore.  The number of entries shown can be chosen
229 interactively with a prefix argument, by customizing
230 vc-log-show-limit.  The log buffer display buttons that can be used
231 to change the number of entries shown.
232 RCS, SCCS, CVS and Git do not support this feature.
234 *** vc-annotate supports annotations through file copies and renames,
235 it displays the old names for the files and it can show logs/diffs for
236 the corresponding lines.  Currently only Git and Mercurial take
237 advantage of this feature.
239 *** When a file is not found, VC will not try to check it out of RCS anymore.
241 *** Diff and log operations can be used from dired buffers.
243 *** vc-git changes
245 **** The new variable vc-git-add-signoff can be used to add a
246 Signed-off-by line when committing.
248 **** Support for operating with stashes has been added to vc-dir: the stash list is
249 displayed in the *vc-dir* header, stashes can be created, removed and
250 their content displayed.
252 **** vc-dir displays the stash status
254 *** log-edit-strip-single-file-name controls whether or not single filenames
255 are stripped when copying text from the ChangeLog to the *VC-Log* buffer.
257 ** Elint
260 *** Elint now uses compilation-mode.
263 *** Elint can now scan individual files and whole directories,
264 and can be run in batch mode.
267 *** Elint does a more thorough initialization, and recognizes more built-in
268 functions and variables.  Customize `elint-scan-preloaded' if you want
269 to sacrifice some accuracy for a faster startup.
272 *** Elint attempts some basic understanding of featurep and (f)boundp tests.
275 *** Customize `elint-ignored-warnings' to suppress some warnings.
277 ** Miscellaneous
279 *** The new command `async-shell-command' bound globally to `M-&' executes
280 the command asynchronously without the need to manually add ampersand to
281 the end of the command.  Its output appears in the buffer `*Async Shell
282 Command*'.
284 *** Isearch searches in the comint/shell input history when the new variable
285 `comint-history-isearch' is non-nil.  New commands `comint-history-isearch-backward'
286 and `comint-history-isearch-backward-regexp' start Isearch in the input history
287 regardless of the value of `comint-history-isearch'.
290 *** Autorevert Tail mode now works now for remote files.
293 * New Modes and Packages in Emacs 23.2
295 ** htmlfontify.el turns a fontified Emacs buffer into an HTML page.
297 ** FIXME CEDET
299 ** js.el is a new major mode for JavaScript files.
301 ** imap-hash.el is a new library to address IMAP mailboxes as hashtables.
304 * Incompatible Lisp Changes in Emacs 23.2
306 ** Several obsolete functions removed.
307 The functions have been obsolete since Emacs 19, and are unlikely to
308 be in use:
310   time-stamp-month-dd-yyyy, time-stamp-dd/mm/yyyy, time-stamp-mon-dd-yyyy
311   time-stamp-dd-mon-yy, time-stamp-yy/mm/dd, time-stamp-yyyy/mm/dd,
312   time-stamp-yyyy-mm-dd, time-stamp-yymmdd, time-stamp-hh:mm:ss,
313   time-stamp-hhmm, baud-rate
316 ** Support for generating Emacs 18 compatible bytecode (by setting
317 the variable `byte-compile-compatibility') has been removed.
320 * Lisp changes in Emacs 23.2
322 ** New function `completion-in-region' to use the standard completion
323 facilities on a particular region of text.
325 ** The 4th arg to all-completions (aka hide-spaces) is declared obsolete.
327 ** read-file-name-predicate is obsolete.  It was used to pass the predicate
328 to read-file-name-internal because read-file-name-internal abused its `pred'
329 argument to pass the current directory, but this hack is not needed
330 any more.
332 ** completion-base-size is obsoleted by completion-base-position.
333 This change causes a few backward incompatibilities, mostly with
334 choose-completion-string-functions where the `mini-p' argument has
335 been replaced by a `base-position' argument, and where the `base-size'
336 argument is now always nil.
338 ** called-interactively-p now takes one argument and replaces interactive-p
339 which is now marked obsolete.
340 ** New function set-advertised-calling-convention makes it possible
341 to obsolete arguments as well as make some arguments mandatory.
342 ** eval-next-after-load is obsolete.
343 ** New hook `after-load-functions' run after loading an Elisp file.
345 ** You can control which binding is preferentially shown in menus and
346 docstrings by adding a `:advertised-binding' property to the corresponding
347 command's symbol.  That property can hold a single binding or a list
348 of bindings.
350 ** New macro with-silent-modifications to tweak text properties without
351 affecting the buffer's modification state.
352 ** All the default-FOO variables that hold the default value of the FOO
353 variable, are now declared obsolete.
355 ** read-key is a function halfway between read-event and read-key-sequence.
356 It reads a single key, but obeys input and escape sequence decoding.
358 ** start-process-shell-command and start-file-process-shell-command
359 now only take a single `command' argument.
361 ** The variable `process-file-side-effects' shall be bound to nil, if
362 a `process-file' call does not change a remote file.  By this, file
363 name handlers like Tramp can apply optimizations.
365 ** Hash tables have a new printed representation that is readable.
366 The feature `hashtable-print-readable' identifies this new
367 functionality.
369 ** Functions performing Unicode normalization are added.  They are:
370 ucs-normalize-NFD-region, ucs-normalize-NFD-string,
371 ucs-normalize-NFC-region, ucs-normalize-NFC-string,
372 ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,
373 ucs-normalize-NFKC-region, ucs-normalize-NFKC-string,
374 ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string,
375 ucs-normalize-HFS-NFC-region, ucs-normalize-HFS-NFC-string.
377 ** completion-annotate-function specifies how to compute annotations
378 for completions displayed in *Completions*.
381 ** Face aliases can now be marked as obsolete, using the macro
382 `define-obsolete-face-alias'.
385 ** Changing the file-names generated by byte-compilation by redefining
386 the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
387 Instead, customize byte-compile-dest-file-function.
390 ** `byte-compile-warnings' can have a new member, `constants'.
392 ** `delete-directory' has an optional parameter RECURSIVE.
394 ** New function `copy-directory', which copies a directory recursively.
397 ** New function `window-full-height-p', analogous to the full-width version.
400 * Changes in Emacs 23.2 on non-free operating systems
403 ** On MS-Windows, `display-time' now displays the system load average
404 as well as the time, as it does on GNU and Unix.
407 * Installation Changes in Emacs 23.1
409 ** The default X toolkit is now Gtk+, rather than Lucid.
410 The configure option `--with-gtk' has been removed.  Gtk is now the
411 default toolkit, but you can use --with-x-toolkit=gtk if necessary.
413 ** New font code.
414 Fonts are handled by new code capable of dealing with multiple font
415 backends.  This uses the freetype and fontconfig libraries.
417 *** Emacs now accepts font names supplied in the fontconfig format
418 (e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
420 *** Added support for local fonts (fonts installed on the machine
421 where Emacs is running).
423 *** Added support for the Xft library for antialiasing.
425 *** Added support for the otf library for complex text layout by
426 OpenType fonts.
428 *** Added support for the m17n library for text shaping.
430 ** Changes to image support
432 *** configure now checks for libgif before libungif when searching for
433 a GIF library.
435 *** Emacs now supports the SVG image format through librsvg2.
437 *** Emacs now supports multi-page TIFF images.
439 ** New NeXTSTEP-based port
440 This provides support for GNUstep (via the GNUstep libraries) and Mac
441 OS X (via the Cocoa libraries).
443 Specify --with-ns to configure for this.  By default, a self-contained
444 app will be built (containing all lisp).  To install/share lisp with
445 other emacsen (e.g. X11 build) use --disable-ns-self-contained.  See
446 nextstep/README and nextstep/INSTALL in the Emacs source directory.
448 ** Mac OS X is no longer supported via Carbon.
449 Use the NeXTSTEP port, described above.
451 ** The new configuration option "--with-dbus" enables D-Bus language
452 bindings for Emacs.
454 ** Support for many obsolete platforms has been removed.
455 See the list at the end of etc/MACHINES for details.
457 *** Support for systems without alloca has been removed.
459 *** Support for Sun windows has been removed.
461 *** The `emacstool' utility has been removed.
463 ** The following platforms will be removed in a future Emacs version:
464 If you are still using Emacs on one of these platforms, please email
465 emacs-devel@gnu.org to inform the Emacs developers.
467 *** Old GNU/Linux systems based on libc version 5.
469 *** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
470     executable format.
472 *** Solaris versions 2.6 and below.
474 *** Solaris on IBM RS6000 machines.
476 *** UNIX System V (the original SysV, not later platforms based on it).
478 *** Unixware on non-x86 machines.
480 *** Platforms not supporting shared libraries (i.e., requiring the
481 NO_SHARED_LIBS compilation flag).
483 ** The configure options `--with-gcc', `--without-gcc' have been removed.
484 Configure will use gcc by default.  Set the CC environment variable if
485 you need control over which C compiler is used.
487 ** The refcards are now shipped as PDF files.
489 ** The manuals are now licensed under the GNU Free Documentation License v1.3,
490 or any later version.
492 ** Emacs 23 comes with a new set of default icons.
493 Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
494 The Emacs 22 icon is available as `emacs22.png' in the same location.
496 * Changes in Emacs 23.1
498 ** Improved X Window System support
500 *** Emacs now supports using both X displays and ttys in one session.
501 With an Emacs server active (M-x server-start), `emacsclient -t'
502 creates a tty frame connected to the running emacs server.  You can
503 use any number of different ttys.  `emacsclient -c' creates a new X11
504 frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
505 There may be problems if a display exits unexpectedly and Emacs is compiled
506 with Gtk+, see etc/PROBLEMS.
508 You can test for the presence of this feature in your Lisp code by
509 testing for the `multi-tty' feature.
511 *** Emacs starts in the background, as a daemon, when given the
512 --daemon command line argument.  It disconnects from the terminal and
513 starts the server.  Clients can connect and create graphical or
514 terminal frames using emacsclient.
516 **** emacsclient starts emacs in daemon mode and connects to it when
517 --alternate-editor="" is used (or when the evironment variable
518 ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an
519 emacs server.
521 *** The new command close-display-connection closes a connection to a
522 remote display.  There are some bugs for Gtk+.  See etc/PROBLEMS.
524 *** Emacs now supports the XEmbed specification.
525 You can embed Emacs in another application on X11.  The new command line
526 option --parent-id is used to pass the parent window id to Emacs.  See
527 http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
528 for details about XEmbed.
530 *** Emacs can now set the frame opacity.
531 The opacity of a frame can be controlled by setting the `alpha' frame
532 parameter.  This only takes effect on a compositing window manager for
533 the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac
534 OS X, or on Windows 2000 and later versions of Windows.
536 The alpha parameter should be an integer between 0 (transparent) and
537 100 (opaque), or a float number between 0.0 and 1.0.  It can also be a
538 cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
539 active frame and INACTIVE is the opacity of non-active frames.
541 The variable `frame-alpha-lower-limit' defines a lower bound for the
542 opacity; the default is 20.
544 ** Internationalization changes
546 *** The Emacs character set is now a superset of Unicode.
547 (It has about four times the code space, which should be plenty).
549 The internal encoding used for buffers and strings is now
550 Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias
551 for this).  This encoding is backward-compatible with Unicode's UTF-8
552 encoding.  The internal encoding previously used by Emacs,
553 `emacs-mule', is still available for reading and writing files.
555 During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
556 As a result, byte-compiled files containing non-ASCII characters can't
557 be read by earlier versions of Emacs.  Files compiled by Emacs 20, 21,
558 or 22 are loaded correctly as `emacs-mule' (whether or not they
559 contain multibyte characters).  This takes somewhat more time, so it
560 may be worth recompiling existing .elc files which don't need to be
561 shared with older Emacsen.
563 *** There are new coding systems/aliases; see M-x list-coding-systems.
565 *** There is a new charset implementation with many new charsets.
566 See M-x list-character-sets.  New charsets can be defined conveniently
567 as tables of unicodes.
569 *** There are new language environments for Chinese-GBK,
570 Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
571 Sinhala, and TaiViet.
573 *** The minor modes unify-8859-on-encoding-mode and
574 unify-8859-on-decoding-mode are obsolete.
576 *** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
577 accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
578 decimal).  It also accepts Unicode character names with completion.
580 *** The `cyrillic-translit' input method supports many new characters.
581 Common typographical characters available from Unicode were added to
582 `cyrillic-translit': punctuation marks, accented characters, fractions,
583 and others.
585 ** Emacs now supports serial port access on GNU/Linux, Unix, and
586 Windows.  The new command `serial-term' starts an interactive terminal
587 on a serial port.  The serial port can be configured at runtime with
588 the mode-line mouse menu.
590 ** Menu Bar changes
592 *** In the Options menu, the "Set Default Font" item applies the
593 selected font to the `default' face on all frames, not just the
594 current frame.  Furthermore, if Emacs is compiled with both GTK and
595 Fontconfig support, the "Set Default Font" item uses the GTK font
596 selection dialog instead of an Emacs pop-up menu.
598 *** The font setting chosen by "Set Default Font" is saved if the
599 "Save Options" item is used.
601 *** The Tools menu contains a new Encryption/Decryption submenu.
602 This contains commands provided by EasyPG, the newly-included
603 interface to GnuPG (see New Modes and Packages).
605 *** In the Options menu, the "Truncate Long Lines in the Buffer" entry
606 has been replaced with a submenu offering three different ways to
607 handle long lines: truncation, continuation at the window edge, and
608 the new word wrapping behavior (see Editing Changes, below).
610 *** Improvements to menus for major and minor modes
611 More major and minor modes now have a mode specific menu, and existing
612 mode menus have been improved to include more functionality.
614 ** Mode-line changes
616 *** The mode-line displays a `@', instead of `-', if the
617 default-directory for the current buffer is on a remote machine.
619 *** The mode-line displays a mode menu when mouse-1 is clicked on a
620 minor mode, in the same way as it already did for major modes.
622 *** The `mode-line-emphasis' face is used to highlight certain
623 mode-line information (e.g. waiting for a VC command to finish).
625 *** The mode-line tooltips have been improved to provide more details.
627 *** The VC, line/colum number and minor mode indicators on the mode
628 line are now interactive: mouse-1 can be used on them to pop up a menu.
630 ** File deletion can make use of the Recycle Bin or system Trash folder.
631 Set `delete-by-moving-to-trash' non-nil to use this.  Deleted files
632 and directories will then be sent to the Recycle Bin on Windows, and
633 to `trash-directory' on other systems.
635 ** Directory-local variables can now be defined.
636 By default, Emacs looks in .dir-locals.el for directory-local
637 variables.  For more information, see `dir-locals-set-directory-class'
638 and `dir-locals-set-class-variables'.
640 ** Emacs can now use `auth-source' for authentication.
641 `smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
642 login names and passwords.  The match, if found, is reported
643 in *Messages* with the password blanked out.
645 ** `where-is-preferred-modifier' can specify your favorite modifier.
648 * Startup Changes in Emacs 23.1
650 ** The option `inhibit-startup-screen' (with aliases to old names
651 `inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
652 display of the initial message in the *scratch* buffer.  If you don't
653 want to display the initial message in the *scratch* buffer at startup,
654 you can set the option `initial-scratch-message' to nil.
656 ** New user option `initial-buffer-choice' specifies what to display
657 after starting Emacs: startup screen, *scratch* buffer, visiting a
658 file or directory.
660 ** New alias `argv' for `command-line-args-left'
661 This is a convenience alias, so that one can write `(pop argv)'
662 inside of --eval command line arguments in order to access
663 following arguments.
665 ** The abbrev file is no longer read at startup in batch mode.
667 ** Emacs now supports invocation by an X session manager.
668 It can save a session and restore it later.  See the documentation of
669 the functions `emacs-session-save' and `emacs-session-restore'.
670 (Actually, this feature was introduced with Emacs 22, but it was not
671 documented.)
673 * Incompatible Editing Changes in Emacs 23.1
675 ** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
676 on the regexp command prefix map.
678 ** In Dired-x, all command guesses for ! are now added to the default
679 list accessible by M-n instead of pushing all guesses temporarily into
680 the history list.
682 ** In Isearch mode, a special case of typing `C-w' at the beginning of
683 the minibuffer that toggles word search (i.e. using key sequences
684 `C-s RET C-w' or `C-s M-e C-w') is obsolete.  You can use the global key
685 `M-s w' to start word search, or type `M-s w' in Isearch mode to
686 toggle word search.  To start nonincremental word search you can now use
687 `M-s w RET' and `M-s w C-r RET' instead of `C-s RET C-w' and `C-r RET C-w'.
689 ** In Info, `Info-search' is unbound from `M-s' to allow using `M-s w'
690 for word search as well as other search commands from the global prefix
691 key `M-s'.  `Info-search' is still bound to `s', and also incremental
692 search commands `C-s', `C-M-s', `C-r', `C-M-r' are available for searching
693 through multiple Info nodes, together with their nonincremental versions
694 `C-s RET', `C-r RET', `C-M-s RET', `C-M-r RET', `M-s w RET'.
696 ** In Text mode, `center-line' and `center-paragraph' are rebound from
697 `M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the global
698 prefix map `M-o', which is intended for such formatting commands.
700 ** The following input methods were removed in Emacs 22.2, but this was
701 not advertised: danish-alt-postfix, esperanto-alt-postfix,
702 finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
703 norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
704 and swedish-alt-postfix.  Use the versions without "alt-", which are
705 identical.
708 * Editing Changes in Emacs 23.1
710 ** The C-n and C-p line-motion commands now move by screen lines,
711 taking continued lines and variable-width characters into account.
712 Setting `line-move-visual' to nil reverts this to the previous
713 behavior (i.e., motion by logical lines based on buffer contents
714 alone).
716 ** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
717 invokes `suspend-frame'.  These changes are for compatibility with the
718 new multi-tty support (see `Improved X Window System support' above).
720 ** Mark changes
722 *** Transient Mark mode is now on by default.
724 *** mark-even-if-inactive now defaults to t
726 *** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
727 activating it.
729 *** When Transient Mark mode is on, M-q now fills the region if the
730 region is active.  Otherwise, it fills the current paragraph.
732 *** When Transient Mark mode is on, M-$ now checks spelling of the
733 region if the region is active.  Otherwise, it checks spelling of the
734 word at point.
736 *** When Transient Mark mode is on, TAB now indents the region if the
737 region is active.
739 *** The variable `use-empty-active-region' controls whether an empty
740 active region in Transient Mark mode should make commands operate on
741 that empty region.
743 ** Temporarily active regions
745 *** The new variable shift-select-mode, non-nil by default, controls
746 shift-selection.  When Shift Select mode is on, shift-translated
747 motion keys (e.g. S-left and S-down) activate and extend a temporary
748 region, similar to mouse-selection.
750 *** Temporarily active regions, created using shift-selection or
751 mouse-selection, are not necessarily deactivated in the next command.
752 They are only deactivated after point motion commands that are not
753 shift-translated, or after commands that would ordinarily deactivate
754 the mark in Transient Mark mode (e.g., any command that modifies the
755 buffer).
757 ** Minibuffer and completion changes
759 *** Emacs may ask for confirmation before opening a non-existent file
760 or buffer.  By default, Emacs requests confirmation if you type RET
761 immediately after TAB, and the resulting input is not an existing file
762 or buffer; this usually happens when the minibuffer input did not
763 complete far enough and you entered RET by mistake.  In that case,
764 Emacs puts the message "[Confirm]" in the minibuffer; type RET again
765 to create the file or buffer.
767 The new variable confirm-nonexistent-file-or-buffer determines whether
768 Emacs asks for confirmation.  The default value is `after-completion'.
769 If you change it to t, Emacs always asks for confirmation; if you
770 change it to nil, Emacs never asks for confirmation.
772 *** The rules for performing completion have been changed.
773 When generating completion alternatives, Emacs now takes the
774 minibuffer text after point, if any, into account: this text is
775 treated as a substring of the remaining part of the completion
776 alternative (i.e., the part not matched by the minibuffer text before
777 point).  If no completion alternatives are found this way, Emacs
778 attempts to perform partial-completion.  If still no completion
779 alternatives are found, we fall back on the Emacs 22 rules for
780 performing completion.
782 The new variable `completion-styles' can be customized to choose your
783 favorite completion style.
785 *** When M-n in the minibuffer reaches the end of the list of defaults,
786 it adds the completion list to the end, so next M-n continues putting
787 completion items to the minibuffer.  The same principle applies to
788 incremental search commands as well: C-s or C-M-s starts searching
789 the default values and after the end of defaults they continue
790 searching minibuffer completion items.
792 *** Minibuffer input of shell commands now comes with completion.
794 *** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
795 name of the current buffer.
797 *** In the M-! (shell-command) prompt, M-n provides some default commands.
798 These are guessed using the file extension of the current file, based
799 on the file-handlers specified in the operating system's `mailcap'
800 file.  The ! command in Dired (dired-do-shell-command) works
801 similarly, using the file displayed on the current line.
803 *** A list of regexp default values is available via M-n for `occur',
804 `keep-lines', `flush-lines' and `how-many'.  This list includes the active
805 region in transient-mark-mode, the word under the cursor, the last Isearch
806 regexp, the last Isearch string and the last replacement regexp.
808 *** When enable-recursive-minibuffers is non-nil, operations which use
809 switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
810 used in a minibuffer or a dedicated window.  Instead, they fallback on
811 using pop-to-buffer, which will use some other window.  This change
812 has no effect when enable-recursive-minibuffers is nil (the default).
814 *** Isearch started in the minibuffer searches in the minibuffer history.
815 Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer
816 history elements, and forward Isearch commands (C-s, C-M-s) search in
817 next history elements.  When the reverse search reaches the first history
818 element, it wraps to the last history element, and the forward search
819 wraps to the first history element.  When the search is terminated, the
820 history element containing the search string becomes the current.
822 *** The variable read-file-name-completion-ignore-case overrides
823 completion-ignore-case for file name completion.
825 *** The variable read-buffer-completion-ignore-case overrides
826 completion-ignore-case for buffer name completion.
828 *** The new command `minibuffer-force-complete' chooses one of the
829 possible completions, rather than stopping at the common prefix.
831 *** If `completion-auto-help' is `lazy', Emacs shows the completions
832 buffer only on the second attempt to complete.  This was already
833 supported in `partial-completion-mode'.
835 ** Face changes
837 *** S-down-mouse-1 now pops up a menu for changing the font and text
838 size of the default face in the current buffer.  The face is changed
839 via face remapping (see Lisp changes, below).
841 *** New commands to change the default face size in the current buffer.
842 To increase it, type `C-x C-+' or `C-x C-='.  To decrease it, type
843 `C-x C--'.  To restore the default (global) face size, type `C-x C-0'.
844 These work via Text Scale mode, a new minor mode.
846 The final key in the above commands may be repeated without the
847 leading `C-x', e.g. `C-x C-= C-= C-=' increases the face height by
848 three steps.  Each step scales the height of the default face by the
849 value of the variable `text-scale-mode-step'.
851 *** The commands buffer-face-mode and buffer-face-set can be used to
852 remap the default face in the current buffer.  See "Buffer Face mode",
853 under New Modes and Packages.
855 ** Primary selection changes
857 *** You can disable kill ring commands from accessing the primary
858 selection by setting `x-select-enable-primary' to nil.
860 ** Continuation lines can now be wrapped at word boundaries
861 (word-wrapping).  This is controlled by the new per-buffer variable
862 `word-wrap'.  Word wrapping does not take place if continuation lines
863 are not shown, e.g. if truncate-lines is non-nil.  The most convenient
864 way to enable word-wrapping is using the new minor mode Visual Line
865 mode; in addition to setting `word-wrap' to t, this rebinds some
866 editing commands to work on screen lines rather than text lines.  See
867 New Modes and Packages, below.
869 ** Window management changes
871 *** truncate-partial-width-windows now accepts integer values, which
872 specify a minimum window width for partial-width windows, below which
873 lines are truncated.  The default has been changed to 50.
875 *** The new command balance-windows-area balances windows both
876 vertically and horizontally.
878 *** pop-to-buffer now always sets input focus when the popped-to window
879 is on a different frame.
881 ** Miscellaneous changes:
883 *** C-l is bound to the new command recenter-top-bottom, rather than recenter.
884 This moves the current line to window center, top and bottom on
885 successive invocations.
887 *** scroll-preserve-screen-position also preserves the column position.
889 *** If `yank-pop-change-selection' is t, rotating the kill ring also
890 updates the selection or clipboard to the current yank, just as M-w
891 would do so with the text it copies to the kill ring.
893 *** C-M-% now shows replacement as it would look in the buffer, with
894 `\N' and `\&' substituted according to the match.  Old behavior can be
895 restored by customizing `query-replace-show-replacement'.
897 *** The command shell prompts for the default directory, when it is
898 called with a prefix and the default directory is a remote file name.
899 This is because some file name handlers (like ange-ftp) are not able to
900 run processes remotely.
902 *** The new command kill-matching-buffers kills buffers whose name
903 matches a regexp.
905 *** The value of comment-style now defaults to `indent'.
906 Thefore, comment-start markers are inserted at the current indentation
907 of the region to comment, rather than the leftmost column.
909 *** The new commands `pp-macroexpand-expression' and
910 `pp-macroexpand-last-sexp' pretty-print macro expansions.
912 *** The new command `set-file-modes' allows to set file's mode bits.
913 The mode bits can be specified in symbolic notation, like with GNU
914 Coreutils, in addition to an octal number.  `chmod' is a new
915 convenience alias for this function.
917 *** `next-error-recenter' specifies how next-error should recenter the
918 visited source file.  Its value can be a number (for example, 0 for
919 top line, -1 for bottom line), or nil for no recentering.
921 *** When typing in a password in the echo area, C-y yanks the current
922 kill into the password.
924 *** Tooltip frame parameters `font' and `color' in `tooltip-frame-parameters'
925 are ignored.  Customize the `tooltip' face instead.
927 *** `mkdir' is a new convenience alias for `make-directory'.
929 * New Modes and Packages in Emacs 23.1
931 ** Auto Composition Mode is a minor mode that composes characters
932 automatically when they are displayed.  It is globally on by default.
933 It uses `auto-composition-function' (default `auto-compose-chars').
935 ** Bubbles, a new game, is similar to SameGame.
937 ** Buffer Face mode is a minor mode for remapping the default face in
938 the current buffer.  The variable `buffer-face-mode-face' specifies
939 the face to remap to.  The command `buffer-face-set' prompts for a
940 face name, sets `buffer-face-mode-face' to it, and enables
941 buffer-face-mode.  See "Face changes", under Editing Changes, for a
942 description of face remapping.
944 ** butterfly flips the desired bit on the drive platter.
945 See http://xkcd.com/378/
947 ** bug-reference.el provides clickable links to bug reports.
949 ** dbus.el provides D-Bus language bindings.
950 D-Bus is an inter-process communication mechanism for applications
951 residing on the same host.  See the manual for details.
953 ** DocView mode allows viewing of PDF, PostScript and DVI documents.
954 One can also search for a regular expression in the document.  For
955 details, see the commentary in doc-view.el.
957 PDF and DVI files are now opened in Doc View mode by default.
959 In Postcript mode, C-c C-c launches Doc View minor mode for viewing
960 the postscript file.
962 ** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
963 It includes a GnuPG keyring browser, cryptographic operations on
964 regions and files, and automatic encryption of *.gpg files.  For
965 details, see the EasyPG Assistant User's Manual.
967 ** json.el is a library for parsing and generating JSON
968 (JavaScript Object Notation), a lightweight data-interchange format.
970 ** linum.el is a new minor mode to display line numbers for the
971 current buffer.
973 ** mairix.el is an interface to mairix, a free tool for indexing and
974 searching locally stored mail.  It allows you to query mairix and
975 display the search results with Rmail, Gnus and VM.  Note that there
976 is an existing Gnus back end, nnmairix.el, which should be used with
977 Maildir/MH setups.
979 ** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
981 ** nXML Mode
982 This is a new mode for editing XML documents.  It allows a schema to
983 be associated with the XML document being edited, using Relax NG as
984 the schema language.  The schema is used to provide two key features:
986 *** Continuous validation.  nXML validates as you type, highlighting
987 any invalid parts of your document.
989 *** Completion.  nXML can assist you in entering an element name,
990 attribute name or data value by using information about what is
991 allowed by the schema in that context.
993 ** proced.el provides a Dired-like interface for operating on
994 processes.  Proced makes an Emacs buffer containing a listing of the
995 current processes.  You can use the normal Emacs commands to move
996 around in this buffer, and special Proced commands to operate on the
997 processes listed.  It is currently only functional on GNU/Linux,
998 MS-Windows and Solaris.
1000 ** Remember Mode is a mode for jotting down things to remember.
1001 Notes can be saved to a Diary file.  For details, see the Remember
1002 Manual.
1004 ** RST mode is a major mode for editing reStructuredText files.
1006 ** Ruby mode is a major mode for Ruby files.
1008 ** Visual Line mode provides support for editing by visual lines.
1009 It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
1010 and C-k to commands that operate by visual lines instead of logical
1011 lines.  This is a more reliable replacement for longlines-mode.
1012 This can also be turned on using the menu bar, via
1013 Options -> Line Wrapping in this Buffer -> Word Wrap
1015 ** xesam.el is an implementation of Xesam, an interface to (desktop)
1016 search engines like Beagle, Strigi, and Tracker.  The Xesam API
1017 requires D-Bus for communication.
1019 ** zeroconf.el offers service discovery and service publishing
1020 interfaces according to the zeroconf specification.  It communicates
1021 with Avahi, a zeroconf implementation, via D-Bus messages on systems
1022 which have installed this software.
1024 ** There is a new `whitespace' package.
1025 (The pre-existing one has been renamed to `old-whitespace'.)
1026 Now, besides reporting bogus blanks, the whitespace package has a
1027 minor mode and a global minor mode to visualize blanks (TAB, (HARD)
1028 SPACE and NEWLINE).  The visualization is made via faces and/or display
1029 table.  It can also indicate lines that extend beyond a given column,
1030 trailing blanks, and empty lines at the start or end of a buffer.
1031 See `whitespace-style' for more details.  The `whitespace-action' option
1032 specifies what to do when a buffer is visited, killed, or written.
1035 * Changes in Specialized Modes and Packages in Emacs 23.1
1037 ** Abbrev has been rewritten in Elisp and extended with more flexibility.
1039 *** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
1040     abbrev-table-p, abbrev-insert, abbrev-table-menu.
1042 *** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
1044 *** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
1045     extra arguments for arbitrary properties.
1047 *** New variable `abbrev-minor-mode-table-alist'.
1049 *** `local-abbrev-table' can hold a list of abbrev-tables.
1051 *** Abbrevs have now the following special properties:
1052     `:count', `:system', `:enable-function', `:case-fixed'.
1054 *** Abbrev-tables have now the following special properties:
1055     `:parents', `:case-fixed', `:enable-function', `:regexp',
1056     `abbrev-table-modiff'.
1058 ** Apropos
1060 *** `apropos-library' describes the elements defined in a given library.
1062 *** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
1064 ** Archive Mode has basic support to browse Rar archives.
1065 Note, however, that the free version of the unrar command only handles
1066 versions 1 and 2 of the Rar format.
1068 ** BibTeX mode
1070 *** New command `bibtex-initialize' (re)initializes BibTeX buffers.
1072 *** New `bibtex-entry-format' options `whitespace', `braces', and
1073 `string', disabled by default.
1075 *** New variable `bibtex-cite-matcher-alist' contains rules to
1076 identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
1078 *** Command `bibtex-url' allows multiple URLs per entry.
1080 ** Bookmarks
1082 *** bookmark.el saves bookmarks in a pre-Emacs-23-incompatible file format
1083 bookmark.el can read a .emacs.bmk file saved by an older Emacs, but an
1084 older Emacs cannot read one saved by Emacs 23.
1086 ** Calendar and diary
1088 *** There is a new date style, `iso', essentially year/month/day.
1089 The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
1090 Similarly, the commands `american-calendar' and `european-calendar'
1091 should be replaced by `calendar-set-date-style'.
1093 *** The calendar namespace has been rationalized.
1094 All functions and variables now begin with a `calendar-', `diary-', or
1095 `holiday-' prefix.  The various calendar systems have secondary
1096 prefixes, eg `calendar-french-'.  The old names you are likely to use
1097 directly still exist, for the time being, as aliases, but please start
1098 using the new names.
1100 *** The whitespace in the calendar layout can be customized.
1101 See the variables:
1102 calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
1103 calendar-day-header-width, and calendar-day-digit-width.
1105 *** Text (e.g. ISO weeks) can be displayed between the calendar months.
1106 See the variables calendar-intermonth-header and calendar-intermonth-text.
1108 *** The function `holiday-chinese' computes holidays on the Chinese calendar.
1109 It has been used to add items to the list `holiday-oriental-holidays'.
1111 *** `diary-remind' accepts a negative number -DAYS as a shorthand for
1112 the list (1 2 ... DAYS).
1114 ** Change Log mode
1116 *** The new command C-c C-f (change-log-find-file) finds the file
1117 associated with the current log entry.
1119 *** The new command C-c C-c (change-log-goto-source) goes to the
1120 source code associated with a log entry.
1122 ** Compile and grep modes
1124 *** The mode-line entry for the *compilation* and *grep* buffer is color coded.
1125 It has different colors for to show that: (a) the command is still
1126 running, (b) successful completion, (c) error.
1128 *** compilation-auto-jump-to-first-error tells `compile' to jump to
1129 the first error encountered during compilations.
1131 *** compilation-scroll-output accepts a new value, `first-error', which
1132 says to stop auto scrolling at the first error that occurs.
1134 *** The `cc' alias for C++ files in `grep-file-aliases' has been
1135 improved.  `hh' can be used to match C++ header files and `cchh' both
1136 C++ sources and headers.
1138 ** Copyright
1140 *** You can specify your copyright holders' names.
1141 Only copyright lines with holders matching `copyright-names-regexp' are
1142 considered for update.
1144 *** Copyrights can be at the end of the buffer.
1145 This is controlled by `copyright-at-end-flag' (used by, e.g., change-log-mode).
1147 ** Custom
1149 *** defcustom accepts new keyword arguments, `:safe' and `:risky', which
1150 set a variable's `safe-local-variable' and `risky-local-variable' property.
1152 ** Diff mode
1154 *** diff-refine-hunk highlights word-level details of changes in a diff hunk.
1155 It's used automatically as you move through hunks, see
1156 diff-auto-refine-mode.  It is bound to `C-c C-b'.
1158 *** diff-add-change-log-entries-other-window iterates through the diff
1159 buffer and tries to create ChangeLog entries for each change.
1160 It is bound to `C-x 4 A'.
1162 *** Turning on `whitespace-mode' in a diff buffer will show trailing
1163 whitespace problems in the modified lines.
1165 ** Dired
1167 *** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
1168 and C-x C-q in wdired-mode exits it with asking a question about
1169 saving changes.
1171 *** `&' runs the command `dired-do-async-shell-command' that executes
1172 the command asynchronously without the need to manually add ampersand
1173 to the end of the command.  Its output appears in the buffer `*Async Shell
1174 Command*'.
1176 *** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names.
1177 When a new user option `dired-isearch-filenames' is t, then even ordinary
1178 Isearch started with `C-s' and `C-M-s' matches only at file names in the
1179 Dired buffer.  When `dired-isearch-filenames' is `dwim' then activation of
1180 file name Isearch depends on the position of point - if point is on a file
1181 name initially, then Isearch matches only file names, otherwise it matches
1182 everywhere in the Dired buffer.  You can toggle file names matching on or
1183 off by typing `M-s f' in Isearch mode.
1185 *** `M-s a C-s' and `M-s a M-C-s' run multi-file Isearch on the marked files.
1186 They visit the first marked file in the sequence and display the usual Isearch
1187 prompt for a string or a regexp where all Isearch commands are available.
1189 *** `Q' in Dired provides two new keys for multi-file replacement.
1190 The upper case key `Y' replaces all remaining matches in all remaining files
1191 with no more questions.  The upper case key `N' stops doing replacements
1192 in the current file and skips to the next file.  These multi-file keys
1193 are available for all commands that use `tags-query-replace'
1194 including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
1195 `reftex-query-replace-document'.
1197 ** Fortran
1199 *** The line length of fixed-form Fortran is not fixed at 72 any more.
1200 Customize the variable `fortran-line-length' to change it.
1202 *** In Fortran mode, M-; is now bound to the standard comment-dwim,
1203 rather than fortran-indent-comment.
1205 *** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
1207 ** Gnus
1209 *** The Gnus package has been updated
1210 There are many news features, bug fixes and improvements; see the file
1211 GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
1213 *** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
1214 saving articles drafts and ~/.newsrc.eld.  These file may not be read
1215 correctly in Emacs 22 and below.  If you want to Gnus across different Emacs
1216 versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
1218 *** Passwords are consistently loaded through `auth-source'
1219 Gnus can use `auth-source' for POP and IMAP passwords.  Also see that
1220 `smtpmail' and `url' support `auth-source' for SMTP and HTTP/HTTPS/RSS
1221 authentication respectively.
1223 ** Help mode
1225 *** New macro `with-help-window' should set up help windows better
1226 than `with-output-to-temp-buffer' with `print-help-return-message'.
1228 *** New option `help-window-select' permits to customize whether help
1229 window shall be automatically selected when invoking help.
1231 *** New variable `help-window-point-marker' permits one to specify a new
1232 position for point in help window (for example in `view-lossage').
1234 ** Isearch
1236 *** New command `isearch-forward-word' bound globally to `M-s w' starts
1237 incremental word search.  New command `isearch-toggle-word' bound to the
1238 same key `M-s w' in Isearch mode toggles word searching on or off
1239 while Isearch is active.
1241 *** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch
1242 mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current
1243 search string as its regexp argument.  The same key `M-s h r' and
1244 other keys on the `M-s h' prefix are bound globally to the command
1245 `highlight-regexp' and other hi-lock commands.
1247 *** New command `isearch-occur' bound to `M-s o' in Isearch mode
1248 runs `occur' with the current search string.  The same key `M-s o'
1249 is bound globally to the command `occur'.
1251 *** Isearch can now search through multiple ChangeLog files.
1252 When running Isearch in a ChangeLog file, if the search fails,
1253 then another C-s tries searching the previous ChangeLog,
1254 if there is one (e.g. going from ChangeLog to ChangeLog.12).
1255 This is enabled if multi-isearch-search is non-nil.
1257 *** Two new commands to start Isearch on a list of marked buffers
1258 for buff-menu.el and ibuffer.el are bound to the keys `M-s a C-s' and
1259 `M-s a M-C-s'.
1261 *** The part of an Isearch that failed to match is highlighted in
1262 `isearch-fail' face.
1264 *** `C-h C-h' in Isearch mode displays isearch-specific Help screen,
1265 `C-h b' displays all Isearch key bindings, `C-h k' displays the full
1266 documentation of the given Isearch key sequence, `C-h m' displays
1267 documentation of Isearch mode.  All the rest Help commands exit Isearch mode
1268 and execute their global definitions.
1270 *** When started in the minibuffer, Isearch searches in the minibuffer
1271 history.  See `Minibuffer changes', above.
1273 ** MH-E
1275 *** Upgraded to MH-E version 8.2.  See MH-E-NEWS for details.
1277 ** Python
1278 *** The file etc/emacs.py now supports both Python 2 and 3, meaning
1279 that either version can be used as inferior Python by python.el.
1281 *** Python mode now has `pdbtrack' functionality.  When using pdb to
1282 debug a Python program, pdbtrack notices the pdb prompt and displays
1283 the source file and line that the program is stopped at, much the same
1284 way as gud-mode does for debugging C programs with gdb.
1286 ** Recentf
1288 *** The default value of `recentf-keep' prevents from checking of
1289 remote files, if there is no established connection to the
1290 corresponding remote host.
1292 ** Rmail
1294 *** Rmail no longer converts the messages to Babyl format.
1295 Instead, it uses UNIX mbox format, both on disk and in Rmail buffers,
1296 and does conversion and decoding when a message is displayed.
1298 The first time you visit an Rmail file in Babyl format, Rmail
1299 automatically converts it to mbox format.  This is a one-time
1300 conversion, but it can take a few minutes, depending on how fast is
1301 your machine and on the size of the file.  You should find the rest of
1302 Rmail usage unaltered.
1304 However, M-x set-rmail-inbox-list now lasts only for one session
1305 because there is no way to save the list of inbox files in an
1306 mbox-format file.
1308 Also, whereas with Babyl format M-x find-file would switch to Rmail
1309 mode, with mbox format this is no longer the case (there being no way
1310 to add an "-*- rmail-*-" cookie to an mbox file).  Use C-u M-x rmail
1311 instead.
1313 If you have written any extensions to Rmail, they are likely to need
1314 updating.  Conceptually, the Rmail buffer that you see is no longer
1315 just a narrowed portion of the whole.  So you cannot access the whole
1316 of a message (or message collection) by a simple save-restriction and
1317 widen.  Instead, there are two buffers: the rmail-buffer, and the
1318 rmail-view-buffer.  The former is the buffer that you see, the latter
1319 is invisible.  Most of the time, the invisible `view' buffer contains
1320 the full contents of the Rmail file, and the Rmail buffer contains a
1321 decoded copy of the current message (with only a subset of the
1322 headers).  In this state, Rmail is said to be `swapped'.
1324 You may find the following functions useful:
1326 `rmail-get-header' and `rmail-set-header' get or set the value of a
1327 message header, whether or not it is currently visible.
1329 `rmail-apply-in-message' is a general purpose function that calls a
1330 function (with arguments) which you specify on the full text of a given
1331 message.  To further narrow to just the headers, search forward for "\n\n".
1333 *** The new command `rmail-mime' displays MIME messages.
1334 It is bound to `v' in Rmail buffers and summaries.  It displays plain
1335 text and multipart messages in a temporary buffer, and offers buttons
1336 to save attachments.
1338 *** The command `rmail-redecode-body' no longer accepts the optional arg RAW.
1339 Since Rmail now holds messages in their original undecoded form in a
1340 separate buffer, `rmail-redecode-body' no longer encodes the original
1341 message, and therefore there should be no need to avoid encoding it.
1343 *** The o command is now `rmail-output'.  It is an all-purpose command
1344 for copying messages from Rmail and appending them to files.  It
1345 handles Babyl-format files as well as mbox-format files, and it
1346 handles both kinds properly when they are visited in Emacs.  It always
1347 copies the full headers of the message.
1349 *** The C-o command is now `rmail-output-as-seen'.  It uses
1350 the message as displayed, appending it to an mbox file.
1352 *** The modified status of the Rmail buffer is reported in the mode-line.
1353 Previously, this information was hidden.
1355 ** TeX modes
1357 *** New option latex-indent-within-escaped-parens
1358 permits to customize indentation of LaTeX environments delimited
1359 by escaped parens.
1361 ** T-mouse Mode
1363 *** If the gpm mouse server is running and t-mouse-mode is enabled,
1364 Emacs uses a Unix socket in a GNU/Linux console to talk to server,
1365 rather than faking events using the client program mev.  This C level
1366 approach provides mouse highlighting and help echoing in the
1367 minibuffer.
1369 ** Tramp
1371 *** New connection methods.
1372 The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
1373 been introduced.  There are also new so-called gateway methods
1374 "tunnel" and "socks".
1376 *** IPv6 addresses.
1377 IPv6 addresses are supported now as host names.  They must be embedded
1378 in square brackets, like in "/ssh:[::1]:".
1380 *** Multihop syntax has been removed.
1381 The pseudo-method "multi" has been removed.  Instead, multi hops
1382 can be specified by the new variable `tramp-default-proxies-alist'.
1384 *** More default settings.
1385 Default values can be set via the variables `tramp-default-user',
1386 `tramp-default-user-alist' and `tramp-default-host'.
1388 *** Connection information is cached.
1389 In order to reduce connection setup, information about used
1390 connections is kept persistently in a file.  The name of this file is
1391 defined in the variable `tramp-persistency-file-name'.
1393 *** Control of remote processes.
1394 Running processes on a remote host can be controlled by settings in
1395 `tramp-remote-path' and `tramp-remote-process-environment'.
1397 *** Success of remote copy is checked.
1398 When the variable `file-precious-flag' is set, the success of a remote
1399 file copy is checked via the file's checksum.
1401 *** Passwords can be read from an authentification file.
1402 Tramp uses the package `auth-source' to read passwords from a file, if
1403 necessary.
1405 ** VC and related modes
1407 *** VC now supports applying VC operations to a set of files at a time.
1408 This enables VC to work much more effectively with changeset-oriented
1409 version-control systems such as Subversion, GNU Arch, Mercurial, Git
1410 and Bzr.  VC will now pass a multiple-file commit to these systems as
1411 a single changeset.
1413 *** vc-dir is a new command that displays file names and their VC
1414 status.  It allows to apply various VC operations to a file, a
1415 directory or a set of files/directories.
1417 *** VC switches are no longer appended, rather the first non-nil value is used.
1418 (This was for the most part true in Emacs 22, but was not advertised).
1419 This is because there is an increasing variety of VC systems, and they
1420 do not all accept the same "common" options.  For example, a CVS diff
1421 command used to append the values of `vc-cvs-diff-switches',
1422 `vc-diff-switches', and `diff-switches'.  Now the first non-nil value
1423 from that sequence is used.  The special value `t' means "no switches".
1425 *** Clicking on the VC mode-line entry now pops the VC menu.
1427 *** The VC mode-line entry now has a tooltip that explains the VC file status.
1429 *** In VC Annotate mode, the key bindings have changed to use lower
1430 case keys instead of the upper case keys used in the past.
1432 *** In VC Annotate mode, for VC systems that support changesets, you can
1433 see the diff for the whole changeset (not only for the current file)
1434 by typing the D key.  Using the "Show changeset diff of revision at
1435 line" menu entry does the same thing.
1437 *** In VC Annotate mode, you can type v to toggle the annotation visibility.
1439 *** In VC Annotate mode, you can type f to show the file revision on
1440 the current line.
1442 *** Asynchronous VC commands display [Waiting...] in the mode-line
1443 of the corresponding buffer as long as the asynchronous process is
1444 active.
1446 *** Log entries can be modified using the key "e" in log-view.
1447 For now only CVS, RCS, SCCS and SVN support this functionality.
1448 This is done by the `modify-change-comment' backend function.
1450 *** In log-view-mode, for VC systems that support changesets, you can
1451 see the diff for the whole changeset (not only for the current file)
1452 by typing the D key or using the "Changeset Diff" menu entry.
1454 *** In Log Edit mode,  C-c C-d now shows the diff for the files involved.
1456 *** vc-git supports the "git grep" command.
1458 *** VC Support for Meta-CVS has been removed for lack of a maintainer able
1459 to update it to the new VC.
1461 ** Miscellaneous
1463 *** comint-mode uses `start-file-process' now (see Lisp Changes).
1464 If `default-directory' is a remote file name, subprocesses are started
1465 on the corresponding remote system.
1467 *** Eldoc highlights the function argument under point
1468 with the face `eldoc-highlight-function-argument'.
1470 *** In Etags, the --members option is now the default.
1471 Use --no-members if you want the old default behavior of not tagging
1472 struct members in C, members variables in C++ and variables in PHP.
1474 *** The `gdb' command only works with the graphical interface now.
1475 Use `gud-gdb' if you want the (old) text command mode.
1477 *** goto-address.el provides two new minor modes, goto-address-mode and
1478 goto-address-prog-mode, which buttonize URLS and email addresses.
1480 *** The new command `eshell/info' runs info in an eshell buffer.
1482 *** The new variable `ffap-rfc-directories' specifies a list of local
1483 directories in which `ffap-rfc' will first search for RFCs.
1485 *** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
1486 See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
1488 *** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
1490 *** Info displays breadcrumbs in the header of the page.
1491 See Info-breadcrumbs-depth to control it.
1493 *** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
1494 It is used to configure wireless interfaces.
1496 *** The pcmpl-unix package supports hostname completion for ssh and scp.
1498 *** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
1500 *** smerge-refine highlights word-level details of changes in conflict.
1501 It's used automatically as you move through conflicts, see
1502 smerge-auto-refine-mode.
1504 *** talk.el has been extended for multiple tty support.
1506 *** A new command `display-time-world' has been added to the Time
1507 package.  It creates a buffer with an updating time display using
1508 several time zones.
1510 *** The appearance of superscript and subscript in TeX is more customizable.
1511 See the documentation of the variables: tex-fontify-script,
1512 tex-font-script-display, tex-suscript-height-ratio, and
1513 tex-suscript-height-minimum.
1515 *** view-remove-frame-by-deleting is now by default t
1516 since users found iconification of view-mode frames distracting.
1518 *** WoMan tries to add locale-specific manual page directories to the
1519 search path.  This can be disabled by setting `woman-locale' to nil.
1522 * Changes in Emacs 23.1 on non-free operating systems
1524 ** Case is now considered significant in completion on MS-Windows.
1525 The default value of `completion-ignore-case' is now nil on
1526 MS-Windows, the same as it is for other operating systems.  The
1527 variable doesn't apply to reading a file name -- in that case Emacs
1528 heeds `read-file-name-completion-ignore-case' instead.
1530 ** IPv6 is supported on MS-Windows.
1531 Emacs now supports IPv6 on Windows XP and later, and earlier versions
1532 of Windows with third party IPv6 stacks installed.  In Emacs 22, IPv6 was
1533 supported on other platforms, but not on Windows due to using the winsock
1534 1.1 header file, even though Emacs was linking to the winsock 2 library.
1536 ** Busy cursor (hourglass) now displays on MS-Windows.
1537 When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
1538 In Emacs 22 only X supported the busy cursor.
1540 ** Battery status is available on MS-Windows
1541 Emacs can now display the battery status in the mode-line when enabled with
1542 display-battery-mode or from the Options menu.  More verbose battery
1543 information is also available with the command `battery'.  In Emacs 22
1544 battery status was supported only on GNU/Linux and Mac.
1546 ** More keys available on MS-Windows.
1547 Keys normally associated with IMEs, and some exotic keys not normally found
1548 on standard keyboards have been given names so they can be bound to functions
1549 inside Emacs.  If there are keys on your keyboard that have not been exposed
1550 to Emacs in the past, try C-h k to see if they are available now.
1552 Emacs can now bind functions to the extra buttons for media player and
1553 browser control present on some keyboards.  These buttons are disabled
1554 by default, since enabling them prevents their system-wide use when
1555 Emacs has focus.  To enable them, set the variable
1556 w32-pass-multimedia-buttons to nil.  See the doc string of that variable
1557 for the list of extra keys that are available.
1559 ** BDF fonts no longer supported on MS-Windows.
1560 The font backend was completely rewritten for this release.  The focus
1561 on Windows has been getting acceptable performance and full unicode
1562 support, including complex script shaping for native Windows fonts.  A
1563 rewrite of the BDF font support has not happened due to lack of time
1564 and developers.  If demand still exists for such a backend even with
1565 the improved language support for native Windows fonts, future
1566 development in this direction will most likely be based on the
1567 freetype library, giving access to a wider range of font formats.
1570 * Incompatible Lisp Changes in Emacs 23.1
1572 ** Variables cannot be both buffer-local and frame-local any more.
1574 ** `functionp' returns nil for special forms.
1575 I.e., it only returns t for objects that can be passed to `funcall'.
1577 ** The behavior of map-char-table has changed.  It may call the
1578 specified function with a cons (FROM . TO) as a key if characters in
1579 that range have the same value.
1581 ** Process changes
1583 *** The function `dired-call-process' has been removed.
1585 *** The multibyteness of process filters is now determined by the
1586 coding-system used for decoding.  The functions
1587 `process-filter-multibyte-p' and `set-process-filter-multibyte' are
1588 obsolete.
1590 ** The variable `byte-compile-warnings' can now be a list starting with `not',
1591 meaning to disable the specified warnings.  The meaning of this list
1592 may therefore be the reverse of what you expect (of course, this is
1593 only an issue if you make use of the new `not' syntax).  Rather than
1594 checking/manipulating elements directly, use the new functions
1595 `byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
1596 `byte-compile-enable-warning.'
1598 ** `mode-name' is no longer guaranteed to be a string.
1599 Use `(format-mode-line mode-name)' to ensure a string value.
1601 ** The function x-font-family-list has been removed.
1602 Use the new function font-family-list (see Lisp Changes, below).
1604 ** Internationalization changes
1606 *** The value of the function `charset-id' is now always 0.
1608 *** The functions `register-char-codings' and `coding-system-spec'
1609 have been removed.
1611 *** The cpXXX coding systems are now supported automatically.
1612 The functions cp-...-codepage, which you had to use in Emacs 22 to
1613 enable support for these coding systems, have been deleted.
1615 *** The following features have been removed.  They were used for
1616 displaying various scripts with specific fonts, and are no longer
1617 needed now that OpenType font support is available:
1619 **** `devanagari' and `devan-util', and all associated devanagari-* and
1620 dev-* functions and variables (formerly used for Devanagari script).
1622 **** `kannada' and `knd-util', and all associated kannada-* and knd-*
1623 functions and variables (formerly used for Kannada script).
1625 **** `malayalam' and `mlm-util', and all associated malayalam-* and
1626 mlm-* functions and variables (formerly used for Malayalam script).
1628 **** `tamil' and `tml-util, and all associated tamil-* and tml-*
1629 functions and variables (formerly used for Tamil script).
1631 *** The meaning of NAME argument of `set-fontset-font' is changed.
1632 Previously nil is accepted as the default fontset.  Now, nil is for
1633 the fontset of the selected frame and t is for the default fontset.
1635 *** The meaning of FONTSET argument of `print-fontset' is changed.
1636 Now, nil is for the fontset of the selected frame and t is for the
1637 default fontset.
1639 ** If a function in write-region-annotate-functions returns with a
1640 different buffer current, Emacs no longer kills that buffer
1641 automatically.  This behavior existed in previous versions of Emacs,
1642 but was undocumented.  To kill a buffer after write-region, give the
1643 variable `write-region-post-annotation-function' a buffer-local value
1644 of `kill-buffer'.
1646 ** The variable temp-file-name-pattern has been removed.
1647 This variable was only used by call-process-region, which now uses
1648 temporary-file-directory instead.
1650 ** The COUNT and SYSTEM-FLAG arguments to define-abbrev have been
1651 removed.  The function now takes extra arguments for specifying
1652 arbitrary abbrev properties.
1654 ** end-of-defun-function is now guaranteed to work only when called
1655 from the start of a defun.  It must now leave point exactly at the end
1656 of defun, since `end-of-defun' now itself moves forward over
1657 whitespace after calling it.
1660 * Lisp Changes in Emacs 23.1
1662 ** The new variable `generate-autoload-cookie' controls the magic comment
1663 string used by `update-file-autoloads' to find autoloaded forms.  The
1664 variable `generated-autoload-file' similarly controls the name of the
1665 file where `update-file-autoloads' writes the calls to `autoload'.
1666 The default values are ";;;###autoload" and `loaddefs.el',
1667 respectively.
1669 ** New primitives `list-system-processes' and `process-attributes'
1670 let Lisp programs access the processes that are running on the local
1671 machine.  See the doc strings of these functions for more details.
1672 Not all platforms support accessing this information; on those that
1673 don't, these primitives will return nil.
1675 ** New variable `user-emacs-directory'.
1676 Use this instead of "~/.emacs.d".
1678 ** If a local hook function has a non-nil `permanent-local-hook'
1679 property, `kill-all-local-variables' does not remove it from the local
1680 value of the hook variable; it remains even if you change major modes.
1682 ** `frame-inherited-parameters' lets new frames inherit parameters from
1683 the selected frame.
1685 ** New keymap `input-decode-map' overrides like key-translation-map, but
1686 applies before function-key-map.  Also it is terminal-local contrary to
1687 key-translation-map.  Terminal-specific key-sequences are generally added to
1688 this map rather than to function-key-map now.
1690 ** `ignore-errors' is now a standard macro (does not require the CL package).
1692 ** `interprogram-paste-function' can now return one string or a list
1693 of strings.  In the latter case, Emacs puts the second and following
1694 strings on the kill ring.
1696 ** In `condition-case', a handler can specify "let the debugger run first".
1697 You do this by writing `debug' in the list of conditions to be handled,
1698 like this:
1700     (condition-case nil
1701         (foo bar)
1702       ((debug error) nil))
1704 ** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
1706 ** `beginning-of-defun-function' now takes one argument, the count given to
1707 `beginning-of-defun'.  (N.B. `end-of-defun-function' doesn't take any
1708 arguments.)
1710 ** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
1711 IDENTIFICATION specifies which part of the remote identifier has to be
1712 returned.  With CONNECTED passed non-nil, it is checked whether a
1713 remote connection has been established already.
1715 ** The new macro `declare-function' suppresses compiler warnings about
1716 undefined functions.
1718 ** Changes to interactive function handling
1720 *** The new interactive spec code ^ says to first call
1721 handle-shift-selection if shift-select-mode is non-nil, before reading
1722 the command arguments.  This is used for shift-selection (see above).
1724 *** Built-in functions can now have an interactive specification that
1725 is not a prompt string.  If the `intspec' parameter of a `DEFUN'
1726 starts with a `(', the string is evaluated as a Lisp form.
1728 *** The interactive-form of a function can be added post-facto via the
1729 `interactive-form' symbol property.  Mostly useful to add complex
1730 interactive forms to subroutines.
1732 ** Region changes
1734 *** Commands should use `use-region-p' to test whether there is
1735 an active region that they should operate on.
1737 *** `region-active-p' returns non-nil when Transient Mark mode is
1738 enabled and the mark is active.  Most commands that act specially on
1739 the active region in Transient Mark mode should use `use-region-p'
1740 instead of `region-active-p', because `use-region-p' obeys the new
1741 user option `use-empty-active-region' (see Editing Changes, above).
1743 *** If a command sets `transient-mark-mode' to (only . OLDVAL), that
1744 means to activate transient-mark-mode temporarily, until the next
1745 unshifted point motion command or mark deactivation.  Afterwards,
1746 reset transient-mark-mode to the value OLDVAL.  The values `only' and
1747 `identity', introduced in Emacs 22, are now deprecated.
1749 ** Emacs session information
1751 *** The new variables `before-init-time' and `after-init-time' record the
1752 value of `current-time' before and after Emacs loads the init files.
1754 *** The new function `emacs-uptime' returns the uptime of an Emacs instance.
1756 *** The new function `emacs-init-time' returns the duration of the
1757 Emacs initialization.
1759 ** Changes affecting display-buffer
1761 *** display-buffer tries to be smarter when splitting windows.
1762 The new option split-window-preferred-function lets you specify your own
1763 function to pop up new windows.  Its default value split-window-sensibly
1764 can split a window either vertically or horizontally, whichever seems
1765 more suitable in the current configuration.  You can tune the behavior
1766 of split-window-sensibly by customizing split-height-threshold and the
1767 new option split-width-threshold.  Both options now take the value nil
1768 to inhibit splitting in one direction.  Setting split-width-threshold to
1769 nil inhibits horizontal splitting and gets you the behavior of Emacs 22
1770 in this respect.  In any case, display-buffer may now split the largest
1771 window vertically even when it is not as wide as the containing frame.
1773 *** If pop-up-frames has the value `graphic-only', display-buffer only
1774 makes a separate frame on graphic displays.
1776 *** select-frame and set-frame-selected-window have a new optional
1777 argument NORECORD.  If non-nil, this will avoid messing with the order
1778 of recently selected windows and the buffer list.
1780 ** Window parameters can now be defined.
1781 These are analogous to frame parameters, but are associated with
1782 individual windows.
1784 *** The new functions window-parameters, window-parameter, and
1785 set-window-parameter are used to query and set window parameters.
1787 ** Minibuffer and completion changes
1789 *** A list of default values can be specified for the DEFAULT argument of
1790 functions `read-from-minibuffer', `read-string', `read-command',
1791 `read-variable', `read-buffer', `completing-read'.  Elements of this list
1792 are available for inserting into the minibuffer by typing `M-n'.
1793 For empty input these functions return the first element of this list.
1795 *** New function `read-regexp' uses the regexp history and some useful
1796 regexp defaults (string at point, last Isearch/replacement regexp/string)
1797 via M-n when reading a regexp in the minibuffer.
1799 *** minibuffer-local-must-match-filename-map is now named
1800 minibuffer-local-filename-must-match-map.
1802 *** The `require-match' argument to `completing-read' accepts the new
1803 values `confirm-only' and `confirm-after-completion'.
1805 ** Search and replacement changes
1807 *** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
1809 *** New function `match-substitute-replacement' returns the result of
1810 `replace-match' without actually using it in the buffer.
1812 *** The new variable `replace-search-function' determines the function
1813 to use for searching in query-replace and replace-string.  The
1814 function it specifies is called by `perform-replace' when its 4th
1815 argument is nil.
1817 *** The new variable `replace-re-search-function' determines the
1818 function to use for searching in `query-replace-regexp',
1819 `replace-regexp', `query-replace-regexp-eval', and
1820 `map-query-replace-regexp'.  The function it specifies is called by
1821 `perform-replace' when its 4th argument is non-nil.
1823 *** New keymap `search-map' bound to `M-s' provides global bindings
1824 for search related commands.
1826 *** New keymap `multi-query-replace-map' contains additonal keys bound
1827 to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
1829 *** The variable `inhibit-changing-match-data', if non-nil, prevents
1830 the search and match primitives from changing the match data.
1832 *** New functions `word-search-forward-lax' and `word-search-backward-lax'.
1833 These are like `word-search-forward and `word-search-backward', except
1834 that the end of the search string need not match a word boundary,
1835 unless it ends in whitespace.
1837 ** File handling changes
1839 *** set-file-modes is now interactive and can take the mode value in
1840 symbolic notation thanks to auxiliary functions.
1842 *** file-local-variables-alist stores an alist of file-local
1843 variables defined in the current buffer.
1845 ** Face-remapping
1847 *** Each face can be remapped to a different face definition using the
1848 variable `face-remapping-alist'.  This is an alist that maps faces to
1849 replacement definitions (which can be face names, lists of face names,
1850 or attribute/value plists.  If this variable is buffer-local, the
1851 remapping occurs only in that buffer.
1853 *** text-scale-mode remaps the default face to a larger or smaller
1854 size in the current buffer.  This feature is used by the Buffer Face
1855 menu and the new `C-x C-+', `C-x C--', and `C-x C-0' commands (see
1856 Editing Changes, above).
1858 *** New functions:
1860 **** `face-remap-add-relative' adds a face remapping entry to the
1861 current buffer.
1863 **** ``face-remap-remove-relative' removes a face remapping entry from
1864 the current buffer.
1866 **** `face-remap-reset-base' restores a face to its global definition.
1868 **** `face-remap-set-base' sets the base remapping of a face.
1870 ** Process changes
1872 *** The new function `start-file-process' is similar to `start-process',
1873 but obeys file handlers.  The file handler is chosen based on
1874 `default-directory'.  The functions `start-file-process-shell-command'
1875 and `process-file-shell-command' are also new; they call internally
1876 `start-file-process' and `process-file', respectively.
1878 *** The new function `process-lines' executes an external program and
1879 returns its output as a list of lines.
1881 ** Character code, representation, and charset changes.
1883 *** In multibyte buffers and strings, characters are represented by
1884 UTF-8 byte sequences.  The character code space is now 0x0..0x3FFFFF
1885 with no gap; code points 0x0..0x10FFFF are Unicode characters of the
1886 same code points, while code points 0x3FFF80..0x3FFFFF are raw 8-bit
1887 bytes.
1889 *** Generic characters no longer exist.
1891 *** The concept of a charset has changed.  A single character may
1892 belong to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
1893 unicode, iso-8859-1, iso-8859-3, etc).
1895 **** The dimension of a charset is now 1, 2, 3, or 4, and the size of
1896 each dimension is no longer limited to 94 or 96.
1898 **** A dynamic charset priority list is used to infer the charset of
1899 characters for display.
1901 *** The functions `split-char' and `make-char' now accept up to 4
1902 positional codes instead of just 2.
1904 *** The functions `encode-char' and `decode-char' now accept any character sets.
1906 *** The function `define-charset' now accepts a completely different
1907 form of arguments (old-style arguments still work).
1909 *** The value of the function `char-charset' depends on the current
1910 priorities of charsets.
1912 *** The function get-char-code-property now accepts many Unicode base
1913 character properties.  They are `name', `general-category',
1914 `canonical-combining-class', `bidi-class', `decomposition',
1915 `decimal-digit-value', `digit-value', `numeric-value', `mirrored',
1916 `old-name', `iso-10646-comment', `uppercase', `lowercase', and
1917 `titlecase'.
1919 *** The functions `modify-syntax-entry' and `modify-category-entry' now
1920 accept a cons of characters as the first argument, and modify all
1921 entries in that range of characters.
1923 *** Use of `translation-table-for-input' for character code unification
1924 is now obsolete, since Emacs 23.1 and later uses Unicode as basis for
1925 internal representation of characters.
1927 *** New functions:
1929 **** `characterp' returns t if and only if the argument is a character.
1930 This replaces `char-valid-p', which is now obsolete.
1932 **** `max-char' returns the maximum character code (currently #x3FFFFF).
1934 **** `define-charset-alias' defines an alias of a charset.
1936 **** `set-charset-priority' sets priorities of charsets.
1938 **** `charset-priority-list' returns a prioritized list of charsets.
1940 **** `unibyte-string' makes a unibyte string from bytes.
1942 **** `define-char-code-property' defines a character code property.
1944 **** `char-code-property-description' returns the description string of
1945 a character code property.
1947 *** New variables:
1949 **** `find-word-boundary-function-table' is a char-table of functions to
1950 search for a word boundary.
1952 **** `char-script-table' is a char-table of script names.
1954 **** `char-width-table' is a char-table of character widths.
1956 **** `print-charset-text-property' controls how to handle `charset' text
1957 property on printing a string.
1959 **** `printable-chars' is a char-table of printable characters.
1961 ** Code conversion changes
1963 *** The new function `define-coding-system' should be used to define a
1964 coding system instead of `make-coding-system' (which is now obsolete).
1966 *** The functions `encode-coding-region' and `decode-coding-region'
1967 have an optional 4th argument to specify where the result of
1968 conversion should go.
1970 *** The functions `encode-coding-string' and `decode-coding-string'
1971 have an optional 4th argument specifying a buffer to store the result
1972 of conversion.
1974 *** The new variable `inhibit-null-byte-detection' controls whether to
1975 consider text with null bytes as binary data.  By default, it is
1976 `nil', and Emacs uses `no-conversion' for any text containing null
1977 bytes.
1979 *** The functions `set-coding-priority' and `make-coding-system' are obsolete.
1981 *** New functions:
1983 **** `with-coding-priority' executes Lisp code using the specified
1984 coding system priority order.
1986 **** `check-coding-systems-region' checks if the text in the region is
1987 encodable by the specified coding systems.
1989 **** `coding-system-aliases' returns a list of aliases of a coding system.
1991 **** `coding-system-charset-list' returns a list of charsets supported
1992 by a coding system.
1994 **** `coding-system-priority-list' returns a list of coding systems
1995 ordered by their priorities.
1997 **** `set-coding-system-priority' sets priorities of coding systems.
1999 **** `coding-system-from-name' returns a coding system matching with
2000 the argument name.
2003 ** There is a new input method, Robin, different from Quail.
2004 It has three functionalities:
2005  i) a simple input method (converts an ASCII sequence into a string).
2006 ii) converts an existing buffer substring into another string
2007 iii) reverse conversion (each character produced by a
2008 robin rule can hold the original ASCII sequence as a char-code-property)
2010 *** The new function `robin-define-package' defines a Robin package.
2012 *** The new function `robin-modify-package' modifies an existing Robin package.
2014 *** The new function `robin-use-package' starts using a Robin package
2015 as an input method.
2017 *** The new function `string-to-unibyte' is like `string-as-unibyte'
2018 but signals an error if STRING contains a non-ASCII, non-eight-bit
2019 character.
2021 ** Changes related to the new font backend
2023 *** Which font backends to use can be specified by the X resource
2024 "FontBackend".  For instance, to use both X core fonts and Xft fonts:
2026 Emacs.FontBackend: x,xft
2028 If this resource is not set, Emacs tries to use all font backends
2029 available on your graphic device.
2031 *** New frame parameter `font-backend' specifies a list of
2032 font-backends supported by the frame's graphic device.  On X, they are
2033 currently `x' and `xft'.
2035 *** The function `set-fontset-font' now accepts a script name as the
2036 second argument, and has an optional 5th argument to control how to
2037 set the font.
2039 *** New functions:
2041 **** `fontp' checks if the argument is a font-spec or font-entity.
2043 **** `font-spec' creates a new font-spec object.
2045 **** `font-get' returns a font property value.
2047 **** `font-put' sets a font property value.
2049 **** `font-face-attributes' returns a plist of face attributes set by a font.
2051 **** `list-fonts' returns a list of font-entities matching a font spec.
2053 **** `find-font' returns the font-entity best matching the given font spec.
2055 **** `font-family-list' returns a list of family names of available fonts.
2057 **** `font-xlfd-name' returns an XLFD name of a given font spec, font
2058 entity, or font object.
2060 **** `clear-font-cache' clears all font caches.
2062 ** Changes related to multiple-terminal (multi-tty) support
2064 *** $TERM is now set to `dumb' for subprocesses.  If you want to know the
2065 $TERM inherited by Emacs you will have to look inside initial-environment.
2067 *** $DISPLAY is now dynamically inherited from the frame's `display'.
2069 *** The `window-system' variable is now frame-local.  The new
2070 `initial-window-system' variable contains the `window-system' value
2071 for the first frame.  `window-system' is also now a function that
2072 takes a frame argument.
2074 *** The `keyboard-translate-table' variable and the terminal and
2075 keyboard coding systems are now terminal-local.
2077 *** You can specify a terminal device (`tty' parameter) and a terminal
2078 type (`tty-type' parameter) to `make-terminal-frame'.
2080 *** The function `make-frame-on-display' now works during a tty
2081 session.
2083 *** A new `terminal' data type.
2084 The functions `get-device-terminal', `terminal-parameters',
2085 `terminal-parameter', `set-terminal-parameter' use this data type.
2087 *** Function key sequences are now mapped using `local-function-key-map',
2088 a new variable.  This inherits from the global variable function-key-map,
2089 which is not used directly any more.
2091 *** New hooks:
2093 **** before-hack-local-variables-hook is called after setting new
2094 variable file-local-variables-alist, and before actually applying the
2095 file-local variables.
2097 **** `suspend-tty-functions' and `resume-tty-functions' are called
2098 after a tty frame has been suspended or resumed, respectively.  The
2099 functions are called with the terminal id of the frame being
2100 suspended/resumed as a parameter.
2102 **** The special hook `delete-terminal-functions' is called before
2103 deleting a terminal.
2105 *** New functions:
2107 **** `delete-terminal'
2109 **** `suspend-tty'
2111 **** `resume-tty'.
2113 *** `initial-environment' holds the environment inherited from Emacs's parent.
2115 ** Redisplay changes
2117 *** For underlined characters, the distance between the underline and
2118 the baseline is controlled by a new variable, `underline-minimum-offset'.
2120 *** You can now pass the value of the `invisible' property to
2121 invisible-p to check whether it would cause the text to be invisible.
2122 This is convenient when checking invisibility of text with no buffer
2123 position (e.g. in before/after-strings).
2125 *** `clear-image-cache' can be told to flush only images of a specific file.
2127 *** `vertical-motion' can now be given a goal column.
2128 It now accepts a cons cell (COLS . LINES) in its first argument, which
2129 says to stop, where possible, at a pixel x-position equal to COLS
2130 times the default column width.
2132 *** redisplay-end-trigger-functions, set-window-redisplay-end-trigger,
2133 and window-redisplay-end-trigger are obsolete.  Use `jit-lock-register'
2134 instead.
2136 *** The new variables `wrap-prefix' and `line-prefix' specify display
2137 specs which are appended at display-time to every continuation line
2138 and non-continuation line, respectively.  In addition, Emacs
2139 recognizes the `wrap-prefix' and `line-prefix' text or overlay
2140 properties; these have the same effects as the variables of the same
2141 name, but take precedence.
2143 ** The Lisp interpreter now treats non-breaking space as whitespace.
2145 ** Miscellaneous new functions
2147 *** `apply-partially' performs a "curried" application of a function.
2149 *** `buffer-swap-text' swaps text between two buffers.  This can be
2150 useful for modes such as tar-mode, archive-mode, RMAIL.
2152 *** `combine-and-quote-strings' produces a single string from a list of strings
2153 sticking a separator string in between each pair, and quoting those
2154 strings that include the separator as their substring.  Useful for
2155 consing shell command lines from the individual arguments.
2157 *** `custom-note-var-changed' tells Custom to treat the change in a
2158 certain variable as having been made within Custom.
2160 *** `face-all-attributes' returns an alist describing all the basic
2161 attributes of a given face.
2163 *** `format-seconds' converts a number of seconds into a readable
2164 string of days, hours, etc.
2166 *** `image-refresh' refreshes all images associated with a given image
2167 specification.
2169 *** `locate-user-emacs-file' helps packages to select the appropriate
2170 place to save user-specific files.  It defaults to `user-emacs-directory'
2171 unless the file already exists at $HOME.
2173 *** `read-color' reads a color name using the minibuffer.
2175 *** `read-shell-command' does what its name says, with completion.  It
2176 uses the minibuffer-local-shell-command-map for that.
2178 *** `split-string-and-unquote' splits a string into a list of substrings
2179 on the boundaries of a given delimiter, and unquotes the substrings that
2180 are quoted.  Useful for taking apart shell commands.
2182 *** The two new functions `looking-at-p' and `string-match-p' can do
2183 the same matching as `looking-at' and `string-match' without changing
2184 the match data.
2186 *** The two new functions `make-serial-process' and
2187 `serial-process-configure' provide a Lisp interface to the new serial
2188 port support (see Emacs changes, above).
2190 ** Miscellaneous new variables
2192 *** `auto-save-include-big-deletions', if non-nil, means auto-save is
2193 not turned off automatically after a big deletion.
2195 *** `read-circle', if nil, disables the reading of recursive Lisp
2196 structures using the #N= and #N# syntax.
2198 *** `this-command-keys-shift-translated' is non-nil if the key
2199 sequence invoking the current command was found by shift-translation.
2201 *** `window-point-insertion-type' determines the insertion-type of the
2202 marker used for window-point.
2204 *** bookmark provides `bookmark-make-record-function' so special major
2205 modes like Info can teach bookmark.el how to save and restore the
2206 relevant data.
2208 *** `fill-forward-paragraph-function' specifies which function the
2209 filling code should use to find paragraph boundaries.
2212 * New Packages for Lisp Programming in Emacs 23.1
2214 ** The new package avl-tree.el deals with the AVL tree data structure.
2216 ** The new package check-declare.el verifies the accuracy of
2217 declare-function macros (see Lisp Changes, above).
2219 ** find-cmd.el can build `find' commands using lisp syntax.
2221 ** The package misearch.el has been added.  It allows Isearch to search
2222 through multiple buffers.  A variable `multi-isearch-next-buffer-function'
2223 defines the function to call to get the next buffer to search in the series
2224 of multiple buffers.  Top-level functions `multi-isearch-buffers',
2225 `multi-isearch-buffers-regexp', `multi-isearch-files' and
2226 `multi-isearch-files-regexp' accept a single argument that specifies
2227 a list of buffers/files to search for a string/regexp.
2229 ** The new major mode `special-mode' is intended as a parent for
2230 major modes such as those that set the "'mode-class 'special" property.
2233 ----------------------------------------------------------------------
2234 This file is part of GNU Emacs.
2236 GNU Emacs is free software: you can redistribute it and/or modify
2237 it under the terms of the GNU General Public License as published by
2238 the Free Software Foundation, either version 3 of the License, or
2239 (at your option) any later version.
2241 GNU Emacs is distributed in the hope that it will be useful,
2242 but WITHOUT ANY WARRANTY; without even the implied warranty of
2243 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
2244 GNU General Public License for more details.
2246 You should have received a copy of the GNU General Public License
2247 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
2250 Local variables:
2251 mode: outline
2252 paragraph-separate: "[  \f]*$"
2253 end:
2255 arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2