# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018, 1997, 1998 Ian Jackson, Christian Schwarz, 1998-2017,
# The Debian Policy Mailing List
# This file is distributed under the same license as the Debian Policy
# Manual package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2018.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Debian Policy Manual 4.1.6.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-07-10 16:09+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.4.0\n"

#: ../../ch-controlfields.rst:2
msgid "Control files and their fields"
msgstr ""

#: ../../ch-controlfields.rst:4
msgid ""
"The package management system manipulates data represented in a common "
"format, known as *control data*, stored in *control files*. Control files"
" are used for source packages, binary packages and the ``.changes`` files"
" which control the installation of uploaded files.  [#]_"
msgstr ""

#: ../../ch-controlfields.rst:12
msgid "Syntax of control files"
msgstr ""

#: ../../ch-controlfields.rst:14
msgid ""
"A control file consists of one or more paragraphs of fields.  [#]_ The "
"paragraphs are separated by empty lines. Parsers may accept lines "
"consisting solely of spaces and tabs as paragraph separators, but control"
" files should use empty lines. Some control files allow only one "
"paragraph; others allow several, in which case each paragraph usually "
"refers to a different package. (For example, in source packages, the "
"first paragraph refers to the source package, and later paragraphs refer "
"to binary packages generated from the source.) The ordering of the "
"paragraphs in control files is significant."
msgstr ""

#: ../../ch-controlfields.rst:24
msgid ""
"Each paragraph consists of a series of data fields. Each field consists "
"of the field name followed by a colon and then the data/value associated "
"with that field. The field name is composed of US-ASCII characters "
"excluding control characters, space, and colon (i.e., characters in the "
"ranges U+0021 (``!``) through U+0039 (``9``), and U+003B (``;``) through "
"U+007E (``~``), inclusive). Field names must not begin with the comment "
"character (U+0023 ``#``), nor with the hyphen character (U+002D ``-``)."
msgstr ""

#: ../../ch-controlfields.rst:32
msgid ""
"The field ends at the end of the line or at the end of the last "
"continuation line (see below). Horizontal whitespace (spaces and tabs) "
"may occur immediately before or after the value and is ignored there; it "
"is conventional to put a single space after the colon. For example, a "
"field might be:"
msgstr ""

#: ../../ch-controlfields.rst:42
msgid "the field name is ``Package`` and the field value ``libc6``."
msgstr ""

#: ../../ch-controlfields.rst:44
msgid ""
"Empty field values are only permitted in source package control files "
"(``debian/control``). Such fields are ignored."
msgstr ""

#: ../../ch-controlfields.rst:47
msgid ""
"A paragraph must not contain more than one instance of a particular field"
" name."
msgstr ""

#: ../../ch-controlfields.rst:50
msgid "There are three types of fields:"
msgstr ""

#: ../../ch-controlfields.rst:55
msgid "simple"
msgstr ""

#: ../../ch-controlfields.rst:53
msgid ""
"The field, including its value, must be a single line. Folding of the "
"field is not permitted. This is the default field type if the definition "
"of the field does not specify a different type."
msgstr ""

#: ../../ch-controlfields.rst:61
msgid "folded"
msgstr ""

#: ../../ch-controlfields.rst:58
msgid ""
"The value of a folded field is a logical line that may span several "
"lines. The lines after the first are called continuation lines and must "
"start with a space or a tab. Whitespace, including any newlines, is not "
"significant in the field values of folded fields.  [#]_"
msgstr ""

#: ../../ch-controlfields.rst:69
msgid "multiline"
msgstr ""

#: ../../ch-controlfields.rst:64
msgid ""
"The value of a multiline field may comprise multiple continuation lines. "
"The first line of the value, the part on the same line as the field name,"
" often has special significance or may have to be empty. Other lines are "
"added following the same syntax as the continuation lines of the folded "
"fields. Whitespace, including newlines, is significant in the values of "
"multiline fields."
msgstr ""

#: ../../ch-controlfields.rst:71
msgid ""
"Whitespace must not appear inside names (of packages, architectures, "
"files or anything else) or version numbers, or between the characters of "
"multi-character version relationships."
msgstr ""

#: ../../ch-controlfields.rst:75
msgid ""
"The presence and purpose of a field, and the syntax of its value may "
"differ between types of control files."
msgstr ""

#: ../../ch-controlfields.rst:78
msgid ""
"Field names are not case-sensitive, but it is usual to capitalize the "
"field names using mixed case as shown below. Field values are case-"
"sensitive unless the description of the field says otherwise."
msgstr ""

#: ../../ch-controlfields.rst:82
msgid ""
"Paragraph separators (empty lines), and lines consisting only of U+0020 "
"SPACE and U+0009 TAB, are not allowed within field values or between "
"fields. Empty lines in field values are usually escaped by representing "
"them by a U+0020 SPACE followed by a U+002E (``.``)."
msgstr ""

#: ../../ch-controlfields.rst:87
msgid ""
"Lines starting with U+0023 (``#``), without any preceding whitespace, are"
" comment lines that are only permitted in source package control files "
"(``debian/control``). These comment lines are ignored, even between two "
"continuation lines. They do not end logical lines."
msgstr ""

#: ../../ch-controlfields.rst:92
msgid "All control files must be encoded in UTF-8."
msgstr ""

#: ../../ch-controlfields.rst:97
msgid "Source package control files -- ``debian/control``"
msgstr ""

#: ../../ch-controlfields.rst:99
msgid ""
"The ``debian/control`` file contains the most vital (and version-"
"independent) information about the source package and about the binary "
"packages it creates."
msgstr ""

#: ../../ch-controlfields.rst:103
msgid ""
"The first paragraph of the control file contains information about the "
"source package in general. The subsequent paragraphs each describe a "
"binary package that the source tree builds. Each binary package built "
"from this source package has a corresponding paragraph, except for any "
"automatically-generated debug packages that do not require one."
msgstr ""

#: ../../ch-controlfields.rst:109
msgid ""
"The fields in the general paragraph (the first one, for the source "
"package) are:"
msgstr ""

#: ../../ch-controlfields.rst:112 ../../ch-controlfields.rst:221
#: ../../ch-controlfields.rst:279
msgid ":ref:`Source <s-f-Source>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:114 ../../ch-controlfields.rst:202
#: ../../ch-controlfields.rst:229 ../../ch-controlfields.rst:291
msgid ":ref:`Maintainer <s-f-Maintainer>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:116 ../../ch-controlfields.rst:231
msgid ":ref:`Uploaders <s-f-Uploaders>`"
msgstr ""

#: ../../ch-controlfields.rst:118 ../../ch-controlfields.rst:140
#: ../../ch-controlfields.rst:190
msgid ":ref:`Section <s-f-Section>` (recommended)"
msgstr ""

#: ../../ch-controlfields.rst:120 ../../ch-controlfields.rst:142
#: ../../ch-controlfields.rst:192
msgid ":ref:`Priority <s-f-Priority>` (recommended)"
msgstr ""

#: ../../ch-controlfields.rst:122 ../../ch-controlfields.rst:243
msgid ":ref:`Build-Depends et al <s-sourcebinarydeps>`"
msgstr ""

#: ../../ch-controlfields.rst:124 ../../ch-controlfields.rst:241
msgid ":ref:`Standards-Version <s-f-Standards-Version>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:126 ../../ch-controlfields.rst:150
#: ../../ch-controlfields.rst:206 ../../ch-controlfields.rst:233
msgid ":ref:`Homepage <s-f-Homepage>`"
msgstr ""

#: ../../ch-controlfields.rst:128 ../../ch-controlfields.rst:235
msgid ":ref:`Version Control System (VCS) fields <s-f-VCS-fields>`"
msgstr ""

#: ../../ch-controlfields.rst:130 ../../ch-controlfields.rst:237
msgid ":ref:`Testsuite <s-f-Testsuite>`"
msgstr ""

#: ../../ch-controlfields.rst:132
msgid ":ref:`Rules-Requires-Root <s-f-Rules-Requires-Root>`"
msgstr ""

#: ../../ch-controlfields.rst:134
msgid "The fields in the binary package paragraphs are:"
msgstr ""

#: ../../ch-controlfields.rst:136 ../../ch-controlfields.rst:184
msgid ":ref:`Package <s-f-Package>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:138 ../../ch-controlfields.rst:194
#: ../../ch-controlfields.rst:283
msgid ":ref:`Architecture <s-f-Architecture>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:144 ../../ch-controlfields.rst:196
msgid ":ref:`Essential <s-f-Essential>`"
msgstr ""

#: ../../ch-controlfields.rst:146 ../../ch-controlfields.rst:198
msgid ":ref:`Depends et al <s-binarydeps>`"
msgstr ""

#: ../../ch-controlfields.rst:148 ../../ch-controlfields.rst:204
#: ../../ch-controlfields.rst:295
msgid ":ref:`Description <s-f-Description>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:152 ../../ch-controlfields.rst:208
msgid ":ref:`Built-Using <s-built-using>`"
msgstr ""

#: ../../ch-controlfields.rst:154
msgid ":ref:`Package-Type <s-f-Package-Type>`"
msgstr ""

#: ../../ch-controlfields.rst:156
msgid "The syntax and semantics of the fields are described below."
msgstr ""

#: ../../ch-controlfields.rst:158
msgid ""
"These fields are used by ``dpkg-gencontrol`` to generate control files "
"for binary packages (see below), by ``dpkg-genchanges`` to generate the "
"``.changes`` file to accompany the upload, and by ``dpkg-source`` when it"
" creates the ``.dsc`` source control file as part of a source archive. "
"Some fields are folded in ``debian/control``, but not in any other "
"control file. These tools are responsible for removing the line breaks "
"from such fields when using fields from ``debian/control`` to generate "
"other control files. They are also responsible for discarding empty "
"fields."
msgstr ""

#: ../../ch-controlfields.rst:168
msgid ""
"The fields here may contain variable references - their values will be "
"substituted by ``dpkg-gencontrol``, ``dpkg-genchanges`` or ``dpkg-"
"source`` when they generate output control files. See :ref:`s-substvars` "
"for details."
msgstr ""

#: ../../ch-controlfields.rst:176
msgid "Binary package control files -- ``DEBIAN/control``"
msgstr ""

#: ../../ch-controlfields.rst:178
msgid ""
"The ``DEBIAN/control`` file contains the most vital (and version-"
"dependent) information about a binary package. It consists of a single "
"paragraph."
msgstr ""

#: ../../ch-controlfields.rst:182 ../../ch-controlfields.rst:273
msgid "The fields in this file are:"
msgstr ""

#: ../../ch-controlfields.rst:186
msgid ":ref:`Source <s-f-Source>`"
msgstr ""

#: ../../ch-controlfields.rst:188 ../../ch-controlfields.rst:227
#: ../../ch-controlfields.rst:285
msgid ":ref:`Version <s-f-Version>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:200
msgid ":ref:`Installed-Size <s-f-Installed-Size>`"
msgstr ""

#: ../../ch-controlfields.rst:213
msgid "Debian source control files -- ``.dsc``"
msgstr ""

#: ../../ch-controlfields.rst:215
msgid ""
"This file consists of a single paragraph, possibly surrounded by a PGP "
"signature. The fields of that paragraph are listed below. Their syntax is"
" described above, in :ref:`s-controlsyntax`."
msgstr ""

#: ../../ch-controlfields.rst:219 ../../ch-controlfields.rst:275
msgid ":ref:`Format <s-f-Format>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:223
msgid ":ref:`Binary <s-f-Binary>`"
msgstr ""

#: ../../ch-controlfields.rst:225
msgid ":ref:`Architecture <s-f-Architecture>`"
msgstr ""

#: ../../ch-controlfields.rst:239
msgid ":ref:`Dgit <s-f-Dgit>`"
msgstr ""

#: ../../ch-controlfields.rst:245
msgid ":ref:`Package-List <s-f-Package-List>` (recommended)"
msgstr ""

#: ../../ch-controlfields.rst:247 ../../ch-controlfields.rst:301
msgid ":ref:`Checksums-Sha1 and Checksums-Sha256 <s-f-Checksums>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:250 ../../ch-controlfields.rst:304
msgid ":ref:`Files <s-f-Files>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:252
msgid ""
"The Debian source control file is generated by ``dpkg-source`` when it "
"builds the source archive, from other files in the source package, "
"described above. When unpacking, it is checked against the files and "
"directories in the other parts of the source package."
msgstr ""

#: ../../ch-controlfields.rst:260
msgid "Debian changes files -- ``.changes``"
msgstr ""

#: ../../ch-controlfields.rst:262
msgid ""
"The ``.changes`` files are used by the Debian archive maintenance "
"software to process updates to packages. They consist of a single "
"paragraph, possibly surrounded by a PGP signature. That paragraph "
"contains information from the ``debian/control`` file and other data "
"about the source package gathered via ``debian/changelog`` and "
"``debian/rules``."
msgstr ""

#: ../../ch-controlfields.rst:269
msgid ""
"``.changes`` files have a format version that is incremented whenever the"
" documented fields or their meaning change. This document describes "
"format 1.8."
msgstr ""

#: ../../ch-controlfields.rst:277
msgid ":ref:`Date <s-f-Date>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:281
msgid ":ref:`Binary <s-f-Binary>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:287
msgid ":ref:`Distribution <s-f-Distribution>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:289
msgid ":ref:`Urgency <s-f-Urgency>` (recommended)"
msgstr ""

#: ../../ch-controlfields.rst:293
msgid ":ref:`Changed-By <s-f-Changed-By>`"
msgstr ""

#: ../../ch-controlfields.rst:297
msgid ":ref:`Closes <s-f-Closes>`"
msgstr ""

#: ../../ch-controlfields.rst:299
msgid ":ref:`Changes <s-f-Changes>` (mandatory)"
msgstr ""

#: ../../ch-controlfields.rst:309
msgid "List of fields"
msgstr ""

#: ../../ch-controlfields.rst:314
msgid "``Source``"
msgstr ""

#: ../../ch-controlfields.rst:316
msgid "This field identifies the source package name."
msgstr ""

#: ../../ch-controlfields.rst:318
msgid ""
"In ``debian/control`` or a ``.dsc`` file, this field must contain only "
"the name of the source package."
msgstr ""

#: ../../ch-controlfields.rst:321
msgid ""
"In a binary package control file or a ``.changes`` file, the source "
"package name may be followed by a version number in parentheses.  [#]_ "
"This version number may be omitted (and is, by ``dpkg-gencontrol``) if it"
" has the same value as the ``Version`` field of the binary package in "
"question. The field itself may be omitted from a binary package control "
"file when the source package has the same name and version as the binary "
"package."
msgstr ""

#: ../../ch-controlfields.rst:329
msgid ""
"Package names (both source and binary, see :ref:`s-f-Package`) must "
"consist only of lower case letters (``a-z``), digits (``0-9``), plus "
"(``+``) and minus (``-``) signs, and periods (``.``). They must be at "
"least two characters long and must start with an alphanumeric character."
msgstr ""

#: ../../ch-controlfields.rst:338
msgid "``Maintainer``"
msgstr ""

#: ../../ch-controlfields.rst:340
msgid ""
"The package maintainer's name and email address. The name must come "
"first, then the email address inside angle brackets ``<>`` (in RFC822 "
"format)."
msgstr ""

#: ../../ch-controlfields.rst:344
msgid ""
"If the maintainer's name contains a full stop then the whole field will "
"not work directly as an email address due to a misfeature in the syntax "
"specified in RFC822; a program using this field as an address must check "
"for this and correct the problem if necessary (for example by putting the"
" name in round brackets and moving it to the end, and bringing the email "
"address forward)."
msgstr ""

#: ../../ch-controlfields.rst:351
msgid ""
"See :ref:`s-maintainer` for additional requirements and information about"
" package maintainers."
msgstr ""

#: ../../ch-controlfields.rst:357
msgid "``Uploaders``"
msgstr ""

#: ../../ch-controlfields.rst:359
msgid ""
"List of the names and email addresses of co-maintainers of the package, "
"if any. If the package has other maintainers besides the one named in the"
" :ref:`Maintainer field <s-f-Maintainer>`, their names and email "
"addresses should be listed here. The format of each entry is the same as "
"that of the Maintainer field, and multiple entries must be comma "
"separated."
msgstr ""

#: ../../ch-controlfields.rst:366
msgid ""
"This is normally an optional field, but if the ``Maintainer`` control "
"field names a group of people and a shared email address, the "
"``Uploaders`` field must be present and must contain at least one human "
"with their personal email address."
msgstr ""

#: ../../ch-controlfields.rst:371
msgid "The Uploaders field in ``debian/control`` can be folded."
msgstr ""

#: ../../ch-controlfields.rst:376
msgid "``Changed-By``"
msgstr ""

#: ../../ch-controlfields.rst:378
msgid ""
"The name and email address of the person who prepared this version of the"
" package, usually a maintainer. The syntax is the same as for the "
":ref:`Maintainer field <s-f-Maintainer>`."
msgstr ""

#: ../../ch-controlfields.rst:385
msgid "``Section``"
msgstr ""

#: ../../ch-controlfields.rst:387
msgid ""
"This field specifies an application area into which the package has been "
"classified. See :ref:`s-subsections`."
msgstr ""

#: ../../ch-controlfields.rst:390 ../../ch-controlfields.rst:403
msgid ""
"When it appears in the ``debian/control`` file, it gives the value for "
"the subfield of the same name in the ``Files`` field of the ``.changes`` "
"file. It also gives the default for the same field in the binary "
"packages."
msgstr ""

#: ../../ch-controlfields.rst:398
msgid "``Priority``"
msgstr ""

#: ../../ch-controlfields.rst:400
msgid ""
"This field represents how important it is that the user have the package "
"installed. See :ref:`s-priorities`."
msgstr ""

#: ../../ch-controlfields.rst:411
msgid "``Package``"
msgstr ""

#: ../../ch-controlfields.rst:413
msgid "The name of the binary package."
msgstr ""

#: ../../ch-controlfields.rst:415
msgid ""
"Binary package names must follow the same syntax and restrictions as "
"source package names. See :ref:`s-f-Source` for the details."
msgstr ""

#: ../../ch-controlfields.rst:422
msgid "``Architecture``"
msgstr ""

#: ../../ch-controlfields.rst:424
msgid ""
"Depending on context and the control file used, the ``Architecture`` "
"field can include the following sets of values:"
msgstr ""

#: ../../ch-controlfields.rst:427
msgid ""
"A unique single word identifying a Debian machine architecture as "
"described in :ref:`s-arch-spec`."
msgstr ""

#: ../../ch-controlfields.rst:430
msgid ""
"An architecture wildcard identifying a set of Debian machine "
"architectures, see :ref:`s-arch-wildcard-spec`. ``any`` matches all "
"Debian machine architectures and is the most frequently used."
msgstr ""

#: ../../ch-controlfields.rst:435
msgid "``all``, which indicates an architecture-independent package."
msgstr ""

#: ../../ch-controlfields.rst:437
msgid "``source``, which indicates a source package."
msgstr ""

#: ../../ch-controlfields.rst:439
msgid ""
"In the main ``debian/control`` file in the source package, this field may"
" contain the special value ``all``, the special architecture wildcard "
"``any``, or a list of specific and wildcard architectures separated by "
"spaces. If ``all`` or ``any`` appears, that value must be the entire "
"contents of the field. Most packages will use either ``all`` or ``any``."
msgstr ""

#: ../../ch-controlfields.rst:445
msgid ""
"Specifying a specific list of architectures indicates that the source "
"will build an architecture-dependent package only on architectures "
"included in the list. Specifying a list of architecture wildcards "
"indicates that the source will build an architecture-dependent package on"
" only those architectures that match any of the specified architecture "
"wildcards. Specifying a list of architectures or architecture wildcards "
"other than ``any`` is for the minority of cases where a program is not "
"portable or is not useful on some architectures. Where possible, the "
"program should be made portable instead."
msgstr ""

#: ../../ch-controlfields.rst:455
msgid ""
"In the Debian source control file ``.dsc``, this field contains a list of"
" architectures and architecture wildcards separated by spaces. When the "
"list contains the architecture wildcard ``any``, the only other value "
"allowed in the list is ``all``."
msgstr ""

#: ../../ch-controlfields.rst:460
msgid ""
"The list may include (or consist solely of) the special value ``all``. In"
" other words, in ``.dsc`` files unlike the ``debian/control``, ``all`` "
"may occur in combination with specific architectures. The "
"``Architecture`` field in the Debian source control file ``.dsc`` is "
"generally constructed from the ``Architecture`` fields in the "
"``debian/control`` in the source package."
msgstr ""

#: ../../ch-controlfields.rst:467
msgid ""
"Specifying only ``any`` indicates that the source package isn't dependent"
" on any particular architecture and should compile fine on any one. The "
"produced binary package(s) will be specific to whatever the current build"
" architecture is."
msgstr ""

#: ../../ch-controlfields.rst:472
msgid ""
"Specifying only ``all`` indicates that the source package will only build"
" architecture-independent packages."
msgstr ""

#: ../../ch-controlfields.rst:475
msgid ""
"Specifying ``any all`` indicates that the source package isn't dependent "
"on any particular architecture. The set of produced binary packages will "
"include at least one architecture-dependent package and one architecture-"
"independent package."
msgstr ""

#: ../../ch-controlfields.rst:480
msgid ""
"Specifying a list of architectures or architecture wildcards indicates "
"that the source will build an architecture-dependent package, and will "
"only work correctly on the listed or matching architectures. If the "
"source package also builds at least one architecture-independent package,"
" ``all`` will also be included in the list."
msgstr ""

#: ../../ch-controlfields.rst:486
msgid ""
"In a ``.changes`` file, the ``Architecture`` field lists the "
"architecture(s) of the package(s) currently being uploaded. This will be "
"a list; if the source for the package is also being uploaded, the special"
" entry ``source`` is also present. ``all`` will be present if any "
"architecture-independent packages are being uploaded. Architecture "
"wildcards such as ``any`` must never occur in the ``Architecture`` field "
"in the ``.changes`` file."
msgstr ""

#: ../../ch-controlfields.rst:494
msgid ""
"See :ref:`s-debianrules` for information on how to get the architecture "
"for the build process."
msgstr ""

#: ../../ch-controlfields.rst:500
msgid "``Essential``"
msgstr ""

#: ../../ch-controlfields.rst:502
msgid ""
"This is a boolean field which may occur only in the control file of a "
"binary package or in a per-package fields paragraph of a source package "
"control file."
msgstr ""

#: ../../ch-controlfields.rst:506
msgid ""
"If set to ``yes`` then the package management system will refuse to "
"remove the package (upgrading and replacing it is still possible). The "
"other possible value is ``no``, which is the same as not having the field"
" at all."
msgstr ""

#: ../../ch-controlfields.rst:514
msgid ""
"Package interrelationship fields: ``Depends``, ``Pre-Depends``, "
"``Recommends``, ``Suggests``, ``Breaks``, ``Conflicts``, ``Provides``, "
"``Replaces``, ``Enhances``"
msgstr ""

#: ../../ch-controlfields.rst:516
msgid ""
"These fields describe the package's relationships with other packages. "
"Their syntax and semantics are described in :doc:`Declaring relationships"
" between packages <ch-relationships>`."
msgstr ""

#: ../../ch-controlfields.rst:523
msgid "``Standards-Version``"
msgstr ""

#: ../../ch-controlfields.rst:525
msgid ""
"The most recent version of the standards (the policy manual and "
"associated texts) with which the package complies.  See "
":ref:`s-standardsversion`."
msgstr ""

#: ../../ch-controlfields.rst:529
msgid ""
"The version number has four components: major and minor version number "
"and major and minor patch level. When the standards change in a way that "
"requires every package to change the major number will be changed. "
"Significant changes that will require work in many packages will be "
"signaled by a change to the minor number. The major patch level will be "
"changed for any change to the meaning of the standards, however small; "
"the minor patch level will be changed when only cosmetic, typographical "
"or other edits are made which neither change the meaning of the document "
"nor affect the contents of packages."
msgstr ""

#: ../../ch-controlfields.rst:539
msgid ""
"Thus only the first three components of the policy version are "
"significant in the *Standards-Version* control field, and so either these"
" three components or all four components may be specified. [#]_"
msgstr ""

#: ../../ch-controlfields.rst:546
msgid "``Version``"
msgstr ""

#: ../../ch-controlfields.rst:548
msgid ""
"The version number of a package. The format is: "
"``[epoch:]upstream_version[-debian_revision]``."
msgstr ""

#: ../../ch-controlfields.rst:551
msgid "The three components here are:"
msgstr ""

#: ../../ch-controlfields.rst:561
msgid "``epoch``"
msgstr ""

#: ../../ch-controlfields.rst:554
msgid ""
"This is a single (generally small) unsigned integer. It may be omitted, "
"in which case zero is assumed. If it is omitted then the "
"``upstream_version`` may not contain any colons."
msgstr ""

#: ../../ch-controlfields.rst:558
msgid ""
"Epochs can help when the upstream version numbering scheme changes, but "
"they must be used with care.  You should not change the epoch, even in "
"experimental, without getting consensus on debian-devel first."
msgstr ""

#: ../../ch-controlfields.rst:578
msgid "``upstream_version``"
msgstr ""

#: ../../ch-controlfields.rst:564
msgid ""
"This is the main part of the version number. It is usually the version "
"number of the original (\"upstream\") package from which the ``.deb`` "
"file has been made, if this is applicable. Usually this will be in the "
"same format as that specified by the upstream author(s); however, it may "
"need to be reformatted to fit into the package management system's format"
" and comparison scheme."
msgstr ""

#: ../../ch-controlfields.rst:571
msgid ""
"The comparison behavior of the package management system with respect to "
"the ``upstream_version`` is described below. The ``upstream_version`` "
"portion of the version number is mandatory."
msgstr ""

#: ../../ch-controlfields.rst:575
msgid ""
"The ``upstream_version`` may contain only alphanumerics [#]_ and the "
"characters ``.`` ``+`` ``-`` ``~`` (full stop, plus, hyphen, tilde) and "
"should start with a digit. If there is no ``debian_revision`` then "
"hyphens are not allowed."
msgstr ""

#: ../../ch-controlfields.rst:599
msgid "``debian_revision`` This part of the version number specifies the"
msgstr ""

#: ../../ch-controlfields.rst:581
msgid ""
"version of the Debian package based on the upstream version. It may "
"contain only alphanumerics and the characters ``+`` ``.`` ``~`` (plus, "
"full stop, tilde) and is compared in the same way as the "
"``upstream_version`` is."
msgstr ""

#: ../../ch-controlfields.rst:586
msgid ""
"It is optional; if it isn't present then the ``upstream_version`` may not"
" contain a hyphen. This format represents the case where a piece of "
"software was written specifically to be a Debian package, where the "
"Debian package source must always be identical to the pristine source and"
" therefore no revision indication is required."
msgstr ""

#: ../../ch-controlfields.rst:592
msgid ""
"It is conventional to restart the ``debian_revision`` at ``1`` each time "
"the ``upstream_version`` is increased."
msgstr ""

#: ../../ch-controlfields.rst:595
msgid ""
"The package management system will break the version number apart at the "
"last hyphen in the string (if there is one) to determine the "
"``upstream_version`` and ``debian_revision``. The absence of a "
"``debian_revision`` is equivalent to a ``debian_revision`` of ``0``."
msgstr ""

#: ../../ch-controlfields.rst:601
msgid ""
"When comparing two version numbers, first the epoch of each are compared,"
" then the ``upstream_version`` if epoch is equal, and then "
"``debian_revision`` if ``upstream_version`` is also equal. epoch is "
"compared numerically. The ``upstream_version`` and ``debian_revision`` "
"parts are compared by the package management system using the following "
"algorithm:"
msgstr ""

#: ../../ch-controlfields.rst:607
msgid "The strings are compared from left to right."
msgstr ""

#: ../../ch-controlfields.rst:609
msgid ""
"First the initial part of each string consisting entirely of non-digit "
"characters is determined. These two parts (one of which may be empty) are"
" compared lexically. If a difference is found it is returned. The lexical"
" comparison is a comparison of ASCII values modified so that all the "
"letters sort earlier than all the non-letters and so that a tilde sorts "
"before anything, even the end of a part. For example, the following parts"
" are in sorted order from earliest to latest: ``~~``, ``~~a``, ``~``, the"
" empty part, ``a``. [#]_"
msgstr ""

#: ../../ch-controlfields.rst:618
msgid ""
"Then the initial part of the remainder of each string which consists "
"entirely of digit characters is determined. The numerical values of these"
" two parts are compared, and any difference found is returned as the "
"result of the comparison. For these purposes an empty string (which can "
"only occur at the end of one or both version strings being compared) "
"counts as zero."
msgstr ""

#: ../../ch-controlfields.rst:625
msgid ""
"These two steps (comparing and removing initial non-digit strings and "
"initial digit strings) are repeated until a difference is found or both "
"strings are exhausted."
msgstr ""

#: ../../ch-controlfields.rst:630
msgid "Epochs should be used sparingly"
msgstr ""

#: ../../ch-controlfields.rst:632
msgid ""
"Note that the purpose of epochs is to cope with situations where the "
"upstream version numbering scheme changes and to allow us to leave behind"
" serious mistakes. If you think that increasing the epoch is the right "
"solution, you should consult debian-devel and get consensus before doing "
"so (even in experimental)."
msgstr ""

#: ../../ch-controlfields.rst:639
msgid ""
"Epochs should not be used when a package needs to be rolled back. In that"
" case, use the ``+really`` convention: for example, if you uploaded "
"``2.3-3`` and now you need to go backwards to upstream 2.2, call your "
"reverting upload something like ``2.3+really2.2-1``. Eventually, when we "
"upload upstream 2.4, the +really part can go away."
msgstr ""

#: ../../ch-controlfields.rst:645
msgid ""
"Epochs are also not intended to cope with version numbers containing "
"strings of letters which the package management system cannot interpret "
"(such as ``ALPHA`` or ``pre-``), or with silly orderings.  [#]_"
msgstr ""

#: ../../ch-controlfields.rst:653
msgid "``Description``"
msgstr ""

#: ../../ch-controlfields.rst:655
msgid ""
"In a source or binary control file, the ``Description`` field contains a "
"description of the binary package, consisting of two parts, the synopsis "
"or the short description, and the long description. It is a multiline "
"field with the following format:"
msgstr ""

#: ../../ch-controlfields.rst:665
msgid "The lines in the extended description can have these formats:"
msgstr ""

#: ../../ch-controlfields.rst:667
msgid ""
"Those starting with a single space are part of a paragraph. Successive "
"lines of this form will be word-wrapped when displayed. The leading space"
" will usually be stripped off. The line must contain at least one non-"
"whitespace character."
msgstr ""

#: ../../ch-controlfields.rst:672
msgid ""
"Those starting with two or more spaces. These will be displayed verbatim."
" If the display cannot be panned horizontally, the displaying program "
"will line wrap them \"hard\" (i.e., without taking account of word "
"breaks). If it can they will be allowed to trail off to the right. None, "
"one or two initial spaces may be deleted, but the number of spaces "
"deleted from each line will be the same (so that you can have indenting "
"work correctly, for example). The line must contain at least one non-"
"whitespace character."
msgstr ""

#: ../../ch-controlfields.rst:681
msgid ""
"Those containing a single space followed by a single full stop character."
" These are rendered as blank lines. This is the *only* way to get a blank"
" line.  [#]_"
msgstr ""

#: ../../ch-controlfields.rst:685
msgid ""
"Those containing a space, a full stop and some more characters. These are"
" for future expansion. Do not use them."
msgstr ""

#: ../../ch-controlfields.rst:688
msgid "Do not use tab characters. Their effect is not predictable."
msgstr ""

#: ../../ch-controlfields.rst:690
msgid "See :ref:`s-descriptions` for further information on this."
msgstr ""

#: ../../ch-controlfields.rst:693
msgid ""
"In a ``.changes`` file, the ``Description`` field contains a summary of "
"the descriptions for the packages being uploaded. For this case, the "
"first line of the field value (the part on the same line as "
"``Description:``) is always empty. It is a multiline field, with one line"
" per package. Each line is indented by one space and contains the name of"
" a binary package, a space, a hyphen (``-``), a space, and the short "
"description line from that package."
msgstr ""

#: ../../ch-controlfields.rst:704
msgid "``Distribution``"
msgstr ""

#: ../../ch-controlfields.rst:706
msgid ""
"In a ``.changes`` file or parsed changelog output this contains the "
"(space-separated) name(s) of the distribution(s) where this version of "
"the package should be installed. Valid distributions are determined by "
"the archive maintainers.  [#]_ The Debian archive software only supports "
"listing a single distribution. Migration of packages to other "
"distributions is handled outside of the upload process."
msgstr ""

#: ../../ch-controlfields.rst:716
msgid "``Date``"
msgstr ""

#: ../../ch-controlfields.rst:718
msgid ""
"This field includes the date the package was built or last edited. It "
"must be in the same format as the date in a ``debian/changelog`` entry."
msgstr ""

#: ../../ch-controlfields.rst:721
msgid ""
"The value of this field is usually extracted from the "
"``debian/changelog`` file - see :ref:`s-dpkgchangelog`)."
msgstr ""

#: ../../ch-controlfields.rst:727
msgid "``Format``"
msgstr ""

#: ../../ch-controlfields.rst:729
msgid ""
"In |changes link|_ files, this field declares the format version of that "
"file. The syntax of the field value is the same as that of a "
":ref:`package version number <s-f-Version>` except that no epoch or "
"Debian revision is allowed. The format described in this document is 1.8."
msgstr ""

#: ../../ch-controlfields.rst:735
msgid ""
"In |dsc link|_ files, this field declares the format of the source "
"package. The field value is used by programs acting on a source package "
"to interpret the list of files in the source package and determine how to"
" unpack it. The syntax of the field value is a numeric major revision, a "
"period, a numeric minor revision, and then an optional subtype after "
"whitespace, which if specified is an alphanumeric word in parentheses. "
"The subtype is optional in the syntax but may be mandatory for particular"
" source format revisions. [#]_"
msgstr ""

#: ../../ch-controlfields.rst:753
msgid "``Urgency``"
msgstr ""

#: ../../ch-controlfields.rst:755
msgid ""
"This is a description of how important it is to upgrade to this version "
"from previous ones. It consists of a single keyword taking one of the "
"values ``low``, ``medium``, ``high``, ``emergency``, or ``critical`` [#]_"
" (not case-sensitive) followed by an optional commentary (separated by a "
"space) which is usually in parentheses. For example:"
msgstr ""

#: ../../ch-controlfields.rst:765 ../../ch-controlfields.rst:782
msgid ""
"The value of this field is usually extracted from the "
"``debian/changelog`` file - see :ref:`s-dpkgchangelog`."
msgstr ""

#: ../../ch-controlfields.rst:771
msgid "``Changes``"
msgstr ""

#: ../../ch-controlfields.rst:773
msgid ""
"This multiline field contains the human-readable changes data, describing"
" the differences between the last version and the current one."
msgstr ""

#: ../../ch-controlfields.rst:776
msgid ""
"The first line of the field value (the part on the same line as "
"``Changes:``) is always empty. The content of the field is expressed as "
"continuation lines, with each line indented by at least one space. Blank "
"lines must be represented by a line consisting only of a space and a full"
" stop (``.``)."
msgstr ""

#: ../../ch-controlfields.rst:785
msgid ""
"Each version's change information should be preceded by a \"title\" line "
"giving at least the version, distribution(s) and urgency, in a human-"
"readable way."
msgstr ""

#: ../../ch-controlfields.rst:789
msgid ""
"If data from several versions is being returned the entry for the most "
"recent version should be returned first, and entries should be separated "
"by the representation of a blank line (the \"title\" line may also be "
"followed by the representation of a blank line)."
msgstr ""

#: ../../ch-controlfields.rst:797
msgid "``Binary``"
msgstr ""

#: ../../ch-controlfields.rst:799
msgid ""
"This folded field is a list of binary packages. Its syntax and meaning "
"varies depending on the control file in which it appears."
msgstr ""

#: ../../ch-controlfields.rst:802
msgid ""
"When it appears in the ``.dsc`` file, it lists binary packages which a "
"source package can produce, separated by commas [#]_. The source package "
"does not necessarily produce all of these binary packages for every "
"architecture. The source control file doesn't contain details of which "
"architectures are appropriate for which of the binary packages."
msgstr ""

#: ../../ch-controlfields.rst:808
msgid ""
"When it appears in a ``.changes`` file, it lists the names of the binary "
"packages being uploaded, separated by whitespace (not commas)."
msgstr ""

#: ../../ch-controlfields.rst:814
msgid "``Installed-Size``"
msgstr ""

#: ../../ch-controlfields.rst:816
msgid ""
"This field appears in the control files of binary packages, and in the "
"``Packages`` files. It gives an estimate of the total amount of disk "
"space required to install the named package. Actual installed size may "
"vary based on block size, file system properties, or actions taken by "
"package maintainer scripts."
msgstr ""

#: ../../ch-controlfields.rst:822
msgid ""
"The disk space is given as the integer value of the estimated installed "
"size in bytes, divided by 1024 and rounded up."
msgstr ""

#: ../../ch-controlfields.rst:828
msgid "``Files``"
msgstr ""

#: ../../ch-controlfields.rst:830
msgid ""
"This field contains a list of files with information about each one. The "
"exact information and syntax varies with the context."
msgstr ""

#: ../../ch-controlfields.rst:833
msgid ""
"In all cases, Files is a multiline field. The first line of the field "
"value (the part on the same line as ``Files:``) is always empty. The "
"content of the field is expressed as continuation lines, one line per "
"file. Each line must be indented by one space and contain a number of "
"sub-fields, separated by spaces, as described below."
msgstr ""

#: ../../ch-controlfields.rst:839
msgid ""
"In the ``.dsc`` file, each line contains the MD5 checksum, size and "
"filename of the tar file and (if applicable) diff file which make up the "
"remainder of the source package.  [#]_ For example:"
msgstr ""

#: ../../ch-controlfields.rst:849
msgid ""
"The exact forms of the filenames are described in :ref:`s-pkg-"
"sourcearchives`."
msgstr ""

#: ../../ch-controlfields.rst:852
msgid ""
"In the ``.changes`` file this contains one line per file being uploaded. "
"Each line contains the MD5 checksum, size, section and priority and the "
"filename. For example:"
msgstr ""

#: ../../ch-controlfields.rst:864
msgid ""
"The :ref:`section <s-f-Section>` and :ref:`priority <s-f-Priority>` are "
"the values of the corresponding fields in the main source control file. "
"If no section or priority is specified then ``-`` should be used, though "
"section and priority values must be specified for new packages to be "
"installed properly."
msgstr ""

#: ../../ch-controlfields.rst:870
msgid ""
"The special value ``byhand`` for the section in a ``.changes`` file "
"indicates that the file in question is not an ordinary package file and "
"must be installed by hand by the distribution maintainers. If the section"
" is ``byhand`` the priority should be ``-``."
msgstr ""

#: ../../ch-controlfields.rst:875
msgid ""
"If a new Debian revision of a package is being shipped and no new "
"original source archive is being distributed the ``.dsc`` must still "
"contain the ``Files`` field entry for the original source archive "
"``package_upstream-version.orig.tar.gz``, but the ``.changes`` file "
"should leave it out. In this case the original source archive on the "
"distribution site must match exactly, byte-for-byte, the original source "
"archive which was used to generate the ``.dsc`` file and diff which are "
"being uploaded."
msgstr ""

#: ../../ch-controlfields.rst:887
msgid "``Closes``"
msgstr ""

#: ../../ch-controlfields.rst:889
msgid ""
"A space-separated list of bug report numbers that the upload governed by "
"the .changes file closes."
msgstr ""

#: ../../ch-controlfields.rst:895
msgid "``Homepage``"
msgstr ""

#: ../../ch-controlfields.rst:897
msgid ""
"The URL of the web site for this package, preferably (when applicable) "
"the site from which the original source can be obtained and any "
"additional upstream documentation or information may be found. The "
"content of this field is a simple URL without any surrounding characters "
"such as ``<>``."
msgstr ""

#: ../../ch-controlfields.rst:906
msgid "``Checksums-Sha1`` and ``Checksums-Sha256``"
msgstr ""

#: ../../ch-controlfields.rst:908
msgid ""
"These multiline fields contain a list of files with a checksum and size "
"for each one. Both ``Checksums-Sha1`` and ``Checksums-Sha256`` have the "
"same syntax and differ only in the checksum algorithm used: SHA-1 for "
"``Checksums-Sha1`` and SHA-256 for ``Checksums-Sha256``."
msgstr ""

#: ../../ch-controlfields.rst:913
msgid ""
"``Checksums-Sha1`` and ``Checksums-Sha256`` are multiline fields. The "
"first line of the field value (the part on the same line as ``Checksums-"
"Sha1:`` or ``Checksums-Sha256:``) is always empty. The content of the "
"field is expressed as continuation lines, one line per file. Each line "
"consists of the checksum, a space, the file size, a space, and the file "
"name. For example (from a ``.changes`` file):"
msgstr ""

#: ../../ch-controlfields.rst:933
msgid ""
"In the ``.dsc`` file, these fields list all files that make up the source"
" package. In the ``.changes`` file, these fields list all files being "
"uploaded. The list of files in these fields must match the list of files "
"in the ``Files`` field."
msgstr ""

#: ../../ch-controlfields.rst:941 ../../ch-controlfields.rst:1197
msgid "``DM-Upload-Allowed``"
msgstr ""

#: ../../ch-controlfields.rst:943
msgid "Obsolete, see :ref:`below <s-f-DM-Upload-Allowed>`."
msgstr ""

#: ../../ch-controlfields.rst:948
msgid "Version Control System (VCS) fields"
msgstr ""

#: ../../ch-controlfields.rst:950
msgid ""
"Debian source packages are increasingly developed using VCSs. The purpose"
" of the following fields is to indicate a publicly accessible repository "
"where the Debian source package is developed."
msgstr ""

#: ../../ch-controlfields.rst:955
msgid "``Vcs-Browser``"
msgstr ""

#: ../../ch-controlfields.rst:955
msgid "URL of a web interface for browsing the repository."
msgstr ""

#: ../../ch-controlfields.rst:981
msgid "``Vcs-<type>``"
msgstr ""

#: ../../ch-controlfields.rst:958
msgid ""
"The field name identifies the VCS. The field's value uses the version "
"control system's conventional syntax for describing repository locations "
"and should be sufficient to locate the repository used for packaging. "
"Ideally, it also locates the branch used for development of new versions "
"of the Debian package."
msgstr ""

#: ../../ch-controlfields.rst:964
msgid ""
"The following values for <type> are supported, with the corresponding VCS"
" indicated in parentheses if it isn't obvious:"
msgstr ""

#: ../../ch-controlfields.rst:967
msgid "Arch"
msgstr ""

#: ../../ch-controlfields.rst:968
msgid "Bzr (Bazaar)"
msgstr ""

#: ../../ch-controlfields.rst:969
msgid "Cvs (CVS)"
msgstr ""

#: ../../ch-controlfields.rst:970
msgid "Darcs"
msgstr ""

#: ../../ch-controlfields.rst:971
msgid "Git"
msgstr ""

#: ../../ch-controlfields.rst:972
msgid "Hg (Mercurial)"
msgstr ""

#: ../../ch-controlfields.rst:973
msgid "Mtn (Monotone)"
msgstr ""

#: ../../ch-controlfields.rst:974
msgid "Svn (Subversion)"
msgstr ""

#: ../../ch-controlfields.rst:976
msgid ""
"In the case of Git, the value consists of a URL, optionally followed by "
"the word ``-b`` and the name of a branch in the indicated repository, "
"following the syntax of the ``git clone`` command. If no branch is "
"specified, the packaging should be on the default branch."
msgstr ""

#: ../../ch-controlfields.rst:981
msgid "More than one different VCS may be specified for the same package."
msgstr ""

#: ../../ch-controlfields.rst:983
msgid ""
"For both fields, any URLs given should use a scheme that provides "
"confidentiality (``https``, for example, rather than ``http`` or ``git``)"
" if the VCS repository supports it."
msgstr ""

#: ../../ch-controlfields.rst:990
msgid "``Package-List``"
msgstr ""

#: ../../ch-controlfields.rst:992
msgid ""
"Multiline field listing all the packages that can be built from the "
"source package, considering every architecture. The first line of the "
"field value is empty. Each one of the next lines describes one binary "
"package, by listing its name, type, section and priority separated by "
"spaces. Fifth and subsequent space-separated items may be present and "
"parsers must allow them. See the :ref:`Package-Type <s-f-Package-Type>` "
"field for a list of package types."
msgstr ""

#: ../../ch-controlfields.rst:1003
msgid "``Package-Type``"
msgstr ""

#: ../../ch-controlfields.rst:1005
msgid ""
"Simple field containing a word indicating the type of package: ``deb`` "
"for binary packages and ``udeb`` for micro binary packages. Other types "
"not defined here may be indicated. In source package control files, the "
"``Package-Type`` field should be omitted instead of giving it a value of "
"``deb``, as this value is assumed for paragraphs lacking this field."
msgstr ""

#: ../../ch-controlfields.rst:1014
msgid "``Dgit``"
msgstr ""

#: ../../ch-controlfields.rst:1016
msgid ""
"Folded field containing a single git commit hash, presented in full, "
"followed optionally by whitespace and other data to be defined in future "
"extensions."
msgstr ""

#: ../../ch-controlfields.rst:1020
msgid ""
"Declares that the source package corresponds exactly to a referenced "
"commit in a Git repository available at the canonical location called "
"*dgit-repos*, used by ``dgit``, a bidirectional gateway between the "
"Debian archive and Git. The commit is reachable from at least one "
"reference whose name matches ``refs/dgit/*``. See the manual page of "
"``dgit`` for further details."
msgstr ""

#: ../../ch-controlfields.rst:1030
msgid "``Testsuite``"
msgstr ""

#: ../../ch-controlfields.rst:1032
msgid ""
"Simple field containing a comma-separated list of values allowing test "
"execution environments to discover packages which provide tests."
msgstr ""

#: ../../ch-controlfields.rst:1035
msgid ""
"This field is automatically added to Debian source control files "
"(``.dsc``) by ``dpkg``, with the value ``autopkgtest``, when a "
"``debian/tests/control`` file is present in the source package. This "
"field may also be used in source package control files "
"(``debian/control``) if needed in other situations."
msgstr ""

#: ../../ch-controlfields.rst:1044
msgid "``Rules-Requires-Root``"
msgstr ""

#: ../../ch-controlfields.rst:1046
msgid ""
"Simple field that defines if the source package requires access to root "
"(or fakeroot) during selected targets in the :ref:`Main building script: "
"debian/rules <s-debianrules>`."
msgstr ""

#: ../../ch-controlfields.rst:1050
msgid "The field can consist of exactly one of the following three items:"
msgstr ""

#: ../../ch-controlfields.rst:1052
msgid ""
"``no``: Declares that neither root nor fakeroot is required. Package "
"builders (e.g. dpkg-buildpackage) may choose to invoke any target in "
"``debian/rules`` with an unprivileged user."
msgstr ""

#: ../../ch-controlfields.rst:1056
msgid ""
"``binary-targets`` (default): Declares that the package will need the "
"root (or fakeroot) when either of the ``binary``, ``binary-arch`` or "
"``binary-indep`` targets are called.  This is how every tool behaved "
"before this field was defined."
msgstr ""

#: ../../ch-controlfields.rst:1061
msgid ""
"A space separated list of keywords described below.  These keywords must "
"always contain a forward slash, which sets them apart from the other "
"possible values of ``Rules-Requires-Root``.  When this list is provided, "
"the builder must provide a `gain root command` (as defined in "
":ref:`debian/rules and Rules-Requires-Root <s-debianrules-gainrootapi>`) "
"*or* pretend that the value was set to ``binary-targets``, and both the "
"builder and the package's ``debian/rules`` script must downgrade "
"accordingly (see below)."
msgstr ""

#: ../../ch-controlfields.rst:1070
msgid ""
"If the package builder supports the ``Rules-Requires-Root`` field and "
"wants to enable the feature, then it must set the environment variable "
"``DEB_RULES_REQUIRES_ROOT`` when invoking the package building script "
"``debian/rules``.  The value of ``DEB_RULES_REQUIRES_ROOT`` should be one"
" of:"
msgstr ""

#: ../../ch-controlfields.rst:1076
msgid ""
"The value of ``Rules-Requires-Root`` if the builder can support that "
"value.  The builder may trim unnecessary whitespace used to format the "
"field for readability."
msgstr ""

#: ../../ch-controlfields.rst:1080
msgid ""
"The value ``binary-targets`` if it cannot support the value of ``Rules-"
"Requires-Root``."
msgstr ""

#: ../../ch-controlfields.rst:1083
msgid ""
"A compliant builder may also leave ``DEB_RULES_REQUIRES_ROOT`` unset or "
"set it to ``binary-targets`` if it has been requested to test whether the"
" package it builds correctly implements the fall-back for legacy "
"builders."
msgstr ""

#: ../../ch-controlfields.rst:1089
msgid "Remarks"
msgstr ""

#: ../../ch-controlfields.rst:1091
msgid ""
"All packages and builders must support ``binary-targets`` as this was the"
" historical behaviour prior to the introduction of this field."
msgstr ""

#: ../../ch-controlfields.rst:1094
msgid ""
"Any tool (particularly older versions of them) may be unaware of this "
"field and behave like the field was set to ``binary-targets``.  The "
"package build must gracefully cope with this and produce a semantically "
"equivalent result."
msgstr ""

#: ../../ch-controlfields.rst:1099
msgid ""
"This field intentionally does not enable a package to request a true root"
" over fakeroot."
msgstr ""

#: ../../ch-controlfields.rst:1103
msgid "Definition of the keywords"
msgstr ""

#: ../../ch-controlfields.rst:1105
msgid "The keywords have the format ``<namespace>/<case>``, where:"
msgstr ""

#: ../../ch-controlfields.rst:1107
msgid ""
"``<namespace>`` must consist entirely of printable ASCII characters "
"except for any whitespace and the forward slash (``/``).  It must consist"
" of at least 2 characters."
msgstr ""

#: ../../ch-controlfields.rst:1111
msgid ""
"``/`` (between ``<namespace>`` and ``<case>``) is a single ASCII forward "
"slash."
msgstr ""

#: ../../ch-controlfields.rst:1114
msgid ""
"``<case>`` must consist entirely of printable ASCII characters except for"
" any whitespace.  It must consist of at least 2 characters."
msgstr ""

#: ../../ch-controlfields.rst:1118
msgid ""
"These keywords define where the package build script ``debian/rules``, or"
" the tools called by that script, will need access to root or fakeroot."
msgstr ""

#: ../../ch-controlfields.rst:1122
msgid ""
"In addition to the keywords defined in the next section, each tool or "
"package may define keywords within a namespace named after that tool or "
"package.  The package or tool is considered to own that namespace."
msgstr ""

#: ../../ch-controlfields.rst:1126
msgid ""
"A tool may use the `gain root command` to do something under (fake)root "
"if and only if the tool defines an appropriate keyword in its namespace, "
"and the package lists that keyword in ``Rules-Requires-Root``."
msgstr ""

#: ../../ch-controlfields.rst:1131
msgid ""
"All tools must ignore keywords under namespaces they do not know or own."
"  A tool may emit a warning, or abort with an error, if it finds unknown "
"keywords in namespaces it owns, but it is not required to do this for all"
" keywords in the namespace."
msgstr ""

#: ../../ch-controlfields.rst:1137
msgid "Provided keywords"
msgstr ""

#: ../../ch-controlfields.rst:1139
msgid "The following keywords are defined:"
msgstr ""

#: ../../ch-controlfields.rst:1141
msgid ""
"``dpkg/target-subcommand``: declares that there exists a command that the"
" ``debian/rules`` file must run under (fake)root"
msgstr ""

#: ../../ch-controlfields.rst:1144
msgid ""
"``dpkg/target/foo``: declares that the additional, package-specific "
"target ``foo`` (that is, not one of the targets specified in :ref:`Main "
"building script: debian/rules <s-debianrules>`) must be run under "
"(fake)root"
msgstr ""

#: ../../ch-controlfields.rst:1149
msgid ""
"This list is intentionally incomplete. You should consult the "
"documentation of the tool or package in question for which keywords it "
"defines and when they are needed."
msgstr ""

#: ../../ch-controlfields.rst:1156
msgid "User-defined fields"
msgstr ""

#: ../../ch-controlfields.rst:1158
msgid ""
"Additional user-defined fields may be added to the source package control"
" file. Such fields will be ignored, and not copied to (for example) "
"binary or Debian source control files or upload control files."
msgstr ""

#: ../../ch-controlfields.rst:1162
msgid ""
"If you wish to add additional unsupported fields to these output files "
"you should use the mechanism described here."
msgstr ""

#: ../../ch-controlfields.rst:1165
msgid ""
"Fields in the main source control information file with names starting "
"``X``, followed by one or more of the letters ``BCS`` and a hyphen ``-``,"
" will be copied to the output files. Only the part of the field name "
"after the hyphen will be used in the output file. Where the letter ``B`` "
"is used the field will appear in binary package control files, where the "
"letter ``S`` is used in Debian source control files and where ``C`` is "
"used in upload control (``.changes``) files."
msgstr ""

#: ../../ch-controlfields.rst:1173
msgid ""
"For example, if the main source information control file contains the "
"field"
msgstr ""

#: ../../ch-controlfields.rst:1180
msgid "then the binary and Debian source control files will contain the field"
msgstr ""

#: ../../ch-controlfields.rst:1189
msgid "Obsolete fields"
msgstr ""

#: ../../ch-controlfields.rst:1191
msgid ""
"The following fields have been obsoleted and may be found in packages "
"conforming with previous versions of the Policy."
msgstr ""

#: ../../ch-controlfields.rst:1199
msgid ""
"Indicates that Debian Maintainers may upload this package to the Debian "
"archive. The only valid value is ``yes``. This field was used to regulate"
" uploads by Debian Maintainers, See the General Resolution `Endorse the "
"concept of Debian Maintainers "
"<https://www.debian.org/vote/2007/vote_003>`_ for more details."
msgstr ""

#: ../../ch-controlfields.rst:1207
msgid "``dpkg``'s internal databases are in a similar format."
msgstr ""

#: ../../ch-controlfields.rst:1210
msgid "The paragraphs are also sometimes referred to as stanzas."
msgstr ""

#: ../../ch-controlfields.rst:1213
msgid ""
"This folding method is similar to RFC 5322, allowing control files that "
"contain only one paragraph and no multiline fields to be read by parsers "
"written for RFC 5322."
msgstr ""

#: ../../ch-controlfields.rst:1218
msgid ""
"It is customary to leave a space after the package name if a version "
"number is specified."
msgstr ""

#: ../../ch-controlfields.rst:1222
msgid ""
"In the past, people specified the full version number in the Standards-"
"Version field, for example \"2.3.0.0\". Since minor patch-level changes "
"don't introduce new policy, it was thought it would be better to relax "
"policy and only require the first 3 components to be specified, in this "
"example \"2.3.0\". All four components may still be used if someone "
"wishes to do so."
msgstr ""

#: ../../ch-controlfields.rst:1230
msgid "Alphanumerics are ``A-Za-z0-9`` only."
msgstr ""

#: ../../ch-controlfields.rst:1233
msgid ""
"One common use of ``~`` is for upstream pre-releases. For example, "
"``1.0~beta1~svn1245`` sorts earlier than ``1.0~beta1``, which sorts "
"earlier than ``1.0``."
msgstr ""

#: ../../ch-controlfields.rst:1238
msgid ""
"The author of this manual has heard of a package whose versions went "
"``1.1``, ``1.2``, ``1.3``, ``1``, ``2.1``, ``2.2``, ``2`` and so forth."
msgstr ""

#: ../../ch-controlfields.rst:1243
msgid ""
"Completely empty lines will not be rendered as blank lines. Instead, they"
" will cause the parser to think you're starting a whole new record in the"
" control file, and will therefore likely abort with an error."
msgstr ""

#: ../../ch-controlfields.rst:1249
msgid ""
"Example distribution names in the Debian archive used in ``.changes`` "
"files are:"
msgstr ""

#: ../../ch-controlfields.rst:1256
msgid "*unstable*"
msgstr ""

#: ../../ch-controlfields.rst:1253
msgid ""
"This distribution value refers to the *developmental* part of the Debian "
"distribution tree. Most new packages, new upstream versions of packages "
"and bug fixes go into the *unstable* directory tree."
msgstr ""

#: ../../ch-controlfields.rst:1263
msgid "*experimental*"
msgstr ""

#: ../../ch-controlfields.rst:1259
msgid ""
"The packages with this distribution value are deemed by their maintainers"
" to be high risk. Oftentimes they represent early beta or developmental "
"packages from various sources that the maintainers want people to try, "
"but are not ready to be a part of the other parts of the Debian "
"distribution tree."
msgstr ""

#: ../../ch-controlfields.rst:1265
msgid ""
"Others are used for updating stable releases or for security uploads. "
"More information is available in the Debian Developer's Reference, "
"section \"The Debian archive\"."
msgstr ""

#: ../../ch-controlfields.rst:1270
msgid ""
"The source formats currently supported by the Debian archive software are"
" ``1.0``, ``3.0 (native)``, and ``3.0 (quilt)``."
msgstr ""

#: ../../ch-controlfields.rst:1274
msgid ""
"Other urgency values are supported with configuration changes in the "
"archive software but are not used in Debian. The urgency affects how "
"quickly a package will be considered for inclusion into the ``testing`` "
"distribution and gives an indication of the importance of any fixes "
"included in the upload. ``Emergency`` and ``critical`` are treated as "
"synonymous."
msgstr ""

#: ../../ch-controlfields.rst:1282
msgid "A space after each comma is conventional."
msgstr ""

#: ../../ch-controlfields.rst:1285
msgid "That is, the parts which are not the ``.dsc``."
msgstr ""

