summaryrefslogtreecommitdiff
path: root/.localrepo/embark-consult-1.1.tar
blob: 0d08a66a11e4fc7ae1a7895a7b4f7501f28d0155 (plain)
ofshex dumpascii
0000 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 00 00 00 00 00 00 00 00 00 00 00 00 00 embark-consult-1.1/.............
0020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0060 00 00 00 00 30 30 30 30 37 35 35 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000755.0000000.0000000.0000
0080 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 32 37 34 30 00 20 35 00 00 00 0000000.00000000000.012740..5...
00a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
00c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
00e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0100 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
0120 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
0140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
01a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
01c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
01e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0200 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 52 45 41 44 4d 45 2e 6f 72 67 00 00 00 embark-consult-1.1/README.org...
0220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0260 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
0280 30 31 37 33 33 33 34 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 34 34 32 31 00 20 30 00 00 00 0173334.00000000000.014421..0...
02a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
02c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
02e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0300 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
0320 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
0340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
03a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
03c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
03e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
0400 23 2b 54 49 54 4c 45 3a 20 45 6d 62 61 72 6b 3a 20 45 6d 61 63 73 20 4d 69 6e 69 2d 42 75 66 66 #+TITLE:.Embark:.Emacs.Mini-Buff
0420 65 72 20 41 63 74 69 6f 6e 73 20 52 6f 6f 74 65 64 20 69 6e 20 4b 65 79 6d 61 70 73 0a 23 2b 4f er.Actions.Rooted.in.Keymaps.#+O
0440 50 54 49 4f 4e 53 3a 20 64 3a 6e 69 6c 0a 23 2b 45 58 50 4f 52 54 5f 46 49 4c 45 5f 4e 41 4d 45 PTIONS:.d:nil.#+EXPORT_FILE_NAME
0460 3a 20 65 6d 62 61 72 6b 2e 74 65 78 69 0a 23 2b 54 45 58 49 4e 46 4f 5f 44 49 52 5f 43 41 54 45 :.embark.texi.#+TEXINFO_DIR_CATE
0480 47 4f 52 59 3a 20 45 6d 61 63 73 20 6d 69 73 63 20 66 65 61 74 75 72 65 73 0a 23 2b 54 45 58 49 GORY:.Emacs.misc.features.#+TEXI
04a0 4e 46 4f 5f 44 49 52 5f 54 49 54 4c 45 3a 20 45 6d 62 61 72 6b 3a 20 28 65 6d 62 61 72 6b 29 2e NFO_DIR_TITLE:.Embark:.(embark).
04c0 0a 23 2b 54 45 58 49 4e 46 4f 5f 44 49 52 5f 44 45 53 43 3a 20 45 6d 61 63 73 20 4d 69 6e 69 2d .#+TEXINFO_DIR_DESC:.Emacs.Mini-
04e0 42 75 66 66 65 72 20 41 63 74 69 6f 6e 73 20 52 6f 6f 74 65 64 20 69 6e 20 4b 65 79 6d 61 70 73 Buffer.Actions.Rooted.in.Keymaps
0500 0a 0a 23 2b 68 74 6d 6c 3a 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6c 70 61 2e 67 ..#+html:.<a.href="http://elpa.g
0520 6e 75 2e 6f 72 67 2f 70 61 63 6b 61 67 65 73 2f 65 6d 62 61 72 6b 2e 68 74 6d 6c 22 3e 3c 69 6d nu.org/packages/embark.html"><im
0540 67 20 61 6c 74 3d 22 47 4e 55 20 45 4c 50 41 22 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 65 6c g.alt="GNU.ELPA".src="https://el
0560 70 61 2e 67 6e 75 2e 6f 72 67 2f 70 61 63 6b 61 67 65 73 2f 65 6d 62 61 72 6b 2e 73 76 67 22 2f pa.gnu.org/packages/embark.svg"/
0580 3e 3c 2f 61 3e 0a 23 2b 68 74 6d 6c 3a 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6c ></a>.#+html:.<a.href="http://el
05a0 70 61 2e 67 6e 75 2e 6f 72 67 2f 64 65 76 65 6c 2f 65 6d 62 61 72 6b 2e 68 74 6d 6c 22 3e 3c 69 pa.gnu.org/devel/embark.html"><i
05c0 6d 67 20 61 6c 74 3d 22 47 4e 55 2d 64 65 76 65 6c 20 45 4c 50 41 22 20 73 72 63 3d 22 68 74 74 mg.alt="GNU-devel.ELPA".src="htt
05e0 70 73 3a 2f 2f 65 6c 70 61 2e 67 6e 75 2e 6f 72 67 2f 64 65 76 65 6c 2f 65 6d 62 61 72 6b 2e 73 ps://elpa.gnu.org/devel/embark.s
0600 76 67 22 2f 3e 3c 2f 61 3e 0a 23 2b 68 74 6d 6c 3a 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 vg"/></a>.#+html:.<a.href="https
0620 3a 2f 2f 6d 65 6c 70 61 2e 6f 72 67 2f 23 2f 65 6d 62 61 72 6b 22 3e 3c 69 6d 67 20 61 6c 74 3d ://melpa.org/#/embark"><img.alt=
0640 22 4d 45 4c 50 41 22 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 6d 65 6c 70 61 2e 6f 72 67 2f 70 "MELPA".src="https://melpa.org/p
0660 61 63 6b 61 67 65 73 2f 65 6d 62 61 72 6b 2d 62 61 64 67 65 2e 73 76 67 22 2f 3e 3c 2f 61 3e 0a ackages/embark-badge.svg"/></a>.
0680 23 2b 68 74 6d 6c 3a 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 73 74 61 62 6c 65 2e #+html:.<a.href="https://stable.
06a0 6d 65 6c 70 61 2e 6f 72 67 2f 23 2f 65 6d 62 61 72 6b 22 3e 3c 69 6d 67 20 61 6c 74 3d 22 4d 45 melpa.org/#/embark"><img.alt="ME
06c0 4c 50 41 20 53 74 61 62 6c 65 22 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 73 74 61 62 6c 65 2e LPA.Stable".src="https://stable.
06e0 6d 65 6c 70 61 2e 6f 72 67 2f 70 61 63 6b 61 67 65 73 2f 65 6d 62 61 72 6b 2d 62 61 64 67 65 2e melpa.org/packages/embark-badge.
0700 73 76 67 22 2f 3e 3c 2f 61 3e 0a 0a 2a 20 4f 76 65 72 76 69 65 77 0a 0a 45 6d 62 61 72 6b 20 6d svg"/></a>..*.Overview..Embark.m
0720 61 6b 65 73 20 69 74 20 65 61 73 79 20 74 6f 20 63 68 6f 6f 73 65 20 61 20 63 6f 6d 6d 61 6e 64 akes.it.easy.to.choose.a.command
0740 20 74 6f 20 72 75 6e 20 62 61 73 65 64 20 6f 6e 20 77 68 61 74 20 69 73 20 6e 65 61 72 0a 70 6f .to.run.based.on.what.is.near.po
0760 69 6e 74 2c 20 62 6f 74 68 20 64 75 72 69 6e 67 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f int,.both.during.a.minibuffer.co
0780 6d 70 6c 65 74 69 6f 6e 20 73 65 73 73 69 6f 6e 20 28 69 6e 20 61 20 77 61 79 20 66 61 6d 69 6c mpletion.session.(in.a.way.famil
07a0 69 61 72 0a 74 6f 20 48 65 6c 6d 20 6f 72 20 43 6f 75 6e 73 65 6c 20 75 73 65 72 73 29 20 61 6e iar.to.Helm.or.Counsel.users).an
07c0 64 20 69 6e 20 6e 6f 72 6d 61 6c 20 62 75 66 66 65 72 73 2e 20 42 69 6e 64 20 74 68 65 20 63 6f d.in.normal.buffers..Bind.the.co
07e0 6d 6d 61 6e 64 0a 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 74 6f 20 61 20 6b 65 79 20 61 6e 64 20 mmand.=embark-act=.to.a.key.and.
0800 69 74 20 61 63 74 73 20 6c 69 6b 65 20 70 72 65 66 69 78 2d 6b 65 79 20 66 6f 72 20 61 20 6b 65 it.acts.like.prefix-key.for.a.ke
0820 79 6d 61 70 20 6f 66 0a 2f 61 63 74 69 6f 6e 73 2f 20 28 63 6f 6d 6d 61 6e 64 73 29 20 72 65 6c ymap.of./actions/.(commands).rel
0840 65 76 61 6e 74 20 74 6f 20 74 68 65 20 2f 74 61 72 67 65 74 2f 20 61 72 6f 75 6e 64 20 70 6f 69 evant.to.the./target/.around.poi
0860 6e 74 2e 20 57 69 74 68 20 70 6f 69 6e 74 20 6f 6e 0a 61 6e 20 55 52 4c 20 69 6e 20 61 20 62 75 nt..With.point.on.an.URL.in.a.bu
0880 66 66 65 72 20 79 6f 75 20 63 61 6e 20 6f 70 65 6e 20 74 68 65 20 55 52 4c 20 69 6e 20 61 20 62 ffer.you.can.open.the.URL.in.a.b
08a0 72 6f 77 73 65 72 20 6f 72 20 65 77 77 20 6f 72 0a 64 6f 77 6e 6c 6f 61 64 20 74 68 65 20 66 69 rowser.or.eww.or.download.the.fi
08c0 6c 65 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 2e 20 49 66 20 77 68 69 6c 65 20 73 77 69 74 63 68 le.it.points.to..If.while.switch
08e0 69 6e 67 20 62 75 66 66 65 72 73 20 79 6f 75 20 73 70 6f 74 20 61 6e 0a 6f 6c 64 20 6f 6e 65 2c ing.buffers.you.spot.an.old.one,
0900 20 79 6f 75 20 63 61 6e 20 6b 69 6c 6c 20 69 74 20 72 69 67 68 74 20 74 68 65 72 65 20 61 6e 64 .you.can.kill.it.right.there.and
0920 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 73 65 6c 65 63 74 20 61 6e 6f 74 68 65 72 2e 0a 45 6d 62 .continue.to.select.another..Emb
0940 61 72 6b 20 63 6f 6d 65 73 20 70 72 65 63 6f 6e 66 69 67 75 72 65 64 20 77 69 74 68 20 6f 76 65 ark.comes.preconfigured.with.ove
0960 72 20 61 20 68 75 6e 64 72 65 64 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6d 6d 6f 6e 0a 74 r.a.hundred.actions.for.common.t
0980 79 70 65 73 20 6f 66 20 74 61 72 67 65 74 73 20 73 75 63 68 20 61 73 20 66 69 6c 65 73 2c 20 62 ypes.of.targets.such.as.files,.b
09a0 75 66 66 65 72 73 2c 20 69 64 65 6e 74 69 66 69 65 72 73 2c 20 73 2d 65 78 70 72 65 73 73 69 6f uffers,.identifiers,.s-expressio
09c0 6e 73 2c 0a 73 65 6e 74 65 6e 63 65 73 3b 20 61 6e 64 20 69 74 20 69 73 20 65 61 73 79 20 74 6f ns,.sentences;.and.it.is.easy.to
09e0 20 61 64 64 20 6d 6f 72 65 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 6d 6f 72 65 20 74 61 72 67 65 .add.more.actions.and.more.targe
0a00 74 20 74 79 70 65 73 2e 0a 45 6d 62 61 72 6b 20 63 61 6e 20 61 6c 73 6f 20 63 6f 6c 6c 65 63 74 t.types..Embark.can.also.collect
0a20 20 61 6c 6c 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 69 6e 20 61 20 6d 69 6e 69 62 75 66 .all.the.candidates.in.a.minibuf
0a40 66 65 72 20 74 6f 20 61 6e 0a 6f 63 63 75 72 2d 6c 69 6b 65 20 62 75 66 66 65 72 20 6f 72 20 65 fer.to.an.occur-like.buffer.or.e
0a60 78 70 6f 72 74 20 74 68 65 6d 20 74 6f 20 61 20 62 75 66 66 65 72 20 69 6e 20 61 20 6d 61 6a 6f xport.them.to.a.buffer.in.a.majo
0a80 72 2d 6d 6f 64 65 20 73 70 65 63 69 66 69 63 0a 74 6f 20 74 68 65 20 74 79 70 65 20 6f 66 20 63 r-mode.specific.to.the.type.of.c
0aa0 61 6e 64 69 64 61 74 65 73 2c 20 73 75 63 68 20 61 73 20 64 69 72 65 64 20 66 6f 72 20 61 20 73 andidates,.such.as.dired.for.a.s
0ac0 65 74 20 6f 66 20 66 69 6c 65 73 2c 20 69 62 75 66 66 65 72 0a 66 6f 72 20 61 20 73 65 74 20 6f et.of.files,.ibuffer.for.a.set.o
0ae0 66 20 62 75 66 66 65 72 73 2c 20 6f 72 20 63 75 73 74 6f 6d 69 7a 65 20 66 6f 72 20 61 20 73 65 f.buffers,.or.customize.for.a.se
0b00 74 20 6f 66 20 76 61 72 69 61 62 6c 65 73 2e 0a 0a 2a 2a 20 41 63 74 69 6e 67 20 6f 6e 20 74 61 t.of.variables...**.Acting.on.ta
0b20 72 67 65 74 73 0a 0a 59 6f 75 20 63 61 6e 20 74 68 69 6e 6b 20 6f 66 20 3d 65 6d 62 61 72 6b 2d rgets..You.can.think.of.=embark-
0b40 61 63 74 3d 20 61 73 20 61 20 6b 65 79 62 6f 61 72 64 2d 62 61 73 65 64 20 76 65 72 73 69 6f 6e act=.as.a.keyboard-based.version
0b60 20 6f 66 20 61 0a 72 69 67 68 74 2d 63 6c 69 63 6b 20 63 6f 6e 74 65 78 74 75 61 6c 20 6d 65 6e .of.a.right-click.contextual.men
0b80 75 2e 20 54 68 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 63 6f 6d 6d 61 6e 64 20 28 77 68 69 u..The.=embark-act=.command.(whi
0ba0 63 68 20 79 6f 75 20 73 68 6f 75 6c 64 0a 62 69 6e 64 20 74 6f 20 61 20 63 6f 6e 76 65 6e 69 65 ch.you.should.bind.to.a.convenie
0bc0 6e 74 20 6b 65 79 29 2c 20 61 63 74 73 20 61 73 20 61 20 70 72 65 66 69 78 20 66 6f 72 20 61 20 nt.key),.acts.as.a.prefix.for.a.
0be0 6b 65 79 6d 61 70 20 6f 66 66 65 72 69 6e 67 20 79 6f 75 0a 72 65 6c 65 76 61 6e 74 20 2f 61 63 keymap.offering.you.relevant./ac
0c00 74 69 6f 6e 73 2f 20 74 6f 20 75 73 65 20 6f 6e 20 61 20 2f 74 61 72 67 65 74 2f 20 64 65 74 65 tions/.to.use.on.a./target/.dete
0c20 72 6d 69 6e 65 64 20 62 79 20 74 68 65 20 63 6f 6e 74 65 78 74 3a 0a 0a 2d 20 49 6e 20 74 68 65 rmined.by.the.context:..-.In.the
0c40 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 74 68 65 20 74 61 72 67 65 74 20 69 73 20 74 68 65 20 63 .minibuffer,.the.target.is.the.c
0c60 75 72 72 65 6e 74 20 74 6f 70 20 63 6f 6d 70 6c 65 74 69 6f 6e 0a 20 20 63 61 6e 64 69 64 61 74 urrent.top.completion...candidat
0c80 65 2e 0a 2d 20 49 6e 20 74 68 65 20 3d 2a 43 6f 6d 70 6c 65 74 69 6f 6e 73 2a 3d 20 62 75 66 66 e..-.In.the.=*Completions*=.buff
0ca0 65 72 20 74 68 65 20 74 61 72 67 65 74 20 69 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 er.the.target.is.the.completion.
0cc0 61 74 20 70 6f 69 6e 74 2e 0a 2d 20 49 6e 20 61 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 2c at.point..-.In.a.regular.buffer,
0ce0 20 74 68 65 20 74 61 72 67 65 74 20 69 73 20 74 68 65 20 72 65 67 69 6f 6e 20 69 66 20 61 63 74 .the.target.is.the.region.if.act
0d00 69 76 65 2c 20 6f 72 20 65 6c 73 65 20 74 68 65 0a 20 20 66 69 6c 65 2c 20 73 79 6d 62 6f 6c 2c ive,.or.else.the...file,.symbol,
0d20 20 55 52 4c 2c 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 64 65 66 75 6e 20 61 74 20 70 .URL,.s-expression.or.defun.at.p
0d40 6f 69 6e 74 2e 0a 0a 4d 75 6c 74 69 70 6c 65 20 74 61 72 67 65 74 73 20 63 61 6e 20 62 65 20 70 oint...Multiple.targets.can.be.p
0d60 72 65 73 65 6e 74 20 61 74 20 74 68 65 20 73 61 6d 65 20 6c 6f 63 61 74 69 6f 6e 20 61 6e 64 20 resent.at.the.same.location.and.
0d80 79 6f 75 20 63 61 6e 20 63 79 63 6c 65 0a 62 65 74 77 65 65 6e 20 74 68 65 6d 20 62 79 20 72 65 you.can.cycle.between.them.by.re
0da0 70 65 61 74 69 6e 67 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 6b 65 79 20 62 69 6e peating.the.=embark-act=.key.bin
0dc0 64 69 6e 67 2e 20 54 68 65 20 74 79 70 65 20 6f 66 0a 61 63 74 69 6f 6e 73 20 6f 66 66 65 72 65 ding..The.type.of.actions.offere
0de0 64 20 64 65 70 65 6e 64 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 74 61 72 67 d.depend.on.the.type.of.the.targ
0e00 65 74 2e 20 48 65 72 65 20 69 73 20 61 20 73 61 6d 70 6c 65 20 6f 66 0a 61 20 66 65 77 20 6f 66 et..Here.is.a.sample.of.a.few.of
0e20 20 74 68 65 20 61 63 74 69 6f 6e 73 20 6f 66 66 65 72 65 64 20 69 6e 20 74 68 65 20 64 65 66 61 .the.actions.offered.in.the.defa
0e40 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 2d 20 46 6f 72 20 66 69 6c 65 73 20 ult.configuration:..-.For.files.
0e60 79 6f 75 20 67 65 74 20 6f 66 66 65 72 65 64 20 61 63 74 69 6f 6e 73 20 6c 69 6b 65 20 64 65 6c you.get.offered.actions.like.del
0e80 65 74 69 6e 67 2c 20 63 6f 70 79 69 6e 67 2c 0a 20 20 72 65 6e 61 6d 69 6e 67 2c 20 76 69 73 69 eting,.copying,...renaming,.visi
0ea0 74 69 6e 67 20 69 6e 20 61 6e 6f 74 68 65 72 20 77 69 6e 64 6f 77 2c 20 72 75 6e 6e 69 6e 67 20 ting.in.another.window,.running.
0ec0 61 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 6f 6e 20 74 68 65 0a 20 20 66 69 6c 65 2c 20 65 a.shell.command.on.the...file,.e
0ee0 74 63 2e 0a 2d 20 46 6f 72 20 62 75 66 66 65 72 73 20 74 68 65 20 61 63 74 69 6f 6e 73 20 69 6e tc..-.For.buffers.the.actions.in
0f00 63 6c 75 64 65 20 73 77 69 74 63 68 69 6e 67 20 74 6f 20 6f 72 20 6b 69 6c 6c 69 6e 67 20 74 68 clude.switching.to.or.killing.th
0f20 65 20 62 75 66 66 65 72 2e 0a 2d 20 46 6f 72 20 70 61 63 6b 61 67 65 20 6e 61 6d 65 73 20 74 68 e.buffer..-.For.package.names.th
0f40 65 20 61 63 74 69 6f 6e 73 20 69 6e 63 6c 75 64 65 20 69 6e 73 74 61 6c 6c 69 6e 67 2c 20 72 65 e.actions.include.installing,.re
0f60 6d 6f 76 69 6e 67 20 6f 72 0a 20 20 76 69 73 69 74 69 6e 67 20 74 68 65 20 68 6f 6d 65 70 61 67 moving.or...visiting.the.homepag
0f80 65 2e 0a 2d 20 46 6f 72 20 45 6d 61 63 73 20 4c 69 73 70 20 73 79 6d 62 6f 6c 73 20 74 68 65 20 e..-.For.Emacs.Lisp.symbols.the.
0fa0 61 63 74 69 6f 6e 73 20 69 6e 63 6c 75 64 65 20 66 69 6e 64 69 6e 67 20 74 68 65 20 64 65 66 69 actions.include.finding.the.defi
0fc0 6e 69 74 69 6f 6e 2c 0a 20 20 6c 6f 6f 6b 69 6e 67 20 75 70 20 64 6f 63 75 6d 65 6e 74 61 74 69 nition,...looking.up.documentati
0fe0 6f 6e 2c 20 65 76 61 6c 75 61 74 69 6e 67 20 28 77 68 69 63 68 20 66 6f 72 20 61 20 76 61 72 69 on,.evaluating.(which.for.a.vari
1000 61 62 6c 65 0a 20 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 73 68 6f 77 73 20 74 68 65 20 76 61 6c able...immediately.shows.the.val
1020 75 65 2c 20 62 75 74 20 66 6f 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 6c 65 74 73 20 79 6f 75 20 ue,.but.for.a.function.lets.you.
1040 70 61 73 73 20 69 74 0a 20 20 73 6f 6d 65 20 61 72 67 75 6d 65 6e 74 73 20 66 69 72 73 74 29 2e pass.it...some.arguments.first).
1060 20 54 68 65 72 65 20 61 72 65 20 73 6f 6d 65 20 61 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69 63 .There.are.some.actions.specific
1080 20 74 6f 20 76 61 72 69 61 62 6c 65 73 2c 0a 20 20 73 75 63 68 20 61 73 20 73 65 74 74 69 6e 67 .to.variables,...such.as.setting
10a0 20 74 68 65 20 76 61 6c 75 65 20 64 69 72 65 63 74 6c 79 20 6f 72 20 74 68 6f 75 67 68 20 74 68 .the.value.directly.or.though.th
10c0 65 20 63 75 73 74 6f 6d 69 7a 65 20 73 79 73 74 65 6d 2c 0a 20 20 61 6e 64 20 73 6f 6d 65 20 61 e.customize.system,...and.some.a
10e0 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 2c 20 73 75 63 ctions.specific.to.commands,.suc
1100 68 20 61 73 20 62 69 6e 64 69 6e 67 20 69 74 20 74 6f 20 61 20 6b 65 79 2e 0a 0a 42 79 20 64 65 h.as.binding.it.to.a.key...By.de
1120 66 61 75 6c 74 20 77 68 65 6e 20 79 6f 75 20 75 73 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 fault.when.you.use.=embark-act=.
1140 69 66 20 79 6f 75 20 64 6f 6e 27 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 73 65 6c 65 63 74 20 if.you.don't.immediately.select.
1160 61 6e 0a 61 63 74 69 6f 6e 2c 20 61 66 74 65 72 20 61 20 73 68 6f 72 74 20 64 65 6c 61 79 20 45 an.action,.after.a.short.delay.E
1180 6d 62 61 72 6b 20 77 69 6c 6c 20 70 6f 70 20 75 70 20 61 20 62 75 66 66 65 72 20 73 68 6f 77 69 mbark.will.pop.up.a.buffer.showi
11a0 6e 67 20 61 20 6c 69 73 74 0a 6f 66 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 69 72 20 63 ng.a.list.of.actions.and.their.c
11c0 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 20 49 66 20 79 6f orresponding.key.bindings..If.yo
11e0 75 20 61 72 65 20 75 73 69 6e 67 0a 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 6f 75 74 73 69 64 65 u.are.using.=embark-act=.outside
1200 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 45 6d 62 61 72 6b 20 77 69 6c 6c 20 61 6c 73 .the.minibuffer,.Embark.will.als
1220 6f 20 68 69 67 68 6c 69 67 68 74 20 74 68 65 0a 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 2e 20 o.highlight.the.current.target..
1240 54 68 65 73 65 20 62 65 68 61 76 69 6f 72 73 20 61 72 65 20 63 6f 6e 66 69 67 75 72 61 62 6c 65 These.behaviors.are.configurable
1260 20 76 69 61 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 3d 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 .via.the.variable.=embark-indica
1280 74 6f 72 73 3d 2e 20 49 6e 73 74 65 61 64 20 6f 66 20 73 65 6c 65 63 74 69 6e 67 20 61 6e 20 61 tors=..Instead.of.selecting.an.a
12a0 63 74 69 6f 6e 20 76 69 61 20 69 74 73 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 0a 79 6f 75 20 63 ction.via.its.key.binding,.you.c
12c0 61 6e 20 73 65 6c 65 63 74 20 69 74 20 62 79 20 6e 61 6d 65 20 77 69 74 68 20 63 6f 6d 70 6c 65 an.select.it.by.name.with.comple
12e0 74 69 6f 6e 20 62 79 20 74 79 70 69 6e 67 20 3d 43 2d 68 3d 20 61 66 74 65 72 0a 3d 65 6d 62 61 tion.by.typing.=C-h=.after.=emba
1300 72 6b 2d 61 63 74 3d 2e 0a 0a 45 76 65 72 79 74 68 69 6e 67 20 69 73 20 65 61 73 69 6c 79 20 63 rk-act=...Everything.is.easily.c
1320 6f 6e 66 69 67 75 72 61 62 6c 65 3a 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 74 68 65 20 63 75 72 onfigurable:.determining.the.cur
1340 72 65 6e 74 20 74 61 72 67 65 74 2c 0a 63 6c 61 73 73 69 66 79 69 6e 67 20 69 74 2c 20 61 6e 64 rent.target,.classifying.it,.and
1360 20 64 65 63 69 64 69 6e 67 20 77 68 69 63 68 20 61 63 74 69 6f 6e 73 20 61 72 65 20 6f 66 66 65 .deciding.which.actions.are.offe
1380 72 65 64 20 66 6f 72 20 65 61 63 68 20 74 79 70 65 0a 69 6e 20 74 68 65 20 63 6c 61 73 73 69 66 red.for.each.type.in.the.classif
13a0 69 63 61 74 69 6f 6e 2e 20 54 68 65 20 61 62 6f 76 65 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 ication..The.above.introduction.
13c0 6a 75 73 74 20 6d 65 6e 74 69 6f 6e 73 20 70 61 72 74 20 6f 66 0a 74 68 65 20 64 65 66 61 75 6c just.mentions.part.of.the.defaul
13e0 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 0a 0a 43 6f 6e 66 69 67 75 72 69 6e 67 20 77 68 t.configuration...Configuring.wh
1400 69 63 68 20 61 63 74 69 6f 6e 73 20 61 72 65 20 6f 66 66 65 72 65 64 20 66 6f 72 20 61 20 74 79 ich.actions.are.offered.for.a.ty
1420 70 65 20 69 73 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 65 61 73 79 0a 61 6e 64 20 72 65 71 75 pe.is.particularly.easy.and.requ
1440 69 72 65 73 20 6e 6f 20 70 72 6f 67 72 61 6d 6d 69 6e 67 3a 20 74 68 65 20 76 61 72 69 61 62 6c ires.no.programming:.the.variabl
1460 65 20 3d 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 61 6c 69 73 74 3d 0a 61 73 73 6f 63 69 61 74 e.=embark-keymap-alist=.associat
1480 65 73 20 74 61 72 67 65 74 20 74 79 70 65 73 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 73 20 63 es.target.types.with.variables.c
14a0 6f 6e 74 61 69 6e 69 6e 67 20 6b 65 79 6d 61 70 73 2c 20 61 6e 64 20 74 68 6f 73 65 0a 6b 65 79 ontaining.keymaps,.and.those.key
14c0 6d 61 70 73 20 63 6f 6e 74 61 69 6e 69 6e 67 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 maps.containing.bindings.for.the
14e0 20 61 63 74 69 6f 6e 73 2e 20 28 54 6f 20 65 78 61 6d 69 6e 65 20 74 68 65 20 61 76 61 69 6c 61 .actions..(To.examine.the.availa
1500 62 6c 65 0a 63 61 74 65 67 6f 72 69 65 73 20 61 6e 64 20 74 68 65 69 72 20 61 73 73 6f 63 69 61 ble.categories.and.their.associa
1520 74 65 64 20 6b 65 79 6d 61 70 73 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 3d 43 2d 68 20 76 0a ted.keymaps,.you.can.use.=C-h.v.
1540 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 61 6c 69 73 74 3d 20 6f 72 20 63 75 73 74 6f 6d 69 7a embark-keymap-alist=.or.customiz
1560 65 20 74 68 61 74 20 76 61 72 69 61 62 6c 65 2e 29 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 e.that.variable.).For.example,.i
1580 6e 20 74 68 65 0a 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 65 20 n.the.default.configuration.the.
15a0 74 79 70 65 20 3d 66 69 6c 65 3d 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 type.=file=.is.associated.with.t
15c0 68 65 20 73 79 6d 62 6f 6c 0a 3d 65 6d 62 61 72 6b 2d 66 69 6c 65 2d 6d 61 70 3d 2e 20 54 68 61 he.symbol.=embark-file-map=..Tha
15e0 74 20 73 79 6d 62 6f 6c 20 6e 61 6d 65 73 20 61 20 6b 65 79 6d 61 70 20 77 69 74 68 20 73 69 6e t.symbol.names.a.keymap.with.sin
1600 67 6c 65 2d 6c 65 74 74 65 72 20 6b 65 79 0a 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 63 6f 6d 6d gle-letter.key.bindings.for.comm
1620 6f 6e 20 45 6d 61 63 73 20 66 69 6c 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 66 6f 72 20 69 6e 73 74 on.Emacs.file.commands,.for.inst
1640 61 6e 63 65 20 3d 63 3d 20 69 73 20 62 6f 75 6e 64 20 74 6f 0a 3d 63 6f 70 79 2d 66 69 6c 65 3d ance.=c=.is.bound.to.=copy-file=
1660 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 69 66 20 79 6f 75 20 61 72 65 20 69 6e 20 ..This.means.that.if.you.are.in.
1680 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 61 66 74 65 72 20 72 75 6e 6e 69 6e 67 0a 61 20 63 the.minibuffer.after.running.a.c
16a0 6f 6d 6d 61 6e 64 20 74 68 61 74 20 70 72 6f 6d 70 74 73 20 66 6f 72 20 61 20 66 69 6c 65 2c 20 ommand.that.prompts.for.a.file,.
16c0 73 75 63 68 20 61 73 20 3d 66 69 6e 64 2d 66 69 6c 65 3d 20 6f 72 20 3d 72 65 6e 61 6d 65 2d 66 such.as.=find-file=.or.=rename-f
16e0 69 6c 65 3d 2c 0a 79 6f 75 20 63 61 6e 20 63 6f 70 79 20 61 20 66 69 6c 65 20 62 79 20 72 75 6e ile=,.you.can.copy.a.file.by.run
1700 6e 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 61 6e 64 20 74 68 65 6e 20 70 72 65 73 73 ning.=embark-act=.and.then.press
1720 69 6e 67 20 3d 63 3d 2e 0a 0a 54 68 65 73 65 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 20 61 ing.=c=...These.action.keymaps.a
1740 72 65 20 76 65 72 79 20 63 6f 6e 76 65 6e 69 65 6e 74 20 62 75 74 20 6e 6f 74 20 73 74 72 69 63 re.very.convenient.but.not.stric
1760 74 6c 79 20 6e 65 63 65 73 73 61 72 79 0a 77 68 65 6e 20 75 73 69 6e 67 20 3d 65 6d 62 61 72 6b tly.necessary.when.using.=embark
1780 2d 61 63 74 3d 3a 20 79 6f 75 20 63 61 6e 20 75 73 65 20 61 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 -act=:.you.can.use.any.command.t
17a0 68 61 74 20 72 65 61 64 73 20 66 72 6f 6d 20 74 68 65 0a 6d 69 6e 69 62 75 66 66 65 72 20 61 73 hat.reads.from.the.minibuffer.as
17c0 20 61 6e 20 61 63 74 69 6f 6e 20 61 6e 64 20 74 68 65 20 74 61 72 67 65 74 20 6f 66 20 74 68 65 .an.action.and.the.target.of.the
17e0 20 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 65 64 0a 61 74 20 74 68 65 20 .action.will.be.inserted.at.the.
1800 66 69 72 73 74 20 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 2e 20 41 66 74 65 72 20 72 first.minibuffer.prompt..After.r
1820 75 6e 6e 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 61 6c 6c 20 6f 66 20 79 6f 75 72 0a unning.=embark-act=.all.of.your.
1840 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 61 6e 64 20 65 76 65 6e 20 3d 65 78 65 63 75 74 65 2d 65 key.bindings.and.even.=execute-e
1860 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 3d 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 xtended-command=.can.be.used.to.
1880 72 75 6e 20 61 0a 63 6f 6d 6d 61 6e 64 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 run.a.command..For.example,.if.y
18a0 6f 75 20 77 61 6e 74 20 74 6f 20 72 65 70 6c 61 63 65 20 61 6c 6c 20 6f 63 63 75 72 72 65 6e 63 ou.want.to.replace.all.occurrenc
18c0 65 73 20 6f 66 20 74 68 65 0a 73 79 6d 62 6f 6c 20 61 74 20 70 6f 69 6e 74 2c 20 6a 75 73 74 20 es.of.the.symbol.at.point,.just.
18e0 75 73 65 20 3d 4d 2d 25 3d 20 61 73 20 74 68 65 20 61 63 74 69 6f 6e 2c 20 74 68 65 72 65 20 69 use.=M-%=.as.the.action,.there.i
1900 73 20 6e 6f 20 6e 65 65 64 20 74 6f 20 62 69 6e 64 0a 3d 71 75 65 72 79 2d 72 65 70 6c 61 63 65 s.no.need.to.bind.=query-replace
1920 3d 20 69 6e 20 6f 6e 65 20 6f 66 20 45 6d 62 61 72 6b 27 73 20 6b 65 79 6d 61 70 73 2e 20 41 6c =.in.one.of.Embark's.keymaps..Al
1940 73 6f 2c 20 74 68 6f 73 65 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 0a 61 72 65 20 6e 6f 72 so,.those.action.keymaps.are.nor
1960 6d 61 6c 20 45 6d 61 63 73 20 6b 65 79 6d 61 70 73 20 61 6e 64 20 79 6f 75 20 73 68 6f 75 6c 64 mal.Emacs.keymaps.and.you.should
1980 20 66 65 65 6c 20 66 72 65 65 20 74 6f 20 62 69 6e 64 20 69 6e 20 74 68 65 6d 0a 77 68 61 74 65 .feel.free.to.bind.in.them.whate
19a0 76 65 72 20 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 20 66 69 6e 64 20 75 73 65 66 75 6c 20 61 73 20 ver.commands.you.find.useful.as.
19c0 61 63 74 69 6f 6e 73 20 61 6e 64 20 77 61 6e 74 20 74 6f 20 62 65 20 61 76 61 69 6c 61 62 6c 65 actions.and.want.to.be.available
19e0 0a 74 68 72 6f 75 67 68 20 63 6f 6e 76 65 6e 69 65 6e 74 20 62 69 6e 64 69 6e 67 73 2e 0a 0a 54 .through.convenient.bindings...T
1a00 68 65 20 61 63 74 69 6f 6e 73 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 he.actions.in.=embark-general-ma
1a20 70 3d 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 6e 6f 20 6d 61 74 74 65 72 20 77 68 61 74 20 p=.are.available.no.matter.what.
1a40 74 79 70 65 0a 6f 66 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 79 6f 75 20 61 72 65 20 69 6e 20 74 68 type.of.completion.you.are.in.th
1a60 65 20 6d 69 64 64 6c 65 20 6f 66 2e 20 42 79 20 64 65 66 61 75 6c 74 20 74 68 69 73 20 69 6e 63 e.middle.of..By.default.this.inc
1a80 6c 75 64 65 73 0a 62 69 6e 64 69 6e 67 73 20 74 6f 20 73 61 76 65 20 74 68 65 20 63 75 72 72 65 ludes.bindings.to.save.the.curre
1aa0 6e 74 20 63 61 6e 64 69 64 61 74 65 20 69 6e 20 74 68 65 20 6b 69 6c 6c 20 72 69 6e 67 20 61 6e nt.candidate.in.the.kill.ring.an
1ac0 64 20 74 6f 20 69 6e 73 65 72 74 0a 74 68 65 20 63 75 72 72 65 6e 74 20 63 61 6e 64 69 64 61 74 d.to.insert.the.current.candidat
1ae0 65 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 73 65 6c 65 63 74 65 64 20 62 75 66 e.in.the.previously.selected.buf
1b00 66 65 72 20 28 74 68 65 20 62 75 66 66 65 72 0a 74 68 61 74 20 77 61 73 20 63 75 72 72 65 6e 74 fer.(the.buffer.that.was.current
1b20 20 77 68 65 6e 20 79 6f 75 20 65 78 65 63 75 74 65 64 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 .when.you.executed.a.command.tha
1b40 74 20 6f 70 65 6e 65 64 20 75 70 20 74 68 65 0a 6d 69 6e 69 62 75 66 66 65 72 29 2e 0a 0a 45 6d t.opened.up.the.minibuffer)...Em
1b60 61 63 73 27 73 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 79 73 74 acs's.minibuffer.completion.syst
1b80 65 6d 20 69 6e 63 6c 75 64 65 73 20 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 61 74 69 6e 67 20 em.includes.metadata.indicating.
1ba0 74 68 65 0a 2f 63 61 74 65 67 6f 72 79 2f 20 6f 66 20 77 68 61 74 20 69 73 20 62 65 69 6e 67 20 the./category/.of.what.is.being.
1bc0 63 6f 6d 70 6c 65 74 65 64 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 3d 66 69 6e 64 2d 66 69 completed..For.example,.=find-fi
1be0 6c 65 3d 27 73 0a 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 61 74 65 67 le='s.metadata.indicates.a.categ
1c00 6f 72 79 20 6f 66 20 3d 66 69 6c 65 3d 20 61 6e 64 20 3d 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 ory.of.=file=.and.=switch-to-buf
1c20 66 65 72 3d 27 73 20 6d 65 74 61 64 61 74 61 0a 69 6e 64 69 63 61 74 65 73 20 61 20 63 61 74 65 fer='s.metadata.indicates.a.cate
1c40 67 6f 72 79 20 6f 66 20 3d 62 75 66 66 65 72 3d 2e 20 45 6d 62 61 72 6b 20 68 61 73 20 74 68 65 gory.of.=buffer=..Embark.has.the
1c60 20 72 65 6c 61 74 65 64 20 6e 6f 74 69 6f 6e 20 6f 66 20 74 68 65 0a 2f 74 79 70 65 2f 20 6f 66 .related.notion.of.the./type/.of
1c80 20 61 20 74 61 72 67 65 74 20 66 6f 72 20 61 63 74 69 6f 6e 73 2c 20 61 6e 64 20 62 79 20 64 65 .a.target.for.actions,.and.by.de
1ca0 66 61 75 6c 74 20 77 68 65 6e 20 63 61 74 65 67 6f 72 79 20 6d 65 74 61 64 61 74 61 0a 69 73 20 fault.when.category.metadata.is.
1cc0 70 72 65 73 65 6e 74 20 69 74 20 69 73 20 74 61 6b 65 6e 20 74 6f 20 62 65 20 74 68 65 20 74 79 present.it.is.taken.to.be.the.ty
1ce0 70 65 20 6f 66 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 0a 63 61 6e 64 pe.of.minibuffer.completion.cand
1d00 69 64 61 74 65 73 20 77 68 65 6e 20 75 73 65 64 20 61 73 20 74 61 72 67 65 74 73 2e 20 45 6d 61 idates.when.used.as.targets..Ema
1d20 63 73 20 63 6f 6d 6d 61 6e 64 73 20 6f 66 74 65 6e 20 64 6f 20 6e 6f 74 20 73 65 74 0a 75 73 65 cs.commands.often.do.not.set.use
1d40 66 75 6c 20 63 61 74 65 67 6f 72 79 20 6d 65 74 61 64 61 74 61 20 73 6f 20 74 68 65 20 5b 5b 68 ful.category.metadata.so.the.[[h
1d60 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 6d 61 72 67 69 6e 61 6c ttps://github.com/minad/marginal
1d80 69 61 5d 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 5d 20 70 61 63 6b 61 67 65 2c 20 77 68 69 63 68 20 ia][Marginalia]].package,.which.
1da0 73 75 70 70 6c 69 65 73 0a 74 68 69 73 20 6d 69 73 73 69 6e 67 20 6d 65 74 61 64 61 74 61 2c 20 supplies.this.missing.metadata,.
1dc0 69 73 20 68 69 67 68 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 77 69 is.highly.recommended.for.use.wi
1de0 74 68 20 45 6d 62 61 72 6b 2e 0a 0a 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 20 63 6f 6e th.Embark...Embark's.default.con
1e00 66 69 67 75 72 61 74 69 6f 6e 20 68 61 73 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 66 figuration.has.actions.for.the.f
1e20 6f 6c 6c 6f 77 69 6e 67 20 74 61 72 67 65 74 0a 74 79 70 65 73 3a 20 66 69 6c 65 73 2c 20 62 75 ollowing.target.types:.files,.bu
1e40 66 66 65 72 73 2c 20 73 79 6d 62 6f 6c 73 2c 20 70 61 63 6b 61 67 65 73 2c 20 55 52 4c 73 2c 20 ffers,.symbols,.packages,.URLs,.
1e60 62 6f 6f 6b 6d 61 72 6b 73 2c 20 61 6e 64 20 61 73 20 61 0a 73 6f 6d 65 77 68 61 74 20 73 70 65 bookmarks,.and.as.a.somewhat.spe
1e80 63 69 61 6c 20 63 61 73 65 2c 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 77 68 65 6e 20 74 68 65 20 cial.case,.actions.for.when.the.
1ea0 72 65 67 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 20 59 6f 75 20 63 61 6e 0a 72 65 61 64 20 61 region.is.active..You.can.read.a
1ec0 62 6f 75 74 20 74 68 65 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 bout.the.[[https://github.com/oa
1ee0 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 77 69 6b 69 2f 44 65 66 61 75 6c 74 2d 41 63 74 69 6f ntolin/embark/wiki/Default-Actio
1f00 6e 73 5d 5b 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 69 72 20 6b 65 ns][default.actions.and.their.ke
1f20 79 20 62 69 6e 64 69 6e 67 73 5d 5d 20 6f 6e 20 74 68 65 20 47 69 74 48 75 62 0a 70 72 6f 6a 65 y.bindings]].on.the.GitHub.proje
1f40 63 74 20 77 69 6b 69 2e 0a 0a 2a 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 ct.wiki...**.The.default.action.
1f60 6f 6e 20 61 20 74 61 72 67 65 74 0a 0a 45 6d 62 61 72 6b 20 68 61 73 20 61 20 6e 6f 74 69 6f 6e on.a.target..Embark.has.a.notion
1f80 20 6f 66 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 66 6f 72 20 61 20 74 61 72 67 65 74 3a .of.default.action.for.a.target:
1fa0 0a 0a 2d 20 49 66 20 74 68 65 20 74 61 72 67 65 74 20 69 73 20 61 20 6d 69 6e 69 62 75 66 66 65 ..-.If.the.target.is.a.minibuffe
1fc0 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 2c 20 74 68 65 6e 20 74 68 65 r.completion.candidate,.then.the
1fe0 20 64 65 66 61 75 6c 74 0a 20 20 61 63 74 69 6f 6e 20 69 73 20 77 68 61 74 65 76 65 72 20 63 6f .default...action.is.whatever.co
2000 6d 6d 61 6e 64 20 6f 70 65 6e 65 64 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 6e 20 74 mmand.opened.the.minibuffer.in.t
2020 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 69 66 he.first.place....For.example.if
2040 20 79 6f 75 20 72 75 6e 20 3d 6b 69 6c 6c 2d 62 75 66 66 65 72 3d 2c 20 74 68 65 6e 20 74 68 65 .you.run.=kill-buffer=,.then.the
2060 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 0a 20 20 74 6f 20 6b 69 6c .default.action.will.be...to.kil
2080 6c 20 62 75 66 66 65 72 73 2e 0a 2d 20 49 66 20 74 68 65 20 74 61 72 67 65 74 20 63 6f 6d 65 73 l.buffers..-.If.the.target.comes
20a0 20 66 72 6f 6d 20 61 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 20 28 69 2e 65 2e 2c 20 6e 6f .from.a.regular.buffer.(i.e.,.no
20c0 74 20 61 20 6d 69 6e 69 62 75 66 66 65 72 29 2c 0a 20 20 74 68 65 6e 20 74 68 65 20 64 65 66 61 t.a.minibuffer),...then.the.defa
20e0 75 6c 74 20 61 63 74 69 6f 6e 20 69 73 20 77 68 61 74 65 76 65 72 20 69 73 20 62 6f 75 6e 64 20 ult.action.is.whatever.is.bound.
2100 74 6f 20 3d 52 45 54 3d 20 69 6e 20 74 68 65 20 6b 65 79 6d 61 70 20 6f 66 0a 20 20 61 63 74 69 to.=RET=.in.the.keymap.of...acti
2120 6f 6e 73 20 66 6f 72 20 74 68 61 74 20 74 79 70 65 20 6f 66 20 74 61 72 67 65 74 2e 20 46 6f 72 ons.for.that.type.of.target..For
2140 20 65 78 61 6d 70 6c 65 2c 20 69 6e 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 0a 20 20 .example,.in.Embark's.default...
2160 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 6f 72 20 61 20 55 52 4c 20 66 6f 75 6e 64 20 61 74 configuration.for.a.URL.found.at
2180 20 70 6f 69 6e 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 69 73 0a 20 20 3d .point.the.default.action.is...=
21a0 62 72 6f 77 73 65 2d 75 72 6c 3d 2c 20 62 65 63 61 75 73 65 20 3d 52 45 54 3d 20 69 73 20 62 6f browse-url=,.because.=RET=.is.bo
21c0 75 6e 64 20 74 6f 20 3d 62 72 6f 77 73 65 2d 75 72 6c 3d 20 69 6e 20 74 68 65 20 3d 65 6d 62 61 und.to.=browse-url=.in.the.=emba
21e0 72 6b 2d 75 72 6c 2d 6d 61 70 3d 0a 20 20 6b 65 79 6d 61 70 2e 0a 0a 54 6f 20 72 75 6e 20 74 68 rk-url-map=...keymap...To.run.th
2200 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 79 6f 75 20 63 61 6e 20 70 72 65 73 73 20 3d e.default.action.you.can.press.=
2220 52 45 54 3d 20 61 66 74 65 72 20 72 75 6e 6e 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 2e RET=.after.running.=embark-act=.
2240 0a 4e 6f 74 65 20 74 68 61 74 20 69 66 20 74 68 65 72 65 20 61 72 65 20 73 65 76 65 72 61 6c 20 .Note.that.if.there.are.several.
2260 64 69 66 66 65 72 65 6e 74 20 74 61 72 67 65 74 73 20 61 74 20 61 20 67 69 76 65 6e 20 6c 6f 63 different.targets.at.a.given.loc
2280 61 74 69 6f 6e 2c 0a 65 61 63 68 20 68 61 73 20 69 74 73 20 6f 77 6e 20 64 65 66 61 75 6c 74 20 ation,.each.has.its.own.default.
22a0 61 63 74 69 6f 6e 2c 20 73 6f 20 66 69 72 73 74 20 63 79 63 6c 65 20 74 6f 20 74 68 65 20 74 61 action,.so.first.cycle.to.the.ta
22c0 72 67 65 74 20 79 6f 75 20 77 61 6e 74 0a 61 6e 64 20 74 68 65 6e 20 70 72 65 73 73 20 3d 52 45 rget.you.want.and.then.press.=RE
22e0 54 3d 20 74 6f 20 72 75 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 64 65 66 61 T=.to.run.the.corresponding.defa
2300 75 6c 74 20 61 63 74 69 6f 6e 2e 0a 0a 54 68 65 72 65 20 69 73 20 61 6c 73 6f 20 3d 65 6d 62 61 ult.action...There.is.also.=emba
2320 72 6b 2d 64 77 69 6d 3d 20 77 68 69 63 68 20 72 75 6e 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 rk-dwim=.which.runs.the.default.
2340 61 63 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 66 69 72 73 74 0a 74 61 72 67 65 74 20 66 6f 75 6e action.for.the.first.target.foun
2360 64 2e 20 49 74 27 73 20 70 72 65 74 74 79 20 68 61 6e 64 79 20 69 6e 20 6e 6f 6e 2d 6d 69 6e 69 d..It's.pretty.handy.in.non-mini
2380 62 75 66 66 65 72 20 62 75 66 66 65 72 73 3a 20 77 69 74 68 0a 45 6d 62 61 72 6b 27 73 20 64 65 buffer.buffers:.with.Embark's.de
23a0 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 74 20 77 69 6c 6c 3a 0a 0a 2d 20 fault.configuration.it.will:..-.
23c0 4f 70 65 6e 20 74 68 65 20 66 69 6c 65 20 61 74 20 70 6f 69 6e 74 2e 0a 2d 20 4f 70 65 6e 20 74 Open.the.file.at.point..-.Open.t
23e0 68 65 20 55 52 4c 20 61 74 20 70 6f 69 6e 74 20 69 6e 20 61 20 77 65 62 20 62 72 6f 77 73 65 72 he.URL.at.point.in.a.web.browser
2400 20 28 75 73 69 6e 67 20 74 68 65 20 3d 62 72 6f 77 73 65 2d 75 72 6c 3d 0a 20 20 63 6f 6d 6d 61 .(using.the.=browse-url=...comma
2420 6e 64 29 2e 0a 2d 20 43 6f 6d 70 6f 73 65 20 61 20 6e 65 77 20 65 6d 61 69 6c 20 74 6f 20 74 68 nd)..-.Compose.a.new.email.to.th
2440 65 20 65 6d 61 69 6c 20 61 64 64 72 65 73 73 20 61 74 20 70 6f 69 6e 74 2e 0a 2d 20 49 6e 20 61 e.email.address.at.point..-.In.a
2460 6e 20 45 6d 61 63 73 20 4c 69 73 70 20 62 75 66 66 65 72 2c 20 69 66 20 70 6f 69 6e 74 20 69 73 n.Emacs.Lisp.buffer,.if.point.is
2480 20 6f 6e 20 61 6e 20 6f 70 65 6e 69 6e 67 20 70 61 72 65 6e 74 68 65 73 69 73 20 6f 72 0a 20 20 .on.an.opening.parenthesis.or...
24a0 72 69 67 68 74 20 61 66 74 65 72 20 61 20 63 6c 6f 73 69 6e 67 20 6f 6e 65 2c 20 69 74 20 77 69 right.after.a.closing.one,.it.wi
24c0 6c 6c 20 65 76 61 6c 75 61 74 65 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 20 20 ll.evaluate.the.corresponding...
24e0 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2d 20 47 6f 20 74 6f 20 74 68 65 20 64 65 66 69 6e 69 74 69 expression..-.Go.to.the.definiti
2500 6f 6e 20 6f 66 20 61 6e 20 45 6d 61 63 73 20 4c 69 73 70 20 66 75 6e 63 74 69 6f 6e 2c 20 76 61 on.of.an.Emacs.Lisp.function,.va
2520 72 69 61 62 6c 65 20 6f 72 20 6d 61 63 72 6f 20 61 74 0a 20 20 70 6f 69 6e 74 2e 0a 2d 20 46 69 riable.or.macro.at...point..-.Fi
2540 6e 64 20 74 68 65 20 66 69 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 6e 20 nd.the.file.corresponding.to.an.
2560 45 6d 61 63 73 20 4c 69 73 70 20 6c 69 62 72 61 72 79 20 61 74 20 70 6f 69 6e 74 2e 0a 0a 2a 2a Emacs.Lisp.library.at.point...**
2580 20 57 6f 72 6b 69 6e 67 20 77 69 74 68 20 73 65 74 73 20 6f 66 20 70 6f 73 73 69 62 6c 65 20 74 .Working.with.sets.of.possible.t
25a0 61 72 67 65 74 73 0a 0a 42 65 73 69 64 65 73 20 61 63 74 69 6e 67 20 69 6e 64 69 76 69 64 75 61 argets..Besides.acting.individua
25c0 6c 6c 79 20 6f 6e 20 74 61 72 67 65 74 73 2c 20 45 6d 62 61 72 6b 20 6c 65 74 73 20 79 6f 75 20 lly.on.targets,.Embark.lets.you.
25e0 77 6f 72 6b 0a 63 6f 6c 6c 65 63 74 69 76 65 6c 79 20 6f 6e 20 61 20 73 65 74 20 6f 66 20 74 61 work.collectively.on.a.set.of.ta
2600 72 67 65 74 20 2f 63 61 6e 64 69 64 61 74 65 73 2f 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 rget./candidates/..For.example,.
2620 77 68 69 6c 65 20 79 6f 75 20 61 72 65 0a 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 while.you.are.in.the.minibuffer.
2640 74 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 61 72 65 20 73 69 6d 70 6c 79 20 74 68 65 20 70 6f the.candidates.are.simply.the.po
2660 73 73 69 62 6c 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 0a 6f 66 20 79 6f 75 72 20 69 6e 70 75 74 ssible.completions.of.your.input
2680 2e 20 45 6d 62 61 72 6b 20 70 72 6f 76 69 64 65 73 20 74 68 72 65 65 20 6d 61 69 6e 20 63 6f 6d ..Embark.provides.three.main.com
26a0 6d 61 6e 64 73 20 74 6f 20 77 6f 72 6b 20 6f 6e 20 63 61 6e 64 69 64 61 74 65 0a 73 65 74 73 3a mands.to.work.on.candidate.sets:
26c0 0a 0a 2d 20 54 68 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 63 6f 6d 6d 61 6e 64 ..-.The.=embark-act-all=.command
26e0 20 72 75 6e 73 20 74 68 65 20 73 61 6d 65 20 61 63 74 69 6f 6e 20 6f 6e 20 65 61 63 68 20 6f 66 .runs.the.same.action.on.each.of
2700 20 74 68 65 0a 20 20 63 75 72 72 65 6e 74 20 63 61 6e 64 69 64 61 74 65 73 2e 20 49 74 20 69 73 .the...current.candidates..It.is
2720 20 6a 75 73 74 20 6c 69 6b 65 20 75 73 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 6f 6e .just.like.using.=embark-act=.on
2740 20 65 61 63 68 0a 20 20 63 61 6e 64 69 64 61 74 65 20 69 6e 20 74 75 72 6e 2e 20 28 42 65 63 61 .each...candidate.in.turn..(Beca
2760 75 73 65 20 79 6f 75 20 63 61 6e 20 65 61 73 69 6c 79 20 61 63 74 20 6f 6e 20 6d 61 6e 79 20 6d use.you.can.easily.act.on.many.m
2780 6f 72 65 0a 20 20 63 61 6e 64 69 64 61 74 65 73 20 74 68 61 6e 20 79 6f 75 20 6d 65 61 6e 74 20 ore...candidates.than.you.meant.
27a0 74 6f 2c 20 62 79 20 64 65 66 61 75 6c 74 20 45 6d 62 61 72 6b 20 61 73 6b 73 20 79 6f 75 20 74 to,.by.default.Embark.asks.you.t
27c0 6f 20 63 6f 6e 66 69 72 6d 0a 20 20 75 73 65 73 20 6f 66 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d o.confirm...uses.of.=embark-act-
27e0 61 6c 6c 3d 3b 20 79 6f 75 20 63 61 6e 20 74 75 72 6e 20 74 68 69 73 20 6f 66 66 20 62 79 20 73 all=;.you.can.turn.this.off.by.s
2800 65 74 74 69 6e 67 20 74 68 65 20 75 73 65 72 0a 20 20 6f 70 74 69 6f 6e 20 3d 65 6d 62 61 72 6b etting.the.user...option.=embark
2820 2d 63 6f 6e 66 69 72 6d 2d 61 63 74 2d 61 6c 6c 3d 20 74 6f 20 3d 6e 69 6c 3d 2e 29 0a 0a 2d 20 -confirm-act-all=.to.=nil=.)..-.
2840 54 68 65 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 20 63 6f 6d 6d 61 6e 64 20 70 72 6f The.=embark-collect=.command.pro
2860 64 75 63 65 73 20 61 20 62 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 61 6c 6c 20 74 68 65 20 63 duces.a.buffer.listing.all.the.c
2880 75 72 72 65 6e 74 0a 20 20 63 61 6e 64 69 64 61 74 65 73 2c 20 66 6f 72 20 79 6f 75 20 74 6f 20 urrent...candidates,.for.you.to.
28a0 70 65 72 75 73 65 20 61 6e 64 20 72 75 6e 20 61 63 74 69 6f 6e 73 20 6f 6e 20 61 74 20 79 6f 75 peruse.and.run.actions.on.at.you
28c0 72 20 6c 65 69 73 75 72 65 2e 0a 20 20 54 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 61 72 65 20 r.leisure....The.candidates.are.
28e0 64 69 73 70 6c 61 79 65 64 20 61 73 20 61 20 6c 69 73 74 20 73 68 6f 77 69 6e 67 20 61 64 64 69 displayed.as.a.list.showing.addi
2900 74 69 6f 6e 61 6c 0a 20 20 61 6e 6e 6f 74 61 74 69 6f 6e 73 2e 20 49 66 20 61 6e 79 20 6f 66 20 tional...annotations..If.any.of.
2920 74 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 63 6f 6e 74 61 69 6e 20 6e 65 77 6c 69 6e 65 73 2c the.candidates.contain.newlines,
2940 20 74 68 65 6e 0a 20 20 68 6f 72 69 7a 6f 6e 74 61 6c 20 6c 69 6e 65 73 20 61 72 65 20 75 73 65 .then...horizontal.lines.are.use
2960 64 20 74 6f 20 73 65 70 61 72 61 74 65 20 63 61 6e 64 69 64 61 74 65 73 2e 0a 0a 20 20 54 68 65 d.to.separate.candidates.....The
2980 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 69 73 20 73 6f 6d 65 77 68 .Embark.Collect.buffer.is.somewh
29a0 61 74 20 22 64 69 72 65 64 2d 6c 69 6b 65 22 3a 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 0a at."dired-like":.you.can.select.
29c0 20 20 61 6e 64 20 64 65 73 65 6c 65 63 74 20 63 61 6e 64 69 64 61 74 65 73 20 74 68 72 6f 75 67 ..and.deselect.candidates.throug
29e0 68 20 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 20 28 61 76 61 69 6c 61 62 6c 65 20 61 73 20 h.=embark-select=.(available.as.
2a00 61 6e 0a 20 20 61 63 74 69 6f 6e 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 2c 20 62 6f 75 an...action.in.=embark-act=,.bou
2a20 6e 64 20 74 6f 20 3d 53 50 43 3d 3b 20 62 75 74 20 79 6f 75 20 63 6f 75 6c 64 20 61 6c 73 6f 20 nd.to.=SPC=;.but.you.could.also.
2a40 67 69 76 65 20 69 74 20 61 0a 20 20 67 6c 6f 62 61 6c 20 6b 65 79 20 62 69 6e 64 69 6e 67 29 2e give.it.a...global.key.binding).
2a60 20 49 6e 20 61 6e 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 3d 65 6d .In.an.Embark.Collect.buffer.=em
2a80 62 61 72 6b 2d 61 63 74 3d 20 69 73 20 62 6f 75 6e 64 0a 20 20 74 6f 20 3d 61 3d 20 61 6e 64 20 bark-act=.is.bound...to.=a=.and.
2aa0 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 3d 41 3d =embark-act-all=.is.bound.to.=A=
2ac0 3b 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 77 69 6c 6c 20 61 63 74 20 6f 6e 0a 20 ;.=embark-act-all=.will.act.on..
2ae0 20 61 6c 6c 20 63 75 72 72 65 6e 74 6c 79 20 6d 61 72 6b 65 64 20 63 61 6e 64 69 64 61 74 65 73 .all.currently.marked.candidates
2b00 20 69 66 20 74 68 65 72 65 20 61 6e 79 2c 20 61 6e 64 20 77 69 6c 6c 20 61 63 74 20 6f 6e 20 61 .if.there.any,.and.will.act.on.a
2b20 6c 6c 0a 20 20 63 61 6e 64 69 64 61 74 65 73 20 69 66 20 6e 6f 6e 65 20 61 72 65 20 6d 61 72 6b ll...candidates.if.none.are.mark
2b40 65 64 2e 20 49 6e 20 70 61 72 74 69 63 75 6c 61 72 2c 20 74 68 69 73 20 6d 65 61 6e 73 20 74 68 ed..In.particular,.this.means.th
2b60 61 74 20 3d 61 20 53 50 43 3d 0a 20 20 77 69 6c 6c 20 74 6f 67 67 6c 65 20 77 68 65 74 68 65 72 at.=a.SPC=...will.toggle.whether
2b80 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 20 61 74 20 70 6f 69 6e 74 20 69 73 20 73 65 6c 65 63 .the.candidate.at.point.is.selec
2ba0 74 65 64 2c 20 61 6e 64 20 3d 41 20 53 50 43 3d 0a 20 20 77 69 6c 6c 20 73 65 6c 65 63 74 20 61 ted,.and.=A.SPC=...will.select.a
2bc0 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 20 69 66 20 6e 6f 6e 65 20 61 72 65 20 73 65 6c 65 63 74 ll.candidates.if.none.are.select
2be0 65 64 2c 20 6f 72 20 64 65 73 65 6c 65 63 74 20 61 6c 6c 0a 20 20 73 65 6c 65 63 74 65 64 20 63 ed,.or.deselect.all...selected.c
2c00 61 6e 64 69 64 61 74 65 73 20 69 66 20 74 68 65 72 65 20 61 72 65 20 73 6f 6d 65 2e 0a 0a 2d 20 andidates.if.there.are.some...-.
2c20 54 68 65 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 63 6f 6d 6d 61 6e 64 20 74 72 69 65 The.=embark-export=.command.trie
2c40 73 20 74 6f 20 6f 70 65 6e 20 61 20 62 75 66 66 65 72 20 69 6e 20 61 6e 20 61 70 70 72 6f 70 72 s.to.open.a.buffer.in.an.appropr
2c60 69 61 74 65 0a 20 20 6d 61 6a 6f 72 20 6d 6f 64 65 20 66 6f 72 20 74 68 65 20 73 65 74 20 6f 66 iate...major.mode.for.the.set.of
2c80 20 63 61 6e 64 69 64 61 74 65 73 2e 20 49 66 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 61 .candidates..If.the.candidates.a
2ca0 72 65 20 66 69 6c 65 73 0a 20 20 65 78 70 6f 72 74 20 70 72 6f 64 75 63 65 73 20 61 20 44 69 72 re.files...export.produces.a.Dir
2cc0 65 64 20 62 75 66 66 65 72 3b 20 69 66 20 74 68 65 79 20 61 72 65 20 62 75 66 66 65 72 73 2c 20 ed.buffer;.if.they.are.buffers,.
2ce0 79 6f 75 20 67 65 74 20 61 6e 0a 20 20 49 62 75 66 66 65 72 20 62 75 66 66 65 72 3b 20 61 6e 64 you.get.an...Ibuffer.buffer;.and
2d00 20 69 66 20 74 68 65 79 20 61 72 65 20 70 61 63 6b 61 67 65 73 20 79 6f 75 20 67 65 74 20 61 20 .if.they.are.packages.you.get.a.
2d20 62 75 66 66 65 72 20 69 6e 0a 20 20 70 61 63 6b 61 67 65 20 6d 65 6e 75 20 6d 6f 64 65 2e 0a 0a buffer.in...package.menu.mode...
2d40 20 20 49 66 20 79 6f 75 20 75 73 65 20 74 68 65 20 67 72 65 70 70 69 6e 67 20 63 6f 6d 6d 61 6e ..If.you.use.the.grepping.comman
2d60 64 73 20 66 72 6f 6d 20 74 68 65 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d ds.from.the.[[https://github.com
2d80 2f 6d 69 6e 61 64 2f 63 6f 6e 73 75 6c 74 2f 5d 5b 43 6f 6e 73 75 6c 74 5d 5d 20 70 61 63 6b 61 /minad/consult/][Consult]].packa
2da0 67 65 2c 0a 20 20 3d 63 6f 6e 73 75 6c 74 2d 67 72 65 70 3d 2c 20 3d 63 6f 6e 73 75 6c 74 2d 67 ge,...=consult-grep=,.=consult-g
2dc0 69 74 2d 67 72 65 70 3d 20 6f 72 20 3d 63 6f 6e 73 75 6c 74 2d 72 69 70 67 72 65 70 3d 2c 20 74 it-grep=.or.=consult-ripgrep=,.t
2de0 68 65 6e 20 79 6f 75 20 73 68 6f 75 6c 64 0a 20 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 3d 65 6d hen.you.should...install.the.=em
2e00 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 2c 20 77 68 69 63 68 20 61 64 64 bark-consult=.package,.which.add
2e20 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 65 78 70 6f 72 74 69 6e 67 20 61 0a 20 20 6c 69 73 74 s.support.for.exporting.a...list
2e40 20 6f 66 20 67 72 65 70 20 72 65 73 75 6c 74 73 20 74 6f 20 61 6e 20 68 6f 6e 65 73 74 20 67 72 .of.grep.results.to.an.honest.gr
2e60 65 70 2d 6d 6f 64 65 20 62 75 66 66 65 72 2c 20 6f 6e 20 77 68 69 63 68 20 79 6f 75 20 63 61 6e ep-mode.buffer,.on.which.you.can
2e80 0a 20 20 65 76 65 6e 20 75 73 65 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d ...even.use.[[https://github.com
2ea0 2f 6d 68 61 79 61 73 68 69 31 31 32 30 2f 45 6d 61 63 73 2d 77 67 72 65 70 5d 5b 77 67 72 65 70 /mhayashi1120/Emacs-wgrep][wgrep
2ec0 5d 5d 20 69 66 20 79 6f 75 20 77 69 73 68 2e 0a 0a 57 68 65 6e 20 69 6e 20 64 6f 75 62 74 20 63 ]].if.you.wish...When.in.doubt.c
2ee0 68 6f 6f 73 69 6e 67 20 62 65 74 77 65 65 6e 20 65 78 70 6f 72 74 69 6e 67 20 61 6e 64 20 63 6f hoosing.between.exporting.and.co
2f00 6c 6c 65 63 74 69 6e 67 2c 20 61 20 67 6f 6f 64 20 72 75 6c 65 0a 6f 66 20 74 68 75 6d 62 20 69 llecting,.a.good.rule.of.thumb.i
2f20 73 20 74 6f 20 61 6c 77 61 79 73 20 70 72 65 66 65 72 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 s.to.always.prefer.=embark-expor
2f40 74 3d 20 73 69 6e 63 65 20 77 68 65 6e 20 61 6e 20 65 78 70 6f 72 74 65 72 20 74 6f 20 61 0a 73 t=.since.when.an.exporter.to.a.s
2f60 70 65 63 69 61 6c 20 6d 61 6a 6f 72 20 6d 6f 64 65 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 66 pecial.major.mode.is.available.f
2f80 6f 72 20 61 20 67 69 76 65 6e 20 74 79 70 65 20 6f 66 20 74 61 72 67 65 74 2c 20 69 74 20 77 69 or.a.given.type.of.target,.it.wi
2fa0 6c 6c 20 62 65 0a 6d 6f 72 65 20 66 65 61 74 75 72 65 66 75 6c 20 74 68 61 6e 20 61 6e 20 45 6d ll.be.more.featureful.than.an.Em
2fc0 62 61 72 6b 20 63 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 2c 20 61 6e 64 20 69 66 20 6e 6f 20 73 bark.collect.buffer,.and.if.no.s
2fe0 75 63 68 20 65 78 70 6f 72 74 65 72 0a 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74 68 65 20 3d uch.exporter.is.configured.the.=
3000 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 63 6f 6d 6d 61 6e 64 20 66 61 6c 6c 73 20 62 61 63 embark-export=.command.falls.bac
3020 6b 20 74 6f 20 74 68 65 20 67 65 6e 65 72 69 63 0a 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 k.to.the.generic.=embark-collect
3040 3d 2e 0a 0a 54 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 6c 77 61 79 73 20 61 76 =...These.commands.are.always.av
3060 61 69 6c 61 62 6c 65 20 61 73 20 22 61 63 74 69 6f 6e 73 22 20 28 61 6c 74 68 6f 75 67 68 20 74 ailable.as."actions".(although.t
3080 68 65 79 20 64 6f 20 6e 6f 74 0a 61 63 74 20 6f 6e 20 6a 75 73 74 20 74 68 65 20 63 75 72 72 65 hey.do.not.act.on.just.the.curre
30a0 6e 74 20 74 61 72 67 65 74 20 62 75 74 20 6f 6e 20 61 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 29 nt.target.but.on.all.candidates)
30c0 20 66 6f 72 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 0a 61 6e 64 20 61 72 65 20 62 6f 75 6e 64 20 .for.=embark-act=.and.are.bound.
30e0 74 6f 20 3d 41 3d 2c 20 3d 53 3d 20 28 66 6f 72 20 22 73 6e 61 70 73 68 6f 74 22 29 2c 20 61 6e to.=A=,.=S=.(for."snapshot"),.an
3100 64 20 3d 45 3d 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2c 20 69 6e 0a 3d 65 6d 62 61 72 6b 2d d.=E=,.respectively,.in.=embark-
3120 67 65 6e 65 72 61 6c 2d 6d 61 70 3d 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 79 6f general-map=..This.means.that.yo
3140 75 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 62 69 6e 64 20 79 6f 75 72 20 6f 77 6e 0a 6b u.do.not.have.to.bind.your.own.k
3160 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 73 65 20 28 61 6c 74 68 6f 75 67 68 20 ey.bindings.for.these.(although.
3180 79 6f 75 20 63 61 6e 2c 20 6f 66 20 63 6f 75 72 73 65 21 29 2c 20 6a 75 73 74 20 61 20 6b 65 79 you.can,.of.course!),.just.a.key
31a0 0a 62 69 6e 64 69 6e 67 20 66 6f 72 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 2e 0a 0a 49 6e 20 45 .binding.for.=embark-act=...In.E
31c0 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 6f 72 20 45 6d 62 61 72 6b 20 45 78 70 6f 72 74 20 62 mbark.Collect.or.Embark.Export.b
31e0 75 66 66 65 72 73 20 74 68 61 74 20 77 65 72 65 20 6f 62 74 61 69 6e 65 64 20 62 79 0a 72 75 6e uffers.that.were.obtained.by.run
3200 6e 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 20 6f 72 20 3d 65 6d 62 61 72 6b ning.=embark-collect=.or.=embark
3220 2d 65 78 70 6f 72 74 3d 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 -export=.from.within.a.minibuffe
3240 72 0a 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 3d 67 3d 20 69 73 20 62 6f 75 r.completion.session,.=g=.is.bou
3260 6e 64 20 74 6f 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 72 65 73 74 61 72 74 73 20 74 68 nd.to.a.command.that.restarts.th
3280 65 0a 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 74 68 61 74 20 69 73 2c 20 74 e.completion.session,.that.is,.t
32a0 68 65 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 6f 70 65 6e 65 64 20 74 68 65 20 6d 69 6e 69 62 he.command.that.opened.the.minib
32c0 75 66 66 65 72 20 69 73 0a 72 75 6e 20 61 67 61 69 6e 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 62 uffer.is.run.again.and.the.minib
32e0 75 66 66 65 72 20 63 6f 6e 74 65 6e 74 73 20 72 65 73 74 6f 72 65 64 2e 20 59 6f 75 20 63 61 6e uffer.contents.restored..You.can
3300 20 74 68 65 6e 20 69 6e 74 65 72 61 63 74 0a 6e 6f 72 6d 61 6c 6c 79 20 77 69 74 68 20 74 68 65 .then.interact.normally.with.the
3320 20 63 6f 6d 6d 61 6e 64 2c 20 70 65 72 68 61 70 73 20 65 64 69 74 69 6e 67 20 74 68 65 20 6d 69 .command,.perhaps.editing.the.mi
3340 6e 69 62 75 66 66 65 72 20 63 6f 6e 74 65 6e 74 73 2c 0a 61 6e 64 2c 20 69 66 20 79 6f 75 20 77 nibuffer.contents,.and,.if.you.w
3360 69 73 68 2c 20 79 6f 75 20 63 61 6e 20 72 65 72 75 6e 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 ish,.you.can.rerun.=embark-colle
3380 63 74 3d 20 6f 72 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 74 6f 20 67 65 74 0a 61 6e ct=.or.=embark-export=.to.get.an
33a0 20 75 70 64 61 74 65 64 20 62 75 66 66 65 72 2e 0a 0a 2a 2a 2a 20 53 65 6c 65 63 74 69 6e 67 20 .updated.buffer...***.Selecting.
33c0 73 6f 6d 65 20 74 61 72 67 65 74 73 20 74 6f 20 6d 61 6b 65 20 61 6e 20 61 64 20 68 6f 63 20 63 some.targets.to.make.an.ad.hoc.c
33e0 61 6e 64 69 64 61 74 65 20 73 65 74 0a 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 77 andidate.set..The.commands.for.w
3400 6f 72 6b 69 6e 67 20 77 69 74 68 20 73 65 74 73 20 6f 66 20 63 61 6e 64 69 64 61 74 65 73 20 6a orking.with.sets.of.candidates.j
3420 75 73 74 20 64 65 73 63 72 69 62 65 64 2c 0a 6e 61 6d 65 6c 79 20 3d 65 6d 62 61 72 6b 2d 61 63 ust.described,.namely.=embark-ac
3440 74 2d 61 6c 6c 3d 2c 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 61 6e 64 20 3d 65 6d 62 t-all=,.=embark-export=.and.=emb
3460 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 20 62 79 20 64 65 66 61 75 6c 74 0a 77 6f 72 6b 20 77 69 74 ark-collect=.by.default.work.wit
3480 68 20 61 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 h.all.candidates.defined.in.the.
34a0 63 75 72 72 65 6e 74 20 63 6f 6e 74 65 78 74 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 69 6e current.context..For.example,.in
34c0 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 74 68 65 79 20 6f 70 65 72 61 74 65 20 6f 6e 20 .the.minibuffer.they.operate.on.
34e0 61 6c 6c 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 all.currently.completion.candida
3500 74 65 73 2c 0a 6f 72 20 69 6e 20 61 20 64 69 72 65 64 20 62 75 66 66 65 72 20 74 68 65 79 20 77 tes,.or.in.a.dired.buffer.they.w
3520 6f 72 6b 20 6f 6e 20 61 6c 6c 20 6d 61 72 6b 65 64 20 66 69 6c 65 73 20 28 6f 72 20 61 6c 6c 20 ork.on.all.marked.files.(or.all.
3540 66 69 6c 65 73 20 69 66 0a 6e 6f 6e 65 20 61 72 65 20 6d 61 72 6b 65 64 29 2e 20 45 6d 62 61 72 files.if.none.are.marked)..Embar
3560 6b 20 61 6c 73 6f 20 68 61 73 20 61 20 6e 6f 74 69 6f 6e 20 6f 66 20 2f 73 65 6c 65 63 74 69 6f k.also.has.a.notion.of./selectio
3580 6e 2f 2c 20 77 68 65 72 65 20 79 6f 75 20 63 61 6e 0a 61 63 63 75 6d 75 6c 61 74 65 20 61 6e 20 n/,.where.you.can.accumulate.an.
35a0 61 64 20 68 6f 63 20 6c 69 73 74 20 6f 66 20 74 61 72 67 65 74 73 20 66 6f 72 20 74 68 65 73 65 ad.hoc.list.of.targets.for.these
35c0 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 77 6f 72 6b 20 6f 6e 2e 0a 0a 54 68 65 20 73 65 6c 65 63 .commands.to.work.on...The.selec
35e0 74 69 6f 6e 20 69 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 20 75 73 69 6e 67 20 74 68 65 20 tion.is.controlled.by.using.the.
3600 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 20 61 63 74 69 6f 6e 2c 20 62 6f 75 6e 64 0a 74 6f =embark-select=.action,.bound.to
3620 20 3d 53 50 43 3d 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 3d 20 73 .=SPC=.in.=embark-general-map=.s
3640 6f 20 74 68 61 74 20 69 74 20 69 73 20 61 6c 77 61 79 73 20 61 76 61 69 6c 61 62 6c 65 20 28 79 o.that.it.is.always.available.(y
3660 6f 75 20 63 61 6e 0a 61 6c 73 6f 20 67 69 76 65 20 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d ou.can.also.give.=embark-select=
3680 20 61 20 67 6c 6f 62 61 6c 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 69 66 20 79 6f 75 20 77 69 73 .a.global.key.binding.if.you.wis
36a0 68 3b 20 77 68 65 6e 20 63 61 6c 6c 65 64 0a 64 69 72 65 63 74 6c 79 2c 20 6e 6f 74 20 61 73 20 h;.when.called.directly,.not.as.
36c0 61 6e 20 61 63 74 69 6f 6e 20 66 6f 72 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 2c 20 69 74 20 77 an.action.for.=embark-act=,.it.w
36e0 69 6c 6c 20 73 65 6c 65 63 74 20 74 68 65 20 66 69 72 73 74 0a 74 61 72 67 65 74 20 61 74 20 70 ill.select.the.first.target.at.p
3700 6f 69 6e 74 29 2e 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 20 61 63 74 69 6f 6e 20 6f 6e 20 61 20 oint)..Calling.this.action.on.a.
3720 74 61 72 67 65 74 20 74 6f 67 67 6c 65 73 20 69 74 73 0a 6d 65 6d 62 65 72 73 68 69 70 20 69 6e target.toggles.its.membership.in
3740 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 27 73 20 45 6d 62 61 72 6b 20 73 65 6c .the.current.buffer's.Embark.sel
3760 65 63 74 69 6f 6e 3b 20 74 68 61 74 20 69 73 2c 20 69 74 20 61 64 64 73 0a 69 74 20 74 6f 20 73 ection;.that.is,.it.adds.it.to.s
3780 65 6c 65 63 74 69 6f 6e 20 69 66 20 6e 6f 74 20 73 65 6c 65 63 74 65 64 20 61 6e 64 20 72 65 6d election.if.not.selected.and.rem
37a0 6f 76 65 73 20 69 74 20 66 72 6f 6d 20 74 68 65 20 73 65 6c 65 63 74 69 6f 6e 20 69 66 0a 69 74 oves.it.from.the.selection.if.it
37c0 20 77 61 73 20 73 65 6c 65 63 74 65 64 2e 20 57 68 65 6e 65 76 65 72 20 74 68 65 20 73 65 6c 65 .was.selected..Whenever.the.sele
37e0 63 74 69 6f 6e 20 66 6f 72 20 61 20 62 75 66 66 65 72 20 69 73 20 6e 6f 6e 2d 65 6d 70 74 79 2c ction.for.a.buffer.is.non-empty,
3800 20 74 68 65 0a 63 6f 6d 6d 61 6e 64 73 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 2c 20 .the.commands.=embark-act-all=,.
3820 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c =embark-export=.and.=embark-coll
3840 65 63 74 3d 20 77 69 6c 6c 20 61 63 74 20 6f 6e 0a 74 68 65 20 73 65 6c 65 63 74 69 6f 6e 2e 0a ect=.will.act.on.the.selection..
3860 0a 54 6f 20 64 65 73 65 6c 65 63 74 20 61 6c 6c 20 73 65 6c 65 63 74 65 64 20 74 61 72 67 65 74 .To.deselect.all.selected.target
3880 73 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 s,.you.can.use.the.=embark-selec
38a0 74 3d 20 61 63 74 69 6f 6e 0a 74 68 72 6f 75 67 68 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c t=.action.through.=embark-act-al
38c0 6c 3d 2c 20 73 69 6e 63 65 20 74 68 69 73 20 77 69 6c 6c 20 72 75 6e 20 3d 65 6d 62 61 72 6b 2d l=,.since.this.will.run.=embark-
38e0 73 65 6c 65 63 74 3d 20 6f 6e 20 65 61 63 68 0a 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 63 75 select=.on.each.member.of.the.cu
3900 72 72 65 6e 74 20 73 65 6c 65 63 74 69 6f 6e 2e 20 53 69 6d 69 6c 61 72 6c 79 20 69 66 20 6e 6f rrent.selection..Similarly.if.no
3920 20 74 61 72 67 65 74 73 20 61 72 65 20 73 65 6c 65 63 74 65 64 0a 61 6e 64 20 79 6f 75 20 61 72 .targets.are.selected.and.you.ar
3940 65 20 69 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 65 73 e.in.a.minibuffer.completion.ses
3960 73 69 6f 6e 2c 20 72 75 6e 6e 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 0a 66 72 sion,.running.=embark-select=.fr
3980 6f 6d 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 77 69 6c 6c 20 73 65 6c 65 63 74 20 om.=embark-act-all=.will.select.
39a0 61 6c 6c 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 all.the.current.completion.candi
39c0 64 61 74 65 73 2e 0a 0a 42 79 20 64 65 66 61 75 6c 74 2c 20 77 68 65 6e 65 76 65 72 20 73 6f 6d dates...By.default,.whenever.som
39e0 65 20 74 61 72 67 65 74 73 20 61 72 65 20 73 65 6c 65 63 74 65 64 20 69 6e 20 74 68 65 20 63 75 e.targets.are.selected.in.the.cu
3a00 72 72 65 6e 74 20 62 75 66 66 65 72 2c 0a 61 20 63 6f 75 6e 74 20 6f 66 20 73 65 6c 65 63 74 65 rrent.buffer,.a.count.of.selecte
3a20 64 20 74 61 72 67 65 74 73 20 61 70 70 65 61 72 73 20 69 6e 20 74 68 65 20 6d 6f 64 65 20 6c 69 d.targets.appears.in.the.mode.li
3a40 6e 65 2e 20 54 68 69 73 20 63 61 6e 20 62 65 0a 74 75 72 6e 65 64 20 6f 66 66 20 6f 72 20 63 75 ne..This.can.be.turned.off.or.cu
3a60 73 74 6f 6d 69 7a 65 64 20 74 68 72 6f 75 67 68 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 73 65 6c stomized.through.the.=embark-sel
3a80 65 63 74 69 6f 6e 2d 69 6e 64 69 63 61 74 6f 72 3d 20 75 73 65 72 0a 6f 70 74 69 6f 6e 2e 0a 0a ection-indicator=.user.option...
3aa0 54 68 65 20 73 65 6c 65 63 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 20 73 The.selection.functionality.is.s
3ac0 75 70 70 6f 72 74 65 64 20 69 6e 20 65 76 65 72 79 20 62 75 66 66 65 72 3a 0a 0a 2d 20 49 6e 20 upported.in.every.buffer:..-.In.
3ae0 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 74 68 69 73 20 67 69 76 65 73 20 61 20 63 6f 6e 76 the.minibuffer.this.gives.a.conv
3b00 65 6e 69 65 6e 74 20 77 61 79 20 74 6f 20 61 63 74 20 6f 6e 20 73 65 76 65 72 61 6c 0a 20 20 63 enient.way.to.act.on.several...c
3b20 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 74 68 61 74 20 64 6f 6e 27 74 20 ompletion.candidates.that.don't.
3b40 66 6f 6c 6c 6f 77 20 61 6e 79 20 73 69 6d 70 6c 65 20 70 61 74 74 65 72 6e 3a 20 6a 75 73 74 20 follow.any.simple.pattern:.just.
3b60 67 6f 0a 20 20 74 68 72 6f 75 67 68 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 73 65 6c go...through.the.completions.sel
3b80 65 63 74 69 6e 67 20 74 68 65 20 6f 6e 65 73 20 79 6f 75 20 77 61 6e 74 2c 20 74 68 65 6e 20 75 ecting.the.ones.you.want,.then.u
3ba0 73 65 0a 20 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 2e 20 46 6f 72 20 65 78 61 6d 70 se...=embark-act-all=..For.examp
3bc0 6c 65 2c 20 79 6f 75 20 63 6f 75 6c 64 20 61 74 74 61 63 68 20 73 65 76 65 72 61 6c 20 66 69 6c le,.you.could.attach.several.fil
3be0 65 73 20 61 74 20 6f 6e 63 65 0a 20 20 74 6f 20 61 6e 20 65 6d 61 69 6c 2e 0a 2d 20 46 6f 72 20 es.at.once...to.an.email..-.For.
3c00 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 20 74 68 69 73 20 66 75 6e 63 Embark.Collect.buffers.this.func
3c20 74 69 6f 6e 61 6c 69 74 79 20 65 6e 61 62 6c 65 73 20 61 20 64 69 72 65 64 2d 6c 69 6b 65 0a 20 tionality.enables.a.dired-like..
3c40 20 77 6f 72 6b 66 6c 6f 77 2c 20 69 6e 20 77 68 69 63 68 20 79 6f 75 20 6d 61 72 6b 20 76 61 72 .workflow,.in.which.you.mark.var
3c60 69 6f 75 73 20 63 61 6e 64 69 64 61 74 65 73 20 61 6e 64 20 61 70 70 6c 79 20 61 6e 20 61 63 74 ious.candidates.and.apply.an.act
3c80 69 6f 6e 0a 20 20 74 6f 20 61 6c 6c 20 61 74 20 6f 6e 63 65 2e 20 28 49 74 20 73 75 70 65 72 73 ion...to.all.at.once..(It.supers
3ca0 65 64 65 73 20 61 20 70 72 65 76 69 6f 75 73 20 61 64 20 68 6f 63 20 64 69 72 65 64 2d 6c 69 6b edes.a.previous.ad.hoc.dired-lik
3cc0 65 0a 20 20 69 6e 74 65 72 66 61 63 65 20 74 68 61 74 20 77 61 73 20 69 6d 70 6c 65 6d 65 6e 74 e...interface.that.was.implement
3ce0 65 64 20 6f 6e 6c 79 20 69 6e 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 ed.only.in.Embark.Collect.buffer
3d00 73 2c 20 77 69 74 68 0a 20 20 61 20 73 6c 69 67 68 74 6c 79 20 64 69 66 66 65 72 65 6e 74 20 69 s,.with...a.slightly.different.i
3d20 6e 74 65 72 66 61 63 65 2e 29 0a 2d 20 49 6e 20 61 20 65 77 77 20 62 75 66 66 65 72 20 79 6f 75 nterface.).-.In.a.eww.buffer.you
3d40 20 63 6f 75 6c 64 20 75 73 65 20 74 68 69 73 20 74 6f 20 73 65 6c 65 63 74 20 76 61 72 69 6f 75 .could.use.this.to.select.variou
3d60 73 20 6c 69 6e 6b 73 20 79 6f 75 20 77 69 73 68 0a 20 20 74 6f 20 66 6f 6c 6c 6f 77 20 75 70 20 s.links.you.wish...to.follow.up.
3d80 6f 6e 2c 20 61 6e 64 20 74 68 65 6e 20 63 6f 6c 6c 65 63 74 20 74 68 65 6d 20 69 6e 74 6f 20 61 on,.and.then.collect.them.into.a
3da0 20 62 75 66 66 65 72 2e 20 53 69 6d 69 6c 61 72 6c 79 2c 0a 20 20 77 68 69 6c 65 20 72 65 61 64 .buffer..Similarly,...while.read
3dc0 69 6e 67 20 45 6d 61 63 73 27 73 20 69 6e 66 6f 20 6d 61 6e 75 61 6c 20 79 6f 75 20 63 6f 75 6c ing.Emacs's.info.manual.you.coul
3de0 64 20 73 65 6c 65 63 74 20 73 6f 6d 65 20 73 79 6d 62 6f 6c 73 20 79 6f 75 0a 20 20 77 61 6e 74 d.select.some.symbols.you...want
3e00 20 74 6f 20 72 65 61 64 20 6d 6f 72 65 20 61 62 6f 75 74 20 61 6e 64 20 65 78 70 6f 72 74 20 74 .to.read.more.about.and.export.t
3e20 68 65 6d 20 74 6f 20 61 6e 20 3d 61 70 72 6f 70 6f 73 2d 6d 6f 64 65 3d 20 62 75 66 66 65 72 2e hem.to.an.=apropos-mode=.buffer.
3e40 0a 2d 20 59 6f 75 20 63 61 6e 20 75 73 65 20 73 65 6c 65 63 74 69 6f 6e 73 20 69 6e 20 72 65 67 .-.You.can.use.selections.in.reg
3e60 75 6c 61 72 20 74 65 78 74 20 6f 72 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 62 75 66 66 65 72 73 ular.text.or.programming.buffers
3e80 20 74 6f 20 64 6f 0a 20 20 63 6f 6d 70 6c 65 78 20 65 64 69 74 69 6e 67 20 6f 70 65 72 61 74 69 .to.do...complex.editing.operati
3ea0 6f 6e 73 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20 68 61 76 65 20 74 68 ons..For.example,.if.you.have.th
3ec0 72 65 65 0a 20 20 70 61 72 61 67 72 61 70 68 73 20 73 63 61 74 74 65 72 65 64 20 6f 76 65 72 20 ree...paragraphs.scattered.over.
3ee0 61 20 66 69 6c 65 20 61 6e 64 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 72 69 6e 67 20 74 68 65 a.file.and.you.want.to.bring.the
3f00 6d 0a 20 20 74 6f 67 65 74 68 65 72 2c 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 65 61 63 m...together,.you.can.select.eac
3f20 68 20 6f 6e 65 2c 20 69 6e 73 65 72 74 20 74 68 65 6d 20 61 6c 6c 20 73 6f 6d 65 77 68 65 72 65 h.one,.insert.them.all.somewhere
3f40 20 61 6e 64 0a 20 20 66 69 6e 61 6c 6c 79 20 64 65 6c 65 74 65 20 61 6c 6c 20 6f 66 20 74 68 65 .and...finally.delete.all.of.the
3f60 6d 20 28 66 72 6f 6d 20 74 68 65 69 72 20 6f 72 69 67 69 6e 61 6c 20 6c 6f 63 61 74 69 6f 6e 73 m.(from.their.original.locations
3f80 29 2e 0a 20 20 0a 2a 2a 2a 20 3d 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 61 20 6c 69 76 65 2d 75 ).....***.=embark-live=.a.live-u
3fa0 70 64 61 74 69 6e 67 20 76 61 72 69 61 6e 74 20 6f 66 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 pdating.variant.of.=embark-colle
3fc0 63 74 3d 0a 0a 46 69 6e 61 6c 6c 79 2c 20 74 68 65 72 65 20 69 73 20 61 6c 73 6f 20 61 6e 20 3d ct=..Finally,.there.is.also.an.=
3fe0 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 76 61 72 69 61 6e 74 20 6f 66 20 74 68 65 20 3d 65 6d 62 embark-live=.variant.of.the.=emb
4000 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 0a 63 6f 6d 6d 61 6e 64 20 77 68 69 63 68 20 61 75 74 6f 6d ark-collect=.command.which.autom
4020 61 74 69 63 61 6c 6c 79 20 75 70 64 61 74 65 73 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 atically.updates.the.collection.
4040 61 66 74 65 72 20 65 61 63 68 20 63 68 61 6e 67 65 0a 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 after.each.change.in.the.source.
4060 62 75 66 66 65 72 2e 20 55 73 65 72 73 20 6f 66 20 61 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 55 49 buffer..Users.of.a.completion.UI
4080 20 74 68 61 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 75 70 64 61 74 65 73 20 61 6e 64 20 .that.automatically.updates.and.
40a0 64 69 73 70 6c 61 79 73 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 20 6c 69 73 74 20 28 73 75 63 displays.the.candidate.list.(suc
40c0 68 20 61 73 20 56 65 72 74 69 63 6f 2c 20 49 63 6f 6d 70 6c 65 74 65 2c 0a 46 69 64 6f 2d 6d 6f h.as.Vertico,.Icomplete,.Fido-mo
40e0 64 65 2c 20 6f 72 20 4d 43 54 29 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 6e 6f 74 20 77 61 de,.or.MCT).will.probably.not.wa
4100 6e 74 20 74 6f 20 75 73 65 0a 3d 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 66 72 6f 6d 20 74 68 65 nt.to.use.=embark-live=.from.the
4120 20 6d 69 6e 69 62 75 66 66 65 72 20 61 73 20 74 68 65 79 20 77 69 6c 6c 20 74 68 65 6e 20 68 61 .minibuffer.as.they.will.then.ha
4140 76 65 20 74 77 6f 20 6c 69 76 65 0a 75 70 64 61 74 69 6e 67 20 64 69 73 70 6c 61 79 73 20 6f 66 ve.two.live.updating.displays.of
4160 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 21 0a 0a 41 20 6d .the.completion.candidates!..A.m
4180 6f 72 65 20 6c 69 6b 65 6c 79 20 75 73 65 20 6f 66 20 3d 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 ore.likely.use.of.=embark-live=.
41a0 69 73 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 61 20 72 65 67 75 6c 61 72 20 62 is.to.be.called.from.a.regular.b
41c0 75 66 66 65 72 0a 74 6f 20 64 69 73 70 6c 61 79 20 61 20 73 6f 72 74 20 6f 66 20 6c 69 76 65 20 uffer.to.display.a.sort.of.live.
41e0 75 70 64 61 74 69 6e 67 20 22 74 61 62 6c 65 20 6f 66 20 63 6f 6e 74 65 6e 74 73 22 20 66 6f 72 updating."table.of.contents".for
4200 20 74 68 65 20 62 75 66 66 65 72 2e 0a 54 68 69 73 20 64 65 70 65 6e 64 73 20 6f 6e 20 68 61 76 .the.buffer..This.depends.on.hav
4220 69 6e 67 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 61 6e 64 69 64 61 74 65 20 63 6f 6c 6c 65 63 ing.appropriate.candidate.collec
4240 74 6f 72 73 20 63 6f 6e 66 69 67 75 72 65 64 20 69 6e 0a 3d 65 6d 62 61 72 6b 2d 63 61 6e 64 69 tors.configured.in.=embark-candi
4260 64 61 74 65 2d 63 6f 6c 6c 65 63 74 6f 72 73 3d 2e 20 54 68 65 72 65 20 61 72 65 20 6e 6f 74 20 date-collectors=..There.are.not.
4280 6d 61 6e 79 20 69 6e 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 0a 63 6f 6e 66 69 67 75 many.in.Embark's.default.configu
42a0 72 61 74 69 6f 6e 2c 20 62 75 74 20 79 6f 75 20 63 61 6e 20 74 72 79 20 74 68 69 73 20 65 78 70 ration,.but.you.can.try.this.exp
42c0 65 72 69 6d 65 6e 74 3a 20 6f 70 65 6e 20 61 20 64 69 72 65 64 20 62 75 66 66 65 72 20 69 6e 0a eriment:.open.a.dired.buffer.in.
42e0 61 20 64 69 72 65 63 74 6f 72 79 20 74 68 61 74 20 68 61 73 20 76 65 72 79 20 6d 61 6e 79 20 66 a.directory.that.has.very.many.f
4300 69 6c 65 73 2c 20 6d 61 72 6b 20 61 20 66 65 77 2c 20 61 6e 64 20 72 75 6e 20 3d 65 6d 62 61 72 iles,.mark.a.few,.and.run.=embar
4320 6b 2d 6c 69 76 65 3d 2e 0a 59 6f 75 27 6c 6c 20 67 65 74 20 61 6e 20 45 6d 62 61 72 6b 20 43 6f k-live=..You'll.get.an.Embark.Co
4340 6c 6c 65 63 74 20 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6f 6e 6c 79 20 74 68 65 llect.buffer.containing.only.the
4360 20 6d 61 72 6b 65 64 20 66 69 6c 65 73 2c 0a 77 68 69 63 68 20 75 70 64 61 74 65 73 20 61 73 20 .marked.files,.which.updates.as.
4380 79 6f 75 20 6d 61 72 6b 20 6f 72 20 75 6e 6d 61 72 6b 20 66 69 6c 65 73 20 69 6e 20 64 69 72 65 you.mark.or.unmark.files.in.dire
43a0 64 2e 20 54 6f 20 6d 61 6b 65 0a 3d 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 67 65 6e 75 69 6e 65 d..To.make.=embark-live=.genuine
43c0 6c 79 20 75 73 65 66 75 6c 20 6f 74 68 65 72 20 63 61 6e 64 69 64 61 74 65 20 63 6f 6c 6c 65 63 ly.useful.other.candidate.collec
43e0 74 6f 72 73 20 61 72 65 20 72 65 71 75 69 72 65 64 2e 0a 54 68 65 20 3d 65 6d 62 61 72 6b 2d 63 tors.are.required..The.=embark-c
4400 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 20 28 64 6f 63 75 6d 65 6e 74 65 64 20 6e 65 61 72 onsult=.package.(documented.near
4420 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 69 73 20 6d 61 6e 75 61 6c 29 0a 63 6f 6e 74 61 69 6e .the.end.of.this.manual).contain
4440 73 20 61 20 66 65 77 3a 20 6f 6e 65 20 66 6f 72 20 69 6d 65 6e 75 20 69 74 65 6d 73 20 61 6e 64 s.a.few:.one.for.imenu.items.and
4460 20 6f 6e 65 20 66 6f 72 20 6f 75 74 6c 69 6e 65 20 68 65 61 64 69 6e 67 73 20 61 73 0a 75 73 65 .one.for.outline.headings.as.use
4480 64 20 62 79 20 3d 6f 75 74 6c 69 6e 65 2d 6d 69 6e 6f 72 2d 6d 6f 64 65 3d 2e 20 54 68 6f 73 65 d.by.=outline-minor-mode=..Those
44a0 20 63 6f 6c 6c 65 63 74 6f 72 73 20 72 65 61 6c 6c 79 20 64 6f 20 67 69 76 65 0a 3d 65 6d 62 61 .collectors.really.do.give.=emba
44c0 72 6b 2d 6c 69 76 65 3d 20 61 20 74 61 62 6c 65 2d 6f 66 2d 63 6f 6e 74 65 6e 74 73 20 66 65 65 rk-live=.a.table-of-contents.fee
44e0 6c 2e 0a 0a 2a 2a 20 53 77 69 74 63 68 69 6e 67 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 l...**.Switching.to.a.different.
4500 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 6c 6f 73 69 6e 67 20 77 68 61 74 20 79 6f 75 27 command.without.losing.what.you'
4520 76 65 20 74 79 70 65 64 0a 0a 45 6d 62 61 72 6b 20 61 6c 73 6f 20 68 61 73 20 74 68 65 20 3d 65 ve.typed..Embark.also.has.the.=e
4540 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d 20 63 6f 6d 6d 61 6e 64 20 77 68 69 63 68 20 69 73 20 75 mbark-become=.command.which.is.u
4560 73 65 66 75 6c 20 66 6f 72 20 77 68 65 6e 0a 79 6f 75 20 72 75 6e 20 61 20 63 6f 6d 6d 61 6e 64 seful.for.when.you.run.a.command
4580 2c 20 73 74 61 72 74 20 74 79 70 69 6e 67 20 61 74 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 ,.start.typing.at.the.minibuffer
45a0 20 61 6e 64 20 72 65 61 6c 69 7a 65 20 79 6f 75 0a 6d 65 61 6e 74 20 61 20 64 69 66 66 65 72 65 .and.realize.you.meant.a.differe
45c0 6e 74 20 63 6f 6d 6d 61 6e 64 2e 20 54 68 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 nt.command..The.most.common.case
45e0 20 66 6f 72 20 6d 65 20 69 73 20 74 68 61 74 20 49 20 72 75 6e 0a 3d 73 77 69 74 63 68 2d 74 6f .for.me.is.that.I.run.=switch-to
4600 2d 62 75 66 66 65 72 3d 2c 20 73 74 61 72 74 20 74 79 70 69 6e 67 20 61 20 62 75 66 66 65 72 20 -buffer=,.start.typing.a.buffer.
4620 6e 61 6d 65 20 61 6e 64 20 72 65 61 6c 69 7a 65 20 49 20 68 61 76 65 6e 27 74 0a 6f 70 65 6e 65 name.and.realize.I.haven't.opene
4640 64 20 74 68 65 20 66 69 6c 65 20 49 20 68 61 64 20 69 6e 20 6d 69 6e 64 20 79 65 74 21 20 49 27 d.the.file.I.had.in.mind.yet!.I'
4660 6c 6c 20 75 73 65 20 74 68 69 73 20 73 69 74 75 61 74 69 6f 6e 20 61 73 20 61 0a 72 75 6e 6e 69 ll.use.this.situation.as.a.runni
4680 6e 67 20 65 78 61 6d 70 6c 65 20 74 6f 20 69 6c 6c 75 73 74 72 61 74 65 20 3d 65 6d 62 61 72 6b ng.example.to.illustrate.=embark
46a0 2d 62 65 63 6f 6d 65 3d 2e 20 57 68 65 6e 20 74 68 69 73 20 68 61 70 70 65 6e 73 20 49 20 63 61 -become=..When.this.happens.I.ca
46c0 6e 2c 0a 6f 66 20 63 6f 75 72 73 65 2c 20 70 72 65 73 73 20 3d 43 2d 67 3d 20 61 6e 64 20 74 68 n,.of.course,.press.=C-g=.and.th
46e0 65 6e 20 72 75 6e 20 3d 66 69 6e 64 2d 66 69 6c 65 3d 20 61 6e 64 20 6f 70 65 6e 20 74 68 65 20 en.run.=find-file=.and.open.the.
4700 66 69 6c 65 2c 20 62 75 74 0a 74 68 69 73 20 72 65 71 75 69 72 65 73 20 72 65 74 79 70 69 6e 67 file,.but.this.requires.retyping
4720 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 66 69 6c 65 20 6e 61 6d 65 20 79 6f .the.portion.of.the.file.name.yo
4740 75 20 61 6c 72 65 61 64 79 0a 74 79 70 65 64 2e 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 63 61 u.already.typed..This.process.ca
4760 6e 20 62 65 20 73 74 72 65 61 6d 6c 69 6e 65 64 20 77 69 74 68 20 3d 65 6d 62 61 72 6b 2d 62 65 n.be.streamlined.with.=embark-be
4780 63 6f 6d 65 3d 3a 20 77 68 69 6c 65 20 73 74 69 6c 6c 0a 69 6e 20 74 68 65 20 3d 73 77 69 74 63 come=:.while.still.in.the.=switc
47a0 68 2d 74 6f 2d 62 75 66 66 65 72 3d 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 3d 65 6d 62 61 72 6b h-to-buffer=.you.can.run.=embark
47c0 2d 62 65 63 6f 6d 65 3d 20 61 6e 64 20 65 66 66 65 63 74 69 76 65 6c 79 0a 6d 61 6b 65 20 74 68 -become=.and.effectively.make.th
47e0 65 20 3d 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 3d 20 63 6f 6d 6d 61 6e 64 20 62 65 63 e.=switch-to-buffer=.command.bec
4800 6f 6d 65 20 3d 66 69 6e 64 2d 66 69 6c 65 3d 20 66 6f 72 20 74 68 69 73 20 72 75 6e 2e 0a 0a 59 ome.=find-file=.for.this.run...Y
4820 6f 75 20 63 61 6e 20 62 69 6e 64 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d 20 74 6f 20 61 ou.can.bind.=embark-become=.to.a
4840 20 6b 65 79 20 69 6e 20 3d 6d 69 6e 69 62 75 66 66 65 72 2d 6c 6f 63 61 6c 2d 6d 61 70 3d 2c 20 .key.in.=minibuffer-local-map=,.
4860 62 75 74 20 69 74 20 69 73 0a 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 61 6e 20 61 but.it.is.also.available.as.an.a
4880 63 74 69 6f 6e 20 75 6e 64 65 72 20 74 68 65 20 6c 65 74 74 65 72 20 3d 42 3d 20 28 75 70 70 65 ction.under.the.letter.=B=.(uppe
48a0 72 63 61 73 65 29 2c 20 73 6f 20 79 6f 75 0a 64 6f 6e 27 74 20 6e 65 65 64 20 61 20 62 69 6e 64 rcase),.so.you.don't.need.a.bind
48c0 69 6e 67 20 69 66 20 79 6f 75 20 61 6c 72 65 61 64 79 20 68 61 76 65 20 6f 6e 65 20 66 6f 72 20 ing.if.you.already.have.one.for.
48e0 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 2e 20 53 6f 2c 0a 61 73 73 75 6d 69 6e 67 20 49 20 68 61 76 =embark-act=..So,.assuming.I.hav
4900 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 62 6f 75 6e 64 20 74 6f 2c 20 73 61 79 2c 20 3d 43 e.=embark-act=.bound.to,.say,.=C
4920 2d 2e 3d 2c 20 6f 6e 63 65 20 49 20 72 65 61 6c 69 7a 65 20 49 0a 68 61 76 65 6e 27 74 20 6f 70 -.=,.once.I.realize.I.haven't.op
4940 65 6e 20 74 68 65 20 66 69 6c 65 20 49 20 63 61 6e 20 74 79 70 65 20 3d 43 2d 2e 20 42 20 43 2d en.the.file.I.can.type.=C-..B.C-
4960 78 20 43 2d 66 3d 20 74 6f 20 68 61 76 65 0a 3d 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 x.C-f=.to.have.=switch-to-buffer
4980 3d 20 62 65 63 6f 6d 65 20 3d 66 69 6e 64 2d 66 69 6c 65 3d 20 77 69 74 68 6f 75 74 20 6c 6f 73 =.become.=find-file=.without.los
49a0 69 6e 67 20 77 68 61 74 20 49 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 74 79 70 65 64 20 69 6e ing.what.I.have.already.typed.in
49c0 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 42 75 74 20 66 6f 72 20 65 76 65 6e 20 6d .the.minibuffer...But.for.even.m
49e0 6f 72 65 20 63 6f 6e 76 65 6e 69 65 6e 63 65 2c 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d ore.convenience,.=embark-become=
4a00 20 6f 66 66 65 72 73 20 73 68 6f 72 74 65 72 20 6b 65 79 0a 62 69 6e 64 69 6e 67 73 20 66 6f 72 .offers.shorter.key.bindings.for
4a20 20 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 20 61 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20 77 61 6e 74 .commands.you.are.likely.to.want
4a40 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 74 6f 0a 62 65 63 6f 6d 65 2e 20 .the.current.command.to.become..
4a60 57 68 65 6e 20 79 6f 75 20 75 73 65 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d 20 69 74 20 When.you.use.=embark-become=.it.
4a80 6c 6f 6f 6b 73 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 69 6e looks.for.the.current.command.in
4aa0 0a 61 6c 6c 20 6b 65 79 6d 61 70 73 20 6e 61 6d 65 64 20 69 6e 20 74 68 65 20 6c 69 73 74 20 3d .all.keymaps.named.in.the.list.=
4ac0 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 6b 65 79 6d 61 70 73 3d 20 61 6e 64 20 74 68 65 6e 20 embark-become-keymaps=.and.then.
4ae0 61 63 74 69 76 61 74 65 73 0a 61 6c 6c 20 6b 65 79 6d 61 70 73 20 74 68 61 74 20 63 6f 6e 74 61 activates.all.keymaps.that.conta
4b00 69 6e 20 69 74 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 in.it..For.example,.the.default.
4b20 76 61 6c 75 65 20 6f 66 0a 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 6b 65 79 6d 61 70 73 3d value.of.=embark-become-keymaps=
4b40 20 63 6f 6e 74 61 69 6e 73 20 61 20 6b 65 79 6d 61 70 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d .contains.a.keymap.=embark-becom
4b60 65 2d 66 69 6c 65 2b 62 75 66 66 65 72 2d 6d 61 70 3d 0a 77 69 74 68 20 62 69 6e 64 69 6e 67 73 e-file+buffer-map=.with.bindings
4b80 20 66 6f 72 20 73 65 76 65 72 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 72 65 6c 61 74 65 64 20 74 6f .for.several.commands.related.to
4ba0 20 66 69 6c 65 73 20 61 6e 64 20 62 75 66 66 65 72 73 2c 20 69 6e 0a 70 61 72 74 69 63 75 6c 61 .files.and.buffers,.in.particula
4bc0 72 2c 20 69 74 20 62 69 6e 64 73 20 3d 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 3d 20 74 r,.it.binds.=switch-to-buffer=.t
4be0 6f 20 3d 62 3d 20 61 6e 64 20 3d 66 69 6e 64 2d 66 69 6c 65 3d 20 74 6f 20 3d 66 3d 2e 20 53 6f o.=b=.and.=find-file=.to.=f=..So
4c00 20 77 68 65 6e 0a 49 20 61 63 63 69 64 65 6e 74 61 6c 6c 79 20 74 72 79 20 74 6f 20 73 77 69 74 .when.I.accidentally.try.to.swit
4c20 63 68 20 74 6f 20 61 20 62 75 66 66 65 72 20 66 6f 72 20 61 20 66 69 6c 65 20 49 20 68 61 76 65 ch.to.a.buffer.for.a.file.I.have
4c40 6e 27 74 20 6f 70 65 6e 65 64 0a 79 65 74 2c 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d 20 n't.opened.yet,.=embark-become=.
4c60 66 69 6e 64 73 20 74 68 61 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 49 20 72 61 6e 2c 20 3d 73 finds.that.the.command.I.ran,.=s
4c80 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 3d 2c 20 69 73 0a 69 6e 20 74 68 65 20 6b 65 79 6d witch-to-buffer=,.is.in.the.keym
4ca0 61 70 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 66 69 6c 65 2b 62 75 66 66 65 72 2d 6d 61 ap.=embark-become-file+buffer-ma
4cc0 70 3d 2c 20 73 6f 20 69 74 20 61 63 74 69 76 61 74 65 73 20 74 68 61 74 0a 6b 65 79 6d 61 70 20 p=,.so.it.activates.that.keymap.
4ce0 28 61 6e 64 20 61 6e 79 20 6f 74 68 65 72 73 20 74 68 61 74 20 61 6c 73 6f 20 63 6f 6e 74 61 69 (and.any.others.that.also.contai
4d00 6e 20 61 20 62 69 6e 64 69 6e 67 20 66 6f 72 0a 3d 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 n.a.binding.for.=switch-to-buffe
4d20 72 3d 29 2e 20 54 68 65 20 65 6e 64 20 72 65 73 75 6c 74 20 69 73 20 74 68 61 74 20 49 20 63 61 r=)..The.end.result.is.that.I.ca
4d40 6e 20 74 79 70 65 20 3d 43 2d 2e 20 42 20 66 3d 20 74 6f 0a 73 77 69 74 63 68 20 74 6f 20 3d 66 n.type.=C-..B.f=.to.switch.to.=f
4d60 69 6e 64 2d 66 69 6c 65 3d 2e 0a 0a 2a 20 51 75 69 63 6b 20 73 74 61 72 74 0a 0a 54 68 65 20 65 ind-file=...*.Quick.start..The.e
4d80 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 69 6e 73 74 61 6c 6c 20 45 6d 62 61 72 6b 20 69 73 20 asiest.way.to.install.Embark.is.
4da0 66 72 6f 6d 20 47 4e 55 20 45 4c 50 41 2c 20 6a 75 73 74 20 72 75 6e 20 3d 4d 2d 78 0a 70 61 63 from.GNU.ELPA,.just.run.=M-x.pac
4dc0 6b 61 67 65 2d 69 6e 73 74 61 6c 6c 20 52 45 54 20 65 6d 62 61 72 6b 20 52 45 54 3d 2e 20 28 49 kage-install.RET.embark.RET=..(I
4de0 74 20 69 73 20 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 4d 45 4c 50 41 2e 29 20 49 t.is.also.available.on.MELPA.).I
4e00 74 20 69 73 0a 68 69 67 68 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 61 6c 73 6f 20 t.is.highly.recommended.to.also.
4e20 69 6e 73 74 61 6c 6c 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e install.[[https://github.com/min
4e40 61 64 2f 6d 61 72 67 69 6e 61 6c 69 61 5d 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 5d 20 28 61 6c 73 ad/marginalia][Marginalia]].(als
4e60 6f 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 47 4e 55 0a 45 4c 50 41 29 2c 20 73 6f 20 74 68 61 o.available.on.GNU.ELPA),.so.tha
4e80 74 20 45 6d 62 61 72 6b 20 63 61 6e 20 6f 66 66 65 72 20 79 6f 75 20 70 72 65 63 6f 6e 66 69 67 t.Embark.can.offer.you.preconfig
4ea0 75 72 65 64 20 61 63 74 69 6f 6e 73 20 69 6e 20 6d 6f 72 65 0a 63 6f 6e 74 65 78 74 73 2e 20 46 ured.actions.in.more.contexts..F
4ec0 6f 72 20 3d 75 73 65 2d 70 61 63 6b 61 67 65 3d 20 75 73 65 72 73 2c 20 74 68 65 20 66 6f 6c 6c or.=use-package=.users,.the.foll
4ee0 6f 77 69 6e 67 20 69 73 20 61 20 76 65 72 79 20 72 65 61 73 6f 6e 61 62 6c 65 0a 73 74 61 72 74 owing.is.a.very.reasonable.start
4f00 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 ing.configuration:..#+begin_src.
4f20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 75 73 65 2d 70 61 63 6b 61 67 65 20 6d 61 72 67 69 6e emacs-lisp...(use-package.margin
4f40 61 6c 69 61 0a 20 20 20 20 3a 65 6e 73 75 72 65 20 74 0a 20 20 20 20 3a 63 6f 6e 66 69 67 0a 20 alia.....:ensure.t.....:config..
4f60 20 20 20 28 6d 61 72 67 69 6e 61 6c 69 61 2d 6d 6f 64 65 29 29 0a 0a 20 20 28 75 73 65 2d 70 61 ...(marginalia-mode))....(use-pa
4f80 63 6b 61 67 65 20 65 6d 62 61 72 6b 0a 20 20 20 20 3a 65 6e 73 75 72 65 20 74 0a 0a 20 20 20 20 ckage.embark.....:ensure.t......
4fa0 3a 62 69 6e 64 0a 20 20 20 20 28 28 22 43 2d 2e 22 20 2e 20 65 6d 62 61 72 6b 2d 61 63 74 29 20 :bind.....(("C-."...embark-act).
4fc0 20 20 20 20 20 20 20 20 3b 3b 20 70 69 63 6b 20 73 6f 6d 65 20 63 6f 6d 66 6f 72 74 61 62 6c 65 ........;;.pick.some.comfortable
4fe0 20 62 69 6e 64 69 6e 67 0a 20 20 20 20 20 28 22 43 2d 3b 22 20 2e 20 65 6d 62 61 72 6b 2d 64 77 .binding......("C-;"...embark-dw
5000 69 6d 29 20 20 20 20 20 20 20 20 3b 3b 20 67 6f 6f 64 20 61 6c 74 65 72 6e 61 74 69 76 65 3a 20 im)........;;.good.alternative:.
5020 4d 2d 2e 0a 20 20 20 20 20 28 22 43 2d 68 20 42 22 20 2e 20 65 6d 62 61 72 6b 2d 62 69 6e 64 69 M-.......("C-h.B"...embark-bindi
5040 6e 67 73 29 29 20 3b 3b 20 61 6c 74 65 72 6e 61 74 69 76 65 20 66 6f 72 20 60 64 65 73 63 72 69 ngs)).;;.alternative.for.`descri
5060 62 65 2d 62 69 6e 64 69 6e 67 73 27 0a 0a 20 20 20 20 3a 69 6e 69 74 0a 0a 20 20 20 20 3b 3b 20 be-bindings'......:init......;;.
5080 4f 70 74 69 6f 6e 61 6c 6c 79 20 72 65 70 6c 61 63 65 20 74 68 65 20 6b 65 79 20 68 65 6c 70 20 Optionally.replace.the.key.help.
50a0 77 69 74 68 20 61 20 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 20 69 6e 74 65 72 66 61 63 65 with.a.completing-read.interface
50c0 0a 20 20 20 20 28 73 65 74 71 20 70 72 65 66 69 78 2d 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 20 23 .....(setq.prefix-help-command.#
50e0 27 65 6d 62 61 72 6b 2d 70 72 65 66 69 78 2d 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 29 0a 0a 20 20 'embark-prefix-help-command)....
5100 20 20 3b 3b 20 53 68 6f 77 20 74 68 65 20 45 6d 62 61 72 6b 20 74 61 72 67 65 74 20 61 74 20 70 ..;;.Show.the.Embark.target.at.p
5120 6f 69 6e 74 20 76 69 61 20 45 6c 64 6f 63 2e 20 59 6f 75 20 6d 61 79 20 61 64 6a 75 73 74 20 74 oint.via.Eldoc..You.may.adjust.t
5140 68 65 0a 20 20 20 20 3b 3b 20 45 6c 64 6f 63 20 73 74 72 61 74 65 67 79 2c 20 69 66 20 79 6f 75 he.....;;.Eldoc.strategy,.if.you
5160 20 77 61 6e 74 20 74 6f 20 73 65 65 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 .want.to.see.the.documentation.f
5180 72 6f 6d 0a 20 20 20 20 3b 3b 20 6d 75 6c 74 69 70 6c 65 20 70 72 6f 76 69 64 65 72 73 2e 20 42 rom.....;;.multiple.providers..B
51a0 65 77 61 72 65 20 74 68 61 74 20 75 73 69 6e 67 20 74 68 69 73 20 63 61 6e 20 62 65 20 61 20 6c eware.that.using.this.can.be.a.l
51c0 69 74 74 6c 65 0a 20 20 20 20 3b 3b 20 6a 61 72 72 69 6e 67 20 73 69 6e 63 65 20 74 68 65 20 6d ittle.....;;.jarring.since.the.m
51e0 65 73 73 61 67 65 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 63 essage.shown.in.the.minibuffer.c
5200 61 6e 20 62 65 20 6d 6f 72 65 0a 20 20 20 20 3b 3b 20 74 68 61 6e 20 6f 6e 65 20 6c 69 6e 65 2c an.be.more.....;;.than.one.line,
5220 20 63 61 75 73 69 6e 67 20 74 68 65 20 6d 6f 64 65 6c 69 6e 65 20 74 6f 20 6d 6f 76 65 20 75 70 .causing.the.modeline.to.move.up
5240 20 61 6e 64 20 64 6f 77 6e 3a 0a 0a 20 20 20 20 3b 3b 20 28 61 64 64 2d 68 6f 6f 6b 20 27 65 6c .and.down:......;;.(add-hook.'el
5260 64 6f 63 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2d 66 75 6e 63 74 69 6f 6e 73 20 23 27 65 6d doc-documentation-functions.#'em
5280 62 61 72 6b 2d 65 6c 64 6f 63 2d 66 69 72 73 74 2d 74 61 72 67 65 74 29 0a 20 20 20 20 3b 3b 20 bark-eldoc-first-target).....;;.
52a0 28 73 65 74 71 20 65 6c 64 6f 63 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2d 73 74 72 61 74 65 (setq.eldoc-documentation-strate
52c0 67 79 20 23 27 65 6c 64 6f 63 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2d 63 6f 6d 70 6f 73 65 gy.#'eldoc-documentation-compose
52e0 2d 65 61 67 65 72 6c 79 29 0a 0a 20 20 20 20 3a 63 6f 6e 66 69 67 0a 0a 20 20 20 20 3b 3b 20 48 -eagerly)......:config......;;.H
5300 69 64 65 20 74 68 65 20 6d 6f 64 65 20 6c 69 6e 65 20 6f 66 20 74 68 65 20 45 6d 62 61 72 6b 20 ide.the.mode.line.of.the.Embark.
5320 6c 69 76 65 2f 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 62 75 66 66 65 72 73 0a 20 20 20 20 28 61 64 live/completions.buffers.....(ad
5340 64 2d 74 6f 2d 6c 69 73 74 20 27 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 6c 69 73 74 0a d-to-list.'display-buffer-alist.
5360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 28 22 5c 5c 60 5c 5c 2a 45 6d 62 61 72 6b .................'("\\`\\*Embark
5380 20 43 6f 6c 6c 65 63 74 20 5c 5c 28 4c 69 76 65 5c 5c 7c 43 6f 6d 70 6c 65 74 69 6f 6e 73 5c 5c .Collect.\\(Live\\|Completions\\
53a0 29 5c 5c 2a 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 69 6c 0a 20 20 20 )\\*"....................nil....
53c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 74 65 ................(window-paramete
53e0 72 73 20 28 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 20 2e 20 6e 6f 6e 65 29 29 29 29 29 rs.(mode-line-format...none)))))
5400 0a 0a 20 20 3b 3b 20 43 6f 6e 73 75 6c 74 20 75 73 65 72 73 20 77 69 6c 6c 20 61 6c 73 6f 20 77 ....;;.Consult.users.will.also.w
5420 61 6e 74 20 74 68 65 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 20 70 61 63 6b 61 67 65 2e 0a ant.the.embark-consult.package..
5440 20 20 28 75 73 65 2d 70 61 63 6b 61 67 65 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 0a 20 20 ..(use-package.embark-consult...
5460 20 20 3a 65 6e 73 75 72 65 20 74 20 3b 20 6f 6e 6c 79 20 6e 65 65 64 20 74 6f 20 69 6e 73 74 61 ..:ensure.t.;.only.need.to.insta
5480 6c 6c 20 69 74 2c 20 65 6d 62 61 72 6b 20 6c 6f 61 64 73 20 69 74 20 61 66 74 65 72 20 63 6f 6e ll.it,.embark.loads.it.after.con
54a0 73 75 6c 74 20 69 66 20 66 6f 75 6e 64 0a 20 20 20 20 3a 68 6f 6f 6b 0a 20 20 20 20 28 65 6d 62 sult.if.found.....:hook.....(emb
54c0 61 72 6b 2d 63 6f 6c 6c 65 63 74 2d 6d 6f 64 65 20 2e 20 63 6f 6e 73 75 6c 74 2d 70 72 65 76 69 ark-collect-mode...consult-previ
54e0 65 77 2d 61 74 2d 70 6f 69 6e 74 2d 6d 6f 64 65 29 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 41 62 ew-at-point-mode)).#+end_src..Ab
5500 6f 75 74 20 74 68 65 20 73 75 67 67 65 73 74 65 64 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 out.the.suggested.key.bindings.f
5520 6f 72 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 64 77 69 6d or.=embark-act=.and.=embark-dwim
5540 3d 3a 0a 2d 20 54 68 6f 73 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 75 6e 6c 69 =:.-.Those.key.bindings.are.unli
5560 6b 65 6c 79 20 74 6f 20 77 6f 72 6b 20 69 6e 20 74 68 65 20 74 65 72 6d 69 6e 61 6c 2c 20 62 75 kely.to.work.in.the.terminal,.bu
5580 74 0a 20 20 74 65 72 6d 69 6e 61 6c 20 75 73 65 72 73 20 61 72 65 20 70 72 6f 62 61 62 6c 79 20 t...terminal.users.are.probably.
55a0 77 65 6c 6c 20 61 77 61 72 65 20 6f 66 20 74 68 69 73 20 61 6e 64 20 77 69 6c 6c 20 6b 6e 6f 77 well.aware.of.this.and.will.know
55c0 20 74 6f 0a 20 20 73 65 6c 65 63 74 20 64 69 66 66 65 72 65 6e 74 20 62 69 6e 64 69 6e 67 73 2e .to...select.different.bindings.
55e0 0a 2d 20 54 68 65 20 73 75 67 67 65 73 74 65 64 20 3d 43 2d 2e 3d 20 62 69 6e 64 69 6e 67 20 69 .-.The.suggested.=C-.=.binding.i
5600 73 20 75 73 65 64 20 62 79 20 64 65 66 61 75 6c 74 20 69 6e 20 28 61 74 20 6c 65 61 73 74 20 73 s.used.by.default.in.(at.least.s
5620 6f 6d 65 0a 20 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 73 20 6f 66 29 20 47 4e 4f 4d 45 20 74 6f ome...installations.of).GNOME.to
5640 20 69 6e 70 75 74 20 65 6d 6f 6a 69 73 2c 20 61 6e 64 20 45 6d 61 63 73 20 64 6f 65 73 6e 27 74 .input.emojis,.and.Emacs.doesn't
5660 20 65 76 65 6e 20 67 65 74 0a 20 20 61 20 63 68 61 6e 63 65 20 74 6f 20 72 65 73 70 6f 6e 64 20 .even.get...a.chance.to.respond.
5680 74 6f 20 74 68 65 20 62 69 6e 64 69 6e 67 2e 20 59 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 61 to.the.binding..You.can.select.a
56a0 20 64 69 66 66 65 72 65 6e 74 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 3d 65 6d .different.key...binding.for.=em
56c0 62 61 72 6b 2d 61 63 74 3d 20 6f 72 20 75 73 65 20 3d 69 62 75 73 2d 73 65 74 75 70 3d 20 74 6f bark-act=.or.use.=ibus-setup=.to
56e0 20 63 68 61 6e 67 65 20 74 68 65 20 73 68 6f 72 74 63 75 74 20 66 6f 72 0a 20 20 65 6d 6f 6a 69 .change.the.shortcut.for...emoji
5700 20 69 6e 73 65 72 74 69 6f 6e 20 28 45 6d 61 63 73 20 32 39 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 .insertion.(Emacs.29.will.likely
5720 20 75 73 65 20 3d 43 2d 78 20 38 20 65 20 65 3d 2c 20 69 6e 20 63 61 73 65 20 79 6f 75 0a 20 20 .use.=C-x.8.e.e=,.in.case.you...
5740 77 61 6e 74 20 74 6f 20 73 65 74 20 74 68 65 20 73 61 6d 65 20 6f 6e 65 20 73 79 73 74 65 6d 2d want.to.set.the.same.one.system-
5760 77 69 64 65 29 2e 0a 2d 20 54 68 65 20 73 75 67 67 65 73 74 65 64 20 61 6c 74 65 72 6e 61 74 69 wide)..-.The.suggested.alternati
5780 76 65 20 6f 66 20 3d 4d 2d 2e 3d 20 66 6f 72 20 3d 65 6d 62 61 72 6b 2d 64 77 69 6d 3d 20 69 73 ve.of.=M-.=.for.=embark-dwim=.is
57a0 20 62 6f 75 6e 64 20 62 79 20 64 65 66 61 75 6c 74 0a 20 20 74 6f 20 3d 78 72 65 66 2d 66 69 6e .bound.by.default...to.=xref-fin
57c0 64 2d 64 65 66 69 6e 69 74 69 6f 6e 73 3d 2e 20 54 68 61 74 20 69 73 20 61 20 76 65 72 79 20 75 d-definitions=..That.is.a.very.u
57e0 73 65 66 75 6c 20 63 6f 6d 6d 61 6e 64 20 62 75 74 0a 20 20 6f 76 65 72 77 72 69 74 69 6e 67 20 seful.command.but...overwriting.
5800 69 74 20 77 69 74 68 20 3d 65 6d 62 61 72 6b 2d 64 77 69 6d 3d 20 69 73 20 73 65 6e 73 69 62 6c it.with.=embark-dwim=.is.sensibl
5820 65 20 73 69 6e 63 65 20 69 6e 20 45 6d 62 61 72 6b 27 73 0a 20 20 64 65 66 61 75 6c 74 20 63 6f e.since.in.Embark's...default.co
5840 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 3d 65 6d 62 61 72 6b 2d 64 77 69 6d 3d 20 77 69 6c 6c 20 nfiguration,.=embark-dwim=.will.
5860 61 6c 73 6f 20 66 69 6e 64 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 0a 20 20 74 68 also.find.the.definition.of...th
5880 65 20 69 64 65 6e 74 69 66 69 65 72 20 61 74 20 70 6f 69 6e 74 2e 20 28 4e 6f 74 65 20 74 68 61 e.identifier.at.point..(Note.tha
58a0 74 20 3d 78 72 65 66 2d 66 69 6e 64 2d 64 65 66 69 6e 69 74 69 6f 6e 73 3d 20 77 69 74 68 20 61 t.=xref-find-definitions=.with.a
58c0 0a 20 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 70 72 6f 6d 70 74 73 20 79 6f 75 20 66 ...prefix.argument.prompts.you.f
58e0 6f 72 20 61 6e 20 69 64 65 6e 74 69 66 69 65 72 2c 20 3d 65 6d 62 61 72 6b 2d 64 77 69 6d 3d 20 or.an.identifier,.=embark-dwim=.
5900 64 6f 65 73 20 6e 6f 74 0a 20 20 63 6f 76 65 72 20 74 68 69 73 20 63 61 73 65 29 2e 0a 0a 4f 74 does.not...cover.this.case)...Ot
5920 68 65 72 20 45 6d 62 61 72 6b 20 63 6f 6d 6d 61 6e 64 73 20 73 75 63 68 20 61 73 20 3d 65 6d 62 her.Embark.commands.such.as.=emb
5940 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 2c 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d 2c 0a 3d ark-act-all=,.=embark-become=,.=
5960 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 2c 20 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 65 78 70 embark-collect=,.and.=embark-exp
5980 6f 72 74 3d 20 63 61 6e 20 62 65 20 72 75 6e 20 74 68 72 6f 75 67 68 20 3d 65 6d 62 61 72 6b 2d ort=.can.be.run.through.=embark-
59a0 61 63 74 3d 20 61 73 0a 61 63 74 69 6f 6e 73 20 62 6f 75 6e 64 20 74 6f 20 3d 41 3d 2c 20 3d 42 act=.as.actions.bound.to.=A=,.=B
59c0 3d 2c 20 3d 53 3d 20 28 66 6f 72 20 22 73 6e 61 70 73 68 6f 74 22 29 2c 20 61 6e 64 20 3d 45 3d =,.=S=.(for."snapshot"),.and.=E=
59e0 20 72 65 73 70 65 63 74 69 76 65 6c 79 2c 20 61 6e 64 0a 74 68 75 73 20 64 6f 6e 27 74 20 72 65 .respectively,.and.thus.don't.re
5a00 61 6c 6c 79 20 6e 65 65 64 20 61 20 64 65 64 69 63 61 74 65 64 20 6b 65 79 20 62 69 6e 64 69 6e ally.need.a.dedicated.key.bindin
5a20 67 2c 20 62 75 74 20 66 65 65 6c 20 66 72 65 65 20 74 6f 20 62 69 6e 64 0a 74 68 65 6d 20 64 69 g,.but.feel.free.to.bind.them.di
5a40 72 65 63 74 6c 79 20 69 66 20 79 6f 75 20 73 6f 20 77 69 73 68 2e 20 49 66 20 79 6f 75 20 64 6f rectly.if.you.so.wish..If.you.do
5a60 20 63 68 6f 6f 73 65 20 74 6f 20 62 69 6e 64 20 74 68 65 6d 20 64 69 72 65 63 74 6c 79 2c 0a 79 .choose.to.bind.them.directly,.y
5a80 6f 75 27 6c 6c 20 70 72 6f 62 61 62 6c 79 20 77 61 6e 74 20 74 6f 20 62 69 6e 64 20 74 68 65 6d ou'll.probably.want.to.bind.them
5aa0 20 69 6e 20 3d 6d 69 6e 69 62 75 66 66 65 72 2d 6c 6f 63 61 6c 2d 6d 61 70 3d 2c 20 73 69 6e 63 .in.=minibuffer-local-map=,.sinc
5ac0 65 20 74 68 65 79 0a 61 72 65 20 6d 6f 73 74 20 75 73 65 66 75 6c 20 69 6e 20 74 68 65 20 6d 69 e.they.are.most.useful.in.the.mi
5ae0 6e 69 62 75 66 66 65 72 20 28 69 6e 20 66 61 63 74 2c 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d nibuffer.(in.fact,.=embark-becom
5b00 65 3d 20 6f 6e 6c 79 20 77 6f 72 6b 73 0a 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 29 e=.only.works.in.the.minibuffer)
5b20 2e 0a 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 64 77 69 6d 3d 20 65 78 65 ...The.command.=embark-dwim=.exe
5b40 63 75 74 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 61 74 20 70 6f 69 6e cutes.the.default.action.at.poin
5b60 74 2e 20 41 6e 6f 74 68 65 72 20 67 6f 6f 64 0a 6b 65 79 62 69 6e 64 69 6e 67 20 66 6f 72 20 3d t..Another.good.keybinding.for.=
5b80 65 6d 62 61 72 6b 2d 64 77 69 6d 3d 20 69 73 20 3d 4d 2d 2e 3d 20 73 69 6e 63 65 20 3d 65 6d 62 embark-dwim=.is.=M-.=.since.=emb
5ba0 61 72 6b 2d 64 77 69 6d 3d 20 61 63 74 73 20 6c 69 6b 65 0a 3d 78 72 65 66 2d 66 69 6e 64 2d 64 ark-dwim=.acts.like.=xref-find-d
5bc0 65 66 69 6e 69 74 69 6f 6e 73 3d 20 6f 6e 20 74 68 65 20 73 79 6d 62 6f 6c 20 61 74 20 70 6f 69 efinitions=.on.the.symbol.at.poi
5be0 6e 74 2e 20 3d 43 2d 2e 3d 20 63 61 6e 20 62 65 20 73 65 65 6e 20 61 73 20 61 0a 72 69 67 68 74 nt..=C-.=.can.be.seen.as.a.right
5c00 2d 63 6c 69 63 6b 20 63 6f 6e 74 65 78 74 20 6d 65 6e 75 20 61 74 20 70 6f 69 6e 74 20 61 6e 64 -click.context.menu.at.point.and
5c20 20 3d 4d 2d 2e 3d 20 61 63 74 73 20 6c 69 6b 65 20 6c 65 66 74 2d 63 6c 69 63 6b 2e 20 54 68 65 .=M-.=.acts.like.left-click..The
5c40 0a 6b 65 79 62 69 6e 64 69 6e 67 73 20 61 72 65 20 6d 6e 65 6d 6f 6e 69 63 2c 20 62 6f 74 68 20 .keybindings.are.mnemonic,.both.
5c60 61 63 74 20 61 74 20 74 68 65 20 70 6f 69 6e 74 20 28 3d 2e 3d 29 2e 0a 0a 45 6d 62 61 72 6b 20 act.at.the.point.(=.=)...Embark.
5c80 6e 65 65 64 73 20 74 6f 20 6b 6e 6f 77 20 77 68 61 74 20 79 6f 75 72 20 6d 69 6e 69 62 75 66 66 needs.to.know.what.your.minibuff
5ca0 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 79 73 74 65 6d 20 63 6f 6e 73 69 64 65 72 73 0a 74 er.completion.system.considers.t
5cc0 6f 20 62 65 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63 61 6e 64 69 64 61 74 65 73 20 61 6e 64 20 o.be.the.list.of.candidates.and.
5ce0 77 68 69 63 68 20 6f 6e 65 20 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 61 6e 64 69 64 61 which.one.is.the.current.candida
5d00 74 65 2e 0a 45 6d 62 61 72 6b 20 77 6f 72 6b 73 20 6f 75 74 20 6f 66 20 74 68 65 20 62 6f 78 20 te..Embark.works.out.of.the.box.
5d20 69 66 20 79 6f 75 20 75 73 65 20 45 6d 61 63 73 27 73 20 64 65 66 61 75 6c 74 20 74 61 62 20 63 if.you.use.Emacs's.default.tab.c
5d40 6f 6d 70 6c 65 74 69 6f 6e 2c 0a 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 3d 69 63 6f 6d 70 6c 65 ompletion,.the.built-in.=icomple
5d60 74 65 2d 6d 6f 64 65 3d 20 6f 72 20 3d 66 69 64 6f 2d 6d 6f 64 65 3d 2c 20 6f 72 20 74 68 65 20 te-mode=.or.=fido-mode=,.or.the.
5d80 74 68 69 72 64 2d 70 61 72 74 79 20 70 61 63 6b 61 67 65 73 0a 5b 5b 68 74 74 70 73 3a 2f 2f 67 third-party.packages.[[https://g
5da0 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 76 65 72 74 69 63 6f 5d 5b 56 65 72 74 69 63 6f ithub.com/minad/vertico][Vertico
5dc0 5d 5d 20 6f 72 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 61 62 6f 2d 61 ]].or.[[https://github.com/abo-a
5de0 62 6f 2f 73 77 69 70 65 72 5d 5b 49 76 79 5d 5d 2e 0a 0a 49 66 20 79 6f 75 20 61 72 65 20 61 20 bo/swiper][Ivy]]...If.you.are.a.
5e00 5b 5b 68 74 74 70 73 3a 2f 2f 65 6d 61 63 73 2d 68 65 6c 6d 2e 67 69 74 68 75 62 2e 69 6f 2f 68 [[https://emacs-helm.github.io/h
5e20 65 6c 6d 2f 5d 5b 48 65 6c 6d 5d 5d 20 6f 72 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 elm/][Helm]].or.[[https://github
5e40 2e 63 6f 6d 2f 61 62 6f 2d 61 62 6f 2f 73 77 69 70 65 72 5d 5b 49 76 79 5d 5d 20 75 73 65 72 20 .com/abo-abo/swiper][Ivy]].user.
5e60 79 6f 75 20 61 72 65 20 75 6e 6c 69 6b 65 6c 79 20 74 6f 20 77 61 6e 74 20 45 6d 62 61 72 6b 20 you.are.unlikely.to.want.Embark.
5e80 73 69 6e 63 65 0a 74 68 6f 73 65 20 70 61 63 6b 61 67 65 73 20 69 6e 63 6c 75 64 65 20 63 6f 6d since.those.packages.include.com
5ea0 70 72 65 68 65 6e 73 69 76 65 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 66 6f 72 20 61 63 74 prehensive.functionality.for.act
5ec0 69 6e 67 20 6f 6e 0a 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e ing.on.minibuffer.completion.can
5ee0 64 69 64 61 74 65 73 2e 20 28 45 6d 62 61 72 6b 20 64 6f 65 73 20 63 6f 6d 65 20 77 69 74 68 20 didates..(Embark.does.come.with.
5f00 49 76 79 0a 69 6e 74 65 67 72 61 74 69 6f 6e 20 64 65 73 70 69 74 65 20 74 68 69 73 2e 29 0a 0a Ivy.integration.despite.this.)..
5f20 2a 20 41 64 76 61 6e 63 65 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 2a 2a 20 53 68 6f 77 *.Advanced.configuration.**.Show
5f40 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 76 61 69 6c 61 62 6c 65 20 ing.information.about.available.
5f60 74 61 72 67 65 74 73 20 61 6e 64 20 61 63 74 69 6f 6e 73 0a 0a 42 79 20 64 65 66 61 75 6c 74 2c targets.and.actions..By.default,
5f80 20 69 66 20 79 6f 75 20 72 75 6e 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 61 6e 64 20 64 6f 20 .if.you.run.=embark-act=.and.do.
5fa0 6e 6f 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 73 65 6c 65 63 74 20 61 6e 0a 61 63 74 69 6f 6e not.immediately.select.an.action
5fc0 2c 20 61 66 74 65 72 20 61 20 73 68 6f 72 74 20 64 65 6c 61 79 20 45 6d 62 61 72 6b 20 77 69 6c ,.after.a.short.delay.Embark.wil
5fe0 6c 20 70 6f 70 20 75 70 20 61 20 62 75 66 66 65 72 20 63 61 6c 6c 65 64 20 3d 2a 45 6d 62 61 72 l.pop.up.a.buffer.called.=*Embar
6000 6b 0a 41 63 74 69 6f 6e 73 2a 3d 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 6c 69 73 74 20 6f 66 k.Actions*=.containing.a.list.of
6020 20 61 76 61 69 6c 61 62 6c 65 20 61 63 74 69 6f 6e 73 20 77 69 74 68 20 74 68 65 69 72 20 6b 65 .available.actions.with.their.ke
6040 79 0a 62 69 6e 64 69 6e 67 73 2e 20 59 6f 75 20 63 61 6e 20 73 63 72 6f 6c 6c 20 74 68 61 74 20 y.bindings..You.can.scroll.that.
6060 62 75 66 66 65 72 20 77 69 74 68 20 74 68 65 20 6d 6f 75 73 65 20 6f 66 20 77 69 74 68 20 74 68 buffer.with.the.mouse.of.with.th
6080 65 20 75 73 75 61 6c 0a 63 6f 6d 6d 61 6e 64 73 20 3d 73 63 72 6f 6c 6c 2d 6f 74 68 65 72 2d 77 e.usual.commands.=scroll-other-w
60a0 69 6e 64 6f 77 3d 20 61 6e 64 20 3d 73 63 72 6f 6c 6c 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 2d indow=.and.=scroll-other-window-
60c0 64 6f 77 6e 3d 20 28 62 6f 75 6e 64 20 62 79 0a 64 65 66 61 75 6c 74 20 74 6f 20 3d 43 2d 4d 2d down=.(bound.by.default.to.=C-M-
60e0 76 3d 20 61 6e 64 20 3d 43 2d 4d 2d 53 2d 76 3d 29 2e 0a 0a 54 68 61 74 20 66 75 6e 63 74 69 6f v=.and.=C-M-S-v=)...That.functio
6100 6e 61 6c 69 74 79 20 69 73 20 70 72 6f 76 69 64 65 64 20 62 79 20 74 68 65 20 3d 65 6d 62 61 72 nality.is.provided.by.the.=embar
6120 6b 2d 6d 69 78 65 64 2d 69 6e 64 69 63 61 74 6f 72 3d 2c 20 62 75 74 0a 45 6d 62 61 72 6b 20 68 k-mixed-indicator=,.but.Embark.h
6140 61 73 20 6f 74 68 65 72 20 69 6e 64 69 63 61 74 6f 72 73 20 74 68 61 74 20 63 61 6e 20 70 72 6f as.other.indicators.that.can.pro
6160 76 69 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 0a 74 61 72 67 65 vide.information.about.the.targe
6180 74 20 61 6e 64 20 69 74 73 20 74 79 70 65 2c 20 77 68 61 74 20 6f 74 68 65 72 20 74 61 72 67 65 t.and.its.type,.what.other.targe
61a0 74 73 20 79 6f 75 20 63 61 6e 20 63 79 63 6c 65 20 74 6f 2c 20 61 6e 64 20 77 68 69 63 68 0a 61 ts.you.can.cycle.to,.and.which.a
61c0 63 74 69 6f 6e 73 20 68 61 76 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 74 68 65 20 ctions.have.key.bindings.in.the.
61e0 61 63 74 69 6f 6e 20 6d 61 70 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 79 70 65 20 action.map.for.the.current.type.
6200 6f 66 0a 74 61 72 67 65 74 2e 20 41 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69 63 61 74 of.target..Any.number.of.indicat
6220 6f 72 73 20 63 61 6e 20 62 65 20 61 63 74 69 76 65 20 61 74 20 6f 6e 63 65 20 61 6e 64 20 74 68 ors.can.be.active.at.once.and.th
6240 65 20 75 73 65 72 0a 6f 70 74 69 6f 6e 20 3d 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 e.user.option.=embark-indicators
6260 3d 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20 74 6f 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 =.should.be.set.to.a.list.of.the
6280 20 64 65 73 69 72 65 64 0a 69 6e 64 69 63 61 74 6f 72 73 2e 0a 0a 45 6d 62 61 72 6b 20 63 6f 6d .desired.indicators...Embark.com
62a0 65 73 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 64 69 63 61 74 6f 72 73 es.with.the.following.indicators
62c0 3a 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 6d 69 6e 69 6d 61 6c 2d 69 6e 64 69 63 61 74 6f 72 3d 3a :..-.=embark-minimal-indicator=:
62e0 20 73 68 6f 77 73 20 61 20 6d 65 73 73 61 67 65 73 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 .shows.a.messages.in.the.echo.ar
6300 65 61 20 6f 72 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 20 73 68 6f 77 69 6e ea.or...minibuffer.prompt.showin
6320 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 20 61 6e 64 20 74 68 65 20 74 79 70 g.the.current.target.and.the.typ
6340 65 73 20 6f 66 20 61 6c 6c 0a 20 20 74 61 72 67 65 74 73 20 73 74 61 72 74 69 6e 67 20 77 69 74 es.of.all...targets.starting.wit
6360 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 6f 6e 65 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 68 69 h.the.current.one...-.=embark-hi
6380 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 3d 3a 20 68 69 67 68 6c 69 67 68 74 73 20 74 ghlight-indicator=:.highlights.t
63a0 68 65 20 74 61 72 67 65 74 20 61 74 20 70 6f 69 6e 74 3b 20 6f 6e 20 62 79 0a 20 20 64 65 66 61 he.target.at.point;.on.by...defa
63c0 75 6c 74 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 76 65 72 62 6f 73 65 2d 69 6e 64 69 63 61 74 6f ult...-.=embark-verbose-indicato
63e0 72 3d 3a 20 64 69 73 70 6c 61 79 73 20 61 20 74 61 62 6c 65 20 6f 66 20 61 63 74 69 6f 6e 73 20 r=:.displays.a.table.of.actions.
6400 61 6e 64 20 74 68 65 69 72 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 61 20 62 75 and.their.key...bindings.in.a.bu
6420 66 66 65 72 3b 20 74 68 69 73 20 69 73 20 6e 6f 74 20 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 2c ffer;.this.is.not.on.by.default,
6440 20 69 6e 20 66 61 76 6f 72 20 6f 66 20 74 68 65 0a 20 20 6d 69 78 65 64 20 69 6e 64 69 63 61 74 .in.favor.of.the...mixed.indicat
6460 6f 72 20 64 65 73 63 72 69 62 65 64 20 6e 65 78 74 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 6d 69 or.described.next...-.=embark-mi
6480 78 65 64 2d 69 6e 64 69 63 61 74 6f 72 3d 3a 20 73 74 61 72 74 73 20 6f 75 74 20 62 79 20 62 65 xed-indicator=:.starts.out.by.be
64a0 68 61 76 69 6e 67 20 61 73 20 74 68 65 20 6d 69 6e 69 6d 61 6c 0a 20 20 69 6e 64 69 63 61 74 6f having.as.the.minimal...indicato
64c0 72 20 62 75 74 20 61 66 74 65 72 20 61 20 73 68 6f 72 74 20 64 65 6c 61 79 20 61 63 74 73 20 61 r.but.after.a.short.delay.acts.a
64e0 73 20 74 68 65 20 76 65 72 62 6f 73 65 20 69 6e 64 69 63 61 74 6f 72 3b 0a 20 20 74 68 69 73 20 s.the.verbose.indicator;...this.
6500 69 73 20 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 69 73 65 is.on.by.default...-.=embark-ise
6520 61 72 63 68 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 3d 3a 20 74 68 69 73 20 arch-highlight-indicator=:.this.
6540 6f 6e 6c 79 20 64 6f 65 73 20 73 6f 6d 65 74 68 69 6e 67 20 77 68 65 6e 0a 20 20 74 68 65 20 63 only.does.something.when...the.c
6560 75 72 72 65 6e 74 20 74 61 72 67 65 74 20 69 73 20 74 68 65 20 73 79 6d 62 6f 6c 20 61 74 20 70 urrent.target.is.the.symbol.at.p
6580 6f 69 6e 74 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 69 74 0a 20 20 6c 61 7a 69 6c 79 20 oint,.in.which.case.it...lazily.
65a0 68 69 67 68 6c 69 67 68 74 73 20 61 6c 6c 20 6f 63 63 75 72 72 65 6e 63 65 73 20 6f 66 20 74 68 highlights.all.occurrences.of.th
65c0 61 74 20 73 79 6d 62 6f 6c 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 62 75 66 66 65 at.symbol.in.the.current...buffe
65e0 72 2c 20 6c 69 6b 65 20 69 73 65 61 72 63 68 3b 20 61 6c 73 6f 20 6f 6e 20 62 79 20 64 65 66 61 r,.like.isearch;.also.on.by.defa
6600 75 6c 74 2e 0a 0a 55 73 65 72 73 20 6f 66 20 74 68 65 20 70 6f 70 75 6c 61 72 20 5b 5b 68 74 74 ult...Users.of.the.popular.[[htt
6620 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 75 73 74 62 75 72 2f 65 6d 61 63 73 2d 77 68 ps://github.com/justbur/emacs-wh
6640 69 63 68 2d 6b 65 79 5d 5b 77 68 69 63 68 2d 6b 65 79 5d 5d 20 70 61 63 6b 61 67 65 20 6d 61 79 ich-key][which-key]].package.may
6660 20 70 72 65 66 65 72 20 74 6f 20 75 73 65 20 74 68 65 0a 3d 65 6d 62 61 72 6b 2d 77 68 69 63 68 .prefer.to.use.the.=embark-which
6680 2d 6b 65 79 2d 69 6e 64 69 63 61 74 6f 72 3d 20 66 72 6f 6d 20 74 68 65 20 5b 5b 68 74 74 70 73 -key-indicator=.from.the.[[https
66a0 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 77 69 ://github.com/oantolin/embark/wi
66c0 6b 69 2f 41 64 64 69 74 69 6f 6e 61 6c 2d 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 23 75 73 65 2d ki/Additional-Configuration#use-
66e0 77 68 69 63 68 2d 6b 65 79 2d 6c 69 6b 65 2d 61 2d 6b 65 79 2d 6d 65 6e 75 2d 70 72 6f 6d 70 74 which-key-like-a-key-menu-prompt
6700 5d 5b 45 6d 62 61 72 6b 20 77 69 6b 69 5d 5d 2e 20 4a 75 73 74 20 63 6f 70 79 20 69 74 73 0a 64 ][Embark.wiki]]..Just.copy.its.d
6720 65 66 69 6e 69 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 77 69 6b 69 20 69 6e 74 6f 20 79 6f 75 efinition.from.the.wiki.into.you
6740 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 63 75 73 74 6f 6d 69 7a 65 20 74 68 r.configuration.and.customize.th
6760 65 0a 3d 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 3d 20 75 73 65 72 20 6f 70 74 69 6f e.=embark-indicators=.user.optio
6780 6e 20 74 6f 20 65 78 63 6c 75 64 65 20 74 68 65 20 6d 69 78 65 64 20 61 6e 64 20 76 65 72 62 6f n.to.exclude.the.mixed.and.verbo
67a0 73 65 0a 69 6e 64 69 63 61 74 6f 72 73 20 61 6e 64 20 74 6f 20 69 6e 63 6c 75 64 65 20 3d 65 6d se.indicators.and.to.include.=em
67c0 62 61 72 6b 2d 77 68 69 63 68 2d 6b 65 79 2d 69 6e 64 69 63 61 74 6f 72 3d 2e 0a 0a 49 66 20 79 bark-which-key-indicator=...If.y
67e0 6f 75 20 75 73 65 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 ou.use.[[https://github.com/mina
6800 64 2f 76 65 72 74 69 63 6f 5d 5b 56 65 72 74 69 63 6f 5d 5d 2c 20 74 68 65 72 65 20 69 73 20 61 d/vertico][Vertico]],.there.is.a
6820 6e 20 65 76 65 6e 20 65 61 73 69 65 72 20 77 61 79 20 74 6f 20 67 65 74 20 61 0a 3d 77 68 69 63 n.even.easier.way.to.get.a.=whic
6840 68 2d 6b 65 79 3d 2d 6c 69 6b 65 20 64 69 73 70 6c 61 79 20 74 68 61 74 20 61 6c 73 6f 20 6c 65 h-key=-like.display.that.also.le
6860 74 73 20 79 6f 75 20 75 73 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 74 6f 20 6e 61 72 72 6f 77 0a ts.you.use.completion.to.narrow.
6880 64 6f 77 6e 20 74 68 65 20 6c 69 73 74 20 6f 66 20 61 6c 74 65 72 6e 61 74 69 76 65 73 2c 20 64 down.the.list.of.alternatives,.d
68a0 65 73 63 72 69 62 65 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6e 65 78 74 0a escribed.at.the.end.of.the.next.
68c0 73 65 63 74 69 6f 6e 2e 0a 0a 2a 2a 20 53 65 6c 65 63 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 section...**.Selecting.commands.
68e0 76 69 61 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 69 6e 73 74 65 61 64 20 6f 66 20 6b 65 79 20 62 via.completions.instead.of.key.b
6900 69 6e 64 69 6e 67 73 0a 0a 41 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 74 6f 20 72 65 indings..As.an.alternative.to.re
6920 61 64 69 6e 67 20 74 68 65 20 6c 69 73 74 20 6f 66 20 61 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 ading.the.list.of.actions.in.the
6940 20 76 65 72 62 6f 73 65 20 6f 72 0a 6d 69 78 65 64 20 69 6e 64 69 63 61 74 6f 72 73 20 28 73 65 .verbose.or.mixed.indicators.(se
6960 65 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 65 63 74 69 6f 6e 20 66 6f 72 20 61 20 64 65 73 e.the.previous.section.for.a.des
6980 63 72 69 70 74 69 6f 6e 20 6f 66 0a 74 68 65 73 65 29 2c 20 79 6f 75 20 63 61 6e 20 70 72 65 73 cription.of.these),.you.can.pres
69a0 73 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 68 65 6c 70 2d 6b 65 79 3d 2c 20 77 68 69 63 68 20 69 s.the.=embark-help-key=,.which.i
69c0 73 20 3d 43 2d 68 3d 20 62 79 20 64 65 66 61 75 6c 74 0a 28 62 75 74 20 79 6f 75 20 6d 61 79 20 s.=C-h=.by.default.(but.you.may.
69e0 70 72 65 66 65 72 20 3d 3f 3d 20 74 6f 20 66 72 65 65 20 75 70 20 3d 43 2d 68 3d 20 66 6f 72 20 prefer.=?=.to.free.up.=C-h=.for.
6a00 75 73 65 20 61 73 20 61 20 70 72 65 66 69 78 29 20 61 66 74 65 72 0a 72 75 6e 6e 69 6e 67 20 3d use.as.a.prefix).after.running.=
6a20 65 6d 62 61 72 6b 2d 61 63 74 3d 2e 20 50 72 65 73 73 69 6e 67 20 74 68 65 20 68 65 6c 70 20 6b embark-act=..Pressing.the.help.k
6a40 65 79 20 77 69 6c 6c 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 74 68 65 20 6e 61 6d 65 0a ey.will.prompt.you.for.the.name.
6a60 6f 66 20 61 6e 20 61 63 74 69 6f 6e 20 77 69 74 68 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 28 62 75 of.an.action.with.completion.(bu
6a80 74 20 66 65 65 6c 20 66 72 65 65 20 74 6f 20 65 6e 74 65 72 20 61 20 63 6f 6d 6d 61 6e 64 20 74 t.feel.free.to.enter.a.command.t
6aa0 68 61 74 20 69 73 0a 6e 6f 74 20 61 6d 6f 6e 67 20 74 68 65 20 6f 66 66 65 72 65 64 20 63 61 6e hat.is.not.among.the.offered.can
6ac0 64 69 64 61 74 65 73 21 29 2c 20 61 6e 64 20 77 69 6c 6c 20 61 6c 73 6f 20 72 65 6d 69 6e 64 20 didates!),.and.will.also.remind.
6ae0 79 6f 75 20 6f 66 20 74 68 65 0a 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 20 59 6f 75 20 63 61 6e you.of.the.key.bindings..You.can
6b00 20 70 72 65 73 73 20 3d 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 70 72 6f 6d 70 74 65 72 2d 6b .press.=embark-keymap-prompter-k
6b20 65 79 3d 2c 20 77 68 69 63 68 20 69 73 20 3d 40 3d 20 62 79 0a 64 65 66 61 75 6c 74 2c 20 61 74 ey=,.which.is.=@=.by.default,.at
6b40 20 74 68 65 20 70 72 6f 6d 70 74 20 61 6e 64 20 74 68 65 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 .the.prompt.and.then.one.of.the.
6b60 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 74 6f 20 65 6e 74 65 72 20 74 68 65 0a 6e 61 6d 65 20 6f key.bindings.to.enter.the.name.o
6b80 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 61 63 74 69 6f 6e 2e 0a 0a 59 6f 75 f.the.corresponding.action...You
6ba0 20 6d 61 79 20 74 68 69 6e 6b 20 74 68 61 74 20 77 69 74 68 20 74 68 65 20 3d 2a 45 6d 62 61 72 .may.think.that.with.the.=*Embar
6bc0 6b 20 41 63 74 69 6f 6e 73 2a 3d 20 62 75 66 66 65 72 20 70 6f 70 70 69 6e 67 20 75 70 20 74 6f k.Actions*=.buffer.popping.up.to
6be0 0a 72 65 6d 69 6e 64 20 79 6f 75 20 6f 66 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 .remind.you.of.the.key.bindings.
6c00 79 6f 75 27 64 20 6e 65 76 65 72 20 77 61 6e 74 20 74 6f 20 75 73 65 20 63 6f 6d 70 6c 65 74 69 you'd.never.want.to.use.completi
6c20 6f 6e 20 74 6f 0a 73 65 6c 65 63 74 20 61 6e 20 61 63 74 69 6f 6e 20 62 79 20 6e 61 6d 65 2c 20 on.to.select.an.action.by.name,.
6c40 62 75 74 20 70 65 72 73 6f 6e 61 6c 6c 79 20 49 20 66 69 6e 64 20 74 68 61 74 20 74 79 70 69 6e but.personally.I.find.that.typin
6c60 67 20 61 20 73 6d 61 6c 6c 0a 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 61 63 74 69 6f 6e 20 g.a.small.portion.of.the.action.
6c80 6e 61 6d 65 20 74 6f 20 6e 61 72 72 6f 77 20 64 6f 77 6e 20 74 68 65 20 6c 69 73 74 20 6f 66 20 name.to.narrow.down.the.list.of.
6ca0 63 61 6e 64 69 64 61 74 65 73 20 66 65 65 6c 73 0a 73 69 67 6e 69 66 69 63 61 6e 74 6c 79 20 66 candidates.feels.significantly.f
6cc0 61 73 74 65 72 20 74 68 61 6e 20 76 69 73 75 61 6c 6c 79 20 73 63 61 6e 6e 69 6e 67 20 74 68 65 aster.than.visually.scanning.the
6ce0 20 65 6e 74 69 72 65 20 6c 69 73 74 20 6f 66 20 61 63 74 69 6f 6e 73 2e 0a 0a 49 66 20 79 6f 75 .entire.list.of.actions...If.you
6d00 20 66 69 6e 64 20 79 6f 75 20 70 72 65 66 65 72 20 73 65 6c 65 63 74 69 6e 67 20 61 63 74 69 6f .find.you.prefer.selecting.actio
6d20 6e 73 20 74 68 61 74 20 77 61 79 2c 20 79 6f 75 20 63 61 6e 20 63 6f 6e 66 69 67 75 72 65 0a 65 ns.that.way,.you.can.configure.e
6d40 6d 62 61 72 6b 20 74 6f 20 61 6c 77 61 79 73 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 61 mbark.to.always.prompt.you.for.a
6d60 63 74 69 6f 6e 73 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 3d ctions.by.setting.the.variable.=
6d80 65 6d 62 61 72 6b 2d 70 72 6f 6d 70 74 65 72 3d 20 74 6f 20 3d 65 6d 62 61 72 6b 2d 63 6f 6d 70 embark-prompter=.to.=embark-comp
6da0 6c 65 74 69 6e 67 2d 72 65 61 64 2d 70 72 6f 6d 70 74 65 72 3d 2e 0a 0a 4f 6e 20 74 68 65 20 6f leting-read-prompter=...On.the.o
6dc0 74 68 65 72 20 68 61 6e 64 2c 20 79 6f 75 20 6d 61 79 20 77 69 73 68 20 74 6f 20 63 6f 6e 74 69 ther.hand,.you.may.wish.to.conti
6de0 6e 75 65 20 75 73 69 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 0a 61 nue.using.key.bindings.for.the.a
6e00 63 74 69 6f 6e 73 20 79 6f 75 20 70 65 72 66 6f 72 6d 20 6d 6f 73 74 20 6f 66 74 65 6e 2c 20 61 ctions.you.perform.most.often,.a
6e20 6e 64 20 74 6f 20 75 73 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 6e 6c 79 20 74 6f 20 65 78 70 nd.to.use.completion.only.to.exp
6e40 6c 6f 72 65 0a 77 68 61 74 20 66 75 72 74 68 65 72 20 61 63 74 69 6f 6e 73 20 61 72 65 20 61 76 lore.what.further.actions.are.av
6e60 61 69 6c 61 62 6c 65 20 6f 72 20 77 68 65 6e 20 79 6f 75 27 76 65 20 66 6f 72 67 6f 74 74 65 6e ailable.or.when.you've.forgotten
6e80 20 61 20 6b 65 79 0a 62 69 6e 64 69 6e 67 2e 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 79 6f .a.key.binding..In.that.case,.yo
6ea0 75 20 6d 61 79 20 70 72 65 66 65 72 20 74 6f 20 75 73 65 20 74 68 65 20 6d 69 6e 69 6d 61 6c 20 u.may.prefer.to.use.the.minimal.
6ec0 69 6e 64 69 63 61 74 6f 72 2c 0a 77 68 69 63 68 20 64 6f 65 73 20 6e 6f 74 20 70 6f 70 2d 75 70 indicator,.which.does.not.pop-up
6ee0 20 61 6e 20 3d 2a 45 6d 62 61 72 6b 20 41 63 74 69 6f 6e 73 2a 3d 20 62 75 66 66 65 72 20 61 74 .an.=*Embark.Actions*=.buffer.at
6f00 20 61 6c 6c 2c 20 61 6e 64 20 74 6f 20 75 73 65 0a 74 68 65 20 3d 65 6d 62 61 72 6b 2d 68 65 6c .all,.and.to.use.the.=embark-hel
6f20 70 2d 6b 65 79 3d 20 77 68 65 6e 65 76 65 72 20 79 6f 75 20 6e 65 65 64 20 68 65 6c 70 2e 20 54 p-key=.whenever.you.need.help..T
6f40 68 69 73 20 75 6e 6f 62 74 72 75 73 69 76 65 20 73 65 74 75 70 20 69 73 0a 61 63 68 69 65 76 65 his.unobtrusive.setup.is.achieve
6f60 64 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 d.with.the.following.configurati
6f80 6f 6e 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 73 on:..#+begin_src.emacs-lisp...(s
6fa0 65 74 71 20 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 0a 20 20 20 20 20 20 20 20 27 28 etq.embark-indicators.........'(
6fc0 65 6d 62 61 72 6b 2d 6d 69 6e 69 6d 61 6c 2d 69 6e 64 69 63 61 74 6f 72 20 20 3b 20 64 65 66 61 embark-minimal-indicator..;.defa
6fe0 75 6c 74 20 69 73 20 65 6d 62 61 72 6b 2d 6d 69 78 65 64 2d 69 6e 64 69 63 61 74 6f 72 0a 20 20 ult.is.embark-mixed-indicator...
7000 20 20 20 20 20 20 20 20 65 6d 62 61 72 6b 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 ........embark-highlight-indicat
7020 6f 72 0a 20 20 20 20 20 20 20 20 20 20 65 6d 62 61 72 6b 2d 69 73 65 61 72 63 68 2d 68 69 67 68 or...........embark-isearch-high
7040 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 29 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 5b 5b 68 light-indicator)).#+end_src..[[h
7060 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 76 65 72 74 69 63 6f 5d ttps://github.com/minad/vertico]
7080 5b 56 65 72 74 69 63 6f 5d 5d 20 75 73 65 72 73 20 6d 61 79 20 77 69 73 68 20 74 6f 20 63 6f 6e [Vertico]].users.may.wish.to.con
70a0 66 69 67 75 72 65 20 61 20 67 72 69 64 20 64 69 73 70 6c 61 79 20 66 6f 72 20 74 68 65 20 61 63 figure.a.grid.display.for.the.ac
70c0 74 69 6f 6e 73 20 61 6e 64 0a 6b 65 79 2d 62 69 6e 64 69 6e 67 73 2c 20 72 65 6d 69 6e 69 73 63 tions.and.key-bindings,.reminisc
70e0 65 6e 74 20 6f 66 20 74 68 65 20 70 6f 70 75 6c 61 72 20 70 61 63 6b 61 67 65 20 5b 5b 68 74 74 ent.of.the.popular.package.[[htt
7100 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 75 73 74 62 75 72 2f 65 6d 61 63 73 2d 77 68 ps://github.com/justbur/emacs-wh
7120 69 63 68 2d 6b 65 79 5d 5b 77 68 69 63 68 2d 6b 65 79 5d 5d 2c 20 62 75 74 2c 20 6f 66 0a 63 6f ich-key][which-key]],.but,.of.co
7140 75 72 73 65 2c 20 65 6e 68 61 6e 63 65 64 20 62 79 20 74 68 65 20 75 73 65 20 6f 66 20 63 6f 6d urse,.enhanced.by.the.use.of.com
7160 70 6c 65 74 69 6f 6e 20 74 6f 20 6e 61 72 72 6f 77 20 74 68 65 20 6c 69 73 74 20 6f 66 0a 63 6f pletion.to.narrow.the.list.of.co
7180 6d 6d 61 6e 64 73 2e 20 49 6e 20 6f 72 64 65 72 20 74 6f 20 67 65 74 20 74 68 65 20 67 72 69 64 mmands..In.order.to.get.the.grid
71a0 20 64 69 73 70 6c 61 79 2c 20 70 75 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 20 79 .display,.put.the.following.in.y
71c0 6f 75 72 0a 56 65 72 74 69 63 6f 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 23 2b 62 65 our.Vertico.configuration:..#+be
71e0 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 61 64 64 2d 74 6f 2d 6c 69 73 gin_src.emacs-lisp...(add-to-lis
7200 74 20 27 76 65 72 74 69 63 6f 2d 6d 75 6c 74 69 66 6f 72 6d 2d 63 61 74 65 67 6f 72 69 65 73 20 t.'vertico-multiform-categories.
7220 27 28 65 6d 62 61 72 6b 2d 6b 65 79 62 69 6e 64 69 6e 67 20 67 72 69 64 29 29 0a 20 20 28 76 65 '(embark-keybinding.grid))...(ve
7240 72 74 69 63 6f 2d 6d 75 6c 74 69 66 6f 72 6d 2d 6d 6f 64 65 29 0a 23 2b 65 6e 64 5f 73 72 63 0a rtico-multiform-mode).#+end_src.
7260 0a 54 68 69 73 20 77 69 6c 6c 20 6d 61 6b 65 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 6b 65 .This.will.make.the.available.ke
7280 79 73 20 62 65 20 73 68 6f 77 6e 20 69 6e 20 61 20 63 6f 6d 70 61 63 74 20 67 72 69 64 20 6c 69 ys.be.shown.in.a.compact.grid.li
72a0 6b 65 20 69 6e 0a 3d 77 68 69 63 68 2d 6b 65 79 3d 2e 20 54 68 65 20 3d 76 65 72 74 69 63 6f 2d ke.in.=which-key=..The.=vertico-
72c0 6d 75 6c 74 69 66 6f 72 6d 2d 6d 6f 64 65 3d 20 61 6c 73 6f 20 65 6e 61 62 6c 65 73 20 6b 65 79 multiform-mode=.also.enables.key
72e0 73 20 73 75 63 68 20 61 73 20 3d 4d 2d 56 3d 2c 0a 3d 4d 2d 47 3d 2c 20 3d 4d 2d 42 3d 2c 20 61 s.such.as.=M-V=,.=M-G=,.=M-B=,.a
7300 6e 64 20 3d 4d 2d 55 3d 20 66 6f 72 20 6d 61 6e 75 61 6c 6c 79 20 73 77 69 74 63 68 69 6e 67 20 nd.=M-U=.for.manually.switching.
7320 62 65 74 77 65 65 6e 20 6c 61 79 6f 75 74 73 20 69 6e 20 56 65 72 74 69 63 6f 0a 62 75 66 66 65 between.layouts.in.Vertico.buffe
7340 72 73 2e 0a 0a 2a 2a 2a 20 53 65 6c 65 63 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 76 69 61 20 rs...***.Selecting.commands.via.
7360 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 75 74 73 69 64 65 20 6f 66 20 45 6d 62 61 72 6b 0a 0a 49 66 completion.outside.of.Embark..If
7380 20 79 6f 75 20 6c 69 6b 65 20 74 68 69 73 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 69 6e 74 65 72 66 .you.like.this.completion.interf
73a0 61 63 65 20 66 6f 72 20 65 78 70 6c 6f 72 69 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 ace.for.exploring.key.bindings.f
73c0 6f 72 0a 45 6d 62 61 72 6b 20 61 63 74 69 6f 6e 73 2c 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 or.Embark.actions,.you.may.want.
73e0 74 6f 20 75 73 65 20 69 74 20 65 6c 73 65 77 68 65 72 65 20 69 6e 20 45 6d 61 63 73 2e 20 59 6f to.use.it.elsewhere.in.Emacs..Yo
7400 75 20 63 61 6e 20 75 73 65 0a 45 6d 62 61 72 6b 27 73 20 63 6f 6d 70 6c 65 74 69 6f 6e 2d 62 61 u.can.use.Embark's.completion-ba
7420 73 65 64 20 63 6f 6d 6d 61 6e 64 20 70 72 6f 6d 70 74 65 72 20 74 6f 20 6c 69 73 74 3a 0a 0a 2d sed.command.prompter.to.list:..-
7440 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 75 6e 64 65 72 20 61 20 70 72 65 66 69 78 2c 0a 2d 20 .key.bindings.under.a.prefix,.-.
7460 6c 6f 63 61 6c 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2c 20 6f 72 0a 2d 20 61 6c 6c 20 6b 65 79 local.key.bindings,.or.-.all.key
7480 20 62 69 6e 64 69 6e 67 73 2e 0a 20 20 0a 54 6f 20 75 73 65 20 69 74 20 66 6f 72 20 6b 65 79 20 .bindings.....To.use.it.for.key.
74a0 62 69 6e 64 69 6e 67 73 20 75 6e 64 65 72 20 61 20 70 72 65 66 69 78 20 28 79 6f 75 20 63 61 6e bindings.under.a.prefix.(you.can
74c0 20 75 73 65 20 74 68 69 73 20 74 6f 20 72 65 70 6c 61 63 65 0a 74 68 65 20 3d 77 68 69 63 68 2d .use.this.to.replace.the.=which-
74e0 6b 65 79 3d 20 70 61 63 6b 61 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 29 2c 20 75 73 65 20 key=.package,.for.example),.use.
7500 74 68 69 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 this.configuration:..#+begin_src
7520 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 73 65 74 71 20 70 72 65 66 69 78 2d 68 65 6c 70 2d .emacs-lisp...(setq.prefix-help-
7540 63 6f 6d 6d 61 6e 64 20 23 27 65 6d 62 61 72 6b 2d 70 72 65 66 69 78 2d 68 65 6c 70 2d 63 6f 6d command.#'embark-prefix-help-com
7560 6d 61 6e 64 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 4e 6f 77 2c 20 77 68 65 6e 20 79 6f 75 20 68 mand).#+end_src..Now,.when.you.h
7580 61 76 65 20 73 74 61 72 74 65 64 20 6f 6e 20 61 20 70 72 65 66 69 78 20 73 65 71 75 65 6e 63 65 ave.started.on.a.prefix.sequence
75a0 20 73 75 63 68 20 61 73 20 3d 43 2d 78 3d 20 6f 72 20 3d 43 2d 63 3d 2c 0a 70 72 65 73 73 69 6e .such.as.=C-x=.or.=C-c=,.pressin
75c0 67 20 3d 43 2d 68 3d 20 77 69 6c 6c 20 62 72 69 6e 67 20 75 70 20 74 68 65 20 45 6d 62 61 72 6b g.=C-h=.will.bring.up.the.Embark
75e0 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 0a 3d 70 72 65 66 69 78 .version.of.the.built-in.=prefix
7600 2d 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 3d 2c 20 77 68 69 63 68 20 77 69 6c 6c 20 6c 69 73 74 20 -help-command=,.which.will.list.
7620 74 68 65 20 6b 65 79 73 20 75 6e 64 65 72 20 74 68 61 74 20 70 72 65 66 69 78 20 61 6e 64 0a 74 the.keys.under.that.prefix.and.t
7640 68 65 69 72 20 62 69 6e 64 69 6e 67 73 2c 20 61 6e 64 20 6c 65 74 73 20 79 6f 75 20 73 65 6c 65 heir.bindings,.and.lets.you.sele
7660 63 74 20 74 68 65 20 6f 6e 65 20 79 6f 75 20 77 61 6e 74 65 64 20 77 69 74 68 20 63 6f 6d 70 6c ct.the.one.you.wanted.with.compl
7680 65 74 69 6f 6e 2c 0a 6f 72 20 62 79 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 69 66 20 79 6f 75 20 etion,.or.by.key.binding.if.you.
76a0 70 72 65 73 73 20 3d 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 70 72 6f 6d 70 74 65 72 2d 6b 65 press.=embark-keymap-prompter-ke
76c0 79 3d 2e 0a 0a 54 6f 20 6c 69 73 74 20 6c 6f 63 61 6c 20 6f 72 20 67 6c 6f 62 61 6c 20 6b 65 79 y=...To.list.local.or.global.key
76e0 20 62 69 6e 64 69 6e 67 73 2c 20 75 73 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 3d 65 6d 62 61 .bindings,.use.the.command.=emba
7700 72 6b 2d 62 69 6e 64 69 6e 67 73 3d 2e 0a 59 6f 75 20 63 61 6e 20 62 69 6e 64 20 74 68 61 74 20 rk-bindings=..You.can.bind.that.
7720 74 6f 20 3d 43 2d 68 20 62 3d 2c 20 77 68 69 63 68 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 to.=C-h.b=,.which.is.the.default
7740 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 74 68 65 0a 62 75 69 6c 74 2d 69 6e 20 3d 64 .key.binding.for.the.built-in.=d
7760 65 73 63 72 69 62 65 2d 62 69 6e 64 69 6e 67 73 3d 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 escribe-bindings=.command,.which
7780 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 72 65 70 6c 61 63 65 2e 20 42 79 0a 64 65 .this.command.can.replace..By.de
77a0 66 61 75 6c 74 2c 20 3d 65 6d 62 61 72 6b 2d 62 69 6e 64 69 6e 67 73 3d 20 6c 69 73 74 73 20 6c fault,.=embark-bindings=.lists.l
77c0 6f 63 61 6c 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2c 20 74 79 70 69 63 61 6c 6c 79 20 74 68 6f ocal.key.bindings,.typically.tho
77e0 73 65 0a 62 6f 75 6e 64 20 69 6e 20 74 68 65 20 6d 61 6a 6f 72 20 6d 6f 64 65 20 6b 65 79 6d 61 se.bound.in.the.major.mode.keyma
7800 70 3b 20 74 6f 20 67 65 74 20 67 6c 6f 62 61 6c 20 62 69 6e 64 69 6e 67 73 20 61 73 20 77 65 6c p;.to.get.global.bindings.as.wel
7820 6c 2c 20 63 61 6c 6c 0a 69 74 20 77 69 74 68 20 61 20 3d 43 2d 75 3d 20 70 72 65 66 69 78 20 61 l,.call.it.with.a.=C-u=.prefix.a
7840 72 67 75 6d 65 6e 74 2e 0a 0a 2a 2a 20 51 75 69 74 74 69 6e 67 20 74 68 65 20 6d 69 6e 69 62 75 rgument...**.Quitting.the.minibu
7860 66 66 65 72 20 61 66 74 65 72 20 61 6e 20 61 63 74 69 6f 6e 0a 0a 42 79 20 64 65 66 61 75 6c 74 ffer.after.an.action..By.default
7880 2c 20 69 66 20 79 6f 75 20 63 61 6c 6c 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 66 72 6f 6d 20 ,.if.you.call.=embark-act=.from.
78a0 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 74 20 71 75 69 74 73 20 74 68 65 0a 6d 69 6e 69 the.minibuffer.it.quits.the.mini
78c0 62 75 66 66 65 72 20 61 66 74 65 72 20 70 65 72 66 6f 72 6d 69 6e 67 20 74 68 65 20 61 63 74 69 buffer.after.performing.the.acti
78e0 6f 6e 2e 20 59 6f 75 20 63 61 6e 20 63 68 61 6e 67 65 20 74 68 69 73 20 62 79 20 73 65 74 74 69 on..You.can.change.this.by.setti
7900 6e 67 0a 74 68 65 20 75 73 65 72 20 6f 70 74 69 6f 6e 20 3d 65 6d 62 61 72 6b 2d 71 75 69 74 2d ng.the.user.option.=embark-quit-
7920 61 66 74 65 72 2d 61 63 74 69 6f 6e 3d 20 74 6f 20 3d 6e 69 6c 3d 2e 20 48 61 76 69 6e 67 20 3d after-action=.to.=nil=..Having.=
7940 65 6d 62 61 72 6b 2d 61 63 74 3d 20 2f 6e 6f 74 2f 0a 71 75 69 74 20 74 68 65 20 6d 69 6e 69 62 embark-act=./not/.quit.the.minib
7960 75 66 66 65 72 20 63 61 6e 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 74 75 72 6e 20 63 6f 6d 6d uffer.can.be.useful.to.turn.comm
7980 61 6e 64 73 20 69 6e 74 6f 20 6c 69 74 74 6c 65 20 22 74 68 69 6e 67 0a 6d 61 6e 61 67 65 72 73 ands.into.little."thing.managers
79a0 22 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 3d 66 69 6e "..For.example,.you.can.use.=fin
79c0 64 2d 66 69 6c 65 3d 20 61 73 20 61 20 6c 69 74 74 6c 65 20 66 69 6c 65 20 6d 61 6e 61 67 65 72 d-file=.as.a.little.file.manager
79e0 0a 6f 72 20 3d 64 65 73 63 72 69 62 65 2d 70 61 63 6b 61 67 65 3d 20 61 73 20 61 20 6c 69 74 74 .or.=describe-package=.as.a.litt
7a00 6c 65 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 3a 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 le.package.manager:.you.can.run.
7a20 74 68 6f 73 65 0a 63 6f 6d 6d 61 6e 64 73 2c 20 70 65 72 66 6f 72 6d 20 61 20 73 65 72 69 65 73 those.commands,.perform.a.series
7a40 20 6f 66 20 61 63 74 69 6f 6e 73 2c 20 61 6e 64 20 74 68 65 6e 20 71 75 69 74 20 74 68 65 20 63 .of.actions,.and.then.quit.the.c
7a60 6f 6d 6d 61 6e 64 2e 0a 0a 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 ommand...If.you.want.to.control.
7a80 74 68 65 20 71 75 69 74 74 69 6e 67 20 62 65 68 61 76 69 6f 72 20 69 6e 20 61 20 66 69 6e 65 2d the.quitting.behavior.in.a.fine-
7aa0 67 72 61 69 6e 65 64 20 6d 61 6e 6e 65 72 0a 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 grained.manner.depending.on.the.
7ac0 61 63 74 69 6f 6e 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 20 3d 65 6d 62 61 72 6b 2d 71 75 69 74 action,.you.can.set.=embark-quit
7ae0 2d 61 66 74 65 72 2d 61 63 74 69 6f 6e 3d 20 74 6f 20 61 6e 0a 61 6c 69 73 74 2c 20 61 73 73 6f -after-action=.to.an.alist,.asso
7b00 63 69 61 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 65 69 74 68 65 72 20 3d 74 3d 20 66 ciating.commands.to.either.=t=.f
7b20 6f 72 20 71 75 69 74 74 69 6e 67 20 6f 72 20 3d 6e 69 6c 3d 20 66 6f 72 20 6e 6f 74 0a 71 75 69 or.quitting.or.=nil=.for.not.qui
7b40 74 74 69 6e 67 2e 20 57 68 65 6e 20 75 73 69 6e 67 20 61 6e 20 61 6c 69 73 74 2c 20 79 6f 75 20 tting..When.using.an.alist,.you.
7b60 63 61 6e 20 75 73 65 20 74 68 65 20 73 70 65 63 69 61 6c 20 6b 65 79 20 3d 74 3d 20 74 6f 0a 73 can.use.the.special.key.=t=.to.s
7b80 70 65 63 69 66 79 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 2e 20 46 6f 72 pecify.the.default.behavior..For
7ba0 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 61 74 20 62 79 20 64 65 66 .example,.to.specify.that.by.def
7bc0 61 75 6c 74 0a 61 63 74 69 6f 6e 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 71 75 69 74 20 74 68 65 ault.actions.should.not.quit.the
7be0 20 6d 69 6e 69 62 75 66 66 65 72 20 62 75 74 20 74 68 61 74 20 75 73 69 6e 67 20 3d 6b 69 6c 6c .minibuffer.but.that.using.=kill
7c00 2d 62 75 66 66 65 72 3d 20 61 73 0a 61 6e 20 61 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 71 75 69 -buffer=.as.an.action.should.qui
7c20 74 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e t,.you.can.use.the.following.con
7c40 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c figuration:..#+begin_src.emacs-l
7c60 69 73 70 0a 20 20 28 73 65 74 71 20 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 66 74 65 72 2d 61 63 isp...(setq.embark-quit-after-ac
7c80 74 69 6f 6e 20 27 28 28 6b 69 6c 6c 2d 62 75 66 66 65 72 20 2e 20 74 29 20 28 74 20 2e 20 6e 69 tion.'((kill-buffer...t).(t...ni
7ca0 6c 29 29 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 54 68 65 20 76 61 72 69 61 62 6c 65 20 3d 65 6d l))).#+end_src..The.variable.=em
7cc0 62 61 72 6b 2d 71 75 69 74 2d 61 66 74 65 72 2d 61 63 74 69 6f 6e 3d 20 6f 6e 6c 79 20 73 70 65 bark-quit-after-action=.only.spe
7ce0 63 69 66 69 65 73 20 61 20 64 65 66 61 75 6c 74 2c 20 74 68 61 74 0a 69 73 2c 20 69 74 20 6f 6e cifies.a.default,.that.is,.it.on
7d00 6c 79 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 3d 65 6d 62 61 ly.controls.whether.or.not.=emba
7d20 72 6b 2d 61 63 74 3d 20 71 75 69 74 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 0a 77 68 65 rk-act=.quits.the.minibuffer.whe
7d40 6e 20 79 6f 75 20 63 61 6c 6c 20 69 74 20 77 69 74 68 6f 75 74 20 61 20 70 72 65 66 69 78 20 61 n.you.call.it.without.a.prefix.a
7d60 72 67 75 6d 65 6e 74 2c 20 61 6e 64 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 74 68 65 0a rgument,.and.you.can.select.the.
7d80 6f 70 70 6f 73 69 74 65 20 62 65 68 61 76 69 6f 72 20 74 6f 20 77 68 61 74 20 74 68 65 20 76 61 opposite.behavior.to.what.the.va
7da0 72 69 61 62 6c 65 20 73 61 79 73 20 62 79 20 63 61 6c 6c 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 61 riable.says.by.calling.=embark-a
7dc0 63 74 3d 20 77 69 74 68 0a 3d 43 2d 75 3d 2e 20 41 6c 73 6f 20 6e 6f 74 65 20 74 68 61 74 20 62 ct=.with.=C-u=..Also.note.that.b
7de0 6f 74 68 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 3d 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 66 oth.the.variable.=embark-quit-af
7e00 74 65 72 2d 61 63 74 69 6f 6e 3d 20 61 6e 64 20 3d 43 2d 75 3d 0a 68 61 76 65 20 6e 6f 20 65 66 ter-action=.and.=C-u=.have.no.ef
7e20 66 65 63 74 20 77 68 65 6e 20 79 6f 75 20 63 61 6c 6c 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 20 fect.when.you.call.=embark-act=.
7e40 6f 75 74 73 69 64 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 49 66 20 79 6f 75 20 outside.the.minibuffer...If.you.
7e60 66 69 6e 64 20 79 6f 75 72 73 65 6c 66 20 75 73 69 6e 67 20 74 68 65 20 71 75 69 74 74 69 6e 67 find.yourself.using.the.quitting
7e80 20 61 6e 64 20 6e 6f 6e 2d 71 75 69 74 74 69 6e 67 20 76 61 72 69 61 6e 74 73 20 6f 66 0a 3d 65 .and.non-quitting.variants.of.=e
7ea0 6d 62 61 72 6b 2d 61 63 74 3d 20 61 62 6f 75 74 20 65 71 75 61 6c 6c 79 20 6f 66 74 65 6e 2c 20 mbark-act=.about.equally.often,.
7ec0 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 68 65 20 61 63 74 69 6f 6e 2c 20 79 6f 75 independently.of.the.action,.you
7ee0 20 6d 61 79 0a 70 72 65 66 65 72 20 74 6f 20 73 69 6d 70 6c 79 20 68 61 76 65 20 73 65 70 61 72 .may.prefer.to.simply.have.separ
7f00 61 74 65 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 74 68 65 6d 20 69 6e 73 74 65 61 64 20 6f 66 ate.commands.for.them.instead.of
7f20 20 61 20 73 69 6e 67 6c 65 0a 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 79 6f 75 20 63 61 6c 6c 20 .a.single.command.that.you.call.
7f40 77 69 74 68 20 3d 43 2d 75 3d 20 68 61 6c 66 20 74 68 65 20 74 69 6d 65 2e 20 59 6f 75 20 63 6f with.=C-u=.half.the.time..You.co
7f60 75 6c 64 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 6b 65 65 70 20 74 68 65 20 64 65 66 61 75 uld,.for.example,.keep.the.defau
7f80 6c 74 20 65 78 69 74 69 6e 67 20 62 65 68 61 76 69 6f 72 20 6f 66 20 3d 65 6d 62 61 72 6b 2d 61 lt.exiting.behavior.of.=embark-a
7fa0 63 74 3d 20 61 6e 64 20 64 65 66 69 6e 65 20 61 0a 6e 6f 6e 2d 71 75 69 74 74 69 6e 67 20 76 65 ct=.and.define.a.non-quitting.ve
7fc0 72 73 69 6f 6e 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 rsion.as.follows:..#+begin_src.e
7fe0 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 61 63 74 2d 6e 6f macs-lisp...(defun.embark-act-no
8000 71 75 69 74 20 28 29 0a 20 20 20 20 22 52 75 6e 20 61 63 74 69 6f 6e 20 62 75 74 20 64 6f 6e 27 quit.()....."Run.action.but.don'
8020 74 20 71 75 69 74 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 61 66 74 65 72 77 61 72 64 73 t.quit.the.minibuffer.afterwards
8040 2e 22 0a 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 28 6c 65 74 20 28 28 .".....(interactive).....(let.((
8060 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 66 74 65 72 2d 61 63 74 69 6f 6e 20 6e 69 6c 29 29 0a 20 embark-quit-after-action.nil))..
8080 20 20 20 20 20 28 65 6d 62 61 72 6b 2d 61 63 74 29 29 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 2a .....(embark-act))).#+end_src..*
80a0 2a 20 52 75 6e 6e 69 6e 67 20 73 6f 6d 65 20 73 65 74 75 70 20 61 66 74 65 72 20 69 6e 6a 65 63 *.Running.some.setup.after.injec
80c0 74 69 6e 67 20 74 68 65 20 74 61 72 67 65 74 0a 0a 59 6f 75 20 63 61 6e 20 63 75 73 74 6f 6d 69 ting.the.target..You.can.customi
80e0 7a 65 20 77 68 61 74 20 68 61 70 70 65 6e 73 20 61 66 74 65 72 20 74 68 65 20 74 61 72 67 65 74 ze.what.happens.after.the.target
8100 20 69 73 20 69 6e 73 65 72 74 65 64 20 61 74 20 74 68 65 0a 6d 69 6e 69 62 75 66 66 65 72 20 70 .is.inserted.at.the.minibuffer.p
8120 72 6f 6d 70 74 20 6f 66 20 61 6e 20 61 63 74 69 6f 6e 2e 20 54 68 65 72 65 20 61 72 65 0a 3d 65 rompt.of.an.action..There.are.=e
8140 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2c 20 74 mbark-target-injection-hooks=,.t
8160 68 61 74 20 61 72 65 20 72 75 6e 20 62 79 20 64 65 66 61 75 6c 74 20 61 66 74 65 72 20 69 6e 6a hat.are.run.by.default.after.inj
8180 65 63 74 69 6e 67 0a 74 68 65 20 74 61 72 67 65 74 20 69 6e 74 6f 20 74 68 65 20 6d 69 6e 69 62 ecting.the.target.into.the.minib
81a0 75 66 66 65 72 2e 20 54 68 65 20 76 61 72 69 61 62 6c 65 0a 3d 65 6d 62 61 72 6b 2d 74 61 72 67 uffer..The.variable.=embark-targ
81c0 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 20 69 73 20 61 6e 20 61 6c 69 73 74 20 et-injection-hooks=.is.an.alist.
81e0 61 73 73 6f 63 69 61 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 0a 74 68 65 69 72 20 73 65 associating.commands.to.their.se
8200 74 75 70 20 68 6f 6f 6b 73 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 73 70 65 63 69 61 6c tup.hooks..There.are.two.special
8220 20 6b 65 79 73 3a 20 69 66 20 6e 6f 20 73 65 74 75 70 20 68 6f 6f 6b 20 69 73 0a 73 70 65 63 69 .keys:.if.no.setup.hook.is.speci
8240 66 69 65 64 20 66 6f 72 20 61 20 67 69 76 65 6e 20 61 63 74 69 6f 6e 2c 20 74 68 65 20 68 6f 6f fied.for.a.given.action,.the.hoo
8260 6b 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 3d 74 3d 20 69 73 20 72 75 6e 3b 20 61 6e 64 20 k.associated.to.=t=.is.run;.and.
8280 74 68 65 0a 68 6f 6f 6b 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 3d 3a 61 6c 77 61 79 73 3d the.hook.associated.to.=:always=
82a0 20 69 73 20 72 75 6e 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 61 63 74 69 6f 6e .is.run.regardless.of.the.action
82c0 2e 20 28 54 68 69 73 0a 76 61 72 69 61 62 6c 65 20 75 73 65 64 20 74 6f 20 68 61 76 65 20 74 68 ..(This.variable.used.to.have.th
82e0 65 20 6c 65 73 73 20 65 78 70 6c 69 63 69 74 20 6e 61 6d 65 20 6f 66 0a 3d 65 6d 62 61 72 6b 2d e.less.explicit.name.of.=embark-
8300 73 65 74 75 70 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2c 20 73 6f 20 70 6c 65 61 73 65 20 75 setup-action-hooks=,.so.please.u
8320 70 64 61 74 65 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 29 0a 0a 46 6f 72 20 pdate.your.configuration.)..For.
8340 65 78 61 6d 70 6c 65 2c 20 63 6f 6e 73 69 64 65 72 20 75 73 69 6e 67 20 3d 73 68 65 6c 6c 2d 63 example,.consider.using.=shell-c
8360 6f 6d 6d 61 6e 64 3d 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 20 64 75 72 69 6e 67 20 66 69 6c 65 ommand=.as.an.action.during.file
8380 0a 63 6f 6d 70 6c 65 74 69 6f 6e 2e 20 49 74 20 77 6f 75 6c 64 20 62 65 20 75 73 65 66 75 6c 20 .completion..It.would.be.useful.
83a0 74 6f 20 69 6e 73 65 72 74 20 61 20 73 70 61 63 65 20 62 65 66 6f 72 65 20 74 68 65 20 74 61 72 to.insert.a.space.before.the.tar
83c0 67 65 74 0a 66 69 6c 65 20 6e 61 6d 65 20 61 6e 64 20 74 6f 20 6c 65 61 76 65 20 74 68 65 20 70 get.file.name.and.to.leave.the.p
83e0 6f 69 6e 74 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 2c 20 73 6f 20 79 6f 75 20 63 61 oint.at.the.beginning,.so.you.ca
8400 6e 0a 69 6d 6d 65 64 69 61 74 65 6c 79 20 74 79 70 65 20 74 68 65 20 73 68 65 6c 6c 20 63 6f 6d n.immediately.type.the.shell.com
8420 6d 61 6e 64 20 74 6f 20 72 75 6e 20 6f 6e 20 74 68 61 74 20 66 69 6c 65 2e 20 54 68 61 74 27 73 mand.to.run.on.that.file..That's
8440 20 77 68 79 20 69 6e 0a 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 .why.in.Embark's.default.configu
8460 72 61 74 69 6f 6e 20 74 68 65 72 65 20 69 73 20 61 6e 20 65 6e 74 72 79 20 69 6e 0a 3d 65 6d 62 ration.there.is.an.entry.in.=emb
8480 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 20 61 73 73 6f ark-target-injection-hooks=.asso
84a0 63 69 61 74 69 6e 67 20 3d 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 3d 20 74 6f 20 61 20 68 6f 6f ciating.=shell-command=.to.a.hoo
84c0 6b 20 74 68 61 74 0a 69 6e 63 6c 75 64 65 73 20 3d 65 6d 62 61 72 6b 2d 2d 73 68 65 6c 6c 2d 70 k.that.includes.=embark--shell-p
84e0 72 65 70 3d 2c 20 61 20 73 69 6d 70 6c 65 20 68 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 74 rep=,.a.simple.helper.function.t
8500 68 61 74 20 71 75 6f 74 65 73 20 61 6c 6c 0a 74 68 65 20 73 70 61 63 65 73 20 69 6e 20 74 68 65 hat.quotes.all.the.spaces.in.the
8520 20 66 69 6c 65 20 6e 61 6d 65 2c 20 69 6e 73 65 72 74 73 20 61 6e 20 65 78 74 72 61 20 73 70 61 .file.name,.inserts.an.extra.spa
8540 63 65 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 0a 6f 66 20 74 68 65 20 6c 69 6e 65 20 ce.at.the.beginning.of.the.line.
8560 61 6e 64 20 6c 65 61 76 65 73 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6c 65 66 74 20 6f 66 20 and.leaves.point.to.the.left.of.
8580 69 74 2e 0a 0a 4e 6f 77 2c 20 74 68 65 20 70 72 65 70 61 72 61 74 69 6f 6e 20 74 68 61 74 20 3d it...Now,.the.preparation.that.=
85a0 65 6d 62 61 72 6b 2d 2d 73 68 65 6c 6c 2d 70 72 65 70 3d 20 64 6f 65 73 20 77 6f 75 6c 64 20 62 embark--shell-prep=.does.would.b
85c0 65 20 75 73 65 6c 65 73 73 20 69 66 0a 45 6d 62 61 72 6b 20 64 69 64 20 77 68 61 74 20 69 74 20 e.useless.if.Embark.did.what.it.
85e0 6e 6f 72 6d 61 6c 6c 79 20 64 6f 65 73 20 61 66 74 65 72 20 69 74 20 69 6e 73 65 72 74 73 20 74 normally.does.after.it.inserts.t
8600 68 65 20 74 61 72 67 65 74 20 6f 66 20 74 68 65 0a 61 63 74 69 6f 6e 20 61 74 20 74 68 65 20 6d he.target.of.the.action.at.the.m
8620 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 2c 20 77 68 69 63 68 20 69 73 20 74 6f 20 22 70 inibuffer.prompt,.which.is.to."p
8640 72 65 73 73 20 3d 52 45 54 3d 22 20 66 6f 72 20 79 6f 75 2c 0a 61 63 63 65 70 74 69 6e 67 20 74 ress.=RET=".for.you,.accepting.t
8660 68 65 20 74 61 72 67 65 74 20 61 73 20 69 73 3b 20 69 66 20 45 6d 62 61 72 6b 20 64 69 64 20 74 he.target.as.is;.if.Embark.did.t
8680 68 61 74 20 66 6f 72 20 3d 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 3d 20 79 6f 75 0a 77 6f 75 6c hat.for.=shell-command=.you.woul
86a0 64 6e 27 74 20 67 65 74 20 61 20 63 68 61 6e 63 65 20 74 6f 20 74 79 70 65 20 69 6e 20 74 68 65 dn't.get.a.chance.to.type.in.the
86c0 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 65 78 65 63 75 74 65 21 20 54 68 61 74 20 69 73 20 77 68 79 .command.to.execute!.That.is.why
86e0 0a 69 6e 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 .in.Embark's.default.configurati
8700 6f 6e 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 3d 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 3d on.the.entry.for.=shell-command=
8720 20 69 6e 0a 3d 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f .in.=embark-target-injection-hoo
8740 6b 73 3d 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 0a 3d ks=.also.contains.the.function.=
8760 65 6d 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 3d 2e 0a 0a 45 6d 62 61 72 6b 20 75 73 65 embark--allow-edit=...Embark.use
8780 64 20 74 6f 20 68 61 76 65 20 61 20 64 65 64 69 63 61 74 65 64 20 76 61 72 69 61 62 6c 65 20 3d d.to.have.a.dedicated.variable.=
87a0 65 6d 62 61 72 6b 2d 61 6c 6c 6f 77 2d 65 64 69 74 2d 61 63 74 69 6f 6e 73 3d 20 74 6f 0a 77 68 embark-allow-edit-actions=.to.wh
87c0 69 63 68 20 79 6f 75 20 63 6f 75 6c 64 20 61 64 64 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 77 ich.you.could.add.commands.for.w
87e0 68 69 63 68 20 45 6d 62 61 72 6b 20 73 68 6f 75 6c 64 20 66 6f 72 67 6f 20 70 72 65 73 73 69 6e hich.Embark.should.forgo.pressin
8800 67 0a 3d 52 45 54 3d 20 66 6f 72 20 79 6f 75 20 61 66 74 65 72 20 69 6e 73 65 72 74 69 6e 67 20 g.=RET=.for.you.after.inserting.
8820 74 68 65 20 74 61 72 67 65 74 2e 20 53 69 6e 63 65 20 69 74 73 20 65 66 66 65 63 74 20 63 61 6e the.target..Since.its.effect.can
8840 20 61 6c 73 6f 20 62 65 0a 61 63 68 69 65 76 65 64 20 76 69 61 20 74 68 65 20 67 65 6e 65 72 61 .also.be.achieved.via.the.genera
8860 6c 20 3d 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 l.=embark-target-injection-hooks
8880 3d 20 6d 65 63 68 61 6e 69 73 6d 2c 20 74 68 61 74 0a 76 61 72 69 61 62 6c 65 20 68 61 73 20 62 =.mechanism,.that.variable.has.b
88a0 65 65 6e 20 72 65 6d 6f 76 65 64 20 74 6f 20 73 69 6d 70 6c 69 66 79 20 45 6d 62 61 72 6b 2e 20 een.removed.to.simplify.Embark..
88c0 42 65 20 73 75 72 65 20 74 6f 20 75 70 64 61 74 65 20 79 6f 75 72 0a 63 6f 6e 66 69 67 75 72 61 Be.sure.to.update.your.configura
88e0 74 69 6f 6e 3b 20 69 66 20 79 6f 75 20 68 61 64 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 3a tion;.if.you.had.something.like:
8900 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 61 64 64 2d ..#+begin_src.emacs-lisp...(add-
8920 74 6f 2d 6c 69 73 74 20 27 65 6d 62 61 72 6b 2d 61 6c 6c 6f 77 2d 65 64 69 74 2d 61 63 74 69 6f to-list.'embark-allow-edit-actio
8940 6e 73 20 27 6d 79 2d 63 6f 6d 6d 61 6e 64 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 79 6f 75 20 73 ns.'my-command).#+end_src..you.s
8960 68 6f 75 6c 64 20 72 65 70 6c 61 63 65 20 69 74 20 77 69 74 68 3a 0a 0a 23 2b 62 65 67 69 6e 5f hould.replace.it.with:..#+begin_
8980 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 70 75 73 68 20 27 65 6d 62 61 72 6b 2d 2d src.emacs-lisp...(push.'embark--
89a0 61 6c 6c 6f 77 2d 65 64 69 74 0a 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d 67 65 74 20 27 6d allow-edit.........(alist-get.'m
89c0 79 2d 63 6f 6d 6d 61 6e 64 20 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f y-command.embark-target-injectio
89e0 6e 2d 68 6f 6f 6b 73 29 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 0a 41 6c 73 6f 20 6e 6f 74 65 20 n-hooks)).#+end_src...Also.note.
8a00 74 68 61 74 20 77 68 69 6c 65 20 79 6f 75 20 63 6f 75 6c 64 20 61 62 75 73 65 20 3d 65 6d 62 61 that.while.you.could.abuse.=emba
8a20 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 3d 20 73 6f 20 74 68 61 74 20 79 6f 75 0a 68 61 76 65 rk--allow-edit=.so.that.you.have
8a40 20 74 6f 20 63 6f 6e 66 69 72 6d 20 22 64 61 6e 67 65 72 6f 75 73 22 20 61 63 74 69 6f 6e 73 20 .to.confirm."dangerous".actions.
8a60 73 75 63 68 20 61 73 20 3d 64 65 6c 65 74 65 2d 66 69 6c 65 3d 2c 20 69 74 20 69 73 20 62 65 74 such.as.=delete-file=,.it.is.bet
8a80 74 65 72 0a 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 62 79 ter.to.implement.confirmation.by
8aa0 20 61 64 64 69 6e 67 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 2d 63 6f 6e 66 69 72 6d 3d 20 66 75 .adding.the.=embark--confirm=.fu
8ac0 6e 63 74 69 6f 6e 20 74 6f 0a 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 6e 74 72 79 20 nction.to.the.appropriate.entry.
8ae0 6f 66 20 61 20 64 69 66 66 65 72 65 6e 74 20 68 6f 6f 6b 20 61 6c 69 73 74 2c 20 6e 61 6d 65 6c of.a.different.hook.alist,.namel
8b00 79 2c 0a 3d 65 6d 62 61 72 6b 2d 70 72 65 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2e 0a 0a 42 y,.=embark-pre-action-hooks=...B
8b20 65 73 69 64 65 73 20 3d 65 6d 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 3d 2c 20 45 6d 62 esides.=embark--allow-edit=,.Emb
8b40 61 72 6b 20 63 6f 6d 65 73 20 77 69 74 68 20 61 6e 6f 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 20 ark.comes.with.another.function.
8b60 74 68 61 74 20 69 73 0a 6f 66 20 67 65 6e 65 72 61 6c 20 75 74 69 6c 69 74 79 20 69 6e 20 61 63 that.is.of.general.utility.in.ac
8b80 74 69 6f 6e 20 73 65 74 75 70 20 68 6f 6f 6b 73 3a 20 3d 65 6d 62 61 72 6b 2d 2d 69 67 6e 6f 72 tion.setup.hooks:.=embark--ignor
8ba0 65 2d 74 61 72 67 65 74 3d 2e 20 55 73 65 0a 69 74 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 e-target=..Use.it.for.commands.t
8bc0 68 61 74 20 64 6f 20 70 72 6f 6d 70 74 20 79 6f 75 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 hat.do.prompt.you.in.the.minibuf
8be0 66 65 72 20 62 75 74 20 66 6f 72 20 77 68 69 63 68 0a 69 6e 73 65 72 74 69 6e 67 20 74 68 65 20 fer.but.for.which.inserting.the.
8c00 74 61 72 67 65 74 20 77 6f 75 6c 64 20 62 65 20 69 6e 61 70 70 72 6f 70 72 69 61 74 65 2e 20 54 target.would.be.inappropriate..T
8c20 68 69 73 20 69 73 20 6e 6f 74 20 61 20 63 6f 6d 6d 6f 6e 0a 73 69 74 75 61 74 69 6f 6e 20 62 75 his.is.not.a.common.situation.bu
8c40 74 20 64 6f 65 73 20 6f 63 63 61 73 69 6f 6e 61 6c 6c 79 20 61 72 69 73 65 2e 20 46 6f 72 20 65 t.does.occasionally.arise..For.e
8c60 78 61 6d 70 6c 65 20 69 74 20 69 73 20 75 73 65 64 20 62 79 0a 64 65 66 61 75 6c 74 20 66 6f 72 xample.it.is.used.by.default.for
8c80 20 3d 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 2d 6f 6e 2d 72 65 67 69 6f 6e 3d 3a 20 74 68 61 74 .=shell-command-on-region=:.that
8ca0 20 63 6f 6d 6d 61 6e 64 20 69 73 20 75 73 65 64 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 0a 66 6f .command.is.used.as.an.action.fo
8cc0 72 20 72 65 67 69 6f 6e 20 74 61 72 67 65 74 73 2c 20 61 6e 64 20 69 74 20 70 72 6f 6d 70 74 73 r.region.targets,.and.it.prompts
8ce0 20 79 6f 75 20 66 6f 72 20 61 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 3b 20 79 6f 75 0a 74 79 .you.for.a.shell.command;.you.ty
8d00 70 69 63 61 6c 6c 79 20 64 6f 20 2f 6e 6f 74 2f 20 77 61 6e 74 20 74 68 65 20 74 61 72 67 65 74 pically.do./not/.want.the.target
8d20 2c 20 74 68 61 74 20 69 73 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 72 65 ,.that.is.the.contents.of.the.re
8d40 67 69 6f 6e 2c 0a 74 6f 20 62 65 20 65 6e 74 65 72 65 64 20 61 74 20 74 68 61 74 20 70 72 6f 6d gion,.to.be.entered.at.that.prom
8d60 70 74 21 0a 0a 2a 2a 20 52 75 6e 6e 69 6e 67 20 68 6f 6f 6b 73 20 62 65 66 6f 72 65 2c 20 61 66 pt!..**.Running.hooks.before,.af
8d80 74 65 72 20 6f 72 20 61 72 6f 75 6e 64 20 61 6e 20 61 63 74 69 6f 6e 0a 0a 45 6d 62 61 72 6b 20 ter.or.around.an.action..Embark.
8da0 68 61 73 20 74 68 72 65 65 20 76 61 72 69 61 62 6c 65 73 2c 20 3d 65 6d 62 61 72 6b 2d 70 72 65 has.three.variables,.=embark-pre
8dc0 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2c 0a 3d 65 6d 62 61 72 6b 2d 70 6f 73 74 2d 61 63 74 -action-hooks=,.=embark-post-act
8de0 69 6f 6e 2d 68 6f 6f 6b 73 3d 20 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 61 72 6f 75 6e 64 2d 61 63 ion-hooks=.and.=embark-around-ac
8e00 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2c 20 77 68 69 63 68 20 61 72 65 0a 61 6c 69 73 74 73 20 61 73 tion-hooks=,.which.are.alists.as
8e20 73 6f 63 69 61 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 68 6f 6f 6b 73 20 74 68 61 74 sociating.commands.to.hooks.that
8e40 20 73 68 6f 75 6c 64 20 72 75 6e 20 62 65 66 6f 72 65 20 6f 72 20 61 66 74 65 72 0a 6f 72 20 61 .should.run.before.or.after.or.a
8e60 73 20 61 72 6f 75 6e 64 20 61 64 76 69 63 65 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 s.around.advice.for.the.command.
8e80 77 68 65 6e 20 75 73 65 64 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 2e 20 41 73 20 77 69 74 68 0a when.used.as.an.action..As.with.
8ea0 3d 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2c =embark-target-injection-hooks=,
8ec0 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 73 70 65 63 69 61 6c 20 6b 65 79 73 20 66 6f 72 20 .there.are.two.special.keys.for.
8ee0 74 68 65 0a 61 6c 69 73 74 73 3a 20 3d 74 3d 20 64 65 73 69 67 6e 61 74 65 73 20 74 68 65 20 64 the.alists:.=t=.designates.the.d
8f00 65 66 61 75 6c 74 20 68 6f 6f 6b 20 74 6f 20 72 75 6e 20 77 68 65 6e 20 6e 6f 20 73 70 65 63 69 efault.hook.to.run.when.no.speci
8f20 66 69 63 20 68 6f 6f 6b 20 69 73 0a 73 70 65 63 69 66 69 65 64 20 66 6f 72 20 61 20 63 6f 6d 6d fic.hook.is.specified.for.a.comm
8f40 61 6e 64 3b 20 61 6e 64 20 74 68 65 20 68 6f 6f 6b 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 and;.and.the.hook.associated.to.
8f60 3d 3a 61 6c 77 61 79 73 3d 20 72 75 6e 73 0a 72 65 67 61 72 64 6c 65 73 73 2e 0a 0a 54 68 65 20 =:always=.runs.regardless...The.
8f80 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 20 6f 66 20 74 68 6f 73 65 20 76 61 72 69 61 62 6c 65 default.values.of.those.variable
8fa0 73 20 61 72 65 20 66 61 69 72 6c 79 20 65 78 74 65 6e 73 69 76 65 2c 20 61 64 64 69 6e 67 0a 63 s.are.fairly.extensive,.adding.c
8fc0 72 65 61 74 75 72 65 20 63 6f 6d 66 6f 72 74 73 20 74 6f 20 6d 61 6b 65 20 72 75 6e 6e 69 6e 67 reature.comforts.to.make.running
8fe0 20 61 63 74 69 6f 6e 73 20 61 20 73 6d 6f 6f 74 68 20 65 78 70 65 72 69 65 6e 63 65 2e 20 45 6d .actions.a.smooth.experience..Em
9000 62 61 72 6b 0a 63 6f 6d 65 73 20 77 69 74 68 20 73 65 76 65 72 61 6c 20 66 75 6e 63 74 69 6f 6e bark.comes.with.several.function
9020 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 73 65 20 s.intended.to.be.added.to.these.
9040 68 6f 6f 6b 73 2c 20 61 6e 64 0a 75 73 65 64 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 hooks,.and.used.in.the.default.v
9060 61 6c 75 65 73 20 6f 66 20 3d 65 6d 62 61 72 6b 2d 70 72 65 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b alues.of.=embark-pre-action-hook
9080 73 3d 2c 0a 3d 65 6d 62 61 72 6b 2d 70 6f 73 74 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 20 61 s=,.=embark-post-action-hooks=.a
90a0 6e 64 20 3d 65 6d 62 61 72 6b 2d 61 72 6f 75 6e 64 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 2e nd.=embark-around-action-hooks=.
90c0 0a 0a 46 6f 72 20 70 72 65 2d 61 63 74 69 6f 6e 20 68 6f 6f 6b 73 3a 0a 0a 2d 20 3d 65 6d 62 61 ..For.pre-action.hooks:..-.=emba
90e0 72 6b 2d 2d 63 6f 6e 66 69 72 6d 3d 20 3a 3a 20 50 72 6f 6d 70 74 20 74 68 65 20 75 73 65 72 20 rk--confirm=.::.Prompt.the.user.
9100 66 6f 72 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 62 65 66 6f 72 65 20 65 78 65 63 75 74 69 6e for.confirmation.before.executin
9120 67 0a 20 20 74 68 65 20 61 63 74 69 6f 6e 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62 65 20 g...the.action..This.is.used.be.
9140 64 65 66 61 75 6c 74 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 64 65 65 6d 65 64 20 22 64 61 6e default.for.commands.deemed."dan
9160 67 65 72 6f 75 73 22 2c 0a 20 20 6f 72 2c 20 6d 6f 72 65 20 61 63 63 75 72 61 74 65 6c 79 2c 20 gerous",...or,.more.accurately,.
9180 68 61 72 64 20 74 6f 20 75 6e 64 6f 2c 20 73 75 63 68 20 61 73 20 3d 64 65 6c 65 74 65 2d 66 69 hard.to.undo,.such.as.=delete-fi
91a0 6c 65 3d 20 61 6e 64 0a 20 20 3d 6b 69 6c 6c 2d 62 75 66 66 65 72 3d 2e 0a 0a 2d 20 3d 65 6d 62 le=.and...=kill-buffer=...-.=emb
91c0 61 72 6b 2d 2d 75 6e 6d 61 72 6b 2d 74 61 72 67 65 74 3d 20 3a 3a 20 55 6e 6d 61 72 6b 20 74 68 ark--unmark-target=.::.Unmark.th
91e0 65 20 61 63 74 69 76 65 20 72 65 67 69 6f 6e 2e 20 55 73 65 20 74 68 69 73 20 66 6f 72 0a 20 20 e.active.region..Use.this.for...
9200 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 61 63 74 20 6f 6e 20 74 68 65 20 commands.you.want.to.act.on.the.
9220 72 65 67 69 6f 6e 20 63 6f 6e 74 65 6e 74 73 20 62 75 74 20 77 69 74 68 6f 75 74 20 74 68 65 0a region.contents.but.without.the.
9240 20 20 72 65 67 69 6f 6e 20 62 65 69 6e 67 20 61 63 74 69 76 65 2e 20 54 68 65 20 64 65 66 61 75 ..region.being.active..The.defau
9260 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 75 73 65 73 20 74 68 69 73 20 66 75 6e 63 74 lt.configuration.uses.this.funct
9280 69 6f 6e 20 61 73 0a 20 20 61 20 70 72 65 2d 61 63 74 69 6f 6e 20 68 6f 6f 6b 20 66 6f 72 20 3d ion.as...a.pre-action.hook.for.=
92a0 6f 63 63 75 72 3d 20 61 6e 64 20 3d 71 75 65 72 79 2d 72 65 70 6c 61 63 65 3d 2c 20 66 6f 72 20 occur=.and.=query-replace=,.for.
92c0 65 78 61 6d 70 6c 65 2c 20 73 6f 20 74 68 61 74 0a 20 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 example,.so.that...you.can.use.t
92e0 68 65 6d 20 61 73 20 61 63 74 69 6f 6e 73 20 77 69 74 68 20 72 65 67 69 6f 6e 20 74 61 72 67 65 hem.as.actions.with.region.targe
9300 74 73 20 74 6f 20 73 65 61 72 63 68 20 74 68 65 20 77 68 6f 6c 65 0a 20 20 62 75 66 66 65 72 20 ts.to.search.the.whole...buffer.
9320 66 6f 72 20 74 68 65 20 74 65 78 74 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 72 65 for.the.text.contained.in.the.re
9340 67 69 6f 6e 2e 20 57 69 74 68 6f 75 74 20 74 68 69 73 20 70 72 65 2d 61 63 74 69 6f 6e 0a 20 20 gion..Without.this.pre-action...
9360 68 6f 6f 6b 20 75 73 69 6e 67 20 3d 6f 63 63 75 72 3d 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 20 hook.using.=occur=.as.an.action.
9380 66 6f 72 20 61 20 72 65 67 69 6f 6e 20 74 61 72 67 65 74 20 77 6f 75 6c 64 20 62 65 0a 20 20 70 for.a.region.target.would.be...p
93a0 6f 69 6e 74 6c 65 73 73 3a 20 69 74 20 77 6f 75 6c 64 20 73 65 61 72 63 68 20 66 6f 72 20 74 68 ointless:.it.would.search.for.th
93c0 65 20 74 68 65 20 72 65 67 69 6f 6e 20 63 6f 6e 74 65 6e 74 73 20 2f 69 6e 20 74 68 65 0a 20 20 e.the.region.contents./in.the...
93e0 72 65 67 69 6f 6e 2f 2c 20 28 74 79 70 69 63 61 6c 6c 79 2c 20 64 75 65 20 74 6f 20 74 68 65 20 region/,.(typically,.due.to.the.
9400 64 65 74 61 69 6c 73 20 6f 66 20 72 65 67 65 78 70 73 29 20 66 69 6e 64 69 6e 67 20 6f 6e 6c 79 details.of.regexps).finding.only
9420 20 6f 6e 65 0a 20 20 6d 61 74 63 68 21 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 62 65 67 69 6e 6e .one...match!..-.=embark--beginn
9440 69 6e 67 2d 6f 66 2d 74 61 72 67 65 74 3d 20 3a 3a 20 4d 6f 76 65 20 74 6f 20 74 68 65 20 62 65 ing-of-target=.::.Move.to.the.be
9460 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 0a 20 20 28 66 6f 72 20 74 61 72 ginning.of.the.target...(for.tar
9480 67 65 74 73 20 74 68 61 74 20 72 65 70 6f 72 74 20 62 6f 75 6e 64 73 29 2e 20 54 68 69 73 20 69 gets.that.report.bounds)..This.i
94a0 73 20 75 73 65 64 20 62 79 20 64 65 66 61 75 6c 74 20 66 6f 72 0a 20 20 62 61 63 6b 77 61 72 64 s.used.by.default.for...backward
94c0 20 6d 6f 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 73 75 63 68 20 61 73 20 3d 62 61 63 6b 77 61 .motion.commands.such.as.=backwa
94e0 72 64 2d 73 65 78 70 3d 2c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 64 6f 6e 27 74 0a 20 20 61 rd-sexp=,.so.that.they.don't...a
9500 63 63 69 64 65 6e 74 61 6c 6c 79 20 6c 65 61 76 65 20 79 6f 75 20 6f 6e 20 74 68 65 20 63 75 72 ccidentally.leave.you.on.the.cur
9520 72 65 6e 74 20 74 61 72 67 65 74 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 65 6e 64 2d 6f 66 2d rent.target...-.=embark--end-of-
9540 74 61 72 67 65 74 3d 20 3a 3a 20 4d 6f 76 65 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 target=.::.Move.to.the.end.of.th
9560 65 20 74 61 72 67 65 74 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 0a 20 20 73 69 6d 69 6c 61 72 e.target..This.is.used...similar
9580 6c 79 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 66 75 6e 63 74 69 6f 6e 2c 20 62 75 74 ly.to.the.previous.function,.but
95a0 20 61 6c 73 6f 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 63 74 0a 20 20 6f 6e .also.for.commands.that.act...on
95c0 20 74 68 65 20 6c 61 73 74 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 6b 65 20 3d 65 76 61 .the.last.s-expression.like.=eva
95e0 6c 2d 6c 61 73 74 2d 73 65 78 70 3d 2e 20 54 68 69 73 20 61 6c 6c 6f 77 20 79 6f 75 20 74 6f 20 l-last-sexp=..This.allow.you.to.
9600 61 63 74 0a 20 20 6f 6e 20 61 6e 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 66 72 6f 6d 20 61 6e act...on.an.s-expression.from.an
9620 79 77 68 65 72 65 20 69 6e 73 69 64 65 20 69 74 20 61 6e 64 20 73 74 69 6c 6c 20 75 73 65 0a 20 ywhere.inside.it.and.still.use..
9640 20 3d 65 76 61 6c 2d 6c 61 73 74 2d 73 65 78 70 3d 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 2e 0a .=eval-last-sexp=.as.an.action..
9660 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 78 72 65 66 2d 70 75 73 68 2d 6d 61 72 6b 65 72 73 3d 20 3a .-.=embark--xref-push-markers=.:
9680 3a 20 50 75 73 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 6f 6e 20 74 :.Push.the.current.location.on.t
96a0 68 65 20 78 72 65 66 0a 20 20 6d 61 72 6b 65 72 20 73 74 61 63 6b 2e 20 55 73 65 20 74 68 69 73 he.xref...marker.stack..Use.this
96c0 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 74 61 6b 65 20 79 6f 75 20 73 6f 6d 65 .for.commands.that.take.you.some
96e0 77 68 65 72 65 20 61 6e 64 20 66 6f 72 0a 20 20 77 68 69 63 68 20 79 6f 75 27 64 20 6c 69 6b 65 where.and.for...which.you'd.like
9700 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 63 6f 6d 65 20 62 61 63 6b 20 74 6f 20 77 68 65 72 .to.be.able.to.come.back.to.wher
9720 65 20 79 6f 75 20 77 65 72 65 20 75 73 69 6e 67 0a 20 20 3d 78 72 65 66 2d 70 6f 70 2d 6d 61 72 e.you.were.using...=xref-pop-mar
9740 6b 65 72 2d 73 74 61 63 6b 3d 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62 79 20 64 65 66 61 ker-stack=..This.is.used.by.defa
9760 75 6c 74 20 66 6f 72 20 3d 66 69 6e 64 2d 6c 69 62 72 61 72 79 3d 2e 0a 0a 46 6f 72 20 70 6f 73 ult.for.=find-library=...For.pos
9780 74 2d 61 63 74 69 6f 6e 20 68 6f 6f 6b 73 3a 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 72 65 73 74 t-action.hooks:..-.=embark--rest
97a0 61 72 74 3d 20 3a 3a 20 52 65 73 74 61 72 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 63 75 72 72 art=.::.Restart.the.command.curr
97c0 65 6e 74 6c 79 20 70 72 6f 6d 70 74 69 6e 67 20 69 6e 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 ently.prompting.in.the...minibuf
97e0 66 65 72 2c 20 73 6f 20 74 68 61 74 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63 6f 6d 70 6c 65 74 fer,.so.that.the.list.of.complet
9800 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 69 73 20 75 70 64 61 74 65 64 2e 0a 20 20 54 68 69 ion.candidates.is.updated....Thi
9820 73 20 69 73 20 75 73 65 66 75 6c 20 61 73 20 61 20 70 6f 73 74 20 61 63 74 69 6f 6e 20 68 6f 6f s.is.useful.as.a.post.action.hoo
9840 6b 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 65 6c 65 74 65 20 6f 72 0a 20 20 k.for.commands.that.delete.or...
9860 72 65 6e 61 6d 65 20 61 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 3b 20 66 rename.a.completion.candidate;.f
9880 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 0a or.example.the.default.value.of.
98a0 20 20 3d 65 6d 62 61 72 6b 2d 70 6f 73 74 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 20 75 73 65 ..=embark-post-action-hooks=.use
98c0 73 20 69 74 20 66 6f 72 20 3d 64 65 6c 65 74 65 2d 66 69 6c 65 3d 2c 20 3d 6b 69 6c 6c 2d 62 75 s.it.for.=delete-file=,.=kill-bu
98e0 66 66 65 72 3d 2c 0a 20 20 3d 72 65 6e 61 6d 65 2d 66 69 6c 65 3d 2c 20 3d 72 65 6e 61 6d 65 2d ffer=,...=rename-file=,.=rename-
9900 62 75 66 66 65 72 3d 2c 20 65 74 63 2e 0a 0a 46 6f 72 20 61 72 6f 75 6e 64 2d 61 63 74 69 6f 6e buffer=,.etc...For.around-action
9920 20 68 6f 6f 6b 73 3a 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 6d 61 72 6b 2d 74 61 72 67 65 74 3d .hooks:..-.=embark--mark-target=
9940 20 3a 3a 20 53 61 76 65 20 65 78 69 73 74 69 6e 67 20 6d 61 72 6b 20 61 6e 64 20 70 6f 69 6e 74 .::.Save.existing.mark.and.point
9960 20 6c 6f 63 61 74 69 6f 6e 2c 20 6d 61 72 6b 0a 20 20 74 68 65 20 74 61 72 67 65 74 20 61 6e 64 .location,.mark...the.target.and
9980 20 72 75 6e 20 74 68 65 20 61 63 74 69 6f 6e 2e 20 4d 6f 73 74 20 74 61 72 67 65 74 73 20 61 74 .run.the.action..Most.targets.at
99a0 20 70 6f 69 6e 74 20 6f 75 74 73 69 64 65 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 .point.outside.the...minibuffer.
99c0 72 65 70 6f 72 74 20 77 68 69 63 68 20 72 65 67 69 6f 6e 20 6f 66 20 74 68 65 20 62 75 66 66 65 report.which.region.of.the.buffe
99e0 72 20 74 68 65 79 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 0a 20 20 28 74 68 69 73 20 69 73 20 r.they.correspond.to...(this.is.
9a00 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 62 79 20 3d 65 6d 62 61 72 6b 2d the.information.used.by.=embark-
9a20 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 3d 20 74 6f 0a 20 20 6b 6e 6f 77 20 77 highlight-indicator=.to...know.w
9a40 68 61 74 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 62 75 66 66 65 72 20 74 6f 20 68 69 67 hat.portion.of.the.buffer.to.hig
9a60 68 6c 69 67 68 74 29 3b 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 72 6b 73 0a 20 20 74 hlight);.this.function.marks...t
9a80 68 61 74 20 72 65 67 69 6f 6e 2e 20 49 74 20 69 73 20 75 73 65 66 75 6c 20 61 73 20 61 6e 20 61 hat.region..It.is.useful.as.an.a
9aa0 72 6f 75 6e 64 20 61 63 74 69 6f 6e 20 68 6f 6f 6b 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 round.action.hook.for.commands.t
9ac0 68 61 74 0a 20 20 65 78 70 65 63 74 20 61 20 72 65 67 69 6f 6e 20 74 6f 20 62 65 20 6d 61 72 6b hat...expect.a.region.to.be.mark
9ae0 65 64 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 74 20 69 73 20 75 73 65 64 20 62 79 20 64 ed,.for.example,.it.is.used.by.d
9b00 65 66 61 75 6c 74 20 66 6f 72 0a 20 20 3d 69 6e 64 65 6e 74 2d 72 65 67 69 6f 6e 3d 20 73 6f 20 efault.for...=indent-region=.so.
9b20 74 68 61 74 20 69 74 20 77 6f 72 6b 73 20 6f 6e 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 74 61 that.it.works.on.s-expression.ta
9b40 72 67 65 74 73 2c 20 6f 72 20 66 6f 72 0a 20 20 3d 66 69 6c 6c 2d 72 65 67 69 6f 6e 3d 20 73 6f rgets,.or.for...=fill-region=.so
9b60 20 74 68 61 74 20 69 74 20 77 6f 72 6b 73 20 6f 6e 20 70 61 72 61 67 72 61 70 68 20 74 61 72 67 .that.it.works.on.paragraph.targ
9b80 65 74 73 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 63 64 3d 20 3a 3a 20 52 75 6e 20 74 68 65 20 ets...-.=embark--cd=.::.Run.the.
9ba0 61 63 74 69 6f 6e 20 77 69 74 68 20 3d 64 65 66 61 75 6c 74 2d 64 69 72 65 63 74 6f 72 79 3d 20 action.with.=default-directory=.
9bc0 73 65 74 20 74 6f 20 74 68 65 0a 20 20 64 69 72 65 63 74 6f 72 79 20 61 73 73 6f 63 69 61 74 65 set.to.the...directory.associate
9be0 64 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 2e 20 54 68 65 20 74 61 72 d.to.the.current.target..The.tar
9c00 67 65 74 20 73 68 6f 75 6c 64 20 62 65 20 6f 66 0a 20 20 74 79 70 65 20 3d 66 69 6c 65 3d 2c 20 get.should.be.of...type.=file=,.
9c20 3d 62 75 66 66 65 72 3d 2c 20 3d 62 6f 6f 6b 6d 61 72 6b 3d 20 6f 72 20 3d 6c 69 62 72 61 72 79 =buffer=,.=bookmark=.or.=library
9c40 3d 2c 20 61 6e 64 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 64 69 72 65 63 74 6f 72 79 0a =,.and.the.associated.directory.
9c60 20 20 69 73 20 77 68 61 74 20 79 6f 75 27 64 20 65 78 70 65 63 74 20 69 6e 20 65 61 63 68 20 63 ..is.what.you'd.expect.in.each.c
9c80 61 73 65 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 6e 61 72 72 6f 77 2d 74 6f 2d 74 61 72 67 65 ase...-.=embark--narrow-to-targe
9ca0 74 3d 20 3a 3a 20 52 75 6e 20 74 68 65 20 61 63 74 69 6f 6e 20 77 69 74 68 20 62 75 66 66 65 72 t=.::.Run.the.action.with.buffer
9cc0 20 6e 61 72 72 6f 77 65 64 20 74 6f 0a 20 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 2e 20 55 .narrowed.to...current.target..U
9ce0 73 65 20 74 68 69 73 20 61 73 20 61 6e 20 61 72 6f 75 6e 64 20 68 6f 6f 6b 20 74 6f 20 6c 6f 63 se.this.as.an.around.hook.to.loc
9d00 61 6c 69 7a 65 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 0a 20 20 61 63 74 69 6f 6e 73 20 74 68 alize.the.effect.of...actions.th
9d20 61 74 20 64 6f 6e 27 74 20 61 6c 72 65 61 64 79 20 77 6f 72 6b 20 6f 6e 20 6a 75 73 74 20 74 68 at.don't.already.work.on.just.th
9d40 65 20 72 65 67 69 6f 6e 2e 20 49 6e 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 63 6f 6e 66 69 e.region..In.the.default...confi
9d60 67 75 72 61 74 69 6f 6e 20 69 74 20 69 73 20 75 73 65 64 20 66 6f 72 20 3d 72 65 70 75 6e 63 74 guration.it.is.used.for.=repunct
9d80 75 61 74 65 2d 73 65 6e 74 65 6e 63 65 73 3d 2e 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 2d 73 61 76 uate-sentences=...-.=embark--sav
9da0 65 2d 65 78 63 75 72 73 69 6f 6e 3d 20 3a 3a 20 52 75 6e 20 74 68 65 20 61 63 74 69 6f 6e 20 72 e-excursion=.::.Run.the.action.r
9dc0 65 73 74 6f 72 69 6e 67 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 65 6e 64 2e 0a 20 20 54 68 65 estoring.point.at.the.end....The
9de0 20 63 75 72 72 65 6e 74 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 .current.default.configuration.d
9e00 6f 65 73 6e 27 74 20 75 73 65 20 74 68 69 73 20 62 75 74 20 69 74 20 69 73 0a 20 20 61 76 61 69 oesn't.use.this.but.it.is...avai
9e20 6c 61 62 6c 65 20 66 6f 72 20 75 73 65 72 73 2e 0a 0a 2a 2a 20 43 72 65 61 74 69 6e 67 20 79 6f lable.for.users...**.Creating.yo
9e40 75 72 20 6f 77 6e 20 6b 65 79 6d 61 70 73 0a 0a 41 6c 6c 20 69 6e 74 65 72 6e 61 6c 20 6b 65 79 ur.own.keymaps..All.internal.key
9e60 6d 61 70 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 77 69 74 68 20 74 68 65 20 73 74 61 6e 64 61 maps.are.defined.with.the.standa
9e80 72 64 20 68 65 6c 70 65 72 20 6d 61 63 72 6f 0a 3d 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 3d 2e rd.helper.macro.=defvar-keymap=.
9ea0 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 61 20 73 69 6d 70 6c 65 20 76 65 72 73 69 6f 6e 20 6f 66 .For.example.a.simple.version.of
9ec0 20 74 68 65 20 66 69 6c 65 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 0a 63 6f 75 6c 64 20 62 65 .the.file.action.keymap.could.be
9ee0 20 64 65 66 69 6e 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 23 2b 42 45 47 49 4e 5f 53 52 .defined.as.follows:..#+BEGIN_SR
9f00 43 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 65 6d C.emacs-lisp...(defvar-keymap.em
9f20 62 61 72 6b 2d 66 69 6c 65 2d 6d 61 70 0a 20 20 20 20 3a 64 6f 63 20 22 45 78 61 6d 70 6c 65 20 bark-file-map.....:doc."Example.
9f40 6b 65 79 6d 61 70 20 77 69 74 68 20 61 20 66 65 77 20 66 69 6c 65 20 61 63 74 69 6f 6e 73 22 0a keymap.with.a.few.file.actions".
9f60 20 20 20 20 3a 70 61 72 65 6e 74 20 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 0a 20 ....:parent.embark-general-map..
9f80 20 20 20 22 64 22 20 23 27 64 65 6c 65 74 65 2d 66 69 6c 65 0a 20 20 20 20 22 72 22 20 23 27 72 ..."d".#'delete-file....."r".#'r
9fa0 65 6e 61 6d 65 2d 66 69 6c 65 0a 20 20 20 20 22 63 22 20 23 27 63 6f 70 79 2d 66 69 6c 65 29 0a ename-file....."c".#'copy-file).
9fc0 23 2b 45 4e 44 5f 53 52 43 0a 0a 54 68 65 73 65 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 20 #+END_SRC..These.action.keymaps.
9fe0 61 72 65 20 70 65 72 66 65 63 74 6c 79 20 6e 6f 72 6d 61 6c 20 45 6d 61 63 73 0a 6b 65 79 6d 61 are.perfectly.normal.Emacs.keyma
a000 70 73 2e 20 20 59 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 69 6e 68 65 72 69 74 20 66 72 6f ps...You.may.want.to.inherit.fro
a020 6d 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 3d 20 69 66 20 79 6f m.the.=embark-general-map=.if.yo
a040 75 0a 77 61 6e 74 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 45 6d 62 u.want.to.access.the.default.Emb
a060 61 72 6b 20 61 63 74 69 6f 6e 73 2e 20 4e 6f 74 65 20 74 68 61 74 20 3d 65 6d 62 61 72 6b 2d 63 ark.actions..Note.that.=embark-c
a080 6f 6c 6c 65 63 74 3d 0a 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 61 72 65 20 ollect=.and.=embark-export=.are.
a0a0 61 6c 73 6f 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65 20 76 69 61 20 3d 65 6d 62 61 72 6b 2d also.made.available.via.=embark-
a0c0 67 65 6e 65 72 61 6c 2d 6d 61 70 3d 2e 0a 0a 2a 2a 20 44 65 66 69 6e 69 6e 67 20 61 63 74 69 6f general-map=...**.Defining.actio
a0e0 6e 73 20 66 6f 72 20 6e 65 77 20 63 61 74 65 67 6f 72 69 65 73 20 6f 66 20 74 61 72 67 65 74 73 ns.for.new.categories.of.targets
a100 0a 0a 49 74 20 69 73 20 65 61 73 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 45 6d 62 61 72 6b ..It.is.easy.to.configure.Embark
a120 20 74 6f 20 70 72 6f 76 69 64 65 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 6e 65 77 20 74 79 70 65 .to.provide.actions.for.new.type
a140 73 20 6f 66 0a 74 61 72 67 65 74 73 2c 20 65 69 74 68 65 72 20 69 6e 20 74 68 65 20 6d 69 6e 69 s.of.targets,.either.in.the.mini
a160 62 75 66 66 65 72 20 6f 72 20 6f 75 74 73 69 64 65 20 69 74 2e 20 49 20 70 72 65 73 65 6e 74 20 buffer.or.outside.it..I.present.
a180 62 65 6c 6f 77 20 74 77 6f 0a 76 65 72 79 20 64 65 74 61 69 6c 65 64 20 65 78 61 6d 70 6c 65 73 below.two.very.detailed.examples
a1a0 20 6f 66 20 68 6f 77 20 74 6f 20 64 6f 20 74 68 69 73 2e 20 41 74 20 73 65 76 65 72 61 6c 20 70 .of.how.to.do.this..At.several.p
a1c0 6f 69 6e 74 73 20 49 27 6c 6c 0a 65 78 70 6c 61 69 6e 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 oints.I'll.explain.more.than.one
a1e0 20 77 61 79 20 74 6f 20 70 72 6f 63 65 65 64 2c 20 74 79 70 69 63 61 6c 6c 79 20 77 69 74 68 20 .way.to.proceed,.typically.with.
a200 74 68 65 20 65 61 73 69 65 73 74 0a 6f 70 74 69 6f 6e 20 66 69 72 73 74 2e 20 49 20 69 6e 63 6c the.easiest.option.first..I.incl
a220 75 64 65 20 74 68 65 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6f 70 74 69 6f 6e 73 20 73 69 6e 63 ude.the.alternative.options.sinc
a240 65 20 74 68 65 72 65 20 77 69 6c 6c 20 62 65 0a 73 69 6d 69 6c 61 72 20 73 69 74 75 61 74 69 6f e.there.will.be.similar.situatio
a260 6e 73 20 77 68 65 72 65 20 74 68 65 20 65 61 73 69 65 73 74 20 6f 70 74 69 6f 6e 20 69 73 20 6e ns.where.the.easiest.option.is.n
a280 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 0a 0a 2a 2a 2a 20 4e 65 77 20 6d 69 6e 69 62 75 66 66 65 ot.available...***.New.minibuffe
a2a0 72 20 74 61 72 67 65 74 20 65 78 61 6d 70 6c 65 20 2d 20 74 61 62 2d 62 61 72 20 74 61 62 73 0a r.target.example.-.tab-bar.tabs.
a2c0 0a 41 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 61 6b 65 20 74 68 65 20 6e 65 77 20 5b 5b 68 .As.an.example,.take.the.new.[[h
a2e0 74 74 70 73 3a 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 73 6f 66 74 77 61 72 65 2f 65 6d 61 63 ttps://www.gnu.org/software/emac
a300 73 2f 6d 61 6e 75 61 6c 2f 68 74 6d 6c 5f 6e 6f 64 65 2f 65 6d 61 63 73 2f 54 61 62 2d 42 61 72 s/manual/html_node/emacs/Tab-Bar
a320 73 2e 68 74 6d 6c 5d 5b 74 61 62 20 62 61 72 73 5d 5d 20 66 72 6f 6d 20 45 6d 61 63 73 20 32 37 s.html][tab.bars]].from.Emacs.27
a340 2e 20 49 27 6c 6c 20 65 78 70 6c 61 69 6e 20 68 6f 77 0a 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 ..I'll.explain.how.to.configure.
a360 45 6d 62 61 72 6b 20 74 6f 20 6f 66 66 65 72 20 74 61 62 2d 73 70 65 63 69 66 69 63 20 61 63 74 Embark.to.offer.tab-specific.act
a380 69 6f 6e 73 20 77 68 65 6e 20 79 6f 75 20 75 73 65 20 74 68 65 0a 74 61 62 2d 62 61 72 2d 6d 6f ions.when.you.use.the.tab-bar-mo
a3a0 64 65 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 6d 65 6e 74 69 6f 6e 20 74 61 62 73 20 62 79 de.commands.that.mention.tabs.by
a3c0 20 6e 61 6d 65 2e 20 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 65 78 70 6c 61 69 6e .name..The.configuration.explain
a3e0 65 64 20 68 65 72 65 20 69 73 20 6e 6f 77 20 62 75 69 6c 74 2d 69 6e 20 74 6f 20 45 6d 62 61 72 ed.here.is.now.built-in.to.Embar
a400 6b 20 28 61 6e 64 20 4d 61 72 67 69 6e 61 6c 69 61 29 2c 20 62 75 74 20 69 74 27 73 0a 73 74 69 k.(and.Marginalia),.but.it's.sti
a420 6c 6c 20 61 20 67 6f 6f 64 20 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 20 65 78 61 6d 70 6c 65 ll.a.good.self-contained.example
a440 2e 20 49 6e 20 6f 72 64 65 72 20 74 6f 20 73 65 74 75 70 20 75 70 20 74 61 62 20 61 63 74 69 6f ..In.order.to.setup.up.tab.actio
a460 6e 73 0a 79 6f 75 20 77 6f 75 6c 64 20 6e 65 65 64 20 74 6f 3a 20 28 31 29 20 6d 61 6b 65 20 73 ns.you.would.need.to:.(1).make.s
a480 75 72 65 20 45 6d 62 61 72 6b 20 6b 6e 6f 77 73 20 74 68 6f 73 65 20 63 6f 6d 6d 61 6e 64 73 20 ure.Embark.knows.those.commands.
a4a0 64 65 61 6c 20 77 69 74 68 0a 74 61 62 73 2c 20 28 32 29 20 64 65 66 69 6e 65 20 61 20 6b 65 79 deal.with.tabs,.(2).define.a.key
a4c0 6d 61 70 20 66 6f 72 20 74 61 62 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 map.for.tab.actions.and.configur
a4e0 65 20 45 6d 62 61 72 6b 20 73 6f 20 69 74 0a 6b 6e 6f 77 73 20 74 68 61 74 27 73 20 74 68 65 20 e.Embark.so.it.knows.that's.the.
a500 6b 65 79 6d 61 70 20 79 6f 75 20 77 61 6e 74 2e 0a 0a 2a 2a 2a 2a 20 54 65 6c 6c 69 6e 67 20 45 keymap.you.want...****.Telling.E
a520 6d 62 61 72 6b 20 61 62 6f 75 74 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 70 72 6f 6d 70 74 mbark.about.commands.that.prompt
a540 20 66 6f 72 20 74 61 62 73 20 62 79 20 6e 61 6d 65 0a 0a 46 6f 72 20 73 74 65 70 20 28 31 29 2c .for.tabs.by.name..For.step.(1),
a560 20 69 74 20 77 6f 75 6c 64 20 62 65 20 67 72 65 61 74 20 69 66 20 74 68 65 20 3d 74 61 62 2d 62 .it.would.be.great.if.the.=tab-b
a580 61 72 2d 6d 6f 64 65 3d 20 63 6f 6d 6d 61 6e 64 73 20 72 65 70 6f 72 74 65 64 0a 74 68 65 20 63 ar-mode=.commands.reported.the.c
a5a0 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 74 65 67 6f 72 79 20 3d 74 61 62 3d 20 77 68 65 6e 20 61 73 ompletion.category.=tab=.when.as
a5c0 6b 69 6e 67 20 79 6f 75 20 66 6f 72 20 61 20 74 61 62 20 77 69 74 68 0a 63 6f 6d 70 6c 65 74 69 king.you.for.a.tab.with.completi
a5e0 6f 6e 2e 20 28 41 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 on..(All.built-in.Emacs.commands
a600 20 74 68 61 74 20 70 72 6f 6d 70 74 20 66 6f 72 20 66 69 6c 65 20 6e 61 6d 65 73 2c 0a 66 6f 72 .that.prompt.for.file.names,.for
a620 20 65 78 61 6d 70 6c 65 2c 20 64 6f 20 68 61 76 65 20 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 .example,.do.have.metadata.indic
a640 61 74 69 6e 67 20 74 68 61 74 20 74 68 65 79 20 77 61 6e 74 20 61 20 3d 66 69 6c 65 3d 2e 29 20 ating.that.they.want.a.=file=.).
a660 54 68 65 79 0a 64 6f 20 6e 6f 74 2c 20 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 2c 20 61 6e 64 20 They.do.not,.unfortunately,.and.
a680 49 20 77 69 6c 6c 20 64 65 73 63 72 69 62 65 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 77 61 79 73 I.will.describe.a.couple.of.ways
a6a0 20 74 6f 20 64 65 61 6c 0a 77 69 74 68 20 74 68 69 73 2e 0a 0a 4d 61 79 62 65 20 74 68 65 20 65 .to.deal.with.this...Maybe.the.e
a6c0 61 73 69 65 73 74 20 74 68 69 6e 67 20 69 73 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 5b 5b 68 asiest.thing.is.to.configure.[[h
a6e0 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 6d 61 72 67 69 6e 61 6c ttps://github.com/minad/marginal
a700 69 61 5d 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 5d 20 74 6f 20 65 6e 68 61 6e 63 65 20 74 68 6f 73 ia][Marginalia]].to.enhance.thos
a720 65 0a 63 6f 6d 6d 61 6e 64 73 2e 20 41 6c 6c 20 6f 66 20 74 68 65 20 3d 74 61 62 2d 62 61 72 2d e.commands..All.of.the.=tab-bar-
a740 2a 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 3d 20 63 6f 6d 6d 61 6e 64 73 20 68 61 76 65 20 74 68 65 *-tab-by-name=.commands.have.the
a760 20 77 6f 72 64 73 0a 22 74 61 62 20 62 79 20 6e 61 6d 65 22 20 69 6e 20 74 68 65 20 6d 69 6e 69 .words."tab.by.name".in.the.mini
a780 62 75 66 66 65 72 20 70 72 6f 6d 70 74 2c 20 73 6f 20 79 6f 75 20 63 61 6e 20 75 73 65 3a 0a 0a buffer.prompt,.so.you.can.use:..
a7a0 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 61 64 64 2d 74 6f #+begin_src.emacs-lisp...(add-to
a7c0 2d 6c 69 73 74 20 27 6d 61 72 67 69 6e 61 6c 69 61 2d 70 72 6f 6d 70 74 2d 63 61 74 65 67 6f 72 -list.'marginalia-prompt-categor
a7e0 69 65 73 20 27 28 22 74 61 62 20 62 79 20 6e 61 6d 65 22 20 2e 20 74 61 62 29 29 0a 23 2b 65 6e ies.'("tab.by.name"...tab)).#+en
a800 64 5f 73 72 63 0a 0a 54 68 61 74 27 73 20 69 74 21 20 42 75 74 20 69 6e 20 63 61 73 65 20 79 6f d_src..That's.it!.But.in.case.yo
a820 75 20 61 72 65 20 65 76 65 72 20 69 6e 20 61 20 73 69 74 75 61 74 69 6f 6e 20 77 68 65 72 65 20 u.are.ever.in.a.situation.where.
a840 79 6f 75 20 64 6f 6e 27 74 0a 61 6c 72 65 61 64 79 20 68 61 76 65 20 63 6f 6d 6d 61 6e 64 73 20 you.don't.already.have.commands.
a860 74 68 61 74 20 70 72 6f 6d 70 74 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 74 73 20 79 6f 75 20 that.prompt.for.the.targets.you.
a880 77 61 6e 74 2c 20 49 27 6c 6c 0a 64 65 73 63 72 69 62 65 20 68 6f 77 20 77 72 69 74 69 6e 67 20 want,.I'll.describe.how.writing.
a8a0 79 6f 75 72 20 6f 77 6e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 70 70 72 6f 70 72 69 61 74 your.own.command.with.appropriat
a8c0 65 20 3d 63 61 74 65 67 6f 72 79 3d 0a 6d 65 74 61 64 61 74 61 20 6c 6f 6f 6b 73 3a 0a 0a 23 2b e.=category=.metadata.looks:..#+
a8e0 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 64 65 66 75 6e 20 6d 79 begin_src.emacs-lisp...(defun.my
a900 2d 73 65 6c 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 28 74 61 62 29 0a 20 20 20 20 28 69 -select-tab-by-name.(tab).....(i
a920 6e 74 65 72 61 63 74 69 76 65 0a 20 20 20 20 20 28 6c 69 73 74 0a 20 20 20 20 20 20 28 6c 65 74 nteractive......(list.......(let
a940 20 28 28 74 61 62 2d 6c 69 73 74 20 28 6f 72 20 28 6d 61 70 63 61 72 20 28 6c 61 6d 62 64 61 20 .((tab-list.(or.(mapcar.(lambda.
a960 28 74 61 62 29 20 28 63 64 72 20 28 61 73 73 71 20 27 6e 61 6d 65 20 74 61 62 29 29 29 0a 20 20 (tab).(cdr.(assq.'name.tab)))...
a980 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ................................
a9a0 28 74 61 62 2d 62 61 72 2d 74 61 62 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (tab-bar-tabs)).................
a9c0 20 20 20 20 20 20 20 20 20 20 28 75 73 65 72 2d 65 72 72 6f 72 20 22 4e 6f 20 74 61 62 73 20 66 ..........(user-error."No.tabs.f
a9e0 6f 75 6e 64 22 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 ound")))).........(completing-re
aa00 61 64 0a 20 20 20 20 20 20 20 20 20 22 54 61 62 73 3a 20 22 0a 20 20 20 20 20 20 20 20 20 28 6c ad.........."Tabs:."..........(l
aa20 61 6d 62 64 61 20 28 73 74 72 69 6e 67 20 70 72 65 64 69 63 61 74 65 20 61 63 74 69 6f 6e 29 0a ambda.(string.predicate.action).
aa40 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 65 71 20 61 63 74 69 6f 6e 20 27 6d 65 74 61 64 ...........(if.(eq.action.'metad
aa60 61 74 61 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 28 6d 65 74 61 64 61 74 61 20 28 ata)................'(metadata.(
aa80 63 61 74 65 67 6f 72 79 20 2e 20 74 61 62 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 category...tab))..............(c
aaa0 6f 6d 70 6c 65 74 65 2d 77 69 74 68 2d 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 omplete-with-action.............
aac0 20 20 61 63 74 69 6f 6e 20 74 61 62 2d 6c 69 73 74 20 73 74 72 69 6e 67 20 70 72 65 64 69 63 61 ..action.tab-list.string.predica
aae0 74 65 29 29 29 29 29 29 29 0a 20 20 20 20 28 74 61 62 2d 62 61 72 2d 73 65 6c 65 63 74 2d 74 61 te))))))).....(tab-bar-select-ta
ab00 62 2d 62 79 2d 6e 61 6d 65 20 74 61 62 29 29 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 41 73 20 79 6f b-by-name.tab)).#+end_src..As.yo
ab20 75 20 63 61 6e 20 73 65 65 2c 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 73 75 70 70 6f 72 74 20 u.can.see,.the.built-in.support.
ab40 66 6f 72 20 73 65 74 74 69 6e 67 20 74 68 65 20 63 61 74 65 67 6f 72 79 0a 6d 65 74 61 2d 64 61 for.setting.the.category.meta-da
ab60 74 75 6d 20 69 73 20 6e 6f 74 20 76 65 72 79 20 65 61 73 79 20 74 6f 20 75 73 65 20 6f 72 20 70 tum.is.not.very.easy.to.use.or.p
ab80 72 65 74 74 79 20 74 6f 20 6c 6f 6f 6b 20 61 74 2e 20 54 6f 20 68 65 6c 70 20 77 69 74 68 0a 74 retty.to.look.at..To.help.with.t
aba0 68 69 73 20 49 20 72 65 63 6f 6d 6d 65 6e 64 20 74 68 65 20 3d 63 6f 6e 73 75 6c 74 2d 2d 72 65 his.I.recommend.the.=consult--re
abc0 61 64 3d 20 66 75 6e 63 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 65 78 63 65 6c 6c 65 6e 74 0a ad=.function.from.the.excellent.
abe0 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 63 6f 6e 73 75 [[https://github.com/minad/consu
ac00 6c 74 2f 5d 5b 43 6f 6e 73 75 6c 74 5d 5d 20 70 61 63 6b 61 67 65 2e 20 57 69 74 68 20 74 68 61 lt/][Consult]].package..With.tha
ac20 74 20 66 75 6e 63 74 69 6f 6e 20 77 65 20 63 61 6e 20 72 65 77 72 69 74 65 20 74 68 65 20 63 6f t.function.we.can.rewrite.the.co
ac40 6d 6d 61 6e 64 20 61 73 0a 66 6f 6c 6c 6f 77 73 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 mmand.as.follows:..#+begin_src.e
ac60 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 64 65 66 75 6e 20 6d 79 2d 73 65 6c 65 63 74 2d 74 61 62 macs-lisp...(defun.my-select-tab
ac80 2d 62 79 2d 6e 61 6d 65 20 28 74 61 62 29 0a 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 0a -by-name.(tab).....(interactive.
aca0 20 20 20 20 20 28 6c 69 73 74 0a 20 20 20 20 20 20 28 6c 65 74 20 28 28 74 61 62 2d 6c 69 73 74 .....(list.......(let.((tab-list
acc0 20 28 6f 72 20 28 6d 61 70 63 61 72 20 28 6c 61 6d 62 64 61 20 28 74 61 62 29 20 28 63 64 72 20 .(or.(mapcar.(lambda.(tab).(cdr.
ace0 28 61 73 73 71 20 27 6e 61 6d 65 20 74 61 62 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (assq.'name.tab)))..............
ad00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 61 62 2d 62 61 72 2d 74 61 .....................(tab-bar-ta
ad20 62 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 bs))...........................(
ad40 75 73 65 72 2d 65 72 72 6f 72 20 22 4e 6f 20 74 61 62 73 20 66 6f 75 6e 64 22 29 29 29 29 0a 20 user-error."No.tabs.found"))))..
ad60 20 20 20 20 20 20 20 28 63 6f 6e 73 75 6c 74 2d 2d 72 65 61 64 20 74 61 62 2d 6c 69 73 74 0a 20 .......(consult--read.tab-list..
ad80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 70 72 6f 6d 70 74 20 22 54 ......................:prompt."T
ada0 61 62 73 3a 20 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 63 abs:."........................:c
adc0 61 74 65 67 6f 72 79 20 27 74 61 62 29 29 29 29 0a 20 20 20 20 28 74 61 62 2d 62 61 72 2d 73 65 ategory.'tab)))).....(tab-bar-se
ade0 6c 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 74 61 62 29 29 0a 23 2b 65 6e 64 5f 73 72 63 lect-tab-by-name.tab)).#+end_src
ae00 0a 0a 4d 75 63 68 20 6e 69 63 65 72 21 20 4e 6f 20 6d 61 74 74 65 72 20 68 6f 77 20 79 6f 75 20 ..Much.nicer!.No.matter.how.you.
ae20 64 65 66 69 6e 65 20 74 68 65 20 3d 6d 79 2d 73 65 6c 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d define.the.=my-select-tab-by-nam
ae40 65 3d 0a 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 20 66 69 72 73 74 20 61 70 70 72 6f 61 63 68 20 77 e=.command,.the.first.approach.w
ae60 69 74 68 20 4d 61 72 67 69 6e 61 6c 69 61 20 61 6e 64 20 70 72 6f 6d 70 74 20 64 65 74 65 63 74 ith.Marginalia.and.prompt.detect
ae80 69 6f 6e 20 68 61 73 0a 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 64 76 61 6e 74 61 67 65 73 ion.has.the.following.advantages
aea0 3a 20 79 6f 75 20 67 65 74 20 74 68 65 20 3d 74 61 62 3d 20 63 61 74 65 67 6f 72 79 20 66 6f 72 :.you.get.the.=tab=.category.for
aec0 20 61 6c 6c 20 74 68 65 0a 3d 74 61 62 2d 62 61 72 2d 2a 2d 62 61 72 2d 62 79 2d 6e 61 6d 65 3d .all.the.=tab-bar-*-bar-by-name=
aee0 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 6f 6e 63 65 2c 20 61 6c 73 6f 2c 20 79 6f 75 20 65 6e 68 .commands.at.once,.also,.you.enh
af00 61 6e 63 65 20 62 75 69 6c 74 2d 69 6e 0a 63 6f 6d 6d 61 6e 64 73 2c 20 69 6e 73 74 65 61 64 20 ance.built-in.commands,.instead.
af20 6f 66 20 64 65 66 69 6e 69 6e 67 20 6e 65 77 20 6f 6e 65 73 2e 0a 0a 2a 2a 2a 2a 20 44 65 66 69 of.defining.new.ones...****.Defi
af40 6e 69 6e 67 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 61 20 6b 65 79 6d 61 70 20 66 6f ning.and.configuring.a.keymap.fo
af60 72 20 74 61 62 20 61 63 74 69 6f 6e 73 0a 0a 20 4c 65 74 27 73 20 73 61 79 20 77 65 20 77 61 6e r.tab.actions...Let's.say.we.wan
af80 74 20 74 6f 20 6f 66 66 65 72 20 73 65 6c 65 63 74 2c 20 72 65 6e 61 6d 65 20 61 6e 64 20 63 6c t.to.offer.select,.rename.and.cl
afa0 6f 73 65 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 61 62 73 0a 20 28 69 6e 20 61 64 64 69 74 69 ose.actions.for.tabs..(in.additi
afc0 6f 6e 20 74 6f 20 45 6d 62 61 72 6b 20 67 65 6e 65 72 61 6c 20 61 63 74 69 6f 6e 73 2c 20 73 75 on.to.Embark.general.actions,.su
afe0 63 68 20 61 73 20 73 61 76 69 6e 67 20 74 68 65 20 74 61 62 20 6e 61 6d 65 20 74 6f 0a 20 74 68 ch.as.saving.the.tab.name.to..th
b000 65 20 6b 69 6c 6c 2d 72 69 6e 67 2c 20 77 68 69 63 68 20 79 6f 75 20 67 65 74 20 66 6f 72 20 66 e.kill-ring,.which.you.get.for.f
b020 72 65 65 29 2e 20 54 68 65 6e 20 74 68 69 73 20 77 69 6c 6c 20 64 6f 3a 0a 0a 20 23 2b 62 65 67 ree)..Then.this.will.do:...#+beg
b040 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 28 64 65 66 76 61 72 2d 6b 65 79 in_src.emacs-lisp....(defvar-key
b060 6d 61 70 20 65 6d 62 61 72 6b 2d 74 61 62 2d 61 63 74 69 6f 6e 73 0a 20 20 20 20 20 3a 64 6f 63 map.embark-tab-actions......:doc
b080 20 22 4b 65 79 6d 61 70 20 66 6f 72 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 61 62 2d 62 61 72 ."Keymap.for.actions.for.tab-bar
b0a0 20 74 61 62 73 20 28 77 68 65 6e 20 6d 65 6e 74 69 6f 6e 65 64 20 62 79 20 6e 61 6d 65 29 2e 22 .tabs.(when.mentioned.by.name)."
b0c0 0a 20 20 20 20 20 3a 70 61 72 65 6e 74 20 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 ......:parent.embark-general-map
b0e0 0a 20 20 20 20 20 22 73 22 20 23 27 74 61 62 2d 62 61 72 2d 73 65 6c 65 63 74 2d 74 61 62 2d 62 ......"s".#'tab-bar-select-tab-b
b100 79 2d 6e 61 6d 65 0a 20 20 20 20 20 22 72 22 20 23 27 74 61 62 2d 62 61 72 2d 72 65 6e 61 6d 65 y-name......"r".#'tab-bar-rename
b120 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 0a 20 20 20 20 20 22 6b 22 20 23 27 74 61 62 2d 62 61 72 2d -tab-by-name......"k".#'tab-bar-
b140 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 29 0a 0a 20 20 20 28 61 64 64 2d 74 6f 2d 6c close-tab-by-name).....(add-to-l
b160 69 73 74 20 27 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 61 6c 69 73 74 20 27 28 74 61 62 20 2e ist.'embark-keymap-alist.'(tab..
b180 20 65 6d 62 61 72 6b 2d 74 61 62 2d 61 63 74 69 6f 6e 73 29 29 0a 20 23 2b 65 6e 64 5f 73 72 63 .embark-tab-actions))..#+end_src
b1a0 0a 0a 20 57 68 61 74 20 69 66 20 61 66 74 65 72 20 75 73 69 6e 67 20 74 68 69 73 20 66 6f 72 20 ...What.if.after.using.this.for.
b1c0 61 20 77 68 69 6c 65 20 79 6f 75 20 66 65 65 6c 20 63 6c 6f 73 69 6e 67 20 74 68 65 20 74 61 62 a.while.you.feel.closing.the.tab
b1e0 0a 20 77 69 74 68 6f 75 74 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 69 73 20 64 61 6e 67 65 72 ..without.confirmation.is.danger
b200 6f 75 73 3f 20 59 6f 75 20 68 61 76 65 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 6f 70 74 69 6f 6e ous?.You.have.a.couple.of.option
b220 73 3a 0a 0a 20 31 2e 20 59 6f 75 20 63 61 6e 20 6b 65 65 70 20 75 73 69 6e 67 20 74 68 65 20 3d s:...1..You.can.keep.using.the.=
b240 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 3d 20 63 6f 6d 6d 61 tab-bar-close-tab-by-name=.comma
b260 6e 64 2c 20 62 75 74 20 68 61 76 65 0a 20 20 20 20 45 6d 62 61 72 6b 20 61 73 6b 20 79 6f 75 20 nd,.but.have.....Embark.ask.you.
b280 66 6f 72 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 3a 0a 20 20 20 20 23 2b 62 65 67 69 6e 5f 73 72 for.confirmation:.....#+begin_sr
b2a0 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 20 20 28 70 75 73 68 20 23 27 65 6d 62 61 72 c.emacs-lisp.......(push.#'embar
b2c0 6b 2d 2d 63 6f 6e 66 69 72 6d 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d 67 65 k--confirm.............(alist-ge
b2e0 74 20 27 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 0a 20 20 20 t.'tab-bar-close-tab-by-name....
b300 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 6d 62 61 72 6b 2d 70 72 65 2d 61 ....................embark-pre-a
b320 63 74 69 6f 6e 2d 68 6f 6f 6b 73 29 29 0a 20 20 20 20 23 2b 65 6e 64 5f 73 72 63 0a 0a 20 32 2e ction-hooks)).....#+end_src...2.
b340 20 59 6f 75 20 63 61 6e 20 77 72 69 74 65 20 79 6f 75 72 20 6f 77 6e 20 63 6f 6d 6d 61 6e 64 20 .You.can.write.your.own.command.
b360 74 68 61 74 20 70 72 6f 6d 70 74 73 20 66 6f 72 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 61 6e that.prompts.for.confirmation.an
b380 64 0a 20 20 20 20 75 73 65 20 74 68 61 74 20 69 6e 73 74 65 61 64 20 6f 66 20 3d 74 61 62 2d 62 d.....use.that.instead.of.=tab-b
b3a0 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 3d 20 69 6e 20 74 68 65 20 61 62 6f ar-close-tab-by-name=.in.the.abo
b3c0 76 65 20 6b 65 79 6d 61 70 3a 0a 20 20 20 20 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 ve.keymap:.....#+begin_src.emacs
b3e0 2d 6c 69 73 70 0a 20 20 20 20 20 20 28 64 65 66 75 6e 20 6d 79 2d 63 6f 6e 66 69 72 6d 2d 63 6c -lisp.......(defun.my-confirm-cl
b400 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 28 74 61 62 29 0a 20 20 20 20 20 20 20 20 28 69 ose-tab-by-name.(tab).........(i
b420 6e 74 65 72 61 63 74 69 76 65 20 22 73 54 61 62 20 74 6f 20 63 6c 6f 73 65 3a 20 22 29 0a 20 20 nteractive."sTab.to.close:.")...
b440 20 20 20 20 20 20 28 77 68 65 6e 20 28 79 2d 6f 72 2d 6e 2d 70 20 28 66 6f 72 6d 61 74 20 22 43 ......(when.(y-or-n-p.(format."C
b460 6c 6f 73 65 20 74 61 62 20 27 25 73 27 3f 20 22 20 74 61 62 29 29 0a 20 20 20 20 20 20 20 20 20 lose.tab.'%s'?.".tab))..........
b480 20 28 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 74 61 62 29 .(tab-bar-close-tab-by-name.tab)
b4a0 29 29 0a 20 20 20 20 23 2b 65 6e 64 5f 73 72 63 0a 0a 20 20 20 20 4e 6f 74 69 63 65 20 74 68 61 )).....#+end_src......Notice.tha
b4c0 74 20 74 68 69 73 20 69 73 20 61 20 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f t.this.is.a.command.you.can.also
b4e0 20 75 73 65 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 3d 4d 2d 78 3d 0a 20 20 20 20 69 6e 64 .use.directly.from.=M-x=.....ind
b500 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 45 6d 62 61 72 6b 2e 20 55 73 69 6e 67 20 69 74 20 66 ependently.of.Embark..Using.it.f
b520 72 6f 6d 20 3d 4d 2d 78 3d 20 6c 65 61 76 65 73 20 73 6f 6d 65 74 68 69 6e 67 20 74 6f 20 62 65 rom.=M-x=.leaves.something.to.be
b540 0a 20 20 20 20 64 65 73 69 72 65 64 2c 20 74 68 6f 75 67 68 2c 20 73 69 6e 63 65 20 79 6f 75 20 .....desired,.though,.since.you.
b560 64 6f 6e 27 74 20 67 65 74 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 74 61 62 don't.get.completion.for.the.tab
b580 20 6e 61 6d 65 73 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e 20 66 69 78 20 74 68 69 73 20 69 66 20 .names......You.can.fix.this.if.
b5a0 79 6f 75 20 77 69 73 68 20 61 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 70 72 65 you.wish.as.described.in.the.pre
b5c0 76 69 6f 75 73 20 73 65 63 74 69 6f 6e 2e 0a 0a 2a 2a 2a 20 4e 65 77 20 74 61 72 67 65 74 20 65 vious.section...***.New.target.e
b5e0 78 61 6d 70 6c 65 20 69 6e 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 73 20 2d 20 73 68 6f 72 xample.in.regular.buffers.-.shor
b600 74 20 57 69 6b 69 70 65 64 69 61 20 6c 69 6e 6b 73 0a 0a 53 61 79 20 79 6f 75 20 77 61 6e 74 20 t.Wikipedia.links..Say.you.want.
b620 74 6f 20 74 65 61 63 68 20 45 6d 62 61 72 6b 20 74 6f 20 74 72 65 61 74 20 74 65 78 74 20 6f 66 to.teach.Embark.to.treat.text.of
b640 20 74 68 65 20 66 6f 72 6d 0a 3d 77 69 6b 69 70 65 64 69 61 3a 47 61 72 72 79 5f 4b 61 73 70 61 .the.form.=wikipedia:Garry_Kaspa
b660 72 6f 76 3d 20 69 6e 20 61 6e 79 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 20 61 73 20 61 20 rov=.in.any.regular.buffer.as.a.
b680 6c 69 6e 6b 20 74 6f 20 57 69 6b 69 70 65 64 69 61 2c 0a 77 69 74 68 20 61 63 74 69 6f 6e 73 20 link.to.Wikipedia,.with.actions.
b6a0 74 6f 20 6f 70 65 6e 20 74 68 65 20 57 69 6b 69 70 65 64 69 61 20 70 61 67 65 20 69 6e 20 65 77 to.open.the.Wikipedia.page.in.ew
b6c0 77 20 6f 72 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 62 72 6f 77 73 65 72 0a 6f 72 20 74 6f 20 73 w.or.an.external.browser.or.to.s
b6e0 61 76 65 20 74 68 65 20 55 52 4c 20 6f 66 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 65 20 6b ave.the.URL.of.the.page.in.the.k
b700 69 6c 6c 2d 72 69 6e 67 2e 20 57 65 20 63 61 6e 20 74 61 6b 65 20 61 64 76 61 6e 74 61 67 65 0a ill-ring..We.can.take.advantage.
b720 6f 66 20 74 68 65 20 61 63 74 69 6f 6e 73 20 74 68 61 74 20 45 6d 62 61 72 6b 20 68 61 73 20 70 of.the.actions.that.Embark.has.p
b740 72 65 63 6f 6e 66 69 67 75 72 65 64 20 66 6f 72 20 55 52 4c 73 2c 20 73 6f 20 61 6c 6c 20 77 65 reconfigured.for.URLs,.so.all.we
b760 20 6e 65 65 64 0a 74 6f 20 64 6f 20 69 73 20 74 65 61 63 68 20 45 6d 62 61 72 6b 20 74 68 61 74 .need.to.do.is.teach.Embark.that
b780 20 3d 77 69 6b 69 70 65 64 69 61 3a 47 61 72 72 79 5f 4b 61 73 70 61 72 6f 76 3d 20 73 74 61 6e .=wikipedia:Garry_Kasparov=.stan
b7a0 64 73 20 66 6f 72 20 74 68 65 20 55 52 4c 0a 3d 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 ds.for.the.URL.=https://en.wikip
b7c0 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 47 61 72 72 79 5f 4b 61 73 70 61 72 6f 76 3d 2e 0a 0a edia.org/wiki/Garry_Kasparov=...
b7e0 59 6f 75 20 63 61 6e 20 62 65 20 61 73 20 66 61 6e 63 79 20 61 73 20 79 6f 75 20 77 61 6e 74 20 You.can.be.as.fancy.as.you.want.
b800 77 69 74 68 20 74 68 65 20 72 65 63 6f 67 6e 69 7a 65 64 20 73 79 6e 74 61 78 2e 20 48 65 72 65 with.the.recognized.syntax..Here
b820 2c 20 74 6f 0a 6b 65 65 70 20 74 68 65 20 65 78 61 6d 70 6c 65 20 73 69 6d 70 6c 65 2c 20 49 27 ,.to.keep.the.example.simple,.I'
b840 6c 6c 20 61 73 73 75 6d 65 20 74 68 65 20 6c 69 6e 6b 20 6d 61 74 63 68 65 73 20 74 68 65 20 72 ll.assume.the.link.matches.the.r
b860 65 67 65 78 70 0a 3d 77 69 6b 69 70 65 64 69 61 3a 5b 5b 3a 61 6c 6e 75 6d 3a 5d 5f 5d 2b 3d 2e egexp.=wikipedia:[[:alnum:]_]+=.
b880 20 57 65 20 77 69 6c 6c 20 77 72 69 74 65 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 6c .We.will.write.a.function.that.l
b8a0 6f 6f 6b 73 20 66 6f 72 20 61 0a 6d 61 74 63 68 20 73 75 72 72 6f 75 6e 64 69 6e 67 20 70 6f 69 ooks.for.a.match.surrounding.poi
b8c0 6e 74 2c 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 20 64 6f 74 74 65 64 20 6c 69 73 74 20 6f 66 nt,.and.returns.a.dotted.list.of
b8e0 20 74 68 65 20 66 6f 72 6d 20 3d 27 28 75 72 6c 0a 55 52 4c 2d 4f 46 2d 54 48 45 2d 50 41 47 45 .the.form.='(url.URL-OF-THE-PAGE
b900 20 53 54 41 52 54 20 2e 20 45 4e 44 29 3d 20 77 68 65 72 65 20 3d 53 54 41 52 54 3d 20 61 6e 64 .START...END)=.where.=START=.and
b920 20 3d 45 4e 44 3d 20 61 72 65 20 74 68 65 20 62 75 66 66 65 72 0a 70 6f 73 69 74 69 6f 6e 73 20 .=END=.are.the.buffer.positions.
b940 62 6f 75 6e 64 69 6e 67 20 74 68 65 20 74 61 72 67 65 74 2c 20 61 6e 64 20 61 72 65 20 75 73 65 bounding.the.target,.and.are.use
b960 64 20 62 79 20 45 6d 62 61 72 6b 20 74 6f 20 68 69 67 68 6c 69 67 68 74 20 69 74 0a 69 66 20 79 d.by.Embark.to.highlight.it.if.y
b980 6f 75 20 68 61 76 65 20 3d 65 6d 62 61 72 6b 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 ou.have.=embark-highlight-indica
b9a0 74 6f 72 3d 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 6c 69 73 74 0a 3d 65 6d 62 61 72 tor=.included.in.the.list.=embar
b9c0 6b 2d 69 6e 64 69 63 61 74 6f 72 73 3d 2e 20 28 54 68 65 72 65 20 61 72 65 20 61 20 63 6f 75 70 k-indicators=..(There.are.a.coup
b9e0 6c 65 20 6f 66 20 6f 74 68 65 72 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 72 65 74 75 le.of.other.options.for.the.retu
ba00 72 6e 0a 76 61 6c 75 65 20 6f 66 20 61 20 74 61 72 67 65 74 20 66 69 6e 64 65 72 3a 20 74 68 65 rn.value.of.a.target.finder:.the
ba20 20 62 6f 75 6e 64 69 6e 67 20 70 6f 73 69 74 69 6f 6e 73 20 61 72 65 20 6f 70 74 69 6f 6e 61 6c .bounding.positions.are.optional
ba40 20 61 6e 64 20 61 0a 73 69 6e 67 6c 65 20 74 61 72 67 65 74 20 66 69 6e 64 65 72 20 69 73 20 61 .and.a.single.target.finder.is.a
ba60 6c 6c 6f 77 65 64 20 74 6f 20 72 65 74 75 72 6e 20 6d 75 6c 74 69 70 6c 65 20 74 61 72 67 65 74 llowed.to.return.multiple.target
ba80 73 3b 20 73 65 65 20 74 68 65 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 3d 65 6d s;.see.the.documentation.for.=em
baa0 62 61 72 6b 2d 74 61 72 67 65 74 2d 66 69 6e 64 65 72 73 3d 20 66 6f 72 20 64 65 74 61 69 6c 73 bark-target-finders=.for.details
bac0 2e 29 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 64 65 .)..#+begin_src.emacs-lisp...(de
bae0 66 75 6e 20 6d 79 2d 73 68 6f 72 74 2d 77 69 6b 69 70 65 64 69 61 2d 6c 69 6e 6b 20 28 29 0a 20 fun.my-short-wikipedia-link.()..
bb00 20 20 20 22 54 61 72 67 65 74 20 61 20 6c 69 6e 6b 20 61 74 20 70 6f 69 6e 74 20 6f 66 20 74 68 ..."Target.a.link.at.point.of.th
bb20 65 20 66 6f 72 6d 20 77 69 6b 69 70 65 64 69 61 3a 50 61 67 65 5f 4e 61 6d 65 2e 22 0a 20 20 20 e.form.wikipedia:Page_Name."....
bb40 20 28 73 61 76 65 2d 65 78 63 75 72 73 69 6f 6e 0a 20 20 20 20 20 20 28 6c 65 74 2a 20 28 28 73 .(save-excursion.......(let*.((s
bb60 74 61 72 74 20 28 70 72 6f 67 6e 20 28 73 6b 69 70 2d 63 68 61 72 73 2d 62 61 63 6b 77 61 72 64 tart.(progn.(skip-chars-backward
bb80 20 22 5b 3a 61 6c 6e 75 6d 3a 5d 5f 3a 22 29 20 28 70 6f 69 6e 74 29 29 29 0a 20 20 20 20 20 20 ."[:alnum:]_:").(point))).......
bba0 20 20 20 20 20 20 20 28 65 6e 64 20 28 70 72 6f 67 6e 20 28 73 6b 69 70 2d 63 68 61 72 73 2d 66 .......(end.(progn.(skip-chars-f
bbc0 6f 72 77 61 72 64 20 22 5b 3a 61 6c 6e 75 6d 3a 5d 5f 3a 22 29 20 28 70 6f 69 6e 74 29 29 29 0a orward."[:alnum:]_:").(point))).
bbe0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 74 72 20 28 62 75 66 66 65 72 2d 73 75 62 73 74 72 .............(str.(buffer-substr
bc00 69 6e 67 2d 6e 6f 2d 70 72 6f 70 65 72 74 69 65 73 20 73 74 61 72 74 20 65 6e 64 29 29 29 0a 20 ing-no-properties.start.end)))..
bc20 20 20 20 20 20 20 20 28 73 61 76 65 2d 6d 61 74 63 68 2d 64 61 74 61 0a 20 20 20 20 20 20 20 20 .......(save-match-data.........
bc40 20 20 28 77 68 65 6e 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 77 69 6b 69 70 65 64 69 61 ..(when.(string-match."wikipedia
bc60 3a 5c 5c 28 5b 5b 3a 61 6c 6e 75 6d 3a 5d 5f 5d 2b 5c 5c 29 22 20 73 74 72 29 0a 20 20 20 20 20 :\\([[:alnum:]_]+\\)".str)......
bc80 20 20 20 20 20 20 20 60 28 75 72 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2c 28 66 6f 72 .......`(url...............,(for
bca0 6d 61 74 20 22 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 mat."https://en.wikipedia.org/wi
bcc0 6b 69 2f 25 73 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d ki/%s"........................(m
bce0 61 74 63 68 2d 73 74 72 69 6e 67 20 31 20 73 74 72 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 atch-string.1.str)).............
bd00 20 20 2c 73 74 61 72 74 20 2e 20 2c 65 6e 64 29 29 29 29 29 29 0a 0a 20 20 28 61 64 64 2d 74 6f ..,start...,end))))))....(add-to
bd20 2d 6c 69 73 74 20 27 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 66 69 6e 64 65 72 73 20 27 6d 79 -list.'embark-target-finders.'my
bd40 2d 73 68 6f 72 74 2d 77 69 6b 69 70 65 64 69 61 2d 6c 69 6e 6b 29 0a 23 2b 65 6e 64 5f 73 72 63 -short-wikipedia-link).#+end_src
bd60 0a 0a 2a 20 48 6f 77 20 64 6f 65 73 20 45 6d 62 61 72 6b 20 63 61 6c 6c 20 74 68 65 20 61 63 74 ..*.How.does.Embark.call.the.act
bd80 69 6f 6e 73 3f 0a 0a 20 20 45 6d 62 61 72 6b 20 61 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f 72 6d ions?....Embark.actions.are.norm
bda0 61 6c 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 61 74 20 69 73 2c 20 66 75 6e 63 al.Emacs.commands,.that.is,.func
bdc0 74 69 6f 6e 73 20 77 69 74 68 20 61 6e 0a 20 20 69 6e 74 65 72 61 63 74 69 76 65 20 73 70 65 63 tions.with.an...interactive.spec
bde0 69 66 69 63 61 74 69 6f 6e 2e 20 49 6e 20 6f 72 64 65 72 20 74 6f 20 65 78 65 63 75 74 65 20 61 ification..In.order.to.execute.a
be00 6e 20 61 63 74 69 6f 6e 2c 20 45 6d 62 61 72 6b 0a 20 20 63 61 6c 6c 73 20 74 68 65 20 63 6f 6d n.action,.Embark...calls.the.com
be20 6d 61 6e 64 20 77 69 74 68 20 3d 63 61 6c 6c 2d 69 6e 74 65 72 61 63 74 69 76 65 6c 79 3d 2c 20 mand.with.=call-interactively=,.
be40 73 6f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 72 65 61 64 73 20 75 73 65 72 0a 20 20 69 6e 70 75 so.the.command.reads.user...inpu
be60 74 20 65 78 61 63 74 6c 79 20 61 73 20 69 66 20 72 75 6e 20 64 69 72 65 63 74 6c 79 20 62 79 20 t.exactly.as.if.run.directly.by.
be80 74 68 65 20 75 73 65 72 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65 0a 20 20 63 6f 6d 6d the.user..For.example.the...comm
bea0 61 6e 64 20 6d 61 79 20 6f 70 65 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 61 6e 64 20 72 65 and.may.open.a.minibuffer.and.re
bec0 61 64 20 61 20 73 74 72 69 6e 67 0a 20 20 28 3d 72 65 61 64 2d 66 72 6f 6d 2d 6d 69 6e 69 62 75 ad.a.string...(=read-from-minibu
bee0 66 66 65 72 3d 29 20 6f 72 20 6f 70 65 6e 20 61 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 69 6e 74 65 ffer=).or.open.a.completion.inte
bf00 72 66 61 63 65 0a 20 20 28 3d 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 3d 29 2e 20 49 66 20 rface...(=completing-read=)..If.
bf20 74 68 69 73 20 68 61 70 70 65 6e 73 2c 20 45 6d 62 61 72 6b 20 74 61 6b 65 73 20 74 68 65 20 74 this.happens,.Embark.takes.the.t
bf40 61 72 67 65 74 20 73 74 72 69 6e 67 0a 20 20 61 6e 64 20 69 6e 73 65 72 74 73 20 69 74 20 61 75 arget.string...and.inserts.it.au
bf60 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 74 6f 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c tomatically.into.the.minibuffer,
bf80 20 73 69 6d 75 6c 61 74 69 6e 67 20 75 73 65 72 0a 20 20 69 6e 70 75 74 20 74 68 69 73 20 77 61 .simulating.user...input.this.wa
bfa0 79 2e 20 41 66 74 65 72 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 20 73 74 72 69 6e 67 2c 20 45 y..After.inserting.the.string,.E
bfc0 6d 62 61 72 6b 20 65 78 69 74 73 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 73 75 mbark.exits.the...minibuffer,.su
bfe0 62 6d 69 74 74 69 6e 67 20 74 68 65 20 69 6e 70 75 74 2e 20 28 54 68 65 20 69 6d 6d 65 64 69 61 bmitting.the.input..(The.immedia
c000 74 65 20 6d 69 6e 69 62 75 66 66 65 72 20 65 78 69 74 20 63 61 6e 0a 20 20 62 65 20 64 69 73 61 te.minibuffer.exit.can...be.disa
c020 62 6c 65 64 20 66 6f 72 20 73 70 65 63 69 66 69 63 20 61 63 74 69 6f 6e 73 20 69 6e 20 6f 72 64 bled.for.specific.actions.in.ord
c040 65 72 20 74 6f 20 61 6c 6c 6f 77 20 65 64 69 74 69 6e 67 20 74 68 65 0a 20 20 69 6e 70 75 74 3b er.to.allow.editing.the...input;
c060 20 74 68 69 73 20 69 73 20 64 6f 6e 65 20 62 79 20 61 64 64 69 6e 67 20 74 68 65 20 3d 65 6d 62 .this.is.done.by.adding.the.=emb
c080 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 3d 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68 65 ark--allow-edit=.function.to.the
c0a0 0a 20 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 6e 74 72 79 20 6f 66 20 3d 65 6d 62 61 72 6b 2d ...appropriate.entry.of.=embark-
c0c0 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 3d 29 2e 20 45 6d 62 61 72 6b target-injection-hooks=)..Embark
c0e0 20 69 6e 73 65 72 74 73 0a 20 20 74 68 65 20 74 61 72 67 65 74 20 73 74 72 69 6e 67 20 61 74 20 .inserts...the.target.string.at.
c100 74 68 65 20 66 69 72 73 74 20 6d 69 6e 69 62 75 66 66 65 72 20 6f 70 65 6e 65 64 20 62 79 20 74 the.first.minibuffer.opened.by.t
c120 68 65 20 61 63 74 69 6f 6e 0a 20 20 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 69 66 20 74 68 65 20 he.action...command,.and.if.the.
c140 63 6f 6d 6d 61 6e 64 20 68 61 70 70 65 6e 73 20 74 6f 20 70 72 6f 6d 70 74 20 74 68 65 20 75 73 command.happens.to.prompt.the.us
c160 65 72 20 66 6f 72 20 69 6e 70 75 74 0a 20 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63 65 2c 20 74 er.for.input...more.than.once,.t
c180 68 65 20 75 73 65 72 20 73 74 69 6c 6c 20 69 6e 74 65 72 61 63 74 73 20 77 69 74 68 20 74 68 65 he.user.still.interacts.with.the
c1a0 20 73 65 63 6f 6e 64 20 61 6e 64 20 66 75 72 74 68 65 72 0a 20 20 70 72 6f 6d 70 74 73 20 69 6e .second.and.further...prompts.in
c1c0 20 74 68 65 20 6e 6f 72 6d 61 6c 20 66 61 73 68 69 6f 6e 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 .the.normal.fashion..Note.that.i
c1e0 66 20 61 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73 20 6e 6f 74 0a 20 20 70 72 6f 6d 70 74 20 74 68 f.a.command.does.not...prompt.th
c200 65 20 75 73 65 72 20 66 6f 72 20 69 6e 70 75 74 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 e.user.for.input.in.the.minibuff
c220 65 72 2c 20 45 6d 62 61 72 6b 20 73 74 69 6c 6c 20 61 6c 6c 6f 77 73 20 79 6f 75 0a 20 20 74 6f er,.Embark.still.allows.you...to
c240 20 75 73 65 20 69 74 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 2c 20 62 75 74 20 6f 66 20 63 6f 75 .use.it.as.an.action,.but.of.cou
c260 72 73 65 2c 20 6e 65 76 65 72 20 69 6e 73 65 72 74 73 20 74 68 65 20 74 61 72 67 65 74 0a 20 20 rse,.never.inserts.the.target...
c280 61 6e 79 77 68 65 72 65 2e 20 28 54 68 65 72 65 20 61 72 65 20 70 6c 65 6e 74 79 20 6f 66 20 65 anywhere..(There.are.plenty.of.e
c2a0 78 61 6d 70 6c 65 73 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 xamples.in.the.default.configura
c2c0 74 69 6f 6e 0a 20 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 70 tion...of.commands.that.do.not.p
c2e0 72 6f 6d 70 74 20 74 68 65 20 75 73 65 72 20 62 6f 75 6e 64 20 74 6f 20 6b 65 79 73 20 69 6e 20 rompt.the.user.bound.to.keys.in.
c300 74 68 65 20 61 63 74 69 6f 6e 0a 20 20 6d 61 70 73 2c 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 72 the.action...maps,.most.of.the.r
c320 65 67 69 6f 6e 20 61 63 74 69 6f 6e 73 2c 20 66 6f 72 20 69 6e 73 74 61 6e 63 65 2e 29 0a 0a 20 egion.actions,.for.instance.)...
c340 20 54 68 69 73 20 69 73 20 68 6f 77 20 45 6d 62 61 72 6b 20 6d 61 6e 61 67 65 73 20 74 6f 20 72 .This.is.how.Embark.manages.to.r
c360 65 75 73 65 20 6e 6f 72 6d 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 61 73 20 61 63 74 69 6f 6e 73 2e euse.normal.commands.as.actions.
c380 20 54 68 65 0a 20 20 6d 65 63 68 61 6e 69 73 6d 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 75 .The...mechanism.allows.you.to.u
c3a0 73 65 20 61 73 20 45 6d 62 61 72 6b 20 61 63 74 69 6f 6e 73 20 63 6f 6d 6d 61 6e 64 73 20 74 68 se.as.Embark.actions.commands.th
c3c0 61 74 20 77 65 72 65 20 6e 6f 74 0a 20 20 77 72 69 74 74 65 6e 20 77 69 74 68 20 45 6d 62 61 72 at.were.not...written.with.Embar
c3e0 6b 20 69 6e 20 6d 69 6e 64 20 28 61 6e 64 20 69 6e 64 65 65 64 20 61 6c 6d 6f 73 74 20 61 6c 6c k.in.mind.(and.indeed.almost.all
c400 20 61 63 74 69 6f 6e 73 20 74 68 61 74 20 61 72 65 0a 20 20 62 6f 75 6e 64 20 62 79 20 64 65 66 .actions.that.are...bound.by.def
c420 61 75 6c 74 20 69 6e 20 45 6d 62 61 72 6b 27 73 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 20 ault.in.Embark's.action.keymaps.
c440 61 72 65 20 73 74 61 6e 64 61 72 64 20 45 6d 61 63 73 0a 20 20 63 6f 6d 6d 61 6e 64 73 29 2e 20 are.standard.Emacs...commands)..
c460 49 74 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 77 72 69 74 65 20 6e 65 77 20 It.also.allows.you.to.write.new.
c480 63 75 73 74 6f 6d 20 61 63 74 69 6f 6e 73 20 69 6e 20 73 75 63 68 20 61 0a 20 20 77 61 79 20 74 custom.actions.in.such.a...way.t
c4a0 68 61 74 20 74 68 65 79 20 61 72 65 20 75 73 65 66 75 6c 20 65 76 65 6e 20 77 69 74 68 6f 75 74 hat.they.are.useful.even.without
c4c0 20 45 6d 62 61 72 6b 2e 0a 0a 20 20 53 74 61 72 69 6e 67 20 66 72 6f 6d 20 76 65 72 73 69 6f 6e .Embark.....Staring.from.version
c4e0 20 32 38 2e 31 2c 20 45 6d 61 63 73 20 68 61 73 20 61 20 76 61 72 69 61 62 6c 65 0a 20 20 3d 79 .28.1,.Emacs.has.a.variable...=y
c500 2d 6f 72 2d 6e 2d 70 2d 75 73 65 2d 72 65 61 64 2d 6b 65 79 3d 2c 20 77 68 69 63 68 20 77 68 65 -or-n-p-use-read-key=,.which.whe
c520 6e 20 73 65 74 20 74 6f 20 3d 74 3d 20 63 61 75 73 65 73 20 3d 79 2d 6f 72 2d 6e 2d 70 3d 20 74 n.set.to.=t=.causes.=y-or-n-p=.t
c540 6f 20 75 73 65 0a 20 20 3d 72 65 61 64 2d 6b 65 79 3d 20 69 6e 73 74 65 61 64 20 6f 66 20 3d 72 o.use...=read-key=.instead.of.=r
c560 65 61 64 2d 66 72 6f 6d 2d 6d 69 6e 69 62 75 66 66 65 72 3d 2e 20 53 65 74 74 69 6e 67 0a 20 20 ead-from-minibuffer=..Setting...
c580 3d 79 2d 6f 72 2d 6e 2d 70 2d 75 73 65 2d 72 65 61 64 2d 6b 65 79 3d 20 74 6f 20 3d 74 3d 20 69 =y-or-n-p-use-read-key=.to.=t=.i
c5a0 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 66 6f 72 20 45 6d 62 61 72 6b 20 75 73 65 72 73 20 62 s.recommended.for.Embark.users.b
c5c0 65 63 61 75 73 65 0a 20 20 69 74 20 6b 65 65 70 73 20 45 6d 62 61 72 6b 20 66 72 6f 6d 20 61 74 ecause...it.keeps.Embark.from.at
c5e0 74 65 6d 70 74 69 6e 67 20 74 6f 20 69 6e 73 65 72 74 20 74 68 65 20 74 61 72 67 65 74 20 61 74 tempting.to.insert.the.target.at
c600 20 61 20 3d 79 2d 6f 72 2d 6e 2d 70 3d 0a 20 20 70 72 6f 6d 70 74 2c 20 77 68 69 63 68 20 77 6f .a.=y-or-n-p=...prompt,.which.wo
c620 75 6c 64 20 61 6c 6d 6f 73 74 20 6e 65 76 65 72 20 62 65 20 73 65 6e 73 69 62 6c 65 2e 20 41 6c uld.almost.never.be.sensible..Al
c640 73 6f 20 63 6f 6e 73 69 64 65 72 20 74 68 69 73 20 61 73 0a 20 20 61 20 77 61 72 6e 69 6e 67 20 so.consider.this.as...a.warning.
c660 74 6f 20 73 74 72 75 63 74 75 72 65 20 79 6f 75 72 20 6f 77 6e 20 61 63 74 69 6f 6e 20 63 6f 6d to.structure.your.own.action.com
c680 6d 61 6e 64 73 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 65 79 20 75 73 65 0a 20 20 3d 79 2d 6f mands.so.that.if.they.use...=y-o
c6a0 72 2d 6e 2d 70 3d 2c 20 74 68 65 79 20 64 6f 20 73 6f 20 6f 6e 6c 79 20 61 66 74 65 72 20 74 68 r-n-p=,.they.do.so.only.after.th
c6c0 65 20 70 72 6f 6d 70 74 69 6e 67 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 74 2e 0a 0a 20 20 48 e.prompting.for.the.target.....H
c6e0 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c 65 20 69 6c 6c 75 73 74 72 61 ere.is.a.simple.example.illustra
c700 74 69 6e 67 20 74 68 65 20 76 61 72 69 6f 75 73 20 77 61 79 73 20 6f 66 20 72 65 61 64 69 6e 67 ting.the.various.ways.of.reading
c720 0a 20 20 69 6e 70 75 74 20 66 72 6f 6d 20 74 68 65 20 75 73 65 72 20 6d 65 6e 74 69 6f 6e 65 64 ...input.from.the.user.mentioned
c740 20 61 62 6f 76 65 2e 20 42 69 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 .above..Bind.the.following.comma
c760 6e 64 73 20 74 6f 0a 20 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 3d nds.to...the.=embark-symbol-map=
c780 20 74 6f 20 62 65 20 75 73 65 64 20 61 73 20 61 63 74 69 6f 6e 73 2c 20 74 68 65 6e 20 70 75 74 .to.be.used.as.actions,.then.put
c7a0 20 74 68 65 20 70 6f 69 6e 74 20 6f 6e 0a 20 20 73 6f 6d 65 20 73 79 6d 62 6f 6c 20 61 6e 64 20 .the.point.on...some.symbol.and.
c7c0 72 75 6e 20 74 68 65 6d 20 77 69 74 68 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 3a 0a 0a 20 20 23 run.them.with.=embark-act=:....#
c7e0 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 64 65 66 75 6e +begin_src.emacs-lisp.....(defun
c800 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 31 20 28 29 0a 20 20 20 20 .example-action-command1.().....
c820 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 28 6d 65 73 73 61 67 65 20 22 ..(interactive).......(message."
c840 54 68 65 20 69 6e 70 75 74 20 77 61 73 20 60 25 73 27 2e 22 20 28 72 65 61 64 2d 66 72 6f 6d 2d The.input.was.`%s'.".(read-from-
c860 6d 69 6e 69 62 75 66 66 65 72 20 22 49 6e 70 75 74 3a 20 22 29 29 29 0a 0a 20 20 20 20 28 64 65 minibuffer."Input:.")))......(de
c880 66 75 6e 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 32 20 28 61 72 67 fun.example-action-command2.(arg
c8a0 20 69 6e 70 75 74 31 20 69 6e 70 75 74 32 29 0a 20 20 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 .input1.input2).......(interacti
c8c0 76 65 20 22 50 5c 6e 73 49 6e 70 75 74 20 31 3a 20 5c 6e 73 49 6e 70 75 74 20 32 3a 20 22 29 0a ve."P\nsInput.1:.\nsInput.2:.").
c8e0 20 20 20 20 20 20 28 6d 65 73 73 61 67 65 20 22 54 68 65 20 66 69 72 73 74 20 69 6e 70 75 74 20 ......(message."The.first.input.
c900 25 73 77 61 73 20 60 25 73 27 2c 20 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20 77 61 73 20 60 %swas.`%s',.and.the.second.was.`
c920 25 73 27 2e 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 61 72 67 20 22 74 72 %s'."................(if.arg."tr
c940 75 6c 79 20 22 20 22 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 70 75 74 31 0a uly."."")................input1.
c960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 70 75 74 32 29 29 0a 0a 20 20 20 20 28 64 65 ...............input2))......(de
c980 66 75 6e 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 33 20 28 29 0a 20 fun.example-action-command3.()..
c9a0 20 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 28 6d 65 73 73 61 67 .....(interactive).......(messag
c9c0 65 20 22 59 6f 75 72 20 73 65 6c 65 63 74 69 6f 6e 20 77 61 73 20 60 25 73 27 2e 22 0a 20 20 20 e."Your.selection.was.`%s'."....
c9e0 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 20 22 53 65 ............(completing-read."Se
ca00 6c 65 63 74 3a 20 22 20 27 28 22 45 22 20 22 4d 22 20 22 42 22 20 22 41 22 20 22 52 22 20 22 4b lect:.".'("E"."M"."B"."A"."R"."K
ca20 22 29 29 29 29 0a 0a 20 20 20 20 28 64 65 66 75 6e 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e "))))......(defun.example-action
ca40 2d 63 6f 6d 6d 61 6e 64 34 20 28 29 0a 20 20 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 -command4.().......(interactive)
ca60 0a 20 20 20 20 20 20 28 6d 65 73 73 61 67 65 20 22 49 20 64 6f 6e 27 74 20 70 72 6f 6d 70 74 20 .......(message."I.don't.prompt.
ca80 79 6f 75 20 66 6f 72 20 69 6e 70 75 74 20 61 6e 64 20 74 68 75 73 20 69 67 6e 6f 72 65 20 74 68 you.for.input.and.thus.ignore.th
caa0 65 20 74 61 72 67 65 74 21 22 29 29 0a 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d e.target!"))......(keymap-set.em
cac0 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 31 22 20 23 27 65 78 61 6d 70 6c 65 2d bark-symbol-map."X.1".#'example-
cae0 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 31 29 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 action-command1).....(keymap-set
cb00 20 65 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 32 22 20 23 27 65 78 61 6d 70 .embark-symbol-map."X.2".#'examp
cb20 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 32 29 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d le-action-command2).....(keymap-
cb40 73 65 74 20 65 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 33 22 20 23 27 65 78 set.embark-symbol-map."X.3".#'ex
cb60 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 33 29 0a 20 20 20 20 28 6b 65 79 6d ample-action-command3).....(keym
cb80 61 70 2d 73 65 74 20 65 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 34 22 20 23 ap-set.embark-symbol-map."X.4".#
cba0 27 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 34 29 0a 20 20 23 2b 65 6e 'example-action-command4)...#+en
cbc0 64 5f 73 72 63 0a 0a 20 20 41 6c 73 6f 20 6e 6f 74 65 20 74 68 61 74 20 69 66 20 79 6f 75 20 61 d_src....Also.note.that.if.you.a
cbe0 72 65 20 75 73 69 6e 67 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 74 6f 20 63 61 6c re.using.the.key.bindings.to.cal
cc00 6c 20 61 63 74 69 6f 6e 73 2c 0a 20 20 79 6f 75 20 63 61 6e 20 70 61 73 73 20 70 72 65 66 69 78 l.actions,...you.can.pass.prefix
cc20 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 61 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 6e 6f 72 .arguments.to.actions.in.the.nor
cc40 6d 61 6c 20 77 61 79 2e 20 46 6f 72 0a 20 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61 6e 20 mal.way..For...example,.you.can.
cc60 75 73 65 20 3d 43 2d 75 20 58 32 3d 20 77 69 74 68 20 74 68 65 20 61 62 6f 76 65 20 64 65 6d 6f use.=C-u.X2=.with.the.above.demo
cc80 6e 73 74 72 61 74 69 6f 6e 20 61 63 74 69 6f 6e 73 20 74 6f 0a 20 20 6d 61 6b 65 20 74 68 65 20 nstration.actions.to...make.the.
cca0 6d 65 73 73 61 67 65 20 70 72 69 6e 74 65 64 20 62 79 20 3d 65 78 61 6d 70 6c 65 2d 61 63 74 69 message.printed.by.=example-acti
ccc0 6f 6e 2d 63 6f 6d 6d 61 6e 64 32 3d 20 6d 6f 72 65 20 65 6d 70 68 61 74 69 63 2e 0a 20 20 54 68 on-command2=.more.emphatic....Th
cce0 69 73 20 61 62 69 6c 69 74 79 20 74 6f 20 70 61 73 73 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 is.ability.to.pass.prefix.argume
cd00 6e 74 73 20 74 6f 20 61 63 74 69 6f 6e 73 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 73 6f 6d nts.to.actions.is.useful.for.som
cd20 65 0a 20 20 61 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 e...actions.in.the.default.confi
cd40 67 75 72 61 74 69 6f 6e 2c 20 73 75 63 68 20 61 73 0a 20 20 3d 65 6d 62 61 72 6b 2d 73 68 65 6c guration,.such.as...=embark-shel
cd60 6c 2d 63 6f 6d 6d 61 6e 64 2d 6f 6e 2d 62 75 66 66 65 72 3d 2e 0a 0a 2a 2a 20 4e 6f 6e 2d 69 6e l-command-on-buffer=...**.Non-in
cd80 74 65 72 61 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 61 63 74 69 6f 6e 73 0a 0a teractive.functions.as.actions..
cda0 20 20 41 6c 74 65 72 6e 61 74 69 76 65 6c 79 2c 20 45 6d 62 61 72 6b 20 64 6f 65 73 20 73 75 70 ..Alternatively,.Embark.does.sup
cdc0 70 6f 72 74 20 6f 6e 65 20 6f 74 68 65 72 20 74 79 70 65 20 6f 66 20 61 63 74 69 6f 6e 3a 20 61 port.one.other.type.of.action:.a
cde0 0a 20 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 61 ...non-interactive.function.of.a
ce00 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 74 61 72 67 65 74 20 69 73 20 .single.argument..The.target.is.
ce20 70 61 73 73 65 64 0a 20 20 61 73 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 passed...as.argument.to.the.func
ce40 74 69 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 0a 20 20 23 2b 62 65 67 69 6e 5f 73 72 tion..For.example:....#+begin_sr
ce60 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 64 65 66 75 6e 20 65 78 61 6d 70 6c 65 2d c.emacs-lisp.....(defun.example-
ce80 61 63 74 69 6f 6e 2d 66 75 6e 63 74 69 6f 6e 20 28 74 61 72 67 65 74 29 0a 20 20 20 20 20 20 28 action-function.(target).......(
cea0 6d 65 73 73 61 67 65 20 22 54 68 65 20 74 61 72 67 65 74 20 77 61 73 20 60 25 73 27 2e 22 20 74 message."The.target.was.`%s'.".t
cec0 61 72 67 65 74 29 29 0a 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d 62 61 72 6b 2d arget))......(keymap-set.embark-
cee0 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 34 22 20 23 27 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f symbol-map."X.4".#'example-actio
cf00 6e 2d 66 75 6e 63 74 69 6f 6e 29 0a 20 20 23 2b 65 6e 64 5f 73 72 63 0a 0a 20 20 4e 6f 74 65 20 n-function)...#+end_src....Note.
cf20 74 68 61 74 20 6e 6f 72 6d 61 6c 6c 79 20 62 69 6e 64 69 6e 67 20 6e 6f 6e 2d 69 6e 74 65 72 61 that.normally.binding.non-intera
cf40 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 20 61 20 6b 65 79 6d 61 70 20 69 73 0a 20 ctive.functions.in.a.keymap.is..
cf60 20 75 73 65 6c 65 73 73 2c 20 73 69 6e 63 65 20 77 68 65 6e 20 61 74 74 65 6d 70 74 69 6e 67 20 .useless,.since.when.attempting.
cf80 74 6f 20 72 75 6e 20 74 68 65 6d 20 75 73 69 6e 67 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e to.run.them.using.the.key.bindin
cfa0 67 20 79 6f 75 0a 20 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 73 69 6d g.you...get.an.error.message.sim
cfc0 69 6c 61 72 20 74 6f 20 22 57 72 6f 6e 67 20 74 79 70 65 20 61 72 67 75 6d 65 6e 74 3a 20 63 6f ilar.to."Wrong.type.argument:.co
cfe0 6d 6d 61 6e 64 70 2c 0a 20 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 66 75 6e 63 74 69 6f mmandp,...example-action-functio
d000 6e 22 2e 20 49 6e 20 67 65 6e 65 72 61 6c 20 69 74 20 69 73 20 6d 6f 72 65 20 66 6c 65 78 69 62 n"..In.general.it.is.more.flexib
d020 6c 65 20 74 6f 20 77 72 69 74 65 0a 20 20 61 6e 79 20 6e 65 77 20 45 6d 62 61 72 6b 20 61 63 74 le.to.write...any.new.Embark.act
d040 69 6f 6e 73 20 61 73 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 61 74 20 69 73 2c 20 61 73 20 69 6e ions.as.commands,.that.is,.as.in
d060 74 65 72 61 63 74 69 76 65 0a 20 20 66 75 6e 63 74 69 6f 6e 73 2c 20 62 65 63 61 75 73 65 20 74 teractive...functions,.because.t
d080 68 61 74 20 77 61 79 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e 20 74 68 65 6d 20 64 69 hat.way.you.can.also.run.them.di
d0a0 72 65 63 74 6c 79 2c 20 77 69 74 68 6f 75 74 0a 20 20 45 6d 62 61 72 6b 2e 20 42 75 74 20 74 68 rectly,.without...Embark..But.th
d0c0 65 72 65 20 61 72 65 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 72 65 61 73 6f 6e 73 20 74 6f 20 75 ere.are.a.couple.of.reasons.to.u
d0e0 73 65 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 0a 20 20 66 75 6e 63 74 69 6f 6e 73 20 61 se.non-interactive...functions.a
d100 73 20 61 63 74 69 6f 6e 73 3a 0a 0a 20 20 31 2e 20 59 6f 75 20 6d 61 79 20 61 6c 72 65 61 64 79 s.actions:....1..You.may.already
d120 20 68 61 76 65 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 6c 79 69 6e 67 20 61 72 6f 75 6e 64 2c .have.the.function.lying.around,
d140 20 61 6e 64 20 69 74 20 69 73 0a 20 20 20 20 20 63 6f 6e 76 65 6e 69 65 6e 74 20 74 6f 20 73 69 .and.it.is......convenient.to.si
d160 6d 70 6c 79 20 72 65 75 73 65 20 69 74 2e 0a 0a 20 20 32 2e 20 46 6f 72 20 63 6f 6d 6d 61 6e 64 mply.reuse.it.....2..For.command
d180 20 61 63 74 69 6f 6e 73 20 74 68 65 20 74 61 72 67 65 74 73 20 63 61 6e 20 6f 6e 6c 79 20 62 65 .actions.the.targets.can.only.be
d1a0 20 73 69 6d 70 6c 65 20 73 74 72 69 6e 67 2c 20 77 69 74 68 0a 20 20 20 20 20 6e 6f 20 74 65 78 .simple.string,.with......no.tex
d1c0 74 20 70 72 6f 70 65 72 74 69 65 73 2e 20 46 6f 72 20 63 65 72 74 61 69 6e 20 61 64 76 61 6e 63 t.properties..For.certain.advanc
d1e0 65 64 20 75 73 65 73 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 68 65 0a 20 20 20 20 20 61 63 ed.uses.you.may.want.the......ac
d200 74 69 6f 6e 20 74 6f 20 72 65 63 65 69 76 65 20 61 20 73 74 72 69 6e 67 20 2f 77 69 74 68 2f 20 tion.to.receive.a.string./with/.
d220 73 6f 6d 65 20 74 65 78 74 20 70 72 6f 70 65 72 74 69 65 73 2c 20 6f 72 20 65 76 65 6e 20 61 0a some.text.properties,.or.even.a.
d240 20 20 20 20 20 6e 6f 6e 2d 73 74 72 69 6e 67 20 74 61 72 67 65 74 2e 0a 0a 2a 20 45 6d 62 61 72 .....non-string.target...*.Embar
d260 6b 2c 20 4d 61 72 67 69 6e 61 6c 69 61 20 61 6e 64 20 43 6f 6e 73 75 6c 74 0a 0a 45 6d 62 61 72 k,.Marginalia.and.Consult..Embar
d280 6b 20 63 6f 6f 70 65 72 61 74 65 73 20 77 65 6c 6c 20 77 69 74 68 20 74 68 65 20 5b 5b 68 74 74 k.cooperates.well.with.the.[[htt
d2a0 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 6d 61 72 67 69 6e 61 6c 69 61 ps://github.com/minad/marginalia
d2c0 5d 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 5d 20 61 6e 64 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 ][Marginalia]].and.[[https://git
d2e0 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 63 6f 6e 73 75 6c 74 5d 5b 43 6f 6e 73 75 6c 74 5d 5d hub.com/minad/consult][Consult]]
d300 20 70 61 63 6b 61 67 65 73 2e 0a 4e 65 69 74 68 65 72 20 6f 66 20 74 68 6f 73 65 20 70 61 63 6b .packages..Neither.of.those.pack
d320 61 67 65 73 20 69 73 20 61 20 64 65 70 65 6e 64 65 6e 63 79 20 6f 66 20 45 6d 62 61 72 6b 2c 20 ages.is.a.dependency.of.Embark,.
d340 62 75 74 20 62 6f 74 68 20 61 72 65 0a 68 69 67 68 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 but.both.are.highly.recommended.
d360 63 6f 6d 70 61 6e 69 6f 6e 73 20 74 6f 20 45 6d 62 61 72 6b 2c 20 66 6f 72 20 6f 70 70 6f 73 69 companions.to.Embark,.for.opposi
d380 74 65 20 72 65 61 73 6f 6e 73 3a 0a 4d 61 72 67 69 6e 61 6c 69 61 20 67 72 65 61 74 6c 79 20 65 te.reasons:.Marginalia.greatly.e
d3a0 6e 68 61 6e 63 65 73 20 45 6d 62 61 72 6b 27 73 20 75 73 65 66 75 6c 6e 65 73 73 2c 20 77 68 69 nhances.Embark's.usefulness,.whi
d3c0 6c 65 20 45 6d 62 61 72 6b 20 63 61 6e 20 68 65 6c 70 0a 65 6e 68 61 6e 63 65 20 43 6f 6e 73 75 le.Embark.can.help.enhance.Consu
d3e0 6c 74 2e 0a 0a 49 6e 20 74 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 69 73 20 73 65 lt...In.the.remainder.of.this.se
d400 63 74 69 6f 6e 20 49 27 6c 6c 20 65 78 70 6c 61 69 6e 20 77 68 61 74 20 65 78 61 63 74 6c 79 20 ction.I'll.explain.what.exactly.
d420 4d 61 72 67 69 6e 61 6c 69 61 0a 64 6f 65 73 20 66 6f 72 20 45 6d 62 61 72 6b 2c 20 61 6e 64 20 Marginalia.does.for.Embark,.and.
d440 77 68 61 74 20 45 6d 62 61 72 6b 20 63 61 6e 20 64 6f 20 66 6f 72 20 43 6f 6e 73 75 6c 74 2e 0a what.Embark.can.do.for.Consult..
d460 0a 2a 2a 20 4d 61 72 67 69 6e 61 6c 69 61 0a 0a 45 6d 62 61 72 6b 20 63 6f 6d 65 73 20 77 69 74 .**.Marginalia..Embark.comes.wit
d480 68 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 73 79 6d 62 6f 6c 73 20 28 63 6f 6d 6d 61 6e 64 73 2c h.actions.for.symbols.(commands,
d4a0 20 66 75 6e 63 74 69 6f 6e 73 2c 20 76 61 72 69 61 62 6c 65 73 0a 77 69 74 68 20 61 63 74 69 6f .functions,.variables.with.actio
d4c0 6e 73 20 73 75 63 68 20 61 73 20 66 69 6e 64 69 6e 67 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f ns.such.as.finding.the.definitio
d4e0 6e 2c 20 6c 6f 6f 6b 69 6e 67 20 75 70 20 74 68 65 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c n,.looking.up.the.documentation,
d500 20 65 76 61 6c 75 61 74 69 6e 67 2c 20 65 74 63 2e 29 20 69 6e 20 74 68 65 20 3d 65 6d 62 61 72 .evaluating,.etc.).in.the.=embar
d520 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 3d 20 6b 65 79 6d 61 70 2c 20 61 6e 64 0a 66 6f 72 20 70 61 k-symbol-map=.keymap,.and.for.pa
d540 63 6b 61 67 65 73 20 28 61 63 74 69 6f 6e 73 20 6c 69 6b 65 20 69 6e 73 74 61 6c 6c 2c 20 64 65 ckages.(actions.like.install,.de
d560 6c 65 74 65 2c 20 62 72 6f 77 73 65 20 75 72 6c 2c 20 65 74 63 2e 29 20 69 6e 20 74 68 65 0a 3d lete,.browse.url,.etc.).in.the.=
d580 65 6d 62 61 72 6b 2d 70 61 63 6b 61 67 65 2d 6b 65 79 6d 61 70 3d 2e 0a 0a 55 6e 66 6f 72 74 75 embark-package-keymap=...Unfortu
d5a0 6e 61 74 65 6c 79 20 45 6d 62 61 72 6b 20 64 6f 65 73 20 6e 6f 74 20 61 75 74 6f 6d 61 74 69 63 nately.Embark.does.not.automatic
d5c0 61 6c 6c 79 20 6f 66 66 65 72 73 20 79 6f 75 20 74 68 65 73 65 20 6b 65 79 6d 61 70 73 0a 77 68 ally.offers.you.these.keymaps.wh
d5e0 65 6e 20 72 65 6c 65 76 61 6e 74 2c 20 62 65 63 61 75 73 65 20 6d 61 6e 79 20 62 75 69 6c 74 2d en.relevant,.because.many.built-
d600 69 6e 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 20 64 6f 6e 27 74 20 72 65 70 6f 72 74 0a 61 in.Emacs.commands.don't.report.a
d620 63 63 75 72 61 74 65 20 63 61 74 65 67 6f 72 79 20 6d 65 74 61 64 61 74 61 2e 20 46 6f 72 20 65 ccurate.category.metadata..For.e
d640 78 61 6d 70 6c 65 2c 20 61 20 63 6f 6d 6d 61 6e 64 20 6c 69 6b 65 0a 3d 64 65 73 63 72 69 62 65 xample,.a.command.like.=describe
d660 2d 70 61 63 6b 61 67 65 3d 2c 20 77 68 69 63 68 20 72 65 61 64 73 20 61 20 70 61 63 6b 61 67 65 -package=,.which.reads.a.package
d680 20 6e 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 0a 64 6f 65 73 20 .name.from.the.minibuffer,.does.
d6a0 6e 6f 74 20 68 61 76 65 20 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 69 not.have.metadata.indicating.thi
d6c0 73 20 66 61 63 74 2e 0a 0a 49 6e 20 61 6e 20 65 61 72 6c 69 65 72 20 45 6d 62 61 72 6b 20 76 65 s.fact...In.an.earlier.Embark.ve
d6e0 72 73 69 6f 6e 2c 20 74 68 65 72 65 20 77 65 72 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 73 rsion,.there.were.functions.to.s
d700 75 70 70 6c 79 20 74 68 69 73 0a 6d 69 73 73 69 6e 67 20 6d 65 74 61 64 61 74 61 2c 20 62 75 74 upply.this.missing.metadata,.but
d720 20 74 68 65 79 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 76 65 64 20 74 6f 20 4d 61 72 67 69 6e 61 .they.have.been.moved.to.Margina
d740 6c 69 61 2c 20 77 68 69 63 68 0a 61 75 67 6d 65 6e 74 73 20 6d 61 6e 79 20 45 6d 61 63 73 20 63 lia,.which.augments.many.Emacs.c
d760 6f 6d 6d 61 6e 64 20 74 6f 20 72 65 70 6f 72 74 20 61 63 63 75 72 61 74 65 20 63 61 74 65 67 6f ommand.to.report.accurate.catego
d780 72 79 20 6d 65 74 61 64 61 74 61 2e 0a 53 69 6d 70 6c 79 20 61 63 74 69 76 61 74 69 6e 67 20 3d ry.metadata..Simply.activating.=
d7a0 6d 61 72 67 69 6e 61 6c 69 61 2d 6d 6f 64 65 3d 20 61 6c 6c 6f 77 73 20 45 6d 62 61 72 6b 20 74 marginalia-mode=.allows.Embark.t
d7c0 6f 20 6f 66 66 65 72 20 79 6f 75 20 74 68 65 0a 70 61 63 6b 61 67 65 20 61 6e 64 20 73 79 6d 62 o.offer.you.the.package.and.symb
d7e0 6f 6c 20 61 63 74 69 6f 6e 73 20 77 68 65 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 61 67 61 69 ol.actions.when.appropriate.agai
d800 6e 2e 20 43 61 6e 64 69 64 61 74 65 0a 61 6e 6e 6f 74 61 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 n..Candidate.annotations.in.the.
d820 45 6d 62 61 72 6b 20 63 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 61 72 65 20 61 6c 73 6f 20 70 Embark.collect.buffer.are.also.p
d840 72 6f 76 69 64 65 64 20 62 79 20 74 68 65 0a 4d 61 72 67 69 6e 61 6c 69 61 20 70 61 63 6b 61 67 rovided.by.the.Marginalia.packag
d860 65 3a 0a 0a 2d 20 49 66 20 79 6f 75 20 69 6e 73 74 61 6c 6c 20 4d 61 72 67 69 6e 61 6c 69 61 20 e:..-.If.you.install.Marginalia.
d880 61 6e 64 20 61 63 74 69 76 61 74 65 20 3d 6d 61 72 67 69 6e 61 6c 69 61 2d 6d 6f 64 65 3d 2c 20 and.activate.=marginalia-mode=,.
d8a0 45 6d 62 61 72 6b 0a 20 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 20 77 69 6c 6c 20 75 73 Embark...Collect.buffers.will.us
d8c0 65 20 74 68 65 20 4d 61 72 67 69 6e 61 6c 69 61 20 61 6e 6e 6f 74 61 74 69 6f 6e 73 20 61 75 74 e.the.Marginalia.annotations.aut
d8e0 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 0a 2d 20 49 66 20 79 6f 75 20 64 6f 6e 27 74 20 69 6e 73 74 omatically...-.If.you.don't.inst
d900 61 6c 6c 20 4d 61 72 67 69 6e 61 6c 69 61 2c 20 79 6f 75 20 77 69 6c 6c 20 73 65 65 20 6f 6e 6c all.Marginalia,.you.will.see.onl
d920 79 20 74 68 65 20 61 6e 6e 6f 74 61 74 69 6f 6e 73 0a 20 20 74 68 61 74 20 63 6f 6d 65 20 77 69 y.the.annotations...that.come.wi
d940 74 68 20 45 6d 61 63 73 20 28 73 75 63 68 20 61 73 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 69 th.Emacs.(such.as.key.bindings.i
d960 6e 20 3d 4d 2d 78 3d 2c 20 6f 72 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 63 68 61 72 61 63 n.=M-x=,.or.the.unicode...charac
d980 74 65 72 73 20 69 6e 20 3d 43 2d 78 20 38 20 52 45 54 3d 29 2e 0a 0a 2a 2a 20 43 6f 6e 73 75 6c ters.in.=C-x.8.RET=)...**.Consul
d9a0 74 0a 0a 54 68 65 20 65 78 63 65 6c 6c 65 6e 74 20 43 6f 6e 73 75 6c 74 20 70 61 63 6b 61 67 65 t..The.excellent.Consult.package
d9c0 20 70 72 6f 76 69 64 65 73 20 6d 61 6e 79 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 75 73 65 .provides.many.commands.that.use
d9e0 0a 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 76 69 61 20 74 68 65 20 .minibuffer.completion,.via.the.
da00 3d 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 3d 20 66 75 6e 63 74 69 6f 6e 3b 20 70 6c 65 6e =completing-read=.function;.plen
da20 74 79 20 6f 66 20 69 74 73 0a 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 63 6f 6e 73 69 64 ty.of.its.commands.can.be.consid
da40 65 72 65 64 20 65 6e 68 61 6e 63 65 64 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 62 75 69 6c 74 2d ered.enhanced.versions.of.built-
da60 69 6e 20 45 6d 61 63 73 0a 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 73 6f 6d 65 20 61 72 65 20 in.Emacs.commands,.and.some.are.
da80 63 6f 6d 70 6c 65 74 65 6c 79 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e 20 4f 6e completely.new.functionality..On
daa0 65 20 63 6f 6d 6d 6f 6e 0a 65 6e 68 61 6e 63 65 6d 65 6e 74 20 70 72 6f 76 69 64 65 64 20 69 6e e.common.enhancement.provided.in
dac0 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 77 68 69 63 68 20 69 74 20 6d 61 6b 65 73 .all.commands.for.which.it.makes
dae0 20 73 65 6e 73 65 20 69 73 0a 70 72 65 76 69 65 77 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2c .sense.is.preview.functionality,
db00 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 3d 63 6f 6e 73 75 6c 74 2d 62 75 66 66 65 72 3d 20 77 69 .for.example.=consult-buffer=.wi
db20 6c 6c 20 73 68 6f 77 20 79 6f 75 20 61 0a 71 75 69 63 6b 20 70 72 65 76 69 65 77 20 6f 66 20 61 ll.show.you.a.quick.preview.of.a
db40 20 62 75 66 66 65 72 20 62 65 66 6f 72 65 20 79 6f 75 20 61 63 74 75 61 6c 6c 79 20 73 77 69 74 .buffer.before.you.actually.swit
db60 63 68 20 74 6f 20 69 74 2e 0a 0a 49 66 20 79 6f 75 20 75 73 65 20 62 6f 74 68 20 43 6f 6e 73 75 ch.to.it...If.you.use.both.Consu
db80 6c 74 20 61 6e 64 20 45 6d 62 61 72 6b 20 79 6f 75 20 73 68 6f 75 6c 64 20 69 6e 73 74 61 6c 6c lt.and.Embark.you.should.install
dba0 20 74 68 65 0a 3d 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 20 77 68 .the.=embark-consult=.package.wh
dbc0 69 63 68 20 70 72 6f 76 69 64 65 73 20 69 6e 74 65 67 72 61 74 69 6f 6e 20 62 65 74 77 65 65 6e ich.provides.integration.between
dbe0 20 74 68 65 20 74 77 6f 2e 20 49 74 0a 70 72 6f 76 69 64 65 73 20 65 78 70 6f 72 74 65 72 73 20 .the.two..It.provides.exporters.
dc00 66 6f 72 20 73 65 76 65 72 61 6c 20 43 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 for.several.Consult.commands.and
dc20 20 61 6c 73 6f 20 74 77 65 61 6b 73 20 74 68 65 0a 62 65 68 61 76 69 6f 72 20 6f 66 20 6d 61 6e .also.tweaks.the.behavior.of.man
dc40 79 20 43 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 73 20 77 68 65 6e 20 75 73 65 64 20 61 73 20 y.Consult.commands.when.used.as.
dc60 61 63 74 69 6f 6e 73 20 77 69 74 68 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 0a 69 6e 20 73 75 62 actions.with.=embark-act=.in.sub
dc80 74 6c 65 20 77 61 79 73 20 74 68 61 74 20 79 6f 75 20 6d 61 79 20 6e 6f 74 20 65 76 65 6e 20 6e tle.ways.that.you.may.not.even.n
dca0 6f 74 69 63 65 2c 20 62 75 74 20 6d 61 6b 65 20 66 6f 72 20 61 20 73 6d 6f 6f 74 68 65 72 0a 65 otice,.but.make.for.a.smoother.e
dcc0 78 70 65 72 69 65 6e 63 65 2e 20 59 6f 75 20 6e 65 65 64 20 6f 6e 6c 79 20 69 6e 73 74 61 6c 6c xperience..You.need.only.install
dce0 20 69 74 20 74 6f 20 67 65 74 20 74 68 65 73 65 20 62 65 6e 65 66 69 74 73 3a 20 45 6d 62 61 72 .it.to.get.these.benefits:.Embar
dd00 6b 0a 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6c 6f 61 64 20 69 74 20 61 66 74 k.will.automatically.load.it.aft
dd20 65 72 20 43 6f 6e 73 75 6c 74 20 69 66 20 66 6f 75 6e 64 2e 0a 0a 54 68 65 20 3d 65 6d 62 61 72 er.Consult.if.found...The.=embar
dd40 6b 2d 63 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64 65 73 20 74 68 65 20 k-consult=.package.provides.the.
dd60 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 70 6f 72 74 65 72 73 3a 0a 0a 2d 20 59 6f 75 20 63 61 6e 20 following.exporters:..-.You.can.
dd80 75 73 65 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 66 72 6f 6d 20 3d 63 6f 6e 73 75 6c use.=embark-export=.from.=consul
dda0 74 2d 6c 69 6e 65 3d 2c 20 3d 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 3d 2c 20 6f 72 0a 20 t-line=,.=consult-outline=,.or..
ddc0 20 3d 63 6f 6e 73 75 6c 74 2d 6d 61 72 6b 3d 20 74 6f 20 6f 62 74 61 69 6e 20 61 6e 20 3d 6f 63 .=consult-mark=.to.obtain.an.=oc
dde0 63 75 72 2d 6d 6f 64 65 3d 20 62 75 66 66 65 72 2e 20 41 73 20 77 69 74 68 20 74 68 65 20 62 75 cur-mode=.buffer..As.with.the.bu
de00 69 6c 74 2d 69 6e 0a 20 20 3d 6f 63 63 75 72 3d 20 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 75 73 65 ilt-in...=occur=.command.you.use
de20 20 74 68 61 74 20 62 75 66 66 65 72 20 74 6f 20 6a 75 6d 70 20 74 6f 20 61 20 6d 61 74 63 68 20 .that.buffer.to.jump.to.a.match.
de40 61 6e 64 20 61 66 74 65 72 20 74 68 61 74 2c 0a 20 20 79 6f 75 20 63 61 6e 20 74 68 65 6e 20 75 and.after.that,...you.can.then.u
de60 73 65 20 3d 6e 65 78 74 2d 65 72 72 6f 72 3d 20 61 6e 64 20 3d 70 72 65 76 69 6f 75 73 2d 65 72 se.=next-error=.and.=previous-er
de80 72 6f 72 3d 20 74 6f 20 6e 61 76 69 67 61 74 65 20 74 6f 20 6f 74 68 65 72 0a 20 20 6d 61 74 63 ror=.to.navigate.to.other...matc
dea0 68 65 73 2e 20 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 70 72 65 73 73 20 3d 65 3d 20 74 6f 20 61 hes..You.can.also.press.=e=.to.a
dec0 63 74 69 76 61 74 65 20 3d 6f 63 63 75 72 2d 65 64 69 74 2d 6d 6f 64 65 3d 20 61 6e 64 20 65 64 ctivate.=occur-edit-mode=.and.ed
dee0 69 74 0a 20 20 74 68 65 20 6d 61 74 63 68 65 73 20 69 6e 20 70 6c 61 63 65 21 0a 0a 2d 20 59 6f it...the.matches.in.place!..-.Yo
df00 75 20 63 61 6e 20 65 78 70 6f 72 74 20 66 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 65 20 43 6f 6e u.can.export.from.any.of.the.Con
df20 73 75 6c 74 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 sult.asynchronous.search.command
df40 73 2c 0a 20 20 3d 63 6f 6e 73 75 6c 74 2d 67 72 65 70 3d 2c 20 3d 63 6f 6e 73 75 6c 74 2d 67 69 s,...=consult-grep=,.=consult-gi
df60 74 2d 67 72 65 70 3d 2c 20 6f 72 20 3d 63 6f 6e 73 75 6c 74 2d 72 69 70 67 72 65 70 3d 20 74 6f t-grep=,.or.=consult-ripgrep=.to
df80 20 67 65 74 20 61 0a 20 20 3d 67 72 65 70 2d 6d 6f 64 65 3d 20 62 75 66 66 65 72 2e 20 48 65 72 .get.a...=grep-mode=.buffer..Her
dfa0 65 20 74 6f 6f 20 79 6f 75 20 63 61 6e 20 75 73 65 20 3d 6e 65 78 74 2d 65 72 72 6f 72 3d 20 61 e.too.you.can.use.=next-error=.a
dfc0 6e 64 20 3d 70 72 65 76 69 6f 75 73 2d 65 72 72 6f 72 3d 0a 20 20 74 6f 20 6e 61 76 69 67 61 74 nd.=previous-error=...to.navigat
dfe0 65 20 61 6d 6f 6e 67 20 6d 61 74 63 68 65 73 2c 20 61 6e 64 2c 20 69 66 20 79 6f 75 20 69 6e 73 e.among.matches,.and,.if.you.ins
e000 74 61 6c 6c 20 74 68 65 20 5b 5b 68 74 74 70 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 68 61 tall.the.[[http://github.com/mha
e020 79 61 73 68 69 31 31 32 30 2f 45 6d 61 63 73 2d 77 67 72 65 70 2f 72 61 77 2f 6d 61 73 74 65 72 yashi1120/Emacs-wgrep/raw/master
e040 2f 77 67 72 65 70 2e 65 6c 20 5d 5b 77 67 72 65 70 5d 5d 20 70 61 63 6b 61 67 65 2c 0a 20 20 79 /wgrep.el.][wgrep]].package,...y
e060 6f 75 20 63 61 6e 20 75 73 65 20 69 74 20 74 6f 20 65 64 69 74 20 74 68 65 20 6d 61 74 63 68 65 ou.can.use.it.to.edit.the.matche
e080 73 20 69 6e 20 70 6c 61 63 65 2e 0a 0a 49 6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20 70 72 65 73 s.in.place...In.both.cases,.pres
e0a0 73 69 6e 67 20 3d 67 3d 20 77 69 6c 6c 20 72 65 72 75 6e 20 74 68 65 20 43 6f 6e 73 75 6c 74 20 sing.=g=.will.rerun.the.Consult.
e0c0 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 68 61 64 0a 65 78 70 6f 72 74 65 64 20 66 72 6f 6d 20 61 6e command.you.had.exported.from.an
e0e0 64 20 72 65 2d 65 6e 74 65 72 20 74 68 65 20 69 6e 70 75 74 20 79 6f 75 20 68 61 64 20 74 79 70 d.re-enter.the.input.you.had.typ
e100 65 64 20 28 77 68 69 63 68 20 69 73 20 73 69 6d 69 6c 61 72 0a 74 6f 20 72 65 76 65 72 74 69 6e ed.(which.is.similar.to.revertin
e120 67 20 62 75 74 20 61 20 6c 69 74 74 6c 65 20 6d 6f 72 65 20 66 6c 65 78 69 62 6c 65 29 2e 20 59 g.but.a.little.more.flexible)..Y
e140 6f 75 20 63 61 6e 20 74 68 65 6e 20 70 72 6f 63 65 65 64 20 74 6f 0a 72 65 2d 65 78 70 6f 72 74 ou.can.then.proceed.to.re-export
e160 20 69 66 20 74 68 61 74 27 73 20 77 68 61 74 20 79 6f 75 20 77 61 6e 74 2c 20 62 75 74 20 79 6f .if.that's.what.you.want,.but.yo
e180 75 20 63 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 74 68 65 20 69 6e 70 75 74 0a 63 68 61 6e 67 69 u.can.also.edit.the.input.changi
e1a0 6e 67 20 74 68 65 20 73 65 61 72 63 68 20 74 65 72 6d 73 20 6f 72 20 73 69 6d 70 6c 79 20 63 61 ng.the.search.terms.or.simply.ca
e1c0 6e 63 65 6c 20 69 66 20 79 6f 75 20 73 65 65 20 79 6f 75 20 61 72 65 20 64 6f 6e 65 0a 77 69 74 ncel.if.you.see.you.are.done.wit
e1e0 68 20 74 68 61 74 20 73 65 61 72 63 68 2e 0a 0a 54 68 65 20 3d 65 6d 62 61 72 6b 2d 63 6f 6e 73 h.that.search...The.=embark-cons
e200 75 6c 74 3d 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 63 61 6e 64 69 64 61 74 ult=.also.contains.some.candidat
e220 65 73 20 63 6f 6c 6c 65 63 74 6f 72 73 20 74 68 61 74 20 61 6c 6c 6f 77 0a 79 6f 75 20 74 6f 20 es.collectors.that.allow.you.to.
e240 72 75 6e 20 3d 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 74 6f 20 67 65 74 20 61 20 6c 69 76 65 2d run.=embark-live=.to.get.a.live-
e260 75 70 64 61 74 69 6e 67 20 74 61 62 6c 65 20 6f 66 20 63 6f 6e 74 65 6e 74 73 20 66 6f 72 0a 79 updating.table.of.contents.for.y
e280 6f 75 72 20 62 75 66 66 65 72 3a 0a 0a 2d 20 3d 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 6f our.buffer:..-.=embark-consult-o
e2a0 75 74 6c 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 3d 20 70 72 6f 64 75 63 65 73 20 74 68 65 20 utline-candidates=.produces.the.
e2c0 6f 75 74 6c 69 6e 65 20 68 65 61 64 69 6e 67 73 20 6f 66 0a 20 20 74 68 65 20 63 75 72 72 65 6e outline.headings.of...the.curren
e2e0 74 20 62 75 66 66 65 72 2c 20 75 73 69 6e 67 20 3d 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 t.buffer,.using.=consult-outline
e300 3d 2e 0a 2d 20 3d 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 63 61 6e 64 69 =..-.=embark-consult-imenu-candi
e320 64 61 74 65 73 3d 20 70 72 6f 64 75 63 65 73 20 74 68 65 20 69 6d 65 6e 75 20 69 74 65 6d 73 20 dates=.produces.the.imenu.items.
e340 6f 66 0a 20 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2c 20 75 73 69 6e 67 20 3d of...the.current.buffer,.using.=
e360 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 3d 2e 0a 2d 20 3d 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c consult-imenu=..-.=embark-consul
e380 74 2d 69 6d 65 6e 75 2d 6f 72 2d 6f 75 74 6c 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 3d 20 69 t-imenu-or-outline-candidates=.i
e3a0 73 20 61 20 73 69 6d 70 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 0a 20 20 6f 66 20 74 68 65 20 s.a.simple.combination...of.the.
e3c0 74 77 6f 20 70 72 65 76 69 6f 75 73 20 66 75 6e 63 74 69 6f 6e 73 3a 20 69 74 20 70 72 6f 64 75 two.previous.functions:.it.produ
e3e0 63 65 73 20 69 6d 65 6e 75 20 69 74 65 6d 73 20 69 6e 20 62 75 66 66 65 72 73 0a 20 20 64 65 72 ces.imenu.items.in.buffers...der
e400 69 76 69 6e 67 20 66 72 6f 6d 20 3d 70 72 6f 67 2d 6d 6f 64 65 3d 20 61 6e 64 20 6f 74 68 65 72 iving.from.=prog-mode=.and.other
e420 77 69 73 65 20 6f 75 74 6c 69 6e 65 20 68 65 61 64 69 6e 67 73 2e 0a 0a 54 68 65 20 77 61 79 20 wise.outline.headings...The.way.
e440 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 3d 65 6d 62 61 72 6b 2d 6c 69 76 65 3d 20 28 6f 72 20 3d to.configure.=embark-live=.(or.=
e460 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 20 61 6e 64 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f embark-collect=.and.=embark-expo
e480 72 74 3d 0a 66 6f 72 20 74 68 61 74 20 6d 61 74 74 65 72 29 20 74 6f 20 75 73 65 20 6f 6e 65 20 rt=.for.that.matter).to.use.one.
e4a0 6f 66 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 74 6f 20 61 64 64 20 69 74 20 61 of.these.function.is.to.add.it.a
e4c0 74 20 74 68 65 20 65 6e 64 0a 6f 66 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 63 61 6e 64 69 64 61 t.the.end.of.the.=embark-candida
e4e0 74 65 2d 63 6f 6c 6c 65 63 74 6f 72 73 3d 20 6c 69 73 74 2e 20 54 68 65 20 3d 65 6d 62 61 72 6b te-collectors=.list..The.=embark
e500 2d 63 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 20 62 79 0a 64 65 66 61 75 6c 74 20 61 64 64 -consult=.package.by.default.add
e520 73 20 74 68 65 20 6c 61 73 74 20 6f 6e 65 2c 20 77 68 69 63 68 20 73 65 65 6d 73 20 74 6f 20 62 s.the.last.one,.which.seems.to.b
e540 65 20 74 68 65 20 6d 6f 73 74 20 73 65 6e 73 69 62 6c 65 0a 64 65 66 61 75 6c 74 2e 0a 0a 42 65 e.the.most.sensible.default...Be
e560 73 69 64 65 73 20 74 68 6f 73 65 20 65 78 70 6f 72 74 65 72 73 20 61 6e 64 20 63 61 6e 64 69 64 sides.those.exporters.and.candid
e580 61 74 65 20 63 6f 6c 6c 65 63 74 6f 72 73 2c 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 63 6f 6e 73 ate.collectors,.the.=embark-cons
e5a0 75 6c 74 3d 0a 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64 65 73 20 6d 61 6e 79 20 73 75 62 74 6c ult=.package.provides.many.subtl
e5c0 65 20 74 77 65 61 6b 73 20 61 6e 64 20 73 6d 61 6c 6c 20 69 6e 74 65 67 72 61 74 69 6f 6e 73 20 e.tweaks.and.small.integrations.
e5e0 62 65 74 77 65 65 6e 0a 45 6d 62 61 72 6b 20 61 6e 64 20 43 6f 6e 73 75 6c 74 2e 20 53 6f 6d 65 between.Embark.and.Consult..Some
e600 20 65 78 61 6d 70 6c 65 73 20 61 72 65 3a 0a 0a 2d 20 57 68 65 6e 20 75 73 65 64 20 61 73 20 61 .examples.are:..-.When.used.as.a
e620 63 74 69 6f 6e 73 2c 20 74 68 65 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 73 65 61 72 63 68 20 ctions,.the.asynchronous.search.
e640 63 6f 6d 6d 61 6e 64 73 20 77 69 6c 6c 20 73 65 61 72 63 68 0a 20 20 6f 6e 6c 79 20 74 68 65 20 commands.will.search...only.the.
e660 66 69 6c 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 74 68 65 20 74 61 72 67 65 74 73 3a files.associated.to.the.targets:
e680 20 69 66 20 74 68 65 20 74 61 72 67 65 74 73 20 2f 61 72 65 2f 20 66 69 6c 65 73 2c 0a 20 20 69 .if.the.targets./are/.files,...i
e6a0 74 20 73 65 61 72 63 68 65 73 20 74 68 6f 73 65 20 66 69 6c 65 73 3b 20 66 6f 72 20 62 75 66 66 t.searches.those.files;.for.buff
e6c0 65 72 73 20 69 74 20 77 69 6c 6c 20 73 65 61 72 63 68 20 65 69 74 68 65 72 20 74 68 65 0a 20 20 ers.it.will.search.either.the...
e6e0 61 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 20 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 2c associated.file.if.there.is.one,
e700 20 65 6c 73 65 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 62 75 66 66 65 72 27 73 0a .else.all.files.in.the.buffer's.
e720 20 20 3d 64 65 66 61 75 6c 74 2d 64 69 72 65 63 74 6f 72 79 3d 3b 20 66 6f 72 20 62 6f 6f 6b 6d ..=default-directory=;.for.bookm
e740 61 72 6b 73 20 69 74 20 77 69 6c 6c 20 73 65 61 72 63 68 20 74 68 65 20 66 69 6c 65 20 74 68 65 arks.it.will.search.the.file.the
e760 79 20 70 6f 69 6e 74 0a 20 20 74 6f 2c 20 73 61 6d 65 20 66 6f 72 20 45 6d 61 63 73 20 4c 69 73 y.point...to,.same.for.Emacs.Lis
e780 70 20 6c 69 62 72 61 72 69 65 73 2e 20 54 68 69 73 20 69 73 20 70 61 72 74 69 63 75 6c 61 72 6c p.libraries..This.is.particularl
e7a0 79 20 70 6f 77 65 72 66 75 6c 0a 20 20 77 68 65 6e 20 75 73 69 6e 67 20 3d 65 6d 62 61 72 6b 2d y.powerful...when.using.=embark-
e7c0 61 63 74 2d 61 6c 6c 3d 20 74 6f 20 61 63 74 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 66 69 6c 65 act-all=.to.act.on.multiple.file
e7e0 73 20 61 74 20 6f 6e 63 65 2c 20 66 6f 72 0a 20 20 65 78 61 6d 70 6c 65 20 79 6f 75 20 63 61 6e s.at.once,.for...example.you.can
e800 20 75 73 65 20 3d 63 6f 6e 73 75 6c 74 2d 66 69 6e 64 3d 20 74 6f 20 73 65 61 72 63 68 20 61 6d .use.=consult-find=.to.search.am
e820 6f 6e 67 20 66 69 6c 65 20 2f 6e 61 6d 65 73 2f 20 61 6e 64 20 74 68 65 6e 0a 20 20 3d 65 6d 62 ong.file./names/.and.then...=emb
e840 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 61 6e 64 20 3d 63 6f 6e 73 75 6c 74 2d 67 72 65 70 3d 20 ark-act-all=.and.=consult-grep=.
e860 74 6f 20 73 65 61 72 63 68 20 77 69 74 68 69 6e 20 74 68 65 20 6d 61 74 63 68 69 6e 67 20 66 69 to.search.within.the.matching.fi
e880 6c 65 73 2e 0a 0a 20 2d 20 46 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 74 61 72 67 65 74 20 74 79 les....-.For.all.other.target.ty
e8a0 70 65 73 2c 20 74 68 6f 73 65 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 73 65 pes,.those.that.do.not.have.a.se
e8c0 6e 73 69 62 6c 65 0a 20 20 20 6e 6f 74 69 6f 6e 20 6f 66 20 61 73 73 6f 63 69 61 74 65 64 20 66 nsible....notion.of.associated.f
e8e0 69 6c 65 2c 20 61 20 43 6f 6e 73 75 6c 74 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 20 28 61 ile,.a.Consult.search.command.(a
e900 73 79 6e 63 68 72 6f 6e 6f 75 73 0a 20 20 20 6f 72 20 6e 6f 74 29 20 77 69 6c 6c 20 73 65 61 72 synchronous....or.not).will.sear
e920 63 68 20 66 6f 72 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 20 62 75 ch.for.the.text.of.the.target.bu
e940 74 20 6c 65 61 76 65 20 74 68 65 0a 20 20 20 6d 69 6e 69 62 75 66 66 65 72 20 6f 70 65 6e 20 73 t.leave.the....minibuffer.open.s
e960 6f 20 79 6f 75 20 63 61 6e 20 69 6e 74 65 72 61 63 74 20 77 69 74 68 20 74 68 65 20 43 6f 6e 73 o.you.can.interact.with.the.Cons
e980 75 6c 74 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 2d 20 3d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 3d 20 ult.command...-.=consult-imenu=.
e9a0 77 69 6c 6c 20 73 65 61 72 63 68 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 74 20 61 6e 64 20 74 will.search.for.the.target.and.t
e9c0 61 6b 65 20 79 6f 75 20 64 69 72 65 63 74 6c 79 20 74 6f 0a 20 20 74 68 65 20 6c 6f 63 61 74 69 ake.you.directly.to...the.locati
e9e0 6f 6e 20 69 66 20 69 74 20 6d 61 74 63 68 65 73 20 61 20 75 6e 69 71 75 65 20 69 6d 65 6e 75 20 on.if.it.matches.a.unique.imenu.
ea00 65 6e 74 72 79 2c 20 6f 74 68 65 72 77 69 73 65 20 69 74 20 77 69 6c 6c 0a 20 20 6c 65 61 76 65 entry,.otherwise.it.will...leave
ea20 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 6f 70 65 6e 20 73 6f 20 79 6f 75 20 63 61 6e 20 .the.minibuffer.open.so.you.can.
ea40 6e 61 76 69 67 61 74 65 20 61 6d 6f 6e 67 20 74 68 65 20 6d 61 74 63 68 65 73 2e 0a 0a 2a 20 52 navigate.among.the.matches...*.R
ea60 65 6c 61 74 65 64 20 50 61 63 6b 61 67 65 73 0a 0a 54 68 65 72 65 20 61 72 65 20 73 65 76 65 72 elated.Packages..There.are.sever
ea80 61 6c 20 70 61 63 6b 61 67 65 73 20 74 68 61 74 20 6f 66 66 65 72 20 66 75 6e 63 74 69 6f 6e 61 al.packages.that.offer.functiona
eaa0 6c 69 74 79 20 73 69 6d 69 6c 61 72 0a 74 6f 20 45 6d 62 61 72 6b 27 73 2e 20 0a 0a 2d 20 41 63 lity.similar.to.Embark's....-.Ac
eac0 74 69 6e 67 20 6f 6e 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 ting.on.minibuffer.completion.ca
eae0 6e 64 69 64 61 74 65 73 20 3a 3a 20 54 68 65 20 70 6f 70 75 6c 61 72 20 49 76 79 20 61 6e 64 0a ndidates.::.The.popular.Ivy.and.
eb00 20 20 48 65 6c 6d 20 70 61 63 6b 61 67 65 73 20 68 61 76 65 20 73 75 70 70 6f 72 74 20 66 6f 72 ..Helm.packages.have.support.for
eb20 20 61 63 74 69 6e 67 20 6f 6e 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 .acting.on.the.completion.candid
eb40 61 74 65 73 0a 20 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 77 72 69 74 74 65 6e 20 75 73 69 6e 67 ates...of.commands.written.using
eb60 20 74 68 65 69 72 20 41 50 49 73 2c 20 61 6e 64 20 74 68 65 72 65 20 69 73 20 61 6e 20 65 78 74 .their.APIs,.and.there.is.an.ext
eb80 65 6e 73 69 76 65 0a 20 20 65 63 6f 73 79 73 74 65 6d 20 6f 66 20 70 61 63 6b 61 67 65 73 20 6d ensive...ecosystem.of.packages.m
eba0 65 61 6e 74 20 66 6f 72 20 48 65 6c 6d 20 61 6e 64 20 66 6f 72 20 49 76 79 20 28 74 68 65 20 49 eant.for.Helm.and.for.Ivy.(the.I
ebc0 76 79 20 6f 6e 65 73 0a 20 20 75 73 75 61 6c 6c 79 20 68 61 76 65 20 22 63 6f 75 6e 73 65 6c 22 vy.ones...usually.have."counsel"
ebe0 20 69 6e 20 74 68 65 20 6e 61 6d 65 29 20 70 72 6f 76 69 64 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 .in.the.name).providing.commands
ec00 20 61 6e 64 0a 20 20 61 70 70 72 6f 70 72 69 61 74 65 20 61 63 74 69 6f 6e 73 2e 0a 2d 20 41 63 .and...appropriate.actions..-.Ac
ec20 74 69 6e 67 20 6f 6e 20 74 68 69 6e 67 73 20 61 74 20 70 6f 69 6e 74 20 3a 3a 20 54 68 65 20 62 ting.on.things.at.point.::.The.b
ec40 75 69 6c 74 2d 69 6e 20 3d 63 6f 6e 74 65 78 74 2d 6d 65 6e 75 2d 6d 6f 64 65 3d 20 70 72 6f 76 uilt-in.=context-menu-mode=.prov
ec60 69 64 65 73 0a 20 20 61 20 6d 6f 75 73 65 2d 64 72 69 76 65 6e 20 63 6f 6e 74 65 78 74 2d 73 65 ides...a.mouse-driven.context-se
ec80 6e 73 69 74 69 76 65 20 63 6f 6e 66 69 67 75 72 61 62 6c 65 20 6d 65 6e 75 2e 20 54 68 65 20 3d nsitive.configurable.menu..The.=
eca0 64 6f 2d 61 74 2d 70 6f 69 6e 74 3d 0a 20 20 70 61 63 6b 61 67 65 20 62 79 20 50 68 69 6c 69 70 do-at-point=...package.by.Philip
ecc0 20 4b 61 6c 75 64 65 72 63 69 63 20 28 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 47 4e 55 20 45 4c .Kaludercic.(available.on.GNU.EL
ece0 50 41 29 2c 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 0a 20 20 68 61 6e 64 20 69 73 20 6b 65 79 62 PA),.on.the.other...hand.is.keyb
ed00 6f 61 72 64 2d 64 72 69 76 65 6e 2e 0a 2d 20 43 6f 6c 6c 65 63 74 69 6e 67 20 63 6f 6d 70 6c 65 oard-driven..-.Collecting.comple
ed20 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 69 6e 74 6f 20 61 20 62 75 66 66 65 72 20 3a 3a tion.candidates.into.a.buffer.::
ed40 20 54 68 65 20 49 76 79 20 70 61 63 6b 61 67 65 0a 20 20 68 61 73 20 74 68 65 20 63 6f 6d 6d 61 .The.Ivy.package...has.the.comma
ed60 6e 64 20 3d 69 76 79 2d 6f 63 63 75 72 3d 20 77 68 69 63 68 20 69 73 20 73 69 6d 69 6c 61 72 20 nd.=ivy-occur=.which.is.similar.
ed80 74 6f 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 2e 20 41 73 0a 20 20 77 69 74 68 20 49 to.=embark-collect=..As...with.I
eda0 76 79 20 61 63 74 69 6f 6e 73 2c 20 3d 69 76 79 2d 6f 63 63 75 72 3d 20 6f 6e 6c 79 20 77 6f 72 vy.actions,.=ivy-occur=.only.wor
edc0 6b 73 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 77 72 69 74 74 65 6e 20 75 73 69 6e 67 0a 20 20 ks.for.commands.written.using...
ede0 74 68 65 20 49 76 79 20 41 50 49 2e 0a 20 20 0a 2a 20 52 65 73 6f 75 72 63 65 73 0a 0a 49 66 20 the.Ivy.API.....*.Resources..If.
ee00 79 6f 75 20 77 61 6e 74 20 74 6f 20 6c 65 61 72 6e 20 6d 6f 72 65 20 61 62 6f 75 74 20 68 6f 77 you.want.to.learn.more.about.how
ee20 20 6f 74 68 65 72 73 20 68 61 76 65 20 75 73 65 64 20 45 6d 62 61 72 6b 20 68 65 72 65 20 61 72 .others.have.used.Embark.here.ar
ee40 65 0a 73 6f 6d 65 20 6c 69 6e 6b 73 20 74 6f 20 72 65 61 64 3a 0a 0a 2d 20 5b 5b 68 74 74 70 73 e.some.links.to.read:..-.[[https
ee60 3a 2f 2f 6b 61 72 74 68 69 6e 6b 73 2e 63 6f 6d 2f 73 6f 66 74 77 61 72 65 2f 66 69 66 74 65 65 ://karthinks.com/software/fiftee
ee80 6e 2d 77 61 79 73 2d 74 6f 2d 75 73 65 2d 65 6d 62 61 72 6b 2f 5d 5b 46 69 66 74 65 65 6e 20 77 n-ways-to-use-embark/][Fifteen.w
eea0 61 79 73 20 74 6f 20 75 73 65 20 45 6d 62 61 72 6b 5d 5d 2c 20 61 20 62 6c 6f 67 20 70 6f 73 74 ays.to.use.Embark]],.a.blog.post
eec0 20 62 79 20 4b 61 72 74 68 69 6b 20 43 68 69 6b 6d 61 67 61 6c 75 72 2e 0a 2d 20 5b 5b 68 74 74 .by.Karthik.Chikmagalur..-.[[htt
eee0 70 73 3a 2f 2f 70 72 6f 74 65 73 69 6c 61 6f 73 2e 63 6f 6d 2f 64 6f 74 65 6d 61 63 73 2f 5d 5b ps://protesilaos.com/dotemacs/][
ef00 50 72 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 27 73 20 64 6f 74 65 6d 61 63 73 5d 5d Protesilaos.Stavrou's.dotemacs]]
ef20 2c 20 6c 6f 6f 6b 20 66 6f 72 20 74 68 65 20 73 65 63 74 69 6f 6e 20 63 61 6c 6c 65 64 0a 20 20 ,.look.for.the.section.called...
ef40 22 45 78 74 65 6e 64 65 64 20 6d 69 6e 69 62 75 66 66 65 72 20 61 63 74 69 6f 6e 73 20 61 6e 64 "Extended.minibuffer.actions.and
ef60 20 6d 6f 72 65 20 28 65 6d 62 61 72 6b 2e 65 6c 20 61 6e 64 0a 20 20 70 72 6f 74 2d 65 6d 62 61 .more.(embark.el.and...prot-emba
ef80 72 6b 2e 65 6c 29 22 0a 0a 41 6e 64 20 73 6f 6d 65 20 76 69 64 65 6f 73 20 74 6f 20 77 61 74 63 rk.el)"..And.some.videos.to.watc
efa0 68 3a 0a 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 70 72 6f 74 65 73 69 6c 61 6f 73 2e 63 6f 6d 2f h:..-.[[https://protesilaos.com/
efc0 63 6f 64 65 6c 6f 67 2f 32 30 32 31 2d 30 31 2d 30 39 2d 65 6d 61 63 73 2d 65 6d 62 61 72 6b 2d codelog/2021-01-09-emacs-embark-
efe0 65 78 74 72 61 73 2f 5d 5b 45 6d 62 61 72 6b 20 61 6e 64 20 6d 79 20 65 78 74 72 61 73 5d 5d 20 extras/][Embark.and.my.extras]].
f000 62 79 20 50 72 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 2e 0a 2d 20 5b 5b 68 74 74 70 by.Protesilaos.Stavrou..-.[[http
f020 73 3a 2f 2f 79 6f 75 74 75 2e 62 65 2f 71 70 6f 51 69 69 69 6e 43 74 59 5d 5b 45 6d 62 61 72 6b s://youtu.be/qpoQiiinCtY][Embark
f040 20 2d 2d 20 4b 65 79 20 66 65 61 74 75 72 65 73 20 61 6e 64 20 74 77 65 61 6b 73 5d 5d 20 62 79 .--.Key.features.and.tweaks]].by
f060 20 52 61 6f 75 6c 20 43 6f 6d 6e 69 6e 6f 73 20 6f 6e 20 74 68 65 0a 20 20 45 6d 61 63 73 2d 45 .Raoul.Comninos.on.the...Emacs-E
f080 6c 65 6d 65 6e 74 73 20 59 6f 75 54 75 62 65 20 63 68 61 6e 6e 65 6c 2e 0a 2d 20 5b 5b 68 74 74 lements.YouTube.channel..-.[[htt
f0a0 70 73 3a 2f 2f 79 6f 75 74 75 2e 62 65 2f 57 73 78 58 72 31 6e 63 75 6b 59 5d 5b 4c 69 76 65 73 ps://youtu.be/WsxXr1ncukY][Lives
f0c0 74 72 65 61 6d 65 64 3a 20 41 64 64 69 6e 67 20 61 6e 20 45 6d 62 61 72 6b 20 63 6f 6e 74 65 78 treamed:.Adding.an.Embark.contex
f0e0 74 20 61 63 74 69 6f 6e 20 74 6f 20 73 65 6e 64 20 61 20 73 74 72 65 61 6d 0a 20 20 6d 65 73 73 t.action.to.send.a.stream...mess
f100 61 67 65 5d 5d 20 62 79 20 53 61 63 68 61 20 43 68 75 61 2e 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f age]].by.Sacha.Chua..-.[[https:/
f120 2f 79 6f 75 74 75 2e 62 65 2f 71 6b 32 49 73 5f 73 43 38 4c 6b 5d 5b 53 79 73 74 65 6d 20 43 72 /youtu.be/qk2Is_sC8Lk][System.Cr
f140 61 66 74 65 72 73 20 4c 69 76 65 21 20 2d 20 54 68 65 20 4d 61 6e 79 20 55 73 65 73 20 6f 66 20 afters.Live!.-.The.Many.Uses.of.
f160 45 6d 62 61 72 6b 5d 5d 20 62 79 20 44 61 76 69 64 20 57 69 6c 73 6f 6e 2e 0a 2d 20 5b 5b 68 74 Embark]].by.David.Wilson..-.[[ht
f180 74 70 73 3a 2f 2f 79 6f 75 74 75 2e 62 65 2f 35 66 66 62 32 61 74 32 64 37 77 5d 5b 55 73 69 6e tps://youtu.be/5ffb2at2d7w][Usin
f1a0 67 20 45 6d 61 63 73 20 45 70 69 73 6f 64 65 20 38 30 20 2d 20 56 65 72 74 69 63 6f 2c 20 4d 61 g.Emacs.Episode.80.-.Vertico,.Ma
f1c0 72 67 69 6e 61 6c 69 61 2c 20 43 6f 6e 73 75 6c 74 20 61 6e 64 20 45 6d 62 61 72 6b 5d 5d 20 62 rginalia,.Consult.and.Embark]].b
f1e0 79 0a 20 20 4d 69 6b 65 20 5a 61 6d 61 6e 73 6b 79 2e 0a 0a 2a 20 43 6f 6e 74 72 69 62 75 74 69 y...Mike.Zamansky...*.Contributi
f200 6f 6e 73 0a 0a 43 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 74 6f 20 45 6d 62 61 72 6b 20 61 72 65 ons..Contributions.to.Embark.are
f220 20 76 65 72 79 20 77 65 6c 63 6f 6d 65 2e 20 54 68 65 72 65 20 69 73 20 61 20 5b 5b 68 74 74 70 .very.welcome..There.is.a.[[http
f240 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 69 s://github.com/oantolin/embark/i
f260 73 73 75 65 73 2f 39 35 5d 5b 77 69 73 68 20 6c 69 73 74 5d 5d 20 66 6f 72 0a 61 63 74 69 6f 6e ssues/95][wish.list]].for.action
f280 73 2c 20 74 61 72 67 65 74 20 66 69 6e 64 65 72 73 2c 20 63 61 6e 64 69 64 61 74 65 20 63 6f 6c s,.target.finders,.candidate.col
f2a0 6c 65 63 74 6f 72 73 20 61 6e 64 20 65 78 70 6f 72 74 65 72 73 2e 20 46 6f 72 20 6f 74 68 65 72 lectors.and.exporters..For.other
f2c0 0a 69 64 65 61 73 20 79 6f 75 20 68 61 76 65 20 66 6f 72 20 45 6d 62 61 72 6b 2c 20 66 65 65 6c .ideas.you.have.for.Embark,.feel
f2e0 20 66 72 65 65 20 74 6f 20 6f 70 65 6e 20 61 6e 20 69 73 73 75 65 20 6f 6e 20 74 68 65 20 5b 5b .free.to.open.an.issue.on.the.[[
f300 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 https://github.com/oantolin/emba
f320 72 6b 2f 69 73 73 75 65 73 5d 5b 69 73 73 75 65 0a 74 72 61 63 6b 65 72 5d 5d 2e 20 41 6e 79 20 rk/issues][issue.tracker]]..Any.
f340 6e 65 61 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 72 69 63 6b 73 20 79 6f 75 20 66 69 neat.configuration.tricks.you.fi
f360 6e 64 20 6d 69 67 68 74 20 62 65 20 61 20 67 6f 6f 64 20 66 69 74 0a 66 6f 72 20 74 68 65 20 5b nd.might.be.a.good.fit.for.the.[
f380 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 [https://github.com/oantolin/emb
f3a0 61 72 6b 2f 77 69 6b 69 5d 5b 77 69 6b 69 5d 5d 2e 0a 0a 43 6f 64 65 20 63 6f 6e 74 72 69 62 75 ark/wiki][wiki]]...Code.contribu
f3c0 74 69 6f 6e 73 20 61 72 65 20 76 65 72 79 20 77 65 6c 63 6f 6d 65 20 74 6f 6f 2c 20 62 75 74 20 tions.are.very.welcome.too,.but.
f3e0 73 69 6e 63 65 20 45 6d 62 61 72 6b 20 69 73 20 6e 6f 77 20 6f 6e 0a 47 4e 55 20 45 4c 50 41 2c since.Embark.is.now.on.GNU.ELPA,
f400 20 63 6f 70 79 72 69 67 68 74 20 61 73 73 69 67 6e 6d 65 6e 74 20 74 6f 20 74 68 65 20 46 53 46 .copyright.assignment.to.the.FSF
f420 20 69 73 20 72 65 71 75 69 72 65 64 20 62 65 66 6f 72 65 20 79 6f 75 20 63 61 6e 0a 63 6f 6e 74 .is.required.before.you.can.cont
f440 72 69 62 75 74 65 20 63 6f 64 65 2e 0a 0a 2a 20 41 63 6b 6e 6f 77 6c 65 64 67 6d 65 6e 74 73 0a ribute.code...*.Acknowledgments.
f460 0a 57 68 69 6c 65 20 49 2c 20 4f 6d 61 72 20 41 6e 74 6f 6c c3 ad 6e 20 43 61 6d 61 72 65 6e 61 .While.I,.Omar.Antol..n.Camarena
f480 2c 20 68 61 76 65 20 77 72 69 74 74 65 6e 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 45 6d 62 61 72 ,.have.written.most.of.the.Embar
f4a0 6b 20 63 6f 64 65 0a 61 6e 64 20 72 65 6d 61 69 6e 20 76 65 72 79 20 73 74 75 62 62 6f 72 6e 20 k.code.and.remain.very.stubborn.
f4c0 61 62 6f 75 74 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 64 65 73 69 67 6e 20 64 65 63 69 73 69 6f about.some.of.the.design.decisio
f4e0 6e 73 2c 20 45 6d 62 61 72 6b 0a 68 61 73 20 72 65 63 65 69 76 65 64 20 73 75 62 73 74 61 6e 74 ns,.Embark.has.received.substant
f500 69 61 6c 20 68 65 6c 70 20 66 72 6f 6d 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 6f 74 68 65 72 20 ial.help.from.a.number.of.other.
f520 70 65 6f 70 6c 65 20 77 68 69 63 68 20 74 68 69 73 0a 64 6f 63 75 6d 65 6e 74 20 68 61 73 20 6e people.which.this.document.has.n
f540 65 67 6c 65 63 74 65 64 20 74 6f 20 6d 65 6e 74 69 6f 6e 20 66 6f 72 20 66 61 72 20 74 6f 6f 20 eglected.to.mention.for.far.too.
f560 6c 6f 6e 67 2e 20 49 6e 20 70 61 72 74 69 63 75 6c 61 72 2c 0a 44 61 6e 69 65 6c 20 4d 65 6e 64 long..In.particular,.Daniel.Mend
f580 6c 65 72 20 68 61 73 20 62 65 65 6e 20 61 62 73 6f 6c 75 74 65 6c 79 20 69 6e 76 61 6c 75 61 62 ler.has.been.absolutely.invaluab
f5a0 6c 65 2c 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 73 65 76 65 72 61 6c 0a 69 6d 70 6f 72 74 61 le,.implementing.several.importa
f5c0 6e 74 20 66 65 61 74 75 72 65 73 2c 20 61 6e 64 20 70 72 6f 76 69 64 69 6e 67 20 61 20 6c 6f 74 nt.features,.and.providing.a.lot
f5e0 20 6f 66 20 75 73 65 66 75 6c 20 61 64 76 69 63 65 2e 0a 0a 43 6f 64 65 20 63 6f 6e 74 72 69 62 .of.useful.advice...Code.contrib
f600 75 74 69 6f 6e 73 3a 0a 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f utions:..-.[[https://github.com/
f620 6d 69 6e 61 64 5d 5b 44 61 6e 69 65 6c 20 4d 65 6e 64 6c 65 72 5d 5d 0a 2d 20 5b 5b 68 74 74 70 minad][Daniel.Mendler]].-.[[http
f640 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 63 6c 65 6d 65 72 61 2f 5d 5b 43 6c 65 6d 65 6e 73 s://github.com/clemera/][Clemens
f660 20 52 61 64 65 72 6d 61 63 68 65 72 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 63 6f 64 65 62 .Radermacher]].-.[[https://codeb
f680 65 72 67 2e 6f 72 67 2f 6a 61 6f 2f 5d 5b 4a 6f 73 c3 a9 20 41 6e 74 6f 6e 69 6f 20 4f 72 74 65 erg.org/jao/][Jos...Antonio.Orte
f6a0 67 61 20 52 75 69 7a 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d ga.Ruiz]].-.[[https://github.com
f6c0 2f 69 79 65 66 72 61 74 5d 5b 49 74 61 69 20 59 2e 20 45 66 72 61 74 5d 5d 0a 2d 20 5b 5b 68 74 /iyefrat][Itai.Y..Efrat]].-.[[ht
f6e0 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 61 31 33 5d 5b 61 31 33 5d 5d 0a 2d 20 5b 5b tps://github.com/a13][a13]].-.[[
f700 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 61 6b 61 6e 61 6b 61 65 76 61 6e 67 https://github.com/jakanakaevang
f720 65 6c 69 5d 5b 6a 61 6b 61 6e 61 6b 61 65 76 61 6e 67 65 6c 69 5d 5d 0a 2d 20 5b 5b 68 74 74 70 eli][jakanakaevangeli]].-.[[http
f740 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 68 61 6b 61 6d 5d 5b 6d 69 68 61 6b 61 6d 5d s://github.com/mihakam][mihakam]
f760 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6c 65 75 6e 67 62 6b ].-.[[https://github.com/leungbk
f780 5d 5b 42 72 69 61 6e 20 4c 65 75 6e 67 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 ][Brian.Leung]].-.[[https://gith
f7a0 75 62 2e 63 6f 6d 2f 6b 61 72 74 68 69 6e 6b 5d 5b 4b 61 72 74 68 69 6b 20 43 68 69 6b 6d 61 67 ub.com/karthink][Karthik.Chikmag
f7c0 61 6c 75 72 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 72 6f alur]].-.[[https://github.com/ro
f7e0 73 68 61 6e 73 68 61 72 69 66 66 5d 5b 52 6f 73 68 61 6e 20 53 68 61 72 69 66 66 5d 5d 0a 2d 20 shanshariff][Roshan.Shariff]].-.
f800 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 63 6f 6e 64 79 30 39 31 39 5d 5b [[https://github.com/condy0919][
f820 63 6f 6e 64 79 30 39 31 39 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 condy0919]].-.[[https://github.c
f840 6f 6d 2f 44 61 6d 69 65 6e 43 61 73 73 6f 75 5d 5b 44 61 6d 69 65 6e 20 43 61 73 73 6f 75 5d 5d om/DamienCassou][Damien.Cassou]]
f860 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 4a 69 6d 44 42 68 5d 5b .-.[[https://github.com/JimDBh][
f880 4a 69 6d 44 42 68 5d 5d 0a 0a 41 64 76 69 63 65 20 61 6e 64 20 75 73 65 66 75 6c 20 64 69 73 63 JimDBh]]..Advice.and.useful.disc
f8a0 75 73 73 69 6f 6e 73 3a 0a 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d ussions:..-.[[https://github.com
f8c0 2f 6d 69 6e 61 64 5d 5b 44 61 6e 69 65 6c 20 4d 65 6e 64 6c 65 72 5d 5d 0a 2d 20 5b 5b 68 74 74 /minad][Daniel.Mendler]].-.[[htt
f8e0 70 73 3a 2f 2f 67 69 74 6c 61 62 2e 63 6f 6d 2f 70 72 6f 74 65 73 69 6c 61 6f 73 2f 5d 5b 50 72 ps://gitlab.com/protesilaos/][Pr
f900 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f otesilaos.Stavrou]].-.[[https://
f920 67 69 74 68 75 62 2e 63 6f 6d 2f 63 6c 65 6d 65 72 61 2f 5d 5b 43 6c 65 6d 65 6e 73 20 52 61 64 github.com/clemera/][Clemens.Rad
f940 65 72 6d 61 63 68 65 72 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f ermacher]].-.[[https://github.co
f960 6d 2f 68 6d 65 6c 6d 61 6e 2f 5d 5b 48 6f 77 61 72 64 20 4d 65 6c 6d 61 6e 5d 5d 0a 2d 20 5b 5b m/hmelman/][Howard.Melman]].-.[[
f980 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 61 73 74 6f 66 66 5d 5b 41 75 67 75 73 https://github.com/astoff][Augus
f9a0 74 6f 20 53 74 6f 66 66 65 6c 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e to.Stoffel]].-.[[https://github.
f9c0 63 6f 6d 2f 62 64 61 72 63 75 73 5d 5b 42 72 75 63 65 20 64 27 41 72 63 75 73 5d 5d 0a 2d 20 5b com/bdarcus][Bruce.d'Arcus]].-.[
f9e0 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 64 74 73 6d 69 74 68 5d 5b 4a 44 [https://github.com/jdtsmith][JD
fa00 20 53 6d 69 74 68 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f .Smith]].-.[[https://github.com/
fa20 6b 61 72 74 68 69 6e 6b 5d 5b 4b 61 72 74 68 69 6b 20 43 68 69 6b 6d 61 67 61 6c 75 72 5d 5d 0a karthink][Karthik.Chikmagalur]].
fa40 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 61 6b 61 6e 61 6b 61 65 -.[[https://github.com/jakanakae
fa60 76 61 6e 67 65 6c 69 5d 5b 6a 61 6b 61 6e 61 6b 61 65 76 61 6e 67 65 6c 69 5d 5d 0a 2d 20 5b 5b vangeli][jakanakaevangeli]].-.[[
fa80 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 69 79 65 66 72 61 74 5d 5b 49 74 61 69 https://github.com/iyefrat][Itai
faa0 20 59 2e 20 45 66 72 61 74 5d 5d 0a 2d 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 .Y..Efrat]].-.[[https://github.c
fac0 6f 6d 2f 6d 6f 68 6b 61 6c 65 5d 5b 4d 6f 68 73 69 6e 20 4b 61 6c 65 65 6d 5d 5d 0a 00 00 00 00 om/mohkale][Mohsin.Kaleem]].....
fae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fb00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fb20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fb40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fb60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fb80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fbc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fbe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fc00 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 52 45 41 44 4d 45 2d 65 6c 70 61 00 00 embark-consult-1.1/README-elpa..
fc20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fc40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fc60 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
fc80 30 32 30 36 37 32 33 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 34 35 35 31 00 20 30 00 00 00 0206723.00000000000.014551..0...
fca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fcc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fd00 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
fd20 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
fd40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fd60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fd80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fda0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fdc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fde0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
fe00 20 20 20 20 20 20 20 20 20 20 20 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 ................................
fe20 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 ................................
fe40 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 ................................
fe60 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 ................................
fe80 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 ................................
fea0 81 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 45 4d 42 41 52 4b 3a 20 45 4d 41 43 53 20 4d 49 ................EMBARK:.EMACS.MI
fec0 4e 49 2d 42 55 46 46 45 52 20 41 43 54 49 4f 4e 53 20 52 4f 4f 54 45 44 20 49 4e 0a 20 20 20 20 NI-BUFFER.ACTIONS.ROOTED.IN.....
fee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4b 45 59 4d ............................KEYM
ff00 41 50 53 0a 20 20 20 20 20 20 20 20 20 20 20 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 APS.............................
ff20 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 ................................
ff40 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 ................................
ff60 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 ................................
ff80 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 94 81 e2 ................................
ffa0 94 81 e2 94 81 0a 0a 0a 0a 0a 0a 31 20 4f 76 65 72 76 69 65 77 0a e2 95 90 e2 95 90 e2 95 90 e2 ...........1.Overview...........
ffc0 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 0a 0a 20 20 45 6d 62 61 72 6b 20 6d ........................Embark.m
ffe0 61 6b 65 73 20 69 74 20 65 61 73 79 20 74 6f 20 63 68 6f 6f 73 65 20 61 20 63 6f 6d 6d 61 6e 64 akes.it.easy.to.choose.a.command
10000 20 74 6f 20 72 75 6e 20 62 61 73 65 64 20 6f 6e 20 77 68 61 74 20 69 73 20 6e 65 61 72 0a 20 20 .to.run.based.on.what.is.near...
10020 70 6f 69 6e 74 2c 20 62 6f 74 68 20 64 75 72 69 6e 67 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 point,.both.during.a.minibuffer.
10040 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 65 73 73 69 6f 6e 20 28 69 6e 20 61 20 77 61 79 20 66 61 6d completion.session.(in.a.way.fam
10060 69 6c 69 61 72 0a 20 20 74 6f 20 48 65 6c 6d 20 6f 72 20 43 6f 75 6e 73 65 6c 20 75 73 65 72 73 iliar...to.Helm.or.Counsel.users
10080 29 20 61 6e 64 20 69 6e 20 6e 6f 72 6d 61 6c 20 62 75 66 66 65 72 73 2e 20 42 69 6e 64 20 74 68 ).and.in.normal.buffers..Bind.th
100a0 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 74 6f 20 61 20 6b 65 e.command...`embark-act'.to.a.ke
100c0 79 20 61 6e 64 20 69 74 20 61 63 74 73 20 6c 69 6b 65 20 70 72 65 66 69 78 2d 6b 65 79 20 66 6f y.and.it.acts.like.prefix-key.fo
100e0 72 20 61 20 6b 65 79 6d 61 70 20 6f 66 0a 20 20 2f 61 63 74 69 6f 6e 73 2f 20 28 63 6f 6d 6d 61 r.a.keymap.of.../actions/.(comma
10100 6e 64 73 29 20 72 65 6c 65 76 61 6e 74 20 74 6f 20 74 68 65 20 2f 74 61 72 67 65 74 2f 20 61 72 nds).relevant.to.the./target/.ar
10120 6f 75 6e 64 20 70 6f 69 6e 74 2e 20 57 69 74 68 20 70 6f 69 6e 74 0a 20 20 6f 6e 20 61 6e 20 55 ound.point..With.point...on.an.U
10140 52 4c 20 69 6e 20 61 20 62 75 66 66 65 72 20 79 6f 75 20 63 61 6e 20 6f 70 65 6e 20 74 68 65 20 RL.in.a.buffer.you.can.open.the.
10160 55 52 4c 20 69 6e 20 61 20 62 72 6f 77 73 65 72 20 6f 72 20 65 77 77 20 6f 72 0a 20 20 64 6f 77 URL.in.a.browser.or.eww.or...dow
10180 6e 6c 6f 61 64 20 74 68 65 20 66 69 6c 65 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 2e 20 49 66 20 nload.the.file.it.points.to..If.
101a0 77 68 69 6c 65 20 73 77 69 74 63 68 69 6e 67 20 62 75 66 66 65 72 73 20 79 6f 75 20 73 70 6f 74 while.switching.buffers.you.spot
101c0 20 61 6e 0a 20 20 6f 6c 64 20 6f 6e 65 2c 20 79 6f 75 20 63 61 6e 20 6b 69 6c 6c 20 69 74 20 72 .an...old.one,.you.can.kill.it.r
101e0 69 67 68 74 20 74 68 65 72 65 20 61 6e 64 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 73 65 6c 65 63 ight.there.and.continue.to.selec
10200 74 20 61 6e 6f 74 68 65 72 2e 0a 20 20 45 6d 62 61 72 6b 20 63 6f 6d 65 73 20 70 72 65 63 6f 6e t.another....Embark.comes.precon
10220 66 69 67 75 72 65 64 20 77 69 74 68 20 6f 76 65 72 20 61 20 68 75 6e 64 72 65 64 20 61 63 74 69 figured.with.over.a.hundred.acti
10240 6f 6e 73 20 66 6f 72 20 63 6f 6d 6d 6f 6e 0a 20 20 74 79 70 65 73 20 6f 66 20 74 61 72 67 65 74 ons.for.common...types.of.target
10260 73 20 73 75 63 68 20 61 73 20 66 69 6c 65 73 2c 20 62 75 66 66 65 72 73 2c 20 69 64 65 6e 74 69 s.such.as.files,.buffers,.identi
10280 66 69 65 72 73 2c 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 73 2c 0a 20 20 73 65 6e 74 65 6e 63 65 fiers,.s-expressions,...sentence
102a0 73 3b 20 61 6e 64 20 69 74 20 69 73 20 65 61 73 79 20 74 6f 20 61 64 64 20 6d 6f 72 65 20 61 63 s;.and.it.is.easy.to.add.more.ac
102c0 74 69 6f 6e 73 20 61 6e 64 20 6d 6f 72 65 20 74 61 72 67 65 74 20 74 79 70 65 73 2e 0a 20 20 45 tions.and.more.target.types....E
102e0 6d 62 61 72 6b 20 63 61 6e 20 61 6c 73 6f 20 63 6f 6c 6c 65 63 74 20 61 6c 6c 20 74 68 65 20 63 mbark.can.also.collect.all.the.c
10300 61 6e 64 69 64 61 74 65 73 20 69 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 74 6f 20 61 6e 0a andidates.in.a.minibuffer.to.an.
10320 20 20 6f 63 63 75 72 2d 6c 69 6b 65 20 62 75 66 66 65 72 20 6f 72 20 65 78 70 6f 72 74 20 74 68 ..occur-like.buffer.or.export.th
10340 65 6d 20 74 6f 20 61 20 62 75 66 66 65 72 20 69 6e 20 61 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 73 em.to.a.buffer.in.a.major-mode.s
10360 70 65 63 69 66 69 63 0a 20 20 74 6f 20 74 68 65 20 74 79 70 65 20 6f 66 20 63 61 6e 64 69 64 61 pecific...to.the.type.of.candida
10380 74 65 73 2c 20 73 75 63 68 20 61 73 20 64 69 72 65 64 20 66 6f 72 20 61 20 73 65 74 20 6f 66 20 tes,.such.as.dired.for.a.set.of.
103a0 66 69 6c 65 73 2c 20 69 62 75 66 66 65 72 0a 20 20 66 6f 72 20 61 20 73 65 74 20 6f 66 20 62 75 files,.ibuffer...for.a.set.of.bu
103c0 66 66 65 72 73 2c 20 6f 72 20 63 75 73 74 6f 6d 69 7a 65 20 66 6f 72 20 61 20 73 65 74 20 6f 66 ffers,.or.customize.for.a.set.of
103e0 20 76 61 72 69 61 62 6c 65 73 2e 0a 0a 0a 31 2e 31 20 41 63 74 69 6e 67 20 6f 6e 20 74 61 72 67 .variables....1.1.Acting.on.targ
10400 65 74 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ets.............................
10420 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
10440 e2 94 80 0a 0a 20 20 59 6f 75 20 63 61 6e 20 74 68 69 6e 6b 20 6f 66 20 60 65 6d 62 61 72 6b 2d .......You.can.think.of.`embark-
10460 61 63 74 27 20 61 73 20 61 20 6b 65 79 62 6f 61 72 64 2d 62 61 73 65 64 20 76 65 72 73 69 6f 6e act'.as.a.keyboard-based.version
10480 20 6f 66 20 61 0a 20 20 72 69 67 68 74 2d 63 6c 69 63 6b 20 63 6f 6e 74 65 78 74 75 61 6c 20 6d .of.a...right-click.contextual.m
104a0 65 6e 75 2e 20 54 68 65 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 63 6f 6d 6d 61 6e 64 20 28 77 enu..The.`embark-act'.command.(w
104c0 68 69 63 68 20 79 6f 75 0a 20 20 73 68 6f 75 6c 64 20 62 69 6e 64 20 74 6f 20 61 20 63 6f 6e 76 hich.you...should.bind.to.a.conv
104e0 65 6e 69 65 6e 74 20 6b 65 79 29 2c 20 61 63 74 73 20 61 73 20 61 20 70 72 65 66 69 78 20 66 6f enient.key),.acts.as.a.prefix.fo
10500 72 20 61 20 6b 65 79 6d 61 70 0a 20 20 6f 66 66 65 72 69 6e 67 20 79 6f 75 20 72 65 6c 65 76 61 r.a.keymap...offering.you.releva
10520 6e 74 20 2f 61 63 74 69 6f 6e 73 2f 20 74 6f 20 75 73 65 20 6f 6e 20 61 20 2f 74 61 72 67 65 74 nt./actions/.to.use.on.a./target
10540 2f 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 0a 20 20 63 6f 6e 74 65 78 74 3a 0a 0a /.determined.by.the...context:..
10560 20 20 e2 80 a2 20 49 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 74 68 65 20 74 61 72 ......In.the.minibuffer,.the.tar
10580 67 65 74 20 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 6f 70 20 63 6f 6d 70 6c 65 74 69 6f get.is.the.current.top.completio
105a0 6e 0a 20 20 20 20 63 61 6e 64 69 64 61 74 65 2e 0a 20 20 e2 80 a2 20 49 6e 20 74 68 65 20 60 2a n.....candidate........In.the.`*
105c0 43 6f 6d 70 6c 65 74 69 6f 6e 73 2a 27 20 62 75 66 66 65 72 20 74 68 65 20 74 61 72 67 65 74 20 Completions*'.buffer.the.target.
105e0 69 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 61 74 20 70 6f 69 6e 74 2e 0a 20 20 e2 80 is.the.completion.at.point......
10600 a2 20 49 6e 20 61 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 2c 20 74 68 65 20 74 61 72 67 65 ..In.a.regular.buffer,.the.targe
10620 74 20 69 73 20 74 68 65 20 72 65 67 69 6f 6e 20 69 66 20 61 63 74 69 76 65 2c 20 6f 72 20 65 6c t.is.the.region.if.active,.or.el
10640 73 65 20 74 68 65 0a 20 20 20 20 66 69 6c 65 2c 20 73 79 6d 62 6f 6c 2c 20 55 52 4c 2c 20 73 2d se.the.....file,.symbol,.URL,.s-
10660 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 64 65 66 75 6e 20 61 74 20 70 6f 69 6e 74 2e 0a 0a 20 expression.or.defun.at.point....
10680 20 4d 75 6c 74 69 70 6c 65 20 74 61 72 67 65 74 73 20 63 61 6e 20 62 65 20 70 72 65 73 65 6e 74 .Multiple.targets.can.be.present
106a0 20 61 74 20 74 68 65 20 73 61 6d 65 20 6c 6f 63 61 74 69 6f 6e 20 61 6e 64 20 79 6f 75 20 63 61 .at.the.same.location.and.you.ca
106c0 6e 20 63 79 63 6c 65 0a 20 20 62 65 74 77 65 65 6e 20 74 68 65 6d 20 62 79 20 72 65 70 65 61 74 n.cycle...between.them.by.repeat
106e0 69 6e 67 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 6b 65 79 20 62 69 6e 64 69 6e 67 ing.the.`embark-act'.key.binding
10700 2e 20 54 68 65 20 74 79 70 65 20 6f 66 0a 20 20 61 63 74 69 6f 6e 73 20 6f 66 66 65 72 65 64 20 ..The.type.of...actions.offered.
10720 64 65 70 65 6e 64 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 depend.on.the.type.of.the.target
10740 2e 20 48 65 72 65 20 69 73 20 61 20 73 61 6d 70 6c 65 20 6f 66 0a 20 20 61 20 66 65 77 20 6f 66 ..Here.is.a.sample.of...a.few.of
10760 20 74 68 65 20 61 63 74 69 6f 6e 73 20 6f 66 66 65 72 65 64 20 69 6e 20 74 68 65 20 64 65 66 61 .the.actions.offered.in.the.defa
10780 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 20 20 e2 80 a2 20 46 6f 72 20 66 69 ult.configuration:........For.fi
107a0 6c 65 73 20 79 6f 75 20 67 65 74 20 6f 66 66 65 72 65 64 20 61 63 74 69 6f 6e 73 20 6c 69 6b 65 les.you.get.offered.actions.like
107c0 20 64 65 6c 65 74 69 6e 67 2c 20 63 6f 70 79 69 6e 67 2c 20 72 65 6e 61 6d 69 6e 67 2c 0a 20 20 .deleting,.copying,.renaming,...
107e0 20 20 76 69 73 69 74 69 6e 67 20 69 6e 20 61 6e 6f 74 68 65 72 20 77 69 6e 64 6f 77 2c 20 72 75 ..visiting.in.another.window,.ru
10800 6e 6e 69 6e 67 20 61 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 6f 6e 20 74 68 65 20 66 69 6c nning.a.shell.command.on.the.fil
10820 65 2c 0a 20 20 20 20 65 74 63 2e 0a 20 20 e2 80 a2 20 46 6f 72 20 62 75 66 66 65 72 73 20 74 68 e,.....etc........For.buffers.th
10840 65 20 61 63 74 69 6f 6e 73 20 69 6e 63 6c 75 64 65 20 73 77 69 74 63 68 69 6e 67 20 74 6f 20 6f e.actions.include.switching.to.o
10860 72 20 6b 69 6c 6c 69 6e 67 20 74 68 65 20 62 75 66 66 65 72 2e 0a 20 20 e2 80 a2 20 46 6f 72 20 r.killing.the.buffer........For.
10880 70 61 63 6b 61 67 65 20 6e 61 6d 65 73 20 74 68 65 20 61 63 74 69 6f 6e 73 20 69 6e 63 6c 75 64 package.names.the.actions.includ
108a0 65 20 69 6e 73 74 61 6c 6c 69 6e 67 2c 20 72 65 6d 6f 76 69 6e 67 20 6f 72 0a 20 20 20 20 76 69 e.installing,.removing.or.....vi
108c0 73 69 74 69 6e 67 20 74 68 65 20 68 6f 6d 65 70 61 67 65 2e 0a 20 20 e2 80 a2 20 46 6f 72 20 45 siting.the.homepage........For.E
108e0 6d 61 63 73 20 4c 69 73 70 20 73 79 6d 62 6f 6c 73 20 74 68 65 20 61 63 74 69 6f 6e 73 20 69 6e macs.Lisp.symbols.the.actions.in
10900 63 6c 75 64 65 20 66 69 6e 64 69 6e 67 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 2c 0a 20 20 clude.finding.the.definition,...
10920 20 20 6c 6f 6f 6b 69 6e 67 20 75 70 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 65 76 61 6c ..looking.up.documentation,.eval
10940 75 61 74 69 6e 67 20 28 77 68 69 63 68 20 66 6f 72 20 61 20 76 61 72 69 61 62 6c 65 0a 20 20 20 uating.(which.for.a.variable....
10960 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 73 68 6f 77 73 20 74 68 65 20 76 61 6c 75 65 2c 20 62 75 .immediately.shows.the.value,.bu
10980 74 20 66 6f 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 6c 65 74 73 20 79 6f 75 20 70 61 73 73 20 69 t.for.a.function.lets.you.pass.i
109a0 74 0a 20 20 20 20 73 6f 6d 65 20 61 72 67 75 6d 65 6e 74 73 20 66 69 72 73 74 29 2e 20 54 68 65 t.....some.arguments.first)..The
109c0 72 65 20 61 72 65 20 73 6f 6d 65 20 61 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 re.are.some.actions.specific.to.
109e0 76 61 72 69 61 62 6c 65 73 2c 0a 20 20 20 20 73 75 63 68 20 61 73 20 73 65 74 74 69 6e 67 20 74 variables,.....such.as.setting.t
10a00 68 65 20 76 61 6c 75 65 20 64 69 72 65 63 74 6c 79 20 6f 72 20 74 68 6f 75 67 68 20 74 68 65 20 he.value.directly.or.though.the.
10a20 63 75 73 74 6f 6d 69 7a 65 20 73 79 73 74 65 6d 2c 0a 20 20 20 20 61 6e 64 20 73 6f 6d 65 20 61 customize.system,.....and.some.a
10a40 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 2c 20 73 75 63 ctions.specific.to.commands,.suc
10a60 68 20 61 73 20 62 69 6e 64 69 6e 67 20 69 74 20 74 6f 20 61 20 6b 65 79 2e 0a 0a 20 20 42 79 20 h.as.binding.it.to.a.key.....By.
10a80 64 65 66 61 75 6c 74 20 77 68 65 6e 20 79 6f 75 20 75 73 65 20 60 65 6d 62 61 72 6b 2d 61 63 74 default.when.you.use.`embark-act
10aa0 27 20 69 66 20 79 6f 75 20 64 6f 6e 27 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 73 65 6c 65 63 '.if.you.don't.immediately.selec
10ac0 74 0a 20 20 61 6e 20 61 63 74 69 6f 6e 2c 20 61 66 74 65 72 20 61 20 73 68 6f 72 74 20 64 65 6c t...an.action,.after.a.short.del
10ae0 61 79 20 45 6d 62 61 72 6b 20 77 69 6c 6c 20 70 6f 70 20 75 70 20 61 20 62 75 66 66 65 72 20 73 ay.Embark.will.pop.up.a.buffer.s
10b00 68 6f 77 69 6e 67 20 61 0a 20 20 6c 69 73 74 20 6f 66 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 74 howing.a...list.of.actions.and.t
10b20 68 65 69 72 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e heir.corresponding.key.bindings.
10b40 20 49 66 20 79 6f 75 20 61 72 65 20 75 73 69 6e 67 0a 20 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 .If.you.are.using...`embark-act'
10b60 20 6f 75 74 73 69 64 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 45 6d 62 61 72 6b 20 .outside.the.minibuffer,.Embark.
10b80 77 69 6c 6c 20 61 6c 73 6f 20 68 69 67 68 6c 69 67 68 74 20 74 68 65 0a 20 20 63 75 72 72 65 6e will.also.highlight.the...curren
10ba0 74 20 74 61 72 67 65 74 2e 20 54 68 65 73 65 20 62 65 68 61 76 69 6f 72 73 20 61 72 65 20 63 6f t.target..These.behaviors.are.co
10bc0 6e 66 69 67 75 72 61 62 6c 65 20 76 69 61 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 20 20 60 65 nfigurable.via.the.variable...`e
10be0 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 27 2e 20 49 6e 73 74 65 61 64 20 6f 66 20 73 65 mbark-indicators'..Instead.of.se
10c00 6c 65 63 74 69 6e 67 20 61 6e 20 61 63 74 69 6f 6e 20 76 69 61 20 69 74 73 20 6b 65 79 0a 20 20 lecting.an.action.via.its.key...
10c20 62 69 6e 64 69 6e 67 2c 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 69 74 20 62 79 20 6e 61 binding,.you.can.select.it.by.na
10c40 6d 65 20 77 69 74 68 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 62 79 20 74 79 70 69 6e 67 20 60 43 2d me.with.completion.by.typing.`C-
10c60 68 27 0a 20 20 61 66 74 65 72 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 2e 0a 0a 20 20 45 76 65 72 h'...after.`embark-act'.....Ever
10c80 79 74 68 69 6e 67 20 69 73 20 65 61 73 69 6c 79 20 63 6f 6e 66 69 67 75 72 61 62 6c 65 3a 20 64 ything.is.easily.configurable:.d
10ca0 65 74 65 72 6d 69 6e 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 2c 0a 20 etermining.the.current.target,..
10cc0 20 63 6c 61 73 73 69 66 79 69 6e 67 20 69 74 2c 20 61 6e 64 20 64 65 63 69 64 69 6e 67 20 77 68 .classifying.it,.and.deciding.wh
10ce0 69 63 68 20 61 63 74 69 6f 6e 73 20 61 72 65 20 6f 66 66 65 72 65 64 20 66 6f 72 20 65 61 63 68 ich.actions.are.offered.for.each
10d00 20 74 79 70 65 0a 20 20 69 6e 20 74 68 65 20 63 6c 61 73 73 69 66 69 63 61 74 69 6f 6e 2e 20 54 .type...in.the.classification..T
10d20 68 65 20 61 62 6f 76 65 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 6a 75 73 74 20 6d 65 6e 74 69 he.above.introduction.just.menti
10d40 6f 6e 73 20 70 61 72 74 20 6f 66 0a 20 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 ons.part.of...the.default.config
10d60 75 72 61 74 69 6f 6e 2e 0a 0a 20 20 43 6f 6e 66 69 67 75 72 69 6e 67 20 77 68 69 63 68 20 61 63 uration.....Configuring.which.ac
10d80 74 69 6f 6e 73 20 61 72 65 20 6f 66 66 65 72 65 64 20 66 6f 72 20 61 20 74 79 70 65 20 69 73 20 tions.are.offered.for.a.type.is.
10da0 70 61 72 74 69 63 75 6c 61 72 6c 79 20 65 61 73 79 0a 20 20 61 6e 64 20 72 65 71 75 69 72 65 73 particularly.easy...and.requires
10dc0 20 6e 6f 20 70 72 6f 67 72 61 6d 6d 69 6e 67 3a 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 60 65 .no.programming:.the.variable.`e
10de0 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 61 6c 69 73 74 27 0a 20 20 61 73 73 6f 63 69 61 74 65 73 mbark-keymap-alist'...associates
10e00 20 74 61 72 67 65 74 20 74 79 70 65 73 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 73 20 63 6f 6e .target.types.with.variables.con
10e20 74 61 69 6e 69 6e 67 20 6b 65 79 6d 61 70 73 2c 20 61 6e 64 20 74 68 6f 73 65 0a 20 20 6b 65 79 taining.keymaps,.and.those...key
10e40 6d 61 70 73 20 63 6f 6e 74 61 69 6e 69 6e 67 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 maps.containing.bindings.for.the
10e60 20 61 63 74 69 6f 6e 73 2e 20 28 54 6f 20 65 78 61 6d 69 6e 65 20 74 68 65 20 61 76 61 69 6c 61 .actions..(To.examine.the.availa
10e80 62 6c 65 0a 20 20 63 61 74 65 67 6f 72 69 65 73 20 61 6e 64 20 74 68 65 69 72 20 61 73 73 6f 63 ble...categories.and.their.assoc
10ea0 69 61 74 65 64 20 6b 65 79 6d 61 70 73 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 60 43 2d 68 20 iated.keymaps,.you.can.use.`C-h.
10ec0 76 0a 20 20 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 61 6c 69 73 74 27 20 6f 72 20 63 75 73 74 v...embark-keymap-alist'.or.cust
10ee0 6f 6d 69 7a 65 20 74 68 61 74 20 76 61 72 69 61 62 6c 65 2e 29 20 46 6f 72 20 65 78 61 6d 70 6c omize.that.variable.).For.exampl
10f00 65 2c 20 69 6e 20 74 68 65 0a 20 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f e,.in.the...default.configuratio
10f20 6e 20 74 68 65 20 74 79 70 65 20 60 66 69 6c 65 27 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 n.the.type.`file'.is.associated.
10f40 77 69 74 68 20 74 68 65 20 73 79 6d 62 6f 6c 0a 20 20 60 65 6d 62 61 72 6b 2d 66 69 6c 65 2d 6d with.the.symbol...`embark-file-m
10f60 61 70 27 2e 20 54 68 61 74 20 73 79 6d 62 6f 6c 20 6e 61 6d 65 73 20 61 20 6b 65 79 6d 61 70 20 ap'..That.symbol.names.a.keymap.
10f80 77 69 74 68 20 73 69 6e 67 6c 65 2d 6c 65 74 74 65 72 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 with.single-letter.key...binding
10fa0 73 20 66 6f 72 20 63 6f 6d 6d 6f 6e 20 45 6d 61 63 73 20 66 69 6c 65 20 63 6f 6d 6d 61 6e 64 73 s.for.common.Emacs.file.commands
10fc0 2c 20 66 6f 72 20 69 6e 73 74 61 6e 63 65 20 60 63 27 20 69 73 20 62 6f 75 6e 64 20 74 6f 0a 20 ,.for.instance.`c'.is.bound.to..
10fe0 20 60 63 6f 70 79 2d 66 69 6c 65 27 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 69 66 .`copy-file'..This.means.that.if
11000 20 79 6f 75 20 61 72 65 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 61 66 74 65 72 .you.are.in.the.minibuffer.after
11020 0a 20 20 72 75 6e 6e 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 70 72 6f 6d 70 74 ...running.a.command.that.prompt
11040 73 20 66 6f 72 20 61 20 66 69 6c 65 2c 20 73 75 63 68 20 61 73 20 60 66 69 6e 64 2d 66 69 6c 65 s.for.a.file,.such.as.`find-file
11060 27 20 6f 72 0a 20 20 60 72 65 6e 61 6d 65 2d 66 69 6c 65 27 2c 20 79 6f 75 20 63 61 6e 20 63 6f '.or...`rename-file',.you.can.co
11080 70 79 20 61 20 66 69 6c 65 20 62 79 20 72 75 6e 6e 69 6e 67 20 60 65 6d 62 61 72 6b 2d 61 63 74 py.a.file.by.running.`embark-act
110a0 27 20 61 6e 64 20 74 68 65 6e 0a 20 20 70 72 65 73 73 69 6e 67 20 60 63 27 2e 0a 0a 20 20 54 68 '.and.then...pressing.`c'.....Th
110c0 65 73 65 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 20 61 72 65 20 76 65 72 79 20 63 6f 6e 76 ese.action.keymaps.are.very.conv
110e0 65 6e 69 65 6e 74 20 62 75 74 20 6e 6f 74 20 73 74 72 69 63 74 6c 79 20 6e 65 63 65 73 73 61 72 enient.but.not.strictly.necessar
11100 79 0a 20 20 77 68 65 6e 20 75 73 69 6e 67 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 3a 20 79 6f 75 y...when.using.`embark-act':.you
11120 20 63 61 6e 20 75 73 65 20 61 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 72 65 61 64 73 20 .can.use.any.command.that.reads.
11140 66 72 6f 6d 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 61 73 20 61 6e 20 61 63 74 69 from.the...minibuffer.as.an.acti
11160 6f 6e 20 61 6e 64 20 74 68 65 20 74 61 72 67 65 74 20 6f 66 20 74 68 65 20 61 63 74 69 6f 6e 20 on.and.the.target.of.the.action.
11180 77 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 65 64 0a 20 20 61 74 20 74 68 65 20 66 69 72 73 74 20 will.be.inserted...at.the.first.
111a0 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 2e 20 41 66 74 65 72 20 72 75 6e 6e 69 6e 67 minibuffer.prompt..After.running
111c0 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 61 6c 6c 20 6f 66 20 79 6f 75 72 0a 20 20 6b 65 79 20 .`embark-act'.all.of.your...key.
111e0 62 69 6e 64 69 6e 67 73 20 61 6e 64 20 65 76 65 6e 20 60 65 78 65 63 75 74 65 2d 65 78 74 65 6e bindings.and.even.`execute-exten
11200 64 65 64 2d 63 6f 6d 6d 61 6e 64 27 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 72 75 6e 20 ded-command'.can.be.used.to.run.
11220 61 0a 20 20 63 6f 6d 6d 61 6e 64 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 a...command..For.example,.if.you
11240 20 77 61 6e 74 20 74 6f 20 72 65 70 6c 61 63 65 20 61 6c 6c 20 6f 63 63 75 72 72 65 6e 63 65 73 .want.to.replace.all.occurrences
11260 20 6f 66 20 74 68 65 0a 20 20 73 79 6d 62 6f 6c 20 61 74 20 70 6f 69 6e 74 2c 20 6a 75 73 74 20 .of.the...symbol.at.point,.just.
11280 75 73 65 20 60 4d 2d 25 27 20 61 73 20 74 68 65 20 61 63 74 69 6f 6e 2c 20 74 68 65 72 65 20 69 use.`M-%'.as.the.action,.there.i
112a0 73 20 6e 6f 20 6e 65 65 64 20 74 6f 0a 20 20 62 69 6e 64 20 60 71 75 65 72 79 2d 72 65 70 6c 61 s.no.need.to...bind.`query-repla
112c0 63 65 27 20 69 6e 20 6f 6e 65 20 6f 66 20 45 6d 62 61 72 6b 27 73 20 6b 65 79 6d 61 70 73 2e 20 ce'.in.one.of.Embark's.keymaps..
112e0 41 6c 73 6f 2c 20 74 68 6f 73 65 20 61 63 74 69 6f 6e 0a 20 20 6b 65 79 6d 61 70 73 20 61 72 65 Also,.those.action...keymaps.are
11300 20 6e 6f 72 6d 61 6c 20 45 6d 61 63 73 20 6b 65 79 6d 61 70 73 20 61 6e 64 20 79 6f 75 20 73 68 .normal.Emacs.keymaps.and.you.sh
11320 6f 75 6c 64 20 66 65 65 6c 20 66 72 65 65 20 74 6f 20 62 69 6e 64 20 69 6e 0a 20 20 74 68 65 6d ould.feel.free.to.bind.in...them
11340 20 77 68 61 74 65 76 65 72 20 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 20 66 69 6e 64 20 75 73 65 66 .whatever.commands.you.find.usef
11360 75 6c 20 61 73 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 77 61 6e 74 20 74 6f 20 62 65 0a 20 20 61 ul.as.actions.and.want.to.be...a
11380 76 61 69 6c 61 62 6c 65 20 74 68 72 6f 75 67 68 20 63 6f 6e 76 65 6e 69 65 6e 74 20 62 69 6e 64 vailable.through.convenient.bind
113a0 69 6e 67 73 2e 0a 0a 20 20 54 68 65 20 61 63 74 69 6f 6e 73 20 69 6e 20 60 65 6d 62 61 72 6b 2d ings.....The.actions.in.`embark-
113c0 67 65 6e 65 72 61 6c 2d 6d 61 70 27 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 6e 6f 20 6d 61 general-map'.are.available.no.ma
113e0 74 74 65 72 20 77 68 61 74 20 74 79 70 65 0a 20 20 6f 66 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 79 tter.what.type...of.completion.y
11400 6f 75 20 61 72 65 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f 66 2e 20 42 79 20 64 65 66 61 ou.are.in.the.middle.of..By.defa
11420 75 6c 74 20 74 68 69 73 20 69 6e 63 6c 75 64 65 73 0a 20 20 62 69 6e 64 69 6e 67 73 20 74 6f 20 ult.this.includes...bindings.to.
11440 73 61 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 61 6e 64 69 64 61 74 65 20 69 6e 20 74 68 save.the.current.candidate.in.th
11460 65 20 6b 69 6c 6c 20 72 69 6e 67 20 61 6e 64 20 74 6f 20 69 6e 73 65 72 74 0a 20 20 74 68 65 20 e.kill.ring.and.to.insert...the.
11480 63 75 72 72 65 6e 74 20 63 61 6e 64 69 64 61 74 65 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 current.candidate.in.the.previou
114a0 73 6c 79 20 73 65 6c 65 63 74 65 64 20 62 75 66 66 65 72 20 28 74 68 65 20 62 75 66 66 65 72 0a sly.selected.buffer.(the.buffer.
114c0 20 20 74 68 61 74 20 77 61 73 20 63 75 72 72 65 6e 74 20 77 68 65 6e 20 79 6f 75 20 65 78 65 63 ..that.was.current.when.you.exec
114e0 75 74 65 64 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 6f 70 65 6e 65 64 20 75 70 20 74 68 uted.a.command.that.opened.up.th
11500 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 29 2e 0a 0a 20 20 45 6d 61 63 73 27 73 20 6d 69 6e 69 e...minibuffer).....Emacs's.mini
11520 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 79 73 74 65 6d 20 69 6e 63 6c 75 64 65 buffer.completion.system.include
11540 73 20 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 65 0a 20 20 2f 63 61 74 s.metadata.indicating.the.../cat
11560 65 67 6f 72 79 2f 20 6f 66 20 77 68 61 74 20 69 73 20 62 65 69 6e 67 20 63 6f 6d 70 6c 65 74 65 egory/.of.what.is.being.complete
11580 64 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 60 66 69 6e 64 2d 66 69 6c 65 27 27 73 0a 20 20 d..For.example,.`find-file''s...
115a0 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 61 74 65 67 6f 72 79 20 6f 66 metadata.indicates.a.category.of
115c0 20 60 66 69 6c 65 27 20 61 6e 64 20 60 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 27 27 73 .`file'.and.`switch-to-buffer''s
115e0 0a 20 20 6d 65 74 61 64 61 74 61 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 61 74 65 67 6f 72 79 ...metadata.indicates.a.category
11600 20 6f 66 20 60 62 75 66 66 65 72 27 2e 20 45 6d 62 61 72 6b 20 68 61 73 20 74 68 65 20 72 65 6c .of.`buffer'..Embark.has.the.rel
11620 61 74 65 64 0a 20 20 6e 6f 74 69 6f 6e 20 6f 66 20 74 68 65 20 2f 74 79 70 65 2f 20 6f 66 20 61 ated...notion.of.the./type/.of.a
11640 20 74 61 72 67 65 74 20 66 6f 72 20 61 63 74 69 6f 6e 73 2c 20 61 6e 64 20 62 79 20 64 65 66 61 .target.for.actions,.and.by.defa
11660 75 6c 74 20 77 68 65 6e 0a 20 20 63 61 74 65 67 6f 72 79 20 6d 65 74 61 64 61 74 61 20 69 73 20 ult.when...category.metadata.is.
11680 70 72 65 73 65 6e 74 20 69 74 20 69 73 20 74 61 6b 65 6e 20 74 6f 20 62 65 20 74 68 65 20 74 79 present.it.is.taken.to.be.the.ty
116a0 70 65 20 6f 66 20 6d 69 6e 69 62 75 66 66 65 72 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 pe.of.minibuffer...completion.ca
116c0 6e 64 69 64 61 74 65 73 20 77 68 65 6e 20 75 73 65 64 20 61 73 20 74 61 72 67 65 74 73 2e 20 45 ndidates.when.used.as.targets..E
116e0 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 20 6f 66 74 65 6e 20 64 6f 0a 20 20 6e 6f 74 20 73 65 74 macs.commands.often.do...not.set
11700 20 75 73 65 66 75 6c 20 63 61 74 65 67 6f 72 79 20 6d 65 74 61 64 61 74 61 20 73 6f 20 74 68 65 .useful.category.metadata.so.the
11720 20 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 20 70 61 63 6b 61 67 65 2c 20 77 68 69 63 68 0a 20 20 73 .[Marginalia].package,.which...s
11740 75 70 70 6c 69 65 73 20 74 68 69 73 20 6d 69 73 73 69 6e 67 20 6d 65 74 61 64 61 74 61 2c 20 69 upplies.this.missing.metadata,.i
11760 73 20 68 69 67 68 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 77 69 74 s.highly.recommended.for.use.wit
11780 68 0a 20 20 45 6d 62 61 72 6b 2e 0a 0a 20 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 20 h...Embark.....Embark's.default.
117a0 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 68 61 73 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 68 configuration.has.actions.for.th
117c0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 72 67 65 74 0a 20 20 74 79 70 65 73 3a 20 66 69 6c 65 e.following.target...types:.file
117e0 73 2c 20 62 75 66 66 65 72 73 2c 20 73 79 6d 62 6f 6c 73 2c 20 70 61 63 6b 61 67 65 73 2c 20 55 s,.buffers,.symbols,.packages,.U
11800 52 4c 73 2c 20 62 6f 6f 6b 6d 61 72 6b 73 2c 20 61 6e 64 20 61 73 20 61 0a 20 20 73 6f 6d 65 77 RLs,.bookmarks,.and.as.a...somew
11820 68 61 74 20 73 70 65 63 69 61 6c 20 63 61 73 65 2c 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 77 68 hat.special.case,.actions.for.wh
11840 65 6e 20 74 68 65 20 72 65 67 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 20 59 6f 75 20 63 61 6e en.the.region.is.active..You.can
11860 0a 20 20 72 65 61 64 20 61 62 6f 75 74 20 74 68 65 20 5b 64 65 66 61 75 6c 74 20 61 63 74 69 6f ...read.about.the.[default.actio
11880 6e 73 20 61 6e 64 20 74 68 65 69 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 5d 20 6f 6e 20 74 68 ns.and.their.key.bindings].on.th
118a0 65 20 47 69 74 48 75 62 0a 20 20 70 72 6f 6a 65 63 74 20 77 69 6b 69 2e 0a 0a 0a 5b 4d 61 72 67 e.GitHub...project.wiki....[Marg
118c0 69 6e 61 6c 69 61 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 inalia].<https://github.com/mina
118e0 64 2f 6d 61 72 67 69 6e 61 6c 69 61 3e 0a 0a 5b 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 73 20 d/marginalia>..[default.actions.
11900 61 6e 64 20 74 68 65 69 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 5d 0a 3c 68 74 74 70 73 3a 2f and.their.key.bindings].<https:/
11920 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 77 69 6b 69 /github.com/oantolin/embark/wiki
11940 2f 44 65 66 61 75 6c 74 2d 41 63 74 69 6f 6e 73 3e 0a 0a 0a 31 2e 32 20 54 68 65 20 64 65 66 61 /Default-Actions>...1.2.The.defa
11960 75 6c 74 20 61 63 74 69 6f 6e 20 6f 6e 20 61 20 74 61 72 67 65 74 0a e2 94 80 e2 94 80 e2 94 80 ult.action.on.a.target..........
11980 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
119a0 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
119c0 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 ................................
119e0 20 45 6d 62 61 72 6b 20 68 61 73 20 61 20 6e 6f 74 69 6f 6e 20 6f 66 20 64 65 66 61 75 6c 74 20 .Embark.has.a.notion.of.default.
11a00 61 63 74 69 6f 6e 20 66 6f 72 20 61 20 74 61 72 67 65 74 3a 0a 0a 20 20 e2 80 a2 20 49 66 20 74 action.for.a.target:........If.t
11a20 68 65 20 74 61 72 67 65 74 20 69 73 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 he.target.is.a.minibuffer.comple
11a40 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 2c 20 74 68 65 6e 20 74 68 65 20 64 65 66 61 75 6c 74 tion.candidate,.then.the.default
11a60 0a 20 20 20 20 61 63 74 69 6f 6e 20 69 73 20 77 68 61 74 65 76 65 72 20 63 6f 6d 6d 61 6e 64 20 .....action.is.whatever.command.
11a80 6f 70 65 6e 65 64 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 6e 20 74 68 65 20 66 69 72 opened.the.minibuffer.in.the.fir
11aa0 73 74 20 70 6c 61 63 65 2e 0a 20 20 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 69 66 20 79 6f 75 st.place......For.example.if.you
11ac0 20 72 75 6e 20 60 6b 69 6c 6c 2d 62 75 66 66 65 72 27 2c 20 74 68 65 6e 20 74 68 65 20 64 65 66 .run.`kill-buffer',.then.the.def
11ae0 61 75 6c 74 20 61 63 74 69 6f 6e 20 77 69 6c 6c 0a 20 20 20 20 62 65 20 74 6f 20 6b 69 6c 6c 20 ault.action.will.....be.to.kill.
11b00 62 75 66 66 65 72 73 2e 0a 20 20 e2 80 a2 20 49 66 20 74 68 65 20 74 61 72 67 65 74 20 63 6f 6d buffers........If.the.target.com
11b20 65 73 20 66 72 6f 6d 20 61 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 20 28 69 2e 65 2e 2c 20 es.from.a.regular.buffer.(i.e.,.
11b40 6e 6f 74 20 61 20 6d 69 6e 69 62 75 66 66 65 72 29 2c 0a 20 20 20 20 74 68 65 6e 20 74 68 65 20 not.a.minibuffer),.....then.the.
11b60 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 69 73 20 77 68 61 74 65 76 65 72 20 69 73 20 62 6f default.action.is.whatever.is.bo
11b80 75 6e 64 20 74 6f 20 60 52 45 54 27 20 69 6e 20 74 68 65 20 6b 65 79 6d 61 70 0a 20 20 20 20 6f und.to.`RET'.in.the.keymap.....o
11ba0 66 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 68 61 74 20 74 79 70 65 20 6f 66 20 74 61 72 67 65 f.actions.for.that.type.of.targe
11bc0 74 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 6e 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 t..For.example,.in.Embark's.defa
11be0 75 6c 74 0a 20 20 20 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 6f 72 20 61 20 55 52 4c 20 ult.....configuration.for.a.URL.
11c00 66 6f 75 6e 64 20 61 74 20 70 6f 69 6e 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f found.at.point.the.default.actio
11c20 6e 20 69 73 0a 20 20 20 20 60 62 72 6f 77 73 65 2d 75 72 6c 27 2c 20 62 65 63 61 75 73 65 20 60 n.is.....`browse-url',.because.`
11c40 52 45 54 27 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 60 62 72 6f 77 73 65 2d 75 72 6c 27 20 69 6e RET'.is.bound.to.`browse-url'.in
11c60 20 74 68 65 0a 20 20 20 20 60 65 6d 62 61 72 6b 2d 75 72 6c 2d 6d 61 70 27 20 6b 65 79 6d 61 70 .the.....`embark-url-map'.keymap
11c80 2e 0a 0a 20 20 54 6f 20 72 75 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 79 .....To.run.the.default.action.y
11ca0 6f 75 20 63 61 6e 20 70 72 65 73 73 20 60 52 45 54 27 20 61 66 74 65 72 20 72 75 6e 6e 69 6e 67 ou.can.press.`RET'.after.running
11cc0 0a 20 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 69 66 20 74 ...`embark-act'...Note.that.if.t
11ce0 68 65 72 65 20 61 72 65 20 73 65 76 65 72 61 6c 20 64 69 66 66 65 72 65 6e 74 20 74 61 72 67 65 here.are.several.different.targe
11d00 74 73 20 61 74 20 61 0a 20 20 67 69 76 65 6e 20 6c 6f 63 61 74 69 6f 6e 2c 20 65 61 63 68 20 68 ts.at.a...given.location,.each.h
11d20 61 73 20 69 74 73 20 6f 77 6e 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 2c 20 73 6f 20 66 69 as.its.own.default.action,.so.fi
11d40 72 73 74 20 63 79 63 6c 65 20 74 6f 20 74 68 65 0a 20 20 74 61 72 67 65 74 20 79 6f 75 20 77 61 rst.cycle.to.the...target.you.wa
11d60 6e 74 20 61 6e 64 20 74 68 65 6e 20 70 72 65 73 73 20 60 52 45 54 27 20 74 6f 20 72 75 6e 20 74 nt.and.then.press.`RET'.to.run.t
11d80 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 64 65 66 61 75 6c 74 0a 20 20 61 63 74 69 6f he.corresponding.default...actio
11da0 6e 2e 0a 0a 20 20 54 68 65 72 65 20 69 73 20 61 6c 73 6f 20 60 65 6d 62 61 72 6b 2d 64 77 69 6d n.....There.is.also.`embark-dwim
11dc0 27 20 77 68 69 63 68 20 72 75 6e 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 '.which.runs.the.default.action.
11de0 66 6f 72 20 74 68 65 0a 20 20 66 69 72 73 74 20 74 61 72 67 65 74 20 66 6f 75 6e 64 2e 20 49 74 for.the...first.target.found..It
11e00 27 73 20 70 72 65 74 74 79 20 68 61 6e 64 79 20 69 6e 20 6e 6f 6e 2d 6d 69 6e 69 62 75 66 66 65 's.pretty.handy.in.non-minibuffe
11e20 72 20 62 75 66 66 65 72 73 3a 20 77 69 74 68 0a 20 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 r.buffers:.with...Embark's.defau
11e40 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 74 20 77 69 6c 6c 3a 0a 0a 20 20 e2 80 a2 lt.configuration.it.will:.......
11e60 20 4f 70 65 6e 20 74 68 65 20 66 69 6c 65 20 61 74 20 70 6f 69 6e 74 2e 0a 20 20 e2 80 a2 20 4f .Open.the.file.at.point........O
11e80 70 65 6e 20 74 68 65 20 55 52 4c 20 61 74 20 70 6f 69 6e 74 20 69 6e 20 61 20 77 65 62 20 62 72 pen.the.URL.at.point.in.a.web.br
11ea0 6f 77 73 65 72 20 28 75 73 69 6e 67 20 74 68 65 20 60 62 72 6f 77 73 65 2d 75 72 6c 27 0a 20 20 owser.(using.the.`browse-url'...
11ec0 20 20 63 6f 6d 6d 61 6e 64 29 2e 0a 20 20 e2 80 a2 20 43 6f 6d 70 6f 73 65 20 61 20 6e 65 77 20 ..command)........Compose.a.new.
11ee0 65 6d 61 69 6c 20 74 6f 20 74 68 65 20 65 6d 61 69 6c 20 61 64 64 72 65 73 73 20 61 74 20 70 6f email.to.the.email.address.at.po
11f00 69 6e 74 2e 0a 20 20 e2 80 a2 20 49 6e 20 61 6e 20 45 6d 61 63 73 20 4c 69 73 70 20 62 75 66 66 int........In.an.Emacs.Lisp.buff
11f20 65 72 2c 20 69 66 20 70 6f 69 6e 74 20 69 73 20 6f 6e 20 61 6e 20 6f 70 65 6e 69 6e 67 20 70 61 er,.if.point.is.on.an.opening.pa
11f40 72 65 6e 74 68 65 73 69 73 20 6f 72 0a 20 20 20 20 72 69 67 68 74 20 61 66 74 65 72 20 61 20 63 renthesis.or.....right.after.a.c
11f60 6c 6f 73 69 6e 67 20 6f 6e 65 2c 20 69 74 20 77 69 6c 6c 20 65 76 61 6c 75 61 74 65 20 74 68 65 losing.one,.it.will.evaluate.the
11f80 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 20 20 20 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 20 .corresponding.....expression...
11fa0 20 e2 80 a2 20 47 6f 20 74 6f 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 6e 20 .....Go.to.the.definition.of.an.
11fc0 45 6d 61 63 73 20 4c 69 73 70 20 66 75 6e 63 74 69 6f 6e 2c 20 76 61 72 69 61 62 6c 65 20 6f 72 Emacs.Lisp.function,.variable.or
11fe0 20 6d 61 63 72 6f 20 61 74 0a 20 20 20 20 70 6f 69 6e 74 2e 0a 20 20 e2 80 a2 20 46 69 6e 64 20 .macro.at.....point........Find.
12000 74 68 65 20 66 69 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 6e 20 45 6d 61 the.file.corresponding.to.an.Ema
12020 63 73 20 4c 69 73 70 20 6c 69 62 72 61 72 79 20 61 74 20 70 6f 69 6e 74 2e 0a 0a 0a 31 2e 33 20 cs.Lisp.library.at.point....1.3.
12040 57 6f 72 6b 69 6e 67 20 77 69 74 68 20 73 65 74 73 20 6f 66 20 70 6f 73 73 69 62 6c 65 20 74 61 Working.with.sets.of.possible.ta
12060 72 67 65 74 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 rgets...........................
12080 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
120a0 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
120c0 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
120e0 80 0a 0a 20 20 42 65 73 69 64 65 73 20 61 63 74 69 6e 67 20 69 6e 64 69 76 69 64 75 61 6c 6c 79 .....Besides.acting.individually
12100 20 6f 6e 20 74 61 72 67 65 74 73 2c 20 45 6d 62 61 72 6b 20 6c 65 74 73 20 79 6f 75 20 77 6f 72 .on.targets,.Embark.lets.you.wor
12120 6b 0a 20 20 63 6f 6c 6c 65 63 74 69 76 65 6c 79 20 6f 6e 20 61 20 73 65 74 20 6f 66 20 74 61 72 k...collectively.on.a.set.of.tar
12140 67 65 74 20 2f 63 61 6e 64 69 64 61 74 65 73 2f 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 get./candidates/..For.example,.w
12160 68 69 6c 65 20 79 6f 75 0a 20 20 61 72 65 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 hile.you...are.in.the.minibuffer
12180 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 61 72 65 20 73 69 6d 70 6c 79 20 74 68 65 20 70 .the.candidates.are.simply.the.p
121a0 6f 73 73 69 62 6c 65 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 6f 66 20 79 6f 75 72 20 69 6e ossible...completions.of.your.in
121c0 70 75 74 2e 20 45 6d 62 61 72 6b 20 70 72 6f 76 69 64 65 73 20 74 68 72 65 65 20 6d 61 69 6e 20 put..Embark.provides.three.main.
121e0 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 77 6f 72 6b 0a 20 20 6f 6e 20 63 61 6e 64 69 64 61 74 65 20 commands.to.work...on.candidate.
12200 73 65 74 73 3a 0a 0a 20 20 e2 80 a2 20 54 68 65 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c sets:........The.`embark-act-all
12220 27 20 63 6f 6d 6d 61 6e 64 20 72 75 6e 73 20 74 68 65 20 73 61 6d 65 20 61 63 74 69 6f 6e 20 6f '.command.runs.the.same.action.o
12240 6e 20 65 61 63 68 20 6f 66 20 74 68 65 0a 20 20 20 20 63 75 72 72 65 6e 74 20 63 61 6e 64 69 64 n.each.of.the.....current.candid
12260 61 74 65 73 2e 20 49 74 20 69 73 20 6a 75 73 74 20 6c 69 6b 65 20 75 73 69 6e 67 20 60 65 6d 62 ates..It.is.just.like.using.`emb
12280 61 72 6b 2d 61 63 74 27 20 6f 6e 20 65 61 63 68 0a 20 20 20 20 63 61 6e 64 69 64 61 74 65 20 69 ark-act'.on.each.....candidate.i
122a0 6e 20 74 75 72 6e 2e 20 28 42 65 63 61 75 73 65 20 79 6f 75 20 63 61 6e 20 65 61 73 69 6c 79 20 n.turn..(Because.you.can.easily.
122c0 61 63 74 20 6f 6e 20 6d 61 6e 79 20 6d 6f 72 65 0a 20 20 20 20 63 61 6e 64 69 64 61 74 65 73 20 act.on.many.more.....candidates.
122e0 74 68 61 6e 20 79 6f 75 20 6d 65 61 6e 74 20 74 6f 2c 20 62 79 20 64 65 66 61 75 6c 74 20 45 6d than.you.meant.to,.by.default.Em
12300 62 61 72 6b 20 61 73 6b 73 20 79 6f 75 20 74 6f 20 63 6f 6e 66 69 72 6d 0a 20 20 20 20 75 73 65 bark.asks.you.to.confirm.....use
12320 73 20 6f 66 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 3b 20 79 6f 75 20 63 61 6e 20 74 s.of.`embark-act-all';.you.can.t
12340 75 72 6e 20 74 68 69 73 20 6f 66 66 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 75 73 65 72 urn.this.off.by.setting.the.user
12360 0a 20 20 20 20 6f 70 74 69 6f 6e 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 66 69 72 6d 2d 61 63 74 2d .....option.`embark-confirm-act-
12380 61 6c 6c 27 20 74 6f 20 60 6e 69 6c 27 2e 29 0a 0a 20 20 e2 80 a2 20 54 68 65 20 60 65 6d 62 61 all'.to.`nil'.)........The.`emba
123a0 72 6b 2d 63 6f 6c 6c 65 63 74 27 20 63 6f 6d 6d 61 6e 64 20 70 72 6f 64 75 63 65 73 20 61 20 62 rk-collect'.command.produces.a.b
123c0 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 61 6c 6c 20 74 68 65 0a 20 20 20 20 63 75 72 72 65 6e uffer.listing.all.the.....curren
123e0 74 20 63 61 6e 64 69 64 61 74 65 73 2c 20 66 6f 72 20 79 6f 75 20 74 6f 20 70 65 72 75 73 65 20 t.candidates,.for.you.to.peruse.
12400 61 6e 64 20 72 75 6e 20 61 63 74 69 6f 6e 73 20 6f 6e 20 61 74 20 79 6f 75 72 0a 20 20 20 20 6c and.run.actions.on.at.your.....l
12420 65 69 73 75 72 65 2e 20 20 54 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 61 72 65 20 64 69 73 70 eisure...The.candidates.are.disp
12440 6c 61 79 65 64 20 61 73 20 61 20 6c 69 73 74 20 73 68 6f 77 69 6e 67 20 61 64 64 69 74 69 6f 6e layed.as.a.list.showing.addition
12460 61 6c 0a 20 20 20 20 61 6e 6e 6f 74 61 74 69 6f 6e 73 2e 20 49 66 20 61 6e 79 20 6f 66 20 74 68 al.....annotations..If.any.of.th
12480 65 20 63 61 6e 64 69 64 61 74 65 73 20 63 6f 6e 74 61 69 6e 20 6e 65 77 6c 69 6e 65 73 2c 20 74 e.candidates.contain.newlines,.t
124a0 68 65 6e 0a 20 20 20 20 68 6f 72 69 7a 6f 6e 74 61 6c 20 6c 69 6e 65 73 20 61 72 65 20 75 73 65 hen.....horizontal.lines.are.use
124c0 64 20 74 6f 20 73 65 70 61 72 61 74 65 20 63 61 6e 64 69 64 61 74 65 73 2e 0a 0a 20 20 20 20 54 d.to.separate.candidates.......T
124e0 68 65 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 69 73 20 73 6f 6d 65 he.Embark.Collect.buffer.is.some
12500 77 68 61 74 20 22 64 69 72 65 64 2d 6c 69 6b 65 22 3a 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 what."dired-like":.you.can.selec
12520 74 0a 20 20 20 20 61 6e 64 20 64 65 73 65 6c 65 63 74 20 63 61 6e 64 69 64 61 74 65 73 20 74 68 t.....and.deselect.candidates.th
12540 72 6f 75 67 68 20 60 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 27 20 28 61 76 61 69 6c 61 62 6c 65 rough.`embark-select'.(available
12560 20 61 73 20 61 6e 0a 20 20 20 20 61 63 74 69 6f 6e 20 69 6e 20 60 65 6d 62 61 72 6b 2d 61 63 74 .as.an.....action.in.`embark-act
12580 27 2c 20 62 6f 75 6e 64 20 74 6f 20 60 53 50 43 27 3b 20 62 75 74 20 79 6f 75 20 63 6f 75 6c 64 ',.bound.to.`SPC';.but.you.could
125a0 20 61 6c 73 6f 20 67 69 76 65 20 69 74 20 61 0a 20 20 20 20 67 6c 6f 62 61 6c 20 6b 65 79 20 62 .also.give.it.a.....global.key.b
125c0 69 6e 64 69 6e 67 29 2e 20 49 6e 20 61 6e 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 inding)..In.an.Embark.Collect.bu
125e0 66 66 65 72 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 69 73 0a 20 20 20 20 62 6f 75 6e 64 20 74 ffer.`embark-act'.is.....bound.t
12600 6f 20 60 61 27 20 61 6e 64 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 20 69 73 20 62 6f o.`a'.and.`embark-act-all'.is.bo
12620 75 6e 64 20 74 6f 20 60 41 27 3b 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 0a 20 20 20 und.to.`A';.`embark-act-all'....
12640 20 77 69 6c 6c 20 61 63 74 20 6f 6e 20 61 6c 6c 20 63 75 72 72 65 6e 74 6c 79 20 6d 61 72 6b 65 .will.act.on.all.currently.marke
12660 64 20 63 61 6e 64 69 64 61 74 65 73 20 69 66 20 74 68 65 72 65 20 61 6e 79 2c 20 61 6e 64 20 77 d.candidates.if.there.any,.and.w
12680 69 6c 6c 0a 20 20 20 20 61 63 74 20 6f 6e 20 61 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 20 69 66 ill.....act.on.all.candidates.if
126a0 20 6e 6f 6e 65 20 61 72 65 20 6d 61 72 6b 65 64 2e 20 49 6e 20 70 61 72 74 69 63 75 6c 61 72 2c .none.are.marked..In.particular,
126c0 20 74 68 69 73 20 6d 65 61 6e 73 0a 20 20 20 20 74 68 61 74 20 60 61 20 53 50 43 27 20 77 69 6c .this.means.....that.`a.SPC'.wil
126e0 6c 20 74 6f 67 67 6c 65 20 77 68 65 74 68 65 72 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 20 61 l.toggle.whether.the.candidate.a
12700 74 20 70 6f 69 6e 74 20 69 73 20 73 65 6c 65 63 74 65 64 2c 0a 20 20 20 20 61 6e 64 20 60 41 20 t.point.is.selected,.....and.`A.
12720 53 50 43 27 20 77 69 6c 6c 20 73 65 6c 65 63 74 20 61 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 20 SPC'.will.select.all.candidates.
12740 69 66 20 6e 6f 6e 65 20 61 72 65 20 73 65 6c 65 63 74 65 64 2c 20 6f 72 0a 20 20 20 20 64 65 73 if.none.are.selected,.or.....des
12760 65 6c 65 63 74 20 61 6c 6c 20 73 65 6c 65 63 74 65 64 20 63 61 6e 64 69 64 61 74 65 73 20 69 66 elect.all.selected.candidates.if
12780 20 74 68 65 72 65 20 61 72 65 20 73 6f 6d 65 2e 0a 0a 20 20 e2 80 a2 20 54 68 65 20 60 65 6d 62 .there.are.some.........The.`emb
127a0 61 72 6b 2d 65 78 70 6f 72 74 27 20 63 6f 6d 6d 61 6e 64 20 74 72 69 65 73 20 74 6f 20 6f 70 65 ark-export'.command.tries.to.ope
127c0 6e 20 61 20 62 75 66 66 65 72 20 69 6e 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 0a 20 20 20 n.a.buffer.in.an.appropriate....
127e0 20 6d 61 6a 6f 72 20 6d 6f 64 65 20 66 6f 72 20 74 68 65 20 73 65 74 20 6f 66 20 63 61 6e 64 69 .major.mode.for.the.set.of.candi
12800 64 61 74 65 73 2e 20 49 66 20 74 68 65 20 63 61 6e 64 69 64 61 74 65 73 20 61 72 65 20 66 69 6c dates..If.the.candidates.are.fil
12820 65 73 0a 20 20 20 20 65 78 70 6f 72 74 20 70 72 6f 64 75 63 65 73 20 61 20 44 69 72 65 64 20 62 es.....export.produces.a.Dired.b
12840 75 66 66 65 72 3b 20 69 66 20 74 68 65 79 20 61 72 65 20 62 75 66 66 65 72 73 2c 20 79 6f 75 20 uffer;.if.they.are.buffers,.you.
12860 67 65 74 20 61 6e 0a 20 20 20 20 49 62 75 66 66 65 72 20 62 75 66 66 65 72 3b 20 61 6e 64 20 69 get.an.....Ibuffer.buffer;.and.i
12880 66 20 74 68 65 79 20 61 72 65 20 70 61 63 6b 61 67 65 73 20 79 6f 75 20 67 65 74 20 61 20 62 75 f.they.are.packages.you.get.a.bu
128a0 66 66 65 72 20 69 6e 20 70 61 63 6b 61 67 65 0a 20 20 20 20 6d 65 6e 75 20 6d 6f 64 65 2e 0a 0a ffer.in.package.....menu.mode...
128c0 20 20 20 20 49 66 20 79 6f 75 20 75 73 65 20 74 68 65 20 67 72 65 70 70 69 6e 67 20 63 6f 6d 6d ....If.you.use.the.grepping.comm
128e0 61 6e 64 73 20 66 72 6f 6d 20 74 68 65 20 5b 43 6f 6e 73 75 6c 74 5d 20 70 61 63 6b 61 67 65 2c ands.from.the.[Consult].package,
12900 0a 20 20 20 20 60 63 6f 6e 73 75 6c 74 2d 67 72 65 70 27 2c 20 60 63 6f 6e 73 75 6c 74 2d 67 69 .....`consult-grep',.`consult-gi
12920 74 2d 67 72 65 70 27 20 6f 72 20 60 63 6f 6e 73 75 6c 74 2d 72 69 70 67 72 65 70 27 2c 20 74 68 t-grep'.or.`consult-ripgrep',.th
12940 65 6e 20 79 6f 75 0a 20 20 20 20 73 68 6f 75 6c 64 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 60 65 en.you.....should.install.the.`e
12960 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 20 70 61 63 6b 61 67 65 2c 20 77 68 69 63 68 20 61 64 mbark-consult'.package,.which.ad
12980 64 73 20 73 75 70 70 6f 72 74 20 66 6f 72 0a 20 20 20 20 65 78 70 6f 72 74 69 6e 67 20 61 20 6c ds.support.for.....exporting.a.l
129a0 69 73 74 20 6f 66 20 67 72 65 70 20 72 65 73 75 6c 74 73 20 74 6f 20 61 6e 20 68 6f 6e 65 73 74 ist.of.grep.results.to.an.honest
129c0 20 67 72 65 70 2d 6d 6f 64 65 20 62 75 66 66 65 72 2c 20 6f 6e 0a 20 20 20 20 77 68 69 63 68 20 .grep-mode.buffer,.on.....which.
129e0 79 6f 75 20 63 61 6e 20 65 76 65 6e 20 75 73 65 20 5b 77 67 72 65 70 5d 20 69 66 20 79 6f 75 20 you.can.even.use.[wgrep].if.you.
12a00 77 69 73 68 2e 0a 0a 20 20 57 68 65 6e 20 69 6e 20 64 6f 75 62 74 20 63 68 6f 6f 73 69 6e 67 20 wish.....When.in.doubt.choosing.
12a20 62 65 74 77 65 65 6e 20 65 78 70 6f 72 74 69 6e 67 20 61 6e 64 20 63 6f 6c 6c 65 63 74 69 6e 67 between.exporting.and.collecting
12a40 2c 20 61 20 67 6f 6f 64 20 72 75 6c 65 0a 20 20 6f 66 20 74 68 75 6d 62 20 69 73 20 74 6f 20 61 ,.a.good.rule...of.thumb.is.to.a
12a60 6c 77 61 79 73 20 70 72 65 66 65 72 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 73 69 6e lways.prefer.`embark-export'.sin
12a80 63 65 20 77 68 65 6e 20 61 6e 20 65 78 70 6f 72 74 65 72 20 74 6f 0a 20 20 61 20 73 70 65 63 69 ce.when.an.exporter.to...a.speci
12aa0 61 6c 20 6d 61 6a 6f 72 20 6d 6f 64 65 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 61 al.major.mode.is.available.for.a
12ac0 20 67 69 76 65 6e 20 74 79 70 65 20 6f 66 20 74 61 72 67 65 74 2c 20 69 74 20 77 69 6c 6c 0a 20 .given.type.of.target,.it.will..
12ae0 20 62 65 20 6d 6f 72 65 20 66 65 61 74 75 72 65 66 75 6c 20 74 68 61 6e 20 61 6e 20 45 6d 62 61 .be.more.featureful.than.an.Emba
12b00 72 6b 20 63 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 2c 20 61 6e 64 20 69 66 20 6e 6f 20 73 75 63 rk.collect.buffer,.and.if.no.suc
12b20 68 0a 20 20 65 78 70 6f 72 74 65 72 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74 68 65 20 60 h...exporter.is.configured.the.`
12b40 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 63 6f 6d 6d 61 6e 64 20 66 61 6c 6c 73 20 62 61 63 embark-export'.command.falls.bac
12b60 6b 20 74 6f 20 74 68 65 0a 20 20 67 65 6e 65 72 69 63 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 k.to.the...generic.`embark-colle
12b80 63 74 27 2e 0a 0a 20 20 54 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 6c 77 61 79 ct'.....These.commands.are.alway
12ba0 73 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 22 61 63 74 69 6f 6e 73 22 20 28 61 6c 74 68 6f 75 s.available.as."actions".(althou
12bc0 67 68 20 74 68 65 79 20 64 6f 20 6e 6f 74 0a 20 20 61 63 74 20 6f 6e 20 6a 75 73 74 20 74 68 65 gh.they.do.not...act.on.just.the
12be0 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 20 62 75 74 20 6f 6e 20 61 6c 6c 20 63 61 6e 64 69 .current.target.but.on.all.candi
12c00 64 61 74 65 73 29 20 66 6f 72 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 0a 20 20 61 6e 64 20 61 72 dates).for.`embark-act'...and.ar
12c20 65 20 62 6f 75 6e 64 20 74 6f 20 60 41 27 2c 20 60 53 27 20 28 66 6f 72 20 22 73 6e 61 70 73 68 e.bound.to.`A',.`S'.(for."snapsh
12c40 6f 74 22 29 2c 20 61 6e 64 20 60 45 27 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2c 20 69 6e 0a ot"),.and.`E',.respectively,.in.
12c60 20 20 60 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 27 2e 20 54 68 69 73 20 6d 65 61 ..`embark-general-map'..This.mea
12c80 6e 73 20 74 68 61 74 20 79 6f 75 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 62 69 6e 64 20 ns.that.you.do.not.have.to.bind.
12ca0 79 6f 75 72 20 6f 77 6e 0a 20 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 73 your.own...key.bindings.for.thes
12cc0 65 20 28 61 6c 74 68 6f 75 67 68 20 79 6f 75 20 63 61 6e 2c 20 6f 66 20 63 6f 75 72 73 65 21 29 e.(although.you.can,.of.course!)
12ce0 2c 20 6a 75 73 74 20 61 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 60 65 6d 62 61 ,.just.a.key...binding.for.`emba
12d00 72 6b 2d 61 63 74 27 2e 0a 0a 20 20 49 6e 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 6f 72 rk-act'.....In.Embark.Collect.or
12d20 20 45 6d 62 61 72 6b 20 45 78 70 6f 72 74 20 62 75 66 66 65 72 73 20 74 68 61 74 20 77 65 72 65 .Embark.Export.buffers.that.were
12d40 20 6f 62 74 61 69 6e 65 64 20 62 79 0a 20 20 72 75 6e 6e 69 6e 67 20 60 65 6d 62 61 72 6b 2d 63 .obtained.by...running.`embark-c
12d60 6f 6c 6c 65 63 74 27 20 6f 72 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 66 72 6f 6d 20 ollect'.or.`embark-export'.from.
12d80 77 69 74 68 69 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 72 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e within.a.minibuffer...completion
12da0 20 73 65 73 73 69 6f 6e 2c 20 60 67 27 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 61 20 63 6f 6d 6d .session,.`g'.is.bound.to.a.comm
12dc0 61 6e 64 20 74 68 61 74 20 72 65 73 74 61 72 74 73 20 74 68 65 0a 20 20 63 6f 6d 70 6c 65 74 69 and.that.restarts.the...completi
12de0 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 74 68 61 74 20 69 73 2c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 on.session,.that.is,.the.command
12e00 20 74 68 61 74 20 6f 70 65 6e 65 64 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 0a 20 .that.opened.the.minibuffer.is..
12e20 20 72 75 6e 20 61 67 61 69 6e 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f .run.again.and.the.minibuffer.co
12e40 6e 74 65 6e 74 73 20 72 65 73 74 6f 72 65 64 2e 20 59 6f 75 20 63 61 6e 20 74 68 65 6e 20 69 6e ntents.restored..You.can.then.in
12e60 74 65 72 61 63 74 0a 20 20 6e 6f 72 6d 61 6c 6c 79 20 77 69 74 68 20 74 68 65 20 63 6f 6d 6d 61 teract...normally.with.the.comma
12e80 6e 64 2c 20 70 65 72 68 61 70 73 20 65 64 69 74 69 6e 67 20 74 68 65 20 6d 69 6e 69 62 75 66 66 nd,.perhaps.editing.the.minibuff
12ea0 65 72 20 63 6f 6e 74 65 6e 74 73 2c 0a 20 20 61 6e 64 2c 20 69 66 20 79 6f 75 20 77 69 73 68 2c er.contents,...and,.if.you.wish,
12ec0 20 79 6f 75 20 63 61 6e 20 72 65 72 75 6e 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 27 20 .you.can.rerun.`embark-collect'.
12ee0 6f 72 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 74 6f 0a 20 20 67 65 74 20 61 6e 20 75 or.`embark-export'.to...get.an.u
12f00 70 64 61 74 65 64 20 62 75 66 66 65 72 2e 0a 0a 0a 5b 43 6f 6e 73 75 6c 74 5d 20 3c 68 74 74 70 pdated.buffer....[Consult].<http
12f20 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 63 6f 6e 73 75 6c 74 2f 3e 0a 0a s://github.com/minad/consult/>..
12f40 5b 77 67 72 65 70 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 68 61 79 [wgrep].<https://github.com/mhay
12f60 61 73 68 69 31 31 32 30 2f 45 6d 61 63 73 2d 77 67 72 65 70 3e 0a 0a 31 2e 33 2e 31 20 53 65 6c ashi1120/Emacs-wgrep>..1.3.1.Sel
12f80 65 63 74 69 6e 67 20 73 6f 6d 65 20 74 61 72 67 65 74 73 20 74 6f 20 6d 61 6b 65 20 61 6e 20 61 ecting.some.targets.to.make.an.a
12fa0 64 20 68 6f 63 20 63 61 6e 64 69 64 61 74 65 20 73 65 74 0a e2 95 8c e2 95 8c e2 95 8c e2 95 8c d.hoc.candidate.set.............
12fc0 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 ................................
12fe0 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
13000 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
13020 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 ................................
13040 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
13060 95 8c e2 95 8c e2 95 8c 0a 0a 20 20 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 77 6f 72 ............The.commands.for.wor
13080 6b 69 6e 67 20 77 69 74 68 20 73 65 74 73 20 6f 66 20 63 61 6e 64 69 64 61 74 65 73 20 6a 75 73 king.with.sets.of.candidates.jus
130a0 74 20 64 65 73 63 72 69 62 65 64 2c 0a 20 20 6e 61 6d 65 6c 79 20 60 65 6d 62 61 72 6b 2d 61 63 t.described,...namely.`embark-ac
130c0 74 2d 61 6c 6c 27 2c 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 61 6e 64 20 60 65 6d 62 t-all',.`embark-export'.and.`emb
130e0 61 72 6b 2d 63 6f 6c 6c 65 63 74 27 20 62 79 0a 20 20 64 65 66 61 75 6c 74 20 77 6f 72 6b 20 77 ark-collect'.by...default.work.w
13100 69 74 68 20 61 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 ith.all.candidates.defined.in.th
13120 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 74 65 78 74 2e 20 46 6f 72 0a 20 20 65 78 61 6d 70 6c 65 e.current.context..For...example
13140 2c 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 74 68 65 79 20 6f 70 65 72 61 74 65 ,.in.the.minibuffer.they.operate
13160 20 6f 6e 20 61 6c 6c 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6d 70 6c 65 74 69 6f 6e 0a 20 20 63 .on.all.currently.completion...c
13180 61 6e 64 69 64 61 74 65 73 2c 20 6f 72 20 69 6e 20 61 20 64 69 72 65 64 20 62 75 66 66 65 72 20 andidates,.or.in.a.dired.buffer.
131a0 74 68 65 79 20 77 6f 72 6b 20 6f 6e 20 61 6c 6c 20 6d 61 72 6b 65 64 20 66 69 6c 65 73 20 28 6f they.work.on.all.marked.files.(o
131c0 72 20 61 6c 6c 0a 20 20 66 69 6c 65 73 20 69 66 20 6e 6f 6e 65 20 61 72 65 20 6d 61 72 6b 65 64 r.all...files.if.none.are.marked
131e0 29 2e 20 45 6d 62 61 72 6b 20 61 6c 73 6f 20 68 61 73 20 61 20 6e 6f 74 69 6f 6e 20 6f 66 20 2f )..Embark.also.has.a.notion.of./
13200 73 65 6c 65 63 74 69 6f 6e 2f 2c 0a 20 20 77 68 65 72 65 20 79 6f 75 20 63 61 6e 20 61 63 63 75 selection/,...where.you.can.accu
13220 6d 75 6c 61 74 65 20 61 6e 20 61 64 20 68 6f 63 20 6c 69 73 74 20 6f 66 20 74 61 72 67 65 74 73 mulate.an.ad.hoc.list.of.targets
13240 20 66 6f 72 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 74 6f 20 77 6f 72 6b 20 6f 6e .for.these.commands...to.work.on
13260 2e 0a 0a 20 20 54 68 65 20 73 65 6c 65 63 74 69 6f 6e 20 69 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 .....The.selection.is.controlled
13280 20 62 79 20 75 73 69 6e 67 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 27 20 61 63 .by.using.the.`embark-select'.ac
132a0 74 69 6f 6e 2c 20 62 6f 75 6e 64 0a 20 20 74 6f 20 60 53 50 43 27 20 69 6e 20 60 65 6d 62 61 72 tion,.bound...to.`SPC'.in.`embar
132c0 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 27 20 73 6f 20 74 68 61 74 20 69 74 20 69 73 20 61 6c 77 k-general-map'.so.that.it.is.alw
132e0 61 79 73 20 61 76 61 69 6c 61 62 6c 65 20 28 79 6f 75 0a 20 20 63 61 6e 20 61 6c 73 6f 20 67 69 ays.available.(you...can.also.gi
13300 76 65 20 60 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 27 20 61 20 67 6c 6f 62 61 6c 20 6b 65 79 20 ve.`embark-select'.a.global.key.
13320 62 69 6e 64 69 6e 67 20 69 66 20 79 6f 75 20 77 69 73 68 3b 20 77 68 65 6e 0a 20 20 63 61 6c 6c binding.if.you.wish;.when...call
13340 65 64 20 64 69 72 65 63 74 6c 79 2c 20 6e 6f 74 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 20 66 6f ed.directly,.not.as.an.action.fo
13360 72 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 2c 20 69 74 20 77 69 6c 6c 20 73 65 6c 65 63 74 20 74 r.`embark-act',.it.will.select.t
13380 68 65 0a 20 20 66 69 72 73 74 20 74 61 72 67 65 74 20 61 74 20 70 6f 69 6e 74 29 2e 20 43 61 6c he...first.target.at.point)..Cal
133a0 6c 69 6e 67 20 74 68 69 73 20 61 63 74 69 6f 6e 20 6f 6e 20 61 20 74 61 72 67 65 74 20 74 6f 67 ling.this.action.on.a.target.tog
133c0 67 6c 65 73 20 69 74 73 0a 20 20 6d 65 6d 62 65 72 73 68 69 70 20 69 6e 20 74 68 65 20 63 75 72 gles.its...membership.in.the.cur
133e0 72 65 6e 74 20 62 75 66 66 65 72 27 73 20 45 6d 62 61 72 6b 20 73 65 6c 65 63 74 69 6f 6e 3b 20 rent.buffer's.Embark.selection;.
13400 74 68 61 74 20 69 73 2c 20 69 74 20 61 64 64 73 0a 20 20 69 74 20 74 6f 20 73 65 6c 65 63 74 69 that.is,.it.adds...it.to.selecti
13420 6f 6e 20 69 66 20 6e 6f 74 20 73 65 6c 65 63 74 65 64 20 61 6e 64 20 72 65 6d 6f 76 65 73 20 69 on.if.not.selected.and.removes.i
13440 74 20 66 72 6f 6d 20 74 68 65 20 73 65 6c 65 63 74 69 6f 6e 20 69 66 0a 20 20 69 74 20 77 61 73 t.from.the.selection.if...it.was
13460 20 73 65 6c 65 63 74 65 64 2e 20 57 68 65 6e 65 76 65 72 20 74 68 65 20 73 65 6c 65 63 74 69 6f .selected..Whenever.the.selectio
13480 6e 20 66 6f 72 20 61 20 62 75 66 66 65 72 20 69 73 20 6e 6f 6e 2d 65 6d 70 74 79 2c 20 74 68 65 n.for.a.buffer.is.non-empty,.the
134a0 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 2c 20 60 65 ...commands.`embark-act-all',.`e
134c0 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 61 6e 64 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 mbark-export'.and.`embark-collec
134e0 74 27 20 77 69 6c 6c 0a 20 20 61 63 74 20 6f 6e 20 74 68 65 20 73 65 6c 65 63 74 69 6f 6e 2e 0a t'.will...act.on.the.selection..
13500 0a 20 20 54 6f 20 64 65 73 65 6c 65 63 74 20 61 6c 6c 20 73 65 6c 65 63 74 65 64 20 74 61 72 67 ...To.deselect.all.selected.targ
13520 65 74 73 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 73 65 6c ets,.you.can.use.the.`embark-sel
13540 65 63 74 27 0a 20 20 61 63 74 69 6f 6e 20 74 68 72 6f 75 67 68 20 60 65 6d 62 61 72 6b 2d 61 63 ect'...action.through.`embark-ac
13560 74 2d 61 6c 6c 27 2c 20 73 69 6e 63 65 20 74 68 69 73 20 77 69 6c 6c 20 72 75 6e 20 60 65 6d 62 t-all',.since.this.will.run.`emb
13580 61 72 6b 2d 73 65 6c 65 63 74 27 0a 20 20 6f 6e 20 65 61 63 68 20 6d 65 6d 62 65 72 20 6f 66 20 ark-select'...on.each.member.of.
135a0 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 6c 65 63 74 69 6f 6e 2e 20 53 69 6d 69 6c 61 72 6c 79 the.current.selection..Similarly
135c0 20 69 66 20 6e 6f 20 74 61 72 67 65 74 73 20 61 72 65 0a 20 20 73 65 6c 65 63 74 65 64 20 61 6e .if.no.targets.are...selected.an
135e0 64 20 79 6f 75 20 61 72 65 20 69 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 d.you.are.in.a.minibuffer.comple
13600 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 72 75 6e 6e 69 6e 67 0a 20 20 60 65 6d 62 61 72 6b 2d tion.session,.running...`embark-
13620 73 65 6c 65 63 74 27 20 66 72 6f 6d 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 20 77 69 select'.from.`embark-act-all'.wi
13640 6c 6c 20 73 65 6c 65 63 74 20 61 6c 6c 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 63 6f 6d 70 ll.select.all.the.current...comp
13660 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 2e 0a 0a 20 20 42 79 20 64 65 66 61 75 6c 74 letion.candidates.....By.default
13680 2c 20 77 68 65 6e 65 76 65 72 20 73 6f 6d 65 20 74 61 72 67 65 74 73 20 61 72 65 20 73 65 6c 65 ,.whenever.some.targets.are.sele
136a0 63 74 65 64 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2c 0a 20 20 61 20 cted.in.the.current.buffer,...a.
136c0 63 6f 75 6e 74 20 6f 66 20 73 65 6c 65 63 74 65 64 20 74 61 72 67 65 74 73 20 61 70 70 65 61 72 count.of.selected.targets.appear
136e0 73 20 69 6e 20 74 68 65 20 6d 6f 64 65 20 6c 69 6e 65 2e 20 54 68 69 73 20 63 61 6e 20 62 65 0a s.in.the.mode.line..This.can.be.
13700 20 20 74 75 72 6e 65 64 20 6f 66 66 20 6f 72 20 63 75 73 74 6f 6d 69 7a 65 64 20 74 68 72 6f 75 ..turned.off.or.customized.throu
13720 67 68 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 69 6f 6e 2d 69 6e 64 69 63 61 74 gh.the.`embark-selection-indicat
13740 6f 72 27 20 75 73 65 72 0a 20 20 6f 70 74 69 6f 6e 2e 0a 0a 20 20 54 68 65 20 73 65 6c 65 63 74 or'.user...option.....The.select
13760 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 20 73 75 70 70 6f 72 74 65 64 20 69 ion.functionality.is.supported.i
13780 6e 20 65 76 65 72 79 20 62 75 66 66 65 72 3a 0a 0a 20 20 e2 80 a2 20 49 6e 20 74 68 65 20 6d 69 n.every.buffer:........In.the.mi
137a0 6e 69 62 75 66 66 65 72 20 74 68 69 73 20 67 69 76 65 73 20 61 20 63 6f 6e 76 65 6e 69 65 6e 74 nibuffer.this.gives.a.convenient
137c0 20 77 61 79 20 74 6f 20 61 63 74 20 6f 6e 20 73 65 76 65 72 61 6c 0a 20 20 20 20 63 6f 6d 70 6c .way.to.act.on.several.....compl
137e0 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 74 68 61 74 20 64 6f 6e 27 74 20 66 6f 6c 6c etion.candidates.that.don't.foll
13800 6f 77 20 61 6e 79 20 73 69 6d 70 6c 65 20 70 61 74 74 65 72 6e 3a 20 6a 75 73 74 20 67 6f 0a 20 ow.any.simple.pattern:.just.go..
13820 20 20 20 74 68 72 6f 75 67 68 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 73 65 6c 65 63 ...through.the.completions.selec
13840 74 69 6e 67 20 74 68 65 20 6f 6e 65 73 20 79 6f 75 20 77 61 6e 74 2c 20 74 68 65 6e 20 75 73 65 ting.the.ones.you.want,.then.use
13860 0a 20 20 20 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 2e 20 46 6f 72 20 65 78 61 6d 70 .....`embark-act-all'..For.examp
13880 6c 65 2c 20 79 6f 75 20 63 6f 75 6c 64 20 61 74 74 61 63 68 20 73 65 76 65 72 61 6c 20 66 69 6c le,.you.could.attach.several.fil
138a0 65 73 20 61 74 0a 20 20 20 20 6f 6e 63 65 20 74 6f 20 61 6e 20 65 6d 61 69 6c 2e 0a 20 20 e2 80 es.at.....once.to.an.email......
138c0 a2 20 46 6f 72 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 20 74 68 69 ..For.Embark.Collect.buffers.thi
138e0 73 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 65 6e 61 62 6c 65 73 20 61 20 64 69 72 65 64 2d s.functionality.enables.a.dired-
13900 6c 69 6b 65 0a 20 20 20 20 77 6f 72 6b 66 6c 6f 77 2c 20 69 6e 20 77 68 69 63 68 20 79 6f 75 20 like.....workflow,.in.which.you.
13920 6d 61 72 6b 20 76 61 72 69 6f 75 73 20 63 61 6e 64 69 64 61 74 65 73 20 61 6e 64 20 61 70 70 6c mark.various.candidates.and.appl
13940 79 20 61 6e 20 61 63 74 69 6f 6e 0a 20 20 20 20 74 6f 20 61 6c 6c 20 61 74 20 6f 6e 63 65 2e 20 y.an.action.....to.all.at.once..
13960 28 49 74 20 73 75 70 65 72 73 65 64 65 73 20 61 20 70 72 65 76 69 6f 75 73 20 61 64 20 68 6f 63 (It.supersedes.a.previous.ad.hoc
13980 20 64 69 72 65 64 2d 6c 69 6b 65 0a 20 20 20 20 69 6e 74 65 72 66 61 63 65 20 74 68 61 74 20 77 .dired-like.....interface.that.w
139a0 61 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 6f 6e 6c 79 20 69 6e 20 45 6d 62 61 72 6b 20 43 6f as.implemented.only.in.Embark.Co
139c0 6c 6c 65 63 74 20 62 75 66 66 65 72 73 2c 20 77 69 74 68 0a 20 20 20 20 61 20 73 6c 69 67 68 74 llect.buffers,.with.....a.slight
139e0 6c 79 20 64 69 66 66 65 72 65 6e 74 20 69 6e 74 65 72 66 61 63 65 2e 29 0a 20 20 e2 80 a2 20 49 ly.different.interface.).......I
13a00 6e 20 61 20 65 77 77 20 62 75 66 66 65 72 20 79 6f 75 20 63 6f 75 6c 64 20 75 73 65 20 74 68 69 n.a.eww.buffer.you.could.use.thi
13a20 73 20 74 6f 20 73 65 6c 65 63 74 20 76 61 72 69 6f 75 73 20 6c 69 6e 6b 73 20 79 6f 75 20 77 69 s.to.select.various.links.you.wi
13a40 73 68 0a 20 20 20 20 74 6f 20 66 6f 6c 6c 6f 77 20 75 70 20 6f 6e 2c 20 61 6e 64 20 74 68 65 6e sh.....to.follow.up.on,.and.then
13a60 20 63 6f 6c 6c 65 63 74 20 74 68 65 6d 20 69 6e 74 6f 20 61 20 62 75 66 66 65 72 2e 20 53 69 6d .collect.them.into.a.buffer..Sim
13a80 69 6c 61 72 6c 79 2c 0a 20 20 20 20 77 68 69 6c 65 20 72 65 61 64 69 6e 67 20 45 6d 61 63 73 27 ilarly,.....while.reading.Emacs'
13aa0 73 20 69 6e 66 6f 20 6d 61 6e 75 61 6c 20 79 6f 75 20 63 6f 75 6c 64 20 73 65 6c 65 63 74 20 73 s.info.manual.you.could.select.s
13ac0 6f 6d 65 20 73 79 6d 62 6f 6c 73 20 79 6f 75 0a 20 20 20 20 77 61 6e 74 20 74 6f 20 72 65 61 64 ome.symbols.you.....want.to.read
13ae0 20 6d 6f 72 65 20 61 62 6f 75 74 20 61 6e 64 20 65 78 70 6f 72 74 20 74 68 65 6d 20 74 6f 20 61 .more.about.and.export.them.to.a
13b00 6e 20 60 61 70 72 6f 70 6f 73 2d 6d 6f 64 65 27 20 62 75 66 66 65 72 2e 0a 20 20 e2 80 a2 20 59 n.`apropos-mode'.buffer........Y
13b20 6f 75 20 63 61 6e 20 75 73 65 20 73 65 6c 65 63 74 69 6f 6e 73 20 69 6e 20 72 65 67 75 6c 61 72 ou.can.use.selections.in.regular
13b40 20 74 65 78 74 20 6f 72 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 62 75 66 66 65 72 73 20 74 6f 20 .text.or.programming.buffers.to.
13b60 64 6f 0a 20 20 20 20 63 6f 6d 70 6c 65 78 20 65 64 69 74 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e do.....complex.editing.operation
13b80 73 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20 68 61 76 65 20 74 68 72 65 s..For.example,.if.you.have.thre
13ba0 65 0a 20 20 20 20 70 61 72 61 67 72 61 70 68 73 20 73 63 61 74 74 65 72 65 64 20 6f 76 65 72 20 e.....paragraphs.scattered.over.
13bc0 61 20 66 69 6c 65 20 61 6e 64 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 72 69 6e 67 20 74 68 65 a.file.and.you.want.to.bring.the
13be0 6d 0a 20 20 20 20 74 6f 67 65 74 68 65 72 2c 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 65 m.....together,.you.can.select.e
13c00 61 63 68 20 6f 6e 65 2c 20 69 6e 73 65 72 74 20 74 68 65 6d 20 61 6c 6c 20 73 6f 6d 65 77 68 65 ach.one,.insert.them.all.somewhe
13c20 72 65 20 61 6e 64 0a 20 20 20 20 66 69 6e 61 6c 6c 79 20 64 65 6c 65 74 65 20 61 6c 6c 20 6f 66 re.and.....finally.delete.all.of
13c40 20 74 68 65 6d 20 28 66 72 6f 6d 20 74 68 65 69 72 20 6f 72 69 67 69 6e 61 6c 20 6c 6f 63 61 74 .them.(from.their.original.locat
13c60 69 6f 6e 73 29 2e 0a 0a 0a 31 2e 33 2e 32 20 60 65 6d 62 61 72 6b 2d 6c 69 76 65 27 20 61 20 6c ions)....1.3.2.`embark-live'.a.l
13c80 69 76 65 2d 75 70 64 61 74 69 6e 67 20 76 61 72 69 61 6e 74 20 6f 66 20 60 65 6d 62 61 72 6b 2d ive-updating.variant.of.`embark-
13ca0 63 6f 6c 6c 65 63 74 27 0a e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 collect'........................
13cc0 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
13ce0 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
13d00 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 ................................
13d20 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
13d40 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
13d60 e2 95 8c e2 95 8c 0a 0a 20 20 46 69 6e 61 6c 6c 79 2c 20 74 68 65 72 65 20 69 73 20 61 6c 73 6f ..........Finally,.there.is.also
13d80 20 61 6e 20 60 65 6d 62 61 72 6b 2d 6c 69 76 65 27 20 76 61 72 69 61 6e 74 20 6f 66 20 74 68 65 .an.`embark-live'.variant.of.the
13da0 0a 20 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 27 20 63 6f 6d 6d 61 6e 64 20 77 68 69 63 ...`embark-collect'.command.whic
13dc0 68 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 70 64 61 74 65 73 20 74 68 65 20 63 6f 6c 6c h.automatically.updates.the.coll
13de0 65 63 74 69 6f 6e 0a 20 20 61 66 74 65 72 20 65 61 63 68 20 63 68 61 6e 67 65 20 69 6e 20 74 68 ection...after.each.change.in.th
13e00 65 20 73 6f 75 72 63 65 20 62 75 66 66 65 72 2e 20 55 73 65 72 73 20 6f 66 20 61 20 63 6f 6d 70 e.source.buffer..Users.of.a.comp
13e20 6c 65 74 69 6f 6e 20 55 49 20 74 68 61 74 0a 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 letion.UI.that...automatically.u
13e40 70 64 61 74 65 73 20 61 6e 64 20 64 69 73 70 6c 61 79 73 20 74 68 65 20 63 61 6e 64 69 64 61 74 pdates.and.displays.the.candidat
13e60 65 20 6c 69 73 74 20 28 73 75 63 68 20 61 73 0a 20 20 56 65 72 74 69 63 6f 2c 20 49 63 6f 6d 70 e.list.(such.as...Vertico,.Icomp
13e80 6c 65 74 65 2c 20 46 69 64 6f 2d 6d 6f 64 65 2c 20 6f 72 20 4d 43 54 29 20 77 69 6c 6c 20 70 72 lete,.Fido-mode,.or.MCT).will.pr
13ea0 6f 62 61 62 6c 79 20 6e 6f 74 20 77 61 6e 74 20 74 6f 20 75 73 65 0a 20 20 60 65 6d 62 61 72 6b obably.not.want.to.use...`embark
13ec0 2d 6c 69 76 65 27 20 66 72 6f 6d 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 61 73 20 74 68 -live'.from.the.minibuffer.as.th
13ee0 65 79 20 77 69 6c 6c 20 74 68 65 6e 20 68 61 76 65 20 74 77 6f 20 6c 69 76 65 0a 20 20 75 70 64 ey.will.then.have.two.live...upd
13f00 61 74 69 6e 67 20 64 69 73 70 6c 61 79 73 20 6f 66 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e ating.displays.of.the.completion
13f20 20 63 61 6e 64 69 64 61 74 65 73 21 0a 0a 20 20 41 20 6d 6f 72 65 20 6c 69 6b 65 6c 79 20 75 73 .candidates!....A.more.likely.us
13f40 65 20 6f 66 20 60 65 6d 62 61 72 6b 2d 6c 69 76 65 27 20 69 73 20 74 6f 20 62 65 20 63 61 6c 6c e.of.`embark-live'.is.to.be.call
13f60 65 64 20 66 72 6f 6d 20 61 20 72 65 67 75 6c 61 72 0a 20 20 62 75 66 66 65 72 20 74 6f 20 64 69 ed.from.a.regular...buffer.to.di
13f80 73 70 6c 61 79 20 61 20 73 6f 72 74 20 6f 66 20 6c 69 76 65 20 75 70 64 61 74 69 6e 67 20 22 74 splay.a.sort.of.live.updating."t
13fa0 61 62 6c 65 20 6f 66 20 63 6f 6e 74 65 6e 74 73 22 20 66 6f 72 20 74 68 65 0a 20 20 62 75 66 66 able.of.contents".for.the...buff
13fc0 65 72 2e 20 20 54 68 69 73 20 64 65 70 65 6e 64 73 20 6f 6e 20 68 61 76 69 6e 67 20 61 70 70 72 er...This.depends.on.having.appr
13fe0 6f 70 72 69 61 74 65 20 63 61 6e 64 69 64 61 74 65 20 63 6f 6c 6c 65 63 74 6f 72 73 0a 20 20 63 opriate.candidate.collectors...c
14000 6f 6e 66 69 67 75 72 65 64 20 69 6e 20 60 65 6d 62 61 72 6b 2d 63 61 6e 64 69 64 61 74 65 2d 63 onfigured.in.`embark-candidate-c
14020 6f 6c 6c 65 63 74 6f 72 73 27 2e 20 54 68 65 72 65 20 61 72 65 20 6e 6f 74 20 6d 61 6e 79 20 69 ollectors'..There.are.not.many.i
14040 6e 0a 20 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 n...Embark's.default.configurati
14060 6f 6e 2c 20 62 75 74 20 79 6f 75 20 63 61 6e 20 74 72 79 20 74 68 69 73 20 65 78 70 65 72 69 6d on,.but.you.can.try.this.experim
14080 65 6e 74 3a 20 6f 70 65 6e 0a 20 20 61 20 64 69 72 65 64 20 62 75 66 66 65 72 20 69 6e 20 61 20 ent:.open...a.dired.buffer.in.a.
140a0 64 69 72 65 63 74 6f 72 79 20 74 68 61 74 20 68 61 73 20 76 65 72 79 20 6d 61 6e 79 20 66 69 6c directory.that.has.very.many.fil
140c0 65 73 2c 20 6d 61 72 6b 20 61 20 66 65 77 2c 0a 20 20 61 6e 64 20 72 75 6e 20 60 65 6d 62 61 72 es,.mark.a.few,...and.run.`embar
140e0 6b 2d 6c 69 76 65 27 2e 20 20 59 6f 75 27 6c 6c 20 67 65 74 20 61 6e 20 45 6d 62 61 72 6b 20 43 k-live'...You'll.get.an.Embark.C
14100 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 0a 20 20 6f 6e 6c 79 20 ollect.buffer.containing...only.
14120 74 68 65 20 6d 61 72 6b 65 64 20 66 69 6c 65 73 2c 20 77 68 69 63 68 20 75 70 64 61 74 65 73 20 the.marked.files,.which.updates.
14140 61 73 20 79 6f 75 20 6d 61 72 6b 20 6f 72 20 75 6e 6d 61 72 6b 20 66 69 6c 65 73 20 69 6e 0a 20 as.you.mark.or.unmark.files.in..
14160 20 64 69 72 65 64 2e 20 54 6f 20 6d 61 6b 65 20 60 65 6d 62 61 72 6b 2d 6c 69 76 65 27 20 67 65 .dired..To.make.`embark-live'.ge
14180 6e 75 69 6e 65 6c 79 20 75 73 65 66 75 6c 20 6f 74 68 65 72 20 63 61 6e 64 69 64 61 74 65 0a 20 nuinely.useful.other.candidate..
141a0 20 63 6f 6c 6c 65 63 74 6f 72 73 20 61 72 65 20 72 65 71 75 69 72 65 64 2e 20 20 54 68 65 20 60 .collectors.are.required...The.`
141c0 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 20 70 61 63 6b 61 67 65 20 28 64 6f 63 75 6d 65 6e embark-consult'.package.(documen
141e0 74 65 64 0a 20 20 6e 65 61 72 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 69 73 20 6d 61 6e 75 61 ted...near.the.end.of.this.manua
14200 6c 29 20 63 6f 6e 74 61 69 6e 73 20 61 20 66 65 77 3a 20 6f 6e 65 20 66 6f 72 20 69 6d 65 6e 75 l).contains.a.few:.one.for.imenu
14220 20 69 74 65 6d 73 20 61 6e 64 0a 20 20 6f 6e 65 20 66 6f 72 20 6f 75 74 6c 69 6e 65 20 68 65 61 .items.and...one.for.outline.hea
14240 64 69 6e 67 73 20 61 73 20 75 73 65 64 20 62 79 20 60 6f 75 74 6c 69 6e 65 2d 6d 69 6e 6f 72 2d dings.as.used.by.`outline-minor-
14260 6d 6f 64 65 27 2e 20 54 68 6f 73 65 0a 20 20 63 6f 6c 6c 65 63 74 6f 72 73 20 72 65 61 6c 6c 79 mode'..Those...collectors.really
14280 20 64 6f 20 67 69 76 65 20 60 65 6d 62 61 72 6b 2d 6c 69 76 65 27 20 61 20 74 61 62 6c 65 2d 6f .do.give.`embark-live'.a.table-o
142a0 66 2d 63 6f 6e 74 65 6e 74 73 20 66 65 65 6c 2e 0a 0a 0a 31 2e 34 20 53 77 69 74 63 68 69 6e 67 f-contents.feel....1.4.Switching
142c0 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 .to.a.different.command.without.
142e0 6c 6f 73 69 6e 67 20 77 68 61 74 20 79 6f 75 27 76 65 20 74 79 70 65 64 0a e2 94 80 e2 94 80 e2 losing.what.you've.typed........
14300 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
14320 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
14340 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
14360 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
14380 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
143a0 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
143c0 94 80 e2 94 80 e2 94 80 0a 0a 20 20 45 6d 62 61 72 6b 20 61 6c 73 6f 20 68 61 73 20 74 68 65 20 ............Embark.also.has.the.
143e0 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 20 63 6f 6d 6d 61 6e 64 20 77 68 69 63 68 20 69 73 `embark-become'.command.which.is
14400 20 75 73 65 66 75 6c 20 66 6f 72 20 77 68 65 6e 0a 20 20 79 6f 75 20 72 75 6e 20 61 20 63 6f 6d .useful.for.when...you.run.a.com
14420 6d 61 6e 64 2c 20 73 74 61 72 74 20 74 79 70 69 6e 67 20 61 74 20 74 68 65 20 6d 69 6e 69 62 75 mand,.start.typing.at.the.minibu
14440 66 66 65 72 20 61 6e 64 20 72 65 61 6c 69 7a 65 20 79 6f 75 0a 20 20 6d 65 61 6e 74 20 61 20 64 ffer.and.realize.you...meant.a.d
14460 69 66 66 65 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 2e 20 54 68 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f ifferent.command..The.most.commo
14480 6e 20 63 61 73 65 20 66 6f 72 20 6d 65 20 69 73 20 74 68 61 74 20 49 20 72 75 6e 0a 20 20 60 73 n.case.for.me.is.that.I.run...`s
144a0 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 27 2c 20 73 74 61 72 74 20 74 79 70 69 6e 67 20 61 witch-to-buffer',.start.typing.a
144c0 20 62 75 66 66 65 72 20 6e 61 6d 65 20 61 6e 64 20 72 65 61 6c 69 7a 65 20 49 20 68 61 76 65 6e .buffer.name.and.realize.I.haven
144e0 27 74 0a 20 20 6f 70 65 6e 65 64 20 74 68 65 20 66 69 6c 65 20 49 20 68 61 64 20 69 6e 20 6d 69 't...opened.the.file.I.had.in.mi
14500 6e 64 20 79 65 74 21 20 49 27 6c 6c 20 75 73 65 20 74 68 69 73 20 73 69 74 75 61 74 69 6f 6e 20 nd.yet!.I'll.use.this.situation.
14520 61 73 20 61 0a 20 20 72 75 6e 6e 69 6e 67 20 65 78 61 6d 70 6c 65 20 74 6f 20 69 6c 6c 75 73 74 as.a...running.example.to.illust
14540 72 61 74 65 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 2e 20 57 68 65 6e 20 74 68 69 73 20 rate.`embark-become'..When.this.
14560 68 61 70 70 65 6e 73 20 49 0a 20 20 63 61 6e 2c 20 6f 66 20 63 6f 75 72 73 65 2c 20 70 72 65 73 happens.I...can,.of.course,.pres
14580 73 20 60 43 2d 67 27 20 61 6e 64 20 74 68 65 6e 20 72 75 6e 20 60 66 69 6e 64 2d 66 69 6c 65 27 s.`C-g'.and.then.run.`find-file'
145a0 20 61 6e 64 20 6f 70 65 6e 20 74 68 65 0a 20 20 66 69 6c 65 2c 20 62 75 74 20 74 68 69 73 20 72 .and.open.the...file,.but.this.r
145c0 65 71 75 69 72 65 73 20 72 65 74 79 70 69 6e 67 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 6f 66 20 equires.retyping.the.portion.of.
145e0 74 68 65 20 66 69 6c 65 20 6e 61 6d 65 20 79 6f 75 0a 20 20 61 6c 72 65 61 64 79 20 74 79 70 65 the.file.name.you...already.type
14600 64 2e 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 63 61 6e 20 62 65 20 73 74 72 65 61 6d 6c 69 6e d..This.process.can.be.streamlin
14620 65 64 20 77 69 74 68 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 3a 0a 20 20 77 68 69 6c 65 ed.with.`embark-become':...while
14640 20 73 74 69 6c 6c 20 69 6e 20 74 68 65 20 60 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 27 .still.in.the.`switch-to-buffer'
14660 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 20 61 6e 64 .you.can.run.`embark-become'.and
14680 0a 20 20 65 66 66 65 63 74 69 76 65 6c 79 20 6d 61 6b 65 20 74 68 65 20 60 73 77 69 74 63 68 2d ...effectively.make.the.`switch-
146a0 74 6f 2d 62 75 66 66 65 72 27 20 63 6f 6d 6d 61 6e 64 20 62 65 63 6f 6d 65 20 60 66 69 6e 64 2d to-buffer'.command.become.`find-
146c0 66 69 6c 65 27 20 66 6f 72 0a 20 20 74 68 69 73 20 72 75 6e 2e 0a 0a 20 20 59 6f 75 20 63 61 6e file'.for...this.run.....You.can
146e0 20 62 69 6e 64 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 20 74 6f 20 61 20 6b 65 79 20 69 .bind.`embark-become'.to.a.key.i
14700 6e 20 60 6d 69 6e 69 62 75 66 66 65 72 2d 6c 6f 63 61 6c 2d 6d 61 70 27 2c 20 62 75 74 0a 20 20 n.`minibuffer-local-map',.but...
14720 69 74 20 69 73 20 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 61 6e 20 61 63 74 69 6f it.is.also.available.as.an.actio
14740 6e 20 75 6e 64 65 72 20 74 68 65 20 6c 65 74 74 65 72 20 60 42 27 20 28 75 70 70 65 72 63 61 73 n.under.the.letter.`B'.(uppercas
14760 65 29 2c 20 73 6f 0a 20 20 79 6f 75 20 64 6f 6e 27 74 20 6e 65 65 64 20 61 20 62 69 6e 64 69 6e e),.so...you.don't.need.a.bindin
14780 67 20 69 66 20 79 6f 75 20 61 6c 72 65 61 64 79 20 68 61 76 65 20 6f 6e 65 20 66 6f 72 20 60 65 g.if.you.already.have.one.for.`e
147a0 6d 62 61 72 6b 2d 61 63 74 27 2e 20 53 6f 2c 0a 20 20 61 73 73 75 6d 69 6e 67 20 49 20 68 61 76 mbark-act'..So,...assuming.I.hav
147c0 65 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 62 6f 75 6e 64 20 74 6f 2c 20 73 61 79 2c 20 60 43 e.`embark-act'.bound.to,.say,.`C
147e0 2d 2e 27 2c 20 6f 6e 63 65 20 49 20 72 65 61 6c 69 7a 65 20 49 0a 20 20 68 61 76 65 6e 27 74 20 -.',.once.I.realize.I...haven't.
14800 6f 70 65 6e 20 74 68 65 20 66 69 6c 65 20 49 20 63 61 6e 20 74 79 70 65 20 60 43 2d 2e 20 42 20 open.the.file.I.can.type.`C-..B.
14820 43 2d 78 20 43 2d 66 27 20 74 6f 20 68 61 76 65 0a 20 20 60 73 77 69 74 63 68 2d 74 6f 2d 62 75 C-x.C-f'.to.have...`switch-to-bu
14840 66 66 65 72 27 20 62 65 63 6f 6d 65 20 60 66 69 6e 64 2d 66 69 6c 65 27 20 77 69 74 68 6f 75 74 ffer'.become.`find-file'.without
14860 20 6c 6f 73 69 6e 67 20 77 68 61 74 20 49 20 68 61 76 65 0a 20 20 61 6c 72 65 61 64 79 20 74 79 .losing.what.I.have...already.ty
14880 70 65 64 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 20 20 42 75 74 20 66 6f ped.in.the.minibuffer.....But.fo
148a0 72 20 65 76 65 6e 20 6d 6f 72 65 20 63 6f 6e 76 65 6e 69 65 6e 63 65 2c 20 60 65 6d 62 61 72 6b r.even.more.convenience,.`embark
148c0 2d 62 65 63 6f 6d 65 27 20 6f 66 66 65 72 73 20 73 68 6f 72 74 65 72 20 6b 65 79 0a 20 20 62 69 -become'.offers.shorter.key...bi
148e0 6e 64 69 6e 67 73 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 20 61 72 65 20 6c 69 6b 65 ndings.for.commands.you.are.like
14900 6c 79 20 74 6f 20 77 61 6e 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 74 ly.to.want.the.current.command.t
14920 6f 0a 20 20 62 65 63 6f 6d 65 2e 20 57 68 65 6e 20 79 6f 75 20 75 73 65 20 60 65 6d 62 61 72 6b o...become..When.you.use.`embark
14940 2d 62 65 63 6f 6d 65 27 20 69 74 20 6c 6f 6f 6b 73 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e -become'.it.looks.for.the.curren
14960 74 20 63 6f 6d 6d 61 6e 64 0a 20 20 69 6e 20 61 6c 6c 20 6b 65 79 6d 61 70 73 20 6e 61 6d 65 64 t.command...in.all.keymaps.named
14980 20 69 6e 20 74 68 65 20 6c 69 73 74 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 6b 65 79 6d .in.the.list.`embark-become-keym
149a0 61 70 73 27 20 61 6e 64 20 74 68 65 6e 0a 20 20 61 63 74 69 76 61 74 65 73 20 61 6c 6c 20 6b 65 aps'.and.then...activates.all.ke
149c0 79 6d 61 70 73 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 20 69 74 2e 20 46 6f 72 20 65 78 61 6d 70 ymaps.that.contain.it..For.examp
149e0 6c 65 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 0a 20 20 6f 66 20 60 65 6d 62 61 le,.the.default.value...of.`emba
14a00 72 6b 2d 62 65 63 6f 6d 65 2d 6b 65 79 6d 61 70 73 27 20 63 6f 6e 74 61 69 6e 73 20 61 20 6b 65 rk-become-keymaps'.contains.a.ke
14a20 79 6d 61 70 0a 20 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 66 69 6c 65 2b 62 75 66 66 65 ymap...`embark-become-file+buffe
14a40 72 2d 6d 61 70 27 20 77 69 74 68 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 73 65 76 65 72 61 6c r-map'.with.bindings.for.several
14a60 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 72 65 6c 61 74 65 64 20 74 6f 20 66 69 6c 65 73 20 61 6e 64 .commands...related.to.files.and
14a80 20 62 75 66 66 65 72 73 2c 20 69 6e 20 70 61 72 74 69 63 75 6c 61 72 2c 20 69 74 20 62 69 6e 64 .buffers,.in.particular,.it.bind
14aa0 73 0a 20 20 60 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 27 20 74 6f 20 60 62 27 20 61 6e s...`switch-to-buffer'.to.`b'.an
14ac0 64 20 60 66 69 6e 64 2d 66 69 6c 65 27 20 74 6f 20 60 66 27 2e 20 53 6f 20 77 68 65 6e 20 49 0a d.`find-file'.to.`f'..So.when.I.
14ae0 20 20 61 63 63 69 64 65 6e 74 61 6c 6c 79 20 74 72 79 20 74 6f 20 73 77 69 74 63 68 20 74 6f 20 ..accidentally.try.to.switch.to.
14b00 61 20 62 75 66 66 65 72 20 66 6f 72 20 61 20 66 69 6c 65 20 49 20 68 61 76 65 6e 27 74 20 6f 70 a.buffer.for.a.file.I.haven't.op
14b20 65 6e 65 64 0a 20 20 79 65 74 2c 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 20 66 69 6e 64 ened...yet,.`embark-become'.find
14b40 73 20 74 68 61 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 49 20 72 61 6e 2c 20 60 73 77 69 74 63 s.that.the.command.I.ran,.`switc
14b60 68 2d 74 6f 2d 62 75 66 66 65 72 27 2c 0a 20 20 69 73 20 69 6e 20 74 68 65 20 6b 65 79 6d 61 70 h-to-buffer',...is.in.the.keymap
14b80 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 66 69 6c 65 2b 62 75 66 66 65 72 2d 6d 61 70 27 .`embark-become-file+buffer-map'
14ba0 2c 20 73 6f 20 69 74 20 61 63 74 69 76 61 74 65 73 20 74 68 61 74 0a 20 20 6b 65 79 6d 61 70 20 ,.so.it.activates.that...keymap.
14bc0 28 61 6e 64 20 61 6e 79 20 6f 74 68 65 72 73 20 74 68 61 74 20 61 6c 73 6f 20 63 6f 6e 74 61 69 (and.any.others.that.also.contai
14be0 6e 20 61 20 62 69 6e 64 69 6e 67 20 66 6f 72 0a 20 20 60 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 n.a.binding.for...`switch-to-buf
14c00 66 65 72 27 29 2e 20 54 68 65 20 65 6e 64 20 72 65 73 75 6c 74 20 69 73 20 74 68 61 74 20 49 20 fer')..The.end.result.is.that.I.
14c20 63 61 6e 20 74 79 70 65 20 60 43 2d 2e 20 42 20 66 27 20 74 6f 0a 20 20 73 77 69 74 63 68 20 74 can.type.`C-..B.f'.to...switch.t
14c40 6f 20 60 66 69 6e 64 2d 66 69 6c 65 27 2e 0a 0a 0a 32 20 51 75 69 63 6b 20 73 74 61 72 74 0a e2 o.`find-file'....2.Quick.start..
14c60 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 ................................
14c80 e2 95 90 e2 95 90 0a 0a 20 20 54 68 65 20 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 69 6e 73 ..........The.easiest.way.to.ins
14ca0 74 61 6c 6c 20 45 6d 62 61 72 6b 20 69 73 20 66 72 6f 6d 20 47 4e 55 20 45 4c 50 41 2c 20 6a 75 tall.Embark.is.from.GNU.ELPA,.ju
14cc0 73 74 20 72 75 6e 20 60 4d 2d 78 0a 20 20 70 61 63 6b 61 67 65 2d 69 6e 73 74 61 6c 6c 20 52 45 st.run.`M-x...package-install.RE
14ce0 54 20 65 6d 62 61 72 6b 20 52 45 54 27 2e 20 28 49 74 20 69 73 20 61 6c 73 6f 20 61 76 61 69 6c T.embark.RET'..(It.is.also.avail
14d00 61 62 6c 65 20 6f 6e 20 4d 45 4c 50 41 2e 29 20 49 74 0a 20 20 69 73 20 68 69 67 68 6c 79 20 72 able.on.MELPA.).It...is.highly.r
14d20 65 63 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 61 6c 73 6f 20 69 6e 73 74 61 6c 6c 20 5b 4d 61 72 67 ecommended.to.also.install.[Marg
14d40 69 6e 61 6c 69 61 5d 20 28 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 0a 20 20 47 4e 55 inalia].(also.available.on...GNU
14d60 20 45 4c 50 41 29 2c 20 73 6f 20 74 68 61 74 20 45 6d 62 61 72 6b 20 63 61 6e 20 6f 66 66 65 72 .ELPA),.so.that.Embark.can.offer
14d80 20 79 6f 75 20 70 72 65 63 6f 6e 66 69 67 75 72 65 64 20 61 63 74 69 6f 6e 73 20 69 6e 20 6d 6f .you.preconfigured.actions.in.mo
14da0 72 65 0a 20 20 63 6f 6e 74 65 78 74 73 2e 20 46 6f 72 20 60 75 73 65 2d 70 61 63 6b 61 67 65 27 re...contexts..For.`use-package'
14dc0 20 75 73 65 72 73 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 76 65 72 79 20 .users,.the.following.is.a.very.
14de0 72 65 61 73 6f 6e 61 62 6c 65 0a 20 20 73 74 61 72 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 reasonable...starting.configurat
14e00 69 6f 6e 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 75 ion:..........................(u
14e20 73 65 2d 70 61 63 6b 61 67 65 20 6d 61 72 67 69 6e 61 6c 69 61 0a 20 20 e2 94 82 20 20 20 3a 65 se-package.marginalia.........:e
14e40 6e 73 75 72 65 20 74 0a 20 20 e2 94 82 20 20 20 3a 63 6f 6e 66 69 67 0a 20 20 e2 94 82 20 20 20 nsure.t.........:config.........
14e60 28 6d 61 72 67 69 6e 61 6c 69 61 2d 6d 6f 64 65 29 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 (marginalia-mode))..............
14e80 28 75 73 65 2d 70 61 63 6b 61 67 65 20 65 6d 62 61 72 6b 0a 20 20 e2 94 82 20 20 20 3a 65 6e 73 (use-package.embark.........:ens
14ea0 75 72 65 20 74 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 20 20 3a 62 69 6e 64 0a 20 20 e2 94 82 ure.t................:bind......
14ec0 20 20 20 28 28 22 43 2d 2e 22 20 2e 20 65 6d 62 61 72 6b 2d 61 63 74 29 20 20 20 20 20 20 20 20 ...(("C-."...embark-act)........
14ee0 20 3b 3b 20 70 69 63 6b 20 73 6f 6d 65 20 63 6f 6d 66 6f 72 74 61 62 6c 65 20 62 69 6e 64 69 6e .;;.pick.some.comfortable.bindin
14f00 67 0a 20 20 e2 94 82 20 20 20 20 28 22 43 2d 3b 22 20 2e 20 65 6d 62 61 72 6b 2d 64 77 69 6d 29 g..........("C-;"...embark-dwim)
14f20 20 20 20 20 20 20 20 20 3b 3b 20 67 6f 6f 64 20 61 6c 74 65 72 6e 61 74 69 76 65 3a 20 4d 2d 2e ........;;.good.alternative:.M-.
14f40 0a 20 20 e2 94 82 20 20 20 20 28 22 43 2d 68 20 42 22 20 2e 20 65 6d 62 61 72 6b 2d 62 69 6e 64 ..........("C-h.B"...embark-bind
14f60 69 6e 67 73 29 29 20 3b 3b 20 61 6c 74 65 72 6e 61 74 69 76 65 20 66 6f 72 20 60 64 65 73 63 72 ings)).;;.alternative.for.`descr
14f80 69 62 65 2d 62 69 6e 64 69 6e 67 73 27 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 20 20 3a 69 6e ibe-bindings'................:in
14fa0 69 74 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 20 20 3b 3b 20 4f 70 74 69 6f 6e 61 6c 6c 79 20 it................;;.Optionally.
14fc0 72 65 70 6c 61 63 65 20 74 68 65 20 6b 65 79 20 68 65 6c 70 20 77 69 74 68 20 61 20 63 6f 6d 70 replace.the.key.help.with.a.comp
14fe0 6c 65 74 69 6e 67 2d 72 65 61 64 20 69 6e 74 65 72 66 61 63 65 0a 20 20 e2 94 82 20 20 20 28 73 leting-read.interface.........(s
15000 65 74 71 20 70 72 65 66 69 78 2d 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 20 23 27 65 6d 62 61 72 6b etq.prefix-help-command.#'embark
15020 2d 70 72 65 66 69 78 2d 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 e2 94 82 20 0a 20 20 e2 -prefix-help-command)...........
15040 94 82 20 20 20 3b 3b 20 53 68 6f 77 20 74 68 65 20 45 6d 62 61 72 6b 20 74 61 72 67 65 74 20 61 .....;;.Show.the.Embark.target.a
15060 74 20 70 6f 69 6e 74 20 76 69 61 20 45 6c 64 6f 63 2e 20 59 6f 75 20 6d 61 79 20 61 64 6a 75 73 t.point.via.Eldoc..You.may.adjus
15080 74 20 74 68 65 0a 20 20 e2 94 82 20 20 20 3b 3b 20 45 6c 64 6f 63 20 73 74 72 61 74 65 67 79 2c t.the.........;;.Eldoc.strategy,
150a0 20 69 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73 65 65 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 .if.you.want.to.see.the.document
150c0 61 74 69 6f 6e 20 66 72 6f 6d 0a 20 20 e2 94 82 20 20 20 3b 3b 20 6d 75 6c 74 69 70 6c 65 20 70 ation.from.........;;.multiple.p
150e0 72 6f 76 69 64 65 72 73 2e 20 42 65 77 61 72 65 20 74 68 61 74 20 75 73 69 6e 67 20 74 68 69 73 roviders..Beware.that.using.this
15100 20 63 61 6e 20 62 65 20 61 20 6c 69 74 74 6c 65 0a 20 20 e2 94 82 20 20 20 3b 3b 20 6a 61 72 72 .can.be.a.little.........;;.jarr
15120 69 6e 67 20 73 69 6e 63 65 20 74 68 65 20 6d 65 73 73 61 67 65 20 73 68 6f 77 6e 20 69 6e 20 74 ing.since.the.message.shown.in.t
15140 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 63 61 6e 20 62 65 20 6d 6f 72 65 0a 20 20 e2 94 82 20 he.minibuffer.can.be.more.......
15160 20 20 3b 3b 20 74 68 61 6e 20 6f 6e 65 20 6c 69 6e 65 2c 20 63 61 75 73 69 6e 67 20 74 68 65 20 ..;;.than.one.line,.causing.the.
15180 6d 6f 64 65 6c 69 6e 65 20 74 6f 20 6d 6f 76 65 20 75 70 20 61 6e 64 20 64 6f 77 6e 3a 0a 20 20 modeline.to.move.up.and.down:...
151a0 e2 94 82 20 0a 20 20 e2 94 82 20 20 20 3b 3b 20 28 61 64 64 2d 68 6f 6f 6b 20 27 65 6c 64 6f 63 .............;;.(add-hook.'eldoc
151c0 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2d 66 75 6e 63 74 69 6f 6e 73 20 23 27 65 6d 62 61 72 -documentation-functions.#'embar
151e0 6b 2d 65 6c 64 6f 63 2d 66 69 72 73 74 2d 74 61 72 67 65 74 29 0a 20 20 e2 94 82 20 20 20 3b 3b k-eldoc-first-target).........;;
15200 20 28 73 65 74 71 20 65 6c 64 6f 63 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2d 73 74 72 61 74 .(setq.eldoc-documentation-strat
15220 65 67 79 20 23 27 65 6c 64 6f 63 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2d 63 6f 6d 70 6f 73 egy.#'eldoc-documentation-compos
15240 65 2d 65 61 67 65 72 6c 79 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 20 20 3a 63 6f 6e 66 69 e-eagerly)................:confi
15260 67 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 20 20 3b 3b 20 48 69 64 65 20 74 68 65 20 6d 6f 64 g................;;.Hide.the.mod
15280 65 20 6c 69 6e 65 20 6f 66 20 74 68 65 20 45 6d 62 61 72 6b 20 6c 69 76 65 2f 63 6f 6d 70 6c 65 e.line.of.the.Embark.live/comple
152a0 74 69 6f 6e 73 20 62 75 66 66 65 72 73 0a 20 20 e2 94 82 20 20 20 28 61 64 64 2d 74 6f 2d 6c 69 tions.buffers.........(add-to-li
152c0 73 74 20 27 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 6c 69 73 74 0a 20 20 e2 94 82 20 09 st.'display-buffer-alist........
152e0 20 20 20 20 20 20 20 27 28 22 5c 5c 60 5c 5c 2a 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 5c .......'("\\`\\*Embark.Collect.\
15300 5c 28 4c 69 76 65 5c 5c 7c 43 6f 6d 70 6c 65 74 69 6f 6e 73 5c 5c 29 5c 5c 2a 22 0a 20 20 e2 94 \(Live\\|Completions\\)\\*".....
15320 82 20 09 09 20 6e 69 6c 0a 20 20 e2 94 82 20 09 09 20 28 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 .....nil..........(window-parame
15340 74 65 72 73 20 28 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 20 2e 20 6e 6f 6e 65 29 29 29 ters.(mode-line-format...none)))
15360 29 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 3b 3b 20 43 6f 6e 73 75 6c 74 20 75 73 65 72 73 ))..............;;.Consult.users
15380 20 77 69 6c 6c 20 61 6c 73 6f 20 77 61 6e 74 20 74 68 65 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 .will.also.want.the.embark-consu
153a0 6c 74 20 70 61 63 6b 61 67 65 2e 0a 20 20 e2 94 82 20 28 75 73 65 2d 70 61 63 6b 61 67 65 20 65 lt.package........(use-package.e
153c0 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 0a 20 20 e2 94 82 20 20 20 3a 65 6e 73 75 72 65 20 74 20 mbark-consult.........:ensure.t.
153e0 3b 20 6f 6e 6c 79 20 6e 65 65 64 20 74 6f 20 69 6e 73 74 61 6c 6c 20 69 74 2c 20 65 6d 62 61 72 ;.only.need.to.install.it,.embar
15400 6b 20 6c 6f 61 64 73 20 69 74 20 61 66 74 65 72 20 63 6f 6e 73 75 6c 74 20 69 66 20 66 6f 75 6e k.loads.it.after.consult.if.foun
15420 64 0a 20 20 e2 94 82 20 20 20 3a 68 6f 6f 6b 0a 20 20 e2 94 82 20 20 20 28 65 6d 62 61 72 6b 2d d.........:hook.........(embark-
15440 63 6f 6c 6c 65 63 74 2d 6d 6f 64 65 20 2e 20 63 6f 6e 73 75 6c 74 2d 70 72 65 76 69 65 77 2d 61 collect-mode...consult-preview-a
15460 74 2d 70 6f 69 6e 74 2d 6d 6f 64 65 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 t-point-mode))..................
15480 0a 0a 20 20 41 62 6f 75 74 20 74 68 65 20 73 75 67 67 65 73 74 65 64 20 6b 65 79 20 62 69 6e 64 ....About.the.suggested.key.bind
154a0 69 6e 67 73 20 66 6f 72 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 61 6e 64 20 60 65 6d 62 61 72 ings.for.`embark-act'.and.`embar
154c0 6b 2d 64 77 69 6d 27 3a 0a 20 20 e2 80 a2 20 54 68 6f 73 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 k-dwim':.......Those.key.binding
154e0 73 20 61 72 65 20 75 6e 6c 69 6b 65 6c 79 20 74 6f 20 77 6f 72 6b 20 69 6e 20 74 68 65 20 74 65 s.are.unlikely.to.work.in.the.te
15500 72 6d 69 6e 61 6c 2c 20 62 75 74 0a 20 20 20 20 74 65 72 6d 69 6e 61 6c 20 75 73 65 72 73 20 61 rminal,.but.....terminal.users.a
15520 72 65 20 70 72 6f 62 61 62 6c 79 20 77 65 6c 6c 20 61 77 61 72 65 20 6f 66 20 74 68 69 73 20 61 re.probably.well.aware.of.this.a
15540 6e 64 20 77 69 6c 6c 20 6b 6e 6f 77 20 74 6f 0a 20 20 20 20 73 65 6c 65 63 74 20 64 69 66 66 65 nd.will.know.to.....select.diffe
15560 72 65 6e 74 20 62 69 6e 64 69 6e 67 73 2e 0a 20 20 e2 80 a2 20 54 68 65 20 73 75 67 67 65 73 74 rent.bindings........The.suggest
15580 65 64 20 60 43 2d 2e 27 20 62 69 6e 64 69 6e 67 20 69 73 20 75 73 65 64 20 62 79 20 64 65 66 61 ed.`C-.'.binding.is.used.by.defa
155a0 75 6c 74 20 69 6e 20 28 61 74 20 6c 65 61 73 74 20 73 6f 6d 65 0a 20 20 20 20 69 6e 73 74 61 6c ult.in.(at.least.some.....instal
155c0 6c 61 74 69 6f 6e 73 20 6f 66 29 20 47 4e 4f 4d 45 20 74 6f 20 69 6e 70 75 74 20 65 6d 6f 6a 69 lations.of).GNOME.to.input.emoji
155e0 73 2c 20 61 6e 64 20 45 6d 61 63 73 20 64 6f 65 73 6e 27 74 20 65 76 65 6e 20 67 65 74 0a 20 20 s,.and.Emacs.doesn't.even.get...
15600 20 20 61 20 63 68 61 6e 63 65 20 74 6f 20 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 20 62 69 6e ..a.chance.to.respond.to.the.bin
15620 64 69 6e 67 2e 20 59 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 61 20 64 69 66 66 65 72 65 6e 74 ding..You.can.select.a.different
15640 20 6b 65 79 0a 20 20 20 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 60 65 6d 62 61 72 6b 2d 61 63 74 .key.....binding.for.`embark-act
15660 27 20 6f 72 20 75 73 65 20 60 69 62 75 73 2d 73 65 74 75 70 27 20 74 6f 20 63 68 61 6e 67 65 20 '.or.use.`ibus-setup'.to.change.
15680 74 68 65 20 73 68 6f 72 74 63 75 74 0a 20 20 20 20 66 6f 72 20 65 6d 6f 6a 69 20 69 6e 73 65 72 the.shortcut.....for.emoji.inser
156a0 74 69 6f 6e 20 28 45 6d 61 63 73 20 32 39 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20 75 73 65 20 60 tion.(Emacs.29.will.likely.use.`
156c0 43 2d 78 20 38 20 65 20 65 27 2c 20 69 6e 20 63 61 73 65 0a 20 20 20 20 79 6f 75 20 77 61 6e 74 C-x.8.e.e',.in.case.....you.want
156e0 20 74 6f 20 73 65 74 20 74 68 65 20 73 61 6d 65 20 6f 6e 65 20 73 79 73 74 65 6d 2d 77 69 64 65 .to.set.the.same.one.system-wide
15700 29 2e 0a 20 20 e2 80 a2 20 54 68 65 20 73 75 67 67 65 73 74 65 64 20 61 6c 74 65 72 6e 61 74 69 )........The.suggested.alternati
15720 76 65 20 6f 66 20 60 4d 2d 2e 27 20 66 6f 72 20 60 65 6d 62 61 72 6b 2d 64 77 69 6d 27 20 69 73 ve.of.`M-.'.for.`embark-dwim'.is
15740 20 62 6f 75 6e 64 20 62 79 0a 20 20 20 20 64 65 66 61 75 6c 74 20 74 6f 20 60 78 72 65 66 2d 66 .bound.by.....default.to.`xref-f
15760 69 6e 64 2d 64 65 66 69 6e 69 74 69 6f 6e 73 27 2e 20 54 68 61 74 20 69 73 20 61 20 76 65 72 79 ind-definitions'..That.is.a.very
15780 20 75 73 65 66 75 6c 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 62 75 74 20 6f 76 65 72 77 72 69 74 .useful.command.....but.overwrit
157a0 69 6e 67 20 69 74 20 77 69 74 68 20 60 65 6d 62 61 72 6b 2d 64 77 69 6d 27 20 69 73 20 73 65 6e ing.it.with.`embark-dwim'.is.sen
157c0 73 69 62 6c 65 20 73 69 6e 63 65 20 69 6e 20 45 6d 62 61 72 6b 27 73 0a 20 20 20 20 64 65 66 61 sible.since.in.Embark's.....defa
157e0 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 60 65 6d 62 61 72 6b 2d 64 77 69 6d 27 ult.configuration,.`embark-dwim'
15800 20 77 69 6c 6c 20 61 6c 73 6f 20 66 69 6e 64 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 0a 20 .will.also.find.the.definition..
15820 20 20 20 6f 66 20 74 68 65 20 69 64 65 6e 74 69 66 69 65 72 20 61 74 20 70 6f 69 6e 74 2e 20 28 ...of.the.identifier.at.point..(
15840 4e 6f 74 65 20 74 68 61 74 20 60 78 72 65 66 2d 66 69 6e 64 2d 64 65 66 69 6e 69 74 69 6f 6e 73 Note.that.`xref-find-definitions
15860 27 20 77 69 74 68 0a 20 20 20 20 61 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 70 72 6f '.with.....a.prefix.argument.pro
15880 6d 70 74 73 20 79 6f 75 20 66 6f 72 20 61 6e 20 69 64 65 6e 74 69 66 69 65 72 2c 20 60 65 6d 62 mpts.you.for.an.identifier,.`emb
158a0 61 72 6b 2d 64 77 69 6d 27 20 64 6f 65 73 0a 20 20 20 20 6e 6f 74 20 63 6f 76 65 72 20 74 68 69 ark-dwim'.does.....not.cover.thi
158c0 73 20 63 61 73 65 29 2e 0a 0a 20 20 4f 74 68 65 72 20 45 6d 62 61 72 6b 20 63 6f 6d 6d 61 6e 64 s.case).....Other.Embark.command
158e0 73 20 73 75 63 68 20 61 73 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 2c 20 60 65 6d 62 s.such.as.`embark-act-all',.`emb
15900 61 72 6b 2d 62 65 63 6f 6d 65 27 2c 0a 20 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 27 2c ark-become',...`embark-collect',
15920 20 61 6e 64 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 63 61 6e 20 62 65 20 72 75 6e 20 .and.`embark-export'.can.be.run.
15940 74 68 72 6f 75 67 68 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 0a 20 20 61 73 20 61 63 74 69 6f 6e through.`embark-act'...as.action
15960 73 20 62 6f 75 6e 64 20 74 6f 20 60 41 27 2c 20 60 42 27 2c 20 60 53 27 20 28 66 6f 72 20 22 73 s.bound.to.`A',.`B',.`S'.(for."s
15980 6e 61 70 73 68 6f 74 22 29 2c 20 61 6e 64 20 60 45 27 0a 20 20 72 65 73 70 65 63 74 69 76 65 6c napshot"),.and.`E'...respectivel
159a0 79 2c 20 61 6e 64 20 74 68 75 73 20 64 6f 6e 27 74 20 72 65 61 6c 6c 79 20 6e 65 65 64 20 61 20 y,.and.thus.don't.really.need.a.
159c0 64 65 64 69 63 61 74 65 64 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 62 75 74 0a 20 20 66 65 65 dedicated.key.binding,.but...fee
159e0 6c 20 66 72 65 65 20 74 6f 20 62 69 6e 64 20 74 68 65 6d 20 64 69 72 65 63 74 6c 79 20 69 66 20 l.free.to.bind.them.directly.if.
15a00 79 6f 75 20 73 6f 20 77 69 73 68 2e 20 49 66 20 79 6f 75 20 64 6f 20 63 68 6f 6f 73 65 20 74 6f you.so.wish..If.you.do.choose.to
15a20 0a 20 20 62 69 6e 64 20 74 68 65 6d 20 64 69 72 65 63 74 6c 79 2c 20 79 6f 75 27 6c 6c 20 70 72 ...bind.them.directly,.you'll.pr
15a40 6f 62 61 62 6c 79 20 77 61 6e 74 20 74 6f 20 62 69 6e 64 20 74 68 65 6d 20 69 6e 0a 20 20 60 6d obably.want.to.bind.them.in...`m
15a60 69 6e 69 62 75 66 66 65 72 2d 6c 6f 63 61 6c 2d 6d 61 70 27 2c 20 73 69 6e 63 65 20 74 68 65 79 inibuffer-local-map',.since.they
15a80 20 61 72 65 20 6d 6f 73 74 20 75 73 65 66 75 6c 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 .are.most.useful.in.the.minibuff
15aa0 65 72 0a 20 20 28 69 6e 20 66 61 63 74 2c 20 60 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 27 20 6f er...(in.fact,.`embark-become'.o
15ac0 6e 6c 79 20 77 6f 72 6b 73 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 29 2e 0a 0a 20 nly.works.in.the.minibuffer)....
15ae0 20 54 68 65 20 63 6f 6d 6d 61 6e 64 20 60 65 6d 62 61 72 6b 2d 64 77 69 6d 27 20 65 78 65 63 75 .The.command.`embark-dwim'.execu
15b00 74 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 61 74 0a 20 20 70 6f 69 6e tes.the.default.action.at...poin
15b20 74 2e 20 41 6e 6f 74 68 65 72 20 67 6f 6f 64 20 6b 65 79 62 69 6e 64 69 6e 67 20 66 6f 72 20 60 t..Another.good.keybinding.for.`
15b40 65 6d 62 61 72 6b 2d 64 77 69 6d 27 20 69 73 20 60 4d 2d 2e 27 20 73 69 6e 63 65 0a 20 20 60 65 embark-dwim'.is.`M-.'.since...`e
15b60 6d 62 61 72 6b 2d 64 77 69 6d 27 20 61 63 74 73 20 6c 69 6b 65 20 60 78 72 65 66 2d 66 69 6e 64 mbark-dwim'.acts.like.`xref-find
15b80 2d 64 65 66 69 6e 69 74 69 6f 6e 73 27 20 6f 6e 20 74 68 65 20 73 79 6d 62 6f 6c 20 61 74 0a 20 -definitions'.on.the.symbol.at..
15ba0 20 70 6f 69 6e 74 2e 20 60 43 2d 2e 27 20 63 61 6e 20 62 65 20 73 65 65 6e 20 61 73 20 61 20 72 .point..`C-.'.can.be.seen.as.a.r
15bc0 69 67 68 74 2d 63 6c 69 63 6b 20 63 6f 6e 74 65 78 74 20 6d 65 6e 75 20 61 74 20 70 6f 69 6e 74 ight-click.context.menu.at.point
15be0 20 61 6e 64 0a 20 20 60 4d 2d 2e 27 20 61 63 74 73 20 6c 69 6b 65 20 6c 65 66 74 2d 63 6c 69 63 .and...`M-.'.acts.like.left-clic
15c00 6b 2e 20 54 68 65 20 6b 65 79 62 69 6e 64 69 6e 67 73 20 61 72 65 20 6d 6e 65 6d 6f 6e 69 63 2c k..The.keybindings.are.mnemonic,
15c20 20 62 6f 74 68 20 61 63 74 20 61 74 0a 20 20 74 68 65 20 70 6f 69 6e 74 20 28 60 2e 27 29 2e 0a .both.act.at...the.point.(`.')..
15c40 0a 20 20 45 6d 62 61 72 6b 20 6e 65 65 64 73 20 74 6f 20 6b 6e 6f 77 20 77 68 61 74 20 79 6f 75 ...Embark.needs.to.know.what.you
15c60 72 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 79 73 74 65 6d 20 63 r.minibuffer.completion.system.c
15c80 6f 6e 73 69 64 65 72 73 0a 20 20 74 6f 20 62 65 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63 61 6e onsiders...to.be.the.list.of.can
15ca0 64 69 64 61 74 65 73 20 61 6e 64 20 77 68 69 63 68 20 6f 6e 65 20 69 73 20 74 68 65 20 63 75 72 didates.and.which.one.is.the.cur
15cc0 72 65 6e 74 20 63 61 6e 64 69 64 61 74 65 2e 0a 20 20 45 6d 62 61 72 6b 20 77 6f 72 6b 73 20 6f rent.candidate....Embark.works.o
15ce0 75 74 20 6f 66 20 74 68 65 20 62 6f 78 20 69 66 20 79 6f 75 20 75 73 65 20 45 6d 61 63 73 27 73 ut.of.the.box.if.you.use.Emacs's
15d00 20 64 65 66 61 75 6c 74 20 74 61 62 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 0a 20 20 74 68 65 20 62 .default.tab.completion,...the.b
15d20 75 69 6c 74 2d 69 6e 20 60 69 63 6f 6d 70 6c 65 74 65 2d 6d 6f 64 65 27 20 6f 72 20 60 66 69 64 uilt-in.`icomplete-mode'.or.`fid
15d40 6f 2d 6d 6f 64 65 27 2c 20 6f 72 20 74 68 65 20 74 68 69 72 64 2d 70 61 72 74 79 0a 20 20 70 61 o-mode',.or.the.third-party...pa
15d60 63 6b 61 67 65 73 20 5b 56 65 72 74 69 63 6f 5d 20 6f 72 20 5b 49 76 79 5d 2e 0a 0a 20 20 49 66 ckages.[Vertico].or.[Ivy].....If
15d80 20 79 6f 75 20 61 72 65 20 61 20 5b 48 65 6c 6d 5d 20 6f 72 20 5b 49 76 79 5d 20 75 73 65 72 20 .you.are.a.[Helm].or.[Ivy].user.
15da0 79 6f 75 20 61 72 65 20 75 6e 6c 69 6b 65 6c 79 20 74 6f 20 77 61 6e 74 20 45 6d 62 61 72 6b 0a you.are.unlikely.to.want.Embark.
15dc0 20 20 73 69 6e 63 65 20 74 68 6f 73 65 20 70 61 63 6b 61 67 65 73 20 69 6e 63 6c 75 64 65 20 63 ..since.those.packages.include.c
15de0 6f 6d 70 72 65 68 65 6e 73 69 76 65 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 66 6f 72 20 61 omprehensive.functionality.for.a
15e00 63 74 69 6e 67 20 6f 6e 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e cting.on...minibuffer.completion
15e20 20 63 61 6e 64 69 64 61 74 65 73 2e 20 28 45 6d 62 61 72 6b 20 64 6f 65 73 20 63 6f 6d 65 20 77 .candidates..(Embark.does.come.w
15e40 69 74 68 20 49 76 79 0a 20 20 69 6e 74 65 67 72 61 74 69 6f 6e 20 64 65 73 70 69 74 65 20 74 68 ith.Ivy...integration.despite.th
15e60 69 73 2e 29 0a 0a 0a 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 is.)...[Marginalia].<https://git
15e80 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 6d 61 72 67 69 6e 61 6c 69 61 3e 0a 0a 5b 56 65 72 74 hub.com/minad/marginalia>..[Vert
15ea0 69 63 6f 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 76 ico].<https://github.com/minad/v
15ec0 65 72 74 69 63 6f 3e 0a 0a 5b 49 76 79 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 ertico>..[Ivy].<https://github.c
15ee0 6f 6d 2f 61 62 6f 2d 61 62 6f 2f 73 77 69 70 65 72 3e 0a 0a 5b 48 65 6c 6d 5d 20 3c 68 74 74 70 om/abo-abo/swiper>..[Helm].<http
15f00 73 3a 2f 2f 65 6d 61 63 73 2d 68 65 6c 6d 2e 67 69 74 68 75 62 2e 69 6f 2f 68 65 6c 6d 2f 3e 0a s://emacs-helm.github.io/helm/>.
15f20 0a 0a 33 20 41 64 76 61 6e 63 65 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a e2 95 90 e2 95 ..3.Advanced.configuration......
15f40 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 ................................
15f60 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 ................................
15f80 e2 95 90 0a 0a 33 2e 31 20 53 68 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f .....3.1.Showing.information.abo
15fa0 75 74 20 61 76 61 69 6c 61 62 6c 65 20 74 61 72 67 65 74 73 20 61 6e 64 20 61 63 74 69 6f 6e 73 ut.available.targets.and.actions
15fc0 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
15fe0 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
16000 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
16020 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
16040 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
16060 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 42 79 20 64 65 66 61 75 6c 74 ......................By.default
16080 2c 20 69 66 20 79 6f 75 20 72 75 6e 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 61 6e 64 20 64 6f ,.if.you.run.`embark-act'.and.do
160a0 20 6e 6f 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 73 65 6c 65 63 74 20 61 6e 0a 20 20 61 63 74 .not.immediately.select.an...act
160c0 69 6f 6e 2c 20 61 66 74 65 72 20 61 20 73 68 6f 72 74 20 64 65 6c 61 79 20 45 6d 62 61 72 6b 20 ion,.after.a.short.delay.Embark.
160e0 77 69 6c 6c 20 70 6f 70 20 75 70 20 61 20 62 75 66 66 65 72 20 63 61 6c 6c 65 64 0a 20 20 60 2a will.pop.up.a.buffer.called...`*
16100 45 6d 62 61 72 6b 20 41 63 74 69 6f 6e 73 2a 27 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 6c 69 Embark.Actions*'.containing.a.li
16120 73 74 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 61 63 74 69 6f 6e 73 20 77 69 74 68 20 74 68 65 st.of.available.actions.with.the
16140 69 72 0a 20 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 20 59 6f 75 20 63 61 6e 20 73 63 72 6f 6c ir...key.bindings..You.can.scrol
16160 6c 20 74 68 61 74 20 62 75 66 66 65 72 20 77 69 74 68 20 74 68 65 20 6d 6f 75 73 65 20 6f 66 20 l.that.buffer.with.the.mouse.of.
16180 77 69 74 68 20 74 68 65 0a 20 20 75 73 75 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 60 73 63 72 6f 6c with.the...usual.commands.`scrol
161a0 6c 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 27 20 61 6e 64 20 60 73 63 72 6f 6c 6c 2d 6f 74 68 65 l-other-window'.and.`scroll-othe
161c0 72 2d 77 69 6e 64 6f 77 2d 64 6f 77 6e 27 0a 20 20 28 62 6f 75 6e 64 20 62 79 20 64 65 66 61 75 r-window-down'...(bound.by.defau
161e0 6c 74 20 74 6f 20 60 43 2d 4d 2d 76 27 20 61 6e 64 20 60 43 2d 4d 2d 53 2d 76 27 29 2e 0a 0a 20 lt.to.`C-M-v'.and.`C-M-S-v')....
16200 20 54 68 61 74 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 20 70 72 6f 76 69 64 65 64 20 .That.functionality.is.provided.
16220 62 79 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 6d 69 78 65 64 2d 69 6e 64 69 63 61 74 6f 72 27 2c by.the.`embark-mixed-indicator',
16240 20 62 75 74 0a 20 20 45 6d 62 61 72 6b 20 68 61 73 20 6f 74 68 65 72 20 69 6e 64 69 63 61 74 6f .but...Embark.has.other.indicato
16260 72 73 20 74 68 61 74 20 63 61 6e 20 70 72 6f 76 69 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 rs.that.can.provide.information.
16280 61 62 6f 75 74 20 74 68 65 0a 20 20 74 61 72 67 65 74 20 61 6e 64 20 69 74 73 20 74 79 70 65 2c about.the...target.and.its.type,
162a0 20 77 68 61 74 20 6f 74 68 65 72 20 74 61 72 67 65 74 73 20 79 6f 75 20 63 61 6e 20 63 79 63 6c .what.other.targets.you.can.cycl
162c0 65 20 74 6f 2c 20 61 6e 64 20 77 68 69 63 68 0a 20 20 61 63 74 69 6f 6e 73 20 68 61 76 65 20 6b e.to,.and.which...actions.have.k
162e0 65 79 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 74 68 65 20 61 63 74 69 6f 6e 20 6d 61 70 20 66 6f ey.bindings.in.the.action.map.fo
16300 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 79 70 65 20 6f 66 0a 20 20 74 61 72 67 65 74 2e 20 r.the.current.type.of...target..
16320 41 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69 63 61 74 6f 72 73 20 63 61 6e 20 62 65 20 Any.number.of.indicators.can.be.
16340 61 63 74 69 76 65 20 61 74 20 6f 6e 63 65 20 61 6e 64 20 74 68 65 20 75 73 65 72 0a 20 20 6f 70 active.at.once.and.the.user...op
16360 74 69 6f 6e 20 60 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 27 20 73 68 6f 75 6c 64 20 tion.`embark-indicators'.should.
16380 62 65 20 73 65 74 20 74 6f 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 20 64 65 73 69 72 65 64 0a be.set.to.a.list.of.the.desired.
163a0 20 20 69 6e 64 69 63 61 74 6f 72 73 2e 0a 0a 20 20 45 6d 62 61 72 6b 20 63 6f 6d 65 73 20 77 69 ..indicators.....Embark.comes.wi
163c0 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 64 69 63 61 74 6f 72 73 3a 0a 0a 20 20 th.the.following.indicators:....
163e0 e2 80 a2 20 60 65 6d 62 61 72 6b 2d 6d 69 6e 69 6d 61 6c 2d 69 6e 64 69 63 61 74 6f 72 27 3a 20 ....`embark-minimal-indicator':.
16400 73 68 6f 77 73 20 61 20 6d 65 73 73 61 67 65 73 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 65 shows.a.messages.in.the.echo.are
16420 61 20 6f 72 0a 20 20 20 20 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 20 73 68 6f 77 69 a.or.....minibuffer.prompt.showi
16440 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 20 61 6e 64 20 74 68 65 20 74 79 ng.the.current.target.and.the.ty
16460 70 65 73 20 6f 66 20 61 6c 6c 0a 20 20 20 20 74 61 72 67 65 74 73 20 73 74 61 72 74 69 6e 67 20 pes.of.all.....targets.starting.
16480 77 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 6f 6e 65 2e 0a 0a 20 20 e2 80 a2 20 60 65 6d with.the.current.one.........`em
164a0 62 61 72 6b 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 27 3a 20 68 69 67 68 6c bark-highlight-indicator':.highl
164c0 69 67 68 74 73 20 74 68 65 20 74 61 72 67 65 74 20 61 74 20 70 6f 69 6e 74 3b 20 6f 6e 20 62 79 ights.the.target.at.point;.on.by
164e0 0a 20 20 20 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 e2 80 a2 20 60 65 6d 62 61 72 6b 2d 76 65 72 .....default.........`embark-ver
16500 62 6f 73 65 2d 69 6e 64 69 63 61 74 6f 72 27 3a 20 64 69 73 70 6c 61 79 73 20 61 20 74 61 62 6c bose-indicator':.displays.a.tabl
16520 65 20 6f 66 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 69 72 0a 20 20 20 20 6b 65 79 20 62 e.of.actions.and.their.....key.b
16540 69 6e 64 69 6e 67 73 20 69 6e 20 61 20 62 75 66 66 65 72 3b 20 74 68 69 73 20 69 73 20 6e 6f 74 indings.in.a.buffer;.this.is.not
16560 20 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 2c 20 69 6e 20 66 61 76 6f 72 20 6f 66 20 74 68 65 0a .on.by.default,.in.favor.of.the.
16580 20 20 20 20 6d 69 78 65 64 20 69 6e 64 69 63 61 74 6f 72 20 64 65 73 63 72 69 62 65 64 20 6e 65 ....mixed.indicator.described.ne
165a0 78 74 2e 0a 0a 20 20 e2 80 a2 20 60 65 6d 62 61 72 6b 2d 6d 69 78 65 64 2d 69 6e 64 69 63 61 74 xt.........`embark-mixed-indicat
165c0 6f 72 27 3a 20 73 74 61 72 74 73 20 6f 75 74 20 62 79 20 62 65 68 61 76 69 6e 67 20 61 73 20 74 or':.starts.out.by.behaving.as.t
165e0 68 65 20 6d 69 6e 69 6d 61 6c 0a 20 20 20 20 69 6e 64 69 63 61 74 6f 72 20 62 75 74 20 61 66 74 he.minimal.....indicator.but.aft
16600 65 72 20 61 20 73 68 6f 72 74 20 64 65 6c 61 79 20 61 63 74 73 20 61 73 20 74 68 65 20 76 65 72 er.a.short.delay.acts.as.the.ver
16620 62 6f 73 65 20 69 6e 64 69 63 61 74 6f 72 3b 0a 20 20 20 20 74 68 69 73 20 69 73 20 6f 6e 20 62 bose.indicator;.....this.is.on.b
16640 79 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 e2 80 a2 20 60 65 6d 62 61 72 6b 2d 69 73 65 61 72 63 y.default.........`embark-isearc
16660 68 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 27 3a 20 74 68 69 73 20 6f 6e 6c h-highlight-indicator':.this.onl
16680 79 20 64 6f 65 73 20 73 6f 6d 65 74 68 69 6e 67 20 77 68 65 6e 0a 20 20 20 20 74 68 65 20 63 75 y.does.something.when.....the.cu
166a0 72 72 65 6e 74 20 74 61 72 67 65 74 20 69 73 20 74 68 65 20 73 79 6d 62 6f 6c 20 61 74 20 70 6f rrent.target.is.the.symbol.at.po
166c0 69 6e 74 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 69 74 20 6c 61 7a 69 6c 79 0a 20 20 20 int,.in.which.case.it.lazily....
166e0 20 68 69 67 68 6c 69 67 68 74 73 20 61 6c 6c 20 6f 63 63 75 72 72 65 6e 63 65 73 20 6f 66 20 74 .highlights.all.occurrences.of.t
16700 68 61 74 20 73 79 6d 62 6f 6c 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 hat.symbol.in.the.current.buffer
16720 2c 0a 20 20 20 20 6c 69 6b 65 20 69 73 65 61 72 63 68 3b 20 61 6c 73 6f 20 6f 6e 20 62 79 20 64 ,.....like.isearch;.also.on.by.d
16740 65 66 61 75 6c 74 2e 0a 0a 20 20 55 73 65 72 73 20 6f 66 20 74 68 65 20 70 6f 70 75 6c 61 72 20 efault.....Users.of.the.popular.
16760 5b 77 68 69 63 68 2d 6b 65 79 5d 20 70 61 63 6b 61 67 65 20 6d 61 79 20 70 72 65 66 65 72 20 74 [which-key].package.may.prefer.t
16780 6f 20 75 73 65 20 74 68 65 0a 20 20 60 65 6d 62 61 72 6b 2d 77 68 69 63 68 2d 6b 65 79 2d 69 6e o.use.the...`embark-which-key-in
167a0 64 69 63 61 74 6f 72 27 20 66 72 6f 6d 20 74 68 65 20 5b 45 6d 62 61 72 6b 20 77 69 6b 69 5d 2e dicator'.from.the.[Embark.wiki].
167c0 20 4a 75 73 74 20 63 6f 70 79 20 69 74 73 0a 20 20 64 65 66 69 6e 69 74 69 6f 6e 20 66 72 6f 6d .Just.copy.its...definition.from
167e0 20 74 68 65 20 77 69 6b 69 20 69 6e 74 6f 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f .the.wiki.into.your.configuratio
16800 6e 20 61 6e 64 20 63 75 73 74 6f 6d 69 7a 65 20 74 68 65 0a 20 20 60 65 6d 62 61 72 6b 2d 69 6e n.and.customize.the...`embark-in
16820 64 69 63 61 74 6f 72 73 27 20 75 73 65 72 20 6f 70 74 69 6f 6e 20 74 6f 20 65 78 63 6c 75 64 65 dicators'.user.option.to.exclude
16840 20 74 68 65 20 6d 69 78 65 64 20 61 6e 64 20 76 65 72 62 6f 73 65 0a 20 20 69 6e 64 69 63 61 74 .the.mixed.and.verbose...indicat
16860 6f 72 73 20 61 6e 64 20 74 6f 20 69 6e 63 6c 75 64 65 20 60 65 6d 62 61 72 6b 2d 77 68 69 63 68 ors.and.to.include.`embark-which
16880 2d 6b 65 79 2d 69 6e 64 69 63 61 74 6f 72 27 2e 0a 0a 20 20 49 66 20 79 6f 75 20 75 73 65 20 5b -key-indicator'.....If.you.use.[
168a0 56 65 72 74 69 63 6f 5d 2c 20 74 68 65 72 65 20 69 73 20 61 6e 20 65 76 65 6e 20 65 61 73 69 65 Vertico],.there.is.an.even.easie
168c0 72 20 77 61 79 20 74 6f 20 67 65 74 20 61 0a 20 20 60 77 68 69 63 68 2d 6b 65 79 27 2d 6c 69 6b r.way.to.get.a...`which-key'-lik
168e0 65 20 64 69 73 70 6c 61 79 20 74 68 61 74 20 61 6c 73 6f 20 6c 65 74 73 20 79 6f 75 20 75 73 65 e.display.that.also.lets.you.use
16900 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 74 6f 20 6e 61 72 72 6f 77 0a 20 20 64 6f 77 6e 20 74 68 65 .completion.to.narrow...down.the
16920 20 6c 69 73 74 20 6f 66 20 61 6c 74 65 72 6e 61 74 69 76 65 73 2c 20 64 65 73 63 72 69 62 65 64 .list.of.alternatives,.described
16940 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6e 65 78 74 0a 20 20 73 65 63 74 69 6f .at.the.end.of.the.next...sectio
16960 6e 2e 0a 0a 0a 5b 77 68 69 63 68 2d 6b 65 79 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 n....[which-key].<https://github
16980 2e 63 6f 6d 2f 6a 75 73 74 62 75 72 2f 65 6d 61 63 73 2d 77 68 69 63 68 2d 6b 65 79 3e 0a 0a 5b .com/justbur/emacs-which-key>..[
169a0 45 6d 62 61 72 6b 20 77 69 6b 69 5d 0a 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d Embark.wiki].<https://github.com
169c0 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 77 69 6b 69 2f 41 64 64 69 74 69 6f 6e 61 6c /oantolin/embark/wiki/Additional
169e0 2d 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 23 75 73 65 2d 77 68 69 63 68 2d 6b 65 79 2d 6c 69 6b -Configuration#use-which-key-lik
16a00 65 2d 61 2d 6b 65 79 2d 6d 65 6e 75 2d 70 72 6f 6d 70 74 3e 0a 0a 5b 56 65 72 74 69 63 6f 5d 20 e-a-key-menu-prompt>..[Vertico].
16a20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 76 65 72 74 69 63 <https://github.com/minad/vertic
16a40 6f 3e 0a 0a 0a 33 2e 32 20 53 65 6c 65 63 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 76 69 61 20 o>...3.2.Selecting.commands.via.
16a60 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 69 6e 73 74 65 61 64 20 6f 66 20 6b 65 79 20 62 69 6e 64 69 completions.instead.of.key.bindi
16a80 6e 67 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ngs.............................
16aa0 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
16ac0 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
16ae0 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
16b00 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
16b20 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a ................................
16b40 20 20 41 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 74 6f 20 72 65 61 64 69 6e 67 20 74 ..As.an.alternative.to.reading.t
16b60 68 65 20 6c 69 73 74 20 6f 66 20 61 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 76 65 72 62 6f 73 he.list.of.actions.in.the.verbos
16b80 65 20 6f 72 0a 20 20 6d 69 78 65 64 20 69 6e 64 69 63 61 74 6f 72 73 20 28 73 65 65 20 74 68 65 e.or...mixed.indicators.(see.the
16ba0 20 70 72 65 76 69 6f 75 73 20 73 65 63 74 69 6f 6e 20 66 6f 72 20 61 20 64 65 73 63 72 69 70 74 .previous.section.for.a.descript
16bc0 69 6f 6e 20 6f 66 0a 20 20 74 68 65 73 65 29 2c 20 79 6f 75 20 63 61 6e 20 70 72 65 73 73 20 74 ion.of...these),.you.can.press.t
16be0 68 65 20 60 65 6d 62 61 72 6b 2d 68 65 6c 70 2d 6b 65 79 27 2c 20 77 68 69 63 68 20 69 73 20 60 he.`embark-help-key',.which.is.`
16c00 43 2d 68 27 20 62 79 20 64 65 66 61 75 6c 74 0a 20 20 28 62 75 74 20 79 6f 75 20 6d 61 79 20 70 C-h'.by.default...(but.you.may.p
16c20 72 65 66 65 72 20 60 3f 27 20 74 6f 20 66 72 65 65 20 75 70 20 60 43 2d 68 27 20 66 6f 72 20 75 refer.`?'.to.free.up.`C-h'.for.u
16c40 73 65 20 61 73 20 61 20 70 72 65 66 69 78 29 20 61 66 74 65 72 0a 20 20 72 75 6e 6e 69 6e 67 20 se.as.a.prefix).after...running.
16c60 60 65 6d 62 61 72 6b 2d 61 63 74 27 2e 20 50 72 65 73 73 69 6e 67 20 74 68 65 20 68 65 6c 70 20 `embark-act'..Pressing.the.help.
16c80 6b 65 79 20 77 69 6c 6c 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 74 68 65 0a 20 20 6e 61 key.will.prompt.you.for.the...na
16ca0 6d 65 20 6f 66 20 61 6e 20 61 63 74 69 6f 6e 20 77 69 74 68 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 me.of.an.action.with.completion.
16cc0 28 62 75 74 20 66 65 65 6c 20 66 72 65 65 20 74 6f 20 65 6e 74 65 72 20 61 20 63 6f 6d 6d 61 6e (but.feel.free.to.enter.a.comman
16ce0 64 0a 20 20 74 68 61 74 20 69 73 20 6e 6f 74 20 61 6d 6f 6e 67 20 74 68 65 20 6f 66 66 65 72 65 d...that.is.not.among.the.offere
16d00 64 20 63 61 6e 64 69 64 61 74 65 73 21 29 2c 20 61 6e 64 20 77 69 6c 6c 20 61 6c 73 6f 20 72 65 d.candidates!),.and.will.also.re
16d20 6d 69 6e 64 20 79 6f 75 0a 20 20 6f 66 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 20 mind.you...of.the.key.bindings..
16d40 59 6f 75 20 63 61 6e 20 70 72 65 73 73 20 60 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 70 72 6f You.can.press.`embark-keymap-pro
16d60 6d 70 74 65 72 2d 6b 65 79 27 2c 20 77 68 69 63 68 0a 20 20 69 73 20 60 40 27 20 62 79 20 64 65 mpter-key',.which...is.`@'.by.de
16d80 66 61 75 6c 74 2c 20 61 74 20 74 68 65 20 70 72 6f 6d 70 74 20 61 6e 64 20 74 68 65 6e 20 6f 6e fault,.at.the.prompt.and.then.on
16da0 65 20 6f 66 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 74 6f 0a 20 20 65 6e 74 65 72 e.of.the.key.bindings.to...enter
16dc0 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 61 .the.name.of.the.corresponding.a
16de0 63 74 69 6f 6e 2e 0a 0a 20 20 59 6f 75 20 6d 61 79 20 74 68 69 6e 6b 20 74 68 61 74 20 77 69 74 ction.....You.may.think.that.wit
16e00 68 20 74 68 65 20 60 2a 45 6d 62 61 72 6b 20 41 63 74 69 6f 6e 73 2a 27 20 62 75 66 66 65 72 20 h.the.`*Embark.Actions*'.buffer.
16e20 70 6f 70 70 69 6e 67 20 75 70 20 74 6f 0a 20 20 72 65 6d 69 6e 64 20 79 6f 75 20 6f 66 20 74 68 popping.up.to...remind.you.of.th
16e40 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 79 6f 75 27 64 20 6e 65 76 65 72 20 77 61 6e 74 20 e.key.bindings.you'd.never.want.
16e60 74 6f 20 75 73 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 74 6f 0a 20 20 73 65 6c 65 63 74 20 61 6e to.use.completion.to...select.an
16e80 20 61 63 74 69 6f 6e 20 62 79 20 6e 61 6d 65 2c 20 62 75 74 20 70 65 72 73 6f 6e 61 6c 6c 79 20 .action.by.name,.but.personally.
16ea0 49 20 66 69 6e 64 20 74 68 61 74 20 74 79 70 69 6e 67 20 61 20 73 6d 61 6c 6c 0a 20 20 70 6f 72 I.find.that.typing.a.small...por
16ec0 74 69 6f 6e 20 6f 66 20 74 68 65 20 61 63 74 69 6f 6e 20 6e 61 6d 65 20 74 6f 20 6e 61 72 72 6f tion.of.the.action.name.to.narro
16ee0 77 20 64 6f 77 6e 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63 61 6e 64 69 64 61 74 65 73 20 66 65 w.down.the.list.of.candidates.fe
16f00 65 6c 73 0a 20 20 73 69 67 6e 69 66 69 63 61 6e 74 6c 79 20 66 61 73 74 65 72 20 74 68 61 6e 20 els...significantly.faster.than.
16f20 76 69 73 75 61 6c 6c 79 20 73 63 61 6e 6e 69 6e 67 20 74 68 65 20 65 6e 74 69 72 65 20 6c 69 73 visually.scanning.the.entire.lis
16f40 74 20 6f 66 0a 20 20 61 63 74 69 6f 6e 73 2e 0a 0a 20 20 49 66 20 79 6f 75 20 66 69 6e 64 20 79 t.of...actions.....If.you.find.y
16f60 6f 75 20 70 72 65 66 65 72 20 73 65 6c 65 63 74 69 6e 67 20 61 63 74 69 6f 6e 73 20 74 68 61 74 ou.prefer.selecting.actions.that
16f80 20 77 61 79 2c 20 79 6f 75 20 63 61 6e 20 63 6f 6e 66 69 67 75 72 65 0a 20 20 65 6d 62 61 72 6b .way,.you.can.configure...embark
16fa0 20 74 6f 20 61 6c 77 61 79 73 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 61 63 74 69 6f 6e .to.always.prompt.you.for.action
16fc0 73 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 20 20 60 65 6d 62 s.by.setting.the.variable...`emb
16fe0 61 72 6b 2d 70 72 6f 6d 70 74 65 72 27 20 74 6f 20 60 65 6d 62 61 72 6b 2d 63 6f 6d 70 6c 65 74 ark-prompter'.to.`embark-complet
17000 69 6e 67 2d 72 65 61 64 2d 70 72 6f 6d 70 74 65 72 27 2e 0a 0a 20 20 4f 6e 20 74 68 65 20 6f 74 ing-read-prompter'.....On.the.ot
17020 68 65 72 20 68 61 6e 64 2c 20 79 6f 75 20 6d 61 79 20 77 69 73 68 20 74 6f 20 63 6f 6e 74 69 6e her.hand,.you.may.wish.to.contin
17040 75 65 20 75 73 69 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 0a 20 20 ue.using.key.bindings.for.the...
17060 61 63 74 69 6f 6e 73 20 79 6f 75 20 70 65 72 66 6f 72 6d 20 6d 6f 73 74 20 6f 66 74 65 6e 2c 20 actions.you.perform.most.often,.
17080 61 6e 64 20 74 6f 20 75 73 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 6e 6c 79 20 74 6f 20 65 78 and.to.use.completion.only.to.ex
170a0 70 6c 6f 72 65 0a 20 20 77 68 61 74 20 66 75 72 74 68 65 72 20 61 63 74 69 6f 6e 73 20 61 72 65 plore...what.further.actions.are
170c0 20 61 76 61 69 6c 61 62 6c 65 20 6f 72 20 77 68 65 6e 20 79 6f 75 27 76 65 20 66 6f 72 67 6f 74 .available.or.when.you've.forgot
170e0 74 65 6e 20 61 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 2e 20 49 6e 20 74 68 61 74 20 63 61 73 ten.a.key...binding..In.that.cas
17100 65 2c 20 79 6f 75 20 6d 61 79 20 70 72 65 66 65 72 20 74 6f 20 75 73 65 20 74 68 65 20 6d 69 6e e,.you.may.prefer.to.use.the.min
17120 69 6d 61 6c 20 69 6e 64 69 63 61 74 6f 72 2c 0a 20 20 77 68 69 63 68 20 64 6f 65 73 20 6e 6f 74 imal.indicator,...which.does.not
17140 20 70 6f 70 2d 75 70 20 61 6e 20 60 2a 45 6d 62 61 72 6b 20 41 63 74 69 6f 6e 73 2a 27 20 62 75 .pop-up.an.`*Embark.Actions*'.bu
17160 66 66 65 72 20 61 74 20 61 6c 6c 2c 20 61 6e 64 20 74 6f 20 75 73 65 0a 20 20 74 68 65 20 60 65 ffer.at.all,.and.to.use...the.`e
17180 6d 62 61 72 6b 2d 68 65 6c 70 2d 6b 65 79 27 20 77 68 65 6e 65 76 65 72 20 79 6f 75 20 6e 65 65 mbark-help-key'.whenever.you.nee
171a0 64 20 68 65 6c 70 2e 20 54 68 69 73 20 75 6e 6f 62 74 72 75 73 69 76 65 20 73 65 74 75 70 0a 20 d.help..This.unobtrusive.setup..
171c0 20 69 73 20 61 63 68 69 65 76 65 64 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 .is.achieved.with.the.following.
171e0 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 configuration:..................
17200 80 0a 20 20 e2 94 82 20 28 73 65 74 71 20 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 0a ........(setq.embark-indicators.
17220 20 20 e2 94 82 20 20 20 20 20 20 20 27 28 65 6d 62 61 72 6b 2d 6d 69 6e 69 6d 61 6c 2d 69 6e 64 ............'(embark-minimal-ind
17240 69 63 61 74 6f 72 20 20 3b 20 64 65 66 61 75 6c 74 20 69 73 20 65 6d 62 61 72 6b 2d 6d 69 78 65 icator..;.default.is.embark-mixe
17260 64 2d 69 6e 64 69 63 61 74 6f 72 0a 20 20 e2 94 82 20 09 65 6d 62 61 72 6b 2d 68 69 67 68 6c 69 d-indicator........embark-highli
17280 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 0a 20 20 e2 94 82 20 09 65 6d 62 61 72 6b 2d 69 73 65 61 ght-indicator........embark-isea
172a0 72 63 68 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 29 29 0a 20 20 e2 94 94 e2 rch-highlight-indicator)).......
172c0 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 5b 56 65 72 74 69 63 6f 5d 20 75 73 65 72 73 20 6d ...............[Vertico].users.m
172e0 61 79 20 77 69 73 68 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 61 20 67 72 69 64 20 64 69 73 70 ay.wish.to.configure.a.grid.disp
17300 6c 61 79 20 66 6f 72 20 74 68 65 20 61 63 74 69 6f 6e 73 0a 20 20 61 6e 64 20 6b 65 79 2d 62 69 lay.for.the.actions...and.key-bi
17320 6e 64 69 6e 67 73 2c 20 72 65 6d 69 6e 69 73 63 65 6e 74 20 6f 66 20 74 68 65 20 70 6f 70 75 6c ndings,.reminiscent.of.the.popul
17340 61 72 20 70 61 63 6b 61 67 65 20 5b 77 68 69 63 68 2d 6b 65 79 5d 2c 20 62 75 74 2c 0a 20 20 6f ar.package.[which-key],.but,...o
17360 66 20 63 6f 75 72 73 65 2c 20 65 6e 68 61 6e 63 65 64 20 62 79 20 74 68 65 20 75 73 65 20 6f 66 f.course,.enhanced.by.the.use.of
17380 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 74 6f 20 6e 61 72 72 6f 77 20 74 68 65 20 6c 69 73 74 20 6f .completion.to.narrow.the.list.o
173a0 66 0a 20 20 63 6f 6d 6d 61 6e 64 73 2e 20 49 6e 20 6f 72 64 65 72 20 74 6f 20 67 65 74 20 74 68 f...commands..In.order.to.get.th
173c0 65 20 67 72 69 64 20 64 69 73 70 6c 61 79 2c 20 70 75 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e e.grid.display,.put.the.followin
173e0 67 20 69 6e 20 79 6f 75 72 0a 20 20 56 65 72 74 69 63 6f 20 63 6f 6e 66 69 67 75 72 61 74 69 6f g.in.your...Vertico.configuratio
17400 6e 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 61 64 64 n:..........................(add
17420 2d 74 6f 2d 6c 69 73 74 20 27 76 65 72 74 69 63 6f 2d 6d 75 6c 74 69 66 6f 72 6d 2d 63 61 74 65 -to-list.'vertico-multiform-cate
17440 67 6f 72 69 65 73 20 27 28 65 6d 62 61 72 6b 2d 6b 65 79 62 69 6e 64 69 6e 67 20 67 72 69 64 29 gories.'(embark-keybinding.grid)
17460 29 0a 20 20 e2 94 82 20 28 76 65 72 74 69 63 6f 2d 6d 75 6c 74 69 66 6f 72 6d 2d 6d 6f 64 65 29 ).......(vertico-multiform-mode)
17480 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 54 68 69 73 20 77 69 6c 6c 20 ......................This.will.
174a0 6d 61 6b 65 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 6b 65 79 73 20 62 65 20 73 68 6f 77 6e make.the.available.keys.be.shown
174c0 20 69 6e 20 61 20 63 6f 6d 70 61 63 74 20 67 72 69 64 20 6c 69 6b 65 20 69 6e 0a 20 20 60 77 68 .in.a.compact.grid.like.in...`wh
174e0 69 63 68 2d 6b 65 79 27 2e 20 54 68 65 20 60 76 65 72 74 69 63 6f 2d 6d 75 6c 74 69 66 6f 72 6d ich-key'..The.`vertico-multiform
17500 2d 6d 6f 64 65 27 20 61 6c 73 6f 20 65 6e 61 62 6c 65 73 20 6b 65 79 73 20 73 75 63 68 20 61 73 -mode'.also.enables.keys.such.as
17520 0a 20 20 60 4d 2d 56 27 2c 20 60 4d 2d 47 27 2c 20 60 4d 2d 42 27 2c 20 61 6e 64 20 60 4d 2d 55 ...`M-V',.`M-G',.`M-B',.and.`M-U
17540 27 20 66 6f 72 20 6d 61 6e 75 61 6c 6c 79 20 73 77 69 74 63 68 69 6e 67 20 62 65 74 77 65 65 6e '.for.manually.switching.between
17560 20 6c 61 79 6f 75 74 73 0a 20 20 69 6e 20 56 65 72 74 69 63 6f 20 62 75 66 66 65 72 73 2e 0a 0a .layouts...in.Vertico.buffers...
17580 0a 5b 56 65 72 74 69 63 6f 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d .[Vertico].<https://github.com/m
175a0 69 6e 61 64 2f 76 65 72 74 69 63 6f 3e 0a 0a 5b 77 68 69 63 68 2d 6b 65 79 5d 20 3c 68 74 74 70 inad/vertico>..[which-key].<http
175c0 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 75 73 74 62 75 72 2f 65 6d 61 63 73 2d 77 68 69 s://github.com/justbur/emacs-whi
175e0 63 68 2d 6b 65 79 3e 0a 0a 33 2e 32 2e 31 20 53 65 6c 65 63 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 ch-key>..3.2.1.Selecting.command
17600 73 20 76 69 61 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f 75 74 73 69 64 65 20 6f 66 20 45 6d 62 61 s.via.completion.outside.of.Emba
17620 72 6b 0a e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 rk..............................
17640 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
17660 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
17680 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 ................................
176a0 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
176c0 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c 0a 0a 20 20 49 66 20 79 6f 75 20 6c 69 6b 65 20 74 68 ..................If.you.like.th
176e0 69 73 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 69 6e 74 65 72 66 61 63 65 20 66 6f 72 20 65 78 70 6c is.completion.interface.for.expl
17700 6f 72 69 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 0a 20 20 45 6d 62 61 72 6b 20 oring.key.bindings.for...Embark.
17720 61 63 74 69 6f 6e 73 2c 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 75 73 65 20 69 74 20 actions,.you.may.want.to.use.it.
17740 65 6c 73 65 77 68 65 72 65 20 69 6e 20 45 6d 61 63 73 2e 20 59 6f 75 20 63 61 6e 20 75 73 65 0a elsewhere.in.Emacs..You.can.use.
17760 20 20 45 6d 62 61 72 6b 27 73 20 63 6f 6d 70 6c 65 74 69 6f 6e 2d 62 61 73 65 64 20 63 6f 6d 6d ..Embark's.completion-based.comm
17780 61 6e 64 20 70 72 6f 6d 70 74 65 72 20 74 6f 20 6c 69 73 74 3a 0a 0a 20 20 e2 80 a2 20 6b 65 79 and.prompter.to.list:........key
177a0 20 62 69 6e 64 69 6e 67 73 20 75 6e 64 65 72 20 61 20 70 72 65 66 69 78 2c 0a 20 20 e2 80 a2 20 .bindings.under.a.prefix,.......
177c0 6c 6f 63 61 6c 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2c 20 6f 72 0a 20 20 e2 80 a2 20 61 6c 6c local.key.bindings,.or.......all
177e0 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 0a 0a 20 20 54 6f 20 75 73 65 20 69 74 20 66 6f 72 20 .key.bindings.....To.use.it.for.
17800 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 75 6e 64 65 72 20 61 20 70 72 65 66 69 78 20 28 79 6f 75 key.bindings.under.a.prefix.(you
17820 20 63 61 6e 20 75 73 65 20 74 68 69 73 20 74 6f 20 72 65 70 6c 61 63 65 0a 20 20 74 68 65 20 60 .can.use.this.to.replace...the.`
17840 77 68 69 63 68 2d 6b 65 79 27 20 70 61 63 6b 61 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 29 which-key'.package,.for.example)
17860 2c 20 75 73 65 20 74 68 69 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 20 20 e2 94 8c ,.use.this.configuration:.......
17880 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 73 65 74 71 20 70 72 65 66 69 78 2d ...................(setq.prefix-
178a0 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 20 23 27 65 6d 62 61 72 6b 2d 70 72 65 66 69 78 2d 68 65 6c help-command.#'embark-prefix-hel
178c0 70 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 p-command)......................
178e0 4e 6f 77 2c 20 77 68 65 6e 20 79 6f 75 20 68 61 76 65 20 73 74 61 72 74 65 64 20 6f 6e 20 61 20 Now,.when.you.have.started.on.a.
17900 70 72 65 66 69 78 20 73 65 71 75 65 6e 63 65 20 73 75 63 68 20 61 73 20 60 43 2d 78 27 20 6f 72 prefix.sequence.such.as.`C-x'.or
17920 0a 20 20 60 43 2d 63 27 2c 20 70 72 65 73 73 69 6e 67 20 60 43 2d 68 27 20 77 69 6c 6c 20 62 72 ...`C-c',.pressing.`C-h'.will.br
17940 69 6e 67 20 75 70 20 74 68 65 20 45 6d 62 61 72 6b 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 ing.up.the.Embark.version.of.the
17960 20 62 75 69 6c 74 2d 69 6e 0a 20 20 60 70 72 65 66 69 78 2d 68 65 6c 70 2d 63 6f 6d 6d 61 6e 64 .built-in...`prefix-help-command
17980 27 2c 20 77 68 69 63 68 20 77 69 6c 6c 20 6c 69 73 74 20 74 68 65 20 6b 65 79 73 20 75 6e 64 65 ',.which.will.list.the.keys.unde
179a0 72 20 74 68 61 74 20 70 72 65 66 69 78 20 61 6e 64 0a 20 20 74 68 65 69 72 20 62 69 6e 64 69 6e r.that.prefix.and...their.bindin
179c0 67 73 2c 20 61 6e 64 20 6c 65 74 73 20 79 6f 75 20 73 65 6c 65 63 74 20 74 68 65 20 6f 6e 65 20 gs,.and.lets.you.select.the.one.
179e0 79 6f 75 20 77 61 6e 74 65 64 20 77 69 74 68 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 6f 72 you.wanted.with...completion,.or
17a00 20 62 79 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 69 66 20 79 6f 75 20 70 72 65 73 73 0a 20 20 60 .by.key.binding.if.you.press...`
17a20 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 70 72 6f 6d 70 74 65 72 2d 6b 65 79 27 2e 0a 0a 20 20 embark-keymap-prompter-key'.....
17a40 54 6f 20 6c 69 73 74 20 6c 6f 63 61 6c 20 6f 72 20 67 6c 6f 62 61 6c 20 6b 65 79 20 62 69 6e 64 To.list.local.or.global.key.bind
17a60 69 6e 67 73 2c 20 75 73 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 60 65 6d 62 61 72 6b 2d ings,.use.the.command...`embark-
17a80 62 69 6e 64 69 6e 67 73 27 2e 20 20 59 6f 75 20 63 61 6e 20 62 69 6e 64 20 74 68 61 74 20 74 6f bindings'...You.can.bind.that.to
17aa0 20 60 43 2d 68 20 62 27 2c 20 77 68 69 63 68 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 .`C-h.b',.which.is.the.default..
17ac0 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 60 64 .key.binding.for.the.built-in.`d
17ae0 65 73 63 72 69 62 65 2d 62 69 6e 64 69 6e 67 73 27 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 escribe-bindings'.command,.which
17b00 20 74 68 69 73 0a 20 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 72 65 70 6c 61 63 65 2e 20 42 79 20 .this...command.can.replace..By.
17b20 64 65 66 61 75 6c 74 2c 20 60 65 6d 62 61 72 6b 2d 62 69 6e 64 69 6e 67 73 27 20 6c 69 73 74 73 default,.`embark-bindings'.lists
17b40 20 6c 6f 63 61 6c 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 73 2c 20 74 79 70 69 63 61 6c 6c 79 .local.key...bindings,.typically
17b60 20 74 68 6f 73 65 20 62 6f 75 6e 64 20 69 6e 20 74 68 65 20 6d 61 6a 6f 72 20 6d 6f 64 65 20 6b .those.bound.in.the.major.mode.k
17b80 65 79 6d 61 70 3b 20 74 6f 20 67 65 74 0a 20 20 67 6c 6f 62 61 6c 20 62 69 6e 64 69 6e 67 73 20 eymap;.to.get...global.bindings.
17ba0 61 73 20 77 65 6c 6c 2c 20 63 61 6c 6c 20 69 74 20 77 69 74 68 20 61 20 60 43 2d 75 27 20 70 72 as.well,.call.it.with.a.`C-u'.pr
17bc0 65 66 69 78 20 61 72 67 75 6d 65 6e 74 2e 0a 0a 0a 33 2e 33 20 51 75 69 74 74 69 6e 67 20 74 68 efix.argument....3.3.Quitting.th
17be0 65 20 6d 69 6e 69 62 75 66 66 65 72 20 61 66 74 65 72 20 61 6e 20 61 63 74 69 6f 6e 0a e2 94 80 e.minibuffer.after.an.action....
17c00 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
17c20 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
17c40 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
17c60 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a ................................
17c80 20 20 42 79 20 64 65 66 61 75 6c 74 2c 20 69 66 20 79 6f 75 20 63 61 6c 6c 20 60 65 6d 62 61 72 ..By.default,.if.you.call.`embar
17ca0 6b 2d 61 63 74 27 20 66 72 6f 6d 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 74 20 71 75 k-act'.from.the.minibuffer.it.qu
17cc0 69 74 73 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 61 66 74 65 72 20 70 65 72 66 6f its.the...minibuffer.after.perfo
17ce0 72 6d 69 6e 67 20 74 68 65 20 61 63 74 69 6f 6e 2e 20 59 6f 75 20 63 61 6e 20 63 68 61 6e 67 65 rming.the.action..You.can.change
17d00 20 74 68 69 73 20 62 79 20 73 65 74 74 69 6e 67 0a 20 20 74 68 65 20 75 73 65 72 20 6f 70 74 69 .this.by.setting...the.user.opti
17d20 6f 6e 20 60 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 66 74 65 72 2d 61 63 74 69 6f 6e 27 20 74 6f on.`embark-quit-after-action'.to
17d40 20 60 6e 69 6c 27 2e 20 48 61 76 69 6e 67 0a 20 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 2f 6e .`nil'..Having...`embark-act'./n
17d60 6f 74 2f 20 71 75 69 74 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 63 61 6e 20 62 65 20 75 ot/.quit.the.minibuffer.can.be.u
17d80 73 65 66 75 6c 20 74 6f 20 74 75 72 6e 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 69 6e 74 6f 20 6c 69 seful.to.turn.commands...into.li
17da0 74 74 6c 65 20 22 74 68 69 6e 67 20 6d 61 6e 61 67 65 72 73 22 2e 20 46 6f 72 20 65 78 61 6d 70 ttle."thing.managers"..For.examp
17dc0 6c 65 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 60 66 69 6e 64 2d 66 69 6c 65 27 20 61 73 0a 20 le,.you.can.use.`find-file'.as..
17de0 20 61 20 6c 69 74 74 6c 65 20 66 69 6c 65 20 6d 61 6e 61 67 65 72 20 6f 72 20 60 64 65 73 63 72 .a.little.file.manager.or.`descr
17e00 69 62 65 2d 70 61 63 6b 61 67 65 27 20 61 73 20 61 20 6c 69 74 74 6c 65 20 70 61 63 6b 61 67 65 ibe-package'.as.a.little.package
17e20 0a 20 20 6d 61 6e 61 67 65 72 3a 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 74 68 6f 73 65 20 63 6f ...manager:.you.can.run.those.co
17e40 6d 6d 61 6e 64 73 2c 20 70 65 72 66 6f 72 6d 20 61 20 73 65 72 69 65 73 20 6f 66 20 61 63 74 69 mmands,.perform.a.series.of.acti
17e60 6f 6e 73 2c 20 61 6e 64 0a 20 20 74 68 65 6e 20 71 75 69 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 ons,.and...then.quit.the.command
17e80 2e 0a 0a 20 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 65 20 .....If.you.want.to.control.the.
17ea0 71 75 69 74 74 69 6e 67 20 62 65 68 61 76 69 6f 72 20 69 6e 20 61 20 66 69 6e 65 2d 67 72 61 69 quitting.behavior.in.a.fine-grai
17ec0 6e 65 64 20 6d 61 6e 6e 65 72 0a 20 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 61 63 ned.manner...depending.on.the.ac
17ee0 74 69 6f 6e 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 20 60 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 tion,.you.can.set.`embark-quit-a
17f00 66 74 65 72 2d 61 63 74 69 6f 6e 27 20 74 6f 20 61 6e 0a 20 20 61 6c 69 73 74 2c 20 61 73 73 6f fter-action'.to.an...alist,.asso
17f20 63 69 61 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 65 69 74 68 65 72 20 60 74 27 20 66 ciating.commands.to.either.`t'.f
17f40 6f 72 20 71 75 69 74 74 69 6e 67 20 6f 72 20 60 6e 69 6c 27 20 66 6f 72 0a 20 20 6e 6f 74 20 71 or.quitting.or.`nil'.for...not.q
17f60 75 69 74 74 69 6e 67 2e 20 57 68 65 6e 20 75 73 69 6e 67 20 61 6e 20 61 6c 69 73 74 2c 20 79 6f uitting..When.using.an.alist,.yo
17f80 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 73 70 65 63 69 61 6c 20 6b 65 79 20 60 74 27 20 74 6f u.can.use.the.special.key.`t'.to
17fa0 0a 20 20 73 70 65 63 69 66 79 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 2e ...specify.the.default.behavior.
17fc0 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 61 74 20 62 79 .For.example,.to.specify.that.by
17fe0 20 64 65 66 61 75 6c 74 0a 20 20 61 63 74 69 6f 6e 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 71 75 .default...actions.should.not.qu
18000 69 74 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 62 75 74 20 74 68 61 74 20 75 73 69 6e 67 it.the.minibuffer.but.that.using
18020 20 60 6b 69 6c 6c 2d 62 75 66 66 65 72 27 20 61 73 0a 20 20 61 6e 20 61 63 74 69 6f 6e 20 73 68 .`kill-buffer'.as...an.action.sh
18040 6f 75 6c 64 20 71 75 69 74 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f ould.quit,.you.can.use.the.follo
18060 77 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 wing.configuration:.............
18080 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 73 65 74 71 20 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 .............(setq.embark-quit-a
180a0 66 74 65 72 2d 61 63 74 69 6f 6e 20 27 28 28 6b 69 6c 6c 2d 62 75 66 66 65 72 20 2e 20 74 29 20 fter-action.'((kill-buffer...t).
180c0 28 74 20 2e 20 6e 69 6c 29 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 (t...nil))).....................
180e0 20 54 68 65 20 76 61 72 69 61 62 6c 65 20 60 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 66 74 65 72 .The.variable.`embark-quit-after
18100 2d 61 63 74 69 6f 6e 27 20 6f 6e 6c 79 20 73 70 65 63 69 66 69 65 73 20 61 20 64 65 66 61 75 6c -action'.only.specifies.a.defaul
18120 74 2c 20 74 68 61 74 0a 20 20 69 73 2c 20 69 74 20 6f 6e 6c 79 20 63 6f 6e 74 72 6f 6c 73 20 77 t,.that...is,.it.only.controls.w
18140 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 71 75 69 74 73 hether.or.not.`embark-act'.quits
18160 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 0a 20 20 77 68 65 6e 20 79 6f 75 20 63 61 6c 6c 20 .the.minibuffer...when.you.call.
18180 69 74 20 77 69 74 68 6f 75 74 20 61 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 2c 20 61 6e it.without.a.prefix.argument,.an
181a0 64 20 79 6f 75 20 63 61 6e 20 73 65 6c 65 63 74 20 74 68 65 0a 20 20 6f 70 70 6f 73 69 74 65 20 d.you.can.select.the...opposite.
181c0 62 65 68 61 76 69 6f 72 20 74 6f 20 77 68 61 74 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 73 61 behavior.to.what.the.variable.sa
181e0 79 73 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 0a 20 20 77 69 74 ys.by.calling.`embark-act'...wit
18200 68 20 60 43 2d 75 27 2e 20 41 6c 73 6f 20 6e 6f 74 65 20 74 68 61 74 20 62 6f 74 68 20 74 68 65 h.`C-u'..Also.note.that.both.the
18220 20 76 61 72 69 61 62 6c 65 0a 20 20 60 65 6d 62 61 72 6b 2d 71 75 69 74 2d 61 66 74 65 72 2d 61 .variable...`embark-quit-after-a
18240 63 74 69 6f 6e 27 20 61 6e 64 20 60 43 2d 75 27 20 68 61 76 65 20 6e 6f 20 65 66 66 65 63 74 20 ction'.and.`C-u'.have.no.effect.
18260 77 68 65 6e 20 79 6f 75 20 63 61 6c 6c 0a 20 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 20 6f 75 74 when.you.call...`embark-act'.out
18280 73 69 64 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 20 20 49 66 20 79 6f 75 20 66 side.the.minibuffer.....If.you.f
182a0 69 6e 64 20 79 6f 75 72 73 65 6c 66 20 75 73 69 6e 67 20 74 68 65 20 71 75 69 74 74 69 6e 67 20 ind.yourself.using.the.quitting.
182c0 61 6e 64 20 6e 6f 6e 2d 71 75 69 74 74 69 6e 67 20 76 61 72 69 61 6e 74 73 20 6f 66 0a 20 20 60 and.non-quitting.variants.of...`
182e0 65 6d 62 61 72 6b 2d 61 63 74 27 20 61 62 6f 75 74 20 65 71 75 61 6c 6c 79 20 6f 66 74 65 6e 2c embark-act'.about.equally.often,
18300 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 68 65 20 61 63 74 69 6f 6e 2c 20 79 6f .independently.of.the.action,.yo
18320 75 20 6d 61 79 0a 20 20 70 72 65 66 65 72 20 74 6f 20 73 69 6d 70 6c 79 20 68 61 76 65 20 73 65 u.may...prefer.to.simply.have.se
18340 70 61 72 61 74 65 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 74 68 65 6d 20 69 6e 73 74 65 61 64 parate.commands.for.them.instead
18360 20 6f 66 20 61 20 73 69 6e 67 6c 65 0a 20 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 79 6f 75 20 .of.a.single...command.that.you.
18380 63 61 6c 6c 20 77 69 74 68 20 60 43 2d 75 27 20 68 61 6c 66 20 74 68 65 20 74 69 6d 65 2e 20 59 call.with.`C-u'.half.the.time..Y
183a0 6f 75 20 63 6f 75 6c 64 2c 20 66 6f 72 0a 20 20 65 78 61 6d 70 6c 65 2c 20 6b 65 65 70 20 74 68 ou.could,.for...example,.keep.th
183c0 65 20 64 65 66 61 75 6c 74 20 65 78 69 74 69 6e 67 20 62 65 68 61 76 69 6f 72 20 6f 66 20 60 65 e.default.exiting.behavior.of.`e
183e0 6d 62 61 72 6b 2d 61 63 74 27 20 61 6e 64 20 64 65 66 69 6e 65 0a 20 20 61 20 6e 6f 6e 2d 71 75 mbark-act'.and.define...a.non-qu
18400 69 74 74 69 6e 67 20 76 65 72 73 69 6f 6e 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 e2 94 itting.version.as.follows:......
18420 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 65 6d 62 61 72 ....................(defun.embar
18440 6b 2d 61 63 74 2d 6e 6f 71 75 69 74 20 28 29 0a 20 20 e2 94 82 20 20 20 22 52 75 6e 20 61 63 74 k-act-noquit.()........."Run.act
18460 69 6f 6e 20 62 75 74 20 64 6f 6e 27 74 20 71 75 69 74 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 ion.but.don't.quit.the.minibuffe
18480 72 20 61 66 74 65 72 77 61 72 64 73 2e 22 0a 20 20 e2 94 82 20 20 20 28 69 6e 74 65 72 61 63 74 r.afterwards.".........(interact
184a0 69 76 65 29 0a 20 20 e2 94 82 20 20 20 28 6c 65 74 20 28 28 65 6d 62 61 72 6b 2d 71 75 69 74 2d ive).........(let.((embark-quit-
184c0 61 66 74 65 72 2d 61 63 74 69 6f 6e 20 6e 69 6c 29 29 0a 20 20 e2 94 82 20 20 20 20 20 28 65 6d after-action.nil))...........(em
184e0 62 61 72 6b 2d 61 63 74 29 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 0a bark-act))).....................
18500 33 2e 34 20 52 75 6e 6e 69 6e 67 20 73 6f 6d 65 20 73 65 74 75 70 20 61 66 74 65 72 20 69 6e 6a 3.4.Running.some.setup.after.inj
18520 65 63 74 69 6e 67 20 74 68 65 20 74 61 72 67 65 74 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ecting.the.target...............
18540 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
18560 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
18580 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
185a0 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
185c0 94 80 e2 94 80 0a 0a 20 20 59 6f 75 20 63 61 6e 20 63 75 73 74 6f 6d 69 7a 65 20 77 68 61 74 20 .........You.can.customize.what.
185e0 68 61 70 70 65 6e 73 20 61 66 74 65 72 20 74 68 65 20 74 61 72 67 65 74 20 69 73 20 69 6e 73 65 happens.after.the.target.is.inse
18600 72 74 65 64 20 61 74 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 20 rted.at.the...minibuffer.prompt.
18620 6f 66 20 61 6e 20 61 63 74 69 6f 6e 2e 20 54 68 65 72 65 20 61 72 65 0a 20 20 60 65 6d 62 61 72 of.an.action..There.are...`embar
18640 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2c 20 74 68 61 74 20 k-target-injection-hooks',.that.
18660 61 72 65 20 72 75 6e 20 62 79 20 64 65 66 61 75 6c 74 20 61 66 74 65 72 0a 20 20 69 6e 6a 65 63 are.run.by.default.after...injec
18680 74 69 6e 67 20 74 68 65 20 74 61 72 67 65 74 20 69 6e 74 6f 20 74 68 65 20 6d 69 6e 69 62 75 66 ting.the.target.into.the.minibuf
186a0 66 65 72 2e 20 54 68 65 20 76 61 72 69 61 62 6c 65 0a 20 20 60 65 6d 62 61 72 6b 2d 74 61 72 67 fer..The.variable...`embark-targ
186c0 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 20 69 73 20 61 6e 20 61 6c 69 73 74 20 et-injection-hooks'.is.an.alist.
186e0 61 73 73 6f 63 69 61 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 0a 20 20 74 68 65 69 72 20 associating.commands.to...their.
18700 73 65 74 75 70 20 68 6f 6f 6b 73 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 73 70 65 63 69 setup.hooks..There.are.two.speci
18720 61 6c 20 6b 65 79 73 3a 20 69 66 20 6e 6f 20 73 65 74 75 70 20 68 6f 6f 6b 20 69 73 0a 20 20 73 al.keys:.if.no.setup.hook.is...s
18740 70 65 63 69 66 69 65 64 20 66 6f 72 20 61 20 67 69 76 65 6e 20 61 63 74 69 6f 6e 2c 20 74 68 65 pecified.for.a.given.action,.the
18760 20 68 6f 6f 6b 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 60 74 27 20 69 73 20 72 75 6e 3b 20 .hook.associated.to.`t'.is.run;.
18780 61 6e 64 0a 20 20 74 68 65 20 68 6f 6f 6b 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 60 3a 61 and...the.hook.associated.to.`:a
187a0 6c 77 61 79 73 27 20 69 73 20 72 75 6e 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 0a lways'.is.run.regardless.of.the.
187c0 20 20 61 63 74 69 6f 6e 2e 20 28 54 68 69 73 20 76 61 72 69 61 62 6c 65 20 75 73 65 64 20 74 6f ..action..(This.variable.used.to
187e0 20 68 61 76 65 20 74 68 65 20 6c 65 73 73 20 65 78 70 6c 69 63 69 74 20 6e 61 6d 65 20 6f 66 0a .have.the.less.explicit.name.of.
18800 20 20 60 65 6d 62 61 72 6b 2d 73 65 74 75 70 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2c 20 73 ..`embark-setup-action-hooks',.s
18820 6f 20 70 6c 65 61 73 65 20 75 70 64 61 74 65 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 o.please.update.your.configurati
18840 6f 6e 2e 29 0a 0a 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 63 6f 6e 73 69 64 65 72 20 75 73 on.)....For.example,.consider.us
18860 69 6e 67 20 60 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 27 20 61 73 20 61 6e 20 61 63 74 69 6f 6e ing.`shell-command'.as.an.action
18880 20 64 75 72 69 6e 67 20 66 69 6c 65 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 2e 20 49 74 20 77 6f .during.file...completion..It.wo
188a0 75 6c 64 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 69 6e 73 65 72 74 20 61 20 73 70 61 63 65 20 uld.be.useful.to.insert.a.space.
188c0 62 65 66 6f 72 65 20 74 68 65 20 74 61 72 67 65 74 0a 20 20 66 69 6c 65 20 6e 61 6d 65 20 61 6e before.the.target...file.name.an
188e0 64 20 74 6f 20 6c 65 61 76 65 20 74 68 65 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 62 65 67 69 d.to.leave.the.point.at.the.begi
18900 6e 6e 69 6e 67 2c 20 73 6f 20 79 6f 75 20 63 61 6e 0a 20 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 nning,.so.you.can...immediately.
18920 74 79 70 65 20 74 68 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 72 75 6e 20 6f 6e type.the.shell.command.to.run.on
18940 20 74 68 61 74 20 66 69 6c 65 2e 20 54 68 61 74 27 73 20 77 68 79 20 69 6e 0a 20 20 45 6d 62 61 .that.file..That's.why.in...Emba
18960 72 6b 27 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 65 72 65 rk's.default.configuration.there
18980 20 69 73 20 61 6e 20 65 6e 74 72 79 20 69 6e 0a 20 20 60 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 .is.an.entry.in...`embark-target
189a0 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 20 61 73 73 6f 63 69 61 74 69 6e 67 20 60 73 -injection-hooks'.associating.`s
189c0 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 27 20 74 6f 20 61 20 68 6f 6f 6b 0a 20 20 74 68 61 74 20 69 hell-command'.to.a.hook...that.i
189e0 6e 63 6c 75 64 65 73 20 60 65 6d 62 61 72 6b 2d 2d 73 68 65 6c 6c 2d 70 72 65 70 27 2c 20 61 20 ncludes.`embark--shell-prep',.a.
18a00 73 69 6d 70 6c 65 20 68 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 71 75 simple.helper.function.that...qu
18a20 6f 74 65 73 20 61 6c 6c 20 74 68 65 20 73 70 61 63 65 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 otes.all.the.spaces.in.the.file.
18a40 6e 61 6d 65 2c 20 69 6e 73 65 72 74 73 20 61 6e 20 65 78 74 72 61 20 73 70 61 63 65 20 61 74 20 name,.inserts.an.extra.space.at.
18a60 74 68 65 0a 20 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 6c 69 6e 65 20 61 6e 64 20 the...beginning.of.the.line.and.
18a80 6c 65 61 76 65 73 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6c 65 66 74 20 6f 66 20 69 74 2e 0a leaves.point.to.the.left.of.it..
18aa0 0a 20 20 4e 6f 77 2c 20 74 68 65 20 70 72 65 70 61 72 61 74 69 6f 6e 20 74 68 61 74 20 60 65 6d ...Now,.the.preparation.that.`em
18ac0 62 61 72 6b 2d 2d 73 68 65 6c 6c 2d 70 72 65 70 27 20 64 6f 65 73 20 77 6f 75 6c 64 20 62 65 20 bark--shell-prep'.does.would.be.
18ae0 75 73 65 6c 65 73 73 0a 20 20 69 66 20 45 6d 62 61 72 6b 20 64 69 64 20 77 68 61 74 20 69 74 20 useless...if.Embark.did.what.it.
18b00 6e 6f 72 6d 61 6c 6c 79 20 64 6f 65 73 20 61 66 74 65 72 20 69 74 20 69 6e 73 65 72 74 73 20 74 normally.does.after.it.inserts.t
18b20 68 65 20 74 61 72 67 65 74 20 6f 66 20 74 68 65 0a 20 20 61 63 74 69 6f 6e 20 61 74 20 74 68 65 he.target.of.the...action.at.the
18b40 20 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 2c 20 77 68 69 63 68 20 69 73 20 74 6f 20 .minibuffer.prompt,.which.is.to.
18b60 22 70 72 65 73 73 20 60 52 45 54 27 22 20 66 6f 72 20 79 6f 75 2c 0a 20 20 61 63 63 65 70 74 69 "press.`RET'".for.you,...accepti
18b80 6e 67 20 74 68 65 20 74 61 72 67 65 74 20 61 73 20 69 73 3b 20 69 66 20 45 6d 62 61 72 6b 20 64 ng.the.target.as.is;.if.Embark.d
18ba0 69 64 20 74 68 61 74 20 66 6f 72 20 60 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 27 20 79 6f 75 0a id.that.for.`shell-command'.you.
18bc0 20 20 77 6f 75 6c 64 6e 27 74 20 67 65 74 20 61 20 63 68 61 6e 63 65 20 74 6f 20 74 79 70 65 20 ..wouldn't.get.a.chance.to.type.
18be0 69 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 65 78 65 63 75 74 65 21 20 54 68 61 74 20 in.the.command.to.execute!.That.
18c00 69 73 20 77 68 79 0a 20 20 69 6e 20 45 6d 62 61 72 6b 27 73 20 64 65 66 61 75 6c 74 20 63 6f 6e is.why...in.Embark's.default.con
18c20 66 69 67 75 72 61 74 69 6f 6e 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 60 73 68 65 6c 6c 2d figuration.the.entry.for.`shell-
18c40 63 6f 6d 6d 61 6e 64 27 20 69 6e 0a 20 20 60 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a command'.in...`embark-target-inj
18c60 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 ection-hooks'.also.contains.the.
18c80 66 75 6e 63 74 69 6f 6e 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 27 2e function...`embark--allow-edit'.
18ca0 0a 0a 20 20 45 6d 62 61 72 6b 20 75 73 65 64 20 74 6f 20 68 61 76 65 20 61 20 64 65 64 69 63 61 ....Embark.used.to.have.a.dedica
18cc0 74 65 64 20 76 61 72 69 61 62 6c 65 20 60 65 6d 62 61 72 6b 2d 61 6c 6c 6f 77 2d 65 64 69 74 2d ted.variable.`embark-allow-edit-
18ce0 61 63 74 69 6f 6e 73 27 0a 20 20 74 6f 20 77 68 69 63 68 20 79 6f 75 20 63 6f 75 6c 64 20 61 64 actions'...to.which.you.could.ad
18d00 64 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 77 68 69 63 68 20 45 6d 62 61 72 6b 20 73 68 6f 75 d.commands.for.which.Embark.shou
18d20 6c 64 20 66 6f 72 67 6f 20 70 72 65 73 73 69 6e 67 0a 20 20 60 52 45 54 27 20 66 6f 72 20 79 6f ld.forgo.pressing...`RET'.for.yo
18d40 75 20 61 66 74 65 72 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 20 74 61 72 67 65 74 2e 20 53 69 u.after.inserting.the.target..Si
18d60 6e 63 65 20 69 74 73 20 65 66 66 65 63 74 20 63 61 6e 20 61 6c 73 6f 20 62 65 0a 20 20 61 63 68 nce.its.effect.can.also.be...ach
18d80 69 65 76 65 64 20 76 69 61 20 74 68 65 20 67 65 6e 65 72 61 6c 20 60 65 6d 62 61 72 6b 2d 74 61 ieved.via.the.general.`embark-ta
18da0 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 20 6d 65 63 68 61 6e 69 73 6d 2c rget-injection-hooks'.mechanism,
18dc0 0a 20 20 74 68 61 74 20 76 61 72 69 61 62 6c 65 20 68 61 73 20 62 65 65 6e 20 72 65 6d 6f 76 65 ...that.variable.has.been.remove
18de0 64 20 74 6f 20 73 69 6d 70 6c 69 66 79 20 45 6d 62 61 72 6b 2e 20 42 65 20 73 75 72 65 20 74 6f d.to.simplify.Embark..Be.sure.to
18e00 20 75 70 64 61 74 65 0a 20 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3b 20 69 66 .update...your.configuration;.if
18e20 20 79 6f 75 20 68 61 64 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 3a 0a 0a 20 20 e2 94 8c e2 .you.had.something.like:........
18e40 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 61 64 64 2d 74 6f 2d 6c 69 73 74 20 27 ..................(add-to-list.'
18e60 65 6d 62 61 72 6b 2d 61 6c 6c 6f 77 2d 65 64 69 74 2d 61 63 74 69 6f 6e 73 20 27 6d 79 2d 63 6f embark-allow-edit-actions.'my-co
18e80 6d 6d 61 6e 64 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 79 6f 75 20 mmand)......................you.
18ea0 73 68 6f 75 6c 64 20 72 65 70 6c 61 63 65 20 69 74 20 77 69 74 68 3a 0a 0a 20 20 e2 94 8c e2 94 should.replace.it.with:.........
18ec0 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 70 75 73 68 20 27 65 6d 62 61 72 6b 2d 2d .................(push.'embark--
18ee0 61 6c 6c 6f 77 2d 65 64 69 74 0a 20 20 e2 94 82 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d 67 65 allow-edit.............(alist-ge
18f00 74 20 27 6d 79 2d 63 6f 6d 6d 61 6e 64 20 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 t.'my-command.embark-target-inje
18f20 63 74 69 6f 6e 2d 68 6f 6f 6b 73 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a ction-hooks))...................
18f40 0a 0a 20 20 41 6c 73 6f 20 6e 6f 74 65 20 74 68 61 74 20 77 68 69 6c 65 20 79 6f 75 20 63 6f 75 ....Also.note.that.while.you.cou
18f60 6c 64 20 61 62 75 73 65 20 60 65 6d 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 27 20 73 6f ld.abuse.`embark--allow-edit'.so
18f80 20 74 68 61 74 20 79 6f 75 0a 20 20 68 61 76 65 20 74 6f 20 63 6f 6e 66 69 72 6d 20 22 64 61 6e .that.you...have.to.confirm."dan
18fa0 67 65 72 6f 75 73 22 20 61 63 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 60 64 65 6c 65 74 65 2d gerous".actions.such.as.`delete-
18fc0 66 69 6c 65 27 2c 20 69 74 20 69 73 0a 20 20 62 65 74 74 65 72 20 74 6f 20 69 6d 70 6c 65 6d 65 file',.it.is...better.to.impleme
18fe0 6e 74 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 62 79 20 61 64 64 69 6e 67 20 74 68 65 20 60 65 nt.confirmation.by.adding.the.`e
19000 6d 62 61 72 6b 2d 2d 63 6f 6e 66 69 72 6d 27 0a 20 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68 mbark--confirm'...function.to.th
19020 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 6e 74 72 79 20 6f 66 20 61 20 64 69 66 66 65 72 65 e.appropriate.entry.of.a.differe
19040 6e 74 20 68 6f 6f 6b 20 61 6c 69 73 74 2c 20 6e 61 6d 65 6c 79 2c 0a 20 20 60 65 6d 62 61 72 6b nt.hook.alist,.namely,...`embark
19060 2d 70 72 65 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2e 0a 0a 20 20 42 65 73 69 64 65 73 20 60 -pre-action-hooks'.....Besides.`
19080 65 6d 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 27 2c 20 45 6d 62 61 72 6b 20 63 6f 6d 65 embark--allow-edit',.Embark.come
190a0 73 20 77 69 74 68 20 61 6e 6f 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 69 s.with.another.function.that...i
190c0 73 20 6f 66 20 67 65 6e 65 72 61 6c 20 75 74 69 6c 69 74 79 20 69 6e 20 61 63 74 69 6f 6e 20 73 s.of.general.utility.in.action.s
190e0 65 74 75 70 20 68 6f 6f 6b 73 3a 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 69 67 6e 6f 72 65 2d 74 61 etup.hooks:...`embark--ignore-ta
19100 72 67 65 74 27 2e 20 55 73 65 20 69 74 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 rget'..Use.it.for.commands.that.
19120 64 6f 20 70 72 6f 6d 70 74 20 79 6f 75 20 69 6e 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 do.prompt.you.in.the...minibuffe
19140 72 20 62 75 74 20 66 6f 72 20 77 68 69 63 68 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 20 74 61 r.but.for.which.inserting.the.ta
19160 72 67 65 74 20 77 6f 75 6c 64 20 62 65 0a 20 20 69 6e 61 70 70 72 6f 70 72 69 61 74 65 2e 20 54 rget.would.be...inappropriate..T
19180 68 69 73 20 69 73 20 6e 6f 74 20 61 20 63 6f 6d 6d 6f 6e 20 73 69 74 75 61 74 69 6f 6e 20 62 75 his.is.not.a.common.situation.bu
191a0 74 20 64 6f 65 73 20 6f 63 63 61 73 69 6f 6e 61 6c 6c 79 0a 20 20 61 72 69 73 65 2e 20 46 6f 72 t.does.occasionally...arise..For
191c0 20 65 78 61 6d 70 6c 65 20 69 74 20 69 73 20 75 73 65 64 20 62 79 20 64 65 66 61 75 6c 74 20 66 .example.it.is.used.by.default.f
191e0 6f 72 0a 20 20 60 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 2d 6f 6e 2d 72 65 67 69 6f 6e 27 3a 20 or...`shell-command-on-region':.
19200 74 68 61 74 20 63 6f 6d 6d 61 6e 64 20 69 73 20 75 73 65 64 20 61 73 20 61 6e 20 61 63 74 69 6f that.command.is.used.as.an.actio
19220 6e 20 66 6f 72 0a 20 20 72 65 67 69 6f 6e 20 74 61 72 67 65 74 73 2c 20 61 6e 64 20 69 74 20 70 n.for...region.targets,.and.it.p
19240 72 6f 6d 70 74 73 20 79 6f 75 20 66 6f 72 20 61 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 3b 20 rompts.you.for.a.shell.command;.
19260 79 6f 75 20 74 79 70 69 63 61 6c 6c 79 0a 20 20 64 6f 20 2f 6e 6f 74 2f 20 77 61 6e 74 20 74 68 you.typically...do./not/.want.th
19280 65 20 74 61 72 67 65 74 2c 20 74 68 61 74 20 69 73 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f e.target,.that.is.the.contents.o
192a0 66 20 74 68 65 20 72 65 67 69 6f 6e 2c 20 74 6f 20 62 65 0a 20 20 65 6e 74 65 72 65 64 20 61 74 f.the.region,.to.be...entered.at
192c0 20 74 68 61 74 20 70 72 6f 6d 70 74 21 0a 0a 0a 33 2e 35 20 52 75 6e 6e 69 6e 67 20 68 6f 6f 6b .that.prompt!...3.5.Running.hook
192e0 73 20 62 65 66 6f 72 65 2c 20 61 66 74 65 72 20 6f 72 20 61 72 6f 75 6e 64 20 61 6e 20 61 63 74 s.before,.after.or.around.an.act
19300 69 6f 6e 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ion.............................
19320 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
19340 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
19360 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
19380 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 ................................
193a0 20 45 6d 62 61 72 6b 20 68 61 73 20 74 68 72 65 65 20 76 61 72 69 61 62 6c 65 73 2c 20 60 65 6d .Embark.has.three.variables,.`em
193c0 62 61 72 6b 2d 70 72 65 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2c 0a 20 20 60 65 6d 62 61 72 bark-pre-action-hooks',...`embar
193e0 6b 2d 70 6f 73 74 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 20 61 6e 64 20 60 65 6d 62 61 72 6b k-post-action-hooks'.and.`embark
19400 2d 61 72 6f 75 6e 64 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2c 20 77 68 69 63 68 20 61 72 65 -around-action-hooks',.which.are
19420 0a 20 20 61 6c 69 73 74 73 20 61 73 73 6f 63 69 61 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 74 ...alists.associating.commands.t
19440 6f 20 68 6f 6f 6b 73 20 74 68 61 74 20 73 68 6f 75 6c 64 20 72 75 6e 20 62 65 66 6f 72 65 20 6f o.hooks.that.should.run.before.o
19460 72 20 61 66 74 65 72 0a 20 20 6f 72 20 61 73 20 61 72 6f 75 6e 64 20 61 64 76 69 63 65 20 66 6f r.after...or.as.around.advice.fo
19480 72 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 68 65 6e 20 75 73 65 64 20 61 73 20 61 6e 20 61 63 r.the.command.when.used.as.an.ac
194a0 74 69 6f 6e 2e 20 41 73 20 77 69 74 68 0a 20 20 60 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 tion..As.with...`embark-target-i
194c0 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2c 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 73 njection-hooks',.there.are.two.s
194e0 70 65 63 69 61 6c 20 6b 65 79 73 20 66 6f 72 20 74 68 65 0a 20 20 61 6c 69 73 74 73 3a 20 60 74 pecial.keys.for.the...alists:.`t
19500 27 20 64 65 73 69 67 6e 61 74 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 68 6f 6f 6b 20 74 6f '.designates.the.default.hook.to
19520 20 72 75 6e 20 77 68 65 6e 20 6e 6f 20 73 70 65 63 69 66 69 63 20 68 6f 6f 6b 0a 20 20 69 73 20 .run.when.no.specific.hook...is.
19540 73 70 65 63 69 66 69 65 64 20 66 6f 72 20 61 20 63 6f 6d 6d 61 6e 64 3b 20 61 6e 64 20 74 68 65 specified.for.a.command;.and.the
19560 20 68 6f 6f 6b 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 60 3a 61 6c 77 61 79 73 27 20 72 75 .hook.associated.to.`:always'.ru
19580 6e 73 0a 20 20 72 65 67 61 72 64 6c 65 73 73 2e 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 ns...regardless.....The.default.
195a0 76 61 6c 75 65 73 20 6f 66 20 74 68 6f 73 65 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 66 61 values.of.those.variables.are.fa
195c0 69 72 6c 79 20 65 78 74 65 6e 73 69 76 65 2c 20 61 64 64 69 6e 67 0a 20 20 63 72 65 61 74 75 72 irly.extensive,.adding...creatur
195e0 65 20 63 6f 6d 66 6f 72 74 73 20 74 6f 20 6d 61 6b 65 20 72 75 6e 6e 69 6e 67 20 61 63 74 69 6f e.comforts.to.make.running.actio
19600 6e 73 20 61 20 73 6d 6f 6f 74 68 20 65 78 70 65 72 69 65 6e 63 65 2e 20 45 6d 62 61 72 6b 0a 20 ns.a.smooth.experience..Embark..
19620 20 63 6f 6d 65 73 20 77 69 74 68 20 73 65 76 65 72 61 6c 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e .comes.with.several.functions.in
19640 74 65 6e 64 65 64 20 74 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 73 65 20 68 6f 6f 6b tended.to.be.added.to.these.hook
19660 73 2c 20 61 6e 64 0a 20 20 75 73 65 64 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c s,.and...used.in.the.default.val
19680 75 65 73 20 6f 66 20 60 65 6d 62 61 72 6b 2d 70 72 65 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 ues.of.`embark-pre-action-hooks'
196a0 2c 0a 20 20 60 65 6d 62 61 72 6b 2d 70 6f 73 74 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 20 61 ,...`embark-post-action-hooks'.a
196c0 6e 64 20 60 65 6d 62 61 72 6b 2d 61 72 6f 75 6e 64 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 2e nd.`embark-around-action-hooks'.
196e0 0a 0a 20 20 46 6f 72 20 70 72 65 2d 61 63 74 69 6f 6e 20 68 6f 6f 6b 73 3a 0a 0a 20 20 60 65 6d ....For.pre-action.hooks:....`em
19700 62 61 72 6b 2d 2d 63 6f 6e 66 69 72 6d 27 0a 20 20 20 20 20 20 20 20 50 72 6f 6d 70 74 20 74 68 bark--confirm'.........Prompt.th
19720 65 20 75 73 65 72 20 66 6f 72 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 62 65 66 6f 72 65 20 65 e.user.for.confirmation.before.e
19740 78 65 63 75 74 69 6e 67 20 74 68 65 0a 20 20 20 20 20 20 20 20 61 63 74 69 6f 6e 2e 20 54 68 69 xecuting.the.........action..Thi
19760 73 20 69 73 20 75 73 65 64 20 62 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 s.is.used.be.default.for.command
19780 73 20 64 65 65 6d 65 64 20 22 64 61 6e 67 65 72 6f 75 73 22 2c 0a 20 20 20 20 20 20 20 20 6f 72 s.deemed."dangerous",.........or
197a0 2c 20 6d 6f 72 65 20 61 63 63 75 72 61 74 65 6c 79 2c 20 68 61 72 64 20 74 6f 20 75 6e 64 6f 2c ,.more.accurately,.hard.to.undo,
197c0 20 73 75 63 68 20 61 73 20 60 64 65 6c 65 74 65 2d 66 69 6c 65 27 20 61 6e 64 0a 20 20 20 20 20 .such.as.`delete-file'.and......
197e0 20 20 20 60 6b 69 6c 6c 2d 62 75 66 66 65 72 27 2e 0a 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 75 6e ...`kill-buffer'.....`embark--un
19800 6d 61 72 6b 2d 74 61 72 67 65 74 27 0a 20 20 20 20 20 20 20 20 55 6e 6d 61 72 6b 20 74 68 65 20 mark-target'.........Unmark.the.
19820 61 63 74 69 76 65 20 72 65 67 69 6f 6e 2e 20 55 73 65 20 74 68 69 73 20 66 6f 72 20 63 6f 6d 6d active.region..Use.this.for.comm
19840 61 6e 64 73 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 61 63 74 0a 20 20 20 20 20 20 20 20 6f 6e 20 ands.you.want.to.act.........on.
19860 74 68 65 20 72 65 67 69 6f 6e 20 63 6f 6e 74 65 6e 74 73 20 62 75 74 20 77 69 74 68 6f 75 74 20 the.region.contents.but.without.
19880 74 68 65 20 72 65 67 69 6f 6e 20 62 65 69 6e 67 20 61 63 74 69 76 65 2e 20 54 68 65 0a 20 20 20 the.region.being.active..The....
198a0 20 20 20 20 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 75 73 65 73 20 .....default.configuration.uses.
198c0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 61 20 70 72 65 2d 61 63 74 69 6f 6e 20 68 6f this.function.as.a.pre-action.ho
198e0 6f 6b 0a 20 20 20 20 20 20 20 20 66 6f 72 20 60 6f 63 63 75 72 27 20 61 6e 64 20 60 71 75 65 72 ok.........for.`occur'.and.`quer
19900 79 2d 72 65 70 6c 61 63 65 27 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 6f 20 74 68 61 74 y-replace',.for.example,.so.that
19920 20 79 6f 75 20 63 61 6e 0a 20 20 20 20 20 20 20 20 75 73 65 20 74 68 65 6d 20 61 73 20 61 63 74 .you.can.........use.them.as.act
19940 69 6f 6e 73 20 77 69 74 68 20 72 65 67 69 6f 6e 20 74 61 72 67 65 74 73 20 74 6f 20 73 65 61 72 ions.with.region.targets.to.sear
19960 63 68 20 74 68 65 20 77 68 6f 6c 65 0a 20 20 20 20 20 20 20 20 62 75 66 66 65 72 20 66 6f 72 20 ch.the.whole.........buffer.for.
19980 74 68 65 20 74 65 78 74 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 72 65 67 69 6f 6e the.text.contained.in.the.region
199a0 2e 20 57 69 74 68 6f 75 74 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 70 72 65 2d 61 63 74 69 6f ..Without.this.........pre-actio
199c0 6e 20 68 6f 6f 6b 20 75 73 69 6e 67 20 60 6f 63 63 75 72 27 20 61 73 20 61 6e 20 61 63 74 69 6f n.hook.using.`occur'.as.an.actio
199e0 6e 20 66 6f 72 20 61 20 72 65 67 69 6f 6e 20 74 61 72 67 65 74 0a 20 20 20 20 20 20 20 20 77 6f n.for.a.region.target.........wo
19a00 75 6c 64 20 62 65 20 70 6f 69 6e 74 6c 65 73 73 3a 20 69 74 20 77 6f 75 6c 64 20 73 65 61 72 63 uld.be.pointless:.it.would.searc
19a20 68 20 66 6f 72 20 74 68 65 20 74 68 65 20 72 65 67 69 6f 6e 20 63 6f 6e 74 65 6e 74 73 0a 20 20 h.for.the.the.region.contents...
19a40 20 20 20 20 20 20 2f 69 6e 20 74 68 65 20 72 65 67 69 6f 6e 2f 2c 20 28 74 79 70 69 63 61 6c 6c ....../in.the.region/,.(typicall
19a60 79 2c 20 64 75 65 20 74 6f 20 74 68 65 20 64 65 74 61 69 6c 73 20 6f 66 20 72 65 67 65 78 70 73 y,.due.to.the.details.of.regexps
19a80 29 0a 20 20 20 20 20 20 20 20 66 69 6e 64 69 6e 67 20 6f 6e 6c 79 20 6f 6e 65 20 6d 61 74 63 68 ).........finding.only.one.match
19aa0 21 0a 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 62 65 67 69 6e 6e 69 6e 67 2d 6f 66 2d 74 61 72 67 65 !....`embark--beginning-of-targe
19ac0 74 27 0a 20 20 20 20 20 20 20 20 4d 6f 76 65 20 74 6f 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 t'.........Move.to.the.beginning
19ae0 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 20 28 66 6f 72 20 74 61 72 67 65 74 73 20 74 68 61 74 .of.the.target.(for.targets.that
19b00 20 72 65 70 6f 72 74 0a 20 20 20 20 20 20 20 20 62 6f 75 6e 64 73 29 2e 20 54 68 69 73 20 69 73 .report.........bounds)..This.is
19b20 20 75 73 65 64 20 62 79 20 64 65 66 61 75 6c 74 20 66 6f 72 20 62 61 63 6b 77 61 72 64 20 6d 6f .used.by.default.for.backward.mo
19b40 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 20 20 20 20 73 75 63 68 20 61 73 20 60 62 tion.commands.........such.as.`b
19b60 61 63 6b 77 61 72 64 2d 73 65 78 70 27 2c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 64 6f 6e 27 ackward-sexp',.so.that.they.don'
19b80 74 20 61 63 63 69 64 65 6e 74 61 6c 6c 79 20 6c 65 61 76 65 0a 20 20 20 20 20 20 20 20 79 6f 75 t.accidentally.leave.........you
19ba0 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 2e 0a 0a 20 20 60 65 6d 62 61 .on.the.current.target.....`emba
19bc0 72 6b 2d 2d 65 6e 64 2d 6f 66 2d 74 61 72 67 65 74 27 0a 20 20 20 20 20 20 20 20 4d 6f 76 65 20 rk--end-of-target'.........Move.
19be0 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 2e 20 54 68 69 73 20 69 to.the.end.of.the.target..This.i
19c00 73 20 75 73 65 64 20 73 69 6d 69 6c 61 72 6c 79 20 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 s.used.similarly.to.the.........
19c20 70 72 65 76 69 6f 75 73 20 66 75 6e 63 74 69 6f 6e 2c 20 62 75 74 20 61 6c 73 6f 20 66 6f 72 20 previous.function,.but.also.for.
19c40 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 63 74 20 6f 6e 20 74 68 65 20 6c 61 73 74 0a 20 20 commands.that.act.on.the.last...
19c60 20 20 20 20 20 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 6b 65 20 60 65 76 61 6c 2d 6c 61 ......s-expression.like.`eval-la
19c80 73 74 2d 73 65 78 70 27 2e 20 54 68 69 73 20 61 6c 6c 6f 77 20 79 6f 75 20 74 6f 20 61 63 74 20 st-sexp'..This.allow.you.to.act.
19ca0 6f 6e 20 61 6e 0a 20 20 20 20 20 20 20 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 66 72 6f 6d 20 on.an.........s-expression.from.
19cc0 61 6e 79 77 68 65 72 65 20 69 6e 73 69 64 65 20 69 74 20 61 6e 64 20 73 74 69 6c 6c 20 75 73 65 anywhere.inside.it.and.still.use
19ce0 0a 20 20 20 20 20 20 20 20 60 65 76 61 6c 2d 6c 61 73 74 2d 73 65 78 70 27 20 61 73 20 61 6e 20 .........`eval-last-sexp'.as.an.
19d00 61 63 74 69 6f 6e 2e 0a 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 78 72 65 66 2d 70 75 73 68 2d 6d 61 action.....`embark--xref-push-ma
19d20 72 6b 65 72 73 27 0a 20 20 20 20 20 20 20 20 50 75 73 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 rkers'.........Push.the.current.
19d40 6c 6f 63 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 78 72 65 66 20 6d 61 72 6b 65 72 20 73 74 61 63 location.on.the.xref.marker.stac
19d60 6b 2e 20 55 73 65 20 74 68 69 73 20 66 6f 72 0a 20 20 20 20 20 20 20 20 63 6f 6d 6d 61 6e 64 73 k..Use.this.for.........commands
19d80 20 74 68 61 74 20 74 61 6b 65 20 79 6f 75 20 73 6f 6d 65 77 68 65 72 65 20 61 6e 64 20 66 6f 72 .that.take.you.somewhere.and.for
19da0 20 77 68 69 63 68 20 79 6f 75 27 64 20 6c 69 6b 65 20 74 6f 20 62 65 0a 20 20 20 20 20 20 20 20 .which.you'd.like.to.be.........
19dc0 61 62 6c 65 20 74 6f 20 63 6f 6d 65 20 62 61 63 6b 20 74 6f 20 77 68 65 72 65 20 79 6f 75 20 77 able.to.come.back.to.where.you.w
19de0 65 72 65 20 75 73 69 6e 67 0a 20 20 20 20 20 20 20 20 60 78 72 65 66 2d 70 6f 70 2d 6d 61 72 6b ere.using.........`xref-pop-mark
19e00 65 72 2d 73 74 61 63 6b 27 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62 79 20 64 65 66 61 75 er-stack'..This.is.used.by.defau
19e20 6c 74 20 66 6f 72 0a 20 20 20 20 20 20 20 20 60 66 69 6e 64 2d 6c 69 62 72 61 72 79 27 2e 0a 0a lt.for.........`find-library'...
19e40 20 20 46 6f 72 20 70 6f 73 74 2d 61 63 74 69 6f 6e 20 68 6f 6f 6b 73 3a 0a 0a 20 20 60 65 6d 62 ..For.post-action.hooks:....`emb
19e60 61 72 6b 2d 2d 72 65 73 74 61 72 74 27 0a 20 20 20 20 20 20 20 20 52 65 73 74 61 72 74 20 74 68 ark--restart'.........Restart.th
19e80 65 20 63 6f 6d 6d 61 6e 64 20 63 75 72 72 65 6e 74 6c 79 20 70 72 6f 6d 70 74 69 6e 67 20 69 6e e.command.currently.prompting.in
19ea0 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 73 6f 0a 20 20 20 20 20 20 20 20 74 68 61 74 .the.minibuffer,.so.........that
19ec0 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 .the.list.of.completion.candidat
19ee0 65 73 20 69 73 20 75 70 64 61 74 65 64 2e 20 20 54 68 69 73 20 69 73 0a 20 20 20 20 20 20 20 20 es.is.updated...This.is.........
19f00 75 73 65 66 75 6c 20 61 73 20 61 20 70 6f 73 74 20 61 63 74 69 6f 6e 20 68 6f 6f 6b 20 66 6f 72 useful.as.a.post.action.hook.for
19f20 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 65 6c 65 74 65 20 6f 72 20 72 65 6e 61 6d 65 0a .commands.that.delete.or.rename.
19f40 20 20 20 20 20 20 20 20 61 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 3b 20 ........a.completion.candidate;.
19f60 66 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 for.example.the.default.value.of
19f80 0a 20 20 20 20 20 20 20 20 60 65 6d 62 61 72 6b 2d 70 6f 73 74 2d 61 63 74 69 6f 6e 2d 68 6f 6f .........`embark-post-action-hoo
19fa0 6b 73 27 20 75 73 65 73 20 69 74 20 66 6f 72 20 60 64 65 6c 65 74 65 2d 66 69 6c 65 27 2c 0a 20 ks'.uses.it.for.`delete-file',..
19fc0 20 20 20 20 20 20 20 60 6b 69 6c 6c 2d 62 75 66 66 65 72 27 2c 20 60 72 65 6e 61 6d 65 2d 66 69 .......`kill-buffer',.`rename-fi
19fe0 6c 65 27 2c 20 60 72 65 6e 61 6d 65 2d 62 75 66 66 65 72 27 2c 20 65 74 63 2e 0a 0a 20 20 46 6f le',.`rename-buffer',.etc.....Fo
1a000 72 20 61 72 6f 75 6e 64 2d 61 63 74 69 6f 6e 20 68 6f 6f 6b 73 3a 0a 0a 20 20 60 65 6d 62 61 72 r.around-action.hooks:....`embar
1a020 6b 2d 2d 6d 61 72 6b 2d 74 61 72 67 65 74 27 0a 20 20 20 20 20 20 20 20 53 61 76 65 20 65 78 69 k--mark-target'.........Save.exi
1a040 73 74 69 6e 67 20 6d 61 72 6b 20 61 6e 64 20 70 6f 69 6e 74 20 6c 6f 63 61 74 69 6f 6e 2c 20 6d sting.mark.and.point.location,.m
1a060 61 72 6b 20 74 68 65 20 74 61 72 67 65 74 20 61 6e 64 20 72 75 6e 0a 20 20 20 20 20 20 20 20 74 ark.the.target.and.run.........t
1a080 68 65 20 61 63 74 69 6f 6e 2e 20 4d 6f 73 74 20 74 61 72 67 65 74 73 20 61 74 20 70 6f 69 6e 74 he.action..Most.targets.at.point
1a0a0 20 6f 75 74 73 69 64 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 72 65 70 6f 72 74 0a 20 .outside.the.minibuffer.report..
1a0c0 20 20 20 20 20 20 20 77 68 69 63 68 20 72 65 67 69 6f 6e 20 6f 66 20 74 68 65 20 62 75 66 66 65 .......which.region.of.the.buffe
1a0e0 72 20 74 68 65 79 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 28 74 68 69 73 20 69 73 20 74 68 r.they.correspond.to.(this.is.th
1a100 65 0a 20 20 20 20 20 20 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 62 79 20 60 65 e.........information.used.by.`e
1a120 6d 62 61 72 6b 2d 68 69 67 68 6c 69 67 68 74 2d 69 6e 64 69 63 61 74 6f 72 27 20 74 6f 20 6b 6e mbark-highlight-indicator'.to.kn
1a140 6f 77 20 77 68 61 74 0a 20 20 20 20 20 20 20 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 62 ow.what.........portion.of.the.b
1a160 75 66 66 65 72 20 74 6f 20 68 69 67 68 6c 69 67 68 74 29 3b 20 74 68 69 73 20 66 75 6e 63 74 69 uffer.to.highlight);.this.functi
1a180 6f 6e 20 6d 61 72 6b 73 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 72 65 67 69 6f 6e 2e 20 49 74 on.marks.that.........region..It
1a1a0 20 69 73 20 75 73 65 66 75 6c 20 61 73 20 61 6e 20 61 72 6f 75 6e 64 20 61 63 74 69 6f 6e 20 68 .is.useful.as.an.around.action.h
1a1c0 6f 6f 6b 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 65 78 ook.for.commands.that.........ex
1a1e0 70 65 63 74 20 61 20 72 65 67 69 6f 6e 20 74 6f 20 62 65 20 6d 61 72 6b 65 64 2c 20 66 6f 72 20 pect.a.region.to.be.marked,.for.
1a200 65 78 61 6d 70 6c 65 2c 20 69 74 20 69 73 20 75 73 65 64 20 62 79 20 64 65 66 61 75 6c 74 0a 20 example,.it.is.used.by.default..
1a220 20 20 20 20 20 20 20 66 6f 72 20 60 69 6e 64 65 6e 74 2d 72 65 67 69 6f 6e 27 20 73 6f 20 74 68 .......for.`indent-region'.so.th
1a240 61 74 20 69 74 20 77 6f 72 6b 73 20 6f 6e 20 73 2d 65 78 70 72 65 73 73 69 6f 6e 20 74 61 72 67 at.it.works.on.s-expression.targ
1a260 65 74 73 2c 20 6f 72 0a 20 20 20 20 20 20 20 20 66 6f 72 20 60 66 69 6c 6c 2d 72 65 67 69 6f 6e ets,.or.........for.`fill-region
1a280 27 20 73 6f 20 74 68 61 74 20 69 74 20 77 6f 72 6b 73 20 6f 6e 20 70 61 72 61 67 72 61 70 68 20 '.so.that.it.works.on.paragraph.
1a2a0 74 61 72 67 65 74 73 2e 0a 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 63 64 27 0a 20 20 20 20 20 20 20 targets.....`embark--cd'........
1a2c0 20 52 75 6e 20 74 68 65 20 61 63 74 69 6f 6e 20 77 69 74 68 20 60 64 65 66 61 75 6c 74 2d 64 69 .Run.the.action.with.`default-di
1a2e0 72 65 63 74 6f 72 79 27 20 73 65 74 20 74 6f 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a 20 20 rectory'.set.to.the.directory...
1a300 20 20 20 20 20 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 20 ......associated.to.the.current.
1a320 74 61 72 67 65 74 2e 20 54 68 65 20 74 61 72 67 65 74 20 73 68 6f 75 6c 64 20 62 65 20 6f 66 20 target..The.target.should.be.of.
1a340 74 79 70 65 0a 20 20 20 20 20 20 20 20 60 66 69 6c 65 27 2c 20 60 62 75 66 66 65 72 27 2c 20 60 type.........`file',.`buffer',.`
1a360 62 6f 6f 6b 6d 61 72 6b 27 20 6f 72 20 60 6c 69 62 72 61 72 79 27 2c 20 61 6e 64 20 74 68 65 20 bookmark'.or.`library',.and.the.
1a380 61 73 73 6f 63 69 61 74 65 64 0a 20 20 20 20 20 20 20 20 64 69 72 65 63 74 6f 72 79 20 69 73 20 associated.........directory.is.
1a3a0 77 68 61 74 20 79 6f 75 27 64 20 65 78 70 65 63 74 20 69 6e 20 65 61 63 68 20 63 61 73 65 2e 0a what.you'd.expect.in.each.case..
1a3c0 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 6e 61 72 72 6f 77 2d 74 6f 2d 74 61 72 67 65 74 27 0a 20 20 ...`embark--narrow-to-target'...
1a3e0 20 20 20 20 20 20 52 75 6e 20 74 68 65 20 61 63 74 69 6f 6e 20 77 69 74 68 20 62 75 66 66 65 72 ......Run.the.action.with.buffer
1a400 20 6e 61 72 72 6f 77 65 64 20 74 6f 20 63 75 72 72 65 6e 74 20 74 61 72 67 65 74 2e 20 55 73 65 .narrowed.to.current.target..Use
1a420 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 61 73 20 61 6e 20 61 72 6f 75 6e 64 20 68 6f 6f 6b 20 .this.........as.an.around.hook.
1a440 74 6f 20 6c 6f 63 61 6c 69 7a 65 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 20 61 63 74 69 6f 6e to.localize.the.effect.of.action
1a460 73 20 74 68 61 74 20 64 6f 6e 27 74 0a 20 20 20 20 20 20 20 20 61 6c 72 65 61 64 79 20 77 6f 72 s.that.don't.........already.wor
1a480 6b 20 6f 6e 20 6a 75 73 74 20 74 68 65 20 72 65 67 69 6f 6e 2e 20 49 6e 20 74 68 65 20 64 65 66 k.on.just.the.region..In.the.def
1a4a0 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 74 0a 20 20 20 20 20 20 20 20 69 73 ault.configuration.it.........is
1a4c0 20 75 73 65 64 20 66 6f 72 20 60 72 65 70 75 6e 63 74 75 61 74 65 2d 73 65 6e 74 65 6e 63 65 73 .used.for.`repunctuate-sentences
1a4e0 27 2e 0a 0a 20 20 60 65 6d 62 61 72 6b 2d 2d 73 61 76 65 2d 65 78 63 75 72 73 69 6f 6e 27 0a 20 '.....`embark--save-excursion'..
1a500 20 20 20 20 20 20 20 52 75 6e 20 74 68 65 20 61 63 74 69 6f 6e 20 72 65 73 74 6f 72 69 6e 67 20 .......Run.the.action.restoring.
1a520 70 6f 69 6e 74 20 61 74 20 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20 63 75 72 72 65 6e 74 20 64 point.at.the.end...The.current.d
1a540 65 66 61 75 6c 74 0a 20 20 20 20 20 20 20 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 6f 65 efault.........configuration.doe
1a560 73 6e 27 74 20 75 73 65 20 74 68 69 73 20 62 75 74 20 69 74 20 69 73 20 61 76 61 69 6c 61 62 6c sn't.use.this.but.it.is.availabl
1a580 65 20 66 6f 72 20 75 73 65 72 73 2e 0a 0a 0a 33 2e 36 20 43 72 65 61 74 69 6e 67 20 79 6f 75 72 e.for.users....3.6.Creating.your
1a5a0 20 6f 77 6e 20 6b 65 79 6d 61 70 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 .own.keymaps....................
1a5c0 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
1a5e0 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
1a600 80 e2 94 80 0a 0a 20 20 41 6c 6c 20 69 6e 74 65 72 6e 61 6c 20 6b 65 79 6d 61 70 73 20 61 72 65 ........All.internal.keymaps.are
1a620 20 64 65 66 69 6e 65 64 20 77 69 74 68 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 68 65 6c 70 65 .defined.with.the.standard.helpe
1a640 72 20 6d 61 63 72 6f 0a 20 20 60 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 27 2e 20 46 6f 72 20 65 r.macro...`defvar-keymap'..For.e
1a660 78 61 6d 70 6c 65 20 61 20 73 69 6d 70 6c 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 xample.a.simple.version.of.the.f
1a680 69 6c 65 20 61 63 74 69 6f 6e 0a 20 20 6b 65 79 6d 61 70 20 63 6f 75 6c 64 20 62 65 20 64 65 66 ile.action...keymap.could.be.def
1a6a0 69 6e 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 ined.as.follows:................
1a6c0 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 65 6d 62 61 72 6b 2d ..........(defvar-keymap.embark-
1a6e0 66 69 6c 65 2d 6d 61 70 0a 20 20 e2 94 82 20 20 20 3a 64 6f 63 20 22 45 78 61 6d 70 6c 65 20 6b file-map.........:doc."Example.k
1a700 65 79 6d 61 70 20 77 69 74 68 20 61 20 66 65 77 20 66 69 6c 65 20 61 63 74 69 6f 6e 73 22 0a 20 eymap.with.a.few.file.actions"..
1a720 20 e2 94 82 20 20 20 3a 70 61 72 65 6e 74 20 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 .......:parent.embark-general-ma
1a740 70 0a 20 20 e2 94 82 20 20 20 22 64 22 20 23 27 64 65 6c 65 74 65 2d 66 69 6c 65 0a 20 20 e2 94 p........."d".#'delete-file.....
1a760 82 20 20 20 22 72 22 20 23 27 72 65 6e 61 6d 65 2d 66 69 6c 65 0a 20 20 e2 94 82 20 20 20 22 63 ...."r".#'rename-file........."c
1a780 22 20 23 27 63 6f 70 79 2d 66 69 6c 65 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ".#'copy-file)..................
1a7a0 0a 0a 20 20 54 68 65 73 65 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 20 61 72 65 20 70 65 72 ....These.action.keymaps.are.per
1a7c0 66 65 63 74 6c 79 20 6e 6f 72 6d 61 6c 20 45 6d 61 63 73 20 6b 65 79 6d 61 70 73 2e 20 20 59 6f fectly.normal.Emacs.keymaps...Yo
1a7e0 75 20 6d 61 79 20 77 61 6e 74 0a 20 20 74 6f 20 69 6e 68 65 72 69 74 20 66 72 6f 6d 20 74 68 65 u.may.want...to.inherit.from.the
1a800 20 60 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 27 20 69 66 20 79 6f 75 20 77 61 6e .`embark-general-map'.if.you.wan
1a820 74 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 0a 20 20 64 65 66 61 75 6c 74 20 45 6d 62 61 72 6b t.to.access.the...default.Embark
1a840 20 61 63 74 69 6f 6e 73 2e 20 4e 6f 74 65 20 74 68 61 74 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c .actions..Note.that.`embark-coll
1a860 65 63 74 27 20 61 6e 64 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 0a 20 20 61 72 65 20 61 ect'.and.`embark-export'...are.a
1a880 6c 73 6f 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65 20 76 69 61 20 60 65 6d 62 61 72 6b 2d 67 lso.made.available.via.`embark-g
1a8a0 65 6e 65 72 61 6c 2d 6d 61 70 27 2e 0a 0a 0a 33 2e 37 20 44 65 66 69 6e 69 6e 67 20 61 63 74 69 eneral-map'....3.7.Defining.acti
1a8c0 6f 6e 73 20 66 6f 72 20 6e 65 77 20 63 61 74 65 67 6f 72 69 65 73 20 6f 66 20 74 61 72 67 65 74 ons.for.new.categories.of.target
1a8e0 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 s...............................
1a900 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
1a920 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
1a940 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ................................
1a960 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 49 74 20 69 ............................It.i
1a980 73 20 65 61 73 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 45 6d 62 61 72 6b 20 74 6f 20 70 72 s.easy.to.configure.Embark.to.pr
1a9a0 6f 76 69 64 65 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 6e 65 77 20 74 79 70 65 73 20 6f 66 0a 20 ovide.actions.for.new.types.of..
1a9c0 20 74 61 72 67 65 74 73 2c 20 65 69 74 68 65 72 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 .targets,.either.in.the.minibuff
1a9e0 65 72 20 6f 72 20 6f 75 74 73 69 64 65 20 69 74 2e 20 49 20 70 72 65 73 65 6e 74 20 62 65 6c 6f er.or.outside.it..I.present.belo
1aa00 77 20 74 77 6f 0a 20 20 76 65 72 79 20 64 65 74 61 69 6c 65 64 20 65 78 61 6d 70 6c 65 73 20 6f w.two...very.detailed.examples.o
1aa20 66 20 68 6f 77 20 74 6f 20 64 6f 20 74 68 69 73 2e 20 41 74 20 73 65 76 65 72 61 6c 20 70 6f 69 f.how.to.do.this..At.several.poi
1aa40 6e 74 73 20 49 27 6c 6c 0a 20 20 65 78 70 6c 61 69 6e 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 nts.I'll...explain.more.than.one
1aa60 20 77 61 79 20 74 6f 20 70 72 6f 63 65 65 64 2c 20 74 79 70 69 63 61 6c 6c 79 20 77 69 74 68 20 .way.to.proceed,.typically.with.
1aa80 74 68 65 20 65 61 73 69 65 73 74 0a 20 20 6f 70 74 69 6f 6e 20 66 69 72 73 74 2e 20 49 20 69 6e the.easiest...option.first..I.in
1aaa0 63 6c 75 64 65 20 74 68 65 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6f 70 74 69 6f 6e 73 20 73 69 clude.the.alternative.options.si
1aac0 6e 63 65 20 74 68 65 72 65 20 77 69 6c 6c 20 62 65 0a 20 20 73 69 6d 69 6c 61 72 20 73 69 74 75 nce.there.will.be...similar.situ
1aae0 61 74 69 6f 6e 73 20 77 68 65 72 65 20 74 68 65 20 65 61 73 69 65 73 74 20 6f 70 74 69 6f 6e 20 ations.where.the.easiest.option.
1ab00 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 0a 0a 0a 33 2e 37 2e 31 20 4e 65 77 20 6d 69 is.not.available....3.7.1.New.mi
1ab20 6e 69 62 75 66 66 65 72 20 74 61 72 67 65 74 20 65 78 61 6d 70 6c 65 20 2d 20 74 61 62 2d 62 61 nibuffer.target.example.-.tab-ba
1ab40 72 20 74 61 62 73 0a e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 r.tabs..........................
1ab60 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
1ab80 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 ................................
1aba0 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
1abc0 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c 0a 0a 20 ................................
1abe0 20 41 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 61 6b 65 20 74 68 65 20 6e 65 77 20 5b 74 61 .As.an.example,.take.the.new.[ta
1ac00 62 20 62 61 72 73 5d 20 66 72 6f 6d 20 45 6d 61 63 73 20 32 37 2e 20 49 27 6c 6c 20 65 78 70 6c b.bars].from.Emacs.27..I'll.expl
1ac20 61 69 6e 20 68 6f 77 0a 20 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 45 6d 62 61 72 6b 20 74 6f ain.how...to.configure.Embark.to
1ac40 20 6f 66 66 65 72 20 74 61 62 2d 73 70 65 63 69 66 69 63 20 61 63 74 69 6f 6e 73 20 77 68 65 6e .offer.tab-specific.actions.when
1ac60 20 79 6f 75 20 75 73 65 20 74 68 65 0a 20 20 74 61 62 2d 62 61 72 2d 6d 6f 64 65 20 63 6f 6d 6d .you.use.the...tab-bar-mode.comm
1ac80 61 6e 64 73 20 74 68 61 74 20 6d 65 6e 74 69 6f 6e 20 74 61 62 73 20 62 79 20 6e 61 6d 65 2e 20 ands.that.mention.tabs.by.name..
1aca0 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 20 20 65 78 70 6c 61 69 6e 65 64 20 68 65 The.configuration...explained.he
1acc0 72 65 20 69 73 20 6e 6f 77 20 62 75 69 6c 74 2d 69 6e 20 74 6f 20 45 6d 62 61 72 6b 20 28 61 6e re.is.now.built-in.to.Embark.(an
1ace0 64 20 4d 61 72 67 69 6e 61 6c 69 61 29 2c 20 62 75 74 20 69 74 27 73 0a 20 20 73 74 69 6c 6c 20 d.Marginalia),.but.it's...still.
1ad00 61 20 67 6f 6f 64 20 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 20 65 78 61 6d 70 6c 65 2e 20 49 a.good.self-contained.example..I
1ad20 6e 20 6f 72 64 65 72 20 74 6f 20 73 65 74 75 70 20 75 70 20 74 61 62 20 61 63 74 69 6f 6e 73 0a n.order.to.setup.up.tab.actions.
1ad40 20 20 79 6f 75 20 77 6f 75 6c 64 20 6e 65 65 64 20 74 6f 3a 20 28 31 29 20 6d 61 6b 65 20 73 75 ..you.would.need.to:.(1).make.su
1ad60 72 65 20 45 6d 62 61 72 6b 20 6b 6e 6f 77 73 20 74 68 6f 73 65 20 63 6f 6d 6d 61 6e 64 73 20 64 re.Embark.knows.those.commands.d
1ad80 65 61 6c 20 77 69 74 68 0a 20 20 74 61 62 73 2c 20 28 32 29 20 64 65 66 69 6e 65 20 61 20 6b 65 eal.with...tabs,.(2).define.a.ke
1ada0 79 6d 61 70 20 66 6f 72 20 74 61 62 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 ymap.for.tab.actions.and.configu
1adc0 72 65 20 45 6d 62 61 72 6b 20 73 6f 20 69 74 0a 20 20 6b 6e 6f 77 73 20 74 68 61 74 27 73 20 74 re.Embark.so.it...knows.that's.t
1ade0 68 65 20 6b 65 79 6d 61 70 20 79 6f 75 20 77 61 6e 74 2e 0a 0a 0a 5b 74 61 62 20 62 61 72 73 5d he.keymap.you.want....[tab.bars]
1ae00 0a 3c 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 73 6f 66 74 77 61 72 65 2f 65 .<https://www.gnu.org/software/e
1ae20 6d 61 63 73 2f 6d 61 6e 75 61 6c 2f 68 74 6d 6c 5f 6e 6f 64 65 2f 65 6d 61 63 73 2f 54 61 62 2d macs/manual/html_node/emacs/Tab-
1ae40 42 61 72 73 2e 68 74 6d 6c 3e 0a 0a e2 97 8a 20 33 2e 37 2e 31 2e 31 20 54 65 6c 6c 69 6e 67 20 Bars.html>......3.7.1.1.Telling.
1ae60 45 6d 62 61 72 6b 20 61 62 6f 75 74 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 70 72 6f 6d 70 Embark.about.commands.that.promp
1ae80 74 20 66 6f 72 20 74 61 62 73 20 62 79 20 6e 61 6d 65 0a 0a 20 20 46 6f 72 20 73 74 65 70 20 28 t.for.tabs.by.name....For.step.(
1aea0 31 29 2c 20 69 74 20 77 6f 75 6c 64 20 62 65 20 67 72 65 61 74 20 69 66 20 74 68 65 20 60 74 61 1),.it.would.be.great.if.the.`ta
1aec0 62 2d 62 61 72 2d 6d 6f 64 65 27 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 72 65 70 6f 72 74 65 64 20 b-bar-mode'.commands...reported.
1aee0 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 74 65 67 6f 72 79 20 60 74 61 62 27 20 77 68 the.completion.category.`tab'.wh
1af00 65 6e 20 61 73 6b 69 6e 67 20 79 6f 75 20 66 6f 72 20 61 20 74 61 62 20 77 69 74 68 0a 20 20 63 en.asking.you.for.a.tab.with...c
1af20 6f 6d 70 6c 65 74 69 6f 6e 2e 20 28 41 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 45 6d 61 63 73 20 63 ompletion..(All.built-in.Emacs.c
1af40 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 70 72 6f 6d 70 74 20 66 6f 72 20 66 69 6c 65 20 6e 61 6d ommands.that.prompt.for.file.nam
1af60 65 73 2c 0a 20 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 64 6f 20 68 61 76 65 20 6d 65 74 61 64 es,...for.example,.do.have.metad
1af80 61 74 61 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 61 74 20 74 68 65 79 20 77 61 6e 74 20 61 20 ata.indicating.that.they.want.a.
1afa0 60 66 69 6c 65 27 2e 29 0a 20 20 54 68 65 79 20 64 6f 20 6e 6f 74 2c 20 75 6e 66 6f 72 74 75 6e `file'.)...They.do.not,.unfortun
1afc0 61 74 65 6c 79 2c 20 61 6e 64 20 49 20 77 69 6c 6c 20 64 65 73 63 72 69 62 65 20 61 20 63 6f 75 ately,.and.I.will.describe.a.cou
1afe0 70 6c 65 20 6f 66 20 77 61 79 73 20 74 6f 0a 20 20 64 65 61 6c 20 77 69 74 68 20 74 68 69 73 2e ple.of.ways.to...deal.with.this.
1b000 0a 0a 20 20 4d 61 79 62 65 20 74 68 65 20 65 61 73 69 65 73 74 20 74 68 69 6e 67 20 69 73 20 74 ....Maybe.the.easiest.thing.is.t
1b020 6f 20 63 6f 6e 66 69 67 75 72 65 20 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 20 74 6f 20 65 6e 68 61 o.configure.[Marginalia].to.enha
1b040 6e 63 65 20 74 68 6f 73 65 0a 20 20 63 6f 6d 6d 61 6e 64 73 2e 20 41 6c 6c 20 6f 66 20 74 68 65 nce.those...commands..All.of.the
1b060 20 60 74 61 62 2d 62 61 72 2d 2a 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 27 20 63 6f 6d 6d 61 6e 64 .`tab-bar-*-tab-by-name'.command
1b080 73 20 68 61 76 65 20 74 68 65 20 77 6f 72 64 73 0a 20 20 22 74 61 62 20 62 79 20 6e 61 6d 65 22 s.have.the.words..."tab.by.name"
1b0a0 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 2c 20 73 6f 20 79 6f .in.the.minibuffer.prompt,.so.yo
1b0c0 75 20 63 61 6e 20 75 73 65 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 u.can.use:......................
1b0e0 e2 94 82 20 28 61 64 64 2d 74 6f 2d 6c 69 73 74 20 27 6d 61 72 67 69 6e 61 6c 69 61 2d 70 72 6f ....(add-to-list.'marginalia-pro
1b100 6d 70 74 2d 63 61 74 65 67 6f 72 69 65 73 20 27 28 22 74 61 62 20 62 79 20 6e 61 6d 65 22 20 2e mpt-categories.'("tab.by.name"..
1b120 20 74 61 62 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 54 68 61 74 .tab))......................That
1b140 27 73 20 69 74 21 20 42 75 74 20 69 6e 20 63 61 73 65 20 79 6f 75 20 61 72 65 20 65 76 65 72 20 's.it!.But.in.case.you.are.ever.
1b160 69 6e 20 61 20 73 69 74 75 61 74 69 6f 6e 20 77 68 65 72 65 20 79 6f 75 20 64 6f 6e 27 74 0a 20 in.a.situation.where.you.don't..
1b180 20 61 6c 72 65 61 64 79 20 68 61 76 65 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 70 72 6f 6d .already.have.commands.that.prom
1b1a0 70 74 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 74 73 20 79 6f 75 20 77 61 6e 74 2c 20 49 27 6c pt.for.the.targets.you.want,.I'l
1b1c0 6c 0a 20 20 64 65 73 63 72 69 62 65 20 68 6f 77 20 77 72 69 74 69 6e 67 20 79 6f 75 72 20 6f 77 l...describe.how.writing.your.ow
1b1e0 6e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 70 70 72 6f 70 72 69 61 74 65 20 60 63 61 74 65 n.command.with.appropriate.`cate
1b200 67 6f 72 79 27 0a 20 20 6d 65 74 61 64 61 74 61 20 6c 6f 6f 6b 73 3a 0a 0a 20 20 e2 94 8c e2 94 gory'...metadata.looks:.........
1b220 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 6d 79 2d 73 65 6c 65 63 .................(defun.my-selec
1b240 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 28 74 61 62 29 0a 20 20 e2 94 82 20 20 20 28 69 6e 74 t-tab-by-name.(tab).........(int
1b260 65 72 61 63 74 69 76 65 0a 20 20 e2 94 82 20 20 20 20 28 6c 69 73 74 0a 20 20 e2 94 82 20 20 20 eractive..........(list.........
1b280 20 20 28 6c 65 74 20 28 28 74 61 62 2d 6c 69 73 74 20 28 6f 72 20 28 6d 61 70 63 61 72 20 28 6c ..(let.((tab-list.(or.(mapcar.(l
1b2a0 61 6d 62 64 61 20 28 74 61 62 29 20 28 63 64 72 20 28 61 73 73 71 20 27 6e 61 6d 65 20 74 61 62 ambda.(tab).(cdr.(assq.'name.tab
1b2c0 29 29 29 0a 20 20 e2 94 82 20 09 09 09 09 28 74 61 62 2d 62 61 72 2d 74 61 62 73 29 29 0a 20 20 )))...........(tab-bar-tabs))...
1b2e0 e2 94 82 20 09 09 09 28 75 73 65 72 2d 65 72 72 6f 72 20 22 4e 6f 20 74 61 62 73 20 66 6f 75 6e .......(user-error."No.tabs.foun
1b300 64 22 29 29 29 29 0a 20 20 e2 94 82 20 20 20 20 20 20 20 28 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 d")))).............(completing-r
1b320 65 61 64 0a 20 20 e2 94 82 20 20 20 20 20 20 20 20 22 54 61 62 73 3a 20 22 0a 20 20 e2 94 82 20 ead.............."Tabs:.".......
1b340 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 73 74 72 69 6e 67 20 70 72 65 64 69 63 61 74 65 .......(lambda.(string.predicate
1b360 20 61 63 74 69 6f 6e 29 0a 20 20 e2 94 82 20 09 20 28 69 66 20 28 65 71 20 61 63 74 69 6f 6e 20 .action).........(if.(eq.action.
1b380 27 6d 65 74 61 64 61 74 61 29 0a 20 20 e2 94 82 20 09 20 20 20 20 20 27 28 6d 65 74 61 64 61 74 'metadata).............'(metadat
1b3a0 61 20 28 63 61 74 65 67 6f 72 79 20 2e 20 74 61 62 29 29 0a 20 20 e2 94 82 20 09 20 20 20 28 63 a.(category...tab))...........(c
1b3c0 6f 6d 70 6c 65 74 65 2d 77 69 74 68 2d 61 63 74 69 6f 6e 0a 20 20 e2 94 82 20 09 20 20 20 20 61 omplete-with-action............a
1b3e0 63 74 69 6f 6e 20 74 61 62 2d 6c 69 73 74 20 73 74 72 69 6e 67 20 70 72 65 64 69 63 61 74 65 29 ction.tab-list.string.predicate)
1b400 29 29 29 29 29 29 0a 20 20 e2 94 82 20 20 20 28 74 61 62 2d 62 61 72 2d 73 65 6c 65 63 74 2d 74 )))))).........(tab-bar-select-t
1b420 61 62 2d 62 79 2d 6e 61 6d 65 20 74 61 62 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 ab-by-name.tab))................
1b440 94 80 0a 0a 20 20 41 73 20 79 6f 75 20 63 61 6e 20 73 65 65 2c 20 74 68 65 20 62 75 69 6c 74 2d ......As.you.can.see,.the.built-
1b460 69 6e 20 73 75 70 70 6f 72 74 20 66 6f 72 20 73 65 74 74 69 6e 67 20 74 68 65 20 63 61 74 65 67 in.support.for.setting.the.categ
1b480 6f 72 79 0a 20 20 6d 65 74 61 2d 64 61 74 75 6d 20 69 73 20 6e 6f 74 20 76 65 72 79 20 65 61 73 ory...meta-datum.is.not.very.eas
1b4a0 79 20 74 6f 20 75 73 65 20 6f 72 20 70 72 65 74 74 79 20 74 6f 20 6c 6f 6f 6b 20 61 74 2e 20 54 y.to.use.or.pretty.to.look.at..T
1b4c0 6f 20 68 65 6c 70 20 77 69 74 68 0a 20 20 74 68 69 73 20 49 20 72 65 63 6f 6d 6d 65 6e 64 20 74 o.help.with...this.I.recommend.t
1b4e0 68 65 20 60 63 6f 6e 73 75 6c 74 2d 2d 72 65 61 64 27 20 66 75 6e 63 74 69 6f 6e 20 66 72 6f 6d he.`consult--read'.function.from
1b500 20 74 68 65 20 65 78 63 65 6c 6c 65 6e 74 0a 20 20 5b 43 6f 6e 73 75 6c 74 5d 20 70 61 63 6b 61 .the.excellent...[Consult].packa
1b520 67 65 2e 20 57 69 74 68 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 77 65 20 63 61 6e 20 72 65 ge..With.that.function.we.can.re
1b540 77 72 69 74 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 73 0a 20 20 66 6f 6c 6c 6f 77 73 3a 0a write.the.command.as...follows:.
1b560 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 .........................(defun.
1b580 6d 79 2d 73 65 6c 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 28 74 61 62 29 0a 20 20 e2 94 my-select-tab-by-name.(tab).....
1b5a0 82 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 0a 20 20 e2 94 82 20 20 20 20 28 6c 69 73 74 0a ....(interactive..........(list.
1b5c0 20 20 e2 94 82 20 20 20 20 20 28 6c 65 74 20 28 28 74 61 62 2d 6c 69 73 74 20 28 6f 72 20 28 6d ..........(let.((tab-list.(or.(m
1b5e0 61 70 63 61 72 20 28 6c 61 6d 62 64 61 20 28 74 61 62 29 20 28 63 64 72 20 28 61 73 73 71 20 27 apcar.(lambda.(tab).(cdr.(assq.'
1b600 6e 61 6d 65 20 74 61 62 29 29 29 0a 20 20 e2 94 82 20 09 09 09 09 28 74 61 62 2d 62 61 72 2d 74 name.tab)))...........(tab-bar-t
1b620 61 62 73 29 29 0a 20 20 e2 94 82 20 09 09 09 28 75 73 65 72 2d 65 72 72 6f 72 20 22 4e 6f 20 74 abs))..........(user-error."No.t
1b640 61 62 73 20 66 6f 75 6e 64 22 29 29 29 29 0a 20 20 e2 94 82 20 20 20 20 20 20 20 28 63 6f 6e 73 abs.found")))).............(cons
1b660 75 6c 74 2d 2d 72 65 61 64 20 74 61 62 2d 6c 69 73 74 0a 20 20 e2 94 82 20 09 09 20 20 20 20 20 ult--read.tab-list..............
1b680 3a 70 72 6f 6d 70 74 20 22 54 61 62 73 3a 20 22 0a 20 20 e2 94 82 20 09 09 20 20 20 20 20 3a 63 :prompt."Tabs:."..............:c
1b6a0 61 74 65 67 6f 72 79 20 27 74 61 62 29 29 29 29 0a 20 20 e2 94 82 20 20 20 28 74 61 62 2d 62 61 ategory.'tab)))).........(tab-ba
1b6c0 72 2d 73 65 6c 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 74 61 62 29 29 0a 20 20 e2 94 94 r-select-tab-by-name.tab))......
1b6e0 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 4d 75 63 68 20 6e 69 63 65 72 21 20 4e 6f 20 6d ................Much.nicer!.No.m
1b700 61 74 74 65 72 20 68 6f 77 20 79 6f 75 20 64 65 66 69 6e 65 20 74 68 65 20 60 6d 79 2d 73 65 6c atter.how.you.define.the.`my-sel
1b720 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 27 0a 20 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 20 ect-tab-by-name'...command,.the.
1b740 66 69 72 73 74 20 61 70 70 72 6f 61 63 68 20 77 69 74 68 20 4d 61 72 67 69 6e 61 6c 69 61 20 61 first.approach.with.Marginalia.a
1b760 6e 64 20 70 72 6f 6d 70 74 20 64 65 74 65 63 74 69 6f 6e 20 68 61 73 0a 20 20 74 68 65 20 66 6f nd.prompt.detection.has...the.fo
1b780 6c 6c 6f 77 69 6e 67 20 61 64 76 61 6e 74 61 67 65 73 3a 20 79 6f 75 20 67 65 74 20 74 68 65 20 llowing.advantages:.you.get.the.
1b7a0 60 74 61 62 27 20 63 61 74 65 67 6f 72 79 20 66 6f 72 20 61 6c 6c 20 74 68 65 0a 20 20 60 74 61 `tab'.category.for.all.the...`ta
1b7c0 62 2d 62 61 72 2d 2a 2d 62 61 72 2d 62 79 2d 6e 61 6d 65 27 20 63 6f 6d 6d 61 6e 64 73 20 61 74 b-bar-*-bar-by-name'.commands.at
1b7e0 20 6f 6e 63 65 2c 20 61 6c 73 6f 2c 20 79 6f 75 20 65 6e 68 61 6e 63 65 20 62 75 69 6c 74 2d 69 .once,.also,.you.enhance.built-i
1b800 6e 0a 20 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 64 65 66 69 6e 69 6e n...commands,.instead.of.definin
1b820 67 20 6e 65 77 20 6f 6e 65 73 2e 0a 0a 0a 20 20 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 20 3c 68 74 g.new.ones......[Marginalia].<ht
1b840 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 6d 61 72 67 69 6e 61 6c 69 tps://github.com/minad/marginali
1b860 61 3e 0a 0a 20 20 5b 43 6f 6e 73 75 6c 74 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e a>....[Consult].<https://github.
1b880 63 6f 6d 2f 6d 69 6e 61 64 2f 63 6f 6e 73 75 6c 74 2f 3e 0a 0a 0a e2 97 8a 20 33 2e 37 2e 31 2e com/minad/consult/>.......3.7.1.
1b8a0 32 20 44 65 66 69 6e 69 6e 67 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 61 20 6b 65 79 2.Defining.and.configuring.a.key
1b8c0 6d 61 70 20 66 6f 72 20 74 61 62 20 61 63 74 69 6f 6e 73 0a 0a 20 20 4c 65 74 27 73 20 73 61 79 map.for.tab.actions....Let's.say
1b8e0 20 77 65 20 77 61 6e 74 20 74 6f 20 6f 66 66 65 72 20 73 65 6c 65 63 74 2c 20 72 65 6e 61 6d 65 .we.want.to.offer.select,.rename
1b900 20 61 6e 64 20 63 6c 6f 73 65 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 61 62 73 0a 20 20 28 69 .and.close.actions.for.tabs...(i
1b920 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 45 6d 62 61 72 6b 20 67 65 6e 65 72 61 6c 20 61 63 74 n.addition.to.Embark.general.act
1b940 69 6f 6e 73 2c 20 73 75 63 68 20 61 73 20 73 61 76 69 6e 67 20 74 68 65 20 74 61 62 20 6e 61 6d ions,.such.as.saving.the.tab.nam
1b960 65 20 74 6f 0a 20 20 74 68 65 20 6b 69 6c 6c 2d 72 69 6e 67 2c 20 77 68 69 63 68 20 79 6f 75 20 e.to...the.kill-ring,.which.you.
1b980 67 65 74 20 66 6f 72 20 66 72 65 65 29 2e 20 54 68 65 6e 20 74 68 69 73 20 77 69 6c 6c 20 64 6f get.for.free)..Then.this.will.do
1b9a0 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 76 :..........................(defv
1b9c0 61 72 2d 6b 65 79 6d 61 70 20 65 6d 62 61 72 6b 2d 74 61 62 2d 61 63 74 69 6f 6e 73 0a 20 20 e2 ar-keymap.embark-tab-actions....
1b9e0 94 82 20 20 20 3a 64 6f 63 20 22 4b 65 79 6d 61 70 20 66 6f 72 20 61 63 74 69 6f 6e 73 20 66 6f .....:doc."Keymap.for.actions.fo
1ba00 72 20 74 61 62 2d 62 61 72 20 74 61 62 73 20 28 77 68 65 6e 20 6d 65 6e 74 69 6f 6e 65 64 20 62 r.tab-bar.tabs.(when.mentioned.b
1ba20 79 20 6e 61 6d 65 29 2e 22 0a 20 20 e2 94 82 20 20 20 3a 70 61 72 65 6e 74 20 65 6d 62 61 72 6b y.name).".........:parent.embark
1ba40 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 0a 20 20 e2 94 82 20 20 20 22 73 22 20 23 27 74 61 62 2d 62 -general-map........."s".#'tab-b
1ba60 61 72 2d 73 65 6c 65 63 74 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 0a 20 20 e2 94 82 20 20 20 22 72 ar-select-tab-by-name........."r
1ba80 22 20 23 27 74 61 62 2d 62 61 72 2d 72 65 6e 61 6d 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 0a 20 ".#'tab-bar-rename-tab-by-name..
1baa0 20 e2 94 82 20 20 20 22 6b 22 20 23 27 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 ......."k".#'tab-bar-close-tab-b
1bac0 79 2d 6e 61 6d 65 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 28 61 64 64 2d 74 6f 2d 6c 69 73 y-name)..............(add-to-lis
1bae0 74 20 27 65 6d 62 61 72 6b 2d 6b 65 79 6d 61 70 2d 61 6c 69 73 74 20 27 28 74 61 62 20 2e 20 65 t.'embark-keymap-alist.'(tab...e
1bb00 6d 62 61 72 6b 2d 74 61 62 2d 61 63 74 69 6f 6e 73 29 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 mbark-tab-actions)).............
1bb20 94 80 e2 94 80 0a 0a 20 20 57 68 61 74 20 69 66 20 61 66 74 65 72 20 75 73 69 6e 67 20 74 68 69 .........What.if.after.using.thi
1bb40 73 20 66 6f 72 20 61 20 77 68 69 6c 65 20 79 6f 75 20 66 65 65 6c 20 63 6c 6f 73 69 6e 67 20 74 s.for.a.while.you.feel.closing.t
1bb60 68 65 20 74 61 62 20 77 69 74 68 6f 75 74 0a 20 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 69 73 he.tab.without...confirmation.is
1bb80 20 64 61 6e 67 65 72 6f 75 73 3f 20 59 6f 75 20 68 61 76 65 20 61 20 63 6f 75 70 6c 65 20 6f 66 .dangerous?.You.have.a.couple.of
1bba0 20 6f 70 74 69 6f 6e 73 3a 0a 0a 20 20 31 2e 20 59 6f 75 20 63 61 6e 20 6b 65 65 70 20 75 73 69 .options:....1..You.can.keep.usi
1bbc0 6e 67 20 74 68 65 20 60 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d ng.the.`tab-bar-close-tab-by-nam
1bbe0 65 27 20 63 6f 6d 6d 61 6e 64 2c 20 62 75 74 0a 20 20 20 20 20 68 61 76 65 20 45 6d 62 61 72 6b e'.command,.but......have.Embark
1bc00 20 61 73 6b 20 79 6f 75 20 66 6f 72 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 3a 0a 20 20 20 20 20 .ask.you.for.confirmation:......
1bc20 e2 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 20 20 20 e2 94 82 20 28 70 75 73 68 20 23 .........................(push.#
1bc40 27 65 6d 62 61 72 6b 2d 2d 63 6f 6e 66 69 72 6d 0a 20 20 20 20 20 e2 94 82 20 20 20 20 20 20 20 'embark--confirm................
1bc60 28 61 6c 69 73 74 2d 67 65 74 20 27 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 (alist-get.'tab-bar-close-tab-by
1bc80 2d 6e 61 6d 65 0a 20 20 20 20 20 e2 94 82 20 09 09 20 65 6d 62 61 72 6b 2d 70 72 65 2d 61 63 74 -name.............embark-pre-act
1bca0 69 6f 6e 2d 68 6f 6f 6b 73 29 29 0a 20 20 20 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ion-hooks)).....................
1bcc0 0a 0a 20 20 32 2e 20 59 6f 75 20 63 61 6e 20 77 72 69 74 65 20 79 6f 75 72 20 6f 77 6e 20 63 6f ....2..You.can.write.your.own.co
1bce0 6d 6d 61 6e 64 20 74 68 61 74 20 70 72 6f 6d 70 74 73 20 66 6f 72 20 63 6f 6e 66 69 72 6d 61 74 mmand.that.prompts.for.confirmat
1bd00 69 6f 6e 20 61 6e 64 0a 20 20 20 20 20 75 73 65 20 74 68 61 74 20 69 6e 73 74 65 61 64 20 6f 66 ion.and......use.that.instead.of
1bd20 20 60 74 61 62 2d 62 61 72 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 27 20 69 6e 20 .`tab-bar-close-tab-by-name'.in.
1bd40 74 68 65 20 61 62 6f 76 65 0a 20 20 20 20 20 6b 65 79 6d 61 70 3a 0a 20 20 20 20 20 e2 94 8c e2 the.above......keymap:..........
1bd60 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 20 20 20 e2 94 82 20 28 64 65 66 75 6e 20 6d 79 2d 63 .....................(defun.my-c
1bd80 6f 6e 66 69 72 6d 2d 63 6c 6f 73 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 28 74 61 62 29 0a 20 onfirm-close-tab-by-name.(tab)..
1bda0 20 20 20 20 e2 94 82 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 20 22 73 54 61 62 20 74 6f 20 ..........(interactive."sTab.to.
1bdc0 63 6c 6f 73 65 3a 20 22 29 0a 20 20 20 20 20 e2 94 82 20 20 20 28 77 68 65 6e 20 28 79 2d 6f 72 close:.")............(when.(y-or
1bde0 2d 6e 2d 70 20 28 66 6f 72 6d 61 74 20 22 43 6c 6f 73 65 20 74 61 62 20 27 25 73 27 3f 20 22 20 -n-p.(format."Close.tab.'%s'?.".
1be00 74 61 62 29 29 0a 20 20 20 20 20 e2 94 82 20 20 20 20 20 28 74 61 62 2d 62 61 72 2d 63 6c 6f 73 tab))..............(tab-bar-clos
1be20 65 2d 74 61 62 2d 62 79 2d 6e 61 6d 65 20 74 61 62 29 29 29 0a 20 20 20 20 20 e2 94 94 e2 94 80 e-tab-by-name.tab)))............
1be40 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 20 20 20 4e 6f 74 69 63 65 20 74 68 61 74 20 74 68 69 73 ................Notice.that.this
1be60 20 69 73 20 61 20 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f 20 75 73 65 20 64 .is.a.command.you.can.also.use.d
1be80 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 60 4d 2d 78 27 0a 20 20 20 20 20 69 6e 64 65 70 65 6e 64 irectly.from.`M-x'......independ
1bea0 65 6e 74 6c 79 20 6f 66 20 45 6d 62 61 72 6b 2e 20 55 73 69 6e 67 20 69 74 20 66 72 6f 6d 20 60 ently.of.Embark..Using.it.from.`
1bec0 4d 2d 78 27 20 6c 65 61 76 65 73 20 73 6f 6d 65 74 68 69 6e 67 20 74 6f 20 62 65 0a 20 20 20 20 M-x'.leaves.something.to.be.....
1bee0 20 64 65 73 69 72 65 64 2c 20 74 68 6f 75 67 68 2c 20 73 69 6e 63 65 20 79 6f 75 20 64 6f 6e 27 .desired,.though,.since.you.don'
1bf00 74 20 67 65 74 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 74 61 62 20 6e 61 6d t.get.completion.for.the.tab.nam
1bf20 65 73 2e 0a 20 20 20 20 20 59 6f 75 20 63 61 6e 20 66 69 78 20 74 68 69 73 20 69 66 20 79 6f 75 es.......You.can.fix.this.if.you
1bf40 20 77 69 73 68 20 61 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f .wish.as.described.in.the.previo
1bf60 75 73 20 73 65 63 74 69 6f 6e 2e 0a 0a 0a 33 2e 37 2e 32 20 4e 65 77 20 74 61 72 67 65 74 20 65 us.section....3.7.2.New.target.e
1bf80 78 61 6d 70 6c 65 20 69 6e 20 72 65 67 75 6c 61 72 20 62 75 66 66 65 72 73 20 2d 20 73 68 6f 72 xample.in.regular.buffers.-.shor
1bfa0 74 20 57 69 6b 69 70 65 64 69 61 20 6c 69 6e 6b 73 0a e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 t.Wikipedia.links...............
1bfc0 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
1bfe0 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
1c000 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 ................................
1c020 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 ................................
1c040 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c ................................
1c060 e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c e2 95 8c 0a 0a 20 20 53 ...............................S
1c080 61 79 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 74 65 61 63 68 20 45 6d 62 61 72 6b 20 74 6f 20 74 ay.you.want.to.teach.Embark.to.t
1c0a0 72 65 61 74 20 74 65 78 74 20 6f 66 20 74 68 65 20 66 6f 72 6d 0a 20 20 60 77 69 6b 69 70 65 64 reat.text.of.the.form...`wikiped
1c0c0 69 61 3a 47 61 72 72 79 5f 4b 61 73 70 61 72 6f 76 27 20 69 6e 20 61 6e 79 20 72 65 67 75 6c 61 ia:Garry_Kasparov'.in.any.regula
1c0e0 72 20 62 75 66 66 65 72 20 61 73 20 61 20 6c 69 6e 6b 20 74 6f 0a 20 20 57 69 6b 69 70 65 64 69 r.buffer.as.a.link.to...Wikipedi
1c100 61 2c 20 77 69 74 68 20 61 63 74 69 6f 6e 73 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 57 69 6b 69 a,.with.actions.to.open.the.Wiki
1c120 70 65 64 69 61 20 70 61 67 65 20 69 6e 20 65 77 77 20 6f 72 20 61 6e 0a 20 20 65 78 74 65 72 6e pedia.page.in.eww.or.an...extern
1c140 61 6c 20 62 72 6f 77 73 65 72 20 6f 72 20 74 6f 20 73 61 76 65 20 74 68 65 20 55 52 4c 20 6f 66 al.browser.or.to.save.the.URL.of
1c160 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 65 20 6b 69 6c 6c 2d 72 69 6e 67 2e 20 57 65 0a 20 .the.page.in.the.kill-ring..We..
1c180 20 63 61 6e 20 74 61 6b 65 20 61 64 76 61 6e 74 61 67 65 20 6f 66 20 74 68 65 20 61 63 74 69 6f .can.take.advantage.of.the.actio
1c1a0 6e 73 20 74 68 61 74 20 45 6d 62 61 72 6b 20 68 61 73 20 70 72 65 63 6f 6e 66 69 67 75 72 65 64 ns.that.Embark.has.preconfigured
1c1c0 20 66 6f 72 0a 20 20 55 52 4c 73 2c 20 73 6f 20 61 6c 6c 20 77 65 20 6e 65 65 64 20 74 6f 20 64 .for...URLs,.so.all.we.need.to.d
1c1e0 6f 20 69 73 20 74 65 61 63 68 20 45 6d 62 61 72 6b 20 74 68 61 74 0a 20 20 60 77 69 6b 69 70 65 o.is.teach.Embark.that...`wikipe
1c200 64 69 61 3a 47 61 72 72 79 5f 4b 61 73 70 61 72 6f 76 27 20 73 74 61 6e 64 73 20 66 6f 72 20 74 dia:Garry_Kasparov'.stands.for.t
1c220 68 65 20 55 52 4c 0a 20 20 60 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f he.URL...`https://en.wikipedia.o
1c240 72 67 2f 77 69 6b 69 2f 47 61 72 72 79 5f 4b 61 73 70 61 72 6f 76 27 2e 0a 0a 20 20 59 6f 75 20 rg/wiki/Garry_Kasparov'.....You.
1c260 63 61 6e 20 62 65 20 61 73 20 66 61 6e 63 79 20 61 73 20 79 6f 75 20 77 61 6e 74 20 77 69 74 68 can.be.as.fancy.as.you.want.with
1c280 20 74 68 65 20 72 65 63 6f 67 6e 69 7a 65 64 20 73 79 6e 74 61 78 2e 20 48 65 72 65 2c 20 74 6f .the.recognized.syntax..Here,.to
1c2a0 0a 20 20 6b 65 65 70 20 74 68 65 20 65 78 61 6d 70 6c 65 20 73 69 6d 70 6c 65 2c 20 49 27 6c 6c ...keep.the.example.simple,.I'll
1c2c0 20 61 73 73 75 6d 65 20 74 68 65 20 6c 69 6e 6b 20 6d 61 74 63 68 65 73 20 74 68 65 20 72 65 67 .assume.the.link.matches.the.reg
1c2e0 65 78 70 0a 20 20 60 77 69 6b 69 70 65 64 69 61 3a 5b 5b 3a 61 6c 6e 75 6d 3a 5d 5f 5d 2b 27 2e exp...`wikipedia:[[:alnum:]_]+'.
1c300 20 57 65 20 77 69 6c 6c 20 77 72 69 74 65 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 6c .We.will.write.a.function.that.l
1c320 6f 6f 6b 73 20 66 6f 72 20 61 0a 20 20 6d 61 74 63 68 20 73 75 72 72 6f 75 6e 64 69 6e 67 20 70 ooks.for.a...match.surrounding.p
1c340 6f 69 6e 74 2c 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 20 64 6f 74 74 65 64 20 6c 69 73 74 20 oint,.and.returns.a.dotted.list.
1c360 6f 66 20 74 68 65 20 66 6f 72 6d 20 60 27 28 75 72 6c 0a 20 20 55 52 4c 2d 4f 46 2d 54 48 45 2d of.the.form.`'(url...URL-OF-THE-
1c380 50 41 47 45 20 53 54 41 52 54 20 2e 20 45 4e 44 29 27 20 77 68 65 72 65 20 60 53 54 41 52 54 27 PAGE.START...END)'.where.`START'
1c3a0 20 61 6e 64 20 60 45 4e 44 27 20 61 72 65 20 74 68 65 20 62 75 66 66 65 72 0a 20 20 70 6f 73 69 .and.`END'.are.the.buffer...posi
1c3c0 74 69 6f 6e 73 20 62 6f 75 6e 64 69 6e 67 20 74 68 65 20 74 61 72 67 65 74 2c 20 61 6e 64 20 61 tions.bounding.the.target,.and.a
1c3e0 72 65 20 75 73 65 64 20 62 79 20 45 6d 62 61 72 6b 20 74 6f 20 68 69 67 68 6c 69 67 68 74 20 69 re.used.by.Embark.to.highlight.i
1c400 74 0a 20 20 69 66 20 79 6f 75 20 68 61 76 65 20 60 65 6d 62 61 72 6b 2d 68 69 67 68 6c 69 67 68 t...if.you.have.`embark-highligh
1c420 74 2d 69 6e 64 69 63 61 74 6f 72 27 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 6c 69 73 t-indicator'.included.in.the.lis
1c440 74 0a 20 20 60 65 6d 62 61 72 6b 2d 69 6e 64 69 63 61 74 6f 72 73 27 2e 20 28 54 68 65 72 65 20 t...`embark-indicators'..(There.
1c460 61 72 65 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 6f 74 68 65 72 20 6f 70 74 69 6f 6e 73 20 66 6f are.a.couple.of.other.options.fo
1c480 72 20 74 68 65 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 61 20 74 61 72 67 65 74 r.the...return.value.of.a.target
1c4a0 20 66 69 6e 64 65 72 3a 20 74 68 65 20 62 6f 75 6e 64 69 6e 67 20 70 6f 73 69 74 69 6f 6e 73 20 .finder:.the.bounding.positions.
1c4c0 61 72 65 20 6f 70 74 69 6f 6e 61 6c 0a 20 20 61 6e 64 20 61 20 73 69 6e 67 6c 65 20 74 61 72 67 are.optional...and.a.single.targ
1c4e0 65 74 20 66 69 6e 64 65 72 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 72 65 74 75 72 6e 20 6d et.finder.is.allowed.to.return.m
1c500 75 6c 74 69 70 6c 65 20 74 61 72 67 65 74 73 3b 20 73 65 65 0a 20 20 74 68 65 20 64 6f 63 75 6d ultiple.targets;.see...the.docum
1c520 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 60 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 66 69 6e 64 entation.for.`embark-target-find
1c540 65 72 73 27 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 29 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 ers'.for.details.)..............
1c560 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 6d 79 2d 73 68 6f 72 74 2d 77 69 6b 69 ............(defun.my-short-wiki
1c580 70 65 64 69 61 2d 6c 69 6e 6b 20 28 29 0a 20 20 e2 94 82 20 20 20 22 54 61 72 67 65 74 20 61 20 pedia-link.()........."Target.a.
1c5a0 6c 69 6e 6b 20 61 74 20 70 6f 69 6e 74 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 77 69 6b 69 70 65 link.at.point.of.the.form.wikipe
1c5c0 64 69 61 3a 50 61 67 65 5f 4e 61 6d 65 2e 22 0a 20 20 e2 94 82 20 20 20 28 73 61 76 65 2d 65 78 dia:Page_Name.".........(save-ex
1c5e0 63 75 72 73 69 6f 6e 0a 20 20 e2 94 82 20 20 20 20 20 28 6c 65 74 2a 20 28 28 73 74 61 72 74 20 cursion...........(let*.((start.
1c600 28 70 72 6f 67 6e 20 28 73 6b 69 70 2d 63 68 61 72 73 2d 62 61 63 6b 77 61 72 64 20 22 5b 3a 61 (progn.(skip-chars-backward."[:a
1c620 6c 6e 75 6d 3a 5d 5f 3a 22 29 20 28 70 6f 69 6e 74 29 29 29 0a 20 20 e2 94 82 20 09 20 20 20 28 lnum:]_:").(point)))...........(
1c640 65 6e 64 20 28 70 72 6f 67 6e 20 28 73 6b 69 70 2d 63 68 61 72 73 2d 66 6f 72 77 61 72 64 20 22 end.(progn.(skip-chars-forward."
1c660 5b 3a 61 6c 6e 75 6d 3a 5d 5f 3a 22 29 20 28 70 6f 69 6e 74 29 29 29 0a 20 20 e2 94 82 20 09 20 [:alnum:]_:").(point))).........
1c680 20 20 28 73 74 72 20 28 62 75 66 66 65 72 2d 73 75 62 73 74 72 69 6e 67 2d 6e 6f 2d 70 72 6f 70 ..(str.(buffer-substring-no-prop
1c6a0 65 72 74 69 65 73 20 73 74 61 72 74 20 65 6e 64 29 29 29 0a 20 20 e2 94 82 20 20 20 20 20 20 20 erties.start.end))).............
1c6c0 28 73 61 76 65 2d 6d 61 74 63 68 2d 64 61 74 61 0a 20 20 e2 94 82 20 09 28 77 68 65 6e 20 28 73 (save-match-data........(when.(s
1c6e0 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 77 69 6b 69 70 65 64 69 61 3a 5c 5c 28 5b 5b 3a 61 6c 6e tring-match."wikipedia:\\([[:aln
1c700 75 6d 3a 5d 5f 5d 2b 5c 5c 29 22 20 73 74 72 29 0a 20 20 e2 94 82 20 09 20 20 60 28 75 72 6c 0a um:]_]+\\)".str)..........`(url.
1c720 20 20 e2 94 82 20 09 20 20 20 20 2c 28 66 6f 72 6d 61 74 20 22 68 74 74 70 73 3a 2f 2f 65 6e 2e ...........,(format."https://en.
1c740 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 25 73 22 0a 20 20 e2 94 82 20 09 09 20 wikipedia.org/wiki/%s"..........
1c760 20 20 20 20 28 6d 61 74 63 68 2d 73 74 72 69 6e 67 20 31 20 73 74 72 29 29 0a 20 20 e2 94 82 20 ....(match-string.1.str)).......
1c780 09 20 20 20 20 2c 73 74 61 72 74 20 2e 20 2c 65 6e 64 29 29 29 29 29 29 0a 20 20 e2 94 82 20 0a .....,start...,end))))))........
1c7a0 20 20 e2 94 82 20 28 61 64 64 2d 74 6f 2d 6c 69 73 74 20 27 65 6d 62 61 72 6b 2d 74 61 72 67 65 ......(add-to-list.'embark-targe
1c7c0 74 2d 66 69 6e 64 65 72 73 20 27 6d 79 2d 73 68 6f 72 74 2d 77 69 6b 69 70 65 64 69 61 2d 6c 69 t-finders.'my-short-wikipedia-li
1c7e0 6e 6b 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 0a 34 20 48 6f 77 20 64 6f nk).....................4.How.do
1c800 65 73 20 45 6d 62 61 72 6b 20 63 61 6c 6c 20 74 68 65 20 61 63 74 69 6f 6e 73 3f 0a e2 95 90 e2 es.Embark.call.the.actions?.....
1c820 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 ................................
1c840 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 ................................
1c860 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 ................................
1c880 95 90 e2 95 90 0a 0a 20 20 45 6d 62 61 72 6b 20 61 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f 72 6d .........Embark.actions.are.norm
1c8a0 61 6c 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 61 74 20 69 73 2c 20 66 75 6e 63 al.Emacs.commands,.that.is,.func
1c8c0 74 69 6f 6e 73 20 77 69 74 68 20 61 6e 0a 20 20 69 6e 74 65 72 61 63 74 69 76 65 20 73 70 65 63 tions.with.an...interactive.spec
1c8e0 69 66 69 63 61 74 69 6f 6e 2e 20 49 6e 20 6f 72 64 65 72 20 74 6f 20 65 78 65 63 75 74 65 20 61 ification..In.order.to.execute.a
1c900 6e 20 61 63 74 69 6f 6e 2c 20 45 6d 62 61 72 6b 20 63 61 6c 6c 73 0a 20 20 74 68 65 20 63 6f 6d n.action,.Embark.calls...the.com
1c920 6d 61 6e 64 20 77 69 74 68 20 60 63 61 6c 6c 2d 69 6e 74 65 72 61 63 74 69 76 65 6c 79 27 2c 20 mand.with.`call-interactively',.
1c940 73 6f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 72 65 61 64 73 20 75 73 65 72 20 69 6e 70 75 74 0a so.the.command.reads.user.input.
1c960 20 20 65 78 61 63 74 6c 79 20 61 73 20 69 66 20 72 75 6e 20 64 69 72 65 63 74 6c 79 20 62 79 20 ..exactly.as.if.run.directly.by.
1c980 74 68 65 20 75 73 65 72 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65 20 63 6f 6d 6d 61 6e the.user..For.example.the.comman
1c9a0 64 20 6d 61 79 0a 20 20 6f 70 65 6e 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 61 6e 64 20 72 65 d.may...open.a.minibuffer.and.re
1c9c0 61 64 20 61 20 73 74 72 69 6e 67 20 28 60 72 65 61 64 2d 66 72 6f 6d 2d 6d 69 6e 69 62 75 66 66 ad.a.string.(`read-from-minibuff
1c9e0 65 72 27 29 20 6f 72 20 6f 70 65 6e 20 61 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 69 6e 74 65 er').or.open.a...completion.inte
1ca00 72 66 61 63 65 20 28 60 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 27 29 2e 20 49 66 20 74 68 rface.(`completing-read')..If.th
1ca20 69 73 20 68 61 70 70 65 6e 73 2c 20 45 6d 62 61 72 6b 0a 20 20 74 61 6b 65 73 20 74 68 65 20 74 is.happens,.Embark...takes.the.t
1ca40 61 72 67 65 74 20 73 74 72 69 6e 67 20 61 6e 64 20 69 6e 73 65 72 74 73 20 69 74 20 61 75 74 6f arget.string.and.inserts.it.auto
1ca60 6d 61 74 69 63 61 6c 6c 79 20 69 6e 74 6f 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 2c matically.into.the...minibuffer,
1ca80 20 73 69 6d 75 6c 61 74 69 6e 67 20 75 73 65 72 20 69 6e 70 75 74 20 74 68 69 73 20 77 61 79 2e .simulating.user.input.this.way.
1caa0 20 41 66 74 65 72 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 0a 20 20 73 74 72 69 6e 67 2c 20 45 .After.inserting.the...string,.E
1cac0 6d 62 61 72 6b 20 65 78 69 74 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 73 75 62 6d mbark.exits.the.minibuffer,.subm
1cae0 69 74 74 69 6e 67 20 74 68 65 20 69 6e 70 75 74 2e 20 28 54 68 65 0a 20 20 69 6d 6d 65 64 69 61 itting.the.input..(The...immedia
1cb00 74 65 20 6d 69 6e 69 62 75 66 66 65 72 20 65 78 69 74 20 63 61 6e 20 62 65 20 64 69 73 61 62 6c te.minibuffer.exit.can.be.disabl
1cb20 65 64 20 66 6f 72 20 73 70 65 63 69 66 69 63 20 61 63 74 69 6f 6e 73 20 69 6e 0a 20 20 6f 72 64 ed.for.specific.actions.in...ord
1cb40 65 72 20 74 6f 20 61 6c 6c 6f 77 20 65 64 69 74 69 6e 67 20 74 68 65 20 69 6e 70 75 74 3b 20 74 er.to.allow.editing.the.input;.t
1cb60 68 69 73 20 69 73 20 64 6f 6e 65 20 62 79 20 61 64 64 69 6e 67 20 74 68 65 0a 20 20 60 65 6d 62 his.is.done.by.adding.the...`emb
1cb80 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 27 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 74 68 65 ark--allow-edit'.function.to.the
1cba0 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 6e 74 72 79 20 6f 66 0a 20 20 60 65 6d 62 61 72 6b 2d .appropriate.entry.of...`embark-
1cbc0 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 27 29 2e 20 45 6d 62 61 72 6b target-injection-hooks')..Embark
1cbe0 20 69 6e 73 65 72 74 73 20 74 68 65 20 74 61 72 67 65 74 20 73 74 72 69 6e 67 20 61 74 0a 20 20 .inserts.the.target.string.at...
1cc00 74 68 65 20 66 69 72 73 74 20 6d 69 6e 69 62 75 66 66 65 72 20 6f 70 65 6e 65 64 20 62 79 20 74 the.first.minibuffer.opened.by.t
1cc20 68 65 20 61 63 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 69 66 20 74 68 65 20 63 6f he.action.command,.and.if.the.co
1cc40 6d 6d 61 6e 64 0a 20 20 68 61 70 70 65 6e 73 20 74 6f 20 70 72 6f 6d 70 74 20 74 68 65 20 75 73 mmand...happens.to.prompt.the.us
1cc60 65 72 20 66 6f 72 20 69 6e 70 75 74 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63 65 2c 20 74 68 65 er.for.input.more.than.once,.the
1cc80 20 75 73 65 72 20 73 74 69 6c 6c 0a 20 20 69 6e 74 65 72 61 63 74 73 20 77 69 74 68 20 74 68 65 .user.still...interacts.with.the
1cca0 20 73 65 63 6f 6e 64 20 61 6e 64 20 66 75 72 74 68 65 72 20 70 72 6f 6d 70 74 73 20 69 6e 20 74 .second.and.further.prompts.in.t
1ccc0 68 65 20 6e 6f 72 6d 61 6c 0a 20 20 66 61 73 68 69 6f 6e 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 he.normal...fashion..Note.that.i
1cce0 66 20 61 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 70 72 6f 6d 70 74 20 74 68 65 20 f.a.command.does.not.prompt.the.
1cd00 75 73 65 72 20 66 6f 72 20 69 6e 70 75 74 20 69 6e 0a 20 20 74 68 65 20 6d 69 6e 69 62 75 66 66 user.for.input.in...the.minibuff
1cd20 65 72 2c 20 45 6d 62 61 72 6b 20 73 74 69 6c 6c 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 75 er,.Embark.still.allows.you.to.u
1cd40 73 65 20 69 74 20 61 73 20 61 6e 20 61 63 74 69 6f 6e 2c 20 62 75 74 20 6f 66 0a 20 20 63 6f 75 se.it.as.an.action,.but.of...cou
1cd60 72 73 65 2c 20 6e 65 76 65 72 20 69 6e 73 65 72 74 73 20 74 68 65 20 74 61 72 67 65 74 20 61 6e rse,.never.inserts.the.target.an
1cd80 79 77 68 65 72 65 2e 20 28 54 68 65 72 65 20 61 72 65 20 70 6c 65 6e 74 79 20 6f 66 0a 20 20 65 ywhere..(There.are.plenty.of...e
1cda0 78 61 6d 70 6c 65 73 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 xamples.in.the.default.configura
1cdc0 74 69 6f 6e 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 70 72 6f tion.of.commands.that.do.not.pro
1cde0 6d 70 74 0a 20 20 74 68 65 20 75 73 65 72 20 62 6f 75 6e 64 20 74 6f 20 6b 65 79 73 20 69 6e 20 mpt...the.user.bound.to.keys.in.
1ce00 74 68 65 20 61 63 74 69 6f 6e 20 6d 61 70 73 2c 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 72 65 67 the.action.maps,.most.of.the.reg
1ce20 69 6f 6e 20 61 63 74 69 6f 6e 73 2c 0a 20 20 66 6f 72 20 69 6e 73 74 61 6e 63 65 2e 29 0a 0a 20 ion.actions,...for.instance.)...
1ce40 20 54 68 69 73 20 69 73 20 68 6f 77 20 45 6d 62 61 72 6b 20 6d 61 6e 61 67 65 73 20 74 6f 20 72 .This.is.how.Embark.manages.to.r
1ce60 65 75 73 65 20 6e 6f 72 6d 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 61 73 20 61 63 74 69 6f 6e 73 2e euse.normal.commands.as.actions.
1ce80 20 54 68 65 0a 20 20 6d 65 63 68 61 6e 69 73 6d 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 75 .The...mechanism.allows.you.to.u
1cea0 73 65 20 61 73 20 45 6d 62 61 72 6b 20 61 63 74 69 6f 6e 73 20 63 6f 6d 6d 61 6e 64 73 20 74 68 se.as.Embark.actions.commands.th
1cec0 61 74 20 77 65 72 65 20 6e 6f 74 0a 20 20 77 72 69 74 74 65 6e 20 77 69 74 68 20 45 6d 62 61 72 at.were.not...written.with.Embar
1cee0 6b 20 69 6e 20 6d 69 6e 64 20 28 61 6e 64 20 69 6e 64 65 65 64 20 61 6c 6d 6f 73 74 20 61 6c 6c k.in.mind.(and.indeed.almost.all
1cf00 20 61 63 74 69 6f 6e 73 20 74 68 61 74 20 61 72 65 0a 20 20 62 6f 75 6e 64 20 62 79 20 64 65 66 .actions.that.are...bound.by.def
1cf20 61 75 6c 74 20 69 6e 20 45 6d 62 61 72 6b 27 73 20 61 63 74 69 6f 6e 20 6b 65 79 6d 61 70 73 20 ault.in.Embark's.action.keymaps.
1cf40 61 72 65 20 73 74 61 6e 64 61 72 64 20 45 6d 61 63 73 0a 20 20 63 6f 6d 6d 61 6e 64 73 29 2e 20 are.standard.Emacs...commands)..
1cf60 49 74 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 77 72 69 74 65 20 6e 65 77 20 It.also.allows.you.to.write.new.
1cf80 63 75 73 74 6f 6d 20 61 63 74 69 6f 6e 73 20 69 6e 20 73 75 63 68 20 61 0a 20 20 77 61 79 20 74 custom.actions.in.such.a...way.t
1cfa0 68 61 74 20 74 68 65 79 20 61 72 65 20 75 73 65 66 75 6c 20 65 76 65 6e 20 77 69 74 68 6f 75 74 hat.they.are.useful.even.without
1cfc0 20 45 6d 62 61 72 6b 2e 0a 0a 20 20 53 74 61 72 69 6e 67 20 66 72 6f 6d 20 76 65 72 73 69 6f 6e .Embark.....Staring.from.version
1cfe0 20 32 38 2e 31 2c 20 45 6d 61 63 73 20 68 61 73 20 61 20 76 61 72 69 61 62 6c 65 0a 20 20 60 79 .28.1,.Emacs.has.a.variable...`y
1d000 2d 6f 72 2d 6e 2d 70 2d 75 73 65 2d 72 65 61 64 2d 6b 65 79 27 2c 20 77 68 69 63 68 20 77 68 65 -or-n-p-use-read-key',.which.whe
1d020 6e 20 73 65 74 20 74 6f 20 60 74 27 20 63 61 75 73 65 73 20 60 79 2d 6f 72 2d 6e 2d 70 27 20 74 n.set.to.`t'.causes.`y-or-n-p'.t
1d040 6f 0a 20 20 75 73 65 20 60 72 65 61 64 2d 6b 65 79 27 20 69 6e 73 74 65 61 64 20 6f 66 20 60 72 o...use.`read-key'.instead.of.`r
1d060 65 61 64 2d 66 72 6f 6d 2d 6d 69 6e 69 62 75 66 66 65 72 27 2e 20 53 65 74 74 69 6e 67 0a 20 20 ead-from-minibuffer'..Setting...
1d080 60 79 2d 6f 72 2d 6e 2d 70 2d 75 73 65 2d 72 65 61 64 2d 6b 65 79 27 20 74 6f 20 60 74 27 20 69 `y-or-n-p-use-read-key'.to.`t'.i
1d0a0 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 66 6f 72 20 45 6d 62 61 72 6b 20 75 73 65 72 73 20 62 s.recommended.for.Embark.users.b
1d0c0 65 63 61 75 73 65 0a 20 20 69 74 20 6b 65 65 70 73 20 45 6d 62 61 72 6b 20 66 72 6f 6d 20 61 74 ecause...it.keeps.Embark.from.at
1d0e0 74 65 6d 70 74 69 6e 67 20 74 6f 20 69 6e 73 65 72 74 20 74 68 65 20 74 61 72 67 65 74 20 61 74 tempting.to.insert.the.target.at
1d100 20 61 20 60 79 2d 6f 72 2d 6e 2d 70 27 0a 20 20 70 72 6f 6d 70 74 2c 20 77 68 69 63 68 20 77 6f .a.`y-or-n-p'...prompt,.which.wo
1d120 75 6c 64 20 61 6c 6d 6f 73 74 20 6e 65 76 65 72 20 62 65 20 73 65 6e 73 69 62 6c 65 2e 20 41 6c uld.almost.never.be.sensible..Al
1d140 73 6f 20 63 6f 6e 73 69 64 65 72 20 74 68 69 73 20 61 73 20 61 0a 20 20 77 61 72 6e 69 6e 67 20 so.consider.this.as.a...warning.
1d160 74 6f 20 73 74 72 75 63 74 75 72 65 20 79 6f 75 72 20 6f 77 6e 20 61 63 74 69 6f 6e 20 63 6f 6d to.structure.your.own.action.com
1d180 6d 61 6e 64 73 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 65 79 20 75 73 65 0a 20 20 60 79 2d 6f mands.so.that.if.they.use...`y-o
1d1a0 72 2d 6e 2d 70 27 2c 20 74 68 65 79 20 64 6f 20 73 6f 20 6f 6e 6c 79 20 61 66 74 65 72 20 74 68 r-n-p',.they.do.so.only.after.th
1d1c0 65 20 70 72 6f 6d 70 74 69 6e 67 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 74 2e 0a 0a 20 20 48 e.prompting.for.the.target.....H
1d1e0 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c 65 20 69 6c 6c 75 73 74 72 61 ere.is.a.simple.example.illustra
1d200 74 69 6e 67 20 74 68 65 20 76 61 72 69 6f 75 73 20 77 61 79 73 20 6f 66 20 72 65 61 64 69 6e 67 ting.the.various.ways.of.reading
1d220 0a 20 20 69 6e 70 75 74 20 66 72 6f 6d 20 74 68 65 20 75 73 65 72 20 6d 65 6e 74 69 6f 6e 65 64 ...input.from.the.user.mentioned
1d240 20 61 62 6f 76 65 2e 20 42 69 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 .above..Bind.the.following.comma
1d260 6e 64 73 20 74 6f 0a 20 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 27 nds.to...the.`embark-symbol-map'
1d280 20 74 6f 20 62 65 20 75 73 65 64 20 61 73 20 61 63 74 69 6f 6e 73 2c 20 74 68 65 6e 20 70 75 74 .to.be.used.as.actions,.then.put
1d2a0 20 74 68 65 20 70 6f 69 6e 74 20 6f 6e 0a 20 20 73 6f 6d 65 20 73 79 6d 62 6f 6c 20 61 6e 64 20 .the.point.on...some.symbol.and.
1d2c0 72 75 6e 20 74 68 65 6d 20 77 69 74 68 20 60 65 6d 62 61 72 6b 2d 61 63 74 27 3a 0a 0a 20 20 e2 run.them.with.`embark-act':.....
1d2e0 94 8c e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 65 78 61 6d .....................(defun.exam
1d300 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 31 20 28 29 0a 20 20 e2 94 82 20 20 20 28 ple-action-command1.().........(
1d320 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 e2 94 82 20 20 20 28 6d 65 73 73 61 67 65 20 22 54 interactive).........(message."T
1d340 68 65 20 69 6e 70 75 74 20 77 61 73 20 60 25 73 27 2e 22 20 28 72 65 61 64 2d 66 72 6f 6d 2d 6d he.input.was.`%s'.".(read-from-m
1d360 69 6e 69 62 75 66 66 65 72 20 22 49 6e 70 75 74 3a 20 22 29 29 29 0a 20 20 e2 94 82 20 0a 20 20 inibuffer."Input:.")))..........
1d380 e2 94 82 20 28 64 65 66 75 6e 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e ....(defun.example-action-comman
1d3a0 64 32 20 28 61 72 67 20 69 6e 70 75 74 31 20 69 6e 70 75 74 32 29 0a 20 20 e2 94 82 20 20 20 28 d2.(arg.input1.input2).........(
1d3c0 69 6e 74 65 72 61 63 74 69 76 65 20 22 50 5c 6e 73 49 6e 70 75 74 20 31 3a 20 5c 6e 73 49 6e 70 interactive."P\nsInput.1:.\nsInp
1d3e0 75 74 20 32 3a 20 22 29 0a 20 20 e2 94 82 20 20 20 28 6d 65 73 73 61 67 65 20 22 54 68 65 20 66 ut.2:.").........(message."The.f
1d400 69 72 73 74 20 69 6e 70 75 74 20 25 73 77 61 73 20 60 25 73 27 2c 20 61 6e 64 20 74 68 65 20 73 irst.input.%swas.`%s',.and.the.s
1d420 65 63 6f 6e 64 20 77 61 73 20 60 25 73 27 2e 22 0a 20 20 e2 94 82 20 09 20 20 20 28 69 66 20 61 econd.was.`%s'."...........(if.a
1d440 72 67 20 22 74 72 75 6c 79 20 22 20 22 22 29 0a 20 20 e2 94 82 20 09 20 20 20 69 6e 70 75 74 31 rg."truly."."")...........input1
1d460 0a 20 20 e2 94 82 20 09 20 20 20 69 6e 70 75 74 32 29 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 ...........input2)).............
1d480 20 28 64 65 66 75 6e 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 33 20 .(defun.example-action-command3.
1d4a0 28 29 0a 20 20 e2 94 82 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 e2 94 82 20 20 ().........(interactive)........
1d4c0 20 28 6d 65 73 73 61 67 65 20 22 59 6f 75 72 20 73 65 6c 65 63 74 69 6f 6e 20 77 61 73 20 60 25 .(message."Your.selection.was.`%
1d4e0 73 27 2e 22 0a 20 20 e2 94 82 20 09 20 20 20 28 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 20 s'."...........(completing-read.
1d500 22 53 65 6c 65 63 74 3a 20 22 20 27 28 22 45 22 20 22 4d 22 20 22 42 22 20 22 41 22 20 22 52 22 "Select:.".'("E"."M"."B"."A"."R"
1d520 20 22 4b 22 29 29 29 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 65 78 61 ."K"))))..............(defun.exa
1d540 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 34 20 28 29 0a 20 20 e2 94 82 20 20 20 mple-action-command4.().........
1d560 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 e2 94 82 20 20 20 28 6d 65 73 73 61 67 65 20 22 (interactive).........(message."
1d580 49 20 64 6f 6e 27 74 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 69 6e 70 75 74 20 61 6e 64 I.don't.prompt.you.for.input.and
1d5a0 20 74 68 75 73 20 69 67 6e 6f 72 65 20 74 68 65 20 74 61 72 67 65 74 21 22 29 29 0a 20 20 e2 94 .thus.ignore.the.target!")).....
1d5c0 82 20 0a 20 20 e2 94 82 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d 62 61 72 6b 2d 73 79 6d 62 .........(keymap-set.embark-symb
1d5e0 6f 6c 2d 6d 61 70 20 22 58 20 31 22 20 23 27 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f ol-map."X.1".#'example-action-co
1d600 6d 6d 61 6e 64 31 29 0a 20 20 e2 94 82 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d 62 61 72 6b mmand1).......(keymap-set.embark
1d620 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 32 22 20 23 27 65 78 61 6d 70 6c 65 2d 61 63 74 69 -symbol-map."X.2".#'example-acti
1d640 6f 6e 2d 63 6f 6d 6d 61 6e 64 32 29 0a 20 20 e2 94 82 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 on-command2).......(keymap-set.e
1d660 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 33 22 20 23 27 65 78 61 6d 70 6c 65 mbark-symbol-map."X.3".#'example
1d680 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 33 29 0a 20 20 e2 94 82 20 28 6b 65 79 6d 61 70 2d -action-command3).......(keymap-
1d6a0 73 65 74 20 65 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 34 22 20 23 27 65 78 set.embark-symbol-map."X.4".#'ex
1d6c0 61 6d 70 6c 65 2d 61 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 34 29 0a 20 20 e2 94 94 e2 94 80 e2 ample-action-command4)..........
1d6e0 94 80 e2 94 80 e2 94 80 0a 0a 20 20 41 6c 73 6f 20 6e 6f 74 65 20 74 68 61 74 20 69 66 20 79 6f ............Also.note.that.if.yo
1d700 75 20 61 72 65 20 75 73 69 6e 67 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 74 6f 20 u.are.using.the.key.bindings.to.
1d720 63 61 6c 6c 20 61 63 74 69 6f 6e 73 2c 20 79 6f 75 0a 20 20 63 61 6e 20 70 61 73 73 20 70 72 65 call.actions,.you...can.pass.pre
1d740 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 61 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 fix.arguments.to.actions.in.the.
1d760 6e 6f 72 6d 61 6c 20 77 61 79 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 20 20 79 6f 75 20 63 normal.way..For.example,...you.c
1d780 61 6e 20 75 73 65 20 60 43 2d 75 20 58 32 27 20 77 69 74 68 20 74 68 65 20 61 62 6f 76 65 20 64 an.use.`C-u.X2'.with.the.above.d
1d7a0 65 6d 6f 6e 73 74 72 61 74 69 6f 6e 20 61 63 74 69 6f 6e 73 20 74 6f 20 6d 61 6b 65 20 74 68 65 emonstration.actions.to.make.the
1d7c0 0a 20 20 6d 65 73 73 61 67 65 20 70 72 69 6e 74 65 64 20 62 79 20 60 65 78 61 6d 70 6c 65 2d 61 ...message.printed.by.`example-a
1d7e0 63 74 69 6f 6e 2d 63 6f 6d 6d 61 6e 64 32 27 20 6d 6f 72 65 20 65 6d 70 68 61 74 69 63 2e 20 20 ction-command2'.more.emphatic...
1d800 54 68 69 73 0a 20 20 61 62 69 6c 69 74 79 20 74 6f 20 70 61 73 73 20 70 72 65 66 69 78 20 61 72 This...ability.to.pass.prefix.ar
1d820 67 75 6d 65 6e 74 73 20 74 6f 20 61 63 74 69 6f 6e 73 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 guments.to.actions.is.useful.for
1d840 20 73 6f 6d 65 20 61 63 74 69 6f 6e 73 0a 20 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 .some.actions...in.the.default.c
1d860 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 73 75 63 68 20 61 73 0a 20 20 60 65 6d 62 61 72 6b 2d onfiguration,.such.as...`embark-
1d880 73 68 65 6c 6c 2d 63 6f 6d 6d 61 6e 64 2d 6f 6e 2d 62 75 66 66 65 72 27 2e 0a 0a 0a 34 2e 31 20 shell-command-on-buffer'....4.1.
1d8a0 4e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 61 63 74 Non-interactive.functions.as.act
1d8c0 69 6f 6e 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 ions............................
1d8e0 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ................................
1d900 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 ................................
1d920 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 ................................
1d940 20 41 6c 74 65 72 6e 61 74 69 76 65 6c 79 2c 20 45 6d 62 61 72 6b 20 64 6f 65 73 20 73 75 70 70 .Alternatively,.Embark.does.supp
1d960 6f 72 74 20 6f 6e 65 20 6f 74 68 65 72 20 74 79 70 65 20 6f 66 20 61 63 74 69 6f 6e 3a 20 61 0a ort.one.other.type.of.action:.a.
1d980 20 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 61 20 ..non-interactive.function.of.a.
1d9a0 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 74 61 72 67 65 74 20 69 73 20 70 single.argument..The.target.is.p
1d9c0 61 73 73 65 64 20 61 73 0a 20 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 assed.as...argument.to.the.funct
1d9e0 69 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 0a 20 20 e2 94 8c e2 94 80 e2 94 80 e2 94 ion..For.example:...............
1da00 80 e2 94 80 0a 20 20 e2 94 82 20 28 64 65 66 75 6e 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 6f 6e ...........(defun.example-action
1da20 2d 66 75 6e 63 74 69 6f 6e 20 28 74 61 72 67 65 74 29 0a 20 20 e2 94 82 20 20 20 28 6d 65 73 73 -function.(target).........(mess
1da40 61 67 65 20 22 54 68 65 20 74 61 72 67 65 74 20 77 61 73 20 60 25 73 27 2e 22 20 74 61 72 67 65 age."The.target.was.`%s'.".targe
1da60 74 29 29 0a 20 20 e2 94 82 20 0a 20 20 e2 94 82 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d 62 t))..............(keymap-set.emb
1da80 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 20 22 58 20 34 22 20 23 27 65 78 61 6d 70 6c 65 2d 61 ark-symbol-map."X.4".#'example-a
1daa0 63 74 69 6f 6e 2d 66 75 6e 63 74 69 6f 6e 29 0a 20 20 e2 94 94 e2 94 80 e2 94 80 e2 94 80 e2 94 ction-function).................
1dac0 80 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 20 6e 6f 72 6d 61 6c 6c 79 20 62 69 6e 64 69 6e 67 20 .....Note.that.normally.binding.
1dae0 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 20 61 20 6b non-interactive.functions.in.a.k
1db00 65 79 6d 61 70 20 69 73 0a 20 20 75 73 65 6c 65 73 73 2c 20 73 69 6e 63 65 20 77 68 65 6e 20 61 eymap.is...useless,.since.when.a
1db20 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 72 75 6e 20 74 68 65 6d 20 75 73 69 6e 67 20 74 68 65 20 ttempting.to.run.them.using.the.
1db40 6b 65 79 20 62 69 6e 64 69 6e 67 20 79 6f 75 0a 20 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20 6d key.binding.you...get.an.error.m
1db60 65 73 73 61 67 65 20 73 69 6d 69 6c 61 72 20 74 6f 20 22 57 72 6f 6e 67 20 74 79 70 65 20 61 72 essage.similar.to."Wrong.type.ar
1db80 67 75 6d 65 6e 74 3a 20 63 6f 6d 6d 61 6e 64 70 2c 0a 20 20 65 78 61 6d 70 6c 65 2d 61 63 74 69 gument:.commandp,...example-acti
1dba0 6f 6e 2d 66 75 6e 63 74 69 6f 6e 22 2e 20 49 6e 20 67 65 6e 65 72 61 6c 20 69 74 20 69 73 20 6d on-function"..In.general.it.is.m
1dbc0 6f 72 65 20 66 6c 65 78 69 62 6c 65 20 74 6f 20 77 72 69 74 65 20 61 6e 79 0a 20 20 6e 65 77 20 ore.flexible.to.write.any...new.
1dbe0 45 6d 62 61 72 6b 20 61 63 74 69 6f 6e 73 20 61 73 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 61 74 Embark.actions.as.commands,.that
1dc00 20 69 73 2c 20 61 73 20 69 6e 74 65 72 61 63 74 69 76 65 20 66 75 6e 63 74 69 6f 6e 73 2c 0a 20 .is,.as.interactive.functions,..
1dc20 20 62 65 63 61 75 73 65 20 74 68 61 74 20 77 61 79 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f 20 72 .because.that.way.you.can.also.r
1dc40 75 6e 20 74 68 65 6d 20 64 69 72 65 63 74 6c 79 2c 20 77 69 74 68 6f 75 74 20 45 6d 62 61 72 6b un.them.directly,.without.Embark
1dc60 2e 20 42 75 74 0a 20 20 74 68 65 72 65 20 61 72 65 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 72 65 ..But...there.are.a.couple.of.re
1dc80 61 73 6f 6e 73 20 74 6f 20 75 73 65 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 20 66 75 6e asons.to.use.non-interactive.fun
1dca0 63 74 69 6f 6e 73 20 61 73 0a 20 20 61 63 74 69 6f 6e 73 3a 0a 0a 20 20 31 2e 20 59 6f 75 20 6d ctions.as...actions:....1..You.m
1dcc0 61 79 20 61 6c 72 65 61 64 79 20 68 61 76 65 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 6c 79 69 ay.already.have.the.function.lyi
1dce0 6e 67 20 61 72 6f 75 6e 64 2c 20 61 6e 64 20 69 74 20 69 73 0a 20 20 20 20 20 63 6f 6e 76 65 6e ng.around,.and.it.is......conven
1dd00 69 65 6e 74 20 74 6f 20 73 69 6d 70 6c 79 20 72 65 75 73 65 20 69 74 2e 0a 0a 20 20 32 2e 20 46 ient.to.simply.reuse.it.....2..F
1dd20 6f 72 20 63 6f 6d 6d 61 6e 64 20 61 63 74 69 6f 6e 73 20 74 68 65 20 74 61 72 67 65 74 73 20 63 or.command.actions.the.targets.c
1dd40 61 6e 20 6f 6e 6c 79 20 62 65 20 73 69 6d 70 6c 65 20 73 74 72 69 6e 67 2c 20 77 69 74 68 20 6e an.only.be.simple.string,.with.n
1dd60 6f 0a 20 20 20 20 20 74 65 78 74 20 70 72 6f 70 65 72 74 69 65 73 2e 20 46 6f 72 20 63 65 72 74 o......text.properties..For.cert
1dd80 61 69 6e 20 61 64 76 61 6e 63 65 64 20 75 73 65 73 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 ain.advanced.uses.you.may.want.t
1dda0 68 65 20 61 63 74 69 6f 6e 0a 20 20 20 20 20 74 6f 20 72 65 63 65 69 76 65 20 61 20 73 74 72 69 he.action......to.receive.a.stri
1ddc0 6e 67 20 2f 77 69 74 68 2f 20 73 6f 6d 65 20 74 65 78 74 20 70 72 6f 70 65 72 74 69 65 73 2c 20 ng./with/.some.text.properties,.
1dde0 6f 72 20 65 76 65 6e 20 61 0a 20 20 20 20 20 6e 6f 6e 2d 73 74 72 69 6e 67 20 74 61 72 67 65 74 or.even.a......non-string.target
1de00 2e 0a 0a 0a 35 20 45 6d 62 61 72 6b 2c 20 4d 61 72 67 69 6e 61 6c 69 61 20 61 6e 64 20 43 6f 6e ....5.Embark,.Marginalia.and.Con
1de20 73 75 6c 74 0a e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 sult............................
1de40 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 ................................
1de60 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 ................................
1de80 95 90 e2 95 90 0a 0a 20 20 45 6d 62 61 72 6b 20 63 6f 6f 70 65 72 61 74 65 73 20 77 65 6c 6c 20 .........Embark.cooperates.well.
1dea0 77 69 74 68 20 74 68 65 20 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 20 61 6e 64 20 5b 43 6f 6e 73 75 with.the.[Marginalia].and.[Consu
1dec0 6c 74 5d 20 70 61 63 6b 61 67 65 73 2e 0a 20 20 4e 65 69 74 68 65 72 20 6f 66 20 74 68 6f 73 65 lt].packages....Neither.of.those
1dee0 20 70 61 63 6b 61 67 65 73 20 69 73 20 61 20 64 65 70 65 6e 64 65 6e 63 79 20 6f 66 20 45 6d 62 .packages.is.a.dependency.of.Emb
1df00 61 72 6b 2c 20 62 75 74 20 62 6f 74 68 20 61 72 65 0a 20 20 68 69 67 68 6c 79 20 72 65 63 6f 6d ark,.but.both.are...highly.recom
1df20 6d 65 6e 64 65 64 20 63 6f 6d 70 61 6e 69 6f 6e 73 20 74 6f 20 45 6d 62 61 72 6b 2c 20 66 6f 72 mended.companions.to.Embark,.for
1df40 20 6f 70 70 6f 73 69 74 65 20 72 65 61 73 6f 6e 73 3a 0a 20 20 4d 61 72 67 69 6e 61 6c 69 61 20 .opposite.reasons:...Marginalia.
1df60 67 72 65 61 74 6c 79 20 65 6e 68 61 6e 63 65 73 20 45 6d 62 61 72 6b 27 73 20 75 73 65 66 75 6c greatly.enhances.Embark's.useful
1df80 6e 65 73 73 2c 20 77 68 69 6c 65 20 45 6d 62 61 72 6b 20 63 61 6e 20 68 65 6c 70 0a 20 20 65 6e ness,.while.Embark.can.help...en
1dfa0 68 61 6e 63 65 20 43 6f 6e 73 75 6c 74 2e 0a 0a 20 20 49 6e 20 74 68 65 20 72 65 6d 61 69 6e 64 hance.Consult.....In.the.remaind
1dfc0 65 72 20 6f 66 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 49 27 6c 6c 20 65 78 70 6c 61 69 6e 20 er.of.this.section.I'll.explain.
1dfe0 77 68 61 74 20 65 78 61 63 74 6c 79 20 4d 61 72 67 69 6e 61 6c 69 61 0a 20 20 64 6f 65 73 20 66 what.exactly.Marginalia...does.f
1e000 6f 72 20 45 6d 62 61 72 6b 2c 20 61 6e 64 20 77 68 61 74 20 45 6d 62 61 72 6b 20 63 61 6e 20 64 or.Embark,.and.what.Embark.can.d
1e020 6f 20 66 6f 72 20 43 6f 6e 73 75 6c 74 2e 0a 0a 0a 5b 4d 61 72 67 69 6e 61 6c 69 61 5d 20 3c 68 o.for.Consult....[Marginalia].<h
1e040 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 2f 6d 61 72 67 69 6e 61 6c ttps://github.com/minad/marginal
1e060 69 61 3e 0a 0a 5b 43 6f 6e 73 75 6c 74 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 ia>..[Consult].<https://github.c
1e080 6f 6d 2f 6d 69 6e 61 64 2f 63 6f 6e 73 75 6c 74 3e 0a 0a 35 2e 31 20 4d 61 72 67 69 6e 61 6c 69 om/minad/consult>..5.1.Marginali
1e0a0 61 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 a...............................
1e0c0 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 45 6d 62 61 72 6b 20 63 6f 6d 65 73 20 77 69 74 ................Embark.comes.wit
1e0e0 68 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 73 79 6d 62 6f 6c 73 20 28 63 6f 6d 6d 61 6e 64 73 2c h.actions.for.symbols.(commands,
1e100 20 66 75 6e 63 74 69 6f 6e 73 2c 20 76 61 72 69 61 62 6c 65 73 0a 20 20 77 69 74 68 20 61 63 74 .functions,.variables...with.act
1e120 69 6f 6e 73 20 73 75 63 68 20 61 73 20 66 69 6e 64 69 6e 67 20 74 68 65 20 64 65 66 69 6e 69 74 ions.such.as.finding.the.definit
1e140 69 6f 6e 2c 20 6c 6f 6f 6b 69 6e 67 20 75 70 20 74 68 65 0a 20 20 64 6f 63 75 6d 65 6e 74 61 74 ion,.looking.up.the...documentat
1e160 69 6f 6e 2c 20 65 76 61 6c 75 61 74 69 6e 67 2c 20 65 74 63 2e 29 20 69 6e 20 74 68 65 20 60 65 ion,.evaluating,.etc.).in.the.`e
1e180 6d 62 61 72 6b 2d 73 79 6d 62 6f 6c 2d 6d 61 70 27 20 6b 65 79 6d 61 70 2c 0a 20 20 61 6e 64 20 mbark-symbol-map'.keymap,...and.
1e1a0 66 6f 72 20 70 61 63 6b 61 67 65 73 20 28 61 63 74 69 6f 6e 73 20 6c 69 6b 65 20 69 6e 73 74 61 for.packages.(actions.like.insta
1e1c0 6c 6c 2c 20 64 65 6c 65 74 65 2c 20 62 72 6f 77 73 65 20 75 72 6c 2c 20 65 74 63 2e 29 20 69 6e ll,.delete,.browse.url,.etc.).in
1e1e0 0a 20 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 70 61 63 6b 61 67 65 2d 6b 65 79 6d 61 70 27 2e 0a ...the.`embark-package-keymap'..
1e200 0a 20 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 45 6d 62 61 72 6b 20 64 6f 65 73 20 6e 6f 74 ...Unfortunately.Embark.does.not
1e220 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 66 66 65 72 73 20 79 6f 75 20 74 68 65 73 65 20 .automatically.offers.you.these.
1e240 6b 65 79 6d 61 70 73 0a 20 20 77 68 65 6e 20 72 65 6c 65 76 61 6e 74 2c 20 62 65 63 61 75 73 65 keymaps...when.relevant,.because
1e260 20 6d 61 6e 79 20 62 75 69 6c 74 2d 69 6e 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 20 64 6f .many.built-in.Emacs.commands.do
1e280 6e 27 74 20 72 65 70 6f 72 74 0a 20 20 61 63 63 75 72 61 74 65 20 63 61 74 65 67 6f 72 79 20 6d n't.report...accurate.category.m
1e2a0 65 74 61 64 61 74 61 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 61 20 63 6f 6d 6d 61 6e 64 20 etadata..For.example,.a.command.
1e2c0 6c 69 6b 65 0a 20 20 60 64 65 73 63 72 69 62 65 2d 70 61 63 6b 61 67 65 27 2c 20 77 68 69 63 68 like...`describe-package',.which
1e2e0 20 72 65 61 64 73 20 61 20 70 61 63 6b 61 67 65 20 6e 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 6d .reads.a.package.name.from.the.m
1e300 69 6e 69 62 75 66 66 65 72 2c 0a 20 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 6d 65 74 61 64 inibuffer,...does.not.have.metad
1e320 61 74 61 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 69 73 20 66 61 63 74 2e 0a 0a 20 20 49 6e 20 ata.indicating.this.fact.....In.
1e340 61 6e 20 65 61 72 6c 69 65 72 20 45 6d 62 61 72 6b 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 72 65 an.earlier.Embark.version,.there
1e360 20 77 65 72 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 73 75 70 70 6c 79 20 74 68 69 73 0a 20 .were.functions.to.supply.this..
1e380 20 6d 69 73 73 69 6e 67 20 6d 65 74 61 64 61 74 61 2c 20 62 75 74 20 74 68 65 79 20 68 61 76 65 .missing.metadata,.but.they.have
1e3a0 20 62 65 65 6e 20 6d 6f 76 65 64 20 74 6f 20 4d 61 72 67 69 6e 61 6c 69 61 2c 20 77 68 69 63 68 .been.moved.to.Marginalia,.which
1e3c0 0a 20 20 61 75 67 6d 65 6e 74 73 20 6d 61 6e 79 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 20 74 ...augments.many.Emacs.command.t
1e3e0 6f 20 72 65 70 6f 72 74 20 61 63 63 75 72 61 74 65 20 63 61 74 65 67 6f 72 79 20 6d 65 74 61 64 o.report.accurate.category.metad
1e400 61 74 61 2e 0a 20 20 53 69 6d 70 6c 79 20 61 63 74 69 76 61 74 69 6e 67 20 60 6d 61 72 67 69 6e ata....Simply.activating.`margin
1e420 61 6c 69 61 2d 6d 6f 64 65 27 20 61 6c 6c 6f 77 73 20 45 6d 62 61 72 6b 20 74 6f 20 6f 66 66 65 alia-mode'.allows.Embark.to.offe
1e440 72 20 79 6f 75 20 74 68 65 0a 20 20 70 61 63 6b 61 67 65 20 61 6e 64 20 73 79 6d 62 6f 6c 20 61 r.you.the...package.and.symbol.a
1e460 63 74 69 6f 6e 73 20 77 68 65 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 61 67 61 69 6e 2e 20 43 ctions.when.appropriate.again..C
1e480 61 6e 64 69 64 61 74 65 0a 20 20 61 6e 6e 6f 74 61 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 45 6d andidate...annotations.in.the.Em
1e4a0 62 61 72 6b 20 63 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 61 72 65 20 61 6c 73 6f 20 70 72 6f bark.collect.buffer.are.also.pro
1e4c0 76 69 64 65 64 20 62 79 20 74 68 65 0a 20 20 4d 61 72 67 69 6e 61 6c 69 61 20 70 61 63 6b 61 67 vided.by.the...Marginalia.packag
1e4e0 65 3a 0a 0a 20 20 e2 80 a2 20 49 66 20 79 6f 75 20 69 6e 73 74 61 6c 6c 20 4d 61 72 67 69 6e 61 e:........If.you.install.Margina
1e500 6c 69 61 20 61 6e 64 20 61 63 74 69 76 61 74 65 20 60 6d 61 72 67 69 6e 61 6c 69 61 2d 6d 6f 64 lia.and.activate.`marginalia-mod
1e520 65 27 2c 20 45 6d 62 61 72 6b 0a 20 20 20 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 20 77 e',.Embark.....Collect.buffers.w
1e540 69 6c 6c 20 75 73 65 20 74 68 65 20 4d 61 72 67 69 6e 61 6c 69 61 20 61 6e 6e 6f 74 61 74 69 6f ill.use.the.Marginalia.annotatio
1e560 6e 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 0a 20 20 e2 80 a2 20 49 66 20 79 6f 75 20 ns.automatically.........If.you.
1e580 64 6f 6e 27 74 20 69 6e 73 74 61 6c 6c 20 4d 61 72 67 69 6e 61 6c 69 61 2c 20 79 6f 75 20 77 69 don't.install.Marginalia,.you.wi
1e5a0 6c 6c 20 73 65 65 20 6f 6e 6c 79 20 74 68 65 20 61 6e 6e 6f 74 61 74 69 6f 6e 73 0a 20 20 20 20 ll.see.only.the.annotations.....
1e5c0 74 68 61 74 20 63 6f 6d 65 20 77 69 74 68 20 45 6d 61 63 73 20 28 73 75 63 68 20 61 73 20 6b 65 that.come.with.Emacs.(such.as.ke
1e5e0 79 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 60 4d 2d 78 27 2c 20 6f 72 20 74 68 65 20 75 6e 69 63 y.bindings.in.`M-x',.or.the.unic
1e600 6f 64 65 0a 20 20 20 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 20 60 43 2d 78 20 38 20 52 45 54 ode.....characters.in.`C-x.8.RET
1e620 27 29 2e 0a 0a 0a 35 2e 32 20 43 6f 6e 73 75 6c 74 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 ')....5.2.Consult...............
1e640 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 54 68 65 20 65 78 63 65 6c .......................The.excel
1e660 6c 65 6e 74 20 43 6f 6e 73 75 6c 74 20 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64 65 73 20 6d 61 lent.Consult.package.provides.ma
1e680 6e 79 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 75 73 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 ny.commands.that.use...minibuffe
1e6a0 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 76 69 61 20 74 68 65 20 60 63 6f 6d 70 6c 65 74 69 6e r.completion,.via.the.`completin
1e6c0 67 2d 72 65 61 64 27 20 66 75 6e 63 74 69 6f 6e 3b 20 70 6c 65 6e 74 79 20 6f 66 0a 20 20 69 74 g-read'.function;.plenty.of...it
1e6e0 73 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 20 65 6e 68 s.commands.can.be.considered.enh
1e700 61 6e 63 65 64 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 62 75 69 6c 74 2d 69 6e 20 45 6d 61 63 73 anced.versions.of.built-in.Emacs
1e720 0a 20 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 73 6f 6d 65 20 61 72 65 20 63 6f 6d 70 6c 65 ...commands,.and.some.are.comple
1e740 74 65 6c 79 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e 20 4f 6e 65 20 63 6f 6d 6d tely.new.functionality..One.comm
1e760 6f 6e 0a 20 20 65 6e 68 61 6e 63 65 6d 65 6e 74 20 70 72 6f 76 69 64 65 64 20 69 6e 20 61 6c 6c on...enhancement.provided.in.all
1e780 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 77 68 69 63 68 20 69 74 20 6d 61 6b 65 73 20 73 65 6e .commands.for.which.it.makes.sen
1e7a0 73 65 20 69 73 0a 20 20 70 72 65 76 69 65 77 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2c 20 66 se.is...preview.functionality,.f
1e7c0 6f 72 20 65 78 61 6d 70 6c 65 20 60 63 6f 6e 73 75 6c 74 2d 62 75 66 66 65 72 27 20 77 69 6c 6c or.example.`consult-buffer'.will
1e7e0 20 73 68 6f 77 20 79 6f 75 20 61 0a 20 20 71 75 69 63 6b 20 70 72 65 76 69 65 77 20 6f 66 20 61 .show.you.a...quick.preview.of.a
1e800 20 62 75 66 66 65 72 20 62 65 66 6f 72 65 20 79 6f 75 20 61 63 74 75 61 6c 6c 79 20 73 77 69 74 .buffer.before.you.actually.swit
1e820 63 68 20 74 6f 20 69 74 2e 0a 0a 20 20 49 66 20 79 6f 75 20 75 73 65 20 62 6f 74 68 20 43 6f 6e ch.to.it.....If.you.use.both.Con
1e840 73 75 6c 74 20 61 6e 64 20 45 6d 62 61 72 6b 20 79 6f 75 20 73 68 6f 75 6c 64 20 69 6e 73 74 61 sult.and.Embark.you.should.insta
1e860 6c 6c 20 74 68 65 0a 20 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 20 70 61 63 6b 61 67 ll.the...`embark-consult'.packag
1e880 65 20 77 68 69 63 68 20 70 72 6f 76 69 64 65 73 20 69 6e 74 65 67 72 61 74 69 6f 6e 20 62 65 74 e.which.provides.integration.bet
1e8a0 77 65 65 6e 20 74 68 65 0a 20 20 74 77 6f 2e 20 49 74 20 70 72 6f 76 69 64 65 73 20 65 78 70 6f ween.the...two..It.provides.expo
1e8c0 72 74 65 72 73 20 66 6f 72 20 73 65 76 65 72 61 6c 20 43 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e rters.for.several.Consult.comman
1e8e0 64 73 20 61 6e 64 20 61 6c 73 6f 0a 20 20 74 77 65 61 6b 73 20 74 68 65 20 62 65 68 61 76 69 6f ds.and.also...tweaks.the.behavio
1e900 72 20 6f 66 20 6d 61 6e 79 20 43 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 73 20 77 68 65 6e 20 r.of.many.Consult.commands.when.
1e920 75 73 65 64 20 61 73 20 61 63 74 69 6f 6e 73 20 77 69 74 68 0a 20 20 60 65 6d 62 61 72 6b 2d 61 used.as.actions.with...`embark-a
1e940 63 74 27 20 69 6e 20 73 75 62 74 6c 65 20 77 61 79 73 20 74 68 61 74 20 79 6f 75 20 6d 61 79 20 ct'.in.subtle.ways.that.you.may.
1e960 6e 6f 74 20 65 76 65 6e 20 6e 6f 74 69 63 65 2c 20 62 75 74 20 6d 61 6b 65 20 66 6f 72 0a 20 20 not.even.notice,.but.make.for...
1e980 61 20 73 6d 6f 6f 74 68 65 72 20 65 78 70 65 72 69 65 6e 63 65 2e 20 59 6f 75 20 6e 65 65 64 20 a.smoother.experience..You.need.
1e9a0 6f 6e 6c 79 20 69 6e 73 74 61 6c 6c 20 69 74 20 74 6f 20 67 65 74 20 74 68 65 73 65 20 62 65 6e only.install.it.to.get.these.ben
1e9c0 65 66 69 74 73 3a 0a 20 20 45 6d 62 61 72 6b 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c efits:...Embark.will.automatical
1e9e0 6c 79 20 6c 6f 61 64 20 69 74 20 61 66 74 65 72 20 43 6f 6e 73 75 6c 74 20 69 66 20 66 6f 75 6e ly.load.it.after.Consult.if.foun
1ea00 64 2e 0a 0a 20 20 54 68 65 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 20 70 61 63 6b 61 d.....The.`embark-consult'.packa
1ea20 67 65 20 70 72 6f 76 69 64 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 70 6f 72 74 ge.provides.the.following.export
1ea40 65 72 73 3a 0a 0a 20 20 e2 80 a2 20 59 6f 75 20 63 61 6e 20 75 73 65 20 60 65 6d 62 61 72 6b 2d ers:........You.can.use.`embark-
1ea60 65 78 70 6f 72 74 27 20 66 72 6f 6d 20 60 63 6f 6e 73 75 6c 74 2d 6c 69 6e 65 27 2c 20 60 63 6f export'.from.`consult-line',.`co
1ea80 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 27 2c 0a 20 20 20 20 6f 72 20 60 63 6f 6e 73 75 6c 74 2d nsult-outline',.....or.`consult-
1eaa0 6d 61 72 6b 27 20 74 6f 20 6f 62 74 61 69 6e 20 61 6e 20 60 6f 63 63 75 72 2d 6d 6f 64 65 27 20 mark'.to.obtain.an.`occur-mode'.
1eac0 62 75 66 66 65 72 2e 20 41 73 20 77 69 74 68 20 74 68 65 0a 20 20 20 20 62 75 69 6c 74 2d 69 6e buffer..As.with.the.....built-in
1eae0 20 60 6f 63 63 75 72 27 20 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 75 73 65 20 74 68 61 74 20 62 75 .`occur'.command.you.use.that.bu
1eb00 66 66 65 72 20 74 6f 20 6a 75 6d 70 20 74 6f 20 61 20 6d 61 74 63 68 20 61 6e 64 0a 20 20 20 20 ffer.to.jump.to.a.match.and.....
1eb20 61 66 74 65 72 20 74 68 61 74 2c 20 79 6f 75 20 63 61 6e 20 74 68 65 6e 20 75 73 65 20 60 6e 65 after.that,.you.can.then.use.`ne
1eb40 78 74 2d 65 72 72 6f 72 27 20 61 6e 64 20 60 70 72 65 76 69 6f 75 73 2d 65 72 72 6f 72 27 20 74 xt-error'.and.`previous-error'.t
1eb60 6f 0a 20 20 20 20 6e 61 76 69 67 61 74 65 20 74 6f 20 6f 74 68 65 72 20 6d 61 74 63 68 65 73 2e o.....navigate.to.other.matches.
1eb80 20 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 70 72 65 73 73 20 60 65 27 20 74 6f 20 61 63 74 69 76 .You.can.also.press.`e'.to.activ
1eba0 61 74 65 0a 20 20 20 20 60 6f 63 63 75 72 2d 65 64 69 74 2d 6d 6f 64 65 27 20 61 6e 64 20 65 64 ate.....`occur-edit-mode'.and.ed
1ebc0 69 74 20 74 68 65 20 6d 61 74 63 68 65 73 20 69 6e 20 70 6c 61 63 65 21 0a 0a 20 20 e2 80 a2 20 it.the.matches.in.place!........
1ebe0 59 6f 75 20 63 61 6e 20 65 78 70 6f 72 74 20 66 72 6f 6d 20 61 6e 79 20 6f 66 20 74 68 65 20 43 You.can.export.from.any.of.the.C
1ec00 6f 6e 73 75 6c 74 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 onsult.asynchronous.search.comma
1ec20 6e 64 73 2c 0a 20 20 20 20 60 63 6f 6e 73 75 6c 74 2d 67 72 65 70 27 2c 20 60 63 6f 6e 73 75 6c nds,.....`consult-grep',.`consul
1ec40 74 2d 67 69 74 2d 67 72 65 70 27 2c 20 6f 72 20 60 63 6f 6e 73 75 6c 74 2d 72 69 70 67 72 65 70 t-git-grep',.or.`consult-ripgrep
1ec60 27 20 74 6f 20 67 65 74 20 61 0a 20 20 20 20 60 67 72 65 70 2d 6d 6f 64 65 27 20 62 75 66 66 65 '.to.get.a.....`grep-mode'.buffe
1ec80 72 2e 20 48 65 72 65 20 74 6f 6f 20 79 6f 75 20 63 61 6e 20 75 73 65 20 60 6e 65 78 74 2d 65 72 r..Here.too.you.can.use.`next-er
1eca0 72 6f 72 27 20 61 6e 64 0a 20 20 20 20 60 70 72 65 76 69 6f 75 73 2d 65 72 72 6f 72 27 20 74 6f ror'.and.....`previous-error'.to
1ecc0 20 6e 61 76 69 67 61 74 65 20 61 6d 6f 6e 67 20 6d 61 74 63 68 65 73 2c 20 61 6e 64 2c 20 69 66 .navigate.among.matches,.and,.if
1ece0 20 79 6f 75 20 69 6e 73 74 61 6c 6c 20 74 68 65 0a 20 20 20 20 5b 77 67 72 65 70 5d 20 70 61 63 .you.install.the.....[wgrep].pac
1ed00 6b 61 67 65 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 69 74 20 74 6f 20 65 64 69 74 20 74 68 65 kage,.you.can.use.it.to.edit.the
1ed20 20 6d 61 74 63 68 65 73 20 69 6e 20 70 6c 61 63 65 2e 0a 0a 20 20 49 6e 20 62 6f 74 68 20 63 61 .matches.in.place.....In.both.ca
1ed40 73 65 73 2c 20 70 72 65 73 73 69 6e 67 20 60 67 27 20 77 69 6c 6c 20 72 65 72 75 6e 20 74 68 65 ses,.pressing.`g'.will.rerun.the
1ed60 20 43 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 68 61 64 0a 20 20 65 78 70 6f 72 .Consult.command.you.had...expor
1ed80 74 65 64 20 66 72 6f 6d 20 61 6e 64 20 72 65 2d 65 6e 74 65 72 20 74 68 65 20 69 6e 70 75 74 20 ted.from.and.re-enter.the.input.
1eda0 79 6f 75 20 68 61 64 20 74 79 70 65 64 20 28 77 68 69 63 68 20 69 73 20 73 69 6d 69 6c 61 72 0a you.had.typed.(which.is.similar.
1edc0 20 20 74 6f 20 72 65 76 65 72 74 69 6e 67 20 62 75 74 20 61 20 6c 69 74 74 6c 65 20 6d 6f 72 65 ..to.reverting.but.a.little.more
1ede0 20 66 6c 65 78 69 62 6c 65 29 2e 20 59 6f 75 20 63 61 6e 20 74 68 65 6e 20 70 72 6f 63 65 65 64 .flexible)..You.can.then.proceed
1ee00 20 74 6f 0a 20 20 72 65 2d 65 78 70 6f 72 74 20 69 66 20 74 68 61 74 27 73 20 77 68 61 74 20 79 .to...re-export.if.that's.what.y
1ee20 6f 75 20 77 61 6e 74 2c 20 62 75 74 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 74 ou.want,.but.you.can.also.edit.t
1ee40 68 65 20 69 6e 70 75 74 0a 20 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 73 65 61 72 63 68 20 74 he.input...changing.the.search.t
1ee60 65 72 6d 73 20 6f 72 20 73 69 6d 70 6c 79 20 63 61 6e 63 65 6c 20 69 66 20 79 6f 75 20 73 65 65 erms.or.simply.cancel.if.you.see
1ee80 20 79 6f 75 20 61 72 65 20 64 6f 6e 65 0a 20 20 77 69 74 68 20 74 68 61 74 20 73 65 61 72 63 68 .you.are.done...with.that.search
1eea0 2e 0a 0a 20 20 54 68 65 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 20 61 6c 73 6f 20 63 .....The.`embark-consult'.also.c
1eec0 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 63 61 6e 64 69 64 61 74 65 73 20 63 6f 6c 6c 65 63 74 6f ontains.some.candidates.collecto
1eee0 72 73 20 74 68 61 74 0a 20 20 61 6c 6c 6f 77 20 79 6f 75 20 74 6f 20 72 75 6e 20 60 65 6d 62 61 rs.that...allow.you.to.run.`emba
1ef00 72 6b 2d 6c 69 76 65 27 20 74 6f 20 67 65 74 20 61 20 6c 69 76 65 2d 75 70 64 61 74 69 6e 67 20 rk-live'.to.get.a.live-updating.
1ef20 74 61 62 6c 65 20 6f 66 0a 20 20 63 6f 6e 74 65 6e 74 73 20 66 6f 72 20 79 6f 75 72 20 62 75 66 table.of...contents.for.your.buf
1ef40 66 65 72 3a 0a 0a 20 20 e2 80 a2 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c fer:........`embark-consult-outl
1ef60 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 27 20 70 72 6f 64 75 63 65 73 20 74 68 65 20 6f 75 74 ine-candidates'.produces.the.out
1ef80 6c 69 6e 65 20 68 65 61 64 69 6e 67 73 20 6f 66 0a 20 20 20 20 74 68 65 20 63 75 72 72 65 6e 74 line.headings.of.....the.current
1efa0 20 62 75 66 66 65 72 2c 20 75 73 69 6e 67 20 60 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 27 .buffer,.using.`consult-outline'
1efc0 2e 0a 20 20 e2 80 a2 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 63 61 ........`embark-consult-imenu-ca
1efe0 6e 64 69 64 61 74 65 73 27 20 70 72 6f 64 75 63 65 73 20 74 68 65 20 69 6d 65 6e 75 20 69 74 65 ndidates'.produces.the.imenu.ite
1f000 6d 73 20 6f 66 20 74 68 65 0a 20 20 20 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2c 20 75 73 ms.of.the.....current.buffer,.us
1f020 69 6e 67 20 60 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 27 2e 0a 20 20 e2 80 a2 20 60 65 6d 62 61 ing.`consult-imenu'........`emba
1f040 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 6f 72 2d 6f 75 74 6c 69 6e 65 2d 63 61 6e 64 rk-consult-imenu-or-outline-cand
1f060 69 64 61 74 65 73 27 20 69 73 20 61 20 73 69 6d 70 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 0a idates'.is.a.simple.combination.
1f080 20 20 20 20 6f 66 20 74 68 65 20 74 77 6f 20 70 72 65 76 69 6f 75 73 20 66 75 6e 63 74 69 6f 6e ....of.the.two.previous.function
1f0a0 73 3a 20 69 74 20 70 72 6f 64 75 63 65 73 20 69 6d 65 6e 75 20 69 74 65 6d 73 20 69 6e 20 62 75 s:.it.produces.imenu.items.in.bu
1f0c0 66 66 65 72 73 0a 20 20 20 20 64 65 72 69 76 69 6e 67 20 66 72 6f 6d 20 60 70 72 6f 67 2d 6d 6f ffers.....deriving.from.`prog-mo
1f0e0 64 65 27 20 61 6e 64 20 6f 74 68 65 72 77 69 73 65 20 6f 75 74 6c 69 6e 65 20 68 65 61 64 69 6e de'.and.otherwise.outline.headin
1f100 67 73 2e 0a 0a 20 20 54 68 65 20 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 60 65 6d 62 gs.....The.way.to.configure.`emb
1f120 61 72 6b 2d 6c 69 76 65 27 20 28 6f 72 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 27 20 61 ark-live'.(or.`embark-collect'.a
1f140 6e 64 0a 20 20 60 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 27 20 66 6f 72 20 74 68 61 74 20 6d 61 nd...`embark-export'.for.that.ma
1f160 74 74 65 72 29 20 74 6f 20 75 73 65 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 66 75 6e 63 74 69 tter).to.use.one.of.these.functi
1f180 6f 6e 20 69 73 20 74 6f 0a 20 20 61 64 64 20 69 74 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 on.is.to...add.it.at.the.end.of.
1f1a0 74 68 65 20 60 65 6d 62 61 72 6b 2d 63 61 6e 64 69 64 61 74 65 2d 63 6f 6c 6c 65 63 74 6f 72 73 the.`embark-candidate-collectors
1f1c0 27 20 6c 69 73 74 2e 20 54 68 65 0a 20 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 20 70 '.list..The...`embark-consult'.p
1f1e0 61 63 6b 61 67 65 20 62 79 20 64 65 66 61 75 6c 74 20 61 64 64 73 20 74 68 65 20 6c 61 73 74 20 ackage.by.default.adds.the.last.
1f200 6f 6e 65 2c 20 77 68 69 63 68 20 73 65 65 6d 73 20 74 6f 0a 20 20 62 65 20 74 68 65 20 6d 6f 73 one,.which.seems.to...be.the.mos
1f220 74 20 73 65 6e 73 69 62 6c 65 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 42 65 73 69 64 65 73 20 74 t.sensible.default.....Besides.t
1f240 68 6f 73 65 20 65 78 70 6f 72 74 65 72 73 20 61 6e 64 20 63 61 6e 64 69 64 61 74 65 20 63 6f 6c hose.exporters.and.candidate.col
1f260 6c 65 63 74 6f 72 73 2c 20 74 68 65 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 27 0a 20 20 lectors,.the.`embark-consult'...
1f280 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64 65 73 20 6d 61 6e 79 20 73 75 62 74 6c 65 20 74 77 65 package.provides.many.subtle.twe
1f2a0 61 6b 73 20 61 6e 64 20 73 6d 61 6c 6c 20 69 6e 74 65 67 72 61 74 69 6f 6e 73 20 62 65 74 77 65 aks.and.small.integrations.betwe
1f2c0 65 6e 0a 20 20 45 6d 62 61 72 6b 20 61 6e 64 20 43 6f 6e 73 75 6c 74 2e 20 53 6f 6d 65 20 65 78 en...Embark.and.Consult..Some.ex
1f2e0 61 6d 70 6c 65 73 20 61 72 65 3a 0a 0a 20 20 e2 80 a2 20 57 68 65 6e 20 75 73 65 64 20 61 73 20 amples.are:........When.used.as.
1f300 61 63 74 69 6f 6e 73 2c 20 74 68 65 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 73 65 61 72 63 68 actions,.the.asynchronous.search
1f320 20 63 6f 6d 6d 61 6e 64 73 20 77 69 6c 6c 20 73 65 61 72 63 68 0a 20 20 20 20 6f 6e 6c 79 20 74 .commands.will.search.....only.t
1f340 68 65 20 66 69 6c 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 74 68 65 20 74 61 72 67 65 he.files.associated.to.the.targe
1f360 74 73 3a 20 69 66 20 74 68 65 20 74 61 72 67 65 74 73 20 2f 61 72 65 2f 0a 20 20 20 20 66 69 6c ts:.if.the.targets./are/.....fil
1f380 65 73 2c 20 69 74 20 73 65 61 72 63 68 65 73 20 74 68 6f 73 65 20 66 69 6c 65 73 3b 20 66 6f 72 es,.it.searches.those.files;.for
1f3a0 20 62 75 66 66 65 72 73 20 69 74 20 77 69 6c 6c 20 73 65 61 72 63 68 20 65 69 74 68 65 72 0a 20 .buffers.it.will.search.either..
1f3c0 20 20 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 20 69 66 20 74 68 65 72 65 20 ...the.associated.file.if.there.
1f3e0 69 73 20 6f 6e 65 2c 20 65 6c 73 65 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 62 75 is.one,.else.all.files.in.the.bu
1f400 66 66 65 72 27 73 0a 20 20 20 20 60 64 65 66 61 75 6c 74 2d 64 69 72 65 63 74 6f 72 79 27 3b 20 ffer's.....`default-directory';.
1f420 66 6f 72 20 62 6f 6f 6b 6d 61 72 6b 73 20 69 74 20 77 69 6c 6c 20 73 65 61 72 63 68 20 74 68 65 for.bookmarks.it.will.search.the
1f440 20 66 69 6c 65 20 74 68 65 79 0a 20 20 20 20 70 6f 69 6e 74 20 74 6f 2c 20 73 61 6d 65 20 66 6f .file.they.....point.to,.same.fo
1f460 72 20 45 6d 61 63 73 20 4c 69 73 70 20 6c 69 62 72 61 72 69 65 73 2e 20 54 68 69 73 20 69 73 20 r.Emacs.Lisp.libraries..This.is.
1f480 70 61 72 74 69 63 75 6c 61 72 6c 79 0a 20 20 20 20 70 6f 77 65 72 66 75 6c 20 77 68 65 6e 20 75 particularly.....powerful.when.u
1f4a0 73 69 6e 67 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 20 74 6f 20 61 63 74 20 6f 6e 20 sing.`embark-act-all'.to.act.on.
1f4c0 6d 75 6c 74 69 70 6c 65 20 66 69 6c 65 73 20 61 74 0a 20 20 20 20 6f 6e 63 65 2c 20 66 6f 72 20 multiple.files.at.....once,.for.
1f4e0 65 78 61 6d 70 6c 65 20 79 6f 75 20 63 61 6e 20 75 73 65 20 60 63 6f 6e 73 75 6c 74 2d 66 69 6e example.you.can.use.`consult-fin
1f500 64 27 20 74 6f 20 73 65 61 72 63 68 20 61 6d 6f 6e 67 20 66 69 6c 65 0a 20 20 20 20 2f 6e 61 6d d'.to.search.among.file...../nam
1f520 65 73 2f 20 61 6e 64 20 74 68 65 6e 20 60 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 27 20 61 6e es/.and.then.`embark-act-all'.an
1f540 64 20 60 63 6f 6e 73 75 6c 74 2d 67 72 65 70 27 20 74 6f 20 73 65 61 72 63 68 0a 20 20 20 20 77 d.`consult-grep'.to.search.....w
1f560 69 74 68 69 6e 20 74 68 65 20 6d 61 74 63 68 69 6e 67 20 66 69 6c 65 73 2e 0a 0a 20 20 20 20 e2 ithin.the.matching.files........
1f580 80 a2 20 46 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 74 61 72 67 65 74 20 74 79 70 65 73 2c 20 74 ...For.all.other.target.types,.t
1f5a0 68 6f 73 65 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 73 65 6e 73 69 62 6c 65 hose.that.do.not.have.a.sensible
1f5c0 0a 20 20 20 20 20 20 6e 6f 74 69 6f 6e 20 6f 66 20 61 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 .......notion.of.associated.file
1f5e0 2c 20 61 20 43 6f 6e 73 75 6c 74 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 20 28 61 73 79 6e ,.a.Consult.search.command.(asyn
1f600 63 68 72 6f 6e 6f 75 73 0a 20 20 20 20 20 20 6f 72 20 6e 6f 74 29 20 77 69 6c 6c 20 73 65 61 72 chronous.......or.not).will.sear
1f620 63 68 20 66 6f 72 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 20 62 75 ch.for.the.text.of.the.target.bu
1f640 74 20 6c 65 61 76 65 20 74 68 65 0a 20 20 20 20 20 20 6d 69 6e 69 62 75 66 66 65 72 20 6f 70 65 t.leave.the.......minibuffer.ope
1f660 6e 20 73 6f 20 79 6f 75 20 63 61 6e 20 69 6e 74 65 72 61 63 74 20 77 69 74 68 20 74 68 65 20 43 n.so.you.can.interact.with.the.C
1f680 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 e2 80 a2 20 60 63 6f 6e 73 75 6c 74 2d onsult.command.........`consult-
1f6a0 69 6d 65 6e 75 27 20 77 69 6c 6c 20 73 65 61 72 63 68 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 imenu'.will.search.for.the.targe
1f6c0 74 20 61 6e 64 20 74 61 6b 65 20 79 6f 75 20 64 69 72 65 63 74 6c 79 20 74 6f 0a 20 20 20 20 74 t.and.take.you.directly.to.....t
1f6e0 68 65 20 6c 6f 63 61 74 69 6f 6e 20 69 66 20 69 74 20 6d 61 74 63 68 65 73 20 61 20 75 6e 69 71 he.location.if.it.matches.a.uniq
1f700 75 65 20 69 6d 65 6e 75 20 65 6e 74 72 79 2c 20 6f 74 68 65 72 77 69 73 65 20 69 74 20 77 69 6c ue.imenu.entry,.otherwise.it.wil
1f720 6c 0a 20 20 20 20 6c 65 61 76 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 6f 70 65 6e 20 l.....leave.the.minibuffer.open.
1f740 73 6f 20 79 6f 75 20 63 61 6e 20 6e 61 76 69 67 61 74 65 20 61 6d 6f 6e 67 20 74 68 65 20 6d 61 so.you.can.navigate.among.the.ma
1f760 74 63 68 65 73 2e 0a 0a 0a 5b 77 67 72 65 70 5d 20 3c 68 74 74 70 3a 2f 2f 67 69 74 68 75 62 2e tches....[wgrep].<http://github.
1f780 63 6f 6d 2f 6d 68 61 79 61 73 68 69 31 31 32 30 2f 45 6d 61 63 73 2d 77 67 72 65 70 2f 72 61 77 com/mhayashi1120/Emacs-wgrep/raw
1f7a0 2f 6d 61 73 74 65 72 2f 77 67 72 65 70 2e 65 6c 0a 3e 0a 0a 0a 36 20 52 65 6c 61 74 65 64 20 50 /master/wgrep.el.>...6.Related.P
1f7c0 61 63 6b 61 67 65 73 0a e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 ackages.........................
1f7e0 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 0a 0a ................................
1f800 20 20 54 68 65 72 65 20 61 72 65 20 73 65 76 65 72 61 6c 20 70 61 63 6b 61 67 65 73 20 74 68 61 ..There.are.several.packages.tha
1f820 74 20 6f 66 66 65 72 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 73 69 6d 69 6c 61 72 20 74 6f t.offer.functionality.similar.to
1f840 0a 20 20 45 6d 62 61 72 6b 27 73 2e 0a 0a 20 20 41 63 74 69 6e 67 20 6f 6e 20 6d 69 6e 69 62 75 ...Embark's.....Acting.on.minibu
1f860 66 66 65 72 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 0a 20 20 20 20 20 ffer.completion.candidates......
1f880 20 20 20 54 68 65 20 70 6f 70 75 6c 61 72 20 49 76 79 20 61 6e 64 20 48 65 6c 6d 20 70 61 63 6b ...The.popular.Ivy.and.Helm.pack
1f8a0 61 67 65 73 20 68 61 76 65 20 73 75 70 70 6f 72 74 20 66 6f 72 20 61 63 74 69 6e 67 20 6f 6e 20 ages.have.support.for.acting.on.
1f8c0 74 68 65 0a 20 20 20 20 20 20 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 the.........completion.candidate
1f8e0 73 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 77 72 69 74 74 65 6e 20 75 73 69 6e 67 20 74 68 65 69 s.of.commands.written.using.thei
1f900 72 20 41 50 49 73 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 74 68 65 72 65 20 69 73 20 61 6e 20 r.APIs,.and.........there.is.an.
1f920 65 78 74 65 6e 73 69 76 65 20 65 63 6f 73 79 73 74 65 6d 20 6f 66 20 70 61 63 6b 61 67 65 73 20 extensive.ecosystem.of.packages.
1f940 6d 65 61 6e 74 20 66 6f 72 20 48 65 6c 6d 20 61 6e 64 0a 20 20 20 20 20 20 20 20 66 6f 72 20 49 meant.for.Helm.and.........for.I
1f960 76 79 20 28 74 68 65 20 49 76 79 20 6f 6e 65 73 20 75 73 75 61 6c 6c 79 20 68 61 76 65 20 22 63 vy.(the.Ivy.ones.usually.have."c
1f980 6f 75 6e 73 65 6c 22 20 69 6e 20 74 68 65 20 6e 61 6d 65 29 0a 20 20 20 20 20 20 20 20 70 72 6f ounsel".in.the.name).........pro
1f9a0 76 69 64 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 61 70 70 72 6f 70 72 69 61 74 65 20 viding.commands.and.appropriate.
1f9c0 61 63 74 69 6f 6e 73 2e 0a 20 20 41 63 74 69 6e 67 20 6f 6e 20 74 68 69 6e 67 73 20 61 74 20 70 actions....Acting.on.things.at.p
1f9e0 6f 69 6e 74 0a 20 20 20 20 20 20 20 20 54 68 65 20 62 75 69 6c 74 2d 69 6e 20 60 63 6f 6e 74 65 oint.........The.built-in.`conte
1fa00 78 74 2d 6d 65 6e 75 2d 6d 6f 64 65 27 20 70 72 6f 76 69 64 65 73 20 61 20 6d 6f 75 73 65 2d 64 xt-menu-mode'.provides.a.mouse-d
1fa20 72 69 76 65 6e 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 65 78 74 2d 73 65 6e 73 69 74 69 76 65 20 riven.........context-sensitive.
1fa40 63 6f 6e 66 69 67 75 72 61 62 6c 65 20 6d 65 6e 75 2e 20 54 68 65 20 60 64 6f 2d 61 74 2d 70 6f configurable.menu..The.`do-at-po
1fa60 69 6e 74 27 20 70 61 63 6b 61 67 65 0a 20 20 20 20 20 20 20 20 62 79 20 50 68 69 6c 69 70 20 4b int'.package.........by.Philip.K
1fa80 61 6c 75 64 65 72 63 69 63 20 28 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 47 4e 55 20 45 4c 50 41 aludercic.(available.on.GNU.ELPA
1faa0 29 2c 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 0a 20 20 20 20 20 20 20 20 69 73 20 ),.on.the.other.hand.........is.
1fac0 6b 65 79 62 6f 61 72 64 2d 64 72 69 76 65 6e 2e 0a 20 20 43 6f 6c 6c 65 63 74 69 6e 67 20 63 6f keyboard-driven....Collecting.co
1fae0 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 69 6e 74 6f 20 61 20 62 75 66 66 65 mpletion.candidates.into.a.buffe
1fb00 72 0a 20 20 20 20 20 20 20 20 54 68 65 20 49 76 79 20 70 61 63 6b 61 67 65 20 68 61 73 20 74 68 r.........The.Ivy.package.has.th
1fb20 65 20 63 6f 6d 6d 61 6e 64 20 60 69 76 79 2d 6f 63 63 75 72 27 20 77 68 69 63 68 20 69 73 20 73 e.command.`ivy-occur'.which.is.s
1fb40 69 6d 69 6c 61 72 20 74 6f 0a 20 20 20 20 20 20 20 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 imilar.to.........`embark-collec
1fb60 74 27 2e 20 41 73 20 77 69 74 68 20 49 76 79 20 61 63 74 69 6f 6e 73 2c 20 60 69 76 79 2d 6f 63 t'..As.with.Ivy.actions,.`ivy-oc
1fb80 63 75 72 27 20 6f 6e 6c 79 20 77 6f 72 6b 73 0a 20 20 20 20 20 20 20 20 66 6f 72 20 63 6f 6d 6d cur'.only.works.........for.comm
1fba0 61 6e 64 73 20 77 72 69 74 74 65 6e 20 75 73 69 6e 67 20 74 68 65 20 49 76 79 20 41 50 49 2e 0a ands.written.using.the.Ivy.API..
1fbc0 0a 0a 37 20 52 65 73 6f 75 72 63 65 73 0a e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 ..7.Resources...................
1fbe0 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 0a 0a 20 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 ...................If.you.want.t
1fc00 6f 20 6c 65 61 72 6e 20 6d 6f 72 65 20 61 62 6f 75 74 20 68 6f 77 20 6f 74 68 65 72 73 20 68 61 o.learn.more.about.how.others.ha
1fc20 76 65 20 75 73 65 64 20 45 6d 62 61 72 6b 20 68 65 72 65 20 61 72 65 0a 20 20 73 6f 6d 65 20 6c ve.used.Embark.here.are...some.l
1fc40 69 6e 6b 73 20 74 6f 20 72 65 61 64 3a 0a 0a 20 20 e2 80 a2 20 5b 46 69 66 74 65 65 6e 20 77 61 inks.to.read:........[Fifteen.wa
1fc60 79 73 20 74 6f 20 75 73 65 20 45 6d 62 61 72 6b 5d 2c 20 61 20 62 6c 6f 67 20 70 6f 73 74 20 62 ys.to.use.Embark],.a.blog.post.b
1fc80 79 20 4b 61 72 74 68 69 6b 20 43 68 69 6b 6d 61 67 61 6c 75 72 2e 0a 20 20 e2 80 a2 20 5b 50 72 y.Karthik.Chikmagalur........[Pr
1fca0 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 27 73 20 64 6f 74 65 6d 61 63 73 5d 2c 20 6c otesilaos.Stavrou's.dotemacs],.l
1fcc0 6f 6f 6b 20 66 6f 72 20 74 68 65 20 73 65 63 74 69 6f 6e 20 63 61 6c 6c 65 64 0a 20 20 20 20 22 ook.for.the.section.called....."
1fce0 45 78 74 65 6e 64 65 64 20 6d 69 6e 69 62 75 66 66 65 72 20 61 63 74 69 6f 6e 73 20 61 6e 64 20 Extended.minibuffer.actions.and.
1fd00 6d 6f 72 65 20 28 65 6d 62 61 72 6b 2e 65 6c 20 61 6e 64 0a 20 20 20 20 70 72 6f 74 2d 65 6d 62 more.(embark.el.and.....prot-emb
1fd20 61 72 6b 2e 65 6c 29 22 0a 0a 20 20 41 6e 64 20 73 6f 6d 65 20 76 69 64 65 6f 73 20 74 6f 20 77 ark.el)"....And.some.videos.to.w
1fd40 61 74 63 68 3a 0a 0a 20 20 e2 80 a2 20 5b 45 6d 62 61 72 6b 20 61 6e 64 20 6d 79 20 65 78 74 72 atch:........[Embark.and.my.extr
1fd60 61 73 5d 20 62 79 20 50 72 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 2e 0a 20 20 e2 80 as].by.Protesilaos.Stavrou......
1fd80 a2 20 5b 45 6d 62 61 72 6b 20 e2 80 93 20 4b 65 79 20 66 65 61 74 75 72 65 73 20 61 6e 64 20 74 ..[Embark.....Key.features.and.t
1fda0 77 65 61 6b 73 5d 20 62 79 20 52 61 6f 75 6c 20 43 6f 6d 6e 69 6e 6f 73 20 6f 6e 20 74 68 65 0a weaks].by.Raoul.Comninos.on.the.
1fdc0 20 20 20 20 45 6d 61 63 73 2d 45 6c 65 6d 65 6e 74 73 20 59 6f 75 54 75 62 65 20 63 68 61 6e 6e ....Emacs-Elements.YouTube.chann
1fde0 65 6c 2e 0a 20 20 e2 80 a2 20 5b 4c 69 76 65 73 74 72 65 61 6d 65 64 3a 20 41 64 64 69 6e 67 20 el........[Livestreamed:.Adding.
1fe00 61 6e 20 45 6d 62 61 72 6b 20 63 6f 6e 74 65 78 74 20 61 63 74 69 6f 6e 20 74 6f 20 73 65 6e 64 an.Embark.context.action.to.send
1fe20 20 61 20 73 74 72 65 61 6d 0a 20 20 20 20 6d 65 73 73 61 67 65 5d 20 62 79 20 53 61 63 68 61 20 .a.stream.....message].by.Sacha.
1fe40 43 68 75 61 2e 0a 20 20 e2 80 a2 20 5b 53 79 73 74 65 6d 20 43 72 61 66 74 65 72 73 20 4c 69 76 Chua........[System.Crafters.Liv
1fe60 65 21 20 2d 20 54 68 65 20 4d 61 6e 79 20 55 73 65 73 20 6f 66 20 45 6d 62 61 72 6b 5d 20 62 79 e!.-.The.Many.Uses.of.Embark].by
1fe80 20 44 61 76 69 64 20 57 69 6c 73 6f 6e 2e 0a 20 20 e2 80 a2 20 5b 55 73 69 6e 67 20 45 6d 61 63 .David.Wilson........[Using.Emac
1fea0 73 20 45 70 69 73 6f 64 65 20 38 30 20 2d 20 56 65 72 74 69 63 6f 2c 20 4d 61 72 67 69 6e 61 6c s.Episode.80.-.Vertico,.Marginal
1fec0 69 61 2c 20 43 6f 6e 73 75 6c 74 20 61 6e 64 20 45 6d 62 61 72 6b 5d 0a 20 20 20 20 62 79 20 4d ia,.Consult.and.Embark].....by.M
1fee0 69 6b 65 20 5a 61 6d 61 6e 73 6b 79 2e 0a 0a 0a 5b 46 69 66 74 65 65 6e 20 77 61 79 73 20 74 6f ike.Zamansky....[Fifteen.ways.to
1ff00 20 75 73 65 20 45 6d 62 61 72 6b 5d 0a 3c 68 74 74 70 73 3a 2f 2f 6b 61 72 74 68 69 6e 6b 73 2e .use.Embark].<https://karthinks.
1ff20 63 6f 6d 2f 73 6f 66 74 77 61 72 65 2f 66 69 66 74 65 65 6e 2d 77 61 79 73 2d 74 6f 2d 75 73 65 com/software/fifteen-ways-to-use
1ff40 2d 65 6d 62 61 72 6b 2f 3e 0a 0a 5b 50 72 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 27 -embark/>..[Protesilaos.Stavrou'
1ff60 73 20 64 6f 74 65 6d 61 63 73 5d 20 3c 68 74 74 70 73 3a 2f 2f 70 72 6f 74 65 73 69 6c 61 6f 73 s.dotemacs].<https://protesilaos
1ff80 2e 63 6f 6d 2f 64 6f 74 65 6d 61 63 73 2f 3e 0a 0a 5b 45 6d 62 61 72 6b 20 61 6e 64 20 6d 79 20 .com/dotemacs/>..[Embark.and.my.
1ffa0 65 78 74 72 61 73 5d 0a 3c 68 74 74 70 73 3a 2f 2f 70 72 6f 74 65 73 69 6c 61 6f 73 2e 63 6f 6d extras].<https://protesilaos.com
1ffc0 2f 63 6f 64 65 6c 6f 67 2f 32 30 32 31 2d 30 31 2d 30 39 2d 65 6d 61 63 73 2d 65 6d 62 61 72 6b /codelog/2021-01-09-emacs-embark
1ffe0 2d 65 78 74 72 61 73 2f 3e 0a 0a 5b 45 6d 62 61 72 6b 20 e2 80 93 20 4b 65 79 20 66 65 61 74 75 -extras/>..[Embark.....Key.featu
20000 72 65 73 20 61 6e 64 20 74 77 65 61 6b 73 5d 20 3c 68 74 74 70 73 3a 2f 2f 79 6f 75 74 75 2e 62 res.and.tweaks].<https://youtu.b
20020 65 2f 71 70 6f 51 69 69 69 6e 43 74 59 3e 0a 0a 5b 4c 69 76 65 73 74 72 65 61 6d 65 64 3a 20 41 e/qpoQiiinCtY>..[Livestreamed:.A
20040 64 64 69 6e 67 20 61 6e 20 45 6d 62 61 72 6b 20 63 6f 6e 74 65 78 74 20 61 63 74 69 6f 6e 20 74 dding.an.Embark.context.action.t
20060 6f 20 73 65 6e 64 20 61 20 73 74 72 65 61 6d 20 6d 65 73 73 61 67 65 5d 0a 3c 68 74 74 70 73 3a o.send.a.stream.message].<https:
20080 2f 2f 79 6f 75 74 75 2e 62 65 2f 57 73 78 58 72 31 6e 63 75 6b 59 3e 0a 0a 5b 53 79 73 74 65 6d //youtu.be/WsxXr1ncukY>..[System
200a0 20 43 72 61 66 74 65 72 73 20 4c 69 76 65 21 20 2d 20 54 68 65 20 4d 61 6e 79 20 55 73 65 73 20 .Crafters.Live!.-.The.Many.Uses.
200c0 6f 66 20 45 6d 62 61 72 6b 5d 0a 3c 68 74 74 70 73 3a 2f 2f 79 6f 75 74 75 2e 62 65 2f 71 6b 32 of.Embark].<https://youtu.be/qk2
200e0 49 73 5f 73 43 38 4c 6b 3e 0a 0a 5b 55 73 69 6e 67 20 45 6d 61 63 73 20 45 70 69 73 6f 64 65 20 Is_sC8Lk>..[Using.Emacs.Episode.
20100 38 30 20 2d 20 56 65 72 74 69 63 6f 2c 20 4d 61 72 67 69 6e 61 6c 69 61 2c 20 43 6f 6e 73 75 6c 80.-.Vertico,.Marginalia,.Consul
20120 74 20 61 6e 64 20 45 6d 62 61 72 6b 5d 0a 3c 68 74 74 70 73 3a 2f 2f 79 6f 75 74 75 2e 62 65 2f t.and.Embark].<https://youtu.be/
20140 35 66 66 62 32 61 74 32 64 37 77 3e 0a 0a 0a 38 20 43 6f 6e 74 72 69 62 75 74 69 6f 6e 73 0a e2 5ffb2at2d7w>...8.Contributions..
20160 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 ................................
20180 e2 95 90 e2 95 90 e2 95 90 e2 95 90 0a 0a 20 20 43 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 74 6f ................Contributions.to
201a0 20 45 6d 62 61 72 6b 20 61 72 65 20 76 65 72 79 20 77 65 6c 63 6f 6d 65 2e 20 54 68 65 72 65 20 .Embark.are.very.welcome..There.
201c0 69 73 20 61 20 5b 77 69 73 68 20 6c 69 73 74 5d 20 66 6f 72 0a 20 20 61 63 74 69 6f 6e 73 2c 20 is.a.[wish.list].for...actions,.
201e0 74 61 72 67 65 74 20 66 69 6e 64 65 72 73 2c 20 63 61 6e 64 69 64 61 74 65 20 63 6f 6c 6c 65 63 target.finders,.candidate.collec
20200 74 6f 72 73 20 61 6e 64 20 65 78 70 6f 72 74 65 72 73 2e 20 46 6f 72 20 6f 74 68 65 72 0a 20 20 tors.and.exporters..For.other...
20220 69 64 65 61 73 20 79 6f 75 20 68 61 76 65 20 66 6f 72 20 45 6d 62 61 72 6b 2c 20 66 65 65 6c 20 ideas.you.have.for.Embark,.feel.
20240 66 72 65 65 20 74 6f 20 6f 70 65 6e 20 61 6e 20 69 73 73 75 65 20 6f 6e 20 74 68 65 20 5b 69 73 free.to.open.an.issue.on.the.[is
20260 73 75 65 0a 20 20 74 72 61 63 6b 65 72 5d 2e 20 41 6e 79 20 6e 65 61 74 20 63 6f 6e 66 69 67 75 sue...tracker]..Any.neat.configu
20280 72 61 74 69 6f 6e 20 74 72 69 63 6b 73 20 79 6f 75 20 66 69 6e 64 20 6d 69 67 68 74 20 62 65 20 ration.tricks.you.find.might.be.
202a0 61 20 67 6f 6f 64 20 66 69 74 0a 20 20 66 6f 72 20 74 68 65 20 5b 77 69 6b 69 5d 2e 0a 0a 20 20 a.good.fit...for.the.[wiki].....
202c0 43 6f 64 65 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 61 72 65 20 76 65 72 79 20 77 65 6c 63 Code.contributions.are.very.welc
202e0 6f 6d 65 20 74 6f 6f 2c 20 62 75 74 20 73 69 6e 63 65 20 45 6d 62 61 72 6b 20 69 73 20 6e 6f 77 ome.too,.but.since.Embark.is.now
20300 20 6f 6e 0a 20 20 47 4e 55 20 45 4c 50 41 2c 20 63 6f 70 79 72 69 67 68 74 20 61 73 73 69 67 6e .on...GNU.ELPA,.copyright.assign
20320 6d 65 6e 74 20 74 6f 20 74 68 65 20 46 53 46 20 69 73 20 72 65 71 75 69 72 65 64 20 62 65 66 6f ment.to.the.FSF.is.required.befo
20340 72 65 20 79 6f 75 20 63 61 6e 0a 20 20 63 6f 6e 74 72 69 62 75 74 65 20 63 6f 64 65 2e 0a 0a 0a re.you.can...contribute.code....
20360 5b 77 69 73 68 20 6c 69 73 74 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f [wish.list].<https://github.com/
20380 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 69 73 73 75 65 73 2f 39 35 3e 0a 0a 5b 69 73 73 oantolin/embark/issues/95>..[iss
203a0 75 65 20 74 72 61 63 6b 65 72 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f ue.tracker].<https://github.com/
203c0 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 2f 69 73 73 75 65 73 3e 0a 0a 5b 77 69 6b 69 5d 20 oantolin/embark/issues>..[wiki].
203e0 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 <https://github.com/oantolin/emb
20400 61 72 6b 2f 77 69 6b 69 3e 0a 0a 0a 39 20 41 63 6b 6e 6f 77 6c 65 64 67 6d 65 6e 74 73 0a e2 95 ark/wiki>...9.Acknowledgments...
20420 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 ................................
20440 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 e2 95 90 0a 0a 20 20 57 68 69 6c 65 20 49 2c 20 4f 6d .....................While.I,.Om
20460 61 72 20 41 6e 74 6f 6c c3 ad 6e 20 43 61 6d 61 72 65 6e 61 2c 20 68 61 76 65 20 77 72 69 74 74 ar.Antol..n.Camarena,.have.writt
20480 65 6e 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 45 6d 62 61 72 6b 20 63 6f 64 65 0a 20 20 61 6e 64 en.most.of.the.Embark.code...and
204a0 20 72 65 6d 61 69 6e 20 76 65 72 79 20 73 74 75 62 62 6f 72 6e 20 61 62 6f 75 74 20 73 6f 6d 65 .remain.very.stubborn.about.some
204c0 20 6f 66 20 74 68 65 20 64 65 73 69 67 6e 20 64 65 63 69 73 69 6f 6e 73 2c 20 45 6d 62 61 72 6b .of.the.design.decisions,.Embark
204e0 0a 20 20 68 61 73 20 72 65 63 65 69 76 65 64 20 73 75 62 73 74 61 6e 74 69 61 6c 20 68 65 6c 70 ...has.received.substantial.help
20500 20 66 72 6f 6d 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 6f 74 68 65 72 20 70 65 6f 70 6c 65 20 77 .from.a.number.of.other.people.w
20520 68 69 63 68 20 74 68 69 73 0a 20 20 64 6f 63 75 6d 65 6e 74 20 68 61 73 20 6e 65 67 6c 65 63 74 hich.this...document.has.neglect
20540 65 64 20 74 6f 20 6d 65 6e 74 69 6f 6e 20 66 6f 72 20 66 61 72 20 74 6f 6f 20 6c 6f 6e 67 2e 20 ed.to.mention.for.far.too.long..
20560 49 6e 20 70 61 72 74 69 63 75 6c 61 72 2c 0a 20 20 44 61 6e 69 65 6c 20 4d 65 6e 64 6c 65 72 20 In.particular,...Daniel.Mendler.
20580 68 61 73 20 62 65 65 6e 20 61 62 73 6f 6c 75 74 65 6c 79 20 69 6e 76 61 6c 75 61 62 6c 65 2c 20 has.been.absolutely.invaluable,.
205a0 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 73 65 76 65 72 61 6c 0a 20 20 69 6d 70 6f 72 74 61 6e 74 implementing.several...important
205c0 20 66 65 61 74 75 72 65 73 2c 20 61 6e 64 20 70 72 6f 76 69 64 69 6e 67 20 61 20 6c 6f 74 20 6f .features,.and.providing.a.lot.o
205e0 66 20 75 73 65 66 75 6c 20 61 64 76 69 63 65 2e 0a 0a 20 20 43 6f 64 65 20 63 6f 6e 74 72 69 62 f.useful.advice.....Code.contrib
20600 75 74 69 6f 6e 73 3a 0a 0a 20 20 e2 80 a2 20 5b 44 61 6e 69 65 6c 20 4d 65 6e 64 6c 65 72 5d 0a utions:........[Daniel.Mendler].
20620 20 20 e2 80 a2 20 5b 43 6c 65 6d 65 6e 73 20 52 61 64 65 72 6d 61 63 68 65 72 5d 0a 20 20 e2 80 ......[Clemens.Radermacher].....
20640 a2 20 5b 4a 6f 73 c3 a9 20 41 6e 74 6f 6e 69 6f 20 4f 72 74 65 67 61 20 52 75 69 7a 5d 0a 20 20 ..[Jos...Antonio.Ortega.Ruiz]...
20660 e2 80 a2 20 5b 49 74 61 69 20 59 2e 20 45 66 72 61 74 5d 0a 20 20 e2 80 a2 20 5b 61 31 33 5d 0a ....[Itai.Y..Efrat].......[a13].
20680 20 20 e2 80 a2 20 5b 6a 61 6b 61 6e 61 6b 61 65 76 61 6e 67 65 6c 69 5d 0a 20 20 e2 80 a2 20 5b ......[jakanakaevangeli].......[
206a0 6d 69 68 61 6b 61 6d 5d 0a 20 20 e2 80 a2 20 5b 42 72 69 61 6e 20 4c 65 75 6e 67 5d 0a 20 20 e2 mihakam].......[Brian.Leung]....
206c0 80 a2 20 5b 4b 61 72 74 68 69 6b 20 43 68 69 6b 6d 61 67 61 6c 75 72 5d 0a 20 20 e2 80 a2 20 5b ...[Karthik.Chikmagalur].......[
206e0 52 6f 73 68 61 6e 20 53 68 61 72 69 66 66 5d 0a 20 20 e2 80 a2 20 5b 63 6f 6e 64 79 30 39 31 39 Roshan.Shariff].......[condy0919
20700 5d 0a 20 20 e2 80 a2 20 5b 44 61 6d 69 65 6e 20 43 61 73 73 6f 75 5d 0a 20 20 e2 80 a2 20 5b 4a ].......[Damien.Cassou].......[J
20720 69 6d 44 42 68 5d 0a 0a 20 20 41 64 76 69 63 65 20 61 6e 64 20 75 73 65 66 75 6c 20 64 69 73 63 imDBh]....Advice.and.useful.disc
20740 75 73 73 69 6f 6e 73 3a 0a 0a 20 20 e2 80 a2 20 5b 44 61 6e 69 65 6c 20 4d 65 6e 64 6c 65 72 5d ussions:........[Daniel.Mendler]
20760 0a 20 20 e2 80 a2 20 5b 50 72 6f 74 65 73 69 6c 61 6f 73 20 53 74 61 76 72 6f 75 5d 0a 20 20 e2 .......[Protesilaos.Stavrou]....
20780 80 a2 20 5b 43 6c 65 6d 65 6e 73 20 52 61 64 65 72 6d 61 63 68 65 72 5d 0a 20 20 e2 80 a2 20 5b ...[Clemens.Radermacher].......[
207a0 48 6f 77 61 72 64 20 4d 65 6c 6d 61 6e 5d 0a 20 20 e2 80 a2 20 5b 41 75 67 75 73 74 6f 20 53 74 Howard.Melman].......[Augusto.St
207c0 6f 66 66 65 6c 5d 0a 20 20 e2 80 a2 20 5b 42 72 75 63 65 20 64 27 41 72 63 75 73 5d 0a 20 20 e2 offel].......[Bruce.d'Arcus]....
207e0 80 a2 20 5b 4a 44 20 53 6d 69 74 68 5d 0a 20 20 e2 80 a2 20 5b 4b 61 72 74 68 69 6b 20 43 68 69 ...[JD.Smith].......[Karthik.Chi
20800 6b 6d 61 67 61 6c 75 72 5d 0a 20 20 e2 80 a2 20 5b 6a 61 6b 61 6e 61 6b 61 65 76 61 6e 67 65 6c kmagalur].......[jakanakaevangel
20820 69 5d 0a 20 20 e2 80 a2 20 5b 49 74 61 69 20 59 2e 20 45 66 72 61 74 5d 0a 20 20 e2 80 a2 20 5b i].......[Itai.Y..Efrat].......[
20840 4d 6f 68 73 69 6e 20 4b 61 6c 65 65 6d 5d 0a 0a 0a 5b 44 61 6e 69 65 6c 20 4d 65 6e 64 6c 65 72 Mohsin.Kaleem]...[Daniel.Mendler
20860 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 6e 61 64 3e 0a 0a 5b 43 ].<https://github.com/minad>..[C
20880 6c 65 6d 65 6e 73 20 52 61 64 65 72 6d 61 63 68 65 72 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 lemens.Radermacher].<https://git
208a0 68 75 62 2e 63 6f 6d 2f 63 6c 65 6d 65 72 61 2f 3e 0a 0a 5b 4a 6f 73 c3 a9 20 41 6e 74 6f 6e 69 hub.com/clemera/>..[Jos...Antoni
208c0 6f 20 4f 72 74 65 67 61 20 52 75 69 7a 5d 20 3c 68 74 74 70 73 3a 2f 2f 63 6f 64 65 62 65 72 67 o.Ortega.Ruiz].<https://codeberg
208e0 2e 6f 72 67 2f 6a 61 6f 2f 3e 0a 0a 5b 49 74 61 69 20 59 2e 20 45 66 72 61 74 5d 20 3c 68 74 74 .org/jao/>..[Itai.Y..Efrat].<htt
20900 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 69 79 65 66 72 61 74 3e 0a 0a 5b 61 31 33 5d 20 ps://github.com/iyefrat>..[a13].
20920 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 61 31 33 3e 0a 0a 5b 6a 61 6b 61 6e <https://github.com/a13>..[jakan
20940 61 6b 61 65 76 61 6e 67 65 6c 69 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d akaevangeli].<https://github.com
20960 2f 6a 61 6b 61 6e 61 6b 61 65 76 61 6e 67 65 6c 69 3e 0a 0a 5b 6d 69 68 61 6b 61 6d 5d 20 3c 68 /jakanakaevangeli>..[mihakam].<h
20980 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 69 68 61 6b 61 6d 3e 0a 0a 5b 42 72 69 ttps://github.com/mihakam>..[Bri
209a0 61 6e 20 4c 65 75 6e 67 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6c 65 an.Leung].<https://github.com/le
209c0 75 6e 67 62 6b 3e 0a 0a 5b 4b 61 72 74 68 69 6b 20 43 68 69 6b 6d 61 67 61 6c 75 72 5d 20 3c 68 ungbk>..[Karthik.Chikmagalur].<h
209e0 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6b 61 72 74 68 69 6e 6b 3e 0a 0a 5b 52 6f ttps://github.com/karthink>..[Ro
20a00 73 68 61 6e 20 53 68 61 72 69 66 66 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f shan.Shariff].<https://github.co
20a20 6d 2f 72 6f 73 68 61 6e 73 68 61 72 69 66 66 3e 0a 0a 5b 63 6f 6e 64 79 30 39 31 39 5d 20 3c 68 m/roshanshariff>..[condy0919].<h
20a40 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 63 6f 6e 64 79 30 39 31 39 3e 0a 0a 5b 44 ttps://github.com/condy0919>..[D
20a60 61 6d 69 65 6e 20 43 61 73 73 6f 75 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f amien.Cassou].<https://github.co
20a80 6d 2f 44 61 6d 69 65 6e 43 61 73 73 6f 75 3e 0a 0a 5b 4a 69 6d 44 42 68 5d 20 3c 68 74 74 70 73 m/DamienCassou>..[JimDBh].<https
20aa0 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 4a 69 6d 44 42 68 3e 0a 0a 5b 50 72 6f 74 65 73 69 6c ://github.com/JimDBh>..[Protesil
20ac0 61 6f 73 20 53 74 61 76 72 6f 75 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 6c 61 62 2e 63 6f 6d aos.Stavrou].<https://gitlab.com
20ae0 2f 70 72 6f 74 65 73 69 6c 61 6f 73 2f 3e 0a 0a 5b 48 6f 77 61 72 64 20 4d 65 6c 6d 61 6e 5d 20 /protesilaos/>..[Howard.Melman].
20b00 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 68 6d 65 6c 6d 61 6e 2f 3e 0a 0a 5b <https://github.com/hmelman/>..[
20b20 41 75 67 75 73 74 6f 20 53 74 6f 66 66 65 6c 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 Augusto.Stoffel].<https://github
20b40 2e 63 6f 6d 2f 61 73 74 6f 66 66 3e 0a 0a 5b 42 72 75 63 65 20 64 27 41 72 63 75 73 5d 20 3c 68 .com/astoff>..[Bruce.d'Arcus].<h
20b60 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 62 64 61 72 63 75 73 3e 0a 0a 5b 4a 44 20 ttps://github.com/bdarcus>..[JD.
20b80 53 6d 69 74 68 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6a 64 74 73 6d Smith].<https://github.com/jdtsm
20ba0 69 74 68 3e 0a 0a 5b 4d 6f 68 73 69 6e 20 4b 61 6c 65 65 6d 5d 20 3c 68 74 74 70 73 3a 2f 2f 67 ith>..[Mohsin.Kaleem].<https://g
20bc0 69 74 68 75 62 2e 63 6f 6d 2f 6d 6f 68 6b 61 6c 65 3e 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 ithub.com/mohkale>..............
20be0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20c00 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 43 48 41 4e 47 45 4c 4f 47 2e 6f 72 67 embark-consult-1.1/CHANGELOG.org
20c20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20c40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20c60 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
20c80 30 30 31 32 37 37 33 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 34 37 35 32 00 20 30 00 00 00 0012773.00000000000.014752..0...
20ca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20cc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20ce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20d00 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
20d20 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
20d40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20d60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20d80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20da0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20dc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20de0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
20e00 23 2b 74 69 74 6c 65 3a 20 45 6d 62 61 72 6b 20 63 68 61 6e 67 65 6c 6f 67 0a 0a 2a 20 56 65 72 #+title:.Embark.changelog..*.Ver
20e20 73 69 6f 6e 20 31 2e 31 20 28 32 30 32 34 2d 30 34 2d 31 38 29 0a 2d 20 54 68 65 20 3d 65 6d 62 sion.1.1.(2024-04-18).-.The.=emb
20e40 61 72 6b 2d 63 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 ark-consult=.package.contains.a.
20e60 6e 65 77 20 65 78 70 6f 72 74 65 72 20 66 6f 72 0a 20 20 3d 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 new.exporter.for...=consult-loca
20e80 74 69 6f 6e 3d 20 74 61 72 67 65 74 73 20 28 70 72 6f 64 75 63 65 64 20 62 79 20 73 65 76 65 72 tion=.targets.(produced.by.sever
20ea0 61 6c 20 3d 63 6f 6e 73 75 6c 74 3d 20 63 6f 6d 6d 61 6e 64 73 20 73 75 63 68 0a 20 20 61 73 20 al.=consult=.commands.such...as.
20ec0 3d 63 6f 6e 73 75 6c 74 2d 6c 69 6e 65 3d 29 2c 20 77 68 69 63 68 20 65 78 70 6f 72 74 73 20 74 =consult-line=),.which.exports.t
20ee0 6f 20 61 20 67 72 65 70 20 6d 6f 64 65 20 62 75 66 66 65 72 2e 20 55 73 65 72 73 20 77 69 73 68 o.a.grep.mode.buffer..Users.wish
20f00 69 6e 67 0a 20 20 74 6f 20 75 73 65 20 74 68 65 20 6e 65 77 20 67 72 65 70 20 6d 6f 64 65 20 65 ing...to.use.the.new.grep.mode.e
20f20 78 70 6f 72 74 65 72 20 63 61 6e 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 xporter.can.use.the.following...
20f40 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 0a 20 20 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 configuration:...#+begin_src.ema
20f60 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f cs-lisp.....(setf.(alist-get.'co
20f80 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 20 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 65 72 73 2d nsult-location.embark-exporters-
20fa0 61 6c 69 73 74 29 0a 20 20 20 20 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c alist)...........#'embark-consul
20fc0 74 2d 65 78 70 6f 72 74 2d 6c 6f 63 61 74 69 6f 6e 2d 67 72 65 70 29 0a 20 20 23 2b 65 6e 64 5f t-export-location-grep)...#+end_
20fe0 73 72 63 0a 20 20 54 68 65 20 6d 61 69 6e 20 72 65 61 73 6f 6e 20 66 6f 72 20 61 64 64 69 6e 67 src...The.main.reason.for.adding
21000 20 74 68 65 20 6e 65 77 20 65 78 70 6f 72 74 65 72 20 69 73 20 74 68 61 74 20 75 73 65 72 73 20 .the.new.exporter.is.that.users.
21020 6f 66 20 74 68 65 0a 20 20 3d 77 67 72 65 70 3d 20 70 61 63 6b 61 67 65 20 77 69 6c 6c 20 62 65 of.the...=wgrep=.package.will.be
21040 20 61 62 6c 65 20 74 6f 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 61 20 66 65 61 74 75 72 65 20 74 .able.to.make.use.of.a.feature.t
21060 68 61 74 20 3d 77 67 72 65 70 3d 20 68 61 73 0a 20 20 61 6e 64 20 74 68 65 20 62 75 69 6c 74 2d hat.=wgrep=.has...and.the.built-
21080 69 6e 20 3d 6f 63 63 75 72 2d 65 64 69 74 2d 6d 6f 64 65 3d 20 6c 61 63 6b 73 3a 20 77 68 65 6e in.=occur-edit-mode=.lacks:.when
210a0 20 65 64 69 74 69 6e 67 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 0a 20 20 79 6f 75 20 63 61 .editing.search.results...you.ca
210c0 6e 20 61 64 64 20 6e 65 77 20 6c 69 6e 65 73 20 74 6f 20 61 20 72 65 73 75 6c 74 20 6c 6f 63 61 n.add.new.lines.to.a.result.loca
210e0 74 69 6f 6e 2e 20 54 68 65 72 65 20 61 72 65 20 61 6c 73 6f 20 73 6f 6d 65 0a 20 20 64 69 73 61 tion..There.are.also.some...disa
21100 64 76 61 6e 74 61 67 65 73 20 6f 66 20 67 72 65 70 20 6d 6f 64 65 20 63 6f 6d 70 61 72 65 64 20 dvantages.of.grep.mode.compared.
21120 74 6f 20 6f 63 63 75 72 20 6d 6f 64 65 20 28 77 68 69 63 68 20 69 73 20 77 68 79 20 74 68 65 0a to.occur.mode.(which.is.why.the.
21140 20 20 70 72 65 76 69 6f 75 73 6c 79 20 65 78 69 73 74 69 6e 67 20 6f 63 63 75 72 20 6d 6f 64 65 ..previously.existing.occur.mode
21160 20 65 78 70 6f 72 74 65 72 20 63 6f 6e 74 69 6e 75 65 73 20 74 6f 20 62 65 20 74 68 65 0a 20 20 .exporter.continues.to.be.the...
21180 64 65 66 61 75 6c 74 29 3a 20 28 31 29 20 3d 77 67 72 65 70 3d 20 69 73 20 61 20 74 68 69 72 64 default):.(1).=wgrep=.is.a.third
211a0 20 70 61 72 74 79 20 70 61 63 6b 61 67 65 20 77 68 69 6c 65 20 3d 6f 63 63 75 72 2d 65 64 69 74 .party.package.while.=occur-edit
211c0 2d 6d 6f 64 65 3d 0a 20 20 69 73 20 62 75 69 6c 74 2d 69 6e 3b 20 28 32 29 20 6f 63 63 75 72 20 -mode=...is.built-in;.(2).occur.
211e0 6d 6f 64 65 20 62 75 66 66 65 72 73 20 63 61 6e 20 6c 69 73 74 20 6c 69 6e 65 73 20 69 6e 20 61 mode.buffers.can.list.lines.in.a
21200 6e 79 20 6b 69 6e 64 20 6f 66 0a 20 20 62 75 66 66 65 72 2c 20 62 75 74 20 67 72 65 70 20 6d 6f ny.kind.of...buffer,.but.grep.mo
21220 64 65 20 61 6e 64 20 3d 77 67 72 65 70 3d 20 61 72 65 20 6d 65 61 6e 74 20 66 6f 72 20 6c 69 6e de.and.=wgrep=.are.meant.for.lin
21240 65 73 20 6f 66 20 66 69 6c 65 73 0a 20 20 65 78 63 6c 75 73 69 76 65 6c 79 2e 0a 2a 20 56 65 72 es.of.files...exclusively..*.Ver
21260 73 69 6f 6e 20 31 2e 30 20 28 32 30 32 33 2d 31 32 2d 30 38 29 0a 2d 20 59 6f 75 20 63 61 6e 20 sion.1.0.(2023-12-08).-.You.can.
21280 6e 6f 77 20 75 73 65 20 61 72 6f 75 6e 64 20 61 63 74 69 6f 6e 20 68 6f 6f 6b 73 20 77 69 74 68 now.use.around.action.hooks.with
212a0 20 6d 75 6c 74 69 74 61 72 67 65 74 20 61 63 74 69 6f 6e 73 20 28 74 68 61 74 0a 20 20 79 6f 75 .multitarget.actions.(that...you
212c0 20 63 6f 75 6c 64 6e 27 74 20 70 72 65 76 69 6f 75 73 6c 79 20 77 61 73 20 61 6e 20 6f 76 65 72 .couldn't.previously.was.an.over
212e0 73 69 67 68 74 29 2e 0a 2d 20 55 73 65 72 73 20 6f 66 20 74 68 65 20 3d 65 6d 62 61 72 6b 2d 63 sight)..-.Users.of.the.=embark-c
21300 6f 6e 73 75 6c 74 3d 20 70 61 63 6b 61 67 65 20 63 61 6e 20 6e 6f 77 20 75 73 65 20 63 6f 6e 73 onsult=.package.can.now.use.cons
21320 75 6c 74 20 61 73 79 6e 63 20 73 65 61 72 63 68 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 73 75 63 68 ult.async.search...commands.such
21340 20 61 73 20 3d 63 6f 6e 73 75 6c 74 2d 67 72 65 70 3d 20 61 73 20 6d 75 6c 74 69 74 61 72 67 65 .as.=consult-grep=.as.multitarge
21360 74 20 61 63 74 69 6f 6e 73 20 28 74 68 72 6f 75 67 68 0a 20 20 3d 65 6d 62 61 72 6b 2d 61 63 74 t.actions.(through...=embark-act
21380 2d 61 6c 6c 3d 29 20 74 6f 20 73 65 61 72 63 68 20 61 20 6c 69 73 74 20 6f 66 20 66 69 6c 65 73 -all=).to.search.a.list.of.files
213a0 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 0a 20 20 3d 63 6f ..For.example,.you.can.use...=co
213c0 6e 73 75 6c 74 2d 66 69 6e 64 3d 20 74 6f 20 73 65 61 72 63 68 20 61 6d 6f 6e 67 20 66 69 6c 65 nsult-find=.to.search.among.file
213e0 20 2f 6e 61 6d 65 73 2f 20 61 6e 64 20 6f 6e 63 65 20 79 6f 75 20 68 61 76 65 20 74 68 65 0a 20 ./names/.and.once.you.have.the..
21400 20 72 65 6c 65 76 61 6e 74 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 .relevant.files.in.the.minibuffe
21420 72 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 r,.you.can.use.=embark-act-all=.
21440 74 6f 0a 20 20 73 65 61 72 63 68 20 66 6f 72 20 73 6f 6d 65 20 74 65 78 74 20 69 6e 20 74 68 6f to...search.for.some.text.in.tho
21460 73 65 20 66 69 6c 65 73 2e 20 57 68 65 6e 20 61 63 74 69 6e 67 20 6f 6e 20 62 75 66 66 65 72 73 se.files..When.acting.on.buffers
21480 20 63 6f 6e 73 75 6c 74 0a 20 20 61 73 79 6e 63 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 73 .consult...async.search.commands
214a0 20 77 69 6c 6c 20 73 65 61 72 63 68 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 .will.search.the.associated.file
214c0 20 69 66 20 74 68 65 72 65 20 69 73 0a 20 20 6f 6e 65 2c 20 6f 72 20 65 6c 73 65 20 74 68 65 20 .if.there.is...one,.or.else.the.
214e0 3d 64 65 66 61 75 6c 74 2d 64 69 72 65 63 74 6f 72 79 3d 20 6f 66 20 74 68 65 20 62 75 66 66 65 =default-directory=.of.the.buffe
21500 72 2e 0a 2d 20 3d 65 6d 62 61 72 6b 2d 62 69 6e 64 69 6e 67 73 3d 20 61 6e 64 20 73 69 6d 69 6c r..-.=embark-bindings=.and.simil
21520 61 72 20 63 6f 6d 6d 61 6e 64 73 20 6e 6f 77 20 73 68 6f 77 20 64 65 66 69 6e 69 74 69 6f 6e 20 ar.commands.now.show.definition.
21540 6f 66 20 6b 65 79 62 6f 61 72 64 0a 20 20 6d 61 63 72 6f 73 2e 0a 2d 20 3d 65 6d 62 61 72 6b 2d of.keyboard...macros..-.=embark-
21560 6f 72 67 3d 20 6e 6f 77 20 72 65 63 6f 67 6e 69 7a 65 73 20 4f 72 67 20 6c 69 6e 6b 73 20 69 6e org=.now.recognizes.Org.links.in
21580 20 6e 6f 6e 2d 6f 72 67 20 62 75 66 66 65 72 73 2e 0a 2d 20 4e 6f 77 20 70 72 65 73 73 69 6e 67 .non-org.buffers..-.Now.pressing
215a0 20 52 45 54 20 69 6e 20 61 6e 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 20 6f 6e 20 61 .RET.in.an.=embark-collect=.on.a
215c0 20 73 65 6c 65 63 74 69 6f 6e 20 6d 61 64 65 20 62 79 0a 20 20 75 73 69 6e 67 20 3d 65 6d 62 61 .selection.made.by...using.=emba
215e0 72 6b 2d 73 65 6c 65 63 74 3d 20 69 6e 20 61 20 6e 6f 72 6d 61 6c 20 62 75 66 66 65 72 20 77 69 rk-select=.in.a.normal.buffer.wi
21600 6c 6c 20 74 61 6b 65 20 79 6f 75 20 74 6f 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e 0a 20 20 65 61 ll.take.you.to.the.location...ea
21620 63 68 20 74 61 72 67 65 74 20 77 61 73 20 63 6f 6c 6c 65 63 74 65 64 20 66 72 6f 6d 2e 0a 2d 20 ch.target.was.collected.from..-.
21640 53 6f 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 6e 61 6d 65 64 20 66 6f 72 20 67 72 65 61 74 Some.functions.renamed.for.great
21660 65 72 20 63 6f 6e 73 69 73 74 65 6e 63 79 20 28 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 er.consistency.(these.functions.
21680 61 72 65 0a 20 20 75 6e 6c 69 6b 65 6c 79 20 74 6f 20 62 65 20 72 65 66 65 72 72 65 64 20 74 6f are...unlikely.to.be.referred.to
216a0 20 69 6e 20 75 73 65 72 27 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 29 3a 0a 20 20 2d 20 3d .in.user's.configuration):...-.=
216c0 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 63 6f 6d 70 6c 65 74 69 6f 6e 2d 61 74 2d 70 6f 69 6e embark-target-completion-at-poin
216e0 74 3d 20 e2 86 92 20 3d 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 63 6f 6d 70 6c 65 74 69 6f 6e t=.....=embark-target-completion
21700 2d 6c 69 73 74 2d 63 61 6e 64 69 64 61 74 65 3d 0a 20 20 2d 20 3d 65 6d 62 61 72 6b 2d 74 61 72 -list-candidate=...-.=embark-tar
21720 67 65 74 2d 74 6f 70 2d 6d 69 6e 69 62 75 66 66 65 72 2d 63 6f 6d 70 6c 65 74 69 6f 6e 3d 20 e2 get-top-minibuffer-completion=..
21740 86 92 20 3d 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 74 6f 70 2d 6d 69 6e 69 62 75 66 66 65 72 ...=embark-target-top-minibuffer
21760 2d 63 61 6e 64 69 64 61 74 65 3d 0a 20 20 2d 20 3d 65 6d 62 61 72 6b 2d 63 6f 6d 70 6c 65 74 69 -candidate=...-.=embark-completi
21780 6f 6e 73 2d 62 75 66 66 65 72 2d 63 61 6e 64 69 64 61 74 65 73 3d 20 e2 86 92 20 3d 65 6d 62 61 ons-buffer-candidates=.....=emba
217a0 72 6b 2d 63 6f 6d 70 6c 65 74 69 6f 6e 2d 6c 69 73 74 2d 63 61 6e 64 69 64 61 74 65 73 3d 0a 2a rk-completion-list-candidates=.*
217c0 20 56 65 72 73 69 6f 6e 20 30 2e 32 33 20 28 32 30 32 33 2d 30 39 2d 31 39 29 0a 2d 20 41 64 64 .Version.0.23.(2023-09-19).-.Add
217e0 65 64 20 61 20 6d 6f 64 65 20 6c 69 6e 65 20 69 6e 64 69 63 61 74 6f 72 20 73 68 6f 77 69 6e 67 ed.a.mode.line.indicator.showing
21800 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 65 6c 65 63 74 65 64 20 74 61 72 67 65 74 73 20 .the.number.of.selected.targets.
21820 69 6e 0a 20 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 20 28 63 6f 6e 74 72 69 62 in...the.current.buffer.(contrib
21840 75 74 65 64 20 62 79 20 40 6d 69 6e 61 64 2c 20 74 68 61 6e 6b 73 21 29 0a 2d 20 4e 6f 77 20 3d uted.by.@minad,.thanks!).-.Now.=
21860 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 63 61 6c 6c 65 embark-select=.can.also.be.calle
21880 64 20 61 73 20 61 20 74 6f 70 2d 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 2c 20 66 72 6f 6d 0a 20 d.as.a.top-level.command,.from..
218a0 20 6f 75 74 73 69 64 65 20 3d 65 6d 62 61 72 6b 2d 61 63 74 3d 2e 20 57 68 65 6e 20 63 61 6c 6c .outside.=embark-act=..When.call
218c0 65 64 20 74 68 61 74 20 77 61 79 2c 20 69 74 20 77 69 6c 6c 20 73 65 6c 65 63 74 20 74 68 65 20 ed.that.way,.it.will.select.the.
218e0 66 69 72 73 74 0a 20 20 74 61 72 67 65 74 20 61 74 20 70 6f 69 6e 74 2e 0a 2d 20 3d 65 6d 62 61 first...target.at.point..-.=emba
21900 72 6b 2d 6f 72 67 3d 20 6e 6f 77 20 68 61 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 61 63 74 69 rk-org=.now.has.support.for.acti
21920 6e 67 20 6f 6e 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 6f 72 67 20 68 65 61 64 69 6e 67 73 ng.on.references.to.org.headings
21940 0a 20 20 69 6e 20 6f 74 68 65 72 20 62 75 66 66 65 72 73 2c 20 62 79 20 6a 75 6d 70 69 6e 67 20 ...in.other.buffers,.by.jumping.
21960 74 6f 20 74 68 65 20 68 65 61 64 69 6e 67 20 66 69 72 73 74 20 61 6e 64 20 74 68 65 6e 20 72 75 to.the.heading.first.and.then.ru
21980 6e 6e 69 6e 67 0a 20 20 74 68 65 20 61 63 74 69 6f 6e 2e 20 4f 6e 65 20 73 6f 75 72 63 65 20 6f nning...the.action..One.source.o
219a0 66 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 6f 72 67 20 68 65 61 64 69 6e 67 73 20 69 6e 20 f.references.to.org.headings.in.
219c0 6f 74 68 65 72 0a 20 20 62 75 66 66 65 72 73 20 61 72 65 20 61 67 65 6e 64 61 20 76 69 65 77 73 other...buffers.are.agenda.views
219e0 3a 20 65 61 63 68 20 61 67 65 6e 64 61 20 69 74 65 6d 20 69 73 20 73 75 63 68 20 61 20 72 65 66 :.each.agenda.item.is.such.a.ref
21a00 65 72 65 6e 63 65 2e 20 42 75 74 0a 20 20 74 68 69 73 20 66 65 61 74 75 72 65 20 61 6c 73 6f 20 erence..But...this.feature.also.
21a20 73 75 70 70 6f 72 74 73 20 73 6f 6d 65 20 67 72 65 61 74 20 74 68 69 72 64 20 70 61 72 74 79 20 supports.some.great.third.party.
21a40 63 6f 6d 6d 61 6e 64 73 20 77 68 69 63 68 0a 20 20 70 72 6f 64 75 63 65 20 72 65 66 65 72 65 6e commands.which...produce.referen
21a60 63 65 73 20 74 6f 20 6f 72 67 20 68 65 61 64 69 6e 67 73 2c 20 73 75 63 68 20 61 73 20 3d 6f 72 ces.to.org.headings,.such.as.=or
21a80 67 2d 71 6c 2d 66 69 6e 64 3d 20 66 72 6f 6d 20 74 68 65 0a 20 20 3d 6f 72 67 2d 71 6c 3d 20 70 g-ql-find=.from.the...=org-ql=.p
21aa0 61 63 6b 61 67 65 20 6f 72 20 3d 63 6f 6e 73 75 6c 74 2d 6f 72 67 2d 68 65 61 64 69 6e 67 3d 20 ackage.or.=consult-org-heading=.
21ac0 66 72 6f 6d 20 3d 63 6f 6e 73 75 6c 74 3d 2e 0a 2d 20 52 65 6e 61 6d 65 64 20 3d 65 6d 62 61 72 from.=consult=..-.Renamed.=embar
21ae0 6b 2d 69 73 65 61 72 63 68 3d 20 74 6f 20 3d 65 6d 62 61 72 6b 2d 69 73 65 61 72 63 68 2d 66 6f k-isearch=.to.=embark-isearch-fo
21b00 72 77 61 72 64 3d 20 61 6e 64 20 61 64 64 65 64 0a 20 20 3d 65 6d 62 61 72 6b 2d 69 73 65 61 72 rward=.and.added...=embark-isear
21b20 63 68 2d 62 61 63 6b 77 61 72 64 3d 2e 0a 2d 20 3d 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 3d 20 ch-backward=..-.=embark-become=.
21b40 6e 6f 77 20 72 65 6d 6f 76 65 73 20 61 6e 79 20 69 6e 76 69 73 69 62 6c 65 20 74 65 78 74 20 66 now.removes.any.invisible.text.f
21b60 72 6f 6d 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 0a 20 20 69 6e 70 75 74 20 6f 6e 20 74 68 rom.the.minibuffer...input.on.th
21b80 65 20 67 72 6f 75 6e 64 73 20 74 68 61 74 20 75 73 65 72 73 20 70 72 6f 62 61 62 6c 79 20 65 78 e.grounds.that.users.probably.ex
21ba0 70 65 63 74 20 74 68 65 20 74 61 72 67 65 74 20 63 6f 6d 6d 61 6e 64 0a 20 20 74 6f 20 72 65 63 pect.the.target.command...to.rec
21bc0 65 69 76 65 20 65 78 61 63 74 6c 79 20 74 68 65 20 69 6e 70 75 74 20 74 68 65 79 20 63 61 6e 20 eive.exactly.the.input.they.can.
21be0 73 65 65 2e 0a 2d 20 54 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 see..-.The.meaning.of.the.prefix
21c00 20 61 72 67 75 6d 65 6e 74 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 62 69 6e 64 69 6e 67 73 3d 20 68 .argument.in.=embark-bindings=.h
21c20 61 73 20 66 6c 69 70 70 65 64 3a 0a 20 20 6e 6f 77 20 62 79 20 64 65 66 61 75 6c 74 20 67 6c 6f as.flipped:...now.by.default.glo
21c40 62 61 6c 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 65 78 63 6c 75 64 65 64 20 61 6e bal.key.bindings.are.excluded.an
21c60 64 20 79 6f 75 20 63 61 6e 20 75 73 65 20 3d 43 2d 75 3d 0a 20 20 74 6f 20 69 6e 63 6c 75 64 65 d.you.can.use.=C-u=...to.include
21c80 20 74 68 65 6d 2e 0a 2d 20 49 66 20 61 6e 79 20 63 61 6e 64 69 64 61 74 65 20 69 6e 20 61 6e 20 .them..-.If.any.candidate.in.an.
21ca0 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 73 20 61 embark-collect.buffer.contains.a
21cc0 20 6e 65 77 6c 69 6e 65 2c 0a 20 20 74 68 65 6e 20 63 61 6e 64 69 64 61 74 65 73 20 77 69 6c 6c .newline,...then.candidates.will
21ce0 20 62 65 20 73 65 70 61 72 61 74 65 64 20 62 79 20 68 6f 72 69 7a 6f 6e 74 61 6c 20 6c 69 6e 65 .be.separated.by.horizontal.line
21d00 73 2e 20 54 68 69 73 20 69 73 20 68 61 6e 64 79 0a 20 20 66 6f 72 20 74 68 65 20 6b 69 6c 6c 2d s..This.is.handy...for.the.kill-
21d20 72 69 6e 67 2c 20 77 68 69 63 68 20 79 6f 75 20 63 61 6e 20 62 72 6f 77 73 65 20 62 79 20 63 61 ring,.which.you.can.browse.by.ca
21d40 6c 6c 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 3d 0a 20 20 66 72 6f 6d 20 3d 79 lling.=embark-collect=...from.=y
21d60 61 6e 6b 2d 70 6f 70 3d 2e 0a 2a 20 56 65 72 73 69 6f 6e 20 30 2e 32 32 2e 31 20 28 32 30 32 33 ank-pop=..*.Version.0.22.1.(2023
21d80 2d 30 34 2d 32 30 29 0a 2a 2a 20 4e 65 77 20 66 65 61 74 75 72 65 3a 20 73 65 6c 65 63 74 69 6f -04-20).**.New.feature:.selectio
21da0 6e 73 0a 4e 6f 77 20 75 73 65 72 73 20 63 61 6e 20 73 65 6c 65 63 74 20 73 65 76 65 72 61 6c 20 ns.Now.users.can.select.several.
21dc0 74 61 72 67 65 74 73 20 74 6f 20 6d 61 6b 65 20 61 6e 20 61 64 20 68 6f 63 20 63 6f 6c 6c 65 63 targets.to.make.an.ad.hoc.collec
21de0 74 69 6f 6e 2e 20 54 68 65 0a 63 6f 6d 6d 61 6e 64 73 20 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 tion..The.commands.=embark-act-a
21e00 6c 6c 3d 2c 20 3d 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 3d 20 61 6e 64 20 3d 65 6d 62 61 72 6b ll=,.=embark-export=.and.=embark
21e20 2d 63 6f 6c 6c 65 63 74 3d 20 77 69 6c 6c 20 61 63 74 20 6f 6e 0a 74 68 65 20 73 65 6c 65 63 74 -collect=.will.act.on.the.select
21e40 69 6f 6e 20 69 66 20 69 74 20 69 73 20 6e 6f 6e 2d 65 6d 70 74 79 2e 20 54 6f 20 73 65 6c 65 63 ion.if.it.is.non-empty..To.selec
21e60 74 20 6f 72 20 64 65 73 65 6c 65 63 74 20 61 20 74 61 72 67 65 74 20 75 73 65 0a 74 68 65 20 3d t.or.deselect.a.target.use.the.=
21e80 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 20 61 63 74 69 6f 6e 20 28 62 6f 75 6e 64 20 74 6f 20 embark-select=.action.(bound.to.
21ea0 3d 53 50 43 3d 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d 61 70 3d 29 2e 20 =SPC=.in.=embark-general-map=)..
21ec0 49 66 20 79 6f 75 0a 68 61 76 65 20 73 6f 6d 65 20 74 61 72 67 65 74 73 20 73 65 6c 65 63 74 65 If.you.have.some.targets.selecte
21ee0 64 2c 20 74 68 65 6e 20 75 73 69 6e 67 20 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 20 74 68 d,.then.using.=embark-select=.th
21f00 72 6f 75 67 68 0a 3d 65 6d 62 61 72 6b 2d 61 63 74 2d 61 6c 6c 3d 20 77 69 6c 6c 20 64 65 73 65 rough.=embark-act-all=.will.dese
21f20 6c 65 63 74 20 74 68 65 6d 2e 0a 0a 42 65 66 6f 72 65 20 74 68 69 73 20 63 68 61 6e 67 65 20 74 lect.them...Before.this.change.t
21f40 68 65 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 20 68 61 64 20 74 68 he.Embark.Collect.buffers.had.th
21f60 65 69 72 20 6f 77 6e 0a 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73 65 6c 65 63 74 eir.own.implementation.of.select
21f80 69 6f 6e 73 20 77 68 69 63 68 20 68 61 73 20 62 65 65 6e 20 72 65 6d 6f 76 65 64 2e 20 54 68 69 ions.which.has.been.removed..Thi
21fa0 73 20 69 73 20 68 6f 77 20 74 6f 0a 74 72 61 6e 73 6c 61 74 65 20 74 68 65 20 6f 6c 64 20 62 69 s.is.how.to.translate.the.old.bi
21fc0 6e 64 69 6e 67 73 20 74 6f 20 74 68 65 20 6e 65 77 20 66 65 61 74 75 72 65 20 28 77 68 69 63 68 ndings.to.the.new.feature.(which
21fe0 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 0a 61 6c 6c 20 62 75 66 66 65 72 73 2c 20 6e 6f .is.available.in.all.buffers,.no
22000 74 20 6a 75 73 74 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 21 29 3a t.just.Embark.Collect.buffers!):
22020 0a 0a 7c 20 54 61 73 6b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 4f 6c 64 20 62 69 6e ..|.Task...............|.Old.bin
22040 64 69 6e 67 20 7c 20 4e 65 77 20 62 69 6e 64 69 6e 67 20 20 20 7c 0a 7c 2d 2d 2d 2d 2d 2d 2d 2d ding.|.New.binding...|.|--------
22060 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2b 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2b 2d 2d 2d 2d 2d ------------+-------------+-----
22080 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 7c 0a 7c 20 4d 61 72 6b 20 61 20 63 61 6e 64 69 64 61 74 65 20 20 ----------|.|.Mark.a.candidate..
220a0 20 7c 20 6d 20 20 20 20 20 20 20 20 20 20 20 7c 20 61 20 53 50 43 20 20 20 20 20 20 20 20 20 7c .|.m...........|.a.SPC.........|
220c0 0a 7c 20 55 6e 6d 61 72 6b 20 61 20 63 61 6e 64 69 64 61 74 65 20 7c 20 75 20 20 20 20 20 20 20 .|.Unmark.a.candidate.|.u.......
220e0 20 20 20 20 7c 20 61 20 53 50 43 20 20 20 20 20 20 20 20 20 7c 0a 7c 20 55 6e 6d 61 72 6b 20 61 ....|.a.SPC.........|.|.Unmark.a
22100 6c 6c 20 20 20 20 20 20 20 20 20 7c 20 55 20 20 20 20 20 20 20 20 20 20 20 7c 20 41 20 53 50 43 ll.........|.U...........|.A.SPC
22120 20 20 20 20 20 20 20 20 20 7c 0a 7c 20 4d 61 72 6b 20 61 6c 6c 20 5b 31 5d 20 20 20 20 20 20 20 .........|.|.Mark.all.[1].......
22140 7c 20 74 20 20 20 20 20 20 20 20 20 20 20 7c 20 41 20 53 50 43 20 20 20 20 20 20 20 20 20 7c 0a |.t...........|.A.SPC.........|.
22160 7c 20 54 6f 67 67 6c 65 20 61 6c 6c 20 6d 61 72 6b 73 20 20 20 7c 20 74 20 20 20 20 20 20 20 20 |.Toggle.all.marks...|.t........
22180 20 20 20 7c 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 7c 0a 0a 5b 31 5d 20 4d 61 72 6b 69 6e ...|.not.available.|..[1].Markin
221a0 67 20 61 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 20 28 77 69 74 68 20 65 69 74 68 65 72 20 74 68 g.all.candidates.(with.either.th
221c0 65 20 6f 6c 64 20 3d 74 3d 20 6f 72 20 74 68 65 20 6e 65 77 20 3d 41 20 53 50 43 3d 29 0a 72 65 e.old.=t=.or.the.new.=A.SPC=).re
221e0 71 75 69 72 65 73 20 74 68 61 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6d 61 72 6b 65 64 20 quires.that.there.are.no.marked.
22200 63 61 6e 64 69 64 61 74 65 73 20 74 6f 20 62 65 67 69 6e 20 77 69 74 68 2e 0a 0a 49 6e 20 6f 72 candidates.to.begin.with...In.or
22220 64 65 72 20 74 6f 20 6d 61 6b 65 20 72 6f 6f 6d 20 66 6f 72 20 74 68 65 20 62 69 6e 64 69 6e 67 der.to.make.room.for.the.binding
22240 20 6f 66 20 3d 65 6d 62 61 72 6b 2d 73 65 6c 65 63 74 3d 20 74 6f 0a 3d 53 50 43 3d 2c 20 73 6f .of.=embark-select=.to.=SPC=,.so
22260 6d 65 20 6f 74 68 65 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 77 65 72 65 20 6d 6f 76 65 64 me.other.key.bindings.were.moved
22280 3a 0a 0a 2d 20 3d 6d 61 72 6b 3d 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d :..-.=mark=.in.=embark-general-m
222a0 61 70 3d 20 77 61 73 20 6d 6f 76 65 64 20 74 6f 20 3d 43 2d 53 50 43 3d 2e 0a 2d 20 3d 6f 75 74 ap=.was.moved.to.=C-SPC=..-.=out
222c0 6c 69 6e 65 2d 6d 61 72 6b 2d 73 75 62 74 72 65 65 3d 20 69 6e 20 3d 65 6d 62 61 72 6b 2d 68 65 line-mark-subtree=.in.=embark-he
222e0 61 64 69 6e 67 2d 6d 61 70 3d 20 77 61 73 20 6d 6f 76 65 64 20 74 6f 20 3d 43 2d 53 50 43 3d 2e ading-map=.was.moved.to.=C-SPC=.
22300 0a 2d 20 3d 77 68 69 74 65 73 70 61 63 65 2d 63 6c 65 61 6e 75 70 2d 72 65 67 69 6f 6e 3d 20 69 .-.=whitespace-cleanup-region=.i
22320 6e 20 3d 65 6d 62 61 72 6b 2d 72 65 67 69 6f 6e 2d 6d 61 70 3d 20 77 61 73 20 6d 6f 76 65 64 20 n.=embark-region-map=.was.moved.
22340 74 6f 20 3d 46 3d 2e 0a 0a 2a 20 56 65 72 73 69 6f 6e 20 30 2e 32 31 2e 31 20 28 32 30 32 30 2d to.=F=...*.Version.0.21.1.(2020-
22360 30 31 2d 33 30 29 0a 2d 20 46 69 6e 61 6c 6c 79 20 73 74 61 72 74 65 64 20 74 68 69 73 20 63 68 01-30).-.Finally.started.this.ch
22380 61 6e 67 65 6c 6f 67 20 6f 6e 20 32 30 32 33 2d 30 34 2d 32 30 2e 20 4b 6e 6f 77 6e 20 69 73 73 angelog.on.2023-04-20..Known.iss
223a0 75 65 73 20 77 69 74 68 20 74 68 65 0a 20 20 63 68 61 6e 67 65 6c 6f 67 3a 20 69 74 20 73 74 61 ues.with.the...changelog:.it.sta
223c0 72 74 65 64 20 76 65 72 79 20 6c 61 74 65 2c 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 20 rted.very.late,.the.first.entry.
223e0 69 73 20 6e 6f 74 20 76 65 72 79 0a 20 20 69 6e 66 6f 72 6d 61 74 69 76 65 2e 0a 00 00 00 00 00 is.not.very...informative.......
22400 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c embark-consult-1.1/embark-consul
22420 74 2e 65 6c 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 t.el............................
22440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
22460 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
22480 30 30 34 35 31 36 33 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 36 32 32 31 00 20 30 00 00 00 0045163.00000000000.016221..0...
224a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
224c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
224e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
22500 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
22520 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
22540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
22560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
22580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
225a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
225c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
225e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
22600 3b 3b 3b 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2e 65 6c 20 2d 2d 2d 20 43 6f 6e 73 75 6c ;;;.embark-consult.el.---.Consul
22620 74 20 69 6e 74 65 67 72 61 74 69 6f 6e 20 66 6f 72 20 45 6d 62 61 72 6b 20 2d 2a 2d 20 6c 65 78 t.integration.for.Embark.-*-.lex
22640 69 63 61 6c 2d 62 69 6e 64 69 6e 67 3a 20 74 3b 20 2d 2a 2d 0a 0a 3b 3b 20 43 6f 70 79 72 69 67 ical-binding:.t;.-*-..;;.Copyrig
22660 68 74 20 28 43 29 20 32 30 32 31 2d 32 30 32 33 20 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 ht.(C).2021-2023..Free.Software.
22680 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e 63 2e 0a 0a 3b 3b 20 41 75 74 68 6f 72 3a 20 4f 6d 61 Foundation,.Inc...;;.Author:.Oma
226a0 72 20 41 6e 74 6f 6c c3 ad 6e 20 43 61 6d 61 72 65 6e 61 20 3c 6f 6d 61 72 40 6d 61 74 65 6d 2e r.Antol..n.Camarena.<omar@matem.
226c0 75 6e 61 6d 2e 6d 78 3e 0a 3b 3b 20 4d 61 69 6e 74 61 69 6e 65 72 3a 20 4f 6d 61 72 20 41 6e 74 unam.mx>.;;.Maintainer:.Omar.Ant
226e0 6f 6c c3 ad 6e 20 43 61 6d 61 72 65 6e 61 20 3c 6f 6d 61 72 40 6d 61 74 65 6d 2e 75 6e 61 6d 2e ol..n.Camarena.<omar@matem.unam.
22700 6d 78 3e 0a 3b 3b 20 4b 65 79 77 6f 72 64 73 3a 20 63 6f 6e 76 65 6e 69 65 6e 63 65 0a 3b 3b 20 mx>.;;.Keywords:.convenience.;;.
22720 56 65 72 73 69 6f 6e 3a 20 31 2e 31 0a 3b 3b 20 48 6f 6d 65 70 61 67 65 3a 20 68 74 74 70 73 3a Version:.1.1.;;.Homepage:.https:
22740 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 0a 3b 3b 20 //github.com/oantolin/embark.;;.
22760 50 61 63 6b 61 67 65 2d 52 65 71 75 69 72 65 73 3a 20 28 28 65 6d 61 63 73 20 22 32 37 2e 31 22 Package-Requires:.((emacs."27.1"
22780 29 20 28 63 6f 6d 70 61 74 20 22 32 39 2e 31 2e 34 2e 30 22 29 20 28 65 6d 62 61 72 6b 20 22 31 ).(compat."29.1.4.0").(embark."1
227a0 2e 30 22 29 20 28 63 6f 6e 73 75 6c 74 20 22 31 2e 30 22 29 29 0a 0a 3b 3b 20 54 68 69 73 20 70 .0").(consult."1.0"))..;;.This.p
227c0 72 6f 67 72 61 6d 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 72 65 3b 20 79 6f 75 20 63 61 6e rogram.is.free.software;.you.can
227e0 20 72 65 64 69 73 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f 6f 72 20 6d 6f 64 69 66 79 0a 3b .redistribute.it.and/or.modify.;
22800 3b 20 69 74 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 47 4e 55 20 ;.it.under.the.terms.of.the.GNU.
22820 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 General.Public.License.as.publis
22840 68 65 64 20 62 79 0a 3b 3b 20 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e hed.by.;;.the.Free.Software.Foun
22860 64 61 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 76 65 72 73 69 6f 6e 20 33 20 6f 66 20 74 68 65 20 dation,.either.version.3.of.the.
22880 4c 69 63 65 6e 73 65 2c 20 6f 72 0a 3b 3b 20 28 61 74 20 79 6f 75 72 20 6f 70 74 69 6f 6e 29 20 License,.or.;;.(at.your.option).
228a0 61 6e 79 20 6c 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 0a 3b 3b 20 54 68 69 73 20 70 72 6f 67 any.later.version...;;.This.prog
228c0 72 61 6d 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74 ram.is.distributed.in.the.hope.t
228e0 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2c 0a 3b 3b 20 62 75 74 20 57 49 hat.it.will.be.useful,.;;.but.WI
22900 54 48 4f 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 3b 20 77 69 74 68 6f 75 74 20 65 76 65 6e THOUT.ANY.WARRANTY;.without.even
22920 20 74 68 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 6e 74 79 20 6f 66 0a 3b 3b 20 4d 45 52 43 .the.implied.warranty.of.;;.MERC
22940 48 41 4e 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e 45 53 53 20 46 4f 52 20 41 20 50 41 52 HANTABILITY.or.FITNESS.FOR.A.PAR
22960 54 49 43 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65 0a 3b 3b 20 47 4e 55 TICULAR.PURPOSE...See.the.;;.GNU
22980 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 .General.Public.License.for.more
229a0 20 64 65 74 61 69 6c 73 2e 0a 0a 3b 3b 20 59 6f 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65 .details...;;.You.should.have.re
229c0 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c ceived.a.copy.of.the.GNU.General
229e0 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 0a 3b 3b 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 .Public.License.;;.along.with.th
22a00 69 73 20 70 72 6f 67 72 61 6d 2e 20 20 49 66 20 6e 6f 74 2c 20 73 65 65 20 3c 68 74 74 70 73 3a is.program...If.not,.see.<https:
22a20 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 63 65 6e 73 65 73 2f 3e 2e 0a 0a 3b 3b 3b 20 43 //www.gnu.org/licenses/>...;;;.C
22a40 6f 6d 6d 65 6e 74 61 72 79 3a 0a 0a 3b 3b 20 54 68 69 73 20 70 61 63 6b 61 67 65 20 70 72 6f 76 ommentary:..;;.This.package.prov
22a60 69 64 65 73 20 69 6e 74 65 67 72 61 74 69 6f 6e 20 62 65 74 77 65 65 6e 20 45 6d 62 61 72 6b 20 ides.integration.between.Embark.
22a80 61 6e 64 20 43 6f 6e 73 75 6c 74 2e 20 20 54 68 65 20 70 61 63 6b 61 67 65 0a 3b 3b 20 77 69 6c and.Consult...The.package.;;.wil
22aa0 6c 20 62 65 20 6c 6f 61 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 45 6d 62 l.be.loaded.automatically.by.Emb
22ac0 61 72 6b 2e 0a 0a 3b 3b 20 53 6f 6d 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 61 6c 69 ark...;;.Some.of.the.functionali
22ae0 74 79 20 68 65 72 65 20 77 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 63 6f 6e 74 61 69 6e 65 64 ty.here.was.previously.contained
22b00 20 69 6e 20 45 6d 62 61 72 6b 0a 3b 3b 20 69 74 73 65 6c 66 3a 0a 0a 3b 3b 20 2d 20 53 75 70 70 .in.Embark.;;.itself:..;;.-.Supp
22b20 6f 72 74 20 66 6f 72 20 63 6f 6e 73 75 6c 74 2d 62 75 66 66 65 72 2c 20 73 6f 20 74 68 61 74 20 ort.for.consult-buffer,.so.that.
22b40 79 6f 75 20 67 65 74 20 74 68 65 20 63 6f 72 72 65 63 74 20 61 63 74 69 6f 6e 73 0a 3b 3b 20 66 you.get.the.correct.actions.;;.f
22b60 6f 72 20 65 61 63 68 20 74 79 70 65 20 6f 66 20 65 6e 74 72 79 20 69 6e 20 63 6f 6e 73 75 6c 74 or.each.type.of.entry.in.consult
22b80 2d 62 75 66 66 65 72 27 73 20 6c 69 73 74 2e 0a 0a 3b 3b 20 2d 20 53 75 70 70 6f 72 74 20 66 6f -buffer's.list...;;.-.Support.fo
22ba0 72 20 63 6f 6e 73 75 6c 74 2d 6c 69 6e 65 2c 20 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 2c r.consult-line,.consult-outline,
22bc0 20 63 6f 6e 73 75 6c 74 2d 6d 61 72 6b 20 61 6e 64 0a 3b 3b 20 63 6f 6e 73 75 6c 74 2d 67 6c 6f .consult-mark.and.;;.consult-glo
22be0 62 61 6c 2d 6d 61 72 6b 2c 20 73 6f 20 74 68 61 74 20 74 68 65 20 69 6e 73 65 72 74 20 61 6e 64 bal-mark,.so.that.the.insert.and
22c00 20 73 61 76 65 20 61 63 74 69 6f 6e 73 20 64 6f 6e 27 74 0a 3b 3b 20 69 6e 63 6c 75 64 65 20 61 .save.actions.don't.;;.include.a
22c20 20 77 65 69 72 64 20 75 6e 69 63 6f 64 65 20 63 68 61 72 61 63 74 65 72 20 61 74 20 74 68 65 20 .weird.unicode.character.at.the.
22c40 73 74 61 72 74 20 6f 66 20 74 68 65 20 6c 69 6e 65 2c 20 61 6e 64 20 73 6f 0a 3b 3b 20 79 6f 75 start.of.the.line,.and.so.;;.you
22c60 20 63 61 6e 20 65 78 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 6d 20 74 6f 20 61 6e 20 6f 63 63 75 .can.export.from.them.to.an.occu
22c80 72 20 62 75 66 66 65 72 20 28 77 68 65 72 65 20 6f 63 63 75 72 2d 65 64 69 74 2d 6d 6f 64 65 0a r.buffer.(where.occur-edit-mode.
22ca0 3b 3b 20 77 6f 72 6b 73 21 29 2e 0a 0a 3b 3b 20 4a 75 73 74 20 6c 6f 61 64 20 74 68 69 73 20 70 ;;.works!)...;;.Just.load.this.p
22cc0 61 63 6b 61 67 65 20 74 6f 20 67 65 74 20 74 68 65 20 61 62 6f 76 65 20 66 75 6e 63 74 69 6f 6e ackage.to.get.the.above.function
22ce0 61 6c 69 74 79 2c 20 6e 6f 20 66 75 72 74 68 65 72 0a 3b 3b 20 63 6f 6e 66 69 67 75 72 61 74 69 ality,.no.further.;;.configurati
22d00 6f 6e 20 69 73 20 6e 65 63 65 73 73 61 72 79 2e 0a 0a 3b 3b 20 41 64 64 69 74 69 6f 6e 61 6c 6c on.is.necessary...;;.Additionall
22d20 79 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 66 75 6e y.this.package.contains.some.fun
22d40 63 74 69 6f 6e 61 6c 69 74 79 20 74 68 61 74 20 68 61 73 0a 3b 3b 20 6e 65 76 65 72 20 62 65 65 ctionality.that.has.;;.never.bee
22d60 6e 20 69 6e 20 45 6d 62 61 72 6b 3a 20 61 63 63 65 73 73 20 74 6f 20 43 6f 6e 73 75 6c 74 20 70 n.in.Embark:.access.to.Consult.p
22d80 72 65 76 69 65 77 20 66 72 6f 6d 20 61 75 74 6f 2d 75 70 64 61 74 69 6e 67 0a 3b 3b 20 45 6d 62 review.from.auto-updating.;;.Emb
22da0 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 20 74 68 61 74 20 69 73 20 61 73 73 6f 63 ark.Collect.buffer.that.is.assoc
22dc0 69 61 74 65 64 20 74 6f 20 61 6e 20 61 63 74 69 76 65 20 6d 69 6e 69 62 75 66 66 65 72 0a 3b 3b iated.to.an.active.minibuffer.;;
22de0 20 66 6f 72 20 61 20 43 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 46 6f 72 20 69 6e 66 .for.a.Consult.command...For.inf
22e00 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 43 6f 6e 73 75 6c 74 20 70 72 65 76 69 65 77 2c 20 73 65 65 ormation.on.Consult.preview,.see
22e20 0a 3b 3b 20 43 6f 6e 73 75 6c 74 27 73 20 69 6e 66 6f 20 6d 61 6e 75 61 6c 20 6f 72 20 69 74 73 .;;.Consult's.info.manual.or.its
22e40 20 72 65 61 64 6d 65 20 6f 6e 20 47 69 74 48 75 62 2e 0a 0a 3b 3b 20 49 66 20 79 6f 75 20 61 6c .readme.on.GitHub...;;.If.you.al
22e60 77 61 79 73 20 77 61 6e 74 20 74 68 65 20 6d 69 6e 6f 72 20 6d 6f 64 65 20 65 6e 61 62 6c 65 64 ways.want.the.minor.mode.enabled
22e80 20 77 68 65 6e 65 76 65 72 20 69 74 20 70 6f 73 73 69 62 6c 65 20 75 73 65 3a 0a 0a 3b 3b 20 28 .whenever.it.possible.use:..;;.(
22ea0 61 64 64 2d 68 6f 6f 6b 20 27 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 2d 6d 6f 64 65 2d 68 6f add-hook.'embark-collect-mode-ho
22ec0 6f 6b 20 23 27 63 6f 6e 73 75 6c 74 2d 70 72 65 76 69 65 77 2d 61 74 2d 70 6f 69 6e 74 2d 6d 6f ok.#'consult-preview-at-point-mo
22ee0 64 65 29 0a 0a 3b 3b 20 49 66 20 79 6f 75 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 68 65 20 6d 69 de)..;;.If.you.don't.want.the.mi
22f00 6e 6f 72 20 6d 6f 64 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 6e 20 61 6e 64 20 70 72 nor.mode.automatically.on.and.pr
22f20 65 66 65 72 20 74 6f 0a 3b 3b 20 74 72 69 67 67 65 72 20 74 68 65 20 63 6f 6e 73 75 6c 74 20 70 efer.to.;;.trigger.the.consult.p
22f40 72 65 76 69 65 77 73 20 6d 61 6e 75 61 6c 6c 79 20 75 73 65 20 74 68 69 73 20 69 6e 73 74 65 61 reviews.manually.use.this.instea
22f60 64 3a 0a 0a 3b 3b 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 d:..;;.(keymap-set.embark-collec
22f80 74 2d 6d 6f 64 65 2d 6d 61 70 20 22 43 2d 6a 22 0a 3b 3b 20 20 20 23 27 63 6f 6e 73 75 6c 74 2d t-mode-map."C-j".;;...#'consult-
22fa0 70 72 65 76 69 65 77 2d 61 74 2d 70 6f 69 6e 74 29 0a 0a 3b 3b 3b 20 43 6f 64 65 3a 0a 0a 28 72 preview-at-point)..;;;.Code:..(r
22fc0 65 71 75 69 72 65 20 27 65 6d 62 61 72 6b 29 0a 28 72 65 71 75 69 72 65 20 27 63 6f 6e 73 75 6c equire.'embark).(require.'consul
22fe0 74 29 0a 0a 28 65 76 61 6c 2d 77 68 65 6e 2d 63 6f 6d 70 69 6c 65 0a 20 20 28 72 65 71 75 69 72 t)..(eval-when-compile...(requir
23000 65 20 27 63 6c 2d 6c 69 62 29 29 0a 0a 3b 3b 3b 20 43 6f 6e 73 75 6c 74 20 70 72 65 76 69 65 77 e.'cl-lib))..;;;.Consult.preview
23020 20 66 72 6f 6d 20 45 6d 62 61 72 6b 20 43 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 73 0a 0a 28 64 .from.Embark.Collect.buffers..(d
23040 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 63 6f 6c 6c 65 63 74 2d 63 61 6e efun.embark-consult--collect-can
23060 64 69 64 61 74 65 20 28 29 0a 20 20 22 52 65 74 75 72 6e 20 63 61 6e 64 69 64 61 74 65 20 61 74 didate.()..."Return.candidate.at
23080 20 70 6f 69 6e 74 20 69 6e 20 63 6f 6c 6c 65 63 74 20 62 75 66 66 65 72 2e 22 0a 20 20 28 63 61 .point.in.collect.buffer."...(ca
230a0 64 72 20 28 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 63 6f 6c 6c 65 63 74 2d 63 61 6e 64 69 64 dr.(embark-target-collect-candid
230c0 61 74 65 29 29 29 0a 0a 28 61 64 64 2d 68 6f 6f 6b 20 27 63 6f 6e 73 75 6c 74 2d 2d 63 6f 6d 70 ate)))..(add-hook.'consult--comp
230e0 6c 65 74 69 6f 6e 2d 63 61 6e 64 69 64 61 74 65 2d 68 6f 6f 6b 20 23 27 65 6d 62 61 72 6b 2d 63 letion-candidate-hook.#'embark-c
23100 6f 6e 73 75 6c 74 2d 2d 63 6f 6c 6c 65 63 74 2d 63 61 6e 64 69 64 61 74 65 29 0a 0a 3b 3b 3b 20 onsult--collect-candidate)..;;;.
23120 53 75 70 70 6f 72 74 20 66 6f 72 20 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 0a 0a 28 64 Support.for.consult-location..(d
23140 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 73 74 72 69 70 20 28 73 74 72 69 efun.embark-consult--strip.(stri
23160 6e 67 29 0a 20 20 22 53 74 72 69 70 20 73 75 62 73 74 72 69 6e 67 73 20 6d 61 72 6b 65 64 20 77 ng)..."Strip.substrings.marked.w
23180 69 74 68 20 74 68 65 20 60 63 6f 6e 73 75 6c 74 2d 73 74 72 69 70 27 20 70 72 6f 70 65 72 74 79 ith.the.`consult-strip'.property
231a0 20 66 72 6f 6d 20 53 54 52 49 4e 47 2e 22 0a 20 20 28 69 66 20 28 74 65 78 74 2d 70 72 6f 70 65 .from.STRING."...(if.(text-prope
231c0 72 74 79 2d 6e 6f 74 2d 61 6c 6c 20 30 20 28 6c 65 6e 67 74 68 20 73 74 72 69 6e 67 29 20 27 63 rty-not-all.0.(length.string).'c
231e0 6f 6e 73 75 6c 74 2d 73 74 72 69 70 20 6e 69 6c 20 73 74 72 69 6e 67 29 0a 20 20 20 20 20 20 28 onsult-strip.nil.string).......(
23200 6c 65 74 20 28 28 65 6e 64 20 28 6c 65 6e 67 74 68 20 73 74 72 69 6e 67 29 29 20 28 70 6f 73 20 let.((end.(length.string)).(pos.
23220 30 29 20 28 63 68 75 6e 6b 73 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 69 6c 65 20 28 3c 20 70 0).(chunks)).........(while.(<.p
23240 6f 73 20 65 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6e 65 78 74 20 28 6e os.end)...........(let.((next.(n
23260 65 78 74 2d 73 69 6e 67 6c 65 2d 70 72 6f 70 65 72 74 79 2d 63 68 61 6e 67 65 20 70 6f 73 20 27 ext-single-property-change.pos.'
23280 63 6f 6e 73 75 6c 74 2d 73 74 72 69 70 20 73 74 72 69 6e 67 20 65 6e 64 29 29 29 0a 20 20 20 20 consult-strip.string.end))).....
232a0 20 20 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 ........(unless.(get-text-proper
232c0 74 79 20 70 6f 73 20 27 63 6f 6e 73 75 6c 74 2d 73 74 72 69 70 20 73 74 72 69 6e 67 29 0a 20 20 ty.pos.'consult-strip.string)...
232e0 20 20 20 20 20 20 20 20 20 20 20 20 28 70 75 73 68 20 28 73 75 62 73 74 72 69 6e 67 20 73 74 72 ............(push.(substring.str
23300 69 6e 67 20 70 6f 73 20 6e 65 78 74 29 20 63 68 75 6e 6b 73 29 29 0a 20 20 20 20 20 20 20 20 20 ing.pos.next).chunks))..........
23320 20 20 20 28 73 65 74 71 20 70 6f 73 20 6e 65 78 74 29 29 29 0a 20 20 20 20 20 20 20 20 28 61 70 ...(setq.pos.next))).........(ap
23340 70 6c 79 20 23 27 63 6f 6e 63 61 74 20 28 6e 72 65 76 65 72 73 65 20 63 68 75 6e 6b 73 29 29 29 ply.#'concat.(nreverse.chunks)))
23360 0a 20 20 20 20 73 74 72 69 6e 67 29 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e .....string))..(defun.embark-con
23380 73 75 6c 74 2d 2d 74 61 72 67 65 74 2d 73 74 72 69 70 20 28 74 79 70 65 20 74 61 72 67 65 74 29 sult--target-strip.(type.target)
233a0 0a 20 20 22 52 65 6d 6f 76 65 20 74 68 65 20 75 6e 69 63 6f 64 65 20 73 75 66 66 69 78 20 63 68 ..."Remove.the.unicode.suffix.ch
233c0 61 72 61 63 74 65 72 20 66 72 6f 6d 20 61 20 54 41 52 47 45 54 20 6f 66 20 54 59 50 45 2e 22 0a aracter.from.a.TARGET.of.TYPE.".
233e0 20 20 28 63 6f 6e 73 20 74 79 70 65 20 28 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 73 74 ..(cons.type.(embark-consult--st
23400 72 69 70 20 74 61 72 67 65 74 29 29 29 0a 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 rip.target)))..(setf.(alist-get.
23420 27 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 20 65 6d 62 61 72 6b 2d 74 72 61 6e 73 66 6f 'consult-location.embark-transfo
23440 72 6d 65 72 2d 61 6c 69 73 74 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 rmer-alist).......#'embark-consu
23460 6c 74 2d 2d 74 61 72 67 65 74 2d 73 74 72 69 70 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b lt--target-strip)..(defun.embark
23480 2d 63 6f 6e 73 75 6c 74 2d 67 6f 74 6f 2d 6c 6f 63 61 74 69 6f 6e 20 28 74 61 72 67 65 74 29 0a -consult-goto-location.(target).
234a0 20 20 22 4a 75 6d 70 20 74 6f 20 63 6f 6e 73 75 6c 74 20 6c 6f 63 61 74 69 6f 6e 20 54 41 52 47 .."Jump.to.consult.location.TARG
234c0 45 54 2e 22 0a 20 20 28 63 6f 6e 73 75 6c 74 2d 2d 6a 75 6d 70 20 28 63 61 72 20 28 63 6f 6e 73 ET."...(consult--jump.(car.(cons
234e0 75 6c 74 2d 2d 67 65 74 2d 6c 6f 63 61 74 69 6f 6e 20 74 61 72 67 65 74 29 29 29 0a 20 20 28 70 ult--get-location.target)))...(p
23500 75 6c 73 65 2d 6d 6f 6d 65 6e 74 61 72 79 2d 68 69 67 68 6c 69 67 68 74 2d 6f 6e 65 2d 6c 69 6e ulse-momentary-highlight-one-lin
23520 65 20 28 70 6f 69 6e 74 29 29 29 0a 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 e.(point)))..(setf.(alist-get.'c
23540 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 20 65 6d 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 onsult-location.embark-default-a
23560 63 74 69 6f 6e 2d 6f 76 65 72 72 69 64 65 73 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d ction-overrides).......#'embark-
23580 63 6f 6e 73 75 6c 74 2d 67 6f 74 6f 2d 6c 6f 63 61 74 69 6f 6e 29 0a 0a 28 64 65 66 75 6e 20 65 consult-goto-location)..(defun.e
235a0 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 70 6f 72 74 2d 6c 6f 63 61 74 69 6f 6e 2d 6f 63 mbark-consult-export-location-oc
235c0 63 75 72 20 28 6c 69 6e 65 73 29 0a 20 20 22 43 72 65 61 74 65 20 61 6e 20 6f 63 63 75 72 20 6d cur.(lines)..."Create.an.occur.m
235e0 6f 64 65 20 62 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 4c 49 4e 45 53 2e 0a 54 68 65 20 65 6c ode.buffer.listing.LINES..The.el
23600 65 6d 65 6e 74 73 20 6f 66 20 4c 49 4e 45 53 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6d 70 6c 65 ements.of.LINES.should.be.comple
23620 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 77 69 74 68 0a 63 61 74 65 67 6f 72 79 20 60 63 tion.candidates.with.category.`c
23640 6f 6e 73 75 6c 74 2d 6c 69 6e 65 27 2e 22 0a 20 20 28 6c 65 74 20 28 28 62 75 66 20 28 67 65 6e onsult-line'."...(let.((buf.(gen
23660 65 72 61 74 65 2d 6e 65 77 2d 62 75 66 66 65 72 20 22 2a 45 6d 62 61 72 6b 20 45 78 70 6f 72 74 erate-new-buffer."*Embark.Export
23680 20 4f 63 63 75 72 2a 22 29 29 0a 20 20 20 20 20 20 20 20 28 6d 6f 75 73 65 2d 6d 73 67 20 22 6d .Occur*")).........(mouse-msg."m
236a0 6f 75 73 65 2d 32 3a 20 67 6f 20 74 6f 20 74 68 69 73 20 6f 63 63 75 72 72 65 6e 63 65 22 29 0a ouse-2:.go.to.this.occurrence").
236c0 20 20 20 20 20 20 20 20 28 69 6e 68 69 62 69 74 2d 72 65 61 64 2d 6f 6e 6c 79 20 74 29 0a 20 20 ........(inhibit-read-only.t)...
236e0 20 20 20 20 20 20 6c 61 73 74 2d 62 75 66 29 0a 20 20 20 20 28 77 69 74 68 2d 63 75 72 72 65 6e ......last-buf).....(with-curren
23700 74 2d 62 75 66 66 65 72 20 62 75 66 0a 20 20 20 20 20 20 28 64 6f 6c 69 73 74 20 28 6c 69 6e 65 t-buffer.buf.......(dolist.(line
23720 20 6c 69 6e 65 73 29 0a 20 20 20 20 20 20 20 20 28 70 63 61 73 65 2d 6c 65 74 2a 0a 20 20 20 20 .lines).........(pcase-let*.....
23740 20 20 20 20 20 20 20 20 28 28 60 28 2c 6c 6f 63 20 2e 20 2c 6e 75 6d 29 20 28 63 6f 6e 73 75 6c ........((`(,loc...,num).(consul
23760 74 2d 2d 67 65 74 2d 6c 6f 63 61 74 69 6f 6e 20 6c 69 6e 65 29 29 0a 20 20 20 20 20 20 20 20 20 t--get-location.line))..........
23780 20 20 20 20 3b 3b 20 74 68 65 20 74 65 78 74 20 70 72 6f 70 65 72 74 69 65 73 20 61 64 64 65 64 ....;;.the.text.properties.added
237a0 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 69 6e 67 73 20 61 72 65 0a 20 20 .to.the.following.strings.are...
237c0 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 74 61 6b 65 6e 20 66 72 6f 6d 20 6f 63 63 75 72 2d 65 ...........;;.taken.from.occur-e
237e0 6e 67 69 6e 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 6e 6f 20 28 70 72 6f 70 ngine..............(lineno.(prop
23800 65 72 74 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f ertize.......................(fo
23820 72 6d 61 74 20 22 25 37 64 3a 22 20 6e 75 6d 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rmat."%7d:".num)................
23840 20 20 20 20 20 20 20 27 6f 63 63 75 72 2d 70 72 65 66 69 78 20 74 0a 20 20 20 20 20 20 20 20 20 .......'occur-prefix.t..........
23860 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 41 6c 6c 6f 77 20 69 6e 73 65 72 74 69 6f 6e 20 .............;;.Allow.insertion.
23880 6f 66 20 74 65 78 74 20 61 74 20 74 68 65 20 65 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 of.text.at.the.end..............
238a0 20 20 20 20 20 20 20 20 20 3b 3b 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 28 66 6f 72 20 4f .........;;.of.the.prefix.(for.O
238c0 63 63 75 72 20 45 64 69 74 20 6d 6f 64 65 29 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ccur.Edit.mode).................
238e0 20 20 20 20 20 20 20 27 66 72 6f 6e 74 2d 73 74 69 63 6b 79 20 74 0a 20 20 20 20 20 20 20 20 20 .......'front-sticky.t..........
23900 20 20 20 20 20 20 20 20 20 20 20 20 20 27 72 65 61 72 2d 6e 6f 6e 73 74 69 63 6b 79 20 74 0a 20 .............'rear-nonsticky.t..
23920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 72 65 61 64 2d 6f 6e 6c 79 20 .....................'read-only.
23940 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 6f 63 63 75 72 2d 74 t.......................'occur-t
23960 61 72 67 65 74 20 6c 6f 63 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 arget.loc.......................
23980 27 66 6f 6c 6c 6f 77 2d 6c 69 6e 6b 20 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 'follow-link.t..................
239a0 20 20 20 20 20 27 68 65 6c 70 2d 65 63 68 6f 20 6d 6f 75 73 65 2d 6d 73 67 0a 20 20 20 20 20 20 .....'help-echo.mouse-msg.......
239c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 6f 6e 74 2d 6c 6f 63 6b 2d 66 61 63 65 20 ................'font-lock-face.
239e0 6c 69 73 74 2d 6d 61 74 63 68 69 6e 67 2d 6c 69 6e 65 73 2d 70 72 65 66 69 78 2d 66 61 63 65 0a list-matching-lines-prefix-face.
23a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 6d 6f 75 73 65 2d 66 61 63 ......................'mouse-fac
23a20 65 20 27 68 69 67 68 6c 69 67 68 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e e.'highlight))..............(con
23a40 74 65 6e 74 73 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c tents.(propertize.(embark-consul
23a60 74 2d 2d 73 74 72 69 70 20 6c 69 6e 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t--strip.line)..................
23a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 6f 63 63 75 72 2d 74 61 72 67 65 74 20 ..................'occur-target.
23aa0 6c 6f 63 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 loc.............................
23ac0 20 20 20 20 20 20 20 27 6f 63 63 75 72 2d 6d 61 74 63 68 20 74 0a 20 20 20 20 20 20 20 20 20 20 .......'occur-match.t...........
23ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 6f 6c 6c 6f 77 .........................'follow
23b00 2d 6c 69 6e 6b 20 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -link.t.........................
23b20 20 20 20 20 20 20 20 20 20 20 20 27 68 65 6c 70 2d 65 63 68 6f 20 6d 6f 75 73 65 2d 6d 73 67 0a ...........'help-echo.mouse-msg.
23b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ................................
23b60 20 20 20 27 6d 6f 75 73 65 2d 66 61 63 65 20 27 68 69 67 68 6c 69 67 68 74 29 29 0a 20 20 20 20 ...'mouse-face.'highlight)).....
23b80 20 20 20 20 20 20 20 20 20 28 6e 6c 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 5c 6e 22 20 27 6f .........(nl.(propertize."\n".'o
23ba0 63 63 75 72 2d 74 61 72 67 65 74 20 6c 6f 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 ccur-target.loc))..............(
23bc0 74 68 69 73 2d 62 75 66 20 28 6d 61 72 6b 65 72 2d 62 75 66 66 65 72 20 6c 6f 63 29 29 29 0a 20 this-buf.(marker-buffer.loc)))..
23be0 20 20 20 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 65 71 20 74 68 69 73 2d 62 75 66 20 6c 61 .........(unless.(eq.this-buf.la
23c00 73 74 2d 62 75 66 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 28 70 72 6f st-buf).............(insert.(pro
23c20 70 65 72 74 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f pertize......................(fo
23c40 72 6d 61 74 20 22 6c 69 6e 65 73 20 66 72 6f 6d 20 62 75 66 66 65 72 3a 20 25 73 5c 6e 22 20 74 rmat."lines.from.buffer:.%s\n".t
23c60 68 69 73 2d 62 75 66 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 his-buf)......................'f
23c80 61 63 65 20 6c 69 73 74 2d 6d 61 74 63 68 69 6e 67 2d 6c 69 6e 65 73 2d 62 75 66 66 65 72 2d 6e ace.list-matching-lines-buffer-n
23ca0 61 6d 65 2d 66 61 63 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 72 ame-face......................'r
23cc0 65 61 64 2d 6f 6e 6c 79 20 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 6c ead-only.t)).............(setq.l
23ce0 61 73 74 2d 62 75 66 20 74 68 69 73 2d 62 75 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 69 6e ast-buf.this-buf))...........(in
23d00 73 65 72 74 20 6c 69 6e 65 6e 6f 20 63 6f 6e 74 65 6e 74 73 20 6e 6c 29 29 29 0a 20 20 20 20 20 sert.lineno.contents.nl)))......
23d20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 70 6f 69 6e 74 2d 6d 69 6e 29 29 0a 20 20 20 20 20 20 28 .(goto-char.(point-min)).......(
23d40 6f 63 63 75 72 2d 6d 6f 64 65 29 29 0a 20 20 20 20 28 70 6f 70 2d 74 6f 2d 62 75 66 66 65 72 20 occur-mode)).....(pop-to-buffer.
23d60 62 75 66 29 29 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 buf)))..(defun.embark-consult-ex
23d80 70 6f 72 74 2d 6c 6f 63 61 74 69 6f 6e 2d 67 72 65 70 20 28 6c 69 6e 65 73 29 0a 20 20 22 43 72 port-location-grep.(lines)..."Cr
23da0 65 61 74 65 20 61 20 67 72 65 70 20 6d 6f 64 65 20 62 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 eate.a.grep.mode.buffer.listing.
23dc0 4c 49 4e 45 53 2e 0a 41 6e 79 20 4c 49 4e 45 53 20 74 68 61 74 20 63 6f 6d 65 20 66 72 6f 6d 20 LINES..Any.LINES.that.come.from.
23de0 61 20 62 75 66 66 65 72 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 76 69 73 69 74 69 6e 67 20 61 a.buffer.which.is.not.visiting.a
23e00 20 66 69 6c 65 0a 77 69 6c 6c 20 62 65 20 65 78 63 6c 75 64 65 64 20 66 72 6f 6d 20 74 68 65 20 .file.will.be.excluded.from.the.
23e20 67 72 65 70 20 62 75 66 66 65 72 2c 20 73 69 6e 63 65 20 67 72 65 70 20 6d 6f 64 65 20 6f 6e 6c grep.buffer,.since.grep.mode.onl
23e40 79 20 77 6f 72 6b 73 0a 77 69 74 68 20 66 69 6c 65 73 2e 20 20 54 68 65 20 65 6c 65 6d 65 6e 74 y.works.with.files...The.element
23e60 73 20 6f 66 20 4c 49 4e 45 53 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 0a s.of.LINES.should.be.completion.
23e80 63 61 6e 64 69 64 61 74 65 73 20 77 69 74 68 20 63 61 74 65 67 6f 72 79 20 60 63 6f 6e 73 75 6c candidates.with.category.`consul
23ea0 74 2d 6c 6f 63 61 74 69 6f 6e 27 2e 20 20 4e 6f 20 6d 61 74 63 68 65 73 20 77 69 6c 6c 20 62 65 t-location'...No.matches.will.be
23ec0 0a 68 69 67 68 6c 69 67 68 74 65 64 20 69 6e 20 74 68 65 20 65 78 70 6f 72 74 65 64 20 62 75 66 .highlighted.in.the.exported.buf
23ee0 66 65 72 2c 20 73 69 6e 63 65 20 74 68 65 20 60 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e fer,.since.the.`consult-location
23f00 27 0a 63 61 6e 64 69 64 61 74 65 73 20 64 6f 20 6e 6f 74 20 63 61 72 72 79 20 74 68 61 74 20 69 '.candidates.do.not.carry.that.i
23f20 6e 66 6f 72 6d 61 74 69 6f 6e 2e 22 0a 20 20 28 6c 65 74 20 28 6e 6f 6e 2d 66 69 6c 65 2d 62 75 nformation."...(let.(non-file-bu
23f40 66 66 65 72 73 29 0a 20 20 20 20 28 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 65 78 70 6f ffers).....(embark-consult--expo
23f60 72 74 2d 67 72 65 70 0a 20 20 20 20 20 3a 68 65 61 64 65 72 20 22 45 78 70 6f 72 74 65 64 20 6c rt-grep......:header."Exported.l
23f80 69 6e 65 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 20 28 66 69 6c 65 2d 62 61 63 6b 65 64 20 ine.search.results.(file-backed.
23fa0 62 75 66 66 65 72 73 20 6f 6e 6c 79 29 3a 5c 6e 5c 6e 22 0a 20 20 20 20 20 3a 6c 69 6e 65 73 20 buffers.only):\n\n"......:lines.
23fc0 6c 69 6e 65 73 0a 20 20 20 20 20 3a 69 6e 73 65 72 74 0a 20 20 20 20 20 28 6c 61 6d 62 64 61 20 lines......:insert......(lambda.
23fe0 28 6c 69 6e 65 73 29 0a 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 63 6f 75 6e 74 20 30 29 29 0a (lines)........(let.((count.0)).
24000 20 20 20 20 20 20 20 20 20 28 64 6f 6c 69 73 74 20 28 6c 69 6e 65 20 6c 69 6e 65 73 29 0a 20 20 .........(dolist.(line.lines)...
24020 20 20 20 20 20 20 20 20 20 28 70 63 61 73 65 2d 6c 65 74 2a 20 28 28 60 28 2c 6c 6f 63 20 2e 20 .........(pcase-let*.((`(,loc...
24040 2c 6e 75 6d 29 20 28 63 6f 6e 73 75 6c 74 2d 2d 67 65 74 2d 6c 6f 63 61 74 69 6f 6e 20 6c 69 6e ,num).(consult--get-location.lin
24060 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e e)).........................(lin
24080 65 6e 6f 20 28 66 6f 72 6d 61 74 20 22 25 64 22 20 6e 75 6d 29 29 0a 20 20 20 20 20 20 20 20 20 eno.(format."%d".num))..........
240a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 74 65 6e 74 73 20 28 65 6d 62 61 72 6b ...............(contents.(embark
240c0 2d 63 6f 6e 73 75 6c 74 2d 2d 73 74 72 69 70 20 6c 69 6e 65 29 29 0a 20 20 20 20 20 20 20 20 20 -consult--strip.line))..........
240e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 62 75 66 66 65 72 20 28 6d 61 72 6b 65 72 2d 62 ...............(buffer.(marker-b
24100 75 66 66 65 72 20 6c 6f 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 uffer.loc)).....................
24120 20 20 20 20 28 66 69 6c 65 20 28 62 75 66 66 65 72 2d 66 69 6c 65 2d 6e 61 6d 65 20 62 75 66 66 ....(file.(buffer-file-name.buff
24140 65 72 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 6e 75 6c 6c 20 66 69 6c er)))..............(if.(null.fil
24160 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6c 2d 70 75 73 68 6e 65 77 20 e)..................(cl-pushnew.
24180 62 75 66 66 65 72 20 6e 6f 6e 2d 66 69 6c 65 2d 62 75 66 66 65 72 73 29 0a 20 20 20 20 20 20 20 buffer.non-file-buffers)........
241a0 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 28 66 69 6c 65 2d 72 65 6c 61 74 69 76 65 2d 6e ........(insert.(file-relative-n
241c0 61 6d 65 20 66 69 6c 65 29 20 22 3a 22 20 6c 69 6e 65 6e 6f 20 22 3a 22 20 63 6f 6e 74 65 6e 74 ame.file).":".lineno.":".content
241e0 73 20 22 5c 6e 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6c 2d 69 6e 63 66 20 s."\n")................(cl-incf.
24200 63 6f 75 6e 74 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 63 6f 75 6e 74 29 29 0a 20 20 20 20 20 count))))..........count))......
24220 3a 66 6f 6f 74 65 72 0a 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 20 20 20 20 20 20 28 :footer......(lambda.()........(
24240 77 68 65 6e 20 6e 6f 6e 2d 66 69 6c 65 2d 62 75 66 66 65 72 73 0a 20 20 20 20 20 20 20 20 20 28 when.non-file-buffers..........(
24260 6c 65 74 20 28 28 73 74 61 72 74 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 70 6f 69 6e 74 2d 6d 61 let.((start.(goto-char.(point-ma
24280 78 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 22 5c 6e 53 6f 6d 65 x))))............(insert."\nSome
242a0 20 72 65 73 75 6c 74 73 20 77 65 72 65 20 69 6e 20 62 75 66 66 65 72 73 20 77 69 74 68 20 6e 6f .results.were.in.buffers.with.no
242c0 20 61 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .associated.file"...............
242e0 20 20 20 20 20 22 20 61 6e 64 20 61 72 65 20 6d 69 73 73 69 6e 67 5c 6e 66 72 6f 6d 20 74 68 65 .....".and.are.missing\nfrom.the
24300 20 65 78 70 6f 72 74 65 64 20 72 65 73 75 6c 74 3a 5c 6e 22 29 0a 20 20 20 20 20 20 20 20 20 20 .exported.result:\n")...........
24320 20 28 64 6f 6c 69 73 74 20 28 62 75 66 20 6e 6f 6e 2d 66 69 6c 65 2d 62 75 66 66 65 72 73 29 0a .(dolist.(buf.non-file-buffers).
24340 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 22 2d 20 22 20 28 62 75 66 66 65 .............(insert."-.".(buffe
24360 72 2d 6e 61 6d 65 20 62 75 66 29 20 22 5c 6e 22 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 r-name.buf)."\n"))............(i
24380 6e 73 65 72 74 20 22 5c 6e 45 69 74 68 65 72 20 73 61 76 65 20 74 68 65 20 62 75 66 66 65 72 73 nsert."\nEither.save.the.buffers
243a0 20 6f 72 20 75 73 65 20 74 68 65 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .or.use.the"....................
243c0 22 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 70 6f 72 74 2d 6c 6f 63 61 74 69 6f ".`embark-consult-export-locatio
243e0 6e 2d 6f 63 63 75 72 27 5c 6e 65 78 70 6f 72 74 65 72 2e 22 29 0a 20 20 20 20 20 20 20 20 20 20 n-occur'\nexporter.")...........
24400 20 28 6d 65 73 73 61 67 65 20 22 54 68 69 73 20 65 78 70 6f 72 74 65 72 20 64 6f 65 73 20 6e 6f .(message."This.exporter.does.no
24420 74 20 73 75 70 70 6f 72 74 20 6e 6f 6e 2d 66 69 6c 65 20 62 75 66 66 65 72 73 3a 20 25 73 22 0a t.support.non-file.buffers:.%s".
24440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f 6e 2d 66 69 6c 65 2d 62 75 66 ....................non-file-buf
24460 66 65 72 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 61 64 64 2d 74 65 78 74 2d 70 72 6f 70 65 fers)............(add-text-prope
24480 72 74 69 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 74 61 72 74 20 28 70 6f 69 6e 74 2d 6d rties.............start.(point-m
244a0 61 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 27 28 72 65 61 64 2d 6f 6e 6c 79 20 74 20 77 67 ax).............'(read-only.t.wg
244c0 72 65 70 2d 66 6f 6f 74 65 72 20 74 20 66 72 6f 6e 74 2d 73 74 69 63 6b 79 20 74 29 29 29 29 29 rep-footer.t.front-sticky.t)))))
244e0 29 29 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 75 70 67 72 )))..(defun.embark-consult--upgr
24500 61 64 65 2d 6d 61 72 6b 65 72 73 20 28 29 0a 20 20 22 55 70 67 72 61 64 65 20 63 6f 6e 73 75 6c ade-markers.()..."Upgrade.consul
24520 74 2d 6c 6f 63 61 74 69 6f 6e 20 63 68 65 61 70 20 6d 61 72 6b 65 72 73 20 74 6f 20 72 65 61 6c t-location.cheap.markers.to.real
24540 20 6d 61 72 6b 65 72 73 2e 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6d 65 61 6e 74 .markers..This.function.is.meant
24560 20 74 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20 60 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 2d .to.be.added.to.`embark-collect-
24580 6d 6f 64 65 2d 68 6f 6f 6b 27 2e 22 0a 20 20 28 77 68 65 6e 20 28 65 71 20 65 6d 62 61 72 6b 2d mode-hook'."...(when.(eq.embark-
245a0 2d 74 79 70 65 20 27 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 29 0a 20 20 20 20 28 64 6f -type.'consult-location).....(do
245c0 6c 69 73 74 20 28 65 6e 74 72 79 20 74 61 62 75 6c 61 74 65 64 2d 6c 69 73 74 2d 65 6e 74 72 69 list.(entry.tabulated-list-entri
245e0 65 73 29 0a 20 20 20 20 20 20 28 77 68 65 6e 20 28 63 61 72 20 65 6e 74 72 79 29 0a 20 20 20 20 es).......(when.(car.entry).....
24600 20 20 20 20 28 63 6f 6e 73 75 6c 74 2d 2d 67 65 74 2d 6c 6f 63 61 74 69 6f 6e 20 28 63 61 72 20 ....(consult--get-location.(car.
24620 65 6e 74 72 79 29 29 29 29 29 29 0a 0a 3b 3b 20 53 65 74 20 64 65 66 61 75 6c 74 20 60 6f 63 63 entry))))))..;;.Set.default.`occ
24640 75 72 2d 6d 6f 64 65 27 20 62 61 73 65 64 20 65 78 70 6f 72 74 65 72 20 66 6f 72 20 63 6f 6e 73 ur-mode'.based.exporter.for.cons
24660 75 6c 74 2d 6c 69 6e 65 2c 0a 3b 3b 20 63 6f 6e 73 75 6c 74 2d 6c 69 6e 65 2d 6d 75 6c 74 69 2c ult-line,.;;.consult-line-multi,
24680 20 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 20 61 6e 64 20 61 6c 69 6b 65 20 41 6e 6f 74 68 .consult-outline.and.alike.Anoth
246a0 65 72 20 6f 70 74 69 6f 6e 20 69 73 0a 3b 3b 20 75 73 69 6e 67 20 67 72 65 70 2d 6d 6f 64 65 20 er.option.is.;;.using.grep-mode.
246c0 62 79 20 75 73 69 6e 67 20 60 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 70 6f 72 74 2d by.using.`embark-consult-export-
246e0 6c 6f 63 61 74 69 6f 6e 2d 67 72 65 70 27 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 location-grep'.(setf.(alist-get.
24700 27 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 20 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 65 'consult-location.embark-exporte
24720 72 73 2d 61 6c 69 73 74 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 rs-alist).......#'embark-consult
24740 2d 65 78 70 6f 72 74 2d 6c 6f 63 61 74 69 6f 6e 2d 6f 63 63 75 72 29 0a 28 63 6c 2d 70 75 73 68 -export-location-occur).(cl-push
24760 6e 65 77 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 75 70 67 72 61 64 65 2d 6d 61 new.#'embark-consult--upgrade-ma
24780 72 6b 65 72 73 20 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 2d 6d 6f 64 65 2d 68 6f 6f 6b 29 0a rkers.embark-collect-mode-hook).
247a0 0a 3b 3b 3b 20 53 75 70 70 6f 72 74 20 66 6f 72 20 63 6f 6e 73 75 6c 74 2d 67 72 65 70 0a 0a 28 .;;;.Support.for.consult-grep..(
247c0 64 65 66 76 61 72 20 67 72 65 70 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 6d 61 74 63 68 65 73 29 0a 28 defvar.grep-mode-line-matches).(
247e0 64 65 66 76 61 72 20 67 72 65 70 2d 6e 75 6d 2d 6d 61 74 63 68 65 73 2d 66 6f 75 6e 64 29 0a 28 defvar.grep-num-matches-found).(
24800 64 65 63 6c 61 72 65 2d 66 75 6e 63 74 69 6f 6e 20 77 67 72 65 70 2d 73 65 74 75 70 20 22 65 78 declare-function.wgrep-setup."ex
24820 74 3a 77 67 72 65 70 22 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 65 6d 62 61 72 6b t:wgrep")..(defvar-keymap.embark
24840 2d 63 6f 6e 73 75 6c 74 2d 72 65 72 75 6e 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 41 20 6b 65 79 -consult-rerun-map...:doc."A.key
24860 6d 61 70 20 77 69 74 68 20 61 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 60 65 6d 62 61 72 6b 2d 72 map.with.a.binding.for.`embark-r
24880 65 72 75 6e 2d 63 6f 6c 6c 65 63 74 2d 6f 72 2d 65 78 70 6f 72 74 27 2e 22 0a 20 20 3a 70 61 72 erun-collect-or-export'."...:par
248a0 65 6e 74 20 6e 69 6c 0a 20 20 22 67 22 20 23 27 65 6d 62 61 72 6b 2d 72 65 72 75 6e 2d 63 6f 6c ent.nil..."g".#'embark-rerun-col
248c0 6c 65 63 74 2d 6f 72 2d 65 78 70 6f 72 74 29 0a 0a 28 63 6c 2d 64 65 66 75 6e 20 65 6d 62 61 72 lect-or-export)..(cl-defun.embar
248e0 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 65 78 70 6f 72 74 2d 67 72 65 70 20 28 26 6b 65 79 20 68 65 61 k-consult--export-grep.(&key.hea
24900 64 65 72 20 6c 69 6e 65 73 20 69 6e 73 65 72 74 20 66 6f 6f 74 65 72 29 0a 20 20 22 43 72 65 61 der.lines.insert.footer)..."Crea
24920 74 65 20 61 20 67 72 65 70 20 6d 6f 64 65 20 62 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 4c 49 te.a.grep.mode.buffer.listing.LI
24940 4e 45 53 2e 0a 54 68 65 20 48 45 41 44 45 52 20 73 74 72 69 6e 67 20 69 73 20 69 6e 73 65 72 74 NES..The.HEADER.string.is.insert
24960 65 64 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 20 62 75 66 66 65 72 2e 20 20 54 68 ed.at.the.top.of.the.buffer...Th
24980 65 0a 66 75 6e 63 74 69 6f 6e 20 49 4e 53 45 52 54 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 69 e.function.INSERT.is.called.to.i
249a0 6e 73 65 72 74 20 74 68 65 20 4c 49 4e 45 53 20 61 6e 64 20 73 68 6f 75 6c 64 20 72 65 74 75 72 nsert.the.LINES.and.should.retur
249c0 6e 20 61 0a 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 6d 61 74 63 68 65 73 20 28 74 68 65 72 65 20 n.a.count.of.the.matches.(there.
249e0 6d 61 79 20 62 65 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 6d 61 74 63 68 20 70 65 72 20 6c may.be.more.than.one.match.per.l
24a00 69 6e 65 29 2e 0a 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 46 4f 4f 54 45 52 20 69 73 20 63 61 6c ine)..The.function.FOOTER.is.cal
24a20 6c 65 64 20 74 6f 20 69 6e 73 65 72 74 20 61 20 66 6f 6f 74 65 72 2e 22 0a 20 20 28 6c 65 74 20 led.to.insert.a.footer."...(let.
24a40 28 28 62 75 66 20 28 67 65 6e 65 72 61 74 65 2d 6e 65 77 2d 62 75 66 66 65 72 20 22 2a 45 6d 62 ((buf.(generate-new-buffer."*Emb
24a60 61 72 6b 20 45 78 70 6f 72 74 20 47 72 65 70 2a 22 29 29 29 0a 20 20 20 20 28 77 69 74 68 2d 63 ark.Export.Grep*"))).....(with-c
24a80 75 72 72 65 6e 74 2d 62 75 66 66 65 72 20 62 75 66 0a 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 urrent-buffer.buf.......(insert.
24aa0 28 70 72 6f 70 65 72 74 69 7a 65 20 68 65 61 64 65 72 20 27 77 67 72 65 70 2d 68 65 61 64 65 72 (propertize.header.'wgrep-header
24ac0 20 74 20 27 66 72 6f 6e 74 2d 73 74 69 63 6b 79 20 74 29 29 0a 20 20 20 20 20 20 28 6c 65 74 20 .t.'front-sticky.t)).......(let.
24ae0 28 28 63 6f 75 6e 74 20 28 66 75 6e 63 61 6c 6c 20 69 6e 73 65 72 74 20 6c 69 6e 65 73 29 29 29 ((count.(funcall.insert.lines)))
24b00 0a 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 66 6f 6f 74 65 72 29 0a 20 20 20 20 20 20 .........(funcall.footer).......
24b20 20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 70 6f 69 6e 74 2d 6d 69 6e 29 29 0a 20 20 20 20 20 20 ..(goto-char.(point-min)).......
24b40 20 20 28 67 72 65 70 2d 6d 6f 64 65 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 2d 6c 6f 63 61 ..(grep-mode).........(setq-loca
24b60 6c 20 67 72 65 70 2d 6e 75 6d 2d 6d 61 74 63 68 65 73 2d 66 6f 75 6e 64 20 63 6f 75 6e 74 0a 20 l.grep-num-matches-found.count..
24b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 65 2d 6c 69 6e 65 2d 70 72 6f ...................mode-line-pro
24ba0 63 65 73 73 20 67 72 65 70 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 6d 61 74 63 68 65 73 29 29 0a 20 20 cess.grep-mode-line-matches))...
24bc0 20 20 20 20 3b 3b 20 4d 61 6b 65 20 74 68 69 73 20 62 75 66 66 65 72 20 63 75 72 72 65 6e 74 20 ....;;.Make.this.buffer.current.
24be0 66 6f 72 20 6e 65 78 74 2f 70 72 65 76 69 6f 75 73 2d 65 72 72 6f 72 0a 20 20 20 20 20 20 28 73 for.next/previous-error.......(s
24c00 65 74 71 20 6e 65 78 74 2d 65 72 72 6f 72 2d 6c 61 73 74 2d 62 75 66 66 65 72 20 62 75 66 29 0a etq.next-error-last-buffer.buf).
24c20 20 20 20 20 20 20 3b 3b 20 53 65 74 20 75 70 20 6b 65 79 6d 61 70 20 62 65 66 6f 72 65 20 70 6f ......;;.Set.up.keymap.before.po
24c40 73 73 69 62 6c 65 20 77 67 72 65 70 2d 73 65 74 75 70 2c 20 73 6f 20 74 68 61 74 20 77 67 72 65 ssible.wgrep-setup,.so.that.wgre
24c60 70 0a 20 20 20 20 20 20 3b 3b 20 72 65 73 74 6f 72 65 73 20 6f 75 72 20 62 69 6e 64 69 6e 67 20 p.......;;.restores.our.binding.
24c80 74 6f 6f 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 66 69 6e 69 73 68 65 73 20 65 64 69 74 69 too.when.the.user.finishes.editi
24ca0 6e 67 2e 0a 20 20 20 20 20 20 28 75 73 65 2d 6c 6f 63 61 6c 2d 6d 61 70 20 28 6d 61 6b 65 2d 63 ng........(use-local-map.(make-c
24cc0 6f 6d 70 6f 73 65 64 2d 6b 65 79 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 omposed-keymap..................
24ce0 20 20 20 20 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 72 65 72 75 6e 2d 6d 61 70 0a 20 20 .....embark-consult-rerun-map...
24d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 75 72 72 65 6e 74 2d 6c 6f 63 ....................(current-loc
24d20 61 6c 2d 6d 61 70 29 29 29 0a 20 20 20 20 20 20 3b 3b 20 54 4f 44 4f 20 57 67 72 65 70 20 33 2e al-map))).......;;.TODO.Wgrep.3.
24d40 30 20 61 6e 64 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 75 73 65 20 64 0.and.development.versions.use.d
24d60 69 66 66 65 72 65 6e 74 20 6e 61 6d 65 73 20 66 6f 72 20 74 68 65 0a 20 20 20 20 20 20 3b 3b 20 ifferent.names.for.the.......;;.
24d80 70 61 72 73 65 72 20 76 61 72 69 61 62 6c 65 2e 0a 20 20 20 20 20 20 28 64 65 66 76 61 72 20 77 parser.variable........(defvar.w
24da0 67 72 65 70 2d 68 65 61 64 65 72 2f 66 6f 6f 74 65 72 2d 70 61 72 73 65 72 29 0a 20 20 20 20 20 grep-header/footer-parser)......
24dc0 20 28 64 65 66 76 61 72 20 77 67 72 65 70 2d 68 65 61 64 65 72 26 66 6f 6f 74 65 72 2d 70 61 72 .(defvar.wgrep-header&footer-par
24de0 73 65 72 29 0a 20 20 20 20 20 20 28 73 65 74 71 2d 6c 6f 63 61 6c 20 77 67 72 65 70 2d 68 65 61 ser).......(setq-local.wgrep-hea
24e00 64 65 72 2f 66 6f 6f 74 65 72 2d 70 61 72 73 65 72 20 23 27 69 67 6e 6f 72 65 0a 20 20 20 20 20 der/footer-parser.#'ignore......
24e20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 67 72 65 70 2d 68 65 61 64 65 72 26 66 6f 6f 74 65 72 .............wgrep-header&footer
24e40 2d 70 61 72 73 65 72 20 23 27 69 67 6e 6f 72 65 29 0a 20 20 20 20 20 20 28 77 68 65 6e 20 28 66 -parser.#'ignore).......(when.(f
24e60 62 6f 75 6e 64 70 20 27 77 67 72 65 70 2d 73 65 74 75 70 29 20 28 77 67 72 65 70 2d 73 65 74 75 boundp.'wgrep-setup).(wgrep-setu
24e80 70 29 29 29 0a 20 20 20 20 28 70 6f 70 2d 74 6f 2d 62 75 66 66 65 72 20 62 75 66 29 29 29 0a 0a p))).....(pop-to-buffer.buf)))..
24ea0 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 70 6f 72 74 2d 67 72 65 (defun.embark-consult-export-gre
24ec0 70 20 28 6c 69 6e 65 73 29 0a 20 20 22 43 72 65 61 74 65 20 61 20 67 72 65 70 20 6d 6f 64 65 20 p.(lines)..."Create.a.grep.mode.
24ee0 62 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 4c 49 4e 45 53 2e 0a 54 68 65 20 65 6c 65 6d 65 6e buffer.listing.LINES..The.elemen
24f00 74 73 20 6f 66 20 4c 49 4e 45 53 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6d 70 6c 65 74 69 6f 6e ts.of.LINES.should.be.completion
24f20 20 63 61 6e 64 69 64 61 74 65 73 20 77 69 74 68 0a 63 61 74 65 67 6f 72 79 20 60 63 6f 6e 73 75 .candidates.with.category.`consu
24f40 6c 74 2d 67 72 65 70 27 2e 22 0a 20 20 28 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 65 78 lt-grep'."...(embark-consult--ex
24f60 70 6f 72 74 2d 67 72 65 70 0a 20 20 20 3a 68 65 61 64 65 72 20 22 45 78 70 6f 72 74 65 64 20 67 port-grep....:header."Exported.g
24f80 72 65 70 20 72 65 73 75 6c 74 73 3a 5c 6e 5c 6e 22 0a 20 20 20 3a 6c 69 6e 65 73 20 6c 69 6e 65 rep.results:\n\n"....:lines.line
24fa0 73 0a 20 20 20 3a 69 6e 73 65 72 74 0a 20 20 20 28 6c 61 6d 62 64 61 20 28 6c 69 6e 65 73 29 0a s....:insert....(lambda.(lines).
24fc0 20 20 20 20 20 28 64 6f 6c 69 73 74 20 28 6c 69 6e 65 20 6c 69 6e 65 73 29 20 28 69 6e 73 65 72 .....(dolist.(line.lines).(inser
24fe0 74 20 6c 69 6e 65 20 22 5c 6e 22 29 29 0a 20 20 20 20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 70 t.line."\n"))......(goto-char.(p
25000 6f 69 6e 74 2d 6d 69 6e 29 29 0a 20 20 20 20 20 28 6c 65 74 20 28 28 63 6f 75 6e 74 20 30 29 20 oint-min))......(let.((count.0).
25020 70 72 6f 70 29 0a 20 20 20 20 20 20 20 28 77 68 69 6c 65 20 28 73 65 74 71 20 70 72 6f 70 20 28 prop)........(while.(setq.prop.(
25040 74 65 78 74 2d 70 72 6f 70 65 72 74 79 2d 73 65 61 72 63 68 2d 66 6f 72 77 61 72 64 0a 20 20 20 text-property-search-forward....
25060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 61 63 65 20 27 63 6f .......................'face.'co
25080 6e 73 75 6c 74 2d 68 69 67 68 6c 69 67 68 74 2d 6d 61 74 63 68 20 74 29 29 0a 20 20 20 20 20 20 nsult-highlight-match.t)).......
250a0 20 20 20 28 63 6c 2d 69 6e 63 66 20 63 6f 75 6e 74 29 0a 20 20 20 20 20 20 20 20 20 28 70 75 74 ...(cl-incf.count)..........(put
250c0 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 28 70 72 6f 70 2d 6d 61 74 63 68 2d 62 65 67 69 6e -text-property.(prop-match-begin
250e0 6e 69 6e 67 20 70 72 6f 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ning.prop)......................
25100 20 20 20 20 20 20 20 28 70 72 6f 70 2d 6d 61 74 63 68 2d 65 6e 64 20 70 72 6f 70 29 0a 20 20 20 .......(prop-match-end.prop)....
25120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 6f 6e 74 2d 6c .........................'font-l
25140 6f 63 6b 2d 66 61 63 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ock-face........................
25160 20 20 20 20 20 27 6d 61 74 63 68 29 29 0a 20 20 20 20 20 20 20 63 6f 75 6e 74 29 29 0a 20 20 20 .....'match))........count))....
25180 3a 66 6f 6f 74 65 72 20 23 27 69 67 6e 6f 72 65 29 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 :footer.#'ignore))..(defun.embar
251a0 6b 2d 63 6f 6e 73 75 6c 74 2d 67 6f 74 6f 2d 67 72 65 70 20 28 6c 6f 63 61 74 69 6f 6e 29 0a 20 k-consult-goto-grep.(location)..
251c0 20 22 47 6f 20 74 6f 20 4c 4f 43 41 54 49 4f 4e 2c 20 77 68 69 63 68 20 73 68 6f 75 6c 64 20 62 ."Go.to.LOCATION,.which.should.b
251e0 65 20 61 20 73 74 72 69 6e 67 20 77 69 74 68 20 61 20 67 72 65 70 20 6d 61 74 63 68 2e 22 0a 20 e.a.string.with.a.grep.match."..
25200 20 28 63 6f 6e 73 75 6c 74 2d 2d 6a 75 6d 70 20 28 63 6f 6e 73 75 6c 74 2d 2d 67 72 65 70 2d 70 .(consult--jump.(consult--grep-p
25220 6f 73 69 74 69 6f 6e 20 6c 6f 63 61 74 69 6f 6e 29 29 0a 20 20 28 70 75 6c 73 65 2d 6d 6f 6d 65 osition.location))...(pulse-mome
25240 6e 74 61 72 79 2d 68 69 67 68 6c 69 67 68 74 2d 6f 6e 65 2d 6c 69 6e 65 20 28 70 6f 69 6e 74 29 ntary-highlight-one-line.(point)
25260 29 29 0a 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f 6e 73 75 6c 74 2d 67 72 ))..(setf.(alist-get.'consult-gr
25280 65 70 20 65 6d 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 63 74 69 6f 6e 2d 6f 76 65 72 72 69 64 ep.embark-default-action-overrid
252a0 65 73 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 67 6f 74 6f 2d es).......#'embark-consult-goto-
252c0 67 72 65 70 29 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f 6e 73 75 6c 74 2d grep).(setf.(alist-get.'consult-
252e0 67 72 65 70 20 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 65 72 73 2d 61 6c 69 73 74 29 0a 20 20 20 grep.embark-exporters-alist)....
25300 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 70 6f 72 74 2d 67 72 65 70 29 ...#'embark-consult-export-grep)
25320 0a 0a 3b 3b 3b 20 53 75 70 70 6f 72 74 20 66 6f 72 20 63 6f 6e 73 75 6c 74 2d 78 72 65 66 0a 0a ..;;;.Support.for.consult-xref..
25340 28 64 65 63 6c 61 72 65 2d 66 75 6e 63 74 69 6f 6e 20 78 72 65 66 2d 2d 73 68 6f 77 2d 78 72 65 (declare-function.xref--show-xre
25360 66 2d 62 75 66 66 65 72 20 22 65 78 74 3a 78 72 65 66 22 29 0a 28 64 65 63 6c 61 72 65 2d 66 75 f-buffer."ext:xref").(declare-fu
25380 6e 63 74 69 6f 6e 20 63 6f 6e 73 75 6c 74 2d 78 72 65 66 20 22 65 78 74 3a 63 6f 6e 73 75 6c 74 nction.consult-xref."ext:consult
253a0 2d 78 72 65 66 22 29 0a 28 64 65 66 76 61 72 20 78 72 65 66 2d 61 75 74 6f 2d 6a 75 6d 70 2d 74 -xref").(defvar.xref-auto-jump-t
253c0 6f 2d 66 69 72 73 74 2d 78 72 65 66 29 0a 28 64 65 66 76 61 72 20 63 6f 6e 73 75 6c 74 2d 78 72 o-first-xref).(defvar.consult-xr
253e0 65 66 2d 2d 66 65 74 63 68 65 72 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 ef--fetcher)..(defun.embark-cons
25400 75 6c 74 2d 65 78 70 6f 72 74 2d 78 72 65 66 20 28 69 74 65 6d 73 29 0a 20 20 22 43 72 65 61 74 ult-export-xref.(items)..."Creat
25420 65 20 61 6e 20 78 72 65 66 20 62 75 66 66 65 72 20 6c 69 73 74 69 6e 67 20 49 54 45 4d 53 2e 22 e.an.xref.buffer.listing.ITEMS."
25440 0a 20 20 28 63 6c 2d 66 6c 65 74 20 28 28 78 72 65 66 2d 69 74 65 6d 73 20 28 69 74 65 6d 73 29 ...(cl-flet.((xref-items.(items)
25460 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 28 6c 61 6d 62 64 61 20 28 ...............(mapcar.(lambda.(
25480 69 74 65 6d 29 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 30 20 27 63 6f 6e 73 item).(get-text-property.0.'cons
254a0 75 6c 74 2d 78 72 65 66 20 69 74 65 6d 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ult-xref.item)).................
254c0 20 20 20 20 20 20 69 74 65 6d 73 29 29 29 0a 20 20 20 20 28 6c 65 74 20 28 28 66 65 74 63 68 65 ......items))).....(let.((fetche
254e0 72 20 63 6f 6e 73 75 6c 74 2d 78 72 65 66 2d 2d 66 65 74 63 68 65 72 29 0a 20 20 20 20 20 20 20 r.consult-xref--fetcher)........
25500 20 20 20 28 69 6e 70 75 74 20 28 6d 69 6e 69 62 75 66 66 65 72 2d 63 6f 6e 74 65 6e 74 73 29 29 ...(input.(minibuffer-contents))
25520 29 0a 20 20 20 20 20 20 28 73 65 74 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 28 78 72 65 66 ).......(set-buffer........(xref
25540 2d 2d 73 68 6f 77 2d 78 72 65 66 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 20 28 6c 61 6d 62 --show-xref-buffer.........(lamb
25560 64 61 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 63 61 6e 64 69 64 61 74 65 da.()...........(let.((candidate
25580 73 20 28 66 75 6e 63 61 6c 6c 20 66 65 74 63 68 65 72 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 s.(funcall.fetcher)))...........
255a0 20 20 28 69 66 20 28 6e 75 6c 6c 20 28 63 64 72 20 63 61 6e 64 69 64 61 74 65 73 29 29 0a 20 20 ..(if.(null.(cdr.candidates))...
255c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e 64 69 64 61 74 65 73 0a 20 20 20 20 20 20 20 ..............candidates........
255e0 20 20 20 20 20 20 20 28 63 61 74 63 68 20 27 78 72 65 66 2d 69 74 65 6d 73 0a 20 20 20 20 20 20 .......(catch.'xref-items.......
25600 20 20 20 20 20 20 20 20 20 20 28 6d 69 6e 69 62 75 66 66 65 72 2d 77 69 74 68 2d 73 65 74 75 70 ..........(minibuffer-with-setup
25620 2d 68 6f 6f 6b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 -hook.....................(lambd
25640 61 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 73 65 a.().......................(inse
25660 72 74 20 69 6e 70 75 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rt.input).......................
25680 28 61 64 64 2d 68 6f 6f 6b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (add-hook.......................
256a0 20 27 6d 69 6e 69 62 75 66 66 65 72 2d 65 78 69 74 2d 68 6f 6f 6b 0a 20 20 20 20 20 20 20 20 20 .'minibuffer-exit-hook..........
256c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 20 20 20 20 20 20 ..............(lambda.()........
256e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 68 72 6f 77 20 27 78 72 65 66 2d 69 ..................(throw.'xref-i
25700 74 65 6d 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 tems............................
25720 20 20 20 20 20 28 78 72 65 66 2d 69 74 65 6d 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .....(xref-items................
25740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 0a 20 20 20 20 20 20 20 20 20 20 ..................(or...........
25760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 6c 69 73 74 2d 67 ........................(plist-g
25780 65 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 et..............................
257a0 20 20 20 20 20 20 28 65 6d 62 61 72 6b 2d 2d 6d 61 79 62 65 2d 74 72 61 6e 73 66 6f 72 6d 2d 63 ......(embark--maybe-transform-c
257c0 61 6e 64 69 64 61 74 65 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 andidates)......................
257e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 63 61 6e 64 69 64 61 74 65 73 29 0a 20 20 20 20 20 ..............:candidates)......
25800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 .............................(us
25820 65 72 2d 65 72 72 6f 72 20 22 4e 6f 20 63 61 6e 64 69 64 61 74 65 73 20 66 6f 72 20 65 78 70 6f er-error."No.candidates.for.expo
25840 72 74 22 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rt")))))........................
25860 6e 69 6c 20 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 75 nil.t))...................(consu
25880 6c 74 2d 78 72 65 66 20 66 65 74 63 68 65 72 29 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 60 28 lt-xref.fetcher)))))).........`(
258a0 28 66 65 74 63 68 65 64 2d 78 72 65 66 73 20 2e 20 2c 28 78 72 65 66 2d 69 74 65 6d 73 20 69 74 (fetched-xrefs...,(xref-items.it
258c0 65 6d 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 77 69 6e 64 6f 77 20 2e 20 2c 28 65 6d 62 61 ems))...........(window...,(emba
258e0 72 6b 2d 2d 74 61 72 67 65 74 2d 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 61 rk--target-window))...........(a
25900 75 74 6f 2d 6a 75 6d 70 20 2e 20 2c 78 72 65 66 2d 61 75 74 6f 2d 6a 75 6d 70 2d 74 6f 2d 66 69 uto-jump...,xref-auto-jump-to-fi
25920 72 73 74 2d 78 72 65 66 29 0a 20 20 20 20 20 20 20 20 20 20 28 64 69 73 70 6c 61 79 2d 61 63 74 rst-xref)...........(display-act
25940 69 6f 6e 29 29 29 29 29 29 29 0a 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f ion)))))))..(setf.(alist-get.'co
25960 6e 73 75 6c 74 2d 78 72 65 66 20 65 6d 62 61 72 6b 2d 65 78 70 6f 72 74 65 72 73 2d 61 6c 69 73 nsult-xref.embark-exporters-alis
25980 74 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 65 78 70 6f 72 74 t).......#'embark-consult-export
259a0 2d 78 72 65 66 29 0a 0a 3b 3b 3b 20 53 75 70 70 6f 72 74 20 66 6f 72 20 63 6f 6e 73 75 6c 74 2d -xref)..;;;.Support.for.consult-
259c0 66 69 6e 64 20 61 6e 64 20 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 65 0a 0a 28 73 65 74 66 20 28 find.and.consult-locate..(setf.(
259e0 61 6c 69 73 74 2d 67 65 74 20 27 28 66 69 6c 65 20 2e 20 63 6f 6e 73 75 6c 74 2d 66 69 6e 64 29 alist-get.'(file...consult-find)
25a00 20 65 6d 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 63 74 69 6f 6e 2d 6f 76 65 72 72 69 64 65 73 .embark-default-action-overrides
25a20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 69 6c 20 6e 69 6c 20 23 27 65 71 75 61 ..................nil.nil.#'equa
25a40 6c 29 0a 20 20 20 20 20 20 23 27 66 69 6e 64 2d 66 69 6c 65 29 0a 0a 28 73 65 74 66 20 28 61 6c l).......#'find-file)..(setf.(al
25a60 69 73 74 2d 67 65 74 20 27 28 66 69 6c 65 20 2e 20 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 65 29 ist-get.'(file...consult-locate)
25a80 20 65 6d 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 63 74 69 6f 6e 2d 6f 76 65 72 72 69 64 65 73 .embark-default-action-overrides
25aa0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 69 6c 20 6e 69 6c 20 23 27 65 71 75 61 ..................nil.nil.#'equa
25ac0 6c 29 0a 20 20 20 20 20 20 23 27 66 69 6e 64 2d 66 69 6c 65 29 0a 0a 3b 3b 3b 20 53 75 70 70 6f l).......#'find-file)..;;;.Suppo
25ae0 72 74 20 66 6f 72 20 63 6f 6e 73 75 6c 74 2d 69 73 65 61 72 63 68 2d 68 69 73 74 6f 72 79 0a 0a rt.for.consult-isearch-history..
25b00 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f 6e 73 75 6c 74 2d 69 73 65 61 72 63 (setf.(alist-get.'consult-isearc
25b20 68 2d 68 69 73 74 6f 72 79 20 65 6d 62 61 72 6b 2d 74 72 61 6e 73 66 6f 72 6d 65 72 2d 61 6c 69 h-history.embark-transformer-ali
25b40 73 74 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 74 61 72 67 st).......#'embark-consult--targ
25b60 65 74 2d 73 74 72 69 70 29 0a 0a 3b 3b 3b 20 53 75 70 70 6f 72 74 20 66 6f 72 20 63 6f 6e 73 75 et-strip)..;;;.Support.for.consu
25b80 6c 74 2d 6d 61 6e 20 61 6e 64 20 63 6f 6e 73 75 6c 74 2d 69 6e 66 6f 0a 0a 28 64 65 66 75 6e 20 lt-man.and.consult-info..(defun.
25ba0 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 6d 61 6e 20 28 63 61 6e 64 29 0a 20 20 22 44 65 66 embark-consult-man.(cand)..."Def
25bc0 61 75 6c 74 20 61 63 74 69 6f 6e 20 6f 76 65 72 72 69 64 65 20 66 6f 72 20 60 63 6f 6e 73 75 6c ault.action.override.for.`consul
25be0 74 2d 6d 61 6e 27 2c 20 6f 70 65 6e 20 43 41 4e 44 20 6d 61 6e 20 70 61 67 65 2e 22 0a 20 20 28 t-man',.open.CAND.man.page."...(
25c00 6d 61 6e 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 30 20 27 63 6f 6e 73 75 6c man.(get-text-property.0.'consul
25c20 74 2d 6d 61 6e 20 63 61 6e 64 29 29 29 0a 0a 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 t-man.cand)))..(setf.(alist-get.
25c40 27 63 6f 6e 73 75 6c 74 2d 6d 61 6e 20 65 6d 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 63 74 69 'consult-man.embark-default-acti
25c60 6f 6e 2d 6f 76 65 72 72 69 64 65 73 29 0a 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e on-overrides).......#'embark-con
25c80 73 75 6c 74 2d 6d 61 6e 29 0a 0a 28 64 65 63 6c 61 72 65 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6e sult-man)..(declare-function.con
25ca0 73 75 6c 74 2d 69 6e 66 6f 2d 2d 61 63 74 69 6f 6e 20 22 65 78 74 3a 63 6f 6e 73 75 6c 74 2d 69 sult-info--action."ext:consult-i
25cc0 6e 66 6f 22 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6e 66 nfo")..(defun.embark-consult-inf
25ce0 6f 20 28 63 61 6e 64 29 0a 20 20 22 44 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 6f 76 65 72 72 o.(cand)..."Default.action.overr
25d00 69 64 65 20 66 6f 72 20 60 63 6f 6e 73 75 6c 74 2d 69 6e 66 6f 27 2c 20 6f 70 65 6e 20 43 41 4e ide.for.`consult-info',.open.CAN
25d20 44 20 69 6e 66 6f 20 6d 61 6e 75 61 6c 2e 22 0a 20 20 28 63 6f 6e 73 75 6c 74 2d 69 6e 66 6f 2d D.info.manual."...(consult-info-
25d40 2d 61 63 74 69 6f 6e 20 63 61 6e 64 29 0a 20 20 28 70 75 6c 73 65 2d 6d 6f 6d 65 6e 74 61 72 79 -action.cand)...(pulse-momentary
25d60 2d 68 69 67 68 6c 69 67 68 74 2d 6f 6e 65 2d 6c 69 6e 65 20 28 70 6f 69 6e 74 29 29 29 0a 0a 28 -highlight-one-line.(point)))..(
25d80 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f 6e 73 75 6c 74 2d 69 6e 66 6f 20 65 6d setf.(alist-get.'consult-info.em
25da0 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 63 74 69 6f 6e 2d 6f 76 65 72 72 69 64 65 73 29 0a 20 bark-default-action-overrides)..
25dc0 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6e 66 6f 29 0a 0a 28 73 65 .....#'embark-consult-info)..(se
25de0 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 63 6f 6e 73 75 6c 74 2d 69 6e 66 6f 20 65 6d 62 61 tf.(alist-get.'consult-info.emba
25e00 72 6b 2d 74 72 61 6e 73 66 6f 72 6d 65 72 2d 61 6c 69 73 74 29 0a 20 20 20 20 20 20 23 27 65 6d rk-transformer-alist).......#'em
25e20 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 74 61 72 67 65 74 2d 73 74 72 69 70 29 0a 0a 3b 3b 3b bark-consult--target-strip)..;;;
25e40 20 42 69 6e 64 69 6e 67 73 20 66 6f 72 20 63 6f 6e 73 75 6c 74 20 63 6f 6d 6d 61 6e 64 73 20 69 .Bindings.for.consult.commands.i
25e60 6e 20 65 6d 62 61 72 6b 20 6b 65 79 6d 61 70 73 0a 0a 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d n.embark.keymaps..(keymap-set.em
25e80 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 66 69 6c 65 2b 62 75 66 66 65 72 2d 6d 61 70 20 22 43 20 62 bark-become-file+buffer-map."C.b
25ea0 22 20 23 27 63 6f 6e 73 75 6c 74 2d 62 75 66 66 65 72 29 0a 28 6b 65 79 6d 61 70 2d 73 65 74 20 ".#'consult-buffer).(keymap-set.
25ec0 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 66 69 6c 65 2b 62 75 66 66 65 72 2d 6d 61 70 20 22 43 embark-become-file+buffer-map."C
25ee0 20 34 20 62 22 20 23 27 63 6f 6e 73 75 6c 74 2d 62 75 66 66 65 72 2d 6f 74 68 65 72 2d 77 69 6e .4.b".#'consult-buffer-other-win
25f00 64 6f 77 29 0a 0a 3b 3b 3b 20 53 75 70 70 6f 72 74 20 66 6f 72 20 43 6f 6e 73 75 6c 74 20 73 65 dow)..;;;.Support.for.Consult.se
25f20 61 72 63 68 20 63 6f 6d 6d 61 6e 64 73 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 65 6d arch.commands..(defvar-keymap.em
25f40 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 79 6e 63 2d 73 65 61 72 63 68 2d 6d 61 70 0a 20 20 3a bark-consult-sync-search-map...:
25f60 64 6f 63 20 22 4b 65 79 6d 61 70 20 66 6f 72 20 43 6f 6e 73 75 6c 74 20 73 79 6e 63 20 73 65 61 doc."Keymap.for.Consult.sync.sea
25f80 72 63 68 20 63 6f 6d 6d 61 6e 64 73 22 0a 20 20 3a 70 61 72 65 6e 74 20 6e 69 6c 0a 20 20 22 6f rch.commands"...:parent.nil..."o
25fa0 22 20 23 27 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 0a 20 20 22 69 22 20 27 63 6f 6e 73 75 ".#'consult-outline..."i".'consu
25fc0 6c 74 2d 69 6d 65 6e 75 0a 20 20 22 49 22 20 27 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 6d 75 lt-imenu..."I".'consult-imenu-mu
25fe0 6c 74 69 0a 20 20 22 6c 22 20 23 27 63 6f 6e 73 75 6c 74 2d 6c 69 6e 65 0a 20 20 22 4c 22 20 23 lti..."l".#'consult-line..."L".#
26000 27 63 6f 6e 73 75 6c 74 2d 6c 69 6e 65 2d 6d 75 6c 74 69 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 'consult-line-multi)..(defvar-ke
26020 79 6d 61 70 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 61 73 79 6e 63 2d 73 65 61 72 63 68 ymap.embark-consult-async-search
26040 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 4b 65 79 6d 61 70 20 66 6f 72 20 43 6f 6e 73 75 6c 74 20 -map...:doc."Keymap.for.Consult.
26060 61 73 79 6e 63 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 73 22 0a 20 20 3a 70 61 72 65 6e 74 async.search.commands"...:parent
26080 20 6e 69 6c 0a 20 20 22 67 22 20 23 27 63 6f 6e 73 75 6c 74 2d 67 72 65 70 0a 20 20 22 72 22 20 .nil..."g".#'consult-grep..."r".
260a0 23 27 63 6f 6e 73 75 6c 74 2d 72 69 70 67 72 65 70 0a 20 20 22 47 22 20 23 27 63 6f 6e 73 75 6c #'consult-ripgrep..."G".#'consul
260c0 74 2d 67 69 74 2d 67 72 65 70 0a 20 20 22 66 22 20 23 27 63 6f 6e 73 75 6c 74 2d 66 69 6e 64 0a t-git-grep..."f".#'consult-find.
260e0 20 20 22 46 22 20 23 27 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 65 29 0a 0a 28 64 65 66 76 61 72 .."F".#'consult-locate)..(defvar
26100 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 65 61 72 63 68 2d 6d 61 70 0a 20 20 28 6b 65 .embark-consult-search-map...(ke
26120 79 6d 61 70 2d 63 61 6e 6f 6e 69 63 61 6c 69 7a 65 0a 20 20 20 28 6d 61 6b 65 2d 63 6f 6d 70 6f ymap-canonicalize....(make-compo
26140 73 65 64 2d 6b 65 79 6d 61 70 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 79 6e 63 2d 73 sed-keymap.embark-consult-sync-s
26160 65 61 72 63 68 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 earch-map.......................
26180 20 20 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 61 73 79 6e 63 2d 73 65 61 72 63 68 2d 6d ...embark-consult-async-search-m
261a0 61 70 29 29 0a 20 20 22 4b 65 79 6d 61 70 20 66 6f 72 20 61 6c 6c 20 43 6f 6e 73 75 6c 74 20 73 ap))..."Keymap.for.all.Consult.s
261c0 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 73 2e 22 29 0a 0a 28 66 73 65 74 20 27 65 6d 62 61 72 6b earch.commands.")..(fset.'embark
261e0 2d 63 6f 6e 73 75 6c 74 2d 73 79 6e 63 2d 73 65 61 72 63 68 2d 6d 61 70 20 65 6d 62 61 72 6b 2d -consult-sync-search-map.embark-
26200 63 6f 6e 73 75 6c 74 2d 73 79 6e 63 2d 73 65 61 72 63 68 2d 6d 61 70 29 0a 28 6b 65 79 6d 61 70 consult-sync-search-map).(keymap
26220 2d 73 65 74 20 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 6d 61 74 63 68 2d 6d 61 70 20 22 43 22 -set.embark-become-match-map."C"
26240 20 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 79 6e 63 2d 73 65 61 72 63 68 2d 6d 61 70 .'embark-consult-sync-search-map
26260 29 0a 0a 28 63 6c 2d 70 75 73 68 6e 65 77 20 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 61 )..(cl-pushnew.'embark-consult-a
26280 73 79 6e 63 2d 73 65 61 72 63 68 2d 6d 61 70 20 65 6d 62 61 72 6b 2d 62 65 63 6f 6d 65 2d 6b 65 sync-search-map.embark-become-ke
262a0 79 6d 61 70 73 29 0a 0a 28 66 73 65 74 20 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 65 ymaps)..(fset.'embark-consult-se
262c0 61 72 63 68 2d 6d 61 70 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 65 61 72 63 68 2d 6d arch-map.embark-consult-search-m
262e0 61 70 29 0a 28 6b 65 79 6d 61 70 2d 73 65 74 20 65 6d 62 61 72 6b 2d 67 65 6e 65 72 61 6c 2d 6d ap).(keymap-set.embark-general-m
26300 61 70 20 22 43 22 20 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 65 61 72 63 68 2d 6d 61 ap."C".'embark-consult-search-ma
26320 70 29 0a 0a 28 6d 61 70 2d 6b 65 79 6d 61 70 0a 20 28 6c 61 6d 62 64 61 20 28 5f 6b 65 79 20 63 p)..(map-keymap..(lambda.(_key.c
26340 6d 64 29 0a 20 20 20 28 63 6c 2d 70 75 73 68 6e 65 77 20 27 65 6d 62 61 72 6b 2d 2d 75 6e 6d 61 md)....(cl-pushnew.'embark--unma
26360 72 6b 2d 74 61 72 67 65 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d rk-target................(alist-
26380 67 65 74 20 63 6d 64 20 65 6d 62 61 72 6b 2d 70 72 65 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 29 get.cmd.embark-pre-action-hooks)
263a0 29 0a 20 20 20 28 63 6c 2d 70 75 73 68 6e 65 77 20 27 65 6d 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d )....(cl-pushnew.'embark--allow-
263c0 65 64 69 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d 67 65 74 20 63 edit................(alist-get.c
263e0 6d 64 20 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 md.embark-target-injection-hooks
26400 29 29 29 0a 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 73 65 61 72 63 68 2d 6d 61 70 29 0a )))..embark-consult-search-map).
26420 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 75 6e 69 71 75 65 2d 6d .(defun.embark-consult--unique-m
26440 61 74 63 68 20 28 26 72 65 73 74 20 5f 29 0a 20 20 22 49 66 20 74 68 65 72 65 20 69 73 20 61 20 atch.(&rest._)..."If.there.is.a.
26460 75 6e 69 71 75 65 20 6d 61 74 63 68 69 6e 67 20 63 61 6e 64 69 64 61 74 65 2c 20 61 63 63 65 70 unique.matching.candidate,.accep
26480 74 20 69 74 2e 0a 54 68 69 73 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 t.it..This.is.intended.to.be.use
264a0 64 20 69 6e 20 60 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f d.in.`embark-target-injection-ho
264c0 6f 6b 73 27 2e 22 0a 20 20 28 6c 65 74 20 28 28 63 61 6e 64 69 64 61 74 65 73 20 28 63 64 72 20 oks'."...(let.((candidates.(cdr.
264e0 28 65 6d 62 61 72 6b 2d 6d 69 6e 69 62 75 66 66 65 72 2d 63 61 6e 64 69 64 61 74 65 73 29 29 29 (embark-minibuffer-candidates)))
26500 29 0a 20 20 20 20 28 69 66 20 28 6f 72 20 28 6e 75 6c 6c 20 63 61 6e 64 69 64 61 74 65 73 29 20 ).....(if.(or.(null.candidates).
26520 28 63 64 72 20 63 61 6e 64 69 64 61 74 65 73 29 29 0a 20 20 20 20 20 20 20 20 28 65 6d 62 61 72 (cdr.candidates)).........(embar
26540 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 29 0a 20 20 20 20 20 20 28 64 65 6c 65 74 65 2d 6d 69 6e k--allow-edit).......(delete-min
26560 69 62 75 66 66 65 72 2d 63 6f 6e 74 65 6e 74 73 29 0a 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 ibuffer-contents).......(insert.
26580 28 63 61 72 20 63 61 6e 64 69 64 61 74 65 73 29 29 29 29 29 0a 0a 28 64 6f 6c 69 73 74 20 28 63 (car.candidates)))))..(dolist.(c
265a0 6d 64 20 27 28 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 20 63 6f 6e 73 75 6c 74 2d 69 6d 65 md.'(consult-outline.consult-ime
265c0 6e 75 20 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 6d 75 6c 74 69 29 29 0a 20 20 28 73 65 74 66 nu.consult-imenu-multi))...(setf
265e0 20 28 61 6c 69 73 74 2d 67 65 74 20 63 6d 64 20 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e .(alist-get.cmd.embark-target-in
26600 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 29 0a 20 20 20 20 20 20 20 20 28 72 65 6d 71 20 27 65 6d jection-hooks).........(remq.'em
26620 62 61 72 6b 2d 2d 61 6c 6c 6f 77 2d 65 64 69 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 bark--allow-edit...............(
26640 61 6c 69 73 74 2d 67 65 74 20 63 6d 64 20 65 6d 62 61 72 6b 2d 74 61 72 67 65 74 2d 69 6e 6a 65 alist-get.cmd.embark-target-inje
26660 63 74 69 6f 6e 2d 68 6f 6f 6b 73 29 29 29 0a 20 20 28 63 6c 2d 70 75 73 68 6e 65 77 20 23 27 65 ction-hooks)))...(cl-pushnew.#'e
26680 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 75 6e 69 71 75 65 2d 6d 61 74 63 68 0a 20 20 20 20 mbark-consult--unique-match.....
266a0 20 20 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d 67 65 74 20 63 6d 64 20 65 6d 62 61 72 6b 2d ..........(alist-get.cmd.embark-
266c0 74 61 72 67 65 74 2d 69 6e 6a 65 63 74 69 6f 6e 2d 68 6f 6f 6b 73 29 29 29 0a 0a 28 63 6c 2d 64 target-injection-hooks)))..(cl-d
266e0 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 61 73 79 6e 63 2d 73 65 61 72 63 efun.embark-consult--async-searc
26700 68 2d 64 77 69 6d 0a 20 20 20 20 28 26 6b 65 79 20 61 63 74 69 6f 6e 20 74 79 70 65 20 74 61 72 h-dwim.....(&key.action.type.tar
26720 67 65 74 20 63 61 6e 64 69 64 61 74 65 73 20 26 61 6c 6c 6f 77 2d 6f 74 68 65 72 2d 6b 65 79 73 get.candidates.&allow-other-keys
26740 29 0a 20 20 22 44 57 49 4d 20 77 68 65 6e 20 75 73 69 6e 67 20 61 20 43 6f 6e 73 75 6c 74 20 61 )..."DWIM.when.using.a.Consult.a
26760 73 79 6e 63 20 73 65 61 72 63 68 20 63 6f 6d 6d 61 6e 64 20 61 73 20 61 6e 20 41 43 54 49 4f 4e sync.search.command.as.an.ACTION
26780 2e 0a 49 66 20 74 68 65 20 54 59 50 45 20 6f 66 20 74 68 65 20 74 61 72 67 65 74 28 73 29 20 68 ..If.the.TYPE.of.the.target(s).h
267a0 61 73 20 61 20 6e 6f 74 69 6f 6e 20 6f 66 20 61 73 73 6f 63 69 61 74 65 64 0a 66 69 6c 65 20 28 as.a.notion.of.associated.file.(
267c0 66 69 6c 65 73 2c 20 62 75 66 66 65 72 73 2c 20 6c 69 62 72 61 72 69 65 73 20 61 6e 64 20 73 6f files,.buffers,.libraries.and.so
267e0 6d 65 20 62 6f 6f 6b 6d 61 72 6b 73 20 64 6f 29 2c 20 74 68 65 6e 20 72 75 6e 0a 74 68 65 20 41 me.bookmarks.do),.then.run.the.A
26800 43 54 49 4f 4e 20 77 69 74 68 20 60 63 6f 6e 73 75 6c 74 2d 70 72 6f 6a 65 63 74 2d 66 75 6e 63 CTION.with.`consult-project-func
26820 74 69 6f 6e 27 20 73 65 74 20 74 6f 20 6e 69 6c 2c 20 61 6e 64 20 73 65 61 72 63 68 0a 6f 6e 6c tion'.set.to.nil,.and.search.onl
26840 79 20 74 68 65 20 66 69 6c 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f 20 74 68 65 20 54 41 y.the.files.associated.to.the.TA
26860 52 47 45 54 20 6f 72 20 43 41 4e 44 49 44 41 54 45 53 2e 20 20 46 6f 72 20 6f 74 68 65 72 0a 74 RGET.or.CANDIDATES...For.other.t
26880 79 70 65 73 2c 20 72 75 6e 20 74 68 65 20 41 43 54 49 4f 4e 20 77 69 74 68 20 54 41 52 47 45 54 ypes,.run.the.ACTION.with.TARGET
268a0 20 6f 72 20 43 41 4e 44 49 44 41 54 45 53 20 61 73 20 69 6e 69 74 69 61 6c 20 69 6e 70 75 74 2e .or.CANDIDATES.as.initial.input.
268c0 22 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 66 69 6c 65 2d 66 6e 20 28 63 64 72 20 28 61 73 73 71 "...(if-let.((file-fn.(cdr.(assq
268e0 20 74 79 70 65 20 65 6d 62 61 72 6b 2d 2d 61 73 73 6f 63 69 61 74 65 64 2d 66 69 6c 65 2d 66 6e .type.embark--associated-file-fn
26900 2d 61 6c 69 73 74 29 29 29 29 0a 20 20 20 20 20 20 28 6c 65 74 20 28 63 6f 6e 73 75 6c 74 2d 70 -alist)))).......(let.(consult-p
26920 72 6f 6a 65 63 74 2d 66 75 6e 63 74 69 6f 6e 29 0a 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c roject-function).........(funcal
26940 6c 20 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 6c 71 20 l.action..................(delq.
26960 6e 69 6c 20 28 6d 61 70 63 61 72 20 66 69 6c 65 2d 66 6e 20 28 6f 72 20 63 61 6e 64 69 64 61 74 nil.(mapcar.file-fn.(or.candidat
26980 65 73 20 28 6c 69 73 74 20 74 61 72 67 65 74 29 29 29 29 29 29 0a 20 20 20 20 28 66 75 6e 63 61 es.(list.target)))))).....(funca
269a0 6c 6c 20 61 63 74 69 6f 6e 20 6e 69 6c 20 28 6f 72 20 74 61 72 67 65 74 20 28 73 74 72 69 6e 67 ll.action.nil.(or.target.(string
269c0 2d 6a 6f 69 6e 20 63 61 6e 64 69 64 61 74 65 73 20 22 20 22 29 29 29 29 29 0a 0a 28 6d 61 70 2d -join.candidates.".")))))..(map-
269e0 6b 65 79 6d 61 70 0a 20 28 6c 61 6d 62 64 61 20 28 5f 6b 65 79 20 63 6d 64 29 0a 20 20 20 28 75 keymap..(lambda.(_key.cmd)....(u
26a00 6e 6c 65 73 73 20 28 65 71 20 63 6d 64 20 23 27 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 65 29 0a nless.(eq.cmd.#'consult-locate).
26a20 20 20 20 20 20 28 63 6c 2d 70 75 73 68 6e 65 77 20 63 6d 64 20 65 6d 62 61 72 6b 2d 6d 75 6c 74 .....(cl-pushnew.cmd.embark-mult
26a40 69 74 61 72 67 65 74 2d 61 63 74 69 6f 6e 73 29 0a 20 20 20 20 20 28 63 6c 2d 70 75 73 68 6e 65 itarget-actions)......(cl-pushne
26a60 77 20 23 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 61 73 79 6e 63 2d 73 65 61 72 63 68 w.#'embark-consult--async-search
26a80 2d 64 77 69 6d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 2d 67 65 -dwim..................(alist-ge
26aa0 74 20 63 6d 64 20 65 6d 62 61 72 6b 2d 61 72 6f 75 6e 64 2d 61 63 74 69 6f 6e 2d 68 6f 6f 6b 73 t.cmd.embark-around-action-hooks
26ac0 29 29 29 29 0a 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 61 73 79 6e 63 2d 73 65 61 72 63 ))))..embark-consult-async-searc
26ae0 68 2d 6d 61 70 29 0a 0a 3b 3b 3b 20 54 61 62 6c 65 73 20 6f 66 20 63 6f 6e 74 65 6e 74 73 20 66 h-map)..;;;.Tables.of.contents.f
26b00 6f 72 20 62 75 66 66 65 72 73 3a 20 69 6d 65 6e 75 20 61 6e 64 20 6f 75 74 6c 69 6e 65 20 63 61 or.buffers:.imenu.and.outline.ca
26b20 6e 64 69 64 61 74 65 20 63 6f 6c 6c 65 63 74 6f 72 73 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 ndidate.collectors..(defun.embar
26b40 6b 2d 63 6f 6e 73 75 6c 74 2d 6f 75 74 6c 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 20 28 29 0a k-consult-outline-candidates.().
26b60 20 20 22 43 6f 6c 6c 65 63 74 20 61 6c 6c 20 6f 75 74 6c 69 6e 65 20 68 65 61 64 69 6e 67 73 20 .."Collect.all.outline.headings.
26b80 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2e 22 0a 20 20 28 63 6f 6e 73 20 in.the.current.buffer."...(cons.
26ba0 27 63 6f 6e 73 75 6c 74 2d 6c 6f 63 61 74 69 6f 6e 20 28 63 6f 6e 73 75 6c 74 2d 2d 6f 75 74 6c 'consult-location.(consult--outl
26bc0 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 29 29 29 0a 0a 28 61 75 74 6f 6c 6f 61 64 20 27 63 6f ine-candidates)))..(autoload.'co
26be0 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 2d 69 74 65 6d 73 20 22 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e nsult-imenu--items."consult-imen
26c00 75 22 29 0a 0a 28 64 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 u")..(defun.embark-consult-imenu
26c20 2d 63 61 6e 64 69 64 61 74 65 73 20 28 29 0a 20 20 22 43 6f 6c 6c 65 63 74 20 61 6c 6c 20 69 6d -candidates.()..."Collect.all.im
26c40 65 6e 75 20 69 74 65 6d 73 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2e enu.items.in.the.current.buffer.
26c60 22 0a 20 20 28 63 6f 6e 73 20 27 69 6d 65 6e 75 20 28 6d 61 70 63 61 72 20 23 27 63 61 72 20 28 "...(cons.'imenu.(mapcar.#'car.(
26c80 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 2d 69 74 65 6d 73 29 29 29 29 0a 0a 28 64 65 63 6c 61 consult-imenu--items))))..(decla
26ca0 72 65 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 2d 67 72 6f 75 70 re-function.consult-imenu--group
26cc0 20 22 65 78 74 3a 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 22 29 0a 0a 28 64 65 66 75 6e 20 65 6d ."ext:consult-imenu")..(defun.em
26ce0 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 2d 69 6d 65 6e 75 2d 67 72 6f 75 70 2d 66 75 6e 63 74 69 bark-consult--imenu-group-functi
26d00 6f 6e 20 28 74 79 70 65 20 70 72 6f 70 29 0a 20 20 22 52 65 74 75 72 6e 20 61 20 73 75 69 74 61 on.(type.prop)..."Return.a.suita
26d20 62 6c 65 20 67 72 6f 75 70 2d 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 69 6d 65 6e 75 2e 0a 54 59 ble.group-function.for.imenu..TY
26d40 50 45 20 69 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 74 65 67 6f 72 79 2e 0a 50 PE.is.the.completion.category..P
26d60 52 4f 50 20 69 73 20 74 68 65 20 6d 65 74 61 64 61 74 61 20 70 72 6f 70 65 72 74 79 2e 0a 4d 65 ROP.is.the.metadata.property..Me
26d80 61 6e 74 20 61 73 20 3a 61 66 74 65 72 2d 75 6e 74 69 6c 20 61 64 76 69 63 65 20 66 6f 72 20 60 ant.as.:after-until.advice.for.`
26da0 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 2d 2d 6d 65 74 61 64 61 74 75 6d 27 2e 22 0a 20 20 28 embark-collect--metadatum'."...(
26dc0 77 68 65 6e 20 28 61 6e 64 20 28 65 71 20 74 79 70 65 20 27 69 6d 65 6e 75 29 20 28 65 71 20 70 when.(and.(eq.type.'imenu).(eq.p
26de0 72 6f 70 20 27 67 72 6f 75 70 2d 66 75 6e 63 74 69 6f 6e 29 29 0a 20 20 20 20 28 63 6f 6e 73 75 rop.'group-function)).....(consu
26e00 6c 74 2d 69 6d 65 6e 75 2d 2d 67 72 6f 75 70 29 29 29 0a 0a 28 61 64 76 69 63 65 2d 61 64 64 20 lt-imenu--group)))..(advice-add.
26e20 23 27 65 6d 62 61 72 6b 2d 63 6f 6c 6c 65 63 74 2d 2d 6d 65 74 61 64 61 74 75 6d 20 3a 61 66 74 #'embark-collect--metadatum.:aft
26e40 65 72 2d 75 6e 74 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f er-until.............#'embark-co
26e60 6e 73 75 6c 74 2d 2d 69 6d 65 6e 75 2d 67 72 6f 75 70 2d 66 75 6e 63 74 69 6f 6e 29 0a 0a 28 64 nsult--imenu-group-function)..(d
26e80 65 66 75 6e 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 6f 72 2d 6f 75 74 efun.embark-consult-imenu-or-out
26ea0 6c 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 20 28 29 0a 20 20 22 43 6f 6c 6c 65 63 74 20 69 6d line-candidates.()..."Collect.im
26ec0 65 6e 75 20 69 74 65 6d 73 20 69 6e 20 70 72 6f 67 20 6d 6f 64 65 73 20 62 75 66 66 65 72 20 6f enu.items.in.prog.modes.buffer.o
26ee0 72 20 6f 75 74 6c 69 6e 65 20 68 65 61 64 69 6e 67 73 20 6f 74 68 65 72 77 69 73 65 2e 22 0a 20 r.outline.headings.otherwise."..
26f00 20 28 69 66 20 28 64 65 72 69 76 65 64 2d 6d 6f 64 65 2d 70 20 27 70 72 6f 67 2d 6d 6f 64 65 29 .(if.(derived-mode-p.'prog-mode)
26f20 0a 20 20 20 20 20 20 28 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 63 61 6e .......(embark-consult-imenu-can
26f40 64 69 64 61 74 65 73 29 0a 20 20 20 20 28 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 6f 75 74 didates).....(embark-consult-out
26f60 6c 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 73 29 29 29 0a 0a 28 73 65 74 66 20 28 61 6c 69 73 74 line-candidates)))..(setf.(alist
26f80 2d 67 65 74 20 27 69 6d 65 6e 75 20 65 6d 62 61 72 6b 2d 64 65 66 61 75 6c 74 2d 61 63 74 69 6f -get.'imenu.embark-default-actio
26fa0 6e 2d 6f 76 65 72 72 69 64 65 73 29 20 27 63 6f 6e 73 75 6c 74 2d 69 6d 65 6e 75 29 0a 0a 28 61 n-overrides).'consult-imenu)..(a
26fc0 64 64 2d 74 6f 2d 6c 69 73 74 20 27 65 6d 62 61 72 6b 2d 63 61 6e 64 69 64 61 74 65 2d 63 6f 6c dd-to-list.'embark-candidate-col
26fe0 6c 65 63 74 6f 72 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 65 6d 62 61 72 6b 2d 63 6f lectors..............#'embark-co
27000 6e 73 75 6c 74 2d 69 6d 65 6e 75 2d 6f 72 2d 6f 75 74 6c 69 6e 65 2d 63 61 6e 64 69 64 61 74 65 nsult-imenu-or-outline-candidate
27020 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 27 61 70 70 65 6e 64 29 0a 0a 28 70 72 6f 76 69 64 s..............'append)..(provid
27040 65 20 27 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 29 0a 3b 3b 3b 20 65 6d 62 61 72 6b 2d 63 6f e.'embark-consult).;;;.embark-co
27060 6e 73 75 6c 74 2e 65 6c 20 65 6e 64 73 20 68 65 72 65 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 nsult.el.ends.here..............
27080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
270a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
270c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
270e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
271a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
271c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
271e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27200 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c embark-consult-1.1/embark-consul
27220 74 2d 70 6b 67 2e 65 6c 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 t-pkg.el........................
27240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27260 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
27280 30 30 30 30 37 32 37 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 36 37 37 35 00 20 30 00 00 00 0000727.00000000000.016775..0...
272a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
272c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
272e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27300 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
27320 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
27340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
273a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
273c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
273e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27400 3b 3b 20 47 65 6e 65 72 61 74 65 64 20 70 61 63 6b 61 67 65 20 64 65 73 63 72 69 70 74 69 6f 6e ;;.Generated.package.description
27420 20 66 72 6f 6d 20 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2e 65 6c 20 20 2d 2a 2d 20 6e 6f 2d .from.embark-consult.el..-*-.no-
27440 62 79 74 65 2d 63 6f 6d 70 69 6c 65 3a 20 74 20 2d 2a 2d 0a 28 64 65 66 69 6e 65 2d 70 61 63 6b byte-compile:.t.-*-.(define-pack
27460 61 67 65 20 22 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 22 20 22 31 2e 31 22 20 22 43 6f 6e 73 age."embark-consult"."1.1"."Cons
27480 75 6c 74 20 69 6e 74 65 67 72 61 74 69 6f 6e 20 66 6f 72 20 45 6d 62 61 72 6b 22 20 27 28 28 65 ult.integration.for.Embark".'((e
274a0 6d 61 63 73 20 22 32 37 2e 31 22 29 20 28 63 6f 6d 70 61 74 20 22 32 39 2e 31 2e 34 2e 30 22 29 macs."27.1").(compat."29.1.4.0")
274c0 20 28 65 6d 62 61 72 6b 20 22 31 2e 30 22 29 20 28 63 6f 6e 73 75 6c 74 20 22 31 2e 30 22 29 29 .(embark."1.0").(consult."1.0"))
274e0 20 3a 63 6f 6d 6d 69 74 20 22 31 39 35 61 64 64 31 66 31 63 63 64 31 30 35 39 34 37 32 63 39 64 .:commit."195add1f1ccd1059472c9d
27500 66 37 33 33 34 63 39 37 63 34 64 31 35 35 34 32 35 65 22 20 3a 61 75 74 68 6f 72 73 20 27 28 28 f7334c97c4d155425e".:authors.'((
27520 22 4f 6d 61 72 20 41 6e 74 6f 6c c3 ad 6e 20 43 61 6d 61 72 65 6e 61 22 20 2e 20 22 6f 6d 61 72 "Omar.Antol..n.Camarena"..."omar
27540 40 6d 61 74 65 6d 2e 75 6e 61 6d 2e 6d 78 22 29 29 20 3a 6d 61 69 6e 74 61 69 6e 65 72 20 27 28 @matem.unam.mx")).:maintainer.'(
27560 22 4f 6d 61 72 20 41 6e 74 6f 6c c3 ad 6e 20 43 61 6d 61 72 65 6e 61 22 20 2e 20 22 6f 6d 61 72 "Omar.Antol..n.Camarena"..."omar
27580 40 6d 61 74 65 6d 2e 75 6e 61 6d 2e 6d 78 22 29 20 3a 6b 65 79 77 6f 72 64 73 20 27 28 22 63 6f @matem.unam.mx").:keywords.'("co
275a0 6e 76 65 6e 69 65 6e 63 65 22 29 20 3a 75 72 6c 20 22 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 nvenience").:url."https://github
275c0 2e 63 6f 6d 2f 6f 61 6e 74 6f 6c 69 6e 2f 65 6d 62 61 72 6b 22 29 0a 00 00 00 00 00 00 00 00 00 .com/oantolin/embark")..........
275e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27600 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 2e 64 69 72 2d 6c 6f 63 61 6c 73 2e 65 embark-consult-1.1/.dir-locals.e
27620 6c 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 l...............................
27640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27660 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
27680 30 30 30 30 32 36 31 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 35 33 37 30 00 20 30 00 00 00 0000261.00000000000.015370..0...
276a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
276c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
276e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27700 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
27720 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
27740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
277a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
277c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
277e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27800 3b 3b 3b 20 44 69 72 65 63 74 6f 72 79 20 4c 6f 63 61 6c 20 56 61 72 69 61 62 6c 65 73 0a 3b 3b ;;;.Directory.Local.Variables.;;
27820 3b 20 46 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 65 65 20 28 69 6e 66 6f ;.For.more.information.see.(info
27840 20 22 28 65 6d 61 63 73 29 20 44 69 72 65 63 74 6f 72 79 20 56 61 72 69 61 62 6c 65 73 22 29 0a ."(emacs).Directory.Variables").
27860 0a 28 28 65 6d 61 63 73 2d 6c 69 73 70 2d 6d 6f 64 65 0a 20 20 28 73 68 6f 77 2d 74 72 61 69 6c .((emacs-lisp-mode...(show-trail
27880 69 6e 67 2d 77 68 69 74 65 73 70 61 63 65 20 2e 20 74 29 0a 20 20 28 69 6e 64 65 6e 74 2d 74 61 ing-whitespace...t)...(indent-ta
278a0 62 73 2d 6d 6f 64 65 20 2e 20 6e 69 6c 29 29 29 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 bs-mode...nil)))................
278c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
278e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27900 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27920 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
279a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
279c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
279e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27a00 65 6d 62 61 72 6b 2d 63 6f 6e 73 75 6c 74 2d 31 2e 31 2f 2e 65 6c 70 61 69 67 6e 6f 72 65 00 00 embark-consult-1.1/.elpaignore..
27a20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27a40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27a60 00 00 00 00 30 30 30 30 36 34 34 00 30 30 30 30 30 30 30 00 30 30 30 30 30 30 30 00 30 30 30 30 ....0000644.0000000.0000000.0000
27a80 30 30 30 30 30 30 37 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 35 30 36 33 00 20 30 00 00 00 0000007.00000000000.015063..0...
27aa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27b00 00 75 73 74 61 72 20 20 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ustar...root...................
27b20 00 00 00 00 00 00 00 00 00 72 6f 6f 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .........root...................
27b40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27b60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27b80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27bc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27be0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27c00 4c 49 43 45 4e 53 45 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 LICENSE.........................
27c20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27c40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27c60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27c80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27cc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27d00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27d20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27d40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27d60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27d80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27da0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27dc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27de0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27e00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27e20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27e40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27e60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27e80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ea0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ec0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27ee0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27f00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27f20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27f40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27f60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27f80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27fa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27fc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27fe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
280a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
280c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
280e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
281a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
281c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
281e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28260 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28280 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
282a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
282c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
282e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28300 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28320 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
283a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
283c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
283e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28400 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28460 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28480 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
284a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
284c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
284e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28500 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28520 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
285a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
285c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
285e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28600 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28620 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28660 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28680 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
286a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
286c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
286e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28700 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28720 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
287a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
287c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
287e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28800 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28840 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28860 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28880 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
288a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
288c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
288e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28900 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28920 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
289a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
289c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
289e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28a00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28a20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28a40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28a60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28a80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28aa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28b00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28b20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28b40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28b60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28b80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28bc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28be0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28c00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28c20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28c40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28c60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28c80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28cc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28d00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28d20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28d40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28d60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28d80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28da0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28dc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28de0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28e00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28e20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28e40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28e60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28e80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ea0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ec0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28ee0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28f00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28f20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28f40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28f60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28f80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28fa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28fc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28fe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
290a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
290c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
290e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
291a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
291c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
291e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29260 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29280 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
292a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
292c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
292e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29300 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29320 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
293a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
293c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
293e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29400 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29460 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29480 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
294a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
294c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
294e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29500 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29520 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
295a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
295c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
295e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29600 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29620 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29660 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29680 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
296a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
296c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
296e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29700 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29720 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
297a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
297c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
297e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29800 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29840 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29860 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29880 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
298a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
298c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
298e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29900 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29920 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
299a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
299c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
299e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29a00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29a20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29a40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29a60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29a80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29aa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29b00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29b20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29b40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29b60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29b80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29bc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29be0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29c00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29c20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29c40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29c60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29c80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29cc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29d00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29d20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29d40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29d60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29d80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29da0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29dc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29de0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29e00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29e20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29e40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29e60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29e80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ea0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ec0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29ee0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29f00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29f20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29f40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29f60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29f80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29fa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29fc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29fe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a0a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a0c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a0e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a1a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a1c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a1e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a260 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a280 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a2a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a2c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a2e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a300 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a320 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a3a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a3c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a3e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a400 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a460 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a480 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a4a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a4c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a4e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a500 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a520 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a5a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a5c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a5e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a600 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a620 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a660 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a680 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a6a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a6c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a6e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a700 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a720 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a7a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a7c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a7e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
generated by cgit v1.2.3 (git 2.25.1) at 2025-10-26 21:21:30 +0000