Skip to content

Commit

Permalink
Docs: Changelog entries for compose buffer enhancements
Browse files Browse the repository at this point in the history
  • Loading branch information
Phil Sainty committed Jan 21, 2024
1 parent a6a39d5 commit a7955bc
Showing 1 changed file with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions README.org
Original file line number Diff line number Diff line change
Expand Up @@ -303,9 +303,42 @@ Ement.el doesn't support encrypted rooms natively, but it can be used transparen
+ Option ~ement-room-list-space-prefix~ is applied to space names in the room list (e.g. set to empty string for cleaner appearance).
+ Option ~ement-room-reaction-names-limit~ sets how many senders of a reaction are shown in the buffer (more than that many are shown in the tooltip).

+ 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-window-auto-height~ causes dynamic scaling of the compose buffer window height so that the full message is visible at all times.
+ Option ~ement-room-compose-buffer-window-auto-height-min~ specifies the minimum window height when ~ement-room-compose-buffer-window-auto-height~ is enabled.
+ Option ~ement-room-compose-buffer-window-auto-height-max~ specifies the maximum window height when ~ement-room-compose-buffer-window-auto-height~ 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 ~<insert>~ 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-commands~ determines which commands will start a new message when ~ement-room-self-insert-mode~ is enabled (defaulting to ~self-insert-command~ and ~yank~).
+ Option ~ement-room-self-insert-chars~ determines which typed characters will start a new message when ~ement-room-self-insert-mode~ is enabled (regardless of whether they are bound to ~self-insert-command~).
+ 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]].)

*Fixes*

Expand Down

0 comments on commit a7955bc

Please sign in to comment.