From 85217735d8d52955b999821d4f9642c5118d12a1 Mon Sep 17 00:00:00 2001 From: Gerard Vermeulen Date: Wed, 12 Jun 2024 10:58:48 +0200 Subject: [PATCH] Fix "src_emacs-lisp" results --- README.org | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/README.org b/README.org index 817eaf0..349d68a 100644 --- a/README.org +++ b/README.org @@ -1077,8 +1077,8 @@ looks for files. :CUSTOM_ID: sec:enable-disabled-commands :END: -Execute src_emacs-lisp{(find-library "novice")} to see how Emacs prevents new -users from shooting themselves in the feet. Listing +Execute src_emacs-lisp[:results none]{(find-library "novice")} to see how Emacs +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]]. #+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~ and ~embark~ do not play together nicely. 2. Except for highlighting of email and web URLs, =embark-dwim= englobes the - functionality of src_emacs-lisp{(find-library "goto-addr")} that activates - mail and web URLs to turn them into clickable buttons. Since =embark-dwim= - acts on a superset of target types, it renders =goto-addr= superfluous. See: + functionality of src_emacs-lisp[:results none]{(find-library "goto-addr")} + that activates mail and web URLs to turn them into clickable buttons. Since + =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)]]. 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 @@ -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 macro under the name =misspellings-abrev=. I have used those directions to 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 abbreviation definitions in this file by means of: 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. 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 -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. #+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 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=. @@ -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 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]] 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]]. 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. #+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. 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 -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 [[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. 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?"]],