(set-mark-command): Deactivate mark on second C-SPC C-SPC
[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
GM
29** The default X toolkit is now Gtk+, rather than Lucid.
30
2b7a2553
GM
31** The new configuration option "--enable-font-backend" enables new code
32for handling fonts by multiple backends (the old font handling codes
33still exist). This requires the freetype and fontconfig libraries, and
34supports local fonts (fonts installed on the machine where Emacs is running).
35Additionally, the Xft library can be used for antialiasing support.
36Fontconfig-like font names (e.g. monospace-12) are also accepted.
37
1abe3a1e
DN
38** The new configuration option "--with-dbus" enables D-Bus language
39bindings for Emacs.
40
15f02f65
GM
41** The Mac Carbon port is no longer supported.
42Instead, use... [what?]
43
9d3cc9b2
GM
44** configure now checks for libgif before libungif when searching for
45a GIF library.
b5ac89f8 46
36e625ec
GM
47** Support for systems without alloca has been removed.
48
07e5c0b0
DN
49** Support for Sun windows has been removed.
50
bb9f7948
EZ
51** Support for many obsolete platforms has been removed.
52See the list at the end of etc/MACHINES for details.
53
48a8be40
GM
54** The `emacstool' utility has been removed.
55
a46ee55c
GM
56** The configure options `--with-gcc', `--without-gcc' have been removed.
57Configure will use gcc by default. Set the CC environment variable if
58you need control over which C compiler is used.
59
60** The configure option `--with-gtk' has been removed. Gtk is now the
61default toolkit, but you can use --with-x-toolkit=gtk if necessary.
4e5cdb4f 62\f
6dadd99f
NR
63* Changes in Emacs 23.1
64
780d7bb9 65** Emacs now supports using both X displays and ttys in one session.
1abe3a1e
DN
66Start the server (M-x server-start). Then `emacsclient -t' creates a
67tty frame connected to the running emacs server. You can also use any
68number of different ttys. `emacsclient -c' creates a new X11 frame on
69the current $DISPLAY or a tty frame if $DISPLAY is not set.
780d7bb9
RS
70
71You can test for the presence of this feature in your Lisp code by
72testing for the `multi-tty' feature.
73
d82c3d44
GM
74** The Emacs character set is now a superset of Unicode.
75(It has about four times the code space, which should be plenty).
76
77The internal encoding used for buffers and strings is now
78Unicode-based and called `utf-8-emacs'. utf-8-emacs is backwards
79compatible with the UTF-8 encoding of Unicode. The `emacs-mule'
80coding system can still read and write data in the old internal encoding.
81
82Since the internal encoding is also used by default for byte-compiled
83files -- i.e. the normal coding system for byte-compiled Lisp files is
84now utf-8-Emacs -- Lisp containing non-ASCII characters which is
85compiled by Emacs 23 can't be read by earlier versions of Emacs. Files
86compiled by Emacs 20, 21, or 22 are loaded correctly as emacs-mule
87(whether or not they contain multibyte characters), which makes loading
88them somewhat slower than Emacs 23-compiled files. Thus it may be worth
89recompiling existing .elc files which don't need to be shared with older
90Emacsen.
91
d82c3d44
GM
92** There are assorted new coding systems/aliases -- see M-x list-coding-systems.
93
94** There is a new charset implementation with many new charsets.
95See M-x list-character-sets. New charsets can be defined conveniently
96as tables of unicodes.
97
98The dimension of a charset is now 1, 2, 3, or 4, and the size of each
99dimension is no longer limited to 94 or 96.
100
101A dynamic charset priority list is used to infer the charset of
102characters for display.
103
19095422
KH
104** There are new Chinese-GBK, Chinese-GB18030, Khmer, Bengali,
105Punjabi, Gujarati, Oriya, Telugu, Sinhala, and TaiViet language
d82c3d44
GM
106environments.
107
7b476dbe
JD
108** Emacs now supports the XEmbed specification.
109You can embed Emacs in another application on X11. The new command line option
110--parent-id is used to pass the parent window id to Emacs. See
111http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
112for details about XEmbed.
113
251ad2de
TTN
114** Emacs comes with a new set of icons for Mac OS X.
115OS-X-style icons (an application icon and a relevant document icon)
116were contributed by Kentaro Ohkouchi.
117Source files for these icons can be found in Emacs.app/Contents/Resources.
1518e9a1 118PNG versions are available as etc/images/icons/emacs*_mac.png.
251ad2de 119
f664fee9
MC
120** Built-in functions (subr) can now have an interactive specification
121that is not a prompt string. If the `intspec' parameter of a `DEFUN'
122starts with a `(', the string is evaluated as a Lisp form.
123
124** set-file-modes is now interactive and can take the mode value in
125symbolic notation thanks to auxiliary functions.
126
90ab5c62
SM
127** split-window-preferred-function specifies whether display-buffer should
128split windows vertically or horizontally.
129
24cdde13
GM
130** Emacsclient has been extended to support opening a new terminal
131frame. Its behavior has been changed to open a new Emacs frame by
132default. Use the -c option to get the old behavior of opening files in
133the currently selected Emacs frame.
134
c0dadae9
MC
135** The refcards are now shipped as PDF files.
136
795a2a94
GM
137** Emacs now supports the SVG image format through librsvg2.
138
6d25a312
SM
139** C-SPC C-SPC in transient-mark-mode pushes a mark without activating it.
140
a2b84f35
DN
141** transient-mark-mode is now enabled by default.
142
75f6af19 143** If you set find-file-confirm-nonexistent-file to t, then C-x C-f
0a963185
SM
144requires confirmation before opening a non-existent file.
145
6dadd99f
NR
146** If the gpm mouse server is running and t-mouse-mode enabled, Emacs uses a
147Unix socket in a GNU/Linux console to talk to server, rather than faking events
148using the client program mev. This C level approach provides mouse
149highlighting, and help echoing in the minibuffer.
150
c2e8590b
TTN
151** The new variable next-error-recenter specifies how next-error should
152recenter the visited source file. Its value can be a number (for example,
1530 for top line, -1 for bottom line), or nil for no recentering.
154
1abe3a1e
DN
155** New command recenter-top-bottom moves the current line to window
156center, top and bottom on successive invokations.
157
eb28688c
GM
158** C-l is bound to the new command recenter-top-bottom, rather than recenter.
159
d87b5ced 160** The mode-line displays a `@' if the default-directory for the current buffer
1f2e1c75 161is on a remote machine, or a hyphen otherwise.
6c5d503f 162
c9447ae1
GM
163** The mode-line displays a mode menu when mouse-1 is clicked on a minor mode,
164in the same way as it already did for major modes.
165
de3054d5 166** The new command balance-windows-area balances windows both vertically
62e3c31f 167and horizontally.
d466e9fc
SM
168
169** The new command close-display-connection can be used to close a connection
170to a remote display, e.g. because the display is about to become unreachable.
6c5d503f
MA
171
172** The command shell prompts for the default directory, when it is
173called with a prefix, and the default directory is a remote file name.
de3054d5 174This is because some file name handlers (like ange-ftp) are not able to
6c5d503f 175run processes remotely.
aff2ba04
RS
176
177** The new command `display-time-world' starts an updating time display
178using several time zones, in a buffer.
c4c9b6f9 179
5c4a15b3
GM
180** The new function `format-seconds' converts a number of seconds into a
181readable string of days, hours, etc.
182
9f871ce2
GM
183** The new variables `before-init-time' and `after-init-time' record the
184value of `current-time' before and after Emacs loads the init files.
c4c9b6f9
GM
185
186** The new function `emacs-uptime' returns the uptime of an Emacs instance.
187
b3cf10d7
JL
188** The new function `emacs-init-time' returns the duration of the
189Emacs initialization.
190
d82c3d44
GM
191** The minor modes unify-8859-on-encoding-mode, unify-8859-on-decoding-mode
192are obsolete.
193
6dadd99f 194\f
0bfd685e 195* Startup Changes in Emacs 23.1
21f7b9d8 196
56e1896b
JL
197** New user option `initial-buffer-choice' specifies what to display
198after starting Emacs: startup screen, *scratch* buffer, visiting a
199file or directory.
200
aa5310e4
DK
201** New alias `argv' for `command-line-args-left'
202This is a convenience alias, so that one can write `(pop argv)'
203inside of --eval command line arguments in order to access
204following arguments.
f8fd7ed3
GM
205
206** The abbrev file is no longer read at startup in batch mode.
c44da964 207\f
0bfd685e 208* Incompatible Editing Changes in Emacs 23.1
b58cb59f 209
117907d4
JL
210+++
211** In Dired-x, all command guesses for ! are now added to the default
212list accessible by M-n instead of pushing all guesses temporarily into
213the history list.
214
406c0f12 215\f
0bfd685e 216* Editing Changes in Emacs 23.1
406c0f12 217
59b5d020
JL
218+++
219** C-M-% now shows replacement as it would look in the buffer, with
220`\N' and `\&' substituted according to the match. Old behavior can be
221restored by customizing `query-replace-show-replacement'.
222
1ac03a31
JL
223+++
224** M-q now fills the region if the region is active and
225`transient-mark-mode' is turned on. Otherwise, it fills the current
ecde850a 226paragraph.
1ac03a31 227
ecde850a 228+++
dc868f13
JL
229** M-$ now checks spelling of the region if the region is active and
230`transient-mark-mode' is turned on. Otherwise, it checks spelling of the
231word at point.
232
6dd697d9
DN
233** TAB now indents the region if the region is active and
234`transient-mark-mode' is turned on.
235
d03b9b31
RS
236** `use-empty-active-region' controls whether an empty active region
237in Transient Mark mode should make commands operate on that empty region.
238
24cdde13
GM
239** C-z now invokes `suspend-frame', C-x C-c now invokes
240`save-buffers-kill-terminal'.
241
a151f82c
SS
242** New command kill-matching-buffers kills buffers whose name matches a regexp.
243
63571b5a
RS
244** You can disable kill ring commands from accessing the primary selection
245by setting `x-select-enable-primary' to nil.
246
247** If `select-active-regions' is t, setting the mark automatically
248makes the new region into the primary selection (for interaction with
249other window applications). If you enable this, you might want to bind
250`mouse-yank-primary' to Mouse-2.
539f5bda 251
4496b02b
RS
252** If `yank-pop-change-selection' is t, rotating the kill ring
253also updates the selection or clipboard to the current yank,
254just as M-w would do so with the text it copies to the kill ring.
255
297b8ccd
JL
256** Minibuffer changes:
257
dc2f6c05
JL
258*** In C-x d, if you type M-n you get the visited file name of the
259current buffer.
260
117907d4
JL
261*** In Dired, a list of commands for ! extracted from mailcap according to
262file extensions are added to the default list accessible by M-n.
263
264*** A list of regexp default values is available via M-n for `occur',
265`keep-lines', `flush-lines' and `how-many'. This list includes the active
266region in transient-mark-mode, the word under the cursor, the last isearch
267regexp, the last isearch string and the last replacement regexp.
268
297b8ccd
JL
269*** isearch started in the minibuffer searches in the minibuffer history.
270Reverse isearch commands (C-r, C-M-r) search in previous minibuffer
271history elements, and forward isearch commands (C-s, C-M-s) search in
272next history elements. When the reverse search reaches the first history
273element, it wraps to the last history element, and the forward search
274wraps to the first history element. When the search is terminated, the
275history element containing the search string becomes the current.
276
0bfd685e
GM
277\f
278* New Modes and Packages in Emacs 23.1
0091c67e 279
2e282009
GM
280** FIXME add details of new packages imported from lisp/gnus.
281
1816bda7
MC
282** The package doc-view.el has been added. It supports viewing of PDF,
283PostScript and DVI documents inside an Emacs buffer by converting the
284document to a set of PNG images first. One can also search for a
285regular expression in the document. The commentary of the file explains
286its usage.
287
c06c430f
MO
288** The nXML package has been added. It is a new mode for editing XML
289documents. nXML mode allows a schema to be associated with the XML
290document being edited. nXML mode uses Relax NG as its schema
291language. The schema is used to provide two key features:
292
293*** Continuous validation. nXML validates as you type, highlighting
294any invalid parts of your document.
295
296*** Completion. nXML can assist you in entering an element name,
297attribute name or data value by using information about what is
298allowed by the schema in that context.
a2e0b5dd 299
0329d8a3
GM
300** A new game called `bubbles' has been added. This is a version of
301the "Same Game" with configurable difficulty level.
a0818148 302
dcd6e8d7 303** minibuffer-indicate-depth-mode shows the minibuffer depth in the prompt.
3f7194ed 304
15f3eb73
MO
305** Remember Mode (remember.el) is now included with Emacs. It is a
306mode for quickly jotting down things to remember. Included with
307remember.el is a backend that can save notes to a Diary file. Please
308consult the Remember Manual for usage details.
309
9264ee6a
MA
310** D-Bus language bindings for Elisp are provided by the package
311dbus.el and by extensions to the C modules of Emacs. D-Bus is an
312inter-process communication mechanism for applications residing on the
313same host, based on messages. See the manual for further details.
c154c0be 314
c6588a85
MO
315** EasyPG is now part of the Emacs distribution. It is an all-in-one
316GnuPG interface which includes GnuPG keyring browser, cryptographic
317operations on regions and files, and automatic encryption of *.gpg
318files. See the EasyPG Assistant User's Manual for further details.
e11910e2 319
c06c430f
MO
320** json.el is now included with Emacs. It is a library for parsing
321and generating JSON (JavaScript Object Notation). JSON is a
322lightweight data-interchange format.
323
e11910e2
GM
324** Auto Composition Mode is a minor mode that composes characters
325automatically when they are displayed. It is globally on by default.
326It uses `auto-composition-function' (default `auto-compose-chars').
327
0bfd685e
GM
328\f
329* Changes in Specialized Modes and Packages in Emacs 23.1
61d244ca 330
429d5f08
GM
331** In Change Log mode, the new function `change-log-find-file', bound to
332C-c C-f, finds the file associated with the current log entry.
e8cbfb8d 333
e047f448
SM
334** abbrev was rewritten in Elisp and extended with more flexibility.
335*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
336 abbrev-table-p.
337*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
338*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
339 extra arguments for arbitrary properties.
340*** New variable `abbrev-minor-mode-table-alist'.
341*** `local-abbrev-table' can hold a list of abbrev-tables.
342*** Abbrevs have now the following special properties:
79415279 343 `:count', `:system', `:enable-function', `:case-fixed'.
e047f448
SM
344*** Abbrev-tables have now the following special properties:
345 `:parents', `:case-fixed', `:enable-function', `:regexp',
346 `abbrev-table-modiff'.
347
0253fffa
MR
348** Help mode.
349*** New macro `with-help-window' should set up help windows better
350than `with-output-to-temp-buffer' with `print-help-return-message'.
351*** New option `help-window-select' permits to customize whether help
352window shall be automatically selected when invoking help.
353*** New variable `help-window-point-marker' permits to specify new
b0d2d4e8 354position of point in help window (for example in `view-lossage').
0253fffa
MR
355
356** view-remove-frame-by-deleting is now by default t
b0d2d4e8 357since users found iconification of view-mode frames distracting.
0253fffa 358
bafbec39
JL
359** Isearch mode
360
361*** New command `isearch-occur' bound to `M-s o' in isearch mode
362runs `occur' with the current search string.
363
364*** isearch can now search through multiple ChangeLog files.
12bbb989
JL
365When running isearch in a ChangeLog file, if the search fails,
366then another C-s tries searching the previous ChangeLog,
367if there is one (e.g. go from ChangeLog to ChangeLog.12).
368
9097e8af
RS
369This is enabled if isearch-buffers-multi is non-nil.
370
4c24d241
GM
371*** The part of an isearch that failed to match is highlighted in `isearch-fail'
372face.
373
c3bb6fdb
SM
374** smerge-refine highlights word-level details of changes in conflict.
375It's used automatically as you move through conflicts, see smerge-auto-refine.
376
25e50a58
DN
377** Diff mode
378
379*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
380It's used automatically as you move through hunks, see
381diff-auto-refine. It is bound to `C-c C-b'.
382
e7940cb5
DN
383*** diff-add-change-log-entries-other-window iterates through the diff
384buffer and tries to create ChangeLog entries for each change.
385It is bound to `C-x 4 A'.
c3bb6fdb 386
e6a01e4e 387** archive-mode has basic support to browse Rar archives.
c3bb6fdb 388
24cdde13
GM
389** talk.el has been extended for multiple tty support.
390
813fb3fe
SM
391** compilation-auto-jump-to-first-error tells `compile' to jump to
392the first error encountered during compilations.
393
b68769f2 394** In the `copyright' package, you can specify your copyright holders' names.
b649d2e4
SM
395Only copyright lines with holders matching copyright-names-regexp will be
396considered for update.
397
e7ce8577
GM
398** eldoc highlights the function argument under point
399with the face `eldoc-highlight-function-argument'.
400
ef6d86b5
MR
401** hide-ifdef-mode permits to shadow ifdef-blocks instead of hiding them.
402See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
403
b68769f2 404+++
8d5cc579 405** defcustom accepts new keyword arguments, `:safe' and `:risky', which
b68769f2
GM
406set a variable's `safe-local-variable' and `risky-local-variable' property.
407
b0d2d4e8
FP
408** Etags changes.
409*** The --members option is now the default.
410
411Use --no-members if you want the old default behaviour of not tagging
412struct members in C, members variables in C++ and variables in PHP.
413
56dada42 414** VC
397c4757
DN
415*** Clicking on the VC mode-line entry now pops the VC menu.
416
9372a958 417*** The VC mode-line entry now has a tooltip that explains the VC file status.
cb223bba 418
082c5622
DN
419*** VC now supports applying VC operations to a set of files at a time.
420
4a11b6b5
ER
421This enables VC to work much more effectively with changeset-oriented
422version-control systems such as Subversion, GNU Arch, Mercurial, and
423Bzr. VC will now pass a multiple-file commit to these systems
424as a single changeset.
425
b58a65fa
TTN
426*** In VC Annotate mode, you can type V to toggle the annotation visibility.
427
f3ff0fe9
DN
428*** In VC Annotate mode, you can type f to show the file revision on
429the current line.
430
93a142e1
DN
431** log-edit now has a command bound to C-c C-d to show the diff for
432the files involved.
433
5d503af9
SM
434** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
435
332de56f
GM
436** The appearance of superscript and subscript in TeX is more customizable.
437See the documentation of the variables: tex-fontify-script,
438tex-font-script-display, tex-suscript-height-ratio, and
439tex-suscript-height-minimum.
440
2793c9bb
RW
441** BibTeX mode:
442
c5578d5f
RW
443*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
444
2793c9bb
RW
445*** New `bibtex-entry-format' options `whitespace', `braces', and
446`string', disabled by default.
447
448*** New variable `bibtex-cite-matcher-alist' contains rules to
0f3cd6b2 449identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
2793c9bb 450
c5578d5f 451*** Command `bibtex-url' allows multiple URLs per entry.
2793c9bb 452
cc213f24
MA
453+++
454** Tramp
455
456*** New connection methods.
457The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
458been introduced. There are also new so-called gateway methods
459"tunnel" and "socks".
460
461*** Multihop syntax has been removed.
462The pseudo-method "multi" has been removed. Instead of, multi hops
463can be specified by the new variable `tramp-default-proxies-alist'.
464
465*** More default settings.
466Default values can be set via the variables `tramp-default-user',
467`tramp-default-user-alist' and `tramp-default-host'.
468
469*** Connection information is cached.
470In order to reduce connection setup, information about used
471connections are kept persistent in a file. The name of this file is
472defined in the variable `tramp-persistency-file-name'.
473
474*** Control of remote processes.
475Running processes on a remote host can be controlled by settings in
476`tramp-remote-path' and `tramp-remote-process-environment'.
477
478*** Success of remote copy is checked.
479When the variable `file-precious-flag' is set, the success of a remote
480file copy is checked via the file's checksum.
481
d15f7b68
GM
482** Miscellaneous programming mode changes
483
da26ea8d
GM
484*** The file etc/emacs.py now supports both Python 2 and 3, meaning
485that either version can be used as inferior Python by python.el.
c3f01f42 486
4c24d241
GM
487*** Python mode now has `pdbtrack' functionality. When using pdb to
488debug a Python program, pdbtrack notices the pdb prompt and displays
489the source file and line that the program is stopped at, much the same
490way as gud-mode does for debugging C programs with gdb.
491
d15f7b68
GM
492*** The variable `fortran-line-length' can change the fixed-form line-length.
493
a9f480e8
GM
494*** In Fortran mode, M-; is now bound to the standard comment-dwim,
495rather than fortran-indent-comment.
496
b68769f2
GM
497+++
498*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
2fb6c6be 499
cf944fa4
RS
500** Gnus package
501
502*** The Gnus package has been updated
503
504*** There are many news features, bug fixes and improvements.
505
506See the file GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
507
d15f7b68
GM
508** Miscellaneous
509
510*** comint-mode uses `start-file-process' now (see Lisp Changes).
cc213f24
MA
511If `default-directory' is a remote file name, subprocesses are started
512on the corresponding remote system.
513
d15f7b68 514*** C-x C-q in dired-mode now runs the command wdired-change-to-wdired-mode,
40aa8257
JL
515and C-x C-q in wdired-mode exits it with asking a question about
516saving changes.
d15f7b68 517
4596901f
GM
518*** The new command `eshell/info' runs info in an eshell buffer.
519
1752e205
GM
520*** The pcmpl-unix package supports hostname completion for ssh and scp.
521
3cf86f00
GM
522*** WoMan tries to add locale-specific manual page directories to the
523search path. This can be disabled by setting `woman-locale' to nil.
524
4d1e89e3
GM
525*** The new variable `ffap-rfc-directories' specifies a list of local
526directories in which `ffap-rfc' will first search for RFCs.
527
d2c98acc 528*** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
b7bfcc8a 529It is used to configure wireless interfaces.
d2c98acc 530
0bfd685e
GM
531\f
532* Changes in Emacs 23.1 on non-free operating systems
8ab314f9 533
672f99b6
JR
534---
535** IPv6 is supported on MS-Windows.
536Emacs now supports IPv6 on Windows XP and later, and earlier versions
537of Windows with third party IPv6 stacks installed. Previously IPv6 was
538supported on other platforms, but not on Windows due to using the winsock
5391.1 header file, even though Emacs was linking to the winsock 2 library.
540
3280c5c5
JR
541** More keys available on MS-Windows.
542Keys normally associated with IMEs, and some exotic keys not normally found
543on standard keyboards have been given names so they can be bound to functions
544inside Emacs. If there are keys on your keyboard that have not been exposed
545to Emacs in the past, try C-h k to see if they are available now.
546
547Emacs can now bind functions to the extra buttons for media player and
548browser control present on some keyboards. These buttons are disabled
549by default, since enabling them prevents their system-wide use when
550Emacs has focus. To enable them, set the variable
551w32-pass-multimedia-buttons to nil. See the doc string of that variable
552for the list of extra keys that are available.
0bfd685e
GM
553\f
554* Incompatible Lisp Changes in Emacs 23.1
8ec65cd7 555
d82c3d44
GM
556** The behavior of map-char-table has changed. It may call the
557specified function with a cons (FROM . TO) as a key if characters in
558that range have the same value.
559
560** The value of the function `charset-id' is now always 0.
561
562** The functions `register-char-codings' and `coding-system-spec'
563have been removed.
564
6a6b4d7d
KH
565** The cpXXX coding systems are now supported automatically. The
566functions cp-...-codepage, which you had to use in Emacs 22 to enable
567support for these coding systems, have been deleted.
d82c3d44 568
03605a28
MA
569+++
570** The function `dired-call-process' has been removed.
571
777ea444
GM
572** The variable `byte-compile-warnings' can now be a list starting with `not',
573meaning to disable the specified warnings. The meaning of this list
574may therefore be the reverse of what you expect (of course, this is
575only an issue if you make use of the new `not' syntax). Rather than
576checking/manipulating elements directly, use the new functions
577`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
578`byte-compile-enable-warning.'
579
69df9d6d
GM
580** `mode-name' is no longer guaranteed to be a string.
581Use `(format-mode-line mode-name)' to ensure a string value.
582
85a1f98d
GM
583** The following features have been removed. They were used for
584displaying various scripts with specific fonts, and are no longer
585needed now that OpenType font support is available:
586
587*** `devanagari' and `devan-util', and all associated devanagari-* and
588dev-* functions and variables (formerly used for Devanagari script).
589
590*** `kannada' and `knd-util', and all associated kannada-* and knd-*
591functions and variables (formerly used for Kannada script).
592
593*** `malayalam' and `mlm-util', and all associated malayalam-* and
594mlm-* functions and variables (formerly used for Malayalam script).
595
596*** `tamil' and `tml-util, and all associated tamil-* and tml-*
597functions and variables (formerly used for Tamil script).
6a6b4d7d 598
0bfd685e
GM
599\f
600* Lisp Changes in Emacs 23.1
8ab314f9 601
13cda5f9
SM
602** The new `buffer-swap-text' function can swap the text between two buffers.
603This can be useful for modes such as tar-mode, archive-mode, RMAIL.
604
a2bc5bdd
SM
605** `clear-image-cache' can be told to flush only images of a specific file.
606
64663f06 607** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
d82c3d44 608
50bfa18a 609** `beginning-of-defun-function' now takes one argument, the count
d82c3d44 610 given to `beginning-of-defun'.
50bfa18a 611
39d0bf74
RS
612** The variable `inhibit-changing-match-data', if non-nil, prevents the
613search and match primitives from changing the match data.
614
59b5d020
JL
615+++
616** New function `match-substitute-replacement' returns the result of
617`replace-match' without actually using it in the buffer.
618
2d105adf
RS
619** If a local hook function has a non-nil `permanent-local-hook'
620property, then `kill-all-local-variables' does not remove it from
621the local value of the hook variable. This means it remains
622even if you change major modes.
623
b9694062
JL
624+++
625** A list of default values can be specified for the DEFAULT argument of
626functions `read-from-minibuffer', `read-string', `read-command',
627`read-variable', `read-buffer', `completing-read'. Elements of this list
628are available for inserting into the minibuffer by typing `M-n'.
629For empty input these functions return the first element of this list.
630
66dc1ca2
RS
631** `custom-note-var-changed' tells Custom to treat the change in a certain
632variable as having been made within Custom.
633
ab6198b2
SM
634** `frame-inherited-parameters' lets new frames inherit parameters from
635the selected frame.
66dc1ca2 636
c60d543d 637** Commands should use `use-region-p' to test whether there is
d03b9b31
RS
638an active region that they should operate on.
639
c60d543d
RS
640** `region-active-p' returns non-nil when Transient Mark mode
641is enabled and there is an active region. This is NOT the best function
642to use to test whether a command should operate on the region instead
643of the usual behavior -- for that, use `use-region-p'.
644
4f4a84ec
SM
645** New keymap `input-decode-map' overrides like key-translation-map, but
646applies before function-key-map. Also it is terminal-local contrary to
647key-translation-map. Terminal-specific key-sequences are generally added to
648this map rather than to function-key-map now.
649
967b2682
GM
650** The new macro `declare-function' suppresses compiler warnings about
651undefined functions. The new `check-declare' package verifies that such
652statements are accurate (i.e. the functions are actually defined in
653the specified files).
654
d9774611
RS
655** The new function `read-color' reads a color name using the minibuffer.
656
833547aa
RS
657** The new function `face-all-attributes' returns an alist
658describing all the basic attributes of a given face.
659
63571b5a
RS
660** `interprogram-paste-function' can now return one string or a list
661of strings. In the latter case, Emacs puts the second and following
662strings on the kill ring.
663
d82c3d44
GM
664** Character code, representation, and charset changes.
665
666The character code space is now 0x0..0x3FFFFF with no gap.
667Characters of code 0x0..0x10FFFF are Unicode characters of the same code points.
668Characters of code 0x3FFF80..0x3FFFFF are raw 8-bit bytes.
669
670Generic characters no longer exist.
671
672In buffer and string, characters are represented by UTF-8 byte
673sequence in a multibyte buffer/string.
674
675The concept of a charset has changed. A single character may belong to
676multiple charsets (e.g. a-grave, U+00E0, belongs to charsets unicode,
677iso-8859-1, iso-8859-3, etc).
678
679*** The new function `characterp' returns t if and only if the argument
db4f9d2a 680is a character. This replaces `char-valid-p', which is now obsolete.
d82c3d44
GM
681
682*** The new function `max-char' returns the maximum character code
683(currently it is #x3FFFFF).
684
685*** The functions `encode-char' and `decode-char' now accept any character sets.
686
687*** The function `define-charset' now accepts a completely different
688form of arguments (old-style arguments still work).
689
690*** The new function `define-charset-alias' defines an alias of a charset.
691
692*** The value of the function `char-charset' depends on the current
693priorities of charsets.
694
695*** The new function `charset-priority-list' returns the list of
696charsets ordered by priority.
697
698*** The new function `set-charset-priority' sets priorities of charsets.
699
700*** The new function `unibyte-charset' returns the current unibyte
701charset. The unibyte charset determines how unibyte/multibyte
702conversion is done.
703
704*** The new function `set-unibyte-charset' sets the unibyte charset.
705
706*** The new function `unibyte-string' make a unibyte string from bytes.
707
708*** The new function `define-char-code-property' defines a character
709code property.
710
711*** The new function `char-code-property-description' returns the
712description string of a character code property.
713
714*** The function get-char-code-property now accepts many Unicode base
715character properties. They are `name', `general-category',
716`canonical-combining-class', `bidi-class', `decomposition',
717`decimal-digit-value', `digit-value', `numeric-value', `mirrored',
718`old-name', `iso-10646-comment', `uppercase', `lowercase', and
719`titlecase'.
720
721*** The new variable `find-word-boundary-function-table' is a
722char-table of functions to search for a word boundary.
723
724*** The new variable `char-script-table' is a char-table of script names.
725
726*** The new variable `char-width-table' is a char-table of character widths.
727
728*** The new variable `print-charset-text-property' controls how to
729handle `charset' text property on printing a string.
730
731*** The new variable `printable-chars' is a char-table defining if a
732character is printable or not.
733
734*** The functions `modify-syntax-entry' and `modify-category-entry' now
735accepts a cons of characters as the first argument, and modify all
736entries in that range of characters.
737
d82c3d44
GM
738** Code conversion changes.
739
740*** The new function `define-coding-system' should be used to define a
741coding system instead of `make-coding-system' (which is now obsolete).
742
743*** The functions `encode-coding-region' and `decode-coding-region'
744have an optional 4th argument to specify where the result of
745conversion should go.
746
747*** The functions `encode-coding-string' and `decode-coding-string'
748have an optional 4th argument specifying a buffer to store the result
749of conversion.
750
751*** The new function `with-coding-priority' executes the body part with
752the specified coding system priority order.
753
754*** The new function `check-coding-systems-region' checks if the text
755in the region is encodable by the specified coding systems.
756
757*** The new function `coding-system-aliases' returns a list of aliases
758of a coding system.
759
760*** The new function `coding-system-charset-list' returns a list of
761charsets supported by a coding system.
762
763*** The new function `coding-system-priority-list' returns a list of
764coding systems ordered by their priorities.
765
766*** The new function `set-coding-system-priority' sets priorities of
767coding systems.
768
769*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
770
771** There is a new input method, Robin, different from Quail.
772It has three functionalities:
773 i) a simple input method (converts an ASCII sequence into a string).
774ii) converts an existing buffer substring into another string
775iii) reverse conversion (each character produced by a
776robin rule can hold the original ASCII sequence as a char-code-property)
777
778*** The new function `robin-define-package' defines a Robin package.
779
780*** The new function `robin-modify-package' modifies an existing Robin package.
781
782*** The new function `robin-use-package' starts using a Robin package
783as an input method.
784
2b7a2553
GM
785** Changes related to the new font backend.
786
b19aa6dd
GM
787Which font backends to use can be specified by the X resource "FontBackend".
788For instance, to use both X core fonts and Xft fonts:
2b7a2553 789
b19aa6dd 790Emacs.FontBackend: x,xft
2b7a2553 791
b19aa6dd
GM
792If this resource is not set, Emacs tries to use all font backends
793available on your graphic device.
d82c3d44
GM
794
795*** New frame parameter `font-backend' specifies a list of
796font-backends supported by the frame's graphic device. On X, they are
797currently `x' and `xft'.
798
799*** New function `fontp' checks if the argument is a font-spec or font-entity.
800
801*** New function `font-spec' creates a new font-spec object.
802
803*** New function `font-get' returns a font property value.
804
805*** New function `font-put' sets a font property value.
806
807*** New function `list-fonts' returns a list of font-entities matching
808the given specification.
809
810*** New function `list-families' returns a list of family names of
811available fonts.
812
813*** New function `font-font' returns a font-entity best matching with
814the given specification.
815
816*** New function `font-xlfd-name' returns an XLFD name of a given font
817(font-spec, font-entity, or font-object).
818
819*** New function `clear-font-cache' clears all font caches.
820
821*** The function `set-fontset-font' now accepts a script name as the
822second argument, and has an optional 5th argument to control how to
823set the font.
824
24cdde13
GM
825** Changes related to multiple tty support.
826
b12f6e85
SM
827*** $TERM is now set to `dumb' for subprocesses. If you want to know the
828$TERM inherited by Emacs you will have to look inside initial-environment.
829
6168122d
SM
830*** $DISPLAY is now dynamically inherited from the frame's `display'.
831
24cdde13
GM
832*** The `window-system' variable has been made frame-local. The new
833`initial-window-system' variable contains the `window-system' value
834for the first frame.
835
836*** You can specify a terminal device (`tty' parameter) and a terminal
837type (`tty-type' parameter) to `make-terminal-frame'.
838
839*** The new function `make-frame-on-tty' allows you to create a new
840frame on another tty device interactively.
841
842*** The function `make-frame-on-display' now works during a tty
843session, and `make-frame-on-tty' works during a graphical session.
844
da406961 845*** New functions: `delete-tty', `suspend-tty', `resume-tty'.
24cdde13 846
419f8f49
SM
847*** A new data type for terminals with functions: `get-device-terminal',
848`terminal-parameters', `terminal-parameter', `set-terminal-parameter'.
24cdde13 849
1816bda7 850*** New hooks: `suspend-tty-functions' and `resume-tty-functions'
92cd6a7c 851are called after a tty frame has been suspended or resumed,
de3054d5 852respectively. The functions are called with the terminal id of the frame
92cd6a7c
DN
853being suspended/resumed as a parameter.
854
01ff458e 855*** New function: `environment'.
da406961 856
4f4a84ec 857*** New variable: `local-function-key-map'.
01ff458e
SM
858This in addition to the global function-key-map variable that
859already existed. The global variable is not used directly any more;
860instead, the local-function-key-map is initialized so as to inherit from
861function-key-map.
da406961 862
82866ad5
SM
863*** `initial-environment' holds the environment inherited from Emacs's parent.
864
24cdde13
GM
865*** The `keyboard-translate-table' variable and the terminal and
866keyboard coding systems have been made terminal-local.
867
1aa423e9
SM
868*** In addition to the global function-key-map, Emacs has terminal-local
869local-function-key-map variables, and uses them instead of the
24cdde13
GM
870global keymaps to set up translations and function key sequences
871relevant to a specific terminal device.
872
873
90ab5c62
SM
874** You can now also pass the value of the `invisible' property to invisible-p
875to check whether it would cause the text to be invisible. Convenient when
876checking invisibility of text which has no buffer position
877(e.g. in before/after-strings).
9f44d41a 878
ea2e3ef4
RS
879** Non-breaking space now acts as whitespace.
880
41bd52f7 881+++
8d371994
RS
882** In `condition-case', a handler can specify "let the debugger run first".
883
884You do this by writing `debug' in the list of conditions to be handled,
885like this:
886
887 (condition-case nil
888 (foo bar)
889 ((debug error) nil))
890
0a963185
SM
891** The `require-match' argument to `completing-read' accepts a new value
892`confirm-only'.
893
c69b0314
SM
894+++
895** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
896
9f44d41a
RS
897** New function `window-full-width-p' returns t if a window is as wide
898as its frame.
899
900** The new function `split-string-and-unquote' does (what?)
901
902** The new function `combine-and-quote-strings' does (what?)
903
904** The new function `image-refresh' refreshes all images associated
905with a given image specification.
906
abf13a8b
CY
907+++
908** New variable `user-emacs-directory'.
909Use this instead of "~/.emacs.d".
910
b2b387f9 911+++
0f3cd6b2 912** The new function `start-file-process' is similar to `start-process',
b2b387f9 913but obeys file handlers. The file handler is chosen based on
6dbe7eb4
MA
914`default-directory'. The functions `start-file-process-shell-command'
915and `process-file-shell-command' are also new; they call internally
0f3cd6b2 916`start-file-process' and `process-file', respectively.
b2b387f9 917
967b2682
GM
918** The new function `process-lines' executes an external program and
919returns its output as a list of lines.
920
64639e26 921+++
41bd52f7
MA
922** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
923IDENTIFICATION specifies which part of the remote identifier has to be
924returned. With CONNECTED passed non-nil, it is checked whether a
925remote connection has been established already.
64639e26 926
45595a4f
RS
927** The two new functions `looking-at-p' and `string-match-p' can do
928the same matching as `looking-at' and `string-match' without changing
929the match data.
89835619
SM
930
931** The interactive-form of a function can be added post-facto via the
932`interactive-form' symbol property. Mostly useful to add complex interactive
933forms to subroutines.
9bae34bf 934\f
0bfd685e 935* New Packages for Lisp Programming in Emacs 23.1
efeb796b 936
9097e8af
RS
937** The package isearch-multi.el has been added. It implements a new mode
938`isearch-buffers-minor-mode' that allows isearch to search through
939multiple buffers. In this mode a new variable
940`isearch-buffers-next-buffer-function' defines the function to call
941to get the next buffer to search in the series of multiple buffers.
942
d53a60a6
TTN
943** The new package avl-tree.el deals with the AVL tree data structure.
944
05197f40 945\f
a933dad1 946----------------------------------------------------------------------
5b87ad55 947This file is part of GNU Emacs.
a933dad1 948
5b87ad55
GM
949GNU Emacs is free software; you can redistribute it and/or modify
950it under the terms of the GNU General Public License as published by
64be3a42 951the Free Software Foundation; either version 3, or (at your option)
5b87ad55
GM
952any later version.
953
954GNU Emacs is distributed in the hope that it will be useful,
955but WITHOUT ANY WARRANTY; without even the implied warranty of
956MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
957GNU General Public License for more details.
a933dad1 958
5b87ad55
GM
959You should have received a copy of the GNU General Public License
960along with GNU Emacs; see the file COPYING. If not, write to the
961Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
962Boston, MA 02110-1301, USA.
a933dad1 963
05197f40 964\f
a933dad1
DL
965Local variables:
966mode: outline
967paragraph-separate: "[ \f]*$"
968end:
ab5796a9 969
a533413c 970arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2