[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Pristine source from upstream VCS repository

On 05-Mar-2009, Charles Plessy wrote:
> at the same time, your patch would make it mandatory to write a
> get-orig-source target when uscan(1) can not do the job. […] Can you
> soften your wording to the current "optional" status ?

Agreed. I also should have used the standard document markup for
various terms.

Here is an updated patch:

=== modified file 'policy.sgml'
--- policy.sgml	2009-03-05 08:44:48 +0000
+++ policy.sgml	2009-03-05 23:59:38 +0000
@@ -1907,12 +1907,21 @@
 	    <tag><tt>get-orig-source</tt> (optional)</tag>
-		This target fetches the most recent version of the
-		original source package from a canonical archive site
-		(via FTP or WWW, for example), does any necessary
+		This target generates the original source archive for
+		the package, such that its contents exactly match the
+		original source archive used to generate the package
+		for Debian. See the “Original source archive”
+		section, below, for policy details of this file.
+	      </p>
+	      <p>
+		The actions for this target fetch the original source
+		package, corresponding to the Debian package version,
+		from a canonical archive site (for example, via FTP,
+		WWW, or a public VCS repository), do any necessary
 		rearrangement to turn it into the original source
-		tar file format described below, and leaves it in the
-		current directory.
+		archive file format, and leave it in the current
+		directory.
@@ -1922,8 +1931,14 @@
-		This target is optional, but providing it if
-		possible is a good idea.
+		This target is <em>optional</em>. A common reason to
+		forego this target is that the upstream developers
+		make canonical original source archive files for
+		specific versions available for direct public
+		download; in these cases, the package only needs an
+		appropriate <file>debian/watch</file> configuration
+		for <prgn>uscan</prgn> to fetch the original source
+		archive.

 \          “Immorality: The morality of those who are having a better |
  `\                                          time.” —Henry L. Mencken |
_o__)                                                                  |
Ben Finney <ben@benfinney.id.au>

Attachment: signature.asc
Description: Digital signature

Reply to: