branch: externals/ivy
commit 425c85672454b44fb84250d607636f8879ffade2
Author: Basil L. Contovounesios <[email protected]>
Commit: Basil L. Contovounesios <[email protected]>

    * ivy.el (ivy-state): Document some slots.
---
 ivy.el | 31 +++++++++++++++++++------------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/ivy.el b/ivy.el
index 3c900c9542..b790306887 100644
--- a/ivy.el
+++ b/ivy.el
@@ -393,25 +393,32 @@ Remove DEF from `counsel-M-x' list."
 ;;; Globals
 
 (cl-defstruct ivy-state
+  "State representing a call to `ivy-read'."
   prompt collection
   predicate require-match initial-input
   history preselect keymap update-fn sort
-  ;; The frame in which `ivy-read' was called
-  frame
-  ;; The window in which `ivy-read' was called
-  window
-  ;; The buffer in which `ivy-read' was called
-  buffer
-  ;; The value of `ivy-text' to be used by `ivy-occur'
-  text
+  (frame
+   nil :type frame :documentation
+   "The frame in which `ivy-read' was called.")
+  (window
+   nil :type window :documentation
+   "The window in which `ivy-read' was called.")
+  (buffer
+   nil :type buffer :documentation
+   "The buffer in which `ivy-read' was called.")
+  (text
+   nil :type string :documentation
+   "The value of `ivy-text' to be used by `ivy-occur'.")
   action
   unwind
   re-builder
   matcher
-  ;; When this is non-nil, call it for each input change to get new candidates
-  dynamic-collection
-  ;; A lambda that transforms candidates only for display
-  display-transformer-fn
+  (dynamic-collection
+   nil :documentation
+   "When non-nil, call collection anew for each input change.")
+  (display-transformer-fn
+   nil :documentation
+   "A function that formats candidates for display.")
   directory
   caller
   current

Reply via email to