From 779b283127b310bb8676d11fed7a071ef1ce4ceb Mon Sep 17 00:00:00 2001 From: Max Kanat-Alexander Date: Wed, 17 Feb 2010 13:49:23 -0800 Subject: Bug 529201: Add help for every single field to fields.html r=LpSolit, a=LpSolit --- Bugzilla/Field.pm | 18 ++ page.cgi | 2 +- skins/standard/page.css | 33 ++ template/en/default/bug/field-help.none.tmpl | 224 +++++++++++++ template/en/default/global/help.html.tmpl | 5 +- template/en/default/pages/fields.html.tmpl | 349 +++++++++------------ .../en/default/search/search-advanced.html.tmpl | 2 +- template/en/default/search/search-help.html.tmpl | 104 ------ 8 files changed, 430 insertions(+), 307 deletions(-) create mode 100644 template/en/default/bug/field-help.none.tmpl delete mode 100644 template/en/default/search/search-help.html.tmpl diff --git a/Bugzilla/Field.pm b/Bugzilla/Field.pm index c2ab6e11b..6b9ceb7c0 100644 --- a/Bugzilla/Field.pm +++ b/Bugzilla/Field.pm @@ -547,6 +547,24 @@ sub legal_values { =over +=item C + +True if this is a time-tracking field that should only be shown to users +in the C. + +=back + +=cut + +sub is_timetracking { + my ($self) = @_; + return grep($_ eq $self->name, TIMETRACKING_FIELDS) ? 1 : 0; +} + +=pod + +=over + =item C What field controls this field's visibility? Returns a C diff --git a/page.cgi b/page.cgi index 9326229a5..5464789e7 100755 --- a/page.cgi +++ b/page.cgi @@ -43,7 +43,7 @@ use Bugzilla::Search::Quicksearch; # For quicksearch.html. sub quicksearch_field_names { - my $fields = Bugzilla::Search::Quicksearch::FIELD_MAP; + my $fields = Bugzilla::Search::Quicksearch->FIELD_MAP; my %fields_reverse; # Put longer names before shorter names. my @nicknames = sort { length($b) <=> length($a) } (keys %$fields); diff --git a/skins/standard/page.css b/skins/standard/page.css index 47869bb58..da0c3be8d 100644 --- a/skins/standard/page.css +++ b/skins/standard/page.css @@ -68,3 +68,36 @@ width: 10em; } +/***************/ +/* fields.html */ +/***************/ + +table.field_value_explanation { + table-layout: fixed; + border-collapse: collapse; +} + +.field_value_explanation thead h2 { + margin: 0; +} + +.field_value_explanation .header_row td { + text-align: center; + font-size: 120%; + font-weight: bold; +} + +.field_value_explanation tbody td { + border: 1px solid black; + padding: 1em; +} + +.field_value_explanation dt, +.field_descriptions dt +{ + margin-top: 1em; +} + +.field_descriptions dt { + font-size: 120%; +} diff --git a/template/en/default/bug/field-help.none.tmpl b/template/en/default/bug/field-help.none.tmpl new file mode 100644 index 000000000..549a89002 --- /dev/null +++ b/template/en/default/bug/field-help.none.tmpl @@ -0,0 +1,224 @@ +[%# The contents of this file are subject to the Mozilla Public + # License Version 1.1 (the "License"); you may not use this file + # except in compliance with the License. You may obtain a copy of + # the License at http://www.mozilla.org/MPL/ + # + # Software distributed under the License is distributed on an "AS + # IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or + # implied. See the License for the specific language governing + # rights and limitations under the License. + # + # The Original Code is the Bugzilla Bug Tracking System. + # + # The Initial Developer of the Original Code is Netscape Communications + # Corporation. Portions created by Netscape are + # Copyright (C) 1998 Netscape Communications Corporation. All + # Rights Reserved. + # + # Contributor(s): Gervase Markham + # Max Kanat-Alexander + #%] + +[%# This file describes both bug fields and search fields. %] + +[% PROCESS "global/field-descs.none.tmpl" %] + +[% help_html = { + +# Note that all these keys here are in alphabetical order, though +# search-specific fields are at the bottom. + +############## +# Bug Fields # +############## + +alias => + "A short, unique name assigned to $terms.abug in order to assist with + looking it up and referring to it in other places in ${terms.Bugzilla}.", + +assigned_to => + "The person in charge of resolving the ${terms.bug}.", + +blocked => + "This $terms.bug must be resolved before the $terms.bugs listed in this + field can be resolved.", + +bug_file_loc => + "$terms.Bugs can have a URL associated with them - for example, a" + _ " pointer to a web site where the problem is seen.", + +bug_id => + "The numeric id of $terms.abug, unique within this entire installation" + _ " of ${terms.Bugzilla}.", + +bug_severity => + "How severe the $terms.bug is, or whether it's an enhancement.", + +bug_status => + "$terms.Abug may be in any of a number of states.", + +cc => + "Users who may not have a direct role to play on this $terms.bug, but who + are interested in its progress.", + +classification => + "$terms.Bugs are categorised into Classifications, Products and" + _ " Components. classifications is the top-level categorisation.", + +component => + "Components are second-level categories; each belongs to a" + _ " particular Product. Select a Product to narrow down this list.", + +creation_ts => + "When the $terms.bug was filed.", + +deadline => + "The date that this $terms.bug must be resolved by, entered in YYYY-MM-DD + format.", + +delta_ts => + "When this $terms.bug was last updated.", + +dependson => + "The $terms.bugs listed here must be resolved before this $terms.bug + can be resolved.", + +estimated_time => + "The amount of time that has been estimated it will take to resolve + this ${terms.bug}.", + +keywords => + "You can add keywords from a defined list to $terms.bugs, in order" + _ " to tag and group them.", + +longdesc => + "$terms.Bugs have comments added to them by $terms.Bugzilla users." + _ "You can search for some text in those comments.", + +op_sys => + "The operating system the $terms.bug was observed on.", + +percentage_complete => + "How close to 100% done this $terms.bug is, by comparing its + $field_descs.work_time to its ${field_descs.estimated_time}.", + +priority => + "Engineers prioritize their $terms.bugs using this field.", + +# Note that this has extra text added below if useclassification is on. +product => + "$terms.Bugs are categorised into Products and Components.", + +qa_contact => + "The person responsible for confirming this $terms.bug if it is" + _ " unconfirmed, and for verifying the fix once the $terms.bug" + _ " has been resolved.", + +remaining_time => + "The number of hours of work left on this $terms.bug, calculated by + subtracting the $field_descs.work_time from the + ${field_descs.estimated_time}.", + +rep_platform => + "The hardware platform the $terms.bug was observed on.", + +reporter => + "The person who filed this ${terms.bug}.", + +resolution => + "If $terms.abug is in a resolved state, then one of these reasons" + _ " will be given for its resolution.", + +see_also => + "This allows you to refer to $terms.bugs in other installations. + You can enter a URL to $terms.abug in the 'Add $terms.Bug URLs' + field to note that that $terms.bug is related to this one. You can + enter multiple URLs at once by separating them with a comma. + +

You should normally use this field to refer to $terms.bugs in + other installations. For $terms.bugs in this + installation, it is better to use the $field_descs.dependson and + $field_descs.blocked fields.

", + +short_desc => + "The $terms.bug summary is a short sentence which succinctly" + _ " describes what the $terms.bug is about.", + +status_whiteboard => + "Each $terms.bug has a free-form single line text entry box for" + _ " adding tags and status information.", + +target_milestone => + "The target_milestone field is used to define when the engineer" + _ " the $terms.bug is assigned to expects to fix it.", + +version => + "The version field defines the version of the software the" + _ " $terms.bug was found in.", + +votes => + "Some $terms.bugs can be voted for, and you can limit your search to" + _ " $terms.bugs with more than a certain number of votes.", + +work_time => + "The total amount of time spent on this $terms.bug so far.", + +########################## +# Search-specific fields # +########################## + +chfield => + "You can search for specific types of change - this field defines" + _" which field you are interested in changes for.", + +# Duplicated to chfieldto below, also. +chfieldfrom => + "Specify the start and end dates either in YYYY-MM-DD format + optionally followed by HH:mm, in 24 hour clock), or in relative + dates such as 1h, 2d, 3w, 4m, 5y, which respectively mean one hour, + two days, three weeks, four months, or five years ago. 0d is last + midnight, and 0h, 0w, 0m, 0y is the beginning of this hour, week, + month, or year.", + +chfieldvalue => + "The value the field defined above changed to during that time.", + +content => + "This is a field available in searches that does a Google-like + 'full-text' search on the $field_descs.short_desc and + $field_descs.longdesc fields.", + +# Duplicated to email2 below, also. +email1 => + "Every $terms.bug has people associated with it in different" + _ " roles. Here, you can search on what people are in what role.", + +} %] + +[% help_html.email2 = help_html.email1 %] +[% help_html.chfieldto = help_html.chfieldfrom %] +[% help_html.deadlinefrom = help_html.deadline %] +[% help_html.deadlineto = help_html.deadline %] + +[% help_all_note = BLOCK %] + Note: When searching, selecting the option "All" + only finds [% terms.bugs %] whose value for this field is literally + the word "All". +[% END %] +[% FOREACH all_field = ['op_sys', 'rep_platform'] %] + [% help_html.$all_field = help_html.$all_field _ ' ' _ help_all_note %] +[% END %] + +[% IF Param('useclassification') %] + [% help_html.product = help_html.product + _ " Select a Classification to narrow down this list." %] +[% END %] + +[% FOREACH help_field = bug_fields.keys %] + [% type_desc = BLOCK %] + The type of [% field_descs.${help_field} FILTER html %] search you + would like. + [% END %] + [% SET type_name = help_field _ '_type' %] + [% help_html.$type_name = type_desc %] +[% END %] diff --git a/template/en/default/global/help.html.tmpl b/template/en/default/global/help.html.tmpl index 36439bc07..c0ff819ce 100644 --- a/template/en/default/global/help.html.tmpl +++ b/template/en/default/global/help.html.tmpl @@ -23,8 +23,9 @@ [% IF cgi.param("help") %] diff --git a/template/en/default/pages/fields.html.tmpl b/template/en/default/pages/fields.html.tmpl index 5be28cab7..184aef96f 100644 --- a/template/en/default/pages/fields.html.tmpl +++ b/template/en/default/pages/fields.html.tmpl @@ -20,128 +20,142 @@ #%] [% PROCESS "global/field-descs.none.tmpl" %] -[% INCLUDE global/header.html.tmpl title = "A $terms.Bug's Life Cycle" %] +[% PROCESS global/header.html.tmpl + title = "$terms.Bug Fields" + style_urls = ['skins/standard/page.css'] +%] -

-The status and resolution fields define and track the life -cycle of [% terms.abug %]. -

+

This page describes the various fields that you see + on [% terms.abug %].

- - - - - -
-

STATUS

+ + + + - - + + - + + - + + + + + - + + + + + @@ -149,7 +163,7 @@ cycle of [% terms.abug %]. +
+ +

[% field_descs.bug_status FILTER upper FILTER html %]

 -

RESOLUTION

+ +

[% field_descs.resolution FILTER upper FILTER html %]
The status field indicates the general health of a - [% terms.bug %]. Only certain status transitions are allowed.
The [% field_descs.bug_status FILTER html %] field indicates the + current state of a [% terms.bug %]. Only certain status transitions + are allowed.The resolution field indicates what happened to this - [%+ terms.bug %].The [% field_descs.resolution FILTER html %] field indicates what + happened to this [%+ terms.bug %].
Open [% terms.Bugs %]
- [% display_value("bug_status", "UNCONFIRMED") FILTER html %] + [% display_value("bug_status", "UNCONFIRMED") FILTER html %]
This [% terms.bug %] has recently been added to the database. - Nobody has validated that this [% terms.bug %] is true. Users + Nobody has confirmed that this [% terms.bug %] is valid. Users who have the "canconfirm" permission set may confirm - this [% terms.bug %], changing its state to [% display_value("bug_status", "NEW") FILTER html %]. Or, it may be - directly resolved and marked [% display_value("bug_status", "RESOLVED") FILTER html %]. + this [% terms.bug %], changing its state to + [% display_value("bug_status", "NEW") FILTER html %]. + Or, it may be directly resolved and marked + [% display_value("bug_status", "RESOLVED") FILTER html %].
- [% display_value("bug_status", "NEW") FILTER html %] + [% display_value("bug_status", "NEW") FILTER html %]
- This [% terms.bug %] has recently been added to the assignee's - list of [% terms.bugs %] and must be processed. [% terms.Bugs %] in - this state may be accepted, and become [% display_value("bug_status", "ASSIGNED") FILTER html %], passed - on to someone else, and remain [% display_value("bug_status", "NEW") FILTER html %], or resolved and marked + This [% terms.bug %] is valid and has recently been filed. + [%+ terms.Bugs %] in this state become + [% display_value("bug_status", "ASSIGNED") FILTER html %] when + somebody is working on them, or become resolved and marked [% display_value("bug_status", "RESOLVED") FILTER html %].
- [% display_value("bug_status", "ASSIGNED") FILTER html %] + [% display_value("bug_status", "ASSIGNED") FILTER html %]
- This [% terms.bug %] is not yet resolved, but is assigned to the - proper person. From here [% terms.bugs %] can be given to another - person and become [% display_value("bug_status", "NEW") FILTER html %], or - resolved and become [% display_value("bug_status", "RESOLVED") FILTER html %]. + This [% terms.bug %] is not yet resolved, but is assigned to the + proper person who is working on the [% terms.bug %]. From here, + [%+ terms.bugs %] can be given to another person and become + [% display_value("bug_status", "NEW") FILTER html %], or + resolved and become + [% display_value("bug_status", "RESOLVED") FILTER html %].
- [% display_value("bug_status", "REOPENED") FILTER html %] + [% display_value("bug_status", "REOPENED") FILTER html %]
- This [% terms.bug %] was once resolved, but the resolution was - deemed incorrect. For example, a [% display_value("resolution", "WORKSFORME") FILTER html %] [% terms.bug %] is - [% display_value("bug_status", "REOPENED") FILTER html %] when more information shows up and - the [% terms.bug %] is now reproducible. From here [% terms.bugs %] are - either marked [% display_value("bug_status", "ASSIGNED") FILTER html %] or + This [% terms.bug %] was once resolved, but the resolution was + deemed incorrect. For example, a + [% display_value("resolution", "WORKSFORME") FILTER html %] + [%+ terms.bug %] is marked + [% display_value("bug_status", "REOPENED") FILTER html %] when + more information shows up and the [% terms.bug %] is now + reproducible. From here, [% terms.bugs %] are either marked + [% display_value("bug_status", "ASSIGNED") FILTER html %] or [% display_value("bug_status", "RESOLVED") FILTER html %].
-
-
- No resolution yet. All [% terms.bugs %] which are in one of - these "open" states have the resolution set to blank. All - other [% terms.bugs %] will be marked with one of the following - resolutions. -
-
+ No resolution yet. All [% terms.bugs %] which are in one of + these "open" states have no resolution set.
Closed [% terms.Bugs %]
- [% display_value("bug_status", "RESOLVED") FILTER html %] + [% display_value("bug_status", "RESOLVED") FILTER html %]
- A resolution has been taken, and it is awaiting verification by - QA. From here [% terms.bugs %] are either re-opened and become - [% display_value("bug_status", "REOPENED") FILTER html %], are marked - [% display_value("bug_status", "VERIFIED") FILTER html %], or are closed for - good and marked [% display_value("bug_status", "CLOSED") FILTER html %]. + A resolution has been performed, and it is awaiting verification by + QA. From here [% terms.bugs %] are either re-opened and become + [% display_value("bug_status", "REOPENED") FILTER html %], are + marked [% display_value("bug_status", "VERIFIED") FILTER html %], + or are closed for good and marked + [% display_value("bug_status", "CLOSED") FILTER html %].
- [% display_value("bug_status", "VERIFIED") FILTER html %] + [% display_value("bug_status", "VERIFIED") FILTER html %]
- QA has looked at the [% terms.bug %] and the resolution and - agrees that the appropriate resolution has been taken. [% terms.Bugs %] remain - in this state until the product they were reported - against actually ships, at which point they become + QA has looked at the [% terms.bug %] and the resolution and + agrees that the appropriate resolution has been taken. + [%+ terms.Bugs %] remain in this state until the product they were + reported against actually ships, at which point they become [% display_value("bug_status", "CLOSED") FILTER html %].
- [% display_value("bug_status", "CLOSED") FILTER html %] + [% display_value("bug_status", "CLOSED") FILTER html %]
- The [% terms.bug %] is considered dead, the resolution is correct. - Any zombie [% terms.bugs %] who choose to walk the earth again must - do so by becoming [% display_value("bug_status", "REOPENED") FILTER html %]. + The [% terms.bug %] is considered dead, the resolution is correct. + Any zombie [% terms.bugs %] who choose to walk the earth again must + do so by becoming + [% display_value("bug_status", "REOPENED") FILTER html %].
- [% display_value("resolution", "FIXED") FILTER html %] + [% display_value("resolution", "FIXED") FILTER html %]
A fix for this [% terms.bug %] is checked into the tree and @@ -157,14 +171,14 @@ cycle of [% terms.abug %].
- [% display_value("resolution", "INVALID") FILTER html %] + [% display_value("resolution", "INVALID") FILTER html %]
The problem described is not [% terms.abug %].
- [% display_value("resolution", "WONTFIX") FILTER html %] + [% display_value("resolution", "WONTFIX") FILTER html %]
The problem described is [% terms.abug %] which will never be @@ -172,17 +186,18 @@ cycle of [% terms.abug %].
- [% display_value("resolution", "DUPLICATE") FILTER html %] + [% display_value("resolution", "DUPLICATE") FILTER html %]
The problem is a duplicate of an existing [% terms.bug %]. - Marking [% terms.abug %] duplicate requires the [% terms.bug %]# - of the duplicating [% terms.bug %] and will at least put - that [% terms.bug %] number in the description field. + When [% terms.abug %] is marked as a + [% display_value("resolution", "DUPLICATE") FILTER html %], + you will see which [% terms.bug %] it is a duplicate of, + next to the resolution.
- [% display_value("resolution", "WORKSFORME") FILTER html %] + [% display_value("resolution", "WORKSFORME") FILTER html %]
All attempts at reproducing this [% terms.bug %] were futile, @@ -191,141 +206,77 @@ cycle of [% terms.abug %]. the [% terms.bug %] can be reopened.
-
- [% display_value("resolution", "MOVED") FILTER html %] -
-
- The problem was specific to a related product - whose [% terms.bugs %] are tracked in - another [% terms.bug %] database. - The [% terms.bug %] has been moved to that database. -
+ [% IF Param('move-enabled') %] +
+ [% display_value("resolution", "MOVED") FILTER html %] +
+
+ The problem was specific to a related product + whose [% terms.bugs %] are tracked in + another [% terms.bug %] database. + The [% terms.bug %] has been moved to that database. +
+ [% END %]
-

Importance

-The importance of [% terms.abug %] is described as the combination of -its priority and severity, -as described below. - -

Priority

-This field describes the importance and order in which [% terms.abug %] -should be fixed compared to other [% terms.bugs %]. This field is utilized -by the programmers/engineers to prioritize their work to be done. - -

Severity

-This field describes the impact of [% terms.abug %]. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
[% display_value("bug_severity", "blocker") FILTER html %]Blocks development and/or testing work
[% display_value("bug_severity", "critical") FILTER html %]crashes, loss of data, severe memory leak
[% display_value("bug_severity", "major") FILTER html %]major loss of function
[% display_value("bug_severity", "normal") FILTER html %]regular issue, some loss of functionality under specific circumstances
[% display_value("bug_severity", "minor") FILTER html %]minor loss of function, or other problem where easy - workaround is present
[% display_value("bug_severity", "trivial") FILTER html %]cosmetic problem like misspelled words or misaligned - text
[% display_value("bug_severity", "enhancement") FILTER html %]Request for enhancement
- -

Platform

-This is the hardware platform against which the [% terms.bug %] was -reported. Legal platforms include: - -
    -
  • [% display_value("rep_platform", "All") FILTER html %] (happens on all platforms; cross-platform [% terms.bug %])
    • - -
  • [% display_value("rep_platform", "Macintosh") FILTER html %]
    • - -
  • [% display_value("rep_platform", "PC") FILTER html %]
    • -
-Note: When searching, selecting the option -[% display_value("rep_platform", "All") FILTER html %] does not -select [% terms.bugs %] -assigned against any platform. It merely selects [% terms.bugs %] that are -marked as occurring on all platforms, i.e. are designated -[% display_value("rep_platform", "All") FILTER html %]. - -

Operating System

-This is the operating system against which the [% terms.bug %] was -reported. Legal operating systems include: +

Other Fields

-
    -
  • [% display_value("op_sys", "All") FILTER html %] (happens on all operating systems; cross-platform - [% terms.bug %])
    • +[% PROCESS "bug/field-help.none.tmpl" %] -
  • Windows
    • - -
  • Mac OS
    • - -
  • Linux
    • -
-Sometimes the operating system implies the platform, but not -always. For example, Linux can run on PC and Macintosh and -others. - -

Assigned To

- -

-This is the person in charge of resolving the [% terms.bug %]. Every time -this field changes, the status changes to [% display_value("bug_status", "NEW") FILTER html %] to make it -easy to see which new [% terms.bugs %] have appeared on a person's list.

- -

-The default status for queries is set to [% display_value("bug_status", "NEW") FILTER html %], -[%+ display_value("bug_status", "ASSIGNED") FILTER html %] and [% display_value("bug_status", "REOPENED") FILTER html %]. -When searching for [% terms.bugs %] that have been resolved or -verified, remember to set the status field appropriately. -

- -[% IF Param("use_see_also") %] -

See Also

- -

This allows you to refer to [% terms.bugs %] in other installations. - You can enter a URL to a [%+ terms.bug %] in the "Add [% terms.Bug %] URLs" - field to note that that [% terms.bug %] is related to this one. You can - enter multiple URLs at once by separating them with a comma.

+[% SET field_help_map = {} %] +[% FOREACH field = bug_fields.keys %] + [% SET field_desc = field_descs.$field %] + [% field_help_map.$field_desc = { help => help_html.$field, + field => field } %] +[% END %] -

You should normally use this field to refer to [% terms.bugs %] in - other installations. For [% terms.bugs %] in this - installation, it is better to use the "Depends On" and "Blocks" - fields.

+[%# These are fields that don't need to be documented, either because + # they have docs somewhere else in the UI, or they don't show up on bugs. + # %] +[% SET skip_fields = [ + 'days_elapsed', + 'everconfirmed', + 'reporter_accessible', + 'cclist_accessible', + 'bug_group', + 'commenter', + 'owner_idle_time', + 'bug_status', + 'resolution', +] %] + +
+[% FOREACH field_desc = field_help_map.keys.sort %] + [% SET field = field_help_map.${field_desc}.field %] + [% SET field_object = bug_fields.$field %] + + [% NEXT IF field_object.obsolete %] + [% NEXT IF !user.is_timetracker AND field_object.is_timetracking %] + + [% NEXT IF field == 'status_whiteboard' AND !Param('usestatuswhiteboard') %] + [% NEXT IF field == 'target_milestone' AND !Param('usetargetmilestone') %] + [% NEXT IF field == 'alias' AND !Param('usebugaliases') %] + + [%# For now we don't have help for attachment fields and so on. %] + [% NEXT IF field.match('\.') %] + + [% NEXT IF skip_fields.contains(field) %] + +
[% field_desc FILTER html %]
+
+ [% SET help_text = field_help_map.${field_desc}.help %] + [% IF help_text %] + [% help_text FILTER none %] + [% ELSE %] + A custom [% field_types.${field_object.type} FILTER html %] field in + this installation of [% terms.Bugzilla %]. + [% END %] +
[% END %] +
-[% INCLUDE global/footer.html.tmpl %] +[% PROCESS global/footer.html.tmpl %] diff --git a/template/en/default/search/search-advanced.html.tmpl b/template/en/default/search/search-advanced.html.tmpl index cb0519a81..3a4252c2d 100644 --- a/template/en/default/search/search-advanced.html.tmpl +++ b/template/en/default/search/search-advanced.html.tmpl @@ -55,7 +55,7 @@ var queryform = "queryform" [% IF NOT cgi.param("help") %] document.write("

Give me some help<\/a> (reloads page).<\/p>"); [% ELSE %] - [% PROCESS "search/search-help.html.tmpl" %] + [% PROCESS "bug/field-help.none.tmpl" %] if (generateHelp()) document.write("

For help, mouse over the page elements.<\/p>"); else diff --git a/template/en/default/search/search-help.html.tmpl b/template/en/default/search/search-help.html.tmpl deleted file mode 100644 index 4dbf6652a..000000000 --- a/template/en/default/search/search-help.html.tmpl +++ /dev/null @@ -1,104 +0,0 @@ -[%# The contents of this file are subject to the Mozilla Public - # License Version 1.1 (the "License"); you may not use this file - # except in compliance with the License. You may obtain a copy of - # the License at http://www.mozilla.org/MPL/ - # - # Software distributed under the License is distributed on an "AS - # IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or - # implied. See the License for the specific language governing - # rights and limitations under the License. - # - # The Original Code is the Bugzilla Bug Tracking System. - # - # The Initial Developer of the Original Code is Netscape Communications - # Corporation. Portions created by Netscape are - # Copyright (C) 1998 Netscape Communications Corporation. All - # Rights Reserved. - # - # Contributor(s): Gervase Markham - #%] - -[% help_html = [ -{ id => "short_desc_type", - html => "The type of summary search you would like" }, -{ id => "short_desc", - html => "The $terms.bug summary is a short sentence which succinctly - describes
what the $terms.bug is about." }, -{ id => "classification", - html => "$terms.Bugs are categorised into Classifications, Products and Components. classifications is the
- top-level categorisation." }, -{ id => "product", - html => Param('useclassification') ? - "$terms.Bugs are categorised into Products and Components. Select a Classification to narrow down this list" : - "$terms.Bugs are categorised into Products and Components. Product is - the
top-level categorisation." }, -{ id => "component", - html => "Components are second-level categories; each belongs to a
- particular Product. Select a Product to narrow down this list." }, -{ id => "version", - html => "The version field defines the version of the software the - $terms.bug
was found in." }, -{ id => "target_milestone", - html => "The target_milestone field is used to define when the engineer
- the $terms.bug is assigned to expects to fix it." }, -{ id => "longdesc", - html => "$terms.Bugs have comments added to them by $terms.Bugzilla users. - You can
search for some text in those comments." }, -{ id => "longdesc_type", - html => "The type of comment search you would like" }, -{ id => "bug_file_loc", - html => "$terms.Bugs can have a URL associated with them - for example, a - pointer
to a web site where the problem is seen." }, -{ id => "bug_file_loc_type", - html => "The type of URL search you would like" }, -{ id => "status_whiteboard", - html => "Each $terms.bug has a free-form single line text entry box for - adding
tags and status information." }, -{ id => "status_whiteboard_type", - html => "The type of whiteboard search you would like" }, -{ id => "keywords", - html => "You can add keywords from a defined list to $terms.bugs, in order - to
tag and group them." }, -{ id => "keywords_type", - html => "The type of keyword search you would like" }, -{ id => "bug_status", - html => "$terms.Abug may be in any of a number of states." }, -{ id => "resolution", - html => "If $terms.abug is in a resolved state, then one of these reasons - will
be given for its resolution." }, -{ id => "bug_severity", - html => "How severe the $terms.bug is, or whether it's an enhancement." }, -{ id => "priority", - html => "Engineers prioritize their $terms.bugs using this field." }, -{ id => "rep_platform", - html => "The hardware platform the $terms.bug was observed on." }, -{ id => "op_sys", - html => "The operating system the $terms.bug was observed on." }, -{ id => "email1", - html => "Every $terms.bug has people associated with it in different - roles.
Here, you can search on what people are in what role." }, -{ id => "email2", - html => "Every $terms.bug has people associated with it in different - roles.
Here, you can search on what people are in what role." }, -{ id => "bug_id", - html => "You can limit your search to a specific set of $terms.bugs ." }, -{ id => "chfield", - html => "You can search for specific types of change - this field define
- which field you are interested in changes for." }, -{ id => "chfieldfrom", - html => "Specify the start and end dates either in YYYY-MM-DD format
- (optionally followed by HH:mm, in 24 hour clock), or in relative
- dates such as 1h, 2d, 3w, 4m, 5y, which respectively mean one hour,
- two days, three weeks, four months, or five years ago. 0d is last
- midnight, and 0h, 0w, 0m, 0y is the beginning of this hour, week,
- month, or year." }, -{ id => "chfieldto", - html => "Specify the start and end dates either in YYYY-MM-DD format
- (optionally followed by HH:mm, in 24 hour clock), or in relative
- dates such as 1h, 2d, 3w, 4m, 5y, which respectively mean one hour,
- two days, three weeks, four months, or five years ago. 0d is last
- midnight, and 0h, 0w, 0m, 0y is the beginning of this hour, week,
- month, or year." }, -{ id => "chfieldvalue", - html => "The value the field defined above changed to during that time." }, -] %] -- cgit v1.2.3-24-g4f1b