Variable: byte-compile-warnings

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

Value

t

Documentation

List of warnings that the byte-compiler should issue (t for almost all).

Elements of the list may be:

  free-vars references to variables not in the current lexical scope.
  unresolved calls to unknown functions.
  callargs function calls with args that don't match the definition.
  redefine function name redefined from a macro to ordinary function or vice
              versa, or redefined to take a different number of arguments.
  obsolete obsolete variables and functions.
  noruntime functions that may not be defined at runtime (typically
              defined only under eval-when-compile).
  interactive-only
commands that normally shouldn't be called from Lisp code.
  lexical global/dynamic variables lacking a prefix.
  lexical-dynamic
              lexically bound variable declared dynamic elsewhere
  make-local calls to make-variable-buffer-local that may be incorrect.
  mapcar mapcar called for effect.
  not-unused warning about using variables with symbol names starting with _.
  constants let-binding of, or assignment to, constants/nonvariables.
  docstrings docstrings that are too wide (longer than
              byte-compile-docstring-max-column or
              fill-column characters, whichever is bigger) or
              have other stylistic issues.
  docstrings-non-ascii-quotes docstrings that have non-ASCII quotes.
                              This depends on the docstrings warning type.
  suspicious constructs that usually don't do what the coder wanted.

If the list begins with not, then the remaining elements specify warnings to suppress. For example, (not mapcar) will suppress warnings about mapcar.

The t value means "all non experimental warning types", and excludes the types in byte-compile--emacs-build-warning-types. A value of all really means all.

Probably introduced at or before Emacs version 23.1.

Source Code

;; Defined in /usr/src/emacs/lisp/emacs-lisp/bytecomp.el.gz
(defcustom byte-compile-warnings t
  "List of warnings that the byte-compiler should issue (t for almost all).

Elements of the list may be:

  free-vars   references to variables not in the current lexical scope.
  unresolved  calls to unknown functions.
  callargs    function calls with args that don't match the definition.
  redefine    function name redefined from a macro to ordinary function or vice
              versa, or redefined to take a different number of arguments.
  obsolete    obsolete variables and functions.
  noruntime   functions that may not be defined at runtime (typically
              defined only under `eval-when-compile').
  interactive-only
	      commands that normally shouldn't be called from Lisp code.
  lexical     global/dynamic variables lacking a prefix.
  lexical-dynamic
              lexically bound variable declared dynamic elsewhere
  make-local  calls to `make-variable-buffer-local' that may be incorrect.
  mapcar      mapcar called for effect.
  not-unused  warning about using variables with symbol names starting with _.
  constants   let-binding of, or assignment to, constants/nonvariables.
  docstrings  docstrings that are too wide (longer than
              `byte-compile-docstring-max-column' or
              `fill-column' characters, whichever is bigger) or
              have other stylistic issues.
  docstrings-non-ascii-quotes docstrings that have non-ASCII quotes.
                              This depends on the `docstrings' warning type.
  suspicious  constructs that usually don't do what the coder wanted.

If the list begins with `not', then the remaining elements specify warnings to
suppress.  For example, (not mapcar) will suppress warnings about mapcar.

The t value means \"all non experimental warning types\", and
excludes the types in `byte-compile--emacs-build-warning-types'.
A value of `all' really means all."
  :type `(choice (const :tag "All" t)
		 (set :menu-tag "Some"
                      ,@(mapcar (lambda (x) `(const ,x))
                                byte-compile-warning-types))))