Re: The next releases

[Glenn Morris <rgm@gnu.org>]

My general comment is: never hesitate to make a NEWS entry.
Not giving it any +++/--- markup means someone will check it.

Ted Zlatanov wrote:

> +---
> +** Emacs now detects and uses GnuTLS v3 features

Quibbling about language, but I'd say something like:

  ** Emacs now uses GnuTLS v3 features where available.

But as a user, this tells me nothing, so I'm not sure I see the point of
this entry as it stands.

>  +++
> +** Emacs can now reject invalid SSL/TLS certificates, as determined by
> +GnuTLS The new variable `gnutls-verify-error' can be customized.  It
> +is off for now, but will be turned to reject invalid certificates by
> +default in the future.

[If this is a new option, it should have a :version tag.]

** New option `gnutls-verify-error', if non-nil, means that Emacs
should reject SSL/TLS certificates that GnuTLS determines as invalid.  
(This option defaults to nil at present, but this is expected to change
in a future release.)

> +
> ++++
>  ** Emacs now supports menus on text-mode terminals.

Did you mean to add that markup? It seems an unrelated change.

> +** CFEngine mode

It seems redundant to say "CFEngine mode..." in all the following, given
that the whole section is about CFEngine mode.

> +
> +*** CFEngine mode has completion and ElDoc support
[...]
> +*** CFEngine mode has Flycheck support for on-the-fly syntax checking

*** Support for completion, ElDoc, and Flycheck has been added.

> +*** CFEngine mode can parse the current syntax from cf-promises

I have no idea what that means, but I'm not a CFEngine user, so that may
be expected.

> ++++
> +*** `describe-package' buffer uses the `:keywords extra property to
> +display keyword buttons.  Clicking them shows the list of packages
> +that have that keyword.

*** In the buffer produced by `describe-package', there are now buttons
listing the keywords related to that package.  You can click on them
to see other packages related to any given keyword.

> ++++
> +*** the list of packages now shows the archive

*** The output of `list-packages' now includes the archive providing
each package.

[Though this will be self-evident, so I'm not sure it is worth
mentioning.]

> ++++
> +*** the list of packages can now be filtered by a keyword

I don't understand what this really means. The wording makes me think
it's somehow related to the list-packages command, but it does not seem
to be.


Second general comment is that NEWS entries should be grammatical: start
with a capital, end with a full-stop.