From 687c32e267749e1ee7c80b5cbd5c602f3c64e24b Mon Sep 17 00:00:00 2001
From: matejcik <ja@matejcik.cz>
Date: Wed, 4 Mar 2020 13:45:19 +0100
Subject: [PATCH] python: regenerate OPTIONS.rst

---
 python/docs/OPTIONS.rst         | 80 +++++++++++++++++++++------------
 python/helper-scripts/README.md |  1 +
 2 files changed, 53 insertions(+), 28 deletions(-)

diff --git a/python/docs/OPTIONS.rst b/python/docs/OPTIONS.rst
index 145708c0b..2eef1fd7b 100644
--- a/python/docs/OPTIONS.rst
+++ b/python/docs/OPTIONS.rst
@@ -26,36 +26,41 @@ on one page here.
   Usage: trezorctl [OPTIONS] COMMAND [ARGS]...
 
   Options:
-    -p, --path TEXT  Select device by specific path.
-    -v, --verbose    Show communication messages.
-    -j, --json       Print result as JSON object
-    --version        Show the version and exit.
-    --help           Show this message and exit.
+    -p, --path TEXT           Select device by specific path.
+    -v, --verbose             Show communication messages.
+    -j, --json                Print result as JSON object
+    -P, --passphrase-on-host  Enter passphrase on host.
+    -s, --session-id HEX      Resume given session ID.
+    --version                 Show the version and exit.
+    --help                    Show this message and exit.
 
   Commands:
-    binance          Binance Chain commands.
-    btc              Bitcoin and Bitcoin-like coins commands.
-    cardano          Cardano commands.
-    clear-session    Clear session (remove cached PIN, passphrase, etc.).
-    cosi             CoSi (Cothority / collective signing) commands.
-    crypto           Miscellaneous cryptography features.
-    device           Device management commands - setup, recover seed, wipe, etc.
-    eos              EOS commands.
-    ethereum         Ethereum commands.
-    fido             FIDO2, U2F and WebAuthN management commands.
-    firmware-update  Upload new firmware to device.
-    get-features     Retrieve device features and settings.
-    lisk             Lisk commands.
-    list             List connected Trezor devices.
-    monero           Monero commands.
-    nem              NEM commands.
-    ping             Send ping message.
-    ripple           Ripple commands.
-    set              Device settings.
-    stellar          Stellar commands.
-    tezos            Tezos commands.
-    usb-reset        Perform USB reset on stuck devices.
-    version          Show version of trezorctl/trezorlib.
+    binance            Binance Chain commands.
+    btc                Bitcoin and Bitcoin-like coins commands.
+    cardano            Cardano commands.
+    clear-session      Clear session (remove cached PIN, passphrase, etc.).
+    cosi               CoSi (Cothority / collective signing) commands.
+    crypto             Miscellaneous cryptography features.
+    debug              Miscellaneous debug features.
+    device             Device management commands - setup, recover seed, wipe, etc.
+    eos                EOS commands.
+    ethereum           Ethereum commands.
+    fido               FIDO2, U2F and WebAuthN management commands.
+    firmware-update    Upload new firmware to device.
+    get-features       Retrieve device features and settings.
+    get-session        Get a session ID for subsequent commands.
+    lisk               Lisk commands.
+    list               List connected Trezor devices.
+    monero             Monero commands.
+    nem                NEM commands.
+    ping               Send ping message.
+    ripple             Ripple commands.
+    set                Device settings.
+    stellar            Stellar commands.
+    tezos              Tezos commands.
+    usb-reset          Perform USB reset on stuck devices.
+    version            Show version of trezorctl/trezorlib.
+    wait-for-emulator  Wait until Trezor Emulator comes up.
 
 Binance Chain commands.
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -163,6 +168,25 @@ Miscellaneous cryptography features.
     encrypt-keyvalue  Encrypt value by given key and path.
     get-entropy       Get random bytes from device.
 
+Miscellaneous debug features.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code::
+
+  trezorctl debug --help
+
+.. code::
+
+  Usage: trezorctl debug [OPTIONS] COMMAND [ARGS]...
+
+    Miscellaneous debug features.
+
+  Options:
+    --help  Show this message and exit.
+
+  Commands:
+    show-text  Show text on Trezor display.
+
 Device management commands - setup, recover seed, wipe, etc.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/python/helper-scripts/README.md b/python/helper-scripts/README.md
index a8a76c2cf..d7282d940 100644
--- a/python/helper-scripts/README.md
+++ b/python/helper-scripts/README.md
@@ -3,3 +3,4 @@ These scripts automate some tasks related to release process.
 * __`relicence.py`__ rewrites licence headers in all non-empty Python files
 * __`linkify-changelog.py`__ generates Markdown links to github issues/PRs in changelog
 * __`bump-required-fw-versions.py`__ downloads latest firmware versions and updates trezorlib requirements
+* __`make-options-rst.py`__ runs all `trezorctl` commands with the `--help` option and concatenates output as `OPTIONS.rst`