comparison doc/lispref/functions.texi @ 86826:9b003519e0dd

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

86825:d7f423869e23

@node Declaring Functions
@section Telling the Compiler that a Function is Defined
@cindex function declaration
@cindex declaring functions

Byte-compiling a file often produces warnings about functions that the
compiler doesn't know about (@pxref{Compiler Errors}).  Sometimes this
indicates a real problem, but usually the functions in question are
defined in other files which would be loaded if that code is run.  For

a file name ending in @samp{.c}.  @code{check-declare-file} looks for
these files in the C source code directory.  This is useful only when
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.

@node Function Safety
@section Determining whether a Function is Safe to Call
@cindex function safety
@cindex safety of functions

86826:9b003519e0dd

@node Declaring Functions
@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
indicates a real problem, but usually the functions in question are
defined in other files which would be loaded if that code is run.  For

a file name ending in @samp{.c}.  @code{check-declare-file} looks for
these files in the C source code directory.  This is useful only when
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
@cindex safety of functions