280 lines
5.1 KiB
HTML
280 lines
5.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Hints and Tips</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
|
REL="HOME"
|
|
TITLE="The Bugzilla Guide - 3.4.2
|
|
Release"
|
|
HREF="index.html"><LINK
|
|
REL="UP"
|
|
TITLE="Using Bugzilla"
|
|
HREF="using.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Attachments"
|
|
HREF="attachments.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Time Tracking Information"
|
|
HREF="timetracking.html"></HEAD
|
|
><BODY
|
|
CLASS="section"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>The Bugzilla Guide - 3.4.2
|
|
Release</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="attachments.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
>Chapter 5. Using Bugzilla</TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="timetracking.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="section"
|
|
><H1
|
|
CLASS="section"
|
|
><A
|
|
NAME="hintsandtips"
|
|
>5.8. Hints and Tips</A
|
|
></H1
|
|
><P
|
|
>This section distills some Bugzilla tips and best practices
|
|
that have been developed.</P
|
|
><DIV
|
|
CLASS="section"
|
|
><H2
|
|
CLASS="section"
|
|
><A
|
|
NAME="AEN2653"
|
|
>5.8.1. Autolinkification</A
|
|
></H2
|
|
><P
|
|
>Bugzilla comments are plain text - so typing <U> will
|
|
produce less-than, U, greater-than rather than underlined text.
|
|
However, Bugzilla will automatically make hyperlinks out of certain
|
|
sorts of text in comments. For example, the text
|
|
"http://www.bugzilla.org" will be turned into a link:
|
|
<A
|
|
HREF="http://www.bugzilla.org"
|
|
TARGET="_top"
|
|
>http://www.bugzilla.org</A
|
|
>.
|
|
Other strings which get linkified in the obvious manner are:
|
|
<P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
><TBODY
|
|
><TR
|
|
><TD
|
|
>bug 12345</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>comment 7</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>bug 23456, comment 53</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>attachment 4321</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>mailto:george@example.com</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>george@example.com</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>ftp://ftp.mozilla.org</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>Most other sorts of URL</TD
|
|
></TR
|
|
></TBODY
|
|
></TABLE
|
|
><P
|
|
></P
|
|
>
|
|
</P
|
|
><P
|
|
>A corollary here is that if you type a bug number in a comment,
|
|
you should put the word "bug" before it, so it gets autolinkified
|
|
for the convenience of others.
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="section"
|
|
><H2
|
|
CLASS="section"
|
|
><A
|
|
NAME="commenting"
|
|
>5.8.2. Comments</A
|
|
></H2
|
|
><P
|
|
>If you are changing the fields on a bug, only comment if
|
|
either you have something pertinent to say, or Bugzilla requires it.
|
|
Otherwise, you may spam people unnecessarily with bug mail.
|
|
To take an example: a user can set up their account to filter out messages
|
|
where someone just adds themselves to the CC field of a bug
|
|
(which happens a lot.) If you come along, add yourself to the CC field,
|
|
and add a comment saying "Adding self to CC", then that person
|
|
gets a pointless piece of mail they would otherwise have avoided.
|
|
</P
|
|
><P
|
|
> Don't use sigs in comments. Signing your name ("Bill") is acceptable,
|
|
if you do it out of habit, but full mail/news-style
|
|
four line ASCII art creations are not.
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="section"
|
|
><H2
|
|
CLASS="section"
|
|
><A
|
|
NAME="comment-wrapping"
|
|
>5.8.3. Server-Side Comment Wrapping</A
|
|
></H2
|
|
><P
|
|
> Bugzilla stores comments unwrapped and wraps them at display time. This
|
|
ensures proper wrapping in all browsers. Lines beginning with the ">"
|
|
character are assumed to be quotes, and are not wrapped.
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="section"
|
|
><H2
|
|
CLASS="section"
|
|
><A
|
|
NAME="dependencytree"
|
|
>5.8.4. Dependency Tree</A
|
|
></H2
|
|
><P
|
|
> On the <SPAN
|
|
CLASS="QUOTE"
|
|
>"Dependency tree"</SPAN
|
|
> page linked from each bug
|
|
page, you can see the dependency relationship from the bug as a
|
|
tree structure.
|
|
</P
|
|
><P
|
|
> You can change how much depth to show, and you can hide resolved bugs
|
|
from this page. You can also collaps/expand dependencies for
|
|
each bug on the tree view, using the [-]/[+] buttons that appear
|
|
before its summary. This option is not available for terminal
|
|
bugs in the tree (that don't have further dependencies).
|
|
</P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="attachments.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="timetracking.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Attachments</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="using.html"
|
|
ACCESSKEY="U"
|
|
>Up</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Time Tracking Information</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |