misc phpdoc updates

Author: robocoder

src/Compiler.php

@@ -429,8 +429,10 @@ protected function flattenSelectors(OutputBlock $block, $parentKey = null)
     }
 
     /**
-     * glue parts of :not( or :nth-child( ... that are in general splitted in selectors parts
+     * Glue parts of :not( or :nth-child( ... that are in general splitted in selectors parts
+     *
      * @param array $parts
+     *
      * @return array
      */
     protected function glueFunctionSelectors($parts)
@@ -1044,7 +1046,7 @@ protected function filterWithout($envs, $without)
     /**
      * Filter WITH rules
      *
-     * @param integer              $without
+     * @param integer                                                   $without
      * @param \Leafo\ScssPhp\Block|\Leafo\ScssPhp\Formatter\OutputBlock $block
      *
      * @return boolean
@@ -1479,7 +1481,7 @@ protected function compileChildren($stms, OutputBlock $out)
      *
      * @param array                                $stms
      * @param \Leafo\ScssPhp\Formatter\OutputBlock $out
-     * @param \Leafo\ScssPhp\Block $selfParent
+     * @param \Leafo\ScssPhp\Block                 $selfParent
      *
      * @throws \Exception
      */
@@ -1611,6 +1613,14 @@ protected function compileMediaQuery($queryList)
         return $out;
     }
 
+    /**
+     * Merge direct relationships between selectors
+     *
+     * @param array $selectors1
+     * @param array $selectors2
+     *
+     * @return array
+     */
     protected function mergeDirectRelationships($selectors1, $selectors2)
     {
         if (empty($selectors1) || empty($selectors2)) {
@@ -1711,9 +1721,9 @@ protected function mergeMediaTypes($type1, $type2)
     /**
      * Compile import; returns true if the value was something that could be imported
      *
-     * @param array         $rawPath
-     * @param OutputBlock   $out
-     * @param boolean       $once
+     * @param array                                $rawPath
+     * @param \Leafo\ScssPhp\Formatter\OutputBlock $out
+     * @param boolean                              $once
      *
      * @return boolean
      */
@@ -3142,7 +3152,7 @@ protected function extractInterpolation($list)
      * Find the final set of selectors
      *
      * @param \Leafo\ScssPhp\Compiler\Environment $env
-     * @param Leafo\ScssPhp\Block $selfParent
+     * @param \Leafo\ScssPhp\Block                $selfParent
      *
      * @return array
      */
@@ -3736,8 +3746,8 @@ public function addFeature($name)
     /**
      * Import file
      *
-     * @param OutputBlock $path
-     * @param array       $out
+     * @param string                               $path
+     * @param \Leafo\ScssPhp\Formatter\OutputBlock $out
      */
     protected function importFile($path, OutputBlock $out)
     {

src/Parser.php

@@ -1265,9 +1265,9 @@ protected function expression(&$out)
     /**
      * Parse expression specifically checking for lists in parenthesis or brackets
      *
-     * @param array $out
+     * @param array   $out
      * @param integer $s
-     * @param string $closingParen
+     * @param string  $closingParen
      *
      * @return boolean
      */
@@ -1540,7 +1540,7 @@ protected function progid(&$out)
      * Parse function call
      *
      * @param string $name
-     * @param array $func
+     * @param array  $func
      *
      * @return boolean
      */

src/SourceMap/SourceMapGenerator.php

@@ -110,11 +110,11 @@ public function __construct(array $options = [])
     public function addMapping($generatedLine, $generatedColumn, $originalLine, $originalColumn, $sourceFile)
     {
         $this->mappings[] = [
-            'generated_line' => $generatedLine,
+            'generated_line'   => $generatedLine,
             'generated_column' => $generatedColumn,
-            'original_line' => $originalLine,
-            'original_column' => $originalColumn,
-            'source_file' => $sourceFile
+            'original_line'    => $originalLine,
+            'original_column'  => $originalColumn,
+            'source_file'      => $sourceFile
         ];
 
         $this->sources[$sourceFile] = $sourceFile;
@@ -125,6 +125,8 @@ public function addMapping($generatedLine, $generatedColumn, $originalLine, $ori
      *
      * @param string $content The content to write
      *
+     * @return string
+     *
      * @throws \Leafo\ScssPhp\Exception\CompilerException If the file could not be saved
      */
     public function saveMap($content)
@@ -295,6 +297,13 @@ protected function findFileIndex($filename)
         return $this->source_keys[$filename];
     }
 
+    /**
+     * Normalize filename
+     *
+     * @param string $filename
+     *
+     * @return string
+     */
     protected function normalizeFilename($filename)
     {
         $filename = $this->fixWindowsPath($filename);