(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'

has to be used when this variable is changed; it doesn't work to
reinitialize the mode since that typically clobbers the variable.

diff --git a/lisp/progmodes/cc-vars.el b/lisp/progmodes/cc-vars.el
index 5ea6ad89a70d78016d7889cfc98eac00034afa65..0485bf3332f9f129d8c57bf5a3e79d6fdbb96fee 100644 (file)
--- a/lisp/progmodes/cc-vars.el
+++ b/lisp/progmodes/cc-vars.el
@@ -493,13 +493,13 @@ Note that CC Mode uses this variable to set many other variables that
 handle the paragraph filling.  That's done at mode initialization or
 when you switch to a style which sets this variable.  Thus, if you
 change it in some other way, e.g. interactively in a CC Mode buffer,
-you will need to do \\[c-mode] (or whatever mode you're currently
-using) to reinitialize.
+you will need to do \\[c-setup-paragraph-variables] afterwards so that
+the other variables are updated with the new value.
 
-Note also that when CC Mode starts up, the other variables are
-modified before the mode hooks are run.  If you change this variable
-in a mode hook, you can call `c-setup-paragraph-variables' afterwards
-to redo it."
+Note also that when CC Mode starts up, all variables are initialized
+before the mode hooks are run.  It's therefore necessary to make a
+call to `c-setup-paragraph-variables' explicitly if you change this
+variable in a mode hook."
   :type '(radio
          (regexp :tag "Regexp for all modes")
          (list