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
Hide 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,69 +1079,82 @@ ...@@ -1087,69 +1079,82 @@
<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>
</listitem>
<listitem>
<para>
Quote the associated comment when you click on its reply link - sets
the behavior of the comment "Reply" link. Options include quoting the
full comment, just reference the comment number, or turn the link off.
</para>
</listitem>
<listitem>
<para>
Language used in email - select which language email will be sent in,
from the list of available languages.
</para>
</listitem>
<listitem>
<para>
After changing a bug - This controls what page is displayed after
changes to a bug are submitted. The options include to show the bug
just modified, to show the next bug in your list, or to do nothing.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
After changing bugs - This controls which bugs or no bugs Enable tags for bugs - turn bug tagging on or off.
are shown in the page after you changed bugs.
You can select the bug you've changed this time, or the next
bug of the list.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add individual bugs to saved searches - this controls Zoom textareas large when in use (requires JavaScript) - enable or
whether you can add individual bugs to saved searches disable the automatic expanding of text areas when text is being
or you can't. entered into them.
</para>
</listitem>
<listitem>
<para>
Field separator character for CSV files -
Select between a comma and semi-colon for exported CSV bug lists.
</para>
</listitem>
<listitem>
<para>
Automatically add me to the CC list of bugs I change - set default
behavior of CC list. Options include "Always", "Never", and "Only
if I have no role on them".
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
When viewing a bug, show comments in this order - When viewing a bug, show comments in this order -
This controls the order of comments, you can select below: controls the order of comments. Options include "Oldest
<simplelist> to Newest", "Newest to Oldest" and "Newest to Oldest, but keep the
<member>Initial description, comment 1, comment 2, ...</member> bug description at the top".
<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 Show a quip at the top of each bug list - controls
whether a quip will be shown on the Bug list page or not. whether a quip will be shown on the Bug list page.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
...@@ -1159,31 +1164,8 @@ ...@@ -1159,31 +1164,8 @@
<title>Email Preferences</title> <title>Email Preferences</title>
<para> <para>
This tab controls the amount of email Bugzilla sends you. This tab allows you to enable or disable email notification on
</para> specific events.
<para>
The first item on this page is marked <quote>Users to watch</quote>.
When you enter one or more comma-delineated user accounts (usually email
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>
<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>
<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,24 +1277,57 @@ ...@@ -1287,24 +1277,57 @@
</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> </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> <para>
By default, Bugzilla sends out email regardless of who made the Each user listed in the <quote>Users watching you</quote> field
change... even if you were the one responsible for generating has you listed in their <quote>Users to watch</quote> list
the email in the first place. If you don't care to receive bugmail and can get bugmail according to your relationship to the bug and
from your own changes, check the box marked <quote>Only email me their <quote>Field/recipient specific options</quote> setting.
reports of changes made by other people</quote>.
</para> </para>
</section> </section>
<section id="savedsearches" xreflabel="Saved Searches">
<title>Saved Searches</title>
<para>
On this tab you can view and run any Saved Searches that you have
created, and also any Saved Searches that other members of the group
defined in the "querysharegroup" parameter have shared.
Saved Searches can be added to the page footer from this screen.
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>
</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 id="permissionsettings"> <section id="permissionsettings">
<title>Permissions</title> <title>Permissions</title>
......
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