From 56a520c593c842a87d85ed247ca1492f99125b1d Mon Sep 17 00:00:00 2001 From: "Christopher J. Brody" Date: Wed, 17 Jan 2018 11:44:16 -0500 Subject: [PATCH] additional doc updates --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 800feb581..bbb5a67c4 100644 --- a/README.md +++ b/README.md @@ -499,7 +499,7 @@ Some additional issues are tracked in [open Cordova-sqlite-storage bug-general i - SQL error messages reported by Windows platform version are not consistent with Android/iOS/macOS platform versions. - UNICODE `\u2028` (line separator) and `\u2029` (paragraph separator) characters are currently not supported and known to be broken on iOS, macOS, and Android platform versions due to JSON issues reported in [Cordova bug CB-9435](https://issues.apache.org/jira/browse/CB-9435) and [cordova/cordova-discuss#57](https://github.com/cordova/cordova-discuss/issues/57). This is fixed with a workaround for iOS/macOS in: [litehelpers / Cordova-sqlite-evplus-legacy-free](https://github.com/litehelpers/Cordova-sqlite-evplus-legacy-free) and [litehelpers / Cordova-sqlite-evplus-legacy-attach-detach-free](https://github.com/litehelpers/Cordova-sqlite-evplus-legacy-attach-detach-free) (GPL or special commercial license terms) as well as [litehelpers / cordova-sqlite-evmax-ext-workers-legacy-build-free](https://github.com/litehelpers/cordova-sqlite-evmax-ext-workers-legacy-build-free) (GPL or premium commercial license terms). - SELECT BLOB column value type is not supported consistently across all platforms (not supported on Windows). It is recommended to use the built-in HEX function to SELECT BLOB column data in hexadecimal format, working consistently across all platforms. As an alternative: SELECT BLOB in Base64 format is supported by [litehelpers / cordova-sqlite-ext](https://github.com/litehelpers/cordova-sqlite-ext) (permissive license terms) and [litehelpers / Cordova-sqlite-evcore-extbuild-free](https://github.com/litehelpers/Cordova-sqlite-evcore-extbuild-free) (GPL or commercial license options). -- Database files with certain multi-byte UTF-8 characters are not tested and not expected to work consistently across all platform implementations. +- Database files with certain multi-byte UTF-8 characters SUCH AS XXX are not tested and not expected to work consistently across all platform implementations. - Truncation in case of UNICODE `\u0000` (same as `\0`) character on Android (default Android-sqlite-connector database implementation) and Windows. - Case-insensitive matching and other string manipulations on Unicode characters, which is provided by optional ICU integration in the sqlite source and working with recent versions of Android, is not supported for any target platforms. - The iOS/macOS platform version uses a thread pool but with only one thread working at a time due to "synchronized" database access. @@ -538,6 +538,8 @@ Additional limitations are tracked in [marked Cordova-sqlite-storage doc-todo is - More emojis and other 4-octet UTF-8 characters - More database file names with multi-byte UTF-8 characters including emojis and other 4-byte UTF-8 characters - Use of `?NNN`/`:AAA`/`@AAAA`/`$AAAA` parameter placeholders as documented in and ) (currently NOT supported by this plugin) ref: [litehelpers/Cordova-sqlite-storage#717](https://github.com/litehelpers/Cordova-sqlite-storage/issues/717) +- XXX FUTURE TBD Android/iOS directory names with XXX characters +- XXX Use of `?NNN`/`:AAA`/`@AAAA`/`$AAAA` parameter placeholders documented in , ), NOT supported in this plugin as discussed in XXX - Single-statement and SQL batch transaction calls with invalid arguments (TBD behavior subject to change) - Plugin vs (WebKit) Web SQL transaction behavior in case of an error handler which returns various falsy vs truthy values - Other [open Cordova-sqlite-storage testing issues](https://github.com/litehelpers/Cordova-sqlite-storage/issues?q=is%3Aissue+is%3Aopen+label%3Atesting)