Skip to content

bugzilla
bugzilla
Commit dc9ca5af authored by lpsolit%gmail.com's avatar lpsolit%gmail.com
Browse files
Options

Bug 400629: The "User Preferences" doc page has no information about saved…

Bug 400629: The "User Preferences" doc page has no information about saved searches - Patch by Sam Folk-Williams <sam.folkwilliams@gmail.com> r=LpSolit
parent b66b08bb
Show whitespace changes
Inline Side-by-side
Showing with 111 additions and 88 deletions
docs/xml/using.xml
View file @ dc9ca5af
...@@ -398,18 +398,10 @@ ...@@ -398,18 +398,10 @@
values. If none is selected, then the field can take any value.</para> values. If none is selected, then the field can take any value.</para>
<para> <para>
Once you've run a search, you can save it as a Saved Search, which After a search is run, you can save it as a Saved Search, which
appears in the page footer. will appear in the page footer. If you are in the group defined
On the Saved Searches tab of your User Preferences page (the Prefs link by the "querysharegroup" parameter, you may share your queries
in Bugzilla's footer), members of the group defined in the with other users, see <xref linkend="savedsearches"/> for more details.
querysharegroup parameter can share such Saved Searches with user groups
so that other users may use them.
At the same place, you can see Saved Searches other users are sharing, and
have them show up in your personal Bugzilla footer along with your own
Saved Searches.
If somebody is sharing a Search with a group she or he is allowed to
<link linkend="groups">assign users to</link>, the sharer may opt to have
the Search show up in the group's direct members' footers by default.
</para> </para>
<section id="boolean"> <section id="boolean">
...@@ -1087,103 +1079,93 @@ ...@@ -1087,103 +1079,93 @@
<section id="userpreferences"> <section id="userpreferences">
<title>User Preferences</title> <title>User Preferences</title>
<para>Once you have logged in, you can customize various aspects of <para>
Bugzilla via the "Edit prefs" link in the page footer. Once logged in, you can customize various aspects of
The preferences are split into three tabs:</para> Bugzilla via the "Preferences" link in the page footer.
The preferences are split into five tabs:</para>
<section id="accountpreferences" xreflabel="Account Preferences">
<title>Account Preferences</title>
<para>On this tab, you can change your basic account information,
including your password, email address and real name. For security
reasons, in order to change anything on this page you must type your
<emphasis>current</emphasis>
password into the
<quote>Password</quote>
field at the top of the page.
If you attempt to change your email address, a confirmation
email is sent to both the old and new addresses, with a link to use to
confirm the change. This helps to prevent account hijacking.</para>
</section>
<section id="generalpreferences" xreflabel="General Preferences"> <section id="generalpreferences" xreflabel="General Preferences">
<title>General Preferences</title> <title>General Preferences</title>
<para> <para>
This tab allows you to change several Bugzilla behavior. This tab allows you to change several default settings of Bugzilla.
</para> </para>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">
<listitem> <listitem>
<para> <para>
Field separator character for CSV files - Bugzilla's general appearance (skin) - select which skin to use.
This controls separator character used in CSV formatted Bug List. Bugzilla supports adding custom skins.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
After changing bugs - This controls which bugs or no bugs Quote the associated comment when you click on its reply link - sets
are shown in the page after you changed bugs. the behavior of the comment "Reply" link. Options include quoting the
You can select the bug you've changed this time, or the next full comment, just reference the comment number, or turn the link off.
bug of the list.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add individual bugs to saved searches - this controls Language used in email - select which language email will be sent in,
whether you can add individual bugs to saved searches from the list of available languages.
or you can't.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
When viewing a bug, show comments in this order - After changing a bug - This controls what page is displayed after
This controls the order of comments, you can select below: changes to a bug are submitted. The options include to show the bug
<simplelist> just modified, to show the next bug in your list, or to do nothing.
<member>Initial description, comment 1, comment 2, ...</member>
<member>Initial description, last comment, ..., comment 2, comment 1.</member>
<member>Initial last comment, ..., comment 2, comment 1, description.</member>
</simplelist>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Show a quip at the top of each bug list - This controls Enable tags for bugs - turn bug tagging on or off.
whether a quip will be shown on the Bug list page or not.
</para> </para>
</listitem> </listitem>
</itemizedlist> <listitem>
</section>
<section id="emailpreferences">
<title>Email Preferences</title>
<para> <para>
This tab controls the amount of email Bugzilla sends you. Zoom textareas large when in use (requires JavaScript) - enable or
disable the automatic expanding of text areas when text is being
entered into them.
</para> </para>
</listitem>
<listitem>
<para> <para>
The first item on this page is marked <quote>Users to watch</quote>. Field separator character for CSV files -
When you enter one or more comma-delineated user accounts (usually email Select between a comma and semi-colon for exported CSV bug lists.
addresses) into the text entry box, you will receive a copy of all the
bugmail those users are sent (security settings permitting).
This powerful functionality enables seamless transitions as developers
change projects or users go on holiday.
</para> </para>
</listitem>
<note> <listitem>
<para> <para>
The ability to watch other users may not be available in all Automatically add me to the CC list of bugs I change - set default
Bugzilla installations. If you don't see this feature, and feel behavior of CC list. Options include "Always", "Never", and "Only
that you need it, speak to your administrator. if I have no role on them".
</para> </para>
</note> </listitem>
<listitem>
<para>
When viewing a bug, show comments in this order -
controls the order of comments. Options include "Oldest
to Newest", "Newest to Oldest" and "Newest to Oldest, but keep the
bug description at the top".
</para>
</listitem>
<listitem>
<para>
Show a quip at the top of each bug list - controls
whether a quip will be shown on the Bug list page.
</para>
</listitem>
</itemizedlist>
</section>
<section id="emailpreferences">
<title>Email Preferences</title>
<para> <para>
Each user listed in the <quote>Users watching you</quote> field This tab allows you to enable or disable email notification on
has you listed in their <quote>Users to watch</quote> list specific events.
and can get bugmail according to your relationship to the bug and
their <quote>Field/recipient specific options</quote> setting.
</para> </para>
<para> <para>
...@@ -1196,15 +1178,24 @@ ...@@ -1196,15 +1178,24 @@
<note> <note>
<para> <para>
Your Bugzilla administrator can stop a user from receiving A Bugzilla administrator can stop a user from receiving
bugmail by adding the user's name to the bugmail by clicking the <quote>Bugmail Disabled</quote> checkbox
<filename>data/nomail</filename> file. This is a drastic step when editing the user account. This is a drastic step
best taken only for disabled accounts, as it overrides best taken only for disabled accounts, as it overrides
the user's individual mail preferences. the user's individual mail preferences.
</para> </para>
</note> </note>
<para> <para>
There are two global options -- <quote>Email me when someone
asks me to set a flag</quote> and <quote>Email me when someone
sets a flag I asked for</quote>. These define how you want to
receive bugmail with regards to flags. Their use is quite
straightforward; enable the checkboxes if you want Bugzilla to
send you mail under either of the above conditions.
</para>
<para>
If you'd like to set your bugmail to something besides If you'd like to set your bugmail to something besides
'Completely ON' and 'Completely OFF', the 'Completely ON' and 'Completely OFF', the
<quote>Field/recipient specific options</quote> table <quote>Field/recipient specific options</quote> table
...@@ -1254,7 +1245,6 @@ ...@@ -1254,7 +1245,6 @@
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<note> <note>
<para> <para>
Some columns may not be visible for your installation, depending Some columns may not be visible for your installation, depending
...@@ -1287,22 +1277,55 @@ ...@@ -1287,22 +1277,55 @@
</note> </note>
<para> <para>
Two items not in the table (<quote>Email me when someone Bugzilla has a feature called <quote>Users Watching</quote>.
asks me to set a flag</quote> and <quote>Email me when someone When you enter one or more comma-delineated user accounts (usually email
sets a flag I asked for</quote>) define how you want to addresses) into the text entry box, you will receive a copy of all the
receive bugmail with regards to flags. Their use is quite bugmail those users are sent (security settings permitting).
straightforward; enable the checkboxes if you want Bugzilla to This powerful functionality enables seamless transitions as developers
send you mail under either of the above conditions. change projects or users go on holiday.
</para>
<note>
<para>
The ability to watch other users may not be available in all
Bugzilla installations. If you don't see this feature, and feel
that you need it, speak to your administrator.
</para>
</note>
<para>
Each user listed in the <quote>Users watching you</quote> field
has you listed in their <quote>Users to watch</quote> list
and can get bugmail according to your relationship to the bug and
their <quote>Field/recipient specific options</quote> setting.
</para> </para>
</section>
<section id="savedsearches" xreflabel="Saved Searches">
<title>Saved Searches</title>
<para> <para>
By default, Bugzilla sends out email regardless of who made the On this tab you can view and run any Saved Searches that you have
change... even if you were the one responsible for generating created, and also any Saved Searches that other members of the group
the email in the first place. If you don't care to receive bugmail defined in the "querysharegroup" parameter have shared.
from your own changes, check the box marked <quote>Only email me Saved Searches can be added to the page footer from this screen.
reports of changes made by other people</quote>. If somebody is sharing a Search with a group she or he is allowed to
<link linkend="groups">assign users to</link>, the sharer may opt to have
the Search show up in the footer of the group's direct members by default.
</para> </para>
</section>
<section id="accountpreferences" xreflabel="Name and Password">
<title>Name and Password</title>
<para>On this tab, you can change your basic account information,
including your password, email address and real name. For security
reasons, in order to change anything on this page you must type your
<emphasis>current</emphasis> password into the <quote>Password</quote>
field at the top of the page.
If you attempt to change your email address, a confirmation
email is sent to both the old and new addresses, with a link to use to
confirm the change. This helps to prevent account hijacking.</para>
</section> </section>
<section id="permissionsettings"> <section id="permissionsettings">
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment