blob: ad4a75dd683758a2ea3dc74a06c6260d64742beb [file] [log] [blame] [edit]
## Setting up Bugtraq
*SINCE 1.4.0*
[Bugtraq](https://github.com/mstrap/bugtraq) is a specification started by Syntevo & supported by Gitblit to establish a standard to define and parse commit messages for linkable text.
### Why do I care?
It's a portable way for your repository to have linkable issue, pull request, change-id, etc text fragments. SmartGit/Hg and Gitblit both use the reference implementation available in the aforementioned Github project so if you configure Bugtraq for one you automatically get linked text in the other.
### How do I define the configuration?
You add a *.gitbugtraq* file to the root of your repository on the default branch.
This file is formatted like a standard Git config file. Here are some quick examples:
[bugtraq "googlecode"]
url = http://code.google.com/p/yourproject/issues/detail?id=%BUGID%
logregex = "[Ii]ssues?:?(\\s*(,|and)?\\s*#?\\d+)+\n(\\d+)"
[bugtraq "gerrit"]
url = "https://git.eclipse.org/r/#q,%BUGID%,n,z"
logregex = "Change-Id:\\s*(I[A-Fa-f0-9]{40})"
[bugtraq "jira"]
https://jira.atlassian.com/browse/%BUGID%
logregex = (JRA-\\d+)
[bugtraq "github"]
url = "https://github.com/gitblit/gitblit/pull/%BUGID%"
loglinkregex = "(?:pull request|pull|pr)\\s*[-#]?[0-9]+"
logregex = "\\d+"
loglinktext = "pull request #%BUGID%"