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> <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, and leave it in the current + directory. </p> <p> @@ -1922,8 +1931,14 @@ </p> <p> - 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. </p> </item> -- \ “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