#use wml::debian::template title="Debian BTS — informações para desenvolvedores(as)" NOHEADER=yes NOCOPYRIGHT=true #include "$(ENGLISHDIR)/Bugs/pkgreport-opts.inc" #use wml::debian::translation-check translation="40a57e26c62893be7c80d82f1772999f68d51179"
Inicialmente, um relatório de bug é enviado por um(a) usuário(a) como
uma mensagem de e-mail comum para submit@bugs.debian.org
, o qual
deve incluir uma linha Package
(para mais informações veja
instruções para relatar bug). Um número é então
atribuído ao relatório, informado ao(à) usuário(a) e encaminhado para
debian-bugs-dist
. Se a linha Package
contiver
um pacote que tenha um(a) ou mais mantenedores(as) conhecidos(a), eles(as) também
receberão uma cópia.
Na campo Assunto
será adicionado
Bug#
nnn:
e o campo Responder para
incluirá o(a) usuário(a) que enviou o relatório e também
nnn@bugs.debian.org
.
X-Debian-PR: quiet
Os relatórios de bugs Debian devem ser fechados quando o problema é corrigido. Problemas em pacotes só podem ser considerados corrigidos apenas quando um pacote que inclui a correção para o bug entra no repositório Debian.
Normalmente, as únicas pessoas que devem fechar um relatório de bug são: o(a) usuário(a) que relatou o bug e os(as) mantenedores(as) do pacote para o qual o bug foi enviado. Existem exceções para esta regra, por exemplo, os bugs relatados para pacotes desconhecidos ou para certos pseudopacotes genéricos. Um bug também pode ser fechado por qualquer contribuidor(a) se o bug for de um pacote órfão, ou se o(a) mantenedor(a) do pacote esqueceu de fechá-lo. É muito importante mencionar a versão do pacote para a qual o bug foi corrigido. Em caso de dúvida, não feche o bug, peça primeiro por ajuda na lista de discussão debian-devel.
Relatórios de bugs devem ser fechados através do envio de um
e-mail para nnn-done@bugs.debian.org
.
O corpo da mensagem precisa conter uma explicação de como o bug
foi corrigido.
Com as mensagens recebidas do sistema de acompanhamento de bugs, tudo
o que você precisa fazer para fechar o bug é enviar uma resposta através de
seu programa de e-mail e editar o campo Para
inserindo
nnn-done@bugs.debian.org
em vez de
nnn@bugs.debian.org
(nnn-close
é fornecido como um apelido para
nnn-done
).
Onde aplicável, por favor forneça uma linha Version
no pseudocabeçalho
de sua mensagem quando fechar um bug, de forma que o sistema de acompanhamento
de bugs saiba quais versões do pacote contêm a correção.
A pessoa que está fechando o bug, a pessoa que o relatou e a lista de
discussão debian-bugs-closed
irão todos receber uma notificação
sobre a mudança do status do relatório. A pessoa que enviou o relatório e a
lista de discussão também receberão o conteúdo da mensagem enviada
para nnn-done
.
O sistema de acompanhamento de bugs incluirá o endereço da pessoa que
relatou o bug e o endereço do bug (nnn@bugs.debian.org
)
no cabeçalho Responder para
depois de encaminhar o relatório do
bug. Por favor, observe que estes são dois endereços distintos.
Qualquer desenvolvedor(a) que deseje responder a um relatório de bugs deve
simplesmente responder à mensagem, respeitando o cabeçalho
Responder para
. Isto não fechará o bug.
Não use as funcionalidades responder para todos
ou
encaminhar
do seu leitor de e-mail, a não ser que você deseje editar os
destinatários consideravelmente. Em particular, não envie
mensagens encaminhadas para submit@bugs.debian.org
.
As mensagens podem ser enviadas para os seguintes endereços a fim de serem arquivadas no sistema de acompanhamento de bugs:
@bugs.debian.org
- estas mensagens também são enviadas
para o(a) mantenedor(a) do pacote e encaminhadas para
debian-bugs-dist
, mas não para a pessoa que
relatou o bug;
-submitter@bugs.debian.org
- estas também são enviadas
para a pessoa que relatou o bug e encaminhadas para debian-bugs-dist
,
mas não para o(a) mantenedor(a) do pacote;
-maintonly@bugs.debian.org
- estas são enviados somente
para o(a) mantenedor(a) do pacote, e não para a pessoa que
relatou o bug ou debian-bugs-dist
;
-quiet@bugs.debian.org
- estas são apenas arquivadas
no sistema de acompanhamento de bug (como todos os anteriores), e
não são enviadas para mais ninguém.
Para mais informações sobre cabeçalhos para suprimir mensagens de confirmação e como enviar com cópias usando o sistema de acompanhamento de bugs, veja as instruções para relatar bugs.
O sistema de acompanhamento de bugs grava um nível de severidade para
cada relatório de bug. Este é definido como normal
por padrão, mas
pode ser sobrescrito incluindo uma linha Severity
no
pseudocabeçalho quando o bug é enviado (consulte as
instruções para reportar bugs), ou usando
o comando severity
com o servidor de
requisição de controle.
Os níveis de severidade são:
critical
grave
serious
mustou
required, ou, na opinião do(a) mantenedor(a) do pacote ou do(a) gerente de lançamento, torna o pacote impróprio para o lançamento.
important
normal
minor
wishlist
Certas severidades são consideradas release-critical, significando que o bug terá um impacto na liberação do pacote na versão estável (stable) do Debian. Atualmente, as severidades nesta categoria são critical, grave e serious. Para regras completas e canônicas sobre quais problemas merecem tais severidades, veja a lista dos problemas release-critical para o próximo lançamento
Cada bug pode ter zero ou mais conjunto de tags. Estas tags são exibidas na lista de bugs quando você consulta a página do pacote e quando você consulta o registro completo do bug.
As tags podem ser definidas incluindo uma linha Tags
no
pseudocabeçalho quando o bug é reportado (consulte as
instruções para reportar bugs)
ou usando o comando tags
com o
servidor de requisição de controle. Separe
tags múltiplas com vírgulas, espaços ou ambos.
As tags atuais dos bugs são:
patch
wontfix
moreinfo
Não funciona. O que não funciona?
unreproducible
help
newcomer
.newcomer
pending
fixed
fixed.
security
upstream
confirmed
fixed-upstream
fixed-in-experimental
d-i
ipv6
lfs
l10n
a11y
ftbfs
Algumas informações sobre tags específicas de versão: As tags -ignore ignoram o bug para permitir a propagação para a teste (testing). As tags de versões indicam que o bug em questão não deve ser arquivado antes de ser corrigido no conjunto das versões marcadas. As tags de versão também indicam que um bug somente pode ser considerado problemático em um conjunto de versões específicas. [Em outras palavras, se qualquer das tags de versão estão inseridas, o bug é inexistente em qualquer versão cuja tag daquela versão correspondente não está inserida. Caso contrário, as regras normais de encontrado/corrigido se aplicam.]
Tags de versões não devem ser usadas se o versionamento
adequado do bug conseguir o efeito desejado, uma vez que exigem a adição e
a remoção manual. Se você não tem certeza se uma tag de versão é
necessária, entre em contato com os(as) administradores(as) do Debian BTS
(
Quando um(a) desenvolvedor(a) encaminha um relatório de bugs para o(a) desenvolvedor(a) original do código fonte do qual o pacote Debian é derivado, deve-se anotar no sistema de acompanhamento de bugs como abaixo:
Certifique-se de que o campo Para
da sua
mensagem para o(a) autor(a) possua apenas o endereço de e-email dele(a) (ou os
endeços de e-mail no caso de ser mais de um(a) autor(a)); no campo
Cc
coloque: a pessoa que reportou o bug,
nnn-forwarded@bugs.debian.org
e
nnn@bugs.debian.org
.
Peça ao(à) autor(a) para preservar o campo Cc
deixando nnn-forwarded@bugs.debian.org
quando responder,
assim o sistema de acompanhamento de bugs irá arquivar a resposta com o
relatório original. Estas mensagens são apenas arquivadas e não
enviadas; para enviar uma mensagem da forma normal, envie-a para
nnn@bugs.debian.org
.
Quando o sistema de acompanhamento de bugs recebe uma mensagem com
nnn-forwarded
, ele marca o bug relevante como tendo sido
encaminhado para o(s) endereço(s) no campo Para
da mensagem que ele
recebe, caso o bug já não esteja marcado como encaminhado.
Você pode também manipular a informação forwarded to
enviando
mensagens para
control@bugs.debian.org
.
Nos casos onde a pessoa responsável por consertar o bug não é o(a) mantenedor(a) do pacote (por exemplo, quando o pacote é mantido por uma equipe), pode ser útil registrar esse fato no sistema de processamento de bugs. Para facilitar, cada bug pode opcionalmente ter um(a) dono(a).
O(A) dono(a) pode ser configurado(a) adicionando a linha Owner
no pseudocabeçalho quando o bug é enviado (veja as
instruções para relatar bugs),
ou usando os comandos owner
e noowner
no
servidor de requisição de controle.
Se o(a) mantenedor(a) de um pacote está listado(a) incorretamente,
é porque, geralmente, o(a) mantenedor(a) mudou recentemente e
o(a) novo(a) mantenedor(a) não fez o envio de uma nova versão do
pacote com um campo Maintainer
do arquivo de controle modificado.
Isto será corrigido quando o pacote for enviado; alternativamente, os(as)
mantenedores(as) do repositório podem sobrescrever o registro do(a)
mantenedor(a) de um pacote manualmente, por exemplo, se uma recompilação e um
reenvio do pacote não são esperados tão cedo.
Entre em contato com override-change@debian.org
para mudanças no
arquivo de sobrescrita (override file).
É possível reatribuir relatórios de bugs para outros pacotes,
reabrir bugs fechados erroneamente, modificar a informação dizendo
para onde, caso exista, um relatório de bug foi encaminhado, mudar
as severidades e títulos de relatórios, configurar o(a) responsável pelos
bugs, juntar e separar relatórios de bugs e registrar as
versões dos pacotes nos quais os bugs foram encontrados e em quais delas os
bugs foram corrigidos. Isto é feito enviando e-mails para
control@bugs.debian.org
.
O formato destas mensagens é descrito em
outro documento disponível no web site, ou no arquivo
bug-maint-mailcontrol.txt
. Uma versão em texto puro
também pode ser obtida enviando uma mensagem com a palavra
help
para o servidor no endereço acima.
O sistema de acompanhamento de bugs também permite que a pessoa que relatou o
bug, os(as) desenvolvedores(as) e qualquer outra parte interessada, inscrevam-se
em um bug específico. Esse recurso pode ser usado por aqueles(as) que desejam
monitorar um bug, sem que seja necessário inscrever-se em um pacote através do
rastreador de pacotes do Debian. Todas
as mensagens recebidas em nnn@bugs.debian.org
, são
enviadas aos(às) inscritos(as).
A inscrição em um bug pode ser feita através do envio de um e-mail para
nnn-subscribe@bugs.debian.org
. O assunto e o conteúdo
do e-mail são ignorados pelo BTS. Uma vez que a mensagem seja processada, os(as)
usuários(as) receberão um e-mail de confirmação que deve ser respondido para que
eles(as) comecem a receber as mensagens relacionadas ao bug.
Também é possível cancelar a inscrição de um bug. O cancelamento da
inscrição pode ser feita através do envio de um e-mail para
nnn-unsubscribe@bugs.debian.org
. O
assunto e o conteúdo do e-mail são novamente ignorados pelo BTS. Os(As)
usuários(as) receberão uma mensagem de confirmação que deve ser respondida para
que eles(as) tenham as inscrições do bug canceladas.
Por padrão, o endereço inscrito é aquele encontrado no campo De
do cabeçalho da mensagem. Se você deseja inscrever um outro
endereço de e-mail em um bug, você terá que codificar o endereço a ser inscrito dentro
da mensagem de inscrição. Eis o formato utilizado para isso:
nnn-subscribe-
\
localpart=
\
example.com@bugs.debian.org
.
Esse exemplo enviaria à localpart@example.com
uma mensagem de
inscrição no bug nnn. O símbolo @
deve ser codificado
mudando para o símbolo =
.
Similarmente, um cancelamento de inscrição utilizaria o seguinte formato:
nnn-unsubscribe-
localpart\
=
example.com@bugs.debian.org
.
Em ambos os casos, o assunto e o corpo do e-mail serão encaminhados ao
endereço contido na requisição de confirmação.
Mensagens que chegam em submit
ou bugs
cujo campo assunto inicie com Bug#
nnn serão tratadas
como tendo sido enviadas para nnn@bugs.debian.org
.
Isto é para compatibilidade retroativa com mensagens encaminhadas a partir do
endereço antigo e para pegar mensagens enviadas para submit
por
engano (por exemplo, usando "responder para todos os destinatários").
Um esquema similar opera para maintonly
,
done
, quiet
e forwarded
,
os quais tratam mensagens que chegam com uma tag Subject como tendo sido
enviadas para o endereço nnn-qualquercoisa@bugs.debian.org
correspondente.
Mensagens que chegam com forwarded
puro e done
—
isto é, sem o número do relatório de bugs no endereço — e sem um número de
bug no campo assunto serão arquivadas como junk
e mantidas por algumas
semanas, mas por outro lado serão ignoradas.
X-Debian-PR: quiet
É usado para ser possível prevenir que o sistema de acompanhamento
de bugs encaminhe para qualquer lugar mensagens que o mesmo recebeu em
debian-bugs
, colocando uma linha
X-Debian-PR: quiet
no cabeçalho da mensagem atual.
Esta linha de cabeçalho é agora ignorada. Em vez disso, envie
sua mensagem para quiet
ou nnn-quiet
(ou maintonly
ou nnn-maintonly
).