#use wml::debian::template title="System śledzenia błędów - informacje dla rozwijających" NOHEADER=yes NOCOPYRIGHT=true #use wml::debian::translation-check translation="1.61"
Pierwszym etapem jest nadesłanie zgłoszenia w postaci zwykłej wiadomości
poczty elektronicznej na adres submit@bugs.debian.org
. Zgłoszeniu zostaje nadany
numer, zgłaszająca osoba otrzymuje potwierdzenie, a zgłoszenie jest
przekazywane na listę debian-bugs-dist
. Jeśli zgłaszający dodał
nagłówek Package
zawierający nazwę pakietu, którego opiekun jest
znany, kopia zgłoszenia zostaje wysłana także do opiekuna.
Na początku nagłówka Subject
zostaje dodany napis
Bug#
nnn:
, a nagłówek
Reply-To
zostaje ustawiony tak, by zawierał zarówno adres
zgłaszającego jak i nnn@bugs.debian.org
.
X-Debian-PR: quiet
Zgłoszenia błędów w Debianie powinny być zamykane w momencie usunięcia problemu. Problemy w pakietach można uznać za rozwiązane tylko wtedy, gdy pakiet zawierający poprawkę dla danego błędu trafi do archiwum Debiana.
Zazwyczaj jedynymi osobami uprawnionymi do zamykania zgłoszenia są zgłaszający ten błąd i opiekun(owie) danego pakietu. Są jednak wyjątki od tej reguły, na przykład w przypadku błędów zgłoszonych w nieznanych pakietach lub w niektórych pseudo-pakietach. Jeśli masz wątpliwości, nie zamykaj zgłoszenia - poproś o radę na liście debian-devel.
Zgłoszenia należy zamykać przez wysłanie wiadomości e-mail na adres
nnn-done@bugs.debian.org
. Treść wiadomości musi
zawierać objaśnienie sposobu, w jaki został poprawiony dany błąd.
Dzięki wiadomościom e-mail wysyłanym przez system śledzenia błędów
zamknięcie zgłoszenia sprowadza się do odpowiedzenia na taki list po
uprzedniej zmianie pola To
na
nnn-done@bugs.debian.org
zamiast
nnn@bugs.debian.org
(adres nnn-done
ma
też alias nnn-close
).
Jeśli to możliwe, proszę podać linię Version
w
pseudo-nagłówku Twojej wiadomości podczas
zamykania błędu, by system zarządzania błędami wiedział które wydanie paczki
zawiera poprawkę.
Osoba zamykająca zgłoszenie, osoba która zgłosiła błąd, oraz lista
debian-bugs-closed
otrzymają powiadomienie dotyczące zmiany stanu
danego zgłoszenia. Do zgłaszającego oraz na listę zostanie także wysłana
wiadomość zawierająca treść wiadomości wysłanej na adres
nnn-done
.
System śledzenia błędów dodaje do nagłówka Reply-To
przekazywanej wiadomości adres osoby zgłaszającej błąd oraz adres błędu
(nnn@bugs.debian.org
). Należy zwrócić uwagę na fakt,
że są to dwa oddzielne adresy.
Jeśli rozwijający pragnie odpowiedzieć na zgłoszenie, powinien po prostu
użyć funkcji odpowiedzi swojego programu pocztowego, adresując list zgodnie z
nagłówkiem Reply-To
. Nie spowoduje to zamknięcia
błędu.
System śledzenia błędów otrzyma wiadomość wysłaną na adres
nnn@bugs.debian.org
, przekaże ją do opiekuna pakietu, dopisze do
zgłoszenia, a także przekaże na listę debian-bugs-dist
.
Wysyłając wiadomości do nnn-submitter@bugs.debian.org
należy pamiętać że otrzyma go też osoba, która zgłosiła błąd, oraz że kopia
wiadomości zostanie umieszczona w Systemie śledzenia błędów. Wiadomość nie
zostanie wysłana do osoby przygotowującej paczki.
Jeśli chcesz wysłać wiadomość, która nie nadaje się do przekazania na listę
debian-bugs-dist
, możesz wysłać ją na adres
nnn-quiet@bugs.debian.org
lub
nnn-maintonly@bugs.debian.org
. Poczta wysyłana na pierwszy z tych
adresów jest zapisywana w systemie śledzenia błędów, ale nie jest przekazywana
do żadnych osób ani list dyskusyjnych. Poczta wysyłana na adres
nnn-maintonly@bugs.debian.org
jest zapisywana w systemie i
przekazywana tylko do opiekuna danego pakietu.
Nie należy używać opcji ,,odpowiedz wszystkim'' programu pocztowego,
chyba że samodzielnie usunie się pewnych adresatów. Należy zwrócić uwagę na
to, aby nie wysyłać wiadomości dotyczących istniejących zgłoszeń na adres
submit@bugs.debian.org
.
Więcej informaji o nagłówkach powstrzymujących wiadomości potwierdzające (ACK) oraz o wysyłaniu kopii listów za pomocą Systemu śledzenia błędów jest dostępnych w instrukcji zgłaszania błędów.
System śledzenia błędów zapisuje stopień ważności każdego ze zgłoszonych błędów. Jest
ona domyślnie ustawiona na ,,zwykłą'' (ang. normal
), ale
można ją zmienić dodając do zgłoszenia pseudo-nagłówek Severity
(patrz Jak zgłosić błąd) lub przy pomocy
polecenia severity
serwera
pocztowego.
Dostępne są następujące stopnie ważności:
krytyczny
(ang. critical
)
bardzo poważny
(ang. grave
)
poważny
(ang. serious
)
ważny
(ang. important
)
zwykły
(ang. normal
)
drobny
(ang. minor
)
życzenie
(ang. wishlist
)
Uwaga: przy ustawianiu stopnia ważności błędu należy używać angielskich nazw. Serwer obsługujący te żądania nie zna ich polskich (ani żadnych innych) tłumaczeń.
Pewne stopnie ważności są traktowane jako uniemożliwiające wydanie (ang. release-critical), co znaczy, że błąd ten będzie miał wpływ na to, czy dany pakiet zostanie wydany w stabilnej edycji Debiana. Obecnie status taki mają stopnie krytyczny, bardzo poważny i poważny.
Każdy błąd może mieć pewną ilość znaczników. Są one wyświetlane na liście błędów dla każdego z pakietów oraz na pełnej liście błędów.
Znaczniki można ustawiać dodając do zgłoszenia pseudo-nagłówek
Tags
(patrz Jak zgłosić
błąd), lub przy pomocy polecenia tags
serwera pocztowego.
Znaczniki należy rozdzielać przecinkami lub spacjami.
Dostępne są obecnie następujące znaczniki:
patch
(łata)
wontfix
(nie naprawię)
moreinfo
(więcej informacji)
unreproducible
(nie da się powtórzyć)
help
(pomocy)
pending
(poprawiany)
fixed
(poprawiony)
security
(bezpieczeństwo)
upstream
(źródło)
confirmed
(potwierdzony)
fixed-upstream
(poprawiony przez zewnętrznego opiekuna)
fixed-in-experimental
(poprawiony w dystrybucji
eksperymentalnej)
d-i
ipv6
lfs
l10n
potato
woody
sarge
sarge-ignore
etch
etch-ignore
sid
experimental
Ostatnie pięć znaczników jest używanych głównie przy błędach uniemożliwiających wydanie, w przypadku których ważna jest wiedza na temat tego, do których wersji Debiana się odnoszą, aby poprawiać (lub usuwać) odpowiednie pakiety.
Rozwijający, który przekazuje zgłoszenie błędu opiekunowi źródłowemu pakietu, powinien zaznaczyć ten fakt w systemie śledzenia błędów w następujący sposób:
W polu To
wiadomości e-mail należy umieścić tylko adres(y)
opiekuna(ów) źródłowego(ych); w polu CC
należy umieścić adres
osoby, która zgłosiła błąd oraz adres
nnn-forwarded@bugs.debian.org
.
Należy poprosić osobę wymienioną w polu To
, aby pozostawiła
przy odpowiadaniu adres nnn-forwarded@bugs.debian.org
w polu
CC
, dzięki czemu jej wiadomość zostanie zapisana razem z resztą
zgłoszenia.
Kiedy system śledzenia błędów otrzyma wiadomość wysłaną na adres
nnn-forwarded
, zaznaczy dany błąd jako przekazany na
adres wymieniony w polu To
danej wiadomości, jeśli błąd nie ma już statusu ,,przekazany''.
Można też ustawić informację "przekazane do" przy pomocy
odpowiedniej wiadomości wysłanej na adres control@bugs.debian.org
.
Zdarza się, że osoba odpowiedzialna za naprawienie błędu nie jest opiekunem danego pakietu (np. gdy pakietem zajmuje się grupa opiekunów). W takim przypadku warto odnotować to w systemie śledzenia błędów - każdemu błędowi można przypisać właściciela.
Właściciel błędu może zostać ustalone przez podanie linii Owner
w pseudo-nagłówku podczas zgłoszenia błedu (więcej w instrukcji zgłaszania błędu) lub za pomocą
poleceń owner
i noowner
serwera kontroli żądzań.
Najczęściej powodem przyporządkowania do pakietu niewłaściwego opiekuna,
jest to, że opiekun niedawno się zmienił, a nowy opiekun jeszcze nie wysłał na
serwer nowej wersji pakietu ze zmienionym polem kontrolnym
Maintainer
. Opiekun zostanie zmieniony automatycznie gdy na
serwer archiwum zostanie wysłana nowa wersja pakietu. Jeśli jednak nowa wersja
nie jest wkrótce spodziewana, opiekunowie systemu śledzenia błędów mogą
ręcznie zmienić tą informację. Można się z nimi skontaktować pod
adresem override-change@debian.org
.
Możliwa jest zmiana przyporządkowania błędu do pakietu, powtórne otwarcie
omyłkowo zamkniętego zgłoszenia, modyfikacja informacji mówiącej o tym do
kogo, o ile w ogóle, zostało przekazane zgłoszenie, zmiana stopnia ważności
i tytułu błędu, ustalenia właściciela błędu, połączenie i roździelenie raportu
błedu oraz do zapisu wersji paczek w których błędy zostały znalezione,
a także w których zostały poprawione. Można to zrobić wysyłając odpowiednią
wiadomość na adres control@bugs.debian.org
.
Format tej wiadomości jest opisany w innym
dokumencie dostępnym na stronie WWW lub w pliku
bug-maint-mailcontrol.txt
. Wersję tekstową tego dokumentu można
także uzyskać wysyłając słowo help
na wymieniony wyżej adres.
System śledzenia błędów pozwala także osobom zgłaszającym błedy, deweloperom
oraz innym zainteresowanym do dołączenia do subskrypcji pojedyńczych błedów.
Ta opcja może być użyta przes osoby chcące mieć podgląd na dyskusję błedu bez
konieczności subskrybcji paczki przez PTS. Wszystkie wiadomości wysłane na
nnn@debian.org
są wysyłane do osób w subskrybcji.
Subskrybowanie do błędu może być wykonane przez wysłanie wiadomości pod adres
nnn-subscribe@bugs.debian.org
. Temat oraz treść wiadomości
są ignorowane przez BTS. Kiedy tylko wiadomość zostanie przetworzona, użytkownikowi
jest wysyłana wiadomość potwierdzająca, na która trzeba odpowiedzieć przed tym jak
wiadomości dotyczące tego błedu zostaną do niego wysłane.
Jest także możliwe usunięcie swojego adresu z listy subksybcji. Można to
uczynić poprzez wysłanie wiadomości pod adres
nnn-unsubscribe@bugs.debian.org
. Temat oraz treść
wiadomości są ignorowane przez BTS. Użytkownik musi odpowiedzieć na wiadomość
potwierdzająca zanim zostanie usunięty z listy.
Domyślne, adres który chce zostać dołączony do listy zasubskrybowanych jest
znajdowany w nagłówku From
. Jeśli chcesz zapisać inny adres,
musisz zakodować adres, który ma zostać dopisany do listy. Przybiera to taką postać:
nnn-subscribe-
localpart=
example.com@bugs.debian.org
.
Przykład ten wysłałby na adres localpart@example.com
wiadomośc
subskrybcji do błedu. Część @
znaku musi zostać zakodowana poprzez
zamienienie do postaci =
. Podobnie, wypisanei z listy przybiera postać
nnn-unsubscribe-
localpart=
example.com@bugs.debian.org
.
W obu przypadkach temat oraz treść wiadomości zostaną przekazane na adres podany
w potwierdzeniu wysyłanym przez system.
Wiadomości przychodzące na adres submit@bugs.debian.org
lub
bugs@bugs.debian.org
, których adres zaczyna się od
Bug#
nnn będą traktowane tak, jakby były wysłane na
adres nnn@bugs.debian.org
. Dzieje się tak ze względu
na zgodność wstecz jak i na to, aby wyłapywać pocztę wysyłaną na adres
submit@bugs.debian.org
przez pomyłkę (na przykład przez użycie
opcji odpowiedzi do wszystkich adresatów).
Podobna zasada obowiązuje dla adresów maintonly
,
done
, quiet
oraz forwarded
,
które traktują pocztę nadchodzącą ze znacznikiem w tytule jakby nadeszła na
odpowiadający adres nnn-cośtam@bugs.debian.org
.
Wiadomości nadchodzące na adresy forwarded@bugs.debian.org
i
done@bugs.debian.org
- tzn. bez numeru błędu w adresie, a nie
zawierające numeru w temacie, zostają zapamiętane jako
"śmieci" przez parę tygodni i zignorowane.
X-Debian-PR: quiet
Kiedyś można było zapobiec przekazywaniu poczty przez system śledzenia
błędów przez dodanie nagłówka pocztowego X-Debian-PR: quiet
.
Nagłówek ten jest teraz ignorowany. Zamiast niego należy używać adresów
quiet
lub nnn-quiet
(względnie
maintonly
lub nnn-maintonly
).