procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document that 'byte-compile-dynamic' is obsolete

Browse source 
* doc/lispref/compile.texi (Dynamic Loading): Document that this
is deprecated.

* etc/NEWS: mark the 'byte-compile-dynamic' entry as documented.
This commit is contained in:
Eli Zaretskii 2020-03-07 14:23:23 +02:00
parent 512b66abd7
commit 08c042bd26
2 changed files with 8 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/lispref/compile.texi
View file

@ -302,7 +302,7 @@ function is called, it reads the full definition from the file, to
replace the place-holder. replace the place-holder.
The advantage of dynamic function loading is that loading the file The advantage of dynamic function loading is that loading the file
becomes much faster. This is a good thing for a file which contains should become faster. This is a good thing for a file which contains
many separate user-callable functions, if using one of them does not many separate user-callable functions, if using one of them does not
imply you will probably also use the rest. A specialized mode which imply you will probably also use the rest. A specialized mode which
provides many keyboard commands often has that usage pattern: a user may provides many keyboard commands often has that usage pattern: a user may
@ -326,6 +326,10 @@ installed Emacs files. But they are quite likely to happen with Lisp
files that you are changing. The easiest way to prevent these problems files that you are changing. The easiest way to prevent these problems
is to reload the new compiled file immediately after each recompilation. is to reload the new compiled file immediately after each recompilation.
@emph{Experience shows that using dynamic function loading provides
benefits that are hardly measurable, so this feature is deprecated
since Emacs 27.1.}
The byte compiler uses the dynamic function loading feature if the The byte compiler uses the dynamic function loading feature if the
variable @code{byte-compile-dynamic} is non-@code{nil} at compilation variable @code{byte-compile-dynamic} is non-@code{nil} at compilation
time. Do not set this variable globally, since dynamic loading is time. Do not set this variable globally, since dynamic loading is

5
etc/NEWS
View file

@ -803,10 +803,11 @@ You can use this new user option to control indentation of arguments of
** byte compiler ** byte compiler
+++
*** 'byte-compile-dynamic' is now obsolete. *** 'byte-compile-dynamic' is now obsolete.
This is because on the one hand it suffers from misbehavior in corner This is because on the one hand it suffers from misbehavior in corner
cases that have plagued it for years, and on the other experiments indicated cases that have plagued it for years, and on the other hand experience
that it doesn't bring any measurable benefit. indicates that it doesn't bring any measurable benefit.
--- ---
*** The 'g' keystroke in "*Compile-Log*" buffers has been bound to a *** The 'g' keystroke in "*Compile-Log*" buffers has been bound to a