diff options
Diffstat (limited to 'Documentation/user-search.txt')
-rw-r--r-- | Documentation/user-search.txt | 54 |
1 files changed, 30 insertions, 24 deletions
diff --git a/Documentation/user-search.txt b/Documentation/user-search.txt index 8a231fe72e..f4328be948 100644 --- a/Documentation/user-search.txt +++ b/Documentation/user-search.txt @@ -1,7 +1,7 @@ Gerrit Code Review - Searching Changes ====================================== -Default Searches +Default Searches ---------------- Most basic searches can be viewed by clicking on a link along the top @@ -23,6 +23,7 @@ matches the search, the change will be presented instead of a list. |Open changes in Foo | status:open project:Foo |================================================= + Basic Change Search ------------------- @@ -36,7 +37,7 @@ text and let Gerrit figure out the meaning: |Full or abbreviated Change-Id | Ic0ff33 |Full or abbreviated commit SHA-1 | d81b32ef |Email address | user@example.com -|Approval requirement | CodeReview>=+2, Verified=1 +|Approval requirement | Code-Review>=+2, Verified=1 |============================================================= @@ -109,7 +110,6 @@ matches project names by regular expression. The link:http://www.brics.dk/automaton/[dk.brics.automaton library] is used for evaluation of such patterns. - [[branch]] branch:'BRANCH':: + @@ -271,6 +271,17 @@ status:abandoned:: Change has been abandoned. +Argument Quoting +---------------- + +Operator values that are not bare words (roughly A-Z, a-z, 0-9, @, +hypen, dot and underscore) must be quoted for the query parser. + +Quoting is accepted as either double quotes +(e.g. `message:"the value"`) or as matched +curly braces (e.g. `message:{the value}`). + + Boolean Operators ----------------- @@ -306,18 +317,12 @@ Labels ------ Label operators can be used to match approval scores given during a code review. The specific set of supported labels depends on -the server configuration, however `CodeReview` and `Verified` +the server configuration, however `Code-Review` and `Verified` are the default labels provided out of the box. A label name is any of the following: -* The category name. If the category name contains spaces, - it must be wrapped in double quotes. Example: `label:"Code Review"`. - -* The name, without spaces. This avoids needing to use double quotes - for the common category Code Review. Example: `label:CodeReview`. - -* The internal short name. Example: `label:CRVW`, or `label:VRIF`. +* The label name. Example: `label:Code-Review`. * The one or two character abbreviation shown in the column header of change list pages. Example: `label:R` or `label:V`. @@ -325,38 +330,38 @@ A label name is any of the following: A label name must be followed by a score, or an operator and a score. The easiest way to explain this is by example. -`label:CodeReview=2`:: -`label:CodeReview=+2`:: -`label:CodeReview+2`:: +`label:Code-Review=2`:: +`label:Code-Review=+2`:: +`label:Code-Review+2`:: + -Matches changes where there is at least one +2 score for Code Review. +Matches changes where there is at least one +2 score for Code-Review. The + prefix is optional for positive score values. If the + is used, the = operator is optional. -`label:CodeReview=-2`:: -`label:CodeReview-2`:: +`label:Code-Review=-2`:: +`label:Code-Review-2`:: + -Matches changes where there is at least one -2 score for Code Review. +Matches changes where there is at least one -2 score for Code-Review. Because the negative sign is required, the = operator is optional. -`label:CodeReview=1`:: +`label:Code-Review=1`:: + -Matches changes where there is at least one +1 score for Code Review. +Matches changes where there is at least one +1 score for Code-Review. Scores of +2 are not matched, even though they are higher. -`label:CodeReview>=1`:: +`label:Code-Review>=1`:: + Matches changes with either a +1, +2, or any higher score. -`label:CodeReview<=-1`:: +`label:Code-Review<=-1`:: + Matches changes with either a -1, -2, or any lower score. -`is:open CodeReview+2 Verified+1 -Verified-1 -CodeReview-2`:: +`is:open Code-Review+2 Verified+1 -Verified-1 -Code-Review-2`:: + Matches changes that are ready to be submitted. -`is:open (Verified-1 OR CodeReview-2)`:: +`is:open (Verified-1 OR Code-Review-2)`:: + Changes that are blocked from submission due to a blocking score. @@ -427,6 +432,7 @@ set by the pagination system as the user navigates through results of a query. Including either value in a web query may lead to unpredictable results. + GERRIT ------ Part of link:index.html[Gerrit Code Review] |