Root and Game Info Properties
FF[5] will have some substantial changes to game info properties.
Note: Updates to HA, EV, and others will follow.
Property: CA
Propvalue: (simpletext | composed simpletext ":" simpletext)
Propertytype: root
Function: Provides the used charset and (optional) its encoding
for SimpleText and Text type. The first part is the name of
the charset. Default value is 'ISO-8859-1' aka 'Latin1'.
The second optional name is the type of encoding used.
Default value is none.
Only charset names (or their aliases) as specified in RFC 1345
(or updates thereof) are allowed.
Basically this field uses the same names as MIME messages in
their 'charset=' field (in Content-Type).
RFC's can be obtained via FTP from DS.INTERNIC.NET, NIS.NSF.NET,
WUARCHIVE.WUSTL.EDU, SRC.DOC.IC.AC.UK or FTP.IMAG.FR.
Property: BR (same for WR)
Propvalue: simpletext
Propertytype: game-info
Function: Provides the rank of the black player.
For Go (GM[1]) the following format is recommended:
"..k" or "..kyu" for kyu ranks and
"..d" or "..dan" for dan ranks.
Go servers may want to add '?' for an uncertain rating and
'*' for an established rating. Furthermore, a string might
be added to describe the rating in more detail.
Examples:
BR[9 dan] BR[4d*, IGS]
BR[3 kyu, AGA] BR[9 dan, Judan, Gosei]
Property: DT
Propvalue: (simpletext | composed simpletext ":" simpletext)
Propertytype: game-info
Function: Provides the date when the game was played.
The first field gives the date in ISO format (Gregorian
calender), the second (optional) value can be used for
additional information, or to store dates which don't fit into
the Gregorian scheme, e.g. ancient dates given as era years.
It is MANDATORY to use the ISO-standard format for the first
value. ISO format implies usage of the Gregorian calender.
If the ISO date can't be specified it should be left empty.
Syntax:
"YYYY-MM-DD" year (4 digits), month (2 digits), day (2 digits)
Do not use other separators such as "/", " ", "," or ".".
Partial dates are allowed:
"YYYY" - game was played in YYYY
"YYYY-MM" - game was played in YYYY, month MM
For games that last more than one day: separate other dates
by a comma (no spaces!).
For games that were played over a period of time: specify
start date and end date separated by a "~"
Following shortcuts may be used:
"MM-DD" - if preceeded by YYYY-MM-DD, YYYY-MM, MM-DD, MM or DD
"MM" - if preceeded by YYYY-MM or MM
"DD" - if preceeded by YYYY-MM-DD, MM-DD or DD
Shortcuts aquire the last preceeding YYYY and MM (if necessary).
Note: interpretation is done from left to right.
Examples:
1996-05,06 = played in May,June 1996
1996-05-06,07,08 = played on 6th,7th,8th May 1996
1996,1997 = played in 1996 and 1997
1996-10-12~11-01 = played from 12th October
until 1st November
1996-12-27,28,1997-01-03~07 = played on 27th,28th
of December 1996 and from 3rd to 7th Januray 1997
Note: it's recommended to use shortcuts whenever possible,
e.g. 1997-05-05,06 instead of 1997-05-05,1997-05-06
Note: If a game lasted only two days, then the "~" should
not be used.
Examples for second value:
DT[1934:spring] ... played in Spring 1934
DT[1845-03-03,04:played nonstop through the night]
DT[1844-04-15:Tenpo 15-II-28]
DT[:early Qing era]
Property: PC
Propvalue: simpletext
Propertytype: game-info
Function: Provides the place where the games was played. It is
recommended to describe the place with increasing
detail from left to right. If the country is listed,
then using ISO-3166 abbreviations is recommended.
Examples:
PC[NL,Amsterdam]
PC[JP,Tokyo,Fujiyama Hot Spring Resort Hotel]
Property: RE
Propvalue: (simpletext | composed simpletext ":" simpletext)
Propertytype: game-info
Function: Provides the result of the game. The first value
gives the result in machine-readable form, the second value
is additional unformated information. It is MANDATORY to use
the following format for the first value:
"0" (zero) or "Draw" for a draw (jigo)
Color "+" ["score"] for a win by one player
Score is optional (some games don't have a score,
e.g. chess). If the score is given it has to be given
as a real value, e.g. "B+0.5", "W+64", "B+12.5"
Color "+Resign" or Color "+R" for a win by
resignation. Applications must not write "Black resigns".
Color "+Time" or Color "+T" for a win on time
Color "+Forfeit" or Color "+F" for a win by
forfeit
"A+" for a win for all players
"A-" for a loss for all players
"M+" for multi-player games, where more than one player
wins. Details should be given in free text.
"Void" for no result
"Unfinished" for suspended and unfinished games
"?" for an unknown result
Property: RO
Propvalue: simpletext
Propertytype: game-info
Function: Provides round-number and type of round. Following
format is recommended: RO[number,type,misc]
number ... number of round
type ... playoff, league, preliminary, etc.
Type may be omitted in title matches, e.g. RO[2]
misc ... optional additional info, e.g. on which board the
game was played (in team matches)
Examples: RO[2,league] ... 2nd round of the league
RO[2,preliminary,board 3] ... 2nd round of
preliminary stage, board 3 (team match)