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

Программа dh_make создала файл, похожий на этот:

gentoo for Debian
-----------------
<possible notes regarding this package - if none, delete this file>
 -- Josip Rodin <joy-mg@debian.org>, Wed, 11 Nov 1998 21:02:14 +0100

Если вам нечего сюда написать, удалите этот файл. Смотрите dh_installdocs(1).

Файл compat определяет уровень совместимости debhelper. В настоящее время вы должны указывать уровень debhelper v7 следующим образом:

$ echo 7 > debian/compat

Бывает очень обидно, когда тратишь много времени и усилий на настройку программы, а при очередном обновлении все настройки исчезают. Debian предлагает решение этой проблемы через механизм пометки файлов как настроечных — conffiles ^[55]. Для таких файлов при обновлении пакета вам будет задан вопрос, нужно ли заменить старые файлы теми, что включены в новый пакет.

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

Если ваша программа не только использует файлы настройки, но и изменяет их, будет лучше не отмечать их как conffiles, так как в этом случае dpkg каждый раз будет просить пользователя проверить изменения.

Если программа, которую вы упаковываете, требует от пользователя изменить файлы настройки в каталоге /etc, существует два популярных способа не отмечать их как conffiles, чтобы подавить вопросы со стороны dpkg:

Информацию о сценариях сопровождающего смотрите в Раздел 5.19, «Файлы {pre|post}{inst|rm}».

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

Большинство этих файлов являются сценариями оболочки, за исключением пакет.cron.d, который должен иметь формат crontab(5).

Для архивирования журнальных файлов никаких файлов cron.* задавать ненужно — для этого есть другие средства (смотрите dh_installlogrotate(1) и logrotate(8)).

В этом файле указываются каталоги, которые необходимы для обычной установки (make install DESTDIR=..., вызываемая dh_auto_install), но которые автоматически не создаются. Обычно, это указывает на проблему в Makefile.

Файлы, указанные в файле install, не нуждаются в предварительном создании каталогов. Смотрите Раздел 5.11, «Файл install».

Для начала лучше попробовать запустить установку и использовать этот файл, только если есть проблемы. В начале имён каталогов, перечисляемых в файле dirs, косая черта не указывается.

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

Обычно, к таким файлам относятся файлы в форматах HTML, PS и PDF, помещаемые в /usr/share/doc/имяпакета/.

Вот как выглядит файл gentoo, входящий в пакет gentoo.doc-base:

Document: gentoo
Title: Gentoo Manual
Author: Emil Brink
Abstract: This manual describes what Gentoo is, and how it can be used.
Section: File Management
Format: HTML
Index: /usr/share/doc/gentoo/html/index.html
Files: /usr/share/doc/gentoo/html/*.html

Формат этого файла описан в справочной странице install-docs(8), а также в локальной копии руководства Debian по doc-base из пакета doc-base.

Подробная информация по установке дополнительной документации приведена в Раздел 3.3, «Установка файлов в их каталоги назначения».

В этом файле указаны имена файлов документации, которые можно установить во временный каталог с помощью dh_installdocs(1).

По умолчанию будут включены все файлы, имеющиеся в самом верхнем каталоге с исходным кодом, а именно BUGS, README*, TODO и т.д.

Для пакета gentoo также включаются несколько других файлов:

BUGS
CONFIG-CHANGES
CREDITS
NEWS
README
README.gtkrc
TODO

В этом файле указываются файлы для Emacs, которые могут быть скомпилированы во время установки пакета.

Они устанавливаются во временный каталог при помощи dh_installemacsen(1).

Если они вам не нужны, удалите их.

Команда dh_installexamples(1) устанавливает файлы и каталоги, указанные в этом файле, как файлы примеров.

Если ваш пакет содержит службу и её необходимо запускать при старте системы, вероятнее всего, вы не обратили внимания на мой изначальный совет, не так ли? :-)

Файл пакет.init устанавливается как сценарий /etc/init.d/пакет для запуска и остановки службы. Довольно общий его шаблон создаётся командой dh_make в файле init.d.ex. Вам придётся его переименовать и отредактировать, обеспечив соблюдение стандарта заголовка согласно Linux Standard Base (LSB). Он устанавливается во временный каталог с помощью dh_installinit(1).

Файл пакет.default будет установлен в /etc/default/пакет. В этом файле хранятся значения по умолчанию, используемые сценарием инициализации. В большинстве случаев, файл пакет.default используется для отключения запуска службы, установки некоторых флагов по умолчанию или времени ожидания. Если ваш сценарий инициализации имеет какие-либо настраиваемые параметры, вам надо поместить их в файл пакет.default, а не в сам сценарий запуска.

Если с оригинальной программой поставляется сценарий инициализации, то вы можете использовать и его. Если он вам не подходит, то создайте свой в файле с именем пакет.init. Однако, если оригинальный сценарий инициализации хорошо написан и устанавливается в правильное место, вам всё ещё нужно установить символьные ссылки в rc*. Для этого замените dh_installinit в файле rules на следующие строки:

override_dh_installinit:
        dh_installinit --onlyscripts

Если сценарий инициализации не требуется, удалите эти файлы.

Если есть файлы, которые необходимо установить в пакет, но стандартная команда make install не делает этого, поместите их имена и пути назначения в файл install. Они устанавливаются при помощи dh_install(1)^[56]. В первую очередь, вы должны проверить, нет ли более подходящего способа это сделать. Например, файлы документации должны находиться в файле docs, а не в этом.

В файле install для каждого устанавливаемого файла отводится одна строка; в ней задаётся имя файла (относительно верхнего каталога сборки), потом пробел, потом установочный каталог (относительно каталога установки). Например, если при установке не устанавливается src/bar, то файл install будет выглядеть так:

src/bar usr/bin

В результате после установки пакета в системе появится исполняемая команда /usr/bin/bar.

Также, в файле install можно указывать только имя файла без каталога установки, если не менялся относительный путь. Такой формат, обычно, используется для большого пакета, в котором результат сборки разбивается на несколько двоичных пакетов; список устанавливаемых файлов помещается в соответствующий файл пакет-1.install, пакет-2.install и т.д.

Если команда dh_install не находит файлы в текущем каталоге, то она ищет их в debian/tmp (или в любом другом месте, указанном в --sourcedir).

Если у вашего пакета есть страницы в формате info, то их нужно устанавливать при помощи dh_installinfo(1), перечислив их в файле пакет.info.

Если вам, как сопровождающему пакета, нужно создать дополнительные символьные ссылки в каталогах сборки пакета, установите их с помощью dh_link(1), перечислив полные пути файлов источника и назначения в файле пакет.links.

Если lintian находит ошибки, хотя для этого случая в политике Debian разрешены исключения, то можно использовать файл пакет.lintian-overrides или source/lintian-overrides, чтобы убрать подобные сообщения. Прочтите руководство пользователя Lintian (/usr/share/doc/lintian/lintian.html/index.html) и не сообщайте о некорректности работы программы проверки.

Файл пакет.lintian-overrides предназначен для двоичного пакета и устанавливается в usr/share/lintian/overrides/пакет с помощью команды dh_lintian.

Файл source/lintian-overrides предназначен для пакета с исходным кодом. Он не устанавливается.

Для каждой программы должна быть справочная страница. Если её нет, её необходимо создать. Команда dh_make создаёт несколько шаблонов справочных страниц. Они должны быть скопированы и отредактированы для каждой команды, не имеющей собственной справочной страницы. Проверьте, что удалили неиспользованные шаблоны.

Если ваш пакет содержит справочные страницы, то их следует устанавливать с помощью dh_installman(1), перечислив в файле пакет.manpages.

Чтобы установить справочную страницу doc/gentoo.1 для пакета gentoo, создайте следующий файл gentoo.manpages:

docs/gentoo.1

Пользователи X Window System, обычно, используют диспетчеры окон с меню, которое может быть настроено для запуска программ. Если у них установлен пакет Debian menu, то каждая установленная программа будет доступна из меню.

Вот стандартный файл menu.ex, который создала программа dh_make:

?package(gentoo):needs=X11|text|vc|wm \
        section=Applications/see-menu-manual\
        title=gentoo command=/usr/bin/gentoo

Первое поле после двоеточия — это needs, которое указывает тип интерфейса, необходимого программе. Измените его на приведённые варианты, например text или X11.

В поле section задаются пункты меню и подменю, где должна появиться программа ^[58].

В поле title указывается название программы. Вы можете начать его с заглавной буквы, если вы хотите. Используйте короткое название.

И, наконец, поле command — команда, которая запускает программу.

Давайте переименуем файл в menu и изменим запись в меню:

?package(gentoo): needs=X11 \
        section=Applications/Tools \
        title=Gentoo command=gentoo

Также вы можете добавить другие поля, такие как longtitle, icon, hints и т.д. Подробную информацию можно найти в dh_installmenu(1), menufile(5), update-menus(1) и в дополнительной политике Debian по меню.

Этот файл устанавливается командой dh_installchangelogs(1).

Файлы postinst, preinst, postrm и prerm ^[59] называются сценариями сопровождающего. Эти сценарии находятся в управляющей области пакета и запускаются программой dpkg при установке, обновлении или удалении пакета.

Как начинающему сопровождающему вам следует избегать ручной правки сценариев сопровождающего, так как они имеют тенденцию усложняться. Более подробную информацию смотрите в руководстве по политике Debian, глава 6 «Сценарии сопровождающего пакета и процесс установки», и взгляните на файлы примеров