From 2bd7ace54e7a7a8da418a851cce87e757a808d30 Mon Sep 17 00:00:00 2001
From: dan <dan@noemail.net>
Date: Thu, 5 Mar 2015 14:07:25 +0000
Subject: [PATCH] Add comments to sqlite3ota.h to make it clear that passing
 NULL in place of a parent VFS name to sqlite3ota_create_vfs() causes the new
 VFS to use the system default as its parent.

FossilOrigin-Name: 158c1a48818a9abc001b9ea547167c2624a7bad3
---
 ext/ota/sqlite3ota.h | 13 +++++++++----
 manifest             | 12 ++++++------
 manifest.uuid        |  2 +-
 3 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/ext/ota/sqlite3ota.h b/ext/ota/sqlite3ota.h
index 6fb982cd9a..d1a11948ea 100644
--- a/ext/ota/sqlite3ota.h
+++ b/ext/ota/sqlite3ota.h
@@ -318,8 +318,10 @@ sqlite3_int64 sqlite3ota_progress(sqlite3ota *pOta);
 
 /*
 ** Create an OTA VFS named zName that accesses the underlying file-system
-** via existing VFS zParent. The new object is registered as a non-default
-** VFS with SQLite before returning.
+** via existing VFS zParent. Or, if the zParent parameter is passed NULL, 
+** then the new OTA VFS uses the default system VFS to access the file-system.
+** The new object is registered as a non-default VFS with SQLite before 
+** returning.
 **
 ** Part of the OTA implementation uses a custom VFS object. Usually, this
 ** object is created and deleted automatically by OTA. 
@@ -335,10 +337,13 @@ sqlite3_int64 sqlite3ota_progress(sqlite3ota *pOta);
 **     // Create a VFS named "multiplexor" (not the default).
 **     sqlite3_multiplex_initialize("multiplexor", 0);
 **
-**     // Create an ota VFS named "ota" that uses multiplexor.
+**     // Create an ota VFS named "ota" that uses multiplexor. If the
+**     // second argument were replaced with NULL, the "ota" VFS would
+**     // access the file-system via the system default VFS, bypassing the
+**     // multiplexor.
 **     sqlite3ota_create_vfs("ota", "multiplexor");
 **
-**     // Create a zipvfs VFS named "zipvfs" that uses ota. 
+**     // Create a zipvfs VFS named "zipvfs" that uses ota.
 **     zipvfs_create_vfs_v3("zipvfs", "ota", 0, xCompressorAlgorithmDetector);
 **
 **     // Make zipvfs the default VFS.
diff --git a/manifest b/manifest
index fabc0ff6b1..84de50ad73 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Fix\sa\stypo\sin\ssqlite3ota.h.
-D 2015-03-05T13:43:21.466
+C Add\scomments\sto\ssqlite3ota.h\sto\smake\sit\sclear\sthat\spassing\sNULL\sin\splace\sof\sa\sparent\sVFS\sname\sto\ssqlite3ota_create_vfs()\scauses\sthe\snew\sVFS\sto\suse\sthe\ssystem\sdefault\sas\sits\sparent.
+D 2015-03-05T14:07:25.199
 F Makefile.arm-wince-mingw32ce-gcc d6df77f1f48d690bd73162294bbba7f59507c72f
 F Makefile.in 6b9e7677829aa94b9f30949656e27312aefb9a46
 F Makefile.linux-gcc 91d710bdc4998cb015f39edf3cb314ec4f4d7e23
@@ -139,7 +139,7 @@ F ext/ota/otacrash.test a078d34e2edbcedac5f894e3e7d08d452a327007
 F ext/ota/otafault.test 8c43586c2b96ca16bbce00b5d7e7d67316126db8
 F ext/ota/otafault2.test fa202a98ca221faec318f3e5c5f39485b1256561
 F ext/ota/sqlite3ota.c f0ee6872b833c14c02101affc42e2f29ede54fec
-F ext/ota/sqlite3ota.h 62ffca87ae0015f2b97bbb5f25feba0280dd42e9
+F ext/ota/sqlite3ota.h d85a579448f5cb2cf042c63abefd1a440c46c962
 F ext/ota/test_ota.c e34c801c665d64b4b9e00b71f1acf8c652404b2b
 F ext/rtree/README 6315c0d73ebf0ec40dedb5aa0e942bc8b54e3761
 F ext/rtree/rtree.c 14e6239434d4e3f65d3e90320713f26aa24e167f
@@ -1258,7 +1258,7 @@ F tool/vdbe_profile.tcl 67746953071a9f8f2f668b73fe899074e2c6d8c1
 F tool/warnings-clang.sh f6aa929dc20ef1f856af04a730772f59283631d4
 F tool/warnings.sh 0abfd78ceb09b7f7c27c688c8e3fe93268a13b32
 F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f
-P d6d21ff55228d3ffe6cdbb5755645b147806a1da
-R 096b8c3fcef62782bdfa6cd3c57ba69b
+P 04087dec4c3db5f322eca289585525b7267ed4f8
+R 1c3da4ddcbca798e150df95ec9fb5930
 U dan
-Z 18c7b61a87dea891bead975838708a9c
+Z 394f4029bb7037e7ee9a54787f07d0e0
diff --git a/manifest.uuid b/manifest.uuid
index bbc9eda6e0..665b4f66c2 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-04087dec4c3db5f322eca289585525b7267ed4f8
\ No newline at end of file
+158c1a48818a9abc001b9ea547167c2624a7bad3
\ No newline at end of file