Variable: documentation-dynamic-reload

documentation-dynamic-reload is a variable defined in doc.c.

Value

t

Documentation

If non-nil, reload changed DOC and Lisp files when calling documentation.

For etc/DOC and for files byte-compiled with non-nil byte-compile-dynamic-docstring (the default), documentation strings are loaded on-demand only when documentation is called for a symbol.

If these files have changed since they were initially loaded, reading the documentation string for that symbol out of the files may fail. If it fails, and this variable is non-nil, then the files will be loaded again to redefine all its functions and variables. documentation will then retry; if the symbol was redefined by reloading the file, reading the documentation string will then succeed.

Source Code

// Defined in /usr/src/emacs/src/doc.c
  DEFVAR_BOOL ("documentation-dynamic-reload", documentation_dynamic_reload,
	       doc: /* If non-nil, reload changed `DOC' and Lisp files when calling `documentation'.

For `etc/DOC' and for files byte-compiled with non-nil
`byte-compile-dynamic-docstring' (the default), documentation strings
are loaded on-demand only when `documentation' is called for a symbol.

If these files have changed since they were initially loaded, reading
the documentation string for that symbol out of the files may fail.  If
it fails, and this variable is non-nil, then the files will be loaded
again to redefine all its functions and variables.  `documentation' will
then retry; if the symbol was redefined by reloading the file, reading
the documentation string will then succeed.  */);