branch: elpa/pg commit bfa54d185923fda915dfe11f7c9d4af1cde973df Author: Eric Marsden <eric.mars...@risk-engineering.org> Commit: Eric Marsden <eric.mars...@risk-engineering.org>
Documentation: pg-el can be installed via NonGNU ELPA --- README.md | 18 ++++++++++++------ doc/src/installation.md | 12 +++++++++++- 2 files changed, 23 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 99eac6e336..a90d9aec8b 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,7 @@ [](https://www.gnu.org/licenses/gpl-3.0.html) [](https://github.com/emarsden/pg-el/) [](https://melpa.org/#/pg) +[](https://elpa.nongnu.org/nongnu/pg.html) [](https://github.com/emarsden/pg-el/actions/) [](https://github.com/emarsden/pg-el/actions/) @@ -75,10 +76,10 @@ The following PostgreSQL-compatible databases have been tested: adds some features for compatibility with Oracle). Last tested 2025-04 with version 4.4. - The [Timescale DB](https://www.timescale.com/) extension for time series data, source available - but non open source. This works perfectly (last tested 2025-05 with version 2.19.3). + but non open source. This works perfectly (last tested 2025-07 with version 2.19.3). - The [CitusDB](https://github.com/citusdata/citus) extension for sharding PostgreSQL over multiple - hosts (AGPLv3 licence). Works perfectly (last tested 2025-05 with Citus version 13.0). + hosts (AGPLv3 licence). Works perfectly (last tested 2025-07 with Citus version 13.0). - The [OrioleDB](https://github.com/orioledb/orioledb) extension, which adds a new storage engine designed for better multithreading and solid state storage, works perfectly. Last tested 2025-07 @@ -144,7 +145,7 @@ The following PostgreSQL-compatible databases have been tested: - The [Materialize](https://materialize.com/) operational database (a proprietary differential dataflow database) has many limitations in its PostgreSQL compatibility: no support for primary keys, unique constraints, check constraints, for the `bit` type for example. It works with these - limitations with pg-el (last tested 2025-07 with Materialize v0.149). + limitations with pg-el (last tested 2025-07 with Materialize v0.150). - The [QuestDB](https://questdb.io/) time series database (Apache licensed) has very limited PostgreSQL support, and does not support the `integer` type for example. Last tested 2025-06 with @@ -184,7 +185,7 @@ The following PostgreSQL-compatible databases have been tested: PostgreSQL variants that **don't work** with pg-el: -- The ClickHouse database, whose PostgreSQL support is too limited. As of version 25.4 in 2025-06, +- The ClickHouse database, whose PostgreSQL support is too limited. As of version 25.6 in 2025-07, there is no implementation of the `pg_types` system table, no support for basic PostgreSQL-flavoured SQL commands such as `SET`, no support for the extended query mechanism. @@ -214,8 +215,13 @@ that enables access to PostgreSQL from Emacs by binding to the libpq library. ## Installation -Install via the [MELPA package archive](https://melpa.org/partials/getting-started.html) by -including the following in your Emacs initialization file (`.emacs.el` or `init.el`): +Install via the [NonGNU ELPA package archive](https://elpa.nongnu.org/) by running the command + + M-x package-install RET pg + +Alternatively, install via the [MELPA package +archive](https://melpa.org/partials/getting-started.html) by including the following in your Emacs +initialization file (`.emacs.el` or `init.el`): (require 'package) (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) diff --git a/doc/src/installation.md b/doc/src/installation.md index 1baa592645..6e789104bd 100644 --- a/doc/src/installation.md +++ b/doc/src/installation.md @@ -1,6 +1,16 @@ # Installation -You can install via the MELPA package archive, or with `package-vc-install`, or with `use-package`. +You can install via the NonGNU ELPA package archive, or via the MELPA package archive, or with +`package-vc-install`, or with `use-package`. + + +## Installing via NonGNU ELPA + +From Emacs, run + + M-x package-install RET pg + +to install the pg package from the [NonGNU ELPA](https://elpa.nongnu.org/) package archive. ## Installing via MELPA