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.