Sync the database file after a rollback.  This is a cherrypick merge
of check-in [b21b911f23].

FossilOrigin-Name: 82dd61fccff3e4c77e060e5734cd4b4e2eeb7c32

Modify the sqlite3_log() interface and implementation so that it never uses
dynamic memory allocation - to avoid deadlocking when called while holding
the memory allocator mutex.  Cherry-pick merge of [28d1bc98d6].

FossilOrigin-Name: 6f368b5448363ae497bd4ff49b4ceeafb27f8cb3

When TEMP files are in memory, also put the massive TEMP file used by
the VACUUM command in memory.  This is a cherry-pick merge of
[9daf4e7d07]

FossilOrigin-Name: e5342234357dcfde33fb7589f87d64f6de7d9970

Expire pragma statements when reset, even if they were not run to completion.

FossilOrigin-Name: b8fbf4275bded6680e368a6a8343866467bd7e22

Merge in all of the logging enhancements.  This is a cherrypick merge of
the following check-ins: [103321e37a], [a8076aede3], [6d910245ad],
[7c4cca6d1a], [edea3bb740], [1a6d4bb130], [a8c984c1d6], [69a493182f], and
[1168763d2c].

FossilOrigin-Name: 46f406b2022b534f396491c04adad8a2012b8fcb

Fix a segfault that is possible for an OOM fault in ATTACH when in
shared-cache mode.  This is a cherrypick merge of check-in [e37137376a].

FossilOrigin-Name: f73cc0e9af5e4b7a15e8947c412966f9e9935f8b

Enhance integrity_check to detect out-of-order rowids.  This is a
cherrypick merge of check-in [cae47c5b09].

FossilOrigin-Name: ecd22ef34d5cd516d2b6138f8b80c39daad3519d

Merge in the fix for VACUUM on auto_vacuumed databases with large schemas.
Check-in [86d50ce57f].  Ticket [da1151f97df].

FossilOrigin-Name: ce624e39c2f7c5480937a8d2007e7ebd684665dc

Start a new branch for release 3.6.22 plus limited enhancements and fixes.
This first check-in includes the performance enhancements of check-ins
[26cb1df735], [61a2c8d4d6], and [27dc5b1c52]

FossilOrigin-Name: 9588259882541e215813f48ccfa9180d8013a876

Version 3.6.22 Release Candidate 2

FossilOrigin-Name: 28d0d7710761114a44a1a3a425a6883c661f06e7

Removed compiler warnings in MSVC.

FossilOrigin-Name: 4ecb4725b76042ac414caf90039d5d0a5f8f7068

Make sure new pages are zeroed even when loading a freelist page using the
noContent option.  This prevents a harmless valgrind warning.

FossilOrigin-Name: e47e213369a2652d7eb6bddd58617959e21ca82b

Fix a problem in the shell tool. In some cases sqlite3_errmsg() was being called before sqlite3_finalize(), causing error messages to be more generic than they should be.

FossilOrigin-Name: e5d07045fabe0803715cfb291aa9e971235cb08a

In the debugging memory allocator, initialize new memory allocations to
pseudo-randomness in an effort to find problems with memcmp() of structures
that have uninitialized pad bytes.

FossilOrigin-Name: 6462817b2f817a6105449b0ea3e1e336e42571d1

Fix a case in os_unix.c where two structures that might have uninitialized
padding bytes are compared using memcmp().

FossilOrigin-Name: e02f25560216c7c96c5e1c7e71a8531650b3a96f

Version 3.6.22 Release Candidate 1

FossilOrigin-Name: 9d8ab0f1f5ea4f05a685ea6541f501532514e8c5

Add experimental implementation of FTS3 functions matchinfo() and snippet() (not enabled by default).

FossilOrigin-Name: 51f7ee844057086789dcfcdcba7daf45343cae62

Fix a bug in the new sqlite3_test_control case of the previous check-in.

FossilOrigin-Name: 3b77701bc854997346e9cc33fe64d00d4b6332bd

Add a new sqlite3_test_control() verb that facilitates testing that all
keywords are shown in the documentation.  (Two keywords were found to
be missing while testing the change.)

FossilOrigin-Name: d3cdc4b12be7f1ed2249ad210482200868956d12

Add evidence marks associated with autoincrement.

FossilOrigin-Name: 0e918c54893c361fb005295847f89aadcbfae35d

Add comments and an assert() to help clarify the operation of the
sqlite3VdbeList() routine used to implement EXPLAIN.

FossilOrigin-Name: e1ccdb93d79a6f7b16f1f59cc3ad78f8d02eae84

Minor changes to test scripts to support various SQLITE_OMIT options.

FossilOrigin-Name: 97f8a886b6314b044a0522a88f569798fdfb3ef9

Changes to remove warnings in MSVC build.

FossilOrigin-Name: 6cf76c2ae25d6e58926637ecd42eed6b300b1a25

Change evidence marks to track requirement number changes in the foreign-key
documentation.

FossilOrigin-Name: 6b4fcd81e775ff4c5d7bc454378555cf73cf5772

Change the version number to 3.6.22.

FossilOrigin-Name: 96919a46bbd63cb1794c8eb96b6ad23ecc09ba6b

Adjustments to column cache handling in order to restore 100% branch
test coverage.

FossilOrigin-Name: cc6b959bc1f968e08eea1afd387201d70a0c1e80

Remove some code in the column cache that is no longer used.  Replace it with
an assert().

FossilOrigin-Name: 1f890efb7863bd743b9f6ef841e0c0c4e67d76e1

Remove obsolete comment text from expr.c.  No functional code changes.

FossilOrigin-Name: 84058be0beb799bc989d73a8d4cd8791ab709395

Within the special new.* and old.* tables of a trigger, recognize all the
original table names even if those names overload the "rowid", "oid", or
"_rowid_" special names.  Ticket [34d2ae1c6d0].

FossilOrigin-Name: 1a0e5fa9f0ff792c678c99d49960601a0cef925b

Fix a bug triggered by optimizing an FTS3 table when there are no segments on disk but pending terms in the hash table.

FossilOrigin-Name: a3b50e4f80ca2dacc1f72435b8c72d55ffdb64e7

Immediately purge entries from the column cache when the associated register
undergoes an affinity change.  Ticket [eb5548a849].  Enhance the
SQLITE_TESTCTRL_OPTIMIZATIONS setting of sqlite3_test_control so that it
can disable the column cache for testing purposes, in an effort to prevent
future problems of a similar nature to this one.

FossilOrigin-Name: ea4e57e1c1b6663ceb12872e31a8503f6c14e3d8

Move the query flattener turn-off from a pragma to an sqlite3_test_control()
call.  Make provisions (not yet implemented) to turn off other optimizers
using the same call.

FossilOrigin-Name: 4a97c623f4e190134de4b2ca406e311034a74797

Add the experimental FTS3 matchinfo() function. Provides details of the match that may be used for result ranking and other purposes.

FossilOrigin-Name: 37a1de02d1d8a34604f1bee896eaf579d4ba149a

Add a pragma to disable the query flattener - for use during testing.

FossilOrigin-Name: 1d8550e5c88db0ea76aea579c1a5bf99d48fbe43

Change many comments in e_fkey.test to include the full text of the corresponding statement in foreignkeys.html.

FossilOrigin-Name: 4b489ecb250ea0e80d5bf8806f07259e1107f8ad

Fix a problem in FTS3 phrase queries. Add tests to check that it really is fixed.

FossilOrigin-Name: 956de051f43dfc2f178a7820981da4bf69927190

Modified statement machine in sqlite3_complete() to return 0 on empty string.
Added/updated tests for same.  Ticket 356c885b0b.

FossilOrigin-Name: 76eca7295cf7df4bef013af6c8c37251300cd383

Fixed some TCL test cases to work if SQLITE_OMIT_TRIGGER is defined.

FossilOrigin-Name: 85e3c73497d72d09becf728efe81041277ca1730

Updated and added new test cases for CLI.

FossilOrigin-Name: 29e3c8da1bd3971215036e5f5cfa5b25c6caa81f

In shell.c (CLI), modified local_getline() to remove '\r' as well as '\n' from end of lines.

FossilOrigin-Name: b1b48be1cf55f3179eab8824cf5fee8100518845

Fix typo in comment of prepare.c.

FossilOrigin-Name: 333c3ffe6d4d2293d01958812b9c02b0bf9796a4

Disable trace when recursively running commands while vacuuming.

FossilOrigin-Name: 69a1348a3c88ffbf401cf72bbec8b4a76557bd11

Change the REGEXP function in ICU to require exactly 2 arguments.

FossilOrigin-Name: c34cf23efb92d9bbb7cf4245d372e47182771f63

Remove unreachable code that was added by the fix to the "(xANDy)OR(z)" bug
in the previous check-in.

FossilOrigin-Name: 04915562a0c2cb377bc7baa0c06c5d9ac376563c

Ensure WHERE clause terms involving tables on the right end of a join
are not prematurely evaluated when tables on the left end of the join
make use of the OR-clause optimization.
Fix for ticket [31338dca7e].

FossilOrigin-Name: 2c2de252666662f5459904fc33a9f2956cbff23c

Modify some comments in e_fkey.test. No changes to code or tests.

FossilOrigin-Name: 1ba4f412325fc2ce552ad7feecf93891f7f95059

Add a few simple evidence comments to the tokenizer.  No functional changes.

FossilOrigin-Name: 0daec3099d439ce8a8779260b12975f262037bc8

Handle an unhandled OOM error code that occurs in fts3 with SQLITE_TEST defined.

FossilOrigin-Name: 82b069998e10b1a9a1d5e6bd85877d7b654c78bd

Fix a broken assert() in fts3_write.c. Also fix a couple of compiler warnings in fts3 code.

FossilOrigin-Name: a730a05b39c45138765df98d34b9db1ab4e72152

Additional corrections to documentation comments.  No functional code changes.

FossilOrigin-Name: b3740b0aa0a7c6932e33e02b37baed5a5960a0bd

Minor documentation updates.  No functional changes.

FossilOrigin-Name: 6ae7e40ba0f710609cf1bc8baa54e7839eb7a2d7

Fix some documentation comments in sqlite.h.in.  No functional code changes.

FossilOrigin-Name: c16b9bec77c8b9120b728f8431648d95175a83b8

Tests to cover a few extra branches in fts3.c.

FossilOrigin-Name: 06b72b007393dc34d75a8bb16ce0e4507d5f8faa

Further fts3 coverage tests.

FossilOrigin-Name: d2a8c0f683271f5fb8c9badfb13e4e46fd78db71

Rename tkt-d82e3f3721.txt to use the (correct) .test suffix.

FossilOrigin-Name: 68cccd62b71f7b55bf7f2f56dc8507cbe80229ba

Extra tests for coverage of fts3 code.

FossilOrigin-Name: eee921a99e69a9cd868a89de620bf47c4e26e4b5

Add coverage test cases for fts3.

FossilOrigin-Name: 8fcb0478c82507403165719724b62a308cb83b57

Additional changes to C-language interface documentation.

FossilOrigin-Name: 1342916fd350d06e1c1f3d7d380249f0c9282c7b

Change the fts3 test interface used to configure the advisory node size paraemeter.

FossilOrigin-Name: 87fc0ce151c89beb5a43b65c0b1706f340c0c173

Rationalize some code in fts3 used by optimize operations, queries of the pending-terms hash table and segment merges. Add the "INSERT INTO tbl(tbl) VALUES('optimize')" syntax.

FossilOrigin-Name: 29476da353df4c67fe744c1c5f466ba5b9c1a54b

Add comment to fts3rnd.test to explain how the test works.

FossilOrigin-Name: 6b740c7cd57d618623ed028be4213dfef860054a

Extensive edits to the comments in the sqlite.h.in source file to identify
testable statements of truth about the C-language interface.

FossilOrigin-Name: ea884e1ed8dba1aa0f3cf68fc71923954983f6c6

Avoid declaring and freeing test variables if SQLITE_TEST not defined.

FossilOrigin-Name: c2d22960f652264c48ec41b9ca4047aa142d86f7

Remove some unused macros and types from fts3.c.

FossilOrigin-Name: 83a80efe8a6c3d53a7f80b4c5f4e0f40aa0aa52f

Fix handling of "WHERE col MATCH ? AND docid = ?" clauses in fts3.

FossilOrigin-Name: 6cbbae849990d99b7ffe252b642d6be49d0c7235

Fix an OOM related problem in the snippet() and offsets() functions of fts3.

FossilOrigin-Name: 61efff414254f209f1c69728ae2da3b3888b7290

Changes to fts3 to avoid flushing data to disk within a SELECT statement.

FossilOrigin-Name: 48c0db0eb2d134bb302bb5eca6beb0ec46736257

Only declare the sqlite3_mutex_held() and sqlite3_mutex_notheld() interfaces
in the header file if NDEBUG is not defined.

FossilOrigin-Name: ee9b1c05a7f12d3d668b804bd11ae0def984b66e

Restore the incorrect legacy ON INSERT syntax to the parser as a no-op.
That way, older databases that actually use this meaningless syntax will
still be readable.

FossilOrigin-Name: 54b955c36ba5c139a63c6031855305b764d3fa6c

Added test cases for the multi-way USING and NATURAL JOIN fix.
Ticket [f74beaabde].

FossilOrigin-Name: 0b34ab25624ae4b6c5fa7775328ff0e637d68bfc

The USING clause and NATURAL JOIN look at all tables to the left when
searching for a match, not just the one table to the immediate left.
Tables further to the left are preferred.
Fix for ticket [f74beaabde].  Still need to add test cases to complete
the ticket.

FossilOrigin-Name: b558e96f0a3cd2cbbe86e44293246a4730960d52

Improve test coverage of fts3.c.

FossilOrigin-Name: 56b6432f8622d53ffd3a4d9a2244114f8531ed71

Mark fts3ReallocOrFree and fts3InitVtab as static. Ticket [ff44d82f3b].

FossilOrigin-Name: a9038306c33c88120d8bef27209d8f0641c85c9b

Change to order of two branches in vtab.c in order to a restore 100% test
coverage.

FossilOrigin-Name: fdfdc777c59a108496c7381c8b267b38485e2c13

Add comments to better explain the two-pass memory allocation approach
for prepared statements.

FossilOrigin-Name: 0e5e18ea12c70559d4c63981c0bb5f9430c5bcbb

Add tests to improve coverage of fts3. Associated bugfixes.

FossilOrigin-Name: f0eac4175aee6c50ee68acc253f76fbe44574250

Avoid pointer aliasing in the allocSpace() routine in vdbeaux.c.

FossilOrigin-Name: d6ae27512229d95502c584b17bb2cbdba401f80a

Begin updating API documentation to use the new MD5-hash based
automatic requirements numbering.  Comment changes only.  Many similar
changes will follow.

FossilOrigin-Name: 973c5c86eed31dcce54d14e71938f2e255f5f1c7

Allow zero-length names for tables, columns, and indices.
Fix for ticket [78e04e52eaf].

FossilOrigin-Name: 7b1cfd65a6f7c85ef8f6e4622973457cff9d007c

Add test cases for ticket [abe728bbc311].

FossilOrigin-Name: 4eb9bf0b93a564844f133691936593245aa792fc

Avoid dereferencing a null pointer when doing a multi-database comment where
one or more of the databases is an ATTACH-ed TEMP database.
Ticket [abe728bbc311d].

FossilOrigin-Name: f43e37e0a4cc7c15c996f4404dc775636396567d

Add evidence marks for the abs() and soundex() SQL functions.

FossilOrigin-Name: 003f3ed10cdb64b73d6df00e28260dd3491e1f16

Version 3.6.21 release candidate 3.

FossilOrigin-Name: 1ed88e9d01e9eda5cbc622e7614277f29bcc551c

Remove a redundant line from fts3.

FossilOrigin-Name: cd50acf37fd1e3b388f98fb2df7ed03cff454b24

Add extra tests for parsing of whitespace in tokenizer declarations,.

FossilOrigin-Name: 5030ba2e308df6aeef2ed6b2e153f7baf2c81262

Move some SQLITE_TEST code down to avoid mixing code and variable declarations.
Fix a test for high-order bit handling in sqlite3Fts3InitTokenizer().

FossilOrigin-Name: fad43d290f9489726aaa2e999a17ea17ed78b27b

Version 3.6.21 release candidate 2.

FossilOrigin-Name: 78f6baffb0289a173b0bb56bc54bf0f32e6c957d

Add some tests for OR, AND and NOT operations to fts3rnd.test. Add tests to check that errors are returned when bad arguments are passed to fts3 functions snippet, offsets and optimize. Minor fix for the same

FossilOrigin-Name: 5811df3f0412598d189d46b58de4deff24573651

Enhanced detection of database corruption in btree.c:allocateSpace().

FossilOrigin-Name: 5a511f98877f0f7f12d336b7831f3da901856b02

Fix to check-in [f221f31eff]:  Make sure local variable rc is declared even
when compiled without SQLITE_DEBUG.

FossilOrigin-Name: 7a9a35327c55452e858335933ce11669fc888aeb

Add test case for the obscure corruption detection added by the previous commit.

FossilOrigin-Name: f221f31efff83651b9af295b98cfe98bcba3ad54

Catch an obscure case of database corruption.

FossilOrigin-Name: 0f9b17a6da42b4da667bbbc00f713effe92a66b5

Fix another bug in 3-way NEAR queries.

FossilOrigin-Name: 3bb13a06521b54194c9f3eb44e0dc42bacf016a4

Fix some problems with FTS3 and 3-way NEAR queries.

FossilOrigin-Name: 23dc6fb5b28712d1ba18dc7ddb3f2ef3b469d611

Add the SQLITE_4_BYTE_ALIGNED_MALLOC compile-time option which tells some
assert() statements that the underlying system only requires 4-byte alignment
of 8-byte data objects like double or int64 and that system malloc() only
guarantees 4-byte alignment of returned pointers.

FossilOrigin-Name: 08faee686eb2fabe0dde51231ee55880e78541e8

Remove an assert() in btree.c:releasePage() that is not necessarily true
when the btree is recovering from an OOM that occurs in the middle of
a balance().

FossilOrigin-Name: 04fc9c7661dd24d080f965e7eae9010a2d346e6a

Fix a problem involving a 3-way NEAR query.

FossilOrigin-Name: 507890a9139875b1b594225c432c714f67312c0e

In the OSTRACE debugging macros in os_unix.c, identify the VFS currently
in use.

FossilOrigin-Name: 082b8da005128f47f63e95b6b702bf4517221b2a

Modify [2ad1461f25] to avoid leaving a prepared statement in "active" state following an OOM error in FTS3.

FossilOrigin-Name: 69c21ee46aeeb624fd8638b17ff7259a3e5f9a46

Fix an FTS3 problem where an OOM error was not being propagated back
out to the top-level interface.

FossilOrigin-Name: 2ad1461f255c2499367b706a5ec65b44c1fc1618