Handle customizations of reftex-include-file-commands

* reftex.texi (Multifile Documents): Document
reftex-include-file-commands.
(Options): Mention that non-customize changes might require
calling reftex-compile-variables.

* textmodes/reftex-vars.el (reftex-include-file-commands): Call
reftex-set-dirty on changes.

2 files changed, 17 insertions, 0 deletions

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index d04a8bbb083..448c7f26c1a 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,10 @@
+2015-02-25  Tassilo Horn  <tsdh@gnu.org>
+
+        * reftex.texi (Multifile Documents): Document
+        reftex-include-file-commands.
+        (Options): Mention that non-customize changes might require
+        calling reftex-compile-variables.
+
 2015-02-21  Paul Eggert  <eggert@cs.ucla.edu>
 
         * texinfo.tex: Update from gnulib.
diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi
index 567063f2c3b..facfb4376db 100644
--- a/doc/misc/reftex.texi
+++ b/doc/misc/reftex.texi
@@ -2961,6 +2961,12 @@ label itself in order to be processed correctly by @RefTeX{}.  The only
 exception is that section labels referring to a section statement
 outside the current file can still use that section title as
 context.
+
+@item
+@vindex reftex-include-file-commands
+@RefTeX{} knows about the @code{\include} and @code{\input} macros.
+In case you use different commands to include files in a multifile
+document, customize the variable @code{reftex-include-file-commands}.
 @end itemize
 
 @node Language Support
@@ -3893,6 +3899,10 @@ Lisp (and even if you are) you might find it more comfortable to use
 @code{customize} to look at and change these variables. @kbd{M-x
 reftex-customize} will get you there.
 
+In case you don't use the @code{customize} interface, here's a caveat:
+Changing (mostly parsing-related) options might require a call to
+@code{reftex-compile-variables} in order to become effective.
+
 @menu
 * Options - Table of Contents::
 * Options - Defining Label Environments::