handling comments

A PGN file contains embedded comments (also called annotations), which are enclosed in braces in the PGN file.

CQL can search these and write its own user-specified comments. CQL also by default adds comments indicating positions where a filter matched, and some filter-specific comments.

Filters that handle comments are:

filter syntax example description
comment string comment "lost" write specified comment
comment set_filter comment attack (Q .) write squares in set associated with set_filter
hascomment string hascomment "cook" string argument is a substring of comment of current position
silent filter silent next (check check) suppress automatically generated comments associated with filter

Note: The silent keyword can also be specified as a CQL parameter in which case it suppresses all automatically generated comments. Specifying --silent as a command line option has the same effect.