branch: externals/transient
commit bcd9fbe22e87e607f5e1259bdc85c87f57a78ceb
Author: Jonas Bernoulli <jo...@bernoul.li>
Commit: Jonas Bernoulli <jo...@bernoul.li>
manual: Use new "dfn" macro
---
docs/.orgconfig | 1 +
docs/transient.org | 8 ++++----
docs/transient.texi | 8 ++++----
3 files changed, 9 insertions(+), 8 deletions(-)
diff --git a/docs/.orgconfig b/docs/.orgconfig
index 92cfc92bae..ec583bb199 100644
--- a/docs/.orgconfig
+++ b/docs/.orgconfig
@@ -10,5 +10,6 @@
#+macro: var @@texinfo:@var{@@$1@@texinfo:}@@
#+macro: kbdvar (eval (format "@@texinfo:@kbd{@@%s@@texinfo:}@@" (let
(case-fold-search) (replace-regexp-in-string "<\\([a-zA-Z-]+\\)>"
"@@texinfo:@var{@@\\1@@texinfo:}@@" (replace-regexp-in-string
org-texinfo--quoted-keys-regexp "@@texinfo:@key{@@\\&@@texinfo:}@@" $1 t) t))))
#+macro: codevar (eval (let (case-fold-search) (format
"@@texinfo:@code{@@%s@@texinfo:}@@" (replace-regexp-in-string
"\\([A-Z][A-Z-]+\\)" "@@texinfo:@var{@@\\&@@texinfo:}@@" $1 t))))
+#+macro: dfn @@texinfo:@dfn{@@$1@@texinfo:}@@
#+language: en
diff --git a/docs/transient.org b/docs/transient.org
index ff4e35aaf0..c28a675e2c 100644
--- a/docs/transient.org
+++ b/docs/transient.org
@@ -62,10 +62,10 @@ commands (a prefix and a suffix) we prefer to call it just a
Transient keymaps are a feature provided by Emacs. Transients as
implemented by this package involve the use of transient keymaps.
-Emacs provides a feature that it calls "prefix commands". When we
+Emacs provides a feature that it calls {{{dfn(prefix commands)}}}. When we
talk about "prefix commands" in this manual, then we mean our own kind
of "prefix commands", unless specified otherwise. To avoid ambiguity
-we sometimes use the terms "transient prefix command" for our kind and
+we sometimes use the terms {{{dfn(transient prefix command)}}} for our kind and
"regular prefix command" for Emacs' kind.
#+end_quote
@@ -409,11 +409,11 @@ Git for a decade, while others are just getting started
now.
#+cindex: levels
For that reason a mechanism is needed that authors can use to classify a
transient's infixes and suffixes along the essentials...everything
-spectrum. We use the term "levels" to describe that mechanism.
+spectrum. We use the term {{{dfn(levels)}}} to describe that mechanism.
#+cindex: transient-level
Each suffix command is placed on a level and each transient has a
-level (called transient-level), which controls which suffix commands
+level (called {{{dfn(transient-level)}}}), which controls which suffix commands
are available. Integers between 1 and 7 (inclusive) are valid levels.
For suffixes, 0 is also valid; it means that the suffix is not
displayed at any level.
diff --git a/docs/transient.texi b/docs/transient.texi
index 2d06cefcf3..01a15afabd 100644
--- a/docs/transient.texi
+++ b/docs/transient.texi
@@ -165,10 +165,10 @@ commands (a prefix and a suffix) we prefer to call it
just a
Transient keymaps are a feature provided by Emacs. Transients as
implemented by this package involve the use of transient keymaps.
-Emacs provides a feature that it calls "prefix commands". When we
+Emacs provides a feature that it calls @dfn{prefix commands}. When we
talk about "prefix commands" in this manual, then we mean our own kind
of "prefix commands", unless specified otherwise. To avoid ambiguity
-we sometimes use the terms "transient prefix command" for our kind and
+we sometimes use the terms @dfn{transient prefix command} for our kind and
"regular prefix command" for Emacs' kind.
@end quotation
@@ -564,11 +564,11 @@ Git for a decade, while others are just getting started
now.
@cindex levels
For that reason a mechanism is needed that authors can use to classify a
transient's infixes and suffixes along the essentials@dots{}everything
-spectrum. We use the term "levels" to describe that mechanism.
+spectrum. We use the term @dfn{levels} to describe that mechanism.
@cindex transient-level
Each suffix command is placed on a level and each transient has a
-level (called transient-level), which controls which suffix commands
+level (called @dfn{transient-level}), which controls which suffix commands
are available. Integers between 1 and 7 (inclusive) are valid levels.
For suffixes, 0 is also valid; it means that the suffix is not
displayed at any level.
