[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/emacsql c1ede49bbe 283/427: Update headers.
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/emacsql c1ede49bbe 283/427: Update headers. |
Date: |
Tue, 13 Dec 2022 02:59:51 -0500 (EST) |
branch: elpa/emacsql
commit c1ede49bbe5527aa49a1ea4cf19377fd212418dd
Author: Christopher Wellons <wellons@nullprogram.com>
Commit: Christopher Wellons <wellons@nullprogram.com>
Update headers.
---
README.md | 30 +++++++++++++++---------------
emacsql.el | 11 +++++------
2 files changed, 20 insertions(+), 21 deletions(-)
diff --git a/README.md b/README.md
index 52bdc4ddcc..49294a746e 100644
--- a/README.md
+++ b/README.md
@@ -14,12 +14,15 @@ closures. EmacSQL has no concept of "TEXT" values; it's all
just lisp
objects. The lisp object `nil` corresponds 1:1 with `NULL` in the
database.
-This package includes custom native binaries for communicating with a
-SQLite database. When linked with GNU Readline, or when run in
-Windows, the official sqlite3 command shell is incapable of correct
-interaction. If your own package depends on EmacSQL as a database it
-also means you don't have to rely on the user having particular
-software installed.
+During package installation EmacSQL will attempt to compile a custom
+native binary for communicating with a SQLite database. If this fails
+(a C compiler is not available), it will attempt to download, with
+permission, a pre-built binary when the first database connection is
+attempted. The official sqlite3 command shell is incapable of correct
+interaction when linked with GNU Readline, or when run in Windows, so
+a custom built tool is required. If your own package depends on
+EmacSQL as a database this means it doesn't have to rely on the user
+having any particular software installed.
Requires Emacs 24 or later.
@@ -278,21 +281,18 @@ This is why rows must be vectors and not lists.
## SQLite Support
-The included SQLite binary is compiled with [Soundex][soundex] and
-[full-text search][fts] (FTS4) enabled. These are disabled by the
-default SQLite build. Currently binaries are included for the
-following platforms:
+The custom EmacSQL SQLite binary is compiled with [Soundex][soundex]
+and [full-text search][fts] (FTS4) enabled -- features disabled by the
+default SQLite build. This backend should work on any system with a
+compliant C compiler installed as `cc`. If you don't have a C compiler
+installed the following platforms will be able to fetch a pre-built
+SQLite binary:
* Linux x86 and x86_64
* OS X x86_64
* Windows x86 and x86_64, including Cygwin
* Linux armv6l (Raspberry Pi + Raspbian)
-EmacSQL will run the binary matching Emacs, not necessarily the best
-one for the OS, so 32-bit Emacs will run the 32-bit back-end. More
-platforms could be supported in the future, but this is currently all
-I'm able to target and test at the moment.
-
### Ignored Features
EmacSQL doesn't cover all of SQLite's features. Here are a list of
diff --git a/emacsql.el b/emacsql.el
index c3c4183bd3..7a6857fef0 100644
--- a/emacsql.el
+++ b/emacsql.el
@@ -13,12 +13,11 @@
;; (primarily), PostgreSQL, MySQL, and potentially other SQL
;; databases.
-;; Notice: this package is bundled with custom SQLite native binaries
-;; for a number of platforms. This means you do *not* need to install
-;; any sort of SQLite software on your system for EmacSQL to work.
-;; Unless you're on an unusual platform, in which case you'll need to
-;; compile your own. This is not the case for any other SQL database,
-;; however.
+;; During package installation EmacSQL will attempt to compile a
+;; custom native binary for communicating with a SQLite database. If
+;; this fails (a C compiler is not available), it will attempt to
+;; download, with permission, a pre-built binary when the first
+;; database connection is attempted.
;; Most EmacSQL functions operate on a database connection. A
;; connection to SQLite is established with `emacsql-connect'. For
- [nongnu] elpa/emacsql 933e6f109a 263/427: Clean up for easier cross-compilation., (continued)
- [nongnu] elpa/emacsql 933e6f109a 263/427: Clean up for easier cross-compilation., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 810243e823 290/427: Remember SQLite fetch preference in customization., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql fb2270509f 279/427: Adjust make clean., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 7e078e2b32 282/427: Change OS-detection in Makefile., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql cfde8bea56 291/427: Update README for new customization variable., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 46850a75d0 268/427: Update the README., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 3e6a24e22a 303/427: Escape identifiers that collide with keywords., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql c4036cbdc8 280/427: Move test print statement., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 1bf92bab9e 285/427: Add a special case for unary not., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql da2b137771 289/427: Fix the parameter naming in emacsql-show-last-sql., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql c1ede49bbe 283/427: Update headers.,
ELPA Syncer <=
- [nongnu] elpa/emacsql 965039cec2 314/427: Adjust header lines for each back-end., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 57c40202e8 307/427: Set correct default transaction type in PostgreSQL., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 7b505b6e94 309/427: Update back-end documentation., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 649fc6b0b4 312/427: Add emacsql-pg using pg.el as a back-end., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 4a535e2cca 318/427: Fix typo in emacsql-buffer's doc-string, ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql a5a0c2f838 323/427: Fix typo, ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql e6ce8ded45 326/427: Require url when running emacsql-sqlite-download, ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 01f3d3eb2b 316/427: Fallback to buffer-file-name when load-file-name is nil, ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 02acd07072 328/427: Ensure executable variable is defined at compile time., ELPA Syncer, 2022/12/13
- [nongnu] elpa/emacsql 2ffcc95c67 338/427: Fix a typo in the doc-string of emacsql-with-params., ELPA Syncer, 2022/12/13