Index: src/sqlite.h.in
==================================================================
--- src/sqlite.h.in
+++ src/sqlite.h.in
@@ -41,11 +41,11 @@
 ** The requirement consists of all text up through the next
 ** {...} mark or until the end of the comment.  Text following
 ** {EX} is an explanatory amplification of the preceding requirement.
 ** Both the {EX} and the {END} are optional.
 **
-** @(#) $Id: sqlite.h.in,v 1.273 2007/12/01 19:23:20 drh Exp $
+** @(#) $Id: sqlite.h.in,v 1.274 2007/12/04 13:22:44 drh Exp $
 */
 #ifndef _SQLITE3_H_
 #define _SQLITE3_H_
 #include <stdarg.h>     /* Needed for the definition of va_list */
 
@@ -3307,10 +3307,20 @@
 
 /*
 ** CAPI3REF:  Close A BLOB Handle
 **
 ** Close an open [sqlite3_blob | blob handle].
+**
+** Closing a BLOB might cause the current transaction to commit.
+** If any writes were made to the BLOB, they might be held in cache
+** until the close operation.  Closing the BLOB forces the changes
+** out to disk and so if any I/O errors occur, they will likely occur
+** at the time when the BLOB is closed.  Any errors that occur during
+** closing are reported as a non-zero return value.
+**
+** The BLOB is closed unconditionally.  Even if this routine returns
+** an error code, the BLOB is still closed.
 */
 int sqlite3_blob_close(sqlite3_blob *);
 
 /*
 ** CAPI3REF:  Return The Size Of An Open BLOB