Update the documentation to state that any parameter that is optimized out

of a prepared statement becomes an anonymous parameter for which
sqlite3_bind_parameter_name() returns NULL.

FossilOrigin-Name: 701b8a23e3ea2c94454af5d9bd1e72acb66d0fe2

diff --git a/manifest b/manifest
index b9205ae2bb05bc7a17053bfe035a0138099dc7eb..f7cee8fa4c2d00d4e831202d42c77abb7df1a927 100644 (file)
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Minor\sperformance\simprovements.
-D 2011-05-30T23:42:16.233
+C Update\sthe\sdocumentation\sto\sstate\sthat\sany\sparameter\sthat\sis\soptimized\sout\nof\sa\sprepared\sstatement\sbecomes\san\sanonymous\sparameter\sfor\swhich\nsqlite3_bind_parameter_name()\sreturns\sNULL.
+D 2011-05-31T11:56:15.040
 F Makefile.arm-wince-mingw32ce-gcc d6df77f1f48d690bd73162294bbba7f59507c72f
 F Makefile.in 11dcc00a8d0e5202def00e81732784fb0cc4fe1d
 F Makefile.linux-gcc 91d710bdc4998cb015f39edf3cb314ec4f4d7e23
@@ -179,7 +179,7 @@ F src/resolve.c 1c0f32b64f8e3f555fe1f732f9d6f501a7f05706
 F src/rowset.c 69afa95a97c524ba6faf3805e717b5b7ae85a697
 F src/select.c d9d440809025a58547e39f4f268c2a296bfb56ff
 F src/shell.c decd04236a7ef26be5ef46d4ea963044bfad9a48
-F src/sqlite.h.in 91c63a69eeddbd62182ec00dbfee390016972bdb
+F src/sqlite.h.in c095996e68e0082f674f32e68ca909fc24196a2a
 F src/sqlite3ext.h c90bd5507099f62043832d73f6425d8d5c5da754
 F src/sqliteInt.h d9ff5f198b5bac7ee0c6e1ea55f76897ba4dda87
 F src/sqliteLimit.h 164b0e6749d31e0daa1a4589a169d31c0dec7b3d
@@ -938,7 +938,7 @@ F tool/speedtest8.c 2902c46588c40b55661e471d7a86e4dd71a18224
 F tool/speedtest8inst1.c 293327bc76823f473684d589a8160bde1f52c14e
 F tool/split-sqlite3c.tcl d9be87f1c340285a3e081eb19b4a247981ed290c
 F tool/vdbe-compress.tcl d70ea6d8a19e3571d7ab8c9b75cba86d1173ff0f
-P 1bab03c4811b5e5b3d15632bc2a3844891f9fad7
-R 7acb04adb38e3c88e3b1f83ed6f40a4e
+P f9950c6af1813f724dacd7455f472acec921b06a
+R f6b845f51167252cf7d20999b01d5085
 U drh
-Z 9e474b54141fcb6c3097a32384090f3c
+Z 659dc0a03ae6f4d76444e7107181eaaf

diff --git a/manifest.uuid b/manifest.uuid
index 58a05fb5399152422935c5010777d06c93d19976..6374f6392035fdd92da5184005d296afd56816e9 100644 (file)
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-f9950c6af1813f724dacd7455f472acec921b06a
\ No newline at end of file
+701b8a23e3ea2c94454af5d9bd1e72acb66d0fe2
\ No newline at end of file

diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index 445a247a19a80b346677142415fb1f34d1f4396f..a9d60e8a2d6349d83b19db1035027552297f5e22 100644 (file)
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -3068,6 +3068,8 @@ int sqlite3_bind_parameter_count(sqlite3_stmt*);
 ** is included as part of the name.)^
 ** ^Parameters of the form "?" without a following integer have no name
 ** and are referred to as "nameless" or "anonymous parameters".
+** ^Any parameter that is optimized out of the prepared statement by the 
+** query planner becomes a nameless or anonymous parameter.
 **
 ** ^The first host parameter has an index of 1, not 0.
 **