Binary for generating a man page

Stored as an example so that "cargo install" does not install the binary
by default.

examples/generate-docs.rs

@@ -0,0 +1,108 @@
+use man::prelude::*;
+use std::fs::File;
+use std::io::prelude::*;
+
+fn main() {
+    let page = Manual::new("rage")
+        .about("A simple, secure, and modern encryption tool")
+        .author(Author::new("Jack Grigg").email("thestr4d@gmail.com"))
+        .flag(
+            Flag::new()
+                .short("-g")
+                .long("--generate")
+                .help("Generate a new age key pair"),
+        )
+        .flag(
+            Flag::new()
+                .short("-d")
+                .long("--decrypt")
+                .help("Decrypt the input (default is to encrypt)"),
+        )
+        .flag(
+            Flag::new()
+                .short("-p")
+                .long("--passphrase")
+                .help("Use a passphrase instead of public keys"),
+        )
+        .option(
+            Opt::new("input")
+                .short("-i")
+                .long("--input")
+                .help("The file path to read input from (defaults to stdin)"),
+        )
+        .option(
+            Opt::new("output")
+                .short("-o")
+                .long("--output")
+                .help("The file path to write output to (defaults to stdout)"),
+        )
+        .arg(Arg::new("arguments"))
+        .example(
+            Example::new()
+                .text("Generate a new key pair")
+                .command("rage -g"),
+        )
+        .example(Example::new().text("Encryption to a public key").command(
+            "echo \"_o/\" | rage -o hello.age pubkey:98W5ph53zfPGOzEOH-fMojQ4jUY7VLEmtmozREqnw4I",
+        ))
+        .example(
+            Example::new()
+                .text("Encryption to multiple public keys (with default output to stdout)")
+                .command(
+                    "echo \"_o/\" | rage pubkey:98W5ph53zfPGOzEOH-fMojQ4jUY7VLEmtmozREqnw4I \
+                     pubkey:jqmfMHBjlb7HoIjjTsCQ9NHIk_q53Uy_ZxmXBhdIpx4 > hello.age",
+                ),
+        )
+        .example(
+            Example::new()
+                .text("Encryption with a password (interactive only, use public keys for batch!)")
+                .command("rage -i hello.txt -o hello.txt.age -p")
+                .output("Type passphrase:"),
+        )
+        .example(
+            Example::new()
+                .text("Encryption to a list of recipients in a file")
+                .command("tar cv ~/xxx | rage recipients.txt > xxx.tar.age"),
+        )
+        .example(
+            Example::new()
+                .text("Encryption to a list of age recipients at a URL")
+                .command(
+                    "echo \"_o/\" | rage -o hello.age \
+                     https://filippo.io/.well-known/age.keys > hello.age",
+                ),
+        )
+        .example(
+            Example::new()
+                .text(
+                    "Encryption to a GitHub user \
+                     (equivalent to https://github.com/str4d.keys)",
+                )
+                .command("echo \"_o/\" | rage github:str4d | nc 192.0.2.0 1234"),
+        )
+        .example(
+            Example::new()
+                .text(
+                    "Encryption to an alias \
+                     (stored at ~/.config/age/aliases.txt, change with --aliases)",
+                )
+                .command("tar cv ~/xxx | rage alias:str4d > xxx.tar.age"),
+        )
+        .example(
+            Example::new()
+                .text("Decryption with keys at ~/.config/age/keys.txt")
+                .command("age -decrypt -i hello.age")
+                .output("_o/"),
+        )
+        .example(
+            Example::new()
+                .text("Decryption with custom keys")
+                .command("age -d -o hello -i hello.age keyA.txt keyB.txt"),
+        )
+        .render();
+
+    let mut file =
+        File::create("./target/rage.1").expect("Should be able to open file in target directory");
+    file.write_all(page.as_bytes())
+        .expect("Should be able to write to file in target directory");
+}