diff options
| author | Jonas Bernoulli | 2024-03-21 23:55:38 +0100 |
|---|---|---|
| committer | Jonas Bernoulli | 2024-03-21 23:55:38 +0100 |
| commit | c214fc9626c8b37e4d155a6d3caebe2e09fd0ab2 (patch) | |
| tree | 547e0c7bd23cd0eeea1abb8d3f3f5adf366aec95 /doc/misc | |
| parent | 2000d6e0f27f9f34f343016f4aa93e09c29c8695 (diff) | |
| download | emacs-c214fc9626c8b37e4d155a6d3caebe2e09fd0ab2.tar.gz emacs-c214fc9626c8b37e4d155a6d3caebe2e09fd0ab2.zip | |
Update to Transient v0.6.0-1-gcaef3347
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/transient.texi | 28 |
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, | |||
| 53 | available at @uref{https://github.com/positron-solutions/transient-showcase}. | 53 | available at @uref{https://github.com/positron-solutions/transient-showcase}. |
| 54 | 54 | ||
| 55 | @noindent | 55 | @noindent |
| 56 | This manual is for Transient version 0.5.2. | 56 | This 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 |
| 557 | This command toggle whether suffixes that are on levels lower than | 557 | This command toggle whether suffixes that are on levels higher than |
| 558 | the level specified by @code{transient-default-level} are temporarily | 558 | the level specified by @code{transient-default-level} are temporarily |
| 559 | available anyway. | 559 | available anyway. |
| 560 | @end table | 560 | @end table |
| @@ -1206,9 +1206,19 @@ The returned children must have the same form as stored in the | |||
| 1206 | prefix's @code{transient--layout} property, but it is often more convenient | 1206 | prefix's @code{transient--layout} property, but it is often more convenient |
| 1207 | to use the same form as understood by @code{transient-define-prefix}, | 1207 | to use the same form as understood by @code{transient-define-prefix}, |
| 1208 | described below. If you use the latter approach, you can use the | 1208 | described 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 |
| 1210 | transform them from the convenient to the expected form. | 1210 | transform them from the convenient to the expected form. |
| 1211 | 1211 | ||
| 1212 | If you explicitly specify children and then transform them using | ||
| 1213 | @code{:setup-chilren}, then the class of the group is determined as usual, | ||
| 1214 | based on explicitly specified children. | ||
| 1215 | |||
| 1216 | If you do not explicitly specify children and thus rely solely on | ||
| 1217 | @code{:setup-children}, then you must specify the class using @code{:class}. | ||
| 1218 | For backward compatibility, if you fail to do so, @code{transient-column} | ||
| 1219 | is used and a warning is displayed. This warning will eventually | ||
| 1220 | be replaced with an error. | ||
| 1221 | |||
| 1212 | @item | 1222 | @item |
| 1213 | The boolean @code{:pad-keys} argument controls whether keys of all suffixes | 1223 | The boolean @code{:pad-keys} argument controls whether keys of all suffixes |
| 1214 | contained in a group are right padded, effectively aligning the | 1224 | contained 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. | |||
| 1220 | subgroups with commands at the same level, though in principle there | 1230 | subgroups with commands at the same level, though in principle there |
| 1221 | is nothing that prevents that.) | 1231 | is nothing that prevents that.) |
| 1222 | 1232 | ||
| 1223 | If the @var{ELEMENT}s are not subgroups, then they can be a mixture of lists | 1233 | If the @var{ELEMENT}s are not subgroups, then they can be a mixture of |
| 1224 | that specify commands and strings. Strings are inserted verbatim into | 1234 | lists, which specify commands, and strings. Strings are inserted |
| 1225 | the buffer. The empty string can be used to insert gaps between | 1235 | verbatim into the buffer. The empty string can be used to insert gaps |
| 1226 | suffixes, which is particularly useful if the suffixes are outlined as | 1236 | between suffixes, which is particularly useful if the suffixes are |
| 1227 | a table. | 1237 | outlined as a table. |
| 1228 | 1238 | ||
| 1229 | Inside group specifications, including inside contained suffix | 1239 | Inside group specifications, including inside contained suffix |
| 1230 | specifications, nothing has to be quoted and quoting anyway is | 1240 | specifications, nothing has to be quoted and quoting anyway is |