Re: The netsec thread

[Robert Pluim]

>>>>> On Fri, 23 Aug 2019 17:15:53 +0300, Eli Zaretskii <address@hidden> said:

    >> From: Robert Pluim <address@hidden>
    >> Cc: address@hidden,  address@hidden
    >> Date: Fri, 23 Aug 2019 15:20:47 +0200
    >> 
    >> >>>>> On Fri, 23 Aug 2019 16:03:33 +0300, Eli Zaretskii <address@hidden> 
said:
    >> 
    Eli> If it is not in the manual, why is it marked "+++"?
    >> 
    >> NEWS says:
    >> 
    >> Temporary note:
    >> +++ indicates that all necessary documentation updates are complete.
    >> (This means all relevant manuals in doc/ AND lisp doc-strings.)
    >> 
    >> The doc-string is up to date => +++. Itʼs an obscure, hopefully
    >> never-to-be-used option, so I donʼt feel it needs to be in the manual
    >> (you yourself said something similar very recently about
    >> 'ispell-skip-html' :-) )

    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 :-) )

Robert