feat: add support for examples

Author: jon4hz

mango.go

@@ -22,6 +22,7 @@ type Command struct {
 	Name     string
 	Short    string
 	Usage    string
+	Example  string
 	Flags    map[string]Flag
 	Commands map[string]*Command
 }
@@ -176,6 +177,24 @@ func (m ManPage) buildCommand(w Builder, c Command) {
 			w.IndentEnd()
 		}
 	}
+
+	if c.Example != "" {
+		if c.Name == m.Root.Name {
+			w.Section("Examples")
+			w.TaggedParagraph(-1)
+		} else {
+			w.TaggedParagraph(-1)
+			w.TextBold("EXAMPLES")
+			w.Indent(4)
+		}
+		w.Text(c.Example)
+
+		if c.Name == m.Root.Name {
+			w.EndSection()
+		} else {
+			w.IndentEnd()
+		}
+	}
 }
 
 // Build generates the man page.