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

3
Copyright (C) 2007, 2008, 2009, 2010 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 bug-gnu-emacs@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

* Installation Changes in Emacs 23.3

20 21 22 23 24
---
** New configure option --with-crt-dir specifies the location of your
crt*.o files, if they are in a non-standard location.  This is only
used on x86-64 and s390x GNU/Linux architectures.

25 26 27 28 29 30 31 32 33 34
* Startup Changes in Emacs 23.3

* Changes in Emacs 23.3


* Editing Changes in Emacs 23.3


* Changes in Specialized Modes and Packages in Emacs 23.3

Glenn Morris's avatar
Glenn Morris committed
35 36 37 38
---
** The appt-add command takes an optional argument for the warning time.
This can be used in place of the default appt-message-warning-time.

39 40 41 42
---
** You can allow inferior Python processes to load modules from the
current directory by setting `python-remove-cwd-from-path' to nil.

43 44
** VC and related modes

45 46 47 48
*** New VC command `vc-log-incoming', bound to `C-x v I'.
This shows a log of changes to be received with a pull operation.
For Git, this runs "git fetch" to make the necessary data available
locally; this requires version 1.7 or newer.
49

50 51
*** New VC command `vc-log-outgoing', bound to `C-x v O'.
This shows a log of changes to be sent in the next commit.
52

53
*** New VC command vc-find-conflicted-file.
54

55
+++
56 57 58 59 60 61
*** The 'g' key in VC diff, log, log-incoming and log-outgoing buffers
reruns the corresponding VC command to compute an up to date version
of the buffer.

*** vc-dir for Bzr supports viewing shelve contents and shelving snapshots.

62
+++
63
*** Special markup can be added to log-edit buffers.
64 65 66 67 68 69
You can add headers specifying additional information to be supplied
to the version control system.  For example:

  Author: J. R. Hacker <jrh@example.com>
  Fixes: 4204
  Actual text of log entry...
70

71 72 73
Bazaar recognizes the headers "Author", "Date" and "Fixes".
Git, Mercurial, and Monotone recognize "Author" and "Date".
Any unknown header is left as is in the message, so it is not lost.
74

Glenn Morris's avatar
Glenn Morris committed
75 76 77 78 79
** Obsolete packages

+++
*** lmenu.el and cl-compat.el are now obsolete.

80 81

* New Modes and Packages in Emacs 23.3
82

83 84 85 86
** smie.el is a generic navigation and indentation engine.
It takes a simple BNF description of the grammar, and provides both
sexp-style navigation (jumping over begin..end pairs) as well as
indentation, which can be adjusted via ad-hoc indentation rules.
87

88 89 90

* Incompatible Lisp Changes in Emacs 23.3

91 92 93 94
** posn-col-row now excludes the header line from the row count
If the frame has a header line, posn-col-row will count row numbers
starting from the first line of text below the header line.

95 96 97

* Lisp changes in Emacs 23.3

98
+++
99 100
** `e' and `pi' are now called `float-e' and `float-pi'.
  The old names are obsolete.
101 102 103 104 105 106 107 108 109 110

+++
** The use of unintern without an obarray arg is now obsolete.

---
** The function `princ-list' is now obsolete.

+++
** The yank-handler argument to kill-region and friends is now obsolete.

111
+++
112 113 114 115 116
** New function byte-to-string, like char-to-string but for bytes.


* Changes in Emacs 23.3 on non-free operating systems

117 118 119 120
+++
** The nextstep port can have different modifiers for the left and right
alt/option key by customizing the value for ns-right-alternate-modifier.

121

122 123
* Installation Changes in Emacs 23.2

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

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

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

Glenn Morris's avatar
Glenn Morris committed
132 133 134
** `make install' now consistently ignores umask, creating a
world-readable install.

135
** Emacs compiles with Gconf support, if it is detected.
Chong Yidong's avatar
Chong Yidong committed
136
Use the configure option --without-gconf to disable this.
Glenn Morris's avatar
Glenn Morris committed
137
This is used by the `font-use-system-font' feature (see below).
Chong Yidong's avatar
Chong Yidong committed
138

Chong Yidong's avatar
Chong Yidong committed
139
* Startup Changes in Emacs 23.2
140

Chong Yidong's avatar
Chong Yidong committed
141 142 143 144 145
** The command-line option -Q (--quick) also inhibits loading X resources.
However, if Emacs is compiled with the Lucid or Motif toolkit, X
resource settings for the graphical widgets are still applied.
On Windows, the -Q option causes Emacs to ignore Registry settings,
but environment variables set on the Registry are still honored.
146

Chong Yidong's avatar
Chong Yidong committed
147 148
*** The new variable `inhibit-x-resources' shows whether X resources
were loaded.
149

Chong Yidong's avatar
Chong Yidong committed
150 151
** New command-line option -mm (--maximized) maximizes the initial frame.

Chong Yidong's avatar
Chong Yidong committed
152
* Changes in Emacs 23.2
153

Chong Yidong's avatar
Chong Yidong committed
154
** The maximum size of buffers (and the largest fixnum) is doubled.
155 156
On typical 32bit systems, buffers can now be up to 512MB.

Chong Yidong's avatar
Chong Yidong committed
157 158
** The default value of `trash-directory' is now nil.
This means that `move-file-to-trash' trashes files according to
159 160 161 162
freedesktop.org specifications, the same method used by the Gnome,
KDE, and XFCE desktops.  (This change has no effect on Windows, which
uses `system-move-file-to-trash' for trashing.)

163
** The pointer now becomes invisible when typing.
Chong Yidong's avatar
Chong Yidong committed
164
Customize `make-pointer-invisible' to disable this feature.
165

Chong Yidong's avatar
Chong Yidong committed
166
** Font changes
167

Chong Yidong's avatar
Chong Yidong committed
168 169 170 171 172 173
*** Emacs can use the system default monospaced font in Gnome.
To enable this feature, set `font-use-system-font' to non-nil (it is
nil by default).  If the system default changes, Emacs changes also.
This feature requires Gconf support, which is automatically included
at compile-time if configure detects the gconf libraries (you can
disable this with the configure option --without-gconf).
174

Chong Yidong's avatar
Chong Yidong committed
175 176 177
*** On X11, Emacs reacts to Xft changes made by configuration tools,
via the XSETTINGS mechanism.  This includes antialias, hinting,
hintstyle, RGBA, DPI and lcdfilter changes.
178

Chong Yidong's avatar
Chong Yidong committed
179 180 181 182
** Killing a buffer with a running process now asks for confirmation.
To remove this query, remove `process-kill-buffer-query-function' from
`kill-buffer-query-functions', or set the appropriate process flag
with `set-process-query-on-exit-flag'.
183

184
** File-local variable changes
185

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

190
*** There are new commands for adding and removing file-local variables:
191 192 193 194
`add-file-local-variable', `delete-file-local-variable',
`add-file-local-variable-prop-line', and
`delete-file-local-variable-prop-line'.

195
*** There are new commands for adding and removing directory-local variables,
196 197 198
and copying them to and from file-local variable lists:
`add-dir-local-variable', `delete-dir-local-variable',
`copy-dir-locals-to-file-locals',
199 200 201
`copy-dir-locals-to-file-locals-prop-line' and
`copy-file-locals-to-dir-locals'.

Chong Yidong's avatar
Chong Yidong committed
202
** Internationalization changes
203

Chong Yidong's avatar
Chong Yidong committed
204 205 206 207 208
*** Unibyte sessions are now considered obsolete.
This refers to the EMACS_UNIBYTE environment variable as well as the
--unibyte, --multibyte, --no-multibyte, and --no-unibyte command line
arguments.  Customizing enable-multibyte-characters and setting
default-enable-multibyte-characters are also deprecated.
209

Chong Yidong's avatar
Chong Yidong committed
210 211 212 213 214 215
*** New coding system `utf-8-hfs'.
This is suitable for default-file-name-coding-system on Mac OS X; see
international/ucs-normalize.el.

** Function arguments in *Help* buffers are now shown in upper-case.
Customize `help-downcase-arguments' to t to show them in lower-case.
216

217 218 219 220 221 222 223 224 225 226 227
** New command `async-shell-command', bound globally to `M-&'.
This executes the command asynchronously, similar to calling `M-!' and
manually adding an ampersand to the end of the command.  With `M-&',
you don't need the ampersand.  The output appears in the buffer
`*Async Shell Command*'.

** When running in a new enough xterm (newer than version 242), Emacs
asks xterm what the background color is and it sets up faces
accordingly for a dark background if needed (the current default is to
consider the background light).

Glenn Morris's avatar
Glenn Morris committed
228 229 230

* Editing Changes in Emacs 23.2

Chong Yidong's avatar
Chong Yidong committed
231
** Kill-ring and selection changes
232

Chong Yidong's avatar
Chong Yidong committed
233 234 235 236
*** If `select-active-regions' is t, any active region automatically
becomes the primary selection (for interaction with other window
applications).  If you enable this, you might want to bind
`mouse-yank-primary' to Mouse-2.
237

Chong Yidong's avatar
Chong Yidong committed
238 239 240
*** When `save-interprogram-paste-before-kill' is non-nil, the kill
commands save the interprogram-paste selection into the kill ring
before doing anything else.  This avoids losing the selection.
241

Chong Yidong's avatar
Chong Yidong committed
242 243
*** When `kill-do-not-save-duplicates' is non-nil, identical
subsequent kills are not duplicated in the `kill-ring'.
Chong Yidong's avatar
Chong Yidong committed
244

Chong Yidong's avatar
Chong Yidong committed
245
** Completion changes
Glenn Morris's avatar
Glenn Morris committed
246

247
*** The new command `completion-at-point' provides mode-sensitive completion.
248

249
*** tab-always-indent set to `complete' lets TAB do completion as well.
250

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

Chong Yidong's avatar
Chong Yidong committed
254 255 256 257 258
*** The new variable `completions-format' determines how completions
are displayed in the *Completions* buffer.  If you set it to
`vertical', completions are sorted vertically in columns.

** The default value of `blink-matching-paren-distance' is increased.
Juri Linkov's avatar
Juri Linkov committed
259

Chong Yidong's avatar
Chong Yidong committed
260 261 262 263 264 265
** M-n provides more default values in the minibuffer for commands
that read file names.  These include the file name at point (when ffap
is loaded without ffap-bindings), the file name on the current line
(in Dired buffers), and the directory names of adjacent Dired windows
(for Dired commands that operate on several directories, such as copy,
rename, or diff).
266

Chong Yidong's avatar
Chong Yidong committed
267 268 269 270
** M-r is bound to the new `move-to-window-line-top-bottom'.
This moves point to the window center, top and bottom on successive
invocations, in the same spirit as the C-l (recenter-top-bottom)
command.
271

Chong Yidong's avatar
Chong Yidong committed
272 273
** The new variable `recenter-positions' determines the default
cycling order of C-l (`recenter-top-bottom').
274

275 276 277
** The abbrevs file is now a file named abbrev_defs in
user-emacs-directory; but the old location, ~/.abbrev_defs, is used if
that file exists.
278

279 280 281

* Changes in Specialized Modes and Packages in Emacs 23.2

282 283
** The bookmark menu has a narrowing search via bookmark-bmenu-search.

284
** Calc
285

286 287 288
*** The Calc settings file is now a file named calc.el in
user-emacs-directory; but the old location, ~/.calc.el, is used if
that file exists.
289

290 291
*** Graphing commands (`g f' etc.) now work on MS-Windows, if you have
the native Windows port of Gnuplot version 3.8 or later installed.
292

Chong Yidong's avatar
Chong Yidong committed
293
** Calendar and diary
294

Chong Yidong's avatar
Chong Yidong committed
295 296
*** Fancy diary display is now the default.
If you prefer the simple display, customize `diary-display-function'.
297

Chong Yidong's avatar
Chong Yidong committed
298
*** The diary's fancy display now enables view-mode.
299

Chong Yidong's avatar
Chong Yidong committed
300 301 302 303
*** The command `calendar-current-date' accepts an optional argument
giving an offset from today.

** Desktop
304

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

312
** Dired
313

314 315
*** The new variable `dired-auto-revert-buffer', if non-nil, causes
Dired buffers to be reverted automatically on revisiting them.
316

317
** DocView
318

Juri Linkov's avatar
Juri Linkov committed
319
*** When `doc-view-continuous' is non-nil, scrolling a line
320 321
on the page edge advances to the next/previous page.

322 323 324 325 326 327 328 329 330 331 332 333 334 335 336
** Elint

*** Elint now uses compilation-mode.

*** Elint can now scan individual files and whole directories,
and can be run in batch mode.

*** Elint does a more thorough initialization, and recognizes more built-in
functions and variables.  Customize `elint-scan-preloaded' if you want
to sacrifice some accuracy for a faster startup.

*** Elint attempts some basic understanding of featurep and (f)boundp tests.

*** Customize `elint-ignored-warnings' to suppress some warnings.

337
** GDB-UI
338

Juanma Barranquero's avatar
Juanma Barranquero committed
339
*** Toolbar functionality for reverse debugging.  Display of STL
Glenn Morris's avatar
Glenn Morris committed
340
collections as watch expressions.  These features require GDB 7.0 or later.
Glenn Morris's avatar
Glenn Morris committed
341

342
** Grep
343

344
*** A new command `zrgrep' searches recursively in gzipped files.
345

346 347 348 349 350
** Info

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

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

355 356
** LaTeX mode now provides completion (via completion-at-point).

357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372
** Message mode is now the default mode for composing mail.

The default for `mail-user-agent' is now message-user-agent, so the
C-x m (`compose-mail') command uses Message mode instead of Mail mode.

Message mode has been included in Emacs, as part of the Gnus package,
for several years.  It provides several features that are absent in
Mail mode, such as MIME handling.

*** If the user has not customized mail-user-agent, `compose-mail'
checks for Mail mode customizations, and issues a warning if these
customizations are found.  This alerts users who may otherwise be
unaware that their mail configuration has changed.

To disable this check, set compose-mail-user-agent-warnings to nil.

373 374 375 376 377
** The default value of mail-interactive is t, since Emacs 23.1.
(This was not announced at the time.)  It means that when sending mail,
Emacs will wait for the process sending mail to return.  If you
experience delays when sending mail, you may wish to set this to nil.

378 379
** nXML mode is now the default for editing XML files.

380 381 382
** pcomplete provides a new command `pcomplete-std-completion' which
is similar to `pcomplete' but using the standard completion UI code.

383
** Shell (and other comint modes)
384

385
*** M-s is no longer bound to `comint-next-matching-input'.
386

387 388
*** M-r is now bound to `comint-history-isearch-backward-regexp'.
This starts an incremental search of the comint/shell input history.
389

390
*** ansi-color is now enabled by default in Shell mode.
391 392 393
To disable it, set ansi-color-for-comint-mode to nil.

** Tramp
394

395 396 397
*** New connection methods "rsyncc", "imap" and "imaps".
On systems which support GVFS-Fuse, Tramp offers also the new
connection methods "dav", "davs", "obex" and "synce".
398

399
** VC and related modes
400

401 402 403 404
*** When using C-x v v or C-x v i on a unregistered file that is in a
directory not controlled by any VCS, ask the user what VC backend to
use to create a repository, create a new repository and register the
file.
405

406 407 408
*** New command `vc-root-print-log', bound to `C-x v L'.
This displays a `*vc-change-log*' buffer showing the history of the
version-controlled directory tree as a whole.
409

410 411 412
*** New command `vc-root-diff', bound to `C-x v D'.
This is similar to `vc-diff', but compares the entire directory tree
of the current VC directory with its working revision.
413

414 415 416 417 418 419
*** `C-x v l' and `C-x v L' do not show the full log by default.
The number of entries shown can be chosen interactively with a prefix
argument, or by customizing vc-log-show-limit.  The `*vc-change-log*'
buffer now contains buttons at the end of the buffer, which can be
used to increase the number of entries shown.  RCS, SCCS, and CVS do
not support this feature.
420

421 422 423 424
*** vc-annotate supports annotations through file copies and renames,
it displays the old names for the files and it can show logs/diffs for
the corresponding lines.  Currently only Git and Mercurial take
advantage of this feature.
425

426 427 428
*** The log command in vc-annotate can display a single log entry
instead of redisplaying the full log.  The RCS, CVS and SCCS VC
backends do not support this.
429

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

432
*** Diff and log operations can be used from Dired buffers.
433

Dan Nicolaescu's avatar
Dan Nicolaescu committed
434 435
*** vc-git changes

436 437 438 439 440
**** The short log format for git makes use of the graph display,
so it's not supported on git versions earlier than 1.5.6.

**** vc-dir uses the --relative option of git, and so requires at least
git version 1.5.5.
Dan Nicolaescu's avatar
Dan Nicolaescu committed
441

Glenn Morris's avatar
Glenn Morris committed
442 443 444
**** Support for operating with stashes has been added to vc-dir:
the stash list is displayed in the *vc-dir* header, stashes can be
created, removed, applied and their content displayed.
445

446 447
*** vc-bzr supports operating with shelves: the shelve list is
displayed in the *vc-dir* header, shelves can be created, removed and applied.
448

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

452
** Miscellaneous
453

Juri Linkov's avatar
Juri Linkov committed
454 455 456 457 458 459 460
*** Interactively `multi-isearch-buffers' and `multi-isearch-buffers-regexp'
read buffer names to search, one by one, ended with RET.  With a prefix
argument, they ask for a regexp, and search in buffers whose names match
the specified regexp.  Interactively `multi-isearch-files' and
`multi-isearch-files-regexp' read file names to search, one by one,
ended with RET.  With a prefix argument, they ask for a wildcard, and
search in file buffers whose file names match the specified wildcard.
461

462
*** Autorevert Tail mode now works also for remote files.
463

464
*** The new eshell built-in commands `su' and `sudo' support Tramp.
465 466
Thus, they change `default-directory' to reflect the new user id, and
let commands run under that user's permissions.  This works even when
467
`default-directory' is already remote.  Calling the external commands
468 469 470 471 472 473 474
is possible via `*su' or `*sudo', respectively.

** Obsolete packages

*** sym-comp.el is now obsolete, superseded by completion-at-point.

*** lucid.el and levents.el are now obsolete.
475

Steve Yegge's avatar
Steve Yegge committed
476 477 478

* New Modes and Packages in Emacs 23.2

479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503
** CEDET (the Collection of Emacs Development Tools) is now in Emacs.
This is a collection of packages to aid with using Emacs as an IDE
(integrated development environment):

*** The Semantic package allows the use of parsers to intelligently
edit and navigate source code.  Parsers for C/C++, Java, Javascript,
and several other languages are included by default, and Semantic can
also interface with external tools such as GNU Global and GNU Idutils.

To enable Semantic, use the global minor mode `semantic-mode'.
See the Semantic manual for details.

*** EDE (Emacs Development Environment) is a package for managing code
projects, including features such as automatic Makefile generation.

To enable EDE, use the minor mode `global-ede-mode'.
See the EDE manual for details.

*** SRecode is a library for recoding Semantic tags back into source
code.  It is currently used by some parts of Semantic and EDE; in the
future, it may be used for code generation features.

*** The EIEIO library implements a subset of the Common Lisp Object
System (CLOS).  It is used by the other CEDET packages.

Stefan Monnier's avatar
Stefan Monnier committed
504
** mpc.el is a front end for the Music Player Daemon.  Run it with M-x mpc.
Chong Yidong's avatar
Chong Yidong committed
505

Stefan Monnier's avatar
Stefan Monnier committed
506 507
** htmlfontify.el turns a fontified Emacs buffer into an HTML page.

508
** js.el is a new major mode for JavaScript files.
509

510 511
** imap-hash.el is a new library to address IMAP mailboxes as hashtables.

512 513 514

* Incompatible Lisp Changes in Emacs 23.2

515 516 517
** The Lisp reader turns integers that are too large/small into floats.
For instance, on machines where `536870911' is the largest integer,
reading `536870912' gives the floating-point object `536870912.0'.
Chong Yidong's avatar
Chong Yidong committed
518 519 520

This change only concerns the Lisp reader; it does not affect how
actual integer objects overflow.
521

522 523 524 525 526 527 528 529 530 531 532 533
** Several obsolete functions removed.
The functions have been obsolete since Emacs 19, and are unlikely to
be in use:

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

** Support for generating Emacs 18 compatible bytecode (by setting
the variable `byte-compile-compatibility') has been removed.

Glenn Morris's avatar
Glenn Morris committed
534 535 536 537 538 539 540
** In image-mode.el `image-mode-maybe' is obsolete.
Instead, you can either use `image-mode' (which displays an image file
as the actual image initially), or `image-mode-as-text' (when you want
to display an image file as text initially).  `image-mode-as-text' is a
combination of a non-image mode from `auto-mode-alist' (or Fundamental
mode) and `image-minor-mode'.  `image-minor-mode' provides a `C-c C-c'
key binding to toggle image display.
541 542
`image-toggle-display-text' removes image properties.
`image-toggle-display-image' adds image properties.
Glenn Morris's avatar
Glenn Morris committed
543
`image-toggle-display' toggles between `image-mode-as-text' and `image-mode'.
544

545 546

* Lisp changes in Emacs 23.2
547

548 549
** All the default-FOO variables that hold the default value of the FOO
variable, are now declared obsolete.
550

551 552
** read-key is a function halfway between read-event and read-key-sequence.
It reads a single key, but obeys input and escape sequence decoding.
553

Chong Yidong's avatar
Chong Yidong committed
554
** Frame parameter changes
555

Chong Yidong's avatar
Chong Yidong committed
556 557
*** You can give the `fullscreen' frame parameter the value `maximized'.
This maximizes the frame.
558

Chong Yidong's avatar
Chong Yidong committed
559 560 561
*** The new frame parameter `sticky' makes Emacs frames sticky in
virtual desktops.

562
** Completion changes
563

564
*** completion-base-size is obsoleted by completion-base-position.
565 566 567 568
This change causes a few backward incompatibilities, mostly with
choose-completion-string-functions where the `mini-p' argument has
been replaced by a `base-position' argument, and where the `base-size'
argument is now always nil.
569

570 571
*** New function `completion-in-region' to use the standard completion
facilities on a particular region of text.
572

573
*** The 4th arg to all-completions (aka hide-spaces) is declared obsolete.
574

575 576 577 578
*** completion-annotate-function specifies how to compute annotations
for completions displayed in *Completions*.

** Minibuffer changes
579

580 581 582 583 584 585
*** read-file-name-predicate is obsolete.  It was used to pass the predicate
to read-file-name-internal because read-file-name-internal abused its `pred'
argument to pass the current directory, but this hack is not needed
any more.

** Changes to file-manipulation functions
586

587
*** `delete-directory' has an optional parameter RECURSIVE.
588

589 590
*** New function `copy-directory', which copies a directory recursively.

591 592
** called-interactively-p now takes one argument and replaces interactive-p
which is now marked obsolete.
593

594 595
** New function set-advertised-calling-convention makes it possible
to obsolete arguments as well as make some arguments mandatory.
596

597 598 599 600 601
** You can control which binding is preferentially shown in menus and
docstrings by adding a `:advertised-binding' property to the corresponding
command's symbol.  That property can hold a single binding or a list
of bindings.

602
** Network and process changes
603

604
*** start-process-shell-command and start-file-process-shell-command
Glenn Morris's avatar
Glenn Morris committed
605
now only take a single `command' argument.
606

607 608 609
*** The new variable `process-file-side-effects' should be set to nil
if a `process-file' call does not change a remote file.  This allows
file name handlers such as Tramp to optimizations.
610

611
*** make-network-process can now also create `seqpacket' Unix sockets.
612 613

** Loading changes
614

615
*** eval-next-after-load is obsolete.
616

617 618 619
*** New hook `after-load-functions' run after loading an Elisp file.

** Byte compilation changes
620

621 622 623
*** Changing the file-names generated by byte-compilation by redefining
the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
Instead, customize byte-compile-dest-file-function.
624

625 626 627 628 629
*** `byte-compile-warnings' has new members, `constants' and `suspicious'.

** New macro with-silent-modifications to tweak text properties without
affecting the buffer's modification state.

630 631 632
** Hash tables have a new printed representation that is readable.
The feature `hashtable-print-readable' identifies this new
functionality.
633

634
** New functions for performing Unicode normalization:
635 636 637 638 639 640
ucs-normalize-NFD-region, ucs-normalize-NFD-string,
ucs-normalize-NFC-region, ucs-normalize-NFC-string,
ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,
ucs-normalize-NFKC-region, ucs-normalize-NFKC-string,
ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string,
ucs-normalize-HFS-NFC-region, ucs-normalize-HFS-NFC-string.
Stefan Monnier's avatar
.  
Stefan Monnier committed
641

642 643
** Face aliases can now be marked as obsolete, using the macro
`define-obsolete-face-alias'.
644

Glenn Morris's avatar
Glenn Morris committed
645 646
** New function `window-full-height-p', analogous to the full-width version.

647

Chong Yidong's avatar
Chong Yidong committed
648 649 650 651
* Changes in Emacs 23.2 on non-free operating systems

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

653

654
* Installation Changes in Emacs 23.1
655

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

Chong Yidong's avatar
Chong Yidong committed
660 661
** New font code.
Fonts are handled by new code capable of dealing with multiple font
662
backends.  This uses the freetype and fontconfig libraries.
663

Chong Yidong's avatar
Chong Yidong committed
664 665
*** 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
666

Chong Yidong's avatar
Chong Yidong committed
667 668 669 670 671 672 673 674 675
*** 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.
676

Chong Yidong's avatar
Chong Yidong committed
677
** Changes to image support
678

Chong Yidong's avatar
Chong Yidong committed
679
*** configure now checks for libgif before libungif when searching for
680
a GIF library.
681

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

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

Juanma Barranquero's avatar
Juanma Barranquero committed
686
** New NeXTSTEP-based port.
Glenn Morris's avatar
Glenn Morris committed
687
This provides support for GNUstep (via the GNUstep libraries) and Mac
Michael Albinus's avatar
Michael Albinus committed
688
OS X (via the Cocoa libraries).
689

Glenn Morris's avatar
Glenn Morris committed
690
Specify --with-ns to configure for this.  By default, a self-contained
691 692 693
app will be built (containing all lisp).  To install/share lisp with
other emacsen (e.g. X11 build) use --disable-ns-self-contained.  See
nextstep/README and nextstep/INSTALL in the Emacs source directory.
Chong Yidong's avatar
Chong Yidong committed
694 695 696

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

Chong Yidong's avatar
Chong Yidong committed
698 699
** The new configuration option "--with-dbus" enables D-Bus language
bindings for Emacs.
700

701 702
** Support for many obsolete platforms has been removed.
See the list at the end of etc/MACHINES for details.
703

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

Chong Yidong's avatar
Chong Yidong committed
706
*** Support for Sun windows has been removed.
707

Chong Yidong's avatar
Chong Yidong committed
708
*** The `emacstool' utility has been removed.
Chong Yidong's avatar
Chong Yidong committed
709

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

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

716
*** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
Juanma Barranquero's avatar
Juanma Barranquero committed
717
executable format.
Chong Yidong's avatar
Chong Yidong committed
718 719 720

*** Solaris versions 2.6 and below.

721 722 723 724
*** Solaris on IBM RS6000 machines.

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

725 726
*** Unixware on non-x86 machines.

727 728
*** Platforms not supporting shared libraries (i.e., requiring the
NO_SHARED_LIBS compilation flag).
Chong Yidong's avatar
Chong Yidong committed
729

730 731 732 733
** 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
734 735
** The refcards are now shipped as PDF files.

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

Chong Yidong's avatar
Chong Yidong committed
739 740 741
** 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
742 743 744

* Changes in Emacs 23.1

Chong Yidong's avatar
Chong Yidong committed
745
** Improved X Window System support
746

Chong Yidong's avatar
Chong Yidong committed
747 748 749 750 751
*** 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).
752 753
There may be problems if a display exits unexpectedly and Emacs is compiled
with Gtk+, see etc/PROBLEMS.
754 755 756

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

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

763
**** emacsclient starts emacs in daemon mode and connects to it when
764 765
--alternate-editor="" is used (or when the evironment variable
ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an
766 767
emacs server.

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

Chong Yidong's avatar
Chong Yidong committed
771 772 773
*** 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
774 775
http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
for details about XEmbed.
776

Chong Yidong's avatar
Chong Yidong committed
777 778 779
*** 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
780 781
the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac
OS X, or on Windows 2000 and later versions of Windows.
782 783

The alpha parameter should be an integer between 0 (transparent) and
Chong Yidong's avatar
Chong Yidong committed
784 785
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
786
active frame and INACTIVE is the opacity of non-active frames.
787

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

Chong Yidong's avatar
Chong Yidong committed
791
** Internationalization changes
792

Chong Yidong's avatar
Chong Yidong committed
793 794
*** 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
795

Chong Yidong's avatar
Chong Yidong committed
796
The internal encoding used for buffers and strings is now
797 798 799 800
Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias
for this).  This encoding is backward-compatible with Unicode's UTF-8
encoding.  The internal encoding previously used by Emacs,
`emacs-mule', is still available for reading and writing files.
Nick Roberts's avatar
Nick Roberts committed
801

Chong Yidong's avatar
Chong Yidong committed
802 803 804
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,
805 806 807 808
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.
809

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

Chong Yidong's avatar
Chong Yidong committed
812 813 814
*** 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
815

Chong Yidong's avatar
Chong Yidong committed
816 817 818
*** There are new language environments for Chinese-GBK,
Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
Sinhala, and TaiViet.
819

Chong Yidong's avatar
Chong Yidong committed
820 821
*** The minor modes unify-8859-on-encoding-mode and
unify-8859-on-decoding-mode are obsolete.
822

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

827 828 829 830 831
*** The `cyrillic-translit' input method supports many new characters.
Common typographical characters available from Unicode were added to
`cyrillic-translit': punctuation marks, accented characters, fractions,
and others.

Chong Yidong's avatar
Chong Yidong committed
832
** Emacs now supports serial port access on GNU/Linux, Unix, and
833 834 835
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.
836

Chong Yidong's avatar
Chong Yidong committed
837
** Menu Bar changes
838

Chong Yidong's avatar
Chong Yidong committed
839 840 841 842 843
*** 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.
844

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

848 849 850
*** 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).
851

852 853 854
*** 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
855
the new word wrapping behavior (see Editing Changes, below).
856

Dan Nicolaescu's avatar
Dan Nicolaescu committed
857 858 859 860
*** Improvements to menus for major and minor modes
More major and minor modes now have a mode specific menu, and existing
mode menus have been improved to include more functionality.

Chong Yidong's avatar
Chong Yidong committed
861
** Mode-line changes
862

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

Chong Yidong's avatar
Chong Yidong committed
866 867
*** 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.
868

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

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

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

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

Chong Yidong's avatar
Chong Yidong committed
882
** Directory-local variables can now be defined.
883 884 885
By default, Emacs looks in .dir-locals.el for directory-local
variables.  For more information, see `dir-locals-set-directory-class'
and `dir-locals-set-class-variables'.
886

887 888 889 890 891 892 893
** Emacs can now use `auth-source' for authentication.
`smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
login names and passwords.  The match, if found, is reported
in *Messages* with the password blanked out.

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

894

895
* Startup Changes in Emacs 23.1
896

897 898 899 900 901 902
** 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.

903 904 905 906
** New user option `initial-buffer-choice' specifies what to display
after starting Emacs: startup screen, *scratch* buffer, visiting a
file or directory.

907 908 909 910
** 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.
911 912

** The abbrev file is no longer read at startup in batch mode.
913