msgid ""
msgstr ""
"Project-Id-Version: \n"
"POT-Creation-Date: 2015-06-08 23:08+0900\n"
"PO-Revision-Date: 2015-05-05 18:17+0900\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 1.6.10\n"

#. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
msgctxt "_"
msgid "translator-credits"
msgstr ""

#. (itstool) path: bookinfo/title
#: debmake-doc.en.xml:14
msgid "Guide for Debian Maintainers"
msgstr "Debian Maintainer向け案内書"

#. (itstool) path: bookinfo/author
#: debmake-doc.en.xml:15
msgid "<personname> Osamu Aoki</personname>"
msgstr "<personname> 青木 修 </personname>"

#. (itstool) path: bookinfo/date
#: debmake-doc.en.xml:18
msgid "2015-05-25"
msgstr "2015-05-25"

#. (itstool) path: abstract/simpara
#: debmake-doc.en.xml:20
msgid ""
"This tutorial document describes the building of the Debian package to "
"ordinary Debian users and prospective developers using the <emphasis role="
"\"strong\">debmake</emphasis> command."
msgstr ""

#. (itstool) path: abstract/simpara
#: debmake-doc.en.xml:24
msgid ""
"It is focused on the modern packaging style and comes with many simple "
"examples."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:28
msgid "POSIX shell script packaging"
msgstr "POSIX シェルスクリプトのパッケージング"

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:33
msgid "Python3 script packaging"
msgstr "Python3 スクリプトのパッケージング"

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:38
msgid "C with Makefile/Autotools/CMake"
msgstr "Makefile/Autotools/CMake を使う C"

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:43
msgid "multiple binary package with shared library etc."
msgstr "共有ライブラリー等を含む複数バイナリーパッケージ"

#. (itstool) path: abstract/simpara
#: debmake-doc.en.xml:49
msgid ""
"This “Guide for Debian Maintainers” can be considered as the successor to "
"the “Debian New Maintainers’ Guide”."
msgstr ""

#. (itstool) path: bookinfo/copyright
#: debmake-doc.en.xml:51
msgid "<year>2014-2015</year> <holder>Osamu Aoki</holder>"
msgstr ""

#. (itstool) path: legalnotice/simpara
#: debmake-doc.en.xml:57
msgid ""
"Permission is hereby granted, free of charge, to any person obtaining a copy "
"of this software and associated documentation files (the \"Software\"), to "
"deal in the Software without restriction, including without limitation the "
"rights to use, copy, modify, merge, publish, distribute, sublicense, and/or "
"sell copies of the Software, and to permit persons to whom the Software is "
"furnished to do so, subject to the following conditions:"
msgstr ""

#. (itstool) path: legalnotice/simpara
#: debmake-doc.en.xml:63
msgid ""
"The above copyright notice and this permission notice shall be included in "
"all copies or substantial portions of the Software."
msgstr ""

#. (itstool) path: legalnotice/simpara
#: debmake-doc.en.xml:65
msgid ""
"THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR "
"IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, "
"FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE "
"AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER "
"LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING "
"FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS "
"IN THE SOFTWARE."
msgstr ""

#. (itstool) path: legalnotice/simpara
#: debmake-doc.en.xml:72
msgid ""
"This guide was made using the following previous documents as its reference:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:75
msgid ""
"“Making a Debian Package (AKA the Debmake Manual)”, copyright © 1997 Jaldhar "
"Vyas."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:80
msgid ""
"“The New-Maintainer’s Debian Packaging Howto”, copyright © 1997 Will Lowe."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:85
msgid ""
"“Debian New Maintainers’ Guide”, copyright © 1998-2002 Josip Rodin, "
"2005-2014 Osamu Aoki, 2010 Craig Small, and 2010 Raphaël Hertzog."
msgstr ""

#. (itstool) path: legalnotice/simpara
#: debmake-doc.en.xml:90
msgid ""
"Newer versions of this guide should always be available in the <emphasis "
"role=\"strong\">debmake-doc</emphasis> package."
msgstr ""

#. (itstool) path: imageobject/imagedata
#. This is a reference to an external file such as an image or video. When
#. the file changes, the md5 hash will change to let you know you need to
#. update your localized copy. The msgstr is not used at all. Set it to
#. whatever you like once you have updated your copy of the file.
#: debmake-doc.en.xml:95
msgctxt "_"
msgid "external ref='debian-openlogo.png' md5='__failed__'"
msgstr ""

#. (itstool) path: preface/title
#: debmake-doc.en.xml:102
msgid "Preface"
msgstr "序文"

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:103
msgid "Debian Reference"
msgstr "Debian レファレンス"

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:103
msgid ""
"You do need to know a little about Unix programming but you certainly don’t "
"need to be a wizard. You can learn about the basic handling of a Debian "
"system from the <_:ulink-1/>. It contains some pointers to learn about Unix "
"programming, too."
msgstr ""
"Unix プログラミングに関して少々の知識は必要ですが、熟練者である事は決してあり"
"ません。Debian システムの基本操作は <_:ulink-1/> から学べます。Unix プログラ"
"ミングに関して学習するヒントを含んでいます。"

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:103
msgid ""
"If you are a somewhat experienced Debian user <_:footnote-1/>, you may have "
"encountered following situations:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:106
msgid ""
"You wish to install a certain software package not yet found in the Debian "
"archive."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:111
msgid "You wish to update a Debian package with the newer upstream release."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:116
msgid "You wish to fix bugs of a Debian package with some patches."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:121
msgid ""
"If you are not interested in sharing the Debian package, you can certainly "
"work around your local situation by compiling and installing the fixed "
"upstream source package into <emphasis role=\"strong\">/usr/local/</"
"emphasis>."
msgstr ""

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:121
msgid ""
"If you wanted to create a Debian package to fulfill these wishes and to "
"share your work with the community, you are the target audience of this "
"guide as a prospective Debian maintainer. <_:footnote-1/> Welcome to the "
"Debian community."
msgstr ""

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:122
msgid ""
"Debian has many social and technical rules and conventions to follow since "
"it is a large volunteer organization with history. Debian also has developed "
"huge array of packaging tools and archive maintenance tools to build "
"consistent set of binary packages addressing many technical objectives:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:125
msgid "clean build under clearly specified package dependencies and patches"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:130
msgid "packages build across many architectures"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:135
msgid "optimal splits into multiple binary packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:140
msgid "smooth library transitions"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:145
msgid "security enhancement using specific compiler flags"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:150
msgid "multiarch support"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:155 debmake-doc.en.xml:3534
msgid "…"
msgstr ""

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:160
msgid ""
"These make it somewhat overwhelming for many new prospective Debian "
"maintainers to get involved with Debian. This guide tries to provide entry "
"points for them to get started. It describes as follows:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:163
msgid ""
"What you should know before getting involved with Debian as a prospective "
"maintainer."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:168
msgid "What it looks like to make a simple Debian package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:173
msgid "What kind of rules exist for making the Debian package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:178
msgid "Tips for making the Debian package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:183
msgid "Examples of making Debian packages for several typical scenarios."
msgstr ""

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:188
msgid ""
"The author felt limitations of updating the original “New Maintainers' "
"Guide” with the <emphasis role=\"strong\">dh-make</emphasis> package and "
"decided to create an alternative tool and its matching document to address "
"modern requirements. The result is the <emphasis role=\"strong\">debmake</"
"emphasis> (version: 4.2.1) package and this updated “Guide for Debian "
"Maintainers” in the <emphasis role=\"strong\">debmake-doc</emphasis> "
"(version: 1.0-1) package."
msgstr ""

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:189
msgid ""
"Many chores and tips have been integrated into the <emphasis role=\"strong"
"\">debmake</emphasis> command making this guide simple. This guide also "
"offers many packaging examples."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:190
msgid ""
"It takes many hours to properly create and maintain Debian packages. The "
"Debian maintainer must be <emphasis role=\"strong\">both technically "
"competent and diligent</emphasis> to take up this challenge."
msgstr ""

#. (itstool) path: preface/simpara
#: debmake-doc.en.xml:191
msgid ""
"Some important topics are explained in detail. Some of them may look "
"irrelevant to you. Please be patient. Some corner cases are skipped. Some "
"topics are only covered by the external pointers. These are intentional "
"choices to keep this guide simple and maintainable."
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:194
msgid "Overview"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:195 debmake-doc.en.xml:1193
msgid "GNU Coding Standards"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:195 debmake-doc.en.xml:1193
msgid "FHS"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:195
msgid ""
"The Debian packaging of the <emphasis>package-1.0</emphasis><emphasis role="
"\"strong\">.tar.gz</emphasis>, containing a simple C source following the <_:"
"ulink-1/> and <_:ulink-2/>, can be done with the <emphasis role=\"strong"
"\">debmake</emphasis> command as follows."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:201
msgid ""
"If manual adjustments of generated configuration files are skipped, the "
"generated binary package lacks meaningful package description but still "
"functions well under the <emphasis role=\"strong\">dpkg</emphasis> command "
"to be used for your local deployment."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:202
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command only provides good "
"template files. These template files must be manually adjusted to their "
"perfection to comply with the strict quality requirements of the Debian "
"archive, if the generated package is intended for the general consumption."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:203
msgid ""
"If you are new to the Debian packaging, do not worry about the details and "
"just get the big picture instead."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:204
msgid ""
"The <emphasis role=\"strong\">deb-make</emphasis> command was popular before "
"the <emphasis role=\"strong\">dh_make</emphasis> command. The current "
"<emphasis role=\"strong\">debmake</emphasis> package starts its version from "
"<emphasis role=\"strong\">4.0</emphasis> to avoid version overlaps with "
"obsolete <emphasis role=\"strong\">debmake</emphasis> package which provided "
"the <emphasis role=\"strong\">deb-make</emphasis> command."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:204
msgid ""
"If you have been exposed to the Debian packaging, this looks very much like "
"the <emphasis role=\"strong\">dh_make</emphasis> command. This is because "
"the <emphasis role=\"strong\">debmake</emphasis> command is intended to "
"replace functions offered historically by the <emphasis role=\"strong"
"\">dh_make</emphasis> command. <_:footnote-1/>"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:205
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command is designed with "
"following features:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:208
msgid "modern packaging style"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:213
msgid ""
"<emphasis role=\"strong\">debian/copyright</emphasis>: <emphasis role="
"\"strong\">DEP-5</emphasis> complient"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:218
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis>: <emphasis role=\"strong"
"\">substvar</emphasis> support, <emphasis role=\"strong\">multiarch</"
"emphasis> support, multi binary packages, …"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:223
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis>: <emphasis role=\"strong"
"\">dh</emphasis> syntax, compiler hardening options, …"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:230
msgid "flexibility"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:235
msgid ""
"many options (<xref linkend=\"boption\"/>, <xref linkend=\"options\"/>, "
"<xref linkend=\"manpage\"/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:242
msgid "sane default actions"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:247
msgid "execute non-stop with clean results"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:252
msgid ""
"generate the multiarch package, unless <emphasis role=\"strong\">-m</"
"emphasis> option is explicitly specified."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:257
msgid ""
"generate the non-native Debian package with the “<emphasis role=\"strong"
"\">3.0 (quilt)</emphasis>” format, unless <emphasis role=\"strong\">-n</"
"emphasis> option is explicitly specified."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:264
msgid "extra utility"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:269
msgid ""
"verification of the <emphasis role=\"strong\">debian/copyright</emphasis> "
"file against the current source (<xref linkend=\"koption\"/>)"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:276
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command delegates most of "
"the heavy lifting to its back-end packages: <emphasis role=\"strong"
"\">debhelper</emphasis>, <emphasis role=\"strong\">dpkg-dev</emphasis>, "
"<emphasis role=\"strong\">devscripts</emphasis>, <emphasis role=\"strong"
"\">pbuilder</emphasis>, etc."
msgstr ""

#. (itstool) path: tip/simpara
#. (itstool) path: section/simpara
#: debmake-doc.en.xml:277 debmake-doc.en.xml:8025
msgid ""
"Make sure to protect the arguments of the <emphasis role=\"strong\">-b</"
"emphasis>, <emphasis role=\"strong\">-f</emphasis>, <emphasis role=\"strong"
"\">-l</emphasis>, and <emphasis role=\"strong\">-w</emphasis> options from "
"the shell interference by quoting them properly."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:278
msgid "The non-native Debian package is the normal Debian package."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:279
msgid ""
"The generation of the <emphasis role=\"strong\">debian/copyright</emphasis> "
"file, and the outputs from the <emphasis role=\"strong\">-c</emphasis> "
"(<xref linkend=\"coption\"/>) and <emphasis role=\"strong\">-k</emphasis> "
"(<xref linkend=\"koption\"/>) options involve heuristic operations on the "
"copyright and license information. They may produce some erroneous results."
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:282
msgid "Prerequisites"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:283
msgid ""
"Here are the prerequisites which you need to understand before you to get "
"involved with Debian."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:285
msgid "People around Debian"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:286
msgid ""
"There are several types of people interacting around Debian with different "
"roles:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:289
msgid ""
"<emphasis role=\"strong\">upstream author</emphasis>: the person who made "
"the original program."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:294
msgid ""
"<emphasis role=\"strong\">upstream maintainer</emphasis>: the person who "
"currently maintains the program."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:299
msgid ""
"<emphasis role=\"strong\">maintainer</emphasis>: the person making the "
"Debian package of the program."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:304
msgid ""
"<emphasis role=\"strong\">sponsor</emphasis>: a person who helps maintainers "
"to upload packages to the official Debian package archive (after checking "
"their contents)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:309
msgid ""
"<emphasis role=\"strong\">mentor</emphasis>: a person who helps novice "
"maintainers with packaging etc."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:314
msgid ""
"<emphasis role=\"strong\">Debian Developer</emphasis> (DD): a member of the "
"Debian project with full upload rights to the official Debian package "
"archive."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:319
msgid ""
"<emphasis role=\"strong\">Debian Maintainer</emphasis> (DM): a person with "
"limited upload rights to the official Debian package archive."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:324
msgid ""
"Please note that you can’t 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>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:325
msgid ""
"Please note that you do not need to create any new packages 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=\"approaches\"/>)."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:328
msgid "How to contribute"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:329
msgid "Please refer to the following to learn how to contribute to Debian:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:333
msgid "How can you help Debian?"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:332 debmake-doc.en.xml:347
msgid "<_:ulink-1/> (official)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:338
msgid ""
"The Debian GNU/Linux FAQ, Chapter 13 - \"Contributing to the Debian Project\""
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:337
msgid "<_:ulink-1/> (semi-official)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:343
msgid "Debian Wiki, HelpDebian"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:342 debmake-doc.en.xml:352
msgid "<_:ulink-1/> (supplemental)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:348
msgid "Debian New Member site"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:353
msgid "Debian Mentors FAQ"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:359
msgid "Social dynamics of Debian"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:360
msgid ""
"Please understand Debian’s social dynamics to prepare yourself for "
"interactions with Debian:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:363
msgid "We all are volunteers."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:368
msgid "You can’t impose on others what to do."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:373
msgid "You should be motivated to do things by yourself."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:380
msgid "Friendly cooperation is the driving force."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:385
msgid "Your contribution should not over-strain others."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:390
msgid "Your contribution is valuable only when others appreciate it."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:397
msgid ""
"Debian is not your school where you get automatic attention of teachers."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:402
msgid "You should be able to learn many things by yourself."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:407
msgid "Attention from other volunteers is a very scarce resource."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:414
msgid "Debian is constantly improving."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:419
msgid "You are expected to make high quality packages."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:424
msgid "You should adapt yourself to the change."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:431
msgid ""
"Since we focus only on the technical aspects of the packaging in the rest of "
"this guide, please refer to the following to understand the social dynamics "
"of Debian:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:435
msgid "Debian: 17 years of Free Software, “do-ocracy”, and democracy"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:434
msgid "<_:ulink-1/> (Introductory slides by the ex-DPL)"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:441
msgid "Technical reminders"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:442
msgid ""
"Here are some technical reminders to accommodate other maintainers to work "
"on your package easily and effectively to maximize the output of Debian as a "
"whole."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:445
msgid "Make your package easy to debug."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:450
msgid "Keep your package simple."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:455
msgid "Don’t over-engineer your package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:462
msgid "Keep your package well-documented."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:467
msgid "Use readable code style."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:472
msgid "Make comments in code."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:477
msgid "Format code consistently."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:483
msgid ""
"The overwhelming number of Debian maintainers use <emphasis role=\"strong"
"\">git</emphasis> over other VCS systems such as <emphasis role=\"strong"
"\">hg</emphasis>, <emphasis role=\"strong\">bzr</emphasis>, etc."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:482
msgid "Maintain the git repository <_:footnote-1/> of the package."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:489
msgid ""
"Debugging of software tends to consume more time than writing the initial "
"working software."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:492
msgid "Debian documentation"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:493
msgid ""
"Please make yourself ready to read the pertinent part of the official Debian "
"documentation together with this guide as needed to generate perfect Debian "
"packages:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:496
msgid "“Debian Policy Manual”"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:502
msgid "http://www.debian.org/doc/devel-manuals#policy"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:501
msgid "“must follow” rules (<_:ulink-1/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:508
msgid "“Debian Developer’s Reference”"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:514
msgid "http://www.debian.org/doc/devel-manuals#devref"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:513
msgid "“best practice” document (<_:ulink-1/>)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:520
msgid ""
"If this guide contradicts with the official Debian documentation, they are "
"correct. Please file a bug report on the <emphasis role=\"strong\">debmake-"
"doc</emphasis> package using the <emphasis role=\"strong\">reportbug</"
"emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:521
msgid ""
"Here are alternative tutorial documents which you may read along with this "
"guide:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:524
#, fuzzy
msgid "“Debian New Maintainers' Guide” (older)"
msgstr "Debian メンテナーガイド (debmake使用版)"

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:530
msgid "https://www.debian.org/doc/devel-manuals#maint-guide"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:535
msgid "https://packages.qa.debian.org/m/maint-guide.html"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:541
msgid "“Debian Packaging Tutorial”"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:547
msgid "https://www.debian.org/doc/devel-manuals#packaging-tutorial"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:552
msgid "https://packages.qa.debian.org/p/packaging-tutorial.html"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:558
msgid "“Ubuntu Packaging Guide” (Ubuntu is Debian based.)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:564
msgid "http://packaging.ubuntu.com/html/"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:570
msgid ""
"When reading these tutorials, you should consider to use the <emphasis role="
"\"strong\">debmake</emphasis> command in place of the <emphasis role=\"strong"
"\">dh_make</emphasis> command for better template files."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:573
msgid "Help resources"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:574
msgid ""
"Before you decide to ask your question in some public place, please do your "
"parts of efforts, i.e., read the fine documentation:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:577
msgid ""
"package information available through the <emphasis role=\"strong"
"\">aptitude</emphasis>, <emphasis role=\"strong\">apt-cache</emphasis>, and "
"<emphasis role=\"strong\">dpkg</emphasis> commands."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:582
msgid ""
"files in <emphasis role=\"strong\">/usr/share/doc/</"
"emphasis><emphasis>package</emphasis> for all pertinent packages."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:587
msgid ""
"contents of <emphasis role=\"strong\">man</emphasis> <emphasis>command</"
"emphasis> for all pertinent commands."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:592
msgid ""
"contents of <emphasis role=\"strong\">info</emphasis> <emphasis>command</"
"emphasis> for all pertinent commands."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:598
msgid "debian-mentors@lists.debian.org mailing list archive"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:597 debmake-doc.en.xml:602
msgid "contents of <_:ulink-1/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:603
msgid "debian-devel@lists.debian.org mailing list archive"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:607
msgid ""
"Your desired information can be found effectively by using the well-formend "
"search string such as “keyword <emphasis role=\"strong\">site:lists.debian."
"org</emphasis>” to limit the search domain of the web search engine."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:608
msgid ""
"Making a small test package is a good way to learn details of the packaging. "
"Inspecting existing well maintained packages is the best way to learn how "
"other people make packages."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:609
msgid ""
"If you still have questions about the packaging, you can ask them "
"interactively:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:613
msgid "debian-mentors@lists.debian.org"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:612
msgid "<_:ulink-1/> mailing list. (This mailing list is for the novice.)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:618
msgid "debian-devel@lists.debian.org"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:617
msgid "<_:ulink-1/> mailing list. (This mailing list is for the expert.)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:623
msgid "IRC"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:622
msgid "<_:ulink-1/> such as #debian-mentors."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:628
msgid "https://wiki.debian.org/Teams"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:627
msgid ""
"Teams focusing on a specific set of packages. (Full list at <_:ulink-1/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:632
msgid "Language-specific mailing lists."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:638
msgid "debian-devel-{french,italian,portuguese,spanish}@lists.debian.org"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:643
msgid "debian-devel@debian.or.jp"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:649
msgid ""
"The more experienced Debian developers will gladly help you, if you ask "
"properly after making your required efforts."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:650
msgid ""
"Debian development is a moving target. Some information found on the web may "
"be outdated, incorrect, and not-applicable. Please use them carefully."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:653
msgid "Archive situation"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:654
msgid "Please realize the situation of the Debian archive."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:657
msgid "Debian already has packages for most kinds of programs."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:662
msgid ""
"The number of packages already in the Debian archive is several tens of "
"times greater than that of active maintainers."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:667
msgid ""
"Unfortunately, some packages lack appropriate level of attention by the "
"maintainer."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:672
msgid ""
"Thus, contributions to packages already in the archive are far more "
"appreciated (and more likely to receive sponsorship for the uploading) by "
"other maintainers."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:673
msgid ""
"The <emphasis role=\"strong\">wnpp-alert</emphasis> command from the "
"<emphasis role=\"strong\">devscripts</emphasis> package can check for "
"installed packages up for adoption or orphaned."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:676
msgid "Contribution approaches"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:677
msgid ""
"Here is a pseudo-Python code for your contribution approaches to Debian with "
"a <emphasis role=\"strong\">program</emphasis>:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:713
msgid "Here:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:716
msgid "For exist_in_debian(), and is_team_maintained(); check:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:721
msgid "the <emphasis role=\"strong\">aptitude</emphasis> command"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:727
msgid "Debian packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:726
msgid "<_:ulink-1/> web page"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:732
msgid "Teams"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:738
msgid "For is_orphaned(), is_RFA(), and is_ITPed_by_others(); check:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:743
msgid ""
"The output of the <emphasis role=\"strong\">wnpp-alert</emphasis> command."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:749
msgid "Work-Needing and Prospective Packages"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:754
msgid "Debian Bug report logs: Bugs in pseudo-package wnpp in unstable"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:759
msgid "Debian Packages that Need Lovin'"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:764
msgid "Browse wnpp bugs based on debtags"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:770
msgid "For is_good_program(), check:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:775
msgid "The program should be useful."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:780
msgid ""
"The program should not introduce security and maintenance concerns to the "
"Debian system."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:785
msgid ""
"The program should be well documented and its code needs to be "
"understandable (i.e. not obfuscated)."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:791
msgid ""
"This is not the absolute requirement. The hostile upstream may become major "
"resource drains for us all. The friendly upstream can be consulted to solve "
"any problems with the program."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:790
msgid ""
"The program’s authors agree with the packaging and are amicable to Debian. "
"<_:footnote-1/>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:797
msgid "For is_it_DFSG(), and is_its_dependency_DFSG(); check:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:803
msgid "Debian Free Software Guidelines"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:802
msgid "<_:ulink-1/> (DFSG)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:809
msgid "For is_it_distributable(), check:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:814
msgid "The software must have a license and it should allow its distribution."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:821
msgid ""
"You either need to file an ITP or adopt a package to start working on it. "
"See the “Debian Developer’s Reference”:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:825
msgid "5.1. New packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:824 debmake-doc.en.xml:829
msgid "<_:ulink-1/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:830
msgid ""
"5.9. Moving, removing, renaming, orphaning, adopting, and reintroducing "
"packages"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:836
msgid "Novice maintainer"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:837
msgid ""
"The novice maintainer should avoid packaging programs with the high security "
"exposure:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:840
msgid ""
"<emphasis role=\"strong\">setuid</emphasis> or <emphasis role=\"strong"
"\">setgid</emphasis> program"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:845
msgid "<emphasis role=\"strong\">daemon</emphasis> program"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:850
msgid ""
"program installed in the <emphasis role=\"strong\">/sbin/</emphasis> or "
"<emphasis role=\"strong\">/usr/sbin/</emphasis> directories"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:855
msgid ""
"When you gain more experience in packaging, you’ll be able to package such "
"programs."
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:859
msgid "Tool Setups"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:860
msgid ""
"The <emphasis role=\"strong\">build-essential</emphasis> package must be "
"installed in the build environment."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:861
msgid ""
"The <emphasis role=\"strong\">devscripts</emphasis> package should be "
"installed on the maintainer environment."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:862
msgid ""
"Although this is not necessary the absolute requirement, it is a good idea "
"to install and setup all of the popular set of packages mentioned in this "
"chapter on the maintainer environment. This enables us to share the common "
"baseline working environment."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:863
#, fuzzy
msgid "Overview of Debian Maintainer Tools"
msgstr "Debian Maintainer向け案内書"

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:863
msgid ""
"Please install the tools mentioned in the <_:ulink-1/> of the “Debian "
"Developer’s Reference”, as needed, too."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:864
msgid ""
"The cut-and-paste from the PDF format does not function well for U+0022 "
"QUOTATION MARK (ASCII double quote), U+0027 APOSTROPHE (ASCII single quote), "
"and U+0060 GRAVE ACCENT (ASCII back tick) since they are converted by the "
"LaTeX to U+201D RIGHT DOUBLE QUOTATION MARK, U+2019 RIGHT SINGLE QUOTATION "
"MARK, and U+2018 LEFT SINGLE QUOTATION MARK."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:864
msgid ""
"For the cut-and-paste from the code listing part, use this document in the "
"HTML format. <_:footnote-1/>"
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:865
msgid ""
"Tool setups presented here are only meant as an example and may not be up-to-"
"date with the latest packages on the system. Debian development is a moving "
"target. Please make sure to read the pertinent documentation and update the "
"configuration as needed."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:867
msgid "Email address"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:868
msgid ""
"Various Debian maintenance tools recognize your email address and name to "
"use by the shell environment variables <emphasis role=\"strong\">$DEBEMAIL</"
"emphasis> and <emphasis role=\"strong\">$DEBFULLNAME</emphasis>."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:869
msgid ""
"This 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 <emphasis role=\"strong\">~/.bashrc</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:869
msgid ""
"Let’s setup these packages by adding the following lines to <emphasis role="
"\"strong\">~/.bashrc</emphasis> <_:footnote-1/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:870 debmake-doc.en.xml:879 debmake-doc.en.xml:902
msgid "Add to the <emphasis role=\"strong\">~/.bashrc</emphasis> file"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:877
msgid "mc"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:878
msgid ""
"The <emphasis role=\"strong\">mc</emphasis> command offers very easy ways to "
"manage files. It can open the binary <emphasis role=\"strong\">deb</"
"emphasis> file to check its content by pressing the Enter key over the "
"binary <emphasis role=\"strong\">deb</emphasis> file. It uses the <emphasis "
"role=\"strong\">dpkg-deb</emphasis> command as its back-end. Let’s setup it "
"to support easy <emphasis role=\"strong\">chdir</emphasis> as follows."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:886
msgid "git"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:887
msgid ""
"Nowadays, the <emphasis role=\"strong\">git</emphasis> command is the "
"essential tool to manage the source tree with history."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:888
msgid ""
"The global user configuration for the <emphasis role=\"strong\">git</"
"emphasis> command such as your name and email address can be set in "
"<emphasis role=\"strong\">~/.gitconfig</emphasis> as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:891
msgid ""
"If you are too accustomed to the CVS or Subversion commands, you may wish to "
"set several command aliases as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:894
msgid "You can check your global configuration as follows."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:896
msgid ""
"It is essential to use the <emphasis role=\"strong\">gitk</emphasis> command "
"to work effectively with the history of the git repository."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:899
msgid "quilt"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:900
msgid ""
"The <emphasis role=\"strong\">quilt</emphasis> command offers a basic method "
"for recording modifications. For the Debian packaging, it should be "
"customized to record modifications in the <emphasis role=\"strong\">debian/"
"patches/</emphasis> directory instead of its default <emphasis role=\"strong"
"\">patches/</emphasis> directory."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:901
msgid ""
"In order to avoid changing the behavior of the <emphasis role=\"strong"
"\">quilt</emphasis> command itself, let’s create an alias <emphasis role="
"\"strong\">dquilt</emphasis> for the Debian packaging by adding the "
"following lines to the <emphasis role=\"strong\">~/.bashrc</emphasis> file. "
"The second line provides the same shell completion feature of the <emphasis "
"role=\"strong\">quilt</emphasis> command to the <emphasis role=\"strong"
"\">dquilt</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:906
msgid ""
"Then let’s create <emphasis role=\"strong\">~/.quiltrc-dpkg</emphasis> as "
"follows."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:920
msgid "How To Survive With Many Patches or Introduction to Quilt"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:920
msgid ""
"See <emphasis role=\"strong\">quilt</emphasis>(1) and <_:ulink-1/> on how to "
"use the <emphasis role=\"strong\">quilt</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:921
msgid "See <xref linkend=\"alt-patch\"/> for example usages."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:924
msgid "devscripts"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:925
msgid ""
"The <emphasis role=\"strong\">debsign</emphasis> command, included in the "
"<emphasis role=\"strong\">devscripts</emphasis> package, is used to sign the "
"Debian package with your private GPG key."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:926
msgid ""
"The <emphasis role=\"strong\">debuild</emphasis> command, included in the "
"<emphasis role=\"strong\">devscripts</emphasis> package, builds the binary "
"package and check them with the <emphasis role=\"strong\">lintian</emphasis> "
"command. It is useful to have verbose outputs from the <emphasis role="
"\"strong\">lintian</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:927
msgid ""
"You can setup these by the <emphasis role=\"strong\">~/.devscripts</"
"emphasis> as follows."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:931
msgid "Creating a new GPG key"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:931
msgid "Currently, RSA key with 4096 bits is good idea. See <_:ulink-1/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:934
msgid "pbuilder"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:935
msgid ""
"The <emphasis role=\"strong\">sbuild</emphasis> package provides an "
"alternative chroot platform."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:935
msgid ""
"The <emphasis role=\"strong\">pbuilder</emphasis> package provides the clean "
"room (<emphasis role=\"strong\">chroot</emphasis>) build environment. <_:"
"footnote-1/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:936
msgid "Let’s customize it with several helper packages."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:939
msgid ""
"The <emphasis role=\"strong\">cowbuilder</emphasis> package to boost the "
"chroot creation speed."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:944
msgid ""
"The <emphasis role=\"strong\">lintian</emphasis> package to find bugs in the "
"package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:949
msgid ""
"The <emphasis role=\"strong\">bash</emphasis>, <emphasis role=\"strong\">mc</"
"emphasis>, and <emphasis role=\"strong\">vim</emphasis> packages in case "
"build fails."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:954
msgid ""
"The <emphasis role=\"strong\">ccache</emphasis> package to boost the "
"<emphasis role=\"strong\">gcc</emphasis> speed. (optional)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:959
msgid ""
"The <emphasis role=\"strong\">libeatmydata1</emphasis> package to boost the "
"<emphasis role=\"strong\">dpkg</emphasis> speed. (optional)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:964
msgid ""
"The parallel <emphasis role=\"strong\">make</emphasis> to boost the build "
"speed. (optional)"
msgstr ""

#. (itstool) path: warning/simpara
#: debmake-doc.en.xml:969
msgid ""
"The optional customization may cause negative effects. In case of doubts, "
"disable them."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:970
msgid ""
"Let’s create <emphasis role=\"strong\">~/.pbuilderrc</emphasis> as follows "
"(all optional features are disabled)."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:991
msgid ""
"A symlink from <emphasis role=\"strong\">/root/.pbuilderrc</emphasis> to "
"<emphasis role=\"strong\">/home/&lt;user&gt;/.pbuilderrc</emphasis> may help "
"for the consistent experience."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:992
msgid "Bug #606542"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:992
msgid ""
"Due to <_:ulink-1/>, you may need to manually install packages listed in "
"<emphasis role=\"strong\">EXTRAPACKAGES</emphasis> into the chroot. See "
"<xref linkend=\"chroot\"/>."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:993
msgid ""
"Install <emphasis role=\"strong\">libeatmydata1</emphasis> (&gt;=82-2) both "
"inside and outside of the chroot or disable to use <emphasis role=\"strong"
"\">libeatmydata1</emphasis>. This may cause the race condition with some "
"build systems."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:994
msgid ""
"The parallel <emphasis role=\"strong\">make</emphasis> may fail for some "
"existing packages and may make the build log difficult to read."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:995
msgid "Let’s create a hook scripts as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:996
msgid ""
"<emphasis role=\"strong\">/var/cache/pbuilder/hooks/A10ccache</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1003
msgid ""
"<emphasis role=\"strong\">/var/cache/pbuilder/hooks/B90lintian</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1010
msgid "<emphasis role=\"strong\">/var/cache/pbuilder/hooks/C10shell</emphasis>"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1017
msgid ""
"All these scripts need to be set world executable: “<emphasis role=\"strong"
"\">-rwxr-xr-x 1 root root</emphasis>”."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1018
msgid ""
"The <emphasis role=\"strong\">ccache</emphasis> cache directory <emphasis "
"role=\"strong\">/var/cache/pbuilder/ccache</emphasis> needs to be set world "
"writable: “<emphasis role=\"strong\">-rwxrwxrwx 1 root root</emphasis>” for "
"the <emphasis role=\"strong\">pbuilder</emphasis> command. You should be "
"aware of associated security concerns."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1021 debmake-doc.en.xml:4465
msgid "git-buildpackage"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1022
msgid ""
"You may wish to set several global configurations in <emphasis role=\"strong"
"\">~/.gbp.conf</emphasis>"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:1032
msgid ""
"The <emphasis role=\"strong\">gbp</emphasis> command is the alias of the "
"<emphasis role=\"strong\">git-buildpackage</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1035
msgid "HTTP proxy"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1036
msgid ""
"You should set up a local HTTP caching proxy to save the bandwidth for the "
"Debian package repository access. There are several choices:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1039
msgid ""
"Simple HTTP caching proxy using the <emphasis role=\"strong\">squid</"
"emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1044
msgid ""
"Specialized HTTP caching proxy using the <emphasis role=\"strong\">apt-"
"cacher-ng</emphasis> package."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1051
msgid "Private Debian repository"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1052
msgid ""
"You can set up a private Debian package repository with the <emphasis role="
"\"strong\">reprepro</emphasis> package."
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:1056
msgid "Simple Example"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1057
msgid ""
"There is an old Latin saying: “<emphasis role=\"strong\">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”)."
msgstr ""

#. (itstool) path: chapter/simpara
#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1058 debmake-doc.en.xml:6243
msgid ""
"Here is an example of creating a simple Debian package from a simple C "
"source using the <emphasis role=\"strong\">Makefile</emphasis> as its build "
"system."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1059
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-0.0.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: chapter/simpara
#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1060 debmake-doc.en.xml:5606 debmake-doc.en.xml:5734
#: debmake-doc.en.xml:6246
msgid "This type of source is meant to be installed as a non-system file as:"
msgstr ""

#. (itstool) path: chapter/simpara
#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1065 debmake-doc.en.xml:5610 debmake-doc.en.xml:6251
msgid ""
"Debian packaging requires to change this “<emphasis role=\"strong\">make "
"install</emphasis>” process to install files to the target system image "
"location instead of the normal location under <emphasis role=\"strong\">/usr/"
"local</emphasis>."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1066
msgid ""
"Examples of creating Debian package from other complicated build systems are "
"described in <xref linkend=\"more\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1068
msgid "Big picture"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1069
msgid ""
"The big picture for building a single non-native Debian package from the "
"upstream tarball <emphasis role=\"strong\">debhello-0.0.tar.gz</emphasis> "
"can be summarized as:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1072
msgid "The maintainer obtains the upstream tarball and untar its contents."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1077
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command debianize the "
"upstream source tree by adding template files to it."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1082
msgid "The maintainer customizes template files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1087
msgid ""
"The <emphasis role=\"strong\">debuild</emphasis> command builds the binary "
"package from the debianized source tree."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1092
msgid "Big picture of package building"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:1099
msgid ""
"The <emphasis role=\"strong\">debuild</emphasis> command in this and "
"following examples may be substituted by the equivalent commands such as the "
"<emphasis role=\"strong\">pdebuild</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1102
msgid "What is debmake?"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1103
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command is the helper "
"script for the Debian packaging."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1106
msgid ""
"It always sets most of the obvious option states and values to reasonable "
"defaults."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1111
msgid ""
"It generates the upstream tarball and its required symlink if they are "
"missing."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1116
msgid ""
"It doesn’t overwrite the existing configuration files in the <emphasis role="
"\"strong\">debian/</emphasis> directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1121
msgid "It supports the <emphasis role=\"strong\">multiarch</emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1126
msgid ""
"It creates good template files such as the <emphasis role=\"strong\">debian/"
"copyright</emphasis> file complaint to <emphasis role=\"strong\">DEP-5</"
"emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1131
msgid ""
"These features make Debian packaging with <emphasis role=\"strong\">debmake</"
"emphasis> simple and modern."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1134
msgid "What is debuild?"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1135
msgid ""
"Here is a summary of commands similar to the <emphasis role=\"strong"
"\">debuild</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1138
msgid ""
"The <emphasis role=\"strong\">debian/rules</emphasis> file defines how the "
"Debian package is built."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1143
msgid ""
"The <emphasis role=\"strong\">dpkg-buildpackage</emphasis> is the official "
"command to invoke <emphasis role=\"strong\">debian/rules</emphasis> to build "
"the Debian package. Notably, it executes itself with the <emphasis role="
"\"strong\">clean</emphasis> target before the <emphasis role=\"strong"
"\">binary</emphasis> one for the normal package build."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1148
msgid ""
"The <emphasis role=\"strong\">debuild</emphasis> command is a wrapper script "
"of <emphasis role=\"strong\">dpkg-buidpackage</emphasis> to build a package "
"under the proper environment variables."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1153
msgid ""
"The <emphasis role=\"strong\">pdebuild</emphasis> command is a wrapper "
"script to build a package under the proper chroot environment with the "
"proper environment variables."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1158
msgid ""
"The <emphasis role=\"strong\">git-pbuilder</emphasis> command is another "
"wrapper script to build a package under the proper chroot environment with "
"the proper environment variables. This provides an easier command line UI to "
"switch among different build environments."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1165
msgid "Step-by-step: upstream"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1166
msgid "Let’s get the source."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1167
msgid "Download <emphasis role=\"strong\">debhello-0.0.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1182
msgid ""
"Here, the C source <emphasis role=\"strong\">hello.c</emphasis> is a very "
"simple one."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1183
msgid "<emphasis role=\"strong\">hello.c</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1193
msgid ""
"Here, the <emphasis role=\"strong\">Makefile</emphasis> supports <_:ulink-1/"
"> and <_:ulink-2/>. Notably:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1196
msgid ""
"build binaries honoring <emphasis role=\"strong\">$(CPPFLAGS)</emphasis>, "
"<emphasis role=\"strong\">$(CFLAGS)</emphasis>, <emphasis role=\"strong\">"
"$(LDFLAGS)</emphasis>, etc."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1201
msgid ""
"install files with the <emphasis role=\"strong\">$(DESTDIR)</emphasis> to "
"the target system image"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1206
msgid ""
"install files with the <emphasis role=\"strong\">$(prefix)</emphasis> which "
"can be overridden to be <emphasis role=\"strong\">/usr</emphasis>"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1211
msgid "<emphasis role=\"strong\">Makefile</emphasis>"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1237
msgid ""
"The <emphasis role=\"strong\">echo</emphasis> of the <emphasis role=\"strong"
"\">$(CFLAGS)</emphasis> is used to verify the proper setting of the build "
"flag in the following example."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1240
msgid "Step-by-step: debmake"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:1241
msgid ""
"If the <emphasis role=\"strong\">debmake</emphasis> command is invoked with "
"the <emphasis role=\"strong\">-T</emphasis> option, more verbose comments "
"are generated for the template files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1242
msgid ""
"The output from the <emphasis role=\"strong\">debmake</emphasis> command is "
"very verbose and explains what it does as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1287
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command generates all these "
"template files based on the command line option. Since no options are "
"specified, the <emphasis role=\"strong\">debmake</emphasis> command choses "
"reasonable default values for you:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1290
msgid "The source package name: <emphasis role=\"strong\">debhello</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1295
msgid "The upstream version: <emphasis role=\"strong\">0.0</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1300
msgid "The binary package name: <emphasis role=\"strong\">debhello</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1305
msgid "The Debian revision: <emphasis role=\"strong\">1</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1310
msgid ""
"The package type: <emphasis role=\"strong\">bin</emphasis> (the ELF binary "
"executable package)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1315
msgid ""
"The <emphasis role=\"strong\">-x</emphasis> option: <emphasis role=\"strong"
"\">-x1</emphasis> (default for the single binary package)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1320 debmake-doc.en.xml:5259
msgid "Let’s inspect generated template files."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1321
msgid ""
"The source tree after the basic <emphasis role=\"strong\">debmake</emphasis> "
"execution."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1348
msgid ""
"The <emphasis role=\"strong\">debian/rules</emphasis> file is the build "
"script provided by the package maintainer. Here is its template file "
"generated by the <emphasis role=\"strong\">debmake</emphasis> command."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1349
msgid "<emphasis role=\"strong\">debian/rules</emphasis> (template file):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1367
msgid ""
"This is essentially the standard <emphasis role=\"strong\">debian/rules</"
"emphasis> file with the <emphasis role=\"strong\">dh</emphasis> command. "
"(There are some commented out contents for you to customize it.)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1368
msgid ""
"The <emphasis role=\"strong\">debian/control</emphasis> file provides the "
"main meta data for the Debian package. Here is its template file generated "
"by the <emphasis role=\"strong\">debmake</emphasis> command."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1369
msgid "<emphasis role=\"strong\">debian/control</emphasis> (template file):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1387
msgid ""
"Since this is the ELF binary executable package, the <emphasis role=\"strong"
"\">debmake</emphasis> command sets “<emphasis role=\"strong\">Architecture: "
"any</emphasis>” and “<emphasis role=\"strong\">Multi-Arch: foreign</"
"emphasis>”. Also, it sets required <emphasis role=\"strong\">substvar</"
"emphasis> parameters as “<emphasis role=\"strong\">Depends: ${shlibs:"
"Depends}, ${misc:Depends}</emphasis>”. These are explained in <xref linkend="
"\"basics\"/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:1388
msgid "5.2 Source package control files — debian/control"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1388
msgid ""
"Please note this <emphasis role=\"strong\">debian/control</emphasis> file "
"uses the RFC-822 style as documented in <_:ulink-1/> of the “Debian Policy "
"Manual”. The use of the empty line and the leading space are significant."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1389
msgid ""
"The <emphasis role=\"strong\">debian/copyright</emphasis> file provides the "
"copyright summary data of the Debian package. Here is its template file "
"generated by the <emphasis role=\"strong\">debmake</emphasis> command."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1390
msgid "<emphasis role=\"strong\">debian/copyright</emphasis> (template file):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1433
msgid "Step-by-step: maintainer"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1434
msgid ""
"Some manual modification is required to make the proper Debian package as a "
"maintainer."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1435
msgid ""
"In order to install files as a part of the system files, the <emphasis role="
"\"strong\">$(prefix)</emphasis> value of <emphasis role=\"strong\">/usr/"
"local</emphasis> in the <emphasis role=\"strong\">Makefile</emphasis> should "
"be overridden to be <emphasis role=\"strong\">/usr</emphasis>. This can be "
"accommodated by the following the <emphasis role=\"strong\">debian/rules</"
"emphasis> file with the <emphasis role=\"strong\">override_dh_auto_install</"
"emphasis> target setting “<emphasis role=\"strong\">prefix=/usr</emphasis>”."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1436
msgid "<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1452
msgid ""
"Exporting the <emphasis role=\"strong\">DH_VERBOSE</emphasis> in the "
"<emphasis role=\"strong\">debian/rules</emphasis> file as above forces the "
"<emphasis role=\"strong\">debhelper</emphasis> tool to make a fine grained "
"build report."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:1453
msgid ""
"This is a cliché to force read-only relocation link for the hardening and to "
"prevent the lintian warning “<emphasis role=\"strong\">W: debhello: "
"hardening-no-relro usr/bin/hello</emphasis>”. This is not really needed for "
"this example but should be harmless. The lintian seems to produce false "
"positive warning for this case which has no linked library."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1453
msgid ""
"Exporting the <emphasis role=\"strong\">DEB_BUILD_MAINT_OPTION</emphasis> as "
"above sets the hardening options as described in the “FEATURE AREAS/"
"ENVIRONMENT” in <emphasis role=\"strong\">dpkg-buildflags</emphasis>(1). <_:"
"footnote-1/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1454
msgid ""
"Exporting the <emphasis role=\"strong\">DEB_CFLAGS_MAINT_APPEND</emphasis> "
"as above forces C compiler to emit all the warnings."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:1455
msgid ""
"This is a cliché to prevent overlinking for the complex library dependency "
"case such as Gnome programs. This is not really needed for this simple "
"example but should be harmless."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1455
msgid ""
"Exporting the <emphasis role=\"strong\">DEB_LDFLAGS_MAINT_APPEND</emphasis> "
"as above forces linker to link only when the library is actually needed. <_:"
"footnote-1/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1456
msgid ""
"The <emphasis role=\"strong\">dh_auto_install</emphasis> command for the "
"Makefile based build system does essentially “<emphasis role=\"strong\">"
"$(MAKE) install DESTDIR=debian/debhello</emphasis>”. The creation of this "
"<emphasis role=\"strong\">override_dh_auto_install</emphasis> target changes "
"its behavior to “<emphasis role=\"strong\">$(MAKE) install DESTDIR=debian/"
"debhello prefix=/usr</emphasis>”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1457
msgid ""
"Here are the maintainer version of the <emphasis role=\"strong\">debian/"
"control</emphasis> and <emphasis role=\"strong\">debian/copyright</emphasis> "
"files."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1458
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1481
msgid ""
"<emphasis role=\"strong\">debian/copyright</emphasis> (maintainer version):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1510 debmake-doc.en.xml:5463 debmake-doc.en.xml:5709
#: debmake-doc.en.xml:5906 debmake-doc.en.xml:6041 debmake-doc.en.xml:6343
#: debmake-doc.en.xml:6553 debmake-doc.en.xml:6714 debmake-doc.en.xml:6899
#: debmake-doc.en.xml:7231 debmake-doc.en.xml:7540
msgid ""
"There are several other template files under the <emphasis role=\"strong"
"\">debian/</emphasis> directory. These also needs to be updated."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1511
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=0.0):"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:1529
msgid ""
"Configuration files used by the <emphasis role=\"strong\">dh_</emphasis>* "
"commands from the <emphasis role=\"strong\">debhelper</emphasis> package "
"usually treat <emphasis role=\"strong\">#</emphasis> as the start of the "
"comment line."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1532
msgid "Step-by-step: debuild"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1533 debmake-doc.en.xml:5484
msgid ""
"You can create a non-native Debian package using the <emphasis role=\"strong"
"\">debuild</emphasis> command (or its equivalents) in this source tree. The "
"command output is very verbose and explains what it does as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1564
msgid ""
"You can verify <emphasis role=\"strong\">CFLAGS</emphasis> is updated "
"properly with <emphasis role=\"strong\">-Wall</emphasis> and <emphasis role="
"\"strong\">-pedantic</emphasis> by the <emphasis role=\"strong"
"\">DEB_CFLAGS_MAINT_APPEND</emphasis> variable."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1565
msgid ""
"The manpage should be added to the package as reported by the <emphasis role="
"\"strong\">lintian</emphasis> package as shown in the later examples (see "
"<xref linkend=\"more\"/>). Let’s move on for now."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1566 debmake-doc.en.xml:5508
msgid "Let’s inspect the result."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1567
msgid ""
"The generated files of <emphasis role=\"strong\">debhello</emphasis> version "
"<emphasis role=\"strong\">0.0</emphasis> by the <emphasis role=\"strong"
"\">debuild</emphasis> command:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1582 debmake-doc.en.xml:5524
msgid "You see all the generated files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1585
msgid ""
"The <emphasis role=\"strong\">debhello_0.0.orig.tar.gz</emphasis> is a "
"symlink to the upstream tarball."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1590
msgid ""
"The <emphasis role=\"strong\">debhello_0.0-1.debian.tar.xz</emphasis> "
"contains the maintainer generated contents."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1595
msgid ""
"The <emphasis role=\"strong\">debhello_0.0-1.dsc</emphasis> is the meta data "
"file for the Debian source package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1600
msgid ""
"The <emphasis role=\"strong\">debhello_0.0-1_amd64.deb</emphasis> is the "
"Debian binary package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1605
msgid ""
"The <emphasis role=\"strong\">debhello_0.0-1_amd64.changes</emphasis> is the "
"meta data file for the Debian binary package."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1610
msgid ""
"The <emphasis role=\"strong\">debhello_0.0-1.debian.tar.xz</emphasis> "
"contains the Debian changes to the upstream source as follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1611
msgid ""
"The compressed archive contents of <emphasis role=\"strong\">debhello_0.0-1."
"debian.tar.xz</emphasis>:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1632
msgid ""
"The <emphasis role=\"strong\">debhello_0.0-1_amd64.deb</emphasis> contains "
"the files to be installed as follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1633
msgid ""
"The binary package contents of <emphasis role=\"strong"
"\">debhello_0.0-1_amd64.deb</emphasis>:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1646
msgid ""
"The generated dependency of <emphasis role=\"strong\">debhello_0.0-1_amd64."
"deb</emphasis> is as follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1647
msgid ""
"The generated dependency of <emphasis role=\"strong\">debhello_0.0-1_amd64."
"deb</emphasis>:"
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:1651
msgid ""
"Much more details need to be addressed before uploading the package to the "
"Debian archive."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1652
msgid ""
"If manual adjustments of auto-generated configuration files are skipped, the "
"generated binary package may lack meaningful package description and some of "
"the policy requirements may be missed. This sloppy package functions well "
"under the <emphasis role=\"strong\">dpkg</emphasis> command, and may be good "
"enough for your local deployment."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1655
msgid "Alternative: patch files"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1656
msgid ""
"The above step-by-step example did not touch the upstream source to make the "
"proper Debian package."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1657
msgid ""
"An alternative approach is to change the upstream source by creating the "
"patch <emphasis role=\"strong\">000-prefix-usr.patch</emphasis> which "
"modifies the upstream <emphasis role=\"strong\">Makefile</emphasis> to set "
"the $(prefix) value to <emphasis role=\"strong\">/usr</emphasis> in advance."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1658
msgid ""
"create <emphasis role=\"strong\">000-prefix-usr.patch</emphasis> by the "
"<emphasis role=\"strong\">diff</emphasis> command:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1676
msgid ""
"Please note that the upstream source tree is restored to the original state."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1677
msgid ""
"The packaging is practically the same as the above step-by-step example "
"except for 2 points of the maintainer modification."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1678
msgid ""
"The maintainer modification to the <emphasis role=\"strong\">debian/rules</"
"emphasis> file doesn’t have the <emphasis role=\"strong"
"\">override_dh_auto_install</emphasis> target as follows:"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1679
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (alternative maintainer "
"version):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1692
msgid ""
"The maintainer modification to the upstream source during the package "
"building process is enabled by adding the corresponding patch file in the "
"<emphasis role=\"strong\">debian/patches/</emphasis> directory and listing "
"its file names in the <emphasis role=\"strong\">debian/patches/series</"
"emphasis> file."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1693
msgid ""
"Set of files to modify the upstream <emphasis role=\"strong\">Makefile</"
"emphasis>:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1710
msgid "The rest of the packaging is the same as the step-by-step example."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1711
msgid ""
"As indicated in <xref linkend=\"patchapproach\"/>, there are several tools "
"other than the <emphasis role=\"strong\">diff</emphasis> command which "
"generate patch files used for this alternative approach of packaging. Most "
"frequently used ones are the <emphasis role=\"strong\">dquilt</emphasis> or "
"<emphasis role=\"strong\">gbp-pq</emphasis> commands."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1712
msgid ""
"There is no need to create the patch file in advance for these commands "
"since it can be generated as you make the maintainer modification. Here is "
"an example for the <emphasis role=\"strong\">dquilt</emphasis> command."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:1713
msgid ""
"patch file generation using the <emphasis role=\"strong\">dquilt</emphasis> "
"command:"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:1749
msgid ""
"If the package is maintained in the git repository using the <emphasis role="
"\"strong\">gbp</emphasis> command, please use the <emphasis role=\"strong"
"\">gbp-pq</emphasis> command to manage patches."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1750
msgid ""
"This alternative approach to the Debian packaging using a series of patch "
"files may be less robust for the future upstream changes but more flexible "
"to cope with the difficult upstream source. (See <xref linkend=\"deb3\"/>.)"
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:1754
msgid "Basics"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1755
msgid "It’s time to learn the basic rules of the Debian packaging."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1756
msgid ""
"The Debian source package is a set of input files used to build the Debian "
"binary package and is not a single file."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1757
msgid ""
"The Debian binary package is a special archive file which holds a set of "
"installable binary data with their associated information."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1758
msgid ""
"A single Debian source package may generate multiple Debian binary packages "
"defined in the <emphasis role=\"strong\">debian/control</emphasis> file."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:1759
msgid ""
"The non-native Debian package in the “<emphasis role=\"strong\">3.0 (quilt)</"
"emphasis>” format is the most normal Debian binary package format."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:1760
msgid ""
"There are many wrapper scripts. Use them to streamline your workflow but "
"make sure to understand the basics of their internals."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:1762
msgid "Packaging workflow"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1763
msgid ""
"The Debian packaging workflow to create the Debian binary package involves "
"generating several specifically named files (see <xref linkend=\"name-version"
"\"/>) as defined in the “Debian Policy Manual”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1764
msgid ""
"The oversimplified method for the Debian packaging workflow can be "
"summarized in 5 steps as follows."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1767 debmake-doc.en.xml:8000
msgid ""
"The upstream tarball is downloaded as the <emphasis>package-version</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1772
msgid ""
"The upstream tarball is untarred to create many files under the "
"<emphasis>package-version</emphasis><emphasis role=\"strong\">/</emphasis> "
"directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1777
msgid ""
"The upstream tarball is copied (or symlinked) to the particular filename "
"<emphasis>packagename_version</emphasis><emphasis role=\"strong\">.orig.tar."
"gz</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1782
msgid ""
"the character separating <emphasis>package</emphasis> and <emphasis>version</"
"emphasis> is changed from <emphasis role=\"strong\">-</emphasis> (hyphen) to "
"<emphasis role=\"strong\">_</emphasis> (underscore)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1787
msgid ""
"<emphasis role=\"strong\">.orig</emphasis> is added in the file extension."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1794
msgid ""
"The Debian package specification files are added to the upstream source "
"under the <emphasis>package-version</emphasis><emphasis role=\"strong\">/"
"debian/</emphasis> directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1799
msgid ""
"Required specification files under the <emphasis role=\"strong\">debian/</"
"emphasis>*:"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:1804
msgid "<emphasis role=\"strong\">debian/rules</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1808
msgid ""
"The executable script for building the Debian package (see <xref linkend="
"\"rules\"/>)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:1814
msgid "<emphasis role=\"strong\">debian/control</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1818
msgid ""
"The package configuration file containing the source package name, the "
"source build dependency, the binary package name, the binary dependency, "
"etc. (see <xref linkend=\"control\"/>)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:1824
msgid "<emphasis role=\"strong\">debian/changelog</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1828
msgid ""
"The Debian package history file defining the upstream package version and "
"the Debian revision in its first line (see <xref linkend=\"changelog\"/>)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:1834
msgid "<emphasis role=\"strong\">debian/copyright</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1838
msgid "The copyright and license summary (see <xref linkend=\"copyright\"/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1846
msgid ""
"Optional specification files under the <emphasis role=\"strong\">debian/</"
"emphasis>* (see <xref linkend=\"debianconf\"/>):"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1851
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command invoked in the "
"<emphasis>package-version/</emphasis> directory provides the initial set of "
"these template configuration files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1856
msgid ""
"Required specification files are generated even with the <emphasis role="
"\"strong\">-x0</emphasis> option."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1861
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command does not overwrite "
"any existing configuration files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1868
msgid ""
"These files must be manually edited to their perfection according to the "
"“Debian Policy Manual” and “Debian Developer’s Reference”."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1875
msgid ""
"The <emphasis role=\"strong\">dpkg-buildpackage</emphasis> command (usually "
"from its wrapper <emphasis role=\"strong\">debuild</emphasis> or <emphasis "
"role=\"strong\">pdebuild</emphasis>) is invoked in the <emphasis>package-"
"version/</emphasis> directory to make the Debian source and binary packages "
"by invoking the <emphasis role=\"strong\">debian/rules</emphasis> script."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1880
msgid ""
"The current directory is set as: <emphasis role=\"strong\">$(CURDIR)=</"
"emphasis><emphasis>/path/to/package-version/</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1885
msgid ""
"Create the Debian source package in the “<emphasis role=\"strong\">3.0 "
"(quilt)</emphasis>” format using <emphasis role=\"strong\">dpkg-source</"
"emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1890
msgid ""
"<emphasis>package_version</emphasis>.<emphasis role=\"strong\">orig.tar.gz</"
"emphasis> (copy or symlink of <emphasis>package-version</emphasis>.<emphasis "
"role=\"strong\">tar.gz</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1895
msgid ""
"<emphasis>package_version-revision</emphasis>.<emphasis role=\"strong"
"\">debian.tar.xz</emphasis> (tarball of <emphasis>package-version</emphasis>/"
"<emphasis role=\"strong\">debian/</emphasis>*)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1900
msgid ""
"<emphasis>package_version-revision</emphasis>.<emphasis role=\"strong\">dsc</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1907
msgid ""
"Build the source using “<emphasis role=\"strong\">debian/rules build</"
"emphasis>” into <emphasis role=\"strong\">$(DESTDIR)</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1912
msgid ""
"<emphasis role=\"strong\">DESTDIR=debian</emphasis>/<emphasis>binarypackage/"
"</emphasis> (single binary package)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1917
msgid ""
"<emphasis role=\"strong\">DESTDIR=debian/tmp/</emphasis> (multi binary "
"package)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1924
msgid ""
"Create the Debian binary package using <emphasis role=\"strong\">dpkg-deb</"
"emphasis>(1), and <emphasis role=\"strong\">dpkg-genchanges</emphasis>(1)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1929
msgid ""
"<emphasis>binarypackage_version-revision_arch</emphasis>.<emphasis role="
"\"strong\">deb</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1934
msgid "… (There may be multiple Debian binary package files.)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1939
msgid ""
"<emphasis>package_version-revision_arch</emphasis>.<emphasis role=\"strong"
"\">changes</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1948
msgid ""
"Check the quality of the Debian package with the <emphasis role=\"strong"
"\">lintian</emphasis> command. (recommended)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:1954
msgid "ftp-master"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1953
msgid "Follow the rejection guideline from <_:ulink-1/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:1959
msgid "REJECT-FAQ"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:1964
msgid "NEW checklist"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:1969
msgid "Lintian Autorejects"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:1969
msgid "lintian tag list"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1968
msgid "<_:ulink-1/> (<_:ulink-2/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1977
msgid ""
"Sign the <emphasis>package_version-revision</emphasis>.<emphasis role="
"\"strong\">dsc</emphasis> and <emphasis>package_version-revision_arch</"
"emphasis>.<emphasis role=\"strong\">changes</emphasis> with the <emphasis "
"role=\"strong\">debsign</emphasis> command using your private GPG key."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1982
msgid ""
"Upload the set of the Debian source and binary package files with the "
"<emphasis role=\"strong\">dput</emphasis> command to the Debian archive."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:1987
msgid "Here, please replace each part of the filename as:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1990
msgid ""
"the <emphasis>package</emphasis> part with the Debian source package name"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:1995
msgid ""
"the <emphasis>binarypackage</emphasis> part with the Debian binary package "
"name"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2000
msgid "the <emphasis>version</emphasis> part with the upstream version"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2005
msgid "the <emphasis>revision</emphasis> part with the Debian revision"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2010
msgid "the <emphasis>arch</emphasis> part with the package architecture"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2015
msgid "Chapter 6. Best Packaging Practices"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:2015
msgid ""
"There is very extensive documentation in <_:ulink-1/> of the “Debian "
"Developer’s Reference”. Please read it."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2018
msgid "Package name and version"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2019
msgid ""
"If the upstream source comes as <emphasis role=\"strong\">hello-0.9.12.tar."
"gz</emphasis>, you can take <emphasis role=\"strong\">hello</emphasis> as "
"the upstream source package name and <emphasis role=\"strong\">0.9.12</"
"emphasis> as the upstream version."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2020 debmake-doc.en.xml:8532
msgid ""
"<emphasis role=\"strong\">debmake</emphasis> is meant to provide template "
"files for the package maintainer to work on. Comment lines started by "
"<emphasis role=\"strong\">#</emphasis> contain the tutorial text. You must "
"remove or edit such comment lines before uploading to the Debian archive."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2021 debmake-doc.en.xml:8533
msgid ""
"There are some limitations for what characters may be used as a part of the "
"Debian package. The most notable limitation is the prohibition of uppercase "
"letters in the package name. Here is the summary in the regular expression."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2024 debmake-doc.en.xml:8536
msgid ""
"Upstream package name (<emphasis role=\"strong\">-p</emphasis>): [-+.a-z0-9]"
"{2,}"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2029 debmake-doc.en.xml:8541
msgid ""
"Binary package name (<emphasis role=\"strong\">-b</emphasis>): [-+.a-z0-9]"
"{2,}"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2034 debmake-doc.en.xml:8546
msgid ""
"Upstream version (<emphasis role=\"strong\">-u</emphasis>): [0-9][-+.:~a-"
"z0-9A-Z]*"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2039 debmake-doc.en.xml:8551
msgid ""
"Debian revision (<emphasis role=\"strong\">-r</emphasis>): [0-9][+.~a-z0-9A-"
"Z]*"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2044 debmake-doc.en.xml:2324 debmake-doc.en.xml:8556
msgid "Chapter 5 - Control files and their fields"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2044 debmake-doc.en.xml:8556
msgid "See the exact definition in <_:ulink-1/> of the “Debian Policy Manual”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2045
msgid ""
"You must adjust the package name and upstream version accordingly for the "
"Debian packaging."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:2046
msgid ""
"For more than 90% of packages, the package name is equal or less than 24 "
"characters; the upstream version is equal or less than 10 characters and the "
"Debian revision is equal or less than 3 characters."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2046
msgid ""
"In order to manage the package name and version information effectively "
"under popular tools such as the <emphasis role=\"strong\">aptitude</"
"emphasis> command, it is a good idea to keep the length of package name to "
"be equal or less than 30 characters; and the total length of version and "
"revision to be equal or less than 14 characters. <_:footnote-1/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2047
msgid ""
"In order to avoid name collisions, the user visible binary package name "
"should not be chosen from any generic words."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2048
msgid ""
"If upstream does not use a normal versioning scheme such as <emphasis role="
"\"strong\">2.30.32</emphasis> but uses some kind of date such as <emphasis "
"role=\"strong\">11Apr29</emphasis>, a random codename string, or a VCS hash "
"value as part of the version, make sure to remove them from the upstream "
"version. Such information can be recorded in the <emphasis role=\"strong"
"\">debian/changelog</emphasis> file. If you need to invent a version string, "
"use the <emphasis role=\"strong\">YYYYMMDD</emphasis> format such as "
"<emphasis role=\"strong\">20110429</emphasis> as upstream version. This "
"ensures that dpkg interprets later versions correctly as upgrades. If you "
"need to ensure smooth transition to the normal version scheme such as "
"<emphasis role=\"strong\">0.1</emphasis> in future, use the <emphasis role="
"\"strong\">0~YYMMDD</emphasis> format such as <emphasis role=\"strong"
"\">0~110429</emphasis> as upstream version, instead."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2049
msgid ""
"Version strings can be compared using the <emphasis role=\"strong\">dpkg</"
"emphasis> command as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2051
msgid "The version comparison rule can be summarized as:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2054
msgid "Strings are compared from the head to the tail."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2059
msgid "Letters are larger than digits."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2064
msgid "Numbers are compared as integers."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2069
msgid "Letters are compared in ASCII code order."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2074
msgid ""
"There are special rules for period (<emphasis role=\"strong\">.</emphasis>), "
"plus (<emphasis role=\"strong\">+</emphasis>), and tilde (<emphasis role="
"\"strong\">~</emphasis>) characters, as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2076
msgid ""
"One tricky case occurs when upstream releases <emphasis role=\"strong"
"\">hello-0.9.12-ReleaseCandidate-99.tar.gz</emphasis> as the pre-release of "
"<emphasis role=\"strong\">hello-0.9.12.tar.gz</emphasis>. You can ensure the "
"upgrade to work properly by renaming the upstream source to <emphasis role="
"\"strong\">hello-0.9.12~rc99.tar.gz</emphasis> having the proper version "
"order."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2079
msgid "Native Debian package"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2080
msgid ""
"The non-native Debian package in the “<emphasis role=\"strong\">3.0 (quilt)</"
"emphasis>” format is the most normal Debian binary package format. The above "
"workflow and the following packaging examples always use this format."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2081
msgid ""
"The native Debian package is the rare Debian binary package format. It may "
"be used only when the package is useful and valuable only for Debian. Thus, "
"its use is generally deprecated."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:2082
msgid ""
"The native debian package is often accidentally built when its upstream "
"tarball is not accessible from the <emphasis role=\"strong\">dpkg-"
"buildpackage</emphasis> command with its correct name "
"<emphasis>package_version</emphasis>.<emphasis role=\"strong\">orig.tar.gz</"
"emphasis> . A typical newbie mistake is to make a symlink name with "
"“<emphasis role=\"strong\">-</emphasis>” instead of the correct one with "
"“<emphasis role=\"strong\">_</emphasis>”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2083
msgid ""
"The native Debian package has no separation between the <emphasis role="
"\"strong\">upstream code</emphasis> and the <emphasis role=\"strong\">Debian "
"changes</emphasis> and consists only with the following:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2086
msgid ""
"<emphasis>package_version</emphasis>.<emphasis role=\"strong\">tar.gz</"
"emphasis> (copy or symlink of <emphasis>package-version</emphasis>.<emphasis "
"role=\"strong\">tar.gz</emphasis> with <emphasis role=\"strong\">debian/</"
"emphasis>* files.)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2091
msgid ""
"<emphasis>package_version</emphasis>.<emphasis role=\"strong\">dsc</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2096
msgid ""
"If you need to create the native Debian package, create it in the “<emphasis "
"role=\"strong\">3.0 (native)</emphasis>” format using <emphasis role=\"strong"
"\">dpkg-source</emphasis>(1)."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:2097
msgid ""
"Use of the “<emphasis role=\"strong\">debameke -t …</emphasis>” command can "
"help this workflow. See <xref linkend=\"dt-option\"/>."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:2097
msgid ""
"Some people promote to package even programs which have been written only "
"for Debian in the non-native package format. The required tarball without "
"<emphasis role=\"strong\">debian/</emphasis>* files needs to be manually "
"generated in advance before the standard workflow in <xref linkend=\"workflow"
"\"/>. <_:footnote-1/> They claim that the use of non-native package format "
"eases communication with the downstream distributions."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2100
msgid "debian/rules"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2101
msgid ""
"The <emphasis role=\"strong\">debian/rules</emphasis> script is the "
"executable script to build the Debian package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2104
msgid ""
"The <emphasis role=\"strong\">debian/rules</emphasis> script re-targets the "
"upstream build system (see <xref linkend=\"build\"/>) to install files in "
"the <emphasis role=\"strong\">$(DESTDIR)</emphasis> and creates the archive "
"file of the generated files as the <emphasis role=\"strong\">deb</emphasis> "
"file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2109
msgid ""
"The <emphasis role=\"strong\">deb</emphasis> file is used for the binary "
"distribution and installed to the system using the <emphasis role=\"strong"
"\">dpkg</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2116
msgid ""
"The <emphasis role=\"strong\">dh</emphasis> command is normally used as the "
"front-end to the build system inside the <emphasis role=\"strong\">debian/"
"rules</emphasis> script."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2121
msgid ""
"<emphasis role=\"strong\">$(DESTDIR)</emphasis> path depends on the build "
"type."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2126
msgid ""
"<emphasis role=\"strong\">$(DESTDIR)=debian/</"
"emphasis><emphasis>binarypackage</emphasis> (single binary package)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2131
msgid ""
"<emphasis role=\"strong\">$(DESTDIR)=debian/tmp</emphasis> (multiple binary "
"package)"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2139
msgid "dh"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2140
msgid ""
"The <emphasis role=\"strong\">dh</emphasis> command from the <emphasis role="
"\"strong\">debhelper</emphasis> package with the help from its associated "
"packages functions as the wrapper to the typical upstream build systems and "
"offers us with the uniform access to them by supporting all the Debian "
"policy stipulated targets of the <emphasis role=\"strong\">debian/rules</"
"emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2143
msgid ""
"<emphasis role=\"strong\">dh clean</emphasis> : clean files in the source "
"tree."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2148
msgid "<emphasis role=\"strong\">dh build</emphasis> : build the source tree"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2153
msgid ""
"<emphasis role=\"strong\">dh build-arch</emphasis> : build the source tree "
"for architecture dependent packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2158
msgid ""
"<emphasis role=\"strong\">dh build-indep</emphasis> : build the source tree "
"for architecture independent packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2163
msgid ""
"<emphasis role=\"strong\">dh install</emphasis> : install the binary files "
"to <emphasis role=\"strong\">$(DESTDIR)</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2168
msgid ""
"<emphasis role=\"strong\">dh install-arch</emphasis> : install the binary "
"files to <emphasis role=\"strong\">$(DESTDIR)</emphasis> for architecture "
"dependent packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2173
msgid ""
"<emphasis role=\"strong\">dh install-indep</emphasis> : install the binary "
"files to <emphasis role=\"strong\">$(DESTDIR)</emphasis> for architecture "
"independent packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2178
msgid ""
"<emphasis role=\"strong\">dh binary</emphasis> : generate the <emphasis role="
"\"strong\">deb</emphasis> file"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2183
msgid ""
"<emphasis role=\"strong\">dh binary-arch</emphasis> : generate the <emphasis "
"role=\"strong\">deb</emphasis> file for architecture dependent packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2188
msgid ""
"<emphasis role=\"strong\">dh binary-indep</emphasis> : generate the "
"<emphasis role=\"strong\">deb</emphasis> file for architecture independent "
"packages"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:2193
msgid ""
"For <emphasis role=\"strong\">debhelper</emphasis> “compat &gt;= 9”, the "
"<emphasis role=\"strong\">dh</emphasis> command exports compiler flags "
"(<emphasis role=\"strong\">CFLAGS</emphasis>, <emphasis role=\"strong"
"\">CXXFLAGS</emphasis>, <emphasis role=\"strong\">FFLAGS</emphasis>, "
"<emphasis role=\"strong\">CPPFLAGS</emphasis> and <emphasis role=\"strong"
"\">LDFLAGS</emphasis>) with values as returned by <emphasis role=\"strong"
"\">dpkg-buildflags</emphasis> if they are not set previously. (The <emphasis "
"role=\"strong\">dh</emphasis> command calls <emphasis role=\"strong"
"\">set_buildflags</emphasis> defined in the <emphasis role=\"strong"
"\">Debian::Debhelper::Dh_Lib</emphasis> module.)"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2196
msgid "Simple debian/rules"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:2197
msgid ""
"This simplicity is available since the version 7 of the <emphasis role="
"\"strong\">debhelper</emphasis> package. This guide assumes the use of the "
"<emphasis role=\"strong\">debhelper</emphasis> version 9 or newer."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:2197
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command generates a bit "
"more complicated <emphasis role=\"strong\">debian/rules</emphasis> file. But "
"this is the core part."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2197
msgid ""
"Thanks to this abstraction of the <emphasis role=\"strong\">dh</emphasis> "
"command <_:footnote-1/>, the Debian policy compliant <emphasis role=\"strong"
"\">debian/rules</emphasis> file supporting all the required targets can be "
"written as simple as <_:footnote-2/>:"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:2198
msgid "Simple <emphasis role=\"strong\">debian/rules</emphasis>:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2205
msgid ""
"Essentially, this <emphasis role=\"strong\">dh</emphasis> command functions "
"as the sequencer to call all required <emphasis role=\"strong\">dh_</"
"emphasis>* commands at the right moment."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:2206
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command sets the <emphasis "
"role=\"strong\">debian/control</emphasis> file with “<emphasis role=\"strong"
"\">Build-Depends: debhelper (&gt;=9)</emphasis>” and the <emphasis role="
"\"strong\">debian/compat</emphasis> file with “<emphasis role=\"strong\">9</"
"emphasis>”."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:2207
msgid ""
"Setting “<emphasis role=\"strong\">export DH_VERBOSE = 1</emphasis>” outputs "
"every command that modifies files on the build system. Also it enables "
"verbose build logs for some build systems."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2210
msgid "Customized debian/rules"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2211
msgid ""
"Flexible customization of the <emphasis role=\"strong\">debian/rules</"
"emphasis> is realized by adding appropriate <emphasis role=\"strong"
"\">override_dh_</emphasis>* targets and their rules."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2212
msgid ""
"Whenever some special operation is required for a certain <emphasis role="
"\"strong\">dh_</emphasis><emphasis>foo</emphasis> command invoked by the "
"<emphasis role=\"strong\">dh</emphasis> command, any automatic execution of "
"it can be overridden by adding the makefile target <emphasis role=\"strong"
"\">override_dh_</emphasis><emphasis>foo</emphasis> in the <emphasis role="
"\"strong\">debian/rules</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2213
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command creates the initial "
"template file taking advantage of the above simple <emphasis role=\"strong"
"\">debian/rules</emphasis> while adding some extra customizations for the "
"package hardening, etc."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2214
msgid ""
"You need to know how underlying build systems work under the hood (see <xref "
"linkend=\"build\"/>) to address their irregularities using the package "
"customization."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2215
msgid ""
"See <xref linkend=\"simple\"/> for the actual simple <emphasis role=\"strong"
"\">debian/rules</emphasis> generated by the <emphasis role=\"strong"
"\">debmake</emphasis> command which comes with the commented out parts "
"addressing the hardening via compile options (see <xref linkend=\"harden\"/"
">) and the multiarch customization (see <xref linkend=\"multiarch\"/>)."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2218
msgid "Variables for debian/rules"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2219
msgid ""
"Some variable definitions useful for customizing <emphasis role=\"strong"
"\">debian/rules</emphasis> can be found in files under <emphasis role="
"\"strong\">/usr/share/dpkg/</emphasis>. Notably:"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2222
msgid "<emphasis role=\"strong\">pkg-info.mk</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2226
msgid ""
"<emphasis role=\"strong\">DEB_SOURCE</emphasis>, <emphasis role=\"strong"
"\">DEB_VERSION</emphasis>, <emphasis role=\"strong"
"\">DEB_VERSION_EPOCH_UPSTREAM</emphasis>, <emphasis role=\"strong"
"\">DEB_VERSION_UPSTREAM_REVISION</emphasis>, <emphasis role=\"strong"
"\">DEB_VERSION_UPSTREAM</emphasis>, and <emphasis role=\"strong"
"\">DEB_DISTRIBUTION</emphasis> variables. These are useful for the backport "
"support etc.."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2234
msgid "<emphasis role=\"strong\">vender.mk</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2238
msgid ""
"<emphasis role=\"strong\">DEB_VENDOR</emphasis> and <emphasis role=\"strong"
"\">DEB_PARENT_VENDOR</emphasis> variables; and <emphasis role=\"strong"
"\">dpkg_vendor_derives_from</emphasis> macro. These are useful for the "
"vendor support (Debian, Ubuntu, …)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2246
msgid "<emphasis role=\"strong\">architecture.mk</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2250
msgid ""
"Set <emphasis role=\"strong\">DEB_HOST_</emphasis>* and <emphasis role="
"\"strong\">DEB_BUILD_</emphasis>* variables. Only variables used explicitly "
"in <emphasis role=\"strong\">debian/rules</emphasis> need to be defined "
"using <emphasis role=\"strong\">dpkg-architecture</emphasis>. So there is no "
"need to include <emphasis role=\"strong\">architecture.mk</emphasis> in "
"<emphasis role=\"strong\">debian/rules</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2258
msgid "<emphasis role=\"strong\">buildflags.mk</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2262
msgid ""
"Set <emphasis role=\"strong\">CFLAGS</emphasis>, <emphasis role=\"strong"
"\">CPPFLAGS</emphasis>, <emphasis role=\"strong\">CXXFLAGS</emphasis>, "
"<emphasis role=\"strong\">OBJCFLAGS</emphasis>, <emphasis role=\"strong"
"\">OBJCXXFLAGS</emphasis>, <emphasis role=\"strong\">GCJFLAGS</emphasis>, "
"<emphasis role=\"strong\">FFLAGS</emphasis>, <emphasis role=\"strong"
"\">FCFLAGS</emphasis>, and <emphasis role=\"strong\">LDFLAGS</emphasis> "
"build flags."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2268
msgid ""
"If you wish to use some of these useful variables in <emphasis role=\"strong"
"\">debian/rules</emphasis>, copy relevant codes to <emphasis role=\"strong"
"\">debian/rules</emphasis> or write a simpler alternative in it. Please keep "
"<emphasis role=\"strong\">debian/rules</emphasis> simple."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2269
msgid ""
"For example, you can add an extra option to <emphasis role=\"strong"
"\">CONFIGURE_FLAGS</emphasis> for <emphasis role=\"strong\">linux-any</"
"emphasis> target architectures by adding the followings to <emphasis role="
"\"strong\">debian/rules</emphasis>:"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:2275
msgid ""
"It was useful to include <emphasis role=\"strong\">buildflags.mk</emphasis> "
"in the <emphasis role=\"strong\">debian/rules</emphasis> to set the build "
"flags such as <emphasis role=\"strong\">CPPFLAGS</emphasis>, <emphasis role="
"\"strong\">CFLAGS</emphasis>, <emphasis role=\"strong\">LDFLAGS</emphasis>, "
"etc. properly while honoring <emphasis role=\"strong"
"\">DEB_CFLAGS_MAINT_APPEND</emphasis>, <emphasis role=\"strong"
"\">DEB_BUILD_MAINT_OPTIONS</emphasis>, etc. for the <emphasis role=\"strong"
"\">debhelper</emphasis> “compat &lt;= 8”. Now you should use the <emphasis "
"role=\"strong\">debhelper</emphasis> “compat &gt;= 9”, should not include "
"<emphasis role=\"strong\">buildflags.mk</emphasis> without specific reasons, "
"and should let the <emphasis role=\"strong\">dh</emphasis> command set these "
"build flags."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2276
msgid ""
"See <xref linkend=\"multiarch\"/>, <emphasis role=\"strong\">dpkg-"
"architecture</emphasis>(1) and <emphasis role=\"strong\">dpkg-buildflags</"
"emphasis>(1)."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2279
msgid "Reproducible build"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2280
msgid "Here are some recommendations to attain the reproducible build result."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2283
msgid "Don’t embed the timestamp based on the system time."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2288
msgid ""
"Use “<emphasis role=\"strong\">dh $@</emphasis>” in the <emphasis role="
"\"strong\">debian/rules</emphasis> to access the latest <emphasis role="
"\"strong\">debhelper</emphasis> features."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2293
msgid ""
"Export the build environment as “<emphasis role=\"strong\">LC_ALL=C.UTF-8</"
"emphasis>” (see <xref linkend=\"utf-8-build\"/>)."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2299
msgid "ReproducibleBuilds"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2298
msgid "Read more at <_:ulink-1/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2303
msgid ""
"If the timestamp is needed, please consider to patch the upstream source to "
"obtain the timestamp from the last entry in <emphasis role=\"strong\">debian/"
"changelog</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:2304
msgid "Shell code snippet example to obtain a formatted timestamp string:"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2310
msgid "debian/control"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2311
msgid ""
"The <emphasis role=\"strong\">debian/control</emphasis> file consists of "
"blocks of meta data separated by the blank line. Each block of meta data "
"defines the following in this order:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2314
msgid "meta data for the Debian source package"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2319
msgid "meta data for the Debian binary packages"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2324
msgid ""
"See <_:ulink-1/> of the “Debian Policy Manual” for the definition of each "
"meta data."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2325
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command with the <emphasis "
"role=\"strong\">-b</emphasis> option (see <xref linkend=\"boption\"/>) "
"creates the initial template <emphasis role=\"strong\">debian/control</"
"emphasis> file with followings:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2328
msgid ""
"a set of <emphasis role=\"strong\">Package</emphasis> stanzas defining the "
"split of the Debian binary packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2333
msgid "a basic set of substvar used in each pertinent stanza"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2339
msgid "Split of the Debian binary package"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2340
msgid ""
"For well behaving build systems, the split of the Debian binary package into "
"small ones can be realized as follows."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2343
msgid ""
"Create binary package entries for all binary packages in the <emphasis role="
"\"strong\">debian/control</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2348
msgid ""
"List all file paths (relative to <emphasis role=\"strong\">debian/tmp</"
"emphasis>) in the corresponding <emphasis role=\"strong\">debian/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">."
"install</emphasis> files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2353
msgid "Please check examples in this guide:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2356
msgid "<xref linkend=\"autotools-multi\"/> (Autotools based)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2361
msgid "<xref linkend=\"cmake-multi\"/> (CMake based)"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2368
msgid "Substvar"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2369
msgid "variable substitutions mechanism"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2369
msgid ""
"The <emphasis role=\"strong\">debian/control</emphasis> file also defines "
"the package dependency in which the <_:ulink-1/> (substvar) may be used to "
"free package maintainers from chores of tracking most of the simple package "
"dependency cases. See <emphasis role=\"strong\">deb-substvars</emphasis>(5)."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2370
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command supports following "
"substvars."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2373
msgid ""
"<emphasis role=\"strong\">${misc:Depends}</emphasis> for all binary packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2378
msgid ""
"<emphasis role=\"strong\">${misc:Pre-Depends}</emphasis> for all multiarch "
"packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2383
msgid ""
"<emphasis role=\"strong\">${shlibs:Depends}</emphasis> for all binary "
"executable and library packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2388
msgid ""
"<emphasis role=\"strong\">${python:Depends}</emphasis> for all Python "
"packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2393
msgid ""
"<emphasis role=\"strong\">${python3:Depends}</emphasis> for all Python3 "
"packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2398
msgid ""
"<emphasis role=\"strong\">${perl:Depends}</emphasis> for all Perl packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2403
msgid ""
"<emphasis role=\"strong\">${ruby:Depends}</emphasis> for all Ruby packages"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2408
msgid ""
"For the shared library, required libraries found simply by \"<emphasis role="
"\"strong\">objdump -p</emphasis> <emphasis>/path/to/program</emphasis> "
"<emphasis role=\"strong\">| grep NEEDED</emphasis>\" are covered by the "
"<emphasis role=\"strong\">shlib</emphasis> substvar."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2409
msgid ""
"For the Python and other interpreters, required modules found simply looking "
"for lines with “<emphasis role=\"strong\">import</emphasis>”, “<emphasis "
"role=\"strong\">use</emphasis>”, “<emphasis role=\"strong\">require</"
"emphasis>”, etc., are covered by the corresponding substvar."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2410
msgid ""
"For other programs which do not deploy their own substvar, the <emphasis "
"role=\"strong\">misc</emphasis> substvar covers their dependency."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2411
msgid ""
"For POSIX shell programs, there is no easy way to identify the dependency "
"and no substvar covers their dependency."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2412
msgid "GObject introspection"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2412
msgid ""
"For libraries and modules required via the dynamic loading mechanism "
"including the <_:ulink-1/> mechanism, there is no easy way to identify the "
"dependency and no substvar covers their dependency."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2415
msgid "binNMU safe"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2416
msgid "binNMU"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2416
msgid ""
"For the safe <_:ulink-1/>, the dependency among binary packages from a same "
"source package needs attention if there are both “<emphasis role=\"strong"
"\">Architecture: any</emphasis>” and “<emphasis role=\"strong"
"\">Architecture: all</emphasis>” packages involved in it."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2419
msgid ""
"“<emphasis role=\"strong\">Architecture: any</emphasis>” package depends on "
"“<emphasis role=\"strong\">Architecture: any</emphasis>” <emphasis>foo</"
"emphasis> package"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2424
msgid ""
"<emphasis role=\"strong\">Depends:</emphasis> <emphasis>foo</emphasis> "
"<emphasis role=\"strong\">(== ${binary:Version})</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2431
msgid ""
"“<emphasis role=\"strong\">Architecture: any</emphasis>” package depends on "
"“<emphasis role=\"strong\">Architecture: all</emphasis>” <emphasis>bar</"
"emphasis> package"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2436
msgid ""
"<emphasis role=\"strong\">Depends:</emphasis> <emphasis>bar</emphasis> "
"<emphasis role=\"strong\">(== ${source:Version}</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2443
msgid ""
"“<emphasis role=\"strong\">Architecture: all</emphasis>” package depends on "
"“<emphasis role=\"strong\">Architecture: any</emphasis>” <emphasis>baz</"
"emphasis> package"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2448
msgid ""
"<emphasis role=\"strong\">Depends:</emphasis> <emphasis>baz</emphasis> "
"<emphasis role=\"strong\">(&gt;= ${source:Version})</emphasis>, "
"<emphasis>baz</emphasis> <emphasis role=\"strong\">(&lt;&lt; ${source:"
"Upstream-Version}.0~)</emphasis>"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2457
msgid "The library package name"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2458
msgid ""
"Let’s consider that the upstream source tarball of the <emphasis role="
"\"strong\">lib</emphasis><emphasis>foo</emphasis> library is updated from "
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo-7.0</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> to <emphasis role="
"\"strong\">lib</emphasis><emphasis>foo-8.0</emphasis><emphasis role=\"strong"
"\">.tar.gz</emphasis> with the new SONAME major version which affects other "
"packages."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2459
msgid ""
"The binary library package must be renamed from <emphasis role=\"strong"
"\">lib</emphasis><emphasis>foo7</emphasis> to <emphasis role=\"strong\">lib</"
"emphasis><emphasis>foo8</emphasis> to keep the <emphasis role=\"strong"
"\">unstable</emphasis> suite system working for all dependent packages after "
"the upload of the package based on the <emphasis role=\"strong\">lib</"
"emphasis><emphasis>foo-8.0</emphasis><emphasis role=\"strong\">.tar.gz</"
"emphasis>."
msgstr ""

#. (itstool) path: warning/simpara
#: debmake-doc.en.xml:2460
msgid ""
"If the binary library package isn’t renamed, many dependent packages in the "
"<emphasis role=\"strong\">unstable</emphasis> suite become broken just after "
"the library upload even if the binNMU is requested. The binNMU may not "
"happen immediately after the upload due to several reasons."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2461
msgid ""
"The <emphasis role=\"strong\">-dev</emphasis> package must follow one of the "
"following naming rules:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2464
msgid ""
"Use the <emphasis role=\"strong\">unversioned -dev</emphasis> package name: "
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo</emphasis><emphasis "
"role=\"strong\">-dev</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2469
msgid "This is the normal case."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2474
msgid ""
"Only one version of the library source package is allowed in the archive."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2479
msgid ""
"The associated library package needs to be renamed from <emphasis role="
"\"strong\">lib</emphasis><emphasis>foo7</emphasis> to <emphasis role=\"strong"
"\">lib</emphasis><emphasis>foo8</emphasis> to prevent the dependency "
"breakage in the <emphasis role=\"strong\">unstable</emphasis> archive during "
"the library transition."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2487
msgid "ABI"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2486
msgid ""
"This approach must be used if the simple binNMU resolves the library "
"dependency. (<_:ulink-1/> change)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2492 debmake-doc.en.xml:2541
msgid "API"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2491
msgid ""
"This approach is still a good idea if manual code updates, etc. can be "
"coordinated. (<_:ulink-1/> change)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2498
msgid ""
"Use the <emphasis role=\"strong\">versioned -dev</emphasis> package names: "
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo7</emphasis><emphasis "
"role=\"strong\">-dev</emphasis> and <emphasis role=\"strong\">lib</"
"emphasis><emphasis>foo8</emphasis><emphasis role=\"strong\">-dev</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2503
msgid "This is the special case."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2508
msgid ""
"Two versions of the library source packages are allowed simultaneously in "
"the archive."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2513
msgid ""
"Make all dependent packages depend on <emphasis role=\"strong\">lib</"
"emphasis><emphasis>foo</emphasis><emphasis role=\"strong\">-dev</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2518
msgid ""
"Make both <emphasis role=\"strong\">lib</emphasis><emphasis>foo7</"
"emphasis><emphasis role=\"strong\">-dev</emphasis> and <emphasis role="
"\"strong\">lib</emphasis><emphasis>foo8</emphasis><emphasis role=\"strong\">-"
"dev</emphasis> provide <emphasis role=\"strong\">lib</"
"emphasis><emphasis>foo</emphasis><emphasis role=\"strong\">-dev</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2523
msgid ""
"The source package needs to be renamed as <emphasis role=\"strong\">lib</"
"emphasis><emphasis>foo7-7.0</emphasis><emphasis role=\"strong\">.tar.gz</"
"emphasis> and <emphasis role=\"strong\">lib</emphasis><emphasis>foo8-8.0</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> respectively from "
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo-?.0</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2528
msgid ""
"The package specific install file path including <emphasis role=\"strong"
"\">lib</emphasis><emphasis>foo7</emphasis> and <emphasis role=\"strong"
"\">lib</emphasis><emphasis>foo8</emphasis> respectively for header files "
"etc. needs to be chosen to make them co-installable."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2535
msgid "Do not use this approach, if possible."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2540
msgid ""
"This approach may be useful if the update of dependent packages require "
"major manual code updates, etc. (<_:ulink-1/> change)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2547
msgid "See <xref linkend=\"lib\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2551
msgid "debmake -b"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2552
msgid ""
"The <emphasis role=\"strong\">-b</emphasis> option of the <emphasis role="
"\"strong\">debmake</emphasis> command provides intuitive and flexible "
"methods to customize packaging parameters in the <emphasis role=\"strong"
"\">debian/control</emphasis> file. It sets the following stanza values."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2555
msgid "<emphasis role=\"strong\">Package:</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#. (itstool) path: row/entry
#: debmake-doc.en.xml:2560 debmake-doc.en.xml:2685
msgid "<emphasis role=\"strong\">Architecture:</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#. (itstool) path: row/entry
#: debmake-doc.en.xml:2565 debmake-doc.en.xml:2686
msgid "<emphasis role=\"strong\">Multi-Arch:</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2570
msgid "<emphasis role=\"strong\">Depends:</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2575
msgid "<emphasis role=\"strong\">Pre-Depends:</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2580
msgid ""
"Let’s quote the pertinent part from the <emphasis role=\"strong\">debmake</"
"emphasis> manpage here."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2584 debmake-doc.en.xml:8176
msgid ""
"<emphasis role=\"strong\">-b</emphasis> \"<emphasis>binarypackage[:type],…</"
"emphasis>\", <emphasis role=\"strong\">--binaryspec</emphasis> "
"\"<emphasis>binarypackage[:type],…</emphasis>\""
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2588 debmake-doc.en.xml:8180
msgid ""
"set binary package specs by the comma separated list of "
"<emphasis>binarypackage:type</emphasis> pairs, e.g., in full form “<emphasis "
"role=\"strong\">foo:bin,foo-doc:doc,libfoo1:lib,libfoo1-dbg:dbg,libfoo-dev:"
"dev</emphasis>” or in short form “<emphasis role=\"strong\">,-doc,libfoo1,"
"libfoo1-dbg, libfoo-dev</emphasis>”."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2591 debmake-doc.en.xml:8183
msgid ""
"Here, <emphasis>binarypackage</emphasis> is the binary package name; and "
"optional <emphasis>type</emphasis> is chosen from the following "
"<emphasis>type</emphasis> values:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2594 debmake-doc.en.xml:8186
msgid ""
"<emphasis role=\"strong\">bin</emphasis>: C/C++ compiled ELF binary code "
"package (any, foreign) (default, alias: <emphasis role=\"strong\">\"\"</"
"emphasis>, i.e., <emphasis>null-string</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2599 debmake-doc.en.xml:8191
msgid ""
"<emphasis role=\"strong\">data</emphasis>: Data (fonts, graphics, …) package "
"(all, foreign) (alias: <emphasis role=\"strong\">da</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2604 debmake-doc.en.xml:8196
msgid ""
"<emphasis role=\"strong\">dbg</emphasis>: Debug symbol package (any, same) "
"(alias: <emphasis role=\"strong\">db</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2609 debmake-doc.en.xml:8201
msgid ""
"<emphasis role=\"strong\">dev</emphasis>: Library development package (any, "
"same) (alias: <emphasis role=\"strong\">de</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2614 debmake-doc.en.xml:8206
msgid ""
"<emphasis role=\"strong\">doc</emphasis>: Documentation package (all, "
"foreign) (alias: <emphasis role=\"strong\">do</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2619 debmake-doc.en.xml:8211
msgid ""
"<emphasis role=\"strong\">lib</emphasis>: Library package (any, same) "
"(alias: <emphasis role=\"strong\">l</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2624 debmake-doc.en.xml:8216
msgid ""
"<emphasis role=\"strong\">perl</emphasis>: Perl script package (all, "
"foreign) (alias: <emphasis role=\"strong\">pl</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2629 debmake-doc.en.xml:8221
msgid ""
"<emphasis role=\"strong\">python</emphasis>: Python script package (all, "
"foreign) (alias: <emphasis role=\"strong\">py</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2634 debmake-doc.en.xml:8226
msgid ""
"<emphasis role=\"strong\">python3</emphasis>: Python3 script package (all, "
"foreign) (alias: <emphasis role=\"strong\">py3</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2639 debmake-doc.en.xml:8231
msgid ""
"<emphasis role=\"strong\">ruby</emphasis>: Ruby script package (all, "
"foreign) (alias: <emphasis role=\"strong\">rb</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2644 debmake-doc.en.xml:8236
msgid ""
"<emphasis role=\"strong\">script</emphasis>: Shell script package (all, "
"foreign) (alias: <emphasis role=\"strong\">sh</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2649 debmake-doc.en.xml:8241
msgid ""
"The pair values in the parentheses, such as (any, foreign), are the "
"<emphasis role=\"strong\">Architecture</emphasis> and <emphasis role=\"strong"
"\">Multi-Arch</emphasis> stanza values set in the <emphasis role=\"strong"
"\">debian/control</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2650 debmake-doc.en.xml:8242
msgid ""
"In many cases, the <emphasis role=\"strong\">debmake</emphasis> command "
"makes good guesses for <emphasis>type</emphasis> from "
"<emphasis>binarypackage</emphasis>. If <emphasis>type</emphasis> is not "
"obvious, <emphasis>type</emphasis> is set to <emphasis role=\"strong\">bin</"
"emphasis>. For example, <emphasis role=\"strong\">libfoo</emphasis> sets "
"<emphasis>type</emphasis> to <emphasis role=\"strong\">lib</emphasis>, and "
"<emphasis role=\"strong\">font-bar</emphasis> sets <emphasis>type</emphasis> "
"to <emphasis role=\"strong\">data</emphasis>, …"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2651 debmake-doc.en.xml:8243
msgid ""
"If the source tree contents do not match settings for <emphasis>type</"
"emphasis>, <emphasis role=\"strong\">debmake</emphasis> warns you."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2656
msgid ""
"Here are some typical multiarch package split scenarios for the following "
"upstream source examples:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2659
msgid ""
"a library source <emphasis>libfoo-1.0</emphasis><emphasis role=\"strong\">."
"tar.gz</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2664
msgid ""
"a tool source <emphasis>bar-1.0</emphasis><emphasis role=\"strong\">.tar.gz</"
"emphasis> written in a compiled language"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2669
msgid ""
"a tool source <emphasis>baz-1.0</emphasis><emphasis role=\"strong\">.tar.gz</"
"emphasis> written in an interpreted language"
msgstr ""

#. (itstool) path: row/entry
#: debmake-doc.en.xml:2683
msgid "<emphasis>binarypackage</emphasis>"
msgstr ""

#. (itstool) path: row/entry
#: debmake-doc.en.xml:2684
msgid "<emphasis>type</emphasis>"
msgstr ""

#. (itstool) path: row/entry
#: debmake-doc.en.xml:2687
msgid "Package content"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2692
msgid "<emphasis role=\"strong\">lib</emphasis><emphasis>foo1</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2693
msgid "<emphasis role=\"strong\">lib</emphasis><superscript>*</superscript>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2694 debmake-doc.en.xml:2701 debmake-doc.en.xml:2708
#: debmake-doc.en.xml:2715 debmake-doc.en.xml:2729
msgid "any"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2695 debmake-doc.en.xml:2702 debmake-doc.en.xml:2709
msgid "same"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2696
msgid "the shared library, co-installable"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2699
msgid ""
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo1</emphasis><emphasis "
"role=\"strong\">-dbg</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2700
msgid "<emphasis role=\"strong\">dbg</emphasis><superscript>*</superscript>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2703
msgid "the shared library debug symbols, co-installable"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2706
msgid ""
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo</emphasis><emphasis "
"role=\"strong\">-dev</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2707
msgid "<emphasis role=\"strong\">dev</emphasis><superscript>*</superscript>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2710
msgid "the shared library header files etc., co-installable"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2713
msgid ""
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo</emphasis><emphasis "
"role=\"strong\">-tools</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2714 debmake-doc.en.xml:2728
msgid "<emphasis role=\"strong\">bin</emphasis><superscript>*</superscript>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2716 debmake-doc.en.xml:2723 debmake-doc.en.xml:2730
#: debmake-doc.en.xml:2737 debmake-doc.en.xml:2744
msgid "foreign"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2717
msgid "the run-time support programs, not co-installable"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2720
msgid ""
"<emphasis role=\"strong\">lib</emphasis><emphasis>foo</emphasis><emphasis "
"role=\"strong\">-doc</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2721 debmake-doc.en.xml:2735
msgid "<emphasis role=\"strong\">doc</emphasis><superscript>*</superscript>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2722 debmake-doc.en.xml:2736 debmake-doc.en.xml:2743
msgid "all"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2724
msgid "the shared library documentation files"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2727
msgid "<emphasis>bar</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2731
msgid "the compiled program files, not co-installable"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2734
msgid "<emphasis>bar</emphasis><emphasis role=\"strong\">-doc</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2738
msgid "the documentation files for the program"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2741
msgid "<emphasis>baz</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2742
msgid "<emphasis role=\"strong\">script</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:2745
msgid "the interpreted program files"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:2750
msgid ""
"The binary package name starting with a “<emphasis role=\"strong\">-</"
"emphasis>” (hyphen) is treated as the abbreviated name. The real binary "
"package name is generated by attaching it to the source package name."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2751
msgid ""
"For the cases marked with <superscript>*</superscript> in the above table, "
"the <emphasis>type</emphasis> values are guessed right from the package "
"names."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2752
msgid ""
"The default type is the <emphasis role=\"strong\">bin</emphasis> type which "
"means the compiled ELF binary executables. This is why the example in <xref "
"linkend=\"simple\"/> does not specify <emphasis role=\"strong\">-b</"
"emphasis> option."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2753
msgid ""
"For programs written in other compiled languages, you may need to add its "
"run-time library package dependency to the resulting binary package by "
"adjusting the <emphasis role=\"strong\">Depends:</emphasis> stanza of the "
"<emphasis role=\"strong\">debian/control</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2754
msgid ""
"The development package for the shared library should depend on it and "
"should contain a version numberless symlink to it. E.g.: <emphasis role="
"\"strong\">/usr/lib/x86_64-linux-gnu/</emphasis><emphasis>libfoo</"
"emphasis><emphasis role=\"strong\">.so</emphasis> → <emphasis>libfoo</"
"emphasis><emphasis role=\"strong\">.so.</emphasis><emphasis>1</emphasis>"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:2755
msgid ""
"The <emphasis role=\"strong\">dbg</emphasis> type package can be made either "
"one-on-one for each <emphasis role=\"strong\">bin</emphasis> and <emphasis "
"role=\"strong\">lib</emphasis> type package or one-on-all for all <emphasis "
"role=\"strong\">bin</emphasis> and <emphasis role=\"strong\">lib</emphasis> "
"type packages."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2758
msgid "debian/changelog"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2759
msgid ""
"The <emphasis role=\"strong\">debian/changelog</emphasis> file records the "
"Debian package history and defines the upstream package version and the "
"Debian revision in its first line."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2760
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command creates the initial "
"template file with the upstream package version and the Debian revision. The "
"distribution is set to <emphasis role=\"strong\">UNRELEASED</emphasis> to "
"prevent accidental upload to the Debian archive."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2761
msgid ""
"The <emphasis role=\"strong\">debchange</emphasis> command (alias <emphasis "
"role=\"strong\">dch</emphasis>) is used to edit this."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:2762
msgid ""
"The date string used in the <emphasis role=\"strong\">debian/changelog</"
"emphasis> file can be manually generated by “<emphasis role=\"strong"
"\">LC_ALL=C date -R</emphasis>”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2763
msgid ""
"This is installed in the <emphasis role=\"strong\">/usr/share/doc/</"
"emphasis><emphasis>binarypackage</emphasis> directory as <emphasis role="
"\"strong\">changelog.Debian.gz</emphasis> by the <emphasis role=\"strong"
"\">dh_installchangelogs</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2764
msgid ""
"The upstream changelog is installed in the <emphasis role=\"strong\">/usr/"
"share/doc/</emphasis><emphasis>binarypackage</emphasis> directory as "
"<emphasis role=\"strong\">changelog.gz</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2765
msgid ""
"The upstream changelog is automatically found by the <emphasis role=\"strong"
"\">dh_installchangelogs</emphasis> using the case insensitive match of its "
"file name to <emphasis role=\"strong\">changelog</emphasis>, <emphasis role="
"\"strong\">changes</emphasis>, <emphasis role=\"strong\">changelog.txt</"
"emphasis>, <emphasis role=\"strong\">changes.txt</emphasis>, <emphasis role="
"\"strong\">history</emphasis>, <emphasis role=\"strong\">history.txt</"
"emphasis>, or <emphasis role=\"strong\">changelog.md</emphasis> and searched "
"in the <emphasis role=\"strong\">./</emphasis> <emphasis role=\"strong\">doc/"
"</emphasis>, or <emphasis role=\"strong\">docs/</emphasis> directories."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:2766
msgid ""
"If you are using the <emphasis role=\"strong\">vim</emphasis> editor, make "
"sure to save this with the “<emphasis role=\"strong\">:wq</emphasis>” "
"command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2766
msgid ""
"After finishing your packaging and verifying its quality, please execute the "
"“<emphasis role=\"strong\">dch -r</emphasis>” and save the finalized "
"<emphasis role=\"strong\">debian/changelog</emphasis> file with the "
"distribution normally set to <emphasis role=\"strong\">unstable</emphasis>. "
"<_:footnote-1/> If you are packaging for the backports, security updates, "
"LTS, etc., please use the appropriate distribution names, instead."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2769
msgid "debian/copyright"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2770
msgid ""
"Debian takes the copyright and license matters very seriously. The “Debian "
"Policy Manual” enforces to have summary of them in the <emphasis role="
"\"strong\">debian/copyright</emphasis> file in the package."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2771
msgid "machine-readable debian/copyright file"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2771
msgid "You should format it as the <_:ulink-1/> (DEP-5)."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:2772
msgid ""
"The <emphasis role=\"strong\">debian/copyright</emphasis> file should be "
"sorted to keep the generic file patterns at the top of the list. See <xref "
"linkend=\"koption\"/>."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:2773
msgid ""
"The <emphasis role=\"strong\">licensecheck</emphasis> command from the "
"<emphasis role=\"strong\">devscripts</emphasis> package was referenced to "
"make this internal checker."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2773
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command creates the initial "
"DEP-5 compatible template file by scanning the entire source tree. It uses "
"an internal license checker to classify each license text. <_:footnote-1/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2774
msgid ""
"Unless specifically requested to be pedantic with the <emphasis role=\"strong"
"\">-P</emphasis> option, the <emphasis role=\"strong\">debmake</emphasis> "
"command skips reporting for auto-generated files with permissive licenses to "
"be practical."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:2775
msgid ""
"If you find issues with this license checker, please file a bug report to "
"the <emphasis role=\"strong\">debmake</emphasis> package with the "
"problematic part of text containing the copyright and license."
msgstr ""

#. (itstool) path: section/title
#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2778 debmake-doc.en.xml:2779 debmake-doc.en.xml:2780
msgid "DFSG"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2779
msgid "Debian takes software freedom seriously and follows the <_:ulink-1/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2780
msgid ""
"The non-<_:ulink-1/> components in the upstream source tarball can be easily "
"removed when the <emphasis role=\"strong\">uscan</emphasis> command is used "
"to update the Debian package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2783
msgid ""
"List the files to be removed in the <emphasis role=\"strong\">Files-"
"Excluded</emphasis> stanza of the <emphasis role=\"strong\">debian/"
"copyright</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2788
msgid ""
"List the URL to download the upstream tarball in the <emphasis role=\"strong"
"\">debian/watch</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2793
msgid ""
"Run the <emphasis role=\"strong\">uscan</emphasis> command to download the "
"new upstream tarball."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2798
msgid ""
"Alternatively, use the “<emphasis role=\"strong\">gbp import-orig --uscan --"
"pristine-tar</emphasis>” command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2805
msgid ""
"The resulting tarball has the version number with an additional suffix "
"<emphasis role=\"strong\">+dfsg</emphasis>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:2812
msgid "Other debian/*"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:2813
msgid ""
"Optional configuration files may be added under the <emphasis role=\"strong"
"\">debian/</emphasis> directory. Most of them are to control <emphasis role="
"\"strong\">dh_</emphasis>* commands offered by the <emphasis role=\"strong"
"\">debhelper</emphasis> package but there are some for <emphasis role="
"\"strong\">lintian</emphasis> and <emphasis role=\"strong\">gbp</emphasis> "
"commands. Here is the alphabetical list of notable optional configuration "
"files."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2816
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.bug-control</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2820
msgid ""
"installed as <emphasis role=\"strong\">usr/share/bug/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">/"
"control</emphasis> in <emphasis>binarypackage</emphasis>. See <xref linkend="
"\"bug\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2826
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.bug-presubj</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2830
msgid ""
"installed as <emphasis role=\"strong\">usr/share/bug/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">/"
"presubj</emphasis> in <emphasis>binarypackage</emphasis>. See <xref linkend="
"\"bug\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2836
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.bug-script</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2840
msgid ""
"installed as <emphasis role=\"strong\">usr/share/bug/</"
"emphasis><emphasis>binarypackage</emphasis> or <emphasis role=\"strong\">usr/"
"share/bug/</emphasis><emphasis>binarypackage</emphasis><emphasis role="
"\"strong\">/script</emphasis> in <emphasis>binarypackage</emphasis>. See "
"<xref linkend=\"bug\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2846
msgid ""
"<emphasis role=\"strong\">clean</emphasis> <superscript><emphasis role="
"\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2850
msgid ""
"List files which should be removed but are not cleaned by the <emphasis role="
"\"strong\">dh_auto_clean</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2853
msgid ""
"See <emphasis role=\"strong\">dh_auto_clean</emphasis>(1) and <emphasis role="
"\"strong\">dh_clean</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2857
msgid ""
"<emphasis role=\"strong\">compat</emphasis> <superscript><emphasis role="
"\"strong\">-x1</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2861
msgid ""
"Set the <emphasis role=\"strong\">debhelper</emphasis> compatibility level "
"(currently, “<emphasis role=\"strong\">9</emphasis>”)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2864
msgid ""
"See “COMPATIBILITY LEVELS” in <emphasis role=\"strong\">debhelper</"
"emphasis>(8)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2868
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.conffile</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2872
msgid ""
"No need for this file under “compat &gt;= 3” since all files in the "
"<emphasis role=\"strong\">etc/</emphasis> directory are conffiles."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2875
msgid "See <emphasis role=\"strong\">dh_installdeb</emphasis>(1)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2876
msgid ""
"If the program you’re packaging requires every user to modify the "
"configuration files in the <emphasis role=\"strong\">/etc</emphasis> "
"directory, there are two popular ways to arrange for them to not be "
"conffiles, keeping the <emphasis role=\"strong\">dpkg</emphasis> command "
"happy and quiet."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2879
msgid ""
"Create a symlink under the <emphasis role=\"strong\">/etc</emphasis> "
"directory pointing to a file under the <emphasis role=\"strong\">/var</"
"emphasis> directory generated by the maintainer scripts."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2884
msgid ""
"Create a file generated by the maintainer scripts under the <emphasis role="
"\"strong\">/etc</emphasis> directory."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2892
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.config</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2896
msgid ""
"This is the <emphasis role=\"strong\">debconf</emphasis> <emphasis role="
"\"strong\">config</emphasis> script used for asking any questions necessary "
"to configure the package. See <xref linkend=\"debconf\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2902
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.cron.hourly</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2906
msgid ""
"Installed into the <emphasis role=\"strong\">etc/cron/hourly/</"
"emphasis><emphasis>binarypackage</emphasis> file in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2909 debmake-doc.en.xml:2920 debmake-doc.en.xml:2931
msgid ""
"See <emphasis role=\"strong\">dh_installcron</emphasis>(1) and <emphasis "
"role=\"strong\">cron</emphasis>(8)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2913
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.cron.daily</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2917
msgid ""
"Installed into the <emphasis role=\"strong\">etc/cron/daily/</"
"emphasis><emphasis>binarypackage</emphasis> file in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2924
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.cron.weekly</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2928
msgid ""
"Installed into the <emphasis role=\"strong\">etc/cron/weekly/</"
"emphasis><emphasis>binarypackage</emphasis> file in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2935
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.cron.monthly</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2939
msgid ""
"Installed into the <emphasis role=\"strong\">etc/cron/monthly/</"
"emphasis><emphasis>binarypackage</emphasis> file in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2942
msgid ""
"See <emphasis role=\"strong\">dh_installcro</emphasis>*(1) and <emphasis "
"role=\"strong\">cron</emphasis>(8)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2946
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.cron.d</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2950
msgid ""
"Installed into the <emphasis role=\"strong\">etc/cron.d/</"
"emphasis><emphasis>binarypackage</emphasis> file in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2953
msgid ""
"See <emphasis role=\"strong\">dh_installcron</emphasis>(1), <emphasis role="
"\"strong\">cron</emphasis>(8), and <emphasis role=\"strong\">crontab</"
"emphasis>(5)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2957
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.default</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2961
msgid ""
"If this exists, it is installed into <emphasis role=\"strong\">etc/default/</"
"emphasis><emphasis>binarypackage</emphasis> in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2964 debmake-doc.en.xml:3086
msgid "See <emphasis role=\"strong\">dh_installinit</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2968
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.dirs</emphasis> "
"<superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2972
msgid "List directories to be created in <emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2975
msgid "See <emphasis role=\"strong\">dh_installdirs</emphasis>(1)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2976
msgid ""
"Usually, this is not needed since all <emphasis role=\"strong\">dh_install</"
"emphasis>* commands create required directories automatically. Use this only "
"when you run into trouble."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2980
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.doc-base</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2984
msgid ""
"Installed as the <emphasis role=\"strong\">doc-base</emphasis> control file "
"in <emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:2987
msgid "Debian doc-base Manual"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2987
msgid ""
"See <emphasis role=\"strong\">dh_installdocs</emphasis>(1) and <_:ulink-1/> "
"provided by the <emphasis role=\"strong\">doc-base</emphasis> package."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:2991
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.docs</emphasis> "
"<superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2995
msgid ""
"List documentation files to be installed in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:2998 debmake-doc.en.xml:3230 debmake-doc.en.xml:3340
msgid "See <emphasis role=\"strong\">dh_installdocs</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3002
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.emacsen-compat</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3006
msgid ""
"Installed into <emphasis role=\"strong\">usr/lib/emacsen-common/packages/"
"compat/</emphasis><emphasis>binarypackage</emphasis> in "
"<emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3009 debmake-doc.en.xml:3020 debmake-doc.en.xml:3031
#: debmake-doc.en.xml:3042
msgid "See <emphasis role=\"strong\">dh_installemacsen</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3013
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.emacsen-"
"install</emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></"
"superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3017
msgid ""
"Installed into <emphasis role=\"strong\">usr/lib/emacsen-common/packages/"
"install/</emphasis><emphasis>binarypackage</emphasis> in "
"<emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3024
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.emacsen-remove</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3028
msgid ""
"Installed into <emphasis role=\"strong\">usr/lib/emacsen-common/packages/"
"remove/</emphasis><emphasis>binarypackage</emphasis> in "
"<emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3035
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.emacsen-"
"startup</emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></"
"superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3039
msgid ""
"Installed into <emphasis role=\"strong\">usr/lib/emacsen-common/packages/"
"startup/</emphasis><emphasis>binarypackage</emphasis> in "
"<emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3046
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.examples</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3050
msgid ""
"List example files or directories to be installed into <emphasis role="
"\"strong\">usr/share/doc/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">/examples/</emphasis> in "
"<emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3053
msgid "See <emphasis role=\"strong\">dh_installexamples</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3057
msgid "<emphasis role=\"strong\">gbp.conf</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3061
msgid ""
"If this exists, it functions as the configuration file for the <emphasis "
"role=\"strong\">gbp</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3064
msgid ""
"See <emphasis role=\"strong\">gbp.conf</emphasis>(5), <emphasis role=\"strong"
"\">gbp</emphasis>(1), and <emphasis role=\"strong\">git-buildpackage</"
"emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3068
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.info</emphasis> "
"<superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3072
msgid "List info files to be installed in <emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3075
msgid "See <emphasis role=\"strong\">dh_installinfo</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3079
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.init</emphasis> "
"<superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3083
msgid ""
"Installed into <emphasis role=\"strong\">etc/init.d/</"
"emphasis><emphasis>binarypackage</emphasis> in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3090
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.install</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3094
msgid ""
"List files which should be installed but are not installed by the <emphasis "
"role=\"strong\">dh_auto_install</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3097
msgid ""
"See <emphasis role=\"strong\">dh_install</emphasis>(1) and <emphasis role="
"\"strong\">dh_auto_install</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3101
msgid ""
"<emphasis role=\"strong\">license-examples/</emphasis>* "
"<superscript><emphasis role=\"strong\">-x4</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3105
msgid ""
"These are copyright file examples generated by the <emphasis role=\"strong"
"\">debmake</emphasis> command. Use these as the reference for making "
"<emphasis role=\"strong\">copyright</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3108
msgid "Please make sure to erase these files."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3112
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.links</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3116
msgid ""
"List pairs of source and destination files to be symlinked. Each pair should "
"be put on its own line, with the source and destination separated by the "
"whitespace."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3119
msgid "See <emphasis role=\"strong\">dh_link</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3123
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.lintian-"
"overrides</emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></"
"superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3127
msgid ""
"Installed into <emphasis role=\"strong\">usr/share/lintian/overrides/</"
"emphasis><emphasis>binarypackage</emphasis> in the package build directory. "
"This file is used to suppress erroneous <emphasis role=\"strong\">lintian</"
"emphasis> diagnostics."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3130 debmake-doc.en.xml:3276
msgid ""
"See <emphasis role=\"strong\">dh_lintian</emphasis>(1) and <emphasis role="
"\"strong\">lintian</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3134
msgid ""
"<emphasis role=\"strong\">manpage.</emphasis>* <superscript><emphasis role="
"\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3138
msgid ""
"These are manpage template files generated by the <emphasis role=\"strong"
"\">debmake</emphasis> command. Please rename these to appropriate file names "
"and update their contents."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3141
msgid ""
"Debian Policy requires that each program, utility, and function should have "
"an associated manual page included in the same package. Manual pages are "
"written in <emphasis role=\"strong\">nroff</emphasis>(1)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3142
msgid ""
"If you are new to making manpage, use <emphasis role=\"strong\">manpage."
"asciidoc</emphasis> or <emphasis role=\"strong\">manpage.1</emphasis> as the "
"starting point."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3146
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.manpages</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3150
msgid "List man pages to be installed."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3153
msgid "See <emphasis role=\"strong\">dh_installman</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3157
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.menu</emphasis> "
"<superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3161
msgid ""
"Debian menu file installed into <emphasis role=\"strong\">usr/share/menu/</"
"emphasis><emphasis>binarypackage</emphasis> in <emphasis>binarypackage</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3164
msgid ""
"See <emphasis role=\"strong\">menufile</emphasis>(5) for its format. See "
"<emphasis role=\"strong\">dh_installmenu</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3168
msgid "<emphasis role=\"strong\">NEWS</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3172
msgid ""
"Installed into <emphasis role=\"strong\">usr/share/doc/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">/NEWS."
"Debian</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3175
msgid "See <emphasis role=\"strong\">dh_installchangelogs</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3179
msgid "<emphasis role=\"strong\">patches/</emphasis>*"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3183
msgid ""
"Collection of <emphasis role=\"strong\">-p1</emphasis> patch files which are "
"applied to the upstream source before building the source."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3186
msgid ""
"See dpkg-source(8), <xref linkend=\"quilt-setup\"/> and <xref linkend=\"alt-"
"patch\"/>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3187
msgid ""
"No patch files are generated by the <emphasis role=\"strong\">debmake</"
"emphasis> command."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3191
msgid ""
"<emphasis role=\"strong\">patches/series</emphasis> <superscript><emphasis "
"role=\"strong\">-x1</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3195
msgid ""
"The application sequence of the <emphasis role=\"strong\">patches/</"
"emphasis>* patch files."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3201
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.preinst</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3204
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.postinst</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3207
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.prerm</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3210
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.postrm</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3214
msgid ""
"These maintainer scripts are installed into the <emphasis role=\"strong"
"\">DEBIAN</emphasis> directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3217
msgid ""
"Inside the scripts, the token <emphasis role=\"strong\">#DEBHELPER#</"
"emphasis> is replaced with shell script snippets generated by other "
"<emphasis role=\"strong\">debhelper</emphasis> commands."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3218
msgid "Chapter 6 - Package maintainer scripts and installation procedure"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3218
msgid ""
"See <emphasis role=\"strong\">dh_installdeb</emphasis>(1) and <_:ulink-1/> "
"of the “Debian Policy Manual”."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3219 debmake-doc.en.xml:4271
msgid "3.9.1 Prompting in maintainer scripts"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3219
msgid ""
"See also <emphasis role=\"strong\">debconf-devel</emphasis>(7) and <_:"
"ulink-1/> of the “Debian Policy Manual”."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3223
msgid ""
"<emphasis role=\"strong\">README.Debian</emphasis> <superscript><emphasis "
"role=\"strong\">-x1</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3227
msgid ""
"Installed into the first binary package listed in the <emphasis role=\"strong"
"\">debian/control</emphasis> file as <emphasis role=\"strong\">usr/share/doc/"
"</emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">/"
"README.Debian</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3231
msgid "This file provides the information specific to the Debian package."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3235
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.service</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3239
msgid ""
"If this exists, it is installed into <emphasis role=\"strong\">lib/systemd/"
"system/</emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong"
"\">.service</emphasis> in <emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3242 debmake-doc.en.xml:3351
msgid ""
"See <emphasis role=\"strong\">dh_systemd_enable</emphasis>(1), <emphasis "
"role=\"strong\">dh_systemd_start</emphasis>(1), and <emphasis role=\"strong"
"\">dh_installinit</emphasis>(1)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3246
msgid ""
"<emphasis role=\"strong\">source/format</emphasis> <superscript><emphasis "
"role=\"strong\">-x1</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3250
msgid "The Debian package format."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3255
msgid ""
"Use “<emphasis role=\"strong\">3.0 (quilt)</emphasis>” to make this non-"
"native package (recommended)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3260
msgid ""
"Use “<emphasis role=\"strong\">3.0 (native)</emphasis>” to make this native "
"package"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3263
msgid ""
"See “SOURCE PACKAGE FORMATS” in <emphasis role=\"strong\">dpkg-source</"
"emphasis>(8)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3269
msgid ""
"<emphasis role=\"strong\">source/lintian-overrides</emphasis> or <emphasis "
"role=\"strong\">source.lintian-overrides</emphasis> <superscript><emphasis "
"role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3273
msgid ""
"These files are not installed, but will be scanned by the <emphasis role="
"\"strong\">lintian</emphasis> command to provide overrides for the source "
"package."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3280
msgid ""
"<emphasis role=\"strong\">source/local-options</emphasis> "
"<superscript><emphasis role=\"strong\">-x1</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3284
msgid ""
"This is not included in the generated source package but committed to the "
"VCS for its smooth operation."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3287 debmake-doc.en.xml:3298
msgid ""
"See “FILE FORMATS” in <emphasis role=\"strong\">dpkg-source</emphasis>(8)."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3291
msgid "<emphasis role=\"strong\">source/options</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3295
msgid ""
"See the <emphasis role=\"strong\">dpkg-source</emphasis>(1) manpage under "
"\"FILE FORMATS\" to learn about the package formats and the patch mechanisms."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3302
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.symbols</"
"emphasis> <superscript><emphasis role=\"strong\">-x2</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3306
msgid ""
"The symbols files, if present, are passed to the <emphasis role=\"strong"
"\">dpkg-gensymbols</emphasis> command to be processed and installed."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3309
msgid ""
"See <emphasis role=\"strong\">dh_makeshlibs</emphasis>(1) and <xref linkend="
"\"symbols\"/>.."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3313
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.templates</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3317
msgid ""
"This is the <emphasis role=\"strong\">debconf</emphasis> <emphasis role="
"\"strong\">templates</emphasis> file used for asking any questions necessary "
"to configure the package. See <xref linkend=\"debconf\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3323
msgid "<emphasis role=\"strong\">tests/control</emphasis>"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3328 debmake-doc.en.xml:4275
msgid "DEP-8"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3327
msgid ""
"This is the RFC822-style test metadata file defined in <_:ulink-1/>. See "
"<emphasis role=\"strong\">adt-run</emphasis>(1) and <xref linkend=\"ci\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3333
msgid "<emphasis role=\"strong\">TODO</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3337
msgid ""
"Installed into the first binary package listed in the <emphasis role=\"strong"
"\">debian/control</emphasis> file as <emphasis role=\"strong\">usr/share/doc/"
"</emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">/TODO."
"Debian</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3344
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.tmpfile</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3348
msgid ""
"If this exists, it is installed into <emphasis role=\"strong\">usr/lib/"
"tmpfiles.d/</emphasis><emphasis>binarypackage</emphasis><emphasis role="
"\"strong\">.conf</emphasis> in <emphasis>binarypackage</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3355
msgid ""
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.upstart</"
"emphasis> <superscript><emphasis role=\"strong\">-x3</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3359
msgid ""
"If this exists, it is installed into etc/init/package.conf in the package "
"build directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3362
msgid ""
"See <emphasis role=\"strong\">dh_installinit</emphasis>(1) and <xref linkend="
"\"emptypkg\"/>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:3366
msgid ""
"<emphasis role=\"strong\">watch</emphasis> <superscript><emphasis role="
"\"strong\">-x1</emphasis></superscript>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3370
msgid ""
"The control file for the <emphasis role=\"strong\">uscan</emphasis> command "
"to download the latest upstream version"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3373
msgid ""
"This control file may be configured to verify the authenticity of the "
"tarball using its GPG signature (see <xref linkend=\"signing-key\"/>)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3374
msgid ""
"See <xref linkend=\"dfsg\"/> and <emphasis role=\"strong\">uscan</"
"emphasis>(1)."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3378
msgid "Here are a few reminders to the above list."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3381
msgid ""
"For the single binary package, <emphasis>binarypackage</emphasis><emphasis "
"role=\"strong\">.</emphasis> part of the filename in the list may be removed."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3386
msgid ""
"For the multi binary package, configuration file missing "
"<emphasis>binarypackage</emphasis><emphasis role=\"strong\">.</emphasis> "
"part of the filename is applied to the first binary package listed in the "
"<emphasis role=\"strong\">debian/control</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3391
msgid ""
"When there are many binary packages, their configurations can be specified "
"independently by prefixing their name to their configuration filenames such "
"as <emphasis>package-1</emphasis><emphasis role=\"strong\">.install</"
"emphasis>, <emphasis>package-2</emphasis><emphasis role=\"strong\">.install</"
"emphasis>, etc."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3396
msgid ""
"Configuration template filenames with <superscript><emphasis role=\"strong"
"\">-x1</emphasis></superscript>, <superscript><emphasis role=\"strong\">-x2</"
"emphasis></superscript>, <superscript><emphasis role=\"strong\">-x3</"
"emphasis></superscript>, or <superscript><emphasis role=\"strong\">-x4</"
"emphasis></superscript> in the above mean that they are generated by the "
"<emphasis role=\"strong\">debmake</emphasis> command with that <emphasis "
"role=\"strong\">-x</emphasis> option (see <xref linkend=\"xoption\"/>)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3401
msgid ""
"Some template configuration files may not be created by the <emphasis role="
"\"strong\">debmake</emphasis> command. In such cases, you need to create "
"them with an editor."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3406
msgid ""
"Unusual configuration template files generated by the <emphasis role=\"strong"
"\">debmake</emphasis> command with the extra <emphasis role=\"strong\">.ex</"
"emphasis> suffix needs to be activated by removing that suffix."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3411
msgid ""
"Unused configuration template files generated by the <emphasis role=\"strong"
"\">debmake</emphasis> command should be removed."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3416
msgid ""
"Copy configuration template files as needed to the filenames matching their "
"pertinent binary package names."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3423
msgid "signing-key.pgp"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3424
msgid "Some packages are signed by the GPG key."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3425
msgid "GNU hello"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3425
msgid "http://ftp.gnu.org/gnu/hello/"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3425
msgid ""
"For example, <_:ulink-1/> can be downloaded via HTTP from <_:ulink-2/> . "
"There are sets of files:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3428
msgid ""
"<emphasis role=\"strong\">hello-</emphasis><emphasis>version</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> (upstream source)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3433
msgid ""
"<emphasis role=\"strong\">hello-</emphasis><emphasis>version</"
"emphasis><emphasis role=\"strong\">.tar.gz.sig</emphasis> (detached "
"signature)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3438
msgid "Let’s pick the latest version set."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3446
msgid "web of trust"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3446
msgid ""
"If you know the public GPG key of the upstream from the mailing list, use it "
"as the <emphasis role=\"strong\">debian/upstream/signing-key.pgp</emphasis> "
"file. Otherwise, use the hkp keyserver and check it via your <_:ulink-1/>."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:3458
msgid ""
"If your network environment blocks access to the HPK port <emphasis role="
"\"strong\">11371</emphasis>, use “<emphasis role=\"strong\">hkp://keyserver."
"ubuntu.com:80</emphasis>” instead."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3459
msgid ""
"After confirming the key ID <emphasis role=\"strong\">80EE4A00</emphasis> is "
"trust worthy one, download its public key into the <emphasis role=\"strong"
"\">debian/upstream/signing-key.pgp</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3461
msgid ""
"Then set the corresponding <emphasis role=\"strong\">debian/watch</emphasis> "
"file as follows."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3464
msgid ""
"Now the <emphasis role=\"strong\">uscan</emphasis> command will check the "
"authenticity of the package using the GPG signature."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3467
msgid "Package customization"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3468
msgid ""
"Some upstream sources do not behave well and you may need to add "
"customization to the build system of those upstream sources."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3469
msgid ""
"The package should be customized by the least invasive way to address the "
"root cause of the Debian packaging problem. Your packaging shall be more "
"robust for the future upgrades in this way. (You should also solve the root "
"cause of the problem and send its patch to the upstream.)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3470
msgid ""
"Here, there are a few technical approaches to customize the build system:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3473
msgid "<emphasis role=\"strong\">debian/rules</emphasis> approach"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3478
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>bianrypackage</"
"emphasis>.* approach"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3483
msgid "<emphasis role=\"strong\">patches/</emphasis>* approach"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3489
msgid "debian/rules approach"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3490
msgid ""
"The customization to the Debian package build system can be done through the "
"<emphasis role=\"strong\">debian/rules</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3491
msgid "See <xref linkend=\"customrules\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3494
msgid "debian/binarypackage.* approach"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3495
msgid ""
"Add customized configuration files for the <emphasis role=\"strong\">dh_</"
"emphasis>* command from the <emphasis role=\"strong\">debhelper</emphasis> "
"package in the <emphasis role=\"strong\">debian/</emphasis> directory."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3496
msgid "See <xref linkend=\"debianconf\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3499
msgid "patches/* approach"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3500
msgid ""
"Modifications to the upstream source before building it can be done by "
"placing the collection of the <emphasis role=\"strong\">-p1</emphasis> "
"patches in the <emphasis role=\"strong\">patches/</emphasis> directory and "
"applying them in sequence defined in the <emphasis role=\"strong\">patches/"
"series</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3501
msgid ""
"There are several methods to prepare the required <emphasis role=\"strong\">-"
"p1</emphasis> patches for this."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3504
msgid "The <emphasis role=\"strong\">diff</emphasis> command (manual)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3509
msgid ""
"The “<emphasis role=\"strong\">git format-patches</emphasis>” command "
"(manual for the git repository)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3514
msgid ""
"The <emphasis role=\"strong\">dquilt</emphasis> command (manual, elegant) "
"(alias of the <emphasis role=\"strong\">quilt</emphasis> command, see <xref "
"linkend=\"quilt-setup\"/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3519
msgid ""
"The <emphasis role=\"strong\">gbp-pq</emphasis> command (specialized, simple)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3524
msgid ""
"The <emphasis role=\"strong\">git-dpm</emphasis> command (specialized, "
"elegant)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3529
msgid "Patches used in other distros and floating on the mailing list"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3539
msgid "DEP-3"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3539
msgid ""
"Wherever these patches come from, it is good idea to tag them with <_:"
"ulink-1/> compatible header."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3540
msgid ""
"These patches should apply cleanly. For new upstream releases, you must "
"normalize them by the <emphasis role=\"strong\">dquilt</emphasis> command "
"(see <xref linkend=\"quilt-setup\"/>)."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:3543
msgid ""
"Don’t forget to normalize patches when you upgrade to the new upstream "
"source or import the externally generated patches."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3544
msgid "See <xref linkend=\"alt-patch\"/> for example."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3548
msgid "Upstream build systems"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3549
msgid ""
"Upstream build systems are designed to go through several steps to install "
"generated binary files to the system from the source distribution."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3551
msgid "Autotools"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3552
msgid ""
"Autotools (<emphasis role=\"strong\">autoconf</emphasis> + <emphasis role="
"\"strong\">automake</emphasis>) has 4 steps."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3555
msgid ""
"setup the build system (“<emphasis role=\"strong\">vim configure.ac Makefile."
"am</emphasis>” and “<emphasis role=\"strong\">autoreconf -ivf</emphasis>”)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3560
msgid ""
"configure the build system (“<emphasis role=\"strong\">./configure</"
"emphasis>”)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3565 debmake-doc.en.xml:3622
msgid "build the source tree (“<emphasis role=\"strong\">make</emphasis>”)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3570 debmake-doc.en.xml:3627
msgid ""
"install the binary files (“<emphasis role=\"strong\">make install</"
"emphasis>”)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3575
msgid ""
"The upstream usually performs the step 1 and builds the upstream tarball for "
"distribution using the “<emphasis role=\"strong\">make dist</emphasis>” "
"command. (The generated tarball contains not only the pristine upstream VCS "
"contents but also other generated files.)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3576
msgid ""
"The package maintainer needs to take care steps 2 to 4 at least. This is "
"realized by the “<emphasis role=\"strong\">dh $@ --with autotools-dev</"
"emphasis>” command used in the <emphasis role=\"strong\">debian/rules</"
"emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3577
msgid ""
"The package maintainer may wish to take care all steps 1 to 4. This is "
"realized by the “<emphasis role=\"strong\">dh $@ --with autoreconf</"
"emphasis>” command used in the <emphasis role=\"strong\">debian/rules</"
"emphasis> file. This rebuilds all auto-generated files to the latest version "
"ones and provides better supports for the porting to the newer architectures."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3578
msgid "If you wish to learn more on the Autotools, please see:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3582
msgid "GNU Automake documentation"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3587
msgid "GNU Autoconf documentation"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3592
msgid "Autotools Tutorial"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3597
msgid "Introduction to the autotools (autoconf, automake, and libtool)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3602
msgid "Autotools Mythbuster"
msgstr ""

#. (itstool) path: section/title
#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3608 debmake-doc.en.xml:3638
msgid "CMake"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3609
msgid "CMake has 4 steps."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3612
msgid ""
"setup the build system (“<emphasis role=\"strong\">vim CMakeLists.txt config."
"h.in</emphasis>”)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3617
msgid ""
"configure the build system (“<emphasis role=\"strong\">cmake</emphasis>”)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3632
msgid ""
"The upstream tarball contains no auto-generated files and is generated by "
"the <emphasis role=\"strong\">tar</emphasis> command after the step 1."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3633
msgid "The package maintainer needs to take care steps 2 to 4."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3634
msgid "If you wish to learn more on the CMake, please see:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3643
msgid "CMake tutorial"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3649
msgid "Python distutils"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3650
msgid "Python distutils has 3 steps."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3653
msgid ""
"setup and configure the build system (“<emphasis role=\"strong\">vim setup."
"py</emphasis>”)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3658
msgid ""
"build the source tree (“<emphasis role=\"strong\">python setup.py build</"
"emphasis>”)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3663
msgid ""
"install the binary files (“<emphasis role=\"strong\">python setup.py "
"install</emphasis>”)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3668
msgid ""
"The upstream usually performs the step 1 and builds the upstream tarball for "
"distribution using the “<emphasis role=\"strong\">python setup.py sdist</"
"emphasis>” command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3669
msgid ""
"The package maintainer needs to take care the step 2. This is realized "
"simply by the “<emphasis role=\"strong\">dh $@</emphasis>” command used in "
"the <emphasis role=\"strong\">debian/rules</emphasis> file, after <emphasis "
"role=\"strong\">jessie</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3670
msgid ""
"The situation of other build systems, such as CMake, are very similar to "
"this Python one."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3671
msgid ""
"If you wish to learn more on the Python3 and <emphasis role=\"strong"
"\">distutils</emphasis>, please see:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3675
msgid "Python3"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3680 debmake-doc.en.xml:5779
msgid "distutils"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3687
msgid "Debugging information"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3688
msgid "Chapter 10 - Files"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3688
msgid ""
"The Debian package is built with the debugging information but packaged into "
"the binary package after stripping the debugging information as required by "
"<_:ulink-1/> of the “Debian Policy Manual”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3689
msgid ""
"The debugging information can be packaged separately as the debug package "
"using the “<emphasis role=\"strong\">dh_strip --dbg-package=</"
"emphasis><emphasis>package”</emphasis> command in the <emphasis role=\"strong"
"\">override_dh_strip:</emphasis> target of the <emphasis role=\"strong"
"\">debian/rules</emphasis> file. The name of such debug package normally has "
"the <emphasis role=\"strong\">-dbg</emphasis> suffix."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:3690
msgid ""
"The creation of the <emphasis role=\"strong\">-dbg</emphasis> package is "
"optional. In future, it may be superseded by some new mechanism to provide "
"the debugging information."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3691
msgid ""
"The installation path of the debugging information is as follows to enable "
"auto-loading of it by the <emphasis role=\"strong\">gdb</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3694
msgid ""
"<emphasis role=\"strong\">/usr/lib/debug/.build-id/</"
"emphasis><emphasis>12/3456…</emphasis> (compat&gt;=9, for <emphasis role="
"\"strong\">buildID</emphasis>=<emphasis>123456…</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3699
msgid ""
"<emphasis role=\"strong\">/usr/lib/debug/</emphasis><emphasis>path/to/"
"binary</emphasis> (compat&lt;&lt;9, for <emphasis>/path/to/binary</emphasis>)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3704
msgid "See"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3708
msgid "6.7.9. Best practices for debug packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3707
msgid "<_:ulink-1/> of the “Debian Developer’s Reference”."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3713
msgid "18.2 Debugging Information in Separate Files"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3712
msgid "<_:ulink-1/> of the “Debugging with gdb”"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3717
msgid "<emphasis role=\"strong\">dh_strip</emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3722
msgid "<emphasis role=\"strong\">strip</emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3727
msgid "<emphasis role=\"strong\">readelf</emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3732
msgid "<emphasis role=\"strong\">objcopy</emphasis>(1)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3738
msgid "DebugPackage"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3737 debmake-doc.en.xml:3742 debmake-doc.en.xml:4101
#: debmake-doc.en.xml:4106 debmake-doc.en.xml:4134 debmake-doc.en.xml:4139
msgid "Debian wiki <_:ulink-1/>"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3743
msgid "AutomaticDebugPackages"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3749
msgid "Library package"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3750
msgid ""
"Packaging the library software requires you to perform much more work than "
"usual. Here are some reminders for packaging the library software:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3753
msgid ""
"The library binary package must be named as <xref linkend=\"libnames\"/>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3758
msgid ""
"Debian ships shared library such as <emphasis role=\"strong\">/usr/lib/&lt;"
"triplet&gt;/lib</emphasis><emphasis>foo-0.1</emphasis><emphasis role=\"strong"
"\">.so.</emphasis><emphasis>1.0.0</emphasis> (see <xref linkend=\"multiarch"
"\"/>)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3763
msgid ""
"Debian encourages to use versioned symbols in the shared library (see <xref "
"linkend=\"symbols\"/>)."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3768
msgid ""
"Debian doesn’t ship <emphasis role=\"strong\">*.la</emphasis> libtool "
"library archive files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3773
msgid ""
"Debian discourages to use and ship <emphasis role=\"strong\">*.a</emphasis> "
"static library files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3778
msgid "Before packaging the shared library software, see:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3782
msgid "Chapter 8 - Shared libraries"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3781 debmake-doc.en.xml:3786 debmake-doc.en.xml:4073
msgid "<_:ulink-1/> of the “Debian Policy Manual”"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3787
msgid "10.2 Libraries"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3792
msgid "6.7.2. Libraries"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3791
msgid "<_:ulink-1/> of the “Debian Developer’s Reference”"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3796
msgid "For the historic background study, see:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3800
msgid "Escaping the Dependency Hell"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:3800
msgid ""
"This document was written before the introduction of the <emphasis role="
"\"strong\">symbols</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3804
msgid "This encourages to have versioned symbols in the shared library."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3812
msgid "Debian Library Packaging guide"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3812
msgid "Chapter 6. Development (-DEV) packages"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:3812
msgid ""
"The strong preference to use the SONAME versioned <emphasis role=\"strong\">-"
"dev</emphasis> package names over the single <emphasis role=\"strong\">-dev</"
"emphasis> package name in its <_:ulink-1/> does not seem to be shared by the "
"former ftp-master (Steve Langasek). This document was written before the "
"introduction of the <emphasis role=\"strong\">multiarch</emphasis> system "
"and the <emphasis role=\"strong\">symbols</emphasis> file."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3817
msgid "its announcenent"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3816
msgid "Please read the discussion thread following <_:ulink-1/>, too."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3825
msgid "Multiarch"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3826
msgid ""
"The multiarch support for cross-architecture installation of binary packages "
"(particularly <emphasis role=\"strong\">i386</emphasis> and <emphasis role="
"\"strong\">amd64</emphasis>, but also other combinations) in the <emphasis "
"role=\"strong\">dpkg</emphasis> and <emphasis role=\"strong\">apt</emphasis> "
"packages introduced to Debian <emphasis role=\"strong\">wheezy</emphasis> "
"(7.0, May 2013) demands us to pay extra attention for the packaging."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3827 debmake-doc.en.xml:4131
msgid "You should read the following references in detail."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3830
msgid "Ubuntu wiki (upstream)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3836
msgid "MultiarchSpec"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3842
msgid "Debian wiki (Debian situation)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3848
msgid "Debian multiarch support"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3853
msgid "Multiarch/Implementation"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3859
msgid ""
"The multiarch is enabled by using the <emphasis role=\"strong\">&lt;"
"triplet&gt;</emphasis> value such as <emphasis role=\"strong\">i386-linux-"
"gnu</emphasis> and <emphasis role=\"strong\">x86_64-linux-gnu</emphasis> in "
"the install path of shared libraries as <emphasis role=\"strong\">/usr/lib/"
"&lt;triplet&gt;/</emphasis>, etc.."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3862
msgid ""
"The <emphasis role=\"strong\">&lt;triplet&gt;</emphasis> value required "
"internally by <emphasis role=\"strong\">debhelper</emphasis> scripts is "
"implicitly set in themselves. The maintainer doesn’t need to worry."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3867
msgid ""
"The <emphasis role=\"strong\">&lt;triplet&gt;</emphasis> value used in "
"<emphasis role=\"strong\">override_dh_</emphasis>* target scripts must be "
"explicitly set in the <emphasis role=\"strong\">debian/rules</emphasis> by "
"the maintainer. The <emphasis role=\"strong\">&lt;triplet&gt;</emphasis> "
"value is stored in <emphasis role=\"strong\">$(DEB_HOST_MULTIARCH)</"
"emphasis> variable in the following <emphasis role=\"strong\">debian/rules</"
"emphasis> snippet example:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3877
msgid ""
"See <xref linkend=\"variablesrules\"/> and <emphasis role=\"strong\">dpkg-"
"architecture</emphasis>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3879
msgid "The multiarch library path"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3880 debmake-doc.en.xml:3881
msgid "Filesystem Hierarchy Standard"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3880
msgid "/usr/lib : Libraries for programming and packages"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3880
msgid ""
"Debian policy requires to follow <_:ulink-1/>. Its <_:ulink-2/> states "
"\"<emphasis role=\"strong\">/usr/lib</emphasis> includes object files, "
"libraries, and internal binaries that are not intended to be executed "
"directly by users or shell scripts.\""
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3881
msgid ""
"Debian policy makes an exception to <_:ulink-1/> to use <emphasis role="
"\"strong\">/usr/lib/&lt;triplet&gt;/</emphasis> instead of <emphasis role="
"\"strong\">/usr/lib&lt;qual&gt;/</emphasis> (e.g., <emphasis role=\"strong"
"\">/lib32/</emphasis> and <emphasis role=\"strong\">/lib64/</emphasis>) to "
"support the multiarch library."
msgstr ""

#. (itstool) path: table/title
#: debmake-doc.en.xml:3883
msgid "The multiarch library path options"
msgstr ""

#. (itstool) path: row/entry
#: debmake-doc.en.xml:3890 debmake-doc.en.xml:3940 debmake-doc.en.xml:3978
msgid "Classic path"
msgstr ""

#. (itstool) path: row/entry
#: debmake-doc.en.xml:3891 debmake-doc.en.xml:3941 debmake-doc.en.xml:3979
msgid "i386 multiarch path"
msgstr ""

#. (itstool) path: row/entry
#: debmake-doc.en.xml:3892 debmake-doc.en.xml:3942 debmake-doc.en.xml:3980
msgid "amd64 multiarch path"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3897
msgid "<emphasis role=\"strong\">/lib/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3898
msgid "<emphasis role=\"strong\">/lib/i386-linux-gnu/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3899
msgid "<emphasis role=\"strong\">/lib/x86_64-linux-gnu/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3902
msgid "<emphasis role=\"strong\">/usr/lib/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3903
msgid "<emphasis role=\"strong\">/usr/lib/i386-linux-gnu/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3904
msgid "<emphasis role=\"strong\">/usr/lib/x86_64-linux-gnu/</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3909
msgid ""
"For Autotools based packages under the <emphasis role=\"strong\">debhelper</"
"emphasis> package (compat&gt;=9), this path setting is automatically taken "
"care by the <emphasis role=\"strong\">dh_auto_configure</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3910
msgid ""
"For other packages with non-supported build systems, you need to manually "
"adjust the install path as follows."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3913
msgid ""
"If <emphasis role=\"strong\">./configure</emphasis> is used in the part of "
"<emphasis role=\"strong\">override_dh_auto_configure</emphasis> target in "
"<emphasis role=\"strong\">debian/rules</emphasis>, make sure to replace it "
"with “<emphasis role=\"strong\">dh_auto_configure --</emphasis>” while re-"
"targeting the install path from <emphasis role=\"strong\">/usr/lib/</"
"emphasis> to <emphasis role=\"strong\">/usr/lib/$(DEB_HOST_MULTIARCH)/</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:3918
msgid ""
"Replace all occurrences of <emphasis role=\"strong\">/usr/lib/</emphasis> "
"with <emphasis role=\"strong\">/usr/lib/*/</emphasis> in <emphasis role="
"\"strong\">debian/</emphasis><emphasis>foo</emphasis><emphasis role=\"strong"
"\">.install</emphasis> files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3923
msgid ""
"All files installed simultaneously as the multiarch package to the same file "
"path should have exactly the same file content. You must be careful on "
"differences generated by the data byte order and by the compression "
"algorithm."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3924
msgid "GNU Coding Standards: 7.2.5 Variables for Installation Directories"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:3924
msgid ""
"The <emphasis role=\"strong\">--libexecdir</emphasis> option of the "
"<emphasis role=\"strong\">./configure</emphasis> command specifies the "
"default path to install executable programs run by other programs rather "
"than by users. Its Autotools default is <emphasis role=\"strong\">/usr/"
"libexec/</emphasis> but its Debian non-multi-arch default is <emphasis role="
"\"strong\">/usr/lib/</emphasis>. If such executables are a part of a \"Multi-"
"arch: foreign\" package, path such as <emphasis role=\"strong\">/usr/lib/</"
"emphasis> or <emphasis role=\"strong\">/usr/lib/</"
"emphasis><emphasis>packagename</emphasis> may be more desirable than "
"<emphasis role=\"strong\">/usr/lib/&lt;triplet&gt;/</emphasis> which "
"<emphasis role=\"strong\">dh_auto_configure</emphasis> uses. The <_:ulink-1/"
"> has description for <emphasis role=\"strong\">libexecdir</emphasis> as "
"\"The definition of <emphasis role=\"strong\">libexecdir</emphasis> is the "
"same for all packages, so you should install your data in a subdirectory "
"thereof. Most packages install their data under <emphasis role=\"strong\">"
"$(libexecdir)/package-name/</emphasis> …\". (It is always good idea to "
"follow GNU unless it conflicts with the Debian policy)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3925
msgid ""
"The shared library files in the default path <emphasis role=\"strong\">/usr/"
"lib/</emphasis> and <emphasis role=\"strong\">/usr/lib/&lt;triplet&gt;/</"
"emphasis> are loaded automatically."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3926
msgid ""
"For the shared library files in the other path, GCC option <emphasis role="
"\"strong\">-l</emphasis> must be set by the <emphasis role=\"strong\">pkg-"
"config</emphasis> command to make them loaded properly."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3929
msgid "The multiarch header file path"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3930
msgid ""
"GCC includes both <emphasis role=\"strong\">/usr/include/</emphasis> and "
"<emphasis role=\"strong\">/usr/include/&lt;triplet&gt;/</emphasis> by "
"default on the multiarch Debian system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3931
msgid ""
"If the header file is not in those paths, GCC option <emphasis role=\"strong"
"\">-I</emphasis> must be set by the <emphasis role=\"strong\">pkg-config</"
"emphasis> command to make \"<emphasis role=\"strong\">#include &lt;</"
"emphasis><emphasis>foo.h</emphasis><emphasis role=\"strong\">&gt;</emphasis>"
"\" work properly."
msgstr ""

#. (itstool) path: table/title
#: debmake-doc.en.xml:3933
msgid "The multiarch header file path options"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3947
msgid "<emphasis role=\"strong\">/usr/include/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3948
msgid "<emphasis role=\"strong\">/usr/include/i386-linux-gnu/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3949
msgid "<emphasis role=\"strong\">/usr/include/x86_64-linux-gnu/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3952
msgid ""
"<emphasis role=\"strong\">/usr/include/</emphasis><emphasis>packagename</"
"emphasis><emphasis role=\"strong\">/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3953
msgid ""
"<emphasis role=\"strong\">/usr/include/i386-linux-gnu/</"
"emphasis><emphasis>packagename</emphasis><emphasis role=\"strong\">/</"
"emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3954
msgid ""
"<emphasis role=\"strong\">/usr/include/x86_64-linux-gnu/</"
"emphasis><emphasis>packagename</emphasis><emphasis role=\"strong\">/</"
"emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3958
msgid ""
"<emphasis role=\"strong\">/usr/lib/i386-linux-gnu/</"
"emphasis><emphasis>packagename</emphasis><emphasis role=\"strong\">/</"
"emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3959
msgid ""
"<emphasis role=\"strong\">/usr/lib/x86_64-linux-gnu/</"
"emphasis><emphasis>packagename</emphasis><emphasis role=\"strong\">/</"
"emphasis>"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:3964
msgid ""
"Filesystem Hierarchy Standard: /usr/lib : Libraries for programming and "
"packages"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:3964
msgid ""
"This path is compliant to the FHS. <_:ulink-1/> states \"Applications may "
"use a single subdirectory under <emphasis role=\"strong\">/usr/lib</"
"emphasis>. If an application uses a subdirectory, all architecture-dependent "
"data exclusively used by the application must be placed within that "
"subdirectory.\""
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3964
msgid ""
"The use if the <emphasis role=\"strong\">/usr/lib/&lt;triplet&gt;/</"
"emphasis><emphasis>packagename</emphasis><emphasis role=\"strong\">/</"
"emphasis> path for the header files allows the upstream to use the same "
"install script for the multiatch system with <emphasis role=\"strong\">/usr/"
"lib/&lt;triplet&gt;</emphasis> and the biarch system with <emphasis role="
"\"strong\">/usr/lib&lt;qual&gt;/</emphasis>. <_:footnote-1/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3965
msgid ""
"The use of the file path containing <emphasis>packagename</emphasis> enables "
"to have more than 2 development libraries simultaneously installed on a "
"system."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3968
msgid "The multiarch <emphasis role=\"strong\">*.pc</emphasis> file path"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3969
msgid ""
"The <emphasis role=\"strong\">pkg-config</emphasis> program is used to "
"retrieve information about installed libraries in the system. It stores its "
"configuration parameters in the <emphasis role=\"strong\">*.pc</emphasis> "
"file and is used for setting the <emphasis role=\"strong\">-I</emphasis> and "
"<emphasis role=\"strong\">-l</emphasis> options for GCC."
msgstr ""

#. (itstool) path: table/title
#: debmake-doc.en.xml:3971
msgid "The <emphasis role=\"strong\">*.pc</emphasis> file path options"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3985
msgid "<emphasis role=\"strong\">/usr/lib/pkgconfig/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3986
msgid "<emphasis role=\"strong\">/usr/lib/i386-linux-gnu/pkgconfig/</emphasis>"
msgstr ""

#. (itstool) path: entry/simpara
#: debmake-doc.en.xml:3987
msgid ""
"<emphasis role=\"strong\">/usr/lib/x86_64-linux-gnu/pkgconfig/</emphasis>"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:3995
msgid "Library symbols"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3996
msgid ""
"The symbols support in the <emphasis role=\"strong\">dpkg</emphasis> "
"introduced to Debian <emphasis role=\"strong\">lenny</emphasis> (5.0, May "
"2009) helps us to manage the backward ABI compatibility of the library "
"package with the same package name. The <emphasis role=\"strong\">DEBIAN/"
"symbols</emphasis> file in the binary package provides the minimal version "
"associated to each symbol."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:3997
msgid "The oversimplified method for the library packaging is as follows."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4000
msgid ""
"Extract the old <emphasis role=\"strong\">DEBIAN/symbols</emphasis> file of "
"the immediate previous binary package with the “<emphasis role=\"strong"
"\">dpkg-deb -e</emphasis>” command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4005
msgid ""
"Alternatively, the <emphasis role=\"strong\">mc</emphasis> command may be "
"used to extract the <emphasis role=\"strong\">DEBIAN/symbols</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4012 debmake-doc.en.xml:4044
msgid ""
"Copy it to the <emphasis role=\"strong\">debian/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">."
"symbols</emphasis> file."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4017
msgid "If this is the first package, use an empty content file instead."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4024
msgid "Build the binary package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4029
msgid ""
"If the <emphasis role=\"strong\">dpkg-gensymbols</emphasis> command warns "
"some new symbols:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4034
msgid ""
"Extract the updated <emphasis role=\"strong\">DEBIAN/symbols</emphasis> file "
"with the “<emphasis role=\"strong\">dpkg-deb -e</emphasis>” command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4039
msgid ""
"Trim the Debian revision such as <emphasis role=\"strong\">-1</emphasis> in "
"it."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4049
msgid "Re-build the binary package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4056
msgid ""
"If the <emphasis role=\"strong\">dpkg-gensymbols</emphasis> command does not "
"warn new symbols:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4061
msgid "You are done with the library packaging."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4070
msgid "For the details, you should read the following primary references."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4074
msgid "8.6.3 The symbols system"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4078
msgid "<emphasis role=\"strong\">dh_makeshlibs</emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4083
msgid "<emphasis role=\"strong\">dpkg-gensymbols</emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4088
msgid "<emphasis role=\"strong\">dpkg-shlibdeps</emphasis>(1)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4093
msgid "<emphasis role=\"strong\">deb-symbols</emphasis>(5)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4098
msgid "Yous should also check:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4102
msgid "UsingSymbolsFiles"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4107
msgid "Projects/ImprovedDpkgShlibdeps"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4112
msgid "Working with symbols files"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4111
msgid "Debian kde team <_:ulink-1/>"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4126
msgid "8.6.4 The shlibs system"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4126
msgid ""
"For C++ libraries and other cases where the tracking of the symbols is "
"problematic, follow <_:ulink-1/> of the “Debian Policy Manual”, instead. "
"Please make sure to erase the empty <emphasis role=\"strong\">debian/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">."
"symbols</emphasis> file generated by the <emphasis role=\"strong\">debmake</"
"emphasis> command. For this case, the <emphasis role=\"strong\">DEBIAN/"
"shlibs</emphasis> file is used."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4129
msgid "Compiler hardening"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4130
msgid ""
"The compiler hardening support spreading for Debian <emphasis role=\"strong"
"\">jessie</emphasis> (8.0, TBA) demands us to pay extra attention for the "
"packaging."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4135
msgid "Hardening"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4140
msgid "Hardening Walkthrough"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4144
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command adds template "
"comments to the <emphasis role=\"strong\">debian/rules</emphasis> file as "
"needed for <emphasis role=\"strong\">DEB_BUILD_MAINT_OPTIONS</emphasis>, "
"<emphasis role=\"strong\">DEB_CFLAGS_MAINT_APPEND</emphasis>, and <emphasis "
"role=\"strong\">DEB_LDFLAGS_MAINT_APPEND</emphasis> (see <xref linkend="
"\"simple\"/> and <emphasis role=\"strong\">dpkg-buildflags</emphasis>(1))."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4147
msgid "Bug report"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4148
msgid ""
"The <emphasis role=\"strong\">reportbug</emphasis> command used for the bug "
"report of <emphasis>binarypackage</emphasis> can be customized by the files "
"in <emphasis role=\"strong\">usr/share/bug/</"
"emphasis><emphasis>binarypackage</emphasis><emphasis role=\"strong\">/</"
"emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4149
msgid ""
"The <emphasis role=\"strong\">dh_bugfiles</emphasis> command installs these "
"files from the template files in the <emphasis role=\"strong\">debian/</"
"emphasis> directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4152
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.bug-control</emphasis> → <emphasis role="
"\"strong\">usr/share/bug/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">/control</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4157
msgid ""
"This file contains some directions such as redirecting the bug report to "
"another package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4164
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.bug-presubj</emphasis> → <emphasis role="
"\"strong\">usr/share/bug/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">/presubj</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4169
msgid ""
"This file is displayed to the user by the <emphasis role=\"strong"
"\">reportbug</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4176
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.bug-script</emphasis> → <emphasis role="
"\"strong\">usr/share/bug/</emphasis><emphasis>binarypackage</emphasis> or "
"<emphasis role=\"strong\">usr/share/bug/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">/script</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4181
msgid ""
"The <emphasis role=\"strong\">reportbug</emphasis> command runs this script "
"to generate a template file for the bug report."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4188
msgid "reportbug’s Features for Developers"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4188
msgid ""
"See <emphasis role=\"strong\">dh_bugfiles</emphasis>(1) and <_:ulink-1/>"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4191
msgid "debconf"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4192
msgid ""
"The <emphasis role=\"strong\">debconf</emphasis> package enables us to "
"configure packages during their installation in 2 main ways:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4195
msgid ""
"non-interactively from the <emphasis role=\"strong\">debian-installer</"
"emphasis> pre-seeding."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4200
msgid ""
"interactively from the menu interface (<emphasis role=\"strong\">dialog</"
"emphasis>, <emphasis role=\"strong\">gnome</emphasis>, <emphasis role="
"\"strong\">kde</emphasis>, …)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4205
msgid ""
"the package installation: invoked by the <emphasis role=\"strong\">dpkg</"
"emphasis> command"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4210
msgid ""
"the installed package: invoked by the <emphasis role=\"strong\">dpkg-"
"reconfigure</emphasis> command"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4217
msgid ""
"All user interactions for the package installation must be handled by this "
"<emphasis role=\"strong\">debconf</emphasis> system using the following "
"files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4220
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.cofig</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4225
msgid ""
"This is the <emphasis role=\"strong\">debconf</emphasis> <emphasis role="
"\"strong\">config</emphasis> script used for asking any questions necessary "
"to configure the package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4232
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.template</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4237
msgid ""
"This is the <emphasis role=\"strong\">debconf</emphasis> <emphasis role="
"\"strong\">templates</emphasis> file used for asking any questions necessary "
"to configure the package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4244
msgid "package configuration scripts"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4249
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.preinst</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4254
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.prerm</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4259
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.postinst</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4264
msgid ""
"<emphasis role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.postrm</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4271
msgid ""
"See <emphasis role=\"strong\">dh_installdebconf</emphasis>(1), <emphasis "
"role=\"strong\">debconf</emphasis>(7), <emphasis role=\"strong\">debconf-"
"devel</emphasis>(7) and <_:ulink-1/> of the “Debian Policy Manual”."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4274
msgid "Continuous integration"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4275
msgid "continuous integration"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4275
msgid ""
"<_:ulink-1/> defines the <emphasis role=\"strong\">debian/tests/control</"
"emphasis> file as the RFC822-style test metadata file for the <_:ulink-2/> "
"(CI) of the Debian package."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4276
msgid ""
"It is used after building the binary packages from the source package "
"containing this <emphasis role=\"strong\">debian/tests/control</emphasis> "
"file. When the <emphasis role=\"strong\">adt-run</emphasis> command provided "
"by the <emphasis role=\"strong\">autopkgtest</emphasis> package is run, the "
"generated binary packages are installed and tested in the virtual "
"environment according to this file."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4277
msgid "3. autopkgtest: Automatic testing for packages"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4277
msgid ""
"See documents in the <emphasis role=\"strong\">/usr/share/doc/autopkgtest/</"
"emphasis> directory and <_:ulink-1/> of the “Ubuntu Packaging Guide”."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4278
msgid "There are several other CI tools on Debian for you to explore."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4281
msgid ""
"The <emphasis role=\"strong\">debci</emphasis> package: CI platform on the "
"top of the <emphasis role=\"strong\">autopkgtest</emphasis> package"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4286
msgid ""
"The <emphasis role=\"strong\">jenkins</emphasis> package: generic CI platform"
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:4294
msgid "Options"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:4295
msgid ""
"Here are some notable options for the <emphasis role=\"strong\">debmake</"
"emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4297
msgid "Shortcut options (-a, -i)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4298
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command offers 2 shortcut "
"options."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4301
msgid "<emphasis role=\"strong\">-a</emphasis> : open the upstream tarball"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4306
msgid ""
"<emphasis role=\"strong\">-i</emphasis> : execute script to build the binary "
"package"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4311
msgid ""
"The example in the above <xref linkend=\"simple\"/> can be done simply as "
"follows."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4313
msgid ""
"URL such as “<emphasis role=\"strong\">http://www.example.org/DL/package-1.0."
"tar.gz</emphasis>” may be used for the <emphasis role=\"strong\">-a</"
"emphasis> option."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4314
msgid ""
"URL such as “<emphasis role=\"strong\">http://arm.koji.fedoraproject.org/"
"packages/ibus/1.5.7/3.fc21/src/ibus-1.5.7-3.fc21.src.rpm</emphasis>” may be "
"used for the <emphasis role=\"strong\">-a</emphasis> option, too."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4317
msgid "Upstream snapshot (-d, -t)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4318
msgid ""
"The upstream snapshot from the upstream source tree in VCS can be made with "
"the <emphasis role=\"strong\">-d</emphasis> option if the upstream supports "
"the “<emphasis role=\"strong\">make dist</emphasis>” equivalence."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4321
msgid ""
"Alternatively, the same can be made with the <emphasis role=\"strong\">-t</"
"emphasis> option if the upstream tarball can be made with the <emphasis role="
"\"strong\">tar</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4324
msgid ""
"Unless you provide the upstream version with the <emphasis role=\"strong\">-"
"u</emphasis> option or with the <emphasis role=\"strong\">debian/changelog</"
"emphasis> file, a snapshot upstream version is generated in the <emphasis "
"role=\"strong\">0~%y%m%d%H%M</emphasis> format, e.g., "
"<emphasis>0~1403012359</emphasis>, from the UTC date and time."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4325
msgid ""
"If the upstream VCS is hosted in the <emphasis>package/</emphasis> directory "
"instead of the <emphasis>upstream-vcs/</emphasis> directory, the “<emphasis "
"role=\"strong\">-p</emphasis> <emphasis>package”</emphasis> can be skipped."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4326
msgid ""
"If the upstream source tree in the VCS contains the <emphasis role=\"strong"
"\">debian/</emphasis>* files, the <emphasis role=\"strong\">debmake</"
"emphasis> command with either the <emphasis role=\"strong\">-d</emphasis> "
"option or the <emphasis role=\"strong\">-t</emphasis> option combined with "
"the <emphasis role=\"strong\">-i</emphasis> option automates making of the "
"non-native Debian packages from the VCS snapshot while using these <emphasis "
"role=\"strong\">debian/</emphasis>* files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4332
msgid ""
"This Debian <emphasis role=\"strong\">non-native</emphasis> binary package "
"building scheme using the “<emphasis role=\"strong\">debmake -t -i debuild</"
"emphasis>” command may be considered as the <emphasis role=\"strong\">quasi-"
"native</emphasis> Debian package scheme since the packaging situation "
"resembles the Debian <emphasis role=\"strong\">native</emphasis> binary "
"package building case using the <emphasis role=\"strong\">debuild</emphasis> "
"command without the upstream tarball."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4333
msgid ""
"Use of the <emphasis role=\"strong\">non-native</emphasis> Debian package "
"helps to ease communication with the downstream distros such as Ubuntu for "
"bug fixes etc."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4336
msgid "Python module"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4337
msgid ""
"You can generate a functioning single binary Debian package with a "
"reasonable package description directly from the Python module package "
"offered as a tarball <emphasis>pythonmodule-1.0</emphasis><emphasis role="
"\"strong\">.tar.gz</emphasis>. The <emphasis role=\"strong\">-b</emphasis> "
"option specifying the package type <emphasis role=\"strong\">python</"
"emphasis> and the <emphasis role=\"strong\">-s</emphasis> option to copy the "
"package description from the upstream package need to be specified."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4339
msgid ""
"For other interpreted languages with the <emphasis role=\"strong\">-b</"
"emphasis> option support, specify the pertinent <emphasis>type</emphasis> "
"for the <emphasis role=\"strong\">-b</emphasis> option."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4340
msgid ""
"For interpreted languages without the <emphasis role=\"strong\">-b</"
"emphasis> option support, specify the <emphasis role=\"strong\">script</"
"emphasis> type instead and add the interpreter package as the dependency of "
"the resulting binary package by adjusting the <emphasis role=\"strong"
"\">debian/control</emphasis> file."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4343
msgid "debmake -cc"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4344
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command with the <emphasis "
"role=\"strong\">-cc</emphasis> option can make a summary of the copyright "
"and license for the entire source tree to the standard output."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4348
msgid ""
"With <emphasis role=\"strong\">-c</emphasis>, this provides shorter report."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4351
msgid "debmake -k"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4352
msgid ""
"When updating a package for the new upstream release, the <emphasis role="
"\"strong\">debmake</emphasis> command can verify the content of the existing "
"<emphasis role=\"strong\">debian/copyright</emphasis> file against the "
"copyright and license situation of the entire updated source tree."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4357
msgid ""
"The “<emphasis role=\"strong\">debmake -k</emphasis>” command parses the "
"<emphasis role=\"strong\">debian/copyright</emphasis> file from the top to "
"the bottom and compare the license of all the non-binary files in the "
"current package with the license described in the last matching file pattern "
"entry of the <emphasis role=\"strong\">debian/copyright</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4358
msgid ""
"When editing the auto-generated <emphasis role=\"strong\">debian/copyright</"
"emphasis> file, please make sure to keep the generic file patterns at the "
"top of the list."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4359
msgid ""
"For all new upstream releases, run the “<emphasis role=\"strong\">debmake -"
"k</emphasis>” command to ensure that the <emphasis role=\"strong\">debian/"
"copyright</emphasis> file is current."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4362
msgid "debmake -j"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4363
msgid ""
"The generation of the functioning multi binary package always requires extra "
"manual works than that of the functioning single binary package. The test "
"build of the source package is essential part of it."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4364
msgid ""
"For example, let’s package the same <emphasis>package-1.0</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> (see <xref linkend="
"\"simple\"/>) into a multi binary package. At the line invoking the "
"<emphasis role=\"strong\">debmake</emphasis> command, let’s invoke it with "
"the <emphasis role=\"strong\">-j</emphasis> option instead for the test "
"building and the report generation."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:4366
msgid ""
"The <emphasis role=\"strong\">-j</emphasis> option for <emphasis role="
"\"strong\">debmake</emphasis> invokes <emphasis role=\"strong\">dpkg-"
"depcheck</emphasis>(1) to run <emphasis role=\"strong\">debian/rules</"
"emphasis> under <emphasis role=\"strong\">strace</emphasis>(1) to obtain "
"library dependencies. Unfortunately, this is very slow. If you know the "
"library package dependencies from other sources such as the SPEC file in the "
"source, you may just run \"<emphasis role=\"strong\">debmake</emphasis> …\" "
"without <emphasis role=\"strong\">-j</emphasis> and “<emphasis role=\"strong"
"\">debian/rules install</emphasis>” to check the install paths of the "
"generated files."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4369
msgid ""
"Check the last lines of <emphasis>package</emphasis><emphasis role=\"strong"
"\">.build-dep.log</emphasis> to judge build dependencies for <emphasis role="
"\"strong\">Build-Depends</emphasis>. (You do not need to list packages used "
"by <emphasis role=\"strong\">debhelper</emphasis>, <emphasis role=\"strong"
"\">perl</emphasis>, or <emphasis role=\"strong\">fakeroot</emphasis> "
"explicitly in <emphasis role=\"strong\">Build-Depends</emphasis>. This "
"technique is useful for the generation of the single binary package, too.)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4374
msgid ""
"Check the contents of <emphasis>package</emphasis><emphasis role=\"strong\">."
"install.log</emphasis> to identify the install paths for files to decide how "
"you split them into multiple packages."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4385
msgid ""
"Update <emphasis role=\"strong\">debian/control</emphasis> and <emphasis "
"role=\"strong\">debian/</emphasis><emphasis>binarypackage</"
"emphasis><emphasis role=\"strong\">.install</emphasis> files using the above "
"information."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4390
msgid ""
"Update other <emphasis role=\"strong\">debian/</emphasis>* files as needed."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4398
msgid ""
"Each <emphasis>binarypackage_version-revision_arch</emphasis><emphasis role="
"\"strong\">.deb</emphasis> has files specified by the <emphasis role=\"strong"
"\">debian/</emphasis><emphasis>binarypackage</emphasis><emphasis role="
"\"strong\">.install</emphasis> file."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4405
msgid "debmake -x"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4406
msgid ""
"The amount of template files generated by the <emphasis role=\"strong"
"\">debmake</emphasis> command depends on the <emphasis role=\"strong\">-x</"
"emphasis>[01234] option."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4409
msgid ""
"See <xref linkend=\"emptypkg\"/> for the cherry-picking of the template "
"files."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:4414
msgid ""
"None of the existing configuration files are modified by the <emphasis role="
"\"strong\">debmake</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4417
msgid "debmake -T"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4418
msgid ""
"The <emphasis role=\"strong\">debmake</emphasis> command invoked with the "
"<emphasis role=\"strong\">-T</emphasis> option additionally prints the "
"verbose tutorial comment lines. The lines marked with <emphasis role=\"strong"
"\">###</emphasis> in the template files are part of the verbose tutorial "
"comment lines."
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:4422
msgid "Tips"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:4423
msgid "Here are some notable tips around the Debian packaging."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4425
msgid "debdiff"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4426
msgid ""
"You can compare file contents in two source Debian packages with the "
"<emphasis role=\"strong\">debdiff</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4428
msgid ""
"You can also compare file lists in two sets of binary Debian packages with "
"the <emphasis role=\"strong\">debdiff</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4430
msgid ""
"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."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4433
msgid "dget"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4434
msgid ""
"You can download the set of files for the Debian source package with the "
"<emphasis role=\"strong\">dget</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4438
msgid "debc"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4439
msgid ""
"You should install generated packages with the <emphasis role=\"strong"
"\">debc</emphasis> command to test it locally."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4443
msgid "piuparts"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4444
msgid ""
"You should install generated packages with the <emphasis role=\"strong"
"\">piuparts</emphasis> command to test it automatically."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:4446
msgid "This is very slow proess with the remote APT package repository access."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4449
msgid "debsign"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4450
msgid ""
"After completing the test of the package, you can sign it with the <emphasis "
"role=\"strong\">debsign</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4454
msgid "dput"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4455
msgid ""
"After signing the package with the <emphasis role=\"strong\">debsign</"
"emphasis> command, you can upload the set of files for the Debian source and "
"binary package with the <emphasis role=\"strong\">dput</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4459
msgid "bts"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4460
msgid "5.8. Handling bugs"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4460
msgid ""
"After uploading the package, you will receive bug reports. It is an "
"important duty of a package maintainer to manage these bugs properly as "
"described in <_:ulink-1/> of the “Debian Developer’s Reference”."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4461
msgid "Debian Bug Tracking System"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4461
msgid ""
"The <emphasis role=\"strong\">bts</emphasis> command is a handy tool to "
"manage bugs on <_:ulink-1/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4466
msgid ""
"The <emphasis role=\"strong\">git-buildpackage</emphasis> package offers "
"many commands to automate packaging activities using the git repository."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4469
msgid ""
"<emphasis role=\"strong\">git-import-dsc</emphasis>: import the previous "
"Debian source package to the git repository."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4474
msgid ""
"<emphasis role=\"strong\">git-import-orig</emphasis>: import the new "
"upstream tar to the git repository."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4479
msgid ""
"<emphasis role=\"strong\">git-dch</emphasis>: generate the Debian changelog "
"from the git commit messages."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4484
msgid ""
"<emphasis role=\"strong\">git-buildpackage</emphasis>: build the Debian "
"binary package from the git repository. (alias <emphasis role=\"strong"
"\">gbp</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4489
msgid ""
"The <emphasis role=\"strong\">--pristine-tar</emphasis> option for the "
"<emphasis role=\"strong\">git-buildpackage</emphasis> command enables to "
"store the upstream tarball in the same git repository."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4494
msgid ""
"The <emphasis role=\"strong\">--uscan</emphasis> option for the <emphasis "
"role=\"strong\">git-buildpackage</emphasis> command enables to download and "
"commit the new upstream tarball into the git repository."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4499
msgid ""
"The “<emphasis role=\"strong\">gbp pull</emphasis>” command updates the "
"<emphasis role=\"strong\">debian</emphasis>, <emphasis role=\"strong"
"\">upstream</emphasis> and <emphasis role=\"strong\">pristine-tar</emphasis> "
"branches safely from the remote repository."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4506
msgid ""
"<emphasis role=\"strong\">git-pbuilder</emphasis>: build the Debian binary "
"package from the git repository using the <emphasis role=\"strong"
"\">pbuilder</emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4511
msgid ""
"The <emphasis role=\"strong\">cowbuilder</emphasis> package is used as its "
"backend."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4518
msgid ""
"The <emphasis role=\"strong\">gbp-pq</emphasis>, <emphasis role=\"strong"
"\">git-dpm</emphasis> or <emphasis role=\"strong\">quilt</emphasis> (or "
"alias <emphasis role=\"strong\">dquilt</emphasis>) commands are used to "
"manage quilt patches."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4523
msgid ""
"The use of the <emphasis role=\"strong\">dquilt</emphasis> command is the "
"simplest to learn and requires you to commit the resulting files manually "
"with the <emphasis role=\"strong\">git</emphasis> command to the <emphasis "
"role=\"strong\">master</emphasis> branch."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4528
msgid ""
"The use of the “<emphasis role=\"strong\">gbp pq</emphasis>” command "
"provides the equivalent functionality of the patch set management without "
"using <emphasis role=\"strong\">dquilt</emphasis> and eases including "
"upstream git repository changes by the cherry-picking."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4533
msgid ""
"The use of the “<emphasis role=\"strong\">gbp dpm</emphasis>” command "
"provides the more enhanced functionality than that of the ‘<emphasis role="
"\"strong\">gbp pq</emphasis>’' command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4540
msgid ""
"The package history management with the <emphasis role=\"strong\">git-"
"buildpackage</emphasis> package is becoming the standard practice for most "
"Debian maintainers."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4541
msgid "See:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4545
msgid "Building Debian Packages with git-buildpackage"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4550
msgid "https://wiki.debian.org/GitPackagingWorkflow"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4555
msgid "https://wiki.debian.org/GitPackagingWorkflow/DebConf11BOF"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4560
msgid ""
"http://raphaelhertzog.com/2010/11/18/4-tips-to-maintain-a-3-0-quilt-debian-"
"source-package-in-a-vcs/"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4565
msgid "Building from source"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4564
msgid ""
"The <emphasis role=\"strong\">systemd</emphasis> packaging practice "
"documentation on <_:ulink-1/>."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4569
msgid ""
"Relax. You don’t need to use all the wrapper tools. Use only ones which "
"match your needs."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4572
msgid "Package history"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4573
msgid "snapshot.debian.org"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4573
msgid ""
"For Debian source packages named <emphasis>&lt;source-package&gt;</emphasis> "
"recorded in the <_:ulink-1/> archive, an initial git repository with all of "
"the Debian version history can be generated as follows."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4577
msgid "Upstream git repository"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4578
msgid ""
"For the Debian packaging with the <emphasis role=\"strong\">git-"
"buildpackage</emphasis> package, the <emphasis role=\"strong\">upstream</"
"emphasis> branch on the remote repository <emphasis role=\"strong\">origin</"
"emphasis> is normally used to track the content of the released upstream "
"tarball."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4579
msgid ""
"The upstream git repository can also be tracked by naming its remote "
"repository as <emphasis role=\"strong\">upstream</emphasis> instead of the "
"default <emphasis role=\"strong\">origin</emphasis>. Then you can easily "
"cherry-pick recent upstream changes into the Debian revision by cherry-"
"picking with the <emphasis role=\"strong\">gitk</emphasis> command and using "
"the <emphasis role=\"strong\">gbp-pq</emphasis> command."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4580
msgid ""
"The <emphasis role=\"strong\">git-import-orig</emphasis> command with the "
"<emphasis role=\"strong\">--upstream-vcs-tag</emphasis> option can create a "
"nice packaging history by making a merge commit into <emphasis role=\"strong"
"\">upstream</emphasis> branch from the specified tag on the upstream git "
"repository."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:4581
msgid ""
"The content of the released upstream tarball may not match exactly with the "
"corresponding content of the upstream git repository. It may contain some "
"auto-generated files or miss some files. (Autotools, distutils, …)"
msgstr ""

#. (itstool) path: section/title
#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4584 debmake-doc.en.xml:4585
msgid "chroot"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4586
msgid "https://wiki.debian.org/git-pbuilder"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:4586
msgid ""
"The <emphasis role=\"strong\">git-pbuilder</emphasis> style organization is "
"deployed here. See <_:ulink-1/> . Be careful since many HOWTOs use different "
"organization."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4585
msgid ""
"The <_:ulink-1/> for the clean package build environment can be created and "
"managed using the tools described in <xref linkend=\"setup\"/>. <_:"
"footnote-2/>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4587
msgid ""
"Here is a quick summary of available package build commands. There are many "
"ways to do the same thing."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4590
msgid ""
"<emphasis role=\"strong\">dpkg-buildpackage</emphasis> = core of package "
"building tool"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4595
msgid ""
"<emphasis role=\"strong\">debuild</emphasis> = <emphasis role=\"strong"
"\">dpkg-buildpackage</emphasis> + <emphasis role=\"strong\">lintian</"
"emphasis> (build under the sanitized environment variables)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4600
msgid ""
"<emphasis role=\"strong\">pbuilder</emphasis> = core of the Debian chroot "
"environment tool"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4605
msgid ""
"<emphasis role=\"strong\">pdebuild</emphasis> = <emphasis role=\"strong"
"\">pbuilder</emphasis> + <emphasis role=\"strong\">dpkg-buildpackage</"
"emphasis> (build in the chroot)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4610
msgid ""
"<emphasis role=\"strong\">cowbuilder</emphasis> = speed up the <emphasis "
"role=\"strong\">pbuilder</emphasis> execution"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4615
msgid ""
"<emphasis role=\"strong\">git-pbuilder</emphasis> = the easy-to-use command "
"line syntax for <emphasis role=\"strong\">pdebuild</emphasis> (used by "
"<emphasis role=\"strong\">gbp buildpackge</emphasis>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4620
msgid ""
"<emphasis role=\"strong\">gbp</emphasis> = manage the Debian source under "
"the git"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4625
msgid ""
"<emphasis role=\"strong\">gbp buildpackge</emphasis> = <emphasis role="
"\"strong\">pbuilder</emphasis> + <emphasis role=\"strong\">dpkg-"
"buildpackage</emphasis> + <emphasis role=\"strong\">gbp</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4630
msgid ""
"A clean <emphasis role=\"strong\">sid</emphasis> distribution chroot "
"environment can be used as follows."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4633
msgid ""
"The chroot filesystem creation command for the <emphasis role=\"strong"
"\">sid</emphasis> distribution"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4638
msgid "<emphasis role=\"strong\">pbuilder create</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4643
msgid "<emphasis role=\"strong\">git-pbuilder create</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4650
msgid ""
"The master chroot filesystem path for the <emphasis role=\"strong\">sid</"
"emphasis> distribution chroot"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4655
msgid "<emphasis role=\"strong\">/var/cache/pbuilder/base.cow</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4662
msgid ""
"The package build command for the <emphasis role=\"strong\">sid</emphasis> "
"distribution chroot"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4667
msgid "<emphasis role=\"strong\">pdebuild</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4672
msgid "<emphasis role=\"strong\">git-pbuilder</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4677
msgid "<emphasis role=\"strong\">gbp buildpackage</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4684
msgid ""
"The command to update the <emphasis role=\"strong\">sid</emphasis> chroot"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4689
msgid "<emphasis role=\"strong\">pbuilder --update</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4694
msgid "<emphasis role=\"strong\">git-pbuilder update</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4701 debmake-doc.en.xml:4784
msgid ""
"The command to login to the <emphasis role=\"strong\">sid</emphasis> chroot "
"to modify it"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4706
msgid ""
"<emphasis role=\"strong\">git-pbuilder login --save-after-login</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4713
msgid ""
"An arbitrary <emphasis>dist</emphasis> distribution environment can be used "
"as follows."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4716
msgid ""
"The chroot filesystem creation command for the <emphasis>dist</emphasis> "
"distribution"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4721
msgid ""
"<emphasis role=\"strong\">pbuilder create --distribution</emphasis> "
"<emphasis>dist</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4726
msgid ""
"<emphasis role=\"strong\">DIST=</emphasis><emphasis>dist</emphasis> "
"<emphasis role=\"strong\">git-pbuilder create</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4733
msgid ""
"The master chroot filesystem path for the <emphasis>dist</emphasis> "
"distribution chroot"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4738
msgid ""
"path: <emphasis role=\"strong\">/var/cache/pbuilder/base-</"
"emphasis><emphasis>dist</emphasis><emphasis role=\"strong\">.cow</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4745
msgid ""
"The package build command for the <emphasis>dist</emphasis> distribution "
"chroot"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4750
msgid ""
"<emphasis role=\"strong\">pdebuild -- --basepath=/var/cache/pbuilder/base-</"
"emphasis><emphasis>dist</emphasis><emphasis role=\"strong\">.cow</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4755
msgid ""
"<emphasis role=\"strong\">DIST=</emphasis><emphasis>dist</emphasis> "
"<emphasis role=\"strong\">git-pbuilder</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4760
msgid ""
"<emphasis role=\"strong\">gbp buildpackage --git-dist=</"
"emphasis><emphasis>dist</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4767
msgid "The command to update the <emphasis>dist</emphasis> chroot"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4772
msgid ""
"<emphasis role=\"strong\">pbuilder update --basepath=/var/cache/pbuilder/"
"base-</emphasis><emphasis>dist</emphasis><emphasis role=\"strong\">.cow</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4777
msgid ""
"<emphasis role=\"strong\">DIST=</emphasis><emphasis>dist</emphasis> "
"<emphasis role=\"strong\">git-pbuilder update</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4789
msgid ""
"<emphasis role=\"strong\">pbuilder --login --basepath=/var/cache/pbuilder/"
"base-</emphasis><emphasis>dist</emphasis><emphasis role=\"strong\">.cow --"
"save-after-login</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4794
msgid ""
"<emphasis role=\"strong\">DIST=</emphasis><emphasis>dist</emphasis> "
"<emphasis role=\"strong\">git-pbuilder login --save-after-login</emphasis>"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4801
msgid ""
"A custom environment with some pre-loaded packages needed for the new "
"experimental packages, this “<emphasis role=\"strong\">git-pbuilder login --"
"save-after-login</emphasis>” command is quite handy."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4802
msgid ""
"If your old chroot is missing packages such as <emphasis role=\"strong"
"\">libeatmydata1</emphasis>, <emphasis role=\"strong\">ccache</emphasis>, "
"and <emphasis role=\"strong\">lintian</emphasis>, you may want to install "
"these with the “<emphasis role=\"strong\">git-pbuilder login --save-after-"
"login</emphasis>” command."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4803
msgid ""
"The chroot filesystem can be cloned simply by copying with “<emphasis role="
"\"strong\">cp -a base-</emphasis><emphasis>dist</emphasis><emphasis role="
"\"strong\">.cow base-</emphasis><emphasis>customdist</emphasis><emphasis "
"role=\"strong\">.cow</emphasis>”. The new chroot can be accessed as "
"“<emphasis role=\"strong\">gbp buildpackage --git-dist=</"
"emphasis><emphasis>customdist”</emphasis> and “<emphasis role=\"strong"
"\">DIST=</emphasis><emphasis>customdist</emphasis> <emphasis role=\"strong"
"\">git-pbuilder …</emphasis>”."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4804
msgid ""
"When the <emphasis role=\"strong\">orig.tar.gz</emphasis> file needs to be "
"upload for the Debian revision other than <emphasis role=\"strong\">0</"
"emphasis> and <emphasis role=\"strong\">1</emphasis> (e.g., for the security "
"upload), add the <emphasis role=\"strong\">-sa</emphasis> option to the end "
"of <emphasis role=\"strong\">dpkg-buildpackage</emphasis>, <emphasis role="
"\"strong\">debuild</emphasis>, <emphasis role=\"strong\">pdebuild</"
"emphasis>, and <emphasis role=\"strong\">git-pbuilder</emphasis> commands. "
"For the “<emphasis role=\"strong\">gbp buildpackage</emphasis>” command, "
"temporarily modify the <emphasis role=\"strong\">builder</emphasis> setting "
"of <emphasis role=\"strong\">~/.gbp.conf</emphasis>."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:4805
msgid ""
"The description in this section is too terse to be useful for most of the "
"prospective maintainers. This is the intentional choice of the author. You "
"are highly encouraged to search and read all the pertinent documents "
"associated with the commands used."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4808
msgid "New Debian revision"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4809
msgid ""
"Let’s assume that a bug report <emphasis role=\"strong\">#</"
"emphasis><emphasis>bug_number</emphasis> was filed against your package, and "
"it describes a problem that you can solve by editing <emphasis role=\"strong"
"\">buggy</emphasis> file in the upstream source. Here’s what you need to do "
"to create a new Debian revision of the package with the <emphasis role="
"\"strong\">bugname.patch</emphasis> file recording the fix."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:4810
msgid ""
"New Debian revision with the <emphasis role=\"strong\">dquilt</emphasis> "
"command"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4821
msgid ""
"Alternatively if the package is managed in the git repository using the "
"<emphasis role=\"strong\">git-buildpackage</emphasis> command with its "
"default configuration."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:4822
msgid ""
"New Debian revision with the <emphasis role=\"strong\">gbp-pq</emphasis> "
"command"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4835
msgid ""
"Please make sure to describe concisely the changes that fix reported bugs "
"and close those bugs by adding “<emphasis role=\"strong\">Closes: #</"
"emphasis><emphasis>&lt;bug_number&gt;”</emphasis> in the <emphasis role="
"\"strong\">debian/changelog</emphasis> file."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4836
msgid ""
"Use a <emphasis role=\"strong\">debian/changelog</emphasis> entry with a "
"version string such as <emphasis role=\"strong\">1.0.1-1~rc1</emphasis> when "
"you experiment. Then, unclutter such <emphasis role=\"strong\">changelog</"
"emphasis> entries into a single entry for the official package."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4839
msgid "New upstream release"
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:4840
msgid ""
"If a package <emphasis role=\"strong\">foo</emphasis> is packaged in the old "
"<emphasis role=\"strong\">1.0</emphasis> format, this can be done by running "
"“<emphasis role=\"strong\">zcat</emphasis> <emphasis>/path/to/"
"foo_oldversion</emphasis><emphasis role=\"strong\">.diff.gz|patch -p1</"
"emphasis>” in the new extracted source, instead."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4840
msgid ""
"If a package <emphasis role=\"strong\">foo</emphasis> is properly packaged "
"in the modern “<emphasis role=\"strong\">3.0 (native)</emphasis>” or "
"“<emphasis role=\"strong\">3.0 (quilt)</emphasis>” formats, packaging a new "
"upstream release is essentially moving the old <emphasis role=\"strong"
"\">debian/</emphasis> directory to the new source. This can be done by "
"running “<emphasis role=\"strong\">tar -xvzf</emphasis> <emphasis>/path/to/"
"foo_oldversion</emphasis><emphasis role=\"strong\">.debian.tar.gz</"
"emphasis>” in the new extracted source. <_:footnote-1/> Of course, you need "
"to do some obvious chores."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4841
msgid ""
"There are several tools to handle this situation. After updating to the new "
"upstream release with these tools, please make sure to describe concisely "
"the changes in the new upstream release that fix reported bugs and close "
"those bugs by adding “<emphasis role=\"strong\">Closes: #</"
"emphasis><emphasis>bug_number”</emphasis> in the <emphasis role=\"strong"
"\">debian/changelog</emphasis> file."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4843
msgid "uupdate + tarball"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4844
msgid ""
"You can update to the new upstream source with the <emphasis role=\"strong"
"\">uupdate</emphasis> command from the <emphasis role=\"strong\">devscripts</"
"emphasis> package. It requires to have the old Debian source package and the "
"new upstream tarball."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4854
msgid "uscan"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4855
msgid ""
"You can update to the new upstream source with the <emphasis role=\"strong"
"\">uscan</emphasis> command from the <emphasis role=\"strong\">devscripts</"
"emphasis> package. It requires to have the old Debian source package and the "
"<emphasis role=\"strong\">debian/watch</emphasis> file in it."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4863
msgid "gbp"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4864
msgid ""
"You can update to the new upstream source with the “<emphasis role=\"strong"
"\">gbp import-orig --pristine-tar</emphasis>” command from the <emphasis "
"role=\"strong\">git-buildpackage</emphasis> package. It requires to have the "
"old Debian source in the git repository and the new upstream tarball."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:4879 debmake-doc.en.xml:4897
msgid ""
"If upstream uses the git repository, please also use <emphasis role=\"strong"
"\">--upstream-vcs-tag</emphasis> option for the <emphasis role=\"strong"
"\">gbp import-orig</emphasis> command."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4882
msgid "gbp + uscan"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4883
msgid ""
"You can update to the new upstream source with the “<emphasis role=\"strong"
"\">gbp import-orig --pristine-tar --uscan</emphasis>” command from the "
"<emphasis role=\"strong\">git-buildpackage</emphasis> package. It requires "
"to have the old Debian source in the git repository and the <emphasis role="
"\"strong\">debian/watch</emphasis> file in it."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4901
msgid "Library transition"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4902
msgid "ben file"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4902
msgid "Release Team"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4902
msgid ""
"When you package a new library package version which affects other packages, "
"you must file a transition bug report against the <emphasis role=\"strong"
"\">release.debian.org</emphasis> psuedo package using the <emphasis role="
"\"strong\">reportbug</emphasis> command with the <_:ulink-1/> and wait for "
"the approval for its upload from the <_:ulink-2/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4903
msgid "transition tracker"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4903
msgid "Transitions"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4903
msgid "Release team has the <_:ulink-1/>. See <_:ulink-2/>."
msgstr ""

#. (itstool) path: caution/simpara
#: debmake-doc.en.xml:4904
msgid ""
"Please make sure to rename binary packages as <xref linkend=\"libnames\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4907
msgid "3.0 source format"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4908
msgid ""
"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 "
"<emphasis role=\"strong\">debhelper</emphasis> system and the <emphasis role="
"\"strong\">3.0</emphasis> source format."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4911
msgid ""
"If you need to recreate deleted template files for any reason, you can run "
"<emphasis role=\"strong\">debmake</emphasis> again in the same Debian "
"package source tree. Then edit them appropriately."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4916
msgid ""
"If the package has not been updated to use the <emphasis role=\"strong\">dh</"
"emphasis> command for the <emphasis role=\"strong\">debian/rules</emphasis> "
"file, update it to use it (see <xref linkend=\"simplerules\"/>). Update the "
"<emphasis role=\"strong\">debian/control</emphasis> file accordingly."
msgstr ""

#. (itstool) path: footnote/simpara
#: debmake-doc.en.xml:4922
msgid ""
"You can split <emphasis role=\"strong\">big.diff</emphasis> into many small "
"incremental patches using the <emphasis role=\"strong\">splitdiff</emphasis> "
"command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4921
msgid ""
"If you have a <emphasis role=\"strong\">1.0</emphasis> source package with "
"the <emphasis role=\"strong\">foo.diff.gz</emphasis> file, you can update it "
"to the newer “<emphasis role=\"strong\">3.0 (quilt)</emphasis>” source "
"format by creating <emphasis role=\"strong\">debian/source/format</emphasis> "
"with “<emphasis role=\"strong\">3.0 (quilt)</emphasis>”. The rest of the "
"<emphasis role=\"strong\">debian/</emphasis>* files can just be copied. "
"Import the <emphasis role=\"strong\">big.diff</emphasis> file generated by "
"the command “<emphasis role=\"strong\">filterdiff -z -x <emphasis><emphasis "
"role=\"strong\">/debian/</emphasis></emphasis> foo.diff.gz &gt; big.diff</"
"emphasis>” to your quilt system, if needed. <_:footnote-1/>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4926
msgid ""
"If it was packaged using another patch system such as <emphasis role=\"strong"
"\">dpatch</emphasis>, <emphasis role=\"strong\">dbs</emphasis>, or <emphasis "
"role=\"strong\">cdbs</emphasis> with <emphasis role=\"strong\">-p0</"
"emphasis>, <emphasis role=\"strong\">-p1</emphasis>, or <emphasis role="
"\"strong\">-p2</emphasis>, convert it to the quilt command using the "
"<emphasis role=\"strong\">deb3</emphasis> script in the <emphasis role="
"\"strong\">quilt</emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4931
msgid ""
"If it was packaged with the <emphasis role=\"strong\">dh</emphasis> command "
"with the “<emphasis role=\"strong\">--with quilt</emphasis>” option or with "
"the <emphasis role=\"strong\">dh_quilt_patch</emphasis> and <emphasis role="
"\"strong\">dh_quilt_unpatch</emphasis> commands, remove these and make it "
"use the newer “<emphasis role=\"strong\">3.0 (quilt)</emphasis>” source "
"format."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4936
msgid ""
"If you have a <emphasis role=\"strong\">1.0</emphasis> source package "
"without the <emphasis role=\"strong\">foo.diff.gz</emphasis> file, you can "
"update it to the newer “<emphasis role=\"strong\">3.0 (native)</emphasis>” "
"source format by creating <emphasis role=\"strong\">debian/source/format</"
"emphasis> with “<emphasis role=\"strong\">3.0 (native)</emphasis>”. The rest "
"of the <emphasis role=\"strong\">debian/</emphasis>* files can just be "
"copied."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4941
msgid "DEP - Debian Enhancement Proposals"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4941
msgid "You should check <_:ulink-1/> and adopt ACCEPTED proposals."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4942
msgid "ProjectsDebSrc3.0"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4942
msgid ""
"See <_:ulink-1/> to check the support status of the new Debian source "
"formats by the Debian tool chains."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4945
msgid "CDBS"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4946
msgid ""
"The Common Debian Build System (<emphasis role=\"strong\">CDBS</emphasis>) "
"is a wrapper system over the <emphasis role=\"strong\">debhelper</emphasis> "
"package. The <emphasis role=\"strong\">CDBS</emphasis> is based on the "
"Makefile inclusion mechanism and configured by the <emphasis role=\"strong"
"\">DEB_</emphasis>* configuration variables set in the <emphasis role="
"\"strong\">debian/rules</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4947
msgid ""
"Before the introduction of the <emphasis role=\"strong\">dh</emphasis> "
"command to the <emphasis role=\"strong\">debhelper</emphasis> package at the "
"version 7, the <emphasis role=\"strong\">CDBS</emphasis> was the only "
"approach to create a simple and clean <emphasis role=\"strong\">debian/"
"rules</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4948
msgid ""
"For many simple packages, the <emphasis role=\"strong\">dh</emphasis> "
"command alone allows us to make a simple and clean <emphasis role=\"strong"
"\">debian/rules</emphasis> file, now. It is desirable to keep the build "
"system simple and clean by not using the superfluous <emphasis role=\"strong"
"\">CDBS</emphasis>."
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:4949
msgid ""
"“The <emphasis role=\"strong\">CDBS</emphasis> magically does the job for me "
"with less typing” nor “I don’t understand the new <emphasis role=\"strong"
"\">dh</emphasis> syntax” can’t be the excuse to keep using the <emphasis "
"role=\"strong\">CDBS</emphasis> system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4950
msgid ""
"For some complicated packages such as GNOME related ones, the <emphasis role="
"\"strong\">CDBS</emphasis> is leveraged to automate their uniform packaging "
"by the current maintainers with reasons. If this is the case, please do not "
"bother converting from the <emphasis role=\"strong\">CDBS</emphasis> to the "
"<emphasis role=\"strong\">dh</emphasis> syntax."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4951
msgid "team"
msgstr ""

#. (itstool) path: note/simpara
#: debmake-doc.en.xml:4951
msgid ""
"If you are working with a <_:ulink-1/> of maintainers, please follow the "
"established practice of the team."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4952
msgid ""
"When converting packages from the <emphasis role=\"strong\">CDBS</emphasis> "
"to the <emphasis role=\"strong\">dh</emphasis> syntax, please use the "
"following as your reference:"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4956
msgid "CDBS Documentation"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4961
msgid "The Common Debian Build System (CDBS), FOSDEM 2009"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4967
msgid "Build under UTF-8"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4968
msgid ""
"The default locale of the build environment is <emphasis role=\"strong\">C</"
"emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4969
msgid ""
"Some programs such as the <emphasis role=\"strong\">read</emphasis> function "
"of Python3 change their behavior depending on the locale."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4970
msgid ""
"Adding the following code to the <emphasis role=\"strong\">debian/rules</"
"emphasis> file ensures to build the program under the <emphasis role=\"strong"
"\">C.UTF-8</emphasis> locale."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4975
msgid "UTF-8 conversion"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:4976
msgid "UTF-8"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4976
msgid ""
"If upstream documents are encoded in old encoding schemes, converting them "
"to <_:ulink-1/> is a good idea."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4977
msgid ""
"Use the <emphasis role=\"strong\">iconv</emphasis> command in the <emphasis "
"role=\"strong\">libc-bin</emphasis> package to convert encodings of plain "
"text files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4979
msgid ""
"Use <emphasis role=\"strong\">w3m</emphasis>(1) to convert from HTML files "
"to UTF-8 plain text files. When you do this, make sure to execute it under "
"UTF-8 locale."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4983
msgid ""
"Run these scripts in the <emphasis role=\"strong\">override_dh_</emphasis>* "
"target of the <emphasis role=\"strong\">debian/rules</emphasis> file."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:4986
msgid "Upload <emphasis role=\"strong\">orig.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4987
msgid ""
"When you first upload the package to the archive, you need to include the "
"original <emphasis role=\"strong\">orig.tar.gz</emphasis> source, too."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:4988
msgid ""
"If the Debian revision number of the package is either <emphasis role="
"\"strong\">1</emphasis> or <emphasis role=\"strong\">0</emphasis>, this is "
"the default. Otherwise, you must provide the <emphasis role=\"strong\">dpkg-"
"buildpackage</emphasis> option <emphasis role=\"strong\">-sa</emphasis> to "
"the <emphasis role=\"strong\">dpkg-buildpackage</emphasis> command."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4991
msgid "<emphasis role=\"strong\">dpkg-buildpackage -sa</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:4996
msgid "<emphasis role=\"strong\">debuild -sa</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5001
msgid "<emphasis role=\"strong\">pdebuild --debbuildopts -sa</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5006
msgid "<emphasis role=\"strong\">git-pbuilder -sa</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5011 debmake-doc.en.xml:5044
msgid ""
"For <emphasis role=\"strong\">gbp buildpackage</emphasis>, edit the "
"<emphasis role=\"strong\">~/.gbp.conf</emphasis> file."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:5016
msgid ""
"On the other hand, the <emphasis role=\"strong\">-sd</emphasis> option will "
"force the exclusion of the original <emphasis role=\"strong\">orig.tar.gz</"
"emphasis> source."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:5017
msgid ""
"Security uploads require to include the <emphasis role=\"strong\">orig.tar."
"gz</emphasis>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5020
msgid "Skipped uploads"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5021
msgid ""
"If you created multiple entries in the <emphasis role=\"strong\">debian/"
"changelog</emphasis> while skipping uploads, you must create a proper "
"<emphasis role=\"strong\">*_.changes</emphasis> file which includes all "
"changes since the last upload. This can be done by specifying the dpkg-"
"buildpackage option <emphasis role=\"strong\">-v</emphasis> with the last "
"uploaded version, e.g., <emphasis>1.2</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5024
msgid ""
"<emphasis role=\"strong\">dpkg-buildpackage -v</emphasis><emphasis>1.2</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5029
msgid "<emphasis role=\"strong\">debuild -v</emphasis><emphasis>1.2</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5034
msgid ""
"<emphasis role=\"strong\">pdebuild --debbuildopts -v</"
"emphasis><emphasis>1.2</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5039
msgid ""
"<emphasis role=\"strong\">git-pbuilder -v</emphasis><emphasis>1.2</emphasis>"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5051
msgid "Advanced packaging"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5052
msgid ""
"Hints for the following can be found in the <emphasis role=\"strong"
"\">debhelper</emphasis>(7) manpage:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5055
msgid ""
"differences of the debhelper tool behavior under “<emphasis role=\"strong"
"\">compat</emphasis> &lt;= 8”"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5060
msgid ""
"building several binary packages with several different build conditions"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5065
msgid "making multiple copies of the upstream source"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5070
msgid ""
"invoking multiple “<emphasis role=\"strong\">dh_auto_configure -S …</"
"emphasis>” commands in the <emphasis role=\"strong"
"\">override_dh_auto_configure</emphasis> target"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5075
msgid ""
"invoking multiple “<emphasis role=\"strong\">dh_auto_build -S …</emphasis>” "
"commands in the <emphasis role=\"strong\">override_dh_auto_build</emphasis> "
"target"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5080
msgid ""
"invoking multiple “<emphasis role=\"strong\">dh_auto_install -S …</"
"emphasis>” commands in the <emphasis role=\"strong"
"\">override_dh_auto_install</emphasis> target"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5088
msgid "Package-Type"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5087
msgid ""
"building <emphasis role=\"strong\">udeb</emphasis> packages with “<emphasis "
"role=\"strong\">Package-Type: udeb</emphasis>” in <emphasis role=\"strong"
"\">debian/control</emphasis> (see <_:ulink-1/>)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5093
msgid "BuildProfileSpec"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5092
msgid "excluding some packages for the bootstrapping (see also <_:ulink-1/>)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5097
msgid ""
"adding the <emphasis role=\"strong\">Build-Profiles</emphasis> fields in "
"binary package stanzas in <emphasis role=\"strong\">debian/control</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5102
msgid ""
"building packages with the <emphasis role=\"strong\">DEB_BUILD_PROFILES</"
"emphasis> environment variable set to the pertinent profile name"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5109
msgid ""
"Hints for the following can be found in the <emphasis role=\"strong\">dpkg-"
"source</emphasis>(1) manpage:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5112
msgid "naming convention for the multiple upstream source tarballs"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5117
msgid ""
"<emphasis>packagename_version</emphasis><emphasis role=\"strong\">.orig.tar."
"gz</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5122
msgid ""
"<emphasis>packagename_version</emphasis><emphasis role=\"strong\">.orig-</"
"emphasis><emphasis>componentname</emphasis><emphasis role=\"strong\">.tar."
"gz</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5129
msgid "recording the Debian changes to the upstream binary file"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5134
msgid "<emphasis role=\"strong\">dpkg-source --commit</emphasis>"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5143
msgid "Other distros"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5144
msgid ""
"Although the upstream tarball has all the information to build the Debian "
"package, it is not always easy to figure out which combination of options to "
"use."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5145
msgid ""
"Also, the upstream may be more focused on the feature enhancements and may "
"be less eager for backward compatibilities etc. which are important aspect "
"of the Debian packaging practice."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5146
msgid ""
"The leveraging of information from other distributions is an option to "
"address above issues."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5147
msgid ""
"If the other distribution in interest is a Debian derivative one, it is "
"trivial to reuse it."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5148
msgid "RPM"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5148
msgid "Repackage src.rpm"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5148
msgid ""
"If the other distribution in interest is a <_:ulink-1/> based distribution, "
"see <_:ulink-2/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5149
msgid ""
"Downloading and opening of the <emphasis role=\"strong\">src.rpm</emphasis> "
"file can be done with the <emphasis role=\"strong\">rget</emphasis> command. "
"(Place the <emphasis role=\"strong\">rget</emphasis> script in your PATH.)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5150
msgid "rget script"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5157
msgid ""
"Many upstream tarballs contain the SPEC file named as <emphasis>packagename</"
"emphasis>.<emphasis role=\"strong\">spec</emphasis> or "
"<emphasis>packagename</emphasis>.<emphasis role=\"strong\">spec.in</"
"emphasis> used by the RPM system. This can be used as the baseline for the "
"Debian package, too."
msgstr ""

#. (itstool) path: chapter/title
#: debmake-doc.en.xml:5161
msgid "More Examples"
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:5162
msgid ""
"There is an old Latin saying: “<emphasis role=\"strong\">fabricando fit "
"faber</emphasis>” (“practice makes perfect”)."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:5163
msgid ""
"It is highly recommended to practice and experiment with all the steps of "
"Debian packaging with simple packages. This chapter provides you with the "
"many upstream cases for your practice."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:5164
msgid ""
"This should also serve as introductory examples for many programing topics."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5167
msgid "Programing in the POSIX shell, Python3, and C."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5172
msgid ""
"Method to create the desktop GUI program launcher with the icon graphics."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5178
msgid "CLI"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5178
msgid "GUI"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5177
msgid "Conversion of command from <_:ulink-1/> to <_:ulink-2/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5183
msgid "internationalization and localization"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5182
msgid ""
"Conversion of program to use <emphasis role=\"strong\">gettext</emphasis> "
"for <_:ulink-1/>: POSIX shell, Python3, and C sources."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5187
msgid ""
"Overview of many build systems: Makefile, Python distutils, Autotools, and "
"CMake."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:5192
msgid "Please note Debian takes few things serious."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5195
msgid "Free software (a.k.a. Libre software)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5200
msgid "Stability and security of OS."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5205
msgid "Universal OS realized via:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5210
msgid "free choice for upstream sources,"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5215
msgid "free choice of CPU architectures, and"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5220
msgid "free choice of UI languages."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:5227
msgid ""
"The typical packaging example presented in <xref linkend=\"simple\"/> is the "
"prerequisite for this chapter."
msgstr ""

#. (itstool) path: chapter/simpara
#: debmake-doc.en.xml:5228
msgid ""
"Some details are intentionally left vague in the following. Please try to "
"read the pertinent documentation and practice yourself to find them out."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:5229
msgid ""
"The detailed log of all the package build examples can be obtained by "
"following the instruction in <xref linkend=\"details\"/>."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5230
#, fuzzy
msgid "Debian Code Search"
msgstr "Debian レファレンス"

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:5230
msgid ""
"The best source of the packaging example is the current Debian archive "
"itself. Please use the “<_:ulink-1/>” service to find pertinent examples."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5232
msgid "Cherry-pick templates"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5233
msgid ""
"Here is an example of creating a simple Debian package from a zero content "
"source on an empty directory."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5234
msgid ""
"This is a good platform to get all the template files without making mess in "
"the upstream source tree you are working on."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5235
msgid ""
"Let’s assume this empty directory to be <emphasis role=\"strong"
"\">debhello-0.1</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5242
msgid ""
"Let’s generate the maximum amount of template files by specifying the "
"<emphasis role=\"strong\">-x4</emphasis> option."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5243
msgid ""
"Let’s also use the “<emphasis role=\"strong\">-p</emphasis> "
"<emphasis>debhello</emphasis> <emphasis role=\"strong\">-t -u</emphasis> "
"<emphasis>0.1</emphasis> <emphasis role=\"strong\">-r</emphasis> "
"<emphasis>1”</emphasis> options to make missing upstream tarball."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5282
msgid ""
"Now you can copy any of these generated template files in the "
"<emphasis>debhello-0.1/</emphasis><emphasis role=\"strong\">debian/</"
"emphasis> directory to your package as needed while renaming them as needed."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:5283
msgid ""
"The generated template files can be made more verbose ones by invoking the "
"<emphasis role=\"strong\">debmake</emphasis> command with the <emphasis role="
"\"strong\">-T</emphasis> option (tutorial mode)."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5286
msgid "No Makefile (shell, CLI)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5287
msgid ""
"Here is an example of creating a simple Debian package from a POSIX shell "
"CLI program without its build system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5288
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-0.2.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5289
msgid ""
"This type of source has no automated means and files must be installed "
"manually."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5294 debmake-doc.en.xml:5611 debmake-doc.en.xml:5739
#: debmake-doc.en.xml:5939 debmake-doc.en.xml:6072 debmake-doc.en.xml:6252
#: debmake-doc.en.xml:6380 debmake-doc.en.xml:6569 debmake-doc.en.xml:6730
#: debmake-doc.en.xml:6914 debmake-doc.en.xml:7281 debmake-doc.en.xml:7584
msgid "Let’s get the source and make the Debian package."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5295
msgid "Download <emphasis role=\"strong\">debhello-0.2.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5314
msgid ""
"Here, the POSIX shell script <emphasis role=\"strong\">hello</emphasis> is a "
"very simple one."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5315
msgid "<emphasis role=\"strong\">hello</emphasis> (v=0.2)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5323
msgid "Desktop Entry Specification"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5323
msgid ""
"Here, the <emphasis role=\"strong\">hello.desktop</emphasis> supports <_:"
"ulink-1/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5324
msgid "<emphasis role=\"strong\">hello.desktop</emphasis> (v=0.2)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5338
msgid ""
"Here, the <emphasis role=\"strong\">hello.png</emphasis> is the icon "
"graphics file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5339 debmake-doc.en.xml:5663 debmake-doc.en.xml:5982
msgid ""
"Let’s package this with the <emphasis role=\"strong\">debmake</emphasis> "
"command. Here, the <emphasis role=\"strong\">-b':sh'</emphasis> option is "
"used to specify the generated binary package is a shell script."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5353 debmake-doc.en.xml:5677 debmake-doc.en.xml:5829
#: debmake-doc.en.xml:5996 debmake-doc.en.xml:6521 debmake-doc.en.xml:6680
#: debmake-doc.en.xml:6824 debmake-doc.en.xml:7088 debmake-doc.en.xml:7384
msgid "Let’s inspect notable template files generated."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5354
msgid ""
"The source tree after the basic <emphasis role=\"strong\">debmake</emphasis> "
"execution. (v=0.2)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5385
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=0.2):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5394
msgid ""
"This is essentially the standard <emphasis role=\"strong\">debian/rules</"
"emphasis> file with the <emphasis role=\"strong\">dh</emphasis> command. "
"Since this is the script package, this template <emphasis role=\"strong"
"\">debian/rules</emphasis> file has no build flag related contents."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5395
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (template file, v=0.2):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5413
msgid ""
"Since this is the shell script package, the <emphasis role=\"strong"
"\">debmake</emphasis> command sets “<emphasis role=\"strong\">Architecture: "
"all</emphasis>” and “<emphasis role=\"strong\">Multi-Arch: foreign</"
"emphasis>”. Also, it sets required <emphasis role=\"strong\">substvar</"
"emphasis> parameters as “<emphasis role=\"strong\">Depends: ${misc:Depends}</"
"emphasis>”. These are explained in <xref linkend=\"basics\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5414
msgid ""
"Since this upstream source lacks the upstream <emphasis role=\"strong"
"\">Makefile</emphasis>, that functionality needs to be provided by the "
"maintainer. This upstream contains only a script file and data files and no "
"C source files, the <emphasis role=\"strong\">build</emphasis> process can "
"be skipped but the <emphasis role=\"strong\">install</emphasis> process "
"needs to be implemented. For this case, this is achieved cleanly by adding "
"the <emphasis role=\"strong\">debian/install</emphasis> and <emphasis role="
"\"strong\">debian/manpages</emphasis> files without complicating the "
"<emphasis role=\"strong\">debian/rules</emphasis> file."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5415 debmake-doc.en.xml:5693 debmake-doc.en.xml:5862
#: debmake-doc.en.xml:6015 debmake-doc.en.xml:6197 debmake-doc.en.xml:6534
#: debmake-doc.en.xml:6696 debmake-doc.en.xml:6859 debmake-doc.en.xml:7108
#: debmake-doc.en.xml:7405
msgid "Let’s make this Debian package better as the maintainer."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5416
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=0.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5426
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=0.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5449
msgid ""
"<emphasis role=\"strong\">debian/install</emphasis> (maintainer version, "
"v=0.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5457
msgid ""
"<emphasis role=\"strong\">debian/manpages</emphasis> (maintainer version, "
"v=0.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5464
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=0.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5509
msgid ""
"The generated files of <emphasis role=\"strong\">debhello</emphasis> version "
"<emphasis role=\"strong\">0.2</emphasis> by the <emphasis role=\"strong"
"\">debuild</emphasis> command:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5527
msgid ""
"The <emphasis role=\"strong\">debhello_0.2.orig.tar.gz</emphasis> is a "
"symlink to the upstream tarball."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5532
msgid ""
"The <emphasis role=\"strong\">debhello_0.2-1.debian.tar.xz</emphasis> "
"contains the maintainer generated contents."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5537
msgid ""
"The <emphasis role=\"strong\">debhello_0.2-1.dsc</emphasis> is the meta data "
"file for the Debian source package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5542
msgid ""
"The <emphasis role=\"strong\">debhello_0.2-1_amd64.deb</emphasis> is the "
"Debian binary package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:5547
msgid ""
"The <emphasis role=\"strong\">debhello_0.2-1_amd64.changes</emphasis> is the "
"meta data file for the Debian binary package."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5552
msgid ""
"The <emphasis role=\"strong\">debhello_0.2-1.debian.tar.xz</emphasis> "
"contains the Debian changes to the upstream source as follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5553
msgid ""
"The compressed archive contents of <emphasis role=\"strong\">debhello_0.2-1."
"debian.tar.xz</emphasis>:"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5580
msgid ""
"The <emphasis role=\"strong\">debhello_0.2-1_amd64.deb</emphasis> contains "
"the files to be installed as follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5581
msgid ""
"The binary package contents of <emphasis role=\"strong"
"\">debhello_0.2-1_amd64.deb</emphasis>:"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5603
msgid "Makefile (shell, CLI)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5604
msgid ""
"Here is an example of creating a simple Debian package from a POSIX shell "
"CLI program using the <emphasis role=\"strong\">Makefile</emphasis> as its "
"build system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5605
msgid ""
"Let’s assume its upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.0.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5612
msgid "Download <emphasis role=\"strong\">debhello-1.0.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5632
msgid ""
"Here, the <emphasis role=\"strong\">Makefile</emphasis> uses <emphasis role="
"\"strong\">$(DESTDIR)</emphasis> and <emphasis role=\"strong\">$(prefix)</"
"emphasis> properly. All other files are the same as <xref linkend="
"\"nomakefile\"/> and most of the packaging activities are the same."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5633
msgid "<emphasis role=\"strong\">Makefile</emphasis> (v=1.0)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5678
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=1.0):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5694
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=1.0):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5707
msgid ""
"Since this upstream source has the proper upstream <emphasis role=\"strong"
"\">Makefile</emphasis>, there are no needs to create <emphasis role=\"strong"
"\">debian/install</emphasis> and <emphasis role=\"strong\">debian/manpages</"
"emphasis> files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5708
msgid ""
"The <emphasis role=\"strong\">debian/control</emphasis> file is exactly the "
"same as the one in <xref linkend=\"nomakefile\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5710
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=1.0):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5728
msgid ""
"The rest of the packaging activities are practically the same as the one in "
"<xref linkend=\"nomakefile\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5731
msgid "setup.py (Python3, CLI)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5732
msgid ""
"Here is an example of creating a simple Debian package from a Python3 CLI "
"program using the <emphasis role=\"strong\">setup.py</emphasis> as its build "
"system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5733
msgid ""
"Let’s assume its upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.1.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5738
msgid ""
"Debian packaging requires to change the last line to “<emphasis role=\"strong"
"\">python3 setup.py install --install-layout=deb</emphasis>” to install "
"files to the target system image location. This issue is automatically "
"addressed when using the <emphasis role=\"strong\">dh</emphasis> command for "
"the Debian packaging."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5740
msgid "Download <emphasis role=\"strong\">debhello-1.1.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5759
msgid ""
"Here, the <emphasis role=\"strong\">hello</emphasis> script and its "
"associated <emphasis role=\"strong\">hello_py</emphasis> module are as "
"follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5760
msgid "<emphasis role=\"strong\">hello</emphasis> (v=1.1)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5768
msgid "<emphasis role=\"strong\">hello_py/__init__.py</emphasis> (v=1.1)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5779
msgid ""
"These are packaged using the Python <_:ulink-1/> with the <emphasis role="
"\"strong\">setup.py</emphasis> and <emphasis role=\"strong\">MANIFEST.in</"
"emphasis> files."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5780
msgid "<emphasis role=\"strong\">setup.py</emphasis> (v=1.1)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5809
msgid "<emphasis role=\"strong\">MANIFEST.in</emphasis> (v=1.1)"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:5814
msgid "setuptools"
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:5814
msgid ""
"Many modern Python packages are distributed using <_:ulink-1/>. Since "
"setuptools is an enhanced alternative to distutils, this example is useful "
"for them."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5815 debmake-doc.en.xml:6182
msgid ""
"Let’s package this with the <emphasis role=\"strong\">debmake</emphasis> "
"command. Here, the <emphasis role=\"strong\">-b':py3'</emphasis> option is "
"used to specify the generated binary package contain Python3 script and "
"module files."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5830
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=1.1):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5839
msgid ""
"This is essentially the standard <emphasis role=\"strong\">debian/rules</"
"emphasis> file with the <emphasis role=\"strong\">dh</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5840
msgid ""
"The use of “<emphasis role=\"strong\">--with python3</emphasis>” option "
"invokes <emphasis role=\"strong\">dh_python3</emphasis> to calculate Python "
"dependencies, adds maintainer scripts to byte compile files, etc. See "
"<emphasis role=\"strong\">dh_python3</emphasis>(1)."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5841
msgid ""
"The use of “<emphasis role=\"strong\">--buildsystem=pybuild</emphasis>” "
"option invokes various build systems for requested Python versions in order "
"to build modules and extensions. See <emphasis role=\"strong\">pybuild</"
"emphasis>(1)."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5842
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (template file, v=1.1):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5861
msgid ""
"Since this is the Python3 package, the <emphasis role=\"strong\">debmake</"
"emphasis> command sets “<emphasis role=\"strong\">Architecture: all</"
"emphasis>” and “<emphasis role=\"strong\">Multi-Arch: foreign</emphasis>”. "
"Also, it sets required <emphasis role=\"strong\">substvar</emphasis> "
"parameters as “<emphasis role=\"strong\">Depends: ${python3:Depends}, ${misc:"
"Depends}</emphasis>”. These are explained in <xref linkend=\"basics\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5863
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=1.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5873
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=1.1):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5897
msgid ""
"The <emphasis role=\"strong\">hello</emphasis> command does not come with "
"the upstream provided manpage, let’s add it as the maintainer."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5898
msgid ""
"<emphasis role=\"strong\">debian/manpages</emphasis> etc. (maintainer "
"version, v=1.1):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5907 debmake-doc.en.xml:6060
msgid ""
"The rest of the packaging activities are practically the same as the one in "
"<xref linkend=\"makefile-sh\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5908
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=1.1):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5928 debmake-doc.en.xml:6061 debmake-doc.en.xml:6235
#: debmake-doc.en.xml:6363
msgid "Here is the generated dependency list of binary packages."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5929
msgid "The generated dependency list of binary packages (v=1.1):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:5935
msgid "Makefile (shell, GUI)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5936
msgid ""
"Here is an example of creating a simple Debian package from a POSIX shell "
"GUI program using the <emphasis role=\"strong\">Makefile</emphasis> as its "
"build system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5937
msgid ""
"This upstream is based in <xref linkend=\"makefile-sh\"/> with enhanced GUI "
"support."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5938
msgid ""
"Let’s assume its upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.2.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5940
msgid "Download <emphasis role=\"strong\">debhello-1.2.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5960
msgid ""
"Here, the <emphasis role=\"strong\">hello</emphasis> has been re-written to "
"use the <emphasis role=\"strong\">zenity</emphasis> command to make this a "
"GTK+ GUI program."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5961
msgid "<emphasis role=\"strong\">hello</emphasis> (v=1.2)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5966
msgid ""
"Here, the desktop file is updated to be <emphasis role=\"strong"
"\">Terminal=false</emphasis> as a GUI program."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5967
msgid "<emphasis role=\"strong\">hello.desktop</emphasis> (v=1.2)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:5981
msgid "All other files are the same as <xref linkend=\"makefile-sh\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:5997
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (template file, v=1.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6016
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=1.2):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6039
msgid "Please note manually added <emphasis role=\"strong\">zenity</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6040
msgid ""
"The <emphasis role=\"strong\">debian/rules</emphasis> file is exactly the "
"same as the one in <xref linkend=\"makefile-sh\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6042
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=1.2):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6062
msgid "The generated dependency list of binary packages (v=1.2):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:6068
msgid "setup.py (Python3, GUI)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6069
msgid ""
"Here is an example of creating a simple Debian package from a Python3 GUI "
"program using the <emphasis role=\"strong\">setup.py</emphasis> as its build "
"system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6070
msgid ""
"This upstream is based in <xref linkend=\"setup-py\"/> with enhanced GUI, "
"desktop icon, and manpage supports."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6071
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.3.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6073
msgid "Download <emphasis role=\"strong\">debhello-1.3.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6097
msgid "Here are the upstream sources."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6098
msgid "<emphasis role=\"strong\">hello</emphasis> (v=1.3)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6106
msgid "<emphasis role=\"strong\">hello_py/__init__.py</emphasis> (v=1.3)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6140
msgid "<emphasis role=\"strong\">setup.py</emphasis> (v=1.3)"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6174
msgid "<emphasis role=\"strong\">MANIFEST.in</emphasis> (v=1.3)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6196
msgid "The result is practically the same as <xref linkend=\"setup-py\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6198
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=1.3):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6208
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=1.3):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6232
msgid ""
"Please note manually added <emphasis role=\"strong\">python3-gi</emphasis> "
"and <emphasis role=\"strong\">gir1.2-gtk-3.0</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6233
msgid ""
"Since this upstream source has manpage and other files with matching entries "
"in the <emphasis role=\"strong\">setup.py</emphasis> file, there are no "
"needs to create them and add <emphasis role=\"strong\">debian/install</"
"emphasis> and <emphasis role=\"strong\">debian/manpages</emphasis> files "
"which was required in <xref linkend=\"setup-py\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6234
msgid ""
"The rest of the packaging activities are practically the same as the one in "
"<xref linkend=\"setup-py\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6236
msgid "The generated dependency list of binary packages (v=1.3):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:6242
msgid "Makefile (single-binary)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6244
msgid ""
"This is an enhanced upstream source example for <xref linkend=\"simple\"/>. "
"This comes with the manpage, the desktop file, and the desktop icon. This "
"also links to an external library <emphasis role=\"strong\">libm</emphasis> "
"to be a more practical example."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6245
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.4.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6253
msgid "Download <emphasis role=\"strong\">debhello-1.4.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6274 debmake-doc.en.xml:6402 debmake-doc.en.xml:6592
#: debmake-doc.en.xml:6753 debmake-doc.en.xml:6941 debmake-doc.en.xml:7308
msgid "Here, the contents of this source are as follows."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6275
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (v=1.4):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6288
msgid "<emphasis role=\"strong\">src/config.h</emphasis> (v=1.4):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6292
msgid "<emphasis role=\"strong\">Makefile</emphasis> (v=1.4):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6324
msgid ""
"Please note that this <emphasis role=\"strong\">Makefile</emphasis> has the "
"proper <emphasis role=\"strong\">install</emphasis> target for the manpage, "
"the desktop file, and the desktop icon."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6325 debmake-doc.en.xml:6506 debmake-doc.en.xml:6665
#: debmake-doc.en.xml:6809 debmake-doc.en.xml:7369
msgid ""
"Let’s package this with the <emphasis role=\"strong\">debmake</emphasis> "
"command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6339
msgid "The result is practically the same as <xref linkend=\"step-debmake\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6340
msgid ""
"Let’s make this Debian package better as the maintainer which is practically "
"the same as <xref linkend=\"step-maintainer\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6341
msgid ""
"If the <emphasis role=\"strong\">DEB_BUILD_MAINT_OPTIONS</emphasis> is not "
"exported in the <emphasis role=\"strong\">debian/rules</emphasis>, the "
"lintian warns \"W: debhello: hardening-no-relro usr/bin/hello\" for the "
"linking of the <emphasis role=\"strong\">libm</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6342
msgid ""
"The <emphasis role=\"strong\">debian/control</emphasis> file making it "
"exactly the same as one in <xref linkend=\"step-maintainer\"/>, since the "
"<emphasis role=\"strong\">libm</emphasis> library is always available as a "
"part of the <emphasis role=\"strong\">libc6</emphasis> (Priority: required)."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6344
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=1.4):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6362 debmake-doc.en.xml:6554 debmake-doc.en.xml:6715
msgid ""
"The rest of the packaging activities are practically the same as the one in "
"<xref linkend=\"step-debuild\"/>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6364
msgid "The generated dependency list of binary packages (v=1.4):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:6370
msgid "Makefile.in + configure (single-binary)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6371
msgid ""
"Here is an example of creating a simple Debian package from a simple C "
"source using the <emphasis role=\"strong\">Makefile.in</emphasis> and "
"<emphasis role=\"strong\">configure</emphasis> as its build system."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6372
msgid ""
"This is an enhanced upstream source example for <xref linkend=\"makefile-"
"single\"/>. This also links to an external library <emphasis role=\"strong"
"\">libm</emphasis> and this source is configurable using arguments to the "
"<emphasis role=\"strong\">configure</emphasis> script which generates the "
"<emphasis role=\"strong\">Makefile</emphasis> and <emphasis role=\"strong"
"\">src/config.h</emphasis> files."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6373
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.5.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6374 debmake-doc.en.xml:6562 debmake-doc.en.xml:6722
#: debmake-doc.en.xml:6907 debmake-doc.en.xml:7273
msgid ""
"This type of source is meant to be installed as a non-system file, for "
"example, as:"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6381
msgid "Download <emphasis role=\"strong\">debhello-1.5.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6403
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (v=1.5):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6422
msgid "<emphasis role=\"strong\">Makefile.in</emphasis> (v=1.5):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6459
msgid "<emphasis role=\"strong\">configure</emphasis> (v=1.5):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6505
msgid ""
"Please note that the <emphasis role=\"strong\">configure</emphasis> command "
"replaces strings with <emphasis role=\"strong\">@…@</emphasis> in the "
"<emphasis role=\"strong\">Makefile.in</emphasis> to produce <emphasis role="
"\"strong\">Makefile</emphasis> and creates <emphasis role=\"strong\">src/"
"config.h</emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6520
msgid ""
"The result is similar to <xref linkend=\"step-debmake\"/> but not exactly "
"the same."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6522
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=1.5):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6535
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=1.5):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:6557
msgid "Autotools (single-binary)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6558
msgid ""
"Here is an example of creating a simple Debian package from a simple C "
"source using the Autotools = Autoconf and Automake (<emphasis role=\"strong"
"\">Makefile.am</emphasis> and <emphasis role=\"strong\">configure.ac</"
"emphasis>) as its build system. See <xref linkend=\"autotools\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6559
msgid ""
"This source usually comes with the upstream auto-generated <emphasis role="
"\"strong\">Makefile.in</emphasis> and <emphasis role=\"strong\">configure</"
"emphasis> files, too. This source can be packaged using these files as <xref "
"linkend=\"configure-single\"/> with the help of the <emphasis role=\"strong"
"\">autotools-dev</emphasis> package."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6560
msgid ""
"The better alternative is to regenerate these files using the latest "
"Autoconf and Automake packages if the upstream provided <emphasis role="
"\"strong\">Makefile.am</emphasis> and <emphasis role=\"strong\">configure."
"ac</emphasis> are compatible with the latest version. This is advantageous "
"for the porting to the new CPU architectures etc. This can be automated by "
"using the “<emphasis role=\"strong\">--with autoreconf</emphasis>” option "
"for the <emphasis role=\"strong\">dh</emphasis> command."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6561
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.6.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6570
msgid "Download <emphasis role=\"strong\">debhello-1.6.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6593
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (v=1.6):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6612
msgid "<emphasis role=\"strong\">Makefile.am</emphasis> (v=1.6):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6621
msgid "<emphasis role=\"strong\">configure.ac</emphasis> (v=1.6):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6679 debmake-doc.en.xml:6823 debmake-doc.en.xml:7383
msgid ""
"The result is similar to <xref linkend=\"configure-single\"/> but not "
"exactly the same."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6681
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=1.6):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6697
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=1.6):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:6718
msgid "CMake (single-binary)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6719
msgid ""
"Here is an example of creating a simple Debian package from a simple C "
"source using the CMake (<emphasis role=\"strong\">CMakeLists.txt</emphasis> "
"and some files such as <emphasis role=\"strong\">config.h.in</emphasis>) as "
"its build system. See <xref linkend=\"cmake\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6720
msgid ""
"The <emphasis role=\"strong\">cmake</emphasis> command generates the "
"<emphasis role=\"strong\">Makefile</emphasis> file based on the <emphasis "
"role=\"strong\">CMakeLists.txt</emphasis> file and its <emphasis role="
"\"strong\">-D</emphasis> option. It also configure the file as specified in "
"its <emphasis role=\"strong\">configure_file(…)</emphasis> by replacing "
"strings with <emphasis role=\"strong\">@…@</emphasis> and changing <emphasis "
"role=\"strong\">#cmakedefine …</emphasis> line."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6721
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-1.7.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6731
msgid "Download <emphasis role=\"strong\">debhello-1.7.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6754
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (v=1.7):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6773
msgid "<emphasis role=\"strong\">src/config.h.in</emphasis> (v=1.7):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6780
msgid "<emphasis role=\"strong\">CMakeLists.txt</emphasis> (v=1.7):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6825
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=1.7):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6841
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (template file, v=1.7):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6860
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=1.7):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6876
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=1.7):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6900 debmake-doc.en.xml:7254 debmake-doc.en.xml:7564
msgid ""
"The rest of the packaging activities are practically the same as the one in "
"<xref linkend=\"configure-single\"/>."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:6903
msgid "Autotools (multi-binary)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6904
msgid ""
"Here is an example of creating a set of Debian binary packages including the "
"executable package, the shared library package, the development file "
"package, and the debug symbol package from a simple C source using the "
"Autotools = Autoconf and Automake (<emphasis role=\"strong\">Makefile.am</"
"emphasis> and <emphasis role=\"strong\">configure.ac</emphasis>) as its "
"build system. See <xref linkend=\"autotools\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6905
msgid ""
"Let’s package this in the same way as <xref linkend=\"autotools-single\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:6906
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-2.0.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6915
msgid "Download <emphasis role=\"strong\">debhello-2.0.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6942
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (v=2.0):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6955
msgid ""
"<emphasis role=\"strong\">lib/sharedlib.h</emphasis> and <emphasis role="
"\"strong\">lib/sharedlib.c</emphasis> (v=1.6):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:6967
msgid "<emphasis role=\"strong\">Makefile.am</emphasis> (v=2.0):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7005
msgid "<emphasis role=\"strong\">configure.ac</emphasis> (v=2.0):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7041
msgid ""
"Let’s package this with the <emphasis role=\"strong\">debmake</emphasis> "
"command into multiple packages:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7044
msgid ""
"<emphasis role=\"strong\">debhello</emphasis>: type = <emphasis role=\"strong"
"\">bin</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7049
msgid ""
"<emphasis role=\"strong\">libsharedlib1</emphasis>: type = <emphasis role="
"\"strong\">lib</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7054
msgid ""
"<emphasis role=\"strong\">libsharedlib-dev</emphasis>: type = <emphasis role="
"\"strong\">dev</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7059
msgid ""
"<emphasis role=\"strong\">debhello-dbg</emphasis>: type = <emphasis role="
"\"strong\">dbg</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7064
msgid ""
"<emphasis role=\"strong\">libsharedlib1-dbg</emphasis>: type = <emphasis "
"role=\"strong\">dbg</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7069
msgid ""
"Here, the <emphasis role=\"strong\">-b',libsharedlib1,libsharedlib-dev,-dbg,"
"libsharedlib1-dbg'</emphasis> option is used to specify the generated binary "
"packages."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7087
msgid ""
"The result is similar to <xref linkend=\"configure-single\"/> but with more "
"template files."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7089
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=2.0):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7109
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=2.0):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7129
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=2.0):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7213
msgid ""
"<emphasis role=\"strong\">debian/*.install</emphasis> (maintainer version, "
"v=2.0):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7230 debmake-doc.en.xml:7539
msgid ""
"Since this upstream source creates the proper auto-generated <emphasis role="
"\"strong\">Makefile</emphasis>, there are no needs to create <emphasis role="
"\"strong\">debian/install</emphasis> and <emphasis role=\"strong\">debian/"
"manpages</emphasis> files."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7232
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=2.0):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7255 debmake-doc.en.xml:7565
msgid "Here are the generated dependency lists of binary packages."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7256
msgid "The generated dependency lists of binary packages (v=2.0):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:7270
msgid "CMake (multi-binary)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7271
msgid ""
"Here is an example of creating a set of Debian binary packages including the "
"executable package, the shared library package, the development file "
"package, and the debug symbol package from a simple C source using the CMake "
"(<emphasis role=\"strong\">CMakeLists.txt</emphasis> and some files such as "
"<emphasis role=\"strong\">config.h.in</emphasis>) as its build system. See "
"<xref linkend=\"cmake\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7272
msgid ""
"Let’s assume this upstream tarball to be <emphasis role=\"strong"
"\">debhello-2.1.tar.gz</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7282
msgid "Download <emphasis role=\"strong\">debhello-2.1.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7309
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7322
msgid "<emphasis role=\"strong\">src/config.h.in</emphasis> (v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7327
msgid ""
"<emphasis role=\"strong\">lib/sharedlib.c</emphasis> and <emphasis role="
"\"strong\">lib/sharedlib.h</emphasis> (v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7339
msgid "<emphasis role=\"strong\">CMakeLists.txt</emphasis> (v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7385
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (template file, v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7406
msgid ""
"<emphasis role=\"strong\">debian/rules</emphasis> (maintainer version, "
"v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7431
msgid ""
"<emphasis role=\"strong\">debian/control</emphasis> (maintainer version, "
"v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7515
msgid ""
"<emphasis role=\"strong\">debian/*.install</emphasis> (maintainer version, "
"v=2.1):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7532
msgid ""
"This upstream CMakeList.txt needs to be patched to cope with the multiarch "
"path."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7533
msgid ""
"<emphasis role=\"strong\">debian/patches/</emphasis>* (maintainer version, "
"v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7541
msgid ""
"Template files under <emphasis role=\"strong\">debian/</emphasis>. (v=2.1):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7566
msgid "The generated dependency lists of binary packages (v=2.1):"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:7580
msgid "Internationalization"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7581
msgid ""
"Here is an example of updating the simple upstream C source <emphasis role="
"\"strong\">debhello-2.0.tar.gz</emphasis> presented in <xref linkend="
"\"autotools-multi\"/> for the internationalization (i18n) and creating the "
"updated upstream C source <emphasis role=\"strong\">debhello-2.0.tar.gz</"
"emphasis>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7582
msgid ""
"In the real situation, the package should be already internationalized. So "
"this example is educational for you to understand how this "
"internationalization is implemented."
msgstr ""

#. (itstool) path: tip/simpara
#: debmake-doc.en.xml:7583
msgid ""
"The routine maintainer activity for the i18n is simply to add translation po "
"files reported to you via BTS system to the <emphasis role=\"strong\">po/</"
"emphasis> directory and to update the language list in the <emphasis role="
"\"strong\">po/LINGUAS</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7585
msgid ""
"Download <emphasis role=\"strong\">debhello-2.0.tar.gz</emphasis> (i18n)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7611
msgid ""
"Internationalize this source tree with the <emphasis role=\"strong"
"\">gettextize</emphasis> command and remove files auto-generated by the "
"Autotools."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7612
msgid "run <emphasis role=\"strong\">gettextize</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7671
msgid ""
"Let’s check generated files under the <emphasis role=\"strong\">po/</"
"emphasis> directory."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7672
msgid "files in <emphasis role=\"strong\">po</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7686
msgid ""
"Let’s update the <emphasis role=\"strong\">configure.ac</emphasis> by adding "
"“<emphasis role=\"strong\">AM_GNU_GETTEXT([external])</emphasis>”, etc.."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7687
msgid "<emphasis role=\"strong\">configure.ac</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7730
msgid ""
"Let’s create the <emphasis role=\"strong\">po/Makevars</emphasis> from the "
"<emphasis role=\"strong\">po/Makevars.template</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7731
msgid "<emphasis role=\"strong\">po/Makevars</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7755
msgid ""
"Let’s update C sources for the i18n by wrapping strings with <emphasis role="
"\"strong\">_(…)</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7756
msgid "<emphasis role=\"strong\">src/hello.c</emphasis> (i18n):"
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7771
msgid "<emphasis role=\"strong\">lib/sharedlib.c</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7783
msgid ""
"The new <emphasis role=\"strong\">gettext</emphasis> (v=0.19) can handle the "
"i18n of the desktop file directly."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7784
msgid "<emphasis role=\"strong\">data/hello.desktop.in</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7798
msgid ""
"Let’s list the input files to extract translatable strings in <emphasis role="
"\"strong\">po/POTFILES.in</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7799
msgid "<emphasis role=\"strong\">po/POTFILES.in</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7806
msgid ""
"Here is the updated root <emphasis role=\"strong\">Makefile.am</emphasis> "
"with <emphasis role=\"strong\">po</emphasis> added to the <emphasis role="
"\"strong\">SUBDIRS</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7807
msgid "<emphasis role=\"strong\">Makefile.am</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7816
msgid ""
"Let’s make a translation template file <emphasis role=\"strong\">debhello."
"pot</emphasis>."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7817
msgid "<emphasis role=\"strong\">po/debhello.pot</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7865
msgid "Let’s add Japanese translation."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7866
msgid ""
"<emphasis role=\"strong\">po/LINGUAS</emphasis> and <emphasis role=\"strong"
"\">po/fr.po</emphasis> (i18n):"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7915
msgid ""
"The packaging activities are practically the same as the one in <xref "
"linkend=\"autotools-multi\"/>."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7916
msgid "You can find more i18n examples in <xref linkend=\"details\"/> for"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7919
msgid "the POSIX shell script with the Makefile (v=3.0),"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7924
msgid "the Python3 script with the distutils (v=3.1),"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7929
msgid "the C source with the Makefile.in + configure (v=3.2),"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7934
msgid "the C source with the Autotools (v=3.3), and"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7939
msgid "the C source with the CMake (v=3.4)."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:7946
msgid "Details"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7947
msgid ""
"Actual details of the examples presented and their variants can be obtained "
"by the following."
msgstr ""

#. (itstool) path: formalpara/title
#: debmake-doc.en.xml:7948
msgid "How to get details"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7955
msgid ""
"Each directory with the <emphasis role=\"strong\">-pkg[0-9]</emphasis> "
"suffix contains the Debian packaging example."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7958
msgid ""
"emulated console command line activity log: the <emphasis role=\"strong\">."
"log</emphasis> file"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7963
msgid ""
"emulated console command line activity log (short): the <emphasis role="
"\"strong\">.slog</emphasis> file"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7968
msgid ""
"snapshot source tree image after the <emphasis role=\"strong\">debmake</"
"emphasis> command: the <emphasis role=\"strong\">debmake</emphasis> directory"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7973
msgid ""
"snapshot source tree image after the properly packaging: the <emphasis role="
"\"strong\">packge</emphasis> directory"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:7978
msgid ""
"snapshot source tree image after the <emphasis role=\"strong\">debuild</"
"emphasis> command: the <emphasis role=\"strong\">test</emphasis> directory"
msgstr ""

#. (itstool) path: appendix/title
#: debmake-doc.en.xml:7986
msgid "<emphasis role=\"strong\">debmake</emphasis>(1) manpage"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:7988
msgid "NAME"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7989
msgid "debmake - program to make the Debian source package"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:7992
msgid "SYNOPSIS"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7993
msgid ""
"<emphasis role=\"strong\">debmake</emphasis> [<emphasis role=\"strong\">-h</"
"emphasis>] [<emphasis role=\"strong\">-c</emphasis> | <emphasis role=\"strong"
"\">-k</emphasis>] [<emphasis role=\"strong\">-n</emphasis> | <emphasis role="
"\"strong\">-a</emphasis> <emphasis>package-version</emphasis><emphasis role="
"\"strong\">.orig.tar.gz</emphasis> | <emphasis role=\"strong\">-d</emphasis> "
"| <emphasis role=\"strong\">-t</emphasis> ] [<emphasis role=\"strong\">-p</"
"emphasis> <emphasis>package</emphasis>] [<emphasis role=\"strong\">-u</"
"emphasis> <emphasis>version</emphasis>] [<emphasis role=\"strong\">-r</"
"emphasis> <emphasis>revision</emphasis>] [<emphasis role=\"strong\">-z</"
"emphasis> <emphasis>extension</emphasis>] [<emphasis role=\"strong\">-b</"
"emphasis> \"<emphasis>binarypackage</emphasis><emphasis><phrase role=\":"
"__type__\">, …</phrase></emphasis>]\" [<emphasis role=\"strong\">-e</"
"emphasis> <emphasis>foo@example.org</emphasis>] [<emphasis role=\"strong\">-"
"f</emphasis> \"<emphasis>firstname lastname</emphasis>\"] [<emphasis role="
"\"strong\">-i</emphasis> \"<emphasis>buildtool</emphasis>\" | <emphasis role="
"\"strong\">-j</emphasis>] [<emphasis role=\"strong\">-l</emphasis> "
"<emphasis>license_file</emphasis>] [<emphasis role=\"strong\">-m</emphasis>] "
"[<emphasis role=\"strong\">-o</emphasis> <emphasis>file</emphasis>] "
"[<emphasis role=\"strong\">-q</emphasis>] [<emphasis role=\"strong\">-s</"
"emphasis>] [<emphasis role=\"strong\">-v</emphasis>] [<emphasis role=\"strong"
"\">-w</emphasis> \"<emphasis>addon, …</emphasis>\"] [<emphasis role=\"strong"
"\">-x</emphasis> [01234]] [<emphasis role=\"strong\">-y</emphasis>] "
"[<emphasis role=\"strong\">-P</emphasis>] [<emphasis role=\"strong\">-T</"
"emphasis>]"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:7996
msgid "DESCRIPTION"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:7997
msgid ""
"<emphasis role=\"strong\">debmake</emphasis> helps to build the Debian "
"package from the upstream source. Normally, this is done as follows:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8005
msgid ""
"It is untared to create many files under the <emphasis>package-version/</"
"emphasis> directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8010
msgid ""
"debmake is invoked in the <emphasis>package-version/</emphasis> directory "
"possibly without any arguments."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8015
msgid ""
"Files in the <emphasis>package-version</emphasis><emphasis role=\"strong\">/"
"debian/</emphasis> directory are manually adjusted."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8020
msgid ""
"<emphasis role=\"strong\">dpkg-buildpackage</emphasis> (usually from its "
"wrapper <emphasis role=\"strong\">debuild</emphasis> or <emphasis role="
"\"strong\">pdebuild</emphasis>) is invoked in the <emphasis>package-version/"
"</emphasis> directory to make debian packages."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8027
msgid "optional arguments:"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8030
msgid ""
"<emphasis role=\"strong\">-h</emphasis>, <emphasis role=\"strong\">--help</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8034
msgid "show this help message and exit."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8040
msgid ""
"<emphasis role=\"strong\">-c</emphasis>, <emphasis role=\"strong\">--"
"copyright</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8044
msgid "scan source for copyright+license text and exit."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8049
msgid "<emphasis role=\"strong\">-c</emphasis>: sinple output style"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8054
msgid ""
"<emphasis role=\"strong\">-cc</emphasis>: normal output style (similar to "
"the <emphasis role=\"strong\">debian/copyright</emphasis> file)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8059
msgid "<emphasis role=\"strong\">-ccc</emphasis>: debug output style"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8067
msgid ""
"<emphasis role=\"strong\">-k</emphasis>, <emphasis role=\"strong\">--kludge</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8071
msgid ""
"compare the <emphasis role=\"strong\">debian/copyright</emphasis> file with "
"the source and exit."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8074
msgid ""
"The <emphasis role=\"strong\">debian/copyright</emphasis> file must be "
"organized to list the generic file patterns before the specific exceptions."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8077
msgid "<emphasis role=\"strong\">-k</emphasis>: basic output style"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8082
msgid "<emphasis role=\"strong\">-kk</emphasis>: verbose output style"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8090
msgid ""
"<emphasis role=\"strong\">-n</emphasis>, <emphasis role=\"strong\">--native</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8094
msgid ""
"make a native Debian source package without <emphasis role=\"strong\">.orig."
"tar.gz</emphasis>. This makes the “<emphasis role=\"strong\">3.0 (native)</"
"emphasis>” format package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8097
msgid ""
"If you are thinking to package a Debian specific source tree with <emphasis "
"role=\"strong\">debian/</emphasis>* in it into a native Debian package, "
"please think otherwise. You can use “<emphasis role=\"strong\">debmake -d -i "
"debuild</emphasis>” or “<emphasis role=\"strong\">debmake -t -i debuild</"
"emphasis>” to make the “<emphasis role=\"strong\">3.0 (quilt)</emphasis>” "
"format non-native Debian package. The only difference is that the <emphasis "
"role=\"strong\">debian/changelog</emphasis> file must use the non-native "
"version scheme: <emphasis>version-revision</emphasis>. The non-native "
"package is more friendly to the downstream distributions."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8101
msgid ""
"<emphasis role=\"strong\">-a</emphasis> <emphasis>package-version</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis>, <emphasis role="
"\"strong\">--archive</emphasis> <emphasis>package-version</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8105
msgid ""
"use the upstream source tarball directly. (<emphasis role=\"strong\">-p</"
"emphasis>, <emphasis role=\"strong\">-u</emphasis>, <emphasis role=\"strong"
"\">-z</emphasis>: overridden)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8108
msgid ""
"The upstream tarball may be specified as <emphasis>package_version</"
"emphasis><emphasis role=\"strong\">.orig.tar.gz</emphasis> and <emphasis "
"role=\"strong\">tar.gz</emphasis> for all cases may be <emphasis role="
"\"strong\">tar.bz2</emphasis>, or <emphasis role=\"strong\">tar.xz</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8109
msgid ""
"If the specified upstream tarball name contains uppercase letters, the "
"Debian package name is generated by converting them to lowercase letters."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8110
msgid ""
"If the specified argument is the URL (http://, https://, or ftp://) to the "
"upstream tarball, the upstream tarball is downloaded from the URL using "
"<emphasis role=\"strong\">wget</emphasis> or <emphasis role=\"strong\">curl</"
"emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8114
msgid ""
"<emphasis role=\"strong\">-d</emphasis>, <emphasis role=\"strong\">--dist</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8118
msgid ""
"run “make dist” equivalent first to generate upstream tarball and use it."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8121
msgid ""
"“<emphasis role=\"strong\">debmake -d</emphasis>” is designed to run in the "
"<emphasis>package/</emphasis> directory hosting the upstream VCS with the "
"build system supporting “<emphasis role=\"strong\">make dist</emphasis>” "
"equivalents. (automake/autoconf, Python distutils, …)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8125
msgid ""
"<emphasis role=\"strong\">-t</emphasis>, <emphasis role=\"strong\">--tar</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8129
msgid ""
"run “<emphasis role=\"strong\">tar</emphasis>” to generate upstream tarball "
"and use it"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8132
msgid ""
"“<emphasis role=\"strong\">debmake -t</emphasis>” is designed to run in the "
"<emphasis>package/</emphasis> directory hosting the upstream VCS. Unless you "
"provide the upstream version with the <emphasis role=\"strong\">-u</"
"emphasis> option or with the <emphasis role=\"strong\">debian/changelog</"
"emphasis> file, a snapshot upstream version is generated in the <emphasis "
"role=\"strong\">0~%y%m%d%H%M</emphasis> format, e.g., "
"<emphasis>0~1403012359</emphasis>, from the UTC date and time. The generated "
"tarball excludes the <emphasis role=\"strong\">debian/</emphasis> directory "
"found in the upstream VCS. (It also excludes typical VCS directories: "
"<emphasis role=\"strong\">.git/ .hg/ .svn/ .CVS/</emphasis>)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8136
msgid ""
"<emphasis role=\"strong\">-p</emphasis> <emphasis>package</emphasis>, "
"<emphasis role=\"strong\">--package</emphasis> <emphasis>package</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8140
msgid "set the Debian package name."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8146
msgid ""
"<emphasis role=\"strong\">-u</emphasis> <emphasis>version</emphasis>, "
"<emphasis role=\"strong\">--upstreamversion</emphasis> <emphasis>version</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8150
msgid "set the upstream package version."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8156
msgid ""
"<emphasis role=\"strong\">-r</emphasis> <emphasis>revision</emphasis>, "
"<emphasis role=\"strong\">--revision</emphasis> <emphasis>revision</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8160
msgid "set the Debian package revision."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8166
msgid ""
"<emphasis role=\"strong\">-z</emphasis> <emphasis>extension</emphasis>, "
"<emphasis role=\"strong\">--targz</emphasis> <emphasis>extension</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8170
msgid ""
"set the tarball type, <emphasis>extension</emphasis>=(<emphasis role=\"strong"
"\">tar.gz</emphasis>|<emphasis role=\"strong\">tar.bz2</emphasis>|<emphasis "
"role=\"strong\">tar.xz</emphasis>) (alias: <emphasis role=\"strong\">z</"
"emphasis>, <emphasis role=\"strong\">b</emphasis>, <emphasis role=\"strong"
"\">x</emphasis>)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8247
msgid ""
"<emphasis role=\"strong\">-e</emphasis> <emphasis>foo@example.org</"
"emphasis>, <emphasis role=\"strong\">--email</emphasis> "
"<emphasis>foo@example.org</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8251
msgid "set e-mail address."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8254
msgid ""
"The default is taken from the value of the environment variable <emphasis "
"role=\"strong\">$DEBEMAIL</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8258
msgid ""
"<emphasis role=\"strong\">-f</emphasis> \"<emphasis>firstname lastname</"
"emphasis>\", <emphasis role=\"strong\">--fullname</emphasis> "
"\"<emphasis>firstname lastname</emphasis>\""
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8262
msgid "set the fullname."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8265
msgid ""
"The default is taken from the value of the environment variable <emphasis "
"role=\"strong\">$DEBFULLNAME</emphasis>."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8269
msgid ""
"<emphasis role=\"strong\">-i</emphasis> \"<emphasis>buildtool</emphasis>\", "
"<emphasis role=\"strong\">--invoke</emphasis> \"<emphasis>buildtool</"
"emphasis>\""
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8273
msgid ""
"invoke \"<emphasis>buildtool</emphasis>\" at the end of execution. "
"<emphasis>buildtool</emphasis> may be “<emphasis role=\"strong\">dpkg-"
"buildpackage</emphasis>”, “<emphasis role=\"strong\">debuild</emphasis>”, "
"“<emphasis role=\"strong\">pdebuild</emphasis>”, “<emphasis role=\"strong"
"\">pdebuild --pbuilder cowbuilder</emphasis>”, etc.."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8276
msgid "The default is not to execute any program."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8280
msgid ""
"<emphasis role=\"strong\">-j</emphasis>, <emphasis role=\"strong\">--judge</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8284
msgid ""
"run <emphasis role=\"strong\">dpkg-depcheck</emphasis> to judge build "
"dependencies and identify file paths. Log files are in the parent directory."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8289
msgid ""
"<emphasis>package</emphasis><emphasis role=\"strong\">.build-dep.log</"
"emphasis>: Log file for <emphasis role=\"strong\">dpkg-depcheck</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8294
msgid ""
"<emphasis>package</emphasis><emphasis role=\"strong\">.install.log</"
"emphasis>: Log file recording files in the <emphasis role=\"strong\">debian/"
"tmp</emphasis> directory."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8302
msgid ""
"<emphasis role=\"strong\">-l</emphasis> \"<emphasis>license_file,…</emphasis>"
"\", <emphasis role=\"strong\">--license</emphasis> \"<emphasis>license_file,…"
"</emphasis>\""
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8306
msgid ""
"add formatted license text to the end of the <emphasis role=\"strong"
"\">debian/copyright</emphasis> file holding license scan results"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8309
msgid ""
"The default is add <emphasis role=\"strong\">COPYING</emphasis> and "
"<emphasis role=\"strong\">LICENSE</emphasis> and <emphasis>license_file</"
"emphasis> needs to list only the additional file names all separated by "
"“<emphasis role=\"strong\">,</emphasis>”."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8313
msgid ""
"<emphasis role=\"strong\">-m</emphasis>, <emphasis role=\"strong\">--"
"monoarch</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8317
msgid "force packages to be non-multiarch."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8323
msgid ""
"<emphasis role=\"strong\">-o</emphasis> <emphasis>file</emphasis>, <emphasis "
"role=\"strong\">--option</emphasis> <emphasis>file</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8327
msgid ""
"read optional parameters from the <emphasis>file</emphasis>. (This is not "
"for everyday use.)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8330
msgid ""
"The <emphasis>file</emphasis> is sourced as the Python3 code at the end of "
"<emphasis role=\"strong\">para.py</emphasis>. For example, the package "
"description can be specified by the following file."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8343
msgid ""
"<emphasis role=\"strong\">-q</emphasis>, <emphasis role=\"strong\">--"
"quitearly</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8347
msgid ""
"quit early before creating files in the <emphasis role=\"strong\">debian/</"
"emphasis> directory."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8353
msgid ""
"<emphasis role=\"strong\">-s</emphasis>, <emphasis role=\"strong\">--spec</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8357
msgid ""
"use upstream spec (setup.py for Python, etc.) for the package description."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8363
msgid ""
"<emphasis role=\"strong\">-v</emphasis>, <emphasis role=\"strong\">--"
"version</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8367
msgid "show version information."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8373
msgid ""
"<emphasis role=\"strong\">-w</emphasis> \"<emphasis>addon,…</emphasis>\", "
"<emphasis role=\"strong\">--with</emphasis> \"<emphasis>addon,…</emphasis>\""
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8377
msgid ""
"add extra arguments to the <emphasis role=\"strong\">--with</emphasis> "
"option of the <emphasis role=\"strong\">dh</emphasis>(1) command as "
"<emphasis>addon</emphasis> in <emphasis role=\"strong\">debian/rules</"
"emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8380
msgid ""
"The <emphasis>addon</emphasis> values are listed all separated by “<emphasis "
"role=\"strong\">,</emphasis>”, e.g., “<emphasis role=\"strong\">-w \"python2,"
"autoreconf\"”</emphasis>."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8381
msgid ""
"For Autotools based packages, setting <emphasis role=\"strong\">autoreconf</"
"emphasis> as <emphasis>addon</emphasis> forces to run “<emphasis role="
"\"strong\">autoreconf -i -v -f</emphasis>” for every package building. "
"Otherwise, <emphasis role=\"strong\">autotools-dev</emphasis> as "
"<emphasis>addon</emphasis> is used as default."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8382
msgid ""
"For Autotools based packages, if they install Python programs, <emphasis "
"role=\"strong\">python2</emphasis> as addon is needed for packages with "
"“<emphasis role=\"strong\">compat &lt; 9</emphasis>” since this is non-"
"obvious. But for <emphasis role=\"strong\">setup.py</emphasis> based "
"packages, <emphasis role=\"strong\">python2</emphasis> as <emphasis>addon</"
"emphasis> is not needed since this is obvious and it is automatically set "
"for the <emphasis role=\"strong\">dh</emphasis>(1) command by the <emphasis "
"role=\"strong\">debmake</emphasis> command when it is required."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8386
msgid ""
"<emphasis role=\"strong\">-x</emphasis> <emphasis>n</emphasis>, <emphasis "
"role=\"strong\">--extra</emphasis> <emphasis>n</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8390
msgid "generate extra configuration files as templates."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8393
msgid ""
"The number <emphasis>n</emphasis> changes which configuration templates are "
"generated."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8396
msgid ""
"<emphasis role=\"strong\">-x0</emphasis>: bare minimum configuration files. "
"(default if these files exist already)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8401
msgid ""
"<emphasis role=\"strong\">-x1</emphasis>: ,, + desirable configuration "
"files. (default for new packages)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8406
msgid ""
"<emphasis role=\"strong\">-x2</emphasis>: ,, + interesting configuration "
"files. (recommended for experts, multi binary aware)"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8411
msgid ""
"<emphasis role=\"strong\">-x3</emphasis>: ,, + unusual configuration "
"template files with the extra <emphasis role=\"strong\">.ex</emphasis> "
"suffix to ease their removal. (recommended for new users) To use these as "
"configuration files, rename their file names into ones without the <emphasis "
"role=\"strong\">.ex</emphasis> suffix."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8416
msgid "<emphasis role=\"strong\">-x4</emphasis>: ,, + copyright file examples."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8424
msgid ""
"<emphasis role=\"strong\">-y</emphasis>, <emphasis role=\"strong\">--yes</"
"emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8428
msgid ""
"“force yes” for all prompts. (without option: “ask [Y/n]”; doubled option: "
"“force no”)"
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8434
msgid ""
"<emphasis role=\"strong\">-P</emphasis>, <emphasis role=\"strong\">--"
"pedantic</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8438
msgid "pedantically check auto-generated files."
msgstr ""

#. (itstool) path: varlistentry/term
#: debmake-doc.en.xml:8444
msgid ""
"<emphasis role=\"strong\">-T</emphasis>, <emphasis role=\"strong\">--"
"tutorial</emphasis>"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8448
msgid "output tutorial comment lines in template files."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8457
msgid "EXAMPLES"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8458
msgid ""
"For a well behaving source, you can build a good-for-local-use installable "
"single Debian binary package easily with one command. Test install of such a "
"package generated in this way offers a good alternative to traditional "
"“<emphasis role=\"strong\">make install</emphasis>” to the <emphasis role="
"\"strong\">/usr/local</emphasis> directory since the Debian package can be "
"removed cleanly by the “<emphasis role=\"strong\">dpkg -P</emphasis> "
"<emphasis>…”</emphasis> command. Here are some examples of how to build such "
"test packages. (These should work in most cases. If the <emphasis role="
"\"strong\">-d</emphasis> does not work, try <emphasis role=\"strong\">-t</"
"emphasis> instead.)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8461
msgid "For a typical C program source tree packaged with autoconf/automake:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8464
msgid "<emphasis role=\"strong\">debmake -d -i debuild</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8469
msgid "For a typical python module source tree:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8472
msgid ""
"<emphasis role=\"strong\">debmake -s -d -b\":python\" -i debuild</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8477
msgid ""
"For a typical python module in the <emphasis>package-version</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> archive:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8480
msgid ""
"<emphasis role=\"strong\">debmake -s -a <emphasis>package-version</emphasis>."
"tar.gz -b\":python\" -i debuild</emphasis>"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8485
msgid ""
"For a typical perl module in the <emphasis>Package-version</"
"emphasis><emphasis role=\"strong\">.tar.gz</emphasis> archive:"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8488
msgid ""
"<emphasis role=\"strong\">debmake -a <emphasis>Package-version</emphasis>."
"tar.gz -b\":perl\" -i debuild</emphasis>"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8495
msgid "HELPER PACKAGES"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8496
msgid ""
"Packaging may require installation of some additional specialty helper "
"packages."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8499
msgid ""
"Python3 program may require the <emphasis role=\"strong\">dh-python</"
"emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8504
msgid ""
"Autotools (Autoconf + Automake) build system may require <emphasis role="
"\"strong\">autotools-dev</emphasis> or <emphasis role=\"strong\">dh-"
"autoreconf</emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8509
msgid ""
"Ruby program may require the <emphasis role=\"strong\">gem2deb</emphasis> "
"package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8514
msgid ""
"Java program may require the <emphasis role=\"strong\">javahelper</emphasis> "
"package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8519
msgid ""
"Gnome programs may require the <emphasis role=\"strong\">gobject-"
"introspection</emphasis> package."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8524
msgid "etc."
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8531
msgid "CAVEAT"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8559
msgid "DEBUG"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8560
msgid ""
"The character set in the environment variable <emphasis role=\"strong\">"
"$DEBUG</emphasis> determines the logging output level."
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8563
msgid "<emphasis role=\"strong\">i</emphasis>: print information"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8568
msgid "<emphasis role=\"strong\">p</emphasis>: list all global parameters"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8573
msgid ""
"<emphasis role=\"strong\">d</emphasis>: list parsed parameters for all "
"binary packages"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8578
msgid ""
"<emphasis role=\"strong\">f</emphasis>: input filename for the copyright scan"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8583
msgid ""
"<emphasis role=\"strong\">y</emphasis>: year/name split of copyright line"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8588
msgid "<emphasis role=\"strong\">s</emphasis>: line scanner for format_state"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8593
msgid ""
"<emphasis role=\"strong\">b</emphasis>: content_state scan loop: begin-loop"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8598
msgid ""
"<emphasis role=\"strong\">m</emphasis>: content_state scan loop: after regex "
"match"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8603
msgid ""
"<emphasis role=\"strong\">e</emphasis>: content_state scan loop: end-loop"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8608
msgid "<emphasis role=\"strong\">c</emphasis>: print copyright section text"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8613
msgid "<emphasis role=\"strong\">l</emphasis>: print license section text"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8618
msgid ""
"<emphasis role=\"strong\">a</emphasis>: print author/translator section text"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8623
msgid ""
"<emphasis role=\"strong\">k</emphasis>: sort key for debian/copyright stanza"
msgstr ""

#. (itstool) path: listitem/simpara
#: debmake-doc.en.xml:8628
msgid ""
"<emphasis role=\"strong\">n</emphasis>: scan result of debian/copyright "
"(“<emphasis role=\"strong\">debmake -k</emphasis>”)"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8633
msgid "Use this as:"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8637
msgid "AUTHOR"
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:8638
msgid "osamu@debian.org"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8638
msgid "Copyright © 2014-2015 Osamu Aoki &lt;<_:ulink-1/>&gt;"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8641
msgid "LICENSE"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8642
msgid "MIT License"
msgstr ""

#. (itstool) path: section/title
#: debmake-doc.en.xml:8645
msgid "SEE ALSO"
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8646
msgid ""
"The <emphasis role=\"strong\">debmake-doc</emphasis> package provides the "
"“Guide for Debian Maintainers” in the plain text, HTML and PDF formats under "
"the <emphasis role=\"strong\">/usr/share/doc/debmake-doc/</emphasis> "
"directory."
msgstr ""

#. (itstool) path: simpara/ulink
#: debmake-doc.en.xml:8647
#, fuzzy
msgid "Debian New Maintainers’ Guide"
msgstr "Debian メンテナーガイド (debmake使用版)"

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8647
msgid ""
"Also, please read the original <_:ulink-1/> provided by the the <emphasis "
"role=\"strong\">maint-guide</emphasis> package."
msgstr ""

#. (itstool) path: section/simpara
#: debmake-doc.en.xml:8648
msgid ""
"See also <emphasis role=\"strong\">dpkg-source</emphasis>(1), <emphasis role="
"\"strong\">deb-control</emphasis>(5), <emphasis role=\"strong\">debhelper</"
"emphasis>(7), <emphasis role=\"strong\">dh</emphasis>(1), <emphasis role="
"\"strong\">dpkg-buildpackage</emphasis>(1), <emphasis role=\"strong"
"\">debuild</emphasis>(1), <emphasis role=\"strong\">quilt</emphasis>(1), "
"<emphasis role=\"strong\">dpkg-depcheck</emphasis>(1), <emphasis role="
"\"strong\">pdebuild</emphasis>(1), <emphasis role=\"strong\">pbuilder</"
"emphasis>(8), <emphasis role=\"strong\">cowbuilder</emphasis>(8), <emphasis "
"role=\"strong\">gbp-buildpackage</emphasis>(1), <emphasis role=\"strong"
"\">gbp-pq</emphasis>(1), and <emphasis role=\"strong\">git-pbuilder</"
"emphasis>(1) manpages."
msgstr ""
