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(1) - Generate changelog from github + + + + +
+ + + +
    +
  1. git-generate-changelog(1)
  2. +
  3. +
  4. git-generate-changelog(1)
  5. +
+ +

NAME

+

+ git-generate-changelog - Generate changelog from github +

+ +

SYNOPSIS

+ +

git generate-changelog [-h|--help] [-u|--user] [-p|--project]

+ +

DESCRIPTION

+ +

Automatically generate change log from your tags, issues, labels and pull requests on GitHub.

+ +

OPTIONS

+ +

-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

+ +

EXAMPLES

+ +

AUTHOR

+ +

Written by Petr Korolev sky4winder@gmail.com

+ +

REPORTING BUGS

+ +

<https://github.com/skywinder/github-changelog-generator/issues>

+ +

SEE ALSO

+ +

<https://github.com/skywinder/github-changelog-generator/>

+ + +
    +
  1. +
  2. November 2016
  3. +
  4. git-generate-changelog(1)
  5. +
+ +
+ + diff --git a/man/git-generate-changelog.md b/man/git-generate-changelog.md index a12c4e031..2fa109f8f 100644 --- a/man/git-generate-changelog.md +++ b/man/git-generate-changelog.md @@ -51,6 +51,10 @@ Automatically generate change log from your tags, issues, labels and pull reques 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:**" @@ -79,6 +83,10 @@ Automatically generate change log from your tags, issues, labels and pull reques 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. @@ -119,6 +127,10 @@ Automatically generate change log from your tags, issues, labels and pull reques 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 @@ -151,6 +163,22 @@ Automatically generate change log from your tags, issues, labels and pull reques 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