diff options
Diffstat (limited to 'elpa/transient-0.8.6/CHANGELOG')
| -rw-r--r-- | elpa/transient-0.8.6/CHANGELOG | 1139 |
1 files changed, 1139 insertions, 0 deletions
diff --git a/elpa/transient-0.8.6/CHANGELOG b/elpa/transient-0.8.6/CHANGELOG new file mode 100644 index 0000000..d5b821f --- /dev/null +++ b/elpa/transient-0.8.6/CHANGELOG @@ -0,0 +1,1139 @@ +# -*- mode: org -*- +* v0.8.6 2025-03-15 + +Bug fixes: + +- ~transient-show-summary~ errored for commands that have neither a + summary nor a docstring. 0886651d + +- ~transient-format-description~ errored for ~transient-information~ + and ~transient-information*~ suffixes. #366 + +- ~transient--wrap-command~ failed to load autoloaded commands. + 40308623 + +- ~transient-suffix-object~ errored if a command is bound more than + once and is invoked using the mouse or ~RET~. f69e1286 + +- For some releases ~transient-suffix-object~ errored if it could not + identify a unique suffix, which helped establish that it is in fact + legitimate to use this function as a predicate. No longer error if + there are zero matches, but continue to error if their are multiple + matches that cannot be disambiguated. 4a06aeb0 + +* v0.8.5 2025-03-01 + +- Added new faces ~transient-key-recurse~ and ~transient-key-stack~. + 58e22554 + +Bug fixes: + +- ~transient--setup-recursion~ did not consider the ~resurse~ shorthand. + 32a7e256 + +- The parent group was not always stored in suffix objects. #354 + +- Invoking a suffix of a sub-prefix (which is configured to return to + the outer prefix), did exit instead of returning, if the suffix's + own behavior was not explicitly specified. #352 + +- The color of a suffix that returns to the outer prefix, was wrong + when there isn't actually an outer prefix. e88005d2 + +- When potentially removing other bindings for the same command + while adding a new binding, false-negative avoidance was too heavily + favored over false-positive avoidance. #355 + +- Defining the ~transient-higher-level~ face involves calling + ~face-attributes~ on another face. That call requested the value + for the current frame (which may not exist yet) instead of using + the default. #359 + +- When the transient window is hidden while the minibuffer is used, + then it was not restored if using Helm. #361 + +- Non-suffix command that aren't accessed via a symbol, were not + properly wrapped to ensure post-command cleanup happens even in + case of an error or if the user aborts a minibuffer use, causing + the menu window to get stuck. 08201f06 + +* v0.8.4 2025-02-01 + +- Added new option ~transient-show-docstring-format~. 65cd6cec + +- Unless called with a prefix argument, ~transient-toggle-docstrings~ + now only shows docstrings for the current menu invocation. 13f3f5e0 + +- The ~##~ macro from the ~llama~ package can now be used after keywords + in group specifications (including suffix bindings). 7c650436 + +- Suffix commands can now be advised using the new ~advice~ and ~advice*~ + slots available for suffixes and groups. This feature is still + experimental. #340 + +- ~transient-scope~ can now also match against prefix classes, not just + specific prefix commands. #334 + +- The default level of a suffix command can now be set via its + prototype, using the new function ~transient-set-default-level~. + f6c249c7 + +* v0.8.3 2025-01-03 + +- Added new constant ~transient-version~. 3022f6d5 + +* v0.8.2 2025-01-01 + +- Added support for displaying the transient menu in a dedicated + frame. bf58c0bb + +- When including a group via a variable, the imported value can now be + a top-level group. eebcbe30 + +- The transient window is now fitted to its buffer horizontally as well. + fd9811ea + +- Added new command ~transient-copy-menu-text~. 042f37aa + +- Added new command ~transient-toggle-docstrings~. 52679f98 + +- Added new command ~transient-describe~, which can be bound as many times + as needed to show help for arbitrary things. 5a18a791 + +Bug fixes: + +- The use of ~display-buffer-full-frame~ was prevented too aggressively. + 5353464b + +- Fixed remembering and restoring the old value of the ~no-other-window~ + window parameter. de984302 + +- When a command is bound multiple times and the instances use different + transient behavior, then the behavior (and color) for the last binding + was used for all bindings. fe71a7e7, a99dcda9 + +- Enabling ~transient-force-single-column~ resulted in an error. + 28347e59 + +- ~transient-toggle-common~ used to exit the menu. 98c01b84 + +* v0.8.1 2024-12-08 + +Bug fixes: + +- Interactively setting the level of a transient prefix resulted in + an error. #337. + +* v0.8.0 2024-12-06 + +- While the minibuffer is in use, the menu window is now hidden by + default. The new option ~transient-show-during-minibuffer-read~ not + only controls whether the menu stays visible while the minibuffer + is in use, but also whether it may be resized if necessary. This + new option replaces ~transient-hide-during-minibuffer-read~. #330 + +- When returning to a prefix whose ~refresh-suffixes~ slot is non-nil, + its suffixes are now re-initialized. #327 + +- Added documentation for ~inapt-if*~ slots to manual. 179545a6 + +- ~transient-args~ now takes a prefix command or a list of prefix + commands as argument. + +- ~transient-scope~ now takes a prefix command or a list of prefix + commands and/or a prefix class or list of prefix classes as + arguments. It can still be called without any argument, but that + should only be done in functions that take part in setting up a + menu, not in a suffix command. + +- Added new generic function ~transient-prefix-value~, giving finer + control over how the value returned by ~transient-args~ is determined. + +- Added support for implementing ~transient-init-scope~ methods for + prefix classes. + +- ~transient-setup-buffer-hook~ is now run later to allow overriding + more default settings. + +- The new prefix slots ~display-action~ and ~mode-line-format~, can be + used to override ~transient-display-buffer-action~ and + ~transient-mode-line-format~ for individual prefix menus. #332 + +- Updated the manual considerably. + +Bug fixes: + +- Fixes some menu navigation edge-cases. + +* v0.7.9 2024-11-04 + +Bug fixes: + +- Fixed a recent regression in ~transient-suffix-object~. #325 + +- The height of the transient window was fixed even it used the full + frame height. 5478d4e6 + +* v0.7.8 2024-11-02 + +- Additional potential mistakes in menu definitions are now detected. + bbda5bb6, 8873c300 + +- Added new (and still experimental) ~environment~ prefix slot, which + can be used to, for example, implement a cache to be used while + refreshing the menu. 05c011b8 + +- When navigating through the menu using the keyboard or hovering a + suffix command with the mouse, information about the command is now + shown in the echo area or using a tooltip. #282 + +Bug fixes: + +- When the command that exits a transient uses the minibuffer, + ~transient-current-*~ variables were not immediately reset to + ~nil~. #323 + +- Key sequences with three or more events broke + ~transient-suffix-object~. #324 + +* v0.7.7 2024-10-04 + +Bug fix: + +- Fix a regression introduced by the previous commit, which broke + dynamic prefixes that use a ~:setup-children~ function to prepare + their suffixes. #313 + +* v0.7.6 2024-10-01 + +- ~transient-active-prefix~ now accepts a single prefix symbol, in place + of a list of such symbols. #307 + +- ~other-frame-prefix~ and ~other-window-prefix~ can now be used while a + transient prefix is active. #305 + +- Added new macro ~transient-with-help-window~ for use in ~:show-help~ + functions. #309 + +* v0.7.5 2024-09-01 + +- Updated tooling. + +Bug fixes: + +- ~static-if~ is now used correctly. 0e35673e + +- When an existing window ends up being used to display the transient + buffer, then the previous value of the ~no-other-window~ parameter is + now restored, when the transient is exited. #302 + +- The names assigned to suffixes, which are defined using lambdas in + the prefix definition, are now guaranteed to be unique. #304 + +* v0.7.4 2024-08-05 + +- Added new function ~transient-active-prefix~. + +* v0.7.3 2024-07-13 + +- Refactored code responsible for inserting columns. + +Bug fix: + +- The ~transient-current-*~ variables are intended to only be used by + suffix commands, when they are invoked from a prefix. Previously + they were only cleared when the prefix is ultimately exited, which + meant that they unintentionally were accessible in timers. Now the + values of these variables are nil when used outside their intended + scope. 0e0ece32, f2cb28a5 + +* v0.7.2 2024-06-24 + +- Added support for adding suffixes that activate value presets. #183 + +Bug fix: + +- Restored the ability to individually set infix arguments if the + prefix's ~refresh-suffixes~ slot is non-nil. 8db5f0fd + +* v0.7.1 2024-06-19 + +- Added a workaround for ~emoji.el~ from Emacs 29.1 calling an internal + function using an outdated number of arguments. #288 + +* v0.7.0 2024-06-18 + +- Added new macro ~transient-augment-suffix~, which can be used to + specify the suffix behavior of a command that was previously defined + as a prefix, using ~transient-define-prefix~. 2fd3ea14 + +- Added new function ~transient-scope~, which is just a convenient way + to get the value of the ~scope~ slot of the ~transient-prefix-object~. + 7f6c39c5 + +- Added new hook ~transient-setup-buffer-hook~, which is run early when + setting the transient menu buffer. #283 + +- Added new class ~transient-information*~, a variant of recently added + ~transient-information~ class. 8a80e952 + +- By default our macros that define commands, mark those as for + interactive use only. ~(declare (interactive-only nil))~ can now be + used to overwrite that. fcc60e27 + +- Groups now also accept ~:inapt*~ predicates. 3d395d64 + +- Spaces between columns is reduced from three to two. dd93001e + +- Removed unused ~transient-plist-to-alist~ function. 1251faf0 + +Bug fixes: + +- ~transient--force-fixed-pitch~ was run to late to always succeed. #283 + +- Key binding conflict detection was too strict, taking hypothetical + bindings for inapt commands into account. c356d1bc + +- Key binding conflict detection did not consider bindings in regular + keymaps, such as ~transient-base-map~. 2698d62d + +- ~func-arity~ gets confused when a function is advised, so we had to + add a wrapper function ~transient--func-arity~. 91dd7bb3 + +- Some mistakes, that can be expected to occur when defining suffix and + prefix commands, were not detected. 7e827c31 + +* v0.6.0 2024-03-21 + +- On Emacs 28.1 and later, all infix commands and suffix commands + that are defined inline (i.e., using a lambda when defining a prefix + command), are now hidden from ~execute-extended-command~ (aka ~M-x~) /by + default/. It was already possible to hide these commands, but users + had to opt-in explicitly. After refactoring how these commands are + declared to be unsuitable for ~M-x~, it is now possible to hide them + /without/ also hiding other, unrelated kinds of unsuitable commands. + + I recommend that you instruct ~M-x~ to hide /all/ unsuitable command. + This requires that you customizing ~read-extended-command-predicate~, + because the Emacs authors have decided that this should be an opt-in + feature. + + Note that this has no effect on Emacs releases before 28.1. + +- Added documentation stating that ~:class~ has to be specified when + using ~:setup-children~. beecdc85 + +- Added a new prefix slot ~column-widths~, which can be used to specify + the minimal width of each column in all ~transient-columns~ groups of + that prefix. 92e8952e + +- When assigning a name to a suffix that is defined inline, we no + longer use the suffix description, iff that would result in an + overly long name. 81a108ba + +- Functions used as the value of face slots can now take one + argument, the suffix object. Functions that take zero arguments + are still supported. Additionally, ~transient--pending-suffix~ is + bound around calls to these functions, but it is better to pass + the object as an argument. f582a9bc + +- The new ~definition~ suffix slot can be used to specify a default + function definition that is used if no function body is provided + using ~transient-define-suffix~. 5b334a51 + +- Taught ~transient-suffix-object~ about ~transient--pending-suffix~. + 20a3770d + +Bug fixes: + +- If ~transient-parse-suffix~ and ~transient-parse-suffixes~ are called + with an invalid value for their ~prefix~ argument, they failed to + detect that. 03e752d9 + +- If ~nil~ is encountered inside a group specification, that was + silently ignored. Now an error is signaled. 8c01a1eb + +- ~find-function~ wasn't able to locate the definitions of infix + commands anymore. a30df67b + +- There was no binding for ~ignore-preserving-kill-region~ in + ~transient-predicate-map~. 0fc87002 + +- Invoking a non-symbolic non-suffix command, caused an error. + bd2a5ea0 + +- When a group begins with an included subgroup, that affected what + group class was assumed, in the absence of an explicit specification. + df36bc87 + +- ~transient--suspend-override~ failed to move out of the minibuffer + before refreshing the transient buffer. 833143ba + +- When a suffix command signaled an error during a trivial phase + (which does not involve, e.g., the minibuffer), then the transient + window was not deleted when the debugger was entered. 9d8f361f + +- When a prefix was refreshed, the wrong color was used for suffix + commands that exit the prefix, indicating that would cause a return + to the outer prefix, even though there is none. f51c144a + +- Calling ~transient-infix-read~ with an invalid value, resulted in + a confusing error. Now an appropriate error is used. 3ebb6acf + +- When third-party code or user customization managed to display + another buffer in our dedicated window, then that buffer got + killed when we tried to kill the transient buffer. #271 + +* v0.5.3 2023-12-16 + +- Fixed regression when setting ~:pad-keys~ for a ~transient-columns~ + group. #269 + +* v0.5.2 2023-12-05 + +- Fixed formatting issues in the manual. + +* v0.5.1 2023-12-05 + +- Added a new introduction by JD Smith (@jdtsmith). + +Bug fixes: + +- Faces that use a box are now defined more defensively to protect + against unexpected values and provide reasonable fallback colors. + 413310cd, b8aefce3 + +- Only prepare to return to the parent transient if there actually is + a parent. The only negative effect of failing to do this was that + the suffix was colored wrong, since ~transient--do-return~ falls back + to behave like ~transient--do-exit~. 5f2cfc9f + +* v0.5.0 2023-11-28 + +- Some suffix commands exit the transient from which they were + invoked, while others don't (allowing the user to invoke another + suffix without first having to enter the transient again). + + Until now it wasn't possible to tell which category any given suffix + falls into, at least not by default. Now the key binding of each + suffix is colorized to indicate its transient behavior. Red means + that the suffix exits the transient, and blue means that it does + not. Keys for suffixes that currently cannot be invoked are gray. + + Likewise, the thin line, that is drawn between the transient popup + buffer and the minibuffer, is used to indicate what happens, if you + invoke a command that is not a suffix. Most prefixes do not allow + non-suffixes to be invoked, so this line usually is gray. c8a9ac51 + +- Many faces have also been improved. This involves changing which + built-in faces they inherit from, some explicit changes to their + appearance, and semantic clarifications. Of course your mileage may + vary — it's possible that some face just happened to look right with + your chosen theme, but now it has to be themed to achieve that + again. 47d3f01d 71d16d86 et al. + +- Added a new face, ~transient-delimiter~, which is used for parentheses + around values and the pipe character used to separate possible values + from each other. 567b5d54 + +- Added a new command ~transient-toggle-level-limit~, bound to ~C-x a~, + which temporarily shows all suffix commands a transient has to + offer. This makes it possible to occasionally use more obscure + commands and arguments, without having to always display them. + For more information see [[https://magit.vc/manual/transient/Enabling-and-Disabling-Suffixes.html][Enabling and Disabling Suffixes]]. #243 + +The changes described below, only directly affect package authors and +users who implement their own transients. If that does not describe +you, then all you have to know is that many features were fine-tuned +and otherwise improved, opening up some new use-cases and making some +things easier to implement. This will hopefully lead to improvements +in your favorite transient-using packages in the coming months. + +- It sometimes makes sense to bind multiple keys to the same suffix + command, e.g., because they behave differently based on the suffix + description, or some other slot that can be set per binding. + Previously these bindings shared a visibility level; how this can + be set individually. #153 + +- While functions are run, which format strings to be inserted into the + transient buffer or to determine whether other aspects of a suffix, + that transient buffer no longer is the current buffer. Instead the + buffer in which the prefix and its suffixes operate, is the current + buffer. This affects functions such as ~transient-format-description~ + and those found in predicate slots such as ~if~. In contexts where + the transient buffer is needed but the other buffer happens to be + current, the new macro ~transient-with-shadowed-buffer~ can be used + to temporarily change that. + +- The new suffix slots ~face~ and ~inapt-face~ can be used to specify how + a suffix looks, which in simple cases is more convenient than using + a function as ~description~ and adding the face there. The values of + these slots should be faces or functions that returns a face. The + default for ~inapt-face~ is ~transient-inapt-suffix~, but in some cases + it is undesirable to apply this face to the whole description, so + this can be overridden by setting this slot to ~nil~ for individual + suffixes. The default for ~face~ is ~nil~. c2a75880 8e15a29b 71399d21 + +- Added new variables ~transient--pending-suffix~ and + ~transient--pending-group~, which are bound while a suffix/group is + being inserted. These are mostly intended for internal purposes, + but in some rare complex cases package authors might need them too. + 0717589a 70e8dc80 + +- Sometimes it is useful to display some information in the transient + buffer, which is not associated with a suffix command. The new + class ~transient-information~ can be used for that purpose. Children + that use this class are very similar to regular suffixes, the lack + of a command binding being nearly the only difference. #226 + +- Instead of a list of choices, the value of a suffix's ~choices~ slot + can now be a function that returns such a list. #212 + +- Per-suffix functions that format its description (specified using the + ~description~ slot) can now optionally take one instead of zero argument, + the respective suffix object. 09be367b + +- Added a new command ~transient-echo-arguments~ intended for use in + examples and bug reports, when a prefix must bind some command, but it + does not really matter which. Using this command is less verbose than + having to implement a dummy every time, and it comes with some goodies. + I.e., it reports information about the prefix from which it was invoked. + faa3d09d + +- When a command was defined using ~transient-define-suffix~ and an alias + for that command was created using ~defalias~, then the alias had no + access to the associated suffix object. Now it does, which makes it + possible to bind the same command multiple times in a prefix, and make + it behave differently depending on the symbol-name that was used to + invoke it. f43aee1a + +- The values of a prefix's ~transient-suffix~ and ~transient-non-suffix~ + slots should now be a boolean. The value of the ~transient-suffix~ + slot has to be handled differently for different types of suffixes. + I.e., infix arguments must ignore it, and sub-prefixes must honor + it but to do so they must use a different pre-command. Previously + booleans were not supported and the previously recommended values, + ~transient--do-stay~ and ~transient--do-exit~ are still supported (but + they are "corrected" for sub-prefixes). For the ~transient~ slot the + use of booleans was always allowed and recommended. 8098d175 + +- For sub-prefixes a value of ~t~ for the ~transient-suffix~ slot of the + parent prefix now means that suffixes, which exit the sub-prefix, + return to the parent prefix, instead of exiting that as well. + 784887b7 5ad5b627 + +- In addition to booleans and pre-commands, the values of the + ~transient-suffix~, ~transient-non-suffix~ and ~transient~ slots + may now also be pre-command "shorthands", e.g., use ~leave~ instead + of ~transient--do-leave~ (which in some cases is a good value for + `transient-non-suffix`). 9617b6c7 + +- ~transient--do-replace~ now behaves as documented and implied by its + name. Use the new ~transient--do-stack~ if you want to return to the + outer prefix. 94661e0c + +- Added a new prefix slot ~transient-switch-frame~, which allows + specifying the transient behavior of ~switch-frame~ per prefix and + independently of the transient behavior of other non-suffixes + (specified using the ~transient-non-suffix~ slot). 609dabfd + +- Added a new function ~transient-prefix-object~ to allow package + authors to avoid the following unfortunate complication. + + While a transient is being setup or refreshed (which involves + preparing its suffixes) the variable ~transient--prefix~ can be + used to access the prefix object. Thus this is what has to be + used in suffix methods such as ~transient-format-description~, + and in object-specific functions that are stored in suffix slots + such as ~description~. When a suffix command is invoked (i.e., + in its ~interactive~ form and function body) then the variable + ~transient-current-prefix~ has to be used instead. + + Two distinct variables are needed, because any prefix may itself + be used as a suffix of another prefix, and such sub-prefixes have + to be able to tell themselves apart from the prefix they were + invoked from. Regular suffix commands, which are not prefixes, do + not have to concern themselves with this distinction, so they can + use this function instead. In the context of a plain suffix, it + always returns the value of the appropriate variable. + 37307c1b + +Bug fixes: + +- cc0fa805 transient--post-command: Redisplay after universal argument +- dd970cd4 Compile suffix commands that are defined inside prefix definitions +- b150b48b transient-quit-one: Cancel prefix-arg instead of exiting transient +- 7c08beb8 Revert "transient-{set,save,reset}: Stay transient" +- f8209cc8 transient--maybe-pad-keys: Ignore raw strings +- 0a0ba1aa transient--do-leave: Actually behave as documented +- ed5bd6fd transient-infix-set(argument): Fix disabling incompatible options +- 3a2b936a Fix highlighting infix for which user input is being read +- d834f764 transient-format(around:suffix): Don't attempt to highlight full line +- af6eb310 transient-format: Only highlight infix if minibuffer is used +- b1d1c369 Prevent temporary faces from leaking back into objects +- 307695d2 transient-format-description(around:suffix): Combine faces +- 7f0215c4 transient-format-value(option,value): Use argument faces + +Also contains various documentation updates and a lot of code clean-ups. + +This release drops support for Emacs 25. The last Emacs 25 release +(25.3) was released in 2017; over six years ago. The current Emacs +version is 29.1; that's four major releases since 25.1. + +* v0.4.3 2023-08-25 + +- Added a second implementation of ~transient--wrap-command~, taking + advantage of improvements in Emacs 30. + +* v0.4.2 2023-08-25 + +- Infix commands are only useful when invoked from a transient prefix + command and ~execute-extended-command~ should not offer them as + completion candidates. In the past we used a weird kludge to + accomplish that, but now we rely on ~read-extended-command-predicate~. + That allowed the removal of some complications and made it possible + to fix a bug in ~transient--wrap-command~. + + To hide infix commands, users now have to update to Emacs 28, or + later, and customize ~read-extended-command-predicate~. + + #+begin_src emacs-lisp + (setq read-extended-command-predicate + 'command-completion-default-include-p) + #+end_src + +- Due to changes in Emacs 29.1, pretty-printing isn't consistent + across Emacs releases anymore by default, which is unfortunate + in our case because we use it to write to files that are likely + to be checked into version control. We now force the use of the + old style across releases. + +* v0.4.1 2023-06-02 + +Bug fixes: + +- 070d47b0 Support searches that end right after suffix +- ab831828 transient--insert-group(columns): Drop separator before first column +- 62edeffd #247 Fix bug using :incompatible using suffixes before infixes +- 6efa9fad transient-predicate-map: Bind univeral-argument-more + +* v0.4.0 2023-05-10 + +- Transient has to update state after every suffix command. If that + fails for some reason, then Emacs ends up in an badly broken state. + It was rare, but in the worst case scenario, that meant that Emacs + refused to call any more commands and had to be killed. + + Naturally ~post-command-hook~ is the first choice to run something + after commands, but unfortunately that hook is not guaranteed to run + only once, and worse it is not guaranteed run /after/ the command. + Working around this limitation made an essential part of Transient + much more complex and fragile. As new edge-cases were discovered, + new and increasingly desperate heuristics had to be added, until I + finally decided that relying solely on hooks was just not feasible. + + Now ~pre-command-hook~ is used to advice ~this-command~, to add an + around advice, which ensures that the state update takes place, even + when ~post-command-hook~ is run prematurely. The advice wraps both + the function body and the interactive spec with ~unwind-protect~, so + we can finally be sure that the state change is always performed, + and that the advice is removed again. + + It has been an interesting journey, and I have documented it in long + commit messages. If you are interested in the details, see 7b8a7d71 + (which still tries to avoid using any advice), 51c68c87, 52cac9c0, + bug#61179 and bug#61176. + +- The ~transient-define-prefix~ now expands to code instead of data, + meaning that lambda expressions are finally properly evaluated and + byte-compiled. ea851f3b e88f51d6 277e5f2d a1774182 + +- Popup navigation is no longer considered a second-class feature and + is enabled by default. Some transients allow arbitrary non-suffixes + to be invoked, so some key bindings, which were previously used for + popup navigation, had to be removed, to avoid conflicts. 98d50202 ff + +- Each prefix and suffix can now have its own help function. This is + configured using the new ~show-help~ slot. ea5ac99f + +- The ~transient-options~ class now supports two types of options that + can have multiple values: repeated option-value pairs and a final + option that takes all remaining arguments as value. #154 + +- Added support for the use of non-proportional text in the transient + popup. 7f5520b3 + +- Imenu was taught about Transient's definition macros. #178 + +- It is now possible to return to the parent prefix from a sub-prefix. + e90f7a16 + +- Boolean values of the ~transient~ slot of sub-prefixes are now + interpreted correctly. 4a36b1d9 + +- Added new option ~transient-hide-during-minibuffer-read~. 5762bd9a + +- Added new option ~transient-align-variable-pitch~. cda6a120 + +- Added new command ~transient-reset~, which clears the set and saved + value of the active transient. 51585b8d + +- When using Emacs 28, ~execute-extended-command~ can be told to ignore + transient infix commands. Even when using that Emacs version, that + command does not ignore any commands by default, but this behavior + can be easily be enabled using: + + (setq read-extended-command-predicate + 'command-completion-default-include-p) + + Infix arguments are implemented as commands, so they by default show + up as completion candidates of ~execute-extended-command~, which is + useless because they are only intended to be invoked from transient + prefix commands. Enable this feature to prevent that. + +- Added new command ~transient-toggle-debug~. b466cd9a + +- Depend on the Compat package, allowing me to use convenient features + that were added to Emacs over the last few years, without having to + wait another few years until everybody has updated to a reasonably + recent Emacs release. 5ae3c401 + +- Added basic support for suffixes that span multiple lines (multi-row + cells). #193 + +- Infix arguments can now be invoked following a prefix argument. To + use a negative prefix argument use "C--". "-" cannot be used anymore + because it conflicts with the most common prefix key used for infix + arguments. ed2febd0 + +- Removed obsolete aliases for functions deprecated in v0.3.0. #192 + +- Duplicated suffix commands are now disambiguated, making it possible + to bind a command multiple times as a suffix of a transient command, + but still have it do different things depending on what binding is + used, based on the value of some slot of the corresponding suffix + object, similar to how ~self-insert-command~ inserts the pressed key. + f27c840a + +- ~recursive-edit~ and ~top-level~ can now be used while a transient is + active. fcdeadc1 5a1b2bac + +- Switched to Emacs 29's new keymap functions, which are also supported + in newer releases, thanks to the Compat package. 87f70af5 5a966aa8 + +Bug fixes: + +- 938b0591 #173 transient--show: Set point after displaying window again +- 202271f7 Resurrect transient-files class +- c26cbac5 #181 transient-{init,set}-value: Use case-sensitive matching +- 28491e1f Properly deal with stealth undefined command +- 143a1393 transient-infix-read: Always enable-recursive-minibuffers +- 76b77e01 magit--{pre,post}-command: Add emergency exits +- 09b436fa transient--debug: Ignore error in transient--suffix-symbol +- f2e0dfcc transient--get-predicate-for: Ignore error in transient--suffix-symbol +- bf29731a transient--post-command: Don't pop and push equal redisplay maps +- 3c78b10f transient--redisplay: Don't redisplay during mouse-drag-region +- 714e3482 No longer always suspend when handle-switch-frame is called +- ecb815bc transient--abort-commands: Add keyboard-escape-quit +- 8b1f8dcc transient--minibuffer-depth: Must always be a number +- 686b7ebc Fix handling of sub-prefix command that use the minibuffer +- a19faa1c Return to outer prefix when minibuffer is aborted for sub-prefix +- 4477555b transient--post-exit: Deal with unbound transient slot properly +- 0f39af0e #188 transient-format-description: Use cl-call-next-method +- 1fd1cf51 When highlighting suffixes not normally displayed consider group level +- 7c771c94 Do not let-bind overriding-terminal-local-map to nil +- 31d355b5 transient-set-level: Refresh shown levels after setting one +- bb056e71 Invoke suffix commands directly when a button is pushed +- 270eff1c Fix redisplay when popup navigation is enabled +- 81b2b912 Use this-original-command again +- d4fb853d #198 transient--show: Also hide the header-line +- 7467a79c transient--suspend-override: Cancel display timer +- 5686a792 transient--suspend-override: Cancel prefix key display +- 1c84d7ad Remap kp-subtract, kp-equal and kp-add +- 5302db18 Once popup is showing keep doing so until full exit +- cc887ebe transient--delay-post-command: Fix execute-extended-command handling +- 3b267425 transient--fit-window-to-buffer: Use correct package prefix +- 9d4fabc3 #208 transient--describe-function: Handle renamed help buffer +- 555792f7 #209 Fix setting level of anonymous infixes +- 0a3b22f1 #215 transient--delay-post-command: Account for events returned as vector +- ad953cc3 #204 transient--insert-group: Add fallback for failed alignment calculation +- 5337e5eb #230 transient-define-{*}: Error if ARGLIST is missing +- d800ce01 Use equal to compare with empty vector +- 3657117b #234 transient--parse-suffix: Detect when mandatory command is missing +- f88cbbc5 #234 transient--parse-suffix: Differentiate command and desc lambda +- 0204a243 #234 transient--parse-suffix: Define suffix aliases at load-time +- 0ae0de43 #241 transient--invalid: Add special-case for anonymous inapt commands +- af7fe42b #244 transient--parse-suffix: Don't try to evaluate closures again +- 6ff5c51f transient-isearch-abort: Fix partial match case + +Also contains various documentation updates, code clean-ups and +build improvements. + +* v0.3.7 2021-10-25 + +- Added an additional safety hatch to prevent Emacs from entering an + inconsistent state when an unexpected error occurs. 99e48369 + +- Added support for implementing section movement commands in + third-party packages. This was requested by the maintainer of + Emacspeak. Because they would be of very limited use to sighted + users no such commands are added to Transient itself. 769219b5 + +- ~transient-read-number-{N0,N+,N}~ now support infix arguments that + have three different states: disabled, enabled without an empty + value, and enabled with a non-empty value. 626d105e + +- If a command is called as a suffix of itself, then the help command + shows the function definition instead of the man-page as it usually + does for prefixes. e17e2b2f + +- Give users more control over how the transient buffer is displayed. + Various aspects that were previously hardcoded can now be changed + using the ~transient-display-buffer-action~ option. 7c677737 + +- Added support for adding suffixes that might be neither defined nor + autoloaded when the prefix is invoked. This usually results in an + error and while it is now possible to override that using an extra + step, it is still discouraged. 6842305e + +Bug fixes: + +- 1e740608 transient-map: Bind C-u to universal-argument +- e9048100 Explicitly call transient--pre-command in button action +- be119ee4 Export variables for transient non-infix suffixes +- b526b9c7 transient-infix-set: Consider all incompatibility rules +- 7126d6aa Fix hydra-inspired colors +- 0c2255a2 transient-get-value: Add an emergency exit + +Also contains various documentation updates and code clean-ups. + +* v0.3.6 2021-07-01 + +- Added new option ~transient-force-single-column~, which may be useful + for low vision. #122 + +- Added new option ~transient-highlight-higher-levels~, which is + intended for package authors. 90a05622 + +* v0.3.5 2021-06-16 + +- Added a kludge to work around some unexpected Emacs behavior. + ef921d30 + +- When showing help for a suffix that is also a subprefix, then also + consider the manpage that is set for the prefix, if any. a9bdd013 + +* v0.3.4 2021-05-25 + +- Very minor changes. + +* v0.3.3 2021-05-24 + +- Added SPDX-License-Identifier library header. 7d3d8d79 + +* v0.3.2 2021-04-20 + +- Fixed an error message. c145229a + +* v0.3.1 2021-04-19 + +- Changed ~transient-prefix~'s ~suffix-description~ slot to be initially + unbound, as was always intended. c28b8a4 + +- Added new functions ~transient-read-file~ and + ~transient-read-existing-file~. a3b44224 + +* v0.3.0 2021-02-21 + +- Added a temporary kludge to prevent a transient from being invoked + while the minibuffer is active. A future release will enable + this again, once we are sure that cannot cause Emacs to enter an + inconsistent state, that causes most events to be ignored. #112 + +- Improved the backtrace that is shown when a fatal error occurred in a + critical context. This involved some back and forth. See commits + mentioning the "emergency exit". + +- Added support for defining a per-prefix fallback suffix description + function, which is used for suffixes that do not explicitly provide + a description. The new ~suffix-description~ slot is used to specify + that function. The new ~transient-command-summary-or-name~ function + is useful, not just as an example. 8b22b52b + +- Added ~transient-arg-value~, which can be used to extract the values + of individual arguments in the output of ~transient-args~. d76f73f8 + +- Added support for using variables in group and suffix definitions + of a prefix. Such indirect specifications are resolved when the + transient prefix is being defined. #101 + +- No longer bind ~M-<key>~ to any common suffix commands; freeing this + namespace for a variety of uses in individual transient. A few + existing bindings had to be changed because of this. 990eb0a2 + +- Added ~transient-suffixes~ function, which is useful when + ~transient-args~ is not sufficient because one needs the suffix + objects, not just their values. #98 + +- Added ~init-value~ slot for infix and prefix objects. If this value + bound then it is called with the object as only argument instead of + the primary ~transient-init-value~ method of the object class. #96, + 3284f6a0 + +- Added ~unsavable~ slot for infix objects. If this is non-nil, then + the value of the infix is removed from the prefix value before + saving, setting and adding to history. #96 + +- Added support for right padding the keys of all suffixes in a group. + This is controlled using the new ~pad-keys~ slot of group objects. + 7502390b, 293a437d + +- Added support for delaying setup of the suffixes of a prefix until + that is invoked. Also added support for using unnamed functions as + suffix commands. Taken together these changes make it possible to + dynamically create the list of suffixed. See the ~notmuch-transient~ + package for two examples: ~notmuch-search-transient~ and + ~notmuch-tag-transient~. f2252d53, a3e53633 + +- Added the infix class ~transient-lisp-variable~. 2d8ceff4 + +- Added ~transient-infix-read~, which allows arbitrary commands to read + a value the same way as would the infix command that is provided as + an argument to this function. 73694be4 + +- Added support for coloring suffixes in a Hydra-like fashion. + To enable this, customize option ~transient-semantic-coloring~. + 248862c5 + +- Added support for disabling and dimming suffix commands that are + currently not suitable, instead of completely hiding them. #80 + +- Autoload functions that serve a purpose similar to that of + ~define-key~. #85 + +- Consistently use ~transient-~ as the prefix of all symbols. + The old names remain available as obsolete aliases. dd0c44cb + +- Added support for scrolling the transient popup buffer using the + scroll bar. #84 + +- Various bug fixes. + 48238bf5 Allow invoking arbitrary prefixes as non-suffixes + d85eb790 transient-read-directory: Pass read value through file-local-name + f086cb62 transient--insert-suffix: Allow same key with different predicates + d555d260 transient-format-description(lisp-variable): Return string + 0d79ccfa transient--parse-suffix: Don't fallback to read-string for options + f88dbc43 transient-suffix-object: Support all suffixes + b343e2a3 transient-infix-read: Fix ivy specific kludge + 55bad195 transient--pp-to-file: Bugfix + c1df3b21 Ensure we use symbols in a few more places + 769fa438 transient-set-level: Fix edge-case + 88d935c7 transient-display-buffer-action: inhibit-same-window by default + +* v0.2.0 2020-02-26 + +- ~transient-args~ must now be called with a transient prefix command + as argument. It is now the only argument and its value must be a + symbol now, an object is no longer supported. When this command + does not match ~current-transient-command~, then this function now + returns the set, saved or default value. 0312b93, 7d0db28, + d33fe5a, a6ce195 + +- No longer use the last history element as initial minibuffer input + by default. Added new option ~transient-read-with-initial-input~ to + allow users to restore the old default. dcf7a4d, 5decc6e + +- The set and saved values were not always used. #68 + +- Added support for inserting and removing groups. #36 + +- Added support for specifying where to insert elements and groups + using coordinates. #26 + +- Added support for moving the cursor inside the transient popup + buffer using the arrow keys or Isearch, and for invoke suffix + commands using RET or mouse clicks. Unlike Magit-Popup, Transient + doesn't make the transient popup buffer the current buffer. This + is important when invoking suffix commands that take the current + position into account, but it has the drawback that we do not get + these features for free. Because I also consider them unnecessary + I did not implement them initially. Turns out quite a few users + strongly disagree. Set ~transient-enable-popup-navigation~ to ~t~ to + enable these features. #42 + +- Explicitly support Edebug. Previously when Edebug was triggered + while a transient was active, then Emacs entered an unrecoverable + state. #19 + +- No longer attempt to display a thin line in termcap frames. 0a96a57 + +- Work around some Ivy bugs/incompatibilities. af243d5, fed7ab1 + +- The new option ~transient-force-fixed-pitch~ allows users to use a + monospaced font in transient's popup buffer even if they use a + proportional font for the rest of Emacs. #25, #67 + +- Adapted to backward incompatible changes in Emacs 27 that prevented + faces from extending to the edge of the window as expected. c1ae1ee + +- No longer depend on dash (or any other third-party package). #66 + +- When a transient has conflicting key bindings and Transient is + configure to warn about that, then Emacs entered an unrecoverable + state instead. 75de1f0 + +- ~transient-format-value~ now supports options with multiple values. + #65 + +- Removing a suffix based on its position was broken. 41cbf49 + +- In our popup buffers disable the tab feature that Emacs 27 + introduces. #62 + +- Inserting a new suffix next to another ended up replacing the latter + instead if its key binding was defined in the suffix object. #58 + +- ~transient-undefined~ learned to make some noise. #57 + +- Fix replacing a suffix with another suffix bound to the same key. + 5a360bb, 4ce1868 + +- Characters are no longer allowed as pseudo suffixes. To insert a + an empty cell into a table use the empty string instead. 71687ba + +- Added new variable ~transient--buffer-name~. #45 + +- Some misconfiguration that affects how the transient popup buffer + is displayed could lead to Emacs entering an unrecoverable state. + #34, #44 + +- The echo area is now cleared when the transient popup buffer is + shown. afdf1f0 + +- If ~transient-show-popup~ is 0 or a negative number, then not even + a one-line summary is shown initially. #41 + +- Added new function ~transient-read-directory~. a87cb2c + +- ~define-transient-command~ now supports specifying the level of a + suffix using the ~:level~ keyword argument. 6506cfd + +- The mode-related suffix predicates now also support a list of modes + as argument in addition to a single mode as before. 1c6afb8 + +- The new ~incompatible~ slot of prefix objects makes it possible to + specify which arguments should be autoatically disabled when the + user enables certain other arguments. 544b3bb + +- ~transient--history-push~ is now defined as generic function. 47b7975 + +- The a new ~history-key~ slot and ~transient--history-key~ generic + function for prefix objects. 3668aeb, e627d45 + +- Disallow setting the level of essential suffixes that are shared + between all transients. #29 + +- The active infix is now highlight while reading its value from the + user. #30 + +- The commands ~transient-set~ and ~transient-save~ can now be configured + to exit the transient, though by default they still don't. a47ae94 + +- Always respect the ~transient~ slot of a suffix, even if that suffix + has a binding in ~transient-predicate-map~. 919fc66 + +- Added new generic functions ~transient-set-value~ and + ~transient-save-value~ intended for prefix commands. ebe9d9d + +- It is no longer possible to set a prefix level to 0, which is an + invalid value. #28 + +- All transient prefix and suffix commands are now automatically + declared to be for interactive use only. a6295fa + +- Infix arguments are no longer added to ~command-history~ because + these entries were both useless and extremely noisy. #23 + +- ~digit-argument~ no longer exits the transient. 5f0ec7d + +- A new keymap, ~transient-base-map~ was added to make it easier to + change key bindings that are shared between all transients. This + new keymap is used as the parent of all the other keymaps that are + shared between all transients. + +- Added new commands ~transient-scroll-up~ and ~transient-scroll-down~, + which scroll the transient window. ~C-v~ and ~M-v~ (and ~<next>~ and + ~<prior>~) are bound to these commands. These keys were chosen they + are bound to scrolling commands in the global map too. This made + it necessary to find a new binding for ~transient-show~, which ~C-t~ is + bound to now. #17 + +- The new option ~transient-mode-line-format~ allows users to use + a mode-line for the transient popup buffer instead of just a + thin line that separates it from the echo area. When using a + non-standard value for ~transient-display-buffer-action~ it may + be necessary to do that. #17 + +- The new option ~transient-display-buffer-action~ allows users to + specify how a window is selected to display the transient popup + buffer. The ~lv~ library is no longer used. #17 + +- The window that was selected before the transient window was shown + is no longer re-selected before calling a suffix that exits the + transient. If a suffix changes the selected window unintentionally, + then that is a bug. This makes it possible to intentionally change + the window layout using transients. + +- An infix is a special kind of suffix. Depending on context + "suffixes" means "suffixes (including infixes)" or "non-infix + suffixes". This is now mention in a few places where users might + otherwise get confused. + +- Stopped claiming that the transient is shown in the "echo area", + because technically that is not correct. Instead talk about the + "popup buffer". + +- Fixed handling of suffix commands that are undefined at the time the + prefix is invoked. This is still an error, but the error message + now explains what is wrong. a729bbb + +- Fixed saving values/history/levels, making sure that the printed + expression is never abbreviated. #15 + +- Fixed jumping to the correct place in a manpage when showing the + documentation for an infix argument. c4bf4af + +- Bound ~ESC ESC ESC~ to ~transient-quit-all~ because the convention is + that it should be possible to exit any temporary state using this + binding. #12 + +- Fixed referencing suffix bindings by their key when the key binding + is defined in the suffix object instead of in the suffix spec. + e4ffb97 + +- Remove trailing whitespace from popup text for the benefit of users + who have set enabled ~show-trailing-whitespace~ globally. 0758efa + +- Fixed showing available bindings on a single line instead of using + the usual popup buffer. 2f011c9, 99d3bf6 + +- Added a line between the ~lv~ window and the echo area. ca18bb6 + +- Fixed adding a new suffix at the end of a group and removing a + group's last suffix. #20, #6 + +- No longer use ~cl-typep~, which appears to have a bug on Emacs 25. + 9183fe1 + +- Fixed ~lisp~ make target. 170a3fd + +- Fixed reading a number as the value of an infix. 8219c0b + +- Various bug fixes to + ~transient--goto-argument-description~ (4f80a89), + ~transient-show-help~ (ccac95e), + ~transient-infix-read~ (7bf9759). + +* v0.1.0 2019-01-14 + +- First release. |