DOC: describe the Top-level Menu and signaling in the manual

* README.org:
- The Top-level Menu buffer: new section.
- Sending signals to running top-levels: new section.

ADDED: key and menu bindings for sweeprolog-list-top-levels

* sweeprolog.el:
- sweeprolog-prefix-map: bind sweeprolog-list-top-levels to T
- sweeprolog-menu: add menu entry for sweeprolog-list-top-levels

ADDED: new command for signaling a top-level from the Top-level Menu

* sweeprolog.el:
- sweeprolog-top-level-menu-signal: new command
- sweeprolog-top-level-menu-mode-map: bind it to s

ADDED: new command for signaling the current top-level

* sweeprolog.el:
- sweeprolog-top-level-signal-current: new command
- sweeprolog-top-level-mode-map: bind it to C-c C-c

FIXED: top-level buffer to thread synchronization

ADDED: new command for signaling Prolog top-level threads

* sweep.pl: sweep_thread_signal/2: new predicate.

* sweeprolog.el:
- sweeprolog-signal-thread: new function, Elisp interface for
sweep_thread_signal/2.
- sweeprolog-top-level-thread-id: new buffer-local variable in
sweeprolog-top-level buffers.
- sweeprolog-top-level-signal: new command.
- sweeprolog-top-level-mode: signal top-level thread with
thread_exit/1 when buffer is killed.

FIXED: reverse args modes in sweeprolog-document-predicate-at-point

ADDED: sweep Top-level Menu for listing Prolog top-levels

* sweep.pl
- sweep_top_level_threads/2: new predicate for querying
currently active Prolog top-level threads

* sweeprolog.el
- sweeprolog-top-level-menu--entries: new function, exposing
sweep_top_level_threads/2 to Elisp.
- sweeprolog-top-level-menu-mode: new major mode derived from
tabulated-list-mode
- sweeprolog-top-level-menu-go-to: new command, switches to the
top-level buffer of the Top-level Menu entry at point
- sweeprolog-top-level-menu-kill: new command, kills the top-level
buffer of the Top-level Menu entry at point
- sweeprolog-top-level-menu-new: new command, creates a new top-level
from the Top-level Menu
- sweeprolog-list-top-levels: new command, opens the Top-level Menu

NEWS.org: announce sweeprolog-document-predicate-at-point

README.org: fix typos

DOC: Add docstrings to some undocumented internal functions

DOC: new manual section "Documenting predicates"

ADDED: new command sweeprolog-document-predicate-at-point

ADDED: new function sweeprolog-definition-at-point

DOC: document new eldoc integration

ADDED: on-the-fly documentation for predicates with eldoc

ADDED: auto-insert integration for filling in Prolog module headers

* sweeprolog-module-header-comment-skeleton: new user option

FIXED: clear highlighting from whitespace after a fullstop

NEWS.org: remove version macro using internal package-desc-version

FIXED: error when indenting after prefix operator

DOC: say sweep-module instead of sweeprolog-module in the manual

DOC: add missing source block in Getting Started section

DOC: Added "Getting Started" manual section

ADDED: Menu for sweep commands

DOC: add a reference to the SWI-Prolog manual QQ section

ENHANCED: provide semantic highlighting for missing term kinds

DOC: document quasi-quotation highlighting in the manual

ENHANCED: fontify quasi-quotation content according to its type

* sweeprolog-qq-mode-alist: new user option
* (sweeprolog--colour-term-to-faces): use it

FIXED: error on interactively removing variable highlighting

DOC: document new variable highlighting in the manual

ADDED: new command sweeprolog-highlight-variable

* (sweeprolog-highlight-variable): New command
* (sweeprolog-cursor-sensor-functions): use it

ADDED: new user option sweeprolog-enable-cursor-sensor

* sweeprolog-enable-cursor-sensor: New option
* (sweeprolog-mode): use it

ENHANCED: underline occurrences of the variable at point

DOC: add installation instructions from NonGNU ELPA

Use a public mailing list in the Maintainer package header

ENHANCED: More indicative error on failure to locate sweep-module

ENHANCED: only fontify visible sweeprolog-mode buffers on idle

ENHANCED: (sweep--colour-term-to-face): return multiple regions

DOC: document the newly added sweeprolog-restart command

ADDED: new command sweeprolog-restart for resetting sweep

* (sweeprolog-init): new &rest args
* (sweeprolog-restart): new command
* sweeprolog-prefix-map: bind it

FIXED: remove message_hook during cleanup to avoid possible crash

MODIFIED: Breaking change: rename sweep.el to sweeprolog.el...

...and replace the `sweep-` prefix for all symbols with `sweeprolog-`.

This follows a request from RMS and Philip Kaludercic on the
emacs-devel mailing list to make the name of the Emacs package more
indicative.

FIXED: don't rely on string-lines added in Emacs 28.1

FIXED: use a more robust mechanism for finding sweep-module

Update LICENSE

DOC: update installation instruction to reflect inclusion in swipl

DOC: fix typos in README.org

DOC: document imenu support in sweep-mode buffers

ADDED: support imenu in sweep-mode buffers

ENHANCED: also update highlighting between sub terms

ADDED: sweep-mode: make sexp-based commands work on Prolog terms

This includes forward-sexp (C-M-f), transpose-sexps (C-M-t), etc.

DOC: fix copy-paste error in README.org

DOC: document new user option sweep-faces-style

Tweak README to prevent a hosting platform from failing to render it

ADDED: sweep-faces-style user option for controlling highlighting

sweep.el: remove outdated sweep--compile-module function

Find Emacs as `emacs`

FIXED: qualify calls to sweep_funcall/2

FIXED: sweep-init-args separate arguments

FIXED: indentation error when typing at end of buffer

BUILD: replaced Makefile with CMakeLists.txt

BUILD: rely on preexisting emacs-module.h

BUILD: Inline sweep.h in sweep.c

New make target: make info

ADDED: new user option for choosing indentation increments

* sweep.el:
** sweep-indent-offset: new user option
** (sweep-indent-line): use it

* README.org: document new indentation engine

ENHANCHED: automatic syntax aware autoindentation in sweep-mode

ADDED: sweep_op_info/2: new_predicate

FIXED: handle some more color terms

FIXED: (sweep--colourise): handle the dict_content color term

PORT: use (eql sweep) instead of (eql 'sweep) in cl-defmethods...

...for compatibility with Emacs 27

FIXED: (sweep-beginning-of-top-term): possible infinite loop

FIXED: package-lint complaint about autoloaded private function

DOC: update commentary section in sweep.el

DOC: Add Top-level history section

FIXED: indentation after with inline comments

ENHANCED: don't record one-character inputs in the top level history

ADDED: sweep-colourise-buffer-on-idle user option, on by default

ENHANCED: Update semantic highlighting on idle timer in sweep-mode

(sweep-colourise-buffer-max-size): new user option
(sweep-colourise-buffer-min-interval): new user option
(sweep-mode): setup highlighting on idle timer

ADDED: (sweep-indent-line-ends-with-prefix-operator): New function

(sweep-indent-line-indentation): use it

ADDED: (sweep-prefix-operators): New function

Makefile: Allow specifying the path to emacs

Running emacs on macOS, the emacs binary is inside the app bundle, not
on the path, so it's useful to be able to specify it.

Makefile: Use "--batch" instead of "-batch" for consistency

DOC: README.org: add ^:{} option

PORT: don't depend on pos-bol added in Emacs 29

DOC: Following file specifications: new section

ADDED: (sweep-mode-map): bind C-c C-o to sweep-find-file-at-point

ADDED: (sweep-find-file-at-point): new function

(sweep-mode): add sweep-file-at-point to file-name-at-point-functions
buffer locally.

ADDED: (sweep-file-at-point): new function

DOC: NEWS.org: new file

sweep.el: bump Package-Version to 0.2.0

PORT: sweep.el: require Emacs version 28 for RTLD_GLOBAL

DOC: Loading buffers: new section

ENHANCED: (sweep-load-buffer): report results

FIXED: (sweep-load-buffer): error after prompting for a buffer

FIXED: sweep_load_buffer/3: load files in the context of "user"

ENHANCED: (sweep-load-buffer): use read-buffer to choose a buffer

ADDED: sweep-load-buffer

FIXED: sweep_predicates_collection/2: include preds defined in user

FIXED: premature cut in sweep_predicate_location/2

ENHANCED: Display message if unable to find predicate location