Bug#649530: [copyright-format] clearer definitions and more consistent License: stanza specification

[Jonathan Nieder <jrnieder@gmail.com>]

Charles Plessy wrote:
> Le Wed, Feb 08, 2012 at 06:15:55PM -0600, Jonathan Nieder a écrit :

>>        <para>
>>          Remaining lines: if left blank here, the file
>> -        <emphasis>must</emphasis> include one or more<link
>> +        <emphasis>must</emphasis> include a <link
>>          linkend="stand-alone-license-paragraph">stand-alone License
>> -        paragraphs</link> matching the first line's license short
>> +        paragraph</link> matching each of the first line's license short
>>          names, with their exception if any.
>>          Otherwise, this field should either
>>          include the full text of the license(s) or include a pointer to the
>
> Hi Jonathan,
>
> I am not sure that using the singular makes the instructions clearer.  Couldn't
> one argue that it does not allow to have two standalone License paragraphs for
> one dual license statement from a Files paragraph ?

Ah, thanks for mentioning this.  I should have explained it.

The problem is that the text

	include one or more paragraphs matching the license short names

is somewhat ambiguous.  To my ears, the reading that jumps out is (1)
I might want to provide one, two, or even more standalone paragraphs,
according to my preference, and (2) each one of those paragraphs
should simultaneously match all license names from the Files
paragraph.  Clearly that is wrong, so I wanted to disambiguate.

Therefore I wrote:

	include a paragraph matching each of the license short names

which is intended to convey that for each license short name mentioned
in this Files paragraph, there must be (at least) one standalone
license paragraph.

Now based on your response, I suspect you misread "each" to mean
"all".  Can you suggest an alternate wording?  For example, maybe
something in this spirit would work:

	If there are no remaining lines, then all of the short names
	or short names followed by license exceptions making up the
	first line must be described in standalone license paragraphs.

Thanks for looking it over.

Sincerely,
Jonathan