tweaks to reformat tool; doc updates

doc/BUILD_STEPS

@@ -19,3 +19,13 @@
 4 - (optional) run test programs
 
     make tests && make check
+
+Notes on using uncrustify
+-----------------
+- version 0.61 is required
+- build/install uncrustify from your favorite distro (0.61), OR download from
+  https://github.com/bengardner/uncrustify and build from source
+  (configure --prefix /path/to/install && make && make install)
+- either use uncrustify directly (see uncrustify --help) or use the provided
+  reformat.sh tool which is a shim over some of the options (see reformat.sh
+  -h)

reformat.sh

@@ -18,6 +18,7 @@ USAGE: reformat.sh [-x] [-i] [-c CFG] [-b FILE] {-a | FILE...}
     -a: perform recursively on all files ending in .c or .h
         if -a not provided, then perform on all files passed in
     -x: instead of formatting, check if output format is the same as input
+    -h: show this help and exit
 EOF
 }
 
@@ -40,7 +41,7 @@ do_recursive=no
 do_check=no
 blacklist=
 
-while getopts ":ib:ax" opt; do
+while getopts ":ib:axh" opt; do
     case $opt in
         i)
             do_inplace=yes
@@ -57,6 +58,10 @@ while getopts ":ib:ax" opt; do
         x)
             do_check=yes
             ;;
+        h)
+            usage
+            exit 1
+            ;;
         \?)
             usage
             error "invalid argument: -$OPTARG"