branch: externals/transient
commit 4a823dbf7f57f97877a519d12b949b5b202d517c
Author: Jonas Bernoulli <jo...@bernoul.li>
Commit: Jonas Bernoulli <jo...@bernoul.li>
manual: Add an example for transient-append-suffix
---
docs/transient.org | 11 ++++++++++-
docs/transient.texi | 11 ++++++++++-
2 files changed, 20 insertions(+), 2 deletions(-)
diff --git a/docs/transient.org b/docs/transient.org
index a28e906e86..1551230f11 100644
--- a/docs/transient.org
+++ b/docs/transient.org
@@ -736,7 +736,16 @@ These options are mainly intended for developers.
To an extent, transients can be customized interactively, see
[[*Enabling and Disabling Suffixes]]. This section explains how existing
-transients can be further modified non-interactively.
+transients can be further modified non-interactively. Let's begin
+with an example:
+
+#+begin_src emacs-lisp
+ (transient-append-suffix 'magit-patch-apply "-3"
+ '("-R" "Apply in reverse" "--reverse"))
+#+end_src
+
+This inserts a new infix argument to toggle the ~--reverse~ argument
+after the infix argument that toggles ~-3~ in ~magit-patch-apply~.
The following functions share a few arguments:
diff --git a/docs/transient.texi b/docs/transient.texi
index deca28cc7d..281c97e187 100644
--- a/docs/transient.texi
+++ b/docs/transient.texi
@@ -900,7 +900,16 @@ same customization.
To an extent, transients can be customized interactively, see
@ref{Enabling and Disabling Suffixes}. This section explains how existing
-transients can be further modified non-interactively.
+transients can be further modified non-interactively. Let's begin
+with an example:
+
+@lisp
+(transient-append-suffix 'magit-patch-apply "-3"
+ '("-R" "Apply in reverse" "--reverse"))
+@end lisp
+
+This inserts a new infix argument to toggle the @code{--reverse} argument
+after the infix argument that toggles @code{-3} in @code{magit-patch-apply}.
The following functions share a few arguments:
