more docs!

1 files changed, 92 insertions, 10 deletions

diff --git a/chess.texi b/chess.texi
index 05dcd03..9988669 100644
--- a/chess.texi
+++ b/chess.texi
@@ -98,7 +98,7 @@ also reflecting which side is next to move, and what privileges are
 currently available to each side (castling short or long, en passant
 capture, etc).
 
-A position may be represented in ASCII using FEN notation, or
+A position may be represented in ASCII using FEN (or EPD) notation, or
 graphically by displaying a chess board.  It is rather inconvenient to
 render them verbally.
 
@@ -227,6 +227,20 @@ And in "full" mode (where all spaces are accounted for):
 
 @c lispfun chess-pos-to-fen
 
+@subsection EPD notation
+
+Extended Position Description is an extension of the FEN notation to
+allow to supply additional information in a simple and standardized
+way.  In addition to a FEN notation psotion description, EPD allows
+for an optional list of opcode/value pairs.  There is a standard
+set of opcodes with well defined meanings to choose from.
+
+@c lispfun chess-epd-to-pos
+
+@c lispfun chess-pos-to-epd
+
+@c lispfun chess-epd-read-file
+
 @section Plies
 
 A @dfn{ply} is the differential between two positions.  Or, it is the
@@ -478,9 +492,14 @@ database base-class:
 @subsubsection chess-file
 
 This module does not use an external chess database program
-to store and retrieve games.  It uses the PGN format parsing
-routines provided in `chess-pgn.el' to implement Collections
-for ordinary PGN files.
+to store and retrieve games.  It uses the PGN of EPD format parsing
+routines provided in `chess-pgn.el' and `chess-epd.el' to implement Collections
+for ordinary PGN and EPD files.
+
+EPD file collections are represented as a collection of games originating
+at the given position.  One might argue that conceptually, they represent
+a collection of positions, but it is more convenient to merge all
+collections into one uniform concept.
 
 @subsubsection chess-scid
 
@@ -604,7 +623,7 @@ different games would get impossible to sort out.  Better to create a
 new board for every game---the way ordinary humans would do it in the
 real world.
 
-@chapter Displays
+@chapter Chessboard displays
 
 The previous chapter described all the objects found in
 chess---positions, plies, variations, games and collections.  However,
@@ -613,12 +632,12 @@ functions given so far.  In order to present them in a meaningful
 fashion to a human reader, it is necessary to create and use a display
 object.
 
+@section Generic display manipulation functions
+
 @c lispfun chess-display-create
 
 @c lispfun chess-display-destroy
 
-@chapter Chessboard displays
-
 @c lispfun chess-display-active-p
 
 @c lispfun chess-display-clear-board
@@ -665,6 +684,56 @@ object.
 
 @c lispfun chess-display-variation
 
+@section Plain ASCII diagram displays
+
+The simplest display style available is chess-plain, a very customisable
+ASCII board diagram display.
+
+@defvar chess-plain-separate-frame
+If non-nil, display the chessboard in its own frame.
+@end defvar
+
+@defvar chess-plain-draw-border
+Non-nil if a border should be drawn (using `chess-plain-border-chars').
+@end defvar
+
+@defvar chess-plain-border-chars
+A list of Characters used to draw borders.
+@end defvar
+
+@defvar chess-plain-black-square-char
+Character used to indicate empty black squares.
+@end defvar
+
+@defvar chess-plain-white-square-char
+Character used to indicate black white squares.
+@end defvar
+
+@defvar chess-plain-piece-chars
+Alist of pieces and their corresponding characters.
+@end defvar
+
+@defvar chess-plain-upcase-indicates
+Defines what a upcase char should indicate.
+The default is 'color, meaning a upcase char is a white piece, a
+lowercase char a black piece.  Possible values: 'color (default),
+'square-color.  If set to 'square-color, a uppercase character
+indicates a piece on a black square. (Note that you also need to
+modify `chess-plain-piece-chars' to avoid real confusion.)
+@end defvar
+
+@defvar chess-plain-spacing
+Number of spaces between files.
+@end defvar
+
+@section ICS1 style ASCII displays
+
+@defvar chess-ics1-separate-frame
+If non-nil, display the chessboard in its own frame.
+@end defvar
+
+@section Graphical displays
+
 @chapter Engines
 
 @c lispfun chess-engine-create
@@ -695,9 +764,9 @@ Based on the services provided above, there is also a speical mode
 for communication with Internet Chess Servers.
 
 ON an Internet Chess Server you can seek to play against other
-human or computer players, observe other games being player of examined,
-play tournaments, be part of a group game, or do various other interesting
-chess related things.
+human or computer players, observe other games being player or examined,
+play tournaments, chat with fellow chess players, participate in a team game,
+or do various other interesting chess related things.
 
 A default set of well known servers is defined in the following variable:
 
@@ -721,6 +790,19 @@ want to do is find an oponent for a new game.  You can use the
 ICS command "seek" to announce your availability for a chess game
 to interested people.
 
+@section The sought game display
+
+There is a special mode for displaying games sought by other users
+on an Internet Chess Server.  Provided you didn't turn off seek ads
+manually (for instance by setting the seek variable to 0 (off) on the
+ICS server by issueing "set seek 0"), the first seek advertisment
+automatically pops up a new window which is in `chess-ics-sought-mode'.
+
+@c lispfun chess-ics-sought-mode
+
+In this buffer, use mouse-2 or @kbd{RET} on a line to accept that
+particular game and play it.
+
 @unnumbered Concept Index
 
 @printindex cp