package debian-policy tags 466550 + patch thanks On 19-Feb-2008, Andres Mejia wrote: > When considering the phrase in policy "...does any necessary > rearrangement to turn it into the original source tar file > format...", it makes more sense when it refers to the original > source tar file of the source package in Debian (or will be in > Debian), and the original source tarball would be at a particular > version, and thus the get-orig-source should generate that > particular version of the original source tarball of the source > package in Debian.
Here's my attempt:
=== modified file 'policy.sgml'
--- policy.sgml 2009-03-05 08:44:48 +0000
+++ policy.sgml 2009-03-05 09:06:48 +0000
@@ -1907,12 +1907,21 @@
<tag><tt>get-orig-source</tt> (optional)</tag>
<item>
<p>
- 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 described below, and leave it in
+ the current directory.
</p>
<p>
@@ -1922,8 +1931,13 @@
</p>
<p>
- This target is optional, but providing it if
- possible is a good idea.
+ Commonly, upstream developers will make canonical
+ original source archive files for specific versions
+ available for direct public download, and the
+ ‘uscan(1)’ tool can automate this task with an
+ appropriate ‘debian/watch’ configuration file. This
+ target is therefore optional, and required only for
+ those cases not satisfied by ‘uscan(1)’.
</p>
</item>
--
\ “I hope that after I die, people will say of me: ‘That guy sure |
`\ owed me a lot of money’.” —Jack Handey |
_o__) |
Ben Finney <b...@benfinney.id.au>
signature.asc
Description: Digital signature
