Файл conffiles

Одна из самых неприятных (и раздражающих) вещей, которая может случиться, это когда вы потратили очень много времени и усилий на то, чтобы настроить программу, а при очередном обновлении все ваши настройки исчезли. Debian предлагает решение этой проблемы, через специальный механизм работы с конфигурационными файлами: все конфигурационные файлы должны быть помечены как таковые, это позволит при обновлении проверить не изменились ли данные файлы, и, если они изменились, спросить у вас, нужно ли заменить старые конфигурационные файлы теми, что пришли в новом пакете. Для того, чтобы это сделать это, вы должны в файле conffiles указать полные пути к каждому конфигурационному файлу (обычно они находятся в каталоге /etc). Одни файл в одной строчке.

У программы gentoo есть только один конфигурационный файл — /etc/gentoorc — и мы укажем его в файле conffiles. Если у вашей программы нет конфигурационных файлов, вам этот файл не нужен.

Файл dirs

Этот файл содержит названия каталогов, которые необходимы, но которые не создаются командой установки программы (‘make install’).

По умолчанию, он содержит следующие строки: usr/bin usr/sbin

Заметьте, что начальный символ ‘косая черта’ отсутствует. В нашем случае, необходимо изменить этот файл следующим образом: usr/X11R6/bin usr/X11R6/man/man1

но эти каталоги создаются командой ‘make install’, поэтому нам этот файл не нужен и мы можем его легко удалить.

Файл ex.doc-base

Если ваш пакет содержит документацию (отличную от страниц Руководства или info-файлов), вы должны воспользоваться файлом doc-base для того, чтобы ее зарегистрировать в системе. Это позволит пользователю найти ее при помощи программ dhelp(1), dwww(1) и, возможно, другими.

Вот как выглядит файл doc-base, входящий в пакет gentoo: Document: gentoo Title: Gentoo Manual Author: Emil Brink Abstract: This manual describes what Gentoo is, and how it can be used. Section: Apps/Tools

Format: HTML Index: /usr/share/doc/gentoo/html/index.html Files: /usr/share/doc/gentoo/html/*.html

Формат этого файла описан в странице Руководства install-docs(8), а также в документации, входящей в пакет doc-base (см. файл /usr/doc/doc-base/doc-base.html/index.html).

Файл manpage.1.ex

Файлы, имеющие расширение .ex, представляют собой примеры тех дополнительных файлов, которые вам могут понадобится. Для того, чтобы воспользоваться ими, удалите расширение .ex. Если вы не собираетесь их использовать, просто удалите их!

Для вашей программа должна присутствовать страница Руководства. Если ее нет, вы должны заполнить шаблон manpage.1.ex. Краткое описание того, как создавать страницы Руководства, смотрите в man(7). Не забудьте переименовать этот файл, чтобы его имя соответствовало имени программы, а расширение — разделу Руководства, в который должна попасть данная страница. Вот короткий список разделов: Раздел | Описание | Примечание 1 Команды пользователя Программы и сценарии 2 Системные вызовы Функции, предоставляемые ядром 3 Библиотечные вызовы Функции, предоставляемые различными библиотеками 4 Специальные файлы Обычно файлы в каталоге /dev 5 Форматы файлов Например, формат файла /etc/passwd 6 Игры Или другие развлекательный программы 7 Макро пакеты Например, макросы пакета man 8 Системное администрирование Программы, которые обычно запускаются только пользователем root 9 Kernel routines Нестандартные вызовы и информация о внутреннем строении

Таким образом, страница Руководства для программы gentoo должна называться gentoo.1 или gentoo.1x, так как это программа. В исходных текстах страница Руководства отсутствовала, поэтому нам пришлось написать собственную, используя информацию из файла примера и документации к программе.

Файл menu.ex

Пользователи X Window System обычно используют диспетчеры окон, которые поддерживают меню программ. Если у них установлен пакет menu, им станет доступным набор стандартных меню для каждой установленной программы. Это не является обязательным с точки зрения «Политики Debian», но обычно пользователи с удовольствием используют данную возможность. Мы можем добавить меню для программы gentoo, соответствующим образом подправив данный файл. Вот, что создала программа dh_make: ?package(gentoo):needs=X11|text|vc|wm section=Apps/see-menu-manual\ title="gentoo" command="/usr/bin/gentoo"

Значение первого поля указывает тип интерфейса, требуемого для программы (например, текст (text) или X11). Затем перечислены путь в меню, где должна появиться соответствующая запись. Актуальный список разделов доступен в как /usr/share/doc/debian-policy/menu-policy.html/ch2.html#s2.1. Третье поле — название программы. Четвертое — название файла со значком для программ (или отсутствует, если значка нет). Пятое — текст, который появится в меню. И, наконец, шестое — команда, которая запускает программу.

В нашем случае, данный файл будет выглядеть так: ?package(gentoo):needs=X11 section=Apps/Misc \ title="Gentoo" command="/usr/X11R6/bin/gentoo"

Для дополнительной информации смотрите menufile(5), update-menus(1) и /usr/share/doc/debian-policy/menu-policy.html/.

Файл README.Debian

Любая дополнительная информация, а также различия между программой в вашем пакете и исходной программой должны быть описаны в файле README.Debian. Программа dh_make создает файл, похожий на этот: gentoo for Debian ----------------------

Josip Rodin <jrodin@jagor.srce.hr>, Wed, 11 Nov 1998 21:02:14 +0100

Так как в нашем примере нам нечего поместить в этот файл, мы его удалим.

Файл watch.ex

Данный файл может быть использован программами uscan(1) и uupdate(1) (они предоставляются пакетом devscripts) для отслеживания серверов, откуда вы загрузили исходные тексты программы. Вот, например, что находится в этом файле в пакете gentoo: # watch control file for uscan # Site Directory Pattern Version Script ftp.obsession.se /gentoo gentoo-(.*)\.tar\.gz debian uupdate

Совет: подсоединитесь к Интернету и попробуйте запустить программу uscan, находясь в каталоге программы после того, как вы создали этот файл. И прочитайте документацию на эту программу!

Файлы postinst.ex, preinst.ex, postrm.ex, prerm.ex

Эти файлы называются служебными сценариями, те сценариями, которые попадают в управляющую область пакета, и которые запускаются программой dpkg в момент, когда ваш пакет устанавливается, обновляется или удаляется.

Возможно, пока вам следует избегать создания этих сценариев, так как они имеют тенденцию усложняться со временем. Подробную информацию вы можете найти в «Руководстве по созданию пакетов», раздел 6; также просмотрите файлы примеров, созданные программой dh_make.

Теперь все должно быть готово к построению пакета.

[ назад ] [ Содержание ] [ 1 ] [ ] [ 3 ] [

] [ 5 ] [ 6 ] [ вперед ]

Руководство начинающего разработчика Debian версия 1.0.2, 10 June 2001 (?)
Josip Rodin jrodin@jagor.srce.hr
Перевод: Михаил Соболев, mss@transas.com
Перевод: Алексей Выскубов, alexey@pepper.spb.ru

postamble();

Руководство начинающего разработчика Debian - Другие файлы в каталоге debian/

В каталоге debian/ вы также можете найти другие файлы, большинство их которых имеет расширение .ex, который означает, что соответствущий файл является примером. Если вам необходимы те или иные дополнительные свойства у пакета, просмотрите эти файлы и прочитайте соответствующую документацию (подсказка: документ называется «Политика Debian»). Вы должны переименовать необходимые файлы, убрав расширение .ex, а затем изменить их и, если необходимо, файл debian/rules. Некоторые из этих файлов — те, что достаточно часто используются — описаны ниже.