Silence `writegood-mode' more
This commit is contained in:
parent
bc59dc48bd
commit
0438a6c702
47
README.org
47
README.org
@ -136,15 +136,15 @@ Here follows a list of interesting Emacs configurations:
|
|||||||
silently ignore the setup stanzas of uninstalled extension packages.
|
silently ignore the setup stanzas of uninstalled extension packages.
|
||||||
5. [[https://sachachua.com/dotemacs/][Sacha Chua's configuration]] is a practical example of producing the Emacs
|
5. [[https://sachachua.com/dotemacs/][Sacha Chua's configuration]] is a practical example of producing the Emacs
|
||||||
initialization files by tangling an [[info:org#Top][org]] file. It gives me the impression
|
initialization files by tangling an [[info:org#Top][org]] file. It gives me the impression
|
||||||
that she is a very practical person trying to achieve her goals by the most
|
that she is a practical person trying to achieve her goals by the most
|
||||||
efficient means.
|
efficient means.
|
||||||
6. [[https://github.com/purcell/emacs.d][Steve Purcell's configuration]] is well organized and a showcase of readable
|
6. [[https://github.com/purcell/emacs.d][Steve Purcell's configuration]] is well organized and a showcase of readable
|
||||||
code. Its commit and issue histories are also helpful: see for instance the
|
code. Its commit and issue histories are also helpful: see for instance the
|
||||||
discussion [[https://github.com/purcell/emacs.d/issues/778][The order of company candidates is incorrect in Emacs lisp mode]].
|
discussion [[https://github.com/purcell/emacs.d/issues/778][The order of company candidates is incorrect in Emacs lisp mode]].
|
||||||
|
|
||||||
Here follows a list of links on how to use Emacs and Elisp:
|
Here follows a list of links on how to use Emacs and Elisp:
|
||||||
1. [[https://www.masteringemacs.org/][Mastering Emacs]] is a link to a blog with many interesting posts that promotes
|
1. [[https://www.masteringemacs.org/][Mastering Emacs]] is a link to a blog with interesting posts that promotes a
|
||||||
a book on how to become a proficient Emacs user.
|
book on how to become a proficient Emacs user.
|
||||||
2. [[https://www2.lib.uchicago.edu/keith/emacs/][Use GNU Emacs: The Plain Text Computing Environment]] explains the fundamentals
|
2. [[https://www2.lib.uchicago.edu/keith/emacs/][Use GNU Emacs: The Plain Text Computing Environment]] explains the fundamentals
|
||||||
of the Emacs abstractions before showing how to exploit those abstractions
|
of the Emacs abstractions before showing how to exploit those abstractions
|
||||||
interactively. It targets a similar audience as the [[https://www.masteringemacs.org/][Mastering Emacs]] book.
|
interactively. It targets a similar audience as the [[https://www.masteringemacs.org/][Mastering Emacs]] book.
|
||||||
@ -155,7 +155,7 @@ Here follows a list of links on how to use Emacs and Elisp:
|
|||||||
4. [[https://www.youtube.com/watch?v=6ZWp05OW1c0][Emergency Emacs]] is a link to a video on fundamental editing features and
|
4. [[https://www.youtube.com/watch?v=6ZWp05OW1c0][Emergency Emacs]] is a link to a video on fundamental editing features and
|
||||||
principles with focus on [[info:ediff#Top][ediff (info)]], [[info:emacs#Undo][undo (info)]], [[info:emacs#Moving Point][moving point (info)]],
|
principles with focus on [[info:ediff#Top][ediff (info)]], [[info:emacs#Undo][undo (info)]], [[info:emacs#Moving Point][moving point (info)]],
|
||||||
[[info:emacs#Erasing][erasing (info)]], and [[info:emacs#Dynamic Abbrevs][dynamic abbreviations (info)]].
|
[[info:emacs#Erasing][erasing (info)]], and [[info:emacs#Dynamic Abbrevs][dynamic abbreviations (info)]].
|
||||||
5. [[https://endlessparentheses.com/][Endless Parentheses]] is a blog with many mindblowing code snippets.
|
5. [[https://endlessparentheses.com/][Endless Parentheses]] is a blog with mindblowing code snippets.
|
||||||
6. [[https://www.murilopereira.com/how-to-open-a-file-in-emacs/][How to open a file in Emacs]] looks into [[info:elisp#Top][elisp (info)]] and
|
6. [[https://www.murilopereira.com/how-to-open-a-file-in-emacs/][How to open a file in Emacs]] looks into [[info:elisp#Top][elisp (info)]] and
|
||||||
[[info:elisp#Debugging][elisp debugging (info)]] and then compares Emacs, [[https://www.vim.org/][Vim]],
|
[[info:elisp#Debugging][elisp debugging (info)]] and then compares Emacs, [[https://www.vim.org/][Vim]],
|
||||||
[[https://neovim.io/][Neovim]], and [[https://code.visualstudio.com/][Visual Studio Code]] with respect to values and technology.
|
[[https://neovim.io/][Neovim]], and [[https://code.visualstudio.com/][Visual Studio Code]] with respect to values and technology.
|
||||||
@ -536,11 +536,14 @@ Listing [[lst:set-default-face-height]] shows that font scaling is easy in case
|
|||||||
proper initialization of all face heigths. To adjust the font size in the
|
proper initialization of all face heigths. To adjust the font size in the
|
||||||
current or future frames, invoke src_emacs-lisp{(set-default-face-height)}. To
|
current or future frames, invoke src_emacs-lisp{(set-default-face-height)}. To
|
||||||
adjust the font size in the current buffer, type:
|
adjust the font size in the current buffer, type:
|
||||||
1. {{{kbd(s-=)}}} which is bound to src_emacs-lisp{(text-scale-adjust +1)}.
|
1. {{{kbd(s-=)}}} to invoke src_emacs-lisp[:results silent]{(text-scale-adjust
|
||||||
2. {{{kbd(s--)}}} which is bound to src_emacs-lisp{(text-scale-adjust -1)}.
|
+1)}.
|
||||||
3. {{{kbd(s-0)}}} which is bound to src_emacs-lisp{(text-scale-adjust 0)}.
|
2. {{{kbd(s--)}}} to invoke src_emacs-lisp[:results silent]{(text-scale-adjust
|
||||||
|
-1)}.
|
||||||
|
3. {{{kbd(s-0)}}} to invoke src_emacs-lisp[:results silent]{(text-scale-adjust
|
||||||
|
0)}.
|
||||||
Listing [[lst:fix-gtk-color-for-invert-default-face]],
|
Listing [[lst:fix-gtk-color-for-invert-default-face]],
|
||||||
[[lst:shadow-org-font-lock-faces]], and [[lst:shadow-emacs-font-lock-faces]] show a few
|
[[lst:shadow-org-font-lock-faces]], and [[lst:shadow-emacs-font-lock-faces]] show a
|
||||||
tweaks to improve visibility without theming:
|
tweaks to improve visibility without theming:
|
||||||
1. Fixing the =gtk= background color of the already loaded =region= face.
|
1. Fixing the =gtk= background color of the already loaded =region= face.
|
||||||
2. Toggling between a dark and light background by means of
|
2. Toggling between a dark and light background by means of
|
||||||
@ -631,7 +634,7 @@ Scale all other faces with a height that is a real number."
|
|||||||
:inherit (fixed-pitch)
|
:inherit (fixed-pitch)
|
||||||
,@(and (>= emacs-major-version 27) '(:extend t))
|
,@(and (>= emacs-major-version 27) '(:extend t))
|
||||||
:background "#FFFFD0"))
|
:background "#FFFFD0"))
|
||||||
"My face used for text inside various blocks.
|
"My face used for text inside blocks.
|
||||||
|
|
||||||
It is always used for source blocks. You can refine what face
|
It is always used for source blocks. You can refine what face
|
||||||
should be used depending on the source block language by setting,
|
should be used depending on the source block language by setting,
|
||||||
@ -843,8 +846,8 @@ BUG: The virtual buffers of the ~consult-buffer~ command do not seem to work.
|
|||||||
Therefore, ~consult-buffer~ is no means to access the bookmark history (contrary
|
Therefore, ~consult-buffer~ is no means to access the bookmark history (contrary
|
||||||
to claims in [[info:consult#Top][consult (info)]]).
|
to claims in [[info:consult#Top][consult (info)]]).
|
||||||
|
|
||||||
#+caption[Let Emacs save bookmarks when it is killed]:
|
#+caption[Let Emacs save bookmarks when killed]:
|
||||||
#+caption: Let Emacs save bookmarks when it is killed.
|
#+caption: Let Emacs save bookmarks when killed.
|
||||||
#+name: lst:setup-bookmark
|
#+name: lst:setup-bookmark
|
||||||
#+begin_src emacs-lisp -n :results silent
|
#+begin_src emacs-lisp -n :results silent
|
||||||
(with-eval-after-load 'bookmark
|
(with-eval-after-load 'bookmark
|
||||||
@ -2288,8 +2291,7 @@ list detailing and motivating each listing:
|
|||||||
4. Listing [[lst:ob-tangle-plus]] extends [[info:org#Noweb Reference Syntax][source code export (info)]] with the
|
4. Listing [[lst:ob-tangle-plus]] extends [[info:org#Noweb Reference Syntax][source code export (info)]] with the
|
||||||
possibility to tangle of for instance Emacs Lisp files (or other programming
|
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
|
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:
|
~toggle-post-tangle-hook-dir-usage~ may change.
|
||||||
tangle-dir: ANY-PLACE~ near the beginning an Org file.
|
|
||||||
5. Listing [[lst:set-org-link-options]] handles [[https://orgmode.org/][Org-mode]] options specific to
|
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: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
|
||||||
@ -2460,7 +2462,7 @@ When prefix ARG is non-nil, prompt first for a language."
|
|||||||
|
|
||||||
(defcustom org-babel-post-tangle-dir nil
|
(defcustom org-babel-post-tangle-dir nil
|
||||||
"Destination directory used by `dir+org-babel-post-tangle'.
|
"Destination directory used by `dir+org-babel-post-tangle'.
|
||||||
May be changed by `toggle-post-tangle-hook-dir-usage'."
|
Is subject to change by `toggle-post-tangle-hook-dir-usage'."
|
||||||
:group 'org-babel)
|
:group 'org-babel)
|
||||||
|
|
||||||
(defcustom org-babel-post-tangle-dir-modes '(emacs-lisp-mode)
|
(defcustom org-babel-post-tangle-dir-modes '(emacs-lisp-mode)
|
||||||
@ -3323,7 +3325,7 @@ processor, text to product convertor) to an Emacs setup. Listing
|
|||||||
|
|
||||||
Ref. [cite:@Schulte.MCSE.2011.41] shows that [[https://orgmode.org/][Org-mode]] is a simple, plain-text
|
Ref. [cite:@Schulte.MCSE.2011.41] shows that [[https://orgmode.org/][Org-mode]] is a simple, plain-text
|
||||||
markup language for hierarchical documents allowing intermingling of data, code,
|
markup language for hierarchical documents allowing intermingling of data, code,
|
||||||
and prose. It serves as an example link to to show how to use [[https://github.com/bdarcus/citar][Citar]] within this
|
and prose. It serves as an example link to show how to use [[https://github.com/bdarcus/citar][Citar]] within this
|
||||||
setup, provided that =citar-bibliography= and =citar-library-paths= point to
|
setup, provided that =citar-bibliography= and =citar-library-paths= point to
|
||||||
valid directories and files. In an [[https://orgmode.org/][Org-mode]] buffer this setup allows to:
|
valid directories and files. In an [[https://orgmode.org/][Org-mode]] buffer this setup allows to:
|
||||||
1. Insert one or more [[https://orgmode.org/][Org-mode]] cite links:
|
1. Insert one or more [[https://orgmode.org/][Org-mode]] cite links:
|
||||||
@ -3632,8 +3634,7 @@ facilate moving single directories or whole directory trees."
|
|||||||
(let ((path (match-string 1 link))
|
(let ((path (match-string 1 link))
|
||||||
(page (and (match-beginning 2)
|
(page (and (match-beginning 2)
|
||||||
(string-to-number (match-string 2 link)))))
|
(string-to-number (match-string 2 link)))))
|
||||||
;; Let Org mode open the file (in-emacs = 1) to ensure
|
;; Let Org mode open the file to respect org-link-frame-setup.
|
||||||
;; org-link-frame-setup is respected.
|
|
||||||
(org-open-file path 1)
|
(org-open-file path 1)
|
||||||
(when page (pdf-view-goto-page page))))
|
(when page (pdf-view-goto-page page))))
|
||||||
|
|
||||||
@ -3934,7 +3935,7 @@ Load all test files first."
|
|||||||
;; test-ob-exp/noweb-on-export fails due to spacing (can't fix).
|
;; test-ob-exp/noweb-on-export fails due to spacing (can't fix).
|
||||||
;; test-ob-exp/noweb-on-export-with-exports-results due to spacing (idem).
|
;; test-ob-exp/noweb-on-export-with-exports-results due to spacing (idem).
|
||||||
;; ob-maxima fixed but spacing is fragile. Which Maxima?
|
;; ob-maxima fixed but spacing is fragile. Which Maxima?
|
||||||
;; ob-python hangs sometimes, but very seldom.
|
;; ob-python hangs sometimes, but seldom.
|
||||||
;; ob-tangle/continued-code-blocks-w-noweb-ref fails.
|
;; ob-tangle/continued-code-blocks-w-noweb-ref fails.
|
||||||
(ert (rx (or "org/" "org-fold" "org-element" "org-macro" "org-src"
|
(ert (rx (or "org/" "org-fold" "org-element" "org-macro" "org-src"
|
||||||
"property-inheritance"
|
"property-inheritance"
|
||||||
@ -6022,8 +6023,8 @@ packages:
|
|||||||
2. [[https://jedi.readthedocs.io/en/latest/][Jedi]] is a static analysis tool for Python that is typically used in plugins
|
2. [[https://jedi.readthedocs.io/en/latest/][Jedi]] is a static analysis tool for Python that is typically used in plugins
|
||||||
for editors or integrated development environments. Jedi has a focus on
|
for editors or integrated development environments. Jedi has a focus on
|
||||||
autocompletion and object definition lookup functionality.
|
autocompletion and object definition lookup functionality.
|
||||||
3. [[https://github.com/charliermarsh/ruff#readme][Ruff]] is an extremely fast Python linter and a replacement for [[https://flake8.pycqa.org/en/latest/][Flake8]] with a
|
3. Nowadays, [[https://github.com/charliermarsh/ruff#readme][Ruff]] is the fastest Python linter and a replacement for [[https://flake8.pycqa.org/en/latest/][Flake8]] with
|
||||||
variety of its plugins. [[https://notes.crmarsh.com/][Charlie Marsh]] explains why he started [[https://pypi.org/project/ruff/][Ruff]] in the
|
a variety of its plugins. [[https://notes.crmarsh.com/][Charlie Marsh]] explains why he started [[https://pypi.org/project/ruff/][Ruff]] in the
|
||||||
post [[https://notes.crmarsh.com/python-tooling-could-be-much-much-faster][Python tooling could be much faster]].
|
post [[https://notes.crmarsh.com/python-tooling-could-be-much-much-faster][Python tooling could be much faster]].
|
||||||
4. [[https://github.com/python-lsp/python-lsp-server#readme][Python LSP Server]] is in my opinion the most complete [[https://en.wikipedia.org/wiki/Language_Server_Protocol][Language Server Protocol]]
|
4. [[https://github.com/python-lsp/python-lsp-server#readme][Python LSP Server]] is in my opinion the most complete [[https://en.wikipedia.org/wiki/Language_Server_Protocol][Language Server Protocol]]
|
||||||
implementation for Python and it handles [[https://github.com/charliermarsh/ruff#readme][Ruff]] thanks to the [[https://github.com/python-lsp/python-lsp-ruff][python-lsp-ruff]]
|
implementation for Python and it handles [[https://github.com/charliermarsh/ruff#readme][Ruff]] thanks to the [[https://github.com/python-lsp/python-lsp-ruff][python-lsp-ruff]]
|
||||||
@ -6715,8 +6716,8 @@ Listing [[lst:obas-test][Org Babel Ackermann Scheme test]] allows to check wheth
|
|||||||
:END:
|
:END:
|
||||||
|
|
||||||
The library [[info:dash.info#Top][dash.el (info)]] positions itself as a modern alternative for the list
|
The library [[info:dash.info#Top][dash.el (info)]] positions itself as a modern alternative for the list
|
||||||
processing API of [[info:cl#Top][cl]]. It is a requirement of several important packages in this
|
processing API of [[info:cl#Top][cl]]. It is a requirement of important packages in this Emacs
|
||||||
Emacs setup (for instance [[https://github.com/andras-simonyi/citeproc-el#readme][citeproc]], [[https://github.com/magit/magit#readme][magit]], and [[https://github.com/Fuco1/smartparens#readme][smartparens]]). Listing
|
setup (for instance [[https://github.com/andras-simonyi/citeproc-el#readme][citeproc]], [[https://github.com/magit/magit#readme][magit]], and [[https://github.com/Fuco1/smartparens#readme][smartparens]]). Listing
|
||||||
[[lst:configure-dash]] enables fontification of =dash= macros and makes
|
[[lst:configure-dash]] enables fontification of =dash= macros and makes
|
||||||
=info-lookup-symbol= take into account the =dash= macros.
|
=info-lookup-symbol= take into account the =dash= macros.
|
||||||
|
|
||||||
@ -7135,7 +7136,7 @@ on any Org table, Org source block, Org block, or Org subtree.
|
|||||||
(user-error "Not in a table")))
|
(user-error "Not in a table")))
|
||||||
|
|
||||||
(defun narrow-or-widen-dwim (p)
|
(defun narrow-or-widen-dwim (p)
|
||||||
"Widen if buffer is narrowed, narrow \"Do What I Mean\" otherwise.
|
"Widen a narrowed buffer, narrow \"Do What I Mean\" otherwise.
|
||||||
DWIM means: region, Org table, Org source block, Org block, Org
|
DWIM means: region, Org table, Org source block, Org block, Org
|
||||||
subtree, LaTeX environment, TeX group, or defun, whichever
|
subtree, LaTeX environment, TeX group, or defun, whichever
|
||||||
applies first. Narrowing to org-src-block actually calls
|
applies first. Narrowing to org-src-block actually calls
|
||||||
|
Loading…
Reference in New Issue
Block a user