1 files changed, 16 insertions, 6 deletions
diff --git a/building_guide/pai_gow.md b/building_guide/pai_gow.md
index ebc1da9..bf3a3a3 100644
--- a/building_guide/pai_gow.md
+++ b/building_guide/pai_gow.md
@@ -12,17 +12,27 @@ Configure a `casino_tables` entry:
   pai_gow:
     variant: classic # classic, ez, no_push, face_up
     envy: true
+    a2345_second_highest: true # default; false makes A2345 the lowest straight
     action_ticks: 60
 ```
 
 There are six player seats and one dealer. Each round deals seven packets
 from a fresh 53-card deck, including unused seats. No player banking.
-`bet 20` places the main wager; `bet 5 fortune` adds the optional side bet.
-`deal` marks a bettor ready; when all bettors are ready, or the betting
-window expires, the cards are dealt. Place side bets before marking ready.
-A Fortune wager requires a main wager. Both use the table's limits; each
-is also bounded to 500,000,000 credits to keep combined payouts below the
-economy's credit cap even on unlimited tables.
+Side bets come first: `bet 5 fortune` (and, on a Face Up table,
+`bet <amount> pushace`) is placed before the main wager. `bet 20` is the
+main wager that commits the round; when every active player has one, the
+cards are dealt immediately. A lone bettor is dealt as soon as the main
+wager lands, with no timed window. Otherwise the betting window opens and
+expires on `betting_ticks`; anyone who has not bet sits out. `unbet main`,
+`unbet fortune`, `unbet pushace` or `unbet all` returns an undealt wager,
+and `stop` before the deal returns every wager and frees the seat. Both
+wagers use the table's limits; each is also bounded to 500,000,000 credits
+to keep combined payouts below the economy's credit cap even on unlimited
+tables.
+
+`a2345_second_highest` defaults to true and controls whether A-2-3-4-5 is
+the second-highest straight (below TJQKA) or the lowest. When enabled the
+rule is printed on the felt.
 
 ## Player hand setting