gitlab-org--gitlab-foss/doc/customization/issue_closing.md
2015-03-30 22:31:07 +03:00

1.3 KiB

Issue closing pattern

If a commit message matches the regular expression below, all issues referenced from the matched text will be closed. This happens when the commit is pushed or merged into the default branch of a project.

When not specified, the default issue_closing_pattern as shown below will be used:

((?:[Cc]los(?:e[sd]?|ing)|[Ff]ix(?:e[sd]|ing)?) +(?:(?:issues? +)?#\d+(?:(?:, *| +and +)?))+)

For example:

git commit -m "Awesome commit message (Fix #20, Fixes #21 and Closes #22). This commit is also related to #17 and fixes #18, #19 and #23."

will close #20, #21, #22, #18, #19 and #23, but #17 won't be closed as it does not match the pattern. It also works with multiline commit messages.

Tip: you can test this closing pattern at http://rubular.com. Use this site to test your own patterns.

Change the pattern

For Omnibus installs you can change the default pattern in /etc/gitlab/gitlab.rb:

issue_closing_pattern: '((?:[Cc]los(?:e[sd]|ing)|[Ff]ix(?:e[sd]|ing)?) +(?:(?:issues? +)?#\d+(?:(?:, *| +and +)?))+)'

For manual installs you can customize the pattern in gitlab.yml.