Add Settings.parseRetainCommentsBetweenQueries

[lukaseder]

When the parser is used to translate SQL scripts (e.g. via the ParserCLI or website), it is often desirable to not touch any comments that may be used to describe parts of the script, e.g.

-- ==========================================
-- header
-- created 2000-01-01
-- ==========================================

-- Change Request #14813
-- ------------------------------------------
CREATE TABLE x123 (i int);
CREATE TABLE x456 (j int);
-- Special table
CREATE TABLE x789 (k int);

-- Change Request #153819
-- ------------------------------------------
ALTER TABLE x789 ADD x int;

All the whitespace and comments that are located in between statements could be parsed and retained by jOOQ's parser. For now, it would still be difficult to retain comments within a statement as our query object model doesn't allow for representing arbitrary whitespace and comments, but on the top level, that could work.

[lukaseder]

The feature works, now for some whitespace management