<feed xmlns='http://www.w3.org/2005/Atom'>
<title>emacs/doc, branch scratch/bug-55156</title>
<subtitle>Emacs is the extensible, customizable, self-documenting real-time display editor. 
</subtitle>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/'/>
<entry>
<title>eval.c: New functions `defvar-1` and `defconst-1` (bug#55156)</title>
<updated>2022-05-26T16:21:32+00:00</updated>
<author>
<name>Stefan Monnier</name>
</author>
<published>2022-05-25T21:53:39+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=80ba4c170756049a101b4e6692882ac30ba5e1a5'/>
<id>80ba4c170756049a101b4e6692882ac30ba5e1a5</id>
<content type='text'>
The bytecode interpreter can't directly call special forms, so
the byte-compiler usually converts special forms into some sequence of
byte codes (basically, providing a duplicate definition of the special
form).  There are still two exceptions to this: `defconst` and `defvar`,
where the compiler instead generates a convoluted chunk of code like:

    (funcall '(lambda (x) (defvar &lt;sym&gt; x &lt;doc&gt;)) &lt;value&gt;)

where the quote makes sure we keep the function non-compiled, so as
to end up running the special form at run time.

Get rid of this workaround by introducing `defvar-1` and `defconst-1`
which provide a *functional* interface to the functionality of the
corresponding special form.

* src/eval.c (defvar, Fdefvar_1, Fdefconst_1): New functions, extracted from
`Fdefvar` and `Fdefconst`.
(Fdefvar, Fdefconst): Use them.
(syms_of_eval): `defsubr` the new functions.

* lisp/emacs-lisp/bytecomp.el (byte-compile-tmp-var): Delete const.
(byte-compile-defvar): Simplify using the new functions.

* doc/lispref/variables.texi (Defining Variables): Adjust the doc of
`defvar` to reflect the actual semantics implemented.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The bytecode interpreter can't directly call special forms, so
the byte-compiler usually converts special forms into some sequence of
byte codes (basically, providing a duplicate definition of the special
form).  There are still two exceptions to this: `defconst` and `defvar`,
where the compiler instead generates a convoluted chunk of code like:

    (funcall '(lambda (x) (defvar &lt;sym&gt; x &lt;doc&gt;)) &lt;value&gt;)

where the quote makes sure we keep the function non-compiled, so as
to end up running the special form at run time.

Get rid of this workaround by introducing `defvar-1` and `defconst-1`
which provide a *functional* interface to the functionality of the
corresponding special form.

* src/eval.c (defvar, Fdefvar_1, Fdefconst_1): New functions, extracted from
`Fdefvar` and `Fdefconst`.
(Fdefvar, Fdefconst): Use them.
(syms_of_eval): `defsubr` the new functions.

* lisp/emacs-lisp/bytecomp.el (byte-compile-tmp-var): Delete const.
(byte-compile-defvar): Simplify using the new functions.

* doc/lispref/variables.texi (Defining Variables): Adjust the doc of
`defvar` to reflect the actual semantics implemented.
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge from origin/emacs-28</title>
<updated>2022-05-25T17:57:59+00:00</updated>
<author>
<name>Eli Zaretskii</name>
</author>
<published>2022-05-25T17:57:59+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=97bb31be9f4e06060f2d192b049c3cdb47aca2f5'/>
<id>97bb31be9f4e06060f2d192b049c3cdb47aca2f5</id>
<content type='text'>
86b49d5865 ; * etc/NEWS: Announce changes in 'desktop-kill'.  (Bug#55...
d5ccf2621a ; Fix last change
f1c1fd7184 Improve documentation of mail-user-agent.
b05d1e9b98 ; * lisp/desktop.el: Update the commentary.  (Bug#55560)
139bfa1a08 More fixes in abbrev.el doc strings
d80dea6036 Add note about Tramp completion to completion-styles doc s...
9e7c0cf57d Remove mention of removed nnimap-nov-is-evil variable
90aae0bca2 Improve documentation strings and prompts in abbrev.el
dfa3e6f424 Restore the Fselect_window call in gui_consider_frame_title.
de35e9728f Advise against settings in the MS-Windows system registry
3ffa3d3403 ; Minor addition to make-tarball.txt
7dc026f9ea Fix kmacro-keymap binding after previous change
4f0fd54bc4 Add glossary entries for "interactively"
af1c05a3c4 Fix the name of a kmacro command.

# Conflicts:
#	etc/NEWS
#	lisp/abbrev.el
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
86b49d5865 ; * etc/NEWS: Announce changes in 'desktop-kill'.  (Bug#55...
d5ccf2621a ; Fix last change
f1c1fd7184 Improve documentation of mail-user-agent.
b05d1e9b98 ; * lisp/desktop.el: Update the commentary.  (Bug#55560)
139bfa1a08 More fixes in abbrev.el doc strings
d80dea6036 Add note about Tramp completion to completion-styles doc s...
9e7c0cf57d Remove mention of removed nnimap-nov-is-evil variable
90aae0bca2 Improve documentation strings and prompts in abbrev.el
dfa3e6f424 Restore the Fselect_window call in gui_consider_frame_title.
de35e9728f Advise against settings in the MS-Windows system registry
3ffa3d3403 ; Minor addition to make-tarball.txt
7dc026f9ea Fix kmacro-keymap binding after previous change
4f0fd54bc4 Add glossary entries for "interactively"
af1c05a3c4 Fix the name of a kmacro command.

# Conflicts:
#	etc/NEWS
#	lisp/abbrev.el
</pre>
</div>
</content>
</entry>
<entry>
<title>Make yank-transform-functions into defvar</title>
<updated>2022-05-25T12:23:56+00:00</updated>
<author>
<name>Lars Ingebrigtsen</name>
</author>
<published>2022-05-25T12:23:56+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=ce79fe451d845c09e5502071f9af9845eb930885'/>
<id>ce79fe451d845c09e5502071f9af9845eb930885</id>
<content type='text'>
* doc/lispref/text.texi (Yanking): Adjust.
* lisp/simple.el (yank-transform-functions): Make into defvar
because it's not that useful as a user option.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* doc/lispref/text.texi (Yanking): Adjust.
* lisp/simple.el (yank-transform-functions): Make into defvar
because it's not that useful as a user option.
</pre>
</div>
</content>
</entry>
<entry>
<title>Keep subcommands in pipelines from clobbering the head/tail processes</title>
<updated>2022-05-24T12:58:00+00:00</updated>
<author>
<name>Jim Porter</name>
</author>
<published>2022-05-23T00:27:48+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=a49ecdd0ff2b2526fcc519bb23ce1f5113c8fb1d'/>
<id>a49ecdd0ff2b2526fcc519bb23ce1f5113c8fb1d</id>
<content type='text'>
* lisp/eshell/esh-cmd.el (eshell-execute-pipeline): Use 'make-symbol'
for headproc and tailproc.
(eshell-do-pipelines, eshell-do-pipelines-synchronously): Adapt to the
above.

* test/lisp/eshell/eshell-tests.el (eshell-test/pipe-subcommand)
(eshell-test/pipe-subcommand-with-pipe): New test.

* doc/misc/eshell.texi (Bugs and ideas): Remove item about piping to
process from loop; this commit fixes it (bug#55590).
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* lisp/eshell/esh-cmd.el (eshell-execute-pipeline): Use 'make-symbol'
for headproc and tailproc.
(eshell-do-pipelines, eshell-do-pipelines-synchronously): Adapt to the
above.

* test/lisp/eshell/eshell-tests.el (eshell-test/pipe-subcommand)
(eshell-test/pipe-subcommand-with-pipe): New test.

* doc/misc/eshell.texi (Bugs and ideas): Remove item about piping to
process from loop; this commit fixes it (bug#55590).
</pre>
</div>
</content>
</entry>
<entry>
<title>Add ".epub" to Tramp archive file suffixes.</title>
<updated>2022-05-24T10:15:41+00:00</updated>
<author>
<name>Michael Albinus</name>
</author>
<published>2022-05-24T10:15:41+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=54a3132cfa6541e74688e1cf7821aab7d8df926a'/>
<id>54a3132cfa6541e74688e1cf7821aab7d8df926a</id>
<content type='text'>
* doc/misc/tramp.texi (Archive file names):
* lisp/net/tramp-archive.el (tramp-archive-suffixes): Add ".epub".
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* doc/misc/tramp.texi (Archive file names):
* lisp/net/tramp-archive.el (tramp-archive-suffixes): Add ".epub".
</pre>
</div>
</content>
</entry>
<entry>
<title>Enable keys M-down, M-up, M-RET for in-buffer completion</title>
<updated>2022-05-22T17:55:35+00:00</updated>
<author>
<name>Juri Linkov</name>
</author>
<published>2022-05-22T17:55:35+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=b2a5bf142fb25094ff623dc93d2ce916aee3d971'/>
<id>b2a5bf142fb25094ff623dc93d2ce916aee3d971</id>
<content type='text'>
* lisp/minibuffer.el (completion-in-region-mode-map): Add keybindings M-&lt;up&gt;
for minibuffer-previous-completion, M-&lt;down&gt; for minibuffer-next-completion,
M-RET for minibuffer-choose-completion.
(completion-in-region-mode): Set buffer-local
'minibuffer-completion-auto-choose' to nil.
(minibuffer-next-completion): Get the value of
'minibuffer-completion-auto-choose' from the minibuffer.
(minibuffer-previous-completion): Simplify by delegating to
'minibuffer-next-completion'.

* doc/emacs/programs.texi (Symbol Completion): Add description of keys
M-down, M-up, M-RET.

https://lists.gnu.org/archive/html/emacs-devel/2022-05/msg00916.html
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* lisp/minibuffer.el (completion-in-region-mode-map): Add keybindings M-&lt;up&gt;
for minibuffer-previous-completion, M-&lt;down&gt; for minibuffer-next-completion,
M-RET for minibuffer-choose-completion.
(completion-in-region-mode): Set buffer-local
'minibuffer-completion-auto-choose' to nil.
(minibuffer-next-completion): Get the value of
'minibuffer-completion-auto-choose' from the minibuffer.
(minibuffer-previous-completion): Simplify by delegating to
'minibuffer-next-completion'.

* doc/emacs/programs.texi (Symbol Completion): Add description of keys
M-down, M-up, M-RET.

https://lists.gnu.org/archive/html/emacs-devel/2022-05/msg00916.html
</pre>
</div>
</content>
</entry>
<entry>
<title>; Fix last change</title>
<updated>2022-05-22T08:17:23+00:00</updated>
<author>
<name>Eli Zaretskii</name>
</author>
<published>2022-05-22T08:17:23+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=d5ccf2621aa11130d4cf47efc2b8bcde6f6f8be1'/>
<id>d5ccf2621aa11130d4cf47efc2b8bcde6f6f8be1</id>
<content type='text'>
* doc/emacs/sending.texi (Mail Methods): Fix indexing and markup.
(Bug#55569)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* doc/emacs/sending.texi (Mail Methods): Fix indexing and markup.
(Bug#55569)
</pre>
</div>
</content>
</entry>
<entry>
<title>Improve documentation of mail-user-agent.</title>
<updated>2022-05-22T08:14:00+00:00</updated>
<author>
<name>Damien Cassou</name>
</author>
<published>2022-05-22T06:09:38+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=f1c1fd718478823b760020ed136345d94f379801'/>
<id>f1c1fd718478823b760020ed136345d94f379801</id>
<content type='text'>
* doc/emacs/sending.texi (Mail Methods):
* lisp/simple.el (mail-user-agent): Mention additional options
of non-bundled MUA.  (Bug#5569)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* doc/emacs/sending.texi (Mail Methods):
* lisp/simple.el (mail-user-agent): Mention additional options
of non-bundled MUA.  (Bug#5569)
</pre>
</div>
</content>
</entry>
<entry>
<title>; * doc/emacs/dired.texi (Entering Dired): Fix typo.</title>
<updated>2022-05-21T23:15:01+00:00</updated>
<author>
<name>Sean Whitton</name>
</author>
<published>2022-05-21T23:15:01+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=900700a03fd9839b70ffb6796e441e5ba57136a7'/>
<id>900700a03fd9839b70ffb6796e441e5ba57136a7</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Remove mention of removed nnimap-nov-is-evil variable</title>
<updated>2022-05-21T11:32:44+00:00</updated>
<author>
<name>Arash Esbati</name>
</author>
<published>2022-05-21T11:32:33+00:00</published>
<link rel='alternate' type='text/html' href='https://jason.zzq.org/git/emacs/commit/?id=9e7c0cf57d522b50423880f3a846c52c5509fef9'/>
<id>9e7c0cf57d522b50423880f3a846c52c5509fef9</id>
<content type='text'>
* doc/misc/gnus.texi (Slow/Expensive Connection): Remove mention
of removed nnimap-nov-is-evil variable (bug#55556).
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* doc/misc/gnus.texi (Slow/Expensive Connection): Remove mention
of removed nnimap-nov-is-evil variable (bug#55556).
</pre>
</div>
</content>
</entry>
</feed>
