Съществуват още няколко файла в поддиректорията debian/ като повечето от тях са с разширение `.ex' което означава че те са примерни. Ако желаете или се налага да използвате някой от тяхните свойства, разгледайте ги и прочетете съответната документация (Policy Manual), преименувайте ги като премахнете `.ex' разширението и ако е нужно ги редактирайте заедно с файла rules. Често използваните от тях са обяснени в следващите секции.
Всякакви допълнителни детайли или несъответствие между оригиналния пакет и вашата дебианизирана версия трябва да бъдат описани тук. Dh_make създава примерен файл който изглежда така:
gentoo for Debian
----------------------
<possible notes regarding this package - if none, delete this file>
Josip Rodin <jrodin@jagor.srce.hr>, Wed, 11 Nov 1998 21:02:14 +0100
Тъй като няма какво да опишем в този файл - можем спокойно да го изтрием.
Едно от най-дразнещите неща при софтуера е, когато загубите много време и усилия, за да настроите една програма, и когато я обновите да изгубите всички промени, които сте направили по конфигурационния файл.Debian разрешава този проблем като маркира конфигурационните файлове така че когато обновявате пакета да бъдете попитан дали искате да запазите старата конфигурация или не. Това се прави като се добавя пълният път до всеки конфигурационен файл (те обикновенно са в /etc) по един на ред в файла conffiles.
Gentoo има един конфигурационен файл, /etc/gentoorc, и ние ще го добавим в файла `conffiles'. Не е нужно да имате този файл ако вашата програма няма конфигурационен файл.
Този файл указва директориите в които ще се инсталира програмата в случай че при нормалната инсталация (make install) не са създадени. По подразбиране файла изглежда така:
usr/bin
usr/sbin
Забележете че директориите не започват с `/'. Нормално е да ги променим на:
usr/X11R6/bin
usr/X11R6/man/man1
но тъй като тези директории са създадени в Makefile-а този файл не ни е нужен и можем да го изтрием.
Файловете завършващи с *.ex са примери за това как да добавим някакъв вид поддръжка в този пакет. За да използвате някой от тях премахнете .ex разширението и го редактирайте. Ако не искате да го използвате просто го изтриите.
Програмата ви трябва да има man страница. Ако няма, това е скелета върху който
можете да направите една. Вижте man страницата относно man(7) за
кратко описание как да създадете man страница. Уверете се че сте преименували
този файл на името на програмата и разширението да съответства на тази в която
искате да бъде поставена man страницата. Ето кратко описание на секциите:
Секция | Описание | Бележки
1 Потребителски команди Изпълними команди или скриптове
2 Системни извиквания Функции на kernel-а
3 Библиотечни извиквания Функции на системните библиотеки
4 Специални файлове Обикновенно се намират в /dev
5 Файлови формати Примерно формата на /etc/passwd
6 Игри Или други несериозни неща
7 Макро пакети Такива като man макроси
8 Системна Администрация Обикновенно програми стартирани само от root.
9 Kernel routines Системни извиквания и вътрешни особенности
Съответно man страницата на gentoo трябва да се казва gentoo.1 или gentoo.1x защото това е X11 програма. В оригиналния пакет няма gentoo.1 страница затова аз направих една като ползвах примерната страница и документацията от изходния код.
Потребителите на X Window System обикновенно имат window manager с меню което може да бъде настроено да стартира програми. Ако те са инсталирали Debian пакета "menu", за всяка програма ще бъдат създадени комплект менюта. Това не е задължително изискване от Debian Policy но потребителите ще го оценят. Можем да добавим Gentoo в менютата като редактирамето този файл. Ето примерния файл който създава dh_make:
?package(gentoo):needs=X11|text|vc|wm section=Apps/see-menu-manual\
title="gentoo" command="/usr/bin/gentoo"
Първото поле указва какъв вид интерфейс изисква програмата (тоест текстов или X11). Следва менюто и подменюто в което програмата трябва да се добави. Може да прочетете за списък със секциите в: /usr/share/doc/debian-policy/menu-policy.html/ch2.html#s2.1. Третото поле е името на програмата. Четвъртото е иконата на програмата или none ако няма такава. Петото поле е текста който ще се появи в менюто. И накрая в шестото поле се намира командата с която ще бъде стартирана програмата.
И така, променяме горните редове на:
?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/.
Може да го ползвате като допълнение към програмите uscan(1) и
uupdate(1) (в devscripts пакета) за наблюдение на адреса откъдето
сте взели оригиналния изходен код. Ето какво сам сложил аз:
# watch control file for uscan
# Site Directory Pattern Version Script
ftp.obsession.se /gentoo gentoo-(.*)\.tar\.gz debian uupdate
Съвет: свържете се с интернет и стартирайте "uscan" в директорията на програмата след като сте създали файла. И прочетете man страниците.
Ако вашият пакет има HTML или някакъв друг вид документация (освен man или 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.
Тези файлове се наричат скриптове на отговорника по поддръжка, скриптове които се поставят в контролната област на пакета и се стартират от dpkg когато инсталирате, обновявате или премахвате пакета.
За сега трябва да избягвате каквито и да било редакции на ръка върху тези скриптове защото са доста сложни. За повече информация погледнете в Packaging Manual, секция 6 и разгледайте примерния файл направен от dh_make.
Вече сме готови да изградим пакета.
jrodin@jagor.srce.hrgeroy@stemo.bg