fixup doc comments

iroh-cli/src/commands.rs

@@ -21,7 +21,7 @@ pub(crate) mod start;
 pub(crate) mod tag;
 
 /// iroh is a tool for syncing bytes
-/// https://iroh.computer/docs
+/// <https://iroh.computer/docs>
 #[derive(Parser, Debug, Clone)]
 #[clap(version, verbatim_doc_comment)]
 pub(crate) struct Cli {
@@ -69,7 +69,7 @@ pub(crate) enum Commands {
     /// Open the iroh console
     ///
     /// The console is a REPL for interacting with a running iroh node.
-    /// For more info on available commands, see https://iroh.computer/docs/api
+    /// For more info on available commands, see <https://iroh.computer/docs/api>
     Console,
 
     #[clap(flatten)]

iroh-cli/src/commands/doc.rs

@@ -66,11 +66,11 @@ pub enum DlPolicyCmd {
         /// Set the general download policy for this document.
         kind: FetchKind,
         /// Add an exception to the download policy.
-        /// An exception must be formatted as <matching_kind>:<encoding>:<pattern>.
+        /// An exception must be formatted as `<matching_kind>:<encoding>:<pattern>`.
         ///
-        /// - <matching_kind> can be either `prefix` or `exact`.
+        /// - `<matching_kind>` can be either `prefix` or `exact`.
         ///
-        /// - <encoding> can be either `utf8` or `hex`.
+        /// - `<encoding>` can be either `utf8` or `hex`.
         #[clap(short, long, value_name = "matching_kind>:<encoding>:<pattern")]
         except: Vec<FilterKind>,
     },

iroh-cli/src/commands/rpc.rs

@@ -20,7 +20,7 @@ pub enum RpcCommands {
     /// Manage documents
     ///
     /// Documents are mutable, syncable key-value stores.
-    /// For more on docs see https://iroh.computer/docs/layers/documents
+    /// For more on docs see <https://iroh.computer/docs/layers/documents>
     Doc {
         #[clap(subcommand)]
         command: DocCommands,
@@ -36,7 +36,7 @@ pub enum RpcCommands {
     /// Manage blobs
     ///
     /// Blobs are immutable, opaque chunks of arbitrary-sized data.
-    /// For more on blobs see https://iroh.computer/docs/layers/blobs
+    /// For more on blobs see <https://iroh.computer/docs/layers/blobs>
     Blob {
         #[clap(subcommand)]
         command: BlobCommands,