From e428d12e19bdc0b4a2a45a1fbdc35dc270a93839 Mon Sep 17 00:00:00 2001
From: "lpsolit%gmail.com" <>
Date: Fri, 4 Apr 2008 11:47:54 +0000
Subject: Documentation for bug 180879: flags changes can be restricted to a
grant and request groups - Patch by me, r=myk
---
docs/en/xml/administration.xml | 91 ++++++++++++++++++++++++++++--------------
1 file changed, 60 insertions(+), 31 deletions(-)
(limited to 'docs')
diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml
index f22523026..f96882e3b 100644
--- a/docs/en/xml/administration.xml
+++ b/docs/en/xml/administration.xml
@@ -880,15 +880,15 @@
Using flag requests
- If a flag has been defined as 'requestable',
- users are allowed to set the flag's status to ?
.
- This status indicates that someone (aka the requester
is asking
- for someone else to set the flag to either +
or -
.
+ If a flag has been defined as 'requestable', and a user has enough privileges
+ to request it (see below), the user can set the flag's status to ?
.
+ This status indicates that someone (a.k.a. the requester
) is asking
+ someone else to set the flag to either +
or -
.
If a flag has been defined as 'specifically requestable',
a text box will appear next to the flag into which the requester may
- enter a Bugzilla username. That named person (aka the requestee
)
+ enter a Bugzilla username. That named person (a.k.a. the requestee
)
will receive an email notifying them of the request, and pointing them
to the bug/attachment in question.
@@ -926,8 +926,7 @@
- For a Bugzilla user, attachment flags show up in two
- places:
+ For a Bugzilla user, attachment flags show up in three places:
@@ -946,6 +945,14 @@
screen is where you set flags to ?, -, +, or unset them.
+
+
+ Requests are listed in the Request Queue
, which
+ is accessible from the My Requests
link (if you are
+ logged in) or Requests
link (if you are logged out)
+ visible in the footer of all pages.
+
+
@@ -956,14 +963,13 @@
Bug flags are used to set a status on the bug itself. You can
- see Bug Flags in the Show Bug
screen
- (editbug.cgi).
+ see Bug Flags in the Show Bug
and Requests
+ screens, as described above.
- Only users with the ability to edit the bug may
- set flags on bugs. This includes the assignee, reporter, and
- any user with the editbugs
- permission.
+ Only users with enough privileges (see below) may set flags on bugs.
+ This doesn't necessarily include the assignee, reporter, or users with the
+ editbugs permission.
@@ -998,17 +1004,18 @@
This is the name of the flag. This will be displayed
to Bugzilla users who are looking at or setting the flag.
- The name may consist of any valid Unicode character.
+ The name may contain any valid Unicode characters except commas
+ and spaces.
Description
- This describes the flag in more detail. At present, this doesn't
- show up anywhere helpful; ideally, it would be nice to have
- it show up as a tooltip. This field
- can be as long as you like, and can contain any character you want.
+ The description describes the flag in more detail. It is visible
+ in a tooltip when hovering over a flag either in the Show Bug
+ or Edit Attachment
pages. This field can be as
+ long as you like, and can contain any character you want.
@@ -1054,9 +1061,9 @@
You may select a Product without selecting a specific Component,
- but it is illegal to select a Component without a Product, or to select a
- Component that does not belong to the named Product. Doing so as of
- this writing (2.18rc3) will raise an error... even if all your products
+ but you can't select a Component without a Product, or to select a
+ Component that does not belong to the named Product. If you do so,
+ Bugzilla will display an error message, even if all your products
have a component by that name.
@@ -1112,16 +1119,6 @@
-
- CC List
-
-
- If you want certain users to be notified every time this flag is
- set to ?, -, +, or unset, add them here. This is a comma-separated
- list of email addresses that need not be restricted to Bugzilla usernames..
-
-
-
Specifically Requestable
@@ -1145,6 +1142,38 @@
+
+ CC List
+
+
+ If you want certain users to be notified every time this flag is
+ set to ?, -, +, or unset, add them here. This is a comma-separated
+ list of email addresses that need not be restricted to Bugzilla usernames.
+
+
+
+
+ Grant Group
+
+ When this field is set to some given group, only users in the group
+ can set the flag to +
and -
. This
+ field does not affect who can request or cancel the flag. For that,
+ see the Request Group
field below. If this field
+ is left blank, all users can set or delete this flag. This field is
+ useful for restricting which users can approve or reject requests.
+
+
+
+
+ Request Group
+
+ When this field is set to some given group, only users in the group
+ can request or cancel this flag. Note that this field has no effect
+ if the grant group
field is empty. You can set the
+ value of this field to a different group, but both fields have to be
+ set to a group for this field to have an effect.
+
+