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