Differenze tra le versioni 1 e 2

Introduzione (work in progress)

Ciò che genericamente chiamiamo Evolution, è di fatto una collezioni di file binari e pacchetti sorgente:

1. Evolution Data Server

evolution-data-server	backend del server evolution database
evolution-data-server-common	file non dipendenti dall'architettura di sistema per Evolution Data Server
evolution-data-server-dbg	backend del server evolution database con simboli di debugging
evolution-data-server-dev	file in sviluppo di evolution-data-server (meta pacchetto)
libcamel<version>	La libreria della gestione messaggi MIME
libcamel<version>-dev	file in sviluppo di libcamel
libebook<version>	libreria client per l'agenda indirizzi di Evolution
libebook<version>-dev	libreria client per l'agenda indirizzi di Evolution (file in sviluppo)
libecal<version>	libreria client per i calendari di Evolution
libecal<version>-dev	libreria client per i calendari di Evolution (file in sviluppo)
libedata-book<version>	libreria backend per l'agenda indirizzi di Evolution
libedata-book<version>-dev	libreria backend per l'agenda indirizzi di Evolution (file in sviluppo)
libedata-cal<version>	libreria backend per calendari di Evolution
libedata-cal<version>-dev	libreria backend per calendari di Evolution (file in sviluppo)
libedataserver<version>	libreria di utilità per evolution data servers
libedataserver<version>-dev	libreria di utilità per evolution data servers (file in sviluppo)
libedataserverui<version>	libreria di utilità GUI per evolution data servers
libedataserverui<version>-dev	libreria di utilità GUI per evolution data servers (file in sviluppo)
libegroupwise<version>	libreria client per accedere da un POA groupwise attraverso un interfaccia SOAP
libegroupwise<version>-dev	file in sviluppo di libegroupwise
libexchange-storage<version>	libreria backend dei calendari Evolution
libexchange-storage<version>-dev	libreria backend dei calendari Evolution (file in sviluppo)

I componenti Evolution-data-server vengono utilizzati anche da altri programmi all'interno di Gnome. Come risultato abbiamo che alcuni dei pacchetti posono essere installati anche se Evolution non è installato.

2. Evolution

evolution	suite groupware con client di posta eletttronica ed organizer
evolution-common	file non dipendenti dall'architettura di sistema per Evolution
evolution-dbg	simboli di debugging per Evolution
evolution-dev	file libreria in sviluppo per Evolution
evolution-plugins	plugins standard per Evolution
evolution-plugins-experimental	plugin sperimentali per Evolution

Questa è l'interfaccia attuale per email, calendari, compiti, contatti e memo.

3. Evolution Exchange
- evolution-exchange
  
  plugin exchange per la suite groupeware Evolution

Evolution-Exchange si occupa esclusivamente di interfacciarsi con i server Exchange viadeals exclusively with interfacing with Exchange servers via Outlook Web Access (OWA).

In aggiunta, Evolution utilizza libgtkhtml3.14 per email in formato html (sia visualizzazione che stampa), libpango per la visualizzazione di filePDF ecc. Ovviamente Evolution dipende anche da altri pacchetti.

La differenza tra un bug ed una richiesta di supporto

In breve: i bug sono problemi nel prodotto, le richieste di supporto sono altri problemi. Per esempio se Evolution crasha il problema è molto probabilmente un bug del prodotto, ma potrebbe anche risiedere altrove, ad esempio in libgtkhtml.

L'errore "connection to POP server times out" è una richiesta di supporto, ed è probabilmente dovuto ad una non corretta configurazione e la soluzione deve essere trovata via Supporto.

Come segnalare un problema

I bug devono essere segnalati contro il corretto pacchetto, es. un bug in libcamel deve essere segnalato come affettante il pacchetto evolution-data-server e non il pacchetto evolution. Se però non si è sicuri, ma è un bug in Evolution, segnalare comunque il bug contro un qualsiasi pacchetto, eventualmente qualcun'altro si occuperà di riassegnare il bug al giusto pacchetto.

L'essenziale per poter lavorare sul bug è avere una buona descrizione del problema e la necessaria documentazione allegata (vedi più avanti per i dettagli).

Innanzitutto: cercare di capire cosa è sbagliato. I bug sono solitamente in:

Interfaccia utente - richiede una dettagliata descrizione del problema, i passi da compiere per riprodurre l'errore e quando appropriato uno screenshoot dello schermo. Vedi ad esempio il bug 12430.
Program crash - Log files from the crash incident are required to track down these. Almost always, this will require the reporter to file in a nice backtrace (since most of the times we cannot reproduce it :-(). For example, see bug 106504. if Apport is installed and enabled, a crash report will be generated under /var/crash, and you will be prompted to open a bug on launchpad; in this case, internal processing will generate the backtrace we need.
Incorrect results - for example, connection errors, deleted emails are not deleted, etc. We also need a detailed description of the issue, the steps to reproduce, and screen captures where appropriate. For example (and to keep with time issues) bug 67955.
Wishlists - a product feature that is either absent, or should be modified to suit the reporter's view of usability. Please explain why you think your proposal would improve overall user experience.
Package selection - Help to find, and assign, the right package. For example, a bug originally filed under Evolution dealing with POP access is really a Evolution-Data-Server bug.

Verify if you can reproduce the issue. If you can, try to describe in details all steps you needed to go through to have the issue. If this is a program crash, make sure you have all necessary debugging symbols packages installed -- see DebuggingProgramCrash for the necessary changes to the repositories lists. What symbols packages to install... varies with the problem. Obviously, the Evolution* ones should be in, but what others will depend on the specific issue. You might need libgtkhtml3.14 if the crash happens while rendering a HTML email, for example.

If you cannot reproduce the issue you will have to ask the reporter to do it.

Once you have collected all data you believe is needed... its time to check upstream and either create a new bug report upstream, or find an existing one that matches the issue. In either case, please add a comment linking back to the Ubuntu bug. Then, please add a tracker entry on the Ubuntu bug (via the "Also affects package" link on the left of the bug report), so that we can find the related upstream report.

Per an upstream request -- when forwarding bugs to bugzilla, please assign the product as Evolution, and the Component as "BugBuddyBugs". Upstream triaging will later assign the correct product component as needed. If the issue is well defined, and all required data has been collected, upstream has agreed that Ubuntu can then assign the correct Component.

Debug message from Evolution

For information on how to get debug messages out of Evolution see: http://projects.gnome.org/evolution/bugs.shtml

Also see

DebuggingProcedures for generic debugging on Ubuntu, and specially
DebuggingProgramCrash on how to setup your machine to get a meaningful backtrace
A Quick Guide to Evolution Bug Hunting on the upstream suggestions
the Evolution Wiki for details on what is going on, and documentation on the internals
Gnome bug tracking system

CategoryBugSquad CategoryDebugging

-  ⇤ ← Versione 1 del 22/05/2011 11.44.01 → 
  Dimensione: 8406
  Autore: FabioMarconi
  Commento:
+   ← Versione 2 del 22/05/2011 15.28.22 → ⇥
  Dimensione: 8576
  Autore: FabioMarconi
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 8:
-       || evolution-data-server||evolution database backend server||
       ||evolution-data-server-common||file non dipendenti dall'architettura sdi sistema per Evolution Data Server||
+       ||evolution-data-server||backend del server evolution database||
       ||evolution-data-server-common||file non dipendenti dall'architettura di sistema per Evolution Data Server||
 Linea 34:
-       ||evolution||groupware suite with mail client and organizer||
       ||evolution-common||architecture independent files for Evolution||
       ||evolution-dbg||debugging symbols for Evolution||
       ||evolution-dev||development library files for Evolution||
       ||evolution-plugins||standard plugins for Evolution||
       ||evolution-plugins-experimental||experimental plugins for Evolution||
+       ||evolution||suite groupware con client di posta eletttronica ed organizer||
       ||evolution-common||file non dipendenti dall'architettura di sistema per Evolution||
       ||evolution-dbg||simboli di debugging per Evolution||
       ||evolution-dev||file libreria in sviluppo per Evolution||
       ||evolution-plugins||plugins standard per Evolution||
       ||evolution-plugins-experimental||plugin sperimentali per Evolution||
 Linea 41:
-This is the actual user interface to email, calendar, tasks, contacts and memos.
+Questa è l'interfaccia attuale per email, calendari, compiti, contatti e memo.
 Linea 44:
-       || evolution-exchange||Exchange plugin for the Evolution groupware suite||
+       || evolution-exchange||plugin exchange per la suite groupeware Evolution||
 Linea 46:
-Evolution-Exchange deals exclusively with interfacing with Exchange servers via the Outlook Web Access (OWA).
+Evolution-Exchange si occupa esclusivamente di interfacciarsi con i server Exchange viadeals exclusively with interfacing with Exchange servers via Outlook Web Access (OWA).
 Linea 48:
-Additionally, Evolution uses libgtkhtml3.14 to format HTML email (either for viewing or printing), libpango for PDF rendering, etc. There are many other packages that Evolution depends on, of course.
+In aggiunta, Evolution utilizza libgtkhtml3.14 per email in formato html (sia visualizzazione che stampa), libpango per la visualizzazione di filePDF ecc. Ovviamente Evolution dipende anche da altri pacchetti.
 Linea 50:
-= The difference between a bug and a support request =
+= La differenza tra un bug ed una richiesta di supporto =
 Linea 52:
-Simply: bugs are product issues, support requests are user issues. For example, an Evolution crash is most probably a product issue (and, as such, a bug), perhaps not in one of the Evolution components -- the crash might be, for example, in libgtkhtml.
+In breve: i bug sono problemi nel prodotto, le richieste di supporto sono altri problemi. Per esempio se Evolution crasha il problema è molto probabilmente un bug del prodotto, ma potrebbe anche risiedere altrove, ad esempio in libgtkhtml.
 Linea 54:
-But "connection to POP server times out" is a support request: this is probably a configuration issue and, as such, resolution should be pursued via [[https://answers.launchpad.net|Support]].
+L'errore "connection to POP server times out" è una richiesta di supporto, ed è probabilmente dovuto ad una non corretta configurazione e la soluzione deve essere trovata via [[https://answers.launchpad.net|Supporto]].
 Linea 56:
-= How to file =
+= Come segnalare un problema =
 Linea 58:
-Bugs should be filled under the correct package -- so, for example, if you find a bug on libcamel, the correct package is Evolution-Data-Server, not Evolution. Nevertheless, if you are unsure -- but it is an Evolution* bug --, file it under any of the Evolution packages; we will, eventually, find the correct package and reassign the bug as needed (and even reassign it out of Evolution, if the Evolution error is a consequence of some other package).
+I bug devono essere segnalati contro il corretto pacchetto, es. un bug in libcamel deve essere segnalato come affettante il pacchetto evolution-data-server e non il pacchetto evolution. Se però non si è sicuri, ma è un bug in Evolution, segnalare comunque il bug contro un qualsiasi pacchetto, eventualmente qualcun'altro si occuperà di riassegnare il bug al giusto pacchetto.
 Linea 60:
-No matter what, we do need to have a good description of the issue, and supporting documentation (see below for details).
+L'essenziale per poter lavorare sul bug è avere una buona descrizione del problema e la necessaria documentazione allegata (vedi più avanti per i dettagli).
 Linea 62:
-First of all: try to identify what is wrong. We usually have bugs on:
 1. User interface - requires a detailed description of the issue, steps to reproduce and screen captures where appropriate. For example, [[https://bugs.launchpad.net/ubuntu/+source/evolution-data-server/+bug/12430|bug 12430]].
+Innanzitutto: cercare di capire cosa è sbagliato. I bug sono solitamente in:
 1. Interfaccia utente - richiede una dettagliata descrizione del problema, i passi da compiere per riprodurre l'errore e quando appropriato uno screenshoot dello schermo. Vedi ad esempio il [[https://bugs.launchpad.net/ubuntu/+source/evolution-data-server/+bug/12430|bug 12430]].