aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJonas Bernoulli2024-03-21 23:55:38 +0100
committerJonas Bernoulli2024-03-21 23:55:38 +0100
commitc214fc9626c8b37e4d155a6d3caebe2e09fd0ab2 (patch)
tree547e0c7bd23cd0eeea1abb8d3f3f5adf366aec95 /doc
parent2000d6e0f27f9f34f343016f4aa93e09c29c8695 (diff)
downloademacs-c214fc9626c8b37e4d155a6d3caebe2e09fd0ab2.tar.gz
emacs-c214fc9626c8b37e4d155a6d3caebe2e09fd0ab2.zip
Update to Transient v0.6.0-1-gcaef3347
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/transient.texi28
1 files changed, 19 insertions, 9 deletions
diff --git a/doc/misc/transient.texi b/doc/misc/transient.texi
index f76edc6b1e4..3a6486903bf 100644
--- a/doc/misc/transient.texi
+++ b/doc/misc/transient.texi
@@ -31,7 +31,7 @@ General Public License for more details.
31@finalout 31@finalout
32@titlepage 32@titlepage
33@title Transient User and Developer Manual 33@title Transient User and Developer Manual
34@subtitle for version 0.5.2 34@subtitle for version 0.6.0
35@author Jonas Bernoulli 35@author Jonas Bernoulli
36@page 36@page
37@vskip 0pt plus 1filll 37@vskip 0pt plus 1filll
@@ -53,7 +53,7 @@ resource to get over that hurdle is Psionic K's interactive tutorial,
53available at @uref{https://github.com/positron-solutions/transient-showcase}. 53available at @uref{https://github.com/positron-solutions/transient-showcase}.
54 54
55@noindent 55@noindent
56This manual is for Transient version 0.5.2. 56This manual is for Transient version 0.6.0.
57 57
58@insertcopying 58@insertcopying
59@end ifnottex 59@end ifnottex
@@ -554,7 +554,7 @@ state, you have to make sure that that state is currently active.
554@item @kbd{C-x a} (@code{transient-toggle-level-limit}) 554@item @kbd{C-x a} (@code{transient-toggle-level-limit})
555@kindex C-x a 555@kindex C-x a
556@findex transient-toggle-level-limit 556@findex transient-toggle-level-limit
557This command toggle whether suffixes that are on levels lower than 557This command toggle whether suffixes that are on levels higher than
558the level specified by @code{transient-default-level} are temporarily 558the level specified by @code{transient-default-level} are temporarily
559available anyway. 559available anyway.
560@end table 560@end table
@@ -1206,9 +1206,19 @@ The returned children must have the same form as stored in the
1206prefix's @code{transient--layout} property, but it is often more convenient 1206prefix's @code{transient--layout} property, but it is often more convenient
1207to use the same form as understood by @code{transient-define-prefix}, 1207to use the same form as understood by @code{transient-define-prefix},
1208described below. If you use the latter approach, you can use the 1208described below. If you use the latter approach, you can use the
1209@code{transient-parse-child} and @code{transient-parse-children} functions to 1209@code{transient-parse-suffixes} and @code{transient-parse-suffix} functions to
1210transform them from the convenient to the expected form. 1210transform them from the convenient to the expected form.
1211 1211
1212If you explicitly specify children and then transform them using
1213@code{:setup-chilren}, then the class of the group is determined as usual,
1214based on explicitly specified children.
1215
1216If you do not explicitly specify children and thus rely solely on
1217@code{:setup-children}, then you must specify the class using @code{:class}.
1218For backward compatibility, if you fail to do so, @code{transient-column}
1219is used and a warning is displayed. This warning will eventually
1220be replaced with an error.
1221
1212@item 1222@item
1213The boolean @code{:pad-keys} argument controls whether keys of all suffixes 1223The boolean @code{:pad-keys} argument controls whether keys of all suffixes
1214contained in a group are right padded, effectively aligning the 1224contained in a group are right padded, effectively aligning the
@@ -1220,11 +1230,11 @@ The @var{ELEMENT}s are either all subgroups, or all suffixes and strings.
1220subgroups with commands at the same level, though in principle there 1230subgroups with commands at the same level, though in principle there
1221is nothing that prevents that.) 1231is nothing that prevents that.)
1222 1232
1223If the @var{ELEMENT}s are not subgroups, then they can be a mixture of lists 1233If the @var{ELEMENT}s are not subgroups, then they can be a mixture of
1224that specify commands and strings. Strings are inserted verbatim into 1234lists, which specify commands, and strings. Strings are inserted
1225the buffer. The empty string can be used to insert gaps between 1235verbatim into the buffer. The empty string can be used to insert gaps
1226suffixes, which is particularly useful if the suffixes are outlined as 1236between suffixes, which is particularly useful if the suffixes are
1227a table. 1237outlined as a table.
1228 1238
1229Inside group specifications, including inside contained suffix 1239Inside group specifications, including inside contained suffix
1230specifications, nothing has to be quoted and quoting anyway is 1240specifications, nothing has to be quoted and quoting anyway is