dotfiles-misc/protesilaos.dotfiles
1
0
Fork 0
mirror of https://github.com/protesilaos/dotfiles.git synced 2026-09-10 07:16:20 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

emacs: reword FAQ about outline-minor-mode and related

Browse source
This commit is contained in:
Protesilaos Stavrou 2024-01-07 19:27:49 +02:00
parent efdf4b5de3
commit 3bee66ffa9
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
1 changed files with 19 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
emacs/.emacs.d/prot-emacs.org
View file

@ -15693,20 +15693,30 @@ but also in all my public-facing Emacs packages. You can spot the
entries to the outline as comments that have three or more delimiters.
I can thus visit the =.el= file I am interested in and enable
~outline-minor-mode~ to get the folding capabilities and extras.
Furthermore, I can use the ~consult-outline~ command to navigate to a
heading with minibuffer completion.
Furthermore, I can use the ~consult-outline~ or ~prot-search-outline~
command to navigate to a heading with minibuffer completion.
What the =prot-emacs.org= provides is an /optional single point of
entry/ to my Emacs configuration. I use this to produce all the
individual files ([[#h:103d6f5a-bdb1-4b49-946a-708a83c79a7d][Anatomy of my Emacs configuration]]). It allows me to
document my comprehensive corpus of work for the benefit of the Emacs
community at-large. I can establish links between sections and use
richer typography, something that ~outline-minor-mode~ does not
provide. This document is exported to my website as a standalone web
page. People can find what they want there. They may also read the
source of this file to learn more about the technicalities of how this
is done. And they can still use only the =.el= files, if they do not
want to deal with Org. Everybody is covered.
community at-large:
- I can establish links between sections and use richer typography,
something that ~outline-minor-mode~ does not provide.
- The extensive commentary included herein is not added to the source
code, thus making it easier for me or others to focus on the
programming parts when we want to.
- This document is exported to my website as a standalone web page.
People can find what they need there and share it with friends,
regardless of their skill level.
- Anyone may read the source of this file to learn more about the
technicalities of how this is done. And they can still use only the
=.el= files, if they do not want to deal with Org. Everybody is
covered.
The =prot-emacs.org= *does not introduce a dependency on Org mode*.
This file is not loaded at startup. I can remove =prot-emacs.org= at