Bugzilla/Bug report guide/ru

Лучшие практики

• Перечитайте текст отчета перед отправкой; текст нельзя отредактировать впоследствии. Текст отчета об ошибке, как правило, немедленно отправляется по электронной почте множеству людей. Напишите отчет ясно, на чистом языке; избегайте разговорной лексики. Подсказка: Представьте, что у вас есть только один шанс в вашей жизни, чтобы написать этот очень важный отчет об ошибке. Вы должны понимать, что получатель может прочитать по-английски, но это может быть не его родной язык.

• Поищите дубликаты, перед созданием нового бага.

• Stay on topic - A bug ticket is used for technical reports and chitchat should be avoided. Keep them in the support channels (forums, IRC or mailing lists).
• Confirm the existence of a problem only once. - It does not help solving the problem, if you and another person report it twice. But if your and the confirmer's systems differ in an obvious way and that would be helpful to know, add this information.
• Open one bug ticket per topic - Usually this means not more than one package and one bug per ticket. If your problem is not discussed on a bug, search for one related to your issue or create a new report. Do not hijack bugs.
• No talk on TRACKER bugs. - Those bugs are meta bugs. If you want to add useful information, add them to a related sub bug or create a new bug.
• Optional: Gentoo consultants provide also commercial support for bugs and ebuilds.
• Attach the logs to the bug ticket if the ticket is about problems during runtime or installation.

Пакеты/ebuild

Вы должны всегда добавлять информацию о системной конфигурации в баг. Для этого создайте новое вложение (attachment) и вставьте содержимое:

user $emerge --info > /tmp/emerge--info.txt

Сообщите об ошибке во время сборки (emerge failed)

Error creating thumbnail: File missing

Используйте кнопку Add an attachment под текстовым полем описания, чтобы прикрепить файлы в bugzilla.

• Сперва напишите точную версию пакета в заголовке отчета, например sys-apps/package-2.3-r4
• Добавьте в заголовок краткое сообщение ошибки
• Прикрепите (attach) логи к сообщению об ошибке

Сообщите об ошибках во время выполнения

Файлы и информация, представляющая интерес, в порядке приоритета:

• Точная версия пакета в заголовке отчета, например sys-apps/package-2.3-r4 аварийно завершается с ошибкой: Не могу продолжать...
• Описание проблемы, чтобы другие могли ее воспроизвести:
  • Как запускается программа (в консоли, в терминале, в качестве демона, в каком уровне запуска и так далее)
  • Какие ошибки выводятся
  • Что заставляет программу аварийно завершаться, неправильно работать, не запускаться
  • Есть ли возможность обойти проблему?
  • Последняя версия пакета, которая работала нормально, если таковая была
  • Какие изменения привели к тому, что программа перестала работать?

Прикрепите (attach) логи к сообщению об ошибке

Сообщить о новой версии; новая версия программы доступна какое-то время

• Search Bugzilla before posting a bump request - is there already a bug open? Has the local Portage tree been synced lately; is it already in Portage?
• Avoid zero-day bump requests (wait at least 48 hours after the release announcement)
• Has it actually been released by upstream sources, or is it just marked in the source tree? Some projects mark a release in the tree long time before it is officially released.
• Be sure to mention if it compiles and runs well on your arch. Any other helpful information you provide is most welcome.
• Add a link to the upstream website
• Give a link or list of fixed bugs or new features (sometimes called changelog)
• Write a summary in the form app-editors/vim-12.3.5 version bump

Не обязательно

• Does a simple copy work, or does the ebuild need changes? (changed dependencies, obsolete patch files)
• Test the ebuild in a local overlay before submitting attachments
• Provide patches for proposed ebuild edits, with optional explanation of changes (file name should match the new version number, not old)
• Provide additional files (initd, unit files) as separate attachments (as needed)
• Do not paste files directly into comments; use attachments.

Запрос на добавление нового пакета; запрос ebuild файла

Если вы хотите добавить в Portage новый ebuild для какой-либо программы, вам нужно найти куратора (maintainer) для пакета, либо самому им стать:

• Link to the upstream website in the bug report
• Give a link or list of features
• Suggest a preliminary category and package name for the ebuild in the subject line for example media-gfx/inkscape ebuild request
• Provide an ebuild and patches that were tested in your local overlay (you can get help in IRC or in the forums with that)

Пакет XY следует отметить как стабильный

If a package is building and working without problems on the system for more than 30 days and it isn't yet marked as stable you can create a stable request.

Ядро

Файлы и информация, представляющая интерес для отчетов об ошибках ядра, в порядке приоритета:

• Which kernel and version is used, on what architecture e.g. gentoo-sources-3.4.2-r2 on x86_64
• The kernel configuration file should be attached to the bug report (/usr/src/linux/.config)
• A list of all devices in the system can be acquired with lspci -k
• Log files during kernel initialization should be attached (/var/log/dmesg or /var/log/messages)

Заметка
Может потребоваться осуществить kernel git-bisect для определения плохих патчей.

Смотрите также

• Bugzilla/Guide — covers the recommended method of reporting bugs for Gentoo.
• Contributing to Gentoo — explains how users can contribute to the development of Gentoo
• Gentoo GitHub — explains how to contribute to Gentoo by creating pull requests on GitHub
• Веб-сайт Gentoo Bugzilla