Variable: byte-compile-dynamic-docstrings

byte-compile-dynamic-docstrings is a customizable variable defined in bytecomp.el.gz.

Value

t

Documentation

If non-nil, compile doc strings for lazy access.

We bury the doc strings of functions and variables inside comments in the file, and bring them into core only when they are actually needed.

When this option is true, if you load the compiled file and then move it, you won't be able to find the documentation of anything in that file.

To disable this option for a certain file, make it a file-local variable in the source file. For example, add this to the first line:
  -*-byte-compile-dynamic-docstrings:nil;-*-
You can also set the variable globally.

This option is enabled by default because it reduces Emacs memory usage.

View in manual

Probably introduced at or before Emacs version 19.29.

Source Code

;; Defined in /usr/src/emacs/lisp/emacs-lisp/bytecomp.el.gz
;;;###autoload(put 'byte-compile-dynamic 'safe-local-variable 'booleanp)

(defcustom byte-compile-dynamic-docstrings t
  "If non-nil, compile doc strings for lazy access.
We bury the doc strings of functions and variables inside comments in
the file, and bring them into core only when they are actually needed.

When this option is true, if you load the compiled file and then move it,
you won't be able to find the documentation of anything in that file.

To disable this option for a certain file, make it a file-local variable
in the source file.  For example, add this to the first line:
  -*-byte-compile-dynamic-docstrings:nil;-*-
You can also set the variable globally.

This option is enabled by default because it reduces Emacs memory usage."
  :type 'boolean)