[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] scratch/ediprolog 8ba8786386 18/31: clarify installation
From: |
Stefan Monnier |
Subject: |
[elpa] scratch/ediprolog 8ba8786386 18/31: clarify installation |
Date: |
Sun, 2 Oct 2022 17:01:38 -0400 (EDT) |
branch: scratch/ediprolog
commit 8ba8786386a90285cfd2a39bdb763f87422ebd6c
Author: Markus Triska <triska@metalevel.at>
Commit: Markus Triska <triska@metalevel.at>
clarify installation
---
README.md | 38 ++++++++++++++++++++++----------------
1 file changed, 22 insertions(+), 16 deletions(-)
diff --git a/README.md b/README.md
index c48fcfd061..03a9b21c91 100644
--- a/README.md
+++ b/README.md
@@ -17,32 +17,30 @@ Emacs's built-in *package manager* via the key
sequence:
M-x package-install RET ediprolog RET
Alternatively, copy [ediprolog.el](ediprolog.el) to your `load-path`
-and add to your `.emacs`:
+and add the following form to your `.emacs`, then evaluate the form or
+restart Emacs:
(require 'ediprolog)
- (global-set-key [f10] 'ediprolog-dwim)
-Restart Emacs and customize ediprolog with
+After you have installed ediprolog, you can customize it with:
M-x customize-group RET ediprolog RET
-# Screenshot
+# Usage
-Here is a sample interaction, using
-[CLP(FD) constraints](https://www.metalevel.at/prolog/clpfd) to
-relate a number to its factorial:
+The central function is `ediprolog-dwim` (Do What I Mean). I recommend
+to bind it to the function key F10 by adding the following
+form to your `.emacs` and evaluating it:
-![Factorial](factorial.png)
+ (global-set-key [f10] 'ediprolog-dwim)
-# Usage
+In the following, I assume that you have also done this.
-The central function is `ediprolog-dwim` (Do What I Mean), which is
-bound to F10 by the snippet above. Depending on the content at
-point, `ediprolog-dwim` does the "appropriate" thing: If point is
-on a *query*, F10 sends the query to a Prolog process, and you
-interact with the process in the current buffer as on a terminal.
-Queries start with "?-" or ":-", possibly preceded by "%" and
-whitespace. An example of a query is:
+Depending on the content at point, `ediprolog-dwim` does the
+"appropriate" thing: If point is on a *query*, it sends the query to a
+Prolog process, and you interact with the process in the current
+buffer as on a terminal. Queries start with "?-" or ":-", possibly
+preceded by "%" and whitespace. An example of a query is:
%?- member(X, [a,b,c]).
@@ -83,3 +81,11 @@ processes simultaneously. Revert with
| C-u C-u F10 | like C-u F10, with a new process |
Tested with SWI-Prolog 5.6, 6.6 and 7.2 + Emacs 21.2, 22.3, 23.1 and 24.3.
+
+# Screenshot
+
+Here is a sample interaction, using
+[CLP(FD) constraints](https://www.metalevel.at/prolog/clpfd) to
+relate a number to its factorial:
+
+![Factorial](factorial.png)
- [elpa] scratch/ediprolog 29a8c4a796 03/31: wording for README, (continued)
- [elpa] scratch/ediprolog 29a8c4a796 03/31: wording for README, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 277d0f9e72 05/31: add screenshot, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog ade75de9ae 07/31: table formatting, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 51a610ebc2 08/31: formatting and layout of Emacs commands, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 1c8b127701 02/31: initial revision, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog f1b2480f46 12/31: preparing version 1.2, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 2b348c3161 15/31: describe screenshot, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 9c4c80ad4a 21/31: improve compatibility with older Emacs versions, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog e75c0ddfc4 30/31: Merge Jun 8 2020 commit '751119cfee9' into externals/ediprolog, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 751119cfee 22/31: update Scryer Prolog answer, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 8ba8786386 18/31: clarify installation,
Stefan Monnier <=
- [elpa] scratch/ediprolog 5fd08fe19a 23/31: improve compatibility with older Emacs versions, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog ebd79c0abd 26/31: enable faithful processing of multiline queries for Scryer Prolog, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 6f94bf2368 19/31: add link to video, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 8b554e63aa 24/31: document Scryer Prolog default setting, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 4b265d2fb5 09/31: add a note distinguishing buffer content and file, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 3f8ab3eea0 10/31: wording, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog dc0e51ba57 29/31: ediprolog 2.2: support newer Scryer Prolog versions, and smaller improvements, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 34f7aa545c 04/31: transition to markdown, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 943f7c2a48 01/31: initial revision, Stefan Monnier, 2022/10/02
- [elpa] scratch/ediprolog 68024b9f08 13/31: point to further information, Stefan Monnier, 2022/10/02