From: larrybr <larrybr@noemail.net>
Date: Wed, 19 Jan 2022 21:11:23 +0000 (+0000)
Subject: Initial help changes for .script (and enhanced .parameter)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=96b922020ce76ccb94b100ea4b02992dba3a55cf;p=thirdparty%2Fsqlite.git

Initial help changes for .script (and enhanced .parameter)

FossilOrigin-Name: a94ab403eb836d3fcb9710d22da5129f58db05d3be145bc77ce1c017761e7894
---

diff --git a/manifest b/manifest
index 01dc783a6f..56a8967ee0 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Fix\sa\stest\sresult\sfor\salterauth2.test\sdue\sto\sthe\srecent\sfix\sto\sauthorizer\ncalls\sfor\sALTER\sTABLE\sDROP\sCOLUMN.
-D 2022-01-19T18:31:43.542
+C Initial\shelp\schanges\sfor\s.script\s(and\senhanced\s.parameter)
+D 2022-01-19T21:11:23.464
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
 F LICENSE.md df5091916dbb40e6e9686186587125e1b2ff51f022cc334e886c19a0e9982724
@@ -552,7 +552,7 @@ F src/random.c 097dc8b31b8fba5a9aca1697aeb9fd82078ec91be734c16bffda620ced7ab83c
 F src/resolve.c 359bc0e445d427583d2ab6110433a5dc777f64a0ecdf8d24826d8b475233ead9
 F src/rowset.c ba9515a922af32abe1f7d39406b9d35730ed65efab9443dc5702693b60854c92
 F src/select.c a4a23a70f0a24a1103ac9698f6be181a6ec7ff6c19e03e8899c43cb6d2af09d6
-F src/shell.c.in 4690f216dc4da0c104a8fd9f9e12bec0483242e630324aa7a3ccd155922e346e
+F src/shell.c.in 89463e86281322630ff531bd6a44f4d53f939b336d879394bc7adfad20f6fb37
 F src/sqlite.h.in a5e0d6bd47e67aabf1475986d36bdcc7bfa9e06566790ebf8e3aa7fa551c9f99
 F src/sqlite3.rc 5121c9e10c3964d5755191c80dd1180c122fc3a8
 F src/sqlite3ext.h 01eb85e4f2759a5ee79c183f4b2877889d4ffdc49d27ae74529c9579e3c8c0ef
@@ -1938,8 +1938,8 @@ F vsixtest/vsixtest.tcl 6a9a6ab600c25a91a7acc6293828957a386a8a93
 F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
 F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
 F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P aca6c61d79215519fb006af19d9011029df68f195a4ce65aff7a1bf4e36efb94
-R 49af707cd669468ece46f1dd370b2f63
-U drh
-Z 256bb3763483caaf79af6f149c662bf0
+P e799a35f2bf85ce43b476738bfbd9b6b378bbf02fa0708dda0deba71dd37f608
+R 64292f6d5c9ab9e96ed89164c0ac1a9a
+U larrybr
+Z 69f6a83be4ba8df24b2fde157c9e5bc8
 # Remove this line to create a well-formed Fossil manifest.
diff --git a/manifest.uuid b/manifest.uuid
index 672d9b9c73..a81b853b32 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-e799a35f2bf85ce43b476738bfbd9b6b378bbf02fa0708dda0deba71dd37f608
\ No newline at end of file
+a94ab403eb836d3fcb9710d22da5129f58db05d3be145bc77ce1c017761e7894
\ No newline at end of file
diff --git a/src/shell.c.in b/src/shell.c.in
index c15d2e54d4..7a0eb785de 100644
--- a/src/shell.c.in
+++ b/src/shell.c.in
@@ -4138,12 +4138,16 @@ static const char *(azHelp[]) = {
   "     -e                    Send output to the system text editor",
   "     -x                    Send output as CSV to a spreadsheet",
   ".parameter CMD ...       Manage SQL parameter bindings",
-  "   clear                   Erase all bindings",
+  "   clear ?NAMES?           Erase some or all parameter bindings",
+  "   edit NAME               Use edit() to create or alter parameter NAME",
   "   init                    Initialize the TEMP table that holds bindings",
   "   list                    List the current parameter bindings",
-  "   set PARAMETER VALUE     Given SQL parameter PARAMETER a value of VALUE",
-  "                           PARAMETER should start with one of: $ : @ ?",
-  "   unset PARAMETER         Remove PARAMETER from the binding table",
+  "   load FILE ?NAMES?       Load some or all parameter bindings from FILE",
+  "   save FILE ?NAMES?       Save some or all parameter bindings into FILE",
+  "   set NAME VALUE          Give SQL parameter NAME a value of VALUE",
+  "                           NAME should start with one of: $ : @ ?, and the",
+  "                           value is space-joined, following argument list",
+  "   unset ?NAMES?           Remove named parameter(s) from the binding table",
   ".print STRING...         Print literal STRING",
 #ifndef SQLITE_OMIT_PROGRESS_CALLBACK
   ".progress N              Invoke progress handler after every N opcodes",
@@ -4171,6 +4175,18 @@ static const char *(azHelp[]) = {
   "   Options:",
   "      --indent             Try to pretty-print the schema",
   "      --nosys              Omit objects whose names start with \"sqlite_\"",
+  ".script CMD ...            Manage SQL statement store",
+  "   clear ?NAMES?           Erase some or all stored SQL statements",
+  "   edit NAME               Use edit() to create or alter statement NAME",
+  "   execute ?NAMES?         Execute the named SQL statements in order",
+  "   init                    Initialize the TEMP table that holds statements",
+  "   list                    List the currently stored statements",
+  "   load FILE ?NAMES?       Load some or all SQL statements from FILE",
+  "   save FILE ?NAMES?       Save some or all SQL statements into FILE",
+  "   set NAME VALUE          Give SQL statement NAME a value of VALUE",
+  "                           NAME must start with a letter, and effective",
+  "                           value is space-joined, following argument list",
+  "   unset ?NAMES?           Remove NAMES from statement store",
   ".selftest ?OPTIONS?      Run tests defined in the SELFTEST table",
   "    Options:",
   "       --init               Create a new SELFTEST table",
@@ -4242,6 +4258,8 @@ static const char *(azHelp[]) = {
   ".vfsname ?AUX?           Print the name of the VFS stack",
   ".width NUM1 NUM2 ...     Set minimum column widths for columnar output",
   "     Negative values right-justify",
+  ".x ?NAMES?               Execute the named stored SQL statements in order",
+  "   This is merely a shorter alias for .script execute ?NAMES?"
 };
 
 /*