<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.2.106"> 
  <!ENTITY manversion "2.1.1">
  <!ENTITY date "2004 年 1 月" >
  <!ENTITY app "<application>Bug Buddy</application>" >
  <!ENTITY appname "Bug Buddy" >
  <!ENTITY ug "GNOME 桌面用户指南" >
]> <article id="index" lang="zh_cn">
  <articleinfo>
    <title>&appname; 手册 &manversion; 版 </title>

    <copyright><year>2004</year> <holder>Sun Microsystems</holder>  </copyright>

    <copyright><year>2002</year> <holder>Eric Baudais</holder>  </copyright>

    <copyright><year>2002</year> <holder>Kevin Conder</holder>  </copyright>

    <copyright><year>2001</year> <holder>Telsa Gwynne</holder>  </copyright><!-- translators: uncomment this:
    <copyright>
      <year>2003</year>
      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
 -->

 

    <publisher><publishername>GNOME Documentation Project</publishername>  </publisher>&legal;  <authorgroup>

      <author><firstname>Sun</firstname> <surname>GNOME Documentation Team</surname> <affiliation><orgname>Sun Microsystems</orgname> </affiliation>
      </author>

      <author><firstname>Eric</firstname> <surname>Baudais</surname>  <affiliation><orgname>GNOME Documentation Project</orgname> <address>baudais@kkpsi.org </address> </affiliation>
      </author>
	  
      <author><firstname>Kevin</firstname> <surname>Conder</surname>  <affiliation><orgname>GNOME Documentation Project</orgname> <address>kevin@kevindumpscore.com </address> </affiliation>
      </author>

      <author><firstname>Telsa</firstname> <surname>Gwynne</surname>  <affiliation><orgname>GNOME Documentation Project</orgname> <address>telsa@linuxchix.org </address> </affiliation>
      </author>
	  
    </authorgroup>

    <revhistory>

      <revision><revnumber>&appname; 手册 &manversion; 版</revnumber> <date>&date;</date> <revdescription>
          <para role="author">Sun GNOME Documentation Team</para>
          <para role="publisher">GNOME Documentation Project </para>
        </revdescription>
      </revision>

      <revision><revnumber>&appname; 手册 2.1 版</revnumber> <date>2002 年 5 月</date> <revdescription>
          <para role="author">Eric Baudais <email>baudais@kkpsi.org</email> </para>
          <para role="author">Kevin Conder <email>kevin@kevindumpscore.com</email> </para>
          <para role="publisher">GNOME Documentation Project </para>
        </revdescription>
      </revision>

      <revision><revnumber>&appname; 手册 2.0 版</revnumber> <date>2001 年 2 月</date> <revdescription>
          <para role="author">Telsa Gywnne <email>telsa@linuxchix.org</email> </para>
          <para role="publisher">GNOME Documentation Project </para>
        </revdescription>
      </revision>

    </revhistory><releaseinfo>本手册介绍 &appname; 的 &appversion; 版。</releaseinfo>  <legalnotice>
      <title>反馈 </title>
      <para>要报告关于 &appname; 应用程序或本手册的错误或提出建议，请遵循 <ulink url="ghelp:gnome-feedback" type="help">GNOME 反馈页</ulink>中的指导。  </para><!-- Translators may also add here feedback address for translations -->
                                                                                

                                                                                
    </legalnotice>

  </articleinfo><!-- ============= Document Body ============================= --><!-- ============= Introduction ============================== --><indexterm zone="index"> <primary>Bug Buddy</primary> </indexterm> <indexterm zone="index"> <primary>bug-buddy</primary> </indexterm> <indexterm zone="index"> <primary>错误报告工具</primary> </indexterm> <sect1 id="bug-buddy-intro">
    <title>简介 </title> 
    <para>&app; 助手可以引导您完成创建和提交错误报告的过程。 您创建的错误报告包含开发人员重现和修复该问题所需的所有信息。 </para>
  </sect1><!-- ============= Getting Started =========================== -->


  <sect1 id="bug-buddy-getting-started">
    <title>入门</title><!-- ============= To Start System Monitor ============================ -->
                                                                                

    <sect2 id="bug-buddy-to-start">
      <title>启动 &appname;</title>
      <para>可以通过以下方式启动 &app;： </para>
      <variablelist>
        <varlistentry><term>命令行</term>  <listitem>
            <para>执行以下命令： <command>bug-buddy</command>  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term>文件管理器窗口</term>  <listitem>
            <para>双击一个核心文件。  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term>崩溃对话框</term>  <listitem>
            <para>选择<guilabel>&ldquo;创建错误报告&rdquo;</guilabel>选项。 </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	
    <sect2 id="bug-buddy-when-you-start">
      <title>启动 &appname; 时 </title>	
      <para>在启动 &app; 时，系统会显示下面的窗口： </para>
      <figure id="bug-buddy-window"> 
        <title>&appname; 窗口</title>
        <screenshot> 
          <mediaobject> 
            <imageobject> 
              <imagedata fileref="figures/bug-buddy_window.png" format="PNG"/>
            </imageobject>
            <textobject> <phrase>显示 Bug Buddy 窗口。
 </phrase>
            </textobject> 
          </mediaobject>
        </screenshot>
      </figure>
      <para>&app; 窗口会显示一些页面，您可以在其中输入错误报告信息。 第一页显示欢迎使用消息。  </para>
      <para>&app; 窗口包含下列按钮：  </para>
      <variablelist> 
        <varlistentry><term><guibutton>关于</guibutton></term>  <listitem> 
            <para>显示<guilabel>&ldquo;关于 &appname;&rdquo;</guilabel>对话框，其中包含 &app; 版本信息、版权信息和开发人员信息。  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term><guibutton>取消</guibutton></term>  <listitem> 
            <para>显示确认警告：  </para>
            <itemizedlist>
              <listitem> 
                <para>单击<guibutton>&ldquo;否&rdquo;</guibutton>返回到当前错误报告。  </para>
              </listitem> 
              <listitem> 
                <para>单击<guibutton>&ldquo;是&rdquo;</guibutton>取消当前的错误报告，并退出 &app;。  </para>
              </listitem> 
            </itemizedlist>
          </listitem>
        </varlistentry>
        <varlistentry><term><guibutton>后退</guibutton></term>  <listitem> 
            <para>显示上一 &app; 页面。  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term><guibutton>前进</guibutton></term>  <listitem> 
            <para>显示下一 &app; 页面。 </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1><!-- ================ Usage ================================ --><!-- This section should describe basic usage of the application. -->


 
 

  <sect1 id="bug-buddy-usage">
    <title>用法 </title>
    <para>要创建和提交错误报告，请执行下列任务：  </para>
    <orderedlist>
      <listitem>
        <para><link linkend="bug-buddy-debug">设置调试选项</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-description">输入错误说明</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-mail-config">输入邮件配置信息</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-confirmation">确认错误报告详细信息</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-submit">提交错误报告</link> </para>
      </listitem>
    </orderedlist>
                                                                                
    <sect2 id="bug-buddy-debug">
      <title>设置调试选项</title>

      <sect3 id="bug-buddy-debug-show">
        <title>显示或隐藏调试选项 </title>
        <para>要显示调试选项，请单击<guilabel>&ldquo;欢迎使用 &appname;&rdquo;</guilabel>页面上的<guibutton>&ldquo;显示调试选项&rdquo;</guibutton>按钮。  </para>
        <para>要隐藏调试选项，请单击<guilabel>&ldquo;欢迎使用 &appname;&rdquo;</guilabel>页面上的<guibutton>&ldquo;隐藏调试选项&rdquo;</guibutton>按钮。 </para>
      </sect3>
                                                                                
      <sect3 id="bug-buddy-debug-none">
        <title>从错误报告中删除调试信息 </title>
        <para>&app; 会自动将如下类型的调试信息添加到错误报告：  </para>
        <variablelist>
          <varlistentry><term>核心文件</term>  <listitem>
              <para>核心文件包含存储在计算机核心内存中的数据的副本。  </para>
            </listitem>
          </varlistentry>
          <varlistentry><term>回溯</term>  <listitem>
              <para>回溯包含一个文本说明，其中详细描述了某个应用程序调用的函数的当前分层结构。  </para>
            </listitem>
          </varlistentry>
        </variablelist>
        <para>如果不想在错误报告中附加任何调试信息，请从<guilabel>&ldquo;调试&rdquo;</guilabel>下拉列表中选择<guilabel>&ldquo;不附加信息&rdquo;</guilabel>。 </para>
      </sect3>

      <sect3 id="bug-buddy-debug-core">
        <title>将核心文件附加到错误报告中 </title>
        <para>要手动将核心文件附加到错误报告中，请执行下列步骤：  </para>
        <orderedlist>
          <listitem>
            <para>从<guilabel>&ldquo;调试&rdquo;</guilabel>下拉列表中选择<guilabel>&ldquo;核心文件&rdquo;</guilabel>。  </para>
          </listitem>
          <listitem>
            <para>在<guilabel>&ldquo;核心文件&rdquo;</guilabel>字段中输入核心文件的名称。 或者，要浏览找到该核心文件，请单击<guibutton>&ldquo;浏览&rdquo;</guibutton>。  </para>
          </listitem>
          <listitem>
            <para>单击<guibutton>&ldquo;开始&rdquo;</guibutton>按钮调试指定的核心文件。  </para>
            <para>要取消调试过程，请单击<guibutton>&ldquo;停止&rdquo;</guibutton>按钮。 </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="bug-buddy-debug-backtrace">
        <title>将回溯附加到错误报告中 </title>
        <para>要手动将崩溃的应用程序的回溯附加到错误报告中，请执行下列步骤：  </para>
        <orderedlist>
          <listitem>
            <para>从<guilabel>&ldquo;调试&rdquo;</guilabel>下拉列表中选择<guilabel>&ldquo;崩溃的应用程序&rdquo;</guilabel>。  </para>
          </listitem>
          <listitem>
            <para>在<guilabel>&ldquo;二进制文件&rdquo;</guilabel>字段中输入应用程序二进制文件的名称。 或者，要浏览找到应用程序二进制文件，请单击<guibutton>&ldquo;浏览&rdquo;</guibutton>。  </para>
            <para>应用程序二进制文件的名称与在命令行中启动该应用程序时输入的命令相同。  </para>
          </listitem>
          <listitem>
            <para>在<guilabel>&ldquo;进程 ID&rdquo;</guilabel>字段中输入进程标识符 (PID)。 可以使用<application>系统监视器</application>应用程序确定进程标识符。  </para>
          </listitem>
          <listitem>
            <para>单击<guibutton>&ldquo;开始&rdquo;</guibutton>按钮调试指定的二进制文件。  </para>
            <para>要取消调试过程，请单击<guibutton>&ldquo;停止&rdquo;</guibutton>按钮。 </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="bug-buddy-debug-copy">
        <title>将调试信息复制到剪贴板 </title>
        <para>要将调试信息复制到剪贴板，请单击<guibutton>&ldquo;复制&rdquo;</guibutton>。 </para>
      </sect3>

      <sect3 id="bug-buddy-debug-save">
        <title>将调试信息保存到文件 </title>
        <para>要将调试信息保存到文件中，请单击<guibutton>&ldquo;保存&rdquo;</guibutton>。 </para>
      </sect3>

  </sect2>
  
  <sect2 id="bug-buddy-description">
    <title>输入错误说明 </title>
    <para>要显示<guilabel>&ldquo;错误说明&rdquo;</guilabel>页面，请单击<guilabel>&ldquo;欢迎使用 &appname;&rdquo;</guilabel>页面上的<guibutton>&ldquo;前进&rdquo;</guibutton>。  </para>
    <para>在<guilabel>&ldquo;错误说明&rdquo;</guilabel>页面上输入下列信息：  </para>
    <variablelist>
      <varlistentry><term><guilabel>概要</guilabel></term>  <listitem>
          <para>输入一个清楚而且简练地说明该问题的简短句子。 <guilabel>&ldquo;概要&rdquo;</guilabel>文本会复制到错误报告电子邮件的<quote>&ldquo;主题&rdquo;</quote>标题中。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>问题说明</guilabel></term>  <listitem>
          <para>输入该问题的说明。 包括任何错误消息或警告。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>重现问题的步骤</guilabel></term>  <listitem>
          <para>使用简短的句子介绍产生该错误的详细准确的步骤说明。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>实际结果</guilabel></term>  <listitem>
          <para>介绍在执行<guilabel>&ldquo;重现问题的步骤&rdquo;</guilabel>中列出的操作时发生的情况。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>期望的结果</guilabel></term>  <listitem>
          <para>介绍在执行<guilabel>&ldquo;重现问题的步骤&rdquo;</guilabel>中列出的操作时期望发生的情况。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>此问题发生的频率</guilabel></term>  <listitem>
          <para>介绍在执行<guilabel>&ldquo;重现问题的步骤&rdquo;</guilabel>中列出的操作时发生该问题的频率。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>其他信息</guilabel></term>  <listitem>
          <para>提供可能对开发人员有用的任何其他信息。 例如：  </para>
          <itemizedlist>
            <listitem>
              <para>任何错误消息的准确副本  </para>
            </listitem>
            <listitem>
              <para>您的窗口管理器的名称和版本号  </para>
            </listitem>
            <listitem>
              <para>其他可以执行必需操作而不会导致该错误的方法  </para>
            </listitem>
              <listitem>
              <para>相关屏幕快照的参考（如果有的话）  </para>
              <para>请不要将屏幕快照附加到 &app; 报告中。 如果必要，开发人员可以直接与您联系以获得屏幕快照。  </para>
            </listitem>
            <listitem>
              <para>没有正确载入或者根本就没有载入的任何文件  </para>
            </listitem>
            <listitem>
              <para>有关导致该问题的原因或者如何修复该问题的任何建议 </para>
            </listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
  
  <sect2 id="bug-buddy-mail-config">
    <title>输入邮件配置信息 </title>
    <para>要显示<guilabel>&ldquo;邮件配置&rdquo;</guilabel>页面，请单击<guilabel>&ldquo;错误说明&rdquo;</guilabel>页面上的<guibutton>&ldquo;前进&rdquo;</guibutton>。  </para>
    <para>在<guilabel>&ldquo;邮件配置&rdquo;</guilabel>页面上输入下列信息：  </para>
    <variablelist>
      <varlistentry><term><guilabel>姓名</guilabel></term>  <listitem>
          <para>输入您的全名。  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>电子邮件</guilabel></term>  <listitem>
          <para>输入您的电子邮件地址。  </para>
          <para>这些信息可以使开发人员联系到您，以请求获得更多信息或关于该问题解决方案的信息。 </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
  
  <sect2 id="bug-buddy-confirmation">
    <title>确认错误报告详细信息 </title>
    <para>要显示<guilabel>&ldquo;确认&rdquo;</guilabel>页面，请单击<guilabel>&ldquo;邮件配置&rdquo;</guilabel>页面上的<guibutton>&ldquo;前进&rdquo;</guibutton>。  </para>
    <para>&app; 会显示错误报告详细信息。 如果要更改任何详细信息，可以在此页面上进行。 </para>
  </sect2>
  
  <sect2 id="bug-buddy-submit">
    <title>提交错误报告 </title>
    <para>要提交错误报告，请单击<guilabel>&ldquo;确认&rdquo;</guilabel>页面上的<guibutton>&ldquo;发送报告&rdquo;</guibutton>按钮。 系统会显示一条确认警告。 单击<guibutton>&ldquo;提交&rdquo;</guibutton>确认您要提交错误报告。  </para>
    <para>&app; 会显示<guilabel>&ldquo;已完成&rdquo;</guilabel>页面，表明错误报告已经提交。 单击<guibutton>&ldquo;关闭&rdquo;</guibutton>关闭 &app; 窗口。 </para>
  </sect2>
  
</sect1>
</article>