bug-writing.html.tmpl

bugzilla的安装文件

    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  "?</b><br>\n     List the full e-mail addresses of other individuals who should receive\n    an e-mail update upon every change to the ";
    #line 182 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " report. You can\n    enter as many e-mail addresses as you'd like, separated by spaces or \n    commas, as long as those people have ";
    #line 184 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bugzilla', 0]);
    $output .=  " accounts.</p>\n  </blockquote>\n\n  <p><b>What else can you tell the engineer about the ";
    #line 187 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  "?</b></p>\n\n  <blockquote>\n    <p><b>Summary:</b> <b>How would you describe the ";
    #line 190 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  ", in \n    approximately 60 or fewer characters?</b><br>\n     A good summary should <b>quickly and uniquely identify ";
    #line 192 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'abug', 0]);
    $output .=  "\n    report</b>. Otherwise, an engineer cannot meaningfully identify your";
    #line 195 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " by its summary, and will often fail to pay attention to \n    your ";
    #line 196 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " report when skimming through a 10 \n    page ";
    #line 197 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " list.<br>\n    <br>\n     A useful summary might be \"<tt>PCMCIA install fails on Tosh Tecra\n    780DVD w/ 3c589C</tt>\". \"<tt>Software fails</tt>\" or \"<tt>install\n    problem</tt>\" would be examples of a bad summary.<br>\n    <br>\n     [ <a href=\"#summary\">Tell Me More</a> ]<br>\n    <br>\n     <b>Description:</b><br>\n     Please provide a detailed problem report in this field. Your ";
    #line 208 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  "'s recipients will most likely expect the following \n     information:</p>\n\n    <blockquote>\n      <p><b>Overview Description:</b> More detailed expansion of\n      summary.</p>\n\n      <blockquote>\n<pre>\nDrag-selecting any page crashes Mac builds in NSGetFactory\n</pre>\n      </blockquote>\n\n      <p><b>Steps to Reproduce:</b> Minimized, easy-to-follow steps that\n      will trigger the ";
    #line 222 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  ". Include any special setup steps.</p>\n\n      <blockquote>\n<pre>\n1) View any web page. (I used the default sample page,\nresource:/res/samples/test0.html)\n\n2) Drag-select the page. (Specifically, while holding down \nthe mouse button, drag the mouse pointer downwards from any \npoint in the browser's content region to the bottom of the \nbrowser's content region.)                   \n</pre>\n      </blockquote>\n\n      <p><b>Actual Results:</b> What the application did after performing\n      the above steps.</p>\n\n      <blockquote>\n<pre>\nThe application crashed. Stack crawl appended below from MacsBug.\n</pre>\n      </blockquote>\n\n      <p><b>Expected Results:</b> What the application should have done,\n      were the ";
    #line 246 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " not present.</p>\n\n      <blockquote>\n<pre>\nThe window should scroll downwards. Scrolled content should be selected. \n(Or, at least, the application should not crash.)\n</pre>\n      </blockquote>\n\n      <p><b>Build Date &amp; Platform:</b> Date and platform of the build\n      that you first encountered the ";
    #line 256 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " in.</p>\n\n      <blockquote>\n<pre>\nBuild 2002-03-15 on Mac OS 9.0\n</pre>\n      </blockquote>\n\n      <p><b>Additional Builds and Platforms:</b> Whether or not \n      the ";
    #line 265 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " takes place on other platforms (or browsers, \n      if applicable).</p>\n\n      <blockquote>\n<pre>\n- Also Occurs On        \nMozilla (2002-03-15 build on Windows NT 4.0) \n\n- Doesn't Occur On        \nMozilla (2002-03-15 build on Red Hat Linux; feature not supported)        \nInternet Explorer 5.0 (shipping build on Windows NT 4.0)        \nNetscape Communicator 4.5 (shipping build on Mac OS 9.0)\n</pre>\n      </blockquote>\n\n      <p><b>Additional Information:</b> Any other debugging information.\n      For crashing ";
    #line 281 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  ":</p>\n\n      <ul>\n        <li><b>Win32:</b> if you receive a Dr. Watson error, please note\n        the type of the crash, and the module that the application crashed\n        in. (e.g. access violation in apprunner.exe)</li>\n\n        <li><b>Mac OS:</b> if you're running MacsBug, please provide the\n        results of a <b>how</b> and an <b>sc</b>:</li>\n      </ul>\n\n      <blockquote>\n<pre>\n*** MACSBUG STACK CRAWL OF CRASH (Mac OS)\nCalling chain using A6/R1 links \nBack chain  ISA  Caller \n00000000    PPC  0BA85E74   \n03AEFD80    PPC  0B742248   \n03AEFD30    PPC  0B50FDDC  NSGetFactory+027FC\nPowerPC unmapped memory exception at 0B512BD0 NSGetFactory+055F0\n</pre>\n      </blockquote>\n    </blockquote>\n  </blockquote>\n\n  <p>You're done!<br>\n  <br>\n   After double-checking your entries for any possible errors, press the\n  \"Commit\" button, and your ";
    #line 309 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " report will now be in \n  the ";
    #line 310 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bugzilla', 0]);
    $output .=  " database.<br>\n  </p>\n</blockquote>\n<hr>\n\n<h3>More Information on Writing Good ";
    #line 315 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bugs', 0]);
    $output .=  "</h3>\n\n<blockquote>\n  <p><b><a name=\"tips\"></a> 1. General Tips for a Useful ";
    #line 318 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bug', 0]);
    $output .=  " \n     Report</b></p>\n\n  <blockquote>\n    <p><b>Use an explicit structure, so your ";
    #line 322 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " reports are easy\n    to skim.</b> ";
    #line 323 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bug', 0]);
    $output .=  " report users often need immediate access to \n    specific sections of your ";
    #line 324 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  ". If your ";
    #line 324 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bugzilla', 0]);
    $output .=  " \n    installation supports the ";
    #line 325 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bugzilla', 0]);
    $output .=  " Helper, use it.</p>\n\n    <p><b>Avoid cuteness if it costs clarity.</b> Nobody will be laughing\n    at your funny ";
    #line 328 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " title at 3:00 AM when they can't remember how \n    to find your ";
    #line 329 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  ".</p>\n\n    <p><b>One ";
    #line 331 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " per report.</b> Completely different people \n    typically fix, verify, and prioritize different ";
    #line 332 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  ". If you \n    mix a handful of ";
    #line 333 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  " into a single report, the right people \n    probably won't discover your ";
    #line 334 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  " in a timely fashion, or at \n    all. Certain ";
    #line 335 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  " are also more important than others. It's \n    impossible to prioritize ";
    #line 336 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'abug', 0]);
    $output .=  " report when\n    it contains four different issues, all of differing importance.</p>\n\n    <p><b>No ";
    #line 339 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " is too trivial to report.</b> Unless you're \n    reading the source code, you can't see actual software ";
    #line 340 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  ", \n    like a dangling pointer -- you'll see their visible manifestations, such \n    as the segfault when the application finally crashes. Severe software \n    problems can manifest themselves in superficially trivial ways. File them\n    anyway.<br>\n    </p>\n  </blockquote>\n\n  <p><b><a name=\"summary\"></a>2. How and Why to Write Good ";
    #line 348 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'Bug', 0]);
    $output .=  "\n  Summaries</b></p>\n\n  <blockquote>\n    <p><b>You want to make a good first impression on the ";
    #line 352 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  "\n    recipient.</b> Just like a New York Times headline guides readers\n    towards a relevant article from dozens of choices, will \n    your ";
    #line 355 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " summary suggest that your ";
    #line 355 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " report is \n    worth reading from dozens or hundreds of choices?</p>\n\n    <p>Conversely, a vague ";
    #line 358 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " summary like <tt>install \n    problem</tt> forces anyone reviewing installation ";
    #line 359 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  " to waste \n    time opening up your ";
    #line 360 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " to determine whether it matters.</p>\n\n    <p><b>Your ";
    #line 362 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " will often be searched by its summary.</b> Just \n    as you'd find web pages with Google by searching by keywords through \n    intuition, so will other people locate your ";
    #line 364 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bugs', 0]);
    $output .=  ". \n    Descriptive ";
    #line 365 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " summaries are\n    naturally keyword-rich, and easier to find.</p>\n\n    <p>For example, you'll find a ";
    #line 368 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " titled \"<tt>Dragging icons \n    from List View to gnome-terminal doesn't paste path</tt>\" if you search on\n    \"List\", \"terminal\", or \"path\". Those search keywords wouldn't have\n    found a ";
    #line 371 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " titled \"<tt>Dragging icons doesn't paste</tt>\".</p>\n\n    <p>Ask yourself, \"Would someone understand my ";
    #line 373 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " from just \n    this summary?\" If so, you've written a fine summary.</p>\n\n    <p><b>Don't write titles like these:</b></p>\n\n    <ol>\n      <li>\"Can't install\" - Why can't you install? What happens when you\n      try to install?</li>\n\n      <li>\"Severe Performance Problems\" - ...and they occur when you do\n      what?</li>\n\n      <li>\"back button does not work\" - Ever? At all?</li>\n    </ol>\n\n    <p><b>Good ";
    #line 388 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $stash->get(['terms', 0, 'bug', 0]);
    $output .=  " titles:</b></p>\n\n    <ol>\n      <li>\"1.0 upgrade installation fails if Mozilla M18 package present\" -\n      Explains problem and the context.</li>\n\n      <li>\"RPM 4 installer crashes if launched on Red Hat 6.2 (RPM 3)\n      system\" - Explains what happens, and the context.</li>\n    </ol>\n  </blockquote>\n</blockquote>\n";
    #line 401 "template\en\default\pages\bug-writing.html.tmpl"
    $output .=  $context->include('global/footer.html.tmpl');
    $output .=  "\n";
        } };
        if ($@) {
            $error = $context->catch($@, \$output);
            die $error unless $error->type eq 'return';
        }
    
        return $output;
    },
    DEFBLOCKS => {

    },
});