bug#23520: 25.0.93; find-feature-regexp : mismatch between docstring and default value.

[Nicolas Richard]

Here's the current definition of find-feature-regexp :

(defcustom find-feature-regexp
  (concat ";;; Code:")
  "The regexp used by `xref-find-definitions' when searching for a feature 
definition.
Note it must contain a `%s' at the place where `format'
should insert the feature name."
  ;; We search for ";;; Code" rather than (feature '%s) because the
  ;; former is near the start of the code, and the latter is very
  ;; uninteresting. If the regexp is not found, just goes to
  ;; (point-min), which is acceptable in this case.
  :type 'regexp
  :group 'xref
  :version "25.0")

The comment explains why there is no "%s" in the default value, but when
doing C-h v find-feature-regexp RET, it's puzzling to read "must contain
%s" and then the default value doesn't actually contain "%s".


In GNU Emacs 25.0.93.1 (i686-pc-linux-gnu, X toolkit, Xaw scroll bars)
 of 2016-05-03 built on Aurora
Repository revision: c6077bfd297a8a0e4deaec217db17be630d98b9c
Windowing system distributor 'The X.Org Foundation', version 11.0.11702000
System Description:     Ubuntu 15.10