Clarify optional Shardok roll argument (#8439)

docs/TEXT_CLIENT_OPERATOR_GUIDE.md

@@ -100,10 +100,23 @@ Post one of the currently listed command indices with:
 post-shardok <index>
 ```
 
+Omit the optional roll value during normal play. The server then generates any
+roll required by the selected command. To override that roll for deterministic
+testing, append an integer value:
+
+```text
+post-shardok <index> <integer-roll>
+```
+
+`roll` is a placeholder in command usage, not a literal argument. Only an
+integer is accepted, and the override has an effect only for Shardok commands
+that support a client-supplied roll.
+
 For a specific active battle:
 
 ```text
 post-shardok <shardok-game-id> <index>
+post-shardok <shardok-game-id> <index> <integer-roll>
 ```
 
 Use `shardok-commands-json` or `shardok-units-json` when the concise output omits a needed field.

src/main/scala/net/eagle0/eagle/text_client/EagleTextClient.scala

@@ -1223,8 +1223,8 @@ object Help {
       |  shardok-units
       |  shardok-units-json
       |  post-json [--force] <province-id> <SelectedCommandType> <JSON>
-      |  post-shardok <index> [roll]
-      |  post-shardok <shardok-game-id> <index> [roll]
+      |  post-shardok <index> [integer-roll]
+      |  post-shardok <shardok-game-id> <index> [integer-roll]
       |  post-rest <province-id>
       |  post-return <province-id>
       |  post-feast <province-id>