comment filter

The comment filter gives the ability to insert comments into games. However, there are few formatting options and presentation is primitive. This feature is mainly intended for debugging CQL scripts, rather than for presentation.

There are two forms of comments, with a quoted string and with a set filter:

    'comment' quoted-string
    'comment' set-filter

These output the quoted string and the squares in the set filter respectively. For example,

J. Lucena
Repeticion de Amores & Arte de Axedrez#103 (c)

1. Qe6+ Kh8 2. Nf7+ Kg8 3. Nh6+ Kh8 4. Qg8+ Rxg8 5. Nf7#

The above is the oldest study matching:

comment "Smothered mate"

It is also possible to output specific squares:

    comment "The rooks are attacking these squares"
    comment attack ([Rr] any)
would output the squares attacked by any rook.

An example of the use of comment is illustrated in the file excelsior-comment.cql, which outputs the squares on which excelsiors were found.

As a filter, comment always returns true.

Unlike all other comments added by CQL, comments added by the comment filter are not suppressed by the silent keyword..