* bs.el (bs-unload-function): New function.
[emacs.git] / etc / NEWS
blob25d73cf3f7bf0b1e087f61332e0a369011ba5a64
1 GNU Emacs NEWS -- history of user-visible changes.
3 Copyright (C) 2007, 2008 Free Software Foundation, Inc.
4 See the end of the file for license conditions.
6 Please send Emacs bug reports to emacs-pretest-bug@gnu.org.
7 If possible, use M-x report-emacs-bug.
9 This file is about changes in Emacs version 23.
11 See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17
12 for changes in older Emacs versions.
14 You can narrow news to a specific version by calling `view-emacs-news'
15 with a prefix argument or by typing C-u C-h C-n.
17 Temporary note:
18  +++ indicates that the appropriate manual has already been updated.
19  --- means no change in the manuals is called for.
20 When you add a new item, please add it without either +++ or ---
21 so we will look at it and add it to the manual.
24 * About external Lisp packages
27 * Installation Changes in Emacs 23.1
29 ** The default X toolkit is now Gtk+, rather than Lucid.
30 The configure option `--with-gtk' has been removed.  Gtk is now the
31 default toolkit, but you can use --with-x-toolkit=gtk if necessary.
33 ** New font code.
34 Fonts are handled by new code capable of dealing with multiple font
35 backends.  This uses the freetype and fontconfig libraries.
37 *** Emacs now accepts font names supplied in the fontconfig format
38 (e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
40 *** Added support for local fonts (fonts installed on the machine
41 where Emacs is running).
43 *** Added support for the Xft library for antialiasing.
45 *** Added support for the otf library for complex text layout by
46 OpenType fonts.
48 *** Added support for the m17n library for text shaping.
50 ** Changes to image support
51 ---
52 *** configure now checks for libgif before libungif when searching for
53 a GIF library.
54 +++
55 *** Emacs now supports the SVG image format through librsvg2.
57 *** Emacs now supports multi-page TIFF images.
59 ** New NeXTSTEP-based port
60 This provides support for GNUstep (via the GNUstep libraries) and Mac
61 OS X (via the Cocoa libraries).
63 Specify --with-ns to configure for this. By default, a self-contained
64 app will be built (containing all lisp).  To install/share lisp with
65 other emacsen (e.g. X11 build) use --disable-ns-self-contained.  See
66 nextstep/README and nextstep/INSTALL in the Emacs source directory.
68 ** Mac OS X is no longer supported via Carbon.
69 Use the NeXTSTEP port, described above.
71 ** The new configuration option "--with-dbus" enables D-Bus language
72 bindings for Emacs.
74 ** Support for many obsolete platforms has been removed.
75 See the list at the end of etc/MACHINES for details.
76 ---
77 *** Support for systems without alloca has been removed.
78 ---
79 *** Support for Sun windows has been removed.
80 ---
81 *** The `emacstool' utility has been removed.
83 ** The following platforms will be removed in a future Emacs version:
84 If you are still using Emacs on one of these platforms, please email
85 emacs-devel@gnu.org to inform the Emacs developers.
87 *** Old GNU/Linux systems based on libc version 5.
89 *** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
90     executable format.
92 *** Solaris versions 2.6 and below.
94 *** Solaris on IBM RS6000 machines.
96 *** UNIX System V (the original SysV, not later platforms based on it).
98 *** Unixware on non-x86 machines.
100 *** Platforms not supporting shared libraries (i.e., requiring the
101 NO_SHARED_LIBS compilation flag).
104 ** The configure options `--with-gcc', `--without-gcc' have been removed.
105 Configure will use gcc by default.  Set the CC environment variable if
106 you need control over which C compiler is used.
108 ** The refcards are now shipped as PDF files.
111 ** Emacs 23 comes with a new set of default icons.
112 Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
113 The Emacs 22 icon is available as `emacs22.png' in the same location.
115 * Changes in Emacs 23.1
117 ** Improved X Window System support
119 *** Emacs now supports using both X displays and ttys in one session.
120 With an Emacs server active (M-x server-start), `emacsclient -t'
121 creates a tty frame connected to the running emacs server.  You can
122 use any number of different ttys.  `emacsclient -c' creates a new X11
123 frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
125 You can test for the presence of this feature in your Lisp code by
126 testing for the `multi-tty' feature.
128 **** Emacsclient can now open new terminal frames.
129 Now, the default behavior is to open a new Emacs frame by default.
130 Use the -c option to get the old behavior of opening files in the
131 currently selected Emacs frame.
133 *** Emacs can now start in background, as a daemon when using the
134 --daemon command line argument.  It disconnects from the terminal and
135 starts the server.  Clients can connect and create graphical or
136 terminal frames using emacsclient.
138 *** The new command close-display-connection closes a connection to a
139 remote display.
141 *** Emacs now supports the XEmbed specification.
142 You can embed Emacs in another application on X11.  The new command line
143 option --parent-id is used to pass the parent window id to Emacs.  See
144 http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
145 for details about XEmbed.
147 *** Emacs can now set the frame opacity.
148 The opacity of a frame can be controlled by setting the `alpha' frame
149 parameter.  This only takes effect on a compositing window manager for
150 the X Window System, such as Compiz, Beryl and Compiz Fusion, or on
151 Windows 2000 and later versions of Windows.
153 The alpha parameter should be an integer between 0 (transparent) and
154 100 (opaque), or a float number between 0.0 and 1.0.  It can also be a
155 cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
156 active frame and INACTIVE is the opactity of non-active frames.
158 The variable `frame-alpha-lower-limit' defines a lower bound for the
159 opacity; the default is 20.
161 ** Internationalization changes
163 *** The Emacs character set is now a superset of Unicode.
164 (It has about four times the code space, which should be plenty).
166 The internal encoding used for buffers and strings is now
167 Unicode-based and called `utf-8-emacs'.  This encoding is backwards
168 compatible with Unicode's UTF-8 encoding.  The internal encoding
169 previously used by Emacs, `emacs-mule', is still available.
171 During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
172 As a result, byte-compiled files containing non-ASCII characters can't
173 be read by earlier versions of Emacs.  Files compiled by Emacs 20, 21,
174 or 22 are loaded correctly as emacs-mule (whether or not they contain
175 multibyte characters).  This takes somewhat more time, so it may be
176 worth recompiling existing .elc files which don't need to be shared
177 with older Emacsen.
179 *** There are new coding systems/aliases; see M-x list-coding-systems.
181 *** There is a new charset implementation with many new charsets.
182 See M-x list-character-sets.  New charsets can be defined conveniently
183 as tables of unicodes.
185 **** The dimension of a charset is now 1, 2, 3, or 4, and the size of
186 each dimension is no longer limited to 94 or 96.
188 **** A dynamic charset priority list is used to infer the charset of
189 characters for display.
191 *** There are new language environments for Chinese-GBK,
192 Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
193 Sinhala, and TaiViet.
195 *** The minor modes unify-8859-on-encoding-mode and
196 unify-8859-on-decoding-mode are obsolete.
198 *** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
199 accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
200 decimal).  It also accepts Unicode character names with completion.
202 *** The `cyrillic-translit' input method supports many new characters.
203 Common typographical characters available from Unicode were added to
204 `cyrillic-translit': punctuation marks, accented characters, fractions,
205 and others.
207 ** Emacs now supports serial port access on GNU/Linux, Unix, and
208 Windows.  The new command `serial-term' starts an interactive terminal
209 on a serial port.  The serial port can be configured at runtime with
210 the mode-line mouse menu.
212 ** Menu Bar changes
214 *** In the Options menu, the "Set Default Font" item applies the
215 selected font to the `default' face on all frames, not just the
216 current frame.  Furthermore, if Emacs is compiled with both GTK and
217 Fontconfig support, the "Set Default Font" item uses the GTK font
218 selection dialog instead of an Emacs pop-up menu.
220 *** The font setting chosen by "Set Default Font" is saved if the
221 "Save Options" item is used.
223 *** The Tools menu contains a new Encryption/Decryption submenu.
224 This contains commands provided by EasyPG, the newly-included
225 interface to GnuPG (see New Modes and Packages).
227 *** In the Options menu, the "Truncate Long Lines in the Buffer" entry
228 has been replaced with a submenu offering three different ways to
229 handle long lines: truncation, continuation at the window edge, and
230 the new word wrapping behavior (see Editing Changes, below).
232 *** Improvements to menus for major and minor modes
233 More major and minor modes now have a mode specific menu, and existing
234 mode menus have been improved to include more functionality.
236 ** Mode-line changes
238 *** The mode-line displays a `@', instead of `-', if the
239 default-directory for the current buffer is on a remote machine.
241 *** The mode-line displays a mode menu when mouse-1 is clicked on a
242 minor mode, in the same way as it already did for major modes.
244 *** The `mode-line-emphasis' face is used to highlight certain
245 mode-line information (e.g. waiting for a VC command to finish).
247 *** The mode-line tooltips have been improved to provide more details.
249 *** The VC, line/colum number and minor mode indicators on the mode
250 line are now interactive: mouse-1 can be used on them to pop up a menu.
252 ** File deletion can make use of the Recycle Bin or system Trash folder.
253 Set `delete-by-moving-to-trash' non-nil to use this.  Deleted files
254 and directories will then be sent to the Recyle Bin on Windows, and
255 to `trash-directory' on other systems.
257 ** Directory-local variables can now be defined.
258 By default, Emacs looks in .dir-settings.el for directory-local
259 variables.  For more information, see `set-directory-project' and
260 `define-project-bindings'.
262 ** Emacs can now use `auth-source' for authentication.
263 `smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
264 login names and passwords.  The match, if found, is reported
265 in *Messages* with the password blanked out.
267 ** `where-is-preferred-modifier' can specify your favorite modifier.
270 * Startup Changes in Emacs 23.1
273 ** The option `inhibit-startup-screen' (with aliases to old names
274 `inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
275 display of the initial message in the *scratch* buffer.  If you don't
276 want to display the initial message in the *scratch* buffer at startup,
277 you can set the option `initial-scratch-message' to nil.
279 ** New user option `initial-buffer-choice' specifies what to display
280 after starting Emacs: startup screen, *scratch* buffer, visiting a
281 file or directory.
283 ** New alias `argv' for `command-line-args-left'
284 This is a convenience alias, so that one can write `(pop argv)'
285 inside of --eval command line arguments in order to access
286 following arguments.
288 ** The abbrev file is no longer read at startup in batch mode.
290 * Incompatible Editing Changes in Emacs 23.1
292 ** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
293 on the regexp command prefix map.
296 ** In Dired-x, all command guesses for ! are now added to the default
297 list accessible by M-n instead of pushing all guesses temporarily into
298 the history list.
301 ** In Isearch mode, a special case of typing `C-w' at the beginning of
302 the minibuffer that toggles word search (i.e. using key sequences
303 `C-s RET C-w' or `C-s M-e C-w') is obsolete.  You can use the global key
304 `M-s w' to start word search, or type `M-s w' in Isearch mode to
305 toggle word search.
307 ** In Text mode, `center-line' and `center-paragraph' are rebound
308 from `M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the
309 global prefix map `M-o' intended for such formatting commands.
312 ** The following input methods were removed in Emacs 22.2, but this was
313 not advertised: danish-alt-postfix, esperanto-alt-postfix,
314 finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
315 norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
316 and swedish-alt-postfix.  Use the versions without "alt-", which are
317 identical.
320 * Editing Changes in Emacs 23.1
323 ** The C-n and C-p line-motion commands now move by screen lines,
324 taking continued lines and variable-width characters into account.
325 Setting `line-move-visual' to nil reverts this to the previous
326 behavior (motion by logical lines based on buffer contents alone).
328 ** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
329 invokes `suspend-frame'.  This change is for compatibility with the
330 new multi-tty support (see `Improved X Window System support' above).
332 ** Mark changes
334 *** Transient Mark mode is now on by default.
336 *** mark-even-if-inactive now defaults to t
338 *** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
339 activating it.
341 *** When Transient Mark mode is on, M-q now fills the region if the
342 region is active.  Otherwise, it fills the current paragraph.
344 *** When Transient Mark mode is on, M-$ now checks spelling of the
345 region if the region is active.  Otherwise, it checks spelling of the
346 word at point.
348 *** When Transient Mark mode is on, TAB now indents the region if the
349 region is active.
351 *** `use-empty-active-region' controls whether an empty active region
352 in Transient Mark mode should make commands operate on that empty
353 region.
355 ** Temporarily active regions
357 *** The new variable shift-select-mode, non-nil by default, controls
358 shift-selection.  When Shift Select mode is on, shift-translated
359 motion keys (e.g. S-left and S-down) activate and extend a temporary
360 region, similar to mouse-selection.
362 *** Temporarily active regions, created using shift-selection or
363 mouse-selection, are not necessarily deactivated in the next command.
364 They are only deactivated after point motion commands that are not
365 shift-translated, or after commands that would ordinarily deactivate
366 the mark in Transient Mark mode (e.g., any command that modifies the
367 buffer).
369 ** Minibuffer and completion changes
371 *** When M-n in the minibuffer reaches the end of the list of defaults,
372 it adds the completion list to the end, so next M-n continues putting
373 completion items to the minibuffer.  The same principle applies to
374 incremental search commands as well: C-s or C-M-s starts searching
375 the default values and after the end of defaults they continue
376 searching minibuffer completion items.
378 *** Minibuffer input of shell commands now comes with completion.
380 *** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
381 name of the current buffer.
383 *** In the M-! (shell-command) prompt, M-n provides some default commands.
384 These are guessed using the file extension of the current file, based
385 on the file-handlers specified in the operating system's `mailcap'
386 file.  The ! command in Dired (dired-do-shell-command) works
387 similarly, using the file displayed on the current line.
389 *** A list of regexp default values is available via M-n for `occur',
390 `keep-lines', `flush-lines' and `how-many'.  This list includes the active
391 region in transient-mark-mode, the word under the cursor, the last Isearch
392 regexp, the last Isearch string and the last replacement regexp.
394 *** When enable-recursive-minibuffers is non-nil, operations which use
395 switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
396 used in a minibuffer or a dedicated window.  Instead, they fallback on
397 using pop-to-buffer, which will use some other window.  This change
398 has no effect when enable-recursive-minibuffers is nil (the default).
400 *** Isearch started in the minibuffer searches in the minibuffer history.
401 Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer
402 history elements, and forward Isearch commands (C-s, C-M-s) search in
403 next history elements.  When the reverse search reaches the first history
404 element, it wraps to the last history element, and the forward search
405 wraps to the first history element.  When the search is terminated, the
406 history element containing the search string becomes the current.
408 *** The variable read-file-name-completion-ignore-case overrides
409 completion-ignore-case for file name completion.
411 *** The variable read-buffer-completion-ignore-case overrides
412 completion-ignore-case for buffer name completion.
414 *** `completion-styles' can be customized to choose your favorite
415 completion style.
417 *** The default completion styles include a form of partial-completion.
419 *** The new command `minibuffer-force-complete' chooses one of the
420 possible completions, rather than stopping at the common prefix.
422 *** If `completion-auto-help' is `lazy', Emacs shows the completions
423 buffer only on the second attempt to complete.  This was already
424 supported in `partial-completion-mode'.
426 ** Face changes
428 *** S-down-mouse-1 now pops up a menu for changing the font and text
429 size of the default face in the current buffer.  The face is changed
430 via face remapping (see below).
432 *** FIXME face-remap
434 ** Primary selection changes
436 *** If `select-active-regions' is t, setting the mark automatically
437 makes the new region into the primary selection (for interaction with
438 other window applications).  If you enable this, you might want to
439 bind `mouse-yank-primary' to Mouse-2.
441 *** You can disable kill ring commands from accessing the primary
442 selection by setting `x-select-enable-primary' to nil.
444 ** Continuation lines can now be wrapped at word boundaries
445 (word-wrapping).  This is controlled by the new per-buffer variable
446 `word-wrap'.  Word wrapping does not take place if continuation lines
447 are not shown, e.g. if truncate-lines is non-nil.  The most convenient
448 way to enable word-wrapping is using the new minor mode Visual Line
449 mode; in addition to setting `word-wrap' to t, this rebinds some
450 editing commands to work on screen lines rather than text lines.  See
451 New Modes and Packages, below.
453 ** Window management changes
455 *** truncate-partial-width-windows now accepts integer values, which
456 specify a minimum window width for partial-width windows, below which
457 lines are truncated.  The default has been changed to 50.
459 *** The new command balance-windows-area balances windows both
460 vertically and horizontally.
462 ** Miscellaneous changes:
465 *** C-l is bound to the new command recenter-top-bottom, rather than recenter.
466 This moves the current line to window center, top and bottom on
467 successive invokations.
469 *** scroll-preserve-screen-position also preserves the column position.
471 *** If `yank-pop-change-selection' is t, rotating the kill ring also
472 updates the selection or clipboard to the current yank, just as M-w
473 would do so with the text it copies to the kill ring.
476 *** C-M-% now shows replacement as it would look in the buffer, with
477 `\N' and `\&' substituted according to the match.  Old behavior can be
478 restored by customizing `query-replace-show-replacement'.
480 *** The command shell prompts for the default directory, when it is
481 called with a prefix and the default directory is a remote file name.
482 This is because some file name handlers (like ange-ftp) are not able to
483 run processes remotely.
485 *** The new command kill-matching-buffers kills buffers whose name
486 matches a regexp.
488 *** The new commands `pp-macroexpand-expression' and
489 `pp-macroexpand-last-sexp' pretty-print macro expansions.
492 * New Modes and Packages in Emacs 23.1
494 ** FIXME add details of new packages imported from lisp/gnus.
495 [Maybe some information from doc/misc/gnus-coding.texi can be reused]
497 ** Auto Composition Mode is a minor mode that composes characters
498 automatically when they are displayed.  It is globally on by default.
499 It uses `auto-composition-function' (default `auto-compose-chars').
501 ** Bubbles, a new game, is similar to SameGame.
503 ** bug-reference.el provides clickable links to bug reports.
505 ** dbus.el provides D-Bus language bindings.
506 D-Bus is an inter-process communication mechanism for applications
507 residing on the same host.  See the manual for details.
509 ** Doc View Mode allows viewing of PDF, PostScript and DVI documents.
510 One can also search for a regular expression in the document.  For
511 details, see the commentary in doc-view.el.
513 ** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
514 It includes a GnuPG keyring browser, cryptographic operations on
515 regions and files, and automatic encryption of *.gpg files.  For
516 details, see the EasyPG Assistant User's Manual.
518 ** json.el is a library for parsing and generating JSON
519 (JavaScript Object Notation), a lightweight data-interchange format.
521 ** linum.el is a new minor mode to display line numbers for the
522 current buffer.
524 ** mairix.el is an interface to mairix, a free tool for indexing and
525 searching locally stored mail.  It allows you to query mairix and
526 display the search results with Rmail, Gnus and VM.  Note that there
527 is an existing Gnus back end, nnmairix.el, which should be used with
528 Maildir/MH setups.
530 ** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
532 ** nXML Mode
533 This is a new mode for editing XML documents.  It allows a schema to
534 be associated with the XML document being edited, using Relax NG as
535 the schema language.  The schema is used to provide two key features:
537 *** Continuous validation.  nXML validates as you type, highlighting
538 any invalid parts of your document.
540 *** Completion.  nXML can assist you in entering an element name,
541 attribute name or data value by using information about what is
542 allowed by the schema in that context.
544 ** proced.el provides a Dired-like interface for operating on processes.
545 Proced makes an Emacs buffer containing a listing of the current
546 processes (using ps(1)).  You can use the normal Emacs commands to
547 move around in this buffer, and special Proced commands to operate on
548 the processes listed.
550 ** Remember Mode is a mode for jotting down things to remember.
551 Notes can be saved to a Diary file.  For details, see the Remember
552 Manual.
554 ** RST mode is a major mode for editing ReSTructured-Text files.
557 ** Visual Line mode provides support for editing by visual lines.
558 It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
559 and C-k to commands that operate by visual lines instead of logical
560 lines.  This is a more reliable replacement for longlines-mode.
561 This can also be turned on using the menu bar, via
562 Options -> Line Wrapping in this Buffer -> Word Wrap
564 ** xesam.el is an implementation of Xesam, an interface to (desktop)
565 search engines like Beagle, Strigi, and Tracker.  The Xesam API
566 requires D-Bus for communication.
568 ** zeroconf.el offers service discovery and service publishing
569 interfaces according to the zeroconf specification.  It communicates
570 with Avahi, a zeroconf implementation, via D-Bus messages on systems
571 which have installed this software.
573 ** There is a new `whitespace' package.
574 (The pre-existing one has been renamed to `old-whitespace'.)
575 Now, besides reporting bogus blanks, the whitespace package has a
576 minor mode and a global minor mode to visualize blanks (TAB, (HARD)
577 SPACE and NEWLINE).  The visualization is made via faces and/or display
578 table.  It can also indicate lines that extend beyond a given column,
579 trailing blanks, and empty lines at the start or end of a buffer.
580 See `whitespace-style' for more details.  The `whitespace-action' option
581 specifies what to do when a buffer is visited, killed, or written.
584 * Changes in Specialized Modes and Packages in Emacs 23.1
586 ** Abbrev has been rewritten in Elisp and extended with more flexibility.
587 *** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
588     abbrev-table-p, abbrev-insert, abbrev-table-menu.
589 *** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
590 *** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
591     extra arguments for arbitrary properties.
592 *** New variable `abbrev-minor-mode-table-alist'.
593 *** `local-abbrev-table' can hold a list of abbrev-tables.
594 *** Abbrevs have now the following special properties:
595     `:count', `:system', `:enable-function', `:case-fixed'.
596 *** Abbrev-tables have now the following special properties:
597     `:parents', `:case-fixed', `:enable-function', `:regexp',
598     `abbrev-table-modiff'.
600 ** Apropos
601 *** `apropos-library' describes the elements defined in a given library.
602 *** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
604 ** Archive Mode has basic support to browse Rar archives.
606 ** BibTeX mode
608 *** New command `bibtex-initialize' (re)initializes BibTeX buffers.
610 *** New `bibtex-entry-format' options `whitespace', `braces', and
611 `string', disabled by default.
613 *** New variable `bibtex-cite-matcher-alist' contains rules to
614 identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
616 *** Command `bibtex-url' allows multiple URLs per entry.
618 ** Calendar and diary
621 *** There is a new date style, `iso', essentially year/month/day.
622 The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
623 Similarly, the commands `american-calendar' and `european-calendar'
624 should be replaced by `calendar-set-date-style'.
627 *** The calendar namespace has been rationalized.
628 All functions and variables now begin with a `calendar-', `diary-', or
629 `holiday-' prefix.  The various calendar systems have secondary
630 prefixes, eg `calendar-french-'.  The old names you are likely to use
631 directly still exist, for the time being, as aliases, but please start
632 using the new names.
635 *** The whitespace in the calendar layout can be customized.
636 See the variables:
637 calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
638 calendar-day-header-width, and calendar-day-digit-width.
641 *** Text (e.g. ISO weeks) can be displayed between the calendar months.
642 See the variables calendar-intermonth-header and calendar-intermonth-text.
645 *** The function `holiday-chinese' computes holidays on the Chinese calendar.
646 It has been used to add items to the list `holiday-oriental-holidays'.
649 *** `diary-remind' accepts a negative number -DAYS as a shorthand for
650 the list (1 2 ... DAYS).
652 ** Change Log mode
654 *** The new command C-c C-f (change-log-find-file) finds the file
655 associated with the current log entry.
657 *** The new command C-c C-c (change-log-goto-source) goes to the
658 source code associated with a log entry.
660 ** Compile and grep modes
662 *** The mode-line entry for the *compilation* and *grep* buffer is color coded.
663 It has different colors for to show that: (a) the command is still
664 running, (b) successful completion, (c) error.
666 *** compilation-auto-jump-to-first-error tells `compile' to jump to
667 the first error encountered during compilations.
669 *** The `cc' alias for C++ files in `grep-file-aliases' has been
670 improved. `hh' can be used to match C++ header files and `cchh' both
671 C++ sources and headers.
673 ** Copyright
675 *** You can specify your copyright holders' names.
676 Only copyright lines with holders matching `copyright-names-regexp' are
677 considered for update.
679 *** Copyrights can be at the end of the buffer.
680 This is controlled by `copyright-at-end-flag' (used by, e.g., change-log-mode).
682 ** Custom
684 *** defcustom accepts new keyword arguments, `:safe' and `:risky', which
685 set a variable's `safe-local-variable' and `risky-local-variable' property.
687 ** Diff mode
689 *** diff-refine-hunk highlights word-level details of changes in a diff hunk.
690 It's used automatically as you move through hunks, see
691 diff-auto-refine-mode.  It is bound to `C-c C-b'.
693 *** diff-add-change-log-entries-other-window iterates through the diff
694 buffer and tries to create ChangeLog entries for each change.
695 It is bound to `C-x 4 A'.
697 *** The new function `diff-show-trailing-whitespaces' shows
698 trailing whitespace problems in the modified lines of a diff buffer.
700 ** Dired
702 *** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
703 and C-x C-q in wdired-mode exits it with asking a question about
704 saving changes.
706 *** `&' runs the command `dired-do-async-shell-command' that executes
707 the command asynchronously without the need to manually add ampersand
708 to the end of the command.  Its output appears in the buffer `*Async Shell
709 Command*'.
711 *** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names.
712 When a new user option `dired-isearch-filenames' is non-nil, then even
713 ordinary Isearch started with `C-s' and `C-M-s' matches only at file names
714 in the Dired buffer.  You can toggle file names matching on or off
715 by typing `M-s f' in Isearch mode.
717 *** `M-s a C-s' and `M-s a M-C-s' run multi-file Isearch on the marked files.
718 They visit the first marked file in the sequence and display the usual Isearch
719 prompt for a string or a regexp where all Isearch commands are available.
721 *** `Q' in Dired provides two new keys for multi-file replacement.
722 The upper case key `Y' replaces all remaining matches in all remaining files
723 with no more questions.  The upper case key `N' stops doing replacements
724 in the current file and skips to the next file.  These multi-file keys
725 are available for all commands that use `tags-query-replace'
726 including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
727 `reftex-query-replace-document'.
729 ** Fortran
731 *** The line length of fixed-form Fortran is not fixed at 72 any more.
732 Customize the variable `fortran-line-length' to change it.
735 *** In Fortran mode, M-; is now bound to the standard comment-dwim,
736 rather than fortran-indent-comment.
739 *** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
741 ** Gnus
743 *** The Gnus package has been updated
744 There are many news features, bug fixes and improvements; see the file
745 GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
747 *** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
748 saving articles drafts and ~/.newsrc.eld.  These file may not be read
749 correctly in Emacs 22 and below.  If you want to Gnus across different Emacs
750 versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
752 *** Password are consistently loaded through `auth-source'
753 Gnus can use `auth-source' for POP and IMAP passwords.  Also see that
754 `smtpmail' and `url' support `auth-source' for SMTP and HTTP/HTTPS/RSS
755 authentication respectively.
757 ** Help mode
758 *** New macro `with-help-window' should set up help windows better
759 than `with-output-to-temp-buffer' with `print-help-return-message'.
760 *** New option `help-window-select' permits to customize whether help
761 window shall be automatically selected when invoking help.
762 *** New variable `help-window-point-marker' permits to specify new
763 position of point in help window (for example in `view-lossage').
765 ** Isearch
767 *** New command `isearch-forward-word' bound globally to `M-s w' starts
768 incremental word search.  New command `isearch-toggle-word' bound to the
769 same key `M-s w' in Isearch mode toggles word searching on or off
770 while Isearch is active.
772 *** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch
773 mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current
774 search string as its regexp argument.  The same key `M-s h r' and
775 other keys on the `M-s h' prefix are bound globally to the command
776 `highlight-regexp' and other hi-lock commands.
778 *** New command `isearch-occur' bound to `M-s o' in Isearch mode
779 runs `occur' with the current search string.  The same key `M-s o'
780 is bound globally to the command `occur'.
782 *** Isearch can now search through multiple ChangeLog files.
783 When running Isearch in a ChangeLog file, if the search fails,
784 then another C-s tries searching the previous ChangeLog,
785 if there is one (e.g. go from ChangeLog to ChangeLog.12).
786 This is enabled if multi-isearch-search is non-nil.
788 *** Two new commands to start Isearch on a list of marked buffers
789 for buff-menu.el and ibuffer.el are bound to the keys `M-s a C-s' and
790 `M-s a M-C-s'.
792 *** The part of an Isearch that failed to match is highlighted in
793 `isearch-fail' face.
795 *** `C-h C-h' in Isearch mode displays isearch-specific Help screen,
796 `C-h b' displays all Isearch key bindings, `C-h k' displays the full
797 documentation of the given Isearch key sequence, `C-h m' displays
798 documentation of Isearch mode.  All the rest Help commands exit Isearch mode
799 and execute their global definitions.
801 *** When started in the minibuffer, Isearch searches in the minibuffer
802 history.  See `Minibuffer changes', above.
805 ** MH-E
807 *** Upgraded to MH-E version 8.1. See MH-E-NEWS for details.
809 ** Python
810 *** The file etc/emacs.py now supports both Python 2 and 3, meaning
811 that either version can be used as inferior Python by python.el.
813 *** Python mode now has `pdbtrack' functionality.  When using pdb to
814 debug a Python program, pdbtrack notices the pdb prompt and displays
815 the source file and line that the program is stopped at, much the same
816 way as gud-mode does for debugging C programs with gdb.
818 ** Recentf
820 *** The default value of `recentf-keep' prevents from checking of
821 remote files, if there is no established connection to the
822 corresponding remote host.
824 ** TeX modes
826 *** New option latex-indent-within-escaped-parens
827 permits to customize indentation of LaTeX environments delimited
828 by escaped parens.
830 ** T-mouse Mode
832 *** If the gpm mouse server is running and t-mouse-mode is enabled,
833 Emacs uses a Unix socket in a GNU/Linux console to talk to server,
834 rather than faking events using the client program mev.  This C level
835 approach provides mouse highlighting and help echoing in the
836 minibuffer.
839 ** Tramp
841 *** New connection methods.
842 The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
843 been introduced.  There are also new so-called gateway methods
844 "tunnel" and "socks".
846 *** Multihop syntax has been removed.
847 The pseudo-method "multi" has been removed.  Instead of, multi hops
848 can be specified by the new variable `tramp-default-proxies-alist'.
850 *** More default settings.
851 Default values can be set via the variables `tramp-default-user',
852 `tramp-default-user-alist' and `tramp-default-host'.
854 *** Connection information is cached.
855 In order to reduce connection setup, information about used
856 connections are kept persistent in a file.  The name of this file is
857 defined in the variable `tramp-persistency-file-name'.
859 *** Control of remote processes.
860 Running processes on a remote host can be controlled by settings in
861 `tramp-remote-path' and `tramp-remote-process-environment'.
863 *** Success of remote copy is checked.
864 When the variable `file-precious-flag' is set, the success of a remote
865 file copy is checked via the file's checksum.
867 *** Passwords can be read from an authentification file.
868 Tramp uses the package `auth-source' to read passwords from a file, if
869 necessary.
871 ** VC and related modes
873 *** VC now supports applying VC operations to a set of files at a time.
874 This enables VC to work much more effectively with changeset-oriented
875 version-control systems such as Subversion, GNU Arch, Mercurial, Git
876 and Bzr.  VC will now pass a multiple-file commit to these systems as
877 a single changeset.
879 *** vc-dir is a new command that displays file names and their VC
880 status.  It allows to apply various VC operations to a file, a
881 directory or a set of files/directories.
883 *** Clicking on the VC mode-line entry now pops the VC menu.
885 *** The VC mode-line entry now has a tooltip that explains the VC file status.
887 *** In VC Annotate mode, for VC systems that support changesets, you can
888 see the diff for the whole changeset (not only for the current file)
889 by typing the D key.
891 *** In VC Annotate mode, you can type v to toggle the annotation visibility.
893 *** In VC Annotate mode, you can type f to show the file revision on
894 the current line.
896 *** In VC Annotate mode, for VC systems that support changesets, you
897 can see the diff for the whole changeset (not only for the current
898 file) by typing the D key or using the "Show changeset diff of
899 revision at line" menu entry.
901 *** Asynchronous VC commands display [Waiting...] in the mode-line
902 of the corresponding buffer as long as the asynchronous process is
903 active.
905 *** Log entries can be modified using the key "e" in log-view.
906 For now only CVS, RCS, SCCS and SVN support this functionality.
907 This is done by the `modify-change-comment' backend function.
909 *** In log-view-mode, for VC systems that support changesets, you can
910 see the diff for the whole changeset (not only for the current file)
911 by typing the D key or using the "Changeset Diff" menu entry.
913 *** In Log Edit mode,  C-c C-d now shows the diff for the files involved.
915 *** vc-git supports the "git grep" command.
917 *** VC Support for Meta-CVS has been removed for lack of maintainer able
918 to update it to the new VC.
920 ** Miscellaneous
922 *** comint-mode uses `start-file-process' now (see Lisp Changes).
923 If `default-directory' is a remote file name, subprocesses are started
924 on the corresponding remote system.
926 *** Eldoc highlights the function argument under point
927 with the face `eldoc-highlight-function-argument'.
929 *** In Etags, the --members option is now the default.
930 Use --no-members if you want the old default behavior of not tagging
931 struct members in C, members variables in C++ and variables in PHP.
933 *** The `gdb' command only works with the graphical interface now.
934 Use `gud-gdb' if you want the (old) text command mode.
936 *** goto-address.el provides two new minor modes, goto-address-mode and
937 goto-address-prog-mode, which buttonize URLS and email addresses.
939 *** The new command `eshell/info' runs info in an eshell buffer.
941 *** The new variable `ffap-rfc-directories' specifies a list of local
942 directories in which `ffap-rfc' will first search for RFCs.
944 *** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
945 See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
947 *** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
949 *** Info displays breadcrumbs in the header of the page.
950 See Info-breadcrumbs-depth to control it.
952 *** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
953 It is used to configure wireless interfaces.
955 *** The pcmpl-unix package supports hostname completion for ssh and scp.
957 *** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
959 *** smerge-refine highlights word-level details of changes in conflict.
960 It's used automatically as you move through conflicts, see
961 smerge-auto-refine-mode.
963 *** talk.el has been extended for multiple tty support.
965 *** A new command `display-time-world' has been added to the Time
966 package.  It creates a buffer with an updating time display using
967 several time zones.
969 *** The appearance of superscript and subscript in TeX is more customizable.
970 See the documentation of the variables: tex-fontify-script,
971 tex-font-script-display, tex-suscript-height-ratio, and
972 tex-suscript-height-minimum.
974 *** view-remove-frame-by-deleting is now by default t
975 since users found iconification of view-mode frames distracting.
977 *** WoMan tries to add locale-specific manual page directories to the
978 search path.  This can be disabled by setting `woman-locale' to nil.
981 * Changes in Emacs 23.1 on non-free operating systems
983 ** Case is now considered significant in completion on MS-Windows.
984 The default value of `completion-ignore-case' is now nil on
985 MS-Windows, the same as it is for other operating systems.  The
986 variable doesn't apply to reading a file name -- in that case Emacs
987 heeds `read-file-name-completion-ignore-case' instead.
990 ** IPv6 is supported on MS-Windows.
991 Emacs now supports IPv6 on Windows XP and later, and earlier versions
992 of Windows with third party IPv6 stacks installed.  In Emacs 22, IPv6 was
993 supported on other platforms, but not on Windows due to using the winsock
994 1.1 header file, even though Emacs was linking to the winsock 2 library.
997 ** Busy cursor (hourglass) now displays on MS-Windows.
998 When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
999 In Emacs 22 only X supported the busy cursor.
1002 ** Battery status is available on MS-Windows
1003 Emacs can now display the battery status in the mode-line when enabled with
1004 display-battery-mode or from the Options menu.  More verbose battery
1005 information is also available with the command `battery'.  In Emacs 22
1006 battery status was supported only on GNU/Linux and Mac.
1008 ** More keys available on MS-Windows.
1009 Keys normally associated with IMEs, and some exotic keys not normally found
1010 on standard keyboards have been given names so they can be bound to functions
1011 inside Emacs.  If there are keys on your keyboard that have not been exposed
1012 to Emacs in the past, try C-h k to see if they are available now.
1014 Emacs can now bind functions to the extra buttons for media player and
1015 browser control present on some keyboards.  These buttons are disabled
1016 by default, since enabling them prevents their system-wide use when
1017 Emacs has focus.  To enable them, set the variable
1018 w32-pass-multimedia-buttons to nil.  See the doc string of that variable
1019 for the list of extra keys that are available.
1021 ** BDF fonts no longer supported on MS-Windows.
1022 The font backend was completely rewritten for this release. The focus
1023 on Windows has been getting acceptable performance and full unicode
1024 support, including complex script shaping for native Windows fonts.  A
1025 rewrite of the BDF font support has not happened due to lack of time
1026 and developers.  If demand still exists for such a backend even with
1027 the improved language support for native Windows fonts, future
1028 development in this direction will most likely be based on the
1029 freetype library, giving access to a wider range of font formats.
1032 * Incompatible Lisp Changes in Emacs 23.1
1034 ** Variables cannot be both buffer-local and frame-local any more.
1036 ** `functionp' returns nil for special forms.
1037 I.e., it only returns t for objects that can be passed to `funcall'.
1039 ** The behavior of map-char-table has changed.  It may call the
1040 specified function with a cons (FROM . TO) as a key if characters in
1041 that range have the same value.
1043 ** Process changes
1045 *** The function `dired-call-process' has been removed.
1047 *** The multibyteness of process filters is now determined by the
1048 coding-system used for decoding.  The functions
1049 `process-filter-multibyte-p' and `set-process-filter-multibyte' are
1050 obsolete.
1053 ** The variable `byte-compile-warnings' can now be a list starting with `not',
1054 meaning to disable the specified warnings.  The meaning of this list
1055 may therefore be the reverse of what you expect (of course, this is
1056 only an issue if you make use of the new `not' syntax).  Rather than
1057 checking/manipulating elements directly, use the new functions
1058 `byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
1059 `byte-compile-enable-warning.'
1061 ** `mode-name' is no longer guaranteed to be a string.
1062 Use `(format-mode-line mode-name)' to ensure a string value.
1064 ** Internationalization changes
1066 *** The value of the function `charset-id' is now always 0.
1068 *** The functions `register-char-codings' and `coding-system-spec'
1069 have been removed.
1071 *** The cpXXX coding systems are now supported automatically.
1072 The functions cp-...-codepage, which you had to use in Emacs 22 to
1073 enable support for these coding systems, have been deleted.
1075 *** The following features have been removed.  They were used for
1076 displaying various scripts with specific fonts, and are no longer
1077 needed now that OpenType font support is available:
1079 **** `devanagari' and `devan-util', and all associated devanagari-* and
1080 dev-* functions and variables (formerly used for Devanagari script).
1082 **** `kannada' and `knd-util', and all associated kannada-* and knd-*
1083 functions and variables (formerly used for Kannada script).
1085 **** `malayalam' and `mlm-util', and all associated malayalam-* and
1086 mlm-* functions and variables (formerly used for Malayalam script).
1088 **** `tamil' and `tml-util, and all associated tamil-* and tml-*
1089 functions and variables (formerly used for Tamil script).
1092 * Lisp Changes in Emacs 23.1
1094 ** New primitives `list-system-processes' and `system-process-attributes'
1095 let Lisp programs access the processes that are running on the local
1096 machine.  See the doc strings of these functions for more details.
1097 Not all platforms support accessing this information; on those that
1098 don't, these primitives will return nil.
1101 ** New variable `user-emacs-directory'.
1102 Use this instead of "~/.emacs.d".
1104 ** If a local hook function has a non-nil `permanent-local-hook'
1105 property, `kill-all-local-variables' does not remove it from the local
1106 value of the hook variable; it remains even if you change major modes.
1108 ** `frame-inherited-parameters' lets new frames inherit parameters from
1109 the selected frame.
1111 ** New keymap `input-decode-map' overrides like key-translation-map, but
1112 applies before function-key-map.  Also it is terminal-local contrary to
1113 key-translation-map.  Terminal-specific key-sequences are generally added to
1114 this map rather than to function-key-map now.
1116 ** `ignore-errors' is now a standard macro (does not require the CL package).
1118 ** `interprogram-paste-function' can now return one string or a list
1119 of strings.  In the latter case, Emacs puts the second and following
1120 strings on the kill ring.
1123 ** In `condition-case', a handler can specify "let the debugger run first".
1124 You do this by writing `debug' in the list of conditions to be handled,
1125 like this:
1127     (condition-case nil
1128         (foo bar)
1129       ((debug error) nil))
1131 ** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
1133 ** `beginning-of-defun-function' now takes one argument, the count
1134 given to `beginning-of-defun'.
1137 ** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
1138 IDENTIFICATION specifies which part of the remote identifier has to be
1139 returned.  With CONNECTED passed non-nil, it is checked whether a
1140 remote connection has been established already.
1143 ** The new macro `declare-function' suppresses compiler warnings about
1144 undefined functions.
1146 ** Changes to interactive function handling
1148 *** The new interactive spec code ^ says to first call
1149 handle-shift-selection if shift-select-mode is non-nil, before reading
1150 the command arguments.  This is used for shift-selection (see above).
1152 *** Built-in functions can now have an interactive specification that
1153 is not a prompt string.  If the `intspec' parameter of a `DEFUN'
1154 starts with a `(', the string is evaluated as a Lisp form.
1156 *** The interactive-form of a function can be added post-facto via the
1157 `interactive-form' symbol property.  Mostly useful to add complex
1158 interactive forms to subroutines.
1160 ** Region changes
1162 *** Commands should use `use-region-p' to test whether there is
1163 an active region that they should operate on.
1165 *** `region-active-p' returns non-nil when Transient Mark mode is
1166 enabled and there is an active region.  This is NOT the best function
1167 to use to test whether a command should operate on the region instead
1168 of the usual behavior -- for that, use `use-region-p'.
1170 *** If a command sets `transient-mark-mode' to (only . OLDVAL), that
1171 means to activate transient-mark-mode temporarily, until the next
1172 unshifted point motion command or mark deactivation.  Afterwards,
1173 reset transient-mark-mode to the value OLDVAL.  The values `only' and
1174 `identity', introduced in Emacs 22, are now deprecated.
1176 ** Emacs session information
1178 *** The new variables `before-init-time' and `after-init-time' record the
1179 value of `current-time' before and after Emacs loads the init files.
1181 *** The new function `emacs-uptime' returns the uptime of an Emacs instance.
1183 *** The new function `emacs-init-time' returns the duration of the
1184 Emacs initialization.
1186 ** Changes affecting display-buffer
1188 *** New value nil for split-height-threshold inhibits vertical splitting
1189 unless there's no other window.
1191 *** New option split-width-threshold controls horizontal splitting.
1193 *** A window can be split horizontally even when it's not full-width.
1195 *** New option split-window-preferred-function can be set to a function
1196 to override the default splitting mechanism of display-buffer.
1198 ** Minibuffer and completion changes
1200 *** A list of default values can be specified for the DEFAULT argument of
1201 functions `read-from-minibuffer', `read-string', `read-command',
1202 `read-variable', `read-buffer', `completing-read'.  Elements of this list
1203 are available for inserting into the minibuffer by typing `M-n'.
1204 For empty input these functions return the first element of this list.
1206 *** New function `read-regexp' uses the regexp history and some useful
1207 regexp defaults (string at point, last Isearch/replacement regexp/string)
1208 via M-n when reading a regexp in the minibuffer.
1210 *** minibuffer-local-must-match-filename-map is now named
1211 minibuffer-local-filename-must-match-map.
1213 *** `all-completions' may now return the base size in the last cdr.
1214 Since this means the returned list is not properly nil-terminated, this
1215 is an incompatible change and is thus enabled by the new variable
1216 completion-all-completions-with-base-size.
1218 *** The `require-match' argument to `completing-read' accepts a new value
1219 `confirm-only'.
1221 ** Search and replacement changes
1223 *** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
1225 *** New function `match-substitute-replacement' returns the result of
1226 `replace-match' without actually using it in the buffer.
1228 *** The new variable `replace-search-function' determines the function
1229 to use for searching in query-replace and replace-string.
1231 *** The new variable `replace-re-search-function' determines the
1232 function to use for searching in `query-replace-regexp',
1233 `replace-regexp', `query-replace-regexp-eval', and
1234 `map-query-replace-regexp'.
1236 *** New keymap `search-map' bound to `M-s' provides global bindings
1237 for search related commands.
1239 *** New keymap `multi-query-replace-map' contains additonal keys bound
1240 to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
1242 *** The variable `inhibit-changing-match-data', if non-nil, prevents
1243 the search and match primitives from changing the match data.
1245 *** New functions `word-search-forward-lax' and `word-search-backward-lax'.
1246 These are like `word-search-forward and `word-search-backward', except
1247 that the end of the search string need not match a word boundary,
1248 unless it ends in whitespace.
1250 ** File handling changes
1252 *** set-file-modes is now interactive and can take the mode value in
1253 symbolic notation thanks to auxiliary functions.
1255 *** If you set find-file-confirm-nonexistent-file to t, then C-x C-f
1256 requires confirmation before opening a non-existent file.
1258 ** Process changes
1260 *** The new function `start-file-process' is similar to `start-process',
1261 but obeys file handlers.  The file handler is chosen based on
1262 `default-directory'.  The functions `start-file-process-shell-command'
1263 and `process-file-shell-command' are also new; they call internally
1264 `start-file-process' and `process-file', respectively.
1266 *** The new function `process-lines' executes an external program and
1267 returns its output as a list of lines.
1269 ** Character code, representation, and charset changes.
1271 The character code space is now 0x0..0x3FFFFF with no gap.
1272 Characters of code 0x0..0x10FFFF are Unicode characters of the same code points.
1273 Characters of code 0x3FFF80..0x3FFFFF are raw 8-bit bytes.
1275 Generic characters no longer exist.
1277 In buffers and strings, characters are represented by UTF-8 byte
1278 sequences in a multibyte buffer/string.
1280 The concept of a charset has changed.  A single character may belong
1281 to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
1282 unicode, iso-8859-1, iso-8859-3, etc).
1284 *** The functions `encode-char' and `decode-char' now accept any character sets.
1286 *** The function `define-charset' now accepts a completely different
1287 form of arguments (old-style arguments still work).
1289 *** The value of the function `char-charset' depends on the current
1290 priorities of charsets.
1292 *** The function get-char-code-property now accepts many Unicode base
1293 character properties.  They are `name', `general-category',
1294 `canonical-combining-class', `bidi-class', `decomposition',
1295 `decimal-digit-value', `digit-value', `numeric-value', `mirrored',
1296 `old-name', `iso-10646-comment', `uppercase', `lowercase', and
1297 `titlecase'.
1299 *** The functions `modify-syntax-entry' and `modify-category-entry' now
1300 accept a cons of characters as the first argument, and modify all
1301 entries in that range of characters.
1304 *** `translation-table-for-input' is now obsolete.
1306 *** New functions:
1308 **** `characterp' returns t if and only if the argument is a character.
1309 This replaces `char-valid-p', which is now obsolete.
1311 **** `max-char' returns the maximum character code (currently #x3FFFFF).
1313 **** `define-charset-alias' defines an alias of a charset.
1315 **** `set-charset-priority' sets priorities of charsets.
1317 **** `charset-priority-list' returns a prioritized list of charsets.
1319 **** `unibyte-string' makes a unibyte string from bytes.
1321 **** `define-char-code-property' defines a character code property.
1323 **** `char-code-property-description' returns the description string of
1324 a character code property.
1326 *** New variables:
1328 **** file-local-variables-alist stores an alist of file-local
1329 variables defined in the current buffer.
1331 **** `find-word-boundary-function-table' is a char-table of functions to
1332 search for a word boundary.
1334 **** `char-script-table' is a char-table of script names.
1336 **** `char-width-table' is a char-table of character widths.
1338 **** `print-charset-text-property' controls how to handle `charset' text
1339 property on printing a string.
1341 **** `printable-chars' is a char-table of printable characters.
1343 ** Code conversion changes
1345 *** The new function `define-coding-system' should be used to define a
1346 coding system instead of `make-coding-system' (which is now obsolete).
1348 *** The functions `encode-coding-region' and `decode-coding-region'
1349 have an optional 4th argument to specify where the result of
1350 conversion should go.
1352 *** The functions `encode-coding-string' and `decode-coding-string'
1353 have an optional 4th argument specifying a buffer to store the result
1354 of conversion.
1356 *** The functions `set-coding-priority' and `make-coding-system' are obsolete.
1358 *** New functions:
1360 **** `with-coding-priority' executes Lisp code using the specified
1361 coding system priority order.
1363 **** `check-coding-systems-region' checks if the text in the region is
1364 encodable by the specified coding systems.
1366 **** `coding-system-aliases' returns a list of aliases of a coding system.
1368 **** `coding-system-charset-list' returns a list of charsets supported
1369 by a coding system.
1371 **** `coding-system-priority-list' returns a list of coding systems
1372 ordered by their priorities.
1374 **** `set-coding-system-priority' sets priorities of coding systems.
1376 ** There is a new input method, Robin, different from Quail.
1377 It has three functionalities:
1378  i) a simple input method (converts an ASCII sequence into a string).
1379 ii) converts an existing buffer substring into another string
1380 iii) reverse conversion (each character produced by a
1381 robin rule can hold the original ASCII sequence as a char-code-property)
1383 *** The new function `robin-define-package' defines a Robin package.
1385 *** The new function `robin-modify-package' modifies an existing Robin package.
1387 *** The new function `robin-use-package' starts using a Robin package
1388 as an input method.
1390 *** The new function `string-to-unibyte' is like `string-as-unibyte'
1391 but signals an error if STRING contains a non-ASCII, non-eight-bit
1392 character.
1394 ** Changes related to the new font backend
1396 Which font backends to use can be specified by the X resource "FontBackend".
1397 For instance, to use both X core fonts and Xft fonts:
1399 Emacs.FontBackend: x,xft
1401 If this resource is not set, Emacs tries to use all font backends
1402 available on your graphic device.
1404 *** New frame parameter `font-backend' specifies a list of
1405 font-backends supported by the frame's graphic device.  On X, they are
1406 currently `x' and `xft'.
1408 *** The function `set-fontset-font' now accepts a script name as the
1409 second argument, and has an optional 5th argument to control how to
1410 set the font.
1412 *** New functions:
1414 **** `fontp' checks if the argument is a font-spec or font-entity.
1416 **** `font-spec' creates a new font-spec object.
1418 **** `font-get' returns a font property value.
1420 **** `font-put' sets a font property value.
1422 **** `font-face-attributes' returns a plist of face attributes set by a font.
1424 **** `list-fonts' returns a list of font-entities matching a font spec.
1426 **** `font-font' returns the font-entity best matching the given font spec.
1428 **** `list-families' returns a list of family names of available fonts.
1430 **** `font-xlfd-name' returns an XLFD name of a given font spec, font
1431 entity, or font object.
1433 **** `clear-font-cache' clears all font caches.
1435 ** Changes related to multiple-terminal (multi-tty) support
1437 *** $TERM is now set to `dumb' for subprocesses.  If you want to know the
1438 $TERM inherited by Emacs you will have to look inside initial-environment.
1440 *** $DISPLAY is now dynamically inherited from the frame's `display'.
1442 *** The `window-system' variable is now frame-local.  The new
1443 `initial-window-system' variable contains the `window-system' value
1444 for the first frame.  `window-system' is also now a function that
1445 takes a frame argument.
1447 *** The `keyboard-translate-table' variable and the terminal and
1448 keyboard coding systems are now terminal-local.
1450 *** You can specify a terminal device (`tty' parameter) and a terminal
1451 type (`tty-type' parameter) to `make-terminal-frame'.
1453 *** The function `make-frame-on-display' now works during a tty
1454 session, and `make-frame-on-tty' works during a graphical session.
1456 *** A new data type for terminals with functions: `get-device-terminal',
1457 `terminal-parameters', `terminal-parameter', `set-terminal-parameter'.
1459 *** Function key sequences are now mapped using `local-function-key-map',
1460 a new variable.  This inherits from the global variable function-key-map,
1461 which is not used directly any more.
1463 *** New hooks:
1465 **** before-hack-local-variables-hook is called after setting new
1466 variable file-local-variables-alist, and before actually applying the
1467 file-local variables.
1469 **** `suspend-tty-functions' and `resume-tty-functions' are called
1470 after a tty frame has been suspended or resumed, respectively.  The
1471 functions are called with the terminal id of the frame being
1472 suspended/resumed as a parameter.
1474 **** The special hook `delete-terminal-functions' is called before
1475 deleting a terminal.
1477 *** New functions:
1479 **** `environment'
1481 **** `make-frame-on-tty' creates a new frame on another tty device.
1483 **** `delete-tty'
1485 **** `suspend-tty'
1487 **** `resume-tty'.
1489 *** `initial-environment' holds the environment inherited from Emacs's parent.
1491 ** Redisplay changes
1493 *** For underlined characters, the distance between the underline and
1494 the baseline is controlled by a new variable, `underline-minimum-offset'.
1496 *** You can now pass the value of the `invisible' property to
1497 invisible-p to check whether it would cause the text to be invisible.
1498 Convenient when checking invisibility of text with no buffer position
1499 (e.g. in before/after-strings).
1501 *** `clear-image-cache' can be told to flush only images of a specific file.
1503 *** `vertical-motion' can now be given a goal column.
1504 It now accepts a cons cell (COLS . LINES) in its first argument, which
1505 says to stop, where possible, at a pixel x-position equal to COLS
1506 times the default column width.
1508 ** The Lisp interpreter now treats non-breaking space as whitespace.
1510 ** Miscellaneous new functions
1512 *** `format-seconds' converts a number of seconds into a readable
1513 string of days, hours, etc.
1515 *** `apply-partially' performs a "curried" application of a function.
1517 *** `read-shell-command' does what its name says, with completion.  It
1518 uses the minibuffer-local-shell-command-map for that.
1520 *** `buffer-swap-text' swaps text between two buffers.  This can be
1521 useful for modes such as tar-mode, archive-mode, RMAIL.
1523 *** `read-color' reads a color name using the minibuffer.
1525 *** `face-all-attributes' returns an alist describing all the basic
1526 attributes of a given face.
1528 *** `window-full-width-p' returns t if a window is as wide as its
1529 frame.
1531 *** `split-string-and-unquote' does (what?)
1533 *** `combine-and-quote-strings' does (what?)
1535 *** `image-refresh' refreshes all images associated with a given image
1536 specification.
1538 *** The two new functions `looking-at-p' and `string-match-p' can do
1539 the same matching as `looking-at' and `string-match' without changing
1540 the match data.
1542 *** The two new functions `make-serial-process' and
1543 `serial-process-configure' provide a Lisp interface to the new serial
1544 port support (see Emacs changes, above).
1546 ** Miscellaneous new variables
1548 *** `this-command-keys-shift-translated' is non-nil if the key
1549 sequence invoking the current command was found by shift-translation.
1551 *** `window-point-insertion-type' determines the insertion-type of the
1552 marker used for window-point.
1554 *** bookmark provides `bookmark-make-record-function' so special major
1555 modes like Info can teach bookmark.el how to save and restore the
1556 relevant data.
1558 *** `next-error-recenter' specifies how next-error should recenter the
1559 visited source file.  Its value can be a number (for example, 0 for
1560 top line, -1 for bottom line), or nil for no recentering.
1562 *** `fill-forward-paragraph-function' specifies which function the
1563 filling code should use to find paragraph boundaries.
1565 *** `custom-note-var-changed' tells Custom to treat the change in a
1566 certain variable as having been made within Custom.
1569 * New Packages for Lisp Programming in Emacs 23.1
1571 ** The new package avl-tree.el deals with the AVL tree data structure.
1574 ** The new package check-declare.el verifies the accuracy of
1575 declare-function macros (see Lisp Changes, above).
1577 ** find-cmd.el can build `find' commands using lisp syntax.
1579 ** The package misearch.el has been added.  It allows Isearch to search
1580 through multiple buffers.  A variable `multi-isearch-next-buffer-function'
1581 defines the function to call to get the next buffer to search in the series
1582 of multiple buffers.  Top-level commands `multi-isearch-buffers',
1583 `multi-isearch-buffers-regexp', `multi-isearch-files' and
1584 `multi-isearch-files-regexp' accept a single argument that specifies
1585 a list of buffers/files to search for a string/regexp.
1587 ** The new major mode `special-mode' is intended as a parent for
1588 major modes such as those that set the "'mode-class 'special" property.
1591 ----------------------------------------------------------------------
1592 This file is part of GNU Emacs.
1594 GNU Emacs is free software: you can redistribute it and/or modify
1595 it under the terms of the GNU General Public License as published by
1596 the Free Software Foundation, either version 3 of the License, or
1597 (at your option) any later version.
1599 GNU Emacs is distributed in the hope that it will be useful,
1600 but WITHOUT ANY WARRANTY; without even the implied warranty of
1601 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1602 GNU General Public License for more details.
1604 You should have received a copy of the GNU General Public License
1605 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
1608 Local variables:
1609 mode: outline
1610 paragraph-separate: "[  \f]*$"
1611 end:
1613 arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2