feat: set and autoset in pai gow, better showdown arrangement, better formatting

1 files changed, 22 insertions, 6 deletions

diff --git a/building_guide/pai_gow.md b/building_guide/pai_gow.md
index bf3a3a3..93e9594 100644
--- a/building_guide/pai_gow.md
+++ b/building_guide/pai_gow.md
@@ -12,6 +12,7 @@ Configure a `casino_tables` entry:
   pai_gow:
     variant: classic # classic, ez, no_push, face_up
     envy: true
+    autoset: false # default; true locks every legal arrangement without "set"
     a2345_second_highest: true # default; false makes A2345 the lowest straight
     action_ticks: 60
 ```
@@ -36,13 +37,28 @@ rule is printed on the felt.
 
 ## Player hand setting
 
-`24` or `set 24` selects positions 2 and 4 for the two-card low hand.
-`13456` selects those five positions for the high hand. Spaces and order
+The seven dealt cards are shown with their position numbers underneath.
+`24` or `set 24` arranges positions 2 and 4 into the two-card low hand;
+`13456` arranges those five positions into the high hand. Spaces and order
 are immaterial; duplicates, out-of-range positions and other counts are
-rejected. Setting locks the hand. Fouls are rejected with a clear warning
-and leave the hand unset. `house` (`house way`, `set house`) sets
-automatically. Timeout or disconnect sets an unfinished hand the house
-way; a committed round cannot be abandoned.
+rejected. Fouls are rejected with a clear warning and leave the hand
+unarranged.
+
+An arrangement is only a preview: the board redraws the five-card high
+hand, a gap, then the two-card low hand (with `HIGH` and `LOW` labels and
+position numbers) and waits. `set` locks the hand and reveals the dealer.
+`house` (`house way`, `set house`) arranges the house way and still needs
+`set`. `autoset on` locks any legal arrangement the moment it is made, so
+the preview and `set` steps are skipped; `autoset off` restores them, and
+`autoset` alone toggles. The table's `autoset` setting only seeds a new
+seat. Timeout or disconnect sets an unfinished hand the house way; a
+committed round cannot be abandoned.
+
+When every seat has set, the dealer reveals and the showdown compares the
+high hands first (your high, then the dealer's high) and then the low hands
+(your low, then the dealer's low). Each hand prints its strength in
+parentheses, bold yellow when it wins its comparison and bold white when it
+loses. The summary names the winner of each hand and then the round.
 
 ## Variants