From: Juri Linkov Date: Sun, 19 Apr 2020 22:57:32 +0000 (+0300) Subject: * doc/emacs/windows.texi (Window Convenience): Decribe more windmove features. X-Git-Tag: emacs-27.1-rc1~203 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9261a219ec20340b3323015b756ef023901aed43;p=emacs.git * doc/emacs/windows.texi (Window Convenience): Decribe more windmove features. * doc/emacs/windows.texi (Window Convenience): Add descriptions of windmove-display-default-keybindings, windmove-delete-default-keybindings, windmove-swap-states-in-direction. * etc/NEWS: Regroup to move some parts closer to related sections. --- diff --git a/doc/emacs/windows.texi b/doc/emacs/windows.texi index 2e07a98f57d..910ef8fd88d 100644 --- a/doc/emacs/windows.texi +++ b/doc/emacs/windows.texi @@ -586,13 +586,25 @@ buffer. @xref{Follow Mode}. @cindex directional window selection @findex windmove-right @findex windmove-default-keybindings +@findex windmove-display-default-keybindings +@findex windmove-delete-default-keybindings +@findex windmove-swap-states-in-direction The Windmove package defines commands for moving directionally between neighboring windows in a frame. @kbd{M-x windmove-right} selects the window immediately to the right of the currently selected -one, and similarly for the left, up, and down -counterparts. @w{@kbd{M-x windmove-default-keybindings}} binds these -commands to @kbd{S-right} etc.; doing so disables shift selection for -those keys (@pxref{Shift Selection}). +one, and similarly for the left, up, and down counterparts. +@w{@kbd{M-x windmove-default-keybindings}} binds these commands to +@kbd{S-right} etc.; doing so disables shift selection for those keys +(@pxref{Shift Selection}). In the same way as keybindings can be +defined for commands that select windows directionally, you can use +@w{@kbd{M-x windmove-display-default-keybindings}} to define +keybindings for commands that specify in what direction to display the +window for the buffer that the next command is going to display. +Also there is @w{@kbd{M-x windmove-delete-default-keybindings}} to +define keybindings for commands that delete windows directionally, and +@w{@kbd{M-x windmove-swap-states-in-direction}} that define +keybindings for commands that swap the window contents of the selected +window with the window in the specified direction. The command @kbd{M-x compare-windows} lets you compare the text shown in different windows. @xref{Comparing Files}. diff --git a/etc/NEWS b/etc/NEWS index def1bce29aa..bca2037c176 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -934,7 +934,7 @@ back, customize 'follow-hide-ghost-cursors' to nil. *** 'windmove-create-window' when non-nil makes a new window. This happens upon moving off the edge of the frame. ---- ++++ *** Windmove supports directional window display and selection. The new command 'windmove-display-default-keybindings' binds default keys with provided modifiers (by default, Shift-Meta) to the commands @@ -948,7 +948,7 @@ display the buffer in the same window, for example, 'S-M-0 C-h e' displays the "*Messages*" buffer in the same window. 'S-M-t C-h C-n' displays NEWS in a new tab. ---- ++++ *** Windmove also supports directional window deletion. The new command 'windmove-delete-default-keybindings' binds default keys with provided prefix (by default, 'C-x') and modifiers (by default, @@ -958,7 +958,7 @@ With a prefix arg 'C-u', also kills the buffer in that window. With 'M-0', deletes the selected window and selects the window that was in the specified direction. ---- ++++ *** New command 'windmove-swap-states-in-direction' binds default keys to the commands that swap the states of the selected window with the window in the specified direction. @@ -1011,10 +1011,6 @@ remapped to these, respectively. ** Dired ---- -*** On systems that support suid/guid files, Dired now fontifies the -permissions of such files with a special face 'dired-set-id'. - +++ *** New command 'dired-create-empty-file'. @@ -1026,10 +1022,6 @@ It is by default bound to '* N'. *** The marking commands now report how many files were marked by the command itself, not how many files are marked in total. ---- -*** A new face, 'dired-special', is used to highlight sockets, named -pipes, block devices and character devices. - +++ *** The new user option 'dired-create-destination-dirs' controls whether 'dired-do-copy' and 'dired-rename-file' should create non-existent @@ -1047,6 +1039,14 @@ Dired performs file renaming using underlying version control system. *** Zstandard compression is now supported for 'dired-do-compress' and 'dired-do-compress-to'. +--- +*** On systems that support suid/guid files, Dired now fontifies the +permissions of such files with a special face 'dired-set-id'. + +--- +*** A new face, 'dired-special', is used to highlight sockets, named +pipes, block devices and character devices. + ** Find-Dired --- @@ -1068,12 +1068,6 @@ script. The default is nil. *** New command 'log-edit-generate-changelog-from-diff', bound to 'C-c C-w'. This generates ChangeLog entries from the VC fileset diff. ---- -*** 'vc-dir' now shows a button allowing you to hide the stash list. -Controlled by user option 'vc-git-show-stash'. Default t means show -the entire list as before. An integer value limits the list length -(but still allows you to show the entire list via the button). - +++ *** Recording ChangeLog entries doesn't require an actual file. If a ChangeLog file doesn't exist, and if the new user option @@ -1084,9 +1078,11 @@ still be used if it exists.) Set the user option to nil to get the previous behavior of always creating a buffer that visits a ChangeLog file. ---- -*** New user option 'vc-find-revision-no-save'. -With non-nil, 'vc-find-revision' doesn't write the created buffer to file. ++++ +*** The new 'd' command ('vc-dir-clean-files') in 'vc-dir-mode' +buffers will delete the marked files (or if no files are marked, the +file under point). This command does not notify the VC backend, and +is mostly useful for unregistered files. --- *** 'vc-dir-ignore' now takes a prefix argument to ignore all marked files. @@ -1101,6 +1097,12 @@ This new user option allows customizing the default arguments passed to When some files are marked, only those are stashed. When no files are marked, all modified files are stashed, as before. +--- +*** 'vc-dir' now shows a button allowing you to hide the stash list. +Controlled by user option 'vc-git-show-stash'. Default t means show +the entire list as before. An integer value limits the list length +(but still allows you to show the entire list via the button). + --- *** 'vc-git-stash' is now bound to 'C' in the stash headers. @@ -1133,25 +1135,19 @@ you invoke 'C-x v m' ('vc-merge'). instead of revision numbers as completion candidates when it prompts for a revision. -+++ -*** 'C-u C-x v D' ('vc-root-version-diff') prompts for two revisions -and compares their entire trees. - --- *** New user option 'vc-hg-revert-switches'. It specifies switches to pass to Hg's 'revert' command. ++++ +*** 'C-u C-x v D' ('vc-root-version-diff') prompts for two revisions +and compares their entire trees. + --- *** 'C-x v M D' ('vc-diff-mergebase') and 'C-x v M L' ('vc-log-mergebase') print diffs and logs between the merge base (common ancestor) of two given revisions. -+++ -*** The new 'd' command ('vc-dir-clean-files') in 'vc-dir-mode' -buffers will delete the marked files (or if no files are marked, the -file under point). This command does not notify the VC backend, and -is mostly useful for unregistered files. - +++ *** New command 'vc-log-search' asks for a pattern, searches it in the revision log, and displays matched log entries in the @@ -1169,6 +1165,10 @@ ID, and shows its log entry together with the diffs introduced by the revision's commit. (For some less capable VCSes, only the log entry is shown.) +--- +*** New user option 'vc-find-revision-no-save'. +With non-nil, 'vc-find-revision' doesn't write the created buffer to file. + --- *** 'C-x v =' can now mimic Magit's diff format. Set the new user option 'diff-font-lock-prettify' to t for that, see