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

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

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

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

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

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

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

23 24 25

* About external Lisp packages

26

27
* Installation Changes in Emacs 23.1
28

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

Chong Yidong's avatar
Chong Yidong committed
33 34 35
** New font code.
Fonts are handled by new code capable of dealing with multiple font
backends.  This requires the freetype and fontconfig libraries
36

Chong Yidong's avatar
Chong Yidong committed
37 38
*** 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
39

Chong Yidong's avatar
Chong Yidong committed
40 41 42 43 44 45 46 47 48
*** 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.
49

Chong Yidong's avatar
Chong Yidong committed
50
** Changes to image support
Chong Yidong's avatar
Chong Yidong committed
51
---
Chong Yidong's avatar
Chong Yidong committed
52
*** configure now checks for libgif before libungif when searching for
53
a GIF library.
Chong Yidong's avatar
Chong Yidong committed
54
+++
Chong Yidong's avatar
Chong Yidong committed
55 56 57 58
*** Emacs now supports the SVG image format through librsvg2.

** The Mac Carbon port is no longer supported.
Instead, use... [FIXME what?]
Glenn Morris's avatar
Glenn Morris committed
59

Chong Yidong's avatar
Chong Yidong committed
60 61
** The new configuration option "--with-dbus" enables D-Bus language
bindings for Emacs.
62

63 64
** Support for many obsolete platforms has been removed.
See the list at the end of etc/MACHINES for details.
Chong Yidong's avatar
Chong Yidong committed
65
---
Chong Yidong's avatar
Chong Yidong committed
66
*** Support for systems without alloca has been removed.
Chong Yidong's avatar
Chong Yidong committed
67
---
Chong Yidong's avatar
Chong Yidong committed
68
*** Support for Sun windows has been removed.
Chong Yidong's avatar
Chong Yidong committed
69 70
---
*** The `emacstool' utility has been removed.
Chong Yidong's avatar
Chong Yidong committed
71

Chong Yidong's avatar
Chong Yidong committed
72
---
73 74 75 76
** 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
77 78
** The refcards are now shipped as PDF files.

Chong Yidong's avatar
Chong Yidong committed
79
---
Chong Yidong's avatar
Chong Yidong committed
80 81 82
** 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
83 84 85

* Changes in Emacs 23.1

Chong Yidong's avatar
Chong Yidong committed
86
** Improved X Window System support
87

Chong Yidong's avatar
Chong Yidong committed
88 89 90 91 92
*** 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).
93 94 95 96

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

Chong Yidong's avatar
Chong Yidong committed
97 98 99 100
**** Emacsclient can now open new terminal frames.
Now, the default behavior is to open a new Emacs frame by default.
Use the -c option to get the old behavior of opening files in the
currently selected Emacs frame.
101

Chong Yidong's avatar
Chong Yidong committed
102 103
*** The new command close-display-connection closes a connection to a
remote display.
104

Chong Yidong's avatar
Chong Yidong committed
105 106 107
*** 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
108 109 110
http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
for details about XEmbed.

Chong Yidong's avatar
Chong Yidong committed
111 112 113
*** 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
114 115
the X Window System, such as Compiz, Beryl and Compiz Fusion, or on
Windows 2000 and later versions of Windows.
116 117

The alpha parameter should be an integer between 0 (transparent) and
Chong Yidong's avatar
Chong Yidong committed
118 119 120
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
active frame and INACTIVE is the opactity of non-active frames.
121

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

Chong Yidong's avatar
Chong Yidong committed
125
** Internationalization changes
126

Chong Yidong's avatar
Chong Yidong committed
127 128
*** 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
129

Chong Yidong's avatar
Chong Yidong committed
130 131 132 133
The internal encoding used for buffers and strings is now
Unicode-based and called `utf-8-emacs'.  This encoding is backwards
compatible with Unicode's UTF-8 encoding.  The internal encoding
previously used by Emacs, `emacs-mule', is still available.
Nick Roberts's avatar
Nick Roberts committed
134

Chong Yidong's avatar
Chong Yidong committed
135 136 137 138 139 140 141
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,
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.
142

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

Chong Yidong's avatar
Chong Yidong committed
145 146 147
*** 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
148

Chong Yidong's avatar
Chong Yidong committed
149 150
**** The dimension of a charset is now 1, 2, 3, or 4, and the size of
each dimension is no longer limited to 94 or 96.
151

Chong Yidong's avatar
Chong Yidong committed
152 153
**** A dynamic charset priority list is used to infer the charset of
characters for display.
154

Chong Yidong's avatar
Chong Yidong committed
155 156 157
*** There are new language environments for Chinese-GBK,
Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
Sinhala, and TaiViet.
158

Chong Yidong's avatar
Chong Yidong committed
159 160
*** The minor modes unify-8859-on-encoding-mode and
unify-8859-on-decoding-mode are obsolete.
161

Chong Yidong's avatar
Chong Yidong committed
162
** Emacs now supports serial port access on GNU/Linux, Unix, and
163 164 165
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.
166

Chong Yidong's avatar
Chong Yidong committed
167
** Menu Bar changes
168
---
Chong Yidong's avatar
Chong Yidong committed
169 170 171 172 173
*** 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.
174
---
Chong Yidong's avatar
Chong Yidong committed
175 176
*** The font setting chosen by "Set Default Font" is saved if the
"Save Options" item is used.
177

178 179 180
*** 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).
181 182 183 184 185
---
*** 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
the new word wrapping option (see Editing Changes, below).
Glenn Morris's avatar
Glenn Morris committed
186

Chong Yidong's avatar
Chong Yidong committed
187
** Mode-line changes
188

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

Chong Yidong's avatar
Chong Yidong committed
192 193
*** 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.
194

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

Chong Yidong's avatar
Chong Yidong committed
198 199 200 201
** Directory-local variables can now be defined.
By default, Emacs looks in .dir-settings.el for directory-local
variables.  For more information, see `set-directory-project' and
`define-project-bindings'.
202

203

204
* Startup Changes in Emacs 23.1
205

206 207 208 209 210 211
** 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.

212 213 214 215
** New user option `initial-buffer-choice' specifies what to display
after starting Emacs: startup screen, *scratch* buffer, visiting a
file or directory.

216 217 218 219
** 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.
220 221

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

225 226 227 228 229
+++
** 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.

230
---
Reiner Steib's avatar
Reiner Steib committed
231
** The following input methods were removed in Emacs 22.2, but this was
Juanma Barranquero's avatar
Juanma Barranquero committed
232
not advertised: danish-alt-postfix, esperanto-alt-postfix,
Reiner Steib's avatar
Reiner Steib committed
233 234 235 236
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.
237

Richard M. Stallman's avatar
Richard M. Stallman committed
238

239
* Editing Changes in Emacs 23.1
Richard M. Stallman's avatar
Richard M. Stallman committed
240

241 242 243 244 245
** 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
behavior (motion by logical lines based on buffer contents alone).

Chong Yidong's avatar
Chong Yidong committed
246 247 248
** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
invokes `suspend-frame'.  This change is for compatibility with the
new multi-tty support (see `Improved X Window System support' above).
249

Chong Yidong's avatar
Chong Yidong committed
250
** Mark changes
251
+++
252 253 254 255
*** Transient Mark mode is now on by default.
+++
*** mark-even-if-inactive now defaults to t
+++
256 257
*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
activating it.
258
+++
259 260
*** When Transient Mark mode is on, M-q now fills the region if the
region is active.  Otherwise, it fills the current paragraph.
Juri Linkov's avatar
Juri Linkov committed
261
+++
262 263
*** 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
264
word at point.
265 266 267 268 269 270 271
*** When Transient Mark mode is on, TAB now indents the region if the
region is active.
*** `use-empty-active-region' controls whether an empty active region
in Transient Mark mode should make commands operate on that empty
region.

** Temporarily active regions
Chong Yidong's avatar
Chong Yidong committed
272
+++
273 274 275 276
*** 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.
Chong Yidong's avatar
Chong Yidong committed
277
+++
278 279 280 281 282 283 284
*** 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).

285
** Minibuffer changes
286

Chong Yidong's avatar
Chong Yidong committed
287 288 289 290
*** Operations like C-x b and C-x C-f, which use switch-to-buffer, 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.
291

292 293 294 295 296 297
*** 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.
298

Chong Yidong's avatar
Chong Yidong committed
299 300 301 302
*** Minibuffer input of shell commands now comes with completion.

*** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
name of the current buffer.
303

Chong Yidong's avatar
Chong Yidong committed
304 305 306 307 308
*** 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.
309 310 311 312 313 314

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

315 316 317 318 319 320 321 322
*** isearch started in the minibuffer searches in the minibuffer history.
Reverse isearch commands (C-r, C-M-r) search in previous minibuffer
history elements, and forward isearch commands (C-s, C-M-s) search in
next history elements.  When the reverse search reaches the first history
element, it wraps to the last history element, and the forward search
wraps to the first history element.  When the search is terminated, the
history element containing the search string becomes the current.

323 324
** Face changes

325 326 327
*** 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
via face remapping (see below).
328

Glenn Morris's avatar
Glenn Morris committed
329 330
*** FIXME face-remap

Chong Yidong's avatar
Chong Yidong committed
331
** Primary selection changes
332

Chong Yidong's avatar
Chong Yidong committed
333 334 335 336
*** If `select-active-regions' is t, setting the mark automatically
makes the new region into the primary selection (for interaction with
other window applications).  If you enable this, you might want to
bind `mouse-yank-primary' to Mouse-2.
Stefan Monnier's avatar
Stefan Monnier committed
337

338 339
*** You can disable kill ring commands from accessing the primary
selection by setting `x-select-enable-primary' to nil.
340

Chong Yidong's avatar
Chong Yidong committed
341
** Completion changes
342

Chong Yidong's avatar
Chong Yidong committed
343 344
*** `completion-styles' can be customized to choose your favorite
completion style.
345

Chong Yidong's avatar
Chong Yidong committed
346
*** The default completion styles include a form of partial-completion.
347

Chong Yidong's avatar
Chong Yidong committed
348 349
*** The new command `minibuffer-force-complete' chooses one of the
possible completions, rather than stopping at the common prefix.
Glenn Morris's avatar
Glenn Morris committed
350

351 352 353
*** `completion-auto-help' can be set to `lazy' to list the
completions only if you repeat the completion.  This was already
supported in `partial-completion-mode'.
Thien-Thi Nguyen's avatar
Thien-Thi Nguyen committed
354

Chong Yidong's avatar
Chong Yidong committed
355 356 357 358 359 360
** Continuation lines can be wrapped at word boundaries
(word-wrapping) instead of the right window edge.  The new per-buffer
variable `word-wrap', if non-nil turns on word-wrapping.  Word
wrapping does not take place if continuation lines are not shown,
e.g. if truncate-lines is non-nil.

361 362 363 364 365 366 367 368 369
** Window management changes

*** truncate-partial-width-windows now accepts integer values, which
specify a minimum window width for partial-width windows, below which
lines are truncated.  The default has been changed to 30.

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

Chong Yidong's avatar
Chong Yidong committed
370
** Miscellaneous changes:
371

372 373 374 375
*** New keymap `search-map' bound to `M-s' provides global bindings
for search related commands: `M-s o' for `occur', `M-s h r' for
`highlight-regexp' and other hi-lock commands on the `M-s h' prefix.

Chong Yidong's avatar
Chong Yidong committed
376 377 378
*** 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
successive invokations.
Michael Olson's avatar
Michael Olson committed
379

Chong Yidong's avatar
Chong Yidong committed
380
*** scroll-preserve-screen-position also preserves the column position.
Michael Olson's avatar
Michael Olson committed
381

Chong Yidong's avatar
Chong Yidong committed
382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398
*** 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.

+++
*** 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.

*** The new command kill-matching-buffers kills buffers whose name
matches a regexp.

399 400
*** The new commands `pp-macroexpand-expression' and
`pp-macroexpand-last-sexp' pretty-print macro expansions.
Michael Albinus's avatar
Michael Albinus committed
401

Chong Yidong's avatar
Chong Yidong committed
402 403

* New Modes and Packages in Emacs 23.1
404

Chong Yidong's avatar
Chong Yidong committed
405 406
** FIXME add details of new packages imported from lisp/gnus.
[Maybe some information from doc/misc/gnus-coding.texi can be reused]
407

408 409 410 411
** 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
412
** Bubbles, a new game, is similar to SameGame.
413

414 415
** bug-reference.el provides clickable links to bug reports.

416
** copyright.el provides utilities for updating copyright notices in files.
Chong Yidong's avatar
Chong Yidong committed
417 418 419

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

422 423 424
** Doc View Mode allows viewing of PDF, PostScript and DVI documents.
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
425

426 427 428 429
** 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
430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461

** 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.

** minibuffer-indicate-depth-mode shows the minibuffer depth in the prompt.

** 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.

** proced.el provides a Dired-like interface for operating on processes.
Proced makes an Emacs buffer containing a listing of the current
processes (using ps(1)).  You can use the normal Emacs commands to
move around in this buffer, and special Proced commands to operate on
the processes listed.

** 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.

** RST mode is a major mode for editing ReSTructured-Text files.
462

463 464 465 466
** A new `whitespace' package has been installed, and the pre-existing one
renamed to `old-whitespace'.
[FIXME someone explain why this is good, if it is...]

Chong Yidong's avatar
Chong Yidong committed
467 468 469 470 471 472 473 474 475
** 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.


* Changes in Specialized Modes and Packages in Emacs 23.1

** Abbrev has been rewritten in Elisp and extended with more flexibility.
Stefan Monnier's avatar
Stefan Monnier committed
476
*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
477
    abbrev-table-p, abbrev-insert, abbrev-table-menu.
Stefan Monnier's avatar
Stefan Monnier committed
478 479 480 481 482 483
*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
    extra arguments for arbitrary properties.
*** New variable `abbrev-minor-mode-table-alist'.
*** `local-abbrev-table' can hold a list of abbrev-tables.
*** Abbrevs have now the following special properties:
484
    `:count', `:system', `:enable-function', `:case-fixed'.
Stefan Monnier's avatar
Stefan Monnier committed
485 486 487 488
*** Abbrev-tables have now the following special properties:
    `:parents', `:case-fixed', `:enable-function', `:regexp',
    `abbrev-table-modiff'.

Chong Yidong's avatar
Chong Yidong committed
489 490 491
** Apropos
*** `apropos-library' describes the elements defined in a given library.
*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
Martin Rudalics's avatar
Martin Rudalics committed
492

Chong Yidong's avatar
Chong Yidong committed
493
** Archive Mode has basic support to browse Rar archives.
Martin Rudalics's avatar
Martin Rudalics committed
494

Chong Yidong's avatar
Chong Yidong committed
495
** BibTeX mode
Juri Linkov's avatar
Juri Linkov committed
496

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

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

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

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

Chong Yidong's avatar
Chong Yidong committed
507
** Calendar and diary
Juri Linkov's avatar
Juri Linkov committed
508

Chong Yidong's avatar
Chong Yidong committed
509 510 511 512 513
+++
*** 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
514

Chong Yidong's avatar
Chong Yidong committed
515 516 517 518 519 520 521 522
+++
*** 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.

523 524 525 526 527 528 529 530
*** The whitespace in the calendar layout can be customized.
See the variables:
calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
calendar-day-header-width, and calendar-day-digit-width.

*** Text (e.g. ISO weeks) can be displayed between the calendar months.
See the variables calendar-intermonth-header and calendar-intermonth-text.

Chong Yidong's avatar
Chong Yidong committed
531 532 533 534 535
*** The function `holiday-chinese' computes holidays on the Chinese calendar.
It has been used to add items to the list `holiday-oriental-holidays'.

*** `diary-remind' accepts a negative number -DAYS as a shorthand for
the list (1 2 ... DAYS).
536

Dan Nicolaescu's avatar
Dan Nicolaescu committed
537 538 539 540 541 542 543
** Compile and grep modes

*** The mode-line entry for the *compilation* and *grep* buffer is color coded.
It has different colors for to show that: (a) the command is still
running, (b) successful completion, (c) error.

*** compilation-auto-jump-to-first-error tells `compile' to jump to
544 545
the first error encountered during compilations.

Dan Nicolaescu's avatar
Dan Nicolaescu committed
546 547 548 549
*** The `cc' alias for C++ files in `grep-file-aliases' has been
improved. `hh' can be used to match C++ header files and `cchh' both
C++ sources and headers.

Chong Yidong's avatar
Chong Yidong committed
550
** Custom
551
+++
Chong Yidong's avatar
Chong Yidong committed
552
*** defcustom accepts new keyword arguments, `:safe' and `:risky', which
553 554
set a variable's `safe-local-variable' and `risky-local-variable' property.

Chong Yidong's avatar
Chong Yidong committed
555
** Diff mode
556

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

Chong Yidong's avatar
Chong Yidong committed
561 562 563
*** diff-add-change-log-entries-other-window iterates through the diff
buffer and tries to create ChangeLog entries for each change.
It is bound to `C-x 4 A'.
564

Chong Yidong's avatar
Chong Yidong committed
565 566
** Fortran
*** The variable `fortran-line-length' can change the fixed-form line-length.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
567

Chong Yidong's avatar
Chong Yidong committed
568 569
*** In Fortran mode, M-; is now bound to the standard comment-dwim,
rather than fortran-indent-comment.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
570

Chong Yidong's avatar
Chong Yidong committed
571 572
+++
*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
573

Chong Yidong's avatar
Chong Yidong committed
574
** Gnus
575

Chong Yidong's avatar
Chong Yidong committed
576 577 578
*** The Gnus package has been updated
There are many news features, bug fixes and improvements; see the file
GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
Eric S. Raymond's avatar
Eric S. Raymond committed
579

Chong Yidong's avatar
Chong Yidong committed
580 581 582 583
*** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
saving articles drafts and ~/.newsrc.eld.  These file may not be read
correctly in Emacs 22 and below.  If you want to Gnus across different Emacs
versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
584

Chong Yidong's avatar
Chong Yidong committed
585 586 587 588 589 590 591
** Help mode
*** New macro `with-help-window' should set up help windows better
than `with-output-to-temp-buffer' with `print-help-return-message'.
*** New option `help-window-select' permits to customize whether help
window shall be automatically selected when invoking help.
*** New variable `help-window-point-marker' permits to specify new
position of point in help window (for example in `view-lossage').
592

Chong Yidong's avatar
Chong Yidong committed
593
** Isearch
594

595 596 597 598
*** New command `isearch-highlight-regexp' bound to `M-s h r'
in isearch mode runs `highlight-regexp' (`hi-lock-face-buffer')
with the current search string as its regexp argument.

Chong Yidong's avatar
Chong Yidong committed
599 600
*** New command `isearch-occur' bound to `M-s o' in isearch mode
runs `occur' with the current search string.
601

Chong Yidong's avatar
Chong Yidong committed
602 603 604 605
*** isearch can now search through multiple ChangeLog files.
When running isearch in a ChangeLog file, if the search fails,
then another C-s tries searching the previous ChangeLog,
if there is one (e.g. go from ChangeLog to ChangeLog.12).
606

Chong Yidong's avatar
Chong Yidong committed
607
This is enabled if isearch-buffers-multi is non-nil.
608

Chong Yidong's avatar
Chong Yidong committed
609 610
*** The part of an isearch that failed to match is highlighted in `isearch-fail'
face.
611

Chong Yidong's avatar
Chong Yidong committed
612 613 614 615 616
*** `C-h C-h' in isearch mode displays isearch-specific Help screen,
`C-h b' displays all isearch key bindings, `C-h k' displays the full
documentation of the given isearch key sequence, `C-h m' displays
documentation of isearch mode.  All the rest Help commands exit isearch mode
and execute their global definitions.
Glenn Morris's avatar
Glenn Morris committed
617

Chong Yidong's avatar
Chong Yidong committed
618 619
*** When started in the minibuffer, Isearch searches in the minibuffer
history.  See `Minibuffer changes', above.
Roland Winkler's avatar
Roland Winkler committed
620

Chong Yidong's avatar
Chong Yidong committed
621 622 623
** Python
*** The file etc/emacs.py now supports both Python 2 and 3, meaning
that either version can be used as inferior Python by python.el.
Roland Winkler's avatar
Roland Winkler committed
624

Chong Yidong's avatar
Chong Yidong committed
625 626 627 628
*** Python mode now has `pdbtrack' functionality.  When using pdb to
debug a Python program, pdbtrack notices the pdb prompt and displays
the source file and line that the program is stopped at, much the same
way as gud-mode does for debugging C programs with gdb.
Roland Winkler's avatar
Roland Winkler committed
629

Chong Yidong's avatar
Chong Yidong committed
630
** T-mouse Mode
Roland Winkler's avatar
Roland Winkler committed
631

Chong Yidong's avatar
Chong Yidong committed
632 633 634 635 636
*** If the gpm mouse server is running and t-mouse-mode is enabled,
Emacs uses a Unix socket in a GNU/Linux console to talk to server,
rather than faking events using the client program mev.  This C level
approach provides mouse highlighting and help echoing in the
minibuffer.
Roland Winkler's avatar
Roland Winkler committed
637

638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666
+++
** Tramp

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

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

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

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

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

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

667 668 669 670
*** Passwords can be read from an authentification file.
Tramp uses the package `auth-source' to read passwords from a file, if
necessary.

671
** VC and related modes
672

Chong Yidong's avatar
Chong Yidong committed
673 674 675 676 677
*** VC now supports applying VC operations to a set of files at a time.
This enables VC to work much more effectively with changeset-oriented
version-control systems such as Subversion, GNU Arch, Mercurial, Git
and Bzr.  VC will now pass a multiple-file commit to these systems as
a single changeset.
678

Chong Yidong's avatar
Chong Yidong committed
679
*** vc-dir is a new command that displays file names and their VC
680 681
status.  It allows to apply various VC operations to a file, a
directory or a set of files/directories.
Glenn Morris's avatar
Glenn Morris committed
682

Chong Yidong's avatar
Chong Yidong committed
683
*** Clicking on the VC mode-line entry now pops the VC menu.
Glenn Morris's avatar
Glenn Morris committed
684

Chong Yidong's avatar
Chong Yidong committed
685
*** The VC mode-line entry now has a tooltip that explains the VC file status.
686

Chong Yidong's avatar
Chong Yidong committed
687 688
*** In VC Annotate mode, for VC systems that support changesets, you can
see the diff for the whole changeset (not only for the current file)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
689
by typing the D key.
690

Dan Nicolaescu's avatar
Dan Nicolaescu committed
691
*** In VC Annotate mode, you can type v to toggle the annotation visibility.
692

Chong Yidong's avatar
Chong Yidong committed
693 694
*** In VC Annotate mode, you can type f to show the file revision on
the current line.
Nick Roberts's avatar
Nick Roberts committed
695

Dan Nicolaescu's avatar
Dan Nicolaescu committed
696 697 698 699 700
*** In VC Annotate mode, for VC systems that support changesets, you
can see the diff for the whole changeset (not only for the current
file) by typing the D key or using the "Show changeset diff of
revision at line" menu entry.

Chong Yidong's avatar
Chong Yidong committed
701 702 703
*** Asynchronous VC commands display [Waiting...] in the mode-line
of the corresponding buffer as long as the asynchronous process is
active.
Reiner Steib's avatar
Reiner Steib committed
704

Chong Yidong's avatar
Chong Yidong committed
705 706 707
*** Log entries can be modified using the key "e" in log-view.
For now only CVS, RCS, SCCS and SVN support this functionality.
This is done by the `modify-change-comment' backend function.
708

Chong Yidong's avatar
Chong Yidong committed
709 710 711
*** In log-view-mode, for VC systems that support changesets, you can
see the diff for the whole changeset (not only for the current file)
by typing the D key or using the "Changeset Diff" menu entry.
Reiner Steib's avatar
Reiner Steib committed
712

713 714 715 716
*** In Log Edit mode,  C-c C-d now shows the diff for the files involved.

*** vc-git supports the "git grep" command.

Chong Yidong's avatar
Chong Yidong committed
717 718
*** VC Support for Meta-CVS has been removed for lack of maintainer able
to update it to the new VC.
Reiner Steib's avatar
Reiner Steib committed
719

720 721
** Miscellaneous

Chong Yidong's avatar
Chong Yidong committed
722 723
*** In Change Log mode, the new command C-c C-f (change-log-find-file)
finds the file associated with the current log entry.
724

725 726 727
*** In Change Log mode, the new command C-c C-c (change-log-goto-source)
goes to the source code associated with a log entry.

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

Chong Yidong's avatar
Chong Yidong committed
732
*** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
733 734
and C-x C-q in wdired-mode exits it with asking a question about
saving changes.
735

Chong Yidong's avatar
Chong Yidong committed
736 737
*** Eldoc highlights the function argument under point
with the face `eldoc-highlight-function-argument'.
738

Chong Yidong's avatar
Chong Yidong committed
739
*** In Etags, the --members option is now the default.
Glenn Morris's avatar
Glenn Morris committed
740
Use --no-members if you want the old default behavior of not tagging
Chong Yidong's avatar
Chong Yidong committed
741
struct members in C, members variables in C++ and variables in PHP.
Glenn Morris's avatar
Glenn Morris committed
742

Chong Yidong's avatar
Chong Yidong committed
743 744 745 746 747 748 749
*** The `gdb' command only works with the graphical interface now.
Use `gud-gdb' if you want the (old) text command mode.

*** goto-address.el provides two new minor modes, goto-address-mode and
goto-address-prog-mode, which buttonize URLS and email addresses.

*** The new command `eshell/info' runs info in an eshell buffer.
Glenn Morris's avatar
Glenn Morris committed
750

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

Chong Yidong's avatar
Chong Yidong committed
754 755 756 757 758 759 760 761
*** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.

*** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.

*** Info displays breadcrumbs in the header of the page.
See Info-breadcrumbs-depth to control it.

Glenn Morris's avatar
Glenn Morris committed
762
*** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
763
It is used to configure wireless interfaces.
Glenn Morris's avatar
Glenn Morris committed
764

Chong Yidong's avatar
Chong Yidong committed
765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788
*** The pcmpl-unix package supports hostname completion for ssh and scp.

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

*** smerge-refine highlights word-level details of changes in conflict.
It's used automatically as you move through conflicts, see smerge-auto-refine.

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

*** A new command `display-time-world' has been added to the Time
package.  It creates a buffer with an updating time display using
several time zones.

*** The appearance of superscript and subscript in TeX is more customizable.
See the documentation of the variables: tex-fontify-script,
tex-font-script-display, tex-suscript-height-ratio, and
tex-suscript-height-minimum.

*** view-remove-frame-by-deleting is now by default t
since users found iconification of view-mode frames distracting.

*** WoMan tries to add locale-specific manual page directories to the
search path.  This can be disabled by setting `woman-locale' to nil.

789 790

* Changes in Emacs 23.1 on non-free operating systems
Juri Linkov's avatar
Juri Linkov committed
791

792 793 794 795 796 797
** Case is now considered significant in completion on MS-Windows.
The default value of `completion-ignore-case' is now nil on
MS-Windows, the same as it is for other operating systems.  The
variable doesn't apply to reading a file name -- in that case Emacs
heeds `read-file-name-completion-ignore-case' instead.

Jason Rumney's avatar
Jason Rumney committed
798 799 800
---
** IPv6 is supported on MS-Windows.
Emacs now supports IPv6 on Windows XP and later, and earlier versions
Jason Rumney's avatar
Jason Rumney committed
801
of Windows with third party IPv6 stacks installed.  In Emacs 22, IPv6 was
Jason Rumney's avatar
Jason Rumney committed
802 803 804
supported on other platforms, but not on Windows due to using the winsock
1.1 header file, even though Emacs was linking to the winsock 2 library.

805
---
806 807
** Busy cursor (hourglass) now displays on MS-Windows.
When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
Jason Rumney's avatar
Jason Rumney committed
808 809 810 811 812 813 814 815
In Emacs 22 only X supported the busy cursor.

---
** Battery status is available on MS-Windows
Emacs can now display the battery status in the mode-line when enabled with
display-battery-mode or from the Options menu.  More verbose battery
information is also available with the command `battery'.  In Emacs 22
battery status was supported only on GNU/Linux and Mac.
816

Jason Rumney's avatar
Jason Rumney committed
817 818 819 820 821 822 823 824 825 826
** More keys available on MS-Windows.
Keys normally associated with IMEs, and some exotic keys not normally found
on standard keyboards have been given names so they can be bound to functions
inside Emacs.  If there are keys on your keyboard that have not been exposed
to Emacs in the past, try C-h k to see if they are available now.

Emacs can now bind functions to the extra buttons for media player and
browser control present on some keyboards.  These buttons are disabled
by default, since enabling them prevents their system-wide use when
Emacs has focus.  To enable them, set the variable
Juanma Barranquero's avatar
Juanma Barranquero committed
827
w32-pass-multimedia-buttons to nil.  See the doc string of that variable
Jason Rumney's avatar
Jason Rumney committed
828
for the list of extra keys that are available.
Jason Rumney's avatar
Jason Rumney committed
829

830 831

* Incompatible Lisp Changes in Emacs 23.1
832

833
** Variables cannot be both buffer-local and frame-local any more.
834

835
** `functionp' returns nil for special forms.
Juanma Barranquero's avatar
Juanma Barranquero committed
836
I.e., it only returns t for objects that can be passed to `funcall'.
837

838 839 840 841
** The behavior of map-char-table has changed.  It may call the
specified function with a cons (FROM . TO) as a key if characters in
that range have the same value.

842 843 844
** Process changes
+++
*** The function `dired-call-process' has been removed.
845
+++
846 847 848 849
*** The multibyteness of process filters is now determined by the
coding-system used for decoding.  The functions
`process-filter-multibyte-p' and `set-process-filter-multibyte' are
obsolete.
850

851
** The variable `byte-compile-warnings' can now be a list starting with `not',
Juanma Barranquero's avatar
Juanma Barranquero committed
852
meaning to disable the specified warnings.  The meaning of this list
853
may therefore be the reverse of what you expect (of course, this is
Juanma Barranquero's avatar
Juanma Barranquero committed
854
only an issue if you make use of the new `not' syntax).  Rather than
855 856 857 858
checking/manipulating elements directly, use the new functions
`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
`byte-compile-enable-warning.'

859 860 861
** `mode-name' is no longer guaranteed to be a string.
Use `(format-mode-line mode-name)' to ensure a string value.

862 863 864 865 866 867 868 869 870 871 872 873
** Internationalization changes

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

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

*** The cpXXX coding systems are now supported automatically.
The functions cp-...-codepage, which you had to use in Emacs 22 to
enable support for these coding systems, have been deleted.

*** The following features have been removed.  They were used for
Glenn Morris's avatar
Glenn Morris committed
874 875 876
displaying various scripts with specific fonts, and are no longer
needed now that OpenType font support is available:

877
**** `devanagari' and `devan-util', and all associated devanagari-* and
Glenn Morris's avatar
Glenn Morris committed
878 879
dev-* functions and variables (formerly used for Devanagari script).

880
**** `kannada' and `knd-util', and all associated kannada-* and knd-*
Glenn Morris's avatar
Glenn Morris committed
881 882
functions and variables (formerly used for Kannada script).

883
**** `malayalam' and `mlm-util', and all associated malayalam-* and
Glenn Morris's avatar
Glenn Morris committed
884 885
mlm-* functions and variables (formerly used for Malayalam script).

886
**** `tamil' and `tml-util, and all associated tamil-* and tml-*
Glenn Morris's avatar
Glenn Morris committed
887
functions and variables (formerly used for Tamil script).
888

889 890

* Lisp Changes in Emacs 23.1
Juri Linkov's avatar
Juri Linkov committed
891

892 893 894
+++
** New variable `user-emacs-directory'.
Use this instead of "~/.emacs.d".
895

896 897 898
** If a local hook function has a non-nil `permanent-local-hook'
property, `kill-all-local-variables' does not remove it from the local
value of the hook variable; it remains even if you change major modes.
Chong Yidong's avatar
Chong Yidong committed
899

900 901
** `frame-inherited-parameters' lets new frames inherit parameters from
the selected frame.
Chong Yidong's avatar
Chong Yidong committed
902

903 904 905 906
** New keymap `input-decode-map' overrides like key-translation-map, but
applies before function-key-map.  Also it is terminal-local contrary to
key-translation-map.  Terminal-specific key-sequences are generally added to
this map rather than to function-key-map now.
Chong Yidong's avatar
Chong Yidong committed
907

908
** `ignore-errors' is now a standard macro (does not require the CL package).
Chong Yidong's avatar
Chong Yidong committed
909

910 911 912
** `interprogram-paste-function' can now return one string or a list
of strings.  In the latter case, Emacs puts the second and following
strings on the kill ring.
Chong Yidong's avatar
Chong Yidong committed
913

914 915 916 917
+++
** In `condition-case', a handler can specify "let the debugger run first".
You do this by writing `debug' in the list of conditions to be handled,
like this:
Chong Yidong's avatar
Chong Yidong committed
918

919 920 921
    (condition-case nil
	(foo bar)
      ((debug error) nil))
Chong Yidong's avatar
Chong Yidong committed
922

923
** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
Chong Yidong's avatar
Chong Yidong committed
924

925 926
** `beginning-of-defun-function' now takes one argument, the count
given to `beginning-of-defun'.
Chong Yidong's avatar
Chong Yidong committed
927

928 929 930 931 932
+++
** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
IDENTIFICATION specifies which part of the remote identifier has to be
returned.  With CONNECTED passed non-nil, it is checked whether a
remote connection has been established already.
Chong Yidong's avatar
Chong Yidong committed
933

934 935
** The new macro `declare-function' suppresses compiler warnings about
undefined functions.
936

937
** Changes to interactive function handling
938

939 940 941
*** The new interactive spec code ^ says to first call
handle-shift-selection if shift-select-mode is non-nil, before reading
the command arguments.  This is used for shift-selection (see above).
942

943 944 945
*** Built-in functions can now have an interactive specification that
is not a prompt string.  If the `intspec' parameter of a `DEFUN'
starts with a `(', the string is evaluated as a Lisp form.
946

947 948 949
*** The interactive-form of a function can be added post-facto via the
`interactive-form' symbol property.  Mostly useful to add complex
interactive forms to subroutines.
950

951
** Region changes
952

953 954
*** Commands should use `use-region-p' to test whether there is
an active region that they should operate on.
955

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

961 962 963 964 965
*** If a command sets `transient-mark-mode' to (only . OLDVAL), that
means to activate transient-mark-mode temporarily, until the next
unshifted point motion command or mark deactivation.  Afterwards,
reset transient-mark-mode to the value OLDVAL.  The values `only' and
`identity', introduced in Emacs 22, are now deprecated.
966

967
** Emacs session information
968

969 970
*** The new variables `before-init-time' and `after-init-time' record the
value of `current-time' before and after Emacs loads the init files.
971

Chong Yidong's avatar