Re: DEP-5: Comment field

[Charles Plessy <plessy@debian.org>]

Le Thu, Aug 26, 2010 at 08:57:34AM +1200, Lars Wirzenius a écrit :
> The Comment field has been suggested for DEP-5.
> 
> There is a pretty clear consensus that we want it. Thus, I propose this
> to be added to the section explaining fields in the header (the
> paragraph with Format etc):
> 
>          * **`Comment`**
>            * Optional
>            * Single occurrence per paragraph, can occur in each paragraph.
>            * Value: formatted text, no synopsis
>            * Description: This field can provide additional information. For
>              example, it might quote an e-mail from the Debian ftpmaster team
>              justifying why the license is acceptable to the main archive, or
>              an explanation of how this version of the package has been forked
>              from a version known to be DFSG-free, even though the current
>              upstream version is not.
> 
> Comments on Comment?

Common comments come on.

 - Will paragraphs that contain only a Comment field be valid ?

 - Is the purpose of the field to be displayed after parsing, or only to
   provide complements of information in the source file ?

 - If we take the Policy strictly, comments lines starting by ‘#’ are only
   allowed in §5.2 (Source package control files -- debian/control),
   which we do not refer to in the DEP. Will the DEP also accept such
   comment lines ?

Cheers,

-- 
Charles