[elpa] externals/eev b6940a2 02/10: Rewrote the section "The first line regenerates the buffer" in (find-links-intro).

[Stefan Monnier]

branch: externals/eev
commit b6940a291fe623130d5cfb1cd4baaabf3116b4cb
Author: Eduardo Ochs <address@hidden>
Commit: Eduardo Ochs <address@hidden>

    Rewrote the section "The first line regenerates the buffer" in 
(find-links-intro).
---
 ChangeLog    |  9 +++++++++
 VERSION      |  4 ++--
 eev-eval.el  | 19 +++++++++++++++++--
 eev-intro.el | 47 +++++++++++++++++++++++++++++++++++++++++++----
 4 files changed, 71 insertions(+), 8 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2f9bfed..cc8b562 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2019-06-16  Eduardo Ochs  <address@hidden>
+
+       * eev-intro.el (find-emacs-keys-intro): list `M-h M-k', `M-h M-f',
+       and `M-h M-p' among the basic keys of eev.
+       (find-links-intro): Rewrote the section "The first line
+       regenerates the buffer".
+
+       * eev-eval.el (ee-eval-sexp-eol): changes in the docstring.
+
 2019-06-12  Eduardo Ochs  <address@hidden>
 
        * eev-tlinks.el (find-latex-links): added more links to the
diff --git a/VERSION b/VERSION
index 0825568..2446a33 100644
--- a/VERSION
+++ b/VERSION
@@ -1,2 +1,2 @@
-Fri Jun 14 02:39:40 GMT 2019
-Thu Jun 13 23:39:40 -03 2019
+Sun Jun 16 17:04:37 GMT 2019
+Sun Jun 16 14:04:37 -03 2019
diff --git a/eev-eval.el b/eev-eval.el
index 8e4334e..ccadbcf 100644
--- a/eev-eval.el
+++ b/eev-eval.el
@@ -19,7 +19,7 @@
 ;;
 ;; Author:     Eduardo Ochs <address@hidden>
 ;; Maintainer: Eduardo Ochs <address@hidden>
-;; Version:    2019mar02
+;; Version:    2019jun16
 ;; Keywords:   e-scripts
 ;;
 ;; Latest version: <http://angg.twu.net/eev-current/eev-eval.el>
@@ -202,7 +202,22 @@ other: set EE-ARG to ARG and eval (ee-last-sexp)."
 
 (defun ee-eval-sexp-eol (&optional arg)
 "Go to the end of line, then run `ee-eval-last-sexp'.
-See: (find-eval-intro)"
+By default, evaluate sexp before eol, and print value in minibuffer.
+This is eev's variant of `C-e C-x C-e', and it can behave in
+several different ways depending on the prefix argument ARG.
+See: (find-eev-quick-intro \"`M-0 M-e'\")
+
+If ARG is:
+  nil:  evaluate the sexp with `debug-on-error' turned off
+    0:  highlight the sexp temporarily
+    1:  show the sexp as a string
+    2:  show the target of the sexp in another window
+    3:  same, but also switch to the new window
+    4:  evaluate the sexp in debug mode
+    5:  run the sexp with `debug-on-error' turned on
+    8:  eval then pretty-print the result in another buffer
+    9:  a hack for testing `call-interactively'
+other: set EE-ARG to ARG and eval (ee-last-sexp)."
   (interactive "P")
   (end-of-line)
   (ee-eval-last-sexp arg))
diff --git a/eev-intro.el b/eev-intro.el
index 8c4c83e..ea493d3 100644
--- a/eev-intro.el
+++ b/eev-intro.el
@@ -19,7 +19,7 @@
 ;;
 ;; Author:     Eduardo Ochs <address@hidden>
 ;; Maintainer: Eduardo Ochs <address@hidden>
-;; Version:    2019jun10
+;; Version:    2019jun16
 ;; Keywords:   e-scripts
 ;;
 ;; Latest version: <http://angg.twu.net/eev-current/eev-intro.el>
@@ -1739,6 +1739,13 @@ The keys for creating \"hyperlinks to here\" and 
refining them are:
             See also: (find-refining-intro \"2. Refining hyperlinks\")
                       (find-refining-intro \"4. A tip for beginners\")
 
+Some other keys that create buffers with elisp hyperlinks:
+  M-h M-k   - (find-eev \"eev-elinks.el\" \"find-ekey-links\")
+  M-h M-f   - (find-eev \"eev-elinks.el\" \"find-efunction-links\")
+  M-h M-p   - (find-eev-quick-intro \"11.1. `find-pdf-links'\")
+    See also: (find-links-intro \"5. The first line regenerates the buffer\")
+
+
 
 2. Key sequences and how to abort them
 ======================================
@@ -3215,7 +3222,7 @@ hyperlinks in scripts]
 
 (defun find-links-conv-intro (&rest pos-spec-list) (interactive)
   (let ((ee-buffer-name "*(find-links-conv-intro)*"))
-    (apply 'find-estring "\
+    (apply 'find-eintro "\
 \(Re)generate: (find-links-conv-intro)
 Source code:  (find-efunction 'find-links-conv-intro)
 More intros:  (find-eev-quick-intro)
@@ -3900,8 +3907,39 @@ Try this, with `M-2 M-e' on each line:
 
 5. The first line regenerates the buffer
 ========================================
-\[To do: explain this convention with examples; explain the
-conventions for the \"variants of the first line\"\]
+Most of the \"M-h commands\" generate buffers with elisp
+hyperlinks in which the the first line \"regenerates the
+buffers\". This means two things:
+
+  1. You can copy the first to your notes, and it will work as a
+     link to that buffer. For example:
+
+     (find-efunction 'next-line)
+     (find-evariable 'line-move-visual)
+     (find-latex-links \"/tmp/mytest\")
+     (find-latex-links \"~/latextest\")
+     (find-code-pdf-links 
\"/usr/local/texlive/2019/texmf-dist/doc/asymptote/\")
+     (find-code-pdf-links 
\"/usr/local/texlive/2019/texmf-dist/doc/asymptote/\" \"{c}\")
+     (find-code-pdf-links 
\"/usr/local/texlive/2019/texmf-dist/doc/asymptote/\" \"asy\")
+
+     A good way to compare the results of the two
+     `find-latex-links' and the three `find-code-pdf-links' sexps
+     above is to run them with `M-2 M-e'. The prefix `M-2' to
+     `M-e' makes the \"target\" of a sexp be displayed in a
+     second window without switching to it. See:
+
+       (find-efunctiondescr 'ee-eval-sexp-eol)
+       (find-multiwindow-intro \"find-2a\")
+
+  2. You can change the arguments of the sexp in the first line
+     and run it again, and this will regenerate the buffer with
+     some modifications. This was explained here:
+
+     (find-eev-quick-intro \"7.5. `find-latex-links'\" \"change the 
\\\"{stem}\\\"\")
+     (find-eev-quick-intro \"11.1. `find-pdf-links'\" \"adjust by hand\")
+
+\[To do: explain how this works in more complex templates.
+Example:\]
 
   (find-find-links-links)
   (find-find-links-links \"\\\\M-u\")
@@ -3912,6 +3950,7 @@ conventions for the \"variants of the first line\"\]
 
 
 
+
 6. Pointing to where we are now
 ===============================
 Several of the `M-h' commands are mainly meant to help us