Update comment

Author: kitloong

src/Database/Models/DatabaseTable.php

@@ -61,8 +61,8 @@ abstract protected function makeIndex(string $table, array $index): Index;
      * Create a new instance.
      *
      * @param  SchemaTable  $table
-     * @param  \Illuminate\Support\Collection<int, SchemaColumn>  $columns  Key is quoted name.
-     * @param  \Illuminate\Support\Collection<int, SchemaIndex>  $indexes  Key is name.
+     * @param  \Illuminate\Support\Collection<int, SchemaColumn>  $columns
+     * @param  \Illuminate\Support\Collection<int, SchemaIndex>  $indexes
      * @param  \Illuminate\Support\Collection<int, string>  $userDefinedTypes
      */
     public function __construct(array $table, Collection $columns, Collection $indexes, Collection $userDefinedTypes)

src/Database/Models/PgSQL/PgSQLUDTColumn.php

@@ -23,6 +23,8 @@ public function __construct(string $table, array $column)
         parent::__construct($table, $column);
 
         $blueprint = new Blueprint($this->stripTablePrefix($table));
+
+        // Generate the add column statement with string column type.
         $blueprint->addColumn('string', $column['name'], [
             'autoIncrement' => $column['auto_increment'],
             'collation'     => $column['collation'],
@@ -31,7 +33,9 @@ public function __construct(string $table, array $column)
             'nullable'      => $column['nullable'],
         ]);
 
-        $sqls    = $blueprint->toSql(Schema::getConnection(), Schema::getConnection()->getSchemaGrammar());
+        $sqls = $blueprint->toSql(Schema::getConnection(), Schema::getConnection()->getSchemaGrammar());
+
+        // Replace the string column type with the user-defined type.
         $sqls[0] = Str::replaceFirst(' varchar ', ' ' . $column['type'] . ' ', $sqls[0]);
 
         $this->sqls = $sqls;

src/Database/Models/SQLSrv/SQLSrvUDTColumn.php

@@ -22,13 +22,17 @@ public function __construct(string $table, array $column)
         parent::__construct($table, $column);
 
         $blueprint = new Blueprint($this->stripTablePrefix($table));
+
+        // Generate the add column statement with string column type.
         $blueprint->addColumn('string', $column['name'], [
             'autoIncrement' => $column['auto_increment'],
             'default'       => $this->parseDefault($column['default']),
             'nullable'      => $column['nullable'],
         ]);
 
-        $sqls    = $blueprint->toSql(Schema::getConnection(), Schema::getConnection()->getSchemaGrammar());
+        $sqls = $blueprint->toSql(Schema::getConnection(), Schema::getConnection()->getSchemaGrammar());
+
+        // Replace the string column type with the user-defined type.
         $sqls[0] = Str::replaceFirst(' nvarchar() ', ' ' . $column['type'] . ' ', $sqls[0]);
 
         $this->sqls = $sqls;

tests/resources/database/migrations/general/2020_03_21_000000_expected_create_all_columns_table.php

@@ -212,10 +212,12 @@ public function up()
                     "ALTER TABLE ".DB::getTablePrefix()."all_columns ADD COLUMN timestamp_defaultnow timestamp(0) without time zone DEFAULT now() NOT NULL",
                 );
 
+                // Test user defined type column.
                 DB::statement(
                     "ALTER TABLE ".DB::getTablePrefix()."all_columns ADD COLUMN status my_status NOT NULL DEFAULT 'PENDING'",
                 );
 
+                // Add a comment so the alter statement will return 2 statements.
                 DB::statement(
                     "COMMENT ON column ".DB::getTablePrefix()."all_columns.status IS 'comment a'",
                 );
@@ -226,6 +228,7 @@ public function up()
                 break;
 
             case Driver::SQLSRV->value:
+                // Test user defined type column.
                 DB::statement(
                     "ALTER TABLE ".DB::getTablePrefix()."all_columns ADD accountnumber accountnumber NOT NULL DEFAULT '1008'",
                 );