From 45246443b75a54c26935e007e3dd2989bba3eec7 Mon Sep 17 00:00:00 2001 From: Phil Sainty Date: Sat, 4 Nov 2023 19:26:31 +1300 Subject: [PATCH] Docs: Changelog entries for compose buffer enhancements --- README.org | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/README.org b/README.org index 26d784a8..6b58998e 100644 --- a/README.org +++ b/README.org @@ -302,9 +302,41 @@ Ement.el doesn't support encrypted rooms natively, but it can be used transparen + Customization group ~ement-room-list~. + Option ~ement-room-list-space-prefix~ is applied to space names in the room list (e.g. set to empty string for cleaner appearance). ++ A variety of enhancements for using compose buffers. ([[https://github.com/alphapapa/ement.el/issues/140][#140]]. Thanks to [[https://github.com/phil-s][Phil Sainty]].) + + Option ~ement-room-compose-buffer-display-action~ declares how and where a new compose buffer window should be displayed. + + Option ~ement-room-compose-buffer-auto-scale~ causes dynamic scaling of the compose buffer window height so that the full message is visible at all times. + + Option ~ement-room-compose-buffer-auto-scale-min-height~ specifies the minimum window height when ~ement-room-compose-buffer-auto-scale~ is enabled. + + Option ~ement-room-compose-buffer-auto-scale-max-height~ specifies the maximum window height when ~ement-room-compose-buffer-auto-scale~ is enabled. + + Option ~ement-room-compose-method~ chooses between minibuffer-centric or compose-buffer-centric behaviour. + + Command ~ement-room-dispatch-new-message~ starts writing a new message using your chosen ~ement-room-compose-method~. (Bound to ~RET~ in room buffers.) + + Command ~ement-room-dispatch-new-message-alt~ starts writing a new message using the alternative method. (Bound to ~M-RET~ in room buffers.) + + Command ~ement-room-dispatch-edit-message~ edits a message using your chosen ~ement-room-compose-method~. (Bound to ~~ in room buffers.) + + Command ~ement-room-dispatch-reply-to-message~ replies to a message using your chosen ~ement-room-compose-method~. (Bound to ~S-RET~ in room buffers.) + + Command ~ement-room-compose-edit~ edits a message using a compose buffer. + + Command ~ement-room-compose-reply~ replies to a message using a compose buffer. + + Command ~ement-room-compose-send-direct~ sends a message directly from a compose buffer (without the minibuffer). (Bound to ~C-x C-s~ in compose buffers.) + + Command ~ement-room-compose-abort~ kills the compose buffer and delete its window. (Bound to ~C-c C-k~ in compose buffers.) + + Command ~ement-room-compose-abort-no-history~ does the same without adding to ~ement-room-message-history~. (Equivalent to ~C-u C-c C-k~.) + + Command ~ement-room-compose-history-prev-message~ cycles backwards through ~ement-room-message-history~. (Bound to ~M-p~ in compose buffers.) + + Command ~ement-room-compose-history-next-message~ cycles forwards through ~ement-room-message-history~. (Bound to ~M-n~ in compose buffers.) + + Command ~ement-room-compose-history-isearch-backward~ initiates an isearch through ~ement-room-message-history~. (Bound to ~M-r~ in compose buffers; continue searching with ~C-r~ or ~C-s~.) + + Command ~ement-room-compose-history-isearch-backward-regexp~ initiates a regexp isearch through ~ement-room-message-history~. (Bound to ~C-M-r~ in compose buffers; continue searching with ~C-r~ or ~C-s~.) + ++ Global minor mode ~ement-room-self-insert-mode~ enables "just typing" to start a message. (Thanks to [[https://github.com/phil-s][Phil Sainty]].) + + Option ~ement-room-self-insert-chars~ determines which typed characters will immediately start a new message when ~ement-room-self-insert-mode~ is enabled. + + Option ~ement-room-mode-map-prefix-key~ defines a prefix key for accessing the full ~ement-room-mode-map~ when ~ement-room-self-insert-mode~ is enabled. (By default this key is ~DEL~.) + *Changes* + Bind ~TAB~ / ~BACKTAB~ to move between links in room and like buffers. ([[https://github.com/alphapapa/ement.el/issues/113][#113]]. Thanks to [[https://github.com/ericsfraga][Eric S. Fraga]] for suggesting.) ++ When editing or replying to a message in a compose buffer, the related room event is highlighed persistently until the compose buffer is killed. (Thanks to [[https://github.com/phil-s][Phil Sainty]].) ++ In compose buffers ~dabbrev~ will prioritise firstly the associated room, and secondly all other rooms, before looking to other buffers for completions. (Thanks to [[https://github.com/phil-s][Phil Sainty]].) ++ Aborted messages are now added to ~ement-room-message-history~ rather than the kill-ring. (Thanks to [[https://github.com/phil-s][Phil Sainty]].) ++ Prefix bindings in ~ement-room-mode-map~ now have named labels in ~which-key~ and similar. (Thanks to [[https://github.com/phil-s][Phil Sainty]].) + +*Fixes* + ++ Edits to previous edit events are correctly sent to the server as edits to the original message event. ([[https://github.com/alphapapa/ement.el/issues/230][#230]]. Thanks to [[https://github.com/phil-s][Phil Sainty]].) ** 0.13