NEWS 35.9 KB
Newer Older
1
GNU Emacs NEWS -- history of user-visible changes.
2

Glenn Morris's avatar
Glenn Morris committed
3
Copyright (C) 2007, 2008 Free Software Foundation, Inc.
4
See the end of the file for license conditions.
Dave Love's avatar
#  
Dave Love committed
5

6
Please send Emacs bug reports to emacs-pretest-bug@gnu.org.
7 8
If possible, use M-x report-emacs-bug.

9
This file is about changes in Emacs version 23.
10

11 12
See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17
for changes in older Emacs versions.
13 14 15

You can narrow news to a specific version by calling `view-emacs-news'
with a prefix argument or by typing C-u C-h C-n.
16 17 18 19 20 21 22

Temporary note:
 +++ indicates that the appropriate manual has already been updated.
 --- means no change in the manuals is called for.
When you add a new item, please add it without either +++ or ---
so we will look at it and add it to the manual.

23 24 25

* About external Lisp packages

26

27
* Installation Changes in Emacs 23.1
28

29 30
** The default X toolkit is now Gtk+, rather than Lucid.

31 32 33 34 35 36 37
** The new configuration option "--enable-font-backend" enables new code
for handling fonts by multiple backends (the old font handling codes
still exist).  This requires the freetype and fontconfig libraries, and
supports local fonts (fonts installed on the machine where Emacs is running).
Additionally, the Xft library can be used for antialiasing support.
Fontconfig-like font names (e.g. monospace-12) are also accepted.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
38 39 40
** The new configuration option "--with-dbus" enables D-Bus language
bindings for Emacs.

41 42 43
** The Mac Carbon port is no longer supported.
Instead, use... [what?]

44 45
** configure now checks for libgif before libungif when searching for
a GIF library.
Glenn Morris's avatar
Glenn Morris committed
46

Glenn Morris's avatar
Glenn Morris committed
47 48
** Support for systems without alloca has been removed.

49 50
** Support for Sun windows has been removed.

51 52 53
** Support for many obsolete platforms has been removed.
See the list at the end of etc/MACHINES for details.

Glenn Morris's avatar
Glenn Morris committed
54 55
** The `emacstool' utility has been removed.

56 57 58 59 60 61
** The configure options `--with-gcc', `--without-gcc' have been removed.
Configure will use gcc by default.  Set the CC environment variable if
you need control over which C compiler is used.

** The configure option `--with-gtk' has been removed. Gtk is now the
default toolkit, but you can use --with-x-toolkit=gtk if necessary.
Nick Roberts's avatar
Nick Roberts committed
62 63 64

* Changes in Emacs 23.1

65
** Emacs now supports using both X displays and ttys in one session.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
66 67 68 69
Start the server (M-x server-start).  Then `emacsclient -t' creates a
tty frame connected to the running emacs server.  You can also use any
number of different ttys.  `emacsclient -c' creates a new X11 frame on
the current $DISPLAY or a tty frame if $DISPLAY is not set.
70 71 72 73

You can test for the presence of this feature in your Lisp code by
testing for the `multi-tty' feature.

74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
** The Emacs character set is now a superset of Unicode.  
(It has about four times the code space, which should be plenty).

The internal encoding used for buffers and strings is now
Unicode-based and called `utf-8-emacs'.  utf-8-emacs is backwards
compatible with the UTF-8 encoding of Unicode.  The `emacs-mule'
coding system can still read and write data in the old internal encoding.

Since the internal encoding is also used by default for byte-compiled
files -- i.e. the normal coding system for byte-compiled Lisp files is
now utf-8-Emacs -- Lisp containing non-ASCII characters which is
compiled by Emacs 23 can't be read by earlier versions of Emacs.  Files
compiled by Emacs 20, 21, or 22 are loaded correctly as emacs-mule
(whether or not they contain multibyte characters), which makes loading
them somewhat slower than Emacs 23-compiled files.  Thus it may be worth
recompiling existing .elc files which don't need to be shared with older
Emacsen.

** There are assorted new coding systems/aliases -- see M-x list-coding-systems.

** There is a new charset implementation with many new charsets.
See M-x list-character-sets.  New charsets can be defined conveniently
as tables of unicodes.

The dimension of a charset is now 1, 2, 3, or 4, and the size of each
dimension is no longer limited to 94 or 96.

A dynamic charset priority list is used to infer the charset of
characters for display.

** There are new Chinese-GBK, Chinese-GB18030, Khmer, and TaiViet language
environments.

Jan Djärv's avatar
Jan Djärv committed
107 108 109 110 111 112
** Emacs now supports the XEmbed specification.
You can embed Emacs in another application on X11.  The new command line option
--parent-id is used to pass the parent window id to Emacs.  See
http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
for details about XEmbed.

Thien-Thi Nguyen's avatar
Thien-Thi Nguyen committed
113 114 115 116
** Emacs comes with a new set of icons for Mac OS X.
OS-X-style icons (an application icon and a relevant document icon)
were contributed by Kentaro Ohkouchi.
Source files for these icons can be found in Emacs.app/Contents/Resources.
117
PNG versions are available as etc/images/icons/emacs*_mac.png.
Thien-Thi Nguyen's avatar
Thien-Thi Nguyen committed
118

119 120 121 122 123 124 125
** Built-in functions (subr) can now have an interactive specification
that is not a prompt string.  If the `intspec' parameter of a `DEFUN'
starts with a `(', the string is evaluated as a Lisp form.

** set-file-modes is now interactive and can take the mode value in
symbolic notation thanks to auxiliary functions.

126 127 128
** split-window-preferred-function specifies whether display-buffer should
split windows vertically or horizontally.

129 130 131 132 133
** Emacsclient has been extended to support opening a new terminal
frame.  Its behavior has been changed to open a new Emacs frame by
default.  Use the -c option to get the old behavior of opening files in
the currently selected Emacs frame.

134 135
** The refcards are now shipped as PDF files.

136 137
** Emacs now supports the SVG image format through librsvg2.

138 139
** transient-mark-mode is now enabled by default.

140
** If you set find-file-confirm-nonexistent-file to t, then C-x C-f
Stefan Monnier's avatar
Stefan Monnier committed
141 142
requires confirmation before opening a non-existent file.

Nick Roberts's avatar
Nick Roberts committed
143 144 145 146 147
** If the gpm mouse server is running and t-mouse-mode enabled, Emacs uses a
Unix socket in a GNU/Linux console to talk to server, rather than faking events
using the client program mev.  This C level approach provides mouse
highlighting, and help echoing in the minibuffer.

148 149 150 151
** The new variable next-error-recenter specifies how next-error should
recenter the visited source file.  Its value can be a number (for example,
0 for top line, -1 for bottom line), or nil for no recentering.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
152 153 154
** New command recenter-top-bottom moves the current line to window
center, top and bottom on successive invokations.

155 156
** C-l is bound to the new command recenter-top-bottom, rather than recenter.

Juanma Barranquero's avatar
Juanma Barranquero committed
157
** The mode-line displays a `@' if the default-directory for the current buffer
Nick Roberts's avatar
Nick Roberts committed
158
is on a remote machine, or a hyphen otherwise.
159

160 161 162
** The mode-line displays a mode menu when mouse-1 is clicked on a minor mode,
in the same way as it already did for major modes.

Juanma Barranquero's avatar
Juanma Barranquero committed
163
** The new command balance-windows-area balances windows both vertically
164
and horizontally.
165 166 167

** The new command close-display-connection can be used to close a connection
to a remote display, e.g. because the display is about to become unreachable.
168 169 170

** The command shell prompts for the default directory, when it is
called with a prefix, and the default directory is a remote file name.
Juanma Barranquero's avatar
Juanma Barranquero committed
171
This is because some file name handlers (like ange-ftp) are not able to
172
run processes remotely.
173 174 175

** The new command `display-time-world' starts an updating time display
using several time zones, in a buffer.
176

Glenn Morris's avatar
Glenn Morris committed
177 178 179
** The new function `format-seconds' converts a number of seconds into a
readable string of days, hours, etc.

Glenn Morris's avatar
Glenn Morris committed
180 181
** The new variables `before-init-time' and `after-init-time' record the
value of `current-time' before and after Emacs loads the init files.
182 183 184

** The new function `emacs-uptime' returns the uptime of an Emacs instance.

185 186 187
** The new function `emacs-init-time' returns the duration of the
Emacs initialization.

188 189 190
** The minor modes unify-8859-on-encoding-mode, unify-8859-on-decoding-mode
are obsolete.

191

192
* Startup Changes in Emacs 23.1
193

194 195 196 197
** New user option `initial-buffer-choice' specifies what to display
after starting Emacs: startup screen, *scratch* buffer, visiting a
file or directory.

198 199 200 201
** New alias `argv' for `command-line-args-left'
This is a convenience alias, so that one can write `(pop argv)'
inside of --eval command line arguments in order to access
following arguments.
202 203

** The abbrev file is no longer read at startup in batch mode.
204

205
* Incompatible Editing Changes in Emacs 23.1
Kim F. Storm's avatar
Kim F. Storm committed
206

207 208 209 210 211
+++
** In Dired-x, all command guesses for ! are now added to the default
list accessible by M-n instead of pushing all guesses temporarily into
the history list.

Richard M. Stallman's avatar
Richard M. Stallman committed
212

213
* Editing Changes in Emacs 23.1
Richard M. Stallman's avatar
Richard M. Stallman committed
214

215 216 217 218 219
+++
** C-M-% now shows replacement as it would look in the buffer, with
`\N' and `\&' substituted according to the match.  Old behavior can be
restored by customizing `query-replace-show-replacement'.

220 221 222
+++
** M-q now fills the region if the region is active and
`transient-mark-mode' is turned on.  Otherwise, it fills the current
Juri Linkov's avatar
Juri Linkov committed
223
paragraph.
224

Juri Linkov's avatar
Juri Linkov committed
225
+++
Juri Linkov's avatar
Juri Linkov committed
226 227 228 229
** M-$ now checks spelling of the region if the region is active and
`transient-mark-mode' is turned on.  Otherwise, it checks spelling of the
word at point.

230 231 232
** TAB now indents the region if the region is active and
`transient-mark-mode' is turned on.

233 234 235
** `use-empty-active-region' controls whether an empty active region
in Transient Mark mode should make commands operate on that empty region.

236 237 238
** C-z now invokes `suspend-frame', C-x C-c now invokes
`save-buffers-kill-terminal'.

239 240
** New command kill-matching-buffers kills buffers whose name matches a regexp.

241 242 243 244 245 246 247
** You can disable kill ring commands from accessing the primary selection
by setting `x-select-enable-primary' to nil.

** If `select-active-regions' is t, setting the mark automatically
makes the new region into the primary selection (for interaction with
other window applications).  If you enable this, you might want to bind
`mouse-yank-primary' to Mouse-2.
248

249 250 251 252
** If `yank-pop-change-selection' is t, rotating the kill ring
also updates the selection or clipboard to the current yank,
just as M-w would do so with the text it copies to the kill ring.

253 254
** Minibuffer changes:

255 256 257
*** In C-x d, if you type M-n you get the visited file name of the
current buffer.

258 259 260 261 262 263 264 265
*** In Dired, a list of commands for ! extracted from mailcap according to
file extensions are added to the default list accessible by M-n.

*** A list of regexp default values is available via M-n for `occur',
`keep-lines', `flush-lines' and `how-many'.  This list includes the active
region in transient-mark-mode, the word under the cursor, the last isearch
regexp, the last isearch string and the last replacement regexp.

266 267 268 269 270 271 272 273
*** isearch started in the minibuffer searches in the minibuffer history.
Reverse isearch commands (C-r, C-M-r) search in previous minibuffer
history elements, and forward isearch commands (C-s, C-M-s) search in
next history elements.  When the reverse search reaches the first history
element, it wraps to the last history element, and the forward search
wraps to the first history element.  When the search is terminated, the
history element containing the search string becomes the current.

274 275

* New Modes and Packages in Emacs 23.1
276

277 278
** FIXME add details of new packages imported from lisp/gnus.

279 280 281 282 283 284
** The package doc-view.el has been added.  It supports viewing of PDF,
PostScript and DVI documents inside an Emacs buffer by converting the
document to a set of PNG images first.  One can also search for a
regular expression in the document.  The commentary of the file explains
its usage.

Glenn Morris's avatar
Glenn Morris committed
285 286 287
** The nXML package has been added.
[FIXME someone who uses this, please write a brief description.]

Thien-Thi Nguyen's avatar
Thien-Thi Nguyen committed
288
** A new game called `bubbles' has been added.
Thien-Thi Nguyen's avatar
Thien-Thi Nguyen committed
289

Kim F. Storm's avatar
Kim F. Storm committed
290
** minibuffer-indicate-depth-mode shows the minibuffer depth in the prompt.
291

Michael Olson's avatar
Michael Olson committed
292 293 294 295 296
** Remember Mode (remember.el) is now included with Emacs.  It is a
mode for quickly jotting down things to remember.  Included with
remember.el is a backend that can save notes to a Diary file.  Please
consult the Remember Manual for usage details.

Michael Albinus's avatar
Michael Albinus committed
297 298 299 300
** D-Bus language bindings for Elisp are provided by the package
dbus.el and by extensions to the C modules of Emacs.  D-Bus is an
inter-process communication mechanism for applications residing on the
same host, based on messages.  See the manual for further details.
Michael Olson's avatar
Michael Olson committed
301

Michael Olson's avatar
Michael Olson committed
302 303 304 305
** EasyPG is now part of the Emacs distribution.  It is an all-in-one
GnuPG interface which includes GnuPG keyring browser, cryptographic
operations on regions and files, and automatic encryption of *.gpg
files.  See the EasyPG Assistant User's Manual for further details.
306 307

* Changes in Specialized Modes and Packages in Emacs 23.1
308

309 310 311
** New minor mode Auto Composition Mode composes characters automatically
when they are displayed.  This mode is globally on by default.

312 313 314
** ChangeLog now has function bound to C-c C-f that finds the file in
the current log entry.

Stefan Monnier's avatar
Stefan Monnier committed
315 316 317 318 319 320 321 322 323
** abbrev was rewritten in Elisp and extended with more flexibility.
*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
    abbrev-table-p.
*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
    extra arguments for arbitrary properties.
*** New variable `abbrev-minor-mode-table-alist'.
*** `local-abbrev-table' can hold a list of abbrev-tables.
*** Abbrevs have now the following special properties:
324
    `:count', `:system', `:enable-function', `:case-fixed'.
Stefan Monnier's avatar
Stefan Monnier committed
325 326 327 328
*** Abbrev-tables have now the following special properties:
    `:parents', `:case-fixed', `:enable-function', `:regexp',
    `abbrev-table-modiff'.

Martin Rudalics's avatar
Martin Rudalics committed
329 330 331 332 333 334
** Help mode.
*** New macro `with-help-window' should set up help windows better
than `with-output-to-temp-buffer' with `print-help-return-message'.
*** New option `help-window-select' permits to customize whether help
window shall be automatically selected when invoking help.
*** New variable `help-window-point-marker' permits to specify new
335
position of point in help window (for example in `view-lossage').
Martin Rudalics's avatar
Martin Rudalics committed
336 337

** view-remove-frame-by-deleting is now by default t
338
since users found iconification of view-mode frames distracting.
Martin Rudalics's avatar
Martin Rudalics committed
339

Juri Linkov's avatar
Juri Linkov committed
340 341 342 343 344 345
** Isearch mode

*** New command `isearch-occur' bound to `M-s o' in isearch mode
runs `occur' with the current search string.

*** isearch can now search through multiple ChangeLog files.
Juri Linkov's avatar
Juri Linkov committed
346 347 348 349
When running isearch in a ChangeLog file, if the search fails,
then another C-s tries searching the previous ChangeLog,
if there is one (e.g. go from ChangeLog to ChangeLog.12).

350 351
This is enabled if isearch-buffers-multi is non-nil.

Glenn Morris's avatar
Glenn Morris committed
352 353 354
*** The part of an isearch that failed to match is highlighted in `isearch-fail'
face.

Stefan Monnier's avatar
Stefan Monnier committed
355 356 357
** smerge-refine highlights word-level details of changes in conflict.
It's used automatically as you move through conflicts, see smerge-auto-refine.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
358 359 360 361 362 363
** Diff mode

*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
It's used automatically as you move through hunks, see
diff-auto-refine.  It is bound to `C-c C-b'.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
364 365 366
*** diff-add-change-log-entries-other-window iterates through the diff
buffer and tries to create ChangeLog entries for each change.
It is bound to `C-x 4 A'.
Stefan Monnier's avatar
Stefan Monnier committed
367

Stefan Monnier's avatar
Stefan Monnier committed
368
** archive-mode has basic support to browse Rar archives.
Stefan Monnier's avatar
Stefan Monnier committed
369

370 371
** talk.el has been extended for multiple tty support.

372 373 374
** compilation-auto-jump-to-first-error tells `compile' to jump to
the first error encountered during compilations.

375
** In the `copyright' package, you can specify your copyright holders' names.
376 377 378
Only copyright lines with holders matching copyright-names-regexp will be
considered for update.

379 380 381
** eldoc highlights the function argument under point
with the face `eldoc-highlight-function-argument'.

Martin Rudalics's avatar
Martin Rudalics committed
382 383 384
** hide-ifdef-mode permits to shadow ifdef-blocks instead of hiding them.
See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.

385
+++
Juanma Barranquero's avatar
Juanma Barranquero committed
386
** defcustom accepts new keyword arguments, `:safe' and `:risky', which
387 388
set a variable's `safe-local-variable' and `risky-local-variable' property.

389 390 391 392 393 394
** Etags changes.
*** The --members option is now the default.

Use --no-members if you want the old default behaviour of not tagging
struct members in C, members variables in C++ and variables in PHP.

395
** VC
Dan Nicolaescu's avatar
Dan Nicolaescu committed
396 397
*** Clicking on the VC mode-line entry now pops the VC menu.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
398
*** The VC mode-line entry now has a tooltip that explains the VC file status.
399

Dan Nicolaescu's avatar
Dan Nicolaescu committed
400 401
*** VC now supports applying VC operations to a set of files at a time.

Eric S. Raymond's avatar
Eric S. Raymond committed
402 403 404 405 406
This enables VC to work much more effectively with changeset-oriented
version-control systems such as Subversion, GNU Arch, Mercurial, and
Bzr. VC will now pass a multiple-file commit to these systems
as a single changeset.

407 408
*** In VC Annotate mode, you can type V to toggle the annotation visibility.

409 410 411
*** In VC Annotate mode, you can type f to show the file revision on
the current line.

412 413 414
** log-edit now has a command bound to C-c C-d to show the diff for
the files involved.

415 416
** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.

Glenn Morris's avatar
Glenn Morris committed
417 418 419 420 421
** The appearance of superscript and subscript in TeX is more customizable.
See the documentation of the variables: tex-fontify-script,
tex-font-script-display, tex-suscript-height-ratio, and
tex-suscript-height-minimum.

Roland Winkler's avatar
Roland Winkler committed
422 423
** BibTeX mode:

Roland Winkler's avatar
Roland Winkler committed
424 425
*** New command `bibtex-initialize' (re)initializes BibTeX buffers. 

Roland Winkler's avatar
Roland Winkler committed
426 427 428 429
*** New `bibtex-entry-format' options `whitespace', `braces', and
`string', disabled by default.

*** New variable `bibtex-cite-matcher-alist' contains rules to
Juanma Barranquero's avatar
Juanma Barranquero committed
430
identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
Roland Winkler's avatar
Roland Winkler committed
431

Roland Winkler's avatar
Roland Winkler committed
432
*** Command `bibtex-url' allows multiple URLs per entry.
Roland Winkler's avatar
Roland Winkler committed
433

434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462
+++
** Tramp

*** New connection methods.
The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
been introduced.  There are also new so-called gateway methods
"tunnel" and "socks".

*** Multihop syntax has been removed.
The pseudo-method "multi" has been removed.  Instead of, multi hops
can be specified by the new variable `tramp-default-proxies-alist'.

*** More default settings.
Default values can be set via the variables `tramp-default-user',
`tramp-default-user-alist' and `tramp-default-host'.

*** Connection information is cached.
In order to reduce connection setup, information about used
connections are kept persistent in a file.  The name of this file is
defined in the variable `tramp-persistency-file-name'.

*** Control of remote processes.
Running processes on a remote host can be controlled by settings in
`tramp-remote-path' and `tramp-remote-process-environment'.

*** Success of remote copy is checked.
When the variable `file-precious-flag' is set, the success of a remote
file copy is checked via the file's checksum.

463 464
** Miscellaneous programming mode changes

Glenn Morris's avatar
Glenn Morris committed
465 466
*** The file etc/emacs.py now supports both Python 2 and 3, meaning
that either version can be used as inferior Python by python.el.
Glenn Morris's avatar
Glenn Morris committed
467

Glenn Morris's avatar
Glenn Morris committed
468 469 470 471 472
*** Python mode now has `pdbtrack' functionality.  When using pdb to
debug a Python program, pdbtrack notices the pdb prompt and displays
the source file and line that the program is stopped at, much the same
way as gud-mode does for debugging C programs with gdb.

473 474
*** The variable `fortran-line-length' can change the fixed-form line-length.

475 476 477
*** In Fortran mode, M-; is now bound to the standard comment-dwim,
rather than fortran-indent-comment.

478 479
+++
*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
480

Reiner Steib's avatar
Reiner Steib committed
481 482 483 484 485 486 487 488
** Gnus package

*** The Gnus package has been updated

*** There are many news features, bug fixes and improvements.

See the file GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.

489 490 491
** Miscellaneous

*** comint-mode uses `start-file-process' now (see Lisp Changes).
492 493 494
If `default-directory' is a remote file name, subprocesses are started
on the corresponding remote system.

495
*** C-x C-q in dired-mode now runs the command wdired-change-to-wdired-mode,
496 497
and C-x C-q in wdired-mode exits it with asking a question about
saving changes.
498

499 500
*** The new command `eshell/info' runs info in an eshell buffer.

Glenn Morris's avatar
Glenn Morris committed
501 502
*** The pcmpl-unix package supports hostname completion for ssh and scp.

Glenn Morris's avatar
Glenn Morris committed
503 504 505
*** WoMan tries to add locale-specific manual page directories to the
search path.  This can be disabled by setting `woman-locale' to nil.

Glenn Morris's avatar
Glenn Morris committed
506 507 508
*** The new variable `ffap-rfc-directories' specifies a list of local
directories in which `ffap-rfc' will first search for RFCs.

509 510

* Changes in Emacs 23.1 on non-free operating systems
Juri Linkov's avatar
Juri Linkov committed
511

Jason Rumney's avatar
Jason Rumney committed
512 513 514 515 516 517 518
---
** IPv6 is supported on MS-Windows.
Emacs now supports IPv6 on Windows XP and later, and earlier versions
of Windows with third party IPv6 stacks installed. Previously IPv6 was
supported on other platforms, but not on Windows due to using the winsock
1.1 header file, even though Emacs was linking to the winsock 2 library.

Jason Rumney's avatar
Jason Rumney committed
519 520 521 522 523 524 525 526 527 528 529 530
** More keys available on MS-Windows.
Keys normally associated with IMEs, and some exotic keys not normally found
on standard keyboards have been given names so they can be bound to functions
inside Emacs.  If there are keys on your keyboard that have not been exposed
to Emacs in the past, try C-h k to see if they are available now.

Emacs can now bind functions to the extra buttons for media player and
browser control present on some keyboards.  These buttons are disabled
by default, since enabling them prevents their system-wide use when
Emacs has focus.  To enable them, set the variable
w32-pass-multimedia-buttons to nil. See the doc string of that variable
for the list of extra keys that are available.
531 532

* Incompatible Lisp Changes in Emacs 23.1
533

534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549
** The behavior of map-char-table has changed.  It may call the
specified function with a cons (FROM . TO) as a key if characters in
that range have the same value.

** The value of the function `charset-id' is now always 0.

** The functions `register-char-codings' and `coding-system-spec'
have been removed.

** Many codepage related functions have been removed.  They are:
  cp-make-coding-systems-for-codepage, cp-charset-for-codepage,
  cp-language-for-codepage, cp-offset-for-codepage,
  cp-supported-codepages
You don't need them anymore because coding systems created by these
functions are supported from the start now.

550 551 552
+++
** The function `dired-call-process' has been removed.

553 554 555 556 557 558 559 560
** The variable `byte-compile-warnings' can now be a list starting with `not',
meaning to disable the specified warnings. The meaning of this list
may therefore be the reverse of what you expect (of course, this is
only an issue if you make use of the new `not' syntax). Rather than
checking/manipulating elements directly, use the new functions
`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
`byte-compile-enable-warning.'

561 562 563
** `mode-name' is no longer guaranteed to be a string.
Use `(format-mode-line mode-name)' to ensure a string value.

564 565

* Lisp Changes in Emacs 23.1
Juri Linkov's avatar
Juri Linkov committed
566

567
** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
568

569
** `beginning-of-defun-function' now takes one argument, the count
570
 given to `beginning-of-defun'.
571

572 573 574
** The variable `inhibit-changing-match-data', if non-nil, prevents the
search and match primitives from changing the match data.

575 576 577 578
+++
** New function `match-substitute-replacement' returns the result of
`replace-match' without actually using it in the buffer.

579 580 581 582 583
** If a local hook function has a non-nil `permanent-local-hook'
property, then `kill-all-local-variables' does not remove it from
the local value of the hook variable.  This means it remains
even if you change major modes.

584 585 586 587 588 589 590
+++
** A list of default values can be specified for the DEFAULT argument of
functions `read-from-minibuffer', `read-string', `read-command',
`read-variable', `read-buffer', `completing-read'.  Elements of this list
are available for inserting into the minibuffer by typing `M-n'.
For empty input these functions return the first element of this list.

591 592 593
** `custom-note-var-changed' tells Custom to treat the change in a certain
variable as having been made within Custom.

594 595
** `frame-inherited-parameters' lets new frames inherit parameters from
the selected frame.
596

597
** Commands should use `use-region-p' to test whether there is
598 599
an active region that they should operate on.

600 601 602 603 604
** `region-active-p' returns non-nil when Transient Mark mode
is enabled and there is an active region.  This is NOT the best function
to use to test whether a command should operate on the region instead
of the usual behavior -- for that, use `use-region-p'.

605 606 607 608 609
** New keymap `input-decode-map' overrides like key-translation-map, but
applies before function-key-map.  Also it is terminal-local contrary to
key-translation-map.  Terminal-specific key-sequences are generally added to
this map rather than to function-key-map now.

610 611 612 613 614
** The new macro `declare-function' suppresses compiler warnings about
undefined functions.  The new `check-declare' package verifies that such
statements are accurate (i.e. the functions are actually defined in
the specified files).

615 616
** The new function `read-color' reads a color name using the minibuffer.

617 618 619
** The new function `face-all-attributes' returns an alist
describing all the basic attributes of a given face.

620 621 622 623
** `interprogram-paste-function' can now return one string or a list
of strings.  In the latter case, Emacs puts the second and following
strings on the kill ring.

624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757
** Character code, representation, and charset changes.

The character code space is now 0x0..0x3FFFFF with no gap. 
Characters of code 0x0..0x10FFFF are Unicode characters of the same code points.
Characters of code 0x3FFF80..0x3FFFFF are raw 8-bit bytes.

Generic characters no longer exist.  

In buffer and string, characters are represented by UTF-8 byte
sequence in a multibyte buffer/string.

The concept of a charset has changed.  A single character may belong to
multiple charsets (e.g. a-grave, U+00E0, belongs to charsets unicode,
iso-8859-1, iso-8859-3, etc).

*** The new function `characterp' returns t if and only if the argument
is a character.

*** The new function `max-char' returns the maximum character code
(currently it is #x3FFFFF).

*** The functions `encode-char' and `decode-char' now accept any character sets.

*** The function `define-charset' now accepts a completely different
form of arguments (old-style arguments still work).

*** The new function `define-charset-alias' defines an alias of a charset.

*** The value of the function `char-charset' depends on the current
priorities of charsets.

*** The new function `charset-priority-list' returns the list of
charsets ordered by priority.

*** The new function `set-charset-priority' sets priorities of charsets.

*** The new function `unibyte-charset' returns the current unibyte
charset.  The unibyte charset determines how unibyte/multibyte
conversion is done.

*** The new function `set-unibyte-charset' sets the unibyte charset.

*** The new function `unibyte-string' make a unibyte string from bytes.

*** The new function `define-char-code-property' defines a character
code property.

*** The new function `char-code-property-description' returns the
description string of a character code property.

*** The function get-char-code-property now accepts many Unicode base
character properties.  They are `name', `general-category',
`canonical-combining-class', `bidi-class', `decomposition',
`decimal-digit-value', `digit-value', `numeric-value', `mirrored',
`old-name', `iso-10646-comment', `uppercase', `lowercase', and
`titlecase'.

*** The new variable `find-word-boundary-function-table' is a
char-table of functions to search for a word boundary.

*** The new variable `char-script-table' is a char-table of script names.

*** The new variable `char-width-table' is a char-table of character widths.

*** The new variable `print-charset-text-property' controls how to
handle `charset' text property on printing a string.

*** The new variable `printable-chars' is a char-table defining if a
character is printable or not.

*** The functions `modify-syntax-entry' and `modify-category-entry' now
accepts a cons of characters as the first argument, and modify all
entries in that range of characters.

*** The functions `char-bytes', `chars-in-region', and `char-valid-p' are
obsolete.

** Code conversion changes.

*** The new function `define-coding-system' should be used to define a
coding system instead of `make-coding-system' (which is now obsolete).

*** The functions `encode-coding-region' and `decode-coding-region'
have an optional 4th argument to specify where the result of
conversion should go.

*** The functions `encode-coding-string' and `decode-coding-string'
have an optional 4th argument specifying a buffer to store the result
of conversion.

*** The new function `with-coding-priority' executes the body part with
the specified coding system priority order.

*** The new function `check-coding-systems-region' checks if the text
in the region is encodable by the specified coding systems.

*** The new function `coding-system-aliases' returns a list of aliases
of a coding system.

*** The new function `coding-system-charset-list' returns a list of
charsets supported by a coding system.

*** The new function `coding-system-priority-list' returns a list of
coding systems ordered by their priorities.

*** The new function `set-coding-system-priority' sets priorities of
coding systems.

*** The functions `set-coding-priority' and `make-coding-system' are obsolete.

** There is a new input method, Robin, different from Quail.
It has three functionalities: 
 i) a simple input method (converts an ASCII sequence into a string).
ii) converts an existing buffer substring into another string
iii) reverse conversion (each character produced by a
robin rule can hold the original ASCII sequence as a char-code-property)

*** The new function `robin-define-package' defines a Robin package.

*** The new function `robin-modify-package' modifies an existing Robin package.

*** The new function `robin-use-package' starts using a Robin package
as an input method.

** Composition changes.

*** New functions and variables `auto-composition-mode' and
`global-auto-composition-mode' toggles the new minor mode Auto
Composition Mode locally and globally.

*** New variable `auto-composition-function' is a function used in
Auto Composition Mode to compose characters.  The default value is the
function `auto-compose-chars'.

758 759
** Changes related to the new font backend.

760 761
Which font backends to use can be specified by the X resource "FontBackend".
For instance, to use both X core fonts and Xft fonts:
762

763
Emacs.FontBackend: x,xft
764

765 766
If this resource is not set, Emacs tries to use all font backends
available on your graphic device.
767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797

*** New frame parameter `font-backend' specifies a list of
font-backends supported by the frame's graphic device.  On X, they are
currently `x' and `xft'.

*** New function `fontp' checks if the argument is a font-spec or font-entity.

*** New function `font-spec' creates a new font-spec object.

*** New function `font-get' returns a font property value.

*** New function `font-put' sets a font property value.

*** New function `list-fonts' returns a list of font-entities matching
the given specification.

*** New function `list-families' returns a list of family names of
available fonts.

*** New function `font-font' returns a font-entity best matching with
the given specification.

*** New function `font-xlfd-name' returns an XLFD name of a given font
(font-spec, font-entity, or font-object).

*** New function `clear-font-cache' clears all font caches.

*** The function `set-fontset-font' now accepts a script name as the
second argument, and has an optional 5th argument to control how to
set the font.

798 799
** Changes related to multiple tty support.

Stefan Monnier's avatar
Stefan Monnier committed
800 801 802
*** $TERM is now set to `dumb' for subprocesses.  If you want to know the
$TERM inherited by Emacs you will have to look inside initial-environment.

803 804
*** $DISPLAY is now dynamically inherited from the frame's `display'.

805 806 807 808 809 810 811 812 813 814 815 816 817
*** The `window-system' variable has been made frame-local. The new
`initial-window-system' variable contains the `window-system' value
for the first frame.

*** You can specify a terminal device (`tty' parameter) and a terminal
type (`tty-type' parameter) to `make-terminal-frame'.

*** The new function `make-frame-on-tty' allows you to create a new
frame on another tty device interactively.

*** The function `make-frame-on-display' now works during a tty
session, and `make-frame-on-tty' works during a graphical session.

818
*** New functions: `delete-tty', `suspend-tty', `resume-tty'.
819

Stefan Monnier's avatar
Stefan Monnier committed
820 821
*** A new data type for terminals with functions: `get-device-terminal',
`terminal-parameters', `terminal-parameter', `set-terminal-parameter'.
822

823
*** New hooks: `suspend-tty-functions' and `resume-tty-functions'
824
are called after a tty frame has been suspended or resumed,
Juanma Barranquero's avatar
Juanma Barranquero committed
825
respectively.  The functions are called with the terminal id of the frame
826 827
being suspended/resumed as a parameter.

Stefan Monnier's avatar
Stefan Monnier committed
828
*** New function: `environment'.
829

830
*** New variable: `local-function-key-map'.
Stefan Monnier's avatar
Stefan Monnier committed
831 832 833 834
This in addition to the global function-key-map variable that
already existed.  The global variable is not used directly any more;
instead, the local-function-key-map is initialized so as to inherit from
function-key-map.
835

Stefan Monnier's avatar
Stefan Monnier committed
836 837
*** `initial-environment' holds the environment inherited from Emacs's parent.

838 839 840
*** The `keyboard-translate-table' variable and the terminal and
keyboard coding systems have been made terminal-local.

841 842
*** In addition to the global function-key-map, Emacs has terminal-local
local-function-key-map variables, and uses them instead of the
843 844 845 846
global keymaps to set up translations and function key sequences
relevant to a specific terminal device.


847 848 849 850
** You can now also pass the value of the `invisible' property to invisible-p
to check whether it would cause the text to be invisible.  Convenient when
checking invisibility of text which has no buffer position
(e.g. in before/after-strings).
851

852 853
** Non-breaking space now acts as whitespace.

854
+++
855 856 857 858 859 860 861 862 863
** In `condition-case', a handler can specify "let the debugger run first".

You do this by writing `debug' in the list of conditions to be handled,
like this:

    (condition-case nil
	(foo bar)
      ((debug error) nil))

Stefan Monnier's avatar
Stefan Monnier committed
864 865 866
** The `require-match' argument to `completing-read' accepts a new value
`confirm-only'.

867 868 869
+++
** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.

870 871 872 873 874 875 876 877 878 879
** New function `window-full-width-p' returns t if a window is as wide
as its frame.

** The new function `split-string-and-unquote' does (what?)

** The new function `combine-and-quote-strings' does (what?)

** The new function `image-refresh' refreshes all images associated
with a given image specification.

Chong Yidong's avatar
Chong Yidong committed
880 881 882 883
+++
** New variable `user-emacs-directory'.
Use this instead of "~/.emacs.d".

884
+++
Juanma Barranquero's avatar
Juanma Barranquero committed
885
** The new function `start-file-process' is similar to `start-process',
886
but obeys file handlers.  The file handler is chosen based on
887 888
`default-directory'.  The functions `start-file-process-shell-command'
and `process-file-shell-command' are also new; they call internally
Juanma Barranquero's avatar
Juanma Barranquero committed
889
`start-file-process' and `process-file', respectively.
890

891 892 893
** The new function `process-lines' executes an external program and
returns its output as a list of lines.

894
+++
895 896 897 898
** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
IDENTIFICATION specifies which part of the remote identifier has to be
returned.  With CONNECTED passed non-nil, it is checked whether a
remote connection has been established already.
899

900 901 902
** The two new functions `looking-at-p' and `string-match-p' can do
the same matching as `looking-at' and `string-match' without changing
the match data.
903 904 905 906

** The interactive-form of a function can be added post-facto via the
`interactive-form' symbol property.  Mostly useful to add complex interactive
forms to subroutines.
907

908
* New Packages for Lisp Programming in Emacs 23.1
909

910 911 912 913 914 915
** The package isearch-multi.el has been added.  It implements a new mode
`isearch-buffers-minor-mode' that allows isearch to search through
multiple buffers.  In this mode a new variable
`isearch-buffers-next-buffer-function' defines the function to call
to get the next buffer to search in the series of multiple buffers.

Thien-Thi Nguyen's avatar
Thien-Thi Nguyen committed
916 917
** The new package avl-tree.el deals with the AVL tree data structure.

918

Dave Love's avatar
#  
Dave Love committed
919
----------------------------------------------------------------------
920
This file is part of GNU Emacs.
Dave Love's avatar
#  
Dave Love committed
921

922 923
GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
924
the Free Software Foundation; either version 3, or (at your option)
925 926 927 928 929 930
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
Dave Love's avatar
#  
Dave Love committed
931

932 933 934 935
You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
Dave Love's avatar
#  
Dave Love committed
936

937

Dave Love's avatar
#  
Dave Love committed
938 939 940 941
Local variables:
mode: outline
paragraph-separate: "[ 	]*$"
end:
Miles Bader's avatar
Miles Bader committed
942

Miles Bader's avatar
Miles Bader committed
943
arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2