<?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 "Gennaio 2004" >
  <!ENTITY app "<application>Bug Buddy</application>" >
  <!ENTITY appname "Bug Buddy" >
  <!ENTITY ug "Manuale utente del desktop GNOME" >
]>
 <article id="index" lang="it">
  <articleinfo>
    <title>Manuale di &appname; V&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><email>baudais@kkpsi.org</email></address>  </affiliation>
      </author>
	  
      <author><firstname>Kevin</firstname> <surname>Conder</surname>  <affiliation><orgname>GNOME Documentation Project</orgname> <address><email>kevin@kevindumpscore.com</email></address>  </affiliation>
      </author>

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

    <revhistory>

      <revision><revnumber>Manuale di &appname; V&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>Manuale di &appname; V2.1</revnumber> <date>Maggio 2002</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>Manuale di &appname; V2.0</revnumber> <date>Febbraio 2001</date> <revdescription>
          <para role="author">Telsa Gywnne <email>telsa@linuxchix.org</email> </para>
          <para role="publisher">GNOME Documentation Project </para>
        </revdescription>
      </revision>

    </revhistory><releaseinfo> Questo manuale descrive la versione &appversion; di &appname;.</releaseinfo>  <legalnotice>
      <title>Commenti </title>
      <para>Per segnalare un problema o inviare suggerimenti sull'applicazione &appname; o su questo manuale, seguire le istruzioni presenti alla <ulink url="ghelp:gnome-feedback" type="help">Pagina di commenti su 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>Strumento per la notifica degli errori</primary>
  </indexterm> <sect1 id="bug-buddy-intro">
    <title>Introduzione </title> 
    <para>La procedura guidata di &app; spiega in dettaglio come creare e inviare una notifica di errore. La notifica di errore deve contenere tutte le informazioni necessarie per riprodurre e correggere il problema. </para>
  </sect1><!-- ============= Getting Started =========================== -->


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

    <sect2 id="bug-buddy-to-start">
      <title>Avviare &appname;</title>
      <para>Per avviare &app; sono disponibili i seguenti metodi: </para>
      <variablelist>
        <varlistentry><term>Riga di comando</term>  <listitem>
            <para>Eseguire il comando seguente: <command>bug-buddy</command>  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term>Finestra del File manager</term>  <listitem>
            <para>Fare doppio clic su un file core.  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term>Finestra di dialogo del crash</term>  <listitem>
            <para>Selezionare l'opzione <guilabel>Crea una nuova notifica d'errore</guilabel>. </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	
    <sect2 id="bug-buddy-when-you-start">
      <title>Avvio di &appname; </title>	
      <para>All'avvio di &app; viene visualizzata la finestra seguente. </para>
      <figure id="bug-buddy-window"> 
        <title>Finestra di &appname; </title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/bug-buddy_window.png" format="PNG"/>  </imageobject>
            <textobject><phrase>Mostra la finestra di Bug Buddy.</phrase>  </textobject> 
          </mediaobject>
        </screenshot>
      </figure>
      <para>La finestra di &app; presenta alcune pagine in cui &egrave; possibile inserire le informazioni sull'errore. La prima pagina contiene un messaggio di benvenuto.  </para>
      <para>La finestra di &app; contiene i seguenti pulsanti:  </para>
      <variablelist> 
        <varlistentry><term><guibutton>Informazioni</guibutton></term>  <listitem> 
            <para>Mostra la finestra di dialogo <guilabel>Informazioni su &appname;</guilabel>, che contiene il numero di versione, l'informativa di copyright e i nomi degli sviluppatori di &app;.  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term><guibutton>Annulla</guibutton></term>  <listitem> 
            <para>Mostra una richiesta di conferma:  </para>
            <itemizedlist>
              <listitem> 
                <para>Fare clic su <guibutton>No</guibutton> per tornare alla notifica d'errore.  </para>
              </listitem> 
              <listitem> 
                <para>Fare clic su <guibutton>S&igrave;</guibutton> per annullare la notifica d'errore e uscire da &app;.  </para>
              </listitem> 
            </itemizedlist>
          </listitem>
        </varlistentry>
        <varlistentry><term><guibutton>Indietro</guibutton></term>  <listitem> 
            <para>Mostra la pagina precedente di &app;.  </para>
          </listitem>
        </varlistentry>
        <varlistentry><term><guibutton>Avanti</guibutton></term>  <listitem> 
            <para>Mostra la pagina successiva di &app;. </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1><!-- ================ Usage ================================ --><!-- This section should describe basic usage of the application. -->


 
 

  <sect1 id="bug-buddy-usage">
    <title>Uso </title>
    <para>Per creare e inviare una notifica d'errore, procedere come segue:  </para>
    <orderedlist>
      <listitem>
        <para><link linkend="bug-buddy-debug">Impostare le opzioni di debug</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-description">Inserire la descrizione dell'errore</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-mail-config">Inserire le informazioni di configurazione della posta</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-confirmation">Confermare il contenuto della notifica d'errore</link>  </para>
      </listitem>
      <listitem>
        <para><link linkend="bug-buddy-submit">Inviare la notifica d'errore</link> </para>
      </listitem>
    </orderedlist>
                                                                                
    <sect2 id="bug-buddy-debug">
      <title>Impostare le opzioni di debug</title>

      <sect3 id="bug-buddy-debug-show">
        <title>Mostrare o nascondere le opzioni di debug </title>
        <para>Per visualizzare le opzioni di debug, fare clic sul pulsante <guibutton>Mostra informazioni di debug</guibutton> nella pagina <guilabel>Benvenuto in &appname;</guilabel>.  </para>
        <para>Per nascondere le opzioni di debug, fare clic sul pulsante <guibutton>Nascondi informazioni di debug</guibutton> nella pagina <guilabel>Benvenuto in &appname;</guilabel>. </para>
      </sect3>
                                                                                
      <sect3 id="bug-buddy-debug-none">
        <title>Rimuovere informazioni di debug dalla notifica d'errore </title>
        <para>&app; aggiunge automaticamente i seguenti tipi di informazioni di debug alla notifica d'errore:  </para>
        <variablelist>
          <varlistentry><term>file core</term>  <listitem>
              <para>Il file core contiene una copia dei dati memorizzati nella memoria interna del computer.  </para>
            </listitem>
          </varlistentry>
          <varlistentry><term>backtrace</term>  <listitem>
              <para>Il backtrace contiene una rappresentazione dettagliata in formato testo della gerarchia di funzioni chiamate da un'applicazione.  </para>
            </listitem>
          </varlistentry>
        </variablelist>
        <para>Se non si intende inserire queste informazioni di debug nella notifica d'errore, selezionare <guilabel>niente</guilabel> nella casella di riepilogo <guilabel>Debug</guilabel>. </para>
      </sect3>

      <sect3 id="bug-buddy-debug-core">
        <title>Allegare un file core alla notifica d'errore </title>
        <para>Per allegare manualmente un file core alla notifica d'errore, procedere come segue:  </para>
        <orderedlist>
          <listitem>
            <para>Selezionare <guilabel>File core</guilabel> nella casella di riepilogo <guilabel>Debug</guilabel>.  </para>
          </listitem>
          <listitem>
            <para>Inserire il nome del file core nel campo corrispondente. In alternativa, per ricercare il file core, fare clic su <guibutton>Sfoglia</guibutton>.  </para>
          </listitem>
          <listitem>
            <para>Fare clic sul pulsante <guibutton>Avvia</guibutton> per eseguire il debug del file core specificato.  </para>
            <para>Per annullare il processo di debug, fare clic sul pulsante <guibutton>Stop</guibutton>. </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="bug-buddy-debug-backtrace">
        <title>Allegare un backtrace alla notifica d'errore </title>
        <para>Per allegare manualmente alla notifica d'errore un backtrace per l'applicazione interrotta, procedere come segue:  </para>
        <orderedlist>
          <listitem>
            <para>Selezionare <guilabel>applicazione che &egrave; andata in crash</guilabel> nella casella di riepilogo <guilabel>Debug</guilabel>.  </para>
          </listitem>
          <listitem>
            <para>Inserire il nome del file binario dell'applicazione nel campo <guilabel>File binario</guilabel>. In alternativa, per ricercare il file binario dell'applicazione, fare clic su <guibutton>Sfoglia</guibutton>.  </para>
            <para>Il nome del file binario corrisponde al comando da digitare sulla riga di comando per avviare l'applicazione.  </para>
          </listitem>
          <listitem>
            <para>Inserire l'identificativo del processo (pid) nel campo <guilabel>ID del processo</guilabel>. Per conoscere l'identificativo del processo &egrave; possibile usare l'applicazione <application>Monitor di sistema</application>.  </para>
          </listitem>
          <listitem>
            <para>Fare clic sul pulsante <guibutton>Avvia</guibutton> per iniziare il debug del file binario specificato.  </para>
            <para>Per annullare il processo di debug, fare clic sul pulsante <guibutton>Stop</guibutton>. </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="bug-buddy-debug-copy">
        <title>Copiare le informazioni di debug negli appunti </title>
        <para>Per copiare le informazioni di debug negli appunti, fare clic su <guibutton>Copia</guibutton>. </para>
      </sect3>

      <sect3 id="bug-buddy-debug-save">
        <title>Salvare le informazioni di debug in un file </title>
        <para>Per salvare le informazioni di debug in un file, fare clic su <guibutton>Salva</guibutton>. </para>
      </sect3>

  </sect2>
  
  <sect2 id="bug-buddy-description">
    <title>Inserire la descrizione dell'errore </title>
    <para>Per visualizzare la pagina <guilabel>Descrizione dell'errore</guilabel>, fare clic su <guibutton>Avanti</guibutton> nella pagina di benvenuto.  </para>
    <para>Nella pagina <guilabel>Descrizione dell'errore</guilabel>, inserire le seguenti informazioni:  </para>
    <variablelist>
      <varlistentry><term><guilabel>Summary</guilabel></term>  <listitem>
          <para>Inserire una descrizione sintetica del problema. Il testo di questo campo viene copiato nell'intestazione <quote>Oggetto</quote> della notifica d'errore inviata.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>Description of Problem</guilabel></term>  <listitem>
          <para>Inserire una descrizione del problema. Includere anche gli eventuali avvertimenti o messaggi di errore.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>Steps to reproduce the problem</guilabel></term>  <listitem>
          <para>Usando una forma concisa, inserire l'esatta descrizione delle operazioni eseguite per produrre l'errore.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>Actual Results</guilabel></term>  <listitem>
          <para>Descrivere ci&ograve; che accade quando si eseguono le operazioni indicate nella sezione che indica come riprodurre il problema.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>Expected Results</guilabel></term>  <listitem>
          <para>Descrivere ci&ograve; che dovrebbe accadere quando si eseguono le operazioni indicate nella sezione che indica come riprodurre il problema.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>How often does this happen</guilabel></term>  <listitem>
          <para>Indicare la frequenza con cui il problema si verifica dopo aver eseguito le operazioni descritte.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>Additional Information</guilabel></term>  <listitem>
          <para>Inserire eventuali informazioni aggiuntive che possano essere utili agli sviluppatori. Ad esempio:  </para>
          <itemizedlist>
            <listitem>
              <para>Una copia esatta dei messaggi di errore  </para>
            </listitem>
            <listitem>
              <para>Il nome e il numero di versione del gestore di finestre  </para>
            </listitem>
            <listitem>
              <para>Metodi alternativi per eseguire l'operazione richiesta senza generare lo stesso errore  </para>
            </listitem>
              <listitem>
              <para>Un riferimento a un'immagine rilevante, se disponibile  </para>
              <para>Non allegare direttamente le immagini alle notifiche di &app;. Se necessario, gli sviluppatori potranno contattare direttamente l'utente per richiedere un'immagine che descriva il problema.  </para>
            </listitem>
            <listitem>
              <para>I file che non vengono caricati o che non vengono caricati correttamente  </para>
            </listitem>
            <listitem>
              <para>Eventuali suggerimenti sulle possibili cause del problema o sulle possibili soluzioni </para>
            </listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
  
  <sect2 id="bug-buddy-mail-config">
    <title>Inserire informazioni di configurazione della posta </title>
    <para>Per visualizzare la pagina <guilabel>Configurazione della posta</guilabel>, fare clic su <guibutton>Avanti</guibutton> nella pagina <guilabel>Descrizione dell'errore</guilabel>.  </para>
    <para>Nella pagina <guilabel>Configurazione della posta</guilabel>, inserire le seguenti informazioni:  </para>
    <variablelist>
      <varlistentry><term><guilabel>Nome</guilabel></term>  <listitem>
          <para>Inserire il proprio nome e cognome.  </para>
        </listitem>
      </varlistentry>
      <varlistentry><term><guilabel>Indirizzo email</guilabel></term>  <listitem>
          <para>Inserire il proprio indirizzo di posta elettronica.  </para>
          <para>Questo consentir&agrave; agli sviluppatori di contattare l'utente per richiedere ulteriori informazioni o per comunicare una possibile soluzione del problema. </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
  
  <sect2 id="bug-buddy-confirmation">
    <title>Confermare le informazioni della notifica d'errore </title>
    <para>Per visualizzare la pagina <guilabel>Conferma</guilabel>, fare clic su <guibutton>Avanti</guibutton> nella pagina <guilabel>Configurazione della posta</guilabel>.  </para>
    <para>&app; mostra il contenuto della notifica d'errore. In questa pagina &egrave; possibile apportare eventuali modifiche alle informazioni inserite. </para>
  </sect2>
  
  <sect2 id="bug-buddy-submit">
    <title>Inviare la notifica d'errore </title>
    <para>Per inviare la notifica d'errore, fare clic sul pulsante <guibutton>Invia notifica</guibutton> nella pagina <guilabel>Conferma</guilabel>. Viene visualizzata una richiesta di conferma. Fare clic su <guibutton>Invia</guibutton> per confermare l'invio della notifica.  </para>
    <para>&app; mostra la pagina <guilabel>Finito</guilabel>, per indicare che la notifica d'errore &egrave; stata inviata. Fare clic su <guibutton>Chiudi</guibutton> per chiudere la finestra di &app;. </para>
  </sect2>
  
</sect1>
</article>