some small docblock updates

src/SuperClosure/ClosureParser/Ast/AstParser.php

@@ -26,6 +26,7 @@ public function getDefaultOptions()
 
     public function parse($closure)
     {
+        // Prepare the closure and reflection objects for parsing
         $closure = $this->prepareClosure($closure);
         $closureReflection = $closure->getReflection();
 
@@ -37,6 +38,7 @@ public function parse($closure)
             // @codeCoverageIgnoreEnd
         }
 
+        // Do a second traversal through the closure's AST to apply additional transformations
         $closureLocation = $closureLocator->getLocation();
         if ($this->options[Options::HANDLE_MAGIC_CONSTANTS]) {
             // Resolve additional nodes by making a second pass through just the closure's nodes
@@ -46,7 +48,7 @@ public function parse($closure)
             $closureAst = $closureAst[0];
         }
 
-        // Get closure context data
+        // Get and return closure context data
         $astPrinter = new \PHPParser_PrettyPrinter_Default();
         $closureCode = $astPrinter->prettyPrint(array($closureAst));
         $closureVariables = $this->determineVariables($closureAst, $closureReflection);

src/functions.php

@@ -2,6 +2,7 @@
 
 namespace
 {
+    // This alias exists to provide backwards compatibility with version 1.0 of SuperClosure.
     class_alias('SuperClosure\SerializableClosure', 'Jeremeamia\SuperClosure\SerializableClosure');
 }