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