[elpa] externals/eev 3f6b3ee 2/2: Merge remote-tracking branch 'eev/UTF-8' into externals/eev

[Stefan Monnier]

branch: externals/eev
commit 3f6b3ee456082334d8c2270cb6c52405e653ba3f
Merge: 9f8dcbe 29821d3
Author: Stefan Monnier <monnier@iro.umontreal.ca>
Commit: Stefan Monnier <monnier@iro.umontreal.ca>

    Merge remote-tracking branch 'eev/UTF-8' into externals/eev
---
 ChangeLog     |  17 +++++++++
 VERSION       |   4 +-
 eev-blinks.el |   3 +-
 eev-edit.el   |   3 +-
 eev-elinks.el |   6 ++-
 eev-intro.el  | 118 ++++++++++++++++++++++++++++++++++++++++++++++++++++++----
 eev-mode.el   |   9 +++--
 7 files changed, 142 insertions(+), 18 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2235855..8ed98cd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,20 @@
+2020-10-02  Eduardo Ochs  <eduardoochs@gmail.com>
+
+       * eev-intro.el (find-psne-intro): added two new sections, one on
+       `ee-flip-psne-ness' and another one on the origin of the name
+       "psne".
+
+       * eev-mode.el (eev-mode-map-set): Commented out the binding of
+       `M-s' to `ee-flip-psne-ness'.
+
+       * eev-blinks.el (ee-find-eejumps-header): added a link to the
+       header.
+
+2020-09-29  Eduardo Ochs  <eduardoochs@gmail.com>
+
+       * eev-intro.el (find-eev-quick-intro): added an item about the
+       menu bar to the section "4.2. `find-ekey-links' and friends".
+
 2020-09-28  Eduardo Ochs  <eduardoochs@gmail.com>
 
        * eev-intro.el (find-elisp-intro): new function.
diff --git a/VERSION b/VERSION
index 08d87b5..9b43c11 100644
--- a/VERSION
+++ b/VERSION
@@ -1,2 +1,2 @@
-Mon Sep 28 19:32:02 GMT 2020
-Mon Sep 28 16:32:02 -03 2020
+Sun Oct  4 09:22:54 GMT 2020
+Sun Oct  4 06:22:54 -03 2020
diff --git a/eev-blinks.el b/eev-blinks.el
index 92770cd..1da7bf3 100644
--- a/eev-blinks.el
+++ b/eev-blinks.el
@@ -21,7 +21,7 @@
 ;;
 ;; Author:     Eduardo Ochs <eduardoochs@gmail.com>
 ;; Maintainer: Eduardo Ochs <eduardoochs@gmail.com>
-;; Version:    2019oct16
+;; Version:    2020oct02
 ;; Keywords:   e-scripts
 ;;
 ;; Latest version: <http://angg.twu.net/eev-current/eev-blinks.el>
@@ -980,6 +980,7 @@ Hint: install the Debian package \"unicode-data\".")
 (defun ee-find-eejumps-header ()
   ";; Generated by: (find-eejumps)
 ;; See: (find-eev-quick-intro \"7.1. `eejump'\" \"`M-j'\")
+;;      (find-eev-quick-intro \"7.2. The list of eejump targets\")
 ;;      (find-emacs-keys-intro \"1. Basic keys (eev)\")
 ;;      (find-emacs-keys-intro \"2. Key sequences\")
 ;; For example,
diff --git a/eev-edit.el b/eev-edit.el
index 218467f..265401f 100644
--- a/eev-edit.el
+++ b/eev-edit.el
@@ -200,8 +200,7 @@ A \"tag\" is the string between \"«»\"s in an anchor."
 ;;
 ;; «ee-flip-psne-ness» (to ".ee-flip-psne-ness")
 ;; (define-key eev-mode-map "\M-s" 'ee-flip-psne-ness)
-
-;; (find-eevfile "eev-insert.el" "defun ee-ill")
+;; See: (find-psne-intro "6. `ee-flip-psne-ness'")
 
 (defun ee-flip-psne-ness ()
   (interactive)
diff --git a/eev-elinks.el b/eev-elinks.el
index 66cd354..edcd91d 100644
--- a/eev-elinks.el
+++ b/eev-elinks.el
@@ -1117,14 +1117,16 @@ This needs a temporary directory; see: 
(find-prepared-intro)"
 ;;;                              |_|                         |___/             
 
 ;;
 ;; «find-epackage-links»  (to ".find-epackage-links")
-;; Tests: (find-epackage-links "eev")
+;; Skel:  (find-find-links-links-new "epackage" "pkgname" "")
+;; Tests: (find-epackage-links "0x0")
 ;;        (find-estring (ee-find-epackage-links0 "0x0"))
 ;;
 (defun find-epackage-links (&optional pkgname &rest pos-spec-list)
 "Visit a temporary buffer containing hyperlinks for an Emacs package."
   (interactive)
   (setq pkgname (or pkgname "{pkgname}"))
-  (apply 'find-elinks
+  (apply
+   'find-elinks
    `((find-epackage-links ,pkgname ,@pos-spec-list)
      ;; Convention: the first sexp always regenerates the buffer.
      (find-efunction 'find-epackage-links)
diff --git a/eev-intro.el b/eev-intro.el
index 59d0aa1..90fc7c5 100644
--- a/eev-intro.el
+++ b/eev-intro.el
@@ -19,7 +19,7 @@
 ;;
 ;; Author:     Eduardo Ochs <eduardoochs@gmail.com>
 ;; Maintainer: Eduardo Ochs <eduardoochs@gmail.com>
-;; Version:    2020sep28
+;; Version:    2020oct04
 ;; Keywords:   e-scripts
 ;;
 ;; Latest version: <http://angg.twu.net/eev-current/eev-intro.el>
@@ -285,16 +285,28 @@ The quickest way to open or recreate this is with `M-5 
M-j'.
 
 This is a tutorial for real beginners.
 It supposes that you have Emacs installed.
-You may start by watching these (old) videos:
+For more material on eev, see:
 
-  http://angg.twu.net/eev-videos/video-eev-quick-0.mp4  (installation basics)
-  http://angg.twu.net/eev-videos/video4-eepitch.mp4     (eev's main ideas)
+  http://angg.twu.net/#eev
 
 
 
 
 1. Installing eev
 =================
+The easiest way to install eev is with `M-x list-packages', as
+explained in this video:
+
+  http://www.youtube.com/watch?v=kxBjiUo88_U
+  http://angg.twu.net/eev-videos/M-x-list-packages-eev-nav.mp4
+
+To activate eev-mode and open this tutorial, run `M-x beginner'.
+
+An alternative way, that only works on *NIX-based systems, is shown in
+this video (from 2016!):
+
+  http://angg.twu.net/eev-videos/video-eev-quick-0.mp4
+
 Open the page at
 
   http://angg.twu.net/eev-intros/find-eev-quick-intro.html
@@ -328,7 +340,7 @@ Every time that Emacs gets stuck into something that you 
don't know
 how to leave, or how to undo, you should kill the Emacs window and
 start it again by typing \"~/eev\" again in the shell prompt.
 
-Eventually you will learn how go get out of everything and how to undo
+Eventually you will learn how to get out of everything and how to undo
 almost anything, _BUT THAT WILL NOT HAPPEN IN THE FIRST TEN MINUTES_.
 This tutorial is intended to make you learn the most essential things
 in the first ten minutes - including how to navigate in Emacs's
@@ -623,6 +635,28 @@ You will notice that:
      point to relevant points in the Emacs manuals - see the next
      section.
 
+  8. `M-h M-k' can also handle some sequences of input events
+     that are not key sequences. For example, if you click
+     on \"Help\" in the menu bar and then click on \"Search
+     Documentation\" and then on \"Emacs Terminology\" in the
+     submenus this will open this page of the Emacs manual:
+
+       (find-enode \"Glossary\")
+
+     If you do `M-h M-k' and then click on Help -> Search
+     Documentation -> Emacs Terminology in the menu bar then `M-h
+     M-k' will generate a buffer in which one of the first lines
+     will be:
+
+       (eek \"M-h M-k  <menu-bar> <help-menu> <search-documentation> 
<emacs-terminology>\")
+
+     For more information on that see:
+
+       (find-enode  \"Menu Bar\")
+       (find-enode  \"Glossary\" \"\\nInput Event\")
+       (find-elnode \"Input Events\")
+       (find-elnode \"Key Sequence Input\" \"menu-bar\")
+
 
 
 
@@ -1054,6 +1088,7 @@ The header is this:
 
   ;; Generated by: (find-eejumps)
   ;; See: (find-eev-quick-intro \"7.1. `eejump'\" \"`M-j'\")
+  ;;      (find-eev-quick-intro \"7.2. The list of eejump targets\")
   ;;      (find-emacs-keys-intro \"1. Basic keys (eev)\")
   ;;      (find-emacs-keys-intro \"2. Key sequences\")
   ;; For example,
@@ -6999,7 +7034,6 @@ It is meant as both a tutorial and a sandbox.
 
 
 
-Note: this intro is being rewritten!
 We mentioned briefly in
 
   (find-pdf-like-intro \"2. Preparation\")
@@ -7067,8 +7101,8 @@ its directory and save its name into the file 
\"~/.psne.log\".
 
 
 
-3. The new way: M-x brep
-========================
+3. The new way: `M-x brep'
+==========================
 Try to run this:
 
   (find-psne-links \"http://www.gnu.org/software/emacs/emacs-paper.html\";)
@@ -7089,6 +7123,7 @@ used to do.
 
 
 
+
 4. The environment variable $S
 ==============================
 If when eev is loaded by Emacs the environment variable $S is
@@ -7165,6 +7200,73 @@ The details on how to create these \"brxxx functions\" 
are here:
 
   (find-brxxx-intro)
 
+
+
+
+
+6. `ee-flip-psne-ness'
+======================
+Converting a \"non-psne URL\" to a \"psne URL\" by hand, like this,
+
+      https://tannerlectures.utah.edu/_documents/a-to-z/c/Coetzee99.pdf
+  -> $S/https/tannerlectures.utah.edu/_documents/a-to-z/c/Coetzee99.pdf
+
+is error-prone and boring.
+
+Eev implements a command to do that, that works in both directions -
+it is called `ee-flip-psne-ness', and it searches for the next
+non-psne-or-psne URL and it \"flips its psne-ness\": it converts
+non-psne URLs to psne URLs and psne URLs to non-psne URLs. 
+
+To try it you will have to run this:
+
+  (define-key eev-mode-map \"\\M-s\" 'ee-flip-psne-ness)
+
+because most people prefer to use the key `M-s' for their other
+things. Then try it by putting the cursor here and typing `M-s' four
+times. Watch the four psne-nesses below flip.
+
+   https://tannerlectures.utah.edu/_documents/a-to-z/c/Coetzee99.pdf
+  $S/https/tannerlectures.utah.edu/_documents/a-to-z/c/Coetzee99.pdf
+   http://www.gnu.org/software/emacs/emacs-paper.html
+  $S/http/www.gnu.org/software/emacs/emacs-paper.html
+
+
+
+
+
+7. A historical note
+====================
+I wrote the first versions of \"psne\" in the late 1990s. At that point
+I was using a program called \"snarf\" to fetch files from the internet
+using FTP and HTTP, and I thought that it was natural to store the
+files downloaded with snarf into the directory \"~/snarf/\". Later I
+changed from snarf to wget, but I kept the directory as \"~/snarf/\".
+
+I tried using several languages for the part that converted a url into
+a directory. I still have the notes from my attempts to use Tcl and
+Awk to do that - but at one point I managed to write a script in Perl
+that was good enough and I stuck to that.
+
+The shell function that I could call as
+
+  psne      $S/http/www.gnu.org/software/emacs/emacs-paper.html
+
+and it would run the fours steps in
+
+  mkdir -p http://www.gnu.org/software/emacs/
+  cd       http://www.gnu.org/software/emacs/
+  wget      $S/http/www.gnu.org/software/emacs/emacs-paper.html
+  echo     'http://www.gnu.org/software/emacs/emacs-paper.html' >> ~/.psne.log
+
+was called \"psne\" because it used a Perl script to obtain the
+directory name, then it ran \"snarf\" (later \"wget\"), and it \"echo\"ed
+the URL to the end of a log file. So \"p-sn-e\".
+
+
+
+
+
 " rest)))
 
 ;; (find-enode "Command Index" "browse-url")
diff --git a/eev-mode.el b/eev-mode.el
index ea9adf8..a897a22 100644
--- a/eev-mode.el
+++ b/eev-mode.el
@@ -1,6 +1,6 @@
 ;;; eev-mode.el -- a minor mode with keybindings for using eev conveniently.
 
-;; Copyright (C) 2012-2019 Free Software Foundation, Inc.
+;; Copyright (C) 2012-2020 Free Software Foundation, Inc.
 ;;
 ;; This file is part of GNU eev.
 ;;
@@ -19,7 +19,7 @@
 ;;
 ;; Author:     Eduardo Ochs <eduardoochs@gmail.com>
 ;; Maintainer: Eduardo Ochs <eduardoochs@gmail.com>
-;; Version:    2020feb20
+;; Version:    2020oct02
 ;; Keywords:   e-scripts
 ;;
 ;; Latest version: <http://angg.twu.net/eev-current/eev-mode.el>
@@ -152,7 +152,10 @@ and: (find-eval-intro \"`M-k'\")"
   (define-key eev-mode-map "\M-h\M--" 'ee-shrink-hyperlink-at-eol)
   ;;
   ;; These ones are also from: (find-eev "eev-edit.el")
-  (define-key eev-mode-map "\M-s" 'ee-flip-psne-ness)
+  ;; See: (find-psne-intro "6. `ee-flip-psne-ness'")
+  ;;   (find-eev "eev-edit.el" "ee-flip-psne-ness")
+  ;;
+  ;; (define-key eev-mode-map "\M-s" 'ee-flip-psne-ness)
   (define-key eev-mode-map "\M-I" 'eewrap-vldi-list-line)
   ;;
   ;; Obsolete: