Comando incorporado em PGN

PGN significa Portable Game Notation, um formato de texto para registrar partidas. Um comando incorporado em PGN acrescenta dados que programas podem interpretar sem deixar de ser compatível com leitores que entendem apenas comentários comuns. Ele aparece dentro de um comentário entre chaves regido pela sintaxe de comentários PGN. A forma geral começa com [%, continua com um nome de comando e seus parâmetros e termina com ].

Em {[%clk 1:05:23]}, clk é o nome do comando e 1:05:23 é seu parâmetro. O suplemento que documenta essa convenção propõe clk para registrar o tempo exibido no relógio após um lance. Ele também descreve vários outros comandos relacionados ao tempo.

A convenção vem de um suplemento cujo status é rascunho final, e não da especificação central original de PGN. O suplemento evita deliberadamente impor uma lista universal de todos os comandos possíveis. Por isso, a interoperabilidade depende de o produtor e o leitor atribuírem o mesmo significado ao nome do comando.

Um programa que não reconhece um comando deve preservá-lo sem alterações como parte do comentário. Isso o diferencia de um par de etiquetas PGN, que armazena dados descritivos na seção inicial da partida, e não dentro de um comentário associado aos lances.