procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

(declare-function): Moved from byte-run.el.

Browse source
This commit is contained in:
Richard M. Stallman 2007-12-03 00:33:35 +00:00
parent e9fa6d0a4c
commit 708bb6f884
2 changed files with 40 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
lisp/ChangeLog
View file

@ -1,5 +1,9 @@
2007-12-03 Richard Stallman <rms@gnu.org>
* subr.el (declare-function): Moved from byte-run.el.
* emacs-lisp/byte-run.el (declare-function): Moved to subr.el
* window.el (recenter-top-bottom): Don't use `ecase'.
2007-12-02 Karl Fogel <kfogel@red-bean.com>

36
lisp/subr.el
View file

@ -36,6 +36,42 @@ Each element of this list holds the arguments to one call to `defcustom'.")
(setq custom-declare-variable-list
(cons arguments custom-declare-variable-list)))
(defmacro declare-function (fn file &optional arglist fileonly)
"Tell the byte-compiler that function FN is defined, in FILE.
Optional ARGLIST is the argument list used by the function. The
FILE argument is not used by the byte-compiler, but by the
`check-declare' package, which checks that FILE contains a
definition for FN. ARGLIST is used by both the byte-compiler and
`check-declare' to check for consistency.
FILE can be either a Lisp file (in which case the \".el\"
extension is optional), or a C file. C files are expanded
relative to the Emacs \"src/\" directory. Lisp files are
searched for using `locate-library', and if that fails they are
expanded relative to the location of the file containing the
declaration. A FILE with an \"ext:\" prefix is an external file.
`check-declare' will check such files if they are found, and skip
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
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:
\(declare-function c-end-of-defun \"progmodes/cc-cmds.el\"
\(&optional arg))
For more information, see Info node `elisp(Declaring Functions)'."
;; Does nothing - byte-compile-declare-function does the work.
nil)
;;;; Basic Lisp macros.