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.
Cheers,
Andrew.
--
------------------------------------------------------------------------
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