#use wml::debian::template title="Debian BTS — informazioni per lo sviluppatore" NOHEADER=yes NOCOPYRIGHT=true #include "$(ENGLISHDIR)/Bugs/pkgreport-opts.inc" #use wml::debian::translation-check translation="40a57e26c62893be7c80d82f1772999f68d51179" maintainer="Francesca Ciceri"
La segnalazione del bug può essere fatta da un qualsiasi utente
con un normale messaggio di posta elettronica a
submit@bugs.debian.org
contenente nel corpo del messaggio
una riga Package
(per maggiori informazioni consultare
Segnalazione di bug).
Successivamente alla segnalazione verrà associato un numero, verrà
inviata una risposta all'utente che ha fatto la segnalazione e infine
verrà inoltrato a debian-bugs-dist
. Se nella riga
Package
è indicato un pacchetto con un manutentore allora
anch'egli riceverà una copia del messaggio.
La linea Subject
avrà in aggiunta
Bug#
nnn:
, e la
Reply-To
sarà cambiata per includere sia l'utente che
segnala il problema, sia il gestore, sia
nnn@bugs.debian.org
.
X-Debian-PR: quiet
Le segnalazioni di bug dovrebbero essere chiuse quando si elimina il problema. Un problema si considera risolto quando il pacchetto che include la soluzione viene immesso nell'archivio Debian.
Normalmente gli unici che dovrebbero chiudere una segnalazione sono la persona che ha fatto la segnalazione e il manutentore del pacchetto verso il quale è stata inviata la segnalazione. Ci sono eccezioni a questa regola, per esempio quando il pacchetto non è specificato oppure per certi pseudo-pacchetti. Un bug può anche essere chiuso da qualsiasi collaboratore se il bug riguarda un pacchetto orfano o se il manutentore del pacchetto non è riuscito a chiuderlo. È molto importante menzionare la versione in cui è stato corretto il bug. Se si è in dubbio anziché chiudere la segnalazione conviene chiedere nella lista di messaggi debian-devel.
Le segnalazioni dovrebbero essere chiuse inviando un email a
nnn-done@bugs.debian.org
. Il testo del messaggio
deve contenere una spiegazione di come il problema è stato risolto.
Con tutti i messaggi inviati dal sistema di tracciamento, per chiudere
una segnalazione è sufficiente rispondere al messaggio con un qualsiasi
programma di posta elettronica e modificare il campo To
per dire
nnn-done@bugs.debian.org
al posto di
nnn@bugs.debian.org
(nnn-close
è fornito come alias per
nnn-done
).
Laddove possibile è meglio utilizzare la linea Version
nello pseudo-header del proprio
messaggio quando si sta chiudendo una segnalazione, in modo che il
sistema sappia quale versione contiene la correzione del problema.
La persona che chiude un bug, la persona che l'ha aperto e la
mailing list debian-bugs-closed
riceveranno ciascuna una notifica
riguardo il cambio dello status del bug. Colui che l'ha aperto e la
mailing list riceveranno inoltre il contenuto del messaggio spedito a
nnn-done
.
Il sistema di tracciamento dei bug includerà l'indirizzo del
segnalatore e quello del bug (nnn@bugs.debian.org
) nel
campo Reply-To
dopo aver rigirato la segnalazione. Nota che
questi sono due indirizzi diversi.
Qualunque sviluppatore che voglia rispondere ad una segnalazione può
semplicemente rispondere al messaggio, senza cambiare il campo
Reply-To
. Questo non chiuderà la
segnalazione.
Non usare mai la possibilità rispondi a tutti
o followup
offerta dal programma di posta a meno che tu non intenda
cambiare poi a mano la lista dei destinatari.
In particolare vedi di non spedire messaggi a
submit@bugs.debian.org
.
Perché i messaggi siano aggiunti nel sistema di tracciamento dei bug, possono essere inviati ai seguenti indirizzi:
@bugs.debian.org
— questi messaggi sono
inviati anche al manutentore del pacchetto e inoltrati a
debian-bugs-dist
, ma non a chi ha segnalato
il bug;
-submitter@bugs.debian.org
— questi messaggi
sono inviati anche a chi ha segnalato il bug e inoltrati a debian-bugs-dist
,
ma non al manutentore del pacchetto;
-maintonly@bugs.debian.org
— questi messaggi
sono inviati solamente al manutentore del pacchetto, non
a chi ha segnalato il bug né a debian-bugs-dist
;
-quiet@bugs.debian.org
— questi messaggi sono
solamente inseriti nel sistema di tracciamento dei bug (come tutti quelli
precedenti), ma non vengono mandati a nessun altro.
Per maggiori informazioni su intestazioni e sulle risposte soppresse e su come inviare copie conoscenza usando il sistema di tracciamento dei bug, vedere istruzioni per segnalare bug.
Il sistema registra un livello di gravità del bug. In maniera predefinita
viene assegnato il livello normal
, ma questo può
essere impostato inserendo una linea
Severity
nello pseudo-header quando il bug viene
segnalato (vedi le
istruzioni per segnalare i bug
), o utilizzando il comando severity
nel
server per il controllo delle segnalazioni.
I livelli di gravità sono:
critical
grave
serious
musto
required) o che comunque secondo il manutentore del pacchetto, o il manager di rilascio, rende lo stesso inappropriato per il rilascio.
important
normal
minor
wishlist
Alcuni livelli sono considerati release-critical, vale a dire che il problema avrà un certo impatto nell'inserire il pacchetto nella versione stabile di Debian. Attualmente questi livelli sono critical, grave e serious. Per le regole complete che definiscono quali problemi meritino questo tag si faccia riferimento all'elenco dei problemi release-critical per il prossimo rilascio.
Ogni bug può avere zero o più insiemi di tag. Questi tag sono mostrati nella lista dei bug quando si guarda la pagina del package e quando si guarda al log completo.
I tag possono essere creati inserendo una linea Tags
nello
pseudo-header quando la segnalazione è inviata (vedi le
istruzioni per inviare segnalazioni),
o usando il codice comando tags
con il
control request server.
I tag vanno separati con una virgola e/o degli spazi.
I tag attuali sono:
patch
wontfix
moreinfo
non funziona. Cosa non funziona?
unreproducible
help
newcomer
.newcomer
pending
fixed
security
upstream
confirmed
fixed-upstream
fixed-in-experimental
d-i
ipv6
lfs
l10n
a11y
ftbfs
Di seguito alcune informazioni sui tag specifici per distribuzione: i tag '-ignore' sono pensati per permettere la propagazione alla fase di test; quelli 'release' vogliono indicare che non è possibile archiviare una segnalazione fintanto che il bug non è stato trovato e corretto in quella distribuzione. I tag 'release' indicano anche che il bug è presente solo in quelle distribuzioni, vale a dire che il bug non è presente nelle distribuzioni per le quali quel bug non ha il tag 'release'.
I tag 'release' non dovrebbero essere necessari se la gestione delle versioni
del bug permette già di chiarire quali distribuzioni ne siano affette.
L'utilizzo delle versioni è da preferire perché non richiede un intervento
manuale. Nel caso di dubbi sull'utilizzo dei tag 'release' contattare gli
amministratori del BTS (
Quando uno sviluppatore manda la segnalazione a chi gestisce il pacchetto originario (e non quello Debian), dovrebbe inserire il fatto all'interno del sistema per la gestione dei bug.
Assicurati che il campo To
del tuo messaggio contenga solo
l'indirizzo dell'autore o degli autori del pacchetto e che il campo Cc
contenga sia l'indirizzo di chi ha fatto la segnalazione, sia
nnn-forwarded@bugs.debian.org
, sia
nnn@bugs.debian.org
.
Chiedi all'autore di mantenere il campo Cc
con
nnn-forwarded@bugs.debian.org
quando risponderanno,
così il sistema inserirà la sua risposta all'interno della segnalazione
originaria. Questi messaggi vengono registrati ma non inoltrati; per inviare
l'email aggiungi ai destinatari nnn@bugs.debian.org
.
Quando il sistema riceve un messaggio indirizzato a
nnn-forwarded
segnerà che il bug è stato
comunicato agli indirizzi nel campo To
del messaggio
che riceve, a meno che il messaggio non sia già stato inoltrato
(forwarded).
Puoi modificare quest'ultima informazione spedendo un messaggio
a control@bugs.debian.org
.
Nei casi in cui chi deve risolvere il problema non è il curatore del pacchetto associato (per esempio quando il pacchetto è gestito da un gruppo di persone), può essere utile registrare questo fatto nel sistema di gestione dei bug. Per aiutare in questa operazione ogni bug può avere opzionalmente un proprietario.
Il proprietario può essere impostato inserendo una linea
Owner
nello pseudo-header della segnalazione (cfr:
come segnalare bug), o
utilizzando i comandi owner
e noowner
del control request server.
Se il gestore di un pacchetto è erroneamente
nella lista il fatto è normalmente spiegato da un recente cambio di
gestore, e il nuovo gestore non ha ancora inserito una nuova versione del
pacchetto con la segnalazione del cambio nel campo
Maintainer
del file di controllo.
Questo problema viene automaticamente risolto quando il pacchetto
è inviato a Debian; in alternativa un manutentore di pacchetto può
sovrascrivere il file del manutentore direttamente a mano, per esempio
se non è previsto un rebuild e un nuovo upload in tempo breve.
Contatta override-change@debian.org
per cambiare il file in
questione.
È possibile assegnare una segnalazione ad un altro pacchetto, o anche
riaprire segnalazioni chiuse per errore, o ancora modificarne le
informazioni relative a dove una certa segnalazione va inviata.
È anche possibile cambiare il livello di gravità della
segnalazione o il titolo stesso, o cambiarne il proprietario, o
fondere/separare delle segnalazioni, o inserire le versioni dei
pacchetti che sono affette dal bug o che non lo sono.
Tutto questo è fatto inviando un
messaggio a control@bugs.debian.org
.
Il formato di questi messaggi è
descritto in un altro documento disponibile sul web nel file
bug-maint-mailcontrol.txt
. Una versione del
documento in solo testo è ottenibile inviando un messaggio
con il solo testo help
al server all'indirizzo
di cui sopra.
Il sistema di tracciamento dei bug permette ai segnalatori, agli
sviluppatori e altri interessati, di iscriversi a singole segnalazioni.
Questa proprietà può essere utilizzata da quelli che vogliono dare
un'occhiata al bug, senza che si debbano iscrivere al pacchetto tramite
il Debian Package Tracker.
Tutti i messaggi inviati a nnn@bugs.debian.org
vengono spediti agli iscritti.
Per iscriversi ad un bug si deve inviare un email a
nnn-subscribe@bugs.debian.org
. L'oggetto e
il corpo del messaggio sono ignorati dal BTS. Una volta che il
messaggio è processato, all'utente viene inviato un messaggio
di conferma al quale è necessario rispondere prima che che
i messaggi del bug vengano inviati.
È anche possibile annullare l'iscrizione ad un bug. Lo si fa
inviando un email a nnn-unsubscribe@bugs.debian.org
.
L'oggetto e il corpo del messaggio sono ignorati dal BTS. Una volta che il
messaggio è processato, all'utente viene inviato un messaggio
nel quale si chiede la conferma dell'annullamento.
Normalmente l'indirizzo utilizzato è quello che si trova
nel campo From
dell'intestazione del messaggio. Se si
volesse iscrivere un altro indirizzo, lo si deve codificare nel
messaggio di iscrizione secondo questo modello:
nnn-subscribe-
localpart=
example.com@bugs.debian.org
.
Questo esempio invierà a localpart@example.com
il
messaggio di conferma per il bug nnn. Il simbolo @
deve essere codificato cambiandolo in =
. Analogamente gli
annullamenti dell'iscrizione vanno fatti con un email a
nnn-unsubscribe-
localpart=
example.com@bugs.debian.org
.
In entrambi i casi l'oggetto e il corpo dell'email verranno copiati nel messaggio che richiede la conferma.
I messaggi che arrivano a submit
o bugs
e il
cui Oggetto comincia con Bug#
nnn verranno trattati
come se fossero stati inviati a nnn@bugs.debian.org
. Questo
sia per compatibilità con i messaggi inviati al vecchio indirizzo sia
per catturare tutti i messaggi erroneamente inviati a submit
(per esempio facendo un 'rispondi a tutti'.)
Una gestione analoga è fatta per maintonly
,
done
, quiet
e forwarded
,
che trattano i messaggi che arrivano con Oggetto simile a quello
di prima. Questi messaggi vengono reinviati all'indirizzo
nnn-eccetera@bugs.debian.org
.
I messaggi che arrivano a forwarded
e
done
— vale a dire senza alcun numero di segnalazione
nell'indirizzo — e senza numero di segnalazione nell'oggetto saranno
mantenuti solo per alcune settimane.
X-Debian-PR: quiet
Una volta era possibile impedire al sistema di fare il
forward di un messaggio ricevuto all'indirizzo
debian-bugs
, inserendo la linea
X-Debian-PR: quiet
nell'intestazione del messaggio.
Questa linea è ormai ignorata. Per ottenere lo stesso scopo il
messaggio va indirizzato a quiet
o
nnn-quiet
(o maintonly
o
nnn-maintonly
).