doc: Use imperative tense in select.rs.

In addition, consistently speak of a 'selection prompt'.

Author: grunweg

src/prompts/select.rs

@@ -5,7 +5,7 @@ use crate::theme::{SimpleTheme, TermThemeRenderer, Theme};
 
 use console::{Key, Term};
 
-/// Renders a select prompt.
+/// Render a selection prompt.
 ///
 /// User can select from one or more options.
 /// Interaction returns index of an item selected in the order they appear in `item` invocation or `items` slice.
@@ -51,22 +51,22 @@ impl Default for Select<'static> {
 }
 
 impl Select<'static> {
-    /// Creates a select prompt builder with default theme.
+    /// Create a selection prompt builder with default theme.
     pub fn new() -> Self {
         Self::with_theme(&SimpleTheme)
     }
 }
 
 impl Select<'_> {
-    /// Indicates whether select menu should be erased from the screen after interaction.
+    /// Indicate whether the selection menu should be erased from the screen after interaction.
     ///
     /// The default is to clear the menu.
     pub fn clear(&mut self, val: bool) -> &mut Self {
         self.clear = val;
         self
     }
 
-    /// Sets initial selected element when select menu is rendered
+    /// Set the initial selected element when the selection menu is rendered.
     ///
     /// Element is indicated by the index at which it appears in `item` method invocation or `items` slice.
     pub fn default(&mut self, val: usize) -> &mut Self {
@@ -106,7 +106,7 @@ impl Select<'_> {
         self
     }
 
-    /// Adds multiple items to the selector.
+    /// Add multiple items to the selector.
     ///
     /// ## Examples
     /// ```rust,no_run
@@ -130,7 +130,7 @@ impl Select<'_> {
         self
     }
 
-    /// Sets the select prompt.
+    /// Set the selection prompt.
     ///
     /// By default, when a prompt is set the system also prints out a confirmation after
     /// the selection. You can opt-out of this with [`report`](#method.report).
@@ -155,15 +155,15 @@ impl Select<'_> {
         self
     }
 
-    /// Indicates whether to report the selected value after interaction.
+    /// Indicate whether to report the selected value after interaction.
     ///
     /// The default is to report the selection.
     pub fn report(&mut self, val: bool) -> &mut Self {
         self.report = val;
         self
     }
 
-    /// Enables user interaction and returns the result.
+    /// Enable user interaction and return the result.
     ///
     /// The user can select the items with the 'Space' bar or 'Enter' and the index of selected item will be returned.
     /// The dialog is rendered on stderr.
@@ -174,7 +174,7 @@ impl Select<'_> {
         self.interact_on(&Term::stderr())
     }
 
-    /// Enables user interaction and returns the result.
+    /// Enable user interaction and return the result.
     ///
     /// The user can select the items with the 'Space' bar or 'Enter' and the index of selected item will be returned.
     /// The dialog is rendered on stderr.
@@ -350,7 +350,7 @@ impl Select<'_> {
 }
 
 impl<'a> Select<'a> {
-    /// Creates a select prompt builder with a specific theme.
+    /// Create a selection prompt builder with a specific theme.
     ///
     /// ## Examples
     /// ```rust,no_run