[nongnu] elpa/emacsql 4332bd67ec 271/427: Flesh out the main header a bit more.

[ELPA Syncer]

branch: elpa/emacsql
commit 4332bd67ec2818aef07280a1b56f17cebd710daa
Author: Christopher Wellons <wellons@nullprogram.com>
Commit: Christopher Wellons <wellons@nullprogram.com>

    Flesh out the main header a bit more.
---
 emacsql.el | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/emacsql.el b/emacsql.el
index 8daf13ac38..a35ee3c02a 100644
--- a/emacsql.el
+++ b/emacsql.el
@@ -9,11 +9,18 @@
 
 ;;; Commentary:
 
-;; The purpose of this package is to provide a high-level Elisp
-;; interface to a high-performance database back-end. Not every feature
-;; of SQL will be exposed, but the important parts should be.
-
-;; Most emacsql functions operate on a database connection. A
+;; EmacSQL is a high-level Emacs Lisp front-end for SQLite
+;; (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.
+
+;; Most EmacSQL functions operate on a database connection. A
 ;; connection to SQLite is established with `emacsql-connect'. For
 ;; each such connection a sqlite3 inferior process is kept alive in
 ;; the background. Connections are closed with `emacsql-close'.
@@ -54,6 +61,9 @@
 ;;              50000)
 ;;     ;; => (("Jeff" 1000) ("Susan" 1001))
 
+;; The letter declares the type (identifier, scalar, vector, Schema)
+;; and the number declares the argument position.
+
 ;; See README.md for much more complete documentation.
 
 ;;; Code: