github_changelog_generator 1.15.0.pre.rc → 1.16.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (66) hide show
  1. checksums.yaml +5 -5
  2. data/LICENSE +1 -1
  3. data/README.md +134 -81
  4. data/Rakefile +1 -1
  5. data/bin/git-generate-changelog +1 -1
  6. data/lib/github_changelog_generator.rb +10 -6
  7. data/lib/github_changelog_generator/argv_parser.rb +224 -0
  8. data/lib/github_changelog_generator/generator/entry.rb +218 -0
  9. data/lib/github_changelog_generator/generator/generator.rb +120 -121
  10. data/lib/github_changelog_generator/generator/generator_fetcher.rb +138 -23
  11. data/lib/github_changelog_generator/generator/generator_processor.rb +60 -27
  12. data/lib/github_changelog_generator/generator/generator_tags.rb +25 -21
  13. data/lib/github_changelog_generator/generator/section.rb +124 -0
  14. data/lib/github_changelog_generator/helper.rb +1 -1
  15. data/lib/github_changelog_generator/octo_fetcher.rb +250 -96
  16. data/lib/github_changelog_generator/options.rb +39 -4
  17. data/lib/github_changelog_generator/parser.rb +70 -209
  18. data/lib/github_changelog_generator/parser_file.rb +35 -16
  19. data/lib/github_changelog_generator/reader.rb +2 -2
  20. data/lib/github_changelog_generator/ssl_certs/cacert.pem +851 -1680
  21. data/lib/github_changelog_generator/task.rb +4 -4
  22. data/lib/github_changelog_generator/version.rb +1 -1
  23. data/man/git-generate-changelog.1 +160 -74
  24. data/man/git-generate-changelog.1.html +159 -95
  25. data/man/git-generate-changelog.html +36 -24
  26. data/man/git-generate-changelog.md +156 -93
  27. data/spec/files/config_example +5 -0
  28. data/spec/files/github-changelog-generator.md +114 -114
  29. data/spec/{install-gem-in-bundler.gemfile → install_gem_in_bundler.gemfile} +2 -0
  30. data/spec/spec_helper.rb +2 -6
  31. data/spec/unit/generator/entry_spec.rb +766 -0
  32. data/spec/unit/generator/generator_processor_spec.rb +103 -41
  33. data/spec/unit/generator/generator_spec.rb +47 -0
  34. data/spec/unit/generator/generator_tags_spec.rb +51 -24
  35. data/spec/unit/generator/section_spec.rb +34 -0
  36. data/spec/unit/octo_fetcher_spec.rb +247 -197
  37. data/spec/unit/options_spec.rb +24 -0
  38. data/spec/unit/parse_file_spec.rb +2 -2
  39. data/spec/unit/parser_spec.rb +50 -0
  40. data/spec/unit/reader_spec.rb +4 -4
  41. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_commits/when_API_is_valid/returns_commits.json +1 -0
  42. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_commits_before/when_API_is_valid/returns_commits.json +1 -1
  43. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid.json +1 -1
  44. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_issue_with_proper_key/values.json +1 -1
  45. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_issues.json +1 -1
  46. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_issues_with_labels.json +1 -1
  47. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_pull_request_with_proper_key/values.json +1 -1
  48. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_issues_and_pr/when_API_call_is_valid/returns_pull_requests_with_labels.json +1 -1
  49. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_pull_requests/when_API_call_is_valid.json +1 -1
  50. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_pull_requests/when_API_call_is_valid/returns_correct_pull_request_keys.json +1 -1
  51. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_closed_pull_requests/when_API_call_is_valid/returns_pull_requests.json +1 -1
  52. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_commit/when_API_call_is_valid.json +1 -1
  53. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_commit/when_API_call_is_valid/returns_commit.json +1 -1
  54. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_date_of_tag/when_API_call_is_valid.json +1 -1
  55. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_date_of_tag/when_API_call_is_valid/returns_date.json +1 -1
  56. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_events_async/when_API_call_is_valid.json +1 -1
  57. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_fetch_events_async/when_API_call_is_valid/populates_issues.json +1 -1
  58. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_API_call_is_valid.json +1 -1
  59. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_API_call_is_valid/should_return_tags.json +1 -1
  60. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_API_call_is_valid/should_return_tags_count.json +1 -1
  61. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_wrong_token_provided.json +1 -1
  62. data/spec/vcr/GitHubChangelogGenerator_OctoFetcher/_github_fetch_tags/when_wrong_token_provided/should_raise_Unauthorized_error.json +1 -1
  63. metadata +56 -20
  64. data/bin/ghclgen +0 -5
  65. data/lib/github_changelog_generator/generator/generator_generation.rb +0 -181
  66. data/spec/unit/generator/generator_generation_spec.rb +0 -73
data/man/git-generate-changelog.1.html CHANGED
@@ -3,7 +3,7 @@
3
3
  <head>
4
4
  <meta http-equiv='content-type' value='text/html;charset=utf8'>
5
5
  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
6
- <title>git-generate-changelog(1) - Generate changelog from github</title>
6
+ <title>git-generate-changelog(1) - Generate changelog from GitHub</title>
7
7
  <style type='text/css' media='all'>
8
8
  /* style: man */
9
9
  body#manpage {margin:0}
@@ -57,6 +57,7 @@
57
57
  <a href="#SYNOPSIS">SYNOPSIS</a>
58
58
  <a href="#DESCRIPTION">DESCRIPTION</a>
59
59
  <a href="#OPTIONS">OPTIONS</a>
60
+ <a href="#REBASED-COMMITS">REBASED COMMITS</a>
60
61
  <a href="#EXAMPLES">EXAMPLES</a>
61
62
  <a href="#AUTHOR">AUTHOR</a>
62
63
  <a href="#REPORTING-BUGS">REPORTING BUGS</a>
@@ -71,7 +72,7 @@
71
72
 
72
73
  <h2 id="NAME">NAME</h2>
73
74
  <p class="man-name">
74
- <code>git-generate-changelog</code> - <span class="man-whatis">Generate changelog from github</span>
75
+ <code>git-generate-changelog</code> - <span class="man-whatis">Generate changelog from GitHub</span>
75
76
  </p>
76
77
 
77
78
  <h2 id="SYNOPSIS">SYNOPSIS</h2>
@@ -80,194 +81,257 @@
80
81
 
81
82
  <h2 id="DESCRIPTION">DESCRIPTION</h2>
82
83
 
83
- <p>Automatically generate change log from your tags, issues, labels and pull requests on GitHub.</p>
84
+ <p>Automatically generate changelog from your tags, issues, labels and pull requests on GitHub.</p>
84
85
 
85
86
  <h2 id="OPTIONS">OPTIONS</h2>
86
87
 
87
- <p> -u, --user [USER]</p>
88
+ <p> -u, --user USER</p>
88
89
 
89
- <p> Username of the owner of target GitHub repo</p>
90
+ <p> Username of the owner of target GitHub repo.</p>
90
91
 
91
- <p> -p, --project [PROJECT]</p>
92
+ <p> -p, --project PROJECT</p>
92
93
 
93
- <p> Name of project on GitHub</p>
94
+ <p> Name of project on GitHub.</p>
94
95
 
95
- <p> -t, --token [TOKEN]</p>
96
+ <p> -t, --token TOKEN</p>
96
97
 
97
98
  <p> To make more than 50 requests per hour your GitHub token is required. You can generate it at: https://github.com/settings/tokens/new</p>
98
99
 
99
- <p> -f, --date-format [FORMAT]</p>
100
+ <p> -f, --date-format FORMAT</p>
100
101
 
101
- <p> Date format. Default is %Y-%m-%d</p>
102
+ <p> Date format. Default is %Y-%m-%d.</p>
102
103
 
103
- <p> -o, --output [NAME]</p>
104
+ <p> -o, --output NAME</p>
104
105
 
105
- <p> Output file. Default is CHANGELOG.md</p>
106
+ <p> Output file. To print to STDOUT instead, use blank as path. Default is CHANGELOG.md.</p>
106
107
 
107
- <p> -b, --base [NAME]</p>
108
+ <p> -b, --base NAME</p>
108
109
 
109
110
  <p> Optional base file to append generated changes to.</p>
110
111
 
111
- <p> --bugs-label [LABEL]</p>
112
+ <p> --summary-label LABEL</p>
112
113
 
113
- <p> Setup custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong></p>
114
+ <p> Set up custom label for the release summary section. Default is "".</p>
114
115
 
115
- <p> --enhancement-label [LABEL]</p>
116
+ <p> --breaking-label LABEL</p>
116
117
 
117
- <p> Setup custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>"</p>
118
+ <p> Set up custom label for breaking changes section. Default is "<strong>Breaking changes:</strong>".</p>
118
119
 
119
- <p> --issues-label [LABEL]</p>
120
+ <p> --enhancement-label LABEL</p>
120
121
 
121
- <p> Setup custom label for closed-issues section. Default is "<strong>Closed issues:</strong>"</p>
122
+ <p> Set up custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>".</p>
122
123
 
123
- <p> --header-label [LABEL]</p>
124
+ <p> --bugs-label LABEL</p>
124
125
 
125
- <p> Setup custom header label. Default is "# Change Log"</p>
126
+ <p> Set up custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong>".</p>
126
127
 
127
- <p> --front-matter [JSON]</p>
128
+ <p> --deprecated-label LABEL</p>
128
129
 
129
- <p> Add YAML front matter. Formatted as JSON because it's easier to add on the command line</p>
130
+ <p> Set up custom label for deprecated section. Default is "<strong>Deprecated:</strong>".</p>
130
131
 
131
- <p> --pr-label [LABEL]</p>
132
+ <p> --removed-label LABEL</p>
132
133
 
133
- <p> Setup custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>"</p>
134
+ <p> Set up custom label for removed section. Default is "<strong>Removed:</strong>".</p>
134
135
 
135
- <p> --[no-]issues</p>
136
+ <p> --security-label LABEL</p>
136
137
 
137
- <p> Include closed issues in changelog. Default is true</p>
138
+ <p> Set up custom label for security section. Default is "<strong>Security:</strong>".</p>
138
139
 
139
- <p> --[no-]issues-wo-labels</p>
140
+ <p> --issues-label LABEL</p>
140
141
 
141
- <p> Include closed issues without labels in changelog. Default is true</p>
142
+ <p> Set up custom label for closed-issues section. Default is "<strong>Closed issues:</strong>".</p>
142
143
 
143
- <p> --[no-]pr-wo-labels</p>
144
+ <p> --header-label LABEL</p>
144
145
 
145
- <p> Include pull requests without labels in changelog. Default is true</p>
146
+ <p> Set up custom header label. Default is "# Changelog".</p>
146
147
 
147
- <p> --[no-]pull-requests</p>
148
+ <p> --configure-sections HASH, STRING</p>
148
149
 
149
- <p> Include pull-requests in changelog. Default is true</p>
150
+ <p> Define your own set of sections which overrides all default sections.</p>
150
151
 
151
- <p> --[no-]filter-by-milestone</p>
152
+ <p> --add-sections HASH, STRING</p>
152
153
 
153
- <p> Use milestone to detect when issue was resolved. Default is true</p>
154
+ <p> Add new sections but keep the default sections.</p>
154
155
 
155
- <p> --[no-]author</p>
156
+ <p> --front-matter JSON</p>
156
157
 
157
- <p> Add author of pull-request in the end. Default is true</p>
158
+ <p> Add YAML front matter. Formatted as JSON because it's easier to add on the command line.</p>
158
159
 
159
- <p> --usernames-as-github-logins</p>
160
+ <p> --pr-label LABEL</p>
160
161
 
161
- <p> Use GitHub tags instead of Markdown links for the author of an issue or pull-request.</p>
162
+ <p> Set up custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>".</p>
162
163
 
163
- <p> --unreleased-only</p>
164
+ <p> --[no-]issues</p>
164
165
 
165
- <p> Generate log from unreleased closed issues only.</p>
166
+ <p> Include closed issues in changelog. Default is true.</p>
166
167
 
167
- <p> --[no-]unreleased</p>
168
+ <p> --[no-]issues-wo-labels</p>
168
169
 
169
- <p> Add to log unreleased closed issues. Default is true</p>
170
+ <p> Include closed issues without labels in changelog. Default is true.</p>
170
171
 
171
- <p> --unreleased-label [label]</p>
172
+ <p> --[no-]pr-wo-labels</p>
172
173
 
173
- <p> Setup custom label for unreleased closed issues section. Default is "<strong>Unreleased:</strong>"</p>
174
+ <p> Include pull requests without labels in changelog. Default is true.</p>
174
175
 
175
- <p> --[no-]compare-link</p>
176
+ <p> --[no-]pull-requests</p>
176
177
 
177
- <p> Include compare link (Full Changelog) between older version and newer version. Default is true</p>
178
+ <p> Include pull-requests in changelog. Default is true.</p>
178
179
 
179
- <p> --include-labels x,y,z</p>
180
+ <p> --[no-]filter-by-milestone</p>
180
181
 
181
- <p> Only issues with the specified labels will be included in the changelog.</p>
182
+ <p> Use milestone to detect when issue was resolved. Default is true.</p>
182
183
 
183
- <p> --exclude-labels x,y,z</p>
184
+ <p> --[no-]issues-of-open-milestones</p>
184
185
 
185
- <p> Issues with the specified labels will be always excluded from changelog. Default is 'duplicate,question,invalid,wontfix'</p>
186
+ <p> Include issues of open milestones. Default is true.</p>
186
187
 
187
- <p> --bug-labels x,y,z</p>
188
+ <p> --[no-]author</p>
188
189
 
189
- <p> Issues with the specified labels will be always added to "Fixed bugs" section. Default is 'bug,Bug'</p>
190
+ <p> Add author of pull request at the end. Default is true.</p>
190
191
 
191
- <p> --enhancement-labels x,y,z</p>
192
+ <p> --usernames-as-github-logins</p>
192
193
 
193
- <p> Issues with the specified labels will be always added to "Implemented enhancements" section. Default is 'enhancement,Enhancement'</p>
194
+ <p> Use GitHub tags instead of Markdown links for the author of an issue or pull-request.</p>
194
195
 
195
- <p> --exclude-tags x,y,z</p>
196
+ <p> --unreleased-only</p>
196
197
 
197
- <p> Change log will exclude specified tags</p>
198
+ <p> Generate log from unreleased closed issues only.</p>
198
199
 
199
- <p> --exclude-tags-regex [REGEX]</p>
200
+ <p> --[no-]unreleased</p>
200
201
 
201
- <p> Apply a regular expression on tag names so that they can be excluded, for example: --exclude-tags-regex ".*+\d{1,}"</p>
202
+ <p> Add to log unreleased closed issues. Default is true.</p>
202
203
 
203
- <p> --since-tag x</p>
204
+ <p> --unreleased-label LABEL</p>
204
205
 
205
- <p> Change log will start after specified tag</p>
206
+ <p> Set up custom label for unreleased closed issues section. Default is "<strong>Unreleased:</strong>".</p>
206
207
 
207
- <p> --due-tag x</p>
208
+ <p> --[no-]compare-link</p>
208
209
 
209
- <p> Change log will end before specified tag</p>
210
+ <p> Include compare link (Full Changelog) between older version and newer version. Default is true.</p>
210
211
 
211
- <p> --max-issues [NUMBER]</p>
212
+ <p> --include-labels x,y,z</p>
212
213
 
213
- <p> Max number of issues to fetch from GitHub. Default is unlimited</p>
214
+ <p> Of the labeled issues, only include the ones with the specified labels.</p>
214
215
 
215
- <p> --release-url [URL]</p>
216
+ <p> --exclude-labels x,y,z</p>
216
217
 
217
- <p> The URL to point to for release links, in printf format (with the tag as variable).</p>
218
+ <p> Issues with the specified labels will be excluded from changelog. Default is 'duplicate,question,invalid,wontfix'.</p>
218
219
 
219
- <p> --github-site [URL]</p>
220
+ <p> --summary-labels x,y,z</p>
220
221
 
221
- <p> The Enterprise Github site on which your project is hosted.</p>
222
+ <p> Issues with these labels will be added to a new section, called "Release Summary". The section display only body of issues. Default is 'Release summary,release-summary,Summary,summary'.</p>
222
223
 
223
- <p> --github-api [URL]</p>
224
+ <p> --breaking-labels x,y,z</p>
224
225
 
225
- <p> The enterprise endpoint to use for your Github API.</p>
226
+ <p> Issues with these labels will be added to a new section, called "Breaking changes". Default is 'backwards-incompatible,breaking'.</p>
226
227
 
227
- <p> --simple-list</p>
228
+ <p> --enhancement-labels x,y,z</p>
228
229
 
229
- <p> Create simple list from issues and pull requests. Default is false.</p>
230
+ <p> Issues with the specified labels will be added to "Implemented enhancements" section. Default is 'enhancement,Enhancement'.</p>
230
231
 
231
- <p> --future-release [RELEASE-VERSION]</p>
232
+ <p> --bug-labels x,y,z</p>
232
233
 
233
- <p> Put the unreleased changes in the specified release number.</p>
234
+ <p> Issues with the specified labels will be added to "Fixed bugs" section. Default is 'bug,Bug'.</p>
234
235
 
235
- <p> --release-branch [RELEASE-BRANCH]</p>
236
+ <p> --deprecated-labels x,y,z</p>
236
237
 
237
- <p> Limit pull requests to the release branch, such as master or release</p>
238
+ <p> Issues with the specified labels will be added to a section called "Deprecated". Default is 'deprecated,Deprecated'.</p>
238
239
 
239
- <p> --http-cache</p>
240
+ <p> --removed-labels x,y,z</p>
240
241
 
241
- <p> Use HTTP Cache to cache Github API requests (useful for large repos) Default is true.</p>
242
+ <p> Issues with the specified labels will be added to a section called "Removed". Default is 'removed,Removed'.</p>
242
243
 
243
- <p> --[no-]cache-file [CACHE-FILE]</p>
244
+ <p> --security-labels x,y,z</p>
244
245
 
245
- <p> Filename to use for cache. Default is github-changelog-http-cache in a temporary directory.</p>
246
+ <p> Issues with the specified labels will be added to a section called "Security fixes". Default is 'security,Security'.</p>
246
247
 
247
- <p> --cache-log [CACHE-LOG]</p>
248
+ <p> --issue-line-labels x,y,z</p>
248
249
 
249
- <p> Filename to use for cache log. Default is github-changelog-logger.log in a temporary directory.</p>
250
+ <p> The specified labels will be shown in brackets next to each matching issue. Use "ALL" to show all labels. Default is [].</p>
250
251
 
251
- <pre><code>--ssl-ca-file [PATH]
252
- </code></pre>
252
+ <p> --exclude-tags x,y,z</p>
253
253
 
254
- <p> Path to cacert.pem file. Default is a bundled lib/github_changelog_generator/ssl_certs/cacert.pem. Respects SSL_CA_PATH.</p>
254
+ <p> Changelog will exclude specified tags.</p>
255
255
 
256
- <p> --require file1.rb,file2.rb</p>
256
+ <p> --exclude-tags-regex REGEX</p>
257
257
 
258
- <p> Paths to Ruby file(s) to require before generating changelog.</p>
258
+ <p> Apply a regular expression on tag names so that they can be excluded, for example: --exclude-tags-regex ".*+\d{1,}".</p>
259
259
 
260
- <p> --[no-]verbose</p>
260
+ <p> --since-tag x</p>
261
261
 
262
- <p> Run verbosely. Default is true</p>
262
+ <p> Changelog will start after specified tag.</p>
263
+
264
+ <p> --due-tag x</p>
265
+
266
+ <p> Changelog will end before specified tag.</p>
267
+
268
+ <p> --since-commit x</p>
269
+
270
+ <p> Fetch only commits after this time. eg. "2017-01-01 10:00:00"</p>
271
+
272
+ <p> --max-issues NUMBER</p>
273
+
274
+ <p> Maximum number of issues to fetch from GitHub. Default is unlimited.</p>
275
+
276
+ <p> --release-url URL</p>
277
+
278
+ <p> The URL to point to for release links, in printf format (with the tag as variable).</p>
279
+
280
+ <p> --github-site URL</p>
281
+
282
+ <p> The Enterprise GitHub site where your project is hosted.</p>
283
+
284
+ <p> --github-api URL</p>
285
+
286
+ <p> The enterprise endpoint to use for your GitHub API.</p>
287
+
288
+ <p> --simple-list</p>
289
+
290
+ <p> Create a simple list from issues and pull requests. Default is false.</p>
291
+
292
+ <p> --future-release RELEASE-VERSION</p>
293
+
294
+ <p> Put the unreleased changes in the specified release number.</p>
295
+
296
+ <p> --release-branch RELEASE-BRANCH</p>
297
+
298
+ <p> Limit pull requests to the release branch, such as master or release.</p>
299
+
300
+ <p> --http-cache</p>
301
+
302
+ <p> Use HTTP Cache to cache GitHub API requests (useful for large repos). Default is true.</p>
303
+
304
+ <p> --[no-]cache-file CACHE-FILE</p>
305
+
306
+ <p> Filename to use for cache. Default is github-changelog-http-cache in a temporary directory.</p>
307
+
308
+ <p> --cache-log CACHE-LOG</p>
309
+
310
+ <p> Filename to use for cache log. Default is github-changelog-logger.log in a temporary directory.</p>
311
+
312
+ <p> --ssl-ca-file PATH</p>
313
+
314
+ <p> Path to cacert.pem file. Default is a bundled lib/github_changelog_generator/ssl_certs/cacert.pem. Respects SSL_CA_PATH.</p>
315
+
316
+ <p> --require file1.rb,file2.rb</p>
317
+
318
+ <p> Paths to Ruby file(s) to require before generating changelog.</p>
319
+
320
+ <p> --[no-]verbose</p>
321
+
322
+ <p> Run verbosely. Default is true.</p>
263
323
 
264
324
  <p> -v, --version</p>
265
325
 
266
- <p> Print version number</p>
326
+ <p> Print version number.</p>
267
327
 
268
328
  <p> -h, --help</p>
269
329
 
270
- <p> Displays Help</p>
330
+ <p> Displays Help.</p>
331
+
332
+ <h2 id="REBASED-COMMITS">REBASED COMMITS</h2>
333
+
334
+ <p>GitHub pull requests that have been merged whose merge commit SHA has been modified through rebasing, cherry picking, or some other method may be tracked via a special comment on GitHub. Git commit SHAs found in comments on pull requests matching the regular expression <code>/rebased commit: ([0-9a-f]{40})/i</code> will be used in place of the original merge SHA when being added to the changelog.</p>
271
335
 
272
336
  <h2 id="EXAMPLES">EXAMPLES</h2>
273
337
 
@@ -277,16 +341,16 @@
277
341
 
278
342
  <h2 id="REPORTING-BUGS">REPORTING BUGS</h2>
279
343
 
280
- <p>&lt;<a href="https://github.com/skywinder/github-changelog-generator/issues" data-bare-link="true">https://github.com/skywinder/github-changelog-generator/issues</a>&gt;</p>
344
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/issues" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/issues</a>&gt;</p>
281
345
 
282
346
  <h2 id="SEE-ALSO">SEE ALSO</h2>
283
347
 
284
- <p>&lt;<a href="https://github.com/skywinder/github-changelog-generator/" data-bare-link="true">https://github.com/skywinder/github-changelog-generator/</a>&gt;</p>
348
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/</a>&gt;</p>
285
349
 
286
350
 
287
351
  <ol class='man-decor man-foot man foot'>
288
352
  <li class='tl'></li>
289
- <li class='tc'>October 2017</li>
353
+ <li class='tc'>May 2020</li>
290
354
  <li class='tr'>git-generate-changelog(1)</li>
291
355
  </ol>
292
356
 
data/man/git-generate-changelog.html CHANGED
@@ -80,51 +80,51 @@
80
80
 
81
81
  <h2 id="DESCRIPTION">DESCRIPTION</h2>
82
82
 
83
- <p>Automatically generate change log from your tags, issues, labels and pull requests on GitHub.</p>
83
+ <p>Automatically generate changelog from your tags, issues, labels and pull requests on GitHub.</p>
84
84
 
85
85
  <h2 id="OPTIONS">OPTIONS</h2>
86
86
 
87
- <p> -u, --user [USER]</p>
87
+ <p> -u, --user USER</p>
88
88
 
89
89
  <p> Username of the owner of target GitHub repo</p>
90
90
 
91
- <p> -p, --project [PROJECT]</p>
91
+ <p> -p, --project PROJECT</p>
92
92
 
93
93
  <p> Name of project on GitHub</p>
94
94
 
95
- <p> -t, --token [TOKEN]</p>
95
+ <p> -t, --token TOKEN</p>
96
96
 
97
97
  <p> To make more than 50 requests per hour your GitHub token is required. You can generate it at: https://github.com/settings/tokens/new</p>
98
98
 
99
- <p> -f, --date-format [FORMAT]</p>
99
+ <p> -f, --date-format FORMAT</p>
100
100
 
101
101
  <p> Date format. Default is %Y-%m-%d</p>
102
102
 
103
- <p> -o, --output [NAME]</p>
103
+ <p> -o, --output NAME</p>
104
104
 
105
105
  <p> Output file. Default is CHANGELOG.md</p>
106
106
 
107
- <p> -b, --base [NAME]</p>
107
+ <p> -b, --base NAME</p>
108
108
 
109
109
  <p> Optional base file to append generated changes to.</p>
110
110
 
111
- <p> --bugs-label [LABEL]</p>
111
+ <p> --bugs-label LABEL</p>
112
112
 
113
113
  <p> Setup custom label for bug-fixes section. Default is "<strong>Fixed bugs:</strong></p>
114
114
 
115
- <p> --enhancement-label [LABEL]</p>
115
+ <p> --enhancement-label LABEL</p>
116
116
 
117
117
  <p> Setup custom label for enhancements section. Default is "<strong>Implemented enhancements:</strong>"</p>
118
118
 
119
- <p> --issues-label [LABEL]</p>
119
+ <p> --issues-label LABEL</p>
120
120
 
121
121
  <p> Setup custom label for closed-issues section. Default is "<strong>Closed issues:</strong>"</p>
122
122
 
123
- <p> --header-label [LABEL]</p>
123
+ <p> --header-label LABEL</p>
124
124
 
125
- <p> Setup custom header label. Default is "# Change Log"</p>
125
+ <p> Setup custom header label. Default is "# Changelog"</p>
126
126
 
127
- <p> --pr-label [LABEL]</p>
127
+ <p> --pr-label LABEL</p>
128
128
 
129
129
  <p> Setup custom label for pull requests section. Default is "<strong>Merged pull requests:</strong>"</p>
130
130
 
@@ -160,7 +160,7 @@
160
160
 
161
161
  <p> Add to log unreleased closed issues. Default is true</p>
162
162
 
163
- <p> --unreleased-label [label]</p>
163
+ <p> --unreleased-label LABEL</p>
164
164
 
165
165
  <p> Add to log unreleased closed issues. Default is true</p>
166
166
 
@@ -186,29 +186,29 @@
186
186
 
187
187
  <p> --exclude-tags x,y,z</p>
188
188
 
189
- <p> Change log will exclude specified tags</p>
189
+ <p> Changelog will exclude specified tags</p>
190
190
 
191
191
  <p> --since-tag x</p>
192
192
 
193
- <p> Change log will start after specified tag</p>
193
+ <p> Changelog will start after specified tag</p>
194
194
 
195
195
  <p> --due-tag x</p>
196
196
 
197
- <p> Change log will end before specified tag</p>
197
+ <p> Changelog will end before specified tag</p>
198
198
 
199
- <p> --max-issues [NUMBER]</p>
199
+ <p> --max-issues NUMBER</p>
200
200
 
201
201
  <p> Max number of issues to fetch from GitHub. Default is unlimited</p>
202
202
 
203
- <p> --release-url [URL]</p>
203
+ <p> --release-url URL</p>
204
204
 
205
205
  <p> The URL to point to for release links, in printf format (with the tag as variable).</p>
206
206
 
207
- <p> --github-site [URL]</p>
207
+ <p> --github-site URL</p>
208
208
 
209
209
  <p> The Enterprise Github site on which your project is hosted.</p>
210
210
 
211
- <p> --github-api [URL]</p>
211
+ <p> --github-api URL</p>
212
212
 
213
213
  <p> The enterprise endpoint to use for your Github API.</p>
214
214
 
@@ -216,10 +216,22 @@
216
216
 
217
217
  <p> Create simple list from issues and pull requests. Default is false.</p>
218
218
 
219
- <p> --future-release [RELEASE-VERSION]</p>
219
+ <p> --future-release RELEASE-VERSION</p>
220
220
 
221
221
  <p> Put the unreleased changes in the specified release number.</p>
222
222
 
223
+ <p> --configure-sections HASH, STRING</p>
224
+
225
+ <p> Define your own set of sections which overrides all default sections") do |v|</p>
226
+
227
+ <p> --add-sections HASH, STRING</p>
228
+
229
+ <p> Add new sections but keep the default sections"</p>
230
+
231
+ <p> --include-merged</p>
232
+
233
+ <p> If configure_sections is set, use this to restore the merged pull requests sections</p>
234
+
223
235
  <p> --[no-]verbose</p>
224
236
 
225
237
  <p> Run verbosely. Default is true</p>
@@ -240,11 +252,11 @@
240
252
 
241
253
  <h2 id="REPORTING-BUGS">REPORTING BUGS</h2>
242
254
 
243
- <p>&lt;<a href="https://github.com/skywinder/github-changelog-generator/issues" data-bare-link="true">https://github.com/skywinder/github-changelog-generator/issues</a>&gt;</p>
255
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/issues" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/issues</a>&gt;</p>
244
256
 
245
257
  <h2 id="SEE-ALSO">SEE ALSO</h2>
246
258
 
247
- <p>&lt;<a href="https://github.com/skywinder/github-changelog-generator/" data-bare-link="true">https://github.com/skywinder/github-changelog-generator/</a>&gt;</p>
259
+ <p>&lt;<a href="https://github.com/github-changelog-generator/github-changelog-generator/" data-bare-link="true">https://github.com/github-changelog-generator/github-changelog-generator/</a>&gt;</p>
248
260
 
249
261
 
250
262
  <ol class='man-decor man-foot man foot'>