2015-08-18 22:33:41 +00:00
|
|
|
# Generating Man Pages For Your Own cobra.Command
|
|
|
|
|
2015-11-21 00:12:30 +00:00
|
|
|
Generating man pages from a cobra command is incredibly easy. An example is as follows:
|
2015-08-18 22:33:41 +00:00
|
|
|
|
|
|
|
```go
|
|
|
|
package main
|
|
|
|
|
|
|
|
import (
|
2017-04-19 12:39:58 +00:00
|
|
|
"log"
|
|
|
|
|
2015-08-18 22:33:41 +00:00
|
|
|
"github.com/spf13/cobra"
|
2016-01-17 00:29:42 +00:00
|
|
|
"github.com/spf13/cobra/doc"
|
2015-08-18 22:33:41 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
func main() {
|
|
|
|
cmd := &cobra.Command{
|
|
|
|
Use: "test",
|
|
|
|
Short: "my test program",
|
|
|
|
}
|
2016-11-15 14:16:05 +00:00
|
|
|
header := &doc.GenManHeader{
|
2015-09-08 20:02:02 +00:00
|
|
|
Title: "MINE",
|
|
|
|
Section: "3",
|
|
|
|
}
|
2017-04-19 12:39:58 +00:00
|
|
|
err := doc.GenManTree(cmd, header, "/tmp")
|
|
|
|
if err != nil {
|
|
|
|
log.Fatal(err)
|
|
|
|
}
|
2015-08-18 22:33:41 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
2016-11-15 14:16:05 +00:00
|
|
|
That will get you a man page `/tmp/test.3`
|