[Top][All Lists]

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

Re: The netsec thread

From: Eli Zaretskii
Subject: Re: The netsec thread
Date: Fri, 23 Aug 2019 17:40:04 +0300

> From: Robert Pluim <address@hidden>
> Cc: address@hidden,  address@hidden
> Date: Fri, 23 Aug 2019 16:27:59 +0200
>     Eli> If this is your interpretation of what NEWS says, then we must modify
>     Eli> that text to be less ambiguous.  "+++" means the doc strings AND the
>     Eli> manuals have been updated, "---" means the doc string WITHOUT manuals
>     Eli> were updated.
> That was indeed my interpretation.
>     Eli> These markers are there for when we are close to releasing a new 
> major
>     Eli> version, and need to make sure everything that needs to be in the
>     Eli> manuals is in the manuals.  It therefore makes no sense to mark by
>     Eli> "+++" changes that do not need to be in the manuals, because that
>     Eli> sends the wrong signal.
> So in this case weʼd use '---'.


> Itʼs all clear to me now, but youʼre right that perhaps a different
> wording would be better (of course it could just be a problem in my
> brain :-) )

If you can suggest a better wording, please do.  One possible way is
to simply remove the reference to the doc strings, as they are not
relevant to the job these markers should do (doc strings should be
adjusted as part of any change).

reply via email to

[Prev in Thread] Current Thread [Next in Thread]