Update documentation status.
[bpt/emacs.git] / etc / NEWS
CommitLineData
29b7722a 1GNU Emacs NEWS -- history of user-visible changes.
5b87ad55 2
dcb8ac09 3Copyright (C) 2007, 2008 Free Software Foundation, Inc.
5b87ad55 4See the end of the file for license conditions.
a933dad1 5
3f7194ed 6Please send Emacs bug reports to emacs-pretest-bug@gnu.org.
9a21d88b
KS
7If possible, use M-x report-emacs-bug.
8
0bfd685e 9This file is about changes in Emacs version 23.
9a21d88b 10
0bfd685e
GM
11See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17
12for changes in older Emacs versions.
9a21d88b
KS
13
14You can narrow news to a specific version by calling `view-emacs-news'
15with a prefix argument or by typing C-u C-h C-n.
3f7194ed
GM
16
17Temporary note:
18 +++ indicates that the appropriate manual has already been updated.
19 --- means no change in the manuals is called for.
20When you add a new item, please add it without either +++ or ---
21so we will look at it and add it to the manual.
22
05197f40 23\f
9c576ea0
KS
24* About external Lisp packages
25
9c576ea0 26\f
0bfd685e 27* Installation Changes in Emacs 23.1
c58dccad 28
3f7194ed 29** The default X toolkit is now Gtk+, rather than Lucid.
09e18d03
CY
30The configure option `--with-gtk' has been removed. Gtk is now the
31default toolkit, but you can use --with-x-toolkit=gtk if necessary.
3f7194ed 32
09e18d03
CY
33** New font code.
34Fonts are handled by new code capable of dealing with multiple font
de9efca0 35backends. This uses the freetype and fontconfig libraries.
2b7a2553 36
09e18d03
CY
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").
1abe3a1e 39
09e18d03
CY
40*** Added support for local fonts (fonts installed on the machine
41where Emacs is running).
42
43*** Added support for the Xft library for antialiasing.
44
45*** Added support for the otf library for complex text layout by
46OpenType fonts.
47
48*** Added support for the m17n library for text shaping.
15f02f65 49
09e18d03 50** Changes to image support
2e0ef05b 51---
09e18d03 52*** configure now checks for libgif before libungif when searching for
9d3cc9b2 53a GIF library.
2e0ef05b 54+++
09e18d03
CY
55*** Emacs now supports the SVG image format through librsvg2.
56
fab17942
JR
57*** Emacs now supports multi-page TIFF images.
58
006a2cde
CY
59** New NeXTSTEP-based port
60This provides support for GNUStep (via the GNUStep libraries) and Mac
1e9b0fb2 61OS X (via the Cocoa libraries).
043023ca
CY
62
63Specify --with-ns to configure for this. By default, a self-contained
64app will be built (containing all lisp). To install/share lisp with
65other emacsen (e.g. X11 build) use --disable-ns-self-contained. See
66nextstep/README and nextstep/INSTALL in the Emacs source directory.
006a2cde
CY
67
68** Mac OS X is no longer supported via Carbon.
69Use the NeXTSTEP port, described above.
36e625ec 70
09e18d03
CY
71** The new configuration option "--with-dbus" enables D-Bus language
72bindings for Emacs.
07e5c0b0 73
bb9f7948
EZ
74** Support for many obsolete platforms has been removed.
75See the list at the end of etc/MACHINES for details.
2e0ef05b 76---
09e18d03 77*** Support for systems without alloca has been removed.
2e0ef05b 78---
09e18d03 79*** Support for Sun windows has been removed.
2e0ef05b
CY
80---
81*** The `emacstool' utility has been removed.
09e18d03 82
006a2cde 83** The following platforms will be removed in a future Emacs version:
9bc072cc
CY
84If you are still using Emacs on one of these platforms, please email
85emacs-devel@gnu.org to inform the Emacs developers.
006a2cde 86
9bc072cc 87*** Old GNU/Linux systems based on libc version 5.
006a2cde 88
9bc072cc
CY
89*** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
90 executable format.
006a2cde
CY
91
92*** Solaris versions 2.6 and below.
93
32847230
CY
94*** Solaris on IBM RS6000 machines.
95
96*** UNIX System V (the original SysV, not later platforms based on it).
97
9bc072cc
CY
98*** Unixware on non-x86 machines.
99
32847230
CY
100*** Platforms not supporting shared libraries (i.e., requiring the
101NO_SHARED_LIBS compilation flag).
006a2cde 102
2e0ef05b 103---
a46ee55c
GM
104** The configure options `--with-gcc', `--without-gcc' have been removed.
105Configure will use gcc by default. Set the CC environment variable if
106you need control over which C compiler is used.
107
09e18d03
CY
108** The refcards are now shipped as PDF files.
109
2e0ef05b 110---
09e18d03
CY
111** Emacs 23 comes with a new set of default icons.
112Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
113The Emacs 22 icon is available as `emacs22.png' in the same location.
4e5cdb4f 114\f
6dadd99f
NR
115* Changes in Emacs 23.1
116
09e18d03 117** Improved X Window System support
ba5ff07b 118
09e18d03
CY
119*** Emacs now supports using both X displays and ttys in one session.
120With an Emacs server active (M-x server-start), `emacsclient -t'
121creates a tty frame connected to the running emacs server. You can
122use any number of different ttys. `emacsclient -c' creates a new X11
123frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
780d7bb9
RS
124
125You can test for the presence of this feature in your Lisp code by
126testing for the `multi-tty' feature.
127
09e18d03
CY
128**** Emacsclient can now open new terminal frames.
129Now, the default behavior is to open a new Emacs frame by default.
130Use the -c option to get the old behavior of opening files in the
131currently selected Emacs frame.
d82c3d44 132
09e18d03
CY
133*** The new command close-display-connection closes a connection to a
134remote display.
d82c3d44 135
09e18d03
CY
136*** Emacs now supports the XEmbed specification.
137You can embed Emacs in another application on X11. The new command line
138option --parent-id is used to pass the parent window id to Emacs. See
7b476dbe
JD
139http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
140for details about XEmbed.
141
09e18d03
CY
142*** Emacs can now set the frame opacity.
143The opacity of a frame can be controlled by setting the `alpha' frame
144parameter. This only takes effect on a compositing window manager for
0f784aa6
JR
145the X Window System, such as Compiz, Beryl and Compiz Fusion, or on
146Windows 2000 and later versions of Windows.
55f9bad5
GM
147
148The alpha parameter should be an integer between 0 (transparent) and
09e18d03
CY
149100 (opaque), or a float number between 0.0 and 1.0. It can also be a
150cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
151active frame and INACTIVE is the opactity of non-active frames.
55f9bad5 152
09e18d03
CY
153The variable `frame-alpha-lower-limit' defines a lower bound for the
154opacity; the default is 20.
55f9bad5 155
09e18d03 156** Internationalization changes
fec8ef06 157
09e18d03
CY
158*** The Emacs character set is now a superset of Unicode.
159(It has about four times the code space, which should be plenty).
0a963185 160
09e18d03
CY
161The internal encoding used for buffers and strings is now
162Unicode-based and called `utf-8-emacs'. This encoding is backwards
163compatible with Unicode's UTF-8 encoding. The internal encoding
164previously used by Emacs, `emacs-mule', is still available.
6dadd99f 165
09e18d03
CY
166During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
167As a result, byte-compiled files containing non-ASCII characters can't
168be read by earlier versions of Emacs. Files compiled by Emacs 20, 21,
169or 22 are loaded correctly as emacs-mule (whether or not they contain
170multibyte characters). This takes somewhat more time, so it may be
171worth recompiling existing .elc files which don't need to be shared
172with older Emacsen.
3ae459e5 173
09e18d03 174*** There are new coding systems/aliases; see M-x list-coding-systems.
c2e8590b 175
09e18d03
CY
176*** There is a new charset implementation with many new charsets.
177See M-x list-character-sets. New charsets can be defined conveniently
178as tables of unicodes.
1abe3a1e 179
09e18d03
CY
180**** The dimension of a charset is now 1, 2, 3, or 4, and the size of
181each dimension is no longer limited to 94 or 96.
eb28688c 182
09e18d03
CY
183**** A dynamic charset priority list is used to infer the charset of
184characters for display.
6c5d503f 185
09e18d03
CY
186*** There are new language environments for Chinese-GBK,
187Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
188Sinhala, and TaiViet.
c9447ae1 189
09e18d03
CY
190*** The minor modes unify-8859-on-encoding-mode and
191unify-8859-on-decoding-mode are obsolete.
d466e9fc 192
e94d0645
JL
193*** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
194accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
195decimal). It also accepts Unicode character names with completion.
196
6d496c76
TZ
197*** The `cyrillic-translit' input method supports many new characters.
198Common typographical characters available from Unicode were added to
199`cyrillic-translit': punctuation marks, accented characters, fractions,
200and others.
201
09e18d03 202** Emacs now supports serial port access on GNU/Linux, Unix, and
81efacf9
CY
203Windows. The new command `serial-term' starts an interactive terminal
204on a serial port. The serial port can be configured at runtime with
205the mode-line mouse menu.
6c5d503f 206
09e18d03 207** Menu Bar changes
81efacf9 208---
09e18d03
CY
209*** In the Options menu, the "Set Default Font" item applies the
210selected font to the `default' face on all frames, not just the
211current frame. Furthermore, if Emacs is compiled with both GTK and
212Fontconfig support, the "Set Default Font" item uses the GTK font
213selection dialog instead of an Emacs pop-up menu.
81efacf9 214---
09e18d03
CY
215*** The font setting chosen by "Set Default Font" is saved if the
216"Save Options" item is used.
1b21ee06 217
b350bdf2
CY
218*** The Tools menu contains a new Encryption/Decryption submenu.
219This contains commands provided by EasyPG, the newly-included
220interface to GnuPG (see New Modes and Packages).
81efacf9
CY
221---
222*** In the Options menu, the "Truncate Long Lines in the Buffer" entry
223has been replaced with a submenu offering three different ways to
224handle long lines: truncation, continuation at the window edge, and
697f6b43 225the new word wrapping behavior (see Editing Changes, below).
5c4a15b3 226
c1337511
DN
227*** Improvements to menus for major and minor modes
228More major and minor modes now have a mode specific menu, and existing
229mode menus have been improved to include more functionality.
230
09e18d03 231** Mode-line changes
a6b85944 232+++
09e18d03
CY
233*** The mode-line displays a `@', instead of `-', if the
234default-directory for the current buffer is on a remote machine.
c4c9b6f9 235
09e18d03
CY
236*** The mode-line displays a mode menu when mouse-1 is clicked on a
237minor mode, in the same way as it already did for major modes.
b3cf10d7 238
09e18d03
CY
239*** The `mode-line-emphasis' face is used to highlight certain
240mode-line information (e.g. waiting for a VC command to finish).
d82c3d44 241
c1337511
DN
242*** The mode-line tooltips have been improved to provide more details.
243
244*** The VC, line/colum number and minor mode indicators on the mode
245line are now interactive: mouse-1 can be used on them to pop up a menu.
246
b798e26a
GM
247** File deletion can make use of the Recycle Bin or system Trash folder.
248Set `delete-by-moving-to-trash' non-nil to use this. Deleted files
249and directories will then be sent to the Recyle Bin on Windows, and
250to `trash-directory' on other systems.
251
09e18d03
CY
252** Directory-local variables can now be defined.
253By default, Emacs looks in .dir-settings.el for directory-local
254variables. For more information, see `set-directory-project' and
255`define-project-bindings'.
307f3501 256
b798e26a
GM
257** Emacs can now use `auth-source' for authentication.
258`smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
259login names and passwords. The match, if found, is reported
260in *Messages* with the password blanked out.
261
262** `where-is-preferred-modifier' can specify your favorite modifier.
263
6dadd99f 264\f
0bfd685e 265* Startup Changes in Emacs 23.1
21f7b9d8 266
a6b85944 267+++
3063e326
JL
268** The option `inhibit-startup-screen' (with aliases to old names
269`inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
270display of the initial message in the *scratch* buffer. If you don't
271want to display the initial message in the *scratch* buffer at startup,
272you can set the option `initial-scratch-message' to nil.
273
56e1896b
JL
274** New user option `initial-buffer-choice' specifies what to display
275after starting Emacs: startup screen, *scratch* buffer, visiting a
276file or directory.
277
aa5310e4
DK
278** New alias `argv' for `command-line-args-left'
279This is a convenience alias, so that one can write `(pop argv)'
280inside of --eval command line arguments in order to access
281following arguments.
f8fd7ed3
GM
282
283** The abbrev file is no longer read at startup in batch mode.
c44da964 284\f
0bfd685e 285* Incompatible Editing Changes in Emacs 23.1
b58cb59f 286
d1949cd5
JL
287** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
288on the regexp command prefix map.
289
117907d4
JL
290+++
291** In Dired-x, all command guesses for ! are now added to the default
292list accessible by M-n instead of pushing all guesses temporarily into
293the history list.
294
e94d0645
JL
295** In Isearch mode, a special case of typing `C-w' at the beginning of
296the minibuffer that toggles word search (i.e. using key sequences
297`C-s RET C-w' or `C-s M-e C-w') is obsolete. You can use the global key
298`M-s w' to start word search, or type `M-s w' in Isearch mode to
299toggle word search.
300
4e14951f
JL
301** In Text mode, `center-line' and `center-paragraph' are rebound
302from `M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the
303global prefix map `M-o' intended for such formatting commands.
304
81efacf9 305---
e405fa5f 306** The following input methods were removed in Emacs 22.2, but this was
9a930d75 307not advertised: danish-alt-postfix, esperanto-alt-postfix,
e405fa5f
RS
308finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
309norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
310and swedish-alt-postfix. Use the versions without "alt-", which are
311identical.
0b0914ae 312
406c0f12 313\f
0bfd685e 314* Editing Changes in Emacs 23.1
406c0f12 315
697f6b43 316+++
0c8b58e9
CY
317** The C-n and C-p line-motion commands now move by screen lines,
318taking continued lines and variable-width characters into account.
319Setting `line-move-visual' to nil reverts this to the previous
320behavior (motion by logical lines based on buffer contents alone).
321
09e18d03
CY
322** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
323invokes `suspend-frame'. This change is for compatibility with the
324new multi-tty support (see `Improved X Window System support' above).
3ae459e5 325
09e18d03 326** Mark changes
59b5d020 327+++
3ae459e5 328*** Transient Mark mode is now on by default.
3ae459e5
CY
329+++
330*** mark-even-if-inactive now defaults to t
3ae459e5 331+++
b350bdf2
CY
332*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
333activating it.
1ac03a31 334+++
3ae459e5
CY
335*** When Transient Mark mode is on, M-q now fills the region if the
336region is active. Otherwise, it fills the current paragraph.
ecde850a 337+++
3ae459e5
CY
338*** When Transient Mark mode is on, M-$ now checks spelling of the
339region if the region is active. Otherwise, it checks spelling of the
dc868f13 340word at point.
697f6b43 341
3ae459e5
CY
342*** When Transient Mark mode is on, TAB now indents the region if the
343region is active.
697f6b43 344
3ae459e5
CY
345*** `use-empty-active-region' controls whether an empty active region
346in Transient Mark mode should make commands operate on that empty
347region.
348
349** Temporarily active regions
4502d15f 350+++
3ae459e5
CY
351*** The new variable shift-select-mode, non-nil by default, controls
352shift-selection. When Shift Select mode is on, shift-translated
353motion keys (e.g. S-left and S-down) activate and extend a temporary
354region, similar to mouse-selection.
4502d15f 355+++
3ae459e5
CY
356*** Temporarily active regions, created using shift-selection or
357mouse-selection, are not necessarily deactivated in the next command.
358They are only deactivated after point motion commands that are not
359shift-translated, or after commands that would ordinarily deactivate
360the mark in Transient Mark mode (e.g., any command that modifies the
361buffer).
362
3307af6c 363** Minibuffer and completion changes
0ca1ad68 364+++
d47a29c1
JL
365*** When M-n in the minibuffer reaches the end of the list of defaults,
366it adds the completion list to the end, so next M-n continues putting
367completion items to the minibuffer. The same principle applies to
368incremental search commands as well: C-s or C-M-s starts searching
369the default values and after the end of defaults they continue
370searching minibuffer completion items.
f3ed2b83 371
09e18d03
CY
372*** Minibuffer input of shell commands now comes with completion.
373
374*** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
375name of the current buffer.
dc2f6c05 376
09e18d03
CY
377*** In the M-! (shell-command) prompt, M-n provides some default commands.
378These are guessed using the file extension of the current file, based
379on the file-handlers specified in the operating system's `mailcap'
380file. The ! command in Dired (dired-do-shell-command) works
381similarly, using the file displayed on the current line.
117907d4
JL
382
383*** A list of regexp default values is available via M-n for `occur',
384`keep-lines', `flush-lines' and `how-many'. This list includes the active
4f75e082
JL
385region in transient-mark-mode, the word under the cursor, the last Isearch
386regexp, the last Isearch string and the last replacement regexp.
c4e606b6 387---
3353f870
CY
388*** When enable-recursive-minibuffers is non-nil, operations which use
389switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
390used in a minibuffer or a dedicated window. Instead, they fallback on
391using pop-to-buffer, which will use some other window. This change
392has no effect when enable-recursive-minibuffers is nil (the default).
393
4f75e082
JL
394*** Isearch started in the minibuffer searches in the minibuffer history.
395Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer
396history elements, and forward Isearch commands (C-s, C-M-s) search in
297b8ccd
JL
397next history elements. When the reverse search reaches the first history
398element, it wraps to the last history element, and the forward search
399wraps to the first history element. When the search is terminated, the
400history element containing the search string becomes the current.
401
6c897494
CY
402*** The variable read-file-name-completion-ignore-case overrides
403completion-ignore-case for file name completion.
404
405*** The variable read-buffer-completion-ignore-case overrides
406completion-ignore-case for buffer name completion.
3307af6c
CY
407---
408*** `completion-styles' can be customized to choose your favorite
409completion style.
410---
411*** The default completion styles include a form of partial-completion.
412---
413*** The new command `minibuffer-force-complete' chooses one of the
414possible completions, rather than stopping at the common prefix.
415+++
416*** If `completion-auto-help' is `lazy', Emacs shows the completions
417buffer only on the second attempt to complete. This was already
418supported in `partial-completion-mode'.
6c897494 419
505d8756
GM
420** Face changes
421
b350bdf2
CY
422*** S-down-mouse-1 now pops up a menu for changing the font and text
423size of the default face in the current buffer. The face is changed
424via face remapping (see below).
d2d160bd 425
f20186fd
GM
426*** FIXME face-remap
427
09e18d03 428** Primary selection changes
0091c67e 429
09e18d03
CY
430*** If `select-active-regions' is t, setting the mark automatically
431makes the new region into the primary selection (for interaction with
432other window applications). If you enable this, you might want to
433bind `mouse-yank-primary' to Mouse-2.
c160dc76 434
b350bdf2
CY
435*** You can disable kill ring commands from accessing the primary
436selection by setting `x-select-enable-primary' to nil.
2e282009 437
697f6b43
CY
438** Continuation lines can now be wrapped at word boundaries
439(word-wrapping). This is controlled by the new per-buffer variable
440`word-wrap'. Word wrapping does not take place if continuation lines
441are not shown, e.g. if truncate-lines is non-nil. The most convenient
442way to enable word-wrapping is using the new minor mode Visual Line
443mode; in addition to setting `word-wrap' to t, this rebinds some
444editing commands to work on screen lines rather than text lines. See
445New Modes and Packages, below.
85b1de32 446
463c6766
CY
447** Window management changes
448
449*** truncate-partial-width-windows now accepts integer values, which
450specify a minimum window width for partial-width windows, below which
7d09b7a6 451lines are truncated. The default has been changed to 50.
463c6766
CY
452
453*** The new command balance-windows-area balances windows both
454vertically and horizontally.
455
09e18d03 456** Miscellaneous changes:
3f7194ed 457
97431b7f 458+++
09e18d03
CY
459*** C-l is bound to the new command recenter-top-bottom, rather than recenter.
460This moves the current line to window center, top and bottom on
461successive invokations.
15f3eb73 462
09e18d03 463*** scroll-preserve-screen-position also preserves the column position.
c154c0be 464
09e18d03
CY
465*** If `yank-pop-change-selection' is t, rotating the kill ring also
466updates the selection or clipboard to the current yank, just as M-w
467would do so with the text it copies to the kill ring.
468
469+++
470*** C-M-% now shows replacement as it would look in the buffer, with
471`\N' and `\&' substituted according to the match. Old behavior can be
472restored by customizing `query-replace-show-replacement'.
473
474*** The command shell prompts for the default directory, when it is
475called with a prefix and the default directory is a remote file name.
476This is because some file name handlers (like ange-ftp) are not able to
477run processes remotely.
478
479*** The new command kill-matching-buffers kills buffers whose name
480matches a regexp.
481
b350bdf2
CY
482*** The new commands `pp-macroexpand-expression' and
483`pp-macroexpand-last-sexp' pretty-print macro expansions.
8f377a4b 484
09e18d03
CY
485\f
486* New Modes and Packages in Emacs 23.1
e11910e2 487
09e18d03
CY
488** FIXME add details of new packages imported from lisp/gnus.
489[Maybe some information from doc/misc/gnus-coding.texi can be reused]
c06c430f 490
e11910e2
GM
491** Auto Composition Mode is a minor mode that composes characters
492automatically when they are displayed. It is globally on by default.
493It uses `auto-composition-function' (default `auto-compose-chars').
494
09e18d03 495** Bubbles, a new game, is similar to SameGame.
f6b26818 496
7ef39c6e
GM
497** bug-reference.el provides clickable links to bug reports.
498
09e18d03
CY
499** dbus.el provides D-Bus language bindings.
500D-Bus is an inter-process communication mechanism for applications
b350bdf2 501residing on the same host. See the manual for details.
09e18d03 502
b350bdf2
CY
503** Doc View Mode allows viewing of PDF, PostScript and DVI documents.
504One can also search for a regular expression in the document. For
505details, see the commentary in doc-view.el.
09e18d03 506
b350bdf2
CY
507** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
508It includes a GnuPG keyring browser, cryptographic operations on
509regions and files, and automatic encryption of *.gpg files. For
510details, see the EasyPG Assistant User's Manual.
09e18d03
CY
511
512** json.el is a library for parsing and generating JSON
513(JavaScript Object Notation), a lightweight data-interchange format.
514
515** linum.el is a new minor mode to display line numbers for the
516current buffer.
517
4b4eb083
CY
518** mairix.el is an interface to mairix, a free tool for indexing and
519searching locally stored mail. It allows you to query mairix and
520display the search results with Rmail, Gnus and VM. Note that there
521is an existing Gnus back end, nnmairix.el, which should be used with
522Maildir/MH setups.
523
e94d0645 524** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
09e18d03
CY
525
526** nXML Mode
527This is a new mode for editing XML documents. It allows a schema to
528be associated with the XML document being edited, using Relax NG as
529the schema language. The schema is used to provide two key features:
530
531*** Continuous validation. nXML validates as you type, highlighting
532any invalid parts of your document.
533
534*** Completion. nXML can assist you in entering an element name,
535attribute name or data value by using information about what is
536allowed by the schema in that context.
537
538** proced.el provides a Dired-like interface for operating on processes.
539Proced makes an Emacs buffer containing a listing of the current
540processes (using ps(1)). You can use the normal Emacs commands to
541move around in this buffer, and special Proced commands to operate on
542the processes listed.
543
544** Remember Mode is a mode for jotting down things to remember.
545Notes can be saved to a Diary file. For details, see the Remember
546Manual.
547
548** RST mode is a major mode for editing ReSTructured-Text files.
c2d0b538 549
7394499e 550+++
12f165e9
CY
551** Visual Line mode provides support for editing by visual lines.
552It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
553and C-k to commands that operate by visual lines instead of logical
554lines. This is a more reliable replacement for longlines-mode.
697f6b43
CY
555This can also be turned on using the menu bar, via
556Options -> Line Wrapping in this Buffer -> Word Wrap
12f165e9 557
0c68a24b
MA
558** xesam.el is an implementation of Xesam, an interface to (desktop)
559search engines like Beagle, Strigi, and Tracker. The Xesam API
560requires D-Bus for communication.
561
09e18d03
CY
562** zeroconf.el offers service discovery and service publishing
563interfaces according to the zeroconf specification. It communicates
564with Avahi, a zeroconf implementation, via D-Bus messages on systems
565which have installed this software.
566
d332a7a4
GM
567** There is a new `whitespace' package.
568(The pre-existing one has been renamed to `old-whitespace'.)
569Now, besides reporting bogus blanks, the whitespace package has a
570minor mode and a global minor mode to visualize blanks (TAB, (HARD)
571SPACE and NEWLINE). The visualization is made via faces and/or display
572table. It can also indicate lines that extend beyond a given column,
573trailing blanks, and empty lines at the start or end of a buffer.
574See `whitespace-style' for more details. The `whitespace-action' option
575specifies what to do when a buffer is visited, killed, or written.
4e5a8be9 576
09e18d03
CY
577\f
578* Changes in Specialized Modes and Packages in Emacs 23.1
579
580** Abbrev has been rewritten in Elisp and extended with more flexibility.
e047f448 581*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
a3709a8c 582 abbrev-table-p, abbrev-insert, abbrev-table-menu.
e047f448
SM
583*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
584*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
585 extra arguments for arbitrary properties.
586*** New variable `abbrev-minor-mode-table-alist'.
587*** `local-abbrev-table' can hold a list of abbrev-tables.
588*** Abbrevs have now the following special properties:
79415279 589 `:count', `:system', `:enable-function', `:case-fixed'.
e047f448
SM
590*** Abbrev-tables have now the following special properties:
591 `:parents', `:case-fixed', `:enable-function', `:regexp',
592 `abbrev-table-modiff'.
593
09e18d03
CY
594** Apropos
595*** `apropos-library' describes the elements defined in a given library.
596*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
0253fffa 597
09e18d03 598** Archive Mode has basic support to browse Rar archives.
0253fffa 599
09e18d03 600** BibTeX mode
bafbec39 601
09e18d03 602*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
bafbec39 603
09e18d03
CY
604*** New `bibtex-entry-format' options `whitespace', `braces', and
605`string', disabled by default.
12bbb989 606
09e18d03
CY
607*** New variable `bibtex-cite-matcher-alist' contains rules to
608identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
9097e8af 609
09e18d03 610*** Command `bibtex-url' allows multiple URLs per entry.
4c24d241 611
09e18d03 612** Calendar and diary
320bc739 613
09e18d03
CY
614+++
615*** There is a new date style, `iso', essentially year/month/day.
616The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
617Similarly, the commands `american-calendar' and `european-calendar'
618should be replaced by `calendar-set-date-style'.
c3bb6fdb 619
09e18d03
CY
620+++
621*** The calendar namespace has been rationalized.
622All functions and variables now begin with a `calendar-', `diary-', or
623`holiday-' prefix. The various calendar systems have secondary
624prefixes, eg `calendar-french-'. The old names you are likely to use
625directly still exist, for the time being, as aliases, but please start
626using the new names.
627
a43a8a2e 628+++
e889393b
GM
629*** The whitespace in the calendar layout can be customized.
630See the variables:
631calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
632calendar-day-header-width, and calendar-day-digit-width.
633
a43a8a2e 634+++
e889393b
GM
635*** Text (e.g. ISO weeks) can be displayed between the calendar months.
636See the variables calendar-intermonth-header and calendar-intermonth-text.
637
a43a8a2e 638+++
09e18d03
CY
639*** The function `holiday-chinese' computes holidays on the Chinese calendar.
640It has been used to add items to the list `holiday-oriental-holidays'.
641
a43a8a2e 642---
09e18d03
CY
643*** `diary-remind' accepts a negative number -DAYS as a shorthand for
644the list (1 2 ... DAYS).
24cdde13 645
a6b85944
CY
646** Change Log mode
647
648*** The new command C-c C-f (change-log-find-file) finds the file
649associated with the current log entry.
650
651*** The new command C-c C-c (change-log-goto-source) goes to the
652source code associated with a log entry.
653
76be286d
DN
654** Compile and grep modes
655
656*** The mode-line entry for the *compilation* and *grep* buffer is color coded.
657It has different colors for to show that: (a) the command is still
658running, (b) successful completion, (c) error.
659
660*** compilation-auto-jump-to-first-error tells `compile' to jump to
813fb3fe
SM
661the first error encountered during compilations.
662
0b22a5e1
DN
663*** The `cc' alias for C++ files in `grep-file-aliases' has been
664improved. `hh' can be used to match C++ header files and `cchh' both
665C++ sources and headers.
666
d332a7a4
GM
667** Copyright
668
669*** You can specify your copyright holders' names.
670Only copyright lines with holders matching `copyright-names-regexp' are
671considered for update.
672
673*** Copyrights can be at the end of the buffer.
674This is controlled by `copyright-at-end-flag' (used by, e.g., change-log-mode).
675
09e18d03 676** Custom
b68769f2 677+++
09e18d03 678*** defcustom accepts new keyword arguments, `:safe' and `:risky', which
b68769f2
GM
679set a variable's `safe-local-variable' and `risky-local-variable' property.
680
09e18d03 681** Diff mode
38b627ce 682
09e18d03
CY
683*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
684It's used automatically as you move through hunks, see
7381be9d 685diff-auto-refine-mode. It is bound to `C-c C-b'.
b58a65fa 686
09e18d03
CY
687*** diff-add-change-log-entries-other-window iterates through the diff
688buffer and tries to create ChangeLog entries for each change.
689It is bound to `C-x 4 A'.
f3ff0fe9 690
d332a7a4
GM
691*** The new function `diff-show-trailing-whitespaces' shows
692trailing whitespace problems in the modified lines of a diff buffer.
693
71554a21
JL
694** Dired
695
696*** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
697and C-x C-q in wdired-mode exits it with asking a question about
698saving changes.
699
d1949cd5
JL
700*** `&' runs the command `dired-do-async-shell-command' that executes
701the command asynchronously without the need to manually add ampersand
702to the end of the command. Its output appears in the buffer `*Async Shell
703Command*'.
704
6d9f0d00
JL
705*** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names.
706When a new user option `dired-isearch-filenames' is non-nil, then even
707ordinary Isearch started with `C-s' and `C-M-s' matches only at file names
e94d0645
JL
708in the Dired buffer. You can toggle file names matching on or off
709by typing `M-s f' in Isearch mode.
6d9f0d00 710
cc3236e1
JL
711*** `M-s a C-s' and `M-s a M-C-s' run multi-file Isearch on the marked files.
712They visit the first marked file in the sequence and display the usual Isearch
713prompt for a string or a regexp where all Isearch commands are available.
714
71554a21
JL
715*** `Q' in Dired provides two new keys for multi-file replacement.
716The upper case key `Y' replaces all remaining matches in all remaining files
717with no more questions. The upper case key `N' stops doing replacements
718in the current file and skips to the next file. These multi-file keys
719are available for all commands that use `tags-query-replace'
720including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
721`reftex-query-replace-document'.
722
09e18d03 723** Fortran
77a00355
GM
724+++
725*** The line length of fixed-form Fortran is not fixed at 72 any more.
726Customize the variable `fortran-line-length' to change it.
117d3cc5 727
87aae241 728+++
09e18d03
CY
729*** In Fortran mode, M-; is now bound to the standard comment-dwim,
730rather than fortran-indent-comment.
76be286d 731
09e18d03
CY
732+++
733*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
b592c357 734
09e18d03 735** Gnus
6653c6b7 736
09e18d03
CY
737*** The Gnus package has been updated
738There are many news features, bug fixes and improvements; see the file
739GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
db86064f 740
09e18d03
CY
741*** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
742saving articles drafts and ~/.newsrc.eld. These file may not be read
743correctly in Emacs 22 and below. If you want to Gnus across different Emacs
744versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
15947a44 745
6d496c76
TZ
746*** Password are consistently loaded through `auth-source'
747Gnus can use `auth-source' for POP and IMAP passwords. Also see that
748`smtpmail' and `url' support `auth-source' for SMTP and HTTP/HTTPS/RSS
749authentication respectively.
750
09e18d03
CY
751** Help mode
752*** New macro `with-help-window' should set up help windows better
753than `with-output-to-temp-buffer' with `print-help-return-message'.
754*** New option `help-window-select' permits to customize whether help
755window shall be automatically selected when invoking help.
756*** New variable `help-window-point-marker' permits to specify new
757position of point in help window (for example in `view-lossage').
15947a44 758
09e18d03 759** Isearch
15947a44 760
4f75e082
JL
761*** New command `isearch-forward-word' bound globally to `M-s w' starts
762incremental word search. New command `isearch-toggle-word' bound to the
763same key `M-s w' in Isearch mode toggles word searching on or off
764while Isearch is active.
765
766*** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch
767mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current
768search string as its regexp argument. The same key `M-s h r' and
769other keys on the `M-s h' prefix are bound globally to the command
770`highlight-regexp' and other hi-lock commands.
f45acc9d 771
4f75e082
JL
772*** New command `isearch-occur' bound to `M-s o' in Isearch mode
773runs `occur' with the current search string. The same key `M-s o'
774is bound globally to the command `occur'.
15947a44 775
4f75e082
JL
776*** Isearch can now search through multiple ChangeLog files.
777When running Isearch in a ChangeLog file, if the search fails,
09e18d03
CY
778then another C-s tries searching the previous ChangeLog,
779if there is one (e.g. go from ChangeLog to ChangeLog.12).
babc4609 780This is enabled if multi-isearch-search is non-nil.
93a142e1 781
babc4609 782*** Two new commands to start Isearch on a list of marked buffers
cc3236e1
JL
783for buff-menu.el and ibuffer.el are bound to the keys `M-s a C-s' and
784`M-s a M-C-s'.
15947a44 785
4f75e082 786*** The part of an Isearch that failed to match is highlighted in `isearch-fail'
09e18d03 787face.
5d503af9 788
4f75e082
JL
789*** `C-h C-h' in Isearch mode displays isearch-specific Help screen,
790`C-h b' displays all Isearch key bindings, `C-h k' displays the full
791documentation of the given Isearch key sequence, `C-h m' displays
792documentation of Isearch mode. All the rest Help commands exit Isearch mode
09e18d03 793and execute their global definitions.
332de56f 794
09e18d03
CY
795*** When started in the minibuffer, Isearch searches in the minibuffer
796history. See `Minibuffer changes', above.
2793c9bb 797
66863844
BW
798+++
799** MH-E
1e9b0fb2 800
66863844
BW
801*** Upgraded to MH-E version 8.1. See MH-E-NEWS for details.
802
09e18d03
CY
803** Python
804*** The file etc/emacs.py now supports both Python 2 and 3, meaning
805that either version can be used as inferior Python by python.el.
c5578d5f 806
09e18d03
CY
807*** Python mode now has `pdbtrack' functionality. When using pdb to
808debug a Python program, pdbtrack notices the pdb prompt and displays
809the source file and line that the program is stopped at, much the same
810way as gud-mode does for debugging C programs with gdb.
2793c9bb 811
1e9b0fb2
MA
812** Recentf
813
814*** The default value of `recentf-keep' prevents from checking of
815remote files, if there is no established connection to the
816corresponding remote host.
817
09e18d03 818** T-mouse Mode
2793c9bb 819
09e18d03
CY
820*** If the gpm mouse server is running and t-mouse-mode is enabled,
821Emacs uses a Unix socket in a GNU/Linux console to talk to server,
822rather than faking events using the client program mev. This C level
823approach provides mouse highlighting and help echoing in the
824minibuffer.
2793c9bb 825
cc213f24
MA
826+++
827** Tramp
828
829*** New connection methods.
830The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
831been introduced. There are also new so-called gateway methods
832"tunnel" and "socks".
833
834*** Multihop syntax has been removed.
835The pseudo-method "multi" has been removed. Instead of, multi hops
836can be specified by the new variable `tramp-default-proxies-alist'.
837
838*** More default settings.
839Default values can be set via the variables `tramp-default-user',
840`tramp-default-user-alist' and `tramp-default-host'.
841
842*** Connection information is cached.
843In order to reduce connection setup, information about used
844connections are kept persistent in a file. The name of this file is
845defined in the variable `tramp-persistency-file-name'.
846
847*** Control of remote processes.
848Running processes on a remote host can be controlled by settings in
849`tramp-remote-path' and `tramp-remote-process-environment'.
850
851*** Success of remote copy is checked.
852When the variable `file-precious-flag' is set, the success of a remote
853file copy is checked via the file's checksum.
854
7cba69f2
MA
855*** Passwords can be read from an authentification file.
856Tramp uses the package `auth-source' to read passwords from a file, if
857necessary.
858
289aee1c 859** VC and related modes
95d8772f 860
09e18d03
CY
861*** VC now supports applying VC operations to a set of files at a time.
862This enables VC to work much more effectively with changeset-oriented
863version-control systems such as Subversion, GNU Arch, Mercurial, Git
864and Bzr. VC will now pass a multiple-file commit to these systems as
865a single changeset.
d15f7b68 866
09e18d03 867*** vc-dir is a new command that displays file names and their VC
289aee1c
DN
868status. It allows to apply various VC operations to a file, a
869directory or a set of files/directories.
c3f01f42 870
09e18d03 871*** Clicking on the VC mode-line entry now pops the VC menu.
4c24d241 872
09e18d03 873*** The VC mode-line entry now has a tooltip that explains the VC file status.
d15f7b68 874
09e18d03
CY
875*** In VC Annotate mode, for VC systems that support changesets, you can
876see the diff for the whole changeset (not only for the current file)
e86fa02b 877by typing the D key.
a9f480e8 878
e86fa02b 879*** In VC Annotate mode, you can type v to toggle the annotation visibility.
2fb6c6be 880
09e18d03
CY
881*** In VC Annotate mode, you can type f to show the file revision on
882the current line.
d5d381e2 883
e86fa02b
DN
884*** In VC Annotate mode, for VC systems that support changesets, you
885can see the diff for the whole changeset (not only for the current
886file) by typing the D key or using the "Show changeset diff of
887revision at line" menu entry.
888
09e18d03
CY
889*** Asynchronous VC commands display [Waiting...] in the mode-line
890of the corresponding buffer as long as the asynchronous process is
891active.
cf944fa4 892
09e18d03
CY
893*** Log entries can be modified using the key "e" in log-view.
894For now only CVS, RCS, SCCS and SVN support this functionality.
895This is done by the `modify-change-comment' backend function.
143cecdb 896
09e18d03
CY
897*** In log-view-mode, for VC systems that support changesets, you can
898see the diff for the whole changeset (not only for the current file)
899by typing the D key or using the "Changeset Diff" menu entry.
cf944fa4 900
289aee1c
DN
901*** In Log Edit mode, C-c C-d now shows the diff for the files involved.
902
903*** vc-git supports the "git grep" command.
904
09e18d03
CY
905*** VC Support for Meta-CVS has been removed for lack of maintainer able
906to update it to the new VC.
cf944fa4 907
d15f7b68
GM
908** Miscellaneous
909
910*** comint-mode uses `start-file-process' now (see Lisp Changes).
cc213f24
MA
911If `default-directory' is a remote file name, subprocesses are started
912on the corresponding remote system.
913
09e18d03
CY
914*** Eldoc highlights the function argument under point
915with the face `eldoc-highlight-function-argument'.
4596901f 916
09e18d03 917*** In Etags, the --members option is now the default.
fffa137c 918Use --no-members if you want the old default behavior of not tagging
09e18d03 919struct members in C, members variables in C++ and variables in PHP.
1752e205 920
09e18d03
CY
921*** The `gdb' command only works with the graphical interface now.
922Use `gud-gdb' if you want the (old) text command mode.
923
924*** goto-address.el provides two new minor modes, goto-address-mode and
925goto-address-prog-mode, which buttonize URLS and email addresses.
926
927*** The new command `eshell/info' runs info in an eshell buffer.
3cf86f00 928
4d1e89e3
GM
929*** The new variable `ffap-rfc-directories' specifies a list of local
930directories in which `ffap-rfc' will first search for RFCs.
931
09e18d03
CY
932*** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
933See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
934
935*** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
936
937*** Info displays breadcrumbs in the header of the page.
938See Info-breadcrumbs-depth to control it.
939
d2c98acc 940*** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
b7bfcc8a 941It is used to configure wireless interfaces.
d2c98acc 942
09e18d03
CY
943*** The pcmpl-unix package supports hostname completion for ssh and scp.
944
945*** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
946
947*** smerge-refine highlights word-level details of changes in conflict.
7381be9d
TTN
948It's used automatically as you move through conflicts, see
949smerge-auto-refine-mode.
09e18d03
CY
950
951*** talk.el has been extended for multiple tty support.
952
953*** A new command `display-time-world' has been added to the Time
954package. It creates a buffer with an updating time display using
955several time zones.
956
957*** The appearance of superscript and subscript in TeX is more customizable.
958See the documentation of the variables: tex-fontify-script,
959tex-font-script-display, tex-suscript-height-ratio, and
960tex-suscript-height-minimum.
961
962*** view-remove-frame-by-deleting is now by default t
963since users found iconification of view-mode frames distracting.
964
965*** WoMan tries to add locale-specific manual page directories to the
966search path. This can be disabled by setting `woman-locale' to nil.
967
0bfd685e
GM
968\f
969* Changes in Emacs 23.1 on non-free operating systems
8ab314f9 970
203553fd
JPW
971** Case is now considered significant in completion on MS-Windows.
972The default value of `completion-ignore-case' is now nil on
973MS-Windows, the same as it is for other operating systems. The
974variable doesn't apply to reading a file name -- in that case Emacs
975heeds `read-file-name-completion-ignore-case' instead.
976
672f99b6
JR
977---
978** IPv6 is supported on MS-Windows.
979Emacs now supports IPv6 on Windows XP and later, and earlier versions
2660a9da 980of Windows with third party IPv6 stacks installed. In Emacs 22, IPv6 was
672f99b6
JR
981supported on other platforms, but not on Windows due to using the winsock
9821.1 header file, even though Emacs was linking to the winsock 2 library.
983
0d22595d 984---
6e344060
JR
985** Busy cursor (hourglass) now displays on MS-Windows.
986When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
2660a9da
JR
987In Emacs 22 only X supported the busy cursor.
988
989---
990** Battery status is available on MS-Windows
991Emacs can now display the battery status in the mode-line when enabled with
992display-battery-mode or from the Options menu. More verbose battery
993information is also available with the command `battery'. In Emacs 22
994battery status was supported only on GNU/Linux and Mac.
6e344060 995
3280c5c5
JR
996** More keys available on MS-Windows.
997Keys normally associated with IMEs, and some exotic keys not normally found
998on standard keyboards have been given names so they can be bound to functions
999inside Emacs. If there are keys on your keyboard that have not been exposed
1000to Emacs in the past, try C-h k to see if they are available now.
1001
1002Emacs can now bind functions to the extra buttons for media player and
1003browser control present on some keyboards. These buttons are disabled
1004by default, since enabling them prevents their system-wide use when
1005Emacs has focus. To enable them, set the variable
0caa490b 1006w32-pass-multimedia-buttons to nil. See the doc string of that variable
3280c5c5 1007for the list of extra keys that are available.
2660a9da 1008
4a263588
JR
1009** BDF fonts no longer supported on MS-Windows.
1010The font backend was completely rewritten for this release. The focus
1011on Windows has been getting acceptable performance and full unicode
1012support, including complex script shaping for native Windows fonts. A
1013rewrite of the BDF font support has not happened due to lack of time
1014and developers. If demand still exists for such a backend even with
1015the improved language support for native Windows fonts, future
1016development in this direction will most likely be based on the
1017freetype library, giving access to a wider range of font formats.
1018
0bfd685e
GM
1019\f
1020* Incompatible Lisp Changes in Emacs 23.1
8ec65cd7 1021
fd9440c5 1022** Variables cannot be both buffer-local and frame-local any more.
a9b08254 1023
fc944cd4 1024** `functionp' returns nil for special forms.
65f81a0b 1025I.e., it only returns t for objects that can be passed to `funcall'.
fc944cd4 1026
d82c3d44
GM
1027** The behavior of map-char-table has changed. It may call the
1028specified function with a cons (FROM . TO) as a key if characters in
1029that range have the same value.
1030
b350bdf2
CY
1031** Process changes
1032+++
1033*** The function `dired-call-process' has been removed.
03605a28 1034+++
b350bdf2
CY
1035*** The multibyteness of process filters is now determined by the
1036coding-system used for decoding. The functions
1037`process-filter-multibyte-p' and `set-process-filter-multibyte' are
1038obsolete.
03605a28 1039
87aae241 1040---
777ea444 1041** The variable `byte-compile-warnings' can now be a list starting with `not',
0caa490b 1042meaning to disable the specified warnings. The meaning of this list
777ea444 1043may therefore be the reverse of what you expect (of course, this is
0caa490b 1044only an issue if you make use of the new `not' syntax). Rather than
777ea444
GM
1045checking/manipulating elements directly, use the new functions
1046`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
1047`byte-compile-enable-warning.'
1048
69df9d6d
GM
1049** `mode-name' is no longer guaranteed to be a string.
1050Use `(format-mode-line mode-name)' to ensure a string value.
1051
b350bdf2
CY
1052** Internationalization changes
1053
1054*** The value of the function `charset-id' is now always 0.
1055
1056*** The functions `register-char-codings' and `coding-system-spec'
1057have been removed.
1058
1059*** The cpXXX coding systems are now supported automatically.
1060The functions cp-...-codepage, which you had to use in Emacs 22 to
1061enable support for these coding systems, have been deleted.
1062
1063*** The following features have been removed. They were used for
85a1f98d
GM
1064displaying various scripts with specific fonts, and are no longer
1065needed now that OpenType font support is available:
1066
b350bdf2 1067**** `devanagari' and `devan-util', and all associated devanagari-* and
85a1f98d
GM
1068dev-* functions and variables (formerly used for Devanagari script).
1069
b350bdf2 1070**** `kannada' and `knd-util', and all associated kannada-* and knd-*
85a1f98d
GM
1071functions and variables (formerly used for Kannada script).
1072
b350bdf2 1073**** `malayalam' and `mlm-util', and all associated malayalam-* and
85a1f98d
GM
1074mlm-* functions and variables (formerly used for Malayalam script).
1075
b350bdf2 1076**** `tamil' and `tml-util, and all associated tamil-* and tml-*
85a1f98d 1077functions and variables (formerly used for Tamil script).
6a6b4d7d 1078
0bfd685e
GM
1079\f
1080* Lisp Changes in Emacs 23.1
8ab314f9 1081
5d692341
EZ
1082** New primitives `list-system-processes' and `system-process-attributes'
1083let Lisp programs access the processes that are running on the local
1084machine. See the doc strings of these functions for more details.
1085Not all platforms support accessing this information; on those that
1086don't, these primitives will return nil.
1087
b350bdf2
CY
1088+++
1089** New variable `user-emacs-directory'.
1090Use this instead of "~/.emacs.d".
43f8b275 1091
b350bdf2
CY
1092** If a local hook function has a non-nil `permanent-local-hook'
1093property, `kill-all-local-variables' does not remove it from the local
1094value of the hook variable; it remains even if you change major modes.
09e18d03 1095
b350bdf2
CY
1096** `frame-inherited-parameters' lets new frames inherit parameters from
1097the selected frame.
09e18d03 1098
b350bdf2
CY
1099** New keymap `input-decode-map' overrides like key-translation-map, but
1100applies before function-key-map. Also it is terminal-local contrary to
1101key-translation-map. Terminal-specific key-sequences are generally added to
1102this map rather than to function-key-map now.
09e18d03 1103
b350bdf2 1104** `ignore-errors' is now a standard macro (does not require the CL package).
09e18d03 1105
b350bdf2
CY
1106** `interprogram-paste-function' can now return one string or a list
1107of strings. In the latter case, Emacs puts the second and following
1108strings on the kill ring.
09e18d03 1109
b350bdf2
CY
1110+++
1111** In `condition-case', a handler can specify "let the debugger run first".
1112You do this by writing `debug' in the list of conditions to be handled,
1113like this:
09e18d03 1114
b350bdf2
CY
1115 (condition-case nil
1116 (foo bar)
1117 ((debug error) nil))
09e18d03 1118
b350bdf2 1119** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
09e18d03 1120
b350bdf2
CY
1121** `beginning-of-defun-function' now takes one argument, the count
1122given to `beginning-of-defun'.
09e18d03 1123
b350bdf2
CY
1124+++
1125** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
1126IDENTIFICATION specifies which part of the remote identifier has to be
1127returned. With CONNECTED passed non-nil, it is checked whether a
1128remote connection has been established already.
09e18d03 1129
87aae241 1130+++
b350bdf2
CY
1131** The new macro `declare-function' suppresses compiler warnings about
1132undefined functions.
a1562258 1133
b350bdf2 1134** Changes to interactive function handling
8ba31f36 1135
b350bdf2
CY
1136*** The new interactive spec code ^ says to first call
1137handle-shift-selection if shift-select-mode is non-nil, before reading
1138the command arguments. This is used for shift-selection (see above).
e2947429 1139
b350bdf2
CY
1140*** Built-in functions can now have an interactive specification that
1141is not a prompt string. If the `intspec' parameter of a `DEFUN'
1142starts with a `(', the string is evaluated as a Lisp form.
e2947429 1143
b350bdf2
CY
1144*** The interactive-form of a function can be added post-facto via the
1145`interactive-form' symbol property. Mostly useful to add complex
1146interactive forms to subroutines.
d87be1df 1147
b350bdf2 1148** Region changes
3ae459e5 1149
b350bdf2
CY
1150*** Commands should use `use-region-p' to test whether there is
1151an active region that they should operate on.
3ae459e5 1152
b350bdf2
CY
1153*** `region-active-p' returns non-nil when Transient Mark mode is
1154enabled and there is an active region. This is NOT the best function
1155to use to test whether a command should operate on the region instead
1156of the usual behavior -- for that, use `use-region-p'.
58555d81 1157
b350bdf2
CY
1158*** If a command sets `transient-mark-mode' to (only . OLDVAL), that
1159means to activate transient-mark-mode temporarily, until the next
1160unshifted point motion command or mark deactivation. Afterwards,
1161reset transient-mark-mode to the value OLDVAL. The values `only' and
1162`identity', introduced in Emacs 22, are now deprecated.
e5c4079c 1163
b350bdf2 1164** Emacs session information
13cda5f9 1165
b350bdf2
CY
1166*** The new variables `before-init-time' and `after-init-time' record the
1167value of `current-time' before and after Emacs loads the init files.
a2bc5bdd 1168
b350bdf2 1169*** The new function `emacs-uptime' returns the uptime of an Emacs instance.
d82c3d44 1170
b350bdf2
CY
1171*** The new function `emacs-init-time' returns the duration of the
1172Emacs initialization.
50bfa18a 1173
b350bdf2 1174** Changes affecting display-buffer
39d0bf74 1175
b350bdf2
CY
1176*** New value nil for split-height-threshold inhibits vertical splitting
1177unless there's no other window.
59b5d020 1178
b350bdf2 1179*** New option split-width-threshold controls horizontal splitting.
426e6ba0 1180
b350bdf2 1181*** A window can be split horizontally even when it's not full-width.
426e6ba0 1182
b350bdf2
CY
1183*** New option split-window-preferred-function can be set to a function
1184to override the default splitting mechanism of display-buffer.
2d105adf 1185
b350bdf2 1186** Minibuffer and completion changes
b9694062 1187+++
b350bdf2 1188*** A list of default values can be specified for the DEFAULT argument of
b9694062
JL
1189functions `read-from-minibuffer', `read-string', `read-command',
1190`read-variable', `read-buffer', `completing-read'. Elements of this list
1191are available for inserting into the minibuffer by typing `M-n'.
1192For empty input these functions return the first element of this list.
1193
90993beb 1194*** New function `read-regexp' uses the regexp history and some useful
4f75e082 1195regexp defaults (string at point, last Isearch/replacement regexp/string)
90993beb
JL
1196via M-n when reading a regexp in the minibuffer.
1197
b350bdf2
CY
1198*** minibuffer-local-must-match-filename-map is now named
1199minibuffer-local-filename-must-match-map.
66dc1ca2 1200
b350bdf2
CY
1201*** `all-completions' may now return the base size in the last cdr.
1202Since this means the returned list is not properly nil-terminated, this
1203is an incompatible change and is thus enabled by the new variable
1204completion-all-completions-with-base-size.
66dc1ca2 1205
b350bdf2
CY
1206*** The `require-match' argument to `completing-read' accepts a new value
1207`confirm-only'.
d03b9b31 1208
b350bdf2
CY
1209** Search and replacement changes
1210+++
1211*** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
1212+++
1213*** New function `match-substitute-replacement' returns the result of
1214`replace-match' without actually using it in the buffer.
c60d543d 1215
b350bdf2
CY
1216*** The new variable `replace-search-function' determines the function
1217to use for searching in query-replace and replace-string.
3ae459e5 1218
b350bdf2
CY
1219*** The new variable `replace-re-search-function' determines the
1220function to use for searching in `query-replace-regexp',
1221`replace-regexp', `query-replace-regexp-eval', and
1222`map-query-replace-regexp'.
4f4a84ec 1223
4f75e082
JL
1224*** New keymap `search-map' bound to `M-s' provides global bindings
1225for search related commands.
1226
1227*** New keymap `multi-query-replace-map' contains additonal keys bound
71554a21
JL
1228to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
1229
b350bdf2
CY
1230*** The variable `inhibit-changing-match-data', if non-nil, prevents
1231the search and match primitives from changing the match data.
967b2682 1232
b350bdf2 1233** File handling changes
8bf5c8a6 1234
b350bdf2
CY
1235*** set-file-modes is now interactive and can take the mode value in
1236symbolic notation thanks to auxiliary functions.
d9774611 1237
b350bdf2
CY
1238*** If you set find-file-confirm-nonexistent-file to t, then C-x C-f
1239requires confirmation before opening a non-existent file.
1240
1241** Process changes
1242+++
1243*** The new function `start-file-process' is similar to `start-process',
1244but obeys file handlers. The file handler is chosen based on
1245`default-directory'. The functions `start-file-process-shell-command'
1246and `process-file-shell-command' are also new; they call internally
1247`start-file-process' and `process-file', respectively.
1248
1249*** The new function `process-lines' executes an external program and
1250returns its output as a list of lines.
63571b5a 1251
d82c3d44
GM
1252** Character code, representation, and charset changes.
1253
0caa490b 1254The character code space is now 0x0..0x3FFFFF with no gap.
d82c3d44
GM
1255Characters of code 0x0..0x10FFFF are Unicode characters of the same code points.
1256Characters of code 0x3FFF80..0x3FFFFF are raw 8-bit bytes.
1257
0caa490b 1258Generic characters no longer exist.
d82c3d44 1259
b350bdf2
CY
1260In buffers and strings, characters are represented by UTF-8 byte
1261sequences in a multibyte buffer/string.
d82c3d44 1262
b350bdf2
CY
1263The concept of a charset has changed. A single character may belong
1264to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
1265unicode, iso-8859-1, iso-8859-3, etc).
d82c3d44
GM
1266
1267*** The functions `encode-char' and `decode-char' now accept any character sets.
1268
1269*** The function `define-charset' now accepts a completely different
1270form of arguments (old-style arguments still work).
1271
d82c3d44
GM
1272*** The value of the function `char-charset' depends on the current
1273priorities of charsets.
1274
d82c3d44
GM
1275*** The function get-char-code-property now accepts many Unicode base
1276character properties. They are `name', `general-category',
1277`canonical-combining-class', `bidi-class', `decomposition',
1278`decimal-digit-value', `digit-value', `numeric-value', `mirrored',
1279`old-name', `iso-10646-comment', `uppercase', `lowercase', and
1280`titlecase'.
1281
b350bdf2
CY
1282*** The functions `modify-syntax-entry' and `modify-category-entry' now
1283accept a cons of characters as the first argument, and modify all
1284entries in that range of characters.
d82c3d44 1285
b350bdf2
CY
1286+++
1287*** `translation-table-for-input' is now obsolete.
d82c3d44 1288
b350bdf2 1289*** New functions:
d82c3d44 1290
b350bdf2
CY
1291**** `characterp' returns t if and only if the argument is a character.
1292This replaces `char-valid-p', which is now obsolete.
d82c3d44 1293
b350bdf2 1294**** `max-char' returns the maximum character code (currently #x3FFFFF).
d82c3d44 1295
b350bdf2
CY
1296**** `define-charset-alias' defines an alias of a charset.
1297
1298**** `set-charset-priority' sets priorities of charsets.
1299
1300**** `charset-priority-list' returns a prioritized list of charsets.
1301
1302**** `unibyte-string' makes a unibyte string from bytes.
1303
1304**** `define-char-code-property' defines a character code property.
1305
1306**** `char-code-property-description' returns the description string of
1307a character code property.
1308
1309*** New variables:
1310
7082ceb2
CY
1311**** file-local-variables-alist stores an alist of file-local
1312variables defined in the current buffer.
1313
b350bdf2
CY
1314**** `find-word-boundary-function-table' is a char-table of functions to
1315search for a word boundary.
1316
1317**** `char-script-table' is a char-table of script names.
1318
1319**** `char-width-table' is a char-table of character widths.
1320
1321**** `print-charset-text-property' controls how to handle `charset' text
1322property on printing a string.
1323
1324**** `printable-chars' is a char-table of printable characters.
d82c3d44 1325
505d8756 1326** Code conversion changes
d82c3d44
GM
1327
1328*** The new function `define-coding-system' should be used to define a
1329coding system instead of `make-coding-system' (which is now obsolete).
1330
1331*** The functions `encode-coding-region' and `decode-coding-region'
1332have an optional 4th argument to specify where the result of
1333conversion should go.
1334
1335*** The functions `encode-coding-string' and `decode-coding-string'
1336have an optional 4th argument specifying a buffer to store the result
1337of conversion.
1338
b350bdf2 1339*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
d82c3d44 1340
b350bdf2 1341*** New functions:
d82c3d44 1342
b350bdf2
CY
1343**** `with-coding-priority' executes Lisp code using the specified
1344coding system priority order.
d82c3d44 1345
b350bdf2
CY
1346**** `check-coding-systems-region' checks if the text in the region is
1347encodable by the specified coding systems.
d82c3d44 1348
b350bdf2 1349**** `coding-system-aliases' returns a list of aliases of a coding system.
d82c3d44 1350
b350bdf2
CY
1351**** `coding-system-charset-list' returns a list of charsets supported
1352by a coding system.
d82c3d44 1353
b350bdf2
CY
1354**** `coding-system-priority-list' returns a list of coding systems
1355ordered by their priorities.
1356
1357**** `set-coding-system-priority' sets priorities of coding systems.
d82c3d44
GM
1358
1359** There is a new input method, Robin, different from Quail.
0caa490b 1360It has three functionalities:
d82c3d44
GM
1361 i) a simple input method (converts an ASCII sequence into a string).
1362ii) converts an existing buffer substring into another string
1363iii) reverse conversion (each character produced by a
1364robin rule can hold the original ASCII sequence as a char-code-property)
1365
1366*** The new function `robin-define-package' defines a Robin package.
1367
1368*** The new function `robin-modify-package' modifies an existing Robin package.
1369
1370*** The new function `robin-use-package' starts using a Robin package
1371as an input method.
1372
888d7d86
KH
1373*** The new function `string-to-unibyte' is like `string-as-unibyte'
1374but signals an error if STRING contains a non-ASCII, non-eight-bit
1375character.
1376
505d8756 1377** Changes related to the new font backend
2b7a2553 1378
b19aa6dd
GM
1379Which font backends to use can be specified by the X resource "FontBackend".
1380For instance, to use both X core fonts and Xft fonts:
2b7a2553 1381
b19aa6dd 1382Emacs.FontBackend: x,xft
2b7a2553 1383
b19aa6dd
GM
1384If this resource is not set, Emacs tries to use all font backends
1385available on your graphic device.
d82c3d44
GM
1386
1387*** New frame parameter `font-backend' specifies a list of
1388font-backends supported by the frame's graphic device. On X, they are
1389currently `x' and `xft'.
1390
b350bdf2
CY
1391*** The function `set-fontset-font' now accepts a script name as the
1392second argument, and has an optional 5th argument to control how to
1393set the font.
d82c3d44 1394
b350bdf2 1395*** New functions:
d82c3d44 1396
b350bdf2 1397**** `fontp' checks if the argument is a font-spec or font-entity.
d82c3d44 1398
b350bdf2 1399**** `font-spec' creates a new font-spec object.
d54b8954 1400
b350bdf2 1401**** `font-get' returns a font property value.
d82c3d44 1402
b350bdf2 1403**** `font-put' sets a font property value.
d82c3d44 1404
b350bdf2 1405**** `font-face-attributes' returns a plist of face attributes set by a font.
d82c3d44 1406
b350bdf2 1407**** `list-fonts' returns a list of font-entities matching a font spec.
d82c3d44 1408
b350bdf2 1409**** `font-font' returns the font-entity best matching the given font spec.
d82c3d44 1410
b350bdf2 1411**** `list-families' returns a list of family names of available fonts.
d82c3d44 1412
b350bdf2
CY
1413**** `font-xlfd-name' returns an XLFD name of a given font spec, font
1414entity, or font object.
1415
1416**** `clear-font-cache' clears all font caches.
d82c3d44 1417
b350bdf2 1418** Changes related to multiple-terminal (multi-tty) support
24cdde13 1419
b12f6e85
SM
1420*** $TERM is now set to `dumb' for subprocesses. If you want to know the
1421$TERM inherited by Emacs you will have to look inside initial-environment.
1422
6168122d
SM
1423*** $DISPLAY is now dynamically inherited from the frame's `display'.
1424
b350bdf2 1425*** The `window-system' variable is now frame-local. The new
24cdde13 1426`initial-window-system' variable contains the `window-system' value
bbe3eb99
GM
1427for the first frame. `window-system' is also now a function that
1428takes a frame argument.
24cdde13 1429
b350bdf2
CY
1430*** The `keyboard-translate-table' variable and the terminal and
1431keyboard coding systems are now terminal-local.
1432
24cdde13
GM
1433*** You can specify a terminal device (`tty' parameter) and a terminal
1434type (`tty-type' parameter) to `make-terminal-frame'.
1435
24cdde13
GM
1436*** The function `make-frame-on-display' now works during a tty
1437session, and `make-frame-on-tty' works during a graphical session.
1438
419f8f49
SM
1439*** A new data type for terminals with functions: `get-device-terminal',
1440`terminal-parameters', `terminal-parameter', `set-terminal-parameter'.
24cdde13 1441
b350bdf2
CY
1442*** Function key sequences are now mapped using `local-function-key-map',
1443a new variable. This inherits from the global variable function-key-map,
1444which is not used directly any more.
92cd6a7c 1445
b350bdf2 1446*** New hooks:
da406961 1447
7082ceb2
CY
1448**** before-hack-local-variables-hook is called after setting new
1449variable file-local-variables-alist, and before actually applying the
1450file-local variables.
1451
b350bdf2
CY
1452**** `suspend-tty-functions' and `resume-tty-functions' are called
1453after a tty frame has been suspended or resumed, respectively. The
1454functions are called with the terminal id of the frame being
1455suspended/resumed as a parameter.
da406961 1456
b350bdf2
CY
1457**** The special hook `delete-terminal-functions' is called before
1458deleting a terminal.
82866ad5 1459
b350bdf2 1460*** New functions:
24cdde13 1461
b350bdf2 1462**** `environment'
24cdde13 1463
b350bdf2 1464**** `make-frame-on-tty' creates a new frame on another tty device.
24cdde13 1465
b350bdf2 1466**** `delete-tty'
9f44d41a 1467
b350bdf2 1468**** `suspend-tty'
ea2e3ef4 1469
b350bdf2 1470**** `resume-tty'.
8d371994 1471
b350bdf2 1472*** `initial-environment' holds the environment inherited from Emacs's parent.
8d371994 1473
b350bdf2 1474** Redisplay changes
8d371994 1475
b350bdf2
CY
1476*** For underlined characters, the distance between the underline and
1477the baseline is controlled by a new variable, `underline-minimum-offset'.
0a963185 1478
b350bdf2
CY
1479*** You can now pass the value of the `invisible' property to
1480invisible-p to check whether it would cause the text to be invisible.
1481Convenient when checking invisibility of text with no buffer position
1482(e.g. in before/after-strings).
c69b0314 1483
b350bdf2 1484*** `clear-image-cache' can be told to flush only images of a specific file.
9f44d41a 1485
0c8b58e9
CY
1486*** `vertical-motion' can now be given a goal column.
1487It now accepts a cons cell (COLS . LINES) in its first argument, which
1488says to stop, where possible, at a pixel x-position equal to COLS
1489times the default column width.
1490
9ac64acd
CY
1491** The Lisp interpreter now treats non-breaking space as whitespace.
1492
b350bdf2 1493** Miscellaneous new functions
9f44d41a 1494
b350bdf2
CY
1495*** `format-seconds' converts a number of seconds into a readable
1496string of days, hours, etc.
9f44d41a 1497
b350bdf2 1498*** `apply-partially' performs a "curried" application of a function.
abf13a8b 1499
b350bdf2
CY
1500*** `read-shell-command' does what its name says, with completion. It
1501uses the minibuffer-local-shell-command-map for that.
b2b387f9 1502
b350bdf2
CY
1503*** `buffer-swap-text' swaps text between two buffers. This can be
1504useful for modes such as tar-mode, archive-mode, RMAIL.
967b2682 1505
b350bdf2
CY
1506*** `read-color' reads a color name using the minibuffer.
1507
1508*** `face-all-attributes' returns an alist describing all the basic
1509attributes of a given face.
1510
1511*** `window-full-width-p' returns t if a window is as wide as its
1512frame.
1513
1514*** `split-string-and-unquote' does (what?)
1515
1516*** `combine-and-quote-strings' does (what?)
1517
1518*** `image-refresh' refreshes all images associated with a given image
1519specification.
64639e26 1520
b350bdf2 1521*** The two new functions `looking-at-p' and `string-match-p' can do
45595a4f
RS
1522the same matching as `looking-at' and `string-match' without changing
1523the match data.
89835619 1524
81efacf9
CY
1525*** The two new functions `make-serial-process' and
1526`serial-process-configure' provide a Lisp interface to the new serial
1527port support (see Emacs changes, above).
1528
b350bdf2
CY
1529** Miscellaneous new variables
1530
1531*** `this-command-keys-shift-translated' is non-nil if the key
1532sequence invoking the current command was found by shift-translation.
1533
1534*** `window-point-insertion-type' determines the insertion-type of the
1535marker used for window-point.
1536
1537*** bookmark provides `bookmark-make-record-function' so special major
1538modes like Info can teach bookmark.el how to save and restore the
1539relevant data.
1540
1541*** `next-error-recenter' specifies how next-error should recenter the
1542visited source file. Its value can be a number (for example, 0 for
1543top line, -1 for bottom line), or nil for no recentering.
1544
1545*** `fill-forward-paragraph-function' specifies which function the
1546filling code should use to find paragraph boundaries.
1547
1548*** `custom-note-var-changed' tells Custom to treat the change in a
1549certain variable as having been made within Custom.
1550
9bae34bf 1551\f
0bfd685e 1552* New Packages for Lisp Programming in Emacs 23.1
efeb796b 1553
b350bdf2
CY
1554** The new package avl-tree.el deals with the AVL tree data structure.
1555
87aae241 1556+++
b350bdf2
CY
1557** The new package check-declare.el verifies the accuracy of
1558declare-function macros (see Lisp Changes, above).
d445b3f8 1559
20202f5e 1560** find-cmd.el can build `find' commands using lisp syntax.
6dfcbe31 1561
babc4609
JL
1562** The package misearch.el has been added. It allows Isearch to search
1563through multiple buffers. A variable `multi-isearch-next-buffer-function'
1564defines the function to call to get the next buffer to search in the series
1565of multiple buffers. Top-level commands `multi-isearch-buffers',
1566`multi-isearch-buffers-regexp', `multi-isearch-files' and
1567`multi-isearch-files-regexp' accept a single argument that specifies
1568a list of buffers/files to search for a string/regexp.
9097e8af 1569
b350bdf2
CY
1570** The new major mode `special-mode' is intended as a parent for
1571major modes such as those that set the "'mode-class 'special" property.
d53a60a6 1572
05197f40 1573\f
a933dad1 1574----------------------------------------------------------------------
5b87ad55 1575This file is part of GNU Emacs.
a933dad1 1576
ab73e885 1577GNU Emacs is free software: you can redistribute it and/or modify
5b87ad55 1578it under the terms of the GNU General Public License as published by
ab73e885
GM
1579the Free Software Foundation, either version 3 of the License, or
1580(at your option) any later version.
5b87ad55
GM
1581
1582GNU Emacs is distributed in the hope that it will be useful,
1583but WITHOUT ANY WARRANTY; without even the implied warranty of
1584MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1585GNU General Public License for more details.
a933dad1 1586
5b87ad55 1587You should have received a copy of the GNU General Public License
ab73e885 1588along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
a933dad1 1589
05197f40 1590\f
a933dad1
DL
1591Local variables:
1592mode: outline
1593paragraph-separate: "[ \f]*$"
1594end:
ab5796a9 1595
a533413c 1596arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2