.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "HACHU 6"
.TH HACHU 6 "2017-08-06" "perl v5.26.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
hachu \- xboard\-compatible engine for Chu Shogi and other variants
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBhachu\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBhachu\fR is a program that plays several shogi and chess variants,
currently sho shogi, chu shogi, dai shogi, makruk and shatranj.
In the future it might play more, and still larger shogi variants,
in particular tenjiku shogi.
.PP
HaChu uses the xboard/winboard chess-engine protocol to communicate.
It thus can use XBoard as a graphical interface for the variants also supported by the latter.
Only XBoard 4.8 and later support chu shogi,
but sho shogi should already work under XBoard 4.7,
and Makruk and Shatranj under much older versions.
Dai shogi is not supported by XBoard yet.
.PP
See \fIxboard\fR\|(6) for instructions about how to use \fBhachu\fR through xboard.
To start up quickly, you just need the command: \fBxboard \-fcp hachu\fR.
You can then use XBoard's New Variant dialog to select the variant you want to play.
To play chu shogi, it is essential that XBoard's 'show target squares' option is switched on;
otherwise the two-step lion moves can not be entered.
.PP
Normally XBoard will use western-style chess symbols to represent the pieces.
But HaChu comes with a set of piece images in the shape of the Japenese kanji
for the names of the chu-shogi pieces.
These can be used in XBoard to get an oriental-style board display.
A settings file for configuring XBoard to use these pieces is also included with HaChu,
so that you can use the command \fBxboard \f(CB@chu\fB\fR to start XBoard with HaChu for oriental-style chu-shogi.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\s-1INTERACTIVE OPTIONS\s0\fR" 8
.IX Item "INTERACTIVE OPTIONS"
HaChu supports some options that can only be set interactively,
though XBoard's engine settings menu dialog.
These include an option for solving tsume problems
(checkmate problems where the winning side is only allowed to play checking moves).
There are also options to adapt it to various versions of the chu-shogi rules:
whether you can only promote on entering the promotion zone,
or whether moves inside or out of the zone (after one move delay) can also be used for promotion,
and whether repeats should be strictly forbidden, or only avoided like other losing moves.
.SH "AVAILABILITY"
.IX Header "AVAILABILITY"
At http://hgm.nubati.net/cgi\-bin/gitweb.cgi the source code can be obtained.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIxboard\fR\|(6)
.PP
game rules: http://hgm.nubati.net/rules
.PP
XBoard: http://hgm.nubati.net
.SH "STANDARDS"
.IX Header "STANDARDS"
WinBoard, \fBxboard\fR(6) interface (\*(L"Chess Engine Communication Protocol\*(R")
.SH "AUTHOR"
.IX Header "AUTHOR"
H.G.Muller <h.g.muller@hccnet.nl>.
.PP
This manual page was generated with \fIpod2man\fR\|(1).