From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 0FYMIg/ruGJkWAAAbAwnHQ (envelope-from ) for ; Mon, 27 Jun 2022 01:26:07 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 6DbnIQ/ruGKAAgEAauVa8A (envelope-from ) for ; Mon, 27 Jun 2022 01:26:07 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 02B5FBBE5 for ; Mon, 27 Jun 2022 01:26:07 +0200 (CEST) Received: from localhost ([::1]:36358 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o5bdm-0004zI-5j for larch@yhetil.org; Sun, 26 Jun 2022 19:26:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37336) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o5bdB-0004yt-Cl for emacs-orgmode@gnu.org; Sun, 26 Jun 2022 19:25:29 -0400 Received: from mail-lj1-x22f.google.com ([2a00:1450:4864:20::22f]:41898) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o5bcw-0006r8-G9 for emacs-orgmode@gnu.org; Sun, 26 Jun 2022 19:25:29 -0400 Received: by mail-lj1-x22f.google.com with SMTP id n15so9029304ljg.8 for ; Sun, 26 Jun 2022 16:25:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=G7uvLbioXX6LUIp/MghTJyAEqr+nM1hfjAaowpYkSk8=; b=ZUyUhpKjMIa8IqsBOKcCS2iyWc5ZEefKdxe/SO461AOQ2vcjQHzlgcUwaRdBnD5DYF 8KKMullYZ101y1a4q1sids/1UQPTq+IazVW2KXmpnk2lUctFYWdK0NVR7bdECE1L9bo1 +5Xg0ml42GuGabPFh2WxuRz0HFtz2bd9b8NUQ1I+PIcwIDrY83elrHdWbuaHXElkUXml zlTzzwxotR1z3rJEqOw4fWWEn/wbYd3lNqXCmxRevrmC6uexZJBgIZy3tK26in2fDro9 TXY1dHuKpuDpUVVW2M9Ct6scfoHw2Msb3aafQOc+BLAl+kvR/E2HKH5Dq3KAcNFyXxRY Z/WQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=G7uvLbioXX6LUIp/MghTJyAEqr+nM1hfjAaowpYkSk8=; b=z+7WPnwE9Rkow7FyosfDQTBQByIAuk2jnrITs00uAG/CVhiiTITw+/YsTE30L4Z5/5 6dfTjAn8I+q59fiWeijmr8g7c3rNb/ns4j02ebTPobQqJpACX7fh4lJPQhIrZNamSycZ m2C/6+haCiMcnTnCWZzhOHLfytuDmYHug071OUa6Y+bIt9J73NQJ7AgG5RRfI1hG7IHa QkifHU6RHprBhaoxwMkI5bJKYxutJVyjwlaho7PWOhiNQ0pt45MwZaj0+676Gqe2xzjI T6wXCoU7FgsN0jBZgIMMZK44H1UMpHlH0tD658extsARXrcill2hTwud/qhAGRWEQ9ge Zl0g== X-Gm-Message-State: AJIora+4hCL4h5BI5iHWXWemnKE4IFnGqvNySCo7Sh27wLjnPvcRGP/2 gImL5+ToUfVbTi803ANFJ0vmpyeKtRprO8imcSE= X-Google-Smtp-Source: AGRyM1v/t1L+L8OEzx2lbvnBytfLzlOtjmvFWkqVNGBKeHOtawqUzkwt4j/8dnCa+37A55oINC7pR3LVK4XsatOOCqA= X-Received: by 2002:a05:651c:1056:b0:25b:bfa4:2c0 with SMTP id x22-20020a05651c105600b0025bbfa402c0mr1574554ljm.225.1656285912414; Sun, 26 Jun 2022 16:25:12 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Eduardo Ochs Date: Sun, 26 Jun 2022 20:25:00 -0300 Message-ID: Subject: Re: Org, Hyperbole, and eev To: Robert Weiner Cc: Org Mode Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=2a00:1450:4864:20::22f; envelope-from=eduardoochs@gmail.com; helo=mail-lj1-x22f.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1656285967; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=G7uvLbioXX6LUIp/MghTJyAEqr+nM1hfjAaowpYkSk8=; b=kfgZ6ntxloa8z1AfzF99iGAYkzYYtqpPYYfllxsU/USSp/ASXSLblgQRvBj6HLbvUwu4Fa G4F1zEuIFzogK55O53HMxdDSlYiO6CeArHckoVqTMX26eXTOILDabZUrvPtswuuSFE4XOv m/7dQS2bkIEPRf7j6CZt2pIyzo5waUiwfWu7NsRz90SqXh9ExsCFLAU9y6L4pSthhxZWiv q90Em8l1LfvC7RIApXJhMRT3lzqjnqedtETm7Z2J3PHhVdQhCmHa+MtalNWBFFSpIgE+sx rK2262lX+9kJStcyGNG7ab7Yge/uUghaiHtdObGSmZGZX3xhlvAxQYtZhGSn+w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1656285967; a=rsa-sha256; cv=none; b=niTtoE4RAFFLlO0tF43fe+Fzp3EddyqE9IU/DZftV6eRPhN10qg6xilSueUOxE+AgYOteU Ensq/ydaZ7JvJ7h7ENqpbsnnUoGtnC412QH9ITWLsRYCAVwD6LnpMh2jNMghidADH23CBU RMTj4tGKOdUTP5Xt1QUGRM9Dm1oZSUUWsIQHRuiPom124S+/UOFxh0xVI6P/oqjCiIKju9 e0Q0cGH6k02ft+fIponA4WSTi/We3pyFB4gHiNAPDKUA9lWRUwWH0cj71jXOBEozgDZN1L ssmzuaqyc9J1lha6UwG2wbwUmFvrY95KdxXOCq6DrbmKE0KyCUYC6+RaeOwVuw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=ZUyUhpKj; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -5.25 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=ZUyUhpKj; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 02B5FBBE5 X-Spam-Score: -5.25 X-Migadu-Scanner: scn0.migadu.com X-TUID: I9WNNiEO/IDd On Sun, 26 Jun 2022 at 17:24, Robert Weiner 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