maint-guide 1.2.30 - en to ru translation catalogue (919 entries)

note: type: Attribute 'lang' of: <book>
en: en
ru: ru

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
ru: Руководство начинающего разработчика Debian

note: type: Content of: <book><bookinfo><authorgroup><author><personname>
en: Josip Rodin
ru: Джосип Родин

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
ru: первоначальный вариант

note: type: Content of: <book><bookinfo><authorgroup><author><personname>
en: Osamu Aoki
ru: Осаму Аоки

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
ru: обновлённый вариант

note: type: Content of: <book><bookinfo><releaseinfo>
en: version &docversion;
ru: версия &docversion;

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
ru: Данный документ создан на основе следующих двух документов:

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
ru: Хорошее начало — половина дела

note: type: Content of: <book><chapter><para>
en: This document tries to describe the building of a Debian package to ordinary Debian users and prospective developers.  It uses fairly non-technical language, and it's well covered with working examples.  There is an old Latin saying: <emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> (It's a long way by the rules, but short and efficient with examples).
ru: В этом документе описан процесс создания пакета Debian с точки зрения обычного пользователя и начинающего разработчика. Он написан простым языком и содержит работающие примеры. В этом руководстве мы пытаемся следовать старой латинской поговорке: <emphasis>Longum iter est per praecepta, breve et efficax perexempla!</emphasis> (Путь длинен, если изучать правила, но короток и эффективен, если пользоваться примерами!).

note: type: Content of: <book><chapter><para><footnote><para>
en: The document assumes you are using a <literal>&base-release;</literal> or newer system.  If you need to follow this text in an older system (including an older Ubuntu system etc.), you must install backported <systemitem role="package">dpkg</systemitem> and <systemitem role="package">debhelper</systemitem> packages, at least.
ru: В документе предполагается, что вы используете <literal>&base-release;</literal> или более новую версию. Если у вас старая версия (включая старые выпуски Ubuntu и т.д.), установите современные версии пакетов <systemitem role="package">dpkg</systemitem> и <systemitem role="package">debhelper</systemitem> из специального репозитория (backports).

note: type: Content of: <book><chapter><para><footnote><para>
en: You can learn about the basic handling of a Debian system from the <ulink url="&debref;">Debian Reference</ulink>.  It contains some pointers to learn about Unix programming, too.
ru: О том, как работать с системой Debian, можно найти в <ulink url="&debref;">справочнике Debian</ulink>. В нём также содержатся ссылки на материалы по программированию в системах Unix.

note: type: Content of: <book><chapter><para>
en: One of the things that makes Debian such a top-notch distribution is its package system.  While there is a vast quantity of software already in the Debian format, sometimes you need to install software that isn't.  You may be wondering how you can make your own packages; and perhaps you think it is a very difficult task.  Well, if you are a real novice on Linux, it is hard, but if you were a rookie, you wouldn't be reading this document now&nbsp;:-)  You do need to know a little about Unix programming but you certainly don't need to be a wizard.  <placeholder type="footnote" id="0"/>
ru: Одна из сильных, по сравнению с другими дистрибутивами, сторон Debian — это система управления пакетами.  Несмотря на то, что для Debian уже существует очень много пакетов, может случиться так, что вам понадобится установить программу, для которой не существует соответствующего пакета. Это может заставить вас задуматься о том, как создать свой собственный пакет. Для тех, кто делает первые шаги в Linux, это сложно, но вы к ним не относитесь, если сейчас читаете этот документ&nbsp;:-) Вам понадобятся некоторые знания о программировании под Unix, но ни в коем случае вы не обязаны быть гуру <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><para>
en: One thing is certain, though: to properly create and maintain Debian packages takes many hours.  Make no mistake, for our system to work the maintainers need to be both technically competent and diligent.
ru: Одно можно сказать определённо: создание и сопровождение пакетов Debian занимает много времени. Несомненно, чтобы наша система работала, сопровождающие должны быть технически грамотными и прилежными.

note: type: Content of: <book><chapter><para>
en: Newer versions of this document should always be available online at <ulink url="&maint-guide;"/> and in the <systemitem role="package">maint-guide</systemitem> package.  The translations may be available in packages such as <systemitem role="package">maint-guide-es</systemitem>.  Please note that this documentation may be slightly outdated.
ru: Самые новые версии этого документа всегда доступны на странице <ulink url="&maint-guide;"/> и в пакете <systemitem role="package">maint-guide</systemitem>. Переводы доступны в отдельных пакетах, например <systemitem role="package">maint-guide-es</systemitem>. Заметим, что данный документ может быть слегка устаревшим.

note: type: Content of: <book><chapter><para>
en: Since this is a tutorial, I choose to explain each detailed step for some important topics.  Some of them may look irrelevant to you.  Please be patient.  I have also intentionally skipped some corner cases and provided only pointers to keep this document simple.
ru: Так как это учебное пособие, каждый важный вопрос будет объясняться последовательно, шаг за шагом. Некоторые из них могут показаться вам ненужными. Будьте терпеливее. Также, для упрощения документа были намеренно опущены некоторые крайние случаи и приведены только ссылки.

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
ru: Социальная динамика Debian

note: type: Content of: <book><chapter><section><para>
en: Here are some observations of Debian's social dynamics, presented in the hope that it will prepare you for interactions with Debian:
ru: Вот некоторые наблюдения за социальной динамикой Debian, представленные в надежде, что это подготовит вас к взаимодействию с Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
ru: Все занимаются Debian на добровольной основе.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
ru: Вы не можете указывать другим что делать.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
ru: Вы сами должны быть заинтересованы что-то делать.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
ru: Движущая сила — дружественное сотрудничество.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
ru: Ваш вклад не должен перенапрягать остальных.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
ru: Ваш вклад полезен, если так посчитают остальные.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
ru: Debian — это не школа, где вы автоматически получите внимание учителей.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
ru: Вы должны быть способны учиться самостоятельно.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
ru: Внимание других добровольцев — очень дефицитный ресурс.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
ru: Debian постоянно улучшается.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
ru: От вас ожидают высококачественных пакетов.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
ru: Вы сами должны адаптироваться к изменениям.

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
ru: Есть несколько групп людей, взаимодействующих в Debian друг с другом в различных качествах:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
ru: <emphasis role="strong">автор программы (upstream author)</emphasis> — человек, который создал программу.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
ru: <emphasis role="strong">сопровождающий программы (upstream maintainer)</emphasis> — человек, который сопровождает программу в настоящее время.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">maintainer</emphasis>: the person making the Debian package of the program.
ru: <emphasis role="strong">сопровождающий (maintainer)</emphasis> — человек, который создал для программы пакет Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">sponsor</emphasis>: a person who helps maintainers to upload packages to the official Debian package archive (after checking their contents).
ru: <emphasis role="strong">поручитель (sponsor)</emphasis> — человек, который помогает сопровождающим помещать пакеты в официальный архив пакетов Debian (после проверки их содержимого).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">mentor</emphasis>: a person who helps novice maintainers with packaging etc.
ru: <emphasis role="strong">наставник (mentor)</emphasis> — человек, который помогает новым сопровождающим в пакетировании и т.п.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Developer</emphasis> (DD): a member of the Debian project with full upload rights to the official Debian package archive.
ru: <emphasis role="strong">разработчик Debian</emphasis> (DD) — человек, являющийся участником проекта Debian. У него есть право на размещение пакетов в официальном архиве пакетов Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Maintainer</emphasis> (DM): a person with limited upload rights to the official Debian package archive.
ru: <emphasis role="strong">сопровождающий Debian</emphasis> (DM) — человек, обладающий ограниченными правами на размещение пакетов в официальном архиве пакетов Debian.

note: type: Content of: <book><chapter><section><para>
en: Please note that you cannot become an official <emphasis role="strong">Debian Developer</emphasis> (DD) overnight, because it takes more than technical skill.  Please do not be discouraged by this.  If it is useful to others, you can still upload your package either as a <emphasis role="strong">maintainer</emphasis> through a <emphasis role="strong">sponsor</emphasis> or as a <emphasis role="strong">Debian Maintainer</emphasis>.
ru: Вы не можете стать официальным <emphasis role="strong">разработчиком Debian</emphasis> за вечер, так как для этого требуются не только технические знания. Но не унывайте. Если ваш пакет полезен другим, вы можете предложить его будучи <emphasis role="strong">сопровождающим</emphasis> через <emphasis role="strong">поручителя</emphasis> или как <emphasis role="strong">сопровождающий Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Please note that you do not need to create any new package to become an official Debian Developer.  Contributing to the existing packages can provide a path to becoming an official Debian Developer too.  There are many packages waiting for good maintainers (see <xref linkend="choose"/>).
ru: Заметим, что вам не нужно обязательно создавать новый пакет, чтобы стать официальным разработчиком Debian, для этого достаточно поддерживать существующие пакеты. Есть много пакетов, которые ждут хороших сопровождающих (смотрите <xref linkend="choose"/>).

note: type: Content of: <book><chapter><section><para>
en: Since we focus only on technical aspects of packaging in this document, please refer to the following to learn how Debian functions and how you can get involved:
ru: Этот документ описывает технические моменты пакетирования. О том, как работает Debian, и как вы можете помочь, обратите внимание на следующие страницы:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (Introductory slides)
ru: <ulink url="&logiciellibre;">Debian: 17 лет Свободного ПО, «дело-кратия» и демократия</ulink> (вступительные слайды)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianorghelp;">How can you help Debian?</ulink> (official)
ru: <ulink url="&debianorghelp;">Как помочь Debian?</ulink> (официальная страница)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - "Contributing to the Debian Project"</ulink> (semi-official)
ru: <ulink url="&debianfaqhelp;">Часто задаваемые вопросы по Debian GNU/Linux, глава 13: «Содействие проекту Debian»</ulink> (полуофициальная страница)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
ru: <ulink url="&debianwikihelp;">Страница HelpDebian в Debian Wiki</ulink> (дополнительно)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&nm-do;">Debian New Member site</ulink> (official)
ru: <ulink url="&nm-do;">Сайт нового сопровождающего Debian</ulink> (официальный)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplemental)
ru: <ulink url="&debianmentorfaq;">Список ответов на часто задаваемые вопросы наставникам Debian</ulink> (дополнительно)

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
ru: Программы, необходимые для разработки

note: type: Content of: <book><chapter><section><para>
en: Before you start anything, you should make sure that you have properly installed some additional packages needed for development.  Note that the list doesn't contain any packages marked <literal>essential</literal> or <literal>required</literal> - we expect that you have those installed already.
ru: Перед тем как начать, нужно убедиться, что установлены все необходимые для разработки пакеты. Обратите внимание, что приведённый ниже список не содержит пакеты, помеченные как <literal>обязательные</literal> (essential) или <literal>требуемые</literal> (required) — считается, что эти пакеты уже установлены на вашей машине.

note: type: Content of: <book><chapter><section><para>
en: The most important package to install on your development system is the <systemitem role="package">build-essential</systemitem> package.  Once you try to install that, it will <emphasis>pull in</emphasis> other packages required to have a basic build environment.
ru: Самый важный пакет в системе разработчика — <systemitem role="package">build-essential</systemitem>. Его установка повлечёт за собой <emphasis>загрузку</emphasis> других пакетов, требуемых для основы среды сборки.

note: type: Content of: <book><chapter><section><para>
en: For some types of packages, that is all you will require; however, there is another set of packages that while not essential for all package builds are useful to have installed or may be required by your package:
ru: Кроме пакетов, требуемых для сборки любого пакета, есть пакеты, которые нужны только для некоторых пакетов; установите их, они могут пригодиться именно для вашего пакета:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem>, and <systemitem role="package">autotools-dev</systemitem> - many newer programs use configure scripts and <filename>Makefile</filename> files preprocessed with the help of programs like these (see <literal>info autoconf</literal>, <literal>info automake</literal>).  <systemitem role="package">autotools-dev</systemitem> keeps up-to-date versions of certain auto files and has documentation about the best way to use those files.
ru: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem> и <systemitem role="package">autotools-dev</systemitem> — данные утилиты (смотрите <literal>info autoconf</literal>, <literal>info automake</literal>) используются во многих современных программах для создания сценариев настройки и файла <filename>Makefile</filename>. В пакете <systemitem role="package">autotools-dev</systemitem> содержатся самые новые версии некоторых файлов auto- и документация по их применению.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: There are also some more specialized but similar packages such as <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.
ru: Существуют также похожие, более специализированные пакеты, такие как <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem> и т.д.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debhelper</systemitem> and <systemitem role="package">dh-make</systemitem> - <systemitem role="package">dh-make</systemitem> is necessary to create the skeleton of our example package, and it will use some of the <systemitem role="package">debhelper</systemitem> tools for creating packages.  They are not essential for this purpose, but are <emphasis>highly</emphasis> recommended for new maintainers.  It makes the whole process very much easier to start, and to control afterwards.  (See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.) <placeholder type="footnote" id="0"/>
ru: <systemitem role="package">debhelper</systemitem> и <systemitem role="package">dh-make</systemitem> — пакет <systemitem role="package">dh-make</systemitem> необходим для создания скелета нашего будущего пакета. Для этого он будет использовать некоторые инструменты из пакета <systemitem role="package">debhelper</systemitem>. Использовать их необязательно, но мы <emphasis>очень</emphasis> рекомендуем их начинающим разработчикам. Они сильно упрощают процесс создания и поддержки пакетов (смотрите <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">devscripts</systemitem> - this package contains some useful scripts that can be helpful for maintainers, but they are also not necessary for building packages.  Packages recommended and suggested by this package are worth looking into.  (See <filename>&devscripts-readme;</filename>.)
ru: <systemitem role="package">devscripts</systemitem> — данный пакет содержит сценарии, полезные для сопровождающих, но так же не являющиеся необходимыми для сборки пакетов. Стоит обратить внимание на рекомендуемые и предлагаемые им пакеты (смотрите <filename>&devscripts-readme;</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">file</systemitem> - this handy program can determine what type a file is.  (See <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">file</systemitem> — данная программа позволяет определить тип файла (смотрите <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gfortran</systemitem> - the GNU Fortran 95 compiler, necessary if your program is written in Fortran.  (See <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">gfortran</systemitem> — пакет содержит компилятор GNU Fortran; требуется, если программа написана на Fortran (смотрите <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git</systemitem> - this package provides a popular version control system designed to handle very large projects with speed and efficiency; it is used for many high profile open source projects, most notably the Linux kernel.  (See <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, git Manual (<filename>&git-doc;</filename>).)
ru: <systemitem role="package">git</systemitem> — данный пакет предоставляет популярную систему контроля версий, разработанную для быстрого и эффективного сопровождения очень больших проектов; она используется во многих известных проектах с открытым кодом, наиболее заметным из которых является ядро Linux (смотрите <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, руководство по git (<filename>&git-doc;</filename>)).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gpc</systemitem> - the GNU Pascal compiler, necessary if your program is written in Pascal.  Worthy of note here is <systemitem role="package">fp-compiler</systemitem>, the Free Pascal Compiler, which is also good at this task.  (See <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">gpc</systemitem> — пакет содержит компилятор GNU Pascal, который требуется при работе с программами, написанными на Pascal. Для этой задачи также хорошо подходит <systemitem role="package">fp-compiler</systemitem>, Free Pascal Compiler (смотрите <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patch</systemitem> - this very useful utility will take a file containing a difference listing (produced by the <command>diff</command> program) and apply it to the original file, producing a patched version.  (See <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">patch</systemitem> — данная утилита изменяет исходный файл в соответствии со списком различий между файлами, полученным при помощи программы <command>diff</command> (смотрите <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patchutils</systemitem> - this package contains some utilities to work with patches such as the <command>lsdiff</command>, <command>interdiff</command> and <command>filterdiff</command> commands.
ru: <systemitem role="package">patchutils</systemitem> — данный пакет содержит несколько утилит для работы с заплатами, например <command>lsdiff</command>, <command>interdiff</command> и <command>filterdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">perl</systemitem> - Perl is one of the most used interpreted scripting languages on today's Unix-like systems, often referred to as Unix's Swiss Army Chainsaw. (See <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">perl</systemitem> — один из наиболее используемых интерпретируемых языков в Unix-системах. Его часто называют «Unix's Swiss Army Chainsaw» (швейцарской армейской пилой) (смотрите <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">python</systemitem> - Python is another of the most used interpreted scripting languages on the Debian system, combining remarkable power with very clear syntax. (See <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">python</systemitem> — ещё один из наиболее используемых интерпретируемых языков в Debian, который объединяет необычайную мощь с очень понятным синтаксисом (смотрите <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">quilt</systemitem> - this package helps you to manage large numbers of patches by keeping track of the changes each patch makes. Patches can be applied, un-applied, refreshed, and more.  (See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, and <filename>&quilt-pdf;</filename>.)
ru: <systemitem role="package">quilt</systemitem> — пакет помогает управлять большими наборами заплат, отслеживая каждое сделанное изменение. Заплаты логически организуются в стек, и вы можете накладывать их, откатывать изменения, обновлять их и т.д. (смотрите <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, <filename>&quilt-pdf;</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">xutils-dev</systemitem> - some programs, usually those made for X11, also use these programs to generate <filename>Makefile</filename> files from sets of macro functions.  (See <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ru: <systemitem role="package">xutils-dev</systemitem> — пакет содержит программы, которые используются при сборке пакетов для X11, например с их помощью генерируется <filename>Makefile</filename> из набора макрофункций (смотрите <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><para>
en: The short descriptions that are given above only serve to introduce you to what each package does.  Before continuing please read the documentation of each relevant program including ones installed through the package dependency such as <command>make</command>, at least, for the standard usage.  It may seem like heavy going now, but later on you'll be <emphasis>very</emphasis> glad you read it.  If you have specific questions later, I would suggest re-reading the documents mentioned above.
ru: Краткие описания, показанные выше, даны лишь для того, чтобы у вас сложилось общее представление о том, для чего предназначен каждый пакет. Прежде чем продолжить, полностью прочитайте документацию к каждой программе (в том числе по установленным согласно зависимостям пакетам, например <command>make</command>), по крайней мере, по основам работы. Сейчас это может оказаться слишком трудным, но позже вы будете <emphasis>очень</emphasis> довольны, что сделали это. Если позднее у вас возникнут конкретные вопросы, перечитайте документацию, упомянутую выше.

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
ru: Документация, необходимая для разработки

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>very important</emphasis> documentation which you should read along with this document:
ru: Кроме этого документа также <emphasis>очень важно</emphasis> прочитать следующую документацию:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debian-policy</systemitem> - the <ulink url="&debian-policy;">Debian Policy Manual</ulink> includes explanations of the structure and contents of the Debian archive, several OS design issues, the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS, which says where each file and directory should be), etc.  For you, the most important thing is that it describes requirements that each package must satisfy to be included in the distribution. (See the local copies of <filename>&policy-pdf;</filename> and <filename>&fhs-pdf;</filename>.)
ru: <systemitem role="package">debian-policy</systemitem> — в <ulink url="&debian-policy;">руководстве по политике Debian</ulink> содержится описание структуры и содержимого архива Debian, некоторых проблем при разработке операционной системы, <ulink url="&fhs;">стандарт иерархии файловой системы</ulink> (FHS, в котором оговаривается расположение каждого файла и каталога) и т.д. Также (что для вас важнее всего), в пакете указаны требования, которым должен удовлетворять каждый пакет Debian для того, чтобы он мог быть включён в дистрибутив (смотрите локальные файлы <filename>&policy-pdf;</filename> и <filename>&fhs-pdf;</filename>).

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>important</emphasis> documentation which you should read along with this document:
ru: Кроме этого документа также <emphasis>важно</emphasis> прочитать следующую документацию:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnu-standards</systemitem> - this package contains two pieces of documentation from the GNU project: <ulink url="&gnu-standard;">GNU Coding Standards</ulink>, and <ulink url="&gnu-maintainer;">Information for Maintainers of GNU Software</ulink>.  Although Debian does not require these to be followed, these are still helpful as guidelines and common sense.  (See the local copies of <filename>&gnu-standard-pdf;</filename> and <filename>&gnu-maintainer-pdf;</filename>.)
ru: <systemitem role="package">gnu-standards</systemitem> — в этом пакете содержатся две части документации проекта GNU: <ulink url="&gnu-standard;">стандарты написания кода GNU </ulink> и <ulink url="&gnu-maintainer;">информация для сопровождающих ПО GNU </ulink>. Хотя в Debian не требуется их соблюдения, они всё равно полезны для общего понимания (смотрите локальные файлы <filename>&gnu-standard-pdf;</filename> и <filename>&gnu-maintainer-pdf;</filename>).

note: type: Content of: <book><chapter><section><para>
en: If this document contradicts any of the documents mentioned above, they are correct.  Please file a bug report on the <systemitem role="package">maint-guide</systemitem> package using <command>reportbug</command>.
ru: Если этот документ в чём-то противоречит документам, упомянутым выше, это считается ошибкой. Отправьте сообщение об ошибке в пакете <systemitem role="package">maint-guide</systemitem> с помощью <command>reportbug</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debpkg-tutorial0;">Debian Packaging Tutorial</ulink>
ru: <ulink url="&debpkg-tutorial0;">Учебник Debian по пакетированию</ulink>

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
ru: Где искать помощь

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: files in <filename>/usr/share/doc/<replaceable>package</replaceable></filename> for all pertinent packages
ru: файлы в <filename>/usr/share/doc/<replaceable>пакет</replaceable></filename> для всех используемых пакетов

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>man</command> <replaceable>command</replaceable></literal> for all pertinent commands
ru: содержимое <literal><command>man</command> <replaceable>команда</replaceable></literal> для всех используемых команд

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>info</command> <replaceable>command</replaceable></literal> for all pertinent commands
ru: содержимое <literal><command>info</command> <replaceable>команда</replaceable></literal> для всех используемых команд

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list archive</ulink>
ru: содержимое <ulink url="&debian-mentors-ldo;">архива списка рассылки debian-mentors@lists.debian.org</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list archive</ulink>
ru: содержимое <ulink url="&debian-devel-ldo;">архива списка рассылки debian-devel@lists.debian.org</ulink>

note: type: Content of: <book><chapter><section><para>
en: You can use web search engines more effectively by including search strings such as <literal>site:lists.debian.org</literal> to limit the domain.
ru: Для более эффективного поиска с помощью поисковых машин добавьте в строку поиска <literal>site:lists.debian.org</literal> для ограничения по домену поиска.

note: type: Content of: <book><chapter><section><para>
en: Making a small test package is a good way to learn details of packaging.  Inspecting existing well maintained packages is the best way to learn how other people make packages.
ru: Создание маленького тестового пакета — хороший способ научиться пакетированию. Изучая устройство тщательно сопровождаемых пакетов, можно узнать ещё больше.

note: type: Content of: <book><chapter><section><para>
en: If you still have questions about packaging that you couldn't find answers to in the available documentation and web resources, you can ask them interactively:
ru: Если вы не смогли найти ответы на свои вопросы в документации и веб, то можете задать их интерактивно:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (This mailing list is for the novice.)
ru: в <ulink url="&debian-mentors-ldo;">список рассылки debian-mentors@lists.debian.org</ulink> (для новичков).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (This mailing list is for the expert.)
ru: в <ulink url="&debian-devel-ldo;">список рассылки debian-devel@lists.debian.org</ulink> (для опытных разработчиков).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
ru: на канале <ulink url="&irc-debian;">IRC</ulink>, например в <literal>#debian-mentors</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Teams focusing on a specific set of packages. (Full list at <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)
ru: Команды, работающие над определённым набором пакетов (полный список <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Language-specific mailing lists such as debian-devel-{french,italian,portuguese,spanish}@lists.debian.org or debian-devel@debian.or.jp. (Full listing at <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> and <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)
ru: Списки рассылки на родном языке, например debian-devel-{french,italian,portuguese,spanish}@lists.debian.org или debian-devel@debian.or.jp (полный список <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> и <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>).

note: type: Content of: <book><chapter><section><para>
en: The more experienced Debian developers will gladly help you, if you ask properly after making your required efforts.
ru: Более опытные разработчики Debian будут рады помочь вам, если на правильно зададите вопрос после попыток разобраться самостоятельно.

note: type: Content of: <book><chapter><section><para>
en: When you receive a bug report (yes, actual bug reports!), you will know that it is time for you to dig into the <ulink url="&bts;">Debian Bug Tracking System</ulink> and read the documentation there, to be able to deal with the reports efficiently.  I highly recommend reading the <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.
ru: Когда вы получите сообщение об ошибке (да, сообщения о реальных ошибках!), то знайте, что пришло время разобраться с <ulink url="&bts;"> системой отслеживания ошибок Debian</ulink> и прочитать имеющуюся там документацию, чтобы эффективно работать с сообщениями об ошибках. Настоятельно рекомендуем прочитать <ulink url="&devref-bug-handling;">справочник разработчика Debian, раздел 5.8. «Работа с ошибками»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Relax and be ready for bug reports, because there is a lot more work to be done before your package will be fully in line with Debian policies and its best practice guidelines (once again, read the <emphasis>real documentation</emphasis> for details).  Good luck!
ru: Отдохните и приготовьтесь получать сообщения об ошибках, так как много чего ещё нужно сделать для того, чтобы пакет полностью соответствовал политике Debian (ещё раз, прочитайте <emphasis>имеющуюся документацию</emphasis>). Успехов!

note: type: Content of: <book><chapter><title>
en: First steps
ru: Первые шаги

note: type: Content of: <book><chapter><para>
en: Let's start by creating a package of your own (or, even better, adopting an existing one).
ru: Давайте попробуем создать свой собственный пакет (или, ещё лучше, адаптировать существующий).

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
ru: Порядок сборки пакета Debian

note: type: Content of: <book><chapter><section><para>
en: If you are making a Debian package with an upstream program, the typical workflow of Debian package building involves generating several specifically named files for each step as follows:
ru: При создании пакета Debian из исходного кода программы в процессе сборки на каждом этапе генерируется несколько файлов со специальными именами:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
ru: получение копии исходного ПО, обычно в формате сжатого tar

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>-<replaceable>version</replaceable>.tar.gz
ru: <replaceable>пакет</replaceable>-<replaceable>версия</replaceable>.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add Debian-specific packaging modifications to the upstream program under the <filename>debian</filename> directory, and create a non-native source package (that is, the set of input files used for Debian package building) in <literal>3.0 (quilt)</literal> format.
ru: добавление специальных изменений Debian в исходную программу в каталог <filename>debian</filename> и создание неродного (non-native) пакета с исходным кодом (то есть, набора входных файлов, используемых для сборки пакета Debian) в формате <literal>3.0 (quilt)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.orig.tar.gz
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>.orig.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.debian.tar.gz
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>-<replaceable>редакция</replaceable>.debian.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><footnote><para>
en: For the older style of non-native Debian source packages in <literal>1.0</literal> format, <literal><replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.diff.gz</literal> is used instead.
ru: В старом формате <literal>1.0</literal> для неродных пакетов Debian с исходным кодом использовалось имя <literal><replaceable>пакет</replaceable>_<replaceable>версия</replaceable>-<replaceable>редакция</replaceable>.diff.gz</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.dsc
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>-<replaceable>редакция</replaceable>.dsc

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Build Debian binary packages, which are ordinary installable package files in <literal>.deb</literal> format (or <literal>.udeb</literal> format, used by the Debian Installer) from the Debian source package.
ru: сборка двоичных пакетов Debian для получения обычных файлов пакетов для установки в формате <literal>.deb</literal> (или в формате <literal>.udeb</literal>, который используется Debian Installer) из пакета Debian с исходным кодом

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>arch</replaceable>.deb
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>-<replaceable>редакция</replaceable>_<replaceable>архитектура</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: Please note that the character separating <literal><replaceable>package</replaceable></literal> and <literal><replaceable>version</replaceable></literal> was changed from <literal>-</literal> (hyphen) in the tarball name to <literal>_</literal> (underscore) in the Debian package filenames.
ru: Заметим, что в именах файлов пакетов Debian для разделения <literal><replaceable>пакета</replaceable></literal> и <literal><replaceable>версии</replaceable></literal> используется символ <literal>_</literal> (подчёркивание), а не <literal>-</literal> (дефис), как в имени оригинального tar-файла.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink>.  The <emphasis role="strong">package architecture</emphasis> follows the <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> and is automatically assigned by the package build process.
ru: Смотрите описание полей <ulink url="&policy-source;">5.6.1 «Source»</ulink>, <ulink url="&policy-package;">5.6.7 «Package»</ulink> и <ulink url="&policy-version;">5.6.12 «Version»</ulink>. Значение <emphasis role="strong">архитектуры пакета</emphasis> задаётся согласно <ulink url="&policy-architecture;">политике Debian в разделе 5.6.8, «Architecture»</ulink> и автоматически назначается в процессе сборки пакета.

note: type: Content of: <book><chapter><section><para>
en: In the file names above, replace the <literal><replaceable>package</replaceable></literal> part with the <emphasis role="strong">package name</emphasis>, the <literal><replaceable>version</replaceable></literal> part with the <emphasis role="strong">upstream version</emphasis>, the <literal><replaceable>revision</replaceable></literal> part with the <emphasis role="strong">Debian revision</emphasis>, and the <literal><replaceable>arch</replaceable></literal> part with the <emphasis role="strong">package architecture</emphasis>, as defined in the Debian Policy Manual.  <placeholder type="footnote" id="0"/>
ru: В именах файлов, представленных выше, замените часть <literal><replaceable>пакет</replaceable></literal> на <emphasis role="strong">имя пакета</emphasis>, часть <literal><replaceable>версия</replaceable></literal> на <emphasis role="strong">версию исходной программы</emphasis>, часть <literal><replaceable>редакция</replaceable></literal> на <emphasis role="strong">редакцию Debian</emphasis> и часть <literal><replaceable>архитектура</replaceable></literal> на <emphasis role="strong">архитектуру, для которой предназначен пакет</emphasis>, в соответствии с политикой Debian <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Each step of this outline is explained with detailed examples in later sections.
ru: Каждый шаг, показанный ранее, детально описан на примерах в последующих разделах.

note: type: Content of: <book><chapter><section><title>
en: Choose your program
ru: Выбор программы

note: type: Content of: <book><chapter><section><para>
en: You have probably chosen the package you want to create.  The first thing you need to do is check if the package is in the distribution archive already by using the following:
ru: Вы, вероятно, уже выбрали пакет, который хотите создать. Первое, что вам необходимо сделать, это проверить, нет ли уже этого пакета в архиве дистрибутива, используя:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
ru: команду <command>aptitude</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&packages-do;">Debian packages</ulink> web page
ru: веб-страницу <ulink url="&packages-do;">пакетов Debian</ulink>

note: type: Content of: <book><chapter><section><para>
en: If the package already exists, well, install it! :-) If it happens to be <emphasis role="strong">orphaned</emphasis> (that is, if its maintainer is set to <ulink url="&qa-do;">Debian QA Group</ulink>), you may be able to pick it up if it's still available.  You may also adopt a package whose maintainer has filed a Request for Adoption (<emphasis role="strong">RFA</emphasis>).<placeholder type="footnote" id="0"/>
ru: Если пакет уже есть, то просто установите его! :-) Если случится так, что он окажется <emphasis role="strong">брошенным</emphasis> (orphaned) — то есть сопровождающий передал его <ulink url="&qa-do;">Debian QA Group</ulink>, то вы сможете подобрать его, если он ещё будет доступен. Также вы можете взять пакет, если его сопровождающий послал «запрос об усыновлении» (Request for Adoption, <emphasis role="strong">RFA</emphasis>) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: There are several package ownership status resources:
ru: Есть несколько ресурсов для получения информации о состоянии владения пакетом:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <command>wnpp-alert</command> command from the <systemitem role="package">devscripts</systemitem> package
ru: Команда <command>wnpp-alert</command> из пакета <systemitem role="package">devscripts</systemitem>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink>
ru: <ulink url="&wnpp-do;">Требующие доработки и будущие пакеты</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-bts;">Debian Bug report logs: Bugs in pseudo-package <systemitem role="package">wnpp</systemitem> in <literal>unstable</literal></ulink>
ru: <ulink url="&wnpp-bts;">Журналы сообщений об ошибках Debian: ошибки в псевдо-пакете <systemitem role="package">wnpp</systemitem> в <literal>unstable</literal></ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-dn;">Debian Packages that Need Lovin'</ulink>
ru: <ulink url="&wnpp-dn;">Пакеты Debian, которым нужна забота</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-debtags;">Browse <systemitem role="package">wnpp</systemitem> bugs based on debtags</ulink>
ru: <ulink url="&wnpp-debtags;">Просмотр ошибок <systemitem role="package">wnpp</systemitem> на основе категорий debtag</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Having said that, there will of course always be new programs that are worth packaging.
ru: С другой стороны, всегда будут появляться новые программы, которые хотелось бы иметь в виде пакета.

note: type: Content of: <book><chapter><section><para>
en: As a side note, it's important to point out that Debian already has packages for most kinds of programs, and the number of packages already in the Debian archive is much larger than that of contributors with upload rights.  Thus, contributions to packages already in the archive are far more appreciated (and more likely to receive sponsorship) by other developers <placeholder type="footnote" id="0"/>.  You can contribute in various ways:
ru: Попутно отметим, что в Debian уже есть пакеты для большинства типов программ, и их количество в архиве Debian намного больше, чем участников с правом загрузки. Поэтому работа над пакетами, которые уже включены в архив, намного предпочтительней (и с большей вероятностью получит поручительство) с точки зрения других разработчиков <placeholder type="footnote" id="0"/>. Этого можно достичь различными путями:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
ru: подобрать брошенный, но пока активно используемый пакет

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
ru: войти в одну из <ulink url="&teams;">команд по пакетированию</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
ru: исправлять ошибки в очень популярных пакетах

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: preparing <ulink url="&devref-nmu;">QA or NMU uploads</ulink>
ru: подготовить пакет для <ulink url="&devref-nmu;">QA или NMU загрузки</ulink>

note: type: Content of: <book><chapter><section><para>
en: If the package is new, and you decide you'd like to see it in Debian, proceed as follows:
ru: Если пакет новый и вы решили, что он нужен в Debian, то сделайте следующее:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: First, you must know that the program works, and have tried it for some time to confirm its usefulness.
ru: Во-первых, вы должны знать, что программа работает и вы, поработав с ней некоторое время, сочли её полезной.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
ru: У программы <emphasis role="strong">обязательно должна быть лицензия</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>main</literal> section, Debian Policy requires it <emphasis role="strong">to be fully compliant with the Debian Free Software Guidelines</emphasis> (<ulink url="&dfsg;">DFSG</ulink>)  and <emphasis role="strong">not to require a package outside of <literal>main</literal></emphasis> for compilation or execution.  This is the desired case.
ru: Для секции <literal>main</literal> политика Debian требует, чтобы программа <emphasis role="strong">удовлетворяла критериям Debian по определению Свободного ПО</emphasis> (<ulink url="&dfsg;">DFSG</ulink>) и <emphasis role="strong">не зависела от пакетов вне <literal>main</literal></emphasis> для компиляции или выполнения. Это предпочтительный вариант.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>contrib</literal> section, it must comply with the DFSG but it may require a package outside of <literal>main</literal> for compilation or execution.
ru: Для секции <literal>contrib</literal> она должна удовлетворять DFSG, но может зависеть от пакетов вне <literal>main</literal> для компиляции или выполнения.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>non-free</literal> section, it may be non-compliant with the DFSG but it <emphasis role="strong">must be distributable</emphasis>.
ru: Для секции <literal>non-free</literal> она может не удовлетворять DFSG, но <emphasis role="strong">должна быть распространяема</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If you are unsure about where it should go, post the license text on <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> and ask for advice.
ru: Если вы не уверены в том, где должна размещаться программа, отправьте текст лицензии в <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> и попросите совета.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should contact the program's author(s) to check if they agree with packaging it and are amicable to Debian.  It is important to be able to consult with the author(s)  in case of any problems with the program, so don't try to package unmaintained software.
ru: Вы должны связаться с авторами программы, чтобы убедиться, что они не против создания пакета Debian с их программой. Возможность консультироваться с авторами программы по поводу тех или иных проблем обычно очень важна, поэтому лучше не пытайтесь создавать пакеты для неподдерживаемых программ.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program certainly should <emphasis role="strong">not</emphasis> run setuid root, or even better, it shouldn't need to be setuid or setgid to anything.
ru: Программа определённо <emphasis role="strong">не должна</emphasis> требовать запуска с помощью setuid root, а ещё лучше — вообще не требовать прав доступа setuid или setgid к чему-либо.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should not be a daemon, or go in an <filename>*/sbin</filename> directory, or open a port as root.
ru: Программа не должна работать как служба, размещаться в каталогах <filename>*/sbin</filename> или открывать порты с правами root.

note: type: Content of: <book><chapter><section><para>
en: As a new maintainer, you are encouraged to get some experience in packaging with easier packages and discouraged from creating complicated packages.
ru: Как начинающий сопровождающий, не беритесь за сложные пакеты, пока не научитесь пакетировать самые простые.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
ru: Простые пакеты

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (collection of data such as wallpaper graphics)
ru: одиночный двоичный пакет, архитектура = all (набор данных, например обои для рабочего стола)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (executables written in an interpreted language such as POSIX shell)
ru: одиночный двоичный пакет, архитектура = all (исполняемые файлы, написанные на интерпретируемых языках, таких как оболочка POSIX)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
ru: Пакеты средней сложности

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = any (ELF binary executables compiled from languages such as C and C++)
ru: одиночный двоичный пакет, архитектура = any (исполняемые двоичные файлы ELF, скомпилированные из исходного кода на C и C++)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages, arch = any + all (packages for ELF binary executables + documentation)
ru: несколько двоичных пакетов, архитектура = any + all (пакеты с исполняемыми двоичными файлами ELF + документация)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source in a format other than <filename>tar.gz</filename> or <filename>tar.bz2</filename>
ru: исходный код в формате, отличном от <filename>tar.gz</filename> или <filename>tar.bz2</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
ru: исходный код с содержимым, не подлежащим распространению

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
ru: Пакеты повышенной сложности

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
ru: пакет для интерпретируемого модуля, используемого другими пакетами

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
ru: пакет для обычной библиотеки ELF, используемого другими пакетами

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
ru: несколько двоичных пакетов, включающих пакет с библиотекой ELF

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
ru: исходный код, получаемый из нескольких источников

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
ru: пакеты с модулями ядра

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
ru: пакеты с заплатами к ядру

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
ru: любой пакет со сложными сценариями сопровождающего

note: type: Content of: <book><chapter><section><para>
en: Packaging high complexity packages is not too hard, but it requires a bit more knowledge. You should seek specific guidance for every complex feature. For example, some languages have their own sub-policy documents:
ru: Пакетирование пакетов повышенной сложности не слишком трудно, но требует больше знаний. Вы должны найти нужное руководство для каждой сложной функции. Например, для некоторых языков есть своя документация с политикой:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-perl;">Perl policy</ulink>
ru: <ulink url="&policy-perl;">Политика для Perl</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-python;">Python policy</ulink>
ru: <ulink url="&policy-python;">Политика для Python</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-java;">Java policy</ulink>
ru: <ulink url="&policy-java;">Политика для Java</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Do not worry about the missing <filename>Makefile</filename>.  You can install the <command>hello</command> command by simply using <command>debhelper</command> as in <xref linkend="install"/>, or by modifying the upstream source to add a new <filename>Makefile</filename> with the <literal>install</literal> target as in <xref linkend="modify"/>.
ru: Не беспокойтесь об отсутствии файла <filename>Makefile</filename>. Вы можете установить команду <command>hello</command> просто с помощью <command>debhelper</command>, как показано в <xref linkend="install"/>, или изменить исходный код, добавив новый <filename>Makefile</filename> с целью <literal>install</literal>, как показано в <xref linkend="modify"/>.

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
ru: Получение программы и ознакомление со сборкой

note: type: Content of: <book><chapter><section><para>
en: So the first thing to do is to find and download the original source code.  Presumably you already have the source file that you picked up at the author's homepage.  Sources for free Unix programs usually come in <command>tar</command>+<command>gzip</command> format with the extension <filename>.tar.gz</filename>, <command>tar</command>+<command>bzip2</command> format with the extension <filename>.tar.bz2</filename>, or <command>tar</command>+<command>xz</command> format with the extension <filename>.tar.xz</filename>.  These usually contain a directory called <filename><replaceable>package</replaceable>-<replaceable>version</replaceable></filename> with all the sources inside.
ru: Итак, первое, что вы должны сделать — найти и скачать исходный код программы. Предполагается, что вы уже взяли файл с домашней страницы автора. Исходный код программ для Unix обычно предоставляется в виде архива в формате <command>tar</command>+<command>gzip</command> с расширением <filename>.tar.gz</filename>, <command>tar</command>+<command>bzip2</command> с расширением <filename>.tar.bz2</filename> или <command>tar</command>+<command>xz</command> с расширением <filename>.tar.xz</filename>. Внутри архива обычно есть каталог с именем <filename><replaceable>пакет</replaceable>-<replaceable>версия</replaceable></filename>, в котором находятся все файлы исходного кода программы.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can identify the archive format using the <command>file</command> command when the file extension is not enough.
ru: Вы можете определить формат архива с помощью команды <command>file</command>, если по расширению это непонятно.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes as some other sort of archive (for instance, the filename ends in <filename>.Z</filename> or <filename>.zip</filename><placeholder type="footnote" id="0"/>), you should also unpack it with the appropriate tools and repack it.
ru: Если исходный код выбранной программы поставляется в другом виде (например, имя файла оканчивается на <filename>.Z</filename> или <filename>.zip</filename><placeholder type="footnote" id="0"/>), распакуйте его соответствующими средствами и перепакуйте его.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes with some contents which do not comply with DFSG, you should also unpack it to remove such contents and repack it with a modified upstream version containing <literal>dfsg</literal>.
ru: Если исходный код выбранной программы поставляется с содержимым, не удовлетворяющим DFSG, то вам также нужно распаковать его и удалить это содержимое и перепаковать его, добавив в версию исходного кода пометку <literal>dfsg</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This program is already packaged. The <ulink url="&gentoo-package;">current version</ulink> uses Autotools as its build structure and is substantially different from the following examples, which were based on version 0.9.12.
ru: Для этой программы пакет уже создан. В <ulink url="&gentoo-package;">текущей версии</ulink> в качестве структуры сборки используется Autotools и, следовательно, есть различия с приводимыми примерами, которые были написаны для версии 0.9.12.

note: type: Content of: <book><chapter><section><para>
en: As an example, I'll use a program called <command>gentoo</command>, a GTK+ file manager.  <placeholder type="footnote" id="0"/>
ru: В качестве примера взята программа <command>gentoo</command> — менеджер файлов, использующий GTK+ <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Create a subdirectory under your home directory named <filename>debian</filename> or <filename>deb</filename> or anything you find appropriate (e.g.  just <filename>~/gentoo</filename> would do fine in this case).  Place the downloaded archive in it, and extract it (with <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Make sure there are no warning messages, even <emphasis>irrelevant</emphasis> ones, because other people's unpacking tools may or may not ignore these anomalies, so they may have problems unpacking them.  Your shell command line may look something like this:
ru: В своём домашнем каталоге создайте каталог с именем <filename>debian</filename>, <filename>deb</filename> или с любым удобным (например, в нашем случае можно было бы использовать <filename>~/gentoo</filename>). Поместите скачанный архив в этот каталог и распакуйте его (<literal>tar xzf gentoo-0.9.12.tar.gz</literal>). Убедитесь, что при этом не возникло никаких, <emphasis>даже, казалось бы, не относящихся к делу</emphasis> ошибок, так как их появление означает, что они могут возникнуть и на машинах других людей, у которых их инструменты распаковки посчитают это за реальную ошибку. В командной строке оболочки вы должны увидеть следующее:

note: type: Content of: <book><chapter><section><para>
en: Now you have another subdirectory, called <filename>gentoo-0.9.12</filename>.  Change to that directory and <emphasis>thoroughly</emphasis> read the provided documentation.  Usually there are files named <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> or <filename>*.html</filename>.  You must find instructions on how to compile and install the program (most probably they'll assume you want to install to the <filename>/usr/local/bin</filename> directory; you won't be doing that, but more on that later in <xref linkend="destdir"/>).
ru: В результате вы получите подкаталог <filename>gentoo-0.9.12</filename>. Перейдите в этот каталог и <emphasis>внимательно</emphasis> прочитайте имеющуюся документацию. Обычно, полезными оказываются файлы <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> или <filename>*.html</filename>. Вы должны найти инструкции, которые позволят вам правильно скомпилировать и установить программу (скорее всего, в каталог <filename>/usr/local/bin</filename>; вы должны будете установить программу в другой каталог, подробнее об этом в <xref linkend="destdir"/>).

note: type: Content of: <book><chapter><section><para>
en: You should start packaging with a completely clean (pristine) source directory, or simply with freshly unpacked sources.
ru: Вы должны начинать процедуру пакетирования в полностью оригинальном (ещё неизменённым) каталоге с исходным кодом (для этого, например, можно заново распаковать архив с исходным кодом).

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
ru: Простые системы сборки

note: type: Content of: <book><chapter><section><para>
en: Simple programs usually come with a <filename>Makefile</filename> and can be compiled just by invoking <literal>make</literal>.<placeholder type="footnote" id="0"/> Some of them support <literal>make check</literal>, which runs included self-tests.  Installation to the destination directories is usually done with <literal>make install</literal>.
ru: В простых программах обычно используется файл <filename>Makefile</filename> и для компиляции достаточно выполнить команду <literal>make</literal><placeholder type="footnote" id="0"/>. Некоторые из них поддерживают команду <literal>make check</literal>, по которой выполняется самопроверка. Установка в каталог назначения обычно выполняется с помощью <literal>make install</literal>.

note: type: Content of: <book><chapter><section><para>
en: Now try to compile and run your program, to make sure it works properly and doesn't break something else while it's installing or running.
ru: Теперь скомпилируйте программу и попробуйте её запустить, чтобы убедиться, что она правильно работает и что при установке и запуске ничто другое не было испорчено.

note: type: Content of: <book><chapter><section><para>
en: Also, you can usually run <literal>make clean</literal> (or better <literal>make distclean</literal>) to clean up the build directory.  Sometimes there's even a <literal>make uninstall</literal> which can be used to remove all the installed files.
ru: Вы также можете попытаться воспользоваться командой <literal>make clean</literal> (или лучше <literal>make distclean</literal>) для очистки каталога сборки. Иногда есть даже команда <literal>make uninstall</literal>, которая позволит удалить все установленные файлы.

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
ru: Популярные переносимые системы сборки

note: type: Content of: <book><chapter><section><para>
en: A lot of free software programs are written in the <ulink url="&c-program;">C</ulink> and <ulink url="&cxx;">C++</ulink> languages.  Many of these use Autotools or CMake to make them portable across different platforms.  These build tools need to be used to generate the <filename>Makefile</filename> and other required source files first.  Then, such programs are built using the usual <literal>make; make install</literal>.
ru: Многие свободные программы написаны на языках <ulink url="&c-program;">C</ulink> и <ulink url="&cxx;">C++</ulink>. В некоторых из них для переносимости между платформами используются Autotools или CMake. Эти инструменты используются для генерации <filename>Makefile</filename> и других необходимых исходных файлов. Такие программы обычно собираются с помощью <literal>make; make install</literal>.

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&gnu-build-system;">Autotools</ulink> is the GNU build system comprising <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink>, and <ulink url="&gettext;">gettext</ulink>.  You can recognize such sources by the <filename>configure.ac</filename>, <filename>Makefile.am</filename>, and <filename>Makefile.in</filename> files.  <placeholder type="footnote" id="0"/>
ru: <ulink url="&gnu-build-system;">Autotools</ulink> — это система сборки GNU, состоящая из <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink> и <ulink url="&gettext;">gettext</ulink>. Её использование можно определить по включённым в исходный архив файлам <filename>configure.ac</filename>, <filename>Makefile.am</filename> и <filename>Makefile.in</filename> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: The first step of the Autotools workflow is usually that upstream runs <literal>autoreconf -i -f</literal> in the source directory and distributes the generated files along with the source.
ru: Первый шаг автоматизации с помощью Autotools обычно выполняет автор программы. Он запускает команду <literal>autoreconf -i -f</literal> в каталоге с исходным кодом и затем распространяет сгенерированные файлы вместе с исходным кодом.

note: type: Content of: <book><chapter><section><para>
en: Editing <filename>configure.ac</filename> and <filename>Makefile.am</filename> files requires some knowledge of <command>autoconf</command> and <command>automake</command>.  See <literal>info autoconf</literal> and <literal>info automake</literal>.
ru: Для правки файлов <filename>configure.ac</filename> и <filename>Makefile.am</filename> требуется знание инструментов <command>autoconf</command> и <command>automake</command>. Смотрите <literal>info autoconf</literal> и <literal>info automake</literal>.

note: type: Content of: <book><chapter><section><para>
en: The second step of the Autotools workflow is usually that the user obtains this distributed source and runs <literal>./configure &amp;&amp; make</literal> in the source directory to compile the program into an executable command <command><replaceable>binary</replaceable></command>.
ru: Второй шаг автоматизации с помощью Autotools обычно выполняет пользователь. Он получает распространяемый код и запускает <literal>./configure &amp;&amp; make</literal> для компиляции программы в исполняемый<command><replaceable>двоичный файл</replaceable></command>.

note: type: Content of: <book><chapter><section><screen>
en: Makefile.in -----+                +-&gt; Makefile -----+-&gt; make -&gt; <replaceable>binary</replaceable>
    src/Makefile.in -+-&gt; ./configure -+-&gt; src/Makefile -+
    config.h.in -----+                +-&gt; config.h -----+
                     |
      config.status -+
      config.guess --+
ru: Makefile.in -----+                +-&gt; Makefile -----+-&gt; make -&gt; <replaceable>двоичный файл</replaceable>
    src/Makefile.in -+-&gt; ./configure -+-&gt; src/Makefile -+
    config.h.in -----+                +-&gt; config.h -----+
                     |
      config.status -+
      config.guess --+

note: type: Content of: <book><chapter><section><para>
en: You can change many things in the <filename>Makefile</filename>; for instance you can change the default location for file installation using the option <literal>./configure --prefix=/usr</literal>.
ru: Вы можете изменять различные переменные в файле <filename>Makefile</filename>. Например каталог установки по умолчанию изменяется с помощью параметра в командной строке: <literal>./configure --prefix=/usr</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can automate this by using <systemitem role="package">dh-autoreconf</systemitem> package.  See <xref linkend="customrules"/>.
ru: Вы можете это автоматизировать с помощью пакета <systemitem role="package">dh-autoreconf</systemitem>. Смотрите <xref linkend="customrules"/>.

note: type: Content of: <book><chapter><section><para>
en: Although it is not required, updating the <filename>configure</filename> and other files with <literal>autoreconf -i -f</literal> may improve the compatibility of the source.  <placeholder type="footnote" id="0"/>
ru: Хотя это не обязательно, обновление <filename>configure</filename> и других файлов с помощью <literal>autoreconf -i -f</literal> может улучшить совместимость исходного кода <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&cmake;">CMake</ulink> is an alternative build system.  You can recognize such sources by the <filename>CMakeLists.txt</filename> file.
ru: Альтернативной системой сборки является <ulink url="&cmake;">CMake</ulink>. Её можно определить по наличию файла <filename>CMakeLists.txt</filename>.

note: type: Content of: <book><chapter><section><title>
en: Package name and version
ru: Имя и версия пакета

note: type: Content of: <book><chapter><section><para>
en: If the upstream source comes as <filename>gentoo-0.9.12.tar.gz</filename>, you can take <literal>gentoo</literal> as the (source) <emphasis role="strong">package name</emphasis> and <literal>0.9.12</literal> as the <emphasis role="strong">upstream version</emphasis>.  These are used in the <filename>debian/changelog</filename> file described later in <xref linkend="changelog"/>, too.
ru: Если оригинальный исходный код программы содержится в файле <filename>gentoo-0.9.12.tar.gz</filename>, то в качестве (исходного) <emphasis role="strong">имени пакета</emphasis> можно взять <literal>gentoo</literal>, а в качестве <emphasis role="strong">версии исходной программы</emphasis> — <literal>0.9.12</literal>. Имя и версия используются в файле <filename>debian/changelog</filename>, который описан далее в <xref linkend="changelog"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default package name field length of <command>aptitude</command> is 30.  For more than 90% of packages, the package name is less than 24 characters.
ru: В <command>aptitude</command> длина поля имени пакет по умолчанию равна 30. Длина имён более чем 90% пакетов менее 24 символов.

note: type: Content of: <book><chapter><section><para>
en: If upstream uses some generic term such as <literal>test-suite</literal> for its name, it is a good idea to rename it to identify its contents explicitly and avoid namespace pollution.  <placeholder type="footnote" id="0"/>
ru: Если для имени автор программы использовал какие-то общие слова, например <literal>test-suite</literal>, то лучше назначить другое имя, которое явно описывает содержимое и не засоряет пространство имён <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This stricter rule should help you avoid confusing file names.
ru: Это жёсткое правило должно помочь избежать путаницы в именах файлов.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default version field length of <command>aptitude</command> is 10.  The Debian revision with preceding hyphen usually consumes 2.  For more than 80% of packages, the upstream version is less than 8 characters and the Debian revision is less than 2 characters.  For more than 90% of packages, the upstream version is less than 10 characters and the Debian revision is less than 3 characters.
ru: В <command>aptitude</command> длина поля версии по умолчанию равна 10. Редакция Debian с символом переноса обычно занимает 2 символа. В более 80% пакетов версия исходной программы — менее 8 символов, а редакция Debian — менее 2 символов. В более 90% пакетов версия исходной программы — менее 10 символов, а редакция Debian — менее 3 символов.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Version strings may be <emphasis role="strong">upstream version</emphasis> (<literal><replaceable>version</replaceable></literal>), <emphasis role="strong">Debian revision</emphasis> (<literal><replaceable>revision</replaceable></literal>), or <emphasis role="strong">version</emphasis> (<literal><replaceable>version</replaceable>-<replaceable>revision</replaceable></literal>).  See <xref linkend="newrevision"/> for how the <emphasis role="strong">Debian revision</emphasis> is incremented.
ru: Строками версий могут быть <emphasis role="strong">версия исходной программы</emphasis> (<literal><replaceable>версия</replaceable></literal>), <emphasis role="strong">редакция Debian</emphasis> (<literal><replaceable>редакция</replaceable></literal>) или <emphasis role="strong">версия</emphasis> (<literal><replaceable>версия</replaceable>-<replaceable>редакция</replaceable></literal>). Смотрите в <xref linkend="newrevision"/> как увеличивается значение <emphasis role="strong">редакции Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Version strings <placeholder type="footnote" id="0"/> can be compared using <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
ru: Строки версий <placeholder type="footnote" id="0"/> можно сравнить с помощь <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> следующим образом:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg --compare-versions <replaceable>ver1</replaceable> <replaceable>op</replaceable> <replaceable>ver2</replaceable>
ru:  $ dpkg --compare-versions <replaceable>версия1</replaceable> <replaceable>операция</replaceable> <replaceable>версия2</replaceable>

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
ru: Правило сравнения версий вкратце можно описать так:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
ru: Строки сравниваются от начала к концу.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
ru: Буквы больше, чем цифры.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
ru: Числа сравниваются как целые.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
ru: Буквы сравниваются согласно порядку кодов ASCII.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: There are special rules for period (<literal>.</literal>), plus (<literal>+</literal>), and tilde (<literal>~</literal>) characters, as follows:
ru: Для символов точки (<literal>.</literal>), плюса (<literal>+</literal>) и тильды (<literal>~</literal>) правила следующие:

note: type: Content of: <book><chapter><section><para>
en: One tricky case occurs when upstream releases <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> as the pre-release of <filename>gentoo-0.9.12.tar.gz</filename>.  You need to make sure that the upgrade works properly by renaming the upstream source to <filename>gentoo-0.9.12~rc99.tar.gz</filename>.
ru: Иногда бывает, что автор выпускает предварительную версию <filename>gentoo-0.9.12.tar.gz</filename> с именем <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename>. Чтобы правильно сработало обновление пакета, вам нужно переименовать файл с исходным кодом в <filename>gentoo-0.9.12~rc99.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
ru: Настройка <command>dh_make</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The following text assumes you are using Bash as your login shell.  If you use some other login shell such as Z shell, use their corresponding configuration files instead of <filename>~/.bashrc</filename>.
ru: В примере предполагается, что в качестве регистрационной оболочки у вас используется Bash. Если вы используете другую регистрационную оболочку (например, Z shell), используйте другие соответствующие файлы настройки вместо <filename>~/.bashrc</filename>.

note: type: Content of: <book><chapter><section><para>
en: Set up the shell environment variables <literal>$DEBEMAIL</literal> and <literal>$DEBFULLNAME</literal> so that various Debian maintenance tools recognize your email address and name to use for packages. <placeholder type="footnote" id="0"/>
ru: Для указания вашего адреса электронной почты и имени, которые будут использоваться в пакетах инструментами сопровождения Debian, настройте переменные окружения <literal>$DEBEMAIL</literal> и <literal>$DEBFULLNAME</literal> <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><screen>
en: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="your.email.address@example.org"
    DEBFULLNAME="Firstname Lastname"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc
ru: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="ваш.адрес.эл.почты@example.org"
    DEBFULLNAME="Имя Фамилия"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
ru: Начальный неродной пакет Debian

note: type: Content of: <book><chapter><section><para>
en: Normal Debian packages are non-native Debian packages made from upstream programs.  If you wish to create a non-native Debian package of an upstream source <filename>gentoo-0.9.12.tar.gz</filename>, you can create an initial non-native Debian package for it by issuing the <command>dh_make</command> command as follows:
ru: Обычно, пакеты Debian являются неродными (non-native) пакетами Debian, создаваемыми из внешнего исходного кода. Если вы хотите создать неродной пакет Debian из исходного кода <filename>gentoo-0.9.12.tar.gz</filename>, то можете сгенерировать начальный неродной пакет Debian с помощью команды <command>dh_make</command> следующим образом:

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of your original source archive.  <placeholder type="footnote" id="0"/> See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> for details.
ru: Здесь замените имя файла именем вашего архива с исходным кодом <placeholder type="footnote" id="0"/>. Подробней смотрите <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are several choices here: <literal>s</literal> for Single binary package, <literal>i</literal> for arch-Independent package, <literal>m</literal> for Multiple binary packages, <literal>l</literal> for Library package, <literal>k</literal> for Kernel module package, <literal>n</literal> for kernel patch package, and <literal>b</literal> for <systemitem role="package">cdbs</systemitem> package.  This document focuses on the use of the <command>dh</command> command (from the package <systemitem role="package">debhelper</systemitem>) to create a single binary package, but also touches on how to use it for arch-independent or multiple binary packages.  The package <systemitem role="package">cdbs</systemitem> offers an alternative packaging script infrastructure to the <command>dh</command> command and is outside the scope of this document.
ru: Здесь предлагается несколько вариантов: <literal>s</literal> — одиночный двоичный пакет, <literal>i</literal> — пакет, независящий от архитектуры, <literal>m</literal> — несколько двоичных пакетов, <literal>l</literal> — пакет для библиотеки, <literal>k</literal> — пакет для модуля ядра, <literal>n</literal> — пакет с заплатами к ядру и <literal>b</literal> — пакет, применяющий <systemitem role="package">cdbs</systemitem>. В этом документе, в основном, описывается использование команды <command>dh</command> (из пакета <systemitem role="package">debhelper</systemitem>) для создания одиночного двоичного пакета, но также затрагиваются варианты с пакетами, независящими от архитектуры, и когда из одной программы создаётся несколько двоичных пакетов. Пакет <systemitem role="package">cdbs</systemitem> предоставляет инфраструктуру пакетирования альтернативную команде <command>dh</command> и не описан в этом документе.

note: type: Content of: <book><chapter><section><para>
en: This execution of <command>dh_make</command> creates a copy of the upstream tarball as <filename>gentoo_0.9.12.orig.tar.gz</filename> in the parent directory to accommodate the creation of the non-native Debian source package with the name <filename>debian.tar.gz</filename> later:
ru: После выполнения <command>dh_make</command> в родительском каталоге создался исходный архив tar с именем <filename>gentoo_0.9.12.orig.tar.gz</filename>, который в дальнейшем будет использоваться для создания неродного пакета с исходным кодом Debian с именем <filename>debian.tar.gz</filename>:

note: type: Content of: <book><chapter><section><para>
en: Please note two key features of this filename <filename>gentoo_0.9.12.orig.tar.gz</filename>:
ru: Отметьте два ключевых момента в имени файла <filename>gentoo_0.9.12.orig.tar.gz</filename>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Package name and version are separated by the character <literal>_</literal> (underscore).
ru: Имя пакета и версия разделены символом <literal>_</literal> (подчёркивание).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The string <filename>.orig</filename> is inserted before the <filename>.tar.gz</filename>.
ru: Перед <filename>.tar.gz</filename> есть часть <filename>.orig</filename>.

note: type: Content of: <book><chapter><section><para>
en: You should also notice that many template files are created in the source under the <filename>debian</filename> directory.  These will be explained in <xref linkend="dreq"/> and <xref linkend="dother"/>.  You should also understand that packaging cannot be a fully automated process.  You will need to modify the upstream source for Debian (see <xref linkend="modify"/>).  After this, you need to use the proper methods for building Debian packages (<xref linkend="build"/>), testing them (<xref linkend="checkit"/>), and uploading them (<xref linkend="upload"/>).  All the steps will be explained.
ru: Вы, наверное, уже заметили, что в исходном коде в каталоге <filename>debian</filename> было создано множество файлов шаблонов. Их назначение описано в <xref linkend="dreq"/> и <xref linkend="dother"/>. Как вы уже догадались, процесс пакетирования не может быть полностью автоматическим. Вам нужно изменить исходный код программы для Debian (<xref linkend="modify"/>). После этого вам нужно правильно собрать пакет Debian (<xref linkend="build"/>), проверить его (<xref linkend="checkit"/>) и отослать в архив (<xref linkend="upload"/>). Далее будут рассмотрены все эти шаги.

note: type: Content of: <book><chapter><section><para>
en: If you accidentally erased some template files while working on them, you can recover them by running <command>dh_make</command> with the <literal>--addmissing</literal> option again in a Debian package source tree.
ru: Если вы случайно стёрли какой-то файл шаблона при работе, то можете восстановить его, повторно запустив <command>dh_make</command> с параметром <literal>--addmissing</literal> в дереве исходного кода пакета Debian.

note: type: Content of: <book><chapter><section><para>
en: Updating an existing package may get complicated since it may be using older techniques.  While learning the basics, please stick to creating a fresh package; further explanations are given in <xref linkend="update"/>.
ru: Обновлять существующий пакет сложнее, так как для его создания могли использоваться старые методы. Поэтому на время обучения пока беритесь за современные пакеты. Мы вернёмся к этому позднее в <xref linkend="update"/>.

note: type: Content of: <book><chapter><title>
en: Modifying the source
ru: Изменение исходного кода

note: type: Content of: <book><chapter><para>
en: Please note that there isn't space here to go into <emphasis>all</emphasis> the details of fixing upstream sources, but here are some basic steps and problems people often run across.
ru: Заметим, что в данный документ невозможно поместить <emphasis>всю</emphasis> информацию по исправлению исходного кода программы, однако здесь приведены основные шаги и проблемы, с которыми часто встречаются люди.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
ru: Настройка <command>quilt</command>

note: type: Content of: <book><chapter><section><para>
en: The program <command>quilt</command> offers a basic method for recording modifications to the upstream source for Debian packaging.  It's useful to have a slightly customized default, so let's create an alias <command>dquilt</command> for Debian packaging by adding the following lines to <filename>~/.bashrc</filename>.  The second line provides the same shell completion feature of the <command>quilt</command> command to the <command>dquilt</command> command:
ru: Программа <command>quilt</command> предлагает простой способ записи изменений, произведённых в исходном коде для пакетирования Debian. Для удобства использования слегка изменим настройки по умолчанию, добавив для пакетирования псевдоним <command>dquilt</command> в файле <filename>~/.bashrc</filename>. Вторая строка служит для включения автодополнения к <command>dquilt</command>, такого же как у команды <command>quilt</command>:

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
ru: Затем создадим файл <filename>~/.quiltrc-dpkg</filename> со следующим содержимым:

note: type: Content of: <book><chapter><section><para>
en: See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <filename>&quilt-pdf;</filename> on how to use <command>quilt</command>.
ru: О том, как использовать <command>quilt</command>, читайте в <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> и <filename>&quilt-pdf;</filename>.

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
ru: Исправление ошибок в исходной программе

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <filename>debian/patches</filename> directory should exist now if you ran <command>dh_make</command> as described before.  This example operation creates it just in case you are updating an existing package.
ru: Каталог <filename>debian/patches</filename> уже должен существовать, если вы запускали <command>dh_make</command>, как это описывалось ранее. В этом примере каталог создаётся вручную, на случай если обновляется существующий пакет.

note: type: Content of: <book><chapter><section><para>
en: Let's fix this and record it with the <command>dquilt</command> command as <filename>fix-gentoo-target.patch</filename>: <placeholder type="footnote" id="0"/>
ru: Внесём исправление и запишем его при помощи команды <command>dquilt</command> в файл <filename>fix-gentoo-target.patch</filename> <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: You change the <filename>Makefile</filename> file as follows:
ru: Изменим файл <filename>Makefile</filename> следующим образом:

note: type: Content of: <book><chapter><section><para>
en: Ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/fix-gentoo-target.patch</filename> and add its description following <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:
ru: Запустите <command>dquilt</command> для генерации и записи заплаты в файл <filename>debian/patches/fix-gentoo-target.patch</filename> и добавьте к ней описание в соответствии с <ulink url="&dep3;">DEP-3: Руководство по маркировке заплат</ulink>:

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt refresh
    $ dquilt header -e
    ... describe patch
ru: $ dquilt refresh
    $ dquilt header -e
    ... описание заплаты

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
ru: Установка файлов в их каталоги назначения

note: type: Content of: <book><chapter><section><para>
en: Most third-party software installs itself in the <filename>/usr/local</filename> directory hierarchy.  On Debian this is reserved for private use by the system administrator, so packages must not use directories such as <filename>/usr/local/bin</filename> but should instead use system directories such as <filename>/usr/bin</filename>, obeying the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS).
ru: Большинство стороннего ПО устанавливает себя в иерархию каталогов <filename>/usr/local</filename>. В Debian это место зарезервировано для использования администратором по своему усмотрению, поэтому пакеты не должны использовать такие каталоги как <filename>/usr/local/bin</filename>, а должны устанавливаться в системные каталоги, такие как <filename>/usr/bin</filename>, согласно <ulink url="&fhs;">стандарту иерархии файловой системы</ulink> (FHS).

note: type: Content of: <book><chapter><section><para>
en: Normally, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> is used to automate building the program, and executing <literal>make install</literal> installs programs directly to the desired destination (following the <literal>install</literal> target in the <filename>Makefile</filename>).  In order for Debian to provide pre-built installable packages, it modifies the build system to install programs into a file tree image created under a temporary directory instead of the actual destination.
ru: Обычно, для автоматизации сборки программы используется <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, а по команде <literal>make install</literal> выполняется установка программ в желаемый каталог, назначенный для цели <literal>install</literal> в файле <filename>Makefile</filename>. Для создания двоичных, готовых к установке пакетов Debian, требуется изменить систему сборки таким образом, чтобы она устанавливала программы в образ файловой системы, развёрнутый во временном каталоге, а не в реальное место назначения.

note: type: Content of: <book><chapter><section><para>
en: These two differences between normal program installation on one hand and the Debian packaging system on the other can be transparently addressed by the <systemitem role="package">debhelper</systemitem> package through the <command>dh_auto_configure</command> and <command>dh_auto_install</command> commands if the following conditions are met:
ru: Эти два различия между нормальной установкой программы, с одной стороны, и системой пакетирования Debian с другой, могут быть прозрачно переданы пакетом <systemitem role="package">debhelper</systemitem> с помощью команд <command>dh_auto_configure</command> и <command>dh_auto_install</command>, если соблюдаются следующие условия:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.
ru: Смотрите <ulink url="&gnu-destdir;">Стандарты программирования GNU: 7.2.4 DESTDIR: Поддержка поэтапной установки</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <filename>Makefile</filename> must follow GNU conventions and support the <literal>$(DESTDIR)</literal> variable.  <placeholder type="footnote" id="0"/>
ru: Файл <filename>Makefile</filename> соответствует соглашениям GNU и поддерживает переменную <literal>$(DESTDIR)</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The source must follow the Filesystem Hierarchy Standard (FHS).
ru: Исходный код следует FHS.

note: type: Content of: <book><chapter><section><para>
en: Programs that use GNU <command>autoconf</command> follow the GNU conventions automatically, so they can be trivial to package.  On the basis of this and other heuristics, it is estimated that the <systemitem role="package">debhelper</systemitem> package will work for about 90% of packages without making any intrusive changes to their build system.  So packaging is not as complicated as it may seem.
ru: Программы, использующие пакет GNU <command>autoconf</command>, автоматически следуют соглашениям GNU, и их легко пакетировать. На основе этого и эвристики можно сделать вывод, что пакет <systemitem role="package">debhelper</systemitem> будет работать с почти 90% пакетов без внесения серьёзных изменений в их системы сборки. Поэтому процесс пакетирования не так сложен, как кажется.

note: type: Content of: <book><chapter><section><para>
en: If you need to make changes in the <filename>Makefile</filename>, you should be careful to support the <literal>$(DESTDIR)</literal> variable.  Although it is unset by default, the <literal>$(DESTDIR)</literal> variable is prepended to each file path used for the program installation.  The packaging script will set <literal>$(DESTDIR)</literal> to the temporary directory.
ru: Если вам необходимо внести изменения в файл <filename>Makefile</filename>, убедитесь, что он поддерживает переменную <literal>$(DESTDIR)</literal>. Значение переменной <literal>$(DESTDIR)</literal> явно в нём не задаётся, но указывается в начале каждого файлового пути, который используется для установки программы. Сценарий пакетирования присвоит <literal>$(DESTDIR)</literal> значение временного каталога.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: For a source package generating multiple binary packages, the <command>dh_auto_install</command> command uses <filename>debian/tmp</filename> as the temporary directory while the <command>dh_install</command> command with the help of <filename>debian/<replaceable>package-1</replaceable>.install</filename> and <filename>debian/<replaceable>package-2</replaceable>.install</filename> files will split the contents of <filename>debian/tmp</filename> into <filename>debian/<replaceable>package-1</replaceable></filename> and <filename>debian/<replaceable>package-2</replaceable></filename> temporary directories, to create <filename><replaceable>package-1</replaceable>_*.deb</filename> and <filename><replaceable>package-2</replaceable>_*.deb</filename> binary packages.
ru: При создании из исходного кода нескольких двоичных пакетов команда <command>dh_auto_install</command> использует <filename>debian/tmp</filename> в качестве временного каталога, а команда <command>dh_install</command> с помощью файлов <filename>debian/<replaceable>пакет-1</replaceable>.install</filename> и <filename>debian/<replaceable>пакет-2</replaceable>.install</filename> разнесёт содержимое <filename>debian/tmp</filename> по временным каталогам <filename>debian/<replaceable>пакет-1</replaceable></filename> и <filename>debian/<replaceable>пакет-2</replaceable></filename> для создания двоичных пакетов <filename><replaceable>пакет-1</replaceable>_*.deb</filename> и <filename><replaceable>пакет-2</replaceable>_*.deb</filename>.

note: type: Content of: <book><chapter><section><para>
en: For a source package generating a single binary package, the temporary directory used by the <command>dh_auto_install</command> command will be set to <filename>debian/<replaceable>package</replaceable></filename>.  <placeholder type="footnote" id="0"/> Everything that is contained in the temporary directory will be installed on users' systems when they install your package; the only difference is that <command>dpkg</command> will be installing the files to paths relative to the root directory rather than your working directory.
ru: При создании из исходного кода одиночного пакета временный каталог, используемый командой <command>dh_auto_install</command>, будет установлен в <filename>debian/<replaceable>пакет</replaceable></filename> <placeholder type="footnote" id="0"/>. Всё, что содержится во временном каталоге, будет помещено в систему пользователя при установке пакета. Различие в том, что <command>dpkg</command> установит файлы в систему относительно корневого каталога, а не вашего рабочего каталога.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that even though your program installs in <filename>debian/<replaceable>package</replaceable></filename>, it still needs to behave correctly when installed from the <filename>.deb</filename> package under the root directory.  So you must not allow the build system to hardcode strings like <literal>/home/me/deb/<replaceable>package</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>package</replaceable></literal> into files in the package.
ru: Помните: даже если ваша программа устанавливается в <filename>debian/<replaceable>пакет</replaceable></filename>, нужно внимательно следить за правильностью её установки из пакета <filename>.deb</filename> в корневой каталог. Поэтому вы не должны разрешать системе сборки записывать неизменяемые строки вроде <literal>/home/моего/deb/<replaceable>пакет</replaceable>-<replaceable>версия</replaceable>/usr/share/<replaceable>пакет</replaceable></literal> в файлы пакета.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This is just an example to show what a <filename>Makefile</filename> should look like.  If the <filename>Makefile</filename> is created by the <command>./configure</command> command, the correct way to fix this kind of <filename>Makefile</filename> is to execute <command>./configure</command> from the <command>dh_auto_configure</command> command with default options including <literal>--prefix=/usr</literal>.
ru: Это просто пример, который показывает как должен выглядеть <filename>Makefile</filename>. Если <filename>Makefile</filename> создан командой <command>./configure</command>, то исправлять файл <filename>Makefile</filename> предпочтительно вызовом <command>./configure</command> из <command>dh_auto_configure</command> с параметрами по умолчанию и добавленным параметром <literal>--prefix=/usr</literal>.

note: type: Content of: <book><chapter><section><para>
en: Here's the relevant part of <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename><placeholder type="footnote" id="0"/>:
ru: Вот соответствующая часть файла <filename>Makefile</filename>, взятого из пакета <systemitem role="package">gentoo</systemitem><placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><screen>
en: # Where to put executable commands on 'make install'?
    BIN     = /usr/local/bin
    # Where to put icons on 'make install'?
    ICONS   = /usr/local/share/gentoo
ru: # Куда помещать исполняемые файлы по команде «make install»?
    BIN     = /usr/local/bin
    # Куда помещать значки по команде «make install»?
    ICONS   = /usr/local/share/gentoo

note: type: Content of: <book><chapter><section><screen>
en: # Where to put executable commands on 'make install'?
    BIN     = $(DESTDIR)/usr/bin
    # Where to put icons on 'make install'?
    ICONS   = $(DESTDIR)/usr/share/gentoo
ru: # Куда помещать исполняемые файлы по команде «make install»?
    BIN     = $(DESTDIR)/usr/bin
    
    # Куда помещать значки по команде «make install»?
    ICONS   = $(DESTDIR)/usr/share/gentoo

note: type: Content of: <book><chapter><section><para>
en: The exact locations that should be used for binaries, icons, documentation, etc. are specified in the Filesystem Hierarchy Standard (FHS).  You should browse through it and read the sections relevant to your package.
ru: Где именно должны располагаться исполняемые файлы, значки, документация и т.д. описывает FHS — стандарт иерархии файловой системы. Рекомендуется обратить внимание на разделы, которые касаются вашего пакета.

note: type: Content of: <book><chapter><section><para>
en: So, we should install executable commands in <filename>/usr/bin</filename> instead of <filename>/usr/local/bin</filename>, the manual page in <filename>/usr/share/man/man1</filename> instead of <filename>/usr/local/man/man1</filename>, and so on.  Notice how there's no manual page mentioned in <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename>, but since Debian Policy requires that every program has one, we'll make one later and install it in <filename>/usr/share/man/man1</filename>.
ru: Итак, исполняемые файлы следует устанавливать в <filename>/usr/bin</filename> вместо <filename>/usr/local/bin</filename>, справочные страницы в <filename>/usr/share/man/man1</filename> вместо <filename>/usr/local/man/man1</filename> и т.д. Обратите внимание, что хотя в <filename>Makefile</filename> из пакета <systemitem role="package">gentoo</systemitem> отсутствует упоминание о справочной странице, Debian Policy требует её наличия для каждой программы, поэтому позднее мы создадим такую страницу и установим её в <filename>/usr/share/man/man1</filename>.

note: type: Content of: <book><chapter><section><para>
en: Some programs don't use <filename>Makefile</filename> variables to define paths such as these.  This means you might have to edit some real C sources in order to fix them to use the right locations.  But where to search, and exactly what for? You can find this out by issuing:
ru: Некоторые программы не используют переменные в <filename>Makefile</filename> для подобного указания путей. Это означает, что, возможно, вам придётся редактировать исходные файлы, написанные на языке C, для указания правильного расположения. Но где и как искать эти пути? Для этого вы можете воспользоваться следующей командой:

note: type: Content of: <book><chapter><section><para>
en: <command>grep</command> will run recursively through the source tree and tell you the filename and the line number for all matches.
ru: Команда <command>grep</command> рекурсивно обходит всё дерево исходного кода и при обнаружении совпадений сообщает вам имя соответствующего файла и номер строки.

note: type: Content of: <book><chapter><section><para>
en: Edit those files and in those lines replace <literal>usr/local/lib</literal> with <literal>usr/lib</literal>.  This can be done automatically as follows:
ru: Отредактируйте указанные строки в этих файлах, заменив <literal>usr/local/lib</literal> на <literal>usr/lib</literal>. Это можно сделать автоматически с помощью команды:

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
ru: Если вы хотите подтверждать каждую замену, запустите следующую команду:

note: type: Content of: <book><chapter><section><para>
en: Next you should find the <literal>install</literal> target (searching for the line that starts with <literal>install:</literal> will usually work) and rename all references to directories other than ones defined at the top of the <filename>Makefile</filename>.
ru: После этого вам нужно найти цель <literal>install</literal> (обычно достаточно найти строку, начинающуюся с <literal>install:</literal>) и заменить все ссылки на каталоги, которые отличаются от указанных в начале файла <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
ru: Первоначально, цель <literal>install</literal> в  <systemitem role="package">gentoo</systemitem> была такой:

note: type: Content of: <book><chapter><section><para>
en: Let's fix this upstream bug and record it with the <command>dquilt</command> command as <filename>debian/patches/install.patch</filename>.
ru: Давайте исправим ошибку с путями в исходной программе и запишем её при помощи команды <command>dquilt</command> в файл <filename>debian/patches/install.patch</filename>.

note: type: Content of: <book><chapter><section><para>
en: In your editor, change this for the Debian package as follows:
ru: Воспользуемся редактором для внесения в пакет Debian следующих изменений:

note: type: Content of: <book><chapter><section><para>
en: You'll have noticed that there's now an <literal>install -d</literal> command before the other commands in the rule.  The original <filename>Makefile</filename> didn't have it because usually <literal>/usr/local/bin</literal> and other directories already exist on the system where you are running <literal>make install</literal>.  However, since we will be installing into a newly created private directory tree, we will have to create each and every one of those directories.
ru: Разумеется вы заметили, что в начале цели появилась команда <literal>install -d</literal>. В исходном <filename>Makefile</filename> её не было, так как обычно <literal>/usr/local/bin</literal> и другие каталоги уже существуют в системе на момент запуска <literal>make install</literal>. Однако, так как мы будем проводить установку в создаваемый каждый раз свой каталог, нам следует создать в нём все необходимые каталоги.

note: type: Content of: <book><chapter><section><para>
en: We can also add in other things at the end of the rule, like the installation of additional documentation that the upstream authors sometimes omit:
ru: В конец правила установки мы можем добавить что-нибудь ещё, например, установку дополнительной документации, которую не включили авторы программы:

note: type: Content of: <book><chapter><section><para>
en: Check carefully, and if everything is okay, ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/install.patch</filename> and add its description:
ru: Убедившись, что всё сделано правильно, c помощью <command>dquilt</command> сгенерируем заплату <filename>debian/patches/install.patch</filename> и добавим её описание:

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
ru: Теперь у вас есть несколько заплат:

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
ru: Заплата для исправления ошибки в программе: <filename>debian/patches/fix-gentoo-target.patch</filename>

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Debian specific packaging modification: <filename>debian/patches/install.patch</filename>
ru: Изменения, необходимые для создания пакета Debian: <filename>debian/patches/install.patch</filename>

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
ru: Не отправляйте разработчикам программы файлы <filename>debian/*</filename>.

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
ru: Несовпадение библиотек

note: type: Content of: <book><chapter><section><para>
en: Let's assume a line in your program's <filename>Makefile</filename> (or <filename>Makefile.in</filename>) as the following.
ru: Предположим, что в программе есть <filename>Makefile</filename> (или <filename>Makefile.in</filename>) со строкой следующего вида:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If there are API changes from the <literal>foo</literal> library to the <literal>foo2</literal> library, required changes to the source code need to be made to match the new API.
ru: Если изменяется программный интерфейс (API) (то есть, вместо библиотеки <literal>foo</literal> начинают использовать библиотеку <literal>foo2</literal>), то требуется изменить исходный код так, чтобы он использовал новый API.

note: type: Content of: <book><chapter><section><para>
en: If your program doesn't compile since the <literal>foo</literal> library doesn't exist and its equivalent is provided by the <literal>foo2</literal> library on the Debian system, you can fix this build problem as <filename>debian/patches/foo2.patch</filename> by changing <literal>foo</literal> into <literal>foo2</literal>:<placeholder type="footnote" id="0"/>
ru: Если ваша программа не компилируется из-за отсутствия библиотеки <literal>foo</literal> и в Debian для неё есть замена в виде <literal>foo2</literal>, то вы можете исправить проблему со сборкой с помощью <filename>debian/patches/foo2.patch</filename>, который заменяет <literal>foo</literal> на <literal>foo2</literal>:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
ru: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... описание заплаты

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
ru: Обязательные файлы в каталоге <filename>debian</filename>

note: type: Content of: <book><chapter><para>
en: In this chapter, files in the <filename>debian</filename> directory are referred to without the leading <filename>debian/</filename> for simplicity whenever the meaning is obvious.
ru: Для простоты в этой главе файлы в каталоге <filename>debian</filename> указаны без начального <filename>debian/</filename>.

note: type: Content of: <book><chapter><para>
en: There is a new subdirectory under the program's source directory, called <filename>debian</filename>.  There are a number of files in this directory that we should edit in order to customize the behavior of the package.  The most important of them are <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename>, and <filename>rules</filename>, which are required for all packages.  <placeholder type="footnote" id="0"/>
ru: В каталоге c исходным кодом программы появился новый подкаталог <filename>debian</filename>. В нём содержится несколько файлов, которые нужно отредактировать для изменения свойств пакета. Наиболее важные из них: <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename> и <filename>rules</filename>; они обязательны для всех пакетов <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>control</filename>
ru: Файл <filename>control</filename>

note: type: Content of: <book><chapter><section><para>
en: This file contains various values which <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command>, and other package management tools will use to manage the package.  It is defined by the <ulink url="&policy-control;">Debian Policy Manual, 5 "Control files and their fields"</ulink>.
ru: Этот файл содержит информацию, которая используется программами <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command> и некоторыми другими инструментами для работы c пакетами. Он описан в <ulink url="&policy-control;">руководстве по политике Debian, в главе 5 «Управляющие файлы и их поля»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
ru: Вот, например, файл <filename>control</filename>, который был создан для нас программой <command>dh_make</command>:

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
ru: (номера строк добавлены для наглядности)

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
ru: В строке 1 содержится название пакета с исходным кодом.

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
ru: В строке 2 содержится название раздела в дистрибутиве, к которому относится пакет с исходным кодом.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 "Sections"</ulink> and <ulink url="&sections-unstable;">List of sections in <literal>sid</literal></ulink>.
ru: Смотрите <ulink url="&policy-subsections;">руководство по политике Debian, раздел 2.4 «Разделы»</ulink> и <ulink url="&sections-unstable;">список разделов в <literal>sid</literal></ulink>.

note: type: Content of: <book><chapter><section><para>
en: As you may have noticed, the Debian archive is divided into multiple areas: <literal>main</literal> (the free software), <literal>non-free</literal> (the not really free software) and <literal>contrib</literal> (free software that depends on non-free software).  Each of these is divided into sections that classify packages into rough categories.  So we have <literal>admin</literal> for administrator-only programs, <literal>devel</literal> for programmer tools, <literal>doc</literal> for documentation, <literal>libs</literal> for libraries, <literal>mail</literal> for email readers and daemons, <literal>net</literal> for network apps and daemons, <literal>x11</literal> for X11 programs that don't fit anywhere else, and many more.  <placeholder type="footnote" id="0"/>
ru: Возможно вы уже заметили, что архив Debian разбит на несколько областей: <literal>main</literal> (свободное ПО), <literal>non-free</literal> (не совсем свободное ПО) и <literal>contrib</literal> (свободное ПО, зависящее от несвободного ПО). Каждая из них делится на разделы, чтобы приближённо разделить пакеты по категориям. Так, в <literal>admin</literal> содержатся программы только для администратора, в <literal>devel</literal> хранятся инструменты разработки ПО, в <literal>doc</literal> содержится документация, в <literal>libs</literal> содержатся библиотеки, в <literal>mail</literal> содержатся почтовые серверы и программы чтения почты, в <literal>net</literal> содержатся сетевые приложения и службы, в <literal>x11</literal> содержатся программы для X11, которые не вошли куда-то ещё, и так далее <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Let's change it then to x11.  (A <literal>main/</literal> prefix is implied so we can omit it.)
ru: В нашем случае мы должны указать x11 (префикс <literal>main/</literal> указывать не обязательно — он подставляется по умолчанию).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
ru: Смотрите <ulink url="&policy-priorities;">руководство по политике Debian, раздел 2.5 «Приоритеты»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 3 describes how important it is that the user installs this package.  <placeholder type="footnote" id="0"/>
ru: В строке 3 указывается насколько важен данный пакет <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <literal>optional</literal> priority will usually work for new packages that do not conflict with others claiming <literal>required</literal>, <literal>important</literal>, or <literal>standard</literal> priority.
ru: Приоритет <literal>optional</literal>, обычно, назначается новым пакетам, которые не конфликтуют с другими, имеющими приоритет <literal>required</literal>, <literal>important</literal> или <literal>standard</literal>.

note: type: Content of: <book><chapter><section><para>
en: Section and priority are used by front-ends like <command>aptitude</command> when they sort packages and select defaults.  Once you upload the package to Debian, the value of these two fields can be overridden by the archive maintainers, in which case you will be notified by email.
ru: Значения раздела и приоритета учитываются в интерфейсах управления пакетами (например, в <command>aptitude</command>) при сортировке и выборе пакетов. При размещении пакета в архиве Debian значения этих полей могут быть изменены администратором архива, о чём вам будет сообщено по электронной почте.

note: type: Content of: <book><chapter><section><para>
en: As this is a normal priority package and doesn't conflict with anything else, we will change the priority to <literal>optional</literal>.
ru: Так как наш пакет имеет обычный приоритет и не конфликтует с другими, мы укажем значение приоритета <literal>optional</literal>.

note: type: Content of: <book><chapter><section><para>
en: Line 4 is the name and email address of the maintainer.  Make sure that this field includes a valid <literal>To</literal> header for email, because after you upload it, the bug tracking system will use it to deliver bug emails to you.  Avoid using commas, ampersands, or parentheses.
ru: В строке 4 указано имя и адрес электронной почты сопровождающего. Убедитесь, что это значение пригодно для поля <literal>To</literal> заголовка электронной почты, потому что после загрузки пакета в архив это значение будет использовано системой отслеживания ошибок для связи с вами. Не используйте в этой строке запятые, скобки и амперсанд.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 "Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink>.
ru: Смотрите <ulink url="&policy-relationships;#s-sourcebinarydeps">руководство по политике Debian, раздел 7.7 «Связи между пакетами с исходным кодом и двоичными пакетами — Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep»</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For all packages packaged with the <command>dh</command> command in the <filename>debian/rules</filename> file, you must have <literal>debhelper (&gt;=9)</literal> in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
ru: Для всех пакетов, упаковываемых с помощью команды <command>dh</command>, в файле <filename>debian/rules</filename> вам потребуется указать <literal>debhelper (&gt;=9)</literal> в поле <literal>Build-Depends</literal> для соответствия требованиям политики Debian, касающимся цели <literal>clean</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For source packages with binary packages all of which are <literal>Architecture: all</literal>, the <literal>Build-Depends-Indep</literal> field may list all the required packages unless they are already listed in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
ru: В пакетах с исходным кодом, в двоичных пакетах которых указано <literal>Architecture: all</literal>, поле <literal>Build-Depends-Indep</literal> может содержать все требуемые пакеты, не перечисленные в <literal>Build-Depends</literal>, для соответствия требованиям политики Debian, касающимся цели <literal>clean</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This somewhat strange situation is a feature well documented in the <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  This is not due to the use of the <command>dh</command> command in the <filename>debian/rules</filename> file but due to how the <command>dpkg-buildpackage</command> works.  The same situation applies to the <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">auto build system for Ubuntu</ulink>.
ru: Эта несколько странная ситуация является хорошо документированной возможностью, описанной  в <ulink url="&policy-build-depends-indep;">руководстве по политике Debian, сноска 55</ulink>. Причина не в использовании команды <command>dh</command> в файле <filename>debian/rules</filename>, а в специфике работы <command>dpkg-buildpackage</command>. Аналогичный случай встречается в <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">системе автоматической сборки Ubuntu</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If you are not sure which one should be used, use the <literal>Build-Depends</literal> field to be on the safe side.  <placeholder type="footnote" id="0"/>
ru: Если вы не знаете, какое из двух полей использовать — остановитесь на поле <literal>Build-Depends</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: To find out what packages your package needs to be built run the command:
ru: Для выяснения того, какие пакеты требуются для сборки, выполните команду:

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
ru: Для ручного, более точного поиска зависимостей программы <command><replaceable>/usr/bin/foo</replaceable></command> выполните:

note: type: Content of: <book><chapter><section><para>
en: Then just take the <literal>-dev</literal> version of every package as a <literal>Build-Depends</literal> entry.  If you use <command>ldd</command> for this purpose, it will report indirect lib dependencies as well, resulting in the problem of excessive build dependencies.
ru: Затем укажите <literal>-dev</literal> версию каждого пакета в поле <literal>Build-Depends</literal>. Если для этой цели воспользоваться <command>ldd</command>, то вы, помимо прочего, узнаете неявные библиотечные зависимости библиотеки и столкнётесь с проблемой избыточных сборочных зависимостей.

note: type: Content of: <book><chapter><section><para>
en: <systemitem role="package">gentoo</systemitem> also happens to require <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> and <systemitem role="package">libglib1.2-dev</systemitem> to build, so we'll add them here next to <systemitem role="package">debhelper</systemitem>.
ru: Кроме того, пакет <systemitem role="package">gentoo</systemitem> требует для сборки пакеты <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> и <systemitem role="package">libglib1.2-dev</systemitem>. Укажите их после пакета <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: Line 6 is the version of the <ulink url="&debian-policy;">Debian Policy Manual</ulink> standards this package follows, the one you read while making your package.
ru: В строке 6 указывается версия документа <ulink url="&debian-policy;">руководства по политике Debian</ulink>, стандартам которого следует данный пакет. Прочитайте его при создании пакета.

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
ru: В строке 7 можно указать URL домашней страницы программы.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the name of the binary package.  This is usually the same as the name of the source package, but it doesn't necessarily have to be that way.
ru: В строке 9 содержится имя двоичного пакета. Обычно, оно совпадает с именем пакета с исходным кодом, но это не является обязательным требованием.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> for exact details.
ru: Подробней об этом смотрите в <ulink url="&policy-architecture;">руководстве по политике Debian, раздел 5.6.8 «Architecture»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 10 describes the architectures the binary package can be compiled for.  This value is usually one of the following depending on the type of the binary package: <placeholder type="footnote" id="0"/>
ru: В строке 10 перечислены архитектуры двоичного пакета, для которых он может быть скомпилирован. Обычно, здесь указывает одно из следующих значений, в зависимости от типа двоичного пакета <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture dependent one usually in a compiled language.
ru: Генерируемый двоичный пакет зависит от архитектуры, обычно определяемой компилируемым языком.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture independent one usually consisting of text, images, or scripts in an interpreted language.
ru: Генерируемый двоичный пакет не зависит от архитектуры, обычно в нём содержится текст, изображения или сценарии интерпретируемого языка.

note: type: Content of: <book><chapter><section><para>
en: We leave line 10 as is since this is written in C.  <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> will fill in the appropriate architecture value for any machine this source package gets compiled on.
ru: Мы не будет менять строку 10, так как программа написана на C. Утилита <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> подставит соответствующее значение архитектуры машины, на которой будет скомпилирован пакет с исходным кодом.

note: type: Content of: <book><chapter><section><para>
en: If your package is architecture independent (for example, a shell or Perl script, or a document), change this to <literal>all</literal>, and read later in <xref linkend="rules"/> about using the <literal>binary-indep</literal> rule instead of <literal>binary-arch</literal> for building the package.
ru: Если ваш пакет не зависит от архитектуры (например, это документ, сценарий оболочки или Perl), укажите значение <literal>all</literal> и прочитайте <xref linkend="rules"/>, в котором описаны правила использования <literal>binary-indep</literal> вместо <literal>binary-arch</literal>.

note: type: Content of: <book><chapter><section><para>
en: Line 11 shows one of the most powerful features of the Debian packaging system.  Packages can relate to each other in various ways.  Apart from <literal>Depends</literal>, other relationship fields are <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal>, and <literal>Replaces</literal>.
ru: В строке 11 показана одна из мощнейших сторон пакетной системы Debian. Пакеты могут быть связаны друг с другом различными способами. Кроме поля <literal>Depends</literal> за отношения между пакетами отвечают <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal> и <literal>Replaces</literal>.

note: type: Content of: <book><chapter><section><para>
en: The package management tools usually behave the same way when dealing with these relations; if not, it will be explained.  (See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, etc.)
ru: Инструменты управления пакетами, обычно, одинаковым образом обрабатывают эти связи; если это так, то будет приведён комментарий (смотрите <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> и т.д.).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.
ru: Смотрите <ulink url="&policy-relationships;">руководство по политике Debian, главу 7 «Объявление связей между пакетами»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
ru: Вот упрощённое описание связей между пакетами <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed unless the packages it depends on are installed.  Use this if your program absolutely will not run (or will cause severe breakage) unless a particular package is present.
ru: Пакет не будет установлен, пока не установлены пакеты, от которых он зависит. Используйте этот тип зависимости, если ваша программа гарантировано не будет работать (или вызовет какие-нибудь серьезные проблемы) при отсутствии какого-то пакета.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages that are not strictly necessary but are typically used with your program.  When a user installs your program, all front-ends will probably prompt them to install the recommended packages.  <command>aptitude</command> and <command>apt-get</command> install recommended packages along with your package by default (but the user can disable this behavior).  <command>dpkg</command> will ignore this field.
ru: Используйте это поле для пакетов, которые не обязательны, но обычно используются с вашей программой. При установке программы все интерфейсы управления пакетами предложат пользователю установить и рекомендуемые пакеты. Утилиты <command>aptitude</command> и <command>apt-get</command> по умолчанию (которое можно изменить) автоматически устанавливают рекомендуемые пакеты вместе с пакетом. Утилита <command>dpkg</command> игнорирует это поле.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages which will work nicely with your program but are not at all necessary.  When a user installs your program, they will probably not be prompted to install suggested packages.  <command>aptitude</command> can be configured to install suggested packages along with your package but this is not its default.  <command>dpkg</command> and <command>apt-get</command> will ignore this field.
ru: Используйте это поле для пакетов, которые отлично дополнят вашу программу, но не требуются для её работы. При установке программы интерфейсы управления пакетами, обычно, не предлагают пользователю установить такие пакеты. В <command>aptitude</command> можно включить автоматическую установку этих предлагаемых (suggested) пакетов (по умолчанию не выполняется). Программы <command>dpkg</command> и <command>apt-get</command> игнорируют это поле.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is stronger than <literal>Depends</literal>.  The package will not be installed unless the packages it pre-depends on are installed and <emphasis>correctly configured</emphasis>.  Use this <emphasis>very</emphasis> sparingly and only after discussing it on the <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink> mailing list.  Read: don't use it at all.  :-)
ru: В этом поле указываются более важные зависимости, чем в <literal>Depends</literal>. Пакет не будет установлен, если какие-либо пакеты из числа таких зависимостей не установлены, либо <emphasis>не правильно настроены</emphasis>. Используйте это поле <emphasis>очень</emphasis> осторожно и только после обсуждения в рассылке <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>. Ещё лучше — не используйте его вообще :-)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed until all the packages it conflicts with have been removed.  Use this if your program absolutely will not run or will cause severe problems if a particular package is present.
ru: Пакет не будет установлен, пока все перечисленные в этом поле пакеты не будут удалены. Используйте это поле только, если ваша программа не будет запускаться, либо возникнут серьёзные проблемы при наличии этих пакетов.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: When installed the package will break all the listed packages.  Normally a <literal>Breaks</literal> entry specifies that it applies to versions earlier than a certain value.  The resolution is generally to use higher-level package management tools to upgrade the listed packages.
ru: Если пакет будет установлен, то работоспособность всех перечисленных пакетов будет нарушена. Чаще всего, в поле <literal>Breaks</literal> указываются пакеты с уточнением версии типа «старее чем». Утилиты управления пакетами, обычно, предлагают обновить перечисленные пакеты до более новых версий.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this when your program replaces files from another package, or completely replaces another package (used in conjunction with <literal>Conflicts</literal>).  Files from the named packages will be overwritten with the files from your package.
ru: Используйте данное поле, если ваш пакет заменяет файлы из другого пакета или же полностью заменяет другой пакет (в этом случае вы также должны использовать поле <literal>Conflicts</literal>). В этом случае файлы из указанного пакета будут перезаписаны файлами из вашего.

note: type: Content of: <book><chapter><section><para>
en: All these fields have uniform syntax.  They are a list of package names separated by commas.  These package names may also be lists of alternative package names, separated by vertical bar symbols <literal>|</literal> (pipe symbols).
ru: Формат всех этих полей одинаков. Он представляет собой список имён пакетов, разделённых запятыми. Здесь также могут быть указаны имена альтернативных пакетов, разделённые вертикальной чертой <literal>|</literal> (символ канала).

note: type: Content of: <book><chapter><section><para>
en: The fields may restrict their applicability to particular versions of each named package.  The restriction of each individual package is listed in parentheses after its name, and should contain a relation from the list below followed by a version number value.  The relations allowed are: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, and <literal>&gt;&gt;</literal> for strictly lower, lower or equal, exactly equal, greater or equal, and strictly greater, respectively.  For example,
ru: Для каждого пакета в списке можно указать версии, которых касается данная зависимость. Версии указываются в круглых скобках после имени пакета и должны состоять из символа сравнения, за которым следует номер версии. Допустимыми символами сравнения являются: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal> и <literal>&gt;&gt;</literal> для «строго раньше», «раньше или равно», «в точности равно», «равно или позже» и «строго позже», соответственно. Например:

note: type: Content of: <book><chapter><section><para>
en: The last feature you need to know about is <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
ru: В завершение рассмотрим конструкции <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal> и прочие.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates shared library dependencies for binary packages.  It generates a list of <ulink url="&elf;">ELF</ulink> executables and shared libraries it has found for each binary package.  This list is used for substituting <literal>${shlibs:Depends}</literal>.
ru: Утилита <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> вычисляет зависимости двоичного пакета от общих библиотек. Она генерирует список исполняемых файлов <ulink url="&elf;">ELF</ulink>  и общих библиотек, которые находит для каждого двоичного пакета. Этот список подставляется вместо <literal>${shlibs:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates Perl dependencies.  It generates a list of a dependencies on <literal>perl</literal> or <literal>perlapi</literal> for each binary package.  This list is used for substituting <literal>${perl:Depends}</literal>.
ru: Утилита <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> вычисляет зависимости Perl. Она генерирует список зависимостей от <literal>perl</literal> или <literal>perlapi</literal> для каждого двоичного пакета. Этот список подставляется вместо <literal>${perl:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: Some <systemitem role="package">debhelper</systemitem> commands may cause the generated package to depend on some additional packages.  All such commands generate a list of required packages for each binary package.  This list is used for substituting <literal>${misc:Depends}</literal>.
ru: Некоторые команды пакета <systemitem role="package">debhelper</systemitem> могут добавлять зависимости к вашему генерируемому пакету. Каждая команда генерирует список необходимых пакетов для каждого двоичного пакета. Этот список подставляется вместо <literal>${misc:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> generates <filename>DEBIAN/control</filename> for each binary package while substituting <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
ru: Утилита <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> генерирует файл <filename>DEBIAN/control</filename> для каждого двоичного пакета, заменяя <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal> и т.д на полученные значения.

note: type: Content of: <book><chapter><section><para>
en: Having said all that, we can leave the <literal>Depends</literal> field exactly as it is now, and insert another line after it saying <literal>Suggests: file</literal>, because <systemitem role="package">gentoo</systemitem> can use some features provided by the <systemitem role="package">file</systemitem> package.
ru: В нашем случае, мы можем оставить поле <literal>Depends</literal> без изменений и добавить после него строчку <literal>Suggests: file</literal>, так как пакет <systemitem role="package">gentoo</systemitem> использует некоторые возможности пакета <systemitem role="package">file</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the Homepage URL.  Let's assume this to be at <ulink url="&gentoo;"/>.
ru: В строке 9 указан URL домашней страницы программы. Предположим, что это будет <ulink url="&gentoo;"/>.

note: type: Content of: <book><chapter><section><para>
en: Line 12 is the short description.  Terminals are conventionally 80 columns wide so this shouldn't be longer than about 60 characters.  I'll change it to <literal>fully GUI-configurable, two-pane X file manager</literal>.
ru: В строке 12 содержится краткое описание пакета. Размер экрана у большинства пользователей имеет 80 столбцов, поэтому постарайтесь ограничить описание шестьюдесятью символами. В нашем случае, заполним поле следующим текстом: <literal>fully GUI-configurable, two-pane X file manager</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: These descriptions are in English.  Translations of these descriptions are provided by <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.
ru: Эти описания составляются на английском языке. Переводы описаний выполняются через <ulink url="&ddtp;">проект переводов описаний Debian — DDTP</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 13 is where the long description goes.  This should be a paragraph which gives more details about the package.  Column 1 of each line should be empty.  There must be no blank lines, but you can put a single <literal>.</literal> (dot) in a column to simulate that.  Also, there must be no more than one blank line after the long description. <placeholder type="footnote" id="0"/>
ru: В строке 13 указывается длинное описание. Это должен быть абзац, содержащий более полную информацию о пакете. Каждая строка должна начинаться с пробела. В тексте не должно быть пустых строк. Если пустая строка всё же требуется, то поставьте точку (<literal>.</literal>) в первом столбце. Не выводите более одной пустой строки после длинного описания <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-bpp-vcs;">Debian Developer's Reference, 6.2.5. "Version Control System location"</ulink>.
ru: Смотрите <ulink url="&devref-bpp-vcs;">справочник разработчика Debian, раздел 6.2.5. «Местонахождение системы контроля версий»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: We can insert <literal>Vcs-*</literal> fields to document the Version Control System (VCS) location between lines 6 and 7.  <placeholder type="footnote" id="0"/> Let's assume that the <systemitem role="package">gentoo</systemitem> package has its VCS located in the Debian Alioth Git Service at <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.
ru: Давайте вставим поля <literal>Vcs-*</literal> для указания местонахождения системы контроля версий между строкой 6 и 7 <placeholder type="footnote" id="0"/>. Предположим, что пакет <systemitem role="package">gentoo</systemitem> в качестве VCS использует сервис Debian Alioth Git по адресу <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.

note: type: Content of: <book><chapter><section><para>
en: Finally, here is the updated <filename>control</filename> file:
ru: Вот обновлённый файл <filename>control</filename>:

note: type: Content of: <book><chapter><section><title>
en: <filename>copyright</filename>
ru: Файл <filename>copyright</filename>

note: type: Content of: <book><chapter><section><para>
en: This file contains information about the copyright and license of the upstream sources.  <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> dictates its content and <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> provides guidelines for its format.
ru: Этот файл содержит информацию об авторских правах и лицензионное соглашение исходной программы. Его содержание определяется в <ulink url="&policy-copyright;">руководстве по политике Debian, разделе 12.5 «Информация об авторских правах»</ulink>, а формат описан в <ulink url="&dep5;">DEP-5: автоматизируемый <filename>debian/copyright</filename></ulink>.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> can give you a template <filename>copyright</filename> file.  Let's use the <literal>--copyright gpl2</literal> option here to get a template file for the <systemitem role="package">gentoo</systemitem> package released under GPL-2.
ru: Шаблон файла <filename>copyright</filename> можно создать с помощью <command>dh_make</command>. Укажем параметр <literal>--copyright gpl2</literal>, чтобы получить файл шаблона для пакета <systemitem role="package">gentoo</systemitem>, выпущенного с лицензией GPL-2.

note: type: Content of: <book><chapter><section><para>
en: In short, here's what <systemitem role="package">gentoo</systemitem>'s <filename>copyright</filename> file should look like:
ru: Вкратце, вот как должен выглядеть файл <filename>copyright</filename> для пакета <systemitem role="package">gentoo</systemitem>:

note: type: Content of: <book><chapter><section><para>
en: Please follow the HOWTO provided by the ftpmasters and sent to debian-devel-announce: <ulink url="&howto-copyright;"/>.
ru: Следуйте HOWTO, написанному ftpmaster-ами, и пошлите анонс в debian-devel-announce: <ulink url="&howto-copyright;"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>changelog</filename>
ru: Файл <filename>changelog</filename>

note: type: Content of: <book><chapter><section><para>
en: This is a required file, which has a special format described in <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>.  This format is used by <command>dpkg</command> and other programs to obtain the version number, revision, distribution, and urgency of your package.
ru: Это обязательный файл, его специальный формат описан в <ulink url="&policy-dpkgchangelog;">руководстве по политике Debian, раздел 4.4 «debian/changelog»</ulink>. Этот формат используется программой <command>dpkg</command> и другими для получения информации о номере версии, редакции, разделе и срочности пакета.

note: type: Content of: <book><chapter><section><para>
en: For you, it is also important, since it is good to have documented all changes you have done.  It will help people downloading your package to see whether there are issues with the package that they should know about.  It will be saved as <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> in the binary package.
ru: Для вас он также важен, так как является хорошим местом для описания всех изменений, которые вы сделали. Это поможет людям, скачавшим ваш пакет, определить, какие выпуски есть у пакета, о которых они должны знать. Он будет сохранён как <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> в двоичном пакете.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
ru: Программа <command>dh_make</command> создает файл по умолчанию, похожий на этот:

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
ru: Теперь файл будет выглядеть так:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: If you use the <literal>dch -r</literal> command to make this last change, please make sure to save the <filename>changelog</filename> file explicitly by the editor.
ru: Если для выполнения изменения вы используете команду <literal>dch -r</literal>, то убедитесь, что записали файл <filename>changelog</filename> именно редактором.

note: type: Content of: <book><chapter><section><para>
en: Once you are satisfied with all the changes and documented them in <filename>changelog</filename>, you should change the distribution value from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).  <placeholder type="footnote" id="0"/>
ru: После проверки правильности всех изменений и их описания в <filename>changelog</filename>, измените имя выпуска с <literal>UNRELEASED</literal> на значение целевого дистрибутива <literal>unstable</literal> (или даже на <literal>experimental</literal>). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can read more about updating the <filename>changelog</filename> file later in <xref linkend="update"/>.
ru: Дополнительную информацию об обновлении файла <filename>changelog</filename> можно найти далее в <xref linkend="update"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>rules</filename>
ru: Файл <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
ru: Цели из файла <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> explains the details.
ru: В <ulink url="&policy-debianrules;">руководстве по политике Debian, раздел 4.9 «Главный сценарий сборки: debian/rules»</ulink> этот файл описан подробно.

note: type: Content of: <book><chapter><section><section><para>
en: Every <filename>rules</filename> file, like any other <filename>Makefile</filename>, consists of several rules, each of which defines a target and how it is carried out.  <placeholder type="footnote" id="0"/> A new rule begins with its target declaration in the first column.  The following lines beginning with the TAB code (ASCII 9) specify the recipe for carrying out that target.  Empty lines and lines beginning with <literal>#</literal> (hash) are treated as comments and ignored.  <placeholder type="footnote" id="1"/>
ru: Файл <filename>rules</filename>, как и любой <filename>Makefile</filename>, состоит из нескольких правил, каждое из которых описывает цель и способ её достижения <placeholder type="footnote" id="0"/>. Новое правило начинается с объявления цели в первой колонке. Следующие за ним строки начинаются с кода TAB (ASCII 9); в них описывается команды достижения цели. Пустые строки и строки, начинающиеся с <literal>#</literal> (решётка), считаются комментариями и игнорируются <placeholder type="footnote" id="1"/>.

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
ru: Упрощённое объяснение целей:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>clean</literal> target: to clean all compiled, generated, and useless files in the build-tree.  (Required)
ru: Цель <literal>clean</literal> служит для удаления всех скомпилированных, сгенерированных и бесполезных файлов в дереве сборки (требуемая).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build</literal> target: to build the source into compiled programs and formatted documents in the build-tree.  (Required)
ru: Цель <literal>build</literal> служит для сборки исходного кода в скомпилированные программы и отформатированные документы в дереве сборки (требуемая).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-arch</literal> target: to build the source into arch-dependent compiled programs in the build-tree.  (Required)
ru: Цель <literal>build-arch</literal> служит для сборки исходного кода в независящие от архитектуры скомпилированные программы в дереве сборки (требуемая).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-indep</literal> target: to build the source into arch-independent formatted documents in the build-tree.  (Required)
ru: Цель <literal>build-indep</literal> служит для сборки исходного кода в независящие от архитектуры отформатированные документы в дереве сборки (требуемая).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>install</literal> target: to install files into a file tree for each binary package under the <filename>debian</filename> directory.  If defined, <literal>binary*</literal> targets effectively depend on this target.  (Optional)
ru: Цель <literal>install</literal> служит для установки файлов в дерево файлов для каждого двоичного пакета из каталога <filename>debian</filename> (необязательная). Цели <literal>binary*</literal> непосредственно зависят от этой цели.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage</literal> as in <xref linkend="completebuild"/>.
ru: Эта цель используется <literal>dpkg-buildpackage</literal> как описано в <xref linkend="completebuild"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary</literal> target: to create all binary packages (effectively a combination of <literal>binary-arch</literal> and <literal>binary-indep</literal> targets).  (Required)<placeholder type="footnote" id="0"/>
ru: Цель <literal>binary</literal> служит для создания всех двоичных пакетов (комбинация целей <literal>binary-arch</literal> и <literal>binary-indep</literal>) (требуемая) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -B</literal> as in <xref linkend="autobuilder"/>.
ru: Эта цель используется <literal>dpkg-buildpackage -B</literal>, как описано в <xref linkend="autobuilder"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-arch</literal> target: to create arch-dependent (<literal>Architecture: any</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
ru: Цель <literal>binary-arch</literal> служит для создания двоичных пакетов, зависящих от архитектуры (<literal>Architecture: any</literal>), в родительском каталоге (требуемая) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -A</literal>.
ru: Эта цель используется <literal>dpkg-buildpackage -A</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-indep</literal> target: to create arch-independent (<literal>Architecture: all</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
ru: Цель <literal>binary-indep</literal> служит для создания двоичных пакетов, независящих от архитектуры (<literal>Architecture: all</literal>), в родительском каталоге (требуемая) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>get-orig-source</literal> target: to obtain the most recent version of the original source package from an upstream archive.  (Optional)
ru: Цель <literal>get-orig-source</literal> служит для получения самой новой версии пакета с оригинальным исходным кодом с сайта разработчика (необязательная).

note: type: Content of: <book><chapter><section><section><para>
en: You are probably overwhelmed by now, but things are much simpler upon examination of the <filename>rules</filename> file that <command>dh_make</command> gives us as a default.
ru: Возможное непонимание должно уйти после того, как вы посмотрите на содержимое файла <filename>rules</filename> по умолчанию, который создаётся программой <command>dh_make</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
ru: Файл <filename>rules</filename> по умолчанию

note: type: Content of: <book><chapter><section><section><para>
en: Newer <command>dh_make</command> generates a very simple but powerful default <filename>rules</filename> file using the <command>dh</command> command:
ru: Новая версия <command>dh_make</command> генерирует очень простой, но эффективный файл <filename>rules</filename> по умолчанию, использующий команду <command>dh</command>:

note: type: Content of: <book><chapter><section><section><para>
en: (I've added the line numbers and trimmed some comments.  In the actual <filename>rules</filename> file, the leading spaces are a TAB code.)
ru: (Для наглядности добавлены номера строк и удалены некоторые комментарии. В реальном файле <filename>rules</filename> начальные пробельные символы имеют код TAB.)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably familiar with lines like line 1 from shell and Perl scripts.  It tells the operating system that this file is to be processed with <filename>/usr/bin/make</filename>.
ru: Вероятно, вы знакомы с назначением строки 1 по сценариям оболочки и Perl. Она указывает операционной системе, что этот файл нужно обработать с помощью <filename>/usr/bin/make</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: Line 4 can be uncommented to set the <literal>DH_VERBOSE</literal> variable to 1, so that the <command>dh</command> command outputs which <command>dh_*</command> commands it is executing.  You can also add a line <literal>export DH_OPTIONS=-v</literal> here, so that each <command>dh_*</command> command outputs which commands it is executing.  This helps you to understand exactly what is going on behind this simple <filename>rules</filename> file and to debug its problems.  This new <command>dh</command> is designed to form a core part of the <systemitem role="package">debhelper</systemitem> tools, and not to hide anything from you.
ru: Строку 4 можно раскомментировать, установив значение переменной <literal>DH_VERBOSE</literal> равным 1. При этом команда <command>dh</command> будет выводить команды <command>dh_*</command>, которые она выполняет. Также, здесь вы можете добавить строку <literal>export DH_OPTIONS=-v</literal>. В этом случае каждая команда <command>dh_*</command> будет выводить все команды, которые она выполняет. Это помогает понять что в действительности происходит в этом простом файле <filename>rules</filename> и при решении проблем. Новая команда <command>dh</command> является основной инструментов <systemitem role="package">debhelper</systemitem> и не скрывает своих действий от вас.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules clean</literal> runs <literal>dh clean</literal>, which in turn runs the following:
ru: При запуске <literal>debian/rules clean</literal> выполняется команда <literal>dh clean</literal>, которая запускает другие:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: The following example assumes your <filename>debian/compat</filename> has a value equal or more than 9 to avoid invoking any python support commands automatically.
ru: В следующем примере предполагается, что ваш <filename>debian/compat</filename> содержит значение, равное 9 или более, что позволяет избежать автоматического вызова команд поддержки python.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: For complete information on what all these <command>dh_*</command> scripts do exactly, and what their other options are, please read their respective manual pages and the <systemitem role="package">debhelper</systemitem> documentation.
ru: Всю информацию о том, что делают сценарии <command>dh_*</command> и какие они имеют параметры, можно найти в их справочных страницах и документации к <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><section><para>
en: The functions of <command>dh_*</command> commands are largely self-evident from their names.  <placeholder type="footnote" id="0"/> There are a few notable ones that are worth giving (over)simplified explanations here assuming a typical build environment based on a <filename>Makefile</filename>: <placeholder type="footnote" id="1"/>
ru: Назначение команд <command>dh_*</command> практически полностью совпадает с их именами <placeholder type="footnote" id="0"/>. Вот несколько наиболее примечательных команд с упрощённым описанием, предполагающим использование типичной среды сборки на основе <filename>Makefile</filename> <placeholder type="footnote" id="1"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>distclean</literal>, <literal>realclean</literal>, or <literal>clean</literal>, and executes that.
ru: В действительности, в <filename>Makefile</filename> ищется и выполняется первая из доступных целей: <literal>distclean</literal>, <literal>realclean</literal> или <literal>clean</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_clean</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>distclean</literal> target.  <placeholder type="footnote" id="0"/>
ru: Если существует <filename>Makefile</filename> с целью <literal>distclean</literal>, то <command>dh_auto_clean</command>, обычно, выполняет следующее <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_configure</command> usually executes the following if <filename>./configure</filename> exists (arguments abbreviated for readability).
ru: Команда <command>dh_auto_configure</command>, обычно, выполняет следующее (если существует <filename>./configure</filename>; список аргументов сокращён для повышения читаемости):

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_build</command> usually executes the following to execute the first target of <filename>Makefile</filename> if it exists.
ru: Команда <command>dh_auto_build</command>, обычно, выполняет следующее для первой цели в <filename>Makefile</filename> (если он существует):

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>test</literal> or <literal>check</literal>, and executes that.
ru: В действительности, в <filename>Makefile</filename> ищется и выполняется первая из доступных целей: <literal>test</literal> или <literal>check</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_test</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>test</literal> target.  <placeholder type="footnote" id="0"/>
ru: Команда <command>dh_auto_test</command>, обычно, выполняет следующее (если существует <filename>Makefile</filename> с целью <literal>test</literal>; строка сокращена для повышения читаемости) <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_install</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>install</literal> target (line folded for readability).
ru: Команда <command>dh_auto_install</command>, обычно, выполняет следующее (если существует <filename>Makefile</filename> с целью <literal>install</literal>; строка сокращена для повышения читаемости):

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><screen>
en: make install \
      DESTDIR=<replaceable>/path/to</replaceable>/<replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>/debian/<replaceable>package</replaceable>
ru: make install \
      DESTDIR=<replaceable>/путь/к</replaceable>/<replaceable>пакету</replaceable>_<replaceable>версия</replaceable>-<replaceable>редакция</replaceable>/debian/<replaceable>пакет</replaceable>

note: type: Content of: <book><chapter><section><section><para>
en: All targets which require the <command>fakeroot</command> command will contain <command>dh_testroot</command>, which exits with an error if you are not using this command to pretend to be root.
ru: Цели, которым требуется команда <command>fakeroot</command>, содержат <command>dh_testroot</command>. Если вы не притворитесь root с помощью этой команды, то выполнение завершится с ошибкой.

note: type: Content of: <book><chapter><section><section><para>
en: The important part to know about the <filename>rules</filename> file created by <command>dh_make</command> is that it is just a suggestion.  It will work for most packages but for more complicated ones, don't be afraid to customize it to fit your needs.
ru: Важно учесть, что файл <filename>rules</filename>, созданный <command>dh_make</command>, это только предложение. Он будет работать для большинства пакетов, но в более сложных случаях не бойтесь изменять его под ваши нужды.

note: type: Content of: <book><chapter><section><section><para>
en: Although <literal>install</literal> is not a required target, it is supported.  <literal>fakeroot dh install</literal> behaves like <literal>fakeroot dh binary</literal> but stops after <command>dh_fixperms</command>.
ru: Хотя цель <literal>install</literal> не является обязательной, она всё равно поддерживается. Команда <literal>fakeroot dh install</literal> работает также как <literal>fakeroot dh binary</literal>, но останавливается после <command>dh_fixperms</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
ru: Доработка файла <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para>
en: There are many ways to customize the <filename>rules</filename> file created with the new <command>dh</command> command.
ru: Есть много способов доработать файл <filename>rules</filename>, созданный новой программой <command>dh</command>.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: If a package installs the <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>custom_name</replaceable>.pm</filename> file, you should activate its customization function by <literal>dh $@ --with <replaceable>custom-name</replaceable></literal>.
ru: Если с пакетом устанавливается файл <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>своё_имя</replaceable>.pm</filename>, то вам нужно активировать его функцию доработки командой <literal>dh $@ --with <replaceable>своё_имя</replaceable></literal>.

note: type: Content of: <book><chapter><section><section><para>
en: The <literal>dh $@</literal> command can be customized as follows: <placeholder type="footnote" id="0"/>
ru: Работу команды <literal>dh $@</literal> можно изменить следующим образом <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: Use of the <command>dh_python2</command> command is preferred over use of <command>dh_pysupport</command> or <command>dh_pycentral</command> commands.  Do not use the <command>dh_python</command> command.
ru: Команда <command>dh_python2</command> предпочтительнее, чем <command>dh_pysupport</command> или <command>dh_pycentral</command>. Не используйте команду <command>dh_python</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_python2</command> command.  (The best choice for Python.) <placeholder type="footnote" id="0"/>
ru: Добавление поддержки команды <command>dh_python2</command> (лучший выбор для Python) <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">python</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
ru: Используйте <literal>dh $@ --with python2</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python</systemitem> framework.
ru: Это позволяет работать с модулями Python, использующими инфраструктуру <systemitem role="package">python</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pysupport</command> command. (deprecated)
ru: Добавление поддержки команды <command>dh_pysupport</command> (устарела):

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-support</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">python-support</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
ru: Используйте <literal>dh $@ --with pysupport</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-support</systemitem> framework.
ru: Это позволяет работать с модулями Python, использующими инфраструктуру <systemitem role="package">python-support</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pycentral</command> command. (deprecated)
ru: Добавление поддержки команды <command>dh_pycentral</command> (устарела):

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-central</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">python-central</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python-central</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with python-central</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
ru: При этом отключается команда <command>dh_pysupport</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-central</systemitem> framework.
ru: Это позволяет работать с модулями Python, использующими инфраструктуру <systemitem role="package">python-central</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_installtex</command> command.
ru: Добавление поддержки команды <command>dh_installtex</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">tex-common</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">tex-common</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with tex</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with tex</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This registers Type 1 fonts, hyphenation patterns, and formats with TeX.
ru: Она регистрирует шрифты в формате Type 1, правила переносов или форматы в TeX.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands.
ru: Добавление поддержки команд <command>dh_quilt_patch</command> и <command>dh_quilt_unpatch</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">quilt</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">quilt</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with quilt</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with quilt</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This applies and un-applies patches to the upstream source from files in the <filename>debian/patches</filename> directory for a source package in the <literal>1.0</literal> format.
ru: Эта команда накладывает и откатывает заплаты на исходный код из файлов каталога <filename>debian/patches</filename> для пакетов с исходным кодом версии <literal>1.0</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This is not needed if you use the new <literal>3.0 (quilt)</literal> source package format.
ru: Она не требуется, если вы используете пакеты с исходным кодом новой версии <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_dkms</command> command.
ru: Добавление поддержки команды <command>dh_dkms</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dkms</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">dkms</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with dkms</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with dkms</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
ru: Это команда позволяет корректно использовать DKMS для пакетов с модулями ядра.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autotools-dev_updateconfig</command> and <command>dh_autotools-dev_restoreconfig</command> commands.
ru: Добавление поддержки команд <command>dh_autotools-dev_updateconfig</command> и <command>dh_autotools-dev_restoreconfig</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">autotools-dev</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">autotools-dev</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autotools-dev</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with autotools-dev</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates and restores <filename>config.sub</filename> and <filename>config.guess</filename>.
ru: Эта команда обновляет и восстанавливает <filename>config.sub</filename> и <filename>config.guess</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autoreconf</command> and <command>dh_autoreconf_clean</command> commands.
ru: Добавление поддержки команд <command>dh_autoreconf</command> и <command>dh_autoreconf_clean</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dh-autoreconf</systemitem> package in <literal>Build-Depends</literal>.
ru: В <literal>Build-Depends</literal> укажите пакет <systemitem role="package">dh-autoreconf</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autoreconf</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with autoreconf</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates the GNU Build System files and restores them after the build.
ru: Эта команда обновляет файлы GNU Build System и восстанавливает их после сборки.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
ru: Добавление поддержки команды <command>dh_girepository</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">gobject-introspection</systemitem> package in <literal>Build-Depends</literal>.
ru: Укажите пакет <systemitem role="package">gobject-introspection</systemitem> в <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with gir</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with gir</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This computes dependencies for packages shipping GObject introspection data and generates the <literal>${gir:Depends}</literal> substitution variable for the package dependency.
ru: Эта команда вычислит зависимости пакетов, содержащих описательные (introspection) данные GObject и сгенерирует переменную подстановки <literal>${gir:Depends}</literal> для пакетной зависимости.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
ru: Добавление поддержки свойства автодополнения <command>bash</command>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">bash-completion</systemitem> package in <literal>Build-Depends</literal>.
ru: Укажите пакет <systemitem role="package">bash-completion</systemitem> в <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with bash-completion</literal> instead.
ru: Вместо <literal>dh $@</literal> используйте <literal>dh $@ --with bash-completion</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This installs <command>bash</command> completions using a configuration file at <filename>debian/<replaceable>package</replaceable>.bash-completion</filename>.
ru: Эта команда установит дополнения <command>bash</command> согласно файлу настройки <filename>debian/<replaceable>пакет</replaceable>.bash-completion</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: Many <command>dh_*</command> commands invoked by the new <command>dh</command> command can be customized by the corresponding configuration files in the <filename>debian</filename> directory.  See <xref linkend="dother"/> and the manpage of each command for the customization of such features.
ru: Многие команды <command>dh_*</command>, вызываемые новой командой <command>dh</command>, могут быть настроены в соответствующих конфигурационных файлах в каталоге <filename>debian</filename>. Смотрите <xref linkend="dother"/> и справочную страницу к каждой команде для настройки этих параметров.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Under <literal>lenny</literal>, if you wanted to change the behavior of a <command>dh_*</command> script you found the relevant line in the <filename>rules</filename> file and adjusted it.
ru: В <literal>lenny</literal>, если вы хотите изменить поведение сценария <command>dh_*</command>, нужно найти соответствующую строку в файле <filename>rules</filename> правил и изменить её.

note: type: Content of: <book><chapter><section><section><para>
en: You may need to run <command>dh_*</command> commands invoked via the new <command>dh</command> with added arguments, or to run additional commands with them, or to skip them.  For such cases, you create an <literal>override_dh_<replaceable>foo</replaceable></literal> target with its rule in the <filename>rules</filename> file defining an <literal>override_dh_<replaceable>foo</replaceable></literal> target for the <command>dh_<replaceable>foo</replaceable></command> command you want to change.  It basically says <emphasis>run me instead</emphasis>.  <placeholder type="footnote" id="0"/>
ru: Некоторые команды <command>dh_*</command>, вызванные новой командой <command>dh</command>, могут потребовать от вас запустить их с некоторыми аргументами, выполнить вместе с ними дополнительные команды или пропустить их. В таких случаях надо создать цель <literal>override_dh_<replaceable>foo</replaceable></literal> с правилами в файле <filename>rules</filename> только для той команды <command>dh_<replaceable>foo</replaceable></command>, которую вы собираетесь изменить. Она воспринимается как <emphasis>запусти меня вместо той</emphasis> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><para>
en: Please note that the <command>dh_auto_*</command> commands tend to do more than what has been discussed in this (over)simplified explanation to take care of all the corner cases.  It is a bad idea to use <literal>override_dh_*</literal> targets to substitute simplified equivalent commands (except for the <literal>override_dh_auto_clean</literal> target) since it may bypass such smart <systemitem role="package">debhelper</systemitem> features.
ru: Заметим, что команды <command>dh_auto_*</command> пытаются делать больше, чем было описано (очень) поверхностно ранее, для того, чтобы учесть все возможные ситуации. Использование упрощённых эквивалентов команд вместо целей <literal>override_dh_*</literal> — плохая идея (за исключением цели <literal>override_dh_auto_clean</literal>), так как это может привести к удалению важных функций <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><section><para>
en: So, for instance, if you want to store system configuration data in the <filename>/etc/gentoo</filename> directory instead of the usual <filename>/etc</filename> directory for the recent <systemitem role="package">gentoo</systemitem> package using Autotools, you can override the default <literal>--sysconfig=/etc</literal> argument given by the <command>dh_auto_configure</command> command to the <command>./configure</command> command by the following:
ru: Так, например, если вы хотите хранить системные файлы настройки пакета <systemitem role="package">gentoo</systemitem> (использующего Autotools) в каталоге <filename>/etc/gentoo</filename> вместо обычного <filename>/etc</filename>, то можете переопределить аргумент <literal>--sysconfig=/etc</literal>, заданный по умолчанию, в команде <command>dh_auto_configure</command>, которая передаст его <command>./configure</command>:

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <command>dh_auto_build</command> without any arguments will execute the first target in the <filename>Makefile</filename>.
ru: Программа <command>dh_auto_build</command> без аргументов выполняет правила первой цели в <filename>Makefile</filename>:

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify <literal>build</literal> as its target to build it <placeholder type="footnote" id="0"/>, you create an <literal>override_dh_auto_build</literal> target to enable this.
ru: Если <filename>Makefile</filename> из исходного кода <systemitem role="package">gentoo</systemitem> требует от вас указания <literal>build</literal> в качестве цели для сборки <placeholder type="footnote" id="0"/>, то для этого можно создать цель <literal>override_dh_auto_build</literal>.

note: type: Content of: <book><chapter><section><section><para>
en: This ensures <literal>$(MAKE)</literal> is run with all the default arguments given by the <command>dh_auto_build</command> command plus the <literal>build</literal> argument.
ru: Это гарантирует выполнение <literal>$(MAKE)</literal> со всеми аргументами по умолчанию, заданными в командах <command>dh_auto_build</command> и аргументе <literal>build</literal>.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify the <literal>packageclean</literal> target to clean it for the Debian package instead of using <literal>distclean</literal> or <literal>clean</literal> targets, you can create an <literal>override_dh_auto_clean</literal> target to enable it.
ru: Если <filename>Makefile</filename> из исходного кода <systemitem role="package">gentoo</systemitem> требует от вас указания цели <literal>packageclean</literal> для очистки пакета Debian, а не <literal>distclean</literal> или <literal>clean</literal>, то для этого можно создать цель <literal>override_dh_auto_clean</literal>.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> contains a <literal>test</literal> target which you do not want to run for the Debian package building process, you can use an empty <literal>override_dh_auto_test</literal> target to skip it.
ru: Если <filename>Makefile</filename> из исходного кода <systemitem role="package">gentoo</systemitem> содержит цель <literal>test</literal>, которую вы не хотите выполнять для процесса сборки пакета Debian, то можно использовать пустую цель <literal>override_dh_auto_test</literal>, чтобы пропустить это действие.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: The <filename>debian/changelog</filename> and <filename>debian/NEWS</filename> files are always automatically installed.  The upstream changelog is found by converting filenames to lower case and matching them against <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, and <filename>changes.txt</filename>.
ru: Файлы <filename>debian/changelog</filename> и <filename>debian/NEWS</filename> всегда устанавливаются автоматически. Файл журнала ищется сопоставлением имён файлов, приведённых к нижнему регистру и совпадением их с именами <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename> и <filename>changes.txt</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: If <systemitem role="package">gentoo</systemitem> has an unusual upstream changelog file called <filename>FIXES</filename>, <command>dh_installchangelogs</command> will not install that file by default.  The <command>dh_installchangelogs</command> command requires <filename>FIXES</filename> as its argument to install it.  <placeholder type="footnote" id="0"/>
ru: Если в пакете <systemitem role="package">gentoo</systemitem> используется необычный журнальный файл с именем <filename>FIXES</filename>, то по умолчанию <command>dh_installchangelogs</command> не установит этот файл. Для его установки укажите команде <command>dh_installchangelogs</command> имя <filename>FIXES</filename> в качестве аргумента <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><para>
en: When you use the new <command>dh</command> command, use of explicit targets such as the ones listed in <xref linkend="targets"/>, other than the <literal>get-orig-source</literal> target, may make it difficult to understand their exact effects.  Please limit explicit targets to <literal>override_dh_*</literal> targets and completely independent ones, if possible.
ru: При работе с новой командой <command>dh</command>, используйте явные цели, перечисленные в <xref linkend="targets"/>, остальные же (кроме <literal>get-orig-source</literal>) могут привести к сложностям понимания их конечного эффекта. Если возможно, ограничьтесь явно заданными целями <literal>override_dh_*</literal> и полностью независимыми целями.

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
ru: Другие файлы в каталоге <filename>debian/</filename>

note: type: Content of: <book><chapter><para>
en: To control most of what <systemitem role="package">debhelper</systemitem> does while building the package, you put optional configuration files under the <filename>debian</filename> directory.  This chapter will provide an overview of what each of these does and its format.  Please read the <ulink url="&debian-policy;">Debian Policy Manual</ulink> and <ulink url="&developers-reference;">Debian Developer's Reference</ulink> for guidelines for packaging.
ru: Для контроля большей части того, что делает <systemitem role="package">debhelper</systemitem> при сборке пакетов, служат необязательные файлы настройки в каталоге <filename>debian</filename>. В этой главе будет рассмотрено, для чего нужен каждый из них и его формат. В <ulink url="&debian-policy;">руководстве по политике Debian</ulink> и <ulink url="&developers-reference;">справочнике разработчика Debian</ulink> приведены общие принципы пакетирования.

note: type: Content of: <book><chapter><para>
en: Some template configuration files for <systemitem role="package">debhelper</systemitem> may not be created by the <command>dh_make</command> command.  In such cases, you need to create them with an editor.
ru: Некоторые шаблоны файлов настройки <systemitem role="package">debhelper</systemitem> не могут быть созданы командой <command>dh_make</command>. В таких случаях вам необходимо создать их с помощью текстового редактора.

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
ru: Если вы хотите активировать некоторые из них, выполните следующие действия:

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: rename the configuration files to use the actual binary package name in place of <literal><replaceable>package</replaceable></literal>;
ru: переименуйте файлы настройки, используя имя реального двоичного пакета;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
ru: измените содержимое файла шаблона согласно вашим нуждам;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
ru: удалите файлы шаблонов, в которых нет необходимости;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
ru: при необходимости, измените файл <filename>control</filename> (смотрите <xref linkend="control"/>);

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>rules</filename> file (see <xref linkend="rules"/>), if necessary.
ru: при необходимости, измените файл <filename>rules</filename> (смотрите <xref linkend="rules"/>);

note: type: Content of: <book><chapter><para>
en: Any <systemitem role="package">debhelper</systemitem> configuration files without a <filename><replaceable>package</replaceable></filename> prefix, such as <filename>install</filename>, apply to the first binary package.  When there are many binary packages, their configurations can be specified by prefixing their name to their configuration filenames such as <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
ru: Любые файлы настройки <systemitem role="package">debhelper</systemitem> без префикса <filename><replaceable>имя пакета</replaceable></filename> как, например, <filename>install</filename>, относятся к первому двоичному пакету. Если есть несколько двоичных пакетов, их файлы настройки могут быть созданы с указанием их имени в имени файла настройки, например, <filename><replaceable>пакет-1</replaceable>.install</filename>, <filename><replaceable>пакет-2</replaceable>.install</filename> и т.д.

note: type: Content of: <book><chapter><section><title>
en: <filename>README.Debian</filename>
ru: Файл <filename>README.Debian</filename>

note: type: Content of: <book><chapter><section><para>
en: Any extra details or discrepancies between the original package and your Debian version should be documented here.
ru: В этот файл записывается любая дополнительная информация, а также различия между программой из пакета Debian и исходной программой.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
ru: Программа <command>dh_make</command> создала файл, похожий на этот:

note: type: Content of: <book><chapter><section><para>
en: If you have nothing to be documented, remove this file.  See <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ru: Если вам нечего сюда написать, удалите этот файл. Смотрите <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>compat</filename>
ru: Файл <filename>compat</filename>

note: type: Content of: <book><chapter><section><title>
en: <filename>conffiles</filename>
ru: Файл <filename>conffiles</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink>.
ru: Смотрите <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> и <ulink url="&policy-conffiles;">руководство по политике Debian, раздел «D.2.5 Conffiles»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: One of the most annoying things about software is when you spend a great deal of time and effort customizing a program, only to have an upgrade stomp all over your changes.  Debian solves this problem by marking such configuration files as conffiles.  <placeholder type="footnote" id="0"/> When you upgrade a package, you'll be asked whether you want to keep your old configuration files or not.
ru: Бывает очень обидно, когда тратишь много времени и усилий на настройку программы, а при очередном обновлении все настройки исчезают. Debian предлагает решение этой проблемы через механизм пометки файлов как настроечных — conffiles <placeholder type="footnote" id="0"/>. Для таких файлов при обновлении пакета вам будет задан вопрос, нужно ли заменить старые файлы теми, что включены в новый пакет.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry><refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> <emphasis>automatically</emphasis> flags any files under the <filename>/etc</filename> directory as conffiles, so if your program only has conffiles there you do not need to specify them in this file.  For most package types, the only place conffiles should ever be is under <filename>/etc</filename>, and so this file doesn't need to exist.
ru: Программа <citerefentry><refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> <emphasis>автоматически</emphasis> помечает все файлы в каталоге <filename>/etc</filename> как файлы conffiles, так что, если у вашей программы есть файлы conffiles только там, вам не обязательно указывать их в этом файле. Для большинства типов пакетов единственное место (и для них так должно быть всегда), в котором содержатся файлы conffiles, это <filename>/etc</filename> и, таким образом, в этом файле нет необходимости.

note: type: Content of: <book><chapter><section><para>
en: If your program uses configuration files but also rewrites them on its own, it's best not to make them conffiles because <command>dpkg</command> will then prompt users to verify the changes all the time.
ru: Если ваша программа не только использует файлы настройки, но и изменяет их, будет лучше не отмечать их как conffiles, так как в этом случае <command>dpkg</command> каждый раз будет просить пользователя проверить изменения.

note: type: Content of: <book><chapter><section><para>
en: If the program you're packaging requires every user to modify the configuration files in the <filename>/etc</filename> directory, there are two popular ways to arrange for them to not be conffiles, keeping <command>dpkg</command> quiet:
ru: Если программа, которую вы упаковываете, требует от пользователя изменить файлы настройки в каталоге <filename>/etc</filename>, существует два популярных способа не отмечать их как conffiles, чтобы подавить вопросы со стороны <command>dpkg</command>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a symlink under the <filename>/etc</filename> directory pointing to a file under the <filename>/var</filename> directory generated by the maintainer scripts.
ru: Создать символьную ссылку в каталоге <filename>/etc</filename>, указывающую на файл в каталоге <filename>/var</filename>, генерируемый сценариями сопровождающего.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a file generated by the maintainer scripts under the <filename>/etc</filename> directory.
ru: Сгенерировать файл в каталоге <filename>/etc</filename> с помощью сценариев сопровождающего.

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
ru: Информацию о сценариях сопровождающего смотрите в <xref linkend="maintscripts"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.cron.*</filename>
ru: Файлы <filename><replaceable>пакет</replaceable>.cron.*</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package requires regularly scheduled tasks to operate properly, you can use these files to set that up.  You can set up regular tasks that either happen hourly, daily, weekly, or monthly, or alternatively happen at any other time that you wish.  The filenames are:
ru: Эти файлы используются для планирования регулярно выполняемых задач. Вы можете назначить список задач, выполняемых ежечасно, ежедневно, еженедельно, ежемесячно или с любым произвольным интервалом. Вот имена этих файлов:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.hourly</filename> - Installed as <filename>/etc/cron.hourly/<replaceable>package</replaceable></filename>; run once an hour.
ru: <filename><replaceable>пакет</replaceable>.cron.hourly</filename> — устанавливается как <filename>/etc/cron.hourly/<replaceable>пакет</replaceable></filename>; выполняется один раз в час.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.daily</filename> - Installed as <filename>/etc/cron.daily/<replaceable>package</replaceable></filename>; run once a day.
ru: <filename><replaceable>пакет</replaceable>.cron.daily</filename> — устанавливается как <filename>/etc/cron.daily/<replaceable>пакет</replaceable></filename>; выполняется один раз в день.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.weekly</filename> - Installed as <filename>/etc/cron.weekly/<replaceable>package</replaceable></filename>; run once a week.
ru: <filename><replaceable>пакет</replaceable>.cron.weekly</filename> — устанавливается как <filename>/etc/cron.weekly/<replaceable>пакет</replaceable></filename>; выполняется один раз в неделю.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.monthly</filename> - Installed as <filename>/etc/cron.monthly/<replaceable>package</replaceable></filename>: run once a month.
ru: <filename><replaceable>пакет</replaceable>.cron.monthly</filename> — устанавливается как <filename>/etc/cron.monthly/<replaceable>пакет</replaceable></filename>; выполняется один раз в месяц.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.d</filename> - Installed as <filename>/etc/cron.d/<replaceable>package</replaceable></filename>: for any other time.
ru: <filename><replaceable>пакет</replaceable>.cron.d</filename> — устанавливается как <filename>/etc/cron.d/<replaceable>пакет</replaceable></filename>; выполняется в любое другое время.

note: type: Content of: <book><chapter><section><para>
en: Most of these files are shell scripts, with the exception of <filename><replaceable>package</replaceable>.cron.d</filename> which follows the format of <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.
ru: Большинство этих файлов являются сценариями оболочки, за исключением <filename><replaceable>пакет</replaceable>.cron.d</filename>, который должен иметь формат <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: No explicit <filename>cron.*</filename> file is needed to set up log rotation; for that, see <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> and <citerefentry><refentrytitle>logrotate</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
ru: Для архивирования журнальных файлов никаких файлов <filename>cron.*</filename> задавать ненужно — для этого есть другие средства (смотрите <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> и <citerefentry><refentrytitle>logrotate</refentrytitle><manvolnum>8</manvolnum></citerefentry>).

note: type: Content of: <book><chapter><section><title>
en: <filename>dirs</filename>
ru: Файл <filename>dirs</filename>

note: type: Content of: <book><chapter><section><para>
en: This file specifies any directories which we need but which are not created by the normal installation procedure (<literal>make install DESTDIR=...</literal> invoked by <literal>dh_auto_install</literal>).  This generally means there is a problem with the <filename>Makefile</filename>.
ru: В этом файле указываются каталоги, которые необходимы для обычной установки (<literal>make install DESTDIR=...</literal>, вызываемая <literal>dh_auto_install</literal>), но которые автоматически не создаются. Обычно, это указывает на проблему в <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Files listed in an <filename>install</filename> file don't need their directories created first.  See <xref linkend="install"/>.
ru: Файлы, указанные в файле <filename>install</filename>, не нуждаются в предварительном создании каталогов. Смотрите <xref linkend="install"/>.

note: type: Content of: <book><chapter><section><para>
en: It is best to try to run the installation first and only use this if you run into trouble.  There is no preceding slash on the directory names listed in the <filename>dirs</filename> file.
ru: Для начала лучше попробовать запустить установку и использовать этот файл, только если есть проблемы. В начале имён каталогов, перечисляемых в файле <filename>dirs</filename>, косая черта не указывается.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.doc-base</filename>
ru: Файл <filename><replaceable>пакет</replaceable>.doc-base</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has documentation other than manual and info pages, you should use the <systemitem role="package">doc-base</systemitem> file to register it, so the user can find it with e.g.  <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, or <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ru: Если ваш пакет содержит документацию, отличную от справочных страниц или файлов в формате info, то для её регистрации в системе вы должны воспользоваться файлом <systemitem role="package">doc-base</systemitem>; это позволит пользователю найти её при помощи, например, <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> или <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: This usually includes HTML, PS and PDF files, shipped in <filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>.
ru: Обычно, к таким файлам относятся файлы в форматах HTML, PS и PDF, помещаемые в <filename>/usr/share/doc/<replaceable>имя_пакета</replaceable>/</filename>.

note: type: Content of: <book><chapter><section><para>
en: This is what <systemitem role="package">gentoo</systemitem>'s doc-base file <filename>gentoo.doc-base</filename> looks like:
ru: Вот как выглядит файл <systemitem role="package">gentoo</systemitem>, входящий в пакет <filename>gentoo.doc-base</filename>:

note: type: Content of: <book><chapter><section><para>
en: For information on the file format, see <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and the Debian <systemitem role="package">doc-base</systemitem> manual at the local copy <filename>&doc-base;</filename> provided by the <systemitem role="package">doc-base</systemitem> package.
ru: Формат этого файла описан в справочной странице <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, а также в локальной копии руководства Debian по <ulink url="&doc-base;">doc-base</ulink> из пакета <systemitem role="package">doc-base</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: For more details on installing additional documentation, look in <xref linkend="destdir"/>.
ru: Подробная информация по установке дополнительной документации приведена в <xref linkend="destdir"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>docs</filename>
ru: Файл <filename>docs</filename>

note: type: Content of: <book><chapter><section><para>
en: This file specifies the file names of documentation files we can have <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> install into the temporary directory for us.
ru: В этом файле указаны имена файлов документации, которые можно установить во временный каталог с помощью <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: By default, it will include all existing files in the top-level source directory that are called <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> etc.
ru: По умолчанию будут включены все файлы, имеющиеся в самом верхнем каталоге с исходным кодом, а именно <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> и т.д.

note: type: Content of: <book><chapter><section><para>
en: For <systemitem role="package">gentoo</systemitem>, some other files are also included:
ru: Для пакета <systemitem role="package">gentoo</systemitem> также включаются несколько других файлов:

note: type: Content of: <book><chapter><section><title>
en: <filename>emacsen-*</filename>
ru: Файлы <filename>emacsen-*</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package supplies Emacs files that can be bytecompiled at package installation time, you can use these files to set it up.
ru: В этом файле указываются файлы для Emacs, которые могут быть скомпилированы во время установки пакета.

note: type: Content of: <book><chapter><section><para>
en: They are installed into the temporary directory by <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ru: Они устанавливаются во временный каталог при помощи <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: If you don't need these, remove them.
ru: Если они вам не нужны, удалите их.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.examples</filename>
ru: Файл <filename><replaceable>пакет</replaceable>.examples</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs files and directories listed in this file as example files.
ru: Команда <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> устанавливает файлы и каталоги, указанные в этом файле, как файлы примеров.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
ru: Файлы <filename><replaceable>пакет</replaceable>.init</filename> и <filename><replaceable>пакет</replaceable>.default</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package is a daemon that needs to be run at system start-up, you've obviously disregarded my initial recommendation, haven't you? :-)
ru: Если ваш пакет содержит службу и её необходимо запускать при старте системы, вероятнее всего, вы не обратили внимания на мой изначальный совет, не так ли? :-)

note: type: Content of: <book><chapter><section><para>
en: If your upstream program provides a file for the init script, you can either use it or not.  If you don't use their init script then create a new one in <filename><replaceable>package</replaceable>.init</filename>.  However if the upstream init script looks fine and installs in the right place you still need to set up the <filename>rc*</filename> symlinks.  To do this you will need to override <command>dh_installinit</command> in the <filename>rules</filename> file with the following lines:
ru: Если с оригинальной программой поставляется сценарий инициализации, то вы можете использовать и его. Если он вам не подходит, то создайте свой в файле с именем <filename><replaceable>пакет</replaceable>.init</filename>. Однако, если оригинальный сценарий инициализации хорошо написан и устанавливается в правильное место, вам всё ещё нужно установить символьные ссылки в <filename>rc*</filename>. Для этого замените <command>dh_installinit</command> в файле <filename>rules</filename> на следующие строки:

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
ru: Если сценарий инициализации не требуется, удалите эти файлы.

note: type: Content of: <book><chapter><section><title>
en: <filename>install</filename>
ru: Файл <filename>install</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This replaces the deprecated <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command which is configured by the <filename>files</filename> file.
ru: Этот файл заменяет устаревшую команду <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, которая настраивается с помощью файла <filename>files</filename>.

note: type: Content of: <book><chapter><section><para>
en: This <filename>install</filename> file has one line per file installed, with the name of the file (relative to the top build directory) then a space then the installation directory (relative to the install directory).  One example of where this is used is if a binary <filename>src/<replaceable>bar</replaceable></filename> is left uninstalled; the <filename>install</filename> file might look like:
ru: В файле <filename>install</filename> для каждого устанавливаемого файла отводится одна строка; в ней задаётся имя файла (относительно верхнего каталога сборки), потом пробел, потом установочный каталог (относительно каталога установки). Например, если при установке не устанавливается <filename>src/<replaceable>bar</replaceable></filename>, то файл <filename>install</filename> будет выглядеть так:

note: type: Content of: <book><chapter><section><para>
en: This means when this package is installed, there will be an executable command <filename>/usr/bin/<replaceable>bar</replaceable></filename>.
ru: В результате после установки пакета в системе появится исполняемая команда <filename>/usr/bin/<replaceable>bar</replaceable></filename>.

note: type: Content of: <book><chapter><section><para>
en: Alternatively, this <filename>install</filename> can have the name of the file only without the installation directory when the relative directory path does not change.  This format is usually used for a large package that splits the output of its build into multiple binary packages using <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
ru: Также, в файле <filename>install</filename> можно указывать только имя файла без каталога установки, если не менялся относительный путь. Такой формат, обычно, используется для большого пакета, в котором результат сборки разбивается на несколько двоичных пакетов; список устанавливаемых файлов помещается в соответствующий файл <filename><replaceable>пакет-1</replaceable>.install</filename>, <filename><replaceable>пакет-2</replaceable>.install</filename> и т.д.

note: type: Content of: <book><chapter><section><para>
en: The <command>dh_install</command> command will fall back to looking in <filename>debian/tmp</filename> for files, if it doesn't find them in the current directory (or wherever you've told it to look using <literal>--sourcedir</literal>).
ru: Если команда <command>dh_install</command> не находит файлы в текущем каталоге, то она ищет их в <filename>debian/tmp</filename> (или в любом другом месте, указанном в <literal>--sourcedir</literal>).

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.info</filename>
ru: Файл <filename><replaceable>пакет</replaceable>.info</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has info pages, you should install them using <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.info</filename> file.
ru: Если у вашего пакета есть страницы в формате info, то их нужно устанавливать при помощи <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, перечислив их в файле <filename><replaceable>пакет</replaceable>.info</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.links</filename>
ru: Файл <filename><replaceable>пакет</replaceable>.links</filename>

note: type: Content of: <book><chapter><section><para>
en: If you need to create additional symlinks in package build directories as package maintainer, you should install them using <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing their full paths of source and destination files in a <filename><replaceable>package</replaceable>.links</filename> file.
ru: Если вам, как сопровождающему пакета, нужно создать дополнительные символьные ссылки в каталогах сборки пакета, установите их с помощью <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, перечислив полные пути файлов источника и назначения в файле <filename><replaceable>пакет</replaceable>.links</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>{<replaceable>package</replaceable>.,source/}lintian-overrides</filename>
ru: Файлы <filename>{<replaceable>пакет</replaceable>.,source/}lintian-overrides</filename>

note: type: Content of: <book><chapter><section><para>
en: <filename><replaceable>package</replaceable>.lintian-overrides</filename> is for the binary package named <systemitem role="package"><replaceable>package</replaceable></systemitem> and is installed into <filename>usr/share/lintian/overrides/<replaceable>package</replaceable></filename> by the <command>dh_lintian</command> command.
ru: Файл <filename><replaceable>пакет</replaceable>.lintian-overrides</filename> предназначен для двоичного <systemitem role="package"><replaceable>пакета</replaceable></systemitem> и устанавливается в <filename>usr/share/lintian/overrides/<replaceable>пакет</replaceable></filename> с помощью команды <command>dh_lintian</command>.

note: type: Content of: <book><chapter><section><para>
en: <filename>source/lintian-overrides</filename> is for the source package.  This is not installed.
ru: Файл <filename>source/lintian-overrides</filename> предназначен для пакета с исходным кодом. Он не устанавливается.

note: type: Content of: <book><chapter><section><title>
en: <filename>manpage.*</filename>
ru: Файлы <filename>manpage.*</filename>

note: type: Content of: <book><chapter><section><para>
en: Your program(s) should have a manual page.  If they don't, you should create them.  The <command>dh_make</command> command creates some template files for manual pages.  These need to be copied and edited for each command missing its manual page.  Please make sure to remove unused templates.
ru: Для каждой программы должна быть справочная страница. Если её нет, её необходимо создать. Команда <command>dh_make</command> создаёт несколько шаблонов справочных страниц. Они должны быть скопированы и отредактированы для каждой команды, не имеющей собственной справочной страницы. Проверьте, что удалили неиспользованные шаблоны.

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.1.ex</filename>
ru: Файл <filename>manpage.1.ex</filename>

note: type: Content of: <book><chapter><section><section><para>
en: Manual pages are normally written in <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  The <filename>manpage.1.ex</filename> template is written in <command>nroff</command>, too.  See the <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> manual page for a brief description of how to edit such a file.
ru: Справочные страницы, как правило, пишутся на языке разметки <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Файл шаблона <filename>manpage.1.ex</filename> также написан на <command>nroff</command>. Смотрите справочную страницу <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry>, в которой приведено краткое описание действий по редактированию подобных файлов.

note: type: Content of: <book><chapter><section><section><para>
en: The final manual page file name should give the name of the program it is documenting, so we will rename it from <literal>manpage</literal> to <literal>gentoo</literal>.  The file name also includes <literal>.1</literal> as the first suffix, which means it's a manual page for a user command.  Be sure to verify that this section is indeed the correct one.  Here's a short list of manual page sections:
ru: Окончательное имя файла справочной страницы должно включать имя документируемой программы, поэтому мы переименуем её с <literal>manpage</literal> на <literal>gentoo</literal>. Имя файла также включает <literal>.1</literal> в качестве первого суффикса, который означает, что эта справочная страница описывает пользовательскую команду. Убедитесь, что используется правильный раздел. Вот короткий список разделов справочных страниц:

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Section
ru: Раздел

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Description
ru: Описание

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Notes
ru: Примечания

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: User commands
ru: Пользовательские команды

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
ru: Запускаемые команды или сценарии

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
ru: Системные вызовы

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
ru: Функции, предоставляемые ядром

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
ru: Библиотечные вызовы

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
ru: Функции, предоставляемые системными библиотеками

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
ru: Специальные файлы

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
ru: Обычно находятся в каталоге <filename>/dev</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
ru: Форматы файлов

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
ru: Например, формат <filename>/etc/passwd</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games
ru: Игры

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
ru: Игры и другие несерьёзные программы

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
ru: Пакеты макросов

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
ru: Например, макросы <command>man</command>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System administration
ru: Системное администрирование

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
ru: Программы, обычно запускаемые только суперпользователем

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
ru: Функции ядра

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
ru: Нестандартные вызовы и внутреннее устройство

note: type: Content of: <book><chapter><section><section><para>
en: So <systemitem role="package">gentoo</systemitem>'s man page should be called <filename>gentoo.1</filename>.  If there was no <filename>gentoo.1</filename> man page in the original source, you should create it by renaming the <filename>manpage.1.ex</filename> template to <filename>gentoo.1</filename> and editing it using information from the example and from the upstream docs.
ru: Таким образом, справочная страница для <systemitem role="package">gentoo</systemitem> должна называться <filename>gentoo.1</filename>. Если в исходном коде нет справочной страницы <filename>gentoo.1</filename>, то её нужно создать путём переименовывания шаблона <filename>manpage.1.ex</filename> в <filename>gentoo.1</filename> и затем изменить его, используя информацию из примера и документации к исходной программе.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Note that <command>help2man</command>'s placeholder man page will claim that more detailed documentation is available in the info system. If the command is missing an <command>info</command> page, you should manually edit the man page created by the <command>help2man</command> command.
ru: Заметим, что в шаблоне справочной страницы из <command>help2man</command> утверждается, что более подробная документация приведена в справочной системе info. Если для команды нет страницы <command>info</command>, то вам нужно изменить справочную страницу, созданную командой <command>help2man</command>.

note: type: Content of: <book><chapter><section><section><para>
en: You can use the <command>help2man</command> command to generate a man page out of the <literal>--help</literal> and <literal>--version</literal> output of each program, too.  <placeholder type="footnote" id="0"/>
ru: Также, вы можете использовать команду <command>help2man</command> для генерации справочной страницы, которая для создания использует результат запуска команды с параметрами <literal>--help</literal> и <literal>--version</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.sgml.ex</filename>
ru: Файл <filename>manpage.sgml.ex</filename>

note: type: Content of: <book><chapter><section><section><para>
en: If on the other hand you prefer writing SGML instead of <command>nroff</command>, you can use the <filename>manpage.sgml.ex</filename> template.  If you do this, you have to:
ru: Если вы предпочитаете использовать SGML вместо <command>nroff</command>, то можете использовать шаблон  <filename>manpage.sgml.ex</filename>. Для этого необходимо:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
ru: переименовать файл в <filename>gentoo.sgml</filename>;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-to-man</systemitem> package
ru: установить пакет <systemitem role="package">docbook-to-man</systemitem>;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add <literal>docbook-to-man</literal> to the <literal>Build-Depends</literal> line in the <filename>control</filename> file
ru: в файл <filename>control</filename> добавить <literal>docbook-to-man</literal> в строку <literal>Build-Depends</literal>;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add an <literal>override_dh_auto_build</literal> target to your <filename>rules</filename> file:
ru: добавить цель <literal>override_dh_auto_build</literal> в файл <filename>rules</filename>:

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.xml.ex</filename>
ru: Файл <filename>manpage.xml.ex</filename>

note: type: Content of: <book><chapter><section><section><para>
en: If you prefer XML over SGML, you can use the <literal>manpage.xml.ex</literal> template.  If you do this, you have to:
ru: Если вы предпочитаете использовать XML вместо SGML, то можете использовать шаблон <literal>manpage.xml.ex</literal>. Для этого необходимо:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
ru: переименовать исходный файл в <literal>gentoo.1.xml</literal>;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-xsl</systemitem> package and an XSLT processor like <systemitem role="package">xsltproc</systemitem> (recommended)
ru: установить пакет <systemitem role="package">docbook-xsl</systemitem> и обработчик XSLT (рекомендуется <systemitem role="package">xsltproc</systemitem>);

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add the <literal>docbook-xsl</literal>, <literal>docbook-xml</literal>, and <literal>xsltproc</literal> packages to the <literal>Build-Depends</literal> line in the <literal>control</literal> file
ru: в файл <literal>control</literal> добавить пакеты <literal>docbook-xsl</literal>, <literal>docbook-xml</literal> и <literal>xsltproc</literal> в строку <literal>Build-Depends</literal>;

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.manpages</filename>
ru: Файл <filename><replaceable>пакет</replaceable>.manpages</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has manual pages, you should install them using <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.manpages</filename> file.
ru: Если ваш пакет содержит справочные страницы, то их следует устанавливать с помощью <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, перечислив в файле <filename><replaceable>пакет</replaceable>.manpages</filename>.

note: type: Content of: <book><chapter><section><para>
en: To install <filename>docs/gentoo.1</filename> as a manpage for the <systemitem role="package">gentoo</systemitem> package, create a <filename>gentoo.manpages</filename> file as follows:
ru: Чтобы установить справочную страницу <filename>doc/gentoo.1</filename> для пакета <systemitem role="package">gentoo</systemitem>, создайте следующий файл <filename>gentoo.manpages</filename>:

note: type: Content of: <book><chapter><section><title>
en: <filename>NEWS</filename>
ru: Файл <filename>NEWS</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
ru: Этот файл устанавливается командой <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>{pre,post}{inst,rm}</filename>
ru: Файлы <filename>{pre|post}{inst|rm}</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Despite this use of the <command>bash</command> shorthand expression <filename>{pre,post}{inst,rm}</filename> to indicate these filenames, you should use pure POSIX syntax for these maintainer scripts for compatibility with <command>dash</command> as the system shell.
ru: Несмотря на то, что здесь используется сокращённое выражение <command>bash</command> для обозначения этих файлов в виде <filename>{pre|post}{inst|rm}</filename>, в сценариях сопровождающего рекомендуется использовать только синтаксис POSIX для лучшей совместимости с системной оболочкой <command>dash</command>.

note: type: Content of: <book><chapter><section><para>
en: These <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, and <filename>prerm</filename> files <placeholder type="footnote" id="0"/> are called <emphasis>maintainer scripts</emphasis>.  They are scripts which are put in the control area of the package and run by <command>dpkg</command> when your package is installed, upgraded, or removed.
ru: Файлы <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename> и <filename>prerm</filename> <placeholder type="footnote" id="0"/> называются сценариями сопровождающего. Эти сценарии находятся в управляющей области пакета и запускаются программой <command>dpkg</command> при установке, обновлении или удалении пакета.

note: type: Content of: <book><chapter><section><para>
en: As a novice maintainer, you should avoid any manual editing of maintainer scripts because they are problematic.  For more information refer to the <ulink url="&policy-mantainerscripts;">Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"</ulink>, and take a look at the example files provided by <command>dh_make</command>.
ru: Как начинающему сопровождающему вам следует избегать ручной правки сценариев сопровождающего, так как они имеют тенденцию усложняться. Более подробную информацию смотрите в <ulink url="&policy-mantainerscripts;">руководстве по политике Debian, глава 6 «Сценарии сопровождающего пакета и процесс установки»</ulink>, и взгляните на файлы примеров, предоставляемые <command>dh_make</command>.

note: type: Content of: <book><chapter><section><para>
en: If you did not listen to me and have created custom maintainer scripts for a package, you should make sure to test them not only for <emphasis role="strong">install</emphasis> and <emphasis role="strong">upgrade</emphasis> but also for <emphasis role="strong">remove</emphasis> and <emphasis role="strong">purge</emphasis>.
ru: Если вы не послушали меня и сделали собственные сценарии сопровождающего для пакета, вам следует убедиться, что вы сделали всё правильно, протестировав их не только для <emphasis role="strong">установки</emphasis> и <emphasis role="strong">обновления</emphasis>, но и для <emphasis role="strong">удаления</emphasis> и <emphasis role="strong">вычистки</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Upgrades to the new version should be silent and non-intrusive (existing users should not notice the upgrade except by discovering that old bugs have been fixed and perhaps that there are new features).
ru: При обновлении пакета до новой версии на экран ничего не должно выводиться и это должен быть ненавязчивый процесс (пользователи не должны обращать внимание на обновление, за исключением обнаружения того, что старые ошибки были исправлены и, возможно, появились новые возможности).

note: type: Content of: <book><chapter><section><para>
en: When the upgrade is necessarily intrusive (eg., config files scattered through various home directories with totally different structure), you may consider as the last resort switching the package to a safe fallback state (e.g., disabling a service) and providing the proper documentation required by policy (<filename>README.Debian</filename> and <filename>NEWS.Debian</filename>).  Don't bother the user with <command>debconf</command> notes invoked from these maintainer scripts for upgrades.
ru: Когда для обновления требуются какие-то действия (например, файлы настройки разбросаны по различным каталогам в домашнем каталоге с абсолютно разной структурой), вы можете перевести пакет в безопасное состояние (например, отключив службу) и предоставить соответствующую документацию, требуемую политикой (<filename>README.Debian</filename> и <filename>NEWS.Debian</filename>). Не беспокойте пользователя меню <command>debconf</command>, вызываемым из сценариев сопровождающего для обновления.

note: type: Content of: <book><chapter><section><para>
en: The <systemitem role="package">ucf</systemitem> package provides a <emphasis>conffile-like</emphasis> handling infrastructure to preserve user changes for files that may not be labeled as <emphasis>conffiles</emphasis> such as those managed by the maintainer scripts.  This should minimize issues associated with them.
ru: Пакет <systemitem role="package">ucf</systemitem> предоставляет <emphasis>conffile-подобную</emphasis> инфраструктуру для сохранения пользовательских изменений в файлах, которые не могут быть помечены как <emphasis>conffiles</emphasis>, например файлы, управляемые сценариями сопровождающего. Это должно минимизировать возможные проблемы, связанные с ними.

note: type: Content of: <book><chapter><section><para>
en: These maintainer scripts are among the Debian enhancements that explain <emphasis role="strong">why people choose Debian</emphasis>.  You must be very careful not to turn them into a source of annoyance.
ru: Сценарии сопровождающего являются сильной стороной Debian, из-за них <emphasis role="strong">люди выбирают Debian</emphasis>. Вы должны быть очень осторожны, чтобы не превратить их в источник раздражения.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.symbols</filename>
ru: Файл <filename><replaceable>пакет</replaceable>.symbols</filename>

note: type: Content of: <book><chapter><section><title>
en: <filename>TODO</filename>
ru: Файл <filename>TODO</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
ru: Этот файл устанавливается командой <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>watch</filename>
ru: Файл <filename>watch</filename>

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
ru: Вот его содержимое:

note: type: Content of: <book><chapter><section><screen>
en: # watch control file for uscan
    version=3
    &sf-net;/gentoo/gentoo-(.+)\.tar\.gz debian uupdate
ru: # управляющий файл watch для uscan
    version=3
    &sf-net;/gentoo/gentoo-(.+)\.tar\.gz debian uupdate

note: type: Content of: <book><chapter><section><para>
en: Normally with a <filename>watch</filename> file, the URL at <literal>&sf-net;/gentoo</literal> is downloaded and searched for links of the form <literal>&lt;a href=...&gt;</literal>.  The basename (just the part after the final <literal>/</literal>) of each linked URL is compared against the Perl regular expression pattern (see <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  <literal>gentoo-(.+)\.tar\.gz</literal>.  Out of the files that match, the one with the greatest version number is downloaded and the <command>uupdate</command> program is run to create an updated source tree.
ru: Обычно, с указанного в файле <filename>watch</filename> URL <literal>http://sf.net/gentoo</literal> скачивается страница и в ней ищутся ссылки вида <literal>&lt;a href=...&gt;</literal>. Базовое имя (часть за последним <literal>/</literal>) каждой найденной ссылки сравнивается с шаблоном регулярного выражения Perl (смотрите <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>) <literal>gentoo-(.+)\.tar\.gz</literal>. Из совпавших файлов загружается файл с наибольшим номером версии и запускается программа <command>uupdate</command>, которая создаёт из них обновлённое дерево исходного кода.

note: type: Content of: <book><chapter><section><para>
en: If the upstream offers the cryptographic signature of the tarball, it is recommended to verify its authenticity using the <literal>pgpsigurlmangle</literal> option as described in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.
ru: Если автор программы подписывает tarball ключом, то рекомендуется проверять его подпись с помощью параметра <literal>pgpsigurlmangle</literal> как описано в <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>source/format</filename>
ru: Файл <filename>source/format</filename>

note: type: Content of: <book><chapter><section><para>
en: In the <filename>debian/source/format</filename> file, there should be a single line indicating the desired format for the source package (check <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> for an exhaustive list).  After <literal>squeeze</literal>, it should say either:
ru: В файле <filename>debian/source/format</filename> должна содержаться единственная строка, указывающая на желаемый формат пакета с исходным кодом (полный список смотрите в <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>). После <literal>squeeze</literal> он должен содержать либо:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
ru: <literal>3.0 (native)</literal> — для родных пакетов Debian;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
ru: <literal>3.0 (quilt)</literal> — для всего остального.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debsrc3;">DebSrc3.0</ulink> for a summary on the switch to the new <literal>3.0 (quilt)</literal> and <literal>3.0 (native)</literal> source formats.
ru: Обзор перехода на новые форматы пакетов <literal>3.0 (quilt)</literal> и <literal>3.0 (native)</literal> с исходным кодом смотрите в <ulink url="&debsrc3;">DebSrc3.0</ulink>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Actually, this new format also supports multiple upstream tarballs and more compression methods.  These are beyond the scope of this document.
ru: Фактически, новый формат также позволяет использовать несколько tar-архивов исходной программы и дополнительные методы сжатия. Описание этого выходит за рамки данного документа.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format records modifications in a <command>quilt</command> patch series within <filename>debian/patches</filename>.  Those changes are then automatically applied during extraction of the source package.  <placeholder type="footnote" id="0"/> The Debian modifications are simply stored in a <filename>debian.tar.gz</filename> archive containing all files under the <filename>debian</filename> directory.  This new format supports inclusion of binary files such as PNG icons by the package maintainer without requiring tricks.  <placeholder type="footnote" id="1"/>
ru: В новом формате пакетов с исходным кодом <literal>3.0 (quilt)</literal> изменения записываются в виде серии заплат <command>quilt</command> в каталог <filename>debian/patches</filename>. Эти изменения автоматически накладываются в ходе распаковки пакета исходного кода <placeholder type="footnote" id="0"/>. Изменения Debian хранятся в архиве <filename>debian.tar.gz</filename>, содержащем все файлы из каталога <filename>debian</filename>. Новый формат позволяет сопровождающему включать двоичные файлы, такие как значки в формате PNG, без дополнительных ухищрений <placeholder type="footnote" id="1"/>.

note: type: Content of: <book><chapter><section><para>
en: When <command>dpkg-source</command> extracts a source package in <literal>3.0 (quilt)</literal> source format, it automatically applies all patches listed in <filename>debian/patches/series</filename>.  You can avoid applying patches at the end of the extraction with the <literal>--skip-patches</literal> option.
ru: Когда программа <command>dpkg-source</command> распаковывает пакет с исходным кодом в формате <literal>3.0 (quilt)</literal>, она автоматически накладывает все заплаты, перечисленные в файле <filename>debian/patches/series</filename>. Вы можете избежать наложения заплат в конце распаковки, указав параметр <literal>--skip-patches</literal>.

note: type: Content of: <book><chapter><section><title>
en: <filename>source/local-options</filename>
ru: Файл <filename>source/local-options</filename>

note: type: Content of: <book><chapter><section><para>
en: After you build a package, the source is normally left patched.  You need to unpatch it manually by running <literal>dquilt pop -a</literal> before committing to the <literal>master</literal> branch.  You can automate this by adding the optional <filename>debian/source/local-options</filename> file containing <literal>unapply-patches</literal>.  This file is not included in the generated source package and changes the local build behavior only.  This file may contain <literal>abort-on-upstream-changes</literal>, too (see <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).
ru: После того, как вы собрали пакет, исходный код, обычно, остаётся изменённым. Вам необходимо вручную убрать изменения, внесённые заплатами, с помощью запуска <literal>dquilt pop -a</literal> перед сохранением в ветку <literal>master</literal>. Вы можете автоматизировать это, добавив дополнительный файл <filename>debian/source/local-options</filename>, содержащий <literal>unapply-patches</literal>. Этот файл не включается в генерируемый пакет с исходным кодом и изменяет только поведение локальной сборки. Также, он может содержать <literal>abort-on-upstream-changes</literal> (смотрите <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><title>
en: <filename>source/options</filename>
ru: Файл <filename>source/options</filename>

note: type: Content of: <book><chapter><section><para>
en: The autogenerated files in the source tree can be quite annoying for packaging since they generate meaningless large patch files.  There are custom modules such as <command>dh_autoreconf</command> to ease this problem as described in <xref linkend="customrules"/>.
ru: Автоматически генерируемые файлы в дереве исходного кода могут немного раздражать при пакетировании, так как из-за них генерируются бесполезные большие файлы заплат. Для решения этой проблемы есть специальные модули, такие как <command>dh_autoreconf</command>, описанные в <xref linkend="customrules"/>.

note: type: Content of: <book><chapter><section><para>
en: You can provide a Perl regular expression to the <literal>--extend-diff-ignore</literal> option argument of <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> to ignore changes made to the autogenerated files while creating the source package.
ru: При создании пакета с исходным кодом вы можете указать регулярное выражение Perl в параметре <literal>--extend-diff-ignore</literal> для <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry>, чтобы игнорировать изменения в автоматически генерируемых файлах.

note: type: Content of: <book><chapter><section><para>
en: As a general solution to address this problem of the autogenerated files, you can store such a <command>dpkg-source</command> option argument in the <filename>source/options</filename> file of the source package.  The following will skip creating patch files for <filename>config.sub</filename>, <filename>config.guess</filename>, and <filename>Makefile</filename>.
ru: Общим решением этой проблемы с автоматически создаваемыми файлами является сохранение аргумента <command>dpkg-source</command> в файле пакета с исходным кодом <filename>source/options</filename>. Благодаря следующим настройкам в файлы заплат не будут включены <filename>config.sub</filename>, <filename>config.guess</filename> и <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>patches/*</filename>
ru: Файлы <filename>patches/*</filename>

note: type: Content of: <book><chapter><section><para>
en: The old <literal>1.0</literal> source format created a single large <filename>diff.gz</filename> file containing package maintenance files in <filename>debian</filename> and patch files for the source.  Such a package is a bit cumbersome to inspect and understand for each source tree modification later.  This is not so nice.
ru: При использовании старого формата пакета с исходным кодом <literal>1.0</literal> создавался один большой файл <filename>diff.gz</filename>, который содержал файлы сопровождения в <filename>debian</filename> и заплаты к исходному коду. Такой пакет немного громоздок для проверки и понимания каждого изменения дерева исходного кода. Это не так уж хорошо.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Several methods of patch set maintenance have been proposed and are in use for Debian packages.  The <command>quilt</command> system is the preferred maintenance system in use.  Others include <command>dpatch</command>, <command>dbs</command>, and <command>cdbs</command>.  Many of these keep such patches as <filename>debian/patches/*</filename> files.
ru: Для управления набором заплат в пакетировании Debian были предложены и применяется несколько методов. Система <command>quilt</command> — предпочтительная система сопровождения. Также есть <command>dpatch</command>, <command>dbs</command>, <command>cdbs</command> и другие. Многие из них хранят заплаты в файлах <filename>debian/patches/*</filename>.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format stores patches in <filename>debian/patches/*</filename> files using the <command>quilt</command> command.  These patches and other package data which are all contained under the <filename>debian</filename> directory are packaged as the <filename>debian.tar.gz</filename> file.  Since the <command>dpkg-source</command> command can handle <command>quilt</command> formatted patch data in the <literal>3.0 (quilt)</literal> source without the <systemitem role="package">quilt</systemitem> package, it does not need a <literal>Build-Depends</literal> on <systemitem role="package">quilt</systemitem>.  <placeholder type="footnote" id="0"/>
ru: В новом формате <literal>3.0 (quilt)</literal> заплаты хранятся в файлах <filename>debian/patches/*</filename>, для создания которых применяется команда <command>quilt</command>. Эти заплаты и другие данные пакета — всё содержимое каталога <filename>debian</filename> — упаковывается в файл <filename>debian.tar.gz</filename>. Так как команда <command>dpkg-source</command> может работать с данными <command>quilt</command> в формате <literal>3.0 (quilt)</literal> без пакета <systemitem role="package">quilt</systemitem>, то его не нужно включать в зависимости <literal>Build-Depends</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you are asking a sponsor to upload your package, this kind of clear separation and documentation of your changes is very important to expedite the package review by your sponsor.
ru: Если вы просите поручителя загрузить ваш пакет, такое чёткое разделение и документирование ваших изменений очень важно для ускорения проверки пакета поручителем.

note: type: Content of: <book><chapter><section><para>
en: The <command>quilt</command> command is explained in <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  It records modifications to the source as a stack of <literal>-p1</literal> patch files in the <filename>debian/patches</filename> directory and the source tree is untouched outside of the <filename>debian</filename> directory.  The order of these patches is recorded in the <filename>debian/patches/series</filename> file.  You can apply (=push), un-apply (=pop), and refresh patches easily.  <placeholder type="footnote" id="0"/>
ru: Работа с командой <command>quilt</command> описана в <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Она записывает изменения исходного кода в виде набора заплат <literal>-p1</literal> в каталоге <filename>debian/patches</filename>, а дерево исходного кода вне каталога <filename>debian</filename> остаётся нетронутым. Порядок применения этих заплат указывается в файле <filename>debian/patches/series</filename>. Вы можете легко наложить (=push), откатить (=pop) или обновить заплаты <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: For <xref linkend="modify"/>, we created three patches in <filename>debian/patches</filename>.
ru: В <xref linkend="modify"/> мы создали 3 заплаты в <filename>debian/patches</filename>.

note: type: Content of: <book><chapter><section><para>
en: Since Debian patches are located in <filename>debian/patches</filename>, please make sure to set up the <command>dquilt</command> command properly as described in <xref linkend="quiltrc"/>.
ru: Поскольку заплаты Debian расположены в <filename>debian/patches</filename>, убедитесь, что программа <command>dquilt</command> настроена правильно, как было описано в <xref linkend="quiltrc"/>.

note: type: Content of: <book><chapter><section><para>
en: When anyone (including yourself) provides a patch <filename><replaceable>foo</replaceable>.patch</filename> to the source later, modifying a <literal>3.0 (quilt)</literal> source package is quite simple:
ru: Позднее, когда кто-то (включая вас самих) предоставляет заплату <filename><replaceable>foo</replaceable>.patch</filename> к исходному коду, изменить пакет исходного кода <literal>3.0 (quilt)</literal> очень просто:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>foo</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
ru: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>foo</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... описание заплаты

note: type: Content of: <book><chapter><section><para>
en: The patches stored in the newer <literal>3.0 (quilt)</literal> source format must be <emphasis>fuzz</emphasis> free.  You can ensure this with <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.
ru: Заплаты, хранимые в новом формате исходного кода <literal>3.0 (quilt)</literal>, должны быть <emphasis>без ненужного мусора</emphasis>. Вы должны убедиться в этом, запустив: <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><title>
en: Building the package
ru: Сборка пакета

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
ru: Теперь мы готовы собрать пакет.

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
ru: Полная (пере)сборка

note: type: Content of: <book><chapter><section><para>
en: In order to perform a complete (re)build of a package properly, you need to make sure you have installed
ru: Для полной (пере)сборки пакета, необходимо убедиться в установке следующего:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
ru: пакета <systemitem role="package">build-essential</systemitem>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>), and
ru: пакетов, перечисленных в поле <literal>Build-Depends</literal> (смотрите <xref linkend="control"/>) и

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends-indep</literal> field (see <xref linkend="control"/>).
ru: пакетов, перечисленных в поле <literal>Build-Depends-indep</literal> (смотрите <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
ru: Затем выполните следующую команду в каталоге с исходным кодом:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
ru: Она сделает всё, что необходимо для создания всех двоичных пакетов и пакета с исходным кодом. Она выполняет:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
ru: очистку дерева исходного кода (<literal>debian/rules clean</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the source package (<literal>dpkg-source -b</literal>)
ru: сборку пакета с исходным кодом (<literal>dpkg-source -b</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
ru: сборку программы (<literal>debian/rules build</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build binary packages (<literal>fakeroot debian/rules binary</literal>)
ru: сборку двоичных пакетов (<literal>fakeroot debian/rules binary</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
ru: создаёт файл <filename>.dsc</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.changes</filename> file, using <command>dpkg-genchanges</command>
ru: создаёт файл <filename>.changes</filename> с помощью <command>dpkg-genchanges</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This GPG key must be signed by a Debian developer to get connected to the web of trust and must be registered to <ulink url="&keyring;">the Debian keyring</ulink>.  This enables your uploaded packages to be accepted to the Debian archives.  See <ulink url="&keycreate;">Creating a new GPG key</ulink> and <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.
ru: Для подключения к доверенному веб (web of trust) этот ключ GPG должен быть подписан разработчиком Debian и должен быть зарегистрирован в <ulink url="&keyring;">связке ключей Debian</ulink>. Это позволяет закачивать пакеты для приёма в архивы Debian. Смотрите <ulink url="&keycreate;">Создание нового ключа GPG</ulink> и <ulink url="&keysigning; ">вики Debian по подписыванию ключами</ulink>.

note: type: Content of: <book><chapter><section><para>
en: For a non-native Debian package, e.g., <systemitem role="package">gentoo</systemitem>, you will see the following files in the parent directory (<filename>~/gentoo</filename>) after building packages:
ru: Для неродного пакета Debian, например, <systemitem role="package">gentoo</systemitem>, после сборки пакетов вы увидите следующие файлы в родительском каталоге (<filename>~/gentoo</filename>):

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code.  The file is generated from your <filename>control</filename> file, and is used when unpacking the source with <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ru: Этот файл содержит информацию о содержимом исходного кода. Он файл генерируется из вашего файла <filename>control</filename> и используется при распаковке пакета с исходным кодом с помощью <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This compressed tarball contains your <filename>debian</filename> directory contents.  Each and every addition you made to the original source code is stored as a <command>quilt</command> patch in <filename>debian/patches</filename>.
ru: В этом сжатом архиве tar находится содержимое вашего каталога <filename>debian</filename>. Все дополнения, вносимые вами в исходный код, хранятся в виде заплат <command>quilt</command> в каталоге <filename>debian/patches</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can avoid applying <command>quilt</command> patches in the <literal>3.0 (quilt)</literal> source format at the end of the extraction with the <literal>--skip-patches</literal> option.  Alternatively, you can run <literal>dquilt pop -a</literal> after normal operation.
ru: Вы можете избежать наложения заплат <command>quilt</command> в формате исходного кода <literal>3.0 (quilt)</literal> в конце извлечения, указав параметр <literal>--skip-patches</literal>. Или же вы можете выполнить <literal>quilt pop -a</literal> после обычной распаковки.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If someone else wants to re-create your package from scratch, they can easily do so using the above three files.  The extraction procedure is trivial: just copy the three files somewhere else and run <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>.  <placeholder type="footnote" id="0"/>
ru: Если кто-либо захочет пересоздать ваш пакет с нуля, они легко смогут сделать это, используя перечисленные выше три файла. Процедура извлечения тривиальна: просто скопируйте куда-нибудь три файла и выполните <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is your completed binary package.  You can use <command>dpkg</command> to install and remove this just like any other package.
ru: Это ваш собранный двоичный пакет. Вы можете использовать <command>dpkg</command> для его установки и удаления, как любой другой пакет.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package revision; it is used by the Debian FTP archive maintenance programs to install the binary and source packages.  It is partly generated from the <filename>changelog</filename> file and the <filename>.dsc</filename> file.
ru: В этом файле описываются все изменения, сделанные в данной редакции пакета, и он используется программами поддержки FTP-архива Debian для внесения пакетов (как двоичных, так и с исходным кодом) в архив. Он частично генерируется из файлов <filename>changelog</filename> и <filename>.dsc</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: As you keep working on the package, its behavior will change and new features will be added.  People downloading your package can look at this file and quickly see what has changed.  Debian archive maintenance programs will also post the contents of this file to the <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> mailing list.
ru: По мере того, как вы будете работать над пакетом, будет меняться его поведение и будет добавляться новая функциональность. Люди, загружающие ваш пакет, могут посмотреть этот файл и сразу понять, что было изменено. Программы поддержки архива Debian будут также отправлять содержимое этого файла в список рассылки <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink>.

note: type: Content of: <book><chapter><section><screen>
en: DEBSIGN_KEYID=Your_GPG_keyID
ru: DEBSIGN_KEYID=ID_ключа_GPG

note: type: Content of: <book><chapter><section><para>
en: The long strings of numbers in the <filename>.dsc</filename> and <filename>.changes</filename> files are SHA1/SHA256 checksums for the files mentioned.  Anyone downloading your files can test them with <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and if the numbers don't match, they'll know the file is corrupt or has been tampered with.
ru: Длинные строки цифр в файлах <filename>.dsc</filename> и <filename>.changes</filename> — это контрольные суммы SHA1/SHA256 упомянутых файлов. Человек, загружающий ваши файлы, может проверить их с помощью <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> или <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> и, если числа не совпадают, он поймёт, что файл был повреждён или подделан.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The actual autobuilder system involves much more complicated schemes than the one documented here.  Such details are beyond the scope of this document.
ru: На самом деле, работа системы autobuilder гораздо сложнее, однако её детальное описание не для этого документа.

note: type: Content of: <book><chapter><section><para>
en: Debian supports many <ulink url="&ports;">ports</ulink> with the <ulink url="&buildd;">autobuilder network</ulink> running <command>buildd</command> daemons on computers of many different architectures.  Although you do not need to do this yourself, you should be aware of what will happen to your packages.  Let's look into roughly how they rebuild your packages for multiple architectures.  <placeholder type="footnote" id="0"/>
ru: Debian поддерживает много <ulink url="&ports;">переносов</ulink> с помощью <ulink url="&buildd;">сети autobuilder</ulink>, в которой работает служба <command>buildd</command> на компьютерах различных архитектур. Хотя вам и не придётся этим заниматься, но всё же следует узнать, что будет происходить с вашими пакетами. Рассмотрим в общих чертах как ваш пакет пересобирается для различных архитектур <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: For <literal>Architecture: any</literal> packages, the autobuilder system performs a rebuild.  It ensures the installation of
ru: Для пакетов с <literal>Architecture: any</literal> система autobuilder выполняет пересборку. Она убеждается, что установлен

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
ru: пакет <systemitem role="package">build-essential</systemitem> и

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>).
ru: пакеты, перечисленные в поле <literal>Build-Depends</literal> (смотрите <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
ru: Затем в каталоге с исходным кодом вызывается команда

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
ru: Она делает всё необходимое для сборки пакетов для данной архитектуры. А именно:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
ru: сборку архитектурно-зависимых двоичных пакетов (<literal>fakeroot debian/rules binary-arch</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: sign the source <filename>.dsc</filename> file, using <command>gpg</command>
ru: подпись файла исходного кода <filename>.dsc</filename> с помощью <command>gpg</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: create and sign the upload <filename>.changes</filename> file, using <command>dpkg-genchanges</command> and <command>gpg</command>
ru: создание и подпись загружаемого файла <filename>.changes</filename> с помощью <command>dpkg-genchanges</command> и <command>gpg</command>

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
ru: Так ваш пакет собирается для различных архитектур.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Unlike under the <systemitem role="package">pbuilder</systemitem> package, the <command>chroot</command> environment under the <systemitem role="package">sbuild</systemitem> package used by the autobuilder system does not enforce the use of a minimal system and may have many leftover packages installed.
ru: В отличие от пакета <systemitem role="package">pbuilder</systemitem>,окружение <command>chroot</command> из пакета <systemitem role="package">sbuild</systemitem>, который используется системой autobuilder, не требует минимальной системы и допускает наличие установленных пакетов, не являющихся необходимыми.

note: type: Content of: <book><chapter><section><para>
en: Although packages listed in the <literal>Build-Depends-Indep</literal> field are required to be installed for our normal packaging work (see <xref linkend="completebuild"/>), they are not required to be installed for the autobuilder system since it builds only architecture dependent binary packages.  <placeholder type="footnote" id="0"/> This distinction between normal packaging and autobuilding procedures is what dictates whether you should record such required packages in the <literal>Build-Depends</literal> or <literal>Build-Depends-Indep</literal> fields of the <filename>debian/control</filename> file (see <xref linkend="control"/>).
ru: Хотя пакеты, перечисленные в поле <literal>Build-Depends-indep</literal>, должны быть установлены при ручном пакетировании (смотрите <xref linkend="completebuild"/>), их не нужно устанавливать при использовании системы autobuilder, так как она занимается исключительно архитектурно-зависимыми двоичными пакетами <placeholder type="footnote" id="0"/>. Это различие между обычным пакетированием и использованием autobuilder определяет, где должны быть перечислены необходимые пакеты: в поле <literal>Build-Depends</literal> или <literal>Build-Depends-indep</literal> файла <filename>debian/control</filename> (смотрите <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
ru: Команда <command>debuild</command>

note: type: Content of: <book><chapter><section><para>
en: You can automate the build activity around executing the <command>dpkg-buildpackage</command> command package further with the <command>debuild</command> command.  See <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ru: Для автоматизации действий по сборки с помощью <command>dpkg-buildpackage</command> можно использовать команду <command>debuild</command>. Смотрите <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
ru: Для очистки каталога исходного кода и пересборки пакета выполните:

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
ru: Для очистки древа исходного кода выполните:

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
ru: Пакет <systemitem role="package">pbuilder</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Since the <systemitem role="package">pbuilder</systemitem> package is still evolving, you should check the actual configuration situation by consulting the latest official documentation.
ru: Так как пакет <systemitem role="package">pbuilder</systemitem> всё ещё развивается, за подробностями настройки обратитесь к его официальной документации.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
ru: Более полная информация по автоматической сборке пакетов Debian приведена в <ulink url="&buildd-do;"/>.

note: type: Content of: <book><chapter><section><para>
en: For a clean room (<command>chroot</command>) build environment to verify the build dependencies, the <systemitem role="package">pbuilder</systemitem> package is very useful.  <placeholder type="footnote" id="0"/> This ensures a clean build from the source under the <literal>sid</literal> auto-builder for different architectures and avoids a severity serious FTBFS (Fails To Build From Source) bug which is always in the RC (release critical) category.  <placeholder type="footnote" id="1"/>
ru: В чистой среде сборки (<command>chroot</command>) для проверки пакетных зависимостей очень полезен пакет <systemitem role="package">pbuilder</systemitem> <placeholder type="footnote" id="0"/>. Он поможет убедиться в чистоте сборки под управлением auto-builder из <literal>sid</literal> для различных архитектур и избежать опасной ошибки FTBFS (ошибка сборки из исходного кода), которая всегда относится к категории RC (критична для данного выпуска) <placeholder type="footnote" id="1"/>.

note: type: Content of: <book><chapter><section><para>
en: Let's customize the <systemitem role="package">pbuilder</systemitem> package as follows:
ru: Давайте настроим пакет <systemitem role="package">pbuilder</systemitem> следующим образом:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: setting the <filename>/var/cache/pbuilder/result</filename> directory writable by your user account.
ru: дадим пользователю право записи в каталог <filename>/var/cache/pbuilder/result</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: creating a directory, e.g.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, writable by the user, to place hook scripts in.
ru: создадим каталог для размещения сценариев, например, <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, доступный пользователю для записи.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: configuring <filename>~/.pbuilderrc</filename> or <filename>/etc/pbuilderrc</filename> to include the following.
ru: добавим в файл <filename>~/.pbuilderrc</filename> или в <filename>/etc/pbuilderrc</filename> следующие строки:

note: type: Content of: <book><chapter><section><para>
en: First let's initialize the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system as follows:
ru: Для начальной инициализации локальной системы <command>chroot</command> пакета <systemitem role="package">pbuilder</systemitem> выполним:

note: type: Content of: <book><chapter><section><para>
en: If you already have a completed source package, issue the following commands in the directory where the <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename>, and <filename><replaceable>foo</replaceable>.dsc</filename> files exist to update the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system and to build binary packages in it:
ru: Если у вас имеется готовый пакет исходного кода, то в каталоге, где расположены файлы <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename> и <filename><replaceable>foo</replaceable>.dsc</filename>, для обновления локальной системы <command>chroot</command> пакета <systemitem role="package">pbuilder</systemitem> и сборки соответствующих двоичных пакетов выполните следующие команды:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_version</replaceable>.dsc
ru: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_версия</replaceable>.dsc

note: type: Content of: <book><chapter><section><para>
en: The newly built packages without the GPG signatures will be located in <filename>/var/cache/pbuilder/result/</filename> with non-root ownership.
ru: Только что собранные пакеты без подписи GPG будут помещены в каталог <filename>/var/cache/pbuilder/result/</filename>, их владельцем будет обычный пользователь (не суперпользователь).

note: type: Content of: <book><chapter><section><para>
en: The GPG signatures on the <filename>.dsc</filename> file and the <filename>.changes</filename> file can be generated as:
ru: Подписи GPG для файлов <filename>.dsc</filename> и <filename>.changes</filename> можно сгенерировать следующим образом:

note: type: Content of: <book><chapter><section><screen>
en: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_version_arch</replaceable>.changes
ru: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_версия_архитектура</replaceable>.changes

note: type: Content of: <book><chapter><section><para>
en: If you have an updated source tree but have not generated the matching source package, issue the following commands in the source directory where the <filename>debian</filename> directory exists, instead:
ru: Если у вас есть обновлённое древо исходного кода, но нет собранных пакетов с исходным кодом, выполните в каталоге, где размещён подкаталог <filename>debian</filename>, другие команды:

note: type: Content of: <book><chapter><section><para>
en: You can log into its <command>chroot</command> environment with the <literal>pbuilder --login --save-after-login</literal> command and configure it as you wish.  This environment can be saved by leaving its shell prompt with <literal>^D</literal> (Control-D).
ru: Вы можете войти внутрь окружения <command>chroot</command>  и настроить его командой <literal>pbuilder --login --save-after-login</literal>. Изменения будут сохранены, когда вы покинете оболочку, нажав <literal>^D</literal> (Control-D).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This assumes <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  You can find many examples of hook scripts in the <filename>/usr/share/doc/pbuilder/examples</filename> directory.
ru: Здесь предполагается, что <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>. Примеры вызываемых (hook) сценариев можно найти в каталоге <filename>/usr/share/doc/pbuilder/examples</filename>.

note: type: Content of: <book><chapter><section><para>
en: The latest version of the <command>lintian</command> command can be executed in the <literal>chroot</literal> environment using the hook script <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> configured as follows: <placeholder type="footnote" id="0"/>
ru: Последняя версия команды <command>lintian</command> может быть вызвана в окружении <literal>chroot</literal>, используя сценарий <filename><replaceable>/var/cache/pbuilder/hooks/</replaceable>/B90lintian</filename>, настроенный следующим образом <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: You need to have access to the latest <literal>sid</literal> environment to build packages properly for <literal>sid</literal>.  In practice, <literal>sid</literal> may be experiencing issues which makes it undesirable for you to migrate your whole system.  The <systemitem role="package">pbuilder</systemitem> package can help you to cope with this kind of situation.
ru: Для правильной сборки пакета для <literal>sid</literal> вам потребуется самое свежее окружение этой ветви, однако миграция на <literal>sid</literal> всей системы может быть нежелательна. Пакет <systemitem role="package">pbuilder</systemitem> поможет вам в этой ситуации.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
ru: Есть некоторые ограничения для такого обновления пакета из <literal>stable</literal>.

note: type: Content of: <book><chapter><section><para>
en: See <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, and <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.
ru: Смотрите <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> и <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
ru: Смотрите <ulink url="&debref-vcs;">Системы управления версиями</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If your upstream uses a source code management system (VCS)  <placeholder type="footnote" id="0"/> to maintain their code, you should consider using it as well.  This makes merging and cherry-picking upstream patches much easier.  There are several specialized wrapper script packages for Debian package building for each VCS.
ru: Если автор программы применяет систему управления кодом <placeholder type="footnote" id="0"/>, то и вы можете использовать её возможности. Это упрощает слияние и выборку заплат для исходного кода. Для каждой VCS существуют специализированные инструменты, позволяющие производить сборку пакетов Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git-buildpackage</systemitem>: a suite to help with Debian packages in Git repositories.
ru: <systemitem role="package">git-buildpackage</systemitem>: инструменты для пакетирования в репозиториях Git.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">svn-buildpackage</systemitem>: helper programs to maintain Debian packages with Subversion.
ru: <systemitem role="package">svn-buildpackage</systemitem>: вспомогательные программы для сопровождения пакетов Debian в Subversion.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">cvs-buildpackage</systemitem>: a set of Debian package scripts for CVS source trees.
ru: <systemitem role="package">cvs-buildpackage</systemitem>: набор сценариев для пакетирования в CVS.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documents how to use the <ulink url="&debian-alioth;">alioth.debian.org</ulink> service.
ru: В <ulink url="&debian-alioth-wiki;">вики Debian Alioth</ulink> описано как использовать службу <ulink url="&debian-alioth;">alioth.debian.org</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Use of <systemitem role="package">git-buildpackage</systemitem> is becoming quite popular for Debian Developers to manage Debian packages with the Git server on <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> This package offers many commands to <emphasis>automate</emphasis> packaging activities:
ru: Среди разработчиков Debian становится популярным использовать <systemitem role="package">git-buildpackage</systemitem> для управления пакетами Debian на сервере Git <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> В этот пакет включено много команд для <emphasis>автоматизации</emphasis> процесса упаковки:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository.
ru: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: сборка пакетов Debian из репозитория Git.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository using <command>pbuilder</command>/<command>cowbuilder</command>.
ru: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: сборка пакетов Debian из репозитория Git с помощью <command>pbuilder</command>/<command>cowbuilder</command>.

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
ru: Для ведения пакетирования в этих командах используются 3 ветви:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
ru: <literal>main</literal> — дерево родных пакетов Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
ru: <literal>upstream</literal> — дерево авторского исходного кода.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>pristine-tar</literal> for upstream tarball generated by the <literal>--pristine-tar</literal> option.<placeholder type="footnote" id="0"/>
ru: <literal>pristine-tar</literal> для авторского tar, создаваемый при использовании параметра <literal>--pristine-tar</literal>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Here are some web resources available for advanced audiences.
ru: Несколько веб-ресурсов для опытных пользователей:

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
ru: Сборка пакетов Debian с помощью git-buildpackage (<filename>&git-buildpackage-doc;</filename>)

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&debian-packages-git;">debian packages in git</ulink>
ru: <ulink url="&debian-packages-git;">Пакеты debian в git</ulink>

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&git-debian-packaging;">Using Git for Debian Packaging</ulink>
ru: <ulink url="&git-debian-packaging;">Использование Git для пакетирования Debian</ulink>

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&git-dpm;">git-dpm: Debian packages in Git manager</ulink>
ru: <ulink url="&git-dpm;">git-dpm: пакеты Debian в Git</ulink>

note: type: Content of: <book><chapter><section><para>
en: You can configure <systemitem role="package">git-buildpackage</systemitem> with <filename>~/.gbp.conf</filename>. See <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>
ru: Для настройки <systemitem role="package">git-buildpackage</systemitem> используйте файл <filename>~/.gbp.conf</filename>. Смотрите <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Quick rebuild
ru: Быстрая пересборка

note: type: Content of: <book><chapter><section><para>
en: With a large package, you may not want to rebuild from scratch every time while you're tuning details in <filename>debian/rules</filename>.  For testing purposes, you can make a <filename>.deb</filename> file without rebuilding the upstream sources like this<placeholder type="footnote" id="0"/>:
ru: При работе над большим пакетом, возможно, вы не захотите каждый раз полностью пересобирать его из исходного кода при изменении настроек в файле <filename>debian/rules</filename>. Исключительно для тестовых целей вы можете создать deb-файл без пересборки кода следующим образом <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: Or simply do the following to see if it builds or not:
ru: Или просто выполните для выяснения возможна ли сборка пакета:

note: type: Content of: <book><chapter><section><para>
en: Once you are finished with your tuning, remember to rebuild following the proper procedure.  You may not be able to upload correctly if you try to upload <filename>.deb</filename> files built this way.
ru: После выбора оптимальных настроек не забудьте пересобрать пакет стандартными средствами. Полученные таким способом файлы <filename>.deb</filename> могут быть загружены в архив некорректно, если вы попытаетесь это сделать.

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
ru: Иерархия команд

note: type: Content of: <book><chapter><section><para>
en: Here is a quick summary of how many commands to build packages fit together in the command hierarchy. There are many ways to do the same thing.
ru: Вот краткая сводка команд, которые объединяются в единую систему для сборки пакетов. Есть много способов сделать одно и тоже.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
ru: <filename>debian/rules</filename> = сценарий сопровождающего для сборки пакета

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
ru: <command>dpkg-buildpackage</command> = ключевой инструмент сборки пакета

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (build under the sanitized environment variables)
ru: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (сборка при проверенных переменных окружение)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
ru: <command>pbuilder</command> = ключевой инструмент chroot-окружения Debian

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (build in the chroot)
ru: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (сборка в chroot)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
ru: <command>cowbuilder</command> = ускорение выполнения <command>pbuilder</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>git-pbuilder</command> = the easy-to-use commandline syntax for <command>pdebuild</command> (used by <command>gbp buildpackage</command>)
ru: <command>git-pbuilder</command> = простой синтаксис командной строки для <command>pdebuild</command> (используется в <command>gbp buildpackge</command>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
ru: <command>gbp</command> = управление исходным кодом Debian в репозитории git

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp buildpackage</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>
ru: <command>gbp buildpackge</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>

note: type: Content of: <book><chapter><section><para>
en: Although use of higher level commands such as <command>gbp buildpackage</command> and <command>pbuilder</command> ensures the perfect package building environment, it is essential to understand how lower level commands such as <filename>debian/rules</filename> and <command>dpkg-buildpackage</command> are executed under them.
ru: Хотя высокоуровневые команды, такие как <command>gbp buildpackge</command> и <command>pbuilder</command>, предоставляют замечательную среду сборки пакета, необходимо понимать какие нижележащие команды, такие как <filename>debian/rules</filename> и <command>dpkg-buildpackage</command>, в них используются.

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
ru: Проверка пакета на наличие ошибок

note: type: Content of: <book><chapter><para>
en: There are some techniques you should know for checking a package for errors before uploading it to the public archives.
ru: Есть несколько стандартных процедур для самостоятельной проверки пакета на наличие ошибок перед его загрузкой в публичный архив, которые вам следует знать.

note: type: Content of: <book><chapter><para>
en: It's also a good idea to carry out testing on a machine other than your own.  You must watch closely for any warnings or errors for all the tests described here.
ru: Лучше проверять пакет на другой машине (не на той, на которой он собирался). Обращайте пристальное внимание на предупреждения и сообщения об ошибках, получаемые в результате описываемых тестов.

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
ru: Подозрительные изменения

note: type: Content of: <book><chapter><section><para>
en: If you find a new autogenerated patch file such as <filename>debian-changes-*</filename> in the <filename>debian/patches</filename> directory after building your non-native Debian package in <literal>3.0 (quilt)</literal> format, chances are you changed some files by accident or the build script modified the upstream source.  If it is your mistake, fix it.  If it is caused by the build script, fix the root cause with <command>dh-autoreconf</command> as in <xref linkend="customrules"/> or work around it with <filename>source/options</filename> as in <xref linkend="sourceopt"/>.
ru: Если вы обнаружите новые автоматически сгенерированные файлы заплат <filename>debian-changes-*</filename> в каталоге <filename>debian/patches</filename> после сборки своего неродного пакета Debian в формате <literal>3.0 (quilt)</literal>, то, вероятнее всего, вы неумышленно изменили какие-то файлы или это сделал авторский сценарий сборки. Если это ваша ошибка, исправьте её. Если это сценарий, то исправьте источник ошибки с помощью <command>dh-autoreconf</command>, как это описано в <xref linkend="customrules"/>, или обойдите её с помощью <filename>source/options</filename>, который описан в <xref linkend="sourceopt"/>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
ru: Проверка установки пакета

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
ru: Проверка сценариев сопровождающего пакета

note: type: Content of: <book><chapter><section><para>
en: All maintainer scripts (that is, <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename>, and <filename>postrm</filename> files) are hard to write correctly unless they are auto-generated by the <systemitem role="package">debhelper</systemitem> programs.  So do not use them if you are a novice maintainer (see <xref linkend="maintscripts"/>).
ru: Все сценарии сопровождающего (<filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename> и <filename>postrm</filename>) сложны в написании, если только для их автоматической генерации не применялись программы из пакета <systemitem role="package">debhelper</systemitem>. Поэтому не пользуйтесь этими сценариями, если вы начинающий сопровождающий (смотрите <xref linkend="maintscripts"/>).

note: type: Content of: <book><chapter><section><para>
en: If the package makes use of these non-trivial maintainer scripts, be sure to test not only for install but also for remove, purge, and upgrade processes.  Many maintainer script bugs show up when packages are removed or purged.  Use the <command>dpkg</command> command as follows to test them:
ru: Если ваш пакет использует эти нетривиальные сценарии сопровождающего, убедитесь, что не только установка, но и удаление, вычистка и обновление пакета также проходят успешно. Многие ошибки в таких сценариях проявляются при удалении или вычистке. Для проверки используйте команду <command>dpkg</command>:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>i386</replaceable>.deb
ru: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>версия</replaceable>-<replaceable>редакция</replaceable>_<replaceable>i386</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
ru: Следует выполнить следующие шаги:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
ru: установите предыдущую версию (если необходимо)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
ru: обновите пакет с предыдущей версии

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
ru: откатитесь на предыдущую версию (по желанию)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: purge it.
ru: вычистите пакет

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
ru: установите новый пакет

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
ru: удалите его

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
ru: установите опять

note: type: Content of: <book><chapter><section><para>
en: If this is your first package, you should create dummy packages with different versions to test your package in advance to prevent future problems.
ru: Если это ваш первый пакет, то для тестирования вам понадобятся ещё пакеты-пустышки различных версий.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that if your package has previously been released in Debian, people will often be upgrading to your package from the version that was in the last Debian release.  Remember to test upgrades from that version too.
ru: Не забудьте проверить наличие в Debian предыдущей версии программы, которую вы пакетируете. В этом случае пользователи, у которых установлена предыдущая версия, могут захотеть обновить пакет и вам следует убедиться в отсутствии проблем при таком обновлении. Также протестируйте обновления и с этой версии.

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
ru: Хотя откат к предыдущей версии официально не поддерживается, будет здорово обеспечить такую возможность.

note: type: Content of: <book><chapter><section><title>
en: Using <systemitem role="package">lintian</systemitem>
ru: Использование <systemitem role="package">lintian</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You do not need to provide the <command>lintian</command> option <literal>-i -I --show-overrides</literal> if you customized <filename>/etc/devscripts.conf</filename> or <filename>~/.devscripts</filename> as described in <xref linkend="debuild"/>.
ru: Вам не потребуется указывать параметр <command>lintian</command> <literal>-i -I --show-overrides</literal>, если вы настроили файл настройки <filename>/etc/devscripts.conf</filename> или <filename>~/.devscripts</filename>, как это было описано в <xref linkend="debuild"/>.

note: type: Content of: <book><chapter><section><para>
en: Run <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> on your <filename>.changes</filename> file.  The <command>lintian</command> command runs many test scripts to check for many common packaging errors.  <placeholder type="footnote" id="0"/>
ru: Запустите <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, передав ей параметром файл <filename>.changes</filename>. Команда <command>lintian</command> выполняет множество тестовых сценариев, проверяющих наличие типичных ошибок пакетирования <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of the <filename>.changes</filename> file generated for your package.  The output of the <command>lintian</command> command uses the following flags:
ru: Разумеется, следует заменить имя файла <filename>.changes</filename> на то, которое было сгенерировано для вашего пакета. В результатах команды <command>lintian</command> используются следующие метки:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
ru: <literal>E:</literal> — ошибка; нарушение политики или ошибка пакетирования.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
ru: <literal>W:</literal> — предупреждение; возможное нарушение политики или ошибка пакетирования.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
ru: <literal>I:</literal> — для информации; сведения о некоторых аспектах пакетирования.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
ru: <literal>N:</literal> — замечание; уточнение, помогающее при отладке.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>O:</literal> for overridden; a message overridden by the <filename>lintian-overrides</filename> files but displayed by the <literal>--show-overrides</literal> option.
ru: <literal>O:</literal> — скрытые сообщения; информация, скрываемая на основе файла <filename>lintian-overrides</filename>, но показываемая при указании параметра <literal>--show-overrides</literal>.

note: type: Content of: <book><chapter><section><para>
en: When you see warnings, tune the package to avoid them or verify that the warnings are spurious.  If spurious, set up <filename>lintian-overrides</filename> files as described in <xref linkend="lintian"/>.
ru: Если вы видите предупреждения — исправьте пакет, чтобы их не было или убедитесь, что это нормально. Если предупреждения излишни — настройте файл <filename>lintian-overrides</filename>, как описано в <xref linkend="lintian"/>.

note: type: Content of: <book><chapter><section><para>
en: Note that you can build the package with <command>dpkg-buildpackage</command> and run <command>lintian</command> on it in one command, if you use <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ru: Заметим, что команда <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> или <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> позволяет собрать пакет с помощью <command>dpkg-buildpackage</command> и сразу проверить его <command>lintian</command>.

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
ru: Команда <command>debc</command>

note: type: Content of: <book><chapter><section><para>
en: You can list files in the binary Debian package with the <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
ru: Вы можете просмотреть список файлов в двоичном пакете Debian с помощью команды <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><screen>
en: $ debc <replaceable>package</replaceable>.changes
ru: $ debc <replaceable>пакет</replaceable>.changes

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
ru: Команда <command>debdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare file contents in two source Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
ru: Вы можете сравнить содержимое файлов двух пакетов исходного кода Debian с помощью команды <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.dsc <replaceable>new-package</replaceable>.dsc
ru: $ debdiff <replaceable>старый-пакет</replaceable>.dsc <replaceable>новый-пакет</replaceable>.dsc

note: type: Content of: <book><chapter><section><para>
en: You can also compare file lists in two sets of binary Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
ru: Также с помощью команды <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> вы можете сравнить списки файлов двух двоичных пакетов Debian.

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.changes <replaceable>new-package</replaceable>.changes
ru: $ debdiff <replaceable>старый-пакет</replaceable>.changes <replaceable>новый-пакет</replaceable>.changes

note: type: Content of: <book><chapter><section><para>
en: These are useful to identify what has been changed in the source packages and to check for inadvertent changes made when updating binary packages, such as unintentionally misplacing or removing files.
ru: Это полезно для определения того, что изменилось в пакетах исходного кода, и что не произошло никаких непреднамеренных изменений при обновлении двоичных пакетов, например неправильного перемещения или удаления файлов.

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
ru: Команда <command>interdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare two <filename>diff.gz</filename> files with the <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.  This is useful for verifying that no inadvertent changes were made to the source by the maintainer when updating packages in the old <literal>1.0</literal> source format.
ru: Команда <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> позволяет сравнить два файла <filename>diff.gz</filename>. Это полезно для проверки отсутствия сделанных сопровождающим нечаянных правок исходного кода при обновлении пакетов в старом формате <literal>1.0</literal>.

note: type: Content of: <book><chapter><section><screen>
en: $ interdiff -z <replaceable>old-package</replaceable>.diff.gz <replaceable>new-package</replaceable>.diff.gz
ru: $ interdiff -z <replaceable>старый-пакет</replaceable>.diff.gz <replaceable>новый-пакет</replaceable>.diff.gz

note: type: Content of: <book><chapter><section><para>
en: The new <literal>3.0</literal> source format stores changes in multiple patch files as described in <xref linkend="patches"/>.  You can trace changes of each <filename>debian/patches/*</filename> file using <command>interdiff</command>, too.
ru: В новой версии формата пакетов с исходным кодом <literal>3.0</literal> изменения хранятся в нескольких файлах заплат (описано в <xref linkend="patches"/>). Вы можете отследить изменения каждого файла <filename>debian/patches/*</filename> также с помощью <command>interdiff</command>.

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
ru: Команда <command>mc</command>

note: type: Content of: <book><chapter><section><para>
en: Many of these file inspection operations can be made into an intuitive process by using a file manager like <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> which will let you browse not only the contents of <filename>*.deb</filename> package files but also <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, and <filename>*.orig.tar.gz</filename> files.
ru: Большинство этих файловых проверок могут быть сделаны интуитивно понятным образом с помощью файлового менеджера типа <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, который позволяет просматривать содержимое не только файлов пакетов <filename>*.deb</filename>, но и таких файлов как <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename> и <filename>*.orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><para>
en: Be on the lookout for extra unneeded files or zero length files, both in the binary and source package.  Often cruft doesn't get cleaned up properly; adjust your <filename>rules</filename> file to compensate for this.
ru: Внимательно следите за лишними ненужными файлами или файлами нулевой длины как в двоичном пакете, так и в пакете с исходным кодом. Зачастую, мусор не вычищается должным образом; подправьте ваш файл <filename>rules</filename>, чтобы исправить это.

note: type: Content of: <book><chapter><title>
en: Updating the package
ru: Обновление пакета

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
ru: Вскоре после выпуска пакета, вам понадобится его обновить.

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
ru: Новая редакция Debian

note: type: Content of: <book><chapter><section><para>
en: Let's say that a bug report was filed against your package as <literal>#654321</literal>, and it describes a problem that you can solve.  Here's what you need to do to create a new Debian revision of the package:
ru: Предположим, что в вашем пакете нашли ошибку (номер <literal>#654321</literal>), и описываемую там проблему вы можете решить. Для того, чтобы создать новую редакцию пакета, нужно:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
ru: Если исправление должно быть записано в виде новой заплаты, сделайте следующее:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> to set the patch name;
ru: запустите <literal>dquilt new <replaceable>название-ошибки.patch</replaceable></literal> для присвоения имени заплате;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> to declare the file to be modified;
ru: запустите <literal>dquilt add <replaceable>файл-с-ошибкой</replaceable></literal> для объявления файла, который должен быть изменён;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
ru: исправьте ошибку в пакете исходного кода;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to record it to <filename><replaceable>bugname.patch</replaceable></filename>;
ru: запустите <literal>dquilt refresh</literal> для записи исправления в файл <filename><replaceable>название-ошибки.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
ru: запустите <literal>dquilt header -e</literal> для добавления её описания;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
ru: Если для исправления требуется обновление существующей заплаты, сделайте следующее:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> to recall the existing <filename><replaceable>foo.patch</replaceable></filename>;
ru: запустите <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> для того, чтобы откатить наложенную заплату <filename><replaceable>foo.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the old <filename><replaceable>foo.patch</replaceable></filename>;
ru: исправьте проблему в старой заплате <filename><replaceable>foo.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update <filename><replaceable>foo.patch</replaceable></filename>;
ru: запустите <literal>dquilt refresh</literal> для обновления заплаты <filename><replaceable>foo.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
ru: запустите <literal>dquilt header -e</literal> для обновления её описания;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>;
ru: запустите <literal>while dquilt push; do dquilt refresh; done</literal> для применения всех заплат при удалении <emphasis>шероховатостей</emphasis>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: To get the date in the required format, use <literal>LANG=C date -R</literal>.
ru: Дату в нужном формате можно получить с помощью команды <literal>LANG=C date -R</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add a new revision at the top of the Debian <filename>changelog</filename> file, for example with <literal>dch -i</literal>, or explicitly with <literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> and then insert the comments using your preferred editor.  <placeholder type="footnote" id="0"/>
ru: Добавьте новую редакцию в начало файла Debian <filename>changelog</filename>, например, с помощью <literal>dch -i</literal> или вручную с помощью <literal>dch -v <replaceable>версия</replaceable>-<replaceable>редакция</replaceable></literal>, а затем добавьте комментарии с помощью текстового редактора <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Include a short description of the bug and the solution in the changelog entry, followed by <literal>Closes: #654321</literal>.  That way, the bug report will be <emphasis>automagically</emphasis> closed by the archive maintenance software the moment your package gets accepted into the Debian archive.
ru: Включите краткое описание ошибки и её решение в список изменений (changelog), сопроводив текстом <literal>Closes: #654321</literal>. Это позволит <emphasis>автомагически</emphasis> закрыть сообщение об ошибке с помощью программного обеспечения обслуживания архива в тот момент, когда ваш пакет будет принят в архив Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in the above to fix more bugs while updating the Debian <filename>changelog</filename> file with <literal>dch</literal> as needed.
ru: Повторите то, что делали выше, для исправления других ошибок, обновляя файл Debian <filename>changelog</filename> с помощью <literal>dch</literal> по мере надобности.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
ru: Повторите всё из <xref linkend="completebuild"/> и <xref linkend="checkit"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Once you are satisfied, you should change the distribution value in <filename>changelog</filename> from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).<placeholder type="footnote" id="0"/>
ru: После проверки правильности, измените в <filename>changelog</filename> имя выпуска с <literal>UNRELEASED</literal> на значение целевого дистрибутива <literal>unstable</literal> (или даже на <literal>experimental</literal>). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
ru: Изучение нового авторского выпуска

note: type: Content of: <book><chapter><section><para>
en: Start by reading the upstream <filename>changelog</filename>, <filename>NEWS</filename>, and whatever other documentation they may have released with the new version.
ru: Начните с чтения файлов <filename>changelog</filename>, <filename>NEWS</filename> и всей остальной документации, которая может поставляться с новой версией.

note: type: Content of: <book><chapter><section><para>
en: You can then inspect changes between the old and new upstream sources as follows, watching out for anything suspicious:
ru: Потом проверьте изменения между старым и новым исходным кодом программы, как описано ниже, чтобы найти что-нибудь подозрительное:

note: type: Content of: <book><chapter><section><screen>
en: $ diff -urN <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable> <replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
ru: $ diff -urN <replaceable>foo</replaceable>-<replaceable>старая-версия</replaceable> <replaceable>foo</replaceable>-<replaceable>новая-версия</replaceable>

note: type: Content of: <book><chapter><section><para>
en: Changes to some auto-generated files by Autotools such as <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename>, and <filename>Makefile.in</filename> may be ignored.  You may delete them before running <command>diff</command> on the source for inspection.
ru: На изменения в некоторых автоматически сгенерированных файлах Autotools, таких как <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename> и <filename>Makefile.in</filename>, можно не обращать внимания. Вы можете удалить их перед запуском <command>diff</command> для проверки исходного кода.

note: type: Content of: <book><chapter><section><title>
en: New upstream release
ru: Новый авторский выпуск

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is packaged in the old <literal>1.0</literal> format, this can be done by running <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> in the new extracted source, instead.
ru: Если пакет <systemitem role="package"><replaceable>foo</replaceable></systemitem> собран в старом формате <literal>1.0</literal>, то вместо этого можно запустить <literal>zcat /<replaceable>путь</replaceable>/<replaceable>к</replaceable>/<replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>.diff.gz|patch -p1</literal> в каталоге с новым исходным кодом.

note: type: Content of: <book><chapter><section><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is properly packaged in the newer <literal>3.0 (native)</literal> or <literal>3.0 (quilt)</literal> formats, packaging a new upstream version is essentially moving the old <filename>debian</filename> directory to the new source.  This can be done by running <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> in the new extracted source.  <placeholder type="footnote" id="0"/> Of course, you need to do some obvious chores:
ru: Если пакет <systemitem role="package"><replaceable>foo</replaceable></systemitem> правильно собран в новом формате <literal>3.0 (native)</literal> или <literal>3.0 (quilt)</literal>, то для подготовки пакета новой версии программы достаточно переместить старый каталог <filename>debian</filename> в новый исходный код. Это можно сделать запуском <literal>tar xvzf /<replaceable>путь</replaceable>/<replaceable>к</replaceable>/<replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>.debian.tar.gz</literal> в каталоге с новым исходным кодом <placeholder type="footnote" id="0"/>. Конечно, потребуется сделать несколько очевидных рутинных операций:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a copy of the upstream source as the <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename> file.
ru: Скопируйте авторский исходный код в файл <filename>foo_<replaceable>новая-версия</replaceable>.orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Update the Debian <filename>changelog</filename> file with <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal>.
ru: Обновите файл Debian <filename>changelog</filename> с помощью <literal>dch -v <replaceable>новая-версия</replaceable>-<replaceable>1</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add an entry with <literal>New upstream release</literal>.
ru: Добавьте пометку <literal>New upstream release</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>in the new upstream release</emphasis> that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
ru: Лаконично опишите изменения <emphasis>в новом авторском выпуске</emphasis>, которые исправляют найденные ошибки, и закройте эти ошибки, добавляя <literal>Closes: #<replaceable>номер_ошибки</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>to the new upstream release</emphasis> by the maintainer that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
ru: Лаконично опишите изменения <emphasis>в новом авторском выпуске</emphasis>, сделанные сопровождающим, которые исправляют найденные ошибки, и закройте эти ошибки, добавляя <literal>Closes: #<replaceable>номер_ошибки</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>.
ru: запустите <literal>while dquilt push; do qduilt refresh; done</literal> для применения всех заплат при удалении <emphasis>шероховатостей</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: If the patch/merge did not apply cleanly, inspect the situation (clues are left in <filename>.rej</filename> files).
ru: Если наложение/слияние произошло с ошибками, изучите ситуацию (сведения есть в файлах <filename>.rej</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source was integrated into the upstream source,
ru: Если применяемая заплата к исходному коду была интегрирована в авторский исходный код, то

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
ru: выполните <literal>dquilt delete</literal> для её удаления.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source conflicted with new changes in the upstream source,
ru: Если применяемая заплата к исходному коду конфликтует с новыми изменениями в авторском исходном коде, то

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt push -f</literal> to apply old patches while forcing rejects as <filename><replaceable>baz</replaceable>.rej</filename>.
ru: выполните <literal>dquilt push -f</literal> для наложения старых заплат с отбрасыванием конфликтующих <filename><replaceable>baz</replaceable>.rej</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Edit the <filename><replaceable>baz</replaceable></filename> file manually to bring about the intended effect of <filename><replaceable>baz</replaceable>.rej</filename>.
ru: Исправьте файл <filename><replaceable>baz</replaceable></filename> ручным копированием нужных строки из <filename><replaceable>baz</replaceable>.rej</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update the patch.
ru: запустите <literal>dquilt refresh</literal> для обновления заплаты.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
ru: Продолжайте, как обычно, командой <literal>while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><section><para>
en: This process can be automated using the <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command as follows:
ru: Это может быть автоматизировано с помощью команды <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>:

note: type: Content of: <book><chapter><section><screen>
en: $ apt-get source <replaceable>foo</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>foo</replaceable> in <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    dpkg-source: info: unpacking <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>/
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.dsc
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>foo</replaceable>/<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    $ uupdate -v <replaceable>newversion</replaceable> ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... document changes made
ru: $ apt-get source <replaceable>foo</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>foo</replaceable> in <replaceable>foo</replaceable>-<replaceable>старая-версия</replaceable>
    dpkg-source: info: unpacking <replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>foo</replaceable>-<replaceable>старая-версия</replaceable>/
    <replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>-1.debian.tar.gz
    <replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>-1.dsc
    <replaceable>foo</replaceable>_<replaceable>старая-версия</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>foo</replaceable>/<replaceable>foo</replaceable>-<replaceable>новая-версия</replaceable>.tar.gz
    $ cd <replaceable>foo</replaceable>-<replaceable>старая-версия</replaceable>
    $ uupdate -v <replaceable>новая-версия</replaceable> ../<replaceable>foo</replaceable>-<replaceable>новая-версия</replaceable>.tar.gz
    $ cd ../<replaceable>foo</replaceable>-<replaceable>новая-версия</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... описание проведённых изменений

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the <command>uscan</command> command downloads the updated source but it does not run the <command>uupdate</command> command, you should correct the <filename>debian/watch</filename> file to have <literal>debian uupdate</literal> at the end of the URL.
ru: Если команда <command>uscan</command> скачает обновлённый исходный код, но не запустит команду <command>uupdate</command>, исправьте файл <filename>debian/watch</filename> таким образом, чтобы упоминание <literal>debian uupdate</literal> было в конце URL.

note: type: Content of: <book><chapter><section><para>
en: If you set up a <filename>debian/watch</filename> file as described in <xref linkend="watch"/>, you can skip the <command>wget</command> command.  You simply run <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> in the <filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> directory instead of the <command>uupdate</command> command.  This will <emphasis>automagically</emphasis> look for the updated source, download it, and run the <command>uupdate</command> command.  <placeholder type="footnote" id="0"/>
ru: Если вы настроили файл <filename>debian/watch</filename> по описанию из <xref linkend="watch"/>, то можете пропустить команду <command>wget</command>. Просто запустите <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> в каталоге <filename><replaceable>foo</replaceable>-<replaceable>старая-версия</replaceable></filename> вместо команды <command>uupdate</command>. Она <emphasis>автомагически</emphasis> найдёт обновления исходного кода, скачает его и запустит команду <command>uupdate</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: You can release this updated source by repeating what you did in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, and <xref linkend="upload"/>.
ru: Вы можете выпустить этот обновлённый исходный код, повторив то, что делали в <xref linkend="completebuild"/>, <xref linkend="checkit"/> и <xref linkend="upload"/>.

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
ru: Обновление стиля пакетирования

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If your sponsor or other maintainers object to updating the existing packaging style, don't bother arguing.  There are more important things to do.
ru: Не стоит беспокоиться или спорить, если ваш поручитель или другие сопровождающие возражают против обновления существующего стиля пакетирования. Есть более важные вещи.

note: type: Content of: <book><chapter><section><para>
en: Updating the package style is not a required activity for the update of a package.  However, doing so lets you use the full capabilities of the modern <systemitem role="package">debhelper</systemitem> system and the <literal>3.0</literal> source format.  <placeholder type="footnote" id="0"/>
ru: При обновлении пакета обновлять стиль пакетирования необязательно. Но сделав это, вы сможете полностью использовать возможности современной системы <systemitem role="package">debhelper</systemitem> и формата исходного кода <literal>3.0</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you need to recreate deleted template files for any reason, you can run <command>dh_make</command> again in the same Debian package source tree with the <literal>--addmissing</literal> option.  Then edit them appropriately.
ru: Если по какой-то причине требуется пересоздать удалённые шаблоны файлов, вы можете ещё раз запустить <command>dh_make</command> с параметром <literal>--addmissing</literal> в том же дереве исходного кода пакета Debian, а затем отредактировать их должным образом.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If the package has not been updated to use the <systemitem role="package">debhelper</systemitem> v7+ <command>dh</command> syntax for the <filename>debian/rules</filename> file, update it to use <command>dh</command>.  Update the <filename>debian/control</filename> file accordingly.
ru: Если в пакете файл <filename>debian/rules</filename> не переписан с использованием команды <command>dh</command> из пакета <systemitem role="package">debhelper</systemitem> v7+, то сделайте это. Обновите файл <filename>debian/control</filename> соответствующим образом.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you want to update the <filename>rules</filename> file created with the <filename>Makefile</filename> inclusion mechanism of the Common Debian Build System (<systemitem role="package">cdbs</systemitem>) to the <command>dh</command> syntax, see the following to understand its <literal>DEB_*</literal> configuration variables.
ru: Если вы хотите переписать файл <filename>rules</filename> с использованием <command>dh</command>, в котором сейчас используется механизм включения <filename>Makefile</filename> из Common Debian Build System (<systemitem role="package">cdbs</systemitem>), то для понимания его переменных настройки <literal>DEB_*</literal> смотрите следующие документы:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
ru: локальная копия <filename>&cdbs-doc;</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package without the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (native)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (native)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.
ru: Если у вас есть пакет исходного кода формата <literal>1.0</literal> без файла <filename><replaceable>foo</replaceable>.diff.gz</filename>, вы можете обновить его до нового формата исходного кода <literal>3.0 (native)</literal>, создав файл <filename>debian/source/format</filename> с содержимым <literal>3.0 (native)</literal>. Остальные файлы <filename>debian/*</filename> могут быть просто скопированы.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can split <filename>big.diff</filename> into many small incremental patches using the <command>splitdiff</command> command.
ru: Вы можете разделить файл <filename>big.diff</filename> на много маленьких приращиваемых заплат с помощью команды <command>splitdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package with the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (quilt)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (quilt)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.  Import the <filename>big.diff</filename> file generated by the command <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> to your <command>quilt</command> system, if needed.  <placeholder type="footnote" id="0"/>
ru: Если у вас есть пакет с исходным кодом формата <literal>1.0</literal> с файлом <filename><replaceable>foo</replaceable>.diff.gz</filename>, вы можете обновить его до нового формата исходного кода <literal>3.0 (quilt)</literal>, создав файл <filename>debian/source/format</filename> с содержимым <literal>3.0 (quilt)</literal>. Остальные файлы <filename>debian/*</filename> могут быть просто скопированы. Если нужно, импортируйте файл <filename>big.diff</filename>, полученный командой <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal>, в вашу систему <command>quilt</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged using another patch system such as <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, or <systemitem role="package">cdbs</systemitem> with <literal>-p0</literal>, <literal>-p1</literal>, or <literal>-p2</literal>, convert it to <systemitem role="package">quilt</systemitem> using <filename>deb3</filename> at <ulink url="&deb3;"/>.
ru: Если в пакете используется другая система заплат, например, <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem> или <systemitem role="package">cdbs</systemitem> с параметром <literal>-p0</literal>, <literal>-p1</literal> или <literal>-p2</literal>, перейдите на <systemitem role="package">quilt</systemitem>, используя <filename>deb3</filename>, как описано в <ulink url="&deb3;"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged with the <command>dh</command> command with the <literal>--with quilt</literal> option or with the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands, remove these and make it use the newer <literal>3.0 (quilt)</literal> source format.
ru: Если пакет был собран командой <command>dh</command> с параметром <literal>--with quilt</literal> или командами <command>dh_quilt_patch</command> и <command>dh_quilt_unpatch</command>, уберите их и перейдите на использование нового формата пакетов исходного кода <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><para>
en: You should check <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> and adopt ACCEPTED proposals.
ru: Проверьте <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> и учтите ПРИНЯТЫЕ предложения.

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
ru: Также вам нужно выполнить остальные задачи, описанные в <xref linkend="newupstream"/>.

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
ru: Преобразование в UTF-8

note: type: Content of: <book><chapter><section><para>
en: If upstream documents are encoded in old encoding schemes, converting them to <ulink url="&utf8;">UTF-8</ulink> is a good idea.
ru: Если авторские документы поставляются в старых кодировках, лучше преобразовать их в <ulink url="&utf8;">UTF-8</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert encodings of plain text files.
ru: Для перекодирования простых файлов используйте <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert from HTML files to UTF-8 plain text files.  When you do this, make sure to execute it under UTF-8 locale.
ru: Для перекодирования файлов HTML в простой текст в кодировке UTF-8 используйте <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Выполнение данной операции должно проводиться при включённой локали UTF-8.

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
ru: Замечания по обновлению пакетов

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Preserve old <filename>changelog</filename> entries (sounds obvious, but there have been cases of people typing <literal>dch</literal> when they should have typed <literal>dch -i</literal>.)
ru: Не удаляйте старые записи из <filename>changelog</filename> (на первый взгляд это очевидно, но были случаи случайного набора <literal>dch</literal> вместо <literal>dch -i</literal>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Existing Debian changes need to be reevaluated; throw away stuff that upstream has incorporated (in one form or another) and remember to keep stuff that hasn't been incorporated by upstream, unless there is a compelling reason not to.
ru: Существующие изменения Debian должны быть пересмотрены; выбросьте инструментарий, который включил автор (в той или иной форме) и не забудьте оставить инструментарий, который не был включён автором, пока не появится убедительной причины этого не делать.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If any changes were made to the build system (hopefully you'd know from inspecting upstream changes) then update the <filename>debian/rules</filename> and <filename>debian/control</filename> build dependencies if necessary.
ru: Если в систему для сборки были внесены изменения (к счастью, вы узнаете об этом при изучении авторских изменений), то при необходимости обновите сборочные зависимости в файлах <filename>debian/rules</filename> и <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> to see if someone has provided patches to bugs that are currently open.
ru: Проверьте <ulink url="&bts;">систему отслеживания ошибок (BTS)</ulink> на случай, если кто-нибудь предоставил заплаты для исправления незакрытых ошибок.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the contents of the <filename>.changes</filename> file to make sure you are uploading to the correct distribution, the proper bug closures are listed in the <literal>Closes</literal> field, the <literal>Maintainer</literal> and <literal>Changed-By</literal> fields match, the file is GPG-signed, etc.
ru: Проверьте содержимое файла <filename>.changes</filename> и убедитесь, что вы выполняете отправку в правильный дистрибутив, закрываемые ошибки перечислены в поле <literal>Closes</literal>, поля <literal>Maintainer</literal> и <literal>Changed-By</literal> совпадают, файл подписан GPG и т. д.

note: type: Content of: <book><chapter><title>
en: Uploading the package
ru: Отправка пакета

note: type: Content of: <book><chapter><para>
en: Now that you have tested your new package thoroughly, you want to release it to a public archive to share it.
ru: Теперь, после тщательного тестирования вашего нового пакета, вы хотите отправить его в публичный архив для использования.

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
ru: Отправка в архив Debian

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
ru: Смотрите <xref linkend="socialdynamics"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are publicly accessible archives such as <ulink url="&mentors-dn;"/> which work almost the same way as the Debian archive and provide an upload area for non-DDs.  You can set up an equivalent archive by yourself using the tools listed at <ulink url="&deb-archive;"/>.  So this section is useful for non-DDs, too.
ru: Существуют публично доступные архивы, например <ulink url="&mentors-dn;"/>, которые работают почти также как архив Debian и предоставляют зону для отправки людям, не имеющим статуса разработчика Debian. Вы можете создать свой архив с помощью инструментов, перечисленных в <ulink url="&deb-archive;"/>. Поэтому данный раздел также будет полезен не только разработчикам Debian.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <systemitem role="package">dput</systemitem> package seems to come with more features and to be becoming more popular than the <systemitem role="package">dupload</systemitem> package.  It uses the file <filename>/etc/dput</filename> for its global configuration and the file <filename>~/.dput.cf</filename> for per-user configuration.  It supports Ubuntu-related services out-of-the-box, too.
ru: Сейчас, вероятно, пакет <systemitem role="package">dput</systemitem> имеет больше возможностей и становится более популярным, чем <systemitem role="package">dupload</systemitem>. Для его настройки используется системный файл <filename>/etc/dput</filename> и пользовательский <filename>~/.dput.cf</filename>. Также он поддерживается службами Ubuntu без дополнительной настройки.

note: type: Content of: <book><chapter><section><para>
en: Once you become an official developer, <placeholder type="footnote" id="0"/> you can upload the package to the Debian archive.  <placeholder type="footnote" id="1"/> You can do this manually, but it's easier to use the existing automated tools, like <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  We'll describe how it's done with <command>dupload</command>.  <placeholder type="footnote" id="2"/>
ru: После того, как вы станете официальным разработчиком <placeholder type="footnote" id="0"/>, то сможете отправлять пакеты в архив Debian <placeholder type="footnote" id="1"/>. Вы можете делать это вручную, но легче воспользоваться существующими инструментами автоматизации, такими как <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> или <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Здесь будет рассказано как это сделать с помощью <command>dupload</command> <placeholder type="footnote" id="2"/>.

note: type: Content of: <book><chapter><section><para>
en: First you have to set up <command>dupload</command>'s config file.  You can either edit the system-wide <filename>/etc/dupload.conf</filename> file, or have your own <filename>~/.dupload.conf</filename> file override the few things you want to change.
ru: Сначала, вам нужно настроить конфигурационный файл для <command>dupload</command>. Вы можете отредактировать системный файл <filename>/etc/dupload.conf</filename>, либо создать свой собственный файл <filename>~/.dupload.conf</filename>, указав те настройки, которые нужно изменить.

note: type: Content of: <book><chapter><section><para>
en: You can read the <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> manual page to understand what each of these options means.
ru: Описание каждого параметра приведено в справочной странице <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <literal>$default_host</literal> option determines which of the upload queues will be used by default.  <literal>anonymous-ftp-master</literal> is the primary one, but it's possible that you will want to use another one.  <placeholder type="footnote" id="0"/>
ru: Параметр <literal>$default_host</literal> определяет, какая из очередей отправки будет использована по умолчанию. Первичной является <literal>anonymous-ftp-master</literal>, но возможно, что вы захотите использовать другую <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: While connected to the Internet, you can upload your package as follows:
ru: Соединившись с Интернетом, вы можете отправить свой пакет следующим образом:

note: type: Content of: <book><chapter><section><para>
en: <command>dupload</command> checks that the SHA1/SHA256 file checksums match those listed in the <filename>.changes</filename> file.  If they do not match, it will warn you to rebuild it as described in <xref linkend="completebuild"/> so it can be properly uploaded.
ru: Команда <command>dupload</command> проверяет, что контрольные суммы SHA1/SHA256 ваших файлов совпадают с указанным в файле <filename>.changes</filename>. Если они не совпадают, она предложит пересобрать пакет (о том, как это правильно делать, смотрите раздел <xref linkend="completebuild"/>).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&uploadqueue-readme;"/>.  Alternatively, you can use the <command>dcut</command> command from the <systemitem role="package">dput</systemitem> package.
ru: Смотрите <ulink url="&uploadqueue-readme;"/>. Или же вы можете использовать команду <command>dcut</command> из пакета <systemitem role="package">dput</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: If you encounter an upload problem at <ulink url="&uploadqueue;"/>, you can fix this by manually uploading a GPG-signed <filename>*.commands</filename> file to there with <command>ftp</command>.  <placeholder type="footnote" id="0"/> For example, using <filename>hello.commands</filename>:
ru: Если при отправке в <ulink url="&uploadqueue;"/> возникли проблемы, то вы можете исправить их вручную загрузив туда файл <filename>*.commands</filename>, подписанный GPG, с помощью <command>ftp</command> <placeholder type="footnote" id="0"/>. Например, используя <filename>hello.commands</filename>:

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
ru: Включение файла <filename>orig.tar.gz</filename> для отправки

note: type: Content of: <book><chapter><section><para>
en: When you first upload the package to the archive, you need to include the original <filename>orig.tar.gz</filename> source, too.  If the Debian revision number of this package is neither <literal>1</literal> nor <literal>0</literal>, you must provide the <command>dpkg-buildpackage</command> option <literal>-sa</literal>.
ru: При самой первой отправке пакета в архив, вам также потребуется добавить к нему файл с исходным кодом <filename>orig.tar.gz</filename>. Если номер редакции Debian для данной версии программы не равен <literal>1</literal> или <literal>0</literal>, то вам следует указать команде <command>dpkg-buildpackage</command> параметр <literal>-sa</literal>.

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
ru: Для команды <command>dpkg-buildpackage</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
ru: Для команды <command>debuild</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
ru: Для команды <command>pdebuild</command>:

note: type: Content of: <book><chapter><section><para>
en: On the other hand, the <literal>-sd</literal> option will force the exclusion of the original <filename>orig.tar.gz</filename> source.
ru: Противоположный по действию параметр <literal>-sd</literal> позволит исключить файл с исходным кодом <filename>orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
ru: Пропущенные отправки

note: type: Content of: <book><appendix><title>
en: Advanced packaging
ru: Углублённое пакетирование

note: type: Content of: <book><appendix><para>
en: You may need to manually edit the packaging template files generated by the <command>dh_make</command> command to address topics covered in this chapter.  The newer <command>debmake</command> command should address these topics better.
ru: Вам может потребоваться вручную отредактировать шаблонные файлы пакета, сгенерированные командой <command>dh_make</command>, чтобы подогнать их под темы, затронутые в этой главе. Новая команда <command>debmake</command> больше подходит к этим темам.

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
ru: Общие библиотеки

note: type: Content of: <book><appendix><section><para>
en: Before packaging shared <ulink url="&library;">libraries</ulink>, you should read the following primary references in detail:
ru: Перед пакетированием общих <ulink url="&library;">библиотек</ulink> прочтите следующие основные документы:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-sharedlibraries;">Debian Policy Manual, 8 "Shared libraries"</ulink>
ru: <ulink url="&policy-sharedlibraries;">руководство по политике Debian, раздел 8 «Общие библиотеки»</ulink>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-fhs;">Debian Policy Manual, 9.1.1 "File System Structure"</ulink>
ru: <ulink url="&policy-fhs;">руководство по политике Debian, раздел 9.1.1 «Структура файловой системы</ulink>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-libraries;">Debian Policy Manual, 10.2 "Libraries"</ulink>
ru: <ulink url="&policy-libraries;">руководство по политике Debian, раздел 10.2 «Библиотеки»</ulink>

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
ru: Вот упрощённое представление, для начала:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
ru: Общие библиотеки — это объектные файлы в формате <ulink url="&elf;">ELF</ulink>, в которых содержится скомпилированный код.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are distributed as <filename>*.so</filename> files. (Neither <filename>*.a</filename> files nor <filename>*.la</filename> files)
ru: Общие библиотеки распространяются в виде файлов <filename>*.so</filename> (не в файлах <filename>*.a</filename> или <filename>*.la</filename>).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are mainly used to share common codes among multiple executables with the <command>ld</command> mechanism.
ru: Главным образом, общие библиотеки нужны для совместного использования общего кода в исполняемых файлах посредством механизма <command>ld</command>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are sometimes used to provide multiple plugins to an executable with the <command>dlopen</command> mechanism.
ru: Иногда общие библиотеки используются в качестве подключаемых модулей исполняемых файлов посредством механизма <command>dlopen</command>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>
ru: Либо: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The <ulink url="&soname;">SONAME</ulink> of a shared library <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>
ru: <ulink url="&soname;">SONAME</ulink> общей библиотеки <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of a shared library usually matches the library file name (but not always).
ru: SONAME общей библиотеки обычно совпадает с именем файла библиотеки (но не всегда).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>
ru: Либо: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of shared libraries linked to <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>
ru: SONAME общих библиотек, которые скомпонованы с <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.
ru: Смотрите <ulink url="&policy-runtime;">руководство по политике Debian, раздел 8.1 «Общие библиотеки времени выполнения»</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: the library package for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> with the SONAME ABI version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>
ru: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: библиотечный пакет общей библиотеки <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> с ABI-версией SONAME, равной <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink>.
ru: Смотрите <ulink url="&policy-ldconfig;">руководство по политике Debian, раздел 8.1.1 «ldconfig»</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The package maintainer scripts of the library package must call <command>ldconfig</command> under the specific circumstances to create the necessary symbolic links for the SONAME.<placeholder type="footnote" id="0"/>
ru: Пакетные сценарии сопровождающего для библиотеки должны вызывать <command>ldconfig</command> для создания необходимых символьных ссылок для SONAME при определённых условиях.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> and <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.
ru: Смотрите <ulink url="&policy-static;">руководство по политике Debian, раздел 8.3 «Статические библиотеки»</ulink> и <ulink url="&policy-dev;">руководство по политике Debian, раздел 8.4 «Файлы для разработки»</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.
ru: Смотрите <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.
ru: Смотрите <ulink url="&rpathissues;">вики Debian RpathIssue</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Although it is somewhat outdated and is only a secondary reference, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> may still be useful.
ru: Несмотря на некоторое устаревание и статус вторичности, следующая ссылка тоже может быть полезна <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink>.

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
ru: Управление <filename>debian/<replaceable>пакет</replaceable>.symbols</filename>

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Backward-incompatible ABI changes normally require you to update the SONAME of the library and the shared library package name to new ones.
ru: При обратно несовместимых изменениях ABI обычно требуется обновить SONAME библиотеки и поменять имя пакета общей библиотеки на новое.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: For C++ libraries and other cases where tracking individual symbols is too difficult, follow <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>, instead.
ru: Вместо указанного для библиотек C++ и в других случаях, где слежение за отдельными символами слишком сложно, прочтите <ulink url="&policy-library-shlibs;">руководство по политике Debian, раздел 8.6.4 «Система shlibs»</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-library-symbols;">Debian Policy Manual, 8.6.3 "The symbols system"</ulink><placeholder type="footnote" id="0"/>
ru: Смотрите <ulink url="&policy-library-symbols;">руководство по политике Debian, раздел 8.6.3 «Система символов»</ulink><placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Prepare the skeleton debianized source tree using the upstream <filename>libfoo-1.3.tar.gz</filename> file.
ru: Подготовьте основу исходного дерева из авторского файла <filename>libfoo-1.3.tar.gz</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If this is the first packaging of the <systemitem role="package">libfoo1</systemitem> package, create the <filename>debian/libfoo1.symbols</filename> file with empty content.
ru: Если пакетирование <systemitem role="package">libfoo1</systemitem> производится впервые, создайте пустой файл <filename>debian/libfoo1.symbols</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was packaged as the <systemitem role="package">libfoo1</systemitem> package with the proper <filename>debian/libfoo1.symbols</filename> in its source package, use it again.
ru: Если была упакована предыдущая авторская версия <literal>1.2</literal> в пакет <systemitem role="package">libfoo1</systemitem> с соответствующим файлом <filename>debian/libfoo1.symbols</filename> в пакете с исходным кодом, то используйте его и сейчас.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: All previous versions of Debian packages are available at <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>.  The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>
ru: Все предыдущие версии пакетов Debian доступны по <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>. Для облегчения переноса пакета в старые выпуски часть, отвечающая за версию Debian, отбрасывается: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> и <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>
ru: Для облегчения переноса пакета в старые выпуски часть, отвечающая за версию Debian, отбрасывается: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build release packages with tools such as <command>debuild</command> and <command>pdebuild</command>.
ru: Соберите выпускаемые пакеты с помощью таких инструментов как <command>debuild</command> и <command>pdebuild</command>.

note: type: Content of: <book><appendix><section><para><footnote><para>
en: See <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.
ru: Смотрите <ulink url="&policy-library-abi;">руководство по политике Debian, раздел 8.6.2 «Изменения ABI общей библиотеки»</ulink>.

note: type: Content of: <book><appendix><section><para>
en: In addition to the above examples, we need to check the ABI compatibility further and bump versions for some symbols manually as needed.  <placeholder type="footnote" id="0"/>
ru: В дополнение к вышеупомянутым примерам мы должны проверить дальнейшую совместимость ABI и, если понадобится, увеличить версии некоторых символов вручную. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Although it is only a secondary reference, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> and its linked web pages may be useful.
ru: Несмотря на статус вторичности, <ulink url="&usingsymbolsfiles;">вики Debian UsingSymbolsFiles</ulink> и содержащиеся на ней ссылки могут быть полезными.

note: type: Content of: <book><appendix><section><title>
en: Multiarch
ru: Мультиархитектурность

note: type: Content of: <book><appendix><section><para>
en: The multiarch feature introduced to Debian wheezy integrates support for cross-architecture installation of binary packages (particularly <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, but also other combinations) in <systemitem role="package">dpkg</systemitem> and <systemitem role="package">apt</systemitem>. You should read the following references in detail:
ru: Свойство мультиархитектурности, появившееся в Debian wheezy, встраивает поддержку кросс-платформенной установки двоичных пакетов (а именно <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, но есть и другие комбинации) в <systemitem role="package">dpkg</systemitem> и <systemitem role="package">apt</systemitem>. Подробная информация приведена в следующих документах:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (upstream)
ru: <ulink url="&multiarchspec;">вики Ubuntu MultiarchSpec</ulink> (авторский документ)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian situation)
ru: <ulink url="&multiarchimplementation;">вики Debian Multiarch/Implementation</ulink> (ситуация в Debian)

note: type: Content of: <book><appendix><section><para>
en: It uses the triplet such as <literal>i386-linux-gnu</literal> and <literal>x86_64-linux-gnu</literal> for the install path of shared libraries. The actual triplet path is dynamically set into the <literal>$(DEB_HOST_MULTIARCH)</literal> variable using the <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle><manvolnum>1</manvolnum></citerefentry> command for each binary package build. For example, the path to install multiarch libraries are changed as follows:<placeholder type="footnote" id="0"/>
ru: При установке общих библиотек в путях используются триплеты, например <literal>i386-linux-gnu</literal> и <literal>x86_64-linux-gnu</literal>. Актуальный триплет динамически задаётся в переменной <literal>$(DEB_HOST_MULTIARCH)</literal> с помощью <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> при каждой сборке. Например, путь установки мультиархитектурных библиотек изменяется следующим образом:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
ru: Старый путь

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
ru: мультиархитектурный путь для i386

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
ru: мультиархитектурный путь для amd64

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
ru: библиотека с исходным кодом <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>bar</replaceable>-1.tar.gz</filename> written in a compiled language
ru: инструмент с исходным кодом <filename><replaceable>bar</replaceable>-1.tar.gz</filename>, написанный на компилируемом языке

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>baz</replaceable>-1.tar.gz</filename> written in an interpreted language
ru: инструмент с исходным кодом <filename><replaceable>baz</replaceable>-1.tar.gz</filename>, написанный на интерпретируемом языке

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package
ru: Пакет

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Architecture:
ru: Архитектура:

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Multi-Arch:
ru: Мультиархитектурность:

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
ru: Содержимое пакета

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: any
ru: любая

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: same
ru: такая же

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
ru: общая библиотека, одновременная установка

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library debug symbols, co-installable
ru: отладочные символы общей библиотеки, одновременная установка

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
ru: заголовочные файлы общей библиотеки, одновременная установка

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: foreign
ru: сторонняя

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
ru: программы поддержки времени выполнения, не одновременная установка

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: all
ru: все

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
ru: файлы документации общей библиотеки

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
ru: скомпилированные файлы программы, одновременная установка

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
ru: файлы документации программы

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
ru: интерпретируемые файлы программы

note: type: Content of: <book><appendix><section><para>
en: Please note that the development package should contain a symlink for the associated shared library <emphasis role="strong">without a version number</emphasis>.  E.g.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>
ru: Заметим, что пакет для разработчика должен содержать символьную ссылку на соответствующую общую библиотеку <emphasis role="strong">без номера версии</emphasis>. Пример: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
ru: Сборка пакета с общей библиотекой

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
ru: Обновите <filename>debian/control</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Pre-Depends: ${misc:Pre-Depends}</literal> for each shared library binary package.
ru: Добавьте <literal>Pre-Depends: ${misc:Pre-Depends}</literal> для каждого двоичного пакета с общей библиотекой.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
ru: Добавьте строку <literal>Multi-Arch:</literal> в раздел каждого двоичного пакета.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Adjust the path from the normal <literal>/usr/lib/</literal> to the multiarch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> for all packaging scripts.
ru: Измените путь с обычного <literal>/usr/lib/</literal> на мультиархитектурный <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> во всех сценариях пакета.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace <literal>/usr/lib/</literal> with <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> in <filename>debian/rules</filename>.
ru: Замените <literal>/usr/lib/</literal> на <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> в <filename>debian/rules</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: Alternatively, you can add <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> and <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> arguments to <literal>./configure</literal>.  Please note that <literal>--libexecdir</literal> specifies the default path to install executable programs run by other programs rather than by users.  Its Autotools default is <filename>/usr/libexec/</filename> but its Debian default is <filename>/usr/lib/</filename>.
ru: Или же вы можете добавить параметры <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> и <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> в <literal>./configure</literal>. Заметим, что в <literal>--libexecdir</literal> задаётся путь по умолчанию для установки исполняемых программ, запускаемых другими программами, а не пользователями. Значение Autotools по умолчанию равно <filename>/usr/libexec/</filename>, но значение Debian по умолчанию равно <filename>/usr/lib/</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace all occurrences of <literal>/usr/lib/</literal> with <literal>/usr/lib/*/</literal> in <filename>debian/<replaceable>foo</replaceable>.install</filename> files.
ru: Замените все появления <literal>/usr/lib/</literal> на <literal>/usr/lib/*/</literal> в файлах <filename>debian/<replaceable>foo</replaceable>.install</filename>.

note: type: Content of: <book><appendix><section><para>
en: Please make sure to verify that the shared library package contains only the expected files, and that your -dev package still works.
ru: Проверьте, что пакет с общей библиотекой содержит только ожидаемые файлы и что ваши пакеты -dev ещё работают.

note: type: Content of: <book><appendix><section><title>
en: Native Debian package
ru: Родной пакет Debian

note: type: Content of: <book><appendix><section><para>
en: If a package is maintained only for Debian or possibly only for local use, its source may contain all the <filename>debian/*</filename> files in it.  There are 2 ways to package it.
ru: Если пакет сопровождается только для Debian или, возможно, предназначен только для локального использования, то файлы <filename>debian/*</filename> можно хранить прямо его в исходном коде. Есть два способа его пакетирования.

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
ru: Альтернативный способ сборки родного пакета Debian:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Create a native Debian source package in the <literal>3.0 (native)</literal> format using a single compressed tar file in which all files are included.
ru: создание родного пакета Debian с исходным кодом в формате <literal>3.0 (native)</literal>, состоящем из одного сжатого файла tar, в который включены все файлы

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.tar.gz
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>.tar.gz

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.dsc
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>.dsc

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
ru: сборка двоичных пакетов Debian из родного пакета Debian с исходным кодом

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb
ru: <replaceable>пакет</replaceable>_<replaceable>версия</replaceable>_<replaceable>архитектура</replaceable>.deb

note: type: Content of: <book><appendix><section><para>
en: After execution of the <command>dpkg-buildpackage</command> command, you will see the following files in the parent directory:
ru: После выполнения команды <command>dpkg-buildpackage</command>, вы увидите следующие файлы в родительском каталоге:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is the source code tarball created from the <filename>mypackage-1.0</filename> directory by the <command>dpkg-source</command> command.  (Its suffix is not <filename>orig.tar.gz</filename>.)
ru: Это сжатый архив tar с исходным кодом, созданный из каталога <filename>mypackage-1.0</filename> командой <command>dpkg-source</command> (его суффикс не <filename>orig.tar.gz</filename>).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package version as in the non-native Debian package. (There is no Debian revision.)
ru: Содержит описание всех изменений, сделанных в текущей версии пакета, такой же как для неродного пакета Debian (в имени нет редакции Debian).
