-p for progress

Author: gtheler

doc/blackjack.md

@@ -33,11 +33,17 @@ documentclass: report
     1. study
     2. change
     3. re-distribute
+    
+> This manual is like an implicit equation.
 
 ## Why
 
 Since blackjack is not straightforward to analyze with analytical statistics equations, a monte-carlo-based approach is needed.
 
+ * compute evs and sds for different rules, decks and strategies
+ * study arranged shoes
+ * ...
+
 
 ## How
 
@@ -180,7 +186,7 @@ In the most basic case, an automated player reads messages from the dealer from
 These messages have to answered by the user.
 If an invalid answer is received, an informative message (@sec:informative) with a complain will be sent and then the same interrogative message will be re-sent.
 
-```include
+```{.include shift-heading-level-by=3}
 commands-int.md
 ```
 
@@ -189,7 +195,7 @@ commands-int.md
 For basic players, all of the informative messages listed in this section can be ignored.
 For advanced players, almost all of the messages can be ignored.
 
-```include
+```{.include shift-heading-level-by=3}
 commands-inf.md
 ```
 
@@ -257,7 +263,7 @@ decks = 1             # number of decks, negative means infinite
 
 ## Reference
 
-```include
+```{.include shift-heading-level-by=2}
 conf.md
 ```
 

doc/commands-inf.md

@@ -1,52 +1,46 @@
 
-* `shuffling` (@sec:shuffling)
-* `new_hand` (@sec:new_hand)
-* `bet_negative` (@sec:bet_negative)
 * `bet_maximum` (@sec:bet_maximum)
+* `bet_negative` (@sec:bet_negative)
 * `bet_zero` (@sec:bet_zero)
-* `card_player` (@sec:card_player)
-* `card_dealer_up` (@sec:card_dealer_up)
 * `card_dealer` (@sec:card_dealer)
 * `card_dealer_hole` (@sec:card_dealer_hole)
+* `card_dealer_up` (@sec:card_dealer_up)
+* `card_player` (@sec:card_player)
 * `dealer_blackjack` (@sec:dealer_blackjack)
-* `player_wins_insurance` (@sec:player_wins_insurance)
+* `new_hand` (@sec:new_hand)
 * `player_blackjack_also` (@sec:player_blackjack_also)
+* `player_double_invalid` (@sec:player_double_invalid)
 * `player_split_invalid` (@sec:player_split_invalid)
 * `player_split_ok` (@sec:player_split_ok)
-* `player_double_invalid` (@sec:player_double_invalid)
+* `player_wins_insurance` (@sec:player_wins_insurance)
+* `shuffling` (@sec:shuffling)
 
 
-#### `shuffling` {#sec:shuffling}
+# `bet_maximum` {#sec:bet_maximum}
 
-The dealer informs that he is shuffling the decks.
-This only happens when a non-zero value for the option `decks` is set.
-If `decks = 0` (or the command-line option `-d0` is passed), then cards
-are drawn randomnly from an infinite set of cards and there is no need to shuffle.
+The dealer complains that the bet the placer placed is invalid.
+The bet is larger than the maximum wager allowed by `maximum_bet`.
+The player will receive a new `bet?` message.
 
 **Examples**
 
 ~~~
-shuffling
+bet_maximum
 ~~~
 
-#### `new_hand` $n$ $b$ {#sec:new_hand}
+# `bet_negative` {#sec:bet_negative}
 
-The dealer states that a new hand is starting. The integer $n$ gives
-the number of the hand that is about to start (first hand is $n=1$).
-The decimal number $b$ states the player's bankroll before placing
-the bet in the hand that is about to start.
-Even though bets have to be integers, pay offs might be non-integer
-such as when winning a natural (e.g. $3/2 = 1.5$ or $6/5$ = 1.2).    
+The dealer complains that the bet the placer placed is invalid.
+Only positive integer numbers are allowed.
+The player will receive a new `bet?` message.
 
 **Examples**
 
 ~~~
-new_hand 1 0
-new_hand 22 -8
-new_hand 24998 -7609.5
+bet_negative
 ~~~
 
-#### `bet_negative` {#sec:bet_negative}
+# `bet_zero` {#sec:bet_zero}
 
 The dealer complains that the bet the placer placed is invalid.
 Only positive integer numbers are allowed.
@@ -55,34 +49,61 @@ The player will receive a new `bet?` message.
 **Examples**
 
 ~~~
-bet_negative
+bet_zero
 ~~~
 
-#### `bet_maximum` {#sec:bet_maximum}
+# `card_dealer` $rs$ {#sec:card_dealer}
 
-The dealer complains that the bet the placer placed is invalid.
-The bet is larger than the maximum wager allowed by `maximum_bet`.
-The player will receive a new `bet?` message.
+The dealer informs that the dealer has been dealt a card.
+The card is given as the two-character ASCII representation discussed
+in @sec:card_player.
 
 **Examples**
 
 ~~~
-bet_maximum
+card_dealer TH
+card_dealer JC
+card_dealer 5D
+card_dealer 5H
+card_dealer QH
 ~~~
 
-#### `bet_zero` {#sec:bet_zero}
+# `card_dealer_hole` $rs$ {#sec:card_dealer_hole}
 
-The dealer complains that the bet the placer placed is invalid.
-Only positive integer numbers are allowed.
-The player will receive a new `bet?` message.
+The dealer informs what his hole card is.
+This message is issued only if playing the american rules, i.e.
+with `enhc = false` or `ahc = true`.
+The card is given as the two-character ASCII representation discussed
+in @sec:card_player.
 
 **Examples**
 
 ~~~
-bet_zero
+card_dealer_hole KH
+card_dealer_hole AC
+card_dealer_hole 4H
+card_dealer_hole 5D
+card_dealer_hole 7H
+~~~
+
+# `card_dealer_up` $rs$ {#sec:card_dealer_up}
+
+The dealer informs that the dealer has been dealt the up card (i.e.
+the first card facing up). This message is issued only once per hand.
+The card is given as the two-character ASCII representation discussed
+in @sec:card_player.
+
+**Examples**
+
+~~~
+card_dealer_up KD
+card_dealer_up 7H
+card_dealer_up KH
+card_dealer_up QD
+card_dealer_up 6C
 ~~~
 
-#### `card_player` $rs$ {#sec:card_player}
+# `card_player` $rs$ {#sec:card_player}
 
 The dealer informs that the player has been dealt a card.
 The card is given as a two-character ASCII representation where
@@ -123,88 +144,57 @@ card_player TD
 card_player 6H 
 ~~~
 
-#### `card_dealer_up` $rs$ {#sec:card_dealer_up}
-
-The dealer informs that the dealer has been dealt the up card (i.e.
-the first card facing up). This message is issued only once per hand.
-The card is given as the two-character ASCII representation discussed
-in @sec:card_player.
-
-**Examples**
-
-~~~
-card_dealer_up KD
-card_dealer_up 7H
-card_dealer_up KH
-card_dealer_up QD
-card_dealer_up 6C
-~~~
-
-#### `card_dealer` $rs$ {#sec:card_dealer}
-
-The dealer informs that the dealer has been dealt a card.
-The card is given as the two-character ASCII representation discussed
-in @sec:card_player.
-
-**Examples**
+# `dealer_blackjack` {#sec:dealer_blackjack}
 
-~~~
-card_dealer TH
-card_dealer JC
-card_dealer 5D
-card_dealer 5H
-card_dealer QH
-~~~
-
-#### `card_dealer_hole` $rs$ {#sec:card_dealer_hole}
-
-The dealer informs what his hole card is.
-This message is issued only if playing the american rules, i.e.
-with `enhc = false` or `ahc = true`.
-The card is given as the two-character ASCII representation discussed
-in @sec:card_player.
+The dealer informs that he has blackjack.
 
 **Examples**
 
 ~~~
-card_dealer_hole KH
-card_dealer_hole AC
-card_dealer_hole 4H
-card_dealer_hole 5D
-card_dealer_hole 7H
+dealer_blackjack
 ~~~
 
-#### `dealer_blackjack` {#sec:dealer_blackjack}
+# `new_hand` $n$ $b$ {#sec:new_hand}
 
-The dealer informs that he has blackjack.
+The dealer states that a new hand is starting. The integer $n$ gives
+the number of the hand that is about to start (first hand is $n=1$).
+The decimal number $b$ states the player's bankroll before placing
+the bet in the hand that is about to start.
+Even though bets have to be integers, pay offs might be non-integer
+such as when winning a natural (e.g. $3/2 = 1.5$ or $6/5$ = 1.2).    
 
 **Examples**
 
 ~~~
-dealer_blackjack
+new_hand 1 0
+new_hand 22 -8
+new_hand 24998 -7609.5
 ~~~
 
-#### `player_wins_insurance` {#sec:player_wins_insurance}
+# `player_blackjack_also` {#sec:player_blackjack_also}
 
-The dealer informs that the user won the insurance.
+The dealer informs that both he and the user have blackjack.
 
 **Examples**
 
 ~~~
-player_wins_insurance
+player_blackjack_also
 ~~~
 
-#### `player_blackjack_also` {#sec:player_blackjack_also}
+# `player_double_invalid` {#sec:player_double_invalid}
 
-The dealer informs that both he and the user have blackjack.
+The dealer complains that the doubling-down request cannot be
+fulfilled. Doubling down is only possible when exactly two
+cards have been dealt in a hand and the `doa` or `da9` option is met.
+The player will receive a new `play?` message.
 
 **Examples**
 
 ~~~
-player_blackjack_also
+player_double_invalid
 ~~~
 
-#### `player_split_invalid` {#sec:player_split_invalid}
+# `player_split_invalid` {#sec:player_split_invalid}
 
 The dealer complains that the split request cannot be
 fulfilled. Splitting is only possible when exactly two
@@ -217,7 +207,7 @@ The player will receive a new `play?` message.
 player_split_invalid
 ~~~
 
-#### `player_split_ok` $k$ {#sec:player_split_ok}
+# `player_split_ok` $k$ {#sec:player_split_ok}
 
 The dealer informs that the split request was successfully be
 fulfilled. The integer $k$ indicates the id of the split hand (the
@@ -230,17 +220,27 @@ player_split_ok 2
 player_split_ok 3
 ~~~
 
-#### `player_double_invalid` {#sec:player_double_invalid}
+# `player_wins_insurance` {#sec:player_wins_insurance}
 
-The dealer complains that the doubling-down request cannot be
-fulfilled. Doubling down is only possible when exactly two
-cards have been dealt in a hand and the `doa` or `da9` option is met.
-The player will receive a new `play?` message.
+The dealer informs that the user won the insurance.
 
 **Examples**
 
 ~~~
-player_double_invalid
+player_wins_insurance
+~~~
+
+# `shuffling` {#sec:shuffling}
+
+The dealer informs that he is shuffling the decks.
+This only happens when a non-zero value for the option `decks` is set.
+If `decks = 0` (or the command-line option `-d0` is passed), then cards
+are drawn randomnly from an infinite set of cards and there is no need to shuffle.
+
+**Examples**
+
+~~~
+shuffling
 ~~~
 
 

doc/commands-int.md

@@ -4,7 +4,7 @@
 * `play?` (@sec:play)
 
 
-#### `bet?` {#sec:bet}
+# `bet?` {#sec:bet}
 
 The dealer asks the user the amount to wage in the hand that is about to start.
 The player should send a positive integer in response.
@@ -16,7 +16,7 @@ first hand has an id equal to one so $k>1$ when splitting).
 bet?
 ~~~
 
-#### `insurance?` {#sec:insurance}
+# `insurance?` {#sec:insurance}
 
 The dealer asks the user if she wants to insure her hand when the dealer's
 upcards is an ace.
@@ -29,7 +29,7 @@ The player should answer either `yes` (or `y`) or `no` (or `n`).
 insurance?
 ~~~
 
-#### `play?` $p$ $d$ {#sec:play}
+# `play?` $p$ $d$ {#sec:play}
 
 The dealer asks the user to play, i.e. to choose wether to