Remove listing with obsolete kludges

This commit is contained in:
Gerard Vermeulen 2024-06-10 19:55:26 +02:00
parent 1ecb41522d
commit 6d7d8e1893

View File

@ -2204,32 +2204,29 @@ Links to Org-mode videos are:
:ID: 0D725DA1-7431-40BD-85FF-EFF4F7E4EC95 :ID: 0D725DA1-7431-40BD-85FF-EFF4F7E4EC95
:END: :END:
I have split the initial [[https://orgmode.org/][Org-mode]] setup over fourteen listings. Here, follows a I have split the initial [[https://orgmode.org/][Org-mode]] setup over thirteen listings. Here, follows a
list detailing and motivating each listing: list detailing and motivating each listing:
1. Listing [[lst:set-org-options]] handles basic [[https://orgmode.org/][Org-mode]] options. 1. Listing [[lst:set-org-options]] handles basic [[https://orgmode.org/][Org-mode]] options.
2. Listing [[lst:org-capture-templates]] initializes a simple capture template. 2. Listing [[lst:org-capture-templates]] initializes a simple capture template.
3. Listing [[lst:setup-org-babel]] sets ~ob-core~, ~ob-latex~, and ~ob-lisp~ options. 3. Listing [[lst:setup-org-babel]] sets ~ob-core~, ~ob-latex~, and ~ob-lisp~ options.
See [[info:org#Working with Source Code][working with source code (info)]] for Org Babel information. See [[info:org#Working with Source Code][working with source code (info)]] for Org Babel information.
4. Listing [[lst:no-org-babel-eval]] prevents evaluation of blocks without an 4. Listing [[lst:set-org-link-options]] handles [[https://orgmode.org/][Org-mode]] options specific to
=org-babel-execute:<LANG>= function and adds fake =org-babel-execute:<LANG>=
functions to silence {{{kbd(M-x org-lint)}}} warnings.
5. Listing [[lst:set-org-link-options]] handles [[https://orgmode.org/][Org-mode]] options specific to
[[info:org#Hyperlinks][hyperlinks (info)]]. [[info:org#Hyperlinks][hyperlinks (info)]].
6. Listing [[lst:looking-at-org-id]] enables recent ~org-id~ features. 5. Listing [[lst:looking-at-org-id]] enables recent ~org-id~ features.
7. Listing [[lst:setup-org-mode-map-1]] and [[lst:setup-org-mode-map-2]] extend the 6. Listing [[lst:setup-org-mode-map-1]] and [[lst:setup-org-mode-map-2]] extend the
=org-mode-map= with useful key-bindings. =org-mode-map= with useful key-bindings.
8. Listing [[lst:setup-org-src]] facilitates [[info:org#Editing Source Code][editing source code blocks]], and it 7. Listing [[lst:setup-org-src]] facilitates [[info:org#Editing Source Code][editing source code blocks]], and it
provides functions to change the indentation of all =org-src-mode= blocks. provides functions to change the indentation of all =org-src-mode= blocks.
9. Listing [[lst:setup-ob-python]] allows to pretty-print Python session source 8. Listing [[lst:setup-ob-python]] allows to pretty-print Python session source
block values with [[https://github.com/psf/black#readme][black]] instead of [[https://docs.python.org/3/library/pprint.html][pprint]]. This snippet may break in the block values with [[https://github.com/psf/black#readme][black]] instead of [[https://docs.python.org/3/library/pprint.html][pprint]]. This snippet may break in the
future, because it sets =org-babel-python--def-format-value= which is a future, because it sets =org-babel-python--def-format-value= which is a
constant declared "private" by two dashes in its name! constant declared "private" by two dashes in its name!
10. Listing [[lst:set-org-export-options]] selects the =non-intrusive= expert user 9. Listing [[lst:set-org-export-options]] selects the =non-intrusive= expert user
interface for export dispatching. interface for export dispatching.
11. Listing [[lst:setup-org-for-lualatex-export]] and 10. Listing [[lst:setup-org-for-lualatex-export]] and
[[lst:set-ox-latex-options-for-lualatex-export]] configure [[https://orgmode.org/][Org-mode]] to generate [[lst:set-ox-latex-options-for-lualatex-export]] configure [[https://orgmode.org/][Org-mode]] to generate
output for the LuaLaTeX compiler. output for the LuaLaTeX compiler.
12. Listing [[lst:setup-org-latex-classes]] defines [[info:org#LaTeXspecificexportsettings][org-latex-classes (info)]] for 11. Listing [[lst:setup-org-latex-classes]] defines [[info:org#LaTeXspecificexportsettings][org-latex-classes (info)]] for
backward compatibility. For an explanation of the code in listing backward compatibility. For an explanation of the code in listing
[[lst:setup-org-latex-classes]], type {{{kbd(C-h v org-latex-classes)}}}. [[lst:setup-org-latex-classes]], type {{{kbd(C-h v org-latex-classes)}}}.
@ -2305,26 +2302,6 @@ list detailing and motivating each listing:
(setopt org-babel-lisp-eval-fn #'sly-eval))) (setopt org-babel-lisp-eval-fn #'sly-eval)))
#+end_src #+end_src
#+caption[Unevaluable source blocks]:
#+caption: Unevaluable source blocks.
#+name: lst:no-org-babel-eval
#+begin_src emacs-lisp -n :results silent
(defvar org-babel-default-header-args:conf '((:eval . "no")))
(defvar org-babel-default-header-args:diff '((:eval . "no")))
(defvar org-babel-default-header-args:text '((:eval . "no")))
(defvar org-babel-default-header-args:toml '((:eval . "no")))
;;; Kludges to silence `org-lint' warnings:
(defun org-babel-execute:conf (_body _params)
"Silence `org-lint' warnings." nil)
(defun org-babel-execute:diff (_body _params)
"Silence `org-lint' warnings." nil)
(defun org-babel-execute:text (_body _params)
"Silence `org-lint' warnings." nil)
(defun org-babel-execute:toml (_body _params)
"Silence `org-lint' warnings." nil)
#+end_src
#+caption[Set =org-link= options]: #+caption[Set =org-link= options]:
#+caption: Set =org-link= options. #+caption: Set =org-link= options.
#+name: lst:set-org-link-options #+name: lst:set-org-link-options