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