peridot/vendor/github.com/spf13/cobra/site/content/docgen/man.md
Neil Hanlon 0d3255ccca
feat(peridot-cli/task-logs): bump cobra for mutex feature
* refactor some code into utils
* prep for task info
2024-07-26 22:38:23 -04:00

519 B

Generating Man Pages For Your Own cobra.Command

Generating man pages from a cobra command is incredibly easy. An example is as follows:

package main

import (
	"log"

	"github.com/spf13/cobra"
	"github.com/spf13/cobra/doc"
)

func main() {
	cmd := &cobra.Command{
		Use:   "test",
		Short: "my test program",
	}
	header := &doc.GenManHeader{
		Title: "MINE",
		Section: "3",
	}
	err := doc.GenManTree(cmd, header, "/tmp")
	if err != nil {
		log.Fatal(err)
	}
}

That will get you a man page /tmp/test.3