From 80e6ad84e317f0f4ee6f56b76541b071e5464423 Mon Sep 17 00:00:00 2001 From: lpsolit%gmail.com <> Date: Nov 24 2006 05:47:32 +0000 Subject: Docs for bug 313020: Implement the ability to add individual bugs to saved searches - Patch by me, r=Colin --- diff --git a/docs/xml/using.xml b/docs/xml/using.xml index 1f3bb60..8e9595d 100644 --- a/docs/xml/using.xml +++ b/docs/xml/using.xml @@ -492,88 +492,143 @@ - -
- Bug Lists +
+ Quicksearch - If you run a search, a list of matching bugs will be returned. - + + Quicksearch is a single-text-box query tool which uses + metacharacters to indicate what is to be searched. For example, typing + "foo|bar" + into Quicksearch would search for "foo" or "bar" in the + summary and status whiteboard of a bug; adding + ":BazProduct" would + search only in that product. + You can use it to find a bug by its number or its alias, too. + + + + You'll find the Quicksearch box in Bugzilla's footer area. + On Bugzilla's front page, there is an additional + Help + link which details how to use it. + +
+ +
+ Bug Lists + + If you run a search, a list of matching bugs will be returned. + - The format of the list is configurable. For example, it can be - sorted by clicking the column headings. Other useful features can be - accessed using the links at the bottom of the list: - - - Long Format: + The format of the list is configurable. For example, it can be + sorted by clicking the column headings. Other useful features can be + accessed using the links at the bottom of the list: + + + Long Format: - this gives you a large page with a non-editable summary of the fields - of each bug. + this gives you a large page with a non-editable summary of the fields + of each bug. - - CSV: + + XML: - get the buglist as comma-separated values, for import into e.g. - a spreadsheet. - - - RSS + get the buglist in the XML format. - get the buglist as an RSS 1.0 feed. Copy this link into your - favorite feed reader. If you are using Firefox, you can also - save the list as a live bookmark by clicking the live bookmark - icon in the status bar. To limit the number of bugs in the feed, - add a limit=n parameter to the URL. + + CSV: - - iCalendar + get the buglist as comma-separated values, for import into e.g. + a spreadsheet. - Get the buglist as an iCalendar file. Each bug is represented as a - to-do item in the imported calendar. - - - Change Columns: + + Feed: - change the bug attributes which appear in the list. + get the buglist as an Atom feed. Copy this link into your + favorite feed reader. If you are using Firefox, you can also + save the list as a live bookmark by clicking the live bookmark + icon in the status bar. To limit the number of bugs in the feed, + add a limit=n parameter to the URL. - - Change several bugs at once: + + iCalendar: - If your account is sufficiently empowered, you can make the same - change to all the bugs in the list - for example, changing their - assignee. + Get the buglist as an iCalendar file. Each bug is represented as a + to-do item in the imported calendar. - - Send mail to bug assignees: + + Change Columns: - Sends mail to the assignees of all bugs on the list. + change the bug attributes which appear in the list. - - Edit Search: + + Change several bugs at once: - If you didn't get exactly the results you were looking for, you can - return to the Query page through this link and make small revisions - to the query you just made so you get more accurate results. - - - Remember Search As: + If your account is sufficiently empowered, and more than one bug + appear in the bug list, this link is displayed which lets you make + the same change to all the bugs in the list - for example, changing + their assignee. - You can give a search a name and remember it; a link will appear - in your page footer giving you quick access to run it again later. - - - + + Send mail to bug assignees: - - If you would like to access the bug list from another program - it is often useful to have the list returned in something other - than HTML. By adding the ctype=type parameter into the bug list URL - you can specify several alternate formats. The supported formats - are: Comma Separated Values (ctype=csv), iCalendar (ctype=ics), - RDF Site Summary (RSS) 1.0 (ctype=rss), ECMAScript, also known - as JavaScript (ctype=js), and finally Resource Description Framework - RDF/XML (ctype=rdf). - + If more than one bug appear in the bug list and there are at least + two distinct bug assignees, this links is displayed which lets you + easily send a mail to the assignees of all bugs on the list. + + + Edit Search: + + If you didn't get exactly the results you were looking for, you can + return to the Query page through this link and make small revisions + to the query you just made so you get more accurate results. + + + Remember Search As: + + You can give a search a name and remember it; a link will appear + in your page footer giving you quick access to run it again later. + + + + + + If you would like to access the bug list from another program + it is often useful to have the list returned in something other + than HTML. By adding the ctype=type parameter into the bug list URL + you can specify several alternate formats. Besides the types described + above, the following formats are also supported: ECMAScript, also known + as JavaScript (ctype=js), and Resource Description Framework RDF/XML + (ctype=rdf). + +
+ +
+ Adding individual bugs from bug lists + + You can at any time add individual bugs to a special type + of saved searches, known as lists of bugs. The distinction + between both types is that saved searches, as described in the previous + section, are stored in the form of a list of matching criteria, while + a list of bugs is an enumerated list of bug numbers. As it is a simple + list of bug numbers, you can easily edit this list by adding + bugs to it. To enable this feature, you have to turn on the + Add individual bugs to saved searches user preference, + see . + + + + This feature is useful when you want to keep track of several bugs, but + for different reasons. Instead of adding yourself to the CC list of all + these bugs and mixing all these reasons, you can now store these bugs in + different lists, e.g. Bugs I want to see fixed before the next + release, Interesting bugs, or Bugs I have + to think about. One big advantage of this way to manage bug lists + is that you can easily add bugs one by one, which is not possible to do + with saved searches without having to edit the search criteria again. + +
@@ -835,25 +890,6 @@
-
- Quicksearch - - Quicksearch is a single-text-box query tool which uses - metacharacters to indicate what is to be searched. For example, typing - "foo|bar" - into Quicksearch would search for "foo" or "bar" in the - summary and status whiteboard of a bug; adding - ":BazProduct" would - search only in that product. - You can use it to find a bug by its number or its alias, too. - - - You'll find the Quicksearch box in Bugzilla's footer area. - On Bugzilla's front page, there is an additional - Help - link which details how to use it. -
-
Comments