[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#593909: debian-policy: Clarifications about the syntax of Debian control files.

On Thu, 2010-08-26 at 10:05 +0900, Charles Plessy wrote:
> Le Sun, Aug 22, 2010 at 03:23:26PM +0900, Charles Plessy a écrit :
> > 
> > 
> > I have been reading §5.1 (Syntax of control files) many times recently, and
> > would like propose clarifications about a couple of points. If consensus emerges,
> > I will write a patch.
> > 
> > 
> > Non-wrappable field values
> > Ordering of the paragraphs
> > Line escape and paragraph separators
> Hi again,
> to this list I would like to add comment lines. Currently they are described in
> §5.2 (5.2 Source package control files -- debian/control), as an additional
> syntax, which strongly suggests that they are allowed in this file only.
> Independantly of whether this is confirmed or not, this syntactic information
> would rather belong to §5.1, that defines the syntax of the control files,
> instead of §5.2, which like the next chapters §5.3–6 lists the fields allowed
> in the different Debian control files. I would therefore propose to have in
> §5.1:
>   Lines starting with # without any preceding whitespace are ‘comments lines’
>   and are ignored, even in the middle of continuation lines for a multiline
>   field. They do not end a multiline field.
> If comment lines are only allowed in source package control files, we could
> add:
>   The use of such comments must be allowed on a per-file basis.
> And then in §5.2:
>   Comment lines are allowed.
> The benefit of this is that it concentrates in §5.1 all the instructions to
> write a basic parser for Debian control files.

This seems sensible, and I think all of the clarifications you plan are
in the same light, and I would certainly support a patch expressing this
all more clearly.


andrew (AT) morphoss (DOT) com                            +64(272)DEBIAN
    I have not seen high-discipline processes succeed in commercial
                     settings. - Alistair Cockburn


Attachment: signature.asc
Description: This is a digitally signed message part

Reply to: