(iwconfig-program, iwconfig-program-options): Add :version.
[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
0bfd685e
GM
526\f
527* Changes in Emacs 23.1 on non-free operating systems
8ab314f9 528
672f99b6
JR
529---
530** IPv6 is supported on MS-Windows.
531Emacs now supports IPv6 on Windows XP and later, and earlier versions
532of Windows with third party IPv6 stacks installed. Previously IPv6 was
533supported on other platforms, but not on Windows due to using the winsock
5341.1 header file, even though Emacs was linking to the winsock 2 library.
535
3280c5c5
JR
536** More keys available on MS-Windows.
537Keys normally associated with IMEs, and some exotic keys not normally found
538on standard keyboards have been given names so they can be bound to functions
539inside Emacs. If there are keys on your keyboard that have not been exposed
540to Emacs in the past, try C-h k to see if they are available now.
541
542Emacs can now bind functions to the extra buttons for media player and
543browser control present on some keyboards. These buttons are disabled
544by default, since enabling them prevents their system-wide use when
545Emacs has focus. To enable them, set the variable
546w32-pass-multimedia-buttons to nil. See the doc string of that variable
547for the list of extra keys that are available.
0bfd685e
GM
548\f
549* Incompatible Lisp Changes in Emacs 23.1
8ec65cd7 550
d82c3d44
GM
551** The behavior of map-char-table has changed. It may call the
552specified function with a cons (FROM . TO) as a key if characters in
553that range have the same value.
554
555** The value of the function `charset-id' is now always 0.
556
557** The functions `register-char-codings' and `coding-system-spec'
558have been removed.
559
6a6b4d7d
KH
560** The cpXXX coding systems are now supported automatically. The
561functions cp-...-codepage, which you had to use in Emacs 22 to enable
562support for these coding systems, have been deleted.
d82c3d44 563
03605a28
MA
564+++
565** The function `dired-call-process' has been removed.
566
777ea444
GM
567** The variable `byte-compile-warnings' can now be a list starting with `not',
568meaning to disable the specified warnings. The meaning of this list
569may therefore be the reverse of what you expect (of course, this is
570only an issue if you make use of the new `not' syntax). Rather than
571checking/manipulating elements directly, use the new functions
572`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
573`byte-compile-enable-warning.'
574
69df9d6d
GM
575** `mode-name' is no longer guaranteed to be a string.
576Use `(format-mode-line mode-name)' to ensure a string value.
577
85a1f98d
GM
578** The following features have been removed. They were used for
579displaying various scripts with specific fonts, and are no longer
580needed now that OpenType font support is available:
581
582*** `devanagari' and `devan-util', and all associated devanagari-* and
583dev-* functions and variables (formerly used for Devanagari script).
584
585*** `kannada' and `knd-util', and all associated kannada-* and knd-*
586functions and variables (formerly used for Kannada script).
587
588*** `malayalam' and `mlm-util', and all associated malayalam-* and
589mlm-* functions and variables (formerly used for Malayalam script).
590
591*** `tamil' and `tml-util, and all associated tamil-* and tml-*
592functions and variables (formerly used for Tamil script).
6a6b4d7d 593
0bfd685e
GM
594\f
595* Lisp Changes in Emacs 23.1
8ab314f9 596
64663f06 597** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
d82c3d44 598
50bfa18a 599** `beginning-of-defun-function' now takes one argument, the count
d82c3d44 600 given to `beginning-of-defun'.
50bfa18a 601
39d0bf74
RS
602** The variable `inhibit-changing-match-data', if non-nil, prevents the
603search and match primitives from changing the match data.
604
59b5d020
JL
605+++
606** New function `match-substitute-replacement' returns the result of
607`replace-match' without actually using it in the buffer.
608
2d105adf
RS
609** If a local hook function has a non-nil `permanent-local-hook'
610property, then `kill-all-local-variables' does not remove it from
611the local value of the hook variable. This means it remains
612even if you change major modes.
613
b9694062
JL
614+++
615** A list of default values can be specified for the DEFAULT argument of
616functions `read-from-minibuffer', `read-string', `read-command',
617`read-variable', `read-buffer', `completing-read'. Elements of this list
618are available for inserting into the minibuffer by typing `M-n'.
619For empty input these functions return the first element of this list.
620
66dc1ca2
RS
621** `custom-note-var-changed' tells Custom to treat the change in a certain
622variable as having been made within Custom.
623
ab6198b2
SM
624** `frame-inherited-parameters' lets new frames inherit parameters from
625the selected frame.
66dc1ca2 626
c60d543d 627** Commands should use `use-region-p' to test whether there is
d03b9b31
RS
628an active region that they should operate on.
629
c60d543d
RS
630** `region-active-p' returns non-nil when Transient Mark mode
631is enabled and there is an active region. This is NOT the best function
632to use to test whether a command should operate on the region instead
633of the usual behavior -- for that, use `use-region-p'.
634
4f4a84ec
SM
635** New keymap `input-decode-map' overrides like key-translation-map, but
636applies before function-key-map. Also it is terminal-local contrary to
637key-translation-map. Terminal-specific key-sequences are generally added to
638this map rather than to function-key-map now.
639
967b2682
GM
640** The new macro `declare-function' suppresses compiler warnings about
641undefined functions. The new `check-declare' package verifies that such
642statements are accurate (i.e. the functions are actually defined in
643the specified files).
644
d9774611
RS
645** The new function `read-color' reads a color name using the minibuffer.
646
833547aa
RS
647** The new function `face-all-attributes' returns an alist
648describing all the basic attributes of a given face.
649
63571b5a
RS
650** `interprogram-paste-function' can now return one string or a list
651of strings. In the latter case, Emacs puts the second and following
652strings on the kill ring.
653
d82c3d44
GM
654** Character code, representation, and charset changes.
655
656The character code space is now 0x0..0x3FFFFF with no gap.
657Characters of code 0x0..0x10FFFF are Unicode characters of the same code points.
658Characters of code 0x3FFF80..0x3FFFFF are raw 8-bit bytes.
659
660Generic characters no longer exist.
661
662In buffer and string, characters are represented by UTF-8 byte
663sequence in a multibyte buffer/string.
664
665The concept of a charset has changed. A single character may belong to
666multiple charsets (e.g. a-grave, U+00E0, belongs to charsets unicode,
667iso-8859-1, iso-8859-3, etc).
668
669*** The new function `characterp' returns t if and only if the argument
db4f9d2a 670is a character. This replaces `char-valid-p', which is now obsolete.
d82c3d44
GM
671
672*** The new function `max-char' returns the maximum character code
673(currently it is #x3FFFFF).
674
675*** The functions `encode-char' and `decode-char' now accept any character sets.
676
677*** The function `define-charset' now accepts a completely different
678form of arguments (old-style arguments still work).
679
680*** The new function `define-charset-alias' defines an alias of a charset.
681
682*** The value of the function `char-charset' depends on the current
683priorities of charsets.
684
685*** The new function `charset-priority-list' returns the list of
686charsets ordered by priority.
687
688*** The new function `set-charset-priority' sets priorities of charsets.
689
690*** The new function `unibyte-charset' returns the current unibyte
691charset. The unibyte charset determines how unibyte/multibyte
692conversion is done.
693
694*** The new function `set-unibyte-charset' sets the unibyte charset.
695
696*** The new function `unibyte-string' make a unibyte string from bytes.
697
698*** The new function `define-char-code-property' defines a character
699code property.
700
701*** The new function `char-code-property-description' returns the
702description string of a character code property.
703
704*** The function get-char-code-property now accepts many Unicode base
705character properties. They are `name', `general-category',
706`canonical-combining-class', `bidi-class', `decomposition',
707`decimal-digit-value', `digit-value', `numeric-value', `mirrored',
708`old-name', `iso-10646-comment', `uppercase', `lowercase', and
709`titlecase'.
710
711*** The new variable `find-word-boundary-function-table' is a
712char-table of functions to search for a word boundary.
713
714*** The new variable `char-script-table' is a char-table of script names.
715
716*** The new variable `char-width-table' is a char-table of character widths.
717
718*** The new variable `print-charset-text-property' controls how to
719handle `charset' text property on printing a string.
720
721*** The new variable `printable-chars' is a char-table defining if a
722character is printable or not.
723
724*** The functions `modify-syntax-entry' and `modify-category-entry' now
725accepts a cons of characters as the first argument, and modify all
726entries in that range of characters.
727
d82c3d44
GM
728** Code conversion changes.
729
730*** The new function `define-coding-system' should be used to define a
731coding system instead of `make-coding-system' (which is now obsolete).
732
733*** The functions `encode-coding-region' and `decode-coding-region'
734have an optional 4th argument to specify where the result of
735conversion should go.
736
737*** The functions `encode-coding-string' and `decode-coding-string'
738have an optional 4th argument specifying a buffer to store the result
739of conversion.
740
741*** The new function `with-coding-priority' executes the body part with
742the specified coding system priority order.
743
744*** The new function `check-coding-systems-region' checks if the text
745in the region is encodable by the specified coding systems.
746
747*** The new function `coding-system-aliases' returns a list of aliases
748of a coding system.
749
750*** The new function `coding-system-charset-list' returns a list of
751charsets supported by a coding system.
752
753*** The new function `coding-system-priority-list' returns a list of
754coding systems ordered by their priorities.
755
756*** The new function `set-coding-system-priority' sets priorities of
757coding systems.
758
759*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
760
761** There is a new input method, Robin, different from Quail.
762It has three functionalities:
763 i) a simple input method (converts an ASCII sequence into a string).
764ii) converts an existing buffer substring into another string
765iii) reverse conversion (each character produced by a
766robin rule can hold the original ASCII sequence as a char-code-property)
767
768*** The new function `robin-define-package' defines a Robin package.
769
770*** The new function `robin-modify-package' modifies an existing Robin package.
771
772*** The new function `robin-use-package' starts using a Robin package
773as an input method.
774
2b7a2553
GM
775** Changes related to the new font backend.
776
b19aa6dd
GM
777Which font backends to use can be specified by the X resource "FontBackend".
778For instance, to use both X core fonts and Xft fonts:
2b7a2553 779
b19aa6dd 780Emacs.FontBackend: x,xft
2b7a2553 781
b19aa6dd
GM
782If this resource is not set, Emacs tries to use all font backends
783available on your graphic device.
d82c3d44
GM
784
785*** New frame parameter `font-backend' specifies a list of
786font-backends supported by the frame's graphic device. On X, they are
787currently `x' and `xft'.
788
789*** New function `fontp' checks if the argument is a font-spec or font-entity.
790
791*** New function `font-spec' creates a new font-spec object.
792
793*** New function `font-get' returns a font property value.
794
795*** New function `font-put' sets a font property value.
796
797*** New function `list-fonts' returns a list of font-entities matching
798the given specification.
799
800*** New function `list-families' returns a list of family names of
801available fonts.
802
803*** New function `font-font' returns a font-entity best matching with
804the given specification.
805
806*** New function `font-xlfd-name' returns an XLFD name of a given font
807(font-spec, font-entity, or font-object).
808
809*** New function `clear-font-cache' clears all font caches.
810
811*** The function `set-fontset-font' now accepts a script name as the
812second argument, and has an optional 5th argument to control how to
813set the font.
814
24cdde13
GM
815** Changes related to multiple tty support.
816
b12f6e85
SM
817*** $TERM is now set to `dumb' for subprocesses. If you want to know the
818$TERM inherited by Emacs you will have to look inside initial-environment.
819
6168122d
SM
820*** $DISPLAY is now dynamically inherited from the frame's `display'.
821
24cdde13
GM
822*** The `window-system' variable has been made frame-local. The new
823`initial-window-system' variable contains the `window-system' value
824for the first frame.
825
826*** You can specify a terminal device (`tty' parameter) and a terminal
827type (`tty-type' parameter) to `make-terminal-frame'.
828
829*** The new function `make-frame-on-tty' allows you to create a new
830frame on another tty device interactively.
831
832*** The function `make-frame-on-display' now works during a tty
833session, and `make-frame-on-tty' works during a graphical session.
834
da406961 835*** New functions: `delete-tty', `suspend-tty', `resume-tty'.
24cdde13 836
419f8f49
SM
837*** A new data type for terminals with functions: `get-device-terminal',
838`terminal-parameters', `terminal-parameter', `set-terminal-parameter'.
24cdde13 839
1816bda7 840*** New hooks: `suspend-tty-functions' and `resume-tty-functions'
92cd6a7c 841are called after a tty frame has been suspended or resumed,
de3054d5 842respectively. The functions are called with the terminal id of the frame
92cd6a7c
DN
843being suspended/resumed as a parameter.
844
01ff458e 845*** New function: `environment'.
da406961 846
4f4a84ec 847*** New variable: `local-function-key-map'.
01ff458e
SM
848This in addition to the global function-key-map variable that
849already existed. The global variable is not used directly any more;
850instead, the local-function-key-map is initialized so as to inherit from
851function-key-map.
da406961 852
82866ad5
SM
853*** `initial-environment' holds the environment inherited from Emacs's parent.
854
24cdde13
GM
855*** The `keyboard-translate-table' variable and the terminal and
856keyboard coding systems have been made terminal-local.
857
1aa423e9
SM
858*** In addition to the global function-key-map, Emacs has terminal-local
859local-function-key-map variables, and uses them instead of the
24cdde13
GM
860global keymaps to set up translations and function key sequences
861relevant to a specific terminal device.
862
863
90ab5c62
SM
864** You can now also pass the value of the `invisible' property to invisible-p
865to check whether it would cause the text to be invisible. Convenient when
866checking invisibility of text which has no buffer position
867(e.g. in before/after-strings).
9f44d41a 868
ea2e3ef4
RS
869** Non-breaking space now acts as whitespace.
870
41bd52f7 871+++
8d371994
RS
872** In `condition-case', a handler can specify "let the debugger run first".
873
874You do this by writing `debug' in the list of conditions to be handled,
875like this:
876
877 (condition-case nil
878 (foo bar)
879 ((debug error) nil))
880
0a963185
SM
881** The `require-match' argument to `completing-read' accepts a new value
882`confirm-only'.
883
c69b0314
SM
884+++
885** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
886
9f44d41a
RS
887** New function `window-full-width-p' returns t if a window is as wide
888as its frame.
889
890** The new function `split-string-and-unquote' does (what?)
891
892** The new function `combine-and-quote-strings' does (what?)
893
894** The new function `image-refresh' refreshes all images associated
895with a given image specification.
896
abf13a8b
CY
897+++
898** New variable `user-emacs-directory'.
899Use this instead of "~/.emacs.d".
900
b2b387f9 901+++
0f3cd6b2 902** The new function `start-file-process' is similar to `start-process',
b2b387f9 903but obeys file handlers. The file handler is chosen based on
6dbe7eb4
MA
904`default-directory'. The functions `start-file-process-shell-command'
905and `process-file-shell-command' are also new; they call internally
0f3cd6b2 906`start-file-process' and `process-file', respectively.
b2b387f9 907
967b2682
GM
908** The new function `process-lines' executes an external program and
909returns its output as a list of lines.
910
64639e26 911+++
41bd52f7
MA
912** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
913IDENTIFICATION specifies which part of the remote identifier has to be
914returned. With CONNECTED passed non-nil, it is checked whether a
915remote connection has been established already.
64639e26 916
45595a4f
RS
917** The two new functions `looking-at-p' and `string-match-p' can do
918the same matching as `looking-at' and `string-match' without changing
919the match data.
89835619
SM
920
921** The interactive-form of a function can be added post-facto via the
922`interactive-form' symbol property. Mostly useful to add complex interactive
923forms to subroutines.
9bae34bf 924\f
0bfd685e 925* New Packages for Lisp Programming in Emacs 23.1
efeb796b 926
9097e8af
RS
927** The package isearch-multi.el has been added. It implements a new mode
928`isearch-buffers-minor-mode' that allows isearch to search through
929multiple buffers. In this mode a new variable
930`isearch-buffers-next-buffer-function' defines the function to call
931to get the next buffer to search in the series of multiple buffers.
932
d53a60a6
TTN
933** The new package avl-tree.el deals with the AVL tree data structure.
934
05197f40 935\f
a933dad1 936----------------------------------------------------------------------
5b87ad55 937This file is part of GNU Emacs.
a933dad1 938
5b87ad55
GM
939GNU Emacs is free software; you can redistribute it and/or modify
940it under the terms of the GNU General Public License as published by
64be3a42 941the Free Software Foundation; either version 3, or (at your option)
5b87ad55
GM
942any later version.
943
944GNU Emacs is distributed in the hope that it will be useful,
945but WITHOUT ANY WARRANTY; without even the implied warranty of
946MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
947GNU General Public License for more details.
a933dad1 948
5b87ad55
GM
949You should have received a copy of the GNU General Public License
950along with GNU Emacs; see the file COPYING. If not, write to the
951Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
952Boston, MA 02110-1301, USA.
a933dad1 953
05197f40 954\f
a933dad1
DL
955Local variables:
956mode: outline
957paragraph-separate: "[ \f]*$"
958end:
ab5796a9 959
a533413c 960arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2