Wiki

• FrontPage
• RecentChanges
• FindPage
• HelpContents
• pt_BR/BTS

Sistema de Rastreamento de Bugs

Portal do wiki Debian sobre bugs. Este portal cobre todos os aspectos para reportar e corrigir bugs no Debian.

BTS (abreviação de Bug Tracking System) é o sistema de rastreamento de bugs do Debian. Foi criado para as necessidades próprias do projeto Debian.

Ele fornece as seguintes funcionalidades:

• Pode ser totalmente controlado por e-mail

• Usuários(as) não precisam se autenticar ou criar uma conta para relatar bugs
• Usuários(as) podem se inscrever em bugs e receber atualizações por e-mail

• Interface web para visualização e filtragem de bugs reportados (incluindo mostrar bugs com patches, bugs já corrigidos).

• Bugs podem ser atribuídos e marcados como afetando diferentes pacotes

• Capacidade de marcar bugs com gravidades diferentes, de wishlist (solicitações de funcionalidades) até críticos (quebra todo o sistema)

• Desenvolvedores(as) podem registrar quais versões de um pacote são afetadas por um bug

• Usuários(as) podem definir suas próprias etiquetas e categorias para agrupar bugs de diferentes maneiras

Reportando bugs

A maneira mais fácil de reportar um bug ao Debian é usar reportbug, que ajuda a guiar através do processo de relatórios e garante que seu relatório de bug inclua partes relevantes da configuração do seu sistema.

Ao relatar um bug, explique o problema claramente, incluindo as seguintes informações:

• O que você estava tentando fazer?
• Como o problema pode ser reproduzido (ações, comandos, ...)?
• Qual seria o comportamento esperado?
• Em vez desse comportamento, o que ocorre?
• Versão do software.
• Versão do Debian que está usando

Nota da tradução: os relatórios devem ser escritos em inglês. Por favor, utilize as perguntas conforme a página neste idioma.

Se você já sabe como corrigir o bug, por favor, inclua isso também. Veja também Como relatar bugs de forma eficaz e BugReport.

Se o bug afeta todas as versões do software e não apenas a versão fornecida pelo Debian, geralmente é melhor comunicar diretamente ao upstream do software (as pessoas que mantêm o software que o Debian empacotou), e também ao Debian. Isso ocorre porque muitos(as) desenvolvedores(as) Debian ficarão relutantes em corrigir um problema a menos que os(as) desenvolvedores(as) upstream planejem fazer a mesma mudança, e porque upstream provavelmente entenderá melhor como corrigir um problema. Consulte o site oficial da página inicial upstream do software para obter informações sobre como relatar bugs upstream: geralmente você pode encontrar a página inicial upstream executando apt show <package> | grep Homepage.

Usando o BTS

Há uma documentação incompleta em Acessando o BTS; as páginas a seguir trazem a mais informações.

There is some, incomplete, documentation in Accessing the BTS and the following pages link to further information

A partir da web

• Use https://bugs.debian.org/NOMEDOPACOTE para listar bugs de um pacote específico

• Use https://bugs.debian.org/NÚMERODOBUG para acessar um relatório de bug específico

A partir da linha de comando

Existem algumas ferramentas de linha de comando no Debian que ajudam a usar o BTS:

• reportbug - uma ferramenta de linha de comando para reportar bugs para o Debian

• bts do pacote devscripts é uma ferramenta de linha de comando para manipular bugs

A partir do e-mail

• HowtoUseBTS e BTS/BugTag

• BTS/HowTo

• Documentação oficial da interface de e-mail: referência dos comandos, mensagens de controle, comandos para solicitações

Usando o UDD

• Pesquisa avançada de bugs usando UDD (a fonte de script CGI pode ser um modelo para um script local personalizado, para ser executado contra uma instância UDD pública)

Usando SOAP

Veja DebbugsSoapInterface.

Corrigindo bugs

Triagem de bugs

• Consulte BugTriage e BugReport/WorkingOn para saber como trabalhar na correção de bugs

• Aprenda como fazer triagem de bugs, Solveig na DebConf18: (vídeo)

Festa de tratamento de bugs

Consulte BSP (Bug Squashing Parties).

Fechando bugs

Relatórios de bug podem ser fechados de várias maneiras:

• Um upload de pacote que contém closes: #12345 no changelog. Quando o pacote é aceito no repositório, desencadeia um e-mail para 12345-done@bugs.debian.org com Version: 1.2.3 na primeira linha do e-mail. Isso só começará quando o pacote nessa versão estiver em sincronia na instável (unstable) em todas as arquiteturas, e também na teste (testing) (se o bug afetar a versão teste (testing)).

• Manualmente, enviando um e-mail para númerodobug-done@bugs.debian.org com um campo de cabeçalho Version: que define o relatório de bug a ser corrigido nessa versão. Se o relatório de bug é um "non-issue" (por exemplo, um relatório falso), a linha Version: não deve ser adicionada ao e-mail (isso é necessário para o BTS ser capaz de distinguir bugs corrigidos em uma versão específica e bugs que não são realmente bugs).

Desenvolvimento do BTS

• Bugs que afetam o BTS: bugs.debian.org e debbugs

• Teams/Debbugs - a equipe responsável pelo BTS

Palestras sobre o BTS

• debbugs ­- Dicas, truques e hacks, Anthony Towns, 15 de junho de 2005 (vídeo, slides)

• Mecanismos internos secretos do Debian, Enrico Zini, 2007 na Fosdem : (vídeo,slides)

Páginas wiki

Todas as páginas wiki sobre o trabalho com bugs no Debian:

CategoryBugs | CategoryPortal