From: drh <>
Date: Tue, 31 Mar 2026 18:49:23 +0000 (+0000)
Subject: Add appropriate headers to ext/session/sqlite3session.h so that the
X-Git-Tag: major-release~21
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d6226a9c279d5239284f01561e4545c6b2b38c54;p=thirdparty%2Fsqlite.git

Add appropriate headers to ext/session/sqlite3session.h so that the
documentation generator will pick up the API documentation for the
new one-at-a-time changegroup APIs.

FossilOrigin-Name: da514f10b7804fd0affaf0fd4b8089012288ba99c165ef4ab78ab28edd331211
---

diff --git a/ext/session/sqlite3session.h b/ext/session/sqlite3session.h
index a5083e7706..fb2336d326 100644
--- a/ext/session/sqlite3session.h
+++ b/ext/session/sqlite3session.h
@@ -1943,6 +1943,8 @@ int sqlite3changegroup_change_begin(
 );
 
 /*
+** CAPI3REF: Add a 64-bit integer to a changegroup
+**
 ** This function may only be called between a successful call to 
 ** sqlite3changegroup_change_begin() and its matching
 ** sqlite3changegroup_change_finish() call. If it is called at any
@@ -1979,6 +1981,8 @@ int sqlite3changegroup_change_int64(
 );
 
 /*
+** CAPI3REF: Add a NULL to a changegroup
+**
 ** This function is similar to sqlite3changegroup_change_int64(). Except that
 ** it configures the change currently under construction with a NULL value
 ** instead of a 64-bit integer.
@@ -1986,6 +1990,8 @@ int sqlite3changegroup_change_int64(
 int sqlite3changegroup_change_null(sqlite3_changegroup*, int, int);
 
 /*
+** CAPI3REF: Add an double to a changegroup
+**
 ** This function is similar to sqlite3changegroup_change_int64(). Except that
 ** it configures the change currently being constructed with a real value
 ** instead of a 64-bit integer.
@@ -1993,6 +1999,8 @@ int sqlite3changegroup_change_null(sqlite3_changegroup*, int, int);
 int sqlite3changegroup_change_double(sqlite3_changegroup*, int, int, double);
 
 /*
+** CAPI3REF: Add a text value to a changegroup
+**
 ** This function is similar to sqlite3changegroup_change_int64(). It configures
 ** the currently accumulated change with a text value instead of a 64-bit
 ** integer. Parameter pVal points to a buffer containing the text encoded using 
@@ -2005,6 +2013,8 @@ int sqlite3changegroup_change_text(
 );
 
 /*
+** CAPI3REF: Add a blob to a changegroup
+**
 ** This function is similar to sqlite3changegroup_change_int64(). It configures
 ** the currently accumulated change with a blob value instead of a 64-bit
 ** integer. Parameter pVal points to a buffer containing the blob. Parameter 
@@ -2015,6 +2025,8 @@ int sqlite3changegroup_change_blob(
 );
 
 /*
+** CAPI3REF: Finish adding one-at-at-time changes to a changegroup
+**
 ** This function may only be called following a successful call to
 ** sqlite3changegroup_change_begin(). Otherwise, it is an SQLITE_MISUSE error.
 **
diff --git a/manifest b/manifest
index 85439a682f..203d118f9a 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Add\san\sAPI\sto\sthe\ssessions\smodule\sto\sadd\schanges\sone\sat\sa\stime\sto\san\ssqlite3_changegroup\sobject.
-D 2026-03-31T10:59:13.118
+C Add\sappropriate\sheaders\sto\sext/session/sqlite3session.h\sso\sthat\sthe\ndocumentation\sgenerator\swill\spick\sup\sthe\sAPI\sdocumentation\sfor\sthe\nnew\sone-at-a-time\schangegroup\sAPIs.
+D 2026-03-31T18:49:23.742
 F .fossil-settings/binary-glob 61195414528fb3ea9693577e1980230d78a1f8b0a54c78cf1b9b24d0a409ed6a x
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
@@ -572,7 +572,7 @@ F ext/session/sessionsize.test 8fcf4685993c3dbaa46a24183940ab9f5aa9ed0d23e5fb63b
 F ext/session/sessionstat1.test 5e718d5888c0c49bbb33a7a4f816366db85f59f6a4f97544a806421b85dc2dec
 F ext/session/sessionwor.test 6fd9a2256442cebde5b2284936ae9e0d54bde692d0f5fd009ecef8511f4cf3fc
 F ext/session/sqlite3session.c bcec91b7fc7f7acdf7fae6020de5f9131ce91c61b6d9953d5f96fc058f6d25d4
-F ext/session/sqlite3session.h b117cddb6ce93411b3b25c8a355d155a120e30efbdf506fc6899b71a333b0c56
+F ext/session/sqlite3session.h 063e7bf7be2fff874456f452a224b5b3013b25682d108933b0351c93a1279b9c
 F ext/session/test_session.c beefbb051a2baa2636f463ad1c50558294a418f955219be9423de54dff946f0f
 F ext/wasm/GNUmakefile 68c750f173106d9d63f12c1edf1256c6f4bad9894b155da5db64322f4912de4b
 F ext/wasm/README-dist.txt f01081a850ce38a56706af6b481e3a7878e24e42b314cfcd4b129f0f8427066a
@@ -2197,9 +2197,8 @@ F tool/warnings-clang.sh bbf6a1e685e534c92ec2bfba5b1745f34fb6f0bc2a362850723a9ee
 F tool/warnings.sh a554d13f6e5cf3760f041b87939e3d616ec6961859c3245e8ef701d1eafc2ca2
 F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f
 F tool/winmain.c 00c8fb88e365c9017db14c73d3c78af62194d9644feaf60e220ab0f411f3604c
-P 934582706109d2ebda26952c7c95f7a5095fa47ec837570a66c991866f7d08cf 716e62e3d1d6ff96f6e4906175818439103e9534e89bec4a86776265a04954b9
-R aa5223b212f1ad46f0f376c6a9330268
-T +closed 716e62e3d1d6ff96f6e4906175818439103e9534e89bec4a86776265a04954b9
-U dan
-Z 567722104ff813fa7a84013ce4b3243e
+P cf1122ea6409bcbd341b67ae45147abb8d5cd491ae95491c801d0621181da40b
+R d079d3d6c192abb2fec9c7dad0aa7226
+U drh
+Z bc742dfff42c3cbadf42e1ec9f9dd77a
 # Remove this line to create a well-formed Fossil manifest.
diff --git a/manifest.uuid b/manifest.uuid
index fd8b52a25d..7caa692cc9 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-cf1122ea6409bcbd341b67ae45147abb8d5cd491ae95491c801d0621181da40b
+da514f10b7804fd0affaf0fd4b8089012288ba99c165ef4ab78ab28edd331211