Ръководство на новите отговорници по поддръжка на Debian
Chapter 1 Начало "Правилният Начин"

Този документ ще се опита да опише изграждането на Debian GNU/Linux пакет на обикновения Debian потребител (и този който иска да стане разработчик) на разбираем език и добре допълнен с примери.

Едно от нещата което прави Debian добра дистрибуция е пакетната система. Въпреки че голяма част от софтуера може да се намери в Debian формат, все някога се налага да инсталирате нещо на което няма .deb пакет. Може би се чудите как може да си направите собствен .deb пакет и вероятно мислите, че е много трудно. Е, ако сте наистина нов в Linux, трудно е, но ако сте начинаещ предполагам няма да четете в момента този документ. :-). Трябва да знаете малко относно Unix програмирането но не се изисква да сте магьосник.

Най-новите версии на този документ могат да бъдат намерени винаги на адрес: http://www.debian.org/doc/maint-guide и в `maint-guide' пакета.

1.1 Програми нужни за разработка

Преди да започнете, уверете се че сте инсталирали допълнителните пакети нужни за разработка. Забележете, че списъкът не съдържа пакети маркирани като `essential' или `required - очакваме че вече ги имате инсталирани.

Този документ беше написан когато официалната стабилна дистрибуция на Debian беше 2.1 `slink' но не вярвам да срещнете затруднения ако имате =>2.2 `potato' защото пакетите са именувани почти по същия начин.

Следните пакети са инсталирани при стандартна инсталация на Debian 2.1, така че вероятно ги имате (и допълнителните пакети от които зависят) вече. Все пак по добре е да проверите чрез `dpkg -s <package>`.

• binutils - нужни за свързване на обектни файлове - с тях се правят програмите :). (виж `info binutils`)
• cpp - C предпроцесор. (виж cpp(1))
• cpio - това е архиватор като tar или zip. (виж cpio(1))
• dpkg-dev - този пакет съдържа инструменти които са нужни за разкомпресирането, изграждането и "качването" на Debian пакети с изходен код. (виж dpkg-source(1))
• file - тази полезна програмка определя какъв вид е файла. (виж file(1))
• gcc - GNU C компилатор. Повечето от Linux програмите са написани на C. Ако вашата програма е написана на някой друг език като C++, Fortran, Pascal, трябва да инсталирате съответно g++, g77, или gpc . (виж gcc(1), g++(1), g77(1), gpc(1))
• libc6-dev - C библиотеките и .h файловете които са нужни на gcc при компилирането. Въпреки че някой програми препоръчват да използвате libc5, чувствайте се насърчени да използвате по-новата версия (libc6). (виж `info libc`)
• make - обикновенно създаването на една програма преминава през няколко стъпки. Вместо да въвеждате едни и същи команди по няколко пъти може да ползвате тази програма за автоматизиране на този процес чрез `Makefile'-овете. Някои програми използват imake и xmkmf които генерират Makefile-ове на базата на макро функции. Повечето нови програми използват конфигуриращи скриптове създавани чрез програми като autoconf и automake, така че може би ще ви се наложи да инсталирате и тях. (виж `info make`, imake(1), xmkmf(1), autoconf(1), automake(1))
• patch - тази много полезна програма ще вземе файл който съдържа списък с различията (направен чрез програмата diff) и ще вмъкне промените в оригиналния файл. (виж patch(1))
• perl5 - Perl е най-използвания скрипт език в днешните un*x системи, често наричан "Швейцарската резачка на Unix" :-). (виж perl(1))

От секцията `devel' вероятно ще се наложи сами да инсталирате следните неща:

• dh-make и debhelper - dh-make е нужен за създаването на скелета на нашия примерен пакет и той ще използва някои от инструментите на debhelper за създаване на пакетите. Те не са жизнено важни за създаването на пакетите, но силно се препоръчват за новите отговорници по поддръжка. Като цяло улеснява процеса на създаването и контролирането на пакета. (виж dh_make(1), debhelper(1), /usr/share/doc/debhelper/README)
• devscripts - този пакет съдържа полезни скриптове са за улеснение на отговорниците по поддръжка, но не са необходими за създаването на пакетите. (виж /usr/share/doc/devscripts/README.gz)
• fakeroot - тази програмка ви позволява да излъжете че сте root което е нужно за някои части от процеса на изграждане. (виж fakeroot(1))
• lintian - това е програма която проверява за грешки след като сте изградили вашият Debian пакет и ако има грешки дава подробна информация за тях. (виж lintian(1), /usr/share/doc/lintian/lintian.html/index.html)

И накрая, следните много важни пакети са и тези от doc секцията:

• debian-policy - включва структурата и съдържанието на архива, няколко документа относно архитектурата на операционната система, стандарт за йерархия на файловата система (fhs, the Filesystem Hierarchy Standard) и най-важното за вас е описанието за изискваните неща които един пакет трябва да има за да бъде включен в дистрибуцията Debian.(виж /usr/share/doc/debian-policy/policy.html/index.html)
• developers-reference - за всичко онова, което не се отнася точно за техническите детайли по правенето на пакети, като напр. описание на структурата на архива, как да преименуваме, да изоставяме правилно пакети, които нямаме възможност повече да поддържаме, да поемем поддържането на даден пакет, да качваме (upload) правилно чужди пакети, как да подържаме съобщенията за грешки в пакетите ни, кога и къде да upload-ваме ... и т.н. (виж /usr/share/doc/developers-reference/developers-reference.html/index.html)
• packaging-manual - описва техническите аспекти на създаването на Debian binary и source пакети. (виж /usr/share/doc/packaging-manual/packaging.html/index.html)

Също така ще се нуждаете от пакет за шифроване като PGP (pgp-* пакетите) или GPG (gnupg пакетът), за да можете да подпишете вашите пакети. Това е важно ако искате да ги направите достъпни за всички (и сигурно точно това ще правите ако вашият труд бъде включен в Debian дистибуцията). Но поради доста странния U.S. закон няма да можете просто да свалите тези пакети от най-близкия огледален FTP сървър на Debian. Ще трябва да го направите от non-US.debian.org (ftp://non-us.debian.org/debian-non-US/) който се намира извън US. Във всеки FTP сървър има един файл наречен README.non-US, в който е указано как да намерите най-близкия за вас non-US огледален сайт.

Краткото описание дадено по-горе е само за да ви упъти кой пакет какво върши. Преди да продължите, моля прочетете доументацията за всяка от програмите. Може да ви се вижда доста трудно засега, но по-късно ще се радвате че сте ги прочели. Забележка: debmake е пакет който съдържа програми който действат по аналогичен начин на dh-make, но неговото използване не е разгледано в този документ. Вижте the Debmake manual за повече информация.

1.2 Друга информация

Има два типа пакети които може да правите - source и binary. Source пакетът съдържа изходния код който може да компилирате в програма. Binary пакетът съдържа просто компилираната програма. Не смесвайте термини като изходен код на програмата (source of the program) и изходен пакет на програмата! (source package of the program) Моля прочетете други документации ако имате нижда от повече детайли за терминологията.

В Debian терминът `maintainer' се използва за човек който прави пакети, `upstream author' за човек който поддържа програма извън Debian проекта. Обикновенно авторът и upstream maintainer са един и същ човек, а понякога и дори `maintainer' е същия човек. Ако сте направили програма и искате тя да бъде включена в Debian чувствайте се свободен да кандидатствате за maintainer.

След като сте изградили пакет (или докато го правите), трябва да станете официален Debian maintainer ако искате програмата да бъде включена в следващата дистибуция (ако програмата е полезна, защо не?). Този процес е обяснен в Ръководство на Разработчика. Моля прочетете го.