From: Eduardo Ochs <eduardoochs@gmail.com>
To: Robert Weiner <rswgnu@gmail.com>
Cc: Org Mode <emacs-orgmode@gnu.org>
Subject: Re: Org, Hyperbole, and eev
Date: Sun, 26 Jun 2022 20:25:00 -0300 [thread overview]
Message-ID: <CADs++6gViTT_USoprmxRTs98b9YAvof7p6D2nbbTeoFErRE0-Q@mail.gmail.com> (raw)
In-Reply-To: <CA+OMD9js3_6eUYbMXyV4wc6L33E0x2ovT8frxOfPn4Sm2gadzQ@mail.gmail.com>
On Sun, 26 Jun 2022 at 17:24, Robert Weiner <rsw@gnu.org> wrote:
>
> That was not the offer. The offer was to show you how to implement a
> discrete eev command using another framework, possibly simplifying
> its implementation. Hopefully, from seeing the code used to do this,
> you could dig in yourself and follow the flow to whatever level you
> like. Hyperbole, for example, has been implemented across years of
> part-time work. Of course, it has complexities in its implementation
> and if the non-abstract parts of that interest you, then use edebug
> or trace commands to explore the code flow but I wouldn't expect
> anyone to write that out for you.
Hi Robert,
That's bad news. In the last years I became a specialist on helping
people with the "non-abstract parts", usually via chat... we discuss
until we find together what are the parts that are not clear to them,
them we write tests that show how those parts work, and then we go
back to the high-level functions.
In eev the two sexp hyperlinks below
(find-efunction 'hkey-initialize)
(find-efunction 'hkey-initialize "Bind the Action Key to {M-RET}")
point to the source code of `hkey-initialize', but the second one is a
"refinement" of the first one in this sense:
(find-refining-intro)
http://angg.twu.net/eev-intros/find-refining-intro.html
I often use sequences of sexp hyperlinks, with and without
refinements, to record an "explanation" of how something is done. For
example, this block
(code-c-d "hyperbole" "~/.emacs.d/elpa/hyperbole-8.0.0/")
(find-hyperbolefile "DEMO")
(find-hyperbolefile "DEMO" "Action Key is {M-RET}")
(find-hyperbolegrep "grep -nH --null -e M-RET *")
(find-efunction 'hkey-initialize)
(find-efunction 'hkey-initialize "Bind the Action Key to {M-RET}")
(find-ekeymapdescr hyperbole-mode-map)
(find-ekeymapdescr hyperbole-mode-map "M-RET")
(find-ekeymapdescr hyperbole-mode-map "M-RET" "hkey-either")
(find-efunction 'hkey-either)
(find-efunction 'assist-key)
(find-efunction 'assist-key-internal)
(find-efunction 'action-key)
(find-efunction 'action-key-internal)
(find-efunction 'hkey-execute)
(find-efunction 'hkey-execute "hkey-alist")
(find-evardescr 'hkey-alist)
(find-eppp hkey-alist)
(find-evariable 'hkey-alist)
(find-evariable 'hkey-alist "If on a Hyperbole button")
(find-efunction 'hbut:at-p)
(find-efunction 'hbut:at-p "ebut:at-p")
(find-efunction 'hbut:at-p "ibut:at-p")
(find-efunction 'ebut:at-p)
(find-efunction 'ebut:get)
(find-efunction 'ibut:at-p)
is an attempt to understand how M-RET treats hkey-alist as a kind of
program to be run...
How would you rewrite the sexps above as Hyperbole buttons?
I downloaded a local copy of
(find-hyperbolefile "FAST-DEMO")
(find-hyperbolefile "FAST-DEMO" "GNU Hyperbole Videos")
(find-hyperbolefile "FAST-DEMO" "Overview and Demo")
(find-hyperbolefile "FAST-DEMO" "https://youtu.be/WKwZHSbHmPg")
with
(find-youtubedl-links nil nil "WKwZHSbHmPg" nil "hoandd")
Docs: (find-efunction 'find-youtubedl-links)
and I found - via the transcript -
(find-yttranscript-links "hoandd" "WKwZHSbHmPg")
Docs: (find-efunction 'find-yttranscript-links)
that starting on 5:14
(find-hypoanddvideo "05:14" "and so it's very easy to create these")
(find-hypoanddvideo "05:17" "live")
(find-hypoanddvideo "05:18" "uh interactive tutorials if you want")
you say that you can use Hyperbole buttons to create interactive
tutorials... I do that with eev all the time, but my "buttons" are
sexps.
Imagine for a moment that a group of, say, 42 Emacs users asks you to
prepare a video tutorial on how exactly hkey-alist works, because they
want to create their own extensions - button types? - and they think
that it would be nice, and useful to the world, etc, etc, if you could
record a video explaining that... would you still answer something
like this,
"then use edebug or trace commands to explore the code flow but I
wouldn't expect anyone to write that out for you"
or would you use Hyperbole to create an interactive tutorial
explaining the details, and record a video demo-ing it?
[[]] =/,
Eduardo Ochs
http://angg.twu.net/#eev
next prev parent reply other threads:[~2022-06-26 23:26 UTC|newest]
Thread overview: 33+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-06-26 15:56 Org, Hyperbole, and eev Eduardo Ochs
2022-06-26 16:28 ` Robert Weiner
2022-06-26 17:51 ` Eduardo Ochs
2022-06-26 18:23 ` Robert Weiner
2022-06-26 19:45 ` Eduardo Ochs
2022-06-26 20:23 ` Robert Weiner
2022-06-26 23:25 ` Eduardo Ochs [this message]
2022-06-27 0:49 ` Robert Weiner
2022-06-27 3:48 ` Eduardo Ochs
2022-06-27 4:11 ` Robert Weiner
2022-06-28 4:43 ` Eduardo Ochs
2022-09-27 15:10 ` Jean Louis
2022-09-27 16:22 ` Eduardo Ochs
2022-09-27 21:16 ` Jean Louis
2022-09-27 21:58 ` Jean Louis
2022-09-28 0:52 ` Eduardo Ochs
2022-09-28 6:04 ` Jean Louis
2022-09-28 10:15 ` Eduardo Ochs
2022-09-29 9:22 ` Jean Louis
2022-10-08 0:28 ` Eduardo Ochs
2022-10-08 1:25 ` Jean Louis
2022-10-11 2:42 ` Robert Weiner
2022-10-11 4:59 ` Jean Louis
2022-09-29 9:42 ` Jean Louis
2022-09-29 11:55 ` Quiliro Ordóñez
2022-09-28 3:52 ` Ihor Radchenko
2022-09-28 9:16 ` Jean Louis
2022-09-29 4:07 ` Ihor Radchenko
2022-09-29 9:59 ` Jean Louis
2022-06-28 4:48 ` Eduardo Ochs
2022-06-28 6:26 ` Robert Weiner
2022-09-27 14:43 ` Jean Louis
2022-09-27 14:16 ` Jean Louis
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CADs++6gViTT_USoprmxRTs98b9YAvof7p6D2nbbTeoFErRE0-Q@mail.gmail.com \
--to=eduardoochs@gmail.com \
--cc=emacs-orgmode@gnu.org \
--cc=rswgnu@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).