From: drh <drh@noemail.net>
Date: Sat, 2 Mar 2019 20:09:35 +0000 (+0000)
Subject: Improved comments on the fossildelta.c extension.
X-Git-Tag: version-3.28.0~136
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=75db74fdaeaeef414793f03c0fea93fb6ed8c92b;p=thirdparty%2Fsqlite.git

Improved comments on the fossildelta.c extension.

FossilOrigin-Name: d7d23f0450d659b2c7df34e4df8623ca7b6fe3bd19422e3e9234515214ae8510
---

diff --git a/ext/misc/fossildelta.c b/ext/misc/fossildelta.c
index b58d358b55..7e78f6fb12 100644
--- a/ext/misc/fossildelta.c
+++ b/ext/misc/fossildelta.c
@@ -10,7 +10,25 @@
 **
 ******************************************************************************
 **
-** This SQLite extension implements the delta functions used by Fossil.
+** This SQLite extension implements the delta functions used by the RBU
+** extension. Three scalar functions and one table-valued function are
+** implemented here:
+**
+**   delta_apply(X,D)     -- apply delta D to file X and return the result
+**   delta_create(X,Y)    -- compute and return a delta that carries X into Y
+**   delta_output_size(D) -- blob size in bytes output from applying delta D
+**   delta_parse(D)       -- returns rows describing delta D
+**
+** The delta format is the Fossil delta format, described in a comment
+** on the delete_create() function implementation below, and also at
+**
+**    https://www.fossil-scm.org/fossil/doc/trunk/www/delta_format.wiki
+**
+** This delta format is used by the RBU extension, which is the main
+** reason that these routines are included in the extension library.
+** RBU does not use this extension directly.  Rather, this extension is
+** provided as a convenience to developers who want to analyze RBU files 
+** that contain deltas.
 */
 #include <string.h>
 #include <assert.h>
diff --git a/manifest b/manifest
index 844bd02081..99d80ef9bf 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Fix\sthe\sSQLITE_DIRECT_OVERFLOW_READ\scompile-time\soption\sso\sthat\sit\sworks\nwith\sSQLITE_HAS_CODEC.
-D 2019-03-02T15:25:24.014
+C Improved\scomments\son\sthe\sfossildelta.c\sextension.
+D 2019-03-02T20:09:35.788
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
 F Makefile.in 1ad7263f38329c0ecea543c80f30af839ee714ea77fc391bf1a3fbb919a5b6b5
@@ -286,7 +286,7 @@ F ext/misc/dbdump.c baf6e37447c9d6968417b1cd34cbedb0b0ab3f91b5329501d8a8d5be3287
 F ext/misc/eval.c 4b4757592d00fd32e44c7a067e6a0e4839c81a4d57abc4131ee7806d1be3104e
 F ext/misc/explain.c d5c12962d79913ef774b297006872af1fccda388f61a11d37758f9179a09551f
 F ext/misc/fileio.c e7864c391e14ccaf73ee4b22f5a55c1eb40ecc93a7f5ee77a1b41b87367ec7ae
-F ext/misc/fossildelta.c 3cc9a9b2f39889b43cd176c19f286bc7dd652f4c202c202d008481252d820316
+F ext/misc/fossildelta.c 910510968a30ab77b8ac1a27931f2cb834e9db9fd5ab122f53b6045b4315665d
 F ext/misc/fuzzer.c 9e79c337faffdd4c5fe4485467537438359b43e0858a40038d4300b894ff553f
 F ext/misc/ieee754.c f190d0cc5182529acb15babd177781be1ac1718c
 F ext/misc/json1.c 8af4672f43634257dbcfdb4515b4070325463d67c6968b4be1bd414de28d4d58
@@ -1805,7 +1805,7 @@ F vsixtest/vsixtest.tcl 6a9a6ab600c25a91a7acc6293828957a386a8a93
 F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
 F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
 F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P d49c32e6e7cc341b5961d2c7b7c68d1649c6542eeec201660e3f82a55aea9e3b
-R 50571770f9cddd9f6937b98986c246b4
+P fd085e9260bec18f968704abb2dd324d954baa121d13b67c3f5b801e9e3834aa
+R 2f413ab89884ce894ab037220c4ef892
 U drh
-Z 39fd6294d7f36d7da03a65b55eee9cda
+Z 4ebc8a2db088c512de2eab3689f25c24
diff --git a/manifest.uuid b/manifest.uuid
index 5a3c4e431a..c0e58c4f51 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-fd085e9260bec18f968704abb2dd324d954baa121d13b67c3f5b801e9e3834aa
\ No newline at end of file
+d7d23f0450d659b2c7df34e4df8623ca7b6fe3bd19422e3e9234515214ae8510
\ No newline at end of file