diff --git a/man/git-generate-changelog.1 b/man/git-generate-changelog.1 index a5d47378c..713e288f9 100644 --- a/man/git-generate-changelog.1 +++ b/man/git-generate-changelog.1 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "GIT\-GENERATE\-CHANGELOG" "1" "October 2015" "" "" +.TH "GIT\-GENERATE\-CHANGELOG" "1" "November 2016" "" "" . .SH "NAME" \fBgit\-generate\-changelog\fR \- Generate changelog from github @@ -73,6 +73,12 @@ Setup custom label for closed\-issues section\. Default is "\fBClosed issues:\fR Setup custom header label\. Default is "# Change Log" . .P +\-\-front\-matter [JSON] +. +.P +Add YAML front matter\. Formatted as JSON because it\'s easier to add on the command line +. +.P \-\-pr\-label [LABEL] . .P @@ -115,6 +121,12 @@ Use milestone to detect when issue was resolved\. Default is true Add author of pull\-request in the end\. Default is true . .P +\-\-usernames\-as\-github\-logins +. +.P +Use GitHub tags instead of Markdown links for the author of an issue or pull\-request\. +. +.P \-\-unreleased\-only . .P @@ -175,6 +187,12 @@ Change log will be filled only between specified tags Change log will exclude specified tags . .P +\-\-exclude\-tags\-regex [REGEX] +. +.P +Apply a regular expression on tag names so that they can be excluded, for example: \-\-exclude\-tags\-regex "\.*+\ed{1,}" +. +.P \-\-since\-tag x . .P @@ -223,6 +241,30 @@ Create simple list from issues and pull requests\. Default is false\. Put the unreleased changes in the specified release number\. . .P +\-\-release\-branch [RELEASE\-BRANCH] +. +.P +Limit pull requests to the release branch, such as master or release +. +.P +\-\-http\-cache +. +.P +Use HTTP Cache to cache Github API requests (useful for large repos) Default is true\. +. +.P +\-\-[no\-]cache\-file [CACHE\-FILE] +. +.P +Filename to use for cache\. Default is /tmp/github\-changelog\-http\-cache +. +.P +\-\-cache\-log [CACHE\-LOG] +. +.P +Filename to use for cache log\. Default is /tmp/github\-changelog\-logger\.log +. +.P \-\-[no\-]verbose . .P diff --git a/man/git-generate-changelog.1.html b/man/git-generate-changelog.1.html new file mode 100644 index 000000000..4ea973631 --- /dev/null +++ b/man/git-generate-changelog.1.html @@ -0,0 +1,290 @@ + + +
+ + +
+ git-generate-changelog
- Generate changelog from github
+
git generate-changelog
[-h|--help] [-u|--user] [-p|--project]
Automatically generate change log from your tags, issues, labels and pull requests on GitHub.
+ +-u, --user [USER]
+ +Username of the owner of target GitHub repo
+ +-p, --project [PROJECT]
+ +Name of project on GitHub
+ +-t, --token [TOKEN]
+ +To make more than 50 requests per hour your GitHub token is required. You can generate it at: https://github.com/settings/tokens/new
+ +-f, --date-format [FORMAT]
+ +Date format. Default is %Y-%m-%d
+ +-o, --output [NAME]
+ +Output file. Default is CHANGELOG.md
+ +-b, --base [NAME]
+ +Optional base file to append generated changes to.
+ +--bugs-label [LABEL]
+ +Setup custom label for bug-fixes section. Default is "Fixed bugs:
+ +--enhancement-label [LABEL]
+ +Setup custom label for enhancements section. Default is "Implemented enhancements:"
+ +--issues-label [LABEL]
+ +Setup custom label for closed-issues section. Default is "Closed issues:"
+ +--header-label [LABEL]
+ +Setup custom header label. Default is "# Change Log"
+ +--front-matter [JSON]
+ +Add YAML front matter. Formatted as JSON because it's easier to add on the command line
+ +--pr-label [LABEL]
+ +Setup custom label for pull requests section. Default is "Merged pull requests:"
+ +--[no-]issues
+ +Include closed issues in changelog. Default is true
+ +--[no-]issues-wo-labels
+ +Include closed issues without labels in changelog. Default is true
+ +--[no-]pr-wo-labels
+ +Include pull requests without labels in changelog. Default is true
+ +--[no-]pull-requests
+ +Include pull-requests in changelog. Default is true
+ +--[no-]filter-by-milestone
+ +Use milestone to detect when issue was resolved. Default is true
+ +--[no-]author
+ +Add author of pull-request in the end. Default is true
+ +--usernames-as-github-logins
+ +Use GitHub tags instead of Markdown links for the author of an issue or pull-request.
+ +--unreleased-only
+ +Generate log from unreleased closed issues only.
+ +--[no-]unreleased
+ +Add to log unreleased closed issues. Default is true
+ +--unreleased-label [label]
+ +Add to log unreleased closed issues. Default is true
+ +--[no-]compare-link
+ +Include compare link (Full Changelog) between older version and newer version. Default is true
+ +--include-labels x,y,z
+ +Only issues with the specified labels will be included in the changelog.
+ +--exclude-labels x,y,z
+ +Issues with the specified labels will be always excluded from changelog. Default is 'duplicate,question,invalid,wontfix'
+ +--bug-labels x,y,z
+ +Issues with the specified labels will be always added to "Fixed bugs" section. Default is 'bug,Bug'
+ +--enhancement-labels x,y,z
+ +Issues with the specified labels will be always added to "Implemented enhancements" section. Default is 'enhancement,Enhancement'
+ +--between-tags x,y,z
+ +Change log will be filled only between specified tags
+ +--exclude-tags x,y,z
+ +Change log will exclude specified tags
+ +--exclude-tags-regex [REGEX]
+ +Apply a regular expression on tag names so that they can be excluded, for example: --exclude-tags-regex ".*+\d{1,}"
+ +--since-tag x
+ +Change log will start after specified tag
+ +--due-tag x
+ +Change log will end before specified tag
+ +--max-issues [NUMBER]
+ +Max number of issues to fetch from GitHub. Default is unlimited
+ +--release-url [URL]
+ +The URL to point to for release links, in printf format (with the tag as variable).
+ +--github-site [URL]
+ +The Enterprise Github site on which your project is hosted.
+ +--github-api [URL]
+ +The enterprise endpoint to use for your Github API.
+ +--simple-list
+ +Create simple list from issues and pull requests. Default is false.
+ +--future-release [RELEASE-VERSION]
+ +Put the unreleased changes in the specified release number.
+ +--release-branch [RELEASE-BRANCH]
+ +Limit pull requests to the release branch, such as master or release
+ +--http-cache
+ +Use HTTP Cache to cache Github API requests (useful for large repos) Default is true.
+ +--[no-]cache-file [CACHE-FILE]
+ +Filename to use for cache. Default is /tmp/github-changelog-http-cache
+ +--cache-log [CACHE-LOG]
+ +Filename to use for cache log. Default is /tmp/github-changelog-logger.log
+ +--[no-]verbose
+ +Run verbosely. Default is true
+ +-v, --version
+ +Print version number
+ +-h, --help
+ +Displays Help
+ +Written by Petr Korolev sky4winder@gmail.com
+ +<https://github.com/skywinder/github-changelog-generator/issues>
+ +<https://github.com/skywinder/github-changelog-generator/>
+ + +