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