pw_tokenizer: Migrate CLI content to cli.rst
Change-Id: I36c98e5fa3fb10f96afb0bcc462de82820a7c907
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/153630
Reviewed-by: Carlos Chinchilla <cachinchilla@google.com>
Reviewed-by: Kayce Basques <kayce@google.com>
Pigweed-Auto-Submit: Kayce Basques <kayce@google.com>
Presubmit-Verified: CQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com>
Commit-Queue: Auto-Submit <auto-submit@pigweed.google.com.iam.gserviceaccount.com>
diff --git a/pw_tokenizer/cli.rst b/pw_tokenizer/cli.rst
index 52a7d13..e728b4f 100644
--- a/pw_tokenizer/cli.rst
+++ b/pw_tokenizer/cli.rst
@@ -35,3 +35,28 @@
Prefixed Base64: $LYvvtgQEdGhlbQ==
See ``--help`` for full usage details.
+
+.. _module-pw_tokenizer-cli-detokenizing:
+
+Detokenizing command line utilties
+==================================
+``pw_tokenizer`` provides two standalone command line utilities for detokenizing
+Base64-encoded tokenized strings.
+
+* ``detokenize.py`` -- Detokenizes Base64-encoded strings in files or from
+ stdin.
+* ``serial_detokenizer.py`` -- Detokenizes Base64-encoded strings from a
+ connected serial device.
+
+If the ``pw_tokenizer`` Python package is installed, these tools may be executed
+as runnable modules. For example:
+
+.. code-block::
+
+ # Detokenize Base64-encoded strings in a file
+ python -m pw_tokenizer.detokenize -i input_file.txt
+
+ # Detokenize Base64-encoded strings in output from a serial device
+ python -m pw_tokenizer.serial_detokenizer --device /dev/ttyACM0
+
+See the ``--help`` options for these tools for full usage information.
diff --git a/pw_tokenizer/docs.rst b/pw_tokenizer/docs.rst
index af4e94f..7005b39 100644
--- a/pw_tokenizer/docs.rst
+++ b/pw_tokenizer/docs.rst
@@ -793,28 +793,9 @@
INF Attempt 1: [%d %s %d %d %d] 55 FAILED_PRECONDITION 1 -40 -38
INF Attempt 2: [%d %s %s] 55 FAILED_PRECONDITION OK
-Command line utilities
-----------------------
-``pw_tokenizer`` provides two standalone command line utilities for detokenizing
-Base64-encoded tokenized strings.
-
-* ``detokenize.py`` -- Detokenizes Base64-encoded strings in files or from
- stdin.
-* ``serial_detokenizer.py`` -- Detokenizes Base64-encoded strings from a
- connected serial device.
-
-If the ``pw_tokenizer`` Python package is installed, these tools may be executed
-as runnable modules. For example:
-
-.. code-block::
-
- # Detokenize Base64-encoded strings in a file
- python -m pw_tokenizer.detokenize -i input_file.txt
-
- # Detokenize Base64-encoded strings in output from a serial device
- python -m pw_tokenizer.serial_detokenizer --device /dev/ttyACM0
-
-See the ``--help`` options for these tools for full usage information.
+Detokenizing command line utilities
+-----------------------------------
+See :ref:`module-pw_tokenizer-cli-detokenizing`.
.. toctree::
:hidden:
