<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.docbook.org/xml/4.4/docbookx.dtd">
<article lang="en">
  <articleinfo>
    <title>All about GNU Backgammon</title>
    <copyright>
      <year>-2007</year>
      <holder>Albert Silver</holder>
    </copyright>
    <copyright>
      <year>2007</year>
      <holder>Christian Anthon</holder>
    </copyright>
    <publisher>
      <publishername> GNU Project </publishername>
    </publisher>
    <authorgroup>
      <author>
        <firstname>Albert</firstname>
        <surname>Silver</surname>
        <affiliation>
          <orgname>GNU Backgammon Project</orgname>
          <address format="linespecific">
            <email>silver_albert@hotmail.com</email>
          </address>
        </affiliation>
      </author>
      <author>
        <firstname>Christian</firstname>
        <surname>Anthon</surname>
        <affiliation>
          <orgname>GNU Backgammon Project</orgname>
          <address format="linespecific">
            <email>congoneser@gmail.com</email>
          </address>
        </affiliation>
      </author>
    </authorgroup>
    <revhistory>
      <revision>
        <revnumber>All about GNU Backgammon</revnumber>
        <date>Marts 2007</date>
        <revdescription>
          <para role="publisher">The GNU Backgammon Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>All about GNU</revnumber>
        <date>Marts 2007</date>
        <revdescription>
          <para role="publisher">Albert Silver and Tom Keith</para>
        </revdescription>
      </revision>
    </revhistory>
    <releaseinfo>This is the GFDL docbook version of Albert Silver's introduction to GNU Backgammon. </releaseinfo>
    <legalnotice>
      <title>Feedback</title>
      <para>To report a bug or make a suggestion regarding the <application moreinfo="none">GNU Backgammon</application> application or this
        manual, send your suggestions to <email>bug-gnubg@gnu.org</email> or
        make a <ulink url="https://savannah.gnu.org/bugs/?group=gnubg">bug
          report</ulink>.</para>
      <para> Permission is granted to copy, distribute and/or modify this
        document under the terms of the GNU Free Documentation License, Version
        1.2 or any later version published by the Free Software Foundation; with
        no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
        copy of the license is included in <xref linkend="legal"/>. </para>
    </legalnotice>
  </articleinfo>
  <sect1 id="Acknowledgments" xreflabel="Acknowledgments">
    <title>Acknowledgments</title>
    <para>This manual is largely identical to Albert Silver's excellent <ulink url="http:http://www.bkgm.com/gnu/AllAboutGNU.html">introduction</ulink> to GNU Backgammon, which may be found on Tom Keith's <ulink url="http://www.bkgm.com">backgammon site</ulink>.</para>
  </sect1>
  <sect1 id="Introduction" xreflabel="Introduction">
    <title>Introduction</title>
    <para>By now, it's fairly common knowledge that just about all the top players make use of the neural-net backgammon programs such as Snowie, or the older Jellyfish. The impact these programs have had on the way the game is understood and played cannot be overstated. Players of all levels have the option of purchasing these revolutionary <emphasis>bots</emphasis> (short for robots) in order to not only have the pleasure of getting a drubbing by a world-class opponent as many times as they want, but also have it analyze their moves, games, and matches. The program will point out our mistakes, tell us how big a blunder our move was, and list the best moves. It is still up to us to understand why our move or cube action was wrong, however there is no question such a tool is priceless. </para>
    <para>Perhaps <emphasis>priceless</emphasis> is a poor choice of words as the price is by no means a given. Though the programs come with different options depending on how much one is willing to spend, a version with all the trimmings, such as importing one's matches, analyzing the games, grading your play, allowing rollouts, etc. will set you back no less than $380 for Snowie or <emphasis>only</emphasis> $220 for the older, and less sophisticated Jellyfish. This would seem to indicate that a top-quality aide is only in reach of someone with deep pockets or a deep commitment. If not, one has to look at some of the free offerings available on the Internet.</para>
    <para>Personally, when I first heard of GNU Backgammon, I immediately remembered with a grimace my first experience with an old version of GNU Chess several years earlier: an engine that barely played at an expert level, as opposed to other master-level programs, an absolute bare minimum in functions, and graphics that reminded me of my first Atari video game system from back in 1977. The surprise that awaited me couldn't have been greater.</para>
    <para>GNU Backgammon is first of all a neural-net program of World-Class strength. It is based on the same technology from which Jellyfish and Snowie originated. </para>
    <informaltable frame="all">
      <tgroup cols="1">
        <tbody>
          <row>
            <entry>
              <para>Neural Net technology</para>
              <para>The concept of neural-net technology is what permitted the breakthrough in playing levels from <emphasis>interesting amateur</emphasis> to <emphasis>world-class</emphasis> playing literally on par with the best in the world. The person behind this <ulink url="http://researchweb.watson.ibm.com/massive/tdl.html">brilliant idea</ulink> is Gerald Tesauro, a researcher for IBM, who built the first neural-net program called TD-Gammon. The difference it brought was that instead of simply using weights and strategies of programmers and players, it created its own by playing against itself hundreds of thousands of times, with each version stronger than the previous one. By version 2.1, which had played 1.5 million games, two-time World Champion Bill Robertie declared it as good as a strong master and even wrote a book on the experience called <ulink url="http://bkgm.com/books/Robertie-LearningFromTheMachine.html">Learning from the Machine</ulink>. In fact, because of its independent learning, its play and that of subsequent programs using neural-net technology have revealed revolutionary strategic knowledge of the game from which top modern practice is based. GNU Backgammon is among those neural-net giants, and is among the top programs in the world.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
  </sect1>
  <sect1 id="Features" xreflabel="Features">
    <title>Features</title>
    <sect2 id="How_strong_is_GNU_Backgammon" xreflabel="How strong is GNU Backgammon">
      <title>How strong is GNU Backgammon?</title>
      <para>On <ulink url="http://www.gamesgrid.com/">Gamesgrid</ulink>, the famous online server where many of the world's best play, a bot called GGRaccoon, using the GNU 0.13 engine and playing on a weaker setting so that it plays instantly, has achieved a rating as high as 2165 and is a favorite sparring partner of the top players there.</para>
      <para>A match was also done using Tony Lezard's <ulink url="http://www.jobstream.com/~tony/backgammon/">Dueller</ulink> software where GNU 0.13 played 100 7-point matches against Snowie 4 using their ideal settings. Although GNU won with a convincing 56-44, subsequent analysis, taking into account the luck factor, revealed that they were of exactly the same strength. GNU 0.14 is 1.18% stronger at 0-ply (the setting of GGRaccoon) than GNU 0.13 at 0-ply in money games.</para>
      <para>GNU is made of 3 neural nets: the contact net which is the main net for middlegame positions, the crashed net, and the race net which is so that GNU does not suffer from the common bane of backgammon programs: the non-contact bearin. For more information on how the neural nets were developed, see Joseph Heled's (the developer) site <ulink url="http://pages.quicksilver.net.nz/pepe/ngb/index.html">The GNU Backgammon Training Program</ulink>. Be sure to select full instead of concise at the bottom left of the site if you do visit it.</para>
    </sect2>
    <sect2 id="Brief_feature_list" xreflabel="Brief feature list">
      <title>Brief feature list</title>
      <para>Aside from offering an analytical engine of the highest order, the program's interface provides a very impressive number of features for users, many of which are not available in commercial programs. It's worth mentioning that GNU Backgammon is also available for MacOS, Solaris, Linux, and other operating systems. There are also programs using the GNU engine running on <ulink url="http://bglightce.homelinux.net/">Pocket PC PDAs</ulink>, and the <ulink url="http://www.nongnu.org/bglight/">source</ulink> is available to be ported to PDAs. </para>
      <orderedlist>
        <listitem>
          <para>Import and export one's games and matches from other sources such as FIBS, Gamesgrid (it imports comments as well), and TrueMoneyGames.</para>
        </listitem>
        <listitem>
          <para>Analyze a game or entire match with a detailed report, including your rating and even the equivalent Snowie error rate.</para>
        </listitem>
        <listitem>
          <para>Keeps track of your results in the Player Record</para>
        </listitem>
        <listitem>
          <para>Rollouts galore with checker play according to score and extensive customizable options.</para>
        </listitem>
        <listitem>
          <para>Setting up of positions.</para>
        </listitem>
        <listitem>
          <para>Export to text documents (with diagrams) and PDF documents.</para>
        </listitem>
        <listitem>
          <para>Export to HTML customizing the information exported and the graphics used.</para>
        </listitem>
        <listitem>
          <para>Copy board and analysis to the Windows clipboard for easy pasting elsewhere.</para>
        </listitem>
        <listitem>
          <para>Numerous ready-made board designs plus the option to make one's own.</para>
        </listitem>
        <listitem>
          <para>Several skins available.</para>
        </listitem>
        <listitem>
          <para>Bearoff databases (both two-sided and one-sided), and tools to make one's own, however large (up to the 12-point, 13-point, etc.).</para>
        </listitem>
      </orderedlist>
      <para>Advanced players will also find a wealth of options to help in their study of the game: </para>
      <orderedlist>
        <listitem>
          <para>Choose between no less than 12(!) Match Equity Tables such as Woolsey's, Trice and Jacobs, or even the Snowie table, not to mention some newer more precise ones. You can also create your own to use instead.</para>
        </listitem>
        <listitem>
          <para>A Temperature Map to visualize the dangers and jokers of a move as well as the volatility of cube decisions.</para>
        </listitem>
        <listitem>
          <para>Kleinman counts and Thorp counts.</para>
        </listitem>
        <listitem>
          <para>Gammon Values and a powerful Market Value viewer showing the values of take points, cash point, beavers, etc. including separate values for a dead cube or live cube.</para>
        </listitem>
      </orderedlist>
      <para>What follows is a tutorial intended to present most of what GNU Backgammon has to offer, though not exhaustively so, and how to make the most of it. </para>
    </sect2>
  </sect1>
  <sect1 id="Where_to_get_it" xreflabel="Where to get it">
    <title>Where to get it</title>
    <para>The official site of GNU Backgammon is either <ulink url="http://www.gnu.org/software/gnubg/">http://www.gnu.org/software/gnubg/</ulink> or <ulink url="http://www.gnubg.org/">http://www.gnubg.org</ulink> though to download an installable version of the program, you'll want to go to the second site. Go there and select Download </para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/md9b1995.png"/>
      </imageobject>
    </mediaobject>
    <para>And then the version (Windows, Mac OS X, Linux, etc.) you want. </para>
  </sect1>
  <sect1 id="Playing_a_game" xreflabel="Playing a game">
    <title>Playing a game</title>
    <para>The first and most basic feature is to simply set up a game and play, so let's start with that. Start the program and maximize the window. If the appearance isn't to your liking, you will find out how to customize it further below. </para>
    <sect2 id="Starting_a_game" xreflabel="Starting a game">
      <title>Starting a game</title>
      <para>To start a game, just click on the New button <inlinegraphic fileref="images/5412263e.png"/> and a small window will open </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m259fcca6.png"/>
        </imageobject>
      </mediaobject>
      <para>so you can set your choice of a game, match, or money game session, as well as whether you want to use Manual dice, or activate the Tutor mode. When you are playing, it will automatically show the pip count (and difference), though you can de-activate it by going to Settings menu and in Options, under the Display tab</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/51394706.png"/>
        </imageobject>
      </mediaobject>
      <para>uncheck the box Show pip count below board. If you want to only refer to it on occasion, for example to test your own estimation, go to the Analyze menu, select Pip count, and the count will appear at the bottom left.</para>
      <sect3 id="Rolling_dice_and_doubling" xreflabel="Rolling dice and doubling">
        <title>Rolling dice and doubling</title>
        <para>To roll the dice, simply click on the empty space of the board on the right side. The same goes for doubling, where you can just click on the cube on the board.</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m7cee1bfc.png"/>
          </imageobject>
        </mediaobject>
        <para>After you've rolled the dice, just clicking on a checker will have GNU play the highest number with it, and after with a second checker or the same one, it will play the lower number. GNU will also help you see where the pieces can go. Just click on a piece and start to drag it. You will see the possible landing squares highlight in green.</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m3a7e4f1b.png"/>
          </imageobject>
        </mediaobject>
        <para>If you would like the programs analysis of a move or cube decision while playing, go to the Analyze menu and select Hint, or press the keyboard shortcut Ctrl-H. For details on the Hint/Annotation window, see below. </para>
        <tip>
          <para>You can also play GNU with a full-screen 3D board and 3D dice rolling. See <xref linkend="Board_designs___2D_and_3D"/> and <xref linkend="Full_Screen_Board"/> for more on that.</para>
        </tip>
      </sect3>
      <sect3 id="Toolbar" xreflabel="Toolbar">
        <title>Toolbar</title>
        <para>While playing, you can access the main functions through the toolbar at the top:</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m215edfe5.png"/>
          </imageobject>
        </mediaobject>
        <para>The functions from left to right are: </para>
        <orderedlist>
          <listitem>
            <para>New – to start a new game </para>
          </listitem>
          <listitem>
            <para>Open – to open a saved match or position </para>
          </listitem>
          <listitem>
            <para>Import – to import a game/match from another source, such as FIBS, Gamesgrid, or Truemoneygames.</para>
          </listitem>
          <listitem>
            <para>Save – to save a game or position in the program's native format.</para>
          </listitem>
          <listitem>
            <para>Export – to export the game to HTML or another format</para>
          </listitem>
          <listitem>
            <para>Accept and Decline – In case a double or redouble is offered.</para>
          </listitem>
          <listitem>
            <para>Beaver – allows you to beaver in case a double or redouble is offered in a money game.</para>
          </listitem>
          <listitem>
            <para>Resign – to resign, though GNU will refuse an offer for a single game if there is a chance for a gammon still.</para>
          </listitem>
          <listitem>
            <para>Undo – if you haven't clicked on the dice yet, and want to change your move.</para>
          </listitem>
          <listitem>
            <para>Hint – to ask the program's considerable opinion</para>
          </listitem>
          <listitem>
            <para>Edit – to change the names of the players, or the position.</para>
          </listitem>
          <listitem>
            <para>Direction – to change the direction the checkers move.</para>
          </listitem>
          <listitem>
            <para>Stop – to stop the program if it is analyzing or doing a rollout. </para>
          </listitem>
        </orderedlist>
      </sect3>
      <sect3 id="Human_vs._Human" xreflabel="Human vs. Human">
        <title>Human vs. Human</title>
        <para>You may wish to use GNU to keep track of a game or match against a friend, and play directly on the program, or you may wish to enter a game from another source such as a book or a videotape for safekeeping and analysis. Start a game by clicking on the New button. In the window, select Human vs. Human. Select Manual dice if you want to enter the dice played, and not have GNU roll them.</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/38371a4c.png"/>
          </imageobject>
        </mediaobject>
        <para>If you want to change the direction of the play (ex: left to right), just click on the Reverse Direction <inlinegraphic fileref="images/1540d81e.png"/> button. You can set/change whose turn it is to play by clicking on the small checker next to the player's name at the bottom. </para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m2b86c3ea.png"/>
          </imageobject>
        </mediaobject>
        <para>You can also set the turn of the player to move in the Game menu and by selecting Set turn at the bottom. </para>
        <para>To enter the moves, just play as you normally would against the program: clicking on the board to roll the dice, selecting the dice rolled, and then playing the move. If you make a mistake and enter the wrong dice, just go to the Game menu again and select Set dice.</para>
        <para>If you make a mistake in the move played, and want to correct this, go to the Game Record (the move list), click on the move you want to change,</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/78be1dd5.png"/>
          </imageobject>
        </mediaobject>
        <para>replay it, and continue from there. It will automatically erase the moves after. If you also want to change the dice rolled, click on the move, then press the Edit button on the toolbar, click on the dice, select the dice you want, press the Edit again, and continue from there.</para>
        <para>If you wanted to double, the simplest way is to click on the move before, re-enter it, and then double. GNU will automatically continue the game with your change and erase the moves that came after.</para>
        <para>If you don't see the move list, go to the View menu, and select Game Record.</para>
        <tip>
          <para>Don't forget to save your results regularly (press the Save button) so you don't lose important information by accident.</para>
        </tip>
      </sect3>
    </sect2>
    <sect2 id="Player_strength" xreflabel="Player strength">
      <title>Player strength</title>
      <para>First set the settings by clicking on the Settings menu at the top, then click on Players. This opens a window displaying the settings for GNU or allowing you to play against someone else (or even have GNU play against itself). At the top there is a tab where you can also set your name for the player. For the GNU engine, I prefer the pre-defined setting of Supremo or World Class for both checker play and cube decisions. At this setting it will take some time to play at given moments which may not be to the taste of everyone, so if you want a top-notch game, just a fraction worse, but almost instant, select Expert instead. You may also get tired of getting beat up by it (if you think it cheats, read the section <xref linkend="A_Word_about__Cheating_"/>), in which case, you can select more modest playing levels.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/48d8024f.png"/>
        </imageobject>
      </mediaobject>
      <para>If you are a Snowie user, or have seen Snowie's analysis, you may wonder why my recommended level of play (Supremo) is set at 2-ply when Snowie's strongest setting is at 3-ply. The reason is simply one of nomenclature, or naming. Snowie starts counting at 1-ply whereas GNU starts at 0-ply, so the program's 2-ply is in fact the same search depth as Snowie's 3-ply.</para>
      <sect3 id="Move_Filter" xreflabel="Move Filter">
        <title>Move Filter</title>
        <para>The move filter allows you to control exactly how many moves GNU is examining at each ply. A ply is basically one move played by one side, thus if both sides played a move, it would be one whole move, but two plies, one for each side. To change the specific settings, press the Modify... button.</para>
        <para>Although the level presets, such as World Class, Supremo, etc. are tested and good, you may want to know or control how GNU filters its moves to analyze and how many. </para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/e613071.png"/>
          </imageobject>
        </mediaobject>
        <para>If you are playing Expert level (this is what GGRaccoon is set at) or another 0-ply setting, the Move Filter settings will not change a thing, as Expert level automatically examines all moves. At Supremo level, this changes though, as it takes a selection of the best moves from 0-ply and examines them at 2-ply. This means that for those selected moves it will calculate all the possibilities 2 plies ahead and evaluate them, allowing it to find better moves. Since Supremo is a 2-ply setting, we are only interested in the 2-ply settings of Large as in the figure above. 3-ply or 4-ply settings will have no effect here because Supremo doesn't examine at that depth. </para>
        <para>In the figure above, we can see it first will Always accept 0 moves. This first line means that it won't force any moves to be analyzed at 2-ply, it will only analyze moves according to the second line. If it had said it would always analyze 2 moves, this would mean that no matter how ridiculously bad the 2nd move was compared to the 1st, it would analyze both at 2-ply. </para>
        <para>The second line says it will Add extra 16 moves within 0.320. This means that provided they aren't more than 0.320 equity worse than the top move, it will select a maximum of 16 moves to analyze at 2-ply. For example, in the diagram below</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m4149eeab.png"/>
          </imageobject>
        </mediaobject>
        <para>the 2nd best move is no less than 0.453 equity worse than the top choice, so it didn't bother analyzing them at 2-ply as it is unlikely to change its mind on what the best move is. </para>
        <para>Take a look at the figure below now:</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m4ed24f10.png"/>
          </imageobject>
        </mediaobject>
        <para>Here, the exact same settings were maintained, but the 1-ply filter was activated. This just means that those 16 moves selected from the 0-ply are sent instead to be analyzed at 1-ply, and then up to 5 moves from 1-ply will be sent to be analyzed at 2-ply. So this would actually be faster than the previous setting (and weaker), since a maximum of only 5 moves would be analyzed at 2-ply depth.</para>
        <tip>
          <para>Feel free to experiment with the settings, as you can always reset them by simply choosing one of the level presets. One setting change I'd recommend is that of the 4-ply. The default setting only considers 2 moves if they are within 0.040 equity of each other. While I trust the program's analysis, there is often more than one move within that range, and I wouldn't want it to miss analyzing one because it is instructed to only look at two moves. I set the filter as in the diagram below: </para>
        </tip>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/4bd6c15f.png"/>
          </imageobject>
        </mediaobject>
        <para>Before going any further, do not forget to click on Save settings at the bottom of the Settings menu. You must do this every time you make changes you wish the program to remember the next time you load it.</para>
      </sect3>
    </sect2>
    <sect2 id="Playing_options_and_Tutor" xreflabel="Playing options and Tutor">
      <title>Playing options and Tutor</title>
      <para>In the Settings menu, select Options, and a small window opens. Here, you can activate automatic bear-off (it will automatically take off the most checkers if it can sparing you the effort of playing obvious moves), choose the equity table to be used (Woolsey's, Snowie's, etc.), select Nackgammon, choose to play with manual dice (you play with your own personal dice instead of the computer's) AND a great teaching tool: the Tutor Mode.</para>
      <para>When activated, the Tutor mode has GNU analyzing your moves and/or cube decisions and comparing them with its choices. You set the threshold for its alerts, so if you set it for bad, it will only warn you when you make a bad mistake. It will then allow you to re-examine your choice, go right ahead with it, or provide a <emphasis>hint</emphasis> essentially showing you its analysis. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/58c77df2.png"/>
        </imageobject>
      </mediaobject>
      <para>My personal choices are to set the limit to bad, and to set the Tutor decisions as Same as Analysis. </para>
      <tip>
        <para>Before going any further, do not forget to click on Save settings at the bottom of the Settings menu. You must do this every time you make changes you wish the program to remember the next time you load it.</para>
      </tip>
    </sect2>
    <sect2 id="Backgammon_variations" xreflabel="Backgammon variations">
      <title>Backgammon variations</title>
      <para>Backgammon has a number of variations, some of which are quite popular on the servers. The main ones are Nackgammon and Hypergammon, both of which are supported by the program, as well as an Eastern variation of the rules not allowing more than 5 checkers on a single point. GNU is also capable of directly importing and recognizing Nackgammon and Hypergammon games played on the servers for analysis.</para>
      <orderedlist>
        <listitem>
          <para>Nackgammon – This variation of backgammon conceived by Nick "Nack" Ballard has two checkers removed from the 6 and 13 points and places them in the opponent's board to form a second anchor. Play follows standard backgammon rules and games are naturally longer. It is considered a more strategic struggle, with luck influencing less than normal backgammon. To play a game of Nackgammon against the program, go to the Settings menu and then select Options.</para>
        </listitem>
      </orderedlist>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m68ad25e2.png"/>
        </imageobject>
      </mediaobject>
      <para>Under the tab Game, select Standard backgammon with Nackgammon starting position. This way it will set up a game of Nackgammon instead of normal backgammon.</para>
      <para>Hypergammon – Hypergammon is a very different game, though it too follows the standard rules of backgammon. In it, each player starts with only 3 checkers in the opponent's board and must of course cross the board and bear them off as in normal backgammon. To play Hypergammon in GNU you must first build the Hypergammon databases using the tool makehyper.exe or you can download the bases <ulink url="ftp://ftp.demon.nl/pub/games/gnubg/databases/hyper">here</ulink>.</para>
    </sect2>
  </sect1>
  <sect1 id="Advanced_Playing_Information" xreflabel="Advanced Playing Information">
    <title>Advanced Playing Information</title>
    <para>For players seeking more advanced information on the position, GNU also provides information on the Match Equity Table (MET), race theory (Kleinman count, Thorp count), a powerful Market Window/Gammon value viewer, and a new tool called the Temperature Map courtesy of <ulink url="http://www46.pair.com/sengoku/TempMap/English/TempMap.html">Sho Sengoku</ulink>.</para>
    <sect2 id="Match_Equity_Table" xreflabel="Match Equity Table">
      <title>Match Equity Table</title>
      <para>The Match Equity Table can be viewed at any moment by entering the Analyze menu and selecting Match Equity Table. There you will see table values including Pre-Crawford and Post-Crawford scores. The table used by GNU is by no means imposed, and you can select any of a number of provided ones, including the Snowie MET, Woolsey's, Jacob and Trice's, etc. by selecting Load Table. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/33d3487.png"/>
        </imageobject>
      </mediaobject>
      <para>In the window that opens, enter the met directory on the right, and then on the right choose the table you want. The tables all end with the .XML extension, so to select the Jacobs and Trice table, choose jacobs.xml. Again, don't forget to save the settings (<menuchoice><guimenu>Settings</guimenu><guimenuitem>Save Settings</guimenuitem></menuchoice>) otherwise it won't remember your choice of table the next time you use the program. </para>
      <informaltable frame="all">
        <tgroup cols="1">
          <tbody>
            <row>
              <entry>
                <para>Match Equity Tables</para>
                <para>The use and knowledge of Match Equity Tables, or METs, in match play is well understood by experienced players. If 25% is the limit to take a double in a money game, ignoring cube revig, in a match this changes enormously according to score. The most famous and popular MET is probably that by Kit Woolsey and Hal Heinrich. However, quite a number have been developed by notable players and researchers, each seeking to get a little closer to playing perfection. GNU allows you to select the MET of your choice, and also includes several you may not be familiar with, with mysterious names such as g11 or Mec26. The first thing to realize is that the Woolsey/Heinrich table is based on a 20% gammon rate, and the bots have clearly shown by today that a more appropriate gammon rate is around 26%. Both the g11 and Mec26 tables use such a rate, though g11 is probably even more precise, as the values up to an 11-point match were generated from extensive rollouts by the program, and the scores above refer to the Mec26 table. For an expert opinion on the subject, allow me to refer to <ulink url="http://www.chicagopoint.com/abtalltime.html">Neil Kazaross</ulink>, who wrote a <ulink url="http://www.bkgm.com/rgb/rgb.cgi?view+1187">post</ulink> on this at the <ulink url="http://www.gammonline.com/">GammonLine</ulink> forum.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect2>
    <sect2 id="Kleinman_and_Thorp_counts" xreflabel="Kleinman and Thorp counts">
      <title>Kleinman and Thorp counts</title>
      <para>If the game situation is a race, one can look up what the Kleinman count or Thorp count has to say about it.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/ff1f1de.png"/>
        </imageobject>
      </mediaobject>
    </sect2>
    <sect2 id="Market_Window_Gammon_value" xreflabel="Market Window Gammon value">
      <title>Market Window/Gammon value</title>
      <para>GNU offers a powerful Market Window/Gammon values tool (<menuchoice><guimenu>Analyze</guimenu><guimenuitem>Market Window</guimenuitem></menuchoice>) to the advanced or aspiring player. This tool will answer all questions on a position's take point, double point, etc. for both players at any match situation, including side-by-side dead-cube/live-cube scores. If you wish to see how other match scores would affect the figures, you can simply use the arrows, and you can change the cube value. And if it is a money game, then the respective double, beaver, raccoon, redouble values will be shown instead.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/234924dc.png" scale="99"/>
        </imageobject>
      </mediaobject>
    </sect2>
    <sect2 id="Temperature_Map" xreflabel="Temperature Map">
      <title>Temperature Map</title>
      <para>Sho Sengoku conceived and developed the idea of the <ulink url="http://www46.pair.com/sengoku/TempMap/English/TempMap.html">Temperature Map</ulink>, which is now available to GNU users. Essentially what it does is allow you to see the possible consequences of a move or cube decision in a visual manner. It is available in the Analysis pane, and in the Hint window. The best way to understand this is to give an example. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/3658e0e8.png" scale="99"/>
        </imageobject>
      </mediaobject>
      <para>Commenting on the position above, as can be seen in the Hint window below, GNU says that running off the anchor with 20/14 would lose 0.064 equity compared to the best move 6/5 6/1. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m2759b1ca.png"/>
        </imageobject>
      </mediaobject>
      <para>It explains this to us through its estimated percentages of wins and losses, but even trusting the numbers, it is sometimes difficult for a player to see why one is worse than the other. This is a classic "pay now, pay later" situation, ideally suited for the Temperature Map. To see it I highlight the moves I want to compare, and then press the Temp. Map button. To select more than one move, keep the Ctrl key pressed and click on the moves you want to examine. Here is what it shows me:</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/2e6307ae.png"/>
        </imageobject>
      </mediaobject>
      <para>The whiter the squares the worse the roll would be for me, and the darker the red, the better. We can see that after 20/14 there would be a number of possible rolls that would lead to disastrous situations compared to the ugly, but necessary 6/5 6/1. </para>
      <para>If for example, you wanted to see why a certain roll, flagged with a white square, plays worse, you can click on Show best move, and the best move after each roll will appear in the corresponding square. Likewise, checking Show equities would show the resulting equities of each case scenario.</para>
      <para>The Temperature Map is also available for cube decisions. Why cube decisions you might ask? The reason is that it allows you to see the volatility of the position, and would thus allow you to see quickly and easily the potential market losers of a position. You can set the depth of the analysis as seen at the bottom of the figure above, but be warned that even a 2-ply analysis of all the possibilities can take some time.</para>
    </sect2>
  </sect1>
  <sect1 id="Importing_and_Exporting_games" xreflabel="Importing and Exporting games">
    <title>Importing and Exporting games</title>
    <para>GNU allows users to import matches from a variety of formats, including the Jellyfish formats, the FIBS oldmoves format, the Snowie GamesGrid format (.sgg), the TrueMoneyGames format (.tmg), and even Snowie's Standard Text Format among others. It also allows you to export your games and positions into the Jellyfish format (.mat), HTML (including easily customizable graphics), a readable text format with diagrams (.txt), and even a PDF document. If you'd like to share a position and some analysis in text format, you can have GNU send this directly to the Windows clipboard for pasting.</para>
    <sect2 id="Importing_games" xreflabel="Importing games">
      <title>Importing games</title>
      <para>Since many players who play online will want to make use of this to analyze their matches, or at the very least see how they did, below are step-by-step instructions on how to do this whether you play at <ulink url="http://www.fibs.com/">FIBS</ulink>, <ulink url="http://www.gamesgrid.com/">GamesGrid</ulink>, or <ulink url="http://www.truemoneygames.com/">TrueMoneyGames</ulink>. Essentially, you just want to save the games in a format that GNU can read and then import them.</para>
      <para>To import a match or position, just press the <inlinegraphic fileref="images/m46788d89.png"/> button on the toolbar. Then select the type of file you wish to import, locate the file, and that's that.</para>
      <tip>
        <para>For those who take online classes, please note that it imports the commentary saved on a move-by-move basis at GamesGrid, so you can see comments in the annotation window when going over the moves. I tested this with an online class and it was all there, neatly saved at every move.</para>
      </tip>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m6e43baca.png" scale="99"/>
        </imageobject>
      </mediaobject>
    </sect2>
    <sect2 id="FIBS_-_Importing_and_analyzing" xreflabel="FIBS - Importing and analyzing">
      <title>FIBS - Importing and analyzing</title>
      <para>These instructions are for use with <ulink url="http://www.fibs.com/~cthulhu/">JavaFIBS</ulink>, my preferred FIBS client.</para>
      <orderedlist>
        <listitem>
          <para>After your match or game is finished, in the JavaFIBS client, go to the Tools menu and select Match Converter.</para>
        </listitem>
        <listitem>
          <para>In the window that opens, click on the match you want to analyze, and press the Convert button. I'd recommend deleting the match after this (pressing the Delete button) so the list doesn't grow too big.</para>
        </listitem>
      </orderedlist>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m5878543.png"/>
        </imageobject>
      </mediaobject>
      <orderedlist>
        <listitem>
          <para>Open the program, enter the File menu, select Import, and then choose .mat match.</para>
        </listitem>
        <listitem>
          <para>Locate the match and import it. You'll find it in the main JavaFIBS directory, in the subdirectory Match and then Jellyfish. See the <xref linkend="remember"/> below to avoid having to do this everytime.</para>
        </listitem>
        <listitem>
          <para>Go to the Analyze menu and select Analyze match. See <xref linkend="Analyzing_matches"/> to learn how to change the analysis settings.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="GamesGrid___Importing_and_analyzing" xreflabel="GamesGrid   Importing and analyzing">
      <title>GamesGrid – Importing and analyzing</title>
      <orderedlist>
        <listitem>
          <para>When playing or watching a match at Gamesgrid, be certain to activate the Record button <inlinegraphic fileref="images/m2c37a1e7.png"/> so it will save the game when you are done.</para>
        </listitem>
        <listitem>
          <para>In the save game window, change the format to be saved to Gamesgrid Snowie Match (.sgg) and then press Save.</para>
        </listitem>
      </orderedlist>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m93f2ca3.png"/>
        </imageobject>
      </mediaobject>
      <orderedlist>
        <listitem>
          <para>Open the program, enter the File menu, select Import, and then choose Gamesgrid .sgg match.</para>
        </listitem>
        <listitem>
          <para>Locate the match and import it. You'll probably find it in the Gamesgrid directory in a subdirectory called SaveGame. See the <xref linkend="remember"/> below to avoid having to do this everytime.</para>
        </listitem>
        <listitem>
          <para>Go to the Analyze menu and select Analyze match. See <xref linkend="Analyzing_matches"/> to learn how to change the analysis settings.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="TrueMoneyGames___Importing_and_Analyzing" xreflabel="TrueMoneyGames   Importing and Analyzing">
      <title>TrueMoneyGames – Importing and Analyzing</title>
      <orderedlist>
        <listitem>
          <para>I'd first suggest changing the option in the TrueMoneyGames client so that it always saves matches by default. Note that you cannot save a match that you are only watching. After opening the program, go to the Tools menu and select Options. In the window that opens, click on the Table tab at the top and then set the options as in the figure below.</para>
        </listitem>
      </orderedlist>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/16d7944c.png"/>
        </imageobject>
      </mediaobject>
      <orderedlist>
        <listitem>
          <para>After saving your game or match, open the program, enter the File menu, select Import, and then choose TrueMoneyGames .tmg match.</para>
        </listitem>
        <listitem>
          <para>Locate the match and import it. You'll probably find it in the TrueMoneyGames directory, called TMG, in a subdirectory called SavedGames. See the <xref linkend="remember"/>" below to avoid having to do this everytime.</para>
        </listitem>
        <listitem>
          <para>Go to the Analyze menu and select Analyze match. See <xref linkend="Analyzing_matches"/> to learn how to change the analysis settings. </para>
        </listitem>
      </orderedlist>
      <tip id="remember" xreflabel="remember">
        <para>You can have GNU always remember where to get or save a specific file format. For example, to have it remember where to import your matches from Gamesgrid go to File, then Import, and then Gamesgrid .sgg match. In the window that opens, first go to the directory where the matches are saved, but before opening the file, press the Set As Default button at the top. After this, save your settings (<menuchoice><guimenu>Settings</guimenu><guimenuitem>Save Settings</guimenuitem></menuchoice>) and GNU will remember where to find your Gamesgrid matches. You can set GNU to remember different directories for each and every type of file format.</para>
      </tip>
    </sect2>
    <sect2 id="Exporting_games_positions" xreflabel="Exporting games positions">
      <title>Exporting games/positions</title>
      <para>GNU allows users to Export their games and matches into a variety of formats such as the Jellyfish formats, text format, not to mention PDF, LaTex, PostScript, and even HTML. Note that when exporting to these formats you get the moves, diagrams at each move, the analysis, and even the game/match statistics. In text format you'll see the boards in ASCII art, and in PDF, you'll literally get an instant e-book of the match. It also can export board positions and Gammonline HTML to the Windows clipboard for easy pasting.</para>
    </sect2>
    <sect2 id="Windows_Clipboard_export" xreflabel="Windows Clipboard export">
      <title>Windows Clipboard export</title>
      <orderedlist>
        <listitem>
          <para>Text export - If you want to share a position and analysis with someone via e-mail or a bulletin board, you can save it to a text file and then recopy the contents, but there is a simpler way. When the position is on the board, go to the Edit menu and select Copy as and the Position as ASCII.</para>
        </listitem>
      </orderedlist>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/2d9edbab.png"/>
        </imageobject>
      </mediaobject>
      <para>Now all you need to do is paste it wherever you like using the Paste command from the menu or the Windows shortcut Ctrl-V (or Shift-Ins) and get something like this:</para>
      <informalexample>
<screen>
              GNU Backgammon  Position ID: sGfwGQDg28EBBg
              Match ID   : cAlvATAAIAAA
              +13-14-15-16-17-18------19-20-21-22-23-24-+     O: Kit Woolsey
              | X           O    |   | O  O  X          |     3 points
              | X           O    |   | O  O  X          |
              | X                |   | O                |
              |                  |   | O                |
              |                  |   |                  |
              |                  |BAR|                  |     11 point match (Cube: 1)
              | O                |   | X                |
              | O                |   | X                |
              | O           X    |   | X                |
              | O     O     X  X |   | X                |     Rolled 63
              | O     O     X  X |   | X                |     4 points
              +12-11-10--9--8--7-------6--5--4--3--2--1-+     X: Gammonline Readers
      </screen>
</informalexample>
      <para>If the diagram comes out bad, it is probably because of the font. To fix it to look like the above, highlight the text of the diagram and change the font to Courier New and the size to 9 or 10.</para>
      <para>To paste the analysis of the position, look at the analysis in either the Annotation window or the Hint window, highlight the moves, and press the Copy button. Then paste it just like the diagram.</para>
      <orderedlist>
        <listitem>
          <para>Gammonline HTML export – If you are a <ulink url="http://www.gammonline.com/">GammonLine</ulink> subscriber, enjoy the GammonLine forum, and would like to share an interesting position, you can also make use of the GammonLine board images as seen in pretty much every article available, AND publish the analysis in elegant HTML. To do this go to the Edit menu, select Copy as, and then GammOnLine (HTML). </para>
        </listitem>
      </orderedlist>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/60df14d2.png"/>
        </imageobject>
      </mediaobject>
      <para>Now go to the text body in the forum and paste it with Ctrl-V (or Shift-Ins). This will work even if the analysis is only in the Hint window.</para>
    </sect2>
    <sect2 id="PNG_Image_export" xreflabel="PNG Image export">
      <title>PNG Image export</title>
      <para>You may also wish to simply save the board position as an image file that you can add to a Word document or HTML document for example. To do so, go to the File menu and select Export, then Position, and PNG. Be careful to add .PNG to the name when saving the image. The board image saved will use the color scheme currently being used. If you wish a different color scheme, change the design (for more info see Appearance|boards). You can also change the size of the image that is created by entering the Settings menu, then Export, and at the bottom right of the window that opens, set the size you want.</para>
    </sect2>
    <sect2 id="HTML_export" xreflabel="HTML export">
      <title>HTML export</title>
      <para>GNU is capable of creating elegant HTML files so that you can publish your games on the web. It will create them exactly according to your specifications, including the number of moves, what it analyzed, the board design of your choice, and even the match/game statistics. Here is a sample of what it looks like:</para>
      <para>Move number 3: mamabear to play 31</para>
      <para>
        <inlinegraphic fileref="images/20d56757.png"/>
      </para>
      <para>Position ID: 0HPhATDg2+ABMA Match ID: MIHlAEAAAAAAPip counts: mamabear 160, KitWoolsey 162</para>
      <para>*mamabear moves 24/20*</para>
      <informaltable frame="all">
        <tgroup cols="3">
          <colspec colnum="1" colname="c1"/>
          <colspec colnum="2" colname="c2"/>
          <colspec colnum="3" colname="c3"/>
          <tbody>
            <row>
              <entry namest="c1" nameend="c2">
                <para>#</para>
              </entry>
              <entry>
                <para>Ply</para>
              </entry>
              <entry>
                <para>Move</para>
              </entry>
              <entry>
                <para>Equity</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>*</para>
              </entry>
              <entry>
                <para>1</para>
              </entry>
              <entry>
                <para>2</para>
              </entry>
              <entry>
                <para>24/20*</para>
              </entry>
              <entry>
                <para>+0.206</para>
              </entry>
            </row>
            <row>
              <entry namest="c1" nameend="c3">
              </entry>
              <entry namest="c4" nameend="c5">
                <para>60.6% 21.1% 1.7% - 39.4% 8.9% 0.2%</para>
              </entry>
            </row>
            <row>
              <entry>
              </entry>
              <entry>
                <para>2</para>
              </entry>
              <entry>
                <para>2</para>
              </entry>
              <entry>
                <para>8/5 6/5</para>
              </entry>
              <entry>
                <para>-0.067 ( -0.272)</para>
              </entry>
            </row>
            <row>
              <entry namest="c1" nameend="c3">
              </entry>
              <entry namest="c4" nameend="c5">
                <para>55.2% 18.1% 1.1% - 44.8% 13.8% 0.6%</para>
              </entry>
            </row>
            <row>
              <entry>
              </entry>
              <entry>
                <para>3</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
              <entry>
                <para>24/23 13/10</para>
              </entry>
              <entry>
                <para>-0.244 ( -0.449)</para>
              </entry>
            </row>
            <row>
              <entry namest="c1" nameend="c3">
              </entry>
              <entry namest="c4" nameend="c5">
                <para>50.2% 15.1% 0.9% - 49.8% 15.1% 0.6%</para>
              </entry>
            </row>
            <row>
              <entry>
              </entry>
              <entry>
                <para>4</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
              <entry>
                <para>24/23 24/21</para>
              </entry>
              <entry>
                <para>-0.256 ( -0.462)</para>
              </entry>
            </row>
            <row>
              <entry namest="c1" nameend="c3">
              </entry>
              <entry namest="c4" nameend="c5">
                <para>49.8% 13.6% 0.8% - 50.2% 14.8% 0.4%</para>
              </entry>
            </row>
            <row>
              <entry>
              </entry>
              <entry>
                <para>5</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
              <entry>
                <para>24/21 6/5</para>
              </entry>
              <entry>
                <para>-0.285 ( -0.491)</para>
              </entry>
            </row>
            <row>
              <entry namest="c1" nameend="c3">
              </entry>
              <entry namest="c4" nameend="c5">
                <para>49.7% 14.4% 1.0% - 50.3% 16.5% 0.7%</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>To set all the settings as you'd like, you need to go to the Settings and then select Export. There you can choose, down to the smallest details, what it will display and how. The <emphasis>how</emphasis> concerns the images used to produce board positions. This is chosen at the bottom of the window and you can choose between its own HTML images or two others, which are FIBS and BBS. </para>
      <para>You can choose what the board in the HTML page will look like, and have it appear exactly as the board design (see <xref linkend="Board_designs___2D_and_3D"/> for more on this) you are using in the program. To do so, you need to create a directory to place the images and then export them. First, go to the File menu, select Export, and then HTML Images... Find a directory to place them in, or create your own by pressing the Create Directory button at the top. I'd suggest using the default name \html-images. Now enter the directory and press the OK button. Be careful to remember the name of the directory you placed the images in, including capital letters if you used any. Now go to the Settings menu, select Export and then at the bottom select GNU Backgammon board images (circled in red below) and type the name of the directory. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/29c6aa57.png"/>
        </imageobject>
      </mediaobject>
      <tip>
        <para>If you want to post a position in an online forum that supports HTML you can do this regardless of whether the forum itself supports the necessary images. Here's how:</para>
      </tip>
      <para>1) First be sure the image to be exported is currently on the board, and then in the Export settings set the HTML board type to fibs2html. In the space below URL to pictures, enter <ulink url="http://fibs2html.sourceforge.net/images/">http://fibs2html.sourceforge.net/images/</ulink> as shown below. Be sure to click Ok, and then Save Settings.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m3fb550fb.png"/>
        </imageobject>
      </mediaobject>
      <para>2) Go to the File menu, and select Export, then Position, and then HTML.. Save the file and then open it in Internet Explorer. In case this already sounds a bit mysterious, inside IE just go to <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice> and click on Browse... Locate the HTML file you saved and open it.</para>
      <para>3) Once you see the board and image in front of you, still in IE, go to the View menu and select Source... This will open a small window with a lot of code. Copy the entire contents to the body of the post you are writing, and the board and analysis should appear in the forum without any problems.</para>
    </sect2>
  </sect1>
  <sect1 id="Analyzing_matches" xreflabel="Analyzing matches">
    <title>Analyzing matches</title>
    <para>GNU also comes with a set of functions that allow it to analyze a game or match, provide a detailed graded report, and allow you to navigate through the moves to quickly see the mistakes made.</para>
    <para>Before starting, you'll want to configure the settings first, though this will only need to be done once. Go to Settings and select Analysis. A fairly large window will open, allowing you to play with as many settings as you could want. This is also where you set the thresholds for the Tutor mode (dubious, bad, etc.). Feel free to look around, but I simply set this to analyze checker play, cube decisions, and luck, and set the level of analysis at World Class for both checker play and cube decisions. The Move limit setting is to set the maximum number of moves it will display in the Hint window and the Analysis pane.</para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/3b2e620f.png"/>
      </imageobject>
    </mediaobject>
    <tip>
      <para>Once more, please do not forget to save (Settings|Save settings) after making changes in the settings, or you will be forced to change them again the next time you start the program.</para>
    </tip>
    <para>If you just played a match at an online server, import it first, then go to the Analyze menu and select Analyze match. If you only want to analyze a specific game, open it and then select Analyze game. Once started, you will see a bar in the bottom right corner showing the progress made in both the number of moves and percentage completed.</para>
  </sect1>
  <sect1 id="Analysis_Results_and_Grade" xreflabel="Analysis Results and Grade">
    <title>Analysis Results and Grade</title>
    <para>Once GNU has finished analyzing your games, you'll want to see the report and then go over the bloopers. In the Analyze menu, select Match statistics, and a window will open. Feel free to resize it (clicking and dragging the edges) to show more information. It will show you the results of both players side by side, allowing you to quickly compare notes. </para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/m3fd7ee24.png"/>
      </imageobject>
    </mediaobject>
    <para>You can click on the tabs at the top see the detailed information on how you did specifically in checker play, cubes, and even how luck or unlucky you were, and see the individual grades for each area. </para>
    <para>If you right-click on the information, you will have the choice to copy it or all the pages into the Windows clipboard, that you can paste wherever you like. </para>
    <para>It is very revealing when you see a very different evaluation of your checker play as opposed to your cube decisions. Another feature (in my opinion) is that GNU only grades your checker play according to non-forced moves, contrary to Snowie which grades while including moves that were spent on the bar or that were forced. In other words, if you played 50 moves but 10 of those were spent on the bar (you can hardly make a mistake if you can't play), then GNU will average your error rate according to the 40 unforced moves. You can save these results with the match (<menuchoice><guimenu>File</guimenu><guisubmenu>Save</guisubmenu><guimenuitem>Match</guimenuitem></menuchoice>), so that you can see the analysis at anytime without having to redo it. If you are used to Snowie's grade system, or would like to compare them, you will see the equivalent Snowie grade at the top.</para>
    <para>GNU can be quite tough on the grades, much harder than Snowie 4, so an Advanced grade in GNU could easily be an Expert or World Class grade in Snowie 4. Below are the limits of each grade:</para>
    <para>Snowie's thresholds (to understand the Snowie rating) are:</para>
    <informaltable frame="all">
      <tgroup cols="1">
        <tbody>
          <row>
            <entry>
              <para>0.0 - 1.2 : Extra-terrestrial</para>
              <para>1.2 - 4.4 : World class</para>
              <para>4.4 - 5.9 : Expert</para>
              <para>5.9 - 8.8 : Advanced</para>
              <para>8.8 - 12.6 : Intermediate</para>
              <para>12.6 -18.5 : Beginner</para>
              <para>18.5 - ?? : Novice</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
    <para>The program's thresholds are:</para>
    <informaltable frame="all">
      <tgroup cols="1">
        <tbody>
          <row>
            <entry>
              <para>0.000 - 0.002 Supernatural</para>
              <para>0.002 - 0.005 World Class </para>
              <para>0.005 - 0.008 Expert 0.008 - 0.012 Advanced </para>
              <para>0.012 - 0.018 Intermediate </para>
              <para>0.018 - 0.026 Casual Player </para>
              <para>0.026 - 0.035 Beginner </para>
              <para>0.035 - oo Awful! </para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
    <para>GNU will also attribute an estimated Elo rating of your play based on the <ulink url="http://www.northcoast.com/~mccool/fibsrate.html">FIBS rating system</ulink>, but it will only do so for match play. To know how they are derived, consult the <ulink url="http://www.cs.ubc.ca/~kvdoel/tmp/ratings/">author's paper</ulink> on this.</para>
    <para>You can also copy the results of the report to another document. To do this, click on any of the lines, then right-click with the mouse, and select either Copy Page or Copy all Pages</para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/34740886.png"/>
      </imageobject>
    </mediaobject>
    <tip>
      <para>If you use a program such as Word or WordPad (avoid Notepad), the formatting will be lost when you paste it, but this is easily fixed: in the document, highlight the text, and change the font to Courier New and size to either 9 or 10. Ex:</para>
    </tip>

    <informalexample>
<screen>
            Malcolm Davis         Neil Kazaross       
            Overall Statistics:
            Error rate (total)                    -1.421 (-12.205%)    -1.121 (-10.072%)   
            Error rate (per decision)               -8.4 ( -0.072%)      -6.2 ( -0.056%)   
            Equiv. Snowie error rate                -3.7                 -2.9              
            Overall rating                        Advanced             Expert              
            Actual result                          -50.00%              +50.00%            
            Luck adjusted result                    +0.87%               -0.87%            
            Luck based FIBS rating diff.            +9.13                                  
            Error based abs. FIBS rating          1951.5               1972.1              
            Checkerplay errors rating loss          89.2                 77.4              
      </screen>
</informalexample>
  </sect1>
  <sect1 id="Player_Records" xreflabel="Player Records">
    <title>Player Records</title>
    <para>You can keep track of the results obtained by yourself and your opponents using the Player Records. There you can store the statistics of your matches and keep records of the average results obtained such as checker play, cube decisions, and luck. It will also break down the results according to the last 20 games played, the last 100, etc.</para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/m7bf4f29.png" scale="99"/>
      </imageobject>
    </mediaobject>
    <para>To add results to an existing account, or simply create a new account in which to add the results (of course you must first have an analyzed match open), go to the Analyze menu, and select Add to Player Records and Match statistics. If the account doesn't already exist, GNU will create it automatically and add the results. If you wish to remove an account, then click on the name in the Player Records, and press the Erase button.</para>
  </sect1>
  <sect1 id="Reviewing_moves_and_mistakes" xreflabel="Reviewing moves and mistakes">
    <title>Reviewing moves and mistakes</title>
    <para>Once you have seen the results of the report, you will probably want to go over the mistakes you made. To do this, you'll need to be sure both the Game Record and the Analysis panes are visible. If you don't see them, or are unsure, go to the View menu, and activate them. </para>
    <sect2 id="Game_Record" xreflabel="Game Record">
      <title>Game Record</title>
      <para>The Game Record pane is located at the top right, and will list the moves, games, and errors:</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/4b13a0e7.png"/>
        </imageobject>
      </mediaobject>
      <para>It always shows the last move of the last game when you open or import a match. You can navigate backwards and forwards move-by-move with the green arrows, and game-by-game with the red arrows. If you use the buttons with the question marks on the green arrows, it will go from mistake-to-mistake. The side-by-side list with colored commentary (note that you must first analyze the match or move before) allows you to quickly overview who made more mistakes in a game, and identify what mistakes and how bad they were. Remember you can set the limits of what is considered a mistake by GNU in the Analysis options in the Settings menu.</para>
      <para>Here is a summary of what the colors and codes mean. The early versions of GNU didn't have the color coding, so they used punctuation marks, standard in chess notation, to describe the moves.</para>
      <para>!? indicates a dubious move</para>
      <para>? indicates a bad move, and</para>
      <para>?? indicates a blunder</para>
      <para>Since every move has two decisions involved, a checker play and a cube decision, one can make two mistakes in a single move, and thus see something like:</para>
      <para>63: 24/15!???</para>
      <para>Though it may seem like GNU got overly enthusiastic about its comments, the fact is there are two separate comments above. The first punctuation (!?) is for the checker play, and the second (??) is for the cube, so here a dubious checker play was made, and a cube decision blunder was also made.</para>
      <para>Note that you can ignore this if you like, and stick to the color coding, as described below. If all this seems a bit disorienting at first, with a bit of practice, it will become second nature.</para>
      <para>Green text indicates a dubious checker play</para>
      <para>Blue text indicates a bad checker play</para>
      <para>Red text indicates a very bad checker play</para>
      <para>Grey background indicates a dubious cube decision</para>
      <para>Purple background indicates a bad cube decision</para>
      <para>Yellow background indicates a very bad cube decision</para>
      <para>Boldface indicates a very lucky move</para>
      <para>Italics indicates a very unlucky move</para>
    </sect2>
    <sect2 id="Hint_window__Analysis_pane" xreflabel="Hint window  Analysis pane">
      <title>Hint window &amp; Analysis pane</title>
      <para>You can see the program's analysis either in the Hint window by pressing the <inlinegraphic fileref="images/m6e32590b.png"/> button on the toolbar, or in the Analysis pane after a game or move has been analyzed (see <xref linkend="Analyzing_matches"/> above). You will see a window open showing the best to worst moves from top to bottom or an analysis of the cube decision. </para>
      <tip>
        <para>GNU allows one to see the analysis in several forms, such as the GWC (Game winning chances) or MWC. In order to see it as shown below go to the Settings menu, select Options, then select the Display tab at the top. Set the last 3 choices as below:</para>
      </tip>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m6fc19da0.png"/>
        </imageobject>
      </mediaobject>
      <sect3 id="Checker_play_analysis" xreflabel="Checker play analysis">
        <title>Checker play analysis</title>
        <para>A first suggestion is to go to the Settings menu, then Appearance, and in it, to the right, make sure the box for GWC as Percentage is checked. Here is what it shows for the dubious move shown above:</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m2759b1ca.png"/>
          </imageobject>
        </mediaobject>
        <para>First of all, if you are new to backgammon software, and the above looks hopelessly complicated, relax, it isn't nearly that bad. Let's look at the 5th line in red, the move that was played, and figure out what it all means:</para>
        <orderedlist>
          <listitem>
            <para>Rank – As it's ranked 5th we know that GNU thinks it is only the 5th best move.</para>
          </listitem>
          <listitem>
            <para>Type – It says Cubeful which means that it is taking into account the possibility that someone may double. This means that occasionally you may see several moves with an equity of -1.000 (see Equity below), despite significantly different winning percentiles, because it thinks that if they are played then the opponent will double, and you should pass. The 2-ply is the depth GNU analyzed the move.</para>
          </listitem>
          <listitem>
            <para>Win - This number is the percentage the move has to win the game. Thus the move played gives the player a 29.7% chance to win (including gammons and backgammons). </para>
          </listitem>
          <listitem>
            <para>W g - This number is the percentage of games that should win by at least a gammon (including backgammons). Thus you have a 0.7% of winning with a gammon or better.</para>
          </listitem>
          <listitem>
            <para>W bg – This number is the percentage of games that should win by a backgammon. Thus you have a 0.0% of winning with a backgammon.</para>
          </listitem>
          <listitem>
            <para>Lose – This is the percentage of losses expected. Thus one has a 70.3% chance of losing the game (including gammons and backgammons). </para>
          </listitem>
          <listitem>
            <para>L g - This number is the percentage of games that should lose by at least a gammon (including backgammons). Thus 8.1% of the games will lose by a gammon or worse.</para>
          </listitem>
          <listitem>
            <para>L bg - This number is the percentage of games that should end in backgammon losses. Thus 0.2% of the games will lose by a backgammon.</para>
          </listitem>
          <listitem>
            <para>Equity – This is the overall evaluation of the position by the program, after considering the different win/loss percentiles, the cube position, and the match score. A 1.000 would mean that you are expected to win a point, a 0.000 would mean that it is roughly equal, and a -1.000 that you are expected to lose a point. The score shows an edge for the side that played as it says 0.137</para>
          </listitem>
          <listitem>
            <para>Diff. – This is the size of the error (the difference in equity) perceived in comparison to the top move. As we can see, the top move's equity reads 0.187 and the move played only 0.137, thus equating to a -0.050 error. The thresholds of the degrees of errors are determined in the Analysis settings. </para>
          </listitem>
          <listitem>
            <para>Move – This is the move being evaluated. In the case of the red line, it is the move that was played.</para>
          </listitem>
        </orderedlist>
        <para>As you can see, it shows the best moves considered, with the move actually played in red, plus the various equity scores for gammons, etc. Most players will focus on the last three, which are the total equity of the move, the difference in equity between the move played and the program's top choice, and what move is being evaluated. However, since GNU can't explain why one move is better than another, looking at the win percentage, and the respective percentages of gammon wins and gammon losses can help.</para>
        <para>That's all nice and well for the Hint window, however the Analysis pane, if activated, will appear below the Game Record a bit differently. If you don't see it at all, be sure it is activated in the View menu. Remember also that you must first have analyzed moves or games (<menuchoice><guimenu>Analyze</guimenu><guimenuitem>Analyze match</guimenuitem></menuchoice>) for it to display anything.</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/5308d35c.png"/>
          </imageobject>
        </mediaobject>
        <para>The organization is similar to the Hint window described above, and the information is identical. The top line of each move shows the rank, the type (depth), the equity and the move played (in boldface). The line below shows the move's winning percentages, the gammon winning chances, and the backgammon percentages, followed by the respective percentages of the opponent. See above for a detailed description.</para>
      </sect3>
      <sect3 id="Cube_analysis" xreflabel="Cube analysis">
        <title>Cube analysis</title>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m1bd07579.png"/>
          </imageobject>
        </mediaobject>
        <para>In the diagram above, you can see how its cube analysis looks like. First you will see that aside from the pure cubeless equity, it also says (Money: +0.357). The reason is that the cube analysis was from a match, where the score can completely change the value and correctness of a double or not, and GNU tells you what the equity would be if the decision were in a money game.</para>
        <para>Below you can see the expected win/loss percentages, just as for checker play, and below that you can see the actual cube analysis. Here is what you are seeing:</para>
        <para>1. Double, take +0.688 – This is the equity GNU estimates you will have if you double, and your opponent accepts. You will notice this is quite different from the cubeless equity at the top at +0.308. The reason is that this second equity of +0.688 takes into account the cube and power it gives. Since we know this is a match cube, the cube may have a very different value depending on how much it weighs on the match score.</para>
        <para>2. Double, pass +1.000 +0.312 – The +1.000 is simply because if your opponent passes, you would win a single game (no gammon or backgammon) hence the +1.000 equity. Since this is considerably higher than your equity of +0.688 if he were to take, dropping the cube would be a +0.312 blunder (1000 – 688).</para>
        <para>3. No double +0.646 -0.042 – This is what your equity would be if you didn't double. Since the equity is lower than the +0.688 you would have if you doubled and the double was accepted, not doubling would lose 0.042 (688 – 646), and would therefore be a mistake.</para>
        <para>Proper cube action obviously represents what should be done on both sides, in other words you should double, since not doubling would be a 0.042 mistake as we saw, and your opponent should take, since dropping would be a 0.312 blunder.</para>
      </sect3>
      <sect3 id="Other_analysis_functions" xreflabel="Other analysis functions">
        <title>Other analysis functions</title>
        <para>If you'd like to copy the analysis of a move(s) or cube decision to a document, highlight the moves that interest you, and press Copy. If you want to highlight more than one, keep the Ctrl key pressed while selecting the moves. Then paste it where you wish. Don't forget to change the font to Courier New size 9 or 10 if you wish to maintain the formatting.</para>
        <para>If you'd like to see how the different moves it analyzed appear on the board, press the Show button. </para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/m1921b4.png"/>
          </imageobject>
        </mediaobject>
        <para>Now just click on a move you want to see in the list of analyzed moves and the board will display it. To see another move, just click on it. This allows you to quickly see and compare the moves it analyzed. To exit Show mode to be able to analyze the moves or run rollouts, click on the Show button again.</para>
        <para>You'll also note a button called the Temp. Map <inlinegraphic fileref="images/m707a2772.png"/>. This is a powerful tool conceived and developed by Sho Sengoku. Please refer to the <xref linkend="Temperature_Map"/> section for details.</para>
        <para>You may also want to have GNU analyze a few select moves a bit deeper. To do this you can have it go a 3rd ply, a 4th ply, or even do a rollout. To do a 3-ply or 4-ply analysis, select the moves you want analyzed, and then press the <inlinegraphic fileref="images/m22b92249.png"/> or <inlinegraphic fileref="images/3117171e.png"/>. Let's have it do a 3-ply analysis of the three moves highlighted above. Just click on the number <emphasis>3</emphasis> and it will do a 3-ply analysis. Be a little patient as 3 plies is considerably slower than 2 plies, but it shouldn't be too long. If you want to customize the evaluator, click on the button indicated with a small red circle <inlinegraphic fileref="images/m2a94f4ab.png"/>, and change the parameters you want. Now just click on the Eval button, and let it compute its results. You may also prefer to see the Match Winning Chances of the moves instead of the equity. This shows the chances of winning the match as opposed to the evaluation according to a single game. To do so, press the MWC button:</para>
        <mediaobject>
          <imageobject>
            <imagedata align="center" fileref="images/53ce0fa6.png"/>
          </imageobject>
        </mediaobject>
        <para>Here we see the results of the 2-ply analysis, displayed not only in percentiles, but in Match Winning Chances, as opposed to Game Winning Chances.</para>
      </sect3>
    </sect2>
    <sect2 id="Commenting_moves" xreflabel="Commenting moves">
      <title>Commenting moves</title>
      <para>You can add or read text comments on moves or cube decisions. This is available through the Commentary pane, available through the View menu (<menuchoice><guimenu>View</guimenu><guimenuitem>Commentary</guimenuitem></menuchoice>).</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m72075f4e.png"/>
        </imageobject>
      </mediaobject>
      <para>These comments are saved with the game score and can also be exported into HTML, PDF, text files, or any of the other Export options in <xref linkend="Exporting_games_positions"/>.</para>
    </sect2>
  </sect1>
  <sect1 id="Rollouts" xreflabel="Rollouts">
    <title>Rollouts</title>
    <para>So what's a rollout? A rollout is when you have the program play against itself a set amount of times (number of trials) and then sum up all the results of wins, losses, gammons, etc. from those games to give a more precise evaluation of a move/position. The interest is that the program may easily be underestimating some features/dangers of a position, and not realize this by only looking a couple of plies ahead. By playing it out, things will happen, and the game will unfold, giving it more accurate information on the consequences of a move. </para>
    <para>One can do a full rollout, meaning it will play the position out until the last checker is born off, or it can be a truncated rollout, playing to a certain depth in plies, enough to evaluate the consequences, or even a mixture of settings. </para>
    <para>Rollouts can be done at any time either directly from the Analysis pane with the Rollout option, or from the Hint window. To use the rollout function you must first select the moves you want to rollout, otherwise the button will remain grayed out and inaccessible. You will want to set your preferred options the first time by clicking on the <inlinegraphic fileref="images/m57625db1.png"/> button to the right of the Rollout button. </para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/mb4b1284.png"/>
      </imageobject>
    </mediaobject>
    <para>GNU offers a vast number of ways to set the rollouts, allowing you as many possibilities for efficiency as possible. Its 0-ply play is incredibly strong and practically instant, so it can help give meaningful results very quickly. GNU also plays according to score in its rollouts (using the match equity table of your choice naturally), which Snowie 4 does not for example. I will explain the main options, share the results of some of the testing that has been done, and share my preferences.</para>
    <para>When one opens the rollout options window for the first time, it can look vastly intimidating and confusing. </para>
    <para>
      <inlinegraphic fileref="images/2dd86698.png"/>
    </para>
    <para>However, it really isn't, so let's run through it from top to bottom and see what GNU can do for you.</para>
    <sect2 id="Playing_strength" xreflabel="Playing strength">
      <title>Playing strength</title>
      <para>To set the primary playing strength used in the rollouts, click on the tab First Play Both at the top:</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m5781f59d.png"/>
        </imageobject>
      </mediaobject>
      <para>This is where you configure the primary strength of play. If you want to set a different playing strength for the cube decisions, you must go to the General Settings tab and at the bottom deactivate the option Cube decisions use same settings as Checker play.</para>
    </sect2>
    <sect2 id="Trials" xreflabel="Trials">
      <title>Trials</title>
      <para>The topmost part under the tab General Settings is where you set the number of trials.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m4796afa7.png"/>
        </imageobject>
      </mediaobject>
      <para>The number of trials is simply the number of games you want GNU to play out (or roll out) as it collects the results. The more trials the better as this reduces the error margin of the results. After all, if it won a certain position 2 times in 3, it could be a fluke, but after hundreds or thousands of trials with variance reduction (see below) the results become far more trustworthy.</para>
    </sect2>
    <sect2 id="Truncated_rollouts" xreflabel="Truncated rollouts">
      <title>Truncated rollouts</title>
      <para>Truncated rollouts are rollouts played to a certain number of moves as opposed to full rollouts. You may feel that the program doesn't really need to play the game to the last move to know whether a move leads to good positions or bad ones.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m19f9a2cc.png"/>
        </imageobject>
      </mediaobject>
      <para>In the above figure the setting is 11 plies, so GNU will play out 11 moves, stop and evaluate the resulting position, and then start the next trial. This is far faster of course, and is particularly desirable if you want to analyze using a 2-ply playing strength which might be too slow for a full rollout.</para>
    </sect2>
    <sect2 id="Evaluation_for_later_plies" xreflabel="Evaluation for later plies">
      <title>Evaluation for later plies</title>
      <para>One can set GNU to use a different playing strength after a specified number of plies in the Evaluation for later plies.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/3cb4011e.png"/>
        </imageobject>
      </mediaobject>
      <para>For example, suppose you had a backgame situation to rollout. Although you wanted the game to be rolled out at 0-ply (1900-2000 Elo), you didn't trust the first plies to be the best. Enabling this as above, you could set the first 8 plies to be played at Supremo (2-ply) and the rest of the game at 0-ply, giving you a bit of both worlds. In fact this has been tested and shown to be very efficient for exactly that type of scenario.</para>
      <para>So how does one set the playing strength of the first 5 plies (for example) and after? At the top, there are those mysterious tabs: </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/4e43baf8.png"/>
        </imageobject>
      </mediaobject>
      <para>If you click on the tab First Play Both, you can set the strength of the first plies to be played. Naturally, if you haven't activated the Evaluation for later plies option this will be the default rollout playing strength. Now, once you have set this, click on the Later Play Both, and you will be able to set the playing strength for the subsequent plies. You can use this option in both full rollouts and truncated rollouts. </para>
    </sect2>
    <sect2 id="Stop_at_specific_Standard_Deviation" xreflabel="Stop at specific Standard Deviation">
      <title>Stop at specific Standard Deviation</title>
      <para>Obviously, a rollout with too few trials will not yield reliable results due to the large Standard Deviation, or in other words how much the result could be wrong by. The more trials the smaller the possible error, however how many trials are necessary? Unfortunately, this can vary a lot according to the position, so to get a Standard Deviation of 0.020 (meaning the equity given could be actually 0.020 more or 0.020 less) one position might need 400 trials, and another might need 1400. This option is designed to address this problem.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m23e0471c.png"/>
        </imageobject>
      </mediaobject>
      <para>In the figure above, the margin was set to 0.100 and a minimum of 144 games were requested. </para>
    </sect2>
    <sect2 id="Stop_at_specific_Joint_Standard_Deviation" xreflabel="Stop at specific Joint Standard Deviation">
      <title>Stop at specific Joint Standard Deviation</title>
      <para><quote>When comparing the results of two plays, each of which has an associated random uncertainty (standard deviation), a 'joint standard deviation' needs to be calculated. If s1 and s2 are the respective uncertainties, the the joint standard deviation is given by sj = sqrt(s1*s1 + s2*s2). If s1 and s2 are close (which is almost always the case in backgammon rollouts where the same number of trials were used for each play), this simplifies to s*sqrt(2) = 1.4*s.</quote> (Chuck Bower, <ulink url="http://www.gammonline.com/members/Jan01/articles/uncert.htm">Understanding Uncertainty</ulink>, 2001)</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m30dc13f6.png"/>
        </imageobject>
      </mediaobject>
      <para>This option allows you to set a rollout to stop when a specific j.s.d. has been reached to compare two moves. You can have it stop when there is no longer any doubt which move is better, or you can have it continue until a certain degree of precision has been reached (you not only want to know which move is best, but by how much), while requiring a minimum number of trials before stopping. </para>
    </sect2>
    <sect2 id="Cubeful" xreflabel="Cubeful">
      <title>Cubeful</title>
      <para>This option is designed to activate or not cubeful rollouts. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/be5c848.png"/>
        </imageobject>
      </mediaobject>
      <para>A cubeful rollout means that it is using the cube in the rollout and, just as in a normal game, might stop the rollout short due to a doubled cube that is passed.</para>
    </sect2>
    <sect2 id="Bearoff_Truncation" xreflabel="Bearoff Truncation">
      <title>Bearoff Truncation</title>
      <para>Since GNU comes with bearoff databases allowing not only perfect play but perfect evaluations of a position as well, it makes since to have the program stop a rollout when it reaches one of these databases.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/723e49fc.png"/>
        </imageobject>
      </mediaobject>
      <para>Here one can activate or de-activate this option, though it is on by default.</para>
      <informaltable frame="all">
        <tgroup cols="1">
          <tbody>
            <row>
              <entry>
                <para>Variance Reduction</para>
                <para>Whenever running a rollout, you will always want the Variance Reduction activated as it greatly increases the reliability of the results. The first time this ingenious <ulink url="http://www.rci.rutgers.edu/~drhoover/SIMULATIONR.PDF">technique</ulink> was introduced to backgammon rollouts was by Fredrik Dahl, the author of Jellyfish. In a nutshell, it factors in luck when evaluating results, so that the program doesn't need 10,000 games to average out the luck of the dice and that way ensure luck wasn't a factor in the results obtained. With it, 100 rolled out games with Variance Reduction can be the equivalent of 5,000 games with no Variance Reduction.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect2>
    <sect2 id="Quasi-Random_dice" xreflabel="Quasi-Random dice">
      <title>Quasi-Random dice</title>
      <para>Normally, GNU will roll the dice out completely randomly, but this may not be desirable in the rollouts. The reason is that luck may cause a number of flukes to happen, especially in the first roll. What if in your trials, the first roll it played never included some numbers which might lead to a slight change in its evaluation? The variance reduction will compensate for this, but so does the option to use quasi-random dice.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/4332f3e4.png"/>
        </imageobject>
      </mediaobject>
      <para>This option deliberately alternates the first roll for every trial so that every possible first roll will have been played after 36 trials, starting with 1 and 1, then 1 and 2, all the way to 6 and 6. The idea is to help negate the luck in the rollouts a bit more. However, this also means that if used, one must use a number of trials that is a multiple of 36. That is why 1296 trials (or 2592 or 3888) is a good number to run rollouts as it is 36 x 36.</para>
    </sect2>
    <sect2 id="Rollout_as_initial_position" xreflabel="Rollout as initial position">
      <title>Rollout as initial position</title>
      <para>If you plan to do a rollout on one of the opening moves you will want to activate the option Rollout as initial position.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/74a66417.png"/>
        </imageobject>
      </mediaobject>
      <para>The reason is that in the opening move one is not allowed to roll a double. This guarantees this will be respected if you roll from the opening position.</para>
    </sect2>
    <sect2 id="Seed" xreflabel="Seed">
      <title>Seed</title>
      <para>The seed is a random number that you can choose and that is linked to the random dice generator. It doesn't affect the randomness by any means, and its sole purpose is to allow you or others to exactly reproduce rollout results. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m518778bb.png"/>
        </imageobject>
      </mediaobject>
      <para>If you see a posted rollout result with the played settings (strength and number of trials), the type of random dice generator chosen, and the seed, you should be able to exactly reproduce the results by using the same settings and the same seed.</para>
    </sect2>
    <sect2 id="Same_cube_and_checker_settings_" xreflabel="Same cube and checker settings ">
      <title>Same cube and checker settings </title>
      <para>You may want to use different settings for the cube decisions than the checker play. If so, uncheck the option Cube decisions use same settings as Checker play.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/26e34ea5.png"/>
        </imageobject>
      </mediaobject>
    </sect2>
    <sect2 id="Same_settings_for_both_players" xreflabel="Same settings for both players">
      <title>Same settings for both players</title>
      <para>Although the obvious choice (and the default one) is to have both players use the same settings, you can also choose not to.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/1805dc7d.png"/>
        </imageobject>
      </mediaobject>
      <para>By deactivating the Use same settings for both players option, you can configure different checker and cube play settings for each side. Thus one side could be playing at Expert level, and the other at Supremo. To set the different playing strengths, you'll now make use of two other tabs at the top:</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m2c28ffc2.png"/>
        </imageobject>
      </mediaobject>
      <para>Once you have opted for individual settings for each side, you must set them. Without this option, the tabs First Play Both and Later Play Both establish the playing strength for both sides. With it, they only determine the playing strength of the first player. You must go to First Play (1) to set the level to be used for the other player. If you have activated <xref linkend="Evaluation_for_later_plies"/> you must also set the Later Play (1).</para>
    </sect2>
    <sect2 id="Final_truncated_evaluation" xreflabel="Final truncated evaluation">
      <title>Final truncated evaluation</title>
      <para>If you are using a truncated rollout, you may be concerned about the final and decisive evaluation. For example, you might be content to let it play 17 plies at 0-ply to evaluate the resulting position, but want a little more precision on the evaluation of the final position. You can change this by deactivating the Use player0 setting for truncation point.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m3eb29fd9.png"/>
        </imageobject>
      </mediaobject>
      <para>When deactivated, you can set a different playing level for that final evaluation. It goes without saying that this is pointless for a full rollout. To set the level, you'll need to go to the top to the Truncation Point tab.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m2698978a.png"/>
        </imageobject>
      </mediaobject>
    </sect2>
    <sect2 id="My_suggested_settings" xreflabel="My suggested settings">
      <title>My suggested settings</title>
      <para>A lot of testing has been done by a number of people seeking to find the most reliable settings under different circumstances, as well as spotting the unreliable ones. I'd like to especially thank Michael Depreli, Ian Shaw, Ian Dunstan and Neil Kazaross for their painstaking research and the huge amount of computer time spent gathering and processing the data. The results helped answer a number of questions that reflect in my choice settings.</para>
      <para>The first thing to note is that the 0-ply checker play is indeed extremely strong (as any victim of GGRaccoon can attest to) and due to its speed is usually ideal for full rollouts. It is only less than ideal for backgame situations, prime vs. prime situations, and positions where timing is an important consideration. So for pretty much any other situation, it can be used confidently. There has been significant questioning of the odd-ply play as it has often been seen that 1-ply would produce erratic results. Tests have shown that this is true of cube decision, but 1-ply checker play is a bit stronger than 0-ply as one would expect.</para>
      <para>The primary setting is what I use the most and covers 95% of my rollouts, giving excellent results within a few minutes.</para>
      <orderedlist>
        <listitem>
          <para>My primary setting: </para>
        </listitem>
      </orderedlist>
      <orderedlist>
        <listitem>
          <orderedlist>
            <listitem>
              <para>Set the number of games to either 648 games or 1296 using the arrows on the right. The reason for these numbers is that there are 36 possible combinations of the dice, and 1296 is 36 times 36.</para>
            </listitem>
            <listitem>
              <para>Uncheck Truncate Rollouts, meaning it is a full rollout.</para>
            </listitem>
            <listitem>
              <para>Set the level to Expert</para>
            </listitem>
            <listitem>
              <para>Leave the other defaults as are</para>
            </listitem>
          </orderedlist>
        </listitem>
      </orderedlist>
      <orderedlist>
        <listitem>
          <para>My secondary setting is when I feel the cube decisions at 0-ply may not be reliable:</para>
          <orderedlist>
            <listitem>
              <para>Set the number of games to either 648 games or 1296 using the arrows on the right. The reason for these numbers is that there are 36 possible combinations of the dice, and 1296 is 36 times 36.</para>
            </listitem>
            <listitem>
              <para>Uncheck Truncate Rollouts, meaning it is a full rollout.</para>
            </listitem>
            <listitem>
              <para>Uncheck Cube decisions use same settings as Checker play</para>
            </listitem>
            <listitem>
              <para>Set the checker play at Expert, </para>
            </listitem>
            <listitem>
              <para>Set the Cube decisions to World Class</para>
            </listitem>
            <listitem>
              <para>Leave the other defaults as are</para>
            </listitem>
          </orderedlist>
        </listitem>
      </orderedlist>
      <orderedlist>
        <listitem>
          <para>My third setting is when the first moves may be difficult (backgame, etc.)</para>
          <orderedlist>
            <listitem>
              <para>Set the number of games to either 648 games or 1296 using the arrows on the right. The reason for these numbers is that there are 36 possible combinations of the dice, and 1296 is 36 times 36.</para>
            </listitem>
            <listitem>
              <para>Activate Enable separate evaluations and set Change eval after ply to a number between 8 and 12.</para>
            </listitem>
            <listitem>
              <para>Uncheck Truncate Rollouts, meaning it is a full rollout.</para>
            </listitem>
            <listitem>
              <para>Under the tab First Play Both set the checker play at World Class</para>
            </listitem>
            <listitem>
              <para>Under the tab Later Play Both set the checker play to Expert.</para>
            </listitem>
            <listitem>
              <para>Set the Cube decisions to World Class</para>
            </listitem>
            <listitem>
              <para>Leave the other defaults as are</para>
            </listitem>
          </orderedlist>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="Stopping_and_continuing_rollouts" xreflabel="Stopping and continuing rollouts">
      <title>Stopping and continuing rollouts</title>
      <para>If you are running a rollout but must stop it before reaching a satisfactory answer, you can stop the rollout and then continue it later. After stopping the rollout, save it. When you open it and go back to the move, if it is a checker play, select the moves you had been analyzing (or only the ones you want to continue) and just press the Rollout button. There is no need to reset the settings, as GNU will remember the exact same settings it had been using when it first began the rollout.</para>
    </sect2>
    <sect2 id="Copy_and_Paste_results" xreflabel="Copy and Paste results">
      <title>Copy and Paste results</title>
      <para>Once you have set your choices, press Ok, and then the Rollout button. When you are done, you may wish to copy the results to a document or e-mail for example. To do so, just select the moves that interest you, keeping the Ctrl key pressed to select more than one, and then press the Copy button as shown.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m1e2a8a3a.png"/>
        </imageobject>
      </mediaobject>
      <para>To see the results, just paste them on the document (Ctrl-V or Shift-Ins for Windows users). </para>
      <informalexample>
<screen>
              1. Rollout          10/9 7/4                     Eq.:  -0.2669
              35.74%  10.04%   0.38% -  64.26%  21.19%   0.74% CL  -0.4004 CF  -0.2669
              [  0.13%   0.13%   0.03% -   0.13%   0.17%   0.05% CL   0.0034 CF   0.0049]
              Full cubeful rollout with var.redn.
              2388 games, Mersenne Twister dice gen. with seed 103 and quasi-random dice
              Play: world class 2-ply cubeful prune [world class]
              keep the first 0 0-ply moves and up to 8 more moves within equity 0.16
              Skip pruning for 1-ply moves.
              Cube: 2-ply cubeful prune [world class]
              2. Rollout          9/5                          Eq.:  -0.2747 ( -0.0078)
              33.62%   7.94%   0.23% -  66.38%  14.36%   0.38% CL  -0.3933 CF  -0.2747
              [  0.12%   0.12%   0.02% -   0.12%   0.16%   0.03% CL   0.0030 CF   0.0044]
              Full cubeful rollout with var.redn.
              2388 games, Mersenne Twister dice gen. with seed 103 and quasi-random dice
              Play: world class 2-ply cubeful prune [world class]
              keep the first 0 0-ply moves and up to 8 more moves within equity 0.16
              Skip pruning for 1-ply moves.
              Cube: 2-ply cubeful prune [world class]
              3. Rollout          10/7 9/8                     Eq.:  -0.3316 ( -0.0647)
              30.97%   6.07%   0.12% -  69.03%  11.81%   0.26% CL  -0.4394 CF  -0.3316
              [  0.12%   0.09%   0.02% -   0.12%   0.15%   0.02% CL   0.0029 CF   0.0039]
              Full cubeful rollout with var.redn.
              2388 games, Mersenne Twister dice gen. with seed 103 and quasi-random dice
              Play: world class 2-ply cubeful prune [world class]
              keep the first 0 0-ply moves and up to 8 more moves within equity 0.16
              Skip pruning for 1-ply moves.
              Cube: 2-ply cubeful prune [world class]
      </screen>
</informalexample>
      <para>If you are using Word or Wordpad, it is suggested you set the pasted text to the font Courier New, and the size to 9 or 10, else the formatting will be lost, and it may be difficult to read.</para>
      <para>Once more: Remember to save your settings before exiting the program or you will need to reconfigure your settings the next time you use the program.</para>
    </sect2>
  </sect1>
  <sect1 id="Setting_up_a_position" xreflabel="Setting up a position">
    <title>Setting up a position</title>
    <para>Naturally, other than matches and games, you might just want to set up a position from a book or other source, and ask the program's expert advice. First, you must start a new game or match, and then just press the Edit button, located at the top in the toolbar.</para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/20bc52ca.png"/>
      </imageobject>
    </mediaobject>
    <sect2 id="Names_and_score" xreflabel="Names and score">
      <title>Names and score</title>
      <para>At the bottom, you will see you have the option of setting the scores or the names of the players.</para>
    </sect2>
    <sect2 id="Side__cube__and_dice" xreflabel="Side  cube  and dice">
      <title>Side, cube, and dice</title>
      <para>If you want to change the dice on the board, click on the side of the board where you would normally click to roll the dice. If you click on the left-side of the board it will propose the dice for the top player, and if you click on the right-side of the board it will present the dice for the bottom player. </para>
      <para>You can set whose turn it is to play by clicking on the small checker next to the player's name at the bottom. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m2b86c3ea.png"/>
        </imageobject>
      </mediaobject>
      <para>You can also set the turn of the player to move in the Game menu and by selecting Set turn at the bottom.</para>
      <para>To set the cube position and value click on the cube or enter the Game menu and select Set cube. A small window will appear with cubes set in all directions. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m76e2d010.png"/>
        </imageobject>
      </mediaobject>
      <para>The cubes that are upside down are for the top player, the ones rightside up are for the bottom player, and if you wish to set the cube in the center, choose the ones facing sideward. If you want the cube at its initial value in the center, choose the 64 cube facing sideward.</para>
      <tip>
        <para>If you want to setup the same position another GNU user posted, you don't need to set it all up manually. You can simply copy the Position ID and Match ID and instantly get the position, cube, and score. Suppose you saw this:</para>
      </tip>
      <informalexample>
<screen>
              GNU Backgammon  Position ID: sGfwGQDg28EBBg
              Match ID   : cAlvATAAIAAA
              +13-14-15-16-17-18------19-20-21-22-23-24-+     O: Kit Woolsey
              | X           O    |   | O  O  X          |     3 points
              | X           O    |   | O  O  X          |
              | X                |   | O                |
              |                  |   | O                |
              |                  |   |                  |
              |                  |BAR|                  |     11 point match (Cube: 1)
              | O                |   | X                |
              | O                |   | X                |
              | O           X    |   | X                |
              | O     O     X  X |   | X                |     Rolled 63
              | O     O     X  X |   | X                |     4 points
              +12-11-10--9--8--7-------6--5--4--3--2--1-+     X: Gammonline Readers
      </screen>
</informalexample>
      <para>Just copy the code after the Position ID into your the program's space (highlight it and press Ctrl-C) for the Position ID</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/66ed48bd.png"/>
        </imageobject>
      </mediaobject>
      <para>Now do the same for the Match ID, and that's all there is to it.</para>
    </sect2>
    <sect2 id="Checker_setup" xreflabel="Checker setup">
      <title>Checker setup</title>
      <para>Moving and setting up the checkers is quite easy and Snowie users will feel at home as the method is identical. To remove or add white checkers to a point for example, use the right mouse button and click on the point. You determine the number of checkers to be added or removed by the height of the point you press. For example, in the following diagram, </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/6a6ae1b7.png" scale="99"/>
        </imageobject>
      </mediaobject>
      <para>if you have 5 white checkers on the 19-point and only want to have 3, click with the right mouse button on the 3rd checker where the yellow arrow indicates and the top two will be removed. Adding checkers is the same, so if you wanted to add a red checker to the 6-point you would place the cursor where the green arrow indicates and left-click. If you want to quickly get the starting position, you can click on the area indicated by the blue ellipses on the left, and if you want to quickly clear the board of all checkers, click instead on the right side on the area indicated by the pink ellipses. Try it and experiment a little. It's much easier to do than to explain.</para>
      <para>Once the position is set up, press the Edit button again to exit Edit mode. Now just go to the Analyze menu and select Hint (suggested even for rollouts). Attention, this isn't a suggestion, you must exit the Edit mode before asking for GNU to evaluate the position otherwise you will get odd results.</para>
    </sect2>
  </sect1>
  <sect1 id="Appearance" xreflabel="Appearance">
    <title>Appearance</title>
    <sect2 id="Skins" xreflabel="Skins">
      <title>Skins</title>
      <para>You can change the overall appearance of the menus through a number of skins included with the installation, however this cannot be done from within the program and must done manually. The procedure is fairly painless if you aren't afraid of moving a couple of files in the Windows Explorer. </para>
      <para>Open Windows Explorer, and enter the \Program Files\gnubg directory. In it there is a directory called \Themes, where the skins are located, and in that, you will see a number of directories with the names of the skins they contain. Enter the directory you want and copy the files in it to the main \gnubg directory. It will ask you if you want to overwrite the files in it. Say yes, and start GNU to see the changes. It is important to copy and not move the files, so if you're not Windows savvy, this means holding the Ctrl key on the keyboard down while dragging the files. Keep the Ctrl key pressed when you let go of the mouse button.</para>
    </sect2>
    <sect2 id="Board_designs___2D_and_3D" xreflabel="Board designs">
      <title>Board designs – 2D and 3D</title>
      <para>The appearance of the boards can also be changed making use of a number of presets, or you can design your own. To make changes, go to the Settings menu and select Appearance. A window will appear, displaying a number of tabs at the top. Select Designs and you will see a list of the preset board designs, as well as thumbnails of what they look like. To choose one, just click on the name of the preset and press Ok. That's all there is to it.</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/6e75aa33.png" scale="99"/>
        </imageobject>
      </mediaobject>
      <para>If you'd like to enjoy a 3D board, go to the General tab, and select 3D board:</para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/4aad0142.png"/>
        </imageobject>
      </mediaobject>
      <para>Here and in the Lighting tab you can also set and control as much of the appearance as possible, allowing you also a great deal of creative possibilities. </para>
      <tip>
        <para>The 3D performance can suffer a little if you don't have a good video card, so if you find this to be your case, and would like to enjoy the 3D board, select Quick drawing:</para>
      </tip>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/m20a4701e.png"/>
        </imageobject>
      </mediaobject>
    </sect2>
    <sect2 id="Full_Screen_Board" xreflabel="Full Screen">
      <title>Full Screen Board</title>
      <para>You can also enjoy a full screen game, without panels, toolbars, or any other distractions, by going to the View menu, and selecting Full screen. If you have a large screen it can be quite an experience, and it can also be a nice way to play against a friend if you have no board nearby. </para>
      <mediaobject>
        <imageobject>
          <imagedata align="center" fileref="images/5ada89e8.png" scale="99"/>
        </imageobject>
      </mediaobject>
      <para>To exit the Full Screen mode, just press the Esc key.</para>
    </sect2>
    <sect2 id="Creating_Original_Designs" xreflabel="Creating Original Designs">
      <title>Creating Original Designs</title>
      <para>You can also make your own designs and save them. Using the tabs at the top, you can change the appearance of the board and if you really like your new design, go back to the Designs tab and save it by pressing Add current design and then Save designs. Send the GNU team your best ones, pressing the Export design button, and they may include them in the next release. <inlinegraphic fileref="images/m60d5424b.png"/> </para>
    </sect2>
  </sect1>
  <sect1 id="Conclusion" xreflabel="Conclusion">
    <title>Conclusion</title>
    <para>By now it should be clear that while a number of backgammon players have complained about the steep prices of top commercial software excluding them from the tools and type of progress available to more fortunate players, that complaint is now definitely without foundation. </para>
    <para>It's true that it is ever a work in progress and has its rough edges, but with time they will undoubtedly be ironed out for the most part. It is also an engine that is stronger than its older top-of-the-line siblings in GamesGrid, and at its price (free), one would have to be crazy not to have it, even if one does own the legendary Snowie. After all, two heads are better than one. </para>
    <para>I would like to effusively thank the authors of GNU Backgammon and its numerous contributors, and would also like to suggest that anyone enjoying their efforts make a contribution to the <ulink url="http://www.fsf.org/">Free Software Foundation</ulink> (FSF), the principal organizational sponsor of the GNU Project, as a token of appreciation. The FSF survives mostly off the contributions, however small, of private donations, and without it, those loud complaints mentioned above would be entirely justified. </para>
  </sect1>
  <sect1 id="A_Word_about__Cheating_" xreflabel="Cheating ">
    <title>A Word about <emphasis>Cheating</emphasis></title>
    <para>By far, the most common complaint seen about all backgammon software, weak or strong, is that it must be cheating to get so lucky. Most of these complaints stem from a lack of understanding of probabilities, and how skillful play will affect luck or the possibility of lucky rolls. </para>
    <para>To begin with, let it be stated that there is no bias of any kind, and the source code of GNU is open to any doubting it. If you still cannot believe it, feel free to use your own dice by entering the Settings menu and selecting Options, and then in the right side Manual dice. If you are rigorously honest about your results, you will find no difference in the long run.</para>
    <para>Probabilities are what rule supreme in backgammon. As there is indeed an uncontrollable luck factor, one cannot guarantee a victory or loss no matter how stacked up the chances are. So, good backgammon strategy is designed to maximize the good rolls for the playing side, and minimize the good rolls for the other side. In other words, after the best play, there will be fewer good rolls for the other side. If the other side doesn't realize what is happening, then it will seem like a never-ending streak of bad luck. It's not; it's the consequence of good playing. GNU is among the very best, so use it and learn with it. You can set it at a much weaker setting, and watch how its luck dries up.</para>
    <para>The mathematics behind probabilities are also usually very poorly understood. Take for example the situation below. If your opponent had a checker on the bar, what is his chance of entering that single point?</para>
    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="images/m634daa5.png"/>
      </imageobject>
    </mediaobject>
    <para>If you said 11 chances in 36 or a little over 30%, good for you, but if you said 1 in 6 then you need a little brushing up. 1 in 6 would be correct if your opponent were only using one die, but with two, the chances add up to 11 in 36. So how come you never enter and GNU does? It may seem like that at times, but it's really not the case. It is natural to focus more on what causes us anguish making reality look quite distorted, but maybe you were very unlucky. Stories of hard luck abound. In a live game, I once played my opening move, and then lost to a backgammon without ever playing another move. My opponent hit me, and I danced for the rest of the game. I wasn't even able to avoid a backgammon. A top professional once told me of an instance where he was giving a gammon, got hit, and lost after dancing 7 straight times against a 3-point board. Does it seem to get more doubles? What about those doubles you rolled while on the bar? They don't count, you say? Sorry, but lady luck makes no case of guaranteeing the double will arrive at the right time. Good strategy will help you be able to use it when it does arrive.</para>
  </sect1>
  <appendix id="legal" lang="en">
    <title lang="en">GNU Free Documentation License</title>
    <subtitle>Version 1.2, November 2002</subtitle>
    <anchor id="gfdl"/>
    <blockquote id="fsf-copyright">
      <para>Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. 59
        Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted
        to copy and distribute verbatim copies of this license document, but
        changing it is not allowed. </para>
    </blockquote>
    <sect1 id="gfdl-0" role="NotInToc">
      <title>PREAMBLE</title>
      <para> The purpose of this License is to make a manual, textbook, or other
        functional and useful document "free" in the sense of freedom: to assure
        everyone the effective freedom to copy and redistribute it, with or
        without modifying it, either commercially or noncommercially.
        Secondarily, this License preserves for the author and publisher a way
        to get credit for their work, while not being considered responsible for
        modifications made by others. </para>
      <para> This License is a kind of "copyleft", which means that derivative
        works of the document must themselves be free in the same sense. It
        complements the GNU General Public License, which is a copyleft license
        designed for free software. </para>
      <para> We have designed this License in order to use it for manuals for
        free software, because free software needs free documentation: a free
        program should come with manuals providing the same freedoms that the
        software does. But this License is not limited to software manuals; it
        can be used for any textual work, regardless of subject matter or
        whether it is published as a printed book. We recommend this License
        principally for works whose purpose is instruction or reference. </para>
    </sect1>
    <sect1 id="gfdl-1" role="NotInToc">
      <title>APPLICABILITY AND DEFINITIONS</title>
      <para id="gfdl-doc"> This License applies to any manual or other work, in
        any medium, that contains a notice placed by the copyright holder saying
        it can be distributed under the terms of this License. Such a notice
        grants a world-wide, royalty-free license, unlimited in duration, to use
        that work under the conditions stated herein. The "Document", below,
        refers to any such manual or work. Any member of the public is a
        licensee, and is addressed as "you". You accept the license if you copy,
        modify or distribute the work in a way requiring permission under
        copyright law. </para>
      <para id="gfdl-mod-ver"> A "Modified Version"  of the Document means any
        work containing the Document or a portion of it, either copied verbatim,
        or with modifications and/or translated into another language. </para>
      <para id="gfdl-secnd-sect"> A "Secondary Section"  is a named appendix or a
        front-matter section of the Document that deals exclusively with the
        relationship of the publishers or authors of the Document to the
        Document's overall subject (or to related matters) and contains nothing
        that could fall directly within that overall subject. (Thus, if the
        Document is in part a textbook of mathematics, a Secondary Section may
        not explain any mathematics.) The relationship could be a matter of
        historical connection with the subject or with related matters, or of
        legal, commercial, philosophical, ethical or political position
        regarding them. </para>
      <para id="gfdl-inv-sect"> The "Invariant Sections"  are certain Secondary
        Sections whose titles are designated, as being those of Invariant
        Sections, in the notice that says that the Document is released under
        this License. If a section does not fit the above definition of
        Secondary then it is not allowed to be designated as Invariant. The
        Document may contain zero Invariant Sections. If the Document does not
        identify any Invariant Sections then there are none. </para>
      <para id="gfdl-cov-text"> The "Cover Texts"  are certain short passages of
        text that are listed, as Front-Cover Texts or Back-Cover Texts, in the
        notice that says that the Document is released under this License. A
        Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at
        most 25 words. </para>
      <para id="gfdl-transparent"> A "Transparent"  copy of the Document means a
        machine-readable copy, represented in a format whose specification is
        available to the general public, that is suitable for revising the
        document straightforwardly with generic text editors or (for images
        composed of pixels) generic paint programs or (for drawings) some widely
        available drawing editor, and that is suitable for input to text
        formatters or for automatic translation to a variety of formats suitable
        for input to text formatters. A copy made in an otherwise Transparent
        file format whose markup, or absence of markup, has been arranged to
        thwart or discourage subsequent modification by readers is not
        Transparent. An image format is not Transparent if used for any
        substantial amount of text. A copy that is not "Transparent" is called
        "Opaque". </para>
      <para> Examples of suitable formats for Transparent copies include plain
        ASCII without markup, Texinfo input format, LaTeX input format, SGML or
        XML using a publicly available DTD, and standard-conforming simple HTML,
        PostScript or PDF designed for human modification. Examples of
        transparent image formats include PNG, XCF and JPG. Opaque formats
        include proprietary formats that can be read and edited only by
        proprietary word processors, SGML or XML for which the DTD and/or
        processing tools are not generally available, and the machine-generated
        HTML, PostScript or PDF produced by some word processors for output
        purposes only. </para>
      <para id="gfdl-title-page"> The "Title Page"  means, for a printed book,
        the title page itself, plus such following pages as are needed to hold,
        legibly, the material this License requires to appear in the title page.
        For works in formats which do not have any title page as such, "Title
        Page" means the text near the most prominent appearance of the work's
        title, preceding the beginning of the body of the text. </para>
      <para id="gfdl-entitled"> A section "Entitled XYZ"  means a named subunit
        of the Document whose title either is precisely XYZ or contains XYZ in
        parentheses following text that translates XYZ in another language.
        (Here XYZ stands for a specific section name mentioned below, such as
        "Acknowledgements", "Dedications", "Endorsements", or "History".) To
        "Preserve the Title" of such a section when you modify the Document
        means that it remains a section "Entitled XYZ" according to this
        definition. </para>
      <para> The Document may include Warranty Disclaimers next to the notice
        which states that this License applies to the Document. These Warranty
        Disclaimers are considered to be included by reference in this License,
        but only as regards disclaiming warranties: any other implication that
        these Warranty Disclaimers may have is void and has no effect on the
        meaning of this License. </para>
    </sect1>
    <sect1 id="gfdl-2" role="NotInToc">
      <title>VERBATIM COPYING</title>
      <para> You may copy and distribute the Document in any medium, either
        commercially or noncommercially, provided that this License, the
        copyright notices, and the license notice saying this License applies to
        the Document are reproduced in all copies, and that you add no other
        conditions whatsoever to those of this License. You may not use
        technical measures to obstruct or control the reading or further copying
        of the copies you make or distribute. However, you may accept
        compensation in exchange for copies. If you distribute a large enough
        number of copies you must also follow the conditions in section3. </para>
      <para> You may also lend copies, under the same conditions stated above,
        and you may publicly display copies. </para>
    </sect1>
    <sect1 id="gfdl-3" role="NotInToc">
      <title>COPYING IN QUANTITY</title>
      <para> If you publish printed copies (or copies in media that commonly
        have printed covers) of the Document, numbering more than 100, and the
        Document's license notice requires Cover Texts, you must enclose the
        copies in covers that carry, clearly and legibly, all these Cover Texts:
        Front-Cover Texts on the front cover, and Back-Cover Texts on the back
        cover. Both covers must also clearly and legibly identify you as the
        publisher of these copies. The front cover must present the full title
        with all words of the title equally prominent and visible. You may add
        other material on the covers in addition. Copying with changes limited
        to the covers, as long as they preserve the title of the Document and
        satisfy these conditions, can be treated as verbatim copying in other
        respects. </para>
      <para> If the required texts for either cover are too voluminous to fit
        legibly, you should put the first ones listed (as many as fit
        reasonably) on the actual cover, and continue the rest onto adjacent
        pages. </para>
      <para> If you publish or distribute Opaque copies of the Document
        numbering more than 100, you must either include a machine-readable
        Transparent copy along with each Opaque copy, or state in or with each
        Opaque copy a computer-network location from which the general
        network-using public has access to download using public-standard
        network protocols a complete Transparent copy of the Document, free of
        added material. If you use the latter option, you must take reasonably
        prudent steps, when you begin distribution of Opaque copies in quantity,
        to ensure that this Transparent copy will remain thus accessible at the
        stated location until at least one year after the last time you
        distribute an Opaque copy (directly or through your agents or retailers)
        of that edition to the public. </para>
      <para> It is requested, but not required, that you contact the authors of
        the Document well before redistributing any large number of copies, to
        give them a chance to provide you with an updated version of the
        Document. </para>
    </sect1>
    <sect1 id="gfdl-4">
      <title>MODIFICATIONS</title>
      <para> You may copy and distribute a Modified Version of the Document
        under the conditions of sections 2 and 3 above, provided that you
        release the Modified Version under precisely this License, with the
        Modified Version filling the role of the Document, thus licensing
        distribution and modification of the Modified Version to whoever
        possesses a copy of it. In addition, you must do these things in the
        Modified Version: </para>
      <orderedlist continuation="restarts" id="gfdl-modif-cond" inheritnum="ignore" numeration="upperalpha">
        <listitem>
          <simpara> Use in the Title Page (and on the covers, if any) a title
            distinct from that of the Document, and from those of previous
            versions (which should, if there were any, be listed in the History
            section of the Document). You may use the same title as a previous
            version if the original publisher of that version gives permission.
          </simpara>
        </listitem>
        <listitem>
          <simpara> List on the Title Page, as authors, one or more persons or
            entities responsible for authorship of the modifications in the
            Modified Version, together with at least five of the principal
            authors of the Document (all of its principal authors, if it has
            fewer than five), unless they release you from this requirement.
          </simpara>
        </listitem>
        <listitem>
          <simpara> State on the Title page the name of the publisher of the
            Modified Version, as the publisher. </simpara>
        </listitem>
        <listitem>
          <simpara> Preserve all the copyright notices of the Document.
          </simpara>
        </listitem>
        <listitem>
          <simpara> Add an appropriate copyright notice for your modifications
            adjacent to the other copyright notices. </simpara>
        </listitem>
        <listitem>
          <simpara> Include, immediately after the copyright notices, a license
            notice giving the public permission to use the Modified Version
            under the terms of this License, in the form shown in the section
            Addendum below. </simpara>
        </listitem>
        <listitem>
          <simpara> Preserve in that license notice the full lists of Invariant
            Sections and required Cover Texts given in the Document's license
            notice. </simpara>
        </listitem>
        <listitem>
          <simpara> Include an unaltered copy of this License. </simpara>
        </listitem>
        <listitem>
          <simpara> Preserve the section Entitled "History", Preserve its Title,
            and add to it an item stating at least the title, year, new authors,
            and publisher of the Modified Version as given on the Title Page. If
            there is no section Entitled "History" in the Document, create one
            stating the title, year, authors, and publisher of the Document as
            given on its Title Page, then add an item describing the Modified
            Version as stated in the previous sentence. </simpara>
        </listitem>
        <listitem>
          <simpara> Preserve the network location, if any, given in the Document
            for public access to a Transparent copy of the Document, and
            likewise the network locations given in the Document for previous
            versions it was based on. These may be placed in the "History"
            section. You may omit a network location for a work that was
            published at least four years before the Document itself, or if the
            original publisher of the version it refers to gives permission.
          </simpara>
        </listitem>
        <listitem>
          <simpara> For any section Entitled "Acknowledgements" or
            "Dedications", Preserve the Title of the section, and preserve in
            the section all the substance and tone of each of the contributor
            acknowledgements and/or dedications given therein. </simpara>
        </listitem>
        <listitem>
          <simpara> Preserve all the Invariant Sections of the Document,
            unaltered in their text and in their titles. Section numbers or the
            equivalent are not considered part of the section titles. </simpara>
        </listitem>
        <listitem>
          <simpara> Delete any section Entitled "Endorsements". Such a section
            may not be included in the Modified Version. </simpara>
        </listitem>
        <listitem>
          <simpara> Do not retitle any existing section to be Entitled
            "Endorsements" or to conflict in title with any Invariant Section.
          </simpara>
        </listitem>
        <listitem>
          <simpara> Preserve any Warranty Disclaimers. </simpara>
        </listitem>
      </orderedlist>
      <para> If the Modified Version includes new front-matter sections or
        appendices that qualify as Secondary Sections and contain no material
        copied from the Document, you may at your option designate some or all
        of these sections as invariant. To do this, add their titles to the list
        of Invariant Sections in the Modified Version's license notice. These
        titles must be distinct from any other section titles. </para>
      <para> You may add a section Entitled "Endorsements", provided it contains
        nothing but endorsements of your Modified Version by various
        parties--for example, statements of peer review or that the text has
        been approved by an organisation as the authoritative definition of a
        standard. </para>
      <para> You may add a passage of up to five words as a Front-Cover Text,
        and a passage of up to 25 words as a Back-Cover Text, to the end of the
        list of Cover Texts in the Modified Version. Only one passage of
        Front-Cover Text and one of Back-Cover Text may be added by (or through
        arrangements made by) any one entity. If the Document already includes a
        cover text for the same cover, previously added by you or by arrangement
        made by the same entity you are acting on behalf of, you may not add
        another; but you may replace the old one, on explicit permission from
        the previous publisher that added the old one. </para>
      <para> The author(s) and publisher(s) of the Document do not by this
        License give permission to use their names for publicity for orto assert
        or imply endorsement of any Modified Version. </para>
    </sect1>
    <sect1 id="gfdl-5" role="NotInToc">
      <title>COMBINING DOCUMENTS</title>
      <para> You may combine the Document with other documents released under
        this License, under the terms defined in section 4 above for modified
        versions, provided that you include in the combination all of the
        Invariant Sections of all of the original documents, unmodified, and
        list them all as Invariant Sections of your combined work in its license
        notice, and that you preserve all their Warranty Disclaimers. </para>
      <para> The combined work need only contain one copy of this License, and
        multiple identical Invariant Sections may be replaced with a single
        copy. If there are multiple Invariant Sections with the same name but
        different contents, make the title of each such section unique by adding
        at the end of it, in parentheses, the name of the original author or
        publisher of that section if known, or else a unique number. Make the
        same adjustment to the section titles in the list of Invariant Sections
        in the license notice of the combined work. </para>
      <para> In the combination, you must combine any sections Entitled
        "History" in the various original documents, forming one section
        Entitled "History"; likewise combine any sections Entitled
        "Acknowledgements", and any sections Entitled "Dedications". You must
        delete all sections Entitled "Endorsements". </para>
    </sect1>
    <sect1 id="gfdl-6" role="NotInToc">
      <title>COLLECTIONS OF DOCUMENTS</title>
      <para> You may make a collection consisting of the Document and other
        documents released under this License, and replace the individual copies
        of this License in the various documents with a single copy that is
        included in the collection, provided that you follow the rules of this
        License for verbatim copying of each of the documents in all other
        respects. </para>
      <para> You may extract a single document from such a collection, and
        distribute it individually under this License, provided you insert a
        copy of this License into the extracted document, and follow this
        License in all other respects regarding verbatim copying of that
        document. </para>
    </sect1>
    <sect1 id="gfdl-7" role="NotInToc">
      <title>AGGREGATION WITH INDEPENDENT WORKS</title>
      <para> A compilation of the Document or its derivatives with other
        separate and independent documents or works, in or on a volume of a
        storage or distribution medium, is called an "aggregate" if the
        copyright resulting from the compilation is not used to limit the legal
        rights of the compilation's users beyond what the individual works
        permit. When the Document is included in an aggregate, this License does
        not apply to the other works in the aggregate which are not themselves
        derivative works of the Document. </para>
      <para> If the Cover Text requirement of section 3 is applicable to these
        copies of the Document, then if the Document is less than one half of
        the entire aggregate, the Document's Cover Texts may be placed on covers
        that bracket the Document within the aggregate, or the electronic
        equivalent of covers if the Document is in electronic form. Otherwise
        they must appear on printed covers that bracket the whole aggregate.
      </para>
    </sect1>
    <sect1 id="gfdl-8" role="NotInToc">
      <title>TRANSLATION</title>
      <para> Translation is considered a kind of modification, so you may
        distribute translations of the Document under the terms of section 4.
        Replacing Invariant Sections with translations requires special
        permission from their copyright holders, but you may include
        translations of some or all Invariant Sections in addition to the
        original versions of these Invariant Sections. You may include a
        translation of this License, and all the license notices in the
        Document, and any Warranty Disclaimers, provided that you also include
        the original English version of this License and the original versions
        of those notices and disclaimers. In case of a disagreement between the
        translation and the original version of this License or a notice or
        disclaimer, the original version will prevail. </para>
      <para> If a section in the Document is Entitled "Acknowledgements",
        "Dedications", or "History", the requirement (section 4) to Preserve its
        Title (section 1) will typically require changing the actual title.
      </para>
    </sect1>
    <sect1 id="gfdl-9" role="NotInToc">
      <title>TERMINATION</title>
      <para> You may not copy, modify, sublicense, or distribute the Document
        except as expressly provided for under this License. Any other attempt
        to copy, modify, sublicense or distribute the Document is void, and will
        automatically terminate your rights under this License. However, parties
        who have received copies, or rights, from you under this License will
        not have their licenses terminated so long as such parties remain in
        full compliance. </para>
    </sect1>
    <sect1 id="gfdl-10" role="NotInToc">
      <title>FUTURE REVISIONS OF THIS LICENSE</title>
      <para> The Free Software Foundation may publish new, revised versions of
        the GNU Free Documentation License from time to time. Such new versions
        will be similar in spirit to the present version, but may differ in
        detail to address new problems or concerns. See
        http://www.gnu.org/copyleft/. </para>
      <para> Each version of the License is given a distinguishing version
        number. If the Document specifies that a particular numbered version of
        this License "or any later version" applies to it, you have the option
        of following the terms and conditions either of that specified version
        or of any later version that has been published (not as a draft) by the
        Free Software Foundation. If the Document does not specify a version
        number of this License, you may choose any version ever published (not
        as a draft) by the Free Software Foundation. </para>
    </sect1>
    <sect1 id="gfdl-addendum">
      <title>ADDENDUM: How to use this License for your documents</title>
      <para> To use this License in a document you have written, include a copy
        of the License in the document and put the following copyright and
        license notices just after the title page: </para>
      <blockquote id="copyright-sample">
        <para> Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
          distribute and/or modify this document under the terms of the GNU Free
          Documentation License, Version 1.2 or any later version published by
          the Free Software Foundation; with no Invariant Sections, no
          Front-Cover Texts, and no Back-Cover Texts. A copy of the license is
          included in the section entitled "GNU Free Documentation License".
        </para>
      </blockquote>
      <para> If you have Invariant Sections, Front-Cover Texts and Back-Cover
        Texts, replace the "with...Texts." line with this: </para>
      <blockquote id="inv-cover-sample">
        <para> with the Invariant Sections being LIST THEIR TITLES, with the
          Front-Cover Texts being LIST, and with the Back-Cover Texts being
          LIST. </para>
      </blockquote>
      <para> If you have Invariant Sections without Cover Texts, or some other
        combination of the three, merge those two alternatives to suit the
        situation. </para>
      <para> If your document contains nontrivial examples of program code, we
        recommend releasing these examples in parallel under your choice of free
        software license, such as the GNU General Public License, to permit
        their use in free software. </para>
    </sect1>
  </appendix>
</article>
