From: Glenn Morris <rgm@gnu.org>
Date: Thu, 29 Nov 2007 04:41:17 +0000 (+0000)
Subject: (Declaring Functions): Add findex.  Mention `external' files.
X-Git-Tag: emacs-pretest-23.0.90~9253
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c45400672ff7d5ab7df0a6dded2e35eb128b2f67;p=emacs.git

(Declaring Functions): Add findex.  Mention `external' files.
---

diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 182d26511b1..b6f209c16d2 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -1227,6 +1227,7 @@ following the definition, just like macros.
 @section Telling the Compiler that a Function is Defined
 @cindex function declaration
 @cindex declaring functions
+@findex declare-function
 
 Byte-compiling a file often produces warnings about functions that the
 compiler doesn't know about (@pxref{Compiler Errors}).  Sometimes this
@@ -1289,6 +1290,11 @@ you call a function that is defined only on certain systems.  Most
 of the primitive functions of Emacs are always defined so they will
 never give you a warning.
 
+  Sometimes a file will optionally use functions from an external package.
+If you prefix the filename in the @code{declare-function} statement with
+@samp{ext:}, then it will be checked if it is found, otherwise skipped
+without error.
+
 @node Function Safety
 @section Determining whether a Function is Safe to Call
 @cindex function safety