Changes

   1 *** INCOMPATIBLE CHANGES:
   2 * SQLT no longer supports setting separate conflicting values for the now
   3   deprecated 'quote_table_names' and 'quote_field_names'. Instead their values
   4   are proxied to the new 'quote_identifiers'. If 'quote_identifiers' is
   5   supplied, the legacy settings are ignored (with a warning). If nothing is
   6   specified the default is TRUE as before. If only one is specified - default
   7   to its value for everything, and if both are specified with a conflicting
   8   value an exception is thrown.
   9
  10 * Fixes to SQLite foreign keys production (patch from Johan Viklund)
  11   closes RT#16412, RT#44769
  12 * ON DELETE/UPDATE actions for SQLite (patch from Lukas Thiemeier)
  13   closes RT#70734, RT#71283, RT#70378
  14 * Proper quoting support in SQLite
  15 * Fix data preservation on SQLite diffs involving adding/dropping columns
  16 * Support for triggers in PostgreSQL producer and parser
  17 * Correct Data Type in SQLT::Parser::DBI::PostgreSQL (patch from Andrew Pam)
  18 * Fix index issue in SQLT::Parser::DBI::PostgreSQL
  19 * Add column and table comments in SQLT::Parser::DBI::PostgreSQL(patch from Andrew Pam)
  20 * Fixed alter_drop_constraint for foreign keys and applying multiple changes
  21   via alter_field to a column in Postgres Producer
  22 * Added a working mechanism for naming foreign keys in the PostgreSQL producer
  23 * Fix PostgreSQL ignoring default values with specified data type
  24 * Fix possible name duplication in SQLlite producer
  25 * Oracle does not accept ON DELETE/UPDATE RESTRICT (though it is the actual default)
  26   fix by not adding the ON DELETE/UPDATE clause at all
  27 * Changed dependency on Digest::SHA1 to the core-bundled Digest::SHA (RT#67989)
  28 * Support for double quoted and bit strings as default values in MySQL parser
  29 * Proper handling of CURRENT_TIMESTAMP default values in MySQL parser (RT#65844)
  30 * Check in MySQL parser to avoid trying to parse a table defined twice in the same
  31   file as indices (and probably other things) get messed up
  32 * Workaround for some MySQL quirks on primary key definitions
  33 * Fix dropping primary keys in MySQL diffs (RT#62250, patch from Nick Bertrand)
  34 * MySQL producer does not attempt to write out non-existent unique constraint names
  35 * MySQL parser correctly differentiates between signed and unsigned integer column
  36   display sizes
  37 * Replace Class::Accessor::Fast dependency with already-included Moo
  38 * Entire codebase is now free of tabs and trailing whitespace
  39 * Spellfixes (RT#68912)
  40 * Fix Diagram Producer POD (RT#71397, RT#71398)
  41 * Fix Diagram Producer to use correct binmode on output (RT#71399)
  42 * Fix ignored option to script/sqlt-diagram (RT#5992)
  43 * Fix t/17sqlfxml-producer.t failures due to whitespace differences introduced by
  44   environment config snippets (RT#70786)
  45 * Deprecate SQL::Translator::Schema::Graph and the as_graph() schema method
  46
  47 # ----------------------------------------------------------
  48 # 0.11010 2011-10-05
  49 # ----------------------------------------------------------
  50
  51 * Add "if exists" to drop view statements in Pg.
  52
  53 # ----------------------------------------------------------
  54 # 0.11009 2011-09-02
  55 # ----------------------------------------------------------
  56
  57 * Fix MySQL producer to properly quote all table names on output (patch from geistteufel)
  58
  59 # ----------------------------------------------------------
  60 # 0.11008 2011-05-04
  61 # ----------------------------------------------------------
  62
  63 * Correctly create and parse FK constraints in SQLite
  64 * Correct postgis geography type insertion and linebreak fix for multiple geometry/geography columns
  65 * made PostgreSQL producer consistent with other producers in terms of
  66   quoting and allowing functions in constraints and indices
  67 * Add distinction of autoinc and regular primary keys to the GraphViz producer
  68 * Fix odd invocation of Test::More::pass() in t/36-filters.t (RT#64728)
  69 * Quote everything in SQL Server
  70 * Turn off constraints before dropping tables in SQL Server
  71 * Make true unique constraints if needed in SQL Server
  72 * Fixed Producer::PostgresSQL to output array type after type size,
  73   i.e. varchar(64)[] rather than varchar[](64)
  74
  75 # ----------------------------------------------------------
  76 # 0.11007 2010-11-30
  77 # ----------------------------------------------------------
  78
  79 * Fix POD typo in SQL/Translator/Schema/Trigger.pm
  80 * Add explicit Scalar::Util to the deplist for really old perls
  81 * Add support for PostGIS Geometry and Geography data types in the Pg producer
  82 * Some minor fixes to squash warnings on new perls
  83 * Support a custom_type_name hint when creating enum types in PostgreSQL
  84 * Fix sqlt options/pod mismatch (RT#58318)
  85 * Oracle Producer multicolumn constraint support
  86 * Add support for triggers in the MySQL producer
  87 * Fix unstable order of View's in MySQL parser
  88
  89 # ----------------------------------------------------------
  90 # 0.11006 2010-06-03
  91 # ----------------------------------------------------------
  92 * Fix Producer::Oracle varchar2 without size def (ORA-00906: missing right
  93   parenthesis)
  94 * Fix Producer::Oracle translate float and double to float instead of number
  95 * Fix Producer::Oracle generation of too long unique constraint names
  96 * Fix Producer::SQLite when generating VIEWs with add_drop_table => 1
  97 * Fix Producer::MySQL not quoting index names when requested (RT#56173)
  98 * Fix Producer::MySQL wrapping extra ()s around VIEW SELECT-ors (RT#56419)
  99 * Fix Field::default_value to behave like a real accessor (allow undef as
 100   an unsetting argument)
 101 * Fix Mysql/Pg/SQLite/MSSQL producers to properly *not* quote numeric default
 102   values (RT#57059)
 103 * Producer::Oracle tests now use Test::Differences
 104 * Prettify output of SQLite producer (less bogus newlines)
 105 * Augment SQLite and Pg producers to accept a perl-formatted (%d.%03d%03d)
 106   and regular no-leading-zero (X.X.X) *_version producer args
 107
 108 # ----------------------------------------------------------
 109 # 0.11005 2010-02-24
 110 # ----------------------------------------------------------
 111 * Fix Parser::DBI::Oracle reading too many tables (RT#49413)
 112 * Fix Parser::MySQL tripping up on PRIMARY KEY ... USING (currently value is ignored) (RT#50468)
 113 * Fix runaway debug trace (RT#52276)
 114 * Fix Parser::PostgreSQL choking on commit; statements in DDL (#RT52277)
 115 * Producer::Oracle now respects quote_field|table_names, and
 116   no longer does name munging of reserved table names
 117 * Producer::Oracle now correctly outputs databse-unique index names
 118
 119 # ----------------------------------------------------------
 120 # 0.11004 2010-02-14
 121 # ----------------------------------------------------------
 122 * Fix PG producer numeric precision regression (RT#49301)
 123 * Add DB2 producer numeric/decimal precision output
 124 * Fix Oracle producer creating numeric precision statements that the test case expects (no whitespace)
 125 * Add Oracle producer creating drop view statements like PG producer does
 126 * Fix SQL::Translator::Diff to use producer_args instead of producer_options
 127
 128 # ----------------------------------------------------------
 129 # 0.11003 2009-09-28
 130 # ----------------------------------------------------------
 131 * Pg parser fixes to deal properly with MATCH <type>
 132 * Pg parser fixes to parse timestamp attributes correctly
 133 * Fix broken default detection in script/sqlt (RT#27438)
 134 * Fix dependency issues with LibXML and TT
 135
 136 # ----------------------------------------------------------
 137 # 0.11002 2009-08-30
 138 # ----------------------------------------------------------
 139 * Depend on fixed Parse::RecDescent
 140 * Added skip-tables and skip-tables-like options to Diagram
 141
 142 # ----------------------------------------------------------
 143 # 0.11001 2009-08-18
 144 # ----------------------------------------------------------
 145 * Removed last use of Readonly
 146 * Adjusted YAML dependency
 147
 148 # ----------------------------------------------------------
 149 # 0.11000 2009-08-18
 150 # ----------------------------------------------------------
 151 * Re-add version numbers to files, else cpan's "upgrade" gets very confused
 152 * Replaced code using Readonly, since most of the rest uses constant, and thats already a dep
 153 * Moved YAML and XML::LibXML back to recommends, the tests for both now skip if not installed
 154 * Bumped to 0.11000 to supercede 0.10 which has incorrect numbering scheme
 155
 156 # ----------------------------------------------------------
 157 # 0.10 2009-08-13
 158 # ----------------------------------------------------------
 159 * Resolved the following RT bugs (thanks to everyone for reporting!):
 160 25791   does not recognize PostgreSQL ON_ERROR_STOP
 161 29265   sqlt-diagram: --natural-join needs Graph::Directed
 162 37814   SQLite translator failing to parse schema
 163 42548   Producer::PostgreSQL incorrectly inserts the size in
 164         'time(stamp)? with(out) time zone' fields
 165 43173   SQL::Translator::Parser without versionnumber - will install
 166         old 0.09002
 167 46805   (No subject)
 168 47026   META.yml is not packaged due to MANIFEST.SKIP (easyfix)
 169 32130   Move from XML::XPath to XML::LibXML::XPathContext
 170 22261   MySQL parse
 171 13915   missing optional prerequisite cause make test to fail
 172 8847    Diagram.pm: BINMODE missing in printing of graphic file.
 173 21065   GraphViz producer fails on tables named 'node'
 174 35448   Producer::PostgreSQL types without size
 175 22026   sqlt-diagram uses -f arg twice
 176 47897   [PATCH] Fix uninitialized value within @_ in (uc|lc)
 177 47668   Mysql Parser doesn't recognize key types
 178 46448   sqlt-graph errors out on MySQL DDL with btree keys
 179 47176   Add Foreign Key support to Parser::DBI::PostgreSQL.pm
 180 48025   MySQL Producer: Case inconsistency between elements in
 181         @no_length_attr and $data_type
 182 48569   sqlt-diagram fails to load SQLite schema
 183 48596   SQL::Translator::Diff::schema_diff should produce a list in
 184         list context
 185 44907   SQL::Translator::Producer::PostgreSQL produce() in list context
 186         should return a list of statements
 187
 188 # ----------------------------------------------------------
 189 # 0.09007 2009-06-25
 190 # ----------------------------------------------------------
 191 * Fixed Pg parser - caching the compiled P::RD schema is a *very*
 192   bad idea
 193 * Fix MSSQL handling of ON UPDATE/DELETE RESTRICT
 194 * Delay MSSQL FK constraint deployment until after all CREATE TABLE
 195   statements
 196 * Coerce other engine's bytea/blob/clob datatypes to VarBinary
 197
 198 # ----------------------------------------------------------
 199 # 0.09006 2009-06-10
 200 # ----------------------------------------------------------
 201 * Multiple test and dependency adhustments to make smokers happy
 202 * Fix YAML producer wrt extra attribute
 203 * Added support for "time(stamp) (p) with time zone" for Pg producer (mo)
 204
 205 # ----------------------------------------------------------
 206 # 0.09005 2009-06-08
 207 # ----------------------------------------------------------
 208 * Add parser support for MySQL default values with a single quote
 209 * Properly quote absolute table names in the MySQL producer
 210 * Added CREATE VIEW subrules for mysql parser (wreis)
 211 * Many fixes to code and tests for trigger's "database_events"
 212 * Added semi-colon for (DROP|CREATE) TYPE statements in the Pg producer (wreis)
 213 * ALTER TABLE/ALTER COLUMN/DROP DEFAULT support in Pg producer (mo)
 214 * XML parser support for multi-event triggers
 215 * SQLite producer support for multi-event triggers
 216 * XML parser switched from XML::XPath to XML::LibXML
 217 * Pg producer ALTER TABLE/COLUMN and DROP DEFAULT support
 218 * MySQL producer skips length attribute for columns which do not support that
 219   attribute. Currently following column types are added to that list:
 220   date time timestamp datetime year
 221 * Switch to Module::Install (mandates minimum perl 5.005)
 222 * Major cleanup of GraphViz proucer
 223 * Massive amount of fixes to SQLite/Pg/Mysql/MSSQL parsers/producers
 224   Fix most of the problems uncovered by the roundtrip test framework
 225   Some highlights:
 226     - Rewind exhausted globs before attempting a read
 227     - Do not add xml comment header if no_comments is set
 228     - table/field counts are held per schema object, not globally
 229     - no more variable table and column names in SQLite and MSSQL
 230     - VIEW support for Pg parser, also some cleanups
 231     - The way we generate Pg create view statements was not standards compliant
 232       (per RhodiumToad in #postgresql)
 233     - Disable MSSQL view/procedure production - they never worked in the first place
 234     - SQLite/MSSQL improvements:
 235       - Support parsing of all DROP clauses
 236       - Support parsing of field-level comments
 237       - When producing do not append table names to constraint/index names
 238
 239 # ----------------------------------------------------------
 240 # 0.09004 2009-02-13
 241 # ----------------------------------------------------------
 242 * Add support for temporary tables in Pg (nachos)
 243 * Create Trigger support for SQLite
 244 * GraphViz producer improvements
 245
 246 # ----------------------------------------------------------
 247 # 0.09003 2009-02-07
 248 # ----------------------------------------------------------
 249   <BORKED RELEASE DELETED OFF CPAN>
 250
 251 # ----------------------------------------------------------
 252 # 0.09002 2008-12-05
 253 # ----------------------------------------------------------
 254 * parsing MySQL CURRENT_TIMESTAMP as scalar ref so it can be produced without
 255   quotes (jgoulah)
 256 * Add ignore_opts parser arg (to ignore table options) in Parser::MySQL (jgoulah)
 257 * Skip tests for buggy Spreadsheet::ParseExcel versions (rbo)
 258 * Add support for skip tables parser arg in Parser::DBI::MySQL (jgoulah)
 259 * Changed behaviour of ::Producer::Oracle when returning an array of statements
 260   to make it compatible to DBI->do()
 261 * Fixed a few bugs in ::Producer::Oracle
 262 * Applied patch from jgoulah to support mysql's MERGE option
 263 * Applied patch from rbo to add support of multiple database events on a trigger
 264 * Applied patch from lukes to allow drop if exists in sqlite producer, with
 265   version >= 3.3
 266 * Applied patch from rjbs with minor changes, now we support scalar refs in
 267   default values!
 268 * Fixed SQLite producer to end index statements in newlines, in scalar context
 269 * Decreed that all list context statements shall not end in ; or ;\n
 270 * Fixed SQLite, Diff and MySQL producers to agree with Decree.
 271 * Added support for CREATE VIEW + tests in the Pg producer (wreis)
 272 * Added support for CREATE VIEW + tests in the sqlite producer (groditi)
 273 * Added proper argument parsing and documentation to MySQL Parser and
 274   Producer (ribasushi)
 275 * Using DROP VIEW instead of OR REPLACE clause in the Pg producer, as replace
 276   only allows replacement with identical set of columns (wreis)
 277 * Added support for DROP VIEW and fixed CREATE VIEW statement in the sqlite
 278   producer (wreis)
 279 * Removed source_db and target_db accessors from Diff (throwback to old version,
 280   only output_db is used)
 281
 282
 283 * Support for longer varchar fields in MySQL
 284
 285 # ----------------------------------------------------------
 286 # 0.09001 2008-08-19
 287 # ----------------------------------------------------------
 288 * Added support for CREATE VIEW + tests in the mysql producer (groditi)
 289 * Added support for SET fields in the mysql producer + test (groditi)
 290 * Added support for proper booleans in the mysql producer, when a mysql version
 291   of at least 4.x is supplied
 292 * Added support for proper enums under pg (as of 8.3), with pg version check,
 293   and deferrable constraints
 294 * Added support to truncate long constraint and index names in the mysql
 295   producer, because of a change to DBIx::Class to produce such long names in
 296   some cases.
 297
 298 # ----------------------------------------------------------
 299 # 0.09000 2008-02-25
 300 # ----------------------------------------------------------
 301
 302 * Fix Pg produces idea of which field types need a size param (wreis)
 303 * Add support for COLLATE table option to MySQL parser
 304 * Allow DEFAULT CHARACTER SET without '=' (as produced by mysqldump)
 305
 306 # -----------------------------------------------------------
 307 # 0.0899_02 2008-01-29
 308 # ----------------------------------------------------------
 309
 310 * Major refactoring of SQL::Translator::Diff again:
 311 * Diff is no longer one huge monolithic function.
 312 * Added more tests for diff
 313 * When producing diffs for MySQL you will (by default) get single alter
 314   statements per table
 315 * SQLite can also do remove columns (by creating a temp table as shown in
 316   http://sqlite.org/faq.html#q11
 317 * Columns can be renamed if the new schema is from a form that can have metadata
 318   (which is pretty much anything but an SQL file.) It does this by looking at
 319   renamed_from in the $field->extra
 320 * Updated Oracle and Postgres producers
 321 * More tests!
 322
 323 # -----------------------------------------------------------
 324 # 0.0899_01 2007-10-21
 325 # ----------------------------------------------------------
 326
 327 * SQL::Translator::Diff now uses the ::Producer modules to create diffs
 328   This *will* break back-compatibility
 329   Use sqlt-diff-old for the previous one, and fix producers!
 330
 331 # -----------------------------------------------------------
 332 # 0.08001 2007-09-26
 333 # ----------------------------------------------------------
 334
 335 * Patched to ignore all TT versions >= 2.15 until TT is fixed :(
 336
 337 # -----------------------------------------------------------
 338 # 0.08 2006-12-07
 339 # -----------------------------------------------------------
 340
 341 * Patched 18ttschema-producer.t and 33tt-table-producter.t to skip on TT 2.15,
 342   thanks Ash!
 343
 344 # -----------------------------------------------------------
 345 # 0.08_04 2006-11-10
 346 # -----------------------------------------------------------
 347
 348 * Patched MySQL producer to name constraints sanely, thanks Ash
 349 * Added patch to Producer::DB2 to avoid dependency issues with foreign keys
 350 * Added patch to remove single quotes for numeric default values in Producer::DB2
 351 * Fixed Parser::SQLite to require a semicolon after a create trigger statement
 352 * Added patch from avinash to add CASCADE to pg table drops
 353
 354 # -----------------------------------------------------------
 355 # 0.08_03
 356 # -----------------------------------------------------------
 357
 358 * Added patch to use default values for Pg timestamp fields
 359
 360 # -----------------------------------------------------------
 361 # 0.08_02    2006-11-03
 362 # -----------------------------------------------------------
 363
 364 * Added patch from Ash to separate DROP statements in mysql producer in
 365   list-context
 366 * Fixed up SQLites usage of no-comments
 367
 368 # -----------------------------------------------------------
 369 # 0.08_01    2006-07-23
 370 # -----------------------------------------------------------
 371
 372 * Made Trigger check that a give table exists in on_table - castaway
 373 * Split some producers (DB2, MySQL, SQLite, PostgreSQL) into sub methods (others
 374   to follow) - castaway
 375 * Add alter_* methods to some Producers and docs to Producer.pm (for use by Diff
 376   later) - castaway
 377 * Made changes to allow producers to return a list of statements - castaway
 378 * Split sqlt-diff into script and module - castaway
 379 * Added quote_table_names and quote_field_names patch (omega, zamolxes) - castaway
 380 * Added DB2 Producer - castaway
 381 * Added mysql_character_set for 4.1+ -mda
 382 * New filters, Names and Globals. -mda
 383 * Added the initial work on a template based Dia UML producer. -mda
 384
 385 # -----------------------------------------------------------
 386 # 0.07    2005-06-10
 387 # -----------------------------------------------------------
 388 *   YAML parser supports extra attributes on tables.
 389
 390 *   All schema objects now support the extra attribute, so can
 391     have arbitary name/value data attached to them.
 392
 393 *   Refactoring: Added SQL::Translator::Schema::Object - base
 394     class for all Schema objects.
 395
 396 *   Changes to MySQL Parser (Dave Howorth)
 397     - ignore INSERT statements
 398     - permit ALTER TABLE ADD FOREIGN KEY
 399     - allow trailing comma on last field in CREATE statements
 400     - collect the database name
 401
 402 *   TTSchema Producer
 403     - Can pass extra variables using tt_vars producer arg.
 404     - Can pass extra config using tt_conf producer arg.
 405     - Variables and config can be passed on the command line
 406       with --tt-var and --tt-conf options to sqlt.
 407
 408 *   Added schema filters.
 409
 410 *   MySQL Producer
 411     - Added 'mysql_table_type' extra attribute on tables.
 412     - Works out InnoDB tables from constraints.
 413     - mysql_charset and mysql_collate extra attributes for tables and fiels.
 414
 415
 416 # -----------------------------------------------------------
 417 # 0.06    2004-05-13
 418 # -----------------------------------------------------------
 419 *   Added SQL::Translator::Manual
 420
 421 *   Installation process now uses Module::Build
 422
 423 *   Added new "Dumper" producer
 424
 425 *   Changed the native SQL Fairy XML format to a fixed mapping.
 426     *NB:* You should convert your existing XML schema. See the
 427     SQL::Translator::Parser::XML::SQLFairy docs.
 428
 429 *   Added producers: TT::Base and TT::Table.
 430
 431 # -----------------------------------------------------------
 432 # 0.05    2004-02-27
 433 # -----------------------------------------------------------
 434 *   Added "COMMENT ON *" syntax to PostgreSQL parser
 435
 436 *   Some fixes to Oracle parser as reported by Gail Binkley
 437
 438 *   Added support in PostgreSQL parser for all "ALTER TABLE" statements
 439
 440 *   Now distributing sqlt-diff script as it's pretty usable
 441
 442 *   Added new options to sqlt-graph and GraphViz producer (Dave Cash)
 443
 444 # -----------------------------------------------------------
 445 # 0.04    2003-11-07
 446 # -----------------------------------------------------------
 447
 448 *   Increased version of Constants module to 1.41 to avoid a problem
 449     where 0.02 has 1.4 of that file and 0.03 had 1.06 which confused
 450     CPAN
 451
 452 *   Hard-coded all the PREREQ_PM modules in Makefile.PL (rather than
 453     setting them dynamically) so that automated tests would pass
 454
 455 # -----------------------------------------------------------
 456 # 0.03    2003-11-06
 457 # -----------------------------------------------------------
 458
 459 *   Added parsers: XML::SQLFairy, Sybase, SQLite, DBI-MySQL,
 460     DBI-PostgreSQL, DBI-SQLite, DBI-Sybase, Storable, YAML
 461
 462 *   Added producers: XML::SQLFairy, TTSchema, Storable, YAML
 463
 464 *   HTML producer now uses stylesheets to allow easy customization of colors
 465
 466 *   Many bug fixes to most every module
 467
 468 *   Added "sqlt-dumper" script to help create a script for dumping
 469     a database a la "mysqldump"
 470
 471 *   Reversed the arrowheads on the graphical producers to show the
 472     relationships in a more standard way
 473
 474 *   Changes all included script names to start with "sqlt"
 475
 476 *   Added capturing and printing most embedded table and field comments
 477
 478 # -----------------------------------------------------------
 479 # 0.02    2003-06-17
 480 # -----------------------------------------------------------
 481
 482 *   Added parsers for Excel and Oracle
 483
 484 *   Removed Sybase parser because it didn't actually work
 485
 486 *   Added ClassDBI, Diagram, GraphViz, HTML, POD, SQLite, Sybase producers
 487
 488 *   Added Schema classes to represent schema as objects
 489
 490 *   Removed "Raw" producer in favor of the Schema classes
 491
 492 *   Removed "Validator" class as the Schema classes validate themselves
 493
 494 *   Improved all existing parsers and producers, expanding them to
 495     handle foreign keys much better, produce better output, etc.
 496
 497 *   Added sqlt-diagram.pl and sqlt-graphviz.pl as CLI frontends to the
 498     graphical producers
 499
 500 *   Added sql_translator.cgi as a web-form frontend to graphical producers
 501
 502 *   Expanded test suite
 503
 504 # -----------------------------------------------------------
 505 # 0.01    2003-02-27
 506 # -----------------------------------------------------------
 507
 508 *   Added parsers: XML::SQLFairy, Sybase, SQLite, DBI-MySQL,
 509     DBI-PostgreSQL, DBI-SQLite, DBI-Sybase, Storable, YAML
 510
 511 *   Added producers: XML::SQLFairy, TTSchema, Storable, YAML
 512
 513 *   HTML producer now uses stylesheets to allow easy customization of colors
 514
 515 *   Many bug fixes to most every module
 516
 517 *   Added "sqlt-dumper" script to help create a script for dumping
 518     a database a la "mysqldump"
 519
 520 *   Reversed the arrowheads on the graphical producers to show the
 521     relationships in a more standard way
 522
 523 *   Changes all included script names to start with "sqlt"
 524
 525 *   Added capturing and printing most embedded table and field comments