--- This patch adds the pristine-tar item to the tag2upload spec. It's based on Ian's suggested text, with some clarifications. Should be almost ready.
tag2upload.5.pod | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/tag2upload.5.pod b/tag2upload.5.pod index 7206fb4e..f934d210 100644 --- a/tag2upload.5.pod +++ b/tag2upload.5.pod @@ -139,6 +139,32 @@ With C<baredebian> quilt modes, this option is mandatory. specifies a native source package format, or if the targeted archive already contains a suitable orig.) +=item C<!pristine-tar>=COMMITID + +Names a commit containing pristine-tar metadata. + +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. + +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. + +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). + +If an orig tarball needs to be (re)generated, the service will use +pristine-tar, using precisely the metadata in the aforementioned files. The +service will check that the generated tarball is treesame to the tree named +in the .id file. + +The named prstine-tar commit must be reachable from the C<pristine-tar> +branch in the repository. + =item C<--quilt=QUILT-MODE> Specifies the git tree format in use, -- 2.47.2
