Bugzilla/Bug report guide/ru

Цель этой статьи — обратить внимание на ряд моментов, которые следует учесть при создании отчетов об ошибках, в целях облегчения жизни тех, кто будет их просматривать. Помните, что они занимаются вашими проблемами бесплатно.

Основная информация
Reread the text before submission, the changes are not reversible and the text cannot be edited afterwards. Also any text entered into a bug report will be usually e-mailed immediately to a lot of people.

Создание нового отчета об ошибке (bug)
Search for duplicates, maybe someone else reported the problem already. The creation of a new bug report is guided, read the instructions carefully. Once the category is chosen, it will show a list of recently entered bug reports to avoid duplicates.

Добавление информации в другой bug

 * Always stay on topic - A bug tracker is used for technical reports and chitchat should be avoided. Keep them in the forums, IRC or mailing-lists.
 * Only confirm the existence of a problem 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.
 * Do not hijack other bugs. - If your problem is not discussed on a bug, search for one related to your issue or create a new report.
 * 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.

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

Проблемы во время сборки
Полезные файлы и информация упорядоченные по приоритету:


 * The exact version of the package in the title of the bug report e.g. sys-apps/package-2.3-r4
 * If possible, add parts of the error message to the title
 * The logfile in
 * If your logfile is too big to upload, compress it: and upload build.log.gz from this directory
 * The output of emerge --info 

Проблемы во время выполнения
Files and information of interest ordered by priority:


 * The exact version of the package in the title of the bug report e.g. sys-apps/package-2.3-r4 crashes with error: Cannot proceed...
 * Description of the problem, so that other can reproduce it:
 * How is the program run (on the console, in a terminal, as a daemon, in what runlevel etc.)
 * Any error output
 * What makes the program crash, behave wrong, not start
 * Is there a workaround?
 * What was the last working version of the package, if any?
 * What changed to make it not work?
 * The output of emerge --info
 * The output of emerge -pv  to quickly see what are the dependencies

Для пакета XY выпущена новая версия
Вэб-сайт разработчика сообщил о том, что доступен новый релиз:


 * Please allow for 24 hours to pass after the release announcement. A developer may already be working on it.
 * Link to the upstream website in the bug report
 * Give a link or list of fixed bugs or new features

If providing new information for the upgraded ebuild (optional):


 * If the new version needs no changes to the ebuild's contents, please indicate such
 * 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 ebuilds or other ebuild-related file contents directly into comments; use attachments for those

Пакет XY должен быть в Portage
If you request a new ebuild for a software to be added to portage, you must find or become a maintainer for the package:


 * Link to the upstream website in the bug report
 * Give a link or list of features
 * Provide an ebuild and patches that were tested in the local overlay (you can get help in IRC or in the forums with that)

Package XY should be marked stable
A package is building and working without problems on the system for more than 30 days but is still marked as unstable:


 * See KEYWORDS for more information on stable/unstable branch
 * Did you test the version you want to become stable thoroughly?
 * Are there other bug reports regarding this bug?
 * Was the version of the package added to the tree at least 30 days ago?
 * Are its dependencies all marked stable?

Ядро
Files and information of interest for kernel bug reports ordered by priority:


 * 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
 * A list of all devices in the system can be acquired with lspci -k
 * Log files during kernel initialization should be attached or

Other bug reports
There is no real template, this falls under the category like problems with captcha on wiki.gentoo.org, forum.gentoo.org is down or anything else that is not really related to software.

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

 * Bugzilla guide
 * Contributing to Gentoo
 * Gentoo Github - Helping the Gentoo project and considering sending a Pull Request via GitHub

Внешние ресурсы

 * Сайт Gentoo Bugzilla