Merge pull request #49 from DimaNagorniy/aud-75

AUD-75: Improve comments of DiffTableRowHelper

Author: prwater

src/MySql/Helper/DiffTableRowHelper.php

@@ -12,7 +12,7 @@ class DiffTableRowHelper
 {
   //--------------------------------------------------------------------------------------------------------------------
   /**
-   * Append a row.
+   * Append a row to existing rows array.
    *
    * @param \array[]                  $theExistRows Exist rows array for appending.
    * @param MultiSourceColumnMetadata $rowMetadata  Row for append.
@@ -31,7 +31,7 @@ public static function appendRow(&$theExistRows, $rowMetadata, $columnName)
 
   //--------------------------------------------------------------------------------------------------------------------
   /**
-   * Create table row.
+   * Create additional row for column with character set name and collation name.
    *
    * @param MultiSourceColumnMetadata $rowMetadata Data for table row.
    *
@@ -61,7 +61,7 @@ public static function createColumnOptionsRow($rowMetadata)
 
   //--------------------------------------------------------------------------------------------------------------------
   /**
-   * Create table row.
+   * Create table row for columns with information from all schemas and config file.
    *
    * @param MultiSourceColumnMetadata $rowMetadata Data for table row.
    * @param string                    $columnName  The columns name.
@@ -83,10 +83,10 @@ public static function createTableRow($rowMetadata, $columnName)
 
   //--------------------------------------------------------------------------------------------------------------------
   /**
-   * Create table row.
+   * Helper function for creating string with character set name and collation name.
    *
-   * @param $theCharacterSetName
-   * @param $theCollationName
+   * @param string $theCharacterSetName Character set name
+   * @param string $theCollationName    Collation name
    *
    * @return string
    */