~ubuntu-branches/debian/sid/gnubg/sid

« back to all changes in this revision

Viewing changes to doc/faq.texi

  • Committer: Bazaar Package Importer
  • Author(s): Russ Allbery
  • Date: 2006-12-28 10:45:05 UTC
  • mfrom: (2.1.5 feisty)
  • Revision ID: james.westby@ubuntu.com-20061228104505-4p6sxxdosrlvhgpr
Tags: 0.14.3+20060923-4
* Translation updates:
  - French, thanks Thomas Huriaux.  (Closes: #404254)
  - Spanish, thanks Javier Ruano.  (Closes: #404613)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
@author Achim Mueller <ace@gnubg.org>
 
2
@macro gnubg
 
3
@t{gnubg}
 
4
@end macro
 
5
 
 
6
@node top
 
7
@chapter Frequently Asked Questions
 
8
@cindex frequently asked questions
 
9
@cindex FAQ
 
10
 
 
11
This chapter documents the most frequently asked questions. Sources include
 
12
the newsgroup @uref{news:rec.games.backgammon,, rec.games.backgammon}, the
 
13
@uref{mailto:bug-gnubg@@gnu.org,, @gnubg{}-mailinglist} and the
 
14
@uref{http://www.gammonline.com,, discussion board of @emph{GammOnLine}}.
 
15
 
 
16
@menu
 
17
* General questions::
 
18
* Installation questions::
 
19
* Gnubg startup questions::
 
20
* Backgammon playing questions::
 
21
* Settings questions::
 
22
* Analysis questions::
 
23
* Database questions::
 
24
* Abbreviations::
 
25
* Some Backgammon and technical terms::
 
26
@end menu
 
27
 
 
28
@node General questions
 
29
@section General questions
 
30
 
 
31
@menu
 
32
* What is GNU Backgammon?::
 
33
* Which operating systems are supported?::
 
34
* Where can I download it?::
 
35
* Do I have to pay for GNU Backgammon?::
 
36
* This GNU stuff sounds interesting::
 
37
* Learn more about backgammon::
 
38
* What is Hypergammon?::
 
39
* What is Nackgammon?::
 
40
* Where do I get more documentation about GNU Backgammon?::
 
41
* I have read all the documentation but I still have questions::
 
42
* I probably found a bug. What shall I do now?::
 
43
* I have some suggestions and new ideas for improvements::
 
44
* This F.A.Q. is full of typos and in bad English.::
 
45
@end menu
 
46
 
 
47
 
 
48
@node What is GNU Backgammon?    
 
49
@subsection What is GNU Backgammon?
 
50
 
 
51
GNU Backgammon (@gnubg{}) is software for playing and analysing backgammon
 
52
positions, games and matches. It's based on a neural network. Although it
 
53
already plays at a very high level, it's still work in progress. You may
 
54
play GNU Backgammon using the command line or a graphical interface
 
55
(based on GTK+).
 
56
 
 
57
@node Which operating systems are supported?
 
58
@subsection Which operating systems are supported?
 
59
 
 
60
Currently GNU Backgammon is specifically designed for @emph{GNU/Linux}. It
 
61
also compiles and (hopefully) runs under @emph{*BSD, IRIX, Solaris} and
 
62
@emph{True64 Unix}. Last but not least there are downloads available for
 
63
@emph{MS Windows}, @emph{MS DOS} and @emph{MacOSX}. If you successfully port 
 
64
GNU Backgammon to another operating system please let us know, contact 
 
65
@uref{bug-gnubg@@gnu.org}.
 
66
 
 
67
@node Where can I download it?
 
68
@subsection Where can I download it?
 
69
 
 
70
The official website is
 
71
@uref{http://www.gnubg.org/}. You can get daily snapshots at 
 
72
@uref{ftp://alpha.gnu.org/gnu/gnubg/snapshots/}. @emph{MS
 
73
Windows} binaries are available at @uref{http://home.online.no/%7Eoeysteij/}. 
 
74
Daily @emph{MS Windows} builds are downloadable from Nardy's homepage at
 
75
@uref{http://users.skynet.be/bk228456/GNUBgW.htm}
 
76
@emph{GNU/Linux}-Rpm's are available at 
 
77
@uref{http://www,acepoint.de/}. And a download for @emph{MacOSX}
 
78
can be found at @uref{http://mapage.noos.fr/gnubgosx/}.
 
79
 
 
80
 
 
81
@node Do I have to pay for GNU Backgammon?
 
82
@subsection Do I have to pay for GNU Backgammon?
 
83
 
 
84
GNU Backgammon is free software and belongs to the @emph{GNU Project}. For 
 
85
more information see the @uref{http://www.gnu.org/licenses/gpl.html,, GNU
 
86
General Public License}. But be aware that GNU Backgammon is not
 
87
@emph{public domain software} or @emph{shareware} as used in 
 
88
@emph{MS Windows}.
 
89
 
 
90
@node This GNU stuff sounds interesting
 
91
@subsection This GNU stuff sounds interesting
 
92
 
 
93
The best starting point is @uref{http://www.gnu.org,, GNU's homepage}.
 
94
 
 
95
@node Learn more about backgammon
 
96
@subsection Learn more about backgammon
 
97
 
 
98
@uref{http://www.bkgm.com,, Backgammon Galore} is a site that lives up
 
99
to its name. And an extensive collection of links is maintained at
 
100
@uref{http://www.chicagopoint.com/links.html,, Chicago Point links}.
 
101
 
 
102
@node What is Hypergammon?
 
103
@subsection What is Hypergammon?
 
104
Hypergammon is a variety of backgammon with only three checkers for 
 
105
each player. Both players start with their checkers on the 22-/23- and 24-point. 
 
106
Rules a like the original backgammon rules. Winning/Loosing a gammon or 
 
107
backgammon is also possible.
 
108
 
 
109
 
 
110
@node What is Nackgammon?
 
111
@subsection What is Nackgammon?
 
112
Nackgammon is a variety of backgammon with exactly the same rules. The
 
113
only difference is the starting position. Both players take a checker
 
114
from their 6- and 13-point and put them back on the 23-point.
 
115
 
 
116
@node Where do I get more documentation about GNU Backgammon?
 
117
@subsection Where do I get more documentation about GNU Backgammon?
 
118
 
 
119
Albert Silver has written a wonderful tutorial for playing GNU Backgammon
 
120
on @emph{MS Windows}. See @uref{http://www.bkgm.com/gnu/AllAboutGNU-1.0/AllAboutGNU.html} 
 
121
for more details.
 
122
 
 
123
@node I have read all the documentation but I still have questions
 
124
@subsection I have read all the documentation but I still have questions
 
125
 
 
126
Send emails to the @uref{mailto:bug-gnubg@@gnu.org,,
 
127
@gnubg{}-mailinglist}. If you've found a bug, please be sure to include 
 
128
details of your operating system, the version of @gnubg{} you're using and 
 
129
any error messages. Try to describe exactly what is happening before the
 
130
error occurs.
 
131
 
 
132
@node I probably found a bug. What shall I do now?
 
133
@subsection I probably found a bug. What shall I do now?
 
134
Either send an e-mail to the @uref{mailto:bug-gnubg@@gnu.org,, @gnubg{}-mailinglist}, 
 
135
or use the menu @option{Help/Report bug} to fill out an online bug report. Please make
 
136
sure that the bug you found was not reported and/or fixed before.
 
137
 
 
138
 
 
139
@node I have some suggestions and new ideas for improvements
 
140
@subsection I have some suggestions and new ideas for improvements
 
141
 
 
142
Wonderful! Send e-mails to the 
 
143
@uref{mailto:bug-gnubg@@gnu.org,, @gnubg{}-mailinglist}.
 
144
 
 
145
@node This F.A.Q. is full of typos and in bad English.
 
146
@subsection This F.A.Q. is full of typos and in bad English.
 
147
 
 
148
Probably you are right. But you are cordially invited to send
 
149
corrections to @email{info@@gnubg.org}. And keep the following
 
150
quote in mind ;-):
 
151
 
 
152
@cite{Documentation is like sex: when it is good, it is very, very good,
 
153
and when it is bad, it is better than nothing.}
 
154
                    
 
155
 
 
156
 
 
157
@node Installation questions
 
158
@section Installation questions
 
159
 
 
160
@menu
 
161
* Where do I find a version for my operating system?::
 
162
* Do I need additional software to run GNU Backgammon?::
 
163
* Installing newer versions::
 
164
* Compiling it from the source code::
 
165
* What software do I need for compiling under @emph{GNU/Linux}?::
 
166
* What software do I need for compiling under @emph{MS Windows}?::
 
167
* It does not compile::
 
168
@end menu
 
169
 
 
170
@node Where do I find a version for my operating system?
 
171
@subsection Where do I find a version for my operating system?
 
172
 
 
173
@emph{MS Windows} binaries are available at 
 
174
@uref{http://home.online.no/%7Eoeysteij/}. Nardy Pillard has published 
 
175
an excellent page at @uref{http://users.skynet.be/bk228456/GNUBgW.htm,, Windows build}.
 
176
@emph{GNU/Linux}-Rpm's are available at 
 
177
@uref{http://mole.dnsalias.org/~acepoint/} or @uref{http://www.acepoint.de}. 
 
178
And a download for @emph{MacOSX} can be found at @uref{http://mapage.noos.fr/gnubgosx/}.
 
179
 
 
180
@node Do I need additional software to run GNU Backgammon?
 
181
@subsection Do I need additional software to run GNU Backgammon?
 
182
 
 
183
No, everything is included in the binaries.
 
184
 
 
185
@node Installing newer versions
 
186
@subsection  Installing newer versions
 
187
 
 
188
If you are using a @emph{MS Windows} operating system make a copy of
 
189
either @file{.gnubgrc} or @file{.gnubgautorc} and
 
190
@file{.gnubgmenurc}. You will find them in either @file{c:} or the home
 
191
directory of your GNU Backgammon (for instance: @file{c:\program
 
192
files\gnubg\}). After you have installed the new version, copy them
 
193
back.
 
194
 
 
195
If you are working with @emph{GNU/Linux} these files are
 
196
probably in your home directory (@file{~/}). They won't be overwritten
 
197
by installing a new version of GNU Backgammon, but it's always a good
 
198
idea to keep backup files. 
 
199
 
 
200
@node Compiling it from the source code
 
201
@subsection Compiling it from the source code
 
202
 
 
203
@ifnottex
 
204
Good luck to you! Download the source code and read either: @ref{What 
 
205
software do I need for compiling under @emph{GNU/Linux}?}, @ref{What 
 
206
software do I need for compiling under @emph{MS Windows}?}.
 
207
@end ifnottex
 
208
 
 
209
@iftex
 
210
Good luck to you! Download the source code and read either: What software 
 
211
do I need for compiling under @emph{GNU/Linux}, What software do I need for 
 
212
compiling under @emph{MS Windows}.
 
213
@end iftex
 
214
 
 
215
@node What software do I need for compiling under @emph{GNU/Linux}?
 
216
@subsection What software do I need for compiling under @emph{GNU/Linux}?
 
217
 
 
218
Depending on the distribution you are working with:
 
219
 
 
220
@itemize
 
221
@item @uref{ftp://alpha.gnu.org/gnu/gnubg/snapshots/,, GNU Backgammon
 
222
snapshots}
 
223
@item a @emph{"C-"}compiler
 
224
@item autoconf and automake
 
225
@item xdevel (for the graphical interface)
 
226
@item gtk+ >= 1.2 (for the graphical interface)
 
227
@item gtk+-devel
 
228
@item gtkglarea (optional for the 3d-board)
 
229
@item gtkglext (optional for the 3d-board)
 
230
@item python (optional for the python shell)
 
231
@item guile (optional, for invoking your own macros)
 
232
@item guile-devel
 
233
@item gdbm (optional, for using your own databases)
 
234
@item gdbm-devel
 
235
@end itemize
 
236
 
 
237
Unpack the GNU Backgammon snapshots and follow the instructions given in 
 
238
the @file{INSTALL} file.
 
239
 
 
240
@node What software do I need for compiling under @emph{MS Windows}?
 
241
@subsection  What software do I need for compiling under @emph{MS Windows}?
 
242
 
 
243
Nardy Pillards has published an excellent instruction guide for making a
 
244
@uref{http://users.skynet.be/bk228456/GNUBgW.htm,, Windows build}.
 
245
 
 
246
@node It does not compile
 
247
@subsection It does not compile
 
248
 
 
249
@ifnottex
 
250
Check that you've installed all necessary development packages. All you 
 
251
need should be listed in either
 
252
 
 
253
@emph{GNU/Linux}:@ref{What software do I need for compiling under
 
254
@emph{GNU/Linux}?}
 
255
 
 
256
or 
 
257
 
 
258
@emph{MS Windows}:@ref{What software do I need for compiling under
 
259
@emph{MS Windows}?}
 
260
@end ifnottex
 
261
 
 
262
@iftex
 
263
Check that you have installed all necessary development packages. All you 
 
264
need should be listed in either
 
265
 
 
266
@emph{GNU/Linux}: What software do I need for compiling under
 
267
@emph{GNU/Linux}?
 
268
 
 
269
or 
 
270
 
 
271
@emph{MS Windows}: What software do I need for compiling under
 
272
@emph{MS Windows}?
 
273
@end iftex
 
274
 
 
275
Look for warnings or errors during compiling. If you still don't have a
 
276
clue, contact the @uref{mailto:bug-gnubg@@gnu.org,,
 
277
@gnubg{}-mailinglist}.
 
278
 
 
279
@node Gnubg startup questions
 
280
@section Gnubg startup questions
 
281
 
 
282
@menu
 
283
* I get an error message at the start::
 
284
* GNU Backgammon complains about missing files::
 
285
* Starting from the @emph{WinXP} menu it plays like a beginner::
 
286
* My screen mixes up while starting GNU Backgammon::
 
287
* How do I make GNU Backgammon remember the size and place of the windows?::
 
288
* I only get a command-line interface -- where is the nice board?::
 
289
* When I restart GNU Backgammon all my settings are lost::
 
290
* I do not need all the graphics -- where is the command terminal?::
 
291
@end menu
 
292
 
 
293
@node I get an error message at the start
 
294
@subsection I get an error message at the start
 
295
 
 
296
Your computer is trying to tell you something, give it a chance and read the 
 
297
messages. Then read the next items carefully @enddots{} 
 
298
 
 
299
@node GNU Backgammon complains about missing files
 
300
@subsection  GNU Backgammon complains about missing files
 
301
 
 
302
GNU Backgammon is probably missing either the file @file{gnubg.weights}
 
303
or @file{gnubg.bd}. @file{Gnubg.bd} is the bearoff database used to 
 
304
evaluate endgame positions.
 
305
 
 
306
The file @file{gnubg.weights} contains the trained neural net weights
 
307
for most of @gnubg{}'s position evaluators.  Like @file{gnubg.bd}, it should
 
308
be kept in either the current directory or the installed directory.
 
309
 
 
310
@node Starting from the @emph{WinXP} menu it plays like a beginner
 
311
@subsection Starting from the @emph{WinXP} menu it plays like a beginner
 
312
 
 
313
Open the @emph{MS Windows} menu and go to the entry of
 
314
@gnubg{}, then right-click with the mouse and choose
 
315
@option{properties}. Check if the @option{working path} is the same
 
316
directory as the @file{*.exe}-file one line above. If not, adjust the
 
317
working path.
 
318
 
 
319
 
 
320
@node My screen mixes up while starting GNU Backgammon
 
321
@subsection My screen mixes up while starting GNU Backgammon
 
322
 
 
323
Install the newest driver for your graphic card. Be sure that you have
 
324
chosen a desktop resolution of  at least 65535 (16 bit colour depth). If
 
325
your card is an @emph{ATI Rage "something"} there might be some problems 
 
326
with the graphical interface (GTK+) and @emph{MS Windows}.
 
327
 
 
328
@node How do I make GNU Backgammon remember the size and place of the windows?
 
329
@subsection How do I make GNU Backgammon remember the size and place of the windows?
 
330
 
 
331
@node I only get a command-line interface -- where is the nice board?
 
332
@subsection I only get a command-line interface -- where is the nice board?
 
333
 
 
334
@emph{MS Windows} users should click on the correct menu entry (@option{GNU
 
335
Backgammon for windows}). If this doesn't work, check whether you have the 
 
336
file @file{c:\[path-to-your-gnubg]\gnubg.exe}.
 
337
 
 
338
@emph{GNU/Linux} users should check if @uref{http://www.gtk.org/,, GTK+} is
 
339
installed. 
 
340
 
 
341
@node When I restart GNU Backgammon all my settings are lost
 
342
@subsection When I restart GNU Backgammon all my settings are lost
 
343
 
 
344
Did you previously save your settings (menu @option{Settings, Save settings})?
 
345
If you have just installed a newer version of GNU Backgammon go to @ref{Installing
 
346
newer versions}
 
347
 
 
348
@node I do not need all the graphics -- where is the command terminal?
 
349
@subsection I do not need all the graphics -- where is the command terminal?
 
350
 
 
351
For @emph{GNU/Linux} users: open a terminal and start @gnubg{} with the
 
352
option @file{-t}.
 
353
 
 
354
@emph{MS Windows} users: Look for @file{gnubg-no-gui.exe}
 
355
in @gnubg{}'s directory or open the @emph{MS Windows} menu
 
356
@option{execute} and type @file{c:\[path-to-your-gnubg]\gnubg-no-gui.exe}.
 
357
There is also the menu entry @option{GNU Backgammon Command Line Interface}.
 
358
 
 
359
@node Backgammon playing questions
 
360
@section Backgammon playing questions
 
361
 
 
362
@menu
 
363
* What is the difference between starting a new game or match or session?::
 
364
* How do I move the checkers?::
 
365
* Can I place more than 5 checkers on a point?::
 
366
* GNU Backgammon is a poor player::
 
367
* GNU Backgammon plays too strong for me::
 
368
* I think this bot is cheating by rolling better dice::
 
369
@end menu
 
370
 
 
371
@node What is the difference between starting a new game or match or session?
 
372
@subsection What is the difference between starting a new game or match or session?
 
373
 
 
374
When you start a new match you will be asked to play to a certain 
 
375
match length (for example, 7 points). The player who first reaches
 
376
this score wins the match. The default for match play has the Crawford 
 
377
Rule (see @uref{http://www.bkgm.com/glossary.html#crawford_rule,, 
 
378
Backgammon Galore: Crawford rule}).
 
379
 
 
380
Starting a new session means playing an unlimited number of games. You may 
 
381
stop the session at any time and save it. The default for sessions has 
 
382
the Jacoby rule (see 
 
383
@uref{http://www.bkgm.com/glossary.html#jacoby_rule,, Backgammon Galore: 
 
384
Jacoby rule}).
 
385
 
 
386
If you choose to play a new game, GNU Backgammon will open the last
 
387
saved match or session you were previously playing. When there isn't a saved 
 
388
match or session it will start a new unlimited session.
 
389
 
 
390
 
 
391
@node How do I move the checkers?
 
392
@subsection  How do I move the checkers?
 
393
 
 
394
The easiest way to move checkers is to @emph{"drag and drop"}. Put your
 
395
mouse over the checker you wish to move, press and hold the left mouse button
 
396
and drag the checker to the desired point.
 
397
 
 
398
If you simply click then the left mouse button moves a checker the amount 
 
399
shown on the left die, and the right mouse button moves a checker the amount 
 
400
shown on the right die.
 
401
 
 
402
To always display the higher number on the left go to the menu
 
403
@option{Settings, Appearance, General} and activate @option{Show higher
 
404
die on left}.
 
405
 
 
406
@node Can I place more than 5 checkers on a point?
 
407
@subsection  Can I place more than 5 checkers on a point?
 
408
 
 
409
Standard international backgammon tournament rules allow up to all 15 checkers 
 
410
on a single point. If you wish to play with a maximum of 5 checkers, go to 
 
411
the menu @option{Settings} and activate the @option{Egyptian Rule}.
 
412
 
 
413
@node GNU Backgammon is a poor player
 
414
@subsection  GNU Backgammon is a poor player
 
415
 
 
416
Are you sure? If you are then you should @emph{definitely} enter the 
 
417
@uref{http://www.backgammon-tournaments.com/,, Backgammon World Championship} 
 
418
in Monte Carlo!
 
419
 
 
420
Otherwise check whether the file @file{gnubg.weights} is correctly
 
421
installed, also see @ref{GNU Backgammon complains about missing files}.
 
422
 
 
423
@node GNU Backgammon plays too strong for me
 
424
@subsection GNU Backgammon plays too strong for me
 
425
 
 
426
Go to the menu @option{Settings, Players} and change the values of
 
427
@option{Player 0}. There are also some predefined settings you may
 
428
choose from.
 
429
 
 
430
@node I think this bot is cheating by rolling better dice
 
431
@subsection I think this bot is cheating by rolling better dice
 
432
 
 
433
In the menu @option{Settings} you may choose between different random dice
 
434
generators. If you still think GNU Backgammon is cheating, program your
 
435
own dice generator or roll manually.
 
436
 
 
437
@node Settings questions
 
438
@section Settings questions
 
439
 
 
440
@menu 
 
441
* Where can I change the name of the human player?::
 
442
* Where are the player records saved?::
 
443
* Where are all the settings stored?::
 
444
* How do I change the colours?::
 
445
* How do I stop the annoying beeps?::
 
446
* What are "plies"?::
 
447
* What is "noise?"::
 
448
* What is "reduced evaluation"?::
 
449
* Where do I get the images for exporting positons and matches?::
 
450
@end menu
 
451
 
 
452
@node Where can I change the name of the human player?
 
453
@subsection Where can I change the name of the human player?
 
454
 
 
455
Go to the menu @option{Settings, Players ...} and click on @option{Player
 
456
1}. At the top there is a field where you can change the human player's name.
 
457
 
 
458
@node Where are the player records saved?
 
459
@subsection Where are the player records saved?
 
460
The player records are stored in a file called @file{gnubgpr}. On @emph{linux systems}
 
461
this file will be saved in ~/.gnubg/. On @emph{MS Windows} you can find this file in
 
462
the directory of gnubg, i.e. C:\Program Files\Gnubg\. It's alway a good idea to make
 
463
a periodically backup of this file and of @file{.gnubgautorc}.
 
464
 
 
465
@node Where are all the settings stored?
 
466
@subsection Where are all the settings stored?
 
467
The settings are stored in a file called @file{.gnubgautorc}. On linux this file is
 
468
in your home directory, on @emph{MS Windows} in the same directory as the program
 
469
itself.
 
470
 
 
471
@node How do I change the colours?
 
472
@subsection How do I change the colours?
 
473
Go to the menu @option{Settings, Appearance}. Here you may change the colours
 
474
of checkers, points and the board itself.
 
475
 
 
476
@node How do I stop the annoying beeps?
 
477
@subsection How do I stop the annoying beeps?
 
478
 
 
479
Go to the menu @option{Settings, Appearance} and click on the card
 
480
@option{General} at the right. Disable the option @option{Beep on illegal input}.
 
481
 
 
482
@node What are "plies"?
 
483
@subsection What are "plies"? 
 
484
 
 
485
A @emph{ply} describes how far GNU Backgammon evaluates the position. 
 
486
@emph{"0-ply"} means GNU Backgammon estimates the worth of the
 
487
position as it is. A @emph{"1-ply"} evaluation looks one step deeper. 
 
488
GNU Backgammon also evaluates positions that may occur one roll
 
489
further. @emph{"2-ply"} is another roll further and so on.
 
490
 
 
491
The more plies you choose the stronger GNU Backgammon becomes. But
 
492
keep in mind that it will also decrease its playing speed.
 
493
 
 
494
Note that @emph{"0-ply"} in GNU Backgammon is equivalent to the
 
495
@emph{"1-ply"} evaluation of Snowie. 
 
496
 
 
497
@node What is "noise?"
 
498
@subsection What is "noise?"
 
499
 
 
500
Noise is a way of reducing GNU Backgammon's @ref{What are
 
501
"plies"?,, 0-ply} evaluation. Increasing the noise decreases its playing
 
502
strength.
 
503
 
 
504
@node What is "reduced evaluation"?
 
505
@subsection What is "reduced evaluation"?
 
506
 
 
507
It's a method for cutting down the searching for candidate moves to increase 
 
508
speed. Reduced evaluations only work with 2-ply and deeper. 
 
509
 
 
510
@node Where do I get the images for exporting positons and matches?
 
511
@subsection Where do I get the images for exporting positions and matches?
 
512
 
 
513
You may use different images to export positions, sessions or matches into html.
 
514
@emph{GNU Backgammon} creates its own set of images when you go to the menue
 
515
@option{file/export/HTML images ...} and select a path. If you want to use BBS- or
 
516
fibs2html-images, download them from Nardy's page at 
 
517
@uref{http://users.skynet.be/bk228456/GNUBgW.htm}. 
 
518
 
 
519
If you want to export @uref{http://www.gammonline.com,, GammOnline} positions you 
 
520
can do this by using @option{Edit/Copy as/GammOnline (HTML)}. Note that you have to
 
521
download the images from @uref{http://www.gammonline.com/members/imgcopy.htm}. You have
 
522
to be a member for accessing these images.
 
523
 
 
524
 
 
525
@node Analysis questions
 
526
@section Analysis questions
 
527
 
 
528
@menu
 
529
* What is a position ID and match ID?::
 
530
* How do I manually create a position?::
 
531
* How can I remove checkers from the bar?::
 
532
* Which formats can I use to import positions?::
 
533
* Which formats can I use to import matches?::
 
534
* How can I switch the players sides?::
 
535
* What do "!" and "?" mean?::
 
536
* How is the error rate determined?::
 
537
@end menu
 
538
 
 
539
@node What is a position ID and match ID?
 
540
@subsection What is a position ID and match ID?
 
541
 
 
542
You will find two small fields titled @option{Position} and @option{Match
 
543
ID} at the top left of the GNU Backgammon window. Here you may use the
 
544
@option{position_id}- or @option{match_id}-format for setting up or
 
545
copying positions.
 
546
 
 
547
An explanation of both formats will (hopefully soon) follow in GNU 
 
548
Backgammon's documentation.
 
549
 
 
550
@node How do I manually create a position?
 
551
@subsection How do I manually create a position?
 
552
 
 
553
Open a new game, match or session. If @gnubg{} has already rolled the dice,
 
554
don't bother. Press @option{edit} and either type the @ref{What is a 
 
555
position ID and match ID?,, position_id} and press @kbd{Enter}
 
556
on your keyboard. Or use the mouse to arrange the checkers.
 
557
 
 
558
Clicking the mouse on the border of the board removes all checkers. A 
 
559
mouse click on a point then adds a certain number of checkers depending on 
 
560
exactly where you click. For example, to add 5 men on your 6 point, 
 
561
click at the top of your 6 point and it will fill with 5 men. The right mouse
 
562
button will add the men for your opponent's side. To add more than 5 checkers 
 
563
to a point you need to further click on the bottom edge of the fifth checker.
 
564
Click on the the doubling cube to set its position and value.
 
565
 
 
566
Then go to the menu @option{Game, Set turn} and choose the player on
 
567
roll, the dice will then disappear.
 
568
 
 
569
@node How can I remove checkers from the bar?
 
570
@subsection How can I remove checkers from the bar?
 
571
 
 
572
You can remove a chequer from the bar in edit mode by drag and drop
 
573
while holding down the [ctrl] key.
 
574
 
 
575
 
 
576
@node Which formats can I use to import positions?
 
577
@subsection Which formats can I use to import positions?
 
578
 
 
579
Currently only @file{*.pos} from @uref{http://jelly.effect.no/,,
 
580
Jellyfish} are supported.
 
581
 
 
582
@node Which formats can I use to import matches?
 
583
@subsection Which formats can I use to import matches?
 
584
 
 
585
You may import @file{*.mat} from @uref{http://jelly.effect.no/,,
 
586
Jellyfish}, @file{*.ssg} from @uref{http://www.gamesgrid.com/,,
 
587
Gamesgrid} or the @emph{oldmove} format used on
 
588
@uref{http://www.fibs.com,, FIBS}. Also possible now is the @file{*.tmg}
 
589
format of @uref{http://www.truemoneygames.com,, truemoneygames}.
 
590
 
 
591
@node How can I switch the players sides?
 
592
@subsection How can I switch the players sides?
 
593
 
 
594
Go to the menu @option{Game} and select @option{Swap players}.
 
595
 
 
596
@node What do "!" and "?" mean?
 
597
@subsection What do "!" and "?" mean?
 
598
 
 
599
After analysing a game or match GNU Backgammon lists some comments on 
 
600
checker plays and cube decisions. Open the menu @option{Windows,
 
601
Game record} and you will see a list of moves. If any moves or cube
 
602
decisions differ from the best, GNU Backgammon will place a comment next
 
603
to it.
 
604
 
 
605
The default settings are:
 
606
 
 
607
@multitable @columnfractions .40 .30 .25 
 
608
@item +0.040 (very good): @tab  @emph{Not yet in use}
 
609
@item +0.020 (good):      @tab  @emph{Not yet in use}
 
610
@item -0.040 (doubtful):  @tab  @emph{?!}
 
611
@item -0.080 (bad):       @tab  @emph{?}
 
612
@item -0.160 (very bad):  @tab  @emph{??}
 
613
@end multitable
 
614
 
 
615
You may change these comments in the menu @option{Windows, Annotation}, 
 
616
creating other comments for moves and/or cube decisions.
 
617
 
 
618
@node How is the error rate determined?
 
619
@subsection How is the error rate determined?
 
620
 
 
621
GNU Backgammon determines the players strength as follows: If a player
 
622
has an average error (per move) of:
 
623
 
 
624
@multitable @columnfractions .40 .30 .25 
 
625
@item Less than 0.005 ---> @tab @emph{Extra-terrestrial}
 
626
@item Less than 0.010 ---> @tab @emph{World class}
 
627
@item Less than 0.015 ---> @tab @emph{Expert}
 
628
@item Less than 0.020 ---> @tab @emph{Advanced}
 
629
@item Less than 0.025 ---> @tab @emph{Intermediate}
 
630
@item Less than 0.030 ---> @tab @emph{Novice}
 
631
@item More than 0.030 ---> @tab @emph{Beginner}
 
632
@end multitable
 
633
 
 
634
After analysing a game, match or session you can see a summary in the
 
635
menu @option{Analyse, @dots{} statistics}. Note that you cannot change the
 
636
ranges of these values.
 
637
 
 
638
@node Database questions
 
639
@section Database questions
 
640
 
 
641
@menu
 
642
* Which databases are available for GNU Backgammon?::
 
643
* How do I get these databases?::
 
644
* How do I create the bearoff databases?::
 
645
* How do I create the necessary databases for playing Hypergammon?::
 
646
@end menu
 
647
 
 
648
@node Which databases are available for GNU Backgammon?
 
649
@subsection Which databases are available for GNU Backgammon?
 
650
Depending on the release and your settings there are different databases
 
651
available:
 
652
 
 
653
@multitable @columnfractions .40 .30 .25
 
654
@item gnubg_os0.bd ---> @tab One sided bearoff database
 
655
@item gnubg_ts0.bd ---> @tab Two sided bearoff database
 
656
@item hyper1.bd    ---> @tab Database for Hypergammon with one chequers
 
657
@item hyper2.bd    ---> @tab Database for Hypergammon with two chequers
 
658
@item hyper3.bd    ---> @tab Database for Hypergammon with three chequers
 
659
@end multitable
 
660
 
 
661
The default @file{gnubg_os0.bd} one sided bearoff database contains
 
662
the approximative probabilites for bearing off a maximum of 15 chequers on 6 points
 
663
in "n" rolls. The default @file{gnubg_ts0.bd} contains the exact probabilities for 
 
664
a maximum of 6 chequers on 6 points for both sides. For a detailed desciption go to
 
665
Nardy's excellent page at @uref{http://users.skynet.be/bk228456/Bearoff-databases.html}
 
666
 
 
667
The @emph{Hypergammon} databases are for playing hypergammon. You have to create them
 
668
for your own. See @ref{How do I create the necessary databases for playing Hypergammon?}.
 
669
 
 
670
 
 
671
@node How do I get these databases?
 
672
@subsection How do I get these databases?
 
673
 
 
674
Actually the default databases (see above) should be included. For @emph{Linux systems}
 
675
you can also get them at @uref{http://www.acepoint.de/GnuBG/rpm.html}. The windows databases
 
676
can be found here: @uref{http://users.skynet.be/bk228456/dlls_recent_builds.htm}
 
677
 
 
678
@node How do I create the bearoff databases?
 
679
@subsection How do I create the bearoff databases?
 
680
 
 
681
Depending on your operating system it's either:
 
682
 
 
683
@command{makebearoff -o [P] -f [gnubg_os0.bd]} for @emph{linux} with "P"= Number of points
 
684
@command{makebearoff.exe -o [P] -f [gnubg_os0.bd]} for @emph{MS Windows}
 
685
 
 
686
or
 
687
 
 
688
@command{makebearoff -t [P]x[C] -f [gnubg_ts0.bd]} for @emph{linux} 
 
689
with "P"= Number of points and "C"=Number of chequers
 
690
@command{makebearoff.exe -o [P]x[C] -f [gnubg_ts0.bd]} for @emph{MS Windows}.
 
691
 
 
692
Again a detailed description can be found at @uref{http://users.skynet.be/bk228456/Bearoff-databases.html}.
 
693
 
 
694
 
 
695
@node How do I create the necessary databases for playing Hypergammon?
 
696
@subsection How do I create the necessary databases for playing Hypergammon?
 
697
 
 
698
On @emph{linux} it's
 
699
 
 
700
@command{makehyper -f hyper1.bd -c 1}
 
701
@command{makehyper -f hyper2.bd -c 2}
 
702
@command{makehyper -f hyper3.bd -c 3}
 
703
 
 
704
On @emph{MS Windows} it's
 
705
 
 
706
@command{makehyper.exe -f hyper1.bd -c 1}
 
707
@command{makehyper.exe -f hyper2.bd -c 2}
 
708
@command{makehyper.exe -f hyper3.bd -c 3}
 
709
 
 
710
Note that the 3-chequer database will need approximately 400 MB of RAM.
 
711
 
 
712
 
 
713
 
 
714
 
 
715
@node Abbreviations
 
716
@section Abbreviations
 
717
 
 
718
@menu
 
719
* "gwc"?::
 
720
* "mwc"?::
 
721
* "dp"?::
 
722
* "tg"?::
 
723
* "epc?"::
 
724
@end menu
 
725
 
 
726
@node "gwc"?
 
727
@subsection "gwc"?
 
728
 
 
729
"gwc" is an abbreviation for @emph{game winning chances}. 
 
730
 
 
731
@node "mwc"?
 
732
@subsection "mwc"?
 
733
 
 
734
"mwc" is an abbreviation for @emph{match winning chances}.
 
735
 
 
736
@node "dp"?
 
737
@subsection "dp"?
 
738
 
 
739
In the menu @option{Analyse, Game/Match/Session statistics} you will see
 
740
a window with some statistics. Near the bottom are four lines beginning with 
 
741
@option{Missed @dots{} and Wrong @dots{}}.  "dp" means "doubling
 
742
point" and describes a situation in the game where you probably should've
 
743
doubled your opponent.
 
744
 
 
745
@node "tg"?
 
746
@subsection "tg"?
 
747
 
 
748
"tg" is an abbreviation for "too good". It indicates that you probably should have 
 
749
kept the cube and not doubled (because of high gammon chances). 
 
750
 
 
751
@node "epc?"
 
752
@subsection "epc?"
 
753
 
 
754
"Epc" is the abbreviation for "effective pip count". See @ref{Some Backgammon and technical
 
755
terms} for a detailed description.
 
756
 
 
757
 
 
758
@node Some Backgammon and technical terms
 
759
@section Some Backgammon and technical terms
 
760
 
 
761
@menu
 
762
* Effective Pipcount::
 
763
* Kleinman Count::
 
764
* Thorp Count::
 
765
* Jacoby Rule::
 
766
* Crawford Rule::
 
767
* Beaver::
 
768
* Raccoon::
 
769
* Probability::
 
770
* Equity::
 
771
* Standard Deviation::
 
772
* Confidence Intervall::
 
773
* Joint Standard Deviation::
 
774
* Market Window::
 
775
* Gammon Value::
 
776
@end menu
 
777
 
 
778
@node Effective Pipcount
 
779
@subsection Effective Pipcount
 
780
 
 
781
The @emph{effective pipcount} (epc) is the result of average rolls you need 
 
782
to bearoff a chequer in a one chequer race  muliplied with the average roll (8.167). 
 
783
The @emph{wastage} is calculated as the result of epc - pipcount.
 
784
 
 
785
An example:
 
786
 
 
787
@example
 
788
Player A: 5 chequers on his 1-point, 4 chequers on his 2-point
 
789
Pipcount: 5x1 + 4x2 = 13
 
790
Epc:      2.189 (Average rolls) x 8.167 = 17.878
 
791
Wasted:   17.878 - 13 = 4.878
 
792
@end example
 
793
 
 
794
It's easy to see that your wastage arises the more chequers you have on lower points (i.e.
 
795
you roll a 6 to bear off a man from the 2- or 1-point.
 
796
 
 
797
 
 
798
@node Kleinman Count
 
799
@subsection Kleinman Count
 
800
 
 
801
The @emph{Kleinman Count} is another calculation in longer bearoff situations.
 
802
The formula is DxD/S, where "D" is trailers pipcount + 4 - leaders pipcount, and
 
803
"S" is the sum of leaders and trailers pipcount -4.
 
804
 
 
805
If the result of DxD/S is round about 1.2, then the leader has a double and the
 
806
trailer a close take. Get more informations about the @emph{Kleinman Count} at
 
807
@uref{http://www.bkgm.com/rgb/rgb.cgi?menu+cubehandlinginraces}
 
808
 
 
809
 
 
810
@node Thorp Count
 
811
@subsection Thorp Count
 
812
 
 
813
@emph{Thorp Count} is a mathematical method to calculate cube decisions in tricky 
 
814
bearoffs:
 
815
 
 
816
@enumerate
 
817
@item Count the leaders (L) and the trailers (T) pipcount.
 
818
@item Add an extra point for every checker on the acepoint (L1) and (T1).
 
819
@item Deduct an extra point for every possessed home board point (L2) and (T2).
 
820
@item Add two extra points for every remaining checker (L3) and (T3).
 
821
@item If the resulting leaders count (L3) equals 30 or is greater than 30 add 10% ((L4).
 
822
@end enumerate
 
823
 
 
824
@itemize @bullet
 
825
@item If (L4) - 2 equals (T3) it is an initial double and a take.
 
826
@item If (L4) - 1 equals (T3) it is a redouble and a take.
 
827
@item If (L4) + 2 is less than (T3) it is a pass.
 
828
@end itemize
 
829
 
 
830
Get more informations about @emph{Thorp Count} at 
 
831
@uref{http://www.bkgm.com/rgb/rgb.cgi?menu+cubehandlinginraces}
 
832
 
 
833
@node Jacoby Rule
 
834
@subsection Jacoby Rule
 
835
 
 
836
The @emph{Jacoby rule} is used in backgamon sessions or moneygame. This rule implies,
 
837
that a player can't win an undoubled gammon (meaning: when the cube is still in the middle).
 
838
This rule was established to protect players from "boring" games while watching his opponent
 
839
trying to win a gammon and getting doubled out if this doesn't succeed. For more information 
 
840
see @uref{http://www.bkgm.com/glossary.html,, Backgammon Galore}.
 
841
    
 
842
 
 
843
@node Crawford Rule
 
844
@subsection Crawford Rule
 
845
 
 
846
The @emph{Crawford rule} is only used in match play. It implies, that a player cannot
 
847
double in the first game after his opponent has reached a score needing only 1
 
848
point to win the match. See also @uref{http://www.bkgm.com/glossary.html,, 
 
849
Backgammon Galore}.
 
850
 
 
851
 
 
852
@node Beaver
 
853
@subsection Beaver
 
854
A @emph{beaver} is only allowed in session games (also known as @emph{money 
 
855
games}). To @emph{beaver} means redoubling (and keeping the cube) rather than 
 
856
just accepting when your opponent has doubled (see
 
857
@uref{http://www.bkgm.com/glossary.html,, Backgammon Galore: 
 
858
beavers}.
 
859
 
 
860
@node Raccoon
 
861
@subsection Raccoon
 
862
 
 
863
When you doubled your opponent, and he makes use of the @emph{beaver} you are allowed
 
864
to turn around the cube again. This is called a @emph{raccoon}.
 
865
 
 
866
 
 
867
@node Probability
 
868
@subsection Probability
 
869
 
 
870
The @emph{probability} describes the likelihood of an event's outcome. If you, i.e., flip
 
871
a coin the probability getting "head" will be 50% or 0.5 [going from 0-1]. Getting a certain
 
872
number on a die with numbers from one to six is 1/6 or 0.166 or 16%. 
 
873
 
 
874
An example in backgammon:
 
875
 
 
876
Assume that you have one chequer on your 2-point and one on your 5-point. Your opponent has two
 
877
chequers on his acepoint, but fortunately you are on roll. What is your probability to win?
 
878
 
 
879
@example
 
880
19 rolls (66, 65, 64, 63, 62, 55, 54, 53, 52, 44, 33, 22) 
 
881
will take both chequers off, 17 rolls will not.
 
882
@end example
 
883
 
 
884
Your probability is 
 
885
 
 
886
@example
 
887
19/36 = 52,8% or 0.528
 
888
@end example
 
889
 
 
890
to win the bearoff.
 
891
 
 
892
@node Equity
 
893
@subsection Equity
 
894
 
 
895
@emph{Equity} in backgammon is the number of points you expect to win in a certain position.
 
896
 
 
897
Take the same example from above. Your equity will be:
 
898
 
 
899
@example
 
900
(19x1 (w) + 0x2 (g) + 0x3 (bg) - 17x1 (l) - 0x2 (lg) - 0x3 (lbg))/36 
 
901
= 2/36 = 1/18 = 0.056.
 
902
@end example
 
903
 
 
904
Every time you play this position for a dollar you are expected to win 5.6 Cent. If you play
 
905
this position a hundred times your gain will be (theoretical) 5.6 dollar.
 
906
 
 
907
 
 
908
@node Standard Deviation
 
909
@subsection Standard Deviation
 
910
 
 
911
This is more difficult and best explained by an example. Let's assume you roll a die 10 times.
 
912
The result is
 
913
 
 
914
@example
 
915
3,6,6,1,2,5,4,6,5,2
 
916
@end example
 
917
 
 
918
Add up all numbers and divide them by 10 (the number of rolls).
 
919
You'll then get an arithmetic mean of 
 
920
 
 
921
@example
 
922
40/10 = 4
 
923
@end example
 
924
 
 
925
Of course this differs from the expected value of 
 
926
 
 
927
@example
 
928
3.5 = (1 + 2 + 3 + 4 + 5 + 6)/6
 
929
@end example
 
930
 
 
931
The variance of our example is calculated as:
 
932
 
 
933
@example
 
934
( (3-4)^2 + (6-4)^2 + (6-4)^2 + (1-4)^2 + (2-4)^2 + 
 
935
+ (5-4)^2 + (4-4)^2 + (6-4)^2 + (5-4)^2 + (2-4)^2 )/10
 
936
 
 
937
= (1 + 4 + 4 + 9  + 4 + 1 + 0 + 4 + 1 + 4)/10 = 3.2 
 
938
@end example
 
939
 
 
940
and is a measure for how far single events differ from the arithmetic mean. The standard deviation is the
 
941
square root of the variance, here it is 
 
942
 
 
943
@example
 
944
3.2^1/2 = 1.79 
 
945
@end example
 
946
 
 
947
Transferred to our backgammon example from above let's assume you don't know anything about
 
948
the calculated probability we have done before (or imagine a position that can't be exactly
 
949
calculated). You play this position with a friend a hundred times, you win 58 games and loose 
 
950
42 games. This will give you an equity of
 
951
 
 
952
@example
 
953
(58-42)/100 = 0.16
 
954
@end example
 
955
 
 
956
But how sure can you be that 0.16 is the "true" equity of this position? Perhaps you will loose 6 points
 
957
in another session of 100 games. Let's calculate the standard deviation of our result.
 
958
 
 
959
@example
 
960
 
 
961
@end example
 
962
 
 
963
 
 
964
@node Confidence Intervall
 
965
@subsection Confidence Intervall
 
966
 
 
967
 
 
968
 
 
969
 
 
970
@node Joint Standard Deviation
 
971
@subsection Joint Standard Deviation
 
972
 
 
973
 
 
974
 
 
975
 
 
976
@node Market Window
 
977
@subsection Market Window
 
978
 
 
979
A @emph{market window} is the range between the point of "first double" and
 
980
"last take". In moneygames it's usually between 50% - 75% winning chances 
 
981
depending on the value of the cube. In matches this range may extremely differ.
 
982
 
 
983
 
 
984
@node Gammon Value
 
985
@subsection Gammon Value 
 
986
In money games the @emph{gammon value} is usually 0.5. This means that you have
 
987
to win twice as much gammons than loosing games to justify a certain move 
 
988
compared to another candidat. In matches this may also extremely differ depending
 
989
on the match score. 
 
990