--- /srv/reproducible-results/rbuild-debian/r-b-build.qOTwImK7/b1/embark_1.1-2_arm64.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.qOTwImK7/b2/embark_1.1-2_arm64.changes
├── Files
│ @@ -1,2 +1,2 @@
│  
│ - 9d04a85154a23114c71f40b3dfeaedcb 98152 editors optional elpa-embark_1.1-2_all.deb
│ + 25b5ebf7e590ed67ce3528d04a6d2806 98148 editors optional elpa-embark_1.1-2_all.deb
├── elpa-embark_1.1-2_all.deb
│ ├── file list
│ │ @@ -1,3 +1,3 @@
│ │  -rw-r--r--   0        0        0        4 2024-07-25 11:12:54.000000 debian-binary
│ │  -rw-r--r--   0        0        0     1768 2024-07-25 11:12:54.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0    96192 2024-07-25 11:12:54.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0    96188 2024-07-25 11:12:54.000000 data.tar.xz
│ ├── control.tar.xz
│ │ ├── control.tar
│ │ │ ├── ./md5sums
│ │ │ │ ├── ./md5sums
│ │ │ │ │┄ Files differ
│ ├── data.tar.xz
│ │ ├── data.tar
│ │ │ ├── ./usr/share/doc/elpa-embark/embark.html
│ │ │ │ ├── ./usr/share/doc/elpa-embark/embark.html
│ │ │ │ │ @@ -1,14 +1,14 @@
│ │ │ │ │  <?xml version="1.0" encoding="utf-8"?>
│ │ │ │ │  <!DOCTYPE html
│ │ │ │ │    PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN'
│ │ │ │ │    'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
│ │ │ │ │  <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
│ │ │ │ │    <head>
│ │ │ │ │ -    <!-- 2024-09-22 Sun 16:00 -->
│ │ │ │ │ +    <!-- 2025-10-25 Sat 22:25 -->
│ │ │ │ │      <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/>
│ │ │ │ │      <meta name="viewport" content="width=device-width, initial-scale=1"/>
│ │ │ │ │      <title>Embark: Emacs Mini-Buffer Actions Rooted in Keymaps</title>
│ │ │ │ │      <meta name="author" content="Omar AntolÃ­n Camarena"/>
│ │ │ │ │      <meta name="generator" content="Org Mode"/>
│ │ │ │ │      <style>#content { max-width: 60em; margin: auto; }
│ │ │ │ │    .title  { text-align: center;
│ │ │ │ │ @@ -197,121 +197,121 @@
│ │ │ │ │      <div id="content" class="content">
│ │ │ │ │        <h1 class="title">Embark: Emacs Mini-Buffer Actions Rooted in Keymaps</h1>
│ │ │ │ │        <div id="table-of-contents" role="doc-toc">
│ │ │ │ │          <h2>Table of Contents</h2>
│ │ │ │ │          <div id="text-table-of-contents" role="doc-toc">
│ │ │ │ │            <ul>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#org8c84690">1. Overview</a>
│ │ │ │ │ +              <a href="#orgc49f3d8">1. Overview</a>
│ │ │ │ │                <ul>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org735124d">1.1. Acting on targets</a>
│ │ │ │ │ +                  <a href="#org1aa497d">1.1. Acting on targets</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#orgd6a7421">1.2. The default action on a target</a>
│ │ │ │ │ +                  <a href="#org07b3179">1.2. The default action on a target</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#orgccac3ea">1.3. Working with sets of possible targets</a>
│ │ │ │ │ +                  <a href="#orgf5a64ac">1.3. Working with sets of possible targets</a>
│ │ │ │ │                    <ul>
│ │ │ │ │                      <li>
│ │ │ │ │ -                      <a href="#org6d0a50a">1.3.1. Selecting some targets to make an ad hoc candidate set</a>
│ │ │ │ │ +                      <a href="#org6e8887d">1.3.1. Selecting some targets to make an ad hoc candidate set</a>
│ │ │ │ │                      </li>
│ │ │ │ │                      <li>
│ │ │ │ │ -                      <a href="#org31f7502">
│ │ │ │ │ +                      <a href="#org99689e8">
│ │ │ │ │                          1.3.2.
│ │ │ │ │                          <code>embark-live</code>
│ │ │ │ │                          a live-updating variant of
│ │ │ │ │                          <code>embark-collect</code>
│ │ │ │ │                        </a>
│ │ │ │ │                      </li>
│ │ │ │ │                    </ul>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org3d700db">1.4. Switching to a different command without losing what you've typed</a>
│ │ │ │ │ +                  <a href="#orgc7d9ab0">1.4. Switching to a different command without losing what you've typed</a>
│ │ │ │ │                  </li>
│ │ │ │ │                </ul>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#org7d203a4">2. Quick start</a>
│ │ │ │ │ +              <a href="#org46d40f1">2. Quick start</a>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#orga866d57">3. Advanced configuration</a>
│ │ │ │ │ +              <a href="#orgf10470d">3. Advanced configuration</a>
│ │ │ │ │                <ul>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org3f16e55">3.1. Showing information about available targets and actions</a>
│ │ │ │ │ +                  <a href="#orgd2543bf">3.1. Showing information about available targets and actions</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#orgdec3cba">3.2. Selecting commands via completions instead of key bindings</a>
│ │ │ │ │ +                  <a href="#org18604e2">3.2. Selecting commands via completions instead of key bindings</a>
│ │ │ │ │                    <ul>
│ │ │ │ │                      <li>
│ │ │ │ │ -                      <a href="#org4af3eda">3.2.1. Selecting commands via completion outside of Embark</a>
│ │ │ │ │ +                      <a href="#org8dc7588">3.2.1. Selecting commands via completion outside of Embark</a>
│ │ │ │ │                      </li>
│ │ │ │ │                    </ul>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org2cd7e05">3.3. Quitting the minibuffer after an action</a>
│ │ │ │ │ +                  <a href="#org96d3bbc">3.3. Quitting the minibuffer after an action</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org79a7f25">3.4. Running some setup after injecting the target</a>
│ │ │ │ │ +                  <a href="#org4f1bb8b">3.4. Running some setup after injecting the target</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#orgbbf6bf6">3.5. Running hooks before, after or around an action</a>
│ │ │ │ │ +                  <a href="#org5809034">3.5. Running hooks before, after or around an action</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org7f66113">3.6. Creating your own keymaps</a>
│ │ │ │ │ +                  <a href="#orgdd86126">3.6. Creating your own keymaps</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org2f212d3">3.7. Defining actions for new categories of targets</a>
│ │ │ │ │ +                  <a href="#org20b3b0a">3.7. Defining actions for new categories of targets</a>
│ │ │ │ │                    <ul>
│ │ │ │ │                      <li>
│ │ │ │ │ -                      <a href="#orgfa958ec">3.7.1. New minibuffer target example - tab-bar tabs</a>
│ │ │ │ │ +                      <a href="#orgcc8cfe1">3.7.1. New minibuffer target example - tab-bar tabs</a>
│ │ │ │ │                      </li>
│ │ │ │ │                      <li>
│ │ │ │ │ -                      <a href="#orge60ed4f">3.7.2. New target example in regular buffers - short Wikipedia links</a>
│ │ │ │ │ +                      <a href="#orgb3891aa">3.7.2. New target example in regular buffers - short Wikipedia links</a>
│ │ │ │ │                      </li>
│ │ │ │ │                    </ul>
│ │ │ │ │                  </li>
│ │ │ │ │                </ul>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#orge3871d0">4. How does Embark call the actions?</a>
│ │ │ │ │ +              <a href="#orga35193f">4. How does Embark call the actions?</a>
│ │ │ │ │                <ul>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org198a9d0">4.1. Non-interactive functions as actions</a>
│ │ │ │ │ +                  <a href="#org8372882">4.1. Non-interactive functions as actions</a>
│ │ │ │ │                  </li>
│ │ │ │ │                </ul>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#orgcbcb91f">5. Embark, Marginalia and Consult</a>
│ │ │ │ │ +              <a href="#orgee0c0d6">5. Embark, Marginalia and Consult</a>
│ │ │ │ │                <ul>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#org6dee493">5.1. Marginalia</a>
│ │ │ │ │ +                  <a href="#org207271f">5.1. Marginalia</a>
│ │ │ │ │                  </li>
│ │ │ │ │                  <li>
│ │ │ │ │ -                  <a href="#orgaf59cf2">5.2. Consult</a>
│ │ │ │ │ +                  <a href="#org8ef19c9">5.2. Consult</a>
│ │ │ │ │                  </li>
│ │ │ │ │                </ul>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#org34fbc10">6. Related Packages</a>
│ │ │ │ │ +              <a href="#org9dfd536">6. Related Packages</a>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#orgdb14532">7. Resources</a>
│ │ │ │ │ +              <a href="#org3de7646">7. Resources</a>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#orgb1cd77b">8. Contributions</a>
│ │ │ │ │ +              <a href="#orgebd1b61">8. Contributions</a>
│ │ │ │ │              </li>
│ │ │ │ │              <li>
│ │ │ │ │ -              <a href="#orgfea3c58">9. Acknowledgments</a>
│ │ │ │ │ +              <a href="#orgdecd8cf">9. Acknowledgments</a>
│ │ │ │ │              </li>
│ │ │ │ │            </ul>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-org8c84690" class="outline-2">
│ │ │ │ │ -        <h2 id="org8c84690">
│ │ │ │ │ +      <div id="outline-container-orgc49f3d8" class="outline-2">
│ │ │ │ │ +        <h2 id="orgc49f3d8">
│ │ │ │ │            <span class="section-number-2">1.</span>
│ │ │ │ │            Overview
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-1">
│ │ │ │ │            <p>
│ │ │ │ │              Embark makes it easy to choose a command to run based on what is near
│ │ │ │ │  point, both during a minibuffer completion session (in a way familiar
│ │ │ │ │ @@ -330,16 +330,16 @@
│ │ │ │ │  sentences; and it is easy to add more actions and more target types.
│ │ │ │ │  Embark can also collect all the candidates in a minibuffer to an
│ │ │ │ │  occur-like buffer or export them to a buffer in a major-mode specific
│ │ │ │ │  to the type of candidates, such as dired for a set of files, ibuffer
│ │ │ │ │  for a set of buffers, or customize for a set of variables.
│ │ │ │ │            </p>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org735124d" class="outline-3">
│ │ │ │ │ -          <h3 id="org735124d">
│ │ │ │ │ +        <div id="outline-container-org1aa497d" class="outline-3">
│ │ │ │ │ +          <h3 id="org1aa497d">
│ │ │ │ │              <span class="section-number-3">1.1.</span>
│ │ │ │ │              Acting on targets
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-1-1">
│ │ │ │ │              <p>
│ │ │ │ │                You can think of
│ │ │ │ │                <code>embark-act</code>
│ │ │ │ │ @@ -501,16 +501,16 @@
│ │ │ │ │  read about the
│ │ │ │ │                <a href="https://github.com/oantolin/embark/wiki/Default-Actions">default actions and their key bindings</a>
│ │ │ │ │                on the GitHub
│ │ │ │ │  project wiki.
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-orgd6a7421" class="outline-3">
│ │ │ │ │ -          <h3 id="orgd6a7421">
│ │ │ │ │ +        <div id="outline-container-org07b3179" class="outline-3">
│ │ │ │ │ +          <h3 id="org07b3179">
│ │ │ │ │              <span class="section-number-3">1.2.</span>
│ │ │ │ │              The default action on a target
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-1-2">
│ │ │ │ │              <p>Embark has a notion of default action for a target:</p>
│ │ │ │ │              <ul class="org-ul">
│ │ │ │ │                <li>
│ │ │ │ │ @@ -570,16 +570,16 @@
│ │ │ │ │  expression.</li>
│ │ │ │ │                <li>Go to the definition of an Emacs Lisp function, variable or macro at
│ │ │ │ │  point.</li>
│ │ │ │ │                <li>Find the file corresponding to an Emacs Lisp library at point.</li>
│ │ │ │ │              </ul>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-orgccac3ea" class="outline-3">
│ │ │ │ │ -          <h3 id="orgccac3ea">
│ │ │ │ │ +        <div id="outline-container-orgf5a64ac" class="outline-3">
│ │ │ │ │ +          <h3 id="orgf5a64ac">
│ │ │ │ │              <span class="section-number-3">1.3.</span>
│ │ │ │ │              Working with sets of possible targets
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-1-3">
│ │ │ │ │              <p>
│ │ │ │ │                Besides acting individually on targets, Embark lets you work
│ │ │ │ │  collectively on a set of target
│ │ │ │ │ @@ -727,16 +727,16 @@
│ │ │ │ │                <code>embark-collect</code>
│ │ │ │ │                or
│ │ │ │ │                <code>embark-export</code>
│ │ │ │ │                to get
│ │ │ │ │  an updated buffer.
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │ -          <div id="outline-container-org6d0a50a" class="outline-4">
│ │ │ │ │ -            <h4 id="org6d0a50a">
│ │ │ │ │ +          <div id="outline-container-org6e8887d" class="outline-4">
│ │ │ │ │ +            <h4 id="org6e8887d">
│ │ │ │ │                <span class="section-number-4">1.3.1.</span>
│ │ │ │ │                Selecting some targets to make an ad hoc candidate set
│ │ │ │ │              </h4>
│ │ │ │ │              <div class="outline-text-4" id="text-1-3-1">
│ │ │ │ │                <p>
│ │ │ │ │                  The commands for working with sets of candidates just described,
│ │ │ │ │  namely
│ │ │ │ │ @@ -833,16 +833,16 @@
│ │ │ │ │  complex editing operations. For example, if you have three
│ │ │ │ │  paragraphs scattered over a file and you want to bring them
│ │ │ │ │  together, you can select each one, insert them all somewhere and
│ │ │ │ │  finally delete all of them (from their original locations).</li>
│ │ │ │ │                </ul>
│ │ │ │ │              </div>
│ │ │ │ │            </div>
│ │ │ │ │ -          <div id="outline-container-org31f7502" class="outline-4">
│ │ │ │ │ -            <h4 id="org31f7502">
│ │ │ │ │ +          <div id="outline-container-org99689e8" class="outline-4">
│ │ │ │ │ +            <h4 id="org99689e8">
│ │ │ │ │                <span class="section-number-4">1.3.2.</span>
│ │ │ │ │                <code>embark-live</code>
│ │ │ │ │                a live-updating variant of
│ │ │ │ │                <code>embark-collect</code>
│ │ │ │ │              </h4>
│ │ │ │ │              <div class="outline-text-4" id="text-1-3-2">
│ │ │ │ │                <p>
│ │ │ │ │ @@ -883,16 +883,16 @@
│ │ │ │ │                  . Those collectors really do give
│ │ │ │ │                  <code>embark-live</code>
│ │ │ │ │                  a table-of-contents feel.
│ │ │ │ │                </p>
│ │ │ │ │              </div>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org3d700db" class="outline-3">
│ │ │ │ │ -          <h3 id="org3d700db">
│ │ │ │ │ +        <div id="outline-container-orgc7d9ab0" class="outline-3">
│ │ │ │ │ +          <h3 id="orgc7d9ab0">
│ │ │ │ │              <span class="section-number-3">1.4.</span>
│ │ │ │ │              Switching to a different command without losing what you've typed
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-1-4">
│ │ │ │ │              <p>
│ │ │ │ │                Embark also has the
│ │ │ │ │                <code>embark-become</code>
│ │ │ │ │ @@ -993,16 +993,16 @@
│ │ │ │ │  switch to
│ │ │ │ │                <code>find-file</code>
│ │ │ │ │                .
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-org7d203a4" class="outline-2">
│ │ │ │ │ -        <h2 id="org7d203a4">
│ │ │ │ │ +      <div id="outline-container-org46d40f1" class="outline-2">
│ │ │ │ │ +        <h2 id="org46d40f1">
│ │ │ │ │            <span class="section-number-2">2.</span>
│ │ │ │ │            Quick start
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-2">
│ │ │ │ │            <p>
│ │ │ │ │              The easiest way to install Embark is
│ │ │ │ │              <code>apt install elpa-embark</code>
│ │ │ │ │ @@ -1216,22 +1216,22 @@
│ │ │ │ │              ) or Ivy user you are unlikely to want Embark since
│ │ │ │ │  those packages include comprehensive functionality for acting on
│ │ │ │ │  minibuffer completion candidates. (Embark does come with Ivy
│ │ │ │ │  integration despite this.)
│ │ │ │ │            </p>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-orga866d57" class="outline-2">
│ │ │ │ │ -        <h2 id="orga866d57">
│ │ │ │ │ +      <div id="outline-container-orgf10470d" class="outline-2">
│ │ │ │ │ +        <h2 id="orgf10470d">
│ │ │ │ │            <span class="section-number-2">3.</span>
│ │ │ │ │            Advanced configuration
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-3"/>
│ │ │ │ │ -        <div id="outline-container-org3f16e55" class="outline-3">
│ │ │ │ │ -          <h3 id="org3f16e55">
│ │ │ │ │ +        <div id="outline-container-orgd2543bf" class="outline-3">
│ │ │ │ │ +          <h3 id="orgd2543bf">
│ │ │ │ │              <span class="section-number-3">3.1.</span>
│ │ │ │ │              Showing information about available targets and actions
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-1">
│ │ │ │ │              <p>
│ │ │ │ │                By default, if you run
│ │ │ │ │                <code>embark-act</code>
│ │ │ │ │ @@ -1320,16 +1320,16 @@
│ │ │ │ │                <code>which-key</code>
│ │ │ │ │                -like display that also lets you use completion to narrow
│ │ │ │ │  down the list of alternatives, described at the end of the next
│ │ │ │ │  section.
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-orgdec3cba" class="outline-3">
│ │ │ │ │ -          <h3 id="orgdec3cba">
│ │ │ │ │ +        <div id="outline-container-org18604e2" class="outline-3">
│ │ │ │ │ +          <h3 id="org18604e2">
│ │ │ │ │              <span class="section-number-3">3.2.</span>
│ │ │ │ │              Selecting commands via completions instead of key bindings
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-2">
│ │ │ │ │              <p>
│ │ │ │ │                As an alternative to reading the list of actions in the verbose or
│ │ │ │ │  mixed indicators (see the previous section for a description of
│ │ │ │ │ @@ -1425,16 +1425,16 @@
│ │ │ │ │                <code>M-B</code>
│ │ │ │ │                , and
│ │ │ │ │                <code>M-U</code>
│ │ │ │ │                for manually switching between layouts in Vertico
│ │ │ │ │  buffers.
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │ -          <div id="outline-container-org4af3eda" class="outline-4">
│ │ │ │ │ -            <h4 id="org4af3eda">
│ │ │ │ │ +          <div id="outline-container-org8dc7588" class="outline-4">
│ │ │ │ │ +            <h4 id="org8dc7588">
│ │ │ │ │                <span class="section-number-4">3.2.1.</span>
│ │ │ │ │                Selecting commands via completion outside of Embark
│ │ │ │ │              </h4>
│ │ │ │ │              <div class="outline-text-4" id="text-3-2-1">
│ │ │ │ │                <p>If you like this completion interface for exploring key bindings for
│ │ │ │ │  Embark actions, you may want to use it elsewhere in Emacs. You can use
│ │ │ │ │  Embark's completion-based command prompter to list:</p>
│ │ │ │ │ @@ -1489,16 +1489,16 @@
│ │ │ │ │  it with a
│ │ │ │ │                  <code>C-u</code>
│ │ │ │ │                  prefix argument.
│ │ │ │ │                </p>
│ │ │ │ │              </div>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org2cd7e05" class="outline-3">
│ │ │ │ │ -          <h3 id="org2cd7e05">
│ │ │ │ │ +        <div id="outline-container-org96d3bbc" class="outline-3">
│ │ │ │ │ +          <h3 id="org96d3bbc">
│ │ │ │ │              <span class="section-number-3">3.3.</span>
│ │ │ │ │              Quitting the minibuffer after an action
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-3">
│ │ │ │ │              <p>
│ │ │ │ │                By default, if you call
│ │ │ │ │                <code>embark-act</code>
│ │ │ │ │ @@ -1593,16 +1593,16 @@
│ │ │ │ │                  <span style="font-weight: bold;">let</span>
│ │ │ │ │                  ((embark-quit-after-action nil))
│ │ │ │ │      (embark-act)))
│ │ │ │ │                </pre>
│ │ │ │ │              </div>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org79a7f25" class="outline-3">
│ │ │ │ │ -          <h3 id="org79a7f25">
│ │ │ │ │ +        <div id="outline-container-org4f1bb8b" class="outline-3">
│ │ │ │ │ +          <h3 id="org4f1bb8b">
│ │ │ │ │              <span class="section-number-3">3.4.</span>
│ │ │ │ │              Running some setup after injecting the target
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-4">
│ │ │ │ │              <p>
│ │ │ │ │                You can customize what happens after the target is inserted at the
│ │ │ │ │  minibuffer prompt of an action. There are
│ │ │ │ │ @@ -1716,16 +1716,16 @@
│ │ │ │ │  typically do
│ │ │ │ │                <i>not</i>
│ │ │ │ │                want the target, that is the contents of the region,
│ │ │ │ │  to be entered at that prompt!
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-orgbbf6bf6" class="outline-3">
│ │ │ │ │ -          <h3 id="orgbbf6bf6">
│ │ │ │ │ +        <div id="outline-container-org5809034" class="outline-3">
│ │ │ │ │ +          <h3 id="org5809034">
│ │ │ │ │              <span class="section-number-3">3.5.</span>
│ │ │ │ │              Running hooks before, after or around an action
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-5">
│ │ │ │ │              <p>
│ │ │ │ │                Embark has three variables,
│ │ │ │ │                <code>embark-pre-action-hooks</code>
│ │ │ │ │ @@ -1909,16 +1909,16 @@
│ │ │ │ │                </dt>
│ │ │ │ │                <dd>Run the action restoring point at the end.
│ │ │ │ │  The current default configuration doesn't use this but it is
│ │ │ │ │  available for users.</dd>
│ │ │ │ │              </dl>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org7f66113" class="outline-3">
│ │ │ │ │ -          <h3 id="org7f66113">
│ │ │ │ │ +        <div id="outline-container-orgdd86126" class="outline-3">
│ │ │ │ │ +          <h3 id="orgdd86126">
│ │ │ │ │              <span class="section-number-3">3.6.</span>
│ │ │ │ │              Creating your own keymaps
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-6">
│ │ │ │ │              <p>
│ │ │ │ │                All internal keymaps are defined with the standard helper macro
│ │ │ │ │                <code>defvar-keymap</code>
│ │ │ │ │ @@ -1953,29 +1953,29 @@
│ │ │ │ │                <code>embark-export</code>
│ │ │ │ │                are also made available via
│ │ │ │ │                <code>embark-general-map</code>
│ │ │ │ │                .
│ │ │ │ │              </p>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org2f212d3" class="outline-3">
│ │ │ │ │ -          <h3 id="org2f212d3">
│ │ │ │ │ +        <div id="outline-container-org20b3b0a" class="outline-3">
│ │ │ │ │ +          <h3 id="org20b3b0a">
│ │ │ │ │              <span class="section-number-3">3.7.</span>
│ │ │ │ │              Defining actions for new categories of targets
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-3-7">
│ │ │ │ │              <p>It is easy to configure Embark to provide actions for new types of
│ │ │ │ │  targets, either in the minibuffer or outside it. I present below two
│ │ │ │ │  very detailed examples of how to do this. At several points I'll
│ │ │ │ │  explain more than one way to proceed, typically with the easiest
│ │ │ │ │  option first. I include the alternative options since there will be
│ │ │ │ │  similar situations where the easiest option is not available.</p>
│ │ │ │ │            </div>
│ │ │ │ │ -          <div id="outline-container-orgfa958ec" class="outline-4">
│ │ │ │ │ -            <h4 id="orgfa958ec">
│ │ │ │ │ +          <div id="outline-container-orgcc8cfe1" class="outline-4">
│ │ │ │ │ +            <h4 id="orgcc8cfe1">
│ │ │ │ │                <span class="section-number-4">3.7.1.</span>
│ │ │ │ │                New minibuffer target example - tab-bar tabs
│ │ │ │ │              </h4>
│ │ │ │ │              <div class="outline-text-4" id="text-3-7-1">
│ │ │ │ │                <p>
│ │ │ │ │                  As an example, take the new
│ │ │ │ │                  <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Tab-Bars">tab bars</a>
│ │ │ │ │ @@ -1987,15 +1987,15 @@
│ │ │ │ │  you would need to: (1) make sure Embark knows those commands deal with
│ │ │ │ │  tabs, (2) define a keymap for tab actions and configure Embark so it
│ │ │ │ │  knows that's the keymap you want.
│ │ │ │ │                </p>
│ │ │ │ │              </div>
│ │ │ │ │              <ol class="org-ol">
│ │ │ │ │                <li>
│ │ │ │ │ -                <a id="org97fbbf5"/>
│ │ │ │ │ +                <a id="org1724e52"/>
│ │ │ │ │                  Telling Embark about commands that prompt for tabs by name
│ │ │ │ │                  <br/>
│ │ │ │ │                  <div class="outline-text-5" id="text-3-7-1-1">
│ │ │ │ │                    <p>
│ │ │ │ │                      For step (1), it would be great if the
│ │ │ │ │                      <code>tab-bar-mode</code>
│ │ │ │ │                      commands reported
│ │ │ │ │ @@ -2113,15 +2113,15 @@
│ │ │ │ │                      <code>tab-bar-*-bar-by-name</code>
│ │ │ │ │                      commands at once, also, you enhance built-in
│ │ │ │ │  commands, instead of defining new ones.
│ │ │ │ │                    </p>
│ │ │ │ │                  </div>
│ │ │ │ │                </li>
│ │ │ │ │                <li>
│ │ │ │ │ -                <a id="orga4f1455"/>
│ │ │ │ │ +                <a id="org524cf99"/>
│ │ │ │ │                  Defining and configuring a keymap for tab actions
│ │ │ │ │                  <br/>
│ │ │ │ │                  <div class="outline-text-5" id="text-3-7-1-2">
│ │ │ │ │                    <p>Let's say we want to offer select, rename and close actions for tabs
│ │ │ │ │  (in addition to Embark general actions, such as saving the tab name to
│ │ │ │ │  the kill-ring, which you get for free). Then this will do:</p>
│ │ │ │ │                    <div class="org-src-container">
│ │ │ │ │ @@ -2201,16 +2201,16 @@
│ │ │ │ │                        </p>
│ │ │ │ │                      </li>
│ │ │ │ │                    </ol>
│ │ │ │ │                  </div>
│ │ │ │ │                </li>
│ │ │ │ │              </ol>
│ │ │ │ │            </div>
│ │ │ │ │ -          <div id="outline-container-orge60ed4f" class="outline-4">
│ │ │ │ │ -            <h4 id="orge60ed4f">
│ │ │ │ │ +          <div id="outline-container-orgb3891aa" class="outline-4">
│ │ │ │ │ +            <h4 id="orgb3891aa">
│ │ │ │ │                <span class="section-number-4">3.7.2.</span>
│ │ │ │ │                New target example in regular buffers - short Wikipedia links
│ │ │ │ │              </h4>
│ │ │ │ │              <div class="outline-text-4" id="text-3-7-2">
│ │ │ │ │                <p>
│ │ │ │ │                  Say you want to teach Embark to treat text of the form
│ │ │ │ │                  <code>wikipedia:Garry_Kasparov</code>
│ │ │ │ │ @@ -2293,16 +2293,16 @@
│ │ │ │ │  (add-to-list 'embark-target-finders 'my-short-wikipedia-link)
│ │ │ │ │                  </pre>
│ │ │ │ │                </div>
│ │ │ │ │              </div>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-orge3871d0" class="outline-2">
│ │ │ │ │ -        <h2 id="orge3871d0">
│ │ │ │ │ +      <div id="outline-container-orga35193f" class="outline-2">
│ │ │ │ │ +        <h2 id="orga35193f">
│ │ │ │ │            <span class="section-number-2">4.</span>
│ │ │ │ │            How does Embark call the actions?
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-4">
│ │ │ │ │            <p>
│ │ │ │ │              Embark actions are normal Emacs commands, that is, functions with an
│ │ │ │ │  interactive specification. In order to execute an action, Embark
│ │ │ │ │ @@ -2474,16 +2474,16 @@
│ │ │ │ │              more emphatic.
│ │ │ │ │  This ability to pass prefix arguments to actions is useful for some
│ │ │ │ │  actions in the default configuration, such as
│ │ │ │ │              <code>embark-shell-command-on-buffer</code>
│ │ │ │ │              .
│ │ │ │ │            </p>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org198a9d0" class="outline-3">
│ │ │ │ │ -          <h3 id="org198a9d0">
│ │ │ │ │ +        <div id="outline-container-org8372882" class="outline-3">
│ │ │ │ │ +          <h3 id="org8372882">
│ │ │ │ │              <span class="section-number-3">4.1.</span>
│ │ │ │ │              Non-interactive functions as actions
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-4-1">
│ │ │ │ │              <p>Alternatively, Embark does support one other type of action: a
│ │ │ │ │  non-interactive function of a single argument. The target is passed
│ │ │ │ │  as argument to the function. For example:</p>
│ │ │ │ │ @@ -2523,16 +2523,16 @@
│ │ │ │ │                  some text properties, or even a
│ │ │ │ │  non-string target.
│ │ │ │ │                </li>
│ │ │ │ │              </ol>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-orgcbcb91f" class="outline-2">
│ │ │ │ │ -        <h2 id="orgcbcb91f">
│ │ │ │ │ +      <div id="outline-container-orgee0c0d6" class="outline-2">
│ │ │ │ │ +        <h2 id="orgee0c0d6">
│ │ │ │ │            <span class="section-number-2">5.</span>
│ │ │ │ │            Embark, Marginalia and Consult
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-5">
│ │ │ │ │            <p>
│ │ │ │ │              Embark cooperates well with the Marginalia (
│ │ │ │ │              <code>apt install elpa-marginalia</code>
│ │ │ │ │ @@ -2543,16 +2543,16 @@
│ │ │ │ │  highly recommended companions to Embark, for opposite reasons:
│ │ │ │ │  Marginalia greatly enhances Embark's usefulness, while Embark can help
│ │ │ │ │  enhance Consult.
│ │ │ │ │            </p>
│ │ │ │ │            <p>In the remainder of this section I'll explain what exactly Marginalia
│ │ │ │ │  does for Embark, and what Embark can do for Consult.</p>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-org6dee493" class="outline-3">
│ │ │ │ │ -          <h3 id="org6dee493">
│ │ │ │ │ +        <div id="outline-container-org207271f" class="outline-3">
│ │ │ │ │ +          <h3 id="org207271f">
│ │ │ │ │              <span class="section-number-3">5.1.</span>
│ │ │ │ │              Marginalia
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-5-1">
│ │ │ │ │              <p>
│ │ │ │ │                Embark comes with actions for symbols (commands, functions, variables
│ │ │ │ │  with actions such as finding the definition, looking up the
│ │ │ │ │ @@ -2597,16 +2597,16 @@
│ │ │ │ │  characters in
│ │ │ │ │                  <code>C-x 8 RET</code>
│ │ │ │ │                  ).
│ │ │ │ │                </li>
│ │ │ │ │              </ul>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │ -        <div id="outline-container-orgaf59cf2" class="outline-3">
│ │ │ │ │ -          <h3 id="orgaf59cf2">
│ │ │ │ │ +        <div id="outline-container-org8ef19c9" class="outline-3">
│ │ │ │ │ +          <h3 id="org8ef19c9">
│ │ │ │ │              <span class="section-number-3">5.2.</span>
│ │ │ │ │              Consult
│ │ │ │ │            </h3>
│ │ │ │ │            <div class="outline-text-3" id="text-5-2">
│ │ │ │ │              <p>
│ │ │ │ │                The excellent Consult package provides many commands that use
│ │ │ │ │  minibuffer completion, via the
│ │ │ │ │ @@ -2783,16 +2783,16 @@
│ │ │ │ │  the location if it matches a unique imenu entry, otherwise it will
│ │ │ │ │  leave the minibuffer open so you can navigate among the matches.
│ │ │ │ │                </li>
│ │ │ │ │              </ul>
│ │ │ │ │            </div>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-org34fbc10" class="outline-2">
│ │ │ │ │ -        <h2 id="org34fbc10">
│ │ │ │ │ +      <div id="outline-container-org9dfd536" class="outline-2">
│ │ │ │ │ +        <h2 id="org9dfd536">
│ │ │ │ │            <span class="section-number-2">6.</span>
│ │ │ │ │            Related Packages
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-6">
│ │ │ │ │            <p>There are several packages that offer functionality similar
│ │ │ │ │  to Embark's.</p>
│ │ │ │ │            <dl class="org-dl">
│ │ │ │ │ @@ -2825,16 +2825,16 @@
│ │ │ │ │                <code>ivy-occur</code>
│ │ │ │ │                only works for commands written using
│ │ │ │ │  the Ivy API.
│ │ │ │ │              </dd>
│ │ │ │ │            </dl>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-orgdb14532" class="outline-2">
│ │ │ │ │ -        <h2 id="orgdb14532">
│ │ │ │ │ +      <div id="outline-container-org3de7646" class="outline-2">
│ │ │ │ │ +        <h2 id="org3de7646">
│ │ │ │ │            <span class="section-number-2">7.</span>
│ │ │ │ │            Resources
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-7">
│ │ │ │ │            <p>If you want to learn more about how others have used Embark here are
│ │ │ │ │  some links to read:</p>
│ │ │ │ │            <ul class="org-ul">
│ │ │ │ │ @@ -2873,16 +2873,16 @@
│ │ │ │ │                <a href="https://youtu.be/5ffb2at2d7w">Using Emacs Episode 80 - Vertico, Marginalia, Consult and Embark</a>
│ │ │ │ │                by
│ │ │ │ │  Mike Zamansky.
│ │ │ │ │              </li>
│ │ │ │ │            </ul>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-orgb1cd77b" class="outline-2">
│ │ │ │ │ -        <h2 id="orgb1cd77b">
│ │ │ │ │ +      <div id="outline-container-orgebd1b61" class="outline-2">
│ │ │ │ │ +        <h2 id="orgebd1b61">
│ │ │ │ │            <span class="section-number-2">8.</span>
│ │ │ │ │            Contributions
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-8">
│ │ │ │ │            <p>
│ │ │ │ │              Contributions to Embark are very welcome. There is a
│ │ │ │ │              <a href="https://github.com/oantolin/embark/issues/95">wish list</a>
│ │ │ │ │ @@ -2897,16 +2897,16 @@
│ │ │ │ │              .
│ │ │ │ │            </p>
│ │ │ │ │            <p>Code contributions are very welcome too, but since Embark is now on
│ │ │ │ │  GNU ELPA, copyright assignment to the FSF is required before you can
│ │ │ │ │  contribute code.</p>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │ -      <div id="outline-container-orgfea3c58" class="outline-2">
│ │ │ │ │ -        <h2 id="orgfea3c58">
│ │ │ │ │ +      <div id="outline-container-orgdecd8cf" class="outline-2">
│ │ │ │ │ +        <h2 id="orgdecd8cf">
│ │ │ │ │            <span class="section-number-2">9.</span>
│ │ │ │ │            Acknowledgments
│ │ │ │ │          </h2>
│ │ │ │ │          <div class="outline-text-2" id="text-9">
│ │ │ │ │            <p>While I, Omar Antolín Camarena, have written most of the Embark code
│ │ │ │ │  and remain very stubborn about some of the design decisions, Embark
│ │ │ │ │  has received substantial help from a number of other people which this
│ │ │ │ │ @@ -2992,14 +2992,14 @@
│ │ │ │ │              </li>
│ │ │ │ │            </ul>
│ │ │ │ │          </div>
│ │ │ │ │        </div>
│ │ │ │ │      </div>
│ │ │ │ │      <div id="postamble" class="status">
│ │ │ │ │        <p class="author">Author: Omar AntolÃ­n Camarena</p>
│ │ │ │ │ -      <p class="date">Created: 2024-09-22 Sun 16:00</p>
│ │ │ │ │ +      <p class="date">Created: 2025-10-25 Sat 22:25</p>
│ │ │ │ │        <p class="validation">
│ │ │ │ │          <a href="https://validator.w3.org/check?uri=referer">Validate</a>
│ │ │ │ │        </p>
│ │ │ │ │      </div>
│ │ │ │ │    </body>
│ │ │ │ │  </html>
