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

Paul Eggert's avatar
Paul Eggert committed
3
Copyright (C) 2014-2015 Free Software Foundation, Inc.
4
See the end of the file for license conditions.
Dave Love's avatar
#  
Dave Love committed
5

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

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

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

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

Glenn Morris's avatar
Glenn Morris committed
17
Temporary note:
Glenn Morris's avatar
Glenn Morris committed
18 19
+++ indicates that all necessary documentation updates are complete.
    (This means all relevant manuals in doc/ AND lisp doc-strings.)
20
--- means no change in the manuals is needed.
Glenn Morris's avatar
Glenn Morris committed
21
When you add a new item, use the appropriate mark if you are sure it applies,
22
otherwise leave it unmarked.
Glenn Morris's avatar
Glenn Morris committed
23

24

Stefan Monnier's avatar
Stefan Monnier committed
25
* Installation Changes in Emacs 25.1
26

Glenn Morris's avatar
Glenn Morris committed
27
+++
Paul Eggert's avatar
Paul Eggert committed
28 29
** Building Emacs now requires C99 or later.

30
** Building Emacs now requires GNU make, version 3.81 or later.
Glenn Morris's avatar
Glenn Morris committed
31

Paul Eggert's avatar
Paul Eggert committed
32 33 34 35 36 37 38
** By default, Emacs no longer works on IRIX.  We expect that Emacs
users are not affected by this, as SGI stopped supporting IRIX in
December 2013.  If you are affected, please send a bug report.  You
should be able to work around the problem either by porting the Emacs
undumping code to GCC under IRIX, or by configuring --with-wide-int,
or by sticking with Emacs 24.4.

Paul Eggert's avatar
Paul Eggert committed
39 40 41
** 'configure' now prefers gnustep-config when configuring GNUstep.
If gnustep-config is not available, the old heuristics are used.

42 43
---
** The configure option `--with-pkg-config-prog' has been removed.
44
Use './configure PKG_CONFIG=/full/name/of/pkg-config' if you need to.
45

46 47 48 49
** The configure option '--enable-silent-rules' is now the default,
and silent rules are now quieter.  To get the old behavior where
'make' chatters a lot, configure with '--disable-silent-rules' or
build with 'make V=1'.
50

51 52 53 54 55 56 57
---
** The configure option '--with-gameuser' now allows to specify a
group instead of a user if its argument is prefixed by ':' (a colon).
This will cause the game score files in ${localstatedir}/games/emacs
to be owned by that group, and the helper program for updating them to
be installed setgid.

Glenn Morris's avatar
Glenn Morris committed
58 59 60 61 62
---
** The `grep-changelog' script (and its manual page) are no longer included.
It has no particular connection to Emacs and has not changed in years,
so if you want to use it, you can always take a copy from an older Emacs.

63

Stefan Monnier's avatar
Stefan Monnier committed
64
* Startup Changes in Emacs 25.1
65 66


Stefan Monnier's avatar
Stefan Monnier committed
67
* Changes in Emacs 25.1
68

69 70 71
** New function `custom-prompt-customize-unsaved-options' checks for
unsaved customizations and prompts user to customize (if found).

72
+++
73 74 75 76
** Network security (TLS/SSL certificate validity and the like) is
added via the new Network Security Manager (NSM) and controlled via
the `network-security-level' variable.

77 78
** C-h l now also lists the commands that were run.

79
---
80
** The new M-s M-w key binding uses eww to search the web for the
81 82
text in the region.

83
** M-x suggests shorthands and ignores obsolete commands for completion.
84 85 86 87 88 89
** x-select-enable-clipboard is renamed select-enable-clipboard.
x-select-enable-primary and renamed select-enable-primary.
Additionally they both now apply to all systems (OSX, GNUstep, Windows, you
name it), with the proviso that on some systems (e.g. Windows)
select-enable-primary is ineffective since the system doesn't
have the equivalent of a primary selection.
Stefan Monnier's avatar
Stefan Monnier committed
90

91 92 93
+++
** terpri gets an optional arg ENSURE to conditionally output a newline.

Leo Liu's avatar
Leo Liu committed
94 95 96
+++
** New macro `define-advice'.

97 98
** `insert-register' now leaves point after the inserted text
when called interactively.  A prefix argument toggles this behavior.
99

100 101
** New var `truncate-string-ellipsis' to choose how to indicate truncation.

102 103 104 105 106
+++
** The new variable `term-file-aliases' replaces some files from lisp/term.
The function `tty-run-terminal-initialization' consults this variable
when deciding what terminal-specific initialization code to run.

107 108 109 110 111
---
** New variable `system-configuration-features', listing some of the
main features that Emacs was compiled with.  This is mainly intended
for use in Emacs bug reports.

112 113 114 115 116
+++
** A password is now hidden also when typed in batch mode.  Another
hiding character but the default `.' can be used by let-binding the
variable `read-hide-char'.

117 118
** The new functions `string-collate-lessp' and `string-collate-equalp'
preserve the collation order as defined by the system's locale(1)
119 120 121
environment.  For the time being this is implemented for modern POSIX
systems and for MS-Windows, for other systems they fall back to their
counterparts `string-lessp' and `string-equal'.
122

123 124 125 126 127 128 129 130 131 132 133
*** The ls-lisp package uses `string-collate-lessp' to sort file names.
If you want the old, locale-independent sorting, customize the new
option `ls-lisp-use-string-collate' to a nil value.

*** The MS-Windows specific variable `w32-collate-ignore-punctuation',
if set to a non-nil value, causes the above 2 functions to ignore
symbol and punctuation characters when collating strings.  This
emulates the behavior of modern Posix platforms when the locale's
codeset is "UTF-8" (as in "en_US.UTF-8").  This is needed because
MS-Windows doesn't support UTF-8 as codeset in its locales.

134 135 136 137 138 139 140
+++
** The new function `bidi-find-overridden-directionality' allows to
find characters whose directionality was, perhaps maliciously,
overridden by directional override control characters.  Lisp programs
can use this to detect potential phishing of URLs and other links that
exploits bidirectional display reordering.

141 142 143 144 145 146 147
+++
** The new function `buffer-substring-with-bidi-context' allows to
copy a portion of a buffer into a different location while preserving
the visual appearance both of the copied text and the text at
destination, even when the copied text includes mixed bidirectional
text and directional control characters.

148 149 150 151 152
** New variable `ns-use-fullscreen-animation' controls animation for
non-native NS fullscreen.  The default is nil.  Set to t to enable
animation when entering and leaving fullscreen.  For native OSX fullscreen
this has no effect.

153
** A new text property `inhibit-read-only' can be used in read-only
154 155
buffers to allow certain parts of the text to be writable.

156 157 158
** A new function `directory-files-recursively' returns all matching
files (recursively) under a directory.

159 160 161 162 163
** The new `directory-name-p' can be used to check whether a file
name (as returned from, for instance, `file-name-all-completions' is
a directory file name.  It returns non-nil if the last character in
the name is a forward slash.

164 165 166 167 168 169
+++
** New variable `fast-but-imprecise-scrolling' inhibits
fontification during full screen scrolling operations, giving less
hesitant operation during auto-repeat of C-v, M-v at the cost of
possible inaccuracies in the end position.

170 171 172 173
** The function `font-info' now returns more details about a font.
In particular, it now returns the average width of the font's
characters, which can be used for geometry-related calculations.

174

Stefan Monnier's avatar
Stefan Monnier committed
175
* Editing Changes in Emacs 25.1
176

177 178
** Unicode names entered via C-x 8 RET now use substring completion by default.

179 180
** New minor mode global-eldoc-mode is enabled by default.

Glenn Morris's avatar
Glenn Morris committed
181
** Emacs now supports "bracketed paste mode" when running on a terminal
182
that supports it.  This facility allows Emacs to understand pasted
Glenn Morris's avatar
Glenn Morris committed
183 184 185
chunks of text as strings to be inserted, instead of interpreting each
character in the pasted text as actual user input.  This results in a
paste experience similar to that under a window system, and significant
186 187
performance improvements when pasting large amounts of text.

Eli Zaretskii's avatar
Eli Zaretskii committed
188 189 190 191 192 193 194 195
** Emacs now supports the latest version of the UBA.
The Emacs implementation of the Unicode Bidirectional Algorithm (UBA)
was updated to support all the latest additions and changes introduced
in Unicode Standard versions 6.3 and 7.0, and a few changes suggested
for Unicode 8.0.  This includes full support for directional isolates
and the Bidirectional Parentheses Algorithm (BPA) specified by these
Unicode standards.

196 197
** You can access `mouse-buffer-menu' (C-down-mouse-1) using C-f10.

198

Stefan Monnier's avatar
Stefan Monnier committed
199
* Changes in Specialized Modes and Packages in Emacs 25.1
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217
** package.el
*** `package-install-from-buffer' and `package-install-file' work on directories.
This follows the same rules as installing from a .tar file, except the
-pkg file is optional.

*** Packages which are dependencies of other packages cannot be deleted.
The FORCE argument to `package-delete' overrides this.

*** New custom variable `package-selected-packages' tracks packages
which were installed by the user (as opposed to installed as
dependencies). This variable can also be manually customized.

*** New command `package-install-user-selected-packages' installs all
packages from `package-selected-packages' which are currently missing.

*** New command `package-autoremove' removes all packages which were
installed strictly as dependencies but are no longer needed.

218 219 220 221
** Shell

When you invoke `shell' interactively, the *shell* buffer will now
display in a new window.  However, you can customize this behavior via
222
the `display-buffer-alist' variable.  For example, to get
223
the old behavior -- *shell* buffer displays in current window -- use
224 225
(add-to-list 'display-buffer-alist
     '("^\\*shell\\*$" . (display-buffer-same-window))).
226

227 228

** EIEIO
229
*** The `:protection' slot option is not obeyed any more.
230 231
*** The `newname' argument to constructors is optional&deprecated.
If you need your objects to be named, do it by inheriting from `eieio-named'.
232 233 234
*** The <class>-list-p and <class>-child-p functions are declared obsolete.
*** The <class> variables are declared obsolete.
*** The <initarg> variables are declared obsolete.
235 236
*** defgeneric and defmethod are declared obsolete.

237 238 239 240
** ido
*** New command `ido-bury-buffer-at-head' bound to C-S-b
Bury the buffer at the head of `ido-matches', analogous to how C-k
kills the buffer at head.
241

242 243 244 245 246 247 248 249
** Minibuffer

*** You can use <up> and <down> keys to move point in the multi-line
minibuffer just as in an ordinary buffer.  Only when point moves over
the bottom/top of the minibuffer it goes to the next/previous history
element.  The new commands bound to <up> and <down> in the minibuffer:
`next-line-or-history-element' and `previous-line-or-history-element'.

250 251
** Search and Replace

252 253 254 255 256 257 258 259
*** Query-replace history is enhanced.
When query-replace reads the FROM string from the minibuffer, typing
`M-p' will now show previous replacements as "FROM SEP TO", where FROM
and TO are the original text and its replacement, and SEP is an arrow
string defined by the new variable `query-replace-from-to-separator'.
To select a prior replacement, type `M-p' until the desired
replacement appears in the minibuffer, and then exit the minibuffer by
typing RET.
260

261 262 263 264 265
** Calc
+++
*** If `quick-calc' is called with a prefix argument, insert the
result of the calculation into the current buffer.

266
** ElDoc
267 268 269 270 271 272
*** New minor mode `global-eldoc-mode'
*** `eldoc-documentation-function' now defaults to `ignore'
*** `describe-char-eldoc' displays information about character at point,
and can be used as a default value of `eldoc-documentation-function'.  It is
useful when, for example, one needs to distinguish various spaces (e.g. ] [,
] [, ] [, etc.) while using mono-spaced font.
273

274 275
** eww

276
+++
277 278 279 280
*** A new command `R' (`eww-readable') will try do identify the main
textual parts of a web page and display only that, leaving menus and
the like off the page.

281
---
282 283 284
*** You can now use several eww buffers in parallel by renaming eww
buffers you want to keep separate.

285
+++
Ivan Shmakov's avatar
Ivan Shmakov committed
286 287 288
*** Partial state of the eww buffers (the URIs and the titles of the
pages visited) is now preserved in the desktop file.

289
+++
290 291 292
*** `eww-after-render-hook' is now called after eww has rendered
the data in the buffer.

293 294 295 296
---
*** The `eww-reload' command now takes a prefix to not reload via
the net, but just use the local copy of the HTML.

297
+++
298 299 300 301 302
*** The DOM shr and eww uses has been changed to the general Emacs
xml.el/libxml2 DOM, and a new package dom.el has been added to
interact with this DOM.  See the Emacs Lisp manual for interface
details.

303
+++
304 305
*** `mailcap-mime-data' is now consulted when displaying PDF files.

306 307 308 309
+++
*** The new `S' command will list all eww buffers, and allow managing
them.

310 311 312 313
---
*** https pages with valid certificates have headers marked in green, while
invalid certificates are marked in red.

314 315 316 317 318
** Message mode

*** text/html messages that contain inline image parts will be
transformed into multipart/related messages before sending.

319 320
** pcase
*** New UPatterns `quote' and `app'.
321
*** New UPatterns can be defined with `pcase-defmacro'.
322 323
+++
*** New vector QPattern.
324

325 326 327
** Lisp mode
*** Strings after `:documentation' are highlighted as docstrings.

328 329 330 331
** Rectangle editing
*** Rectangle Mark mode can have corners past EOL or in the middle of a TAB.
*** C-x C-x in rectangle-mark-mode now cycles through the four corners.
*** `string-rectangle' provides on-the-fly preview of the result.
332

Glenn Morris's avatar
Glenn Morris committed
333 334
** New font-lock functions font-lock-ensure and font-lock-flush, which
should be used instead of font-lock-fontify-buffer when called from Elisp.
335

336 337 338
** Macro `minibuffer-with-setup-hook' takes (:append FUN) to mean
appending FUN to `minibuffer-setup-hook'.

339 340 341
** cl-lib
*** New functions cl-fresh-line, cl-digit-char-p and cl-parse-integer.

342 343 344 345 346 347
** seq
*** New seq library:
The seq library adds sequence manipulation functions and macros that
complement basic functions provided by subr.el. All functions are
prefixed with `seq-' and work on lists, strings and vectors.

348 349 350 351 352
** Calendar and diary

+++
*** New commands to insert diary entries with Chinese dates:
`diary-chinese-insert-anniversary-entry' `diary-chinese-insert-entry'
Glenn Morris's avatar
Glenn Morris committed
353
`diary-chinese-insert-monthly-entry', `diary-chinese-insert-yearly-entry'.
354 355

+++
356
*** The calendar can now list and mark diary entries with Chinese dates.
Glenn Morris's avatar
Glenn Morris committed
357 358
See `diary-chinese-list-entries' and `diary-chinese-mark-entries'.

359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375
---
*** The option `calendar-mode-line-format' can now be nil,
which means to do nothing special with the mode line in calendars.

---
*** Many items obsolete since at least version 23.1 have been removed.
The majority were function/variable/face aliases, too numerous to list here.
The remainder were:

**** Functions `calendar-one-frame-setup', `calendar-only-one-frame-setup',
`calendar-two-frame-setup', `european-calendar', `american-calendar'.

**** Hooks `cal-menu-load-hook', `cal-x-load-hook'.

**** Macro `calendar-for-loop'.

**** Variables `european-calendar-style', `diary-face', `hebrew-holidays-{1,4}'.
376

377 378
**** The nil and list forms of `diary-display-function'.

379 380
** New ERT function `ert-summarize-tests-batch-and-exit'.

381 382 383
---
** `Info-fontify-maximum-menu-size' can be t for no limit.

384 385 386 387 388
+++
** `info-display-manual' can now be given a prefix argument which (any
non-nil value) directs the command to limit the completion
alternatives to currently visited manuals.

389 390 391
---
** ntlm.el has support for NTLM2.

Glenn Morris's avatar
Glenn Morris committed
392 393 394 395
---
** The Rmail commands d, C-d and u now handle repeat counts to delete or
undelete multiple messages.

396 397 398 399 400 401
** Rmail can now render HTML mail messages if your Emacs was built with
libxml2 or if you have the Lynx browser installed.  By default, Rmail
will display the HTML version of a mail message that has both HTML and
plain text parts, if display of HTML email is possible; customize the
`rmail-mime-prefer-html' option to `nil' if you don't want that.

Glenn Morris's avatar
Glenn Morris committed
402
** SES now supports local printer functions; see `ses-define-local-printer'.
403

Glenn Morris's avatar
Glenn Morris committed
404 405 406
** In sh-mode, you can now use `sh-shell' as a file-local variable to
specify the type of shell in use (bash, csh, etc).

407 408 409 410
** TLS
---
*** Fatal TLS errors are now silent by default.

411 412 413
** URL

*** The URL package accepts now the protocols "ssh", "scp" and "rsync".
414 415 416
When `url-handler-mode' is enabled, file operations for these
protocols as well as for "telnet" and "ftp" are passed to Tramp.

417
*** The URL package allows customizing the `url-user-agent' string.
418 419 420
The new `url-user-agent' variable can be customized to be a string or
a function.

421 422 423 424
*** The new interface variable `url-request-noninteractive' can be used
to specify that we're running in a noninteractive context, and that
we should not be queried about things like TLS certificate validity.

425 426 427 428
*** If URL is used with a https connection, the first callback argument
plist will contain a :peer element that has the output of
`gnutls-peer-status' (if Emacs is built with GnuTLS support).

429 430 431 432
** Tramp

*** New connection method "nc", which allows to access dumb busyboxes.

433 434 435 436 437 438 439 440 441
** SQL mode

*** New user variable `sql-default-directory' enables remote
connections using Tramp.

*** New command `sql-send-line-and-next' sends the current line to the
interactive buffer and advances to the next line, skipping whitespace
and comments.

Sam Steingold's avatar
Sam Steingold committed
442 443
*** Add support for Vertica SQL.

444 445
** VC and related modes

446 447
*** The new command vc-region-history shows the log+diff of the active region.

448 449 450 451
*** New option `vc-annotate-background-mode' controls whether
the color range from `vc-annotate-color-map' is applied to the
background or to the foreground.

452
*** `compare-windows' now compares text with the most recently used window
453 454 455
instead of the next window.  The new option `compare-windows-get-window-function'
allows to customize this.

456 457 458
*** Two new faces `compare-windows-removed' and `compare-windows-added'
replace the obsolete face `compare-windows'.

459 460 461 462
** Calculator: decimal display mode uses "," groups, so it's more
fitting for use in money calculations; factorial works with
non-integer inputs.

463 464 465 466 467 468 469 470 471 472
** HideIfDef mode now support full C/C++ expressions, argumented macro expansions
, interactive macro evaluation and automatic scanning of #defined symbols.

*** New custom variable `hide-ifdef-header-regexp' to define C/C++ header file
name patterns. Default case-insensitive .h, .hh, .hpp and .hxx.
*** New custom variable `hide-ifdef-expand-reinclusion-protection' to prevent
reinclusion protected header files from being fully hidden.
*** New custom variable `hide-ifdef-exclude-define-regexp' to define symbol
name patterns (e.x. all "FOR_DOXYGEN_ONLY_*") to be excluded.

473 474 475 476 477
** TeX mode

*** New custom variable `tex-print-file-extension' to help users who
use PDF instead of DVI.

478 479 480 481
** whitespace-mode: new 'big-indent style highlighting too much indentation.
By default, 32 spaces and four TABs are considered to be too much but
`whitespace-big-indent-regexp' can be configured to change that.

482 483 484 485 486
** tildify: `tildify-space-string', `tildify-pattern', and
`tildify-foreach-region-function' variables added making
`tildify-string-alist', `tildify-pattern-alist', and
`tildify-ignored-environments-alist' variables (as well as a few
helper functions) obsolete.
487

488 489 490 491 492 493
** xref
The new package provides generic framework and new commands to find
and move to definitions, as well as pop back to the original location.

*** New key bindings
`xref-find-definitions' replaces `find-tag' and provides an interface
Paul Eggert's avatar
Paul Eggert committed
494
to pick one destination among several.  Hence, `tags-loop-continue' is
495 496 497 498 499 500 501 502 503 504 505 506
unbound.  `xref-pop-marker-stack' replaces `pop-tag-mark', but uses an
easier binding, which is now unoccupied (`M-,').
`xref-find-definitions-other-window' replaces `find-tag-other-window'.
`xref-find-definitions-other-frame' replaces `find-tag-other-frame'.
`xref-find-apropos' replaces `find-tag-regexp'.

*** New variables
`find-tag-marker-ring-length' is now an obsolete alias for
`xref-marker-ring-length'.  `find-tag-marker-ring' is now an obsolete
alias for a private variable.  `xref-push-marker-stack' and
`xref-pop-marker-stack' should be used to mutate it instead.

507 508 509 510 511
** etags
As a result of the above, these commands are now obsolete:
`find-tag-other-window', `find-tag-other-frame', `find-tag-regexp',
`tags-apropos' and `tags-loop-continue'.

512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543
** EUDC
EUDC's LDAP backend has been improved.

*** EUDC supports LDAP-over-SSL URLs (ldaps://).

*** EUDC passes LDAP passwords through a pipe to the ldapsearch
subprocess instead of on the command line.

*** EUDC handles LDAP wildcards automatically so the user shouldn't
need to configure this manually anymore.

*** The LDAP configuration section of EUDC's manual has been
rewritten.

There have also been customization changes.

*** New custom variable `eudc-server-hotlist' to allow specifying
multiple EUDC servers in init file.

*** Custom variable `eudc-inline-query-format' defaults to completing
on email and firstname instead of surname.

*** Custom variable `eudc-expansion-overwrites-query' defaults to nil
to avoid interfering with the kill ring.

*** Custom variable `eudc-inline-expansion-format' defaults to
"Firstname Surname <mail-address>".

*** New custom variable `ldap-ldapsearch-password-prompt-regexp' to
allow overriding the regular expression that recognizes the ldapsearch
command line's password prompt.

544 545 546 547
+++
** tar-mode: new `tar-new-entry' command, allowing for new members to
be added to the archive.

Glenn Morris's avatar
Glenn Morris committed
548 549 550 551 552
** Obsolete packages

---
*** gulp.el

553

Stefan Monnier's avatar
Stefan Monnier committed
554
* New Modes and Packages in Emacs 25.1
555

556 557
** cl-generic.el provides CLOS-style multiple-dispatch generic functions.

558
** scss-mode (a minor variant of css-mode)
559 560 561 562

** let-alist is a new macro (and a package) that allows one to easily
let-bind the values stored in an alist.

563 564 565 566 567
** `tildify-mode' allows to automatically insert hard spaces as one
types the text.  Breaking line after a single-character words is
forbidden by Czech and Polish typography (and may be discouraged in
other languages), so `auto-tildify-mode' makes it easier to create
a typographically-correct documents.
568

Stefan Monnier's avatar
Stefan Monnier committed
569
* Incompatible Lisp Changes in Emacs 25.1
570

Stefan Monnier's avatar
Stefan Monnier committed
571 572 573 574 575
** completion-table-dynamic stays in the minibuffer.
If you want the old behavior of calling the function in the buffer
from which the minibuffer was entered, call it with the new argument
`switch-buffer'.

Glenn Morris's avatar
Glenn Morris committed
576
** window-configurations no longer record the buffers's marks.
577

Glenn Morris's avatar
Glenn Morris committed
578
** inhibit-modification-hooks now also inhibits lock-file checks, as well as
579 580
active region handling.

581 582
** deactivate-mark is now buffer-local.

Glenn Morris's avatar
Glenn Morris committed
583
** `cl-the' now asserts that its argument is of the given type.
584

585 586 587 588 589
+++
** Mouse click events on mode line or header line no longer include
any reference to a buffer position.  The 6th member of the mouse
position list returned for such events is now nil.

590 591 592
** Menu items in keymaps do not support the "key shortcut cache" any more.
These slots used to hold key-shortcut data, but have been obsolete since
Emacs-21.
593

594 595 596 597 598
** Emacs no longer downcases the first letter of a system diagnostic
when signaling a file error.  For example, it now reports "Permission
denied" instead of "permission denied".  The old behavior was problematic
in languages like German where downcasing rules depend on grammar.

599

Stefan Monnier's avatar
Stefan Monnier committed
600
* Lisp Changes in Emacs 25.1
601

602 603 604 605
** lexical closures can use (:documentation <form>) to build their docstring.
It should be placed right where the docstring would be, and <form> is then
evaluated (and should return a string) when the closure is built.

Stefan Monnier's avatar
Stefan Monnier committed
606 607
** define-inline provides a new way to define inlinable functions.

608 609
** New function macroexpand-1 to perform a single step of macroexpansion.

610 611
** Some "x-*" were obsoleted:
*** x-select-text is renamed gui-select-text.
612
*** x-selection-value is renamed gui-selection-value.
613 614 615 616
*** x-get-selection is renamed gui-get-selection.
*** x-get-clipboard and x-clipboard-yank are marked obsolete.
*** x-get-selection-value is renamed to gui-get-primary-selection.
*** x-set-selection is renamed to gui-set-selection
Stefan Monnier's avatar
Stefan Monnier committed
617

618
** New function `alist-get', which is also a valid place (aka lvalue).
619

620 621 622 623
** New function `funcall-interactively', which works like `funcall'
but makes `called-interactively-p' treat the function as (you guessed it)
called interactively.

624 625
** New function `function-put' to use instead of `put' for function properties.

626
+++
627
** New properties that can be specified with `declare':
Glenn Morris's avatar
Glenn Morris committed
628
*** (interactive-only INSTEAD), says to use INSTEAD for non-interactive use.
629 630 631
*** (pure VAL), if VAL is non-nil, indicates the function is pure.
*** (side-effect-free VAL), if VAL is non-nil, indicates the function does not
have side effects.
632

633 634 635 636
+++
** New macro `with-file-modes', for evaluating expressions with default file
permissions set to temporary values (e.g., for creating private files).

637
** You can access the slots of structures using `cl-struct-slot-value'.
Daniel Colascione's avatar
Daniel Colascione committed
638

639 640 641
** Functions `rmail-delete-forward' and `rmail-delete-backward' take an
optional repeat-count argument.

642 643
** Function `sort' can deal with vectors.

644
** Function `system-name' now returns an updated value if the current
645 646 647
system's name has changed or if the Emacs process has changed systems,
and to avoid long waits it no longer consults DNS to canonicalize the
name.  The variable `system-name' is now obsolete.
648

649 650 651
+++
** Function `write-region' no longer outputs "Wrote FILE" in batch mode.

652
---
653 654 655 656 657
** New utilities in subr-x.el:
*** New macros `if-let' and `when-let' allow defining bindings and to
    execute code depending whether all values are true.
*** New macros `thread-first' and `thread-last' allow threading a form
    as the first or last argument of subsequent forms.
658

659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677
+++
** Time-related changes:

*** Time-related functions now consistently accept numbers
(representing seconds since the epoch) and nil (representing the
current time) as well as the usual list-of-integer representation.
Affected functions include `current-time-string', `current-time-zone',
`decode-time', `float-time', `format-time-string', `seconds-to-time',
`time-add', `time-less-p', `time-subtract', `time-to-day-in-year',
`time-to-days', and `time-to-seconds'.

*** The `encode-time-value' and `with-decoded-time-value' macros have
been obsoleted.

*** `calendar-next-time-zone-transition', `time-add', and
`time-subtract' no longer return time values in the obsolete and
undocumented integer-pair format.  Instead, they return a list of two
integers.

678 679 680 681
+++
** New function `set-binary-mode' allows to switch a standard stream
of the Emacs process to binary I/O mode.

682

Stefan Monnier's avatar
Stefan Monnier committed
683
* Changes in Frames and Windows Code in Emacs 25.1
684

685
+++
686
** Emacs can now draw horizontal scroll bars on some platforms that
687
provide toolkit scroll bars, namely Gtk+, Lucid, Motif and Windows.
Martin Rudalics's avatar
Martin Rudalics committed
688
Horizontal scroll bars are turned off by default.
689 690
*** New function `horizontal-scroll-bars-available-p' telling whether
    horizontal scroll bars are available on the underlying system.
Martin Rudalics's avatar
Martin Rudalics committed
691 692
*** New mode `horizontal-scroll-bar-mode' to toggle horizontal scroll
    bars on all existing and future frames.
693 694
*** New function `toggle-horizontal-scroll-bar' to toggle horizontal
    scroll bars on the selected frame.
Martin Rudalics's avatar
Martin Rudalics committed
695 696 697
*** New frame parameters `horizontal-scroll-bars' and
    `scroll-bar-height' to set horizontal scroll bars and their height
    for individual frames and in `default-frame-alist'.
698 699 700
*** New functions `frame-scroll-bar-height' and
    `window-scroll-bar-height' return the height of horizontal scroll
    bars on a specific frame or window.
Martin Rudalics's avatar
Martin Rudalics committed
701 702
*** `set-window-scroll-bars' now accepts five parameters where the last
    two specify height and type of the window's horizontal scroll bar.
703 704 705 706
*** `window-scroll-bars' now returns type and sizes of horizontal scroll
    bars too.
*** New buffer-local variables `horizontal-scroll-bar' and
    `scroll-bar-height'.
Martin Rudalics's avatar
Martin Rudalics committed
707

708
+++
Daniel Colascione's avatar
Daniel Colascione committed
709
** The height of a frame's menu and tool bar are no longer counted in the
Martin Rudalics's avatar
Martin Rudalics committed
710 711 712 713 714 715
frame's text height.  This means that the text height stands only for
the height of the frame's root window plus that of the echo area (if
present).  This was already the behavior for frames with external tool
and menu bars (like in the Gtk builds) but has now been extended to all
builds.

716
+++
Martin Rudalics's avatar
Martin Rudalics committed
717 718 719 720 721 722 723 724 725
** Frames now do not necessarily preserve the number of columns or lines
they display when setting default font, menu bar, fringe width, or
scroll bars.  In particular, maximized and fullscreen frames are
conceptually never resized if such settings change.  For fullheight and
fullwidth frames, the behavior may depend on the toolkit used.
*** New option `frame-inhibit-implied-resize' if non-nil, means that
   setting default font, menu bar, fringe width, or scroll bars of a
   specific frame does not resize that frame in order to preserve the
   number of columns or lines it displays.
726

727
+++
728 729 730 731
** New function `window-preserve-size' allows to preserve the size of
windows without "fixing" it.  It's supported by `fit-window-to-buffer',
`temp-buffer-resize-mode' and `display-buffer'.

Jan Djärv's avatar
Jan Djärv committed
732
** Tearoff menus and detachable toolbars for Gtk+ has been removed.
733 734
Those features have been deprecated in Gtk+ for a long time.

735

Stefan Monnier's avatar
Stefan Monnier committed
736
* Changes in Emacs 25.1 on Non-Free Operating Systems
737

Glenn Morris's avatar
Glenn Morris committed
738 739 740 741 742
---
** Building Emacs for MS-Windows requires at least Windows XP
or Windows Server 2003.  The built binaries still run on all versions
of Windows starting with Windows 9X.

743 744 745
** OS X 10.5 or older is no longer supported.

** OS X on PowerPC is no longer supported.
746

747

Dave Love's avatar
#  
Dave Love committed
748
----------------------------------------------------------------------
749
This file is part of GNU Emacs.
Dave Love's avatar
#  
Dave Love committed
750

751
GNU Emacs is free software: you can redistribute it and/or modify
752
it under the terms of the GNU General Public License as published by
753 754
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
755 756 757 758 759

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
Dave Love's avatar
#  
Dave Love committed
760

761
You should have received a copy of the GNU General Public License
762
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
Dave Love's avatar
#  
Dave Love committed
763

764

Dave Love's avatar
#  
Dave Love committed
765
Local variables:
766
coding: utf-8
Dave Love's avatar
#  
Dave Love committed
767 768 769
mode: outline
paragraph-separate: "[ 	]*$"
end: