On Sat, 2010-06-12 at 18:18 +0900, Charles Plessy wrote:
> Le Fri, Jun 11, 2010 at 09:58:28AM -0700, Russ Allbery a écrit :
> >
> > diff --git a/policy.sgml b/policy.sgml
> > index 87b9795..99ab0ff 100644
> > --- a/policy.sgml
> > +++ b/policy.sgml
> > @@ -2398,6 +2398,11 @@ Package: libc6
> > </p>
> >
> > <p>
> > + Each paragraph may contain at most one instance of a particular
> > + field name.
> > + </p>
> > +
> > + <p>
> > Many fields' values may span several lines; in this case
> > each continuation line must start with a space or a tab.
> > Any trailing spaces or tabs at the end of individual
>
> Hi Russ,
>
> as a non-native speaker, I have difficulties with the use of 'may' in your
> patch: if fields may be unique, they also may be not unique, so what is the
> message in this sentence? It does not give me the impression that the goal
> is to discourage the use of the same field name twice in the same paragraph.
>
> How about “A paragraph should not contain data fields having the same name.”
Hi Charles,
In this sense 'may' should be read as 'must', however I think that if it
causes readability issues for non-native english speakers then the word
'must' should actually be used...
"Each paragraph must contain at most one instance of a particular
field name."
Is that clearer?
Cheers,
Andrew.
--
------------------------------------------------------------------------
andrew (AT) morphoss (DOT) com +64(272)DEBIAN
Building more free and open source software for New Zealanders
------------------------------------------------------------------------
Attachment:
signature.asc
Description: This is a digitally signed message part