Improvements to the documentation for SQLITE_PREPARE_PERSISTENT.

No code changes.

FossilOrigin-Name: 265778142485882f39edfb5756175b2675c1993f0d6395dabbcbbb3767c6ec77

diff --git a/manifest b/manifest
index 64e27f7d66cf322051364f905fa4e8202a303bf6..7fb0de7f93caf542a5c65f41278370e8d6e8230b 100644 (file)
--- 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 ea2046c36ca6bda702f0f4c2e40996d7a7e0c39f..f88123f7c15faf141ebf874d4f7e3663cca3cf24 100644 (file)
--- 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 bb7c69240d6c39601bf306fd0d9da27f2c05fd52..530312aa47e9fc6818ec69436e4c047b0e88544a 100644 (file)
--- 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