diff options
Diffstat (limited to 'docs/html/how.html')
| -rw-r--r-- | docs/html/how.html | 177 |
1 files changed, 158 insertions, 19 deletions
diff --git a/docs/html/how.html b/docs/html/how.html index 00825059c..fad287977 100644 --- a/docs/html/how.html +++ b/docs/html/how.html @@ -4,7 +4,8 @@ >How do I use Bugzilla?</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"><LINK REL="HOME" TITLE="The Bugzilla Guide - 2.17.5 Development Release" HREF="index.html"><LINK @@ -72,9 +73,7 @@ CLASS="section" ><H1 CLASS="section" ><A -NAME="how" -></A ->3.1. How do I use Bugzilla?</H1 +NAME="how">3.1. How do I use Bugzilla?</H1 ><P >This section contains information for end-users of Bugzilla. There is a Bugzilla test installation, called @@ -93,9 +92,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="myaccount" -></A ->3.1.1. Create a Bugzilla Account</H2 +NAME="myaccount">3.1.1. Create a Bugzilla Account</H2 ><P >If you want to use Bugzilla, first you need to create an account. Consult with the administrator responsible for your installation of @@ -163,9 +160,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="bug_page" -></A ->3.1.2. Anatomy of a Bug</H2 +NAME="bug_page">3.1.2. Anatomy of a Bug</H2 ><P >The core of Bugzilla is the screen which displays a particular bug. It's a good place to explain some Bugzilla concepts. @@ -430,9 +425,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="query" -></A ->3.1.3. Searching for Bugs</H2 +NAME="query">3.1.3. Searching for Bugs</H2 ><P >The Bugzilla Search page is is the interface where you can find any bug report, comment, or patch currently in the Bugzilla system. You @@ -460,9 +453,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="list" -></A ->3.1.4. Bug Lists</H2 +NAME="list">3.1.4. Bug Lists</H2 ><P >If you run a search, a list of matching bugs will be returned. The default search is to return all open bugs on the system - don't try @@ -534,9 +525,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="bugreports" -></A ->3.1.5. Filing Bugs</H2 +NAME="bugreports">3.1.5. Filing Bugs</H2 ><P >Years of bug writing experience has been distilled for your reading pleasure into the @@ -589,6 +578,156 @@ TARGET="_top" ></LI ></OL ></DIV +><DIV +CLASS="section" +><H2 +CLASS="section" +><A +NAME="patchviewer">3.1.6. Patch Viewer</H2 +><P +>Viewing and reviewing patches in Bugzilla is often difficult due to + lack of context, improper format and the inherent readability issues that + raw patches present. Patch Viewer is an enhancement to Bugzilla designed + to fix that by offering increased context, linking to sections, and + integrating with Bonsai, LXR and CVS.</P +><P +>Patch viewer allows you to:</P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +>View patches in color, with side-by-side view rather than trying + to interpret the contents of the patch.</TD +></TR +><TR +><TD +>See the difference between two patches.</TD +></TR +><TR +><TD +>Get more context in a patch.</TD +></TR +><TR +><TD +>Collapse and expand sections of a patch for easy + reading.</TD +></TR +><TR +><TD +>Link to a particular section of a patch for discussion or + review</TD +></TR +><TR +><TD +>Go to Bonsai or LXR to see more context, blame, and + cross-references for the part of the patch you are looking at</TD +></TR +><TR +><TD +>Create a rawtext unified format diff out of any patch, no + matter what format it came from</TD +></TR +></TBODY +></TABLE +><P +></P +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_view">3.1.6.1. Viewing Patches in Patch Viewer</H3 +><P +>The main way to view a patch in patch viewer is to click on the + "Diff" link next to a patch in the Attachments list on a bug. You may + also do this within the edit window by clicking the "View Attachment As + Diff" button in the Edit Attachment screen.</P +></DIV +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_diff">3.1.6.2. Seeing the Difference Between Two Patches</H3 +><P +>To see the difference between two patches, you must first view the + newer patch in Patch Viewer. Then select the older patch from the + dropdown at the top of the page ("Differences between [dropdown] and + this patch") and click the "Diff" button. This will show you what + is new or changed in the newer patch.</P +></DIV +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_context">3.1.6.3. Getting More Context in a Patch</H3 +><P +>To get more context in a patch, you put a number in the textbox at + the top of Patch Viewer ("Patch / File / [textbox]") and hit enter. + This will give you that many lines of context before and after each + change. Alternatively, you can click on the "File" link there and it + will show each change in the full context of the file. This feature only + works against files that were diffed using "cvs diff".</P +></DIV +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_collapse">3.1.6.4. Collapsing and Expanding Sections of a Patch</H3 +><P +>To view only a certain set of files in a patch (for example, if a + patch is absolutely huge and you want to only review part of it at a + time), you can click the "(+)" and "(-)" links next to each file (to + expand it or collapse it). If you want to collapse all files or expand + all files, you can click the "Collapse All" and "Expand All" links at the + top of the page.</P +></DIV +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_link">3.1.6.5. Linking to a Section of a Patch</H3 +><P +>To link to a section of a patch (for example, if you want to be + able to give someone a URL to show them which part you are talking + about) you simply click the "Link Here" link on the section header. The + resulting URL can be copied and used in discussion. (Copy Link + Location in Mozilla works as well.)</P +></DIV +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_bonsai_lxr">3.1.6.6. Going to Bonsai and LXR</H3 +><P +>To go to Bonsai to get blame for the lines you are interested in, + you can click the "Lines XX-YY" link on the section header you are + interested in. This works even if the patch is against an old + version of the file, since Bonsai stores all versions of the file.</P +><P +>To go to LXR, you click on the filename on the file header + (unfortunately, since LXR only does the most recent version, line + numbers are likely to rot).</P +></DIV +><DIV +CLASS="section" +><H3 +CLASS="section" +><A +NAME="patchviewer_unified_diff">3.1.6.7. Creating a Unified Diff</H3 +><P +>If the patch is not in a format that you like, you can turn it + into a unified diff format by clicking the "Raw Unified" link at the top + of the page.</P +></DIV +></DIV ></DIV ><DIV CLASS="NAVFOOTER" |