From d7d632d58135928bfcf3e17b89048a40e54a7f64 Mon Sep 17 00:00:00 2001
From: dan <Dan Kennedy>
Date: Mon, 8 Sep 2025 14:32:32 +0000
Subject: [PATCH] Add documentation comment for SQLITE_CHECKPOINT_NOOP.

FossilOrigin-Name: 2b9c495d02724f19ab16612b0e671dfc612f04342222d9901cd0debd08da4cf0
---
 manifest        | 15 ++++++---------
 manifest.uuid   |  2 +-
 src/sqlite.h.in |  5 +++++
 3 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/manifest b/manifest
index f6ee22b173..854f82c84d 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Add\s"PRAGMA\swal_checkpoint\s=\snoop"\sand\sSQLITE_CHECKPOINT_NOOP.\sTo\srequest\sa\scheckpoint\sthat\scheckpoints\szero\sframes.
-D 2025-09-04T19:33:23.379
+C Add\sdocumentation\scomment\sfor\sSQLITE_CHECKPOINT_NOOP.
+D 2025-09-08T14:32:32.174
 F .fossil-settings/binary-glob 61195414528fb3ea9693577e1980230d78a1f8b0a54c78cf1b9b24d0a409ed6a x
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
@@ -743,7 +743,7 @@ F src/resolve.c f8d1d011aba0964ff1bdccd049d4d2c2fec217efd90d202a4bb775e926b2c25d
 F src/rowset.c 8432130e6c344b3401a8874c3cb49fefe6873fec593294de077afea2dce5ec97
 F src/select.c b95181711d59c36d9789e67f76c4cfec64b99f9629a50be5e6566e117b87d957
 F src/shell.c.in 51c8452b3e6b9a0dfa3df853dd16f147e5e4ae2002deb775cf8a2fccf01c3c6c
-F src/sqlite.h.in dac8234e04ca6aa6bc76384b1568c4f70418f18a9177a05eab42dd5d097f8f6c
+F src/sqlite.h.in fc5802897125fcbde28002f835bdab4ee15d00887c9792f6b69a7961a4abb3b1
 F src/sqlite3.rc 015537e6ac1eec6c7050e17b616c2ffe6f70fca241835a84a4f0d5937383c479
 F src/sqlite3ext.h 0bfd049bb2088cc44c2ad54f2079d1c6e43091a4e1ce8868779b75f6c1484f1e
 F src/sqliteInt.h 27c73e48878d31ef230ba867d1f8c3af6aed357fd93ccc605d3f1aae007ea62b
@@ -2173,11 +2173,8 @@ F tool/version-info.c 3b36468a90faf1bbd59c65fd0eb66522d9f941eedd364fabccd7227350
 F tool/warnings-clang.sh bbf6a1e685e534c92ec2bfba5b1745f34fb6f0bc2a362850723a9ee87c1b31a7
 F tool/warnings.sh 1ad0169b022b280bcaaf94a7fa231591be96b514230ab5c98fbf15cd7df842dd
 F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f
-P 02721457cea255a5117a46b77cc87d2e09acb64340ce94089c5b5e6edc5b5033
-R bcde52a0b300b3cfba71e6f86713b592
-T *branch * wal-checkpoint-noop
-T *sym-wal-checkpoint-noop *
-T -sym-trunk *
+P 48be3d020cf0c732557b3d956198a1abcab79424be03f447e2bb89f4d68dc8ff
+R 22a72c4d94910c8e62c5c76a51f0577a
 U dan
-Z 69b6d3520e79695082c094b1d62c1d31
+Z ca2bc409510535e67e326756e9039e49
 # Remove this line to create a well-formed Fossil manifest.
diff --git a/manifest.uuid b/manifest.uuid
index f91e175118..853002a842 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-48be3d020cf0c732557b3d956198a1abcab79424be03f447e2bb89f4d68dc8ff
+2b9c495d02724f19ab16612b0e671dfc612f04342222d9901cd0debd08da4cf0
diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index 42ce232ddf..8335eb1454 100644
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -9899,6 +9899,11 @@ int sqlite3_wal_checkpoint(sqlite3 *db, const char *zDb);
 **   ^This mode works the same way as SQLITE_CHECKPOINT_RESTART with the
 **   addition that it also truncates the log file to zero bytes just prior
 **   to a successful return.
+**
+** <dt>SQLITE_CHECKPOINT_NOOP<dd>
+**   ^This mode always checkpoints zero frames. The only reason to invoke
+**   a NOOP checkpoint is to access the values returned by
+**   sqlite3_wal_checkpoint_v2() via output parameters *pnLog and *pnCkpt.
 ** </dl>
 **
 ** ^If pnLog is not NULL, then *pnLog is set to the total number of frames in
-- 
2.47.3