echo-help: fix typos and document exclamation

Author: balupton

commands/echo-help

@@ -4,6 +4,7 @@ function echo_help_test() (
 	source "$DOROTHY/sources/bash.bash"
 
 	# if there is invalid syntax, then the status won't be 0
+	# @todo automate this to `fixtures/` instead of manual review
 	eval-tester --ignore-stderr -- echo-help 'first argument' --blue='second argument' <<-EOF
 		This <bold> should be bold.
 		This [dim] should be dim.
@@ -50,6 +51,10 @@ function echo_help_test() (
 		\`printf '%s\n' 'sup'; printf 'a\nb\nc'
 		echo-clear-lines -- \$'a\\nb\\nc'\`
 
+		An important note:
+		! my important note.
+		    ! my other important note.
+
 		Using process substitution:
 		\`\`\`
 		printf '%s\n' 'sup'; printf 'a\nb\nc'
@@ -180,6 +185,7 @@ function echo_help() (
 			Text wrapped in three backticks indicates literal code that ignores the above, e.g. \`\`\`--timeout=<timeout:max|immediate|<seconds>>\`\`\`
 			A URL wrapped in angled brackets indicates a URL: \`\`\`<https://dorothy.bevry.me>\`\`\` becomes <https://dorothy.bevry.me>
 			A line that is all capitals with a trailing colon indicates a header, such as the \`ABOUT:\`, \`USAGE:\`, \`OPTIONS:\`, and \`TEMPLATE:\` from earlier.
+			! A line preceeded by \`! \` will have the exclamation mark styled red. Use this for important notes, such as variable overrides and conflicts.
 
 			A line that starts with an asterisk \`*\` indicates a list item, e.g.:
 			\`\`\`
@@ -212,9 +218,10 @@ function echo_help() (
 			       * If \`thing\`, do that.
 			       * If \`other\`, do this.
 
-			Arguments that are passed to \`echo-help\` will become errors that are appended to the bottom. It is will up to you to return the correct exit status.
+			Exit status will be [22] \`EINVAL 22 Invalid argument\`.
 
-			Exit status should typically be: \`return 22 # EINVAL 22 Invalid argument\`
+			Arguments that are passed to \`echo-help\` will become errors that are appended to the bottom.
+			If you want a custom error exit status, it is up to you to ignore and return it.
 		HELPEOF
 		return 22 # EINVAL 22 Invalid argument
 	}