@@ -1373,12 +1373,14 @@ Group3, since he isn't in Group4.
...
@@ -1373,12 +1373,14 @@ Group3, since he isn't in Group4.
make certain files world readable and/or writable. <emphasis>THIS IS
make certain files world readable and/or writable. <emphasis>THIS IS
INSECURE!</emphasis>. This means that anyone who can get access to
INSECURE!</emphasis>. This means that anyone who can get access to
your system can do whatever they want to your Bugzilla installation.
your system can do whatever they want to your Bugzilla installation.
</para>
<note>
<note>
<para>
This also means that if your webserver runs all cgi scripts as the
This also means that if your webserver runs all cgi scripts as the
same user/group, anyone on the system who can run cgi scripts will
same user/group, anyone on the system who can run cgi scripts will
be able to take control of your Bugzilla installation.
be able to take control of your Bugzilla installation.
</note>
</para>
</para>
</note>
<para>
<para>
On Apache, you can use .htaccess files to protect access
On Apache, you can use .htaccess files to protect access
to these directories, as outlined in <ulinkurl="http://bugzilla.mozilla.org/show_bug.cgi?id=57161">Bug 57161</ulink> for the localconfig file, and <ulinkurl="http://bugzilla.mozilla.org/show_bug.cgi?id=65572"> Bug 65572</ulink> for adequate protection in your data/ and shadow/ directories.
to these directories, as outlined in <ulinkurl="http://bugzilla.mozilla.org/show_bug.cgi?id=57161">Bug 57161</ulink> for the localconfig file, and <ulinkurl="http://bugzilla.mozilla.org/show_bug.cgi?id=65572"> Bug 65572</ulink> for adequate protection in your data/ and shadow/ directories.
<entry><programlisting><sgmltagclass="starttag">para</sgmltag>Beginning and end of paragraph<sgmltagclass="endtag">para</sgmltag></programlisting></entry>
Click the <quote>Open a new Bugzilla account</quote> link, enter your
email address and, optionally, your name in the spaces provided,
link, enter your email address and, optionally, your name in the
then click <quote>Create Account</quote>.
spaces provided, then click
</para>
<quote>Create Account</quote>
.</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>Within moments, you should receive an email to the address
<para>
you provided, which contains your login name (generally the
Within moments, you should receive an email to the address
same as the email address), and a password.
you provided above, which contains your login name
This password is randomly generated, but can be
(generally the same as the email address), and a password
changed to something more memorable.</para>
you can use to access your account. This password is
randomly generated, and can be changed to something more memorable.
</para>
</listitem>
</listitem>
<listitem>
<listitem>
<para>Click the
<para>
<quote>Log In</quote>
Click the <quote>Log In</quote> link in the yellow area at
link in the footer at the bottom of the page in your browser,
the bottom of the page in your browser, enter your
enter your email address and password into the spaces provided, and
email address and password into the spaces provided, and click
click
<quote>Login</quote>.
<quote>Login</quote>.
</para>
</para>
</listitem>
</listitem>
</orderedlist>
</orderedlist>
<para>
<para>You are now logged in. Bugzilla uses cookies to remember you are
You are now logged in. Bugzilla uses cookies for authentication, so
logged in so, unless you have cookies disabled or your IP address changes,
(unless your IP address changes) you should not have to log in again.
you should not have to log in again.</para>
</para>
</section>
</section>
<sectionid="bug_page">
<sectionid="bug_page">
<title>Anatomy of a Bug</title>
<title>Anatomy of a Bug</title>
<para>
<para>The core of Bugzilla is the screen which displays a particular
The core of Bugzilla is the screen which displays a particular bug.
bug. It's a good place to explain some Bugzilla concepts.
It's a good place to explain some Bugzilla concepts.
<ulink
<ulinkurl="http://landfill.tequilarista.org/bugzilla-tip/show_bug.cgi?id=1">Bug 1 on Landfill</ulink> is a good example. Note that the names of most fields
While some of the advice is Mozilla-specific, the basic principles of
While some of the advice is Mozilla-specific, the basic principles of reporting Reproducible, Specific bugs, isolating the Product you are using, the Version of the Product, the Component which failed, the Hardware Platform, and Operating System you were using at the time of the failure go a long way toward ensuring accurate, responsible fixes for the bug that bit you.
reporting Reproducible, Specific bugs, isolating the Product you are
</para>
using, the Version of the Product, the Component which failed, the
<para>
Hardware Platform, and Operating System you were using at the time of
The procedure for filing a test bug is as follows:
the failure go a long way toward ensuring accurate, responsible fixes
</para>
for the bug that bit you.</para>
<para>The procedure for filing a test bug is as follows:</para>
<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>
<sectionid="emailsettings">
<title>Email Settings</title>
<para>On this tab you can reduce or increase the amount of email sent
you from Bugzilla, opting in our out depending on your relationship to
the bug and the change that was made to it.
</para>
<para>
You can also do further filtering on the client side by
using the X-Bugzilla-Reason mail header which Bugzilla
adds to all bugmail. This tells you what relationship you have to the
bug in question,
and can be any of Owner, Reporter, QAcontact, CClist, Voter and
WatchingComponent.</para>
<para>By entering user email names, delineated by commas, into the
"Users to watch" text entry box you can receive a copy of all the
bugmail of other users (security settings permitting.) This powerful
functionality enables seamless transitions as developers change
projects or users go on holiday.</para>
<note>
<note>
<para>The ability to watch other users may not be available in all
<para>
Bugzilla installations. If you can't see it, ask your
By default, this page is quite barren. However, go explore
administrator.</para>
the Query Page some more; you will find that you can store
numerous queries on the server, so if you regularly run a
particular query it is just a drop-down menu away. On this
page of Preferences, if you have many stored queries you can
elect to have them always one-click away!
</para>
</note>
</note>
<para>
If you have many stored queries on the server, here you will
find individual drop-downs for each stored query. Each
drop-down gives you the option of that query appearing on the
footer of every page in Bugzilla! This gives you powerful
one-click access to any complex searches you may set up, and
is an excellent way to impress your boss...
</para>
<tip>
<para>By default, the "My Bugs" link appears at the bottom of
each page. However, this query gives you both the bugs you
have reported, as well as those you are assigned. One of
the most common uses for this page is to remove the "My
Bugs" link, replacing it with two other queries, commonly
called "My Bug Reports" and "My Bugs" (but only referencing
bugs assigned to you). This allows you to distinguish those
bugs you have reported from those you are assigned. I
commonly set up complex Boolean queries in the Query page
and link them to my footer in this page. When they are
significantly complex, a one-click reference can save hours
of work.</para>
</tip>
</section>
</section>
<sectionid="permissionsettings">
<sectionid="permissionsettings">
<title>Permissions</title>
<title>Permissions</title>
<para>
<para>This is a purely informative page which outlines your current
This is a purely informative page which outlines your current
permissions on this installation of Bugzilla - what product groups you
permissions on this installation of Bugzilla. If you have
are in, and whether you can edit bugs or perform various administration
permissions to grant certain permissions to other users, the
functions.</para>
"other users" link appears on this page as well as the footer.
</section>
For more information regarding user administration, please
consult the Administration section of this Guide.
</para>
</section>
</section>
<sectionid="reporting">
<title>Reports</title>
<para><emphasis>To be written</emphasis></para>
</section>
</section>
<sectionid="usingbz-conc">
<title>Using Bugzilla-Conclusion</title>
<para>
Thank you for reading through this portion of the Bugzilla
Guide. I anticipate it may not yet meet the needs of all
readers. If you have additional comments or corrections to
make, please submit your contributions to the <ulink
url="mailto://mozilla-webtools@mozilla.org">mozilla-webtools</ulink> mailing list/newsgroup. The mailing list is mirrored to the netscape.public.mozilla.webtools newsgroup, and the newsgroup is mirrored to mozilla-webtools@mozilla.org
