-
Notifications
You must be signed in to change notification settings - Fork 2.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Man pages won't have auto gen tag when option is disabled (#1104)
* Man pages wont have auto gen tag when option is disabled - this addresses #741 * Add documentation for doc generation and a changelog
- Loading branch information
Showing
5 changed files
with
40 additions
and
8 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
# Cobra Changelog | ||
|
||
## Pending | ||
* Fix man page doc generation - no auto generated tag when `cmd.DisableAutoGenTag = true` @jpmcb | ||
|
||
## v1.0.0 | ||
Announcing v1.0.0 of Cobra. 🎉 | ||
**Notable Changes** | ||
* Fish completion (including support for Go custom completion) @marckhouzam | ||
* API (urgent): Rename BashCompDirectives to ShellCompDirectives @marckhouzam | ||
* Remove/replace SetOutput on Command - deprecated @jpmcb | ||
* add support for autolabel stale PR @xchapter7x | ||
* Add Labeler Actions @xchapter7x | ||
* Custom completions coded in Go (instead of Bash) @marckhouzam | ||
* Partial Revert of #922 @jharshman | ||
* Add Makefile to project @jharshman | ||
* Correct documentation for InOrStdin @desponda | ||
* Apply formatting to templates @jharshman | ||
* Revert change so help is printed on stdout again @marckhouzam | ||
* Update md2man to v2.0.0 @pdf | ||
* update viper to v1.4.0 @umarcor | ||
* Update cmd/root.go example in README.md @jharshman |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
# Documentation generation | ||
|
||
- [Man page docs](./man_docs.md) | ||
- [Markdown docs](./md_docs.md) | ||
- [Rest docs](./rest_docs.md) | ||
- [Yaml docs](./yaml_docs.md) | ||
|
||
## Options | ||
### `DisableAutoGenTag` | ||
You may set `cmd.DisableAutoGenTag = true` | ||
to _entirely_ remove the auto generated string "Auto generated by spf13/cobra..." | ||
from any documentation source. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters