From be195d894fa078d262d663ffdc8fdbf1a64ddee7 Mon Sep 17 00:00:00 2001
From: Eshel Yaron <me@eshelyaron.com>
Date: Thu, 17 Aug 2023 23:47:35 +0200
Subject: [PATCH] Announce Compat dependency and bump version to 0.23.0

* NEWS.org (Version 0.23.0 on 2023-08-18): New entry.
* README.org (Installation): Reword.
* sweeprolog.el: Bump minor version.
---
 NEWS.org      | 10 ++++++++++
 README.org    | 38 +++++++++++++++++---------------------
 sweeprolog.el |  2 +-
 3 files changed, 28 insertions(+), 22 deletions(-)

diff --git a/NEWS.org b/NEWS.org
index 55f2133..99500c2 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -11,6 +11,16 @@ SWI-Prolog in Emacs.
 For further details, please consult the manual:
 [[https://eshelyaron.com/sweep.html][https://eshelyaron.com/sweep.html]].
 
+* Version 0.23.0 on 2023-08-18
+
+** Sweep now requires Compat, the forward-compatibility library for Elisp
+
+This version introduces a dependency of Sweep on Compat, the
+forward-compatibility library for Elisp available from GNU ELPA.
+Compat provides implementations of newer Elisp functions and features
+for older Emacs versions, and Sweep now makes use of it for improved
+backward compatibility and ease of maintenance.
+
 * Version 0.22.2 on 2023-08-14
 
 ** Fix potential crash due to a collision between Xwidgets and XPCE
diff --git a/README.org b/README.org
index 09ef6b1..2daaa77 100644
--- a/README.org
+++ b/README.org
@@ -116,32 +116,28 @@ won't work with other Prolog systems.
 :ALT_TITLE: Installation
 :END:
 
-#+CINDEX: install
-The dynamic Emacs module =sweep-module= is included with SWI-Prolog
-versions 8.5.18 and later.  For instructions on how to build and
-install SWI-Prolog, see [[https://www.swi-prolog.org/build/]].
-
-The =sweeprolog= Elisp package is available on NonGNU ELPA, to install
-=sweeprolog= simply type =M-x package-install RET sweeprolog RET=.
+#+CINDEX: requirements
+Installing Sweep requires:
 
-An alternative to installing from ELPA is to get the Elisp library
-from the Sweep Git repository:
+- Emacs 27 or later, and
+- SWI-Prolog 8.5.18 or later.
 
-1. Clone the Sweep repository:
-   #+begin_src sh
-     git clone https://git.sr.ht/~eshel/sweep
-   #+end_src
+#+CINDEX: install
+Sweep is available from NonGNU ELPA, to install it simply type in
+Emacs ~M-x package-install RET sweeprolog RET~.
 
-   Or:
+Note that in Emacs prior to version 28, you need to explicitly enable
+NonGNU ELPA by adding something like the following to your Emacs
+configuration:
 
-   #+begin_src sh
-     git clone https://github.com/SWI-Prolog/packages-sweep sweep
-   #+end_src
+#+begin_src emacs-lisp
+  (with-eval-after-load 'package
+    (add-to-list 'package-archives '("nongnu" . "https://elpa.nongnu.org/nongnu/")))
+#+end_src
 
-2. Add Sweep to Emacs's =load-path=:
-   #+begin_src emacs-lisp
-     (add-to-list 'load-path "/path/to/sweep")
-   #+end_src
+#+CINDEX: update
+#+CINDEX: upgrade
+To upgrade Sweep to a newer version, do ~M-x package-upgrade sweeprolog RET~.
 
 * Getting Started
 :PROPERTIES:
diff --git a/sweeprolog.el b/sweeprolog.el
index 2036a03..b3e7d32 100644
--- a/sweeprolog.el
+++ b/sweeprolog.el
@@ -6,7 +6,7 @@
 ;; Maintainer: Eshel Yaron <~eshel/dev@lists.sr.ht>
 ;; Keywords: prolog languages extensions
 ;; URL: https://git.sr.ht/~eshel/sweep
-;; Package-Version: 0.22.2
+;; Package-Version: 0.23.0
 ;; Package-Requires: ((emacs "27.1") (compat "29.1.4.2"))
 
 ;; This file is NOT part of GNU Emacs.
-- 
2.39.5