[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/eev 2009036 21/64: Added text to `find-escripts-intro'
From: |
Stefan Monnier |
Subject: |
[elpa] externals/eev 2009036 21/64: Added text to `find-escripts-intro' |
Date: |
Sun, 7 Apr 2019 16:59:05 -0400 (EDT) |
branch: externals/eev
commit 20090368c8e3d1c66600f4329fd690d6c85c7539
Author: Eduardo Ochs <address@hidden>
Commit: Eduardo Ochs <address@hidden>
Added text to `find-escripts-intro'
---
VERSION | 4 +-
eev-intro.el | 153 ++++++++++++++++++++++++++++++++++++++++++++++++++---------
2 files changed, 133 insertions(+), 24 deletions(-)
diff --git a/VERSION b/VERSION
index a76f2a8..26c5cc3 100644
--- a/VERSION
+++ b/VERSION
@@ -1,2 +1,2 @@
-Qui Mai 31 03:39:45 GMT 2018
-Qui Mai 31 00:39:45 -03 2018
+Qui Mai 31 03:59:56 GMT 2018
+Qui Mai 31 00:59:56 -03 2018
diff --git a/eev-intro.el b/eev-intro.el
index a717c6b..5189eb4 100644
--- a/eev-intro.el
+++ b/eev-intro.el
@@ -20,7 +20,7 @@
;;
;; Author: Eduardo Ochs <address@hidden>
;; Maintainer: Eduardo Ochs <address@hidden>
-;; Version: 2018mai31
+;; Version: 2018jun02
;; Keywords: e-scripts
;;
;; Latest version: <http://angg.twu.net/eev-current/eev-intro.el>
@@ -5859,7 +5859,8 @@ http://www.youtube.com/watch?v=oJTwQvgfgMM Emacs Org-mode
- a system for note-ta
(apply 'find-estring (ee-tolatin1 "\
\(Re)generate: (find-eev-quick-intro)
Source code: (find-efunction 'find-eev-quick-intro)
-More intros: (find-eev-quick-intro)
+More intros: (find-escripts-intro)
+ (find-emacs-keys-intro)
(find-eev-intro)
(find-eval-intro)
(find-eepitch-intro)
@@ -5869,7 +5870,7 @@ Is is meant as both a tutorial and a sandbox.
This is a tutorial for real beginners.
It supposes that you have Emacs installed.
-You may start by watching:
+You may start by watching these (old) videos:
http://angg.twu.net/eev-videos/video-eev-quick-0.mp4 (installation basics)
http://angg.twu.net/eev-videos/video-eev-quick-1.mp4 (about this tutorial)
@@ -5889,28 +5890,29 @@ in a browser, and open a terminal running a shell. Mark
the multi-line
it into the shell to run its commands.
{
- rm -Rv ~/eev/
- mkdir ~/eev/
- cd ~/eev/
+ rm -Rv ~/eev
+ rm -Rv ~/eev2/
+ mkdir ~/eev2/
+ cd ~/eev2/
rm -v eev2.tgz
wget http://angg.twu.net/eev-current/eev2.tgz
tar -xvzf eev2.tgz
{
echo '#!/bin/sh'
- echo 'cd ~/eev/ && emacs -l eev-readme.el
--eval=\"(find-eev-quick-intro)\"'
- } > ~/e
- chmod 755 ~/e
+ echo 'cd ~/eev2/ && emacs -l eev-readme.el
--eval=\"(find-eev-quick-intro)\"'
+ } > ~/eev
+ chmod 755 ~/eev
}
You now have a shell script that you can invoke with
- ~/e
+ ~/eev
that starts Emacs, loads eev, and opens a copy of this tutorial.
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 \"~/e\" again in the shell prompt.
+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
almost anything, _BUT THAT WILL NOT HAPPEN IN THE FIRST TEN MINUTES_.
@@ -6796,14 +6798,110 @@ Is is meant as both a tutorial and a sandbox.
-Eev's central idea is that you can keep \"executable logs\" of what you
-do, in a format that is easy to \"play back\". We call these executable
-logs \"e-scripts\", and this is an introduction to the _usual_ format of
-e-scripts. We start with a section on how to \"read\" existing
-e-scripts, and then we give hints to help you start \"writing\" your own
-e-scripts, first in a single file and then on several files.
+Eev's central idea is that you can keep \"executable logs\" of
+what you do, in a format that is easy to \"play back\". We call
+these executable logs \"e-scripts\", and this is an introduction
+to the _usual_ format of e-scripts. We start with a section on
+how to \"read\" existing e-scripts, and then we give some hints
+to help you start \"writing\" your own e-scripts, first in a
+single file and then on several files.
+
+A typical e-script - like the ones in http://angg.twu.net/e/ - is
+made of an index followed by a series of \"e-script blocks\".
+Here is a miniature example, with an index with two entries
+followed by two e-script blocks:
+
+
+
+# �.lua5.1-debian� (to \"lua5.1-debian\")
+# �.lua-tutorial� (to \"lua-tutorial\")
+
+
+
+#####
+#
+# The main Debian packages for Lua 5.1
+# 2018jun02
+#
+#####
+
+# �lua5.1-debian� (to \".lua5.1-debian\")
+# (find-status \"lua5.1\")
+# (find-vldifile \"lua5.1.list\")
+# (find-udfile \"lua5.1/\")
+# (find-status \"lua5.1-doc\")
+# (find-vldifile \"lua5.1-doc.list\")
+# (find-udfile \"lua5.1-doc/\")
+# (find-udfile \"lua5.1-doc/doc/\")
+# (find-udfile \"lua5.1-doc/test/\")
+# http://www.lua.org/docs.html
+# http://www.lua.org/manual/5.1/manual.html
+# file:///usr/share/doc/lua5.1-doc/doc/manual.html
+
+ (eepitch-shell)
+ (eepitch-kill)
+ (eepitch-shell)
+sudo apt-get install lua5.1 lua5.1-doc
+
+
+
+
+#####
+#
+# Downloading and opening the eev-based Lua tutorial
+# 2018jun02
+#
+#####
+
+# �lua-tutorial� (to \".lua-tutorial\")
+# http://angg.twu.net/e/lua-intro.e.html
+# http://angg.twu.net/e/lua-intro.e
+# (find-es \"lua-intro\")
+
+ (eepitch-shell)
+ (eepitch-kill)
+ (eepitch-shell)
+cd /tmp/
+rm -v lua-intro.e
+wget http://angg.twu.net/e/lua-intro.e
+
+# (find-fline \"/tmp/lua-intro.e\")
+# (defun eejump-11 () (find-fline \"/tmp/lua-intro.e\"))
+
+
+
+
+
+Let's name its parts - they will be explained in the sections below.
+
+1. The lines with �.lua5.1-debian� and �lua5.1-debian� use
+ the `(to ...)' sexps to \"point to one another\". They are
+ explained at:
+
+ (find-eev-quick-intro \"8. Anchors\")
+
+2. The comment block that says \"The main Debian packages for Lua
+ 5.1\" is simply a way to distinguish visually one e-script
+ block from its neighboring ones. It was produced by `M-B', as
+ explained here:
+
+ (find-eev-quick-intro \"8.4. Creating e-script blocks\")
+
+3. The sexps starting with `find-status' and other `find-xxx's
+ are elisp hyperlinks.
+
+4. The lines with \"http://...\" and \"file:///...\" contain URLs
+ that can be visited using `browse-url' or with `brg' and other
+ `brxxx' functions.
+
+5. The lines with a red star, like \" (eepitch-shell)\", start
+ \"eepitch blocks\", that are explained here:
+
+ (find-eev-quick-intro \"6. Controlling shell-like programs\")
+
+6. The lines just below the lines with \"\"s are shell commands
+ that can be executed with eepitch.
-This index is used in the section ... below.
@@ -6811,21 +6909,27 @@ This index is used in the section ... below.
1. Reading e-scripts
====================
+1.1. A miniature example
+------------------------
+
1.1. Elisp hyperlinks
---------------------
\(Mention code-c-d)
-1.2. URLs
+1.2. Shorter elisp hyperlinks
+-------------------------------
+
+1.3. URLs
---------
-1.3. Eepitch blocks
+1.4. Eepitch blocks
-------------------
-1.4. Anchors, indexes and e-script blocks
+1.5. Anchors, indexes and e-script blocks
-----------------------------------------
-1.5. E-scripts embedded in other files
+1.6. E-scripts embedded in other files
--------------------------------------
@@ -6844,6 +6948,11 @@ This index is used in the section ... below.
+3. Social consequences
+======================
+\(of sharing e-scripts)
+
+
" pos-spec-list)))
;; (find-escripts-intro)
- [elpa] externals/eev 99d0c67 03/64: Changes in `find-videos-intro'; `ee-copy-after-and' -> `ee-copy-rest', (continued)
- [elpa] externals/eev 99d0c67 03/64: Changes in `find-videos-intro'; `ee-copy-after-and' -> `ee-copy-rest', Stefan Monnier, 2019/04/07
- [elpa] externals/eev 5320469 04/64: `eepitch-do' and `find-wget', Stefan Monnier, 2019/04/07
- [elpa] externals/eev 834e074 10/64: `find-customizegroup', Stefan Monnier, 2019/04/07
- [elpa] externals/eev 301db1e 13/64: Make some arguments optional, Stefan Monnier, 2019/04/07
- [elpa] externals/eev 95397ce 02/64: Added `ee-copy-after-and' and `find-eejumps', Stefan Monnier, 2019/04/07
- [elpa] externals/eev b30a527 15/64: Corrected typos in `find-eev-quick-intro'., Stefan Monnier, 2019/04/07
- [elpa] externals/eev 19623c4 05/64: Rewrote eev-rcirc.el., Stefan Monnier, 2019/04/07
- [elpa] externals/eev 70964f1 20/64: Add `find-eev-install-intro' and `find-eev-install-links', Stefan Monnier, 2019/04/07
- [elpa] externals/eev 23f0366 22/64: Added instructions for using the git repository., Stefan Monnier, 2019/04/07
- [elpa] externals/eev 4b2e5aa 18/64: Added eev-codings.el, started to convert files to UTF-8, Stefan Monnier, 2019/04/07
- [elpa] externals/eev 2009036 21/64: Added text to `find-escripts-intro',
Stefan Monnier <=
- [elpa] externals/eev e4964a3 06/64: Rewrote `find-brxxx-intro'., Stefan Monnier, 2019/04/07
- [elpa] externals/eev 4a7bfcf 11/64: High-level words for `find-wset' (code and docs), Stefan Monnier, 2019/04/07
- [elpa] externals/eev a334821 08/64: `ee-mplayer-{audio, video}-options', `find-here-links', Stefan Monnier, 2019/04/07
- [elpa] externals/eev d77a040 24/64: Added `find-sh-at-dir'; added new sections to `find-eev-quick-intro', Stefan Monnier, 2019/04/07
- [elpa] externals/eev 1b0d1dd 25/64: Added several sections to `find-eev-quick-intro'., Stefan Monnier, 2019/04/07
- [elpa] externals/eev b17c70b 29/64: Small changes in README.md, Stefan Monnier, 2019/04/07
- [elpa] externals/eev 655f894 23/64: Added a "$*" to the shell script "~/eev"., Stefan Monnier, 2019/04/07
- [elpa] externals/eev 9f22dff 14/64: Added `find-eev-quick-intro'., Stefan Monnier, 2019/04/07
- [elpa] externals/eev cca8307 09/64: `find-here-links' (code and docs), Stefan Monnier, 2019/04/07
- [elpa] externals/eev 5c4799d 12/64: Small fixes in `find-*-intro' functions, Stefan Monnier, 2019/04/07