docs: Add doc comments to all CLI subcommands (#3414)

* docs: Add doc comments to all CLI subcommands

* docs: Update influxdb_iox/src/commands/database/recover.rs

Co-authored-by: Andrew Lamb <alamb@influxdata.com>
Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>

influxdb_iox/src/commands/database.rs

@@ -194,15 +194,34 @@ struct Claim {
 /// All possible subcommands for database
 #[derive(Debug, StructOpt)]
 enum Command {
+    /// Create a new database
     Create(Create),
+
+    /// Get list of databases
     List(List),
+
+    /// Return configuration of specific database
     Get(Get),
+
+    /// Write data into the specified database
     Write(Write),
+
+    /// Query the data with SQL
     Query(Query),
+
+    /// Manage database chunks
     Chunk(chunk::Config),
+
+    /// Manage database partitions
     Partition(partition::Config),
+
+    /// Recover broken databases
     Recover(recover::Config),
+
+    /// Release a database from its current server owner
     Release(Release),
+
+    /// Claim an unowned database
     Claim(Claim),
 }
 

influxdb_iox/src/commands/database/recover.rs

@@ -39,7 +39,7 @@ pub struct Config {
     command: Command,
 }
 
-/// All possible subcommands for catalog
+/// All possible subcommands for recovering broken databases
 #[derive(Debug, StructOpt)]
 enum Command {
     /// Wipe preserved catalog

influxdb_iox/src/commands/run/mod.rs

@@ -46,8 +46,13 @@ impl Config {
 
 #[derive(Debug, StructOpt)]
 enum Command {
+    /// Run the server in database mode
     Database(database::Config),
+
+    /// Run the server in routing mode
     Router(router::Config),
+
+    /// Run the server in test mode
     Test(test::Config),
 }
 

influxdb_iox/src/main.rs

@@ -145,13 +145,26 @@ struct Config {
 
 #[derive(Debug, StructOpt)]
 enum Command {
+    /// Database-related commands
     Database(commands::database::Config),
+
+    /// Run the InfluxDB IOx server
     // Clippy recommended boxing this variant because it's much larger than the others
     Run(Box<commands::run::Config>),
+
+    /// Router-related commands
     Router(commands::router::Config),
+
+    /// IOx server configuration commands
     Server(commands::server::Config),
+
+    /// Manage long-running IOx operations
     Operation(commands::operations::Config),
+
+    /// Start IOx interactive SQL REPL loop
     Sql(commands::sql::Config),
+
+    /// Interrogate internal database data
     Debug(commands::debug::Config),
 }