style: format shell files

Apply shfmt output to shell examples and test fixtures, and remove
trailing whitespace from the awk script.

Author: kovetskiy

examples/readme-example.sh

@@ -33,7 +33,7 @@
 say-hello() {
     if [[ ! "$1" ]]; then
         echo "Oups !" >&2
-        return 1;
+        return 1
     fi
 
     echo "Hello $1"

shdoc

@@ -448,23 +448,23 @@ function render_docblock_list(docblock, docblock_name, title) {
 #   long_option_regex = "--[[:alnum:]][[:alnum:]-]*((=|[[:blank:]]+)<[^>]+>)?"
 #   pipe_separator_regex = "([[:blank:]]*\\|?[[:blank:]]+)"
 #   description_regex = "([^[:blank:]|<-].*)?"
-#   
+#
 #   # Build regex matching all options
 #   short_or_long_option_regex = sprintf("(%s|%s)", short_option_regex, long_option_regex)
-# 
+#
 #   # Build regex matching multiple options separated by spaces or pipe.
 #   all_options_regex = sprintf("(%s%s)+", short_or_long_option_regex, pipe_separator_regex)
-# 
+#
 #   # Build final regex.
 #   optional_arg_regex = sprintf("^(%s)%s$", all_options_regex, description_regex)
 #   ```
-# 
+#
 #   Final regex with non-matching groups (unsupported by gawk).
-# 
+#
 #   `^((?:(?:-[[:alnum:]](?:[[:blank:]]*<[^>]+>)?|--[[:alnum:]][[:alnum:]-]*(?:(?:=|[[:blank:]]+)<[^>]+>)?)(?:[[:blank:]]*\|?[[:blank:]]+))+)([^[:blank:]|<-].*)?$`
 #
 # @param text   The text to process as an @option entry.
-# 
+#
 # @set dockblock["option"] A docblock for correctly formated options.
 # @set dockblock["option-bad"] A docblock for badly formated options.
 function process_at_option(text) {
@@ -764,7 +764,7 @@ in_example {
 # Select @arg lines with content.
 /^[[:blank:]]*#[[:blank:]]+@arg[[:blank:]]+[^[:blank:]]/ {
     debug("→ @arg")
-    
+
     arg_text = $0
 
     # Remove '# @arg ' tag.
@@ -855,9 +855,9 @@ multiple_line_docblock_name {
     # Check if current line indentation does match the previous line docblock item.
     if ($0 ~ multiple_line_identation_regex ) {
         debug("→ @" multiple_line_docblock_name " - new line")
-        
+
         # Current line has the same indentation as the stderr section.
-    
+
         # Remove indentation and trailing spaces.
         sub(/^[[:space:]]*#[[:space:]]+/, "")
         sub(/[[:space:]]+$/, "")
@@ -968,18 +968,18 @@ END {
         print render("h1", file_title)
 
         if (file_brief != "") {
-            print file_brief "\n" 
+            print file_brief "\n"
         }
 
         if (file_description != "") {
             print render("h2", "Overview")
-            print file_description "\n" 
+            print file_description "\n"
         }
     }
 
     if (toc != "") {
         print render("h2", "Index")
-        print toc "\n" 
+        print toc "\n"
     }
 
     print doc

tests/teardown.sh

@@ -0,0 +1 @@
+

tests/testcases/@deprecated-standalone.test.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-tests:put input <<EOF
+tests:put input << EOF
 # @name Project Name
 # @brief Brief
 # @description overview
@@ -11,7 +11,7 @@ some:first:func() {
 }
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # Project Name
 
 Brief

tests/testcases/@deprecated.test.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-tests:put input <<EOF
+tests:put input << EOF
 # @name Project Name
 # @brief Brief
 # @description overview
@@ -12,7 +12,7 @@ some:first:func() {
 }
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # Project Name
 
 Brief

tests/testcases/@function-declaration.test.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-tests:put input <<EOF
+tests:put input << EOF
 # @name Project Name
 # @brief Brief
 # @description the file description
@@ -45,7 +45,7 @@ g
 h
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # Project Name
 
 Brief

tests/testcases/@name-and-@description.test.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-tests:put input <<EOF
+tests:put input << EOF
 # @name Project Name
 # @brief Brief
 # @description a
@@ -27,7 +27,7 @@ c() {
 }
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # Project Name
 
 Brief

tests/testcases/@option.test.sh

@@ -15,7 +15,7 @@
 #   - appears before numeric argument list.
 #   - appears between @example and @set sections.
 
-tests:put input <<EOF
+tests:put input << EOF
 # @name shdoc @option tests for options
 # @brief Test @option functionnality for options.
 # @description Tests for shdoc processing of @option keyword.
@@ -41,7 +41,7 @@ test-arg() {
 }
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # shdoc @option tests for options
 
 Test @option functionnality for options.

tests/testcases/@section.test.sh

@@ -1,5 +1,4 @@
-
-tests:put input <<EOF
+tests:put input << EOF
 # @name Project Name
 # @brief Brief
 # @description a
@@ -25,7 +24,7 @@ b() {
 }
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # Project Name
 
 Brief

tests/testcases/@see.test.sh

@@ -19,7 +19,7 @@
 #   - a markdown link.
 #   - a text containing a markdown link.
 #   - a text containing a markdown link and a URL.
-tests:put input <<EOF
+tests:put input << EOF
 # @name shdoc @see tests
 # @brief Test @see functionnality.
 # @description Tests for shdoc processing of @see keyword.
@@ -45,7 +45,7 @@ test-working-see() {
 
 EOF
 
-tests:put expected <<EOF
+tests:put expected << EOF
 # shdoc @see tests
 
 Test @see functionnality.