Clean up comments, standardize whitespace.

src/Mustache/Cache.php

@@ -21,6 +21,7 @@ interface Mustache_Cache
      * Load a compiled Mustache_Template class from cache.
      *
      * @param string $key
+     *
      * @return boolean indicates successfully class load
      */
     public function load($key);
@@ -30,6 +31,7 @@ interface Mustache_Cache
      *
      * @param string $key
      * @param string $value
+     *
      * @return void
      */
     public function cache($key, $value);

src/Mustache/Cache/AbstractCache.php

@@ -20,11 +20,21 @@ abstract class Mustache_Cache_AbstractCache implements Mustache_Cache
 {
     private $logger = null;
 
+    /**
+     * Get the current logger instance.
+     *
+     * @return Mustache_Logger|Psr\Log\LoggerInterface
+     */
     public function getLogger()
     {
         return $this->logger;
     }
 
+    /**
+     * Set a logger instance.
+     *
+     * @param Mustache_Logger|Psr\Log\LoggerInterface $logger
+     */
     public function setLogger($logger = null)
     {
         if ($logger !== null && !($logger instanceof Mustache_Logger || is_a($logger, 'Psr\\Log\\LoggerInterface'))) {
@@ -34,6 +44,13 @@ abstract class Mustache_Cache_AbstractCache implements Mustache_Cache
         $this->logger = $logger;
     }
 
+    /**
+     * Add a log record if logging is enabled.
+     *
+     * @param integer $level   The logging level
+     * @param string  $message The log message
+     * @param array   $context The log context
+     */
     protected function log($level, $message, array $context = array())
     {
         if (isset($this->logger)) {

src/Mustache/Cache/FilesystemCache.php

@@ -40,6 +40,7 @@ class Mustache_Cache_FilesystemCache extends Mustache_Cache_AbstractCache
      * Load the class from cache using `require_once`.
      *
      * @param string $key
+     *
      * @return boolean
      */
     public function load($key)
@@ -59,6 +60,7 @@ class Mustache_Cache_FilesystemCache extends Mustache_Cache_AbstractCache
      *
      * @param string $key
      * @param string $value
+     *
      * @return void
      */
     public function cache($key, $value)
@@ -80,6 +82,7 @@ class Mustache_Cache_FilesystemCache extends Mustache_Cache_AbstractCache
      * Subclasses should override for custom cache directory structures.
      *
      * @param string $name
+     *
      * @return string
      */
     protected function getCacheFilename($name)
@@ -90,10 +93,11 @@ class Mustache_Cache_FilesystemCache extends Mustache_Cache_AbstractCache
     /**
      * Create cache directory
      *
-     * @param  string $fileName
-     * @return string
-     *
      * @throws Mustache_Exception_RuntimeException If unable to create directory
+     *
+     * @param string $fileName
+     *
+     * @return string
      */
     private function buildDirectoryForFilename($fileName)
     {
@@ -110,17 +114,19 @@ class Mustache_Cache_FilesystemCache extends Mustache_Cache_AbstractCache
                 throw new Mustache_Exception_RuntimeException(sprintf('Failed to create cache directory "%s".', $dirName));
             }
         }
+
         return $dirName;
     }
 
     /**
      * Write cache file
      *
+     * @throws Mustache_Exception_RuntimeException If unable to write file
+     *
      * @param string $fileName
      * @param string $value
-     * @return void
      *
-     * @throws Mustache_Exception_RuntimeException If unable to write file
+     * @return void
      */
     private function writeFile($fileName, $value)
     {

src/Mustache/Cache/NoopCache.php

@@ -21,6 +21,7 @@ class Mustache_Cache_NoopCache extends Mustache_Cache_AbstractCache
      * Loads nothing. Move along.
      *
      * @param string $key
+     *
      * @return boolean
      */
     public function load($key)
@@ -33,6 +34,7 @@ class Mustache_Cache_NoopCache extends Mustache_Cache_AbstractCache
      *
      * @param string $key
      * @param string $compiled
+     *
      * @return void
      */
     public function cache($key, $compiled)

src/Mustache/Engine.php

@@ -53,7 +53,7 @@ class Mustache_Engine
      *         'template_class_prefix' => '__MyTemplates_',
      *
      *         // A Mustache cache instance or a cache directory string for compiled templates.
-     *         // Mustache will not cache templates unless this is set
+     *         // Mustache will not cache templates unless this is set.
      *         'cache' => dirname(__FILE__).'/tmp/cache/mustache',
      *
      *         // Override default permissions for cache files. Defaults to using the system-defined umask. It is

src/Mustache/Logger.php

@@ -45,6 +45,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function emergency($message, array $context = array());
@@ -57,6 +58,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function alert($message, array $context = array());
@@ -68,6 +70,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function critical($message, array $context = array());
@@ -78,6 +81,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function error($message, array $context = array());
@@ -90,6 +94,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function warning($message, array $context = array());
@@ -99,6 +104,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function notice($message, array $context = array());
@@ -110,6 +116,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function info($message, array $context = array());
@@ -119,6 +126,7 @@ interface Mustache_Logger
      *
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function debug($message, array $context = array());
@@ -129,6 +137,7 @@ interface Mustache_Logger
      * @param mixed  $level
      * @param string $message
      * @param array  $context
+     *
      * @return null
      */
     public function log($level, $message, array $context = array());

test/Mustache/Test/FiveThree/Functional/PartialLambdaIndentTest.php

@@ -42,7 +42,6 @@ EOS;
 
         $tpl = $m->loadTemplate($src);
 
-
         $data = new Mustache_Test_Functional_ClassWithLambda();
         $this->assertEquals($expected, $tpl->render($data));
     }

test/Mustache/Test/FiveThree/Functional/StrictCallablesTest.php

@@ -73,7 +73,6 @@ class Mustache_Test_FiveThree_Functional_StrictCallablesTest extends PHPUnit_Fra
         );
     }
 
-
     /**
      * @group wip
      * @dataProvider strictCallables