summaryrefslogtreecommitdiffstats
path: root/git-bz.txt
diff options
context:
space:
mode:
authorPhilippe Normand <phil@base-art.net>2012-02-15 20:56:14 +0100
committerOwen W. Taylor <otaylor@fishsoup.net>2015-02-27 15:50:06 -0500
commit146ec9c0f35d8ea1494d3f400bffbd9fcde7f5d4 (patch)
treecc0318880fdeff5ecb43599e8d31dd3221a3e6c5 /git-bz.txt
parent3ba8322b80d8cb06c06dc79fb331fb8014556fcb (diff)
downloadgit-bz-146ec9c0f35d8ea1494d3f400bffbd9fcde7f5d4.tar.gz
Support for editing attachment flags.
One has to first define the available flags for the bugtracker used. The only way I found is to look at the source of the bugtracker "Create New Attachment" page. Examples of use of a review: flag below. Self-review would be: review: + Requesting a review from a specific person would look like: review: ? joe@example.com To request review from a specific person as shown above, the requesteeable git-bz option of the flag has to be set to true like: git config bz-tracker.bugzilla.mozilla.org.attachment-flag.review.requesteeable true (Patch includes fixes by Owen Taylor <otaylor@redhat.com>) https://bugzilla.gnome.org/show_bug.cgi?id=602406
Diffstat (limited to 'git-bz.txt')
-rw-r--r--git-bz.txt28
1 files changed, 28 insertions, 0 deletions
diff --git a/git-bz.txt b/git-bz.txt
index 4c4ac83..eaa8eb1 100644
--- a/git-bz.txt
+++ b/git-bz.txt
@@ -289,6 +289,34 @@ Firefox 3, Epiphany and Galeon are supported, and only on Linux. Patches to
add more support and to allow configuring username/password directly
per bug tracker accepted.
+ATTACHMENT FLAGS
+----------------
+
+When editing the description of an attachment with 'git-bz attach -e'
+it is possible to set flag values, depending on the configuration of
+the bug tracker. However, it is first necessary to configure the flag
+types available for your bug tracker. Ask the administrator of the
+tracker or inspect the HTML source code of the attachment.cgi
+page. For each flag you need to configure its id and whether or not it
+is requesteeable (eg. if you can ask for a specific bugzilla user to
+update the flag). Here is a sample configuration:
+
+----------------------------------------
+attachment-flag.review.id = 1
+attachment-flag.review.requesteeable = false
+----------------------------------------
+
+With the above flag configuration, when editing an attachment
+description you should see a template allowing setting the flag:
+
+----------------------------------------
+# Uncomment to set flags for the attachment; flags can be set to +,- , or ?.
+# When setting a flag to ? you can optionally specify individuals as, for example:
+# review: ? joe@example.com
+#review: ?
+----------------------------------------
+
+
BUG REFERENCES
--------------
On the command line, there are multiple ways to refer to a bug: