bug#11647: 24.1; Document return value of load-source-file-function

[Christopher Schmidt]

=== modified file 'src/ChangeLog'
--- src/ChangeLog       2012-06-07 05:11:51 +0000
+++ src/ChangeLog       2012-06-08 01:42:27 +0000
@@ -1,3 +1,8 @@
+2012-06-08  Christopher Schmidt  <christopher@ch.ristopher.com>
+
+       * lread.c (syms_of_lread): Document return value of
+       load-source-file-function.
+
 2012-06-07  Paul Eggert  <eggert@cs.ucla.edu>
 
        * doprnt.c (doprnt): Truncate multibyte char correctly.

=== modified file 'src/lread.c'
--- src/lread.c 2012-05-30 03:59:42 +0000
+++ src/lread.c 2012-06-08 01:53:34 +0000
@@ -4508,7 +4508,8 @@
 
   DEFVAR_LISP ("load-source-file-function", Vload_source_file_function,
               doc: /* Function called in `load' for loading an Emacs Lisp 
source file.
-This function is for doing code conversion before reading the source file.
+This function is for doing code conversion before reading the source
+file.  It should return t if the file exists and loads successfully.
 If nil, loading is done without any code conversion.
 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
  FULLNAME is the full name of FILE.

Unfortunately I cannot get the trunk to build so the patch is untested.
It's just a doc fix, though.

        Christopher