Improve text explaining the last commit

This commit is contained in:
Gerard Vermeulen 2023-12-16 15:15:56 +01:00
parent 2c9932c95a
commit d179453a81

View File

@ -2245,8 +2245,10 @@ list detailing and motivating each listing:
2. Listing [[lst:setup-org-babel]] handles basic [[https://orgmode.org/][Org-mode]] options specific to
[[info:org#Working with Source Code][work with source code (info)]].
3. Listing [[lst:ob-tangle-plus]] extends [[info:org#Noweb Reference Syntax][source code export (info)]] with the
possibility to tangle Emacs Lisp files into a directory specified by a
top-level variable.
possibility to tangle of for instance Emacs Lisp files (or other programming
mode files) into a directory specified by ~org-babel-post-tangle-dir~ which
can be changed using =org-get-entry= to read lines like ~#+property:
tangle-dir: ANY-PLACE~ near the beginning an Org file.
4. Listing [[lst:set-org-link-options]] handles [[https://orgmode.org/][Org-mode]] options specific to
[[info:org#Hyperlinks][hyperlinks (info)]].
5. Listing [[lst:setup-org-mode-map]] extends the =org-mode-map= with useful
@ -2334,14 +2336,15 @@ list detailing and motivating each listing:
(setopt org-babel-lisp-eval-fn #'sly-eval)))
#+end_src
#+caption[Add extra functionality to =ob-tangle=]:
#+caption: Add extra functionality to =ob-tangle=.
#+caption[Change the =org-babel-tangle= destination to a specific directory]:
#+caption: Change the =org-babel-tangle= destination to a specific directory.
#+name: lst:ob-tangle-plus
#+begin_src emacs-lisp -n
(with-eval-after-load 'emacs
;; Modified from https://emacs.stackexchange.com/a/61364 which replies to
;; https://emacs.stackexchange.com/questions/61359/
;; "How to specify a directory to tangle all code blocks into".
;; Org usage example, add a line: #+property: tangle-dir ./site-lisp/
(defcustom org-babel-post-tangle-dir nil
"Destination directory used by `dir+org-babel-post-tangle'.