Document deprecation of hi-lock-mode's 'C-x w' bindings

* doc/emacs/display.texi (Highlight Interactively): Deprecate the
"C-x w" bindings of hi-lock-mode.

* etc/NEWS: Mark the deprecation entry as documented.

2 files changed, 5 insertions, 1 deletions

diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 1b75a15427c..e3b24033a1a 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -924,7 +924,10 @@ mode for all buffers, use @kbd{M-x global-hi-lock-mode} or place
 
   Hi Lock mode works like Font Lock mode (@pxref{Font Lock}), except
 that you specify explicitly the regular expressions to highlight.  You
-control them with these commands:
+control them with the commands described below.  (The key bindings
+below that begin with @kbd{C-x w} are deprecated in favor of the
+global @kbd{M-s h} bindings, and will be removed in some future Emacs
+version.)
 
 @table @kbd
 @item M-s h r @var{regexp} @key{RET} @var{face} @key{RET}
diff --git a/etc/NEWS b/etc/NEWS
index 4eec4a6642f..f4ea3a05ab2 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -321,6 +321,7 @@ default.
 unsaved customizations and prompts user to customize (if found).  It
 is intended for adding to 'kill-emacs-query-functions'.
 
++++
 ** The old `C-x w' bindings in hi-lock-mode are officially deprecated
 in favor of the global `M-s h' bindings introduced in Emacs-23.1.
 They'll disappear soon.