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