Fix "src_emacs-lisp" results

This commit is contained in:
Gerard Vermeulen 2024-06-12 10:58:48 +02:00
parent 7ea6f46fdd
commit 85217735d8

View File

@ -1077,8 +1077,8 @@ looks for files.
:CUSTOM_ID: sec:enable-disabled-commands :CUSTOM_ID: sec:enable-disabled-commands
:END: :END:
Execute src_emacs-lisp{(find-library "novice")} to see how Emacs prevents new Execute src_emacs-lisp[:results none]{(find-library "novice")} to see how Emacs
users from shooting themselves in the feet. Listing prevents new users from shooting themselves in the feet. Listing
[[lst:configure-disabled-command-function]] enables [[https://www.emacswiki.org/emacs/DisabledCommands][disabled commands on the fly]]. [[lst:configure-disabled-command-function]] enables [[https://www.emacswiki.org/emacs/DisabledCommands][disabled commands on the fly]].
#+caption[Configure the =disabled-command-function=]: #+caption[Configure the =disabled-command-function=]:
@ -1446,9 +1446,10 @@ Listing [[lst:bind-embark-commands][bind =embark= commands]] binds =embark= comm
1. =embark-act= prompts the user for an action and performs it. GAV: ~org-mode~ 1. =embark-act= prompts the user for an action and performs it. GAV: ~org-mode~
and ~embark~ do not play together nicely. and ~embark~ do not play together nicely.
2. Except for highlighting of email and web URLs, =embark-dwim= englobes the 2. Except for highlighting of email and web URLs, =embark-dwim= englobes the
functionality of src_emacs-lisp{(find-library "goto-addr")} that activates functionality of src_emacs-lisp[:results none]{(find-library "goto-addr")}
mail and web URLs to turn them into clickable buttons. Since =embark-dwim= that activates mail and web URLs to turn them into clickable buttons. Since
acts on a superset of target types, it renders =goto-addr= superfluous. See: =embark-dwim= acts on a superset of target types, it renders =goto-addr=
superfluous. See:
1. [[info:emacs#Goto Address mode][Goto Address mode (info)]]. 1. [[info:emacs#Goto Address mode][Goto Address mode (info)]].
2. [[info:embark#The default action on a target][The default (embark-dwim) action on a target (info)]]. 2. [[info:embark#The default action on a target][The default (embark-dwim) action on a target (info)]].
3. =embark-bindings= allows to explore all current command key bindings in the 3. =embark-bindings= allows to explore all current command key bindings in the
@ -3883,7 +3884,7 @@ how to use [[info:emacs#Keyboard Macros][Keyboard Macros (info)]] to exploit [[h
misspellings for machines]]. Listing [[lst:misspellings-abbrev]] defines his keyboard misspellings for machines]]. Listing [[lst:misspellings-abbrev]] defines his keyboard
macro under the name =misspellings-abrev=. I have used those directions to macro under the name =misspellings-abrev=. I have used those directions to
define src_emacs-lisp[:results silent]{(describe-variable 'global-abbrev-table)} define src_emacs-lisp[:results silent]{(describe-variable 'global-abbrev-table)}
and to store it in src_emacs-lisp[:results silent]{(describe-variable and to store it in src_emacs-lisp[:results none]{(describe-variable
'abbrev-file-name)} to manage its changes with git. I can change the 'abbrev-file-name)} to manage its changes with git. I can change the
abbreviation definitions in this file by means of: abbreviation definitions in this file by means of:
1. Execute src_emacs-lisp[:results silent]{(edit-abbrevs)} to alter abbreviation 1. Execute src_emacs-lisp[:results silent]{(edit-abbrevs)} to alter abbreviation
@ -4391,7 +4392,7 @@ for use with [[http://www.sbcl.org/][Steel Bank Common Lisp (sbcl)]]:
Listing [[lst:slink-sel]] allows to set or get the Sly string elision length. Listing [[lst:slink-sel]] allows to set or get the Sly string elision length.
Finally, listing [[lst:configure-sly]] uses a technique to [[info:sly#Loading Slynk faster][load Slynk faster (info)]] Finally, listing [[lst:configure-sly]] uses a technique to [[info:sly#Loading Slynk faster][load Slynk faster (info)]]
by means of a custom core file in src_emacs-lisp[:results by means of a custom core file in src_emacs-lisp[:results
silent]{(describe-variable 'no-littering-var-directory)}. Listing none]{(describe-variable 'no-littering-var-directory)}. Listing
[[lst:sbcl-core-for-sly]] tangles to a script to dump such a [[http://www.sbcl.org/][SBCL]] core. [[lst:sbcl-core-for-sly]] tangles to a script to dump such a [[http://www.sbcl.org/][SBCL]] core.
#+caption[Configure =sly=]: #+caption[Configure =sly=]:
@ -4988,7 +4989,7 @@ wiki entry as in [[info:elisp#Edebug][Edebug (info)]].
Listing [[lst:setup-ielm][setup ielm]] configures the [[https://wikemacs.org/wiki/IELM][Interactive Emacs Lisp Mode]] for better Listing [[lst:setup-ielm][setup ielm]] configures the [[https://wikemacs.org/wiki/IELM][Interactive Emacs Lisp Mode]] for better
interoperability with [[https://smartparens.readthedocs.io/en/latest/][smartparens]]: get help on the key bindings by means of interoperability with [[https://smartparens.readthedocs.io/en/latest/][smartparens]]: get help on the key bindings by means of
src_emacs-lisp[:results silent]{(describe-function 'ielm)}. src_emacs-lisp[:results none]{(describe-function 'ielm)}.
#+caption[Setup =ielm=]: #+caption[Setup =ielm=]:
#+caption: Setup =ielm=. #+caption: Setup =ielm=.
@ -5121,7 +5122,7 @@ of [[https://github.com/jorgenschaefer/pyvenv#readme][pyvenv]]). Therefore, I r
Install [[https://github.com/PyCQA/isort#readme][isort]] and [[https://github.com/PyCQA/pyflakes#readme][pyflakes]] to enable adding, removing, sorting, and fixing Install [[https://github.com/PyCQA/isort#readme][isort]] and [[https://github.com/PyCQA/pyflakes#readme][pyflakes]] to enable adding, removing, sorting, and fixing
import statements in [[https://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/progmodes/python.el][Python-mode]], see the end of the commentary import statements in [[https://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/progmodes/python.el][Python-mode]], see the end of the commentary
src_emacs-lisp[:results silent]{(find-library "python")} section. src_emacs-lisp[:results none]{(find-library "python")} section.
Listing [[lst:pyproject-toml-kickoff][kickoff pyproject.toml proposal]] facilitates dropping a [[https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml][pyproject.toml]] Listing [[lst:pyproject-toml-kickoff][kickoff pyproject.toml proposal]] facilitates dropping a [[https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml][pyproject.toml]]
file into Python projects which anyhow should switch to using a [[https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml][pyproject.toml]] file into Python projects which anyhow should switch to using a [[https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml][pyproject.toml]]
@ -5484,7 +5485,7 @@ file in the root directory of any [[https://www.python.org][Python]] project to
according to the configuration in listing [[lst:eglot-maybe-ensure]]. according to the configuration in listing [[lst:eglot-maybe-ensure]].
Type {{{kbd(M-x eglot-show-workspace-configuration)}}} to dump a =JSON= Type {{{kbd(M-x eglot-show-workspace-configuration)}}} to dump a =JSON=
representation of src_emacs-lisp[:results silent]{(describe-variable representation of src_emacs-lisp[:results none]{(describe-variable
'eglot-workspace-configuration)} for debugging. 'eglot-workspace-configuration)} for debugging.
#+caption[Configure =eglot= with =python-lsp-ruff=]: #+caption[Configure =eglot= with =python-lsp-ruff=]:
@ -5754,10 +5755,10 @@ following links show how to put the documentation to practical use:
differ and discusses options how to handle those differences. differ and discusses options how to handle those differences.
Listing [[lst:configure-smartparens]] aims to configure [[https://github.com/Fuco1/smartparens][smartparens]] for Go, LaTeX, Listing [[lst:configure-smartparens]] aims to configure [[https://github.com/Fuco1/smartparens][smartparens]] for Go, LaTeX,
Lisp dialects, Org, and Python. Execute src_emacs-lisp[:results Lisp dialects, Org, and Python. Execute src_emacs-lisp[:results
silent]{(sp-cheat-sheet)} for short documentation taking into account the none]{(sp-cheat-sheet)} for short documentation taking into account the
overridden key bindings in listing [[lst:configure-smartparens]]. Table overridden key bindings in listing [[lst:configure-smartparens]]. Table
[[tab:smartparens-commands-and-bindings]] lists commands with key bindings taken in [[tab:smartparens-commands-and-bindings]] lists commands with key bindings taken in
order from src_emacs-lisp[:results silent]{(sp-cheat-sheet)} that takes the order from src_emacs-lisp[:results none]{(sp-cheat-sheet)} that takes the
overrides of listing [[lst:configure-smartparens]] into account. overrides of listing [[lst:configure-smartparens]] into account.
Despite the provocative post [[https://andreyorst.gitlab.io/posts/2022-02-20-what-if-structural-editing-was-a-mistake/]["What if structural editing was a mistake?"]], Despite the provocative post [[https://andreyorst.gitlab.io/posts/2022-02-20-what-if-structural-editing-was-a-mistake/]["What if structural editing was a mistake?"]],