Re: The netsec thread

[Eli Zaretskii]

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

If this is your interpretation of what NEWS says, then we must modify
that text to be less ambiguous.  "+++" means the doc strings AND the
manuals have been updated, "---" means the doc string WITHOUT manuals
were updated.

These markers are there for when we are close to releasing a new major
version, and need to make sure everything that needs to be in the
manuals is in the manuals.  It therefore makes no sense to mark by
"+++" changes that do not need to be in the manuals, because that
sends the wrong signal.