From: dan <Dan Kennedy>
Date: Wed, 2 Oct 2024 11:11:00 +0000 (+0000)
Subject: Update docs for sqlite3_snapshot_get().
X-Git-Tag: version-3.47.0~73^2~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=f9d1141a3b34e36cf26be87dbd199b036985b2d6;p=thirdparty%2Fsqlite.git

Update docs for sqlite3_snapshot_get().

FossilOrigin-Name: 78c3892ab777a39406da8a9df84d0634397514e25512b0363a13bff3b8bc8925
---

diff --git a/manifest b/manifest
index 83d6936a7d..7342f3b4a1 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C When\spossible,\savoid\staking\swal\sfile\sread-lock\s0\sin\ssqlite3_snapshot_get().
-D 2024-09-26T18:02:17.495
+C Update\sdocs\sfor\ssqlite3_snapshot_get().
+D 2024-10-02T11:11:00.069
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
 F LICENSE.md df5091916dbb40e6e9686186587125e1b2ff51f022cc334e886c19a0e9982724
@@ -769,7 +769,7 @@ F src/resolve.c 9750a281f7ba073b4e6da2be1a6c4071f5d841a7746c5fb3f70d6d793b6675ea
 F src/rowset.c 8432130e6c344b3401a8874c3cb49fefe6873fec593294de077afea2dce5ec97
 F src/select.c 4b14337a2742f0c0beeba490e9a05507e9b4b12184b9cd12773501d08d48e3fe
 F src/shell.c.in 9b68a945f3aafc78eac1a256a4a588a9310dbc61a0cd60378c5b7a78f789af50
-F src/sqlite.h.in 77f55bd1978a04a14db211732f0a609077cf60ba4ccf9baf39988f508945419c
+F src/sqlite.h.in 496f927cf2a687f313c6ac41c03e46f45c8f91c84d8f3ff6607aa9f2794e2ec3
 F src/sqlite3.rc 5121c9e10c3964d5755191c80dd1180c122fc3a8
 F src/sqlite3ext.h 3f046c04ea3595d6bfda99b781926b17e672fd6d27da2ba6d8d8fc39981dcb54
 F src/sqliteInt.h 5978cbb11becc3ce6471015d770d95f694ece06336c496f691df1b02460e9cd5
@@ -2213,11 +2213,8 @@ F vsixtest/vsixtest.tcl 6195aba1f12a5e10efc2b8c0009532167be5e301abe5b31385638080
 F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
 F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
 F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P 9592b9ba3ad7a842cdd4c4010da278485a6fdec7e811bda01ebe640162a8c3b6
-R 8553e4183ac33940fe95918021cfe535
-T *branch * snapshot_get-locking
-T *sym-snapshot_get-locking *
-T -sym-trunk *
+P 34b6ac3d76dbc6819778ec2a0f81cbcdcc0cd1a6303381d97f1c479e4ecdd132
+R a30055f90af028e040102b1e9655fa8f
 U dan
-Z 2b5e37766517d26ed8f4d4495c7d929b
+Z 068c609e961149f2eac59f5d7b1ce4b0
 # Remove this line to create a well-formed Fossil manifest.
diff --git a/manifest.uuid b/manifest.uuid
index 986575a33e..00ceed77c8 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-34b6ac3d76dbc6819778ec2a0f81cbcdcc0cd1a6303381d97f1c479e4ecdd132
+78c3892ab777a39406da8a9df84d0634397514e25512b0363a13bff3b8bc8925
diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index 5546793c94..013be20371 100644
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -10539,6 +10539,14 @@ typedef struct sqlite3_snapshot {
 ** If there is not already a read-transaction open on schema S when
 ** this function is called, one is opened automatically.
 **
+** If a read-transaction is opened by this function, then it is guaranteed 
+** that the returned snapshot object may not be invalidated by a database 
+** writer or checkpointer until after the read-transaction is closed. This 
+** is not guaranteed if a read-transaction is already open when this 
+** function is called. In that case, any subsequent write or checkpoint 
+** operation on the database may invalidate the returned snapshot handle, 
+** even while the read-transaction remains open.
+**
 ** The following must be true for this function to succeed. If any of
 ** the following statements are false when sqlite3_snapshot_get() is
 ** called, SQLITE_ERROR is returned. The final value of *P is undefined