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

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

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

Kim F. Storm's avatar
Kim F. Storm committed
10
This file is about changes in Emacs version 22.
11 12

See files NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17 for changes
Kim F. Storm's avatar
Kim F. Storm committed
13
in older Emacs versions.
14 15 16

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.
17 18 19 20 21 22 23 24 25 26 27 28 29 30

* About external Lisp packages

When you upgrade to Emacs 22 from a previous version, some older
versions of external Lisp packages are known to behave badly.
So in general, it is recommended that you upgrade to the latest
versions of any external Lisp packages that you are using.

You should also be aware that many Lisp packages have been included
with Emacs 22 (see the extensive list below), and you should remove
any older versions of these packages to ensure that the Emacs 22
version is used.  You can use M-x list-load-path-shadows to find such
older packages.

Glenn Morris's avatar
Glenn Morris committed
31 32
Some specific packages that are known to cause problems are given
below.  Emacs tries to warn you about these through `bad-packages-alist'.
33

Romain Francoise's avatar
Romain Francoise committed
34
** Semantic (used by CEDET, ECB, JDEE): upgrade to latest version.
35

Kim F. Storm's avatar
Kim F. Storm committed
36
** cua.el, cua-mode.el: remove old versions.
Glenn Morris's avatar
Glenn Morris committed
37

38 39 40

* Installation Changes in Emacs 22.2

Glenn Morris's avatar
Glenn Morris committed
41 42
** Emacs is now licensed under the GNU GPL version 3 (or later).

43 44
** Support for GNU/kFreeBSD (GNU userland and FreeBSD kernel) was added.

45 46
* Changes in Emacs 22.2

47 48 49 50 51
** `find-name-dired' now uses -iname rather than -name
for case-insensitive filesystems.  The default behavior is determined
by the value of `read-file-name-completion-ignore-case'; if you don't
like that, customize the value of the new option `find-name-arg'.

52 53 54 55
** In Image mode, whenever the displayed image is wider and/or higher
than the window, the usual keys for moving the cursor cause the image
to be scrolled horizontally or vertically instead.

56 57 58 59 60
** Scrollbars follow the system theme on Windows XP and later.
Windows XP introduced themed scrollbars, but applications have to take
special steps to use them. Emacs now has the appropriate resources linked
in to make it use the scrollbars from the system theme.

Juanma Barranquero's avatar
Juanma Barranquero committed
61
** focus-follows-mouse defaults to nil on MS Windows.
62 63 64 65 66 67
Previously this variable was incorrectly documented as having no effect
on MS Windows, and the default was inappropriate for the majority of
Windows installations. Users of software which modifies the behaviour of
Windows to cause focus to follow the mouse will now need to explicitly set
this variable.

68 69 70 71 72 73 74 75 76
** `bad-packages-alist' will warn about external packages that are known
to cause problems in this version of Emacs.

** The values of `dired-recursive-deletes' and `dired-recursive-copies'
have been changed to `top'.  This means that the user is asked once,
before deleting/copying the indicated directory recursively.

** `browse-url-emacs' loads a URL into an Emacs buffer.  Handy for *.el URLs.

Nick Roberts's avatar
Nick Roberts committed
77 78 79 80
** The command gdba has been removed as gdb works now for those cases where it
was needed.  In text command mode, if you have problems before execution has
started, use M-x gud-gdb.

Juanma Barranquero's avatar
Juanma Barranquero committed
81 82 83 84 85 86 87
** desktop.el now detects conflicting uses of the desktop file.
When loading the desktop, desktop.el can now detect that the file is already
in use.  The default behavior is to ask the user what to do, but you can
customize it with the new option `desktop-load-locked-desktop'.  When saving,
desktop.el warns about attempts to overwrite a desktop file if it determines
that the desktop being saved is not an update of the one on disk.

88 89 90 91 92 93
** Etags changes.

*** If tags-loop-revert-buffers has the value `ask', the tags-scanning
loop queries the user interactively if an already-visited file has
been changed since the last visit.  The new default value is `ask'.

94 95
* New Modes and Packages in Emacs 22.2

Stefan Monnier's avatar
Stefan Monnier committed
96 97
** bibtex-style-mode helps you write BibTeX's *.bst files.

98 99
** The new package css-mode.el provides a major mode for editing CSS files.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
100 101
** The new package vera-mode.el provides a major mode for editing Vera files.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
102 103
** The new package verilog-mode.el provides a major mode for editing Verilog files.

104
** The new package socks.el implements the SOCKS v5 protocol.
105

Dan Nicolaescu's avatar
Dan Nicolaescu committed
106 107
** VC

108 109
*** VC backends can provide completion of revision names.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
110 111 112
*** VC backends can provide extra menu entries to be added to the "Version Control" menu.
This can be used to add menu entries for backend specific functions.

Stefan Monnier's avatar
Stefan Monnier committed
113 114 115
*** VC has some support for Mercurial (Hg).

*** VC has some support for Monotone (Mtn).
Dan Nicolaescu's avatar
Dan Nicolaescu committed
116

Stefan Monnier's avatar
Stefan Monnier committed
117 118
*** VC has some support for Bazaar (Bzr).

Dan Nicolaescu's avatar
Dan Nicolaescu committed
119 120
*** VC has some support for Git.

121 122 123 124 125 126 127
* Incompatible Lisp Changes in Emacs 22.2

** shell.el no longer defines the aliases `dirtrack-toggle' and
`dirtrack-mode' for `shell-dirtrack-mode'.  These names were removed
because they clash with commands provided by dirtrack.el.  Use
`shell-dirtrack-mode' instead.

128 129
* Lisp Changes in Emacs 22.2.

130
** Frame-local variables are deprecated and are slated for removal.
Glenn Morris's avatar
Glenn Morris committed
131 132
Use frame parameters instead.

133
** The function invisible-p returns non-nil if the character
Martin Rudalics's avatar
Martin Rudalics committed
134
after a specified position is invisible.
135

136 137 138 139 140
+++
** inhibit-modification-hooks is bound to t while running modification hooks.
As a happy consequence, after-change-functions and before-change-functions
are not bound to nil any more while running an (after|before)-change-function.

141 142 143
** New function `window-full-width-p' returns t if a window is as wide
as its frame.

Chong Yidong's avatar
Chong Yidong committed
144 145 146
** The new function `image-refresh' refreshes all images associated
with a given image specification.

147 148 149 150 151 152 153 154 155
** The new function `combine-and-quote-strings' concatenates a list of strings
using a specified separator.  If a string contains double quotes, they
are escaped in the output.

** The new function `split-string-and-unquote' performs the inverse operation to
`combine-and-quote-strings', i.e. splits a single string into a list
of strings, undoing any quoting added by `combine-and-quote-strings'.
(For some separator/string combinations, the original strings cannot
be recovered.)
156

157

158
* Installation Changes in Emacs 22.1
159

Kim F. Storm's avatar
Kim F. Storm committed
160 161 162 163
** You can build Emacs with Gtk+ widgets by specifying `--with-x-toolkit=gtk'
when you run configure.  This requires Gtk+ 2.4 or newer.  This port
provides a way to display multilingual text in menus (with some caveats).

164 165
** The Emacs Lisp Reference Manual is now part of the distribution.

Richard M. Stallman's avatar
Richard M. Stallman committed
166
The Emacs Lisp Reference Manual in Info format is built as part of the
167
Emacs build procedure and installed together with the Emacs User
Glenn Morris's avatar
Glenn Morris committed
168
Manual.  A menu item was added to the menu bar to make it easily
169 170 171 172 173 174 175
accessible (Help->More Manuals->Emacs Lisp Reference).

** The Introduction to Programming in Emacs Lisp manual is now part of
the distribution.

This manual is now part of the standard distribution and is installed,
together with the Emacs User Manual, into the Info directory.  A menu
Glenn Morris's avatar
Glenn Morris committed
176
item was added to the menu bar to make it easily accessible
177 178
(Help->More Manuals->Introduction to Emacs Lisp).

Kim F. Storm's avatar
Kim F. Storm committed
179 180 181 182
** Leim is now part of the Emacs distribution.
You no longer need to download a separate tarball in order to build
Emacs with Leim.

183 184
** Support for MacOS X was added.
See the files mac/README and mac/INSTALL for build instructions.
185

186 187 188
** Mac OS 9 port now uses the Carbon API by default.  You can also
create a non-Carbon build by specifying `NonCarbon' as a target.  See
the files mac/README and mac/INSTALL for build instructions.
189

190
** Support for a Cygwin build of Emacs was added.
191

Kim F. Storm's avatar
Kim F. Storm committed
192
** Support for GNU/Linux systems on X86-64 machines was added.
Gerd Moellmann's avatar
Gerd Moellmann committed
193

194 195
** Support for GNU/Linux systems on S390 machines was added.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
196 197
** Support for GNU/Linux systems on Tensilica Xtensa machines was added.

Kim F. Storm's avatar
Kim F. Storm committed
198 199
** Support for FreeBSD/Alpha has been added.

200 201 202 203 204
** New translations of the Emacs Tutorial are available in the
following languages: Brasilian Portuguese, Bulgarian, Chinese (both
with simplified and traditional characters), French, Russian, and
Italian.  Type `C-u C-h t' to choose one of them in case your language
setup doesn't automatically select the right one.
205

206 207 208
** New translations of the Emacs reference card are available in the
Brasilian Portuguese and Russian.  The corresponding PostScript files
are also included.
Kim F. Storm's avatar
Kim F. Storm committed
209

210
** A French translation of the `Emacs Survival Guide' is available.
Kim F. Storm's avatar
Kim F. Storm committed
211 212 213 214 215 216 217 218 219 220 221 222 223

** Emacs now supports new configure options `--program-prefix',
`--program-suffix' and `--program-transform-name' that affect the names of
installed programs.

** By default, Emacs now uses a setgid helper program to update game
scores.  The directory ${localstatedir}/games/emacs is the normal
place for game scores to be stored.  You can control this with the
configure option `--with-game-dir'.  The specific user that Emacs uses
to own the game scores is controlled by `--with-game-user'.  If access
to a game user is not available, then scores will be stored separately
in each user's home directory.

224 225 226 227 228
** Emacs now includes support for loading image libraries on demand.
(Currently this feature is only used on MS Windows.)  You can configure
the supported image types and their associated dynamic libraries by
setting the variable `image-library-alist'.

Kim F. Storm's avatar
Kim F. Storm committed
229 230
** Emacs can now be built without sound support.

231
** Emacs Lisp source files are compressed by default if `gzip' is available.
232

233 234
** All images used in Emacs have been consolidated in etc/images and subdirs.
See also the changes to `find-image', documented below.
Noah Friedman's avatar
Noah Friedman committed
235

236 237 238 239 240 241 242 243 244 245 246 247
** Emacs comes with a new set of icons.
These icons are displayed on the taskbar and/or titlebar when Emacs
runs in a graphical environment.  Source files for these icons can be
found in etc/images/icons.  (You can't change the icons displayed by
Emacs by changing these files directly.  On X, the icon is compiled
into the Emacs executable; see gnu.h in the source tree.  On MS
Windows, see nt/icons/emacs.ico.)

** The `emacsserver' program has been removed, replaced with Lisp code.

** The `yow' program has been removed.
Use the corresponding Emacs feature instead.
Noah Friedman's avatar
Noah Friedman committed
248

249 250 251 252
** The Emacs terminal emulation in term.el uses a different terminfo name.
The Emacs terminal emulation in term.el now uses "eterm-color" as its
terminfo name, since term.el now supports color.

253 254 255
** The script etc/emacs-buffer.gdb can be used with gdb to retrieve the
contents of buffers from a core dump and save them to files easily, should
Emacs crash.
256

257 258 259 260 261
** Building with -DENABLE_CHECKING does not automatically build with union
types any more.  Add -DUSE_LISP_UNION_TYPE if you want union types.

** When pure storage overflows while dumping, Emacs now prints how
much pure storage it will approximately need.
262

263

Richard M. Stallman's avatar
Richard M. Stallman committed
264
* Startup Changes in Emacs 22.1
265

266 267 268 269
** Init file changes
If the init file ~/.emacs does not exist, Emacs will try
~/.emacs.d/init.el or ~/.emacs.d/init.elc.  Likewise, if the shell init file
~/.emacs_SHELL is not found, Emacs will try ~/.emacs.d/init_SHELL.sh.
Kim F. Storm's avatar
Kim F. Storm committed
270

271 272 273 274 275 276 277 278 279 280 281 282 283 284 285
** Emacs can now be invoked in full-screen mode on a windowed display.
When Emacs is invoked on a window system, the new command-line options
`--fullwidth', `--fullheight', and `--fullscreen' produce a frame
whose width, height, or both width and height take up the entire
screen size.  (For now, this does not work with some window managers.)

** Emacs now displays a splash screen by default even if command-line
arguments were given.  The new command-line option --no-splash
disables the splash screen; see also the variable
`inhibit-splash-screen' (which is also aliased as
`inhibit-startup-message').

** New user option `inhibit-startup-buffer-menu'.
When loading many files, for instance with `emacs *', Emacs normally
displays a buffer menu.  This option turns the buffer menu off.
Nick Roberts's avatar
Nick Roberts committed
286

287 288
** New command line option -nbc or --no-blinking-cursor disables
the blinking cursor on graphical terminals.
Kenichi Handa's avatar
Kenichi Handa committed
289

Eli Zaretskii's avatar
Eli Zaretskii committed
290 291 292 293 294 295
** The option --script FILE runs Emacs in batch mode and loads FILE.
It is useful for writing Emacs Lisp shell script files, because they
can start with this line:

   #!/usr/bin/emacs --script

296 297 298 299
** The -f option, used from the command line to call a function,
now reads arguments for the function interactively if it is
an interactively callable function.

Eli Zaretskii's avatar
Eli Zaretskii committed
300 301 302 303 304 305 306 307 308
** The option --directory DIR now modifies `load-path' immediately.
Directories are added to the front of `load-path' in the order they
appear on the command line.  For example, with this command line:

  emacs -batch -L .. -L /tmp --eval "(require 'foo)"

Emacs looks for library `foo' in the parent directory, then in /tmp, then
in the other directories in `load-path'.  (-L is short for --directory.)

Richard M. Stallman's avatar
Richard M. Stallman committed
309 310 311 312
** When you specify a frame size with --geometry, the size applies to
all frames you create.  A position specified with --geometry only
affects the initial frame.

313
** Emacs built for MS-Windows now behaves like Emacs on X does,
Glenn Morris's avatar
Glenn Morris committed
314 315 316 317
with respect to its frame position: if you don't specify a position
(in your .emacs init file, in the Registry, or with the --geometry
command-line option), Emacs leaves the frame position to the Windows'
window manager.
318

319 320
** The command line option --no-windows has been changed to
--no-window-system.  The old one still works, but is deprecated.
Stefan Monnier's avatar
Stefan Monnier committed
321

322 323
** If the environment variable DISPLAY specifies an unreachable X display,
Emacs will now startup as if invoked with the --no-window-system option.
Kenichi Handa's avatar
Kenichi Handa committed
324

325 326 327 328 329
** Emacs now reads the standard abbrevs file ~/.abbrev_defs
automatically at startup, if it exists.  When Emacs offers to save
modified buffers, it saves the abbrevs too if they have changed.  It
can do this either silently or asking for confirmation first,
according to the value of `save-abbrevs'.
Eli Zaretskii's avatar
Eli Zaretskii committed
330

331 332 333 334 335 336 337 338 339 340 341 342
** New command line option -Q or --quick.
This is like using -q --no-site-file, but in addition it also disables
the fancy startup screen.

** New command line option -D or --basic-display.
Disables the menu-bar, the tool-bar, the scroll-bars, tool tips, and
the blinking cursor.

** The default is now to use a bitmap as the icon.
The command-line options --icon-type, -i have been replaced with
options --no-bitmap-icon, -nbi to turn the bitmap icon off.

Eli Zaretskii's avatar
Eli Zaretskii committed
343
** If the environment variable EMAIL is defined, Emacs now uses its value
Reiner Steib's avatar
Reiner Steib committed
344
to compute the default value of `user-mail-address', in preference to
Eli Zaretskii's avatar
Eli Zaretskii committed
345
concatenation of `user-login-name' with the name of your host machine.
346

347 348 349

* Incompatible Editing Changes in Emacs 22.1

Kim F. Storm's avatar
Kim F. Storm committed
350 351 352 353
** You can now follow links by clicking Mouse-1 on the link.

See below for more details.

354 355 356 357 358 359 360 361 362 363
** When the undo information of the current command gets really large
(beyond the value of `undo-outer-limit'), Emacs discards it and warns
you about it.

** When Emacs prompts for file names, SPC no longer completes the file name.
This is so filenames with embedded spaces could be input without the
need to quote the space with a C-q.  The underlying changes in the
keymaps that are active in the minibuffer are described below under
"New keymaps for typing file names".

364
If you want the old behavior back, add these two key bindings to your
365 366 367 368 369 370 371
~/.emacs init file:

  (define-key minibuffer-local-filename-completion-map
  	      " " 'minibuffer-complete-word)
  (define-key minibuffer-local-must-match-filename-map
  	      " " 'minibuffer-complete-word)

372 373 374 375 376 377 378 379
** The completion commands TAB, SPC and ? in the minibuffer apply only
to the text before point.  If there is text in the buffer after point,
it remains unchanged.

** In incremental search, C-w is changed.  M-%, C-M-w and C-M-y are special.

See below under "incremental search changes".

380 381 382 383 384 385 386 387 388 389 390
** M-g is now a prefix key.
M-g g and M-g M-g run goto-line.
M-g n and M-g M-n run next-error (like C-x `).
M-g p and M-g M-p run previous-error.

** C-u M-g M-g switches to the most recent previous buffer,
and goes to the specified line in that buffer.

When goto-line starts to execute, if there's a number in the buffer at
point then it acts as the default argument for the minibuffer.

Kim F. Storm's avatar
Kim F. Storm committed
391 392 393
** M-o now is the prefix key for setting text properties;
M-o M-o requests refontification.

394 395
** C-x C-f RET (find-file), typing nothing in the minibuffer, is no longer
a special case.
396 397 398 399 400

Since the default input is the current directory, this has the effect
of specifying the current directory.  Normally that means to visit the
directory with Dired.

401 402 403
You can get the old behavior by typing C-x C-f M-n RET, which fetches
the actual file name into the minibuffer.

404 405 406 407 408 409
** In Dired's ! command (dired-do-shell-command), `*' and `?' now
control substitution of the file names only when they are surrounded
by whitespace.  This means you can now use them as shell wildcards
too.  If you want to use just plain `*' as a wildcard, type `*""'; the
doublequotes make no difference in the shell, but they prevent
special treatment in `dired-do-shell-command'.
410

Kim F. Storm's avatar
Kim F. Storm committed
411 412 413 414 415 416 417 418
** The info-search bindings on C-h C-f, C-h C-k and C-h C-i
have been moved to C-h F, C-h K and C-h S.

** `apply-macro-to-region-lines' now operates on all lines that begin
in the region, rather than on all complete lines in the region.

** line-move-ignore-invisible now defaults to t.

419 420 421
** Adaptive filling misfeature removed.
It no longer treats `NNN.' or `(NNN)' as a prefix.

422 423 424 425
** The old bindings C-M-delete and C-M-backspace have been deleted,
since there are situations where one or the other will shut down
the operating system or your X server.

Kim F. Storm's avatar
Kim F. Storm committed
426 427 428 429 430 431 432
** The register compatibility key bindings (deprecated since Emacs 19)
have been removed:
  C-x /   point-to-register (Use: C-x r SPC)
  C-x j   jump-to-register  (Use: C-x r j)
  C-x x   copy-to-register  (Use: C-x r s)
  C-x g   insert-register   (Use: C-x r i)

Richard M. Stallman's avatar
Richard M. Stallman committed
433 434 435

* Editing Changes in Emacs 22.1

436 437 438
** The max size of buffers and integers has been doubled.
On 32bit machines, it is now 256M (i.e. 268435455).

439 440 441 442 443 444 445
** !MEM FULL! at the start of the mode line indicates that Emacs
cannot get any more memory for Lisp data.  This often means it could
crash soon if you do things that use more memory.  On most systems,
killing buffers will get out of this state.  If killing buffers does
not make !MEM FULL! disappear, you should save your work and start
a new Emacs.

446
** `undo-only' does an undo which does not redo any previous undo.
Richard M. Stallman's avatar
Richard M. Stallman committed
447

448 449 450 451
** Yanking text now discards certain text properties that can
be inconvenient when you did not expect them.  The variable
`yank-excluded-properties' specifies which ones.  Insertion
of register contents and rectangles also discards these properties.
452

453 454
** New command `kill-whole-line' kills an entire line at once.
By default, it is bound to C-S-<backspace>.
455 456 457

** M-SPC (just-one-space) when given a numeric argument N
converts whitespace around point to N spaces.
Richard M. Stallman's avatar
Richard M. Stallman committed
458

459 460 461 462 463
** You can now switch buffers in a cyclic order with C-x C-left
(previous-buffer) and C-x C-right (next-buffer).  C-x left and
C-x right can be used as well.  The functions keep a different buffer
cycle for each frame, using the frame-local buffer list.

464 465 466 467
** C-x 5 C-o displays a specified buffer in another frame
but does not switch to that frame.  It's the multi-frame
analogue of C-x 4 C-o.

468 469 470
** `special-display-buffer-names' and `special-display-regexps' now
understand two new boolean pseudo-frame-parameters `same-frame' and
`same-window'.
471

Kim F. Storm's avatar
Kim F. Storm committed
472 473 474
** New commands to operate on pairs of open and close characters:
`insert-pair', `delete-pair', `raise-sexp'.

475
** M-x setenv now expands environment variable references.
Richard M. Stallman's avatar
Richard M. Stallman committed
476

477 478 479
Substrings of the form `$foo' and `${foo}' in the specified new value
now refer to the value of environment variable foo.  To include a `$'
in the value, use `$$'.
Richard M. Stallman's avatar
Richard M. Stallman committed
480

481 482
** The default values of paragraph-start and indent-line-function have
been changed to reflect those used in Text mode rather than those used
483
in Paragraph-Indent Text mode.
Richard M. Stallman's avatar
Richard M. Stallman committed
484 485 486 487

** The default for the paper size (variable ps-paper-type) is taken
from the locale.

488
** Help command changes:
Juri Linkov's avatar
Juri Linkov committed
489

490
*** Changes in C-h bindings:
Richard M. Stallman's avatar
Richard M. Stallman committed
491 492 493

C-h e displays the *Messages* buffer.

Kim F. Storm's avatar
Kim F. Storm committed
494 495
C-h d runs apropos-documentation.

496 497
C-h r visits the Emacs Manual in Info.

Richard M. Stallman's avatar
Richard M. Stallman committed
498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522
C-h followed by a control character is used for displaying files
    that do not change:

C-h C-f displays the FAQ.
C-h C-e displays the PROBLEMS file.

The info-search bindings on C-h C-f, C-h C-k and C-h C-i
have been moved to C-h F, C-h K and C-h S.

C-h c, C-h k, C-h w, and C-h f now handle remapped interactive commands.
- C-h c and C-h k report the actual command (after possible remapping)
  run by the key sequence.
- C-h w and C-h f on a command which has been remapped now report the
  command it is remapped to, and the keys which can be used to run
  that command.

For example, if C-k is bound to kill-line, and kill-line is remapped
to new-kill-line, these commands now report:
- C-h c and C-h k C-k reports:
  C-k runs the command new-kill-line
- C-h w and C-h f kill-line reports:
  kill-line is remapped to new-kill-line which is on C-k, <deleteline>
- C-h w and C-h f new-kill-line reports:
  new-kill-line is on C-k

523 524 525 526 527 528 529 530 531 532 533 534
*** The apropos commands now accept a list of words to match.
When more than one word is specified, at least two of those words must
be present for an item to match.  Regular expression matching is still
available.

*** The new option `apropos-sort-by-scores' causes the matching items
to be sorted according to their score.  The score for an item is a
number calculated to indicate how well the item matches the words or
regular expression that you entered to the apropos command.  The best
match is listed first, and the calculated score is shown for each
matching item.

Richard M. Stallman's avatar
Richard M. Stallman committed
535 536 537 538 539 540 541 542 543 544 545 546 547 548
*** Help commands `describe-function' and `describe-key' now show function
arguments in lowercase italics on displays that support it.  To change the
default, customize face `help-argument-name' or redefine the function
`help-default-arg-highlight'.

*** C-h v and C-h f commands now include a hyperlink to the C source for
variables and functions defined in C (if the C source is available).

*** Help mode now only makes hyperlinks for faces when the face name is
preceded or followed by the word `face'.  It no longer makes
hyperlinks for variables without variable documentation, unless
preceded by one of the words `variable' or `option'.  It now makes
hyperlinks to Info anchors (or nodes) if the anchor (or node) name is
enclosed in single quotes and preceded by `info anchor' or `Info
Juanma Barranquero's avatar
Juanma Barranquero committed
549
anchor' (in addition to earlier `info node' and `Info node').  In
550 551
addition, it now makes hyperlinks to URLs as well if the URL is
enclosed in single quotes and preceded by `URL'.
Richard M. Stallman's avatar
Richard M. Stallman committed
552 553 554 555 556 557 558

*** The new command `describe-char' (C-u C-x =) pops up a buffer with
description various information about a character, including its
encodings and syntax, its text properties, how to input, overlays, and
widgets at point.  You can get more information about some of them, by
clicking on mouse-sensitive areas or moving there and pressing RET.

Richard M. Stallman's avatar
Richard M. Stallman committed
559 560 561
*** The command `list-text-properties-at' has been deleted because
C-u C-x = gives the same information and more.

Richard M. Stallman's avatar
Richard M. Stallman committed
562 563 564 565 566 567
*** New command `display-local-help' displays any local help at point
in the echo area.  It is bound to `C-h .'.  It normally displays the
same string that would be displayed on mouse-over using the
`help-echo' property, but, in certain cases, it can display a more
keyboard oriented alternative.

568
*** New user option `help-at-pt-display-when-idle' allows you to
Richard M. Stallman's avatar
Richard M. Stallman committed
569 570 571 572 573
automatically show the help provided by `display-local-help' on
point-over, after suitable idle time.  The amount of idle time is
determined by the user option `help-at-pt-timer-delay' and defaults
to one second.  This feature is turned off by default.

574
** Mark command changes:
Richard M. Stallman's avatar
Richard M. Stallman committed
575

576
*** A prefix argument is no longer required to repeat a jump to a
577 578 579
previous mark if you set `set-mark-command-repeat-pop' to t.  I.e. C-u
C-SPC C-SPC C-SPC ... cycles through the mark ring.  Use C-u C-u C-SPC
to set the mark immediately after a jump.
580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618

*** Marking commands extend the region when invoked multiple times.

If you type C-M-SPC (mark-sexp), M-@ (mark-word), M-h
(mark-paragraph), or C-M-h (mark-defun) repeatedly, the marked region
extends each time, so you can mark the next two sexps with M-C-SPC
M-C-SPC, for example.  This feature also works for
mark-end-of-sentence, if you bind that to a key.  It also extends the
region when the mark is active in Transient Mark mode, regardless of
the last command.  To start a new region with one of marking commands
in Transient Mark mode, you can deactivate the active region with C-g,
or set the new mark with C-SPC.

*** Some commands do something special in Transient Mark mode when the
mark is active--for instance, they limit their operation to the
region.  Even if you don't normally use Transient Mark mode, you might
want to get this behavior from a particular command.  There are two
ways you can enable Transient Mark mode and activate the mark, for one
command only.

One method is to type C-SPC C-SPC; this enables Transient Mark mode
and sets the mark at point.  The other method is to type C-u C-x C-x.
This enables Transient Mark mode temporarily but does not alter the
mark or the region.

After these commands, Transient Mark mode remains enabled until you
deactivate the mark.  That typically happens when you type a command
that alters the buffer, but you can also deactivate the mark by typing
C-g.

*** Movement commands `beginning-of-buffer', `end-of-buffer',
`beginning-of-defun', `end-of-defun' do not set the mark if the mark
is already active in Transient Mark mode.

*** M-h (mark-paragraph) now accepts a prefix arg.

With positive arg, M-h marks the current and the following paragraphs;
if the arg is negative, it marks the current and the preceding
paragraphs.
Richard M. Stallman's avatar
Richard M. Stallman committed
619 620 621

** Incremental Search changes:

622 623 624
*** M-% typed in isearch mode invokes `query-replace' or
`query-replace-regexp' (depending on search mode) with the current
search string used as the string to replace.
Richard M. Stallman's avatar
Richard M. Stallman committed
625 626 627 628 629 630 631 632 633 634 635 636 637

*** C-w in incremental search now grabs either a character or a word,
making the decision in a heuristic way.  This new job is done by the
command `isearch-yank-word-or-char'.  To restore the old behavior,
bind C-w to `isearch-yank-word' in `isearch-mode-map'.

*** C-y in incremental search now grabs the next line if point is already
at the end of a line.

*** C-M-w deletes and C-M-y grabs a character in isearch mode.
Another method to grab a character is to enter the minibuffer by `M-e'
and to type `C-f' at the end of the search string in the minibuffer.

638 639 640 641 642
*** Vertical scrolling is now possible within incremental search.
To enable this feature, customize the new user option
`isearch-allow-scroll'.  User written commands which satisfy stringent
constraints can be marked as "scrolling commands".  See the Emacs manual
for details.
Richard M. Stallman's avatar
Richard M. Stallman committed
643 644 645 646 647 648

*** Isearch no longer adds `isearch-resume' commands to the command
history by default.  To enable this feature, customize the new
user option `isearch-resume-in-command-history'.

** Replace command changes:
Richard M. Stallman's avatar
Richard M. Stallman committed
649

Richard M. Stallman's avatar
Richard M. Stallman committed
650 651 652
*** When used interactively, the commands `query-replace-regexp' and
`replace-regexp' allow \,expr to be used in a replacement string,
where expr is an arbitrary Lisp expression evaluated at replacement
653 654 655 656 657 658
time.  `\#' in a replacement string now refers to the count of
replacements already made by the replacement command.  All regular
expression replacement commands now allow `\?' in the replacement
string to specify a position where the replacement string can be
edited for each replacement.  `query-replace-regexp-eval' is now
deprecated since it offers no additional functionality.
Richard M. Stallman's avatar
Richard M. Stallman committed
659

Richard M. Stallman's avatar
Richard M. Stallman committed
660 661
*** query-replace uses isearch lazy highlighting when the new user option
`query-replace-lazy-highlight' is non-nil.
Richard M. Stallman's avatar
Richard M. Stallman committed
662

Richard M. Stallman's avatar
Richard M. Stallman committed
663 664
*** The current match in query-replace is highlighted in new face
`query-replace' which by default inherits from isearch face.
Richard M. Stallman's avatar
Richard M. Stallman committed
665

666 667 668
*** New user option `query-replace-skip-read-only': when non-nil,
`query-replace' and related functions simply ignore
a match if part of it has a read-only property.
669

670
** Local variables lists:
671

672 673 674 675 676 677
*** If the local variables list contains any variable-value pairs that
are not known to be safe, Emacs shows a prompt asking whether to apply
the local variables list as a whole.  In earlier versions, a prompt
was only issued for variables explicitly marked as risky (for the
definition of risky variables, see `risky-local-variable-p').

678
At the prompt, you can choose to save the contents of this local
679 680 681 682 683 684 685
variables list to `safe-local-variable-values'.  This new customizable
option is a list of variable-value pairs that are known to be safe.
Variables can also be marked as safe with the existing
`safe-local-variable' property (see `safe-local-variable-p').
However, risky variables will not be added to
`safe-local-variable-values' in this way.

686 687 688
*** The variable `enable-local-variables' controls how local variable
lists are handled.  t, the default, specifies the standard querying
behavior.  :safe means use only safe values, and ignore the rest.
689
:all means set all variables, whether or not they are safe.
690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707
nil means ignore them all.  Anything else means always query.

*** The variable `safe-local-eval-forms' specifies a list of forms that
are ok to evaluate when they appear in an `eval' local variables
specification.  Normally Emacs asks for confirmation before evaluating
such a form, but if the form appears in this list, no confirmation is
needed.

*** If a function has a non-nil `safe-local-eval-function' property,
that means it is ok to evaluate some calls to that function when it
appears in an `eval' local variables specification.  If the property
is t, then any form calling that function with constant arguments is
ok.  If the property is a function or list of functions, they are called
with the form as argument, and if any returns t, the form is ok to call.

If the form is not "ok to call", that means Emacs asks for
confirmation as before.

708 709 710 711 712 713 714 715
*** In processing a local variables list, Emacs strips the prefix and
suffix from every line before processing all the lines.

*** Text properties in local variables.

A file local variables list cannot specify a string with text
properties--any specified text properties are discarded.

716 717 718 719 720 721 722
** File operation changes:

*** Unquoted `$' in file names do not signal an error any more when
the corresponding environment variable does not exist.
Instead, the `$ENVVAR' text is left as is, so that `$$' quoting
is only rarely needed.

Richard M. Stallman's avatar
Richard M. Stallman committed
723
*** C-x C-f RET, typing nothing in the minibuffer, is no longer a special case.
724

725 726 727
Since the default input is the current directory, this has the effect
of specifying the current directory.  Normally that means to visit the
directory with Dired.
728

Richard M. Stallman's avatar
Richard M. Stallman committed
729
*** C-x s (save-some-buffers) now offers an option `d' to diff a buffer
730
against its file, so you can see what changes you would be saving.
Juri Linkov's avatar
Juri Linkov committed
731

732 733 734 735 736
*** Auto Compression mode is now enabled by default.

*** If the user visits a file larger than `large-file-warning-threshold',
Emacs asks for confirmation.

Richard M. Stallman's avatar
Richard M. Stallman committed
737
*** The commands copy-file, rename-file, make-symbolic-link and
738 739 740 741 742
add-name-to-file, when given a directory as the "new name" argument,
convert it to a file name by merging in the within-directory part of
the existing file's name.  (This is the same convention that shell
commands cp, mv, and ln follow.)  Thus, M-x copy-file RET ~/foo RET
/tmp RET copies ~/foo to /tmp/foo.
Stefan Monnier's avatar
Stefan Monnier committed
743

Richard M. Stallman's avatar
Richard M. Stallman committed
744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759
*** require-final-newline now has two new possible values:

`visit' means add a newline (as an undoable change) if it's needed
when visiting the file.

`visit-save' means add a newline (as an undoable change) if it's
needed when visiting the file, and also add a newline if it's needed
when saving the file.

*** The new option mode-require-final-newline controls how certain
major modes enable require-final-newline.  Any major mode that's
designed for a kind of file that should normally end in a newline
sets require-final-newline based on mode-require-final-newline.
So you can customize mode-require-final-newline to control what these
modes do.

760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784
*** When you are root, and you visit a file whose modes specify
read-only, the Emacs buffer is now read-only too.  Type C-x C-q if you
want to make the buffer writable.  (As root, you can in fact alter the
file.)

*** find-file-read-only visits multiple files in read-only mode,
when the file name contains wildcard characters.

*** find-alternate-file replaces the current file with multiple files,
when the file name contains wildcard characters.  It now asks if you
wish save your changes and not just offer to kill the buffer.

*** When used interactively, `format-write-file' now asks for confirmation
before overwriting an existing file, unless a prefix argument is
supplied.  This behavior is analogous to `write-file'.

*** The variable `auto-save-file-name-transforms' now has a third element that
controls whether or not the function `make-auto-save-file-name' will
attempt to construct a unique auto-save name (e.g. for remote files).

*** The new option `write-region-inhibit-fsync' disables calls to fsync
in `write-region'.  This can be useful on laptops to avoid spinning up
the hard drive upon each file save.  Enabling this variable may result
in data loss, use with care.

Richard M. Stallman's avatar
Richard M. Stallman committed
785
** Minibuffer changes:
Luc Teirlinck's avatar
Luc Teirlinck committed
786

787 788 789 790
*** The completion commands TAB, SPC and ? in the minibuffer apply only
to the text before point.  If there is text in the buffer after point,
it remains unchanged.

Stefan Monnier's avatar
Stefan Monnier committed
791 792 793
*** The new file-name-shadow-mode is turned ON by default, so that when
entering a file name, any prefix which Emacs will ignore is dimmed.

Richard M. Stallman's avatar
Richard M. Stallman committed
794
*** There's a new face `minibuffer-prompt'.
795 796 797
Emacs adds this face to the list of text properties stored in the
variable `minibuffer-prompt-properties', which is used to display the
prompt string.
Luc Teirlinck's avatar
Luc Teirlinck committed
798

799
*** Enhanced visual feedback in `*Completions*' buffer.
800

801 802
Completions lists use faces to highlight what all completions
have in common and where they begin to differ.
803

804 805 806 807 808 809 810 811
The common prefix shared by all possible completions uses the face
`completions-common-part', while the first character that isn't the
same uses the face `completions-first-difference'.  By default,
`completions-common-part' inherits from `default', and
`completions-first-difference' inherits from `bold'.  The idea of
`completions-common-part' is that you can use it to make the common
parts less visible than normal, so that the rest of the differing
parts is, by contrast, slightly highlighted.
Stefan Monnier's avatar
Stefan Monnier committed
812

813
Above fontification is always done when listing completions is
Juanma Barranquero's avatar
Juanma Barranquero committed
814
triggered at minibuffer.  If you want to fontify completions whose
815 816 817 818
listing is triggered at the other normal buffer, you have to pass
the common prefix of completions to `display-completion-list' as
its second argument.

Richard M. Stallman's avatar
Richard M. Stallman committed
819
*** File-name completion can now ignore specified directories.
820 821 822 823 824
If an element of the list in `completion-ignored-extensions' ends in a
slash `/', it indicates a subdirectory that should be ignored when
completing file names.  Elements of `completion-ignored-extensions'
which do not end in a slash are never considered when a completion
candidate is a directory.
Stefan Monnier's avatar
Stefan Monnier committed
825

Richard M. Stallman's avatar
Richard M. Stallman committed
826
*** New user option `history-delete-duplicates'.
827
If set to t when adding a new history element, all previous identical
828
elements are deleted from the history list.
829

Richard M. Stallman's avatar
Richard M. Stallman committed
830
** Redisplay changes:
Nick Roberts's avatar
Nick Roberts committed
831

832 833 834
*** The new face `mode-line-inactive' is used to display the mode line
of non-selected windows.  The `mode-line' face is now used to display
the mode line of the currently selected window.
Kim F. Storm's avatar
Kim F. Storm committed
835

836 837
The new variable `mode-line-in-non-selected-windows' controls whether
the `mode-line-inactive' face is used.
Kim F. Storm's avatar
Kim F. Storm committed
838

839 840 841 842
*** The mode line position information now comes before the major mode.
When the file is maintained under version control, that information
appears between the position information and the major mode.

843 844 845 846 847
*** You can now customize the use of window fringes.  To control this
for all frames, use M-x fringe-mode or the Show/Hide submenu of the
top-level Options menu, or customize the `fringe-mode' variable.  To
control this for a specific frame, use the command M-x
set-fringe-style.
848

849 850 851
*** Angle icons in the fringes can indicate the buffer boundaries.  In
addition, up and down arrow bitmaps in the fringe indicate which ways
the window can be scrolled.
Richard M. Stallman's avatar
Richard M. Stallman committed
852

853 854 855
This behavior is activated by setting the buffer-local variable
`indicate-buffer-boundaries' to a non-nil value.  The default value of
this variable is found in `default-indicate-buffer-boundaries'.
Richard M. Stallman's avatar
Richard M. Stallman committed
856

857 858
If value is `left' or `right', both angle and arrow bitmaps are
displayed in the left or right fringe, resp.
859

Juanma Barranquero's avatar
Juanma Barranquero committed
860
The value can also be an alist which specifies the presence and
Richard M. Stallman's avatar
Richard M. Stallman committed
861
position of each bitmap individually.
862

Richard M. Stallman's avatar
Richard M. Stallman committed
863 864 865 866
For example, ((top . left) (t .  right)) places the top angle bitmap
in left fringe, the bottom angle bitmap in right fringe, and both
arrow bitmaps in right fringe.  To show just the angle bitmaps in the
left fringe, but no arrow bitmaps, use ((top . left) (bottom . left)).
867

Richard M. Stallman's avatar
Richard M. Stallman committed
868 869 870 871 872
*** On window systems, lines which are exactly as wide as the window
(not counting the final newline character) are no longer broken into
two lines on the display (with just the newline on the second line).
Instead, the newline now "overflows" into the right fringe, and the
cursor will be displayed in the fringe when positioned on that newline.
873

Richard M. Stallman's avatar
Richard M. Stallman committed
874
The new user option 'overflow-newline-into-fringe' can be set to nil to
Richard M. Stallman's avatar
Richard M. Stallman committed
875
revert to the old behavior of continuing such lines.
876

Richard M. Stallman's avatar
Richard M. Stallman committed
877
*** A window can now have individual fringe and scroll-bar settings,
Richard M. Stallman's avatar
Richard M. Stallman committed
878 879 880 881 882 883
in addition to the individual display margin settings.

Such individual settings are now preserved when windows are split
horizontally or vertically, a saved window configuration is restored,
or when the frame is resized.

884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919
*** When a window has display margin areas, the fringes are now
displayed between the margins and the buffer's text area, rather than
outside those margins.

*** New face `escape-glyph' highlights control characters and escape glyphs.

*** Non-breaking space and hyphens are now displayed with a special
face, either nobreak-space or escape-glyph.  You can turn this off or
specify a different mode by setting the variable `nobreak-char-display'.

*** The parameters of automatic hscrolling can now be customized.
The variable `hscroll-margin' determines how many columns away from
the window edge point is allowed to get before automatic hscrolling
will horizontally scroll the window.  The default value is 5.

The variable `hscroll-step' determines how many columns automatic
hscrolling scrolls the window when point gets too close to the
window edge.  If its value is zero, the default, Emacs scrolls the
window so as to center point.  If its value is an integer, it says how
many columns to scroll.  If the value is a floating-point number, it
gives the fraction of the window's width to scroll the window.

The variable `automatic-hscrolling' was renamed to
`auto-hscroll-mode'.  The old name is still available as an alias.

*** Moving or scrolling through images (and other lines) taller than
the window now works sensibly, by automatically adjusting the window's
vscroll property.

*** Preemptive redisplay now adapts to current load and bandwidth.

To avoid preempting redisplay on fast computers, networks, and displays,
the arrival of new input is now performed at regular intervals during
redisplay.  The new variable `redisplay-preemption-period' specifies
the period; the default is to check for input every 0.1 seconds.

920 921 922 923 924
*** The %c and %l constructs are now ignored in frame-title-format.
Due to technical limitations in how Emacs interacts with windowing
systems, these constructs often failed to render properly, and could
even cause Emacs to crash.

Kim F. Storm's avatar
Kim F. Storm committed
925 926 927 928
*** If value of `auto-resize-tool-bars' is `grow-only', the tool bar
will expand as needed, but not contract automatically.  To contract
the tool bar, you must type C-l.

929 930
*** New customize option `overline-margin' controls the space between
overline and text.
931

932 933 934
*** New variable `x-underline-at-descent-line' controls the relative
position of the underline.  When set, it overrides the
`x-use-underline-position-properties' variables.
Stefan Monnier's avatar
Stefan Monnier committed
935

936 937 938 939 940 941
** New faces:

*** `mode-line-highlight' is the standard face indicating mouse sensitive
elements on mode-line (and header-line) like `highlight' face on text
areas.

Juri Linkov's avatar
Juri Linkov committed
942 943 944
*** `mode-line-buffer-id' is the standard face for buffer identification
parts of the mode line.

945 946 947 948 949 950 951
*** `shadow' face defines the appearance of the "shadowed" text, i.e.
the text which should be less noticeable than the surrounding text.
This can be achieved by using shades of grey in contrast with either
black or white default foreground color.  This generic shadow face
allows customization of the appearance of shadowed text in one place,
so package-specific faces can inherit from it.

952 953
*** `vertical-border' face is used for the vertical divider between windows.

Kim F. Storm's avatar
Kim F. Storm committed
954
** Font-Lock (syntax highlighting) changes:
Richard M. Stallman's avatar
Richard M. Stallman committed
955 956 957 958 959 960 961 962 963

*** All modes now support using M-x font-lock-mode to toggle
fontification, even those such as Occur, Info, and comint-derived
modes that do their own fontification in a special way.

The variable `Info-fontify' is no longer applicable; to disable
fontification in Info, remove `turn-on-font-lock' from
`Info-mode-hook'.

964
*** New standard font-lock face `font-lock-comment-delimiter-face'.
Richard M. Stallman's avatar
Richard M. Stallman committed
965

966 967
*** New standard font-lock face `font-lock-preprocessor-face'.

Kim F. Storm's avatar
Kim F. Storm committed
968
*** Easy to overlook single character negation can now be font-locked.
969 970 971 972
You can use the new variable `font-lock-negation-char-face' and the face of
the same name to customize this.  Currently the cc-modes, sh-script-mode,
cperl-mode and make-mode support this.

973 974 975 976 977 978 979 980 981 982
*** Font-Lock mode: in major modes such as Lisp mode, where some Emacs
features assume that an open-paren in column 0 is always outside of
any string or comment, Font-Lock now highlights any such open-paren in
bold-red if it is inside a string or a comment, to indicate that it
can cause trouble.  You should rewrite the string or comment so that
the open-paren is not in column 0.

*** M-o now is the prefix key for setting text properties;
M-o M-o requests refontification.

Richard M. Stallman's avatar
Richard M. Stallman committed
983
*** The default settings for JIT stealth lock parameters are changed.
984 985 986 987 988 989 990 991 992 993
The default value for the user option jit-lock-stealth-time is now nil
instead of 3.  This setting of jit-lock-stealth-time disables stealth
fontification: on today's machines, it may be a bug in font lock
patterns if fontification otherwise noticeably degrades interactivity.
If you find movement in infrequently visited buffers sluggish (and the
major mode maintainer has no better idea), customizing
jit-lock-stealth-time to a non-nil value will let Emacs fontify
buffers in the background when it considers the system to be idle.
jit-lock-stealth-nice is now 0.5 instead of 0.125 which is supposed to
cause less load than the old defaults.
Richard M. Stallman's avatar
Richard M. Stallman committed
994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007

*** jit-lock can now be delayed with `jit-lock-defer-time'.

If this variable is non-nil, its value should be the amount of Emacs
idle time in seconds to wait before starting fontification.  For
example, if you set `jit-lock-defer-time' to 0.25, fontification will
only happen after 0.25s of idle time.

*** contextual refontification is now separate from stealth fontification.

jit-lock-defer-contextually is renamed jit-lock-contextually and
jit-lock-context-time determines the delay after which contextual
refontification takes place.

1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018
*** lazy-lock is considered obsolete.

The `lazy-lock' package is superseded by `jit-lock' and is considered
obsolete.  `jit-lock' is activated by default; if you wish to continue
using `lazy-lock', activate it in your ~/.emacs like this:
  (setq font-lock-support-mode 'lazy-lock-mode)

If you invoke `lazy-lock-mode' directly rather than through
`font-lock-support-mode', it now issues a warning:
  "Use font-lock-support-mode rather than calling lazy-lock-mode"

1019
** Menu support:
Richard M. Stallman's avatar
Richard M. Stallman committed
1020 1021 1022 1023 1024 1025

*** A menu item "Show/Hide" was added to the top-level menu "Options".
This menu allows you to turn various display features on and off (such
as the fringes, the tool bar, the speedbar, and the menu bar itself).
You can also move the vertical scroll bar to either side here or turn
it off completely.  There is also a menu-item to toggle displaying of
1026
current date and time, current line and column number in the mode-line.
Richard M. Stallman's avatar
Richard M. Stallman committed
1027 1028 1029

*** Speedbar has moved from the "Tools" top level menu to "Show/Hide".

1030 1031 1032 1033
*** The menu item "Open File..." has been split into two items, "New File..."
and "Open File...".  "Open File..." now opens only existing files.  This is
to support existing GUI file selection dialogs better.

Glenn Morris's avatar
Glenn Morris committed
1034
*** The file selection dialog for Gtk+, Mac, W32 and Motif/LessTif can be
1035 1036 1037 1038 1039
disabled by customizing the variable `use-file-dialog'.

*** The pop up menus for Lucid now stay up if you do a fast click and can
be navigated with the arrow keys (like Gtk+, Mac and W32).

Glenn Morris's avatar
Glenn Morris committed
1040
*** The menu bar for Motif/LessTif/Lucid/Gtk+ can be navigated with keys.
1041 1042 1043
Pressing F10 shows the first menu in the menu bar.  Navigation is done with
the arrow keys, select with the return key and cancel with the escape keys.

1044 1045 1046 1047
*** The Lucid menus can display multilingual text in your locale.  You have
to explicitly specify a fontSet resource for this to work, for example
`-xrm "Emacs*fontSet:  -*-helvetica-medium-r-*--*-120-*-*-*-*-*-*,*"'.

Glenn Morris's avatar
Glenn Morris committed
1048
*** Dialogs for Lucid/Athena and LessTif/Motif now pop down on pressing
1049 1050
ESC, like they do for Gtk+, Mac and W32.

Jan Djärv's avatar
Jan Djärv committed
1051
*** For the Gtk+ version, you can make Emacs use the old file dialog
1052
by setting the variable `x-gtk-use-old-file-dialog' to t.  Default is to use
1053 1054
the new dialog.

1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083
*** You can exit dialog windows and menus by typing C-g.

** Buffer Menu changes:

*** The new options `buffers-menu-show-directories' and
`buffers-menu-show-status' let you control how buffers are displayed
in the menu dropped down when you click "Buffers" from the menu bar.

`buffers-menu-show-directories' controls whether the menu displays
leading directories as part of the file name visited by the buffer.
If its value is `unless-uniquify', the default, directories are
shown unless uniquify-buffer-name-style' is non-nil.  The value of nil
and t turn the display of directories off and on, respectively.

`buffers-menu-show-status' controls whether the Buffers menu includes
the modified and read-only status of the buffers.  By default it is
t, and the status is shown.

Setting these variables directly does not take effect until next time
the Buffers menu is regenerated.

*** New command `Buffer-menu-toggle-files-only' toggles display of file
buffers only in the Buffer Menu.  It is bound to T in Buffer Menu
mode.

*** `buffer-menu' and `list-buffers' now list buffers whose names begin
with a space, when those buffers are visiting files.  Normally buffers
whose names begin with space are omitted.

Richard M. Stallman's avatar
Richard M. Stallman committed
1084
** Mouse changes:
1085

Richard M. Stallman's avatar
Richard M. Stallman committed
1086
*** You can now follow links by clicking Mouse-1 on the link.
1087 1088 1089 1090 1091

Traditionally, Emacs uses a Mouse-1 click to set point and a Mouse-2
click to follow a link, whereas most other applications use a Mouse-1
click for both purposes, depending on whether you click outside or
inside a link.  Now the behavior of a Mouse-1 click has been changed
Glenn Morris's avatar
Glenn Morris committed
1092
to match this context-sensitive dual behavior.  (If you prefer the old
Luc Teirlinck's avatar
Luc Teirlinck committed
1093
behavior, set the user option `mouse-1-click-follows-link' to nil.)
1094

Richard M. Stallman's avatar
Richard M. Stallman committed
1095
Depending on the current mode, a Mouse-2 click in Emacs can do much
1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114
more than just follow a link, so the new Mouse-1 behavior is only
activated for modes which explicitly mark a clickable text as a "link"
(see the new function `mouse-on-link-p' for details).  The Lisp
packages that are included in release 22.1 have been adapted to do
this, but external packages may not yet support this.  However, there
is no risk in using such packages, as the worst thing that could
happen is that you get the original Mouse-1 behavior when you click
on a link, which typically means that you set point where you click.

If you want to get the original Mouse-1 action also inside a link, you
just need to press the Mouse-1 button a little longer than a normal
click (i.e. press and hold the Mouse-1 button for half a second before
you release it).

Dragging the Mouse-1 inside a link still performs the original
drag-mouse-1 action, typically copy the text.

You can customize the new Mouse-1 behavior via the new user options
`mouse-1-click-follows-link' and `mouse-1-click-in-non-selected-windows'.
Juri Linkov's avatar
Juri Linkov committed
1115

Kim F. Storm's avatar
Kim F. Storm committed
1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127
*** If you set the new variable `mouse-autoselect-window' to a non-nil
value, windows are automatically selected as you move the mouse from
one Emacs window to another, even within a frame.  A minibuffer window
can be selected only when it is active.

*** On X, when the window manager requires that you click on a frame to
select it (give it focus), the selected window and cursor position
normally changes according to the mouse click position.  If you set
the variable x-mouse-click-focus-ignore-position to t, the selected
window and cursor position do not change when you click on a frame
to give it focus.

Richard M. Stallman's avatar
Richard M. Stallman committed
1128
*** Emacs normally highlights mouse sensitive text whenever the mouse
1129 1130 1131 1132
is over the text.  By setting the new variable `mouse-highlight', you
can optionally enable mouse highlighting only after you move the
mouse, so that highlighting disappears when you press a key.  You can
also disable mouse highlighting.
1133

Richard M. Stallman's avatar
Richard M. Stallman committed
1134
*** You can now customize if selecting a region by dragging the mouse
1135 1136 1137
shall not copy the selected text to the kill-ring by setting the new
variable mouse-drag-copy-region to nil.

1138
*** Under X, mouse-wheel-mode is turned on by default.
1139

1140 1141 1142 1143 1144
*** Emacs ignores mouse-2 clicks while the mouse wheel is being moved.

People tend to push the mouse wheel (which counts as a mouse-2 click)
unintentionally while turning the wheel, so these clicks are now
ignored.  You can customize this with the mouse-wheel-click-event and
1145
mouse-wheel-inhibit-click-time variables.
Juri Linkov's avatar
Juri Linkov committed
1146

1147 1148
*** mouse-wheels can now scroll a specific fraction of the window
(rather than a fixed number of lines) and the scrolling is `progressive'.
Juri Linkov's avatar
Juri Linkov committed
1149

Kim F. Storm's avatar
Kim F. Storm committed
1150
** Multilingual Environment (Mule) changes:
1151

1152 1153 1154 1155 1156 1157 1158
*** You can disable character translation for a file using the -*-
construct.  Include `enable-character-translation: nil' inside the
-*-...-*- to disable any character translation that may happen by
various global and per-coding-system translation tables.  You can also
specify it in a local variable list at the end of the file.  For
shortcut, instead of using this long variable name, you can append the
character "!" at the end of coding-system name specified in -*-