Man gen

Cargo.toml

@@ -10,5 +10,6 @@ readme = "README.md"
 
 [dependencies]
 clap = { git = "https://github.com/kbknapp/clap-rs", branch = "v3-dev" }
+roff = "0.1.0"
 
 [dev-dependencies]

README.md

@@ -22,8 +22,14 @@ fn main() {
     .flag(Some("-d"), Some("--debug"), Some("Activate debug mode"))
     .flag(Some("-v"), Some("--verbose"), Some("Verbose mode"));
     .option(Some("-o"), Some("--output"), "output", None, "Output file");
+
+  let _string = page.to_string();
 }
 ```
+Preview by running:
+```sh
+$ cargo run > /tmp/app.man; man /tmp/app.man
+```
 
 ## Installation
 ```sh

examples/demo.rs

@@ -0,0 +1,49 @@
+extern crate man;
+
+use man::Man;
+
+fn main() {
+  let msg = Man::new("auth-service")
+    .description("authorize & authenticate members")
+    .argument("path".into())
+    .environment(
+      "PORT".into(),
+      None,
+      Some("The network port to listen to.".into()),
+    )
+    .flag(
+      Some("-h".into()),
+      Some("--help".into()),
+      Some("Prints help information.".into()),
+    )
+    .flag(
+      Some("-V".into()),
+      Some("--version".into()),
+      Some("Prints version information.".into()),
+    )
+    .flag(
+      Some("-v".into()),
+      Some("--verbosity".into()),
+      Some("Pass multiple times to print more information.".into()),
+    )
+    .option(
+      Some("-a".into()),
+      Some("--address".into()),
+      Some("The network address to listen to.".into()),
+      "address".into(),
+      Some("127.0.0.1".into()),
+    )
+    .option(
+      Some("-p".into()),
+      Some("--port".into()),
+      Some("The network port to listen to.".into()),
+      "port".into(),
+      None,
+    )
+    .author("Alice Person", Some("alice@person.com".into()))
+    .author("Bob Human", Some("bob@human.com".into()))
+    .render();
+  // .option(Some("-o"), Some("--output"), "output", None, "Output file");
+
+  println!("{}", msg);
+}

examples/main.rs

@@ -1,7 +1,7 @@
 extern crate clap;
 extern crate man;
 
-use clap::{App, AppSettings, Arg, SubCommand};
+use clap::{App, AppSettings, Arg, Man, SubCommand};
 use man::Manual;
 
 fn main() {

src/lib.rs

@@ -4,8 +4,12 @@
 #![cfg_attr(test, deny(warnings))]
 
 extern crate clap;
+extern crate roff;
+
+mod man;
 
 use clap::{App, Arg, ArgSettings};
+pub use man::*;
 
 /// Describe an argument or option
 #[derive(Debug)]

src/man/author.rs

@@ -0,0 +1,6 @@
+/// An author entry.
+#[derive(Debug)]
+pub struct Author {
+  pub(crate) name: String,
+  pub(crate) email: Option<String>,
+}

src/man/environment.rs

@@ -0,0 +1,7 @@
+/// Command line environment variable representation.
+#[derive(Debug)]
+pub struct Env {
+  pub(crate) name: String,
+  pub(crate) default: Option<String>,
+  pub(crate) description: Option<String>,
+}

src/man/flag.rs

@@ -0,0 +1,7 @@
+/// Command line flag representation.
+#[derive(Debug)]
+pub struct Flag {
+  pub(crate) short: Option<String>,
+  pub(crate) long: Option<String>,
+  pub(crate) description: Option<String>,
+}