Use quit-restore-window to leave completions window.
[emacs.git] / etc / NEWS.23
blobaa8f47f2e2b3aa486718ca3f0b6bfbc4d1985e01
1 GNU Emacs NEWS -- history of user-visible changes.
3 Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
4 See the end of the file for license conditions.
6 Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
7 If possible, use M-x report-emacs-bug.
9 This file is about changes in Emacs version 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 * Installation Changes in Emacs 23.3
20 * Startup Changes in Emacs 23.3
22 * Changes in Emacs 23.3
24 ** The nextstep port can have different modifiers for the left and right
25 alt/option key by customizing the value for ns-right-alternate-modifier.
28 * Editing Changes in Emacs 23.3
31 * Changes in Specialized Modes and Packages in Emacs 23.3
33 ---
34 ** The appt-add command takes an optional argument for the warning time.
35 This can be used in place of the default appt-message-warning-time.
37 ** Obsolete packages
39 +++
40 *** lmenu.el and cl-compat.el are now obsolete.
43 * New Modes and Packages in Emacs 23.3
44 ** smie.el is a generic navigation and indentation engine.
45 It takes a simple BNF description of the grammar, and provides both
46 sexp-style navigation (jumping over begin..end pairs) as well as
47 indentation, which can be adjusted via ad-hoc indentation rules.
49 * Incompatible Lisp Changes in Emacs 23.3
52 * Lisp changes in Emacs 23.3
54 ** `e' and `pi' are now called `float-e' and `float-pi'.
55   The old names are obsolete.
56 ** The use of unintern without an obarray arg is declared obsolete.
57 ** The function `princ-list' is declared obsolete.
58 ** New function byte-to-string, like char-to-string but for bytes.
61 * Changes in Emacs 23.3 on non-free operating systems
64 * Installation Changes in Emacs 23.2
66 ** New configure options for Emacs developers.
67 These are not new features; only the configure flags are new.
69 *** --enable-profiling builds Emacs with profiling enabled.
70 This might not work on all platforms.
72 *** --enable-checking[=OPTIONS] builds emacs with extra runtime checks.
74 ** `make install' now consistently ignores umask, creating a
75 world-readable install.
77 ** Emacs compiles with Gconf support, if it is detected.
78 Use the configure option --without-gconf to disable this.
79 This is used by the `font-use-system-font' feature (see below).
81 * Startup Changes in Emacs 23.2
83 ** The command-line option -Q (--quick) also inhibits loading X resources.
84 However, if Emacs is compiled with the Lucid or Motif toolkit, X
85 resource settings for the graphical widgets are still applied.
86 On Windows, the -Q option causes Emacs to ignore Registry settings,
87 but environment variables set on the Registry are still honored.
89 *** The new variable `inhibit-x-resources' shows whether X resources
90 were loaded.
92 ** New command-line option -mm (--maximized) maximizes the initial frame.
94 * Changes in Emacs 23.2
96 ** The maximum size of buffers (and the largest fixnum) is doubled.
97 On typical 32bit systems, buffers can now be up to 512MB.
99 ** The default value of `trash-directory' is now nil.
100 This means that `move-file-to-trash' trashes files according to
101 freedesktop.org specifications, the same method used by the Gnome,
102 KDE, and XFCE desktops.  (This change has no effect on Windows, which
103 uses `system-move-file-to-trash' for trashing.)
105 ** The pointer now becomes invisible when typing.
106 Customize `make-pointer-invisible' to disable this feature.
108 ** Font changes
110 *** Emacs can use the system default monospaced font in Gnome.
111 To enable this feature, set `font-use-system-font' to non-nil (it is
112 nil by default).  If the system default changes, Emacs changes also.
113 This feature requires Gconf support, which is automatically included
114 at compile-time if configure detects the gconf libraries (you can
115 disable this with the configure option --without-gconf).
117 *** On X11, Emacs reacts to Xft changes made by configuration tools,
118 via the XSETTINGS mechanism.  This includes antialias, hinting,
119 hintstyle, RGBA, DPI and lcdfilter changes.
121 ** Killing a buffer with a running process now asks for confirmation.
122 To remove this query, remove `process-kill-buffer-query-function' from
123 `kill-buffer-query-functions', or set the appropriate process flag
124 with `set-process-query-on-exit-flag'.
126 ** File-local variable changes
128 *** Specifying a minor mode as a local variables enables that mode,
129 unconditionally.  The previous behavior, toggling the mode, was
130 neither reliable nor generally desirable.
132 *** There are new commands for adding and removing file-local variables:
133 `add-file-local-variable', `delete-file-local-variable',
134 `add-file-local-variable-prop-line', and
135 `delete-file-local-variable-prop-line'.
137 *** There are new commands for adding and removing directory-local variables,
138 and copying them to and from file-local variable lists:
139 `add-dir-local-variable', `delete-dir-local-variable',
140 `copy-dir-locals-to-file-locals',
141 `copy-dir-locals-to-file-locals-prop-line' and
142 `copy-file-locals-to-dir-locals'.
144 ** Internationalization changes
146 *** Unibyte sessions are now considered obsolete.
147 This refers to the EMACS_UNIBYTE environment variable as well as the
148 --unibyte, --multibyte, --no-multibyte, and --no-unibyte command line
149 arguments.  Customizing enable-multibyte-characters and setting
150 default-enable-multibyte-characters are also deprecated.
152 *** New coding system `utf-8-hfs'.
153 This is suitable for default-file-name-coding-system on Mac OS X; see
154 international/ucs-normalize.el.
156 ** Function arguments in *Help* buffers are now shown in upper-case.
157 Customize `help-downcase-arguments' to t to show them in lower-case.
159 ** New command `async-shell-command', bound globally to `M-&'.
160 This executes the command asynchronously, similar to calling `M-!' and
161 manually adding an ampersand to the end of the command.  With `M-&',
162 you don't need the ampersand.  The output appears in the buffer
163 `*Async Shell Command*'.
165 ** When running in a new enough xterm (newer than version 242), Emacs
166 asks xterm what the background color is and it sets up faces
167 accordingly for a dark background if needed (the current default is to
168 consider the background light).
171 * Editing Changes in Emacs 23.2
173 ** Kill-ring and selection changes
175 *** If `select-active-regions' is t, any active region automatically
176 becomes the primary selection (for interaction with other window
177 applications).  If you enable this, you might want to bind
178 `mouse-yank-primary' to Mouse-2.
180 *** When `save-interprogram-paste-before-kill' is non-nil, the kill
181 commands save the interprogram-paste selection into the kill ring
182 before doing anything else.  This avoids losing the selection.
184 *** When `kill-do-not-save-duplicates' is non-nil, identical
185 subsequent kills are not duplicated in the `kill-ring'.
187 ** Completion changes
189 *** The new command `completion-at-point' provides mode-sensitive completion.
191 *** tab-always-indent set to `complete' lets TAB do completion as well.
193 *** The new completion-style `initials' is available.
194 For instance, this can complete M-x lch to list-command-history.
196 *** The new variable `completions-format' determines how completions
197 are displayed in the *Completions* buffer.  If you set it to
198 `vertical', completions are sorted vertically in columns.
200 ** The default value of `blink-matching-paren-distance' is increased.
202 ** M-n provides more default values in the minibuffer for commands
203 that read file names.  These include the file name at point (when ffap
204 is loaded without ffap-bindings), the file name on the current line
205 (in Dired buffers), and the directory names of adjacent Dired windows
206 (for Dired commands that operate on several directories, such as copy,
207 rename, or diff).
209 ** M-r is bound to the new `move-to-window-line-top-bottom'.
210 This moves point to the window center, top and bottom on successive
211 invocations, in the same spirit as the C-l (recenter-top-bottom)
212 command.
214 ** The new variable `recenter-positions' determines the default
215 cycling order of C-l (`recenter-top-bottom').
217 ** The abbrevs file is now a file named abbrev_defs in
218 user-emacs-directory; but the old location, ~/.abbrev_defs, is used if
219 that file exists.
222 * Changes in Specialized Modes and Packages in Emacs 23.2
224 ** The bookmark menu has a narrowing search via bookmark-bmenu-search.
226 ** Calc
228 *** The Calc settings file is now a file named calc.el in
229 user-emacs-directory; but the old location, ~/.calc.el, is used if
230 that file exists.
232 *** Graphing commands (`g f' etc.) now work on MS-Windows, if you have
233 the native Windows port of Gnuplot version 3.8 or later installed.
235 ** Calendar and diary
237 *** Fancy diary display is now the default.
238 If you prefer the simple display, customize `diary-display-function'.
240 *** The diary's fancy display now enables view-mode.
242 *** The command `calendar-current-date' accepts an optional argument
243 giving an offset from today.
245 ** Desktop
247 *** The default value for `desktop-buffers-not-to-save' is nil.
248 This means Desktop will try restoring all buffers, when you restart
249 your Emacs session.  Also, `desktop-buffers-not-to-save' is only
250 effective for buffers that have no associated file.  If you want to
251 exempt buffers that do correspond to files, customize the value of
252 `desktop-files-not-to-save' instead.
254 ** Dired
256 *** The new variable `dired-auto-revert-buffer', if non-nil, causes
257 Dired buffers to be reverted automatically on revisiting them.
259 ** DocView
261 *** When `doc-view-continuous' is non-nil, scrolling a line
262 on the page edge advances to the next/previous page.
264 ** Elint
266 *** Elint now uses compilation-mode.
268 *** Elint can now scan individual files and whole directories,
269 and can be run in batch mode.
271 *** Elint does a more thorough initialization, and recognizes more built-in
272 functions and variables.  Customize `elint-scan-preloaded' if you want
273 to sacrifice some accuracy for a faster startup.
275 *** Elint attempts some basic understanding of featurep and (f)boundp tests.
277 *** Customize `elint-ignored-warnings' to suppress some warnings.
279 ** GDB-UI
281 *** Toolbar functionality for reverse debugging.  Display of STL
282 collections as watch expressions.  These features require GDB 7.0 or later.
284 ** Grep
286 *** A new command `zrgrep' searches recursively in gzipped files.
288 ** Info
290 *** The new command `Info-virtual-index' bound to "I" displays a menu of
291 matched topics found in the index.
293 *** The new command `info-finder' replaces finder.el with a virtual Info
294 manual that generates an Info file which gives the same information
295 through a menu structure.
297 ** LaTeX mode now provides completion (via completion-at-point).
299 ** Message mode is now the default mode for composing mail.
301 The default for `mail-user-agent' is now message-user-agent, so the
302 C-x m (`compose-mail') command uses Message mode instead of Mail mode.
304 Message mode has been included in Emacs, as part of the Gnus package,
305 for several years.  It provides several features that are absent in
306 Mail mode, such as MIME handling.
308 *** If the user has not customized mail-user-agent, `compose-mail'
309 checks for Mail mode customizations, and issues a warning if these
310 customizations are found.  This alerts users who may otherwise be
311 unaware that their mail configuration has changed.
313 To disable this check, set compose-mail-user-agent-warnings to nil.
315 ** The default value of mail-interactive is t, since Emacs 23.1.
316 (This was not announced at the time.)  It means that when sending mail,
317 Emacs will wait for the process sending mail to return.  If you
318 experience delays when sending mail, you may wish to set this to nil.
320 ** nXML mode is now the default for editing XML files.
322 ** pcomplete provides a new command `pcomplete-std-completion' which
323 is similar to `pcomplete' but using the standard completion UI code.
325 ** Shell (and other comint modes)
327 *** M-s is no longer bound to `comint-next-matching-input'.
329 *** M-r is now bound to `comint-history-isearch-backward-regexp'.
330 This starts an incremental search of the comint/shell input history.
332 *** ansi-color is now enabled by default in Shell mode.
333 To disable it, set ansi-color-for-comint-mode to nil.
335 ** Tramp
337 *** New connection methods "rsyncc", "imap" and "imaps".
338 On systems which support GVFS-Fuse, Tramp offers also the new
339 connection methods "dav", "davs", "obex" and "synce".
341 ** VC and related modes
343 *** When using C-x v v or C-x v i on a unregistered file that is in a
344 directory not controlled by any VCS, ask the user what VC backend to
345 use to create a repository, create a new repository and register the
346 file.
348 *** New command `vc-root-print-log', bound to `C-x v L'.
349 This displays a `*vc-change-log*' buffer showing the history of the
350 version-controlled directory tree as a whole.
352 *** New command `vc-root-diff', bound to `C-x v D'.
353 This is similar to `vc-diff', but compares the entire directory tree
354 of the current VC directory with its working revision.
356 *** `C-x v l' and `C-x v L' do not show the full log by default.
357 The number of entries shown can be chosen interactively with a prefix
358 argument, or by customizing vc-log-show-limit.  The `*vc-change-log*'
359 buffer now contains buttons at the end of the buffer, which can be
360 used to increase the number of entries shown.  RCS, SCCS, and CVS do
361 not support this feature.
363 *** vc-annotate supports annotations through file copies and renames,
364 it displays the old names for the files and it can show logs/diffs for
365 the corresponding lines.  Currently only Git and Mercurial take
366 advantage of this feature.
368 *** The log command in vc-annotate can display a single log entry
369 instead of redisplaying the full log.  The RCS, CVS and SCCS VC
370 backends do not support this.
372 *** When a file is not found, VC will not try to check it out of RCS anymore.
374 *** Diff and log operations can be used from Dired buffers.
376 *** vc-git changes
378 **** The short log format for git makes use of the graph display,
379 so it's not supported on git versions earlier than 1.5.6.
381 **** vc-dir uses the --relative option of git, and so requires at least
382 git version 1.5.5.
384 **** Support for operating with stashes has been added to vc-dir:
385 the stash list is displayed in the *vc-dir* header, stashes can be
386 created, removed, applied and their content displayed.
388 *** vc-bzr supports operating with shelves: the shelve list is
389 displayed in the *vc-dir* header, shelves can be created, removed and applied.
391 *** log-edit-strip-single-file-name controls whether or not single filenames
392 are stripped when copying text from the ChangeLog to the *VC-Log* buffer.
394 ** Miscellaneous
396 *** Interactively `multi-isearch-buffers' and `multi-isearch-buffers-regexp'
397 read buffer names to search, one by one, ended with RET.  With a prefix
398 argument, they ask for a regexp, and search in buffers whose names match
399 the specified regexp.  Interactively `multi-isearch-files' and
400 `multi-isearch-files-regexp' read file names to search, one by one,
401 ended with RET.  With a prefix argument, they ask for a wildcard, and
402 search in file buffers whose file names match the specified wildcard.
404 *** Autorevert Tail mode now works also for remote files.
406 *** The new eshell built-in commands `su' and `sudo' support Tramp.
407 Thus, they change `default-directory' to reflect the new user id, and
408 let commands run under that user's permissions.  This works even when
409 `default-directory' is already remote.  Calling the external commands
410 is possible via `*su' or `*sudo', respectively.
412 ** Obsolete packages
414 *** sym-comp.el is now obsolete, superseded by completion-at-point.
416 *** lucid.el and levents.el are now obsolete.
419 * New Modes and Packages in Emacs 23.2
421 ** CEDET (the Collection of Emacs Development Tools) is now in Emacs.
422 This is a collection of packages to aid with using Emacs as an IDE
423 (integrated development environment):
425 *** The Semantic package allows the use of parsers to intelligently
426 edit and navigate source code.  Parsers for C/C++, Java, Javascript,
427 and several other languages are included by default, and Semantic can
428 also interface with external tools such as GNU Global and GNU Idutils.
430 To enable Semantic, use the global minor mode `semantic-mode'.
431 See the Semantic manual for details.
433 *** EDE (Emacs Development Environment) is a package for managing code
434 projects, including features such as automatic Makefile generation.
436 To enable EDE, use the minor mode `global-ede-mode'.
437 See the EDE manual for details.
439 *** SRecode is a library for recoding Semantic tags back into source
440 code.  It is currently used by some parts of Semantic and EDE; in the
441 future, it may be used for code generation features.
443 *** The EIEIO library implements a subset of the Common Lisp Object
444 System (CLOS).  It is used by the other CEDET packages.
446 ** mpc.el is a front end for the Music Player Daemon.  Run it with M-x mpc.
448 ** htmlfontify.el turns a fontified Emacs buffer into an HTML page.
450 ** js.el is a new major mode for JavaScript files.
452 ** imap-hash.el is a new library to address IMAP mailboxes as hashtables.
455 * Incompatible Lisp Changes in Emacs 23.2
457 ** The Lisp reader turns integers that are too large/small into floats.
458 For instance, on machines where `536870911' is the largest integer,
459 reading `536870912' gives the floating-point object `536870912.0'.
461 This change only concerns the Lisp reader; it does not affect how
462 actual integer objects overflow.
464 ** Several obsolete functions removed.
465 The functions have been obsolete since Emacs 19, and are unlikely to
466 be in use:
468   time-stamp-month-dd-yyyy, time-stamp-dd/mm/yyyy, time-stamp-mon-dd-yyyy
469   time-stamp-dd-mon-yy, time-stamp-yy/mm/dd, time-stamp-yyyy/mm/dd,
470   time-stamp-yyyy-mm-dd, time-stamp-yymmdd, time-stamp-hh:mm:ss,
471   time-stamp-hhmm, baud-rate
473 ** Support for generating Emacs 18 compatible bytecode (by setting
474 the variable `byte-compile-compatibility') has been removed.
476 ** In image-mode.el `image-mode-maybe' is obsolete.
477 Instead, you can either use `image-mode' (which displays an image file
478 as the actual image initially), or `image-mode-as-text' (when you want
479 to display an image file as text initially).  `image-mode-as-text' is a
480 combination of a non-image mode from `auto-mode-alist' (or Fundamental
481 mode) and `image-minor-mode'.  `image-minor-mode' provides a `C-c C-c'
482 key binding to toggle image display.
483 `image-toggle-display-text' removes image properties.
484 `image-toggle-display-image' adds image properties.
485 `image-toggle-display' toggles between `image-mode-as-text' and `image-mode'.
488 * Lisp changes in Emacs 23.2
490 ** All the default-FOO variables that hold the default value of the FOO
491 variable, are now declared obsolete.
493 ** read-key is a function halfway between read-event and read-key-sequence.
494 It reads a single key, but obeys input and escape sequence decoding.
496 ** Frame parameter changes
498 *** You can give the `fullscreen' frame parameter the value `maximized'.
499 This maximizes the frame.
501 *** The new frame parameter `sticky' makes Emacs frames sticky in
502 virtual desktops.
504 ** Completion changes
506 *** completion-base-size is obsoleted by completion-base-position.
507 This change causes a few backward incompatibilities, mostly with
508 choose-completion-string-functions where the `mini-p' argument has
509 been replaced by a `base-position' argument, and where the `base-size'
510 argument is now always nil.
512 *** New function `completion-in-region' to use the standard completion
513 facilities on a particular region of text.
515 *** The 4th arg to all-completions (aka hide-spaces) is declared obsolete.
517 *** completion-annotate-function specifies how to compute annotations
518 for completions displayed in *Completions*.
520 ** Minibuffer changes
522 *** read-file-name-predicate is obsolete.  It was used to pass the predicate
523 to read-file-name-internal because read-file-name-internal abused its `pred'
524 argument to pass the current directory, but this hack is not needed
525 any more.
527 ** Changes to file-manipulation functions
529 *** `delete-directory' has an optional parameter RECURSIVE.
531 *** New function `copy-directory', which copies a directory recursively.
533 ** called-interactively-p now takes one argument and replaces interactive-p
534 which is now marked obsolete.
536 ** New function set-advertised-calling-convention makes it possible
537 to obsolete arguments as well as make some arguments mandatory.
539 ** You can control which binding is preferentially shown in menus and
540 docstrings by adding a `:advertised-binding' property to the corresponding
541 command's symbol.  That property can hold a single binding or a list
542 of bindings.
544 ** Network and process changes
546 *** start-process-shell-command and start-file-process-shell-command
547 now only take a single `command' argument.
549 *** The new variable `process-file-side-effects' should be set to nil
550 if a `process-file' call does not change a remote file.  This allows
551 file name handlers such as Tramp to optimizations.
553 *** make-network-process can now also create `seqpacket' Unix sockets.
555 ** Loading changes
557 *** eval-next-after-load is obsolete.
559 *** New hook `after-load-functions' run after loading an Elisp file.
561 ** Byte compilation changes
563 *** Changing the file-names generated by byte-compilation by redefining
564 the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
565 Instead, customize byte-compile-dest-file-function.
567 *** `byte-compile-warnings' has new members, `constants' and `suspicious'.
569 ** New macro with-silent-modifications to tweak text properties without
570 affecting the buffer's modification state.
572 ** Hash tables have a new printed representation that is readable.
573 The feature `hashtable-print-readable' identifies this new
574 functionality.
576 ** New functions for performing Unicode normalization:
577 ucs-normalize-NFD-region, ucs-normalize-NFD-string,
578 ucs-normalize-NFC-region, ucs-normalize-NFC-string,
579 ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,
580 ucs-normalize-NFKC-region, ucs-normalize-NFKC-string,
581 ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string,
582 ucs-normalize-HFS-NFC-region, ucs-normalize-HFS-NFC-string.
584 ** Face aliases can now be marked as obsolete, using the macro
585 `define-obsolete-face-alias'.
587 ** New function `window-full-height-p', analogous to the full-width version.
590 * Changes in Emacs 23.2 on non-free operating systems
592 ** On MS-Windows, `display-time' now displays the system load average
593 as well as the time, as it does on GNU and Unix.
596 * Installation Changes in Emacs 23.1
598 ** The default X toolkit is now Gtk+, rather than Lucid.
599 The configure option `--with-gtk' has been removed.  Gtk is now the
600 default toolkit, but you can use --with-x-toolkit=gtk if necessary.
602 ** New font code.
603 Fonts are handled by new code capable of dealing with multiple font
604 backends.  This uses the freetype and fontconfig libraries.
606 *** Emacs now accepts font names supplied in the fontconfig format
607 (e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
609 *** Added support for local fonts (fonts installed on the machine
610 where Emacs is running).
612 *** Added support for the Xft library for antialiasing.
614 *** Added support for the otf library for complex text layout by
615 OpenType fonts.
617 *** Added support for the m17n library for text shaping.
619 ** Changes to image support
621 *** configure now checks for libgif before libungif when searching for
622 a GIF library.
624 *** Emacs now supports the SVG image format through librsvg2.
626 *** Emacs now supports multi-page TIFF images.
628 ** New NeXTSTEP-based port.
629 This provides support for GNUstep (via the GNUstep libraries) and Mac
630 OS X (via the Cocoa libraries).
632 Specify --with-ns to configure for this.  By default, a self-contained
633 app will be built (containing all lisp).  To install/share lisp with
634 other emacsen (e.g. X11 build) use --disable-ns-self-contained.  See
635 nextstep/README and nextstep/INSTALL in the Emacs source directory.
637 ** Mac OS X is no longer supported via Carbon.
638 Use the NeXTSTEP port, described above.
640 ** The new configuration option "--with-dbus" enables D-Bus language
641 bindings for Emacs.
643 ** Support for many obsolete platforms has been removed.
644 See the list at the end of etc/MACHINES for details.
646 *** Support for systems without alloca has been removed.
648 *** Support for Sun windows has been removed.
650 *** The `emacstool' utility has been removed.
652 ** The following platforms will be removed in a future Emacs version:
653 If you are still using Emacs on one of these platforms, please email
654 emacs-devel@gnu.org to inform the Emacs developers.
656 *** Old GNU/Linux systems based on libc version 5.
658 *** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
659 executable format.
661 *** Solaris versions 2.6 and below.
663 *** Solaris on IBM RS6000 machines.
665 *** UNIX System V (the original SysV, not later platforms based on it).
667 *** Unixware on non-x86 machines.
669 *** Platforms not supporting shared libraries (i.e., requiring the
670 NO_SHARED_LIBS compilation flag).
672 ** The configure options `--with-gcc', `--without-gcc' have been removed.
673 Configure will use gcc by default.  Set the CC environment variable if
674 you need control over which C compiler is used.
676 ** The refcards are now shipped as PDF files.
678 ** The manuals are now licensed under the GNU Free Documentation License v1.3,
679 or any later version.
681 ** Emacs 23 comes with a new set of default icons.
682 Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
683 The Emacs 22 icon is available as `emacs22.png' in the same location.
685 * Changes in Emacs 23.1
687 ** Improved X Window System support
689 *** Emacs now supports using both X displays and ttys in one session.
690 With an Emacs server active (M-x server-start), `emacsclient -t'
691 creates a tty frame connected to the running emacs server.  You can
692 use any number of different ttys.  `emacsclient -c' creates a new X11
693 frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
694 There may be problems if a display exits unexpectedly and Emacs is compiled
695 with Gtk+, see etc/PROBLEMS.
697 You can test for the presence of this feature in your Lisp code by
698 testing for the `multi-tty' feature.
700 *** Emacs starts in the background, as a daemon, when given the
701 --daemon command line argument.  It disconnects from the terminal and
702 starts the server.  Clients can connect and create graphical or
703 terminal frames using emacsclient.
705 **** emacsclient starts emacs in daemon mode and connects to it when
706 --alternate-editor="" is used (or when the evironment variable
707 ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an
708 emacs server.
710 *** The new command close-display-connection closes a connection to a
711 remote display.  There are some bugs for Gtk+.  See etc/PROBLEMS.
713 *** Emacs now supports the XEmbed specification.
714 You can embed Emacs in another application on X11.  The new command line
715 option --parent-id is used to pass the parent window id to Emacs.  See
716 http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
717 for details about XEmbed.
719 *** Emacs can now set the frame opacity.
720 The opacity of a frame can be controlled by setting the `alpha' frame
721 parameter.  This only takes effect on a compositing window manager for
722 the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac
723 OS X, or on Windows 2000 and later versions of Windows.
725 The alpha parameter should be an integer between 0 (transparent) and
726 100 (opaque), or a float number between 0.0 and 1.0.  It can also be a
727 cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
728 active frame and INACTIVE is the opacity of non-active frames.
730 The variable `frame-alpha-lower-limit' defines a lower bound for the
731 opacity; the default is 20.
733 ** Internationalization changes
735 *** The Emacs character set is now a superset of Unicode.
736 (It has about four times the code space, which should be plenty).
738 The internal encoding used for buffers and strings is now
739 Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias
740 for this).  This encoding is backward-compatible with Unicode's UTF-8
741 encoding.  The internal encoding previously used by Emacs,
742 `emacs-mule', is still available for reading and writing files.
744 During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
745 As a result, byte-compiled files containing non-ASCII characters can't
746 be read by earlier versions of Emacs.  Files compiled by Emacs 20, 21,
747 or 22 are loaded correctly as `emacs-mule' (whether or not they
748 contain multibyte characters).  This takes somewhat more time, so it
749 may be worth recompiling existing .elc files which don't need to be
750 shared with older Emacsen.
752 *** There are new coding systems/aliases; see M-x list-coding-systems.
754 *** There is a new charset implementation with many new charsets.
755 See M-x list-character-sets.  New charsets can be defined conveniently
756 as tables of unicodes.
758 *** There are new language environments for Chinese-GBK,
759 Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
760 Sinhala, and TaiViet.
762 *** The minor modes unify-8859-on-encoding-mode and
763 unify-8859-on-decoding-mode are obsolete.
765 *** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
766 accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
767 decimal).  It also accepts Unicode character names with completion.
769 *** The `cyrillic-translit' input method supports many new characters.
770 Common typographical characters available from Unicode were added to
771 `cyrillic-translit': punctuation marks, accented characters, fractions,
772 and others.
774 ** Emacs now supports serial port access on GNU/Linux, Unix, and
775 Windows.  The new command `serial-term' starts an interactive terminal
776 on a serial port.  The serial port can be configured at runtime with
777 the mode-line mouse menu.
779 ** Menu Bar changes
781 *** In the Options menu, the "Set Default Font" item applies the
782 selected font to the `default' face on all frames, not just the
783 current frame.  Furthermore, if Emacs is compiled with both GTK and
784 Fontconfig support, the "Set Default Font" item uses the GTK font
785 selection dialog instead of an Emacs pop-up menu.
787 *** The font setting chosen by "Set Default Font" is saved if the
788 "Save Options" item is used.
790 *** The Tools menu contains a new Encryption/Decryption submenu.
791 This contains commands provided by EasyPG, the newly-included
792 interface to GnuPG (see New Modes and Packages).
794 *** In the Options menu, the "Truncate Long Lines in the Buffer" entry
795 has been replaced with a submenu offering three different ways to
796 handle long lines: truncation, continuation at the window edge, and
797 the new word wrapping behavior (see Editing Changes, below).
799 *** Improvements to menus for major and minor modes
800 More major and minor modes now have a mode specific menu, and existing
801 mode menus have been improved to include more functionality.
803 ** Mode-line changes
805 *** The mode-line displays a `@', instead of `-', if the
806 default-directory for the current buffer is on a remote machine.
808 *** The mode-line displays a mode menu when mouse-1 is clicked on a
809 minor mode, in the same way as it already did for major modes.
811 *** The `mode-line-emphasis' face is used to highlight certain
812 mode-line information (e.g. waiting for a VC command to finish).
814 *** The mode-line tooltips have been improved to provide more details.
816 *** The VC, line/colum number and minor mode indicators on the mode
817 line are now interactive: mouse-1 can be used on them to pop up a menu.
819 ** File deletion can make use of the Recycle Bin or system Trash folder.
820 Set `delete-by-moving-to-trash' non-nil to use this.  Deleted files
821 and directories will then be sent to the Recycle Bin on Windows, and
822 to `trash-directory' on other systems.
824 ** Directory-local variables can now be defined.
825 By default, Emacs looks in .dir-locals.el for directory-local
826 variables.  For more information, see `dir-locals-set-directory-class'
827 and `dir-locals-set-class-variables'.
829 ** Emacs can now use `auth-source' for authentication.
830 `smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
831 login names and passwords.  The match, if found, is reported
832 in *Messages* with the password blanked out.
834 ** `where-is-preferred-modifier' can specify your favorite modifier.
837 * Startup Changes in Emacs 23.1
839 ** The option `inhibit-startup-screen' (with aliases to old names
840 `inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
841 display of the initial message in the *scratch* buffer.  If you don't
842 want to display the initial message in the *scratch* buffer at startup,
843 you can set the option `initial-scratch-message' to nil.
845 ** New user option `initial-buffer-choice' specifies what to display
846 after starting Emacs: startup screen, *scratch* buffer, visiting a
847 file or directory.
849 ** New alias `argv' for `command-line-args-left'
850 This is a convenience alias, so that one can write `(pop argv)'
851 inside of --eval command line arguments in order to access
852 following arguments.
854 ** The abbrev file is no longer read at startup in batch mode.
856 ** Emacs now supports invocation by an X session manager.
857 It can save a session and restore it later.  See the documentation of
858 the functions `emacs-session-save' and `emacs-session-restore'.
859 (Actually, this feature was introduced with Emacs 22, but it was not
860 documented.)
862 * Incompatible Editing Changes in Emacs 23.1
864 ** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
865 on the regexp command prefix map.
867 ** In Dired-x, all command guesses for ! are now added to the default
868 list accessible by M-n instead of pushing all guesses temporarily into
869 the history list.
871 ** In Isearch mode, a special case of typing `C-w' at the beginning of
872 the minibuffer that toggles word search (i.e. using key sequences
873 `C-s RET C-w' or `C-s M-e C-w') is obsolete.  You can use the global key
874 `M-s w' to start word search, or type `M-s w' in Isearch mode to
875 toggle word search.  To start nonincremental word search you can now use
876 `M-s w RET' and `M-s w C-r RET' instead of `C-s RET C-w' and `C-r RET C-w'.
878 ** In Info, `Info-search' is unbound from `M-s' to allow using `M-s w'
879 for word search as well as other search commands from the global prefix
880 key `M-s'.  `Info-search' is still bound to `s', and also incremental
881 search commands `C-s', `C-M-s', `C-r', `C-M-r' are available for searching
882 through multiple Info nodes, together with their nonincremental versions
883 `C-s RET', `C-r RET', `C-M-s RET', `C-M-r RET', `M-s w RET'.
885 ** In Text mode, `center-line' and `center-paragraph' are rebound from
886 `M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the global
887 prefix map `M-o', which is intended for such formatting commands.
889 ** The following input methods were removed in Emacs 22.2, but this was
890 not advertised: danish-alt-postfix, esperanto-alt-postfix,
891 finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
892 norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
893 and swedish-alt-postfix.  Use the versions without "alt-", which are
894 identical.
897 * Editing Changes in Emacs 23.1
899 ** The C-n and C-p line-motion commands now move by screen lines,
900 taking continued lines and variable-width characters into account.
901 Setting `line-move-visual' to nil reverts this to the previous
902 behavior (i.e., motion by logical lines based on buffer contents
903 alone).
905 ** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
906 invokes `suspend-frame'.  These changes are for compatibility with the
907 new multi-tty support (see `Improved X Window System support' above).
909 ** Mark changes
911 *** Transient Mark mode is now on by default.
913 *** mark-even-if-inactive now defaults to t
915 *** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
916 activating it.
918 *** When Transient Mark mode is on, M-q now fills the region if the
919 region is active.  Otherwise, it fills the current paragraph.
921 *** When Transient Mark mode is on, M-$ now checks spelling of the
922 region if the region is active.  Otherwise, it checks spelling of the
923 word at point.
925 *** When Transient Mark mode is on, TAB now indents the region if the
926 region is active.
928 *** The variable `use-empty-active-region' controls whether an empty
929 active region in Transient Mark mode should make commands operate on
930 that empty region.
932 ** Temporarily active regions
934 *** The new variable shift-select-mode, non-nil by default, controls
935 shift-selection.  When Shift Select mode is on, shift-translated
936 motion keys (e.g. S-left and S-down) activate and extend a temporary
937 region, similar to mouse-selection.
939 *** Temporarily active regions, created using shift-selection or
940 mouse-selection, are not necessarily deactivated in the next command.
941 They are only deactivated after point motion commands that are not
942 shift-translated, or after commands that would ordinarily deactivate
943 the mark in Transient Mark mode (e.g., any command that modifies the
944 buffer).
946 ** Minibuffer and completion changes
948 *** Emacs may ask for confirmation before opening a non-existent file
949 or buffer.  By default, Emacs requests confirmation if you type RET
950 immediately after TAB, and the resulting input is not an existing file
951 or buffer; this usually happens when the minibuffer input did not
952 complete far enough and you entered RET by mistake.  In that case,
953 Emacs puts the message "[Confirm]" in the minibuffer; type RET again
954 to create the file or buffer.
956 The new variable confirm-nonexistent-file-or-buffer determines whether
957 Emacs asks for confirmation.  The default value is `after-completion'.
958 If you change it to t, Emacs always asks for confirmation; if you
959 change it to nil, Emacs never asks for confirmation.
961 *** The rules for performing completion have been changed.
962 When generating completion alternatives, Emacs now takes the
963 minibuffer text after point, if any, into account: this text is
964 treated as a substring of the remaining part of the completion
965 alternative (i.e., the part not matched by the minibuffer text before
966 point).  If no completion alternatives are found this way, Emacs
967 attempts to perform partial-completion.  If still no completion
968 alternatives are found, we fall back on the Emacs 22 rules for
969 performing completion.
971 The new variable `completion-styles' can be customized to choose your
972 favorite completion style.
974 *** When M-n in the minibuffer reaches the end of the list of defaults,
975 it adds the completion list to the end, so next M-n continues putting
976 completion items to the minibuffer.  The same principle applies to
977 incremental search commands as well: C-s or C-M-s starts searching
978 the default values and after the end of defaults they continue
979 searching minibuffer completion items.
981 *** Minibuffer input of shell commands now comes with completion.
983 *** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
984 name of the current buffer.
986 *** In the M-! (shell-command) prompt, M-n provides some default commands.
987 These are guessed using the file extension of the current file, based
988 on the file-handlers specified in the operating system's `mailcap'
989 file.  The ! command in Dired (dired-do-shell-command) works
990 similarly, using the file displayed on the current line.
992 *** A list of regexp default values is available via M-n for `occur',
993 `keep-lines', `flush-lines' and `how-many'.  This list includes the active
994 region in transient-mark-mode, the word under the cursor, the last Isearch
995 regexp, the last Isearch string and the last replacement regexp.
997 *** When enable-recursive-minibuffers is non-nil, operations which use
998 switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
999 used in a minibuffer or a dedicated window.  Instead, they fallback on
1000 using pop-to-buffer, which will use some other window.  This change
1001 has no effect when enable-recursive-minibuffers is nil (the default).
1003 *** Isearch started in the minibuffer searches in the minibuffer history.
1004 Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer
1005 history elements, and forward Isearch commands (C-s, C-M-s) search in
1006 next history elements.  When the reverse search reaches the first history
1007 element, it wraps to the last history element, and the forward search
1008 wraps to the first history element.  When the search is terminated, the
1009 history element containing the search string becomes the current.
1011 *** The variable read-file-name-completion-ignore-case overrides
1012 completion-ignore-case for file name completion.
1014 *** The variable read-buffer-completion-ignore-case overrides
1015 completion-ignore-case for buffer name completion.
1017 *** The new command `minibuffer-force-complete' chooses one of the
1018 possible completions, rather than stopping at the common prefix.
1020 *** If `completion-auto-help' is `lazy', Emacs shows the completions
1021 buffer only on the second attempt to complete.  This was already
1022 supported in `partial-completion-mode'.
1024 ** Face changes
1026 *** S-down-mouse-1 now pops up a menu for changing the font and text
1027 size of the default face in the current buffer.  The face is changed
1028 via face remapping (see Lisp changes, below).
1030 *** New commands to change the default face size in the current buffer.
1031 To increase it, type `C-x C-+' or `C-x C-='.  To decrease it, type
1032 `C-x C--'.  To restore the default (global) face size, type `C-x C-0'.
1033 These work via Text Scale mode, a new minor mode.
1035 The final key in the above commands may be repeated without the
1036 leading `C-x', e.g. `C-x C-= C-= C-=' increases the face height by
1037 three steps.  Each step scales the height of the default face by the
1038 value of the variable `text-scale-mode-step'.
1040 *** The commands buffer-face-mode and buffer-face-set can be used to
1041 remap the default face in the current buffer.  See "Buffer Face mode",
1042 under New Modes and Packages.
1044 ** Primary selection changes
1046 *** You can disable kill ring commands from accessing the primary
1047 selection by setting `x-select-enable-primary' to nil.
1049 ** Continuation lines can now be wrapped at word boundaries
1050 (word-wrapping).  This is controlled by the new per-buffer variable
1051 `word-wrap'.  Word wrapping does not take place if continuation lines
1052 are not shown, e.g. if truncate-lines is non-nil.  The most convenient
1053 way to enable word-wrapping is using the new minor mode Visual Line
1054 mode; in addition to setting `word-wrap' to t, this rebinds some
1055 editing commands to work on screen lines rather than text lines.  See
1056 New Modes and Packages, below.
1058 ** Window management changes
1060 *** truncate-partial-width-windows now accepts integer values, which
1061 specify a minimum window width for partial-width windows, below which
1062 lines are truncated.  The default has been changed to 50.
1064 *** The new command balance-windows-area balances windows both
1065 vertically and horizontally.
1067 *** pop-to-buffer now always sets input focus when the popped-to window
1068 is on a different frame.
1070 ** Miscellaneous changes:
1072 *** C-l is bound to the new command recenter-top-bottom, rather than recenter.
1073 This moves the current line to window center, top and bottom on
1074 successive invocations.
1076 *** scroll-preserve-screen-position also preserves the column position.
1078 *** If `yank-pop-change-selection' is t, rotating the kill ring also
1079 updates the selection or clipboard to the current yank, just as M-w
1080 would do so with the text it copies to the kill ring.
1082 *** C-M-% now shows replacement as it would look in the buffer, with
1083 `\N' and `\&' substituted according to the match.  Old behavior can be
1084 restored by customizing `query-replace-show-replacement'.
1086 *** The command shell prompts for the default directory, when it is
1087 called with a prefix and the default directory is a remote file name.
1088 This is because some file name handlers (like ange-ftp) are not able to
1089 run processes remotely.
1091 *** The new command kill-matching-buffers kills buffers whose name
1092 matches a regexp.
1094 *** The value of comment-style now defaults to `indent'.
1095 Thefore, comment-start markers are inserted at the current indentation
1096 of the region to comment, rather than the leftmost column.
1098 *** The new commands `pp-macroexpand-expression' and
1099 `pp-macroexpand-last-sexp' pretty-print macro expansions.
1101 *** The new command `set-file-modes' allows to set file's mode bits.
1102 The mode bits can be specified in symbolic notation, like with GNU
1103 Coreutils, in addition to an octal number.  `chmod' is a new
1104 convenience alias for this function.
1106 *** `next-error-recenter' specifies how next-error should recenter the
1107 visited source file.  Its value can be a number (for example, 0 for
1108 top line, -1 for bottom line), or nil for no recentering.
1110 *** When typing in a password in the echo area, C-y yanks the current
1111 kill into the password.
1113 *** Tooltip frame parameters `font' and `color' in `tooltip-frame-parameters'
1114 are ignored.  Customize the `tooltip' face instead.
1116 *** `mkdir' is a new convenience alias for `make-directory'.
1118 * New Modes and Packages in Emacs 23.1
1120 ** Auto Composition Mode is a minor mode that composes characters
1121 automatically when they are displayed.  It is globally on by default.
1122 It uses `auto-composition-function' (default `auto-compose-chars').
1124 ** Bubbles, a new game, is similar to SameGame.
1126 ** Buffer Face mode is a minor mode for remapping the default face in
1127 the current buffer.  The variable `buffer-face-mode-face' specifies
1128 the face to remap to.  The command `buffer-face-set' prompts for a
1129 face name, sets `buffer-face-mode-face' to it, and enables
1130 buffer-face-mode.  See "Face changes", under Editing Changes, for a
1131 description of face remapping.
1133 ** butterfly flips the desired bit on the drive platter.
1134 See http://xkcd.com/378/
1136 ** bug-reference.el provides clickable links to bug reports.
1138 ** dbus.el provides D-Bus language bindings.
1139 D-Bus is an inter-process communication mechanism for applications
1140 residing on the same host.  See the manual for details.
1142 ** DocView mode allows viewing of PDF, PostScript and DVI documents.
1143 One can also search for a regular expression in the document.  For
1144 details, see the commentary in doc-view.el.
1146 PDF and DVI files are now opened in Doc View mode by default.
1148 In Postcript mode, C-c C-c launches Doc View minor mode for viewing
1149 the postscript file.
1151 ** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
1152 It includes a GnuPG keyring browser, cryptographic operations on
1153 regions and files, and automatic encryption of *.gpg files.  For
1154 details, see the EasyPG Assistant User's Manual.
1156 ** json.el is a library for parsing and generating JSON
1157 (JavaScript Object Notation), a lightweight data-interchange format.
1159 ** linum.el is a new minor mode to display line numbers for the
1160 current buffer.
1162 ** mairix.el is an interface to mairix, a free tool for indexing and
1163 searching locally stored mail.  It allows you to query mairix and
1164 display the search results with Rmail, Gnus and VM.  Note that there
1165 is an existing Gnus back end, nnmairix.el, which should be used with
1166 Maildir/MH setups.
1168 ** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
1170 ** nXML Mode
1171 This is a new mode for editing XML documents.  It allows a schema to
1172 be associated with the XML document being edited, using Relax NG as
1173 the schema language.  The schema is used to provide two key features:
1175 *** Continuous validation.  nXML validates as you type, highlighting
1176 any invalid parts of your document.
1178 *** Completion.  nXML can assist you in entering an element name,
1179 attribute name or data value by using information about what is
1180 allowed by the schema in that context.
1182 ** proced.el provides a Dired-like interface for operating on
1183 processes.  Proced makes an Emacs buffer containing a listing of the
1184 current processes.  You can use the normal Emacs commands to move
1185 around in this buffer, and special Proced commands to operate on the
1186 processes listed.  It is currently only functional on GNU/Linux,
1187 MS-Windows and Solaris.
1189 ** Remember Mode is a mode for jotting down things to remember.
1190 Notes can be saved to a Diary file.  For details, see the Remember
1191 Manual.
1193 ** RST mode is a major mode for editing reStructuredText files.
1195 ** Ruby mode is a major mode for Ruby files.
1197 ** Visual Line mode provides support for editing by visual lines.
1198 It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
1199 and C-k to commands that operate by visual lines instead of logical
1200 lines.  This is a more reliable replacement for longlines-mode.
1201 This can also be turned on using the menu bar, via
1202 Options -> Line Wrapping in this Buffer -> Word Wrap
1204 ** xesam.el is an implementation of Xesam, an interface to (desktop)
1205 search engines like Beagle, Strigi, and Tracker.  The Xesam API
1206 requires D-Bus for communication.
1208 ** zeroconf.el offers service discovery and service publishing
1209 interfaces according to the zeroconf specification.  It communicates
1210 with Avahi, a zeroconf implementation, via D-Bus messages on systems
1211 which have installed this software.
1213 ** There is a new `whitespace' package.
1214 (The pre-existing one has been renamed to `old-whitespace'.)
1215 Now, besides reporting bogus blanks, the whitespace package has a
1216 minor mode and a global minor mode to visualize blanks (TAB, (HARD)
1217 SPACE and NEWLINE).  The visualization is made via faces and/or display
1218 table.  It can also indicate lines that extend beyond a given column,
1219 trailing blanks, and empty lines at the start or end of a buffer.
1220 See `whitespace-style' for more details.  The `whitespace-action' option
1221 specifies what to do when a buffer is visited, killed, or written.
1224 * Changes in Specialized Modes and Packages in Emacs 23.1
1226 ** Abbrev has been rewritten in Elisp and extended with more flexibility.
1228 *** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
1229 abbrev-table-p, abbrev-insert, abbrev-table-menu.
1231 *** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
1233 *** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
1234 extra arguments for arbitrary properties.
1236 *** New variable `abbrev-minor-mode-table-alist'.
1238 *** `local-abbrev-table' can hold a list of abbrev-tables.
1240 *** Abbrevs have now the following special properties:
1241 `:count', `:system', `:enable-function', `:case-fixed'.
1243 *** Abbrev-tables have now the following special properties:
1244 `:parents', `:case-fixed', `:enable-function', `:regexp',
1245 `abbrev-table-modiff'.
1247 ** Apropos
1249 *** `apropos-library' describes the elements defined in a given library.
1251 *** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
1253 ** Archive Mode has basic support to browse Rar archives.
1254 Note, however, that the free version of the unrar command only handles
1255 versions 1 and 2 of the Rar format.
1257 ** BibTeX mode
1259 *** New command `bibtex-initialize' (re)initializes BibTeX buffers.
1261 *** New `bibtex-entry-format' options `whitespace', `braces', and
1262 `string', disabled by default.
1264 *** New variable `bibtex-cite-matcher-alist' contains rules to
1265 identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
1267 *** Command `bibtex-url' allows multiple URLs per entry.
1269 ** Bookmarks
1271 *** bookmark.el saves bookmarks in a pre-Emacs-23-incompatible file format
1272 bookmark.el can read a .emacs.bmk file saved by an older Emacs, but an
1273 older Emacs cannot read one saved by Emacs 23.
1275 ** Calendar and diary
1277 *** There is a new date style, `iso', essentially year/month/day.
1278 The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
1279 Similarly, the commands `american-calendar' and `european-calendar'
1280 should be replaced by `calendar-set-date-style'.
1282 *** The calendar namespace has been rationalized.
1283 All functions and variables now begin with a `calendar-', `diary-', or
1284 `holiday-' prefix.  The various calendar systems have secondary
1285 prefixes, eg `calendar-french-'.  The old names you are likely to use
1286 directly still exist, for the time being, as aliases, but please start
1287 using the new names.
1289 *** The whitespace in the calendar layout can be customized.
1290 See the variables:
1291 calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
1292 calendar-day-header-width, and calendar-day-digit-width.
1294 *** Text (e.g. ISO weeks) can be displayed between the calendar months.
1295 See the variables calendar-intermonth-header and calendar-intermonth-text.
1297 *** The function `holiday-chinese' computes holidays on the Chinese calendar.
1298 It has been used to add items to the list `holiday-oriental-holidays'.
1300 *** `diary-remind' accepts a negative number -DAYS as a shorthand for
1301 the list (1 2 ... DAYS).
1303 ** Change Log mode
1305 *** The new command C-c C-f (change-log-find-file) finds the file
1306 associated with the current log entry.
1308 *** The new command C-c C-c (change-log-goto-source) goes to the
1309 source code associated with a log entry.
1311 ** Compile and grep modes
1313 *** The mode-line entry for the *compilation* and *grep* buffer is color coded.
1314 It has different colors for to show that: (a) the command is still
1315 running, (b) successful completion, (c) error.
1317 *** compilation-auto-jump-to-first-error tells `compile' to jump to
1318 the first error encountered during compilations.
1320 *** compilation-scroll-output accepts a new value, `first-error', which
1321 says to stop auto scrolling at the first error that occurs.
1323 *** The `cc' alias for C++ files in `grep-file-aliases' has been
1324 improved.  `hh' can be used to match C++ header files and `cchh' both
1325 C++ sources and headers.
1327 ** Copyright
1329 *** You can specify your copyright holders' names.
1330 Only copyright lines with holders matching `copyright-names-regexp' are
1331 considered for update.
1333 *** Copyrights can be at the end of the buffer.
1334 This is controlled by `copyright-at-end-flag' (used by, e.g., change-log-mode).
1336 ** Custom
1338 *** defcustom accepts new keyword arguments, `:safe' and `:risky', which
1339 set a variable's `safe-local-variable' and `risky-local-variable' property.
1341 ** Diff mode
1343 *** diff-refine-hunk highlights word-level details of changes in a diff hunk.
1344 It's used automatically as you move through hunks, see
1345 diff-auto-refine-mode.  It is bound to `C-c C-b'.
1347 *** diff-add-change-log-entries-other-window iterates through the diff
1348 buffer and tries to create ChangeLog entries for each change.
1349 It is bound to `C-x 4 A'.
1351 *** Turning on `whitespace-mode' in a diff buffer will show trailing
1352 whitespace problems in the modified lines.
1354 ** Dired
1356 *** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
1357 and C-x C-q in wdired-mode exits it with asking a question about
1358 saving changes.
1360 *** `&' runs the command `dired-do-async-shell-command' that executes
1361 the command asynchronously without the need to manually add ampersand
1362 to the end of the command.  Its output appears in the buffer `*Async Shell
1363 Command*'.
1365 *** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names.
1366 When a new user option `dired-isearch-filenames' is t, then even ordinary
1367 Isearch started with `C-s' and `C-M-s' matches only at file names in the
1368 Dired buffer.  When `dired-isearch-filenames' is `dwim' then activation of
1369 file name Isearch depends on the position of point - if point is on a file
1370 name initially, then Isearch matches only file names, otherwise it matches
1371 everywhere in the Dired buffer.  You can toggle file names matching on or
1372 off by typing `M-s f' in Isearch mode.
1374 *** `M-s a C-s' and `M-s a M-C-s' run multi-file Isearch on the marked files.
1375 They visit the first marked file in the sequence and display the usual Isearch
1376 prompt for a string or a regexp where all Isearch commands are available.
1378 *** `Q' in Dired provides two new keys for multi-file replacement.
1379 The upper case key `Y' replaces all remaining matches in all remaining files
1380 with no more questions.  The upper case key `N' stops doing replacements
1381 in the current file and skips to the next file.  These multi-file keys
1382 are available for all commands that use `tags-query-replace'
1383 including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
1384 `reftex-query-replace-document'.
1386 ** Fortran
1388 *** The line length of fixed-form Fortran is not fixed at 72 any more.
1389 Customize the variable `fortran-line-length' to change it.
1391 *** In Fortran mode, M-; is now bound to the standard comment-dwim,
1392 rather than fortran-indent-comment.
1394 *** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
1396 ** Gnus
1398 *** The Gnus package has been updated
1399 There are many new features, bug fixes and improvements; see the file
1400 GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
1402 *** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
1403 saving articles, drafts, and ~/.newsrc.eld.  These file may not be read
1404 correctly in Emacs 22 and below.  If you want to Gnus across different Emacs
1405 versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
1407 *** Passwords are consistently loaded through `auth-source'
1408 Gnus can use `auth-source' for POP and IMAP passwords.  Also see that
1409 `smtpmail' and `url' support `auth-source' for SMTP and HTTP/HTTPS/RSS
1410 authentication respectively.
1412 ** Help mode
1414 *** New macro `with-help-window' should set up help windows better
1415 than `with-output-to-temp-buffer' with `print-help-return-message'.
1417 *** New option `help-window-select' permits to customize whether help
1418 window shall be automatically selected when invoking help.
1420 *** New variable `help-window-point-marker' permits one to specify a new
1421 position for point in help window (for example in `view-lossage').
1423 ** Isearch
1425 *** New command `isearch-forward-word' bound globally to `M-s w' starts
1426 incremental word search.  New command `isearch-toggle-word' bound to the
1427 same key `M-s w' in Isearch mode toggles word searching on or off
1428 while Isearch is active.
1430 *** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch
1431 mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current
1432 search string as its regexp argument.  The same key `M-s h r' and
1433 other keys on the `M-s h' prefix are bound globally to the command
1434 `highlight-regexp' and other hi-lock commands.
1436 *** New command `isearch-occur' bound to `M-s o' in Isearch mode
1437 runs `occur' with the current search string.  The same key `M-s o'
1438 is bound globally to the command `occur'.
1440 *** Isearch can now search through multiple ChangeLog files.
1441 When running Isearch in a ChangeLog file, if the search fails,
1442 then another C-s tries searching the previous ChangeLog,
1443 if there is one (e.g. going from ChangeLog to ChangeLog.12).
1444 This is enabled if multi-isearch-search is non-nil.
1446 *** Two new commands to start Isearch on a list of marked buffers
1447 for buff-menu.el and ibuffer.el are bound to the keys `M-s a C-s' and
1448 `M-s a M-C-s'.
1450 *** The part of an Isearch that failed to match is highlighted in
1451 `isearch-fail' face.
1453 *** `C-h C-h' in Isearch mode displays isearch-specific Help screen,
1454 `C-h b' displays all Isearch key bindings, `C-h k' displays the full
1455 documentation of the given Isearch key sequence, `C-h m' displays
1456 documentation for Isearch mode.  All the other Help commands exit
1457 Isearch mode and execute their global definitions.
1459 *** When started in the minibuffer, Isearch searches in the minibuffer
1460 history.  See `Minibuffer changes', above.
1462 ** MH-E
1464 *** Upgraded to MH-E version 8.2.  See MH-E-NEWS for details.
1466 ** Python
1467 *** The file etc/emacs.py now supports both Python 2 and 3, meaning
1468 that either version can be used as inferior Python by python.el.
1470 *** Python mode now has `pdbtrack' functionality.  When using pdb to
1471 debug a Python program, pdbtrack notices the pdb prompt and displays
1472 the source file and line that the program is stopped at, much the same
1473 way as gud-mode does for debugging C programs with gdb.
1475 ** Recentf
1477 *** The default value of `recentf-keep' prevents from checking of
1478 remote files, if there is no established connection to the
1479 corresponding remote host.
1481 ** Rmail
1483 *** Rmail no longer converts the messages to Babyl format.
1484 Instead, it uses UNIX mbox format, both on disk and in Rmail buffers,
1485 and does conversion and decoding when a message is displayed.
1487 The first time you visit an Rmail file in Babyl format, Rmail
1488 automatically converts it to mbox format.  This is a one-time
1489 conversion, but it can take a few minutes, depending on how fast is
1490 your machine and on the size of the file.  You should find the rest of
1491 Rmail usage unaltered.
1493 However, M-x set-rmail-inbox-list now lasts only for one session
1494 because there is no way to save the list of inbox files in an
1495 mbox-format file.
1497 Also, whereas with Babyl format M-x find-file would switch to Rmail
1498 mode, with mbox format this is no longer the case (there being no way
1499 to add an "-*- rmail-*-" cookie to an mbox file).  Use C-u M-x rmail
1500 instead.
1502 If you have written any extensions to Rmail, they are likely to need
1503 updating.  Conceptually, the Rmail buffer that you see is no longer
1504 just a narrowed portion of the whole.  So you cannot access the whole
1505 of a message (or message collection) by a simple save-restriction and
1506 widen.  Instead, there are two buffers: the rmail-buffer, and the
1507 rmail-view-buffer.  The former is the buffer that you see, the latter
1508 is invisible.  Most of the time, the invisible `view' buffer contains
1509 the full contents of the Rmail file, and the Rmail buffer contains a
1510 decoded copy of the current message (with only a subset of the
1511 headers).  In this state, Rmail is said to be `swapped'.
1513 You may find the following functions useful:
1515 `rmail-get-header' and `rmail-set-header' get or set the value of a
1516 message header, whether or not it is currently visible.
1518 `rmail-apply-in-message' is a general purpose function that calls a
1519 function (with arguments) which you specify on the full text of a given
1520 message.  To further narrow to just the headers, search forward for "\n\n".
1522 *** The new command `rmail-mime' displays MIME messages.
1523 It is bound to `v' in Rmail buffers and summaries.  It displays plain
1524 text and multipart messages in a temporary buffer, and offers buttons
1525 to save attachments.
1527 *** The command `rmail-redecode-body' no longer accepts the optional arg RAW.
1528 Since Rmail now holds messages in their original undecoded form in a
1529 separate buffer, `rmail-redecode-body' no longer encodes the original
1530 message, and therefore there should be no need to avoid encoding it.
1532 *** The o command is now `rmail-output'.  It is an all-purpose command
1533 for copying messages from Rmail and appending them to files.  It
1534 handles Babyl-format files as well as mbox-format files, and it
1535 handles both kinds properly when they are visited in Emacs.  It always
1536 copies the full headers of the message.
1538 *** The C-o command is now `rmail-output-as-seen'.  It uses
1539 the message as displayed, appending it to an mbox file.
1541 *** The modified status of the Rmail buffer is reported in the mode-line.
1542 Previously, this information was hidden.
1544 ** TeX modes
1546 *** New option latex-indent-within-escaped-parens
1547 permits to customize indentation of LaTeX environments delimited
1548 by escaped parens.
1550 ** T-mouse Mode
1552 *** If the gpm mouse server is running and t-mouse-mode is enabled,
1553 Emacs uses a Unix socket in a GNU/Linux console to talk to server,
1554 rather than faking events using the client program mev.  This C level
1555 approach provides mouse highlighting and help echoing in the
1556 minibuffer.
1558 ** Tramp
1560 *** New connection methods.
1561 The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
1562 been introduced.  There are also new so-called gateway methods
1563 "tunnel" and "socks".
1565 *** IPv6 addresses.
1566 IPv6 addresses are supported now as host names.  They must be embedded
1567 in square brackets, like in "/ssh:[::1]:".
1569 *** Multihop syntax has been removed.
1570 The pseudo-method "multi" has been removed.  Instead, multi hops
1571 can be specified by the new variable `tramp-default-proxies-alist'.
1573 *** More default settings.
1574 Default values can be set via the variables `tramp-default-user',
1575 `tramp-default-user-alist' and `tramp-default-host'.
1577 *** Connection information is cached.
1578 In order to reduce connection setup, information about used
1579 connections is kept persistently in a file.  The name of this file is
1580 defined in the variable `tramp-persistency-file-name'.
1582 *** Control of remote processes.
1583 Running processes on a remote host can be controlled by settings in
1584 `tramp-remote-path' and `tramp-remote-process-environment'.
1586 *** Success of remote copy is checked.
1587 When the variable `file-precious-flag' is set, the success of a remote
1588 file copy is checked via the file's checksum.
1590 *** Passwords can be read from an authentification file.
1591 Tramp uses the package `auth-source' to read passwords from a file, if
1592 necessary.
1594 ** VC and related modes
1596 *** VC now supports applying VC operations to a set of files at a time.
1597 This enables VC to work much more effectively with changeset-oriented
1598 version-control systems such as Subversion, GNU Arch, Mercurial, Git
1599 and Bzr.  VC will now pass a multiple-file commit to these systems as
1600 a single changeset.
1602 *** vc-dir is a new command that displays file names and their VC
1603 status.  It allows to apply various VC operations to a file, a
1604 directory or a set of files/directories.
1606 *** VC switches are no longer appended, rather the first non-nil value is used.
1607 (This was for the most part true in Emacs 22, but was not advertised).
1608 This is because there is an increasing variety of VC systems, and they
1609 do not all accept the same "common" options.  For example, a CVS diff
1610 command used to append the values of `vc-cvs-diff-switches',
1611 `vc-diff-switches', and `diff-switches'.  Now the first non-nil value
1612 from that sequence is used.  The special value `t' means "no switches".
1614 *** Clicking on the VC mode-line entry now pops the VC menu.
1616 *** The VC mode-line entry now has a tooltip that explains the VC file status.
1618 *** In VC Annotate mode, the key bindings have changed to use lower
1619 case keys instead of the upper case keys used in the past.
1621 *** In VC Annotate mode, for VC systems that support changesets, you can
1622 see the diff for the whole changeset (not only for the current file)
1623 by typing the D key.  Using the "Show changeset diff of revision at
1624 line" menu entry does the same thing.
1626 *** In VC Annotate mode, you can type v to toggle the annotation visibility.
1628 *** In VC Annotate mode, you can type f to show the file revision on
1629 the current line.
1631 *** Asynchronous VC commands display [Waiting...] in the mode-line
1632 of the corresponding buffer as long as the asynchronous process is
1633 active.
1635 *** Log entries can be modified using the key "e" in log-view.
1636 For now only CVS, RCS, SCCS and SVN support this functionality.
1637 This is done by the `modify-change-comment' backend function.
1639 *** In log-view-mode, for VC systems that support changesets, you can
1640 see the diff for the whole changeset (not only for the current file)
1641 by typing the D key or using the "Changeset Diff" menu entry.
1643 *** In Log Edit mode,  C-c C-d now shows the diff for the files involved.
1645 *** vc-git supports the "git grep" command.
1647 *** VC Support for Meta-CVS has been removed for lack of a maintainer able
1648 to update it to the new VC.
1650 ** Miscellaneous
1652 *** comint-mode uses `start-file-process' now (see Lisp Changes).
1653 If `default-directory' is a remote file name, subprocesses are started
1654 on the corresponding remote system.
1656 *** Eldoc highlights the function argument under point
1657 with the face `eldoc-highlight-function-argument'.
1659 *** In Etags, the --members option is now the default.
1660 Use --no-members if you want the old default behavior of not tagging
1661 struct members in C, members variables in C++ and variables in PHP.
1663 *** The `gdb' command only works with the graphical interface now.
1664 Use `gud-gdb' if you want the (old) text command mode.
1666 *** goto-address.el provides two new minor modes, goto-address-mode and
1667 goto-address-prog-mode, which buttonize URLS and email addresses.
1669 *** The new command `eshell/info' runs info in an eshell buffer.
1671 *** The new variable `ffap-rfc-directories' specifies a list of local
1672 directories in which `ffap-rfc' will first search for RFCs.
1674 *** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
1675 See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
1677 *** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
1679 *** Info displays breadcrumbs in the header of the page.
1680 See Info-breadcrumbs-depth to control it.
1682 *** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
1683 It is used to configure wireless interfaces.
1685 *** The pcmpl-unix package supports hostname completion for ssh and scp.
1687 *** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
1689 *** smerge-refine highlights word-level details of changes in conflict.
1690 It's used automatically as you move through conflicts, see
1691 smerge-auto-refine-mode.
1693 *** talk.el has been extended for multiple tty support.
1695 *** A new command `display-time-world' has been added to the Time
1696 package.  It creates a buffer with an updating time display using
1697 several time zones.
1699 *** The appearance of superscript and subscript in TeX is more customizable.
1700 See the documentation of the variables: tex-fontify-script,
1701 tex-font-script-display, tex-suscript-height-ratio, and
1702 tex-suscript-height-minimum.
1704 *** view-remove-frame-by-deleting is now by default t
1705 since users found iconification of view-mode frames distracting.
1707 *** WoMan tries to add locale-specific manual page directories to the
1708 search path.  This can be disabled by setting `woman-locale' to nil.
1711 * Changes in Emacs 23.1 on non-free operating systems
1713 ** Case is now considered significant in completion on MS-Windows.
1714 The default value of `completion-ignore-case' is now nil on
1715 MS-Windows, the same as it is for other operating systems.  The
1716 variable doesn't apply to reading a file name -- in that case Emacs
1717 heeds `read-file-name-completion-ignore-case' instead.
1719 ** IPv6 is supported on MS-Windows.
1720 Emacs now supports IPv6 on Windows XP and later, and earlier versions
1721 of Windows with third party IPv6 stacks installed.  In Emacs 22, IPv6 was
1722 supported on other platforms, but not on Windows due to using the winsock
1723 1.1 header file, even though Emacs was linking to the winsock 2 library.
1725 ** Busy cursor (hourglass) now displays on MS-Windows.
1726 When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
1727 In Emacs 22 only X supported the busy cursor.
1729 ** Battery status is available on MS-Windows
1730 Emacs can now display the battery status in the mode-line when enabled with
1731 display-battery-mode or from the Options menu.  More verbose battery
1732 information is also available with the command `battery'.  In Emacs 22
1733 battery status was supported only on GNU/Linux and Mac.
1735 ** More keys available on MS-Windows.
1736 Keys normally associated with IMEs, and some exotic keys not normally found
1737 on standard keyboards have been given names so they can be bound to functions
1738 inside Emacs.  If there are keys on your keyboard that have not been exposed
1739 to Emacs in the past, try C-h k to see if they are available now.
1741 Emacs can now bind functions to the extra buttons for media player and
1742 browser control present on some keyboards.  These buttons are disabled
1743 by default, since enabling them prevents their system-wide use when
1744 Emacs has focus.  To enable them, set the variable
1745 w32-pass-multimedia-buttons to nil.  See the doc string of that variable
1746 for the list of extra keys that are available.
1748 ** BDF fonts no longer supported on MS-Windows.
1749 The font backend was completely rewritten for this release.  The focus
1750 on Windows has been getting acceptable performance and full unicode
1751 support, including complex script shaping for native Windows fonts.  A
1752 rewrite of the BDF font support has not happened due to lack of time
1753 and developers.  If demand still exists for such a backend even with
1754 the improved language support for native Windows fonts, future
1755 development in this direction will most likely be based on the
1756 freetype library, giving access to a wider range of font formats.
1759 * Incompatible Lisp Changes in Emacs 23.1
1761 ** Variables cannot be both buffer-local and frame-local any more.
1763 ** `functionp' returns nil for special forms.
1764 I.e., it only returns t for objects that can be passed to `funcall'.
1766 ** The behavior of map-char-table has changed.  It may call the
1767 specified function with a cons (FROM . TO) as a key if characters in
1768 that range have the same value.
1770 ** Process changes
1772 *** The function `dired-call-process' has been removed.
1774 *** The multibyteness of process filters is now determined by the
1775 coding-system used for decoding.  The functions
1776 `process-filter-multibyte-p' and `set-process-filter-multibyte' are
1777 obsolete.
1779 ** The variable `byte-compile-warnings' can now be a list starting with `not',
1780 meaning to disable the specified warnings.  The meaning of this list
1781 may therefore be the reverse of what you expect (of course, this is
1782 only an issue if you make use of the new `not' syntax).  Rather than
1783 checking/manipulating elements directly, use the new functions
1784 `byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
1785 `byte-compile-enable-warning.'
1787 ** `mode-name' is no longer guaranteed to be a string.
1788 Use `(format-mode-line mode-name)' to ensure a string value.
1790 ** The function x-font-family-list has been removed.
1791 Use the new function font-family-list (see Lisp Changes, below).
1793 ** Internationalization changes
1795 *** The value of the function `charset-id' is now always 0.
1797 *** The functions `register-char-codings' and `coding-system-spec'
1798 have been removed.
1800 *** The cpXXX coding systems are now supported automatically.
1801 The functions cp-...-codepage, which you had to use in Emacs 22 to
1802 enable support for these coding systems, have been deleted.
1804 *** The following features have been removed.  They were used for
1805 displaying various scripts with specific fonts, and are no longer
1806 needed now that OpenType font support is available:
1808 **** `devanagari' and `devan-util', and all associated devanagari-* and
1809 dev-* functions and variables (formerly used for Devanagari script).
1811 **** `kannada' and `knd-util', and all associated kannada-* and knd-*
1812 functions and variables (formerly used for Kannada script).
1814 **** `malayalam' and `mlm-util', and all associated malayalam-* and
1815 mlm-* functions and variables (formerly used for Malayalam script).
1817 **** `tamil' and `tml-util, and all associated tamil-* and tml-*
1818 functions and variables (formerly used for Tamil script).
1820 *** The meaning of NAME argument of `set-fontset-font' is changed.
1821 Previously nil is accepted as the default fontset.  Now, nil is for
1822 the fontset of the selected frame and t is for the default fontset.
1824 *** The meaning of FONTSET argument of `print-fontset' is changed.
1825 Now, nil is for the fontset of the selected frame and t is for the
1826 default fontset.
1828 ** If a function in write-region-annotate-functions returns with a
1829 different buffer current, Emacs no longer kills that buffer
1830 automatically.  This behavior existed in previous versions of Emacs,
1831 but was undocumented.  To kill a buffer after write-region, give the
1832 variable `write-region-post-annotation-function' a buffer-local value
1833 of `kill-buffer'.
1835 ** The variable temp-file-name-pattern has been removed.
1836 This variable was only used by call-process-region, which now uses
1837 temporary-file-directory instead.
1839 ** The COUNT and SYSTEM-FLAG arguments to define-abbrev have been
1840 removed.  The function now takes extra arguments for specifying
1841 arbitrary abbrev properties.
1843 ** end-of-defun-function is now guaranteed to work only when called
1844 from the start of a defun.  It must now leave point exactly at the end
1845 of defun, since `end-of-defun' now itself moves forward over
1846 whitespace after calling it.
1849 * Lisp Changes in Emacs 23.1
1851 ** The new variable `generate-autoload-cookie' controls the magic comment
1852 string used by `update-file-autoloads' to find autoloaded forms.  The
1853 variable `generated-autoload-file' similarly controls the name of the
1854 file where `update-file-autoloads' writes the calls to `autoload'.
1855 The default values are ";;;###autoload" and `loaddefs.el',
1856 respectively.
1858 ** New primitives `list-system-processes' and `process-attributes'
1859 let Lisp programs access the processes that are running on the local
1860 machine.  See the doc strings of these functions for more details.
1861 Not all platforms support accessing this information; on those that
1862 don't, these primitives will return nil.
1864 ** New variable `user-emacs-directory'.
1865 Use this instead of "~/.emacs.d".
1867 ** If a local hook function has a non-nil `permanent-local-hook'
1868 property, `kill-all-local-variables' does not remove it from the local
1869 value of the hook variable; it remains even if you change major modes.
1871 ** `frame-inherited-parameters' lets new frames inherit parameters from
1872 the selected frame.
1874 ** New keymap `input-decode-map' overrides like key-translation-map, but
1875 applies before function-key-map.  Also it is terminal-local contrary to
1876 key-translation-map.  Terminal-specific key-sequences are generally added to
1877 this map rather than to function-key-map now.
1879 ** `ignore-errors' is now a standard macro (does not require the CL package).
1881 ** `interprogram-paste-function' can now return one string or a list
1882 of strings.  In the latter case, Emacs puts the second and following
1883 strings on the kill ring.
1885 ** In `condition-case', a handler can specify "let the debugger run first".
1886 You do this by writing `debug' in the list of conditions to be handled,
1887 like this:
1889     (condition-case nil
1890         (foo bar)
1891       ((debug error) nil))
1893 ** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
1895 ** `beginning-of-defun-function' now takes one argument, the count given to
1896 `beginning-of-defun'.  (N.B. `end-of-defun-function' doesn't take any
1897 arguments.)
1899 ** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
1900 IDENTIFICATION specifies which part of the remote identifier has to be
1901 returned.  With CONNECTED passed non-nil, it is checked whether a
1902 remote connection has been established already.
1904 ** The new macro `declare-function' suppresses compiler warnings about
1905 undefined functions.
1907 ** Changes to interactive function handling
1909 *** The new interactive spec code ^ says to first call
1910 handle-shift-selection if shift-select-mode is non-nil, before reading
1911 the command arguments.  This is used for shift-selection (see above).
1913 *** Built-in functions can now have an interactive specification that
1914 is not a prompt string.  If the `intspec' parameter of a `DEFUN'
1915 starts with a `(', the string is evaluated as a Lisp form.
1917 *** The interactive-form of a function can be added post-facto via the
1918 `interactive-form' symbol property.  Mostly useful to add complex
1919 interactive forms to subroutines.
1921 ** Region changes
1923 *** Commands should use `use-region-p' to test whether there is
1924 an active region that they should operate on.
1926 *** `region-active-p' returns non-nil when Transient Mark mode is
1927 enabled and the mark is active.  Most commands that act specially on
1928 the active region in Transient Mark mode should use `use-region-p'
1929 instead of `region-active-p', because `use-region-p' obeys the new
1930 user option `use-empty-active-region' (see Editing Changes, above).
1932 *** If a command sets `transient-mark-mode' to (only . OLDVAL), that
1933 means to activate transient-mark-mode temporarily, until the next
1934 unshifted point motion command or mark deactivation.  Afterwards,
1935 reset transient-mark-mode to the value OLDVAL.  The values `only' and
1936 `identity', introduced in Emacs 22, are now deprecated.
1938 ** Emacs session information
1940 *** The new variables `before-init-time' and `after-init-time' record the
1941 value of `current-time' before and after Emacs loads the init files.
1943 *** The new function `emacs-uptime' returns the uptime of an Emacs instance.
1945 *** The new function `emacs-init-time' returns the duration of the
1946 Emacs initialization.
1948 ** Changes affecting display-buffer
1950 *** display-buffer tries to be smarter when splitting windows.
1951 The new option split-window-preferred-function lets you specify your own
1952 function to pop up new windows.  Its default value split-window-sensibly
1953 can split a window either vertically or horizontally, whichever seems
1954 more suitable in the current configuration.  You can tune the behavior
1955 of split-window-sensibly by customizing split-height-threshold and the
1956 new option split-width-threshold.  Both options now take the value nil
1957 to inhibit splitting in one direction.  Setting split-width-threshold to
1958 nil inhibits horizontal splitting and gets you the behavior of Emacs 22
1959 in this respect.  In any case, display-buffer may now split the largest
1960 window vertically even when it is not as wide as the containing frame.
1962 *** If pop-up-frames has the value `graphic-only', display-buffer only
1963 makes a separate frame on graphic displays.
1965 *** select-frame and set-frame-selected-window have a new optional
1966 argument NORECORD.  If non-nil, this will avoid messing with the order
1967 of recently selected windows and the buffer list.
1969 ** Window parameters can now be defined.
1970 These are analogous to frame parameters, but are associated with
1971 individual windows.
1973 *** The new functions window-parameters, window-parameter, and
1974 set-window-parameter are used to query and set window parameters.
1976 ** Minibuffer and completion changes
1978 *** A list of default values can be specified for the DEFAULT argument of
1979 functions `read-from-minibuffer', `read-string', `read-command',
1980 `read-variable', `read-buffer', `completing-read'.  Elements of this list
1981 are available for inserting into the minibuffer by typing `M-n'.
1982 For empty input these functions return the first element of this list.
1984 *** New function `read-regexp' uses the regexp history and some useful
1985 regexp defaults (string at point, last Isearch/replacement regexp/string)
1986 via M-n when reading a regexp in the minibuffer.
1988 *** minibuffer-local-must-match-filename-map is now named
1989 minibuffer-local-filename-must-match-map.
1991 *** The `require-match' argument to `completing-read' accepts the new
1992 values `confirm-only' and `confirm-after-completion'.
1994 ** Search and replacement changes
1996 *** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
1998 *** New function `match-substitute-replacement' returns the result of
1999 `replace-match' without actually using it in the buffer.
2001 *** The new variable `replace-search-function' determines the function
2002 to use for searching in query-replace and replace-string.  The
2003 function it specifies is called by `perform-replace' when its 4th
2004 argument is nil.
2006 *** The new variable `replace-re-search-function' determines the
2007 function to use for searching in `query-replace-regexp',
2008 `replace-regexp', `query-replace-regexp-eval', and
2009 `map-query-replace-regexp'.  The function it specifies is called by
2010 `perform-replace' when its 4th argument is non-nil.
2012 *** New keymap `search-map' bound to `M-s' provides global bindings
2013 for search related commands.
2015 *** New keymap `multi-query-replace-map' contains additonal keys bound
2016 to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
2018 *** The variable `inhibit-changing-match-data', if non-nil, prevents
2019 the search and match primitives from changing the match data.
2021 *** New functions `word-search-forward-lax' and `word-search-backward-lax'.
2022 These are like `word-search-forward and `word-search-backward', except
2023 that the end of the search string need not match a word boundary,
2024 unless it ends in whitespace.
2026 ** File handling changes
2028 *** set-file-modes is now interactive and can take the mode value in
2029 symbolic notation thanks to auxiliary functions.
2031 *** file-local-variables-alist stores an alist of file-local
2032 variables defined in the current buffer.
2034 ** Face-remapping
2036 *** Each face can be remapped to a different face definition using the
2037 variable `face-remapping-alist'.  This is an alist that maps faces to
2038 replacement definitions (which can be face names, lists of face names,
2039 or attribute/value plists.  If this variable is buffer-local, the
2040 remapping occurs only in that buffer.
2042 *** text-scale-mode remaps the default face to a larger or smaller
2043 size in the current buffer.  This feature is used by the Buffer Face
2044 menu and the new `C-x C-+', `C-x C--', and `C-x C-0' commands (see
2045 Editing Changes, above).
2047 *** New functions:
2049 **** `face-remap-add-relative' adds a face remapping entry to the
2050 current buffer.
2052 **** ``face-remap-remove-relative' removes a face remapping entry from
2053 the current buffer.
2055 **** `face-remap-reset-base' restores a face to its global definition.
2057 **** `face-remap-set-base' sets the base remapping of a face.
2059 ** Process changes
2061 *** The new function `start-file-process' is similar to `start-process',
2062 but obeys file handlers.  The file handler is chosen based on
2063 `default-directory'.  The functions `start-file-process-shell-command'
2064 and `process-file-shell-command' are also new; they call internally
2065 `start-file-process' and `process-file', respectively.
2067 *** The new function `process-lines' executes an external program and
2068 returns its output as a list of lines.
2070 ** Character code, representation, and charset changes.
2072 *** In multibyte buffers and strings, characters are represented by
2073 UTF-8 byte sequences.  The character code space is now 0x0..0x3FFFFF
2074 with no gap; code points 0x0..0x10FFFF are Unicode characters of the
2075 same code points, while code points 0x3FFF80..0x3FFFFF are raw 8-bit
2076 bytes.
2078 *** Generic characters no longer exist.
2080 *** The concept of a charset has changed.  A single character may
2081 belong to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
2082 unicode, iso-8859-1, iso-8859-3, etc).
2084 **** The dimension of a charset is now 1, 2, 3, or 4, and the size of
2085 each dimension is no longer limited to 94 or 96.
2087 **** A dynamic charset priority list is used to infer the charset of
2088 characters for display.
2090 *** The functions `split-char' and `make-char' now accept up to 4
2091 positional codes instead of just 2.
2093 *** The functions `encode-char' and `decode-char' now accept any character sets.
2095 *** The function `define-charset' now accepts a completely different
2096 form of arguments (old-style arguments still work).
2098 *** The value of the function `char-charset' depends on the current
2099 priorities of charsets.
2101 *** The function get-char-code-property now accepts many Unicode base
2102 character properties.  They are `name', `general-category',
2103 `canonical-combining-class', `bidi-class', `decomposition',
2104 `decimal-digit-value', `digit-value', `numeric-value', `mirrored',
2105 `old-name', `iso-10646-comment', `uppercase', `lowercase', and
2106 `titlecase'.
2108 *** The functions `modify-syntax-entry' and `modify-category-entry' now
2109 accept a cons of characters as the first argument, and modify all
2110 entries in that range of characters.
2112 *** Use of `translation-table-for-input' for character code unification
2113 is now obsolete, since Emacs 23.1 and later uses Unicode as basis for
2114 internal representation of characters.
2116 *** New functions:
2118 **** `characterp' returns t if and only if the argument is a character.
2119 This replaces `char-valid-p', which is now obsolete.
2121 **** `max-char' returns the maximum character code (currently #x3FFFFF).
2123 **** `define-charset-alias' defines an alias of a charset.
2125 **** `set-charset-priority' sets priorities of charsets.
2127 **** `charset-priority-list' returns a prioritized list of charsets.
2129 **** `unibyte-string' makes a unibyte string from bytes.
2131 **** `define-char-code-property' defines a character code property.
2133 **** `char-code-property-description' returns the description string of
2134 a character code property.
2136 *** New variables:
2138 **** `find-word-boundary-function-table' is a char-table of functions to
2139 search for a word boundary.
2141 **** `char-script-table' is a char-table of script names.
2143 **** `char-width-table' is a char-table of character widths.
2145 **** `print-charset-text-property' controls how to handle `charset' text
2146 property on printing a string.
2148 **** `printable-chars' is a char-table of printable characters.
2150 ** Code conversion changes
2152 *** The new function `define-coding-system' should be used to define a
2153 coding system instead of `make-coding-system' (which is now obsolete).
2155 *** The functions `encode-coding-region' and `decode-coding-region'
2156 have an optional 4th argument to specify where the result of
2157 conversion should go.
2159 *** The functions `encode-coding-string' and `decode-coding-string'
2160 have an optional 4th argument specifying a buffer to store the result
2161 of conversion.
2163 *** The new variable `inhibit-null-byte-detection' controls whether to
2164 consider text with null bytes as binary data.  By default, it is
2165 `nil', and Emacs uses `no-conversion' for any text containing null
2166 bytes.
2168 *** The functions `set-coding-priority' and `make-coding-system' are obsolete.
2170 *** New functions:
2172 **** `with-coding-priority' executes Lisp code using the specified
2173 coding system priority order.
2175 **** `check-coding-systems-region' checks if the text in the region is
2176 encodable by the specified coding systems.
2178 **** `coding-system-aliases' returns a list of aliases of a coding system.
2180 **** `coding-system-charset-list' returns a list of charsets supported
2181 by a coding system.
2183 **** `coding-system-priority-list' returns a list of coding systems
2184 ordered by their priorities.
2186 **** `set-coding-system-priority' sets priorities of coding systems.
2188 **** `coding-system-from-name' returns a coding system matching with
2189 the argument name.
2191 ** There is a new input method, Robin, different from Quail.
2192 It has three functionalities:
2193  i) a simple input method (converts an ASCII sequence into a string).
2194 ii) converts an existing buffer substring into another string
2195 iii) reverse conversion (each character produced by a
2196 robin rule can hold the original ASCII sequence as a char-code-property)
2198 *** The new function `robin-define-package' defines a Robin package.
2200 *** The new function `robin-modify-package' modifies an existing Robin package.
2202 *** The new function `robin-use-package' starts using a Robin package
2203 as an input method.
2205 *** The new function `string-to-unibyte' is like `string-as-unibyte'
2206 but signals an error if STRING contains a non-ASCII, non-eight-bit
2207 character.
2209 ** Changes related to the new font backend
2211 *** Which font backends to use can be specified by the X resource
2212 "FontBackend".  For instance, to use both X core fonts and Xft fonts:
2214 Emacs.FontBackend: x,xft
2216 If this resource is not set, Emacs tries to use all font backends
2217 available on your graphic device.
2219 *** New frame parameter `font-backend' specifies a list of
2220 font-backends supported by the frame's graphic device.  On X, they are
2221 currently `x' and `xft'.
2223 *** The function `set-fontset-font' now accepts a script name as the
2224 second argument, and has an optional 5th argument to control how to
2225 set the font.
2227 *** New functions:
2229 **** `fontp' checks if the argument is a font-spec or font-entity.
2231 **** `font-spec' creates a new font-spec object.
2233 **** `font-get' returns a font property value.
2235 **** `font-put' sets a font property value.
2237 **** `font-face-attributes' returns a plist of face attributes set by a font.
2239 **** `list-fonts' returns a list of font-entities matching a font spec.
2241 **** `find-font' returns the font-entity best matching the given font spec.
2243 **** `font-family-list' returns a list of family names of available fonts.
2245 **** `font-xlfd-name' returns an XLFD name of a given font spec, font
2246 entity, or font object.
2248 **** `clear-font-cache' clears all font caches.
2250 ** Changes related to multiple-terminal (multi-tty) support
2252 *** $TERM is now set to `dumb' for subprocesses.  If you want to know the
2253 $TERM inherited by Emacs you will have to look inside initial-environment.
2255 *** $DISPLAY is now dynamically inherited from the frame's `display'.
2257 *** The `window-system' variable is now frame-local.  The new
2258 `initial-window-system' variable contains the `window-system' value
2259 for the first frame.  `window-system' is also now a function that
2260 takes a frame argument.
2262 *** The `keyboard-translate-table' variable and the terminal and
2263 keyboard coding systems are now terminal-local.
2265 *** You can specify a terminal device (`tty' parameter) and a terminal
2266 type (`tty-type' parameter) to `make-terminal-frame'.
2268 *** The function `make-frame-on-display' now works during a tty
2269 session.
2271 *** A new `terminal' data type.
2272 The functions `get-device-terminal', `terminal-parameters',
2273 `terminal-parameter', `set-terminal-parameter' use this data type.
2275 *** Function key sequences are now mapped using `local-function-key-map',
2276 a new variable.  This inherits from the global variable function-key-map,
2277 which is not used directly any more.
2279 *** New hooks:
2281 **** before-hack-local-variables-hook is called after setting new
2282 variable file-local-variables-alist, and before actually applying the
2283 file-local variables.
2285 **** `suspend-tty-functions' and `resume-tty-functions' are called
2286 after a tty frame has been suspended or resumed, respectively.  The
2287 functions are called with the terminal id of the frame being
2288 suspended/resumed as a parameter.
2290 **** The special hook `delete-terminal-functions' is called before
2291 deleting a terminal.
2293 *** New functions:
2295 **** `delete-terminal'
2297 **** `suspend-tty'
2299 **** `resume-tty'.
2301 *** `initial-environment' holds the environment inherited from Emacs's parent.
2303 ** Redisplay changes
2305 *** For underlined characters, the distance between the underline and
2306 the baseline is controlled by a new variable, `underline-minimum-offset'.
2308 *** You can now pass the value of the `invisible' property to
2309 invisible-p to check whether it would cause the text to be invisible.
2310 This is convenient when checking invisibility of text with no buffer
2311 position (e.g. in before/after-strings).
2313 *** `clear-image-cache' can be told to flush only images of a specific file.
2315 *** `vertical-motion' can now be given a goal column.
2316 It now accepts a cons cell (COLS . LINES) in its first argument, which
2317 says to stop, where possible, at a pixel x-position equal to COLS
2318 times the default column width.
2320 *** redisplay-end-trigger-functions, set-window-redisplay-end-trigger,
2321 and window-redisplay-end-trigger are obsolete.  Use `jit-lock-register'
2322 instead.
2324 *** The new variables `wrap-prefix' and `line-prefix' specify display
2325 specs which are appended at display-time to every continuation line
2326 and non-continuation line, respectively.  In addition, Emacs
2327 recognizes the `wrap-prefix' and `line-prefix' text or overlay
2328 properties; these have the same effects as the variables of the same
2329 name, but take precedence.
2331 ** The Lisp interpreter now treats non-breaking space as whitespace.
2333 ** Miscellaneous new functions
2335 *** `apply-partially' performs a "curried" application of a function.
2337 *** `buffer-swap-text' swaps text between two buffers.  This can be
2338 useful for modes such as tar-mode, archive-mode, RMAIL.
2340 *** `combine-and-quote-strings' produces a single string from a list of strings
2341 sticking a separator string in between each pair, and quoting those
2342 strings that include the separator as their substring.  Useful for
2343 consing shell command lines from the individual arguments.
2345 *** `custom-note-var-changed' tells Custom to treat the change in a
2346 certain variable as having been made within Custom.
2348 *** `face-all-attributes' returns an alist describing all the basic
2349 attributes of a given face.
2351 *** `format-seconds' converts a number of seconds into a readable
2352 string of days, hours, etc.
2354 *** `image-refresh' refreshes all images associated with a given image
2355 specification.
2357 *** `locate-user-emacs-file' helps packages to select the appropriate
2358 place to save user-specific files.  It defaults to `user-emacs-directory'
2359 unless the file already exists at $HOME.
2361 *** `read-color' reads a color name using the minibuffer.
2363 *** `read-shell-command' does what its name says, with completion.  It
2364 uses the minibuffer-local-shell-command-map for that.
2366 *** `split-string-and-unquote' splits a string into a list of substrings
2367 on the boundaries of a given delimiter, and unquotes the substrings that
2368 are quoted.  Useful for taking apart shell commands.
2370 *** The two new functions `looking-at-p' and `string-match-p' can do
2371 the same matching as `looking-at' and `string-match' without changing
2372 the match data.
2374 *** The two new functions `make-serial-process' and
2375 `serial-process-configure' provide a Lisp interface to the new serial
2376 port support (see Emacs changes, above).
2378 ** Miscellaneous new variables
2380 *** `auto-save-include-big-deletions', if non-nil, means auto-save is
2381 not turned off automatically after a big deletion.
2383 *** `read-circle', if nil, disables the reading of recursive Lisp
2384 structures using the #N= and #N# syntax.
2386 *** `this-command-keys-shift-translated' is non-nil if the key
2387 sequence invoking the current command was found by shift-translation.
2389 *** `window-point-insertion-type' determines the insertion-type of the
2390 marker used for window-point.
2392 *** bookmark provides `bookmark-make-record-function' so special major
2393 modes like Info can teach bookmark.el how to save and restore the
2394 relevant data.
2396 *** `fill-forward-paragraph-function' specifies which function the
2397 filling code should use to find paragraph boundaries.
2400 * New Packages for Lisp Programming in Emacs 23.1
2402 ** The new package avl-tree.el deals with the AVL tree data structure.
2404 ** The new package check-declare.el verifies the accuracy of
2405 declare-function macros (see Lisp Changes, above).
2407 ** find-cmd.el can build `find' commands using lisp syntax.
2409 ** The package misearch.el has been added.  It allows Isearch to search
2410 through multiple buffers.  A variable `multi-isearch-next-buffer-function'
2411 defines the function to call to get the next buffer to search in the series
2412 of multiple buffers.  Top-level functions `multi-isearch-buffers',
2413 `multi-isearch-buffers-regexp', `multi-isearch-files' and
2414 `multi-isearch-files-regexp' accept a single argument that specifies
2415 a list of buffers/files to search for a string/regexp.
2417 ** The new major mode `special-mode' is intended as a parent for
2418 major modes such as those that set the "'mode-class 'special" property.
2421 ----------------------------------------------------------------------
2422 This file is part of GNU Emacs.
2424 GNU Emacs is free software: you can redistribute it and/or modify
2425 it under the terms of the GNU General Public License as published by
2426 the Free Software Foundation, either version 3 of the License, or
2427 (at your option) any later version.
2429 GNU Emacs is distributed in the hope that it will be useful,
2430 but WITHOUT ANY WARRANTY; without even the implied warranty of
2431 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
2432 GNU General Public License for more details.
2434 You should have received a copy of the GNU General Public License
2435 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
2438 Local variables:
2439 mode: outline
2440 paragraph-separate: "[  \f]*$"
2441 end:
2443 arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2