clean: One pass over code and docs to do cleaning (#19)

Author: gliga

doc/index.rst

@@ -2,11 +2,12 @@
 gobash documentation
 ====================
 
-gobash is a set of bash functions that improve programming experience
-in bash (by providing collections, languages features, APIs, testing
-package, command line flag parsing, etc.) without modifying the shell
-interpreter(s). It works with any bash version (on Linux and
-Mac). Parts of the API match those in Go.
+gobash, a self-proclaimed standard bash library, is a set of bash
+functions that improve programming experience in bash (by providing
+collections, languages features, APIs, testing package, command line
+flag parsing, etc.) without modifying the shell interpreter(s). It
+works with any bash version (on Linux and Mac). Parts of the API match
+those in Go.
 
 gobash is publicly available on `GitHub
 <https://github.com/EngineeringSoftware/gobash>`_ under the

doc/language.rst

@@ -159,14 +159,12 @@ method that computes its total area.
 
             make_ $FUNCNAME \
                 "r" "${r}"
-            return $?
     }
 
     function Circle_area() {
-            local -r obj="${1}"
+            local -r c="${1}"
 
-            echo "$MATH_PI * $($obj r) * $($obj r)" | bc
-            return 0
+            echo "$MATH_PI * $($c r) * $($c r)" | bc
     }
 
 Invoking a method is similar to other programming languages. Below, we
@@ -214,8 +212,8 @@ only the name of the person.
 .. code-block:: bash
 
     function Person_to_string() {
-        local -r obj="${1}"
-        echo "I am $($obj name)."
+            local -r p="${1}"
+            echo "I am $($p name)."
     }
     p=$(Person "Jessy" 10)
     $p to_string

src/ui/textui.sh

@@ -79,7 +79,6 @@ function TextSpinner() {
 
         make_ $ctx \
               "${FUNCNAME}" \
-              "ix" "0" \
               "pid" "${NULL}"
 }