Exclude NL and TAB from c0-control group for glyphless display.
[bpt/emacs.git] / etc / NEWS.23
CommitLineData
eb199145
GM
1GNU Emacs NEWS -- history of user-visible changes.
2
3Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
4See the end of the file for license conditions.
5
6Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
7If possible, use M-x report-emacs-bug.
8
9This file is about changes in Emacs version 23.
10
11See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17
12for changes in older Emacs versions.
13
14You can narrow news to a specific version by calling `view-emacs-news'
15with a prefix argument or by typing C-u C-h C-n.
16
eb199145 17\f
171eda53
SM
18* Installation Changes in Emacs 23.3
19
20* Startup Changes in Emacs 23.3
21
22* Changes in Emacs 23.3
23
4c14013d
JB
24** The nextstep port can have different modifiers for the left and right
25alt/option key by customizing the value for ns-right-alternate-modifier.
26
171eda53
SM
27\f
28* Editing Changes in Emacs 23.3
29
30\f
31* Changes in Specialized Modes and Packages in Emacs 23.3
32
2a64315a
SM
33---
34** The appt-add command takes an optional argument for the warning time.
35This can be used in place of the default appt-message-warning-time.
36
220d91b8
JB
37** Obsolete packages
38
39+++
40*** lmenu.el and cl-compat.el are now obsolete.
41
171eda53
SM
42\f
43* New Modes and Packages in Emacs 23.3
d607b96b
SM
44** smie.el is a generic navigation and indentation engine.
45It takes a simple BNF description of the grammar, and provides both
46sexp-style navigation (jumping over begin..end pairs) as well as
47indentation, which can be adjusted via ad-hoc indentation rules.
171eda53
SM
48\f
49* Incompatible Lisp Changes in Emacs 23.3
50
4a47c275
SM
51** posn-col-row now excludes the header line from the row count
52If the frame has a header line, posn-col-row will count row numbers
53starting from the first line of text below the header line.
54
171eda53
SM
55\f
56* Lisp changes in Emacs 23.3
57
266a86bd
CY
58** `e' and `pi' are now called `float-e' and `float-pi'.
59 The old names are obsolete.
6664fc59 60** The use of unintern without an obarray arg is declared obsolete.
d607b96b 61** The function `princ-list' is declared obsolete.
4a47c275 62** The yank-handler argument to kill-region and friends is declared obsolete.
171eda53
SM
63** New function byte-to-string, like char-to-string but for bytes.
64
65\f
66* Changes in Emacs 23.3 on non-free operating systems
67
68\f
eb199145
GM
69* Installation Changes in Emacs 23.2
70
0235128c 71** New configure options for Emacs developers.
eb199145 72These are not new features; only the configure flags are new.
0235128c 73
eb199145
GM
74*** --enable-profiling builds Emacs with profiling enabled.
75This might not work on all platforms.
0235128c 76
eb199145
GM
77*** --enable-checking[=OPTIONS] builds emacs with extra runtime checks.
78
eb199145
GM
79** `make install' now consistently ignores umask, creating a
80world-readable install.
81
82** Emacs compiles with Gconf support, if it is detected.
83Use the configure option --without-gconf to disable this.
6e104790 84This is used by the `font-use-system-font' feature (see below).
eb199145
GM
85
86* Startup Changes in Emacs 23.2
0235128c 87
eb199145
GM
88** The command-line option -Q (--quick) also inhibits loading X resources.
89However, if Emacs is compiled with the Lucid or Motif toolkit, X
90resource settings for the graphical widgets are still applied.
91On Windows, the -Q option causes Emacs to ignore Registry settings,
92but environment variables set on the Registry are still honored.
0235128c 93
eb199145
GM
94*** The new variable `inhibit-x-resources' shows whether X resources
95were loaded.
96
eb199145
GM
97** New command-line option -mm (--maximized) maximizes the initial frame.
98
99* Changes in Emacs 23.2
100
eb199145
GM
101** The maximum size of buffers (and the largest fixnum) is doubled.
102On typical 32bit systems, buffers can now be up to 512MB.
103
eb199145
GM
104** The default value of `trash-directory' is now nil.
105This means that `move-file-to-trash' trashes files according to
106freedesktop.org specifications, the same method used by the Gnome,
107KDE, and XFCE desktops. (This change has no effect on Windows, which
108uses `system-move-file-to-trash' for trashing.)
109
eb199145
GM
110** The pointer now becomes invisible when typing.
111Customize `make-pointer-invisible' to disable this feature.
112
113** Font changes
0235128c 114
eb199145
GM
115*** Emacs can use the system default monospaced font in Gnome.
116To enable this feature, set `font-use-system-font' to non-nil (it is
117nil by default). If the system default changes, Emacs changes also.
118This feature requires Gconf support, which is automatically included
119at compile-time if configure detects the gconf libraries (you can
120disable this with the configure option --without-gconf).
0235128c 121
eb199145
GM
122*** On X11, Emacs reacts to Xft changes made by configuration tools,
123via the XSETTINGS mechanism. This includes antialias, hinting,
124hintstyle, RGBA, DPI and lcdfilter changes.
125
eb199145
GM
126** Killing a buffer with a running process now asks for confirmation.
127To remove this query, remove `process-kill-buffer-query-function' from
128`kill-buffer-query-functions', or set the appropriate process flag
129with `set-process-query-on-exit-flag'.
130
131** File-local variable changes
0235128c 132
eb199145
GM
133*** Specifying a minor mode as a local variables enables that mode,
134unconditionally. The previous behavior, toggling the mode, was
135neither reliable nor generally desirable.
136
6e104790 137*** There are new commands for adding and removing file-local variables:
eb199145
GM
138`add-file-local-variable', `delete-file-local-variable',
139`add-file-local-variable-prop-line', and
140`delete-file-local-variable-prop-line'.
141
6e104790 142*** There are new commands for adding and removing directory-local variables,
eb199145
GM
143and copying them to and from file-local variable lists:
144`add-dir-local-variable', `delete-dir-local-variable',
145`copy-dir-locals-to-file-locals',
146`copy-dir-locals-to-file-locals-prop-line' and
147`copy-file-locals-to-dir-locals'.
148
149** Internationalization changes
0235128c 150
eb199145
GM
151*** Unibyte sessions are now considered obsolete.
152This refers to the EMACS_UNIBYTE environment variable as well as the
153--unibyte, --multibyte, --no-multibyte, and --no-unibyte command line
154arguments. Customizing enable-multibyte-characters and setting
155default-enable-multibyte-characters are also deprecated.
0235128c 156
eb199145
GM
157*** New coding system `utf-8-hfs'.
158This is suitable for default-file-name-coding-system on Mac OS X; see
159international/ucs-normalize.el.
160
eb199145
GM
161** Function arguments in *Help* buffers are now shown in upper-case.
162Customize `help-downcase-arguments' to t to show them in lower-case.
163
0235128c
SM
164** New command `async-shell-command', bound globally to `M-&'.
165This executes the command asynchronously, similar to calling `M-!' and
166manually adding an ampersand to the end of the command. With `M-&',
167you don't need the ampersand. The output appears in the buffer
168`*Async Shell Command*'.
169
170** When running in a new enough xterm (newer than version 242), Emacs
171asks xterm what the background color is and it sets up faces
172accordingly for a dark background if needed (the current default is to
173consider the background light).
174
eb199145
GM
175\f
176* Editing Changes in Emacs 23.2
177
178** Kill-ring and selection changes
0235128c 179
eb199145
GM
180*** If `select-active-regions' is t, any active region automatically
181becomes the primary selection (for interaction with other window
182applications). If you enable this, you might want to bind
183`mouse-yank-primary' to Mouse-2.
0235128c 184
eb199145
GM
185*** When `save-interprogram-paste-before-kill' is non-nil, the kill
186commands save the interprogram-paste selection into the kill ring
187before doing anything else. This avoids losing the selection.
0235128c 188
eb199145
GM
189*** When `kill-do-not-save-duplicates' is non-nil, identical
190subsequent kills are not duplicated in the `kill-ring'.
191
192** Completion changes
193
194*** The new command `completion-at-point' provides mode-sensitive completion.
0235128c 195
eb199145 196*** tab-always-indent set to `complete' lets TAB do completion as well.
0235128c 197
eb199145
GM
198*** The new completion-style `initials' is available.
199For instance, this can complete M-x lch to list-command-history.
0235128c 200
eb199145
GM
201*** The new variable `completions-format' determines how completions
202are displayed in the *Completions* buffer. If you set it to
203`vertical', completions are sorted vertically in columns.
204
eb199145
GM
205** The default value of `blink-matching-paren-distance' is increased.
206
eb199145
GM
207** M-n provides more default values in the minibuffer for commands
208that read file names. These include the file name at point (when ffap
209is loaded without ffap-bindings), the file name on the current line
210(in Dired buffers), and the directory names of adjacent Dired windows
211(for Dired commands that operate on several directories, such as copy,
212rename, or diff).
213
eb199145
GM
214** M-r is bound to the new `move-to-window-line-top-bottom'.
215This moves point to the window center, top and bottom on successive
216invocations, in the same spirit as the C-l (recenter-top-bottom)
217command.
218
eb199145
GM
219** The new variable `recenter-positions' determines the default
220cycling order of C-l (`recenter-top-bottom').
221
eb199145
GM
222** The abbrevs file is now a file named abbrev_defs in
223user-emacs-directory; but the old location, ~/.abbrev_defs, is used if
224that file exists.
0235128c 225
eb199145
GM
226\f
227* Changes in Specialized Modes and Packages in Emacs 23.2
228
229** The bookmark menu has a narrowing search via bookmark-bmenu-search.
230
eb199145 231** Calc
0235128c 232
eb199145
GM
233*** The Calc settings file is now a file named calc.el in
234user-emacs-directory; but the old location, ~/.calc.el, is used if
235that file exists.
0235128c 236
eb199145
GM
237*** Graphing commands (`g f' etc.) now work on MS-Windows, if you have
238the native Windows port of Gnuplot version 3.8 or later installed.
239
240** Calendar and diary
0235128c 241
eb199145
GM
242*** Fancy diary display is now the default.
243If you prefer the simple display, customize `diary-display-function'.
0235128c 244
eb199145 245*** The diary's fancy display now enables view-mode.
0235128c 246
eb199145
GM
247*** The command `calendar-current-date' accepts an optional argument
248giving an offset from today.
249
250** Desktop
0235128c 251
eb199145
GM
252*** The default value for `desktop-buffers-not-to-save' is nil.
253This means Desktop will try restoring all buffers, when you restart
254your Emacs session. Also, `desktop-buffers-not-to-save' is only
255effective for buffers that have no associated file. If you want to
256exempt buffers that do correspond to files, customize the value of
257`desktop-files-not-to-save' instead.
258
259** Dired
0235128c 260
e867cb5d
SM
261*** The new variable `dired-auto-revert-buffer', if non-nil, causes
262Dired buffers to be reverted automatically on revisiting them.
eb199145
GM
263
264** DocView
0235128c 265
eb199145
GM
266*** When `doc-view-continuous' is non-nil, scrolling a line
267on the page edge advances to the next/previous page.
268
0235128c
SM
269** Elint
270
271*** Elint now uses compilation-mode.
272
273*** Elint can now scan individual files and whole directories,
274and can be run in batch mode.
275
276*** Elint does a more thorough initialization, and recognizes more built-in
277functions and variables. Customize `elint-scan-preloaded' if you want
278to sacrifice some accuracy for a faster startup.
279
280*** Elint attempts some basic understanding of featurep and (f)boundp tests.
281
282*** Customize `elint-ignored-warnings' to suppress some warnings.
283
eb199145
GM
284** GDB-UI
285
286*** Toolbar functionality for reverse debugging. Display of STL
6e104790 287collections as watch expressions. These features require GDB 7.0 or later.
eb199145
GM
288
289** Grep
0235128c 290
eb199145
GM
291*** A new command `zrgrep' searches recursively in gzipped files.
292
293** Info
294
295*** The new command `Info-virtual-index' bound to "I" displays a menu of
296matched topics found in the index.
297
298*** The new command `info-finder' replaces finder.el with a virtual Info
299manual that generates an Info file which gives the same information
300through a menu structure.
301
0235128c
SM
302** LaTeX mode now provides completion (via completion-at-point).
303
eb199145
GM
304** Message mode is now the default mode for composing mail.
305
306The default for `mail-user-agent' is now message-user-agent, so the
307C-x m (`compose-mail') command uses Message mode instead of Mail mode.
308
309Message mode has been included in Emacs, as part of the Gnus package,
310for several years. It provides several features that are absent in
311Mail mode, such as MIME handling.
312
313*** If the user has not customized mail-user-agent, `compose-mail'
314checks for Mail mode customizations, and issues a warning if these
315customizations are found. This alerts users who may otherwise be
316unaware that their mail configuration has changed.
317
318To disable this check, set compose-mail-user-agent-warnings to nil.
319
320** The default value of mail-interactive is t, since Emacs 23.1.
321(This was not announced at the time.) It means that when sending mail,
322Emacs will wait for the process sending mail to return. If you
323experience delays when sending mail, you may wish to set this to nil.
324
325** nXML mode is now the default for editing XML files.
326
0235128c
SM
327** pcomplete provides a new command `pcomplete-std-completion' which
328is similar to `pcomplete' but using the standard completion UI code.
329
85738751 330** Shell (and other comint modes)
0235128c 331
85738751 332*** M-s is no longer bound to `comint-next-matching-input'.
0235128c 333
85738751
SM
334*** M-r is now bound to `comint-history-isearch-backward-regexp'.
335This starts an incremental search of the comint/shell input history.
0235128c 336
85738751 337*** ansi-color is now enabled by default in Shell mode.
eb199145
GM
338To disable it, set ansi-color-for-comint-mode to nil.
339
eb199145 340** Tramp
0235128c 341
eb199145
GM
342*** New connection methods "rsyncc", "imap" and "imaps".
343On systems which support GVFS-Fuse, Tramp offers also the new
344connection methods "dav", "davs", "obex" and "synce".
345
346** VC and related modes
0235128c 347
eb199145
GM
348*** When using C-x v v or C-x v i on a unregistered file that is in a
349directory not controlled by any VCS, ask the user what VC backend to
350use to create a repository, create a new repository and register the
351file.
0235128c 352
85738751
SM
353*** New command `vc-root-print-log', bound to `C-x v L'.
354This displays a `*vc-change-log*' buffer showing the history of the
355version-controlled directory tree as a whole.
0235128c 356
85738751
SM
357*** New command `vc-root-diff', bound to `C-x v D'.
358This is similar to `vc-diff', but compares the entire directory tree
359of the current VC directory with its working revision.
0235128c 360
85738751
SM
361*** `C-x v l' and `C-x v L' do not show the full log by default.
362The number of entries shown can be chosen interactively with a prefix
363argument, or by customizing vc-log-show-limit. The `*vc-change-log*'
364buffer now contains buttons at the end of the buffer, which can be
365used to increase the number of entries shown. RCS, SCCS, and CVS do
366not support this feature.
0235128c 367
eb199145
GM
368*** vc-annotate supports annotations through file copies and renames,
369it displays the old names for the files and it can show logs/diffs for
370the corresponding lines. Currently only Git and Mercurial take
371advantage of this feature.
0235128c 372
eb199145
GM
373*** The log command in vc-annotate can display a single log entry
374instead of redisplaying the full log. The RCS, CVS and SCCS VC
375backends do not support this.
0235128c 376
eb199145 377*** When a file is not found, VC will not try to check it out of RCS anymore.
0235128c 378
85738751 379*** Diff and log operations can be used from Dired buffers.
eb199145
GM
380
381*** vc-git changes
382
6e104790
SM
383**** The short log format for git makes use of the graph display,
384so it's not supported on git versions earlier than 1.5.6.
eb199145 385
6e104790
SM
386**** vc-dir uses the --relative option of git, and so requires at least
387git version 1.5.5.
eb199145 388
6e104790
SM
389**** Support for operating with stashes has been added to vc-dir:
390the stash list is displayed in the *vc-dir* header, stashes can be
391created, removed, applied and their content displayed.
eb199145
GM
392
393*** vc-bzr supports operating with shelves: the shelve list is
394displayed in the *vc-dir* header, shelves can be created, removed and applied.
0235128c 395
eb199145
GM
396*** log-edit-strip-single-file-name controls whether or not single filenames
397are stripped when copying text from the ChangeLog to the *VC-Log* buffer.
398
eb199145 399** Miscellaneous
0235128c 400
eb199145
GM
401*** Interactively `multi-isearch-buffers' and `multi-isearch-buffers-regexp'
402read buffer names to search, one by one, ended with RET. With a prefix
403argument, they ask for a regexp, and search in buffers whose names match
404the specified regexp. Interactively `multi-isearch-files' and
405`multi-isearch-files-regexp' read file names to search, one by one,
406ended with RET. With a prefix argument, they ask for a wildcard, and
407search in file buffers whose file names match the specified wildcard.
0235128c 408
eb199145 409*** Autorevert Tail mode now works also for remote files.
0235128c
SM
410
411*** The new eshell built-in commands `su' and `sudo' support Tramp.
412Thus, they change `default-directory' to reflect the new user id, and
413let commands run under that user's permissions. This works even when
eb199145 414`default-directory' is already remote. Calling the external commands
0235128c
SM
415is possible via `*su' or `*sudo', respectively.
416
417** Obsolete packages
418
419*** sym-comp.el is now obsolete, superseded by completion-at-point.
420
421*** lucid.el and levents.el are now obsolete.
eb199145
GM
422
423\f
424* New Modes and Packages in Emacs 23.2
425
426** CEDET (the Collection of Emacs Development Tools) is now in Emacs.
427This is a collection of packages to aid with using Emacs as an IDE
428(integrated development environment):
429
430*** The Semantic package allows the use of parsers to intelligently
431edit and navigate source code. Parsers for C/C++, Java, Javascript,
432and several other languages are included by default, and Semantic can
433also interface with external tools such as GNU Global and GNU Idutils.
434
435To enable Semantic, use the global minor mode `semantic-mode'.
436See the Semantic manual for details.
437
438*** EDE (Emacs Development Environment) is a package for managing code
439projects, including features such as automatic Makefile generation.
440
441To enable EDE, use the minor mode `global-ede-mode'.
442See the EDE manual for details.
443
444*** SRecode is a library for recoding Semantic tags back into source
445code. It is currently used by some parts of Semantic and EDE; in the
446future, it may be used for code generation features.
447
448*** The EIEIO library implements a subset of the Common Lisp Object
449System (CLOS). It is used by the other CEDET packages.
450
451** mpc.el is a front end for the Music Player Daemon. Run it with M-x mpc.
452
453** htmlfontify.el turns a fontified Emacs buffer into an HTML page.
454
455** js.el is a new major mode for JavaScript files.
456
457** imap-hash.el is a new library to address IMAP mailboxes as hashtables.
458
459\f
460* Incompatible Lisp Changes in Emacs 23.2
461
eb199145
GM
462** The Lisp reader turns integers that are too large/small into floats.
463For instance, on machines where `536870911' is the largest integer,
464reading `536870912' gives the floating-point object `536870912.0'.
465
466This change only concerns the Lisp reader; it does not affect how
467actual integer objects overflow.
468
eb199145
GM
469** Several obsolete functions removed.
470The functions have been obsolete since Emacs 19, and are unlikely to
471be in use:
472
473 time-stamp-month-dd-yyyy, time-stamp-dd/mm/yyyy, time-stamp-mon-dd-yyyy
474 time-stamp-dd-mon-yy, time-stamp-yy/mm/dd, time-stamp-yyyy/mm/dd,
475 time-stamp-yyyy-mm-dd, time-stamp-yymmdd, time-stamp-hh:mm:ss,
476 time-stamp-hhmm, baud-rate
477
eb199145
GM
478** Support for generating Emacs 18 compatible bytecode (by setting
479the variable `byte-compile-compatibility') has been removed.
480
6e104790
SM
481** In image-mode.el `image-mode-maybe' is obsolete.
482Instead, you can either use `image-mode' (which displays an image file
483as the actual image initially), or `image-mode-as-text' (when you want
484to display an image file as text initially). `image-mode-as-text' is a
485combination of a non-image mode from `auto-mode-alist' (or Fundamental
486mode) and `image-minor-mode'. `image-minor-mode' provides a `C-c C-c'
487key binding to toggle image display.
eb199145
GM
488`image-toggle-display-text' removes image properties.
489`image-toggle-display-image' adds image properties.
6e104790 490`image-toggle-display' toggles between `image-mode-as-text' and `image-mode'.
eb199145
GM
491
492\f
493* Lisp changes in Emacs 23.2
0235128c 494
e867cb5d
SM
495** All the default-FOO variables that hold the default value of the FOO
496variable, are now declared obsolete.
eb199145 497
e867cb5d
SM
498** read-key is a function halfway between read-event and read-key-sequence.
499It reads a single key, but obeys input and escape sequence decoding.
eb199145
GM
500
501** Frame parameter changes
0235128c 502
eb199145
GM
503*** You can give the `fullscreen' frame parameter the value `maximized'.
504This maximizes the frame.
0235128c 505
eb199145
GM
506*** The new frame parameter `sticky' makes Emacs frames sticky in
507virtual desktops.
508
e867cb5d
SM
509** Completion changes
510
511*** completion-base-size is obsoleted by completion-base-position.
eb199145
GM
512This change causes a few backward incompatibilities, mostly with
513choose-completion-string-functions where the `mini-p' argument has
514been replaced by a `base-position' argument, and where the `base-size'
515argument is now always nil.
516
e867cb5d
SM
517*** New function `completion-in-region' to use the standard completion
518facilities on a particular region of text.
0235128c 519
e867cb5d
SM
520*** The 4th arg to all-completions (aka hide-spaces) is declared obsolete.
521
522*** completion-annotate-function specifies how to compute annotations
523for completions displayed in *Completions*.
524
525** Minibuffer changes
0235128c 526
e867cb5d
SM
527*** read-file-name-predicate is obsolete. It was used to pass the predicate
528to read-file-name-internal because read-file-name-internal abused its `pred'
529argument to pass the current directory, but this hack is not needed
530any more.
531
532** Changes to file-manipulation functions
0235128c 533
e867cb5d 534*** `delete-directory' has an optional parameter RECURSIVE.
0235128c 535
e867cb5d
SM
536*** New function `copy-directory', which copies a directory recursively.
537
eb199145
GM
538** called-interactively-p now takes one argument and replaces interactive-p
539which is now marked obsolete.
e867cb5d 540
eb199145
GM
541** New function set-advertised-calling-convention makes it possible
542to obsolete arguments as well as make some arguments mandatory.
eb199145
GM
543
544** You can control which binding is preferentially shown in menus and
545docstrings by adding a `:advertised-binding' property to the corresponding
546command's symbol. That property can hold a single binding or a list
547of bindings.
548
e867cb5d 549** Network and process changes
0235128c 550
e867cb5d
SM
551*** start-process-shell-command and start-file-process-shell-command
552now only take a single `command' argument.
0235128c 553
e867cb5d
SM
554*** The new variable `process-file-side-effects' should be set to nil
555if a `process-file' call does not change a remote file. This allows
556file name handlers such as Tramp to optimizations.
0235128c 557
e867cb5d 558*** make-network-process can now also create `seqpacket' Unix sockets.
eb199145 559
e867cb5d 560** Loading changes
0235128c 561
e867cb5d 562*** eval-next-after-load is obsolete.
0235128c 563
e867cb5d
SM
564*** New hook `after-load-functions' run after loading an Elisp file.
565
566** Byte compilation changes
0235128c 567
e867cb5d
SM
568*** Changing the file-names generated by byte-compilation by redefining
569the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
570Instead, customize byte-compile-dest-file-function.
0235128c 571
e867cb5d 572*** `byte-compile-warnings' has new members, `constants' and `suspicious'.
eb199145 573
e867cb5d
SM
574** New macro with-silent-modifications to tweak text properties without
575affecting the buffer's modification state.
eb199145 576
eb199145
GM
577** Hash tables have a new printed representation that is readable.
578The feature `hashtable-print-readable' identifies this new
579functionality.
580
e867cb5d 581** New functions for performing Unicode normalization:
eb199145
GM
582ucs-normalize-NFD-region, ucs-normalize-NFD-string,
583ucs-normalize-NFC-region, ucs-normalize-NFC-string,
584ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,
585ucs-normalize-NFKC-region, ucs-normalize-NFKC-string,
586ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string,
587ucs-normalize-HFS-NFC-region, ucs-normalize-HFS-NFC-string.
588
eb199145
GM
589** Face aliases can now be marked as obsolete, using the macro
590`define-obsolete-face-alias'.
591
eb199145
GM
592** New function `window-full-height-p', analogous to the full-width version.
593
594\f
595* Changes in Emacs 23.2 on non-free operating systems
596
eb199145
GM
597** On MS-Windows, `display-time' now displays the system load average
598as well as the time, as it does on GNU and Unix.
599
600\f
601* Installation Changes in Emacs 23.1
602
603** The default X toolkit is now Gtk+, rather than Lucid.
604The configure option `--with-gtk' has been removed. Gtk is now the
605default toolkit, but you can use --with-x-toolkit=gtk if necessary.
606
607** New font code.
608Fonts are handled by new code capable of dealing with multiple font
609backends. This uses the freetype and fontconfig libraries.
610
611*** Emacs now accepts font names supplied in the fontconfig format
612(e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
613
614*** Added support for local fonts (fonts installed on the machine
615where Emacs is running).
616
617*** Added support for the Xft library for antialiasing.
618
619*** Added support for the otf library for complex text layout by
620OpenType fonts.
621
622*** Added support for the m17n library for text shaping.
623
624** Changes to image support
625
626*** configure now checks for libgif before libungif when searching for
627a GIF library.
628
629*** Emacs now supports the SVG image format through librsvg2.
630
631*** Emacs now supports multi-page TIFF images.
632
633** New NeXTSTEP-based port.
634This provides support for GNUstep (via the GNUstep libraries) and Mac
635OS X (via the Cocoa libraries).
636
637Specify --with-ns to configure for this. By default, a self-contained
638app will be built (containing all lisp). To install/share lisp with
639other emacsen (e.g. X11 build) use --disable-ns-self-contained. See
640nextstep/README and nextstep/INSTALL in the Emacs source directory.
641
642** Mac OS X is no longer supported via Carbon.
643Use the NeXTSTEP port, described above.
644
645** The new configuration option "--with-dbus" enables D-Bus language
646bindings for Emacs.
647
648** Support for many obsolete platforms has been removed.
649See the list at the end of etc/MACHINES for details.
650
651*** Support for systems without alloca has been removed.
652
653*** Support for Sun windows has been removed.
654
655*** The `emacstool' utility has been removed.
656
657** The following platforms will be removed in a future Emacs version:
658If you are still using Emacs on one of these platforms, please email
659emacs-devel@gnu.org to inform the Emacs developers.
660
661*** Old GNU/Linux systems based on libc version 5.
662
663*** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
664executable format.
665
666*** Solaris versions 2.6 and below.
667
668*** Solaris on IBM RS6000 machines.
669
670*** UNIX System V (the original SysV, not later platforms based on it).
671
672*** Unixware on non-x86 machines.
673
674*** Platforms not supporting shared libraries (i.e., requiring the
675NO_SHARED_LIBS compilation flag).
676
677** The configure options `--with-gcc', `--without-gcc' have been removed.
678Configure will use gcc by default. Set the CC environment variable if
679you need control over which C compiler is used.
680
681** The refcards are now shipped as PDF files.
682
683** The manuals are now licensed under the GNU Free Documentation License v1.3,
684or any later version.
685
686** Emacs 23 comes with a new set of default icons.
687Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
688The Emacs 22 icon is available as `emacs22.png' in the same location.
689\f
690* Changes in Emacs 23.1
691
692** Improved X Window System support
693
694*** Emacs now supports using both X displays and ttys in one session.
695With an Emacs server active (M-x server-start), `emacsclient -t'
696creates a tty frame connected to the running emacs server. You can
697use any number of different ttys. `emacsclient -c' creates a new X11
698frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
699There may be problems if a display exits unexpectedly and Emacs is compiled
700with Gtk+, see etc/PROBLEMS.
701
702You can test for the presence of this feature in your Lisp code by
703testing for the `multi-tty' feature.
704
705*** Emacs starts in the background, as a daemon, when given the
706--daemon command line argument. It disconnects from the terminal and
707starts the server. Clients can connect and create graphical or
708terminal frames using emacsclient.
709
710**** emacsclient starts emacs in daemon mode and connects to it when
711--alternate-editor="" is used (or when the evironment variable
712ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an
713emacs server.
714
715*** The new command close-display-connection closes a connection to a
716remote display. There are some bugs for Gtk+. See etc/PROBLEMS.
717
718*** Emacs now supports the XEmbed specification.
719You can embed Emacs in another application on X11. The new command line
720option --parent-id is used to pass the parent window id to Emacs. See
721http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
722for details about XEmbed.
723
724*** Emacs can now set the frame opacity.
725The opacity of a frame can be controlled by setting the `alpha' frame
726parameter. This only takes effect on a compositing window manager for
727the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac
728OS X, or on Windows 2000 and later versions of Windows.
729
730The alpha parameter should be an integer between 0 (transparent) and
731100 (opaque), or a float number between 0.0 and 1.0. It can also be a
732cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
733active frame and INACTIVE is the opacity of non-active frames.
734
735The variable `frame-alpha-lower-limit' defines a lower bound for the
736opacity; the default is 20.
737
738** Internationalization changes
739
740*** The Emacs character set is now a superset of Unicode.
741(It has about four times the code space, which should be plenty).
742
743The internal encoding used for buffers and strings is now
744Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias
745for this). This encoding is backward-compatible with Unicode's UTF-8
746encoding. The internal encoding previously used by Emacs,
747`emacs-mule', is still available for reading and writing files.
748
749During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
750As a result, byte-compiled files containing non-ASCII characters can't
751be read by earlier versions of Emacs. Files compiled by Emacs 20, 21,
752or 22 are loaded correctly as `emacs-mule' (whether or not they
753contain multibyte characters). This takes somewhat more time, so it
754may be worth recompiling existing .elc files which don't need to be
755shared with older Emacsen.
756
757*** There are new coding systems/aliases; see M-x list-coding-systems.
758
759*** There is a new charset implementation with many new charsets.
760See M-x list-character-sets. New charsets can be defined conveniently
761as tables of unicodes.
762
763*** There are new language environments for Chinese-GBK,
764Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
765Sinhala, and TaiViet.
766
767*** The minor modes unify-8859-on-encoding-mode and
768unify-8859-on-decoding-mode are obsolete.
769
770*** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers
771accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for
772decimal). It also accepts Unicode character names with completion.
773
774*** The `cyrillic-translit' input method supports many new characters.
775Common typographical characters available from Unicode were added to
776`cyrillic-translit': punctuation marks, accented characters, fractions,
777and others.
778
779** Emacs now supports serial port access on GNU/Linux, Unix, and
780Windows. The new command `serial-term' starts an interactive terminal
781on a serial port. The serial port can be configured at runtime with
782the mode-line mouse menu.
783
784** Menu Bar changes
785
786*** In the Options menu, the "Set Default Font" item applies the
787selected font to the `default' face on all frames, not just the
788current frame. Furthermore, if Emacs is compiled with both GTK and
789Fontconfig support, the "Set Default Font" item uses the GTK font
790selection dialog instead of an Emacs pop-up menu.
791
792*** The font setting chosen by "Set Default Font" is saved if the
793"Save Options" item is used.
794
795*** The Tools menu contains a new Encryption/Decryption submenu.
796This contains commands provided by EasyPG, the newly-included
797interface to GnuPG (see New Modes and Packages).
798
799*** In the Options menu, the "Truncate Long Lines in the Buffer" entry
800has been replaced with a submenu offering three different ways to
801handle long lines: truncation, continuation at the window edge, and
802the new word wrapping behavior (see Editing Changes, below).
803
804*** Improvements to menus for major and minor modes
805More major and minor modes now have a mode specific menu, and existing
806mode menus have been improved to include more functionality.
807
808** Mode-line changes
809
810*** The mode-line displays a `@', instead of `-', if the
811default-directory for the current buffer is on a remote machine.
812
813*** The mode-line displays a mode menu when mouse-1 is clicked on a
814minor mode, in the same way as it already did for major modes.
815
816*** The `mode-line-emphasis' face is used to highlight certain
817mode-line information (e.g. waiting for a VC command to finish).
818
819*** The mode-line tooltips have been improved to provide more details.
820
821*** The VC, line/colum number and minor mode indicators on the mode
822line are now interactive: mouse-1 can be used on them to pop up a menu.
823
824** File deletion can make use of the Recycle Bin or system Trash folder.
825Set `delete-by-moving-to-trash' non-nil to use this. Deleted files
826and directories will then be sent to the Recycle Bin on Windows, and
827to `trash-directory' on other systems.
828
829** Directory-local variables can now be defined.
830By default, Emacs looks in .dir-locals.el for directory-local
831variables. For more information, see `dir-locals-set-directory-class'
832and `dir-locals-set-class-variables'.
833
834** Emacs can now use `auth-source' for authentication.
835`smtpmail' and `url' (Tramp and Gnus also) use `auth-source' to obtain
836login names and passwords. The match, if found, is reported
837in *Messages* with the password blanked out.
838
839** `where-is-preferred-modifier' can specify your favorite modifier.
840
841\f
842* Startup Changes in Emacs 23.1
843
844** The option `inhibit-startup-screen' (with aliases to old names
845`inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
846display of the initial message in the *scratch* buffer. If you don't
847want to display the initial message in the *scratch* buffer at startup,
848you can set the option `initial-scratch-message' to nil.
849
850** New user option `initial-buffer-choice' specifies what to display
851after starting Emacs: startup screen, *scratch* buffer, visiting a
852file or directory.
853
854** New alias `argv' for `command-line-args-left'
855This is a convenience alias, so that one can write `(pop argv)'
856inside of --eval command line arguments in order to access
857following arguments.
858
859** The abbrev file is no longer read at startup in batch mode.
860
861** Emacs now supports invocation by an X session manager.
862It can save a session and restore it later. See the documentation of
863the functions `emacs-session-save' and `emacs-session-restore'.
864(Actually, this feature was introduced with Emacs 22, but it was not
865documented.)
866\f
867* Incompatible Editing Changes in Emacs 23.1
868
869** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&'
870on the regexp command prefix map.
871
872** In Dired-x, all command guesses for ! are now added to the default
873list accessible by M-n instead of pushing all guesses temporarily into
874the history list.
875
876** In Isearch mode, a special case of typing `C-w' at the beginning of
877the minibuffer that toggles word search (i.e. using key sequences
878`C-s RET C-w' or `C-s M-e C-w') is obsolete. You can use the global key
879`M-s w' to start word search, or type `M-s w' in Isearch mode to
880toggle word search. To start nonincremental word search you can now use
881`M-s w RET' and `M-s w C-r RET' instead of `C-s RET C-w' and `C-r RET C-w'.
882
883** In Info, `Info-search' is unbound from `M-s' to allow using `M-s w'
884for word search as well as other search commands from the global prefix
885key `M-s'. `Info-search' is still bound to `s', and also incremental
886search commands `C-s', `C-M-s', `C-r', `C-M-r' are available for searching
887through multiple Info nodes, together with their nonincremental versions
888`C-s RET', `C-r RET', `C-M-s RET', `C-M-r RET', `M-s w RET'.
889
890** In Text mode, `center-line' and `center-paragraph' are rebound from
891`M-s' and `M-S' to global keys `M-o M-s' and `M-o M-S' on the global
892prefix map `M-o', which is intended for such formatting commands.
893
894** The following input methods were removed in Emacs 22.2, but this was
895not advertised: danish-alt-postfix, esperanto-alt-postfix,
896finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
897norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
898and swedish-alt-postfix. Use the versions without "alt-", which are
899identical.
900
901\f
902* Editing Changes in Emacs 23.1
903
904** The C-n and C-p line-motion commands now move by screen lines,
905taking continued lines and variable-width characters into account.
906Setting `line-move-visual' to nil reverts this to the previous
907behavior (i.e., motion by logical lines based on buffer contents
908alone).
909
910** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
911invokes `suspend-frame'. These changes are for compatibility with the
912new multi-tty support (see `Improved X Window System support' above).
913
914** Mark changes
915
916*** Transient Mark mode is now on by default.
917
918*** mark-even-if-inactive now defaults to t
919
920*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
921activating it.
922
923*** When Transient Mark mode is on, M-q now fills the region if the
924region is active. Otherwise, it fills the current paragraph.
925
926*** When Transient Mark mode is on, M-$ now checks spelling of the
927region if the region is active. Otherwise, it checks spelling of the
928word at point.
929
930*** When Transient Mark mode is on, TAB now indents the region if the
931region is active.
932
933*** The variable `use-empty-active-region' controls whether an empty
934active region in Transient Mark mode should make commands operate on
935that empty region.
936
937** Temporarily active regions
938
939*** The new variable shift-select-mode, non-nil by default, controls
940shift-selection. When Shift Select mode is on, shift-translated
941motion keys (e.g. S-left and S-down) activate and extend a temporary
942region, similar to mouse-selection.
943
944*** Temporarily active regions, created using shift-selection or
945mouse-selection, are not necessarily deactivated in the next command.
946They are only deactivated after point motion commands that are not
947shift-translated, or after commands that would ordinarily deactivate
948the mark in Transient Mark mode (e.g., any command that modifies the
949buffer).
950
951** Minibuffer and completion changes
952
953*** Emacs may ask for confirmation before opening a non-existent file
954or buffer. By default, Emacs requests confirmation if you type RET
955immediately after TAB, and the resulting input is not an existing file
956or buffer; this usually happens when the minibuffer input did not
957complete far enough and you entered RET by mistake. In that case,
958Emacs puts the message "[Confirm]" in the minibuffer; type RET again
959to create the file or buffer.
960
961The new variable confirm-nonexistent-file-or-buffer determines whether
962Emacs asks for confirmation. The default value is `after-completion'.
963If you change it to t, Emacs always asks for confirmation; if you
964change it to nil, Emacs never asks for confirmation.
965
966*** The rules for performing completion have been changed.
967When generating completion alternatives, Emacs now takes the
968minibuffer text after point, if any, into account: this text is
969treated as a substring of the remaining part of the completion
970alternative (i.e., the part not matched by the minibuffer text before
971point). If no completion alternatives are found this way, Emacs
972attempts to perform partial-completion. If still no completion
973alternatives are found, we fall back on the Emacs 22 rules for
974performing completion.
975
976The new variable `completion-styles' can be customized to choose your
977favorite completion style.
978
979*** When M-n in the minibuffer reaches the end of the list of defaults,
980it adds the completion list to the end, so next M-n continues putting
981completion items to the minibuffer. The same principle applies to
982incremental search commands as well: C-s or C-M-s starts searching
983the default values and after the end of defaults they continue
984searching minibuffer completion items.
985
986*** Minibuffer input of shell commands now comes with completion.
987
988*** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
989name of the current buffer.
990
991*** In the M-! (shell-command) prompt, M-n provides some default commands.
992These are guessed using the file extension of the current file, based
993on the file-handlers specified in the operating system's `mailcap'
994file. The ! command in Dired (dired-do-shell-command) works
995similarly, using the file displayed on the current line.
996
997*** A list of regexp default values is available via M-n for `occur',
998`keep-lines', `flush-lines' and `how-many'. This list includes the active
999region in transient-mark-mode, the word under the cursor, the last Isearch
1000regexp, the last Isearch string and the last replacement regexp.
1001
1002*** When enable-recursive-minibuffers is non-nil, operations which use
1003switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when
1004used in a minibuffer or a dedicated window. Instead, they fallback on
1005using pop-to-buffer, which will use some other window. This change
1006has no effect when enable-recursive-minibuffers is nil (the default).
1007
1008*** Isearch started in the minibuffer searches in the minibuffer history.
1009Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer
1010history elements, and forward Isearch commands (C-s, C-M-s) search in
1011next history elements. When the reverse search reaches the first history
1012element, it wraps to the last history element, and the forward search
1013wraps to the first history element. When the search is terminated, the
1014history element containing the search string becomes the current.
1015
1016*** The variable read-file-name-completion-ignore-case overrides
1017completion-ignore-case for file name completion.
1018
1019*** The variable read-buffer-completion-ignore-case overrides
1020completion-ignore-case for buffer name completion.
1021
1022*** The new command `minibuffer-force-complete' chooses one of the
1023possible completions, rather than stopping at the common prefix.
1024
1025*** If `completion-auto-help' is `lazy', Emacs shows the completions
1026buffer only on the second attempt to complete. This was already
1027supported in `partial-completion-mode'.
1028
1029** Face changes
1030
1031*** S-down-mouse-1 now pops up a menu for changing the font and text
1032size of the default face in the current buffer. The face is changed
1033via face remapping (see Lisp changes, below).
1034
1035*** New commands to change the default face size in the current buffer.
1036To increase it, type `C-x C-+' or `C-x C-='. To decrease it, type
1037`C-x C--'. To restore the default (global) face size, type `C-x C-0'.
1038These work via Text Scale mode, a new minor mode.
1039
1040The final key in the above commands may be repeated without the
1041leading `C-x', e.g. `C-x C-= C-= C-=' increases the face height by
1042three steps. Each step scales the height of the default face by the
1043value of the variable `text-scale-mode-step'.
1044
1045*** The commands buffer-face-mode and buffer-face-set can be used to
1046remap the default face in the current buffer. See "Buffer Face mode",
1047under New Modes and Packages.
1048
1049** Primary selection changes
1050
1051*** You can disable kill ring commands from accessing the primary
1052selection by setting `x-select-enable-primary' to nil.
1053
1054** Continuation lines can now be wrapped at word boundaries
1055(word-wrapping). This is controlled by the new per-buffer variable
1056`word-wrap'. Word wrapping does not take place if continuation lines
1057are not shown, e.g. if truncate-lines is non-nil. The most convenient
1058way to enable word-wrapping is using the new minor mode Visual Line
1059mode; in addition to setting `word-wrap' to t, this rebinds some
1060editing commands to work on screen lines rather than text lines. See
1061New Modes and Packages, below.
1062
1063** Window management changes
1064
1065*** truncate-partial-width-windows now accepts integer values, which
1066specify a minimum window width for partial-width windows, below which
1067lines are truncated. The default has been changed to 50.
1068
1069*** The new command balance-windows-area balances windows both
1070vertically and horizontally.
1071
1072*** pop-to-buffer now always sets input focus when the popped-to window
1073is on a different frame.
1074
1075** Miscellaneous changes:
1076
1077*** C-l is bound to the new command recenter-top-bottom, rather than recenter.
1078This moves the current line to window center, top and bottom on
1079successive invocations.
1080
1081*** scroll-preserve-screen-position also preserves the column position.
1082
1083*** If `yank-pop-change-selection' is t, rotating the kill ring also
1084updates the selection or clipboard to the current yank, just as M-w
1085would do so with the text it copies to the kill ring.
1086
1087*** C-M-% now shows replacement as it would look in the buffer, with
1088`\N' and `\&' substituted according to the match. Old behavior can be
1089restored by customizing `query-replace-show-replacement'.
1090
1091*** The command shell prompts for the default directory, when it is
1092called with a prefix and the default directory is a remote file name.
1093This is because some file name handlers (like ange-ftp) are not able to
1094run processes remotely.
1095
1096*** The new command kill-matching-buffers kills buffers whose name
1097matches a regexp.
1098
1099*** The value of comment-style now defaults to `indent'.
1100Thefore, comment-start markers are inserted at the current indentation
1101of the region to comment, rather than the leftmost column.
1102
1103*** The new commands `pp-macroexpand-expression' and
1104`pp-macroexpand-last-sexp' pretty-print macro expansions.
1105
1106*** The new command `set-file-modes' allows to set file's mode bits.
1107The mode bits can be specified in symbolic notation, like with GNU
1108Coreutils, in addition to an octal number. `chmod' is a new
1109convenience alias for this function.
1110
1111*** `next-error-recenter' specifies how next-error should recenter the
1112visited source file. Its value can be a number (for example, 0 for
1113top line, -1 for bottom line), or nil for no recentering.
1114
1115*** When typing in a password in the echo area, C-y yanks the current
1116kill into the password.
1117
1118*** Tooltip frame parameters `font' and `color' in `tooltip-frame-parameters'
1119are ignored. Customize the `tooltip' face instead.
1120
1121*** `mkdir' is a new convenience alias for `make-directory'.
1122\f
1123* New Modes and Packages in Emacs 23.1
1124
1125** Auto Composition Mode is a minor mode that composes characters
1126automatically when they are displayed. It is globally on by default.
1127It uses `auto-composition-function' (default `auto-compose-chars').
1128
1129** Bubbles, a new game, is similar to SameGame.
1130
1131** Buffer Face mode is a minor mode for remapping the default face in
1132the current buffer. The variable `buffer-face-mode-face' specifies
1133the face to remap to. The command `buffer-face-set' prompts for a
1134face name, sets `buffer-face-mode-face' to it, and enables
1135buffer-face-mode. See "Face changes", under Editing Changes, for a
1136description of face remapping.
1137
1138** butterfly flips the desired bit on the drive platter.
1139See http://xkcd.com/378/
1140
1141** bug-reference.el provides clickable links to bug reports.
1142
1143** dbus.el provides D-Bus language bindings.
1144D-Bus is an inter-process communication mechanism for applications
1145residing on the same host. See the manual for details.
1146
1147** DocView mode allows viewing of PDF, PostScript and DVI documents.
1148One can also search for a regular expression in the document. For
1149details, see the commentary in doc-view.el.
1150
1151PDF and DVI files are now opened in Doc View mode by default.
1152
1153In Postcript mode, C-c C-c launches Doc View minor mode for viewing
1154the postscript file.
1155
1156** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
1157It includes a GnuPG keyring browser, cryptographic operations on
1158regions and files, and automatic encryption of *.gpg files. For
1159details, see the EasyPG Assistant User's Manual.
1160
1161** json.el is a library for parsing and generating JSON
1162(JavaScript Object Notation), a lightweight data-interchange format.
1163
1164** linum.el is a new minor mode to display line numbers for the
1165current buffer.
1166
1167** mairix.el is an interface to mairix, a free tool for indexing and
1168searching locally stored mail. It allows you to query mairix and
1169display the search results with Rmail, Gnus and VM. Note that there
1170is an existing Gnus back end, nnmairix.el, which should be used with
1171Maildir/MH setups.
1172
1173** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt.
1174
1175** nXML Mode
1176This is a new mode for editing XML documents. It allows a schema to
1177be associated with the XML document being edited, using Relax NG as
1178the schema language. The schema is used to provide two key features:
1179
1180*** Continuous validation. nXML validates as you type, highlighting
1181any invalid parts of your document.
1182
1183*** Completion. nXML can assist you in entering an element name,
1184attribute name or data value by using information about what is
1185allowed by the schema in that context.
1186
1187** proced.el provides a Dired-like interface for operating on
1188processes. Proced makes an Emacs buffer containing a listing of the
1189current processes. You can use the normal Emacs commands to move
1190around in this buffer, and special Proced commands to operate on the
1191processes listed. It is currently only functional on GNU/Linux,
1192MS-Windows and Solaris.
1193
1194** Remember Mode is a mode for jotting down things to remember.
1195Notes can be saved to a Diary file. For details, see the Remember
1196Manual.
1197
1198** RST mode is a major mode for editing reStructuredText files.
1199
1200** Ruby mode is a major mode for Ruby files.
1201
1202** Visual Line mode provides support for editing by visual lines.
1203It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
1204and C-k to commands that operate by visual lines instead of logical
1205lines. This is a more reliable replacement for longlines-mode.
1206This can also be turned on using the menu bar, via
1207Options -> Line Wrapping in this Buffer -> Word Wrap
1208
1209** xesam.el is an implementation of Xesam, an interface to (desktop)
1210search engines like Beagle, Strigi, and Tracker. The Xesam API
1211requires D-Bus for communication.
1212
1213** zeroconf.el offers service discovery and service publishing
1214interfaces according to the zeroconf specification. It communicates
1215with Avahi, a zeroconf implementation, via D-Bus messages on systems
1216which have installed this software.
1217
1218** There is a new `whitespace' package.
1219(The pre-existing one has been renamed to `old-whitespace'.)
1220Now, besides reporting bogus blanks, the whitespace package has a
1221minor mode and a global minor mode to visualize blanks (TAB, (HARD)
1222SPACE and NEWLINE). The visualization is made via faces and/or display
1223table. It can also indicate lines that extend beyond a given column,
1224trailing blanks, and empty lines at the start or end of a buffer.
1225See `whitespace-style' for more details. The `whitespace-action' option
1226specifies what to do when a buffer is visited, killed, or written.
1227
1228\f
1229* Changes in Specialized Modes and Packages in Emacs 23.1
1230
1231** Abbrev has been rewritten in Elisp and extended with more flexibility.
1232
1233*** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
1234abbrev-table-p, abbrev-insert, abbrev-table-menu.
1235
1236*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
1237
1238*** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
1239extra arguments for arbitrary properties.
1240
1241*** New variable `abbrev-minor-mode-table-alist'.
1242
1243*** `local-abbrev-table' can hold a list of abbrev-tables.
1244
1245*** Abbrevs have now the following special properties:
1246`:count', `:system', `:enable-function', `:case-fixed'.
1247
1248*** Abbrev-tables have now the following special properties:
1249`:parents', `:case-fixed', `:enable-function', `:regexp',
1250`abbrev-table-modiff'.
1251
1252** Apropos
1253
1254*** `apropos-library' describes the elements defined in a given library.
1255
1256*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
1257
1258** Archive Mode has basic support to browse Rar archives.
1259Note, however, that the free version of the unrar command only handles
1260versions 1 and 2 of the Rar format.
1261
1262** BibTeX mode
1263
1264*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
1265
1266*** New `bibtex-entry-format' options `whitespace', `braces', and
1267`string', disabled by default.
1268
1269*** New variable `bibtex-cite-matcher-alist' contains rules to
1270identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
1271
1272*** Command `bibtex-url' allows multiple URLs per entry.
1273
1274** Bookmarks
1275
1276*** bookmark.el saves bookmarks in a pre-Emacs-23-incompatible file format
1277bookmark.el can read a .emacs.bmk file saved by an older Emacs, but an
1278older Emacs cannot read one saved by Emacs 23.
1279
1280** Calendar and diary
1281
1282*** There is a new date style, `iso', essentially year/month/day.
1283The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
1284Similarly, the commands `american-calendar' and `european-calendar'
1285should be replaced by `calendar-set-date-style'.
1286
1287*** The calendar namespace has been rationalized.
1288All functions and variables now begin with a `calendar-', `diary-', or
1289`holiday-' prefix. The various calendar systems have secondary
1290prefixes, eg `calendar-french-'. The old names you are likely to use
1291directly still exist, for the time being, as aliases, but please start
1292using the new names.
1293
1294*** The whitespace in the calendar layout can be customized.
1295See the variables:
1296calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
1297calendar-day-header-width, and calendar-day-digit-width.
1298
1299*** Text (e.g. ISO weeks) can be displayed between the calendar months.
1300See the variables calendar-intermonth-header and calendar-intermonth-text.
1301
1302*** The function `holiday-chinese' computes holidays on the Chinese calendar.
1303It has been used to add items to the list `holiday-oriental-holidays'.
1304
1305*** `diary-remind' accepts a negative number -DAYS as a shorthand for
1306the list (1 2 ... DAYS).
1307
1308** Change Log mode
1309
1310*** The new command C-c C-f (change-log-find-file) finds the file
1311associated with the current log entry.
1312
1313*** The new command C-c C-c (change-log-goto-source) goes to the
1314source code associated with a log entry.
1315
1316** Compile and grep modes
1317
1318*** The mode-line entry for the *compilation* and *grep* buffer is color coded.
1319It has different colors for to show that: (a) the command is still
1320running, (b) successful completion, (c) error.
1321
1322*** compilation-auto-jump-to-first-error tells `compile' to jump to
1323the first error encountered during compilations.
1324
1325*** compilation-scroll-output accepts a new value, `first-error', which
1326says to stop auto scrolling at the first error that occurs.
1327
1328*** The `cc' alias for C++ files in `grep-file-aliases' has been
1329improved. `hh' can be used to match C++ header files and `cchh' both
1330C++ sources and headers.
1331
1332** Copyright
1333
1334*** You can specify your copyright holders' names.
1335Only copyright lines with holders matching `copyright-names-regexp' are
1336considered for update.
1337
1338*** Copyrights can be at the end of the buffer.
1339This is controlled by `copyright-at-end-flag' (used by, e.g., change-log-mode).
1340
1341** Custom
1342
1343*** defcustom accepts new keyword arguments, `:safe' and `:risky', which
1344set a variable's `safe-local-variable' and `risky-local-variable' property.
1345
1346** Diff mode
1347
1348*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
1349It's used automatically as you move through hunks, see
1350diff-auto-refine-mode. It is bound to `C-c C-b'.
1351
1352*** diff-add-change-log-entries-other-window iterates through the diff
1353buffer and tries to create ChangeLog entries for each change.
1354It is bound to `C-x 4 A'.
1355
1356*** Turning on `whitespace-mode' in a diff buffer will show trailing
1357whitespace problems in the modified lines.
1358
1359** Dired
1360
1361*** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
1362and C-x C-q in wdired-mode exits it with asking a question about
1363saving changes.
1364
1365*** `&' runs the command `dired-do-async-shell-command' that executes
1366the command asynchronously without the need to manually add ampersand
1367to the end of the command. Its output appears in the buffer `*Async Shell
1368Command*'.
1369
1370*** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names.
1371When a new user option `dired-isearch-filenames' is t, then even ordinary
1372Isearch started with `C-s' and `C-M-s' matches only at file names in the
1373Dired buffer. When `dired-isearch-filenames' is `dwim' then activation of
1374file name Isearch depends on the position of point - if point is on a file
1375name initially, then Isearch matches only file names, otherwise it matches
1376everywhere in the Dired buffer. You can toggle file names matching on or
1377off by typing `M-s f' in Isearch mode.
1378
1379*** `M-s a C-s' and `M-s a M-C-s' run multi-file Isearch on the marked files.
1380They visit the first marked file in the sequence and display the usual Isearch
1381prompt for a string or a regexp where all Isearch commands are available.
1382
1383*** `Q' in Dired provides two new keys for multi-file replacement.
1384The upper case key `Y' replaces all remaining matches in all remaining files
1385with no more questions. The upper case key `N' stops doing replacements
1386in the current file and skips to the next file. These multi-file keys
1387are available for all commands that use `tags-query-replace'
1388including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
1389`reftex-query-replace-document'.
1390
1391** Fortran
1392
1393*** The line length of fixed-form Fortran is not fixed at 72 any more.
1394Customize the variable `fortran-line-length' to change it.
1395
1396*** In Fortran mode, M-; is now bound to the standard comment-dwim,
1397rather than fortran-indent-comment.
1398
1399*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
1400
1401** Gnus
1402
1403*** The Gnus package has been updated
0235128c 1404There are many new features, bug fixes and improvements; see the file
eb199145
GM
1405GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
1406
1407*** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
0235128c 1408saving articles, drafts, and ~/.newsrc.eld. These file may not be read
eb199145
GM
1409correctly in Emacs 22 and below. If you want to Gnus across different Emacs
1410versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
1411
1412*** Passwords are consistently loaded through `auth-source'
1413Gnus can use `auth-source' for POP and IMAP passwords. Also see that
1414`smtpmail' and `url' support `auth-source' for SMTP and HTTP/HTTPS/RSS
1415authentication respectively.
1416
1417** Help mode
1418
1419*** New macro `with-help-window' should set up help windows better
1420than `with-output-to-temp-buffer' with `print-help-return-message'.
1421
1422*** New option `help-window-select' permits to customize whether help
1423window shall be automatically selected when invoking help.
1424
1425*** New variable `help-window-point-marker' permits one to specify a new
1426position for point in help window (for example in `view-lossage').
1427
1428** Isearch
1429
1430*** New command `isearch-forward-word' bound globally to `M-s w' starts
1431incremental word search. New command `isearch-toggle-word' bound to the
1432same key `M-s w' in Isearch mode toggles word searching on or off
1433while Isearch is active.
1434
1435*** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch
1436mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current
1437search string as its regexp argument. The same key `M-s h r' and
1438other keys on the `M-s h' prefix are bound globally to the command
1439`highlight-regexp' and other hi-lock commands.
1440
1441*** New command `isearch-occur' bound to `M-s o' in Isearch mode
1442runs `occur' with the current search string. The same key `M-s o'
1443is bound globally to the command `occur'.
1444
1445*** Isearch can now search through multiple ChangeLog files.
1446When running Isearch in a ChangeLog file, if the search fails,
1447then another C-s tries searching the previous ChangeLog,
1448if there is one (e.g. going from ChangeLog to ChangeLog.12).
1449This is enabled if multi-isearch-search is non-nil.
1450
1451*** Two new commands to start Isearch on a list of marked buffers
1452for buff-menu.el and ibuffer.el are bound to the keys `M-s a C-s' and
1453`M-s a M-C-s'.
1454
1455*** The part of an Isearch that failed to match is highlighted in
1456`isearch-fail' face.
1457
1458*** `C-h C-h' in Isearch mode displays isearch-specific Help screen,
1459`C-h b' displays all Isearch key bindings, `C-h k' displays the full
1460documentation of the given Isearch key sequence, `C-h m' displays
0235128c
SM
1461documentation for Isearch mode. All the other Help commands exit
1462Isearch mode and execute their global definitions.
eb199145
GM
1463
1464*** When started in the minibuffer, Isearch searches in the minibuffer
1465history. See `Minibuffer changes', above.
1466
1467** MH-E
1468
1469*** Upgraded to MH-E version 8.2. See MH-E-NEWS for details.
1470
1471** Python
1472*** The file etc/emacs.py now supports both Python 2 and 3, meaning
1473that either version can be used as inferior Python by python.el.
1474
1475*** Python mode now has `pdbtrack' functionality. When using pdb to
1476debug a Python program, pdbtrack notices the pdb prompt and displays
1477the source file and line that the program is stopped at, much the same
1478way as gud-mode does for debugging C programs with gdb.
1479
1480** Recentf
1481
1482*** The default value of `recentf-keep' prevents from checking of
1483remote files, if there is no established connection to the
1484corresponding remote host.
1485
1486** Rmail
1487
1488*** Rmail no longer converts the messages to Babyl format.
1489Instead, it uses UNIX mbox format, both on disk and in Rmail buffers,
1490and does conversion and decoding when a message is displayed.
1491
1492The first time you visit an Rmail file in Babyl format, Rmail
1493automatically converts it to mbox format. This is a one-time
1494conversion, but it can take a few minutes, depending on how fast is
1495your machine and on the size of the file. You should find the rest of
1496Rmail usage unaltered.
1497
1498However, M-x set-rmail-inbox-list now lasts only for one session
1499because there is no way to save the list of inbox files in an
1500mbox-format file.
1501
1502Also, whereas with Babyl format M-x find-file would switch to Rmail
1503mode, with mbox format this is no longer the case (there being no way
1504to add an "-*- rmail-*-" cookie to an mbox file). Use C-u M-x rmail
1505instead.
1506
1507If you have written any extensions to Rmail, they are likely to need
1508updating. Conceptually, the Rmail buffer that you see is no longer
1509just a narrowed portion of the whole. So you cannot access the whole
1510of a message (or message collection) by a simple save-restriction and
1511widen. Instead, there are two buffers: the rmail-buffer, and the
1512rmail-view-buffer. The former is the buffer that you see, the latter
1513is invisible. Most of the time, the invisible `view' buffer contains
1514the full contents of the Rmail file, and the Rmail buffer contains a
1515decoded copy of the current message (with only a subset of the
1516headers). In this state, Rmail is said to be `swapped'.
1517
1518You may find the following functions useful:
1519
1520`rmail-get-header' and `rmail-set-header' get or set the value of a
1521message header, whether or not it is currently visible.
1522
1523`rmail-apply-in-message' is a general purpose function that calls a
1524function (with arguments) which you specify on the full text of a given
1525message. To further narrow to just the headers, search forward for "\n\n".
1526
1527*** The new command `rmail-mime' displays MIME messages.
1528It is bound to `v' in Rmail buffers and summaries. It displays plain
1529text and multipart messages in a temporary buffer, and offers buttons
1530to save attachments.
1531
1532*** The command `rmail-redecode-body' no longer accepts the optional arg RAW.
1533Since Rmail now holds messages in their original undecoded form in a
1534separate buffer, `rmail-redecode-body' no longer encodes the original
1535message, and therefore there should be no need to avoid encoding it.
1536
1537*** The o command is now `rmail-output'. It is an all-purpose command
1538for copying messages from Rmail and appending them to files. It
1539handles Babyl-format files as well as mbox-format files, and it
1540handles both kinds properly when they are visited in Emacs. It always
1541copies the full headers of the message.
1542
1543*** The C-o command is now `rmail-output-as-seen'. It uses
1544the message as displayed, appending it to an mbox file.
1545
1546*** The modified status of the Rmail buffer is reported in the mode-line.
1547Previously, this information was hidden.
1548
1549** TeX modes
1550
1551*** New option latex-indent-within-escaped-parens
1552permits to customize indentation of LaTeX environments delimited
1553by escaped parens.
1554
1555** T-mouse Mode
1556
1557*** If the gpm mouse server is running and t-mouse-mode is enabled,
1558Emacs uses a Unix socket in a GNU/Linux console to talk to server,
1559rather than faking events using the client program mev. This C level
1560approach provides mouse highlighting and help echoing in the
1561minibuffer.
1562
1563** Tramp
1564
1565*** New connection methods.
1566The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have
1567been introduced. There are also new so-called gateway methods
1568"tunnel" and "socks".
1569
1570*** IPv6 addresses.
1571IPv6 addresses are supported now as host names. They must be embedded
1572in square brackets, like in "/ssh:[::1]:".
1573
1574*** Multihop syntax has been removed.
1575The pseudo-method "multi" has been removed. Instead, multi hops
1576can be specified by the new variable `tramp-default-proxies-alist'.
1577
1578*** More default settings.
1579Default values can be set via the variables `tramp-default-user',
1580`tramp-default-user-alist' and `tramp-default-host'.
1581
1582*** Connection information is cached.
1583In order to reduce connection setup, information about used
1584connections is kept persistently in a file. The name of this file is
1585defined in the variable `tramp-persistency-file-name'.
1586
1587*** Control of remote processes.
1588Running processes on a remote host can be controlled by settings in
1589`tramp-remote-path' and `tramp-remote-process-environment'.
1590
1591*** Success of remote copy is checked.
1592When the variable `file-precious-flag' is set, the success of a remote
1593file copy is checked via the file's checksum.
1594
1595*** Passwords can be read from an authentification file.
1596Tramp uses the package `auth-source' to read passwords from a file, if
1597necessary.
1598
1599** VC and related modes
1600
1601*** VC now supports applying VC operations to a set of files at a time.
1602This enables VC to work much more effectively with changeset-oriented
1603version-control systems such as Subversion, GNU Arch, Mercurial, Git
1604and Bzr. VC will now pass a multiple-file commit to these systems as
1605a single changeset.
1606
1607*** vc-dir is a new command that displays file names and their VC
1608status. It allows to apply various VC operations to a file, a
1609directory or a set of files/directories.
1610
1611*** VC switches are no longer appended, rather the first non-nil value is used.
1612(This was for the most part true in Emacs 22, but was not advertised).
1613This is because there is an increasing variety of VC systems, and they
1614do not all accept the same "common" options. For example, a CVS diff
1615command used to append the values of `vc-cvs-diff-switches',
1616`vc-diff-switches', and `diff-switches'. Now the first non-nil value
1617from that sequence is used. The special value `t' means "no switches".
1618
1619*** Clicking on the VC mode-line entry now pops the VC menu.
1620
1621*** The VC mode-line entry now has a tooltip that explains the VC file status.
1622
1623*** In VC Annotate mode, the key bindings have changed to use lower
1624case keys instead of the upper case keys used in the past.
1625
1626*** In VC Annotate mode, for VC systems that support changesets, you can
1627see the diff for the whole changeset (not only for the current file)
1628by typing the D key. Using the "Show changeset diff of revision at
1629line" menu entry does the same thing.
1630
1631*** In VC Annotate mode, you can type v to toggle the annotation visibility.
1632
1633*** In VC Annotate mode, you can type f to show the file revision on
1634the current line.
1635
1636*** Asynchronous VC commands display [Waiting...] in the mode-line
1637of the corresponding buffer as long as the asynchronous process is
1638active.
1639
1640*** Log entries can be modified using the key "e" in log-view.
1641For now only CVS, RCS, SCCS and SVN support this functionality.
1642This is done by the `modify-change-comment' backend function.
1643
1644*** In log-view-mode, for VC systems that support changesets, you can
1645see the diff for the whole changeset (not only for the current file)
1646by typing the D key or using the "Changeset Diff" menu entry.
1647
1648*** In Log Edit mode, C-c C-d now shows the diff for the files involved.
1649
1650*** vc-git supports the "git grep" command.
1651
1652*** VC Support for Meta-CVS has been removed for lack of a maintainer able
1653to update it to the new VC.
1654
1655** Miscellaneous
1656
1657*** comint-mode uses `start-file-process' now (see Lisp Changes).
1658If `default-directory' is a remote file name, subprocesses are started
1659on the corresponding remote system.
1660
1661*** Eldoc highlights the function argument under point
1662with the face `eldoc-highlight-function-argument'.
1663
1664*** In Etags, the --members option is now the default.
1665Use --no-members if you want the old default behavior of not tagging
1666struct members in C, members variables in C++ and variables in PHP.
1667
1668*** The `gdb' command only works with the graphical interface now.
1669Use `gud-gdb' if you want the (old) text command mode.
1670
1671*** goto-address.el provides two new minor modes, goto-address-mode and
1672goto-address-prog-mode, which buttonize URLS and email addresses.
1673
1674*** The new command `eshell/info' runs info in an eshell buffer.
1675
1676*** The new variable `ffap-rfc-directories' specifies a list of local
1677directories in which `ffap-rfc' will first search for RFCs.
1678
1679*** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
1680See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
1681
1682*** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
1683
1684*** Info displays breadcrumbs in the header of the page.
1685See Info-breadcrumbs-depth to control it.
1686
1687*** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
1688It is used to configure wireless interfaces.
1689
1690*** The pcmpl-unix package supports hostname completion for ssh and scp.
1691
1692*** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
1693
1694*** smerge-refine highlights word-level details of changes in conflict.
1695It's used automatically as you move through conflicts, see
1696smerge-auto-refine-mode.
1697
1698*** talk.el has been extended for multiple tty support.
1699
1700*** A new command `display-time-world' has been added to the Time
1701package. It creates a buffer with an updating time display using
1702several time zones.
1703
1704*** The appearance of superscript and subscript in TeX is more customizable.
1705See the documentation of the variables: tex-fontify-script,
1706tex-font-script-display, tex-suscript-height-ratio, and
1707tex-suscript-height-minimum.
1708
1709*** view-remove-frame-by-deleting is now by default t
1710since users found iconification of view-mode frames distracting.
1711
1712*** WoMan tries to add locale-specific manual page directories to the
1713search path. This can be disabled by setting `woman-locale' to nil.
1714
1715\f
1716* Changes in Emacs 23.1 on non-free operating systems
1717
1718** Case is now considered significant in completion on MS-Windows.
1719The default value of `completion-ignore-case' is now nil on
1720MS-Windows, the same as it is for other operating systems. The
1721variable doesn't apply to reading a file name -- in that case Emacs
1722heeds `read-file-name-completion-ignore-case' instead.
1723
1724** IPv6 is supported on MS-Windows.
1725Emacs now supports IPv6 on Windows XP and later, and earlier versions
1726of Windows with third party IPv6 stacks installed. In Emacs 22, IPv6 was
1727supported on other platforms, but not on Windows due to using the winsock
17281.1 header file, even though Emacs was linking to the winsock 2 library.
1729
1730** Busy cursor (hourglass) now displays on MS-Windows.
1731When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
1732In Emacs 22 only X supported the busy cursor.
1733
1734** Battery status is available on MS-Windows
1735Emacs can now display the battery status in the mode-line when enabled with
1736display-battery-mode or from the Options menu. More verbose battery
1737information is also available with the command `battery'. In Emacs 22
1738battery status was supported only on GNU/Linux and Mac.
1739
1740** More keys available on MS-Windows.
1741Keys normally associated with IMEs, and some exotic keys not normally found
1742on standard keyboards have been given names so they can be bound to functions
1743inside Emacs. If there are keys on your keyboard that have not been exposed
1744to Emacs in the past, try C-h k to see if they are available now.
1745
1746Emacs can now bind functions to the extra buttons for media player and
1747browser control present on some keyboards. These buttons are disabled
1748by default, since enabling them prevents their system-wide use when
1749Emacs has focus. To enable them, set the variable
1750w32-pass-multimedia-buttons to nil. See the doc string of that variable
1751for the list of extra keys that are available.
1752
1753** BDF fonts no longer supported on MS-Windows.
1754The font backend was completely rewritten for this release. The focus
1755on Windows has been getting acceptable performance and full unicode
1756support, including complex script shaping for native Windows fonts. A
1757rewrite of the BDF font support has not happened due to lack of time
1758and developers. If demand still exists for such a backend even with
1759the improved language support for native Windows fonts, future
1760development in this direction will most likely be based on the
1761freetype library, giving access to a wider range of font formats.
1762
1763\f
1764* Incompatible Lisp Changes in Emacs 23.1
1765
1766** Variables cannot be both buffer-local and frame-local any more.
1767
1768** `functionp' returns nil for special forms.
1769I.e., it only returns t for objects that can be passed to `funcall'.
1770
1771** The behavior of map-char-table has changed. It may call the
1772specified function with a cons (FROM . TO) as a key if characters in
1773that range have the same value.
1774
1775** Process changes
1776
1777*** The function `dired-call-process' has been removed.
1778
1779*** The multibyteness of process filters is now determined by the
1780coding-system used for decoding. The functions
1781`process-filter-multibyte-p' and `set-process-filter-multibyte' are
1782obsolete.
1783
1784** The variable `byte-compile-warnings' can now be a list starting with `not',
1785meaning to disable the specified warnings. The meaning of this list
1786may therefore be the reverse of what you expect (of course, this is
1787only an issue if you make use of the new `not' syntax). Rather than
1788checking/manipulating elements directly, use the new functions
1789`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
1790`byte-compile-enable-warning.'
1791
1792** `mode-name' is no longer guaranteed to be a string.
1793Use `(format-mode-line mode-name)' to ensure a string value.
1794
1795** The function x-font-family-list has been removed.
1796Use the new function font-family-list (see Lisp Changes, below).
1797
1798** Internationalization changes
1799
1800*** The value of the function `charset-id' is now always 0.
1801
1802*** The functions `register-char-codings' and `coding-system-spec'
1803have been removed.
1804
1805*** The cpXXX coding systems are now supported automatically.
1806The functions cp-...-codepage, which you had to use in Emacs 22 to
1807enable support for these coding systems, have been deleted.
1808
1809*** The following features have been removed. They were used for
1810displaying various scripts with specific fonts, and are no longer
1811needed now that OpenType font support is available:
1812
1813**** `devanagari' and `devan-util', and all associated devanagari-* and
1814dev-* functions and variables (formerly used for Devanagari script).
1815
1816**** `kannada' and `knd-util', and all associated kannada-* and knd-*
1817functions and variables (formerly used for Kannada script).
1818
1819**** `malayalam' and `mlm-util', and all associated malayalam-* and
1820mlm-* functions and variables (formerly used for Malayalam script).
1821
1822**** `tamil' and `tml-util, and all associated tamil-* and tml-*
1823functions and variables (formerly used for Tamil script).
1824
1825*** The meaning of NAME argument of `set-fontset-font' is changed.
1826Previously nil is accepted as the default fontset. Now, nil is for
1827the fontset of the selected frame and t is for the default fontset.
1828
1829*** The meaning of FONTSET argument of `print-fontset' is changed.
1830Now, nil is for the fontset of the selected frame and t is for the
1831default fontset.
1832
1833** If a function in write-region-annotate-functions returns with a
1834different buffer current, Emacs no longer kills that buffer
1835automatically. This behavior existed in previous versions of Emacs,
1836but was undocumented. To kill a buffer after write-region, give the
1837variable `write-region-post-annotation-function' a buffer-local value
1838of `kill-buffer'.
1839
1840** The variable temp-file-name-pattern has been removed.
1841This variable was only used by call-process-region, which now uses
1842temporary-file-directory instead.
1843
1844** The COUNT and SYSTEM-FLAG arguments to define-abbrev have been
1845removed. The function now takes extra arguments for specifying
1846arbitrary abbrev properties.
1847
1848** end-of-defun-function is now guaranteed to work only when called
1849from the start of a defun. It must now leave point exactly at the end
1850of defun, since `end-of-defun' now itself moves forward over
1851whitespace after calling it.
1852
1853\f
1854* Lisp Changes in Emacs 23.1
1855
1856** The new variable `generate-autoload-cookie' controls the magic comment
1857string used by `update-file-autoloads' to find autoloaded forms. The
1858variable `generated-autoload-file' similarly controls the name of the
1859file where `update-file-autoloads' writes the calls to `autoload'.
1860The default values are ";;;###autoload" and `loaddefs.el',
1861respectively.
1862
1863** New primitives `list-system-processes' and `process-attributes'
1864let Lisp programs access the processes that are running on the local
1865machine. See the doc strings of these functions for more details.
1866Not all platforms support accessing this information; on those that
1867don't, these primitives will return nil.
1868
1869** New variable `user-emacs-directory'.
1870Use this instead of "~/.emacs.d".
1871
1872** If a local hook function has a non-nil `permanent-local-hook'
1873property, `kill-all-local-variables' does not remove it from the local
1874value of the hook variable; it remains even if you change major modes.
1875
1876** `frame-inherited-parameters' lets new frames inherit parameters from
1877the selected frame.
1878
1879** New keymap `input-decode-map' overrides like key-translation-map, but
1880applies before function-key-map. Also it is terminal-local contrary to
1881key-translation-map. Terminal-specific key-sequences are generally added to
1882this map rather than to function-key-map now.
1883
1884** `ignore-errors' is now a standard macro (does not require the CL package).
1885
1886** `interprogram-paste-function' can now return one string or a list
1887of strings. In the latter case, Emacs puts the second and following
1888strings on the kill ring.
1889
1890** In `condition-case', a handler can specify "let the debugger run first".
1891You do this by writing `debug' in the list of conditions to be handled,
1892like this:
1893
1894 (condition-case nil
1895 (foo bar)
1896 ((debug error) nil))
1897
1898** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
1899
1900** `beginning-of-defun-function' now takes one argument, the count given to
1901`beginning-of-defun'. (N.B. `end-of-defun-function' doesn't take any
1902arguments.)
1903
1904** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
1905IDENTIFICATION specifies which part of the remote identifier has to be
1906returned. With CONNECTED passed non-nil, it is checked whether a
1907remote connection has been established already.
1908
1909** The new macro `declare-function' suppresses compiler warnings about
1910undefined functions.
1911
1912** Changes to interactive function handling
1913
1914*** The new interactive spec code ^ says to first call
1915handle-shift-selection if shift-select-mode is non-nil, before reading
1916the command arguments. This is used for shift-selection (see above).
1917
1918*** Built-in functions can now have an interactive specification that
1919is not a prompt string. If the `intspec' parameter of a `DEFUN'
1920starts with a `(', the string is evaluated as a Lisp form.
1921
1922*** The interactive-form of a function can be added post-facto via the
1923`interactive-form' symbol property. Mostly useful to add complex
1924interactive forms to subroutines.
1925
1926** Region changes
1927
1928*** Commands should use `use-region-p' to test whether there is
1929an active region that they should operate on.
1930
1931*** `region-active-p' returns non-nil when Transient Mark mode is
1932enabled and the mark is active. Most commands that act specially on
1933the active region in Transient Mark mode should use `use-region-p'
1934instead of `region-active-p', because `use-region-p' obeys the new
1935user option `use-empty-active-region' (see Editing Changes, above).
1936
1937*** If a command sets `transient-mark-mode' to (only . OLDVAL), that
1938means to activate transient-mark-mode temporarily, until the next
1939unshifted point motion command or mark deactivation. Afterwards,
1940reset transient-mark-mode to the value OLDVAL. The values `only' and
1941`identity', introduced in Emacs 22, are now deprecated.
1942
1943** Emacs session information
1944
1945*** The new variables `before-init-time' and `after-init-time' record the
1946value of `current-time' before and after Emacs loads the init files.
1947
1948*** The new function `emacs-uptime' returns the uptime of an Emacs instance.
1949
1950*** The new function `emacs-init-time' returns the duration of the
1951Emacs initialization.
1952
1953** Changes affecting display-buffer
1954
1955*** display-buffer tries to be smarter when splitting windows.
1956The new option split-window-preferred-function lets you specify your own
1957function to pop up new windows. Its default value split-window-sensibly
1958can split a window either vertically or horizontally, whichever seems
1959more suitable in the current configuration. You can tune the behavior
1960of split-window-sensibly by customizing split-height-threshold and the
1961new option split-width-threshold. Both options now take the value nil
1962to inhibit splitting in one direction. Setting split-width-threshold to
1963nil inhibits horizontal splitting and gets you the behavior of Emacs 22
1964in this respect. In any case, display-buffer may now split the largest
1965window vertically even when it is not as wide as the containing frame.
1966
1967*** If pop-up-frames has the value `graphic-only', display-buffer only
1968makes a separate frame on graphic displays.
1969
1970*** select-frame and set-frame-selected-window have a new optional
1971argument NORECORD. If non-nil, this will avoid messing with the order
1972of recently selected windows and the buffer list.
1973
1974** Window parameters can now be defined.
1975These are analogous to frame parameters, but are associated with
1976individual windows.
1977
1978*** The new functions window-parameters, window-parameter, and
1979set-window-parameter are used to query and set window parameters.
1980
1981** Minibuffer and completion changes
1982
1983*** A list of default values can be specified for the DEFAULT argument of
1984functions `read-from-minibuffer', `read-string', `read-command',
1985`read-variable', `read-buffer', `completing-read'. Elements of this list
1986are available for inserting into the minibuffer by typing `M-n'.
1987For empty input these functions return the first element of this list.
1988
1989*** New function `read-regexp' uses the regexp history and some useful
1990regexp defaults (string at point, last Isearch/replacement regexp/string)
1991via M-n when reading a regexp in the minibuffer.
1992
1993*** minibuffer-local-must-match-filename-map is now named
1994minibuffer-local-filename-must-match-map.
1995
1996*** The `require-match' argument to `completing-read' accepts the new
1997values `confirm-only' and `confirm-after-completion'.
1998
1999** Search and replacement changes
2000
2001*** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
2002
2003*** New function `match-substitute-replacement' returns the result of
2004`replace-match' without actually using it in the buffer.
2005
2006*** The new variable `replace-search-function' determines the function
2007to use for searching in query-replace and replace-string. The
2008function it specifies is called by `perform-replace' when its 4th
2009argument is nil.
2010
2011*** The new variable `replace-re-search-function' determines the
2012function to use for searching in `query-replace-regexp',
2013`replace-regexp', `query-replace-regexp-eval', and
2014`map-query-replace-regexp'. The function it specifies is called by
2015`perform-replace' when its 4th argument is non-nil.
2016
2017*** New keymap `search-map' bound to `M-s' provides global bindings
2018for search related commands.
2019
2020*** New keymap `multi-query-replace-map' contains additonal keys bound
2021to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
2022
2023*** The variable `inhibit-changing-match-data', if non-nil, prevents
2024the search and match primitives from changing the match data.
2025
2026*** New functions `word-search-forward-lax' and `word-search-backward-lax'.
2027These are like `word-search-forward and `word-search-backward', except
2028that the end of the search string need not match a word boundary,
2029unless it ends in whitespace.
2030
2031** File handling changes
2032
2033*** set-file-modes is now interactive and can take the mode value in
2034symbolic notation thanks to auxiliary functions.
2035
2036*** file-local-variables-alist stores an alist of file-local
2037variables defined in the current buffer.
2038
2039** Face-remapping
2040
2041*** Each face can be remapped to a different face definition using the
2042variable `face-remapping-alist'. This is an alist that maps faces to
2043replacement definitions (which can be face names, lists of face names,
2044or attribute/value plists. If this variable is buffer-local, the
2045remapping occurs only in that buffer.
2046
2047*** text-scale-mode remaps the default face to a larger or smaller
2048size in the current buffer. This feature is used by the Buffer Face
2049menu and the new `C-x C-+', `C-x C--', and `C-x C-0' commands (see
2050Editing Changes, above).
2051
2052*** New functions:
2053
2054**** `face-remap-add-relative' adds a face remapping entry to the
2055current buffer.
2056
2057**** ``face-remap-remove-relative' removes a face remapping entry from
2058the current buffer.
2059
2060**** `face-remap-reset-base' restores a face to its global definition.
2061
2062**** `face-remap-set-base' sets the base remapping of a face.
2063
2064** Process changes
2065
2066*** The new function `start-file-process' is similar to `start-process',
2067but obeys file handlers. The file handler is chosen based on
2068`default-directory'. The functions `start-file-process-shell-command'
2069and `process-file-shell-command' are also new; they call internally
2070`start-file-process' and `process-file', respectively.
2071
2072*** The new function `process-lines' executes an external program and
2073returns its output as a list of lines.
2074
2075** Character code, representation, and charset changes.
2076
2077*** In multibyte buffers and strings, characters are represented by
2078UTF-8 byte sequences. The character code space is now 0x0..0x3FFFFF
2079with no gap; code points 0x0..0x10FFFF are Unicode characters of the
2080same code points, while code points 0x3FFF80..0x3FFFFF are raw 8-bit
2081bytes.
2082
2083*** Generic characters no longer exist.
2084
2085*** The concept of a charset has changed. A single character may
2086belong to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
2087unicode, iso-8859-1, iso-8859-3, etc).
2088
2089**** The dimension of a charset is now 1, 2, 3, or 4, and the size of
2090each dimension is no longer limited to 94 or 96.
2091
2092**** A dynamic charset priority list is used to infer the charset of
2093characters for display.
2094
2095*** The functions `split-char' and `make-char' now accept up to 4
2096positional codes instead of just 2.
2097
2098*** The functions `encode-char' and `decode-char' now accept any character sets.
2099
2100*** The function `define-charset' now accepts a completely different
2101form of arguments (old-style arguments still work).
2102
2103*** The value of the function `char-charset' depends on the current
2104priorities of charsets.
2105
2106*** The function get-char-code-property now accepts many Unicode base
2107character properties. They are `name', `general-category',
2108`canonical-combining-class', `bidi-class', `decomposition',
2109`decimal-digit-value', `digit-value', `numeric-value', `mirrored',
2110`old-name', `iso-10646-comment', `uppercase', `lowercase', and
2111`titlecase'.
2112
2113*** The functions `modify-syntax-entry' and `modify-category-entry' now
2114accept a cons of characters as the first argument, and modify all
2115entries in that range of characters.
2116
2117*** Use of `translation-table-for-input' for character code unification
2118is now obsolete, since Emacs 23.1 and later uses Unicode as basis for
2119internal representation of characters.
2120
2121*** New functions:
2122
2123**** `characterp' returns t if and only if the argument is a character.
2124This replaces `char-valid-p', which is now obsolete.
2125
2126**** `max-char' returns the maximum character code (currently #x3FFFFF).
2127
2128**** `define-charset-alias' defines an alias of a charset.
2129
2130**** `set-charset-priority' sets priorities of charsets.
2131
2132**** `charset-priority-list' returns a prioritized list of charsets.
2133
2134**** `unibyte-string' makes a unibyte string from bytes.
2135
2136**** `define-char-code-property' defines a character code property.
2137
2138**** `char-code-property-description' returns the description string of
2139a character code property.
2140
2141*** New variables:
2142
2143**** `find-word-boundary-function-table' is a char-table of functions to
2144search for a word boundary.
2145
2146**** `char-script-table' is a char-table of script names.
2147
2148**** `char-width-table' is a char-table of character widths.
2149
2150**** `print-charset-text-property' controls how to handle `charset' text
2151property on printing a string.
2152
2153**** `printable-chars' is a char-table of printable characters.
2154
2155** Code conversion changes
2156
2157*** The new function `define-coding-system' should be used to define a
2158coding system instead of `make-coding-system' (which is now obsolete).
2159
2160*** The functions `encode-coding-region' and `decode-coding-region'
2161have an optional 4th argument to specify where the result of
2162conversion should go.
2163
2164*** The functions `encode-coding-string' and `decode-coding-string'
2165have an optional 4th argument specifying a buffer to store the result
2166of conversion.
2167
2168*** The new variable `inhibit-null-byte-detection' controls whether to
2169consider text with null bytes as binary data. By default, it is
2170`nil', and Emacs uses `no-conversion' for any text containing null
2171bytes.
2172
2173*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
2174
2175*** New functions:
2176
2177**** `with-coding-priority' executes Lisp code using the specified
2178coding system priority order.
2179
2180**** `check-coding-systems-region' checks if the text in the region is
2181encodable by the specified coding systems.
2182
2183**** `coding-system-aliases' returns a list of aliases of a coding system.
2184
2185**** `coding-system-charset-list' returns a list of charsets supported
2186by a coding system.
2187
2188**** `coding-system-priority-list' returns a list of coding systems
2189ordered by their priorities.
2190
2191**** `set-coding-system-priority' sets priorities of coding systems.
2192
2193**** `coding-system-from-name' returns a coding system matching with
2194the argument name.
2195
2196** There is a new input method, Robin, different from Quail.
2197It has three functionalities:
2198 i) a simple input method (converts an ASCII sequence into a string).
2199ii) converts an existing buffer substring into another string
2200iii) reverse conversion (each character produced by a
2201robin rule can hold the original ASCII sequence as a char-code-property)
2202
2203*** The new function `robin-define-package' defines a Robin package.
2204
2205*** The new function `robin-modify-package' modifies an existing Robin package.
2206
2207*** The new function `robin-use-package' starts using a Robin package
2208as an input method.
2209
2210*** The new function `string-to-unibyte' is like `string-as-unibyte'
2211but signals an error if STRING contains a non-ASCII, non-eight-bit
2212character.
2213
2214** Changes related to the new font backend
2215
2216*** Which font backends to use can be specified by the X resource
2217"FontBackend". For instance, to use both X core fonts and Xft fonts:
2218
2219Emacs.FontBackend: x,xft
2220
2221If this resource is not set, Emacs tries to use all font backends
2222available on your graphic device.
2223
2224*** New frame parameter `font-backend' specifies a list of
2225font-backends supported by the frame's graphic device. On X, they are
2226currently `x' and `xft'.
2227
2228*** The function `set-fontset-font' now accepts a script name as the
2229second argument, and has an optional 5th argument to control how to
2230set the font.
2231
2232*** New functions:
2233
2234**** `fontp' checks if the argument is a font-spec or font-entity.
2235
2236**** `font-spec' creates a new font-spec object.
2237
2238**** `font-get' returns a font property value.
2239
2240**** `font-put' sets a font property value.
2241
2242**** `font-face-attributes' returns a plist of face attributes set by a font.
2243
2244**** `list-fonts' returns a list of font-entities matching a font spec.
2245
2246**** `find-font' returns the font-entity best matching the given font spec.
2247
2248**** `font-family-list' returns a list of family names of available fonts.
2249
2250**** `font-xlfd-name' returns an XLFD name of a given font spec, font
2251entity, or font object.
2252
2253**** `clear-font-cache' clears all font caches.
2254
2255** Changes related to multiple-terminal (multi-tty) support
2256
2257*** $TERM is now set to `dumb' for subprocesses. If you want to know the
2258$TERM inherited by Emacs you will have to look inside initial-environment.
2259
2260*** $DISPLAY is now dynamically inherited from the frame's `display'.
2261
2262*** The `window-system' variable is now frame-local. The new
2263`initial-window-system' variable contains the `window-system' value
2264for the first frame. `window-system' is also now a function that
2265takes a frame argument.
2266
2267*** The `keyboard-translate-table' variable and the terminal and
2268keyboard coding systems are now terminal-local.
2269
2270*** You can specify a terminal device (`tty' parameter) and a terminal
2271type (`tty-type' parameter) to `make-terminal-frame'.
2272
2273*** The function `make-frame-on-display' now works during a tty
2274session.
2275
2276*** A new `terminal' data type.
2277The functions `get-device-terminal', `terminal-parameters',
2278`terminal-parameter', `set-terminal-parameter' use this data type.
2279
2280*** Function key sequences are now mapped using `local-function-key-map',
2281a new variable. This inherits from the global variable function-key-map,
2282which is not used directly any more.
2283
2284*** New hooks:
2285
2286**** before-hack-local-variables-hook is called after setting new
2287variable file-local-variables-alist, and before actually applying the
2288file-local variables.
2289
2290**** `suspend-tty-functions' and `resume-tty-functions' are called
2291after a tty frame has been suspended or resumed, respectively. The
2292functions are called with the terminal id of the frame being
2293suspended/resumed as a parameter.
2294
2295**** The special hook `delete-terminal-functions' is called before
2296deleting a terminal.
2297
2298*** New functions:
2299
2300**** `delete-terminal'
2301
2302**** `suspend-tty'
2303
2304**** `resume-tty'.
2305
2306*** `initial-environment' holds the environment inherited from Emacs's parent.
2307
2308** Redisplay changes
2309
2310*** For underlined characters, the distance between the underline and
2311the baseline is controlled by a new variable, `underline-minimum-offset'.
2312
2313*** You can now pass the value of the `invisible' property to
2314invisible-p to check whether it would cause the text to be invisible.
2315This is convenient when checking invisibility of text with no buffer
2316position (e.g. in before/after-strings).
2317
2318*** `clear-image-cache' can be told to flush only images of a specific file.
2319
2320*** `vertical-motion' can now be given a goal column.
2321It now accepts a cons cell (COLS . LINES) in its first argument, which
2322says to stop, where possible, at a pixel x-position equal to COLS
2323times the default column width.
2324
2325*** redisplay-end-trigger-functions, set-window-redisplay-end-trigger,
2326and window-redisplay-end-trigger are obsolete. Use `jit-lock-register'
2327instead.
2328
2329*** The new variables `wrap-prefix' and `line-prefix' specify display
2330specs which are appended at display-time to every continuation line
2331and non-continuation line, respectively. In addition, Emacs
2332recognizes the `wrap-prefix' and `line-prefix' text or overlay
2333properties; these have the same effects as the variables of the same
2334name, but take precedence.
2335
2336** The Lisp interpreter now treats non-breaking space as whitespace.
2337
2338** Miscellaneous new functions
2339
2340*** `apply-partially' performs a "curried" application of a function.
2341
2342*** `buffer-swap-text' swaps text between two buffers. This can be
2343useful for modes such as tar-mode, archive-mode, RMAIL.
2344
2345*** `combine-and-quote-strings' produces a single string from a list of strings
2346sticking a separator string in between each pair, and quoting those
2347strings that include the separator as their substring. Useful for
2348consing shell command lines from the individual arguments.
2349
2350*** `custom-note-var-changed' tells Custom to treat the change in a
2351certain variable as having been made within Custom.
2352
2353*** `face-all-attributes' returns an alist describing all the basic
2354attributes of a given face.
2355
2356*** `format-seconds' converts a number of seconds into a readable
2357string of days, hours, etc.
2358
2359*** `image-refresh' refreshes all images associated with a given image
2360specification.
2361
2362*** `locate-user-emacs-file' helps packages to select the appropriate
2363place to save user-specific files. It defaults to `user-emacs-directory'
2364unless the file already exists at $HOME.
2365
2366*** `read-color' reads a color name using the minibuffer.
2367
2368*** `read-shell-command' does what its name says, with completion. It
2369uses the minibuffer-local-shell-command-map for that.
2370
2371*** `split-string-and-unquote' splits a string into a list of substrings
2372on the boundaries of a given delimiter, and unquotes the substrings that
2373are quoted. Useful for taking apart shell commands.
2374
2375*** The two new functions `looking-at-p' and `string-match-p' can do
2376the same matching as `looking-at' and `string-match' without changing
2377the match data.
2378
2379*** The two new functions `make-serial-process' and
2380`serial-process-configure' provide a Lisp interface to the new serial
2381port support (see Emacs changes, above).
2382
2383** Miscellaneous new variables
2384
2385*** `auto-save-include-big-deletions', if non-nil, means auto-save is
2386not turned off automatically after a big deletion.
2387
2388*** `read-circle', if nil, disables the reading of recursive Lisp
2389structures using the #N= and #N# syntax.
2390
2391*** `this-command-keys-shift-translated' is non-nil if the key
2392sequence invoking the current command was found by shift-translation.
2393
2394*** `window-point-insertion-type' determines the insertion-type of the
2395marker used for window-point.
2396
2397*** bookmark provides `bookmark-make-record-function' so special major
2398modes like Info can teach bookmark.el how to save and restore the
2399relevant data.
2400
2401*** `fill-forward-paragraph-function' specifies which function the
2402filling code should use to find paragraph boundaries.
2403
2404\f
2405* New Packages for Lisp Programming in Emacs 23.1
2406
2407** The new package avl-tree.el deals with the AVL tree data structure.
2408
2409** The new package check-declare.el verifies the accuracy of
2410declare-function macros (see Lisp Changes, above).
2411
2412** find-cmd.el can build `find' commands using lisp syntax.
2413
2414** The package misearch.el has been added. It allows Isearch to search
2415through multiple buffers. A variable `multi-isearch-next-buffer-function'
2416defines the function to call to get the next buffer to search in the series
2417of multiple buffers. Top-level functions `multi-isearch-buffers',
2418`multi-isearch-buffers-regexp', `multi-isearch-files' and
2419`multi-isearch-files-regexp' accept a single argument that specifies
2420a list of buffers/files to search for a string/regexp.
2421
2422** The new major mode `special-mode' is intended as a parent for
2423major modes such as those that set the "'mode-class 'special" property.
2424
2425\f
2426----------------------------------------------------------------------
2427This file is part of GNU Emacs.
2428
2429GNU Emacs is free software: you can redistribute it and/or modify
2430it under the terms of the GNU General Public License as published by
2431the Free Software Foundation, either version 3 of the License, or
2432(at your option) any later version.
2433
2434GNU Emacs is distributed in the hope that it will be useful,
2435but WITHOUT ANY WARRANTY; without even the implied warranty of
2436MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2437GNU General Public License for more details.
2438
2439You should have received a copy of the GNU General Public License
2440along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
2441
2442\f
2443Local variables:
2444mode: outline
2445paragraph-separate: "[ \f]*$"
2446end:
2447
2448arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2