NEWS 83.8 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, 2009 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 23 24

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.


25 26 27 28 29 30 31 32 33 34
* Installation Changes in Emacs 23.2

** New configure options for Emacs developers
These are not new features; only the configure flags are new.

*** --enable-profiling builds Emacs with profiling enabled.
This might not work on all platforms.

*** --enable-checking[=OPTIONS] builds emacs with extra runtime checks.

Glenn Morris's avatar
Glenn Morris committed
35 36 37 38
---
** `make install' now consistently ignores umask, creating a
world-readable install.

Chong Yidong's avatar
Chong Yidong committed
39
* Startup Changes in Emacs 23.2
40

41
** Command-line option -Q (--quick) now also disables loading X resources.
Chong Yidong's avatar
Chong Yidong committed
42 43 44 45 46
On Windows, this option causes Emacs to ignore Registry settings,
though environment variables set on the Registry are still honored.

*** The new variable `inhibit-x-resources' shows whether X resources
were loaded.
47

Chong Yidong's avatar
Chong Yidong committed
48
* Changes in Emacs 23.2
49

Chong Yidong's avatar
Chong Yidong committed
50
** Unibyte sessions are now considered obsolete.
51 52 53 54 55
I.e. the use of the environment variable EMACS_UNIBYTE, or command line
arguments --unibyte, --multibyte, --no-multibyte, and --no-unibyte
is deprecated.  Similarly for custom-izing enable-multibyte-characters, or
setting default-enable-multibyte-characters.

56 57 58 59 60 61
** The default value of `trash-directory' has changed to nil, which
means that `move-file-to-trash' trashes files according to
freedesktop.org specifications, the same method used by the Gnome,
KDE, and XFCE desktops.  (This change has no effect on Windows, which
uses `system-move-file-to-trash' for trashing.)

62 63 64 65 66
+++
** Emacs frames can be maximized.
The command line arguments -mm/--maximized and the value maximized to the
frame parameter fullscreen makes the Emacs frame maximized.

Jan Djärv's avatar
Jan Djärv committed
67 68 69
+++
** New frame parameter sticky makes Emacs frames sticky in virtual desktops.

70 71 72
** The pointer now becomes invisible when typing.
Customize make-pointer-invisible to turn it off.

73 74 75 76 77
** Killing a buffer with a running process now asks a confirmation.
You can remove this query in two ways: either removing
`process-kill-buffer-query-function' from `kill-buffer-query-functions' or
setting the appropriate process flag with `set-process-query-on-exit-flag'.

78 79 80 81 82 83 84
** The variable `load-in-progress' won't get corrupted by binding it
with `let'.  In certain situations, loading an Emacs Lisp file from
source while in the midst of loading another file (e.g., with
`require' or `autoload') could cause the value of `load-in-progress'
to be corrupted once the outer load completed.  Most code doesn't care
about this, but some (like c-mode) may check it.

85 86 87 88 89 90 91 92 93 94 95 96 97 98 99
** File-local variable changes

*** Specifying a minor mode as a local variables enables that mode,
unconditionally.  The previous behavior, toggling the mode, was
neither reliable nor generally desirable.

*** New commands for adding and removing file-local variables:
`add-file-local-variable', `delete-file-local-variable',
`add-file-local-variable-prop-line', and
`delete-file-local-variable-prop-line'.

*** New commands for adding and removing directory-local variables,
and copying them to and from file-local variable lists:
`add-dir-local-variable', `delete-dir-local-variable',
`copy-dir-locals-to-file-locals',
100 101 102
`copy-dir-locals-to-file-locals-prop-line' and
`copy-file-locals-to-dir-locals'.

103 104 105 106
** New coding system `utf-8-hfs' is available in
international/ucs-normalize.el.  It is suitable for
default-file-name-coding-system on Mac OS X.

Glenn Morris's avatar
Glenn Morris committed
107 108 109

* Editing Changes in Emacs 23.2

Chong Yidong's avatar
Chong Yidong committed
110 111 112 113 114 115 116 117 118 119 120 121 122 123
** Selection changes
+++
*** If `select-active-regions' is t, any active region automatically
becomes the primary selection (for interaction with other window
applications).  If you enable this, you might want to bind
`mouse-yank-primary' to Mouse-2.

*** When `save-interprogram-paste-before-kill' is non-nil, emacs will
not clobber the the interprogram paste when something is killed in it
by saving the former in the `kill-ring' before the latter.

** When `kill-do-not-save-duplicates' is non-nil, identical subsequent
kills are not duplicated in the `kill-ring'.

Glenn Morris's avatar
Glenn Morris committed
124 125 126
+++
** The default value for `blink-matching-paren-distance' has been increased.

Chong Yidong's avatar
Chong Yidong committed
127 128 129
** The new completion-style `initials' is available.
For instance, this can complete M-x lch to list-command-history.

130 131 132

* Changes in Specialized Modes and Packages in Emacs 23.2

133 134
** .calc.el and .abbrev_defs obey user-emacs-directory.

135 136 137 138
** Calc graphing commands (`g f' etc.) now work on MS-Windows,
if you have the native Windows port of Gnuplot version 3.8 or later
installed.

Chong Yidong's avatar
Chong Yidong committed
139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
** Calendar and diary

*** Fancy diary display is now the default.
If you prefer the simple display, customize `diary-display-function'.

*** The diary's fancy display now enables view-mode.

---
*** The command `calendar-current-date' accepts an optional argument
giving an offset from today.

** Desktop
---
*** The default value for `desktop-buffers-not-to-save' is nil.
This means Desktop will try restoring all buffers, when you restart
your Emacs session.  Also, `desktop-buffers-not-to-save' is only
effective for buffers that have no associated file.  If you want to
exempt buffers that do correspond to files, customize the value of
`desktop-files-not-to-save' instead.

Glenn Morris's avatar
Glenn Morris committed
159 160 161
** FIXME mail-user-agent change
This probably affects a lot of documentation.

Glenn Morris's avatar
Glenn Morris committed
162 163
** FIXME gdb-mi

164 165 166 167 168
** Info

*** The new command `Info-virtual-index' bound to "I" displays a menu of
matched topics found in the index.

Juri Linkov's avatar
Juri Linkov committed
169 170 171 172
*** The new command `info-finder' replaces finder.el with a virtual Info
manual that generates an Info file which gives the same information
through a menu structure.

173 174
+++
** New connection methods in Tramp.
175 176 177
The new connection method "rsyncc" has been introduced.  On systems
which support GVFS-Fuse, Tramp offers also the new connection methods
"dav", "davs", "obex" and "synce".
178

Chong Yidong's avatar
Chong Yidong committed
179
** nXML mode is now the default for editing XML files.
180

181 182
** VC and related modes

183 184 185
*** FIXME: add info about the new VC functions: vc-root-diff and
vc-root-print-log once they stabilize.

186 187
*** When a file is not found, VC will not try to check it out of RCS anymore.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
188 189 190
*** vc-git changes

**** The new variable vc-git-add-signoff can be used to add a
Dan Nicolaescu's avatar
Dan Nicolaescu committed
191 192
Signed-off-by line when committing.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
193 194
**** vc-dir displays the stash status

195 196 197
*** log-edit-strip-single-file-name controls whether or not single filenames
are stripped when copying text from the ChangeLog to the *VC-Log* buffer.

198 199 200 201 202 203
** Miscellaneous

*** The new command `async-shell-command' bound globally to `M-&' executes
the command asynchronously without the need to manually add ampersand to
the end of the command.  Its output appears in the buffer `*Async Shell
Command*'.
Glenn Morris's avatar
Glenn Morris committed
204

Chong Yidong's avatar
Chong Yidong committed
205 206 207
+++
*** Autorevert Tail mode now works now for remote files.

Glenn Morris's avatar
Glenn Morris committed
208 209 210
---
*** Elint now uses compilation-mode, and recognizes more built-in
functions and variables.
Steve Yegge's avatar
Steve Yegge committed
211 212 213 214


* New Modes and Packages in Emacs 23.2

215
** js.el is a new major mode for JavaScript files.
216 217 218 219


* Lisp changes in Emacs 23.2

220
** eval-next-after-load is obsolete.
221 222
** New hook `after-load-functions' run after loading an Elisp file.

223 224 225 226 227
** You can control which binding is preferentially shown in menus and
docstrings by adding a `:advertised-binding' property to the corresponding
command's symbol.  That property can hold a single binding or a list
of bindings.

228 229
** New macro with-silent-modifications to tweak text properties without
affecting the buffer's modification state.
230 231 232
** All the default-FOO variables that hold the default value of the FOO
variable, are now declared obsolete.

233 234
** read-key is a function halfway between read-event and read-key-sequence.
It reads a single key, but obeys input and escape sequence decoding.
235

Glenn Morris's avatar
Glenn Morris committed
236 237
** start-process-shell-command and start-file-process-shell-command
now only take a single `command' argument.
238 239 240 241 242

** The variable `process-file-side-effects' shall be bound to nil, if
a `process-file' call does not change a remote file.  By this, file
name handlers like Tramp can apply optimizations.

243 244 245
** Hash tables have a new printed representation that is readable.
The feature `hashtable-print-readable' identifies this new
functionality.
246 247 248 249 250 251 252 253

** Functions performing Unicode normalization are added.  They are:
ucs-normalize-NFD-region, ucs-normalize-NFD-string,
ucs-normalize-NFC-region, ucs-normalize-NFC-string,
ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,
ucs-normalize-NFKC-region, ucs-normalize-NFKC-string,
ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string,
ucs-normalize-HFS-NFC-region, ucs-normalize-HFS-NFC-string.
Stefan Monnier's avatar
.  
Stefan Monnier committed
254 255 256

** completion-annotate-function specifies how to compute annotations
for completions displayed in *Completions*.
257

258
+++
259 260
** Face aliases can now be marked as obsolete, using the macro
`define-obsolete-face-alias'.
261 262 263 264 265

---
** Changing the file-names generated by byte-compilation by redefining
the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
Instead, customize byte-compile-dest-file-function.
Chong Yidong's avatar
Chong Yidong committed
266

267 268 269 270 271 272 273 274 275
** Several obsolete functions removed.
The functions have been obsolete since Emacs 19, and are unlikely to
be in use:

  time-stamp-month-dd-yyyy, time-stamp-dd/mm/yyyy, time-stamp-mon-dd-yyyy
  time-stamp-dd-mon-yy, time-stamp-yy/mm/dd, time-stamp-yyyy/mm/dd,
  time-stamp-yyyy-mm-dd, time-stamp-yymmdd, time-stamp-hh:mm:ss,
  time-stamp-hhmm, baud-rate

Chong Yidong's avatar
Chong Yidong committed
276 277 278 279 280
* Changes in Emacs 23.2 on non-free operating systems

---
** On MS-Windows, `display-time' now displays the system load average
as well as the time, as it does on GNU and Unix.
281

282

283
* Installation Changes in Emacs 23.1
284

285
** The default X toolkit is now Gtk+, rather than Lucid.
Chong Yidong's avatar
Chong Yidong committed
286 287
The configure option `--with-gtk' has been removed.  Gtk is now the
default toolkit, but you can use --with-x-toolkit=gtk if necessary.
288

Chong Yidong's avatar
Chong Yidong committed
289 290
** New font code.
Fonts are handled by new code capable of dealing with multiple font
291
backends.  This uses the freetype and fontconfig libraries.
292

Chong Yidong's avatar
Chong Yidong committed
293 294
*** Emacs now accepts font names supplied in the fontconfig format
(e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
Dan Nicolaescu's avatar
Dan Nicolaescu committed
295

Chong Yidong's avatar
Chong Yidong committed
296 297 298 299 300 301 302 303 304
*** Added support for local fonts (fonts installed on the machine
where Emacs is running).

*** Added support for the Xft library for antialiasing.

*** Added support for the otf library for complex text layout by
OpenType fonts.

*** Added support for the m17n library for text shaping.
305

Chong Yidong's avatar
Chong Yidong committed
306
** Changes to image support
307

Chong Yidong's avatar
Chong Yidong committed
308
*** configure now checks for libgif before libungif when searching for
309
a GIF library.
310

Chong Yidong's avatar
Chong Yidong committed
311 312
*** Emacs now supports the SVG image format through librsvg2.

Jason Rumney's avatar
Jason Rumney committed
313 314
*** Emacs now supports multi-page TIFF images.

Chong Yidong's avatar
Chong Yidong committed
315
** New NeXTSTEP-based port
Glenn Morris's avatar
Glenn Morris committed
316
This provides support for GNUstep (via the GNUstep libraries) and Mac
Michael Albinus's avatar
Michael Albinus committed
317
OS X (via the Cocoa libraries).
318

Glenn Morris's avatar
Glenn Morris committed
319
Specify --with-ns to configure for this.  By default, a self-contained
320 321 322
app will be built (containing all lisp).  To install/share lisp with
other emacsen (e.g. X11 build) use --disable-ns-self-contained.  See
nextstep/README and nextstep/INSTALL in the Emacs source directory.
Chong Yidong's avatar
Chong Yidong committed
323 324 325

** Mac OS X is no longer supported via Carbon.
Use the NeXTSTEP port, described above.
Glenn Morris's avatar
Glenn Morris committed
326

Chong Yidong's avatar
Chong Yidong committed
327 328
** The new configuration option "--with-dbus" enables D-Bus language
bindings for Emacs.
329

330 331
** Support for many obsolete platforms has been removed.
See the list at the end of etc/MACHINES for details.
332

Chong Yidong's avatar
Chong Yidong committed
333
*** Support for systems without alloca has been removed.
334

Chong Yidong's avatar
Chong Yidong committed
335
*** Support for Sun windows has been removed.
336

Chong Yidong's avatar
Chong Yidong committed
337
*** The `emacstool' utility has been removed.
Chong Yidong's avatar
Chong Yidong committed
338

Chong Yidong's avatar
Chong Yidong committed
339
** The following platforms will be removed in a future Emacs version:
340 341
If you are still using Emacs on one of these platforms, please email
emacs-devel@gnu.org to inform the Emacs developers.
Chong Yidong's avatar
Chong Yidong committed
342

343
*** Old GNU/Linux systems based on libc version 5.
Chong Yidong's avatar
Chong Yidong committed
344

345 346
*** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
    executable format.
Chong Yidong's avatar
Chong Yidong committed
347 348 349

*** Solaris versions 2.6 and below.

350 351 352 353
*** Solaris on IBM RS6000 machines.

*** UNIX System V (the original SysV, not later platforms based on it).

354 355
*** Unixware on non-x86 machines.

356 357
*** Platforms not supporting shared libraries (i.e., requiring the
NO_SHARED_LIBS compilation flag).
Chong Yidong's avatar
Chong Yidong committed
358

359 360 361 362
** 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.

Chong Yidong's avatar
Chong Yidong committed
363 364
** The refcards are now shipped as PDF files.

Glenn Morris's avatar
Glenn Morris committed
365 366 367
** The manuals are now licensed under the GNU Free Documentation License v1.3,
or any later version.

Chong Yidong's avatar
Chong Yidong committed
368 369 370
** Emacs 23 comes with a new set of default icons.
Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
The Emacs 22 icon is available as `emacs22.png' in the same location.
Nick Roberts's avatar
Nick Roberts committed
371 372 373

* Changes in Emacs 23.1

Chong Yidong's avatar
Chong Yidong committed
374
** Improved X Window System support
375

Chong Yidong's avatar
Chong Yidong committed
376 377 378 379 380
*** Emacs now supports using both X displays and ttys in one session.
With an Emacs server active (M-x server-start), `emacsclient -t'
creates a tty frame connected to the running emacs server.  You can
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).
381 382
There may be problems if a display exits unexpectedly and Emacs is compiled
with Gtk+, see etc/PROBLEMS.
383 384 385

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

*** Emacs starts in the background, as a daemon, when given the
388 389 390
--daemon command line argument.  It disconnects from the terminal and
starts the server.  Clients can connect and create graphical or
terminal frames using emacsclient.
391

392
**** emacsclient starts emacs in daemon mode and connects to it when
393 394
--alternate-editor="" is used (or when the evironment variable
ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an
395 396
emacs server.

Chong Yidong's avatar
Chong Yidong committed
397
*** The new command close-display-connection closes a connection to a
398
remote display.  There are some bugs for Gtk+.  See etc/PROBLEMS.
399

Chong Yidong's avatar
Chong Yidong committed
400 401 402
*** 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
Jan Djärv's avatar
Jan Djärv committed
403 404
http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
for details about XEmbed.
405

Chong Yidong's avatar
Chong Yidong committed
406 407 408
*** Emacs can now set the frame opacity.
The opacity of a frame can be controlled by setting the `alpha' frame
parameter.  This only takes effect on a compositing window manager for
409 410
the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac
OS X, or on Windows 2000 and later versions of Windows.
411 412

The alpha parameter should be an integer between 0 (transparent) and
Chong Yidong's avatar
Chong Yidong committed
413 414
100 (opaque), or a float number between 0.0 and 1.0.  It can also be a
cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
415
active frame and INACTIVE is the opacity of non-active frames.
416

Chong Yidong's avatar
Chong Yidong committed
417 418
The variable `frame-alpha-lower-limit' defines a lower bound for the
opacity; the default is 20.
419

Chong Yidong's avatar
Chong Yidong committed
420
** Internationalization changes
421

Chong Yidong's avatar
Chong Yidong committed
422 423
*** The Emacs character set is now a superset of Unicode.
(It has about four times the code space, which should be plenty).
Stefan Monnier's avatar
Stefan Monnier committed
424

Chong Yidong's avatar
Chong Yidong committed
425
The internal encoding used for buffers and strings is now
426 427 428 429
Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias
for this).  This encoding is backward-compatible with Unicode's UTF-8
encoding.  The internal encoding previously used by Emacs,
`emacs-mule', is still available for reading and writing files.
Nick Roberts's avatar
Nick Roberts committed
430

Chong Yidong's avatar
Chong Yidong committed
431 432 433
During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
As a result, byte-compiled files containing non-ASCII characters can't
be read by earlier versions of Emacs.  Files compiled by Emacs 20, 21,
434 435 436 437
or 22 are loaded correctly as `emacs-mule' (whether or not they
contain multibyte characters).  This takes somewhat more time, so it
may be worth recompiling existing .elc files which don't need to be
shared with older Emacsen.
438

Chong Yidong's avatar
Chong Yidong committed
439
*** There are new coding systems/aliases; see M-x list-coding-systems.
440

Chong Yidong's avatar
Chong Yidong committed
441 442 443
*** 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.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
444

Chong Yidong's avatar
Chong Yidong committed
445 446 447
*** There are new language environments for Chinese-GBK,
Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
Sinhala, and TaiViet.
448

Chong Yidong's avatar
Chong Yidong committed
449 450
*** The minor modes unify-8859-on-encoding-mode and
unify-8859-on-decoding-mode are obsolete.
451

452 453 454
*** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
decimal).  It also accepts Unicode character names with completion.
455

456 457 458 459 460
*** The `cyrillic-translit' input method supports many new characters.
Common typographical characters available from Unicode were added to
`cyrillic-translit': punctuation marks, accented characters, fractions,
and others.

Chong Yidong's avatar
Chong Yidong committed
461
** Emacs now supports serial port access on GNU/Linux, Unix, and
462 463 464
Windows.  The new command `serial-term' starts an interactive terminal
on a serial port.  The serial port can be configured at runtime with
the mode-line mouse menu.
465

Chong Yidong's avatar
Chong Yidong committed
466
** Menu Bar changes
467

Chong Yidong's avatar
Chong Yidong committed
468 469 470 471 472
*** In the Options menu, the "Set Default Font" item applies the
selected font to the `default' face on all frames, not just the
current frame.  Furthermore, if Emacs is compiled with both GTK and
Fontconfig support, the "Set Default Font" item uses the GTK font
selection dialog instead of an Emacs pop-up menu.
473

Chong Yidong's avatar
Chong Yidong committed
474 475
*** The font setting chosen by "Set Default Font" is saved if the
"Save Options" item is used.
476

477 478 479
*** The Tools menu contains a new Encryption/Decryption submenu.
This contains commands provided by EasyPG, the newly-included
interface to GnuPG (see New Modes and Packages).
480

481 482 483
*** In the Options menu, the "Truncate Long Lines in the Buffer" entry
has been replaced with a submenu offering three different ways to
handle long lines: truncation, continuation at the window edge, and
484
the new word wrapping behavior (see Editing Changes, below).
485

Dan Nicolaescu's avatar
Dan Nicolaescu committed
486 487 488 489
*** Improvements to menus for major and minor modes
More major and minor modes now have a mode specific menu, and existing
mode menus have been improved to include more functionality.

Chong Yidong's avatar
Chong Yidong committed
490
** Mode-line changes
491

Chong Yidong's avatar
Chong Yidong committed
492 493
*** The mode-line displays a `@', instead of `-', if the
default-directory for the current buffer is on a remote machine.
494

Chong Yidong's avatar
Chong Yidong committed
495 496
*** 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.
497

Chong Yidong's avatar
Chong Yidong committed
498 499
*** The `mode-line-emphasis' face is used to highlight certain
mode-line information (e.g. waiting for a VC command to finish).
500

Dan Nicolaescu's avatar
Dan Nicolaescu committed
501
*** The mode-line tooltips have been improved to provide more details.
502

Dan Nicolaescu's avatar
Dan Nicolaescu committed
503 504 505
*** The VC, line/colum number and minor mode indicators on the mode
line are now interactive: mouse-1 can be used on them to pop up a menu.

506 507
** File deletion can make use of the Recycle Bin or system Trash folder.
Set `delete-by-moving-to-trash' non-nil to use this.  Deleted files
508
and directories will then be sent to the Recycle Bin on Windows, and
509 510
to `trash-directory' on other systems.

Chong Yidong's avatar
Chong Yidong committed
511
** Directory-local variables can now be defined.
512 513 514
By default, Emacs looks in .dir-locals.el for directory-local
variables.  For more information, see `dir-locals-set-directory-class'
and `dir-locals-set-class-variables'.
515

516 517 518 519 520 521 522
** Emacs can now use `auth-source' for authentication.
`smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
login names and passwords.  The match, if found, is reported
in *Messages* with the password blanked out.

** `where-is-preferred-modifier' can specify your favorite modifier.

523

524
* Startup Changes in Emacs 23.1
525

526 527 528 529 530 531
** The option `inhibit-startup-screen' (with aliases to old names
`inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
display of the initial message in the *scratch* buffer.  If you don't
want to display the initial message in the *scratch* buffer at startup,
you can set the option `initial-scratch-message' to nil.

532 533 534 535
** New user option `initial-buffer-choice' specifies what to display
after starting Emacs: startup screen, *scratch* buffer, visiting a
file or directory.

536 537 538 539
** 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.
540 541

** The abbrev file is no longer read at startup in batch mode.
542 543 544 545 546 547

** Emacs now supports invocation by an X session manager.
It can save a session and restore it later.  See the documentation of
the functions `emacs-session-save' and `emacs-session-restore'.
(Actually, this feature was introduced with Emacs 22, but it was not
documented.)
548

549
* Incompatible Editing Changes in Emacs 23.1
Kim F. Storm's avatar
Kim F. Storm committed
550

551 552 553
** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
on the regexp command prefix map.

554 555 556 557
** 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.

558 559 560 561
** In Isearch mode, a special case of typing `C-w' at the beginning of
the minibuffer that toggles word search (i.e. using key sequences
`C-s RET C-w' or `C-s M-e C-w') is obsolete.  You can use the global key
`M-s w' to start word search, or type `M-s w' in Isearch mode to
562 563
toggle word search.  To start nonincremental word search you can now use
`M-s w RET' and `M-s w C-r RET' instead of `C-s RET C-w' and `C-r RET C-w'.
564

Juri Linkov's avatar
Juri Linkov committed
565 566 567 568 569 570 571
** In Info, `Info-search' is unbound from `M-s' to allow using `M-s w'
for word search as well as other search commands from the global prefix
key `M-s'.  `Info-search' is still bound to `s', and also incremental
search commands `C-s', `C-M-s', `C-r', `C-M-r' are available for searching
through multiple Info nodes, together with their nonincremental versions
`C-s RET', `C-r RET', `C-M-s RET', `C-M-r RET', `M-s w RET'.

572 573 574
** In Text mode, `center-line' and `center-paragraph' are rebound from
`M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the global
prefix map `M-o', which is intended for such formatting commands.
575

Reiner Steib's avatar
Reiner Steib committed
576
** The following input methods were removed in Emacs 22.2, but this was
Juanma Barranquero's avatar
Juanma Barranquero committed
577
not advertised: danish-alt-postfix, esperanto-alt-postfix,
Reiner Steib's avatar
Reiner Steib committed
578 579 580 581
finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
and swedish-alt-postfix.  Use the versions without "alt-", which are
identical.
582

Richard M. Stallman's avatar
Richard M. Stallman committed
583

584
* Editing Changes in Emacs 23.1
Richard M. Stallman's avatar
Richard M. Stallman committed
585

586 587 588
** The C-n and C-p line-motion commands now move by screen lines,
taking continued lines and variable-width characters into account.
Setting `line-move-visual' to nil reverts this to the previous
589 590
behavior (i.e., motion by logical lines based on buffer contents
alone).
591

Chong Yidong's avatar
Chong Yidong committed
592
** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
593
invokes `suspend-frame'.  These changes are for compatibility with the
Chong Yidong's avatar
Chong Yidong committed
594
new multi-tty support (see `Improved X Window System support' above).
595

Chong Yidong's avatar
Chong Yidong committed
596
** Mark changes
597

598
*** Transient Mark mode is now on by default.
599

600
*** mark-even-if-inactive now defaults to t
601

602 603
*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
activating it.
604

605 606
*** When Transient Mark mode is on, M-q now fills the region if the
region is active.  Otherwise, it fills the current paragraph.
607

608 609
*** When Transient Mark mode is on, M-$ now checks spelling of the
region if the region is active.  Otherwise, it checks spelling of the
Juri Linkov's avatar
Juri Linkov committed
610
word at point.
611

612 613
*** When Transient Mark mode is on, TAB now indents the region if the
region is active.
614 615 616 617

*** The variable `use-empty-active-region' controls whether an empty
active region in Transient Mark mode should make commands operate on
that empty region.
618 619

** Temporarily active regions
620

621 622 623 624
*** The new variable shift-select-mode, non-nil by default, controls
shift-selection.  When Shift Select mode is on, shift-translated
motion keys (e.g. S-left and S-down) activate and extend a temporary
region, similar to mouse-selection.
625

626 627 628 629 630 631 632
*** Temporarily active regions, created using shift-selection or
mouse-selection, are not necessarily deactivated in the next command.
They are only deactivated after point motion commands that are not
shift-translated, or after commands that would ordinarily deactivate
the mark in Transient Mark mode (e.g., any command that modifies the
buffer).

633
** Minibuffer and completion changes
634

635 636 637 638 639 640 641 642 643 644 645 646
*** Emacs may ask for confirmation before opening a non-existent file
or buffer.  By default, Emacs requests confirmation if you type RET
immediately after TAB, and the resulting input is not an existing file
or buffer; this usually happens when the minibuffer input did not
complete far enough and you entered RET by mistake.  In that case,
Emacs puts the message "[Confirm]" in the minibuffer; type RET again
to create the file or buffer.

The new variable confirm-nonexistent-file-or-buffer determines whether
Emacs asks for confirmation.  The default value is `after-completion'.
If you change it to t, Emacs always asks for confirmation; if you
change it to nil, Emacs never asks for confirmation.
647

648 649 650 651 652 653 654 655 656 657 658 659
*** The rules for performing completion have been changed.
When generating completion alternatives, Emacs now takes the
minibuffer text after point, if any, into account: this text is
treated as a substring of the remaining part of the completion
alternative (i.e., the part not matched by the minibuffer text before
point).  If no completion alternatives are found this way, Emacs
attempts to perform partial-completion.  If still no completion
alternatives are found, we fall back on the Emacs 22 rules for
performing completion.

The new variable `completion-styles' can be customized to choose your
favorite completion style.
660

661 662 663 664 665 666
*** When M-n in the minibuffer reaches the end of the list of defaults,
it adds the completion list to the end, so next M-n continues putting
completion items to the minibuffer.  The same principle applies to
incremental search commands as well: C-s or C-M-s starts searching
the default values and after the end of defaults they continue
searching minibuffer completion items.
667

Chong Yidong's avatar
Chong Yidong committed
668
*** Minibuffer input of shell commands now comes with completion.
669

Chong Yidong's avatar
Chong Yidong committed
670 671
*** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
name of the current buffer.
672

Chong Yidong's avatar
Chong Yidong committed
673 674 675 676 677
*** In the M-! (shell-command) prompt, M-n provides some default commands.
These are guessed using the file extension of the current file, based
on the file-handlers specified in the operating system's `mailcap'
file.  The ! command in Dired (dired-do-shell-command) works
similarly, using the file displayed on the current line.
678 679 680

*** 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
Juri Linkov's avatar
Juri Linkov committed
681 682
region in transient-mark-mode, the word under the cursor, the last Isearch
regexp, the last Isearch string and the last replacement regexp.
683

684 685 686 687 688
*** When enable-recursive-minibuffers is non-nil, operations which use
switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
used in a minibuffer or a dedicated window.  Instead, they fallback on
using pop-to-buffer, which will use some other window.  This change
has no effect when enable-recursive-minibuffers is nil (the default).
689

Juri Linkov's avatar
Juri Linkov committed
690 691 692
*** 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
693 694 695 696
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.
697

698 699
*** The variable read-file-name-completion-ignore-case overrides
completion-ignore-case for file name completion.
700

701 702
*** The variable read-buffer-completion-ignore-case overrides
completion-ignore-case for buffer name completion.
703

704 705
*** The new command `minibuffer-force-complete' chooses one of the
possible completions, rather than stopping at the common prefix.
706

707 708 709
*** If `completion-auto-help' is `lazy', Emacs shows the completions
buffer only on the second attempt to complete.  This was already
supported in `partial-completion-mode'.
710

711
** Face changes
712

713 714
*** S-down-mouse-1 now pops up a menu for changing the font and text
size of the default face in the current buffer.  The face is changed
Chong Yidong's avatar
Chong Yidong committed
715
via face remapping (see Lisp changes, below).
716

717 718 719
*** New commands to change the default face size in the current buffer.
To increase it, type `C-x C-+' or `C-x C-='.  To decrease it, type
`C-x C--'.  To restore the default (global) face size, type `C-x C-0'.
720 721 722 723 724 725 726
These work via Text Scale mode, a new minor mode.

The final key in the above commands may be repeated without the
leading `C-x', e.g. `C-x C-= C-= C-=' increases the face height by
three steps.  Each step scales the height of the default face by the
value of the variable `text-scale-mode-step'.

727 728 729
*** The commands buffer-face-mode and buffer-face-set can be used to
remap the default face in the current buffer.  See "Buffer Face mode",
under New Modes and Packages.
Glenn Morris's avatar
Glenn Morris committed
730

Chong Yidong's avatar
Chong Yidong committed
731
** Primary selection changes
732

733 734
*** You can disable kill ring commands from accessing the primary
selection by setting `x-select-enable-primary' to nil.
735

736 737 738 739 740 741 742 743
** Continuation lines can now be wrapped at word boundaries
(word-wrapping).  This is controlled by the new per-buffer variable
`word-wrap'.  Word wrapping does not take place if continuation lines
are not shown, e.g. if truncate-lines is non-nil.  The most convenient
way to enable word-wrapping is using the new minor mode Visual Line
mode; in addition to setting `word-wrap' to t, this rebinds some
editing commands to work on screen lines rather than text lines.  See
New Modes and Packages, below.
Chong Yidong's avatar
Chong Yidong committed
744

745
** Window management changes
746

747 748
*** truncate-partial-width-windows now accepts integer values, which
specify a minimum window width for partial-width windows, below which
749
lines are truncated.  The default has been changed to 50.
750 751 752

*** The new command balance-windows-area balances windows both
vertically and horizontally.
753

Martin Rudalics's avatar
Martin Rudalics committed
754 755 756
*** pop-to-buffer now always sets input focus when the popped-to window
is on a different frame.

Chong Yidong's avatar
Chong Yidong committed
757
** Miscellaneous changes:
758

Chong Yidong's avatar
Chong Yidong committed
759 760
*** C-l is bound to the new command recenter-top-bottom, rather than recenter.
This moves the current line to window center, top and bottom on
Chong Yidong's avatar
Chong Yidong committed
761
successive invocations.
762

Chong Yidong's avatar
Chong Yidong committed
763
*** scroll-preserve-screen-position also preserves the column position.
764

Chong Yidong's avatar
Chong Yidong committed
765 766 767
*** 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.
768

Chong Yidong's avatar
Chong Yidong committed
769 770 771 772 773 774 775 776
*** 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'.

*** The command shell prompts for the default directory, when it is
called with a prefix and the default directory is a remote file name.
This is because some file name handlers (like ange-ftp) are not able to
run processes remotely.
777

Chong Yidong's avatar
Chong Yidong committed
778 779
*** The new command kill-matching-buffers kills buffers whose name
matches a regexp.
780

781 782 783
*** The value of comment-style now defaults to `indent'.
Thefore, comment-start markers are inserted at the current indentation
of the region to comment, rather than the leftmost column.
784

785 786
*** The new commands `pp-macroexpand-expression' and
`pp-macroexpand-last-sexp' pretty-print macro expansions.
787

788 789
*** The new command `set-file-modes' allows to set file's mode bits.
The mode bits can be specified in symbolic notation, like with GNU
790 791
Coreutils, in addition to an octal number.  `chmod' is a new
convenience alias for this function.
Eli Zaretskii's avatar
Eli Zaretskii committed
792

Eli Zaretskii's avatar
Eli Zaretskii committed
793 794 795
*** `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.
796

797 798
*** When typing in a password in the echo area, C-y yanks the current
kill into the password.
799

800 801
*** Tooltip frame parameters `font' and `color' in `tooltip-frame-parameters'
are ignored.  Customize the `tooltip' face instead.
802

Dan Nicolaescu's avatar
Dan Nicolaescu committed
803
*** `mkdir' is a new convenience alias for `make-directory'.
Chong Yidong's avatar
Chong Yidong committed
804 805

* New Modes and Packages in Emacs 23.1
806 807 808 809 810

** Auto Composition Mode is a minor mode that composes characters
automatically when they are displayed.  It is globally on by default.
It uses `auto-composition-function' (default `auto-compose-chars').

Chong Yidong's avatar
Chong Yidong committed
811
** Bubbles, a new game, is similar to SameGame.
812 813 814 815 816 817 818 819

** Buffer Face mode is a minor mode for remapping the default face in
the current buffer.  The variable `buffer-face-mode-face' specifies
the face to remap to.  The command `buffer-face-set' prompts for a
face name, sets `buffer-face-mode-face' to it, and enables
buffer-face-mode.  See "Face changes", under Editing Changes, for a
description of face remapping.

Juri Linkov's avatar
Juri Linkov committed
820 821
** butterfly flips the desired bit on the drive platter.
See http://xkcd.com/378/
822

823 824
** bug-reference.el provides clickable links to bug reports.

Chong Yidong's avatar
Chong Yidong committed
825 826
** dbus.el provides D-Bus language bindings.
D-Bus is an inter-process communication mechanism for applications
827
residing on the same host.  See the manual for details.
Chong Yidong's avatar
Chong Yidong committed
828

829
** DocView mode allows viewing of PDF, PostScript and DVI documents.
830 831
One can also search for a regular expression in the document.  For
details, see the commentary in doc-view.el.
Chong Yidong's avatar
Chong Yidong committed
832

833 834 835 836
PDF and DVI files are now opened in Doc View mode by default.

In Postcript mode, C-c C-c launches Doc View minor mode for viewing
the postscript file.
837

838 839 840 841
** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
It includes a GnuPG keyring browser, cryptographic operations on
regions and files, and automatic encryption of *.gpg files.  For
details, see the EasyPG Assistant User's Manual.
Chong Yidong's avatar
Chong Yidong committed
842 843 844 845 846 847 848

** json.el is a library for parsing and generating JSON
(JavaScript Object Notation), a lightweight data-interchange format.

** linum.el is a new minor mode to display line numbers for the
current buffer.

849 850 851 852 853 854
** mairix.el is an interface to mairix, a free tool for indexing and
searching locally stored mail.  It allows you to query mairix and
display the search results with Rmail, Gnus and VM.  Note that there
is an existing Gnus back end, nnmairix.el, which should be used with
Maildir/MH setups.

855
** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
Chong Yidong's avatar
Chong Yidong committed
856 857 858 859 860 861 862 863 864 865 866 867 868

** nXML Mode
This is a new mode for editing XML documents.  It allows a schema to
be associated with the XML document being edited, using Relax NG as
the schema language.  The schema is used to provide two key features:

*** Continuous validation.  nXML validates as you type, highlighting
any invalid parts of your document.

*** Completion.  nXML can assist you in entering an element name,
attribute name or data value by using information about what is
allowed by the schema in that context.

869 870 871 872 873 874
** proced.el provides a Dired-like interface for operating on
processes.  Proced makes an Emacs buffer containing a listing of the
current processes.  You can use the normal Emacs commands to move
around in this buffer, and special Proced commands to operate on the
processes listed.  It is currently only functional on GNU/Linux,
MS-Windows and Solaris.
Chong Yidong's avatar
Chong Yidong committed
875 876 877 878 879

** Remember Mode is a mode for jotting down things to remember.
Notes can be saved to a Diary file.  For details, see the Remember
Manual.

880
** RST mode is a major mode for editing reStructuredText files.
881

Chong Yidong's avatar
Chong Yidong committed
882 883
** Ruby mode is a major mode for Ruby files.

Chong Yidong's avatar
Chong Yidong committed
884 885 886 887
** Visual Line mode provides support for editing by visual lines.
It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
and C-k to commands that operate by visual lines instead of logical
lines.  This is a more reliable replacement for longlines-mode.
888 889
This can also be turned on using the menu bar, via
Options -> Line Wrapping in this Buffer -> Word Wrap
Chong Yidong's avatar
Chong Yidong committed
890

Michael Albinus's avatar
Michael Albinus committed
891 892 893 894
** xesam.el is an implementation of Xesam, an interface to (desktop)
search engines like Beagle, Strigi, and Tracker.  The Xesam API
requires D-Bus for communication.

Chong Yidong's avatar
Chong Yidong committed
895 896 897 898 899
** zeroconf.el offers service discovery and service publishing
interfaces according to the zeroconf specification.  It communicates
with Avahi, a zeroconf implementation, via D-Bus messages on systems
which have installed this software.

900 901 902 903 904 905 906 907 908
** There is a new `whitespace' package.
(The pre-existing one has been renamed to `old-whitespace'.)
Now, besides reporting bogus blanks, the whitespace package has a
minor mode and a global minor mode to visualize blanks (TAB, (HARD)
SPACE and NEWLINE).  The visualization is made via faces and/or display
table.  It can also indicate lines that extend beyond a given column,
trailing blanks, and empty lines at the start or end of a buffer.
See `whitespace-style' for more details.  The `whitespace-action' option
specifies what to do when a buffer is visited, killed, or written.
909

Chong Yidong's avatar
Chong Yidong committed
910 911 912 913

* Changes in Specialized Modes and Packages in Emacs 23.1

** Abbrev has been rewritten in Elisp and extended with more flexibility.
914

Stefan Monnier's avatar
Stefan Monnier committed
915
*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
916
    abbrev-table-p, abbrev-insert, abbrev-table-menu.
917

Stefan Monnier's avatar
Stefan Monnier committed
918
*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
919

Stefan Monnier's avatar
Stefan Monnier committed
920 921
*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
    extra arguments for arbitrary properties.
922

Stefan Monnier's avatar
Stefan Monnier committed
923
*** New variable `abbrev-minor-mode-table-alist'.
924

Stefan Monnier's avatar
Stefan Monnier committed
925
*** `local-abbrev-table' can hold a list of abbrev-tables.
926

Stefan Monnier's avatar
Stefan Monnier committed
927
*** Abbrevs have now the following special properties:
928
    `:count', `:system', `:enable-function', `:case-fixed'.
929

Stefan Monnier's avatar
Stefan Monnier committed
930 931 932 933
*** Abbrev-tables have now the following special properties:
    `:parents', `:case-fixed', `:enable-function', `:regexp',
    `abbrev-table-modiff'.

Chong Yidong's avatar
Chong Yidong committed
934
** Apropos
935

Chong Yidong's avatar
Chong Yidong committed
936
*** `apropos-library' describes the elements defined in a given library.
937

Chong Yidong's avatar
Chong Yidong committed
938
*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
Martin Rudalics's avatar
Martin Rudalics committed
939

Chong Yidong's avatar
Chong Yidong committed
940
** Archive Mode has basic support to browse Rar archives.
941 942
Note, however, that the free version of the unrar command only handles
versions 1 and 2 of the Rar format.
Martin Rudalics's avatar
Martin Rudalics committed
943

Chong Yidong's avatar
Chong Yidong committed
944
** BibTeX mode
Juri Linkov's avatar
Juri Linkov committed
945

Chong Yidong's avatar
Chong Yidong committed
946
*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
Juri Linkov's avatar
Juri Linkov committed
947

Chong Yidong's avatar
Chong Yidong committed
948 949
*** New `bibtex-entry-format' options `whitespace', `braces', and
`string', disabled by default.
Juri Linkov's avatar
Juri Linkov committed
950

Chong Yidong's avatar
Chong Yidong committed
951 952
*** New variable `bibtex-cite-matcher-alist' contains rules to
identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
953

Chong Yidong's avatar
Chong Yidong committed
954
*** Command `bibtex-url' allows multiple URLs per entry.
Glenn Morris's avatar
Glenn Morris committed
955

Chong Yidong's avatar
Chong Yidong committed
956
** Calendar and diary
Juri Linkov's avatar
Juri Linkov committed
957

Chong Yidong's avatar
Chong Yidong committed
958 959 960 961
*** There is a new date style, `iso', essentially year/month/day.
The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
Similarly, the commands `american-calendar' and `european-calendar'
should be replaced by `calendar-set-date-style'.
Stefan Monnier's avatar
Stefan Monnier committed
962

Chong Yidong's avatar
Chong Yidong committed
963 964 965 966 967 968 969
*** The calendar namespace has been rationalized.
All functions and variables now begin with a `calendar-', `diary-', or
`holiday-' prefix.  The various calendar systems have secondary
prefixes, eg `calendar-french-'.  The old names you are likely to use
directly still exist, for the time being, as aliases, but please start
using the new names.