diff src/fns.c @ 3794:73288faa5759

[xemacs-hg @ 2007-01-20 16:57:05 by aidan] Fill out docstrings fo `function,' `quote' and `require.'
author aidan
date Sat, 20 Jan 2007 16:57:06 +0000
parents facf3239ba30
children 1c2a46ea1f78
line wrap: on
line diff
--- a/src/fns.c	Fri Jan 19 22:51:02 2007 +0000
+++ b/src/fns.c	Sat Jan 20 16:57:06 2007 +0000
@@ -3582,6 +3582,13 @@
 If FILENAME is omitted, the printname of FEATURE is used as the file name.
 If optional third argument NOERROR is non-nil, then return nil if the file
 is not found instead of signaling an error.
+Normally the return value is FEATURE.
+The normal messages at start and end of loading FILENAME are suppressed.
+
+In order to make it possible for a required package to provide macros to be
+expanded at byte-compilation time, top level calls of `require' are
+evaluated both at byte-compile time and at run time.  That is, any top-level
+call to `require' is wrapped in an implicit \(eval-and-compile ...\) block.
 */
        (feature, filename, noerror))
 {