]> code.delx.au - gnu-emacs/blob - etc/NEWS
Fix documentation and implementation of 'directory-name-p'
[gnu-emacs] / etc / NEWS
1 GNU Emacs NEWS -- history of user-visible changes.
2
3 Copyright (C) 2014-2015 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 25.
10
11 See file HISTORY for a list of GNU Emacs versions and release dates.
12 See files NEWS.24, NEWS.23, NEWS.22, NEWS.21, NEWS.20, NEWS.19, NEWS.18,
13 and NEWS.1-17 for changes in older Emacs versions.
14
15 You can narrow news to a specific version by calling `view-emacs-news'
16 with a prefix argument or by typing C-u C-h C-n.
17
18 Temporary note:
19 +++ indicates that all necessary documentation updates are complete.
20 (This means all relevant manuals in doc/ AND lisp doc-strings.)
21 --- means no change in the manuals is needed.
22 When you add a new item, use the appropriate mark if you are sure it applies,
23 otherwise leave it unmarked.
24
25 \f
26 * Installation Changes in Emacs 25.1
27
28 +++
29 ** Building Emacs now requires C99 or later.
30
31 +++
32 ** Building Emacs now requires GNU make, version 3.81 or later.
33
34 +++
35 ** New configure option --with-cairo.
36 This builds Emacs with Cairo drawing. As a side effect, it provides
37 support for built-in printing, when Emacs was built with GTK+.
38
39 ** New configure option --with-modules.
40 This enables support for loading dynamic modules; see below.
41
42 ---
43 ** By default, Emacs no longer works on IRIX. We expect that Emacs
44 users are not affected by this, as SGI stopped supporting IRIX in
45 December 2013. If you are affected, please send a bug report. You
46 should be able to work around the problem either by porting the Emacs
47 undumping code to GCC under IRIX, or by configuring --with-wide-int,
48 or by sticking with Emacs 24.4.
49
50 ---
51 ** The Emacs garbage collector assumes GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS.
52 The GC_MAKE_GCPROS_NOOPS stack-marking variant has been the default
53 since Emacs 24.4, and the other variants were undocumented and were
54 obstacles to maintenance and development. GC_MARK_STACK and its
55 related symbols have been removed from the C internals.
56
57 ---
58 ** 'configure' now prefers gnustep-config when configuring GNUstep.
59 If gnustep-config is not available, the old heuristics are used.
60
61 ---
62 ** 'configure' now prefers inotify to gfile for file notification,
63 unless gfile is explicitly requested via --with-file-notification='gfile'.
64
65 ---
66 ** The configure option '--with-pkg-config-prog' has been removed.
67 Use './configure PKG_CONFIG=/full/name/of/pkg-config' if you need to.
68
69 ---
70 ** The configure option '--with-mmdf' has been removed.
71 It was no longer useful, as it relied on libraries that are no longer
72 supported, and its presence led to confusion during configuration.
73 This affects only the 'movemail' utility; Emacs itself can still
74 process MMDF-format files as before.
75
76 +++
77 ** The configure option '--enable-silent-rules' is now the default,
78 and silent rules are now quieter. To get the old behavior where
79 'make' chatters a lot, configure with '--disable-silent-rules' or
80 build with 'make V=1'.
81
82 ---
83 ** The configure option '--with-gameuser' now allows to specify a
84 group instead of a user if its argument is prefixed by ':' (a colon).
85 This will cause the game score files in ${localstatedir}/games/emacs
86 to be owned by that group, and the helper program for updating them to
87 be installed setgid. The option now defaults to the 'games' group.
88
89 ---
90 ** The `grep-changelog' script (and its manual page) are no longer included.
91 It has no particular connection to Emacs and has not changed in years,
92 so if you want to use it, you can always take a copy from an older Emacs.
93
94 ---
95 ** Emacs 25 comes with a new set of icons.
96 Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
97 The old Emacs logo icons are available as `emacs23.png' in the same location.
98
99 \f
100 * Startup Changes in Emacs 25.1
101
102 +++
103 ** When Emacs is given a file as a command line argument and
104 `initial-buffer-choice' is non-nil, display both the file and
105 `initial-buffer-choice'. When Emacs is given more than one file and
106 `initial-buffer-choice' is non-nil, show `initial-buffer-choice'
107 and *Buffer List*. This makes Emacs convenient to use from the
108 command line when `initial-buffer-choice' is non-nil.
109
110 +++
111 ** The value of ‘initial-scratch-message’ is now treated as a doc string
112 and can contain escape sequences for command keys, quotes, and the like.
113
114 \f
115 * Changes in Emacs 25.1
116
117 +++
118 ** Any file of the form .dir-locals*.el is now considered a dir-local
119 file, and multiple such files can be used in the same directory. See
120 the variable `dir-locals-file' for more information.
121
122 ---
123 ** `xref-find-definitions' and `describe-function' now display
124 information about mode local overrides (defined by cedet/mode-local.el
125 `define-overloadable-function' `define-mode-local-overrides').
126
127 +++
128 ** New `display-buffer' action function `display-buffer-use-some-frame'.
129 This displays the buffer in an existing frame other than the current
130 frame, and allows the caller to specify a frame predicate to exclude
131 frames.
132
133 +++
134 ** New documentation command `describe-symbol'.
135 Works for functions, variables, faces, etc. It is bound to `C-h o' by
136 default.
137
138 +++
139 ** New function `custom-prompt-customize-unsaved-options' checks for
140 unsaved customizations and prompts user to customize (if found). It
141 is intended for adding to 'kill-emacs-query-functions'.
142
143 +++
144 ** Network security (TLS/SSL certificate validity and the like) is
145 added via the new Network Security Manager (NSM) and controlled via
146 the `network-security-level' variable.
147
148 +++
149 ** C-h l now also lists the commands that were run.
150
151 +++
152 ** x-select-enable-clipboard is renamed select-enable-clipboard
153 and x-select-enable-primary is renamed select-enable-primary.
154 Additionally they both now apply to all systems (OSX, GNUstep, Windows, you
155 name it), with the proviso that on some systems (e.g. Windows)
156 select-enable-primary is ineffective since the system doesn't
157 have the equivalent of a primary selection.
158
159 +++
160 ** terpri gets an optional arg ENSURE to conditionally output a newline.
161
162 +++
163 ** New macro `define-advice'.
164
165 +++
166 ** `insert-register' now leaves point after the inserted text
167 when called interactively. A prefix argument toggles this behavior.
168
169 +++
170 ** The new variable `term-file-aliases' replaces some files from lisp/term.
171 The function `tty-run-terminal-initialization' consults this variable
172 when deciding what terminal-specific initialization code to run.
173
174 ---
175 ** New variable `system-configuration-features', listing some of the
176 main features that Emacs was compiled with. This is mainly intended
177 for use in Emacs bug reports.
178
179 +++
180 ** A password is now hidden also when typed in batch mode. Another
181 hiding character but the default `.' can be used by let-binding the
182 variable `read-hide-char'.
183
184 ** The function `font-info' now returns more details about a font.
185 In particular, it now returns the average width of the font's
186 characters, which can be used for geometry-related calculations.
187
188 ** A new function `default-font-width' returns the average width of a
189 character in the current buffer's default font. If the default face
190 is remapped (see `face-remapping-alist'), the value for the remapped
191 face is returned. This function complements the existing function
192 `default-font-height'.
193
194 ** New functions `window-font-height' and `window-font-width' return
195 the height and average width of characters in a specified face and
196 window. If FACE is remapped (see `face-remapping-alist'), the
197 function returns the information for the remapped face.
198
199 ** A new function `window-max-chars-per-line' returns the maximal
200 number of characters that can be displayed on one line. If a face
201 and/or window are provided, these values are used for the
202 calculation. This function is different from `window-body-width' in
203 that it accounts for (i) continuation glyphs, (ii) the size of the
204 font, and (iii) the specified window.
205
206 ** New possible value for `system-type': nacl.
207
208 ** Emacs can now load shared/dynamic libraries (modules).
209 A dynamic Emacs module is a shared library that provides additional
210 functionality for use in Emacs Lisp programs, just like a package
211 written in Emacs Lisp would. The functions `load', `require',
212 `load-file', etc. were extended to load such modules, as they do with
213 Emacs Lisp packages. The new variable `module-file-suffix' holds the
214 system-dependent value of the file-name extension (`.so' on Posix
215 hosts) of the module files.
216
217 A module should export a C-callable function named
218 `emacs_module_init', which Emacs will call as part of the call to
219 `load' or `require' which loads the module. It should also export a
220 symbol named `plugin_is_GPL_compatible' to indicate that its code is
221 released under the GPL or compatible license; Emacs will refuse to
222 load modules that don't export such a symbol.
223
224 If a module needs to call Emacs functions, it should do so through the
225 API defined and documented in the header file `emacs-module.h'. Note
226 that any module that provides Lisp-callable functions will have to use
227 Emacs functions such as `fset' and `funcall', in order to register its
228 functions with the Emacs Lisp interpreter.
229
230 Modules can create `user-ptr' Lisp objects that embed pointers to C
231 struct's defined by the module. This is useful for keeping around
232 complex data structures created by a module, to be passed back to the
233 module's functions. User-ptr objects can also have associated
234 "finalizers" -- functions to be run when the object is GC'ed; this is
235 useful for freeing any resources allocated for the underlying data
236 structure, such as memory, open file descriptors, etc. A new
237 predicate `user-ptr-p' returns non-nil if its argument is a `usr-ptr'
238 object.
239
240 Loadable modules in Emacs are an experimental feature, and subject to
241 change in future releases. For that reason, their support is disabled
242 by default, and must be enabled by using the `--with-modules' option
243 at configure time.
244
245 ** New input method: `tamil-dvorak'.
246
247 \f
248 * Editing Changes in Emacs 25.1
249
250 +++
251 ** M-x suggests shorthands and ignores obsolete commands for completion.
252
253 ** Successive single-char deletions are collapsed in the undo-log just like
254 successive char insertions. This behaviour can be extended to other
255 commands, using the `undo-auto--amalgamate' function.
256
257 ** The heuristic used to insert `undo-boundary' after each command has changed,
258 so that it supports commands which potentially affect multiple buffers.
259
260 +++
261 ** New command `comment-line' bound to `C-x C-;'.
262
263 ** Unicode names entered via C-x 8 RET now use substring completion by default.
264
265 ** C-x 8 now has shorthands for these chars: ‐ ‑ ‒ – — ― ‘ ’ “ ” † ‡ • ′ ″
266 € № ← → ↔ − ≈ ≠ ≤ ≥. As before, you can type C-x 8 C-h to list shorthands.
267
268 ** New minor mode electric-quote-mode for quoting ‘like this’ and “like this”
269 as you type. See also the new variable ‘text-quoting-style’.
270
271 ** New minor mode global-eldoc-mode is enabled by default.
272
273 ** Emacs now supports "bracketed paste mode" when running on a terminal
274 that supports it. This facility allows Emacs to understand pasted
275 chunks of text as strings to be inserted, instead of interpreting each
276 character in the pasted text as actual user input. This results in a
277 paste experience similar to that under a window system, and significant
278 performance improvements when pasting large amounts of text.
279
280 ** Emacs now supports the latest version of the UBA.
281 The Emacs implementation of the Unicode Bidirectional Algorithm (UBA)
282 was updated to support all the latest additions and changes introduced
283 in Unicode Standard versions 6.3, 7.0, and the latest Unicode 8.0.
284 This includes full support for directional isolates and the
285 Bidirectional Parentheses Algorithm (BPA) specified by these Unicode
286 standards.
287
288 ** You can access `mouse-buffer-menu' (C-down-mouse-1) using C-f10.
289
290 +++
291 ** New buffer-local `electric-pair-local-mode'.
292
293 +++
294 ** New variable `fast-but-imprecise-scrolling' inhibits
295 fontification during full screen scrolling operations, giving less
296 hesitant operation during auto-repeat of C-v, M-v at the cost of
297 possible inaccuracies in the end position.
298
299 \f
300 * Changes in Specialized Modes and Packages in Emacs 25.1
301
302 ** Checkdoc
303
304 +++
305 *** New command `checkdoc-package-keywords' checks if the
306 current package keywords are recognized. Set the new option
307 `checkdoc-package-keywords-flag' to non-nil to make
308 `checkdoc-current-buffer' call this function automatically.
309
310 +++
311 *** New function `checkdoc-file' checks for style errors.
312 It's meant for use together with `compile':
313 emacs -batch --eval "(checkdoc-file \"subr.el\")"
314
315 ** New function `bookmark-set-no-overwrite' bound to C-x r M.
316 It raises an error if a bookmark of that name already exists,
317 unlike `bookmark-set' which silently updates an existing bookmark.
318
319 ** JSON
320 ---
321 *** `json-pretty-print' and `json-pretty-print-buffer' now maintain
322 the ordering of object keys by default.
323 ---
324 *** New commands `json-pretty-print-ordered' and
325 `json-pretty-print-buffer-ordered' pretty prints JSON objects with
326 object keys sorted alphabetically.
327
328 ** You can recompute the VC state of a file buffer with `M-x vc-refresh-state'
329 ** Prog mode has some support for multi-mode indentation.
330 See `prog-indentation-context' and `prog-widen'.
331
332 ** Prettify Symbols mode
333 *** Prettify Symbols mode supports custom composition predicates. By
334 overriding the default `prettify-symbols-compose-predicate', modes can
335 specify in which contexts a symbol map be composed to some unicode
336 character. `prettify-symbols-default-compose-p' is the default which
337 is suitable for most programming languages such as C or Lisp (but not
338 (La)TeX).
339
340 *** Symbols can be unprettified while point is inside them.
341 New variable `prettify-symbols-unprettify-at-point' configures this.
342
343 ** New `xterm-screen-extra-capabilities' config.
344
345 ** The `save-place' variable is replaced by a `save-place-mode'.
346
347 ** ERC
348
349 *** Hide message types by network or channel. `erc-hide-list' will
350 hide all messages of the specified type, where `erc-network-hide-list'
351 and `erc-channel-hide-list' will only hide the specified message types
352 for the respective specified targets.
353
354 ** Midnight-mode
355 *** `midnight-mode' is a proper minor mode.
356 *** clean-buffer-*-regexps can now specify buffers via predicate functions.
357
358 ** In xterms, killing text now also sets the CLIPBOARD/PRIMARY selection
359 in the surrounding GUI (using the OSC-52 escape sequence). This only works
360 if your xterm supports it and enables the `allowWindowOps' options (disabled
361 by default at least in Debian, for security reasons).
362
363 Similarly, you can yank the CLIPBOARD/PRIMARY selection (using the OSC-52
364 escape sequence) if your xterm has the feature enabled but for that you
365 additionally need to add `getSelection' to `xterm-extra-capabilities'.
366
367 ** xterm-mouse-mode now supports mouse-tracking (if your xterm supports it).
368
369 ** package.el
370
371 *** New "external" package status.
372 An external package is any installed package that's not built-in and
373 not from `package-user-dir', which usually means it's from an entry in
374 `package-directory-list'. They are treated much like built-in
375 packages, in that they cannot be deleted through the package menu and
376 are not considered for upgrades.
377
378 The effect, is that a user can manually place a specific version of a
379 package inside `package-directory-list' and the package menu will
380 always respect that.
381
382 *** If a package is available on multiple archives and one has higher
383 priority (as per `package-archive-priorities') only that one is
384 listed. This can be configured with `package-menu-hide-low-priority'.
385
386 *** `package-menu-toggle-hiding' now toggles the hiding of packages.
387 This includes the above-mentioned low-priority packages, as well as
388 available packages whose version is lower than the currently installed
389 version (which were previously impossible to display).
390 This allows users to downgrade a package if a lower version is
391 available.
392
393 *** When filtering the package menu, keywords starting with "arc:" or
394 "status:" represent package archive or status, respectively, instead
395 of actual keywords.
396
397 *** Most functions which involve downloading information now take an
398 ASYNC argument. If it is non-nil, package.el performs the download(s)
399 asynchronously.
400
401 *** New variable `package-menu-async' controls whether the
402 package-menu uses asynchronous downloads.
403
404 *** `package-install-from-buffer' and `package-install-file' work on directories.
405 This follows the same rules as installing from a .tar file, except the
406 -pkg file is optional.
407
408 *** Packages which are dependencies of other packages cannot be deleted.
409 The FORCE argument to `package-delete' overrides this.
410
411 *** New custom variable `package-selected-packages' tracks packages
412 which were installed by the user (as opposed to installed as
413 dependencies). This variable can also be manually customized.
414
415 *** New command `package-install-user-selected-packages' installs all
416 packages from `package-selected-packages' which are currently missing.
417
418 *** New command `package-autoremove' removes all packages which were
419 installed strictly as dependencies but are no longer needed.
420
421 ** Shell
422
423 When you invoke `shell' interactively, the *shell* buffer will now
424 display in a new window. However, you can customize this behavior via
425 the `display-buffer-alist' variable. For example, to get
426 the old behavior -- *shell* buffer displays in current window -- use
427 (add-to-list 'display-buffer-alist
428 '("^\\*shell\\*$" . (display-buffer-same-window))).
429
430 ** EIEIO
431 +++
432 *** The `:protection' slot option is not obeyed any more.
433 +++
434 *** The `newname' argument to constructors is optional&deprecated.
435 If you need your objects to be named, do it by inheriting from `eieio-named'.
436 +++
437 *** The <class>-list-p and <class>-child-p functions are declared obsolete.
438 +++
439 *** The <class> variables are declared obsolete.
440 +++
441 *** The <initarg> variables are declared obsolete.
442 *** defgeneric and defmethod are declared obsolete.
443 +++
444 *** `constructor' is now an obsolete alias for `make-instance'.
445
446 ** ido
447 *** New command `ido-bury-buffer-at-head' bound to C-S-b
448 Bury the buffer at the head of `ido-matches', analogous to how C-k
449 kills the buffer at head.
450 *** A prefix argument to `ido-restrict-to-matches' will reverse its
451 meaning, and the list is restricted to those elements that do not
452 match the current input.
453
454 ** Minibuffer
455
456 *** You can use <up> and <down> keys to move point in the multi-line
457 minibuffer just as in an ordinary buffer. Only when point moves over
458 the bottom/top of the minibuffer it goes to the next/previous history
459 element. The new commands bound to <up> and <down> in the minibuffer:
460 `next-line-or-history-element' and `previous-line-or-history-element'.
461
462 ** Search and Replace
463
464 +++
465 *** New user option `search-default-regexp-mode'
466 specifies the default mode for I-search.
467
468 +++
469 *** `isearch' and `query-replace' can now perform character folding in matches.
470 Isearch does that by default, while `query-replace' will do that if
471 the new variable `replace-character-fold' is customized to a non-nil
472 value. This is analogous to case folding, but instead of disregarding
473 case variants, it disregards wider classes of distinctions between
474 similar characters. (Case folding is a special case of character
475 folding.) This means many characters in the search string will match
476 entire groups of characters instead of just themselves.
477
478 For instance, the " will match all variants of double quotes (like “
479 and ”), and the letter a will match all of its accented cousins, even
480 those composed of multiple characters, as well as many other symbols
481 like ℀, ℁, ⒜, and ⓐ.
482
483 +++
484 *** New function `character-fold-to-regexp' can be used
485 by searching commands to produce a regexp matching anything that
486 character-folds into STRING.
487
488 +++
489 *** The new M-s M-w key binding uses eww to search the web for the
490 text in the region. The search engine to use for this is specified by
491 the customizable variable `eww-search-prefix'.
492
493 +++
494 *** Query-replace history is enhanced.
495 When query-replace reads the FROM string from the minibuffer, typing
496 `M-p' will now show previous replacements as "FROM SEP TO", where FROM
497 and TO are the original text and its replacement, and SEP is an arrow
498 string defined by the new variable `query-replace-from-to-separator'.
499 To select a prior replacement, type `M-p' until the desired
500 replacement appears in the minibuffer, and then exit the minibuffer by
501 typing RET.
502
503 ** Calc
504 +++
505 *** If `quick-calc' is called with a prefix argument, insert the
506 result of the calculation into the current buffer.
507
508 +++
509 ** In Edebug, you can now set the initial mode with C-x C-a C-m. With
510 this you can tell Edebug not to stop at the start of the first
511 instrumented function.
512
513 ** ElDoc
514 *** New minor mode `global-eldoc-mode'
515 *** `eldoc-documentation-function' now defaults to `ignore'
516 *** `describe-char-eldoc' displays information about character at point,
517 and can be used as a default value of `eldoc-documentation-function'. It is
518 useful when, for example, one needs to distinguish various spaces (e.g. ] [,
519 ] [, ] [, etc.) while using mono-spaced font.
520
521 ** eww
522
523 ---
524 *** HTML can now be rendered using variable-width fonts.
525
526 +++
527 *** A new command `F' (`eww-toggle-fonts') can be used to toggle
528 whether to use variable-pitch fonts or not. The user can also
529 customize the `shr-use-fonts' variable.
530
531 +++
532 *** A new command `R' (`eww-readable') will try do identify the main
533 textual parts of a web page and display only that, leaving menus and
534 the like off the page.
535
536 ---
537 *** You can now use several eww buffers in parallel by renaming eww
538 buffers you want to keep separate.
539
540 +++
541 *** Partial state of the eww buffers (the URIs and the titles of the
542 pages visited) is now preserved in the desktop file.
543
544 +++
545 *** `eww-after-render-hook' is now called after eww has rendered
546 the data in the buffer.
547
548 ---
549 *** The `eww-reload' command now takes a prefix to not reload via
550 the net, but just use the local copy of the HTML.
551
552 +++
553 *** The DOM shr and eww uses has been changed to the general Emacs
554 xml.el/libxml2 DOM, and a new package dom.el has been added to
555 interact with this DOM. See the Emacs Lisp manual for interface
556 details.
557
558 +++
559 *** `mailcap-mime-data' is now consulted when displaying PDF files.
560
561 +++
562 *** The new `S' command will list all eww buffers, and allow managing
563 them.
564
565 ---
566 *** https pages with valid certificates have headers marked in green, while
567 invalid certificates are marked in red.
568
569 ** Message mode
570
571 *** text/html messages that contain inline image parts will be
572 transformed into multipart/related messages before sending.
573
574 ** pcase
575 *** New UPatterns `quote', `app', `cl-struct', and `eieio'.
576 *** New UPatterns can be defined with `pcase-defmacro'.
577 +++
578 *** New vector QPattern.
579
580 ** Lisp mode
581 *** Strings after `:documentation' are highlighted as docstrings.
582
583 ** Rectangle editing
584 *** Rectangle Mark mode can have corners past EOL or in the middle of a TAB.
585 *** C-x C-x in rectangle-mark-mode now cycles through the four corners.
586 *** `string-rectangle' provides on-the-fly preview of the result.
587
588 ** New font-lock functions font-lock-ensure and font-lock-flush, which
589 should be used instead of font-lock-fontify-buffer when called from Elisp.
590
591 ** Macro `minibuffer-with-setup-hook' takes (:append FUN) to mean
592 appending FUN to `minibuffer-setup-hook'.
593
594 ** cl-lib
595 *** New functions cl-fresh-line, cl-digit-char-p and cl-parse-integer.
596
597 ** Calendar and diary
598
599 +++
600 *** The default `diary-file' is now located in .emacs.d.
601
602 +++
603 *** New commands to insert diary entries with Chinese dates:
604 `diary-chinese-insert-anniversary-entry' `diary-chinese-insert-entry'
605 `diary-chinese-insert-monthly-entry', `diary-chinese-insert-yearly-entry'.
606
607 +++
608 *** The calendar can now list and mark diary entries with Chinese dates.
609 See `diary-chinese-list-entries' and `diary-chinese-mark-entries'.
610
611 ---
612 *** The option `calendar-mode-line-format' can now be nil,
613 which means to do nothing special with the mode line in calendars.
614
615 +++
616 *** New option `calendar-weekend-days'.
617 The option customizes which day headers receive the
618 `calendar-weekend-header' face.
619
620 ---
621 *** New optional args N and STRING for ‘holiday-greek-orthodox-easter’.
622
623 ---
624 *** Many items obsolete since at least version 23.1 have been removed.
625 The majority were function/variable/face aliases, too numerous to list here.
626 The remainder were:
627
628 **** Functions `calendar-one-frame-setup', `calendar-only-one-frame-setup',
629 `calendar-two-frame-setup', `european-calendar', `american-calendar'.
630
631 **** Hooks `cal-menu-load-hook', `cal-x-load-hook'.
632
633 **** Macro `calendar-for-loop'.
634
635 **** Variables `european-calendar-style', `diary-face', `hebrew-holidays-{1,4}'.
636
637 **** The nil and list forms of `diary-display-function'.
638
639 ** New ERT function `ert-summarize-tests-batch-and-exit'.
640
641 ** New js.el option `js-indent-first-init'.
642
643 ---
644 ** `Info-fontify-maximum-menu-size' can be t for no limit.
645
646 +++
647 ** `info-display-manual' can now be given a prefix argument which (any
648 non-nil value) directs the command to limit the completion
649 alternatives to currently visited manuals.
650
651 ---
652 ** ntlm.el has support for NTLM2.
653
654 ** Rmail
655
656 *** The Rmail commands d, C-d and u take optional repeat counts to delete or
657 undelete multiple messages.
658
659 *** Rmail can now render HTML mail messages if your Emacs was built with
660 libxml2 or if you have the Lynx browser installed. By default, Rmail
661 will display the HTML version of a mail message that has both HTML and
662 plain text parts, if display of HTML email is possible; customize the
663 `rmail-mime-prefer-html' option to `nil' if you don't want that.
664
665 +++
666 *** In the commands that make summaries by subject, recipients, or senders,
667 you can no longer use commas to separate regular expressions.
668
669 ** SES now supports local printer functions; see `ses-define-local-printer'.
670
671 ** sh-script
672 *** In sh-mode you can now use `sh-shell' as a file-local variable to
673 specify the type of shell in use (bash, csh, etc).
674
675 *** New value `always' for sh-indent-after-continuation.
676 This provides old-style ("dumb") indentation of continued lines.
677
678 ** TLS
679 ---
680 *** Fatal TLS errors are now silent by default.
681
682 ** URL
683
684 *** The URL package accepts now the protocols "ssh", "scp" and "rsync".
685 When `url-handler-mode' is enabled, file operations for these
686 protocols as well as for "telnet" and "ftp" are passed to Tramp.
687
688 *** The URL package allows customizing the `url-user-agent' string.
689 The new `url-user-agent' variable can be customized to be a string or
690 a function.
691
692 *** The new interface variable `url-request-noninteractive' can be used
693 to specify that we're running in a noninteractive context, and that
694 we should not be queried about things like TLS certificate validity.
695
696 *** If URL is used with a https connection, the first callback argument
697 plist will contain a :peer element that has the output of
698 `gnutls-peer-status' (if Emacs is built with GnuTLS support).
699
700 ** Tramp
701
702 +++
703 *** New connection method "afp", which allows to access Mac OS X
704 volumes via the Apple Filing Protocol.
705
706 +++
707 *** New connection method "nc", which allows to access dumb busyboxes.
708
709 +++
710 *** Method-specific parameters can be overwritten now with variable
711 `tramp-connection-properties'.
712
713 ---
714 *** Handler for `file-notify-valid-p' for remote machines that support
715 filesystem notifications.
716
717 ** SQL mode
718
719 *** New user variable `sql-default-directory' enables remote
720 connections using Tramp.
721
722 *** New command `sql-send-line-and-next' sends the current line to the
723 interactive buffer and advances to the next line, skipping whitespace
724 and comments.
725
726 *** Add support for Vertica SQL.
727
728 ** VC and related modes
729
730 *** Basic push support, via `vc-push', bound to `C-x v P'.
731 Implemented for Bzr, Git, Hg. As part of this change, the pre-existing
732 (undocumented) command vc-hg-push now behaves slightly differently.
733
734 *** The new command vc-region-history shows the log+diff of the active region.
735
736 *** New option `vc-annotate-background-mode' controls whether
737 the color range from `vc-annotate-color-map' is applied to the
738 background or to the foreground.
739
740 *** `compare-windows' now compares text with the most recently used window
741 instead of the next window. The new option `compare-windows-get-window-function'
742 allows to customize this.
743
744 *** Two new faces `compare-windows-removed' and `compare-windows-added'
745 replace the obsolete face `compare-windows'.
746
747 ---
748 *** `log-edit-insert-changelog' converts "(tiny change)" to
749 "Copyright-paperwork-exempt: yes". Set `log-edit-rewrite-tiny-change'
750 nil to disable this.
751
752 ** VHDL mode supports VHDL'08.
753
754 ** Calculator: decimal display mode uses "," groups, so it's more
755 fitting for use in money calculations; factorial works with
756 non-integer inputs.
757
758 ** HideIfDef mode now support full C/C++ expressions, argumented macro expansions,
759 interactive macro evaluation and automatic scanning of #defined symbols.
760
761 *** New custom variable `hide-ifdef-header-regexp' to define C/C++ header file
762 name patterns. Default case-insensitive .h, .hh, .hpp, .hxx, and .h++.
763 *** New custom variable `hide-ifdef-expand-reinclusion-protection' to prevent
764 reinclusion protected header files from being fully hidden.
765 *** New custom variable `hide-ifdef-exclude-define-regexp' to define symbol
766 name patterns (e.g. all "FOR_DOXYGEN_ONLY_*") to be excluded.
767
768 ** TeX mode
769
770 *** New custom variable `tex-print-file-extension' to help users who
771 use PDF instead of DVI.
772
773 *** TeX mode now supports Prettify Symbols mode. When enabling
774 `prettify-symbols-mode' in a tex-mode buffer, \alpha ... \omega, and
775 many other math macros are displayed using unicode characters.
776
777 ** whitespace-mode: new 'big-indent style highlighting too much indentation.
778 By default, 32 spaces and four TABs are considered to be too much but
779 `whitespace-big-indent-regexp' can be configured to change that.
780
781 ** tildify: `tildify-space-string', `tildify-pattern', and
782 `tildify-foreach-region-function' variables added making
783 `tildify-string-alist', `tildify-pattern-alist', and
784 `tildify-ignored-environments-alist' variables (as well as a few
785 helper functions) obsolete.
786
787 ** xref
788 The new package provides generic framework and new commands to find
789 and move to definitions, as well as pop back to the original location.
790
791 *** New key bindings
792 `xref-find-definitions' replaces `find-tag' and provides an interface
793 to pick one destination among several. Hence, `tags-loop-continue' is
794 unbound. `xref-pop-marker-stack' replaces `pop-tag-mark', but uses an
795 easier binding, which is now unoccupied (`M-,').
796 `xref-find-definitions-other-window' replaces `find-tag-other-window'.
797 `xref-find-definitions-other-frame' replaces `find-tag-other-frame'.
798 `xref-find-apropos' replaces `find-tag-regexp'.
799
800 *** New variables
801 `find-tag-marker-ring-length' is now an obsolete alias for
802 `xref-marker-ring-length'. `find-tag-marker-ring' is now an obsolete
803 alias for a private variable. `xref-push-marker-stack' and
804 `xref-pop-marker-stack' should be used to mutate it instead.
805
806 ** etags
807 As a result of the above, these commands are now obsolete:
808 `find-tag-other-window', `find-tag-other-frame', `find-tag-regexp',
809 `tags-apropos' and `tags-loop-continue'.
810
811 ** EUDC
812 EUDC's LDAP backend has been improved.
813
814 *** EUDC supports LDAP-over-SSL URLs (ldaps://).
815
816 *** EUDC passes LDAP passwords through a pipe to the ldapsearch
817 subprocess instead of on the command line.
818
819 *** EUDC handles LDAP wildcards automatically so the user shouldn't
820 need to configure this manually anymore.
821
822 *** The LDAP configuration section of EUDC's manual has been
823 rewritten.
824
825 There have also been customization changes.
826
827 *** New custom variable `eudc-server-hotlist' to allow specifying
828 multiple EUDC servers in init file.
829
830 *** Custom variable `eudc-inline-query-format' defaults to completing
831 on email and firstname instead of surname.
832
833 *** Custom variable `eudc-expansion-overwrites-query' defaults to nil
834 to avoid interfering with the kill ring.
835
836 *** Custom variable `eudc-inline-expansion-format' defaults to
837 "Firstname Surname <mail-address>".
838
839 *** Custom variable `eudc-options-file' defaults to
840 "~/.emacs.d/eudc-options".
841
842 *** New custom variable `ldap-ldapsearch-password-prompt-regexp' to
843 allow overriding the regular expression that recognizes the ldapsearch
844 command line's password prompt.
845
846 EUDC's BBDB backend now supports BBDB 3.
847
848 ** Eshell
849
850 +++
851 *** The new built-in command `clear' can scroll window contents out of sight.
852 If provided with an optional non-nil argument, the scrollback contents will be cleared.
853
854 *** New buffer syntax '#<buffer-name>', which is equivalent to
855 '#<buffer buffer-name>'. This shorthand makes interacting with
856 buffers from eshell more convenient. Custom variable
857 `eshell-buffer-shorthand', which has been broken for a while, has been
858 removed.
859
860 *** By default, eshell "visual" program buffers (created by
861 `eshell-visual-commands' and similar custom vars) are no longer killed
862 when their processes die. This fixes issues with short-lived commands
863 and makes visual programs more useful in general. For example, if
864 "git log" is a visual command, it will always show the visual command
865 buffer, even if the "git log" process dies. For the old behavior,
866 make the new option `eshell-destroy-buffer-when-process-dies' non-nil.
867
868 ** Browse-url
869
870 *** Support for the Conkeror web browser.
871
872 ---
873 *** Support for several ancient browsers is now officially obsolete.
874
875 +++
876 ** tar-mode: new `tar-new-entry' command, allowing for new members to
877 be added to the archive.
878
879 ---
880 ** Autorevert: dired buffers are also auto-reverted via file
881 notifications, if Emacs is compiled with file notification support.
882
883 ** File Notifications
884
885 +++
886 *** The new event `stopped' signals, that a file notification watch is
887 not active any longer.
888
889 +++
890 *** The new function `file-notify-valid-p' checks, whether a file
891 notification descriptor still corresponds to an activate watch.
892
893 ** Dired
894
895 +++
896 *** The command `dired-do-compress' bound to `Z' now can compress
897 directories and decompress zip files.
898
899 +++
900 *** New command `dired-do-compress-to' bound to `c' can be used to
901 compress many marked files into a single named archive. The
902 compression command is determined from the new
903 `dired-compress-files-alist' variable.
904
905 ** Tabulated List Mode
906
907 +++
908 *** It is now safe for a mode that derives `tabulated-list-mode' to not
909 call `tabulated-list-init-header', in which case it will have no
910 header.
911
912 +++
913 *** `tabulated-list-print' takes a second optional argument, update,
914 which specifies an alternative printing method which is faster when
915 few or no entries have changed.
916
917 ** Obsolete packages
918
919 ---
920 *** gulp.el
921
922 *** landmark.el (moved to elpa.gnu.org)
923
924 \f
925 * New Modes and Packages in Emacs 25.1
926
927 ** pinentry.el allows GnuPG passphrase to be prompted through the
928 minibuffer instead of a graphical dialog, depending on whether the gpg
929 command is called from Emacs (i.e., INSIDE_EMACS environment variable
930 is set). This feature requires newer versions of GnuPG (2.1.5 or
931 later) and Pinentry (0.9.5 or later).
932
933 ** cl-generic.el provides CLOS-style multiple-dispatch generic functions.
934
935 ** scss-mode (a minor variant of css-mode)
936
937 ** let-alist is a new macro (and a package) that allows one to easily
938 let-bind the values stored in an alist.
939
940 ** `tildify-mode' allows to automatically insert hard spaces as one
941 types the text. Breaking line after a single-character words is
942 forbidden by Czech and Polish typography (and may be discouraged in
943 other languages), so `auto-tildify-mode' makes it easier to create
944 a typographically-correct documents.
945
946 ** The `seq' library adds sequence manipulation functions and macros
947 that complement basic functions provided by subr.el. All functions
948 are prefixed with `seq-' and work on lists, strings and vectors.
949
950 ** The `map' library provides map-manipulation functions that work on
951 alists, hash-table and arrays. All functions are prefixed with
952 `map-'.
953
954 ** The `thunk' library provides functions and macros to control the
955 evaluation of forms.
956
957 ** js-jsx-mode (a minor variant of js-mode) provides indentation
958 support for JSX, an XML-like syntax extension to ECMAScript.
959
960 \f
961 * Incompatible Lisp Changes in Emacs 25.1
962
963 ---
964 ** `setq' and `setf' must now be called with an even number of
965 arguments. The earlier behavior of silently supplying a nil to the
966 last variable when there was an odd number of arguments has been
967 eliminated.
968
969 ** `syntax-begin-function' is declared obsolete.
970 Removed font-lock-beginning-of-syntax-function and the SYNTAX-BEGIN
971 slot in font-lock-defaults.
972
973 +++
974 ** `package-initialize' now sets `package-enable-at-startup' to nil if
975 called during startup. Users who call this function in their init
976 file and still expect it to be run after startup should set
977 `package-enable-at-startup' to t after the call to
978 `package-initialize'.
979
980 ** `:global' minor mode use `setq-default' rather than `setq'.
981 This means that you can't use `make-local-variable' and expect them to
982 "magically" become buffer-local.
983
984 ** `inhibit-point-motion-hooks' now defaults to t and is obsolete.
985
986 +++
987 ** `track-mouse' no longer freezes the shape of the mouse pointer.
988 The `track-mouse' form no longer refrains from changing the shape of
989 the mouse pointer for the entire time the body of that form is
990 executed. Lisp programs that use `track-mouse' for dragging across
991 large portions of the Emacs display, and want to avoid changes in the
992 pointer shape during dragging, should bind the variable `track-mouse'
993 to the special value `dragging' in the body of the form.
994
995 ---
996 ** The optional `predicate' argument of `lisp-complete-symbol' no longer
997 has any effect. (This change was made in Emacs 24.4 but was not
998 advertised at the time.)
999
1000 ** `indirect-function' does not signal `void-function' any more.
1001 This is mostly a bug-fix, since this change was missed back in 24.4 when
1002 symbol-function was changed not to signal `void-function' any more.
1003
1004 *** As a consequence, the second arg of `indirect-function' is now obsolete.
1005
1006 ** Comint, term, and compile do not set the EMACS env var any more.
1007 Use the INSIDE_EMACS environment variable instead.
1008
1009 ** `save-excursion' does not save&restore the mark any more.
1010
1011 ** read-buffer-function can now be called with a 4th argument (`predicate').
1012
1013 ** completion-table-dynamic stays in the minibuffer.
1014 If you want the old behavior of calling the function in the buffer
1015 from which the minibuffer was entered, call it with the new argument
1016 `switch-buffer'.
1017
1018 ** window-configurations no longer record the buffers' marks.
1019
1020 ** inhibit-modification-hooks now also inhibits lock-file checks, as well as
1021 active region handling.
1022
1023 ** deactivate-mark is now buffer-local.
1024
1025 ** `cl-the' now asserts that its argument is of the given type.
1026
1027 ** `process-running-child-p` may now return a numeric process
1028 group ID instead of `t'.
1029
1030 +++
1031 ** Mouse click events on mode line or header line no longer include
1032 any reference to a buffer position. The 6th member of the mouse
1033 position list returned for such events is now nil.
1034
1035 ** Menu items in keymaps do not support the "key shortcut cache" any more.
1036 These slots used to hold key-shortcut data, but have been obsolete since
1037 Emacs-21.
1038
1039 ** Emacs no longer downcases the first letter of a system diagnostic
1040 when signaling a file error. For example, it now reports "Permission
1041 denied" instead of "permission denied". The old behavior was problematic
1042 in languages like German where downcasing rules depend on grammar.
1043
1044 +++
1045 ** New variable ‘text-quoting-style’ to control how Emacs translates quotes.
1046 Set it to ‘curve’ for curved single quotes ‘like this’, to ‘straight’
1047 for straight apostrophes 'like this', and to ‘grave’ for grave accent
1048 and apostrophe `like this'. The default value nil acts like ‘curve’
1049 if curved single quotes are displayable, and like ‘grave’ otherwise.
1050 The new variable affects display of diagnostics and help, but not of info.
1051
1052 +++
1053 ** substitute-command-keys now replaces quotes.
1054 That is, it converts documentation strings’ quoting style as per the
1055 value of ‘text-quoting-style’. Doc strings in source code can use
1056 either curved single quotes or grave accents and apostrophes. As
1057 before, characters preceded by \= are output as-is.
1058
1059 +++
1060 ** Message-issuing functions ‘error’, ‘message’, etc. now convert quotes.
1061 They use the new ‘format-message’ function instead of plain ‘format’,
1062 so that they now follow user preference as per ‘text-quoting-style’
1063 when processing curved single quotes, grave accents, and apostrophes
1064 in their format argument.
1065
1066 +++
1067 ** The character classes [:alpha:] and [:alnum:] in regular expressions
1068 now match multibyte characters using Unicode character properties.
1069 If you want the old behavior where they matched any character with
1070 word syntax, use `\sw' instead.
1071
1072 +++
1073 ** The character classes [:graph:] and [:print:] in regular expressions
1074 no longer match every multibyte character. Instead, Emacs now
1075 consults the Unicode character properties to determine which
1076 characters are graphic or printable. In particular, surrogates and
1077 unassigned codepoints are now rejected. If you want the old behavior,
1078 use [:multibyte:] instead.
1079
1080 +++
1081 ** The `diff' command uses the unified format now. To restore the old
1082 behavior, set `diff-switches' to `-c'.
1083
1084 ** `grep-template' and `grep-find-template' values don't include the
1085 --color argument anymore. It's added at the <C> place holder position
1086 dynamically. Any third-party code that changes these templates should
1087 be updated accordingly.
1088
1089 +++
1090 ** ‘(/ N)’ is now equivalent to ‘(/ 1 N)’ rather than to ‘(/ N 1)’.
1091 The new behavior is compatible with Common Lisp and with XEmacs.
1092 This change does not affect Lisp code intended to be portable to
1093 Emacs 24.2 and earlier, which did not support unary ‘/’.
1094
1095 +++
1096 ** The `default-directory' value doesn't have to end slash. To make
1097 that happen, `unhandled-file-name-directory' now defaults to calling
1098 `file-name-as-directory'.
1099
1100 \f
1101 * Lisp Changes in Emacs 25.1
1102
1103 ** syntax-propertize is now automatically called on-demand during forward
1104 parsing functions like `forward-sexp'.
1105
1106 ** New hooks prefix-command-echo-keystrokes-functions and
1107 prefix-command-preserve-state-hook, to allow the definition of prefix
1108 commands other than the predefined C-u.
1109
1110 ** New functions `filepos-to-bufferpos' and `bufferpos-to-filepos'.
1111
1112 ** The default value of `load-read-function' is now `read'.
1113
1114 ** New hook `pre-redisplay-functions', a bit easier to use than pre-redisplay-function.
1115
1116 ** The second arg of `looking-back' should always be provided explicitly.
1117
1118 ** Obsolete text properties `intangible', `point-entered', and `point-left'.
1119 Replaced by properties `cursor-intangible' and `cursor-sensor-functions',
1120 implemented by the new `cursor-intangible-mode' and
1121 `cursor-sensor-mode' minor modes.
1122
1123 ** New process type `pipe', which can be used in combination with the
1124 `:stderr' keyword of make-process to handle standard error output
1125 of subprocess.
1126
1127 ** New function `make-process' provides an alternative interface to
1128 `start-process'. It allows programs to set process parameters such as
1129 process filter, sentinel, etc., through keyword arguments (similar to
1130 `make-network-process').
1131
1132 +++
1133 ** A new function `directory-files-recursively' returns all matching
1134 files (recursively) under a directory.
1135
1136 +++
1137 ** New variable `inhibit-message', when bound to non-nil, inhibits
1138 `message' and related functions from displaying messages the Echo
1139 Area. The output is still logged to the *Messages* buffer.
1140
1141 +++
1142 ** A new text property `inhibit-read-only' can be used in read-only
1143 buffers to allow certain parts of the text to be writable.
1144
1145 ** `read-buffer' takes a new `predicate' argument.
1146
1147 ** Emacs Lisp now supports generators.
1148
1149 ** New finalizer facility for running code when objects
1150 become unreachable.
1151
1152 ** lexical closures can use (:documentation <form>) to build their docstring.
1153 It should be placed right where the docstring would be, and <form> is then
1154 evaluated (and should return a string) when the closure is built.
1155
1156 ** define-inline provides a new way to define inlinable functions.
1157
1158 ** New function `macroexpand-1' to perform a single step of macroexpansion.
1159
1160 ** Some "x-*" were obsoleted:
1161 *** x-select-text is renamed gui-select-text.
1162 *** x-selection-value is renamed gui-selection-value.
1163 *** x-get-selection is renamed gui-get-selection.
1164 *** x-get-clipboard and x-clipboard-yank are marked obsolete.
1165 *** x-get-selection-value is renamed to gui-get-primary-selection.
1166 *** x-set-selection is renamed to gui-set-selection
1167
1168 ** New function `string-greaterp', which return the opposite result of
1169 `string-lessp'.
1170
1171 +++
1172 ** The new functions `string-collate-lessp' and `string-collate-equalp'
1173 preserve the collation order as defined by the system's locale(1)
1174 environment. For the time being this is implemented for modern POSIX
1175 systems and for MS-Windows, for other systems they fall back to their
1176 counterparts `string-lessp' and `string-equal'.
1177
1178 ---
1179 *** The ls-lisp package uses `string-collate-lessp' to sort file names.
1180 If you want the old, locale-independent sorting, customize the new
1181 option `ls-lisp-use-string-collate' to a nil value.
1182
1183 +++
1184 *** The MS-Windows specific variable `w32-collate-ignore-punctuation',
1185 if set to a non-nil value, causes the above 2 functions to ignore
1186 symbol and punctuation characters when collating strings. This
1187 emulates the behavior of modern Posix platforms when the locale's
1188 codeset is "UTF-8" (as in "en_US.UTF-8"). This is needed because
1189 MS-Windows doesn't support UTF-8 as codeset in its locales.
1190
1191 ** New function `alist-get', which is also a valid place (aka lvalue).
1192
1193 ** New function `funcall-interactively', which works like `funcall'
1194 but makes `called-interactively-p' treat the function as (you guessed it)
1195 called interactively.
1196
1197 ** New function `function-put' to use instead of `put' for function properties.
1198
1199 +++
1200 ** The new function `bidi-find-overridden-directionality' allows to
1201 find characters whose directionality was, perhaps maliciously,
1202 overridden by directional override control characters. Lisp programs
1203 can use this to detect potential phishing of URLs and other links that
1204 exploits bidirectional display reordering.
1205
1206 +++
1207 ** The new function `buffer-substring-with-bidi-context' allows to
1208 copy a portion of a buffer into a different location while preserving
1209 the visual appearance both of the copied text and the text at
1210 destination, even when the copied text includes mixed bidirectional
1211 text and directional control characters.
1212
1213 +++
1214 ** New properties that can be specified with `declare':
1215 *** (interactive-only INSTEAD), says to use INSTEAD for non-interactive use.
1216 *** (pure VAL), if VAL is non-nil, indicates the function is pure.
1217 *** (side-effect-free VAL), if VAL is non-nil, indicates the function does not
1218 have side effects.
1219
1220 +++
1221 ** New macro `with-file-modes', for evaluating expressions with default file
1222 permissions set to temporary values (e.g., for creating private files).
1223
1224 ** You can access the slots of structures using `cl-struct-slot-value'.
1225
1226 ** Function `sort' can deal with vectors.
1227
1228 ** Function `system-name' now returns an updated value if the current
1229 system's name has changed or if the Emacs process has changed systems,
1230 and to avoid long waits it no longer consults DNS to canonicalize the
1231 name. The variable `system-name' is now obsolete.
1232
1233 +++
1234 ** Function `write-region' no longer outputs "Wrote FILE" in batch mode.
1235
1236 ** If `pwd' is called with a prefix argument, insert the current default
1237 directory at point.
1238
1239 ---
1240 ** New utilities in subr-x.el:
1241 *** New macros `if-let' and `when-let' allow defining bindings and to
1242 execute code depending whether all values are true.
1243 *** New macros `thread-first' and `thread-last' allow threading a form
1244 as the first or last argument of subsequent forms.
1245
1246 +++
1247 ** Documentation strings now support quoting with curved single quotes
1248 ‘like-this’ in addition to the old style with grave accent and
1249 apostrophe `like-this'. The new style looks better on today's displays.
1250 In the new Electric Quote mode, you can enter curved single quotes
1251 into documentation by typing ` and '. Outside Electric Quote mode,
1252 you can enter them by typing ‘C-x 8 [’ and ‘C-x 8 ]’, or (if your Alt
1253 key works) by typing ‘A-[’ and ‘A-]’. As described above under
1254 ‘text-quoting-style’, the user can specify how to display doc string
1255 quotes.
1256
1257 +++
1258 ** New function ‘format-message’ is like ‘format’ and also converts
1259 curved single quotes, grave accents and apostrophes as per
1260 ‘text-quoting-style’.
1261
1262 +++
1263 ** show-help-function's arg is converted via substitute-command-keys
1264 before being passed to the function. Help strings, help-echo
1265 properties, etc. can therefore contain command key escapes and
1266 quotation marks.
1267
1268 +++
1269 ** Time-related changes:
1270
1271 *** Time conversion functions now accept an optional ZONE argument
1272 that specifies the time zone rules for conversion. ZONE is omitted or
1273 nil for Emacs local time, t for Universal Time, ‘wall’ for system wall
1274 clock time, or a string as in ‘set-time-zone-rule’ for a time zone
1275 rule. The affected functions are ‘current-time-string’,
1276 ‘current-time-zone’, ‘decode-time’, and ‘format-time-string’. The
1277 function ‘encode-time’, which already accepted a simple time zone rule
1278 argument, has been extended to accept all the new forms.
1279
1280 *** Time-related functions now consistently accept numbers
1281 (representing seconds since the epoch) and nil (representing the
1282 current time) as well as the usual list-of-integer representation.
1283 Affected functions include `current-time-string', `current-time-zone',
1284 `decode-time', `float-time', `format-time-string', `seconds-to-time',
1285 `time-add', `time-less-p', `time-subtract', `time-to-day-in-year',
1286 `time-to-days', and `time-to-seconds'.
1287
1288 *** The `encode-time-value' and `with-decoded-time-value' macros have
1289 been obsoleted.
1290
1291 *** `calendar-next-time-zone-transition', `time-add', and
1292 `time-subtract' no longer return time values in the obsolete and
1293 undocumented integer-pair format. Instead, they return a list of two
1294 integers.
1295
1296 +++
1297 ** New function `set-binary-mode' allows to switch a standard stream
1298 of the Emacs process to binary I/O mode.
1299
1300 +++
1301 ** The new function `directory-name-p' can be used to check whether a file
1302 name (as returned from, for instance, `file-name-all-completions') is
1303 a directory file name. It returns non-nil if the last character in
1304 the name is a directory separator character (forward slash on GNU and
1305 Unix systems, forward- or backslash on MS-Windows and MS-DOS).
1306
1307 ** ASCII approximations to curved quotes are put in standard-display-table
1308 if the terminal cannot display curved quotes.
1309
1310 ** Standard output and error streams now transliterate characters via
1311 standard-display-table, and encode output using locale-coding-system.
1312
1313 +++
1314 ** New var `truncate-string-ellipsis' to choose how to indicate truncation.
1315
1316 ** Miscellaneous name change
1317
1318 For consistency with the usual Emacs spelling, the Lisp variable
1319 `hfy-optimisations' has been renamed to `hfy-optimizations'.
1320 The old name should still work, as an obsolescent alias.
1321
1322 \f
1323 * Changes in Frames and Windows Code in Emacs 25.1
1324
1325 +++
1326 ** Emacs can now draw horizontal scroll bars on some platforms that
1327 provide toolkit scroll bars, namely Gtk+, Lucid, Motif and Windows.
1328 Horizontal scroll bars are turned off by default.
1329 *** New function `horizontal-scroll-bars-available-p' telling whether
1330 horizontal scroll bars are available on the underlying system.
1331 *** New mode `horizontal-scroll-bar-mode' to toggle horizontal scroll
1332 bars on all existing and future frames.
1333 *** New function `toggle-horizontal-scroll-bar' to toggle horizontal
1334 scroll bars on the selected frame.
1335 *** New frame parameters `horizontal-scroll-bars' and
1336 `scroll-bar-height' to set horizontal scroll bars and their height
1337 for individual frames and in `default-frame-alist'.
1338 *** New functions `frame-scroll-bar-height' and
1339 `window-scroll-bar-height' return the height of horizontal scroll
1340 bars on a specific frame or window.
1341 *** `set-window-scroll-bars' now accepts five parameters where the last
1342 two specify height and type of the window's horizontal scroll bar.
1343 *** `window-scroll-bars' now returns type and sizes of horizontal scroll
1344 bars too.
1345 *** New buffer-local variables `horizontal-scroll-bar' and
1346 `scroll-bar-height'.
1347
1348 +++
1349 ** New functions `frame-geometry' and `frame-edges' give access to a
1350 frame's geometry.
1351
1352 +++
1353 ** New functions `mouse-absolute-pixel-position' and
1354 `set-mouse-absolute-pixel-position' get/set screen coordinates of the
1355 mouse cursor.
1356
1357 +++
1358 ** The function `window-edges' now accepts three additional arguments to
1359 retrieve body, absolute and pixel edges of the window.
1360
1361 +++
1362 ** The functions `window-inside-edges', `window-inside-pixel-edges' and
1363 `window-inside-absolute-pixel-edges' have been renamed to respectively
1364 `window-body-edges', `window-body-pixel-edges' and
1365 `window-absolute-body-pixel-edges'. The old names are kept as aliases.
1366
1367 +++
1368 ** New function `window-absolute-pixel-position' to get the screen
1369 coordinates of a visible buffer position.
1370
1371 +++
1372 ** The height of a frame's menu and tool bar are no longer counted in the
1373 frame's text height. This means that the text height stands only for
1374 the height of the frame's root window plus that of the echo area (if
1375 present). This was already the behavior for frames with external tool
1376 and menu bars (like in the Gtk builds) but has now been extended to all
1377 builds.
1378
1379 +++
1380 ** Frames now do not necessarily preserve the number of columns or lines
1381 they display when setting default font, menu bar, fringe width, or
1382 scroll bars. In particular, maximized and fullscreen frames are
1383 conceptually never resized if such settings change. For fullheight and
1384 fullwidth frames, the behavior may depend on the toolkit used.
1385 *** New option `frame-inhibit-implied-resize' if non-nil, means that
1386 setting default font, menu bar, fringe width, or scroll bars of a
1387 specific frame does not resize that frame in order to preserve the
1388 number of columns or lines it displays.
1389
1390 +++
1391 ** New function `window-preserve-size' allows to preserve the size of
1392 windows without "fixing" it. It's supported by `fit-window-to-buffer',
1393 `temp-buffer-resize-mode' and `display-buffer'.
1394
1395 +++
1396 ** New minor mode `window-divider-mode' and options
1397 `window-divider-default-places', `window-divider-default-bottom-width'
1398 and `window-divider-default-right-width'.
1399
1400 +++
1401 ** New option `switch-to-buffer-in-dedicated-window' allows to customize
1402 how `switch-to-buffer' proceeds interactively when the selected window
1403 is strongly dedicated to its buffer.
1404
1405 +++
1406 ** The option `even-window-heights' has been renamed to
1407 `even-window-sizes' and now handles window widths as well.
1408
1409 ** Tearoff menus and detachable toolbars for Gtk+ has been removed.
1410 Those features have been deprecated in Gtk+ for a long time.
1411
1412 ** Miscellaneous
1413
1414 *** etags no longer qualifies class members by default.
1415 By default, `etags' will not qualify class members for C-like
1416 object-oriented languages with their class names and namespaces, and
1417 will remove qualifications used explicitly in the code from the tag
1418 names it puts in TAGS files. This is so the etags.el back-end for
1419 `xref-find-definitions' is more accurate and produces less false
1420 positives.
1421
1422 Use --class-qualify (-Q) if you want the old default behavior of
1423 qualifying class members in C++, Java, and Objective C. Note that
1424 using -Q might make some class members become "unknown" to `M-.'
1425 (`xref-find-definitions'); if so, you can use `C-u M-.' to specify the
1426 qualified names by hand.
1427
1428 \f
1429 * Changes in Emacs 25.1 on Non-Free Operating Systems
1430
1431 ---
1432 ** MS-Windows specific Emacs build scripts are no longer in the distribution
1433 This includes the makefile.w32-in files in various subdirectories, and
1434 the support files. The file nt/configure.bat now just tells the user
1435 to use the procedure described in nt/INSTALL, by running the Posix
1436 `configure' script in the top-level directory.
1437
1438 ---
1439 ** Building Emacs for MS-Windows requires at least Windows XP
1440 or Windows Server 2003. The built binaries still run on all versions
1441 of Windows starting with Windows 9X.
1442
1443 +++
1444 ** Emacs running on MS-Windows now supports the daemon mode.
1445
1446 ** The byte counts in etags-generated TAGS files are now the same on
1447 MS-Windows as they are on other platforms.
1448
1449 ---
1450 ** On OS X, configure creates a Cocoa ("Nextstep") build by default.
1451 Pass '--without-ns' to configure to create an X11 build, the old default.
1452
1453 ** OS X 10.5 or older is no longer supported.
1454
1455 ** OS X on PowerPC is no longer supported.
1456
1457 ---
1458 ** New variable `ns-use-fullscreen-animation' controls animation for
1459 non-native NS fullscreen. The default is nil. Set to t to enable
1460 animation when entering and leaving fullscreen. For native OSX fullscreen
1461 this has no effect.
1462
1463 ---
1464 ** The new function 'w32-application-type' returns the type of an
1465 MS-Windows application given the name of its executable program file.
1466
1467 \f
1468 ----------------------------------------------------------------------
1469 This file is part of GNU Emacs.
1470
1471 GNU Emacs is free software: you can redistribute it and/or modify
1472 it under the terms of the GNU General Public License as published by
1473 the Free Software Foundation, either version 3 of the License, or
1474 (at your option) any later version.
1475
1476 GNU Emacs is distributed in the hope that it will be useful,
1477 but WITHOUT ANY WARRANTY; without even the implied warranty of
1478 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1479 GNU General Public License for more details.
1480
1481 You should have received a copy of the GNU General Public License
1482 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
1483
1484 \f
1485 Local variables:
1486 coding: utf-8
1487 mode: outline
1488 paragraph-separate: "[ \f]*$"
1489 end: