# HG changeset patch
# User Glenn Morris <rgm@gnu.org>
# Date 1196311277 0
# Node ID 9b003519e0dde790c8a55795fc1e9c3499e69348
# Parent  d7f423869e2364179b954eba8f7d1e04eda97468
(Declaring Functions): Add findex.  Mention `external' files.

diff -r d7f423869e23 -r 9b003519e0dd doc/lispref/functions.texi
--- a/doc/lispref/functions.texi	Thu Nov 29 04:41:07 2007 +0000
+++ b/doc/lispref/functions.texi	Thu Nov 29 04:41:17 2007 +0000
@@ -1227,6 +1227,7 @@
 @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 @@
 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