Here are additional man pages for bearoffdump, makebearoff, and makehyper.
(Debian requires all binaries to have man pages.)
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.ad l
.nh
.TH BEAROFFDUMP 6 "2006-01-14"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
bearoffdump \- dump a position from the GNU Backgammon bearoff database
.SH SYNOPSIS
.B bearoffdump
.I file id
.SH DESCRIPTION
.B bearoffdump
takes the path to a GNU Backgammon bearoff database and a position number
and dumps the bearoff information for that position. It can be called on
either the one-sided bearoff database, normally
.IR /usr/share/gnubg/gnubg_os0.bd ;
or the two-sided bearoff database, normally
.IR /usr/share/gnubg/gnubg_ts0.bd .
The output from the former includes the probabilities of bearing off all
checkers in varying numbers of moves. The latter only gives the
probability of winning and doubling cube equity.
.PP
The
.I id
is difficult to derive if you don't know GNU Backgammon internals. Each
possible combinatorial position of checkers and points is assigned a
position number,
.I id
divided by that number is the player position, and
.I id
modulo that number is the opponent position. The number of points and
checkers is set when building the bearoff database and are shown by
.B bearoffdump
when run with any
.IR id .
.SH SEE ALSO
.IR gnubg (6)
.SH AUTHORS
Joseph Heled, \[/O]ystein Johansen, J\[/o]rn Thyssen, and Gary Wong,
with the assistance of many others <[EMAIL PROTECTED]>.
.PP
This manual page was written by Russ Allbery <[EMAIL PROTECTED]>, for the
Debian GNU/Linux system (but may be used by others). It may be
redistributed and/or modified under the terms of version 2 of the GNU
General Public License as published by the Free Software Foundation (the
same license as GNU Backgammon).
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.ad l
.nh
.TH MAKEBEAROFF 6 "2006-01-15"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
makebearoff \- generate a GNU Backgammon bearoff database
.SH SYNOPSIS
\fBmakebearoff\fR
[\fB\-HCcgnvh\fR]
\fB\-f\fR \fIfilename\fR
[\fB\-t\fR \fIP\fRx\fIC\fR]
[\fB\-o\fR \fIP\fR]
[\fB\-s\fR \fIcache-size\fR]
[\fB\-O\fR \fIfilename\fR]
.SH DESCRIPTION
.B makebearoff
generates GNU Backgammon bearoff databases, which are used to improve play
in the endgame. It can generate either two-sided (exact) databases that
tell precisely the chance of winning or one-sided (approximate) databases
that provide a variety of probabilities looking at each side
independently.
.PP
Bearoff databases can get quite large and can take a significant amount of
time to generate for large numbers of chequers and/or points.
.SH OPTIONS
.TP
\fB\-f\fR \fIfilename\fR, \fB\-\-outfile\fR \fIfilename\fR
Write the bearoff database to
.IR filename .
This option must be given.
.TP
\fB\-t\fR \fIP\fRx\fIC\fR, \fB\-\-two\-sided \fIP\fRx\fIC\fR
Generate a two-sided bearoff database for
.I P
points and
.I C
chequers for each player. Be warned that the size of the database grows
rapidly with larger numbers of points and chequers.
.TP
\fB\-o\fR \fIP\fR, \fB\-\-one\-sided\fR \fIP\fR
Generate a one-sided bearoff database for
.I P
points. One-sided bearoff databases are always generated for up to
fifteen chequers.
.TP
\fB\-s\fR \fIN\fR, \fB\-\-xhash\-size\fR \fIN\fR
Use a memory cache of size
.I N
while building the database. If the cache is smaller than the database
size, database generation will be slower due to disk writes.
.TP
\fB\-O\fR \fIfilename\fR, \fB\-\-old\-bearoff\fR \fIfilename\fR
Reuse an already generated bearoff database. Any needed data already in
this database will just be copied without regenerating it.
.TP
.BR \-H ", " \-\-no\-header
Do not write the normal bearoff database header.
.TP
.BR \-C ", " \-\-no\-cubeful
Do not calculate cubeful equities for two-sided databases.
.TP
.BR \-c ", " \-\-no\-compress
Do not compress one-sided databases.
.TP
.BR \-g ", " \-\-no\-gammons
Do not include gammon distributions in one-sided databases.
.TP
.BR \-n ", " \-\-normal\-dist
Rather than storing exact probabilities, approximate probabilities in a
one-sided database with a normal distribution.
.TP
.BR \-v ", " \-\-version
Show version information and exit.
.TP
.BR \-h ", " \-\-help
Display usage and exit.
.SH EXAMPLES
To generate a two-sided database for up to eight chequers on six points:
.sp 1
.nf
makebearoff \-t 6x8 \-f gnubg_ts.bd
.fi
.sp 1
Note that this database is 72MB in size. To generate a one-sided database
for up to fifteen chequers on ten points:
.sp 1
.nf
makebearoff \-o 10 \-f gnubg_os.bd
.fi
.sp 1
Note that this database is 118MB in size.
.SH SEE ALSO
.IR gnubg (6),
.IR bearoffdump (6)
.SH AUTHORS
Joseph Heled, \[/O]ystein Johansen, J\[/o]rn Thyssen, and Gary Wong,
with the assistance of many others <[EMAIL PROTECTED]>.
.PP
This manual page was written by Russ Allbery <[EMAIL PROTECTED]>, for the
Debian GNU/Linux system (but may be used by others). It may be
redistributed and/or modified under the terms of version 2 of the GNU
General Public License as published by the Free Software Foundation (the
same license as GNU Backgammon).
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.ad l
.nh
.TH MAKEHYPER 6 "2006-01-15"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
makehyper \- generate a GNU Backgammon Hypergammon position database
.SH SYNOPSIS
\fBmakehyper\fR
[\fB\-nvh\fR]
\fB\-f\fR \fIfilename\fR
[\fB\-r\fR \fIfilename\fR]
[\fB\-c\fR \fIchequers\fR]
[\fB\-t\fR \fIthreshold\fR]
.SH DESCRIPTION
Hypergammon is a variation of backgammon with a much reduced number of
chequers (usually three). It's possible to fully analyze this simplified
game and generate a database of position evaluations in order to play
perfectly.
.B makehyper
generates such a position evaluation database.
.PP
Since many of the positions are in contact, it's not possible to generate
the database in one pass; instead,
.B makehyper
iterates until the position evaluation converges. The convergence
threshold can be changed with the
.B \-t
option.
.SH OPTIONS
.TP
\fB\-f\fR \fIfilename\fR, \fB\-\-outfile\fR \fIfilename\fR
Write the hypergammon database to
.IR filename .
This option must be given.
.TP
\fB\-r\fR \fIfilename\fR, \fB\-\-restart\fR \fIfilename\fR
Restart calculation of the database from the given file, which should be a
checkpoint from an earlier run.
.TP
\fB\-c\fR \fIchequers\fR, \fB\-\-chequers\fR \fIchequers\fR
Set the number of chequers in the game. The default is 3, for normal
3-chequer hypergammon.
.TP
.BR \-n ", " \-\-no\-checkpoint
Do not write a checkpoint file after each iteration.
.TP
\fB\-t\fR \fIthreshold\fR, \fB\-\-threshold\fR \fIthreshold\fR
Set the convergence threshold. The default is 1e-5.
.TP
.BR \-v ", " \-\-version
Show version information and exit.
.TP
.BR \-h ", " \-\-help
Display usage and exit.
.SH SEE ALSO
.IR gnubg (6)
.SH AUTHORS
Joseph Heled, \[/O]ystein Johansen, J\[/o]rn Thyssen, and Gary Wong,
with the assistance of many others <[EMAIL PROTECTED]>.
.PP
This manual page was written by Russ Allbery <[EMAIL PROTECTED]>, for the
Debian GNU/Linux system (but may be used by others). It may be
redistributed and/or modified under the terms of version 2 of the GNU
General Public License as published by the Free Software Foundation (the
same license as GNU Backgammon).
--
Russ Allbery ([EMAIL PROTECTED]) <http://www.eyrie.org/~eagle/>
_______________________________________________
Bug-gnubg mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/bug-gnubg
