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

@@ -15,11 +15,11 @@
   :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
@@ -201,22 +201,24 @@
   :short_name: x
 
 ## match fenced code indented by spaces
 #
 - :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
@@ -226,10 +228,18 @@
   :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
 
@@ -352,11 +362,11 @@
   :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
@@ -422,11 +432,12 @@
   :opt_name: menu_include_imported_blocks
   :procname: val_as_bool
 
 - :arg_name: BOOL
   :default: false
-  :description: Include imported notes in menu
+  # :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:
@@ -604,11 +615,11 @@
   :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
 
@@ -626,18 +637,18 @@
   :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: "\nContinue?"
-  :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: "\nProcess?"
   :description: Prompt to approve a block
@@ -715,11 +726,11 @@
   :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
 
@@ -757,11 +768,11 @@
   :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
 
@@ -882,10 +893,10 @@
   :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