* main: (39 commits)
Add '--version' flag to Help output (#1707)
Expose ValidateRequiredFlags and ValidateFlagGroups (#1760)
Document option to hide the default completion cmd (#1779)
ci: add workflow_dispatch (#1387)
add missing license headers (#1809)
ci: use action/setup-go's cache (#1783)
Adjustments to documentation (#1656)
Rename Powershell completion tests (#1803)
Support for case-insensitive command names (#1802)
Deprecate ExactValidArgs() and test combinations of args validators (#1643)
Use correct stale action `exempt-` yaml keys (#1800)
With go 1.18, we must use go install for a binary (#1726)
Clarify SetContext documentation (#1748)
ci: test on Golang 1.19 (#1782)
fix: show flags that shadow parent persistent flag in child help (#1776)
Update gopkg.in/yaml.v2 to gopkg.in/yaml.v3 (#1766)
fix(bash-v2): activeHelp length check syntax (#1762)
fix: correct command path in see_also for YAML doc (#1771)
build(deps): bump github.com/inconshreveable/mousetrap (#1774)
docs: add zitadel to the list (#1772)
...
Previously if a cobra user didn't specify an explicit .Date header, the
current time would be included in all of the generated man pages each
time they were built. This causes an issue for reproducible builds,
since each re-build of a package that includes the man pages will have
different times listed in the man pages.
To fix this, add support for SOURCE_DATE_EPOCH (which is a standardised
packaging environment variable, designed to be used specifically for
this purpose[1]).
[1]: https://reproducible-builds.org/specs/source-date-epoch/
Signed-off-by: Aleksa Sarai <asarai@suse.de>
Just like the last commit, but now for manpages.
genMan still works with a buffer and returns []byte instead of working
directly with an io.Writer. This is because, in turn, md2man takes byte
slices instead of readers and writers.
Wrapping genMan around a writer is unnecessary especially since it's not
an exported function, and also because we'd still need a buffer to get
the output bytes.
* Move man_docs and md_docs into new doc pkg
* Replace *bytes.Buffer with io.Writer
* Replace c == cmd.helpCommand with c.IsHelpCommand()
* Remove redundant len(children) == 0 check in HasSeeAlso
* Duplicate test setup for doc generation
