DOC: Added "Getting Started" manual section

diff --git a/README.org b/README.org
index a66a40f1507315ae4d30506682b5d03a70c791b8..8c83fcc858cb94a48e1ce7b207df1907db949f00 100644 (file)
--- a/README.org
+++ b/README.org
@@ -95,10 +95,27 @@ from the =sweep= Git repository:
      (add-to-list 'load-path "/path/to/sweep")
    #+end_src
 
-3. Load =sweep= into Emacs:
-   #+begin_src emacs-lisp
-     (require 'sweeprolog)
-   #+end_src
+* Getting started
+:PROPERTIES:
+:CUSTOM_ID: getting-started
+:END:
+
+After installing the =sweeprolog= Elisp library, load it into Emacs:
+
+#+begin_src emacs-lisp
+  (require 'sweeprolog)
+#+end_src
+
+All set!  =sweeprolog= automatically loads =sweep-module= and initializes
+the embedded SWI-Prolog runtime.  For a description of the different
+features of =sweep=, see the following sections of this manual.
+
+_Important note for Linux users_: prior to version 29, Emacs would load
+dynamic modules in a way that is not fully compatible with the way the
+SWI-Prolog native library, =libswipl=, loads its own native extensions.
+This may lead to =sweep= failing after loading =sweep-module=.  To work
+around this issue, users running Emacs 28 or earlier on Linux can
+start Emacs with =libswipl= loaded upfront via =LD_PRELOAD=, for example:
 
 * Prolog initialization and cleanup
 :PROPERTIES:

diff --git a/sweeprolog.el b/sweeprolog.el
index 0a6f6bb1b1a359c72c20d652f1ca26bd2c70326a..a9243793b798a76ff51272a24c832c046fb262f3 100644 (file)
--- 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.4.3
+;; Package-Version: 0.4.4
 ;; Package-Requires: ((emacs "28"))
 
 ;; This file is NOT part of GNU Emacs.