From: drh <drh@noemail.net>
Date: Thu, 13 Jul 2017 22:03:34 +0000 (+0000)
Subject: Improvements to the documentation for SQLITE_PREPARE_PERSISTENT.
X-Git-Tag: version-3.20.0~59
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4ba5f33f394c1cfef8de2647680c002c6aaa0d81;p=thirdparty%2Fsqlite.git

Improvements to the documentation for SQLITE_PREPARE_PERSISTENT.
No code changes.

FossilOrigin-Name: 265778142485882f39edfb5756175b2675c1993f0d6395dabbcbbb3767c6ec77
---

diff --git a/manifest b/manifest
index 64e27f7d66..7fb0de7f93 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Fix\sdocumentation\stypo.\s\sNo\schanges\sto\scode.
-D 2017-07-13T20:11:52.585
+C Improvements\sto\sthe\sdocumentation\sfor\sSQLITE_PREPARE_PERSISTENT.\nNo\scode\schanges.
+D 2017-07-13T22:03:34.848
 F Makefile.in 081e48dfe7f995d57ce1a88ddf4d2917b4349158648a6cd45b42beae30de3a12
 F Makefile.linux-gcc 7bc79876b875010e8c8f9502eb935ca92aa3c434
 F Makefile.msc 20850e3e8d4d4791e0531955852d768eb06f24138214870d543abb1a47346fba
@@ -452,7 +452,7 @@ F src/rowset.c 7b7e7e479212e65b723bf40128c7b36dc5afdfac
 F src/select.c 95659b7990e390f9bd8dc30b8975c675fcd1d46e569bc4f5a14e22a8d03e3d14
 F src/shell.c 0401a716fc5343594b8ee60ce065d9a71373d3403f0b81f9fed684741e6401d1
 F src/shell.c.in 98bfdeeb0808418b37f59e6d380568a76e0733efe2494377096f434b39940cad
-F src/sqlite.h.in 866a8521a0d0f0ea7329d64739947fb9414f4a29afcd6193bca2ae21474bbd71
+F src/sqlite.h.in 340e8cfb0c7a04107dc4c587bdbe03376134c0ab64e26b1ae75b6aaea9f90252
 F src/sqlite3.rc 5121c9e10c3964d5755191c80dd1180c122fc3a8
 F src/sqlite3ext.h 654d76dd288780a460be9c88edc6a5eb2d61df03a7153c92f1d87aba41f73b96
 F src/sqliteInt.h 0ba730cdc8afa723a5642380712f8bb33abd6a69218571c18b94acf3562de22a
@@ -1631,7 +1631,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 55f5396576d186f310cb0fa66fbdb8ea68c18a3d0fe5de4b395ea03c7aa04c9e
-R 5464e40ca58b20c3d11d86b4fa25750e
+P 9319f7b71f68c9dc64c22c60b90650955b72f6bd9852d5ea86fa96a5c6fede37
+R 0c1cbac243532940e0fec5e42d3685f0
 U drh
-Z a43ae0a917fdf05a2658256c6ea2fd1c
+Z 0a54df107527e8a216f4daa22e976e46
diff --git a/manifest.uuid b/manifest.uuid
index ea2046c36c..f88123f7c1 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-9319f7b71f68c9dc64c22c60b90650955b72f6bd9852d5ea86fa96a5c6fede37
\ No newline at end of file
+265778142485882f39edfb5756175b2675c1993f0d6395dabbcbbb3767c6ec77
\ No newline at end of file
diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index bb7c69240d..530312aa47 100644
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -3492,13 +3492,15 @@ int sqlite3_limit(sqlite3*, int id, int newVal);
 **
 ** <dl>
 ** [[SQLITE_PREPARE_PERSISTENT]] ^(<dt>SQLITE_PREPARE_PERSISTENT</dt>
-** <dd>The SQLITE_PREPARE_PERSISTENT flag causes [sqlite3_prepare_v3()]
-** and [sqlite3_prepare16_v3()]
-** to optimize the resulting prepared statement to be retained for a 
-** relatively long amount of time.)^  ^Without this flag,
-** [sqlite3_prepare_v3()] and [sqlite3_prepare16_v3()] assume that
-** the prepared statement will be used just once or at most a few times
-** and then destroyed using [sqlite3_finalize()] relatively soon.
+** <dd>The SQLITE_PREPARE_PERSISTENT flag is a hint to the query planner
+** that the prepared statement will be retained for a long time and
+** probably reused many times. ^Without this flag, [sqlite3_prepare_v3()]
+** and [sqlite3_prepare16_v3()] assume that the prepared statement will 
+** be used just once or at most a few times and then destroyed using
+** [sqlite3_finalize()] relatively soon. The current implementation acts
+** on this hint by avoiding the use of [lookaside memory] so as not to
+** deplete the limited store of lookaside memory. Future versions of
+** SQLite may act on this hint differently.
 ** </dl>
 */
 #define SQLITE_PREPARE_PERSISTENT              0x01