1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-04 11:00:45 -08:00

(declare-function): Add optional fourth argument and document it.

This commit is contained in:
Glenn Morris 2007-11-30 07:44:24 +00:00
parent 393209d6fc
commit 7b58c351cf

View file

@ -103,7 +103,7 @@ The return value of this function is not used."
(eval-and-compile (eval-and-compile
(put ',name 'byte-optimizer 'byte-compile-inline-expand)))) (put ',name 'byte-optimizer 'byte-compile-inline-expand))))
(defmacro declare-function (fn file &optional arglist) (defmacro declare-function (fn file &optional arglist fileonly)
"Tell the byte-compiler that function FN is defined, in FILE. "Tell the byte-compiler that function FN is defined, in FILE.
Optional ARGLIST is the argument list used by the function. The Optional ARGLIST is the argument list used by the function. The
FILE argument is not used by the byte-compiler, but by the FILE argument is not used by the byte-compiler, but by the
@ -120,6 +120,15 @@ declaration. A FILE with an \"ext:\" prefix is an external file.
`check-declare' will check such files if they are found, and skip `check-declare' will check such files if they are found, and skip
them without error if they are not. them without error if they are not.
FILEONLY non-nil means that `check-declare' will only check that
FILE exists, not that it defines FN. This is intended for
function-definitions that `check-declare' does not recognize, e.g.
`defstruct'.
To specify a value for FILEONLY without passing an argument list,
set ARGLIST to `t'. This is necessary because `nil' means an
empty argument list, rather than an unspecified one.
Note that for the purposes of `check-declare', this statement Note that for the purposes of `check-declare', this statement
must be the first non-whitespace on a line, and everything up to must be the first non-whitespace on a line, and everything up to
the end of FILE must be all on the same line. For example: the end of FILE must be all on the same line. For example: