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 <ben@benfinney.id.au>
Attachment:
signature.asc
Description: Digital signature