Bug#812119: devscripts: uscan; Files-Excluded syntax is not specified anywhere

[Osamu Aoki]

Hi,

On Wed, Jan 20, 2016 at 10:36:28PM +0000, Wookey wrote:
> +++ James McCoy [2016-01-20 14:49 -0500]:
> > On Jan 20, 2016 2:33 PM, "Adam D. Barratt" <adam at adam-barratt.org.uk> wrote:
> > >
> > > #685506 exists to rectify that, although it hasn't seen any activity for
> > > a while.
> 
> Thank you useful pointer (to long discussion). I got a bit lost in
> there. What is needed to finally have this field (the version that has
> been implemented) documented in the copyright file format doc?
> 
> I don't actually know where
> http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
> comes from. Is it part of policy and thus a patch aginst debian-policy
> is needed?
>  
> > The short version being, Files-Excluded has the same syntax as Files.
> 
> Yes, but has to be in the header paragraph, not the Files paragraph,
> and there can only be one of it (two in the header is a syntax error,
> one in header and more in other paras: the others get ignored).
> 
> But yes these 4 lines is about all that is needed.

For multi-tarball packages, the new Files-Excluded-<component> stanza also
works the same way.

FYI: These are somewhat mentioned in the new manpage of uscan and
mk-origtargz.  Mentioning requirement to be in the header paragraph, not
in the Files paragraph, may be good idea.  Text suggestions welcomed.

Regards,

Osamu