master b516887: Fix documentation of recent 'windmove' changes

[Eli Zaretskii]

branch: master
commit b516887283ce77cf3c0977154f713ef485e3e8a9
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    Fix documentation of recent 'windmove' changes
    
    * lisp/windmove.el (windmove-default-keybindings)
    (windmove-display-default-keybindings)
    (windmove-delete-default-keybindings)
    (windmove-swap-states-default-keybindings): Improve doc strings.
    (Bug#41438)
    
    * etc/NEWS: Fix a typo in the 'windmove' entry.
---
 etc/NEWS         |  4 ++--
 lisp/windmove.el | 12 ++++++++----
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/etc/NEWS b/etc/NEWS
index 8b20700..6759259 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -557,8 +557,8 @@ disabled entirely.
 
 ** Windmove
 
-*** New user options can be used to customize windmove keybindings.
-There options include 'windmove-default-keybindings',
+*** New user options to customize windmove keybindings.
+These options include 'windmove-default-keybindings',
 'windmove-display-default-keybindings',
 'windmove-delete-default-keybindings',
 'windmove-swap-states-default-keybindings'.
diff --git a/lisp/windmove.el b/lisp/windmove.el
index 0eba97a..f558903 100644
--- a/lisp/windmove.el
+++ b/lisp/windmove.el
@@ -749,7 +749,8 @@ Default value of MODIFIERS is `shift-super'."
   "Customisation type for windmove modifiers.")
 
 (defcustom windmove-default-keybindings nil
-  "Default bindings for regular windmove commands."
+  "Default keybindings for regular windmove commands.
+See `windmove-default-keybindings' for more detail."
   :set (lambda (sym val)
          (windmove-install-defaults
           (car val) (cdr val)
@@ -764,7 +765,8 @@ Default value of MODIFIERS is `shift-super'."
   :group 'windmove)
 
 (defcustom windmove-display-default-keybindings nil
-  "Default bindings for display windmove commands."
+  "Default keybindings for windmove directional buffer display commands.
+See `windmove-display-default-keybindings' for more detail."
   :set (lambda (sym val)
          (windmove-install-defaults
           (car val) (cdr val)
@@ -782,7 +784,8 @@ Default value of MODIFIERS is `shift-super'."
   :group 'windmove)
 
 (defcustom windmove-delete-default-keybindings nil
-  "Default bindings for delete windmove commands."
+  "Default keybindings for windmove directional window deletion commands.
+See `windmove-delete-default-keybindings' for more detail."
   :set (lambda (sym val)
          (windmove-install-defaults
           (car val) (cdr val)
@@ -797,7 +800,8 @@ Default value of MODIFIERS is `shift-super'."
   :group 'windmove)
 
 (defcustom windmove-swap-states-default-keybindings nil
-  "Default bindings for swap-state windmove commands."
+  "Default keybindings for windmove's directional window swap-state commands.
+See `windmove-swap-states-default-keybindings' for more detail."
   :set (lambda (sym val)
          (windmove-install-defaults
           (car val) (cdr val)