CS计算机代考程序代写 .\” @(#)notation.n 3.9 (C) Henry Thomas Release 3 Dated 12/10/91

.\” @(#)notation.n 3.9 (C) Henry Thomas Release 3 Dated 12/10/91
.TH notation n “10 December 1990”

.SH NAME

notation \- transform chess notation

.SH SYNOPSYS

notation [input file] [-o output file] [-options…]

.SH DESCRIPTION

This program reads chess games, either full algebraic or shortened (ie
Nf1-g3 or Ng3) and is able to ouptut the board after any move, in
either ascii , postscript, nroff, latex, xboard or gnuan save
format. This program is also multi-lingual: it handles english,
french, spanish, german, italian, dutch, romanian etc… symbols. So
nearly all europeans languages are understood (except greek and
russian, but I can’t handle greek or cyrillic on ascii computers, eh).

.SH OPTIONS
Command line options:

.TP 8
.B -a
algebraic move notation output

.TP 8
.B -s
shortened move notation output

.TP 8
.B -f
specifies the chess symbol input language. The language can be any of
\fBfrench\fR, \fBenglish\fR, \fBitalian\fR, \fBspanish\fR,
\fBgerman\fR, \fBdutch\fR, \fBczech\fR, \fBhungarian\fR, \fBpolish\fR,
\fBromanian\fR, \fBFIDE\fR.

.TP 8
.B -t
specifies the chess symbol output language. Same options as input language.

.TP 8
.B
specifies the input file. If none, keyboard is assumed.

.TP 8
.B -o
specifies the output file. If none, screen is assumed.

.TP 8
.B -c [,
display the board at the move \fBnumber\fR and then stops

.TP 8
.B -b
display only the board, not the moves

.TP 8
.B -d
specifies the output driver. It can be any of the following:
\fBascii\fR, \fBpostscript\fR, \fBtex\fR, \fBroff\fR, \fBxchess\fR
(xchess or xboard save format), \fBgnu\fR (gnuan input format).

.TP 8
.B -i
suppress headers/footers printing. This is useful with tex or ps
drivers, if you want to include the output in a larger file.

.TP 8
.B -v
displays version number and exits

.TP 8
.B -h
displays help screen

.SH “INPUT LANGUAGE”

The input language has four types of input: moves, move numbers,
comments and keywords. All these are separated by blanks, TAB, CR,
commas and semi-columns.

.TP 8
.B move format:
The moves are accepted in algebraic or shortened algebraic notation.
That means that the following are equivalent and accepted \fB Nf1-g3
N-f1xg3, Nxg3, Ng3, Nfg3\fR. The ugly english notation \fBP-K4\fR is
not understood, neither by the program nor me. The program allows and
parse variations.

Nota: provided you remove the three first line, xchess save format is
accepted.

Also you can have move comments. So \fBKg4!!, Ra5++\fR are correct,
as \fBKg4 !!, Ra5 ++\fR. Castling is recognized with the following
\fB0-0 O-O o-o 0-0-0 O-O-O o-o-o\fR. “En passant” and promotion are
now correctly handled. For “en passant”, you just indicate them move
and it is correctly parsed ex: “d5-d7 e5xd6”. Promotion is indicated
with the “=” sign followed by the new piece name. So you just write
“a7-a8=Q” or “d8=K”. If you omit the piece name, promotion is made to
Queen by default; so “a8=” is equivalent to “a8=Q”.

For example, see the files \fBalgebraic.txt\fR,
\fBshortened.txt\fR and \fBboudy.txt\fR

.TP 8
.B move numbers:
move numbers are in the form \fB23.\fR or \fB36\fR. The full point is
optional. Move numbers are checked against internal move counter.

.TP 8
.B comments:
chess codified comments can be put in the input. There are two ways
or doing so. The first one is to use the usual chess notation \fB!?,
!, ,+, ++, #, ep, etc \fR… However, international magazine use other
no-ascii symbols : triangles, squares, infinity and so on. You can
have these symbols \fB on LaTeX output\fR. This is the second way. I
defined three letters abbreviations for such symbols (look at the file
\fBchesssymb.txt\fR for an extensive description). These abbreviations
are following a \fB$\fr sign. For instance \fB$wsb\fR means “white
slightly better”. This is, IMHO, a very interesting feature of the
program.

.TP 8
.B text:
plain text, such as explanations etc… must be enclosed in brackets
or parenthesis \fB[Here Karpov made a very bright move …]\fR
\fB(this is also a comment)\fR. Comments are not parsed, but directly
inserted in the output, for the \fBascii\fR ,\fBnroff\fR and
\fBlatex\fR drivers. The closing characters (ie “]” or “)” depending
of the opening characters may be placed in the text, provided it is
escaped by a “\\” ( so you input “\\]” or “\\)” ).

.TP 8
.B variations:
You can have variations in the source. Variation are in enclosing \fB
{ } \fR. You can have up to three level of variation. It would be
enough for human players. A variation always follows the move. Here is
an exemple of variation : \fB25. Rb2 { Ce4 de4 26 Fc3 Fa3! 27. Ff6 Tb3
} Fa3!\fR

.TP 8
.B keywords:
You can insert keywords in the input text to precisely define what
you want: displaying the board, configuring it… Keywords are
detailled in the next section.

.SH KEYWORDS
all keywords are prefixed with \fB@\fR
.TP 8
.B @startplay
begins the play. Obligatory after a \fB@configxxx\fR keyword.
.TP 8
.B @clearboard
clears the board. Used prior to any \fB@configxxx\fR.
.TP 8
.B @showboard
displays the board. Can be used anywhere
.TP 8
.B @whitesmove
tells the program that is the white’s turn of play. Useful after a
\fB@configxxx\fR and \fB@startplay\fR
.TP 8
.B @blacksmove
tells the program that it is black’s turn
.TP 8
.B @configwhite
initializes configuration of white side. Pieces are then expected, in
form of (optional for Pawn) name, the position. Example
\fB@configwhite Ke3 Rg8 e4\fR.
.TP 8
.B @configblack
initializes configuration of black side. Pieces are then expected, in
form of (optional for Pawn) name, the position. Example:
\fB@configblack Ka8 Nf6 e6\fR.

Note that black pieces are given in uppercase!

.TP 8
.B @default
resets the board to the default start configuration.
.TP 8

.TP 8
.B @title{