Exit code 64 for help + bad syntax

Author: MickaelBlet

README.md

@@ -2,6 +2,7 @@
 
 Parse and stock arguments/options from `argv`.  
 Inspired by the Python library [argparse](https://python.readthedocs.io/en/latest/library/argparse.html).  
+Compatible with **bash** version >= **4.2.0**.  
 Documentations available at [documentations](#documentations).
 
 Use [getopt](https://www.man7.org/linux/man-pages/man1/getopt.1.html) for parse arguments/options.
@@ -15,7 +16,7 @@ set -euo pipefail
 
 source "args.sh"
 
-args_set_description "example of description"
+args_set_description "example" "of" "description"
 args_set_epilog "example of epilog"
 
 args_add_argument \
@@ -24,10 +25,10 @@ args_add_argument \
     --required \
     -- "ARG1"
 args_add_argument \
-    --help="clear the test directory" \
+    --help="print hello" \
     --action="store_true" \
-    --dest="OPT_CLEAR" \
-    -- "-c" "--clear"
+    --dest="DO_HELLO" \
+    -- "-p" "--print-hello"
 args_add_argument \
     --help="help of option" \
     --metavar="VALUE" \
@@ -36,85 +37,62 @@ args_add_argument \
 
 args_parse_arguments "$@"
 
-echo "'ARG1' argument from dest $ARG1"
+echo "'ARG1' argument from dest ${ARG1:-}"
 echo "'ARG1' argument from map  ${ARGS[ARG1]}"
-echo "'-c/--clear' option from dest $OPT_CLEAR"
-echo "'-c/--clear' option from map  ${ARGS[c]}/${ARGS[clear]}"
 echo "'--option' option from map ${ARGS[option]}"
+if $DO_HELLO; then
+    echo "Hello world"
+fi
 ```
 
 ```
 $ ./example/quickstart.sh
 ./example/quickstart.sh: argument 'ARG1' is required
 $ ./example/quickstart.sh -h
-usage: quickstart.sh [-c] [-h] [--option VALUE] -- ARG1
+usage: quickstart.sh [-h] [-p] [--option VALUE] -- ARG1
 
 example of description
 
 positional arguments:
   ARG1                  take the first argument
 
 optional arguments:
-  -c, --clear           clear the test directory
   -h, --help            print this help message
+  -p, --print-hello     print hello
   --option VALUE        help of option
 
 example of epilog
 $ ./example/quickstart.sh 42
 'ARG1' argument from dest 42
 'ARG1' argument from map  42
-'-c/--clear' option from dest false
-'-c/--clear' option from map  false/false
 '--option' option from map 24
-```
-
-## Functions
-
-### args_add_argument
-
-Add a argument
-
-|option|description|
-|---|---|
-|--action|Action (store,store_true,store_false) (default:store)|
-|--default|Default value|
-|--dest|Destination variable|
-|--help|Usage helper|
-|--metavar|Usage argument name (if not set use long/short name)|
-|--required|Is required if present|
-
-```bash
-args_add_argument [options] -- [name/flags...]
-```
-
-#### Examples
-
-```bash
-# positional argument
-args_add_argument --help="help of FOO" --dest="FOO" --required -- "FOO"
-# boolean optional argument
-args_add_argument --action="store_true" --help="help of foo" --dest="FOO" -- "-f" "--foo"
-# not boolean optional argument
-args_add_argument --action="store_false" --help="help of foo" --dest="FOO" -- "-f" "--foo"
-# optional argument
-args_add_argument --help="help of foo" --dest="FOO" -- "-f" "--foo"
-```
-
-### args_parse_arguments
-
-Use after args_add_* functions  
-Convert argument strings to objects and assign them as attributes on the ARGS map  
-Previous calls to args_add_argument/args_add_bool_option/args_add_reverse_bool_option/args_add_option  
-determine exactly what objects are created and how they are assigned  
-Execute this with "$@" parameters
-
-#### Example
-
-```bash
-args_parse_arguments "$@"
+$ ./example/quickstart.sh 42 -p
+'ARG1' argument from dest 42
+'ARG1' argument from map  42
+'--option' option from map 24
+Hello world
+$ ./example/quickstart.sh 42 -p --option 42
+'ARG1' argument from dest 42
+'ARG1' argument from map  42
+'--option' option from map 42
+Hello world
 ```
 
 ## Documentations
 
-[docs/global.md](docs/global.md)  
-[docs/setter.md](docs/setter.md)
+|Function|Description|
+|---|---|
+|[args_add_argument](docs/functions.md#args_add_argument)|Add a argument|
+|[args_parse_arguments](docs/functions.md#args_parse_arguments)|Convert argument strings to objects and assign them as attributes on the ARGS map|
+|[args_set_description](docs/functions.md#args_set_description)|Set a usage description|
+|[args_set_epilog](docs/functions.md#args_set_epilog)|Set a epilog description|
+|[args_set_usage_width](docs/functions.md#args_set_usage_width)|Set the widths of usage message|
+|[args_set_usage](docs/functions.md#args_set_usage)|Set a full usage message|
+|[args_set_alternative](docs/functions.md#args_set_alternative)|Set alternative mode for [getopt](https://www.man7.org/linux/man-pages/man1/getopt.1.html)|
+|[args_usage](docs/functions.md#args_usage)|Show/Generate usage message|
+|[args_clean](docs/functions.md#args_clean)|Clean all map and array for recalled|
+|[args_debug_values](docs/functions.md#args_debug_values)|Show all values of arguments and options|
+
+|Global|
+|---|
+|[variables](docs/global.md#variables)|