From 0e62f142b77af9a4c7701559be9bf3612988fa38 Mon Sep 17 00:00:00 2001
From: drh <>
Date: Fri, 9 Oct 2026 11:47:51 +0000
Subject: [PATCH] In the CLI, add comments to internal SQL functions making it
 clear that those functions are subject to change and removal at any time,
 lest people come to depend on them.  No changes to code.

FossilOrigin-Name: a3332bd623d997921c3186433cd1eab0c9413aa0f68d93b1731cf80128ec3a36
---
 manifest       | 14 +++++++-------
 manifest.uuid  |  2 +-
 src/shell.c.in | 30 ++++++++++++++++++++++++++++++
 3 files changed, 38 insertions(+), 8 deletions(-)

diff --git a/manifest b/manifest
index 38774351c7..fb030c2c8d 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Fix\sa\sbuild\sscript\sproblem\scausing\sgenerated\sfile\ssqlite3-all.c\sto\s#include\s"sqlite-10.c"\sinstead\sof\s"sqlite-A.c".
-D 2026-10-09T11:22:17.592
+C In\sthe\sCLI,\sadd\scomments\sto\sinternal\sSQL\sfunctions\smaking\sit\sclear\sthat\nthose\sfunctions\sare\ssubject\sto\schange\sand\sremoval\sat\sany\stime,\slest\speople\ncome\sto\sdepend\son\sthem.\s\sNo\schanges\sto\scode.
+D 2026-10-09T11:47:51.732
 F .fossil-settings/binary-glob 61195414528fb3ea9693577e1980230d78a1f8b0a54c78cf1b9b24d0a409ed6a x
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
@@ -802,7 +802,7 @@ F src/random.c 606b00941a1d7dd09c381d3279a058d771f406c5213c9932bbd93d5587be4b9c
 F src/resolve.c 0e0990f60c93db38c735d85e5d1741130e72dd0670aec204b5a39118b53c8044
 F src/rowset.c 8432130e6c344b3401a8874c3cb49fefe6873fec593294de077afea2dce5ec97
 F src/select.c f6ad8bbf82f21a32c68ce3d885f1a960469d48efde93f432f5ba680869ae64f6
-F src/shell.c.in fbcaa24ae9fccd177e0fe5e19f9161babb47b8a0b27a9b7fd3df18b855abd3bb
+F src/shell.c.in 7173fbd4457f5fac6aa13af55bce6e6971ea490bba773eb91c885509a80a8feb
 F src/sqlite.h.in 884996e07cfb7681efc76661b79d56a93f9edaea7f6fc4a3c82636dc84783486
 F src/sqlite3.rc 015537e6ac1eec6c7050e17b616c2ffe6f70fca241835a84a4f0d5937383c479
 F src/sqlite3ext.h 5e113c4c0442f2f1b3345d44cbe4b82fad45f2fc0c35f0ed4eef27fb8f1cb394
@@ -2281,8 +2281,8 @@ F tool/warnings-clang.sh bbf6a1e685e534c92ec2bfba5b1745f34fb6f0bc2a362850723a9ee
 F tool/warnings.sh a554d13f6e5cf3760f041b87939e3d616ec6961859c3245e8ef701d1eafc2ca2
 F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f
 F tool/winmain.c 00c8fb88e365c9017db14c73d3c78af62194d9644feaf60e220ab0f411f3604c
-P 797081cb705c65a466379e180344d0c9d781f10415c8ed8f72edc6ea065a1a28
-R 459ddf1fc5c28573caf164b485180572
-U dan
-Z e503e2bdda1a0f59d7658cce1714a502
+P 962b207123fe2bd6d72ad49fb80822b4e4290c1d77ea4ca097ea341202d4cc5f
+R c47cb1350cdcb2f8480994ba533055c1
+U drh
+Z 51974129b7e97591b1466fe204109561
 # Remove this line to create a well-formed Fossil manifest.
diff --git a/manifest.uuid b/manifest.uuid
index 215d30c633..51a9c11142 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-962b207123fe2bd6d72ad49fb80822b4e4290c1d77ea4ca097ea341202d4cc5f
+a3332bd623d997921c3186433cd1eab0c9413aa0f68d93b1731cf80128ec3a36
diff --git a/src/shell.c.in b/src/shell.c.in
index 89d73d04be..a3b2719c5b 100644
--- a/src/shell.c.in
+++ b/src/shell.c.in
@@ -1066,6 +1066,9 @@ static const char *shellPromptAppDef(int c){
 /*
 ** SQL function:  sqlite3_incomplete(TEXT)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Invoke the sqlite3_incomplete() interface and return its result.
 */
 static void shellIncompleteFunc(
@@ -1223,6 +1226,9 @@ static void appendCompletion(
 ** SQL function:  shell_complete_sql(SQL)
 **                shell_complete_sql(SQL, FLAGS)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** If the SQL input is a string, return a new string which is the same
 ** text with all pending quotes and comments finish, so that the
 ** SQL is ready to receive its final semicolon.  The optional FLAGS
@@ -1801,6 +1807,9 @@ static char *shellFakeSchema(
 /*
 ** SQL function:  strtod(X)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Use the C-library strtod() function to convert string X into a double.
 ** Used for comparing the accuracy of SQLite's internal text-to-float conversion
 ** routines against the C-library.
@@ -1819,6 +1828,9 @@ static void shellStrtod(
 /*
 ** SQL function:  dtostr(X)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Use the C-library printf() function to convert real value X into a string.
 ** Used for comparing the accuracy of SQLite's internal float-to-text conversion
 ** routines against the C-library.
@@ -1841,6 +1853,9 @@ static void shellDtostr(
 /*
 ** SQL function:  shell_add_schema(S,X,N)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Add the schema X to the CREATE statement in S for table N and return
 ** the result.
 **
@@ -1913,6 +1928,9 @@ static void shellAddSchemaName(
 /*
 ** SQL function:  shell_prompt_test(PROMPT,PRIOR,FILENAME,FLAGS)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Return the shell prompt, with escapes expanded, for testing purposes.
 ** The first argument is the raw (unexpanded) prompt string.  Or if the
 ** first argument is NULL, then use whatever prompt string is currently
@@ -2399,6 +2417,9 @@ static void shellLog(void *pArg, int iErrCode, const char *zMsg){
 /*
 ** SQL function:  shell_putsnl(X)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Write the text X to the screen (or whatever output is being directed)
 ** adding a newline at the end, and then return X.
 */
@@ -2982,6 +3003,9 @@ static int wsToEol(const char *z){
 /*
 ** SQL Function:  shell_format_schema(SQL,FLAGS)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** This function is internally by the CLI to assist with the
 ** ".schema", ".fullschema", and ".dump" commands.  The first
 ** argument is the value from sqlite_schema.sql.  The value returned
@@ -5062,6 +5086,9 @@ static void shellUSleepFunc(
 /*
 ** SQL function:  shell_module_schema(X)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Return a fake schema for the table-valued function or eponymous virtual
 ** table X.
 */
@@ -6673,6 +6700,9 @@ static void newTempFile(ShellState *p, const char *zSuffix){
 /*
 ** SQL function:  shell_temp_filename(SUFFIX)
 **
+** For use internally and for debugging and testing only.  This function
+** is subject to change or removal in future versions.
+**
 ** Return a randomly generated temporary filename.
 */
 static void shellTempFilenameFunc(