Bugzilla/Bug report guide/ru

From Gentoo Wiki
Jump to: navigation, search
This page is a translated version of the page Bugzilla/Bug report guide and the translation is 100% complete.

Other languages:
English • ‎italiano • ‎日本語 • ‎한국어 • ‎русский • ‎中文(中国大陆)‎

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

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

  • Перечитайте текст отчета перед отправкой; текст нельзя отредактировать впоследствии. Текст отчета об ошибке, как правило, немедленно отправляется по электронной почте множеству людей. Напишите отчет ясно, на чистом языке; избегайте разговорной лексики. Подсказка: Представьте, что у вас есть только один шанс в вашей жизни, чтобы написать этот очень важный отчет об ошибке. Вы должны понимать, что получатель может прочитать по-английски, но это может быть не его родной язык.
  • Поищите дубликаты, перед созданием нового бага.
  • Не отклоняйтесь от темы. — bug ticket предназначен для технических отчетов, а не для болтовни. Оставьте ее для каналов поддержки (форумы, IRC и списков рассылок).
  • Подтверждайте существование проблемы только один раз. — Если вы и кто-то другой сообщите дважды о той же самой проблеме, это не поспособствует ее решению. Однако, если ваша система очевидно отличается от системы подтвердившего ошибку, и это имеет значение, тогда добавьте эту информацию.
  • Открывайте один отчет для каждой проблемы — Если ваша проблема не обсуждается в отчете, поищите отчет, имеющий к ней отношение или создайте новый. Не захватывайте другие отчеты об ошибках.
  • Никаких разговоров в TRACKER bugs. — Эти отчеты являются мета-отчетами. Если вы хотите добавить полезную информацию, добавьте ее в подходящий суб-отчет или создайте новый отчет.

Дополнительно: поддержка Gentoo на коммерческой основе

Если вам необходима коммерческая помощь с ошибками, с любыми проблемами в Gentoo, или необходим новый ebuild, посмотрите на список профессиональных консультантов Gentoo.

Пакеты/ebuild

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

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

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

Используйте кнопку Add an attachment под текстовым полем описания, чтобы прикрепить файлы в bugzilla.
  • Сперва напишите точную версию пакета в заголовке отчета, например sys-apps/package-2.3-r4
  • Добавьте в заголовок краткое сообщение ошибки
  • Прикрепите (attach) файл журнала в /var/tmp/portage/<category>/<packagename>/temp/build.log
    • Если файл журнала слишком велик для загрузки, сожмите его:
      user $xz -9 /var/tmp/portage/<category>/<packagename>/temp/build.log
      и загрузите build.log.xz
  • Прикрепите вывод команды
    user $emerge --info <category/packagename>

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

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

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

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

  • Выполните поиск в Bugzilla перед тем, как отправлять запрос на новую версию – существует ли открытый баг? Было ли недавно обновлено локальное дерево Portage; присутствует ли новая версия в Portage?
  • Избегайте запросов новых версий после нулевого дня с выпуска релиза (подождите по крайней мере 48 часов после сообщения о выпуске)
  • Была ли новая версия действительно выпущена разработчиками, или она только отмечена в дереве исходных кодов? В некоторых проектах новую версию в дереве отмечают задолго до официального выпуска.
  • Обязательно отметьте, если новая версия компилируется и хорошо работает на вашей архитектуре. Любая другая полезная информация, которую вы предоставите, весьма приветствуется.
  • Добавьте ссылку на web-сайт проекта.
  • Предоставьте список исправленных ошибок и новых возможностей (иногда называемый changelog) или ссылку на него
  • Запишите заголовок в формате app-editors/vim-12.3.5 version bump

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

  • Требуются ли изменения в ebuild? (изменение зависимостей, удаление устаревших patch-файлов)
  • Если новая версия не требует изменения содержимого файла ebuild, отметьте это
  • Протестируйте файл ebuild в локальном оверлее перед тем как прикрепить и отправить его
  • Предоставьте патчи для предложенных изменений файла ebuild, по желанию, с объяснением изменений (имя файла должно соответствовать новому номеру версии, не старому)
  • Предоставьте дополнительные файлы (initd, unit-файлы) в качестве отдельных прикреплений (по необходимости)
  • Не вставляйте файлы ebuild или другое содержимое, относящееся к ним, прямо в комментарии; используйте прикрепления

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

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

  • Включите в отчет ссылку на веб-сайт разработчиков
  • Включите в отчет ссылку или список возможностей программы
  • Укажите предварительную категорию и имя пакета для ebuild в строке темы, например «media-gfx/inkscape ebuild request»
  • Предоставьте файл ebuild и патчи, оттестированные в локальном оверлее (помощь в этом можно получить на IRC или на форумах)

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

Пакет собирается и работает без проблем более 30 дней, но все еще отмечен как нестабильный:

  • Более подробную информацию о стабильной/нестабильной ветвях можно найти в статье KEYWORDS
  • Вы тщательно оттестировали версию, которую вы хотите сделать стабильной?
  • Существуют другие отчеты, относящиеся к этой ошибке?
  • Версия пакета была добавлена как минимум 30 дней назад?
  • Все зависимости этой версии отмечены, как стабильные?

Ядро

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

  • Какая версия ядра используется, на какой архитектуре, например gentoo-sources-3.4.2-r2 на x86_64
  • Файл конфигурации ядра следует прикрепить к отчету: /usr/src/linux/.config
  • Список всех устройств в системе можно получить с помощью команды lspci -k
  • Следует прикрепить файлы журналов ядра, содержащие информацию о его инициализации: /var/log/dmesg или /var/log/messages
Заметка
Может потребоваться осуществить kernel git-bisect для определения плохих патчей.

Другие отчеты об ошибках

Тут нет шаблонов, это относится к категории проблем вроде тех, которые возникают с captcha на wiki.gentoo.org, forum.gentoo.org недоступен, или к любым другим проблемам, не относящимся к программному обеспечению.

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

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