<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.12">
  <!ENTITY manrevision "2.8">
  <!ENTITY date "September 2004">
  <!ENTITY app "<application>Blackjack</application>">
  <!ENTITY appname "Blackjack">
  <!-- Information about the entities
       The legal.xml file contains legal information, there is no need to edit the file. 
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
       Use the app entity to specify the name of the application. -->
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&app; Manual</title>       
    <abstract role="description">
      <para>
	Blackjack is a casino rules, multiple deck blackjack game for the GNOME
	Project.  The object of the game is to obtain a hand value that is closer
	to 21 than that of the dealer, without going over 21. The player bets
	with virtual chips.
      </para>
    </abstract>

    <copyright> 
      <year>2003</year> 
      <holder>William Jon McCann</holder> 
    </copyright> 

<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

    <authorgroup> 
      <author role="maintainer">
		<firstname>William Jon</firstname> 
		<surname>McCann</surname> 
		<affiliation> 
	  		<orgname></orgname> 
	  		<address> <email>mccann@jhu.edu</email> </address> 
		</affiliation> 
      </author> 
      
<!-- This is appropriate place for other contributors: translators,
     maintainers,  etc. Commented out by default.
     
      <othercredit role="translator">
		<firstname>Latin</firstname> 
		<surname>Translator 1</surname> 
		<affiliation> 
	  		<orgname>Latin Translation Team</orgname> 
	  		<address> <email>translator@gnome.org</email> </address> 
		</affiliation>
		<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>


<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->  
    <revhistory>
      <revision> 
		<revnumber>&appname; Manual V&manrevision;</revnumber> 
		<date>&date;</date> 
		<revdescription> 
	  		<para role="author">William Jon McCann
	    	<email>mccann@jhu.edu</email>
	  		</para>
	  		<para role="publisher"></para>
		</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &appname;.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
      this manual, follow the directions in the <ulink url="ghelp:gnome-feedback"
	  type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>&appname;</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>mygnomeapp</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="blackjack-introduction"> 

    <title>Introduction</title> 

    <para>&app; is a multiple deck, casino rules blackjack game.  The object
    of the game is to hold cards having a higher count than those of the dealer
    without going over 21.</para>
  </sect1>

  <sect1 id="blackjack-basics">
    <title>Blackjack Basics</title>

    <sect2 id="blackjack-terms">
    <title>Blackjack Terminology</title>
    <para>Here are a few important terms that are used in the game.</para>
    <para>
        <variablelist>
	<varlistentry>
	<term>Blackjack</term>
	<listitem>
	<para>A hand whose first two cards total 21; an instant win worth 150% of your wager</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Bust</term>
	<listitem>
	<para>When the value of a hand exceeds 21; a losing hand</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Double down</term>
	<listitem>
	<para>To double the initial wager and receive exactly one more
        card</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Hit</term>
	<listitem>
	<para>To request another card to be added to the hand</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Insurance</term>
	<listitem>
	<para>A side wager of 50% of the original wager that the dealer 
        has a natural 21 (aka blackjack) that
        is offered when the dealer's face up card is an ace.  If the dealer has
        a natural 21 then the player is paid double.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Push</term>
	<listitem>
	<para>When the value of the player hand and the dealer hand are 
        equal, the original wager is returned to the player</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Split</term>
	<listitem>
	<para>When a hand starts with two cards of the same value (or rank)
        it may be split to form two independent hands</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Stand</term>
	<listitem>
	<para>To stop adding cards to a hand</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Surrender</term>
	<listitem>
        <para>To give up half your wager to not complete the hand</para>
	</listitem>
	</varlistentry>

        </variablelist>
    </para>
    </sect2>

    <sect2 id="blackjack-card-values">
    <title>Card Values</title>
    <para>
    In blackjack, each card is assigned a value.
	<itemizedlist> 
	  <listitem> 
           <para>An Ace can count as either 1 or 11.</para>
	  </listitem> 
	  <listitem> 
           <para>The cards 2 through 9 are valued as indicated.</para>
	  </listitem> 
	  <listitem> 
           <para>The 10, Jack, Queen, and King are all valued at 10.</para>
	  </listitem> 
	</itemizedlist>
    </para> 

    <para>The value of a hand is the sum of the values of each card in the hand.
    
    </para>
    </sect2>

    <sect2 id="blackjack-dealer-rules">
    <title>Dealer Rules</title>
    <para>
    The dealer must play his hand according to very specific rules.  There
    are two basic rule variations that determine what hand total the dealer
    must draw to.
        <variablelist>
	<varlistentry>
	<term>Dealer stands on all 17s</term>
	<listitem>
	<para>The dealer must continue to draw cards (hit) until the
        hand total is at least 17.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Dealer hits soft 17</term>
	<listitem>
	<para>The dealer must continue to draw cards (hit) until the
        hand total is at least 17, except when the dealer has a soft total of 17
        he must take another card.
        A soft total is one where an Ace card is counted as an 11.  
        </para>
	</listitem>
	</varlistentry>
        </variablelist>
    </para>
    </sect2>

  </sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here. 
     If the information about how to get started is very short, you can 
     include it in the Introduction and omit this section. -->

  <sect1 id="blackjack-getting-started"> 
    <title>Getting Started</title> 

    <sect2 id="blackjack-start">
    <title>To Start &app;</title>
    <para>You can start &app; in the following ways:
    </para> 
    <variablelist>
    	<varlistentry>
    		<term><guimenu>Applications</guimenu> menu</term>
    		<listitem>
    		<para>Choose 
    		<menuchoice>
    		<guisubmenu>Games </guisubmenu>
    		<guimenuitem>&appname;</guimenuitem>
    		</menuchoice>. </para>
    		</listitem>
    	</varlistentry>
    	<varlistentry>
    		<term>Command line</term>
    		<listitem>
    		<para>To start &app; from a command line, type the following command, 
    		then press <keycap>Return</keycap>:</para>
    		<para> 
			<command>blackjack</command> 
    		</para> 
    		</listitem>
    	</varlistentry>
    </variablelist>
    </sect2>

    <sect2 id="blackjack-when-start">
    <title>When You Start &app;</title>
    <para>When you start &app;, the following window is displayed.</para>

    <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
	<title>&app; Start Up Window</title> 
	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/blackjack_start_window.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/image.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Shows &app; main window. Contains titlebar, menubar, toolbar, playing area, and
	      scrollbars. Menubar contains Game, Settings, and Help menus. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

    <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
    <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->

    <para>The &app; window contains the following elements:
    </para>
      <variablelist>

	<varlistentry>
	<term>Menubar</term>
	<listitem>
	<para>The menus on the menubar contain all of the commands you need to work with files in 
	&app;.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Toolbar</term>
	<listitem>
	<para> The toolbar contains a subset of the commands that you can access from the menubar.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Statusbar</term>
	<listitem>
	<para>The statusbar displays information about current &app; 
	activity and contextual information about the menu items. </para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term>Playing area</term>
	<listitem>
	<para>The playing area contains the dealer position, player position, player wager stack,
        and the player's chips.</para>
	</listitem>
	</varlistentry>

	</variablelist>
    </sect2>

    <sect2 id="blackjack-menus">
    <title>&app; Menus</title>
      <para>
        The menu bar, located above the <interface>game table</interface>,
        contains the following menus:
      </para>

      <variablelist>

        <!-- ===== Game ===== -->

        <varlistentry>
          <term><guimenu>Game</guimenu></term>
          <listitem>
            <para>
              This menu contains these items:
              <itemizedlist>
                <listitem>
                  <para>
                    <menuchoice>
                      <shortcut><keysym>Ctrl-N</keysym></shortcut>
                      <guimenuitem>New game</guimenuitem>
                    </menuchoice>
                    &mdash;
                    This clears the table and starts a new game.
                  </para>
                </listitem>

                <listitem>
                  <para>
                    <menuchoice>
                      <guimenuitem>Restart game</guimenuitem>
                    </menuchoice>
                    &mdash;
                    This clears the table and restarts the game.
                  </para>
                </listitem>

                <listitem>
                  <para>
                    <menuchoice>
                      <guimenuitem>Hint</guimenuitem>
                    </menuchoice>
                    &mdash;
                    This will give you the computer's best suggestion for your
                    move.
                  </para>
                </listitem>

                <listitem>
                  <para>
                    <menuchoice>
                      <shortcut><keysym>Ctrl-Q</keysym></shortcut>
                      <guimenuitem>Exit</guimenuitem>
                    </menuchoice>
                    &mdash;
                    This quits the game.
                  </para>
                </listitem>

              </itemizedlist>
            </para>
          </listitem>
        </varlistentry>

        <!-- ===== Settings ===== -->

        <varlistentry>
          <term><guimenu>Settings</guimenu></term>
          <listitem>
            <para>
              This menu contains these items:
              <itemizedlist>

                <listitem>
                  <para>
                    <guimenuitem>Show tool bar</guimenuitem>
                    &mdash;
                    This toggle switches the tool bar on and off.
                  </para>
                </listitem>

                <listitem>
                  <para>
                    <guimenuitem>Preferences&hellip;</guimenuitem>
                    &mdash;
                    This opens the <interface>Preferences Dialog</interface>,
                    allowing you to configure the game.
                  </para>
                </listitem>

              </itemizedlist>
            </para>
          </listitem>
        </varlistentry>

        <!-- ===== Help ===== -->

        <varlistentry>
          <term><guimenu>Help</guimenu></term>
          <listitem>
            <para>
              This menu contains:
              <itemizedlist>

                <listitem>
                  <para>
                    <guimenuitem>Contents</guimenuitem>
                    &mdash;
                    Opens your help browser and shows this manual.
                  </para>
                </listitem>

                <listitem>
                  <para>
                    <guimenuitem>About</guimenuitem>
                    &mdash;
                    Opens the <interface>About Dialog</interface>, showing
                    basic information about &app; such as its version
                    number and the names of its authors.
                  </para>
                </listitem>

              </itemizedlist>
            </para>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect2>

    <sect2 id="blackjack-playing-area">
    <title>&app; Playing Area</title>
      <para>
        The playing area (or table), located below the <interface>toolbar</interface>,
        contains the following elements:
      </para>

      <variablelist>

        <varlistentry>
          <term><interface>Dealer position</interface></term>
          <listitem><para>
          This is where the dealer hand will be placed.  It is located at the
          top of the playing area.  On a clear table it will appear as a white
          outlined region.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Player positions</interface></term>
          <listitem><para>
          This is where the player's hands will be placed.  Initially,
          there will be only one player position.  More will be created if
          the player splits a hand.  On a clear table they will appear as white
          outlines below the dealer position.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Player wager stack</interface></term>
          <listitem><para>
          The wager stack represents the initial wager on each hand.  It consists
          of a stack of chips located directly to the left of each player position.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Player chips</interface></term>
          <listitem><para>
          The player's chips represent an infinite stack of chips for
          each of the chip values 100, 25, 5, and 1.  These chips are used
          to modify the wager.
          </para></listitem>
        </varlistentry>

      </variablelist>

    </sect2>

  </sect1>

<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for 
  which the application is designed. -->
  <sect1 id="blackjack-usage"> 
    <title>Usage</title> 
    <para>
      <itemizedlist> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-set-wager"/></para> 
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-deal"/></para> 
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-hit"/></para> 
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-stand"/></para>
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-double-down"/></para> 
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-split"/></para>
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-surrender"/></para>
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-get-hint"/></para>
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="blackjack-usage-keyboard-control"/></para>
	</listitem> 
      </itemizedlist> </para>
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-set-wager"> 
      <title>To Set the Wager</title> 
      <para>To increase the wager for the hand:
      <itemizedlist>
        <listitem>
         <para>Double click on the player chip, located along the lower edge 
         of the playing area, that you wish to add to your wager.</para>
        </listitem>
        <listitem>
         <para>Or, drag the desired chip onto your wager stack, located next to your hand.</para>
        </listitem>
      </itemizedlist>
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-deal"> 
      <title>To Deal a New Hand</title> 
      <para>
      A new hand can be dealt when the table is clear or when play has finished
      on the current hands.
      </para>
      <para>
      To deal a new hand on a clear table, click in the white outlines that
      indicate the dealer or player positions.
      </para>
      <para>
      To deal a new hand after play has finished on the current hands, click
      once on any of the cards on the table.
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-hit"> 
      <title>To Add a Card to a Hand (Hit)</title> 
      <para>
      You may add cards to a hand until the hand total is 21 or over.
      </para>
      <para>
      To add a card to a player's hand, click once on any card in the hand.
      </para>
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-stand"> 
      <title>To Stop Taking Cards (Stand)</title> 
      <para>
      You may stop taking cards at any time after the first two cards have been dealt.
      </para>
      <para>
      To stop adding cards to a hand, click once on any other hand.  For example,
      when there is only one player position (ie. you have not split a pair), click
      on the dealer's hand to stand.  When you have split a pair, you may stand on the
      first player hand by clicking on the second player hand, or the dealer hand.
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-double-down"> 
      <title>To Double Down</title> 
      <para>
      To double down, double click on any of the player chips after the first two
      cards have been dealt.
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-split"> 
      <title>To Split Pairs</title> 
      <para>
      To split a pair, drag the top card of the hand off the player
      position and drop on any empty space on the table.
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-surrender"> 
      <title>To Surrender</title> 
      <para>
      Not yet implemented.
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-get-hint"> 
      <title>Get a hint</title> 
      <para>
      At any time you may ask the game for a hint.  To do this either click
      on the <interface>Hint</interface> button on the <interface>toolbar</interface>,
      or choose the 
      <menuchoice>
    	<guisubmenu>Game </guisubmenu>
    	<guimenuitem>Hint</guimenuitem>
    	</menuchoice> menu item.
      </para>
    </sect2> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="blackjack-usage-keyboard-control"> 
      <title>Keyboard control</title> 
      <para>
      Most of the operations in the game can be controlled from keyboard input.
      <table><title>Control keys</title>
      <tgroup cols="2" align="left" colsep="1" rowsep="1">
      <thead><row><entry>Action</entry><entry>Key</entry></row></thead>
      <tbody>
      <row><entry>Deal new hand</entry><entry>ENTER</entry></row>
      <row><entry>Hit / Add card</entry><entry>H</entry></row>
      <row><entry>Stand / Finish hand</entry><entry>S</entry></row>
      <row><entry>Double down</entry><entry>D</entry></row>
      <row><entry>Split hand</entry><entry>P</entry></row>
      <row><entry>Surrender hand</entry><entry>R</entry></row>
      </tbody>
      </tgroup>
      </table>
      </para>
    </sect2> 
  </sect1>

  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="blackjack-prefs"> 
    <title>Settings</title> 
    <para>To configure &app;, choose 
      <menuchoice> 
	<guimenu>Settings</guimenu> 
	<guimenuitem>Preferences</guimenuitem> 
      </menuchoice>. The 
      <guilabel>Preferences</guilabel> dialog contains the following tabbed
      sections:</para> 
    <itemizedlist> 
      <listitem> 
	<para> 
	  <xref linkend="blackjack-prefs-game"/></para> 
      </listitem> 
      <listitem> 
	<para> 
	  <xref linkend="blackjack-prefs-rules"/></para> 
      </listitem> 
      <listitem> 
	<para> 
	  <xref linkend="blackjack-prefs-cards"/></para> 
      </listitem> 
    </itemizedlist>
<!-- =============== Customization Subsection ================ -->
<!-- Use a new section to describe different tabbed sections on the Settings or Preferences
	     dialog. -->
    <sect2 id="blackjack-prefs-game"> 
      <title>Game</title> 
      <variablelist> 
	<varlistentry> 
	  <term> 
	    <guilabel>Display hand probabilities</guilabel> </term> 
	  <listitem> 
	    <para>Select this item to display dealer hand probabilities and
            expected values for the various player options.</para>
	  </listitem> 
	</varlistentry> 

	<varlistentry> 
	  <term> 
	    <guilabel>Quick deals</guilabel> </term> 
	  <listitem> 
	    <para>Select this item to make the computer deal cards without a delay</para>
	  </listitem> 
	</varlistentry> 

      </variablelist> 
    </sect2>

    <!-- ============= Customization Subsection ===================== -->
    <!-- Another tabbed section on the Preferences dialog. -->
    <sect2 id="blackjack-prefs-rules"> 
      <title>Rules</title> 
      <para>Select rule variations from the list.</para>
    </sect2> 

    <!-- ============= Customization Subsection ===================== -->
    <!-- Another tabbed section on the Preferences dialog. -->
    <sect2 id="blackjack-prefs-cards"> 
      <title>Cards</title> 
      <para>Customize the appearance of the playing cards.</para>
    </sect2> 

  </sect1>

<!-- ============= Advanced ================================== -->
  <sect1 id="blackjack-advanced">
  <title>Advanced</title>
  <para>
  </para>

  <sect2 id="blackjack-advanced-probabilities">
    <title>Dealer Probabilities</title>
    <para>
    When the <guilabel>Show dealer probabilities</guilabel> option is
    selected in the <guilabel>Game</guilabel> tab of the <guilabel>Preferences</guilabel>
    dialog, the exact probabilities of each possible outcome of the dealer's hand
    are displayed over the table surface, to the left of the dealer's hand.  The
    probabilities range from zero to one, where zero means impossible and one means
    certain.  These probabilities take into account all cards dealt from the shoe.
    </para>
  </sect2>

  <sect2 id="blackjack-advanced-expected-values">
    <title>Player Expected Values</title>
    <para>
    When the <guilabel>Show dealer probabilities</guilabel> option is
    selected in the <guilabel>Game</guilabel> tab of the <guilabel>Preferences</guilabel>
    dialog, the exact expected values (in percent of initial bet) of each available player
    option are displayed over the table surface, to the left of the dealer's hand.  These
    values take into account all cards in your current hand and the dealer's face up card.
    For example, suppose the number displayed for standing is -12.345.  This means that
    if you played out the current situation many, many times, standing each time, with a 1.00
    initial wager, then on average you would lose 0.12345.
    </para>
  </sect2>

 </sect1>

<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default. 
     You can use it to describe known bugs and limitations of the 
	  program if there are any - please be frank and list all
     problems you know of. 
  
  <sect1 id="blackjack-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->

<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  <sect1 id="blackjack-about"> 
    <title>About &app;</title> 
    <para> &app; was written by William Jon McCann
      (<email>mccann@jhu.edu</email>).</para>
    <para>
      To report a bug or make a suggestion regarding this application or
      this manual, follow the directions in this 
      <ulink url="ghelp:gnome-feedback"   type="help">document</ulink>.
    </para>

    <para> This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; either version 2 of the License, or (at your option)
      any later version. A copy of this license can be found at this
      <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
      COPYING included with the source code of this program. </para>

  </sect1> 
</article>
