1 files changed, 10 insertions, 9 deletions

diff --git a/etc/NEWS b/etc/NEWS
index 125457c609b..728c3f1bace 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -247,21 +247,22 @@ supplied error message.
 +++
 ** ElDoc
 
-*** New hook 'eldoc-documentation-functions' to be used for
-registering doc string functions.  These functions don't need to
-produce the doc string right away, they may arrange for it to be
-produced asynchronously.  The results of all doc string functions
-accessible to the user through the existing single function hook
-'eldoc-documentation-strategy.
-
-*** New user option 'eldoc-documentation-strategy'
+*** New hook 'eldoc-documentation-functions'.
+This hook is intended to be used for registering doc string functions.
+These functions don't need to produce the doc string right away, they
+may arrange for it to be produced asynchronously.  The results of all
+doc string functions accessible to the user through the existing
+single function hook 'eldoc-documentation-strategy'.
+
+*** New user option 'eldoc-documentation-strategy'.
 The built-in choices available for this user option let users compose
 the results of 'eldoc-documentation-functions' in various ways, even
 if some of those functions are sychronous and some asynchchronous.
 The user option replaces 'eldoc-documentation-function', which is now
 obsolete.
 
-*** The user option 'eldoc-echo-area-use-multiline-p' is now handled
+*** 'eldoc-echo-area-use-multiline-p' is now handled by ElDoc.
+The user option 'eldoc-echo-area-use-multiline-p' is now handled
 by the Eldoc library itself.  Functions in
 'eldoc-documentation-functions' don't need to worry about consulting
 it when producing a doc string.