Fixing typos and cleaning up docblocks

Author: mtdowling

src/CompilerRuntime.php

@@ -4,11 +4,11 @@
 /**
  * Compiles JMESPath expressions to PHP source code and executes it.
  *
- * JMESPath filenames are stored in the cache directory using the following
+ * JMESPath file names are stored in the cache directory using the following
  * logic to determine the filename:
  *
  * 1. Start with the string "jmespath_"
- * 2. Append the MD5 checksum of the expresison.
+ * 2. Append the MD5 checksum of the expression.
  * 3. Append ".php"
  */
 class CompilerRuntime

src/TreeCompiler.php

@@ -110,10 +110,6 @@ private function visit_or(array $node)
             ->write('}');
     }
 
-    /**
-     * Visits a non-terminal subexpression. Subexpressions wrapping nested
-     * array accessors will be combined into a single if/then block.
-     */
     private function visit_subexpression(array $node)
     {
         return $this
@@ -125,9 +121,6 @@ private function visit_subexpression(array $node)
             ->write('}');
     }
 
-    /**
-     * Visits a terminal identifier
-     */
     private function visit_field(array $node)
     {
         $arr = '$value[' . var_export($node['value'], true) . ']';
@@ -149,9 +142,6 @@ private function visit_field(array $node)
         return $this;
     }
 
-    /**
-     * Visits a terminal index
-     */
     private function visit_index(array $node)
     {
         if ($node['value'] >= 0) {

src/TreeInterpreter.php

@@ -36,6 +36,7 @@ public function visit(array $node, $data)
      * Recursively traverses an AST using depth-first, pre-order traversal.
      * The evaluation logic for each node type is embedded into a large switch
      * statement to avoid the cost of "double dispatch".
+     * @return mixed
      */
     private function dispatch(array $node, $value)
     {
@@ -205,6 +206,9 @@ private function dispatch(array $node, $value)
         }
     }
 
+    /**
+     * @return bool
+     */
     private static function relativeCmp($left, $right, $cmp)
     {
         if (!is_int($left) || !is_int($right)) {