PT-1662 fix pt-secure-collect doc styles

docs/pt-secure-collect.rst

@@ -1,8 +1,25 @@
-pt-secure-collect
-=================
+.. program:: pt-secure-collect
 
-Collect, sanitize, pack and encrypt data. By default, this program will
-collect the output of:
+============================
+:program:`pt-secure-collect`
+============================
+
+NAME
+====
+
+:program:`pt-secure-collect` - collect, sanitize, pack and encrypt data.
+
+SYNOPSIS
+========
+
+Usage
+-----
+
+::
+
+  pt-secure-data [<flags>] <command> [<args> ...]
+
+By default, :program:`pt-secure-collect` will collect the output of:
 
 -  ``pt-stalk --no-stalk --iterations=2 --sleep=30 --host=$mysql-host --dest=$temp-dir --port=$mysql-port --user=$mysql-user --password=$mysql-pass``
 -  ``pt-summary``
@@ -12,14 +29,8 @@ Internal variables placeholders will be replaced with the corresponding
 flag values. For example, ``$mysql-host`` will be replaced with the
 values specified in the ``--mysql-host`` flag.
 
-Usage:
-
-::
-
-    pt-secure-data [<flags>] <command> [<args> ...]
-
 Global flags
-~~~~~~~~~~~~
+------------
 
 +-----------+----------------------------------------------------------------------+
 | Flag      | Description                                                          |
@@ -29,16 +40,14 @@ Global flags
 | --debug   | Enable debug log level.                                              |
 +-----------+----------------------------------------------------------------------+
 
-**Commands**
-~~~~~~~~~~~~
+COMMANDS
+========
 
-**Help command**
-^^^^^^^^^^^^^^^^
+* **Help command**
 
   Show help
 
-**Collect command**
-^^^^^^^^^^^^^^^^^^^
+* **Collect command**
 
   Collect, sanitize, pack and encrypt data from pt-tools. Usage:
 
@@ -216,12 +225,10 @@ Collect, sanitize, pack and encrypt data from pt-tools. Usage:
   |        | files. |
   +--------+--------+
 
-**Decrypt command**
-^^^^^^^^^^^^^^^^^^^
+* **Decrypt command**
 
-| Decrypt an encrypted file. The password will be requested from the
-  terminal.
-| Usage:
+  Decrypt an encrypted file. The password will be requested from the
+  terminal. Usage:
 
   ::
 
@@ -256,11 +263,9 @@ Collect, sanitize, pack and encrypt data from pt-tools. Usage:
   |        | on      |
   +--------+---------+
 
-**Encrypt command**
-^^^^^^^^^^^^^^^^^^^
+* **Encrypt command**
 
-| Encrypt a file. The password will be requested from the terminal.
-| Usage:
+  Encrypt a file. The password will be requested from the terminal. Usage:
 
   ::
 
@@ -295,12 +300,10 @@ Collect, sanitize, pack and encrypt data from pt-tools. Usage:
   |        | on      |
   +--------+---------+
 
-**Sanitize command**
-^^^^^^^^^^^^^^^^^^^^
+* **Sanitize command**
 
-| Replace queries in a file by their fingerprints and obfuscate
-  hostnames.
-| Usage:
+  Replace queries in a file by their fingerprints and obfuscate hostnames.
+  Usage:
 
   ::