[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/eev 78ae0b4090 1/2: Small changes in eev-wconfig.el.
From: |
ELPA Syncer |
Subject: |
[elpa] externals/eev 78ae0b4090 1/2: Small changes in eev-wconfig.el. |
Date: |
Mon, 30 May 2022 02:57:35 -0400 (EDT) |
branch: externals/eev
commit 78ae0b409021bca902abbf3468b2168cd822130c
Author: Eduardo Ochs <eduardoochs@gmail.com>
Commit: Eduardo Ochs <eduardoochs@gmail.com>
Small changes in eev-wconfig.el.
---
VERSION | 4 +-
eev-intro.el | 245 +++++++++++++--------------------------------------------
eev-wconfig.el | 51 ++++++++++--
3 files changed, 101 insertions(+), 199 deletions(-)
diff --git a/VERSION b/VERSION
index abb38c22af..56299fc45c 100644
--- a/VERSION
+++ b/VERSION
@@ -1,2 +1,2 @@
-Wed May 18 06:39:49 GMT 2022
-Wed May 18 03:39:49 -03 2022
+Mon May 30 06:08:48 GMT 2022
+Mon May 30 03:08:48 -03 2022
diff --git a/eev-intro.el b/eev-intro.el
index f3213a5f0f..73732769db 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: 20220413
+;; Version: 20220525
;; Keywords: e-scripts
;;
;; Latest version: <http://angg.twu.net/eev-current/eev-intro.el>
@@ -13667,7 +13667,7 @@ harder to explain:
http://www.youtube.com/watch?v=86yiRG8YJD0#t=15m11s
(find-eev2019video \"15:11\" \"Demo: the eepitch block\")
- (find-angg \".emacs.videos\" \"eev2019\")
+ http://angg.twu.net/.emacs.videos.html#eev2019
I don't have easy access to Windows machines, so I have to rely
on friends to test some things for me. I also don't have easy
@@ -14081,160 +14081,91 @@ smarter way that works well, please get in touch!!!
6. Video links
==============
If you're on Windows you need to start by configuring your
-browser and the path to it, as described here:
+browser and the path to it. The old instructions for that are
+here...
(find-video-links-intro)
(find-video-links-intro \"3. `find-youtube-video'\")
(find-video-links-intro \"4. Configuring the browser\")
-and by making `find-eev-video' use the browser to play the
-videos. For that you need to run this sexp,
+...but in may/2022 I created a better way. It is explained in
+the next section.
- (ee-use-youtube-videos)
-as explained here:
- (find-video-links-intro \"7. `find-eev-video'\")
-Also install the Mpv video player, configure its path, and check
-that Emacs can find it. This is explained here:
- (find-video-links-intro \"6. Configuring Mpv\")
+7. eev-wconfig.el
+=================
+NOTE: until may/2022 this section was about this module:
-The next sections of this tutorial will suppose that you know how
-to configure that path to external programs, and how to test
-them.
+ (find-eev \"eev-on-windows.el\")
-IMPORTANT: save the sexps with `setenv' that you used to
-configure the paths to your notes. See:
+that became obsolete, and was superseded by:
- (find-here-links-intro \"4. `find-here-links-3'\")
- (find-here-links-intro \"4. `find-here-links-3'\" \"~/TODO\")
+ (find-eev \"eev-wconfig.el\")
+ (find-eev \"eev-wconfig.el\" \"intro\")
+To run eev-wconfig you need to run these sexps:
+ (require 'eev-wconfig)
+ (find-wconfig-links)
+`(find-wconfig-links)' shows a temporary buffer with links to
+several \"sub-wconfigs\". The main ones are:
-7. eev-on-windows.el
-====================
-The file eev-on-windows.el contains several functions that will
-be used in the next sections. It is not loaded by default, so you
-need to do this:
-
- (require 'eev-on-windows)
-
-If you are on Windows you will also need to download some
-\".exe\" files by running the sexps below. Each of the sexps that
-start with `ee-download-with-eww' may take several seconds to
-complete, and it's better to wait until it sends a message like
-\"Saved (filename.exe)\" to the echo area before executing other
-sexps with `M-e'.
-
- (mkdir \"~/bin/\" t)
- (delete-file \"~/bin/wget.exe\")
- (delete-file \"~/bin/pdftotext.exe\")
- (delete-file \"~/bin/lua52.exe\")
- (delete-file \"~/bin/lua52.dll\")
- (ee-download-with-eww \"http://angg.twu.net/2021-oficina/wget.exe\"
\"~/bin/\")
- (ee-download-with-eww \"http://angg.twu.net/2021-oficina/pdftotext.exe\"
\"~/bin/\")
- (ee-download-with-eww \"http://angg.twu.net/2021-oficina/lua52.exe\"
\"~/bin/\")
- (ee-download-with-eww \"http://angg.twu.net/2021-oficina/lua52.dll\"
\"~/bin/\")
-
-The sexps in the block above only need to be executed once - you
-don't need to execute them at each Emacs session. You can test if
-they worked by running the sexps below:
-
- (find-fline \"~/bin/\" \"wget.exe\")
- (find-fline \"~/bin/\" \"pdftotext.exe\")
- (find-fline \"~/bin/\" \"lua52.exe\")
- (find-callprocess `(\"~/bin/wget.exe\" \"--help\"))
- (find-callprocess `(\"~/bin/pdftotext.exe\" \"--help\"))
- (find-callprocess `(\"~/bin/lua52.exe\" \"--help\"))
+ (find-wconfig-browser-links)
+ (find-wconfig-wget-links)
+ (find-wconfig-shell-links)
+ (find-wconfig-lua-links)
+ (find-wconfig-mpv-links)
+ (find-wconfig-exercises-links)
+Each one of these sub-wconfigs has detailed instructions for
+configuring the thing/word after it: browser, wget, (E)shell,
+Lua, Mpv. The best way to understand how to use these
+sub-wconfigs is by watching the video about eev-wconfig, that is
+here:
+ Page: http://angg.twu.net/eev-wconfig.html
+ Index: (find-1stclassvideoindex \"2022eevwconfig\")
+ Info: (find-1stclassvideo-links \"2022eevwconfig\")
+ Play: (find-2022eevwconfigvideo \"0:00\")
+ (find-2022eevwconfigvideo \"17:29\"
\"(find-wconfig-browser-links)\")
+ (find-2022eevwconfigvideo \"26:52\" \"...a long digression...\")
+ (find-2022eevwconfigvideo \"39:20\" \"(find-wconfig-wget-links)\")
+ (find-2022eevwconfigvideo \"53:41\" \"(find-wconfig-shell-links)\")
+ (find-2022eevwconfigvideo \"57:45\" \"(find-wconfig-lua-links)\")
+ (find-2022eevwconfigvideo \"59:17\" \"(find-wconfig-mpv-links)\")
+ (find-2022eevwconfigvideo \"1:06:16\"
\"(find-wconfig-exercises-links)\")
-7.1. `ee-use-windows'
----------------------
-If you are on Windows you should run this:
+Note that I've included links to the parts of the video that
+describe each one of the sub-wconfigs, and note that you will
+only be able to use the `find-2022eevwconfigvideo' links _to play
+local copies of the videos_ after configuring mpv... so it's
+better to start by accessing this section in a browser, at:
- (ee-use-windows)
+ http://angg.twu.net/eev-intros/find-windows-beginner-intro.html#7
-Its source code is here:
- (find-eev \"eev-on-windows.el\" \"ee-use-windows\")
-Most of what it does is explained in the next sections.
+7.1. `ee-use-windows'
+---------------------
+(Obsolete, deleted)
7.2. Testing wget.exe
---------------------
-Try to run this eepitch block with <f8>s:
-
- (eepitch-eshell)
- (eepitch-kill)
- (eepitch-eshell)
- rm --help
- ls --help
- rm -fv $S/http/www.gnu.org/software/emacs/emacs-paper.html
- ls -l $S/http/www.gnu.org/software/emacs/emacs-paper.html
- #
- mkdir -p $S/http/www.gnu.org/software/emacs/
- cd $S/http/www.gnu.org/software/emacs/
- wget -nc 'http://www.gnu.org/software/emacs/emacs-paper.html'
- echo 'http://www.gnu.org/software/emacs/emacs-paper.html' >> ~/.psne.log
- #
- ls -l $S/http/www.gnu.org/software/emacs/emacs-paper.html
- rm -fv $S/http/www.gnu.org/software/emacs/emacs-paper.html
-
-Now try to follow the instructions here to download the same URL
-with `M-x brep':
-
- (find-psne-intro \"3. The new way: `M-x brep'\")
-
-`M-x brep' uses `eepitch-shell', that on Windows runs cmd.exe by
-default, but in the last section we ran `ee-use-windows', that
-redefines `eepitch-shell' to makes it use Eshell instead of
-cmd.exe - and it also makes the command \"wget\" in eshell run
-~/bin/wget.exe.
-
-Eev also uses wget in the function `find-wget' and its variants
-`find-wgeta', `find-wget-elisp', and `find-wgeta-elisp'. Try the
-tests here, and check that they work:
-
- (find-eev \"eev-plinks.el\" \"find-wget\")
- (find-eev \"eev-plinks.el\" \"find-wget\" \"Tests:\")
-
+(Obsolete, deleted)
7.3. Lua
--------
-`ee-use-windows' also redefine `eepitch-lua51' to make it run
-~/bin/lua52.exe, that you downloaded in section 7, and it runs
-`ee-use-youtube-videos', that you've run explicitly in section 6.
-Try this link to a video:
-
- (find-eevtestblsvideo \"2:33\" \"if I run f8 here I start a new Lua
interpreter\")
-
-it should play the video in a browser. The video shows what
-happens when we run an eepitch block that calls Lua and
-everything works correctly. Check that these two eepitch blocks
-work as expected:
-
- (eepitch-lua51)
- (eepitch-kill)
- (eepitch-lua51)
- print(2+3)
- os.exit()
-
- (eepitch-shell)
- (eepitch-kill)
- (eepitch-shell)
- ~/bin/lua52.exe -i
- print(2+3)
- os.exit()
+(Obsolete, deleted)
@@ -14283,92 +14214,26 @@ The three behaviors are explained here:
7.5. Downloading PDFs
---------------------
-Now try all the tests in the sections 1-5 and 7 of:
-
- (find-pdf-like-intro)
-
-This test in section 2 will not work,
-
- (find-sh0 \"ls -l ~/Coetzee99.pdf\")
-
-because it requires a Unix-style `ls'. It works in Eshell,
-though. Try:
-
- (eepitch-eshell)
- (eepitch-kill)
- (eepitch-eshell)
- ls --help
- ls -l ~/Coetzee99.pdf
-
-That's because eshell defines its `ls' in Lisp. See:
-
- (find-eshellnode \"Built-ins\")
-
-Also, the tests in section 6 don't work on Windows - one of the
-things that `ee-use-windows' does is to make `find-pdf-page' use
-a browser to open PDFs, and section 6 uses a PDF viewer called
-\"xpdf\". Take a look:
-
- (find-pdf-like-intro \"6. How the external programs are called\")
-
-So: check that everything in sections 1-5 and 7 work, except for
-the test that uses `ls'. The links to pages of PDFs converted to
-text should work - the conversion to text will be done by
-~/bin/pdftotext.exe, that you downloaded and tested in section 7.
+(Obsolete, deleted)
7.6. Saving your settings
-------------------------
-If all the tests above worked then you can save your settings.
-I will refer to the block below as the \"Windows setting block\":
-
- ;; See: (find-windows-beginner-intro \"8. Summary\")
- ;; (find-video-links-intro \"4. Configuring the browser\")
- ;; (find-video-links-intro \"6. Configuring Mpv\")
- (require 'beginner)
- (require 'eev-on-windows)
- (ee-use-windows)
- (setenv \"FIREFOXDIR\" \"c:/Program Files/Mozilla Firefox\")
- (setenv \"GOOGLECHROMEDIR\" \"c:/Program Files/Google/Chrome/Application\")
- (setenv \"MPVDIR\" \"c:/Users/myusername/path/to/mpv\")
- ;;
- ;; Choose one:
- (ee-use-googlechrome)
- ;;(ee-use-firefox)
-
-Copy that block to your ~/TODO, but with the right paths in the
-`setenv's. I will refer to that modified copy as the \"Windows
-setting block in ~/TODO\".
+(Obsolete, deleted)
7.7. Testing your settings
--------------------------
-The best way to test your \"Windows setting block in ~/TODO\" is
-by doing this. Start a second Emacs without closing this one, and
-on that second Emacs run:
-
- 1. `M-x eev-beginner',
- 2. `M-1 M-j' (to access your ~/TODO),
- 3. type `M-e' on each line of your \"Windows setting block in
- ~/TODO\" _that is not commented with with a \";;\".
-
-Then... [TODO: complete this!]
+(Obsolete, deleted)
7.8. Saving your settings to your ~/.emacs
------------------------------------------
-See:
-
- (find-elnode \"Init File\" \".emacs\")
-
-A quick way to visit your ~/.emacs is with `M-5 M-5 M-j'. It runs
-this:
-
- (find-fline \"~/.emacs\")
+(Obsolete, deleted)
diff --git a/eev-wconfig.el b/eev-wconfig.el
index 113d318a26..b7fb8b9627 100644
--- a/eev-wconfig.el
+++ b/eev-wconfig.el
@@ -19,7 +19,7 @@
;;
;; Author: Eduardo Ochs <eduardoochs@gmail.com>
;; Maintainer: Eduardo Ochs <eduardoochs@gmail.com>
-;; Version: 20220516
+;; Version: 20220530
;; Keywords: e-scripts
;;
;; Latest version: <http://angg.twu.net/eev-current/eev-wconfig.el>
@@ -257,9 +257,14 @@
\"C:/Program Files (x86)/Google/Chrome/Application/chrome.exe\")
-;; 2. Test
-;; =======
-;; Try: (find-googlechrome \"https://www.lua.org/\")
+;; 2. Tests
+;; ========
+;; Try:
+;; (find-googlechrome \"https://www.lua.org/\")
+;; Also, the section 3.1 of the main tutorial describes a
+;; quick way to open the \"url at point\" with `M-x brg'.
+;; Try it:
+;; (find-eev-quick-intro \"3.1. Non-elisp hyperlinks\")
;; 3. Update this page
@@ -277,10 +282,15 @@
;; Hint: `M-5 M-5 M-j' runs: (find-fline \"~/.emacs\")
;; See: (eek \"M-j\")
;; Try: (eek \"M-5 M-5 M-j\")
+;; If you need to review how to do copy-and-paste and saving, see:
+;; (find-eev-quick-intro \"5.2. Cutting and pasting\")
+;; (find-emacs-keys-intro \"3. Cutting & pasting\")
+;; (find-emacs-keys-intro \"7. Files and buffers\")
+;; (find-emacs-keys-intro \"7. Files and buffers\" \"C-x C-s\")
;;
;; Copy the updated version of the block below -
;; including the three commented lines at the top -
-;; to your init file.
+;; to your init file, and save it with `C-x C-s'.
;; See: (find-eev \"eev-load.el\" \"autoloads\")
;; (find-eev \"eev-wconfig.el\" \"intro\")
@@ -290,6 +300,33 @@
(setq ee-googlechrome-program
\"{ee-googlechrome-program}\")
+
+;; 5. Save some things to your ~/TODO
+;; ==================================
+;; Remember that you are encouraged to use the file ~/TODO as a messy
+;; log file, and that you can access it with `M-1 M-j'. See:
+;; (find-here-links-intro \"1. Alternating between \\\"task\\\" and
\\\"notes\\\"\")
+;; (find-refining-intro \"3. Three buffers\")
+;; (find-refining-intro \"3. Three buffers\" \"~/TODO\")
+;; (find-refining-intro \"3. Three buffers\" \"M-1 M-j\")
+;; Copy the two uncommented sexps below to your ~/TODO, and save it:
+
+(find-wconfig-links)
+(find-wconfig-browser-links)
+
+
+;; 6. Test your saved configuration
+;; ================================
+;; Open a second Emacs without closing this one, and check that in the
+;; second Emacs you can run `M-x eev-beginner' to load eev and open
+;; `(find-eev-quick-intro)'; then run `M-1 M-j' in the second Emacs to
+;; access your ~/TODO, and check that the lines
+;; (find-wconfig-links)
+;; (find-wconfig-browser-links)
+;; that you saved in the section 5 are there. Run the tests in the
+;; section 2 of `(find-wconfig-browser-links)' and check that they
+;; work - i.e., that the second Emacs is using the right value for the
+;; variable `ee-googlechrome-program'.
")
)
pos-spec-list)))
@@ -725,8 +762,8 @@ for k,v in pairs(_G) do print(k) end
;; Check that the file exists:
;; (find-fline \"~/eev-wconfig/\" \"2022dragABC.mp4\")
;; Try to play it with mpv:
-;; (find-mpv-video \"~/eev-wconfig/2022dragABC.mp4\"
-;; (find-video \"~/eev-wconfig/2022dragABC.mp4\"
+;; (find-mpv-video \"~/eev-wconfig/2022dragABC.mp4\")
+;; (find-video \"~/eev-wconfig/2022dragABC.mp4\")
;; 3. Saving