lib/menu.yml in markdown_exec-1.8.5 vs lib/menu.yml in markdown_exec-1.8.6

@@ -1,6 +1,6 @@
-# MDE - Markdown Executor (1.8.5)
+# MDE - Markdown Executor (1.8.6)
 ---
 - :description: Show current configuration values
   :procname: show_config
   :short_name: '0'
 - :arg_name: BOOL
@@ -13,11 +13,11 @@
   :env_var: MDE_BLOCK_CALLS_SCAN
   :opt_name: block_calls_scan
   :procname: val_as_str
 - :arg_name: NAME
   :compreply: false
-  :description: Name of block
+  :description: Name of block to execute
   :env_var: MDE_BLOCK_NAME
   :long_name: block-name
   :opt_name: block_name
   :procname: val_as_str
   :short_name: b
@@ -172,21 +172,23 @@
 - :description: Exit app
   :long_name: exit
   :procname: exit
   :short_name: x
 - :default: "^(?<indent> *)`{3,}"
+  :description: Matches the start and end of a fenced code block
   :env_var: MDE_FENCED_START_AND_END_REGEX
   :opt_name: fenced_start_and_end_regex
   :procname: val_as_str
 - :default: "^(?<indent> *)`{3,}(?<shell>[^`\\s]*) *:?(?<name>[^\\s]*) *(?<rest>.*)
     *$"
+  :description: Match the start of a fenced block
   :env_var: MDE_FENCED_START_EXTENDED_REGEX
   :opt_name: fenced_start_extended_regex
   :procname: val_as_str
 - :arg_name: RELATIVE_PATH
   :compreply: "."
-  :description: Name of document
+  :description: Name of the document to load
   :env_var: MDE_FILENAME
   :long_name: filename
   :opt_name: filename
   :procname: val_as_str
   :short_name: f
@@ -194,10 +196,17 @@
   :default: ''
   :description: Find in documents
   :long_name: find
   :procname: find
   :short_name: "?"
+- :arg_name: FIND_PATH
+  :default: ''
+  :description: Path for find (uses PATH if empty)
+  :env_var: MDE_FIND_PATH
+  :long_name: find-path
+  :opt_name: find_path
+  :procname: val_as_str
 - :default: "^# *(?<name>[^#]*?) *$"
   :env_var: MDE_HEADING1_MATCH
   :opt_name: heading1_match
   :procname: val_as_str
 - :default: "^## *(?<name>[^#]*?) *$"
@@ -298,11 +307,12 @@
   :env_var: MDE_MENU_BLOCKS_WITH_DOCNAME
   :opt_name: menu_blocks_with_docname
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: false
-  :description: Display headings (levels 1,2,3) in block selection menu
+  :description: Controls whether headings(levels 1,2,3) are displayed in the block
+    selection menu
   :env_var: MDE_MENU_BLOCKS_WITH_HEADINGS
   :opt_name: menu_blocks_with_headings
   :procname: val_as_bool
 - :default: fg_rgbh_40_c0_c0
   :description: Color of menu chrome
@@ -357,11 +367,11 @@
   :env_var: MDE_MENU_INCLUDE_IMPORTED_BLOCKS
   :opt_name: menu_include_imported_blocks
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: false
-  :description: Include imported notes in menu
+  :description: Whether imported blocks should be included in the menu
   :env_var: MDE_MENU_INCLUDE_IMPORTED_NOTES
   :opt_name: menu_include_imported_notes
   :procname: val_as_bool
 - :default:
     :line: ''
@@ -509,11 +519,11 @@
   :long_name: output-script
   :opt_name: output_script
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: true
-  :description: Display standard output from execution
+  :description: Whether standard output from execution is displayed
   :env_var: MDE_OUTPUT_STDOUT
   :long_name: output-stdout
   :opt_name: output_stdout
   :procname: val_as_bool
 - :description: Options for viewing saved output file
@@ -528,19 +538,19 @@
   :opt_name: path
   :procname: val_as_str
   :short_name: p
 - :arg_name: BOOL
   :default: true
-  :description: Pause afte executing a BASH block
-  :env_var: MDE_PAUSE_after_script_execution
+  :description: Wheter to pause after manually executing a block and the next menu
+  :env_var: MDE_PAUSE_AFTER_SCRIPT_EXECUTION
   :opt_name: pause_after_script_execution
   :procname: val_as_bool
 - :default: |2-
 
     Continue?
-  :description: Prompt after script execution
-  :env_var: MDE_PROMPT_after_script_execution
+  :description: Prompt after manually executing a block and the next menu
+  :env_var: MDE_PROMPT_AFTER_SCRIPT_EXECUTION
   :opt_name: prompt_after_script_execution
   :procname: val_as_str
 - :default: |2-
 
     Process?
@@ -613,11 +623,11 @@
   :env_var: MDE_RUNTIME_EXCEPTION_ERROR_LEVEL
   :opt_name: runtime_exception_error_level
   :procname: val_as_int
 - :arg_name: BOOL
   :default: false
-  :description: Save executed script
+  :description: Wheter to save an executed script`
   :env_var: MDE_SAVE_EXECUTED_SCRIPT
   :long_name: save-executed-script
   :opt_name: save_executed_script
   :procname: val_as_bool
 - :arg_name: BOOL
@@ -649,11 +659,11 @@
   :env_var: MDE_SAVED_SCRIPT_FILENAME_PREFIX
   :opt_name: saved_script_filename_prefix
   :procname: val_as_str
 - :arg_name: RELATIVE_PATH
   :default: logs
-  :description: Saved script folder
+  :description: Folder where saved scripts are stored
   :env_var: MDE_SAVED_SCRIPT_FOLDER
   :long_name: saved-script-folder
   :opt_name: saved_script_folder
   :procname: val_as_str
 - :arg_name: GLOB
@@ -758,10 +768,10 @@
   :long_name: tab-completions
   :opt_name: tab_completions
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: true
-  :description: Pause for user to approve script
+  :description: Requires user approval before executing a script
   :env_var: MDE_USER_MUST_APPROVE
   :long_name: user-must-approve
   :opt_name: user_must_approve
   :procname: val_as_bool
   :short_name: q