# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-10-24 16:20+0100\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"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: =head1
#: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
#: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
#: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
#: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
#: ../dgit-maint-bpo.7.pod:1 ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
#: ../git-debpush.1.pod:1 ../git-deborig.1.pod:1 ../tag2upload.5.pod:1
#, no-wrap
msgid "NAME"
msgstr ""

#. type: =head1
#: ../dgit.1:1932 ../dgit.7:23 ../dgit-user.7.pod:446
#: ../dgit-nmu-simple.7.pod:158 ../dgit-maint-native.7.pod:125
#: ../dgit-maint-merge.7.pod:509 ../dgit-maint-gbp.7.pod:138
#: ../dgit-maint-debrebase.7.pod:792 ../dgit-downstream-dsc.7.pod:352
#: ../dgit-sponsorship.7.pod:326 ../dgit-maint-bpo.7.pod:140
#: ../git-debrebase.1.pod:640 ../git-debrebase.5.pod:677
#: ../git-debpush.1.pod:339 ../git-deborig.1.pod:60 ../tag2upload.5.pod:337
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: =head1
#: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
#: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
#: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
#: ../dgit-maint-bpo.7.pod:5 ../git-debrebase.5.pod:5 ../tag2upload.5.pod:5
msgid "INTRODUCTION"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:3
msgid "tag2upload - protocol for uploading to Debian via signed git tag"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:7
msgid ""
"tag2upload is a scheme that allows an authorised Debian package maintainer "
"to update a package in the Debian archive, by pushing an appropriate signed "
"git tag."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:11
msgid ""
"Typically these tags are created with git-debpush, and interpreted by C<dgit-"
"repos-server --tag2upload>."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:15
msgid ""
"However, the tags are plain git tags, with small amounts of additional "
"metadata, so they could be made by other tooling."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:19
msgid "This document defines the syntax and semantics of the tag."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:21
msgid "BASICS"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:23
msgid ""
"A signed git tag is an instruction to the tag2upload service if the tag "
"message contains a line looking like this:"
msgstr ""

#. type: verbatim
#: ../tag2upload.5.pod:26
#, no-wrap
msgid ""
" [dgit ... please-upload ...]\n"
"\n"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:28
msgid ""
"The tag must be signed by an authorised uploader, for the relevant package.  "
"The tagged object must be a git commit.  Metadata about the intended "
"operation is obtained from both the tag message and the referenced git tree "
"object."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:35
msgid "GIT METADATA"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:37
msgid ""
"The git tag's name must be C<DISTRO/VERSION>, where VERSION is in the Debian "
"package version number transformed to be valid for git as specified in "
"DEP-14, and DISTRO is the distribution name (the DEP-14 \"vendor\", "
"C<debian> for Debian)."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:43
msgid ""
"The email address from git's C<tagger> field (ie, the author of the tag, "
"from git's point of view)  will be emailed any error reports."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:47
msgid "TAG2UPLOAD IN-TAG METADATA"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:49
msgid ""
"tag2upload reuses a tag metadata format, and some metadata semantics, from "
"dgit."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:53
msgid ""
"Metadata lines are in the form C<[dgit ...]>.  The brackets must be at the "
"start and end of the line.  Inside the brackets, after C<dgit>, are space "
"separated metadata items."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:58
msgid ""
"Each metadata item is C<keyword> or C<keyword=value> (splitting on the first "
"C<=>).  Keywords start with one of the characters C<! - + . 0-9 a-z>.  Items "
"may not contain whitespace.  Any metadata line whose first item starts with "
"a double quote C<\"> is reserved for future expansion, and the whole line is "
"ignored."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:65
msgid ""
"The placement and ordering of metadata items is not relevant, except for the "
"relative ordering of items with the same keyword.  A keyword may be repeated "
"iff this is stated in its description.  Unknown keywords are ignored (and "
"may be repeated)."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:70
msgid ""
"So the abstract data model of a whole parsed but not interpeted tag is: map, "
"from keyword, to nonempty sequence of optional values.  In Rust-ish syntax, "
"C<< Map<String, Vec<Option<String>>> >>."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:74
msgid ""
"Keywords that start with C<!> contain information which is critical for "
"correct processing by the tag2upload service; the service will reject tags "
"containing unknown C<!> items."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:80
msgid "C<please-upload>"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:82
msgid ""
"Declares that this tag is indeed an instruction to a tag2upload service, to "
"produce and upload a source package based on the commit at which the tag "
"points."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:87
msgid ""
"The relevant git objects will also be pushed to a canonical server belonging "
"to the targeted distro (in Debian's case, *.dgit.debian.org)."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:91
msgid "C<source=SOURCE> C<version=VERSION>"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:93
msgid ""
"Specifies the name and version of the source package intended to be "
"uploaded, as also appear in the first line of F<debian/changelog>.  "
"Duplicating this information in the tag metadata is necessary to ensure "
"certain security properties."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:99
msgid ""
"The package and version must correspond to F<debian/control>, or it is an "
"error."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:102
msgid "C<distro=DISTRO>"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:104
msgid ""
"Specifies an intended distribution, to which the package is to be uploaded.  "
"May be repeated."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:108
msgid ""
"Each tag2upload instance ignores tags which do not mention that instance's "
"DISTRO.  So for a tag to be effective, at least one distro= must be present."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:113
msgid ""
"(Note that DISTRO also appears in the tag name, so uploading to multiple "
"distros necessarily involves several tags, although they may have the same "
"tag message.)"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:117
msgid "C<upstream>=COMMITID C<upstream-tag>=TAG"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:119
msgid "Identifies the upstream source code to be used."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:121
msgid ""
"This corresponds to the \"orig\" in the source package.  The orig tarball "
"will be generated with C<git archive>, as invoked by C<git deborig>."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:125
msgid ""
"Both or neither of these must be supplied.  TAG must be fetchable from the "
"same repo as the tag2upload tag, and must resolve to COMMITID, which must be "
"an unabbreviated hash."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:129
msgid ""
"TAG is required in order to ensure that COMMITID is retrievable.  This is "
"because most git repository servers only allow fetching tags and branches, "
"not arbitrary commits."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:133
msgid ""
"If these are omitted, any necessary orig must already be present in the "
"target source package archive.  With C<baredebian> quilt modes, this option "
"is mandatory."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:138
msgid ""
"(This metadata item might be ignored if the git tree specifies a native "
"source package format, or if the targeted archive already contains a "
"suitable orig.)"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:142
msgid "C<!pristine-tar>=COMMITID"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:144
msgid "Names a commit containing pristine-tar metadata."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:146
msgid ""
"The commit must contain exactly one .id file and one .delta for the current "
"upstream release, and their names must correspond to the name of the orig "
"tarball, with \".id\" and \".delta\" appended, respectively.  They must be "
"regular files."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:151
msgid ""
"The tag must also contain an C<upstream> item, and the tree named in the .id "
"file must be identical to that of the C<upstream> commit."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:154
msgid ""
"The pristine-tar commit may contain a signature file.  The signature file "
"name must correspond to the name of the orig tarball, with \".asc\" "
"appended.  The signature file will then be published together with the orig "
"tarball.  The signature file is treated as pure data by the service (so will "
"not be verified or even format checked)."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:160
msgid ""
"If an orig tarball needs to be (re)generated, the service will use pristine-"
"tar, using precisely the metadata in the aforementioned files.  The "
"resulting tarball's contents must be identical to the named git tree, except "
"that it may also contain empty directories.  Specfically, in this "
"comparison, timestamps, ownerships, ordinary 0777 permissions other than "
"executability, and ordering, are disregarded; objects other than plain files "
"with ordinary permissions directories, and symlinks, are forbidden.  (So for "
"example, set-id files, POSIX ACLs, and and attributes, are forbidden.)"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:169
msgid ""
"The named prstine-tar commit must be reachable from the C<pristine-tar> "
"branch in the repository."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:172
msgid "C<--quilt=QUILT-MODE>"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:174
msgid ""
"Specifies the git tree format in use, for a C<3.0 (quilt)> source package."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:177
msgid "The semantics are the same as for the identically-named dgit option."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:179
msgid ""
"If this option is not specified, the default is C<quilt=linear> (depending "
"on the distro and configuration)."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:183
msgid "C<--deliberately=...>"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:185
msgid ""
"The semantics are the same as for the identically-named dgit option.  Unused "
"or unknown deliberately options are ignored."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:188
msgid "C<split>"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:190
msgid ""
"Instructs the tag2upload service that this upload is to be made in \"split "
"git view\" mode:"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:193
msgid ""
"When converting from git to a source package, and in order to push and "
"upload, it may be necessary to make changes -- both to tree content and to "
"git history.  For example, it may be necessary to apply quilt patches, or to "
"make the git branch fast-forwarding from previous history in the targeted "
"suite."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:201
msgid ""
"C<split> instructs the tag2upload service to make these changes, and push "
"git commits representing these changes to only its canonical target "
"repository.  I.e., the suite branch in the canonical target repository may "
"contain additional changes, but these will not be automatically pushed back "
"to a maintainer-owned git repository (eg salsa.debian.org).  The git history "
"on the canonical target repository is always descended from the form "
"supplied by the tagger; it can be readily obtained using dgit."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:214
msgid ""
"Under the current implementation, this metadata item is mandatory, because "
"the service is not capable of doing anything else."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:221
msgid "IN-TREE METADATA"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:223
msgid "The target suite(s), are obtained from F<debian/changelog>."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:227
msgid "CONTENTS OF THE TREE"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:229
msgid "The tree must be in the form of an unpacked Debian source package."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:231
msgid ""
"For a non-native source package format, the upstream files must correspond "
"to any upstream commit specified, or the orig already present in the archive "
"-- either patched or unpatched, according to the quilt mode."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:237
msgid "Mismatches will cause the tag2upload service's processing to fail."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:239
msgid "SEMANTICS"
msgstr ""

#. type: =head2
#: ../tag2upload.5.pod:241
msgid "Influences on processing at the tag2upload service"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:243
msgid ""
"The tag2upload service's processing of a particular tag is influenced "
"B<only> by:"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:248
msgid ""
"git objects whose object ids are quoted in the tag, and git objects they "
"transitively reference by id"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:251
msgid "the distro's ftp archive (e.g. ftp.debian.org)"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:253
msgid "the distro's git deposiotry (e.g. *.dgit.debian.org)"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:255
msgid ""
"The URL and ref names in the tag2upload tag text are only used as aid to "
"fetching the objects named by objectid."
msgstr ""

#. type: =head2
#: ../tag2upload.5.pod:260
msgid "Meaning of the tag"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:262
msgid "The tag, and git objects it references, uniquely determine:"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:266
msgid "The canonical source tree"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:268
msgid ""
"I.e., the patches-applied tree, ready for building with dpkg-buildpackage.  "
"(Also known as the \"dgit view\" tree.)"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:272
msgid ""
"Depending on the quilt mode, this may not be identical to the tagged git "
"tree."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:275
msgid ""
"The service will make a tag C<archive/DISTRO/VERSION> on a commit whose tree "
"is in this canonical form."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:278
msgid "The destination distro, suite, source package name, and version"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:280
msgid "These are directly stated in the tag, or available in the tagged tree."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:282
msgid ""
"All of the copies of the information must correspond.  For example, "
"C<Source> in C<debian/control> must match C<source=> in the tag.  Otherwise "
"the tag is incoherent."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:289
msgid "The tag does B<not> uniquely determine:"
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:293
msgid "The precise source package (.dsc) which should be generated"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:295
msgid ""
"This is because the source package may be influenced by orig tarballs "
"present in the distro's ftp archive."
msgstr ""

#. type: =item
#: ../tag2upload.5.pod:298
msgid "The precice canonical view git ancestry"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:300
msgid ""
"The C<archive/DISTRO/VERSION> tag will be made on a commit whose tree is "
"uniquely determined by the tag, as noted above."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:304
msgid "That commit will have the DEP-14 tagged commit as an ancestor."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:306
msgid ""
"But, with C<split> in the tag, the canonical view's other ancestors can "
"depend on the existing contents of both the git depository, and the ftp "
"archive."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:313
msgid "REPLAY"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:315
msgid "Uploading is intended to be an idempotent process."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:317
msgid ""
"Thus, the tag2upload tag is an instruction to upload I<only if the supplied "
"version is later than the one in the targeted suite>."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:320
msgid ""
"Old tags, specifying old versions, will be rejected (although replay "
"attempts might generate some error mail to the tagger)."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:323
msgid "INVOCATION AND QUEUEING"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:325
msgid ""
"Normally, arrangements will be made so that the tag2upload service becomes "
"aware of new git tags, in relevant repositories; for example, by means of "
"webhooks."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:329
msgid ""
"If this mechanism fails, the tagging user may need to manually provoke the "
"tag2upload service into rescanning the relevant repository."
msgstr ""

#. type: =head1
#: ../tag2upload.5.pod:332
msgid "CREDITS"
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:334
msgid ""
"tag2upload was designed by Ian Jackson <ijackson@chiark.greenend.org.uk> and "
"Sean Whitton <spwhitton@spwhitton.name>."
msgstr ""

#. type: textblock
#: ../tag2upload.5.pod:339
msgid "dgit(1), git-debpush(1)."
msgstr ""