Gentoo Logo

Предупреждение : Этот документ находится в разработке, и его пока не следует считать официальным.


Отправка Ebuild-скриптов

Содержание:

1.  Начало

Создание учетной записи в Bugzilla

Посетите http://bugs.gentoo.org. Это ссылка на базу данных об ошибках, под названием Bugzilla. Среди появившегося списка ссылок найдите "Open a new Bugzilla account" (то есть "Создание новой учётной записи в Bugzilla"). Если вы раньше никогда не создавали такую учётную запись (например, чтобы отправить сообщение об ошибке или дефекте), то вам надо именно туда.

Не направляйте ebuild'ы CPAN

В Portage есть средство под названием g-cpan.pl, устанавливающее заданный модуль CPAN в вашей системе Gentoo с помощью Portage, записывая необходимую информацию (такую как зависимости, перечень файлов и т.д.) в базе данных Portage, так же как при установке ebuild'а. Следовательно, направлять ebuild'ы CPAN не требуется (и не рекомендуется).

За дополнительными сведениями по g-cpan.pl, обращайтесь к его странице справки.

2.  Передача Ebuild-скрипта

Создание сообщения об ошибке

Внизу главной страницы или страницы, на которую вы сразу попадете, есть желтое поле. Выберите ссылку New - Expert или просто перейдите на http://bugs.gentoo.org/enter_bug.cgi. Любой из этих способов приведёт вас на страницу Enter Bug (то есть "Ввод сообщения об ошибке").

Примечание: В системе Bugzilla вся информация рассматривается как сообщения об ошибке, включая даже отправленные ebuild-скрипты. Каждой ошибке назначается свой идентификатор. Запомните это, особенно если у вас есть другие ebuild-скрипты, зависимые от данного пакета.

Bugzilla может работать сразу с несколькими проектами. Для примера - проект Gentoo, другие же проекты могут включать в себя документацию или утилиты для администрирования сайтов. Для отправки Ebuild-скриптов из списка проектов всегда должен быть выбран Gentoo Linux.

При щелчке на Gentoo Linux должна появится форма заполнения сообщения об ошибке.

Заполнение формы сообщения об ошибке

Первое поле в форме - это версия. Если вы знаете, какая версию у вашего пакета - то можете её туда вписать, если нет - то выберите unspecified. Затем выберите тип посылаемого компонента. Все ebuild-скрипты имеют тип Ebuild.

Важно: Для ebuild-скриптов всегда должен быть выбран тип компонента Ebuild. Может показаться, что такие категории как GNOME, Libraries и Server могут относиться к вашему ebuild-скрипту, но они созданы для фильтрации сообщений об ошибках в соответствующих пакетах, а не для отправки новых ebuild-скриптов.

Категории Platform, OS и Priority не должны быть установлены для ebuild-скрипта.

В поле Severity должно быть установлено значение enhancement

Оставьте поле Assigned To пустым. Если вы не меняли настройки почтового уведомления Вugzilla, то вы, как автор запроса, будете автоматически получать сообщения об изменении запроса.

Заполните поле Summary краткой информацией - какой пакет был добавлен, новый ли это пакет или просто обновление. Что-то вроде следующего: foo-bar-x.y.z.ebuild (New Package) или foo-x.y.z.ebuild (Update)

По возможности было бы хорошо, если поле Description было заполнено как можно подробней. Вот пример сообщения об ошибке номер 7.

Листинг 2.1: Пример описания

Hi!

Please find attached gramps.tar.gz containing gramps-0.7.0.ebuild and a
patch so that it will compile against python-2.2

gramps is the Genealogical Research and Analysis Management Programming
System.  It is a very cool gnome/python app.  If you are in the US, you
can head over to 
http://www.familysearch.com/
and you can probably find a GEDCOM file for your family tree to import
into gramps. (Mormons sure do like geneaology)

I suggest app-misc/gramps Also, this ebuild depend on Imaging and ReportLab
previously submitted

tod

После того как всё выполнено, щелкните на кнопке Commit.

Присоединение ebuild-скрипта

Нажав кнопку submit со страницы Enter Bug, вы перейдёте на страницу Posting Bug, получив номер об ошибке.

Внизу этой страницы есть ссылка Create a new attachment (то есть "приложить новый файл"). Щёлкните по ней.

Выберите нужный файл, используя текстовую форму или диалог Обзор (Browse). В поле Description укажите имя ebuild-файла, подобно тому как вы это делали в поле Summary на предыдущей странице.

Конечно, тип содержания должен быть выставлен в "text/plain", а кнопка select from list отмечена.

Больше здесь ничего не требуется, жмите кнопку Submit и дело сделано!

3.  Отправка нескольких ebuild-скриптов

Зависимости

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



Для печати

Обновлено 24 октября 2005

Аннотация: В этом руководстве объясняется, как направить нам свой сборочный сценарий ebuild с использованием системы Bugzilla.

Matt Butcher
автор

Иван Зенков
переводчик

Donate to support our development efforts.

Copyright 2001-2012 Gentoo Foundation, Inc. Questions, Comments? Contact us.