Grammar and formatting

src/strategies/match_prev_cmd.zsh

@@ -3,17 +3,18 @@
 # Match Previous Command Suggestion Strategy                         #
 #--------------------------------------------------------------------#
 # Suggests the most recent history item that matches the given
-# prefix, and whose preceding history item also matches the most
+# prefix and whose preceding history item also matches the most
 # recently executed command.
 #
-# For example, if your have just executed:
+# For example, suppose your history has the following entries:
-#   pwd
+#   - pwd
-#   ls foo
+#   - ls foo
-#   ls bar
+#   - ls bar
-#   pwd
+#   - pwd
-# And then you start typing 'ls', then the suggestion will be 'ls foo',
+#
-# rather than 'ls bar', as your most recently executed command (pwd)
+# Given the history list above, when you type 'ls', the suggestion
-# was followed by 'ls foo' on it's previous invocation.
+# will be 'ls foo' rather than 'ls bar' because your most recently
+# executed command (pwd) was previously followed by 'ls foo'.
 #
 
 _zsh_autosuggest_strategy_match_prev_cmd() {

zsh-autosuggestions.zsh

@@ -356,17 +356,18 @@ _zsh_autosuggest_strategy_default() {
 # Match Previous Command Suggestion Strategy                         #
 #--------------------------------------------------------------------#
 # Suggests the most recent history item that matches the given
-# prefix, and whose preceding history item also matches the most
+# prefix and whose preceding history item also matches the most
 # recently executed command.
 #
-# For example, if your have just executed:
+# For example, suppose your history has the following entries:
-#   pwd
+#   - pwd
-#   ls foo
+#   - ls foo
-#   ls bar
+#   - ls bar
-#   pwd
+#   - pwd
-# And then you start typing 'ls', then the suggestion will be 'ls foo',
+#
-# rather than 'ls bar', as your most recently executed command (pwd)
+# Given the history list above, when you type 'ls', the suggestion
-# was followed by 'ls foo' on it's previous invocation.
+# will be 'ls foo' rather than 'ls bar' because your most recently
+# executed command (pwd) was previously followed by 'ls foo'.
 #
 
 _zsh_autosuggest_strategy_match_prev_cmd() {