Commit | Line | Data |
---|---|---|
eb199145 GM |
1 | GNU Emacs NEWS -- history of user-visible changes. |
2 | ||
3 | Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. | |
4 | See the end of the file for license conditions. | |
5 | ||
6 | Please send Emacs bug reports to bug-gnu-emacs@gnu.org. | |
7 | If possible, use M-x report-emacs-bug. | |
8 | ||
9 | This file is about changes in Emacs version 23. | |
10 | ||
11 | See files NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18, and NEWS.1-17 | |
12 | for changes in older Emacs versions. | |
13 | ||
14 | You can narrow news to a specific version by calling `view-emacs-news' | |
15 | with 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 |
25 | alt/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. | |
35 | This 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. |
45 | It takes a simple BNF description of the grammar, and provides both | |
46 | sexp-style navigation (jumping over begin..end pairs) as well as | |
47 | indentation, 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 |
52 | If the frame has a header line, posn-col-row will count row numbers | |
53 | starting 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 | 72 | These are not new features; only the configure flags are new. |
0235128c | 73 | |
eb199145 GM |
74 | *** --enable-profiling builds Emacs with profiling enabled. |
75 | This 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 |
80 | world-readable install. | |
81 | ||
82 | ** Emacs compiles with Gconf support, if it is detected. | |
83 | Use the configure option --without-gconf to disable this. | |
6e104790 | 84 | This 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. |
89 | However, if Emacs is compiled with the Lucid or Motif toolkit, X | |
90 | resource settings for the graphical widgets are still applied. | |
91 | On Windows, the -Q option causes Emacs to ignore Registry settings, | |
92 | but environment variables set on the Registry are still honored. | |
0235128c | 93 | |
eb199145 GM |
94 | *** The new variable `inhibit-x-resources' shows whether X resources |
95 | were 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. |
102 | On typical 32bit systems, buffers can now be up to 512MB. | |
103 | ||
eb199145 GM |
104 | ** The default value of `trash-directory' is now nil. |
105 | This means that `move-file-to-trash' trashes files according to | |
106 | freedesktop.org specifications, the same method used by the Gnome, | |
107 | KDE, and XFCE desktops. (This change has no effect on Windows, which | |
108 | uses `system-move-file-to-trash' for trashing.) | |
109 | ||
eb199145 GM |
110 | ** The pointer now becomes invisible when typing. |
111 | Customize `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. |
116 | To enable this feature, set `font-use-system-font' to non-nil (it is | |
117 | nil by default). If the system default changes, Emacs changes also. | |
118 | This feature requires Gconf support, which is automatically included | |
119 | at compile-time if configure detects the gconf libraries (you can | |
120 | disable this with the configure option --without-gconf). | |
0235128c | 121 | |
eb199145 GM |
122 | *** On X11, Emacs reacts to Xft changes made by configuration tools, |
123 | via the XSETTINGS mechanism. This includes antialias, hinting, | |
124 | hintstyle, RGBA, DPI and lcdfilter changes. | |
125 | ||
eb199145 GM |
126 | ** Killing a buffer with a running process now asks for confirmation. |
127 | To remove this query, remove `process-kill-buffer-query-function' from | |
128 | `kill-buffer-query-functions', or set the appropriate process flag | |
129 | with `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, |
134 | unconditionally. The previous behavior, toggling the mode, was | |
135 | neither 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 |
143 | and 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. |
152 | This refers to the EMACS_UNIBYTE environment variable as well as the | |
153 | --unibyte, --multibyte, --no-multibyte, and --no-unibyte command line | |
154 | arguments. Customizing enable-multibyte-characters and setting | |
155 | default-enable-multibyte-characters are also deprecated. | |
0235128c | 156 | |
eb199145 GM |
157 | *** New coding system `utf-8-hfs'. |
158 | This is suitable for default-file-name-coding-system on Mac OS X; see | |
159 | international/ucs-normalize.el. | |
160 | ||
eb199145 GM |
161 | ** Function arguments in *Help* buffers are now shown in upper-case. |
162 | Customize `help-downcase-arguments' to t to show them in lower-case. | |
163 | ||
0235128c SM |
164 | ** New command `async-shell-command', bound globally to `M-&'. |
165 | This executes the command asynchronously, similar to calling `M-!' and | |
166 | manually adding an ampersand to the end of the command. With `M-&', | |
167 | you 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 | |
171 | asks xterm what the background color is and it sets up faces | |
172 | accordingly for a dark background if needed (the current default is to | |
173 | consider 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 |
181 | becomes the primary selection (for interaction with other window | |
182 | applications). 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 |
186 | commands save the interprogram-paste selection into the kill ring | |
187 | before doing anything else. This avoids losing the selection. | |
0235128c | 188 | |
eb199145 GM |
189 | *** When `kill-do-not-save-duplicates' is non-nil, identical |
190 | subsequent 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. |
199 | For instance, this can complete M-x lch to list-command-history. | |
0235128c | 200 | |
eb199145 GM |
201 | *** The new variable `completions-format' determines how completions |
202 | are 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 |
208 | that read file names. These include the file name at point (when ffap | |
209 | is 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, | |
212 | rename, or diff). | |
213 | ||
eb199145 GM |
214 | ** M-r is bound to the new `move-to-window-line-top-bottom'. |
215 | This moves point to the window center, top and bottom on successive | |
216 | invocations, in the same spirit as the C-l (recenter-top-bottom) | |
217 | command. | |
218 | ||
eb199145 GM |
219 | ** The new variable `recenter-positions' determines the default |
220 | cycling order of C-l (`recenter-top-bottom'). | |
221 | ||
eb199145 GM |
222 | ** The abbrevs file is now a file named abbrev_defs in |
223 | user-emacs-directory; but the old location, ~/.abbrev_defs, is used if | |
224 | that 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 |
234 | user-emacs-directory; but the old location, ~/.calc.el, is used if | |
235 | that file exists. | |
0235128c | 236 | |
eb199145 GM |
237 | *** Graphing commands (`g f' etc.) now work on MS-Windows, if you have |
238 | the 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. |
243 | If 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 |
248 | giving an offset from today. | |
249 | ||
250 | ** Desktop | |
0235128c | 251 | |
eb199145 GM |
252 | *** The default value for `desktop-buffers-not-to-save' is nil. |
253 | This means Desktop will try restoring all buffers, when you restart | |
254 | your Emacs session. Also, `desktop-buffers-not-to-save' is only | |
255 | effective for buffers that have no associated file. If you want to | |
256 | exempt 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 |
262 | Dired 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 |
267 | on 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, | |
274 | and can be run in batch mode. | |
275 | ||
276 | *** Elint does a more thorough initialization, and recognizes more built-in | |
277 | functions and variables. Customize `elint-scan-preloaded' if you want | |
278 | to 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 | 287 | collections 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 | |
296 | matched topics found in the index. | |
297 | ||
298 | *** The new command `info-finder' replaces finder.el with a virtual Info | |
299 | manual that generates an Info file which gives the same information | |
300 | through 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 | ||
306 | The default for `mail-user-agent' is now message-user-agent, so the | |
307 | C-x m (`compose-mail') command uses Message mode instead of Mail mode. | |
308 | ||
309 | Message mode has been included in Emacs, as part of the Gnus package, | |
310 | for several years. It provides several features that are absent in | |
311 | Mail mode, such as MIME handling. | |
312 | ||
313 | *** If the user has not customized mail-user-agent, `compose-mail' | |
314 | checks for Mail mode customizations, and issues a warning if these | |
315 | customizations are found. This alerts users who may otherwise be | |
316 | unaware that their mail configuration has changed. | |
317 | ||
318 | To 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, | |
322 | Emacs will wait for the process sending mail to return. If you | |
323 | experience 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 |
328 | is 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'. |
335 | This 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 |
338 | To 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". |
343 | On systems which support GVFS-Fuse, Tramp offers also the new | |
344 | connection 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 |
349 | directory not controlled by any VCS, ask the user what VC backend to | |
350 | use to create a repository, create a new repository and register the | |
351 | file. | |
0235128c | 352 | |
85738751 SM |
353 | *** New command `vc-root-print-log', bound to `C-x v L'. |
354 | This displays a `*vc-change-log*' buffer showing the history of the | |
355 | version-controlled directory tree as a whole. | |
0235128c | 356 | |
85738751 SM |
357 | *** New command `vc-root-diff', bound to `C-x v D'. |
358 | This is similar to `vc-diff', but compares the entire directory tree | |
359 | of 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. |
362 | The number of entries shown can be chosen interactively with a prefix | |
363 | argument, or by customizing vc-log-show-limit. The `*vc-change-log*' | |
364 | buffer now contains buttons at the end of the buffer, which can be | |
365 | used to increase the number of entries shown. RCS, SCCS, and CVS do | |
366 | not support this feature. | |
0235128c | 367 | |
eb199145 GM |
368 | *** vc-annotate supports annotations through file copies and renames, |
369 | it displays the old names for the files and it can show logs/diffs for | |
370 | the corresponding lines. Currently only Git and Mercurial take | |
371 | advantage of this feature. | |
0235128c | 372 | |
eb199145 GM |
373 | *** The log command in vc-annotate can display a single log entry |
374 | instead of redisplaying the full log. The RCS, CVS and SCCS VC | |
375 | backends 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, |
384 | so 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 |
387 | git version 1.5.5. | |
eb199145 | 388 | |
6e104790 SM |
389 | **** Support for operating with stashes has been added to vc-dir: |
390 | the stash list is displayed in the *vc-dir* header, stashes can be | |
391 | created, removed, applied and their content displayed. | |
eb199145 GM |
392 | |
393 | *** vc-bzr supports operating with shelves: the shelve list is | |
394 | displayed 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 |
397 | are 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' |
402 | read buffer names to search, one by one, ended with RET. With a prefix | |
403 | argument, they ask for a regexp, and search in buffers whose names match | |
404 | the specified regexp. Interactively `multi-isearch-files' and | |
405 | `multi-isearch-files-regexp' read file names to search, one by one, | |
406 | ended with RET. With a prefix argument, they ask for a wildcard, and | |
407 | search 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. | |
412 | Thus, they change `default-directory' to reflect the new user id, and | |
413 | let commands run under that user's permissions. This works even when | |
eb199145 | 414 | `default-directory' is already remote. Calling the external commands |
0235128c SM |
415 | is 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. | |
427 | This 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 | |
431 | edit and navigate source code. Parsers for C/C++, Java, Javascript, | |
432 | and several other languages are included by default, and Semantic can | |
433 | also interface with external tools such as GNU Global and GNU Idutils. | |
434 | ||
435 | To enable Semantic, use the global minor mode `semantic-mode'. | |
436 | See the Semantic manual for details. | |
437 | ||
438 | *** EDE (Emacs Development Environment) is a package for managing code | |
439 | projects, including features such as automatic Makefile generation. | |
440 | ||
441 | To enable EDE, use the minor mode `global-ede-mode'. | |
442 | See the EDE manual for details. | |
443 | ||
444 | *** SRecode is a library for recoding Semantic tags back into source | |
445 | code. It is currently used by some parts of Semantic and EDE; in the | |
446 | future, it may be used for code generation features. | |
447 | ||
448 | *** The EIEIO library implements a subset of the Common Lisp Object | |
449 | System (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. |
463 | For instance, on machines where `536870911' is the largest integer, | |
464 | reading `536870912' gives the floating-point object `536870912.0'. | |
465 | ||
466 | This change only concerns the Lisp reader; it does not affect how | |
467 | actual integer objects overflow. | |
468 | ||
eb199145 GM |
469 | ** Several obsolete functions removed. |
470 | The functions have been obsolete since Emacs 19, and are unlikely to | |
471 | be 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 |
479 | the variable `byte-compile-compatibility') has been removed. | |
480 | ||
6e104790 SM |
481 | ** In image-mode.el `image-mode-maybe' is obsolete. |
482 | Instead, you can either use `image-mode' (which displays an image file | |
483 | as the actual image initially), or `image-mode-as-text' (when you want | |
484 | to display an image file as text initially). `image-mode-as-text' is a | |
485 | combination of a non-image mode from `auto-mode-alist' (or Fundamental | |
486 | mode) and `image-minor-mode'. `image-minor-mode' provides a `C-c C-c' | |
487 | key 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 |
496 | variable, are now declared obsolete. | |
eb199145 | 497 | |
e867cb5d SM |
498 | ** read-key is a function halfway between read-event and read-key-sequence. |
499 | It 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'. |
504 | This maximizes the frame. | |
0235128c | 505 | |
eb199145 GM |
506 | *** The new frame parameter `sticky' makes Emacs frames sticky in |
507 | virtual desktops. | |
508 | ||
e867cb5d SM |
509 | ** Completion changes |
510 | ||
511 | *** completion-base-size is obsoleted by completion-base-position. | |
eb199145 GM |
512 | This change causes a few backward incompatibilities, mostly with |
513 | choose-completion-string-functions where the `mini-p' argument has | |
514 | been replaced by a `base-position' argument, and where the `base-size' | |
515 | argument is now always nil. | |
516 | ||
e867cb5d SM |
517 | *** New function `completion-in-region' to use the standard completion |
518 | facilities 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 | |
523 | for 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 |
528 | to read-file-name-internal because read-file-name-internal abused its `pred' | |
529 | argument to pass the current directory, but this hack is not needed | |
530 | any 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 |
539 | which is now marked obsolete. | |
e867cb5d | 540 | |
eb199145 GM |
541 | ** New function set-advertised-calling-convention makes it possible |
542 | to obsolete arguments as well as make some arguments mandatory. | |
eb199145 GM |
543 | |
544 | ** You can control which binding is preferentially shown in menus and | |
545 | docstrings by adding a `:advertised-binding' property to the corresponding | |
546 | command's symbol. That property can hold a single binding or a list | |
547 | of bindings. | |
548 | ||
e867cb5d | 549 | ** Network and process changes |
0235128c | 550 | |
e867cb5d SM |
551 | *** start-process-shell-command and start-file-process-shell-command |
552 | now only take a single `command' argument. | |
0235128c | 553 | |
e867cb5d SM |
554 | *** The new variable `process-file-side-effects' should be set to nil |
555 | if a `process-file' call does not change a remote file. This allows | |
556 | file 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 |
569 | the function `byte-compile-dest-file' before loading bytecomp.el is obsolete. | |
570 | Instead, 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 |
575 | affecting the buffer's modification state. | |
eb199145 | 576 | |
eb199145 GM |
577 | ** Hash tables have a new printed representation that is readable. |
578 | The feature `hashtable-print-readable' identifies this new | |
579 | functionality. | |
580 | ||
e867cb5d | 581 | ** New functions for performing Unicode normalization: |
eb199145 GM |
582 | ucs-normalize-NFD-region, ucs-normalize-NFD-string, |
583 | ucs-normalize-NFC-region, ucs-normalize-NFC-string, | |
584 | ucs-normalize-NFKD-region, ucs-normalize-NFKD-string, | |
585 | ucs-normalize-NFKC-region, ucs-normalize-NFKC-string, | |
586 | ucs-normalize-HFS-NFD-region, ucs-normalize-HFS-NFD-string, | |
587 | ucs-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 |
598 | as 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. | |
604 | The configure option `--with-gtk' has been removed. Gtk is now the | |
605 | default toolkit, but you can use --with-x-toolkit=gtk if necessary. | |
606 | ||
607 | ** New font code. | |
608 | Fonts are handled by new code capable of dealing with multiple font | |
609 | backends. 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 | |
615 | where 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 | |
620 | OpenType 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 | |
627 | a 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. | |
634 | This provides support for GNUstep (via the GNUstep libraries) and Mac | |
635 | OS X (via the Cocoa libraries). | |
636 | ||
637 | Specify --with-ns to configure for this. By default, a self-contained | |
638 | app will be built (containing all lisp). To install/share lisp with | |
639 | other emacsen (e.g. X11 build) use --disable-ns-self-contained. See | |
640 | nextstep/README and nextstep/INSTALL in the Emacs source directory. | |
641 | ||
642 | ** Mac OS X is no longer supported via Carbon. | |
643 | Use the NeXTSTEP port, described above. | |
644 | ||
645 | ** The new configuration option "--with-dbus" enables D-Bus language | |
646 | bindings for Emacs. | |
647 | ||
648 | ** Support for many obsolete platforms has been removed. | |
649 | See 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: | |
658 | If you are still using Emacs on one of these platforms, please email | |
659 | emacs-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 | |
664 | executable 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 | |
675 | NO_SHARED_LIBS compilation flag). | |
676 | ||
677 | ** The configure options `--with-gcc', `--without-gcc' have been removed. | |
678 | Configure will use gcc by default. Set the CC environment variable if | |
679 | you 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, | |
684 | or any later version. | |
685 | ||
686 | ** Emacs 23 comes with a new set of default icons. | |
687 | Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png. | |
688 | The 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. | |
695 | With an Emacs server active (M-x server-start), `emacsclient -t' | |
696 | creates a tty frame connected to the running emacs server. You can | |
697 | use any number of different ttys. `emacsclient -c' creates a new X11 | |
698 | frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set). | |
699 | There may be problems if a display exits unexpectedly and Emacs is compiled | |
700 | with Gtk+, see etc/PROBLEMS. | |
701 | ||
702 | You can test for the presence of this feature in your Lisp code by | |
703 | testing 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 | |
707 | starts the server. Clients can connect and create graphical or | |
708 | terminal 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 | |
712 | ALTERNATE_EDITOR is set to "") and emacsclient cannot connect to an | |
713 | emacs server. | |
714 | ||
715 | *** The new command close-display-connection closes a connection to a | |
716 | remote display. There are some bugs for Gtk+. See etc/PROBLEMS. | |
717 | ||
718 | *** Emacs now supports the XEmbed specification. | |
719 | You can embed Emacs in another application on X11. The new command line | |
720 | option --parent-id is used to pass the parent window id to Emacs. See | |
721 | http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html | |
722 | for details about XEmbed. | |
723 | ||
724 | *** Emacs can now set the frame opacity. | |
725 | The opacity of a frame can be controlled by setting the `alpha' frame | |
726 | parameter. This only takes effect on a compositing window manager for | |
727 | the X Window System, such as Compiz, Beryl and Compiz Fusion, on Mac | |
728 | OS X, or on Windows 2000 and later versions of Windows. | |
729 | ||
730 | The alpha parameter should be an integer between 0 (transparent) and | |
731 | 100 (opaque), or a float number between 0.0 and 1.0. It can also be a | |
732 | cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an | |
733 | active frame and INACTIVE is the opacity of non-active frames. | |
734 | ||
735 | The variable `frame-alpha-lower-limit' defines a lower bound for the | |
736 | opacity; 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 | ||
743 | The internal encoding used for buffers and strings is now | |
744 | Unicode-based and called `utf-8-emacs' (`emacs-internal' is an alias | |
745 | for this). This encoding is backward-compatible with Unicode's UTF-8 | |
746 | encoding. The internal encoding previously used by Emacs, | |
747 | `emacs-mule', is still available for reading and writing files. | |
748 | ||
749 | During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files. | |
750 | As a result, byte-compiled files containing non-ASCII characters can't | |
751 | be read by earlier versions of Emacs. Files compiled by Emacs 20, 21, | |
752 | or 22 are loaded correctly as `emacs-mule' (whether or not they | |
753 | contain multibyte characters). This takes somewhat more time, so it | |
754 | may be worth recompiling existing .elc files which don't need to be | |
755 | shared 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. | |
760 | See M-x list-character-sets. New charsets can be defined conveniently | |
761 | as tables of unicodes. | |
762 | ||
763 | *** There are new language environments for Chinese-GBK, | |
764 | Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu, | |
765 | Sinhala, and TaiViet. | |
766 | ||
767 | *** The minor modes unify-8859-on-encoding-mode and | |
768 | unify-8859-on-decoding-mode are obsolete. | |
769 | ||
770 | *** `ucs-insert' is bound to `C-x 8 RET' and in addition to hex numbers | |
771 | accepts numbers in hash notation (e.g. #o21430 for octal, or #10r8984 for | |
772 | decimal). It also accepts Unicode character names with completion. | |
773 | ||
774 | *** The `cyrillic-translit' input method supports many new characters. | |
775 | Common typographical characters available from Unicode were added to | |
776 | `cyrillic-translit': punctuation marks, accented characters, fractions, | |
777 | and others. | |
778 | ||
779 | ** Emacs now supports serial port access on GNU/Linux, Unix, and | |
780 | Windows. The new command `serial-term' starts an interactive terminal | |
781 | on a serial port. The serial port can be configured at runtime with | |
782 | the mode-line mouse menu. | |
783 | ||
784 | ** Menu Bar changes | |
785 | ||
786 | *** In the Options menu, the "Set Default Font" item applies the | |
787 | selected font to the `default' face on all frames, not just the | |
788 | current frame. Furthermore, if Emacs is compiled with both GTK and | |
789 | Fontconfig support, the "Set Default Font" item uses the GTK font | |
790 | selection 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. | |
796 | This contains commands provided by EasyPG, the newly-included | |
797 | interface to GnuPG (see New Modes and Packages). | |
798 | ||
799 | *** In the Options menu, the "Truncate Long Lines in the Buffer" entry | |
800 | has been replaced with a submenu offering three different ways to | |
801 | handle long lines: truncation, continuation at the window edge, and | |
802 | the new word wrapping behavior (see Editing Changes, below). | |
803 | ||
804 | *** Improvements to menus for major and minor modes | |
805 | More major and minor modes now have a mode specific menu, and existing | |
806 | mode menus have been improved to include more functionality. | |
807 | ||
808 | ** Mode-line changes | |
809 | ||
810 | *** The mode-line displays a `@', instead of `-', if the | |
811 | default-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 | |
814 | minor mode, in the same way as it already did for major modes. | |
815 | ||
816 | *** The `mode-line-emphasis' face is used to highlight certain | |
817 | mode-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 | |
822 | line 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. | |
825 | Set `delete-by-moving-to-trash' non-nil to use this. Deleted files | |
826 | and directories will then be sent to the Recycle Bin on Windows, and | |
827 | to `trash-directory' on other systems. | |
828 | ||
829 | ** Directory-local variables can now be defined. | |
830 | By default, Emacs looks in .dir-locals.el for directory-local | |
831 | variables. For more information, see `dir-locals-set-directory-class' | |
832 | and `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 | |
836 | login names and passwords. The match, if found, is reported | |
837 | in *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 | |
846 | display of the initial message in the *scratch* buffer. If you don't | |
847 | want to display the initial message in the *scratch* buffer at startup, | |
848 | you can set the option `initial-scratch-message' to nil. | |
849 | ||
850 | ** New user option `initial-buffer-choice' specifies what to display | |
851 | after starting Emacs: startup screen, *scratch* buffer, visiting a | |
852 | file or directory. | |
853 | ||
854 | ** New alias `argv' for `command-line-args-left' | |
855 | This is a convenience alias, so that one can write `(pop argv)' | |
856 | inside of --eval command line arguments in order to access | |
857 | following 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. | |
862 | It can save a session and restore it later. See the documentation of | |
863 | the functions `emacs-session-save' and `emacs-session-restore'. | |
864 | (Actually, this feature was introduced with Emacs 22, but it was not | |
865 | documented.) | |
866 | \f | |
867 | * Incompatible Editing Changes in Emacs 23.1 | |
868 | ||
869 | ** In Dired, `dired-flag-garbage-files' is rebound from `&' to `%&' | |
870 | on the regexp command prefix map. | |
871 | ||
872 | ** In Dired-x, all command guesses for ! are now added to the default | |
873 | list accessible by M-n instead of pushing all guesses temporarily into | |
874 | the history list. | |
875 | ||
876 | ** In Isearch mode, a special case of typing `C-w' at the beginning of | |
877 | the 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 | |
880 | toggle 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' | |
884 | for word search as well as other search commands from the global prefix | |
885 | key `M-s'. `Info-search' is still bound to `s', and also incremental | |
886 | search commands `C-s', `C-M-s', `C-r', `C-M-r' are available for searching | |
887 | through 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 | |
892 | prefix 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 | |
895 | not advertised: danish-alt-postfix, esperanto-alt-postfix, | |
896 | finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix, | |
897 | norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix, | |
898 | and swedish-alt-postfix. Use the versions without "alt-", which are | |
899 | identical. | |
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, | |
905 | taking continued lines and variable-width characters into account. | |
906 | Setting `line-move-visual' to nil reverts this to the previous | |
907 | behavior (i.e., motion by logical lines based on buffer contents | |
908 | alone). | |
909 | ||
910 | ** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now | |
911 | invokes `suspend-frame'. These changes are for compatibility with the | |
912 | new 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 | |
921 | activating it. | |
922 | ||
923 | *** When Transient Mark mode is on, M-q now fills the region if the | |
924 | region is active. Otherwise, it fills the current paragraph. | |
925 | ||
926 | *** When Transient Mark mode is on, M-$ now checks spelling of the | |
927 | region if the region is active. Otherwise, it checks spelling of the | |
928 | word at point. | |
929 | ||
930 | *** When Transient Mark mode is on, TAB now indents the region if the | |
931 | region is active. | |
932 | ||
933 | *** The variable `use-empty-active-region' controls whether an empty | |
934 | active region in Transient Mark mode should make commands operate on | |
935 | that empty region. | |
936 | ||
937 | ** Temporarily active regions | |
938 | ||
939 | *** The new variable shift-select-mode, non-nil by default, controls | |
940 | shift-selection. When Shift Select mode is on, shift-translated | |
941 | motion keys (e.g. S-left and S-down) activate and extend a temporary | |
942 | region, similar to mouse-selection. | |
943 | ||
944 | *** Temporarily active regions, created using shift-selection or | |
945 | mouse-selection, are not necessarily deactivated in the next command. | |
946 | They are only deactivated after point motion commands that are not | |
947 | shift-translated, or after commands that would ordinarily deactivate | |
948 | the mark in Transient Mark mode (e.g., any command that modifies the | |
949 | buffer). | |
950 | ||
951 | ** Minibuffer and completion changes | |
952 | ||
953 | *** Emacs may ask for confirmation before opening a non-existent file | |
954 | or buffer. By default, Emacs requests confirmation if you type RET | |
955 | immediately after TAB, and the resulting input is not an existing file | |
956 | or buffer; this usually happens when the minibuffer input did not | |
957 | complete far enough and you entered RET by mistake. In that case, | |
958 | Emacs puts the message "[Confirm]" in the minibuffer; type RET again | |
959 | to create the file or buffer. | |
960 | ||
961 | The new variable confirm-nonexistent-file-or-buffer determines whether | |
962 | Emacs asks for confirmation. The default value is `after-completion'. | |
963 | If you change it to t, Emacs always asks for confirmation; if you | |
964 | change it to nil, Emacs never asks for confirmation. | |
965 | ||
966 | *** The rules for performing completion have been changed. | |
967 | When generating completion alternatives, Emacs now takes the | |
968 | minibuffer text after point, if any, into account: this text is | |
969 | treated as a substring of the remaining part of the completion | |
970 | alternative (i.e., the part not matched by the minibuffer text before | |
971 | point). If no completion alternatives are found this way, Emacs | |
972 | attempts to perform partial-completion. If still no completion | |
973 | alternatives are found, we fall back on the Emacs 22 rules for | |
974 | performing completion. | |
975 | ||
976 | The new variable `completion-styles' can be customized to choose your | |
977 | favorite completion style. | |
978 | ||
979 | *** When M-n in the minibuffer reaches the end of the list of defaults, | |
980 | it adds the completion list to the end, so next M-n continues putting | |
981 | completion items to the minibuffer. The same principle applies to | |
982 | incremental search commands as well: C-s or C-M-s starts searching | |
983 | the default values and after the end of defaults they continue | |
984 | searching 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 | |
989 | name of the current buffer. | |
990 | ||
991 | *** In the M-! (shell-command) prompt, M-n provides some default commands. | |
992 | These are guessed using the file extension of the current file, based | |
993 | on the file-handlers specified in the operating system's `mailcap' | |
994 | file. The ! command in Dired (dired-do-shell-command) works | |
995 | similarly, 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 | |
999 | region in transient-mark-mode, the word under the cursor, the last Isearch | |
1000 | regexp, the last Isearch string and the last replacement regexp. | |
1001 | ||
1002 | *** When enable-recursive-minibuffers is non-nil, operations which use | |
1003 | switch-to-buffer (such as C-x b and C-x C-f) do not fail any more when | |
1004 | used in a minibuffer or a dedicated window. Instead, they fallback on | |
1005 | using pop-to-buffer, which will use some other window. This change | |
1006 | has no effect when enable-recursive-minibuffers is nil (the default). | |
1007 | ||
1008 | *** Isearch started in the minibuffer searches in the minibuffer history. | |
1009 | Reverse Isearch commands (C-r, C-M-r) search in previous minibuffer | |
1010 | history elements, and forward Isearch commands (C-s, C-M-s) search in | |
1011 | next history elements. When the reverse search reaches the first history | |
1012 | element, it wraps to the last history element, and the forward search | |
1013 | wraps to the first history element. When the search is terminated, the | |
1014 | history element containing the search string becomes the current. | |
1015 | ||
1016 | *** The variable read-file-name-completion-ignore-case overrides | |
1017 | completion-ignore-case for file name completion. | |
1018 | ||
1019 | *** The variable read-buffer-completion-ignore-case overrides | |
1020 | completion-ignore-case for buffer name completion. | |
1021 | ||
1022 | *** The new command `minibuffer-force-complete' chooses one of the | |
1023 | possible completions, rather than stopping at the common prefix. | |
1024 | ||
1025 | *** If `completion-auto-help' is `lazy', Emacs shows the completions | |
1026 | buffer only on the second attempt to complete. This was already | |
1027 | supported 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 | |
1032 | size of the default face in the current buffer. The face is changed | |
1033 | via face remapping (see Lisp changes, below). | |
1034 | ||
1035 | *** New commands to change the default face size in the current buffer. | |
1036 | To 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'. | |
1038 | These work via Text Scale mode, a new minor mode. | |
1039 | ||
1040 | The final key in the above commands may be repeated without the | |
1041 | leading `C-x', e.g. `C-x C-= C-= C-=' increases the face height by | |
1042 | three steps. Each step scales the height of the default face by the | |
1043 | value of the variable `text-scale-mode-step'. | |
1044 | ||
1045 | *** The commands buffer-face-mode and buffer-face-set can be used to | |
1046 | remap the default face in the current buffer. See "Buffer Face mode", | |
1047 | under New Modes and Packages. | |
1048 | ||
1049 | ** Primary selection changes | |
1050 | ||
1051 | *** You can disable kill ring commands from accessing the primary | |
1052 | selection 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 | |
1057 | are not shown, e.g. if truncate-lines is non-nil. The most convenient | |
1058 | way to enable word-wrapping is using the new minor mode Visual Line | |
1059 | mode; in addition to setting `word-wrap' to t, this rebinds some | |
1060 | editing commands to work on screen lines rather than text lines. See | |
1061 | New Modes and Packages, below. | |
1062 | ||
1063 | ** Window management changes | |
1064 | ||
1065 | *** truncate-partial-width-windows now accepts integer values, which | |
1066 | specify a minimum window width for partial-width windows, below which | |
1067 | lines are truncated. The default has been changed to 50. | |
1068 | ||
1069 | *** The new command balance-windows-area balances windows both | |
1070 | vertically and horizontally. | |
1071 | ||
1072 | *** pop-to-buffer now always sets input focus when the popped-to window | |
1073 | is on a different frame. | |
1074 | ||
1075 | ** Miscellaneous changes: | |
1076 | ||
1077 | *** C-l is bound to the new command recenter-top-bottom, rather than recenter. | |
1078 | This moves the current line to window center, top and bottom on | |
1079 | successive 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 | |
1084 | updates the selection or clipboard to the current yank, just as M-w | |
1085 | would 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 | |
1089 | restored by customizing `query-replace-show-replacement'. | |
1090 | ||
1091 | *** The command shell prompts for the default directory, when it is | |
1092 | called with a prefix and the default directory is a remote file name. | |
1093 | This is because some file name handlers (like ange-ftp) are not able to | |
1094 | run processes remotely. | |
1095 | ||
1096 | *** The new command kill-matching-buffers kills buffers whose name | |
1097 | matches a regexp. | |
1098 | ||
1099 | *** The value of comment-style now defaults to `indent'. | |
1100 | Thefore, comment-start markers are inserted at the current indentation | |
1101 | of 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. | |
1107 | The mode bits can be specified in symbolic notation, like with GNU | |
1108 | Coreutils, in addition to an octal number. `chmod' is a new | |
1109 | convenience alias for this function. | |
1110 | ||
1111 | *** `next-error-recenter' specifies how next-error should recenter the | |
1112 | visited source file. Its value can be a number (for example, 0 for | |
1113 | top 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 | |
1116 | kill into the password. | |
1117 | ||
1118 | *** Tooltip frame parameters `font' and `color' in `tooltip-frame-parameters' | |
1119 | are 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 | |
1126 | automatically when they are displayed. It is globally on by default. | |
1127 | It 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 | |
1132 | the current buffer. The variable `buffer-face-mode-face' specifies | |
1133 | the face to remap to. The command `buffer-face-set' prompts for a | |
1134 | face name, sets `buffer-face-mode-face' to it, and enables | |
1135 | buffer-face-mode. See "Face changes", under Editing Changes, for a | |
1136 | description of face remapping. | |
1137 | ||
1138 | ** butterfly flips the desired bit on the drive platter. | |
1139 | See http://xkcd.com/378/ | |
1140 | ||
1141 | ** bug-reference.el provides clickable links to bug reports. | |
1142 | ||
1143 | ** dbus.el provides D-Bus language bindings. | |
1144 | D-Bus is an inter-process communication mechanism for applications | |
1145 | residing on the same host. See the manual for details. | |
1146 | ||
1147 | ** DocView mode allows viewing of PDF, PostScript and DVI documents. | |
1148 | One can also search for a regular expression in the document. For | |
1149 | details, see the commentary in doc-view.el. | |
1150 | ||
1151 | PDF and DVI files are now opened in Doc View mode by default. | |
1152 | ||
1153 | In Postcript mode, C-c C-c launches Doc View minor mode for viewing | |
1154 | the postscript file. | |
1155 | ||
1156 | ** EasyPG provides an interface to the GNU Privacy Guard (GnuPG). | |
1157 | It includes a GnuPG keyring browser, cryptographic operations on | |
1158 | regions and files, and automatic encryption of *.gpg files. For | |
1159 | details, 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 | |
1165 | current buffer. | |
1166 | ||
1167 | ** mairix.el is an interface to mairix, a free tool for indexing and | |
1168 | searching locally stored mail. It allows you to query mairix and | |
1169 | display the search results with Rmail, Gnus and VM. Note that there | |
1170 | is an existing Gnus back end, nnmairix.el, which should be used with | |
1171 | Maildir/MH setups. | |
1172 | ||
1173 | ** minibuffer-depth-indicate-mode shows the minibuffer depth in the prompt. | |
1174 | ||
1175 | ** nXML Mode | |
1176 | This is a new mode for editing XML documents. It allows a schema to | |
1177 | be associated with the XML document being edited, using Relax NG as | |
1178 | the schema language. The schema is used to provide two key features: | |
1179 | ||
1180 | *** Continuous validation. nXML validates as you type, highlighting | |
1181 | any invalid parts of your document. | |
1182 | ||
1183 | *** Completion. nXML can assist you in entering an element name, | |
1184 | attribute name or data value by using information about what is | |
1185 | allowed by the schema in that context. | |
1186 | ||
1187 | ** proced.el provides a Dired-like interface for operating on | |
1188 | processes. Proced makes an Emacs buffer containing a listing of the | |
1189 | current processes. You can use the normal Emacs commands to move | |
1190 | around in this buffer, and special Proced commands to operate on the | |
1191 | processes listed. It is currently only functional on GNU/Linux, | |
1192 | MS-Windows and Solaris. | |
1193 | ||
1194 | ** Remember Mode is a mode for jotting down things to remember. | |
1195 | Notes can be saved to a Diary file. For details, see the Remember | |
1196 | Manual. | |
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. | |
1203 | It turns on word-wrapping in the current buffer, and rebinds C-a, C-e, | |
1204 | and C-k to commands that operate by visual lines instead of logical | |
1205 | lines. This is a more reliable replacement for longlines-mode. | |
1206 | This can also be turned on using the menu bar, via | |
1207 | Options -> Line Wrapping in this Buffer -> Word Wrap | |
1208 | ||
1209 | ** xesam.el is an implementation of Xesam, an interface to (desktop) | |
1210 | search engines like Beagle, Strigi, and Tracker. The Xesam API | |
1211 | requires D-Bus for communication. | |
1212 | ||
1213 | ** zeroconf.el offers service discovery and service publishing | |
1214 | interfaces according to the zeroconf specification. It communicates | |
1215 | with Avahi, a zeroconf implementation, via D-Bus messages on systems | |
1216 | which have installed this software. | |
1217 | ||
1218 | ** There is a new `whitespace' package. | |
1219 | (The pre-existing one has been renamed to `old-whitespace'.) | |
1220 | Now, besides reporting bogus blanks, the whitespace package has a | |
1221 | minor mode and a global minor mode to visualize blanks (TAB, (HARD) | |
1222 | SPACE and NEWLINE). The visualization is made via faces and/or display | |
1223 | table. It can also indicate lines that extend beyond a given column, | |
1224 | trailing blanks, and empty lines at the start or end of a buffer. | |
1225 | See `whitespace-style' for more details. The `whitespace-action' option | |
1226 | specifies 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, | |
1234 | abbrev-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 | |
1239 | extra 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. | |
1259 | Note, however, that the free version of the unrar command only handles | |
1260 | versions 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 | |
1270 | identify 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 | |
1277 | bookmark.el can read a .emacs.bmk file saved by an older Emacs, but an | |
1278 | older 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. | |
1283 | The variable `european-calendar-style' is obsolete - use `calendar-date-style'. | |
1284 | Similarly, the commands `american-calendar' and `european-calendar' | |
1285 | should be replaced by `calendar-set-date-style'. | |
1286 | ||
1287 | *** The calendar namespace has been rationalized. | |
1288 | All functions and variables now begin with a `calendar-', `diary-', or | |
1289 | `holiday-' prefix. The various calendar systems have secondary | |
1290 | prefixes, eg `calendar-french-'. The old names you are likely to use | |
1291 | directly still exist, for the time being, as aliases, but please start | |
1292 | using the new names. | |
1293 | ||
1294 | *** The whitespace in the calendar layout can be customized. | |
1295 | See the variables: | |
1296 | calendar-left-margin, calendar-intermonth-spacing, calendar-column-width, | |
1297 | calendar-day-header-width, and calendar-day-digit-width. | |
1298 | ||
1299 | *** Text (e.g. ISO weeks) can be displayed between the calendar months. | |
1300 | See the variables calendar-intermonth-header and calendar-intermonth-text. | |
1301 | ||
1302 | *** The function `holiday-chinese' computes holidays on the Chinese calendar. | |
1303 | It 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 | |
1306 | the 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 | |
1311 | associated with the current log entry. | |
1312 | ||
1313 | *** The new command C-c C-c (change-log-goto-source) goes to the | |
1314 | source 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. | |
1319 | It has different colors for to show that: (a) the command is still | |
1320 | running, (b) successful completion, (c) error. | |
1321 | ||
1322 | *** compilation-auto-jump-to-first-error tells `compile' to jump to | |
1323 | the first error encountered during compilations. | |
1324 | ||
1325 | *** compilation-scroll-output accepts a new value, `first-error', which | |
1326 | says to stop auto scrolling at the first error that occurs. | |
1327 | ||
1328 | *** The `cc' alias for C++ files in `grep-file-aliases' has been | |
1329 | improved. `hh' can be used to match C++ header files and `cchh' both | |
1330 | C++ sources and headers. | |
1331 | ||
1332 | ** Copyright | |
1333 | ||
1334 | *** You can specify your copyright holders' names. | |
1335 | Only copyright lines with holders matching `copyright-names-regexp' are | |
1336 | considered for update. | |
1337 | ||
1338 | *** Copyrights can be at the end of the buffer. | |
1339 | This 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 | |
1344 | set 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. | |
1349 | It's used automatically as you move through hunks, see | |
1350 | diff-auto-refine-mode. It is bound to `C-c C-b'. | |
1351 | ||
1352 | *** diff-add-change-log-entries-other-window iterates through the diff | |
1353 | buffer and tries to create ChangeLog entries for each change. | |
1354 | It is bound to `C-x 4 A'. | |
1355 | ||
1356 | *** Turning on `whitespace-mode' in a diff buffer will show trailing | |
1357 | whitespace 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, | |
1362 | and C-x C-q in wdired-mode exits it with asking a question about | |
1363 | saving changes. | |
1364 | ||
1365 | *** `&' runs the command `dired-do-async-shell-command' that executes | |
1366 | the command asynchronously without the need to manually add ampersand | |
1367 | to the end of the command. Its output appears in the buffer `*Async Shell | |
1368 | Command*'. | |
1369 | ||
1370 | *** `M-s f C-s' and `M-s f M-C-s' run Isearch that matches only at file names. | |
1371 | When a new user option `dired-isearch-filenames' is t, then even ordinary | |
1372 | Isearch started with `C-s' and `C-M-s' matches only at file names in the | |
1373 | Dired buffer. When `dired-isearch-filenames' is `dwim' then activation of | |
1374 | file name Isearch depends on the position of point - if point is on a file | |
1375 | name initially, then Isearch matches only file names, otherwise it matches | |
1376 | everywhere in the Dired buffer. You can toggle file names matching on or | |
1377 | off 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. | |
1380 | They visit the first marked file in the sequence and display the usual Isearch | |
1381 | prompt 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. | |
1384 | The upper case key `Y' replaces all remaining matches in all remaining files | |
1385 | with no more questions. The upper case key `N' stops doing replacements | |
1386 | in the current file and skips to the next file. These multi-file keys | |
1387 | are available for all commands that use `tags-query-replace' | |
1388 | including `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. | |
1394 | Customize the variable `fortran-line-length' to change it. | |
1395 | ||
1396 | *** In Fortran mode, M-; is now bound to the standard comment-dwim, | |
1397 | rather 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 | 1404 | There are many new features, bug fixes and improvements; see the file |
eb199145 GM |
1405 | GNUS-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 | 1408 | saving articles, drafts, and ~/.newsrc.eld. These file may not be read |
eb199145 GM |
1409 | correctly in Emacs 22 and below. If you want to Gnus across different Emacs |
1410 | versions, you may set `mm-auto-save-coding-system' to `emacs-mule'. | |
1411 | ||
1412 | *** Passwords are consistently loaded through `auth-source' | |
1413 | Gnus 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 | |
1415 | authentication respectively. | |
1416 | ||
1417 | ** Help mode | |
1418 | ||
1419 | *** New macro `with-help-window' should set up help windows better | |
1420 | than `with-output-to-temp-buffer' with `print-help-return-message'. | |
1421 | ||
1422 | *** New option `help-window-select' permits to customize whether help | |
1423 | window shall be automatically selected when invoking help. | |
1424 | ||
1425 | *** New variable `help-window-point-marker' permits one to specify a new | |
1426 | position 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 | |
1431 | incremental word search. New command `isearch-toggle-word' bound to the | |
1432 | same key `M-s w' in Isearch mode toggles word searching on or off | |
1433 | while Isearch is active. | |
1434 | ||
1435 | *** New command `isearch-highlight-regexp' bound to `M-s h r' in Isearch | |
1436 | mode runs `highlight-regexp' (`hi-lock-face-buffer') with the current | |
1437 | search string as its regexp argument. The same key `M-s h r' and | |
1438 | other 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 | |
1442 | runs `occur' with the current search string. The same key `M-s o' | |
1443 | is bound globally to the command `occur'. | |
1444 | ||
1445 | *** Isearch can now search through multiple ChangeLog files. | |
1446 | When running Isearch in a ChangeLog file, if the search fails, | |
1447 | then another C-s tries searching the previous ChangeLog, | |
1448 | if there is one (e.g. going from ChangeLog to ChangeLog.12). | |
1449 | This is enabled if multi-isearch-search is non-nil. | |
1450 | ||
1451 | *** Two new commands to start Isearch on a list of marked buffers | |
1452 | for 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 | |
1460 | documentation of the given Isearch key sequence, `C-h m' displays | |
0235128c SM |
1461 | documentation for Isearch mode. All the other Help commands exit |
1462 | Isearch mode and execute their global definitions. | |
eb199145 GM |
1463 | |
1464 | *** When started in the minibuffer, Isearch searches in the minibuffer | |
1465 | history. 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 | |
1473 | that either version can be used as inferior Python by python.el. | |
1474 | ||
1475 | *** Python mode now has `pdbtrack' functionality. When using pdb to | |
1476 | debug a Python program, pdbtrack notices the pdb prompt and displays | |
1477 | the source file and line that the program is stopped at, much the same | |
1478 | way 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 | |
1483 | remote files, if there is no established connection to the | |
1484 | corresponding remote host. | |
1485 | ||
1486 | ** Rmail | |
1487 | ||
1488 | *** Rmail no longer converts the messages to Babyl format. | |
1489 | Instead, it uses UNIX mbox format, both on disk and in Rmail buffers, | |
1490 | and does conversion and decoding when a message is displayed. | |
1491 | ||
1492 | The first time you visit an Rmail file in Babyl format, Rmail | |
1493 | automatically converts it to mbox format. This is a one-time | |
1494 | conversion, but it can take a few minutes, depending on how fast is | |
1495 | your machine and on the size of the file. You should find the rest of | |
1496 | Rmail usage unaltered. | |
1497 | ||
1498 | However, M-x set-rmail-inbox-list now lasts only for one session | |
1499 | because there is no way to save the list of inbox files in an | |
1500 | mbox-format file. | |
1501 | ||
1502 | Also, whereas with Babyl format M-x find-file would switch to Rmail | |
1503 | mode, with mbox format this is no longer the case (there being no way | |
1504 | to add an "-*- rmail-*-" cookie to an mbox file). Use C-u M-x rmail | |
1505 | instead. | |
1506 | ||
1507 | If you have written any extensions to Rmail, they are likely to need | |
1508 | updating. Conceptually, the Rmail buffer that you see is no longer | |
1509 | just a narrowed portion of the whole. So you cannot access the whole | |
1510 | of a message (or message collection) by a simple save-restriction and | |
1511 | widen. Instead, there are two buffers: the rmail-buffer, and the | |
1512 | rmail-view-buffer. The former is the buffer that you see, the latter | |
1513 | is invisible. Most of the time, the invisible `view' buffer contains | |
1514 | the full contents of the Rmail file, and the Rmail buffer contains a | |
1515 | decoded copy of the current message (with only a subset of the | |
1516 | headers). In this state, Rmail is said to be `swapped'. | |
1517 | ||
1518 | You may find the following functions useful: | |
1519 | ||
1520 | `rmail-get-header' and `rmail-set-header' get or set the value of a | |
1521 | message header, whether or not it is currently visible. | |
1522 | ||
1523 | `rmail-apply-in-message' is a general purpose function that calls a | |
1524 | function (with arguments) which you specify on the full text of a given | |
1525 | message. To further narrow to just the headers, search forward for "\n\n". | |
1526 | ||
1527 | *** The new command `rmail-mime' displays MIME messages. | |
1528 | It is bound to `v' in Rmail buffers and summaries. It displays plain | |
1529 | text and multipart messages in a temporary buffer, and offers buttons | |
1530 | to save attachments. | |
1531 | ||
1532 | *** The command `rmail-redecode-body' no longer accepts the optional arg RAW. | |
1533 | Since Rmail now holds messages in their original undecoded form in a | |
1534 | separate buffer, `rmail-redecode-body' no longer encodes the original | |
1535 | message, 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 | |
1538 | for copying messages from Rmail and appending them to files. It | |
1539 | handles Babyl-format files as well as mbox-format files, and it | |
1540 | handles both kinds properly when they are visited in Emacs. It always | |
1541 | copies the full headers of the message. | |
1542 | ||
1543 | *** The C-o command is now `rmail-output-as-seen'. It uses | |
1544 | the message as displayed, appending it to an mbox file. | |
1545 | ||
1546 | *** The modified status of the Rmail buffer is reported in the mode-line. | |
1547 | Previously, this information was hidden. | |
1548 | ||
1549 | ** TeX modes | |
1550 | ||
1551 | *** New option latex-indent-within-escaped-parens | |
1552 | permits to customize indentation of LaTeX environments delimited | |
1553 | by escaped parens. | |
1554 | ||
1555 | ** T-mouse Mode | |
1556 | ||
1557 | *** If the gpm mouse server is running and t-mouse-mode is enabled, | |
1558 | Emacs uses a Unix socket in a GNU/Linux console to talk to server, | |
1559 | rather than faking events using the client program mev. This C level | |
1560 | approach provides mouse highlighting and help echoing in the | |
1561 | minibuffer. | |
1562 | ||
1563 | ** Tramp | |
1564 | ||
1565 | *** New connection methods. | |
1566 | The new methods "plinkx", "plink2", "psftp", "sftp" and "fish" have | |
1567 | been introduced. There are also new so-called gateway methods | |
1568 | "tunnel" and "socks". | |
1569 | ||
1570 | *** IPv6 addresses. | |
1571 | IPv6 addresses are supported now as host names. They must be embedded | |
1572 | in square brackets, like in "/ssh:[::1]:". | |
1573 | ||
1574 | *** Multihop syntax has been removed. | |
1575 | The pseudo-method "multi" has been removed. Instead, multi hops | |
1576 | can be specified by the new variable `tramp-default-proxies-alist'. | |
1577 | ||
1578 | *** More default settings. | |
1579 | Default 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. | |
1583 | In order to reduce connection setup, information about used | |
1584 | connections is kept persistently in a file. The name of this file is | |
1585 | defined in the variable `tramp-persistency-file-name'. | |
1586 | ||
1587 | *** Control of remote processes. | |
1588 | Running 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. | |
1592 | When the variable `file-precious-flag' is set, the success of a remote | |
1593 | file copy is checked via the file's checksum. | |
1594 | ||
1595 | *** Passwords can be read from an authentification file. | |
1596 | Tramp uses the package `auth-source' to read passwords from a file, if | |
1597 | necessary. | |
1598 | ||
1599 | ** VC and related modes | |
1600 | ||
1601 | *** VC now supports applying VC operations to a set of files at a time. | |
1602 | This enables VC to work much more effectively with changeset-oriented | |
1603 | version-control systems such as Subversion, GNU Arch, Mercurial, Git | |
1604 | and Bzr. VC will now pass a multiple-file commit to these systems as | |
1605 | a single changeset. | |
1606 | ||
1607 | *** vc-dir is a new command that displays file names and their VC | |
1608 | status. It allows to apply various VC operations to a file, a | |
1609 | directory 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). | |
1613 | This is because there is an increasing variety of VC systems, and they | |
1614 | do not all accept the same "common" options. For example, a CVS diff | |
1615 | command used to append the values of `vc-cvs-diff-switches', | |
1616 | `vc-diff-switches', and `diff-switches'. Now the first non-nil value | |
1617 | from 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 | |
1624 | case 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 | |
1627 | see the diff for the whole changeset (not only for the current file) | |
1628 | by typing the D key. Using the "Show changeset diff of revision at | |
1629 | line" 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 | |
1634 | the current line. | |
1635 | ||
1636 | *** Asynchronous VC commands display [Waiting...] in the mode-line | |
1637 | of the corresponding buffer as long as the asynchronous process is | |
1638 | active. | |
1639 | ||
1640 | *** Log entries can be modified using the key "e" in log-view. | |
1641 | For now only CVS, RCS, SCCS and SVN support this functionality. | |
1642 | This is done by the `modify-change-comment' backend function. | |
1643 | ||
1644 | *** In log-view-mode, for VC systems that support changesets, you can | |
1645 | see the diff for the whole changeset (not only for the current file) | |
1646 | by 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 | |
1653 | to update it to the new VC. | |
1654 | ||
1655 | ** Miscellaneous | |
1656 | ||
1657 | *** comint-mode uses `start-file-process' now (see Lisp Changes). | |
1658 | If `default-directory' is a remote file name, subprocesses are started | |
1659 | on the corresponding remote system. | |
1660 | ||
1661 | *** Eldoc highlights the function argument under point | |
1662 | with the face `eldoc-highlight-function-argument'. | |
1663 | ||
1664 | *** In Etags, the --members option is now the default. | |
1665 | Use --no-members if you want the old default behavior of not tagging | |
1666 | struct members in C, members variables in C++ and variables in PHP. | |
1667 | ||
1668 | *** The `gdb' command only works with the graphical interface now. | |
1669 | Use `gud-gdb' if you want the (old) text command mode. | |
1670 | ||
1671 | *** goto-address.el provides two new minor modes, goto-address-mode and | |
1672 | goto-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 | |
1677 | directories in which `ffap-rfc' will first search for RFCs. | |
1678 | ||
1679 | *** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them. | |
1680 | See 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. | |
1685 | See Info-breadcrumbs-depth to control it. | |
1686 | ||
1687 | *** net-utils has an `iwconfig' command, similar to the existing `ifconfig'. | |
1688 | It 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. | |
1695 | It's used automatically as you move through conflicts, see | |
1696 | smerge-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 | |
1701 | package. It creates a buffer with an updating time display using | |
1702 | several time zones. | |
1703 | ||
1704 | *** The appearance of superscript and subscript in TeX is more customizable. | |
1705 | See the documentation of the variables: tex-fontify-script, | |
1706 | tex-font-script-display, tex-suscript-height-ratio, and | |
1707 | tex-suscript-height-minimum. | |
1708 | ||
1709 | *** view-remove-frame-by-deleting is now by default t | |
1710 | since users found iconification of view-mode frames distracting. | |
1711 | ||
1712 | *** WoMan tries to add locale-specific manual page directories to the | |
1713 | search 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. | |
1719 | The default value of `completion-ignore-case' is now nil on | |
1720 | MS-Windows, the same as it is for other operating systems. The | |
1721 | variable doesn't apply to reading a file name -- in that case Emacs | |
1722 | heeds `read-file-name-completion-ignore-case' instead. | |
1723 | ||
1724 | ** IPv6 is supported on MS-Windows. | |
1725 | Emacs now supports IPv6 on Windows XP and later, and earlier versions | |
1726 | of Windows with third party IPv6 stacks installed. In Emacs 22, IPv6 was | |
1727 | supported on other platforms, but not on Windows due to using the winsock | |
1728 | 1.1 header file, even though Emacs was linking to the winsock 2 library. | |
1729 | ||
1730 | ** Busy cursor (hourglass) now displays on MS-Windows. | |
1731 | When Emacs is busy, an hourglass mouse cursor is displayed on Windows. | |
1732 | In Emacs 22 only X supported the busy cursor. | |
1733 | ||
1734 | ** Battery status is available on MS-Windows | |
1735 | Emacs can now display the battery status in the mode-line when enabled with | |
1736 | display-battery-mode or from the Options menu. More verbose battery | |
1737 | information is also available with the command `battery'. In Emacs 22 | |
1738 | battery status was supported only on GNU/Linux and Mac. | |
1739 | ||
1740 | ** More keys available on MS-Windows. | |
1741 | Keys normally associated with IMEs, and some exotic keys not normally found | |
1742 | on standard keyboards have been given names so they can be bound to functions | |
1743 | inside Emacs. If there are keys on your keyboard that have not been exposed | |
1744 | to Emacs in the past, try C-h k to see if they are available now. | |
1745 | ||
1746 | Emacs can now bind functions to the extra buttons for media player and | |
1747 | browser control present on some keyboards. These buttons are disabled | |
1748 | by default, since enabling them prevents their system-wide use when | |
1749 | Emacs has focus. To enable them, set the variable | |
1750 | w32-pass-multimedia-buttons to nil. See the doc string of that variable | |
1751 | for the list of extra keys that are available. | |
1752 | ||
1753 | ** BDF fonts no longer supported on MS-Windows. | |
1754 | The font backend was completely rewritten for this release. The focus | |
1755 | on Windows has been getting acceptable performance and full unicode | |
1756 | support, including complex script shaping for native Windows fonts. A | |
1757 | rewrite of the BDF font support has not happened due to lack of time | |
1758 | and developers. If demand still exists for such a backend even with | |
1759 | the improved language support for native Windows fonts, future | |
1760 | development in this direction will most likely be based on the | |
1761 | freetype 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. | |
1769 | I.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 | |
1772 | specified function with a cons (FROM . TO) as a key if characters in | |
1773 | that 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 | |
1780 | coding-system used for decoding. The functions | |
1781 | `process-filter-multibyte-p' and `set-process-filter-multibyte' are | |
1782 | obsolete. | |
1783 | ||
1784 | ** The variable `byte-compile-warnings' can now be a list starting with `not', | |
1785 | meaning to disable the specified warnings. The meaning of this list | |
1786 | may therefore be the reverse of what you expect (of course, this is | |
1787 | only an issue if you make use of the new `not' syntax). Rather than | |
1788 | checking/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. | |
1793 | Use `(format-mode-line mode-name)' to ensure a string value. | |
1794 | ||
1795 | ** The function x-font-family-list has been removed. | |
1796 | Use 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' | |
1803 | have been removed. | |
1804 | ||
1805 | *** The cpXXX coding systems are now supported automatically. | |
1806 | The functions cp-...-codepage, which you had to use in Emacs 22 to | |
1807 | enable support for these coding systems, have been deleted. | |
1808 | ||
1809 | *** The following features have been removed. They were used for | |
1810 | displaying various scripts with specific fonts, and are no longer | |
1811 | needed now that OpenType font support is available: | |
1812 | ||
1813 | **** `devanagari' and `devan-util', and all associated devanagari-* and | |
1814 | dev-* functions and variables (formerly used for Devanagari script). | |
1815 | ||
1816 | **** `kannada' and `knd-util', and all associated kannada-* and knd-* | |
1817 | functions and variables (formerly used for Kannada script). | |
1818 | ||
1819 | **** `malayalam' and `mlm-util', and all associated malayalam-* and | |
1820 | mlm-* functions and variables (formerly used for Malayalam script). | |
1821 | ||
1822 | **** `tamil' and `tml-util, and all associated tamil-* and tml-* | |
1823 | functions and variables (formerly used for Tamil script). | |
1824 | ||
1825 | *** The meaning of NAME argument of `set-fontset-font' is changed. | |
1826 | Previously nil is accepted as the default fontset. Now, nil is for | |
1827 | the fontset of the selected frame and t is for the default fontset. | |
1828 | ||
1829 | *** The meaning of FONTSET argument of `print-fontset' is changed. | |
1830 | Now, nil is for the fontset of the selected frame and t is for the | |
1831 | default fontset. | |
1832 | ||
1833 | ** If a function in write-region-annotate-functions returns with a | |
1834 | different buffer current, Emacs no longer kills that buffer | |
1835 | automatically. This behavior existed in previous versions of Emacs, | |
1836 | but was undocumented. To kill a buffer after write-region, give the | |
1837 | variable `write-region-post-annotation-function' a buffer-local value | |
1838 | of `kill-buffer'. | |
1839 | ||
1840 | ** The variable temp-file-name-pattern has been removed. | |
1841 | This variable was only used by call-process-region, which now uses | |
1842 | temporary-file-directory instead. | |
1843 | ||
1844 | ** The COUNT and SYSTEM-FLAG arguments to define-abbrev have been | |
1845 | removed. The function now takes extra arguments for specifying | |
1846 | arbitrary abbrev properties. | |
1847 | ||
1848 | ** end-of-defun-function is now guaranteed to work only when called | |
1849 | from the start of a defun. It must now leave point exactly at the end | |
1850 | of defun, since `end-of-defun' now itself moves forward over | |
1851 | whitespace 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 | |
1857 | string used by `update-file-autoloads' to find autoloaded forms. The | |
1858 | variable `generated-autoload-file' similarly controls the name of the | |
1859 | file where `update-file-autoloads' writes the calls to `autoload'. | |
1860 | The default values are ";;;###autoload" and `loaddefs.el', | |
1861 | respectively. | |
1862 | ||
1863 | ** New primitives `list-system-processes' and `process-attributes' | |
1864 | let Lisp programs access the processes that are running on the local | |
1865 | machine. See the doc strings of these functions for more details. | |
1866 | Not all platforms support accessing this information; on those that | |
1867 | don't, these primitives will return nil. | |
1868 | ||
1869 | ** New variable `user-emacs-directory'. | |
1870 | Use this instead of "~/.emacs.d". | |
1871 | ||
1872 | ** If a local hook function has a non-nil `permanent-local-hook' | |
1873 | property, `kill-all-local-variables' does not remove it from the local | |
1874 | value of the hook variable; it remains even if you change major modes. | |
1875 | ||
1876 | ** `frame-inherited-parameters' lets new frames inherit parameters from | |
1877 | the selected frame. | |
1878 | ||
1879 | ** New keymap `input-decode-map' overrides like key-translation-map, but | |
1880 | applies before function-key-map. Also it is terminal-local contrary to | |
1881 | key-translation-map. Terminal-specific key-sequences are generally added to | |
1882 | this 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 | |
1887 | of strings. In the latter case, Emacs puts the second and following | |
1888 | strings on the kill ring. | |
1889 | ||
1890 | ** In `condition-case', a handler can specify "let the debugger run first". | |
1891 | You do this by writing `debug' in the list of conditions to be handled, | |
1892 | like 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 | |
1902 | arguments.) | |
1903 | ||
1904 | ** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED. | |
1905 | IDENTIFICATION specifies which part of the remote identifier has to be | |
1906 | returned. With CONNECTED passed non-nil, it is checked whether a | |
1907 | remote connection has been established already. | |
1908 | ||
1909 | ** The new macro `declare-function' suppresses compiler warnings about | |
1910 | undefined functions. | |
1911 | ||
1912 | ** Changes to interactive function handling | |
1913 | ||
1914 | *** The new interactive spec code ^ says to first call | |
1915 | handle-shift-selection if shift-select-mode is non-nil, before reading | |
1916 | the command arguments. This is used for shift-selection (see above). | |
1917 | ||
1918 | *** Built-in functions can now have an interactive specification that | |
1919 | is not a prompt string. If the `intspec' parameter of a `DEFUN' | |
1920 | starts 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 | |
1924 | interactive forms to subroutines. | |
1925 | ||
1926 | ** Region changes | |
1927 | ||
1928 | *** Commands should use `use-region-p' to test whether there is | |
1929 | an active region that they should operate on. | |
1930 | ||
1931 | *** `region-active-p' returns non-nil when Transient Mark mode is | |
1932 | enabled and the mark is active. Most commands that act specially on | |
1933 | the active region in Transient Mark mode should use `use-region-p' | |
1934 | instead of `region-active-p', because `use-region-p' obeys the new | |
1935 | user option `use-empty-active-region' (see Editing Changes, above). | |
1936 | ||
1937 | *** If a command sets `transient-mark-mode' to (only . OLDVAL), that | |
1938 | means to activate transient-mark-mode temporarily, until the next | |
1939 | unshifted point motion command or mark deactivation. Afterwards, | |
1940 | reset 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 | |
1946 | value 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 | |
1951 | Emacs initialization. | |
1952 | ||
1953 | ** Changes affecting display-buffer | |
1954 | ||
1955 | *** display-buffer tries to be smarter when splitting windows. | |
1956 | The new option split-window-preferred-function lets you specify your own | |
1957 | function to pop up new windows. Its default value split-window-sensibly | |
1958 | can split a window either vertically or horizontally, whichever seems | |
1959 | more suitable in the current configuration. You can tune the behavior | |
1960 | of split-window-sensibly by customizing split-height-threshold and the | |
1961 | new option split-width-threshold. Both options now take the value nil | |
1962 | to inhibit splitting in one direction. Setting split-width-threshold to | |
1963 | nil inhibits horizontal splitting and gets you the behavior of Emacs 22 | |
1964 | in this respect. In any case, display-buffer may now split the largest | |
1965 | window 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 | |
1968 | makes a separate frame on graphic displays. | |
1969 | ||
1970 | *** select-frame and set-frame-selected-window have a new optional | |
1971 | argument NORECORD. If non-nil, this will avoid messing with the order | |
1972 | of recently selected windows and the buffer list. | |
1973 | ||
1974 | ** Window parameters can now be defined. | |
1975 | These are analogous to frame parameters, but are associated with | |
1976 | individual windows. | |
1977 | ||
1978 | *** The new functions window-parameters, window-parameter, and | |
1979 | set-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 | |
1984 | functions `read-from-minibuffer', `read-string', `read-command', | |
1985 | `read-variable', `read-buffer', `completing-read'. Elements of this list | |
1986 | are available for inserting into the minibuffer by typing `M-n'. | |
1987 | For empty input these functions return the first element of this list. | |
1988 | ||
1989 | *** New function `read-regexp' uses the regexp history and some useful | |
1990 | regexp defaults (string at point, last Isearch/replacement regexp/string) | |
1991 | via M-n when reading a regexp in the minibuffer. | |
1992 | ||
1993 | *** minibuffer-local-must-match-filename-map is now named | |
1994 | minibuffer-local-filename-must-match-map. | |
1995 | ||
1996 | *** The `require-match' argument to `completing-read' accepts the new | |
1997 | values `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 | |
2007 | to use for searching in query-replace and replace-string. The | |
2008 | function it specifies is called by `perform-replace' when its 4th | |
2009 | argument is nil. | |
2010 | ||
2011 | *** The new variable `replace-re-search-function' determines the | |
2012 | function 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 | |
2018 | for search related commands. | |
2019 | ||
2020 | *** New keymap `multi-query-replace-map' contains additonal keys bound | |
2021 | to `automatic-all' and `exit-current' for multi-buffer interactive replacement. | |
2022 | ||
2023 | *** The variable `inhibit-changing-match-data', if non-nil, prevents | |
2024 | the search and match primitives from changing the match data. | |
2025 | ||
2026 | *** New functions `word-search-forward-lax' and `word-search-backward-lax'. | |
2027 | These are like `word-search-forward and `word-search-backward', except | |
2028 | that the end of the search string need not match a word boundary, | |
2029 | unless it ends in whitespace. | |
2030 | ||
2031 | ** File handling changes | |
2032 | ||
2033 | *** set-file-modes is now interactive and can take the mode value in | |
2034 | symbolic notation thanks to auxiliary functions. | |
2035 | ||
2036 | *** file-local-variables-alist stores an alist of file-local | |
2037 | variables defined in the current buffer. | |
2038 | ||
2039 | ** Face-remapping | |
2040 | ||
2041 | *** Each face can be remapped to a different face definition using the | |
2042 | variable `face-remapping-alist'. This is an alist that maps faces to | |
2043 | replacement definitions (which can be face names, lists of face names, | |
2044 | or attribute/value plists. If this variable is buffer-local, the | |
2045 | remapping occurs only in that buffer. | |
2046 | ||
2047 | *** text-scale-mode remaps the default face to a larger or smaller | |
2048 | size in the current buffer. This feature is used by the Buffer Face | |
2049 | menu and the new `C-x C-+', `C-x C--', and `C-x C-0' commands (see | |
2050 | Editing Changes, above). | |
2051 | ||
2052 | *** New functions: | |
2053 | ||
2054 | **** `face-remap-add-relative' adds a face remapping entry to the | |
2055 | current buffer. | |
2056 | ||
2057 | **** ``face-remap-remove-relative' removes a face remapping entry from | |
2058 | the 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', | |
2067 | but obeys file handlers. The file handler is chosen based on | |
2068 | `default-directory'. The functions `start-file-process-shell-command' | |
2069 | and `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 | |
2073 | returns 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 | |
2078 | UTF-8 byte sequences. The character code space is now 0x0..0x3FFFFF | |
2079 | with no gap; code points 0x0..0x10FFFF are Unicode characters of the | |
2080 | same code points, while code points 0x3FFF80..0x3FFFFF are raw 8-bit | |
2081 | bytes. | |
2082 | ||
2083 | *** Generic characters no longer exist. | |
2084 | ||
2085 | *** The concept of a charset has changed. A single character may | |
2086 | belong to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets | |
2087 | unicode, 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 | |
2090 | each dimension is no longer limited to 94 or 96. | |
2091 | ||
2092 | **** A dynamic charset priority list is used to infer the charset of | |
2093 | characters for display. | |
2094 | ||
2095 | *** The functions `split-char' and `make-char' now accept up to 4 | |
2096 | positional 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 | |
2101 | form of arguments (old-style arguments still work). | |
2102 | ||
2103 | *** The value of the function `char-charset' depends on the current | |
2104 | priorities of charsets. | |
2105 | ||
2106 | *** The function get-char-code-property now accepts many Unicode base | |
2107 | character 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 | |
2114 | accept a cons of characters as the first argument, and modify all | |
2115 | entries in that range of characters. | |
2116 | ||
2117 | *** Use of `translation-table-for-input' for character code unification | |
2118 | is now obsolete, since Emacs 23.1 and later uses Unicode as basis for | |
2119 | internal representation of characters. | |
2120 | ||
2121 | *** New functions: | |
2122 | ||
2123 | **** `characterp' returns t if and only if the argument is a character. | |
2124 | This 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 | |
2139 | a character code property. | |
2140 | ||
2141 | *** New variables: | |
2142 | ||
2143 | **** `find-word-boundary-function-table' is a char-table of functions to | |
2144 | search 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 | |
2151 | property 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 | |
2158 | coding system instead of `make-coding-system' (which is now obsolete). | |
2159 | ||
2160 | *** The functions `encode-coding-region' and `decode-coding-region' | |
2161 | have an optional 4th argument to specify where the result of | |
2162 | conversion should go. | |
2163 | ||
2164 | *** The functions `encode-coding-string' and `decode-coding-string' | |
2165 | have an optional 4th argument specifying a buffer to store the result | |
2166 | of conversion. | |
2167 | ||
2168 | *** The new variable `inhibit-null-byte-detection' controls whether to | |
2169 | consider text with null bytes as binary data. By default, it is | |
2170 | `nil', and Emacs uses `no-conversion' for any text containing null | |
2171 | bytes. | |
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 | |
2178 | coding system priority order. | |
2179 | ||
2180 | **** `check-coding-systems-region' checks if the text in the region is | |
2181 | encodable 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 | |
2186 | by a coding system. | |
2187 | ||
2188 | **** `coding-system-priority-list' returns a list of coding systems | |
2189 | ordered 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 | |
2194 | the argument name. | |
2195 | ||
2196 | ** There is a new input method, Robin, different from Quail. | |
2197 | It has three functionalities: | |
2198 | i) a simple input method (converts an ASCII sequence into a string). | |
2199 | ii) converts an existing buffer substring into another string | |
2200 | iii) reverse conversion (each character produced by a | |
2201 | robin 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 | |
2208 | as an input method. | |
2209 | ||
2210 | *** The new function `string-to-unibyte' is like `string-as-unibyte' | |
2211 | but signals an error if STRING contains a non-ASCII, non-eight-bit | |
2212 | character. | |
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 | ||
2219 | Emacs.FontBackend: x,xft | |
2220 | ||
2221 | If this resource is not set, Emacs tries to use all font backends | |
2222 | available on your graphic device. | |
2223 | ||
2224 | *** New frame parameter `font-backend' specifies a list of | |
2225 | font-backends supported by the frame's graphic device. On X, they are | |
2226 | currently `x' and `xft'. | |
2227 | ||
2228 | *** The function `set-fontset-font' now accepts a script name as the | |
2229 | second argument, and has an optional 5th argument to control how to | |
2230 | set 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 | |
2251 | entity, 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 | |
2264 | for the first frame. `window-system' is also now a function that | |
2265 | takes a frame argument. | |
2266 | ||
2267 | *** The `keyboard-translate-table' variable and the terminal and | |
2268 | keyboard coding systems are now terminal-local. | |
2269 | ||
2270 | *** You can specify a terminal device (`tty' parameter) and a terminal | |
2271 | type (`tty-type' parameter) to `make-terminal-frame'. | |
2272 | ||
2273 | *** The function `make-frame-on-display' now works during a tty | |
2274 | session. | |
2275 | ||
2276 | *** A new `terminal' data type. | |
2277 | The 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', | |
2281 | a new variable. This inherits from the global variable function-key-map, | |
2282 | which is not used directly any more. | |
2283 | ||
2284 | *** New hooks: | |
2285 | ||
2286 | **** before-hack-local-variables-hook is called after setting new | |
2287 | variable file-local-variables-alist, and before actually applying the | |
2288 | file-local variables. | |
2289 | ||
2290 | **** `suspend-tty-functions' and `resume-tty-functions' are called | |
2291 | after a tty frame has been suspended or resumed, respectively. The | |
2292 | functions are called with the terminal id of the frame being | |
2293 | suspended/resumed as a parameter. | |
2294 | ||
2295 | **** The special hook `delete-terminal-functions' is called before | |
2296 | deleting 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 | |
2311 | the baseline is controlled by a new variable, `underline-minimum-offset'. | |
2312 | ||
2313 | *** You can now pass the value of the `invisible' property to | |
2314 | invisible-p to check whether it would cause the text to be invisible. | |
2315 | This is convenient when checking invisibility of text with no buffer | |
2316 | position (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. | |
2321 | It now accepts a cons cell (COLS . LINES) in its first argument, which | |
2322 | says to stop, where possible, at a pixel x-position equal to COLS | |
2323 | times the default column width. | |
2324 | ||
2325 | *** redisplay-end-trigger-functions, set-window-redisplay-end-trigger, | |
2326 | and window-redisplay-end-trigger are obsolete. Use `jit-lock-register' | |
2327 | instead. | |
2328 | ||
2329 | *** The new variables `wrap-prefix' and `line-prefix' specify display | |
2330 | specs which are appended at display-time to every continuation line | |
2331 | and non-continuation line, respectively. In addition, Emacs | |
2332 | recognizes the `wrap-prefix' and `line-prefix' text or overlay | |
2333 | properties; these have the same effects as the variables of the same | |
2334 | name, 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 | |
2343 | useful for modes such as tar-mode, archive-mode, RMAIL. | |
2344 | ||
2345 | *** `combine-and-quote-strings' produces a single string from a list of strings | |
2346 | sticking a separator string in between each pair, and quoting those | |
2347 | strings that include the separator as their substring. Useful for | |
2348 | consing shell command lines from the individual arguments. | |
2349 | ||
2350 | *** `custom-note-var-changed' tells Custom to treat the change in a | |
2351 | certain variable as having been made within Custom. | |
2352 | ||
2353 | *** `face-all-attributes' returns an alist describing all the basic | |
2354 | attributes of a given face. | |
2355 | ||
2356 | *** `format-seconds' converts a number of seconds into a readable | |
2357 | string of days, hours, etc. | |
2358 | ||
2359 | *** `image-refresh' refreshes all images associated with a given image | |
2360 | specification. | |
2361 | ||
2362 | *** `locate-user-emacs-file' helps packages to select the appropriate | |
2363 | place to save user-specific files. It defaults to `user-emacs-directory' | |
2364 | unless 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 | |
2369 | uses the minibuffer-local-shell-command-map for that. | |
2370 | ||
2371 | *** `split-string-and-unquote' splits a string into a list of substrings | |
2372 | on the boundaries of a given delimiter, and unquotes the substrings that | |
2373 | are quoted. Useful for taking apart shell commands. | |
2374 | ||
2375 | *** The two new functions `looking-at-p' and `string-match-p' can do | |
2376 | the same matching as `looking-at' and `string-match' without changing | |
2377 | the match data. | |
2378 | ||
2379 | *** The two new functions `make-serial-process' and | |
2380 | `serial-process-configure' provide a Lisp interface to the new serial | |
2381 | port support (see Emacs changes, above). | |
2382 | ||
2383 | ** Miscellaneous new variables | |
2384 | ||
2385 | *** `auto-save-include-big-deletions', if non-nil, means auto-save is | |
2386 | not turned off automatically after a big deletion. | |
2387 | ||
2388 | *** `read-circle', if nil, disables the reading of recursive Lisp | |
2389 | structures using the #N= and #N# syntax. | |
2390 | ||
2391 | *** `this-command-keys-shift-translated' is non-nil if the key | |
2392 | sequence invoking the current command was found by shift-translation. | |
2393 | ||
2394 | *** `window-point-insertion-type' determines the insertion-type of the | |
2395 | marker used for window-point. | |
2396 | ||
2397 | *** bookmark provides `bookmark-make-record-function' so special major | |
2398 | modes like Info can teach bookmark.el how to save and restore the | |
2399 | relevant data. | |
2400 | ||
2401 | *** `fill-forward-paragraph-function' specifies which function the | |
2402 | filling 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 | |
2410 | declare-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 | |
2415 | through multiple buffers. A variable `multi-isearch-next-buffer-function' | |
2416 | defines the function to call to get the next buffer to search in the series | |
2417 | of 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 | |
2420 | a list of buffers/files to search for a string/regexp. | |
2421 | ||
2422 | ** The new major mode `special-mode' is intended as a parent for | |
2423 | major modes such as those that set the "'mode-class 'special" property. | |
2424 | ||
2425 | \f | |
2426 | ---------------------------------------------------------------------- | |
2427 | This file is part of GNU Emacs. | |
2428 | ||
2429 | GNU Emacs is free software: you can redistribute it and/or modify | |
2430 | it under the terms of the GNU General Public License as published by | |
2431 | the Free Software Foundation, either version 3 of the License, or | |
2432 | (at your option) any later version. | |
2433 | ||
2434 | GNU Emacs is distributed in the hope that it will be useful, | |
2435 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
2436 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
2437 | GNU General Public License for more details. | |
2438 | ||
2439 | You should have received a copy of the GNU General Public License | |
2440 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. | |
2441 | ||
2442 | \f | |
2443 | Local variables: | |
2444 | mode: outline | |
2445 | paragraph-separate: "[ \f]*$" | |
2446 | end: | |
2447 | ||
2448 | arch-tag: e759449d-88b3-4de4-9900-3a6c3dfa23e2 |