diff options
| -rw-r--r-- | lisp/emacs-lisp/byte-run.el | 37 |
1 files changed, 0 insertions, 37 deletions
diff --git a/lisp/emacs-lisp/byte-run.el b/lisp/emacs-lisp/byte-run.el index 6a5458df30f..267173c1713 100644 --- a/lisp/emacs-lisp/byte-run.el +++ b/lisp/emacs-lisp/byte-run.el | |||
| @@ -103,43 +103,6 @@ The return value of this function is not used." | |||
| 103 | (eval-and-compile | 103 | (eval-and-compile |
| 104 | (put ',name 'byte-optimizer 'byte-compile-inline-expand)))) | 104 | (put ',name 'byte-optimizer 'byte-compile-inline-expand)))) |
| 105 | 105 | ||
| 106 | (defmacro declare-function (fn file &optional arglist fileonly) | ||
| 107 | "Tell the byte-compiler that function FN is defined, in FILE. | ||
| 108 | Optional ARGLIST is the argument list used by the function. The | ||
| 109 | FILE argument is not used by the byte-compiler, but by the | ||
| 110 | `check-declare' package, which checks that FILE contains a | ||
| 111 | definition for FN. ARGLIST is used by both the byte-compiler and | ||
| 112 | `check-declare' to check for consistency. | ||
| 113 | |||
| 114 | FILE can be either a Lisp file (in which case the \".el\" | ||
| 115 | extension is optional), or a C file. C files are expanded | ||
| 116 | relative to the Emacs \"src/\" directory. Lisp files are | ||
| 117 | searched for using `locate-library', and if that fails they are | ||
| 118 | expanded relative to the location of the file containing the | ||
| 119 | declaration. A FILE with an \"ext:\" prefix is an external file. | ||
| 120 | `check-declare' will check such files if they are found, and skip | ||
| 121 | them without error if they are not. | ||
| 122 | |||
| 123 | FILEONLY non-nil means that `check-declare' will only check that | ||
| 124 | FILE exists, not that it defines FN. This is intended for | ||
| 125 | function-definitions that `check-declare' does not recognize, e.g. | ||
| 126 | `defstruct'. | ||
| 127 | |||
| 128 | To specify a value for FILEONLY without passing an argument list, | ||
| 129 | set ARGLIST to `t'. This is necessary because `nil' means an | ||
| 130 | empty argument list, rather than an unspecified one. | ||
| 131 | |||
| 132 | Note that for the purposes of `check-declare', this statement | ||
| 133 | must be the first non-whitespace on a line, and everything up to | ||
| 134 | the end of FILE must be all on the same line. For example: | ||
| 135 | |||
| 136 | \(declare-function c-end-of-defun \"progmodes/cc-cmds.el\" | ||
| 137 | \(&optional arg)) | ||
| 138 | |||
| 139 | For more information, see Info node `elisp(Declaring Functions)'." | ||
| 140 | ;; Does nothing - byte-compile-declare-function does the work. | ||
| 141 | nil) | ||
| 142 | |||
| 143 | (defun make-obsolete (obsolete-name current-name &optional when) | 106 | (defun make-obsolete (obsolete-name current-name &optional when) |
| 144 | "Make the byte-compiler warn that OBSOLETE-NAME is obsolete. | 107 | "Make the byte-compiler warn that OBSOLETE-NAME is obsolete. |
| 145 | The warning will say that CURRENT-NAME should be used instead. | 108 | The warning will say that CURRENT-NAME should be used instead. |