Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Use roff and mdoc to write the manual pages

Remove the gui's manual page since it didn't contain anything useful at
this point.

Update .gitignore, INSTALL and cutechess.pro to reflect these
changes.
  • Loading branch information...
commit e9e68e329efb72e490043a2ab28222449924abb6 1 parent 83b861d
Arto Jonsson authored
View
5 .gitignore
@@ -17,11 +17,6 @@ test_board
# qmake generated Makefile
Makefile
-# asciidoc generated man page and xml document
-docs/cutechess*.6
-docs/cutechess*.xml
-docs/cutechess*.html
-
# doxygen generated api documents
docs/api/html/
View
9 INSTALL
@@ -32,14 +32,7 @@ And to build the source:
To build on a Macintosh, add "-spec macx-g++" to the qmake command.
-Documentation is available as Unix manual pages and in HTML format. Building
-the documentation in either format requires asciidoc
-(http://www.methods.co.nz/asciidoc/).
-
- $ make doc-man (documentation as Unix manual pages)
- $ make doc-html (documentation in HTML format)
-
-The documentation is built to the "docs" directory.
+Documentation is available as Unix manual pages in the "docs" directory.
If you want to have an overview of Cute Chess' source you can build the API
documentation:
View
10 cutechess.pro
@@ -10,13 +10,3 @@ SUBDIRS = projects
# API documentation (Doxygen)
doc-api.commands = doxygen docs/api/api.doxygen
QMAKE_EXTRA_TARGETS += doc-api
-
-# Unix manual pages
-doc-man.commands += a2x -f manpage docs/cutechess.txt;
-doc-man.commands += a2x -f manpage docs/cutechess-cli.txt
-QMAKE_EXTRA_TARGETS += doc-man
-
-# html documentation
-doc-html.commands += asciidoc -b xhtml11 docs/cutechess.txt;
-doc-html.commands += asciidoc -b xhtml11 docs/cutechess-cli.txt
-QMAKE_EXTRA_TARGETS += doc-html
View
252 docs/cutechess-cli.6
@@ -0,0 +1,252 @@
+.Dd January 7, 2012
+.Dt CUTECHESS-CLI 6
+.Os
+.Sh NAME
+.Nm cutechess-cli
+.Nd A command-line tool for chess engine matches
+.Sh SYNOPSIS
+.Nm
+.Fl engine Ar engine-options
+.Fl engine Ar engine-options
+.Op Fl engine Ar engine-options ...
+.Op options
+.Sh DESCRIPTION
+Runs chess matches from the command line.
+.Pp
+Its options are as follows:
+.Bl -tag -width Ds
+.It Fl engine Ar engine-options
+Add an engine defined by
+.Ar engine-options
+to the tournament.
+See
+.Sx Engine Options .
+.It Fl each Ar engine-options
+Apply
+.Ar engine-options
+to each engine in the tournament.
+.It Fl variant Ar arg
+Set the chess variant to
+.Ar arg .
+.It Fl concurrency Ar n
+Set the maximum number of current games to
+.Ar n .
+.It Fl draw Ar n Ar score
+Adjudicate the game as draw if the score of both engines is within
+.Ar score
+centipawns from zero after
+.Ar n
+full moves have been played.
+.It Fl resign Ar n Ar score
+Adjudicate the game as a loss if an engine's score it at least
+.Ar score
+centipawns below zero for at least
+.Ar n
+consecutive moves.
+.It Fl tournament Ar arg
+Set the tournament type to
+.Ar arg .
+Supported tournament types are:
+.Cm round-robin
+(default) and
+.Cm gauntlet .
+.It Fl event Ar arg
+Set the event name to
+.Ar arg .
+.It Fl games Ar n
+Play
+.Ar n
+games per encounter. This value should be set to an even number in
+tournaments with more than two players to make sure that each player
+plays an equal number of games with white and black pieces.
+.It Fl rounds Ar n
+Multiply the number of rounds to play by
+.Ar n .
+For two-player tournaments this option should be used to set the total
+number of games to play.
+.It Fl ratinginterval Ar n
+Set the interval for printing the ratings to
+.Ar n
+games.
+.It Fl debug
+Display all engine input and output.
+.It Fl pgnin Ar file
+Use
+.Ar file
+as the opening book in PGN format.
+.It Fl pgndepth Ar n
+Set the maximum depth for the PGN input to
+.Ar n
+plies.
+.It Fl pgnout Ar file Bq Cm min
+Save the games to
+.Ar file
+in PGN format. Use the
+.Cm min
+argument to save in a minimal PGN format.
+.It Fl recover
+Restart crashed engines instead of stopping the match.
+.It Fl repeat
+Play each opening twice so that both players get to play it on both
+sides.
+.It Fl site Ar arg
+Set the site / location to
+.Ar arg .
+.It Fl srand Ar n
+Set the random seed for the book move selector to
+.Ar n .
+.It Fl wait Ar n
+Wait
+.Ar n
+milliseconds between games. The default is 0.
+.It Fl -version
+Display the version information.
+.It Fl -help
+Display help information.
+.It Fl -engines
+Display a list of configured engines and exit.
+.It Fl -protocols
+Display a list of supported chess protocols and exit.
+.It Fl -variants
+Display a list of supported chess variants and exit.
+.El
+.Sh ENGINE OPTIONS
+.Bl -tag -width Ds
+.It Ic conf Ns = Ns Ar arg
+Use an engine with the name
+.Ar arg
+from Cute Chess configuration file.
+.It Ic name Ns = Ns Ar arg
+Set the name to
+.Ar arg .
+.It Ic cmd Ns = Ns Ar arg
+Set the command to
+.Ar arg .
+.It Ic dir Ns = Ns Ar arg
+Set the working directory to
+.Ar arg .
+.It Ic arg Ns = Ns Ar arg
+Pass
+.Ar arg
+to the engine as a command line argument.
+.It Ic initstr Ns = Ns Ar arg
+Send
+.Ar arg
+to the engine's standard input at startup.
+.It Ic restart Ns = Ns Cm auto Ns | Ns Cm on Ns | Ns Cm off
+Set the engine restart mode which can be one of the following:
+.Cm auto
+The engine decides wherher to restart (default).
+.Cm on
+The engine is always restarted between games.
+.Cm off
+The engine is never restarted between games.
+.It Ic proto Ns = Ns Ar arg
+Set the chess protocol to
+.Ar arg .
+.It Ic tc Ns = Ns Ar arg Ns | Ns Cm inf
+Set the time control to
+.Ar arg .
+The format is moves/time+increment, where
+.Ar moves
+is the number of moves per tc,
+.Ar time
+is time per tc (either seconds or minutes:seconds, and
+.Ar increment
+is the time increment per move in seconds.
+.Pp
+Infinite time control can be set with
+.Cm inf .
+.It Ic st Ns = Ns Ar n
+Set the time limit fo each move to
+.Ar n
+seconds. This option cannot be used in combination with the
+.Ic tc .
+.It Ic timemargin Ns = Ns Ar n
+Let engines to
+.Ar n
+milliseconds over the time limit.
+.It Ic book Ns = Ns Ar file
+Use
+.Ar file
+(Polyglot book file) as the opening book.
+.It Ic bookdepth Ns = Ns Ar n
+Set the maximum book depth (in fullmoves) to
+.Ar n .
+.It Ic whitepov
+Inver the engine's scores when it plays black. This option should be
+used with engines that always report scores from white's perspective.
+.It Ic depth Ns = Ns Ar n
+Set the search depth limit to
+.Ar n
+plies.
+.It Ic nodes Ns = Ns Ar n
+Set the node count limit to
+.Ar n
+nodes.
+.It Ic option. Ns Ar name Ns = Ns Ar arg
+Set custom engine option
+.Ar name
+to value
+.Ar arg .
+.El
+.Sh EXAMPLES
+Play ten games between two Sloppy engine with a time control of 40
+moves in 60 seconds:
+.Pp
+.Dl $ cutechess-cli \-engine name=Sloppy -engine name=Sloppy -each cmd=sloppy proto=xboard tc=40/60 -rounds 10
+.Pp
+Play a single game between Atak and Glaurung engines with a time
+control of 40 moves in one minute and 30 seconds with one second
+increment:
+.Pp
+.Dl $ cutechess-cli \-engine name=Atak cmd=Atak32.exe dir=C:\\atak proto=xboard -engine cmd=glaurung proto=uci option.Threads=1 -both tc=40/1:30+1
+.Bl -bullet
+.It
+Use the name=Atak parameter because it's a Xboard protocol 1 engine
+and doesn't tell its name.
+.It
+Use the dir=C:\\atak parameter to point the location of the executable.
+.It
+Glaurung can tell its name and is in the PATH variable so only the
+command is needed.
+.It
+Set Glaurung to use 1 thread.
+.It
+Set the time control to 40 moves in one minute and 30 seconds with
+one second increment.
+.El
+.Pp
+Play a Round-Robin tournament between Fruit, Crafty, Stockfish and
+Sloppy:
+.Pp
+.Dl $ cutechess-cli \-engine conf=Fruit -engine conf=Crafty -engine conf=Stockfish -engine conf=Sloppy -each tc=4 book=book.bin -games 2 -rounds 10 -repeat
+.Bl -bullet
+.It
+Play two games per encounter, effectively multiplying the number of
+games by 2.
+.It
+Play 10 times the minimum amount of rounds (3). So the total number
+of rounds to play will be 30, and the total number of games 120.
+.It
+In each two-game encounter colors are switched between games and the
+same opening line is played in both games.
+.El
+.Sh AUTHORS
+The
+.Nm
+utility was written by
+.An Ilari Pihlajisto ,
+.Mt ilari.pihlajisto@mbnet.fi ;
+and
+.An Arto Jonsson ,
+.Mt ajonsson@kapsi.fi .
+.Sh RESOURCES
+.Bl -bullet
+.It
+Source code:
+.Lk http://repo.or.cz/w/sloppygui.git
+.It
+Mailing list:
+.Lk https://list.kapsi.fi/listinfo/cutechess
+.El
View
229 docs/cutechess-cli.txt
@@ -1,229 +0,0 @@
-CUTECHESS-CLI(6)
-================
-
-NAME
-----
-cutechess-cli - A command-line tool for chess engines matches
-
-
-SYNOPSIS
---------
-*cutechess-cli* -engine ['ENGINE OPTIONS'] -engine ['ENGINE OPTIONS']... ['OPTIONS']
-
-DESCRIPTION
------------
-Runs chess matches from the command line.
-
-
-OPTIONS
--------
-
-\--version::
- Display the version information.
-
-\--help::
- Display help information.
-
-\--engines::
- Display a list of configured engines and exit.
-
-\--protocols::
- Display a list of supported chess protocols and exit.
-
-\--variants::
- Display a list of supported chess variants and exit.
-
--engine <options>::
- Add an engine defined by <options> to the tournament.
-
--each <options>::
- Apply <options> to each engine in the tournament.
-
--variant <arg>::
- Set chess variant to <arg>.
-
--concurrency <n>::
- Set the maximum number of concurrent games to <n>.
-
--draw <n> <score>::
- Adjudicate the game as a draw if the score of both engines is
- within <score> centipawns from zero after <n> full moves have
- been played.
-
--resign <n> <score>::
- Adjudicate the game as a loss if an engine's score is at least
- <score> centipawns below zero for at least <n> consecutive moves.
-
--event <arg>::
- Set the event name to <arg>.
-
--games <n>::
- Play <n> games per encounter. This value should be set to an even
- number in tournaments with more than two players to make sure
- that each player plays an equal number of games with white and
- black pieces.
-
--rounds <n>::
- Multiply the number of rounds to play by <n>. For two-player
- tournaments this option should be used to set the total number of
- games to play.
-
--ratinginterval <n>::
- Set the interval for printing the ratings to <n> games.
-
--debug::
- Display all engine input and output.
-
--pgnin <file>::
- Use <file> as the opening book in PGN format.
-
--pgndepth <n>::
- Set the maximum depth for PGN input to <n> plies.
-
--pgnout <file> [min]::
- Save the games to <file> in PGN format. Use the 'min' argument
- to save in a minimal PGN format.
-
--recover::
- Restart crashed engines instead of stopping the match.
-
--repeat::
- Play each opening twice so that both players get to play it on
- both sides.
-
--site <arg>::
- Set the site / location to <arg>.
-
--srand <n>::
- Set the random seed for the book move selector to <n>.
-
--wait <n>::
- Wait <n> milliseconds between games. The default is 0.
-
-
-ENGINE OPTIONS
---------------
-
-conf=<arg>::
- Use an engine with the name <arg> from Cute Chess\' configuration
- file.
-
-name=<arg>::
- Set the name to <arg>.
-
-cmd=<arg>::
- Set the command to <arg>.
-
-dir=<arg>::
- Set the working directory to <arg>.
-
-arg=<arg>::
- Pass <arg> to the engine as a command line argument.
-
-initstr=<arg>::
- Send <arg> to the engine's standard input at startup.
-
-restart=<arg>::
- Set the restart mode to <arg> which can be:
- 'auto': the engine decides whether to restart (default)
- 'on': the engine is always restarted between games
- 'off': the engine is never restarted between games
-
-proto=<arg>::
- Set the chess protocol to <arg>.
-
-tc=<arg>::
- Set the time control to <arg>. The format is
- moves/time+increment, where 'moves' is the number of
- moves per tc, 'time' is time per tc (either seconds or
- minutes:seconds), and 'increment' is time increment
- per move in seconds.
- Infinite time control can be set with 'tc=inf'.
-
-st=<n>::
- Set the time limit for each move to <n> seconds.
- This option can't be used in combination with "tc".
-
-timemargin=<n>::
- Let engines go <n> milliseconds over the time limit.
-
-book=<file>::
- Use <file> (Polyglot book file) as the opening book.
-
-bookdepth=<n>::
- Set the maximum book depth (in fullmoves) to <n>.
-
-whitepov::
- Invert the engine's scores when it plays black. This
- option should be used with engines that always report
- scores from white's perspective.
-
-depth=<n>::
- Set the search depth limit to <n> plies.
-
-nodes=<n>::
- Set the node count limit to <n> nodes.
-
-option.<name>=<arg>::
- Set custom engine option <name> to value <arg>.
-
-
-EXAMPLES
---------
-
-* Play ten games between two Sloppy engines with a time
-control of 40 moves in 60 seconds.
-
------------
-$ cutechess-cli -engine name=Sloppy -engine name=Sloppy -each cmd=sloppy proto=xboard tc=40/60 -rounds 10
------------
-
-* Use the 'name=Atak' parameter because it's a Xboard
-protocol 1 engine and doesn't tell its name.
-
-* Use the 'dir=C:\atak' parameter to point the location of
-the executable.
-
-* Glaurung can tell its name and is in the PATH variable
-so only the command is needed.
-
-* Set Glaurung to use 1 thread.
-
-* Set the time control to 40 moves in one minute and 30
-seconds with a one second increment.
-
------------
-$ cutechess-cli -engine name=Atak cmd=Atak32.exe dir=C:\atak proto=xboard -engine cmd=glaurung proto=uci option.Threads=1 -both tc=40/1:30+1
------------
-
-* Play a Round-Robin tournament between Fruit, Crafty, Stockfish and Sloppy.
-
-* Play two games per encounter, effectively multiplying the number of games by 2.
-
-* Play 10 times the minimum amount of rounds (3). So the total number of rounds
-to play will be 30, and the total number of games 120.
-
-* In each two-game encounter colors are switched between games and the same
-opening line is played in both games.
-
------------
-$ cutechess-cli -engine conf=Fruit -engine conf=Crafty -engine conf=Stockfish -engine conf=Sloppy -each tc=4 book=book.bin -games 2 -rounds 10 -repeat
------------
-
-AUTHOR
-------
-Written by Ilari Pihlajisto <ilari.pihlajisto@mbnet.fi> and Arto Jonsson
-<ajonsson@kapsi.fi>.
-
-
-RESOURCES
----------
-* Source code: <http://repo.or.cz/w/sloppygui.git>
-
-* Mailing list: <https://list.kapsi.fi/listinfo/cutechess>
-
-COPYING
--------
-Copyright \(C) 2008-2011 Ilari Pihlajisto and Arto Jonsson. Free use of this
-software is granted under the terms of GNU General Public License (GPL).
-
View
52 docs/cutechess.txt
@@ -1,52 +0,0 @@
-CUTECHESS(6)
-============
-
-NAME
-----
-cutechess - A graphical user interface for chess engines
-
-
-SYNOPSIS
---------
-*cutechess* ['OPTIONS']
-
-
-DESCRIPTION
------------
-Description of Cute Chess.
-
-
-OPTIONS
--------
-
--v::
-\--version::
- Display the version information.
-
-FILES
------
-
-~/.config/cutechess/cutechess.ini::
- User configuration file.
-
-/etc/xdg/cutechess/cutechess.ini::
- System-wide configuration file.
-
-
-AUTHOR
-------
-Written by Ilari Pihlajisto <ilari.pihlajisto@mbnet.fi> and Arto Jonsson
-<ajonsson@kapsi.fi>.
-
-
-RESOURCES
----------
-* Source code: <http://repo.or.cz/w/sloppygui.git>
-
-* Mailing list: <https://list.kapsi.fi/listinfo/cutechess>
-
-COPYING
--------
-Copyright \(C) 2008-2011 Ilari Pihlajisto and Arto Jonsson. Free use of this
-software is granted under the terms of GNU General Public License (GPL).
-
Please sign in to comment.
Something went wrong with that request. Please try again.