[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/eev 6f81e8e 2/2: Rewrote the section "1. Installing eev
From: |
Stefan Monnier |
Subject: |
[elpa] externals/eev 6f81e8e 2/2: Rewrote the section "1. Installing eev" in `(find-eev-quick-intro)'. |
Date: |
Tue, 4 May 2021 08:18:56 -0400 (EDT) |
branch: externals/eev
commit 6f81e8e2a5f152a0c34b8d356b53b9e258fc2bf3
Author: Eduardo Ochs <eduardoochs@gmail.com>
Commit: Eduardo Ochs <eduardoochs@gmail.com>
Rewrote the section "1. Installing eev" in `(find-eev-quick-intro)'.
---
VERSION | 4 +-
eev-intro.el | 142 ++++++++++++++++++++++++++++++++++++++++++-----------------
2 files changed, 103 insertions(+), 43 deletions(-)
diff --git a/VERSION b/VERSION
index 307b43f..720904b 100644
--- a/VERSION
+++ b/VERSION
@@ -1,2 +1,2 @@
-Fri Apr 23 06:36:02 GMT 2021
-Fri Apr 23 03:36:02 -03 2021
+Tue May 4 07:48:51 GMT 2021
+Tue May 4 04:48:52 -03 2021
diff --git a/eev-intro.el b/eev-intro.el
index 6415e3c..7275fc3 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: 2021apr23
+;; Version: 2021may04
;; Keywords: e-scripts
;;
;; Latest version: <http://angg.twu.net/eev-current/eev-intro.el>
@@ -301,45 +301,44 @@ 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 eev-beginner'.
+The three links in the \"Video links:\" block below
-An alternative way, that only works on *NIX-based systems, is shown in
-this video (from 2016!):
+ [Video links:]
+ (find-eevnavvideo \"0:31\" \"0.1. M-x package-initialize\")
+ (find-eevnavvideo \"0:39\" \"0.2. M-x list-packages\")
+ (find-eevnavvideo \"2:30\" \"0.3. M-x eev-beginner\")
- http://angg.twu.net/eev-videos/video-eev-quick-0.mp4
-
-To run it, open the page at
-
- http://angg.twu.net/eev-intros/find-eev-quick-intro.html
+point to positions in that video; to learn how to use links like
+those, visit this URL:
-in a browser, and open a terminal running a shell. Mark the multi-line
-\"{ ... }\" block below, copy it to the clipboard with ctrl-C, and paste
-it into the shell to run its commands.
-
-{
- rm -Rv ~/eev
- rm -Rv ~/eev2/
- mkdir ~/eev2/
- cd ~/eev2/
- rm -fv eev2.tgz
- wget http://angg.twu.net/eev-current/eev2.tgz
- tar -xvzf eev2.tgz
- {
- echo '#!/bin/sh'
- echo 'cd ~/eev2/ && emacs -l eev-beginner.el
--eval=\"(find-eev-quick-intro)\" $*'
- } > ~/eev
- chmod 755 ~/eev
-}
+ http://angg.twu.net/eev-intros/find-videos-intro.html#2
-You now have a shell script that you can invoke with
+Installing eev does NOT activate eev-mode. To activate eev-mode
+and open this tutorial, run `M-x eev-beginner'.
- ~/eev
+For other ways to install eev see this other tutorial, especially
+its section 5.1:
-that starts Emacs, loads eev, and opens a copy of this tutorial.
+ http://angg.twu.net/eev-intros/find-eev-install-intro.html#5.1
+ http://angg.twu.net/eev-intros/find-eev-install-intro.html
+ (find-eev-install-intro \"5.1. Using the tarball\")
+ (find-eev-install-intro)
-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.
+TIP FOR BEGINNERS: if you are a real beginner with, say, less
+than 10 minutes of experience using Emacs, then you will probably
+be in a stage in which you often get stuck in the middle of
+something that you don't know how to leave - for example, you may
+be in the middle of a \"complex command\", and Emacs may be
+waiting for the keys that would complete the command. The easiest
+way to handle that is to leave Emacs and then start it again, and
+after starting it again you will need to type `M-x eev-beginner'
+to activate eev again. For an explanation of this in video, see:
+
+ [Video links:]
+ (find-eevnavvideo \"3:46\" \"0.4. for the beginners: quitting and
restarting\")
+ (find-eevnavvideo \"4:06\" \"the part of the sequence of keys\")
+ (find-eevnavvideo \"4:21\" \"go to the file menu, click quit\")
+ (find-eevnavvideo \"4:46\" \"enter emacs again, type M-x eev-beginner\")
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_.
@@ -347,9 +346,6 @@ This tutorial is intended to make you learn the most
essential things
in the first ten minutes - including how to navigate in Emacs's
manuals.
-For more on ways to install eev see:
-
- (find-eev-install-intro)
@@ -2210,11 +2206,12 @@ These are the current ways to download and install eev:
and then running `M-x package-install-file';
- 3. by using the script in section 1, that downloads a .tgz from
+ 3. by using the script in section 5.1 below, that downloads a
+ .tgz from
http://angg.twu.net/eev-current/eev2.tgz ,
- unpacks it in the directory ~/eev/ and creates a script
+ unpacks it in the directory ~/eev2/ and creates a script
called \"~/eev\" that starts Emacs loading eev and opening
the main tutorial,
@@ -2240,7 +2237,70 @@ These are the current ways to download and install eev:
-5.1. Using the git repository
+5.1. Using the tarball
+----------------------
+This way of installing eev is recommended for people who can't or
+who don't want to use Emacs's `M-x list-packages' (from
+`package.el') and who are on a *NIX-based system.
+
+To install eev using this method, you should copy and paste the
+block of shell commands below into a terminal,
+
+{
+ rm -Rv ~/eev
+ rm -Rv ~/eev2/
+ mkdir ~/eev2/
+ cd ~/eev2/
+ rm -fv eev2.tgz
+ wget http://angg.twu.net/eev-current/eev2.tgz
+ tar -xvzf eev2.tgz
+ {
+ echo '#!/bin/sh'
+ echo 'cd ~/eev2/ && emacs -l eev-beginner.el
--eval=\"(find-eev-quick-intro)\" $*'
+ } > ~/eev
+ chmod 755 ~/eev
+}
+
+and then execute the commands in it. This is explained in this
+somewhat outdated video (from 2016!):
+
+ http://angg.twu.net/eev-videos/video-eev-quick-0.mp4
+
+In short: you will have to open this URL in a browser,
+
+ http://angg.twu.net/eev-intros/find-eev-install-intro.html#5.1
+
+in a browser, and open a terminal running a shell; then mark the
+multi-line \"{ ... }\" block above, copy it to the clipboard with
+ctrl-C, and paste it into the shell to run its commands.
+
+You will now have a shell script that you can invoke with
+
+ ~/eev
+
+that starts Emacs, loads eev, and opens the main tutorial - i.e.,
+runs `M-x eev-beginner'. Note that if you install eev using this
+method then all the files related to eev will be in the directory
+~/eev2/, except for the script in ~/eev; if you start Emacs in
+the default way then it will not know that it has to look for
+stuff in ~/eev2/, and commands like `M-x eev-beginner' or sexps
+like
+
+ (require 'eev-load)
+ (load \"eev-beginner\")
+
+will not work.
+
+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.
+
+
+
+
+
+
+5.2. Using the git repository
-----------------------------
The git repository for eev is at:
@@ -2272,7 +2332,7 @@ incompatible with our convention of creating a script
called
-5.2. Installation quirks
+5.3. Installation quirks
------------------------
There were a couple of situations around may/2019 which I was
helping friends who had installed eev on Windows with `M-x
@@ -2284,7 +2344,7 @@ work... I still need to understand this. See:
If you have installed both an eev from ELPA and an eev from the
.tgz or from the git repo then one of them will be found first in
-the load-path. Check with one.
+the load-path. Check which one!