From: drh <drh@noemail.net>
Date: Sat, 28 Jan 2017 15:26:14 +0000 (+0000)
Subject: Updates to the sqlite3_blob documentation.  No changes to code.
X-Git-Tag: version-3.17.0~58
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6034d476186cda5b18f6003b8c3f66cb0e216d16;p=thirdparty%2Fsqlite.git

Updates to the sqlite3_blob documentation.  No changes to code.

FossilOrigin-Name: 426b440a5745f9c431c6a3d9ba542af61a6a83fb
---

diff --git a/manifest b/manifest
index 3e4c3fcfe4..6c861e5ee0 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C In\sthe\sspeed-check.sh\sscript,\sautomatically\sinvoke\s"fossil\stest-diff\s--tk"\son\nthe\scachegrind\soutput\sagainst\strunk,\sif\snot\sgenerating\sa\strunk\srun.
-D 2017-01-28T13:40:55.453
+C Updates\sto\sthe\ssqlite3_blob\sdocumentation.\s\sNo\schanges\sto\scode.
+D 2017-01-28T15:26:14.397
 F Makefile.in 5f415e7867296d678fed2e6779aea10c1318b4bc
 F Makefile.linux-gcc 7bc79876b875010e8c8f9502eb935ca92aa3c434
 F Makefile.msc b8ca53350ae545e3562403d5da2a69cec79308da
@@ -393,7 +393,7 @@ F src/resolve.c f9bc0de45a30a450da47b3766de00be89bf9be79
 F src/rowset.c 7b7e7e479212e65b723bf40128c7b36dc5afdfac
 F src/select.c 3856db523b942062bca8722ba03b61c324ff94d6
 F src/shell.c a84e453c213f3e0d6935a582024da4e242f85a19
-F src/sqlite.h.in eefd49aa3aae3b4acd7d7e2f8f9b0db8ae0aff3b
+F src/sqlite.h.in a14cd1f946b9565c4d801c4adeeaa4543fbd6eb4
 F src/sqlite3.rc 5121c9e10c3964d5755191c80dd1180c122fc3a8
 F src/sqlite3ext.h 8648034aa702469afb553231677306cc6492a1ae
 F src/sqliteInt.h 341ce9e5b0397771fa6bd9dadb8ef4cbbd6224d0
@@ -1548,7 +1548,7 @@ F vsixtest/vsixtest.tcl 6a9a6ab600c25a91a7acc6293828957a386a8a93
 F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
 F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
 F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P 7c029655cc3369a1e46741fdd3701d36d420b28b
-R e044c4e027113b10098b21316c3901f3
+P aa1ab37100a91ab4bb91d50a1267c26967efcb21
+R e94128da2458d76e1f9232d83fbb5c60
 U drh
-Z 82ae1e57a20d4dbe9187373cc6493ae1
+Z 85ea4b53c0f0f74a70744dcf483d3a5b
diff --git a/manifest.uuid b/manifest.uuid
index fc7ceb70f4..6d893bf0fe 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-aa1ab37100a91ab4bb91d50a1267c26967efcb21
\ No newline at end of file
+426b440a5745f9c431c6a3d9ba542af61a6a83fb
\ No newline at end of file
diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index 0bf386f72a..d80de6d519 100644
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -6199,6 +6199,12 @@ typedef struct sqlite3_blob sqlite3_blob;
 ** [database connection] error code and message accessible via 
 ** [sqlite3_errcode()] and [sqlite3_errmsg()] and related functions. 
 **
+** A BLOB referenced by sqlite3_blob_open() and be read using the
+** [sqlite3_blob_read()] interface and modified by using
+** [sqlite3_blob_write()].  The [BLOB handle] can be moved to a
+** different row of the same table using the [sqlite3_blob_reopen()]
+** interface.  However, the column, table, or database of a [BLOB handle]
+** cannot be changed once after the [BLOB handle] is opened.
 **
 ** ^(If the row that a BLOB handle points to is modified by an
 ** [UPDATE], [DELETE], or by [ON CONFLICT] side-effects
@@ -6222,6 +6228,10 @@ typedef struct sqlite3_blob sqlite3_blob;
 **
 ** To avoid a resource leak, every open [BLOB handle] should eventually
 ** be released by a call to [sqlite3_blob_close()].
+**
+** See also: [sqlite3_blob_close()],
+** [sqlite3_blob_reopen()], [sqlite3_blob_read()],
+** [sqlite3_blob_bytes()], [sqlite3_blob_write()].
 */
 int sqlite3_blob_open(
   sqlite3*,
@@ -6237,11 +6247,11 @@ int sqlite3_blob_open(
 ** CAPI3REF: Move a BLOB Handle to a New Row
 ** METHOD: sqlite3_blob
 **
-** ^This function is used to move an existing blob handle so that it points
+** ^This function is used to move an existing [BLOB handle] so that it points
 ** to a different row of the same database table. ^The new row is identified
 ** by the rowid value passed as the second argument. Only the row can be
 ** changed. ^The database, table and column on which the blob handle is open
-** remain the same. Moving an existing blob handle to a new row can be
+** remain the same. Moving an existing [BLOB handle] to a new row is
 ** faster than closing the existing handle and opening a new one.
 **
 ** ^(The new row must meet the same criteria as for [sqlite3_blob_open()] -