summaryrefslogtreecommitdiff
path: root/.localrepo/transient-0.10.0.tar
blob: 54e96dd3f52abafa411a4fa5e1392c30d19d08df (plain)
ofshex dumpascii
0000 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 transient-0.10.0/...............
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 32 33 36 00 20 35 00 00 00 0000000.00000000000.012236..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 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 52 45 41 44 4d 45 2e 6f 72 67 00 00 00 00 00 transient-0.10.0/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 30 31 30 30 31 35 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 33 37 30 31 00 20 30 00 00 00 0010015.00000000000.013701..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 2a 20 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 6d 65 6e 75 73 0a 0a 54 72 61 6e 73 *.Transient.command.menus..Trans
0420 69 65 6e 74 20 69 73 20 74 68 65 20 6c 69 62 72 61 72 79 20 75 73 65 64 20 74 6f 20 69 6d 70 6c ient.is.the.library.used.to.impl
0440 65 6d 65 6e 74 20 74 68 65 20 6b 65 79 62 6f 61 72 64 2d 64 72 69 76 65 6e 20 e2 80 9c 6d 65 6e ement.the.keyboard-driven....men
0460 75 73 e2 80 9d 0a 69 6e 20 5b 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 us....in.[[https://github.com/ma
0480 67 69 74 2f 6d 61 67 69 74 2f 5d 5b 4d 61 67 69 74 5d 5d 2e 20 20 49 74 20 69 73 20 64 69 73 74 git/magit/][Magit]]...It.is.dist
04a0 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 70 61 72 61 74 65 20 70 61 63 6b 61 67 65 2c 20 73 ributed.as.a.separate.package,.s
04c0 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 o.that.it.can.be.used.to.impleme
04e0 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 73 20 69 6e 20 5b 5b 68 74 74 70 73 3a 2f 2f 6d 65 nt.similar.menus.in.[[https://me
0500 6c 70 61 2e 6f 72 67 2f 23 2f 74 72 61 6e 73 69 65 6e 74 5d 5b 6f 74 68 65 72 20 70 61 63 6b 61 lpa.org/#/transient][other.packa
0520 67 65 73 5d 5d 2e 0a 0a 2a 2a 20 53 6f 6d 65 20 74 68 69 6e 67 73 20 74 68 61 74 20 54 72 61 6e ges]]...**.Some.things.that.Tran
0540 73 69 65 6e 74 20 63 61 6e 20 64 6f 0a 0a 2d 20 44 69 73 70 6c 61 79 20 63 75 72 72 65 6e 74 20 sient.can.do..-.Display.current.
0560 73 74 61 74 65 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 0a 2d 20 44 69 73 70 6c 61 79 20 61 6e 64 state.of.arguments.-.Display.and
0580 20 6d 61 6e 61 67 65 20 6c 69 66 65 63 79 63 6c 65 20 6f 66 20 6d 6f 64 61 6c 20 62 69 6e 64 69 .manage.lifecycle.of.modal.bindi
05a0 6e 67 73 0a 2d 20 43 6f 6e 74 65 78 74 75 61 6c 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 0a ngs.-.Contextual.user.interface.
05c0 2d 20 46 6c 6f 77 20 63 6f 6e 74 72 6f 6c 20 66 6f 72 20 77 69 7a 61 72 64 2d 6c 69 6b 65 20 63 -.Flow.control.for.wizard-like.c
05e0 6f 6d 70 6f 73 69 74 69 6f 6e 20 6f 66 20 69 6e 74 65 72 61 63 74 69 76 65 20 66 6f 72 6d 73 0a omposition.of.interactive.forms.
0600 2d 20 48 69 73 74 6f 72 79 20 26 20 70 65 72 73 69 73 74 65 6e 63 65 0a 2d 20 52 65 6e 64 65 72 -.History.&.persistence.-.Render
0620 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 66 6f 72 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 43 4c ing.arguments.for.controlling.CL
0640 49 20 70 72 6f 67 72 61 6d 73 0a 0a 2a 2a 20 43 6f 6d 70 6c 65 78 69 74 79 20 69 6e 20 43 4c 49 I.programs..**.Complexity.in.CLI
0660 20 70 72 6f 67 72 61 6d 73 0a 0a 43 6f 6d 70 6c 65 78 69 74 79 20 74 65 6e 64 73 20 74 6f 20 67 .programs..Complexity.tends.to.g
0680 72 6f 77 20 77 69 74 68 20 74 69 6d 65 2e 20 20 48 6f 77 20 64 6f 20 79 6f 75 20 6d 61 6e 61 67 row.with.time...How.do.you.manag
06a0 65 20 74 68 65 20 63 6f 6d 70 6c 65 78 69 74 79 0a 6f 66 20 63 6f 6d 6d 61 6e 64 73 3f 20 20 43 e.the.complexity.of.commands?..C
06c0 6f 6e 73 69 64 65 72 20 74 68 65 20 68 75 6d 62 6c 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 onsider.the.humble.shell.command
06e0 20 3d 6c 73 3d 2e 20 20 49 74 20 6e 6f 77 20 68 61 73 20 6f 76 65 72 0a 2f 66 69 66 74 79 2f 20 .=ls=...It.now.has.over./fifty/.
0700 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 2e 20 20 53 6f 6d 65 20 6f 66 20 74 command.line.options...Some.of.t
0720 68 65 73 65 20 61 72 65 20 62 6f 6f 6c 65 61 6e 20 66 6c 61 67 73 20 28 3d 6c 73 20 2d 6c 3d 29 hese.are.boolean.flags.(=ls.-l=)
0740 2e 0a 53 6f 6d 65 20 74 61 6b 65 20 61 72 67 75 6d 65 6e 74 73 20 28 3d 6c 73 20 2d 2d 73 6f 72 ..Some.take.arguments.(=ls.--sor
0760 74 3d 73 3d 29 2e 20 20 53 6f 6d 65 20 68 61 76 65 20 6e 6f 20 65 66 66 65 63 74 20 75 6e 6c 65 t=s=)...Some.have.no.effect.unle
0780 73 73 20 70 61 69 72 65 64 0a 77 69 74 68 20 6f 74 68 65 72 20 66 6c 61 67 73 20 28 3d 6c 73 20 ss.paired.with.other.flags.(=ls.
07a0 2d 6c 68 3d 29 2e 20 20 53 6f 6d 65 20 61 72 65 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 -lh=)...Some.are.mutually.exclus
07c0 69 76 65 2e 20 20 53 6f 6d 65 20 73 68 65 6c 6c 0a 63 6f 6d 6d 61 6e 64 73 20 65 76 65 6e 20 68 ive...Some.shell.commands.even.h
07e0 61 76 65 20 73 6f 20 6d 61 6e 79 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 68 65 79 20 69 6e ave.so.many.options.that.they.in
0800 74 72 6f 64 75 63 65 20 2f 73 75 62 63 6f 6d 6d 61 6e 64 73 2f 0a 28 3d 67 69 74 20 62 72 61 6e troduce./subcommands/.(=git.bran
0820 63 68 3d 2c 20 3d 67 69 74 20 63 6f 6d 6d 69 74 3d 29 2c 20 65 61 63 68 20 77 69 74 68 20 74 68 ch=,.=git.commit=),.each.with.th
0840 65 69 72 20 6f 77 6e 20 72 69 63 68 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e 73 0a 28 3d 67 69 eir.own.rich.set.of.options.(=gi
0860 74 20 62 72 61 6e 63 68 20 2d 66 3d 29 2e 0a 0a 2a 2a 20 55 73 69 6e 67 20 54 72 61 6e 73 69 65 t.branch.-f=)...**.Using.Transie
0880 6e 74 20 66 6f 72 20 63 6f 6d 70 6f 73 69 6e 67 20 69 6e 74 65 72 61 63 74 69 76 65 20 63 6f 6d nt.for.composing.interactive.com
08a0 6d 61 6e 64 73 0a 0a 57 68 61 74 20 61 62 6f 75 74 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 mands..What.about.Emacs.commands
08c0 20 75 73 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 3f 20 48 6f 77 20 64 6f 20 74 68 65 73 .used.interactively?.How.do.thes
08e0 65 20 68 61 6e 64 6c 65 0a 6f 70 74 69 6f 6e 73 3f 20 20 4f 6e 65 20 73 6f 6c 75 74 69 6f 6e 20 e.handle.options?..One.solution.
0900 69 73 20 74 6f 20 6d 61 6b 65 20 6d 61 6e 79 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 is.to.make.many.versions.of.the.
0920 73 61 6d 65 20 63 6f 6d 6d 61 6e 64 2c 0a 73 6f 20 79 6f 75 20 64 6f 6e 27 74 20 6e 65 65 64 20 same.command,.so.you.don't.need.
0940 74 6f 21 20 43 6f 6e 73 69 64 65 72 3a 20 3d 64 65 6c 65 74 65 2d 6f 74 68 65 72 2d 77 69 6e 64 to!.Consider:.=delete-other-wind
0960 6f 77 73 3d 20 76 73 2e 0a 3d 64 65 6c 65 74 65 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 73 2d 76 ows=.vs..=delete-other-windows-v
0980 65 72 74 69 63 61 6c 6c 79 3d 20 28 61 6d 6f 6e 67 20 6d 61 6e 79 20 73 69 6d 69 6c 61 72 20 65 ertically=.(among.many.similar.e
09a0 78 61 6d 70 6c 65 73 29 2e 0a 0a 53 6f 6d 65 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 20 77 xamples)...Some.Emacs.commands.w
09c0 69 6c 6c 20 73 69 6d 70 6c 79 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 74 68 65 20 6e 65 ill.simply.prompt.you.for.the.ne
09e0 78 74 20 22 61 72 67 75 6d 65 6e 74 22 0a 28 3d 4d 2d 78 20 73 77 69 74 63 68 2d 74 6f 2d 62 75 xt."argument".(=M-x.switch-to-bu
0a00 66 66 65 72 3d 29 2e 20 20 41 6e 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e 20 73 6f 6c 75 74 69 6f 6e ffer=)...Another.common.solution
0a20 20 69 73 20 74 6f 20 75 73 65 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 20 77 68 69 63 .is.to.use.prefix.arguments.whic
0a40 68 20 75 73 75 61 6c 6c 79 20 73 74 61 72 74 20 77 69 74 68 20 3d 43 2d 75 3d 2e 20 20 53 6f 6d h.usually.start.with.=C-u=...Som
0a60 65 74 69 6d 65 73 20 74 68 65 73 65 20 61 72 65 20 73 65 6e 73 69 62 6c 79 0a 6e 75 6d 65 72 69 etimes.these.are.sensibly.numeri
0a80 63 61 6c 20 69 6e 20 6e 61 74 75 72 65 20 28 3d 43 2d 75 20 34 20 4d 2d 78 20 66 6f 72 77 61 72 cal.in.nature.(=C-u.4.M-x.forwar
0aa0 64 2d 70 61 72 61 67 72 61 70 68 3d 20 74 6f 20 6d 6f 76 65 20 66 6f 72 77 61 72 64 20 34 0a 70 d-paragraph=.to.move.forward.4.p
0ac0 61 72 61 67 72 61 70 68 73 29 2e 20 20 42 75 74 20 73 6f 6d 65 74 69 6d 65 73 20 74 68 65 79 20 aragraphs)...But.sometimes.they.
0ae0 66 75 6e 63 74 69 6f 6e 20 69 6e 73 74 65 61 64 20 61 73 20 62 6f 6f 6c 65 61 6e 0a 22 73 77 69 function.instead.as.boolean."swi
0b00 74 63 68 65 73 22 20 28 3d 43 2d 75 20 43 2d 53 50 41 43 45 3d 20 74 6f 20 6a 75 6d 70 20 74 6f tches".(=C-u.C-SPACE=.to.jump.to
0b20 20 74 68 65 20 6c 61 73 74 20 6d 61 72 6b 20 69 6e 73 74 65 61 64 20 6f 66 20 6a 75 73 74 0a 73 .the.last.mark.instead.of.just.s
0b40 65 74 74 69 6e 67 20 69 74 2c 20 3d 43 2d 75 20 43 2d 75 20 43 2d 53 50 41 43 45 3d 20 74 6f 20 etting.it,.=C-u.C-u.C-SPACE=.to.
0b60 75 6e 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 73 65 74 20 74 68 65 20 6d 61 72 6b 29 2e 20 20 unconditionally.set.the.mark)...
0b80 53 69 6e 63 65 0a 74 68 65 72 65 20 61 72 65 6e 27 74 20 6d 61 6e 79 20 73 74 61 6e 64 61 72 64 Since.there.aren't.many.standard
0ba0 73 20 66 6f 72 20 74 68 65 20 75 73 65 20 6f 66 20 70 72 65 66 69 78 20 6f 70 74 69 6f 6e 73 2c s.for.the.use.of.prefix.options,
0bc0 20 79 6f 75 20 68 61 76 65 20 74 6f 0a 72 65 61 64 20 74 68 65 20 63 6f 6d 6d 61 6e 64 27 73 20 .you.have.to.read.the.command's.
0be0 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68 61 74 20 74 documentation.to.find.out.what.t
0c00 68 65 20 70 6f 73 73 69 62 69 6c 69 74 69 65 73 0a 61 72 65 2e 0a 0a 42 75 74 20 77 68 65 6e 20 he.possibilities.are...But.when.
0c20 61 6e 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 20 67 72 6f 77 73 20 74 6f 20 68 61 76 65 20 61 an.Emacs.command.grows.to.have.a
0c40 20 74 72 75 6c 79 20 6c 61 72 67 65 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e 73 0a 61 6e 64 20 .truly.large.set.of.options.and.
0c60 61 72 67 75 6d 65 6e 74 73 2c 20 77 69 74 68 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 62 65 74 arguments,.with.dependencies.bet
0c80 77 65 65 6e 20 74 68 65 6d 2c 20 6c 6f 74 73 20 6f 66 20 6f 70 74 69 6f 6e 20 76 61 6c 75 65 73 ween.them,.lots.of.option.values
0ca0 2c 0a 65 74 63 2e 2c 20 74 68 65 73 65 20 73 69 6d 70 6c 65 20 61 70 70 72 6f 61 63 68 65 73 20 ,.etc.,.these.simple.approaches.
0cc0 6a 75 73 74 20 64 6f 6e 27 74 20 73 63 61 6c 65 2e 20 20 54 72 61 6e 73 69 65 6e 74 20 69 73 20 just.don't.scale...Transient.is.
0ce0 64 65 73 69 67 6e 65 64 0a 74 6f 20 73 6f 6c 76 65 20 74 68 69 73 20 69 73 73 75 65 2e 20 20 54 designed.to.solve.this.issue...T
0d00 68 69 6e 6b 20 6f 66 20 69 74 20 61 73 20 74 68 65 20 68 75 6d 62 6c 65 20 70 72 65 66 69 78 20 hink.of.it.as.the.humble.prefix.
0d20 61 72 67 75 6d 65 6e 74 20 3d 43 2d 75 3d 2c 0a 2f 72 61 69 73 65 64 20 74 6f 20 74 68 65 20 70 argument.=C-u=,./raised.to.the.p
0d40 6f 77 65 72 20 6f 66 20 31 30 2f 2e 20 20 4c 69 6b 65 20 3d 43 2d 75 3d 2c 20 69 74 20 69 73 20 ower.of.10/...Like.=C-u=,.it.is.
0d60 6b 65 79 20 64 72 69 76 65 6e 2e 20 20 4c 69 6b 65 20 74 68 65 0a 73 68 65 6c 6c 2c 20 69 74 20 key.driven...Like.the.shell,.it.
0d80 73 75 70 70 6f 72 74 73 20 62 6f 6f 6c 65 61 6e 20 22 66 6c 61 67 22 20 6f 70 74 69 6f 6e 73 2c supports.boolean."flag".options,
0da0 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 61 6b 65 0a 61 72 67 75 6d 65 6e 74 73 2c 20 61 6e .options.that.take.arguments,.an
0dc0 64 20 65 76 65 6e 20 22 73 75 62 2d 63 6f 6d 6d 61 6e 64 73 22 2c 20 77 69 74 68 20 74 68 65 69 d.even."sub-commands",.with.thei
0de0 72 20 6f 77 6e 20 6f 70 74 69 6f 6e 73 2e 20 20 42 75 74 0a 69 6e 73 74 65 61 64 20 6f 66 20 73 r.own.options...But.instead.of.s
0e00 65 61 72 63 68 69 6e 67 20 74 68 72 6f 75 67 68 20 61 20 6d 61 6e 20 70 61 67 65 20 6f 72 20 63 earching.through.a.man.page.or.c
0e20 6f 6d 6d 61 6e 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 0a 77 65 6c 6c 2d 64 65 73 69 67 ommand.documentation,.well-desig
0e40 6e 65 64 20 74 72 61 6e 73 69 65 6e 74 73 20 2f 67 75 69 64 65 2f 20 74 68 65 69 72 20 75 73 65 ned.transients./guide/.their.use
0e60 72 73 20 74 6f 20 74 68 65 20 72 65 6c 65 76 61 6e 74 20 73 65 74 20 6f 66 0a 6f 70 74 69 6f 6e rs.to.the.relevant.set.of.option
0e80 73 20 28 61 6e 64 20 65 76 65 6e 20 74 68 65 69 72 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 s.(and.even.their.possible.value
0ea0 73 21 29 20 64 69 72 65 63 74 6c 79 2c 20 74 61 6b 69 6e 67 20 69 6e 74 6f 0a 61 63 63 6f 75 6e s!).directly,.taking.into.accoun
0ec0 74 20 61 6e 79 20 69 6d 70 6f 72 74 61 6e 74 20 70 72 65 2d 65 78 69 73 74 69 6e 67 20 45 6d 61 t.any.important.pre-existing.Ema
0ee0 63 73 20 73 65 74 74 69 6e 67 73 2e 20 20 41 6e 64 20 77 68 69 6c 65 20 66 6f 72 0a 73 68 65 6c cs.settings...And.while.for.shel
0f00 6c 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 3d 6c 73 3d 2c 20 74 68 65 72 65 20 69 73 20 6f l.commands.like.=ls=,.there.is.o
0f20 6e 6c 79 20 6f 6e 65 20 77 61 79 20 74 6f 20 22 65 78 65 63 75 74 65 22 20 28 68 69 74 0a 3d 52 nly.one.way.to."execute".(hit.=R
0f40 65 74 75 72 6e 3d 21 29 2c 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 22 65 78 65 63 75 74 eturn=!),.transients.can."execut
0f60 65 22 20 75 73 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 64 69 66 66 65 72 65 6e 74 20 6b 65 79 73 e".using.multiple.different.keys
0f80 20 74 69 65 64 0a 74 6f 20 6f 6e 65 20 6f 66 20 6d 61 6e 79 20 73 65 6c 66 2d 64 6f 63 75 6d 65 .tied.to.one.of.many.self-docume
0fa0 6e 74 69 6e 67 20 2f 61 63 74 69 6f 6e 73 2f 20 28 69 6d 61 67 69 6e 65 20 68 61 76 69 6e 67 20 nting./actions/.(imagine.having.
0fc0 35 20 64 69 66 66 65 72 65 6e 74 0a 63 6f 6c 6f 72 65 64 20 72 65 74 75 72 6e 20 6b 65 79 73 20 5.different.colored.return.keys.
0fe0 6f 6e 20 79 6f 75 72 20 6b 65 79 62 6f 61 72 64 21 29 2e 20 20 54 72 61 6e 73 69 65 6e 74 73 20 on.your.keyboard!)...Transients.
1000 6d 61 6b 65 20 6e 61 76 69 67 61 74 69 6e 67 0a 61 6e 64 20 73 65 74 74 69 6e 67 20 6c 61 72 67 make.navigating.and.setting.larg
1020 65 2c 20 63 6f 6d 70 6c 65 78 20 67 72 6f 75 70 73 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 6f 70 74 e,.complex.groups.of.command.opt
1040 69 6f 6e 73 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 0a 65 61 73 79 2e 20 20 46 75 6e 20 65 76 ions.and.arguments.easy...Fun.ev
1060 65 6e 2e 20 20 4f 6e 63 65 20 79 6f 75 27 76 65 20 74 72 69 65 64 20 69 74 2c 20 69 74 27 73 20 en...Once.you've.tried.it,.it's.
1080 68 61 72 64 20 74 6f 20 67 6f 20 62 61 63 6b 20 74 6f 20 74 68 65 0a 3d 43 2d 75 20 77 68 61 74 hard.to.go.back.to.the.=C-u.what
10a0 20 63 61 6e 20 49 20 64 6f 20 68 65 72 65 20 61 67 61 69 6e 3f 3d 20 77 61 79 2e 0a 0a 5b 5b 68 .can.I.do.here.again?=.way...[[h
10c0 74 74 70 3a 2f 2f 72 65 61 64 6d 65 2e 65 6d 61 63 73 61 69 72 2e 6d 65 2f 74 72 61 6e 73 69 65 ttp://readme.emacsair.me/transie
10e0 6e 74 2e 70 6e 67 5d 5d 0a 0a 23 2b 68 74 6d 6c 3a 20 3c 62 72 3e 3c 62 72 3e 0a 23 2b 68 74 6d nt.png]]..#+html:.<br><br>.#+htm
1100 6c 3a 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d l:.<a.href="https://github.com/m
1120 61 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 2f 61 63 74 69 6f 6e 73 2f 77 6f 72 6b 66 6c 6f 77 73 agit/transient/actions/workflows
1140 2f 63 6f 6d 70 69 6c 65 2e 79 6d 6c 22 3e 3c 69 6d 67 20 61 6c 74 3d 22 43 6f 6d 70 69 6c 65 22 /compile.yml"><img.alt="Compile"
1160 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 74 .src="https://github.com/magit/t
1180 72 61 6e 73 69 65 6e 74 2f 61 63 74 69 6f 6e 73 2f 77 6f 72 6b 66 6c 6f 77 73 2f 63 6f 6d 70 69 ransient/actions/workflows/compi
11a0 6c 65 2e 79 6d 6c 2f 62 61 64 67 65 2e 73 76 67 22 2f 3e 3c 2f 61 3e 0a 23 2b 68 74 6d 6c 3a 20 le.yml/badge.svg"/></a>.#+html:.
11c0 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 <a.href="https://github.com/magi
11e0 74 2f 74 72 61 6e 73 69 65 6e 74 2f 61 63 74 69 6f 6e 73 2f 77 6f 72 6b 66 6c 6f 77 73 2f 6d 61 t/transient/actions/workflows/ma
1200 6e 75 61 6c 2e 79 6d 6c 22 3e 3c 69 6d 67 20 61 6c 74 3d 22 4d 61 6e 75 61 6c 22 20 73 72 63 3d nual.yml"><img.alt="Manual".src=
1220 22 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 74 72 61 6e 73 69 "https://github.com/magit/transi
1240 65 6e 74 2f 61 63 74 69 6f 6e 73 2f 77 6f 72 6b 66 6c 6f 77 73 2f 6d 61 6e 75 61 6c 2e 79 6d 6c ent/actions/workflows/manual.yml
1260 2f 62 61 64 67 65 2e 73 76 67 22 2f 3e 3c 2f 61 3e 0a 23 2b 68 74 6d 6c 3a 20 3c 61 20 68 72 65 /badge.svg"/></a>.#+html:.<a.hre
1280 66 3d 22 68 74 74 70 73 3a 2f 2f 65 6c 70 61 2e 67 6e 75 2e 6f 72 67 2f 70 61 63 6b 61 67 65 73 f="https://elpa.gnu.org/packages
12a0 2f 74 72 61 6e 73 69 65 6e 74 2e 68 74 6d 6c 22 3e 3c 69 6d 67 20 61 6c 74 3d 22 47 4e 55 20 45 /transient.html"><img.alt="GNU.E
12c0 4c 50 41 22 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 65 6d 61 63 73 61 69 72 2e 6d 65 2f 61 73 LPA".src="https://emacsair.me/as
12e0 73 65 74 73 2f 62 61 64 67 65 73 2f 67 6e 75 2d 65 6c 70 61 2e 73 76 67 22 2f 3e 3c 2f 61 3e 0a sets/badges/gnu-elpa.svg"/></a>.
1300 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.
1320 6d 65 6c 70 61 2e 6f 72 67 2f 23 2f 74 72 61 6e 73 69 65 6e 74 22 3e 3c 69 6d 67 20 61 6c 74 3d melpa.org/#/transient"><img.alt=
1340 22 4d 45 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 "MELPA.Stable".src="https://stab
1360 6c 65 2e 6d 65 6c 70 61 2e 6f 72 67 2f 70 61 63 6b 61 67 65 73 2f 74 72 61 6e 73 69 65 6e 74 2d le.melpa.org/packages/transient-
1380 62 61 64 67 65 2e 73 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 badge.svg"/></a>.#+html:.<a.href
13a0 3d 22 68 74 74 70 73 3a 2f 2f 6d 65 6c 70 61 2e 6f 72 67 2f 23 2f 74 72 61 6e 73 69 65 6e 74 22 ="https://melpa.org/#/transient"
13c0 3e 3c 69 6d 67 20 61 6c 74 3d 22 4d 45 4c 50 41 22 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 6d ><img.alt="MELPA".src="https://m
13e0 65 6c 70 61 2e 6f 72 67 2f 70 61 63 6b 61 67 65 73 2f 74 72 61 6e 73 69 65 6e 74 2d 62 61 64 67 elpa.org/packages/transient-badg
1400 65 2e 73 76 67 22 2f 3e 3c 2f 61 3e 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 e.svg"/></a>....................
1420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1460 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1480 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
14a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
14c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
14e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1500 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1520 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
15a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
15c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
15e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1600 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 52 45 41 44 4d 45 2d 65 6c 70 61 00 00 00 00 transient-0.10.0/README-elpa....
1620 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1660 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
1680 30 30 30 37 34 36 31 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 34 30 34 35 00 20 30 00 00 00 0007461.00000000000.014045..0...
16a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
16c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
16e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1700 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...................
1720 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...................
1740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
17a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
17c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
17e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
1800 31 20 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 6d 65 6e 75 73 0a e2 95 90 e2 95 90 1.Transient.command.menus.......
1820 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 ................................
1840 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 ................................
1860 95 90 e2 95 90 0a 0a 20 20 54 72 61 6e 73 69 65 6e 74 20 69 73 20 74 68 65 20 6c 69 62 72 61 72 .........Transient.is.the.librar
1880 79 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 6b 65 79 62 6f 61 72 64 y.used.to.implement.the.keyboard
18a0 2d 64 72 69 76 65 6e 20 e2 80 9c 6d 65 6e 75 73 e2 80 9d 0a 20 20 69 6e 20 5b 4d 61 67 69 74 5d -driven....menus......in.[Magit]
18c0 2e 20 20 49 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 70 61 72 61 ...It.is.distributed.as.a.separa
18e0 74 65 20 70 61 63 6b 61 67 65 2c 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 0a 20 20 62 65 20 te.package,.so.that.it.can...be.
1900 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 73 20 used.to.implement.similar.menus.
1920 69 6e 20 5b 6f 74 68 65 72 20 70 61 63 6b 61 67 65 73 5d 2e 0a 0a 0a 5b 4d 61 67 69 74 5d 20 3c in.[other.packages]....[Magit].<
1940 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 6d 61 67 69 74 2f 3e https://github.com/magit/magit/>
1960 0a 0a 5b 6f 74 68 65 72 20 70 61 63 6b 61 67 65 73 5d 20 3c 68 74 74 70 73 3a 2f 2f 6d 65 6c 70 ..[other.packages].<https://melp
1980 61 2e 6f 72 67 2f 23 2f 74 72 61 6e 73 69 65 6e 74 3e 0a 0a 31 2e 31 20 53 6f 6d 65 20 74 68 69 a.org/#/transient>..1.1.Some.thi
19a0 6e 67 73 20 74 68 61 74 20 54 72 61 6e 73 69 65 6e 74 20 63 61 6e 20 64 6f 0a e2 94 80 e2 94 80 ngs.that.Transient.can.do.......
19c0 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 ................................
19e0 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 ................................
1a00 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 ................................
1a20 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 e2 80 a2 20 44 69 73 70 6c 61 79 20 63 75 72 72 65 6e 74 .................Display.current
1a40 20 73 74 61 74 65 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 0a 20 20 e2 80 a2 20 44 69 73 70 6c 61 .state.of.arguments.......Displa
1a60 79 20 61 6e 64 20 6d 61 6e 61 67 65 20 6c 69 66 65 63 79 63 6c 65 20 6f 66 20 6d 6f 64 61 6c 20 y.and.manage.lifecycle.of.modal.
1a80 62 69 6e 64 69 6e 67 73 0a 20 20 e2 80 a2 20 43 6f 6e 74 65 78 74 75 61 6c 20 75 73 65 72 20 69 bindings.......Contextual.user.i
1aa0 6e 74 65 72 66 61 63 65 0a 20 20 e2 80 a2 20 46 6c 6f 77 20 63 6f 6e 74 72 6f 6c 20 66 6f 72 20 nterface.......Flow.control.for.
1ac0 77 69 7a 61 72 64 2d 6c 69 6b 65 20 63 6f 6d 70 6f 73 69 74 69 6f 6e 20 6f 66 20 69 6e 74 65 72 wizard-like.composition.of.inter
1ae0 61 63 74 69 76 65 20 66 6f 72 6d 73 0a 20 20 e2 80 a2 20 48 69 73 74 6f 72 79 20 26 20 70 65 72 active.forms.......History.&.per
1b00 73 69 73 74 65 6e 63 65 0a 20 20 e2 80 a2 20 52 65 6e 64 65 72 69 6e 67 20 61 72 67 75 6d 65 6e sistence.......Rendering.argumen
1b20 74 73 20 66 6f 72 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 43 4c 49 20 70 72 6f 67 72 61 6d 73 0a ts.for.controlling.CLI.programs.
1b40 0a 0a 31 2e 32 20 43 6f 6d 70 6c 65 78 69 74 79 20 69 6e 20 43 4c 49 20 70 72 6f 67 72 61 6d 73 ..1.2.Complexity.in.CLI.programs
1b60 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 ................................
1b80 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 ................................
1ba0 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 20 43 ...............................C
1bc0 6f 6d 70 6c 65 78 69 74 79 20 74 65 6e 64 73 20 74 6f 20 67 72 6f 77 20 77 69 74 68 20 74 69 6d omplexity.tends.to.grow.with.tim
1be0 65 2e 20 20 48 6f 77 20 64 6f 20 79 6f 75 20 6d 61 6e 61 67 65 20 74 68 65 20 63 6f 6d 70 6c 65 e...How.do.you.manage.the.comple
1c00 78 69 74 79 0a 20 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 3f 20 20 43 6f 6e 73 69 64 65 72 20 74 68 xity...of.commands?..Consider.th
1c20 65 20 68 75 6d 62 6c 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 60 6c 73 27 2e 20 20 49 74 e.humble.shell.command.`ls'...It
1c40 20 6e 6f 77 20 68 61 73 20 6f 76 65 72 0a 20 20 2f 66 69 66 74 79 2f 20 63 6f 6d 6d 61 6e 64 20 .now.has.over.../fifty/.command.
1c60 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 2e 20 20 53 6f 6d 65 20 6f 66 20 74 68 65 73 65 20 61 72 65 line.options...Some.of.these.are
1c80 20 62 6f 6f 6c 65 61 6e 20 66 6c 61 67 73 20 28 60 6c 73 0a 20 20 2d 6c 27 29 2e 20 20 53 6f 6d .boolean.flags.(`ls...-l')...Som
1ca0 65 20 74 61 6b 65 20 61 72 67 75 6d 65 6e 74 73 20 28 60 6c 73 20 2d 2d 73 6f 72 74 3d 73 27 29 e.take.arguments.(`ls.--sort=s')
1cc0 2e 20 20 53 6f 6d 65 20 68 61 76 65 20 6e 6f 20 65 66 66 65 63 74 0a 20 20 75 6e 6c 65 73 73 20 ...Some.have.no.effect...unless.
1ce0 70 61 69 72 65 64 20 77 69 74 68 20 6f 74 68 65 72 20 66 6c 61 67 73 20 28 60 6c 73 20 2d 6c 68 paired.with.other.flags.(`ls.-lh
1d00 27 29 2e 20 20 53 6f 6d 65 20 61 72 65 20 6d 75 74 75 61 6c 6c 79 0a 20 20 65 78 63 6c 75 73 69 ')...Some.are.mutually...exclusi
1d20 76 65 2e 20 20 53 6f 6d 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 65 76 65 6e 20 68 61 ve...Some.shell.commands.even.ha
1d40 76 65 20 73 6f 20 6d 61 6e 79 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 68 65 79 0a 20 20 69 ve.so.many.options.that.they...i
1d60 6e 74 72 6f 64 75 63 65 20 2f 73 75 62 63 6f 6d 6d 61 6e 64 73 2f 20 28 60 67 69 74 20 62 72 61 ntroduce./subcommands/.(`git.bra
1d80 6e 63 68 27 2c 20 60 67 69 74 20 63 6f 6d 6d 69 74 27 29 2c 20 65 61 63 68 20 77 69 74 68 20 74 nch',.`git.commit'),.each.with.t
1da0 68 65 69 72 0a 20 20 6f 77 6e 20 72 69 63 68 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e 73 20 28 heir...own.rich.set.of.options.(
1dc0 60 67 69 74 20 62 72 61 6e 63 68 20 2d 66 27 29 2e 0a 0a 0a 31 2e 33 20 55 73 69 6e 67 20 54 72 `git.branch.-f')....1.3.Using.Tr
1de0 61 6e 73 69 65 6e 74 20 66 6f 72 20 63 6f 6d 70 6f 73 69 6e 67 20 69 6e 74 65 72 61 63 74 69 76 ansient.for.composing.interactiv
1e00 65 20 63 6f 6d 6d 61 6e 64 73 0a e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 e.commands......................
1e20 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 ................................
1e40 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 ................................
1e60 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 ................................
1e80 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 ................................
1ea0 80 e2 94 80 e2 94 80 e2 94 80 e2 94 80 0a 0a 20 20 57 68 61 74 20 61 62 6f 75 74 20 45 6d 61 63 .................What.about.Emac
1ec0 73 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 3f 20 48 s.commands.used.interactively?.H
1ee0 6f 77 20 64 6f 20 74 68 65 73 65 20 68 61 6e 64 6c 65 0a 20 20 6f 70 74 69 6f 6e 73 3f 20 20 4f ow.do.these.handle...options?..O
1f00 6e 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73 20 74 6f 20 6d 61 6b 65 20 6d 61 6e 79 20 76 65 72 73 ne.solution.is.to.make.many.vers
1f20 69 6f 6e 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20 63 6f 6d 6d 61 6e 64 2c 0a 20 20 73 6f 20 79 ions.of.the.same.command,...so.y
1f40 6f 75 20 64 6f 6e 27 74 20 6e 65 65 64 20 74 6f 21 20 43 6f 6e 73 69 64 65 72 3a 20 60 64 65 6c ou.don't.need.to!.Consider:.`del
1f60 65 74 65 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 73 27 20 76 73 2e 0a 20 20 60 64 65 6c 65 74 65 ete-other-windows'.vs....`delete
1f80 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 73 2d 76 65 72 74 69 63 61 6c 6c 79 27 20 28 61 6d 6f 6e -other-windows-vertically'.(amon
1fa0 67 20 6d 61 6e 79 20 73 69 6d 69 6c 61 72 20 65 78 61 6d 70 6c 65 73 29 2e 0a 0a 20 20 53 6f 6d g.many.similar.examples).....Som
1fc0 65 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 70 72 6f e.Emacs.commands.will.simply.pro
1fe0 6d 70 74 20 79 6f 75 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 22 61 72 67 75 6d 65 6e 74 22 0a mpt.you.for.the.next."argument".
2000 20 20 28 60 4d 2d 78 20 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 27 29 2e 20 20 41 6e 6f ..(`M-x.switch-to-buffer')...Ano
2020 74 68 65 72 20 63 6f 6d 6d 6f 6e 20 73 6f 6c 75 74 69 6f 6e 20 69 73 20 74 6f 20 75 73 65 20 70 ther.common.solution.is.to.use.p
2040 72 65 66 69 78 0a 20 20 61 72 67 75 6d 65 6e 74 73 20 77 68 69 63 68 20 75 73 75 61 6c 6c 79 20 refix...arguments.which.usually.
2060 73 74 61 72 74 20 77 69 74 68 20 60 43 2d 75 27 2e 20 20 53 6f 6d 65 74 69 6d 65 73 20 74 68 65 start.with.`C-u'...Sometimes.the
2080 73 65 20 61 72 65 0a 20 20 73 65 6e 73 69 62 6c 79 20 6e 75 6d 65 72 69 63 61 6c 20 69 6e 20 6e se.are...sensibly.numerical.in.n
20a0 61 74 75 72 65 20 28 60 43 2d 75 20 34 20 4d 2d 78 20 66 6f 72 77 61 72 64 2d 70 61 72 61 67 72 ature.(`C-u.4.M-x.forward-paragr
20c0 61 70 68 27 20 74 6f 20 6d 6f 76 65 0a 20 20 66 6f 72 77 61 72 64 20 34 20 70 61 72 61 67 72 61 aph'.to.move...forward.4.paragra
20e0 70 68 73 29 2e 20 20 42 75 74 20 73 6f 6d 65 74 69 6d 65 73 20 74 68 65 79 20 66 75 6e 63 74 69 phs)...But.sometimes.they.functi
2100 6f 6e 20 69 6e 73 74 65 61 64 20 61 73 20 62 6f 6f 6c 65 61 6e 0a 20 20 22 73 77 69 74 63 68 65 on.instead.as.boolean..."switche
2120 73 22 20 28 60 43 2d 75 20 43 2d 53 50 41 43 45 27 20 74 6f 20 6a 75 6d 70 20 74 6f 20 74 68 65 s".(`C-u.C-SPACE'.to.jump.to.the
2140 20 6c 61 73 74 20 6d 61 72 6b 20 69 6e 73 74 65 61 64 20 6f 66 20 6a 75 73 74 0a 20 20 73 65 74 .last.mark.instead.of.just...set
2160 74 69 6e 67 20 69 74 2c 20 60 43 2d 75 20 43 2d 75 20 43 2d 53 50 41 43 45 27 20 74 6f 20 75 6e ting.it,.`C-u.C-u.C-SPACE'.to.un
2180 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 73 65 74 20 74 68 65 20 6d 61 72 6b 29 2e 20 20 53 69 conditionally.set.the.mark)...Si
21a0 6e 63 65 0a 20 20 74 68 65 72 65 20 61 72 65 6e 27 74 20 6d 61 6e 79 20 73 74 61 6e 64 61 72 64 nce...there.aren't.many.standard
21c0 73 20 66 6f 72 20 74 68 65 20 75 73 65 20 6f 66 20 70 72 65 66 69 78 20 6f 70 74 69 6f 6e 73 2c s.for.the.use.of.prefix.options,
21e0 20 79 6f 75 20 68 61 76 65 20 74 6f 0a 20 20 72 65 61 64 20 74 68 65 20 63 6f 6d 6d 61 6e 64 27 .you.have.to...read.the.command'
2200 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68 61 74 s.documentation.to.find.out.what
2220 20 74 68 65 20 70 6f 73 73 69 62 69 6c 69 74 69 65 73 0a 20 20 61 72 65 2e 0a 0a 20 20 42 75 74 .the.possibilities...are.....But
2240 20 77 68 65 6e 20 61 6e 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 20 67 72 6f 77 73 20 74 6f 20 .when.an.Emacs.command.grows.to.
2260 68 61 76 65 20 61 20 74 72 75 6c 79 20 6c 61 72 67 65 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e have.a.truly.large.set.of.option
2280 73 0a 20 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 2c 20 77 69 74 68 20 64 65 70 65 6e 64 65 6e s...and.arguments,.with.dependen
22a0 63 69 65 73 20 62 65 74 77 65 65 6e 20 74 68 65 6d 2c 20 6c 6f 74 73 20 6f 66 20 6f 70 74 69 6f cies.between.them,.lots.of.optio
22c0 6e 20 76 61 6c 75 65 73 2c 0a 20 20 65 74 63 2e 2c 20 74 68 65 73 65 20 73 69 6d 70 6c 65 20 61 n.values,...etc.,.these.simple.a
22e0 70 70 72 6f 61 63 68 65 73 20 6a 75 73 74 20 64 6f 6e 27 74 20 73 63 61 6c 65 2e 20 20 54 72 61 pproaches.just.don't.scale...Tra
2300 6e 73 69 65 6e 74 20 69 73 20 64 65 73 69 67 6e 65 64 0a 20 20 74 6f 20 73 6f 6c 76 65 20 74 68 nsient.is.designed...to.solve.th
2320 69 73 20 69 73 73 75 65 2e 20 20 54 68 69 6e 6b 20 6f 66 20 69 74 20 61 73 20 74 68 65 20 68 75 is.issue...Think.of.it.as.the.hu
2340 6d 62 6c 65 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 60 43 2d 75 27 2c 0a 20 20 2f 72 mble.prefix.argument.`C-u',.../r
2360 61 69 73 65 64 20 74 6f 20 74 68 65 20 70 6f 77 65 72 20 6f 66 20 31 30 2f 2e 20 20 4c 69 6b 65 aised.to.the.power.of.10/...Like
2380 20 60 43 2d 75 27 2c 20 69 74 20 69 73 20 6b 65 79 20 64 72 69 76 65 6e 2e 20 20 4c 69 6b 65 20 .`C-u',.it.is.key.driven...Like.
23a0 74 68 65 0a 20 20 73 68 65 6c 6c 2c 20 69 74 20 73 75 70 70 6f 72 74 73 20 62 6f 6f 6c 65 61 6e the...shell,.it.supports.boolean
23c0 20 22 66 6c 61 67 22 20 6f 70 74 69 6f 6e 73 2c 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 61 ."flag".options,.options.that.ta
23e0 6b 65 0a 20 20 61 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 65 76 65 6e 20 22 73 75 62 2d 63 6f ke...arguments,.and.even."sub-co
2400 6d 6d 61 6e 64 73 22 2c 20 77 69 74 68 20 74 68 65 69 72 20 6f 77 6e 20 6f 70 74 69 6f 6e 73 2e mmands",.with.their.own.options.
2420 20 20 42 75 74 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 73 65 61 72 63 68 69 6e 67 20 74 68 72 ..But...instead.of.searching.thr
2440 6f 75 67 68 20 61 20 6d 61 6e 20 70 61 67 65 20 6f 72 20 63 6f 6d 6d 61 6e 64 20 64 6f 63 75 6d ough.a.man.page.or.command.docum
2460 65 6e 74 61 74 69 6f 6e 2c 0a 20 20 77 65 6c 6c 2d 64 65 73 69 67 6e 65 64 20 74 72 61 6e 73 69 entation,...well-designed.transi
2480 65 6e 74 73 20 2f 67 75 69 64 65 2f 20 74 68 65 69 72 20 75 73 65 72 73 20 74 6f 20 74 68 65 20 ents./guide/.their.users.to.the.
24a0 72 65 6c 65 76 61 6e 74 20 73 65 74 20 6f 66 0a 20 20 6f 70 74 69 6f 6e 73 20 28 61 6e 64 20 65 relevant.set.of...options.(and.e
24c0 76 65 6e 20 74 68 65 69 72 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 21 29 20 64 69 72 65 ven.their.possible.values!).dire
24e0 63 74 6c 79 2c 20 74 61 6b 69 6e 67 20 69 6e 74 6f 0a 20 20 61 63 63 6f 75 6e 74 20 61 6e 79 20 ctly,.taking.into...account.any.
2500 69 6d 70 6f 72 74 61 6e 74 20 70 72 65 2d 65 78 69 73 74 69 6e 67 20 45 6d 61 63 73 20 73 65 74 important.pre-existing.Emacs.set
2520 74 69 6e 67 73 2e 20 20 41 6e 64 20 77 68 69 6c 65 20 66 6f 72 0a 20 20 73 68 65 6c 6c 20 63 6f tings...And.while.for...shell.co
2540 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 60 6c 73 27 2c 20 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 mmands.like.`ls',.there.is.only.
2560 6f 6e 65 20 77 61 79 20 74 6f 20 22 65 78 65 63 75 74 65 22 20 28 68 69 74 0a 20 20 60 52 65 74 one.way.to."execute".(hit...`Ret
2580 75 72 6e 27 21 29 2c 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 22 65 78 65 63 75 74 65 22 urn'!),.transients.can."execute"
25a0 20 75 73 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 64 69 66 66 65 72 65 6e 74 20 6b 65 79 73 0a 20 .using.multiple.different.keys..
25c0 20 74 69 65 64 20 74 6f 20 6f 6e 65 20 6f 66 20 6d 61 6e 79 20 73 65 6c 66 2d 64 6f 63 75 6d 65 .tied.to.one.of.many.self-docume
25e0 6e 74 69 6e 67 20 2f 61 63 74 69 6f 6e 73 2f 20 28 69 6d 61 67 69 6e 65 20 68 61 76 69 6e 67 20 nting./actions/.(imagine.having.
2600 35 0a 20 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6c 6f 72 65 64 20 72 65 74 75 72 6e 20 6b 65 79 5...different.colored.return.key
2620 73 20 6f 6e 20 79 6f 75 72 20 6b 65 79 62 6f 61 72 64 21 29 2e 20 20 54 72 61 6e 73 69 65 6e 74 s.on.your.keyboard!)...Transient
2640 73 20 6d 61 6b 65 0a 20 20 6e 61 76 69 67 61 74 69 6e 67 20 61 6e 64 20 73 65 74 74 69 6e 67 20 s.make...navigating.and.setting.
2660 6c 61 72 67 65 2c 20 63 6f 6d 70 6c 65 78 20 67 72 6f 75 70 73 20 6f 66 20 63 6f 6d 6d 61 6e 64 large,.complex.groups.of.command
2680 20 6f 70 74 69 6f 6e 73 20 61 6e 64 0a 20 20 61 72 67 75 6d 65 6e 74 73 20 65 61 73 79 2e 20 20 .options.and...arguments.easy...
26a0 46 75 6e 20 65 76 65 6e 2e 20 20 4f 6e 63 65 20 79 6f 75 27 76 65 20 74 72 69 65 64 20 69 74 2c Fun.even...Once.you've.tried.it,
26c0 20 69 74 27 73 20 68 61 72 64 20 74 6f 20 67 6f 20 62 61 63 6b 0a 20 20 74 6f 20 74 68 65 20 60 .it's.hard.to.go.back...to.the.`
26e0 43 2d 75 20 77 68 61 74 20 63 61 6e 20 49 20 64 6f 20 68 65 72 65 20 61 67 61 69 6e 3f 27 20 77 C-u.what.can.I.do.here.again?'.w
2700 61 79 2e 0a 0a 20 20 3c 68 74 74 70 3a 2f 2f 72 65 61 64 6d 65 2e 65 6d 61 63 73 61 69 72 2e 6d ay.....<http://readme.emacsair.m
2720 65 2f 74 72 61 6e 73 69 65 6e 74 2e 70 6e 67 3e 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 e/transient.png>................
2740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
27e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2800 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 74 72 61 6e 73 69 65 6e 74 2e 69 6e 66 6f 00 transient-0.10.0/transient.info.
2820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2840 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2860 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
2880 30 35 32 33 36 35 36 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 35 31 34 33 00 20 30 00 00 00 0523656.00000000000.015143..0...
28a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
28e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2900 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...................
2920 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...................
2940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
29e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2a00 54 68 69 73 20 69 73 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 70 72 6f 64 75 63 65 64 This.is.doci3EOZM.info,.produced
2a20 20 62 79 20 6d 61 6b 65 69 6e 66 6f 20 76 65 72 73 69 6f 6e 20 36 2e 38 20 66 72 6f 6d 0a 74 72 .by.makeinfo.version.6.8.from.tr
2a40 61 6e 73 69 65 6e 74 2e 74 65 78 69 2e 0a 0a 20 20 20 20 20 43 6f 70 79 72 69 67 68 74 20 28 43 ansient.texi........Copyright.(C
2a60 29 20 32 30 31 38 e2 80 93 32 30 32 35 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e ).2018...2025.Free.Software.Foun
2a80 64 61 74 69 6f 6e 2c 20 49 6e 63 2e 0a 0a 20 20 20 20 20 59 6f 75 20 63 61 6e 20 72 65 64 69 73 dation,.Inc........You.can.redis
2aa0 74 72 69 62 75 74 65 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 61 6e 64 2f 6f 72 20 6d 6f 64 tribute.this.document.and/or.mod
2ac0 69 66 79 20 69 74 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 0a 20 20 20 20 20 6f 66 20 74 ify.it.under.the.terms......of.t
2ae0 68 65 20 47 4e 55 20 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 he.GNU.General.Public.License.as
2b00 20 70 75 62 6c 69 73 68 65 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 0a .published.by.the.Free.Software.
2b20 20 20 20 20 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 76 65 72 73 69 6f 6e 20 .....Foundation,.either.version.
2b40 33 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 20 79 6f 75 72 20 6f 70 3.of.the.License,.or.(at.your.op
2b60 74 69 6f 6e 29 0a 20 20 20 20 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 0a 20 tion)......any.later.version....
2b80 20 20 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 ....This.document.is.distributed
2ba0 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 .in.the.hope.that.it.will.be.use
2bc0 66 75 6c 2c 0a 20 20 20 20 20 62 75 74 20 57 49 54 48 4f 55 54 20 41 4e 59 20 57 41 52 52 41 4e ful,......but.WITHOUT.ANY.WARRAN
2be0 54 59 3b 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68 65 20 69 6d 70 6c 69 65 64 20 77 61 72 TY;.without.even.the.implied.war
2c00 72 61 6e 74 79 20 6f 66 0a 20 20 20 20 20 4d 45 52 43 48 41 4e 54 41 42 49 4c 49 54 59 20 6f 72 ranty.of......MERCHANTABILITY.or
2c20 20 46 49 54 4e 45 53 53 20 46 4f 52 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50 55 52 50 4f 53 .FITNESS.FOR.A.PARTICULAR.PURPOS
2c40 45 2e 20 20 53 65 65 20 74 68 65 20 47 4e 55 0a 20 20 20 20 20 47 65 6e 65 72 61 6c 20 50 75 62 E...See.the.GNU......General.Pub
2c60 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a 0a 49 lic.License.for.more.details...I
2c80 4e 46 4f 2d 44 49 52 2d 53 45 43 54 49 4f 4e 20 45 6d 61 63 73 20 6d 69 73 63 20 66 65 61 74 75 NFO-DIR-SECTION.Emacs.misc.featu
2ca0 72 65 73 0a 53 54 41 52 54 2d 49 4e 46 4f 2d 44 49 52 2d 45 4e 54 52 59 0a 2a 20 54 72 61 6e 73 res.START-INFO-DIR-ENTRY.*.Trans
2cc0 69 65 6e 74 3a 20 28 74 72 61 6e 73 69 65 6e 74 29 2e 20 54 72 61 6e 73 69 65 6e 74 20 43 6f 6d ient:.(transient)..Transient.Com
2ce0 6d 61 6e 64 73 2e 0a 45 4e 44 2d 49 4e 46 4f 2d 44 49 52 2d 45 4e 54 52 59 0a 0a 1f 0a 46 69 6c mands..END-INFO-DIR-ENTRY....Fil
2d00 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 54 6f 70 2c 20 20 e:.doci3EOZM.info,..Node:.Top,..
2d20 4e 65 78 74 3a 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 2c 20 20 55 70 3a 20 28 64 69 72 29 0a 0a Next:.Introduction,..Up:.(dir)..
2d40 54 72 61 6e 73 69 65 6e 74 20 55 73 65 72 20 61 6e 64 20 44 65 76 65 6c 6f 70 65 72 20 4d 61 6e Transient.User.and.Developer.Man
2d60 75 61 6c 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ual.****************************
2d80 2a 2a 2a 2a 2a 2a 2a 0a 0a 54 72 61 6e 73 69 65 6e 74 20 69 73 20 74 68 65 20 6c 69 62 72 61 72 *******..Transient.is.the.librar
2da0 79 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 6b 65 79 62 6f 61 72 64 y.used.to.implement.the.keyboard
2dc0 2d 64 72 69 76 65 6e 20 e2 80 9c 6d 65 6e 75 73 e2 80 9d 0a 69 6e 20 4d 61 67 69 74 2e 20 20 49 -driven....menus....in.Magit...I
2de0 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 70 61 72 61 74 65 20 70 t.is.distributed.as.a.separate.p
2e00 61 63 6b 61 67 65 2c 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a 75 73 65 64 20 74 ackage,.so.that.it.can.be.used.t
2e20 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 73 20 69 6e 20 6f 74 68 o.implement.similar.menus.in.oth
2e40 65 72 20 70 61 63 6b 61 67 65 73 2e 0a 0a 20 20 20 54 68 69 73 20 6d 61 6e 75 61 6c 20 63 61 6e er.packages......This.manual.can
2e60 20 62 65 20 62 69 74 20 68 61 72 64 20 74 6f 20 64 69 67 65 73 74 20 77 68 65 6e 20 67 65 74 74 .be.bit.hard.to.digest.when.gett
2e80 69 6e 67 20 73 74 61 72 74 65 64 2e 20 20 41 20 75 73 65 66 75 6c 0a 72 65 73 6f 75 72 63 65 20 ing.started...A.useful.resource.
2ea0 74 6f 20 67 65 74 20 6f 76 65 72 20 74 68 61 74 20 68 75 72 64 6c 65 20 69 73 20 50 73 69 6f 6e to.get.over.that.hurdle.is.Psion
2ec0 69 63 20 4b e2 80 99 73 20 69 6e 74 65 72 61 63 74 69 76 65 20 74 75 74 6f 72 69 61 6c 2c 0a 61 ic.K...s.interactive.tutorial,.a
2ee0 76 61 69 6c 61 62 6c 65 20 61 74 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f vailable.at.<https://github.com/
2f00 70 6f 73 69 74 72 6f 6e 2d 73 6f 6c 75 74 69 6f 6e 73 2f 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f positron-solutions/transient-sho
2f20 77 63 61 73 65 3e 2e 0a 0a 54 68 69 73 20 6d 61 6e 75 61 6c 20 69 73 20 66 6f 72 20 54 72 61 6e wcase>...This.manual.is.for.Tran
2f40 73 69 65 6e 74 20 76 65 72 73 69 6f 6e 20 30 2e 31 30 2e 30 2e 0a 0a 20 20 20 20 20 43 6f 70 79 sient.version.0.10.0........Copy
2f60 72 69 67 68 74 20 28 43 29 20 32 30 31 38 e2 80 93 32 30 32 35 20 46 72 65 65 20 53 6f 66 74 77 right.(C).2018...2025.Free.Softw
2f80 61 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e 63 2e 0a 0a 20 20 20 20 20 59 6f 75 20 63 are.Foundation,.Inc........You.c
2fa0 61 6e 20 72 65 64 69 73 74 72 69 62 75 74 65 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 61 6e an.redistribute.this.document.an
2fc0 64 2f 6f 72 20 6d 6f 64 69 66 79 20 69 74 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 0a 20 d/or.modify.it.under.the.terms..
2fe0 20 20 20 20 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 ....of.the.GNU.General.Public.Li
3000 63 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 68 65 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53 cense.as.published.by.the.Free.S
3020 6f 66 74 77 61 72 65 0a 20 20 20 20 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 oftware......Foundation,.either.
3040 76 65 72 73 69 6f 6e 20 33 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 version.3.of.the.License,.or.(at
3060 20 79 6f 75 72 20 6f 70 74 69 6f 6e 29 0a 20 20 20 20 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72 .your.option)......any.later.ver
3080 73 69 6f 6e 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 64 69 73 sion........This.document.is.dis
30a0 74 72 69 62 75 74 65 64 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 69 6c tributed.in.the.hope.that.it.wil
30c0 6c 20 62 65 20 75 73 65 66 75 6c 2c 0a 20 20 20 20 20 62 75 74 20 57 49 54 48 4f 55 54 20 41 4e l.be.useful,......but.WITHOUT.AN
30e0 59 20 57 41 52 52 41 4e 54 59 3b 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68 65 20 69 6d 70 Y.WARRANTY;.without.even.the.imp
3100 6c 69 65 64 20 77 61 72 72 61 6e 74 79 20 6f 66 0a 20 20 20 20 20 4d 45 52 43 48 41 4e 54 41 42 lied.warranty.of......MERCHANTAB
3120 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 54 49 43 55 4c 41 ILITY.or.FITNESS.FOR.A.PARTICULA
3140 52 20 50 55 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65 20 47 4e 55 0a 20 20 20 20 20 47 65 6e R.PURPOSE...See.the.GNU......Gen
3160 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 20 64 65 74 eral.Public.License.for.more.det
3180 61 69 6c 73 2e 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 2a 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3a 3a ails...*.Menu:..*.Introduction::
31a0 0a 2a 20 55 73 61 67 65 3a 3a 0a 2a 20 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 .*.Usage::.*.Modifying.Existing.
31c0 54 72 61 6e 73 69 65 6e 74 73 3a 3a 0a 2a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d Transients::.*.Defining.New.Comm
31e0 61 6e 64 73 3a 3a 0a 2a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 3a 3a 0a 2a ands::.*.Classes.and.Methods::.*
3200 20 46 41 51 3a 3a 0a 2a 20 4b 65 79 73 74 72 6f 6b 65 20 49 6e 64 65 78 3a 3a 0a 2a 20 43 6f 6d .FAQ::.*.Keystroke.Index::.*.Com
3220 6d 61 6e 64 20 61 6e 64 20 46 75 6e 63 74 69 6f 6e 20 49 6e 64 65 78 3a 3a 0a 2a 20 56 61 72 69 mand.and.Function.Index::.*.Vari
3240 61 62 6c 65 20 49 6e 64 65 78 3a 3a 0a 2a 20 43 6f 6e 63 65 70 74 20 49 6e 64 65 78 3a 3a 0a 2a able.Index::.*.Concept.Index::.*
3260 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 3a 3a 0a 0a e2 .GNU.General.Public.License::...
3280 80 94 20 54 68 65 20 44 65 74 61 69 6c 65 64 20 4e 6f 64 65 20 4c 69 73 74 69 6e 67 20 e2 80 94 ...The.Detailed.Node.Listing....
32a0 0a 0a 55 73 61 67 65 0a 0a 2a 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 3a 3a ..Usage..*.Invoking.Transients::
32c0 0a 2a 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 .*.Aborting.and.Resuming.Transie
32e0 6e 74 73 3a 3a 0a 2a 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 3a 3a nts::.*.Common.Suffix.Commands::
3300 0a 2a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 3a 3a 0a 2a 20 55 73 69 6e 67 20 48 69 73 74 6f .*.Saving.Values::.*.Using.Histo
3320 72 79 3a 3a 0a 2a 20 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 6f 72 20 53 75 66 66 69 78 20 43 ry::.*.Getting.Help.for.Suffix.C
3340 6f 6d 6d 61 6e 64 73 3a 3a 0a 2a 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 ommands::.*.Enabling.and.Disabli
3360 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 0a 2a 20 4f 74 68 65 72 20 43 6f 6d 6d 61 6e 64 73 3a 3a ng.Suffixes::.*.Other.Commands::
3380 0a 2a 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 3a 0a 0a 44 65 66 69 6e 69 6e 67 20 4e 65 77 .*.Configuration::..Defining.New
33a0 20 43 6f 6d 6d 61 6e 64 73 0a 0a 2a 20 54 65 63 68 6e 69 63 61 6c 20 49 6e 74 72 6f 64 75 63 74 .Commands..*.Technical.Introduct
33c0 69 6f 6e 3a 3a 0a 2a 20 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 3a 3a 0a 2a 20 ion::.*.Defining.Transients::.*.
33e0 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 Binding.Suffix.and.Infix.Command
3400 73 3a 3a 0a 2a 20 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 s::.*.Defining.Suffix.and.Infix.
3420 43 6f 6d 6d 61 6e 64 73 3a 3a 0a 2a 20 55 73 69 6e 67 20 49 6e 66 69 78 20 41 72 67 75 6d 65 6e Commands::.*.Using.Infix.Argumen
3440 74 73 3a 3a 0a 2a 20 55 73 69 6e 67 20 50 72 65 66 69 78 20 53 63 6f 70 65 3a 3a 0a 2a 20 43 75 ts::.*.Using.Prefix.Scope::.*.Cu
3460 72 72 65 6e 74 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 3a 3a 0a 2a 20 43 75 72 72 65 6e 74 rrent.Suffix.Command::.*.Current
3480 20 50 72 65 66 69 78 20 43 6f 6d 6d 61 6e 64 3a 3a 0a 2a 20 54 72 61 6e 73 69 65 6e 74 20 53 74 .Prefix.Command::.*.Transient.St
34a0 61 74 65 3a 3a 0a 0a 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 ate::..Binding.Suffix.and.Infix.
34c0 43 6f 6d 6d 61 6e 64 73 0a 0a 2a 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 Commands..*.Group.Specifications
34e0 3a 3a 0a 2a 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 3a 3a 0a 0a 0a 43 ::.*.Suffix.Specifications::...C
3500 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 0a 2a 20 47 72 6f 75 70 20 43 6c 61 73 lasses.and.Methods..*.Group.Clas
3520 73 65 73 3a 3a 0a 2a 20 47 72 6f 75 70 20 4d 65 74 68 6f 64 73 3a 3a 0a 2a 20 50 72 65 66 69 78 ses::.*.Group.Methods::.*.Prefix
3540 20 43 6c 61 73 73 65 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 43 6c 61 73 73 65 73 3a 3a 0a 2a 20 .Classes::.*.Suffix.Classes::.*.
3560 50 72 65 66 69 78 20 4d 65 74 68 6f 64 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 4d 65 74 68 6f 64 Prefix.Methods::.*.Suffix.Method
3580 73 3a 3a 0a 2a 20 50 72 65 66 69 78 20 53 6c 6f 74 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 53 6c s::.*.Prefix.Slots::.*.Suffix.Sl
35a0 6f 74 73 3a 3a 0a 2a 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 3a 3a 0a 0a 53 75 66 66 69 ots::.*.Predicate.Slots::..Suffi
35c0 78 20 4d 65 74 68 6f 64 73 0a 0a 2a 20 53 75 66 66 69 78 20 56 61 6c 75 65 20 4d 65 74 68 6f 64 x.Methods..*.Suffix.Value.Method
35e0 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 46 6f 72 6d 61 74 20 4d 65 74 68 6f 64 73 3a 3a 0a 0a 0a s::.*.Suffix.Format.Methods::...
3600 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 ...File:.doci3EOZM.info,..Node:.
3620 49 6e 74 72 6f 64 75 63 74 69 6f 6e 2c 20 20 4e 65 78 74 3a 20 55 73 61 67 65 2c 20 20 50 72 65 Introduction,..Next:.Usage,..Pre
3640 76 3a 20 54 6f 70 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 31 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e v:.Top,..Up:.Top..1.Introduction
3660 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 54 72 61 6e 73 69 65 6e 74 20 69 73 20 74 68 .**************..Transient.is.th
3680 65 20 6c 69 62 72 61 72 79 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 e.library.used.to.implement.the.
36a0 6b 65 79 62 6f 61 72 64 2d 64 72 69 76 65 6e 20 e2 80 9c 6d 65 6e 75 73 e2 80 9d 0a 69 6e 20 4d keyboard-driven....menus....in.M
36c0 61 67 69 74 2e 20 20 49 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 agit...It.is.distributed.as.a.se
36e0 70 61 72 61 74 65 20 70 61 63 6b 61 67 65 2c 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 parate.package,.so.that.it.can.b
3700 65 0a 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 e.used.to.implement.similar.menu
3720 73 20 69 6e 20 6f 74 68 65 72 20 70 61 63 6b 61 67 65 73 2e 0a 0a 20 20 20 54 68 69 73 20 6d 61 s.in.other.packages......This.ma
3740 6e 75 61 6c 20 63 61 6e 20 62 65 20 62 69 74 20 68 61 72 64 20 74 6f 20 64 69 67 65 73 74 20 77 nual.can.be.bit.hard.to.digest.w
3760 68 65 6e 20 67 65 74 74 69 6e 67 20 73 74 61 72 74 65 64 2e 20 20 41 20 75 73 65 66 75 6c 0a 72 hen.getting.started...A.useful.r
3780 65 73 6f 75 72 63 65 20 74 6f 20 67 65 74 20 6f 76 65 72 20 74 68 61 74 20 68 75 72 64 6c 65 20 esource.to.get.over.that.hurdle.
37a0 69 73 20 50 73 69 6f 6e 69 63 20 4b e2 80 99 73 20 69 6e 74 65 72 61 63 74 69 76 65 20 74 75 74 is.Psionic.K...s.interactive.tut
37c0 6f 72 69 61 6c 2c 0a 61 76 61 69 6c 61 62 6c 65 20 61 74 20 3c 68 74 74 70 73 3a 2f 2f 67 69 74 orial,.available.at.<https://git
37e0 68 75 62 2e 63 6f 6d 2f 70 6f 73 69 74 72 6f 6e 2d 73 6f 6c 75 74 69 6f 6e 73 2f 74 72 61 6e 73 hub.com/positron-solutions/trans
3800 69 65 6e 74 2d 73 68 6f 77 63 61 73 65 3e 2e 0a 0a 53 6f 6d 65 20 74 68 69 6e 67 73 20 74 68 61 ient-showcase>...Some.things.tha
3820 74 20 54 72 61 6e 73 69 65 6e 74 20 63 61 6e 20 64 6f 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d t.Transient.can.do.=============
3840 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20 e2 80 a2 20 44 69 73 ====================.........Dis
3860 70 6c 61 79 20 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 0a play.current.state.of.arguments.
3880 20 20 20 e2 80 a2 20 44 69 73 70 6c 61 79 20 61 6e 64 20 6d 61 6e 61 67 65 20 6c 69 66 65 63 79 .......Display.and.manage.lifecy
38a0 63 6c 65 20 6f 66 20 6d 6f 64 61 6c 20 62 69 6e 64 69 6e 67 73 0a 20 20 20 e2 80 a2 20 43 6f 6e cle.of.modal.bindings........Con
38c0 74 65 78 74 75 61 6c 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 0a 20 20 20 e2 80 a2 20 46 6c textual.user.interface........Fl
38e0 6f 77 20 63 6f 6e 74 72 6f 6c 20 66 6f 72 20 77 69 7a 61 72 64 2d 6c 69 6b 65 20 63 6f 6d 70 6f ow.control.for.wizard-like.compo
3900 73 69 74 69 6f 6e 20 6f 66 20 69 6e 74 65 72 61 63 74 69 76 65 20 66 6f 72 6d 73 0a 20 20 20 e2 sition.of.interactive.forms.....
3920 80 a2 20 48 69 73 74 6f 72 79 20 26 20 70 65 72 73 69 73 74 65 6e 63 65 0a 20 20 20 e2 80 a2 20 ...History.&.persistence........
3940 52 65 6e 64 65 72 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 66 6f 72 20 63 6f 6e 74 72 6f 6c 6c Rendering.arguments.for.controll
3960 69 6e 67 20 43 4c 49 20 70 72 6f 67 72 61 6d 73 0a 0a 43 6f 6d 70 6c 65 78 69 74 79 20 69 6e 20 ing.CLI.programs..Complexity.in.
3980 43 4c 49 20 70 72 6f 67 72 61 6d 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d CLI.programs.===================
39a0 3d 3d 3d 3d 3d 3d 3d 0a 0a 43 6f 6d 70 6c 65 78 69 74 79 20 74 65 6e 64 73 20 74 6f 20 67 72 6f =======..Complexity.tends.to.gro
39c0 77 20 77 69 74 68 20 74 69 6d 65 2e 20 20 48 6f 77 20 64 6f 20 79 6f 75 20 6d 61 6e 61 67 65 20 w.with.time...How.do.you.manage.
39e0 74 68 65 20 63 6f 6d 70 6c 65 78 69 74 79 20 6f 66 0a 63 6f 6d 6d 61 6e 64 73 3f 20 20 43 6f 6e the.complexity.of.commands?..Con
3a00 73 69 64 65 72 20 74 68 65 20 68 75 6d 62 6c 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 e2 sider.the.humble.shell.command..
3a20 80 98 6c 73 e2 80 99 2e 20 20 49 74 20 6e 6f 77 20 68 61 73 20 6f 76 65 72 0a 5f 66 69 66 74 79 ..ls......It.now.has.over._fifty
3a40 5f 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 2e 20 20 53 6f 6d 65 20 6f 66 _.command.line.options...Some.of
3a60 20 74 68 65 73 65 20 61 72 65 20 62 6f 6f 6c 65 61 6e 20 66 6c 61 67 73 20 28 e2 80 98 6c 73 0a .these.are.boolean.flags.(...ls.
3a80 2d 6c e2 80 99 29 2e 20 20 53 6f 6d 65 20 74 61 6b 65 20 61 72 67 75 6d 65 6e 74 73 20 28 e2 80 -l...)...Some.take.arguments.(..
3aa0 98 6c 73 20 2d 2d 73 6f 72 74 3d 73 e2 80 99 29 2e 20 20 53 6f 6d 65 20 68 61 76 65 20 6e 6f 20 .ls.--sort=s...)...Some.have.no.
3ac0 65 66 66 65 63 74 20 75 6e 6c 65 73 73 0a 70 61 69 72 65 64 20 77 69 74 68 20 6f 74 68 65 72 20 effect.unless.paired.with.other.
3ae0 66 6c 61 67 73 20 28 e2 80 98 6c 73 20 2d 6c 68 e2 80 99 29 2e 20 20 53 6f 6d 65 20 61 72 65 20 flags.(...ls.-lh...)...Some.are.
3b00 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 76 65 2e 20 20 53 6f 6d 65 0a 73 68 65 6c 6c 20 mutually.exclusive...Some.shell.
3b20 63 6f 6d 6d 61 6e 64 73 20 65 76 65 6e 20 68 61 76 65 20 73 6f 20 6d 61 6e 79 20 6f 70 74 69 6f commands.even.have.so.many.optio
3b40 6e 73 20 74 68 61 74 20 74 68 65 79 20 69 6e 74 72 6f 64 75 63 65 0a 5f 73 75 62 63 6f 6d 6d 61 ns.that.they.introduce._subcomma
3b60 6e 64 73 5f 20 28 e2 80 98 67 69 74 20 62 72 61 6e 63 68 e2 80 99 2c 20 e2 80 98 67 69 74 20 63 nds_.(...git.branch...,....git.c
3b80 6f 6d 6d 69 74 e2 80 99 29 2c 20 65 61 63 68 20 77 69 74 68 20 74 68 65 69 72 20 6f 77 6e 20 72 ommit...),.each.with.their.own.r
3ba0 69 63 68 20 73 65 74 0a 6f 66 20 6f 70 74 69 6f 6e 73 20 28 e2 80 98 67 69 74 20 62 72 61 6e 63 ich.set.of.options.(...git.branc
3bc0 68 20 2d 66 e2 80 99 29 2e 0a 0a 55 73 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 20 66 6f 72 20 63 h.-f...)...Using.Transient.for.c
3be0 6f 6d 70 6f 73 69 6e 67 20 69 6e 74 65 72 61 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 73 0a 3d 3d omposing.interactive.commands.==
3c00 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
3c20 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 57 68 61 74 20 61 62 6f 75 74 20 45 6d 61 ================..What.about.Ema
3c40 63 73 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 3f 20 cs.commands.used.interactively?.
3c60 20 48 6f 77 20 64 6f 20 74 68 65 73 65 20 68 61 6e 64 6c 65 0a 6f 70 74 69 6f 6e 73 3f 20 20 4f .How.do.these.handle.options?..O
3c80 6e 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73 20 74 6f 20 6d 61 6b 65 20 6d 61 6e 79 20 76 65 72 73 ne.solution.is.to.make.many.vers
3ca0 69 6f 6e 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20 63 6f 6d 6d 61 6e 64 2c 20 73 6f 0a 79 6f 75 ions.of.the.same.command,.so.you
3cc0 20 64 6f 6e e2 80 99 74 20 6e 65 65 64 20 74 6f 21 20 20 43 6f 6e 73 69 64 65 72 3a 20 e2 80 98 .don...t.need.to!..Consider:....
3ce0 64 65 6c 65 74 65 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 73 e2 80 99 20 76 73 2e 0a e2 80 98 64 delete-other-windows....vs.....d
3d00 65 6c 65 74 65 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 73 2d 76 65 72 74 69 63 61 6c 6c 79 e2 80 elete-other-windows-vertically..
3d20 99 20 28 61 6d 6f 6e 67 20 6d 61 6e 79 20 73 69 6d 69 6c 61 72 20 65 78 61 6d 70 6c 65 73 29 2e ..(among.many.similar.examples).
3d40 0a 0a 20 20 20 53 6f 6d 65 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 73 20 77 69 6c 6c 20 73 69 .....Some.Emacs.commands.will.si
3d60 6d 70 6c 79 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 22 61 72 mply.prompt.you.for.the.next."ar
3d80 67 75 6d 65 6e 74 22 0a 28 e2 80 98 4d 2d 78 20 73 77 69 74 63 68 2d 74 6f 2d 62 75 66 66 65 72 gument".(...M-x.switch-to-buffer
3da0 e2 80 99 29 2e 20 20 41 6e 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e 20 73 6f 6c 75 74 69 6f 6e 20 69 ...)...Another.common.solution.i
3dc0 73 20 74 6f 20 75 73 65 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 20 77 68 69 63 68 20 s.to.use.prefix.arguments.which.
3de0 75 73 75 61 6c 6c 79 20 73 74 61 72 74 20 77 69 74 68 20 e2 80 98 43 2d 75 e2 80 99 2e 20 20 53 usually.start.with....C-u......S
3e00 6f 6d 65 74 69 6d 65 73 20 74 68 65 73 65 20 61 72 65 20 73 65 6e 73 69 62 6c 79 0a 6e 75 6d 65 ometimes.these.are.sensibly.nume
3e20 72 69 63 61 6c 20 69 6e 20 6e 61 74 75 72 65 20 28 e2 80 98 43 2d 75 20 34 20 4d 2d 78 20 66 6f rical.in.nature.(...C-u.4.M-x.fo
3e40 72 77 61 72 64 2d 70 61 72 61 67 72 61 70 68 e2 80 99 20 74 6f 20 6d 6f 76 65 20 66 6f 72 77 61 rward-paragraph....to.move.forwa
3e60 72 64 20 34 0a 70 61 72 61 67 72 61 70 68 73 29 2e 20 20 42 75 74 20 73 6f 6d 65 74 69 6d 65 73 rd.4.paragraphs)...But.sometimes
3e80 20 74 68 65 79 20 66 75 6e 63 74 69 6f 6e 20 69 6e 73 74 65 61 64 20 61 73 20 62 6f 6f 6c 65 61 .they.function.instead.as.boolea
3ea0 6e 20 22 73 77 69 74 63 68 65 73 22 0a 28 e2 80 98 43 2d 75 20 43 2d 53 50 41 43 45 e2 80 99 20 n."switches".(...C-u.C-SPACE....
3ec0 74 6f 20 6a 75 6d 70 20 74 6f 20 74 68 65 20 6c 61 73 74 20 6d 61 72 6b 20 69 6e 73 74 65 61 64 to.jump.to.the.last.mark.instead
3ee0 20 6f 66 20 6a 75 73 74 20 73 65 74 74 69 6e 67 20 69 74 2c 20 e2 80 98 43 2d 75 0a 43 2d 75 20 .of.just.setting.it,....C-u.C-u.
3f00 43 2d 53 50 41 43 45 e2 80 99 20 74 6f 20 75 6e 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 73 65 C-SPACE....to.unconditionally.se
3f20 74 20 74 68 65 20 6d 61 72 6b 29 2e 20 20 53 69 6e 63 65 20 74 68 65 72 65 20 61 72 65 6e e2 80 t.the.mark)...Since.there.aren..
3f40 99 74 20 6d 61 6e 79 0a 73 74 61 6e 64 61 72 64 73 20 66 6f 72 20 74 68 65 20 75 73 65 20 6f 66 .t.many.standards.for.the.use.of
3f60 20 70 72 65 66 69 78 20 6f 70 74 69 6f 6e 73 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 72 65 61 .prefix.options,.you.have.to.rea
3f80 64 20 74 68 65 20 63 6f 6d 6d 61 6e 64 e2 80 99 73 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 d.the.command...s.documentation.
3fa0 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68 61 74 20 74 68 65 20 70 6f 73 73 69 62 69 6c 69 74 69 to.find.out.what.the.possibiliti
3fc0 65 73 20 61 72 65 2e 0a 0a 20 20 20 42 75 74 20 77 68 65 6e 20 61 6e 20 45 6d 61 63 73 20 63 6f es.are......But.when.an.Emacs.co
3fe0 6d 6d 61 6e 64 20 67 72 6f 77 73 20 74 6f 20 68 61 76 65 20 61 20 74 72 75 6c 79 20 6c 61 72 67 mmand.grows.to.have.a.truly.larg
4000 65 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e 73 0a 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 2c 20 e.set.of.options.and.arguments,.
4020 77 69 74 68 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 62 65 74 77 65 65 6e 20 74 68 65 6d 2c 20 with.dependencies.between.them,.
4040 6c 6f 74 73 20 6f 66 20 6f 70 74 69 6f 6e 20 76 61 6c 75 65 73 2c 0a 65 74 63 2e 2c 20 74 68 65 lots.of.option.values,.etc.,.the
4060 73 65 20 73 69 6d 70 6c 65 20 61 70 70 72 6f 61 63 68 65 73 20 6a 75 73 74 20 64 6f 6e e2 80 99 se.simple.approaches.just.don...
4080 74 20 73 63 61 6c 65 2e 20 20 54 72 61 6e 73 69 65 6e 74 20 69 73 20 64 65 73 69 67 6e 65 64 0a t.scale...Transient.is.designed.
40a0 74 6f 20 73 6f 6c 76 65 20 74 68 69 73 20 69 73 73 75 65 2e 20 20 54 68 69 6e 6b 20 6f 66 20 69 to.solve.this.issue...Think.of.i
40c0 74 20 61 73 20 74 68 65 20 68 75 6d 62 6c 65 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 t.as.the.humble.prefix.argument.
40e0 e2 80 98 43 2d 75 e2 80 99 2c 0a 5f 72 61 69 73 65 64 20 74 6f 20 74 68 65 20 70 6f 77 65 72 20 ...C-u...,._raised.to.the.power.
4100 6f 66 20 31 30 5f 2e 20 20 4c 69 6b 65 20 e2 80 98 43 2d 75 e2 80 99 2c 20 69 74 20 69 73 20 6b of.10_...Like....C-u...,.it.is.k
4120 65 79 20 64 72 69 76 65 6e 2e 20 20 4c 69 6b 65 20 74 68 65 0a 73 68 65 6c 6c 2c 20 69 74 20 73 ey.driven...Like.the.shell,.it.s
4140 75 70 70 6f 72 74 73 20 62 6f 6f 6c 65 61 6e 20 22 66 6c 61 67 22 20 6f 70 74 69 6f 6e 73 2c 20 upports.boolean."flag".options,.
4160 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 61 6b 65 20 61 72 67 75 6d 65 6e 74 73 2c 0a 61 6e 64 options.that.take.arguments,.and
4180 20 65 76 65 6e 20 22 73 75 62 2d 63 6f 6d 6d 61 6e 64 73 22 2c 20 77 69 74 68 20 74 68 65 69 72 .even."sub-commands",.with.their
41a0 20 6f 77 6e 20 6f 70 74 69 6f 6e 73 2e 20 20 42 75 74 20 69 6e 73 74 65 61 64 20 6f 66 0a 73 65 .own.options...But.instead.of.se
41c0 61 72 63 68 69 6e 67 20 74 68 72 6f 75 67 68 20 61 20 6d 61 6e 20 70 61 67 65 20 6f 72 20 63 6f arching.through.a.man.page.or.co
41e0 6d 6d 61 6e 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 77 65 6c 6c 2d 64 65 73 69 67 6e mmand.documentation,.well-design
4200 65 64 0a 74 72 61 6e 73 69 65 6e 74 73 20 5f 67 75 69 64 65 5f 20 74 68 65 69 72 20 75 73 65 72 ed.transients._guide_.their.user
4220 73 20 74 6f 20 74 68 65 20 72 65 6c 65 76 61 6e 74 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e 73 s.to.the.relevant.set.of.options
4240 20 28 61 6e 64 20 65 76 65 6e 0a 74 68 65 69 72 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 .(and.even.their.possible.values
4260 21 29 20 20 64 69 72 65 63 74 6c 79 2c 20 74 61 6b 69 6e 67 20 69 6e 74 6f 20 61 63 63 6f 75 6e !)..directly,.taking.into.accoun
4280 74 20 61 6e 79 20 69 6d 70 6f 72 74 61 6e 74 0a 70 72 65 2d 65 78 69 73 74 69 6e 67 20 45 6d 61 t.any.important.pre-existing.Ema
42a0 63 73 20 73 65 74 74 69 6e 67 73 2e 20 20 41 6e 64 20 77 68 69 6c 65 20 66 6f 72 20 73 68 65 6c cs.settings...And.while.for.shel
42c0 6c 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 e2 80 98 6c 73 e2 80 99 2c 0a 74 68 65 72 65 20 l.commands.like....ls...,.there.
42e0 69 73 20 6f 6e 6c 79 20 6f 6e 65 20 77 61 79 20 74 6f 20 22 65 78 65 63 75 74 65 22 20 28 68 69 is.only.one.way.to."execute".(hi
4300 74 20 e2 80 98 52 65 74 75 72 6e e2 80 99 21 29 2c 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e t....Return...!),.transients.can
4320 0a 22 65 78 65 63 75 74 65 22 20 75 73 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 64 69 66 66 65 72 ."execute".using.multiple.differ
4340 65 6e 74 20 6b 65 79 73 20 74 69 65 64 20 74 6f 20 6f 6e 65 20 6f 66 20 6d 61 6e 79 0a 73 65 6c ent.keys.tied.to.one.of.many.sel
4360 66 2d 64 6f 63 75 6d 65 6e 74 69 6e 67 20 5f 61 63 74 69 6f 6e 73 5f 20 28 69 6d 61 67 69 6e 65 f-documenting._actions_.(imagine
4380 20 68 61 76 69 6e 67 20 35 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6c 6f 72 65 64 20 72 65 74 75 .having.5.different.colored.retu
43a0 72 6e 0a 6b 65 79 73 20 6f 6e 20 79 6f 75 72 20 6b 65 79 62 6f 61 72 64 21 29 2e 20 20 54 72 61 rn.keys.on.your.keyboard!)...Tra
43c0 6e 73 69 65 6e 74 73 20 6d 61 6b 65 20 6e 61 76 69 67 61 74 69 6e 67 20 61 6e 64 20 73 65 74 74 nsients.make.navigating.and.sett
43e0 69 6e 67 20 6c 61 72 67 65 2c 0a 63 6f 6d 70 6c 65 78 20 67 72 6f 75 70 73 20 6f 66 20 63 6f 6d ing.large,.complex.groups.of.com
4400 6d 61 6e 64 20 6f 70 74 69 6f 6e 73 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 20 65 61 73 79 2e mand.options.and.arguments.easy.
4420 20 20 46 75 6e 20 65 76 65 6e 2e 20 20 4f 6e 63 65 0a 79 6f 75 e2 80 99 76 65 20 74 72 69 65 64 ..Fun.even...Once.you...ve.tried
4440 20 69 74 2c 20 69 74 e2 80 99 73 20 68 61 72 64 20 74 6f 20 67 6f 20 62 61 63 6b 20 74 6f 20 74 .it,.it...s.hard.to.go.back.to.t
4460 68 65 20 e2 80 98 43 2d 75 20 77 68 61 74 20 63 61 6e 20 49 20 64 6f 20 68 65 72 65 0a 61 67 61 he....C-u.what.can.I.do.here.aga
4480 69 6e 3f e2 80 99 20 77 61 79 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 in?....way.....File:.doci3EOZM.i
44a0 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 55 73 61 67 65 2c 20 20 4e 65 78 74 3a 20 4d 6f 64 69 66 79 nfo,..Node:.Usage,..Next:.Modify
44c0 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 50 72 65 76 3a 20 ing.Existing.Transients,..Prev:.
44e0 49 6e 74 72 6f 64 75 63 74 69 6f 6e 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 32 20 55 73 61 67 65 0a Introduction,..Up:.Top..2.Usage.
4500 2a 2a 2a 2a 2a 2a 2a 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 2a 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 *******..*.Menu:..*.Invoking.Tra
4520 6e 73 69 65 6e 74 73 3a 3a 0a 2a 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 75 6d 69 6e nsients::.*.Aborting.and.Resumin
4540 67 20 54 72 61 6e 73 69 65 6e 74 73 3a 3a 0a 2a 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 g.Transients::.*.Common.Suffix.C
4560 6f 6d 6d 61 6e 64 73 3a 3a 0a 2a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 3a 3a 0a 2a 20 55 73 ommands::.*.Saving.Values::.*.Us
4580 69 6e 67 20 48 69 73 74 6f 72 79 3a 3a 0a 2a 20 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 6f 72 ing.History::.*.Getting.Help.for
45a0 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 3a 3a 0a 2a 20 45 6e 61 62 6c 69 6e 67 20 61 6e .Suffix.Commands::.*.Enabling.an
45c0 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 0a 2a 20 4f 74 68 65 72 20 43 d.Disabling.Suffixes::.*.Other.C
45e0 6f 6d 6d 61 6e 64 73 3a 3a 0a 2a 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 3a 0a 0a 1f 0a 46 ommands::.*.Configuration::....F
4600 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 49 6e 76 6f ile:.doci3EOZM.info,..Node:.Invo
4620 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 4e 65 78 74 3a 20 41 62 6f 72 74 69 6e 67 king.Transients,..Next:.Aborting
4640 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 55 70 3a 20 55 .and.Resuming.Transients,..Up:.U
4660 73 61 67 65 0a 0a 32 2e 31 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 0a 3d 3d sage..2.1.Invoking.Transients.==
4680 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 41 20 74 72 61 6e 73 69 65 =====================..A.transie
46a0 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 6c 69 6b nt.prefix.command.is.invoked.lik
46c0 65 20 61 6e 79 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64 20 62 79 20 70 72 65 73 73 69 6e 67 0a e.any.other.command.by.pressing.
46e0 74 68 65 20 6b 65 79 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 74 68 61 74 20 63 6f the.key.that.is.bound.to.that.co
4700 6d 6d 61 6e 64 2e 20 20 54 68 65 20 6d 61 69 6e 20 64 69 66 66 65 72 65 6e 63 65 20 74 6f 20 6f mmand...The.main.difference.to.o
4720 74 68 65 72 0a 63 6f 6d 6d 61 6e 64 73 20 69 73 20 74 68 61 74 20 61 20 74 72 61 6e 73 69 65 6e ther.commands.is.that.a.transien
4740 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 63 74 69 76 61 74 65 73 20 61 20 74 72 61 t.prefix.command.activates.a.tra
4760 6e 73 69 65 6e 74 0a 6b 65 79 6d 61 70 2c 20 77 68 69 63 68 20 74 65 6d 70 6f 72 61 72 69 6c 79 nsient.keymap,.which.temporarily
4780 20 62 69 6e 64 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 20 61 .binds.the.transient...s.infix.a
47a0 6e 64 20 73 75 66 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 74 68 61 74 20 74 68 6f nd.suffix.commands,.and.that.tho
47c0 73 65 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 73 68 6f 77 6e 20 69 6e 20 6d 65 6e 75 20 62 75 se.bindings.are.shown.in.menu.bu
47e0 66 66 65 72 2c 20 77 68 69 63 68 20 69 73 0a 64 69 73 70 6c 61 79 65 64 20 69 6e 20 61 20 6e 65 ffer,.which.is.displayed.in.a.ne
4800 77 20 77 69 6e 64 6f 77 2c 20 75 6e 74 69 6c 20 74 68 65 20 6d 65 6e 75 20 69 73 20 65 78 69 74 w.window,.until.the.menu.is.exit
4820 65 64 2e 20 20 42 69 6e 64 69 6e 67 73 20 66 72 6f 6d 0a 6f 74 68 65 72 20 6b 65 79 6d 61 70 73 ed...Bindings.from.other.keymaps
4840 20 6d 61 79 2c 20 6f 72 20 6d 61 79 20 6e 6f 74 2c 20 62 65 20 64 69 73 61 62 6c 65 64 20 77 68 .may,.or.may.not,.be.disabled.wh
4860 69 6c 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 69 73 0a 69 6e 20 65 66 ile.the.transient.state.is.in.ef
4880 66 65 63 74 2e 0a 0a 20 20 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 6b 69 6e 64 73 20 6f 66 fect......There.are.two.kinds.of
48a0 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 61 66 74 .commands.that.are.available.aft
48c0 65 72 20 69 6e 76 6f 6b 69 6e 67 20 61 0a 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 er.invoking.a.transient.prefix.c
48e0 6f 6d 6d 61 6e 64 3b 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 ommand;.infix.and.suffix.command
4900 73 2e 20 20 49 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 73 65 74 0a 73 6f 6d 65 20 76 61 6c 75 s...Infix.commands.set.some.valu
4920 65 20 28 77 68 69 63 68 20 69 73 20 74 68 65 6e 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 6d 65 e.(which.is.then.shown.in.the.me
4940 6e 75 20 62 75 66 66 65 72 29 2c 20 77 69 74 68 6f 75 74 20 6c 65 61 76 69 6e 67 20 74 68 65 0a nu.buffer),.without.leaving.the.
4960 74 72 61 6e 73 69 65 6e 74 2e 20 20 53 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 6f 6e 20 transient...Suffix.commands,.on.
4980 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c 20 75 73 75 61 6c 6c 79 20 71 75 69 74 20 74 68 65 the.other.hand,.usually.quit.the
49a0 0a 74 72 61 6e 73 69 65 6e 74 20 61 6e 64 20 74 68 65 79 20 6d 61 79 20 75 73 65 20 74 68 65 20 .transient.and.they.may.use.the.
49c0 76 61 6c 75 65 73 20 73 65 74 20 62 79 20 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 values.set.by.the.infix.commands
49e0 2c 20 69 2e 65 2e 2c 0a 74 68 65 20 69 6e 66 69 78 20 2a 61 72 67 75 6d 65 6e 74 73 2a 2e 0a 0a ,.i.e.,.the.infix.*arguments*...
4a00 20 20 20 49 6e 73 74 65 61 64 20 6f 66 20 73 65 74 74 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 ...Instead.of.setting.arguments.
4a20 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 to.be.used.by.a.suffix.command,.
4a40 69 6e 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 20 6d 61 79 20 61 6c 73 6f 20 73 65 74 20 73 6f 6d 65 infix.commands.may.also.set.some
4a60 20 76 61 6c 75 65 20 62 79 20 73 69 64 65 2d 65 66 66 65 63 74 2c 20 65 2e 67 2e 2c 20 62 79 20 .value.by.side-effect,.e.g.,.by.
4a80 73 65 74 74 69 6e 67 20 74 68 65 0a 76 61 6c 75 65 20 6f 66 20 73 6f 6d 65 20 76 61 72 69 61 62 setting.the.value.of.some.variab
4aa0 6c 65 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f le.....File:.doci3EOZM.info,..No
4ac0 64 65 3a 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 de:.Aborting.and.Resuming.Transi
4ae0 65 6e 74 73 2c 20 20 4e 65 78 74 3a 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 ents,..Next:.Common.Suffix.Comma
4b00 6e 64 73 2c 20 20 50 72 65 76 3a 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c nds,..Prev:.Invoking.Transients,
4b20 20 20 55 70 3a 20 55 73 61 67 65 0a 0a 32 2e 32 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 ..Up:.Usage..2.2.Aborting.and.Re
4b40 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d suming.Transients.==============
4b60 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 6f 20 71 75 69 74 20 ======================..To.quit.
4b80 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 69 74 68 6f 75 74 20 69 6e 76 6f 6b 69 6e 67 20 61 the.transient.without.invoking.a
4ba0 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 70 72 65 73 73 20 e2 80 98 43 2d 67 e2 80 99 2e .suffix.command.press....C-g....
4bc0 0a 0a 20 20 20 4b 65 79 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 20 6b .....Key.bindings.in.transient.k
4be0 65 79 6d 61 70 73 20 6d 61 79 20 62 65 20 6c 6f 6e 67 65 72 20 74 68 61 6e 20 61 20 73 69 6e 67 eymaps.may.be.longer.than.a.sing
4c00 6c 65 20 65 76 65 6e 74 2e 0a 41 66 74 65 72 20 70 72 65 73 73 69 6e 67 20 61 20 76 61 6c 69 64 le.event..After.pressing.a.valid
4c20 20 70 72 65 66 69 78 20 6b 65 79 2c 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 77 68 6f 73 65 20 .prefix.key,.all.commands.whose.
4c40 62 69 6e 64 69 6e 67 73 20 64 6f 20 6e 6f 74 0a 62 65 67 69 6e 20 77 69 74 68 20 74 68 61 74 20 bindings.do.not.begin.with.that.
4c60 70 72 65 66 69 78 20 6b 65 79 20 61 72 65 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 75 6e 61 76 61 prefix.key.are.temporarily.unava
4c80 69 6c 61 62 6c 65 20 61 6e 64 20 67 72 61 79 65 64 20 6f 75 74 2e 0a 54 6f 20 61 62 6f 72 74 20 ilable.and.grayed.out..To.abort.
4ca0 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 70 72 65 73 73 20 e2 80 98 43 2d 67 e2 80 99 20 28 the.prefix.key.press....C-g....(
4cc0 77 68 69 63 68 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 6f 6e 6c 79 20 71 75 69 74 73 20 74 68 which.in.this.case.only.quits.th
4ce0 65 0a 70 72 65 66 69 78 20 6b 65 79 2c 20 62 75 74 20 6e 6f 74 20 74 68 65 20 63 6f 6d 70 6c 65 e.prefix.key,.but.not.the.comple
4d00 74 65 20 74 72 61 6e 73 69 65 6e 74 29 2e 0a 0a 20 20 20 41 20 74 72 61 6e 73 69 65 6e 74 20 70 te.transient)......A.transient.p
4d20 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 65 20 62 6f 75 6e 64 20 61 73 20 61 20 refix.command.can.be.bound.as.a.
4d40 73 75 66 66 69 78 20 6f 66 20 61 6e 6f 74 68 65 72 0a 74 72 61 6e 73 69 65 6e 74 2e 20 20 49 6e suffix.of.another.transient...In
4d60 76 6f 6b 69 6e 67 20 73 75 63 68 20 61 20 73 75 66 66 69 78 20 72 65 70 6c 61 63 65 73 20 74 68 voking.such.a.suffix.replaces.th
4d80 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 0a 77 69 74 68 20 61 e.current.transient.state.with.a
4da0 20 6e 65 77 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 2c 20 69 2e 65 2e 2c 20 74 68 65 20 .new.transient.state,.i.e.,.the.
4dc0 61 76 61 69 6c 61 62 6c 65 20 62 69 6e 64 69 6e 67 73 20 63 68 61 6e 67 65 20 61 6e 64 20 74 68 available.bindings.change.and.th
4de0 65 0a 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 64 69 73 70 6c 61 79 65 64 20 69 6e 20 74 68 65 20 6d e.information.displayed.in.the.m
4e00 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 75 70 64 61 74 65 64 20 61 63 63 6f 72 64 69 6e 67 6c enu.buffer.is.updated.accordingl
4e20 79 2e 0a 50 72 65 73 73 69 6e 67 20 e2 80 98 43 2d 67 e2 80 99 20 77 68 69 6c 65 20 61 20 6e 65 y..Pressing....C-g....while.a.ne
4e40 73 74 65 64 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 20 6f 6e 6c 79 20 71 75 sted.transient.is.active.only.qu
4e60 69 74 73 20 74 68 65 0a 69 6e 6e 65 72 6d 6f 73 74 20 74 72 61 6e 73 69 65 6e 74 2c 20 63 61 75 its.the.innermost.transient,.cau
4e80 73 69 6e 67 20 61 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 74 72 sing.a.return.to.the.previous.tr
4ea0 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 20 e2 80 98 43 2d 71 e2 80 99 20 6f 72 20 e2 80 98 43 2d 7a ansient.........C-q....or....C-z
4ec0 e2 80 99 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 20 61 6c 77 61 79 73 20 65 78 69 ....on.the.other.hand.always.exi
4ee0 74 73 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 49 66 20 79 6f 75 0a 75 73 65 20 74 ts.all.transients...If.you.use.t
4f00 68 65 20 6c 61 74 74 65 72 2c 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 6c 61 74 65 72 20 72 65 he.latter,.then.you.can.later.re
4f20 73 75 6d 65 20 74 68 65 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 75 73 69 sume.the.stack.of.transients.usi
4f40 6e 67 0a e2 80 98 4d 2d 78 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 e2 80 99 2e 0a 0a ng....M-x.transient-resume......
4f60 4b 65 79 3a 20 43 2d 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 73 65 71 29 0a 0a 4b Key:.C-g.(transient-quit-seq)..K
4f80 65 79 3a 20 43 2d 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e 65 29 0a 20 20 20 ey:.C-g.(transient-quit-one)....
4fa0 20 20 54 68 69 73 20 6b 65 79 20 71 75 69 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 61 ..This.key.quits.the.currently.a
4fc0 63 74 69 76 65 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 73 65 71 75 65 6e 63 65 2c 20 69 ctive.incomplete.key.sequence,.i
4fe0 66 0a 20 20 20 20 20 61 6e 79 2c 20 6f 72 20 65 6c 73 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 f......any,.or.else.the.current.
5000 74 72 61 6e 73 69 65 6e 74 2e 20 20 57 68 65 6e 20 71 75 69 74 74 69 6e 67 20 74 68 65 20 63 75 transient...When.quitting.the.cu
5020 72 72 65 6e 74 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2c 20 69 74 20 72 65 74 75 72 6e 73 rrent......transient,.it.returns
5040 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 74 72 61 6e 73 69 65 6e 74 2c 20 69 66 20 61 .to.the.previous.transient,.if.a
5060 6e 79 2e 0a 0a 20 20 20 54 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 70 72 65 64 65 63 65 73 73 6f ny......Transient...s.predecesso
5080 72 20 62 6f 75 6e 64 20 e2 80 98 71 e2 80 99 20 69 6e 73 74 65 61 64 20 6f 66 20 e2 80 98 43 2d r.bound....q....instead.of....C-
50a0 67 e2 80 99 20 74 6f 20 74 68 65 20 71 75 69 74 0a 63 6f 6d 6d 61 6e 64 2e 20 20 54 6f 20 6c 65 g....to.the.quit.command...To.le
50c0 61 72 6e 20 68 6f 77 20 74 6f 20 67 65 74 20 74 68 61 74 20 62 69 6e 64 69 6e 67 20 62 61 63 6b arn.how.to.get.that.binding.back
50e0 20 73 65 65 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d 71 2d 74 6f 2d 71 75 69 74 .see....transient-bind-q-to-quit
5100 e2 80 99 e2 80 99 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 2e 0a 0a 4b ......s.documentation.string...K
5120 65 79 3a 20 43 2d 71 20 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 29 0a 20 20 20 ey:.C-q.(transient-quit-all)....
5140 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 71 75 69 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 ..This.command.quits.the.current
5160 6c 79 20 61 63 74 69 76 65 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 73 65 71 75 65 6e 63 ly.active.incomplete.key.sequenc
5180 65 2c 20 69 66 0a 20 20 20 20 20 61 6e 79 2c 20 61 6e 64 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e e,.if......any,.and.all.transien
51a0 74 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 ts,.including.the.active.transie
51c0 6e 74 20 61 6e 64 20 61 6c 6c 0a 20 20 20 20 20 73 75 73 70 65 6e 64 65 64 20 74 72 61 6e 73 69 nt.and.all......suspended.transi
51e0 65 6e 74 73 2c 20 69 66 20 61 6e 79 2e 0a 0a 4b 65 79 3a 20 43 2d 7a 20 28 74 72 61 6e 73 69 65 ents,.if.any...Key:.C-z.(transie
5200 6e 74 2d 73 75 73 70 65 6e 64 29 0a 20 20 20 20 20 4c 69 6b 65 20 e2 80 98 74 72 61 6e 73 69 65 nt-suspend)......Like....transie
5220 6e 74 2d 71 75 69 74 2d 61 6c 6c e2 80 99 2c 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 71 75 69 nt-quit-all...,.this.command.qui
5240 74 73 20 61 6e 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 0a 20 20 20 20 20 73 65 71 75 65 6e ts.an.incomplete.key......sequen
5260 63 65 2c 20 69 66 20 61 6e 79 2c 20 61 6e 64 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 ce,.if.any,.and.all.transients..
5280 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 69 74 20 73 61 76 65 73 20 74 68 65 0a 20 20 20 20 .Additionally,.it.saves.the.....
52a0 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 73 6f 20 74 68 61 74 20 69 74 20 .stack.of.transients.so.that.it.
52c0 63 61 6e 20 65 61 73 69 6c 79 20 62 65 20 72 65 73 75 6d 65 64 20 28 77 68 69 63 68 20 69 73 0a can.easily.be.resumed.(which.is.
52e0 20 20 20 20 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 75 73 65 66 75 6c 20 69 66 20 79 6f 75 20 .....particularly.useful.if.you.
5300 71 75 69 63 6b 6c 79 20 6e 65 65 64 20 74 6f 20 64 6f 20 e2 80 9c 73 6f 6d 65 74 68 69 6e 67 20 quickly.need.to.do....something.
5320 65 6c 73 65 e2 80 9d 20 61 6e 64 0a 20 20 20 20 20 74 68 65 20 73 74 61 63 6b 20 69 73 20 64 65 else....and......the.stack.is.de
5340 65 70 65 72 20 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 61 6e eper.than.a.single.transient,.an
5360 64 2f 6f 72 20 79 6f 75 20 68 61 76 65 0a 20 20 20 20 20 61 6c 72 65 61 64 79 20 63 68 61 6e 67 d/or.you.have......already.chang
5380 65 64 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 6f 6d 65 20 69 6e 66 69 78 20 61 72 67 75 ed.the.values.of.some.infix.argu
53a0 6d 65 6e 74 73 29 2e 0a 0a 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 6f 6e 6c 79 20 61 20 73 ments)........Note.that.only.a.s
53c0 69 6e 67 6c 65 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 62 65 ingle.stack.of.transients.can.be
53e0 20 73 61 76 65 64 20 61 74 20 61 20 74 69 6d 65 2e 0a 20 20 20 20 20 49 66 20 61 6e 6f 74 68 65 .saved.at.a.time.......If.anothe
5400 72 20 73 74 61 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 73 61 76 65 64 2c 20 74 68 65 6e 20 73 r.stack.is.already.saved,.then.s
5420 61 76 69 6e 67 20 61 20 6e 65 77 20 73 74 61 63 6b 20 64 69 73 63 61 72 64 73 0a 20 20 20 20 20 aving.a.new.stack.discards......
5440 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 74 61 63 6b 2e 0a 0a 4b 65 79 3a 20 4d 2d 78 20 74 72 the.previous.stack...Key:.M-x.tr
5460 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 ansient-resume......This.command
5480 20 72 65 73 75 6d 65 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 73 75 73 70 65 6e 64 65 .resumes.the.previously.suspende
54a0 64 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 2c 0a 20 20 20 20 20 69 66 20 61 d.stack.of.transients,......if.a
54c0 6e 79 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f ny.....File:.doci3EOZM.info,..No
54e0 64 65 3a 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 4e 65 78 de:.Common.Suffix.Commands,..Nex
5500 74 3a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 2c 20 20 50 72 65 76 3a 20 41 62 6f 72 74 69 6e t:.Saving.Values,..Prev:.Abortin
5520 67 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 55 70 3a 20 g.and.Resuming.Transients,..Up:.
5540 55 73 61 67 65 0a 0a 32 2e 33 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 Usage..2.3.Common.Suffix.Command
5560 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 41 20 s.==========================..A.
5580 66 65 77 20 73 68 61 72 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 few.shared.suffix.commands.are.a
55a0 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 54 68 65 vailable.in.all.transients...The
55c0 73 65 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 74 20 73 68 6f 77 6e se.suffix.commands.are.not.shown
55e0 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 69 6e 20 65 76 65 72 79 20 6d 65 6e 75 20 62 79 20 64 65 .permanently.in.every.menu.by.de
5600 66 61 75 6c 74 2e 0a 4d 6f 73 74 20 6f 66 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 73 68 fault..Most.of.these.commands.sh
5620 61 72 65 20 61 20 63 6f 6d 6d 6f 6e 20 70 72 65 66 69 78 20 6b 65 79 20 61 6e 64 20 70 72 65 73 are.a.common.prefix.key.and.pres
5640 73 69 6e 67 20 74 68 61 74 20 6b 65 79 0a 63 61 75 73 65 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 sing.that.key.causes.the.common.
5660 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 62 65 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 6e commands.to.be.temporarily.shown
5680 20 69 6e 20 74 68 65 20 61 63 74 69 76 65 20 6d 65 6e 75 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f .in.the.active.menu...User.Optio
56a0 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 n:.transient-show-common-command
56c0 73 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 s......This.option.controls.whet
56e0 68 65 72 20 73 68 61 72 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 70 her.shared.suffix.commands.are.p
5700 65 72 6d 61 6e 65 6e 74 6c 79 0a 20 20 20 20 20 73 68 6f 77 6e 20 61 6c 6f 6e 67 73 69 64 65 20 ermanently......shown.alongside.
5720 74 68 65 20 6d 65 6e 75 2d 73 70 65 63 69 66 69 63 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 the.menu-specific.infix.and.suff
5740 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 42 79 0a 20 20 20 20 20 64 65 66 61 75 6c 74 2c 20 74 ix.commands...By......default,.t
5760 68 65 20 73 68 61 72 65 64 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 74 20 70 65 72 6d 61 he.shared.commands.are.not.perma
5780 6e 65 6e 74 6c 79 20 73 68 6f 77 6e 20 74 6f 20 61 76 6f 69 64 0a 20 20 20 20 20 77 61 73 74 69 nently.shown.to.avoid......wasti
57a0 6e 67 20 70 72 65 63 69 6f 75 73 20 73 70 61 63 65 20 61 6e 64 20 6f 76 65 72 77 68 65 6c 6d 69 ng.precious.space.and.overwhelmi
57c0 6e 67 20 74 68 65 20 75 73 65 72 20 77 69 74 68 20 74 6f 6f 20 6d 61 6e 79 0a 20 20 20 20 20 63 ng.the.user.with.too.many......c
57e0 68 6f 69 63 65 73 2e 0a 0a 20 20 20 20 20 49 66 20 79 6f 75 20 70 72 65 66 65 72 20 74 6f 20 61 hoices........If.you.prefer.to.a
5800 6c 77 61 79 73 20 73 65 65 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 65 6e 20 73 lways.see.these.commands,.then.s
5820 65 74 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 74 6f 0a 20 20 20 20 20 61 20 6e 6f 6e 2d e2 80 98 et.this.option.to......a.non-...
5840 6e 69 6c e2 80 99 20 76 61 6c 75 65 2e 20 20 41 6c 74 65 72 6e 61 74 69 76 65 6c 79 20 74 68 65 nil....value...Alternatively.the
5860 20 76 61 6c 75 65 20 63 61 6e 20 62 65 20 74 6f 67 67 6c 65 64 20 66 6f 72 20 74 68 65 0a 20 20 .value.can.be.toggled.for.the...
5880 20 20 20 63 75 72 72 65 6e 74 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 20 6f 6e 6c 79 2c 20 75 ...current.Emacs.session.only,.u
58a0 73 69 6e 67 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e e2 sing....transient-toggle-common.
58c0 80 99 2c 0a 20 20 20 20 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 0a 0a 55 73 65 72 20 ..,......described.below...User.
58e0 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 Option:.transient-common-command
5900 2d 70 72 65 66 69 78 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 70 65 63 69 66 69 -prefix......This.option.specifi
5920 65 73 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 20 69 6e 20 61 6c 6c 20 74 72 es.the.prefix.key.used.in.all.tr
5940 61 6e 73 69 65 6e 74 20 6d 65 6e 75 73 20 74 6f 0a 20 20 20 20 20 69 6e 76 6f 6b 65 20 6d 6f 73 ansient.menus.to......invoke.mos
5960 74 20 6f 66 20 74 68 65 20 73 68 61 72 65 64 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 20 t.of.the.shared.commands,.which.
5980 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 0a 20 20 20 20 20 74 72 61 6e 73 69 are.available.in.all......transi
59a0 65 6e 74 20 6d 65 6e 75 73 2e 20 20 42 79 20 64 65 66 61 75 6c 74 20 74 68 65 73 65 20 62 69 6e ent.menus...By.default.these.bin
59c0 64 69 6e 67 73 20 61 72 65 20 6f 6e 6c 79 20 73 68 6f 77 6e 20 61 66 74 65 72 0a 20 20 20 20 20 dings.are.only.shown.after......
59e0 70 72 65 73 73 69 6e 67 20 74 68 61 74 20 70 72 65 66 69 78 20 6b 65 79 20 61 6e 64 20 62 65 66 pressing.that.prefix.key.and.bef
5a00 6f 72 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 61 74 20 75 70 20 77 69 74 68 20 61 20 76 61 6c ore.following.that.up.with.a.val
5a20 69 64 0a 20 20 20 20 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 28 62 75 74 20 73 65 65 20 74 68 65 id......key.binding.(but.see.the
5a40 20 70 72 65 76 69 6f 75 73 20 6f 70 74 69 6f 6e 29 2e 0a 0a 20 20 20 20 20 46 6f 72 20 68 69 73 .previous.option)........For.his
5a60 74 6f 72 69 63 20 72 65 61 73 6f 6e 73 20 e2 80 98 43 2d 78 e2 80 99 20 69 73 20 75 73 65 64 20 toric.reasons....C-x....is.used.
5a80 62 79 20 64 65 66 61 75 6c 74 2c 20 62 75 74 20 75 73 65 72 73 20 61 72 65 0a 20 20 20 20 20 65 by.default,.but.users.are......e
5aa0 6e 63 6f 75 72 61 67 65 64 20 74 6f 20 70 69 63 6b 20 61 6e 6f 74 68 65 72 20 6b 65 79 2c 20 70 ncouraged.to.pick.another.key,.p
5ac0 72 65 66 65 72 61 62 6c 79 20 6f 6e 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 63 6f 6d 6d 6f 6e referably.one.that.is.not.common
5ae0 6c 79 0a 20 20 20 20 20 75 73 65 64 20 69 6e 20 45 6d 61 63 73 20 62 75 74 20 69 73 20 73 74 69 ly......used.in.Emacs.but.is.sti
5b00 6c 6c 20 63 6f 6e 76 65 6e 69 65 6e 74 20 74 6f 20 74 68 65 6d 2e 0a 0a 20 20 20 20 20 55 73 75 ll.convenient.to.them........Usu
5b20 61 6c 6c 79 2c 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 ally,.while.a.transient.menu.is.
5b40 61 63 74 69 76 65 2c 20 74 68 65 20 75 73 65 72 20 63 61 6e 6e 6f 74 20 69 6e 76 6f 6b 65 0a 20 active,.the.user.cannot.invoke..
5b60 20 20 20 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 62 6f 75 6e 64 20 ....commands.that.are.not.bound.
5b80 69 6e 20 74 68 65 20 6d 65 6e 75 20 69 74 73 65 6c 66 2e 20 20 46 6f 72 20 74 68 6f 73 65 20 6d in.the.menu.itself...For.those.m
5ba0 65 6e 75 73 20 69 74 0a 20 20 20 20 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 74 65 72 2c 20 69 66 enus.it......does.not.matter,.if
5bc0 20 e2 80 98 43 2d 78 e2 80 99 20 6f 72 20 61 6e 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e 6c 79 20 75 ....C-x....or.another.commonly.u
5be0 73 65 64 20 70 72 65 66 69 78 20 6b 65 79 20 69 73 0a 20 20 20 20 20 75 73 65 64 20 66 6f 72 20 sed.prefix.key.is......used.for.
5c00 63 6f 6d 6d 6f 6e 20 6d 65 6e 75 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 common.menu.commands...However,.
5c20 63 65 72 74 61 69 6e 20 6f 74 68 65 72 2c 20 6e 65 77 65 72 20 6d 65 6e 75 73 0a 20 20 20 20 20 certain.other,.newer.menus......
5c40 64 6f 20 6e 6f 74 20 73 75 70 70 72 65 73 73 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 65 73 74 do.not.suppress.key.bindings.est
5c60 61 62 6c 69 73 68 65 64 20 6f 75 74 73 69 64 65 20 74 68 65 20 6d 65 6e 75 20 69 74 73 65 6c 66 ablished.outside.the.menu.itself
5c80 2c 0a 20 20 20 20 20 61 6e 64 20 69 6e 20 74 68 6f 73 65 20 63 61 73 65 73 20 61 20 62 69 6e 64 ,......and.in.those.cases.a.bind
5ca0 69 6e 67 20 66 6f 72 20 61 20 63 6f 6d 6d 6f 6e 20 6d 65 6e 75 20 63 6f 6d 6d 61 6e 64 20 63 6f ing.for.a.common.menu.command.co
5cc0 75 6c 64 20 73 68 61 64 6f 77 0a 20 20 20 20 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 62 69 6e 64 uld.shadow......an.external.bind
5ce0 69 6e 67 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 e2 80 98 43 2d 78 20 43 2d 73 e2 80 99 ing...For.example,....C-x.C-s...
5d00 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 75 73 65 64 20 74 6f 0a 20 20 20 20 20 69 6e 76 6f 6b .could.not.be.used.to......invok
5d20 65 20 e2 80 98 73 61 76 65 2d 62 75 66 66 65 72 e2 80 99 2c 20 69 66 20 74 68 61 74 20 62 69 6e e....save-buffer...,.if.that.bin
5d40 64 69 6e 67 20 69 73 20 73 68 61 64 6f 77 65 64 20 62 79 20 74 68 65 20 6d 65 6e 75 0a 20 20 20 ding.is.shadowed.by.the.menu....
5d60 20 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 e2 ..binding.for....transient-save.
5d80 80 99 2e 0a 0a 20 20 20 20 20 57 68 69 63 68 20 6b 65 79 20 69 73 20 6d 6f 73 74 20 73 75 69 74 ..........Which.key.is.most.suit
5da0 61 62 6c 65 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 75 73 65 72 e2 80 99 73 20 70 72 65 able.depends.on.the.user...s.pre
5dc0 66 65 72 65 6e 63 65 73 2c 20 62 75 74 0a 20 20 20 20 20 67 6f 6f 64 20 63 68 6f 69 63 65 73 20 ferences,.but......good.choices.
5de0 6d 61 79 20 69 6e 63 6c 75 64 65 20 66 75 6e 63 74 69 6f 6e 20 6b 65 79 73 20 61 6e 64 20 e2 80 may.include.function.keys.and...
5e00 98 43 2d 7a e2 80 99 20 28 66 6f 72 20 6d 61 6e 79 20 6b 65 79 62 6f 61 72 64 0a 20 20 20 20 20 .C-z....(for.many.keyboard......
5e20 6c 61 79 6f 75 74 73 20 e2 80 98 7a e2 80 99 20 69 73 20 72 69 67 68 74 20 6e 65 78 74 20 74 6f layouts....z....is.right.next.to
5e40 20 e2 80 98 78 e2 80 99 2c 20 61 6e 64 20 69 6e 76 6f 6b 69 6e 67 20 e2 80 98 73 75 73 70 65 6e ....x...,.and.invoking....suspen
5e60 64 2d 66 72 61 6d 65 e2 80 99 2c 0a 20 20 20 20 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 d-frame...,......while.a.transie
5e80 6e 74 20 6d 65 6e 75 20 69 73 20 61 63 74 69 76 65 2c 20 77 6f 75 6c 64 20 6e 6f 74 20 62 65 20 nt.menu.is.active,.would.not.be.
5ea0 61 20 67 6f 6f 64 20 69 64 65 61 20 61 6e 79 77 61 79 29 2e 0a 0a 4b 65 79 3a 20 43 2d 78 20 74 a.good.idea.anyway)...Key:.C-x.t
5ec0 20 28 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 29 0a 20 20 20 20 20 .(transient-toggle-common)......
5ee0 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 74 6f 67 67 6c 65 73 20 77 68 65 74 68 65 72 20 74 68 65 This.command.toggles.whether.the
5f00 20 67 65 6e 65 72 69 63 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 61 74 20 61 72 65 20 63 6f 6d 6d .generic.commands,.that.are.comm
5f20 6f 6e 0a 20 20 20 20 20 74 6f 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2c 20 61 72 65 20 70 on......to.all.transients,.are.p
5f40 65 72 6d 61 6e 65 6e 74 6c 79 20 64 69 73 70 6c 61 79 65 64 20 6f 72 20 6f 6e 6c 79 20 61 66 74 ermanently.displayed.or.only.aft
5f60 65 72 20 74 79 70 69 6e 67 0a 20 20 20 20 20 74 68 65 20 69 6e 63 6f 6d 70 6c 65 74 65 20 70 72 er.typing......the.incomplete.pr
5f80 65 66 69 78 20 6b 65 79 20 73 65 71 75 65 6e 63 65 e2 80 98 e2 80 99 2e 20 20 54 68 69 73 20 6f efix.key.sequence.........This.o
5fa0 6e 6c 79 20 61 66 66 65 63 74 73 20 74 68 65 0a 20 20 20 20 20 63 75 72 72 65 6e 74 20 45 6d 61 nly.affects.the......current.Ema
5fc0 63 73 20 73 65 73 73 69 6f 6e 2e 0a 0a 20 20 20 54 68 65 20 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e cs.session......The.other.common
5fe0 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 65 69 74 68 65 .commands.are.described.in.eithe
6000 72 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 6f 72 20 69 6e 0a 6f 6e 65 20 6f 66 20 74 68 65 20 r.the.previous.or.in.one.of.the.
6020 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 63 74 69 6f 6e 73 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 following.sections.....File:.doc
6040 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 i3EOZM.info,..Node:.Saving.Value
6060 73 2c 20 20 4e 65 78 74 3a 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 2c 20 20 50 72 65 76 3a 20 s,..Next:.Using.History,..Prev:.
6080 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 55 70 3a 20 55 73 61 Common.Suffix.Commands,..Up:.Usa
60a0 67 65 0a 0a 32 2e 34 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ge..2.4.Saving.Values.==========
60c0 3d 3d 3d 3d 3d 3d 3d 0a 0a 41 66 74 65 72 20 73 65 74 74 69 6e 67 20 74 68 65 20 69 6e 66 69 78 =======..After.setting.the.infix
60e0 20 61 72 67 75 6d 65 6e 74 73 20 69 6e 20 61 20 74 72 61 6e 73 69 65 6e 74 2c 20 74 68 65 20 75 .arguments.in.a.transient,.the.u
6100 73 65 72 20 63 61 6e 20 73 61 76 65 0a 74 68 6f 73 65 20 61 72 67 75 6d 65 6e 74 73 20 66 6f 72 ser.can.save.those.arguments.for
6120 20 66 75 74 75 72 65 20 69 6e 76 6f 63 61 74 69 6f 6e 73 2e 0a 0a 20 20 20 4d 6f 73 74 20 74 72 .future.invocations......Most.tr
6140 61 6e 73 69 65 6e 74 73 20 77 69 6c 6c 20 73 74 61 72 74 20 6f 75 74 20 77 69 74 68 20 74 68 65 ansients.will.start.out.with.the
6160 20 73 61 76 65 64 20 61 72 67 75 6d 65 6e 74 73 20 77 68 65 6e 20 74 68 65 79 20 61 72 65 0a 69 .saved.arguments.when.they.are.i
6180 6e 76 6f 6b 65 64 2e 20 20 54 68 65 72 65 20 61 72 65 20 61 20 66 65 77 20 65 78 63 65 70 74 69 nvoked...There.are.a.few.excepti
61a0 6f 6e 73 2c 20 74 68 6f 75 67 68 2e 20 20 53 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 20 61 72 ons,.though...Some.transients.ar
61c0 65 0a 64 65 73 69 67 6e 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 20 76 61 6c 75 65 20 74 68 61 e.designed.so.that.the.value.tha
61e0 74 20 74 68 65 79 20 75 73 65 20 69 73 20 73 74 6f 72 65 64 20 65 78 74 65 72 6e 61 6c 6c 79 20 t.they.use.is.stored.externally.
6200 61 73 20 74 68 65 0a 62 75 66 66 65 72 2d 6c 6f 63 61 6c 20 76 61 6c 75 65 20 6f 66 20 73 6f 6d as.the.buffer-local.value.of.som
6220 65 20 76 61 72 69 61 62 6c 65 2e 20 20 49 6e 76 6f 6b 69 6e 67 20 73 75 63 68 20 61 20 74 72 61 e.variable...Invoking.such.a.tra
6240 6e 73 69 65 6e 74 20 61 67 61 69 6e 0a 75 73 65 73 20 74 68 65 20 62 75 66 66 65 72 2d 6c 6f 63 nsient.again.uses.the.buffer-loc
6260 61 6c 20 76 61 6c 75 65 2e 20 20 28 31 29 0a 0a 20 20 20 49 66 20 74 68 65 20 75 73 65 72 20 64 al.value...(1).....If.the.user.d
6280 6f 65 73 20 6e 6f 74 20 73 61 76 65 20 74 68 65 20 76 61 6c 75 65 20 61 6e 64 20 6a 75 73 74 20 oes.not.save.the.value.and.just.
62a0 65 78 69 74 73 20 75 73 69 6e 67 20 61 20 72 65 67 75 6c 61 72 0a 73 75 66 66 69 78 20 63 6f 6d exits.using.a.regular.suffix.com
62c0 6d 61 6e 64 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 6d 65 72 65 6c 79 20 73 mand,.then.the.value.is.merely.s
62e0 61 76 65 64 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 0a 68 69 73 74 6f 72 aved.to.the.transient...s.histor
6300 79 2e 20 20 54 68 61 74 20 76 61 6c 75 65 20 77 6f 6e e2 80 99 74 20 62 65 20 75 73 65 64 20 77 y...That.value.won...t.be.used.w
6320 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 6e 65 78 74 20 69 6e 76 6f 6b 65 hen.the.transient.is.next.invoke
6340 64 2c 0a 62 75 74 20 69 74 20 69 73 20 65 61 73 69 6c 79 20 61 63 63 65 73 73 69 62 6c 65 20 28 d,.but.it.is.easily.accessible.(
6360 73 65 65 20 2a 6e 6f 74 65 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 3a 3a 29 2e 0a 0a 20 20 20 see.*note.Using.History::)......
6380 4f 70 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 Option....transient-common-comma
63a0 6e 64 2d 70 72 65 66 69 78 e2 80 99 20 63 6f 6e 74 72 6f 6c 73 20 74 68 65 20 70 72 65 66 69 78 nd-prefix....controls.the.prefix
63c0 20 6b 65 79 20 75 73 65 64 0a 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e 64 69 .key.used.in.the.following.bindi
63e0 6e 67 73 2e 20 20 46 6f 72 20 73 69 6d 70 6c 69 63 69 74 79 e2 80 99 73 20 73 61 6b 65 20 74 68 ngs...For.simplicity...s.sake.th
6400 65 20 64 65 66 61 75 6c 74 2c 20 e2 80 98 43 2d 78 e2 80 99 2c 20 69 73 0a 73 68 6f 77 6e 20 62 e.default,....C-x...,.is.shown.b
6420 65 6c 6f 77 2e 0a 0a 4b 65 79 3a 20 43 2d 78 20 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 elow...Key:.C-x.s.(transient-set
6440 29 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 73 61 76 65 73 20 74 68 65 20 76 61 )......This.command.saves.the.va
6460 6c 75 65 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 66 6f 72 20 lue.of.the.active.transient.for.
6480 74 68 69 73 20 45 6d 61 63 73 0a 20 20 20 20 20 73 65 73 73 69 6f 6e 2e 0a 0a 4b 65 79 3a 20 43 this.Emacs......session...Key:.C
64a0 2d 78 20 43 2d 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 29 0a 20 20 20 20 20 54 68 69 -x.C-s.(transient-save)......Thi
64c0 73 20 63 6f 6d 6d 61 6e 64 20 73 61 76 65 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 s.command.saves.the.value.of.the
64e0 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 70 65 72 73 69 73 74 65 6e 74 6c 79 0a 20 .active.transient.persistently..
6500 20 20 20 20 61 63 72 6f 73 73 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 2e 0a 0a 4b 65 79 3a ....across.Emacs.sessions...Key:
6520 20 43 2d 78 20 43 2d 6b 20 28 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 65 74 29 0a 20 20 20 20 20 .C-x.C-k.(transient-reset)......
6540 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 63 6c 65 61 72 73 20 74 68 65 20 73 65 74 20 61 6e 64 20 This.command.clears.the.set.and.
6560 73 61 76 65 64 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 0a 20 20 20 20 20 saved.values.of.the.active......
6580 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 transient...User.Option:.transie
65a0 6e 74 2d 76 61 6c 75 65 73 2d 66 69 6c 65 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 nt-values-file......This.option.
65c0 6e 61 6d 65 73 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 70 names.the.file.that.is.used.to.p
65e0 65 72 73 69 73 74 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 0a 20 20 20 20 20 74 72 61 6e 73 69 ersist.the.values.of......transi
6600 65 6e 74 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 2e 0a 0a 20 20 ents.between.Emacs.sessions.....
6620 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 46 6f 6f 74 6e 6f 74 65 73 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .----------.Footnotes.----------
6640 0a 0a 20 20 20 28 31 29 20 e2 80 98 6d 61 67 69 74 2d 64 69 66 66 e2 80 99 20 61 6e 64 20 e2 80 .....(1)....magit-diff....and...
6660 98 6d 61 67 69 74 2d 6c 6f 67 e2 80 99 20 61 72 65 20 74 77 6f 20 70 72 6f 6d 69 6e 65 6e 74 20 .magit-log....are.two.prominent.
6680 65 78 61 6d 70 6c 65 73 2c 20 61 6e 64 0a 74 68 65 69 72 20 68 61 6e 64 6c 69 6e 67 20 6f 66 20 examples,.and.their.handling.of.
66a0 62 75 66 66 65 72 2d 6c 6f 63 61 6c 20 76 61 6c 75 65 73 20 69 73 20 61 63 74 75 61 6c 6c 79 20 buffer-local.values.is.actually.
66c0 61 20 62 69 74 20 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 0a 74 68 61 6e 20 6f 75 74 6c a.bit.more.complicated.than.outl
66e0 69 6e 65 64 20 61 62 6f 76 65 20 61 6e 64 20 65 76 65 6e 20 63 75 73 74 6f 6d 69 7a 61 62 6c 65 ined.above.and.even.customizable
6700 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 .....File:.doci3EOZM.info,..Node
6720 3a 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 2c 20 20 4e 65 78 74 3a 20 47 65 74 74 69 6e 67 20 :.Using.History,..Next:.Getting.
6740 48 65 6c 70 20 66 6f 72 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 50 72 65 76 3a Help.for.Suffix.Commands,..Prev:
6760 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 2c 20 20 55 70 3a 20 55 73 61 67 65 0a 0a 32 2e 35 20 .Saving.Values,..Up:.Usage..2.5.
6780 55 73 69 6e 67 20 48 69 73 74 6f 72 79 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a Using.History.=================.
67a0 0a 45 76 65 72 79 20 74 69 6d 65 20 74 68 65 20 75 73 65 72 20 69 6e 76 6f 6b 65 73 20 61 20 73 .Every.time.the.user.invokes.a.s
67c0 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 uffix.command.the.transient...s.
67e0 63 75 72 72 65 6e 74 0a 76 61 6c 75 65 20 69 73 20 73 61 76 65 64 20 74 6f 20 69 74 73 20 68 69 current.value.is.saved.to.its.hi
6800 73 74 6f 72 79 2e 20 20 54 68 65 73 65 20 76 61 6c 75 65 73 20 63 61 6e 20 62 65 20 63 79 63 6c story...These.values.can.be.cycl
6820 65 64 20 74 68 72 6f 75 67 68 2c 20 74 68 65 0a 73 61 6d 65 20 77 61 79 20 6f 6e 65 20 63 61 6e ed.through,.the.same.way.one.can
6840 20 63 79 63 6c 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 68 69 73 74 6f 72 79 20 6f 66 20 63 6f .cycle.through.the.history.of.co
6860 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 65 61 64 0a 75 73 65 72 2d 69 6e 70 75 74 20 69 6e 20 74 mmands.that.read.user-input.in.t
6880 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 20 20 20 4f 70 74 69 6f 6e 20 e2 80 98 74 72 61 he.minibuffer......Option....tra
68a0 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 e2 80 99 20 nsient-common-command-prefix....
68c0 63 6f 6e 74 72 6f 6c 73 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 0a 69 6e 20 controls.the.prefix.key.used.in.
68e0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e 64 69 6e 67 73 2e 20 20 46 6f 72 20 73 69 6d the.following.bindings...For.sim
6900 70 6c 69 63 69 74 79 e2 80 99 73 20 73 61 6b 65 20 74 68 65 20 64 65 66 61 75 6c 74 2c 20 e2 80 plicity...s.sake.the.default,...
6920 98 43 2d 78 e2 80 99 2c 20 69 73 0a 73 68 6f 77 6e 20 62 65 6c 6f 77 2e 0a 0a 4b 65 79 3a 20 43 .C-x...,.is.shown.below...Key:.C
6940 2d 4d 2d 70 20 28 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 76 29 0a 0a 4b -M-p.(transient-history-prev)..K
6960 65 79 3a 20 43 2d 78 20 70 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 73 77 69 74 ey:.C-x.p......This.command.swit
6980 63 68 65 73 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 20 75 73 65 64 20 ches.to.the.previous.value.used.
69a0 66 6f 72 20 74 68 65 20 61 63 74 69 76 65 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a for.the.active......transient...
69c0 4b 65 79 3a 20 43 2d 4d 2d 6e 20 28 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 6e 65 Key:.C-M-n.(transient-history-ne
69e0 78 74 29 0a 0a 4b 65 79 3a 20 43 2d 78 20 6e 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e xt)..Key:.C-x.n......This.comman
6a00 64 20 73 77 69 74 63 68 65 73 20 74 6f 20 74 68 65 20 6e 65 78 74 20 76 61 6c 75 65 20 75 73 65 d.switches.to.the.next.value.use
6a20 64 20 66 6f 72 20 74 68 65 20 61 63 74 69 76 65 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2e d.for.the.active......transient.
6a40 0a 0a 20 20 20 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e .....In.addition.to.the.transien
6a60 74 2d 77 69 64 65 20 68 69 73 74 6f 72 79 2c 20 69 6e 66 69 78 65 73 20 63 61 6e 20 68 61 76 65 t-wide.history,.infixes.can.have
6a80 20 74 68 65 69 72 20 6f 77 6e 0a 68 69 73 74 6f 72 79 2e 20 20 57 68 65 6e 20 61 6e 20 69 6e 66 .their.own.history...When.an.inf
6aa0 69 78 20 72 65 61 64 73 20 75 73 65 72 2d 69 6e 70 75 74 20 75 73 69 6e 67 20 74 68 65 20 6d 69 ix.reads.user-input.using.the.mi
6ac0 6e 69 62 75 66 66 65 72 2c 20 74 68 65 20 75 73 65 72 0a 63 61 6e 20 75 73 65 20 74 68 65 20 72 nibuffer,.the.user.can.use.the.r
6ae0 65 67 75 6c 61 72 20 6d 69 6e 69 62 75 66 66 65 72 20 68 69 73 74 6f 72 79 20 63 6f 6d 6d 61 6e egular.minibuffer.history.comman
6b00 64 73 20 74 6f 20 63 79 63 6c 65 20 74 68 72 6f 75 67 68 0a 70 72 65 76 69 6f 75 73 6c 79 20 75 ds.to.cycle.through.previously.u
6b20 73 65 64 20 76 61 6c 75 65 73 2e 20 20 55 73 75 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 20 6b 65 sed.values...Usually.the.same.ke
6b40 79 73 20 61 73 20 74 68 6f 73 65 20 6d 65 6e 74 69 6f 6e 65 64 20 61 62 6f 76 65 0a 61 72 65 20 ys.as.those.mentioned.above.are.
6b60 62 6f 75 6e 64 20 74 6f 20 74 68 6f 73 65 20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 20 20 41 75 74 bound.to.those.commands......Aut
6b80 68 6f 72 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 73 68 6f 75 6c 64 20 61 72 72 61 6e 67 hors.of.transients.should.arrang
6ba0 65 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 74 e.for.different.infix.commands.t
6bc0 68 61 74 20 72 65 61 64 20 74 68 65 20 73 61 6d 65 20 6b 69 6e 64 20 6f 66 20 76 61 6c 75 65 20 hat.read.the.same.kind.of.value.
6be0 74 6f 20 61 6c 73 6f 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 68 69 73 74 6f 72 79 20 6b 65 79 to.also.use.the.same.history.key
6c00 20 28 73 65 65 0a 2a 6e 6f 74 65 20 53 75 66 66 69 78 20 53 6c 6f 74 73 3a 3a 29 2e 0a 0a 20 20 .(see.*note.Suffix.Slots::).....
6c20 20 42 6f 74 68 20 6b 69 6e 64 73 20 6f 66 20 68 69 73 74 6f 72 79 20 61 72 65 20 73 61 76 65 64 .Both.kinds.of.history.are.saved
6c40 20 74 6f 20 61 20 66 69 6c 65 20 77 68 65 6e 20 45 6d 61 63 73 20 69 73 20 65 78 69 74 65 64 2e .to.a.file.when.Emacs.is.exited.
6c60 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 68 69 ..User.Option:.transient-save-hi
6c80 73 74 6f 72 79 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 story......This.option.controls.
6ca0 77 68 65 74 68 65 72 20 74 68 65 20 68 69 73 74 6f 72 79 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 whether.the.history.of.transient
6cc0 20 63 6f 6d 6d 61 6e 64 73 20 69 73 0a 20 20 20 20 20 73 61 76 65 64 20 77 68 65 6e 20 65 78 69 .commands.is......saved.when.exi
6ce0 74 69 6e 67 20 45 6d 61 63 73 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 ting.Emacs...User.Option:.transi
6d00 65 6e 74 2d 68 69 73 74 6f 72 79 2d 66 69 6c 65 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f ent-history-file......This.optio
6d20 6e 20 6e 61 6d 65 73 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f n.names.the.file.that.is.used.to
6d40 20 70 65 72 73 69 73 74 20 74 68 65 20 68 69 73 74 6f 72 79 20 6f 66 0a 20 20 20 20 20 74 72 61 .persist.the.history.of......tra
6d60 6e 73 69 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 69 6e 66 69 78 65 73 20 62 65 74 77 65 65 nsients.and.their.infixes.betwee
6d80 6e 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 n.Emacs.sessions...User.Option:.
6da0 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 6c 69 6d 69 74 0a 20 20 20 20 20 54 68 69 transient-history-limit......Thi
6dc0 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 68 6f 77 20 6d 61 6e 79 20 68 69 73 74 6f s.option.controls.how.many.histo
6de0 72 79 20 65 6c 65 6d 65 6e 74 73 20 61 72 65 20 6b 65 70 74 20 61 74 20 74 68 65 20 74 69 6d 65 ry.elements.are.kept.at.the.time
6e00 0a 20 20 20 20 20 74 68 65 20 68 69 73 74 6f 72 79 20 69 73 20 73 61 76 65 64 20 69 6e 20 e2 80 ......the.history.is.saved.in...
6e20 98 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 66 69 6c 65 e2 80 99 2e 0a 0a 1f 0a 46 .transient-history-file........F
6e40 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 47 65 74 74 ile:.doci3EOZM.info,..Node:.Gett
6e60 69 6e 67 20 48 65 6c 70 20 66 6f 72 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 4e ing.Help.for.Suffix.Commands,..N
6e80 65 78 74 3a 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 ext:.Enabling.and.Disabling.Suff
6ea0 69 78 65 73 2c 20 20 50 72 65 76 3a 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 2c 20 20 55 70 3a ixes,..Prev:.Using.History,..Up:
6ec0 20 55 73 61 67 65 0a 0a 32 2e 36 20 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 6f 72 20 53 75 66 .Usage..2.6.Getting.Help.for.Suf
6ee0 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d fix.Commands.===================
6f00 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 72 61 6e 73 69 65 6e 74 73 20 63 61 =================..Transients.ca
6f20 6e 20 68 61 76 65 20 6d 61 6e 79 20 73 75 66 66 69 78 65 73 20 61 6e 64 20 69 6e 66 69 78 65 73 n.have.many.suffixes.and.infixes
6f40 20 74 68 61 74 20 74 68 65 20 75 73 65 72 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 0a 66 61 6d 69 .that.the.user.might.not.be.fami
6f60 6c 69 61 72 20 77 69 74 68 2e 20 20 54 6f 20 6d 61 6b 65 20 69 74 20 74 72 69 76 69 61 6c 20 74 liar.with...To.make.it.trivial.t
6f80 6f 20 67 65 74 20 68 65 6c 70 20 66 6f 72 20 74 68 65 73 65 2c 20 54 72 61 6e 73 69 65 6e 74 0a o.get.help.for.these,.Transient.
6fa0 70 72 6f 76 69 64 65 73 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 provides.access.to.the.documenta
6fc0 74 69 6f 6e 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 61 63 74 69 76 65 20 74 72 tion.directly.from.the.active.tr
6fe0 61 6e 73 69 65 6e 74 2e 0a 0a 4b 65 79 3a 20 43 2d 68 20 28 74 72 61 6e 73 69 65 6e 74 2d 68 65 ansient...Key:.C-h.(transient-he
7000 6c 70 29 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 65 6e 74 65 72 73 20 68 65 6c lp)......This.command.enters.hel
7020 70 20 6d 6f 64 65 2e 20 20 57 68 65 6e 20 68 65 6c 70 20 6d 6f 64 65 20 69 73 20 61 63 74 69 76 p.mode...When.help.mode.is.activ
7040 65 2c 20 74 79 70 69 6e 67 20 61 0a 20 20 20 20 20 6b 65 79 20 73 68 6f 77 73 20 69 6e 66 6f 72 e,.typing.a......key.shows.infor
7060 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 mation.about.the.suffix.command.
7080 74 68 61 74 20 74 68 65 20 6b 65 79 0a 20 20 20 20 20 6e 6f 72 6d 61 6c 6c 79 20 69 73 20 62 6f that.the.key......normally.is.bo
70a0 75 6e 64 20 74 6f 20 28 69 6e 73 74 65 61 64 20 6f 66 20 69 6e 76 6f 6b 69 6e 67 20 69 74 29 2e und.to.(instead.of.invoking.it).
70c0 20 20 50 72 65 73 73 69 6e 67 20 e2 80 98 43 2d 68 e2 80 99 20 61 0a 20 20 20 20 20 73 65 63 6f ..Pressing....C-h....a......seco
70e0 6e 64 20 74 69 6d 65 20 73 68 6f 77 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 nd.time.shows.information.about.
7100 74 68 65 20 5f 70 72 65 66 69 78 5f 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 20 20 41 66 74 65 the._prefix_.command........Afte
7120 72 20 74 79 70 69 6e 67 20 61 20 6b 65 79 2c 20 74 68 65 20 73 74 61 63 6b 20 6f 66 20 74 72 61 r.typing.a.key,.the.stack.of.tra
7140 6e 73 69 65 6e 74 20 73 74 61 74 65 73 20 69 73 20 73 75 73 70 65 6e 64 65 64 20 61 6e 64 0a 20 nsient.states.is.suspended.and..
7160 20 20 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 78 ....information.about.the.suffix
7180 20 63 6f 6d 6d 61 6e 64 20 69 73 20 73 68 6f 77 6e 20 69 6e 73 74 65 61 64 2e 20 20 54 79 70 69 .command.is.shown.instead...Typi
71a0 6e 67 20 e2 80 98 71 e2 80 99 0a 20 20 20 20 20 69 6e 20 74 68 65 20 68 65 6c 70 20 62 75 66 66 ng....q.........in.the.help.buff
71c0 65 72 20 62 75 72 69 65 73 20 74 68 61 74 20 62 75 66 66 65 72 20 61 6e 64 20 72 65 73 75 6d 65 er.buries.that.buffer.and.resume
71e0 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 20 20 20 73 74 61 74 65 2e 0a 0a 20 20 20 s.the.transient......state......
7200 57 68 61 74 20 73 6f 72 74 20 6f 66 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 73 68 What.sort.of.documentation.is.sh
7220 6f 77 6e 20 64 65 70 65 6e 64 73 20 6f 6e 20 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 own.depends.on.how.the.transient
7240 20 77 61 73 0a 64 65 66 69 6e 65 64 2e 20 20 46 6f 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 .was.defined...For.infix.command
7260 73 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 61 72 s.that.represent.command-line.ar
7280 67 75 6d 65 6e 74 73 20 74 68 69 73 0a 69 64 65 61 6c 6c 79 20 73 68 6f 77 73 20 74 68 65 20 61 guments.this.ideally.shows.the.a
72a0 70 70 72 6f 70 72 69 61 74 65 20 6d 61 6e 70 61 67 65 2e 20 20 e2 80 98 74 72 61 6e 73 69 65 6e ppropriate.manpage......transien
72c0 74 2d 68 65 6c 70 e2 80 99 20 74 68 65 6e 20 74 72 69 65 73 20 74 6f 0a 6a 75 6d 70 20 74 6f 20 t-help....then.tries.to.jump.to.
72e0 74 68 65 20 63 6f 72 72 65 63 74 20 6c 6f 63 61 74 69 6f 6e 20 77 69 74 68 69 6e 20 74 68 61 74 the.correct.location.within.that
7300 2e 20 20 49 6e 66 6f 20 6d 61 6e 75 61 6c 73 20 61 72 65 20 61 6c 73 6f 0a 73 75 70 70 6f 72 74 ...Info.manuals.are.also.support
7320 65 64 2e 20 20 54 68 65 20 66 61 6c 6c 62 61 63 6b 20 69 73 20 74 6f 20 73 68 6f 77 20 74 68 65 ed...The.fallback.is.to.show.the
7340 20 63 6f 6d 6d 61 6e 64 e2 80 99 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e .command...s.documentation.strin
7360 67 2c 0a 66 6f 72 20 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 20 74 68 69 73 20 69 g,.for.non-infix.suffixes.this.i
7380 73 20 75 73 75 61 6c 6c 79 20 61 70 70 72 6f 70 72 69 61 74 65 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 s.usually.appropriate.....File:.
73a0 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 45 6e 61 62 6c 69 6e 67 20 doci3EOZM.info,..Node:.Enabling.
73c0 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 2c 20 20 4e 65 78 74 3a 20 4f and.Disabling.Suffixes,..Next:.O
73e0 74 68 65 72 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 50 72 65 76 3a 20 47 65 74 74 69 6e 67 20 48 65 ther.Commands,..Prev:.Getting.He
7400 6c 70 20 66 6f 72 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 55 70 3a 20 55 73 61 lp.for.Suffix.Commands,..Up:.Usa
7420 67 65 0a 0a 32 2e 37 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 ge..2.7.Enabling.and.Disabling.S
7440 75 66 66 69 78 65 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d uffixes.========================
7460 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 75 73 65 72 20 62 61 73 65 20 6f 66 20 61 20 ===========..The.user.base.of.a.
7480 70 61 63 6b 61 67 65 20 74 68 61 74 20 75 73 65 73 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e package.that.uses.transients.can
74a0 20 62 65 20 76 65 72 79 20 64 69 76 65 72 73 65 2e 0a 54 68 69 73 20 69 73 20 63 65 72 74 61 69 .be.very.diverse..This.is.certai
74c0 6e 6c 79 20 74 68 65 20 63 61 73 65 20 66 6f 72 20 4d 61 67 69 74 3b 20 73 6f 6d 65 20 75 73 65 nly.the.case.for.Magit;.some.use
74e0 72 73 20 68 61 76 65 20 62 65 65 6e 20 75 73 69 6e 67 20 69 74 20 61 6e 64 0a 47 69 74 20 66 6f rs.have.been.using.it.and.Git.fo
7500 72 20 61 20 64 65 63 61 64 65 2c 20 77 68 69 6c 65 20 6f 74 68 65 72 73 20 61 72 65 20 6a 75 73 r.a.decade,.while.others.are.jus
7520 74 20 67 65 74 74 69 6e 67 20 73 74 61 72 74 65 64 20 6e 6f 77 2e 0a 0a 20 20 20 46 6f 72 20 74 t.getting.started.now......For.t
7540 68 61 74 20 72 65 61 73 6f 6e 20 61 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 20 6e 65 65 64 65 64 hat.reason.a.mechanism.is.needed
7560 20 74 68 61 74 20 61 75 74 68 6f 72 73 20 63 61 6e 20 75 73 65 20 74 6f 0a 63 6c 61 73 73 69 66 .that.authors.can.use.to.classif
7580 79 20 61 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 65 73 20 61 6e 64 20 73 75 y.a.transient...s.infixes.and.su
75a0 66 66 69 78 65 73 20 61 6c 6f 6e 67 20 74 68 65 0a 65 73 73 65 6e 74 69 61 6c 73 2e 2e 2e 65 76 ffixes.along.the.essentials...ev
75c0 65 72 79 74 68 69 6e 67 20 73 70 65 63 74 72 75 6d 2e 20 20 57 65 20 75 73 65 20 74 68 65 20 74 erything.spectrum...We.use.the.t
75e0 65 72 6d 20 e2 80 9c 6c 65 76 65 6c 73 e2 80 9d 20 74 6f 20 64 65 73 63 72 69 62 65 0a 74 68 61 erm....levels....to.describe.tha
7600 74 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 0a 20 20 20 45 61 63 68 20 73 75 66 66 69 78 20 63 6f 6d t.mechanism......Each.suffix.com
7620 6d 61 6e 64 20 69 73 20 70 6c 61 63 65 64 20 6f 6e 20 61 20 6c 65 76 65 6c 20 61 6e 64 20 65 61 mand.is.placed.on.a.level.and.ea
7640 63 68 20 74 72 61 6e 73 69 65 6e 74 20 68 61 73 20 61 0a 6c 65 76 65 6c 20 28 63 61 6c 6c 65 64 ch.transient.has.a.level.(called
7660 20 e2 80 9c 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c e2 80 9d 29 2c 20 77 68 69 63 68 20 63 ....transient-level...),.which.c
7680 6f 6e 74 72 6f 6c 73 20 77 68 69 63 68 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 61 72 ontrols.which.suffix.commands.ar
76a0 65 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 49 6e 74 65 67 65 72 73 20 62 65 74 77 65 65 6e 20 31 e.available...Integers.between.1
76c0 20 61 6e 64 20 37 20 28 69 6e 63 6c 75 73 69 76 65 29 20 61 72 65 20 76 61 6c 69 64 20 6c 65 76 .and.7.(inclusive).are.valid.lev
76e0 65 6c 73 2e 0a 46 6f 72 20 73 75 66 66 69 78 65 73 2c 20 30 20 69 73 20 61 6c 73 6f 20 76 61 6c els..For.suffixes,.0.is.also.val
7700 69 64 3b 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 73 75 66 66 69 78 20 69 73 20 id;.it.means.that.the.suffix.is.
7720 6e 6f 74 20 64 69 73 70 6c 61 79 65 64 0a 61 74 20 61 6e 79 20 6c 65 76 65 6c 2e 0a 0a 20 20 20 not.displayed.at.any.level......
7740 54 68 65 20 6c 65 76 65 6c 73 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 The.levels.of.individual.transie
7760 6e 74 73 20 61 6e 64 2f 6f 72 20 74 68 65 69 72 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 nts.and/or.their.individual.suff
7780 69 78 65 73 0a 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c ixes.can.be.changed.interactivel
77a0 79 2c 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 20 65 6e 74 65 y,.by.invoking.the.menu.and.ente
77c0 72 69 6e 67 20 69 74 73 0a e2 80 9c 65 64 69 74 e2 80 9d 20 6d 6f 64 65 20 75 73 69 6e 67 20 74 ring.its....edit....mode.using.t
77e0 68 65 20 63 6f 6d 6d 61 6e 64 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 he.command....transient-set-leve
7800 6c e2 80 99 2c 20 61 73 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 0a 0a 20 20 20 54 68 l...,.as.described.below......Th
7820 65 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 20 66 6f 72 20 62 6f 74 68 20 74 72 61 6e 73 69 65 e.default.level.for.both.transie
7840 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 73 75 66 66 69 78 65 73 20 69 73 20 34 2e 20 20 54 68 nts.and.their.suffixes.is.4...Th
7860 65 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c e2 80 99 20 e....transient-default-level....
7880 6f 70 74 69 6f 6e 20 6f 6e 6c 79 20 63 6f 6e 74 72 6f 6c 73 20 74 68 65 20 64 65 66 61 75 6c 74 option.only.controls.the.default
78a0 20 66 6f 72 0a 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 75 .for.transients...The.default.su
78c0 66 66 69 78 20 6c 65 76 65 6c 20 69 73 20 61 6c 77 61 79 73 20 34 2e 20 20 54 68 65 20 61 75 74 ffix.level.is.always.4...The.aut
78e0 68 6f 72 73 20 6f 66 0a 74 72 61 6e 73 69 65 6e 74 73 20 73 68 6f 75 6c 64 20 70 6c 61 63 65 20 hors.of.transients.should.place.
7900 63 65 72 74 61 69 6e 20 73 75 66 66 69 78 65 73 20 6f 6e 20 61 20 68 69 67 68 65 72 20 6c 65 76 certain.suffixes.on.a.higher.lev
7920 65 6c 2c 20 69 66 20 74 68 65 79 0a 65 78 70 65 63 74 20 74 68 61 74 20 69 74 20 77 6f 6e e2 80 el,.if.they.expect.that.it.won..
7940 99 74 20 62 65 20 6f 66 20 75 73 65 20 74 6f 20 6d 6f 73 74 20 75 73 65 72 73 2c 20 61 6e 64 20 .t.be.of.use.to.most.users,.and.
7960 74 68 65 79 20 73 68 6f 75 6c 64 20 70 6c 61 63 65 20 76 65 72 79 0a 69 6d 70 6f 72 74 61 6e 74 they.should.place.very.important
7980 20 73 75 66 66 69 78 65 73 20 6f 6e 20 61 20 6c 6f 77 65 72 20 6c 65 76 65 6c 2c 20 73 6f 20 74 .suffixes.on.a.lower.level,.so.t
79a0 68 61 74 20 74 68 65 79 20 72 65 6d 61 69 6e 20 61 76 61 69 6c 61 62 6c 65 20 65 76 65 6e 0a 69 hat.they.remain.available.even.i
79c0 66 20 74 68 65 20 75 73 65 72 20 6c 6f 77 65 72 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 f.the.user.lowers.the.transient.
79e0 6c 65 76 65 6c 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 level...User.Option:.transient-d
7a00 65 66 61 75 6c 74 2d 6c 65 76 65 6c 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f efault-level......This.option.co
7a20 6e 74 72 6f 6c 73 20 77 68 69 63 68 20 73 75 66 66 69 78 20 6c 65 76 65 6c 73 20 61 72 65 20 6d ntrols.which.suffix.levels.are.m
7a40 61 64 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 0a 20 20 20 20 20 64 65 66 61 75 6c 74 2e 20 20 ade.available.by......default...
7a60 49 74 20 73 65 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 20 66 6f 72 20 It.sets.the.transient-level.for.
7a80 74 72 61 6e 73 69 65 6e 74 73 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 0a 20 20 20 20 20 75 73 transients.for.which.the......us
7aa0 65 72 20 68 61 73 20 6e 6f 74 20 73 65 74 20 74 68 61 74 20 69 6e 64 69 76 69 64 75 61 6c 6c 79 er.has.not.set.that.individually
7ac0 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 ...User.Option:.transient-levels
7ae0 2d 66 69 6c 65 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 73 20 74 68 65 -file......This.option.names.the
7b00 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 70 65 72 73 69 73 74 20 74 68 .file.that.is.used.to.persist.th
7b20 65 20 6c 65 76 65 6c 73 20 6f 66 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6e 64 20 e.levels.of......transients.and.
7b40 74 68 65 69 72 20 73 75 66 66 69 78 65 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 20 73 65 73 their.suffixes.between.Emacs.ses
7b60 73 69 6f 6e 73 2e 0a 0a 20 20 20 4f 70 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 sions......Option....transient-c
7b80 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 e2 80 99 20 63 6f 6e 74 72 6f 6c 73 ommon-command-prefix....controls
7ba0 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 0a 69 6e 20 74 68 65 20 66 6f 6c 6c .the.prefix.key.used.in.the.foll
7bc0 6f 77 69 6e 67 20 62 69 6e 64 69 6e 67 73 2e 20 20 46 6f 72 20 73 69 6d 70 6c 69 63 69 74 79 e2 owing.bindings...For.simplicity.
7be0 80 99 73 20 73 61 6b 65 20 74 68 65 20 64 65 66 61 75 6c 74 2c 20 e2 80 98 43 2d 78 e2 80 99 2c ..s.sake.the.default,....C-x...,
7c00 20 69 73 0a 73 68 6f 77 6e 20 62 65 6c 6f 77 2e 0a 0a 4b 65 79 3a 20 43 2d 78 20 6c 20 28 74 72 .is.shown.below...Key:.C-x.l.(tr
7c20 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c 29 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d ansient-set-level)......This.com
7c40 6d 61 6e 64 20 65 6e 74 65 72 73 20 65 64 69 74 20 6d 6f 64 65 2e 20 20 57 68 65 6e 20 65 64 69 mand.enters.edit.mode...When.edi
7c60 74 20 6d 6f 64 65 20 69 73 20 61 63 74 69 76 65 2c 20 74 68 65 6e 20 61 6c 6c 0a 20 20 20 20 20 t.mode.is.active,.then.all......
7c80 69 6e 66 69 78 65 73 20 61 6e 64 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 65 20 63 75 infixes.and.suffixes.that.are.cu
7ca0 72 72 65 6e 74 6c 79 20 75 73 61 62 6c 65 20 61 72 65 20 64 69 73 70 6c 61 79 65 64 20 61 6c 6f rrently.usable.are.displayed.alo
7cc0 6e 67 0a 20 20 20 20 20 77 69 74 68 20 74 68 65 69 72 20 6c 65 76 65 6c 73 2e 20 20 54 68 65 20 ng......with.their.levels...The.
7ce0 63 6f 6c 6f 72 73 20 6f 66 20 74 68 65 20 6c 65 76 65 6c 73 20 69 6e 64 69 63 61 74 65 20 77 68 colors.of.the.levels.indicate.wh
7d00 65 74 68 65 72 20 74 68 65 79 0a 20 20 20 20 20 61 72 65 20 65 6e 61 62 6c 65 64 20 6f 72 20 6e ether.they......are.enabled.or.n
7d20 6f 74 2e 20 20 54 68 65 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 ot...The.level.of.the.transient.
7d40 69 73 20 61 6c 73 6f 20 64 69 73 70 6c 61 79 65 64 0a 20 20 20 20 20 61 6c 6f 6e 67 20 77 69 74 is.also.displayed......along.wit
7d60 68 20 73 6f 6d 65 20 75 73 61 67 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 h.some.usage.information........
7d80 49 6e 20 65 64 69 74 20 6d 6f 64 65 2c 20 70 72 65 73 73 69 6e 67 20 74 68 65 20 6b 65 79 20 74 In.edit.mode,.pressing.the.key.t
7da0 68 61 74 20 77 6f 75 6c 64 20 75 73 75 61 6c 6c 79 20 69 6e 76 6f 6b 65 20 61 20 63 65 72 74 61 hat.would.usually.invoke.a.certa
7dc0 69 6e 0a 20 20 20 20 20 73 75 66 66 69 78 20 69 6e 73 74 65 61 64 20 70 72 6f 6d 70 74 73 20 74 in......suffix.instead.prompts.t
7de0 68 65 20 75 73 65 72 20 66 6f 72 20 74 68 65 20 6c 65 76 65 6c 20 74 68 61 74 20 73 75 66 66 69 he.user.for.the.level.that.suffi
7e00 78 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20 20 70 6c 61 63 65 64 20 6f 6e 2e 0a 0a 20 20 20 x.should.be......placed.on......
7e20 20 20 48 65 6c 70 20 6d 6f 64 65 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 65 64 69 74 ..Help.mode.is.available.in.edit
7e40 20 6d 6f 64 65 2e 0a 0a 20 20 20 20 20 54 6f 20 63 68 61 6e 67 65 20 74 68 65 20 74 72 61 6e 73 .mode........To.change.the.trans
7e60 69 65 6e 74 20 6c 65 76 65 6c 20 70 72 65 73 73 20 e2 80 98 43 2d 78 20 6c e2 80 99 20 61 67 61 ient.level.press....C-x.l....aga
7e80 69 6e 2e 0a 0a 20 20 20 20 20 54 6f 20 65 78 69 74 20 65 64 69 74 20 6d 6f 64 65 20 70 72 65 73 in........To.exit.edit.mode.pres
7ea0 73 20 e2 80 98 43 2d 67 e2 80 99 2e 0a 0a 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 65 64 69 s....C-g...........Note.that.edi
7ec0 74 20 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 64 69 73 70 6c 61 79 20 61 6e 79 20 73 75 66 66 t.mode.does.not.display.any.suff
7ee0 69 78 65 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 0a 20 20 20 20 20 63 75 72 72 65 6e 74 6c 79 ixes.that.are.not......currently
7f00 20 75 73 61 62 6c 65 2e 20 20 e2 80 98 6d 61 67 69 74 2d 72 65 62 61 73 65 e2 80 99 2c 20 66 6f .usable......magit-rebase...,.fo
7f20 72 20 65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 73 20 64 69 66 66 65 72 65 6e 74 0a 20 20 20 20 20 r.example,.shows.different......
7f40 73 75 66 66 69 78 65 73 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 72 20 61 20 suffixes.depending.on.whether.a.
7f60 72 65 62 61 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 70 72 6f 67 72 65 73 73 20 6f 72 rebase.is.already.in.progress.or
7f80 0a 20 20 20 20 20 6e 6f 74 2e 20 20 54 68 65 20 70 72 65 64 69 63 61 74 65 73 20 61 6c 73 6f 20 ......not...The.predicates.also.
7fa0 61 70 70 6c 79 20 69 6e 20 65 64 69 74 20 6d 6f 64 65 2e 0a 0a 20 20 20 20 20 54 68 65 72 65 66 apply.in.edit.mode........Theref
7fc0 6f 72 65 2c 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 77 68 69 63 68 20 73 75 66 66 69 78 65 73 20 61 ore,.to.control.which.suffixes.a
7fe0 72 65 20 61 76 61 69 6c 61 62 6c 65 20 67 69 76 65 6e 20 61 20 63 65 72 74 61 69 6e 0a 20 20 20 re.available.given.a.certain....
8000 20 20 73 74 61 74 65 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 ..state,.you.have.to.make.sure.t
8020 68 61 74 20 74 68 61 74 20 73 74 61 74 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 hat.that.state.is.currently.acti
8040 76 65 2e 0a 0a 4b 65 79 3a 20 43 2d 78 20 61 20 28 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c ve...Key:.C-x.a.(transient-toggl
8060 65 2d 6c 65 76 65 6c 2d 6c 69 6d 69 74 29 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 e-level-limit)......This.command
8080 20 74 6f 67 67 6c 65 20 77 68 65 74 68 65 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 .toggle.whether.suffixes.that.ar
80a0 65 20 6f 6e 20 6c 65 76 65 6c 73 20 68 69 67 68 65 72 20 74 68 61 6e 0a 20 20 20 20 20 74 68 65 e.on.levels.higher.than......the
80c0 20 6c 65 76 65 6c 20 73 70 65 63 69 66 69 65 64 20 62 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 .level.specified.by....transient
80e0 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c e2 80 99 20 61 72 65 20 74 65 6d 70 6f 72 61 72 69 6c -default-level....are.temporaril
8100 79 0a 20 20 20 20 20 61 76 61 69 6c 61 62 6c 65 20 61 6e 79 77 61 79 2e 0a 0a 46 75 6e 63 74 69 y......available.anyway...Functi
8120 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 on:.transient-set-default-level.
8140 73 75 66 66 69 78 20 6c 65 76 65 6c 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 suffix.level......This.function.
8160 73 65 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 73 75 sets.the.default.level.of.the.su
8180 66 66 69 78 20 43 4f 4d 4d 41 4e 44 20 74 6f 0a 20 20 20 20 20 4c 45 56 45 4c 2e 0a 0a 20 20 20 ffix.COMMAND.to......LEVEL......
81a0 20 20 49 66 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 70 70 65 61 72 73 20 69 6e ..If.a.suffix.command.appears.in
81c0 20 6d 75 6c 74 69 70 6c 65 20 6d 65 6e 75 73 2c 20 69 74 20 6d 61 79 20 6d 61 6b 65 20 73 65 6e .multiple.menus,.it.may.make.sen
81e0 73 65 20 74 6f 0a 20 20 20 20 20 63 6f 6e 73 69 73 74 65 6e 74 6c 79 20 63 68 61 6e 67 65 20 69 se.to......consistently.change.i
8200 74 73 20 6c 65 76 65 6c 20 69 6e 20 61 6c 6c 20 74 68 6f 73 65 20 6d 65 6e 75 73 20 61 74 20 6f ts.level.in.all.those.menus.at.o
8220 6e 63 65 2e 20 20 46 6f 72 0a 20 20 20 20 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 e2 80 98 2d nce...For......example,.the....-
8240 2d 67 70 67 2d 73 69 67 6e e2 80 99 20 61 72 67 75 6d 65 6e 74 20 28 77 68 69 63 68 20 69 73 20 -gpg-sign....argument.(which.is.
8260 69 6d 70 6c 65 6d 65 6e 74 65 64 20 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 20 63 6f 6d 6d 61 implemented.using.the......comma
8280 6e 64 20 e2 80 98 6d 61 67 69 74 3a 2d 2d 67 70 67 2d 73 69 67 6e e2 80 99 29 2c 20 69 73 20 62 nd....magit:--gpg-sign...),.is.b
82a0 6f 75 6e 64 20 69 6e 20 61 6c 6c 20 6f 66 20 4d 61 67 69 74 e2 80 99 73 20 6d 65 6e 75 20 77 68 ound.in.all.of.Magit...s.menu.wh
82c0 69 63 68 0a 20 20 20 20 20 63 72 65 61 74 65 20 63 6f 6d 6d 69 74 73 2e 20 20 55 73 65 72 73 20 ich......create.commits...Users.
82e0 77 68 6f 20 73 6f 6d 65 74 69 6d 65 73 20 73 69 67 6e 20 74 68 65 69 72 20 63 6f 6d 6d 69 74 73 who.sometimes.sign.their.commits
8300 20 77 6f 75 6c 64 20 77 61 6e 74 0a 20 20 20 20 20 74 68 61 74 20 61 72 67 75 6d 65 6e 74 20 74 .would.want......that.argument.t
8320 6f 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 20 6f 66 20 74 68 65 73 65 20 6d o.be.available.in.all.of.these.m
8340 65 6e 75 73 2c 20 77 68 69 6c 65 20 66 6f 72 0a 20 20 20 20 20 75 73 65 72 73 20 77 68 6f 20 6e enus,.while.for......users.who.n
8360 65 76 65 72 20 73 69 67 6e 20 69 74 20 69 73 20 6a 75 73 74 20 75 6e 6e 65 63 65 73 73 61 72 79 ever.sign.it.is.just.unnecessary
8380 20 6e 6f 69 73 65 20 69 6e 20 61 6e 79 20 6d 65 6e 75 73 2e 0a 0a 20 20 20 20 20 54 6f 20 61 6c .noise.in.any.menus........To.al
83a0 77 61 79 73 20 6d 61 6b 65 20 e2 80 98 2d 2d 67 70 67 2d 73 69 67 6e e2 80 99 20 61 76 61 69 6c ways.make....--gpg-sign....avail
83c0 61 62 6c 65 2c 20 75 73 65 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 able,.use:............(transient
83e0 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 27 6d 61 67 69 74 3a 2d 2d 67 70 67 2d -set-default-level.'magit:--gpg-
8400 73 69 67 6e 20 31 29 0a 0a 20 20 20 20 20 54 6f 20 6e 65 76 65 72 20 6d 61 6b 65 20 e2 80 98 2d sign.1).......To.never.make....-
8420 2d 67 70 67 2d 73 69 67 6e e2 80 99 20 61 76 61 69 6c 61 62 6c 65 2c 20 75 73 65 3a 0a 0a 20 20 -gpg-sign....available,.use:....
8440 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c ........(transient-set-default-l
8460 65 76 65 6c 20 27 6d 61 67 69 74 3a 2d 2d 67 70 67 2d 73 69 67 6e 20 30 29 0a 0a 20 20 20 20 20 evel.'magit:--gpg-sign.0).......
8480 54 68 69 73 20 73 65 74 73 20 74 68 65 20 6c 65 76 65 6c 20 69 6e 20 74 68 65 20 73 75 66 66 69 This.sets.the.level.in.the.suffi
84a0 78 20 70 72 6f 74 6f 74 79 70 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 69 73 0a 20 20 20 20 x.prototype.object.for.this.....
84c0 20 63 6f 6d 6d 61 6e 64 2e 20 20 43 6f 6d 6d 61 6e 64 73 20 6f 6e 6c 79 20 68 61 76 65 20 61 20 .command...Commands.only.have.a.
84e0 73 75 66 66 69 78 20 70 72 6f 74 6f 74 79 70 65 20 69 66 20 74 68 65 79 20 77 65 72 65 0a 20 20 suffix.prototype.if.they.were...
8500 20 20 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 6f 6e 65 20 6f 66 20 e2 80 98 74 72 61 6e 73 ...defined.using.one.of....trans
8520 69 65 6e 74 2d 64 65 66 69 6e 65 2d 61 72 67 75 6d 65 6e 74 e2 80 99 2c 0a 20 20 20 20 20 e2 80 ient-define-argument...,........
8540 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 e2 80 99 20 61 6e 64 20 e2 .transient-define-infix....and..
8560 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 e2 80 99 2e 20 20 46 ..transient-define-suffix......F
8580 6f 72 20 61 6c 6c 0a 20 20 20 20 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 69 73 20 or.all......other.commands.this.
85a0 77 6f 75 6c 64 20 73 69 67 6e 61 6c 20 61 6e 20 65 72 72 6f 72 2e 20 20 28 54 68 69 73 20 69 73 would.signal.an.error...(This.is
85c0 20 6f 6e 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 72 65 61 73 6f 6e 73 20 77 68 79 20 70 61 63 .one.of.the......reasons.why.pac
85e0 6b 61 67 65 20 61 75 74 68 6f 72 73 20 73 68 6f 75 6c 64 20 75 73 65 20 6f 6e 65 20 6f 66 20 74 kage.authors.should.use.one.of.t
8600 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 0a 20 20 20 20 20 64 65 66 69 6e 65 20 73 68 hese.functions.to......define.sh
8620 61 72 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 65 73 70 65 63 69 ared.suffix.commands,.and.especi
8640 61 6c 6c 79 20 73 68 61 72 65 64 20 61 72 67 75 6d 65 6e 74 73 2e 29 0a 0a 20 20 20 20 20 49 66 ally.shared.arguments.).......If
8660 20 74 68 65 20 75 73 65 72 20 63 68 61 6e 67 65 73 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 20 61 .the.user.changes.the.level.of.a
8680 20 73 75 66 66 69 78 20 69 6e 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 6d 65 6e 75 2c 0a 20 20 .suffix.in.a.particular.menu,...
86a0 20 20 20 75 73 69 6e 67 20 e2 80 98 43 2d 78 20 6c e2 80 99 20 61 73 20 73 68 6f 77 6e 20 61 62 ...using....C-x.l....as.shown.ab
86c0 6f 76 65 2c 20 74 68 65 6e 20 74 68 61 74 20 6f 62 76 69 6f 75 73 6c 79 20 73 68 61 64 6f 77 73 ove,.then.that.obviously.shadows
86e0 20 74 68 65 0a 20 20 20 20 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 20 20 20 49 74 20 69 73 20 61 .the......default........It.is.a
8700 6c 73 6f 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 lso.possible.to.set.the.level.of
8720 20 61 20 73 75 66 66 69 78 20 62 69 6e 64 69 6e 67 20 69 6e 20 61 0a 20 20 20 20 20 70 61 72 74 .a.suffix.binding.in.a......part
8740 69 63 75 6c 61 72 20 6d 65 6e 75 2c 20 65 69 74 68 65 72 20 77 68 65 6e 20 64 65 66 69 6e 69 6e icular.menu,.either.when.definin
8760 67 20 74 68 65 20 6d 65 6e 75 20 75 73 69 6e 67 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 g.the.menu.using.........transie
8780 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 2c e2 80 99 20 6f 72 20 6c 61 74 65 72 20 75 73 nt-define-prefix,....or.later.us
87a0 69 6e 67 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 ing.........transient-insert-suf
87c0 66 69 78 e2 80 99 2e 20 20 49 66 20 73 75 63 68 20 62 69 6e 64 69 6e 67 73 20 73 70 65 63 69 66 fix......If.such.bindings.specif
87e0 79 20 61 20 6c 65 76 65 6c 2c 20 74 68 65 6e 0a 20 20 20 20 20 74 68 61 74 20 61 6c 73 6f 20 6f y.a.level,.then......that.also.o
8800 76 65 72 72 69 64 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 2e 20 20 28 50 65 72 2d 73 75 66 66 verrides.the.default...(Per-suff
8820 69 78 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 73 20 69 73 20 61 0a 20 20 20 20 20 6e 65 77 20 ix.default.levels.is.a......new.
8840 66 65 61 74 75 72 65 2c 20 73 6f 20 79 6f 75 20 6d 69 67 68 74 20 65 6e 63 6f 75 6e 74 65 72 20 feature,.so.you.might.encounter.
8860 74 68 69 73 20 71 75 69 74 65 20 6f 66 74 65 6e 2e 29 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 this.quite.often.)....File:.doci
8880 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 4f 74 68 65 72 20 43 6f 6d 6d 61 6e 64 3EOZM.info,..Node:.Other.Command
88a0 73 2c 20 20 4e 65 78 74 3a 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 20 50 72 65 76 3a 20 s,..Next:.Configuration,..Prev:.
88c0 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 2c Enabling.and.Disabling.Suffixes,
88e0 20 20 55 70 3a 20 55 73 61 67 65 0a 0a 32 2e 38 20 4f 74 68 65 72 20 43 6f 6d 6d 61 6e 64 73 0a ..Up:.Usage..2.8.Other.Commands.
8900 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 57 68 65 6e 20 69 6e 76 6f 6b 69 6e ==================..When.invokin
8920 67 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 20 61 20 73 6d 61 6c 6c 20 66 72 61 6d 65 2c 20 g.a.transient.in.a.small.frame,.
8940 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 69 6e 64 6f 77 20 6d 61 79 20 6e 6f 74 0a 73 68 6f the.transient.window.may.not.sho
8960 77 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 62 75 66 66 65 72 2c 20 6d 61 6b 69 6e 67 20 69 74 w.the.complete.buffer,.making.it
8980 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 73 63 72 6f 6c 6c 2c 20 75 73 69 6e 67 20 74 68 65 0a .necessary.to.scroll,.using.the.
89a0 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 73 65 20 63 6f 6d 6d 61 following.commands...These.comma
89c0 6e 64 73 20 61 72 65 20 6e 65 76 65 72 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 74 72 61 6e 73 nds.are.never.shown.in.the.trans
89e0 69 65 6e 74 0a 77 69 6e 64 6f 77 2c 20 61 6e 64 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 ient.window,.and.the.key.binding
8a00 73 20 61 72 65 20 74 68 65 20 73 61 6d 65 20 61 73 20 66 6f 72 20 e2 80 98 73 63 72 6f 6c 6c 2d s.are.the.same.as.for....scroll-
8a20 75 70 2d 63 6f 6d 6d 61 6e 64 e2 80 99 20 61 6e 64 0a e2 80 98 73 63 72 6f 6c 6c 2d 64 6f 77 6e up-command....and....scroll-down
8a40 2d 63 6f 6d 6d 61 6e 64 e2 80 99 20 69 6e 20 6f 74 68 65 72 20 62 75 66 66 65 72 73 2e 0a 0a 43 -command....in.other.buffers...C
8a60 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 20 61 72 67 0a ommand:.transient-scroll-up.arg.
8a80 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 73 63 72 6f 6c 6c 73 20 74 65 78 74 20 6f .....This.command.scrolls.text.o
8aa0 66 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 75 70 77 61 f.transient...s.menu.window.upwa
8ac0 72 64 20 41 52 47 0a 20 20 20 20 20 6c 69 6e 65 73 2e 20 20 49 66 20 41 52 47 20 69 73 20 e2 80 rd.ARG......lines...If.ARG.is...
8ae0 98 6e 69 6c e2 80 99 2c 20 74 68 65 6e 20 69 74 20 73 63 72 6f 6c 6c 73 20 6e 65 61 72 20 66 75 .nil...,.then.it.scrolls.near.fu
8b00 6c 6c 20 73 63 72 65 65 6e 2e 20 20 54 68 69 73 20 69 73 0a 20 20 20 20 20 61 20 77 72 61 70 70 ll.screen...This.is......a.wrapp
8b20 65 72 20 61 72 6f 75 6e 64 20 e2 80 98 73 63 72 6f 6c 6c 2d 75 70 2d 63 6f 6d 6d 61 6e 64 e2 80 er.around....scroll-up-command..
8b40 99 20 28 77 68 69 63 68 20 73 65 65 29 2e 0a 0a 43 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 ..(which.see)...Command:.transie
8b60 6e 74 2d 73 63 72 6f 6c 6c 2d 64 6f 77 6e 20 61 72 67 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d nt-scroll-down.arg......This.com
8b80 6d 61 6e 64 20 73 63 72 6f 6c 6c 73 20 74 65 78 74 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 e2 80 mand.scrolls.text.of.transient..
8ba0 99 73 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 64 6f 77 6e 20 41 52 47 0a 20 20 20 20 20 6c 69 6e .s.menu.window.down.ARG......lin
8bc0 65 73 2e 20 20 49 66 20 41 52 47 20 69 73 20 e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 65 6e 20 69 es...If.ARG.is....nil...,.then.i
8be0 74 20 73 63 72 6f 6c 6c 73 20 6e 65 61 72 20 66 75 6c 6c 20 73 63 72 65 65 6e 2e 20 20 54 68 69 t.scrolls.near.full.screen...Thi
8c00 73 20 69 73 0a 20 20 20 20 20 61 20 77 72 61 70 70 65 72 20 61 72 6f 75 6e 64 20 e2 80 98 73 63 s.is......a.wrapper.around....sc
8c20 72 6f 6c 6c 2d 64 6f 77 6e 2d 63 6f 6d 6d 61 6e 64 e2 80 99 20 28 77 68 69 63 68 20 73 65 65 29 roll-down-command....(which.see)
8c40 2e 0a 0a 20 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 ......The.following.commands.are
8c60 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 49 66 20 79 .not.available.by.default...If.y
8c80 6f 75 20 77 6f 75 6c 64 0a 6c 69 6b 65 20 74 6f 20 75 73 65 20 74 68 65 6d 20 66 6f 72 20 61 6c ou.would.like.to.use.them.for.al
8ca0 6c 20 6d 65 6e 75 73 2c 20 62 69 6e 64 20 74 68 65 6d 20 69 6e 20 e2 80 98 74 72 61 6e 73 69 65 l.menus,.bind.them.in....transie
8cc0 6e 74 2d 6d 61 70 e2 80 99 2e 0a 0a 43 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 nt-map......Command:.transient-c
8ce0 6f 70 79 2d 6d 65 6e 75 2d 74 65 78 74 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 opy-menu-text......This.command.
8d00 63 6f 70 69 65 73 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 6d 65 6e 75 20 copies.the.contents.of.the.menu.
8d20 62 75 66 66 65 72 20 74 6f 20 74 68 65 20 6b 69 6c 6c 0a 20 20 20 20 20 72 69 6e 67 2e 0a 0a 43 buffer.to.the.kill......ring...C
8d40 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 6f 63 73 74 72 69 ommand:.transient-toggle-docstri
8d60 6e 67 73 0a 20 20 20 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 74 6f 67 67 6c 65 20 62 65 74 ngs......This.command.toggle.bet
8d80 77 65 65 6e 20 73 68 6f 77 69 6e 67 20 73 75 66 66 69 78 20 64 65 73 63 72 69 70 74 69 6f 6e 73 ween.showing.suffix.descriptions
8da0 20 69 6e 20 74 68 65 20 6d 65 6e 75 0a 20 20 20 20 20 28 61 73 20 75 73 75 61 6c 29 20 6f 72 20 .in.the.menu......(as.usual).or.
8dc0 73 68 6f 77 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 73 20 6f 66 20 74 68 65 20 72 showing.the.first.lines.of.the.r
8de0 65 73 70 65 63 74 69 76 65 20 64 6f 63 73 74 72 69 6e 67 73 0a 20 20 20 20 20 69 6e 20 74 68 65 espective.docstrings......in.the
8e00 69 72 20 70 6c 61 63 65 2e 20 20 46 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 20 ir.place...For.commands.that.do.
8e20 6e 6f 74 20 68 61 76 65 20 61 20 64 6f 63 73 74 72 69 6e 67 2c 20 61 6c 77 61 79 73 0a 20 20 20 not.have.a.docstring,.always....
8e40 20 20 64 69 73 70 6c 61 79 20 74 68 65 20 73 75 66 66 69 78 20 64 65 73 63 72 69 70 74 69 6f 6e ..display.the.suffix.description
8e60 2e 20 20 42 65 63 61 75 73 65 20 74 68 65 72 65 20 6c 69 6b 65 6c 79 20 69 73 6e e2 80 99 74 20 ...Because.there.likely.isn...t.
8e80 65 6e 6f 75 67 68 0a 20 20 20 20 20 72 6f 6f 6d 20 74 6f 20 64 69 73 70 6c 61 79 20 6d 75 6c 74 enough......room.to.display.mult
8ea0 69 70 6c 65 20 64 6f 63 73 74 72 69 6e 67 73 20 73 69 64 65 2d 62 79 2d 73 69 64 65 2c 20 61 20 iple.docstrings.side-by-side,.a.
8ec0 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 0a 20 20 20 20 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 single.column......is.used.when.
8ee0 64 69 73 70 6c 61 79 69 6e 67 20 64 6f 63 73 74 72 69 6e 67 73 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 displaying.docstrings.....File:.
8f00 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 43 6f 6e 66 69 67 75 72 61 doci3EOZM.info,..Node:.Configura
8f20 74 69 6f 6e 2c 20 20 50 72 65 76 3a 20 4f 74 68 65 72 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 55 70 tion,..Prev:.Other.Commands,..Up
8f40 3a 20 55 73 61 67 65 0a 0a 32 2e 39 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 3d 3d 3d 3d 3d :.Usage..2.9.Configuration.=====
8f60 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 4d 6f 72 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 64 ============..More.options.are.d
8f80 65 73 63 72 69 62 65 64 20 69 6e 20 2a 6e 6f 74 65 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 escribed.in.*note.Common.Suffix.
8fa0 43 6f 6d 6d 61 6e 64 73 3a 3a 2c 20 69 6e 20 2a 6e 6f 74 65 0a 53 61 76 69 6e 67 20 56 61 6c 75 Commands::,.in.*note.Saving.Valu
8fc0 65 73 3a 3a 2c 20 69 6e 20 2a 6e 6f 74 65 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 3a 3a 20 61 es::,.in.*note.Using.History::.a
8fe0 6e 64 20 69 6e 20 2a 6e 6f 74 65 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 0a 44 69 73 61 62 6c 69 nd.in.*note.Enabling.and.Disabli
9000 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 2e 0a 0a 45 73 73 65 6e 74 69 61 6c 20 4f 70 74 69 6f 6e ng.Suffixes::...Essential.Option
9020 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 77 6f 20 6d 6f 72 65 20 65 73 s.-----------------..Two.more.es
9040 73 65 6e 74 69 61 6c 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 sential.options.are.documented.i
9060 6e 20 2a 6e 6f 74 65 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 0a 43 6f 6d 6d 61 6e 64 73 3a 3a n.*note.Common.Suffix.Commands::
9080 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 ...User.Option:.transient-show-p
90a0 6f 70 75 70 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 opup......This.option.controls.w
90c0 68 65 74 68 65 72 20 61 6e 64 20 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 6d 65 hether.and.when.transient...s.me
90e0 6e 75 20 62 75 66 66 65 72 20 69 73 0a 20 20 20 20 20 73 68 6f 77 6e 2e 0a 0a 20 20 20 20 20 20 nu.buffer.is......shown.........
9100 20 20 e2 80 a2 20 49 66 20 e2 80 98 74 e2 80 99 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 20 ......If....t....(the.default),.
9120 74 68 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 69 73 20 73 68 6f 77 6e 20 61 73 20 73 6f 6f 6e then.the.buffer.is.shown.as.soon
9140 20 61 73 20 61 0a 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 .as.a...........transient.prefix
9160 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2e 0a 0a 20 20 20 20 20 20 20 20 e2 80 .command.is.invoked.............
9180 a2 20 49 66 20 e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 ..If....nil...,.then.the.buffer.
91a0 69 73 20 6e 6f 74 20 73 68 6f 77 6e 20 75 6e 6c 65 73 73 20 74 68 65 20 75 73 65 72 0a 20 20 20 is.not.shown.unless.the.user....
91c0 20 20 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20 72 65 71 75 65 73 74 73 20 69 74 2c 20 62 .......explicitly.requests.it,.b
91e0 79 20 70 72 65 73 73 69 6e 67 20 61 6e 20 69 6e 63 6f 6d 70 6c 65 74 65 20 70 72 65 66 69 78 20 y.pressing.an.incomplete.prefix.
9200 6b 65 79 0a 20 20 20 20 20 20 20 20 20 20 73 65 71 75 65 6e 63 65 2e 0a 0a 20 20 20 20 20 20 20 key...........sequence..........
9220 20 e2 80 a2 20 49 66 20 61 20 6e 75 6d 62 65 72 2c 20 74 68 65 6e 20 74 68 65 20 61 20 62 72 69 .....If.a.number,.then.the.a.bri
9240 65 66 20 6f 6e 65 2d 6c 69 6e 65 20 73 75 6d 6d 61 72 79 20 69 73 20 73 68 6f 77 6e 0a 20 20 20 ef.one-line.summary.is.shown....
9260 20 20 20 20 20 20 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 .......instead.of.the.menu.buffe
9280 72 2e 20 20 49 66 20 7a 65 72 6f 20 6f 72 20 6e 65 67 61 74 69 76 65 2c 20 74 68 65 6e 20 6e 6f r...If.zero.or.negative,.then.no
92a0 74 0a 20 20 20 20 20 20 20 20 20 20 65 76 65 6e 20 74 68 61 74 20 73 75 6d 6d 61 72 79 20 69 73 t...........even.that.summary.is
92c0 20 73 68 6f 77 6e 3b 20 6f 6e 6c 79 20 74 68 65 20 70 72 65 73 73 65 64 20 6b 65 79 20 69 74 73 .shown;.only.the.pressed.key.its
92e0 65 6c 66 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 73 68 6f 77 6e 2e 0a 0a 20 20 20 20 20 20 20 elf.is...........shown..........
9300 20 20 20 54 68 65 20 62 75 66 66 65 72 20 69 73 20 73 68 6f 77 6e 20 6f 6e 63 65 20 74 68 65 20 ...The.buffer.is.shown.once.the.
9320 75 73 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 72 65 71 75 65 73 74 73 20 69 74 20 62 79 0a 20 user.explicitly.requests.it.by..
9340 20 20 20 20 20 20 20 20 20 70 72 65 73 73 69 6e 67 20 61 6e 20 69 6e 63 6f 6d 70 6c 65 74 65 20 .........pressing.an.incomplete.
9360 70 72 65 66 69 78 20 6b 65 79 20 73 65 71 75 65 6e 63 65 2e 20 20 55 6e 6c 65 73 73 20 74 68 69 prefix.key.sequence...Unless.thi
9380 73 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 7a 65 72 6f 2c 20 74 68 65 20 6d 65 6e 75 20 69 73 s.is...........zero,.the.menu.is
93a0 20 73 68 6f 77 6e 20 61 66 74 65 72 20 74 68 61 74 20 6d 61 6e 79 20 73 65 63 6f 6e 64 73 20 6f .shown.after.that.many.seconds.o
93c0 66 20 69 6e 61 63 74 69 76 69 74 79 0a 20 20 20 20 20 20 20 20 20 20 28 75 73 69 6e 67 20 74 68 f.inactivity...........(using.th
93e0 65 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75 65 29 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a e.absolute.value)...User.Option:
9400 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 64 75 72 69 6e 67 2d 6d 69 6e 69 62 75 66 66 65 .transient-show-during-minibuffe
9420 72 2d 72 65 61 64 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 r-read......This.option.controls
9440 20 77 68 65 74 68 65 72 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 63 6f 6e 74 .whether.the.transient.menu.cont
9460 69 6e 75 65 73 20 74 6f 20 62 65 0a 20 20 20 20 20 64 69 73 70 6c 61 79 65 64 20 77 68 69 6c 65 inues.to.be......displayed.while
9480 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 .the.minibuffer.is.used.to.read.
94a0 75 73 65 72 20 69 6e 70 75 74 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 72 user.input........This.is.only.r
94c0 65 6c 65 76 61 6e 74 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 elevant.to.commands.that.do.not.
94e0 63 6c 6f 73 65 20 74 68 65 20 6d 65 6e 75 2c 20 73 75 63 68 0a 20 20 20 20 20 61 73 20 63 6f 6d close.the.menu,.such......as.com
9500 6d 61 6e 64 73 20 74 68 61 74 20 73 65 74 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 20 mands.that.set.infix.arguments..
9520 20 49 66 20 61 20 63 6f 6d 6d 61 6e 64 20 65 78 69 74 73 20 74 68 65 20 6d 65 6e 75 2c 0a 20 20 .If.a.command.exits.the.menu,...
9540 20 20 20 61 6e 64 20 75 73 65 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 74 68 65 6e ...and.uses.the.minibuffer,.then
9560 20 74 68 65 20 6d 65 6e 75 20 69 73 20 61 6c 77 61 79 73 20 63 6c 6f 73 65 64 20 62 65 66 6f 72 .the.menu.is.always.closed.befor
9580 65 20 74 68 65 0a 20 20 20 20 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 65 6e 74 65 72 65 64 e.the......minibuffer.is.entered
95a0 2c 20 69 72 72 65 73 70 65 63 74 69 76 65 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 ,.irrespective.of.the.value.of.t
95c0 68 69 73 20 6f 70 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 e2 80 98 6e 69 6c e2 80 99 his.option........When....nil...
95e0 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 20 68 69 64 65 20 74 68 65 20 6d 65 6e 75 20 77 68 .(the.default),.hide.the.menu.wh
9600 69 6c 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 69 6e 0a 20 20 20 20 20 75 73 ile.the.minibuffer.is.in......us
9620 65 2e 20 20 57 68 65 6e 20 e2 80 98 74 e2 80 99 2c 20 6b 65 65 70 20 73 68 6f 77 69 6e 67 20 74 e...When....t...,.keep.showing.t
9640 68 65 20 6d 65 6e 75 2c 20 62 75 74 20 61 6c 6c 6f 77 20 66 6f 72 20 74 68 65 20 6d 65 6e 75 0a he.menu,.but.allow.for.the.menu.
9660 20 20 20 20 20 77 69 6e 64 6f 77 20 74 6f 20 62 65 20 72 65 73 69 7a 65 64 2c 20 74 6f 20 65 6e .....window.to.be.resized,.to.en
9680 73 75 72 65 20 74 68 61 74 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 sure.that.completion.candidates.
96a0 63 61 6e 20 62 65 0a 20 20 20 20 20 64 69 73 70 6c 61 79 65 64 2e 0a 0a 20 20 20 20 20 57 68 65 can.be......displayed........Whe
96c0 6e 20 e2 80 98 66 69 78 65 64 e2 80 99 2c 20 6b 65 65 70 20 73 68 6f 77 69 6e 67 20 74 68 65 20 n....fixed...,.keep.showing.the.
96e0 6d 65 6e 75 20 61 6e 64 20 70 72 65 76 65 6e 74 20 69 74 20 66 72 6f 6d 20 62 65 69 6e 67 0a 20 menu.and.prevent.it.from.being..
9700 20 20 20 20 72 65 73 69 7a 65 64 2c 20 77 68 69 63 68 20 6d 61 79 20 6d 61 6b 65 20 69 74 20 69 ....resized,.which.may.make.it.i
9720 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 63 6f 6d 70 6c 65 74 mpossible.to.display.the.complet
9740 69 6f 6e 0a 20 20 20 20 20 63 61 6e 64 69 64 61 74 65 73 2e 20 20 49 66 20 74 68 61 74 20 65 76 ion......candidates...If.that.ev
9760 65 72 20 68 61 70 70 65 6e 73 20 66 6f 72 20 79 6f 75 2c 20 63 6f 6e 73 69 64 65 72 20 75 73 69 er.happens.for.you,.consider.usi
9780 6e 67 20 e2 80 98 74 e2 80 99 20 6f 72 20 61 6e 0a 20 20 20 20 20 69 6e 74 65 67 65 72 2c 20 61 ng....t....or.an......integer,.a
97a0 73 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 0a 0a 20 20 20 20 20 49 66 20 74 68 65 20 s.described.below........If.the.
97c0 76 61 6c 75 65 20 69 73 20 e2 80 98 66 69 78 65 64 e2 80 99 20 61 6e 64 20 74 68 65 20 6d 65 6e value.is....fixed....and.the.men
97e0 75 20 77 69 6e 64 6f 77 20 75 73 65 73 20 74 68 65 20 66 75 6c 6c 20 68 65 69 67 68 74 20 6f 66 u.window.uses.the.full.height.of
9800 0a 20 20 20 20 20 69 74 73 20 66 72 61 6d 65 2c 20 74 68 65 6e 20 74 68 65 20 66 6f 72 6d 65 72 ......its.frame,.then.the.former
9820 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 72 65 73 69 7a 69 6e 67 20 69 73 20 61 6c 6c 6f .is.ignored.and.resizing.is.allo
9840 77 65 64 0a 20 20 20 20 20 61 6e 79 77 61 79 2e 20 20 54 68 69 73 20 69 73 20 6e 65 63 65 73 73 wed......anyway...This.is.necess
9860 61 72 79 20 62 65 63 61 75 73 65 20 69 6e 64 69 76 69 64 75 61 6c 20 6d 65 6e 75 73 20 6d 61 79 ary.because.individual.menus.may
9880 20 75 73 65 20 75 6e 75 73 75 61 6c 0a 20 20 20 20 20 64 69 73 70 6c 61 79 20 61 63 74 69 6f 6e .use.unusual......display.action
98a0 73 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 0a 20 20 20 20 20 e2 80 98 74 72 s.different.from.what.........tr
98c0 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e e2 80 99 ansient-display-buffer-action...
98e0 20 73 70 65 63 69 66 69 65 73 20 28 6c 69 6b 65 6c 79 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 .specifies.(likely.to.display.th
9900 61 74 0a 20 20 20 20 20 6d 65 6e 75 20 69 6e 20 61 20 73 69 64 65 2d 77 69 6e 64 6f 77 29 2e 0a at......menu.in.a.side-window)..
9920 0a 20 20 20 20 20 57 68 65 6e 20 75 73 69 6e 67 20 61 20 74 68 69 72 64 2d 70 61 72 74 79 20 6d ......When.using.a.third-party.m
9940 6f 64 65 2c 20 77 68 69 63 68 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 73 69 7a 65 73 ode,.which.automatically.resizes
9960 20 77 69 6e 64 6f 77 73 0a 20 20 20 20 20 28 65 2e 67 2e 2c 20 62 79 20 63 61 6c 6c 69 6e 67 20 .windows......(e.g.,.by.calling.
9980 e2 80 98 62 61 6c 61 6e 63 65 2d 77 69 6e 64 6f 77 73 e2 80 99 20 6f 6e 20 e2 80 98 70 6f 73 74 ...balance-windows....on....post
99a0 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b e2 80 99 29 2c 20 74 68 65 6e 0a 20 20 20 20 20 e2 80 98 -command-hook...),.then.........
99c0 66 69 78 65 64 e2 80 99 20 28 6f 72 20 e2 80 98 6e 69 6c e2 80 99 29 20 69 73 20 6c 69 6b 65 6c fixed....(or....nil...).is.likel
99e0 79 20 61 20 62 65 74 74 65 72 20 63 68 6f 69 63 65 20 74 68 61 6e 20 e2 80 98 74 e2 80 99 2e 0a y.a.better.choice.than....t.....
9a00 0a 20 20 20 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 6e 20 69 ......The.value.can.also.be.an.i
9a20 6e 74 65 67 65 72 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 62 65 68 61 76 69 nteger,.in.which.case.the.behavi
9a40 6f 72 0a 20 20 20 20 20 64 65 70 65 6e 64 73 20 6f 6e 20 77 68 65 74 68 65 72 20 61 74 20 6c 65 or......depends.on.whether.at.le
9a60 61 73 74 20 74 68 61 74 20 6d 61 6e 79 20 6c 69 6e 65 73 20 61 72 65 20 6c 65 66 74 20 74 6f 20 ast.that.many.lines.are.left.to.
9a80 64 69 73 70 6c 61 79 0a 20 20 20 20 20 77 69 6e 64 6f 77 73 20 6f 74 68 65 72 20 74 68 61 6e 20 display......windows.other.than.
9aa0 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f 77 2e 20 20 49 66 20 74 68 61 74 20 69 73 20 74 68 65 the.menu.window...If.that.is.the
9ac0 20 63 61 73 65 2c 20 64 69 73 70 6c 61 79 0a 20 20 20 20 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 .case,.display......the.menu.and
9ae0 20 70 72 65 73 65 72 76 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 61 74 20 77 69 6e 64 6f .preserve.the.size.of.that.windo
9b00 77 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6c 6c 6f 77 0a 20 20 20 20 20 72 65 73 69 7a 69 w...Otherwise,.allow......resizi
9b20 6e 67 20 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 69 66 20 74 68 65 20 6e 75 6d 62 65 72 ng.the.menu.window.if.the.number
9b40 20 69 73 20 70 6f 73 69 74 69 76 65 2c 20 6f 72 20 68 69 64 65 20 74 68 65 0a 20 20 20 20 20 6d .is.positive,.or.hide.the......m
9b60 65 6e 75 20 69 66 20 69 74 20 69 73 20 6e 65 67 61 74 69 76 65 2e 0a 0a 55 73 65 72 20 4f 70 74 enu.if.it.is.negative...User.Opt
9b80 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 77 69 74 68 2d 69 6e 69 74 69 61 6c ion:.transient-read-with-initial
9ba0 2d 69 6e 70 75 74 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 -input......This.option.controls
9bc0 20 77 68 65 74 68 65 72 20 74 68 65 20 6c 61 73 74 20 68 69 73 74 6f 72 79 20 65 6c 65 6d 65 6e .whether.the.last.history.elemen
9be0 74 20 69 73 20 75 73 65 64 20 61 73 0a 20 20 20 20 20 74 68 65 20 69 6e 69 74 69 61 6c 20 6d 69 t.is.used.as......the.initial.mi
9c00 6e 69 62 75 66 66 65 72 20 69 6e 70 75 74 20 77 68 65 6e 20 72 65 61 64 69 6e 67 20 74 68 65 20 nibuffer.input.when.reading.the.
9c20 76 61 6c 75 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 0a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 20 value.of.an.infix......argument.
9c40 66 72 6f 6d 20 74 68 65 20 75 73 65 72 2e 20 20 49 66 20 e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 from.the.user...If....nil...,.th
9c60 65 72 65 20 69 73 20 6e 6f 20 69 6e 69 74 69 61 6c 20 69 6e 70 75 74 20 61 6e 64 0a 20 20 20 20 ere.is.no.initial.input.and.....
9c80 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 68 61 73 20 74 6f 20 62 65 20 61 63 63 .the.first.element.has.to.be.acc
9ca0 65 73 73 65 64 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 6f 6c 64 65 72 0a essed.the.same.way.as.the.older.
9cc0 20 20 20 20 20 65 6c 65 6d 65 6e 74 73 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 .....elements...User.Option:.tra
9ce0 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 0a 20 nsient-enable-popup-navigation..
9d00 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 ....This.option.controls.whether
9d20 20 6e 61 76 69 67 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 6e 61 62 6c 65 64 .navigation.commands.are.enabled
9d40 20 69 6e 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 6d 65 6e 75 20 62 75 66 66 .in......transient...s.menu.buff
9d60 65 72 2e 20 20 49 66 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 e2 80 98 76 65 72 62 6f 73 65 e2 er...If.the.value.is....verbose.
9d80 80 99 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 0a 20 20 20 20 20 62 72 69 65 66 20 64 6f 63 ...(the.default),......brief.doc
9da0 75 6d 65 6e 74 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 75 6e 64 umentation.about.the.command.und
9dc0 65 72 20 70 6f 69 6e 74 20 69 73 20 61 64 64 69 74 69 6f 6e 61 6c 6c 79 0a 20 20 20 20 20 73 68 er.point.is.additionally......sh
9de0 6f 77 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2e 0a 0a 20 20 20 20 20 57 68 69 6c 65 ow.in.the.echo.area........While
9e00 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 20 74 68 65 20 6d 65 6e 75 20 .a.transient.is.active.the.menu.
9e20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 20 20 20 62 buffer.is.not.the.current......b
9e40 75 66 66 65 72 2c 20 6d 61 6b 69 6e 67 20 69 74 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 75 73 uffer,.making.it.necessary.to.us
9e60 65 20 64 65 64 69 63 61 74 65 64 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 61 63 74 20 6f 6e 0a 20 e.dedicated.commands.to.act.on..
9e80 20 20 20 20 74 68 61 74 20 62 75 66 66 65 72 20 69 74 73 65 6c 66 2e 20 20 49 66 20 74 68 69 73 ....that.buffer.itself...If.this
9ea0 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 65 6e 20 74 .option.is.non-...nil...,.then.t
9ec0 68 65 0a 20 20 20 20 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 65 61 74 75 72 65 73 20 61 72 65 20 61 he......following.features.are.a
9ee0 76 61 69 6c 61 62 6c 65 3a 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 3c 55 50 3e e2 80 vailable:.................<UP>..
9f00 99 20 6d 6f 76 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f ..moves.the.cursor.to.the.previo
9f20 75 73 20 73 75 66 66 69 78 2e 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 3c 44 4f 57 4e 3e us.suffix.................<DOWN>
9f40 e2 80 99 20 6d 6f 76 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6e 65 78 74 ....moves.the.cursor.to.the.next
9f60 20 73 75 66 66 69 78 2e 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 4d 2d 3c 52 45 54 3e e2 .suffix.................M-<RET>.
9f80 80 99 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 73 75 66 66 69 78 20 74 68 65 20 63 75 72 73 6f 72 ...invokes.the.suffix.the.cursor
9fa0 20 69 73 20 6f 6e 2e 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 6d 6f 75 73 65 2d 31 e2 80 .is.on.................mouse-1..
9fc0 99 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 63 6c 69 63 6b 65 64 20 6f 6e 20 73 75 66 66 69 78 2e ..invokes.the.clicked.on.suffix.
9fe0 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 43 2d 73 e2 80 99 20 61 6e 64 20 e2 80 98 43 2d ................C-s....and....C-
a000 72 e2 80 99 20 73 74 61 72 74 20 69 73 65 61 72 63 68 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 r....start.isearch.in.the.menu.b
a020 75 66 66 65 72 2e 0a 0a 20 20 20 20 20 42 79 20 64 65 66 61 75 6c 74 20 e2 80 98 4d 2d 3c 52 45 uffer........By.default....M-<RE
a040 54 3e e2 80 99 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 T>....is.bound.to....transient-p
a060 75 73 68 2d 62 75 74 74 6f 6e e2 80 99 2c 20 69 6e 73 74 65 61 64 0a 20 20 20 20 20 6f 66 20 e2 ush-button...,.instead......of..
a080 80 98 3c 52 45 54 3e e2 80 99 2c 20 62 65 63 61 75 73 65 20 69 66 20 61 20 74 72 61 6e 73 69 65 ..<RET>...,.because.if.a.transie
a0a0 6e 74 20 61 6c 6c 6f 77 73 20 74 68 65 20 69 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 0a 20 20 20 20 nt.allows.the.invocation.of.....
a0c0 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 2c 20 74 68 65 6e 20 69 74 20 69 73 20 6c 69 6b 65 6c 79 .non-suffixes,.then.it.is.likely
a0e0 2c 20 74 68 61 74 20 79 6f 75 20 77 6f 75 6c 64 20 77 61 6e 74 20 e2 80 98 3c 52 45 54 3e e2 80 ,.that.you.would.want....<RET>..
a100 99 20 74 6f 20 64 6f 0a 20 20 20 20 20 77 68 61 74 20 69 74 20 77 6f 75 6c 64 20 64 6f 20 69 66 ..to.do......what.it.would.do.if
a120 20 6e 6f 20 74 72 61 6e 73 69 65 6e 74 20 77 65 72 65 20 61 63 74 69 76 65 2e 22 0a 0a 55 73 65 .no.transient.were.active."..Use
a140 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 r.Option:.transient-display-buff
a160 65 72 2d 61 63 74 69 6f 6e 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 70 65 63 69 er-action......This.option.speci
a180 66 69 65 73 20 74 68 65 20 61 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 fies.the.action.used.to.display.
a1a0 74 68 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 0a 20 20 20 20 20 6d 65 6e 75 20 62 75 66 66 the.transient...s......menu.buff
a1c0 65 72 2e 20 20 54 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 64 69 73 70 6c 61 79 65 er...The.menu.buffer.is.displaye
a1e0 64 20 69 6e 20 61 20 77 69 6e 64 6f 77 20 75 73 69 6e 67 0a 20 20 20 20 20 e2 80 98 28 64 69 73 d.in.a.window.using.........(dis
a200 70 6c 61 79 2d 62 75 66 66 65 72 20 42 55 46 46 45 52 20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 play-buffer.BUFFER.transient-dis
a220 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 29 e2 80 99 2e 0a 0a 20 20 20 20 20 54 68 play-buffer-action)...........Th
a240 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 68 61 73 20 74 68 65 20 66 e.value.of.this.option.has.the.f
a260 6f 72 6d 20 e2 80 98 28 46 55 4e 43 54 49 4f 4e 20 2e 20 41 4c 49 53 54 29 e2 80 99 2c 20 77 68 orm....(FUNCTION...ALIST)...,.wh
a280 65 72 65 0a 20 20 20 20 20 46 55 4e 43 54 49 4f 4e 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 ere......FUNCTION.is.a.function.
a2a0 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 45 61 63 68 20 73 75 or.a.list.of.functions...Each.su
a2c0 63 68 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 73 68 6f 75 6c 64 20 61 63 63 65 70 74 20 74 ch.function......should.accept.t
a2e0 77 6f 20 61 72 67 75 6d 65 6e 74 73 3a 20 61 20 62 75 66 66 65 72 20 74 6f 20 64 69 73 70 6c 61 wo.arguments:.a.buffer.to.displa
a300 79 20 61 6e 64 20 61 6e 20 61 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 74 68 65 20 73 61 6d 65 20 y.and.an.alist.of......the.same.
a320 66 6f 72 6d 20 61 73 20 41 4c 49 53 54 2e 20 20 53 65 65 20 2a 6e 6f 74 65 20 28 65 6c 69 73 70 form.as.ALIST...See.*note.(elisp
a340 29 43 68 6f 6f 73 69 6e 67 20 57 69 6e 64 6f 77 3a 3a 2c 20 66 6f 72 0a 20 20 20 20 20 64 65 74 )Choosing.Window::,.for......det
a360 61 69 6c 73 2e 0a 0a 20 20 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 3a 0a 0a 20 20 20 ails........The.default.is:.....
a380 20 20 20 20 20 20 20 28 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 69 6e 2d 73 69 64 65 2d 77 .......(display-buffer-in-side-w
a3a0 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 69 64 65 20 2e 20 62 6f 74 74 6f 6d 29 indow............(side...bottom)
a3c0 0a 20 20 20 20 20 20 20 20 20 20 20 28 64 65 64 69 63 61 74 65 64 20 2e 20 74 29 0a 20 20 20 20 ............(dedicated...t).....
a3e0 20 20 20 20 20 20 20 28 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 20 2e 20 74 29 .......(inhibit-same-window...t)
a400 29 0a 0a 20 20 20 20 20 54 68 69 73 20 64 69 73 70 6c 61 79 73 20 74 68 65 20 77 69 6e 64 6f 77 ).......This.displays.the.window
a420 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 20 74 68 65 20 73 65 6c 65 63 74 65 64 20 66 .at.the.bottom.of.the.selected.f
a440 72 61 6d 65 2e 20 20 46 6f 72 0a 20 20 20 20 20 61 6c 74 65 72 6e 61 74 69 76 65 73 20 73 65 65 rame...For......alternatives.see
a460 20 2a 6e 6f 74 65 20 28 65 6c 69 73 70 29 42 75 66 66 65 72 20 44 69 73 70 6c 61 79 20 41 63 74 .*note.(elisp)Buffer.Display.Act
a480 69 6f 6e 20 46 75 6e 63 74 69 6f 6e 73 3a 3a 2c 0a 20 20 20 20 20 61 6e 64 20 2a 6e 6f 74 65 20 ion.Functions::,......and.*note.
a4a0 28 65 6c 69 73 70 29 42 75 66 66 65 72 20 44 69 73 70 6c 61 79 20 41 63 74 69 6f 6e 20 41 6c 69 (elisp)Buffer.Display.Action.Ali
a4c0 73 74 73 3a 3a 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 79 6f 75 20 73 77 69 74 63 68 20 74 6f 20 sts::........When.you.switch.to.
a4e0 61 20 64 69 66 66 65 72 65 6e 74 20 41 43 54 49 4f 4e 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20 6b a.different.ACTION,.you.should.k
a500 65 65 70 20 74 68 65 20 41 4c 49 53 54 0a 20 20 20 20 20 65 6e 74 72 69 65 73 20 66 6f 72 20 e2 eep.the.ALIST......entries.for..
a520 80 98 64 65 64 69 63 61 74 65 64 e2 80 99 20 61 6e 64 20 e2 80 98 69 6e 68 69 62 69 74 2d 73 61 ..dedicated....and....inhibit-sa
a540 6d 65 2d 77 69 6e 64 6f 77 e2 80 99 20 69 6e 20 6d 6f 73 74 20 63 61 73 65 73 2e 0a 20 20 20 20 me-window....in.most.cases......
a560 20 44 6f 20 6e 6f 74 20 64 72 6f 70 20 74 68 65 6d 20 62 65 63 61 75 73 65 20 79 6f 75 20 61 72 .Do.not.drop.them.because.you.ar
a580 65 20 75 6e 73 75 72 65 20 77 68 65 74 68 65 72 20 74 68 65 79 20 61 72 65 20 6e 65 65 64 65 64 e.unsure.whether.they.are.needed
a5a0 3b 20 69 66 0a 20 20 20 20 20 79 6f 75 20 61 72 65 20 75 6e 73 75 72 65 2c 20 74 68 65 6e 20 6b ;.if......you.are.unsure,.then.k
a5c0 65 65 70 20 74 68 65 6d 2e 0a 0a 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 62 75 eep.them........Note.that.the.bu
a5e0 66 66 65 72 20 74 68 61 74 20 77 61 73 20 63 75 72 72 65 6e 74 20 62 65 66 6f 72 65 20 74 68 65 ffer.that.was.current.before.the
a600 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 0a 20 20 20 20 20 69 73 20 73 68 6f 77 6e 20 .transient.buffer......is.shown.
a620 73 68 6f 75 6c 64 20 72 65 6d 61 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 should.remain.the.current.buffer
a640 2e 20 20 4d 61 6e 79 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 20 61 63 74 ...Many.suffix.commands......act
a660 20 6f 6e 20 74 68 65 20 74 68 69 6e 67 20 61 74 20 70 6f 69 6e 74 2c 20 69 66 20 61 70 70 72 6f .on.the.thing.at.point,.if.appro
a680 70 72 69 61 74 65 2c 20 61 6e 64 20 69 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 20 priate,.and.if.the.transient....
a6a0 20 20 62 75 66 66 65 72 20 62 65 63 61 6d 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 ..buffer.became.the.current.buff
a6c0 65 72 2c 20 74 68 65 6e 20 74 68 61 74 20 77 6f 75 6c 64 20 63 68 61 6e 67 65 20 77 68 61 74 20 er,.then.that.would.change.what.
a6e0 69 73 20 61 74 0a 20 20 20 20 20 70 6f 69 6e 74 2e 20 20 54 6f 20 74 68 61 74 20 65 66 66 65 63 is.at......point...To.that.effec
a700 74 20 e2 80 98 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 e2 80 99 20 65 6e 73 75 t....inhibit-same-window....ensu
a720 72 65 73 20 74 68 61 74 20 74 68 65 0a 20 20 20 20 20 73 65 6c 65 63 74 65 64 20 77 69 6e 64 6f res.that.the......selected.windo
a740 77 20 69 73 20 6e 6f 74 20 75 73 65 64 20 74 6f 20 73 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 w.is.not.used.to.show.the.transi
a760 65 6e 74 20 62 75 66 66 65 72 2e 0a 0a 20 20 20 20 20 49 74 20 6d 61 79 20 62 65 20 70 6f 73 73 ent.buffer........It.may.be.poss
a780 69 62 6c 65 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 77 69 6e 64 6f 77 20 69 6e 20 61 6e ible.to.display.the.window.in.an
a7a0 6f 74 68 65 72 20 66 72 61 6d 65 2c 20 62 75 74 0a 20 20 20 20 20 77 68 65 74 68 65 72 20 74 68 other.frame,.but......whether.th
a7c0 61 74 20 77 6f 72 6b 73 20 69 6e 20 70 72 61 63 74 69 63 65 20 64 65 70 65 6e 64 73 20 6f 6e 20 at.works.in.practice.depends.on.
a7e0 74 68 65 20 77 69 6e 64 6f 77 2d 6d 61 6e 61 67 65 72 2e 20 20 49 66 0a 20 20 20 20 20 74 68 65 the.window-manager...If......the
a800 20 77 69 6e 64 6f 77 20 6d 61 6e 61 67 65 72 20 73 65 6c 65 63 74 73 20 74 68 65 20 6e 65 77 20 .window.manager.selects.the.new.
a820 77 69 6e 64 6f 77 20 28 45 6d 61 63 73 20 66 72 61 6d 65 29 2c 20 74 68 65 6e 20 74 68 61 74 0a window.(Emacs.frame),.then.that.
a840 20 20 20 20 20 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 63 68 61 6e 67 65 73 20 77 68 69 63 68 .....unfortunately.changes.which
a860 20 62 75 66 66 65 72 20 69 73 20 63 75 72 72 65 6e 74 2e 0a 0a 20 20 20 20 20 49 66 20 79 6f 75 .buffer.is.current........If.you
a880 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 74 69 6f 6e .change.the.value.of.this.option
a8a0 2c 20 74 68 65 6e 20 79 6f 75 20 6d 69 67 68 74 20 61 6c 73 6f 20 77 61 6e 74 20 74 6f 0a 20 20 ,.then.you.might.also.want.to...
a8c0 20 20 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 ...change.the.value.of....transi
a8e0 65 6e 74 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 e2 80 99 2e 0a 0a 20 20 20 20 20 54 ent-mode-line-format...........T
a900 68 69 73 20 75 73 65 72 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 64 65 his.user.option.may.be.overridde
a920 6e 20 69 66 20 e2 80 98 3a 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e e2 80 99 20 69 73 20 70 61 n.if....:display-action....is.pa
a940 73 73 65 64 0a 20 20 20 20 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 70 72 ssed......when.creating.a.new.pr
a960 65 66 69 78 20 77 69 74 68 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 efix.with....transient-define-pr
a980 65 66 69 78 e2 80 99 2e 0a 0a 41 63 63 65 73 73 69 62 69 6c 69 74 79 20 4f 70 74 69 6f 6e 73 0a efix......Accessibility.Options.
a9a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 55 73 65 72 20 4f 70 74 69 ---------------------..User.Opti
a9c0 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 73 69 6e 67 6c 65 2d 63 6f 6c 75 6d on:.transient-force-single-colum
a9e0 6e 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 n......This.option.controls.whet
aa00 68 65 72 20 74 68 65 20 75 73 65 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 20 74 her.the.use.of.a.single.column.t
aa20 6f 20 64 69 73 70 6c 61 79 0a 20 20 20 20 20 73 75 66 66 69 78 65 73 20 69 73 20 65 6e 66 6f 72 o.display......suffixes.is.enfor
aa40 63 65 64 2e 20 20 54 68 69 73 20 6d 69 67 68 74 20 62 65 20 75 73 65 66 75 6c 20 66 6f 72 20 75 ced...This.might.be.useful.for.u
aa60 73 65 72 73 20 77 69 74 68 20 6c 6f 77 0a 20 20 20 20 20 76 69 73 69 6f 6e 20 77 68 6f 20 75 73 sers.with.low......vision.who.us
aa80 65 20 6c 61 72 67 65 20 74 65 78 74 20 61 6e 64 20 6d 69 67 68 74 20 6f 74 68 65 72 77 69 73 65 e.large.text.and.might.otherwise
aaa0 20 68 61 76 65 20 74 6f 20 73 63 72 6f 6c 6c 20 69 6e 20 74 77 6f 0a 20 20 20 20 20 64 69 6d 65 .have.to.scroll.in.two......dime
aac0 6e 73 69 6f 6e 73 2e 0a 0a 41 75 78 69 6c 69 61 72 79 20 4f 70 74 69 6f 6e 73 0a 2d 2d 2d 2d 2d nsions...Auxiliary.Options.-----
aae0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 ------------..User.Option:.trans
ab00 69 65 6e 74 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 0a 20 20 20 20 20 54 68 69 73 20 ient-mode-line-format......This.
ab20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 72 61 6e 73 69 65 6e option.controls.whether.transien
ab40 74 e2 80 99 73 20 6d 65 6e 75 20 62 75 66 66 65 72 20 68 61 73 20 61 0a 20 20 20 20 20 6d 6f 64 t...s.menu.buffer.has.a......mod
ab60 65 2d 6c 69 6e 65 2c 20 73 65 70 61 72 61 74 6f 72 20 6c 69 6e 65 2c 20 6f 72 20 6e 65 69 74 68 e-line,.separator.line,.or.neith
ab80 65 72 2e 0a 0a 20 20 20 20 20 49 66 20 e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 65 6e 20 74 68 65 er........If....nil...,.then.the
aba0 20 62 75 66 66 65 72 20 68 61 73 20 6e 6f 20 6d 6f 64 65 2d 6c 69 6e 65 2e 20 20 49 66 20 74 68 .buffer.has.no.mode-line...If.th
abc0 65 20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 0a 20 20 20 20 20 64 69 73 70 6c 61 79 65 64 20 72 e.buffer.is.not......displayed.r
abe0 69 67 68 74 20 61 62 6f 76 65 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2c 20 74 68 65 6e 20 74 ight.above.the.echo.area,.then.t
ac00 68 69 73 20 70 72 6f 62 61 62 6c 79 20 69 73 20 6e 6f 74 20 61 0a 20 20 20 20 20 67 6f 6f 64 20 his.probably.is.not.a......good.
ac20 76 61 6c 75 65 2e 0a 0a 20 20 20 20 20 49 66 20 e2 80 98 6c 69 6e 65 e2 80 99 20 28 74 68 65 20 value........If....line....(the.
ac40 64 65 66 61 75 6c 74 29 20 6f 72 20 61 20 6e 61 74 75 72 61 6c 20 6e 75 6d 62 65 72 2c 20 74 68 default).or.a.natural.number,.th
ac60 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 68 61 73 20 6e 6f 0a 20 20 20 20 20 6d 6f 64 65 2d 6c en.the.buffer.has.no......mode-l
ac80 69 6e 65 2c 20 62 75 74 20 61 20 6c 69 6e 65 20 69 73 20 64 72 61 77 6e 20 69 6e 20 69 74 73 20 ine,.but.a.line.is.drawn.in.its.
aca0 70 6c 61 63 65 2e 20 20 49 66 20 61 20 6e 75 6d 62 65 72 20 69 73 20 75 73 65 64 2c 0a 20 20 20 place...If.a.number.is.used,....
acc0 20 20 74 68 61 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 74 68 69 63 6b 6e 65 73 73 20 6f ..that.specifies.the.thickness.o
ace0 66 20 74 68 65 20 6c 69 6e 65 2e 20 20 4f 6e 20 74 65 72 6d 63 61 70 20 66 72 61 6d 65 73 20 77 f.the.line...On.termcap.frames.w
ad00 65 0a 20 20 20 20 20 63 61 6e 6e 6f 74 20 64 72 61 77 20 6c 69 6e 65 73 2c 20 73 6f 20 74 68 65 e......cannot.draw.lines,.so.the
ad20 72 65 20 e2 80 98 6c 69 6e 65 e2 80 99 20 61 6e 64 20 6e 75 6d 62 65 72 73 20 61 72 65 20 73 79 re....line....and.numbers.are.sy
ad40 6e 6f 6e 79 6d 73 20 66 6f 72 0a 20 20 20 20 20 e2 80 98 6e 69 6c e2 80 99 2e 0a 0a 20 20 20 20 nonyms.for.........nil..........
ad60 20 54 68 65 20 63 6f 6c 6f 72 20 6f 66 20 74 68 65 20 6c 69 6e 65 20 69 73 20 75 73 65 64 20 74 .The.color.of.the.line.is.used.t
ad80 6f 20 69 6e 64 69 63 61 74 65 20 69 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 61 72 65 0a 20 o.indicate.if.non-suffixes.are..
ada0 20 20 20 20 61 6c 6c 6f 77 65 64 20 61 6e 64 20 77 68 65 74 68 65 72 20 74 68 65 79 20 65 78 69 ....allowed.and.whether.they.exi
adc0 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 54 68 65 20 66 6f 72 65 67 72 6f 75 6e 64 t.the.transient...The.foreground
ade0 20 63 6f 6c 6f 72 0a 20 20 20 20 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d .color......of....transient-key-
ae00 6e 6f 6f 70 e2 80 99 20 28 69 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 61 72 65 20 64 69 73 noop....(if.non-suffixes.are.dis
ae20 61 6c 6c 6f 77 65 64 29 2c 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d allowed),.........transient-key-
ae40 73 74 61 79 e2 80 99 20 28 69 66 20 61 6c 6c 6f 77 65 64 20 61 6e 64 20 74 72 61 6e 73 69 65 6e stay....(if.allowed.and.transien
ae60 74 20 73 74 61 79 73 20 61 63 74 69 76 65 29 2c 20 6f 72 0a 20 20 20 20 20 e2 80 98 74 72 61 6e t.stays.active),.or.........tran
ae80 73 69 65 6e 74 2d 6b 65 79 2d 65 78 69 74 e2 80 99 20 28 69 66 20 61 6c 6c 6f 77 65 64 20 61 6e sient-key-exit....(if.allowed.an
aea0 64 20 74 68 65 79 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 29 20 69 73 0a 20 20 d.they.exit.the.transient).is...
aec0 20 20 20 75 73 65 64 20 74 6f 20 64 72 61 77 20 74 68 65 20 6c 69 6e 65 2e 0a 0a 20 20 20 20 20 ...used.to.draw.the.line........
aee0 54 68 69 73 20 75 73 65 72 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 64 This.user.option.may.be.overridd
af00 65 6e 20 69 66 20 e2 80 98 3a 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 e2 80 99 20 69 73 en.if....:mode-line-format....is
af20 20 70 61 73 73 65 64 0a 20 20 20 20 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 .passed......when.creating.a.new
af40 20 70 72 65 66 69 78 20 77 69 74 68 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 .prefix.with....transient-define
af60 2d 70 72 65 66 69 78 e2 80 99 2e 0a 0a 20 20 20 20 20 4f 74 68 65 72 77 69 73 65 20 74 68 69 73 -prefix...........Otherwise.this
af80 20 63 61 6e 20 62 65 20 61 6e 79 20 6d 6f 64 65 2d 6c 69 6e 65 20 66 6f 72 6d 61 74 2e 20 20 53 .can.be.any.mode-line.format...S
afa0 65 65 20 2a 6e 6f 74 65 20 28 65 6c 69 73 70 29 4d 6f 64 65 0a 20 20 20 20 20 4c 69 6e 65 20 46 ee.*note.(elisp)Mode......Line.F
afc0 6f 72 6d 61 74 3a 3a 2c 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 0a 55 73 65 72 20 4f 70 74 69 ormat::,.for.details...User.Opti
afe0 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 6d 61 6e 74 69 63 2d 63 6f 6c 6f 72 69 6e 67 0a on:.transient-semantic-coloring.
b000 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 .....This.option.controls.whethe
b020 72 20 63 6f 6c 6f 72 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 r.colors.are.used.to.indicate.th
b040 65 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 20 6f 66 20 63 6f 6d e......transient.behavior.of.com
b060 6d 61 6e 64 73 2e 0a 0a 20 20 20 20 20 49 66 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 20 74 mands........If.non-...nil...,.t
b080 68 65 6e 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 6f 66 20 65 61 63 68 20 73 75 66 66 hen.the.key.binding.of.each.suff
b0a0 69 78 20 69 73 20 63 6f 6c 6f 72 69 7a 65 64 20 74 6f 0a 20 20 20 20 20 69 6e 64 69 63 61 74 65 ix.is.colorized.to......indicate
b0c0 20 77 68 65 74 68 65 72 20 69 74 20 65 78 69 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 .whether.it.exits.the.transient.
b0e0 73 74 61 74 65 20 6f 72 20 6e 6f 74 2e 20 20 54 68 65 20 63 6f 6c 6f 72 20 6f 66 0a 20 20 20 20 state.or.not...The.color.of.....
b100 20 74 68 65 20 70 72 65 66 69 78 20 69 73 20 69 6e 64 69 63 61 74 65 64 20 75 73 69 6e 67 20 74 .the.prefix.is.indicated.using.t
b120 68 65 20 6c 69 6e 65 20 74 68 61 74 20 69 73 20 64 72 61 77 6e 20 77 68 65 6e 20 74 68 65 20 76 he.line.that.is.drawn.when.the.v
b140 61 6c 75 65 0a 20 20 20 20 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6d 6f 64 65 2d 6c alue......of....transient-mode-l
b160 69 6e 65 2d 66 6f 72 6d 61 74 e2 80 99 20 69 73 20 e2 80 98 6c 69 6e 65 e2 80 99 2e 0a 0a 55 73 ine-format....is....line......Us
b180 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 6d er.Option:.transient-highlight-m
b1a0 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 73 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 ismatched-keys......This.option.
b1c0 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 6f 66 controls.whether.key.bindings.of
b1e0 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 0a 20 20 20 20 20 6e 6f 74 .infix.commands.that.do......not
b200 20 6d 61 74 63 68 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 .match.the.respective.command-li
b220 6e 65 20 61 72 67 75 6d 65 6e 74 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20 20 68 69 67 68 6c ne.argument.should.be......highl
b240 69 67 68 74 65 64 2e 20 20 46 6f 72 20 6f 74 68 65 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 ighted...For.other.infix.command
b260 73 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 68 61 73 20 6e 6f 20 65 66 66 65 63 74 2e 0a 0a 20 20 s.this.option.has.no.effect.....
b280 20 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 ...When.this.option.is.non-...ni
b2a0 6c e2 80 99 2c 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 61 6e 20 69 6e 66 l...,.the.key.binding.for.an.inf
b2c0 69 78 0a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 20 69 73 20 68 69 67 68 6c 69 67 68 74 65 64 20 ix......argument.is.highlighted.
b2e0 77 68 65 6e 20 6f 6e 6c 79 20 61 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 20 28 65 2e 67 2e 2c when.only.a.long.argument.(e.g.,
b300 0a 20 20 20 20 20 e2 80 98 2d 2d 76 65 72 62 6f 73 65 e2 80 99 29 20 69 73 20 73 70 65 63 69 66 .........--verbose...).is.specif
b320 69 65 64 20 62 75 74 20 6e 6f 20 73 68 6f 72 74 68 61 6e 64 20 28 65 2e 67 2e 2c 20 e2 80 98 2d ied.but.no.shorthand.(e.g.,....-
b340 76 e2 80 99 29 2e 20 20 49 6e 20 74 68 65 0a 20 20 20 20 20 72 61 72 65 20 63 61 73 65 20 74 68 v...)...In.the......rare.case.th
b360 61 74 20 61 20 73 68 6f 72 74 68 61 6e 64 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62 75 74 20 at.a.shorthand.is.specified.but.
b380 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 64 6f 65 73 0a 20 20 20 20 20 6e 6f 74 20 6d 61 the.key.binding.does......not.ma
b3a0 74 63 68 2c 20 74 68 65 6e 20 69 74 20 69 73 20 68 69 67 68 6c 69 67 68 74 65 64 20 64 69 66 66 tch,.then.it.is.highlighted.diff
b3c0 65 72 65 6e 74 6c 79 2e 0a 0a 20 20 20 20 20 48 69 67 68 6c 69 67 68 74 69 6e 67 20 6d 69 73 6d erently........Highlighting.mism
b3e0 61 74 63 68 65 64 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 atched.key.bindings.is.useful.wh
b400 65 6e 20 6c 65 61 72 6e 69 6e 67 20 74 68 65 0a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 73 20 6f en.learning.the......arguments.o
b420 66 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 74 6f f.the.underlying.command-line.to
b440 6f 6c 3b 20 79 6f 75 20 77 6f 75 6c 64 6e e2 80 99 74 20 77 61 6e 74 20 74 6f 0a 20 20 20 20 20 ol;.you.wouldn...t.want.to......
b460 6c 65 61 72 6e 20 61 6e 79 20 73 68 6f 72 74 2d 68 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f learn.any.short-hands.that.do.no
b480 74 20 61 63 74 75 61 6c 6c 79 20 65 78 69 73 74 2e 0a 0a 20 20 20 20 20 54 68 65 20 68 69 67 68 t.actually.exist........The.high
b4a0 6c 69 67 68 74 69 6e 67 20 69 73 20 64 6f 6e 65 20 75 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 lighting.is.done.using.one.of.th
b4c0 65 20 66 61 63 65 73 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6d 69 73 6d 61 74 e.faces.........transient-mismat
b4e0 63 68 65 64 2d 6b 65 79 e2 80 99 20 61 6e 64 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e ched-key....and....transient-non
b500 73 74 61 6e 64 61 72 64 2d 6b 65 79 e2 80 99 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 standard-key......User.Option:.t
b520 72 61 6e 73 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e ransient-substitute-key-function
b540 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6d ......This.function.is.used.to.m
b560 6f 64 69 66 79 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 20 20 49 66 20 74 68 65 20 76 61 6c 75 odify.key.bindings...If.the.valu
b580 65 20 6f 66 20 74 68 69 73 0a 20 20 20 20 20 6f 70 74 69 6f 6e 20 69 73 20 e2 80 98 6e 69 6c e2 e.of.this......option.is....nil.
b5a0 80 99 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 20 74 68 65 6e 20 6e 6f 20 73 75 62 73 74 69 ...(the.default),.then.no.substi
b5c0 74 75 74 69 6f 6e 20 69 73 20 70 65 72 66 6f 72 6d 65 64 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 tution.is.performed........This.
b5e0 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 6f 6e 65 20 61 72 67 75 function.is.called.with.one.argu
b600 6d 65 6e 74 2c 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 2c 20 61 6e 64 0a 20 20 20 ment,.the.prefix.object,.and....
b620 20 20 6d 75 73 74 20 72 65 74 75 72 6e 20 61 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 64 65 73 63 ..must.return.a.key.binding.desc
b640 72 69 70 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 74 68 65 20 65 78 69 73 74 69 6e 67 20 6b 65 79 ription,.either.the.existing.key
b660 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 69 6f 6e 20 69 74 20 66 69 6e 64 73 20 69 6e 20 74 68 ......description.it.finds.in.th
b680 65 20 e2 80 98 6b 65 79 e2 80 99 20 73 6c 6f 74 2c 20 6f 72 20 74 68 65 20 6b 65 79 20 64 65 73 e....key....slot,.or.the.key.des
b6a0 63 72 69 70 74 69 6f 6e 20 74 68 61 74 0a 20 20 20 20 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 cription.that......replaces.the.
b6c0 70 72 65 66 69 78 20 6b 65 79 2e 20 20 49 74 20 63 6f 75 6c 64 20 62 65 20 75 73 65 64 20 74 6f prefix.key...It.could.be.used.to
b6e0 20 6d 61 6b 65 20 6f 74 68 65 72 0a 20 20 20 20 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73 2c 20 .make.other......substitutions,.
b700 62 75 74 20 74 68 61 74 20 69 73 20 64 69 73 63 6f 75 72 61 67 65 64 2e 0a 0a 20 20 20 20 20 46 but.that.is.discouraged........F
b720 6f 72 20 65 78 61 6d 70 6c 65 2c 20 e2 80 98 3d e2 80 99 20 69 73 20 68 61 72 64 20 74 6f 20 72 or.example,....=....is.hard.to.r
b740 65 61 63 68 20 75 73 69 6e 67 20 6d 79 20 63 75 73 74 6f 6d 20 6b 65 79 62 6f 61 72 64 20 6c 61 each.using.my.custom.keyboard.la
b760 79 6f 75 74 2c 0a 20 20 20 20 20 73 6f 20 49 20 73 75 62 73 74 69 74 75 74 65 20 e2 80 98 28 e2 yout,......so.I.substitute....(.
b780 80 99 20 66 6f 72 20 74 68 61 74 2c 20 77 68 69 63 68 20 69 73 20 65 61 73 79 20 74 6f 20 72 65 ...for.that,.which.is.easy.to.re
b7a0 61 63 68 20 75 73 69 6e 67 20 61 20 6c 61 79 6f 75 74 0a 20 20 20 20 20 6f 70 74 69 6d 69 7a 65 ach.using.a.layout......optimize
b7c0 64 20 66 6f 72 20 6c 69 73 70 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 d.for.lisp.............(setq.tra
b7e0 6e 73 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 0a 20 nsient-substitute-key-function..
b800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 6f 62 6a 29 0a 20 20 20 ...............(lambda.(obj)....
b820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 6f 72 65 66 20 ...............(let.((key.(oref.
b840 6f 62 6a 20 6b 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 obj.key))).....................(
b860 69 66 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 5c 5c 60 5c 5c 28 3d 5c 5c 29 5b 61 2d 7a if.(string-match."\\`\\(=\\)[a-z
b880 41 2d 5a 5d 22 20 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 A-Z]".key)......................
b8a0 20 20 20 28 72 65 70 6c 61 63 65 2d 6d 61 74 63 68 20 22 28 22 20 74 20 74 20 6b 65 79 20 31 29 ...(replace-match."(".t.t.key.1)
b8c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6b 65 79 29 29 29 29 0a 0a .......................key))))..
b8e0 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d 76 61 72 User.Option:.transient-align-var
b900 69 61 62 6c 65 2d 70 69 74 63 68 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e iable-pitch......This.option.con
b920 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 61 6c 69 67 6e 65 trols.whether.columns.are.aligne
b940 64 20 70 69 78 65 6c 2d 77 69 73 65 20 69 6e 20 74 68 65 0a 20 20 20 20 20 6d 65 6e 75 20 62 75 d.pixel-wise.in.the......menu.bu
b960 66 66 65 72 2e 0a 0a 20 20 20 20 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 ffer........If.this.is.non-...ni
b980 6c e2 80 99 2c 20 74 68 65 6e 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 61 6c 69 67 6e 65 64 20 70 l...,.then.columns.are.aligned.p
b9a0 69 78 65 6c 2d 77 69 73 65 20 74 6f 0a 20 20 20 20 20 73 75 70 70 6f 72 74 20 76 61 72 69 61 62 ixel-wise.to......support.variab
b9c0 6c 65 2d 70 69 74 63 68 20 66 6f 6e 74 73 2e 20 20 4b 65 79 73 20 61 72 65 20 6e 6f 74 20 61 6c le-pitch.fonts...Keys.are.not.al
b9e0 69 67 6e 65 64 2c 20 73 6f 20 79 6f 75 20 73 68 6f 75 6c 64 0a 20 20 20 20 20 75 73 65 20 61 20 igned,.so.you.should......use.a.
ba00 66 69 78 65 64 2d 70 69 74 63 68 20 66 6f 6e 74 20 66 6f 72 20 74 68 65 20 e2 80 98 74 72 61 6e fixed-pitch.font.for.the....tran
ba20 73 69 65 6e 74 2d 6b 65 79 e2 80 99 20 66 61 63 65 2e 20 20 4f 74 68 65 72 20 6b 65 79 0a 20 20 sient-key....face...Other.key...
ba40 20 20 20 66 61 63 65 73 20 69 6e 68 65 72 69 74 20 66 72 6f 6d 20 74 68 61 74 20 66 61 63 65 20 ...faces.inherit.from.that.face.
ba60 75 6e 6c 65 73 73 20 61 20 74 68 65 6d 65 20 69 73 20 75 73 65 64 20 74 68 61 74 20 62 72 65 61 unless.a.theme.is.used.that.brea
ba80 6b 73 0a 20 20 20 20 20 74 68 61 74 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 2e 0a 0a 20 20 20 20 ks......that.relationship.......
baa0 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 .This.option.is.intended.for.use
bac0 72 73 20 77 68 6f 20 75 73 65 20 61 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 66 6f 6e 74 rs.who.use.a.variable-pitch.font
bae0 20 66 6f 72 0a 20 20 20 20 20 74 68 65 20 e2 80 98 64 65 66 61 75 6c 74 e2 80 99 20 66 61 63 65 .for......the....default....face
bb00 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d ...User.Option:.transient-force-
bb20 66 69 78 65 64 2d 70 69 74 63 68 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e fixed-pitch......This.option.con
bb40 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 6f 20 66 6f 72 63 65 20 74 68 65 20 75 73 65 20 6f trols.whether.to.force.the.use.o
bb60 66 20 61 20 6d 6f 6e 6f 73 70 61 63 65 64 20 66 6f 6e 74 0a 20 20 20 20 20 69 6e 20 6d 65 6e 75 f.a.monospaced.font......in.menu
bb80 20 62 75 66 66 65 72 2e 20 20 45 76 65 6e 20 69 66 20 79 6f 75 20 75 73 65 20 61 20 70 72 6f 70 .buffer...Even.if.you.use.a.prop
bba0 6f 72 74 69 6f 6e 61 6c 20 66 6f 6e 74 20 66 6f 72 20 74 68 65 0a 20 20 20 20 20 e2 80 98 64 65 ortional.font.for.the.........de
bbc0 66 61 75 6c 74 e2 80 99 20 66 61 63 65 2c 20 79 6f 75 20 6d 69 67 68 74 20 73 74 69 6c 6c 20 77 fault....face,.you.might.still.w
bbe0 61 6e 74 20 74 6f 20 75 73 65 20 61 20 6d 6f 6e 6f 73 70 61 63 65 64 20 66 6f 6e 74 20 69 6e 0a ant.to.use.a.monospaced.font.in.
bc00 20 20 20 20 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 53 65 74 74 69 6e 67 20 74 .....the.menu.buffer...Setting.t
bc20 68 69 73 20 6f 70 74 69 6f 6e 20 74 6f 20 e2 80 98 74 e2 80 99 20 63 61 75 73 65 73 20 e2 80 98 his.option.to....t....causes....
bc40 64 65 66 61 75 6c 74 e2 80 99 20 74 6f 20 62 65 0a 20 20 20 20 20 72 65 6d 61 70 70 65 64 20 74 default....to.be......remapped.t
bc60 6f 20 e2 80 98 66 69 78 65 64 2d 70 69 74 63 68 e2 80 99 20 69 6e 20 74 68 61 74 20 62 75 66 66 o....fixed-pitch....in.that.buff
bc80 65 72 2e 0a 0a 44 65 76 65 6c 6f 70 65 72 20 4f 70 74 69 6f 6e 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d er...Developer.Options.---------
bca0 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 73 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 6d 61 69 6e --------..These.options.are.main
bcc0 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 64 65 76 65 6c 6f 70 65 72 73 2e 0a 0a 55 73 65 ly.intended.for.developers...Use
bce0 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 74 65 63 74 2d 6b 65 79 2d 63 r.Option:.transient-detect-key-c
bd00 6f 6e 66 6c 69 63 74 73 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f onflicts......This.option.contro
bd20 6c 73 20 77 68 65 74 68 65 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 63 6f 6e 66 6c 69 63 74 73 ls.whether.key.binding.conflicts
bd40 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20 20 64 65 74 65 63 74 65 64 20 61 74 20 74 68 65 20 .should.be......detected.at.the.
bd60 74 69 6d 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 time.the.transient.is.invoked...
bd80 49 66 20 73 6f 2c 20 74 68 69 73 20 72 65 73 75 6c 74 73 0a 20 20 20 20 20 69 6e 20 61 6e 20 65 If.so,.this.results......in.an.e
bda0 72 72 6f 72 2c 20 77 68 69 63 68 20 70 72 65 76 65 6e 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 rror,.which.prevents.the.transie
bdc0 6e 74 20 66 72 6f 6d 20 62 65 69 6e 67 20 75 73 65 64 2e 20 20 42 65 63 61 75 73 65 0a 20 20 20 nt.from.being.used...Because....
bde0 20 20 6f 66 20 74 68 61 74 2c 20 63 6f 6e 66 6c 69 63 74 73 20 61 72 65 20 69 67 6e 6f 72 65 64 ..of.that,.conflicts.are.ignored
be00 20 62 79 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 20 20 20 43 6f 6e 66 6c 69 63 74 73 20 63 61 6e .by.default........Conflicts.can
be20 6e 6f 74 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64 20 65 61 72 6c 69 65 72 2c 20 69 2e 65 2e 2c not.be.determined.earlier,.i.e.,
be40 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 0a 20 20 20 20 20 62 65 69 6e .when.the.transient.is......bein
be60 67 20 64 65 66 69 6e 65 64 20 61 6e 64 20 77 68 65 6e 20 6e 65 77 20 73 75 66 66 69 78 65 73 20 g.defined.and.when.new.suffixes.
be80 61 72 65 20 62 65 69 6e 67 20 61 64 64 65 64 2c 20 62 65 63 61 75 73 65 20 61 74 0a 20 20 20 20 are.being.added,.because.at.....
bea0 20 74 68 61 74 20 74 69 6d 65 20 74 68 65 72 65 20 63 61 6e 20 62 65 20 66 61 6c 73 65 2d 70 6f .that.time.there.can.be.false-po
bec0 73 69 74 69 76 65 73 2e 20 20 49 74 20 69 73 20 61 63 74 75 61 6c 6c 79 20 76 61 6c 69 64 20 66 sitives...It.is.actually.valid.f
bee0 6f 72 0a 20 20 20 20 20 6d 75 6c 74 69 70 6c 65 20 73 75 66 66 69 78 65 73 20 74 6f 20 73 68 61 or......multiple.suffixes.to.sha
bf00 72 65 20 61 20 63 6f 6d 6d 6f 6e 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 70 72 6f 76 69 64 65 re.a.common.key.binding,.provide
bf20 64 20 74 68 65 0a 20 20 20 20 20 70 72 65 64 69 63 61 74 65 73 20 6f 66 20 74 68 6f 73 65 20 73 d.the......predicates.of.those.s
bf40 75 66 66 69 78 65 73 20 70 72 65 76 65 6e 74 20 74 68 61 74 20 6d 6f 72 65 20 74 68 61 6e 20 6f uffixes.prevent.that.more.than.o
bf60 6e 65 20 6f 66 20 74 68 65 6d 20 69 73 0a 20 20 20 20 20 65 6e 61 62 6c 65 64 20 61 74 20 61 20 ne.of.them.is......enabled.at.a.
bf80 74 69 6d 65 2e 0a 0a 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 65 72 time...User.Option:.transient-er
bfa0 72 6f 72 2d 6f 6e 2d 69 6e 73 65 72 74 2d 66 61 69 6c 75 72 65 0a 20 20 20 20 20 54 68 69 73 20 ror-on-insert-failure......This.
bfc0 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 6f 20 73 69 67 6e 61 option.controls.whether.to.signa
bfe0 6c 20 61 6e 20 65 72 72 6f 72 20 77 68 65 6e 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e l.an.error.when.........transien
c000 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 e2 80 99 20 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 t-insert-suffix....or....transie
c020 6e 74 2d 61 70 70 65 6e 64 2d 73 75 66 66 69 78 e2 80 99 20 66 61 69 6c 65 64 20 74 6f 0a 20 20 nt-append-suffix....failed.to...
c040 20 20 20 69 6e 73 65 72 74 20 61 20 73 75 66 66 69 78 20 69 6e 74 6f 20 61 6e 20 65 78 69 73 74 ...insert.a.suffix.into.an.exist
c060 69 6e 67 20 70 72 65 66 69 78 2e 20 20 42 79 20 64 65 66 61 75 6c 74 20 61 20 77 61 72 6e 69 6e ing.prefix...By.default.a.warnin
c080 67 20 69 73 0a 20 20 20 20 20 73 68 6f 77 6e 20 69 6e 73 74 65 61 64 2e 0a 0a 55 73 65 72 20 4f g.is......shown.instead...User.O
c0a0 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 68 69 67 68 65 ption:.transient-highlight-highe
c0c0 72 2d 6c 65 76 65 6c 73 0a 20 20 20 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f r-levels......This.option.contro
c0e0 6c 73 20 77 68 65 74 68 65 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 77 6f 75 6c 64 20 6e ls.whether.suffixes.that.would.n
c100 6f 74 20 62 65 20 61 76 61 69 6c 61 62 6c 65 0a 20 20 20 20 20 62 79 20 64 65 66 61 75 6c 74 20 ot.be.available......by.default.
c120 61 72 65 20 68 69 67 68 6c 69 67 68 74 65 64 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 6e 6f 6e 2d are.highlighted........When.non-
c140 e2 80 98 6e 69 6c e2 80 99 20 74 68 65 6e 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 ...nil....then.the.descriptions.
c160 6f 66 20 73 75 66 66 69 78 65 73 20 61 72 65 20 68 69 67 68 6c 69 67 68 74 65 64 20 69 66 0a 20 of.suffixes.are.highlighted.if..
c180 20 20 20 20 74 68 65 69 72 20 6c 65 76 65 6c 20 69 73 20 61 62 6f 76 65 20 34 2c 20 74 68 65 20 ....their.level.is.above.4,.the.
c1a0 64 65 66 61 75 6c 74 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d default.of....transient-default-
c1c0 6c 65 76 65 6c e2 80 99 2e 0a 20 20 20 20 20 41 73 73 75 6d 69 6e 67 20 79 6f 75 20 68 61 76 65 level..........Assuming.you.have
c1e0 20 73 65 74 20 74 68 61 74 20 76 61 72 69 61 62 6c 65 20 74 6f 20 37 2c 20 74 68 69 73 20 68 69 .set.that.variable.to.7,.this.hi
c200 67 68 6c 69 67 68 74 73 20 61 6c 6c 0a 20 20 20 20 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 ghlights.all......suffixes.that.
c220 77 6f 6e e2 80 99 74 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 75 73 65 72 73 20 77 69 won...t.be.available.to.users.wi
c240 74 68 6f 75 74 20 74 68 65 6d 20 6d 61 6b 69 6e 67 20 74 68 65 0a 20 20 20 20 20 73 61 6d 65 20 thout.them.making.the......same.
c260 63 75 73 74 6f 6d 69 7a 61 74 69 6f 6e 2e 0a 0a 48 6f 6f 6b 20 56 61 72 69 61 62 6c 65 73 0a 2d customization...Hook.Variables.-
c280 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 56 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 -------------..Variable:.transie
c2a0 6e 74 2d 65 78 69 74 2d 68 6f 6f 6b 0a 20 20 20 20 20 54 68 69 73 20 68 6f 6f 6b 20 69 73 20 72 nt-exit-hook......This.hook.is.r
c2c0 75 6e 20 61 66 74 65 72 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 65 78 69 un.after.a.transient.menu.is.exi
c2e0 74 65 64 2c 20 65 76 65 6e 20 69 66 20 61 6e 6f 74 68 65 72 0a 20 20 20 20 20 74 72 61 6e 73 69 ted,.even.if.another......transi
c300 65 6e 74 20 6d 65 6e 75 20 62 65 63 6f 6d 65 73 20 61 63 74 69 76 65 20 61 74 20 74 68 65 20 73 ent.menu.becomes.active.at.the.s
c320 61 6d 65 20 74 69 6d 65 2e 0a 0a 56 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 70 ame.time...Variable:.transient-p
c340 6f 73 74 2d 65 78 69 74 2d 68 6f 6f 6b 0a 20 20 20 20 20 54 68 69 73 20 68 6f 6f 6b 20 69 73 20 ost-exit-hook......This.hook.is.
c360 72 75 6e 20 61 66 74 65 72 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 65 78 run.after.a.transient.menu.is.ex
c380 69 74 65 64 2c 20 70 72 6f 76 69 64 65 64 20 6e 6f 0a 20 20 20 20 20 6f 74 68 65 72 20 74 72 61 ited,.provided.no......other.tra
c3a0 6e 73 69 65 6e 74 20 6d 65 6e 75 20 62 65 63 6f 6d 65 73 20 61 63 74 69 76 65 20 61 74 20 74 68 nsient.menu.becomes.active.at.th
c3c0 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a 56 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e e.same.time...Variable:.transien
c3e0 74 2d 73 65 74 75 70 2d 62 75 66 66 65 72 2d 68 6f 6f 6b 0a 20 20 20 20 20 54 68 69 73 20 68 6f t-setup-buffer-hook......This.ho
c400 6f 6b 20 69 73 20 72 75 6e 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 ok.is.run.when.the.transient.buf
c420 66 65 72 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 2e 20 20 54 68 61 74 0a 20 20 20 20 20 62 fer.is.being.setup...That......b
c440 75 66 66 65 72 20 69 73 20 63 75 72 72 65 6e 74 20 61 6e 64 20 65 6d 70 74 79 20 77 68 65 6e 20 uffer.is.current.and.empty.when.
c460 74 68 69 73 20 68 6f 6f 6b 20 69 73 20 72 75 6e 73 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 this.hook.is.runs.....File:.doci
c480 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 3EOZM.info,..Node:.Modifying.Exi
c4a0 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 4e 65 78 74 3a 20 44 65 66 69 6e 69 6e sting.Transients,..Next:.Definin
c4c0 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 50 72 65 76 3a 20 55 73 61 67 65 2c 20 20 55 g.New.Commands,..Prev:.Usage,..U
c4e0 70 3a 20 54 6f 70 0a 0a 33 20 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 p:.Top..3.Modifying.Existing.Tra
c500 6e 73 69 65 6e 74 73 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a nsients.************************
c520 2a 2a 2a 2a 2a 2a 2a 0a 0a 54 6f 20 61 6e 20 65 78 74 65 6e 74 2c 20 74 72 61 6e 73 69 65 6e 74 *******..To.an.extent,.transient
c540 73 20 63 61 6e 20 62 65 20 63 75 73 74 6f 6d 69 7a 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c s.can.be.customized.interactivel
c560 79 2c 20 73 65 65 20 2a 6e 6f 74 65 0a 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c y,.see.*note.Enabling.and.Disabl
c580 69 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 2e 20 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 65 78 ing.Suffixes::...This.section.ex
c5a0 70 6c 61 69 6e 73 20 68 6f 77 20 65 78 69 73 74 69 6e 67 0a 74 72 61 6e 73 69 65 6e 74 73 20 63 plains.how.existing.transients.c
c5c0 61 6e 20 62 65 20 66 75 72 74 68 65 72 20 6d 6f 64 69 66 69 65 64 20 6e 6f 6e 2d 69 6e 74 65 72 an.be.further.modified.non-inter
c5e0 61 63 74 69 76 65 6c 79 2e 20 20 4c 65 74 e2 80 99 73 20 62 65 67 69 6e 20 77 69 74 68 0a 61 6e actively...Let...s.begin.with.an
c600 20 65 78 61 6d 70 6c 65 3a 0a 0a 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 61 70 70 65 6e .example:.......(transient-appen
c620 64 2d 73 75 66 66 69 78 20 27 6d 61 67 69 74 2d 70 61 74 63 68 2d 61 70 70 6c 79 20 22 2d 33 22 d-suffix.'magit-patch-apply."-3"
c640 0a 20 20 20 20 20 20 20 27 28 22 2d 52 22 20 22 41 70 70 6c 79 20 69 6e 20 72 65 76 65 72 73 65 ........'("-R"."Apply.in.reverse
c660 22 20 22 2d 2d 72 65 76 65 72 73 65 22 29 29 0a 0a 20 20 20 54 68 69 73 20 69 6e 73 65 72 74 73 "."--reverse")).....This.inserts
c680 20 61 20 6e 65 77 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 6f 67 67 6c 65 20 .a.new.infix.argument.to.toggle.
c6a0 74 68 65 20 e2 80 98 2d 2d 72 65 76 65 72 73 65 e2 80 99 20 61 72 67 75 6d 65 6e 74 0a 61 66 74 the....--reverse....argument.aft
c6c0 65 72 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 20 69 73 20 62 6f er.the.infix.argument.that.is.bo
c6e0 75 6e 64 20 74 6f 20 e2 80 98 2d 33 e2 80 99 20 69 6e 20 e2 80 98 6d 61 67 69 74 2d 70 61 74 63 und.to....-3....in....magit-patc
c700 68 2d 61 70 70 6c 79 e2 80 99 2e 0a 0a 20 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 h-apply.........The.following.fu
c720 6e 63 74 69 6f 6e 73 20 73 68 61 72 65 20 61 20 66 65 77 20 61 72 67 75 6d 65 6e 74 73 3a 0a 0a nctions.share.a.few.arguments:..
c740 20 20 20 e2 80 a2 20 50 52 45 46 49 58 20 69 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 .......PREFIX.is.a.transient.pre
c760 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 0a 20 20 20 20 20 50 52 45 fix.command,.a.symbol........PRE
c780 46 49 58 20 6d 61 79 20 61 6c 73 6f 20 62 79 20 61 20 73 79 6d 62 6f 6c 20 69 64 65 6e 74 69 66 FIX.may.also.by.a.symbol.identif
c7a0 79 69 6e 67 20 61 20 73 65 70 61 72 61 74 65 6c 79 20 64 65 66 69 6e 65 64 20 67 72 6f 75 70 2c ying.a.separately.defined.group,
c7c0 0a 20 20 20 20 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 6d ......which.can.be.included.in.m
c7e0 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 65 73 2e 20 20 53 65 65 20 54 4f 44 4f 2e 0a 0a 20 20 ultiple.prefixes...See.TODO.....
c800 20 e2 80 a2 20 53 55 46 46 49 58 20 69 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 .....SUFFIX.is.a.transient.infix
c820 20 6f 72 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 .or.suffix.specification.in.the.
c840 73 61 6d 65 0a 20 20 20 20 20 66 6f 72 6d 20 61 73 20 65 78 70 65 63 74 65 64 20 62 79 20 e2 80 same......form.as.expected.by...
c860 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 e2 80 99 2e 20 20 4e 6f .transient-define-prefix......No
c880 74 65 20 74 68 61 74 20 61 6e 20 69 6e 66 69 78 0a 20 20 20 20 20 69 73 20 61 20 73 70 65 63 69 te.that.an.infix......is.a.speci
c8a0 61 6c 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 2e 20 20 44 65 70 65 6e 64 69 6e 67 20 6f 6e al.kind.of.suffix...Depending.on
c8c0 20 63 6f 6e 74 65 78 74 20 e2 80 9c 73 75 66 66 69 78 65 73 e2 80 9d 20 6d 65 61 6e 73 0a 20 20 .context....suffixes....means...
c8e0 20 20 20 e2 80 9c 73 75 66 66 69 78 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 69 6e 66 69 78 65 ......suffixes.(including.infixe
c900 73 29 e2 80 9d 20 6f 72 20 e2 80 9c 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 e2 80 s)....or....non-infix.suffixes..
c920 9d 2e 20 20 48 65 72 65 20 69 74 0a 20 20 20 20 20 6d 65 61 6e 73 20 74 68 65 20 66 6f 72 6d 65 ....Here.it......means.the.forme
c940 72 2e 20 20 53 65 65 20 2a 6e 6f 74 65 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 r...See.*note.Suffix.Specificati
c960 6f 6e 73 3a 3a 2e 0a 0a 20 20 20 20 20 53 55 46 46 49 58 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 ons::........SUFFIX.may.also.be.
c980 61 20 67 72 6f 75 70 20 69 6e 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 65 78 70 65 a.group.in.the.same.form.as.expe
c9a0 63 74 65 64 20 62 79 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 cted.by.........transient-define
c9c0 2d 70 72 65 66 69 78 e2 80 99 2e 20 20 53 65 65 20 2a 6e 6f 74 65 20 47 72 6f 75 70 20 53 70 65 -prefix......See.*note.Group.Spe
c9e0 63 69 66 69 63 61 74 69 6f 6e 73 3a 3a 2e 0a 0a 20 20 20 e2 80 a2 20 4c 4f 43 20 69 73 20 61 20 cifications::..........LOC.is.a.
ca00 6b 65 79 20 64 65 73 63 72 69 70 74 69 6f 6e 20 28 61 20 73 74 72 69 6e 67 20 61 73 20 72 65 74 key.description.(a.string.as.ret
ca20 75 72 6e 65 64 20 62 79 20 e2 80 98 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 0a 20 urned.by....key-description.....
ca40 20 20 20 20 61 6e 64 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 e2 80 98 6b 62 64 e2 80 99 29 ....and.understood.by....kbd...)
ca60 2c 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 20 69 64 65 6e 74 69 66 79 69 6e ,.a.command,.a.symbol.identifyin
ca80 67 20 61 6e 0a 20 20 20 20 20 69 6e 63 6c 75 64 65 64 20 67 72 6f 75 70 2c 20 6f 72 20 61 20 76 g.an......included.group,.or.a.v
caa0 65 63 74 6f 72 20 73 70 65 63 69 66 79 69 6e 67 20 63 6f 6f 72 64 69 6e 61 74 65 73 2e 20 20 46 ector.specifying.coordinates...F
cac0 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 20 20 20 20 20 e2 80 98 5b 31 20 30 20 2d 31 5d e2 80 99 20 or.example,.........[1.0.-1]....
cae0 69 64 65 6e 74 69 66 69 65 73 20 74 68 65 20 6c 61 73 74 20 73 75 66 66 69 78 20 28 e2 80 98 2d identifies.the.last.suffix.(...-
cb00 31 e2 80 99 29 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 73 75 62 67 72 6f 75 70 0a 20 20 20 20 1...).of.the.first.subgroup.....
cb20 20 28 e2 80 98 30 e2 80 99 29 20 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 67 72 6f 75 70 20 28 .(...0...).of.the.second.group.(
cb40 e2 80 98 31 e2 80 99 29 2e 0a 0a 20 20 20 20 20 49 66 20 4c 4f 43 20 69 73 20 61 20 76 65 63 74 ...1...)........If.LOC.is.a.vect
cb60 6f 72 2c 20 74 68 65 6e 20 69 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 64 65 6e 74 or,.then.it.can.be.used.to.ident
cb80 69 66 79 20 61 20 67 72 6f 75 70 2c 20 6e 6f 74 0a 20 20 20 20 20 6a 75 73 74 20 61 6e 20 69 6e ify.a.group,.not......just.an.in
cba0 64 69 76 69 64 75 61 6c 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 65 20 6c 61 dividual.suffix.command...The.la
cbc0 73 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 61 20 76 65 63 74 6f 72 0a 20 20 20 20 20 6d 61 79 20 st.element.in.a.vector......may.
cbe0 61 6c 73 6f 20 62 65 20 61 20 73 79 6d 62 6f 6c 20 6f 72 20 6b 65 79 2c 20 69 6e 20 77 68 69 63 also.be.a.symbol.or.key,.in.whic
cc00 68 20 63 61 73 65 20 74 68 65 20 70 72 65 63 65 64 69 6e 67 20 65 6c 65 6d 65 6e 74 73 0a 20 20 h.case.the.preceding.elements...
cc20 20 20 20 6d 75 73 74 20 6d 61 74 63 68 20 61 20 67 72 6f 75 70 20 61 6e 64 20 74 68 65 20 6c 61 ...must.match.a.group.and.the.la
cc40 73 74 20 65 6c 65 6d 65 6e 74 20 69 73 20 6c 6f 6f 6b 65 64 20 75 70 20 77 69 74 68 69 6e 20 74 st.element.is.looked.up.within.t
cc60 68 61 74 0a 20 20 20 20 20 67 72 6f 75 70 2e 0a 0a 20 20 20 20 20 54 68 65 20 66 75 6e 63 74 69 hat......group........The.functi
cc80 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 73 75 66 66 69 78 e2 80 99 20 63 61 on....transient-get-suffix....ca
cca0 6e 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 0a 20 20 20 20 20 77 68 n.be.useful.to.determine......wh
ccc0 65 74 68 65 72 20 61 20 63 65 72 74 61 69 6e 20 63 6f 6f 72 64 69 6e 61 74 65 20 76 65 63 74 6f ether.a.certain.coordinate.vecto
cce0 72 20 69 64 65 6e 74 69 66 69 65 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 r.identifies.the.suffix.or.group
cd00 0a 20 20 20 20 20 74 68 61 74 20 79 6f 75 20 65 78 70 65 63 74 20 69 74 20 74 6f 20 69 64 65 6e ......that.you.expect.it.to.iden
cd20 74 69 66 79 2e 20 20 49 6e 20 68 61 69 72 79 20 63 61 73 65 73 20 69 74 20 6d 61 79 20 62 65 20 tify...In.hairy.cases.it.may.be.
cd40 6e 65 63 65 73 73 61 72 79 0a 20 20 20 20 20 74 6f 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 69 6e necessary......to.look.at.the.in
cd60 74 65 72 6e 61 6c 20 6c 61 79 6f 75 74 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2c 20 77 68 ternal.layout.representation,.wh
cd80 69 63 68 20 79 6f 75 20 63 61 6e 20 61 63 63 65 73 73 0a 20 20 20 20 20 75 73 69 6e 67 20 74 68 ich.you.can.access......using.th
cda0 65 20 66 75 6e 63 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 6c 61 79 e.function....transient--get-lay
cdc0 6f 75 74 e2 80 99 2e 0a 0a 20 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f 70 65 72 out.........These.functions.oper
cde0 61 74 65 20 6f 6e 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 74 6f 72 65 64 20 69 6e ate.on.the.information.stored.in
ce00 20 74 68 65 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 e2 80 99 20 70 72 6f .the....transient--layout....pro
ce20 70 65 72 74 79 20 6f 66 20 74 68 65 20 50 52 45 46 49 58 20 73 79 6d 62 6f 6c 2e 20 20 45 6c 65 perty.of.the.PREFIX.symbol...Ele
ce40 6d 65 6e 74 73 20 69 6e 20 74 68 61 74 0a 74 72 65 65 20 61 72 65 20 6e 6f 74 20 6f 62 6a 65 63 ments.in.that.tree.are.not.objec
ce60 74 73 20 62 75 74 20 68 61 76 65 20 74 68 65 20 66 6f 72 6d 20 e2 80 98 28 43 4c 41 53 53 20 50 ts.but.have.the.form....(CLASS.P
ce80 4c 49 53 54 29 20 66 6f 72 20 73 75 66 66 69 78 65 73 e2 80 99 20 61 6e 64 0a 5b 43 4c 41 53 53 LIST).for.suffixes....and.[CLASS
cea0 20 50 4c 49 53 54 20 43 48 49 4c 44 52 45 4e 5d 20 66 6f 72 20 67 72 6f 75 70 73 2e 20 20 41 74 .PLIST.CHILDREN].for.groups...At
cec0 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 74 68 65 20 74 72 65 65 20 69 73 20 61 6e 0a 65 6c 65 6d .the.root.of.the.tree.is.an.elem
cee0 65 6e 74 20 5b 4e 20 6e 69 6c 20 43 48 49 4c 44 52 45 4e 5d 2c 20 77 68 65 72 65 20 4e 20 69 73 ent.[N.nil.CHILDREN],.where.N.is
cf00 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 6c 61 79 6f 75 74 20 66 6f 72 6d 61 .the.version.of.the.layout.forma
cf20 74 2c 0a 63 75 72 72 65 6e 74 6c 79 20 61 6e 64 20 68 6f 70 65 66 75 6c 6c 79 20 66 6f 72 20 61 t,.currently.and.hopefully.for.a
cf40 20 6c 6f 6e 67 20 74 69 6d 65 20 32 2e 20 20 57 68 69 6c 65 20 74 68 61 74 20 65 6c 65 6d 65 6e .long.time.2...While.that.elemen
cf60 74 20 6c 6f 6f 6b 73 0a 6c 69 6b 65 20 61 20 67 72 6f 75 70 20 76 65 63 74 6f 72 2c 20 74 68 61 t.looks.like.a.group.vector,.tha
cf80 74 20 65 6c 65 6d 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20 63 6f 75 6e 74 20 77 68 65 6e 20 69 64 t.element.does.not.count.when.id
cfa0 65 6e 74 69 66 79 69 6e 67 20 61 0a 67 72 6f 75 70 20 75 73 69 6e 67 20 61 20 63 6f 6f 72 64 69 entifying.a.group.using.a.coordi
cfc0 6e 61 74 65 20 76 65 63 74 6f 72 2c 20 69 2e 65 2e 2c 20 5b 30 5d 20 69 73 20 69 74 73 20 66 69 nate.vector,.i.e.,.[0].is.its.fi
cfe0 72 73 74 20 63 68 69 6c 64 2c 20 6e 6f 74 20 74 68 65 0a 72 6f 6f 74 20 65 6c 65 6d 65 6e 74 20 rst.child,.not.the.root.element.
d000 69 74 73 65 6c 66 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 itself...Function:.transient-ins
d020 65 72 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 20 26 6f 70 ert-suffix.prefix.loc.suffix.&op
d040 74 69 6f 6e 61 6c 20 6b 65 65 70 2d 6f 74 68 65 72 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 tional.keep-other..Function:.tra
d060 6e 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 nsient-append-suffix.prefix.loc.
d080 73 75 66 66 69 78 20 26 6f 70 74 69 6f 6e 61 6c 20 6b 65 65 70 2d 6f 74 68 65 72 0a 20 20 20 20 suffix.&optional.keep-other.....
d0a0 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 73 65 72 74 20 74 68 65 20 73 75 66 66 .These.functions.insert.the.suff
d0c0 69 78 20 6f 72 20 67 72 6f 75 70 20 53 55 46 46 49 58 20 69 6e 74 6f 20 50 52 45 46 49 58 0a 20 ix.or.group.SUFFIX.into.PREFIX..
d0e0 20 20 20 20 62 65 66 6f 72 65 20 6f 72 20 61 66 74 65 72 20 4c 4f 43 2e 0a 0a 20 20 20 20 20 43 ....before.or.after.LOC........C
d100 6f 6e 63 65 70 74 75 61 6c 6c 79 20 61 64 64 69 6e 67 20 61 20 62 69 6e 64 69 6e 67 20 74 6f 20 onceptually.adding.a.binding.to.
d120 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f a.transient.prefix.is.similar.to
d140 0a 20 20 20 20 20 61 64 64 69 6e 67 20 61 20 62 69 6e 64 69 6e 67 20 74 6f 20 61 20 6b 65 79 6d ......adding.a.binding.to.a.keym
d160 61 70 2c 20 62 75 74 20 74 68 69 73 20 69 73 20 63 6f 6d 70 6c 69 63 61 74 65 64 20 62 79 20 74 ap,.but.this.is.complicated.by.t
d180 68 65 20 66 61 63 74 0a 20 20 20 20 20 74 68 61 74 20 6d 75 6c 74 69 70 6c 65 20 73 75 66 66 69 he.fact......that.multiple.suffi
d1a0 78 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 62 6f 75 6e 64 20 74 6f 20 74 68 65 20 73 x.commands.can.be.bound.to.the.s
d1c0 61 6d 65 20 6b 65 79 2c 0a 20 20 20 20 20 70 72 6f 76 69 64 65 64 20 74 68 65 79 20 61 72 65 20 ame.key,......provided.they.are.
d1e0 6e 65 76 65 72 20 61 63 74 69 76 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2c 20 73 never.active.at.the.same.time,.s
d200 65 65 20 2a 6e 6f 74 65 0a 20 20 20 20 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 3a 3a 2e ee.*note......Predicate.Slots::.
d220 0a 0a 20 20 20 20 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 62 6f 74 68 20 66 61 6c 73 65 2d .......Unfortunately.both.false-
d240 70 6f 73 69 74 69 76 65 73 20 61 6e 64 20 66 61 6c 73 65 2d 6e 65 67 61 74 69 76 65 73 20 61 72 positives.and.false-negatives.ar
d260 65 0a 20 20 20 20 20 70 6f 73 73 69 62 6c 65 2e 20 20 54 6f 20 64 65 61 6c 20 77 69 74 68 20 74 e......possible...To.deal.with.t
d280 68 65 20 66 6f 72 6d 65 72 2c 20 75 73 65 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 20 4b 45 45 he.former,.use.non-...nil....KEE
d2a0 50 2d 4f 54 48 45 52 2e 20 20 54 68 65 0a 20 20 20 20 20 73 79 6d 62 6f 6c 20 e2 80 98 61 6c 77 P-OTHER...The......symbol....alw
d2c0 61 79 73 e2 80 99 20 70 72 65 76 65 6e 74 73 20 74 68 65 20 72 65 6d 6f 76 61 6c 20 6f 66 20 61 ays....prevents.the.removal.of.a
d2e0 20 66 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 2c 20 69 6e 20 73 6f 6d 65 0a 20 20 20 20 20 63 61 .false-positive,.in.some......ca
d300 73 65 73 20 77 68 65 72 65 20 6f 74 68 65 72 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 20 76 61 ses.where.other.non-...nil....va
d320 6c 75 65 73 20 77 6f 75 6c 64 20 66 61 69 6c 2e 20 20 54 6f 20 64 65 61 6c 20 77 69 74 68 0a 20 lues.would.fail...To.deal.with..
d340 20 20 20 20 66 61 6c 73 65 2d 6e 65 67 61 74 69 76 65 73 20 72 65 6d 6f 76 65 20 74 68 65 20 63 ....false-negatives.remove.the.c
d360 6f 6e 66 6c 69 63 74 69 6e 67 20 62 69 6e 64 69 6e 67 20 73 65 70 61 72 61 74 65 6c 79 2c 20 75 onflicting.binding.separately,.u
d380 73 69 6e 67 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 72 65 6d 6f 76 65 2d 73 75 sing.........transient-remove-su
d3a0 66 66 69 78 e2 80 99 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 ffix......Function:.transient-re
d3c0 70 6c 61 63 65 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 0a 20 place-suffix.prefix.loc.suffix..
d3e0 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 73 ....This.function.replaces.the.s
d400 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 61 74 20 4c 4f 43 20 69 6e 20 50 52 45 46 49 58 20 uffix.or.group.at.LOC.in.PREFIX.
d420 77 69 74 68 0a 20 20 20 20 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 53 55 46 46 49 58 with......suffix.or.group.SUFFIX
d440 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 6d 6f 76 65 2d 73 75 ...Function:.transient-remove-su
d460 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 ffix.prefix.loc......This.functi
d480 6f 6e 20 72 65 6d 6f 76 65 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 61 on.removes.the.suffix.or.group.a
d4a0 74 20 4c 4f 43 20 69 6e 20 50 52 45 46 49 58 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e t.LOC.in.PREFIX...Function:.tran
d4c0 73 69 65 6e 74 2d 67 65 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 0a 20 20 20 20 sient-get-suffix.prefix.loc.....
d4e0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 75 66 66 69 .This.function.returns.the.suffi
d500 78 20 6f 72 20 67 72 6f 75 70 20 61 74 20 4c 4f 43 20 69 6e 20 50 52 45 46 49 58 2e 20 20 54 68 x.or.group.at.LOC.in.PREFIX...Th
d520 65 0a 20 20 20 20 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75 65 20 68 61 73 20 74 68 65 20 66 6f e......returned.value.has.the.fo
d540 72 6d 20 6d 65 6e 74 69 6f 6e 65 64 20 61 62 6f 76 65 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 rm.mentioned.above...Function:.t
d560 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 70 75 74 20 70 72 65 66 69 78 20 6c 6f 63 20 70 ransient-suffix-put.prefix.loc.p
d580 72 6f 70 20 76 61 6c 75 65 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 65 64 69 rop.value......This.function.edi
d5a0 74 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 61 74 20 4c 4f 43 20 69 6e ts.the.suffix.or.group.at.LOC.in
d5c0 20 50 52 45 46 49 58 2c 20 62 79 0a 20 20 20 20 20 73 65 74 74 69 6e 67 20 74 68 65 20 50 52 4f .PREFIX,.by......setting.the.PRO
d5e0 50 20 6f 66 20 69 74 73 20 70 6c 69 73 74 20 74 6f 20 56 41 4c 55 45 2e 0a 0a 20 20 20 53 6f 6d P.of.its.plist.to.VALUE......Som
d600 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 73 68 61 72 65 20 73 75 66 66 69 78 65 73 e.prefix.commands.share.suffixes
d620 2c 20 77 68 69 63 68 20 61 72 65 20 73 65 70 61 72 61 74 65 6c 79 20 61 6e 64 20 74 68 65 6e 0a ,.which.are.separately.and.then.
d640 69 6e 63 6c 75 64 65 64 20 69 6e 20 65 61 63 68 20 70 72 65 66 69 78 20 77 68 65 6e 20 69 74 20 included.in.each.prefix.when.it.
d660 69 73 20 64 65 66 69 6e 65 64 2e 20 20 54 68 65 20 69 6e 63 6c 75 73 69 6f 6e 20 69 73 20 64 6f is.defined...The.inclusion.is.do
d680 6e 65 20 62 79 0a 72 65 66 65 72 65 6e 63 65 2c 20 74 68 65 20 69 6e 63 6c 75 64 65 64 20 73 75 ne.by.reference,.the.included.su
d6a0 66 66 69 78 20 67 72 6f 75 70 73 20 61 72 65 20 6e 6f 74 20 69 6e 6c 69 6e 65 64 20 62 79 20 64 ffix.groups.are.not.inlined.by.d
d6c0 65 66 61 75 6c 74 2e 20 20 53 6f 20 69 66 0a 79 6f 75 20 63 68 61 6e 67 65 2c 20 66 6f 72 20 65 efault...So.if.you.change,.for.e
d6e0 78 61 6d 70 6c 65 2c 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 61 6e 20 61 xample,.the.key.binding.for.an.a
d700 72 67 75 6d 65 6e 74 20 69 6e 20 e2 80 98 6d 61 67 69 74 2d 64 69 66 66 e2 80 99 0a 28 e2 80 98 rgument.in....magit-diff....(...
d720 64 e2 80 99 29 20 74 68 65 20 73 61 6d 65 20 63 68 61 6e 67 65 20 61 6c 73 6f 20 61 70 70 6c 69 d...).the.same.change.also.appli
d740 65 73 20 74 6f 20 e2 80 98 6d 61 67 69 74 2d 64 69 66 66 2d 72 65 66 72 65 73 68 e2 80 99 20 28 es.to....magit-diff-refresh....(
d760 e2 80 98 44 e2 80 99 29 2e 20 20 49 6e 0a 74 68 65 20 72 61 72 65 20 63 61 73 65 20 74 68 61 74 ...D...)...In.the.rare.case.that
d780 20 74 68 69 73 20 69 73 20 6e 6f 74 20 64 65 73 69 72 61 62 6c 65 20 75 73 65 20 e2 80 98 74 72 .this.is.not.desirable.use....tr
d7a0 61 6e 73 69 65 6e 74 2d 69 6e 6c 69 6e 65 2d 67 72 6f 75 70 e2 80 99 0a 62 65 66 6f 72 65 20 6d ansient-inline-group....before.m
d7c0 61 6b 69 6e 67 20 63 68 61 6e 67 65 73 20 74 6f 20 69 6e 63 6c 75 64 65 64 20 73 75 66 66 69 78 aking.changes.to.included.suffix
d7e0 65 73 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 6c 69 6e 65 2d es...Function:.transient-inline-
d800 67 72 6f 75 70 20 50 52 45 46 49 58 20 47 52 4f 55 50 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e group.PREFIX.GROUP......This.fun
d820 63 74 69 6f 6e 20 69 6e 6c 69 6e 65 73 20 74 68 65 20 69 6e 63 6c 75 64 65 64 20 47 52 4f 55 50 ction.inlines.the.included.GROUP
d840 20 69 6e 74 6f 20 50 52 45 46 49 58 2c 20 62 79 20 72 65 70 6c 61 63 69 6e 67 0a 20 20 20 20 20 .into.PREFIX,.by.replacing......
d860 74 68 65 20 73 79 6d 62 6f 6c 20 47 52 4f 55 50 20 77 69 74 68 20 69 74 73 20 65 78 70 61 6e 64 the.symbol.GROUP.with.its.expand
d880 65 64 20 6c 61 79 6f 75 74 20 69 6e 20 74 68 65 20 6c 61 79 6f 75 74 20 6f 66 20 50 52 45 46 49 ed.layout.in.the.layout.of.PREFI
d8a0 58 2e 0a 0a 20 20 20 4d 6f 73 74 20 6f 66 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 64 X......Most.of.these.functions.d
d8c0 6f 20 6e 6f 74 20 73 69 67 6e 61 6c 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 68 65 79 20 63 61 o.not.signal.an.error.if.they.ca
d8e0 6e 6e 6f 74 20 70 65 72 66 6f 72 6d 0a 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6d 6f 64 69 66 nnot.perform.the.requested.modif
d900 69 63 61 74 69 6f 6e 2e 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 69 6e 73 ication...The.functions.that.ins
d920 65 72 74 20 6e 65 77 20 73 75 66 66 69 78 65 73 20 73 68 6f 77 0a 61 20 77 61 72 6e 69 6e 67 20 ert.new.suffixes.show.a.warning.
d940 69 66 20 4c 4f 43 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 50 52 45 46 49 58 if.LOC.cannot.be.found.in.PREFIX
d960 20 77 69 74 68 6f 75 74 20 73 69 67 6e 61 6c 69 6e 67 20 61 6e 20 65 72 72 6f 72 2e 0a 54 68 65 .without.signaling.an.error..The
d980 20 72 65 61 73 6f 6e 20 66 6f 72 20 64 6f 69 6e 67 20 69 74 20 6c 69 6b 65 20 74 68 69 73 20 69 .reason.for.doing.it.like.this.i
d9a0 73 20 74 68 61 74 20 65 73 74 61 62 6c 69 73 68 69 6e 67 20 61 20 6b 65 79 20 62 69 6e 64 69 6e s.that.establishing.a.key.bindin
d9c0 67 0a 28 61 6e 64 20 74 68 61 74 20 69 73 20 77 68 61 74 20 77 65 20 65 73 73 65 6e 74 69 61 6c g.(and.that.is.what.we.essential
d9e0 6c 79 20 61 72 65 20 74 72 79 69 6e 67 20 74 6f 20 64 6f 20 68 65 72 65 29 20 73 68 6f 75 6c 64 ly.are.trying.to.do.here).should
da00 20 6e 6f 74 0a 70 72 65 76 65 6e 74 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 63 6f 6e .not.prevent.the.rest.of.the.con
da20 66 69 67 75 72 61 74 69 6f 6e 20 66 72 6f 6d 20 6c 6f 61 64 69 6e 67 2e 20 20 41 6d 6f 6e 67 20 figuration.from.loading...Among.
da40 74 68 65 73 65 0a 66 75 6e 63 74 69 6f 6e 73 20 6f 6e 6c 79 20 e2 80 98 74 72 61 6e 73 69 65 6e these.functions.only....transien
da60 74 2d 67 65 74 2d 73 75 66 66 69 78 e2 80 99 20 61 6e 64 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 t-get-suffix....and....transient
da80 2d 73 75 66 66 69 78 2d 70 75 74 e2 80 99 20 73 69 67 6e 61 6c 0a 61 6e 20 65 72 72 6f 72 20 62 -suffix-put....signal.an.error.b
daa0 79 20 64 65 66 61 75 6c 74 2e 20 20 49 66 20 79 6f 75 20 72 65 61 6c 6c 79 20 77 61 6e 74 20 74 y.default...If.you.really.want.t
dac0 68 65 20 69 6e 73 65 72 74 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 61 6c 73 6f 0a 73 69 67 6e he.insert.functions.to.also.sign
dae0 61 6c 20 61 6e 20 65 72 72 6f 72 2c 20 73 65 74 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 65 72 al.an.error,.set....transient-er
db00 72 6f 72 2d 6f 6e 2d 69 6e 73 65 72 74 2d 66 61 69 6c 75 72 65 e2 80 99 20 74 6f 20 e2 80 98 74 ror-on-insert-failure....to....t
db20 e2 80 99 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e ........File:.doci3EOZM.info,..N
db40 6f 64 65 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 4e 65 78 ode:.Defining.New.Commands,..Nex
db60 74 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 2c 20 20 50 72 65 76 3a 20 4d t:.Classes.and.Methods,..Prev:.M
db80 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 55 odifying.Existing.Transients,..U
dba0 70 3a 20 54 6f 70 0a 0a 34 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 0a p:.Top..4.Defining.New.Commands.
dbc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 2a 20 4d 65 6e 75 3a ***********************..*.Menu:
dbe0 0a 0a 2a 20 54 65 63 68 6e 69 63 61 6c 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3a 3a 0a 2a 20 44 ..*.Technical.Introduction::.*.D
dc00 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 3a 3a 0a 2a 20 42 69 6e 64 69 6e 67 20 53 efining.Transients::.*.Binding.S
dc20 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 3a 3a 0a 2a 20 44 65 66 uffix.and.Infix.Commands::.*.Def
dc40 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 3a ining.Suffix.and.Infix.Commands:
dc60 3a 0a 2a 20 55 73 69 6e 67 20 49 6e 66 69 78 20 41 72 67 75 6d 65 6e 74 73 3a 3a 0a 2a 20 55 73 :.*.Using.Infix.Arguments::.*.Us
dc80 69 6e 67 20 50 72 65 66 69 78 20 53 63 6f 70 65 3a 3a 0a 2a 20 43 75 72 72 65 6e 74 20 53 75 66 ing.Prefix.Scope::.*.Current.Suf
dca0 66 69 78 20 43 6f 6d 6d 61 6e 64 3a 3a 0a 2a 20 43 75 72 72 65 6e 74 20 50 72 65 66 69 78 20 43 fix.Command::.*.Current.Prefix.C
dcc0 6f 6d 6d 61 6e 64 3a 3a 0a 2a 20 54 72 61 6e 73 69 65 6e 74 20 53 74 61 74 65 3a 3a 0a 0a 1f 0a ommand::.*.Transient.State::....
dce0 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 54 65 63 File:.doci3EOZM.info,..Node:.Tec
dd00 68 6e 69 63 61 6c 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 2c 20 20 4e 65 78 74 3a 20 44 65 66 69 hnical.Introduction,..Next:.Defi
dd20 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 55 70 3a 20 44 65 66 69 6e 69 6e 67 20 4e ning.Transients,..Up:.Defining.N
dd40 65 77 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 2e 31 20 54 65 63 68 6e 69 63 61 6c 20 49 6e 74 72 6f ew.Commands..4.1.Technical.Intro
dd60 64 75 63 74 69 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d duction.========================
dd80 3d 3d 0a 0a 54 61 6b 69 6e 67 20 69 6e 73 70 69 72 61 74 69 6f 6e 20 66 72 6f 6d 20 70 72 65 66 ==..Taking.inspiration.from.pref
dda0 69 78 20 6b 65 79 73 20 61 6e 64 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2c 20 54 72 ix.keys.and.prefix.arguments,.Tr
ddc0 61 6e 73 69 65 6e 74 0a 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 73 69 6d 69 6c 61 72 20 61 62 73 ansient.implements.a.similar.abs
dde0 74 72 61 63 74 69 6f 6e 20 69 6e 76 6f 6c 76 69 6e 67 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d traction.involving.a.prefix.comm
de00 61 6e 64 2c 20 69 6e 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 20 73 75 66 66 69 78 20 and,.infix.arguments.and.suffix.
de20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 20 20 57 68 65 6e 20 74 68 65 20 75 73 65 72 20 63 61 6c 6c commands......When.the.user.call
de40 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 s.a.transient.prefix.command,.a.
de60 74 72 61 6e 73 69 65 6e 74 0a 28 74 65 6d 70 6f 72 61 72 79 29 20 6b 65 79 6d 61 70 20 69 73 20 transient.(temporary).keymap.is.
de80 61 63 74 69 76 61 74 65 64 2c 20 77 68 69 63 68 20 62 69 6e 64 73 20 74 68 65 20 74 72 61 6e 73 activated,.which.binds.the.trans
dea0 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 20 61 6e 64 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e ient...s.infix.and.suffix.comman
dec0 64 73 2c 20 61 6e 64 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 63 6f 6e 74 72 6f 6c 20 74 ds,.and.functions.that.control.t
dee0 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 61 72 65 0a 61 64 64 65 64 20 74 6f 20 he.transient.state.are.added.to.
df00 e2 80 98 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b e2 80 99 20 61 6e 64 20 e2 80 98 70 6f ...pre-command-hook....and....po
df20 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b e2 80 99 2e 20 20 54 68 65 20 61 76 61 69 6c 61 62 st-command-hook......The.availab
df40 6c 65 0a 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 le.suffix.and.infix.commands.and
df60 20 74 68 65 69 72 20 73 74 61 74 65 20 61 72 65 20 73 68 6f 77 6e 20 69 6e 20 61 20 6d 65 6e 75 .their.state.are.shown.in.a.menu
df80 20 62 75 66 66 65 72 0a 75 6e 74 69 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 .buffer.until.the.transient.stat
dfa0 65 20 69 73 20 65 78 69 74 65 64 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 61 20 73 75 66 66 69 78 e.is.exited.by.invoking.a.suffix
dfc0 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 43 61 6c 6c 69 6e 67 20 61 6e 20 69 6e 66 69 78 20 63 .command......Calling.an.infix.c
dfe0 6f 6d 6d 61 6e 64 20 63 61 75 73 65 73 20 69 74 73 20 76 61 6c 75 65 20 74 6f 20 62 65 20 63 68 ommand.causes.its.value.to.be.ch
e000 61 6e 67 65 64 2e 20 20 48 6f 77 20 74 68 61 74 20 69 73 0a 64 6f 6e 65 20 64 65 70 65 6e 64 73 anged...How.that.is.done.depends
e020 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e .on.the.type.of.the.infix.comman
e040 64 2e 20 20 54 68 65 20 73 69 6d 70 6c 65 73 74 20 63 61 73 65 20 69 73 20 61 6e 0a 69 6e 66 69 d...The.simplest.case.is.an.infi
e060 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 63 6f 6d 6d x.command.that.represents.a.comm
e080 61 6e 64 2d 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 and-line.argument.that.does.not.
e0a0 74 61 6b 65 0a 61 20 76 61 6c 75 65 2e 20 20 49 6e 76 6f 6b 69 6e 67 20 73 75 63 68 20 61 6e 20 take.a.value...Invoking.such.an.
e0c0 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 75 73 65 73 20 74 68 65 20 73 77 69 74 63 68 20 infix.command.causes.the.switch.
e0e0 74 6f 20 62 65 20 74 6f 67 67 6c 65 64 0a 6f 6e 20 6f 72 20 6f 66 66 2e 20 20 4d 6f 72 65 20 63 to.be.toggled.on.or.off...More.c
e100 6f 6d 70 6c 65 78 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 6d 61 79 20 72 65 61 64 20 61 omplex.infix.commands.may.read.a
e120 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 75 73 65 72 2c 0a 75 73 69 6e 67 20 74 68 65 20 .value.from.the.user,.using.the.
e140 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 20 20 20 43 61 6c 6c 69 6e 67 20 61 20 73 75 66 66 69 78 minibuffer......Calling.a.suffix
e160 20 63 6f 6d 6d 61 6e 64 20 75 73 75 61 6c 6c 79 20 63 61 75 73 65 73 20 74 68 65 20 74 72 61 6e .command.usually.causes.the.tran
e180 73 69 65 6e 74 20 74 6f 20 62 65 20 65 78 69 74 65 64 3b 0a 74 68 65 20 74 72 61 6e 73 69 65 6e sient.to.be.exited;.the.transien
e1a0 74 20 6b 65 79 6d 61 70 73 20 61 6e 64 20 68 6f 6f 6b 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 t.keymaps.and.hook.functions.are
e1c0 20 72 65 6d 6f 76 65 64 2c 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 6e 6f 0a 6c 6f 6e .removed,.the.menu.buffer.no.lon
e1e0 67 65 72 20 73 68 6f 77 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 ger.shows.information.about.the.
e200 28 6e 6f 20 6c 6f 6e 67 65 72 20 62 6f 75 6e 64 29 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 (no.longer.bound).suffix.command
e220 73 2c 0a 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 6f 6d 65 20 70 75 62 6c 69 63 20 67 6c 6f s,.the.values.of.some.public.glo
e240 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 73 65 74 2c 20 77 68 69 6c 65 20 73 6f 6d bal.variables.are.set,.while.som
e260 65 20 69 6e 74 65 72 6e 61 6c 0a 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 e.internal.global.variables.are.
e280 75 6e 73 65 74 2c 20 61 6e 64 20 66 69 6e 61 6c 6c 79 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 69 unset,.and.finally.the.command.i
e2a0 73 20 61 63 74 75 61 6c 6c 79 20 63 61 6c 6c 65 64 2e 0a 53 75 66 66 69 78 20 63 6f 6d 6d 61 6e s.actually.called..Suffix.comman
e2c0 64 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 63 6f 6e 66 69 67 75 72 65 64 20 74 6f 20 6e 6f 74 ds.can.also.be.configured.to.not
e2e0 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 20 41 20 73 75 66 66 69 .exit.the.transient......A.suffi
e300 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 x.command.can,.but.does.not.have
e320 20 74 6f 2c 20 75 73 65 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 0a 69 6e 20 .to,.use.the.infix.arguments.in.
e340 6d 75 63 68 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 6e 79 20 63 6f 6d 6d 61 6e 64 20 63 61 much.the.same.way.any.command.ca
e360 6e 20 63 68 6f 6f 73 65 20 74 6f 20 75 73 65 20 6f 72 20 69 67 6e 6f 72 65 20 74 68 65 20 70 72 n.choose.to.use.or.ignore.the.pr
e380 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 2e 20 20 46 6f 72 20 61 20 73 75 66 66 69 78 20 63 6f efix.arguments...For.a.suffix.co
e3a0 6d 6d 61 6e 64 20 74 68 61 74 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 61 20 74 72 mmand.that.was.invoked.from.a.tr
e3c0 61 6e 73 69 65 6e 74 2c 20 74 68 65 0a 76 61 72 69 61 62 6c 65 20 e2 80 98 74 72 61 6e 73 69 65 ansient,.the.variable....transie
e3e0 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 e2 80 99 20 61 6e 64 20 74 68 65 20 66 nt-current-suffixes....and.the.f
e400 75 6e 63 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 0a 73 65 72 unction....transient-args....ser
e420 76 65 20 61 62 6f 75 74 20 74 68 65 20 73 61 6d 65 20 70 75 72 70 6f 73 65 20 61 73 20 74 68 65 ve.about.the.same.purpose.as.the
e440 20 76 61 72 69 61 62 6c 65 73 20 e2 80 98 70 72 65 66 69 78 2d 61 72 67 e2 80 99 20 61 6e 64 0a .variables....prefix-arg....and.
e460 e2 80 98 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 2d 61 72 67 e2 80 99 20 64 6f 20 66 6f 72 20 ...current-prefix-arg....do.for.
e480 61 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 77 61 73 20 63 61 6c 6c 65 64 20 61 66 74 65 any.command.that.was.called.afte
e4a0 72 20 74 68 65 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 20 68 61 76 65 20 62 65 65 6e r.the.prefix.arguments.have.been
e4c0 20 73 65 74 20 75 73 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 73 75 63 68 20 61 73 20 e2 80 98 .set.using.a.command.such.as....
e4e0 75 6e 69 76 65 72 73 61 6c 2d 61 72 67 75 6d 65 6e 74 e2 80 99 2e 0a 0a 20 20 20 54 72 61 6e 73 universal-argument.........Trans
e500 69 65 6e 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 ient.can.be.used.to.implement.si
e520 6d 70 6c 65 20 e2 80 9c 63 6f 6d 6d 61 6e 64 20 64 69 73 70 61 74 63 68 65 72 73 e2 80 9d 2e 20 mple....command.dispatchers.....
e540 20 54 68 65 0a 6d 61 69 6e 20 62 65 6e 65 66 69 74 20 74 68 65 6e 20 69 73 20 74 68 61 74 20 74 .The.main.benefit.then.is.that.t
e560 68 65 20 75 73 65 72 20 63 61 6e 20 73 65 65 20 61 6c 6c 20 74 68 65 20 61 76 61 69 6c 61 62 6c he.user.can.see.all.the.availabl
e580 65 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 0a 61 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 e.commands.in.a.temporarily.show
e5a0 6e 20 62 75 66 66 65 72 2c 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 74 68 6f 75 67 68 74 20 6f n.buffer,.which.can.be.thought.o
e5c0 66 20 61 73 20 61 20 e2 80 9c 6d 65 6e 75 e2 80 9d 2e 20 20 54 68 61 74 0a 69 73 20 75 73 65 66 f.as.a....menu......That.is.usef
e5e0 75 6c 20 62 79 20 69 74 73 65 6c 66 20 62 65 63 61 75 73 65 20 69 74 20 66 72 65 65 73 20 74 68 ul.by.itself.because.it.frees.th
e600 65 20 75 73 65 72 20 66 72 6f 6d 20 68 61 76 69 6e 67 20 74 6f 20 72 65 6d 65 6d 62 65 72 0a 61 e.user.from.having.to.remember.a
e620 6c 6c 20 74 68 65 20 6b 65 79 73 20 74 68 61 74 20 61 72 65 20 76 61 6c 69 64 20 61 66 74 65 72 ll.the.keys.that.are.valid.after
e640 20 61 20 63 65 72 74 61 69 6e 20 70 72 65 66 69 78 20 6b 65 79 20 6f 72 20 63 6f 6d 6d 61 6e 64 .a.certain.prefix.key.or.command
e660 2e 0a 4d 61 67 69 74 e2 80 99 73 20 e2 80 98 6d 61 67 69 74 2d 64 69 73 70 61 74 63 68 e2 80 99 ..Magit...s....magit-dispatch...
e680 20 28 6f 6e 20 e2 80 98 43 2d 78 20 4d 2d 67 e2 80 99 29 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 .(on....C-x.M-g...).command.is.a
e6a0 6e 20 65 78 61 6d 70 6c 65 20 6f 66 20 75 73 69 6e 67 0a 54 72 61 6e 73 69 65 6e 74 20 74 6f 20 n.example.of.using.Transient.to.
e6c0 6d 65 72 65 6c 79 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 63 6f 6d 6d 61 6e 64 20 64 69 73 70 61 merely.implement.a.command.dispa
e6e0 74 63 68 65 72 2e 0a 0a 20 20 20 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 61 74 2c 20 tcher......In.addition.to.that,.
e700 54 72 61 6e 73 69 65 6e 74 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 75 73 65 72 73 20 74 6f 20 69 Transient.also.allows.users.to.i
e720 6e 74 65 72 61 63 74 69 76 65 6c 79 0a 70 61 73 73 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 63 nteractively.pass.arguments.to.c
e740 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 20 63 61 6e 20 62 65 ommands...These.arguments.can.be
e760 20 6d 75 63 68 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 0a 74 68 61 6e 20 77 68 61 74 20 69 73 20 .much.more.complex.than.what.is.
e780 72 65 61 73 6f 6e 61 62 6c 65 20 77 68 65 6e 20 75 73 69 6e 67 20 70 72 65 66 69 78 20 61 72 67 reasonable.when.using.prefix.arg
e7a0 75 6d 65 6e 74 73 2e 20 20 54 68 65 72 65 20 69 73 20 61 20 6c 69 6d 69 74 0a 74 6f 20 68 6f 77 uments...There.is.a.limit.to.how
e7c0 20 6d 61 6e 79 20 61 73 70 65 63 74 73 20 6f 66 20 61 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 .many.aspects.of.a.command.can.b
e7e0 65 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 75 73 69 6e 67 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 e.controlled.using.prefix.argume
e800 6e 74 73 2e 20 20 46 75 72 74 68 65 72 6d 6f 72 65 2c 20 77 68 61 74 20 61 20 63 65 72 74 61 69 nts...Furthermore,.what.a.certai
e820 6e 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 6d 65 61 6e 73 20 66 6f 72 0a 64 69 66 66 n.prefix.argument.means.for.diff
e840 65 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 63 6f 6d 70 6c 65 74 65 6c 79 erent.commands.can.be.completely
e860 20 64 69 66 66 65 72 65 6e 74 2c 20 61 6e 64 20 75 73 65 72 73 20 68 61 76 65 20 74 6f 20 72 65 .different,.and.users.have.to.re
e880 61 64 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 6c 65 61 72 6e 20 61 6e 64 20 74 68 ad.documentation.to.learn.and.th
e8a0 65 6e 20 63 6f 6d 6d 69 74 20 74 6f 20 6d 65 6d 6f 72 79 20 77 68 61 74 20 61 20 63 65 72 74 61 en.commit.to.memory.what.a.certa
e8c0 69 6e 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 20 6d 65 61 6e 73 20 74 6f 20 61 20 63 65 in.prefix.argument.means.to.a.ce
e8e0 72 74 61 69 6e 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 54 72 61 6e 73 69 65 6e 74 20 73 75 66 rtain.command......Transient.suf
e900 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c fix.commands,.on.the.other.hand,
e920 20 63 61 6e 20 61 63 63 65 70 74 20 64 6f 7a 65 6e 73 20 6f 66 0a 64 69 66 66 65 72 65 6e 74 20 .can.accept.dozens.of.different.
e940 61 72 67 75 6d 65 6e 74 73 20 77 69 74 68 6f 75 74 20 74 68 65 20 75 73 65 72 20 68 61 76 69 6e arguments.without.the.user.havin
e960 67 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 61 6e 79 74 68 69 6e 67 2e 20 20 57 68 65 6e 0a 75 73 g.to.remember.anything...When.us
e980 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 2c 20 6f 6e 65 20 63 61 6e 20 63 61 6c 6c 20 61 20 63 6f ing.Transient,.one.can.call.a.co
e9a0 6d 6d 61 6e 64 20 77 69 74 68 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 61 72 65 20 6a 75 mmand.with.arguments.that.are.ju
e9c0 73 74 20 61 73 0a 63 6f 6d 70 6c 65 78 20 61 73 20 77 68 65 6e 20 63 61 6c 6c 69 6e 67 20 74 68 st.as.complex.as.when.calling.th
e9e0 65 20 73 61 6d 65 20 66 75 6e 63 74 69 6f 6e 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 6c e.same.function.non-interactivel
ea00 79 20 66 72 6f 6d 20 4c 69 73 70 2e 0a 0a 20 20 20 49 6e 76 6f 6b 69 6e 67 20 61 20 74 72 61 6e y.from.Lisp......Invoking.a.tran
ea20 73 69 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 72 67 75 6d 65 sient.suffix.command.with.argume
ea40 6e 74 73 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 0a 69 6e 76 6f 6b 69 6e 67 20 61 20 63 6f 6d nts.is.similar.to.invoking.a.com
ea60 6d 61 6e 64 20 69 6e 20 61 20 73 68 65 6c 6c 20 77 69 74 68 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e mand.in.a.shell.with.command-lin
ea80 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 61 6e 64 20 68 69 73 74 6f 72 79 0a 65 6e 61 62 6c 65 64 e.completion.and.history.enabled
eaa0 2e 20 20 4f 6e 65 20 62 65 6e 65 66 69 74 20 6f 66 20 74 68 65 20 54 72 61 6e 73 69 65 6e 74 20 ...One.benefit.of.the.Transient.
eac0 69 6e 74 65 72 66 61 63 65 20 69 73 20 74 68 61 74 20 69 74 20 72 65 6d 65 6d 62 65 72 73 0a 68 interface.is.that.it.remembers.h
eae0 69 73 74 6f 72 79 20 6e 6f 74 20 6f 6e 6c 79 20 6f 6e 20 61 20 67 6c 6f 62 61 6c 20 6c 65 76 65 istory.not.only.on.a.global.leve
eb00 6c 20 28 e2 80 9c 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 75 l.(...this.command.was.invoked.u
eb20 73 69 6e 67 0a 74 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 70 72 65 76 69 6f sing.these.arguments,.and.previo
eb40 75 73 6c 79 20 69 74 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 75 73 69 6e 67 20 74 68 6f 73 65 20 usly.it.was.invoked.using.those.
eb60 6f 74 68 65 72 0a 61 72 67 75 6d 65 6e 74 73 e2 80 9d 29 2c 20 62 75 74 20 61 6c 73 6f 20 72 65 other.arguments...),.but.also.re
eb80 6d 65 6d 62 65 72 73 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c members.the.values.of.individual
eba0 20 61 72 67 75 6d 65 6e 74 73 0a 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 2e 20 20 53 65 65 20 2a .arguments.independently...See.*
ebc0 6e 6f 74 65 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 3a 3a 2e 0a 0a 20 20 20 41 66 74 65 72 20 note.Using.History::......After.
ebe0 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e a.transient.prefix.command.is.in
ec00 76 6f 6b 65 64 2c 20 e2 80 98 43 2d 68 20 4b 45 59 e2 80 99 20 63 61 6e 20 62 65 20 75 73 65 64 voked,....C-h.KEY....can.be.used
ec20 20 74 6f 0a 73 68 6f 77 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 .to.show.the.documentation.for.t
ec40 68 65 20 69 6e 66 69 78 20 6f 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 he.infix.or.suffix.command.that.
ec60 e2 80 98 4b 45 59 e2 80 99 20 69 73 0a 62 6f 75 6e 64 20 74 6f 20 28 73 65 65 20 2a 6e 6f 74 65 ...KEY....is.bound.to.(see.*note
ec80 20 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 6f 72 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 .Getting.Help.for.Suffix.Command
eca0 73 3a 3a 29 2c 20 61 6e 64 20 69 6e 66 69 78 65 73 20 61 6e 64 0a 73 75 66 66 69 78 65 73 20 63 s::),.and.infixes.and.suffixes.c
ecc0 61 6e 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 an.be.removed.from.the.transient
ece0 20 75 73 69 6e 67 20 e2 80 98 43 2d 78 20 6c 20 4b 45 59 e2 80 99 2e 20 20 49 6e 66 69 78 65 73 .using....C-x.l.KEY......Infixes
ed00 0a 61 6e 64 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 65 20 64 69 73 61 62 6c 65 64 20 .and.suffixes.that.are.disabled.
ed20 62 79 20 64 65 66 61 75 6c 74 20 63 61 6e 20 62 65 20 65 6e 61 62 6c 65 64 20 74 68 65 20 73 61 by.default.can.be.enabled.the.sa
ed40 6d 65 20 77 61 79 2e 0a 53 65 65 20 2a 6e 6f 74 65 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 me.way..See.*note.Enabling.and.D
ed60 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 2e 0a 0a 20 20 20 54 72 61 6e 73 69 65 isabling.Suffixes::......Transie
ed80 6e 74 20 73 68 69 70 73 20 77 69 74 68 20 73 75 70 70 6f 72 74 20 66 6f 72 20 61 20 66 65 77 20 nt.ships.with.support.for.a.few.
eda0 64 69 66 66 65 72 65 6e 74 20 74 79 70 65 73 20 6f 66 20 73 70 65 63 69 61 6c 69 7a 65 64 0a 69 different.types.of.specialized.i
edc0 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 41 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 73 nfix.commands...A.command.that.s
ede0 65 74 73 20 61 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e 2c 20 66 6f 72 20 65 ets.a.command.line.option,.for.e
ee00 78 61 6d 70 6c 65 2c 0a 68 61 73 20 64 69 66 66 65 72 65 6e 74 20 6e 65 65 64 73 20 74 68 61 6e xample,.has.different.needs.than
ee20 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 6d 65 72 65 6c 79 20 74 6f 67 67 6c 65 73 20 61 .a.command.that.merely.toggles.a
ee40 20 62 6f 6f 6c 65 61 6e 20 66 6c 61 67 2e 0a 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 54 72 61 .boolean.flag..Additionally,.Tra
ee60 6e 73 69 65 6e 74 20 70 72 6f 76 69 64 65 73 20 61 62 73 74 72 61 63 74 69 6f 6e 73 20 66 6f 72 nsient.provides.abstractions.for
ee80 20 64 65 66 69 6e 69 6e 67 20 6e 65 77 20 74 79 70 65 73 2c 0a 77 68 69 63 68 20 74 68 65 20 61 .defining.new.types,.which.the.a
eea0 75 74 68 6f 72 20 6f 66 20 54 72 61 6e 73 69 65 6e 74 20 64 69 64 20 6e 6f 74 20 61 6e 74 69 63 uthor.of.Transient.did.not.antic
eec0 69 70 61 74 65 20 28 6f 72 20 64 69 64 6e e2 80 99 74 20 67 65 74 20 61 72 6f 75 6e 64 0a 74 6f ipate.(or.didn...t.get.around.to
eee0 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 79 65 74 29 2e 0a 0a 20 20 20 4e 6f 74 65 20 74 68 61 .implementing.yet)......Note.tha
ef00 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 6c 73 6f 20 73 75 70 70 6f 72 74 20 72 t.suffix.commands.also.support.r
ef20 65 67 75 6c 61 72 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 41 0a 73 75 66 66 egular.prefix.arguments...A.suff
ef40 69 78 20 63 6f 6d 6d 61 6e 64 20 6d 61 79 20 65 76 65 6e 20 62 65 20 63 61 6c 6c 65 64 20 77 69 ix.command.may.even.be.called.wi
ef60 74 68 20 62 6f 74 68 20 69 6e 66 69 78 20 61 6e 64 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e th.both.infix.and.prefix.argumen
ef80 74 73 0a 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 49 66 20 79 6f 75 20 69 6e 76 ts.at.the.same.time...If.you.inv
efa0 6f 6b 65 20 61 20 63 6f 6d 6d 61 6e 64 20 61 73 20 61 20 73 75 66 66 69 78 20 6f 66 20 61 20 74 oke.a.command.as.a.suffix.of.a.t
efc0 72 61 6e 73 69 65 6e 74 0a 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 62 75 74 20 61 6c 73 ransient.prefix.command,.but.als
efe0 6f 20 77 61 6e 74 20 74 6f 20 70 61 73 73 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 o.want.to.pass.prefix.arguments.
f000 74 6f 20 69 74 2c 20 74 68 65 6e 20 66 69 72 73 74 0a 69 6e 76 6f 6b 65 20 74 68 65 20 70 72 65 to.it,.then.first.invoke.the.pre
f020 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 6f 6e 6c 79 20 61 66 74 65 72 20 64 6f 69 6e fix.command,.and.only.after.doin
f040 67 20 74 68 61 74 20 69 6e 76 6f 6b 65 20 74 68 65 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e g.that.invoke.the.prefix.argumen
f060 74 73 2c 20 62 65 66 6f 72 65 20 66 69 6e 61 6c 6c 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 ts,.before.finally.invoking.the.
f080 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 49 66 20 79 6f 75 20 69 6e 73 74 65 61 64 0a suffix.command...If.you.instead.
f0a0 62 65 67 61 6e 20 62 79 20 70 72 6f 76 69 64 69 6e 67 20 74 68 65 20 70 72 65 66 69 78 20 61 72 began.by.providing.the.prefix.ar
f0c0 67 75 6d 65 6e 74 73 2c 20 74 68 65 6e 20 74 68 6f 73 65 20 77 6f 75 6c 64 20 61 70 70 6c 79 20 guments,.then.those.would.apply.
f0e0 74 6f 20 74 68 65 0a 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 6e 6f 74 20 74 68 65 20 73 to.the.prefix.command,.not.the.s
f100 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 4c 69 6b 65 77 69 73 65 2c 20 69 66 20 79 6f 75 uffix.command...Likewise,.if.you
f120 20 77 61 6e 74 20 74 6f 20 63 68 61 6e 67 65 0a 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 .want.to.change.infix.arguments.
f140 62 65 66 6f 72 65 20 69 6e 76 6f 6b 69 6e 67 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 before.invoking.a.suffix.command
f160 20 77 69 74 68 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2c 0a 74 68 65 6e 20 63 68 61 .with.prefix.arguments,.then.cha
f180 6e 67 65 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 62 65 66 6f 72 65 20 69 nge.the.infix.arguments.before.i
f1a0 6e 76 6f 6b 69 6e 67 20 74 68 65 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 0a 49 6e nvoking.the.prefix.arguments..In
f1c0 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 72 65 67 75 6c 61 72 20 70 72 65 66 69 78 20 61 72 67 .other.words,.regular.prefix.arg
f1e0 75 6d 65 6e 74 73 20 61 6c 77 61 79 73 20 61 70 70 6c 79 20 74 6f 20 74 68 65 20 6e 65 78 74 0a uments.always.apply.to.the.next.
f200 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 73 69 6e 63 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 command,.and.since.transient.pre
f220 66 69 78 2c 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 fix,.infix.and.suffix.commands.a
f240 72 65 20 6a 75 73 74 0a 72 65 67 75 6c 61 72 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 65 20 73 61 re.just.regular.commands,.the.sa
f260 6d 65 20 61 70 70 6c 69 65 73 20 74 6f 20 74 68 65 6d 2e 20 20 28 52 65 67 75 6c 61 72 20 70 72 me.applies.to.them...(Regular.pr
f280 65 66 69 78 20 6b 65 79 73 20 62 65 68 61 76 65 0a 64 69 66 66 65 72 65 6e 74 6c 79 20 62 65 63 efix.keys.behave.differently.bec
f2a0 61 75 73 65 20 74 68 65 79 20 61 72 65 20 6e 6f 74 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 61 6c ause.they.are.not.commands.at.al
f2c0 6c 2c 20 69 6e 73 74 65 61 64 20 74 68 65 79 20 61 72 65 20 6a 75 73 74 0a 69 6e 63 6f 6d 70 6c l,.instead.they.are.just.incompl
f2e0 65 74 65 20 6b 65 79 20 73 65 71 75 65 6e 63 65 73 2c 20 61 6e 64 20 74 68 6f 73 65 20 63 61 6e ete.key.sequences,.and.those.can
f300 6e 6f 74 20 62 65 20 69 6e 74 65 72 72 75 70 74 65 64 20 77 69 74 68 20 70 72 65 66 69 78 0a 63 not.be.interrupted.with.prefix.c
f320 6f 6d 6d 61 6e 64 73 2e 29 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 ommands.)....File:.doci3EOZM.inf
f340 6f 2c 20 20 4e 6f 64 65 3a 20 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 o,..Node:.Defining.Transients,..
f360 4e 65 78 74 3a 20 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 Next:.Binding.Suffix.and.Infix.C
f380 6f 6d 6d 61 6e 64 73 2c 20 20 50 72 65 76 3a 20 54 65 63 68 6e 69 63 61 6c 20 49 6e 74 72 6f 64 ommands,..Prev:.Technical.Introd
f3a0 75 63 74 69 6f 6e 2c 20 20 55 70 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e uction,..Up:.Defining.New.Comman
f3c0 64 73 0a 0a 34 2e 32 20 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 0a 3d 3d 3d 3d ds..4.2.Defining.Transients.====
f3e0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 41 20 74 72 61 6e 73 69 65 6e 74 ===================..A.transient
f400 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 6e .consists.of.a.prefix.command.an
f420 64 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 73 75 66 66 69 78 0a 63 6f 6d 6d 61 6e 64 2c 20 74 d.at.least.one.suffix.command,.t
f440 68 6f 75 67 68 20 75 73 75 61 6c 6c 79 20 61 20 74 72 61 6e 73 69 65 6e 74 20 68 61 73 20 73 65 hough.usually.a.transient.has.se
f460 76 65 72 61 6c 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 2e veral.infix.and.suffix.commands.
f480 20 20 54 68 65 20 62 65 6c 6f 77 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 20 74 68 65 20 74 72 ..The.below.macro.defines.the.tr
f4a0 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 2a 61 6e 64 2a 0a 62 69 6e ansient.prefix.command.*and*.bin
f4c0 64 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 20 61 6e 64 20 73 ds.the.transient...s.infix.and.s
f4e0 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c uffix.commands...In.other.words,
f500 20 69 74 0a 64 65 66 69 6e 65 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 72 61 6e 73 69 65 .it.defines.the.complete.transie
f520 6e 74 2c 20 6e 6f 74 20 6a 75 73 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 nt,.not.just.the.transient.prefi
f540 78 20 63 6f 6d 6d 61 6e 64 0a 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e 76 6f 6b 65 x.command.that.is.used.to.invoke
f560 20 74 68 61 74 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 4d 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 .that.transient...Macro:.transie
f580 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 20 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 5b 64 nt-define-prefix.name.arglist.[d
f5a0 6f 63 73 74 72 69 6e 67 5d 20 5b 6b 65 79 77 6f 72 64 20 76 61 6c 75 65 5d 2e 2e 2e 20 67 72 6f ocstring].[keyword.value]....gro
f5c0 75 70 2e 2e 2e 20 5b 62 6f 64 79 2e 2e 2e 5d 0a 20 20 20 20 20 54 68 69 73 20 6d 61 63 72 6f 20 up....[body...]......This.macro.
f5e0 64 65 66 69 6e 65 73 20 4e 41 4d 45 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 defines.NAME.as.a.transient.pref
f600 69 78 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 62 69 6e 64 73 20 74 68 65 0a 20 20 20 20 20 74 72 ix.command.and.binds.the......tr
f620 61 6e 73 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d ansient...s.infix.and.suffix.com
f640 6d 61 6e 64 73 2e 0a 0a 20 20 20 20 20 41 52 47 4c 49 53 54 20 61 72 65 20 74 68 65 20 61 72 67 mands........ARGLIST.are.the.arg
f660 75 6d 65 6e 74 73 20 74 68 61 74 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 uments.that.the.prefix.command.t
f680 61 6b 65 73 2e 20 20 44 4f 43 53 54 52 49 4e 47 0a 20 20 20 20 20 69 73 20 74 68 65 20 64 6f 63 akes...DOCSTRING......is.the.doc
f6a0 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 61 6e 64 20 69 73 20 6f 70 74 69 6f 6e 61 umentation.string.and.is.optiona
f6c0 6c 2e 0a 0a 20 20 20 20 20 54 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 20 63 61 6e 20 6f 70 74 l........These.arguments.can.opt
f6e0 69 6f 6e 61 6c 6c 79 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6b 65 79 77 6f 72 64 2d 76 ionally.be.followed.by.keyword-v
f700 61 6c 75 65 20 70 61 69 72 73 2e 0a 20 20 20 20 20 45 61 63 68 20 6b 65 79 20 68 61 73 20 74 6f alue.pairs.......Each.key.has.to
f720 20 62 65 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 e2 80 98 .be.a.keyword.symbol,.either....
f740 3a 63 6c 61 73 73 e2 80 99 20 6f 72 20 61 20 6b 65 79 77 6f 72 64 0a 20 20 20 20 20 61 72 67 75 :class....or.a.keyword......argu
f760 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 63 6f 6e 73 74 72 75 63 74 6f ment.supported.by.the.constructo
f780 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 20 20 54 68 65 0a 20 20 20 20 20 e2 80 98 74 72 r.of.that.class...The.........tr
f7a0 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 e2 80 99 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 ansient-prefix....class.is.used.
f7c0 69 66 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 0a 20 20 if.the.class.is.not.specified...
f7e0 20 20 20 65 78 70 6c 69 63 69 74 6c 79 2e 0a 0a 20 20 20 20 20 47 52 4f 55 50 73 20 61 64 64 20 ...explicitly........GROUPs.add.
f800 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 key.bindings.for.infix.and.suffi
f820 78 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 73 70 65 63 69 66 79 0a 20 20 20 20 20 68 6f 77 20 x.commands.and.specify......how.
f840 74 68 65 73 65 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 70 72 65 73 65 6e 74 65 64 20 69 6e 20 these.bindings.are.presented.in.
f860 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 0a 20 the.menu.buffer...At.least.one..
f880 20 20 20 20 47 52 4f 55 50 20 68 61 73 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 2e 20 20 ....GROUP.has.to.be.specified...
f8a0 53 65 65 20 2a 6e 6f 74 65 20 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 See.*note.Binding.Suffix.and.Inf
f8c0 69 78 0a 20 20 20 20 20 43 6f 6d 6d 61 6e 64 73 3a 3a 2e 0a 0a 20 20 20 20 20 54 68 65 20 42 4f ix......Commands::........The.BO
f8e0 44 59 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 49 66 20 69 74 20 69 73 20 6f 6d 69 74 74 65 DY.is.optional...If.it.is.omitte
f900 64 2c 20 74 68 65 6e 20 41 52 47 4c 49 53 54 20 69 73 20 69 67 6e 6f 72 65 64 0a 20 20 20 20 20 d,.then.ARGLIST.is.ignored......
f920 61 6e 64 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 62 65 63 6f and.the.function.definition.beco
f940 6d 65 73 3a 0a 0a 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 mes:............(lambda.()......
f960 20 20 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 20 20 20 20 20 .......(interactive)............
f980 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 20 27 4e 41 4d 45 29 29 0a 0a 20 20 20 20 20 .(transient-setup.'NAME)).......
f9a0 49 66 20 42 4f 44 59 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 69 74 20 6d 75 If.BODY.is.specified,.then.it.mu
f9c0 73 74 20 62 65 67 69 6e 20 77 69 74 68 20 61 6e 20 e2 80 98 69 6e 74 65 72 61 63 74 69 76 65 e2 st.begin.with.an....interactive.
f9e0 80 99 20 66 6f 72 6d 0a 20 20 20 20 20 74 68 61 74 20 6d 61 74 63 68 65 73 20 41 52 47 4c 49 53 ...form......that.matches.ARGLIS
fa00 54 2c 20 61 6e 64 20 69 74 20 6d 75 73 74 20 63 61 6c 6c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 T,.and.it.must.call....transient
fa20 2d 73 65 74 75 70 e2 80 99 2e 20 20 49 74 20 6d 61 79 2c 0a 20 20 20 20 20 68 6f 77 65 76 65 72 -setup......It.may,......however
fa40 2c 20 63 61 6c 6c 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 6c 79 20 77 68 65 6e 20 73 ,.call.that.function.only.when.s
fa60 6f 6d 65 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 73 61 74 69 73 66 69 65 64 2e 0a 0a 20 20 20 ome.condition.is.satisfied......
fa80 20 20 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 68 61 76 65 20 61 20 28 70 6f 73 73 69 62 6c ..All.transients.have.a.(possibl
faa0 79 20 e2 80 98 6e 69 6c e2 80 99 29 20 76 61 6c 75 65 2c 20 77 68 69 63 68 20 69 73 20 65 78 70 y....nil...).value,.which.is.exp
fac0 6f 72 74 65 64 0a 20 20 20 20 20 77 68 65 6e 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 orted......when.suffix.commands.
fae0 61 72 65 20 63 61 6c 6c 65 64 2c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 63 61 6e 20 63 6f 6e are.called,.so.that.they.can.con
fb00 73 75 6d 65 20 74 68 61 74 0a 20 20 20 20 20 76 61 6c 75 65 2e 20 20 46 6f 72 20 73 6f 6d 65 20 sume.that......value...For.some.
fb20 74 72 61 6e 73 69 65 6e 74 73 20 69 74 20 6d 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 transients.it.might.be.necessary
fb40 20 74 6f 20 68 61 76 65 20 61 20 73 6f 72 74 20 6f 66 0a 20 20 20 20 20 73 65 63 6f 6e 64 61 72 .to.have.a.sort.of......secondar
fb60 79 20 76 61 6c 75 65 2c 20 63 61 6c 6c 65 64 20 61 20 e2 80 9c 73 63 6f 70 65 e2 80 9d 2e 20 20 y.value,.called.a....scope......
fb80 53 75 63 68 20 61 20 73 63 6f 70 65 20 77 6f 75 6c 64 20 75 73 75 61 6c 6c 79 20 62 65 0a 20 20 Such.a.scope.would.usually.be...
fba0 20 20 20 73 65 74 20 69 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 e2 80 99 73 20 e2 80 98 69 6e 74 ...set.in.the.command...s....int
fbc0 65 72 61 63 74 69 76 65 e2 80 99 20 66 6f 72 6d 20 61 6e 64 20 68 61 73 20 74 6f 20 62 65 20 70 eractive....form.and.has.to.be.p
fbe0 61 73 73 65 64 20 74 6f 20 74 68 65 0a 20 20 20 20 20 73 65 74 75 70 20 66 75 6e 63 74 69 6f 6e assed.to.the......setup.function
fc00 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 20 27 4e :............(transient-setup.'N
fc20 41 4d 45 20 6e 69 6c 20 6e 69 6c 20 3a 73 63 6f 70 65 20 53 43 4f 50 45 29 0a 0a 20 20 20 20 20 AME.nil.nil.:scope.SCOPE).......
fc40 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 e2 80 For.example,.the.scope.of.the...
fc60 98 6d 61 67 69 74 2d 62 72 61 6e 63 68 2d 63 6f 6e 66 69 67 75 72 65 e2 80 99 20 74 72 61 6e 73 .magit-branch-configure....trans
fc80 69 65 6e 74 20 69 73 0a 20 20 20 20 20 74 68 65 20 62 72 61 6e 63 68 20 77 68 6f 73 65 20 76 61 ient.is......the.branch.whose.va
fca0 72 69 61 62 6c 65 73 20 61 72 65 20 62 65 69 6e 67 20 63 6f 6e 66 69 67 75 72 65 64 2e 0a 0a 20 riables.are.being.configured....
fcc0 20 20 53 6f 6d 65 74 69 6d 65 73 20 6d 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 20 63 6f 6d 6d ..Sometimes.multiple.prefix.comm
fce0 61 6e 64 73 20 73 68 61 72 65 20 61 20 63 6f 6d 6d 6f 6e 20 73 65 74 20 6f 66 20 73 75 66 66 69 ands.share.a.common.set.of.suffi
fd00 78 65 73 2e 0a 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 69 6c 65 20 e2 80 98 6d 61 67 69 74 xes..For.example,.while....magit
fd20 2d 64 69 66 66 e2 80 99 20 28 e2 80 98 64 e2 80 99 29 20 61 6e 64 20 e2 80 98 6d 61 67 69 74 2d -diff....(...d...).and....magit-
fd40 64 69 66 66 2d 72 65 66 72 65 73 68 e2 80 99 20 28 e2 80 98 44 e2 80 99 29 0a 6f 66 66 65 72 20 diff-refresh....(...D...).offer.
fd60 64 69 66 66 65 72 65 6e 74 20 73 75 66 66 69 78 65 73 20 74 6f 20 61 63 74 75 61 6c 6c 79 20 63 different.suffixes.to.actually.c
fd80 72 65 61 74 65 20 6f 72 20 75 70 64 61 74 65 20 61 20 64 69 66 66 2c 20 74 68 65 79 20 62 6f 74 reate.or.update.a.diff,.they.bot
fda0 68 0a 6f 66 66 65 72 20 74 68 65 20 73 61 6d 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 h.offer.the.same.infix.arguments
fdc0 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 68 61 74 20 64 69 66 66 20 69 73 20 66 6f 72 .to.control.how.that.diff.is.for
fde0 6d 61 74 74 65 64 2e 0a 53 75 63 68 20 73 68 61 72 65 64 20 67 72 6f 75 70 73 20 73 68 6f 75 6c matted..Such.shared.groups.shoul
fe00 64 20 62 65 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d d.be.defined.using....transient-
fe20 64 65 66 69 6e 65 2d 67 72 6f 75 70 e2 80 99 20 61 6e 64 0a 74 68 65 6e 20 69 6e 63 6c 75 64 65 define-group....and.then.include
fe40 64 20 69 6e 20 6d 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 65 73 2c 20 62 79 20 75 73 69 6e 67 d.in.multiple.prefixes,.by.using
fe60 20 74 68 65 20 73 79 6d 62 6f 6c 20 74 68 61 74 20 69 64 65 6e 74 69 66 69 65 73 0a 74 68 65 20 .the.symbol.that.identifies.the.
fe80 67 72 6f 75 70 20 69 6e 20 74 68 65 20 70 72 65 66 69 78 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20 group.in.the.prefix.definition,.
fea0 69 6e 20 61 20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 20 79 6f 75 20 77 6f 75 6c 64 0a 6f 74 in.a.location.where.you.would.ot
fec0 68 65 72 77 69 73 65 20 75 73 65 20 61 20 67 72 6f 75 70 20 76 65 63 74 6f 72 2e 20 20 49 66 20 herwise.use.a.group.vector...If.
fee0 61 6e 20 69 6e 63 6c 75 64 65 64 20 67 72 6f 75 70 20 69 73 20 70 6c 61 63 65 64 20 61 74 20 74 an.included.group.is.placed.at.t
ff00 68 65 0a 74 6f 70 2d 6c 65 76 65 6c 20 6f 66 20 61 20 70 72 65 66 69 78 20 28 61 73 20 6f 70 70 he.top-level.of.a.prefix.(as.opp
ff20 6f 73 65 64 20 6f 66 20 69 6e 73 69 64 65 20 69 6e 73 69 64 65 20 61 20 76 65 63 74 6f 72 20 61 osed.of.inside.inside.a.vector.a
ff40 73 20 61 20 63 68 69 6c 64 0a 67 72 6f 75 70 29 2c 20 74 68 65 6e 20 74 68 65 20 73 79 6d 62 6f s.a.child.group),.then.the.symbo
ff60 6c 20 73 68 6f 75 6c 64 20 62 65 20 71 75 6f 74 65 64 2e 0a 0a 4d 61 63 72 6f 3a 20 74 72 61 6e l.should.be.quoted...Macro:.tran
ff80 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 20 6e 61 6d 65 20 67 72 6f 75 70 2e 2e 2e sient-define-group.name.group...
ffa0 0a 20 20 20 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 20 6f 6e 65 20 6f 72 20 6d ......This.macro.define.one.or.m
ffc0 6f 72 65 20 67 72 6f 75 70 73 20 61 6e 64 20 73 74 6f 72 65 73 20 74 68 65 6d 20 69 6e 20 73 79 ore.groups.and.stores.them.in.sy
ffe0 6d 62 6f 6c 0a 20 20 20 20 20 4e 41 4d 45 2e 20 20 47 52 4f 55 50 73 20 68 61 76 65 20 74 68 65 mbol......NAME...GROUPs.have.the
10000 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 66 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 .same.form.as.for....transient-d
10020 65 66 69 6e 65 2d 70 72 65 66 69 78 e2 80 99 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 efine-prefix........File:.doci3E
10040 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 OZM.info,..Node:.Binding.Suffix.
10060 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 4e 65 78 74 3a 20 44 65 66 69 6e and.Infix.Commands,..Next:.Defin
10080 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 ing.Suffix.and.Infix.Commands,..
100a0 50 72 65 76 3a 20 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2c 20 20 55 70 3a 20 Prev:.Defining.Transients,..Up:.
100c0 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 2e 33 20 42 69 6e 64 69 Defining.New.Commands..4.3.Bindi
100e0 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 3d 3d 3d ng.Suffix.and.Infix.Commands.===
10100 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
10120 3d 3d 0a 0a 54 68 65 20 6d 61 63 72 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e ==..The.macro....transient-defin
10140 65 2d 70 72 65 66 69 78 e2 80 99 20 69 73 20 75 73 65 64 20 74 6f 20 64 65 66 69 6e 65 20 61 20 e-prefix....is.used.to.define.a.
10160 74 72 61 6e 73 69 65 6e 74 2e 20 20 54 68 69 73 0a 64 65 66 69 6e 65 73 20 74 68 65 20 61 63 74 transient...This.defines.the.act
10180 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 28 73 65 ual.transient.prefix.command.(se
101a0 65 20 2a 6e 6f 74 65 20 44 65 66 69 6e 69 6e 67 0a 54 72 61 6e 73 69 65 6e 74 73 3a 3a 29 20 61 e.*note.Defining.Transients::).a
101c0 6e 64 20 61 64 64 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 20 nd.adds.the.transient...s.infix.
101e0 61 6e 64 20 73 75 66 66 69 78 20 62 69 6e 64 69 6e 67 73 2c 20 61 73 0a 64 65 73 63 72 69 62 65 and.suffix.bindings,.as.describe
10200 64 20 62 65 6c 6f 77 2e 0a 0a 20 20 20 55 73 65 72 73 20 61 6e 64 20 74 68 69 72 64 2d 70 61 72 d.below......Users.and.third-par
10220 74 79 20 70 61 63 6b 61 67 65 73 20 63 61 6e 20 61 64 64 20 61 64 64 69 74 69 6f 6e 61 6c 20 62 ty.packages.can.add.additional.b
10240 69 6e 64 69 6e 67 73 20 75 73 69 6e 67 0a 66 75 6e 63 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 indings.using.functions.such.as.
10260 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 e2 80 99 20 28 73 ...transient-insert-suffix....(s
10280 65 65 20 2a 6e 6f 74 65 20 4d 6f 64 69 66 79 69 6e 67 0a 45 78 69 73 74 69 6e 67 20 54 72 61 6e ee.*note.Modifying.Existing.Tran
102a0 73 69 65 6e 74 73 3a 3a 29 2e 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 61 6b 65 sients::)...These.functions.take
102c0 20 61 20 e2 80 9c 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e e2 80 9d 0a 61 73 .a....suffix.specification....as
102e0 20 6f 6e 65 20 6f 66 20 74 68 65 69 72 20 61 72 67 75 6d 65 6e 74 73 2c 20 77 68 69 63 68 20 68 .one.of.their.arguments,.which.h
10300 61 73 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 74 68 65 20 73 70 65 63 69 66 69 63 as.the.same.form.as.the.specific
10320 61 74 69 6f 6e 73 0a 75 73 65 64 20 69 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 ations.used.in....transient-defi
10340 6e 65 2d 70 72 65 66 69 78 e2 80 99 2e 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 2a 20 47 72 6f 75 70 20 ne-prefix......*.Menu:..*.Group.
10360 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 53 70 65 63 69 66 Specifications::.*.Suffix.Specif
10380 69 63 61 74 69 6f 6e 73 3a 3a 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e ications::....File:.doci3EOZM.in
103a0 66 6f 2c 20 20 4e 6f 64 65 3a 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c fo,..Node:.Group.Specifications,
103c0 20 20 4e 65 78 74 3a 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c 20 20 ..Next:.Suffix.Specifications,..
103e0 55 70 3a 20 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d Up:.Binding.Suffix.and.Infix.Com
10400 6d 61 6e 64 73 0a 0a 34 2e 33 2e 31 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e mands..4.3.1.Group.Specification
10420 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 s.--------------------------..Th
10440 65 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 6f 66 20 61 e.suffix.and.infix.commands.of.a
10460 20 74 72 61 6e 73 69 65 6e 74 20 61 72 65 20 6f 72 67 61 6e 69 7a 65 64 20 69 6e 20 67 72 6f 75 .transient.are.organized.in.grou
10480 70 73 2e 0a 54 68 65 20 67 72 6f 75 70 69 6e 67 20 63 6f 6e 74 72 6f 6c 73 20 68 6f 77 20 74 68 ps..The.grouping.controls.how.th
104a0 65 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 65 73 20 61 e.descriptions.of.the.suffixes.a
104c0 72 65 20 6f 75 74 6c 69 6e 65 64 0a 76 69 73 75 61 6c 6c 79 20 62 75 74 20 61 6c 73 6f 20 6d 61 re.outlined.visually.but.also.ma
104e0 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20 63 65 72 74 61 69 6e 20 70 kes.it.possible.to.set.certain.p
10500 72 6f 70 65 72 74 69 65 73 20 66 6f 72 20 61 20 73 65 74 0a 6f 66 20 73 75 66 66 69 78 65 73 2e roperties.for.a.set.of.suffixes.
10520 0a 0a 20 20 20 53 65 76 65 72 61 6c 20 67 72 6f 75 70 20 63 6c 61 73 73 65 73 20 65 78 69 73 74 .....Several.group.classes.exist
10540 2c 20 73 6f 6d 65 20 6f 66 20 77 68 69 63 68 20 6f 72 67 61 6e 69 7a 65 20 73 75 66 66 69 78 65 ,.some.of.which.organize.suffixe
10560 73 20 69 6e 0a 73 75 62 67 72 6f 75 70 73 2e 20 20 49 6e 20 6d 6f 73 74 20 63 61 73 65 73 20 74 s.in.subgroups...In.most.cases.t
10580 68 65 20 63 6c 61 73 73 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 62 65 20 73 70 65 he.class.does.not.have.to.be.spe
105a0 63 69 66 69 65 64 0a 65 78 70 6c 69 63 69 74 6c 79 2c 20 62 75 74 20 73 65 65 20 2a 6e 6f 74 65 cified.explicitly,.but.see.*note
105c0 20 47 72 6f 75 70 20 43 6c 61 73 73 65 73 3a 3a 2e 0a 0a 20 20 20 47 72 6f 75 70 73 20 61 72 65 .Group.Classes::......Groups.are
105e0 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 e2 80 98 74 72 61 .specified.in.the.call.to....tra
10600 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 e2 80 99 2c 20 75 73 69 6e 67 0a 76 nsient-define-prefix...,.using.v
10620 65 63 74 6f 72 73 2e 20 20 42 65 63 61 75 73 65 20 67 72 6f 75 70 73 20 61 72 65 20 72 65 70 72 ectors...Because.groups.are.repr
10640 65 73 65 6e 74 65 64 20 75 73 69 6e 67 20 76 65 63 74 6f 72 73 2c 20 77 65 20 63 61 6e 6e 6f 74 esented.using.vectors,.we.cannot
10660 20 75 73 65 0a 73 71 75 61 72 65 20 62 72 61 63 6b 65 74 73 20 74 6f 20 69 6e 64 69 63 61 74 65 .use.square.brackets.to.indicate
10680 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 65 6c 65 6d 65 6e 74 20 61 6e 64 20 69 6e 73 74 65 61 64 .an.optional.element.and.instead
106a0 20 75 73 65 20 63 75 72 6c 79 0a 62 72 61 63 6b 65 74 73 20 74 6f 20 64 6f 20 74 68 65 20 6c 61 .use.curly.brackets.to.do.the.la
106c0 74 74 65 72 2e 0a 0a 20 20 20 47 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 20 74 tter......Group.specifications.t
106e0 68 65 6e 20 68 61 76 65 20 74 68 69 73 20 66 6f 72 6d 3a 0a 0a 20 20 20 20 20 5b 7b 4c 45 56 45 hen.have.this.form:.......[{LEVE
10700 4c 7d 20 7b 44 45 53 43 52 49 50 54 49 4f 4e 7d 20 7b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 7d L}.{DESCRIPTION}.{KEYWORD.VALUE}
10720 2e 2e 2e 20 45 4c 45 4d 45 4e 54 2e 2e 2e 5d 0a 0a 20 20 20 54 68 65 20 4c 45 56 45 4c 20 69 73 ....ELEMENT...].....The.LEVEL.is
10740 20 6f 70 74 69 6f 6e 61 6c 20 61 6e 64 20 64 65 66 61 75 6c 74 73 20 74 6f 20 34 2e 20 20 53 65 .optional.and.defaults.to.4...Se
10760 65 20 2a 6e 6f 74 65 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 0a 44 69 73 61 62 6c 69 6e 67 20 53 e.*note.Enabling.and.Disabling.S
10780 75 66 66 69 78 65 73 3a 3a 2e 0a 0a 20 20 20 54 68 65 20 44 45 53 43 52 49 50 54 49 4f 4e 20 69 uffixes::......The.DESCRIPTION.i
107a0 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 49 66 20 70 72 65 73 65 6e 74 2c 20 69 74 20 69 73 20 75 s.optional...If.present,.it.is.u
107c0 73 65 64 20 61 73 20 74 68 65 20 68 65 61 64 69 6e 67 0a 6f 66 20 74 68 65 20 67 72 6f 75 70 2e sed.as.the.heading.of.the.group.
107e0 0a 0a 20 20 20 54 68 65 20 4b 45 59 57 4f 52 44 2d 56 41 4c 55 45 20 70 61 69 72 73 20 61 72 65 .....The.KEYWORD-VALUE.pairs.are
10800 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 45 61 63 68 20 6b 65 79 77 6f 72 64 20 68 61 73 20 74 6f 20 .optional...Each.keyword.has.to.
10820 62 65 20 61 0a 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 e2 80 98 3a be.a.keyword.symbol,.either....:
10840 63 6c 61 73 73 e2 80 99 20 6f 72 20 61 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 73 class....or.a.keyword.argument.s
10860 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 0a 63 6f 6e 73 74 72 75 63 74 6f 72 20 6f 66 20 74 upported.by.the.constructor.of.t
10880 68 61 74 20 63 6c 61 73 73 2e 0a 0a 20 20 20 e2 80 a2 20 4f 6e 65 20 6f 66 20 74 68 65 73 65 20 hat.class..........One.of.these.
108a0 6b 65 79 77 6f 72 64 73 2c 20 e2 80 98 3a 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 2c 20 69 73 keywords,....:description...,.is
108c0 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 73 70 65 63 69 66 79 69 6e 67 0a 20 20 20 20 20 44 .equivalent.to.specifying......D
108e0 45 53 43 52 49 50 54 49 4f 4e 20 61 74 20 74 68 65 20 76 65 72 79 20 62 65 67 69 6e 6e 69 6e 67 ESCRIPTION.at.the.very.beginning
10900 20 6f 66 20 74 68 65 20 76 65 63 74 6f 72 2e 20 20 54 68 65 0a 20 20 20 20 20 72 65 63 6f 6d 6d .of.the.vector...The......recomm
10920 65 6e 64 61 74 69 6f 6e 20 69 73 20 74 6f 20 75 73 65 20 e2 80 98 3a 64 65 73 63 72 69 70 74 69 endation.is.to.use....:descripti
10940 6f 6e e2 80 99 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 6b 65 79 77 6f 72 64 20 69 73 0a 20 on....if.some.other.keyword.is..
10960 20 20 20 20 61 6c 73 6f 20 75 73 65 64 2c 20 66 6f 72 20 63 6f 6e 73 69 73 74 65 6e 63 79 2c 20 ....also.used,.for.consistency,.
10980 6f 72 20 44 45 53 43 52 49 50 54 49 4f 4e 20 6f 74 68 65 72 77 69 73 65 2c 20 62 65 63 61 75 73 or.DESCRIPTION.otherwise,.becaus
109a0 65 20 69 74 0a 20 20 20 20 20 6c 6f 6f 6b 73 20 62 65 74 74 65 72 2e 0a 0a 20 20 20 e2 80 a2 20 e.it......looks.better..........
109c0 4c 69 6b 65 77 69 73 65 20 e2 80 98 3a 6c 65 76 65 6c e2 80 99 20 69 73 20 65 71 75 69 76 61 6c Likewise....:level....is.equival
109e0 65 6e 74 20 74 6f 20 4c 45 56 45 4c 2e 0a 0a 20 20 20 e2 80 a2 20 4f 74 68 65 72 20 69 6d 70 6f ent.to.LEVEL..........Other.impo
10a00 72 74 61 6e 74 20 6b 65 79 77 6f 72 64 73 20 69 6e 63 6c 75 64 65 20 74 68 65 20 e2 80 98 3a 69 rtant.keywords.include.the....:i
10a20 66 2e 2e 2e e2 80 99 20 61 6e 64 20 e2 80 98 3a 69 6e 61 70 74 2d 69 66 2e 2e 2e e2 80 99 0a 20 f.......and....:inapt-if........
10a40 20 20 20 20 6b 65 79 77 6f 72 64 73 2e 20 20 54 68 65 73 65 20 6b 65 79 77 6f 72 64 73 20 63 6f ....keywords...These.keywords.co
10a60 6e 74 72 6f 6c 20 77 68 65 74 68 65 72 20 74 68 65 20 67 72 6f 75 70 20 69 73 20 61 76 61 69 6c ntrol.whether.the.group.is.avail
10a80 61 62 6c 65 20 69 6e 0a 20 20 20 20 20 61 20 63 65 72 74 61 69 6e 20 73 69 74 75 61 74 69 6f 6e able.in......a.certain.situation
10aa0 2e 0a 0a 20 20 20 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 6f 6e 65 20 67 72 6f 75 70 20 6f ........For.example,.one.group.o
10ac0 66 20 74 68 65 20 e2 80 98 6d 61 67 69 74 2d 72 65 62 61 73 65 e2 80 99 20 74 72 61 6e 73 69 65 f.the....magit-rebase....transie
10ae0 6e 74 20 75 73 65 73 20 e2 80 98 3a 69 66 0a 20 20 20 20 20 6d 61 67 69 74 2d 72 65 62 61 73 65 nt.uses....:if......magit-rebase
10b00 2d 69 6e 2d 70 72 6f 67 72 65 73 73 2d 70 e2 80 99 2c 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e -in-progress-p...,.which.contain
10b20 73 20 74 68 65 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 65 0a 20 20 20 20 20 75 73 65 s.the.suffixes.that.are......use
10b40 66 75 6c 20 77 68 69 6c 65 20 72 65 62 61 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 70 ful.while.rebase.is.already.in.p
10b60 72 6f 67 72 65 73 73 3b 20 61 6e 64 20 61 6e 6f 74 68 65 72 20 74 68 61 74 20 75 73 65 73 0a 20 rogress;.and.another.that.uses..
10b80 20 20 20 20 e2 80 98 3a 69 66 2d 6e 6f 74 20 6d 61 67 69 74 2d 72 65 62 61 73 65 2d 69 6e 2d 70 .......:if-not.magit-rebase-in-p
10ba0 72 6f 67 72 65 73 73 2d 70 e2 80 99 2c 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 rogress-p...,.which.contains.the
10bc0 20 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 74 68 61 74 20 69 6e 69 74 69 61 74 65 20 61 20 72 .suffixes......that.initiate.a.r
10be0 65 62 61 73 65 2e 0a 0a 20 20 20 20 20 54 68 65 73 65 20 70 72 65 64 69 63 61 74 65 73 20 63 61 ebase........These.predicates.ca
10c00 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 6f 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 n.also.be.used.on.individual.suf
10c20 66 69 78 65 73 20 61 6e 64 20 61 72 65 0a 20 20 20 20 20 6f 6e 6c 79 20 64 6f 63 75 6d 65 6e 74 fixes.and.are......only.document
10c40 65 64 20 6f 6e 63 65 2c 20 73 65 65 20 2a 6e 6f 74 65 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f ed.once,.see.*note.Predicate.Slo
10c60 74 73 3a 3a 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 e2 80 98 3a 68 ts::..........The.value.of....:h
10c80 69 64 65 e2 80 99 2c 20 69 66 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 20 69 73 20 61 20 70 ide...,.if.non-...nil...,.is.a.p
10ca0 72 65 64 69 63 61 74 65 20 74 68 61 74 20 63 6f 6e 74 72 6f 6c 73 0a 20 20 20 20 20 77 68 65 74 redicate.that.controls......whet
10cc0 68 65 72 20 74 68 65 20 67 72 6f 75 70 20 69 73 20 68 69 64 64 65 6e 20 62 79 20 64 65 66 61 75 her.the.group.is.hidden.by.defau
10ce0 6c 74 2e 20 20 54 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 0a 20 20 20 20 20 73 lt...The.key.bindings.for......s
10d00 75 66 66 69 78 65 73 20 6f 66 20 61 20 68 69 64 64 65 6e 20 67 72 6f 75 70 20 73 68 6f 75 6c 64 uffixes.of.a.hidden.group.should
10d20 20 61 6c 6c 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 70 72 65 66 69 78 20 6b 65 79 2e 0a 20 20 .all.use.the.same.prefix.key....
10d40 20 20 20 50 72 65 73 73 69 6e 67 20 74 68 61 74 20 70 72 65 66 69 78 20 6b 65 79 20 73 68 6f 75 ...Pressing.that.prefix.key.shou
10d60 6c 64 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 20 74 68 65 20 67 72 6f 75 70 20 61 6e ld.temporarily.show.the.group.an
10d80 64 20 69 74 73 0a 20 20 20 20 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 61 73 73 75 6d d.its......suffixes,.which.assum
10da0 65 73 20 74 68 61 74 20 61 20 70 72 65 64 69 63 61 74 65 20 6c 69 6b 65 20 74 68 69 73 20 69 73 es.that.a.predicate.like.this.is
10dc0 20 75 73 65 64 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 20 20 .used:............(lambda.()....
10de0 20 20 20 20 20 20 20 20 20 28 65 71 20 28 63 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 .........(eq.(car.transient--red
10e00 69 73 70 6c 61 79 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3f 5c 43 2d isplay-key).................?\C-
10e20 63 29 29 20 3b 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 73 68 61 72 65 64 20 62 79 20 61 c)).;.the.prefix.key.shared.by.a
10e40 6c 6c 20 62 69 6e 64 69 6e 67 73 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 76 61 6c 75 65 20 6f 66 ll.bindings.........The.value.of
10e60 20 e2 80 98 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e e2 80 99 2c 20 69 66 20 6e 6f 6e 2d e2 ....:setup-children...,.if.non-.
10e80 80 98 6e 69 6c e2 80 99 2c 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 20 ..nil...,.is.a.function.that....
10ea0 20 20 74 61 6b 65 73 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 2c 20 61 20 70 6f 74 65 6e 74 69 61 ..takes.one.argument,.a.potentia
10ec0 6c 6c 79 20 6c 69 73 74 20 6f 66 20 63 68 69 6c 64 72 65 6e 2c 20 61 6e 64 20 6d 75 73 74 20 72 lly.list.of.children,.and.must.r
10ee0 65 74 75 72 6e 0a 20 20 20 20 20 61 20 6c 69 73 74 20 6f 66 20 63 68 69 6c 64 72 65 6e 20 6f 72 eturn......a.list.of.children.or
10f00 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 74 2e 20 20 54 68 69 73 20 63 61 6e 20 65 69 74 68 65 72 .an.empty.list...This.can.either
10f20 20 62 65 20 75 73 65 64 20 74 6f 0a 20 20 20 20 20 73 6f 6d 65 68 6f 77 20 74 72 61 6e 73 66 6f .be.used.to......somehow.transfo
10f40 72 6d 20 74 68 65 20 67 72 6f 75 70 e2 80 99 73 20 63 68 69 6c 64 72 65 6e 20 74 68 61 74 20 77 rm.the.group...s.children.that.w
10f60 65 72 65 20 64 65 66 69 6e 65 64 20 74 68 65 20 6e 6f 72 6d 61 6c 0a 20 20 20 20 20 77 61 79 2c ere.defined.the.normal......way,
10f80 20 6f 72 20 74 6f 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 63 72 65 61 74 65 20 74 68 65 20 63 68 .or.to.dynamically.create.the.ch
10fa0 69 6c 64 72 65 6e 20 66 72 6f 6d 20 73 63 72 61 74 63 68 2e 0a 0a 20 20 20 20 20 54 68 65 20 72 ildren.from.scratch........The.r
10fc0 65 74 75 72 6e 65 64 20 63 68 69 6c 64 72 65 6e 20 6d 75 73 74 20 68 61 76 65 20 74 68 65 20 73 eturned.children.must.have.the.s
10fe0 61 6d 65 20 66 6f 72 6d 20 61 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 20 20 20 20 20 70 ame.form.as.stored.in.the......p
11000 72 65 66 69 78 e2 80 99 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 e2 80 refix...s....transient--layout..
11020 99 20 70 72 6f 70 65 72 74 79 2c 20 62 75 74 20 69 74 20 69 73 20 6f 66 74 65 6e 20 6d 6f 72 65 ..property,.but.it.is.often.more
11040 0a 20 20 20 20 20 63 6f 6e 76 65 6e 69 65 6e 74 20 74 6f 20 75 73 65 20 74 68 65 20 73 61 6d 65 ......convenient.to.use.the.same
11060 20 66 6f 72 6d 20 61 73 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 0a 20 20 20 20 20 e2 80 98 74 .form.as.understood.by.........t
11080 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 e2 80 99 2c 20 64 65 73 63 72 ransient-define-prefix...,.descr
110a0 69 62 65 64 20 62 65 6c 6f 77 2e 20 20 49 66 20 79 6f 75 20 75 73 65 20 74 68 65 20 6c 61 74 74 ibed.below...If.you.use.the.latt
110c0 65 72 0a 20 20 20 20 20 61 70 70 72 6f 61 63 68 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 er......approach,.you.can.use.th
110e0 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 65 73 e2 80 99 e....transient-parse-suffixes...
11100 20 61 6e 64 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 .and.........transient-parse-suf
11120 66 69 78 e2 80 99 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 fix....functions.to.transform.th
11140 65 6d 20 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 20 63 6f 6e 76 65 6e 69 65 6e 74 20 74 6f 20 74 em.from.the......convenient.to.t
11160 68 65 20 65 78 70 65 63 74 65 64 20 66 6f 72 6d 2e 20 20 44 65 70 65 6e 64 69 6e 67 20 6f 6e 20 he.expected.form...Depending.on.
11180 74 68 65 20 75 73 65 64 20 67 72 6f 75 70 0a 20 20 20 20 20 63 6c 61 73 73 2c 20 e2 80 98 74 72 the.used.group......class,....tr
111a0 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 65 73 e2 80 99 e2 80 99 73 20 53 55 ansient-parse-suffixes......s.SU
111c0 46 46 49 58 45 53 20 6d 75 73 74 20 62 65 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 67 72 FFIXES.must.be.a.list.of......gr
111e0 6f 75 70 20 76 65 63 74 6f 72 73 20 28 66 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f oup.vectors.(for....transient-co
11200 6c 75 6d 6e 73 e2 80 99 29 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 73 75 66 66 69 78 20 6c 69 lumns...).or.a.list.of.suffix.li
11220 73 74 73 0a 20 20 20 20 20 28 66 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 67 72 6f 75 70 20 63 6c sts......(for.all.other.group.cl
11240 61 73 73 65 73 29 2e 0a 0a 20 20 20 20 20 49 66 20 79 6f 75 20 65 78 70 6c 69 63 69 74 6c 79 20 asses)........If.you.explicitly.
11260 73 70 65 63 69 66 79 20 63 68 69 6c 64 72 65 6e 20 61 6e 64 20 74 68 65 6e 20 74 72 61 6e 73 66 specify.children.and.then.transf
11280 6f 72 6d 20 74 68 65 6d 20 75 73 69 6e 67 0a 20 20 20 20 20 e2 80 98 3a 73 65 74 75 70 2d 63 68 orm.them.using.........:setup-ch
112a0 69 6c 64 72 65 6e e2 80 99 2c 20 74 68 65 6e 20 74 68 65 20 63 6c 61 73 73 20 6f 66 20 74 68 65 ildren...,.then.the.class.of.the
112c0 20 67 72 6f 75 70 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 61 73 0a 20 20 20 20 20 75 73 75 .group.is.determined.as......usu
112e0 61 6c 2c 20 62 61 73 65 64 20 6f 6e 20 65 78 70 6c 69 63 69 74 6c 79 20 73 70 65 63 69 66 69 65 al,.based.on.explicitly.specifie
11300 64 20 63 68 69 6c 64 72 65 6e 2e 0a 0a 20 20 20 20 20 49 66 20 79 6f 75 20 64 6f 20 6e 6f 74 20 d.children........If.you.do.not.
11320 65 78 70 6c 69 63 69 74 6c 79 20 73 70 65 63 69 66 79 20 63 68 69 6c 64 72 65 6e 20 61 6e 64 20 explicitly.specify.children.and.
11340 74 68 75 73 20 72 65 6c 79 20 73 6f 6c 65 6c 79 20 6f 6e 0a 20 20 20 20 20 e2 80 98 3a 73 65 74 thus.rely.solely.on.........:set
11360 75 70 2d 63 68 69 6c 64 72 65 6e e2 80 99 2c 20 74 68 65 6e 20 79 6f 75 20 6d 75 73 74 20 73 70 up-children...,.then.you.must.sp
11380 65 63 69 66 79 20 74 68 65 20 63 6c 61 73 73 20 75 73 69 6e 67 20 e2 80 98 3a 63 6c 61 73 73 e2 ecify.the.class.using....:class.
113a0 80 99 2e 0a 20 20 20 20 20 46 6f 72 20 62 61 63 6b 77 61 72 64 20 63 6f 6d 70 61 74 69 62 69 6c .........For.backward.compatibil
113c0 69 74 79 2c 20 69 66 20 79 6f 75 20 66 61 69 6c 20 74 6f 20 64 6f 20 73 6f 2c 0a 20 20 20 20 20 ity,.if.you.fail.to.do.so,......
113e0 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e e2 80 99 20 69 73 20 75 73 65 64 20 61 ...transient-column....is.used.a
11400 6e 64 20 61 20 77 61 72 6e 69 6e 67 20 69 73 20 64 69 73 70 6c 61 79 65 64 2e 20 20 54 68 69 73 nd.a.warning.is.displayed...This
11420 0a 20 20 20 20 20 77 61 72 6e 69 6e 67 20 77 69 6c 6c 20 65 76 65 6e 74 75 61 6c 6c 79 20 62 65 ......warning.will.eventually.be
11440 20 72 65 70 6c 61 63 65 64 20 77 69 74 68 20 61 6e 20 65 72 72 6f 72 2e 0a 0a 20 20 20 20 20 20 .replaced.with.an.error.........
11460 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 20 6d 79 2d ....(transient-define-prefix.my-
11480 66 69 6e 64 65 72 2d 62 79 2d 6b 65 79 77 6f 72 64 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 20 finder-by-keyword.()............
114a0 20 22 53 65 6c 65 63 74 20 61 20 6b 65 79 77 6f 72 64 20 61 6e 64 20 6c 69 73 74 20 6d 61 74 63 ."Select.a.keyword.and.list.matc
114c0 68 69 6e 67 20 70 61 63 6b 61 67 65 73 2e 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 54 hing.packages.".............;;.T
114e0 68 65 20 72 65 61 6c 20 60 66 69 6e 64 65 72 2d 62 79 2d 6b 65 79 77 6f 72 64 27 20 69 73 20 6d he.real.`finder-by-keyword'.is.m
11500 6f 72 65 20 63 6f 6e 76 65 6e 69 65 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 6f 66 ore.convenient.............;;.of
11520 20 63 6f 75 72 73 65 2c 20 62 75 74 20 74 68 61 74 20 69 73 20 6e 6f 74 20 74 68 65 20 70 6f 69 .course,.but.that.is.not.the.poi
11540 6e 74 20 68 65 72 65 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 5b 3a 63 6c 61 73 73 20 74 72 61 nt.here..............[:class.tra
11560 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 73 65 74 nsient-columns..............:set
11580 75 70 2d 63 68 69 6c 64 72 65 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 up-children..............(lambda
115a0 20 28 5f 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 .(_)................(transient-p
115c0 61 72 73 65 2d 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 6d arse-suffixes.................'m
115e0 79 2d 66 69 6e 64 65 72 2d 62 79 2d 6b 65 79 77 6f 72 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 y-finder-by-keyword.............
11600 20 20 20 20 28 6c 65 74 20 28 28 63 68 61 72 20 28 31 2d 20 3f 41 29 29 29 0a 20 20 20 20 20 20 ....(let.((char.(1-.?A))).......
11620 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 20 20 20 20 20 20 20 20 20 20 20 20 ............(mapcar.............
11640 20 20 20 20 20 3b 20 61 20 6c 69 73 74 20 2e 2e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .....;.a.list...................
11660 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 70 61 72 74 69 74 69 6f 6e 29 0a 20 20 20 20 20 20 20 .....(lambda.(partition)........
11680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 63 6f 6e 63 61 74 20 20 20 20 20 20 20 20 20 20 ..............(vconcat..........
116a0 20 20 20 20 3b 20 6f 66 20 67 72 6f 75 70 20 76 65 63 74 6f 72 73 20 2e 2e 2e 0a 20 20 20 20 20 ....;.of.group.vectors..........
116c0 20 20 20 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 .................(mapcar.(lambda
116e0 20 28 65 6c 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 20 20 20 .(elt)..........................
11700 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 65 79 77 6f 72 64 20 28 73 79 6d 62 6f 6c 2d 6e 61 .......(let.((keyword.(symbol-na
11720 6d 65 20 28 63 61 72 20 65 6c 74 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 me.(car.elt)))).................
11740 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 3b 20 2e 2e 2e ...........................;....
11760 20 77 68 65 72 65 20 65 61 63 68 20 73 75 66 66 69 78 20 69 73 20 61 20 6c 69 73 74 0a 20 20 20 .where.each.suffix.is.a.list....
11780 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 28 ...............................(
117a0 6c 69 73 74 20 28 66 6f 72 6d 61 74 20 22 25 63 22 20 28 63 6c 2d 69 6e 63 66 20 63 68 61 72 29 list.(format."%c".(cl-incf.char)
117c0 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 20 20 20 20 )...............................
117e0 20 20 20 20 20 20 20 20 20 20 6b 65 79 77 6f 72 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..........keyword...............
11800 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 6c 61 6d 62 64 ..........................(lambd
11820 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 20 20 20 20 20 a.()............................
11840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 ...............(interactive)....
11860 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 ................................
11880 20 20 20 20 20 20 20 28 66 69 6e 64 65 72 2d 6c 69 73 74 2d 6d 61 74 63 68 65 73 20 6b 65 79 77 .......(finder-list-matches.keyw
118a0 6f 72 64 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 ord)))))........................
118c0 20 20 20 20 20 20 20 70 61 72 74 69 74 69 6f 6e 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 .......partition))).............
118e0 20 20 20 20 20 20 20 28 73 65 71 2d 70 61 72 74 69 74 69 6f 6e 20 66 69 6e 64 65 72 2d 6b 6e 6f .......(seq-partition.finder-kno
11900 77 6e 2d 6b 65 79 77 6f 72 64 73 20 37 29 29 29 29 29 5d 29 0a 0a 20 20 20 e2 80 a2 20 54 68 65 wn-keywords.7)))))]).........The
11920 20 62 6f 6f 6c 65 61 6e 20 e2 80 98 3a 70 61 64 2d 6b 65 79 73 e2 80 99 20 61 72 67 75 6d 65 6e .boolean....:pad-keys....argumen
11940 74 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6b 65 79 73 20 6f 66 20 61 6c 6c 0a 20 t.controls.whether.keys.of.all..
11960 20 20 20 20 73 75 66 66 69 78 65 73 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 61 20 67 72 6f 75 ....suffixes.contained.in.a.grou
11980 70 20 61 72 65 20 72 69 67 68 74 20 70 61 64 64 65 64 2c 20 65 66 66 65 63 74 69 76 65 6c 79 0a p.are.right.padded,.effectively.
119a0 20 20 20 20 20 61 6c 69 67 6e 69 6e 67 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 73 2e 0a .....aligning.the.descriptions..
119c0 0a 20 20 20 e2 80 a2 20 49 66 20 61 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 61 63 ........If.a.keyword.argument.ac
119e0 63 65 70 74 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 76 61 6c 75 65 2c 20 79 6f 75 20 61 cepts.a.function.as.value,.you.a
11a00 6e 20 75 73 65 20 61 0a 20 20 20 20 20 e2 80 98 6c 61 6d 62 64 61 e2 80 99 20 65 78 70 72 65 73 n.use.a.........lambda....expres
11a20 73 69 6f 6e 2e 20 20 41 73 20 61 20 73 70 65 63 69 61 6c 20 63 61 73 65 2c 20 74 68 65 20 e2 80 sion...As.a.special.case,.the...
11a40 98 23 23 e2 80 99 20 6d 61 63 72 6f 20 28 77 68 69 63 68 0a 20 20 20 20 20 72 65 74 75 72 6e 73 .##....macro.(which......returns
11a60 20 61 20 e2 80 98 6c 61 6d 62 64 61 e2 80 99 20 65 78 70 72 65 73 73 69 6f 6e 20 61 6e 64 20 69 .a....lambda....expression.and.i
11a80 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 e2 80 98 6c 6c 61 6d 61 e2 80 99 s.implemented.in.the....llama...
11aa0 0a 20 20 20 20 20 70 61 63 6b 61 67 65 29 20 69 73 20 61 6c 73 6f 20 73 75 70 70 6f 72 74 65 64 ......package).is.also.supported
11ac0 2e 20 20 49 6e 73 69 64 65 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c 20 ...Inside.group.specifications,.
11ae0 74 68 65 20 75 73 65 0a 20 20 20 20 20 6f 66 20 e2 80 98 23 23 e2 80 99 20 69 73 20 6e 6f 74 20 the.use......of....##....is.not.
11b00 73 75 70 70 6f 72 74 65 64 20 61 6e 79 77 68 65 72 65 20 62 75 74 20 64 69 72 65 63 74 6c 79 20 supported.anywhere.but.directly.
11b20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 6b 65 79 77 6f 72 64 0a 20 20 20 20 20 73 79 6d 62 6f 6c 2e following.a.keyword......symbol.
11b40 0a 0a 20 20 20 54 68 65 20 45 4c 45 4d 45 4e 54 73 20 61 72 65 20 65 69 74 68 65 72 20 61 6c 6c .....The.ELEMENTs.are.either.all
11b60 20 73 75 62 67 72 6f 75 70 73 2c 20 6f 72 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 61 6e 64 20 .subgroups,.or.all.suffixes.and.
11b80 73 74 72 69 6e 67 73 2e 0a 28 41 74 20 6c 65 61 73 74 20 63 75 72 72 65 6e 74 6c 79 20 6e 6f 20 strings..(At.least.currently.no.
11ba0 67 72 6f 75 70 20 74 79 70 65 20 65 78 69 73 74 73 20 74 68 61 74 20 77 6f 75 6c 64 20 61 6c 6c group.type.exists.that.would.all
11bc0 6f 77 20 6d 69 78 69 6e 67 0a 73 75 62 67 72 6f 75 70 73 20 77 69 74 68 20 63 6f 6d 6d 61 6e 64 ow.mixing.subgroups.with.command
11be0 73 20 61 74 20 74 68 65 20 73 61 6d 65 20 6c 65 76 65 6c 2c 20 74 68 6f 75 67 68 20 69 6e 20 70 s.at.the.same.level,.though.in.p
11c00 72 69 6e 63 69 70 6c 65 20 74 68 65 72 65 20 69 73 0a 6e 6f 74 68 69 6e 67 20 74 68 61 74 20 70 rinciple.there.is.nothing.that.p
11c20 72 65 76 65 6e 74 73 20 74 68 61 74 2e 29 0a 0a 20 20 20 49 66 20 74 68 65 20 45 4c 45 4d 45 4e revents.that.).....If.the.ELEMEN
11c40 54 73 20 61 72 65 20 6e 6f 74 20 73 75 62 67 72 6f 75 70 73 2c 20 74 68 65 6e 20 74 68 65 79 20 Ts.are.not.subgroups,.then.they.
11c60 63 61 6e 20 62 65 20 61 20 6d 69 78 74 75 72 65 20 6f 66 0a 6c 69 73 74 73 2c 20 77 68 69 63 68 can.be.a.mixture.of.lists,.which
11c80 20 73 70 65 63 69 66 79 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 73 74 72 69 6e 67 73 2e 20 .specify.commands,.and.strings..
11ca0 20 53 74 72 69 6e 67 73 20 61 72 65 20 69 6e 73 65 72 74 65 64 0a 76 65 72 62 61 74 69 6d 20 69 .Strings.are.inserted.verbatim.i
11cc0 6e 74 6f 20 74 68 65 20 62 75 66 66 65 72 2e 20 20 54 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e nto.the.buffer...The.empty.strin
11ce0 67 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 6e 73 65 72 74 20 67 61 70 73 0a 62 65 74 g.can.be.used.to.insert.gaps.bet
11d00 77 65 65 6e 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 69 73 20 70 61 72 74 69 63 75 6c ween.suffixes,.which.is.particul
11d20 61 72 6c 79 20 75 73 65 66 75 6c 20 69 66 20 74 68 65 20 73 75 66 66 69 78 65 73 20 61 72 65 0a arly.useful.if.the.suffixes.are.
11d40 6f 75 74 6c 69 6e 65 64 20 61 73 20 61 20 74 61 62 6c 65 2e 0a 0a 20 20 20 49 6e 73 69 64 65 20 outlined.as.a.table......Inside.
11d60 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 group.specifications,.including.
11d80 69 6e 73 69 64 65 20 63 6f 6e 74 61 69 6e 65 64 20 73 75 66 66 69 78 0a 73 70 65 63 69 66 69 63 inside.contained.suffix.specific
11da0 61 74 69 6f 6e 73 2c 20 6e 6f 74 68 69 6e 67 20 68 61 73 20 74 6f 20 62 65 20 71 75 6f 74 65 64 ations,.nothing.has.to.be.quoted
11dc0 20 61 6e 64 20 71 75 6f 74 69 6e 67 20 61 6e 79 77 61 79 20 69 73 20 69 6e 76 61 6c 69 64 2e 0a .and.quoting.anyway.is.invalid..
11de0 54 68 65 20 76 61 6c 75 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 6b 65 79 77 6f 72 64 2c 20 63 The.value.following.a.keyword,.c
11e00 61 6e 20 62 65 20 65 78 70 6c 69 63 69 74 6c 79 20 75 6e 71 75 6f 74 65 64 20 75 73 69 6e 67 20 an.be.explicitly.unquoted.using.
11e20 e2 80 98 2c e2 80 99 2e 0a 54 68 69 73 20 66 65 61 74 75 72 65 20 69 73 20 65 78 70 65 72 69 6d ...,.....This.feature.is.experim
11e40 65 6e 74 61 6c 20 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 61 76 6f 69 64 65 64 2e 0a 0a 20 20 ental.and.should.be.avoided.....
11e60 20 54 68 65 20 66 6f 72 6d 20 6f 66 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f .The.form.of.suffix.specificatio
11e80 6e 73 20 69 73 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 6e 65 78 74 20 6e 6f 64 ns.is.documented.in.the.next.nod
11ea0 65 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 e.....File:.doci3EOZM.info,..Nod
11ec0 65 3a 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c 20 20 50 72 65 76 3a e:.Suffix.Specifications,..Prev:
11ee0 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c 20 20 55 70 3a 20 42 69 6e 64 .Group.Specifications,..Up:.Bind
11f00 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 ing.Suffix.and.Infix.Commands..4
11f20 2e 33 2e 32 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 0a 2d 2d 2d 2d 2d .3.2.Suffix.Specifications.-----
11f40 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 74 72 61 6e 73 69 ----------------------..A.transi
11f60 65 6e 74 e2 80 99 73 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 ent...s.suffix.and.infix.command
11f80 73 20 61 72 65 20 62 6f 75 6e 64 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 70 s.are.bound.when.the.transient.p
11fa0 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 e2 refix.command.is.defined.using..
11fc0 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 e2 80 99 2c 20 73 65 ..transient-define-prefix...,.se
11fe0 65 20 2a 6e 6f 74 65 0a 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 3a 3a 2e 20 20 e.*note.Defining.Transients::...
12000 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6f 72 67 61 6e 69 7a 65 64 20 69 6e 74 6f 20 The.commands.are.organized.into.
12020 67 72 6f 75 70 73 2c 20 73 65 65 0a 2a 6e 6f 74 65 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 groups,.see.*note.Group.Specific
12040 61 74 69 6f 6e 73 3a 3a 2e 20 20 48 65 72 65 20 77 65 20 64 65 73 63 72 69 62 65 20 74 68 65 20 ations::...Here.we.describe.the.
12060 66 6f 72 6d 20 75 73 65 64 20 74 6f 20 62 69 6e 64 20 61 6e 0a 69 6e 64 69 76 69 64 75 61 6c 20 form.used.to.bind.an.individual.
12080 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 54 68 65 20 73 61 6d 65 20 66 6f 72 suffix.command......The.same.for
120a0 6d 20 69 73 20 61 6c 73 6f 20 75 73 65 64 20 77 68 65 6e 20 6c 61 74 65 72 20 62 69 6e 64 69 6e m.is.also.used.when.later.bindin
120c0 67 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 0a 75 73 69 6e 67 20 66 75 6e 63 g.additional.commands.using.func
120e0 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 tions.such.as....transient-inser
12100 74 2d 73 75 66 66 69 78 e2 80 99 2c 20 73 65 65 20 2a 6e 6f 74 65 20 4d 6f 64 69 66 79 69 6e 67 t-suffix...,.see.*note.Modifying
12120 0a 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 3a 3a 2e 0a 0a 20 20 20 4e 6f 74 65 .Existing.Transients::......Note
12140 20 74 68 61 74 20 61 6e 20 69 6e 66 69 78 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 6b 69 6e 64 .that.an.infix.is.a.special.kind
12160 20 6f 66 20 73 75 66 66 69 78 2e 20 20 44 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f 6e 74 65 78 .of.suffix...Depending.on.contex
12180 74 0a e2 80 9c 73 75 66 66 69 78 65 73 e2 80 9d 20 6d 65 61 6e 73 20 e2 80 9c 73 75 66 66 69 78 t....suffixes....means....suffix
121a0 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 69 6e 66 69 78 65 73 29 e2 80 9d 20 6f 72 20 e2 80 9c es.(including.infixes)....or....
121c0 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 e2 80 9d 2e 0a 48 65 72 65 20 69 74 20 6d non-infix.suffixes.....Here.it.m
121e0 65 61 6e 73 20 74 68 65 20 66 6f 72 6d 65 72 2e 0a 0a 20 20 20 53 75 66 66 69 78 20 73 70 65 63 eans.the.former......Suffix.spec
12200 69 66 69 63 61 74 69 6f 6e 73 20 68 61 76 65 20 74 68 69 73 20 66 6f 72 6d 3a 0a 0a 20 20 20 20 ifications.have.this.form:......
12220 20 28 5b 4c 45 56 45 4c 5d 20 5b 4b 45 59 20 5b 44 45 53 43 52 49 50 54 49 4f 4e 5d 5d 20 43 4f .([LEVEL].[KEY.[DESCRIPTION]].CO
12240 4d 4d 41 4e 44 7c 41 52 47 55 4d 45 4e 54 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e MMAND|ARGUMENT.[KEYWORD.VALUE]..
12260 2e 29 0a 0a 20 20 20 4c 45 56 45 4c 2c 20 4b 45 59 20 61 6e 64 20 44 45 53 43 52 49 50 54 49 4f .).....LEVEL,.KEY.and.DESCRIPTIO
12280 4e 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 N.can.also.be.specified.using.th
122a0 65 20 4b 45 59 57 4f 52 44 73 0a e2 80 98 3a 6c 65 76 65 6c e2 80 99 2c 20 e2 80 98 3a 6b 65 79 e.KEYWORDs....:level...,....:key
122c0 e2 80 99 20 61 6e 64 20 e2 80 98 3a 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 2e 20 20 49 66 20 ....and....:description......If.
122e0 74 68 65 20 6f 62 6a 65 63 74 20 74 68 61 74 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 0a 77 69 the.object.that.is.associated.wi
12300 74 68 20 43 4f 4d 4d 41 4e 44 20 73 65 74 73 20 74 68 65 73 65 20 70 72 6f 70 65 72 74 69 65 73 th.COMMAND.sets.these.properties
12320 2c 20 74 68 65 6e 20 74 68 65 79 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 62 65 0a 73 70 ,.then.they.do.not.have.to.be.sp
12340 65 63 69 66 69 65 64 20 68 65 72 65 2e 20 20 59 6f 75 20 63 61 6e 20 68 6f 77 65 76 65 72 20 73 ecified.here...You.can.however.s
12360 70 65 63 69 66 79 20 74 68 65 6d 20 68 65 72 65 20 61 6e 79 77 61 79 2c 20 70 6f 73 73 69 62 6c pecify.them.here.anyway,.possibl
12380 79 0a 6f 76 65 72 72 69 64 69 6e 67 20 74 68 65 20 6f 62 6a 65 63 74 e2 80 99 73 20 76 61 6c 75 y.overriding.the.object...s.valu
123a0 65 73 20 6a 75 73 74 20 66 6f 72 20 74 68 65 20 62 69 6e 64 69 6e 67 20 69 6e 73 69 64 65 20 74 es.just.for.the.binding.inside.t
123c0 68 69 73 0a 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 20 e2 80 a2 20 4c 45 56 45 4c 20 69 73 20 his.transient..........LEVEL.is.
123e0 74 68 65 20 73 75 66 66 69 78 20 6c 65 76 65 6c 2c 20 61 6e 20 69 6e 74 65 67 65 72 20 62 65 74 the.suffix.level,.an.integer.bet
12400 77 65 65 6e 20 31 20 61 6e 64 20 37 2e 20 20 53 65 65 20 2a 6e 6f 74 65 0a 20 20 20 20 20 45 6e ween.1.and.7...See.*note......En
12420 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 2e abling.and.Disabling.Suffixes::.
12440 0a 0a 20 20 20 e2 80 a2 20 4b 45 59 20 69 73 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c .........KEY.is.the.key.binding,
12460 20 61 20 73 74 72 69 6e 67 20 69 6e 20 74 68 65 20 66 6f 72 6d 61 74 20 72 65 74 75 72 6e 65 64 .a.string.in.the.format.returned
12480 20 62 79 0a 20 20 20 20 20 e2 80 98 64 65 73 63 72 69 62 65 2d 6b 65 79 e2 80 99 20 61 6e 64 20 .by.........describe-key....and.
124a0 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 e2 80 98 6b 62 64 e2 80 99 2e 0a 0a 20 20 20 20 20 54 understood.by....kbd...........T
124c0 68 61 74 20 66 6f 72 6d 61 74 20 69 73 20 6d 6f 72 65 20 70 65 72 6d 69 73 73 69 76 65 20 74 68 hat.format.is.more.permissive.th
124e0 61 6e 20 74 68 65 20 6f 6e 65 20 61 63 63 65 70 74 65 64 20 62 79 0a 20 20 20 20 20 e2 80 98 6b an.the.one.accepted.by.........k
12500 65 79 2d 76 61 6c 69 64 2d 70 e2 80 99 2e 20 20 42 65 69 6e 67 20 6d 6f 72 65 20 70 65 72 6d 69 ey-valid-p......Being.more.permi
12520 73 73 69 76 65 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 2c 20 66 6f 72 0a 20 20 20 ssive.makes.it.possible,.for....
12540 20 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 77 72 69 74 65 20 74 68 65 20 6b 65 79 20 62 69 6e 64 ..example,.to.write.the.key.bind
12560 69 6e 67 2c 20 77 68 69 63 68 20 74 6f 67 67 6c 65 73 20 74 68 65 20 e2 80 98 2d 61 e2 80 99 20 ing,.which.toggles.the....-a....
12580 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 2c 20 61 73 20 22 command......line.argument,.as."
125a0 2d 61 22 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 68 61 76 69 6e 67 20 74 6f 20 77 72 69 74 65 20 -a",.instead.of.having.to.write.
125c0 22 2d 20 61 22 2e 20 20 4c 69 6b 65 77 69 73 65 0a 20 20 20 20 20 61 64 64 69 74 69 6f 6e 61 6c "-.a"...Likewise......additional
125e0 20 73 70 61 63 65 73 20 63 61 6e 20 62 65 20 61 64 64 65 64 2c 20 77 68 69 63 68 20 69 73 20 6e .spaces.can.be.added,.which.is.n
12600 6f 74 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 0a 20 20 20 20 20 64 69 73 70 6c 61 79 69 6e 67 20 ot.removed.when......displaying.
12620 74 68 65 20 62 69 6e 64 69 6e 67 20 69 6e 20 74 68 65 20 6d 65 6e 75 2c 20 77 68 69 63 68 20 69 the.binding.in.the.menu,.which.i
12640 73 20 75 73 65 66 75 6c 20 66 6f 72 20 61 6c 69 67 6e 6d 65 6e 74 0a 20 20 20 20 20 70 75 72 70 s.useful.for.alignment......purp
12660 6f 73 65 73 2e 0a 0a 20 20 20 e2 80 a2 20 44 45 53 43 52 49 50 54 49 4f 4e 20 69 73 20 74 68 65 oses..........DESCRIPTION.is.the
12680 20 64 65 73 63 72 69 70 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 61 20 73 74 72 69 6e 67 20 6f 72 .description,.either.a.string.or
126a0 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 20 20 20 74 61 6b 65 73 20 7a 65 72 6f .a.function.that......takes.zero
126c0 20 6f 72 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 73 20 28 74 68 65 20 73 75 66 66 69 78 20 6f 62 .or.one.arguments.(the.suffix.ob
126e0 6a 65 63 74 29 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 0a 20 20 20 20 20 73 74 72 69 6e 67 2e ject).and.returns.a......string.
12700 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 61 20 6c 61 6d 62 64 ..The.function.should.be.a.lambd
12720 61 20 65 78 70 72 65 73 73 69 6f 6e 20 74 6f 20 61 76 6f 69 64 0a 20 20 20 20 20 61 6d 62 69 67 a.expression.to.avoid......ambig
12740 75 69 74 79 2e 20 20 49 6e 20 73 6f 6d 65 20 63 61 73 65 73 20 61 20 73 79 6d 62 6f 6c 20 74 68 uity...In.some.cases.a.symbol.th
12760 61 74 20 69 73 20 62 6f 75 6e 64 20 61 73 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 77 at.is.bound.as.a.function......w
12780 6f 75 6c 64 20 61 6c 73 6f 20 77 6f 72 6b 20 62 75 74 20 74 6f 20 62 65 20 73 61 66 65 20 79 6f ould.also.work.but.to.be.safe.yo
127a0 75 20 73 68 6f 75 6c 64 20 75 73 65 20 e2 80 98 3a 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 20 u.should.use....:description....
127c0 69 6e 0a 20 20 20 20 20 74 68 61 74 20 63 61 73 65 2e 0a 0a 20 20 20 54 68 65 20 6e 65 78 74 20 in......that.case......The.next.
127e0 65 6c 65 6d 65 6e 74 20 69 73 20 65 69 74 68 65 72 20 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 element.is.either.a.command.or.a
12800 6e 20 61 72 67 75 6d 65 6e 74 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 0a 6f 6e 6c 79 20 61 72 n.argument...This.is.the.only.ar
12820 67 75 6d 65 6e 74 20 74 68 61 74 20 69 73 20 6d 61 6e 64 61 74 6f 72 79 20 69 6e 20 61 6c 6c 20 gument.that.is.mandatory.in.all.
12840 63 61 73 65 73 2e 0a 0a 20 20 20 e2 80 a2 20 43 4f 4d 4d 41 4e 44 20 73 68 6f 75 6c 64 20 62 65 cases..........COMMAND.should.be
12860 20 61 20 73 79 6d 62 6f 6c 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 20 61 73 20 61 20 66 75 6e .a.symbol.that.is.bound.as.a.fun
12880 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 68 61 73 0a 20 20 20 20 20 74 6f 20 62 65 20 64 65 66 69 ction,.which.has......to.be.defi
128a0 6e 65 64 20 6f 72 20 61 74 20 6c 65 61 73 74 20 61 75 74 6f 6c 6f 61 64 65 64 20 61 73 20 61 20 ned.or.at.least.autoloaded.as.a.
128c0 63 6f 6d 6d 61 6e 64 20 62 79 20 74 68 65 20 74 69 6d 65 20 74 68 65 0a 20 20 20 20 20 63 6f 6e command.by.the.time.the......con
128e0 74 61 69 6e 69 6e 67 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 taining.prefix.command.is.invoke
12900 64 2e 0a 0a 20 20 20 20 20 41 6e 79 20 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 64 6f 3b 20 69 74 d........Any.command.will.do;.it
12920 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 68 61 76 65 20 61 6e 20 6f 62 6a 65 63 74 .does.not.need.to.have.an.object
12940 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 20 20 20 77 69 74 68 20 69 74 20 28 61 73 20 77 6f 75 .associated......with.it.(as.wou
12960 6c 64 20 62 65 20 74 68 65 20 63 61 73 65 20 69 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 ld.be.the.case.if....transient-d
12980 65 66 69 6e 65 2d 73 75 66 66 69 78 e2 80 99 20 6f 72 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 efine-suffix....or.........trans
129a0 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 e2 80 99 20 77 65 72 65 20 75 73 65 64 20 74 ient-define-infix....were.used.t
129c0 6f 20 64 65 66 69 6e 65 20 69 74 29 2e 0a 0a 20 20 20 20 20 43 4f 4d 4d 41 4e 44 20 63 61 6e 20 o.define.it)........COMMAND.can.
129e0 61 6c 73 6f 20 62 65 20 61 20 e2 80 98 6c 61 6d 62 64 61 e2 80 99 20 65 78 70 72 65 73 73 69 6f also.be.a....lambda....expressio
12a00 6e 2e 0a 0a 20 20 20 20 20 41 73 20 6d 65 6e 74 69 6f 6e 65 64 20 61 62 6f 76 65 2c 20 74 68 65 n........As.mentioned.above,.the
12a20 20 6f 62 6a 65 63 74 20 74 68 61 74 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 .object.that.is.associated.with.
12a40 61 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 65 a.command......can.be.used.to.se
12a60 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 63 65 72 74 61 69 6e 20 76 61 6c 75 65 73 t.the.default.for.certain.values
12a80 20 74 68 61 74 20 6f 74 68 65 72 77 69 73 65 0a 20 20 20 20 20 68 61 76 65 20 74 6f 20 62 65 20 .that.otherwise......have.to.be.
12aa0 73 65 74 20 69 6e 20 74 68 65 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 2e set.in.the.suffix.specification.
12ac0 20 20 54 68 65 72 65 66 6f 72 65 20 69 66 20 74 68 65 72 65 20 69 73 0a 20 20 20 20 20 6e 6f 20 ..Therefore.if.there.is......no.
12ae0 6f 62 6a 65 63 74 2c 20 74 68 65 6e 20 79 6f 75 20 68 61 76 65 20 74 6f 20 6d 61 6b 65 20 73 75 object,.then.you.have.to.make.su
12b00 72 65 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 4b 45 59 20 61 6e 64 20 74 68 65 0a 20 20 re.to.specify.the.KEY.and.the...
12b20 20 20 20 44 45 53 43 52 49 50 54 49 4f 4e 2e 0a 0a 20 20 20 20 20 41 73 20 61 20 73 70 65 63 69 ...DESCRIPTION........As.a.speci
12b40 61 6c 20 63 61 73 65 2c 20 69 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 61 64 64 20 61 20 63 6f al.case,.if.you.want.to.add.a.co
12b60 6d 6d 61 6e 64 20 74 68 61 74 20 6d 69 67 68 74 20 62 65 0a 20 20 20 20 20 6e 65 69 74 68 65 72 mmand.that.might.be......neither
12b80 20 64 65 66 69 6e 65 64 20 6e 6f 72 20 61 75 74 6f 6c 6f 61 64 65 64 2c 20 79 6f 75 20 63 61 6e .defined.nor.autoloaded,.you.can
12ba0 20 75 73 65 20 61 20 77 6f 72 6b 61 72 6f 75 6e 64 20 6c 69 6b 65 3a 0a 0a 20 20 20 20 20 20 20 .use.a.workaround.like:.........
12bc0 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 20 27 73 6f 6d ...(transient-insert-suffix.'som
12be0 65 2d 70 72 65 66 69 78 20 22 6b 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 27 28 22 21 22 20 22 e-prefix."k".............'("!"."
12c00 43 65 63 69 20 6e 27 65 73 74 20 70 61 73 20 75 6e 65 20 63 6f 6d 6d 61 6e 64 65 22 20 6e 6f 2d Ceci.n'est.pas.une.commande".no-
12c20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 69 66 20 28 6c 61 6d 62 64 command...............:if.(lambd
12c40 61 20 28 29 20 28 66 65 61 74 75 72 65 70 20 27 6e 6f 2d 6c 69 62 72 61 72 79 29 29 29 29 0a 0a a.().(featurep.'no-library))))..
12c60 20 20 20 20 20 49 6e 73 74 65 61 64 20 6f 66 20 e2 80 98 66 65 61 74 75 72 65 70 e2 80 99 20 79 .....Instead.of....featurep....y
12c80 6f 75 20 63 6f 75 6c 64 20 61 6c 73 6f 20 75 73 65 20 e2 80 98 72 65 71 75 69 72 65 e2 80 99 20 ou.could.also.use....require....
12ca0 77 69 74 68 20 61 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 0a 20 20 20 20 20 76 61 6c 75 65 20 with.a.non-...nil.........value.
12cc0 66 6f 72 20 4e 4f 45 52 52 4f 52 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 6d 61 6e 64 61 74 6f for.NOERROR..........The.mandato
12ce0 72 79 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e ry.argument.can.also.be.a.comman
12d00 64 2d 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 2c 20 61 0a 20 20 20 20 20 73 74 72 69 6e 67 2e 20 d-line.argument,.a......string..
12d20 20 49 6e 20 74 68 61 74 20 63 61 73 65 20 61 6e 20 61 6e 6f 6e 79 6d 6f 75 73 20 63 6f 6d 6d 61 .In.that.case.an.anonymous.comma
12d40 6e 64 20 69 73 20 64 65 66 69 6e 65 64 20 61 6e 64 20 62 6f 75 6e 64 2e 0a 0a 20 20 20 20 20 49 nd.is.defined.and.bound........I
12d60 6e 73 74 65 61 64 20 6f 66 20 61 20 73 74 72 69 6e 67 2c 20 74 68 69 73 20 63 61 6e 20 61 6c 73 nstead.of.a.string,.this.can.als
12d80 6f 20 62 65 20 61 20 6c 69 73 74 20 6f 66 20 74 77 6f 20 73 74 72 69 6e 67 73 2c 20 69 6e 0a 20 o.be.a.list.of.two.strings,.in..
12da0 20 20 20 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 66 69 72 73 74 20 73 74 72 69 6e 67 20 ....which.case.the.first.string.
12dc0 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 73 68 6f 72 74 20 61 72 67 75 6d 65 6e 74 20 28 77 is.used.as.the.short.argument.(w
12de0 68 69 63 68 0a 20 20 20 20 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 hich......can.also.be.specified.
12e00 75 73 69 6e 67 20 e2 80 98 3a 73 68 6f 72 74 61 72 67 e2 80 99 29 20 61 6e 64 20 74 68 65 20 73 using....:shortarg...).and.the.s
12e20 65 63 6f 6e 64 20 61 73 20 74 68 65 20 6c 6f 6e 67 0a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 20 econd.as.the.long......argument.
12e40 28 77 68 69 63 68 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 (which.can.also.be.specified.usi
12e60 6e 67 20 e2 80 98 3a 61 72 67 75 6d 65 6e 74 e2 80 99 29 2e 0a 0a 20 20 20 20 20 4f 6e 6c 79 20 ng....:argument...)........Only.
12e80 74 68 65 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 69 the.long.argument.is.displayed.i
12ea0 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 53 65 65 0a 20 20 20 20 20 e2 80 98 n.the.menu.buffer...See.........
12ec0 74 72 61 6e 73 69 65 6e 74 2d 64 65 74 65 63 74 2d 6b 65 79 2d 63 6f 6e 66 6c 69 63 74 73 e2 80 transient-detect-key-conflicts..
12ee0 99 20 66 6f 72 20 68 6f 77 20 74 68 65 20 73 68 6f 72 74 20 61 72 67 75 6d 65 6e 74 20 6d 61 79 ..for.how.the.short.argument.may
12f00 20 62 65 0a 20 20 20 20 20 75 73 65 64 2e 0a 0a 20 20 20 20 20 55 6e 6c 65 73 73 20 74 68 65 20 .be......used........Unless.the.
12f20 63 6c 61 73 73 20 69 73 20 73 70 65 63 69 66 69 65 64 20 65 78 70 6c 69 63 69 74 6c 79 2c 20 74 class.is.specified.explicitly,.t
12f40 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 6c 61 73 73 20 69 73 0a 20 20 20 20 20 67 75 65 he.appropriate.class.is......gue
12f60 73 73 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 2e ssed.based.on.the.long.argument.
12f80 20 20 49 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 65 6e 64 73 20 77 69 74 68 20 e2 80 98 3d ..If.the.argument.ends.with....=
12fa0 e2 80 99 0a 20 20 20 20 20 28 65 2e 67 2e 2c 20 e2 80 98 2d 2d 66 6f 72 6d 61 74 3d e2 80 99 29 .........(e.g.,....--format=...)
12fc0 20 74 68 65 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e e2 80 99 20 69 73 20 .then....transient-option....is.
12fe0 75 73 65 64 2c 20 6f 74 68 65 72 77 69 73 65 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e used,.otherwise.........transien
13000 74 2d 73 77 69 74 63 68 e2 80 99 2e 0a 0a 20 20 20 46 69 6e 61 6c 6c 79 2c 20 64 65 74 61 69 6c t-switch.........Finally,.detail
13020 73 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 6f 70 74 69 6f 6e 61 s.can.be.specified.using.optiona
13040 6c 20 4b 45 59 57 4f 52 44 2d 56 41 4c 55 45 20 70 61 69 72 73 2e 0a 45 61 63 68 20 6b 65 79 77 l.KEYWORD-VALUE.pairs..Each.keyw
13060 6f 72 64 20 68 61 73 20 74 6f 20 62 65 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 ord.has.to.be.a.keyword.symbol,.
13080 65 69 74 68 65 72 20 e2 80 98 3a 63 6c 61 73 73 e2 80 99 20 6f 72 20 61 20 6b 65 79 77 6f 72 64 either....:class....or.a.keyword
130a0 0a 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 63 6f 6e 73 74 .argument.supported.by.the.const
130c0 72 75 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 20 20 53 65 65 20 2a 6e 6f 74 65 ructor.of.that.class...See.*note
130e0 20 53 75 66 66 69 78 0a 53 6c 6f 74 73 3a 3a 2e 0a 0a 20 20 20 49 66 20 61 20 6b 65 79 77 6f 72 .Suffix.Slots::......If.a.keywor
13100 64 20 61 72 67 75 6d 65 6e 74 20 61 63 63 65 70 74 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 61 73 d.argument.accepts.a.function.as
13120 20 76 61 6c 75 65 2c 20 79 6f 75 20 61 6e 20 75 73 65 20 61 0a e2 80 98 6c 61 6d 62 64 61 e2 80 .value,.you.an.use.a....lambda..
13140 99 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 41 73 20 61 20 73 70 65 63 69 61 6c 20 63 61 73 65 ..expression...As.a.special.case
13160 2c 20 74 68 65 20 e2 80 98 23 23 e2 80 99 20 6d 61 63 72 6f 20 28 77 68 69 63 68 20 72 65 74 75 ,.the....##....macro.(which.retu
13180 72 6e 73 20 61 0a e2 80 98 6c 61 6d 62 64 61 e2 80 99 20 65 78 70 72 65 73 73 69 6f 6e 20 61 6e rns.a....lambda....expression.an
131a0 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 e2 80 98 6c 6c 61 6d 61 d.is.implemented.in.the....llama
131c0 e2 80 99 20 70 61 63 6b 61 67 65 29 20 69 73 20 61 6c 73 6f 0a 73 75 70 70 6f 72 74 65 64 2e 20 ....package).is.also.supported..
131e0 20 49 6e 73 69 64 65 20 73 75 66 66 69 78 20 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 20 75 73 65 .Inside.suffix.bindings,.the.use
13200 20 6f 66 20 e2 80 98 23 23 e2 80 99 20 69 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 64 0a 61 6e .of....##....is.not.supported.an
13220 79 77 68 65 72 65 20 62 75 74 20 64 69 72 65 63 74 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 ywhere.but.directly.following.a.
13240 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f keyword.symbol.....File:.doci3EO
13260 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 ZM.info,..Node:.Defining.Suffix.
13280 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 4e 65 78 74 3a 20 55 73 69 6e 67 and.Infix.Commands,..Next:.Using
132a0 20 49 6e 66 69 78 20 41 72 67 75 6d 65 6e 74 73 2c 20 20 50 72 65 76 3a 20 42 69 6e 64 69 6e 67 .Infix.Arguments,..Prev:.Binding
132c0 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 55 70 3a .Suffix.and.Infix.Commands,..Up:
132e0 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 2e 34 20 44 65 66 69 .Defining.New.Commands..4.4.Defi
13300 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 3d ning.Suffix.and.Infix.Commands.=
13320 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
13340 3d 3d 3d 3d 3d 0a 0a 4e 6f 74 65 20 74 68 61 74 20 61 6e 20 69 6e 66 69 78 20 69 73 20 61 20 73 =====..Note.that.an.infix.is.a.s
13360 70 65 63 69 61 6c 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 2e 20 20 44 65 70 65 6e 64 69 6e pecial.kind.of.suffix...Dependin
13380 67 20 6f 6e 20 63 6f 6e 74 65 78 74 0a e2 80 9c 73 75 66 66 69 78 65 73 e2 80 9d 20 6d 65 61 6e g.on.context....suffixes....mean
133a0 73 20 e2 80 9c 73 75 66 66 69 78 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 69 6e 66 69 78 65 73 s....suffixes.(including.infixes
133c0 29 e2 80 9d 20 6f 72 20 e2 80 9c 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 e2 80 9d )....or....non-infix.suffixes...
133e0 2e 0a 0a 4d 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 ...Macro:.transient-define-suffi
13400 78 20 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 5b 64 6f 63 73 74 72 69 6e 67 5d 20 5b 6b 65 79 77 x.name.arglist.[docstring].[keyw
13420 6f 72 64 20 76 61 6c 75 65 5d 2e 2e 2e 20 62 6f 64 79 2e 2e 2e 0a 20 20 20 20 20 54 68 69 73 20 ord.value]....body.........This.
13440 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 20 4e 41 4d 45 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e macro.defines.NAME.as.a.transien
13460 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 20 20 41 52 47 4c 49 53 54 20 t.suffix.command........ARGLIST.
13480 61 72 65 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 74 68 65 20 63 6f 6d 6d 61 are.the.arguments.that.the.comma
134a0 6e 64 20 74 61 6b 65 73 2e 20 20 44 4f 43 53 54 52 49 4e 47 20 69 73 20 74 68 65 0a 20 20 20 20 nd.takes...DOCSTRING.is.the.....
134c0 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 61 6e 64 20 69 73 20 6f 70 74 .documentation.string.and.is.opt
134e0 69 6f 6e 61 6c 2e 0a 0a 20 20 20 20 20 54 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 20 63 61 6e ional........These.arguments.can
13500 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6b 65 79 77 6f .optionally.be.followed.by.keywo
13520 72 64 2d 76 61 6c 75 65 20 70 61 69 72 73 2e 0a 20 20 20 20 20 45 61 63 68 20 6b 65 79 77 6f 72 rd-value.pairs.......Each.keywor
13540 64 20 68 61 73 20 74 6f 20 62 65 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 65 69 d.has.to.be.a.keyword.symbol,.ei
13560 74 68 65 72 20 e2 80 98 3a 63 6c 61 73 73 e2 80 99 20 6f 72 20 61 0a 20 20 20 20 20 6b 65 79 77 ther....:class....or.a......keyw
13580 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 63 6f ord.argument.supported.by.the.co
135a0 6e 73 74 72 75 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 20 20 54 68 65 0a 20 20 nstructor.of.that.class...The...
135c0 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 20 63 6c 61 73 73 20 ......transient-suffix....class.
135e0 69 73 20 75 73 65 64 20 69 66 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 63 is.used.if.the.class.is.not.spec
13600 69 66 69 65 64 0a 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 2e 0a 0a 20 20 20 20 20 54 68 65 ified......explicitly........The
13620 20 42 4f 44 59 20 6d 75 73 74 20 62 65 67 69 6e 20 77 69 74 68 20 61 6e 20 e2 80 98 69 6e 74 65 .BODY.must.begin.with.an....inte
13640 72 61 63 74 69 76 65 e2 80 99 20 66 6f 72 6d 20 74 68 61 74 20 6d 61 74 63 68 65 73 0a 20 20 20 ractive....form.that.matches....
13660 20 20 41 52 47 4c 49 53 54 2e 20 20 54 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 ..ARGLIST...The.infix.arguments.
13680 61 72 65 20 75 73 75 61 6c 6c 79 20 61 63 63 65 73 73 65 64 20 62 79 20 75 73 69 6e 67 0a 20 20 are.usually.accessed.by.using...
136a0 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 20 69 6e 73 69 64 65 20 e2 ......transient-args....inside..
136c0 80 98 69 6e 74 65 72 61 63 74 69 76 65 e2 80 99 2e 0a 0a 4d 61 63 72 6f 3a 20 74 72 61 6e 73 69 ..interactive......Macro:.transi
136e0 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 20 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 5b 64 ent-define-infix.name.arglist.[d
13700 6f 63 73 74 72 69 6e 67 5d 20 5b 6b 65 79 77 6f 72 64 20 76 61 6c 75 65 5d 2e 2e 2e 0a 20 20 20 ocstring].[keyword.value].......
13720 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 20 4e 41 4d 45 20 61 73 20 61 20 74 ..This.macro.defines.NAME.as.a.t
13740 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 20 20 41 52 ransient.infix.command........AR
13760 47 4c 49 53 54 20 69 73 20 61 6c 77 61 79 73 20 69 67 6e 6f 72 65 64 20 28 62 75 74 20 6d 61 6e GLIST.is.always.ignored.(but.man
13780 64 61 74 6f 72 79 20 6e 65 76 65 72 2d 74 68 65 2d 6c 65 73 73 29 20 61 6e 64 0a 20 20 20 20 20 datory.never-the-less).and......
137a0 72 65 73 65 72 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20 75 73 65 2e 20 20 44 4f 43 53 54 52 reserved.for.future.use...DOCSTR
137c0 49 4e 47 20 69 73 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 ING.is.the.documentation.string.
137e0 61 6e 64 0a 20 20 20 20 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 0a 0a 20 20 20 20 20 41 74 20 6c and......is.optional........At.l
13800 65 61 73 74 20 6f 6e 65 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 69 72 20 69 73 20 72 65 71 75 69 east.one.key-value.pair.is.requi
13820 72 65 64 2e 20 20 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 0a 20 20 20 20 20 63 red...All.transient.infix......c
13840 6f 6d 6d 61 6e 64 73 20 61 72 65 20 e2 80 98 65 71 75 61 6c e2 80 99 20 74 6f 20 65 61 63 68 20 ommands.are....equal....to.each.
13860 6f 74 68 65 72 20 28 62 75 74 20 6e 6f 74 20 e2 80 98 65 71 e2 80 99 29 2e 20 20 49 74 20 69 73 other.(but.not....eq...)...It.is
13880 0a 20 20 20 20 20 6d 65 61 6e 69 6e 67 6c 65 73 73 20 74 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 ......meaningless.to.define.an.i
138a0 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 77 69 74 68 6f 75 74 20 70 72 6f 76 69 64 69 6e 67 20 nfix.command,.without.providing.
138c0 61 74 20 6c 65 61 73 74 0a 20 20 20 20 20 6f 6e 65 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 at.least......one.keyword.argume
138e0 6e 74 20 28 75 73 75 61 6c 6c 79 20 e2 80 98 3a 61 72 67 75 6d 65 6e 74 e2 80 99 20 6f 72 20 e2 nt.(usually....:argument....or..
13900 80 98 3a 76 61 72 69 61 62 6c 65 e2 80 99 2c 20 64 65 70 65 6e 64 69 6e 67 0a 20 20 20 20 20 6f ..:variable...,.depending......o
13920 6e 20 74 68 65 20 63 6c 61 73 73 29 2e 20 20 54 68 65 20 73 75 66 66 69 78 20 63 6c 61 73 73 20 n.the.class)...The.suffix.class.
13940 64 65 66 61 75 6c 74 73 20 74 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 e2 defaults.to....transient-switch.
13960 80 99 20 61 6e 64 0a 20 20 20 20 20 63 61 6e 20 62 65 20 73 65 74 20 75 73 69 6e 67 20 74 68 65 ...and......can.be.set.using.the
13980 20 e2 80 98 3a 63 6c 61 73 73 e2 80 99 20 6b 65 79 77 6f 72 64 2e 0a 0a 20 20 20 20 20 54 68 65 ....:class....keyword........The
139a0 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 73 20 61 6c 77 61 79 73 3a 0a .function.definition.is.always:.
139c0 0a 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 20 20 20 ...........(lambda.()...........
139e0 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 ..(interactive).............(let
13a00 20 28 28 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 .((obj.(transient-suffix-object)
13a20 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 ))...............(transient-infi
13a40 78 2d 73 65 74 20 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 x-set.obj.(transient-infix-read.
13a60 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 obj))).............(transient--s
13a80 68 6f 77 29 29 0a 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 how))..........transient-infix-r
13aa0 65 61 64 e2 80 99 20 61 6e 64 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 ead....and....transient-infix-se
13ac0 74 e2 80 99 20 61 72 65 20 67 65 6e 65 72 69 63 0a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 73 2e t....are.generic......functions.
13ae0 20 20 44 69 66 66 65 72 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 62 65 68 61 76 ..Different.infix.commands.behav
13b00 65 20 64 69 66 66 65 72 65 6e 74 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 0a 20 20 20 20 20 63 e.differently.because.the......c
13b20 6f 6e 63 72 65 74 65 20 6d 65 74 68 6f 64 73 20 61 72 65 20 64 69 66 66 65 72 65 6e 74 20 66 6f oncrete.methods.are.different.fo
13b40 72 20 64 69 66 66 65 72 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 6c 61 73 73 65 r.different.infix.command.classe
13b60 73 2e 0a 20 20 20 20 20 49 6e 20 72 61 72 65 20 63 61 73 65 73 20 74 68 65 20 61 62 6f 76 65 20 s.......In.rare.cases.the.above.
13b80 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f 6e 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 20 73 75 command.function.might.not.be.su
13ba0 69 74 61 62 6c 65 2c 0a 20 20 20 20 20 65 76 65 6e 20 69 66 20 79 6f 75 20 64 65 66 69 6e 65 20 itable,......even.if.you.define.
13bc0 79 6f 75 72 20 6f 77 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 6c 61 73 73 2e 20 20 49 your.own.infix.command.class...I
13be0 6e 20 74 68 61 74 20 63 61 73 65 20 79 6f 75 0a 20 20 20 20 20 68 61 76 65 20 74 6f 20 75 73 65 n.that.case.you......have.to.use
13c00 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 e2 80 99 20 74 ....transient-define-suffix....t
13c20 6f 20 64 65 66 69 6e 65 20 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 o.define.the.infix.command......
13c40 61 6e 64 20 75 73 65 20 e2 80 98 74 e2 80 99 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 and.use....t....as.the.value.of.
13c60 74 68 65 20 e2 80 98 3a 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 6b 65 79 77 6f 72 64 2e 0a 0a 4d the....:transient....keyword...M
13c80 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 61 72 67 75 6d 65 6e 74 20 acro:.transient-define-argument.
13ca0 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 5b 64 6f 63 73 74 72 69 6e 67 5d 20 5b 6b 65 79 77 6f 72 name.arglist.[docstring].[keywor
13cc0 64 20 76 61 6c 75 65 5d 2e 2e 2e 0a 20 20 20 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 d.value].........This.macro.defi
13ce0 6e 65 73 20 4e 41 4d 45 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 20 63 6f nes.NAME.as.a.transient.infix.co
13d00 6d 6d 61 6e 64 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 61 6e 20 61 6c 69 61 73 20 66 6f mmand........This.is.an.alias.fo
13d20 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 e2 80 99 2e 20 r....transient-define-infix.....
13d40 20 4f 6e 6c 79 20 75 73 65 20 74 68 69 73 20 61 6c 69 61 73 0a 20 20 20 20 20 74 6f 20 64 65 66 .Only.use.this.alias......to.def
13d60 69 6e 65 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 61 63 74 75 61 6c ine.an.infix.command.that.actual
13d80 6c 79 20 73 65 74 73 20 61 6e 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 2e 0a 20 20 20 20 20 ly.sets.an.infix.argument.......
13da0 54 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 2c To.define.an.infix.command.that,
13dc0 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 65 74 73 20 61 20 76 61 72 69 61 62 6c 65 2c 20 75 .for.example,.sets.a.variable,.u
13de0 73 65 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 se.........transient-define-infi
13e00 78 e2 80 99 20 69 6e 73 74 65 61 64 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d x....instead.....File:.doci3EOZM
13e20 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 55 73 69 6e 67 20 49 6e 66 69 78 20 41 72 67 75 6d 65 .info,..Node:.Using.Infix.Argume
13e40 6e 74 73 2c 20 20 4e 65 78 74 3a 20 55 73 69 6e 67 20 50 72 65 66 69 78 20 53 63 6f 70 65 2c 20 nts,..Next:.Using.Prefix.Scope,.
13e60 20 50 72 65 76 3a 20 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 .Prev:.Defining.Suffix.and.Infix
13e80 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 55 70 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d .Commands,..Up:.Defining.New.Com
13ea0 6d 61 6e 64 73 0a 0a 34 2e 35 20 55 73 69 6e 67 20 49 6e 66 69 78 20 41 72 67 75 6d 65 6e 74 73 mands..4.5.Using.Infix.Arguments
13ec0 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 .=========================..The.
13ee0 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 76 61 72 69 61 62 6c 65 73 20 64 65 73 63 functions.and.the.variables.desc
13f00 72 69 62 65 64 20 62 65 6c 6f 77 20 61 6c 6c 6f 77 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 ribed.below.allow.suffix.command
13f20 73 20 74 6f 0a 61 63 63 65 73 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 74 72 61 s.to.access.the.value.of.the.tra
13f40 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 79 20 77 65 72 65 20 69 6e 76 6f nsient.from.which.they.were.invo
13f60 6b 65 64 3b 20 77 68 69 63 68 20 69 73 0a 74 68 65 20 76 61 6c 75 65 20 6f 66 20 69 74 73 20 69 ked;.which.is.the.value.of.its.i
13f80 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 73 65 20 76 61 72 69 61 62 6c 65 73 nfix.arguments...These.variables
13fa0 20 61 72 65 20 73 65 74 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 0a 69 6e 76 6f 6b 65 73 20 61 .are.set.when.the.user.invokes.a
13fc0 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 65 78 69 74 73 20 74 68 65 20 74 .suffix.command.that.exits.the.t
13fe0 72 61 6e 73 69 65 6e 74 2c 20 62 75 74 20 62 65 66 6f 72 65 20 61 63 74 75 61 6c 6c 79 0a 63 61 ransient,.but.before.actually.ca
14000 6c 6c 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 57 68 65 6e 20 72 65 74 75 lling.the.command......When.retu
14020 72 6e 69 6e 67 20 74 6f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 6f 6f 70 20 61 66 74 65 72 20 rning.to.the.command-loop.after.
14040 63 61 6c 6c 69 6e 67 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 0a 74 68 65 20 calling.the.suffix.command,.the.
14060 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 72 65 73 65 74 20 74 6f 20 e2 80 98 6e 69 6c e2 80 99 arguments.are.reset.to....nil...
14080 20 28 77 68 69 63 68 20 63 61 75 73 65 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 72 .(which.causes.the.function.to.r
140a0 65 74 75 72 6e 0a e2 80 98 6e 69 6c e2 80 99 20 74 6f 6f 29 2e 0a 0a 20 20 20 4c 69 6b 65 20 66 eturn....nil....too)......Like.f
140c0 6f 72 20 45 6d 61 63 73 e2 80 99 73 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2c 20 69 or.Emacs...s.prefix.arguments,.i
140e0 74 20 69 73 20 61 64 76 69 73 61 62 6c 65 2c 20 62 75 74 20 6e 6f 74 0a 6d 61 6e 64 61 74 6f 72 t.is.advisable,.but.not.mandator
14100 79 2c 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 y,.to.access.the.infix.arguments
14120 20 69 6e 73 69 64 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 e2 80 99 73 0a e2 80 98 69 6e 74 65 72 .inside.the.command...s....inter
14140 61 63 74 69 76 65 e2 80 99 20 66 6f 72 6d 2e 20 20 54 68 65 20 70 72 65 66 65 72 72 65 64 20 77 active....form...The.preferred.w
14160 61 79 20 6f 66 20 64 6f 69 6e 67 20 74 68 61 74 20 69 73 20 74 6f 20 63 61 6c 6c 20 74 68 65 0a ay.of.doing.that.is.to.call.the.
14180 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 20 66 75 6e 63 74 69 6f 6e 2c 20 77 ...transient-args....function,.w
141a0 68 69 63 68 20 66 6f 72 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 73 65 72 76 65 73 20 hich.for.infix.arguments.serves.
141c0 61 62 6f 75 74 20 74 68 65 0a 73 61 6d 65 20 70 75 72 70 6f 73 65 20 61 73 20 e2 80 98 70 72 65 about.the.same.purpose.as....pre
141e0 66 69 78 2d 61 72 67 e2 80 99 20 73 65 72 76 65 73 20 66 6f 72 20 70 72 65 66 69 78 20 61 72 67 fix-arg....serves.for.prefix.arg
14200 75 6d 65 6e 74 73 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 uments...Function:.transient-arg
14220 73 20 70 72 65 66 69 78 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 s.prefix......This.function.retu
14240 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 rns.the.value.of.the.transient.p
14260 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 50 52 45 46 49 58 2e 0a 0a 20 20 20 20 refix.command......PREFIX.......
14280 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f .If.the.current.command.was.invo
142a0 6b 65 64 20 66 72 6f 6d 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 0a 20 20 ked.from.the.transient.prefix...
142c0 20 20 20 63 6f 6d 6d 61 6e 64 20 50 52 45 46 49 58 2c 20 74 68 65 6e 20 69 74 20 72 65 74 75 72 ...command.PREFIX,.then.it.retur
142e0 6e 73 20 74 68 65 20 61 63 74 69 76 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 ns.the.active.infix.arguments...
14300 49 66 20 74 68 65 0a 20 20 20 20 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 If.the......current.command.was.
14320 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 50 52 45 46 49 58 2c 20 74 68 65 6e 20 69 74 not.invoked.from.PREFIX,.then.it
14340 20 72 65 74 75 72 6e 73 20 74 68 65 0a 20 20 20 20 20 73 65 74 2c 20 73 61 76 65 64 20 6f 72 20 .returns.the......set,.saved.or.
14360 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 20 50 52 45 46 49 58 2e 0a 0a 20 20 20 20 20 default.value.for.PREFIX........
14380 50 52 45 46 49 58 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 6c 69 73 74 20 6f 66 20 70 72 65 PREFIX.may.also.be.a.list.of.pre
143a0 66 69 78 65 73 2e 20 20 49 66 20 6e 6f 20 70 72 65 66 69 78 20 69 73 20 61 63 74 69 76 65 2c 20 fixes...If.no.prefix.is.active,.
143c0 74 68 65 0a 20 20 20 20 20 66 61 6c 6c 62 61 63 6b 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 66 the......fallback.value.of.the.f
143e0 69 72 73 74 20 6f 66 20 74 68 65 73 65 20 70 72 65 66 69 78 65 73 20 69 73 20 75 73 65 64 2e 0a irst.of.these.prefixes.is.used..
14400 0a 20 20 20 20 20 54 68 65 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 e2 80 98 74 72 ......The.generic.function....tr
14420 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 65 e2 80 99 20 69 73 20 75 73 65 64 20 ansient-prefix-value....is.used.
14440 74 6f 20 64 65 74 65 72 6d 69 6e 65 0a 20 20 20 20 20 74 68 65 20 72 65 74 75 72 6e 65 64 20 76 to.determine......the.returned.v
14460 61 6c 75 65 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 alue........This.function.is.int
14480 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 ended.to.be.used.by.suffix.comma
144a0 6e 64 73 2c 20 77 68 65 74 68 65 72 0a 20 20 20 20 20 74 68 65 79 20 61 72 65 20 69 6e 76 6f 6b nds,.whether......they.are.invok
144c0 65 64 20 66 72 6f 6d 20 61 20 6d 65 6e 75 20 6f 72 20 6e 6f 74 2e 20 20 49 74 20 69 73 20 6e 6f ed.from.a.menu.or.not...It.is.no
144e0 74 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 0a 20 20 20 20 20 77 68 65 6e 20 t.intended.to.be.used......when.
14500 73 65 74 74 69 6e 67 20 75 70 20 61 20 6d 65 6e 75 20 61 6e 64 20 69 74 73 20 73 75 66 66 69 78 setting.up.a.menu.and.its.suffix
14520 65 73 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 es,.in.which.case.........transi
14540 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 e2 80 99 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2e ent-get-value....should.be.used.
14560 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 0a ..Function:.transient-get-value.
14580 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 .....This.function.returns.the.v
145a0 61 6c 75 65 20 6f 66 20 74 68 65 20 65 72 61 6e 74 20 70 72 65 66 69 78 2e 0a 0a 20 20 20 20 20 alue.of.the.erant.prefix........
145c0 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 This.function.is.intended.to.be.
145e0 75 73 65 64 20 77 68 65 6e 20 73 65 74 74 69 6e 67 20 75 70 20 61 20 6d 65 6e 75 20 61 6e 64 20 used.when.setting.up.a.menu.and.
14600 69 74 73 0a 20 20 20 20 20 73 75 66 66 69 78 65 73 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 69 6e its......suffixes...It.is.not.in
14620 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 61 20 73 75 66 66 69 78 20 tended.to.be.used.when.a.suffix.
14640 63 6f 6d 6d 61 6e 64 20 69 73 0a 20 20 20 20 20 69 6e 76 6f 6b 65 64 2c 20 77 68 65 74 68 65 72 command.is......invoked,.whether
14660 20 66 72 6f 6d 20 61 20 6d 65 6e 75 20 6f 72 20 6e 6f 74 2c 20 69 6e 20 77 68 69 63 68 20 63 61 .from.a.menu.or.not,.in.which.ca
14680 73 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 0a 20 20 20 20 20 73 68 6f se....transient-args.........sho
146a0 75 6c 64 20 62 65 20 75 73 65 64 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 75 73 uld.be.used...In.other.words,.us
146c0 65 20 74 68 69 73 2c 20 65 2e 67 2e 2c 20 69 6e 20 61 20 73 75 66 66 69 78 65 73 0a 20 20 20 20 e.this,.e.g.,.in.a.suffixes.....
146e0 20 e2 80 98 3a 69 66 2a e2 80 99 20 6f 72 20 e2 80 98 3a 69 6e 61 70 74 2d 69 66 2a e2 80 99 20 ....:if*....or....:inapt-if*....
14700 70 72 65 64 69 63 61 74 65 20 61 6e 64 20 e2 80 98 3a 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 predicate.and....:description...
14720 20 66 75 6e 63 74 69 6f 6e 2c 20 62 75 74 0a 20 20 20 20 20 6e 65 76 65 72 20 69 6e 20 69 74 73 .function,.but......never.in.its
14740 20 e2 80 98 69 6e 74 65 72 61 63 74 69 76 65 e2 80 99 20 66 6f 72 6d 20 6f 72 20 66 75 6e 63 74 ....interactive....form.or.funct
14760 69 6f 6e 20 62 6f 64 79 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 ion.body...Function:.transient-a
14780 72 67 2d 76 61 6c 75 65 20 61 72 67 20 61 72 67 73 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 rg-value.arg.args......This.func
147a0 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 41 52 47 20 61 73 tion.returns.the.value.of.ARG.as
147c0 20 69 74 20 61 70 70 65 61 72 73 20 69 6e 20 41 52 47 53 2e 0a 0a 20 20 20 20 20 46 6f 72 20 61 .it.appears.in.ARGS........For.a
147e0 20 73 77 69 74 63 68 20 61 20 62 6f 6f 6c 65 61 6e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 .switch.a.boolean.is.returned...
14800 46 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 69 73 0a 20 20 20 20 20 For.an.option.the.value.is......
14820 72 65 74 75 72 6e 65 64 20 61 73 20 61 20 73 74 72 69 6e 67 2c 20 75 73 69 6e 67 20 74 68 65 20 returned.as.a.string,.using.the.
14840 65 6d 70 74 79 20 73 74 72 69 6e 67 20 66 6f 72 20 74 68 65 20 65 6d 70 74 79 20 76 61 6c 75 65 empty.string.for.the.empty.value
14860 2c 0a 20 20 20 20 20 6f 72 20 e2 80 98 6e 69 6c e2 80 99 20 69 66 20 74 68 65 20 6f 70 74 69 6f ,......or....nil....if.the.optio
14880 6e 20 64 6f 65 73 20 6e 6f 74 20 61 70 70 65 61 72 20 69 6e 20 41 52 47 53 2e 0a 0a 46 75 6e 63 n.does.not.appear.in.ARGS...Func
148a0 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 65 73 20 70 72 65 66 69 78 0a tion:.transient-suffixes.prefix.
148c0 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 .....This.function.returns.the.s
148e0 75 66 66 69 78 65 73 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 uffixes.of.the.transient.prefix.
14900 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 50 52 45 46 49 58 2e 20 20 54 68 69 73 20 69 73 20 61 20 command......PREFIX...This.is.a.
14920 6c 69 73 74 20 6f 66 20 6f 62 6a 65 63 74 73 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 list.of.objects...This.function.
14940 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 0a 20 20 20 20 20 75 73 65 64 20 69 66 20 79 6f 75 20 should.only.be......used.if.you.
14960 6e 65 65 64 20 74 68 65 20 6f 62 6a 65 63 74 73 20 28 61 73 20 6f 70 70 6f 73 65 64 20 74 6f 20 need.the.objects.(as.opposed.to.
14980 6a 75 73 74 20 74 68 65 69 72 20 76 61 6c 75 65 73 29 20 61 6e 64 0a 20 20 20 20 20 69 66 20 74 just.their.values).and......if.t
149a0 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 62 65 69 6e 67 20 he.current.command.is.not.being.
149c0 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 50 52 45 46 49 58 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f invoked.from.PREFIX.....File:.do
149e0 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 55 73 69 6e 67 20 50 72 65 66 69 ci3EOZM.info,..Node:.Using.Prefi
14a00 78 20 53 63 6f 70 65 2c 20 20 4e 65 78 74 3a 20 43 75 72 72 65 6e 74 20 53 75 66 66 69 78 20 43 x.Scope,..Next:.Current.Suffix.C
14a20 6f 6d 6d 61 6e 64 2c 20 20 50 72 65 76 3a 20 55 73 69 6e 67 20 49 6e 66 69 78 20 41 72 67 75 6d ommand,..Prev:.Using.Infix.Argum
14a40 65 6e 74 73 2c 20 20 55 70 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 ents,..Up:.Defining.New.Commands
14a60 0a 0a 34 2e 36 20 55 73 69 6e 67 20 50 72 65 66 69 78 20 53 63 6f 70 65 0a 3d 3d 3d 3d 3d 3d 3d ..4.6.Using.Prefix.Scope.=======
14a80 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 53 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 ===============..Some.transients
14aa0 20 68 61 76 65 20 61 20 73 6f 72 74 20 6f 66 20 73 65 63 6f 6e 64 61 72 79 20 76 61 6c 75 65 2c .have.a.sort.of.secondary.value,
14ac0 20 63 61 6c 6c 65 64 20 61 20 73 63 6f 70 65 2e 20 20 41 0a 70 72 65 66 69 78 e2 80 99 73 20 73 .called.a.scope...A.prefix...s.s
14ae0 63 6f 70 65 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 20 e2 80 98 74 72 cope.can.be.accessed.using....tr
14b00 61 6e 73 69 65 6e 74 2d 73 63 6f 70 65 e2 80 99 3b 20 73 69 6d 69 6c 61 72 20 74 6f 20 68 6f 77 ansient-scope...;.similar.to.how
14b20 0a 69 74 73 20 76 61 6c 75 65 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 .its.value.can.be.accessed.using
14b40 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 2e 0a 0a 46 75 6e 63 74 69 6f 6e ....transient-args......Function
14b60 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 63 6f 70 65 20 70 72 65 66 69 78 65 73 20 63 6c 61 73 73 :.transient-scope.prefixes.class
14b80 65 73 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 es......This.function.returns.th
14ba0 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 20 6f 72 20 63 75 72 72 65 6e 74 e.scope.of.the.active.or.current
14bc0 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 20 20 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a .transient......prefix.command..
14be0 0a 20 20 20 20 20 49 66 20 6f 70 74 69 6f 6e 61 6c 20 50 52 45 46 49 58 45 53 20 61 6e 64 20 43 ......If.optional.PREFIXES.and.C
14c00 4c 41 53 53 45 53 20 61 72 65 20 62 6f 74 68 20 6e 69 6c 2c 20 72 65 74 75 72 6e 20 74 68 65 20 LASSES.are.both.nil,.return.the.
14c20 73 63 6f 70 65 20 6f 66 0a 20 20 20 20 20 74 68 65 20 70 72 65 66 69 78 20 63 75 72 72 65 6e 74 scope.of......the.prefix.current
14c40 6c 79 20 62 65 69 6e 67 20 73 65 74 75 70 2c 20 6d 61 6b 69 6e 67 20 74 68 69 73 20 76 61 72 69 ly.being.setup,.making.this.vari
14c60 61 74 69 6f 6e 20 75 73 65 66 75 6c 2c 0a 20 20 20 20 20 65 2e 67 2e 2c 20 69 6e 20 e2 80 98 3a ation.useful,......e.g.,.in....:
14c80 69 66 2a e2 80 99 20 70 72 65 64 69 63 61 74 65 73 2e 20 20 49 66 20 6e 6f 20 70 72 65 66 69 78 if*....predicates...If.no.prefix
14ca0 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 2c 20 62 75 74 20 74 68 65 0a 20 20 20 20 20 63 75 .is.being.setup,.but.the......cu
14cc0 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 73 rrent.command.was.invoked.from.s
14ce0 6f 6d 65 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68 65 20 73 63 6f 70 ome.prefix,.then.return.the.scop
14d00 65 0a 20 20 20 20 20 6f 66 20 74 68 61 74 2e 0a 0a 20 20 20 20 20 49 66 20 50 52 45 46 49 58 45 e......of.that........If.PREFIXE
14d20 53 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 69 74 20 6d 75 73 74 20 62 65 20 61 20 70 72 65 66 69 S.is.non-nil,.it.must.be.a.prefi
14d40 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 73 75 63 68 x.command.or.a.list.of......such
14d60 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 49 66 20 43 4c 41 53 53 45 53 20 69 73 20 6e 6f 6e 2d 6e 69 .commands...If.CLASSES.is.non-ni
14d80 6c 2c 20 69 74 20 6d 75 73 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6c 61 73 73 20 6f 72 0a l,.it.must.be.a.prefix.class.or.
14da0 20 20 20 20 20 61 20 6c 69 73 74 20 6f 66 20 73 75 63 68 20 63 6c 61 73 73 65 73 2e 20 20 57 68 .....a.list.of.such.classes...Wh
14dc0 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 en.this.function.is.called.from.
14de0 74 68 65 20 62 6f 64 79 0a 20 20 20 20 20 6f 72 20 74 68 65 20 e2 80 98 69 6e 74 65 72 61 63 74 the.body......or.the....interact
14e00 69 76 65 e2 80 99 20 66 6f 72 6d 20 6f 66 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c ive....form.of.a.suffix.command,
14e20 20 50 52 45 46 49 58 45 53 20 61 6e 64 2f 6f 72 0a 20 20 20 20 20 43 4c 41 53 53 45 53 20 73 68 .PREFIXES.and/or......CLASSES.sh
14e40 6f 75 6c 64 20 62 65 20 6e 6f 6e 2d 6e 69 6c 2e 20 20 49 66 20 65 69 74 68 65 72 20 69 73 20 6e ould.be.non-nil...If.either.is.n
14e60 6f 6e 2d 6e 69 6c 2c 20 74 72 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 20 69 on-nil,.try.the.following......i
14e80 6e 20 6f 72 64 65 72 3a 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 49 66 20 74 68 65 20 63 75 72 n.order:..............If.the.cur
14ea0 72 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 rent.suffix.command.was.invoked.
14ec0 66 72 6f 6d 20 61 20 70 72 65 66 69 78 2c 20 77 68 69 63 68 0a 20 20 20 20 20 20 20 20 20 20 61 from.a.prefix,.which...........a
14ee0 70 70 65 61 72 73 20 69 6e 20 50 52 45 46 49 58 45 53 2c 20 72 65 74 75 72 6e 20 74 68 65 20 73 ppears.in.PREFIXES,.return.the.s
14f00 63 6f 70 65 20 6f 66 20 74 68 61 74 20 70 72 65 66 69 78 2e 0a 0a 20 20 20 20 20 20 20 20 e2 80 cope.of.that.prefix.............
14f20 a2 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 ..If.the.current.suffix.command.
14f40 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 61 20 70 72 65 66 69 78 2c 20 61 6e 64 0a 20 was.invoked.from.a.prefix,.and..
14f60 20 20 20 20 20 20 20 20 20 69 74 73 20 63 6c 61 73 73 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 .........its.class.derives.from.
14f80 6f 6e 65 20 6f 66 20 74 68 65 20 43 4c 41 53 53 45 53 2c 20 72 65 74 75 72 6e 20 74 68 65 20 73 one.of.the.CLASSES,.return.the.s
14fa0 63 6f 70 65 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 74 68 61 74 20 70 72 65 66 69 78 2e 0a 0a cope.of...........that.prefix...
14fc0 20 20 20 20 20 20 20 20 e2 80 a2 20 49 66 20 61 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 ............If.a.prefix.is.being
14fe0 20 73 65 74 75 70 20 61 6e 64 20 69 74 20 61 70 70 65 61 72 73 20 69 6e 20 50 52 45 46 49 58 45 .setup.and.it.appears.in.PREFIXE
15000 53 2c 20 72 65 74 75 72 6e 0a 20 20 20 20 20 20 20 20 20 20 69 74 73 20 73 63 6f 70 65 2e 0a 0a S,.return...........its.scope...
15020 20 20 20 20 20 20 20 20 e2 80 a2 20 49 66 20 61 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 ............If.a.prefix.is.being
15040 20 73 65 74 75 70 20 61 6e 64 20 69 74 73 20 63 6c 61 73 73 20 64 65 72 69 76 65 73 20 66 72 6f .setup.and.its.class.derives.fro
15060 6d 20 6f 6e 65 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 43 4c 41 53 53 45 53 2c 20 m.one.of...........the.CLASSES,.
15080 72 65 74 75 72 6e 20 69 74 73 20 73 63 6f 70 65 2e 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 46 return.its.scope...............F
150a0 69 6e 61 6c 6c 79 20 74 72 79 20 74 6f 20 72 65 74 75 72 6e 20 74 68 65 20 64 65 66 61 75 6c 74 inally.try.to.return.the.default
150c0 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 .scope.of.the.first.command.....
150e0 20 20 20 20 20 20 69 6e 20 50 52 45 46 49 58 45 53 2e 20 20 54 68 69 73 20 6f 6e 6c 79 20 77 6f ......in.PREFIXES...This.only.wo
15100 72 6b 73 20 69 66 20 74 68 61 74 20 73 6c 6f 74 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 0a 20 rks.if.that.slot.is.set.in.the..
15120 20 20 20 20 20 20 20 20 20 72 65 73 70 65 63 74 69 76 65 20 63 6c 61 73 73 20 64 65 66 69 6e 69 .........respective.class.defini
15140 74 69 6f 6e 20 6f 72 20 75 73 69 6e 67 20 69 74 73 0a 20 20 20 20 20 20 20 20 20 20 e2 80 98 74 tion.or.using.its..............t
15160 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 e2 80 99 20 6d 65 74 68 6f 64 2e 0a 0a ransient-init-scope....method...
15180 20 20 20 20 20 49 66 20 6e 6f 20 70 72 65 66 69 78 20 6d 61 74 63 68 65 73 2c 20 72 65 74 75 72 .....If.no.prefix.matches,.retur
151a0 6e 20 6e 69 6c 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 n.nil.....File:.doci3EOZM.info,.
151c0 20 4e 6f 64 65 3a 20 43 75 72 72 65 6e 74 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 2c 20 20 .Node:.Current.Suffix.Command,..
151e0 4e 65 78 74 3a 20 43 75 72 72 65 6e 74 20 50 72 65 66 69 78 20 43 6f 6d 6d 61 6e 64 2c 20 20 50 Next:.Current.Prefix.Command,..P
15200 72 65 76 3a 20 55 73 69 6e 67 20 50 72 65 66 69 78 20 53 63 6f 70 65 2c 20 20 55 70 3a 20 44 65 rev:.Using.Prefix.Scope,..Up:.De
15220 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 2e 37 20 43 75 72 72 65 6e 74 fining.New.Commands..4.7.Current
15240 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .Suffix.Command.================
15260 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d ==========..Function:.transient-
15280 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 54 68 69 73 20 suffix-object.command......This.
152a0 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 73 6f function.returns.the.object.asso
152c0 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 75 66 66 69 78 0a 20 ciated.with.the.current.suffix..
152e0 20 20 20 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 20 20 45 61 63 68 20 73 75 66 66 69 78 20 63 ....command........Each.suffix.c
15300 6f 6d 6d 61 6e 64 73 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 6e 20 6f 62 ommands.is.associated.with.an.ob
15320 6a 65 63 74 2c 20 77 68 69 63 68 20 68 6f 6c 64 73 0a 20 20 20 20 20 61 64 64 69 74 69 6f 6e 61 ject,.which.holds......additiona
15340 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 78 2c 20 l.information.about.the.suffix,.
15360 73 75 63 68 20 61 73 20 69 74 73 20 76 61 6c 75 65 20 28 69 6e 20 74 68 65 0a 20 20 20 20 20 63 such.as.its.value.(in.the......c
15380 61 73 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 ase.of.an.infix.command,.which.i
153a0 73 20 61 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 29 2e 0a 0a 20 20 s.a.kind.of.suffix.command).....
153c0 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 ...This.function.is.intended.to.
153e0 62 65 20 63 61 6c 6c 65 64 20 62 79 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 be.called.by.infix.commands,.whi
15400 63 68 20 61 72 65 0a 20 20 20 20 20 75 73 75 61 6c 6c 79 20 61 6c 69 61 73 65 73 20 6f 66 20 e2 ch.are......usually.aliases.of..
15420 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 ..transient--default-infix-comma
15440 6e 64 e2 80 99 2c 20 77 68 69 63 68 20 69 73 0a 20 20 20 20 20 64 65 66 69 6e 65 64 20 6c 69 6b nd...,.which.is......defined.lik
15460 65 20 74 68 69 73 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 28 64 65 66 75 6e 20 74 72 61 6e 73 69 e.this:............(defun.transi
15480 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 20 28 29 0a 20 20 ent--default-infix-command.()...
154a0 20 20 20 20 20 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 20 20 ..........(interactive).........
154c0 20 20 20 20 28 6c 65 74 20 28 28 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 ....(let.((obj.(transient-suffix
154e0 2d 6f 62 6a 65 63 74 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 -object)))...............(transi
15500 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 ent-infix-set.obj.(transient-inf
15520 69 78 2d 72 65 61 64 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e ix-read.obj))).............(tran
15540 73 69 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 0a 20 20 20 20 20 28 55 73 65 72 20 69 6e 70 75 74 20 sient--show)).......(User.input.
15560 69 73 20 72 65 61 64 20 6f 75 74 73 69 64 65 20 6f 66 20 e2 80 98 69 6e 74 65 72 61 63 74 69 76 is.read.outside.of....interactiv
15580 65 e2 80 99 20 74 6f 20 70 72 65 76 65 6e 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 e....to.prevent.the.command.....
155a0 20 66 72 6f 6d 20 62 65 69 6e 67 20 61 64 64 65 64 20 74 6f 20 e2 80 98 63 6f 6d 6d 61 6e 64 2d .from.being.added.to....command-
155c0 68 69 73 74 6f 72 79 e2 80 99 2e 29 0a 0a 20 20 20 20 20 53 75 63 68 20 63 6f 6d 6d 61 6e 64 73 history....).......Such.commands
155e0 20 6e 65 65 64 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 69 72 .need.to.be.able.to.access.their
15600 20 61 73 73 6f 63 69 61 74 65 64 20 6f 62 6a 65 63 74 20 74 6f 0a 20 20 20 20 20 67 75 69 64 65 .associated.object.to......guide
15620 20 68 6f 77 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 e2 80 99 20 .how....transient-infix-read....
15640 72 65 61 64 73 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 61 6e 64 20 74 6f 20 73 74 6f 72 65 reads.the.new.value.and.to.store
15660 0a 20 20 20 20 20 74 68 65 20 72 65 61 64 20 76 61 6c 75 65 2e 20 20 4f 74 68 65 72 20 73 75 66 ......the.read.value...Other.suf
15680 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 6e 6f 6e 2d 69 6e 66 69 fix.commands.(including.non-infi
156a0 78 0a 20 20 20 20 20 63 6f 6d 6d 61 6e 64 73 29 20 6d 61 79 20 61 6c 73 6f 20 6e 65 65 64 20 74 x......commands).may.also.need.t
156c0 68 65 20 6f 62 6a 65 63 74 20 74 6f 20 67 75 69 64 65 20 74 68 65 69 72 20 62 65 68 61 76 69 6f he.object.to.guide.their.behavio
156e0 72 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 73 20 r........This.function.attempts.
15700 74 6f 20 72 65 74 75 72 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 73 6f 63 69 61 74 65 64 20 to.return.the.object.associated.
15720 77 69 74 68 20 74 68 65 0a 20 20 20 20 20 63 75 72 72 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d with.the......current.suffix.com
15740 6d 61 6e 64 20 65 76 65 6e 20 69 66 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 mand.even.if.the.suffix.command.
15760 77 61 73 20 6e 6f 74 20 69 6e 76 6f 6b 65 64 0a 20 20 20 20 20 66 72 6f 6d 20 61 20 74 72 61 6e was.not.invoked......from.a.tran
15780 73 69 65 6e 74 2e 20 20 28 46 6f 72 20 73 6f 6d 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 sient...(For.some.suffix.command
157a0 20 74 68 61 74 20 69 73 20 61 20 76 61 6c 69 64 20 74 68 69 6e 67 0a 20 20 20 20 20 74 6f 20 64 .that.is.a.valid.thing......to.d
157c0 6f 2c 20 66 6f 72 20 6f 74 68 65 72 73 20 69 74 20 69 73 20 6e 6f 74 2e 29 20 20 49 6e 20 74 68 o,.for.others.it.is.not.)..In.th
157e0 61 74 20 63 61 73 65 20 e2 80 98 6e 69 6c e2 80 99 20 6d 61 79 20 62 65 20 72 65 74 75 72 6e 65 at.case....nil....may.be.returne
15800 64 2c 0a 20 20 20 20 20 69 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 6e 6f 74 20 64 d,......if.the.command.was.not.d
15820 65 66 69 6e 65 64 20 75 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 6d 61 63 72 6f 73 20 69 efined.using.one.of.the.macros.i
15840 6e 74 65 6e 64 65 64 20 74 6f 0a 20 20 20 20 20 64 65 66 69 6e 65 20 73 75 63 68 20 63 6f 6d 6d ntended.to......define.such.comm
15860 61 6e 64 73 2e 0a 0a 20 20 20 20 20 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e ands........The.optional.argumen
15880 74 20 43 4f 4d 4d 41 4e 44 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e t.COMMAND.is.intended.for.intern
158a0 61 6c 20 75 73 65 2e 20 20 49 66 20 79 6f 75 0a 20 20 20 20 20 61 72 65 20 63 6f 6e 74 65 6d 70 al.use...If.you......are.contemp
158c0 6c 61 74 69 6e 67 20 75 73 69 6e 67 20 69 74 20 69 6e 20 79 6f 75 72 20 6f 77 6e 20 63 6f 64 65 lating.using.it.in.your.own.code
158e0 2c 20 74 68 65 6e 20 79 6f 75 20 73 68 6f 75 6c 64 0a 20 20 20 20 20 70 72 6f 62 61 62 6c 79 20 ,.then.you.should......probably.
15900 75 73 65 20 74 68 69 73 20 69 6e 73 74 65 61 64 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 28 67 65 use.this.instead:............(ge
15920 74 20 43 4f 4d 4d 41 4e 44 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 29 0a 0a 56 t.COMMAND.'transient--suffix)..V
15940 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 ariable:.transient-current-suffi
15960 78 65 73 0a 20 20 20 20 20 54 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 74 68 65 20 74 72 61 xes......The.suffixes.of.the.tra
15980 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 20 73 75 66 66 69 78 20 63 6f nsient.from.which.this.suffix.co
159a0 6d 6d 61 6e 64 20 77 61 73 0a 20 20 20 20 20 69 6e 76 6f 6b 65 64 2e 20 20 54 68 69 73 20 69 73 mmand.was......invoked...This.is
159c0 20 61 20 6c 69 73 74 20 6f 66 20 6f 62 6a 65 63 74 73 2e 20 20 55 73 75 61 6c 6c 79 20 69 74 20 .a.list.of.objects...Usually.it.
159e0 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 74 6f 0a 20 20 20 20 20 69 6e 73 74 65 61 64 20 75 73 is.sufficient.to......instead.us
15a00 65 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e.the.function....transient-args
15a20 e2 80 99 2c 20 77 68 69 63 68 20 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 20 ...,.which.returns.a.list.of....
15a40 20 20 76 61 6c 75 65 73 2e 20 20 49 6e 20 63 6f 6d 70 6c 65 78 20 63 61 73 65 73 20 69 74 20 6d ..values...In.complex.cases.it.m
15a60 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 75 73 65 20 74 68 69 73 0a 20 20 ight.be.necessary.to.use.this...
15a80 20 20 20 76 61 72 69 61 62 6c 65 20 69 6e 73 74 65 61 64 2c 20 69 2e 65 2e 2c 20 69 66 20 79 6f ...variable.instead,.i.e.,.if.yo
15aa0 75 20 6e 65 65 64 20 61 63 63 65 73 73 20 74 6f 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 62 65 73 u.need.access.to.information.bes
15ac0 69 64 65 0a 20 20 20 20 20 74 68 65 20 76 61 6c 75 65 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 ide......the.value.....File:.doc
15ae0 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 43 75 72 72 65 6e 74 20 50 72 65 66 i3EOZM.info,..Node:.Current.Pref
15b00 69 78 20 43 6f 6d 6d 61 6e 64 2c 20 20 4e 65 78 74 3a 20 54 72 61 6e 73 69 65 6e 74 20 53 74 61 ix.Command,..Next:.Transient.Sta
15b20 74 65 2c 20 20 50 72 65 76 3a 20 43 75 72 72 65 6e 74 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e te,..Prev:.Current.Suffix.Comman
15b40 64 2c 20 20 55 70 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 d,..Up:.Defining.New.Commands..4
15b60 2e 38 20 43 75 72 72 65 6e 74 20 50 72 65 66 69 78 20 43 6f 6d 6d 61 6e 64 0a 3d 3d 3d 3d 3d 3d .8.Current.Prefix.Command.======
15b80 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 ====================..Function:.
15ba0 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 0a 20 20 20 20 20 54 68 69 transient-prefix-object......Thi
15bc0 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 s.function.returns.the.current.p
15be0 72 65 66 69 78 20 61 73 20 61 6e 20 6f 62 6a 65 63 74 2e 0a 0a 20 20 20 20 20 57 68 69 6c 65 20 refix.as.an.object........While.
15c00 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 20 6f 72 20 72 65 a.transient.is.being.setup.or.re
15c20 66 72 65 73 68 65 64 20 28 77 68 69 63 68 20 69 6e 76 6f 6c 76 65 73 0a 20 20 20 20 20 70 72 65 freshed.(which.involves......pre
15c40 70 61 72 69 6e 67 20 69 74 73 20 73 75 66 66 69 78 65 73 29 20 74 68 65 20 76 61 72 69 61 62 6c paring.its.suffixes).the.variabl
15c60 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 e2 80 99 20 63 61 6e 20 62 65 e....transient--prefix....can.be
15c80 0a 20 20 20 20 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 70 72 65 66 69 78 20 ......used.to.access.the.prefix.
15ca0 6f 62 6a 65 63 74 2e 20 20 54 68 75 73 20 74 68 69 73 20 69 73 20 77 68 61 74 20 68 61 73 20 74 object...Thus.this.is.what.has.t
15cc0 6f 20 62 65 20 75 73 65 64 0a 20 20 20 20 20 69 6e 20 73 75 66 66 69 78 20 6d 65 74 68 6f 64 73 o.be.used......in.suffix.methods
15ce0 20 73 75 63 68 20 61 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 .such.as....transient-format-des
15d00 63 72 69 70 74 69 6f 6e e2 80 99 2c 20 61 6e 64 20 69 6e 0a 20 20 20 20 20 6f 62 6a 65 63 74 2d cription...,.and.in......object-
15d20 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 61 72 65 20 73 74 6f 72 specific.functions.that.are.stor
15d40 65 64 20 69 6e 20 73 75 66 66 69 78 20 73 6c 6f 74 73 20 73 75 63 68 20 61 73 0a 20 20 20 20 20 ed.in.suffix.slots.such.as......
15d60 e2 80 98 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 61 20 ...description...........When.a.
15d80 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 28 69 2e 65 2e 2c suffix.command.is.invoked.(i.e.,
15da0 20 69 6e 20 69 74 73 20 e2 80 98 69 6e 74 65 72 61 63 74 69 76 65 e2 80 99 20 66 6f 72 6d 0a 20 .in.its....interactive....form..
15dc0 20 20 20 20 61 6e 64 20 66 75 6e 63 74 69 6f 6e 20 62 6f 64 79 29 20 74 68 65 6e 20 74 68 65 20 ....and.function.body).then.the.
15de0 76 61 72 69 61 62 6c 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 variable....transient-current-pr
15e00 65 66 69 78 e2 80 99 20 68 61 73 0a 20 20 20 20 20 74 6f 20 62 65 20 75 73 65 64 20 69 6e 73 74 efix....has......to.be.used.inst
15e20 65 61 64 2e 0a 0a 20 20 20 20 20 54 77 6f 20 64 69 73 74 69 6e 63 74 20 76 61 72 69 61 62 6c 65 ead........Two.distinct.variable
15e40 73 20 61 72 65 20 6e 65 65 64 65 64 2c 20 62 65 63 61 75 73 65 20 61 6e 79 20 70 72 65 66 69 78 s.are.needed,.because.any.prefix
15e60 20 6d 61 79 20 69 74 73 65 6c 66 20 62 65 0a 20 20 20 20 20 75 73 65 64 20 61 73 20 61 20 73 75 .may.itself.be......used.as.a.su
15e80 66 66 69 78 20 6f 66 20 61 6e 6f 74 68 65 72 20 70 72 65 66 69 78 2c 20 61 6e 64 20 73 75 63 68 ffix.of.another.prefix,.and.such
15ea0 20 73 75 62 2d 70 72 65 66 69 78 65 73 20 68 61 76 65 20 74 6f 0a 20 20 20 20 20 62 65 20 61 62 .sub-prefixes.have.to......be.ab
15ec0 6c 65 20 74 6f 20 74 65 6c 6c 20 74 68 65 6d 73 65 6c 76 65 73 20 61 70 61 72 74 20 66 72 6f 6d le.to.tell.themselves.apart.from
15ee0 20 74 68 65 20 70 72 65 66 69 78 20 74 68 65 79 20 77 65 72 65 20 69 6e 76 6f 6b 65 64 0a 20 20 .the.prefix.they.were.invoked...
15f00 20 20 20 66 72 6f 6d 2e 0a 0a 20 20 20 20 20 52 65 67 75 6c 61 72 20 73 75 66 66 69 78 20 63 6f ...from........Regular.suffix.co
15f20 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 20 70 72 65 66 69 78 65 73 2c 20 mmands,.which.are.not.prefixes,.
15f40 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 0a 20 20 20 20 20 63 6f 6e 63 65 72 6e 20 74 68 65 6d do.not.have.to......concern.them
15f60 73 65 6c 76 65 73 20 77 69 74 68 20 74 68 69 73 20 64 69 73 74 69 6e 63 74 69 6f 6e 2c 20 73 6f selves.with.this.distinction,.so
15f80 20 74 68 65 79 20 63 61 6e 20 75 73 65 20 74 68 69 73 0a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e .they.can.use.this......function
15fa0 20 69 6e 73 74 65 61 64 2e 20 20 49 6e 20 74 68 65 20 63 6f 6e 74 65 78 74 20 6f 66 20 61 20 70 .instead...In.the.context.of.a.p
15fc0 6c 61 69 6e 20 73 75 66 66 69 78 2c 20 69 74 20 61 6c 77 61 79 73 0a 20 20 20 20 20 72 65 74 75 lain.suffix,.it.always......retu
15fe0 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 rns.the.value.of.the.appropriate
16000 20 76 61 72 69 61 62 6c 65 2e 0a 0a 56 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d .variable...Variable:.transient-
16020 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 0a 20 20 20 20 20 54 68 65 20 74 72 61 6e 73 69 65 6e current-prefix......The.transien
16040 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 t.from.which.this.suffix.command
16060 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e 20 20 54 68 65 0a 20 20 20 20 20 76 61 6c 75 65 20 69 73 .was.invoked...The......value.is
16080 20 61 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 e2 80 99 20 6f 62 6a 65 63 74 .a....transient-prefix....object
160a0 2c 20 77 68 69 63 68 20 68 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20 20 20 20 20 61 ,.which.holds.information......a
160c0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 ssociated.with.the.transient.pre
160e0 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 56 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e fix.command...Variable:.transien
16100 74 2d 63 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 54 68 65 20 74 72 61 6e 73 t-current-command......The.trans
16120 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 20 73 75 66 66 69 78 20 63 6f 6d 6d ient.from.which.this.suffix.comm
16140 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e 20 20 54 68 65 0a 20 20 20 20 20 76 61 6c 75 65 and.was.invoked...The......value
16160 20 69 73 20 61 20 73 79 6d 62 6f 6c 2c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 .is.a.symbol,.the.transient.pref
16180 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 ix.command...Function:.transient
161a0 2d 61 63 74 69 76 65 2d 70 72 65 66 69 78 20 26 6f 70 74 69 6f 6e 61 6c 20 70 72 65 66 69 78 65 -active-prefix.&optional.prefixe
161c0 73 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 s......This.function.returns.the
161e0 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 6f 62 6a 65 63 74 2e 20 20 49 74 20 72 65 .active.transient.object...It.re
16200 74 75 72 6e 73 0a 20 20 20 20 20 e2 80 98 6e 69 6c e2 80 99 20 69 66 20 74 68 65 72 65 20 69 73 turns.........nil....if.there.is
16220 20 6e 6f 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 69 66 20 74 68 65 20 74 72 61 .no.active.transient,.if.the.tra
16240 6e 73 69 65 6e 74 20 62 75 66 66 65 72 0a 20 20 20 20 20 69 73 6e e2 80 99 74 20 73 68 6f 77 6e nsient.buffer......isn...t.shown
16260 2c 20 61 6e 64 20 77 68 69 6c 65 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 ,.and.while.the.active.transient
16280 20 69 73 20 73 75 73 70 65 6e 64 65 64 20 28 65 2e 67 2e 2c 0a 20 20 20 20 20 77 68 69 6c 65 20 .is.suspended.(e.g.,......while.
162a0 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 69 6e 20 75 73 65 29 2e 0a 0a 20 20 20 20 the.minibuffer.is.in.use).......
162c0 20 55 6e 6c 69 6b 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 .Unlike....transient-current-pre
162e0 66 69 78 e2 80 99 2c 20 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 20 65 76 65 72 20 6e 6f 6e 2d e2 fix...,.which.is.only.ever.non-.
16300 80 98 6e 69 6c e2 80 99 20 69 6e 0a 20 20 20 20 20 63 6f 64 65 20 74 68 61 74 20 69 73 20 72 75 ..nil....in......code.that.is.ru
16320 6e 20 64 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 20 n.directly.by.a.command.that.is.
16340 69 6e 76 6f 6b 65 64 20 77 68 69 6c 65 20 61 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 20 69 invoked.while.a......transient.i
16360 73 20 63 75 72 72 65 6e 74 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 6c 73 6f s.current,.this.function.is.also
16380 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 75 73 65 20 69 6e 0a 20 20 20 20 20 61 73 79 6e 63 68 .suitable.for.use.in......asynch
163a0 72 6f 6e 6f 75 73 20 63 6f 64 65 2c 20 73 75 63 68 20 61 73 20 74 69 6d 65 72 73 20 61 6e 64 20 ronous.code,.such.as.timers.and.
163c0 63 61 6c 6c 62 61 63 6b 73 20 28 74 68 69 73 20 66 75 6e 63 74 69 6f 6e e2 80 99 73 0a 20 20 20 callbacks.(this.function...s....
163e0 20 20 6d 61 69 6e 20 75 73 65 2d 63 61 73 65 29 2e 0a 0a 20 20 20 20 20 49 66 20 6f 70 74 69 6f ..main.use-case)........If.optio
16400 6e 61 6c 20 50 52 45 46 49 58 45 53 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 20 69 nal.PREFIXES.is.non-...nil...,.i
16420 74 20 6d 75 73 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 t.must.be.a.prefix.command......
16440 73 79 6d 62 6f 6c 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 73 79 6d 62 6f 6c 73 2c 20 69 6e 20 symbol.or.a.list.of.symbols,.in.
16460 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 0a which.case.the.active.transient.
16480 20 20 20 20 20 6f 62 6a 65 63 74 20 69 73 20 6f 6e 6c 79 20 72 65 74 75 72 6e 65 64 20 69 66 20 .....object.is.only.returned.if.
164a0 69 74 20 6d 61 74 63 68 65 73 20 6f 6e 65 20 6f 66 20 74 68 65 20 50 52 45 46 49 58 45 53 2e 0a it.matches.one.of.the.PREFIXES..
164c0 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 ...File:.doci3EOZM.info,..Node:.
164e0 54 72 61 6e 73 69 65 6e 74 20 53 74 61 74 65 2c 20 20 50 72 65 76 3a 20 43 75 72 72 65 6e 74 20 Transient.State,..Prev:.Current.
16500 50 72 65 66 69 78 20 43 6f 6d 6d 61 6e 64 2c 20 20 55 70 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 Prefix.Command,..Up:.Defining.Ne
16520 77 20 43 6f 6d 6d 61 6e 64 73 0a 0a 34 2e 39 20 54 72 61 6e 73 69 65 6e 74 20 53 74 61 74 65 0a w.Commands..4.9.Transient.State.
16540 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 49 6e 76 6f 6b 69 6e 67 20 61 20 ===================..Invoking.a.
16560 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 e2 80 9c 61 63 74 69 transient.prefix.command....acti
16580 76 61 74 65 73 e2 80 9d 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 0a 74 72 61 6e 73 69 65 6e vates....the.respective.transien
165a0 74 2c 20 69 2e 65 2e 2c 20 69 74 20 70 75 74 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 t,.i.e.,.it.puts.a.transient.key
165c0 6d 61 70 20 69 6e 74 6f 20 65 66 66 65 63 74 2c 20 77 68 69 63 68 20 62 69 6e 64 73 20 74 68 65 map.into.effect,.which.binds.the
165e0 0a 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 .transient...s.infix.and.suffix.
16600 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 commands......The.default.behavi
16620 6f 72 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 20 69 or.while.a.transient.is.active.i
16640 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 20 e2 80 a2 20 49 6e 76 6f 6b 69 6e 67 20 61 s.as.follows:.........Invoking.a
16660 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 61 66 66 65 63 74 20 n.infix.command.does.not.affect.
16680 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 3b 20 74 68 65 0a 20 20 20 20 20 74 72 the.transient.state;.the......tr
166a0 61 6e 73 69 65 6e 74 20 72 65 6d 61 69 6e 73 20 61 63 74 69 76 65 2e 0a 0a 20 20 20 e2 80 a2 20 ansient.remains.active..........
166c0 49 6e 76 6f 6b 69 6e 67 20 61 20 28 6e 6f 6e 2d 69 6e 66 69 78 29 20 73 75 66 66 69 78 20 63 6f Invoking.a.(non-infix).suffix.co
166e0 6d 6d 61 6e 64 20 e2 80 9c 64 65 61 63 74 69 76 61 74 65 73 e2 80 9d 20 74 68 65 20 74 72 61 6e mmand....deactivates....the.tran
16700 73 69 65 6e 74 0a 20 20 20 20 20 73 74 61 74 65 20 62 79 20 72 65 6d 6f 76 69 6e 67 20 74 68 65 sient......state.by.removing.the
16720 20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 20 61 6e 64 20 70 65 72 66 6f 72 6d 69 6e 67 .transient.keymap.and.performing
16740 20 73 6f 6d 65 0a 20 20 20 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6c 65 61 6e 75 70 2e 0a 0a .some......additional.cleanup...
16760 20 20 20 e2 80 a2 20 49 6e 76 6f 6b 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 .......Invoking.a.command.that.i
16780 73 20 62 6f 75 6e 64 20 69 6e 20 61 20 6b 65 79 6d 61 70 20 6f 74 68 65 72 20 74 68 61 6e 20 74 s.bound.in.a.keymap.other.than.t
167a0 68 65 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 20 69 73 20 64 69 73 61 he......transient.keymap.is.disa
167c0 6c 6c 6f 77 65 64 20 61 6e 64 20 74 72 79 69 6e 67 20 74 6f 20 64 6f 20 73 6f 20 72 65 73 75 6c llowed.and.trying.to.do.so.resul
167e0 74 73 20 69 6e 20 61 0a 20 20 20 20 20 77 61 72 6e 69 6e 67 2e 20 20 54 68 69 73 20 64 6f 65 73 ts.in.a......warning...This.does
16800 20 6e 6f 74 20 e2 80 9c 64 65 61 63 74 69 76 61 74 65 e2 80 9d 20 74 68 65 20 74 72 61 6e 73 69 .not....deactivate....the.transi
16820 65 6e 74 2e 0a 0a 20 20 20 54 68 65 20 62 65 68 61 76 69 6f 72 20 63 61 6e 20 62 65 20 63 68 61 ent......The.behavior.can.be.cha
16840 6e 67 65 64 20 66 6f 72 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 6f 66 20 61 20 70 61 72 74 69 nged.for.all.suffixes.of.a.parti
16860 63 75 6c 61 72 20 70 72 65 66 69 78 0a 61 6e 64 2f 6f 72 20 66 6f 72 20 69 6e 64 69 76 69 64 75 cular.prefix.and/or.for.individu
16880 61 6c 20 73 75 66 66 69 78 65 73 2e 20 20 54 68 65 20 76 61 6c 75 65 73 20 73 68 6f 75 6c 64 20 al.suffixes...The.values.should.
168a0 6e 65 61 72 6c 79 20 61 6c 77 61 79 73 20 62 65 0a 62 6f 6f 6c 65 61 6e 73 2c 20 62 75 74 20 63 nearly.always.be.booleans,.but.c
168c0 65 72 74 61 69 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 63 61 6c 6c 65 64 20 e2 80 9c 70 72 65 2d ertain.functions,.called....pre-
168e0 63 6f 6d 6d 61 6e 64 73 e2 80 9d 2c 20 63 61 6e 20 61 6c 73 6f 20 62 65 0a 75 73 65 64 2e 20 20 commands...,.can.also.be.used...
16900 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e 61 6d 65 64 20 e2 80 98 74 72 61 These.functions.are.named....tra
16920 6e 73 69 65 6e 74 2d 2d 64 6f 2d 56 45 52 42 e2 80 99 2c 20 61 6e 64 20 74 68 65 20 73 79 6d 62 nsient--do-VERB...,.and.the.symb
16940 6f 6c 0a e2 80 98 56 45 52 42 e2 80 99 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73 20 61 20 73 ol....VERB....can.be.used.as.a.s
16960 68 6f 72 74 68 61 6e 64 2e 0a 0a 20 20 20 41 20 62 6f 6f 6c 65 61 6e 20 69 73 20 69 6e 74 65 72 horthand......A.boolean.is.inter
16980 70 72 65 74 65 64 20 61 73 20 61 6e 73 77 65 72 69 6e 67 20 74 68 65 20 71 75 65 73 74 69 6f 6e preted.as.answering.the.question
169a0 20 22 64 6f 65 73 20 74 68 65 0a 74 72 61 6e 73 69 65 6e 74 20 73 74 61 79 20 61 63 74 69 76 65 ."does.the.transient.stay.active
169c0 2c 20 77 68 65 6e 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 3f 22 ,.when.this.command.is.invoked?"
169e0 20 20 e2 80 98 74 e2 80 99 20 6d 65 61 6e 73 20 74 68 61 74 0a 74 68 65 20 74 72 61 6e 73 69 65 .....t....means.that.the.transie
16a00 6e 74 20 73 74 61 79 73 20 61 63 74 69 76 65 2c 20 77 68 69 6c 65 20 e2 80 98 6e 69 6c e2 80 99 nt.stays.active,.while....nil...
16a20 20 6d 65 61 6e 73 20 74 68 61 74 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64 .means.that.invoking.the.command
16a40 0a 65 78 69 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 20 4e 6f 74 65 20 74 .exits.the.transient......Note.t
16a60 68 61 74 20 77 68 65 6e 20 74 68 65 20 73 75 66 66 69 78 20 69 73 20 61 20 e2 80 9c 73 75 62 2d hat.when.the.suffix.is.a....sub-
16a80 70 72 65 66 69 78 e2 80 9d 2c 20 69 6e 76 6f 6b 69 6e 67 20 74 68 61 74 20 63 6f 6d 6d 61 6e 64 prefix...,.invoking.that.command
16aa0 0a 61 6c 77 61 79 73 20 61 63 74 69 76 61 74 65 73 20 74 68 61 74 20 73 75 62 2d 70 72 65 66 69 .always.activates.that.sub-prefi
16ac0 78 2c 20 63 61 75 73 69 6e 67 20 74 68 65 20 6f 75 74 65 72 20 70 72 65 66 69 78 20 74 6f 20 6e x,.causing.the.outer.prefix.to.n
16ae0 6f 20 6c 6f 6e 67 65 72 0a 62 65 20 61 63 74 69 76 65 20 61 6e 64 20 64 69 73 70 6c 61 79 65 64 o.longer.be.active.and.displayed
16b00 2e 20 20 48 65 72 65 20 e2 80 98 74 e2 80 99 20 6d 65 61 6e 73 20 74 68 61 74 20 77 68 65 6e 20 ...Here....t....means.that.when.
16b20 79 6f 75 20 65 78 69 74 20 74 68 65 20 69 6e 6e 65 72 0a 70 72 65 66 69 78 2c 20 74 68 65 6e 20 you.exit.the.inner.prefix,.then.
16b40 74 68 65 20 6f 75 74 65 72 20 70 72 65 66 69 78 20 62 65 63 6f 6d 65 73 20 61 63 74 69 76 65 20 the.outer.prefix.becomes.active.
16b60 61 67 61 69 6e 2c 20 77 68 69 6c 65 20 e2 80 98 6e 69 6c e2 80 99 20 6d 65 61 6e 73 0a 74 68 61 again,.while....nil....means.tha
16b80 74 20 61 6c 6c 20 6f 75 74 65 72 20 70 72 65 66 69 78 65 73 20 61 72 65 20 65 78 69 74 65 64 20 t.all.outer.prefixes.are.exited.
16ba0 61 74 20 6f 6e 63 65 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 62 65 68 61 76 69 6f 72 20 66 6f at.once..........The.behavior.fo
16bc0 72 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 73 65 74 20 66 6f 72 20 61 20 r.non-suffixes.can.be.set.for.a.
16be0 70 61 72 74 69 63 75 6c 61 72 20 70 72 65 66 69 78 2c 0a 20 20 20 20 20 62 79 20 74 68 65 20 70 particular.prefix,......by.the.p
16c00 72 65 66 69 78 e2 80 99 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 refix...s....transient-non-suffi
16c20 78 e2 80 99 20 73 6c 6f 74 20 74 6f 20 61 20 62 6f 6f 6c 65 61 6e 2c 20 61 0a 20 20 20 20 20 73 x....slot.to.a.boolean,.a......s
16c40 75 69 74 61 62 6c 65 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f 6e 2c 20 6f 72 uitable.pre-command.function,.or
16c60 20 61 20 73 68 6f 72 74 68 61 6e 64 20 66 6f 72 20 73 75 63 68 20 61 20 66 75 6e 63 74 69 6f 6e .a.shorthand.for.such.a.function
16c80 2e 0a 20 20 20 20 20 53 65 65 20 2a 6e 6f 74 65 20 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f .......See.*note.Pre-commands.fo
16ca0 72 20 4e 6f 6e 2d 53 75 66 66 69 78 65 73 3a 3a 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 63 6f r.Non-Suffixes::..........The.co
16cc0 6d 6d 6f 6e 20 62 65 68 61 76 69 6f 72 20 66 6f 72 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f mmon.behavior.for.the.suffixes.o
16ce0 66 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 70 72 65 66 69 78 20 63 61 6e 20 62 65 0a 20 20 20 f.a.particular.prefix.can.be....
16d00 20 20 73 65 74 20 75 73 69 6e 67 20 74 68 65 20 70 72 65 66 69 78 e2 80 99 73 20 e2 80 98 74 72 ..set.using.the.prefix...s....tr
16d20 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 65 73 e2 80 99 20 73 6c 6f 74 2e 0a 0a 20 20 20 20 20 ansient-suffixes....slot........
16d40 54 68 65 20 76 61 6c 75 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 69 73 20 73 6c 6f 74 The.value.specified.in.this.slot
16d60 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 61 66 66 65 63 74 20 69 6e 66 69 78 65 73 2e 0a 20 20 20 20 .does.*not*.affect.infixes......
16d80 20 42 65 63 61 75 73 65 20 69 74 20 61 66 66 65 63 74 73 20 62 6f 74 68 20 72 65 67 75 6c 61 72 .Because.it.affects.both.regular
16da0 20 73 75 66 66 69 78 65 73 20 61 73 20 77 65 6c 6c 20 61 73 20 73 75 62 2d 70 72 65 66 69 78 65 .suffixes.as.well.as.sub-prefixe
16dc0 73 2c 0a 20 20 20 20 20 77 68 69 63 68 20 68 61 76 65 20 64 69 66 66 65 72 65 6e 74 20 6e 65 65 s,......which.have.different.nee
16de0 64 73 2c 20 69 74 20 69 73 20 62 65 73 74 20 74 6f 20 61 76 6f 69 64 20 65 78 70 6c 69 63 69 74 ds,.it.is.best.to.avoid.explicit
16e00 6c 79 0a 20 20 20 20 20 73 70 65 63 69 66 79 69 6e 67 20 61 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a ly......specifying.a.function...
16e20 20 20 20 e2 80 a2 20 54 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6e 20 69 6e 64 69 76 69 .......The.behavior.of.an.indivi
16e40 64 75 61 6c 20 73 75 66 66 69 78 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 75 73 69 6e 67 dual.suffix.can.be.changed.using
16e60 20 69 74 73 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 73 6c 6f 74 2e 20 .its.........transient....slot..
16e80 20 57 68 69 6c 65 20 69 74 20 69 73 20 75 73 75 61 6c 6c 79 20 62 65 73 74 20 74 6f 20 75 73 65 .While.it.is.usually.best.to.use
16ea0 20 61 20 62 6f 6f 6c 65 61 6e 2c 20 66 6f 72 0a 20 20 20 20 20 74 68 69 73 20 73 6c 6f 74 20 69 .a.boolean,.for......this.slot.i
16ec0 74 20 63 61 6e 20 6f 63 63 61 73 69 6f 6e 61 6c 6c 79 20 6d 61 6b 65 20 73 65 6e 73 65 20 74 6f t.can.occasionally.make.sense.to
16ee0 20 73 70 65 63 69 66 79 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 65 78 70 6c 69 63 69 .specify.a.function......explici
16f00 74 6c 79 2e 0a 0a 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 73 6c 6f 74 20 63 tly........Note.that.this.slot.c
16f20 61 6e 20 62 65 20 73 65 74 20 77 68 65 6e 20 64 65 66 69 6e 69 6e 67 20 61 20 73 75 66 66 69 78 an.be.set.when.defining.a.suffix
16f40 20 63 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 .command.using.........transient
16f60 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 e2 80 99 20 61 6e 64 2f 6f 72 20 69 6e 20 74 68 65 20 -define-suffix....and/or.in.the.
16f80 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 2e 0a 20 20 20 20 20 49 definition.of.the.prefix.......I
16fa0 66 20 73 65 74 20 69 6e 20 62 6f 74 68 20 70 6c 61 63 65 73 2c 20 74 68 65 6e 20 74 68 65 20 6c f.set.in.both.places,.then.the.l
16fc0 61 74 74 65 72 20 74 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 2c 20 61 73 20 75 73 75 61 6c atter.takes.precedence,.as.usual
16fe0 2e 0a 0a 20 20 20 54 68 65 20 61 76 61 69 6c 61 62 6c 65 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 ......The.available.pre-command.
17000 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 functions.are.documented.in.the.
17020 66 6f 6c 6c 6f 77 69 6e 67 0a 73 75 62 2d 73 65 63 74 69 6f 6e 73 2e 20 20 54 68 65 79 20 61 72 following.sub-sections...They.ar
17040 65 20 63 61 6c 6c 65 64 20 62 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f e.called.by....transient--pre-co
17060 6d 6d 61 6e 64 e2 80 99 2c 20 61 20 66 75 6e 63 74 69 6f 6e 0a 6f 6e 20 e2 80 98 70 72 65 2d 63 mmand...,.a.function.on....pre-c
17080 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b e2 80 99 2c 20 61 6e 64 20 74 68 65 20 76 61 6c 75 65 20 74 68 ommand-hook...,.and.the.value.th
170a0 61 74 20 74 68 65 79 20 72 65 74 75 72 6e 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 at.they.return.determines.whethe
170c0 72 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 65 78 69 74 65 64 2e 20 20 54 6f 20 64 r.the.transient.is.exited...To.d
170e0 6f 20 73 6f 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 63 6f 6e o.so.the.value.of.one.of.the.con
17100 73 74 61 6e 74 73 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 e2 80 99 20 6f 72 20 stants....transient--exit....or.
17120 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 e2 80 99 20 69 73 20 75 73 65 64 20 28 74 ...transient--stay....is.used.(t
17140 68 61 74 20 77 61 79 20 77 65 20 64 6f 6e e2 80 99 74 20 68 61 76 65 0a 74 6f 20 72 65 6d 65 6d hat.way.we.don...t.have.to.remem
17160 62 65 72 20 69 66 20 e2 80 98 74 e2 80 99 20 6d 65 61 6e 73 20 e2 80 9c 65 78 69 74 e2 80 9d 20 ber.if....t....means....exit....
17180 6f 72 20 e2 80 9c 73 74 61 79 e2 80 9d 29 2e 0a 0a 20 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 or....stay...)......Additionally
171a0 2c 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 6d 61 79 20 63 68 61 6e 67 65 20 74 68 65 ,.these.functions.may.change.the
171c0 20 76 61 6c 75 65 20 6f 66 20 e2 80 98 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 e2 80 99 0a 28 77 68 .value.of....this-command....(wh
171e0 69 63 68 20 65 78 70 6c 61 69 6e 73 20 77 68 79 20 74 68 65 79 20 68 61 76 65 20 74 6f 20 62 65 ich.explains.why.they.have.to.be
17200 20 63 61 6c 6c 65 64 20 75 73 69 6e 67 20 e2 80 98 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f .called.using....pre-command-hoo
17220 6b e2 80 99 29 2c 0a 63 61 6c 6c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 65 78 70 6f 72 74 e2 k...),.call....transient-export.
17240 80 99 2c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 7a 61 70 e2 80 99 20 6f ..,....transient--stack-zap....o
17260 72 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 70 75 73 68 e2 80 99 3b 20 61 r....transient--stack-push...;.a
17280 6e 64 20 73 65 74 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e nd.set.the.values.of....transien
172a0 74 2d 2d 65 78 69 74 70 e2 80 99 2c 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 t--exitp...,....transient--helpp
172c0 e2 80 99 20 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 e2 80 99 2e 0a 0a ....or....transient--editp......
172e0 20 20 20 46 6f 72 20 63 6f 6d 70 6c 65 74 65 6e 65 73 73 20 73 61 6b 65 2c 20 73 6f 6d 65 20 6e ...For.completeness.sake,.some.n
17300 6f 74 65 73 20 61 62 6f 75 74 20 63 6f 6d 70 6c 69 63 61 74 69 6f 6e 73 3a 0a 0a 20 20 20 e2 80 otes.about.complications:.......
17320 a2 20 54 68 65 20 74 72 61 6e 73 69 65 6e 74 2d 6e 65 73 73 20 6f 66 20 63 65 72 74 61 69 6e 20 ..The.transient-ness.of.certain.
17340 62 75 69 6c 74 2d 69 6e 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 69 73 20 73 70 65 63 built-in.suffix.commands.is.spec
17360 69 66 69 65 64 0a 20 20 20 20 20 75 73 69 6e 67 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 72 ified......using....transient-pr
17380 65 64 69 63 61 74 65 2d 6d 61 70 e2 80 99 2e 20 20 54 68 69 73 20 69 73 20 61 20 73 70 65 63 69 edicate-map......This.is.a.speci
173a0 61 6c 20 6b 65 79 6d 61 70 2c 20 77 68 69 63 68 0a 20 20 20 20 20 62 69 6e 64 73 20 63 6f 6d 6d al.keymap,.which......binds.comm
173c0 61 6e 64 73 20 74 6f 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 28 61 73 20 6f 70 70 6f 73 65 64 ands.to.pre-commands.(as.opposed
173e0 20 74 6f 20 6b 65 79 73 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 29 20 61 6e 64 0a 20 20 20 20 20 74 .to.keys.to.commands).and......t
17400 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 20 6f 76 65 72 20 74 68 65 20 70 72 65 66 69 78 e2 akes.precedence.over.the.prefix.
17420 80 99 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 20 73 6c 6f 74 2c ..s....transient-suffix....slot,
17440 20 62 75 74 20 6e 6f 74 0a 20 20 20 20 20 74 68 65 20 73 75 66 66 69 78 e2 80 99 73 20 e2 80 98 .but.not......the.suffix...s....
17460 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 73 6c 6f 74 2e 0a 0a 20 20 20 e2 80 a2 20 57 68 69 6c 65 transient....slot..........While
17480 20 61 20 73 75 62 2d 70 72 65 66 69 78 20 69 73 20 61 63 74 69 76 65 20 77 65 20 6e 65 61 72 6c .a.sub-prefix.is.active.we.nearl
174a0 79 20 61 6c 77 61 79 73 20 77 61 6e 74 20 e2 80 98 43 2d 67 e2 80 99 20 74 6f 20 74 61 6b 65 0a y.always.want....C-g....to.take.
174c0 20 20 20 20 20 74 68 65 20 75 73 65 72 20 62 61 63 6b 20 74 6f 20 74 68 65 20 e2 80 9c 73 75 70 .....the.user.back.to.the....sup
174e0 65 72 2d 70 72 65 66 69 78 e2 80 9d 2c 20 65 76 65 6e 20 77 68 65 6e 20 74 68 65 20 6f 74 68 65 er-prefix...,.even.when.the.othe
17500 72 20 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 64 6f 6e e2 80 99 74 20 64 6f 20 74 68 61 74 2e r.suffixes......don...t.do.that.
17520 20 20 48 6f 77 65 76 65 72 2c 20 69 6e 20 72 61 72 65 20 63 61 73 65 73 20 74 68 69 73 20 6d 61 ..However,.in.rare.cases.this.ma
17540 79 20 6e 6f 74 20 62 65 20 64 65 73 69 72 61 62 6c 65 2c 0a 20 20 20 20 20 69 6e 20 77 68 69 63 y.not.be.desirable,......in.whic
17560 68 20 63 61 73 65 20 e2 80 98 72 65 70 6c 61 63 65 e2 80 99 20 63 61 6e 20 62 65 20 75 73 65 64 h.case....replace....can.be.used
17580 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 73 75 62 2d 70 72 .as.the.value.of.the......sub-pr
175a0 65 66 69 78 e2 80 99 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 73 6c 6f 74 2e 0a 0a efix...s....transient....slot...
175c0 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 49 6e 66 69 78 65 73 0a 2d 2d 2d 2d 2d 2d 2d Pre-commands.for.Infixes.-------
175e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 66 -----------------..The.default.f
17600 6f 72 20 69 6e 66 69 78 65 73 20 69 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 or.infixes.is....transient--do-s
17620 74 61 79 e2 80 99 2e 20 20 54 68 69 73 20 69 73 20 61 6c 73 6f 20 74 68 65 20 6f 6e 6c 79 0a 66 tay......This.is.also.the.only.f
17640 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 66 6f 72 20 69 6e 66 unction.that.makes.sense.for.inf
17660 69 78 65 73 2c 20 77 68 69 63 68 20 69 73 20 77 68 79 20 74 68 69 73 20 70 72 65 64 69 63 61 74 ixes,.which.is.why.this.predicat
17680 65 20 69 73 0a 75 73 65 64 20 65 76 65 6e 20 69 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 e.is.used.even.if.the.value.of.t
176a0 68 65 20 70 72 65 66 69 78 e2 80 99 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 he.prefix...s....transient-suffi
176c0 78 e2 80 99 20 73 6c 6f 74 20 69 73 20 e2 80 98 74 e2 80 99 2e 0a 49 6e 20 65 78 74 72 65 6d 65 x....slot.is....t.....In.extreme
176e0 6c 79 20 72 61 72 65 20 63 61 73 65 73 2c 20 6f 6e 65 20 6d 69 67 68 74 20 77 61 6e 74 20 74 6f ly.rare.cases,.one.might.want.to
17700 20 75 73 65 20 73 6f 6d 65 74 68 69 6e 67 20 65 6c 73 65 2c 20 77 68 69 63 68 20 63 61 6e 0a 62 .use.something.else,.which.can.b
17720 65 20 64 6f 6e 65 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 69 6e 66 69 78 e2 80 99 73 20 e.done.by.setting.the.infix...s.
17740 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 73 6c 6f 74 20 64 69 72 65 63 74 6c 79 2e 0a 0a ...transient....slot.directly...
17760 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 73 74 61 79 0a 20 20 Function:.transient...do-stay...
17780 20 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 65 78 70 6f ...Call.the.command.without.expo
177a0 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 rting.variables.and.stay.transie
177c0 6e 74 2e 0a 0a 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 53 75 66 66 69 78 65 73 0a 2d nt...Pre-commands.for.Suffixes.-
177e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 42 79 20 64 65 66 ------------------------..By.def
17800 61 75 6c 74 2c 20 69 6e 76 6f 6b 69 6e 67 20 61 20 73 75 66 66 69 78 20 63 61 75 73 65 73 20 74 ault,.invoking.a.suffix.causes.t
17820 68 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 62 65 20 65 78 69 74 65 64 2e 0a 0a 20 20 20 54 he.transient.to.be.exited......T
17840 68 65 20 62 65 68 61 76 69 6f 72 20 66 6f 72 20 61 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 he.behavior.for.an.individual.su
17860 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 62 79 0a 73 ffix.command.can.be.changed.by.s
17880 65 74 74 69 6e 67 20 69 74 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 73 6c 6f 74 20 etting.its....transient....slot.
178a0 74 6f 20 61 20 62 6f 6f 6c 65 61 6e 20 28 77 68 69 63 68 20 69 73 20 68 69 67 68 6c 79 20 72 65 to.a.boolean.(which.is.highly.re
178c0 63 6f 6d 6d 65 6e 64 65 64 29 2c 0a 6f 72 20 74 6f 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c commended),.or.to.one.of.the.fol
178e0 6c 6f 77 69 6e 67 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 lowing.pre-commands...Function:.
17900 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 65 78 69 74 0a 20 20 20 20 20 43 61 6c 6c 20 74 68 transient...do-exit......Call.th
17920 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 e.command.after.exporting.variab
17940 6c 65 73 20 61 6e 64 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 46 75 6e les.and.exit.the.transient...Fun
17960 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 72 65 74 75 72 6e 0a 20 20 20 ction:.transient...do-return....
17980 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 78 70 6f 72 74 69 ..Call.the.command.after.exporti
179a0 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 20 70 ng.variables.and.return.to.the.p
179c0 61 72 65 6e 74 0a 20 20 20 20 20 70 72 65 66 69 78 2e 20 20 49 66 20 74 68 65 72 65 20 69 73 20 arent......prefix...If.there.is.
179e0 6e 6f 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 63 61 6c 6c 0a 20 20 20 20 no.parent.prefix,.then.call.....
17a00 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 e2 80 99 2e 0a 0a 46 75 6e 63 ....transient--do-exit......Func
17a20 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 63 61 6c 6c 0a 20 20 20 20 20 43 tion:.transient...do-call......C
17a40 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 78 70 6f 72 74 69 6e 67 20 all.the.command.after.exporting.
17a60 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 variables.and.stay.transient....
17a80 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 61 72 65 ..The.following.pre-commands.are
17aa0 20 6f 6e 6c 79 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 73 75 62 2d 70 72 65 66 69 78 65 73 2e .only.suitable.for.sub-prefixes.
17ac0 20 20 49 74 20 69 73 0a 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 65 78 70 6c 69 63 69 ..It.is.not.necessary.to.explici
17ae0 74 6c 79 20 75 73 65 20 74 68 65 73 65 20 70 72 65 64 69 63 61 74 65 73 20 62 65 63 61 75 73 65 tly.use.these.predicates.because
17b00 20 74 68 65 20 63 6f 72 72 65 63 74 0a 70 72 65 64 69 63 61 74 65 20 69 73 20 61 75 74 6f 6d 61 .the.correct.predicate.is.automa
17b20 74 69 63 61 6c 6c 79 20 70 69 63 6b 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 76 61 6c 75 tically.picked.based.on.the.valu
17b40 65 20 6f 66 20 74 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 0a 73 6c 6f 74 20 66 6f e.of.the....transient....slot.fo
17b60 72 20 74 68 65 20 73 75 62 2d 70 72 65 66 69 78 20 69 74 73 65 6c 66 2e 0a 0a 46 75 6e 63 74 69 r.the.sub-prefix.itself...Functi
17b80 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 72 65 63 75 72 73 65 0a 20 20 20 20 20 on:.transient...do-recurse......
17ba0 43 61 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e Call.the.transient.prefix.comman
17bc0 64 2c 20 70 72 65 70 61 72 69 6e 67 20 66 6f 72 20 72 65 74 75 72 6e 20 74 6f 20 6f 75 74 65 72 d,.preparing.for.return.to.outer
17be0 0a 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 20 20 20 57 68 65 74 68 65 72 20 77 ......transient........Whether.w
17c00 65 20 61 63 74 75 61 6c 6c 79 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 e.actually.return.to.the.parent.
17c20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 75 6c 74 69 6d 61 74 65 6c 79 0a 20 20 20 20 20 75 6e 64 transient.is.ultimately......und
17c40 65 72 20 74 68 65 20 63 6f 6e 74 72 6f 6c 20 6f 66 20 65 61 63 68 20 69 6e 76 6f 6b 65 64 20 73 er.the.control.of.each.invoked.s
17c60 75 66 66 69 78 2e 20 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 0a 20 uffix...The.difference.between..
17c80 20 20 20 20 74 68 69 73 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 e2 80 98 74 72 61 6e ....this.pre-command.and....tran
17ca0 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 6b e2 80 99 20 69 73 20 74 68 61 74 20 69 74 20 63 68 sient--do-stack....is.that.it.ch
17cc0 61 6e 67 65 73 20 74 68 65 0a 20 20 20 20 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 e2 80 98 74 anges.the......value.of.the....t
17ce0 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 20 73 6c 6f 74 20 74 6f 20 e2 80 98 74 e2 ransient-suffix....slot.to....t.
17d00 80 99 2e 0a 0a 20 20 20 20 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 61 72 65 6e 74 20 ..........If.there.is.no.parent.
17d20 74 72 61 6e 73 69 65 6e 74 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 63 61 6c 6c 20 74 68 69 73 20 63 transient,.then.only.call.this.c
17d40 6f 6d 6d 61 6e 64 20 61 6e 64 0a 20 20 20 20 20 73 6b 69 70 20 74 68 65 20 73 65 63 6f 6e 64 20 ommand.and......skip.the.second.
17d60 73 74 65 70 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d step...Function:.transient...do-
17d80 73 74 61 63 6b 0a 20 20 20 20 20 43 61 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 stack......Call.the.transient.pr
17da0 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 73 74 61 63 6b 69 6e 67 20 74 68 65 20 61 63 74 69 76 efix.command,.stacking.the.activ
17dc0 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 20 20 20 20 20 50 75 73 68 20 74 68 65 20 61 63 74 69 76 e.transient.......Push.the.activ
17de0 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 e.transient.to.the.transient.sta
17e00 63 6b 2e 0a 0a 20 20 20 20 20 55 6e 6c 65 73 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 64 ck........Unless....transient--d
17e20 6f 2d 72 65 63 75 72 73 65 e2 80 99 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 75 73 65 64 2c o-recurse....is.explicitly.used,
17e40 20 74 68 69 73 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 69 73 20 61 75 74 6f 6d 61 .this.pre-command......is.automa
17e60 74 69 63 61 6c 6c 79 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 tically.used.for.suffixes.that.a
17e80 72 65 20 70 72 65 66 69 78 65 73 20 74 68 65 6d 73 65 6c 76 65 73 2c 0a 20 20 20 20 20 69 2e 65 re.prefixes.themselves,......i.e
17ea0 2e 2c 20 66 6f 72 20 73 75 62 2d 70 72 65 66 69 78 65 73 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 .,.for.sub-prefixes...Function:.
17ec0 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 72 65 70 6c 61 63 65 0a 20 20 20 20 20 43 61 6c 6c transient...do-replace......Call
17ee0 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 72 .the.transient.prefix.command,.r
17f00 65 70 6c 61 63 69 6e 67 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 20 eplacing.the.active.transient...
17f20 20 20 20 20 44 6f 20 6e 6f 74 20 70 75 73 68 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 ....Do.not.push.the.active.trans
17f40 69 65 6e 74 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 0a 0a 20 20 ient.to.the.transient.stack.....
17f60 20 20 20 55 6e 6c 65 73 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 ...Unless....transient--do-recur
17f80 73 65 e2 80 99 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 75 73 65 64 2c 20 74 68 69 73 20 70 se....is.explicitly.used,.this.p
17fa0 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 re-command......is.automatically
17fc0 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 65 20 70 72 65 66 .used.for.suffixes.that.are.pref
17fe0 69 78 65 73 20 74 68 65 6d 73 65 6c 76 65 73 2c 0a 20 20 20 20 20 69 2e 65 2e 2c 20 66 6f 72 20 ixes.themselves,......i.e.,.for.
18000 73 75 62 2d 70 72 65 66 69 78 65 73 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 sub-prefixes...Function:.transie
18020 6e 74 e2 80 93 64 6f 2d 73 75 73 70 65 6e 64 0a 20 20 20 20 20 53 75 73 70 65 6e 64 20 74 68 65 nt...do-suspend......Suspend.the
18040 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 73 61 76 69 6e 67 20 74 68 65 20 74 72 .active.transient,.saving.the.tr
18060 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 75 73 65 ansient.stack........This.is.use
18080 64 20 62 79 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 d.by.the.command....transient-su
180a0 73 70 65 6e 64 e2 80 99 20 61 6e 64 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 61 6c 73 6f 0a 20 20 20 spend....and.optionally.also....
180c0 20 20 62 79 20 e2 80 9c 65 78 74 65 72 6e 61 6c 20 65 76 65 6e 74 73 e2 80 9d 20 73 75 63 68 20 ..by....external.events....such.
180e0 61 73 20 e2 80 98 68 61 6e 64 6c 65 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 e2 80 99 2e 20 20 53 as....handle-switch-frame......S
18100 75 63 68 20 62 69 6e 64 69 6e 67 73 0a 20 20 20 20 20 73 68 6f 75 6c 64 20 62 65 20 61 64 64 65 uch.bindings......should.be.adde
18120 64 20 74 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 e2 d.to....transient-predicate-map.
18140 80 99 2e 0a 0a 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 4e 6f 6e 2d 53 75 66 66 69 78 .....Pre-commands.for.Non-Suffix
18160 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d es.-----------------------------
18180 0a 0a 42 79 20 64 65 66 61 75 6c 74 2c 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 28 63 6f 6d 6d ..By.default,.non-suffixes.(comm
181a0 61 6e 64 73 20 74 68 61 74 20 61 72 65 20 62 6f 75 6e 64 20 69 6e 20 6f 74 68 65 72 20 6b 65 79 ands.that.are.bound.in.other.key
181c0 6d 61 70 73 0a 62 65 73 69 64 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 maps.beside.the.transient.keymap
181e0 29 20 63 61 6e 6e 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 2e 20 20 54 72 79 69 6e 67 20 74 6f 20 ).cannot.be.invoked...Trying.to.
18200 69 6e 76 6f 6b 65 20 73 75 63 68 20 61 0a 63 6f 6d 6d 61 6e 64 20 72 65 73 75 6c 74 73 20 69 6e invoke.such.a.command.results.in
18220 20 61 20 77 61 72 6e 69 6e 67 20 61 6e 64 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 .a.warning.and.the.transient.sta
18240 79 73 20 61 63 74 69 76 65 2e 0a 0a 20 20 20 49 66 20 79 6f 75 20 77 61 6e 74 20 61 20 64 69 66 ys.active......If.you.want.a.dif
18260 66 65 72 65 6e 74 20 62 65 68 61 76 69 6f 72 2c 20 74 68 65 6e 20 73 65 74 20 74 68 65 20 e2 80 ferent.behavior,.then.set.the...
18280 98 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 e2 80 99 0a 73 6c 6f 74 20 6f 66 .transient-non-suffix....slot.of
182a0 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 .the.transient.prefix.command...
182c0 54 68 65 20 76 61 6c 75 65 20 73 68 6f 75 6c 64 20 62 65 20 61 20 62 6f 6f 6c 65 61 6e 2c 0a 61 The.value.should.be.a.boolean,.a
182e0 6e 73 77 65 72 69 6e 67 20 74 68 65 20 71 75 65 73 74 69 6f 6e 2c 20 22 69 73 20 69 74 20 61 6c nswering.the.question,."is.it.al
18300 6c 6f 77 65 64 20 74 6f 20 69 6e 76 6f 6b 65 20 6e 6f 6e 2d 73 75 66 66 69 78 20 63 6f 6d 6d 61 lowed.to.invoke.non-suffix.comma
18320 6e 64 73 3f 2c 20 61 0a 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f 6e 2c 20 6f 72 nds?,.a.pre-command.function,.or
18340 20 61 20 73 68 6f 72 74 68 61 6e 64 20 66 6f 72 20 73 75 63 68 20 61 20 66 75 6e 63 74 69 6f 6e .a.shorthand.for.such.a.function
18360 2e 0a 0a 20 20 20 49 66 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 e2 80 98 74 e2 80 99 2c 20 74 ......If.the.value.is....t...,.t
18380 68 65 6e 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 69 6e 76 6f 6b 65 64 2c hen.non-suffixes.can.be.invoked,
183a0 20 77 68 65 6e 20 69 74 20 69 73 0a e2 80 98 6e 69 6c e2 80 99 20 28 74 68 65 20 64 65 66 61 75 .when.it.is....nil....(the.defau
183c0 6c 74 29 20 74 68 65 6e 20 74 68 65 79 20 63 61 6e 6e 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 2e lt).then.they.cannot.be.invoked.
183e0 0a 0a 20 20 20 54 68 65 20 6f 6e 6c 79 20 6f 74 68 65 72 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 .....The.only.other.recommended.
18400 76 61 6c 75 65 20 69 73 20 e2 80 98 6c 65 61 76 65 e2 80 99 2e 20 20 49 66 20 74 68 61 74 20 69 value.is....leave......If.that.i
18420 73 20 75 73 65 64 2c 20 74 68 65 6e 0a 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 s.used,.then.non-suffixes.can.be
18440 20 69 6e 76 6f 6b 65 64 2c 20 62 75 74 20 69 66 20 6f 6e 65 20 69 73 20 69 6e 76 6f 6b 65 64 2c .invoked,.but.if.one.is.invoked,
18460 20 74 68 65 6e 20 74 68 61 74 20 65 78 69 74 73 20 74 68 65 0a 74 72 61 6e 73 69 65 6e 74 2e 0a .then.that.exits.the.transient..
18480 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 77 61 72 6e 0a 20 .Function:.transient...do-warn..
184a0 20 20 20 20 43 61 6c 6c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 e2 ....Call....transient-undefined.
184c0 80 99 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 46 75 6e 63 74 69 6f 6e ...and.stay.transient...Function
184e0 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 73 74 61 79 0a 20 20 20 20 20 43 61 6c 6c 20 :.transient...do-stay......Call.
18500 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 65 78 70 6f 72 74 69 6e 67 20 76 61 the.command.without.exporting.va
18520 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 46 75 6e riables.and.stay.transient...Fun
18540 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 6c 65 61 76 65 0a 20 20 20 20 ction:.transient...do-leave.....
18560 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 65 78 70 6f 72 74 .Call.the.command.without.export
18580 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 65 78 69 74 20 74 68 65 0a 20 20 20 20 20 ing.variables.and.exit.the......
185a0 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 53 70 65 63 69 61 6c 20 50 72 65 2d 43 6f 6d 6d 61 6e 64 73 transient...Special.Pre-Commands
185c0 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 75 6e 63 74 69 6f 6e 3a .--------------------..Function:
185e0 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 71 75 69 74 2d 6f 6e 65 0a 20 20 20 20 20 49 66 .transient...do-quit-one......If
18600 20 61 63 74 69 76 65 2c 20 71 75 69 74 20 68 65 6c 70 20 6f 72 20 65 64 69 74 20 6d 6f 64 65 2c .active,.quit.help.or.edit.mode,
18620 20 65 6c 73 65 20 65 78 69 74 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e .else.exit.the.active.transient.
18640 0a 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 65 .......This.is.used.when.the.use
18660 72 20 70 72 65 73 73 65 64 20 e2 80 98 43 2d 67 e2 80 99 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 r.pressed....C-g......Function:.
18680 74 72 61 6e 73 69 65 6e 74 e2 80 93 64 6f 2d 71 75 69 74 2d 61 6c 6c 0a 20 20 20 20 20 45 78 69 transient...do-quit-all......Exi
186a0 74 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 77 69 74 68 6f 75 74 20 73 61 76 69 6e 67 20 t.all.transients.without.saving.
186c0 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 the.transient.stack........This.
186e0 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 70 72 65 73 73 65 64 20 e2 80 is.used.when.the.user.pressed...
18700 98 43 2d 71 e2 80 99 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 .C-q......Function:.transient...
18720 64 6f 2d 73 75 73 70 65 6e 64 0a 20 20 20 20 20 53 75 73 70 65 6e 64 20 74 68 65 20 61 63 74 69 do-suspend......Suspend.the.acti
18740 76 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 73 61 76 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 ve.transient,.saving.the.transie
18760 6e 74 20 73 74 61 63 6b 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 77 68 65 nt.stack........This.is.used.whe
18780 6e 20 74 68 65 20 75 73 65 72 20 70 72 65 73 73 65 64 20 e2 80 98 43 2d 7a e2 80 99 2e 0a 0a 1f n.the.user.pressed....C-z.......
187a0 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 43 6c .File:.doci3EOZM.info,..Node:.Cl
187c0 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 2c 20 20 4e 65 78 74 3a 20 46 41 51 2c 20 20 asses.and.Methods,..Next:.FAQ,..
187e0 50 72 65 76 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 6e 64 73 2c 20 20 55 70 Prev:.Defining.New.Commands,..Up
18800 3a 20 54 6f 70 0a 0a 35 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 2a 2a 2a :.Top..5.Classes.and.Methods.***
18820 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 54 72 61 6e 73 69 65 6e 74 20 75 73 ******************..Transient.us
18840 65 73 20 63 6c 61 73 73 65 73 20 61 6e 64 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 es.classes.and.generic.functions
18860 20 74 6f 20 6d 61 6b 65 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 0a 64 65 66 69 6e 65 20 6e .to.make.it.possible.to.define.n
18880 65 77 20 74 79 70 65 73 20 6f 66 20 73 75 66 66 69 78 20 61 6e 64 20 70 72 65 66 69 78 20 63 6f ew.types.of.suffix.and.prefix.co
188a0 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 20 61 72 65 20 73 69 6d 69 6c 61 72 20 74 6f 0a 65 78 69 mmands,.which.are.similar.to.exi
188c0 73 74 69 6e 67 20 74 79 70 65 73 2c 20 62 75 74 20 62 65 68 61 76 65 20 64 69 66 66 65 72 65 6e sting.types,.but.behave.differen
188e0 74 6c 79 20 69 6e 20 73 6f 6d 65 20 72 65 73 70 65 63 74 73 2e 0a 0a 20 20 20 45 76 65 72 79 20 tly.in.some.respects......Every.
18900 70 72 65 66 69 78 2c 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 prefix,.infix.and.suffix.command
18920 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 6e 20 6f 62 6a 65 63 74 2c 0a 77 .is.associated.with.an.object,.w
18940 68 69 63 68 20 68 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 77 68 69 63 68 20 63 6f hich.holds.information,.which.co
18960 6e 74 72 6f 6c 73 20 63 65 72 74 61 69 6e 20 61 73 70 65 63 74 73 20 6f 66 20 69 74 73 20 62 65 ntrols.certain.aspects.of.its.be
18980 68 61 76 69 6f 72 2e 0a 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 6e 20 74 77 6f 20 77 61 79 73 havior..This.happens.in.two.ways
189a0 2e 0a 0a 20 20 20 e2 80 a2 20 41 73 73 6f 63 69 61 74 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 ..........Associating.a.command.
189c0 77 69 74 68 20 61 20 63 65 72 74 61 69 6e 20 63 6c 61 73 73 20 67 69 76 65 73 20 74 68 65 20 63 with.a.certain.class.gives.the.c
189e0 6f 6d 6d 61 6e 64 20 61 0a 20 20 20 20 20 74 79 70 65 2e 20 20 54 68 69 73 20 6d 61 6b 65 73 20 ommand.a......type...This.makes.
18a00 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 75 73 65 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 it.possible.to.use.generic.funct
18a20 69 6f 6e 73 20 74 6f 20 64 6f 0a 20 20 20 20 20 63 65 72 74 61 69 6e 20 74 68 69 6e 67 73 20 74 ions.to.do......certain.things.t
18a40 68 61 74 20 68 61 76 65 20 74 6f 20 62 65 20 64 6f 6e 65 20 64 69 66 66 65 72 65 6e 74 6c 79 20 hat.have.to.be.done.differently.
18a60 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 61 74 0a 20 20 20 20 20 74 79 70 65 20 6f 66 20 63 depending.on.what......type.of.c
18a80 6f 6d 6d 61 6e 64 20 69 74 20 61 63 74 73 20 6f 6e 2e 0a 0a 20 20 20 20 20 54 68 61 74 20 69 6e ommand.it.acts.on........That.in
18aa0 20 74 75 72 6e 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 74 68 69 72 .turn.makes.it.possible.for.thir
18ac0 64 2d 70 61 72 74 69 65 73 20 74 6f 20 61 64 64 20 6e 65 77 20 74 79 70 65 73 0a 20 20 20 20 20 d-parties.to.add.new.types......
18ae0 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 63 6f 6e 76 69 6e 63 65 20 74 68 65 20 6d without.having.to.convince.the.m
18b00 61 69 6e 74 61 69 6e 65 72 20 6f 66 20 54 72 61 6e 73 69 65 6e 74 2c 20 74 68 61 74 20 74 68 61 aintainer.of.Transient,.that.tha
18b20 74 0a 20 20 20 20 20 6e 65 77 20 74 79 70 65 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 65 6e 6f t......new.type.is.important.eno
18b40 75 67 68 20 74 6f 20 6a 75 73 74 69 66 79 20 61 64 64 69 6e 67 20 61 20 73 70 65 63 69 61 6c 20 ugh.to.justify.adding.a.special.
18b60 63 61 73 65 20 74 6f 20 61 0a 20 20 20 20 20 64 6f 7a 65 6e 20 6f 72 20 73 6f 20 66 75 6e 63 74 case.to.a......dozen.or.so.funct
18b80 69 6f 6e 73 2e 0a 0a 20 20 20 e2 80 a2 20 41 73 73 6f 63 69 61 74 69 6e 67 20 61 20 63 6f 6d 6d ions..........Associating.a.comm
18ba0 61 6e 64 20 77 69 74 68 20 61 6e 20 6f 62 6a 65 63 74 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 and.with.an.object.makes.it.poss
18bc0 69 62 6c 65 20 74 6f 20 65 61 73 69 6c 79 0a 20 20 20 20 20 73 74 6f 72 65 20 69 6e 66 6f 72 6d ible.to.easily......store.inform
18be0 61 74 69 6f 6e 20 74 68 61 74 20 69 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 74 68 61 74 20 70 ation.that.is.specific.to.that.p
18c00 61 72 74 69 63 75 6c 61 72 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 20 20 20 54 77 6f 20 63 6f 6d articular.command........Two.com
18c20 6d 61 6e 64 73 20 6d 61 79 20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 74 79 70 65 2c 20 62 75 mands.may.have.the.same.type,.bu
18c40 74 20 6f 62 76 69 6f 75 73 6c 79 20 74 68 65 69 72 20 6b 65 79 0a 20 20 20 20 20 62 69 6e 64 69 t.obviously.their.key......bindi
18c60 6e 67 73 20 61 6e 64 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 73 74 69 6c 6c 20 68 61 76 65 20 ngs.and.descriptions.still.have.
18c80 74 6f 20 62 65 20 64 69 66 66 65 72 65 6e 74 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2e 0a 0a 20 to.be.different,.for.example....
18ca0 20 20 20 20 54 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 6f 6d 65 20 73 6c 6f 74 73 20 61 72 65 ....The.values.of.some.slots.are
18cc0 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20 e2 80 98 72 65 61 64 65 72 e2 80 99 20 73 6c .functions...The....reader....sl
18ce0 6f 74 20 66 6f 72 0a 20 20 20 20 20 65 78 61 6d 70 6c 65 20 68 6f 6c 64 73 20 61 20 66 75 6e 63 ot.for......example.holds.a.func
18d00 74 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 61 20 6e 65 77 20 tion.that.is.used.to.read.a.new.
18d20 76 61 6c 75 65 20 66 6f 72 20 61 6e 0a 20 20 20 20 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e value.for.an......infix.command.
18d40 20 20 54 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 75 63 68 20 73 6c 6f 74 73 20 61 72 65 20 72 ..The.values.of.such.slots.are.r
18d60 65 67 75 6c 61 72 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 47 65 6e 65 72 69 63 20 egular.functions........Generic.
18d80 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 77 68 65 6e 20 61 20 66 75 6e 63 74 69 functions.are.used.when.a.functi
18da0 6f 6e 20 73 68 6f 75 6c 64 20 64 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 20 64 69 66 66 on.should.do.something......diff
18dc0 65 72 65 6e 74 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 63 erent.based.on.the.type.of.the.c
18de0 6f 6d 6d 61 6e 64 2c 20 69 2e 65 2e 2c 20 77 68 65 6e 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73 0a ommand,.i.e.,.when.all.commands.
18e00 20 20 20 20 20 6f 66 20 61 20 63 65 72 74 61 69 6e 20 74 79 70 65 20 73 68 6f 75 6c 64 20 62 65 .....of.a.certain.type.should.be
18e20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 62 75 74 20 64 69 66 66 65 72 65 6e 74 20 have.the.same.way.but.different.
18e40 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 20 62 65 68 61 76 69 6f 72 20 66 6f 72 20 6f 74 68 65 72 from.the......behavior.for.other
18e60 20 74 79 70 65 73 2e 20 20 4f 62 6a 65 63 74 20 73 6c 6f 74 73 20 74 68 61 74 20 68 6f 6c 64 20 .types...Object.slots.that.hold.
18e80 61 20 72 65 67 75 6c 61 72 0a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 76 61 6c 75 65 a.regular......function.as.value
18ea0 20 61 72 65 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 74 61 73 6b 20 74 68 61 74 20 74 68 65 .are.used.when.the.task.that.the
18ec0 79 20 70 65 72 66 6f 72 6d 20 69 73 0a 20 20 20 20 20 6c 69 6b 65 6c 79 20 74 6f 20 64 69 66 66 y.perform.is......likely.to.diff
18ee0 65 72 20 65 76 65 6e 20 62 65 74 77 65 65 6e 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6d 6d 61 6e er.even.between.different.comman
18f00 64 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20 74 79 70 65 2e 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 2a ds.of.the.same.type...*.Menu:..*
18f20 20 47 72 6f 75 70 20 43 6c 61 73 73 65 73 3a 3a 0a 2a 20 47 72 6f 75 70 20 4d 65 74 68 6f 64 73 .Group.Classes::.*.Group.Methods
18f40 3a 3a 0a 2a 20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 43 ::.*.Prefix.Classes::.*.Suffix.C
18f60 6c 61 73 73 65 73 3a 3a 0a 2a 20 50 72 65 66 69 78 20 4d 65 74 68 6f 64 73 3a 3a 0a 2a 20 53 75 lasses::.*.Prefix.Methods::.*.Su
18f80 66 66 69 78 20 4d 65 74 68 6f 64 73 3a 3a 0a 2a 20 50 72 65 66 69 78 20 53 6c 6f 74 73 3a 3a 0a ffix.Methods::.*.Prefix.Slots::.
18fa0 2a 20 53 75 66 66 69 78 20 53 6c 6f 74 73 3a 3a 0a 2a 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f *.Suffix.Slots::.*.Predicate.Slo
18fc0 74 73 3a 3a 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e ts::....File:.doci3EOZM.info,..N
18fe0 6f 64 65 3a 20 47 72 6f 75 70 20 43 6c 61 73 73 65 73 2c 20 20 4e 65 78 74 3a 20 47 72 6f 75 70 ode:.Group.Classes,..Next:.Group
19000 20 4d 65 74 68 6f 64 73 2c 20 20 55 70 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f .Methods,..Up:.Classes.and.Metho
19020 64 73 0a 0a 35 2e 31 20 47 72 6f 75 70 20 43 6c 61 73 73 65 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ds..5.1.Group.Classes.==========
19040 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 74 79 70 65 20 6f 66 20 61 20 67 72 6f 75 70 20 63 61 6e =======..The.type.of.a.group.can
19060 20 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 20 e2 80 98 3a 63 6c 61 73 .be.specified.using.the....:clas
19080 73 e2 80 99 20 70 72 6f 70 65 72 74 79 20 61 74 20 74 68 65 0a 62 65 67 69 6e 6e 69 6e 67 20 6f s....property.at.the.beginning.o
190a0 66 20 74 68 65 20 63 6c 61 73 73 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 2c 20 65 2e 67 2e 2c f.the.class.specification,.e.g.,
190c0 20 e2 80 98 5b 3a 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 0a 2e 2e ....[:class.transient-columns...
190e0 2e 5d e2 80 99 20 69 6e 20 61 20 63 61 6c 6c 20 74 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d .]....in.a.call.to....transient-
19100 64 65 66 69 6e 65 2d 70 72 65 66 69 78 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 61 62 define-prefix.............The.ab
19120 73 74 72 61 63 74 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 e2 80 99 20 63 6c 61 stract....transient-child....cla
19140 73 73 20 69 73 20 74 68 65 20 62 61 73 65 20 63 6c 61 73 73 20 6f 66 20 62 6f 74 68 0a 20 20 20 ss.is.the.base.class.of.both....
19160 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 e2 80 99 20 28 61 6e 64 20 74 68 65 .....transient-group....(and.the
19180 72 65 66 6f 72 65 20 61 6c 6c 20 67 72 6f 75 70 73 29 20 61 73 20 77 65 6c 6c 20 61 73 20 6f 66 refore.all.groups).as.well.as.of
191a0 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 20 28 61 6e .........transient-suffix....(an
191c0 64 20 74 68 65 72 65 66 6f 72 65 20 61 6c 6c 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 d.therefore.all.suffix.and.infix
191e0 20 63 6f 6d 6d 61 6e 64 73 29 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 63 6c 61 73 73 20 65 78 69 .commands)........This.class.exi
19200 73 74 73 20 62 65 63 61 75 73 65 20 74 68 65 20 65 6c 65 6d 65 6e 74 73 20 28 6f 72 20 e2 80 9c sts.because.the.elements.(or....
19220 63 68 69 6c 64 72 65 6e e2 80 9d 29 20 6f 66 20 63 65 72 74 61 69 6e 0a 20 20 20 20 20 67 72 6f children...).of.certain......gro
19240 75 70 73 20 63 61 6e 20 62 65 20 6f 74 68 65 72 20 67 72 6f 75 70 73 20 69 6e 73 74 65 61 64 20 ups.can.be.other.groups.instead.
19260 6f 66 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 of.suffix.and.infix.commands....
19280 20 20 e2 80 a2 20 54 68 65 20 61 62 73 74 72 61 63 74 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d ......The.abstract....transient-
192a0 67 72 6f 75 70 e2 80 99 20 63 6c 61 73 73 20 69 73 20 74 68 65 20 73 75 70 65 72 63 6c 61 73 73 group....class.is.the.superclass
192c0 20 6f 66 20 61 6c 6c 20 6f 74 68 65 72 0a 20 20 20 20 20 67 72 6f 75 70 20 63 6c 61 73 73 65 73 .of.all.other......group.classes
192e0 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d ..........The....transient-colum
19300 6e e2 80 99 20 63 6c 61 73 73 20 69 73 20 74 68 65 20 73 69 6d 70 6c 65 73 74 20 67 72 6f 75 70 n....class.is.the.simplest.group
19320 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 e2 80 9c 66 ........This.is.the.default....f
19340 6c 61 74 e2 80 9d 20 67 72 6f 75 70 2e 20 20 49 66 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e lat....group...If.the.class.is.n
19360 6f 74 20 73 70 65 63 69 66 69 65 64 0a 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20 61 6e 64 ot.specified......explicitly.and
19380 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 69 73 20 6e 6f 74 20 61 20 76 65 63 74 .the.first.element.is.not.a.vect
193a0 6f 72 20 28 69 2e 65 2e 2c 20 6e 6f 74 20 61 0a 20 20 20 20 20 67 72 6f 75 70 29 2c 20 74 68 65 or.(i.e.,.not.a......group),.the
193c0 6e 20 74 68 69 73 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 2e 0a 0a 20 20 20 20 20 54 68 69 73 n.this.class.is.used........This
193e0 20 63 6c 61 73 73 20 64 69 73 70 6c 61 79 73 20 65 61 63 68 20 65 6c 65 6d 65 6e 74 20 6f 6e 20 .class.displays.each.element.on.
19400 61 20 73 65 70 61 72 61 74 65 20 6c 69 6e 65 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 a.separate.line..........The....
19420 74 72 61 6e 73 69 65 6e 74 2d 72 6f 77 e2 80 99 20 63 6c 61 73 73 20 64 69 73 70 6c 61 79 73 20 transient-row....class.displays.
19440 61 6c 6c 20 65 6c 65 6d 65 6e 74 73 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 6c 69 6e 65 2e 0a 0a all.elements.on.a.single.line...
19460 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 e2 .......The....transient-columns.
19480 80 99 20 63 6c 61 73 73 20 64 69 73 70 6c 61 79 73 20 63 6f 6d 6d 61 6e 64 73 20 6f 72 67 61 6e ...class.displays.commands.organ
194a0 69 7a 65 64 20 69 6e 0a 20 20 20 20 20 63 6f 6c 75 6d 6e 73 2e 0a 0a 20 20 20 20 20 44 69 72 65 ized.in......columns........Dire
194c0 63 74 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 20 67 72 6f 75 70 73 20 77 68 ct.elements.have.to.be.groups.wh
194e0 6f 73 65 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 0a 20 20 20 20 20 63 6f 6d ose.elements.have.to.be......com
19500 6d 61 6e 64 73 20 6f 72 20 73 74 72 69 6e 67 73 2e 20 20 45 61 63 68 20 73 75 62 67 72 6f 75 70 mands.or.strings...Each.subgroup
19520 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 63 6f 6c 75 6d 6e 2e 20 20 54 68 69 73 0a 20 20 20 20 .represents.a.column...This.....
19540 20 63 6c 61 73 73 20 74 61 6b 65 73 20 63 61 72 65 20 6f 66 20 69 6e 73 65 72 74 69 6e 67 20 74 .class.takes.care.of.inserting.t
19560 68 65 20 73 75 62 67 72 6f 75 70 73 e2 80 99 20 65 6c 65 6d 65 6e 74 73 2e 0a 0a 20 20 20 20 20 he.subgroups....elements........
19580 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 e2 80 9c 6e 65 73 74 65 64 e2 80 9d This.is.the.default....nested...
195a0 20 67 72 6f 75 70 2e 20 20 49 66 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 .group...If.the.class.is.not.spe
195c0 63 69 66 69 65 64 0a 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20 61 6e 64 20 74 68 65 20 66 cified......explicitly.and.the.f
195e0 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 69 73 20 61 20 76 65 63 74 6f 72 20 28 69 2e 65 2e 2c 20 irst.element.is.a.vector.(i.e.,.
19600 61 20 67 72 6f 75 70 29 2c 20 74 68 65 6e 0a 20 20 20 20 20 74 68 69 73 20 63 6c 61 73 73 20 69 a.group),.then......this.class.i
19620 73 20 75 73 65 64 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 s.used..........The....transient
19640 2d 73 75 62 67 72 6f 75 70 73 e2 80 99 20 63 6c 61 73 73 20 77 72 61 70 73 20 6f 74 68 65 72 20 -subgroups....class.wraps.other.
19660 67 72 6f 75 70 73 2e 0a 0a 20 20 20 20 20 44 69 72 65 63 74 20 65 6c 65 6d 65 6e 74 73 20 68 61 groups........Direct.elements.ha
19680 76 65 20 74 6f 20 62 65 20 67 72 6f 75 70 73 20 77 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 20 68 ve.to.be.groups.whose.elements.h
196a0 61 76 65 20 74 6f 20 62 65 0a 20 20 20 20 20 63 6f 6d 6d 61 6e 64 73 20 6f 72 20 73 74 72 69 6e ave.to.be......commands.or.strin
196c0 67 73 2e 20 20 54 68 69 73 20 67 72 6f 75 70 20 69 6e 73 65 72 74 73 20 61 6e 20 65 6d 70 74 79 gs...This.group.inserts.an.empty
196e0 20 6c 69 6e 65 20 62 65 74 77 65 65 6e 0a 20 20 20 20 20 73 75 62 67 72 6f 75 70 73 2e 20 20 54 .line.between......subgroups...T
19700 68 65 20 73 75 62 67 72 6f 75 70 73 20 74 68 65 6d 73 65 6c 76 65 73 20 61 72 65 20 72 65 73 70 he.subgroups.themselves.are.resp
19720 6f 6e 73 69 62 6c 65 20 66 6f 72 20 64 69 73 70 6c 61 79 69 6e 67 0a 20 20 20 20 20 74 68 65 69 onsible.for.displaying......thei
19740 72 20 65 6c 65 6d 65 6e 74 73 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 r.elements.....File:.doci3EOZM.i
19760 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 47 72 6f 75 70 20 4d 65 74 68 6f 64 73 2c 20 20 4e 65 78 74 nfo,..Node:.Group.Methods,..Next
19780 3a 20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 2c 20 20 50 72 65 76 3a 20 47 72 6f 75 70 20 43 :.Prefix.Classes,..Prev:.Group.C
197a0 6c 61 73 73 65 73 2c 20 20 55 70 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 lasses,..Up:.Classes.and.Methods
197c0 0a 0a 35 2e 32 20 47 72 6f 75 70 20 4d 65 74 68 6f 64 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ..5.2.Group.Methods.============
197e0 3d 3d 3d 3d 3d 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 =====..Function:.transient-setup
19800 2d 63 68 69 6c 64 72 65 6e 20 67 72 6f 75 70 20 63 68 69 6c 64 72 65 6e 0a 20 20 20 20 20 54 68 -children.group.children......Th
19820 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 is.generic.function.can.be.used.
19840 74 6f 20 73 65 74 75 70 20 74 68 65 20 63 68 69 6c 64 72 65 6e 20 6f 72 20 61 20 67 72 6f 75 70 to.setup.the.children.or.a.group
19860 2e 0a 0a 20 20 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ........The.default.implementati
19880 6f 6e 20 75 73 75 61 6c 6c 79 20 6a 75 73 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 63 68 69 6c on.usually.just.returns.the.chil
198a0 64 72 65 6e 0a 20 20 20 20 20 75 6e 63 68 61 6e 67 65 64 2c 20 62 75 74 20 69 66 20 74 68 65 20 dren......unchanged,.but.if.the.
198c0 e2 80 98 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e e2 80 99 20 73 6c 6f 74 20 6f 66 20 47 52 4f ...setup-children....slot.of.GRO
198e0 55 50 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 0a 20 20 20 20 20 74 68 65 6e 20 69 UP.is.non-...nil...,......then.i
19900 74 20 63 61 6c 6c 73 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 43 48 49 4c 44 t.calls.that.function.with.CHILD
19920 52 45 4e 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 0a 20 20 20 REN.as.the.only.argument.and....
19940 20 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 63 ..returns.the.value........The.c
19960 68 69 6c 64 72 65 6e 20 61 72 65 20 67 69 76 65 6e 20 61 73 20 61 20 28 70 6f 74 65 6e 74 69 61 hildren.are.given.as.a.(potentia
19980 6c 6c 79 20 65 6d 70 74 79 29 20 6c 69 73 74 20 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66 0a 20 20 lly.empty).list.consisting.of...
199a0 20 20 20 65 69 74 68 65 72 20 67 72 6f 75 70 20 6f 72 20 73 75 66 66 69 78 20 73 70 65 63 69 66 ...either.group.or.suffix.specif
199c0 69 63 61 74 69 6f 6e 73 2e 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 6d ications...These.functions.can.m
199e0 61 6b 65 0a 20 20 20 20 20 61 72 62 69 74 72 61 72 79 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 ake......arbitrary.changes.to.th
19a00 65 20 63 68 69 6c 64 72 65 6e 20 69 6e 63 6c 75 64 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 69 6e e.children.including.constructin
19a20 67 20 6e 65 77 0a 20 20 20 20 20 63 68 69 6c 64 72 65 6e 20 66 72 6f 6d 20 73 63 72 61 74 63 68 g.new......children.from.scratch
19a40 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 e2 80 93 69 6e 73 65 72 74 2d ...Function:.transient...insert-
19a60 67 72 6f 75 70 20 67 72 6f 75 70 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 group.group......This.generic.fu
19a80 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 74 68 65 20 67 72 6f 75 70 20 61 6e 64 20 69 74 73 nction.formats.the.group.and.its
19aa0 20 65 6c 65 6d 65 6e 74 73 20 61 6e 64 0a 20 20 20 20 20 69 6e 73 65 72 74 73 20 74 68 65 20 72 .elements.and......inserts.the.r
19ac0 65 73 75 6c 74 20 69 6e 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2c 20 77 esult.into.the.current.buffer,.w
19ae0 68 69 63 68 20 69 73 20 61 20 74 65 6d 70 6f 72 61 72 79 0a 20 20 20 20 20 62 75 66 66 65 72 2e hich.is.a.temporary......buffer.
19b00 20 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 61 74 20 62 75 66 66 65 72 20 61 72 ..The.contents.of.that.buffer.ar
19b20 65 20 6c 61 74 65 72 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 6d e.later.inserted.into.the......m
19b40 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 20 20 20 20 20 46 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 enu.buffer........Functions.that
19b60 20 61 72 65 20 63 61 6c 6c 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 .are.called.by.this.function.may
19b80 20 6e 65 65 64 20 74 6f 20 6f 70 65 72 61 74 65 20 69 6e 0a 20 20 20 20 20 74 68 65 20 62 75 66 .need.to.operate.in......the.buf
19ba0 66 65 72 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 61 73 fer.from.which.the.transient.was
19bc0 20 63 61 6c 6c 65 64 2e 20 20 54 6f 20 64 6f 20 73 6f 20 74 68 65 79 20 63 61 6e 0a 20 20 20 20 .called...To.do.so.they.can.....
19be0 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 6d 61 6b 65 20 74 68 65 20 e2 80 98 74 72 61 6e 73 69 65 .temporarily.make.the....transie
19c00 6e 74 2d 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 e2 80 99 20 74 68 65 20 63 75 72 72 65 nt--shadowed-buffer....the.curre
19c20 6e 74 0a 20 20 20 20 20 62 75 66 66 65 72 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f nt......buffer.....File:.doci3EO
19c40 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 2c 20 ZM.info,..Node:.Prefix.Classes,.
19c60 20 4e 65 78 74 3a 20 53 75 66 66 69 78 20 43 6c 61 73 73 65 73 2c 20 20 50 72 65 76 3a 20 47 72 .Next:.Suffix.Classes,..Prev:.Gr
19c80 6f 75 70 20 4d 65 74 68 6f 64 73 2c 20 20 55 70 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 oup.Methods,..Up:.Classes.and.Me
19ca0 74 68 6f 64 73 0a 0a 35 2e 33 20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 0a 3d 3d 3d 3d 3d 3d thods..5.3.Prefix.Classes.======
19cc0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 72 61 6e 73 69 65 6e 74 20 69 74 73 65 6c 66 20 70 ============..Transient.itself.p
19ce0 72 6f 76 69 64 65 73 20 61 20 73 69 6e 67 6c 65 20 63 6c 61 73 73 20 66 6f 72 20 70 72 65 66 69 rovides.a.single.class.for.prefi
19d00 78 20 63 6f 6d 6d 61 6e 64 73 2c 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 e2 x.commands,....transient-prefix.
19d20 80 99 2c 20 62 75 74 20 70 61 63 6b 61 67 65 20 61 75 74 68 6f 72 73 20 6d 61 79 20 77 69 73 68 ..,.but.package.authors.may.wish
19d40 20 74 6f 20 64 65 66 69 6e 65 20 73 70 65 63 69 61 6c 69 7a 65 64 0a 63 6c 61 73 73 65 73 2e 20 .to.define.specialized.classes..
19d60 20 44 6f 69 6e 67 20 73 6f 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 .Doing.so.makes.it.possible.to.c
19d80 68 61 6e 67 65 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 74 68 65 20 73 65 74 0a 6f 66 hange.the.behavior.of.the.set.of
19da0 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 75 73 65 20 74 68 61 74 20 63 .prefix.commands.that.use.that.c
19dc0 6c 61 73 73 2c 20 62 79 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 73 70 65 63 69 61 6c 69 7a 65 lass,.by.implementing.specialize
19de0 64 0a 6d 65 74 68 6f 64 73 20 66 6f 72 20 63 65 72 74 61 69 6e 20 67 65 6e 65 72 69 63 20 66 75 d.methods.for.certain.generic.fu
19e00 6e 63 74 69 6f 6e 73 20 28 73 65 65 20 2a 6e 6f 74 65 20 50 72 65 66 69 78 20 4d 65 74 68 6f 64 nctions.(see.*note.Prefix.Method
19e20 73 3a 3a 29 2e 0a 0a 20 20 20 41 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d s::)......A.transient.prefix.com
19e40 6d 61 6e 64 e2 80 99 73 20 6f 62 6a 65 63 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 mand...s.object.is.stored.in.the
19e60 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 e2 80 99 20 70 72 6f 70 65 72 74 ....transient--prefix....propert
19e80 79 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 73 79 6d 62 6f 6c 2e 20 20 57 68 69 6c 65 20 y.of.the.command.symbol...While.
19ea0 61 20 74 72 61 6e 73 69 65 6e 74 0a 69 73 20 61 63 74 69 76 65 2c 20 61 20 63 6c 6f 6e 65 20 6f a.transient.is.active,.a.clone.o
19ec0 66 20 74 68 61 74 20 6f 62 6a 65 63 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 76 f.that.object.is.stored.in.the.v
19ee0 61 72 69 61 62 6c 65 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 e2 80 99 2e ariable....transient--prefix....
19f00 20 20 41 20 63 6c 6f 6e 65 20 69 73 20 75 73 65 64 20 62 65 63 61 75 73 65 20 73 6f 6d 65 20 63 ..A.clone.is.used.because.some.c
19f20 68 61 6e 67 65 73 20 74 68 61 74 20 61 72 65 20 6d 61 64 65 0a 74 6f 20 74 68 65 20 61 63 74 69 hanges.that.are.made.to.the.acti
19f40 76 65 20 74 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 6f 62 6a 65 63 74 20 73 68 6f 75 6c 64 20 6e ve.transient...s.object.should.n
19f60 6f 74 20 61 66 66 65 63 74 20 6c 61 74 65 72 20 69 6e 76 6f 63 61 74 69 6f 6e 73 2e 0a 0a 1f 0a ot.affect.later.invocations.....
19f80 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 53 75 66 File:.doci3EOZM.info,..Node:.Suf
19fa0 66 69 78 20 43 6c 61 73 73 65 73 2c 20 20 4e 65 78 74 3a 20 50 72 65 66 69 78 20 4d 65 74 68 6f fix.Classes,..Next:.Prefix.Metho
19fc0 64 73 2c 20 20 50 72 65 76 3a 20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 2c 20 20 55 70 3a 20 ds,..Prev:.Prefix.Classes,..Up:.
19fe0 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 0a 35 2e 34 20 53 75 66 66 69 78 20 Classes.and.Methods..5.4.Suffix.
1a000 43 6c 61 73 73 65 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20 e2 Classes.==================......
1a020 80 a2 20 41 6c 6c 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6c 61 73 73 65 73 20 ...All.suffix.and.infix.classes.
1a040 64 65 72 69 76 65 20 66 72 6f 6d 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 derive.from....transient-suffix.
1a060 80 99 2c 20 77 68 69 63 68 0a 20 20 20 20 20 69 6e 20 74 75 72 6e 20 64 65 72 69 76 65 73 20 66 ..,.which......in.turn.derives.f
1a080 72 6f 6d 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 e2 80 99 2c 20 66 72 6f 6d 20 rom....transient-child...,.from.
1a0a0 77 68 69 63 68 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 e2 80 99 which.........transient-group...
1a0c0 20 61 6c 73 6f 20 64 65 72 69 76 65 73 20 28 73 65 65 20 2a 6e 6f 74 65 20 47 72 6f 75 70 20 43 .also.derives.(see.*note.Group.C
1a0e0 6c 61 73 73 65 73 3a 3a 29 2e 0a 0a 20 20 20 e2 80 a2 20 41 6c 6c 20 69 6e 66 69 78 20 63 6c 61 lasses::)..........All.infix.cla
1a100 73 73 65 73 20 64 65 72 69 76 65 20 66 72 6f 6d 20 74 68 65 20 61 62 73 74 72 61 63 74 20 e2 80 sses.derive.from.the.abstract...
1a120 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 e2 80 99 20 63 6c 61 73 73 2c 0a 20 20 20 20 20 .transient-infix....class,......
1a140 77 68 69 63 68 20 69 6e 20 74 75 72 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 74 68 65 20 e2 which.in.turn.derives.from.the..
1a160 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 20 63 6c 61 73 73 2e 0a 0a 20 20 ..transient-suffix....class.....
1a180 20 20 20 49 6e 66 69 78 65 73 20 61 72 65 20 61 20 73 70 65 63 69 61 6c 20 74 79 70 65 20 6f 66 ...Infixes.are.a.special.type.of
1a1a0 20 73 75 66 66 69 78 65 73 2e 20 20 54 68 65 20 70 72 69 6d 61 72 79 20 64 69 66 66 65 72 65 6e .suffixes...The.primary.differen
1a1c0 63 65 20 69 73 0a 20 20 20 20 20 74 68 61 74 20 69 6e 66 69 78 65 73 20 61 6c 77 61 79 73 20 75 ce.is......that.infixes.always.u
1a1e0 73 65 20 74 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 e2 80 99 20 se.the....transient--do-stay....
1a200 70 72 65 2d 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 6c 65 0a 20 20 20 20 20 6e 6f 6e 2d 69 6e 66 69 pre-command,.while......non-infi
1a220 78 20 73 75 66 66 69 78 65 73 20 75 73 65 20 61 20 76 61 72 69 65 74 79 20 6f 66 20 70 72 65 2d x.suffixes.use.a.variety.of.pre-
1a240 63 6f 6d 6d 61 6e 64 73 20 28 73 65 65 20 2a 6e 6f 74 65 0a 20 20 20 20 20 54 72 61 6e 73 69 65 commands.(see.*note......Transie
1a260 6e 74 20 53 74 61 74 65 3a 3a 29 2e 20 20 44 6f 69 6e 67 20 74 68 61 74 20 69 73 20 6d 6f 73 74 nt.State::)...Doing.that.is.most
1a280 20 65 61 73 69 6c 79 20 61 63 68 69 65 76 65 64 20 62 79 20 75 73 69 6e 67 0a 20 20 20 20 20 74 .easily.achieved.by.using......t
1a2a0 68 69 73 20 63 6c 61 73 73 2c 20 74 68 6f 75 67 68 20 74 68 65 6f 72 65 74 69 63 61 6c 6c 79 20 his.class,.though.theoretically.
1a2c0 69 74 20 77 6f 75 6c 64 20 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 65 66 69 6e 65 20 61 it.would.be.possible.to.define.a
1a2e0 6e 0a 20 20 20 20 20 69 6e 66 69 78 20 63 6c 61 73 73 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 n......infix.class.that.does.not
1a300 20 64 6f 20 73 6f 2e 20 20 49 66 20 79 6f 75 20 64 6f 20 74 68 61 74 20 74 68 65 6e 20 79 6f 75 .do.so...If.you.do.that.then.you
1a320 20 67 65 74 20 74 6f 0a 20 20 20 20 20 69 6d 70 6c 65 6d 65 6e 74 20 6d 61 6e 79 20 6d 65 74 68 .get.to......implement.many.meth
1a340 6f 64 73 2e 0a 0a 20 20 20 20 20 41 6c 73 6f 2c 20 69 6e 66 69 78 65 73 20 61 6e 64 20 6e 6f 6e ods........Also,.infixes.and.non
1a360 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 20 61 72 65 20 75 73 75 61 6c 6c 79 20 64 65 66 69 -infix.suffixes.are.usually.defi
1a380 6e 65 64 20 75 73 69 6e 67 0a 20 20 20 20 20 64 69 66 66 65 72 65 6e 74 20 6d 61 63 72 6f 73 20 ned.using......different.macros.
1a3a0 28 73 65 65 20 2a 6e 6f 74 65 20 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 (see.*note.Defining.Suffix.and.I
1a3c0 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 3a 3a 29 2e 0a 0a 20 20 20 e2 80 a2 20 43 6c 61 73 73 65 nfix.Commands::)..........Classe
1a3e0 73 20 75 73 65 64 20 66 6f 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 s.used.for.infix.commands.that.r
1a400 65 70 72 65 73 65 6e 74 20 61 72 67 75 6d 65 6e 74 73 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 epresent.arguments.should.be....
1a420 20 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 74 68 65 20 61 62 73 74 72 61 63 74 20 e2 80 98 74 ..derived.from.the.abstract....t
1a440 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 e2 80 99 20 63 6c 61 73 73 2e 0a 0a 20 20 20 ransient-argument....class......
1a460 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 e2 80 99 20 63 ....The....transient-switch....c
1a480 6c 61 73 73 20 28 6f 72 20 61 20 64 65 72 69 76 65 64 20 63 6c 61 73 73 29 20 69 73 20 75 73 65 lass.(or.a.derived.class).is.use
1a4a0 64 20 66 6f 72 20 69 6e 66 69 78 0a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 d.for.infix......arguments.that.
1a4c0 72 65 70 72 65 73 65 6e 74 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 77 69 74 63 68 65 73 20 represent.command-line.switches.
1a4e0 28 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 64 6f 0a 20 20 20 20 20 6e 6f 74 20 74 61 6b 65 (arguments.that.do......not.take
1a500 20 61 20 76 61 6c 75 65 29 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 .a.value)..........The....transi
1a520 65 6e 74 2d 6f 70 74 69 6f 6e e2 80 99 20 63 6c 61 73 73 20 28 6f 72 20 61 20 64 65 72 69 76 65 ent-option....class.(or.a.derive
1a540 64 20 63 6c 61 73 73 29 20 69 73 20 75 73 65 64 20 66 6f 72 20 69 6e 66 69 78 0a 20 20 20 20 20 d.class).is.used.for.infix......
1a560 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 20 63 6f 6d 6d 61 6e 64 arguments.that.represent.command
1a580 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 20 28 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 64 6f -line.options.(arguments.that.do
1a5a0 0a 20 20 20 20 20 74 61 6b 65 20 61 20 76 61 6c 75 65 29 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 ......take.a.value)..........The
1a5c0 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 e2 80 99 20 63 6c 61 73 73 20 ....transient-switches....class.
1a5e0 63 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 61 20 73 65 74 20 6f 66 20 6d 75 74 75 61 6c 6c can.be.used.for.a.set.of.mutuall
1a600 79 0a 20 20 20 20 20 65 78 63 6c 75 73 69 76 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 77 y......exclusive.command-line.sw
1a620 69 74 63 68 65 73 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 itches..........The....transient
1a640 2d 66 69 6c 65 73 e2 80 99 20 63 6c 61 73 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 -files....class.can.be.used.for.
1a660 61 20 e2 80 98 2d 2d e2 80 99 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 0a 20 20 20 20 20 69 6e a....--....argument.that......in
1a680 64 69 63 61 74 65 73 20 74 68 61 74 20 61 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 20 61 72 67 75 6d dicates.that.all.remaining.argum
1a6a0 65 6e 74 73 20 61 72 65 20 66 69 6c 65 73 2e 0a 0a 20 20 20 e2 80 a2 20 43 6c 61 73 73 65 73 20 ents.are.files..........Classes.
1a6c0 75 73 65 64 20 66 6f 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 65 70 used.for.infix.commands.that.rep
1a6e0 72 65 73 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 73 68 6f 75 6c 64 0a 20 20 20 20 20 64 65 72 resent.variables.should......der
1a700 69 76 65 64 20 66 72 6f 6d 20 74 68 65 20 61 62 73 74 72 61 63 74 20 e2 80 98 74 72 61 6e 73 69 ived.from.the.abstract....transi
1a720 65 6e 74 2d 76 61 72 69 61 62 6c 65 e2 80 99 20 63 6c 61 73 73 2e 0a 0a 20 20 20 e2 80 a2 20 54 ent-variable....class..........T
1a740 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e e2 80 99 20 61 he....transient-information....a
1a760 6e 64 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 2a e2 80 99 20 nd....transient-information*....
1a780 63 6c 61 73 73 65 73 0a 20 20 20 20 20 61 72 65 20 73 70 65 63 69 61 6c 20 69 6e 20 74 68 61 74 classes......are.special.in.that
1a7a0 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 75 73 65 20 74 68 65 73 65 20 63 6c 61 73 73 20 61 .suffixes.that.use.these.class.a
1a7c0 72 65 20 6e 6f 74 0a 20 20 20 20 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 63 6f re.not......associated.with.a.co
1a7e0 6d 6d 61 6e 64 20 61 6e 64 20 74 68 75 73 20 61 6c 73 6f 20 6e 6f 74 20 77 69 74 68 20 61 6e 79 mmand.and.thus.also.not.with.any
1a800 20 6b 65 79 20 62 69 6e 64 69 6e 67 2e 0a 20 20 20 20 20 53 75 63 68 20 73 75 66 66 69 78 65 73 .key.binding.......Such.suffixes
1a820 20 61 72 65 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 61 72 62 69 74 72 .are.only.used.to.display.arbitr
1a840 61 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 20 74 68 61 74 20 61 ary.information,.and......that.a
1a860 6e 79 77 68 65 72 65 20 61 20 73 75 66 66 69 78 20 63 61 6e 20 61 70 70 65 61 72 2e 20 20 44 69 nywhere.a.suffix.can.appear...Di
1a880 73 70 6c 61 79 2d 6f 6e 6c 79 20 73 75 66 66 69 78 0a 20 20 20 20 20 73 70 65 63 69 66 69 63 61 splay-only.suffix......specifica
1a8a0 74 69 6f 6e 73 20 74 61 6b 65 20 74 68 65 73 65 20 66 6f 72 6d 3a 0a 0a 20 20 20 20 20 20 20 20 tions.take.these.form:..........
1a8c0 20 20 28 3a 69 6e 66 6f 20 44 45 53 43 52 49 50 54 49 4f 4e 20 5b 4b 45 59 57 4f 52 44 20 56 41 ..(:info.DESCRIPTION.[KEYWORD.VA
1a8e0 4c 55 45 5d 2e 2e 2e 29 0a 20 20 20 20 20 20 20 20 20 20 28 3a 69 6e 66 6f 2a 20 44 45 53 43 52 LUE]...)...........(:info*.DESCR
1a900 49 50 54 49 4f 4e 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 29 0a 0a 20 20 20 20 IPTION.[KEYWORD.VALUE]...)......
1a920 20 54 68 65 20 e2 80 98 3a 69 6e 66 6f e2 80 99 20 61 6e 64 20 e2 80 98 3a 69 6e 66 6f 2a e2 80 .The....:info....and....:info*..
1a940 99 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 73 20 72 65 70 6c 61 63 65 73 20 74 68 65 ..keyword.arguments.replaces.the
1a960 0a 20 20 20 20 20 e2 80 98 3a 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 20 6b 65 79 77 6f 72 64 .........:description....keyword
1a980 20 75 73 65 64 20 66 6f 72 20 6f 74 68 65 72 20 73 75 66 66 69 78 20 63 6c 61 73 73 65 73 2e 20 .used.for.other.suffix.classes..
1a9a0 20 4f 74 68 65 72 0a 20 20 20 20 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 73 20 74 68 .Other......keyword.arguments.th
1a9c0 61 74 20 79 6f 75 20 6d 69 67 68 74 20 77 61 6e 74 20 74 6f 20 73 65 74 2c 20 69 6e 63 6c 75 64 at.you.might.want.to.set,.includ
1a9e0 65 20 e2 80 98 3a 66 61 63 65 e2 80 99 2c 0a 20 20 20 20 20 70 72 65 64 69 63 61 74 65 20 6b 65 e....:face...,......predicate.ke
1aa00 79 77 6f 72 64 73 20 28 73 75 63 68 20 61 73 20 e2 80 98 3a 69 66 e2 80 99 20 61 6e 64 20 e2 80 ywords.(such.as....:if....and...
1aa20 98 3a 69 6e 61 70 74 2d 69 66 e2 80 99 29 2c 20 61 6e 64 20 e2 80 98 3a 66 6f 72 6d 61 74 e2 80 .:inapt-if...),.and....:format..
1aa40 99 2e 0a 20 20 20 20 20 42 79 20 64 65 66 61 75 6c 74 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 ........By.default.the.value.of.
1aa60 e2 80 98 3a 66 6f 72 6d 61 74 e2 80 99 20 69 6e 63 6c 75 64 65 73 20 e2 80 98 25 6b e2 80 99 2c ...:format....includes....%k...,
1aa80 20 77 68 69 63 68 20 66 6f 72 20 74 68 69 73 0a 20 20 20 20 20 63 6c 61 73 73 20 69 73 20 72 65 .which.for.this......class.is.re
1aaa0 70 6c 61 63 65 64 20 77 69 74 68 20 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 6f 72 20 placed.with.the.empty.string.or.
1aac0 73 70 61 63 65 73 2c 20 69 66 20 6b 65 79 73 20 61 72 65 0a 20 20 20 20 20 62 65 69 6e 67 20 70 spaces,.if.keys.are......being.p
1aae0 61 64 64 65 64 20 69 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 67 72 6f 75 70 2e 0a 0a added.in.the.containing.group...
1ab00 20 20 20 20 20 54 68 65 20 6f 6e 6c 79 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e .....The.only.difference.between
1ab20 20 74 68 65 73 65 20 74 77 6f 20 63 6c 61 73 73 65 73 20 69 73 20 74 68 61 74 20 e2 80 98 3a 69 .these.two.classes.is.that....:i
1ab40 6e 66 6f 2a e2 80 99 0a 20 20 20 20 20 61 6c 69 67 6e 73 20 69 74 73 20 64 65 73 63 72 69 70 74 nfo*.........aligns.its.descript
1ab60 69 6f 6e 20 77 69 74 68 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 6f 66 20 73 75 66 ion.with.the.descriptions.of.suf
1ab80 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 0a 20 20 20 20 20 77 68 69 6c 65 20 66 6f 72 20 e2 80 98 fix.commands,......while.for....
1aba0 3a 69 6e 66 6f e2 80 99 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 62 6c 65 65 64 73 20 :info....the.description.bleeds.
1abc0 69 6e 74 6f 20 74 68 65 20 61 72 65 61 20 77 68 65 72 65 0a 20 20 20 20 20 73 75 66 66 69 78 65 into.the.area.where......suffixe
1abe0 73 20 64 69 73 70 6c 61 79 20 74 68 65 69 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 0a 0a 20 s.display.their.key.bindings....
1ac00 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 ......The....transient-lisp-vari
1ac20 61 62 6c 65 e2 80 99 20 63 6c 61 73 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 68 6f able....class.can.be.used.to.sho
1ac40 77 20 61 6e 64 20 63 68 61 6e 67 65 0a 20 20 20 20 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 6c w.and.change......the.value.of.l
1ac60 69 73 70 20 76 61 72 69 61 62 6c 65 73 2e 20 20 54 68 69 73 20 63 6c 61 73 73 20 69 73 20 6e 6f isp.variables...This.class.is.no
1ac80 74 20 66 75 6c 6c 79 20 66 65 61 74 75 72 65 64 20 79 65 74 0a 20 20 20 20 20 61 6e 64 20 69 74 t.fully.featured.yet......and.it
1aca0 20 69 73 20 73 6f 6d 65 77 68 61 74 20 6c 69 6b 65 6c 79 20 74 68 61 74 20 66 75 74 75 72 65 20 .is.somewhat.likely.that.future.
1acc0 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 6f 6e e2 80 99 74 20 62 65 20 66 75 6c 6c 79 0a 20 20 improvements.won...t.be.fully...
1ace0 20 20 20 62 61 63 6b 77 61 72 64 20 63 6f 6d 70 61 74 69 62 6c 65 2e 0a 0a 20 20 20 e2 80 a2 20 ...backward.compatible..........
1ad00 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e e2 80 99 20 The....transient-cons-option....
1ad20 63 6c 61 73 73 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 73 69 74 75 61 74 69 6f 6e 73 class.is.intended.for.situations
1ad40 20 77 68 65 72 65 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 .where.........transient-args...
1ad60 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 61 6e 20 61 6c 69 73 74 2c 20 69 6e 73 74 65 61 64 .should.return.an.alist,.instead
1ad80 20 6f 66 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 73 74 72 69 6e 67 73 20 28 61 72 67 75 .of.a.list.of......strings.(argu
1ada0 6d 65 6e 74 73 29 2e 20 20 53 75 63 68 20 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 73 70 ments)...Such.suffixes.can.be.sp
1adc0 65 63 69 66 69 65 64 20 69 6e 20 70 72 65 66 69 78 0a 20 20 20 20 20 64 65 66 69 6e 69 74 69 6f ecified.in.prefix......definitio
1ade0 6e 73 20 6c 69 6b 65 20 73 6f 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 28 3a 63 6f 6e 73 20 4f 50 ns.like.so:............(:cons.OP
1ae00 54 49 4f 4e 20 3a 6b 65 79 20 4b 45 59 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e TION.:key.KEY.[KEYWORD.VALUE]...
1ae20 29 0a 0a 20 20 20 20 20 4f 50 54 49 4f 4e 20 6d 61 79 20 62 65 20 73 6f 6d 65 74 68 69 6e 67 20 ).......OPTION.may.be.something.
1ae40 6f 74 68 65 72 20 74 68 61 6e 20 61 20 73 74 72 69 6e 67 2c 20 6c 69 6b 65 6c 79 20 61 20 6b 65 other.than.a.string,.likely.a.ke
1ae60 79 77 6f 72 64 20 6f 72 0a 20 20 20 20 20 73 6f 6d 65 20 6f 74 68 65 72 20 73 79 6d 62 6f 6c 2c yword.or......some.other.symbol,
1ae80 20 69 74 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 e2 80 98 63 61 72 e2 80 99 20 6f 66 20 .it.is.used.as.the....car....of.
1aea0 74 68 65 20 63 6f 6e 73 2d 63 65 6c 6c 2e 20 20 57 68 65 6e 0a 20 20 20 20 20 75 73 69 6e 67 20 the.cons-cell...When......using.
1aec0 73 75 63 68 20 61 6e 20 69 6e 6c 69 6e 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 e2 80 98 3a 6b 65 such.an.inline.definition....:ke
1aee0 79 e2 80 99 20 68 61 73 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 2e 20 20 49 6e 0a 20 20 y....has.to.be.specified...In...
1af00 20 20 20 6d 6f 73 74 20 63 61 73 65 73 20 e2 80 98 3a 72 65 61 64 65 72 e2 80 99 20 73 68 6f 75 ...most.cases....:reader....shou
1af20 6c 64 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 2e 20 20 57 68 65 6e 20 64 65 66 69 ld.also.be.specified...When.defi
1af40 6e 69 6e 67 20 73 75 63 68 0a 20 20 20 20 20 61 20 73 75 66 66 69 78 20 73 65 70 61 72 61 74 65 ning.such......a.suffix.separate
1af60 6c 79 2c 20 74 68 65 20 22 61 6c 69 73 74 20 6b 65 79 22 20 68 61 73 20 74 6f 20 62 65 20 73 70 ly,.the."alist.key".has.to.be.sp
1af80 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 20 e2 80 98 3a 76 61 72 69 61 ecified.using.the.........:varia
1afa0 62 6c 65 e2 80 99 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 2e 0a 0a 20 20 20 20 20 54 ble....keyword.argument........T
1afc0 68 69 73 20 63 6c 61 73 73 20 69 73 20 73 74 69 6c 6c 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 his.class.is.still.experimental.
1afe0 69 74 20 69 73 20 73 6f 6d 65 77 68 61 74 20 6c 69 6b 65 6c 79 20 74 68 61 74 20 66 75 74 75 72 it.is.somewhat.likely.that.futur
1b000 65 0a 20 20 20 20 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 6f 6e e2 80 99 74 20 62 65 20 66 e......improvements.won...t.be.f
1b020 75 6c 6c 79 20 62 61 63 6b 77 61 72 64 20 63 6f 6d 70 61 74 69 62 6c 65 2e 0a 0a 20 20 20 e2 80 ully.backward.compatible........
1b040 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 2d 74 61 72 67 ..The....transient-describe-targ
1b060 65 74 e2 80 99 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 63 6f 6d 6d 61 et....class.is.used.by.the.comma
1b080 6e 64 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 e2 80 99 nd.........transient-describe...
1b0a0 2e 0a 0a 20 20 20 e2 80 a2 20 54 68 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 ..........The....transient-value
1b0c0 2d 70 72 65 73 65 74 e2 80 99 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 74 6f 20 69 6d 70 6c -preset....class.is.used.to.impl
1b0e0 65 6d 65 6e 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 ement.the.command.........transi
1b100 65 6e 74 2d 70 72 65 73 65 74 e2 80 99 2c 20 77 68 69 63 68 20 61 63 74 69 76 61 74 65 73 20 61 ent-preset...,.which.activates.a
1b120 20 76 61 6c 75 65 20 70 72 65 73 65 74 2e 0a 0a 20 20 20 4d 61 67 69 74 20 64 65 66 69 6e 65 73 .value.preset......Magit.defines
1b140 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6c 61 73 73 65 73 2c 20 77 68 69 63 68 20 63 61 6e 20 73 .additional.classes,.which.can.s
1b160 65 72 76 65 20 61 73 20 65 78 61 6d 70 6c 65 73 20 66 6f 72 20 74 68 65 0a 66 61 6e 63 79 20 74 erve.as.examples.for.the.fancy.t
1b180 68 69 6e 67 73 20 79 6f 75 20 63 61 6e 20 64 6f 20 77 69 74 68 6f 75 74 20 6d 6f 64 69 66 79 69 hings.you.can.do.without.modifyi
1b1a0 6e 67 20 54 72 61 6e 73 69 65 6e 74 2e 20 20 53 6f 6d 65 20 6f 66 20 74 68 65 73 65 0a 63 6c 61 ng.Transient...Some.of.these.cla
1b1c0 73 73 65 73 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20 67 65 74 20 67 65 6e 65 72 61 6c 69 7a 65 64 sses.will.likely.get.generalized
1b1e0 20 61 6e 64 20 61 64 64 65 64 20 74 6f 20 54 72 61 6e 73 69 65 6e 74 2e 20 20 46 6f 72 20 6e 6f .and.added.to.Transient...For.no
1b200 77 0a 74 68 65 79 20 61 72 65 20 76 65 72 79 20 6d 75 63 68 20 73 75 62 6a 65 63 74 20 74 6f 20 w.they.are.very.much.subject.to.
1b220 63 68 61 6e 67 65 20 61 6e 64 20 6e 6f 74 20 64 6f 63 75 6d 65 6e 74 65 64 2e 0a 0a 1f 0a 46 69 change.and.not.documented.....Fi
1b240 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 50 72 65 66 69 le:.doci3EOZM.info,..Node:.Prefi
1b260 78 20 4d 65 74 68 6f 64 73 2c 20 20 4e 65 78 74 3a 20 53 75 66 66 69 78 20 4d 65 74 68 6f 64 73 x.Methods,..Next:.Suffix.Methods
1b280 2c 20 20 50 72 65 76 3a 20 53 75 66 66 69 78 20 43 6c 61 73 73 65 73 2c 20 20 55 70 3a 20 43 6c ,..Prev:.Suffix.Classes,..Up:.Cl
1b2a0 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 0a 35 2e 35 20 50 72 65 66 69 78 20 4d 65 asses.and.Methods..5.5.Prefix.Me
1b2c0 74 68 6f 64 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 6f 20 67 65 74 thods.==================..To.get
1b2e0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 6d 65 74 68 6f 64 73 20 69 .information.about.the.methods.i
1b300 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 74 68 65 73 65 20 67 65 6e 65 72 69 63 0a 66 75 6e 63 74 69 mplementing.these.generic.functi
1b320 6f 6e 73 20 75 73 65 20 e2 80 98 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e e2 80 99 2e ons.use....describe-function....
1b340 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 ..Function:.transient-init-value
1b360 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 .obj......This.generic.function.
1b380 73 65 74 73 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f 62 sets.the.initial.value.of.the.ob
1b3a0 6a 65 63 74 20 4f 42 4a 2e 0a 20 20 20 20 20 4d 65 74 68 6f 64 73 20 65 78 69 73 74 20 66 6f 72 ject.OBJ.......Methods.exist.for
1b3c0 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 2e .both.prefix.and.suffix.objects.
1b3e0 0a 0a 20 20 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 6d 65 74 68 6f 64 20 66 6f 72 20 70 72 .......The.default.method.for.pr
1b400 65 66 69 78 20 6f 62 6a 65 63 74 73 20 73 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4f efix.objects.sets.the.value.of.O
1b420 42 4a e2 80 99 73 0a 20 20 20 20 20 e2 80 98 76 61 6c 75 65 e2 80 99 20 73 6c 6f 74 20 74 6f 20 BJ...s.........value....slot.to.
1b440 74 68 65 20 73 65 74 2c 20 73 61 76 65 64 20 6f 72 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e the.set,.saved.or.default.value.
1b460 20 20 54 68 65 20 76 61 6c 75 65 20 74 68 61 74 20 69 73 0a 20 20 20 20 20 73 65 74 20 66 6f 72 ..The.value.that.is......set.for
1b480 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 73 73 69 6f 6e 20 69 73 20 70 72 65 66 65 72 72 65 .the.current.session.is.preferre
1b4a0 64 20 6f 76 65 72 20 74 68 65 20 73 61 76 65 64 20 76 61 6c 75 65 2c 0a 20 20 20 20 20 77 68 69 d.over.the.saved.value,......whi
1b4c0 63 68 20 69 73 20 70 72 65 66 65 72 72 65 64 20 6f 76 65 72 20 74 68 65 20 64 65 66 61 75 6c 74 ch.is.preferred.over.the.default
1b4e0 20 76 61 6c 75 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 .value........The.default.value.
1b500 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 75 73 69 6e 67 20 74 68 65 20 67 65 6e 65 72 69 63 20 is.determined.using.the.generic.
1b520 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 function.........transient-defau
1b540 6c 74 2d 76 61 6c 75 65 e2 80 99 2e 20 20 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 68 61 lt-value......If.you.need.to.cha
1b560 6e 67 65 20 68 6f 77 20 74 68 65 20 76 61 6c 75 65 20 66 6f 72 0a 20 20 20 20 20 61 20 70 72 65 nge.how.the.value.for......a.pre
1b580 66 69 78 20 63 6c 61 73 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 2c 20 69 74 73 20 75 73 75 fix.class.is.determined,.its.usu
1b5a0 61 6c 6c 79 20 73 75 66 66 69 63 69 65 6e 74 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 61 0a 20 ally.sufficient.to.implement.a..
1b5c0 20 20 20 20 6d 65 74 68 6f 64 20 66 6f 72 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 46 ....method.for.that.function...F
1b5e0 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 unction:.transient-default-value
1b600 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 .obj......This.generic.function.
1b620 72 65 74 75 72 6e 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 74 68 65 returns.the.default.value.of.the
1b640 20 6f 62 6a 65 63 74 20 4f 42 4a 2e 0a 20 20 20 20 20 4d 65 74 68 6f 64 73 20 65 78 69 73 74 20 .object.OBJ.......Methods.exist.
1b660 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 for.both.prefix.and.suffix.objec
1b680 74 73 2e 0a 0a 20 20 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 6d 65 74 68 6f 64 20 66 6f 72 ts........The.default.method.for
1b6a0 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 73 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 .prefix.objects.returns.the.valu
1b6c0 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 e2 80 98 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 e2 80 e.of.the.........default-value..
1b6e0 99 20 73 6c 6f 74 20 69 66 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 20 61 6e 64 20 6e 6f 74 20 ..slot.if.that.is.bound.and.not.
1b700 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 66 20 69 74 20 69 73 0a 20 20 20 20 20 61 20 66 75 6e a.function...If.it.is......a.fun
1b720 63 74 69 6f 6e 2c 20 74 68 61 74 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 67 65 74 20 74 68 65 ction,.that.is.called.to.get.the
1b740 20 76 61 6c 75 65 2e 20 20 49 66 20 74 68 65 20 73 6c 6f 74 20 69 73 0a 20 20 20 20 20 75 6e 62 .value...If.the.slot.is......unb
1b760 6f 75 6e 64 2c 20 e2 80 98 6e 69 6c e2 80 99 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 0a 46 75 ound,....nil....is.returned...Fu
1b780 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 65 20 6f nction:.transient-prefix-value.o
1b7a0 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 72 65 bj......This.generic.function.re
1b7c0 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 turns.the.value.of.the.prefix.ob
1b7e0 6a 65 63 74 20 4f 42 4a 2e 0a 0a 20 20 20 20 20 4f 42 4a 20 69 73 20 61 20 70 72 6f 74 6f 74 79 ject.OBJ........OBJ.is.a.prototy
1b800 70 65 20 6f 62 6a 65 63 74 20 61 6e 64 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f 20 73 65 pe.object.and.is.only.used.to.se
1b820 6c 65 63 74 20 74 68 65 0a 20 20 20 20 20 61 70 70 72 6f 70 72 69 61 74 65 20 6d 65 74 68 6f 64 lect.the......appropriate.method
1b840 20 6f 66 20 74 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 .of.this.generic.function...This
1b860 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 0a 20 20 20 20 20 6e 6f 74 20 72 65 74 75 72 6e 20 74 .function.does......not.return.t
1b880 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 61 74 20 6f 62 6a 65 63 74 2e 20 20 49 6e 73 74 65 61 he.value.of.that.object...Instea
1b8a0 64 20 69 74 20 65 78 74 72 61 63 74 73 20 74 68 65 20 6e 61 6d 65 0a 20 20 20 20 20 6f 66 20 74 d.it.extracts.the.name......of.t
1b8c0 68 65 20 72 65 73 70 65 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 20 66 72 6f 6d 20 74 68 65 20 6f he.respective.command.from.the.o
1b8e0 62 6a 65 63 74 20 61 6e 64 20 75 73 65 73 20 74 68 61 74 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 bject.and.uses.that.to.collect..
1b900 20 20 20 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 73 20 66 72 6f 6d 20 74 68 65 20 ....the.current.values.from.the.
1b920 73 75 66 66 69 78 65 73 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 66 72 6f 6d 20 77 68 69 63 suffixes.of.the.prefix.from.whic
1b940 68 20 74 68 65 0a 20 20 20 20 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 h.the......current.command.was.i
1b960 6e 76 6f 6b 65 64 2e 20 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 nvoked...If.the.current.command.
1b980 77 61 73 20 6e 6f 74 0a 20 20 20 20 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 74 68 65 20 69 64 was.not......invoked.from.the.id
1b9a0 65 6e 74 69 66 69 65 64 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 74 68 69 73 20 6d 65 74 68 6f entified.prefix,.then.this.metho
1b9c0 64 20 72 65 74 75 72 6e 73 20 74 68 65 0a 20 20 20 20 20 73 65 74 2c 20 73 61 76 65 20 6f 72 20 d.returns.the......set,.save.or.
1b9e0 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2c 20 61 73 20 64 65 73 63 72 69 62 65 64 20 66 6f 72 20 default.value,.as.described.for.
1ba00 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 2e 0a 0a 20 20 20 20 20 54 68 69 73 ...transient-args...........This
1ba20 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 .function.is.only.intended.to.be
1ba40 20 75 73 65 64 20 62 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 2e 20 20 .used.by....transient-args......
1ba60 49 74 0a 20 20 20 20 20 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 61 73 20 61 6e 20 69 6e 74 It......is.not.defined.as.an.int
1ba80 65 72 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 62 65 63 61 75 73 65 20 74 68 69 72 64 2d 70 61 72 ernal.function.because.third-par
1baa0 74 79 20 70 61 63 6b 61 67 65 73 0a 20 20 20 20 20 6d 61 79 20 64 65 66 69 6e 65 20 74 68 65 69 ty.packages......may.define.thei
1bac0 72 20 6f 77 6e 20 6d 65 74 68 6f 64 73 2e 20 20 54 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6d 65 r.own.methods...That.does.not.me
1bae0 61 6e 20 74 68 61 74 20 69 74 20 77 6f 75 6c 64 20 62 65 0a 20 20 20 20 20 61 20 67 6f 6f 64 20 an.that.it.would.be......a.good.
1bb00 69 64 65 61 20 74 6f 20 63 61 6c 6c 20 69 74 20 66 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 75 idea.to.call.it.for.any.other.pu
1bb20 72 70 6f 73 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 72 65 73 70 65 63 74 69 76 65 20 67 65 6e 65 rpose........The.respective.gene
1bb40 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 ric.function.for.infix.and.suffi
1bb60 78 20 6f 62 6a 65 63 74 73 20 69 73 0a 20 20 20 20 20 6e 61 6d 65 64 20 e2 80 98 74 72 61 6e 73 x.objects.is......named....trans
1bb80 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 e2 80 99 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 ient-infix-value......Function:.
1bba0 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 20 6f 62 6a 0a 20 20 20 20 20 54 68 transient-init-scope.obj......Th
1bbc0 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 73 63 6f is.generic.function.sets.the.sco
1bbe0 70 65 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 20 4f 42 4a 2e 20 20 4d 65 74 68 6f 64 73 0a 20 pe.of.the.object.OBJ...Methods..
1bc00 20 20 20 20 65 78 69 73 74 20 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 ....exist.for.both.prefix.and.su
1bc20 66 66 69 78 20 6f 62 6a 65 63 74 73 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f ffix.objects........This.functio
1bc40 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 61 6c 6c 20 70 72 65 66 69 78 20 61 6e 64 20 73 n.is.called.for.all.prefix.and.s
1bc60 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 62 75 74 0a 20 20 20 20 20 75 6e 6c 65 73 73 20 uffix.commands,.but......unless.
1bc80 61 20 63 6f 6e 63 72 65 74 65 20 6d 65 74 68 6f 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 a.concrete.method.is.implemented
1bca0 20 74 68 69 73 20 66 61 6c 6c 73 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 0a 20 20 20 20 20 .this.falls.through.to.the......
1bcc0 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 77 68 69 63 68 20 69 73 default.implementation,.which.is
1bce0 20 61 20 6e 6f 6f 70 2e 0a 0a 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 76 61 .a.noop.........transient-set-va
1bd00 6c 75 65 e2 80 99 2c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 76 61 6c 75 65 e2 lue...,....transient-save-value.
1bd20 80 99 2c 0a e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 65 74 2d 76 61 6c 75 65 e2 80 99 2c ..,....transient-reset-value...,
1bd40 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 6b 65 79 e2 80 99 2c 0a e2 ....transient--history-key...,..
1bd60 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 70 75 73 68 e2 80 99 20 61 6e 64 ..transient--history-push....and
1bd80 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 69 6e 69 74 e2 80 99 20 61 ....transient--history-init....a
1bda0 72 65 20 6f 74 68 65 72 0a 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 64 65 61 6c 69 re.other.generic.functions.deali
1bdc0 6e 67 20 77 69 74 68 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 72 65 66 69 78 20 6f 62 6a 65 ng.with.the.value.of.prefix.obje
1bde0 63 74 73 2e 20 20 53 65 65 20 74 68 65 69 72 0a 64 6f 63 2d 73 74 72 69 6e 67 73 20 66 6f 72 20 cts...See.their.doc-strings.for.
1be00 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 20 e2 80 98 74 72 61 6e 73 69 65 more.information.........transie
1be20 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 e2 80 99 20 69 73 20 61 6e 6f 74 68 65 72 20 67 65 6e 65 72 nt-show-help....is.another.gener
1be40 69 63 20 66 75 6e 63 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 66 6f 72 0a 70 72 65 66 ic.function.implemented.for.pref
1be60 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 6d 65 74 68 6f 64 ix.commands...The.default.method
1be80 20 65 66 66 65 63 74 69 76 65 6c 79 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 63 6f 6d 6d 61 .effectively.describes.the.comma
1bea0 6e 64 0a 75 73 69 6e 67 20 e2 80 98 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e e2 80 99 nd.using....describe-function...
1bec0 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 .....File:.doci3EOZM.info,..Node
1bee0 3a 20 53 75 66 66 69 78 20 4d 65 74 68 6f 64 73 2c 20 20 4e 65 78 74 3a 20 50 72 65 66 69 78 20 :.Suffix.Methods,..Next:.Prefix.
1bf00 53 6c 6f 74 73 2c 20 20 50 72 65 76 3a 20 50 72 65 66 69 78 20 4d 65 74 68 6f 64 73 2c 20 20 55 Slots,..Prev:.Prefix.Methods,..U
1bf20 70 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 0a 35 2e 36 20 53 75 66 66 p:.Classes.and.Methods..5.6.Suff
1bf40 69 78 20 4d 65 74 68 6f 64 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 ix.Methods.==================..T
1bf60 6f 20 67 65 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 6d 65 74 68 o.get.information.about.the.meth
1bf80 6f 64 73 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 74 68 65 73 65 20 67 65 6e 65 72 69 63 0a 66 ods.implementing.these.generic.f
1bfa0 75 6e 63 74 69 6f 6e 73 20 75 73 65 20 e2 80 98 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f unctions.use....describe-functio
1bfc0 6e e2 80 99 2e 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 2a 20 53 75 66 66 69 78 20 56 61 6c 75 65 20 4d n......*.Menu:..*.Suffix.Value.M
1bfe0 65 74 68 6f 64 73 3a 3a 0a 2a 20 53 75 66 66 69 78 20 46 6f 72 6d 61 74 20 4d 65 74 68 6f 64 73 ethods::.*.Suffix.Format.Methods
1c000 3a 3a 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 ::....File:.doci3EOZM.info,..Nod
1c020 65 3a 20 53 75 66 66 69 78 20 56 61 6c 75 65 20 4d 65 74 68 6f 64 73 2c 20 20 4e 65 78 74 3a 20 e:.Suffix.Value.Methods,..Next:.
1c040 53 75 66 66 69 78 20 46 6f 72 6d 61 74 20 4d 65 74 68 6f 64 73 2c 20 20 55 70 3a 20 53 75 66 66 Suffix.Format.Methods,..Up:.Suff
1c060 69 78 20 4d 65 74 68 6f 64 73 0a 0a 35 2e 36 2e 31 20 53 75 66 66 69 78 20 56 61 6c 75 65 20 4d ix.Methods..5.6.1.Suffix.Value.M
1c080 65 74 68 6f 64 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ethods.-------------------------
1c0a0 2d 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 -..Function:.transient-init-valu
1c0c0 65 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e e.obj......This.generic.function
1c0e0 20 73 65 74 73 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f .sets.the.initial.value.of.the.o
1c100 62 6a 65 63 74 20 4f 42 4a 2e 0a 20 20 20 20 20 4d 65 74 68 6f 64 73 20 65 78 69 73 74 20 66 6f bject.OBJ.......Methods.exist.fo
1c120 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 r.both.prefix.and.suffix.objects
1c140 2e 0a 0a 20 20 20 20 20 46 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e ........For....transient-argumen
1c160 74 e2 80 99 20 6f 62 6a 65 63 74 73 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 68 61 6e 64 6c t....objects.this.function.handl
1c180 65 73 20 73 65 74 74 69 6e 67 20 74 68 65 0a 20 20 20 20 20 76 61 6c 75 65 20 62 79 20 69 74 73 es.setting.the......value.by.its
1c1a0 65 6c 66 2e 0a 0a 20 20 20 20 20 46 6f 72 20 6f 74 68 65 72 20 e2 80 98 74 72 61 6e 73 69 65 6e elf........For.other....transien
1c1c0 74 2d 73 75 66 66 69 78 e2 80 99 20 6f 62 6a 65 63 74 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 e2 t-suffix....objects.(including..
1c1e0 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 e2 80 99 0a 20 20 20 20 20 6f 62 6a 65 63 74 ..transient-infix.........object
1c200 73 29 2c 20 74 68 69 73 20 63 61 6c 6c 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 s),.this.calls....transient-defa
1c220 75 6c 74 2d 76 61 6c 75 65 e2 80 99 20 61 6e 64 20 75 73 65 73 20 74 68 65 20 76 61 6c 75 65 0a ult-value....and.uses.the.value.
1c240 20 20 20 20 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 61 74 2c 20 75 6e 6c 65 73 73 20 69 74 .....returned.by.that,.unless.it
1c260 20 69 73 20 74 68 65 20 73 70 65 63 69 61 6c 20 76 61 6c 75 65 20 e2 80 98 65 69 65 69 6f 2d 2d .is.the.special.value....eieio--
1c280 75 6e 62 6f 75 6e 64 e2 80 99 2c 0a 20 20 20 20 20 77 68 69 63 68 20 69 6e 64 69 63 61 74 65 73 unbound...,......which.indicates
1c2a0 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e .that.there.is.no.default.value.
1c2c0 20 20 53 69 6e 63 65 20 74 68 61 74 20 69 73 20 77 68 61 74 0a 20 20 20 20 20 74 68 65 20 64 65 ..Since.that.is.what......the.de
1c2e0 66 61 75 6c 74 20 6d 65 74 68 6f 64 20 66 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 fault.method.for....transient-su
1c300 66 66 69 78 e2 80 99 20 6f 62 6a 65 63 74 73 20 64 6f 65 73 2c 20 62 6f 74 68 20 6f 66 0a 20 20 ffix....objects.does,.both.of...
1c320 20 20 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 65 66 66 65 63 74 69 76 65 6c 79 20 61 ...these.functions.effectively.a
1c340 72 65 20 6e 6f 6f 70 73 20 66 6f 72 20 74 68 65 73 65 20 63 6c 61 73 73 65 73 2e 0a 0a 20 20 20 re.noops.for.these.classes......
1c360 20 20 49 66 20 79 6f 75 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 63 6c 61 73 73 20 74 68 61 74 20 ..If.you.implement.a.class.that.
1c380 64 65 72 69 76 65 73 20 66 72 6f 6d 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 e2 derives.from....transient-infix.
1c3a0 80 99 0a 20 20 20 20 20 64 69 72 65 63 74 6c 79 2c 20 74 68 65 6e 20 79 6f 75 20 6d 75 73 74 20 ........directly,.then.you.must.
1c3c0 69 6d 70 6c 65 6d 65 6e 74 20 61 20 64 65 64 69 63 61 74 65 64 20 6d 65 74 68 6f 64 20 66 6f 72 implement.a.dedicated.method.for
1c3e0 20 74 68 69 73 0a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 2f 6f 72 20 e2 80 98 74 72 .this......function.and/or....tr
1c400 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 e2 80 99 2e 0a 0a 46 75 6e 63 74 ansient-default-value......Funct
1c420 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 6f 62 6a ion:.transient-default-value.obj
1c440 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 ......This.generic.function.retu
1c460 72 6e 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f 62 6a rns.the.default.value.of.the.obj
1c480 65 63 74 20 4f 42 4a 2e 0a 20 20 20 20 20 4d 65 74 68 6f 64 73 20 65 78 69 73 74 20 66 6f 72 20 ect.OBJ.......Methods.exist.for.
1c4a0 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 2e 0a both.prefix.and.suffix.objects..
1c4c0 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 .Function:.transient-infix-read.
1c4e0 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 64 obj......This.generic.function.d
1c500 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 69 etermines.the.new.value.of.the.i
1c520 6e 66 69 78 20 6f 62 6a 65 63 74 0a 20 20 20 20 20 4f 42 4a 2e 0a 0a 20 20 20 20 20 54 68 69 73 nfix.object......OBJ........This
1c540 20 66 75 6e 63 74 69 6f 6e 20 6d 65 72 65 6c 79 20 64 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 .function.merely.determines.the.
1c560 76 61 6c 75 65 3b 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 e2 80 99 value;....transient-infix-set...
1c580 20 69 73 0a 20 20 20 20 20 75 73 65 64 20 74 6f 20 61 63 74 75 61 6c 6c 79 20 73 74 6f 72 65 20 .is......used.to.actually.store.
1c5a0 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 69 6e 20 74 68 65 20 6f 62 6a 65 63 74 2e 0a 0a 20 20 the.new.value.in.the.object.....
1c5c0 20 20 20 46 6f 72 20 6d 6f 73 74 20 69 6e 66 69 78 20 63 6c 61 73 73 65 73 20 74 68 69 73 20 69 ...For.most.infix.classes.this.i
1c5e0 73 20 64 6f 6e 65 20 62 79 20 72 65 61 64 69 6e 67 20 61 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 s.done.by.reading.a.value.from.t
1c600 68 65 0a 20 20 20 20 20 75 73 65 72 20 75 73 69 6e 67 20 74 68 65 20 72 65 61 64 65 72 20 73 70 he......user.using.the.reader.sp
1c620 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 e2 80 98 72 65 61 64 65 72 e2 80 99 20 73 6c 6f 74 ecified.by.the....reader....slot
1c640 20 28 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e .(using.the.........transient-in
1c660 66 69 78 2d 76 61 6c 75 65 e2 80 99 20 6d 65 74 68 6f 64 20 64 65 73 63 72 69 62 65 64 20 62 65 fix-value....method.described.be
1c680 6c 6f 77 29 2e 0a 0a 20 20 20 20 20 46 6f 72 20 73 6f 6d 65 20 69 6e 66 69 78 20 63 6c 61 73 73 low)........For.some.infix.class
1c6a0 65 73 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 63 68 61 6e 67 65 64 20 77 69 74 68 6f 75 74 20 es.the.value.is.changed.without.
1c6c0 72 65 61 64 69 6e 67 0a 20 20 20 20 20 61 6e 79 74 68 69 6e 67 20 69 6e 20 74 68 65 20 6d 69 6e reading......anything.in.the.min
1c6e0 69 62 75 66 66 65 72 2c 20 69 2e 65 2e 2c 20 74 68 65 20 6d 65 72 65 20 61 63 74 20 6f 66 20 69 ibuffer,.i.e.,.the.mere.act.of.i
1c700 6e 76 6f 6b 69 6e 67 20 74 68 65 0a 20 20 20 20 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 64 nvoking.the......infix.command.d
1c720 65 74 65 72 6d 69 6e 65 73 20 77 68 61 74 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 73 68 6f etermines.what.the.new.value.sho
1c740 75 6c 64 20 62 65 2c 20 62 61 73 65 64 20 6f 6e 20 74 68 65 0a 20 20 20 20 20 70 72 65 76 69 6f uld.be,.based.on.the......previo
1c760 75 73 20 76 61 6c 75 65 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 70 us.value...Function:.transient-p
1c780 72 6f 6d 70 74 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 rompt.obj......This.generic.func
1c7a0 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 70 72 6f 6d 70 74 20 74 6f 20 62 65 20 75 73 tion.returns.the.prompt.to.be.us
1c7c0 65 64 20 74 6f 20 72 65 61 64 20 69 6e 66 69 78 0a 20 20 20 20 20 6f 62 6a 65 63 74 20 4f 42 4a ed.to.read.infix......object.OBJ
1c7e0 e2 80 99 73 20 76 61 6c 75 65 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 ...s.value...Function:.transient
1c800 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 0a 20 20 20 20 20 54 68 69 73 20 67 -infix-set.obj.value......This.g
1c820 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 6f eneric.function.sets.the.value.o
1c840 66 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a 20 74 6f 20 56 41 4c 55 45 2e 0a 0a 46 75 f.infix.object.OBJ.to.VALUE...Fu
1c860 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 6f 62 nction:.transient-infix-value.ob
1c880 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 j......This.generic.function.ret
1c8a0 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 20 6f 62 6a urns.the.value.of.the.suffix.obj
1c8c0 65 63 74 20 4f 42 4a 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 ect.OBJ........This.function.is.
1c8e0 63 61 6c 6c 65 64 20 62 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 20 28 called.by....transient-args....(
1c900 77 68 69 63 68 20 73 65 65 29 2c 20 6d 65 61 6e 69 6e 67 0a 20 20 20 20 20 74 68 69 73 20 66 75 which.see),.meaning......this.fu
1c920 6e 63 74 69 6f 6e 20 69 73 20 68 6f 77 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 74 72 61 nction.is.how.the.value.of.a.tra
1c940 6e 73 69 65 6e 74 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 73 6f 20 74 68 61 74 0a 20 20 20 nsient.is.determined.so.that....
1c960 20 20 74 68 65 20 69 6e 76 6f 6b 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e ..the.invoked.suffix.command.can
1c980 20 75 73 65 20 69 74 2e 0a 0a 20 20 20 20 20 43 75 72 72 65 6e 74 6c 79 20 6d 6f 73 74 20 76 61 .use.it........Currently.most.va
1c9a0 6c 75 65 73 20 61 72 65 20 73 74 72 69 6e 67 73 2c 20 62 75 74 20 74 68 61 74 20 69 73 20 6e 6f lues.are.strings,.but.that.is.no
1c9c0 74 20 73 65 74 20 69 6e 20 73 74 6f 6e 65 2e 0a 20 20 20 20 20 e2 80 98 6e 69 6c e2 80 99 20 69 t.set.in.stone..........nil....i
1c9e0 73 20 6e 6f 74 20 61 20 76 61 6c 75 65 2c 20 69 74 20 6d 65 61 6e 73 20 e2 80 9c 6e 6f 20 76 61 s.not.a.value,.it.means....no.va
1ca00 6c 75 65 e2 80 9d 2e 0a 0a 20 20 20 20 20 55 73 75 61 6c 6c 79 20 6f 6e 6c 79 20 69 6e 66 69 78 lue...........Usually.only.infix
1ca20 65 73 20 68 61 76 65 20 61 20 76 61 6c 75 65 2c 20 62 75 74 20 73 65 65 20 74 68 65 20 6d 65 74 es.have.a.value,.but.see.the.met
1ca40 68 6f 64 20 66 6f 72 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 hod.for.........transient-suffix
1ca60 e2 80 99 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 ......Function:.transient-init-s
1ca80 63 6f 70 65 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 cope.obj......This.generic.funct
1caa0 69 6f 6e 20 73 65 74 73 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 ion.sets.the.scope.of.the.object
1cac0 20 4f 42 4a 2e 20 20 4d 65 74 68 6f 64 73 0a 20 20 20 20 20 65 78 69 73 74 20 66 6f 72 20 62 6f .OBJ...Methods......exist.for.bo
1cae0 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 2e 0a 0a 20 th.prefix.and.suffix.objects....
1cb00 20 20 20 20 54 68 65 20 73 63 6f 70 65 20 69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 70 72 6f 70 ....The.scope.is.actually.a.prop
1cb20 65 72 74 79 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 2c 20 6e 6f erty.of.the.transient.prefix,.no
1cb40 74 20 6f 66 0a 20 20 20 20 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 69 78 65 73 2e 20 20 t.of......individual.suffixes...
1cb60 48 6f 77 65 76 65 72 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 69 6e 76 6f 6b 65 However.it.is.possible.to.invoke
1cb80 20 61 20 73 75 66 66 69 78 0a 20 20 20 20 20 63 6f 6d 6d 61 6e 64 20 64 69 72 65 63 74 6c 79 20 .a.suffix......command.directly.
1cba0 69 6e 73 74 65 61 64 20 6f 66 20 66 72 6f 6d 20 61 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 49 6e instead.of.from.a.transient...In
1cbc0 20 74 68 61 74 20 63 61 73 65 2c 20 69 66 20 74 68 65 0a 20 20 20 20 20 73 75 66 66 69 78 20 65 .that.case,.if.the......suffix.e
1cbe0 78 70 65 63 74 73 20 61 20 73 63 6f 70 65 2c 20 74 68 65 6e 20 69 74 20 68 61 73 20 74 6f 20 64 xpects.a.scope,.then.it.has.to.d
1cc00 65 74 65 72 6d 69 6e 65 20 74 68 61 74 20 69 74 73 65 6c 66 20 61 6e 64 0a 20 20 20 20 20 73 74 etermine.that.itself.and......st
1cc20 6f 72 65 20 69 74 20 69 6e 20 69 74 73 20 e2 80 98 73 63 6f 70 65 e2 80 99 20 73 6c 6f 74 2e 0a ore.it.in.its....scope....slot..
1cc40 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 6f ......This.function.is.called.fo
1cc60 72 20 61 6c 6c 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 r.all.prefix.and.suffix.commands
1cc80 2c 20 62 75 74 0a 20 20 20 20 20 75 6e 6c 65 73 73 20 61 20 63 6f 6e 63 72 65 74 65 20 6d 65 74 ,.but......unless.a.concrete.met
1cca0 68 6f 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2c 20 74 68 69 73 20 66 61 6c 6c 73 20 74 hod.is.implemented,.this.falls.t
1ccc0 68 72 6f 75 67 68 20 74 6f 20 74 68 65 0a 20 20 20 20 20 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 hrough.to.the......default.imple
1cce0 6d 65 6e 74 61 74 69 6f 6e 2c 20 77 68 69 63 68 20 69 73 20 61 20 6e 6f 6f 70 2e 0a 0a 1f 0a 46 mentation,.which.is.a.noop.....F
1cd00 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 53 75 66 66 ile:.doci3EOZM.info,..Node:.Suff
1cd20 69 78 20 46 6f 72 6d 61 74 20 4d 65 74 68 6f 64 73 2c 20 20 50 72 65 76 3a 20 53 75 66 66 69 78 ix.Format.Methods,..Prev:.Suffix
1cd40 20 56 61 6c 75 65 20 4d 65 74 68 6f 64 73 2c 20 20 55 70 3a 20 53 75 66 66 69 78 20 4d 65 74 68 .Value.Methods,..Up:.Suffix.Meth
1cd60 6f 64 73 0a 0a 35 2e 36 2e 32 20 53 75 66 66 69 78 20 46 6f 72 6d 61 74 20 4d 65 74 68 6f 64 73 ods..5.6.2.Suffix.Format.Methods
1cd80 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 75 .---------------------------..Fu
1cda0 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 20 6f 62 6a 0a 20 20 20 nction:.transient-format.obj....
1cdc0 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 ..This.generic.function.formats.
1cde0 61 6e 64 20 72 65 74 75 72 6e 73 20 4f 42 4a 20 66 6f 72 20 64 69 73 70 6c 61 79 2e 0a 0a 20 20 and.returns.OBJ.for.display.....
1ce00 20 20 20 57 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c ...When.this.function.is.called,
1ce20 20 74 68 65 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 20 69 73 20 73 6f 6d 65 .then.the.current.buffer.is.some
1ce40 0a 20 20 20 20 20 74 65 6d 70 6f 72 61 72 79 20 62 75 66 66 65 72 2e 20 20 49 66 20 79 6f 75 20 ......temporary.buffer...If.you.
1ce60 6e 65 65 64 20 74 68 65 20 62 75 66 66 65 72 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 70 need.the.buffer.from.which.the.p
1ce80 72 65 66 69 78 0a 20 20 20 20 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 74 refix......command.was.invoked.t
1cea0 6f 20 62 65 20 63 75 72 72 65 6e 74 2c 20 74 68 65 6e 20 64 6f 20 73 6f 20 62 79 20 74 65 6d 70 o.be.current,.then.do.so.by.temp
1cec0 6f 72 61 72 69 6c 79 20 6d 61 6b 69 6e 67 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 orarily.making.........transient
1cee0 2d 2d 73 6f 75 72 63 65 2d 62 75 66 66 65 72 e2 80 99 20 63 75 72 72 65 6e 74 2e 0a 0a 46 75 6e --source-buffer....current...Fun
1cf00 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 6b 65 79 20 6f 62 6a 0a ction:.transient-format-key.obj.
1cf20 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 .....This.generic.function.forma
1cf40 74 73 20 4f 42 4a e2 80 99 73 20 e2 80 98 6b 65 79 e2 80 99 20 66 6f 72 20 64 69 73 70 6c 61 79 ts.OBJ...s....key....for.display
1cf60 20 61 6e 64 20 72 65 74 75 72 6e 73 0a 20 20 20 20 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 0a 46 .and.returns......the.result...F
1cf80 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 unction:.transient-format-descri
1cfa0 70 74 69 6f 6e 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 ption.obj......This.generic.func
1cfc0 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 4f 42 4a e2 80 99 73 20 e2 80 98 64 65 73 63 72 69 70 74 tion.formats.OBJ...s....descript
1cfe0 69 6f 6e e2 80 99 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 0a 20 20 20 20 20 72 65 74 75 ion....for.display.and......retu
1d000 72 6e 73 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 rns.the.result...Function:.trans
1d020 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 20 6f 62 6a 0a 20 20 20 20 20 54 68 69 73 20 ient-format-value.obj......This.
1d040 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 4f 42 4a e2 80 99 73 generic.function.formats.OBJ...s
1d060 20 76 61 6c 75 65 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 73 0a 20 .value.for.display.and.returns..
1d080 20 20 20 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 ....the.result...Function:.trans
1d0a0 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 20 6f 62 6a 0a 20 20 20 20 20 53 68 6f 77 20 68 65 6c ient-show-help.obj......Show.hel
1d0c0 70 20 66 6f 72 20 74 68 65 20 70 72 65 66 69 78 2c 20 69 6e 66 69 78 20 6f 72 20 73 75 66 66 69 p.for.the.prefix,.infix.or.suffi
1d0e0 78 20 63 6f 6d 6d 61 6e 64 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 0a 20 20 20 20 20 4f 42 x.command.represented.by......OB
1d100 4a 2e 0a 0a 20 20 20 20 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 4f 42 4a e2 80 99 73 20 74 J........Regardless.of.OBJ...s.t
1d120 79 70 65 2c 20 69 66 20 69 74 73 20 e2 80 98 73 68 6f 77 2d 68 65 6c 70 e2 80 99 20 73 6c 6f 74 ype,.if.its....show-help....slot
1d140 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 0a 20 20 20 20 20 74 68 61 74 20 6d 75 73 .is.non-...nil...,......that.mus
1d160 74 20 62 65 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 74 61 6b 65 73 20 4f 42 4a t.be.a.function,.which.takes.OBJ
1d180 20 69 73 20 69 74 73 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 74 0a 20 20 20 20 20 .is.its.only.argument...It......
1d1a0 6d 75 73 74 20 70 72 65 70 61 72 65 2c 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e must.prepare,.display.and.return
1d1c0 20 61 20 62 75 66 66 65 72 2c 20 61 6e 64 20 73 65 6c 65 63 74 20 74 68 65 20 77 69 6e 64 6f 77 .a.buffer,.and.select.the.window
1d1e0 0a 20 20 20 20 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 69 74 2e 20 20 54 68 65 20 e2 ......used.to.display.it...The..
1d200 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 2d 77 69 6e 64 6f 77 e2 80 99 20 ..transient-show-help-window....
1d220 6d 61 63 72 6f 20 69 73 0a 20 20 20 20 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 69 macro.is......intended.for.use.i
1d240 6e 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 46 6f 72 20 70 72 65 66 n.such.functions........For.pref
1d260 69 78 65 73 2c 20 73 68 6f 77 20 74 68 65 20 69 6e 66 6f 20 6d 61 6e 75 61 6c 2c 20 69 66 20 74 ixes,.show.the.info.manual,.if.t
1d280 68 61 74 20 69 73 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 20 hat.is.specified.using.the......
1d2a0 e2 80 98 69 6e 66 6f 2d 6d 61 6e 75 61 6c e2 80 99 20 73 6c 6f 74 2e 20 20 4f 74 68 65 72 77 69 ...info-manual....slot...Otherwi
1d2c0 73 65 2c 20 73 68 6f 77 20 74 68 65 20 6d 61 6e 70 61 67 65 20 69 66 20 74 68 61 74 20 69 73 0a se,.show.the.manpage.if.that.is.
1d2e0 20 20 20 20 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 20 e2 80 98 6d 61 6e 2d .....specified.using.the....man-
1d300 70 61 67 65 e2 80 99 20 73 6c 6f 74 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 73 68 6f 77 20 74 page....slot...Otherwise,.show.t
1d320 68 65 20 63 6f 6d 6d 61 6e 64 e2 80 99 73 0a 20 20 20 20 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f he.command...s......documentatio
1d340 6e 20 73 74 72 69 6e 67 2e 0a 0a 20 20 20 20 20 46 6f 72 20 73 75 66 66 69 78 65 73 2c 20 73 68 n.string........For.suffixes,.sh
1d360 6f 77 20 74 68 65 20 63 6f 6d 6d 61 6e 64 e2 80 99 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e ow.the.command...s.documentation
1d380 20 73 74 72 69 6e 67 2e 0a 0a 20 20 20 20 20 46 6f 72 20 69 6e 66 69 78 65 73 2c 20 73 68 6f 77 .string........For.infixes,.show
1d3a0 20 74 68 65 20 6d 61 6e 70 61 67 65 20 69 66 20 74 68 61 74 20 69 73 20 73 70 65 63 69 66 69 65 .the.manpage.if.that.is.specifie
1d3c0 64 2e 20 20 4f 74 68 65 72 77 69 73 65 20 73 68 6f 77 0a 20 20 20 20 20 74 68 65 20 63 6f 6d 6d d...Otherwise.show......the.comm
1d3e0 61 6e 64 e2 80 99 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 2e 0a 0a 4d and...s.documentation.string...M
1d400 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 68 65 6c 70 2d 77 69 6e 64 6f 77 acro:.transient-with-help-window
1d420 20 26 72 65 73 74 20 62 6f 64 79 0a 20 20 20 20 20 45 76 61 6c 75 61 74 65 20 42 4f 44 59 2c 20 .&rest.body......Evaluate.BODY,.
1d440 73 65 6e 64 20 6f 75 74 70 75 74 20 74 6f 20 e2 80 98 2a 48 65 6c 70 2a e2 80 99 20 62 75 66 66 send.output.to....*Help*....buff
1d460 65 72 2c 20 61 6e 64 20 64 69 73 70 6c 61 79 20 69 74 20 69 6e 20 61 0a 20 20 20 20 20 77 69 6e er,.and.display.it.in.a......win
1d480 64 6f 77 2e 20 20 53 65 6c 65 63 74 20 74 68 65 20 68 65 6c 70 20 77 69 6e 64 6f 77 2c 20 61 6e dow...Select.the.help.window,.an
1d4a0 64 20 6d 61 6b 65 20 74 68 65 20 68 65 6c 70 20 62 75 66 66 65 72 20 63 75 72 72 65 6e 74 0a 20 d.make.the.help.buffer.current..
1d4c0 20 20 20 20 61 6e 64 20 72 65 74 75 72 6e 20 69 74 2e 0a 0a 46 75 6e 63 74 69 6f 6e 3a 20 74 72 ....and.return.it...Function:.tr
1d4e0 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 72 79 20 6f 62 6a 20 26 6f 70 74 69 6f 6e ansient-show-summary.obj.&option
1d500 61 6c 20 72 65 74 75 72 6e 0a 20 20 20 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 al.return......This.generic.func
1d520 74 69 6f 6e 20 73 68 6f 77 73 20 6f 72 2c 20 69 66 20 6f 70 74 69 6f 6e 61 6c 20 52 45 54 55 52 tion.shows.or,.if.optional.RETUR
1d540 4e 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 0a 20 20 20 20 20 72 65 74 75 72 6e 73 N.is.non-...nil...,......returns
1d560 20 61 20 62 72 69 65 66 20 73 75 6d 6d 61 72 79 20 61 62 6f 75 74 20 74 68 65 20 63 6f 6d 6d 61 .a.brief.summary.about.the.comma
1d580 6e 64 20 61 74 20 70 6f 69 6e 74 20 6f 72 20 68 6f 76 65 72 65 64 20 77 69 74 68 0a 20 20 20 20 nd.at.point.or.hovered.with.....
1d5a0 20 74 68 65 20 6d 6f 75 73 65 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 .the.mouse........This.function.
1d5c0 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 20 6d 6f 75 73 65 20 69 73 20 6d 6f 76 65 is.called.when.the.mouse.is.move
1d5e0 64 20 6f 76 65 72 20 61 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 20 20 20 20 20 28 69 66 20 74 68 d.over.a.command.and......(if.th
1d600 65 20 76 61 6c 75 65 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 e.value.of....transient-enable-p
1d620 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e e2 80 99 20 69 73 20 e2 80 98 76 65 72 62 6f 73 65 opup-navigation....is....verbose
1d640 e2 80 99 29 0a 20 20 20 20 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 6e 61 76 69 67 61 74 65 ...)......when.the.user.navigate
1d660 73 20 74 6f 20 61 20 63 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 20 74 68 65 20 6b 65 79 62 6f 61 72 s.to.a.command.using.the.keyboar
1d680 64 2e 0a 0a 20 20 20 20 20 49 66 20 4f 42 4a e2 80 99 73 20 e2 80 98 73 75 6d 6d 61 72 79 e2 80 d........If.OBJ...s....summary..
1d6a0 99 20 73 6c 6f 74 20 69 73 20 61 20 73 74 72 69 6e 67 2c 20 74 68 61 74 20 69 73 20 75 73 65 64 ..slot.is.a.string,.that.is.used
1d6c0 2e 20 20 49 66 20 e2 80 98 73 75 6d 6d 61 72 79 e2 80 99 20 69 73 0a 20 20 20 20 20 61 20 66 75 ...If....summary....is......a.fu
1d6e0 6e 63 74 69 6f 6e 2c 20 74 68 61 74 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 4f 42 4a 20 nction,.that.is.called.with.OBJ.
1d700 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 74 68 65 0a 20 20 20 as.the.only.argument.and.the....
1d720 20 20 72 65 74 75 72 6e 65 64 20 73 74 72 69 6e 67 20 69 73 20 75 73 65 64 2e 20 20 49 66 20 e2 ..returned.string.is.used...If..
1d740 80 98 73 75 6d 6d 61 72 79 e2 80 99 20 69 73 20 6f 72 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 ..summary....is.or.returns.somet
1d760 68 69 6e 67 0a 20 20 20 20 20 6f 74 68 65 72 20 74 68 61 6e 20 61 20 73 74 72 69 6e 67 20 6f 72 hing......other.than.a.string.or
1d780 20 e2 80 98 6e 69 6c e2 80 99 2c 20 6e 6f 20 73 75 6d 6d 61 72 79 20 69 73 20 73 68 6f 77 6e 2e ....nil...,.no.summary.is.shown.
1d7a0 20 20 49 66 20 e2 80 98 73 75 6d 6d 61 72 79 e2 80 99 20 69 73 0a 20 20 20 20 20 6f 72 20 72 65 ..If....summary....is......or.re
1d7c0 74 75 72 6e 73 20 e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 20 turns....nil...,.the.first.line.
1d7e0 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 69 73 0a 20 of.the.documentation.string.is..
1d800 20 20 20 20 75 73 65 64 2c 20 69 66 20 61 6e 79 2e 0a 0a 20 20 20 20 20 49 66 20 52 45 54 55 52 ....used,.if.any........If.RETUR
1d820 4e 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f N.is.non-...nil...,.this.functio
1d840 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 75 6d 6d 61 72 79 20 69 6e 73 74 65 61 64 0a 20 20 n.returns.the.summary.instead...
1d860 20 20 20 6f 66 20 73 68 6f 77 69 6e 67 20 69 74 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 ...of.showing.it...This.is.used.
1d880 77 68 65 6e 20 61 20 74 6f 6f 6c 74 69 70 20 69 73 20 6e 65 65 64 65 64 2e 0a 0a 1f 0a 46 69 6c when.a.tooltip.is.needed.....Fil
1d8a0 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 50 72 65 66 69 78 e:.doci3EOZM.info,..Node:.Prefix
1d8c0 20 53 6c 6f 74 73 2c 20 20 4e 65 78 74 3a 20 53 75 66 66 69 78 20 53 6c 6f 74 73 2c 20 20 50 72 .Slots,..Next:.Suffix.Slots,..Pr
1d8e0 65 76 3a 20 53 75 66 66 69 78 20 4d 65 74 68 6f 64 73 2c 20 20 55 70 3a 20 43 6c 61 73 73 65 73 ev:.Suffix.Methods,..Up:.Classes
1d900 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 0a 35 2e 37 20 50 72 65 66 69 78 20 53 6c 6f 74 73 0a 3d .and.Methods..5.7.Prefix.Slots.=
1d920 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 56 61 6c 75 65 20 61 6e 64 20 53 63 6f 70 65 ===============..Value.and.Scope
1d940 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 64 65 66 61 .---------------............defa
1d960 75 6c 74 2d 76 61 6c 75 65 e2 80 99 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f ult-value....The.default.value.o
1d980 66 20 74 68 65 20 70 72 65 66 69 78 2e 20 20 55 73 65 20 74 68 65 20 6b 65 79 77 6f 72 64 0a 20 f.the.prefix...Use.the.keyword..
1d9a0 20 20 20 20 61 72 67 75 6d 65 6e 74 20 e2 80 98 3a 76 61 6c 75 65 e2 80 99 20 28 73 69 63 29 20 ....argument....:value....(sic).
1d9c0 74 6f 20 73 65 74 20 74 68 69 73 20 73 6c 6f 74 20 69 6e 20 74 68 65 20 64 65 66 69 6e 69 74 69 to.set.this.slot.in.the.definiti
1d9e0 6f 6e 20 6f 66 20 61 0a 20 20 20 20 20 70 72 65 66 69 78 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 on.of.a......prefix.............
1da00 69 6e 69 74 2d 76 61 6c 75 65 e2 80 99 20 41 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 init-value....A.function.that.is
1da20 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 74 74 69 6e 67 20 74 68 65 0a 20 20 20 .responsible.for.setting.the....
1da40 20 20 6f 62 6a 65 63 74 e2 80 99 73 20 76 61 6c 75 65 2e 20 20 49 66 20 62 6f 75 6e 64 2c 20 74 ..object...s.value...If.bound,.t
1da60 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 6f 62 6a 65 hen.this.is.called.with.the.obje
1da80 63 74 20 61 73 0a 20 20 20 20 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 2e 20 20 55 ct.as......the.only.argument...U
1daa0 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73 20 6e 6f 74 20 62 6f 75 6e 64 2c 20 69 6e 20 77 68 69 sually.this.is.not.bound,.in.whi
1dac0 63 68 20 63 61 73 65 20 74 68 65 0a 20 20 20 20 20 6f 62 6a 65 63 74 e2 80 99 73 20 70 72 69 6d ch.case.the......object...s.prim
1dae0 61 72 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 e2 80 99 20 6d ary....transient-init-value....m
1db00 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 73 74 65 61 64 2e 0a 0a 20 20 20 e2 80 a2 ethod.is.called.instead.........
1db20 20 e2 80 98 68 69 73 74 6f 72 79 2d 6b 65 79 e2 80 99 20 49 66 20 6d 75 6c 74 69 70 6c 65 20 70 ....history-key....If.multiple.p
1db40 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 73 68 6f 75 6c 64 20 73 68 61 72 65 20 61 20 73 69 refix.commands.should.share.a.si
1db60 6e 67 6c 65 0a 20 20 20 20 20 76 61 6c 75 65 2c 20 74 68 65 6e 20 74 68 69 73 20 73 6c 6f 74 20 ngle......value,.then.this.slot.
1db80 68 61 73 20 74 6f 20 62 65 20 73 65 74 20 74 6f 20 74 68 65 20 73 61 6d 65 20 76 61 6c 75 65 20 has.to.be.set.to.the.same.value.
1dba0 66 6f 72 20 61 6c 6c 20 6f 66 0a 20 20 20 20 20 74 68 65 6d 2e 20 20 59 6f 75 20 70 72 6f 62 61 for.all.of......them...You.proba
1dbc0 62 6c 79 20 64 6f 6e e2 80 99 74 20 77 61 6e 74 20 74 68 61 74 2e 0a 0a 20 20 20 e2 80 a2 20 e2 bly.don...t.want.that...........
1dbe0 80 98 72 65 6d 65 6d 62 65 72 2d 76 61 6c 75 65 e2 80 99 20 57 68 65 6e 20 61 20 73 75 66 66 69 ..remember-value....When.a.suffi
1dc00 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 77 68 69 63 68 20 63 61 6e 0a x.command.is.invoked,.which.can.
1dc20 20 20 20 20 20 63 6f 6e 73 75 6d 65 20 74 68 65 20 70 72 65 66 69 78 e2 80 99 73 20 76 61 6c 75 .....consume.the.prefix...s.valu
1dc40 65 20 28 77 68 69 63 68 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 73 75 66 66 69 78 20 73 e.(which.depends.on.the.suffix.s
1dc60 6c 6f 74 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 61 6e 64 20 74 68 65 lot.........transient....and.the
1dc80 20 70 72 65 66 69 78 20 73 6c 6f 74 73 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 .prefix.slots....transient-suffi
1dca0 78 e2 80 99 20 61 6e 64 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 x....and.........transient-non-s
1dcc0 75 66 66 69 78 e2 80 99 29 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 61 75 74 uffix...),.then.the.value.is.aut
1dce0 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 73 68 65 64 20 74 6f 0a 20 20 20 20 20 74 68 65 20 70 72 omatically.pushed.to......the.pr
1dd00 65 66 69 78 e2 80 99 73 20 76 61 6c 75 65 20 68 69 73 74 6f 72 79 2e 0a 0a 20 20 20 20 20 54 68 efix...s.value.history........Th
1dd20 69 73 20 73 6c 6f 74 20 61 6c 6c 6f 77 73 20 61 64 64 69 74 69 6f 6e 61 6c 6c 79 20 73 65 74 74 is.slot.allows.additionally.sett
1dd40 69 6e 67 20 6f 72 20 65 76 65 6e 20 73 61 76 69 6e 67 20 74 68 65 20 76 61 6c 75 65 2c 20 73 6f ing.or.even.saving.the.value,.so
1dd60 0a 20 20 20 20 20 74 68 61 74 20 69 74 20 62 65 63 6f 6d 65 73 20 74 68 65 20 69 6e 69 74 69 61 ......that.it.becomes.the.initia
1dd80 6c 20 76 61 6c 75 65 20 77 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 69 73 20 69 6e 76 6f 6b 65 64 l.value.when.the.menu.is.invoked
1dda0 20 61 67 61 69 6e 2e 0a 0a 20 20 20 20 20 42 65 73 69 64 65 20 e2 80 98 6e 69 6c e2 80 99 2c 20 .again........Beside....nil...,.
1ddc0 74 68 65 20 76 61 6c 75 65 20 63 61 6e 20 62 65 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 73 79 the.value.can.be.one.of.these.sy
1dde0 6d 62 6f 6c 73 3a 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 65 78 70 6f 72 74 e2 80 99 mbols:.................export...
1de00 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 77 68 65 6e 20 69 74 20 69 73 20 65 78 70 6f 72 74 .Set.the.value.when.it.is.export
1de20 65 64 2e 20 20 54 68 61 74 20 69 73 20 74 68 65 20 74 69 6d 65 0a 20 20 20 20 20 20 20 20 20 20 ed...That.is.the.time...........
1de40 77 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 77 6f 75 6c 64 20 6f 72 64 69 6e 61 72 69 6c 79 20 when.the.value.would.ordinarily.
1de60 6a 75 73 74 20 62 65 20 70 75 73 68 65 64 20 74 6f 20 74 68 65 20 68 69 73 74 6f 72 79 0a 20 20 just.be.pushed.to.the.history...
1de80 20 20 20 20 20 20 20 20 73 74 61 63 6b 2e 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 65 ........stack..................e
1dea0 78 69 74 e2 80 99 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 77 68 65 6e 20 74 68 65 20 6d 65 xit....Set.the.value.when.the.me
1dec0 6e 75 20 69 73 20 65 78 69 74 65 64 2c 20 65 78 63 65 70 74 20 77 68 65 6e 20 74 68 61 74 0a 20 nu.is.exited,.except.when.that..
1dee0 20 20 20 20 20 20 20 20 20 69 73 20 64 6f 6e 65 20 75 73 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 .........is.done.using.a.command
1df00 20 77 68 6f 73 65 20 73 6f 6c 65 20 70 75 72 70 6f 73 65 20 69 73 20 74 6f 20 71 75 69 74 20 74 .whose.sole.purpose.is.to.quit.t
1df20 68 65 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6e 75 2e 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 he...........menu...............
1df40 e2 80 98 71 75 69 74 e2 80 99 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 77 68 65 6e 20 74 68 ...quit....Set.the.value.when.th
1df60 65 20 6d 65 6e 75 20 69 73 20 71 75 69 74 2c 20 75 73 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 0a e.menu.is.quit,.using.a.command.
1df80 20 20 20 20 20 20 20 20 20 20 77 68 6f 73 65 20 73 6f 6c 65 20 70 75 72 70 6f 73 65 20 69 73 20 ..........whose.sole.purpose.is.
1dfa0 74 6f 20 64 6f 20 73 6f 2e 0a 0a 20 20 20 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 61 6c to.do.so........The.value.can.al
1dfc0 73 6f 20 62 65 20 61 20 6c 69 73 74 20 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 so.be.a.list.of.one.or.more.of.t
1dfe0 68 65 73 65 20 73 79 6d 62 6f 6c 73 20 61 6e 64 0a 20 20 20 20 20 6f 70 74 69 6f 6e 61 6c 6c 79 hese.symbols.and......optionally
1e000 20 61 6c 73 6f 20 74 68 65 20 73 79 6d 62 6f 6c 20 e2 80 98 73 61 76 65 e2 80 99 2e 0a 0a 20 20 .also.the.symbol....save........
1e020 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 73 61 76 65 e2 80 99 20 49 6e 73 74 65 61 64 20 6f 66 20 .............save....Instead.of.
1e040 6d 65 72 65 6c 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 76 61 6c 75 65 2c 20 73 61 76 65 20 69 merely.setting.the.value,.save.i
1e060 74 2c 20 73 6f 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 20 20 69 74 20 77 69 6c 6c 20 62 65 20 t,.so.that...........it.will.be.
1e080 75 73 65 64 20 69 6e 20 66 75 74 75 72 65 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 2e 20 20 used.in.future.Emacs.sessions...
1e0a0 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 6f 74 68 65 72 0a 20 20 20 20 20 20 20 20 20 20 73 79 6d At.least.one.other...........sym
1e0c0 62 6f 6c 20 68 61 73 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 67 65 74 68 65 72 20 77 69 74 68 bol.has.to.be.used.together.with
1e0e0 20 74 68 69 73 2e 0a 0a 20 20 20 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 61 6c 73 6f 20 .this........The.value.can.also.
1e100 62 65 20 61 20 28 71 75 6f 74 65 64 29 20 76 61 72 69 61 62 6c 65 2c 20 77 68 6f 73 65 20 76 61 be.a.(quoted).variable,.whose.va
1e120 6c 75 65 20 69 73 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 73 79 6d 62 6f 6c 73 20 61 73 lue.is.a.list.of......symbols.as
1e140 20 64 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 2e 20 20 49 64 65 61 6c 6c 79 20 61 6e 20 6f 70 .described.above...Ideally.an.op
1e160 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2c 0a 20 20 20 20 20 73 69 6e 63 65 20 tion.should.be.used,......since.
1e180 6e 6f 74 20 61 6c 6c 20 75 73 65 72 73 20 77 69 6c 6c 20 66 69 6e 64 20 74 68 65 20 61 75 74 6f not.all.users.will.find.the.auto
1e1a0 6d 61 74 69 63 20 73 61 76 69 6e 67 20 6f 66 20 74 68 65 20 76 61 6c 75 65 0a 20 20 20 20 20 64 matic.saving.of.the.value......d
1e1c0 65 73 69 72 61 62 6c 65 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 69 6e 63 6f 6d 70 61 74 69 62 6c esirable.............incompatibl
1e1e0 65 e2 80 99 20 41 20 6c 69 73 74 20 6f 66 20 6c 69 73 74 73 2e 20 20 45 61 63 68 20 73 75 62 2d e....A.list.of.lists...Each.sub-
1e200 6c 69 73 74 20 73 70 65 63 69 66 69 65 73 20 61 20 73 65 74 20 6f 66 0a 20 20 20 20 20 6d 75 74 list.specifies.a.set.of......mut
1e220 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 76 65 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 45 6e 61 62 ually.exclusive.arguments...Enab
1e240 6c 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 0a 20 20 20 20 ling.one.of.these.arguments.....
1e260 20 63 61 75 73 65 73 20 74 68 65 20 6f 74 68 65 72 73 20 74 6f 20 62 65 20 64 69 73 61 62 6c 65 .causes.the.others.to.be.disable
1e280 64 2e 20 20 41 6e 20 61 72 67 75 6d 65 6e 74 20 6d 61 79 20 61 70 70 65 61 72 20 69 6e 0a 20 20 d...An.argument.may.appear.in...
1e2a0 20 20 20 6d 75 6c 74 69 70 6c 65 20 73 75 62 2d 6c 69 73 74 73 2e 20 20 41 72 67 75 6d 65 6e 74 ...multiple.sub-lists...Argument
1e2c0 73 20 6d 75 73 74 20 6d 65 20 67 69 76 65 6e 20 69 6e 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d s.must.me.given.in.the.same.form
1e2e0 20 61 73 0a 20 20 20 20 20 75 73 65 64 20 69 6e 20 74 68 65 20 e2 80 98 61 72 67 75 6d 65 6e 74 .as......used.in.the....argument
1e300 e2 80 99 20 6f 72 20 e2 80 98 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 e2 80 99 20 73 6c 6f ....or....argument-format....slo
1e320 74 20 6f 66 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 0a 20 20 20 20 20 73 75 66 66 69 78 20 t.of.the.respective......suffix.
1e340 6f 62 6a 65 63 74 73 2c 20 75 73 75 61 6c 6c 79 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 objects,.usually.something.like.
1e360 e2 80 98 2d 2d 73 77 69 74 63 68 e2 80 99 20 6f 72 20 e2 80 98 2d 2d 6f 70 74 69 6f 6e 3d 25 73 ...--switch....or....--option=%s
1e380 e2 80 99 2e 0a 20 20 20 20 20 46 6f 72 20 6f 70 74 69 6f 6e 73 20 61 6e 64 20 e2 80 98 74 72 61 ..........For.options.and....tra
1e3a0 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 e2 80 99 20 73 75 66 66 69 78 65 73 20 69 74 20 69 nsient-switches....suffixes.it.i
1e3c0 73 20 61 6c 73 6f 20 70 6f 73 73 69 62 6c 65 0a 20 20 20 20 20 74 6f 20 6d 61 74 63 68 20 61 67 s.also.possible......to.match.ag
1e3e0 61 69 6e 73 74 20 61 20 73 70 65 63 69 66 69 63 20 76 61 6c 75 65 2c 20 61 73 20 72 65 74 75 72 ainst.a.specific.value,.as.retur
1e400 6e 65 64 20 62 79 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 ned.by.........transient-infix-v
1e420 61 6c 75 65 e2 80 99 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 e2 80 98 2d 2d 6f 70 74 69 6f alue...,.for.example,....--optio
1e440 6e 3d 6f 6e 65 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 73 63 6f 70 65 e2 80 99 20 46 6f n=one................scope....Fo
1e460 72 20 73 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 20 69 74 20 6d 69 67 68 74 20 62 65 20 6e 65 r.some.transients.it.might.be.ne
1e480 63 65 73 73 61 72 79 20 74 6f 20 68 61 76 65 20 61 20 73 6f 72 74 20 6f 66 0a 20 20 20 20 20 73 cessary.to.have.a.sort.of......s
1e4a0 65 63 6f 6e 64 61 72 79 20 76 61 6c 75 65 2c 20 63 61 6c 6c 65 64 20 61 20 e2 80 9c 73 63 6f 70 econdary.value,.called.a....scop
1e4c0 65 e2 80 9d 2e 20 20 53 65 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 e......See....transient-define-p
1e4e0 72 65 66 69 78 e2 80 99 2e 0a 0a 42 65 68 61 76 69 6f 72 0a 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 20 refix......Behavior.--------....
1e500 20 e2 80 a2 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 2c 20 e2 80 98 ........transient-suffix...,....
1e520 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 e2 80 99 20 61 6e 64 0a 20 20 20 20 transient-non-suffix....and.....
1e540 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 e2 80 99 20 70 6c ....transient-switch-frame....pl
1e560 61 79 20 61 20 70 61 72 74 20 77 68 65 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 65 74 68 ay.a.part.when.determining.wheth
1e580 65 72 20 74 68 65 0a 20 20 20 20 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 20 74 72 61 er.the......currently.active.tra
1e5a0 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 72 65 6d 61 69 6e 73 20 61 63 nsient.prefix.command.remains.ac
1e5c0 74 69 76 65 2f 74 72 61 6e 73 69 65 6e 74 0a 20 20 20 20 20 77 68 65 6e 20 61 20 73 75 66 66 69 tive/transient......when.a.suffi
1e5e0 78 20 6f 72 20 61 72 62 69 74 72 61 72 79 20 6e 6f 6e 2d 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e x.or.arbitrary.non-suffix.comman
1e600 64 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 53 65 65 0a 20 20 20 20 20 2a 6e 6f 74 65 20 54 72 d.is.invoked...See......*note.Tr
1e620 61 6e 73 69 65 6e 74 20 53 74 61 74 65 3a 3a 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 72 65 66 72 ansient.State::.............refr
1e640 65 73 68 2d 73 75 66 66 69 78 65 73 e2 80 99 20 4e 6f 72 6d 61 6c 6c 79 20 73 75 66 66 69 78 20 esh-suffixes....Normally.suffix.
1e660 6f 62 6a 65 63 74 73 20 61 6e 64 20 6b 65 79 6d 61 70 73 20 61 72 65 20 6f 6e 6c 79 0a 20 20 20 objects.and.keymaps.are.only....
1e680 20 20 73 65 74 75 70 20 6f 6e 63 65 2c 20 77 68 65 6e 20 74 68 65 20 70 72 65 66 69 78 20 69 73 ..setup.once,.when.the.prefix.is
1e6a0 20 69 6e 76 6f 6b 65 64 2e 20 20 53 65 74 74 69 6e 67 20 74 68 69 73 20 74 6f 20 e2 80 98 74 e2 .invoked...Setting.this.to....t.
1e6c0 80 99 2c 0a 20 20 20 20 20 63 61 75 73 65 73 20 74 68 65 6d 20 74 6f 20 62 65 20 72 65 63 72 65 ..,......causes.them.to.be.recre
1e6e0 61 74 65 64 20 61 66 74 65 72 20 65 76 65 72 79 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 69 73 20 ated.after.every.command...This.
1e700 69 73 20 75 73 65 66 75 6c 0a 20 20 20 20 20 77 68 65 6e 20 75 73 69 6e 67 20 e2 80 98 3a 69 66 is.useful......when.using....:if
1e720 2e 2e 2e e2 80 99 20 70 72 65 64 69 63 61 74 65 73 2c 20 61 6e 64 20 74 68 6f 73 65 20 6e 65 65 .......predicates,.and.those.nee
1e740 64 20 74 6f 20 62 65 20 72 65 72 75 6e 20 66 6f 72 20 73 6f 6d 65 0a 20 20 20 20 20 72 65 61 73 d.to.be.rerun.for.some......reas
1e760 6f 6e 2e 20 20 44 6f 69 6e 67 20 74 68 69 73 20 69 73 20 73 6f 6d 65 77 68 61 74 20 63 6f 73 74 on...Doing.this.is.somewhat.cost
1e780 6c 79 2c 20 61 6e 64 20 74 68 65 72 65 20 69 73 20 61 20 72 69 73 6b 20 6f 66 0a 20 20 20 20 20 ly,.and.there.is.a.risk.of......
1e7a0 6c 6f 73 69 6e 67 20 73 74 61 74 65 2c 20 73 6f 20 74 68 69 73 20 69 73 20 64 69 73 61 62 6c 65 losing.state,.so.this.is.disable
1e7c0 64 20 62 79 20 64 65 66 61 75 6c 74 20 61 6e 64 20 73 74 69 6c 6c 20 63 6f 6e 73 69 64 65 72 65 d.by.default.and.still.considere
1e7e0 64 0a 20 20 20 20 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 d......experimental.............
1e800 65 6e 76 69 72 6f 6e 6d 65 6e 74 e2 80 99 20 41 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 environment....A.function.used.t
1e820 6f 20 65 73 74 61 62 6c 69 73 68 20 61 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 77 68 69 6c 65 o.establish.an.environment.while
1e840 0a 20 20 20 20 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 2c 20 72 65 66 72 65 73 68 69 6e 67 20 6f ......initializing,.refreshing.o
1e860 72 20 72 65 64 69 73 70 6c 61 79 69 6e 67 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 r.redisplaying.a.transient.prefi
1e880 78 20 6d 65 6e 75 2e 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 74 6f 20 65 x.menu.......This.is.useful.to.e
1e8a0 73 74 61 62 6c 69 73 68 20 61 20 63 61 63 68 65 2c 20 69 6e 20 63 61 73 65 20 6d 75 6c 74 69 70 stablish.a.cache,.in.case.multip
1e8c0 6c 65 20 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 72 65 71 75 69 72 65 20 74 68 65 20 73 61 6d le.suffixes......require.the.sam
1e8e0 65 20 65 78 70 65 6e 73 69 76 65 20 77 6f 72 6b 2e 20 20 54 68 65 20 70 72 6f 76 69 64 65 64 20 e.expensive.work...The.provided.
1e900 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 0a 20 20 20 20 20 77 69 74 68 20 61 74 20 function.is.called......with.at.
1e920 6c 65 61 73 74 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 2c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e least.one.argument,.the.function
1e940 20 66 6f 72 20 77 68 69 63 68 20 69 74 20 65 73 74 61 62 6c 69 73 68 65 73 0a 20 20 20 20 20 74 .for.which.it.establishes......t
1e960 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 49 74 20 6d 75 73 74 20 e2 80 98 66 75 6e 63 he.environment...It.must....func
1e980 61 6c 6c e2 80 99 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 6e 6f 0a 20 20 20 all....that.function.with.no....
1e9a0 20 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 44 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 ..arguments...During.initializat
1e9c0 69 6f 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 70 ion.the.second.argument.is.the.p
1e9e0 72 65 66 69 78 0a 20 20 20 20 20 6f 62 6a 65 63 74 20 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 refix......object.being.initiali
1ea00 7a 65 64 2e 20 20 54 68 69 73 20 73 6c 6f 74 20 69 73 20 73 74 69 6c 6c 20 65 78 70 65 72 69 6d zed...This.slot.is.still.experim
1ea20 65 6e 74 61 6c 2e 0a 0a 41 70 70 65 61 72 61 6e 63 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 ental...Appearance.----------...
1ea40 20 20 e2 80 a2 20 e2 80 98 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e e2 80 99 20 64 65 74 65 72 .........display-action....deter
1ea60 6d 69 6e 65 73 20 68 6f 77 20 74 68 69 73 20 70 72 65 66 69 78 20 69 73 20 64 69 73 70 6c 61 79 mines.how.this.prefix.is.display
1ea80 65 64 2c 0a 20 20 20 20 20 6f 76 65 72 72 69 64 69 6e 67 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 ed,......overriding....transient
1eaa0 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e e2 80 99 2e 20 20 49 74 20 73 -display-buffer-action......It.s
1eac0 68 6f 75 6c 64 20 68 61 76 65 20 74 68 65 0a 20 20 20 20 20 73 61 6d 65 20 74 79 70 65 2e 0a 0a hould.have.the......same.type...
1eae0 20 20 20 e2 80 a2 20 e2 80 98 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 e2 80 99 20 69 73 ..........mode-line-format....is
1eb00 20 74 68 69 73 20 70 72 65 66 69 78 e2 80 99 73 20 6d 6f 64 65 20 6c 69 6e 65 20 66 6f 72 6d 61 .this.prefix...s.mode.line.forma
1eb20 74 2c 20 6f 76 65 72 72 69 64 69 6e 67 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d t,.overriding.........transient-
1eb40 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 e2 80 99 2e 20 20 49 74 20 73 68 6f 75 6c 64 20 mode-line-format......It.should.
1eb60 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 74 79 70 65 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 63 have.the.same.type.............c
1eb80 6f 6c 75 6d 6e 2d 77 69 64 74 68 73 e2 80 99 20 69 73 20 6f 6e 6c 79 20 72 65 73 70 65 63 74 65 olumn-widths....is.only.respecte
1eba0 64 20 69 6e 73 69 64 65 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 e2 80 99 d.inside....transient-columns...
1ebc0 20 67 72 6f 75 70 73 0a 20 20 20 20 20 61 6e 64 20 61 6c 6c 6f 77 73 20 61 6c 69 67 6e 69 6e 67 .groups......and.allows.aligning
1ebe0 20 63 6f 6c 75 6d 6e 73 20 61 63 72 6f 73 73 20 73 65 70 61 72 61 74 65 20 69 6e 73 74 61 6e 63 .columns.across.separate.instanc
1ec00 65 73 20 6f 66 20 74 68 61 74 2e 20 20 41 0a 20 20 20 20 20 6c 69 73 74 20 6f 66 20 69 6e 74 65 es.of.that...A......list.of.inte
1ec20 67 65 72 73 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 e2 gers.............variable-pitch.
1ec40 80 99 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 61 6c 69 67 6e 6d 65 6e 74 20 69 73 ...controls.whether.alignment.is
1ec60 20 64 6f 6e 65 20 70 69 78 65 6c 2d 77 69 73 65 20 74 6f 0a 20 20 20 20 20 61 63 63 6f 75 6e 74 .done.pixel-wise.to......account
1ec80 20 66 6f 72 20 75 73 65 20 6f 66 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 63 68 61 72 61 .for.use.of.variable-pitch.chara
1eca0 63 74 65 72 73 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 66 75 6c 2c 0a 20 20 20 20 20 65 2e 67 cters,.which.is.useful,......e.g
1ecc0 2e 2c 20 77 68 65 6e 20 75 73 69 6e 67 20 65 6d 6f 6a 69 2e 0a 0a 44 6f 63 75 6d 65 6e 74 61 74 .,.when.using.emoji...Documentat
1ece0 69 6f 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 73 68 6f ion.-------------............sho
1ed00 77 2d 68 65 6c 70 e2 80 99 2c 20 e2 80 98 6d 61 6e 2d 70 61 67 65 e2 80 99 20 6f 72 20 e2 80 98 w-help...,....man-page....or....
1ed20 69 6e 66 6f 2d 6d 61 6e 75 61 6c e2 80 99 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 70 info-manual....can.be.used.to.sp
1ed40 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 ecify.the......documentation.for
1ed60 20 74 68 65 20 70 72 65 66 69 78 20 61 6e 64 20 69 74 73 20 73 75 66 66 69 78 65 73 2e 20 20 54 .the.prefix.and.its.suffixes...T
1ed80 68 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c he.command.........transient-hel
1eda0 70 e2 80 99 20 75 73 65 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 p....uses.the.function....transi
1edc0 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 e2 80 99 20 28 77 68 69 63 68 0a 20 20 20 20 20 73 65 65 ent-show-help....(which......see
1ede0 29 20 74 6f 20 6c 6f 6f 6b 75 70 20 61 6e 64 20 75 73 65 20 74 68 65 73 65 20 76 61 6c 75 65 73 ).to.lookup.and.use.these.values
1ee00 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 73 75 66 66 69 78 2d 64 65 73 63 72 69 70 74 69 6f 6e e2 .............suffix-description.
1ee20 80 99 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 61 20 66 75 6e 63 ...can.be.used.to.specify.a.func
1ee40 74 69 6f 6e 20 77 68 69 63 68 0a 20 20 20 20 20 70 72 6f 76 69 64 65 73 20 66 61 6c 6c 62 61 63 tion.which......provides.fallbac
1ee60 6b 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 k.descriptions.for.suffixes.that
1ee80 20 6c 61 63 6b 20 61 0a 20 20 20 20 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 20 20 54 68 69 73 20 .lack.a......description...This.
1eea0 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 75 73 is.intended.to.be.temporarily.us
1eec0 65 64 20 77 68 65 6e 0a 20 20 20 20 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 6f 66 20 61 20 6e ed.when......implementing.of.a.n
1eee0 65 77 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 74 20 77 68 69 63 68 20 74 69 6d 65 ew.prefix.command,.at.which.time
1ef00 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 2d 73 75 6d 6d 61 .........transient-command-summa
1ef20 72 79 2d 6f 72 2d 6e 61 6d 65 e2 80 99 20 69 73 20 61 20 75 73 65 66 75 6c 20 76 61 6c 75 65 2e ry-or-name....is.a.useful.value.
1ef40 0a 0a 49 6e 74 65 72 6e 61 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 73 65 20 73 6c 6f 74 73 ..Internal.--------..These.slots
1ef60 20 61 72 65 20 6d 6f 73 74 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 .are.mostly.intended.for.interna
1ef80 6c 20 75 73 65 2e 20 20 54 68 65 79 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 0a 73 65 74 20 69 l.use...They.should.not.be.set.i
1efa0 6e 20 63 61 6c 6c 73 20 74 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 n.calls.to....transient-define-p
1efc0 72 65 66 69 78 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 70 72 6f 74 6f 74 79 70 65 e2 80 refix................prototype..
1efe0 99 20 57 68 65 6e 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e ..When.a.transient.prefix.comman
1f000 64 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 65 6e 20 61 0a 20 20 20 20 20 63 6c 6f 6e 65 20 d.is.invoked,.then.a......clone.
1f020 6f 66 20 74 68 61 74 20 6f 62 6a 65 63 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 of.that.object.is.stored.in.the.
1f040 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e global.variable.........transien
1f060 74 2d 2d 70 72 65 66 69 78 e2 80 99 20 61 6e 64 20 74 68 65 20 70 72 6f 74 6f 74 79 70 65 20 69 t--prefix....and.the.prototype.i
1f080 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 6e 65 e2 80 99 73 0a 20 20 20 20 20 e2 s.stored.in.the.clone...s.......
1f0a0 80 98 70 72 6f 74 6f 74 79 70 65 e2 80 99 20 73 6c 6f 74 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 ..prototype....slot.............
1f0c0 63 6f 6d 6d 61 6e 64 e2 80 99 20 54 68 65 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c command....The.command,.a.symbol
1f0e0 2e 20 20 45 61 63 68 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 ...Each.transient.prefix.command
1f100 0a 20 20 20 20 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 ......consists.of.a.command,.whi
1f120 63 68 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73 79 6d 62 6f 6c e2 80 99 73 20 66 75 6e ch.is.stored.in.a.symbol...s.fun
1f140 63 74 69 6f 6e 20 73 6c 6f 74 0a 20 20 20 20 20 61 6e 64 20 61 6e 20 6f 62 6a 65 63 74 2c 20 77 ction.slot......and.an.object,.w
1f160 68 69 63 68 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 e2 80 98 74 72 61 6e 73 69 65 hich.is.stored.in.the....transie
1f180 6e 74 2d 2d 70 72 65 66 69 78 e2 80 99 20 70 72 6f 70 65 72 74 79 0a 20 20 20 20 20 6f 66 20 74 nt--prefix....property......of.t
1f1a0 68 65 20 73 61 6d 65 20 73 79 6d 62 6f 6c 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 6c 65 76 65 6c he.same.symbol.............level
1f1c0 e2 80 99 20 54 68 65 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6d 6d ....The.level.of.the.prefix.comm
1f1e0 61 6e 64 73 2e 20 20 54 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 20 ands...The.suffix.commands......
1f200 77 68 6f 73 65 20 6c 61 79 65 72 20 69 73 20 65 71 75 61 6c 20 6f 72 20 6c 6f 77 65 72 20 61 72 whose.layer.is.equal.or.lower.ar
1f220 65 20 64 69 73 70 6c 61 79 65 64 2e 20 20 53 65 65 20 2a 6e 6f 74 65 20 45 6e 61 62 6c 69 6e 67 e.displayed...See.*note.Enabling
1f240 0a 20 20 20 20 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 3a 3a 2e 0a ......and.Disabling.Suffixes::..
1f260 0a 20 20 20 e2 80 a2 20 e2 80 98 76 61 6c 75 65 e2 80 99 20 54 68 65 20 6c 69 6b 65 6c 79 20 6f ...........value....The.likely.o
1f280 75 74 64 61 74 65 64 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 2e 20 20 49 6e utdated.value.of.the.prefix...In
1f2a0 73 74 65 61 64 20 6f 66 0a 20 20 20 20 20 61 63 63 65 73 73 69 6e 67 20 74 68 69 73 20 73 6c 6f stead.of......accessing.this.slo
1f2c0 74 20 64 69 72 65 63 74 6c 79 20 79 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 20 74 68 65 20 66 75 t.directly.you.should.use.the.fu
1f2e0 6e 63 74 69 6f 6e 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c nction.........transient-get-val
1f300 75 65 e2 80 99 2c 20 77 68 69 63 68 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20 72 65 ue...,.which.is.guaranteed.to.re
1f320 74 75 72 6e 20 74 68 65 20 75 70 2d 74 6f 2d 64 61 74 65 0a 20 20 20 20 20 76 61 6c 75 65 2e 0a turn.the.up-to-date......value..
1f340 0a 20 20 20 e2 80 a2 20 e2 80 98 68 69 73 74 6f 72 79 e2 80 99 20 61 6e 64 20 e2 80 98 68 69 73 ...........history....and....his
1f360 74 6f 72 79 2d 70 6f 73 e2 80 99 20 61 72 65 20 75 73 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 tory-pos....are.used.to.keep.tra
1f380 63 6b 20 6f 66 20 68 69 73 74 6f 72 69 63 0a 20 20 20 20 20 76 61 6c 75 65 73 2e 20 20 55 6e 6c ck.of.historic......values...Unl
1f3a0 65 73 73 20 79 6f 75 20 69 6d 70 6c 65 6d 65 6e 74 20 79 6f 75 72 20 6f 77 6e 20 e2 80 98 74 72 ess.you.implement.your.own....tr
1f3c0 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 e2 80 99 0a 20 20 20 20 20 6d 65 74 68 6f ansient-infix-read.........metho
1f3e0 64 20 79 6f 75 20 73 68 6f 75 6c 64 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 64 65 61 6c 20 77 69 d.you.should.not.have.to.deal.wi
1f400 74 68 20 74 68 65 73 65 20 73 6c 6f 74 73 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 75 6e 77 69 6e th.these.slots.............unwin
1f420 64 2d 73 75 66 66 69 78 e2 80 99 20 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 d-suffix....is.used.internally.t
1f440 6f 20 65 6e 73 75 72 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 69 73 0a 20 20 20 20 o.ensure.transient.state.is.....
1f460 20 70 72 6f 70 65 72 6c 79 20 65 78 69 74 65 64 2c 20 65 76 65 6e 20 69 6e 20 63 61 73 65 20 6f .properly.exited,.even.in.case.o
1f480 66 20 61 6e 20 65 72 72 6f 72 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 f.an.error.....File:.doci3EOZM.i
1f4a0 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 53 75 66 66 69 78 20 53 6c 6f 74 73 2c 20 20 4e 65 78 74 3a nfo,..Node:.Suffix.Slots,..Next:
1f4c0 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 2c 20 20 50 72 65 76 3a 20 50 72 65 66 69 78 20 .Predicate.Slots,..Prev:.Prefix.
1f4e0 53 6c 6f 74 73 2c 20 20 55 70 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a Slots,..Up:.Classes.and.Methods.
1f500 0a 35 2e 38 20 53 75 66 66 69 78 20 53 6c 6f 74 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .5.8.Suffix.Slots.==============
1f520 3d 3d 0a 0a 48 65 72 65 20 77 65 20 64 6f 63 75 6d 65 6e 74 20 6d 6f 73 74 20 6f 66 20 74 68 65 ==..Here.we.document.most.of.the
1f540 20 73 6c 6f 74 73 20 74 68 61 74 20 61 72 65 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 66 .slots.that.are.only.available.f
1f560 6f 72 20 73 75 66 66 69 78 0a 6f 62 6a 65 63 74 73 2e 20 20 53 6f 6d 65 20 73 6c 6f 74 73 20 61 or.suffix.objects...Some.slots.a
1f580 72 65 20 73 68 61 72 65 64 20 62 79 20 73 75 66 66 69 78 20 61 6e 64 20 67 72 6f 75 70 20 6f 62 re.shared.by.suffix.and.group.ob
1f5a0 6a 65 63 74 73 2c 20 74 68 65 79 20 61 72 65 0a 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 2a 6e jects,.they.are.documented.in.*n
1f5c0 6f 74 65 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 3a 3a 2e 0a 0a 20 20 20 41 6c 73 6f 20 ote.Predicate.Slots::......Also.
1f5e0 73 65 65 20 2a 6e 6f 74 65 20 53 75 66 66 69 78 20 43 6c 61 73 73 65 73 3a 3a 2e 0a 0a 53 6c 6f see.*note.Suffix.Classes::...Slo
1f600 74 73 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 e2 80 99 0a 2d 2d 2d 2d ts.of....transient-child....----
1f620 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 69 73 20 ----------------------..This.is.
1f640 74 68 65 20 61 62 73 74 72 61 63 74 20 73 75 70 65 72 63 6c 61 73 73 20 6f 66 20 e2 80 98 74 72 the.abstract.superclass.of....tr
1f660 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 e2 80 99 20 61 6e 64 0a e2 80 98 74 72 61 6e 73 69 65 ansient-suffix....and....transie
1f680 6e 74 2d 67 72 6f 75 70 e2 80 99 2e 20 20 54 68 69 73 20 69 73 20 77 68 65 72 65 20 74 68 65 20 nt-group......This.is.where.the.
1f6a0 73 68 61 72 65 64 20 e2 80 98 69 66 2a e2 80 99 20 61 6e 64 20 e2 80 98 69 6e 61 70 74 2d 69 66 shared....if*....and....inapt-if
1f6c0 2a e2 80 99 20 73 6c 6f 74 73 0a 28 73 65 65 20 2a 6e 6f 74 65 20 50 72 65 64 69 63 61 74 65 20 *....slots.(see.*note.Predicate.
1f6e0 53 6c 6f 74 73 3a 3a 29 2c 20 74 68 65 20 e2 80 98 6c 65 76 65 6c e2 80 99 20 73 6c 6f 74 20 28 Slots::),.the....level....slot.(
1f700 73 65 65 20 2a 6e 6f 74 65 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 0a 44 69 73 61 62 6c 69 6e 67 see.*note.Enabling.and.Disabling
1f720 20 53 75 66 66 69 78 65 73 3a 3a 29 2c 20 61 6e 64 20 74 68 65 20 e2 80 98 61 64 76 69 63 65 e2 .Suffixes::),.and.the....advice.
1f740 80 99 20 61 6e 64 20 e2 80 98 61 64 76 69 63 65 2a e2 80 99 20 73 6c 6f 74 73 20 28 73 65 65 20 ...and....advice*....slots.(see.
1f760 2a 6e 6f 74 65 0a 53 6c 6f 74 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 3a *note.Slots.of.transient-suffix:
1f780 3a 29 20 61 72 65 20 64 65 66 69 6e 65 64 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 70 61 72 65 6e :).are.defined.............paren
1f7a0 74 e2 80 99 20 54 68 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 65 20 70 61 72 65 6e 74 20 67 t....The.object.for.the.parent.g
1f7c0 72 6f 75 70 2e 0a 0a 53 6c 6f 74 73 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 roup...Slots.of....transient-suf
1f7e0 66 69 78 e2 80 99 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fix....-------------------------
1f800 2d 2d 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 6b 65 79 e2 80 99 20 69 73 20 74 68 65 20 6b 65 79 20 --............key....is.the.key.
1f820 62 69 6e 64 69 6e 67 2c 20 61 20 73 74 72 69 6e 67 20 69 6e 20 74 68 65 20 66 6f 72 6d 61 74 20 binding,.a.string.in.the.format.
1f840 72 65 74 75 72 6e 65 64 20 62 79 0a 20 20 20 20 20 e2 80 98 64 65 73 63 72 69 62 65 2d 6b 65 79 returned.by.........describe-key
1f860 e2 80 99 20 61 6e 64 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 e2 80 98 6b 62 64 e2 80 99 2e ....and.understood.by....kbd....
1f880 0a 0a 20 20 20 20 20 54 68 61 74 20 66 6f 72 6d 61 74 20 69 73 20 6d 6f 72 65 20 70 65 72 6d 69 .......That.format.is.more.permi
1f8a0 73 73 69 76 65 20 74 68 61 6e 20 74 68 65 20 6f 6e 65 20 61 63 63 65 70 74 65 64 20 62 79 0a 20 ssive.than.the.one.accepted.by..
1f8c0 20 20 20 20 e2 80 98 6b 65 79 2d 76 61 6c 69 64 2d 70 e2 80 99 2e 20 20 42 65 69 6e 67 20 6d 6f .......key-valid-p......Being.mo
1f8e0 72 65 20 70 65 72 6d 69 73 73 69 76 65 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 2c re.permissive.makes.it.possible,
1f900 20 66 6f 72 0a 20 20 20 20 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 77 72 69 74 65 20 74 68 65 20 .for......example,.to.write.the.
1f920 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 77 68 69 63 68 20 74 6f 67 67 6c 65 73 20 74 68 65 20 e2 key.binding,.which.toggles.the..
1f940 80 98 2d 61 e2 80 99 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 6c 69 6e 65 20 61 72 67 75 6d 65 ..-a....command......line.argume
1f960 6e 74 2c 20 61 73 20 22 2d 61 22 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 68 61 76 69 6e 67 20 74 nt,.as."-a",.instead.of.having.t
1f980 6f 20 77 72 69 74 65 20 22 2d 20 61 22 2e 20 20 4c 69 6b 65 77 69 73 65 0a 20 20 20 20 20 61 64 o.write."-.a"...Likewise......ad
1f9a0 64 69 74 69 6f 6e 61 6c 20 73 70 61 63 65 73 20 63 61 6e 20 62 65 20 61 64 64 65 64 2c 20 77 68 ditional.spaces.can.be.added,.wh
1f9c0 69 63 68 20 69 73 20 6e 6f 74 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 0a 20 20 20 20 20 64 69 73 ich.is.not.removed.when......dis
1f9e0 70 6c 61 79 69 6e 67 20 74 68 65 20 62 69 6e 64 69 6e 67 20 69 6e 20 74 68 65 20 6d 65 6e 75 2c playing.the.binding.in.the.menu,
1fa00 20 77 68 69 63 68 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 61 6c 69 67 6e 6d 65 6e 74 0a 20 .which.is.useful.for.alignment..
1fa20 20 20 20 20 70 75 72 70 6f 73 65 73 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 63 6f 6d 6d 61 6e 64 ....purposes.............command
1fa40 e2 80 99 20 54 68 65 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 0a 20 20 20 e2 ....The.command,.a.symbol.......
1fa60 80 a2 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 e2 80 99 20 57 68 65 74 68 65 72 20 74 6f 20 73 74 ......transient....Whether.to.st
1fa80 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 53 65 65 20 2a 6e 6f 74 65 20 54 72 61 6e 73 69 65 ay.transient...See.*note.Transie
1faa0 6e 74 0a 20 20 20 20 20 53 74 61 74 65 3a 3a 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 66 6f 72 6d nt......State::.............form
1fac0 61 74 e2 80 99 20 54 68 65 20 66 6f 72 6d 61 74 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 at....The.format.used.to.display
1fae0 20 74 68 65 20 73 75 66 66 69 78 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a .the.suffix.in.the.menu.buffer..
1fb00 20 20 20 20 20 49 74 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 .....It.must.contain.the.followi
1fb20 6e 67 20 25 2d 70 6c 61 63 65 68 6f 6c 64 65 72 73 3a 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 ng.%-placeholders:..............
1fb40 e2 80 98 25 6b e2 80 99 20 46 6f 72 20 74 68 65 20 6b 65 79 2e 0a 20 20 20 20 20 20 20 20 e2 80 ...%k....For.the.key............
1fb60 a2 20 e2 80 98 25 64 e2 80 99 20 46 6f 72 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 0a .....%d....For.the.description..
1fb80 20 20 20 20 20 20 20 20 e2 80 a2 20 e2 80 98 25 76 e2 80 99 20 46 6f 72 20 74 68 65 20 69 6e 66 ...............%v....For.the.inf
1fba0 69 78 20 76 61 6c 75 65 2e 20 20 4e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 20 64 6f ix.value...Non-infix.suffixes.do
1fbc0 6e e2 80 99 74 20 68 61 76 65 20 61 0a 20 20 20 20 20 20 20 20 20 20 76 61 6c 75 65 2e 0a 0a 20 n...t.have.a...........value....
1fbe0 20 20 e2 80 a2 20 e2 80 98 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 20 54 68 65 20 64 65 73 63 .........description....The.desc
1fc00 72 69 70 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 61 20 73 74 72 69 6e 67 20 6f 72 20 61 20 66 75 ription,.either.a.string.or.a.fu
1fc20 6e 63 74 69 6f 6e 2c 20 77 68 69 63 68 0a 20 20 20 20 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 nction,.which......is.called.wit
1fc40 68 20 7a 65 72 6f 20 6f 72 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 20 28 74 68 65 20 73 75 66 66 h.zero.or.one.argument.(the.suff
1fc60 69 78 20 6f 62 6a 65 63 74 29 2c 20 61 6e 64 0a 20 20 20 20 20 72 65 74 75 72 6e 73 20 61 20 73 ix.object),.and......returns.a.s
1fc80 74 72 69 6e 67 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 66 61 63 65 e2 80 99 20 46 61 63 65 20 75 tring.............face....Face.u
1fca0 73 65 64 20 66 6f 72 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 20 20 49 6e 20 73 69 6d sed.for.the.description...In.sim
1fcc0 70 6c 65 20 63 61 73 65 73 20 69 74 20 69 73 20 65 61 73 69 65 72 0a 20 20 20 20 20 74 6f 20 75 ple.cases.it.is.easier......to.u
1fce0 73 65 20 74 68 69 73 20 69 6e 73 74 65 61 64 20 6f 66 20 75 73 69 6e 67 20 61 20 66 75 6e 63 74 se.this.instead.of.using.a.funct
1fd00 69 6f 6e 20 61 73 20 e2 80 98 64 65 73 63 72 69 70 74 69 6f 6e e2 80 99 20 61 6e 64 20 61 64 64 ion.as....description....and.add
1fd20 69 6e 67 0a 20 20 20 20 20 74 68 65 20 73 74 79 6c 69 6e 67 20 74 68 65 72 65 2e 20 20 e2 80 98 ing......the.styling.there......
1fd40 66 61 63 65 e2 80 99 20 69 73 20 61 70 70 65 6e 64 65 64 20 75 73 69 6e 67 0a 20 20 20 20 20 e2 face....is.appended.using.......
1fd60 80 98 61 64 64 2d 66 61 63 65 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 e2 80 99 2e 0a 0a 20 20 ..add-face-text-property........
1fd80 20 e2 80 a2 20 e2 80 98 73 68 6f 77 2d 68 65 6c 70 e2 80 99 20 41 20 66 75 6e 63 74 69 6f 6e 20 ........show-help....A.function.
1fda0 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 68 65 6c 70 20 66 6f 72 20 74 68 65 20 73 75 66 used.to.display.help.for.the.suf
1fdc0 66 69 78 2e 20 20 49 66 0a 20 20 20 20 20 75 6e 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 20 70 fix...If......unspecified,.the.p
1fde0 72 65 66 69 78 20 63 6f 6e 74 72 6f 6c 73 20 68 6f 77 20 68 65 6c 70 20 69 73 20 64 69 73 70 6c refix.controls.how.help.is.displ
1fe00 61 79 65 64 20 66 6f 72 20 69 74 73 0a 20 20 20 20 20 73 75 66 66 69 78 65 73 2e 20 20 53 65 65 ayed.for.its......suffixes...See
1fe20 20 61 6c 73 6f 20 66 75 6e 63 74 69 6f 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 .also.function....transient-show
1fe40 2d 68 65 6c 70 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 73 75 6d 6d 61 72 79 e2 80 99 20 -help................summary....
1fe60 54 68 65 20 73 75 6d 6d 61 72 79 20 64 69 73 70 6c 61 79 65 64 20 69 6e 20 74 68 65 20 65 63 68 The.summary.displayed.in.the.ech
1fe80 6f 20 61 72 65 61 2c 20 6f 72 20 61 73 20 61 20 74 6f 6f 6c 74 69 70 2e 0a 20 20 20 20 20 49 66 o.area,.or.as.a.tooltip.......If
1fea0 20 74 68 69 73 20 69 73 20 e2 80 98 6e 69 6c e2 80 99 2c 20 77 68 69 63 68 20 69 74 20 75 73 75 .this.is....nil...,.which.it.usu
1fec0 61 6c 6c 79 20 73 68 6f 75 6c 64 20 62 65 2c 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 20 6f ally.should.be,.the.first.line.o
1fee0 66 20 74 68 65 0a 20 20 20 20 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 f.the......documentation.string.
1ff00 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e 20 20 53 65 65 20 e2 80 98 74 72 61 6e 73 69 65 is.used.instead...See....transie
1ff20 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 72 79 e2 80 99 0a 20 20 20 20 20 66 6f 72 20 64 65 74 61 nt-show-summary.........for.deta
1ff40 69 6c 73 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 64 65 66 69 6e 69 74 69 6f 6e e2 80 99 20 41 20 ils.............definition....A.
1ff60 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 64 20 69 66 20 74 68 65 20 62 6f command,.which.is.used.if.the.bo
1ff80 64 79 20 69 73 20 6f 6d 69 74 74 65 64 20 77 68 65 6e 0a 20 20 20 20 20 64 65 66 69 6e 69 6e 67 dy.is.omitted.when......defining
1ffa0 20 61 20 63 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 .a.command.using....transient-de
1ffc0 66 69 6e 65 2d 73 75 66 66 69 78 e2 80 99 2e 0a 0a 20 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e fine-suffix.........The.followin
1ffe0 67 20 74 77 6f 20 73 6c 6f 74 73 20 61 72 65 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 2e 20 20 54 g.two.slots.are.experimental...T
20000 68 65 79 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 65 74 20 66 6f 72 20 61 0a 67 72 6f 75 70 2c hey.can.also.be.set.for.a.group,
20020 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 79 20 61 70 70 6c 79 20 74 6f 20 61 6c 6c .in.which.case.they.apply.to.all
20040 20 73 75 66 66 69 78 65 73 20 69 6e 20 74 68 61 74 20 67 72 6f 75 70 2c 20 65 78 63 65 70 74 0a .suffixes.in.that.group,.except.
20060 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 73 65 74 20 74 68 65 20 73 61 6d 65 20 73 for.suffixes.that.set.the.same.s
20080 6c 6f 74 20 74 6f 20 61 20 6e 6f 6e 2d 6e 69 6c 20 76 61 6c 75 65 2e 0a 0a 20 20 20 e2 80 a2 20 lot.to.a.non-nil.value..........
200a0 e2 80 98 61 64 76 69 63 65 e2 80 99 20 41 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 ...advice....A.function.used.to.
200c0 61 64 76 69 73 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 65 20 61 64 76 69 73 65 20 advise.the.command...The.advise.
200e0 69 73 0a 20 20 20 20 20 63 61 6c 6c 65 64 20 75 73 69 6e 67 20 e2 80 98 28 61 70 70 6c 79 20 61 is......called.using....(apply.a
20100 64 76 69 63 65 20 63 6f 6d 6d 61 6e 64 20 61 72 67 73 29 e2 80 99 2c 20 69 2e 65 2e 2c 20 69 74 dvice.command.args)...,.i.e.,.it
20120 20 62 65 68 61 76 65 73 20 6c 69 6b 65 0a 20 20 20 20 20 61 6e 20 22 61 72 6f 75 6e 64 22 20 61 .behaves.like......an."around".a
20140 64 76 69 63 65 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 61 64 76 69 63 65 2a e2 80 99 20 41 20 66 dvice.............advice*....A.f
20160 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 61 64 76 69 73 65 20 74 68 65 20 63 6f 6d 6d 61 unction.used.to.advise.the.comma
20180 6e 64 2e 20 20 55 6e 6c 69 6b 65 20 e2 80 98 61 64 76 69 63 65 e2 80 99 2c 0a 20 20 20 20 20 74 nd...Unlike....advice...,......t
201a0 68 69 73 20 61 64 76 69 73 65 73 20 6e 6f 74 20 6f 6e 6c 79 20 74 68 65 20 63 6f 6d 6d 61 6e 64 his.advises.not.only.the.command
201c0 20 62 6f 64 79 20 62 75 74 20 61 6c 73 6f 20 69 74 73 20 e2 80 98 69 6e 74 65 72 61 63 74 69 76 .body.but.also.its....interactiv
201e0 65 e2 80 99 0a 20 20 20 20 20 73 70 65 63 2e 20 20 49 66 20 62 6f 74 68 20 73 6c 6f 74 73 20 61 e.........spec...If.both.slots.a
20200 72 65 20 6e 6f 6e 2d 6e 69 6c 2c 20 e2 80 98 61 64 76 69 63 65 e2 80 99 20 69 73 20 75 73 65 64 re.non-nil,....advice....is.used
20220 20 66 6f 72 20 74 68 65 20 62 6f 64 79 20 61 6e 64 0a 20 20 20 20 20 e2 80 98 61 64 76 69 63 65 .for.the.body.and.........advice
20240 2a e2 80 99 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 e2 80 98 69 6e 74 65 72 61 63 74 *....is.used.for.the....interact
20260 69 76 65 e2 80 99 20 66 6f 72 6d 2e 20 20 57 68 65 6e 20 61 64 76 69 73 69 6e 67 20 74 68 65 0a ive....form...When.advising.the.
20280 20 20 20 20 20 e2 80 98 69 6e 74 65 72 61 63 74 69 76 65 e2 80 99 20 73 70 65 63 2c 20 63 61 6c ........interactive....spec,.cal
202a0 6c 65 64 20 75 73 69 6e 67 20 e2 80 98 28 66 75 6e 63 61 6c 6c 20 61 64 76 69 63 65 0a 20 20 20 led.using....(funcall.advice....
202c0 20 20 23 27 61 64 76 69 63 65 2d 65 76 61 6c 2d 69 6e 74 65 72 61 63 74 69 76 65 2d 73 70 65 63 ..#'advice-eval-interactive-spec
202e0 20 73 70 65 63 29 e2 80 99 2e 0a 0a 53 6c 6f 74 73 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e .spec)......Slots.of....transien
20300 74 2d 69 6e 66 69 78 e2 80 99 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d t-infix....---------------------
20320 2d 2d 2d 2d 2d 0a 0a 53 6f 6d 65 20 6f 66 20 74 68 65 73 65 20 73 6c 6f 74 73 20 61 72 65 20 6f -----..Some.of.these.slots.are.o
20340 6e 6c 79 20 6d 65 61 6e 69 6e 67 66 75 6c 20 66 6f 72 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 73 nly.meaningful.for.some.of.the.s
20360 75 62 63 6c 61 73 73 65 73 2e 0a 54 68 65 79 20 61 72 65 20 64 65 66 69 6e 65 64 20 68 65 72 65 ubclasses..They.are.defined.here
20380 20 61 6e 79 77 61 79 20 74 6f 20 61 6c 6c 6f 77 20 73 68 61 72 69 6e 67 20 63 65 72 74 61 69 6e .anyway.to.allow.sharing.certain
203a0 20 6d 65 74 68 6f 64 73 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 61 72 67 75 6d 65 6e 74 e2 80 99 .methods.............argument...
203c0 20 54 68 65 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 2c 20 65 2e 67 2e 2c 20 e2 80 98 2d 2d 76 .The.long.argument,.e.g.,....--v
203e0 65 72 62 6f 73 65 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 73 68 6f 72 74 61 72 67 e2 80 erbose................shortarg..
20400 99 20 54 68 65 20 73 68 6f 72 74 20 61 72 67 75 6d 65 6e 74 2c 20 65 2e 67 2e 2c 20 e2 80 98 2d ..The.short.argument,.e.g.,....-
20420 76 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 76 61 6c 75 65 e2 80 99 20 54 68 65 20 76 61 v................value....The.va
20440 6c 75 65 2e 20 20 53 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 63 63 65 73 73 65 64 20 64 69 72 lue...Should.not.be.accessed.dir
20460 65 63 74 6c 79 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 69 6e 69 74 2d 76 61 6c 75 65 e2 80 99 20 ectly.............init-value....
20480 46 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 Function.that.is.responsible.for
204a0 20 73 65 74 74 69 6e 67 20 74 68 65 20 6f 62 6a 65 63 74 e2 80 99 73 0a 20 20 20 20 20 76 61 6c .setting.the.object...s......val
204c0 75 65 2e 20 20 49 66 20 62 6f 75 6e 64 2c 20 74 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c ue...If.bound,.then.this.is.call
204e0 65 64 20 77 69 74 68 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 20 74 68 65 20 6f 6e 6c 79 0a 20 ed.with.the.object.as.the.only..
20500 20 20 20 20 61 72 67 75 6d 65 6e 74 2e 20 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73 20 6e ....argument...Usually.this.is.n
20520 6f 74 20 62 6f 75 6e 64 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 6f 62 6a 65 ot.bound,.in.which.case.the.obje
20540 63 74 e2 80 99 73 0a 20 20 20 20 20 70 72 69 6d 61 72 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 ct...s......primary....transient
20560 2d 69 6e 69 74 2d 76 61 6c 75 65 e2 80 99 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 -init-value....method.is.called.
20580 69 6e 73 74 65 61 64 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 75 6e 73 61 76 61 62 6c 65 e2 80 99 instead.............unsavable...
205a0 20 57 68 65 74 68 65 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 .Whether.the.value.of.the.suffix
205c0 20 69 73 20 6e 6f 74 20 73 61 76 65 64 20 61 73 20 70 61 72 74 20 6f 66 0a 20 20 20 20 20 74 68 .is.not.saved.as.part.of......th
205e0 65 20 70 72 65 66 69 78 65 73 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 6d 75 6c 74 69 2d 76 61 6c e.prefixes.............multi-val
20600 75 65 e2 80 99 20 46 6f 72 20 6f 70 74 69 6f 6e 73 2c 20 77 68 65 74 68 65 72 20 74 68 65 20 6f ue....For.options,.whether.the.o
20620 70 74 69 6f 6e 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 70 6c 65 0a 20 20 20 20 20 76 61 6c ption.can.have.multiple......val
20640 75 65 73 2e 20 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2c 20 ues...If.this.is.non-...nil...,.
20660 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 73 20 61 72 65 20 72 65 61 64 20 75 73 69 6e 67 0a 20 then.the.values.are.read.using..
20680 20 20 20 20 e2 80 98 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 2d 6d 75 6c 74 69 70 6c 65 e2 .......completing-read-multiple.
206a0 80 99 20 62 79 20 64 65 66 61 75 6c 74 20 61 6e 64 20 69 66 20 79 6f 75 20 73 70 65 63 69 66 79 ...by.default.and.if.you.specify
206c0 20 79 6f 75 72 20 6f 77 6e 0a 20 20 20 20 20 72 65 61 64 65 72 2c 20 74 68 65 6e 20 69 74 20 73 .your.own......reader,.then.it.s
206e0 68 6f 75 6c 64 20 72 65 61 64 20 74 68 65 20 76 61 6c 75 65 73 20 75 73 69 6e 67 20 74 68 61 74 hould.read.the.values.using.that
20700 20 66 75 6e 63 74 69 6f 6e 20 6f 72 0a 20 20 20 20 20 73 69 6d 69 6c 61 72 2e 0a 0a 20 20 20 20 .function.or......similar.......
20720 20 53 75 70 70 6f 72 74 65 64 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 20 76 61 6c 75 65 73 20 .Supported.non-...nil....values.
20740 61 72 65 3a 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 55 73 65 20 e2 80 98 72 65 73 74 e2 80 99 are:..............Use....rest...
20760 20 66 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 61 74 20 63 61 6e 20 68 61 76 65 20 6d 75 6c .for.an.option.that.can.have.mul
20780 74 69 70 6c 65 20 76 61 6c 75 65 73 2e 20 20 54 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 69 73 tiple.values...This...........is
207a0 20 75 73 65 66 75 6c 20 65 2e 67 2e 2c 20 66 6f 72 20 61 6e 20 e2 80 98 2d 2d e2 80 99 20 61 72 .useful.e.g.,.for.an....--....ar
207c0 67 75 6d 65 6e 74 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 61 6c 6c 0a 20 gument.that.indicates.that.all..
207e0 20 20 20 20 20 20 20 20 20 72 65 6d 61 69 6e 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 .........remaining.arguments.are
20800 20 66 69 6c 65 73 20 28 73 75 63 68 20 61 73 20 e2 80 98 67 69 74 20 6c 6f 67 20 2d 2d 20 66 69 .files.(such.as....git.log.--.fi
20820 6c 65 31 0a 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 32 e2 80 99 29 2e 0a 0a 20 20 20 20 20 20 le1...........file2...).........
20840 20 20 20 20 49 6e 20 74 68 65 20 6c 69 73 74 20 72 65 74 75 72 6e 65 64 20 62 79 20 e2 80 98 74 ....In.the.list.returned.by....t
20860 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 20 73 75 63 68 20 61 6e 20 6f 70 74 69 6f 6e 20 ransient-args....such.an.option.
20880 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 69 74 73 20 76 61 6c 75 65 73 20 61 72 65 20 72 65 70 and...........its.values.are.rep
208a0 72 65 73 65 6e 74 65 64 20 62 79 20 61 20 73 69 6e 67 6c 65 20 6c 69 73 74 20 6f 66 20 74 68 65 resented.by.a.single.list.of.the
208c0 20 66 6f 72 6d 0a 20 20 20 20 20 20 20 20 20 20 e2 80 98 28 41 52 47 55 4d 45 4e 54 20 2e 20 56 .form..............(ARGUMENT...V
208e0 41 4c 55 45 53 29 e2 80 99 2e 0a 0a 20 20 20 20 20 20 20 20 e2 80 a2 20 55 73 65 20 e2 80 98 72 ALUES)..................Use....r
20900 65 70 65 61 74 e2 80 99 20 66 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 61 74 20 63 61 6e 20 epeat....for.an.option.that.can.
20920 62 65 20 73 70 65 63 69 66 69 65 64 20 6d 75 6c 74 69 70 6c 65 0a 20 20 20 20 20 20 20 20 20 20 be.specified.multiple...........
20940 74 69 6d 65 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 49 6e 20 74 68 65 20 6c 69 73 74 20 72 65 times.............In.the.list.re
20960 74 75 72 6e 65 64 20 62 79 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 20 65 turned.by....transient-args....e
20980 61 63 68 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 6f 70 ach.instance.of.the...........op
209a0 74 69 6f 6e 20 61 6e 64 20 69 74 73 20 76 61 6c 75 65 20 61 70 70 65 61 72 73 20 73 65 70 61 72 tion.and.its.value.appears.separ
209c0 61 74 65 6c 79 20 69 6e 20 74 68 65 20 75 73 75 61 6c 20 66 72 6f 6d 2c 20 66 6f 72 0a 20 20 20 ately.in.the.usual.from,.for....
209e0 20 20 20 20 20 20 20 65 78 61 6d 70 6c 65 3a 20 e2 80 98 28 22 2d 2d 61 6e 6f 74 68 65 72 2d 61 .......example:....("--another-a
20a00 72 67 75 6d 65 6e 74 22 20 22 2d 2d 6f 70 74 69 6f 6e 3d 66 69 72 73 74 22 0a 20 20 20 20 20 20 rgument"."--option=first".......
20a20 20 20 20 20 22 2d 2d 6f 70 74 69 6f 6e 3d 73 65 63 6f 6e 64 22 29 e2 80 99 2e 0a 0a 20 20 20 20 ...."--option=second")..........
20a40 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73 20 74 68 65 20 6f 70 74 69 6f 6e e2 80 99 73 20 76 61 .In.both.cases.the.option...s.va
20a60 6c 75 65 73 20 68 61 76 65 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 lues.have.to.be.specified.in.the
20a80 0a 20 20 20 20 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 61 20 70 72 65 66 69 78 20 ......default.value.of.a.prefix.
20aa0 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 61 74 20 61 73 20 72 65 74 75 72 6e 65 using.the.same.format.as.returne
20ac0 64 20 62 79 0a 20 20 20 20 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 e2 80 99 2c 20 d.by.........transient-args...,.
20ae0 65 2e 67 2e 2c 20 e2 80 98 28 22 2d 2d 6f 74 68 65 72 22 20 22 2d 2d 6f 3d 31 22 20 22 2d 2d 6f e.g.,....("--other"."--o=1"."--o
20b00 3d 32 22 20 28 22 2d 2d 22 20 22 66 31 22 0a 20 20 20 20 20 22 66 32 22 29 29 e2 80 99 2e 0a 0a =2".("--"."f1"......"f2"))......
20b20 20 20 20 e2 80 a2 20 e2 80 98 61 6c 77 61 79 73 2d 72 65 61 64 e2 80 99 20 46 6f 72 20 6f 70 74 ..........always-read....For.opt
20b40 69 6f 6e 73 2c 20 77 68 65 74 68 65 72 20 74 6f 20 72 65 61 64 20 61 20 76 61 6c 75 65 20 6f 6e ions,.whether.to.read.a.value.on
20b60 20 65 76 65 72 79 0a 20 20 20 20 20 69 6e 76 6f 63 61 74 69 6f 6e 2e 20 20 49 66 20 74 68 69 73 .every......invocation...If.this
20b80 20 69 73 20 e2 80 98 6e 69 6c e2 80 99 2c 20 74 68 65 6e 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 .is....nil...,.then.options.that
20ba0 20 68 61 76 65 20 61 20 76 61 6c 75 65 20 61 72 65 0a 20 20 20 20 20 73 69 6d 70 6c 79 20 75 6e .have.a.value.are......simply.un
20bc0 73 65 74 20 61 6e 64 20 68 61 76 65 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 61 20 73 65 63 set.and.have.to.be.invoked.a.sec
20be0 6f 6e 64 20 74 69 6d 65 20 74 6f 20 73 65 74 20 61 20 6e 65 77 0a 20 20 20 20 20 76 61 6c 75 65 ond.time.to.set.a.new......value
20c00 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 61 6c 6c 6f 77 2d 65 6d 70 74 79 e2 80 99 20 46 6f 72 20 .............allow-empty....For.
20c20 6f 70 74 69 6f 6e 73 2c 20 77 68 65 74 68 65 72 20 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e options,.whether.the.empty.strin
20c40 67 20 69 73 20 61 20 76 61 6c 69 64 0a 20 20 20 20 20 76 61 6c 75 65 2e 0a 0a 20 20 20 e2 80 a2 g.is.a.valid......value.........
20c60 20 e2 80 98 68 69 73 74 6f 72 79 2d 6b 65 79 e2 80 99 20 54 68 65 20 6b 65 79 20 75 73 65 64 20 ....history-key....The.key.used.
20c80 74 6f 20 73 74 6f 72 65 20 74 68 65 20 68 69 73 74 6f 72 79 2e 20 20 54 68 69 73 20 64 65 66 61 to.store.the.history...This.defa
20ca0 75 6c 74 73 20 74 6f 0a 20 20 20 20 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d 65 2e 20 20 ults.to......the.command.name...
20cc0 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 69 6e 66 This.is.useful.when.multiple.inf
20ce0 69 78 65 73 20 73 68 6f 75 6c 64 0a 20 20 20 20 20 73 68 61 72 65 20 74 68 65 20 73 61 6d 65 20 ixes.should......share.the.same.
20d00 68 69 73 74 6f 72 79 20 62 65 63 61 75 73 65 20 74 68 65 69 72 20 76 61 6c 75 65 73 20 61 72 65 history.because.their.values.are
20d20 20 6f 66 20 74 68 65 20 73 61 6d 65 20 6b 69 6e 64 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 72 65 .of.the.same.kind.............re
20d40 61 64 65 72 e2 80 99 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 72 65 61 ader....The.function.used.to.rea
20d60 64 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 2e 20 20 4e 6f 74 20 75 73 d.the.value.of.an.infix...Not.us
20d80 65 64 0a 20 20 20 20 20 66 6f 72 20 73 77 69 74 63 68 65 73 2e 20 20 54 68 65 20 66 75 6e 63 74 ed......for.switches...The.funct
20da0 69 6f 6e 20 74 61 6b 65 73 20 74 68 72 65 65 20 61 72 67 75 6d 65 6e 74 73 2c 20 50 52 4f 4d 50 ion.takes.three.arguments,.PROMP
20dc0 54 2c 0a 20 20 20 20 20 49 4e 49 54 49 41 4c 2d 49 4e 50 55 54 20 61 6e 64 20 48 49 53 54 4f 52 T,......INITIAL-INPUT.and.HISTOR
20de0 59 2c 20 61 6e 64 20 6d 75 73 74 20 72 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 2e 0a 0a 20 20 Y,.and.must.return.a.string.....
20e00 20 e2 80 a2 20 e2 80 98 70 72 6f 6d 70 74 e2 80 99 20 54 68 65 20 70 72 6f 6d 70 74 20 75 73 65 ........prompt....The.prompt.use
20e20 64 20 77 68 65 6e 20 72 65 61 64 69 6e 67 20 74 68 65 20 76 61 6c 75 65 2c 20 65 69 74 68 65 72 d.when.reading.the.value,.either
20e40 20 61 20 73 74 72 69 6e 67 20 6f 72 0a 20 20 20 20 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 .a.string.or......a.function.tha
20e60 74 20 74 61 6b 65 73 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 t.takes.the.object.as.the.only.a
20e80 72 67 75 6d 65 6e 74 20 61 6e 64 20 77 68 69 63 68 0a 20 20 20 20 20 72 65 74 75 72 6e 73 20 61 rgument.and.which......returns.a
20ea0 20 70 72 6f 6d 70 74 20 73 74 72 69 6e 67 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 63 68 6f 69 63 .prompt.string.............choic
20ec0 65 73 e2 80 99 20 41 20 6c 69 73 74 20 6f 66 20 76 61 6c 69 64 20 76 61 6c 75 65 73 2c 20 6f 72 es....A.list.of.valid.values,.or
20ee0 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 73 75 63 68 20 61 0a .a.function.that.returns.such.a.
20f00 20 20 20 20 20 6c 69 73 74 2e 20 20 54 68 65 20 6c 61 74 74 65 72 20 69 73 20 6e 6f 74 20 69 6d .....list...The.latter.is.not.im
20f20 70 6c 65 6d 65 6e 74 65 64 20 66 6f 72 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 plemented.for....transient-switc
20f40 68 65 73 e2 80 99 2c 0a 20 20 20 20 20 62 65 63 61 75 73 65 20 49 20 63 6f 75 6c 64 6e e2 80 99 hes...,......because.I.couldn...
20f60 74 20 74 68 69 6e 6b 20 6f 66 20 61 20 75 73 65 2d 63 61 73 65 2e 20 20 48 6f 77 20 65 78 61 63 t.think.of.a.use-case...How.exac
20f80 74 6c 79 20 74 68 65 20 63 68 6f 69 63 65 73 0a 20 20 20 20 20 61 72 65 20 75 73 65 64 20 76 61 tly.the.choices......are.used.va
20fa0 72 69 65 73 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 63 6c 61 73 73 20 6f 66 20 74 ries.depending.on.the.class.of.t
20fc0 68 65 20 73 75 66 66 69 78 2e 0a 0a 53 6c 6f 74 73 20 6f 66 20 e2 80 98 74 72 61 6e 73 69 65 6e he.suffix...Slots.of....transien
20fe0 74 2d 76 61 72 69 61 62 6c 65 e2 80 99 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d t-variable....------------------
21000 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 76 61 72 69 61 62 6c 65 e2 -----------............variable.
21020 80 99 20 54 68 65 20 76 61 72 69 61 62 6c 65 2e 0a 0a 53 6c 6f 74 73 20 6f 66 20 e2 80 98 74 72 ...The.variable...Slots.of....tr
21040 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 e2 80 99 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ansient-switches....------------
21060 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 61 72 67 -----------------............arg
21080 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 e2 80 99 20 54 68 65 20 64 69 73 70 6c 61 79 20 66 6f 72 6d ument-format....The.display.form
210a0 61 74 2e 20 20 4d 75 73 74 20 63 6f 6e 74 61 69 6e 20 e2 80 98 25 73 e2 80 99 2c 20 6f 6e 65 20 at...Must.contain....%s...,.one.
210c0 6f 66 0a 20 20 20 20 20 74 68 65 20 e2 80 98 63 68 6f 69 63 65 73 e2 80 99 20 69 73 20 73 75 62 of......the....choices....is.sub
210e0 73 74 69 74 75 74 65 64 20 66 6f 72 20 74 68 61 74 2e 20 20 45 2e 67 2e 2c 20 e2 80 98 2d 2d 25 stituted.for.that...E.g.,....--%
21100 73 2d 6f 72 64 65 72 e2 80 99 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 61 72 67 75 6d 65 6e 74 2d s-order................argument-
21120 72 65 67 65 78 70 e2 80 99 20 54 68 65 20 72 65 67 65 78 70 20 75 73 65 64 20 74 6f 20 6d 61 74 regexp....The.regexp.used.to.mat
21140 63 68 20 61 6e 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 73 77 69 74 63 68 65 73 2e 0a 20 20 20 20 ch.any.one.of.the.switches......
21160 20 45 2e 67 2e 2c 20 e2 80 98 5c 5c 28 2d 2d 5c 5c 28 74 6f 70 6f 5c 5c 7c 61 75 74 68 6f 72 2d .E.g.,....\\(--\\(topo\\|author-
21180 64 61 74 65 5c 5c 7c 64 61 74 65 5c 5c 29 2d 6f 72 64 65 72 5c 5c 29 e2 80 99 2e 0a 0a 1f 0a 46 date\\|date\\)-order\\)........F
211a0 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 50 72 65 64 ile:.doci3EOZM.info,..Node:.Pred
211c0 69 63 61 74 65 20 53 6c 6f 74 73 2c 20 20 50 72 65 76 3a 20 53 75 66 66 69 78 20 53 6c 6f 74 73 icate.Slots,..Prev:.Suffix.Slots
211e0 2c 20 20 55 70 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 0a 35 2e 39 20 ,..Up:.Classes.and.Methods..5.9.
21200 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d Predicate.Slots.================
21220 3d 3d 3d 0a 0a 53 75 66 66 69 78 20 61 6e 64 20 67 72 6f 75 70 20 6f 62 6a 65 63 74 73 20 73 68 ===..Suffix.and.group.objects.sh
21240 61 72 65 20 74 77 6f 20 73 65 74 73 20 6f 66 20 70 72 65 64 69 63 61 74 65 20 73 6c 6f 74 73 20 are.two.sets.of.predicate.slots.
21260 74 68 61 74 20 63 6f 6e 74 72 6f 6c 0a 77 68 65 74 68 65 72 20 61 20 67 72 6f 75 70 20 6f 72 20 that.control.whether.a.group.or.
21280 73 75 66 66 69 78 20 73 68 6f 75 6c 64 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 64 65 70 65 6e suffix.should.be.available.depen
212a0 64 69 6e 67 20 6f 6e 20 73 6f 6d 65 20 73 74 61 74 65 2e 0a 4f 6e 6c 79 20 6f 6e 65 20 73 6c 6f ding.on.some.state..Only.one.slo
212c0 74 20 66 72 6f 6d 20 65 61 63 68 20 73 65 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 74 20 74 t.from.each.set.can.be.used.at.t
212e0 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 49 74 20 69 73 0a 75 6e 64 65 66 69 6e 65 64 20 77 he.same.time...It.is.undefined.w
21300 68 69 63 68 20 73 6c 6f 74 20 69 73 20 68 6f 6e 6f 72 65 64 20 69 66 20 79 6f 75 20 75 73 65 20 hich.slot.is.honored.if.you.use.
21320 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 2e 0a 0a 20 20 20 50 72 65 64 69 63 61 74 65 73 20 66 72 more.than.one......Predicates.fr
21340 6f 6d 20 74 68 65 20 66 69 72 73 74 20 67 72 6f 75 70 20 63 6f 6e 74 72 6f 6c 20 77 68 65 74 68 om.the.first.group.control.wheth
21360 65 72 20 74 68 65 20 73 75 66 66 69 78 20 69 73 20 70 72 65 73 65 6e 74 0a 69 6e 20 74 68 65 20 er.the.suffix.is.present.in.the.
21380 6d 65 6e 75 20 61 74 20 61 6c 6c 2e 0a 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 e2 80 99 20 45 6e menu.at.all.............if....En
213a0 61 62 6c 65 20 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d e2 80 able.if.predicate.returns.non-..
213c0 98 6e 69 6c e2 80 99 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 6e 6f 74 e2 80 99 20 45 6e 61 .nil...............if-not....Ena
213e0 62 6c 65 20 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 e2 80 98 6e 69 6c e2 ble.if.predicate.returns....nil.
21400 80 99 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 6e 6f 6e 2d 6e 69 6c e2 80 99 20 45 6e 61 62 ..............if-non-nil....Enab
21420 6c 65 20 69 66 20 76 61 72 69 61 62 6c 65 e2 80 99 73 20 76 61 6c 75 65 20 69 73 20 6e 6f 6e 2d le.if.variable...s.value.is.non-
21440 e2 80 98 6e 69 6c e2 80 99 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 6e 69 6c e2 80 99 20 45 ...nil...............if-nil....E
21460 6e 61 62 6c 65 20 69 66 20 76 61 72 69 61 62 6c 65 e2 80 99 73 20 76 61 6c 75 65 20 69 73 20 e2 nable.if.variable...s.value.is..
21480 80 98 6e 69 6c e2 80 99 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 6d 6f 64 65 e2 80 99 20 45 ..nil...............if-mode....E
214a0 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 6d 61 74 63 68 65 73 20 76 61 6c 75 nable.if.major-mode.matches.valu
214c0 65 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 6e 6f 74 2d 6d 6f 64 65 e2 80 99 20 45 6e 61 62 e............if-not-mode....Enab
214e0 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 le.if.major-mode.does.not.match.
21500 76 61 6c 75 65 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 64 65 72 69 76 65 64 e2 80 99 20 45 value............if-derived....E
21520 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 65 72 69 76 65 73 20 66 72 6f 6d nable.if.major-mode.derives.from
21540 20 76 61 6c 75 65 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 .value............if-not-derived
21560 e2 80 99 20 45 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f ....Enable.if.major-mode.does.no
21580 74 20 64 65 72 69 76 65 20 66 72 6f 6d 20 76 61 6c 75 65 2e 0a 0a 20 20 20 50 72 65 64 69 63 61 t.derive.from.value......Predica
215a0 74 65 73 20 66 72 6f 6d 20 74 68 65 20 73 65 63 6f 6e 64 20 67 72 6f 75 70 20 63 6f 6e 74 72 6f tes.from.the.second.group.contro
215c0 6c 20 77 68 65 74 68 65 72 20 74 68 65 20 73 75 66 66 69 78 20 63 61 6e 20 62 65 0a 69 6e 76 6f l.whether.the.suffix.can.be.invo
215e0 6b 65 64 2e 20 20 54 68 65 20 73 75 66 66 69 78 20 69 73 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 ked...The.suffix.is.shown.in.the
21600 20 6d 65 6e 75 20 72 65 67 61 72 64 6c 65 73 73 2c 20 62 75 74 20 77 68 65 6e 20 69 74 20 69 73 .menu.regardless,.but.when.it.is
21620 0a 63 6f 6e 73 69 64 65 72 65 64 20 22 69 6e 61 70 74 22 2c 20 74 68 65 6e 20 69 74 20 69 73 20 .considered."inapt",.then.it.is.
21640 67 72 61 79 65 64 20 6f 75 74 20 74 6f 20 69 6e 64 69 63 61 74 65 64 20 74 68 61 74 20 69 74 20 grayed.out.to.indicated.that.it.
21660 63 75 72 72 65 6e 74 6c 79 0a 63 61 6e 6e 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 2e 0a 0a 20 20 currently.cannot.be.invoked.....
21680 20 e2 80 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 e2 80 99 20 49 6e 61 70 74 20 69 66 20 70 72 65 ........inapt-if....Inapt.if.pre
216a0 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d e2 80 98 6e 69 6c e2 80 99 2e 0a 20 20 dicate.returns.non-...nil.......
216c0 20 e2 80 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 e2 80 99 20 49 6e 61 70 74 20 69 66 ........inapt-if-not....Inapt.if
216e0 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 e2 80 98 6e 69 6c e2 80 99 2e 0a 20 20 .predicate.returns....nil.......
21700 20 e2 80 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 2d 6e 6f 6e 2d 6e 69 6c e2 80 99 20 49 6e 61 70 ........inapt-if-non-nil....Inap
21720 74 20 69 66 20 76 61 72 69 61 62 6c 65 e2 80 99 73 20 76 61 6c 75 65 20 69 73 20 6e 6f 6e 2d e2 t.if.variable...s.value.is.non-.
21740 80 98 6e 69 6c e2 80 99 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 2d 6e 69 6c ..nil...............inapt-if-nil
21760 e2 80 99 20 49 6e 61 70 74 20 69 66 20 76 61 72 69 61 62 6c 65 e2 80 99 73 20 76 61 6c 75 65 20 ....Inapt.if.variable...s.value.
21780 69 73 20 e2 80 98 6e 69 6c e2 80 99 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 is....nil...............inapt-if
217a0 2d 6d 6f 64 65 e2 80 99 20 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 6d 61 74 -mode....Inapt.if.major-mode.mat
217c0 63 68 65 73 20 76 61 6c 75 65 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 2d 6e ches.value............inapt-if-n
217e0 6f 74 2d 6d 6f 64 65 e2 80 99 20 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 ot-mode....Inapt.if.major-mode.d
21800 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 76 61 6c 75 65 2e 0a 20 20 20 e2 80 a2 20 e2 80 98 69 oes.not.match.value............i
21820 6e 61 70 74 2d 69 66 2d 64 65 72 69 76 65 64 e2 80 99 20 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f napt-if-derived....Inapt.if.majo
21840 72 2d 6d 6f 64 65 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 76 61 6c 75 65 2e 0a 20 20 20 e2 80 r-mode.derives.from.value.......
21860 a2 20 e2 80 98 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 e2 80 99 20 49 6e 61 .....inapt-if-not-derived....Ina
21880 70 74 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 64 65 72 69 76 65 pt.if.major-mode.does.not.derive
218a0 20 66 72 6f 6d 0a 20 20 20 20 20 76 61 6c 75 65 2e 0a 0a 20 20 20 42 79 20 64 65 66 61 75 6c 74 .from......value......By.default
218c0 20 74 68 65 73 65 20 70 72 65 64 69 63 61 74 65 73 20 72 75 6e 20 77 68 65 6e 20 74 68 65 20 70 .these.predicates.run.when.the.p
218e0 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2c 0a 62 75 74 20 74 68 refix.command.is.invoked,.but.th
21900 69 73 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 73 2c 20 75 73 69 6e 67 20 74 68 65 20 e2 80 98 is.can.be.changes,.using.the....
21920 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 e2 80 99 20 70 72 65 66 69 78 20 73 6c 6f 74 2e refresh-suffixes....prefix.slot.
21940 20 20 53 65 65 0a 2a 6e 6f 74 65 20 50 72 65 66 69 78 20 53 6c 6f 74 73 3a 3a 2e 0a 0a 20 20 20 ..See.*note.Prefix.Slots::......
21960 4f 6e 65 20 6d 6f 72 65 20 73 6c 6f 74 20 69 73 20 73 68 61 72 65 64 20 62 65 74 77 65 65 6e 20 One.more.slot.is.shared.between.
21980 67 72 6f 75 70 20 61 6e 64 20 73 75 66 66 69 78 20 63 6c 61 73 73 65 73 2c 20 e2 80 98 6c 65 76 group.and.suffix.classes,....lev
219a0 65 6c e2 80 99 2e 0a 4c 69 6b 65 20 74 68 65 20 73 6c 6f 74 73 20 64 6f 63 75 6d 65 6e 74 65 64 el.....Like.the.slots.documented
219c0 20 61 62 6f 76 65 2c 20 69 74 20 69 73 20 61 20 70 72 65 64 69 63 61 74 65 2c 20 62 75 74 20 69 .above,.it.is.a.predicate,.but.i
219e0 74 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 0a 64 69 66 66 65 72 65 6e 74 20 70 75 72 70 6f 73 t.is.used.for.a.different.purpos
21a00 65 2e 20 20 54 68 65 20 76 61 6c 75 65 20 68 61 73 20 74 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 e...The.value.has.to.be.an.integ
21a20 65 72 20 62 65 74 77 65 65 6e 20 31 20 61 6e 64 20 37 2e 0a e2 80 98 6c 65 76 65 6c e2 80 99 20 er.between.1.and.7.....level....
21a40 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 61 20 73 75 66 66 69 78 20 6f 72 20 61 20 67 controls.whether.a.suffix.or.a.g
21a60 72 6f 75 70 20 73 68 6f 75 6c 64 20 62 65 20 61 76 61 69 6c 61 62 6c 65 0a 64 65 70 65 6e 64 69 roup.should.be.available.dependi
21a80 6e 67 20 6f 6e 20 75 73 65 72 20 70 72 65 66 65 72 65 6e 63 65 2e 20 20 53 65 65 20 2a 6e 6f 74 ng.on.user.preference...See.*not
21aa0 65 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 0a 53 75 66 66 69 78 65 e.Enabling.and.Disabling.Suffixe
21ac0 73 3a 3a 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e s::.....File:.doci3EOZM.info,..N
21ae0 6f 64 65 3a 20 46 41 51 2c 20 20 4e 65 78 74 3a 20 4b 65 79 73 74 72 6f 6b 65 20 49 6e 64 65 78 ode:.FAQ,..Next:.Keystroke.Index
21b00 2c 20 20 50 72 65 76 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 2c 20 20 55 ,..Prev:.Classes.and.Methods,..U
21b20 70 3a 20 54 6f 70 0a 0a 41 70 70 65 6e 64 69 78 20 41 20 46 41 51 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a p:.Top..Appendix.A.FAQ.*********
21b40 2a 2a 2a 2a 2a 0a 0a 41 2e 31 20 43 61 6e 20 49 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 68 65 *****..A.1.Can.I.control.how.the
21b60 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 3f 0a 3d 3d 3d 3d 3d .menu.buffer.is.displayed?.=====
21b80 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
21ba0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 59 65 73 2c 20 73 65 65 20 e2 80 98 74 72 61 6e ==============..Yes,.see....tran
21bc0 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e e2 80 99 20 69 sient-display-buffer-action....i
21be0 6e 20 2a 6e 6f 74 65 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 3a 2e 0a 59 6f 75 20 63 61 6e n.*note.Configuration::..You.can
21c00 20 61 6c 73 6f 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 .also.control.how.the.menu.buffe
21c20 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 61 20 63 61 73 65 2d 62 79 2d 63 61 73 65 r.is.displayed.on.a.case-by-case
21c40 0a 62 61 73 69 73 20 62 79 20 70 61 73 73 69 6e 67 20 e2 80 98 3a 64 69 73 70 6c 61 79 2d 61 63 .basis.by.passing....:display-ac
21c60 74 69 6f 6e e2 80 99 20 74 6f 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 tion....to....transient-define-p
21c80 72 65 66 69 78 e2 80 99 2e 0a 0a 41 2e 32 20 48 6f 77 20 63 61 6e 20 49 20 63 6f 70 79 20 74 65 refix......A.2.How.can.I.copy.te
21ca0 78 74 20 66 72 6f 6d 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 3f 0a 3d 3d 3d 3d 3d 3d 3d xt.from.the.menu.buffer?.=======
21cc0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
21ce0 3d 3d 3d 3d 3d 3d 0a 0a 54 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 6d 61 72 6b 20 74 65 78 74 20 ======..To.be.able.to.mark.text.
21d00 69 6e 20 54 72 61 6e 73 69 65 6e 74 e2 80 99 73 20 6d 65 6e 75 20 62 75 66 66 65 72 20 75 73 69 in.Transient...s.menu.buffer.usi
21d20 6e 67 20 74 68 65 20 6d 6f 75 73 65 2c 20 79 6f 75 0a 68 61 76 65 20 74 6f 20 61 64 64 20 74 68 ng.the.mouse,.you.have.to.add.th
21d40 65 20 62 65 6c 6f 77 20 62 69 6e 64 69 6e 67 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 66 6f 72 20 e.below.binding...Note.that.for.
21d60 74 65 63 68 6e 69 63 61 6c 20 72 65 61 73 6f 6e 73 2c 20 74 68 65 0a 72 65 67 69 6f 6e 20 77 6f technical.reasons,.the.region.wo
21d80 6e e2 80 99 74 20 62 65 20 76 69 73 75 61 6c 69 7a 65 64 2c 20 77 68 69 6c 65 20 64 6f 69 6e 67 n...t.be.visualized,.while.doing
21da0 20 73 6f 2e 20 20 41 66 74 65 72 20 79 6f 75 20 68 61 76 65 20 71 75 69 74 20 74 68 65 0a 74 72 .so...After.you.have.quit.the.tr
21dc0 61 6e 73 69 65 6e 74 20 6d 65 6e 75 2c 20 79 6f 75 20 77 69 6c 6c 20 62 65 20 61 62 6c 65 20 74 ansient.menu,.you.will.be.able.t
21de0 6f 20 79 61 6e 6b 20 69 74 20 69 6e 20 61 6e 6f 74 68 65 72 20 62 75 66 66 65 72 2e 0a 0a 20 20 o.yank.it.in.another.buffer.....
21e00 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 ...(keymap-set.transient-predica
21e20 74 65 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 3c 6d 6f 75 73 65 2d te-map.................."<mouse-
21e40 73 65 74 2d 72 65 67 69 6f 6e 3e 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 set-region>"..................#'
21e60 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 29 0a 0a 20 20 20 43 6f 70 79 69 6e 67 20 transient--do-stay).....Copying.
21e80 74 68 65 20 72 65 67 69 6f 6e 20 77 68 69 6c 65 20 6e 6f 74 20 73 65 65 69 6e 67 20 74 68 65 20 the.region.while.not.seeing.the.
21ea0 72 65 67 69 6f 6e 20 69 73 20 61 20 62 69 74 20 66 69 64 64 6c 79 2c 20 73 6f 20 61 0a 64 65 64 region.is.a.bit.fiddly,.so.a.ded
21ec0 69 63 61 74 65 64 20 63 6f 6d 6d 61 6e 64 2c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 63 6f 70 icated.command,....transient-cop
21ee0 79 2d 6d 65 6e 75 2d 74 65 78 74 e2 80 99 2c 20 77 61 73 20 61 64 64 65 64 2e 20 20 59 6f 75 20 y-menu-text...,.was.added...You.
21f00 68 61 76 65 20 74 6f 0a 61 64 64 20 61 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 74 68 69 73 20 63 have.to.add.a.binding.for.this.c
21f20 6f 6d 6d 61 6e 64 20 69 6e 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 e2 80 99 2e 0a 0a ommand.in....transient-map......
21f40 20 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 22 .....(keymap-set.transient-map."
21f60 43 2d 63 20 43 2d 77 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 70 79 2d 6d 65 6e 75 2d 74 C-c.C-w".#'transient-copy-menu-t
21f80 65 78 74 29 0a 0a 41 2e 33 20 48 6f 77 20 63 61 6e 20 49 20 61 75 74 6f 6c 6f 61 64 20 70 72 65 ext)..A.3.How.can.I.autoload.pre
21fa0 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 3f 0a 3d 3d 3d 3d 3d 3d 3d fix.and.suffix.commands?.=======
21fc0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
21fe0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 49 66 20 79 6f 75 72 20 70 61 63 6b 61 67 65 20 6f 6e 6c ===========..If.your.package.onl
22000 79 20 73 75 70 70 6f 72 74 73 20 45 6d 61 63 73 20 33 30 2c 20 6a 75 73 74 20 70 72 65 66 69 78 y.supports.Emacs.30,.just.prefix
22020 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 77 69 74 68 0a e2 80 98 3b 3b 3b 23 23 23 61 75 .the.definition.with....;;;###au
22040 74 6f 6c 6f 61 64 e2 80 99 2e 20 20 49 66 20 79 6f 75 72 20 70 61 63 6b 61 67 65 20 73 75 70 70 toload......If.your.package.supp
22060 6f 72 74 73 20 72 65 6c 65 61 73 65 64 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 45 6d 61 63 73 2c orts.released.versions.of.Emacs,
22080 0a 79 6f 75 20 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 68 61 76 65 20 74 6f 20 75 73 65 20 61 .you.unfortunately.have.to.use.a
220a0 20 6c 6f 6e 67 20 66 6f 72 6d 20 61 75 74 6f 6c 6f 61 64 20 63 6f 6d 6d 65 6e 74 20 61 73 20 64 .long.form.autoload.comment.as.d
220c0 65 73 63 72 69 62 65 64 0a 69 6e 20 2a 6e 6f 74 65 20 28 65 6c 69 73 70 29 41 75 74 6f 6c 6f 61 escribed.in.*note.(elisp)Autoloa
220e0 64 3a 3a 2e 0a 0a 20 20 20 20 20 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 20 28 61 75 74 6f 6c d::........;;;###autoload.(autol
22100 6f 61 64 20 27 6d 61 67 69 74 2d 64 69 73 70 61 74 63 68 20 22 6d 61 67 69 74 22 20 6e 69 6c 20 oad.'magit-dispatch."magit".nil.
22120 74 29 0a 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 t)......(transient-define-prefix
22140 20 6d 61 67 69 74 2d 64 69 73 70 61 74 63 68 20 28 29 0a 20 20 20 20 20 20 20 2e 2e 2e 29 0a 0a .magit-dispatch.()...........)..
22160 41 2e 34 20 48 6f 77 20 64 6f 65 73 20 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 70 61 72 65 20 74 A.4.How.does.Transient.compare.t
22180 6f 20 70 72 65 66 69 78 20 6b 65 79 73 20 61 6e 64 20 75 6e 69 76 65 72 73 61 6c 20 61 72 67 75 o.prefix.keys.and.universal.argu
221a0 6d 65 6e 74 73 3f 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ments?.=========================
221c0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
221e0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 53 65 65 0a 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 =============..See.<https://gith
22200 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 2f 77 69 6b 69 2f 43 6f 6d 70 ub.com/magit/transient/wiki/Comp
22220 61 72 69 73 6f 6e 2d 77 69 74 68 2d 70 72 65 66 69 78 2d 6b 65 79 73 2d 61 6e 64 2d 75 6e 69 76 arison-with-prefix-keys-and-univ
22240 65 72 73 61 6c 2d 61 72 67 75 6d 65 6e 74 73 3e 2e 0a 0a 41 2e 35 20 48 6f 77 20 64 6f 65 73 20 ersal-arguments>...A.5.How.does.
22260 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 70 61 72 65 20 74 6f 20 4d 61 67 69 74 2d 50 6f 70 75 70 Transient.compare.to.Magit-Popup
22280 20 61 6e 64 20 48 79 64 72 61 3f 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .and.Hydra?.====================
222a0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
222c0 3d 3d 3d 3d 0a 0a 53 65 65 0a 3c 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 ====..See.<https://github.com/ma
222e0 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 2f 77 69 6b 69 2f 43 6f 6d 70 61 72 69 73 6f 6e 2d 77 69 git/transient/wiki/Comparison-wi
22300 74 68 2d 6f 74 68 65 72 2d 70 61 63 6b 61 67 65 73 3e 2e 0a 0a 41 2e 36 20 57 68 79 20 64 6f 65 th-other-packages>...A.6.Why.doe
22320 73 20 e2 80 98 71 e2 80 99 20 6e 6f 74 20 71 75 69 74 20 70 6f 70 75 70 73 20 61 6e 79 6d 6f 72 s....q....not.quit.popups.anymor
22340 65 3f 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d e?.=============================
22360 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 49 20 61 67 72 65 65 20 74 68 61 74 20 e2 80 98 71 e2 ============..I.agree.that....q.
22380 80 99 20 69 73 20 61 20 67 6f 6f 64 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 ...is.a.good.binding.for.command
223a0 73 20 74 68 61 74 20 71 75 69 74 20 73 6f 6d 65 74 68 69 6e 67 2e 0a 54 68 69 73 20 69 6e 63 6c s.that.quit.something..This.incl
223c0 75 64 65 73 20 71 75 69 74 74 69 6e 67 20 77 68 61 74 65 76 65 72 20 74 72 61 6e 73 69 65 6e 74 udes.quitting.whatever.transient
223e0 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 2c 20 62 75 74 20 69 74 0a 61 6c 73 .is.currently.active,.but.it.als
22400 6f 20 69 6e 63 6c 75 64 65 73 20 71 75 69 74 74 69 6e 67 20 77 68 61 74 65 76 65 72 20 69 74 20 o.includes.quitting.whatever.it.
22420 69 73 20 74 68 61 74 20 73 6f 6d 65 20 73 70 65 63 69 66 69 63 20 74 72 61 6e 73 69 65 6e 74 20 is.that.some.specific.transient.
22440 69 73 0a 63 6f 6e 74 72 6f 6c 6c 69 6e 67 2e 20 20 54 68 65 20 74 72 61 6e 73 69 65 6e 74 20 e2 is.controlling...The.transient..
22460 80 98 6d 61 67 69 74 2d 62 6c 61 6d 65 e2 80 99 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 62 69 6e ..magit-blame....for.example.bin
22480 64 73 20 e2 80 98 71 e2 80 99 20 74 6f 20 74 68 65 0a 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 74 ds....q....to.the.command.that.t
224a0 75 72 6e 73 20 e2 80 98 6d 61 67 69 74 2d 62 6c 61 6d 65 2d 6d 6f 64 65 e2 80 99 20 6f 66 66 2e urns....magit-blame-mode....off.
224c0 0a 0a 20 20 20 53 6f 20 49 20 68 61 64 20 74 6f 20 64 65 63 69 64 65 20 69 66 20 e2 80 98 71 e2 .....So.I.had.to.decide.if....q.
224e0 80 99 20 73 68 6f 75 6c 64 20 71 75 69 74 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 ...should.quit.the.active.transi
22500 65 6e 74 20 28 6c 69 6b 65 0a 4d 61 67 69 74 2d 50 6f 70 75 70 20 75 73 65 64 20 74 6f 29 20 6f ent.(like.Magit-Popup.used.to).o
22520 72 20 77 68 65 74 68 65 72 20 e2 80 98 43 2d 67 e2 80 99 20 73 68 6f 75 6c 64 20 64 6f 20 74 68 r.whether....C-g....should.do.th
22540 61 74 20 69 6e 73 74 65 61 64 2c 20 73 6f 20 74 68 61 74 0a e2 80 98 71 e2 80 99 20 63 6f 75 6c at.instead,.so.that....q....coul
22560 64 20 62 65 20 62 6f 75 6e 64 20 69 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 d.be.bound.in.individual.transie
22580 6e 74 20 74 6f 20 77 68 61 74 65 76 65 72 20 63 6f 6d 6d 61 6e 64 73 20 6d 61 6b 65 0a 73 65 6e nt.to.whatever.commands.make.sen
225a0 73 65 20 66 6f 72 20 74 68 65 6d 2e 20 20 42 65 63 61 75 73 65 20 61 6c 6c 20 6f 74 68 65 72 20 se.for.them...Because.all.other.
225c0 6c 65 74 74 65 72 73 20 61 72 65 20 61 6c 72 65 61 64 79 20 72 65 73 65 72 76 65 64 20 66 6f 72 letters.are.already.reserved.for
225e0 20 75 73 65 0a 62 79 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 73 2c 20 49 .use.by.individual.transients,.I
22600 20 68 61 76 65 20 64 65 63 69 64 65 64 20 74 6f 20 6e 6f 20 6c 6f 6e 67 65 72 20 6d 61 6b 65 20 .have.decided.to.no.longer.make.
22620 61 6e 20 65 78 63 65 70 74 69 6f 6e 0a 66 6f 72 20 e2 80 98 71 e2 80 99 2e 0a 0a 20 20 20 49 66 an.exception.for....q.........If
22640 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 67 65 74 20 e2 80 98 71 e2 80 99 e2 80 99 73 20 6f 6c 64 .you.want.to.get....q......s.old
22660 20 62 69 6e 64 69 6e 67 20 62 61 63 6b 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 64 6f 20 73 6f .binding.back.then.you.can.do.so
22680 2e 20 20 44 6f 69 6e 67 0a 74 68 61 74 20 69 73 20 61 20 62 69 74 20 6d 6f 72 65 20 63 6f 6d 70 ...Doing.that.is.a.bit.more.comp
226a0 6c 69 63 61 74 65 64 20 74 68 61 6e 20 63 68 61 6e 67 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 6b licated.than.changing.a.single.k
226c0 65 79 20 62 69 6e 64 69 6e 67 2c 20 73 6f 20 49 0a 68 61 76 65 20 69 6d 70 6c 65 6d 65 6e 74 65 ey.binding,.so.I.have.implemente
226e0 64 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 e2 80 98 74 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d d.a.function,....transient-bind-
22700 71 2d 74 6f 2d 71 75 69 74 e2 80 99 20 74 68 61 74 20 6d 61 6b 65 73 20 74 68 65 0a 6e 65 63 65 q-to-quit....that.makes.the.nece
22720 73 73 61 72 79 20 63 68 61 6e 67 65 73 2e 20 20 53 65 65 20 69 74 73 20 64 6f 63 75 6d 65 6e 74 ssary.changes...See.its.document
22740 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f ation.string.for.more.informatio
22760 6e 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 n.....File:.doci3EOZM.info,..Nod
22780 65 3a 20 4b 65 79 73 74 72 6f 6b 65 20 49 6e 64 65 78 2c 20 20 4e 65 78 74 3a 20 43 6f 6d 6d 61 e:.Keystroke.Index,..Next:.Comma
227a0 6e 64 20 61 6e 64 20 46 75 6e 63 74 69 6f 6e 20 49 6e 64 65 78 2c 20 20 50 72 65 76 3a 20 46 41 nd.and.Function.Index,..Prev:.FA
227c0 51 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 41 70 70 65 6e 64 69 78 20 42 20 4b 65 79 73 74 72 6f 6b Q,..Up:.Top..Appendix.B.Keystrok
227e0 65 20 49 6e 64 65 78 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a e.Index.************************
22800 2a 2a 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 **....File:.doci3EOZM.info,..Nod
22820 65 3a 20 43 6f 6d 6d 61 6e 64 20 61 6e 64 20 46 75 6e 63 74 69 6f 6e 20 49 6e 64 65 78 2c 20 20 e:.Command.and.Function.Index,..
22840 4e 65 78 74 3a 20 56 61 72 69 61 62 6c 65 20 49 6e 64 65 78 2c 20 20 50 72 65 76 3a 20 4b 65 79 Next:.Variable.Index,..Prev:.Key
22860 73 74 72 6f 6b 65 20 49 6e 64 65 78 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 41 70 70 65 6e 64 69 78 stroke.Index,..Up:.Top..Appendix
22880 20 43 20 43 6f 6d 6d 61 6e 64 20 61 6e 64 20 46 75 6e 63 74 69 6f 6e 20 49 6e 64 65 78 0a 2a 2a .C.Command.and.Function.Index.**
228a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ********************************
228c0 2a 2a 2a 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f ***....File:.doci3EOZM.info,..No
228e0 64 65 3a 20 56 61 72 69 61 62 6c 65 20 49 6e 64 65 78 2c 20 20 4e 65 78 74 3a 20 43 6f 6e 63 65 de:.Variable.Index,..Next:.Conce
22900 70 74 20 49 6e 64 65 78 2c 20 20 50 72 65 76 3a 20 43 6f 6d 6d 61 6e 64 20 61 6e 64 20 46 75 6e pt.Index,..Prev:.Command.and.Fun
22920 63 74 69 6f 6e 20 49 6e 64 65 78 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 41 70 70 65 6e 64 69 78 20 ction.Index,..Up:.Top..Appendix.
22940 44 20 56 61 72 69 61 62 6c 65 20 49 6e 64 65 78 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a D.Variable.Index.***************
22960 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 1f 0a 46 69 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e **********....File:.doci3EOZM.in
22980 66 6f 2c 20 20 4e 6f 64 65 3a 20 43 6f 6e 63 65 70 74 20 49 6e 64 65 78 2c 20 20 4e 65 78 74 3a fo,..Node:.Concept.Index,..Next:
229a0 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 2c 20 20 50 72 .GNU.General.Public.License,..Pr
229c0 65 76 3a 20 56 61 72 69 61 62 6c 65 20 49 6e 64 65 78 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 41 70 ev:.Variable.Index,..Up:.Top..Ap
229e0 70 65 6e 64 69 78 20 45 20 43 6f 6e 63 65 70 74 20 49 6e 64 65 78 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a pendix.E.Concept.Index.*********
22a00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 00 08 5b 69 6e 64 65 78 00 08 5d 0a 2a 20 4d ***************....[index..].*.M
22a20 65 6e 75 3a 0a 0a 2a 20 61 62 6f 72 74 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 73 3a 20 20 20 20 enu:..*.aborting.transients:....
22a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 75 ...............Aborting.and.Resu
22a60 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ming.Transients.................
22a80 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 ................................
22aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 63 6c 61 73 ................(line..6).*.clas
22ac0 73 65 73 20 61 6e 64 20 6d 65 74 68 6f 64 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ses.and.methods:................
22ae0 20 20 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 2e 20 20 28 6c 69 6e 65 20 20 ...Classes.and.Methods...(line..
22b00 36 29 0a 2a 20 63 6f 6d 6d 61 6e 64 20 64 69 73 70 61 74 63 68 65 72 73 3a 20 20 20 20 20 20 20 6).*.command.dispatchers:.......
22b20 20 20 20 20 20 20 20 20 20 20 20 20 54 65 63 68 6e 69 63 61 6c 20 49 6e 74 72 6f 64 75 63 74 69 ............Technical.Introducti
22b40 6f 6e 2e 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 on..............................
22b60 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 ................................
22b80 20 20 20 28 6c 69 6e 65 20 33 39 29 0a 2a 20 63 6f 6d 6d 6f 6e 20 73 75 66 66 69 78 20 63 6f 6d ...(line.39).*.common.suffix.com
22ba0 6d 61 6e 64 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 43 6f 6d 6d 6f 6e 20 53 75 66 mands:................Common.Suf
22bc0 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 fix.Commands....................
22be0 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 ................................
22c00 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 64 65 66 69 6e 69 6e .............(line..6).*.definin
22c20 67 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g.infix.commands:...............
22c40 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e Defining.Suffix.and.Infix.Comman
22c60 64 73 2e 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 ds..............................
22c80 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 ................................
22ca0 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 64 65 66 69 6e 69 6e 67 20 73 75 66 66 69 78 20 63 ...(line..6).*.defining.suffix.c
22cc0 6f 6d 6d 61 6e 64 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 44 65 66 69 6e 69 6e 67 20 53 ommands:..............Defining.S
22ce0 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2e 0a 20 20 20 20 20 20 uffix.and.Infix.Commands........
22d00 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 ................................
22d20 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 6c 69 6e 65 20 20 .........................(line..
22d40 36 29 0a 2a 20 64 69 73 61 62 6c 69 6e 67 20 73 75 66 66 69 78 65 73 3a 20 20 20 20 20 20 20 20 6).*.disabling.suffixes:........
22d60 20 20 20 20 20 20 20 20 20 20 20 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 ............Enabling.and.Disabli
22d80 6e 67 20 53 75 66 66 69 78 65 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ng.Suffixes.....................
22da0 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 ................................
22dc0 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 65 6e 61 62 6c 69 6e 67 ............(line..6).*.enabling
22de0 20 73 75 66 66 69 78 65 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 45 .suffixes:.....................E
22e00 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 2e 0a nabling.and.Disabling.Suffixes..
22e20 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 ................................
22e40 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 28 ...............................(
22e60 6c 69 6e 65 20 20 36 29 0a 2a 20 67 65 74 74 69 6e 67 20 68 65 6c 70 3a 20 20 20 20 20 20 20 20 line..6).*.getting.help:........
22e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 ..................Getting.Help.f
22ea0 6f 72 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 or.Suffix.Commands..............
22ec0 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 ................................
22ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 67 ...................(line..6).*.g
22f00 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 roup.specifications:............
22f20 20 20 20 20 20 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2e 20 28 6c 69 6e ......Group.Specifications..(lin
22f40 65 20 20 36 29 0a 2a 20 69 6e 76 6f 6b 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 73 3a 20 20 20 20 e..6).*.invoking.transients:....
22f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e ...............Invoking.Transien
22f80 74 73 2e 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 6c 65 76 65 6c 73 3a 20 20 20 20 20 20 20 20 ts...(line..6).*.levels:........
22fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 45 6e 61 62 6c 69 6e 67 ........................Enabling
22fc0 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 2e 0a 20 20 20 20 20 20 20 .and.Disabling.Suffixes.........
22fe0 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 ................................
23000 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 65 20 31 30 ........................(line.10
23020 29 0a 2a 20 6d 6f 64 69 66 79 69 6e 67 20 65 78 69 73 74 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 ).*.modifying.existing.transient
23040 73 3a 20 20 20 20 20 20 20 20 20 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 s:.........Modifying.Existing.Tr
23060 61 6e 73 69 65 6e 74 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ansients........................
23080 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 ................................
230a0 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 71 75 69 74 20 74 72 61 6e 73 69 .........(line..6).*.quit.transi
230c0 65 6e 74 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 62 6f 72 ent:........................Abor
230e0 74 69 6e 67 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2e 0a 20 20 ting.and.Resuming.Transients....
23100 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 ................................
23120 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 6c 69 .............................(li
23140 6e 65 20 20 36 29 0a 2a 20 72 65 73 75 6d 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 73 3a 20 20 20 ne..6).*.resuming.transients:...
23160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 ................Aborting.and.Res
23180 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 uming.Transients................
231a0 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 ................................
231c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 73 61 76 .................(line..6).*.sav
231e0 69 6e 67 20 76 61 6c 75 65 73 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 3a 20 20 20 20 20 20 20 20 ing.values.of.arguments:........
23200 20 20 20 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 2e 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 ....Saving.Values.........(line.
23220 20 36 29 0a 2a 20 73 63 6f 70 65 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e 74 3a 20 20 20 20 20 .6).*.scope.of.a.transient:.....
23240 20 20 20 20 20 20 20 20 20 20 20 20 20 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 .............Defining.Transients
23260 2e 20 20 28 6c 69 6e 65 20 34 32 29 0a 2a 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 ...(line.42).*.suffix.specificat
23280 69 6f 6e 73 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 75 66 66 69 78 20 53 70 65 ions:.................Suffix.Spe
232a0 63 69 66 69 63 61 74 69 6f 6e 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 cifications.....................
232c0 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 ................................
232e0 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a 20 74 72 61 6e 73 69 65 6e ............(line..6).*.transien
23300 74 20 73 74 61 74 65 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 t.state:.......................T
23320 72 61 6e 73 69 65 6e 74 20 53 74 61 74 65 2e 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 2a ransient.State.......(line..6).*
23340 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .transient-level:...............
23360 20 20 20 20 20 20 20 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 ........Enabling.and.Disabling.S
23380 75 66 66 69 78 65 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 uffixes.........................
233a0 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 ................................
233c0 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 31 35 29 0a 2a 20 76 61 6c 75 65 20 68 69 73 74 6f 72 ........(line.15).*.value.histor
233e0 79 3a 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 55 73 69 6e 67 y:.........................Using
23400 20 48 69 73 74 6f 72 79 2e 20 20 20 20 20 20 20 20 28 6c 69 6e 65 20 20 36 29 0a 0a 1f 0a 46 69 .History.........(line..6)....Fi
23420 6c 65 3a 20 64 6f 63 69 33 45 4f 5a 4d 2e 69 6e 66 6f 2c 20 20 4e 6f 64 65 3a 20 47 4e 55 20 47 le:.doci3EOZM.info,..Node:.GNU.G
23440 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 2c 20 20 50 72 65 76 3a 20 43 6f eneral.Public.License,..Prev:.Co
23460 6e 63 65 70 74 20 49 6e 64 65 78 2c 20 20 55 70 3a 20 54 6f 70 0a 0a 41 70 70 65 6e 64 69 78 20 ncept.Index,..Up:.Top..Appendix.
23480 46 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 0a 2a 2a 2a F.GNU.General.Public.License.***
234a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ********************************
234c0 2a 2a 0a 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 56 65 72 73 **..........................Vers
234e0 69 6f 6e 20 33 2c 20 32 39 20 4a 75 6e 65 20 32 30 30 37 0a 0a 20 20 20 20 20 43 6f 70 79 72 69 ion.3,.29.June.2007.......Copyri
23500 67 68 74 20 c2 a9 20 32 30 30 37 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 ght....2007.Free.Software.Founda
23520 74 69 6f 6e 2c 20 49 6e 63 2e 20 3c 68 74 74 70 73 3a 2f 2f 66 73 66 2e 6f 72 67 2f 3e 0a 0a 20 tion,.Inc..<https://fsf.org/>...
23540 20 20 20 20 45 76 65 72 79 6f 6e 65 20 69 73 20 70 65 72 6d 69 74 74 65 64 20 74 6f 20 63 6f 70 ....Everyone.is.permitted.to.cop
23560 79 20 61 6e 64 20 64 69 73 74 72 69 62 75 74 65 20 76 65 72 62 61 74 69 6d 20 63 6f 70 69 65 73 y.and.distribute.verbatim.copies
23580 20 6f 66 20 74 68 69 73 0a 20 20 20 20 20 6c 69 63 65 6e 73 65 20 64 6f 63 75 6d 65 6e 74 2c 20 .of.this......license.document,.
235a0 62 75 74 20 63 68 61 6e 67 69 6e 67 20 69 74 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 2e 0a but.changing.it.is.not.allowed..
235c0 0a 50 72 65 61 6d 62 6c 65 0a 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 47 4e 55 20 47 65 6e 65 .Preamble.========..The.GNU.Gene
235e0 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 69 73 20 61 20 66 72 65 65 2c 20 63 6f ral.Public.License.is.a.free,.co
23600 70 79 6c 65 66 74 20 6c 69 63 65 6e 73 65 20 66 6f 72 20 73 6f 66 74 77 61 72 65 0a 61 6e 64 20 pyleft.license.for.software.and.
23620 6f 74 68 65 72 20 6b 69 6e 64 73 20 6f 66 20 77 6f 72 6b 73 2e 0a 0a 20 20 20 54 68 65 20 6c 69 other.kinds.of.works......The.li
23640 63 65 6e 73 65 73 20 66 6f 72 20 6d 6f 73 74 20 73 6f 66 74 77 61 72 65 20 61 6e 64 20 6f 74 68 censes.for.most.software.and.oth
23660 65 72 20 70 72 61 63 74 69 63 61 6c 20 77 6f 72 6b 73 20 61 72 65 20 64 65 73 69 67 6e 65 64 0a er.practical.works.are.designed.
23680 74 6f 20 74 61 6b 65 20 61 77 61 79 20 79 6f 75 72 20 66 72 65 65 64 6f 6d 20 74 6f 20 73 68 61 to.take.away.your.freedom.to.sha
236a0 72 65 20 61 6e 64 20 63 68 61 6e 67 65 20 74 68 65 20 77 6f 72 6b 73 2e 20 20 42 79 20 63 6f 6e re.and.change.the.works...By.con
236c0 74 72 61 73 74 2c 0a 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 trast,.the.GNU.General.Public.Li
236e0 63 65 6e 73 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 67 75 61 72 61 6e 74 65 65 20 79 cense.is.intended.to.guarantee.y
23700 6f 75 72 20 66 72 65 65 64 6f 6d 20 74 6f 0a 73 68 61 72 65 20 61 6e 64 20 63 68 61 6e 67 65 20 our.freedom.to.share.and.change.
23720 61 6c 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 20 70 72 6f 67 72 61 6d e2 80 94 74 6f 20 6d all.versions.of.a.program...to.m
23740 61 6b 65 20 73 75 72 65 20 69 74 20 72 65 6d 61 69 6e 73 20 66 72 65 65 0a 73 6f 66 74 77 61 72 ake.sure.it.remains.free.softwar
23760 65 20 66 6f 72 20 61 6c 6c 20 69 74 73 20 75 73 65 72 73 2e 20 20 57 65 2c 20 74 68 65 20 46 72 e.for.all.its.users...We,.the.Fr
23780 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 75 73 65 20 74 68 65 0a ee.Software.Foundation,.use.the.
237a0 47 4e 55 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 GNU.General.Public.License.for.m
237c0 6f 73 74 20 6f 66 20 6f 75 72 20 73 6f 66 74 77 61 72 65 3b 20 69 74 20 61 70 70 6c 69 65 73 20 ost.of.our.software;.it.applies.
237e0 61 6c 73 6f 20 74 6f 0a 61 6e 79 20 6f 74 68 65 72 20 77 6f 72 6b 20 72 65 6c 65 61 73 65 64 20 also.to.any.other.work.released.
23800 74 68 69 73 20 77 61 79 20 62 79 20 69 74 73 20 61 75 74 68 6f 72 73 2e 20 20 59 6f 75 20 63 61 this.way.by.its.authors...You.ca
23820 6e 20 61 70 70 6c 79 20 69 74 20 74 6f 0a 79 6f 75 72 20 70 72 6f 67 72 61 6d 73 2c 20 74 6f 6f n.apply.it.to.your.programs,.too
23840 2e 0a 0a 20 20 20 57 68 65 6e 20 77 65 20 73 70 65 61 6b 20 6f 66 20 66 72 65 65 20 73 6f 66 74 ......When.we.speak.of.free.soft
23860 77 61 72 65 2c 20 77 65 20 61 72 65 20 72 65 66 65 72 72 69 6e 67 20 74 6f 20 66 72 65 65 64 6f ware,.we.are.referring.to.freedo
23880 6d 2c 20 6e 6f 74 0a 70 72 69 63 65 2e 20 20 4f 75 72 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 m,.not.price...Our.General.Publi
238a0 63 20 4c 69 63 65 6e 73 65 73 20 61 72 65 20 64 65 73 69 67 6e 65 64 20 74 6f 20 6d 61 6b 65 20 c.Licenses.are.designed.to.make.
238c0 73 75 72 65 20 74 68 61 74 20 79 6f 75 0a 68 61 76 65 20 74 68 65 20 66 72 65 65 64 6f 6d 20 74 sure.that.you.have.the.freedom.t
238e0 6f 20 64 69 73 74 72 69 62 75 74 65 20 63 6f 70 69 65 73 20 6f 66 20 66 72 65 65 20 73 6f 66 74 o.distribute.copies.of.free.soft
23900 77 61 72 65 20 28 61 6e 64 20 63 68 61 72 67 65 20 66 6f 72 0a 74 68 65 6d 20 69 66 20 79 6f 75 ware.(and.charge.for.them.if.you
23920 20 77 69 73 68 29 2c 20 74 68 61 74 20 79 6f 75 20 72 65 63 65 69 76 65 20 73 6f 75 72 63 65 20 .wish),.that.you.receive.source.
23940 63 6f 64 65 20 6f 72 20 63 61 6e 20 67 65 74 20 69 74 20 69 66 20 79 6f 75 0a 77 61 6e 74 20 69 code.or.can.get.it.if.you.want.i
23960 74 2c 20 74 68 61 74 20 79 6f 75 20 63 61 6e 20 63 68 61 6e 67 65 20 74 68 65 20 73 6f 66 74 77 t,.that.you.can.change.the.softw
23980 61 72 65 20 6f 72 20 75 73 65 20 70 69 65 63 65 73 20 6f 66 20 69 74 20 69 6e 20 6e 65 77 0a 66 are.or.use.pieces.of.it.in.new.f
239a0 72 65 65 20 70 72 6f 67 72 61 6d 73 2c 20 61 6e 64 20 74 68 61 74 20 79 6f 75 20 6b 6e 6f 77 20 ree.programs,.and.that.you.know.
239c0 79 6f 75 20 63 61 6e 20 64 6f 20 74 68 65 73 65 20 74 68 69 6e 67 73 2e 0a 0a 20 20 20 54 6f 20 you.can.do.these.things......To.
239e0 70 72 6f 74 65 63 74 20 79 6f 75 72 20 72 69 67 68 74 73 2c 20 77 65 20 6e 65 65 64 20 74 6f 20 protect.your.rights,.we.need.to.
23a00 70 72 65 76 65 6e 74 20 6f 74 68 65 72 73 20 66 72 6f 6d 20 64 65 6e 79 69 6e 67 20 79 6f 75 0a prevent.others.from.denying.you.
23a20 74 68 65 73 65 20 72 69 67 68 74 73 20 6f 72 20 61 73 6b 69 6e 67 20 79 6f 75 20 74 6f 20 73 75 these.rights.or.asking.you.to.su
23a40 72 72 65 6e 64 65 72 20 74 68 65 20 72 69 67 68 74 73 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 20 rrender.the.rights...Therefore,.
23a60 79 6f 75 20 68 61 76 65 0a 63 65 72 74 61 69 6e 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 69 65 you.have.certain.responsibilitie
23a80 73 20 69 66 20 79 6f 75 20 64 69 73 74 72 69 62 75 74 65 20 63 6f 70 69 65 73 20 6f 66 20 74 68 s.if.you.distribute.copies.of.th
23aa0 65 20 73 6f 66 74 77 61 72 65 2c 20 6f 72 20 69 66 0a 79 6f 75 20 6d 6f 64 69 66 79 20 69 74 3a e.software,.or.if.you.modify.it:
23ac0 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 69 65 73 20 74 6f 20 72 65 73 70 65 63 74 20 74 68 65 .responsibilities.to.respect.the
23ae0 20 66 72 65 65 64 6f 6d 20 6f 66 20 6f 74 68 65 72 73 2e 0a 0a 20 20 20 46 6f 72 20 65 78 61 6d .freedom.of.others......For.exam
23b00 70 6c 65 2c 20 69 66 20 79 6f 75 20 64 69 73 74 72 69 62 75 74 65 20 63 6f 70 69 65 73 20 6f 66 ple,.if.you.distribute.copies.of
23b20 20 73 75 63 68 20 61 20 70 72 6f 67 72 61 6d 2c 20 77 68 65 74 68 65 72 0a 67 72 61 74 69 73 20 .such.a.program,.whether.gratis.
23b40 6f 72 20 66 6f 72 20 61 20 66 65 65 2c 20 79 6f 75 20 6d 75 73 74 20 70 61 73 73 20 6f 6e 20 74 or.for.a.fee,.you.must.pass.on.t
23b60 6f 20 74 68 65 20 72 65 63 69 70 69 65 6e 74 73 20 74 68 65 20 73 61 6d 65 0a 66 72 65 65 64 6f o.the.recipients.the.same.freedo
23b80 6d 73 20 74 68 61 74 20 79 6f 75 20 72 65 63 65 69 76 65 64 2e 20 20 59 6f 75 20 6d 75 73 74 20 ms.that.you.received...You.must.
23ba0 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65 79 2c 20 74 6f 6f 2c 20 72 65 63 65 69 76 make.sure.that.they,.too,.receiv
23bc0 65 0a 6f 72 20 63 61 6e 20 67 65 74 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 41 e.or.can.get.the.source.code...A
23be0 6e 64 20 79 6f 75 20 6d 75 73 74 20 73 68 6f 77 20 74 68 65 6d 20 74 68 65 73 65 20 74 65 72 6d nd.you.must.show.them.these.term
23c00 73 20 73 6f 20 74 68 65 79 0a 6b 6e 6f 77 20 74 68 65 69 72 20 72 69 67 68 74 73 2e 0a 0a 20 20 s.so.they.know.their.rights.....
23c20 20 44 65 76 65 6c 6f 70 65 72 73 20 74 68 61 74 20 75 73 65 20 74 68 65 20 47 4e 55 20 47 50 4c .Developers.that.use.the.GNU.GPL
23c40 20 70 72 6f 74 65 63 74 20 79 6f 75 72 20 72 69 67 68 74 73 20 77 69 74 68 20 74 77 6f 20 73 74 .protect.your.rights.with.two.st
23c60 65 70 73 3a 0a 28 31 29 20 61 73 73 65 72 74 20 63 6f 70 79 72 69 67 68 74 20 6f 6e 20 74 68 65 eps:.(1).assert.copyright.on.the
23c80 20 73 6f 66 74 77 61 72 65 2c 20 61 6e 64 20 28 32 29 20 6f 66 66 65 72 20 79 6f 75 20 74 68 69 .software,.and.(2).offer.you.thi
23ca0 73 20 4c 69 63 65 6e 73 65 0a 67 69 76 69 6e 67 20 79 6f 75 20 6c 65 67 61 6c 20 70 65 72 6d 69 s.License.giving.you.legal.permi
23cc0 73 73 69 6f 6e 20 74 6f 20 63 6f 70 79 2c 20 64 69 73 74 72 69 62 75 74 65 20 61 6e 64 2f 6f 72 ssion.to.copy,.distribute.and/or
23ce0 20 6d 6f 64 69 66 79 20 69 74 2e 0a 0a 20 20 20 46 6f 72 20 74 68 65 20 64 65 76 65 6c 6f 70 65 .modify.it......For.the.develope
23d00 72 73 e2 80 99 20 61 6e 64 20 61 75 74 68 6f 72 73 e2 80 99 20 70 72 6f 74 65 63 74 69 6f 6e 2c rs....and.authors....protection,
23d20 20 74 68 65 20 47 50 4c 20 63 6c 65 61 72 6c 79 20 65 78 70 6c 61 69 6e 73 0a 74 68 61 74 20 74 .the.GPL.clearly.explains.that.t
23d40 68 65 72 65 20 69 73 20 6e 6f 20 77 61 72 72 61 6e 74 79 20 66 6f 72 20 74 68 69 73 20 66 72 65 here.is.no.warranty.for.this.fre
23d60 65 20 73 6f 66 74 77 61 72 65 2e 20 20 46 6f 72 20 62 6f 74 68 20 75 73 65 72 73 e2 80 99 20 61 e.software...For.both.users....a
23d80 6e 64 0a 61 75 74 68 6f 72 73 e2 80 99 20 73 61 6b 65 2c 20 74 68 65 20 47 50 4c 20 72 65 71 75 nd.authors....sake,.the.GPL.requ
23da0 69 72 65 73 20 74 68 61 74 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 6f 6e 73 20 62 65 20 6d ires.that.modified.versions.be.m
23dc0 61 72 6b 65 64 20 61 73 0a 63 68 61 6e 67 65 64 2c 20 73 6f 20 74 68 61 74 20 74 68 65 69 72 20 arked.as.changed,.so.that.their.
23de0 70 72 6f 62 6c 65 6d 73 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 74 74 72 69 62 75 74 65 64 20 problems.will.not.be.attributed.
23e00 65 72 72 6f 6e 65 6f 75 73 6c 79 20 74 6f 0a 61 75 74 68 6f 72 73 20 6f 66 20 70 72 65 76 69 6f erroneously.to.authors.of.previo
23e20 75 73 20 76 65 72 73 69 6f 6e 73 2e 0a 0a 20 20 20 53 6f 6d 65 20 64 65 76 69 63 65 73 20 61 72 us.versions......Some.devices.ar
23e40 65 20 64 65 73 69 67 6e 65 64 20 74 6f 20 64 65 6e 79 20 75 73 65 72 73 20 61 63 63 65 73 73 20 e.designed.to.deny.users.access.
23e60 74 6f 20 69 6e 73 74 61 6c 6c 20 6f 72 20 72 75 6e 0a 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 to.install.or.run.modified.versi
23e80 6f 6e 73 20 6f 66 20 74 68 65 20 73 6f 66 74 77 61 72 65 20 69 6e 73 69 64 65 20 74 68 65 6d 2c ons.of.the.software.inside.them,
23ea0 20 61 6c 74 68 6f 75 67 68 20 74 68 65 20 6d 61 6e 75 66 61 63 74 75 72 65 72 0a 63 61 6e 20 64 .although.the.manufacturer.can.d
23ec0 6f 20 73 6f 2e 20 20 54 68 69 73 20 69 73 20 66 75 6e 64 61 6d 65 6e 74 61 6c 6c 79 20 69 6e 63 o.so...This.is.fundamentally.inc
23ee0 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20 74 68 65 20 61 69 6d 20 6f 66 0a 70 72 6f 74 65 63 ompatible.with.the.aim.of.protec
23f00 74 69 6e 67 20 75 73 65 72 73 e2 80 99 20 66 72 65 65 64 6f 6d 20 74 6f 20 63 68 61 6e 67 65 20 ting.users....freedom.to.change.
23f20 74 68 65 20 73 6f 66 74 77 61 72 65 2e 20 20 54 68 65 20 73 79 73 74 65 6d 61 74 69 63 0a 70 61 the.software...The.systematic.pa
23f40 74 74 65 72 6e 20 6f 66 20 73 75 63 68 20 61 62 75 73 65 20 6f 63 63 75 72 73 20 69 6e 20 74 68 ttern.of.such.abuse.occurs.in.th
23f60 65 20 61 72 65 61 20 6f 66 20 70 72 6f 64 75 63 74 73 20 66 6f 72 20 69 6e 64 69 76 69 64 75 61 e.area.of.products.for.individua
23f80 6c 73 20 74 6f 0a 75 73 65 2c 20 77 68 69 63 68 20 69 73 20 70 72 65 63 69 73 65 6c 79 20 77 68 ls.to.use,.which.is.precisely.wh
23fa0 65 72 65 20 69 74 20 69 73 20 6d 6f 73 74 20 75 6e 61 63 63 65 70 74 61 62 6c 65 2e 20 20 54 68 ere.it.is.most.unacceptable...Th
23fc0 65 72 65 66 6f 72 65 2c 20 77 65 0a 68 61 76 65 20 64 65 73 69 67 6e 65 64 20 74 68 69 73 20 76 erefore,.we.have.designed.this.v
23fe0 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 47 50 4c 20 74 6f 20 70 72 6f 68 69 62 69 74 20 74 68 ersion.of.the.GPL.to.prohibit.th
24000 65 20 70 72 61 63 74 69 63 65 20 66 6f 72 20 74 68 6f 73 65 0a 70 72 6f 64 75 63 74 73 2e 20 20 e.practice.for.those.products...
24020 49 66 20 73 75 63 68 20 70 72 6f 62 6c 65 6d 73 20 61 72 69 73 65 20 73 75 62 73 74 61 6e 74 69 If.such.problems.arise.substanti
24040 61 6c 6c 79 20 69 6e 20 6f 74 68 65 72 20 64 6f 6d 61 69 6e 73 2c 20 77 65 0a 73 74 61 6e 64 20 ally.in.other.domains,.we.stand.
24060 72 65 61 64 79 20 74 6f 20 65 78 74 65 6e 64 20 74 68 69 73 20 70 72 6f 76 69 73 69 6f 6e 20 74 ready.to.extend.this.provision.t
24080 6f 20 74 68 6f 73 65 20 64 6f 6d 61 69 6e 73 20 69 6e 20 66 75 74 75 72 65 20 76 65 72 73 69 6f o.those.domains.in.future.versio
240a0 6e 73 0a 6f 66 20 74 68 65 20 47 50 4c 2c 20 61 73 20 6e 65 65 64 65 64 20 74 6f 20 70 72 6f 74 ns.of.the.GPL,.as.needed.to.prot
240c0 65 63 74 20 74 68 65 20 66 72 65 65 64 6f 6d 20 6f 66 20 75 73 65 72 73 2e 0a 0a 20 20 20 46 69 ect.the.freedom.of.users......Fi
240e0 6e 61 6c 6c 79 2c 20 65 76 65 72 79 20 70 72 6f 67 72 61 6d 20 69 73 20 74 68 72 65 61 74 65 6e nally,.every.program.is.threaten
24100 65 64 20 63 6f 6e 73 74 61 6e 74 6c 79 20 62 79 20 73 6f 66 74 77 61 72 65 20 70 61 74 65 6e 74 ed.constantly.by.software.patent
24120 73 2e 0a 53 74 61 74 65 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 61 6c 6c 6f 77 20 70 61 74 65 6e s..States.should.not.allow.paten
24140 74 73 20 74 6f 20 72 65 73 74 72 69 63 74 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 61 6e 64 20 75 ts.to.restrict.development.and.u
24160 73 65 20 6f 66 0a 73 6f 66 74 77 61 72 65 20 6f 6e 20 67 65 6e 65 72 61 6c 2d 70 75 72 70 6f 73 se.of.software.on.general-purpos
24180 65 20 63 6f 6d 70 75 74 65 72 73 2c 20 62 75 74 20 69 6e 20 74 68 6f 73 65 20 74 68 61 74 20 64 e.computers,.but.in.those.that.d
241a0 6f 2c 20 77 65 20 77 69 73 68 20 74 6f 0a 61 76 6f 69 64 20 74 68 65 20 73 70 65 63 69 61 6c 20 o,.we.wish.to.avoid.the.special.
241c0 64 61 6e 67 65 72 20 74 68 61 74 20 70 61 74 65 6e 74 73 20 61 70 70 6c 69 65 64 20 74 6f 20 61 danger.that.patents.applied.to.a
241e0 20 66 72 65 65 20 70 72 6f 67 72 61 6d 20 63 6f 75 6c 64 0a 6d 61 6b 65 20 69 74 20 65 66 66 65 .free.program.could.make.it.effe
24200 63 74 69 76 65 6c 79 20 70 72 6f 70 72 69 65 74 61 72 79 2e 20 20 54 6f 20 70 72 65 76 65 6e 74 ctively.proprietary...To.prevent
24220 20 74 68 69 73 2c 20 74 68 65 20 47 50 4c 20 61 73 73 75 72 65 73 20 74 68 61 74 0a 70 61 74 65 .this,.the.GPL.assures.that.pate
24240 6e 74 73 20 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 6e 64 65 72 20 74 68 65 nts.cannot.be.used.to.render.the
24260 20 70 72 6f 67 72 61 6d 20 6e 6f 6e 2d 66 72 65 65 2e 0a 0a 20 20 20 54 68 65 20 70 72 65 63 69 .program.non-free......The.preci
24280 73 65 20 74 65 72 6d 73 20 61 6e 64 20 63 6f 6e 64 69 74 69 6f 6e 73 20 66 6f 72 20 63 6f 70 79 se.terms.and.conditions.for.copy
242a0 69 6e 67 2c 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 61 6e 64 0a 6d 6f 64 69 66 69 63 61 74 69 ing,.distribution.and.modificati
242c0 6f 6e 20 66 6f 6c 6c 6f 77 2e 0a 0a 54 45 52 4d 53 20 41 4e 44 20 43 4f 4e 44 49 54 49 4f 4e 53 on.follow...TERMS.AND.CONDITIONS
242e0 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 30 2e 20 44 65 66 69 .====================....0..Defi
24300 6e 69 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 e2 80 9c 54 68 69 73 20 4c 69 63 65 6e 73 65 e2 80 nitions...........This.License..
24320 9d 20 72 65 66 65 72 73 20 74 6f 20 76 65 72 73 69 6f 6e 20 33 20 6f 66 20 74 68 65 20 47 4e 55 ..refers.to.version.3.of.the.GNU
24340 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 2e 0a 0a 20 .General.Public......License....
24360 20 20 20 20 e2 80 9c 43 6f 70 79 72 69 67 68 74 e2 80 9d 20 61 6c 73 6f 20 6d 65 61 6e 73 20 63 .......Copyright....also.means.c
24380 6f 70 79 72 69 67 68 74 2d 6c 69 6b 65 20 6c 61 77 73 20 74 68 61 74 20 61 70 70 6c 79 20 74 6f opyright-like.laws.that.apply.to
243a0 20 6f 74 68 65 72 0a 20 20 20 20 20 6b 69 6e 64 73 20 6f 66 20 77 6f 72 6b 73 2c 20 73 75 63 68 .other......kinds.of.works,.such
243c0 20 61 73 20 73 65 6d 69 63 6f 6e 64 75 63 74 6f 72 20 6d 61 73 6b 73 2e 0a 0a 20 20 20 20 20 e2 .as.semiconductor.masks.........
243e0 80 9c 54 68 65 20 50 72 6f 67 72 61 6d e2 80 9d 20 72 65 66 65 72 73 20 74 6f 20 61 6e 79 20 63 ..The.Program....refers.to.any.c
24400 6f 70 79 72 69 67 68 74 61 62 6c 65 20 77 6f 72 6b 20 6c 69 63 65 6e 73 65 64 20 75 6e 64 65 72 opyrightable.work.licensed.under
24420 20 74 68 69 73 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 2e 20 20 45 61 63 68 20 6c 69 63 65 6e 73 .this......License...Each.licens
24440 65 65 20 69 73 20 61 64 64 72 65 73 73 65 64 20 61 73 20 e2 80 9c 79 6f 75 e2 80 9d 2e 20 20 e2 ee.is.addressed.as....you.......
24460 80 9c 4c 69 63 65 6e 73 65 65 73 e2 80 9d 20 61 6e 64 0a 20 20 20 20 20 e2 80 9c 72 65 63 69 70 ..Licensees....and.........recip
24480 69 65 6e 74 73 e2 80 9d 20 6d 61 79 20 62 65 20 69 6e 64 69 76 69 64 75 61 6c 73 20 6f 72 20 6f ients....may.be.individuals.or.o
244a0 72 67 61 6e 69 7a 61 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 54 6f 20 e2 80 9c 6d 6f 64 69 66 79 rganizations........To....modify
244c0 e2 80 9d 20 61 20 77 6f 72 6b 20 6d 65 61 6e 73 20 74 6f 20 63 6f 70 79 20 66 72 6f 6d 20 6f 72 ....a.work.means.to.copy.from.or
244e0 20 61 64 61 70 74 20 61 6c 6c 20 6f 72 20 70 61 72 74 20 6f 66 20 74 68 65 0a 20 20 20 20 20 77 .adapt.all.or.part.of.the......w
24500 6f 72 6b 20 69 6e 20 61 20 66 61 73 68 69 6f 6e 20 72 65 71 75 69 72 69 6e 67 20 63 6f 70 79 72 ork.in.a.fashion.requiring.copyr
24520 69 67 68 74 20 70 65 72 6d 69 73 73 69 6f 6e 2c 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 65 0a ight.permission,.other.than.the.
24540 20 20 20 20 20 6d 61 6b 69 6e 67 20 6f 66 20 61 6e 20 65 78 61 63 74 20 63 6f 70 79 2e 20 20 54 .....making.of.an.exact.copy...T
24560 68 65 20 72 65 73 75 6c 74 69 6e 67 20 77 6f 72 6b 20 69 73 20 63 61 6c 6c 65 64 20 61 20 e2 80 he.resulting.work.is.called.a...
24580 9c 6d 6f 64 69 66 69 65 64 0a 20 20 20 20 20 76 65 72 73 69 6f 6e e2 80 9d 20 6f 66 20 74 68 65 .modified......version....of.the
245a0 20 65 61 72 6c 69 65 72 20 77 6f 72 6b 20 6f 72 20 61 20 77 6f 72 6b 20 e2 80 9c 62 61 73 65 64 .earlier.work.or.a.work....based
245c0 20 6f 6e e2 80 9d 20 74 68 65 20 65 61 72 6c 69 65 72 20 77 6f 72 6b 2e 0a 0a 20 20 20 20 20 41 .on....the.earlier.work........A
245e0 20 e2 80 9c 63 6f 76 65 72 65 64 20 77 6f 72 6b e2 80 9d 20 6d 65 61 6e 73 20 65 69 74 68 65 72 ....covered.work....means.either
24600 20 74 68 65 20 75 6e 6d 6f 64 69 66 69 65 64 20 50 72 6f 67 72 61 6d 20 6f 72 20 61 20 77 6f 72 .the.unmodified.Program.or.a.wor
24620 6b 0a 20 20 20 20 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 50 72 6f 67 72 61 6d 2e 0a 0a 20 20 k......based.on.the.Program.....
24640 20 20 20 54 6f 20 e2 80 9c 70 72 6f 70 61 67 61 74 65 e2 80 9d 20 61 20 77 6f 72 6b 20 6d 65 61 ...To....propagate....a.work.mea
24660 6e 73 20 74 6f 20 64 6f 20 61 6e 79 74 68 69 6e 67 20 77 69 74 68 20 69 74 20 74 68 61 74 2c 20 ns.to.do.anything.with.it.that,.
24680 77 69 74 68 6f 75 74 0a 20 20 20 20 20 70 65 72 6d 69 73 73 69 6f 6e 2c 20 77 6f 75 6c 64 20 6d without......permission,.would.m
246a0 61 6b 65 20 79 6f 75 20 64 69 72 65 63 74 6c 79 20 6f 72 20 73 65 63 6f 6e 64 61 72 69 6c 79 20 ake.you.directly.or.secondarily.
246c0 6c 69 61 62 6c 65 20 66 6f 72 0a 20 20 20 20 20 69 6e 66 72 69 6e 67 65 6d 65 6e 74 20 75 6e 64 liable.for......infringement.und
246e0 65 72 20 61 70 70 6c 69 63 61 62 6c 65 20 63 6f 70 79 72 69 67 68 74 20 6c 61 77 2c 20 65 78 63 er.applicable.copyright.law,.exc
24700 65 70 74 20 65 78 65 63 75 74 69 6e 67 20 69 74 20 6f 6e 0a 20 20 20 20 20 61 20 63 6f 6d 70 75 ept.executing.it.on......a.compu
24720 74 65 72 20 6f 72 20 6d 6f 64 69 66 79 69 6e 67 20 61 20 70 72 69 76 61 74 65 20 63 6f 70 79 2e ter.or.modifying.a.private.copy.
24740 20 20 50 72 6f 70 61 67 61 74 69 6f 6e 20 69 6e 63 6c 75 64 65 73 0a 20 20 20 20 20 63 6f 70 79 ..Propagation.includes......copy
24760 69 6e 67 2c 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 28 77 69 74 68 20 6f 72 20 77 69 74 68 6f ing,.distribution.(with.or.witho
24780 75 74 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 29 2c 20 6d 61 6b 69 6e 67 0a 20 20 20 20 20 61 76 ut.modification),.making......av
247a0 61 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 70 75 62 6c 69 63 2c 20 61 6e 64 20 69 6e 20 73 6f ailable.to.the.public,.and.in.so
247c0 6d 65 20 63 6f 75 6e 74 72 69 65 73 20 6f 74 68 65 72 20 61 63 74 69 76 69 74 69 65 73 20 61 73 me.countries.other.activities.as
247e0 0a 20 20 20 20 20 77 65 6c 6c 2e 0a 0a 20 20 20 20 20 54 6f 20 e2 80 9c 63 6f 6e 76 65 79 e2 80 ......well........To....convey..
24800 9d 20 61 20 77 6f 72 6b 20 6d 65 61 6e 73 20 61 6e 79 20 6b 69 6e 64 20 6f 66 20 70 72 6f 70 61 ..a.work.means.any.kind.of.propa
24820 67 61 74 69 6f 6e 20 74 68 61 74 20 65 6e 61 62 6c 65 73 20 6f 74 68 65 72 0a 20 20 20 20 20 70 gation.that.enables.other......p
24840 61 72 74 69 65 73 20 74 6f 20 6d 61 6b 65 20 6f 72 20 72 65 63 65 69 76 65 20 63 6f 70 69 65 73 arties.to.make.or.receive.copies
24860 2e 20 20 4d 65 72 65 20 69 6e 74 65 72 61 63 74 69 6f 6e 20 77 69 74 68 20 61 20 75 73 65 72 0a ...Mere.interaction.with.a.user.
24880 20 20 20 20 20 74 68 72 6f 75 67 68 20 61 20 63 6f 6d 70 75 74 65 72 20 6e 65 74 77 6f 72 6b 2c .....through.a.computer.network,
248a0 20 77 69 74 68 20 6e 6f 20 74 72 61 6e 73 66 65 72 20 6f 66 20 61 20 63 6f 70 79 2c 20 69 73 20 .with.no.transfer.of.a.copy,.is.
248c0 6e 6f 74 0a 20 20 20 20 20 63 6f 6e 76 65 79 69 6e 67 2e 0a 0a 20 20 20 20 20 41 6e 20 69 6e 74 not......conveying........An.int
248e0 65 72 61 63 74 69 76 65 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 20 64 69 73 70 6c 61 79 73 eractive.user.interface.displays
24900 20 e2 80 9c 41 70 70 72 6f 70 72 69 61 74 65 20 4c 65 67 61 6c 20 4e 6f 74 69 63 65 73 e2 80 9d ....Appropriate.Legal.Notices...
24920 0a 20 20 20 20 20 74 6f 20 74 68 65 20 65 78 74 65 6e 74 20 74 68 61 74 20 69 74 20 69 6e 63 6c ......to.the.extent.that.it.incl
24940 75 64 65 73 20 61 20 63 6f 6e 76 65 6e 69 65 6e 74 20 61 6e 64 20 70 72 6f 6d 69 6e 65 6e 74 6c udes.a.convenient.and.prominentl
24960 79 20 76 69 73 69 62 6c 65 0a 20 20 20 20 20 66 65 61 74 75 72 65 20 74 68 61 74 20 28 31 29 20 y.visible......feature.that.(1).
24980 64 69 73 70 6c 61 79 73 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 6f 70 79 72 69 67 68 displays.an.appropriate.copyrigh
249a0 74 20 6e 6f 74 69 63 65 2c 20 61 6e 64 20 28 32 29 0a 20 20 20 20 20 74 65 6c 6c 73 20 74 68 65 t.notice,.and.(2)......tells.the
249c0 20 75 73 65 72 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61 72 72 61 6e 74 79 20 .user.that.there.is.no.warranty.
249e0 66 6f 72 20 74 68 65 20 77 6f 72 6b 20 28 65 78 63 65 70 74 20 74 6f 0a 20 20 20 20 20 74 68 65 for.the.work.(except.to......the
24a00 20 65 78 74 65 6e 74 20 74 68 61 74 20 77 61 72 72 61 6e 74 69 65 73 20 61 72 65 20 70 72 6f 76 .extent.that.warranties.are.prov
24a20 69 64 65 64 29 2c 20 74 68 61 74 20 6c 69 63 65 6e 73 65 65 73 20 6d 61 79 20 63 6f 6e 76 65 79 ided),.that.licensees.may.convey
24a40 0a 20 20 20 20 20 74 68 65 20 77 6f 72 6b 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 65 6e 73 ......the.work.under.this.Licens
24a60 65 2c 20 61 6e 64 20 68 6f 77 20 74 6f 20 76 69 65 77 20 61 20 63 6f 70 79 20 6f 66 20 74 68 69 e,.and.how.to.view.a.copy.of.thi
24a80 73 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 2e 20 20 49 66 20 74 68 65 20 69 6e 74 65 72 66 61 63 s......License...If.the.interfac
24aa0 65 20 70 72 65 73 65 6e 74 73 20 61 20 6c 69 73 74 20 6f 66 20 75 73 65 72 20 63 6f 6d 6d 61 6e e.presents.a.list.of.user.comman
24ac0 64 73 20 6f 72 0a 20 20 20 20 20 6f 70 74 69 6f 6e 73 2c 20 73 75 63 68 20 61 73 20 61 20 6d 65 ds.or......options,.such.as.a.me
24ae0 6e 75 2c 20 61 20 70 72 6f 6d 69 6e 65 6e 74 20 69 74 65 6d 20 69 6e 20 74 68 65 20 6c 69 73 74 nu,.a.prominent.item.in.the.list
24b00 20 6d 65 65 74 73 20 74 68 69 73 0a 20 20 20 20 20 63 72 69 74 65 72 69 6f 6e 2e 0a 0a 20 20 31 .meets.this......criterion.....1
24b20 2e 20 53 6f 75 72 63 65 20 43 6f 64 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 e2 80 9c 73 6f 75 72 ..Source.Code........The....sour
24b40 63 65 20 63 6f 64 65 e2 80 9d 20 66 6f 72 20 61 20 77 6f 72 6b 20 6d 65 61 6e 73 20 74 68 65 20 ce.code....for.a.work.means.the.
24b60 70 72 65 66 65 72 72 65 64 20 66 6f 72 6d 20 6f 66 20 74 68 65 20 77 6f 72 6b 0a 20 20 20 20 20 preferred.form.of.the.work......
24b80 66 6f 72 20 6d 61 6b 69 6e 67 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 74 6f 20 69 74 2e 20 for.making.modifications.to.it..
24ba0 20 e2 80 9c 4f 62 6a 65 63 74 20 63 6f 64 65 e2 80 9d 20 6d 65 61 6e 73 20 61 6e 79 20 6e 6f 6e ....Object.code....means.any.non
24bc0 2d 73 6f 75 72 63 65 0a 20 20 20 20 20 66 6f 72 6d 20 6f 66 20 61 20 77 6f 72 6b 2e 0a 0a 20 20 -source......form.of.a.work.....
24be0 20 20 20 41 20 e2 80 9c 53 74 61 6e 64 61 72 64 20 49 6e 74 65 72 66 61 63 65 e2 80 9d 20 6d 65 ...A....Standard.Interface....me
24c00 61 6e 73 20 61 6e 20 69 6e 74 65 72 66 61 63 65 20 74 68 61 74 20 65 69 74 68 65 72 20 69 73 20 ans.an.interface.that.either.is.
24c20 61 6e 0a 20 20 20 20 20 6f 66 66 69 63 69 61 6c 20 73 74 61 6e 64 61 72 64 20 64 65 66 69 6e 65 an......official.standard.define
24c40 64 20 62 79 20 61 20 72 65 63 6f 67 6e 69 7a 65 64 20 73 74 61 6e 64 61 72 64 73 20 62 6f 64 79 d.by.a.recognized.standards.body
24c60 2c 20 6f 72 2c 20 69 6e 0a 20 20 20 20 20 74 68 65 20 63 61 73 65 20 6f 66 20 69 6e 74 65 72 66 ,.or,.in......the.case.of.interf
24c80 61 63 65 73 20 73 70 65 63 69 66 69 65 64 20 66 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 aces.specified.for.a.particular.
24ca0 70 72 6f 67 72 61 6d 6d 69 6e 67 0a 20 20 20 20 20 6c 61 6e 67 75 61 67 65 2c 20 6f 6e 65 20 74 programming......language,.one.t
24cc0 68 61 74 20 69 73 20 77 69 64 65 6c 79 20 75 73 65 64 20 61 6d 6f 6e 67 20 64 65 76 65 6c 6f 70 hat.is.widely.used.among.develop
24ce0 65 72 73 20 77 6f 72 6b 69 6e 67 20 69 6e 20 74 68 61 74 0a 20 20 20 20 20 6c 61 6e 67 75 61 67 ers.working.in.that......languag
24d00 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 e2 80 9c 53 79 73 74 65 6d 20 4c 69 62 72 61 72 69 65 73 e........The....System.Libraries
24d20 e2 80 9d 20 6f 66 20 61 6e 20 65 78 65 63 75 74 61 62 6c 65 20 77 6f 72 6b 20 69 6e 63 6c 75 64 ....of.an.executable.work.includ
24d40 65 20 61 6e 79 74 68 69 6e 67 2c 0a 20 20 20 20 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 65 20 e.anything,......other.than.the.
24d60 77 6f 72 6b 20 61 73 20 61 20 77 68 6f 6c 65 2c 20 74 68 61 74 20 28 61 29 20 69 73 20 69 6e 63 work.as.a.whole,.that.(a).is.inc
24d80 6c 75 64 65 64 20 69 6e 20 74 68 65 20 6e 6f 72 6d 61 6c 0a 20 20 20 20 20 66 6f 72 6d 20 6f 66 luded.in.the.normal......form.of
24da0 20 70 61 63 6b 61 67 69 6e 67 20 61 20 4d 61 6a 6f 72 20 43 6f 6d 70 6f 6e 65 6e 74 2c 20 62 75 .packaging.a.Major.Component,.bu
24dc0 74 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f 66 20 74 68 61 74 0a 20 20 20 20 t.which.is.not.part.of.that.....
24de0 20 4d 61 6a 6f 72 20 43 6f 6d 70 6f 6e 65 6e 74 2c 20 61 6e 64 20 28 62 29 20 73 65 72 76 65 73 .Major.Component,.and.(b).serves
24e00 20 6f 6e 6c 79 20 74 6f 20 65 6e 61 62 6c 65 20 75 73 65 20 6f 66 20 74 68 65 20 77 6f 72 6b 20 .only.to.enable.use.of.the.work.
24e20 77 69 74 68 0a 20 20 20 20 20 74 68 61 74 20 4d 61 6a 6f 72 20 43 6f 6d 70 6f 6e 65 6e 74 2c 20 with......that.Major.Component,.
24e40 6f 72 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 53 74 61 6e 64 61 72 64 20 49 6e 74 65 72 or.to.implement.a.Standard.Inter
24e60 66 61 63 65 20 66 6f 72 0a 20 20 20 20 20 77 68 69 63 68 20 61 6e 20 69 6d 70 6c 65 6d 65 6e 74 face.for......which.an.implement
24e80 61 74 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 70 75 62 6c 69 63 ation.is.available.to.the.public
24ea0 20 69 6e 20 73 6f 75 72 63 65 20 63 6f 64 65 0a 20 20 20 20 20 66 6f 72 6d 2e 20 20 41 20 e2 80 .in.source.code......form...A...
24ec0 9c 4d 61 6a 6f 72 20 43 6f 6d 70 6f 6e 65 6e 74 e2 80 9d 2c 20 69 6e 20 74 68 69 73 20 63 6f 6e .Major.Component...,.in.this.con
24ee0 74 65 78 74 2c 20 6d 65 61 6e 73 20 61 20 6d 61 6a 6f 72 0a 20 20 20 20 20 65 73 73 65 6e 74 69 text,.means.a.major......essenti
24f00 61 6c 20 63 6f 6d 70 6f 6e 65 6e 74 20 28 6b 65 72 6e 65 6c 2c 20 77 69 6e 64 6f 77 20 73 79 73 al.component.(kernel,.window.sys
24f20 74 65 6d 2c 20 61 6e 64 20 73 6f 20 6f 6e 29 20 6f 66 20 74 68 65 0a 20 20 20 20 20 73 70 65 63 tem,.and.so.on).of.the......spec
24f40 69 66 69 63 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 28 69 66 20 61 6e 79 29 20 6f ific.operating.system.(if.any).o
24f60 6e 20 77 68 69 63 68 20 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 77 6f 72 6b 0a 20 20 20 20 n.which.the.executable.work.....
24f80 20 72 75 6e 73 2c 20 6f 72 20 61 20 63 6f 6d 70 69 6c 65 72 20 75 73 65 64 20 74 6f 20 70 72 6f .runs,.or.a.compiler.used.to.pro
24fa0 64 75 63 65 20 74 68 65 20 77 6f 72 6b 2c 20 6f 72 20 61 6e 20 6f 62 6a 65 63 74 20 63 6f 64 65 duce.the.work,.or.an.object.code
24fc0 0a 20 20 20 20 20 69 6e 74 65 72 70 72 65 74 65 72 20 75 73 65 64 20 74 6f 20 72 75 6e 20 69 74 ......interpreter.used.to.run.it
24fe0 2e 0a 0a 20 20 20 20 20 54 68 65 20 e2 80 9c 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 ........The....Corresponding.Sou
25000 72 63 65 e2 80 9d 20 66 6f 72 20 61 20 77 6f 72 6b 20 69 6e 20 6f 62 6a 65 63 74 20 63 6f 64 65 rce....for.a.work.in.object.code
25020 20 66 6f 72 6d 20 6d 65 61 6e 73 20 61 6c 6c 0a 20 20 20 20 20 74 68 65 20 73 6f 75 72 63 65 20 .form.means.all......the.source.
25040 63 6f 64 65 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 2c 20 69 6e 73 74 61 6c 6c code.needed.to.generate,.install
25060 2c 20 61 6e 64 20 28 66 6f 72 20 61 6e 20 65 78 65 63 75 74 61 62 6c 65 0a 20 20 20 20 20 77 6f ,.and.(for.an.executable......wo
25080 72 6b 29 20 72 75 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f 64 65 20 61 6e 64 20 74 6f 20 6d rk).run.the.object.code.and.to.m
250a0 6f 64 69 66 79 20 74 68 65 20 77 6f 72 6b 2c 20 69 6e 63 6c 75 64 69 6e 67 20 73 63 72 69 70 74 odify.the.work,.including.script
250c0 73 0a 20 20 20 20 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 6f 73 65 20 61 63 74 69 76 69 74 69 s......to.control.those.activiti
250e0 65 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 69 6e 63 6c 75 64 es...However,.it.does.not.includ
25100 65 20 74 68 65 0a 20 20 20 20 20 77 6f 72 6b e2 80 99 73 20 53 79 73 74 65 6d 20 4c 69 62 72 61 e.the......work...s.System.Libra
25120 72 69 65 73 2c 20 6f 72 20 67 65 6e 65 72 61 6c 2d 70 75 72 70 6f 73 65 20 74 6f 6f 6c 73 20 6f ries,.or.general-purpose.tools.o
25140 72 20 67 65 6e 65 72 61 6c 6c 79 0a 20 20 20 20 20 61 76 61 69 6c 61 62 6c 65 20 66 72 65 65 20 r.generally......available.free.
25160 70 72 6f 67 72 61 6d 73 20 77 68 69 63 68 20 61 72 65 20 75 73 65 64 20 75 6e 6d 6f 64 69 66 69 programs.which.are.used.unmodifi
25180 65 64 20 69 6e 20 70 65 72 66 6f 72 6d 69 6e 67 0a 20 20 20 20 20 74 68 6f 73 65 20 61 63 74 69 ed.in.performing......those.acti
251a0 76 69 74 69 65 73 20 62 75 74 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 20 70 61 72 74 20 6f 66 vities.but.which.are.not.part.of
251c0 20 74 68 65 20 77 6f 72 6b 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 20 20 20 20 20 43 6f .the.work...For.example,......Co
251e0 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 69 6e 63 6c 75 64 65 73 20 69 6e 74 65 rresponding.Source.includes.inte
25200 72 66 61 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 66 69 6c 65 73 20 61 73 73 6f 63 69 61 74 65 rface.definition.files.associate
25220 64 0a 20 20 20 20 20 77 69 74 68 20 73 6f 75 72 63 65 20 66 69 6c 65 73 20 66 6f 72 20 74 68 65 d......with.source.files.for.the
25240 20 77 6f 72 6b 2c 20 61 6e 64 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 6f 72 20 73 .work,.and.the.source.code.for.s
25260 68 61 72 65 64 0a 20 20 20 20 20 6c 69 62 72 61 72 69 65 73 20 61 6e 64 20 64 79 6e 61 6d 69 63 hared......libraries.and.dynamic
25280 61 6c 6c 79 20 6c 69 6e 6b 65 64 20 73 75 62 70 72 6f 67 72 61 6d 73 20 74 68 61 74 20 74 68 65 ally.linked.subprograms.that.the
252a0 20 77 6f 72 6b 20 69 73 0a 20 20 20 20 20 73 70 65 63 69 66 69 63 61 6c 6c 79 20 64 65 73 69 67 .work.is......specifically.desig
252c0 6e 65 64 20 74 6f 20 72 65 71 75 69 72 65 2c 20 73 75 63 68 20 61 73 20 62 79 20 69 6e 74 69 6d ned.to.require,.such.as.by.intim
252e0 61 74 65 20 64 61 74 61 0a 20 20 20 20 20 63 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 20 6f 72 20 63 ate.data......communication.or.c
25300 6f 6e 74 72 6f 6c 20 66 6c 6f 77 20 62 65 74 77 65 65 6e 20 74 68 6f 73 65 20 73 75 62 70 72 6f ontrol.flow.between.those.subpro
25320 67 72 61 6d 73 20 61 6e 64 20 6f 74 68 65 72 0a 20 20 20 20 20 70 61 72 74 73 20 6f 66 20 74 68 grams.and.other......parts.of.th
25340 65 20 77 6f 72 6b 2e 0a 0a 20 20 20 20 20 54 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 e.work........The.Corresponding.
25360 53 6f 75 72 63 65 20 6e 65 65 64 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 61 6e 79 74 68 69 6e 67 Source.need.not.include.anything
25380 20 74 68 61 74 20 75 73 65 72 73 20 63 61 6e 0a 20 20 20 20 20 72 65 67 65 6e 65 72 61 74 65 20 .that.users.can......regenerate.
253a0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 66 72 6f 6d 20 6f 74 68 65 72 20 70 61 72 74 73 20 6f automatically.from.other.parts.o
253c0 66 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 20 20 20 20 20 53 6f 75 72 63 65 2e f.the.Corresponding......Source.
253e0 0a 0a 20 20 20 20 20 54 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 .......The.Corresponding.Source.
25400 66 6f 72 20 61 20 77 6f 72 6b 20 69 6e 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 6f 72 6d 20 69 for.a.work.in.source.code.form.i
25420 73 20 74 68 61 74 0a 20 20 20 20 20 73 61 6d 65 20 77 6f 72 6b 2e 0a 0a 20 20 32 2e 20 42 61 73 s.that......same.work.....2..Bas
25440 69 63 20 50 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 41 6c 6c 20 72 69 67 68 74 73 ic.Permissions........All.rights
25460 20 67 72 61 6e 74 65 64 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 61 72 65 20 .granted.under.this.License.are.
25480 67 72 61 6e 74 65 64 20 66 6f 72 20 74 68 65 20 74 65 72 6d 20 6f 66 0a 20 20 20 20 20 63 6f 70 granted.for.the.term.of......cop
254a0 79 72 69 67 68 74 20 6f 6e 20 74 68 65 20 50 72 6f 67 72 61 6d 2c 20 61 6e 64 20 61 72 65 20 69 yright.on.the.Program,.and.are.i
254c0 72 72 65 76 6f 63 61 62 6c 65 20 70 72 6f 76 69 64 65 64 20 74 68 65 20 73 74 61 74 65 64 0a 20 rrevocable.provided.the.stated..
254e0 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 65 20 6d 65 74 2e 20 20 54 68 69 73 20 4c 69 ....conditions.are.met...This.Li
25500 63 65 6e 73 65 20 65 78 70 6c 69 63 69 74 6c 79 20 61 66 66 69 72 6d 73 20 79 6f 75 72 20 75 6e cense.explicitly.affirms.your.un
25520 6c 69 6d 69 74 65 64 0a 20 20 20 20 20 70 65 72 6d 69 73 73 69 6f 6e 20 74 6f 20 72 75 6e 20 74 limited......permission.to.run.t
25540 68 65 20 75 6e 6d 6f 64 69 66 69 65 64 20 50 72 6f 67 72 61 6d 2e 20 20 54 68 65 20 6f 75 74 70 he.unmodified.Program...The.outp
25560 75 74 20 66 72 6f 6d 20 72 75 6e 6e 69 6e 67 0a 20 20 20 20 20 61 20 63 6f 76 65 72 65 64 20 77 ut.from.running......a.covered.w
25580 6f 72 6b 20 69 73 20 63 6f 76 65 72 65 64 20 62 79 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 6f ork.is.covered.by.this.License.o
255a0 6e 6c 79 20 69 66 20 74 68 65 20 6f 75 74 70 75 74 2c 20 67 69 76 65 6e 0a 20 20 20 20 20 69 74 nly.if.the.output,.given......it
255c0 73 20 63 6f 6e 74 65 6e 74 2c 20 63 6f 6e 73 74 69 74 75 74 65 73 20 61 20 63 6f 76 65 72 65 64 s.content,.constitutes.a.covered
255e0 20 77 6f 72 6b 2e 20 20 54 68 69 73 20 4c 69 63 65 6e 73 65 20 61 63 6b 6e 6f 77 6c 65 64 67 65 .work...This.License.acknowledge
25600 73 0a 20 20 20 20 20 79 6f 75 72 20 72 69 67 68 74 73 20 6f 66 20 66 61 69 72 20 75 73 65 20 6f s......your.rights.of.fair.use.o
25620 72 20 6f 74 68 65 72 20 65 71 75 69 76 61 6c 65 6e 74 2c 20 61 73 20 70 72 6f 76 69 64 65 64 20 r.other.equivalent,.as.provided.
25640 62 79 0a 20 20 20 20 20 63 6f 70 79 72 69 67 68 74 20 6c 61 77 2e 0a 0a 20 20 20 20 20 59 6f 75 by......copyright.law........You
25660 20 6d 61 79 20 6d 61 6b 65 2c 20 72 75 6e 20 61 6e 64 20 70 72 6f 70 61 67 61 74 65 20 63 6f 76 .may.make,.run.and.propagate.cov
25680 65 72 65 64 20 77 6f 72 6b 73 20 74 68 61 74 20 79 6f 75 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20 ered.works.that.you.do.not......
256a0 63 6f 6e 76 65 79 2c 20 77 69 74 68 6f 75 74 20 63 6f 6e 64 69 74 69 6f 6e 73 20 73 6f 20 6c 6f convey,.without.conditions.so.lo
256c0 6e 67 20 61 73 20 79 6f 75 72 20 6c 69 63 65 6e 73 65 20 6f 74 68 65 72 77 69 73 65 0a 20 20 20 ng.as.your.license.otherwise....
256e0 20 20 72 65 6d 61 69 6e 73 20 69 6e 20 66 6f 72 63 65 2e 20 20 59 6f 75 20 6d 61 79 20 63 6f 6e ..remains.in.force...You.may.con
25700 76 65 79 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 73 20 74 6f 20 6f 74 68 65 72 73 20 66 6f 72 20 vey.covered.works.to.others.for.
25720 74 68 65 0a 20 20 20 20 20 73 6f 6c 65 20 70 75 72 70 6f 73 65 20 6f 66 20 68 61 76 69 6e 67 20 the......sole.purpose.of.having.
25740 74 68 65 6d 20 6d 61 6b 65 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 65 78 63 6c 75 73 69 76 them.make.modifications.exclusiv
25760 65 6c 79 20 66 6f 72 20 79 6f 75 2c 0a 20 20 20 20 20 6f 72 20 70 72 6f 76 69 64 65 20 79 6f 75 ely.for.you,......or.provide.you
25780 20 77 69 74 68 20 66 61 63 69 6c 69 74 69 65 73 20 66 6f 72 20 72 75 6e 6e 69 6e 67 20 74 68 6f .with.facilities.for.running.tho
257a0 73 65 20 77 6f 72 6b 73 2c 20 70 72 6f 76 69 64 65 64 0a 20 20 20 20 20 74 68 61 74 20 79 6f 75 se.works,.provided......that.you
257c0 20 63 6f 6d 70 6c 79 20 77 69 74 68 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 69 73 20 4c .comply.with.the.terms.of.this.L
257e0 69 63 65 6e 73 65 20 69 6e 20 63 6f 6e 76 65 79 69 6e 67 20 61 6c 6c 0a 20 20 20 20 20 6d 61 74 icense.in.conveying.all......mat
25800 65 72 69 61 6c 20 66 6f 72 20 77 68 69 63 68 20 79 6f 75 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 72 erial.for.which.you.do.not.contr
25820 6f 6c 20 63 6f 70 79 72 69 67 68 74 2e 20 20 54 68 6f 73 65 20 74 68 75 73 20 6d 61 6b 69 6e 67 ol.copyright...Those.thus.making
25840 0a 20 20 20 20 20 6f 72 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 ......or.running.the.covered.wor
25860 6b 73 20 66 6f 72 20 79 6f 75 20 6d 75 73 74 20 64 6f 20 73 6f 20 65 78 63 6c 75 73 69 76 65 6c ks.for.you.must.do.so.exclusivel
25880 79 20 6f 6e 20 79 6f 75 72 0a 20 20 20 20 20 62 65 68 61 6c 66 2c 20 75 6e 64 65 72 20 79 6f 75 y.on.your......behalf,.under.you
258a0 72 20 64 69 72 65 63 74 69 6f 6e 20 61 6e 64 20 63 6f 6e 74 72 6f 6c 2c 20 6f 6e 20 74 65 72 6d r.direction.and.control,.on.term
258c0 73 20 74 68 61 74 20 70 72 6f 68 69 62 69 74 0a 20 20 20 20 20 74 68 65 6d 20 66 72 6f 6d 20 6d s.that.prohibit......them.from.m
258e0 61 6b 69 6e 67 20 61 6e 79 20 63 6f 70 69 65 73 20 6f 66 20 79 6f 75 72 20 63 6f 70 79 72 69 67 aking.any.copies.of.your.copyrig
25900 68 74 65 64 20 6d 61 74 65 72 69 61 6c 20 6f 75 74 73 69 64 65 0a 20 20 20 20 20 74 68 65 69 72 hted.material.outside......their
25920 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 20 77 69 74 68 20 79 6f 75 2e 0a 0a 20 20 20 20 20 43 6f .relationship.with.you........Co
25940 6e 76 65 79 69 6e 67 20 75 6e 64 65 72 20 61 6e 79 20 6f 74 68 65 72 20 63 69 72 63 75 6d 73 74 nveying.under.any.other.circumst
25960 61 6e 63 65 73 20 69 73 20 70 65 72 6d 69 74 74 65 64 20 73 6f 6c 65 6c 79 20 75 6e 64 65 72 0a ances.is.permitted.solely.under.
25980 20 20 20 20 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 73 74 61 74 65 64 20 62 65 6c 6f 77 .....the.conditions.stated.below
259a0 2e 20 20 53 75 62 6c 69 63 65 6e 73 69 6e 67 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 3b 20 ...Sublicensing.is.not.allowed;.
259c0 73 65 63 74 69 6f 6e 0a 20 20 20 20 20 31 30 20 6d 61 6b 65 73 20 69 74 20 75 6e 6e 65 63 65 73 section......10.makes.it.unneces
259e0 73 61 72 79 2e 0a 0a 20 20 33 2e 20 50 72 6f 74 65 63 74 69 6e 67 20 55 73 65 72 73 e2 80 99 20 sary.....3..Protecting.Users....
25a00 4c 65 67 61 6c 20 52 69 67 68 74 73 20 46 72 6f 6d 20 41 6e 74 69 2d 43 69 72 63 75 6d 76 65 6e Legal.Rights.From.Anti-Circumven
25a20 74 69 6f 6e 20 4c 61 77 2e 0a 0a 20 20 20 20 20 4e 6f 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 tion.Law........No.covered.work.
25a40 73 68 61 6c 6c 20 62 65 20 64 65 65 6d 65 64 20 70 61 72 74 20 6f 66 20 61 6e 20 65 66 66 65 63 shall.be.deemed.part.of.an.effec
25a60 74 69 76 65 20 74 65 63 68 6e 6f 6c 6f 67 69 63 61 6c 0a 20 20 20 20 20 6d 65 61 73 75 72 65 20 tive.technological......measure.
25a80 75 6e 64 65 72 20 61 6e 79 20 61 70 70 6c 69 63 61 62 6c 65 20 6c 61 77 20 66 75 6c 66 69 6c 6c under.any.applicable.law.fulfill
25aa0 69 6e 67 20 6f 62 6c 69 67 61 74 69 6f 6e 73 20 75 6e 64 65 72 0a 20 20 20 20 20 61 72 74 69 63 ing.obligations.under......artic
25ac0 6c 65 20 31 31 20 6f 66 20 74 68 65 20 57 49 50 4f 20 63 6f 70 79 72 69 67 68 74 20 74 72 65 61 le.11.of.the.WIPO.copyright.trea
25ae0 74 79 20 61 64 6f 70 74 65 64 20 6f 6e 20 32 30 20 44 65 63 65 6d 62 65 72 0a 20 20 20 20 20 31 ty.adopted.on.20.December......1
25b00 39 39 36 2c 20 6f 72 20 73 69 6d 69 6c 61 72 20 6c 61 77 73 20 70 72 6f 68 69 62 69 74 69 6e 67 996,.or.similar.laws.prohibiting
25b20 20 6f 72 20 72 65 73 74 72 69 63 74 69 6e 67 20 63 69 72 63 75 6d 76 65 6e 74 69 6f 6e 20 6f 66 .or.restricting.circumvention.of
25b40 0a 20 20 20 20 20 73 75 63 68 20 6d 65 61 73 75 72 65 73 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 ......such.measures........When.
25b60 79 6f 75 20 63 6f 6e 76 65 79 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 2c 20 79 6f 75 20 77 you.convey.a.covered.work,.you.w
25b80 61 69 76 65 20 61 6e 79 20 6c 65 67 61 6c 20 70 6f 77 65 72 20 74 6f 20 66 6f 72 62 69 64 0a 20 aive.any.legal.power.to.forbid..
25ba0 20 20 20 20 63 69 72 63 75 6d 76 65 6e 74 69 6f 6e 20 6f 66 20 74 65 63 68 6e 6f 6c 6f 67 69 63 ....circumvention.of.technologic
25bc0 61 6c 20 6d 65 61 73 75 72 65 73 20 74 6f 20 74 68 65 20 65 78 74 65 6e 74 20 73 75 63 68 0a 20 al.measures.to.the.extent.such..
25be0 20 20 20 20 63 69 72 63 75 6d 76 65 6e 74 69 6f 6e 20 69 73 20 65 66 66 65 63 74 65 64 20 62 79 ....circumvention.is.effected.by
25c00 20 65 78 65 72 63 69 73 69 6e 67 20 72 69 67 68 74 73 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 .exercising.rights.under.this.Li
25c20 63 65 6e 73 65 0a 20 20 20 20 20 77 69 74 68 20 72 65 73 70 65 63 74 20 74 6f 20 74 68 65 20 63 cense......with.respect.to.the.c
25c40 6f 76 65 72 65 64 20 77 6f 72 6b 2c 20 61 6e 64 20 79 6f 75 20 64 69 73 63 6c 61 69 6d 20 61 6e overed.work,.and.you.disclaim.an
25c60 79 20 69 6e 74 65 6e 74 69 6f 6e 20 74 6f 0a 20 20 20 20 20 6c 69 6d 69 74 20 6f 70 65 72 61 74 y.intention.to......limit.operat
25c80 69 6f 6e 20 6f 72 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 77 6f 72 6b 20 ion.or.modification.of.the.work.
25ca0 61 73 20 61 20 6d 65 61 6e 73 20 6f 66 0a 20 20 20 20 20 65 6e 66 6f 72 63 69 6e 67 2c 20 61 67 as.a.means.of......enforcing,.ag
25cc0 61 69 6e 73 74 20 74 68 65 20 77 6f 72 6b e2 80 99 73 20 75 73 65 72 73 2c 20 79 6f 75 72 20 6f ainst.the.work...s.users,.your.o
25ce0 72 20 74 68 69 72 64 20 70 61 72 74 69 65 73 e2 80 99 20 6c 65 67 61 6c 0a 20 20 20 20 20 72 69 r.third.parties....legal......ri
25d00 67 68 74 73 20 74 6f 20 66 6f 72 62 69 64 20 63 69 72 63 75 6d 76 65 6e 74 69 6f 6e 20 6f 66 20 ghts.to.forbid.circumvention.of.
25d20 74 65 63 68 6e 6f 6c 6f 67 69 63 61 6c 20 6d 65 61 73 75 72 65 73 2e 0a 0a 20 20 34 2e 20 43 6f technological.measures.....4..Co
25d40 6e 76 65 79 69 6e 67 20 56 65 72 62 61 74 69 6d 20 43 6f 70 69 65 73 2e 0a 0a 20 20 20 20 20 59 nveying.Verbatim.Copies........Y
25d60 6f 75 20 6d 61 79 20 63 6f 6e 76 65 79 20 76 65 72 62 61 74 69 6d 20 63 6f 70 69 65 73 20 6f 66 ou.may.convey.verbatim.copies.of
25d80 20 74 68 65 20 50 72 6f 67 72 61 6d e2 80 99 73 20 73 6f 75 72 63 65 20 63 6f 64 65 20 61 73 20 .the.Program...s.source.code.as.
25da0 79 6f 75 0a 20 20 20 20 20 72 65 63 65 69 76 65 20 69 74 2c 20 69 6e 20 61 6e 79 20 6d 65 64 69 you......receive.it,.in.any.medi
25dc0 75 6d 2c 20 70 72 6f 76 69 64 65 64 20 74 68 61 74 20 79 6f 75 20 63 6f 6e 73 70 69 63 75 6f 75 um,.provided.that.you.conspicuou
25de0 73 6c 79 20 61 6e 64 0a 20 20 20 20 20 61 70 70 72 6f 70 72 69 61 74 65 6c 79 20 70 75 62 6c 69 sly.and......appropriately.publi
25e00 73 68 20 6f 6e 20 65 61 63 68 20 63 6f 70 79 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 sh.on.each.copy.an.appropriate.c
25e20 6f 70 79 72 69 67 68 74 20 6e 6f 74 69 63 65 3b 0a 20 20 20 20 20 6b 65 65 70 20 69 6e 74 61 63 opyright.notice;......keep.intac
25e40 74 20 61 6c 6c 20 6e 6f 74 69 63 65 73 20 73 74 61 74 69 6e 67 20 74 68 61 74 20 74 68 69 73 20 t.all.notices.stating.that.this.
25e60 4c 69 63 65 6e 73 65 20 61 6e 64 20 61 6e 79 0a 20 20 20 20 20 6e 6f 6e 2d 70 65 72 6d 69 73 73 License.and.any......non-permiss
25e80 69 76 65 20 74 65 72 6d 73 20 61 64 64 65 64 20 69 6e 20 61 63 63 6f 72 64 20 77 69 74 68 20 73 ive.terms.added.in.accord.with.s
25ea0 65 63 74 69 6f 6e 20 37 20 61 70 70 6c 79 20 74 6f 20 74 68 65 0a 20 20 20 20 20 63 6f 64 65 3b ection.7.apply.to.the......code;
25ec0 20 6b 65 65 70 20 69 6e 74 61 63 74 20 61 6c 6c 20 6e 6f 74 69 63 65 73 20 6f 66 20 74 68 65 20 .keep.intact.all.notices.of.the.
25ee0 61 62 73 65 6e 63 65 20 6f 66 20 61 6e 79 20 77 61 72 72 61 6e 74 79 3b 20 61 6e 64 0a 20 20 20 absence.of.any.warranty;.and....
25f00 20 20 67 69 76 65 20 61 6c 6c 20 72 65 63 69 70 69 65 6e 74 73 20 61 20 63 6f 70 79 20 6f 66 20 ..give.all.recipients.a.copy.of.
25f20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 20 50 72 6f 67 this.License.along.with.the.Prog
25f40 72 61 6d 2e 0a 0a 20 20 20 20 20 59 6f 75 20 6d 61 79 20 63 68 61 72 67 65 20 61 6e 79 20 70 72 ram........You.may.charge.any.pr
25f60 69 63 65 20 6f 72 20 6e 6f 20 70 72 69 63 65 20 66 6f 72 20 65 61 63 68 20 63 6f 70 79 20 74 68 ice.or.no.price.for.each.copy.th
25f80 61 74 20 79 6f 75 20 63 6f 6e 76 65 79 2c 0a 20 20 20 20 20 61 6e 64 20 79 6f 75 20 6d 61 79 20 at.you.convey,......and.you.may.
25fa0 6f 66 66 65 72 20 73 75 70 70 6f 72 74 20 6f 72 20 77 61 72 72 61 6e 74 79 20 70 72 6f 74 65 63 offer.support.or.warranty.protec
25fc0 74 69 6f 6e 20 66 6f 72 20 61 20 66 65 65 2e 0a 0a 20 20 35 2e 20 43 6f 6e 76 65 79 69 6e 67 20 tion.for.a.fee.....5..Conveying.
25fe0 4d 6f 64 69 66 69 65 64 20 53 6f 75 72 63 65 20 56 65 72 73 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 Modified.Source.Versions........
26000 59 6f 75 20 6d 61 79 20 63 6f 6e 76 65 79 20 61 20 77 6f 72 6b 20 62 61 73 65 64 20 6f 6e 20 74 You.may.convey.a.work.based.on.t
26020 68 65 20 50 72 6f 67 72 61 6d 2c 20 6f 72 20 74 68 65 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 he.Program,.or.the.modifications
26040 20 74 6f 0a 20 20 20 20 20 70 72 6f 64 75 63 65 20 69 74 20 66 72 6f 6d 20 74 68 65 20 50 72 6f .to......produce.it.from.the.Pro
26060 67 72 61 6d 2c 20 69 6e 20 74 68 65 20 66 6f 72 6d 20 6f 66 20 73 6f 75 72 63 65 20 63 6f 64 65 gram,.in.the.form.of.source.code
26080 20 75 6e 64 65 72 20 74 68 65 0a 20 20 20 20 20 74 65 72 6d 73 20 6f 66 20 73 65 63 74 69 6f 6e .under.the......terms.of.section
260a0 20 34 2c 20 70 72 6f 76 69 64 65 64 20 74 68 61 74 20 79 6f 75 20 61 6c 73 6f 20 6d 65 65 74 20 .4,.provided.that.you.also.meet.
260c0 61 6c 6c 20 6f 66 20 74 68 65 73 65 0a 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 73 3a 0a 0a 20 all.of.these......conditions:...
260e0 20 20 20 20 20 20 61 2e 20 54 68 65 20 77 6f 72 6b 20 6d 75 73 74 20 63 61 72 72 79 20 70 72 6f ......a..The.work.must.carry.pro
26100 6d 69 6e 65 6e 74 20 6e 6f 74 69 63 65 73 20 73 74 61 74 69 6e 67 20 74 68 61 74 20 79 6f 75 0a minent.notices.stating.that.you.
26120 20 20 20 20 20 20 20 20 20 20 6d 6f 64 69 66 69 65 64 20 69 74 2c 20 61 6e 64 20 67 69 76 69 6e ..........modified.it,.and.givin
26140 67 20 61 20 72 65 6c 65 76 61 6e 74 20 64 61 74 65 2e 0a 0a 20 20 20 20 20 20 20 62 2e 20 54 68 g.a.relevant.date..........b..Th
26160 65 20 77 6f 72 6b 20 6d 75 73 74 20 63 61 72 72 79 20 70 72 6f 6d 69 6e 65 6e 74 20 6e 6f 74 69 e.work.must.carry.prominent.noti
26180 63 65 73 20 73 74 61 74 69 6e 67 20 74 68 61 74 20 69 74 20 69 73 0a 20 20 20 20 20 20 20 20 20 ces.stating.that.it.is..........
261a0 20 72 65 6c 65 61 73 65 64 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 61 6e 64 .released.under.this.License.and
261c0 20 61 6e 79 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 64 64 65 64 20 75 6e 64 65 72 0a 20 20 20 20 .any.conditions.added.under.....
261e0 20 20 20 20 20 20 73 65 63 74 69 6f 6e 20 37 2e 20 20 54 68 69 73 20 72 65 71 75 69 72 65 6d 65 ......section.7...This.requireme
26200 6e 74 20 6d 6f 64 69 66 69 65 73 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 20 69 6e 0a 20 nt.modifies.the.requirement.in..
26220 20 20 20 20 20 20 20 20 20 73 65 63 74 69 6f 6e 20 34 20 74 6f 20 e2 80 9c 6b 65 65 70 20 69 6e .........section.4.to....keep.in
26240 74 61 63 74 20 61 6c 6c 20 6e 6f 74 69 63 65 73 e2 80 9d 2e 0a 0a 20 20 20 20 20 20 20 63 2e 20 tact.all.notices.............c..
26260 59 6f 75 20 6d 75 73 74 20 6c 69 63 65 6e 73 65 20 74 68 65 20 65 6e 74 69 72 65 20 77 6f 72 6b You.must.license.the.entire.work
26280 2c 20 61 73 20 61 20 77 68 6f 6c 65 2c 20 75 6e 64 65 72 20 74 68 69 73 0a 20 20 20 20 20 20 20 ,.as.a.whole,.under.this........
262a0 20 20 20 4c 69 63 65 6e 73 65 20 74 6f 20 61 6e 79 6f 6e 65 20 77 68 6f 20 63 6f 6d 65 73 20 69 ...License.to.anyone.who.comes.i
262c0 6e 74 6f 20 70 6f 73 73 65 73 73 69 6f 6e 20 6f 66 20 61 20 63 6f 70 79 2e 20 20 54 68 69 73 0a nto.possession.of.a.copy...This.
262e0 20 20 20 20 20 20 20 20 20 20 4c 69 63 65 6e 73 65 20 77 69 6c 6c 20 74 68 65 72 65 66 6f 72 65 ..........License.will.therefore
26300 20 61 70 70 6c 79 2c 20 61 6c 6f 6e 67 20 77 69 74 68 20 61 6e 79 20 61 70 70 6c 69 63 61 62 6c .apply,.along.with.any.applicabl
26320 65 0a 20 20 20 20 20 20 20 20 20 20 73 65 63 74 69 6f 6e 20 37 20 61 64 64 69 74 69 6f 6e 61 6c e...........section.7.additional
26340 20 74 65 72 6d 73 2c 20 74 6f 20 74 68 65 20 77 68 6f 6c 65 20 6f 66 20 74 68 65 20 77 6f 72 6b .terms,.to.the.whole.of.the.work
26360 2c 20 61 6e 64 20 61 6c 6c 0a 20 20 20 20 20 20 20 20 20 20 69 74 73 20 70 61 72 74 73 2c 20 72 ,.and.all...........its.parts,.r
26380 65 67 61 72 64 6c 65 73 73 20 6f 66 20 68 6f 77 20 74 68 65 79 20 61 72 65 20 70 61 63 6b 61 67 egardless.of.how.they.are.packag
263a0 65 64 2e 20 20 54 68 69 73 20 4c 69 63 65 6e 73 65 0a 20 20 20 20 20 20 20 20 20 20 67 69 76 65 ed...This.License...........give
263c0 73 20 6e 6f 20 70 65 72 6d 69 73 73 69 6f 6e 20 74 6f 20 6c 69 63 65 6e 73 65 20 74 68 65 20 77 s.no.permission.to.license.the.w
263e0 6f 72 6b 20 69 6e 20 61 6e 79 20 6f 74 68 65 72 20 77 61 79 2c 20 62 75 74 0a 20 20 20 20 20 20 ork.in.any.other.way,.but.......
26400 20 20 20 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 69 6e 76 61 6c 69 64 61 74 65 20 73 75 63 68 20 ....it.does.not.invalidate.such.
26420 70 65 72 6d 69 73 73 69 6f 6e 20 69 66 20 79 6f 75 20 68 61 76 65 20 73 65 70 61 72 61 74 65 6c permission.if.you.have.separatel
26440 79 0a 20 20 20 20 20 20 20 20 20 20 72 65 63 65 69 76 65 64 20 69 74 2e 0a 0a 20 20 20 20 20 20 y...........received.it.........
26460 20 64 2e 20 49 66 20 74 68 65 20 77 6f 72 6b 20 68 61 73 20 69 6e 74 65 72 61 63 74 69 76 65 20 .d..If.the.work.has.interactive.
26480 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 73 2c 20 65 61 63 68 20 6d 75 73 74 20 64 69 73 70 6c user.interfaces,.each.must.displ
264a0 61 79 0a 20 20 20 20 20 20 20 20 20 20 41 70 70 72 6f 70 72 69 61 74 65 20 4c 65 67 61 6c 20 4e ay...........Appropriate.Legal.N
264c0 6f 74 69 63 65 73 3b 20 68 6f 77 65 76 65 72 2c 20 69 66 20 74 68 65 20 50 72 6f 67 72 61 6d 20 otices;.however,.if.the.Program.
264e0 68 61 73 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 61 63 74 69 76 65 20 69 6e 74 65 72 66 has...........interactive.interf
26500 61 63 65 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 64 69 73 70 6c 61 79 20 41 70 70 72 6f 70 72 aces.that.do.not.display.Appropr
26520 69 61 74 65 20 4c 65 67 61 6c 0a 20 20 20 20 20 20 20 20 20 20 4e 6f 74 69 63 65 73 2c 20 79 6f iate.Legal...........Notices,.yo
26540 75 72 20 77 6f 72 6b 20 6e 65 65 64 20 6e 6f 74 20 6d 61 6b 65 20 74 68 65 6d 20 64 6f 20 73 6f ur.work.need.not.make.them.do.so
26560 2e 0a 0a 20 20 20 20 20 41 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 66 20 61 20 63 6f 76 65 72 ........A.compilation.of.a.cover
26580 65 64 20 77 6f 72 6b 20 77 69 74 68 20 6f 74 68 65 72 20 73 65 70 61 72 61 74 65 20 61 6e 64 20 ed.work.with.other.separate.and.
265a0 69 6e 64 65 70 65 6e 64 65 6e 74 0a 20 20 20 20 20 77 6f 72 6b 73 2c 20 77 68 69 63 68 20 61 72 independent......works,.which.ar
265c0 65 20 6e 6f 74 20 62 79 20 74 68 65 69 72 20 6e 61 74 75 72 65 20 65 78 74 65 6e 73 69 6f 6e 73 e.not.by.their.nature.extensions
265e0 20 6f 66 20 74 68 65 20 63 6f 76 65 72 65 64 0a 20 20 20 20 20 77 6f 72 6b 2c 20 61 6e 64 20 77 .of.the.covered......work,.and.w
26600 68 69 63 68 20 61 72 65 20 6e 6f 74 20 63 6f 6d 62 69 6e 65 64 20 77 69 74 68 20 69 74 20 73 75 hich.are.not.combined.with.it.su
26620 63 68 20 61 73 20 74 6f 20 66 6f 72 6d 20 61 20 6c 61 72 67 65 72 0a 20 20 20 20 20 70 72 6f 67 ch.as.to.form.a.larger......prog
26640 72 61 6d 2c 20 69 6e 20 6f 72 20 6f 6e 20 61 20 76 6f 6c 75 6d 65 20 6f 66 20 61 20 73 74 6f 72 ram,.in.or.on.a.volume.of.a.stor
26660 61 67 65 20 6f 72 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 6d 65 64 69 75 6d 2c 20 69 73 0a 20 age.or.distribution.medium,.is..
26680 20 20 20 20 63 61 6c 6c 65 64 20 61 6e 20 e2 80 9c 61 67 67 72 65 67 61 74 65 e2 80 9d 20 69 66 ....called.an....aggregate....if
266a0 20 74 68 65 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 61 6e 64 20 69 74 73 20 72 65 73 75 6c 74 69 .the.compilation.and.its.resulti
266c0 6e 67 0a 20 20 20 20 20 63 6f 70 79 72 69 67 68 74 20 61 72 65 20 6e 6f 74 20 75 73 65 64 20 74 ng......copyright.are.not.used.t
266e0 6f 20 6c 69 6d 69 74 20 74 68 65 20 61 63 63 65 73 73 20 6f 72 20 6c 65 67 61 6c 20 72 69 67 68 o.limit.the.access.or.legal.righ
26700 74 73 20 6f 66 20 74 68 65 0a 20 20 20 20 20 63 6f 6d 70 69 6c 61 74 69 6f 6e e2 80 99 73 20 75 ts.of.the......compilation...s.u
26720 73 65 72 73 20 62 65 79 6f 6e 64 20 77 68 61 74 20 74 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20 sers.beyond.what.the.individual.
26740 77 6f 72 6b 73 20 70 65 72 6d 69 74 2e 0a 20 20 20 20 20 49 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 works.permit.......Inclusion.of.
26760 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 69 6e 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 64 a.covered.work.in.an.aggregate.d
26780 6f 65 73 20 6e 6f 74 20 63 61 75 73 65 20 74 68 69 73 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 20 oes.not.cause.this......License.
267a0 74 6f 20 61 70 70 6c 79 20 74 6f 20 74 68 65 20 6f 74 68 65 72 20 70 61 72 74 73 20 6f 66 20 74 to.apply.to.the.other.parts.of.t
267c0 68 65 20 61 67 67 72 65 67 61 74 65 2e 0a 0a 20 20 36 2e 20 43 6f 6e 76 65 79 69 6e 67 20 4e 6f he.aggregate.....6..Conveying.No
267e0 6e 2d 53 6f 75 72 63 65 20 46 6f 72 6d 73 2e 0a 0a 20 20 20 20 20 59 6f 75 20 6d 61 79 20 63 6f n-Source.Forms........You.may.co
26800 6e 76 65 79 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 69 6e 20 6f 62 6a 65 63 74 20 63 6f nvey.a.covered.work.in.object.co
26820 64 65 20 66 6f 72 6d 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 0a 20 20 20 20 20 6f 66 20 de.form.under.the.terms......of.
26840 73 65 63 74 69 6f 6e 73 20 34 20 61 6e 64 20 35 2c 20 70 72 6f 76 69 64 65 64 20 74 68 61 74 20 sections.4.and.5,.provided.that.
26860 79 6f 75 20 61 6c 73 6f 20 63 6f 6e 76 65 79 20 74 68 65 0a 20 20 20 20 20 6d 61 63 68 69 6e 65 you.also.convey.the......machine
26880 2d 72 65 61 64 61 62 6c 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 75 -readable.Corresponding.Source.u
268a0 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 69 73 0a 20 20 20 20 20 4c 69 63 65 nder.the.terms.of.this......Lice
268c0 6e 73 65 2c 20 69 6e 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 77 61 79 73 3a 0a 0a 20 20 20 20 nse,.in.one.of.these.ways:......
268e0 20 20 20 61 2e 20 43 6f 6e 76 65 79 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f 64 65 20 69 6e 2c ...a..Convey.the.object.code.in,
26900 20 6f 72 20 65 6d 62 6f 64 69 65 64 20 69 6e 2c 20 61 20 70 68 79 73 69 63 61 6c 20 70 72 6f 64 .or.embodied.in,.a.physical.prod
26920 75 63 74 0a 20 20 20 20 20 20 20 20 20 20 28 69 6e 63 6c 75 64 69 6e 67 20 61 20 70 68 79 73 69 uct...........(including.a.physi
26940 63 61 6c 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 6d 65 64 69 75 6d 29 2c 20 61 63 63 6f 6d 70 cal.distribution.medium),.accomp
26960 61 6e 69 65 64 20 62 79 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 43 6f 72 72 65 73 70 6f 6e anied.by.the...........Correspon
26980 64 69 6e 67 20 53 6f 75 72 63 65 20 66 69 78 65 64 20 6f 6e 20 61 20 64 75 72 61 62 6c 65 20 70 ding.Source.fixed.on.a.durable.p
269a0 68 79 73 69 63 61 6c 20 6d 65 64 69 75 6d 0a 20 20 20 20 20 20 20 20 20 20 63 75 73 74 6f 6d 61 hysical.medium...........customa
269c0 72 69 6c 79 20 75 73 65 64 20 66 6f 72 20 73 6f 66 74 77 61 72 65 20 69 6e 74 65 72 63 68 61 6e rily.used.for.software.interchan
269e0 67 65 2e 0a 0a 20 20 20 20 20 20 20 62 2e 20 43 6f 6e 76 65 79 20 74 68 65 20 6f 62 6a 65 63 74 ge..........b..Convey.the.object
26a00 20 63 6f 64 65 20 69 6e 2c 20 6f 72 20 65 6d 62 6f 64 69 65 64 20 69 6e 2c 20 61 20 70 68 79 73 .code.in,.or.embodied.in,.a.phys
26a20 69 63 61 6c 20 70 72 6f 64 75 63 74 0a 20 20 20 20 20 20 20 20 20 20 28 69 6e 63 6c 75 64 69 6e ical.product...........(includin
26a40 67 20 61 20 70 68 79 73 69 63 61 6c 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 6d 65 64 69 75 6d g.a.physical.distribution.medium
26a60 29 2c 20 61 63 63 6f 6d 70 61 6e 69 65 64 20 62 79 20 61 0a 20 20 20 20 20 20 20 20 20 20 77 72 ),.accompanied.by.a...........wr
26a80 69 74 74 65 6e 20 6f 66 66 65 72 2c 20 76 61 6c 69 64 20 66 6f 72 20 61 74 20 6c 65 61 73 74 20 itten.offer,.valid.for.at.least.
26aa0 74 68 72 65 65 20 79 65 61 72 73 20 61 6e 64 20 76 61 6c 69 64 20 66 6f 72 20 61 73 0a 20 20 20 three.years.and.valid.for.as....
26ac0 20 20 20 20 20 20 20 6c 6f 6e 67 20 61 73 20 79 6f 75 20 6f 66 66 65 72 20 73 70 61 72 65 20 70 .......long.as.you.offer.spare.p
26ae0 61 72 74 73 20 6f 72 20 63 75 73 74 6f 6d 65 72 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 61 arts.or.customer.support.for.tha
26b00 74 0a 20 20 20 20 20 20 20 20 20 20 70 72 6f 64 75 63 74 20 6d 6f 64 65 6c 2c 20 74 6f 20 67 69 t...........product.model,.to.gi
26b20 76 65 20 61 6e 79 6f 6e 65 20 77 68 6f 20 70 6f 73 73 65 73 73 65 73 20 74 68 65 20 6f 62 6a 65 ve.anyone.who.possesses.the.obje
26b40 63 74 20 63 6f 64 65 0a 20 20 20 20 20 20 20 20 20 20 65 69 74 68 65 72 20 28 31 29 20 61 20 63 ct.code...........either.(1).a.c
26b60 6f 70 79 20 6f 66 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 opy.of.the.Corresponding.Source.
26b80 66 6f 72 20 61 6c 6c 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 73 6f 66 74 77 61 72 65 20 69 for.all.the...........software.i
26ba0 6e 20 74 68 65 20 70 72 6f 64 75 63 74 20 74 68 61 74 20 69 73 20 63 6f 76 65 72 65 64 20 62 79 n.the.product.that.is.covered.by
26bc0 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 6f 6e 20 61 0a 20 20 20 20 20 20 20 20 20 20 64 75 .this.License,.on.a...........du
26be0 72 61 62 6c 65 20 70 68 79 73 69 63 61 6c 20 6d 65 64 69 75 6d 20 63 75 73 74 6f 6d 61 72 69 6c rable.physical.medium.customaril
26c00 79 20 75 73 65 64 20 66 6f 72 20 73 6f 66 74 77 61 72 65 0a 20 20 20 20 20 20 20 20 20 20 69 6e y.used.for.software...........in
26c20 74 65 72 63 68 61 6e 67 65 2c 20 66 6f 72 20 61 20 70 72 69 63 65 20 6e 6f 20 6d 6f 72 65 20 74 terchange,.for.a.price.no.more.t
26c40 68 61 6e 20 79 6f 75 72 20 72 65 61 73 6f 6e 61 62 6c 65 20 63 6f 73 74 20 6f 66 0a 20 20 20 20 han.your.reasonable.cost.of.....
26c60 20 20 20 20 20 20 70 68 79 73 69 63 61 6c 6c 79 20 70 65 72 66 6f 72 6d 69 6e 67 20 74 68 69 73 ......physically.performing.this
26c80 20 63 6f 6e 76 65 79 69 6e 67 20 6f 66 20 73 6f 75 72 63 65 2c 20 6f 72 20 28 32 29 20 61 63 63 .conveying.of.source,.or.(2).acc
26ca0 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 74 6f 20 63 6f 70 79 20 74 68 65 20 43 6f 72 72 65 73 ess...........to.copy.the.Corres
26cc0 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 66 72 6f 6d 20 61 20 6e 65 74 77 6f 72 6b 20 73 65 ponding.Source.from.a.network.se
26ce0 72 76 65 72 20 61 74 20 6e 6f 0a 20 20 20 20 20 20 20 20 20 20 63 68 61 72 67 65 2e 0a 0a 20 20 rver.at.no...........charge.....
26d00 20 20 20 20 20 63 2e 20 43 6f 6e 76 65 79 20 69 6e 64 69 76 69 64 75 61 6c 20 63 6f 70 69 65 73 .....c..Convey.individual.copies
26d20 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f 64 65 20 77 69 74 68 20 61 20 63 6f 70 79 20 .of.the.object.code.with.a.copy.
26d40 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 77 72 69 74 74 65 6e 20 6f 66 66 65 72 20 74 of.the...........written.offer.t
26d60 6f 20 70 72 6f 76 69 64 65 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 o.provide.the.Corresponding.Sour
26d80 63 65 2e 20 20 54 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 61 6c 74 65 72 6e 61 74 69 76 65 20 ce...This...........alternative.
26da0 69 73 20 61 6c 6c 6f 77 65 64 20 6f 6e 6c 79 20 6f 63 63 61 73 69 6f 6e 61 6c 6c 79 20 61 6e 64 is.allowed.only.occasionally.and
26dc0 20 6e 6f 6e 63 6f 6d 6d 65 72 63 69 61 6c 6c 79 2c 0a 20 20 20 20 20 20 20 20 20 20 61 6e 64 20 .noncommercially,...........and.
26de0 6f 6e 6c 79 20 69 66 20 79 6f 75 20 72 65 63 65 69 76 65 64 20 74 68 65 20 6f 62 6a 65 63 74 20 only.if.you.received.the.object.
26e00 63 6f 64 65 20 77 69 74 68 20 73 75 63 68 20 61 6e 20 6f 66 66 65 72 2c 0a 20 20 20 20 20 20 20 code.with.such.an.offer,........
26e20 20 20 20 69 6e 20 61 63 63 6f 72 64 20 77 69 74 68 20 73 75 62 73 65 63 74 69 6f 6e 20 36 62 2e ...in.accord.with.subsection.6b.
26e40 0a 0a 20 20 20 20 20 20 20 64 2e 20 43 6f 6e 76 65 79 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f .........d..Convey.the.object.co
26e60 64 65 20 62 79 20 6f 66 66 65 72 69 6e 67 20 61 63 63 65 73 73 20 66 72 6f 6d 20 61 20 64 65 73 de.by.offering.access.from.a.des
26e80 69 67 6e 61 74 65 64 0a 20 20 20 20 20 20 20 20 20 20 70 6c 61 63 65 20 28 67 72 61 74 69 73 20 ignated...........place.(gratis.
26ea0 6f 72 20 66 6f 72 20 61 20 63 68 61 72 67 65 29 2c 20 61 6e 64 20 6f 66 66 65 72 20 65 71 75 69 or.for.a.charge),.and.offer.equi
26ec0 76 61 6c 65 6e 74 20 61 63 63 65 73 73 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 43 valent.access.to...........the.C
26ee0 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 orresponding.Source.in.the.same.
26f00 77 61 79 20 74 68 72 6f 75 67 68 20 74 68 65 20 73 61 6d 65 0a 20 20 20 20 20 20 20 20 20 20 70 way.through.the.same...........p
26f20 6c 61 63 65 20 61 74 20 6e 6f 20 66 75 72 74 68 65 72 20 63 68 61 72 67 65 2e 20 20 59 6f 75 20 lace.at.no.further.charge...You.
26f40 6e 65 65 64 20 6e 6f 74 20 72 65 71 75 69 72 65 20 72 65 63 69 70 69 65 6e 74 73 0a 20 20 20 20 need.not.require.recipients.....
26f60 20 20 20 20 20 20 74 6f 20 63 6f 70 79 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 ......to.copy.the.Corresponding.
26f80 53 6f 75 72 63 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f 64 Source.along.with.the.object.cod
26fa0 65 2e 0a 20 20 20 20 20 20 20 20 20 20 49 66 20 74 68 65 20 70 6c 61 63 65 20 74 6f 20 63 6f 70 e............If.the.place.to.cop
26fc0 79 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f 64 65 20 69 73 20 61 20 6e 65 74 77 6f 72 6b 20 73 y.the.object.code.is.a.network.s
26fe0 65 72 76 65 72 2c 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 43 6f 72 72 65 73 70 6f 6e 64 69 erver,.the...........Correspondi
27000 6e 67 20 53 6f 75 72 63 65 20 6d 61 79 20 62 65 20 6f 6e 20 61 20 64 69 66 66 65 72 65 6e 74 20 ng.Source.may.be.on.a.different.
27020 73 65 72 76 65 72 20 28 6f 70 65 72 61 74 65 64 20 62 79 0a 20 20 20 20 20 20 20 20 20 20 79 6f server.(operated.by...........yo
27040 75 20 6f 72 20 61 20 74 68 69 72 64 20 70 61 72 74 79 29 20 74 68 61 74 20 73 75 70 70 6f 72 74 u.or.a.third.party).that.support
27060 73 20 65 71 75 69 76 61 6c 65 6e 74 20 63 6f 70 79 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 66 s.equivalent.copying...........f
27080 61 63 69 6c 69 74 69 65 73 2c 20 70 72 6f 76 69 64 65 64 20 79 6f 75 20 6d 61 69 6e 74 61 69 6e acilities,.provided.you.maintain
270a0 20 63 6c 65 61 72 20 64 69 72 65 63 74 69 6f 6e 73 20 6e 65 78 74 20 74 6f 20 74 68 65 0a 20 20 .clear.directions.next.to.the...
270c0 20 20 20 20 20 20 20 20 6f 62 6a 65 63 74 20 63 6f 64 65 20 73 61 79 69 6e 67 20 77 68 65 72 65 ........object.code.saying.where
270e0 20 74 6f 20 66 69 6e 64 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 .to.find.the.Corresponding.Sourc
27100 65 2e 0a 20 20 20 20 20 20 20 20 20 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 61 74 20 e............Regardless.of.what.
27120 73 65 72 76 65 72 20 68 6f 73 74 73 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 server.hosts.the.Corresponding.S
27140 6f 75 72 63 65 2c 20 79 6f 75 0a 20 20 20 20 20 20 20 20 20 20 72 65 6d 61 69 6e 20 6f 62 6c 69 ource,.you...........remain.obli
27160 67 61 74 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 20 69 74 20 69 73 20 61 76 61 69 6c gated.to.ensure.that.it.is.avail
27180 61 62 6c 65 20 66 6f 72 20 61 73 20 6c 6f 6e 67 20 61 73 0a 20 20 20 20 20 20 20 20 20 20 6e 65 able.for.as.long.as...........ne
271a0 65 64 65 64 20 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 73 65 20 72 65 71 75 69 72 65 6d 65 6e eded.to.satisfy.these.requiremen
271c0 74 73 2e 0a 0a 20 20 20 20 20 20 20 65 2e 20 43 6f 6e 76 65 79 20 74 68 65 20 6f 62 6a 65 63 74 ts..........e..Convey.the.object
271e0 20 63 6f 64 65 20 75 73 69 6e 67 20 70 65 65 72 2d 74 6f 2d 70 65 65 72 20 74 72 61 6e 73 6d 69 .code.using.peer-to-peer.transmi
27200 73 73 69 6f 6e 2c 0a 20 20 20 20 20 20 20 20 20 20 70 72 6f 76 69 64 65 64 20 79 6f 75 20 69 6e ssion,...........provided.you.in
27220 66 6f 72 6d 20 6f 74 68 65 72 20 70 65 65 72 73 20 77 68 65 72 65 20 74 68 65 20 6f 62 6a 65 63 form.other.peers.where.the.objec
27240 74 20 63 6f 64 65 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 43 6f 72 72 65 73 70 6f 6e 64 69 t.code.and...........Correspondi
27260 6e 67 20 53 6f 75 72 63 65 20 6f 66 20 74 68 65 20 77 6f 72 6b 20 61 72 65 20 62 65 69 6e 67 20 ng.Source.of.the.work.are.being.
27280 6f 66 66 65 72 65 64 20 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 67 65 6e 65 72 61 6c offered.to.the...........general
272a0 20 70 75 62 6c 69 63 20 61 74 20 6e 6f 20 63 68 61 72 67 65 20 75 6e 64 65 72 20 73 75 62 73 65 .public.at.no.charge.under.subse
272c0 63 74 69 6f 6e 20 36 64 2e 0a 0a 20 20 20 20 20 41 20 73 65 70 61 72 61 62 6c 65 20 70 6f 72 74 ction.6d........A.separable.port
272e0 69 6f 6e 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6f 64 65 2c 20 77 68 6f 73 65 20 73 6f ion.of.the.object.code,.whose.so
27300 75 72 63 65 20 63 6f 64 65 20 69 73 0a 20 20 20 20 20 65 78 63 6c 75 64 65 64 20 66 72 6f 6d 20 urce.code.is......excluded.from.
27320 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 61 73 20 61 20 53 79 the.Corresponding.Source.as.a.Sy
27340 73 74 65 6d 20 4c 69 62 72 61 72 79 2c 20 6e 65 65 64 0a 20 20 20 20 20 6e 6f 74 20 62 65 20 69 stem.Library,.need......not.be.i
27360 6e 63 6c 75 64 65 64 20 69 6e 20 63 6f 6e 76 65 79 69 6e 67 20 74 68 65 20 6f 62 6a 65 63 74 20 ncluded.in.conveying.the.object.
27380 63 6f 64 65 20 77 6f 72 6b 2e 0a 0a 20 20 20 20 20 41 20 e2 80 9c 55 73 65 72 20 50 72 6f 64 75 code.work........A....User.Produ
273a0 63 74 e2 80 9d 20 69 73 20 65 69 74 68 65 72 20 28 31 29 20 61 20 e2 80 9c 63 6f 6e 73 75 6d 65 ct....is.either.(1).a....consume
273c0 72 20 70 72 6f 64 75 63 74 e2 80 9d 2c 20 77 68 69 63 68 20 6d 65 61 6e 73 0a 20 20 20 20 20 61 r.product...,.which.means......a
273e0 6e 79 20 74 61 6e 67 69 62 6c 65 20 70 65 72 73 6f 6e 61 6c 20 70 72 6f 70 65 72 74 79 20 77 68 ny.tangible.personal.property.wh
27400 69 63 68 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 75 73 65 64 20 66 6f 72 20 70 65 72 73 6f 6e 61 ich.is.normally.used.for.persona
27420 6c 2c 0a 20 20 20 20 20 66 61 6d 69 6c 79 2c 20 6f 72 20 68 6f 75 73 65 68 6f 6c 64 20 70 75 72 l,......family,.or.household.pur
27440 70 6f 73 65 73 2c 20 6f 72 20 28 32 29 20 61 6e 79 74 68 69 6e 67 20 64 65 73 69 67 6e 65 64 20 poses,.or.(2).anything.designed.
27460 6f 72 20 73 6f 6c 64 20 66 6f 72 0a 20 20 20 20 20 69 6e 63 6f 72 70 6f 72 61 74 69 6f 6e 20 69 or.sold.for......incorporation.i
27480 6e 74 6f 20 61 20 64 77 65 6c 6c 69 6e 67 2e 20 20 49 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 nto.a.dwelling...In.determining.
274a0 77 68 65 74 68 65 72 20 61 20 70 72 6f 64 75 63 74 20 69 73 0a 20 20 20 20 20 61 20 63 6f 6e 73 whether.a.product.is......a.cons
274c0 75 6d 65 72 20 70 72 6f 64 75 63 74 2c 20 64 6f 75 62 74 66 75 6c 20 63 61 73 65 73 20 73 68 61 umer.product,.doubtful.cases.sha
274e0 6c 6c 20 62 65 20 72 65 73 6f 6c 76 65 64 20 69 6e 20 66 61 76 6f 72 20 6f 66 0a 20 20 20 20 20 ll.be.resolved.in.favor.of......
27500 63 6f 76 65 72 61 67 65 2e 20 20 46 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 70 72 6f 64 coverage...For.a.particular.prod
27520 75 63 74 20 72 65 63 65 69 76 65 64 20 62 79 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 75 73 65 uct.received.by.a.particular.use
27540 72 2c 0a 20 20 20 20 20 e2 80 9c 6e 6f 72 6d 61 6c 6c 79 20 75 73 65 64 e2 80 9d 20 72 65 66 65 r,.........normally.used....refe
27560 72 73 20 74 6f 20 61 20 74 79 70 69 63 61 6c 20 6f 72 20 63 6f 6d 6d 6f 6e 20 75 73 65 20 6f 66 rs.to.a.typical.or.common.use.of
27580 20 74 68 61 74 20 63 6c 61 73 73 20 6f 66 0a 20 20 20 20 20 70 72 6f 64 75 63 74 2c 20 72 65 67 .that.class.of......product,.reg
275a0 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 74 68 65 20 70 61 72 ardless.of.the.status.of.the.par
275c0 74 69 63 75 6c 61 72 20 75 73 65 72 20 6f 72 20 6f 66 20 74 68 65 0a 20 20 20 20 20 77 61 79 20 ticular.user.or.of.the......way.
275e0 69 6e 20 77 68 69 63 68 20 74 68 65 20 70 61 72 74 69 63 75 6c 61 72 20 75 73 65 72 20 61 63 74 in.which.the.particular.user.act
27600 75 61 6c 6c 79 20 75 73 65 73 2c 20 6f 72 20 65 78 70 65 63 74 73 20 6f 72 20 69 73 0a 20 20 20 ually.uses,.or.expects.or.is....
27620 20 20 65 78 70 65 63 74 65 64 20 74 6f 20 75 73 65 2c 20 74 68 65 20 70 72 6f 64 75 63 74 2e 20 ..expected.to.use,.the.product..
27640 20 41 20 70 72 6f 64 75 63 74 20 69 73 20 61 20 63 6f 6e 73 75 6d 65 72 20 70 72 6f 64 75 63 74 .A.product.is.a.consumer.product
27660 0a 20 20 20 20 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 20 74 68 65 20 ......regardless.of.whether.the.
27680 70 72 6f 64 75 63 74 20 68 61 73 20 73 75 62 73 74 61 6e 74 69 61 6c 20 63 6f 6d 6d 65 72 63 69 product.has.substantial.commerci
276a0 61 6c 2c 0a 20 20 20 20 20 69 6e 64 75 73 74 72 69 61 6c 20 6f 72 20 6e 6f 6e 2d 63 6f 6e 73 75 al,......industrial.or.non-consu
276c0 6d 65 72 20 75 73 65 73 2c 20 75 6e 6c 65 73 73 20 73 75 63 68 20 75 73 65 73 20 72 65 70 72 65 mer.uses,.unless.such.uses.repre
276e0 73 65 6e 74 20 74 68 65 0a 20 20 20 20 20 6f 6e 6c 79 20 73 69 67 6e 69 66 69 63 61 6e 74 20 6d sent.the......only.significant.m
27700 6f 64 65 20 6f 66 20 75 73 65 20 6f 66 20 74 68 65 20 70 72 6f 64 75 63 74 2e 0a 0a 20 20 20 20 ode.of.use.of.the.product.......
27720 20 e2 80 9c 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 49 6e 66 6f 72 6d 61 74 69 6f 6e e2 80 9d 20 ....Installation.Information....
27740 66 6f 72 20 61 20 55 73 65 72 20 50 72 6f 64 75 63 74 20 6d 65 61 6e 73 20 61 6e 79 20 6d 65 74 for.a.User.Product.means.any.met
27760 68 6f 64 73 2c 0a 20 20 20 20 20 70 72 6f 63 65 64 75 72 65 73 2c 20 61 75 74 68 6f 72 69 7a 61 hods,......procedures,.authoriza
27780 74 69 6f 6e 20 6b 65 79 73 2c 20 6f 72 20 6f 74 68 65 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 tion.keys,.or.other.information.
277a0 72 65 71 75 69 72 65 64 20 74 6f 0a 20 20 20 20 20 69 6e 73 74 61 6c 6c 20 61 6e 64 20 65 78 65 required.to......install.and.exe
277c0 63 75 74 65 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 20 63 6f 76 65 cute.modified.versions.of.a.cove
277e0 72 65 64 20 77 6f 72 6b 20 69 6e 20 74 68 61 74 0a 20 20 20 20 20 55 73 65 72 20 50 72 6f 64 75 red.work.in.that......User.Produ
27800 63 74 20 66 72 6f 6d 20 61 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 69 74 ct.from.a.modified.version.of.it
27820 73 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 2e 0a 20 20 20 20 20 54 68 65 s.Corresponding.Source.......The
27840 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6d 75 73 74 20 73 75 66 66 69 63 65 20 74 6f 20 65 6e 73 .information.must.suffice.to.ens
27860 75 72 65 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74 69 6e 75 65 64 0a 20 20 20 20 20 66 75 6e 63 ure.that.the.continued......func
27880 74 69 6f 6e 69 6e 67 20 6f 66 20 74 68 65 20 6d 6f 64 69 66 69 65 64 20 6f 62 6a 65 63 74 20 63 tioning.of.the.modified.object.c
278a0 6f 64 65 20 69 73 20 69 6e 20 6e 6f 20 63 61 73 65 20 70 72 65 76 65 6e 74 65 64 20 6f 72 0a 20 ode.is.in.no.case.prevented.or..
278c0 20 20 20 20 69 6e 74 65 72 66 65 72 65 64 20 77 69 74 68 20 73 6f 6c 65 6c 79 20 62 65 63 61 75 ....interfered.with.solely.becau
278e0 73 65 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 6d 61 64 65 2e 0a 0a se.modification.has.been.made...
27900 20 20 20 20 20 49 66 20 79 6f 75 20 63 6f 6e 76 65 79 20 61 6e 20 6f 62 6a 65 63 74 20 63 6f 64 .....If.you.convey.an.object.cod
27920 65 20 77 6f 72 6b 20 75 6e 64 65 72 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 69 6e 2c 20 6f 72 e.work.under.this.section.in,.or
27940 20 77 69 74 68 2c 0a 20 20 20 20 20 6f 72 20 73 70 65 63 69 66 69 63 61 6c 6c 79 20 66 6f 72 20 .with,......or.specifically.for.
27960 75 73 65 20 69 6e 2c 20 61 20 55 73 65 72 20 50 72 6f 64 75 63 74 2c 20 61 6e 64 20 74 68 65 20 use.in,.a.User.Product,.and.the.
27980 63 6f 6e 76 65 79 69 6e 67 0a 20 20 20 20 20 6f 63 63 75 72 73 20 61 73 20 70 61 72 74 20 6f 66 conveying......occurs.as.part.of
279a0 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 77 68 69 63 68 20 74 68 65 20 72 69 67 68 .a.transaction.in.which.the.righ
279c0 74 20 6f 66 20 70 6f 73 73 65 73 73 69 6f 6e 0a 20 20 20 20 20 61 6e 64 20 75 73 65 20 6f 66 20 t.of.possession......and.use.of.
279e0 74 68 65 20 55 73 65 72 20 50 72 6f 64 75 63 74 20 69 73 20 74 72 61 6e 73 66 65 72 72 65 64 20 the.User.Product.is.transferred.
27a00 74 6f 20 74 68 65 20 72 65 63 69 70 69 65 6e 74 20 69 6e 0a 20 20 20 20 20 70 65 72 70 65 74 75 to.the.recipient.in......perpetu
27a20 69 74 79 20 6f 72 20 66 6f 72 20 61 20 66 69 78 65 64 20 74 65 72 6d 20 28 72 65 67 61 72 64 6c ity.or.for.a.fixed.term.(regardl
27a40 65 73 73 20 6f 66 20 68 6f 77 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 ess.of.how.the.transaction......
27a60 69 73 20 63 68 61 72 61 63 74 65 72 69 7a 65 64 29 2c 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e is.characterized),.the.Correspon
27a80 64 69 6e 67 20 53 6f 75 72 63 65 20 63 6f 6e 76 65 79 65 64 20 75 6e 64 65 72 20 74 68 69 73 0a ding.Source.conveyed.under.this.
27aa0 20 20 20 20 20 73 65 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 61 63 63 6f 6d 70 61 6e 69 65 64 .....section.must.be.accompanied
27ac0 20 62 79 20 74 68 65 20 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 49 6e 66 6f 72 6d 61 74 69 6f 6e .by.the.Installation.Information
27ae0 2e 20 20 42 75 74 0a 20 20 20 20 20 74 68 69 73 20 72 65 71 75 69 72 65 6d 65 6e 74 20 64 6f 65 ...But......this.requirement.doe
27b00 73 20 6e 6f 74 20 61 70 70 6c 79 20 69 66 20 6e 65 69 74 68 65 72 20 79 6f 75 20 6e 6f 72 20 61 s.not.apply.if.neither.you.nor.a
27b20 6e 79 20 74 68 69 72 64 20 70 61 72 74 79 0a 20 20 20 20 20 72 65 74 61 69 6e 73 20 74 68 65 20 ny.third.party......retains.the.
27b40 61 62 69 6c 69 74 79 20 74 6f 20 69 6e 73 74 61 6c 6c 20 6d 6f 64 69 66 69 65 64 20 6f 62 6a 65 ability.to.install.modified.obje
27b60 63 74 20 63 6f 64 65 20 6f 6e 20 74 68 65 20 55 73 65 72 0a 20 20 20 20 20 50 72 6f 64 75 63 74 ct.code.on.the.User......Product
27b80 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 77 6f 72 6b 20 68 61 73 20 62 65 65 6e .(for.example,.the.work.has.been
27ba0 20 69 6e 73 74 61 6c 6c 65 64 20 69 6e 20 52 4f 4d 29 2e 0a 0a 20 20 20 20 20 54 68 65 20 72 65 .installed.in.ROM)........The.re
27bc0 71 75 69 72 65 6d 65 6e 74 20 74 6f 20 70 72 6f 76 69 64 65 20 49 6e 73 74 61 6c 6c 61 74 69 6f quirement.to.provide.Installatio
27be0 6e 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20 20 69 6e 63 6c n.Information.does.not......incl
27c00 75 64 65 20 61 20 72 65 71 75 69 72 65 6d 65 6e 74 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 74 6f ude.a.requirement.to.continue.to
27c20 20 70 72 6f 76 69 64 65 20 73 75 70 70 6f 72 74 20 73 65 72 76 69 63 65 2c 0a 20 20 20 20 20 77 .provide.support.service,......w
27c40 61 72 72 61 6e 74 79 2c 20 6f 72 20 75 70 64 61 74 65 73 20 66 6f 72 20 61 20 77 6f 72 6b 20 74 arranty,.or.updates.for.a.work.t
27c60 68 61 74 20 68 61 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 6f 72 20 69 6e 73 74 61 6c 6c hat.has.been.modified.or.install
27c80 65 64 0a 20 20 20 20 20 62 79 20 74 68 65 20 72 65 63 69 70 69 65 6e 74 2c 20 6f 72 20 66 6f 72 ed......by.the.recipient,.or.for
27ca0 20 74 68 65 20 55 73 65 72 20 50 72 6f 64 75 63 74 20 69 6e 20 77 68 69 63 68 20 69 74 20 68 61 .the.User.Product.in.which.it.ha
27cc0 73 20 62 65 65 6e 0a 20 20 20 20 20 6d 6f 64 69 66 69 65 64 20 6f 72 20 69 6e 73 74 61 6c 6c 65 s.been......modified.or.installe
27ce0 64 2e 20 20 41 63 63 65 73 73 20 74 6f 20 61 20 6e 65 74 77 6f 72 6b 20 6d 61 79 20 62 65 20 64 d...Access.to.a.network.may.be.d
27d00 65 6e 69 65 64 20 77 68 65 6e 20 74 68 65 0a 20 20 20 20 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e enied.when.the......modification
27d20 20 69 74 73 65 6c 66 20 6d 61 74 65 72 69 61 6c 6c 79 20 61 6e 64 20 61 64 76 65 72 73 65 6c 79 .itself.materially.and.adversely
27d40 20 61 66 66 65 63 74 73 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 0a 20 20 20 20 20 6f 66 20 74 .affects.the.operation......of.t
27d60 68 65 20 6e 65 74 77 6f 72 6b 20 6f 72 20 76 69 6f 6c 61 74 65 73 20 74 68 65 20 72 75 6c 65 73 he.network.or.violates.the.rules
27d80 20 61 6e 64 20 70 72 6f 74 6f 63 6f 6c 73 20 66 6f 72 0a 20 20 20 20 20 63 6f 6d 6d 75 6e 69 63 .and.protocols.for......communic
27da0 61 74 69 6f 6e 20 61 63 72 6f 73 73 20 74 68 65 20 6e 65 74 77 6f 72 6b 2e 0a 0a 20 20 20 20 20 ation.across.the.network........
27dc0 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 63 6f 6e 76 65 79 65 64 2c 20 61 Corresponding.Source.conveyed,.a
27de0 6e 64 20 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20 20 20 20 nd.Installation.Information.....
27e00 20 70 72 6f 76 69 64 65 64 2c 20 69 6e 20 61 63 63 6f 72 64 20 77 69 74 68 20 74 68 69 73 20 73 .provided,.in.accord.with.this.s
27e20 65 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 69 6e 20 61 20 66 6f 72 6d 61 74 20 74 68 61 74 20 ection.must.be.in.a.format.that.
27e40 69 73 0a 20 20 20 20 20 70 75 62 6c 69 63 6c 79 20 64 6f 63 75 6d 65 6e 74 65 64 20 28 61 6e 64 is......publicly.documented.(and
27e60 20 77 69 74 68 20 61 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 61 76 61 69 6c 61 62 6c .with.an.implementation.availabl
27e80 65 20 74 6f 20 74 68 65 0a 20 20 20 20 20 70 75 62 6c 69 63 20 69 6e 20 73 6f 75 72 63 65 20 63 e.to.the......public.in.source.c
27ea0 6f 64 65 20 66 6f 72 6d 29 2c 20 61 6e 64 20 6d 75 73 74 20 72 65 71 75 69 72 65 20 6e 6f 20 73 ode.form),.and.must.require.no.s
27ec0 70 65 63 69 61 6c 20 70 61 73 73 77 6f 72 64 0a 20 20 20 20 20 6f 72 20 6b 65 79 20 66 6f 72 20 pecial.password......or.key.for.
27ee0 75 6e 70 61 63 6b 69 6e 67 2c 20 72 65 61 64 69 6e 67 20 6f 72 20 63 6f 70 79 69 6e 67 2e 0a 0a unpacking,.reading.or.copying...
27f00 20 20 37 2e 20 41 64 64 69 74 69 6f 6e 61 6c 20 54 65 72 6d 73 2e 0a 0a 20 20 20 20 20 e2 80 9c ..7..Additional.Terms...........
27f20 41 64 64 69 74 69 6f 6e 61 6c 20 70 65 72 6d 69 73 73 69 6f 6e 73 e2 80 9d 20 61 72 65 20 74 65 Additional.permissions....are.te
27f40 72 6d 73 20 74 68 61 74 20 73 75 70 70 6c 65 6d 65 6e 74 20 74 68 65 20 74 65 72 6d 73 20 6f 66 rms.that.supplement.the.terms.of
27f60 0a 20 20 20 20 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 62 79 20 6d 61 6b 69 6e 67 20 65 78 63 ......this.License.by.making.exc
27f80 65 70 74 69 6f 6e 73 20 66 72 6f 6d 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 69 74 73 0a eptions.from.one.or.more.of.its.
27fa0 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 73 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c 20 70 65 72 .....conditions...Additional.per
27fc0 6d 69 73 73 69 6f 6e 73 20 74 68 61 74 20 61 72 65 20 61 70 70 6c 69 63 61 62 6c 65 20 74 6f 20 missions.that.are.applicable.to.
27fe0 74 68 65 0a 20 20 20 20 20 65 6e 74 69 72 65 20 50 72 6f 67 72 61 6d 20 73 68 61 6c 6c 20 62 65 the......entire.Program.shall.be
28000 20 74 72 65 61 74 65 64 20 61 73 20 74 68 6f 75 67 68 20 74 68 65 79 20 77 65 72 65 20 69 6e 63 .treated.as.though.they.were.inc
28020 6c 75 64 65 64 20 69 6e 0a 20 20 20 20 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 74 6f 20 74 luded.in......this.License,.to.t
28040 68 65 20 65 78 74 65 6e 74 20 74 68 61 74 20 74 68 65 79 20 61 72 65 20 76 61 6c 69 64 20 75 6e he.extent.that.they.are.valid.un
28060 64 65 72 20 61 70 70 6c 69 63 61 62 6c 65 0a 20 20 20 20 20 6c 61 77 2e 20 20 49 66 20 61 64 64 der.applicable......law...If.add
28080 69 74 69 6f 6e 61 6c 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 61 70 70 6c 79 20 6f 6e 6c 79 20 74 itional.permissions.apply.only.t
280a0 6f 20 70 61 72 74 20 6f 66 20 74 68 65 20 50 72 6f 67 72 61 6d 2c 0a 20 20 20 20 20 74 68 61 74 o.part.of.the.Program,......that
280c0 20 70 61 72 74 20 6d 61 79 20 62 65 20 75 73 65 64 20 73 65 70 61 72 61 74 65 6c 79 20 75 6e 64 .part.may.be.used.separately.und
280e0 65 72 20 74 68 6f 73 65 20 70 65 72 6d 69 73 73 69 6f 6e 73 2c 20 62 75 74 20 74 68 65 0a 20 20 er.those.permissions,.but.the...
28100 20 20 20 65 6e 74 69 72 65 20 50 72 6f 67 72 61 6d 20 72 65 6d 61 69 6e 73 20 67 6f 76 65 72 6e ...entire.Program.remains.govern
28120 65 64 20 62 79 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 77 69 74 68 6f 75 74 20 72 65 67 61 72 ed.by.this.License.without.regar
28140 64 20 74 6f 0a 20 20 20 20 20 74 68 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 70 65 72 6d 69 73 73 d.to......the.additional.permiss
28160 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 79 6f 75 20 63 6f 6e 76 65 79 20 61 20 63 6f ions........When.you.convey.a.co
28180 70 79 20 6f 66 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 2c 20 79 6f 75 20 6d 61 79 20 61 74 py.of.a.covered.work,.you.may.at
281a0 20 79 6f 75 72 20 6f 70 74 69 6f 6e 0a 20 20 20 20 20 72 65 6d 6f 76 65 20 61 6e 79 20 61 64 64 .your.option......remove.any.add
281c0 69 74 69 6f 6e 61 6c 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 66 72 6f 6d 20 74 68 61 74 20 63 6f itional.permissions.from.that.co
281e0 70 79 2c 20 6f 72 20 66 72 6f 6d 20 61 6e 79 20 70 61 72 74 0a 20 20 20 20 20 6f 66 20 69 74 2e py,.or.from.any.part......of.it.
28200 20 20 28 41 64 64 69 74 69 6f 6e 61 6c 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 6d 61 79 20 62 65 ..(Additional.permissions.may.be
28220 20 77 72 69 74 74 65 6e 20 74 6f 20 72 65 71 75 69 72 65 20 74 68 65 69 72 20 6f 77 6e 0a 20 20 .written.to.require.their.own...
28240 20 20 20 72 65 6d 6f 76 61 6c 20 69 6e 20 63 65 72 74 61 69 6e 20 63 61 73 65 73 20 77 68 65 6e ...removal.in.certain.cases.when
28260 20 79 6f 75 20 6d 6f 64 69 66 79 20 74 68 65 20 77 6f 72 6b 2e 29 20 20 59 6f 75 20 6d 61 79 20 .you.modify.the.work.)..You.may.
28280 70 6c 61 63 65 0a 20 20 20 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 70 65 72 6d 69 73 73 69 6f 6e place......additional.permission
282a0 73 20 6f 6e 20 6d 61 74 65 72 69 61 6c 2c 20 61 64 64 65 64 20 62 79 20 79 6f 75 20 74 6f 20 61 s.on.material,.added.by.you.to.a
282c0 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 2c 0a 20 20 20 20 20 66 6f 72 20 77 68 69 63 68 20 79 6f .covered.work,......for.which.yo
282e0 75 20 68 61 76 65 20 6f 72 20 63 61 6e 20 67 69 76 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 u.have.or.can.give.appropriate.c
28300 6f 70 79 72 69 67 68 74 20 70 65 72 6d 69 73 73 69 6f 6e 2e 0a 0a 20 20 20 20 20 4e 6f 74 77 69 opyright.permission........Notwi
28320 74 68 73 74 61 6e 64 69 6e 67 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 76 69 73 69 6f 6e 20 6f thstanding.any.other.provision.o
28340 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 66 6f 72 20 6d 61 74 65 72 69 61 6c 0a 20 20 20 f.this.License,.for.material....
28360 20 20 79 6f 75 20 61 64 64 20 74 6f 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 2c 20 79 6f 75 ..you.add.to.a.covered.work,.you
28380 20 6d 61 79 20 28 69 66 20 61 75 74 68 6f 72 69 7a 65 64 20 62 79 20 74 68 65 20 63 6f 70 79 72 .may.(if.authorized.by.the.copyr
283a0 69 67 68 74 0a 20 20 20 20 20 68 6f 6c 64 65 72 73 20 6f 66 20 74 68 61 74 20 6d 61 74 65 72 69 ight......holders.of.that.materi
283c0 61 6c 29 20 73 75 70 70 6c 65 6d 65 6e 74 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 69 73 al).supplement.the.terms.of.this
283e0 20 4c 69 63 65 6e 73 65 20 77 69 74 68 0a 20 20 20 20 20 74 65 72 6d 73 3a 0a 0a 20 20 20 20 20 .License.with......terms:.......
28400 20 20 61 2e 20 44 69 73 63 6c 61 69 6d 69 6e 67 20 77 61 72 72 61 6e 74 79 20 6f 72 20 6c 69 6d ..a..Disclaiming.warranty.or.lim
28420 69 74 69 6e 67 20 6c 69 61 62 69 6c 69 74 79 20 64 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d iting.liability.differently.from
28440 0a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 73 65 63 74 69 6f 6e 73 ...........the.terms.of.sections
28460 20 31 35 20 61 6e 64 20 31 36 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 3b 20 6f 72 0a 0a .15.and.16.of.this.License;.or..
28480 20 20 20 20 20 20 20 62 2e 20 52 65 71 75 69 72 69 6e 67 20 70 72 65 73 65 72 76 61 74 69 6f 6e .......b..Requiring.preservation
284a0 20 6f 66 20 73 70 65 63 69 66 69 65 64 20 72 65 61 73 6f 6e 61 62 6c 65 20 6c 65 67 61 6c 20 6e .of.specified.reasonable.legal.n
284c0 6f 74 69 63 65 73 0a 20 20 20 20 20 20 20 20 20 20 6f 72 20 61 75 74 68 6f 72 20 61 74 74 72 69 otices...........or.author.attri
284e0 62 75 74 69 6f 6e 73 20 69 6e 20 74 68 61 74 20 6d 61 74 65 72 69 61 6c 20 6f 72 20 69 6e 20 74 butions.in.that.material.or.in.t
28500 68 65 20 41 70 70 72 6f 70 72 69 61 74 65 0a 20 20 20 20 20 20 20 20 20 20 4c 65 67 61 6c 20 4e he.Appropriate...........Legal.N
28520 6f 74 69 63 65 73 20 64 69 73 70 6c 61 79 65 64 20 62 79 20 77 6f 72 6b 73 20 63 6f 6e 74 61 69 otices.displayed.by.works.contai
28540 6e 69 6e 67 20 69 74 3b 20 6f 72 0a 0a 20 20 20 20 20 20 20 63 2e 20 50 72 6f 68 69 62 69 74 69 ning.it;.or.........c..Prohibiti
28560 6e 67 20 6d 69 73 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6f 72 69 67 ng.misrepresentation.of.the.orig
28580 69 6e 20 6f 66 20 74 68 61 74 20 6d 61 74 65 72 69 61 6c 2c 0a 20 20 20 20 20 20 20 20 20 20 6f in.of.that.material,...........o
285a0 72 20 72 65 71 75 69 72 69 6e 67 20 74 68 61 74 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 69 6f r.requiring.that.modified.versio
285c0 6e 73 20 6f 66 20 73 75 63 68 20 6d 61 74 65 72 69 61 6c 20 62 65 20 6d 61 72 6b 65 64 0a 20 20 ns.of.such.material.be.marked...
285e0 20 20 20 20 20 20 20 20 69 6e 20 72 65 61 73 6f 6e 61 62 6c 65 20 77 61 79 73 20 61 73 20 64 69 ........in.reasonable.ways.as.di
28600 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 76 65 72 73 69 6f fferent.from.the.original.versio
28620 6e 3b 20 6f 72 0a 0a 20 20 20 20 20 20 20 64 2e 20 4c 69 6d 69 74 69 6e 67 20 74 68 65 20 75 73 n;.or.........d..Limiting.the.us
28640 65 20 66 6f 72 20 70 75 62 6c 69 63 69 74 79 20 70 75 72 70 6f 73 65 73 20 6f 66 20 6e 61 6d 65 e.for.publicity.purposes.of.name
28660 73 20 6f 66 20 6c 69 63 65 6e 73 6f 72 73 0a 20 20 20 20 20 20 20 20 20 20 6f 72 20 61 75 74 68 s.of.licensors...........or.auth
28680 6f 72 73 20 6f 66 20 74 68 65 20 6d 61 74 65 72 69 61 6c 3b 20 6f 72 0a 0a 20 20 20 20 20 20 20 ors.of.the.material;.or.........
286a0 65 2e 20 44 65 63 6c 69 6e 69 6e 67 20 74 6f 20 67 72 61 6e 74 20 72 69 67 68 74 73 20 75 6e 64 e..Declining.to.grant.rights.und
286c0 65 72 20 74 72 61 64 65 6d 61 72 6b 20 6c 61 77 20 66 6f 72 20 75 73 65 20 6f 66 20 73 6f 6d 65 er.trademark.law.for.use.of.some
286e0 0a 20 20 20 20 20 20 20 20 20 20 74 72 61 64 65 20 6e 61 6d 65 73 2c 20 74 72 61 64 65 6d 61 72 ...........trade.names,.trademar
28700 6b 73 2c 20 6f 72 20 73 65 72 76 69 63 65 20 6d 61 72 6b 73 3b 20 6f 72 0a 0a 20 20 20 20 20 20 ks,.or.service.marks;.or........
28720 20 66 2e 20 52 65 71 75 69 72 69 6e 67 20 69 6e 64 65 6d 6e 69 66 69 63 61 74 69 6f 6e 20 6f 66 .f..Requiring.indemnification.of
28740 20 6c 69 63 65 6e 73 6f 72 73 20 61 6e 64 20 61 75 74 68 6f 72 73 20 6f 66 20 74 68 61 74 0a 20 .licensors.and.authors.of.that..
28760 20 20 20 20 20 20 20 20 20 6d 61 74 65 72 69 61 6c 20 62 79 20 61 6e 79 6f 6e 65 20 77 68 6f 20 .........material.by.anyone.who.
28780 63 6f 6e 76 65 79 73 20 74 68 65 20 6d 61 74 65 72 69 61 6c 20 28 6f 72 20 6d 6f 64 69 66 69 65 conveys.the.material.(or.modifie
287a0 64 0a 20 20 20 20 20 20 20 20 20 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 69 74 29 20 77 69 74 68 d...........versions.of.it).with
287c0 20 63 6f 6e 74 72 61 63 74 75 61 6c 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 6f 66 20 6c 69 61 62 .contractual.assumptions.of.liab
287e0 69 6c 69 74 79 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 72 65 63 69 70 69 65 6e 74 ility.to...........the.recipient
28800 2c 20 66 6f 72 20 61 6e 79 20 6c 69 61 62 69 6c 69 74 79 20 74 68 61 74 20 74 68 65 73 65 20 63 ,.for.any.liability.that.these.c
28820 6f 6e 74 72 61 63 74 75 61 6c 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 75 6d 70 74 69 6f 6e 73 ontractual...........assumptions
28840 20 64 69 72 65 63 74 6c 79 20 69 6d 70 6f 73 65 20 6f 6e 20 74 68 6f 73 65 20 6c 69 63 65 6e 73 .directly.impose.on.those.licens
28860 6f 72 73 20 61 6e 64 20 61 75 74 68 6f 72 73 2e 0a 0a 20 20 20 20 20 41 6c 6c 20 6f 74 68 65 72 ors.and.authors........All.other
28880 20 6e 6f 6e 2d 70 65 72 6d 69 73 73 69 76 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 74 65 72 6d 73 .non-permissive.additional.terms
288a0 20 61 72 65 20 63 6f 6e 73 69 64 65 72 65 64 20 e2 80 9c 66 75 72 74 68 65 72 0a 20 20 20 20 20 .are.considered....further......
288c0 72 65 73 74 72 69 63 74 69 6f 6e 73 e2 80 9d 20 77 69 74 68 69 6e 20 74 68 65 20 6d 65 61 6e 69 restrictions....within.the.meani
288e0 6e 67 20 6f 66 20 73 65 63 74 69 6f 6e 20 31 30 2e 20 20 49 66 20 74 68 65 20 50 72 6f 67 72 61 ng.of.section.10...If.the.Progra
28900 6d 20 61 73 0a 20 20 20 20 20 79 6f 75 20 72 65 63 65 69 76 65 64 20 69 74 2c 20 6f 72 20 61 6e m.as......you.received.it,.or.an
28920 79 20 70 61 72 74 20 6f 66 20 69 74 2c 20 63 6f 6e 74 61 69 6e 73 20 61 20 6e 6f 74 69 63 65 20 y.part.of.it,.contains.a.notice.
28940 73 74 61 74 69 6e 67 20 74 68 61 74 0a 20 20 20 20 20 69 74 20 69 73 20 67 6f 76 65 72 6e 65 64 stating.that......it.is.governed
28960 20 62 79 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 61 20 74 65 .by.this.License.along.with.a.te
28980 72 6d 20 74 68 61 74 20 69 73 20 61 20 66 75 72 74 68 65 72 0a 20 20 20 20 20 72 65 73 74 72 69 rm.that.is.a.further......restri
289a0 63 74 69 6f 6e 2c 20 79 6f 75 20 6d 61 79 20 72 65 6d 6f 76 65 20 74 68 61 74 20 74 65 72 6d 2e ction,.you.may.remove.that.term.
289c0 20 20 49 66 20 61 20 6c 69 63 65 6e 73 65 20 64 6f 63 75 6d 65 6e 74 0a 20 20 20 20 20 63 6f 6e ..If.a.license.document......con
289e0 74 61 69 6e 73 20 61 20 66 75 72 74 68 65 72 20 72 65 73 74 72 69 63 74 69 6f 6e 20 62 75 74 20 tains.a.further.restriction.but.
28a00 70 65 72 6d 69 74 73 20 72 65 6c 69 63 65 6e 73 69 6e 67 20 6f 72 20 63 6f 6e 76 65 79 69 6e 67 permits.relicensing.or.conveying
28a20 0a 20 20 20 20 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 79 6f 75 20 6d 61 ......under.this.License,.you.ma
28a40 79 20 61 64 64 20 74 6f 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 6d 61 74 65 72 69 61 6c y.add.to.a.covered.work.material
28a60 20 67 6f 76 65 72 6e 65 64 0a 20 20 20 20 20 62 79 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 .governed......by.the.terms.of.t
28a80 68 61 74 20 6c 69 63 65 6e 73 65 20 64 6f 63 75 6d 65 6e 74 2c 20 70 72 6f 76 69 64 65 64 20 74 hat.license.document,.provided.t
28aa0 68 61 74 20 74 68 65 20 66 75 72 74 68 65 72 0a 20 20 20 20 20 72 65 73 74 72 69 63 74 69 6f 6e hat.the.further......restriction
28ac0 20 64 6f 65 73 20 6e 6f 74 20 73 75 72 76 69 76 65 20 73 75 63 68 20 72 65 6c 69 63 65 6e 73 69 .does.not.survive.such.relicensi
28ae0 6e 67 20 6f 72 20 63 6f 6e 76 65 79 69 6e 67 2e 0a 0a 20 20 20 20 20 49 66 20 79 6f 75 20 61 64 ng.or.conveying........If.you.ad
28b00 64 20 74 65 72 6d 73 20 74 6f 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 69 6e 20 61 63 63 d.terms.to.a.covered.work.in.acc
28b20 6f 72 64 20 77 69 74 68 20 74 68 69 73 20 73 65 63 74 69 6f 6e 2c 20 79 6f 75 0a 20 20 20 20 20 ord.with.this.section,.you......
28b40 6d 75 73 74 20 70 6c 61 63 65 2c 20 69 6e 20 74 68 65 20 72 65 6c 65 76 61 6e 74 20 73 6f 75 72 must.place,.in.the.relevant.sour
28b60 63 65 20 66 69 6c 65 73 2c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 6f 66 20 74 68 65 0a 20 20 20 ce.files,.a.statement.of.the....
28b80 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 74 65 72 6d 73 20 74 68 61 74 20 61 70 70 6c 79 20 74 6f ..additional.terms.that.apply.to
28ba0 20 74 68 6f 73 65 20 66 69 6c 65 73 2c 20 6f 72 20 61 20 6e 6f 74 69 63 65 20 69 6e 64 69 63 61 .those.files,.or.a.notice.indica
28bc0 74 69 6e 67 0a 20 20 20 20 20 77 68 65 72 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 61 70 70 6c ting......where.to.find.the.appl
28be0 69 63 61 62 6c 65 20 74 65 72 6d 73 2e 0a 0a 20 20 20 20 20 41 64 64 69 74 69 6f 6e 61 6c 20 74 icable.terms........Additional.t
28c00 65 72 6d 73 2c 20 70 65 72 6d 69 73 73 69 76 65 20 6f 72 20 6e 6f 6e 2d 70 65 72 6d 69 73 73 69 erms,.permissive.or.non-permissi
28c20 76 65 2c 20 6d 61 79 20 62 65 20 73 74 61 74 65 64 20 69 6e 0a 20 20 20 20 20 74 68 65 20 66 6f ve,.may.be.stated.in......the.fo
28c40 72 6d 20 6f 66 20 61 20 73 65 70 61 72 61 74 65 6c 79 20 77 72 69 74 74 65 6e 20 6c 69 63 65 6e rm.of.a.separately.written.licen
28c60 73 65 2c 20 6f 72 20 73 74 61 74 65 64 20 61 73 20 65 78 63 65 70 74 69 6f 6e 73 3b 0a 20 20 20 se,.or.stated.as.exceptions;....
28c80 20 20 74 68 65 20 61 62 6f 76 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 61 70 70 6c 79 20 65 ..the.above.requirements.apply.e
28ca0 69 74 68 65 72 20 77 61 79 2e 0a 0a 20 20 38 2e 20 54 65 72 6d 69 6e 61 74 69 6f 6e 2e 0a 0a 20 ither.way.....8..Termination....
28cc0 20 20 20 20 59 6f 75 20 6d 61 79 20 6e 6f 74 20 70 72 6f 70 61 67 61 74 65 20 6f 72 20 6d 6f 64 ....You.may.not.propagate.or.mod
28ce0 69 66 79 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 65 78 63 65 70 74 20 61 73 20 65 78 70 ify.a.covered.work.except.as.exp
28d00 72 65 73 73 6c 79 0a 20 20 20 20 20 70 72 6f 76 69 64 65 64 20 75 6e 64 65 72 20 74 68 69 73 20 ressly......provided.under.this.
28d20 4c 69 63 65 6e 73 65 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 6f 74 68 65 72 77 69 73 65 20 License...Any.attempt.otherwise.
28d40 74 6f 20 70 72 6f 70 61 67 61 74 65 20 6f 72 0a 20 20 20 20 20 6d 6f 64 69 66 79 20 69 74 20 69 to.propagate.or......modify.it.i
28d60 73 20 76 6f 69 64 2c 20 61 6e 64 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 s.void,.and.will.automatically.t
28d80 65 72 6d 69 6e 61 74 65 20 79 6f 75 72 20 72 69 67 68 74 73 0a 20 20 20 20 20 75 6e 64 65 72 20 erminate.your.rights......under.
28da0 74 68 69 73 20 4c 69 63 65 6e 73 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 61 6e 79 20 70 61 74 65 this.License.(including.any.pate
28dc0 6e 74 20 6c 69 63 65 6e 73 65 73 20 67 72 61 6e 74 65 64 20 75 6e 64 65 72 20 74 68 65 0a 20 20 nt.licenses.granted.under.the...
28de0 20 20 20 74 68 69 72 64 20 70 61 72 61 67 72 61 70 68 20 6f 66 20 73 65 63 74 69 6f 6e 20 31 31 ...third.paragraph.of.section.11
28e00 29 2e 0a 0a 20 20 20 20 20 48 6f 77 65 76 65 72 2c 20 69 66 20 79 6f 75 20 63 65 61 73 65 20 61 )........However,.if.you.cease.a
28e20 6c 6c 20 76 69 6f 6c 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 74 68 ll.violation.of.this.License,.th
28e40 65 6e 20 79 6f 75 72 0a 20 20 20 20 20 6c 69 63 65 6e 73 65 20 66 72 6f 6d 20 61 20 70 61 72 74 en.your......license.from.a.part
28e60 69 63 75 6c 61 72 20 63 6f 70 79 72 69 67 68 74 20 68 6f 6c 64 65 72 20 69 73 20 72 65 69 6e 73 icular.copyright.holder.is.reins
28e80 74 61 74 65 64 20 28 61 29 0a 20 20 20 20 20 70 72 6f 76 69 73 69 6f 6e 61 6c 6c 79 2c 20 75 6e tated.(a)......provisionally,.un
28ea0 6c 65 73 73 20 61 6e 64 20 75 6e 74 69 6c 20 74 68 65 20 63 6f 70 79 72 69 67 68 74 20 68 6f 6c less.and.until.the.copyright.hol
28ec0 64 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 61 6e 64 0a 20 20 20 20 20 66 69 6e 61 6c 6c 79 20 der.explicitly.and......finally.
28ee0 74 65 72 6d 69 6e 61 74 65 73 20 79 6f 75 72 20 6c 69 63 65 6e 73 65 2c 20 61 6e 64 20 28 62 29 terminates.your.license,.and.(b)
28f00 20 70 65 72 6d 61 6e 65 6e 74 6c 79 2c 20 69 66 20 74 68 65 0a 20 20 20 20 20 63 6f 70 79 72 69 .permanently,.if.the......copyri
28f20 67 68 74 20 68 6f 6c 64 65 72 20 66 61 69 6c 73 20 74 6f 20 6e 6f 74 69 66 79 20 79 6f 75 20 6f ght.holder.fails.to.notify.you.o
28f40 66 20 74 68 65 20 76 69 6f 6c 61 74 69 6f 6e 20 62 79 20 73 6f 6d 65 0a 20 20 20 20 20 72 65 61 f.the.violation.by.some......rea
28f60 73 6f 6e 61 62 6c 65 20 6d 65 61 6e 73 20 70 72 69 6f 72 20 74 6f 20 36 30 20 64 61 79 73 20 61 sonable.means.prior.to.60.days.a
28f80 66 74 65 72 20 74 68 65 20 63 65 73 73 61 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 4d 6f 72 65 6f 76 fter.the.cessation........Moreov
28fa0 65 72 2c 20 79 6f 75 72 20 6c 69 63 65 6e 73 65 20 66 72 6f 6d 20 61 20 70 61 72 74 69 63 75 6c er,.your.license.from.a.particul
28fc0 61 72 20 63 6f 70 79 72 69 67 68 74 20 68 6f 6c 64 65 72 20 69 73 0a 20 20 20 20 20 72 65 69 6e ar.copyright.holder.is......rein
28fe0 73 74 61 74 65 64 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 69 66 20 74 68 65 20 63 6f 70 79 72 69 stated.permanently.if.the.copyri
29000 67 68 74 20 68 6f 6c 64 65 72 20 6e 6f 74 69 66 69 65 73 20 79 6f 75 20 6f 66 20 74 68 65 0a 20 ght.holder.notifies.you.of.the..
29020 20 20 20 20 76 69 6f 6c 61 74 69 6f 6e 20 62 79 20 73 6f 6d 65 20 72 65 61 73 6f 6e 61 62 6c 65 ....violation.by.some.reasonable
29040 20 6d 65 61 6e 73 2c 20 74 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 79 .means,.this.is.the.first.time.y
29060 6f 75 20 68 61 76 65 0a 20 20 20 20 20 72 65 63 65 69 76 65 64 20 6e 6f 74 69 63 65 20 6f 66 20 ou.have......received.notice.of.
29080 76 69 6f 6c 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 28 66 6f 72 20 61 violation.of.this.License.(for.a
290a0 6e 79 20 77 6f 72 6b 29 20 66 72 6f 6d 0a 20 20 20 20 20 74 68 61 74 20 63 6f 70 79 72 69 67 68 ny.work).from......that.copyrigh
290c0 74 20 68 6f 6c 64 65 72 2c 20 61 6e 64 20 79 6f 75 20 63 75 72 65 20 74 68 65 20 76 69 6f 6c 61 t.holder,.and.you.cure.the.viola
290e0 74 69 6f 6e 20 70 72 69 6f 72 20 74 6f 20 33 30 20 64 61 79 73 0a 20 20 20 20 20 61 66 74 65 72 tion.prior.to.30.days......after
29100 20 79 6f 75 72 20 72 65 63 65 69 70 74 20 6f 66 20 74 68 65 20 6e 6f 74 69 63 65 2e 0a 0a 20 20 .your.receipt.of.the.notice.....
29120 20 20 20 54 65 72 6d 69 6e 61 74 69 6f 6e 20 6f 66 20 79 6f 75 72 20 72 69 67 68 74 73 20 75 6e ...Termination.of.your.rights.un
29140 64 65 72 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 74 65 72 6d 69 6e der.this.section.does.not.termin
29160 61 74 65 0a 20 20 20 20 20 74 68 65 20 6c 69 63 65 6e 73 65 73 20 6f 66 20 70 61 72 74 69 65 73 ate......the.licenses.of.parties
29180 20 77 68 6f 20 68 61 76 65 20 72 65 63 65 69 76 65 64 20 63 6f 70 69 65 73 20 6f 72 20 72 69 67 .who.have.received.copies.or.rig
291a0 68 74 73 20 66 72 6f 6d 20 79 6f 75 0a 20 20 20 20 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 hts.from.you......under.this.Lic
291c0 65 6e 73 65 2e 20 20 49 66 20 79 6f 75 72 20 72 69 67 68 74 73 20 68 61 76 65 20 62 65 65 6e 20 ense...If.your.rights.have.been.
291e0 74 65 72 6d 69 6e 61 74 65 64 20 61 6e 64 20 6e 6f 74 0a 20 20 20 20 20 70 65 72 6d 61 6e 65 6e terminated.and.not......permanen
29200 74 6c 79 20 72 65 69 6e 73 74 61 74 65 64 2c 20 79 6f 75 20 64 6f 20 6e 6f 74 20 71 75 61 6c 69 tly.reinstated,.you.do.not.quali
29220 66 79 20 74 6f 20 72 65 63 65 69 76 65 20 6e 65 77 20 6c 69 63 65 6e 73 65 73 0a 20 20 20 20 20 fy.to.receive.new.licenses......
29240 66 6f 72 20 74 68 65 20 73 61 6d 65 20 6d 61 74 65 72 69 61 6c 20 75 6e 64 65 72 20 73 65 63 74 for.the.same.material.under.sect
29260 69 6f 6e 20 31 30 2e 0a 0a 20 20 39 2e 20 41 63 63 65 70 74 61 6e 63 65 20 4e 6f 74 20 52 65 71 ion.10.....9..Acceptance.Not.Req
29280 75 69 72 65 64 20 66 6f 72 20 48 61 76 69 6e 67 20 43 6f 70 69 65 73 2e 0a 0a 20 20 20 20 20 59 uired.for.Having.Copies........Y
292a0 6f 75 20 61 72 65 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 63 63 65 70 74 20 74 68 ou.are.not.required.to.accept.th
292c0 69 73 20 4c 69 63 65 6e 73 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 72 65 63 65 69 76 65 20 6f is.License.in.order.to.receive.o
292e0 72 0a 20 20 20 20 20 72 75 6e 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 50 72 6f 67 72 61 6d r......run.a.copy.of.the.Program
29300 2e 20 20 41 6e 63 69 6c 6c 61 72 79 20 70 72 6f 70 61 67 61 74 69 6f 6e 20 6f 66 20 61 20 63 6f ...Ancillary.propagation.of.a.co
29320 76 65 72 65 64 20 77 6f 72 6b 0a 20 20 20 20 20 6f 63 63 75 72 72 69 6e 67 20 73 6f 6c 65 6c 79 vered.work......occurring.solely
29340 20 61 73 20 61 20 63 6f 6e 73 65 71 75 65 6e 63 65 20 6f 66 20 75 73 69 6e 67 20 70 65 65 72 2d .as.a.consequence.of.using.peer-
29360 74 6f 2d 70 65 65 72 0a 20 20 20 20 20 74 72 61 6e 73 6d 69 73 73 69 6f 6e 20 74 6f 20 72 65 63 to-peer......transmission.to.rec
29380 65 69 76 65 20 61 20 63 6f 70 79 20 6c 69 6b 65 77 69 73 65 20 64 6f 65 73 20 6e 6f 74 20 72 65 eive.a.copy.likewise.does.not.re
293a0 71 75 69 72 65 0a 20 20 20 20 20 61 63 63 65 70 74 61 6e 63 65 2e 20 20 48 6f 77 65 76 65 72 2c quire......acceptance...However,
293c0 20 6e 6f 74 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 69 73 20 4c 69 63 65 6e 73 65 .nothing.other.than.this.License
293e0 20 67 72 61 6e 74 73 20 79 6f 75 0a 20 20 20 20 20 70 65 72 6d 69 73 73 69 6f 6e 20 74 6f 20 70 .grants.you......permission.to.p
29400 72 6f 70 61 67 61 74 65 20 6f 72 20 6d 6f 64 69 66 79 20 61 6e 79 20 63 6f 76 65 72 65 64 20 77 ropagate.or.modify.any.covered.w
29420 6f 72 6b 2e 20 20 54 68 65 73 65 20 61 63 74 69 6f 6e 73 0a 20 20 20 20 20 69 6e 66 72 69 6e 67 ork...These.actions......infring
29440 65 20 63 6f 70 79 72 69 67 68 74 20 69 66 20 79 6f 75 20 64 6f 20 6e 6f 74 20 61 63 63 65 70 74 e.copyright.if.you.do.not.accept
29460 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 0a 20 20 20 20 20 .this.License...Therefore,......
29480 62 79 20 6d 6f 64 69 66 79 69 6e 67 20 6f 72 20 70 72 6f 70 61 67 61 74 69 6e 67 20 61 20 63 6f by.modifying.or.propagating.a.co
294a0 76 65 72 65 64 20 77 6f 72 6b 2c 20 79 6f 75 20 69 6e 64 69 63 61 74 65 20 79 6f 75 72 0a 20 20 vered.work,.you.indicate.your...
294c0 20 20 20 61 63 63 65 70 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 74 6f ...acceptance.of.this.License.to
294e0 20 64 6f 20 73 6f 2e 0a 0a 20 20 31 30 2e 20 41 75 74 6f 6d 61 74 69 63 20 4c 69 63 65 6e 73 69 .do.so.....10..Automatic.Licensi
29500 6e 67 20 6f 66 20 44 6f 77 6e 73 74 72 65 61 6d 20 52 65 63 69 70 69 65 6e 74 73 2e 0a 0a 20 20 ng.of.Downstream.Recipients.....
29520 20 20 20 45 61 63 68 20 74 69 6d 65 20 79 6f 75 20 63 6f 6e 76 65 79 20 61 20 63 6f 76 65 72 65 ...Each.time.you.convey.a.covere
29540 64 20 77 6f 72 6b 2c 20 74 68 65 20 72 65 63 69 70 69 65 6e 74 20 61 75 74 6f 6d 61 74 69 63 61 d.work,.the.recipient.automatica
29560 6c 6c 79 0a 20 20 20 20 20 72 65 63 65 69 76 65 73 20 61 20 6c 69 63 65 6e 73 65 20 66 72 6f 6d lly......receives.a.license.from
29580 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 6c 69 63 65 6e 73 6f 72 73 2c 20 74 6f 20 72 75 6e 2c .the.original.licensors,.to.run,
295a0 20 6d 6f 64 69 66 79 20 61 6e 64 0a 20 20 20 20 20 70 72 6f 70 61 67 61 74 65 20 74 68 61 74 20 .modify.and......propagate.that.
295c0 77 6f 72 6b 2c 20 73 75 62 6a 65 63 74 20 74 6f 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2e 20 20 work,.subject.to.this.License...
295e0 59 6f 75 20 61 72 65 20 6e 6f 74 0a 20 20 20 20 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 You.are.not......responsible.for
29600 20 65 6e 66 6f 72 63 69 6e 67 20 63 6f 6d 70 6c 69 61 6e 63 65 20 62 79 20 74 68 69 72 64 20 70 .enforcing.compliance.by.third.p
29620 61 72 74 69 65 73 20 77 69 74 68 20 74 68 69 73 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 2e 0a 0a arties.with.this......License...
29640 20 20 20 20 20 41 6e 20 e2 80 9c 65 6e 74 69 74 79 20 74 72 61 6e 73 61 63 74 69 6f 6e e2 80 9d .....An....entity.transaction...
29660 20 69 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 72 61 6e 73 66 65 72 72 69 6e 67 20 63 .is.a.transaction.transferring.c
29680 6f 6e 74 72 6f 6c 20 6f 66 20 61 6e 0a 20 20 20 20 20 6f 72 67 61 6e 69 7a 61 74 69 6f 6e 2c 20 ontrol.of.an......organization,.
296a0 6f 72 20 73 75 62 73 74 61 6e 74 69 61 6c 6c 79 20 61 6c 6c 20 61 73 73 65 74 73 20 6f 66 20 6f or.substantially.all.assets.of.o
296c0 6e 65 2c 20 6f 72 20 73 75 62 64 69 76 69 64 69 6e 67 20 61 6e 0a 20 20 20 20 20 6f 72 67 61 6e ne,.or.subdividing.an......organ
296e0 69 7a 61 74 69 6f 6e 2c 20 6f 72 20 6d 65 72 67 69 6e 67 20 6f 72 67 61 6e 69 7a 61 74 69 6f 6e ization,.or.merging.organization
29700 73 2e 20 20 49 66 20 70 72 6f 70 61 67 61 74 69 6f 6e 20 6f 66 20 61 0a 20 20 20 20 20 63 6f 76 s...If.propagation.of.a......cov
29720 65 72 65 64 20 77 6f 72 6b 20 72 65 73 75 6c 74 73 20 66 72 6f 6d 20 61 6e 20 65 6e 74 69 74 79 ered.work.results.from.an.entity
29740 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 65 61 63 68 20 70 61 72 74 79 20 74 6f 20 74 68 61 74 .transaction,.each.party.to.that
29760 0a 20 20 20 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 68 6f 20 72 65 63 65 69 76 65 73 20 61 ......transaction.who.receives.a
29780 20 63 6f 70 79 20 6f 66 20 74 68 65 20 77 6f 72 6b 20 61 6c 73 6f 20 72 65 63 65 69 76 65 73 20 .copy.of.the.work.also.receives.
297a0 77 68 61 74 65 76 65 72 0a 20 20 20 20 20 6c 69 63 65 6e 73 65 73 20 74 6f 20 74 68 65 20 77 6f whatever......licenses.to.the.wo
297c0 72 6b 20 74 68 65 20 70 61 72 74 79 e2 80 99 73 20 70 72 65 64 65 63 65 73 73 6f 72 20 69 6e 20 rk.the.party...s.predecessor.in.
297e0 69 6e 74 65 72 65 73 74 20 68 61 64 20 6f 72 0a 20 20 20 20 20 63 6f 75 6c 64 20 67 69 76 65 20 interest.had.or......could.give.
29800 75 6e 64 65 72 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 70 61 72 61 67 72 61 70 68 2c 20 70 6c under.the.previous.paragraph,.pl
29820 75 73 20 61 20 72 69 67 68 74 20 74 6f 20 70 6f 73 73 65 73 73 69 6f 6e 0a 20 20 20 20 20 6f 66 us.a.right.to.possession......of
29840 20 74 68 65 20 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 6f 66 20 74 68 65 .the.Corresponding.Source.of.the
29860 20 77 6f 72 6b 20 66 72 6f 6d 20 74 68 65 20 70 72 65 64 65 63 65 73 73 6f 72 20 69 6e 0a 20 20 .work.from.the.predecessor.in...
29880 20 20 20 69 6e 74 65 72 65 73 74 2c 20 69 66 20 74 68 65 20 70 72 65 64 65 63 65 73 73 6f 72 20 ...interest,.if.the.predecessor.
298a0 68 61 73 20 69 74 20 6f 72 20 63 61 6e 20 67 65 74 20 69 74 20 77 69 74 68 20 72 65 61 73 6f 6e has.it.or.can.get.it.with.reason
298c0 61 62 6c 65 0a 20 20 20 20 20 65 66 66 6f 72 74 73 2e 0a 0a 20 20 20 20 20 59 6f 75 20 6d 61 79 able......efforts........You.may
298e0 20 6e 6f 74 20 69 6d 70 6f 73 65 20 61 6e 79 20 66 75 72 74 68 65 72 20 72 65 73 74 72 69 63 74 .not.impose.any.further.restrict
29900 69 6f 6e 73 20 6f 6e 20 74 68 65 20 65 78 65 72 63 69 73 65 20 6f 66 20 74 68 65 0a 20 20 20 20 ions.on.the.exercise.of.the.....
29920 20 72 69 67 68 74 73 20 67 72 61 6e 74 65 64 20 6f 72 20 61 66 66 69 72 6d 65 64 20 75 6e 64 65 .rights.granted.or.affirmed.unde
29940 72 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f r.this.License...For.example,.yo
29960 75 0a 20 20 20 20 20 6d 61 79 20 6e 6f 74 20 69 6d 70 6f 73 65 20 61 20 6c 69 63 65 6e 73 65 20 u......may.not.impose.a.license.
29980 66 65 65 2c 20 72 6f 79 61 6c 74 79 2c 20 6f 72 20 6f 74 68 65 72 20 63 68 61 72 67 65 20 66 6f fee,.royalty,.or.other.charge.fo
299a0 72 20 65 78 65 72 63 69 73 65 0a 20 20 20 20 20 6f 66 20 72 69 67 68 74 73 20 67 72 61 6e 74 65 r.exercise......of.rights.grante
299c0 64 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 61 6e 64 20 79 6f 75 20 6d 61 d.under.this.License,.and.you.ma
299e0 79 20 6e 6f 74 20 69 6e 69 74 69 61 74 65 0a 20 20 20 20 20 6c 69 74 69 67 61 74 69 6f 6e 20 28 y.not.initiate......litigation.(
29a00 69 6e 63 6c 75 64 69 6e 67 20 61 20 63 72 6f 73 73 2d 63 6c 61 69 6d 20 6f 72 20 63 6f 75 6e 74 including.a.cross-claim.or.count
29a20 65 72 63 6c 61 69 6d 20 69 6e 20 61 20 6c 61 77 73 75 69 74 29 0a 20 20 20 20 20 61 6c 6c 65 67 erclaim.in.a.lawsuit)......alleg
29a40 69 6e 67 20 74 68 61 74 20 61 6e 79 20 70 61 74 65 6e 74 20 63 6c 61 69 6d 20 69 73 20 69 6e 66 ing.that.any.patent.claim.is.inf
29a60 72 69 6e 67 65 64 20 62 79 20 6d 61 6b 69 6e 67 2c 20 75 73 69 6e 67 2c 0a 20 20 20 20 20 73 65 ringed.by.making,.using,......se
29a80 6c 6c 69 6e 67 2c 20 6f 66 66 65 72 69 6e 67 20 66 6f 72 20 73 61 6c 65 2c 20 6f 72 20 69 6d 70 lling,.offering.for.sale,.or.imp
29aa0 6f 72 74 69 6e 67 20 74 68 65 20 50 72 6f 67 72 61 6d 20 6f 72 20 61 6e 79 20 70 6f 72 74 69 6f orting.the.Program.or.any.portio
29ac0 6e 0a 20 20 20 20 20 6f 66 20 69 74 2e 0a 0a 20 20 31 31 2e 20 50 61 74 65 6e 74 73 2e 0a 0a 20 n......of.it.....11..Patents....
29ae0 20 20 20 20 41 20 e2 80 9c 63 6f 6e 74 72 69 62 75 74 6f 72 e2 80 9d 20 69 73 20 61 20 63 6f 70 ....A....contributor....is.a.cop
29b00 79 72 69 67 68 74 20 68 6f 6c 64 65 72 20 77 68 6f 20 61 75 74 68 6f 72 69 7a 65 73 20 75 73 65 yright.holder.who.authorizes.use
29b20 20 75 6e 64 65 72 20 74 68 69 73 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 20 6f 66 20 74 68 65 20 .under.this......License.of.the.
29b40 50 72 6f 67 72 61 6d 20 6f 72 20 61 20 77 6f 72 6b 20 6f 6e 20 77 68 69 63 68 20 74 68 65 20 50 Program.or.a.work.on.which.the.P
29b60 72 6f 67 72 61 6d 20 69 73 20 62 61 73 65 64 2e 0a 20 20 20 20 20 54 68 65 20 77 6f 72 6b 20 74 rogram.is.based.......The.work.t
29b80 68 75 73 20 6c 69 63 65 6e 73 65 64 20 69 73 20 63 61 6c 6c 65 64 20 74 68 65 20 63 6f 6e 74 72 hus.licensed.is.called.the.contr
29ba0 69 62 75 74 6f 72 e2 80 99 73 20 e2 80 9c 63 6f 6e 74 72 69 62 75 74 6f 72 0a 20 20 20 20 20 76 ibutor...s....contributor......v
29bc0 65 72 73 69 6f 6e e2 80 9d 2e 0a 0a 20 20 20 20 20 41 20 63 6f 6e 74 72 69 62 75 74 6f 72 e2 80 ersion...........A.contributor..
29be0 99 73 20 e2 80 9c 65 73 73 65 6e 74 69 61 6c 20 70 61 74 65 6e 74 20 63 6c 61 69 6d 73 e2 80 9d .s....essential.patent.claims...
29c00 20 61 72 65 20 61 6c 6c 20 70 61 74 65 6e 74 20 63 6c 61 69 6d 73 0a 20 20 20 20 20 6f 77 6e 65 .are.all.patent.claims......owne
29c20 64 20 6f 72 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 20 74 68 65 20 63 6f 6e 74 72 69 62 75 74 d.or.controlled.by.the.contribut
29c40 6f 72 2c 20 77 68 65 74 68 65 72 20 61 6c 72 65 61 64 79 20 61 63 71 75 69 72 65 64 20 6f 72 0a or,.whether.already.acquired.or.
29c60 20 20 20 20 20 68 65 72 65 61 66 74 65 72 20 61 63 71 75 69 72 65 64 2c 20 74 68 61 74 20 77 6f .....hereafter.acquired,.that.wo
29c80 75 6c 64 20 62 65 20 69 6e 66 72 69 6e 67 65 64 20 62 79 20 73 6f 6d 65 20 6d 61 6e 6e 65 72 2c uld.be.infringed.by.some.manner,
29ca0 0a 20 20 20 20 20 70 65 72 6d 69 74 74 65 64 20 62 79 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c ......permitted.by.this.License,
29cc0 20 6f 66 20 6d 61 6b 69 6e 67 2c 20 75 73 69 6e 67 2c 20 6f 72 20 73 65 6c 6c 69 6e 67 20 69 74 .of.making,.using,.or.selling.it
29ce0 73 0a 20 20 20 20 20 63 6f 6e 74 72 69 62 75 74 6f 72 20 76 65 72 73 69 6f 6e 2c 20 62 75 74 20 s......contributor.version,.but.
29d00 64 6f 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 63 6c 61 69 6d 73 20 74 68 61 74 20 77 6f 75 6c 64 do.not.include.claims.that.would
29d20 20 62 65 0a 20 20 20 20 20 69 6e 66 72 69 6e 67 65 64 20 6f 6e 6c 79 20 61 73 20 61 20 63 6f 6e .be......infringed.only.as.a.con
29d40 73 65 71 75 65 6e 63 65 20 6f 66 20 66 75 72 74 68 65 72 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e sequence.of.further.modification
29d60 20 6f 66 20 74 68 65 0a 20 20 20 20 20 63 6f 6e 74 72 69 62 75 74 6f 72 20 76 65 72 73 69 6f 6e .of.the......contributor.version
29d80 2e 20 20 46 6f 72 20 70 75 72 70 6f 73 65 73 20 6f 66 20 74 68 69 73 20 64 65 66 69 6e 69 74 69 ...For.purposes.of.this.definiti
29da0 6f 6e 2c 20 e2 80 9c 63 6f 6e 74 72 6f 6c e2 80 9d 0a 20 20 20 20 20 69 6e 63 6c 75 64 65 73 20 on,....control.........includes.
29dc0 74 68 65 20 72 69 67 68 74 20 74 6f 20 67 72 61 6e 74 20 70 61 74 65 6e 74 20 73 75 62 6c 69 63 the.right.to.grant.patent.sublic
29de0 65 6e 73 65 73 20 69 6e 20 61 20 6d 61 6e 6e 65 72 0a 20 20 20 20 20 63 6f 6e 73 69 73 74 65 6e enses.in.a.manner......consisten
29e00 74 20 77 69 74 68 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 6f 66 20 74 68 69 73 20 t.with.the.requirements.of.this.
29e20 4c 69 63 65 6e 73 65 2e 0a 0a 20 20 20 20 20 45 61 63 68 20 63 6f 6e 74 72 69 62 75 74 6f 72 20 License........Each.contributor.
29e40 67 72 61 6e 74 73 20 79 6f 75 20 61 20 6e 6f 6e 2d 65 78 63 6c 75 73 69 76 65 2c 20 77 6f 72 6c grants.you.a.non-exclusive,.worl
29e60 64 77 69 64 65 2c 0a 20 20 20 20 20 72 6f 79 61 6c 74 79 2d 66 72 65 65 20 70 61 74 65 6e 74 20 dwide,......royalty-free.patent.
29e80 6c 69 63 65 6e 73 65 20 75 6e 64 65 72 20 74 68 65 20 63 6f 6e 74 72 69 62 75 74 6f 72 e2 80 99 license.under.the.contributor...
29ea0 73 20 65 73 73 65 6e 74 69 61 6c 0a 20 20 20 20 20 70 61 74 65 6e 74 20 63 6c 61 69 6d 73 2c 20 s.essential......patent.claims,.
29ec0 74 6f 20 6d 61 6b 65 2c 20 75 73 65 2c 20 73 65 6c 6c 2c 20 6f 66 66 65 72 20 66 6f 72 20 73 61 to.make,.use,.sell,.offer.for.sa
29ee0 6c 65 2c 20 69 6d 70 6f 72 74 20 61 6e 64 0a 20 20 20 20 20 6f 74 68 65 72 77 69 73 65 20 72 75 le,.import.and......otherwise.ru
29f00 6e 2c 20 6d 6f 64 69 66 79 20 61 6e 64 20 70 72 6f 70 61 67 61 74 65 20 74 68 65 20 63 6f 6e 74 n,.modify.and.propagate.the.cont
29f20 65 6e 74 73 20 6f 66 20 69 74 73 20 63 6f 6e 74 72 69 62 75 74 6f 72 0a 20 20 20 20 20 76 65 72 ents.of.its.contributor......ver
29f40 73 69 6f 6e 2e 0a 0a 20 20 20 20 20 49 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 72 sion........In.the.following.thr
29f60 65 65 20 70 61 72 61 67 72 61 70 68 73 2c 20 61 20 e2 80 9c 70 61 74 65 6e 74 20 6c 69 63 65 6e ee.paragraphs,.a....patent.licen
29f80 73 65 e2 80 9d 20 69 73 20 61 6e 79 0a 20 20 20 20 20 65 78 70 72 65 73 73 20 61 67 72 65 65 6d se....is.any......express.agreem
29fa0 65 6e 74 20 6f 72 20 63 6f 6d 6d 69 74 6d 65 6e 74 2c 20 68 6f 77 65 76 65 72 20 64 65 6e 6f 6d ent.or.commitment,.however.denom
29fc0 69 6e 61 74 65 64 2c 20 6e 6f 74 20 74 6f 0a 20 20 20 20 20 65 6e 66 6f 72 63 65 20 61 20 70 61 inated,.not.to......enforce.a.pa
29fe0 74 65 6e 74 20 28 73 75 63 68 20 61 73 20 61 6e 20 65 78 70 72 65 73 73 20 70 65 72 6d 69 73 73 tent.(such.as.an.express.permiss
2a000 69 6f 6e 20 74 6f 20 70 72 61 63 74 69 63 65 20 61 0a 20 20 20 20 20 70 61 74 65 6e 74 20 6f 72 ion.to.practice.a......patent.or
2a020 20 63 6f 76 65 6e 61 6e 74 20 6e 6f 74 20 74 6f 20 73 75 65 20 66 6f 72 20 70 61 74 65 6e 74 20 .covenant.not.to.sue.for.patent.
2a040 69 6e 66 72 69 6e 67 65 6d 65 6e 74 29 2e 20 20 54 6f 20 e2 80 9c 67 72 61 6e 74 e2 80 9d 0a 20 infringement)...To....grant.....
2a060 20 20 20 20 73 75 63 68 20 61 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 74 6f 20 61 20 70 ....such.a.patent.license.to.a.p
2a080 61 72 74 79 20 6d 65 61 6e 73 20 74 6f 20 6d 61 6b 65 20 73 75 63 68 20 61 6e 20 61 67 72 65 65 arty.means.to.make.such.an.agree
2a0a0 6d 65 6e 74 20 6f 72 0a 20 20 20 20 20 63 6f 6d 6d 69 74 6d 65 6e 74 20 6e 6f 74 20 74 6f 20 65 ment.or......commitment.not.to.e
2a0c0 6e 66 6f 72 63 65 20 61 20 70 61 74 65 6e 74 20 61 67 61 69 6e 73 74 20 74 68 65 20 70 61 72 74 nforce.a.patent.against.the.part
2a0e0 79 2e 0a 0a 20 20 20 20 20 49 66 20 79 6f 75 20 63 6f 6e 76 65 79 20 61 20 63 6f 76 65 72 65 64 y........If.you.convey.a.covered
2a100 20 77 6f 72 6b 2c 20 6b 6e 6f 77 69 6e 67 6c 79 20 72 65 6c 79 69 6e 67 20 6f 6e 20 61 20 70 61 .work,.knowingly.relying.on.a.pa
2a120 74 65 6e 74 0a 20 20 20 20 20 6c 69 63 65 6e 73 65 2c 20 61 6e 64 20 74 68 65 20 43 6f 72 72 65 tent......license,.and.the.Corre
2a140 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 6f 66 20 74 68 65 20 77 6f 72 6b 20 69 73 20 6e sponding.Source.of.the.work.is.n
2a160 6f 74 20 61 76 61 69 6c 61 62 6c 65 0a 20 20 20 20 20 66 6f 72 20 61 6e 79 6f 6e 65 20 74 6f 20 ot.available......for.anyone.to.
2a180 63 6f 70 79 2c 20 66 72 65 65 20 6f 66 20 63 68 61 72 67 65 20 61 6e 64 20 75 6e 64 65 72 20 74 copy,.free.of.charge.and.under.t
2a1a0 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 69 73 0a 20 20 20 20 20 4c 69 63 65 6e 73 65 2c 20 74 he.terms.of.this......License,.t
2a1c0 68 72 6f 75 67 68 20 61 20 70 75 62 6c 69 63 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 6e 65 74 77 hrough.a.publicly.available.netw
2a1e0 6f 72 6b 20 73 65 72 76 65 72 20 6f 72 20 6f 74 68 65 72 0a 20 20 20 20 20 72 65 61 64 69 6c 79 ork.server.or.other......readily
2a200 20 61 63 63 65 73 73 69 62 6c 65 20 6d 65 61 6e 73 2c 20 74 68 65 6e 20 79 6f 75 20 6d 75 73 74 .accessible.means,.then.you.must
2a220 20 65 69 74 68 65 72 20 28 31 29 20 63 61 75 73 65 20 74 68 65 0a 20 20 20 20 20 43 6f 72 72 65 .either.(1).cause.the......Corre
2a240 73 70 6f 6e 64 69 6e 67 20 53 6f 75 72 63 65 20 74 6f 20 62 65 20 73 6f 20 61 76 61 69 6c 61 62 sponding.Source.to.be.so.availab
2a260 6c 65 2c 20 6f 72 20 28 32 29 20 61 72 72 61 6e 67 65 20 74 6f 20 64 65 70 72 69 76 65 0a 20 20 le,.or.(2).arrange.to.deprive...
2a280 20 20 20 79 6f 75 72 73 65 6c 66 20 6f 66 20 74 68 65 20 62 65 6e 65 66 69 74 20 6f 66 20 74 68 ...yourself.of.the.benefit.of.th
2a2a0 65 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 66 6f 72 20 74 68 69 73 20 70 61 72 74 69 63 e.patent.license.for.this.partic
2a2c0 75 6c 61 72 0a 20 20 20 20 20 77 6f 72 6b 2c 20 6f 72 20 28 33 29 20 61 72 72 61 6e 67 65 2c 20 ular......work,.or.(3).arrange,.
2a2e0 69 6e 20 61 20 6d 61 6e 6e 65 72 20 63 6f 6e 73 69 73 74 65 6e 74 20 77 69 74 68 20 74 68 65 20 in.a.manner.consistent.with.the.
2a300 72 65 71 75 69 72 65 6d 65 6e 74 73 0a 20 20 20 20 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 requirements......of.this.Licens
2a320 65 2c 20 74 6f 20 65 78 74 65 6e 64 20 74 68 65 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 e,.to.extend.the.patent.license.
2a340 74 6f 20 64 6f 77 6e 73 74 72 65 61 6d 0a 20 20 20 20 20 72 65 63 69 70 69 65 6e 74 73 2e 20 20 to.downstream......recipients...
2a360 e2 80 9c 4b 6e 6f 77 69 6e 67 6c 79 20 72 65 6c 79 69 6e 67 e2 80 9d 20 6d 65 61 6e 73 20 79 6f ...Knowingly.relying....means.yo
2a380 75 20 68 61 76 65 20 61 63 74 75 61 6c 20 6b 6e 6f 77 6c 65 64 67 65 0a 20 20 20 20 20 74 68 61 u.have.actual.knowledge......tha
2a3a0 74 2c 20 62 75 74 20 66 6f 72 20 74 68 65 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 2c 20 79 t,.but.for.the.patent.license,.y
2a3c0 6f 75 72 20 63 6f 6e 76 65 79 69 6e 67 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 0a 20 our.conveying.the.covered.work..
2a3e0 20 20 20 20 69 6e 20 61 20 63 6f 75 6e 74 72 79 2c 20 6f 72 20 79 6f 75 72 20 72 65 63 69 70 69 ....in.a.country,.or.your.recipi
2a400 65 6e 74 e2 80 99 73 20 75 73 65 20 6f 66 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 ent...s.use.of.the.covered.work.
2a420 69 6e 20 61 0a 20 20 20 20 20 63 6f 75 6e 74 72 79 2c 20 77 6f 75 6c 64 20 69 6e 66 72 69 6e 67 in.a......country,.would.infring
2a440 65 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 69 64 65 6e 74 69 66 69 61 62 6c 65 20 70 61 74 65 6e e.one.or.more.identifiable.paten
2a460 74 73 20 69 6e 20 74 68 61 74 0a 20 20 20 20 20 63 6f 75 6e 74 72 79 20 74 68 61 74 20 79 6f 75 ts.in.that......country.that.you
2a480 20 68 61 76 65 20 72 65 61 73 6f 6e 20 74 6f 20 62 65 6c 69 65 76 65 20 61 72 65 20 76 61 6c 69 .have.reason.to.believe.are.vali
2a4a0 64 2e 0a 0a 20 20 20 20 20 49 66 2c 20 70 75 72 73 75 61 6e 74 20 74 6f 20 6f 72 20 69 6e 20 63 d........If,.pursuant.to.or.in.c
2a4c0 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 74 72 61 6e 73 61 63 74 onnection.with.a.single.transact
2a4e0 69 6f 6e 20 6f 72 0a 20 20 20 20 20 61 72 72 61 6e 67 65 6d 65 6e 74 2c 20 79 6f 75 20 63 6f 6e ion.or......arrangement,.you.con
2a500 76 65 79 2c 20 6f 72 20 70 72 6f 70 61 67 61 74 65 20 62 79 20 70 72 6f 63 75 72 69 6e 67 20 63 vey,.or.propagate.by.procuring.c
2a520 6f 6e 76 65 79 61 6e 63 65 20 6f 66 2c 20 61 0a 20 20 20 20 20 63 6f 76 65 72 65 64 20 77 6f 72 onveyance.of,.a......covered.wor
2a540 6b 2c 20 61 6e 64 20 67 72 61 6e 74 20 61 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 74 6f k,.and.grant.a.patent.license.to
2a560 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 70 61 72 74 69 65 73 0a 20 20 20 20 20 72 65 63 65 69 76 .some.of.the.parties......receiv
2a580 69 6e 67 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 61 75 74 68 6f 72 69 7a 69 6e 67 ing.the.covered.work.authorizing
2a5a0 20 74 68 65 6d 20 74 6f 20 75 73 65 2c 20 70 72 6f 70 61 67 61 74 65 2c 0a 20 20 20 20 20 6d 6f .them.to.use,.propagate,......mo
2a5c0 64 69 66 79 20 6f 72 20 63 6f 6e 76 65 79 20 61 20 73 70 65 63 69 66 69 63 20 63 6f 70 79 20 6f dify.or.convey.a.specific.copy.o
2a5e0 66 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 2c 20 74 68 65 6e 20 74 68 65 0a 20 20 20 f.the.covered.work,.then.the....
2a600 20 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 79 6f 75 20 67 72 61 6e 74 20 69 73 20 61 75 ..patent.license.you.grant.is.au
2a620 74 6f 6d 61 74 69 63 61 6c 6c 79 20 65 78 74 65 6e 64 65 64 20 74 6f 20 61 6c 6c 0a 20 20 20 20 tomatically.extended.to.all.....
2a640 20 72 65 63 69 70 69 65 6e 74 73 20 6f 66 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 .recipients.of.the.covered.work.
2a660 61 6e 64 20 77 6f 72 6b 73 20 62 61 73 65 64 20 6f 6e 20 69 74 2e 0a 0a 20 20 20 20 20 41 20 70 and.works.based.on.it........A.p
2a680 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 69 73 20 e2 80 9c 64 69 73 63 72 69 6d 69 6e 61 74 6f atent.license.is....discriminato
2a6a0 72 79 e2 80 9d 20 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 77 69 74 ry....if.it.does.not.include.wit
2a6c0 68 69 6e 0a 20 20 20 20 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 69 74 73 20 63 6f 76 65 72 61 hin......the.scope.of.its.covera
2a6e0 67 65 2c 20 70 72 6f 68 69 62 69 74 73 20 74 68 65 20 65 78 65 72 63 69 73 65 20 6f 66 2c 20 6f ge,.prohibits.the.exercise.of,.o
2a700 72 20 69 73 0a 20 20 20 20 20 63 6f 6e 64 69 74 69 6f 6e 65 64 20 6f 6e 20 74 68 65 20 6e 6f 6e r.is......conditioned.on.the.non
2a720 2d 65 78 65 72 63 69 73 65 20 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 -exercise.of.one.or.more.of.the.
2a740 72 69 67 68 74 73 20 74 68 61 74 0a 20 20 20 20 20 61 72 65 20 73 70 65 63 69 66 69 63 61 6c 6c rights.that......are.specificall
2a760 79 20 67 72 61 6e 74 65 64 20 75 6e 64 65 72 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2e 20 20 59 y.granted.under.this.License...Y
2a780 6f 75 20 6d 61 79 20 6e 6f 74 20 63 6f 6e 76 65 79 20 61 0a 20 20 20 20 20 63 6f 76 65 72 65 64 ou.may.not.convey.a......covered
2a7a0 20 77 6f 72 6b 20 69 66 20 79 6f 75 20 61 72 65 20 61 20 70 61 72 74 79 20 74 6f 20 61 6e 20 61 .work.if.you.are.a.party.to.an.a
2a7c0 72 72 61 6e 67 65 6d 65 6e 74 20 77 69 74 68 20 61 20 74 68 69 72 64 0a 20 20 20 20 20 70 61 72 rrangement.with.a.third......par
2a7e0 74 79 20 74 68 61 74 20 69 73 20 69 6e 20 74 68 65 20 62 75 73 69 6e 65 73 73 20 6f 66 20 64 69 ty.that.is.in.the.business.of.di
2a800 73 74 72 69 62 75 74 69 6e 67 20 73 6f 66 74 77 61 72 65 2c 20 75 6e 64 65 72 20 77 68 69 63 68 stributing.software,.under.which
2a820 0a 20 20 20 20 20 79 6f 75 20 6d 61 6b 65 20 70 61 79 6d 65 6e 74 20 74 6f 20 74 68 65 20 74 68 ......you.make.payment.to.the.th
2a840 69 72 64 20 70 61 72 74 79 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 65 78 74 65 6e 74 20 6f 66 ird.party.based.on.the.extent.of
2a860 20 79 6f 75 72 0a 20 20 20 20 20 61 63 74 69 76 69 74 79 20 6f 66 20 63 6f 6e 76 65 79 69 6e 67 .your......activity.of.conveying
2a880 20 74 68 65 20 77 6f 72 6b 2c 20 61 6e 64 20 75 6e 64 65 72 20 77 68 69 63 68 20 74 68 65 20 74 .the.work,.and.under.which.the.t
2a8a0 68 69 72 64 20 70 61 72 74 79 0a 20 20 20 20 20 67 72 61 6e 74 73 2c 20 74 6f 20 61 6e 79 20 6f hird.party......grants,.to.any.o
2a8c0 66 20 74 68 65 20 70 61 72 74 69 65 73 20 77 68 6f 20 77 6f 75 6c 64 20 72 65 63 65 69 76 65 20 f.the.parties.who.would.receive.
2a8e0 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 0a 20 20 20 20 20 66 72 6f 6d 20 79 6f 75 2c 20 the.covered.work......from.you,.
2a900 61 20 64 69 73 63 72 69 6d 69 6e 61 74 6f 72 79 20 70 61 74 65 6e 74 20 6c 69 63 65 6e 73 65 20 a.discriminatory.patent.license.
2a920 28 61 29 20 69 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 0a 20 20 20 20 20 63 6f 70 69 (a).in.connection.with......copi
2a940 65 73 20 6f 66 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 63 6f 6e 76 65 79 65 64 20 es.of.the.covered.work.conveyed.
2a960 62 79 20 79 6f 75 20 28 6f 72 20 63 6f 70 69 65 73 20 6d 61 64 65 20 66 72 6f 6d 0a 20 20 20 20 by.you.(or.copies.made.from.....
2a980 20 74 68 6f 73 65 20 63 6f 70 69 65 73 29 2c 20 6f 72 20 28 62 29 20 70 72 69 6d 61 72 69 6c 79 .those.copies),.or.(b).primarily
2a9a0 20 66 6f 72 20 61 6e 64 20 69 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 20 73 70 65 63 .for.and.in.connection.with.spec
2a9c0 69 66 69 63 0a 20 20 20 20 20 70 72 6f 64 75 63 74 73 20 6f 72 20 63 6f 6d 70 69 6c 61 74 69 6f ific......products.or.compilatio
2a9e0 6e 73 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 63 6f 76 65 72 65 64 20 77 6f 72 6b ns.that.contain.the.covered.work
2aa00 2c 20 75 6e 6c 65 73 73 20 79 6f 75 0a 20 20 20 20 20 65 6e 74 65 72 65 64 20 69 6e 74 6f 20 74 ,.unless.you......entered.into.t
2aa20 68 61 74 20 61 72 72 61 6e 67 65 6d 65 6e 74 2c 20 6f 72 20 74 68 61 74 20 70 61 74 65 6e 74 20 hat.arrangement,.or.that.patent.
2aa40 6c 69 63 65 6e 73 65 20 77 61 73 20 67 72 61 6e 74 65 64 2c 0a 20 20 20 20 20 70 72 69 6f 72 20 license.was.granted,......prior.
2aa60 74 6f 20 32 38 20 4d 61 72 63 68 20 32 30 30 37 2e 0a 0a 20 20 20 20 20 4e 6f 74 68 69 6e 67 20 to.28.March.2007........Nothing.
2aa80 69 6e 20 74 68 69 73 20 4c 69 63 65 6e 73 65 20 73 68 61 6c 6c 20 62 65 20 63 6f 6e 73 74 72 75 in.this.License.shall.be.constru
2aaa0 65 64 20 61 73 20 65 78 63 6c 75 64 69 6e 67 20 6f 72 20 6c 69 6d 69 74 69 6e 67 0a 20 20 20 20 ed.as.excluding.or.limiting.....
2aac0 20 61 6e 79 20 69 6d 70 6c 69 65 64 20 6c 69 63 65 6e 73 65 20 6f 72 20 6f 74 68 65 72 20 64 65 .any.implied.license.or.other.de
2aae0 66 65 6e 73 65 73 20 74 6f 20 69 6e 66 72 69 6e 67 65 6d 65 6e 74 20 74 68 61 74 20 6d 61 79 0a fenses.to.infringement.that.may.
2ab00 20 20 20 20 20 6f 74 68 65 72 77 69 73 65 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 79 .....otherwise.be.available.to.y
2ab20 6f 75 20 75 6e 64 65 72 20 61 70 70 6c 69 63 61 62 6c 65 20 70 61 74 65 6e 74 20 6c 61 77 2e 0a ou.under.applicable.patent.law..
2ab40 0a 20 20 31 32 2e 20 4e 6f 20 53 75 72 72 65 6e 64 65 72 20 6f 66 20 4f 74 68 65 72 73 e2 80 99 ...12..No.Surrender.of.Others...
2ab60 20 46 72 65 65 64 6f 6d 2e 0a 0a 20 20 20 20 20 49 66 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 72 .Freedom........If.conditions.ar
2ab80 65 20 69 6d 70 6f 73 65 64 20 6f 6e 20 79 6f 75 20 28 77 68 65 74 68 65 72 20 62 79 20 63 6f 75 e.imposed.on.you.(whether.by.cou
2aba0 72 74 20 6f 72 64 65 72 2c 20 61 67 72 65 65 6d 65 6e 74 0a 20 20 20 20 20 6f 72 20 6f 74 68 65 rt.order,.agreement......or.othe
2abc0 72 77 69 73 65 29 20 74 68 61 74 20 63 6f 6e 74 72 61 64 69 63 74 20 74 68 65 20 63 6f 6e 64 69 rwise).that.contradict.the.condi
2abe0 74 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 74 68 65 79 0a 20 20 20 20 tions.of.this.License,.they.....
2ac00 20 64 6f 20 6e 6f 74 20 65 78 63 75 73 65 20 79 6f 75 20 66 72 6f 6d 20 74 68 65 20 63 6f 6e 64 .do.not.excuse.you.from.the.cond
2ac20 69 74 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2e 20 20 49 66 20 79 6f 75 0a itions.of.this.License...If.you.
2ac40 20 20 20 20 20 63 61 6e 6e 6f 74 20 63 6f 6e 76 65 79 20 61 20 63 6f 76 65 72 65 64 20 77 6f 72 .....cannot.convey.a.covered.wor
2ac60 6b 20 73 6f 20 61 73 20 74 6f 20 73 61 74 69 73 66 79 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c k.so.as.to.satisfy.simultaneousl
2ac80 79 20 79 6f 75 72 0a 20 20 20 20 20 6f 62 6c 69 67 61 74 69 6f 6e 73 20 75 6e 64 65 72 20 74 68 y.your......obligations.under.th
2aca0 69 73 20 4c 69 63 65 6e 73 65 20 61 6e 64 20 61 6e 79 20 6f 74 68 65 72 20 70 65 72 74 69 6e 65 is.License.and.any.other.pertine
2acc0 6e 74 20 6f 62 6c 69 67 61 74 69 6f 6e 73 2c 0a 20 20 20 20 20 74 68 65 6e 20 61 73 20 61 20 63 nt.obligations,......then.as.a.c
2ace0 6f 6e 73 65 71 75 65 6e 63 65 20 79 6f 75 20 6d 61 79 20 6e 6f 74 20 63 6f 6e 76 65 79 20 69 74 onsequence.you.may.not.convey.it
2ad00 20 61 74 20 61 6c 6c 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 20 20 20 20 20 69 66 20 79 .at.all...For.example,......if.y
2ad20 6f 75 20 61 67 72 65 65 20 74 6f 20 74 65 72 6d 73 20 74 68 61 74 20 6f 62 6c 69 67 61 74 65 20 ou.agree.to.terms.that.obligate.
2ad40 79 6f 75 20 74 6f 20 63 6f 6c 6c 65 63 74 20 61 20 72 6f 79 61 6c 74 79 20 66 6f 72 0a 20 20 20 you.to.collect.a.royalty.for....
2ad60 20 20 66 75 72 74 68 65 72 20 63 6f 6e 76 65 79 69 6e 67 20 66 72 6f 6d 20 74 68 6f 73 65 20 74 ..further.conveying.from.those.t
2ad80 6f 20 77 68 6f 6d 20 79 6f 75 20 63 6f 6e 76 65 79 20 74 68 65 20 50 72 6f 67 72 61 6d 2c 20 74 o.whom.you.convey.the.Program,.t
2ada0 68 65 0a 20 20 20 20 20 6f 6e 6c 79 20 77 61 79 20 79 6f 75 20 63 6f 75 6c 64 20 73 61 74 69 73 he......only.way.you.could.satis
2adc0 66 79 20 62 6f 74 68 20 74 68 6f 73 65 20 74 65 72 6d 73 20 61 6e 64 20 74 68 69 73 20 4c 69 63 fy.both.those.terms.and.this.Lic
2ade0 65 6e 73 65 20 77 6f 75 6c 64 0a 20 20 20 20 20 62 65 20 74 6f 20 72 65 66 72 61 69 6e 20 65 6e ense.would......be.to.refrain.en
2ae00 74 69 72 65 6c 79 20 66 72 6f 6d 20 63 6f 6e 76 65 79 69 6e 67 20 74 68 65 20 50 72 6f 67 72 61 tirely.from.conveying.the.Progra
2ae20 6d 2e 0a 0a 20 20 31 33 2e 20 55 73 65 20 77 69 74 68 20 74 68 65 20 47 4e 55 20 41 66 66 65 72 m.....13..Use.with.the.GNU.Affer
2ae40 6f 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 2e 0a 0a 20 20 20 20 20 o.General.Public.License........
2ae60 4e 6f 74 77 69 74 68 73 74 61 6e 64 69 6e 67 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 76 69 73 Notwithstanding.any.other.provis
2ae80 69 6f 6e 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2c 20 79 6f 75 20 68 61 76 65 0a 20 20 ion.of.this.License,.you.have...
2aea0 20 20 20 70 65 72 6d 69 73 73 69 6f 6e 20 74 6f 20 6c 69 6e 6b 20 6f 72 20 63 6f 6d 62 69 6e 65 ...permission.to.link.or.combine
2aec0 20 61 6e 79 20 63 6f 76 65 72 65 64 20 77 6f 72 6b 20 77 69 74 68 20 61 20 77 6f 72 6b 20 6c 69 .any.covered.work.with.a.work.li
2aee0 63 65 6e 73 65 64 0a 20 20 20 20 20 75 6e 64 65 72 20 76 65 72 73 69 6f 6e 20 33 20 6f 66 20 74 censed......under.version.3.of.t
2af00 68 65 20 47 4e 55 20 41 66 66 65 72 6f 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 he.GNU.Affero.General.Public.Lic
2af20 65 6e 73 65 20 69 6e 74 6f 20 61 0a 20 20 20 20 20 73 69 6e 67 6c 65 20 63 6f 6d 62 69 6e 65 64 ense.into.a......single.combined
2af40 20 77 6f 72 6b 2c 20 61 6e 64 20 74 6f 20 63 6f 6e 76 65 79 20 74 68 65 20 72 65 73 75 6c 74 69 .work,.and.to.convey.the.resulti
2af60 6e 67 20 77 6f 72 6b 2e 20 20 54 68 65 20 74 65 72 6d 73 0a 20 20 20 20 20 6f 66 20 74 68 69 73 ng.work...The.terms......of.this
2af80 20 4c 69 63 65 6e 73 65 20 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 61 70 70 6c 79 20 .License.will.continue.to.apply.
2afa0 74 6f 20 74 68 65 20 70 61 72 74 20 77 68 69 63 68 20 69 73 20 74 68 65 0a 20 20 20 20 20 63 6f to.the.part.which.is.the......co
2afc0 76 65 72 65 64 20 77 6f 72 6b 2c 20 62 75 74 20 74 68 65 20 73 70 65 63 69 61 6c 20 72 65 71 75 vered.work,.but.the.special.requ
2afe0 69 72 65 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 47 4e 55 20 41 66 66 65 72 6f 0a 20 20 20 20 20 irements.of.the.GNU.Affero......
2b000 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 2c 20 73 65 63 74 69 6f 6e 20 General.Public.License,.section.
2b020 31 33 2c 20 63 6f 6e 63 65 72 6e 69 6e 67 20 69 6e 74 65 72 61 63 74 69 6f 6e 20 74 68 72 6f 75 13,.concerning.interaction.throu
2b040 67 68 0a 20 20 20 20 20 61 20 6e 65 74 77 6f 72 6b 20 77 69 6c 6c 20 61 70 70 6c 79 20 74 6f 20 gh......a.network.will.apply.to.
2b060 74 68 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 61 73 20 73 75 63 68 2e 0a 0a 20 20 31 34 2e 20 the.combination.as.such.....14..
2b080 52 65 76 69 73 65 64 20 56 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 Revised.Versions.of.this.License
2b0a0 2e 0a 0a 20 20 20 20 20 54 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 ........The.Free.Software.Founda
2b0c0 74 69 6f 6e 20 6d 61 79 20 70 75 62 6c 69 73 68 20 72 65 76 69 73 65 64 20 61 6e 64 2f 6f 72 20 tion.may.publish.revised.and/or.
2b0e0 6e 65 77 0a 20 20 20 20 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e new......versions.of.the.GNU.Gen
2b100 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 72 6f 6d 20 74 69 6d 65 20 74 6f eral.Public.License.from.time.to
2b120 20 74 69 6d 65 2e 20 20 53 75 63 68 0a 20 20 20 20 20 6e 65 77 20 76 65 72 73 69 6f 6e 73 20 77 .time...Such......new.versions.w
2b140 69 6c 6c 20 62 65 20 73 69 6d 69 6c 61 72 20 69 6e 20 73 70 69 72 69 74 20 74 6f 20 74 68 65 20 ill.be.similar.in.spirit.to.the.
2b160 70 72 65 73 65 6e 74 20 76 65 72 73 69 6f 6e 2c 20 62 75 74 0a 20 20 20 20 20 6d 61 79 20 64 69 present.version,.but......may.di
2b180 66 66 65 72 20 69 6e 20 64 65 74 61 69 6c 20 74 6f 20 61 64 64 72 65 73 73 20 6e 65 77 20 70 72 ffer.in.detail.to.address.new.pr
2b1a0 6f 62 6c 65 6d 73 20 6f 72 20 63 6f 6e 63 65 72 6e 73 2e 0a 0a 20 20 20 20 20 45 61 63 68 20 76 oblems.or.concerns........Each.v
2b1c0 65 72 73 69 6f 6e 20 69 73 20 67 69 76 65 6e 20 61 20 64 69 73 74 69 6e 67 75 69 73 68 69 6e 67 ersion.is.given.a.distinguishing
2b1e0 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 2e 20 20 49 66 20 74 68 65 0a 20 20 20 20 20 50 72 .version.number...If.the......Pr
2b200 6f 67 72 61 6d 20 73 70 65 63 69 66 69 65 73 20 74 68 61 74 20 61 20 63 65 72 74 61 69 6e 20 6e ogram.specifies.that.a.certain.n
2b220 75 6d 62 65 72 65 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 47 4e 55 0a 20 20 20 20 20 umbered.version.of.the.GNU......
2b240 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 e2 80 9c 6f 72 20 61 6e 79 General.Public.License....or.any
2b260 20 6c 61 74 65 72 20 76 65 72 73 69 6f 6e e2 80 9d 20 61 70 70 6c 69 65 73 20 74 6f 20 69 74 2c .later.version....applies.to.it,
2b280 20 79 6f 75 0a 20 20 20 20 20 68 61 76 65 20 74 68 65 20 6f 70 74 69 6f 6e 20 6f 66 20 66 6f 6c .you......have.the.option.of.fol
2b2a0 6c 6f 77 69 6e 67 20 74 68 65 20 74 65 72 6d 73 20 61 6e 64 20 63 6f 6e 64 69 74 69 6f 6e 73 20 lowing.the.terms.and.conditions.
2b2c0 65 69 74 68 65 72 20 6f 66 0a 20 20 20 20 20 74 68 61 74 20 6e 75 6d 62 65 72 65 64 20 76 65 72 either.of......that.numbered.ver
2b2e0 73 69 6f 6e 20 6f 72 20 6f 66 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72 73 69 6f 6e 20 70 75 62 sion.or.of.any.later.version.pub
2b300 6c 69 73 68 65 64 20 62 79 20 74 68 65 20 46 72 65 65 0a 20 20 20 20 20 53 6f 66 74 77 61 72 65 lished.by.the.Free......Software
2b320 20 46 6f 75 6e 64 61 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 50 72 6f 67 72 61 6d 20 64 6f 65 .Foundation...If.the.Program.doe
2b340 73 20 6e 6f 74 20 73 70 65 63 69 66 79 20 61 20 76 65 72 73 69 6f 6e 0a 20 20 20 20 20 6e 75 6d s.not.specify.a.version......num
2b360 62 65 72 20 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 ber.of.the.GNU.General.Public.Li
2b380 63 65 6e 73 65 2c 20 79 6f 75 20 6d 61 79 20 63 68 6f 6f 73 65 20 61 6e 79 0a 20 20 20 20 20 76 cense,.you.may.choose.any......v
2b3a0 65 72 73 69 6f 6e 20 65 76 65 72 20 70 75 62 6c 69 73 68 65 64 20 62 79 20 74 68 65 20 46 72 65 ersion.ever.published.by.the.Fre
2b3c0 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 49 66 20 e.Software.Foundation........If.
2b3e0 74 68 65 20 50 72 6f 67 72 61 6d 20 73 70 65 63 69 66 69 65 73 20 74 68 61 74 20 61 20 70 72 6f the.Program.specifies.that.a.pro
2b400 78 79 20 63 61 6e 20 64 65 63 69 64 65 20 77 68 69 63 68 20 66 75 74 75 72 65 0a 20 20 20 20 20 xy.can.decide.which.future......
2b420 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c versions.of.the.GNU.General.Publ
2b440 69 63 20 4c 69 63 65 6e 73 65 20 63 61 6e 20 62 65 20 75 73 65 64 2c 20 74 68 61 74 0a 20 20 20 ic.License.can.be.used,.that....
2b460 20 20 70 72 6f 78 79 e2 80 99 73 20 70 75 62 6c 69 63 20 73 74 61 74 65 6d 65 6e 74 20 6f 66 20 ..proxy...s.public.statement.of.
2b480 61 63 63 65 70 74 61 6e 63 65 20 6f 66 20 61 20 76 65 72 73 69 6f 6e 20 70 65 72 6d 61 6e 65 6e acceptance.of.a.version.permanen
2b4a0 74 6c 79 0a 20 20 20 20 20 61 75 74 68 6f 72 69 7a 65 73 20 79 6f 75 20 74 6f 20 63 68 6f 6f 73 tly......authorizes.you.to.choos
2b4c0 65 20 74 68 61 74 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 74 68 65 20 50 72 6f 67 72 61 6d 2e 0a e.that.version.for.the.Program..
2b4e0 0a 20 20 20 20 20 4c 61 74 65 72 20 6c 69 63 65 6e 73 65 20 76 65 72 73 69 6f 6e 73 20 6d 61 79 ......Later.license.versions.may
2b500 20 67 69 76 65 20 79 6f 75 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f 72 20 64 69 66 66 65 72 65 6e .give.you.additional.or.differen
2b520 74 0a 20 20 20 20 20 70 65 72 6d 69 73 73 69 6f 6e 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 6e 6f t......permissions...However,.no
2b540 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f 62 6c 69 67 61 74 69 6f 6e 73 20 61 72 65 20 69 6d 70 6f .additional.obligations.are.impo
2b560 73 65 64 20 6f 6e 20 61 6e 79 0a 20 20 20 20 20 61 75 74 68 6f 72 20 6f 72 20 63 6f 70 79 72 69 sed.on.any......author.or.copyri
2b580 67 68 74 20 68 6f 6c 64 65 72 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20 79 6f 75 72 20 63 ght.holder.as.a.result.of.your.c
2b5a0 68 6f 6f 73 69 6e 67 20 74 6f 20 66 6f 6c 6c 6f 77 20 61 0a 20 20 20 20 20 6c 61 74 65 72 20 76 hoosing.to.follow.a......later.v
2b5c0 65 72 73 69 6f 6e 2e 0a 0a 20 20 31 35 2e 20 44 69 73 63 6c 61 69 6d 65 72 20 6f 66 20 57 61 72 ersion.....15..Disclaimer.of.War
2b5e0 72 61 6e 74 79 2e 0a 0a 20 20 20 20 20 54 48 45 52 45 20 49 53 20 4e 4f 20 57 41 52 52 41 4e 54 ranty........THERE.IS.NO.WARRANT
2b600 59 20 46 4f 52 20 54 48 45 20 50 52 4f 47 52 41 4d 2c 20 54 4f 20 54 48 45 20 45 58 54 45 4e 54 Y.FOR.THE.PROGRAM,.TO.THE.EXTENT
2b620 20 50 45 52 4d 49 54 54 45 44 20 42 59 0a 20 20 20 20 20 41 50 50 4c 49 43 41 42 4c 45 20 4c 41 .PERMITTED.BY......APPLICABLE.LA
2b640 57 2e 20 20 45 58 43 45 50 54 20 57 48 45 4e 20 4f 54 48 45 52 57 49 53 45 20 53 54 41 54 45 44 W...EXCEPT.WHEN.OTHERWISE.STATED
2b660 20 49 4e 20 57 52 49 54 49 4e 47 20 54 48 45 0a 20 20 20 20 20 43 4f 50 59 52 49 47 48 54 20 48 .IN.WRITING.THE......COPYRIGHT.H
2b680 4f 4c 44 45 52 53 20 41 4e 44 2f 4f 52 20 4f 54 48 45 52 20 50 41 52 54 49 45 53 20 50 52 4f 56 OLDERS.AND/OR.OTHER.PARTIES.PROV
2b6a0 49 44 45 20 54 48 45 20 50 52 4f 47 52 41 4d 20 e2 80 9c 41 53 20 49 53 e2 80 9d 0a 20 20 20 20 IDE.THE.PROGRAM....AS.IS........
2b6c0 20 57 49 54 48 4f 55 54 20 57 41 52 52 41 4e 54 59 20 4f 46 20 41 4e 59 20 4b 49 4e 44 2c 20 45 .WITHOUT.WARRANTY.OF.ANY.KIND,.E
2b6e0 49 54 48 45 52 20 45 58 50 52 45 53 53 45 44 20 4f 52 20 49 4d 50 4c 49 45 44 2c 0a 20 20 20 20 ITHER.EXPRESSED.OR.IMPLIED,.....
2b700 20 49 4e 43 4c 55 44 49 4e 47 2c 20 42 55 54 20 4e 4f 54 20 4c 49 4d 49 54 45 44 20 54 4f 2c 20 .INCLUDING,.BUT.NOT.LIMITED.TO,.
2b720 54 48 45 20 49 4d 50 4c 49 45 44 20 57 41 52 52 41 4e 54 49 45 53 20 4f 46 0a 20 20 20 20 20 4d THE.IMPLIED.WARRANTIES.OF......M
2b740 45 52 43 48 41 4e 54 41 42 49 4c 49 54 59 20 41 4e 44 20 46 49 54 4e 45 53 53 20 46 4f 52 20 41 ERCHANTABILITY.AND.FITNESS.FOR.A
2b760 20 50 41 52 54 49 43 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 54 48 45 20 45 4e 54 49 52 45 .PARTICULAR.PURPOSE...THE.ENTIRE
2b780 0a 20 20 20 20 20 52 49 53 4b 20 41 53 20 54 4f 20 54 48 45 20 51 55 41 4c 49 54 59 20 41 4e 44 ......RISK.AS.TO.THE.QUALITY.AND
2b7a0 20 50 45 52 46 4f 52 4d 41 4e 43 45 20 4f 46 20 54 48 45 20 50 52 4f 47 52 41 4d 20 49 53 20 57 .PERFORMANCE.OF.THE.PROGRAM.IS.W
2b7c0 49 54 48 20 59 4f 55 2e 0a 20 20 20 20 20 53 48 4f 55 4c 44 20 54 48 45 20 50 52 4f 47 52 41 4d ITH.YOU.......SHOULD.THE.PROGRAM
2b7e0 20 50 52 4f 56 45 20 44 45 46 45 43 54 49 56 45 2c 20 59 4f 55 20 41 53 53 55 4d 45 20 54 48 45 .PROVE.DEFECTIVE,.YOU.ASSUME.THE
2b800 20 43 4f 53 54 20 4f 46 20 41 4c 4c 0a 20 20 20 20 20 4e 45 43 45 53 53 41 52 59 20 53 45 52 56 .COST.OF.ALL......NECESSARY.SERV
2b820 49 43 49 4e 47 2c 20 52 45 50 41 49 52 20 4f 52 20 43 4f 52 52 45 43 54 49 4f 4e 2e 0a 0a 20 20 ICING,.REPAIR.OR.CORRECTION.....
2b840 31 36 2e 20 4c 69 6d 69 74 61 74 69 6f 6e 20 6f 66 20 4c 69 61 62 69 6c 69 74 79 2e 0a 0a 20 20 16..Limitation.of.Liability.....
2b860 20 20 20 49 4e 20 4e 4f 20 45 56 45 4e 54 20 55 4e 4c 45 53 53 20 52 45 51 55 49 52 45 44 20 42 ...IN.NO.EVENT.UNLESS.REQUIRED.B
2b880 59 20 41 50 50 4c 49 43 41 42 4c 45 20 4c 41 57 20 4f 52 20 41 47 52 45 45 44 20 54 4f 20 49 4e Y.APPLICABLE.LAW.OR.AGREED.TO.IN
2b8a0 0a 20 20 20 20 20 57 52 49 54 49 4e 47 20 57 49 4c 4c 20 41 4e 59 20 43 4f 50 59 52 49 47 48 54 ......WRITING.WILL.ANY.COPYRIGHT
2b8c0 20 48 4f 4c 44 45 52 2c 20 4f 52 20 41 4e 59 20 4f 54 48 45 52 20 50 41 52 54 59 20 57 48 4f 20 .HOLDER,.OR.ANY.OTHER.PARTY.WHO.
2b8e0 4d 4f 44 49 46 49 45 53 0a 20 20 20 20 20 41 4e 44 2f 4f 52 20 43 4f 4e 56 45 59 53 20 54 48 45 MODIFIES......AND/OR.CONVEYS.THE
2b900 20 50 52 4f 47 52 41 4d 20 41 53 20 50 45 52 4d 49 54 54 45 44 20 41 42 4f 56 45 2c 20 42 45 20 .PROGRAM.AS.PERMITTED.ABOVE,.BE.
2b920 4c 49 41 42 4c 45 20 54 4f 20 59 4f 55 20 46 4f 52 0a 20 20 20 20 20 44 41 4d 41 47 45 53 2c 20 LIABLE.TO.YOU.FOR......DAMAGES,.
2b940 49 4e 43 4c 55 44 49 4e 47 20 41 4e 59 20 47 45 4e 45 52 41 4c 2c 20 53 50 45 43 49 41 4c 2c 20 INCLUDING.ANY.GENERAL,.SPECIAL,.
2b960 49 4e 43 49 44 45 4e 54 41 4c 20 4f 52 0a 20 20 20 20 20 43 4f 4e 53 45 51 55 45 4e 54 49 41 4c INCIDENTAL.OR......CONSEQUENTIAL
2b980 20 44 41 4d 41 47 45 53 20 41 52 49 53 49 4e 47 20 4f 55 54 20 4f 46 20 54 48 45 20 55 53 45 20 .DAMAGES.ARISING.OUT.OF.THE.USE.
2b9a0 4f 52 20 49 4e 41 42 49 4c 49 54 59 20 54 4f 20 55 53 45 0a 20 20 20 20 20 54 48 45 20 50 52 4f OR.INABILITY.TO.USE......THE.PRO
2b9c0 47 52 41 4d 20 28 49 4e 43 4c 55 44 49 4e 47 20 42 55 54 20 4e 4f 54 20 4c 49 4d 49 54 45 44 20 GRAM.(INCLUDING.BUT.NOT.LIMITED.
2b9e0 54 4f 20 4c 4f 53 53 20 4f 46 20 44 41 54 41 20 4f 52 20 44 41 54 41 0a 20 20 20 20 20 42 45 49 TO.LOSS.OF.DATA.OR.DATA......BEI
2ba00 4e 47 20 52 45 4e 44 45 52 45 44 20 49 4e 41 43 43 55 52 41 54 45 20 4f 52 20 4c 4f 53 53 45 53 NG.RENDERED.INACCURATE.OR.LOSSES
2ba20 20 53 55 53 54 41 49 4e 45 44 20 42 59 20 59 4f 55 20 4f 52 20 54 48 49 52 44 0a 20 20 20 20 20 .SUSTAINED.BY.YOU.OR.THIRD......
2ba40 50 41 52 54 49 45 53 20 4f 52 20 41 20 46 41 49 4c 55 52 45 20 4f 46 20 54 48 45 20 50 52 4f 47 PARTIES.OR.A.FAILURE.OF.THE.PROG
2ba60 52 41 4d 20 54 4f 20 4f 50 45 52 41 54 45 20 57 49 54 48 20 41 4e 59 20 4f 54 48 45 52 0a 20 20 RAM.TO.OPERATE.WITH.ANY.OTHER...
2ba80 20 20 20 50 52 4f 47 52 41 4d 53 29 2c 20 45 56 45 4e 20 49 46 20 53 55 43 48 20 48 4f 4c 44 45 ...PROGRAMS),.EVEN.IF.SUCH.HOLDE
2baa0 52 20 4f 52 20 4f 54 48 45 52 20 50 41 52 54 59 20 48 41 53 20 42 45 45 4e 20 41 44 56 49 53 45 R.OR.OTHER.PARTY.HAS.BEEN.ADVISE
2bac0 44 20 4f 46 0a 20 20 20 20 20 54 48 45 20 50 4f 53 53 49 42 49 4c 49 54 59 20 4f 46 20 53 55 43 D.OF......THE.POSSIBILITY.OF.SUC
2bae0 48 20 44 41 4d 41 47 45 53 2e 0a 0a 20 20 31 37 2e 20 49 6e 74 65 72 70 72 65 74 61 74 69 6f 6e H.DAMAGES.....17..Interpretation
2bb00 20 6f 66 20 53 65 63 74 69 6f 6e 73 20 31 35 20 61 6e 64 20 31 36 2e 0a 0a 20 20 20 20 20 49 66 .of.Sections.15.and.16........If
2bb20 20 74 68 65 20 64 69 73 63 6c 61 69 6d 65 72 20 6f 66 20 77 61 72 72 61 6e 74 79 20 61 6e 64 20 .the.disclaimer.of.warranty.and.
2bb40 6c 69 6d 69 74 61 74 69 6f 6e 20 6f 66 20 6c 69 61 62 69 6c 69 74 79 20 70 72 6f 76 69 64 65 64 limitation.of.liability.provided
2bb60 0a 20 20 20 20 20 61 62 6f 76 65 20 63 61 6e 6e 6f 74 20 62 65 20 67 69 76 65 6e 20 6c 6f 63 61 ......above.cannot.be.given.loca
2bb80 6c 20 6c 65 67 61 6c 20 65 66 66 65 63 74 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 69 l.legal.effect.according.to.thei
2bba0 72 20 74 65 72 6d 73 2c 0a 20 20 20 20 20 72 65 76 69 65 77 69 6e 67 20 63 6f 75 72 74 73 20 73 r.terms,......reviewing.courts.s
2bbc0 68 61 6c 6c 20 61 70 70 6c 79 20 6c 6f 63 61 6c 20 6c 61 77 20 74 68 61 74 20 6d 6f 73 74 20 63 hall.apply.local.law.that.most.c
2bbe0 6c 6f 73 65 6c 79 0a 20 20 20 20 20 61 70 70 72 6f 78 69 6d 61 74 65 73 20 61 6e 20 61 62 73 6f losely......approximates.an.abso
2bc00 6c 75 74 65 20 77 61 69 76 65 72 20 6f 66 20 61 6c 6c 20 63 69 76 69 6c 20 6c 69 61 62 69 6c 69 lute.waiver.of.all.civil.liabili
2bc20 74 79 20 69 6e 0a 20 20 20 20 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 50 ty.in......connection.with.the.P
2bc40 72 6f 67 72 61 6d 2c 20 75 6e 6c 65 73 73 20 61 20 77 61 72 72 61 6e 74 79 20 6f 72 20 61 73 73 rogram,.unless.a.warranty.or.ass
2bc60 75 6d 70 74 69 6f 6e 20 6f 66 0a 20 20 20 20 20 6c 69 61 62 69 6c 69 74 79 20 61 63 63 6f 6d 70 umption.of......liability.accomp
2bc80 61 6e 69 65 73 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 50 72 6f 67 72 61 6d 20 69 6e 20 72 anies.a.copy.of.the.Program.in.r
2bca0 65 74 75 72 6e 20 66 6f 72 20 61 20 66 65 65 2e 0a 0a 45 4e 44 20 4f 46 20 54 45 52 4d 53 20 41 eturn.for.a.fee...END.OF.TERMS.A
2bcc0 4e 44 20 43 4f 4e 44 49 54 49 4f 4e 53 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ND.CONDITIONS.==================
2bce0 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 48 6f 77 20 74 6f 20 41 70 70 6c 79 20 54 68 65 73 65 20 54 65 =========..How.to.Apply.These.Te
2bd00 72 6d 73 20 74 6f 20 59 6f 75 72 20 4e 65 77 20 50 72 6f 67 72 61 6d 73 0a 3d 3d 3d 3d 3d 3d 3d rms.to.Your.New.Programs.=======
2bd20 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
2bd40 3d 3d 3d 3d 3d 3d 0a 0a 49 66 20 79 6f 75 20 64 65 76 65 6c 6f 70 20 61 20 6e 65 77 20 70 72 6f ======..If.you.develop.a.new.pro
2bd60 67 72 61 6d 2c 20 61 6e 64 20 79 6f 75 20 77 61 6e 74 20 69 74 20 74 6f 20 62 65 20 6f 66 20 74 gram,.and.you.want.it.to.be.of.t
2bd80 68 65 20 67 72 65 61 74 65 73 74 0a 70 6f 73 73 69 62 6c 65 20 75 73 65 20 74 6f 20 74 68 65 20 he.greatest.possible.use.to.the.
2bda0 70 75 62 6c 69 63 2c 20 74 68 65 20 62 65 73 74 20 77 61 79 20 74 6f 20 61 63 68 69 65 76 65 20 public,.the.best.way.to.achieve.
2bdc0 74 68 69 73 20 69 73 20 74 6f 20 6d 61 6b 65 20 69 74 0a 66 72 65 65 20 73 6f 66 74 77 61 72 65 this.is.to.make.it.free.software
2bde0 20 77 68 69 63 68 20 65 76 65 72 79 6f 6e 65 20 63 61 6e 20 72 65 64 69 73 74 72 69 62 75 74 65 .which.everyone.can.redistribute
2be00 20 61 6e 64 20 63 68 61 6e 67 65 20 75 6e 64 65 72 20 74 68 65 73 65 0a 74 65 72 6d 73 2e 0a 0a .and.change.under.these.terms...
2be20 20 20 20 54 6f 20 64 6f 20 73 6f 2c 20 61 74 74 61 63 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e ...To.do.so,.attach.the.followin
2be40 67 20 6e 6f 74 69 63 65 73 20 74 6f 20 74 68 65 20 70 72 6f 67 72 61 6d 2e 20 20 49 74 20 69 73 g.notices.to.the.program...It.is
2be60 20 73 61 66 65 73 74 0a 74 6f 20 61 74 74 61 63 68 20 74 68 65 6d 20 74 6f 20 74 68 65 20 73 74 .safest.to.attach.them.to.the.st
2be80 61 72 74 20 6f 66 20 65 61 63 68 20 73 6f 75 72 63 65 20 66 69 6c 65 20 74 6f 20 6d 6f 73 74 20 art.of.each.source.file.to.most.
2bea0 65 66 66 65 63 74 69 76 65 6c 79 0a 73 74 61 74 65 20 74 68 65 20 65 78 63 6c 75 73 69 6f 6e 20 effectively.state.the.exclusion.
2bec0 6f 66 20 77 61 72 72 61 6e 74 79 3b 20 61 6e 64 20 65 61 63 68 20 66 69 6c 65 20 73 68 6f 75 6c of.warranty;.and.each.file.shoul
2bee0 64 20 68 61 76 65 20 61 74 20 6c 65 61 73 74 20 74 68 65 0a e2 80 9c 63 6f 70 79 72 69 67 68 74 d.have.at.least.the....copyright
2bf00 e2 80 9d 20 6c 69 6e 65 20 61 6e 64 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 77 68 65 72 65 20 ....line.and.a.pointer.to.where.
2bf20 74 68 65 20 66 75 6c 6c 20 6e 6f 74 69 63 65 20 69 73 20 66 6f 75 6e 64 2e 0a 0a 20 20 20 20 20 the.full.notice.is.found........
2bf40 4f 4e 45 20 4c 49 4e 45 20 54 4f 20 47 49 56 45 20 54 48 45 20 50 52 4f 47 52 41 4d 27 53 20 4e ONE.LINE.TO.GIVE.THE.PROGRAM'S.N
2bf60 41 4d 45 20 41 4e 44 20 41 20 42 52 49 45 46 20 49 44 45 41 20 4f 46 20 57 48 41 54 20 49 54 20 AME.AND.A.BRIEF.IDEA.OF.WHAT.IT.
2bf80 44 4f 45 53 2e 0a 20 20 20 20 20 43 6f 70 79 72 69 67 68 74 20 28 43 29 20 59 45 41 52 20 4e 41 DOES.......Copyright.(C).YEAR.NA
2bfa0 4d 45 20 4f 46 20 41 55 54 48 4f 52 0a 0a 20 20 20 20 20 54 68 69 73 20 70 72 6f 67 72 61 6d 20 ME.OF.AUTHOR.......This.program.
2bfc0 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 72 65 3a 20 79 6f 75 20 63 61 6e 20 72 65 64 69 73 74 is.free.software:.you.can.redist
2bfe0 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f 6f 72 20 6d 6f 64 69 66 79 0a 20 20 20 20 20 69 74 20 ribute.it.and/or.modify......it.
2c000 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 47 65 6e 65 72 under.the.terms.of.the.GNU.Gener
2c020 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 68 65 64 20 62 al.Public.License.as.published.b
2c040 79 0a 20 20 20 20 20 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 y......the.Free.Software.Foundat
2c060 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 4c 69 63 ion,.either.version.3.of.the.Lic
2c080 65 6e 73 65 2c 20 6f 72 20 28 61 74 0a 20 20 20 20 20 79 6f 75 72 20 6f 70 74 69 6f 6e 29 20 61 ense,.or.(at......your.option).a
2c0a0 6e 79 20 6c 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 70 72 6f ny.later.version........This.pro
2c0c0 67 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 gram.is.distributed.in.the.hope.
2c0e0 74 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2c 20 62 75 74 0a 20 20 20 20 that.it.will.be.useful,.but.....
2c100 20 57 49 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 .WITHOUT.ANY.WARRANTY;.without.e
2c120 76 65 6e 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 20 20 20 20 ven.the.implied.warranty.of.....
2c140 20 4d 45 52 43 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 .MERCHANTABILITY.or.FITNESS.FOR.
2c160 41 20 50 41 52 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 20 47 A.PARTICULAR.PURPOSE...See.the.G
2c180 4e 55 0a 20 20 20 20 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 NU......General.Public.License.f
2c1a0 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a 0a 20 20 20 20 20 59 6f 75 20 73 68 6f 75 6c or.more.details........You.shoul
2c1c0 64 20 68 61 76 65 20 72 65 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 47 4e d.have.received.a.copy.of.the.GN
2c1e0 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 0a 20 20 20 20 20 61 6c U.General.Public.License......al
2c200 6f 6e 67 20 77 69 74 68 20 74 68 69 73 20 70 72 6f 67 72 61 6d 2e 20 20 49 66 20 6e 6f 74 2c 20 ong.with.this.program...If.not,.
2c220 73 65 65 20 3c 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 63 65 6e 73 65 see.<https://www.gnu.org/license
2c240 73 2f 3e 2e 0a 0a 20 20 20 41 6c 73 6f 20 61 64 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e s/>......Also.add.information.on
2c260 20 68 6f 77 20 74 6f 20 63 6f 6e 74 61 63 74 20 79 6f 75 20 62 79 20 65 6c 65 63 74 72 6f 6e 69 .how.to.contact.you.by.electroni
2c280 63 20 61 6e 64 20 70 61 70 65 72 0a 6d 61 69 6c 2e 0a 0a 20 20 20 49 66 20 74 68 65 20 70 72 6f c.and.paper.mail......If.the.pro
2c2a0 67 72 61 6d 20 64 6f 65 73 20 74 65 72 6d 69 6e 61 6c 20 69 6e 74 65 72 61 63 74 69 6f 6e 2c 20 gram.does.terminal.interaction,.
2c2c0 6d 61 6b 65 20 69 74 20 6f 75 74 70 75 74 20 61 20 73 68 6f 72 74 0a 6e 6f 74 69 63 65 20 6c 69 make.it.output.a.short.notice.li
2c2e0 6b 65 20 74 68 69 73 20 77 68 65 6e 20 69 74 20 73 74 61 72 74 73 20 69 6e 20 61 6e 20 69 6e 74 ke.this.when.it.starts.in.an.int
2c300 65 72 61 63 74 69 76 65 20 6d 6f 64 65 3a 0a 0a 20 20 20 20 20 50 52 4f 47 52 41 4d 20 43 6f 70 eractive.mode:.......PROGRAM.Cop
2c320 79 72 69 67 68 74 20 28 43 29 20 59 45 41 52 20 4e 41 4d 45 20 4f 46 20 41 55 54 48 4f 52 0a 20 yright.(C).YEAR.NAME.OF.AUTHOR..
2c340 20 20 20 20 54 68 69 73 20 70 72 6f 67 72 61 6d 20 63 6f 6d 65 73 20 77 69 74 68 20 41 42 53 4f ....This.program.comes.with.ABSO
2c360 4c 55 54 45 4c 59 20 4e 4f 20 57 41 52 52 41 4e 54 59 3b 20 66 6f 72 20 64 65 74 61 69 6c 73 20 LUTELY.NO.WARRANTY;.for.details.
2c380 74 79 70 65 20 e2 80 98 73 68 6f 77 20 77 e2 80 99 2e 0a 20 20 20 20 20 54 68 69 73 20 69 73 20 type....show.w..........This.is.
2c3a0 66 72 65 65 20 73 6f 66 74 77 61 72 65 2c 20 61 6e 64 20 79 6f 75 20 61 72 65 20 77 65 6c 63 6f free.software,.and.you.are.welco
2c3c0 6d 65 20 74 6f 20 72 65 64 69 73 74 72 69 62 75 74 65 20 69 74 0a 20 20 20 20 20 75 6e 64 65 72 me.to.redistribute.it......under
2c3e0 20 63 65 72 74 61 69 6e 20 63 6f 6e 64 69 74 69 6f 6e 73 3b 20 74 79 70 65 20 e2 80 98 73 68 6f .certain.conditions;.type....sho
2c400 77 20 63 e2 80 99 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 0a 20 20 20 54 68 65 20 68 79 70 6f w.c....for.details......The.hypo
2c420 74 68 65 74 69 63 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 e2 80 98 73 68 6f 77 20 77 e2 80 99 20 61 thetical.commands....show.w....a
2c440 6e 64 20 e2 80 98 73 68 6f 77 20 63 e2 80 99 20 73 68 6f 75 6c 64 20 73 68 6f 77 20 74 68 65 0a nd....show.c....should.show.the.
2c460 61 70 70 72 6f 70 72 69 61 74 65 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 47 65 6e 65 72 61 6c appropriate.parts.of.the.General
2c480 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 2e 20 20 4f 66 20 63 6f 75 72 73 65 2c 20 79 6f 75 .Public.License...Of.course,.you
2c4a0 72 0a 70 72 6f 67 72 61 6d e2 80 99 73 20 63 6f 6d 6d 61 6e 64 73 20 6d 69 67 68 74 20 62 65 20 r.program...s.commands.might.be.
2c4c0 64 69 66 66 65 72 65 6e 74 3b 20 66 6f 72 20 61 20 47 55 49 20 69 6e 74 65 72 66 61 63 65 2c 20 different;.for.a.GUI.interface,.
2c4e0 79 6f 75 20 77 6f 75 6c 64 0a 75 73 65 20 61 6e 20 e2 80 9c 61 62 6f 75 74 20 62 6f 78 e2 80 9d you.would.use.an....about.box...
2c500 2e 0a 0a 20 20 20 59 6f 75 20 73 68 6f 75 6c 64 20 61 6c 73 6f 20 67 65 74 20 79 6f 75 72 20 65 ......You.should.also.get.your.e
2c520 6d 70 6c 6f 79 65 72 20 28 69 66 20 79 6f 75 20 77 6f 72 6b 20 61 73 20 61 20 70 72 6f 67 72 61 mployer.(if.you.work.as.a.progra
2c540 6d 6d 65 72 29 20 6f 72 0a 73 63 68 6f 6f 6c 2c 20 69 66 20 61 6e 79 2c 20 74 6f 20 73 69 67 6e mmer).or.school,.if.any,.to.sign
2c560 20 61 20 e2 80 9c 63 6f 70 79 72 69 67 68 74 20 64 69 73 63 6c 61 69 6d 65 72 e2 80 9d 20 66 6f .a....copyright.disclaimer....fo
2c580 72 20 74 68 65 20 70 72 6f 67 72 61 6d 2c 20 69 66 0a 6e 65 63 65 73 73 61 72 79 2e 20 20 46 6f r.the.program,.if.necessary...Fo
2c5a0 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 69 73 2c 20 61 6e 64 20 r.more.information.on.this,.and.
2c5c0 68 6f 77 20 74 6f 20 61 70 70 6c 79 20 61 6e 64 20 66 6f 6c 6c 6f 77 0a 74 68 65 20 47 4e 55 20 how.to.apply.and.follow.the.GNU.
2c5e0 47 50 4c 2c 20 73 65 65 20 3c 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 GPL,.see.<https://www.gnu.org/li
2c600 63 65 6e 73 65 73 2f 3e 2e 0a 0a 20 20 20 54 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 censes/>......The.GNU.General.Pu
2c620 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 64 6f 65 73 20 6e 6f 74 20 70 65 72 6d 69 74 20 69 6e 63 blic.License.does.not.permit.inc
2c640 6f 72 70 6f 72 61 74 69 6e 67 20 79 6f 75 72 0a 70 72 6f 67 72 61 6d 20 69 6e 74 6f 20 70 72 6f orporating.your.program.into.pro
2c660 70 72 69 65 74 61 72 79 20 70 72 6f 67 72 61 6d 73 2e 20 20 49 66 20 79 6f 75 72 20 70 72 6f 67 prietary.programs...If.your.prog
2c680 72 61 6d 20 69 73 20 61 20 73 75 62 72 6f 75 74 69 6e 65 0a 6c 69 62 72 61 72 79 2c 20 79 6f 75 ram.is.a.subroutine.library,.you
2c6a0 20 6d 61 79 20 63 6f 6e 73 69 64 65 72 20 69 74 20 6d 6f 72 65 20 75 73 65 66 75 6c 20 74 6f 20 .may.consider.it.more.useful.to.
2c6c0 70 65 72 6d 69 74 20 6c 69 6e 6b 69 6e 67 20 70 72 6f 70 72 69 65 74 61 72 79 0a 61 70 70 6c 69 permit.linking.proprietary.appli
2c6e0 63 61 74 69 6f 6e 73 20 77 69 74 68 20 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 49 66 20 74 68 cations.with.the.library...If.th
2c700 69 73 20 69 73 20 77 68 61 74 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 6f 2c 20 75 73 65 20 74 is.is.what.you.want.to.do,.use.t
2c720 68 65 0a 47 4e 55 20 4c 65 73 73 65 72 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 he.GNU.Lesser.General.Public.Lic
2c740 65 6e 73 65 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 69 73 20 4c 69 63 65 6e 73 65 2e 20 20 42 ense.instead.of.this.License...B
2c760 75 74 20 66 69 72 73 74 2c 0a 70 6c 65 61 73 65 20 72 65 61 64 20 3c 68 74 74 70 73 3a 2f 2f 77 ut.first,.please.read.<https://w
2c780 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 63 65 6e 73 65 73 2f 77 68 79 2d 6e 6f 74 2d 6c 67 70 6c ww.gnu.org/licenses/why-not-lgpl
2c7a0 2e 68 74 6d 6c 3e 2e 0a 0a 0a 1f 0a 54 61 67 20 54 61 62 6c 65 3a 0a 4e 6f 64 65 3a 20 54 6f 70 .html>......Tag.Table:.Node:.Top
2c7c0 7f 37 36 33 0a 4e 6f 64 65 3a 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 7f 33 30 37 33 0a 52 65 66 .763.Node:.Introduction.3073.Ref
2c7e0 3a 20 53 6f 6d 65 20 74 68 69 6e 67 73 20 74 68 61 74 20 54 72 61 6e 73 69 65 6e 74 20 63 61 6e :.Some.things.that.Transient.can
2c800 20 64 6f 7f 33 36 30 31 0a 52 65 66 3a 20 43 6f 6d 70 6c 65 78 69 74 79 20 69 6e 20 43 4c 49 20 .do.3601.Ref:.Complexity.in.CLI.
2c820 70 72 6f 67 72 61 6d 73 7f 33 39 35 34 0a 52 65 66 3a 20 55 73 69 6e 67 20 54 72 61 6e 73 69 65 programs.3954.Ref:.Using.Transie
2c840 6e 74 20 66 6f 72 20 63 6f 6d 70 6f 73 69 6e 67 20 69 6e 74 65 72 61 63 74 69 76 65 20 63 6f 6d nt.for.composing.interactive.com
2c860 6d 61 6e 64 73 7f 34 35 35 35 0a 4e 6f 64 65 3a 20 55 73 61 67 65 7f 36 37 39 37 0a 4e 6f 64 65 mands.4555.Node:.Usage.6797.Node
2c880 3a 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 7f 37 31 36 35 0a 4e 6f 64 65 3a :.Invoking.Transients.7165.Node:
2c8a0 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 .Aborting.and.Resuming.Transient
2c8c0 73 7f 38 33 35 37 0a 4e 6f 64 65 3a 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 s.8357.Node:.Common.Suffix.Comma
2c8e0 6e 64 73 7f 31 30 39 34 39 0a 4e 6f 64 65 3a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 7f 31 33 nds.10949.Node:.Saving.Values.13
2c900 38 37 37 0a 52 65 66 3a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 2d 46 6f 6f 74 6e 6f 74 65 2d 877.Ref:.Saving.Values-Footnote-
2c920 31 7f 31 35 34 32 36 0a 4e 6f 64 65 3a 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 7f 31 35 36 31 1.15426.Node:.Using.History.1561
2c940 39 0a 4e 6f 64 65 3a 20 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 6f 72 20 53 75 66 66 69 78 20 9.Node:.Getting.Help.for.Suffix.
2c960 43 6f 6d 6d 61 6e 64 73 7f 31 37 34 36 39 0a 4e 6f 64 65 3a 20 45 6e 61 62 6c 69 6e 67 20 61 6e Commands.17469.Node:.Enabling.an
2c980 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 7f 31 38 38 34 30 0a 4e 6f 64 65 3a d.Disabling.Suffixes.18840.Node:
2c9a0 20 4f 74 68 65 72 20 43 6f 6d 6d 61 6e 64 73 7f 32 34 31 38 30 0a 4e 6f 64 65 3a 20 43 6f 6e 66 .Other.Commands.24180.Node:.Conf
2c9c0 69 67 75 72 61 74 69 6f 6e 7f 32 35 38 34 38 0a 52 65 66 3a 20 45 73 73 65 6e 74 69 61 6c 20 4f iguration.25848.Ref:.Essential.O
2c9e0 70 74 69 6f 6e 73 7f 32 36 31 32 38 0a 52 65 66 3a 20 41 63 63 65 73 73 69 62 69 6c 69 74 79 20 ptions.26128.Ref:.Accessibility.
2ca00 4f 70 74 69 6f 6e 73 7f 33 32 36 35 30 0a 52 65 66 3a 20 41 75 78 69 6c 69 61 72 79 20 4f 70 74 Options.32650.Ref:.Auxiliary.Opt
2ca20 69 6f 6e 73 7f 33 32 39 36 39 0a 52 65 66 3a 20 44 65 76 65 6c 6f 70 65 72 20 4f 70 74 69 6f 6e ions.32969.Ref:.Developer.Option
2ca40 73 7f 33 37 35 30 39 0a 52 65 66 3a 20 48 6f 6f 6b 20 56 61 72 69 61 62 6c 65 73 7f 33 39 30 32 s.37509.Ref:.Hook.Variables.3902
2ca60 34 0a 4e 6f 64 65 3a 20 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 4.Node:.Modifying.Existing.Trans
2ca80 69 65 6e 74 73 7f 33 39 35 34 30 0a 4e 6f 64 65 3a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 ients.39540.Node:.Defining.New.C
2caa0 6f 6d 6d 61 6e 64 73 7f 34 35 33 35 30 0a 4e 6f 64 65 3a 20 54 65 63 68 6e 69 63 61 6c 20 49 6e ommands.45350.Node:.Technical.In
2cac0 74 72 6f 64 75 63 74 69 6f 6e 7f 34 35 37 39 30 0a 4e 6f 64 65 3a 20 44 65 66 69 6e 69 6e 67 20 troduction.45790.Node:.Defining.
2cae0 54 72 61 6e 73 69 65 6e 74 73 7f 35 31 34 39 39 0a 4e 6f 64 65 3a 20 42 69 6e 64 69 6e 67 20 53 Transients.51499.Node:.Binding.S
2cb00 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 7f 35 34 38 33 34 0a 4e uffix.and.Infix.Commands.54834.N
2cb20 6f 64 65 3a 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 7f 35 35 36 39 32 0a ode:.Group.Specifications.55692.
2cb40 4e 6f 64 65 3a 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 7f 36 32 36 32 Node:.Suffix.Specifications.6262
2cb60 38 0a 4e 6f 64 65 3a 20 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 8.Node:.Defining.Suffix.and.Infi
2cb80 78 20 43 6f 6d 6d 61 6e 64 73 7f 36 37 36 36 35 0a 4e 6f 64 65 3a 20 55 73 69 6e 67 20 49 6e 66 x.Commands.67665.Node:.Using.Inf
2cba0 69 78 20 41 72 67 75 6d 65 6e 74 73 7f 37 30 36 37 31 0a 4e 6f 64 65 3a 20 55 73 69 6e 67 20 50 ix.Arguments.70671.Node:.Using.P
2cbc0 72 65 66 69 78 20 53 63 6f 70 65 7f 37 33 36 38 36 0a 4e 6f 64 65 3a 20 43 75 72 72 65 6e 74 20 refix.Scope.73686.Node:.Current.
2cbe0 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 7f 37 35 36 38 38 0a 4e 6f 64 65 3a 20 43 75 72 72 65 Suffix.Command.75688.Node:.Curre
2cc00 6e 74 20 50 72 65 66 69 78 20 43 6f 6d 6d 61 6e 64 7f 37 38 30 33 37 0a 4e 6f 64 65 3a 20 54 72 nt.Prefix.Command.78037.Node:.Tr
2cc20 61 6e 73 69 65 6e 74 20 53 74 61 74 65 7f 38 30 35 37 37 0a 52 65 66 3a 20 50 72 65 2d 63 6f 6d ansient.State.80577.Ref:.Pre-com
2cc40 6d 61 6e 64 73 20 66 6f 72 20 49 6e 66 69 78 65 73 7f 38 34 39 32 38 0a 52 65 66 3a 20 50 72 65 mands.for.Infixes.84928.Ref:.Pre
2cc60 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 53 75 66 66 69 78 65 73 7f 38 35 34 34 35 0a 52 65 66 -commands.for.Suffixes.85445.Ref
2cc80 3a 20 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 4e 6f 6e 2d 53 75 66 66 69 78 65 73 7f :.Pre-commands.for.Non-Suffixes.
2cca0 38 37 38 37 37 0a 52 65 66 3a 20 53 70 65 63 69 61 6c 20 50 72 65 2d 43 6f 6d 6d 61 6e 64 73 7f 87877.Ref:.Special.Pre-Commands.
2ccc0 38 39 30 30 34 0a 4e 6f 64 65 3a 20 43 6c 61 73 73 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 7f 89004.Node:.Classes.and.Methods.
2cce0 38 39 35 30 33 0a 4e 6f 64 65 3a 20 47 72 6f 75 70 20 43 6c 61 73 73 65 73 7f 39 31 35 39 30 0a 89503.Node:.Group.Classes.91590.
2cd00 4e 6f 64 65 3a 20 47 72 6f 75 70 20 4d 65 74 68 6f 64 73 7f 39 33 35 31 37 0a 4e 6f 64 65 3a 20 Node:.Group.Methods.93517.Node:.
2cd20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 7f 39 34 37 36 39 0a 4e 6f 64 65 3a 20 53 75 66 66 69 Prefix.Classes.94769.Node:.Suffi
2cd40 78 20 43 6c 61 73 73 65 73 7f 39 35 36 31 34 0a 4e 6f 64 65 3a 20 50 72 65 66 69 78 20 4d 65 74 x.Classes.95614.Node:.Prefix.Met
2cd60 68 6f 64 73 7f 31 30 30 34 31 32 0a 4e 6f 64 65 3a 20 53 75 66 66 69 78 20 4d 65 74 68 6f 64 73 hods.100412.Node:.Suffix.Methods
2cd80 7f 31 30 33 36 31 39 0a 4e 6f 64 65 3a 20 53 75 66 66 69 78 20 56 61 6c 75 65 20 4d 65 74 68 6f .103619.Node:.Suffix.Value.Metho
2cda0 64 73 7f 31 30 33 39 34 30 0a 4e 6f 64 65 3a 20 53 75 66 66 69 78 20 46 6f 72 6d 61 74 20 4d 65 ds.103940.Node:.Suffix.Format.Me
2cdc0 74 68 6f 64 73 7f 31 30 37 32 36 31 0a 4e 6f 64 65 3a 20 50 72 65 66 69 78 20 53 6c 6f 74 73 7f thods.107261.Node:.Prefix.Slots.
2cde0 31 31 30 32 33 35 0a 52 65 66 3a 20 56 61 6c 75 65 20 61 6e 64 20 53 63 6f 70 65 7f 31 31 30 33 110235.Ref:.Value.and.Scope.1103
2ce00 38 35 0a 52 65 66 3a 20 42 65 68 61 76 69 6f 72 7f 31 31 33 33 38 37 0a 52 65 66 3a 20 41 70 70 85.Ref:.Behavior.113387.Ref:.App
2ce20 65 61 72 61 6e 63 65 7f 31 31 34 37 32 38 0a 52 65 66 3a 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f earance.114728.Ref:.Documentatio
2ce40 6e 7f 31 31 35 34 31 34 0a 52 65 66 3a 20 49 6e 74 65 72 6e 61 6c 7f 31 31 36 30 33 34 0a 4e 6f n.115414.Ref:.Internal.116034.No
2ce60 64 65 3a 20 53 75 66 66 69 78 20 53 6c 6f 74 73 7f 31 31 37 33 38 39 0a 52 65 66 3a 20 53 6c 6f de:.Suffix.Slots.117389.Ref:.Slo
2ce80 74 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 7f 31 31 37 37 35 37 0a 52 65 66 ts.of.transient-child.117757.Ref
2cea0 3a 20 53 6c 6f 74 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7f 31 31 38 32 :.Slots.of.transient-suffix.1182
2cec0 31 35 0a 52 65 66 3a 20 53 6c 6f 74 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 15.Ref:.Slots.of.transient-infix
2cee0 7f 31 32 31 30 36 38 0a 52 65 66 3a 20 53 6c 6f 74 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 2d .121068.Ref:.Slots.of.transient-
2cf00 76 61 72 69 61 62 6c 65 7f 31 32 34 33 36 34 0a 52 65 66 3a 20 53 6c 6f 74 73 20 6f 66 20 74 72 variable.124364.Ref:.Slots.of.tr
2cf20 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 7f 31 32 34 34 36 36 0a 4e 6f 64 65 3a 20 50 72 ansient-switches.124466.Node:.Pr
2cf40 65 64 69 63 61 74 65 20 53 6c 6f 74 73 7f 31 32 34 38 32 39 0a 4e 6f 64 65 3a 20 46 41 51 7f 31 edicate.Slots.124829.Node:.FAQ.1
2cf60 32 37 31 37 34 0a 52 65 66 3a 20 43 61 6e 20 49 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 68 65 27174.Ref:.Can.I.control.how.the
2cf80 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 3f 7f 31 32 37 33 30 .menu.buffer.is.displayed?.12730
2cfa0 33 0a 52 65 66 3a 20 48 6f 77 20 63 61 6e 20 49 20 63 6f 70 79 20 74 65 78 74 20 66 72 6f 6d 20 3.Ref:.How.can.I.copy.text.from.
2cfc0 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 3f 7f 31 32 37 36 32 37 0a 52 65 66 3a 20 48 6f 77 the.menu.buffer?.127627.Ref:.How
2cfe0 20 63 61 6e 20 49 20 61 75 74 6f 6c 6f 61 64 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 .can.I.autoload.prefix.and.suffi
2d000 78 20 63 6f 6d 6d 61 6e 64 73 3f 7f 31 32 38 33 39 30 0a 52 65 66 3a 20 48 6f 77 20 64 6f 65 73 x.commands?.128390.Ref:.How.does
2d020 20 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 70 61 72 65 20 74 6f 20 70 72 65 66 69 78 20 6b 65 79 .Transient.compare.to.prefix.key
2d040 73 20 61 6e 64 20 75 6e 69 76 65 72 73 61 6c 20 61 72 67 75 6d 65 6e 74 73 3f 7f 31 32 38 38 36 s.and.universal.arguments?.12886
2d060 34 0a 52 65 66 3a 20 48 6f 77 20 64 6f 65 73 20 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 70 61 72 4.Ref:.How.does.Transient.compar
2d080 65 20 74 6f 20 4d 61 67 69 74 2d 50 6f 70 75 70 20 61 6e 64 20 48 79 64 72 61 3f 7f 31 32 39 31 e.to.Magit-Popup.and.Hydra?.1291
2d0a0 30 37 0a 52 65 66 3a 20 57 68 79 20 64 6f 65 73 20 71 20 6e 6f 74 20 71 75 69 74 20 70 6f 70 75 07.Ref:.Why.does.q.not.quit.popu
2d0c0 70 73 20 61 6e 79 6d 6f 72 65 3f 7f 31 32 39 33 30 31 0a 4e 6f 64 65 3a 20 4b 65 79 73 74 72 6f ps.anymore?.129301.Node:.Keystro
2d0e0 6b 65 20 49 6e 64 65 78 7f 31 33 30 34 30 34 0a 4e 6f 64 65 3a 20 43 6f 6d 6d 61 6e 64 20 61 6e ke.Index.130404.Node:.Command.an
2d100 64 20 46 75 6e 63 74 69 6f 6e 20 49 6e 64 65 78 7f 31 33 30 35 36 34 0a 4e 6f 64 65 3a 20 56 61 d.Function.Index.130564.Node:.Va
2d120 72 69 61 62 6c 65 20 49 6e 64 65 78 7f 31 33 30 37 35 37 0a 4e 6f 64 65 3a 20 43 6f 6e 63 65 70 riable.Index.130757.Node:.Concep
2d140 74 20 49 6e 64 65 78 7f 31 33 30 39 32 34 0a 4e 6f 64 65 3a 20 47 4e 55 20 47 65 6e 65 72 61 6c t.Index.130924.Node:.GNU.General
2d160 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 7f 31 33 33 36 36 30 0a 1f 0a 45 6e 64 20 54 61 67 .Public.License.133660...End.Tag
2d180 20 54 61 62 6c 65 0a 0a 1f 0a 4c 6f 63 61 6c 20 56 61 72 69 61 62 6c 65 73 3a 0a 63 6f 64 69 6e .Table....Local.Variables:.codin
2d1a0 67 3a 20 75 74 66 2d 38 0a 45 6e 64 3a 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 g:.utf-8.End:...................
2d1c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d1e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d200 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 74 72 61 6e 73 69 65 6e 74 2e 6f 72 67 00 00 transient-0.10.0/transient.org..
2d220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d260 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
2d280 30 33 35 32 32 30 35 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 34 37 36 35 00 20 30 00 00 00 0352205.00000000000.014765..0...
2d2a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d2c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d2e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d300 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...................
2d320 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...................
2d340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d3a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d3c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d3e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
2d400 23 2b 74 69 74 6c 65 3a 20 54 72 61 6e 73 69 65 6e 74 20 55 73 65 72 20 61 6e 64 20 44 65 76 65 #+title:.Transient.User.and.Deve
2d420 6c 6f 70 65 72 20 4d 61 6e 75 61 6c 0a 3a 50 52 45 41 4d 42 4c 45 3a 0a 23 2b 61 75 74 68 6f 72 loper.Manual.:PREAMBLE:.#+author
2d440 3a 20 4a 6f 6e 61 73 20 42 65 72 6e 6f 75 6c 6c 69 0a 23 2b 65 6d 61 69 6c 3a 20 65 6d 61 63 73 :.Jonas.Bernoulli.#+email:.emacs
2d460 2e 74 72 61 6e 73 69 65 6e 74 40 6a 6f 6e 61 73 2e 62 65 72 6e 6f 75 6c 6c 69 2e 64 65 76 0a 23 .transient@jonas.bernoulli.dev.#
2d480 2b 64 61 74 65 3a 20 32 30 31 38 2d 7b 7b 7b 79 65 61 72 7d 7d 7d 0a 0a 23 2b 74 65 78 69 6e 66 +date:.2018-{{{year}}}..#+texinf
2d4a0 6f 5f 64 69 72 5f 63 61 74 65 67 6f 72 79 3a 20 45 6d 61 63 73 20 6d 69 73 63 20 66 65 61 74 75 o_dir_category:.Emacs.misc.featu
2d4c0 72 65 73 0a 23 2b 74 65 78 69 6e 66 6f 5f 64 69 72 5f 74 69 74 6c 65 3a 20 54 72 61 6e 73 69 65 res.#+texinfo_dir_title:.Transie
2d4e0 6e 74 3a 20 28 74 72 61 6e 73 69 65 6e 74 29 2e 0a 23 2b 74 65 78 69 6e 66 6f 5f 64 69 72 5f 64 nt:.(transient)..#+texinfo_dir_d
2d500 65 73 63 3a 20 54 72 61 6e 73 69 65 6e 74 20 43 6f 6d 6d 61 6e 64 73 0a 23 2b 73 75 62 74 69 74 esc:.Transient.Commands.#+subtit
2d520 6c 65 3a 20 66 6f 72 20 76 65 72 73 69 6f 6e 20 30 2e 31 30 2e 30 0a 0a 23 2b 73 65 74 75 70 66 le:.for.version.0.10.0..#+setupf
2d540 69 6c 65 3a 20 2e 6f 72 67 63 6f 6e 66 69 67 0a 0a 54 72 61 6e 73 69 65 6e 74 20 69 73 20 74 68 ile:..orgconfig..Transient.is.th
2d560 65 20 6c 69 62 72 61 72 79 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 e.library.used.to.implement.the.
2d580 6b 65 79 62 6f 61 72 64 2d 64 72 69 76 65 6e 20 e2 80 9c 6d 65 6e 75 73 e2 80 9d 0a 69 6e 20 4d keyboard-driven....menus....in.M
2d5a0 61 67 69 74 2e 20 20 49 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 agit...It.is.distributed.as.a.se
2d5c0 70 61 72 61 74 65 20 70 61 63 6b 61 67 65 2c 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 parate.package,.so.that.it.can.b
2d5e0 65 0a 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 e.used.to.implement.similar.menu
2d600 73 20 69 6e 20 6f 74 68 65 72 20 70 61 63 6b 61 67 65 73 2e 0a 0a 54 68 69 73 20 6d 61 6e 75 61 s.in.other.packages...This.manua
2d620 6c 20 63 61 6e 20 62 65 20 62 69 74 20 68 61 72 64 20 74 6f 20 64 69 67 65 73 74 20 77 68 65 6e l.can.be.bit.hard.to.digest.when
2d640 20 67 65 74 74 69 6e 67 20 73 74 61 72 74 65 64 2e 20 20 41 20 75 73 65 66 75 6c 0a 72 65 73 6f .getting.started...A.useful.reso
2d660 75 72 63 65 20 74 6f 20 67 65 74 20 6f 76 65 72 20 74 68 61 74 20 68 75 72 64 6c 65 20 69 73 20 urce.to.get.over.that.hurdle.is.
2d680 50 73 69 6f 6e 69 63 20 4b 27 73 20 69 6e 74 65 72 61 63 74 69 76 65 20 74 75 74 6f 72 69 61 6c Psionic.K's.interactive.tutorial
2d6a0 2c 0a 61 76 61 69 6c 61 62 6c 65 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f ,.available.at.https://github.co
2d6c0 6d 2f 70 6f 73 69 74 72 6f 6e 2d 73 6f 6c 75 74 69 6f 6e 73 2f 74 72 61 6e 73 69 65 6e 74 2d 73 m/positron-solutions/transient-s
2d6e0 68 6f 77 63 61 73 65 2e 0a 0a 23 2b 74 65 78 69 6e 66 6f 3a 20 40 6e 6f 69 6e 64 65 6e 74 0a 54 howcase...#+texinfo:.@noindent.T
2d700 68 69 73 20 6d 61 6e 75 61 6c 20 69 73 20 66 6f 72 20 54 72 61 6e 73 69 65 6e 74 20 76 65 72 73 his.manual.is.for.Transient.vers
2d720 69 6f 6e 20 30 2e 31 30 2e 30 2e 0a 0a 23 2b 74 65 78 69 6e 66 6f 3a 20 40 69 6e 73 65 72 74 63 ion.0.10.0...#+texinfo:.@insertc
2d740 6f 70 79 69 6e 67 0a 3a 45 4e 44 3a 0a 2a 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 0a 0a 54 72 61 opying.:END:.*.Introduction..Tra
2d760 6e 73 69 65 6e 74 20 69 73 20 74 68 65 20 6c 69 62 72 61 72 79 20 75 73 65 64 20 74 6f 20 69 6d nsient.is.the.library.used.to.im
2d780 70 6c 65 6d 65 6e 74 20 74 68 65 20 6b 65 79 62 6f 61 72 64 2d 64 72 69 76 65 6e 20 7b 7b 7b 64 plement.the.keyboard-driven.{{{d
2d7a0 66 6e 28 6d 65 6e 75 73 29 7d 7d 7d 0a 69 6e 20 4d 61 67 69 74 2e 20 20 49 74 20 69 73 20 64 69 fn(menus)}}}.in.Magit...It.is.di
2d7c0 73 74 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 70 61 72 61 74 65 20 70 61 63 6b 61 67 65 2c stributed.as.a.separate.package,
2d7e0 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 .so.that.it.can.be.used.to.imple
2d800 6d 65 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 73 20 69 6e 20 6f 74 68 65 72 20 70 61 63 6b ment.similar.menus.in.other.pack
2d820 61 67 65 73 2e 0a 0a 54 68 69 73 20 6d 61 6e 75 61 6c 20 63 61 6e 20 62 65 20 62 69 74 20 68 61 ages...This.manual.can.be.bit.ha
2d840 72 64 20 74 6f 20 64 69 67 65 73 74 20 77 68 65 6e 20 67 65 74 74 69 6e 67 20 73 74 61 72 74 65 rd.to.digest.when.getting.starte
2d860 64 2e 20 20 41 20 75 73 65 66 75 6c 0a 72 65 73 6f 75 72 63 65 20 74 6f 20 67 65 74 20 6f 76 65 d...A.useful.resource.to.get.ove
2d880 72 20 74 68 61 74 20 68 75 72 64 6c 65 20 69 73 20 50 73 69 6f 6e 69 63 20 4b 27 73 20 69 6e 74 r.that.hurdle.is.Psionic.K's.int
2d8a0 65 72 61 63 74 69 76 65 20 74 75 74 6f 72 69 61 6c 2c 0a 61 76 61 69 6c 61 62 6c 65 20 61 74 20 eractive.tutorial,.available.at.
2d8c0 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 70 6f 73 69 74 72 6f 6e 2d 73 6f 6c 75 https://github.com/positron-solu
2d8e0 74 69 6f 6e 73 2f 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 63 61 73 65 2e 0a 0a 2a 2a 20 53 6f tions/transient-showcase...**.So
2d900 6d 65 20 74 68 69 6e 67 73 20 74 68 61 74 20 54 72 61 6e 73 69 65 6e 74 20 63 61 6e 20 64 6f 0a me.things.that.Transient.can.do.
2d920 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a :PROPERTIES:.:UNNUMBERED:.notoc.
2d940 3a 45 4e 44 3a 0a 0a 2d 20 44 69 73 70 6c 61 79 20 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f :END:..-.Display.current.state.o
2d960 66 20 61 72 67 75 6d 65 6e 74 73 0a 2d 20 44 69 73 70 6c 61 79 20 61 6e 64 20 6d 61 6e 61 67 65 f.arguments.-.Display.and.manage
2d980 20 6c 69 66 65 63 79 63 6c 65 20 6f 66 20 6d 6f 64 61 6c 20 62 69 6e 64 69 6e 67 73 0a 2d 20 43 .lifecycle.of.modal.bindings.-.C
2d9a0 6f 6e 74 65 78 74 75 61 6c 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 0a 2d 20 46 6c 6f 77 20 ontextual.user.interface.-.Flow.
2d9c0 63 6f 6e 74 72 6f 6c 20 66 6f 72 20 77 69 7a 61 72 64 2d 6c 69 6b 65 20 63 6f 6d 70 6f 73 69 74 control.for.wizard-like.composit
2d9e0 69 6f 6e 20 6f 66 20 69 6e 74 65 72 61 63 74 69 76 65 20 66 6f 72 6d 73 0a 2d 20 48 69 73 74 6f ion.of.interactive.forms.-.Histo
2da00 72 79 20 26 20 70 65 72 73 69 73 74 65 6e 63 65 0a 2d 20 52 65 6e 64 65 72 69 6e 67 20 61 72 67 ry.&.persistence.-.Rendering.arg
2da20 75 6d 65 6e 74 73 20 66 6f 72 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 43 4c 49 20 70 72 6f 67 72 uments.for.controlling.CLI.progr
2da40 61 6d 73 0a 0a 2a 2a 20 43 6f 6d 70 6c 65 78 69 74 79 20 69 6e 20 43 4c 49 20 70 72 6f 67 72 61 ams..**.Complexity.in.CLI.progra
2da60 6d 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 ms.:PROPERTIES:.:UNNUMBERED:.not
2da80 6f 63 0a 3a 45 4e 44 3a 0a 0a 43 6f 6d 70 6c 65 78 69 74 79 20 74 65 6e 64 73 20 74 6f 20 67 72 oc.:END:..Complexity.tends.to.gr
2daa0 6f 77 20 77 69 74 68 20 74 69 6d 65 2e 20 20 48 6f 77 20 64 6f 20 79 6f 75 20 6d 61 6e 61 67 65 ow.with.time...How.do.you.manage
2dac0 20 74 68 65 20 63 6f 6d 70 6c 65 78 69 74 79 0a 6f 66 20 63 6f 6d 6d 61 6e 64 73 3f 20 20 43 6f .the.complexity.of.commands?..Co
2dae0 6e 73 69 64 65 72 20 74 68 65 20 68 75 6d 62 6c 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 nsider.the.humble.shell.command.
2db00 3d 6c 73 3d 2e 20 20 49 74 20 6e 6f 77 20 68 61 73 20 6f 76 65 72 0a 2f 66 69 66 74 79 2f 20 63 =ls=...It.now.has.over./fifty/.c
2db20 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 2e 20 20 53 6f 6d 65 20 6f 66 20 74 68 ommand.line.options...Some.of.th
2db40 65 73 65 20 61 72 65 20 62 6f 6f 6c 65 61 6e 20 66 6c 61 67 73 20 28 3d 6c 73 20 2d 6c 3d 29 2e ese.are.boolean.flags.(=ls.-l=).
2db60 0a 53 6f 6d 65 20 74 61 6b 65 20 61 72 67 75 6d 65 6e 74 73 20 28 3d 6c 73 20 2d 2d 73 6f 72 74 .Some.take.arguments.(=ls.--sort
2db80 3d 73 3d 29 2e 20 20 53 6f 6d 65 20 68 61 76 65 20 6e 6f 20 65 66 66 65 63 74 20 75 6e 6c 65 73 =s=)...Some.have.no.effect.unles
2dba0 73 20 70 61 69 72 65 64 0a 77 69 74 68 20 6f 74 68 65 72 20 66 6c 61 67 73 20 28 3d 6c 73 20 2d s.paired.with.other.flags.(=ls.-
2dbc0 6c 68 3d 29 2e 20 20 53 6f 6d 65 20 61 72 65 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 lh=)...Some.are.mutually.exclusi
2dbe0 76 65 2e 20 20 53 6f 6d 65 20 73 68 65 6c 6c 0a 63 6f 6d 6d 61 6e 64 73 20 65 76 65 6e 20 68 61 ve...Some.shell.commands.even.ha
2dc00 76 65 20 73 6f 20 6d 61 6e 79 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 68 65 79 20 69 6e 74 ve.so.many.options.that.they.int
2dc20 72 6f 64 75 63 65 20 2f 73 75 62 63 6f 6d 6d 61 6e 64 73 2f 0a 28 3d 67 69 74 20 62 72 61 6e 63 roduce./subcommands/.(=git.branc
2dc40 68 3d 2c 20 3d 67 69 74 20 63 6f 6d 6d 69 74 3d 29 2c 20 65 61 63 68 20 77 69 74 68 20 74 68 65 h=,.=git.commit=),.each.with.the
2dc60 69 72 20 6f 77 6e 20 72 69 63 68 20 73 65 74 20 6f 66 20 6f 70 74 69 6f 6e 73 0a 28 3d 67 69 74 ir.own.rich.set.of.options.(=git
2dc80 20 62 72 61 6e 63 68 20 2d 66 3d 29 2e 0a 0a 2a 2a 20 55 73 69 6e 67 20 54 72 61 6e 73 69 65 6e .branch.-f=)...**.Using.Transien
2dca0 74 20 66 6f 72 20 63 6f 6d 70 6f 73 69 6e 67 20 69 6e 74 65 72 61 63 74 69 76 65 20 63 6f 6d 6d t.for.composing.interactive.comm
2dcc0 61 6e 64 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e ands.:PROPERTIES:.:UNNUMBERED:.n
2dce0 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 57 68 61 74 20 61 62 6f 75 74 20 45 6d 61 63 73 20 63 6f 6d otoc.:END:..What.about.Emacs.com
2dd00 6d 61 6e 64 73 20 75 73 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 3f 20 20 48 6f 77 20 64 mands.used.interactively?..How.d
2dd20 6f 20 74 68 65 73 65 20 68 61 6e 64 6c 65 0a 6f 70 74 69 6f 6e 73 3f 20 20 4f 6e 65 20 73 6f 6c o.these.handle.options?..One.sol
2dd40 75 74 69 6f 6e 20 69 73 20 74 6f 20 6d 61 6b 65 20 6d 61 6e 79 20 76 65 72 73 69 6f 6e 73 20 6f ution.is.to.make.many.versions.o
2dd60 66 20 74 68 65 20 73 61 6d 65 20 63 6f 6d 6d 61 6e 64 2c 0a 73 6f 20 79 6f 75 20 64 6f 6e 27 74 f.the.same.command,.so.you.don't
2dd80 20 6e 65 65 64 20 74 6f 21 20 20 43 6f 6e 73 69 64 65 72 3a 20 3d 64 65 6c 65 74 65 2d 6f 74 68 .need.to!..Consider:.=delete-oth
2dda0 65 72 2d 77 69 6e 64 6f 77 73 3d 20 76 73 2e 0a 3d 64 65 6c 65 74 65 2d 6f 74 68 65 72 2d 77 69 er-windows=.vs..=delete-other-wi
2ddc0 6e 64 6f 77 73 2d 76 65 72 74 69 63 61 6c 6c 79 3d 20 28 61 6d 6f 6e 67 20 6d 61 6e 79 20 73 69 ndows-vertically=.(among.many.si
2dde0 6d 69 6c 61 72 20 65 78 61 6d 70 6c 65 73 29 2e 0a 0a 53 6f 6d 65 20 45 6d 61 63 73 20 63 6f 6d milar.examples)...Some.Emacs.com
2de00 6d 61 6e 64 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 70 72 6f 6d 70 74 20 79 6f 75 20 66 6f 72 mands.will.simply.prompt.you.for
2de20 20 74 68 65 20 6e 65 78 74 20 22 61 72 67 75 6d 65 6e 74 22 0a 28 3d 4d 2d 78 20 73 77 69 74 63 .the.next."argument".(=M-x.switc
2de40 68 2d 74 6f 2d 62 75 66 66 65 72 3d 29 2e 20 20 41 6e 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e 20 73 h-to-buffer=)...Another.common.s
2de60 6f 6c 75 74 69 6f 6e 20 69 73 20 74 6f 20 75 73 65 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e olution.is.to.use.prefix.argumen
2de80 74 73 20 77 68 69 63 68 20 75 73 75 61 6c 6c 79 20 73 74 61 72 74 20 77 69 74 68 20 3d 43 2d 75 ts.which.usually.start.with.=C-u
2dea0 3d 2e 20 20 53 6f 6d 65 74 69 6d 65 73 20 74 68 65 73 65 20 61 72 65 20 73 65 6e 73 69 62 6c 79 =...Sometimes.these.are.sensibly
2dec0 0a 6e 75 6d 65 72 69 63 61 6c 20 69 6e 20 6e 61 74 75 72 65 20 28 3d 43 2d 75 20 34 20 4d 2d 78 .numerical.in.nature.(=C-u.4.M-x
2dee0 20 66 6f 72 77 61 72 64 2d 70 61 72 61 67 72 61 70 68 3d 20 74 6f 20 6d 6f 76 65 20 66 6f 72 77 .forward-paragraph=.to.move.forw
2df00 61 72 64 20 34 0a 70 61 72 61 67 72 61 70 68 73 29 2e 20 20 42 75 74 20 73 6f 6d 65 74 69 6d 65 ard.4.paragraphs)...But.sometime
2df20 73 20 74 68 65 79 20 66 75 6e 63 74 69 6f 6e 20 69 6e 73 74 65 61 64 20 61 73 20 62 6f 6f 6c 65 s.they.function.instead.as.boole
2df40 61 6e 0a 22 73 77 69 74 63 68 65 73 22 20 28 3d 43 2d 75 20 43 2d 53 50 41 43 45 3d 20 74 6f 20 an."switches".(=C-u.C-SPACE=.to.
2df60 6a 75 6d 70 20 74 6f 20 74 68 65 20 6c 61 73 74 20 6d 61 72 6b 20 69 6e 73 74 65 61 64 20 6f 66 jump.to.the.last.mark.instead.of
2df80 20 6a 75 73 74 0a 73 65 74 74 69 6e 67 20 69 74 2c 20 3d 43 2d 75 20 43 2d 75 20 43 2d 53 50 41 .just.setting.it,.=C-u.C-u.C-SPA
2dfa0 43 45 3d 20 74 6f 20 75 6e 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 73 65 74 20 74 68 65 20 6d CE=.to.unconditionally.set.the.m
2dfc0 61 72 6b 29 2e 20 20 53 69 6e 63 65 0a 74 68 65 72 65 20 61 72 65 6e 27 74 20 6d 61 6e 79 20 73 ark)...Since.there.aren't.many.s
2dfe0 74 61 6e 64 61 72 64 73 20 66 6f 72 20 74 68 65 20 75 73 65 20 6f 66 20 70 72 65 66 69 78 20 6f tandards.for.the.use.of.prefix.o
2e000 70 74 69 6f 6e 73 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 0a 72 65 61 64 20 74 68 65 20 63 6f 6d ptions,.you.have.to.read.the.com
2e020 6d 61 6e 64 27 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 66 69 6e 64 20 6f 75 74 mand's.documentation.to.find.out
2e040 20 77 68 61 74 20 74 68 65 20 70 6f 73 73 69 62 69 6c 69 74 69 65 73 0a 61 72 65 2e 0a 0a 42 75 .what.the.possibilities.are...Bu
2e060 74 20 77 68 65 6e 20 61 6e 20 45 6d 61 63 73 20 63 6f 6d 6d 61 6e 64 20 67 72 6f 77 73 20 74 6f t.when.an.Emacs.command.grows.to
2e080 20 68 61 76 65 20 61 20 74 72 75 6c 79 20 6c 61 72 67 65 20 73 65 74 20 6f 66 20 6f 70 74 69 6f .have.a.truly.large.set.of.optio
2e0a0 6e 73 0a 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 2c 20 77 69 74 68 20 64 65 70 65 6e 64 65 6e 63 ns.and.arguments,.with.dependenc
2e0c0 69 65 73 20 62 65 74 77 65 65 6e 20 74 68 65 6d 2c 20 6c 6f 74 73 20 6f 66 20 6f 70 74 69 6f 6e ies.between.them,.lots.of.option
2e0e0 20 76 61 6c 75 65 73 2c 0a 65 74 63 2e 2c 20 74 68 65 73 65 20 73 69 6d 70 6c 65 20 61 70 70 72 .values,.etc.,.these.simple.appr
2e100 6f 61 63 68 65 73 20 6a 75 73 74 20 64 6f 6e 27 74 20 73 63 61 6c 65 2e 20 20 54 72 61 6e 73 69 oaches.just.don't.scale...Transi
2e120 65 6e 74 20 69 73 20 64 65 73 69 67 6e 65 64 0a 74 6f 20 73 6f 6c 76 65 20 74 68 69 73 20 69 73 ent.is.designed.to.solve.this.is
2e140 73 75 65 2e 20 20 54 68 69 6e 6b 20 6f 66 20 69 74 20 61 73 20 74 68 65 20 68 75 6d 62 6c 65 20 sue...Think.of.it.as.the.humble.
2e160 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 3d 43 2d 75 3d 2c 0a 2f 72 61 69 73 65 64 20 74 prefix.argument.=C-u=,./raised.t
2e180 6f 20 74 68 65 20 70 6f 77 65 72 20 6f 66 20 31 30 2f 2e 20 20 4c 69 6b 65 20 3d 43 2d 75 3d 2c o.the.power.of.10/...Like.=C-u=,
2e1a0 20 69 74 20 69 73 20 6b 65 79 20 64 72 69 76 65 6e 2e 20 20 4c 69 6b 65 20 74 68 65 0a 73 68 65 .it.is.key.driven...Like.the.she
2e1c0 6c 6c 2c 20 69 74 20 73 75 70 70 6f 72 74 73 20 62 6f 6f 6c 65 61 6e 20 22 66 6c 61 67 22 20 6f ll,.it.supports.boolean."flag".o
2e1e0 70 74 69 6f 6e 73 2c 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 61 6b 65 0a 61 72 67 75 6d 65 ptions,.options.that.take.argume
2e200 6e 74 73 2c 20 61 6e 64 20 65 76 65 6e 20 22 73 75 62 2d 63 6f 6d 6d 61 6e 64 73 22 2c 20 77 69 nts,.and.even."sub-commands",.wi
2e220 74 68 20 74 68 65 69 72 20 6f 77 6e 20 6f 70 74 69 6f 6e 73 2e 20 20 42 75 74 0a 69 6e 73 74 65 th.their.own.options...But.inste
2e240 61 64 20 6f 66 20 73 65 61 72 63 68 69 6e 67 20 74 68 72 6f 75 67 68 20 61 20 6d 61 6e 20 70 61 ad.of.searching.through.a.man.pa
2e260 67 65 20 6f 72 20 63 6f 6d 6d 61 6e 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 0a 77 65 6c ge.or.command.documentation,.wel
2e280 6c 2d 64 65 73 69 67 6e 65 64 20 74 72 61 6e 73 69 65 6e 74 73 20 2f 67 75 69 64 65 2f 20 74 68 l-designed.transients./guide/.th
2e2a0 65 69 72 20 75 73 65 72 73 20 74 6f 20 74 68 65 20 72 65 6c 65 76 61 6e 74 20 73 65 74 20 6f 66 eir.users.to.the.relevant.set.of
2e2c0 0a 6f 70 74 69 6f 6e 73 20 28 61 6e 64 20 65 76 65 6e 20 74 68 65 69 72 20 70 6f 73 73 69 62 6c .options.(and.even.their.possibl
2e2e0 65 20 76 61 6c 75 65 73 21 29 20 64 69 72 65 63 74 6c 79 2c 20 74 61 6b 69 6e 67 20 69 6e 74 6f e.values!).directly,.taking.into
2e300 0a 61 63 63 6f 75 6e 74 20 61 6e 79 20 69 6d 70 6f 72 74 61 6e 74 20 70 72 65 2d 65 78 69 73 74 .account.any.important.pre-exist
2e320 69 6e 67 20 45 6d 61 63 73 20 73 65 74 74 69 6e 67 73 2e 20 20 41 6e 64 20 77 68 69 6c 65 20 66 ing.Emacs.settings...And.while.f
2e340 6f 72 0a 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 3d 6c 73 3d 2c 20 74 68 65 or.shell.commands.like.=ls=,.the
2e360 72 65 20 69 73 20 6f 6e 6c 79 20 6f 6e 65 20 77 61 79 20 74 6f 20 22 65 78 65 63 75 74 65 22 20 re.is.only.one.way.to."execute".
2e380 28 68 69 74 0a 3d 52 65 74 75 72 6e 3d 21 29 2c 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 (hit.=Return=!),.transients.can.
2e3a0 22 65 78 65 63 75 74 65 22 20 75 73 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 64 69 66 66 65 72 65 "execute".using.multiple.differe
2e3c0 6e 74 20 6b 65 79 73 20 74 69 65 64 0a 74 6f 20 6f 6e 65 20 6f 66 20 6d 61 6e 79 20 73 65 6c 66 nt.keys.tied.to.one.of.many.self
2e3e0 2d 64 6f 63 75 6d 65 6e 74 69 6e 67 20 2f 61 63 74 69 6f 6e 73 2f 20 28 69 6d 61 67 69 6e 65 20 -documenting./actions/.(imagine.
2e400 68 61 76 69 6e 67 20 35 20 64 69 66 66 65 72 65 6e 74 0a 63 6f 6c 6f 72 65 64 20 72 65 74 75 72 having.5.different.colored.retur
2e420 6e 20 6b 65 79 73 20 6f 6e 20 79 6f 75 72 20 6b 65 79 62 6f 61 72 64 21 29 2e 20 20 54 72 61 6e n.keys.on.your.keyboard!)...Tran
2e440 73 69 65 6e 74 73 20 6d 61 6b 65 20 6e 61 76 69 67 61 74 69 6e 67 0a 61 6e 64 20 73 65 74 74 69 sients.make.navigating.and.setti
2e460 6e 67 20 6c 61 72 67 65 2c 20 63 6f 6d 70 6c 65 78 20 67 72 6f 75 70 73 20 6f 66 20 63 6f 6d 6d ng.large,.complex.groups.of.comm
2e480 61 6e 64 20 6f 70 74 69 6f 6e 73 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 0a 65 61 73 79 2e 20 and.options.and.arguments.easy..
2e4a0 20 46 75 6e 20 65 76 65 6e 2e 20 20 4f 6e 63 65 20 79 6f 75 27 76 65 20 74 72 69 65 64 20 69 74 .Fun.even...Once.you've.tried.it
2e4c0 2c 20 69 74 27 73 20 68 61 72 64 20 74 6f 20 67 6f 20 62 61 63 6b 20 74 6f 20 74 68 65 0a 3d 43 ,.it's.hard.to.go.back.to.the.=C
2e4e0 2d 75 20 77 68 61 74 20 63 61 6e 20 49 20 64 6f 20 68 65 72 65 20 61 67 61 69 6e 3f 3d 20 77 61 -u.what.can.I.do.here.again?=.wa
2e500 79 2e 0a 0a 2a 20 55 73 61 67 65 0a 2a 2a 20 49 6e 76 6f 6b 69 6e 67 20 54 72 61 6e 73 69 65 6e y...*.Usage.**.Invoking.Transien
2e520 74 73 0a 23 2b 63 69 6e 64 65 78 3a 20 69 6e 76 6f 6b 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 73 ts.#+cindex:.invoking.transients
2e540 0a 0a 41 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 ..A.transient.prefix.command.is.
2e560 69 6e 76 6f 6b 65 64 20 6c 69 6b 65 20 61 6e 79 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64 20 62 invoked.like.any.other.command.b
2e580 79 0a 70 72 65 73 73 69 6e 67 20 74 68 65 20 6b 65 79 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 y.pressing.the.key.that.is.bound
2e5a0 20 74 6f 20 74 68 61 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 65 20 6d 61 69 6e 20 64 69 66 66 .to.that.command...The.main.diff
2e5c0 65 72 65 6e 63 65 0a 74 6f 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64 73 20 69 73 20 74 68 61 74 erence.to.other.commands.is.that
2e5e0 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 63 74 69 .a.transient.prefix.command.acti
2e600 76 61 74 65 73 20 61 0a 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 2c 20 77 68 69 63 68 20 vates.a.transient.keymap,.which.
2e620 74 65 6d 70 6f 72 61 72 69 6c 79 20 62 69 6e 64 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 temporarily.binds.the.transient'
2e640 73 20 69 6e 66 69 78 20 61 6e 64 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 s.infix.and.suffix.commands,.and
2e660 20 74 68 61 74 20 74 68 6f 73 65 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 73 68 6f 77 6e 20 69 .that.those.bindings.are.shown.i
2e680 6e 20 6d 65 6e 75 20 62 75 66 66 65 72 2c 0a 77 68 69 63 68 20 69 73 20 64 69 73 70 6c 61 79 65 n.menu.buffer,.which.is.displaye
2e6a0 64 20 69 6e 20 61 20 6e 65 77 20 77 69 6e 64 6f 77 2c 20 75 6e 74 69 6c 20 74 68 65 20 6d 65 6e d.in.a.new.window,.until.the.men
2e6c0 75 20 69 73 20 65 78 69 74 65 64 2e 0a 42 69 6e 64 69 6e 67 73 20 66 72 6f 6d 20 6f 74 68 65 72 u.is.exited..Bindings.from.other
2e6e0 20 6b 65 79 6d 61 70 73 20 6d 61 79 2c 20 6f 72 20 6d 61 79 20 6e 6f 74 2c 20 62 65 20 64 69 73 .keymaps.may,.or.may.not,.be.dis
2e700 61 62 6c 65 64 20 77 68 69 6c 65 20 74 68 65 0a 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 abled.while.the.transient.state.
2e720 69 73 20 69 6e 20 65 66 66 65 63 74 2e 0a 0a 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 6b 69 6e is.in.effect...There.are.two.kin
2e740 64 73 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 72 65 20 61 76 61 69 6c 61 62 6c ds.of.commands.that.are.availabl
2e760 65 20 61 66 74 65 72 20 69 6e 76 6f 6b 69 6e 67 20 61 0a 74 72 61 6e 73 69 65 6e 74 20 70 72 65 e.after.invoking.a.transient.pre
2e780 66 69 78 20 63 6f 6d 6d 61 6e 64 3b 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f fix.command;.infix.and.suffix.co
2e7a0 6d 6d 61 6e 64 73 2e 20 20 49 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 73 65 74 20 73 6f 6d 65 mmands...Infix.commands.set.some
2e7c0 20 76 61 6c 75 65 20 28 77 68 69 63 68 20 69 73 20 74 68 65 6e 20 73 68 6f 77 6e 20 69 6e 20 74 .value.(which.is.then.shown.in.t
2e7e0 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 29 2c 20 77 69 74 68 6f 75 74 0a 6c 65 61 76 69 6e 67 he.menu.buffer),.without.leaving
2e800 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 53 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 .the.transient...Suffix.commands
2e820 2c 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c 20 75 73 75 61 6c 6c 79 0a 71 75 69 ,.on.the.other.hand,.usually.qui
2e840 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 61 6e 64 20 74 68 65 79 20 6d 61 79 20 75 73 65 t.the.transient.and.they.may.use
2e860 20 74 68 65 20 76 61 6c 75 65 73 20 73 65 74 20 62 79 20 74 68 65 20 69 6e 66 69 78 0a 63 6f 6d .the.values.set.by.the.infix.com
2e880 6d 61 6e 64 73 2c 20 69 2e 65 2e 2c 20 74 68 65 20 69 6e 66 69 78 20 2a 61 72 67 75 6d 65 6e 74 mands,.i.e.,.the.infix.*argument
2e8a0 73 2a 2e 0a 0a 49 6e 73 74 65 61 64 20 6f 66 20 73 65 74 74 69 6e 67 20 61 72 67 75 6d 65 6e 74 s*...Instead.of.setting.argument
2e8c0 73 20 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 s.to.be.used.by.a.suffix.command
2e8e0 2c 20 69 6e 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 20 6d 61 79 20 61 6c 73 6f 20 73 65 74 20 73 6f ,.infix.commands.may.also.set.so
2e900 6d 65 20 76 61 6c 75 65 20 62 79 20 73 69 64 65 2d 65 66 66 65 63 74 2c 20 65 2e 67 2e 2c 20 62 me.value.by.side-effect,.e.g.,.b
2e920 79 20 73 65 74 74 69 6e 67 20 74 68 65 0a 76 61 6c 75 65 20 6f 66 20 73 6f 6d 65 20 76 61 72 69 y.setting.the.value.of.some.vari
2e940 61 62 6c 65 2e 0a 0a 2a 2a 20 41 62 6f 72 74 69 6e 67 20 61 6e 64 20 52 65 73 75 6d 69 6e 67 20 able...**.Aborting.and.Resuming.
2e960 54 72 61 6e 73 69 65 6e 74 73 0a 23 2b 63 69 6e 64 65 78 3a 20 61 62 6f 72 74 69 6e 67 20 74 72 Transients.#+cindex:.aborting.tr
2e980 61 6e 73 69 65 6e 74 73 0a 23 2b 63 69 6e 64 65 78 3a 20 72 65 73 75 6d 69 6e 67 20 74 72 61 6e ansients.#+cindex:.resuming.tran
2e9a0 73 69 65 6e 74 73 0a 0a 23 2b 63 69 6e 64 65 78 3a 20 71 75 69 74 20 74 72 61 6e 73 69 65 6e 74 sients..#+cindex:.quit.transient
2e9c0 0a 54 6f 20 71 75 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 69 74 68 6f 75 74 20 69 .To.quit.the.transient.without.i
2e9e0 6e 76 6f 6b 69 6e 67 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 70 72 65 73 73 20 7b nvoking.a.suffix.command.press.{
2ea00 7b 7b 6b 62 64 28 43 2d 67 29 7d 7d 7d 2e 0a 0a 4b 65 79 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 {{kbd(C-g)}}}...Key.bindings.in.
2ea20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 73 20 6d 61 79 20 62 65 20 6c 6f 6e 67 65 72 20 transient.keymaps.may.be.longer.
2ea40 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20 65 76 65 6e 74 2e 0a 41 66 74 65 72 20 70 72 65 73 73 than.a.single.event..After.press
2ea60 69 6e 67 20 61 20 76 61 6c 69 64 20 70 72 65 66 69 78 20 6b 65 79 2c 20 61 6c 6c 20 63 6f 6d 6d ing.a.valid.prefix.key,.all.comm
2ea80 61 6e 64 73 20 77 68 6f 73 65 20 62 69 6e 64 69 6e 67 73 20 64 6f 20 6e 6f 74 0a 62 65 67 69 6e ands.whose.bindings.do.not.begin
2eaa0 20 77 69 74 68 20 74 68 61 74 20 70 72 65 66 69 78 20 6b 65 79 20 61 72 65 20 74 65 6d 70 6f 72 .with.that.prefix.key.are.tempor
2eac0 61 72 69 6c 79 20 75 6e 61 76 61 69 6c 61 62 6c 65 20 61 6e 64 20 67 72 61 79 65 64 20 6f 75 74 arily.unavailable.and.grayed.out
2eae0 2e 0a 54 6f 20 61 62 6f 72 74 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 70 72 65 73 73 20 ..To.abort.the.prefix.key.press.
2eb00 7b 7b 7b 6b 62 64 28 43 2d 67 29 7d 7d 7d 20 28 77 68 69 63 68 20 69 6e 20 74 68 69 73 20 63 61 {{{kbd(C-g)}}}.(which.in.this.ca
2eb20 73 65 20 6f 6e 6c 79 20 71 75 69 74 73 20 74 68 65 0a 70 72 65 66 69 78 20 6b 65 79 2c 20 62 75 se.only.quits.the.prefix.key,.bu
2eb40 74 20 6e 6f 74 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 72 61 6e 73 69 65 6e 74 29 2e 0a 0a t.not.the.complete.transient)...
2eb60 41 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 A.transient.prefix.command.can.b
2eb80 65 20 62 6f 75 6e 64 20 61 73 20 61 20 73 75 66 66 69 78 20 6f 66 20 61 6e 6f 74 68 65 72 0a 74 e.bound.as.a.suffix.of.another.t
2eba0 72 61 6e 73 69 65 6e 74 2e 20 20 49 6e 76 6f 6b 69 6e 67 20 73 75 63 68 20 61 20 73 75 66 66 69 ransient...Invoking.such.a.suffi
2ebc0 78 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 x.replaces.the.current.transient
2ebe0 0a 73 74 61 74 65 20 77 69 74 68 20 61 20 6e 65 77 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 .state.with.a.new.transient.stat
2ec00 65 2c 20 69 2e 65 2e 2c 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 62 69 6e 64 69 6e 67 73 20 e,.i.e.,.the.available.bindings.
2ec20 63 68 61 6e 67 65 0a 61 6e 64 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 64 69 73 70 6c change.and.the.information.displ
2ec40 61 79 65 64 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 75 70 64 61 74 ayed.in.the.menu.buffer.is.updat
2ec60 65 64 0a 61 63 63 6f 72 64 69 6e 67 6c 79 2e 20 20 50 72 65 73 73 69 6e 67 20 7b 7b 7b 6b 62 64 ed.accordingly...Pressing.{{{kbd
2ec80 28 43 2d 67 29 7d 7d 7d 20 77 68 69 6c 65 20 61 20 6e 65 73 74 65 64 20 74 72 61 6e 73 69 65 6e (C-g)}}}.while.a.nested.transien
2eca0 74 20 69 73 20 61 63 74 69 76 65 20 6f 6e 6c 79 0a 71 75 69 74 73 20 74 68 65 20 69 6e 6e 65 72 t.is.active.only.quits.the.inner
2ecc0 6d 6f 73 74 20 74 72 61 6e 73 69 65 6e 74 2c 20 63 61 75 73 69 6e 67 20 61 20 72 65 74 75 72 6e most.transient,.causing.a.return
2ece0 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 0a 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 7b 7b 7b .to.the.previous.transient...{{{
2ed00 6b 62 64 28 43 2d 71 29 7d 7d 7d 20 6f 72 20 7b 7b 7b 6b 62 64 28 43 2d 7a 29 7d 7d 7d 20 6f 6e kbd(C-q)}}}.or.{{{kbd(C-z)}}}.on
2ed20 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 20 61 6c 77 61 79 73 20 65 78 69 74 73 20 61 6c 6c .the.other.hand.always.exits.all
2ed40 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 49 66 20 79 6f 75 20 75 73 65 0a 74 68 65 20 6c 61 74 .transients...If.you.use.the.lat
2ed60 74 65 72 2c 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 6c 61 74 65 72 20 72 65 73 75 6d 65 20 74 ter,.then.you.can.later.resume.t
2ed80 68 65 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 75 73 69 6e 67 0a 7b 7b 7b he.stack.of.transients.using.{{{
2eda0 6b 62 64 28 4d 2d 78 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 29 7d 7d 7d 2e 0a 0a 23 kbd(M-x.transient-resume)}}}...#
2edc0 2b 61 74 74 72 5f 74 65 78 69 6e 66 6f 3a 20 3a 63 6f 6d 70 61 63 74 20 74 0a 2d 20 4b 65 79 3a +attr_texinfo:.:compact.t.-.Key:
2ede0 20 43 2d 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 73 65 71 29 20 3a 3a 0a 2d 20 4b .C-g.(transient-quit-seq).::.-.K
2ee00 65 79 3a 20 43 2d 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e 65 29 20 3a 3a 0a ey:.C-g.(transient-quit-one).::.
2ee20 0a 20 20 54 68 69 73 20 6b 65 79 20 71 75 69 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 ...This.key.quits.the.currently.
2ee40 61 63 74 69 76 65 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 73 65 71 75 65 6e 63 65 2c 20 active.incomplete.key.sequence,.
2ee60 69 66 20 61 6e 79 2c 0a 20 20 6f 72 20 65 6c 73 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 if.any,...or.else.the.current.tr
2ee80 61 6e 73 69 65 6e 74 2e 20 20 57 68 65 6e 20 71 75 69 74 74 69 6e 67 20 74 68 65 20 63 75 72 72 ansient...When.quitting.the.curr
2eea0 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 2c 0a 20 20 69 74 20 72 65 74 75 72 6e 73 20 74 6f 20 74 ent.transient,...it.returns.to.t
2eec0 68 65 20 70 72 65 76 69 6f 75 73 20 74 72 61 6e 73 69 65 6e 74 2c 20 69 66 20 61 6e 79 2e 0a 0a he.previous.transient,.if.any...
2eee0 54 72 61 6e 73 69 65 6e 74 27 73 20 70 72 65 64 65 63 65 73 73 6f 72 20 62 6f 75 6e 64 20 7b 7b Transient's.predecessor.bound.{{
2ef00 7b 6b 62 64 28 71 29 7d 7d 7d 20 69 6e 73 74 65 61 64 20 6f 66 20 7b 7b 7b 6b 62 64 28 43 2d 67 {kbd(q)}}}.instead.of.{{{kbd(C-g
2ef20 29 7d 7d 7d 20 74 6f 20 74 68 65 20 71 75 69 74 20 63 6f 6d 6d 61 6e 64 2e 0a 54 6f 20 6c 65 61 )}}}.to.the.quit.command..To.lea
2ef40 72 6e 20 68 6f 77 20 74 6f 20 67 65 74 20 74 68 61 74 20 62 69 6e 64 69 6e 67 20 62 61 63 6b 20 rn.how.to.get.that.binding.back.
2ef60 73 65 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d 71 2d 74 6f 2d 71 75 69 74 7e 27 73 see.~transient-bind-q-to-quit~'s
2ef80 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 2e 0a 0a 2d 20 4b 65 79 3a 20 43 .documentation.string...-.Key:.C
2efa0 2d 71 20 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 29 20 3a 3a 0a 0a 20 20 54 68 -q.(transient-quit-all).::....Th
2efc0 69 73 20 63 6f 6d 6d 61 6e 64 20 71 75 69 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 61 is.command.quits.the.currently.a
2efe0 63 74 69 76 65 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 73 65 71 75 65 6e 63 65 2c 20 69 ctive.incomplete.key.sequence,.i
2f000 66 0a 20 20 61 6e 79 2c 20 61 6e 64 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2c 20 69 6e 63 f...any,.and.all.transients,.inc
2f020 6c 75 64 69 6e 67 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 61 6e 64 20 luding.the.active.transient.and.
2f040 61 6c 6c 0a 20 20 73 75 73 70 65 6e 64 65 64 20 74 72 61 6e 73 69 65 6e 74 73 2c 20 69 66 20 61 all...suspended.transients,.if.a
2f060 6e 79 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 7a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 73 70 65 ny...-.Key:.C-z.(transient-suspe
2f080 6e 64 29 20 3a 3a 0a 0a 20 20 4c 69 6b 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 nd).::....Like.~transient-quit-a
2f0a0 6c 6c 7e 2c 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 71 75 69 74 73 20 61 6e 20 69 6e 63 6f 6d ll~,.this.command.quits.an.incom
2f0c0 70 6c 65 74 65 20 6b 65 79 0a 20 20 73 65 71 75 65 6e 63 65 2c 20 69 66 20 61 6e 79 2c 20 61 6e plete.key...sequence,.if.any,.an
2f0e0 64 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c d.all.transients...Additionally,
2f100 20 69 74 20 73 61 76 65 73 20 74 68 65 0a 20 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 .it.saves.the...stack.of.transie
2f120 6e 74 73 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 65 61 73 69 6c 79 20 62 65 20 72 65 73 nts.so.that.it.can.easily.be.res
2f140 75 6d 65 64 20 28 77 68 69 63 68 20 69 73 0a 20 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 75 73 umed.(which.is...particularly.us
2f160 65 66 75 6c 20 69 66 20 79 6f 75 20 71 75 69 63 6b 6c 79 20 6e 65 65 64 20 74 6f 20 64 6f 20 e2 eful.if.you.quickly.need.to.do..
2f180 80 9c 73 6f 6d 65 74 68 69 6e 67 20 65 6c 73 65 e2 80 9d 20 61 6e 64 0a 20 20 74 68 65 20 73 74 ..something.else....and...the.st
2f1a0 61 63 6b 20 69 73 20 64 65 65 70 65 72 20 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20 74 72 61 6e ack.is.deeper.than.a.single.tran
2f1c0 73 69 65 6e 74 2c 20 61 6e 64 2f 6f 72 20 79 6f 75 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 sient,.and/or.you.have.already..
2f1e0 20 63 68 61 6e 67 65 64 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 6f 6d 65 20 69 6e 66 69 .changed.the.values.of.some.infi
2f200 78 20 61 72 67 75 6d 65 6e 74 73 29 2e 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 20 6f 6e 6c 79 20 x.arguments).....Note.that.only.
2f220 61 20 73 69 6e 67 6c 65 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e a.single.stack.of.transients.can
2f240 20 62 65 20 73 61 76 65 64 20 61 74 20 61 20 74 69 6d 65 2e 0a 20 20 49 66 20 61 6e 6f 74 68 65 .be.saved.at.a.time....If.anothe
2f260 72 20 73 74 61 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 73 61 76 65 64 2c 20 74 68 65 6e 20 73 r.stack.is.already.saved,.then.s
2f280 61 76 69 6e 67 20 61 20 6e 65 77 20 73 74 61 63 6b 20 64 69 73 63 61 72 64 73 0a 20 20 74 68 65 aving.a.new.stack.discards...the
2f2a0 20 70 72 65 76 69 6f 75 73 20 73 74 61 63 6b 2e 0a 0a 2d 20 4b 65 79 3a 20 4d 2d 78 20 74 72 61 .previous.stack...-.Key:.M-x.tra
2f2c0 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 nsient-resume.::....This.command
2f2e0 20 72 65 73 75 6d 65 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 73 75 73 70 65 6e 64 65 .resumes.the.previously.suspende
2f300 64 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 2c 0a 20 20 69 66 20 61 6e 79 2e d.stack.of.transients,...if.any.
2f320 0a 0a 2a 2a 20 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 23 2b 63 69 ..**.Common.Suffix.Commands.#+ci
2f340 6e 64 65 78 3a 20 63 6f 6d 6d 6f 6e 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 0a 41 20 ndex:.common.suffix.commands..A.
2f360 66 65 77 20 73 68 61 72 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 few.shared.suffix.commands.are.a
2f380 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 54 68 65 vailable.in.all.transients...The
2f3a0 73 65 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 74 20 73 68 6f 77 6e se.suffix.commands.are.not.shown
2f3c0 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 69 6e 20 65 76 65 72 79 20 6d 65 6e 75 20 62 79 20 64 65 .permanently.in.every.menu.by.de
2f3e0 66 61 75 6c 74 2e 0a 4d 6f 73 74 20 6f 66 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 73 68 fault..Most.of.these.commands.sh
2f400 61 72 65 20 61 20 63 6f 6d 6d 6f 6e 20 70 72 65 66 69 78 20 6b 65 79 20 61 6e 64 20 70 72 65 73 are.a.common.prefix.key.and.pres
2f420 73 69 6e 67 20 74 68 61 74 20 6b 65 79 0a 63 61 75 73 65 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 sing.that.key.causes.the.common.
2f440 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 62 65 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 6e commands.to.be.temporarily.shown
2f460 20 69 6e 20 74 68 65 20 61 63 74 69 76 65 20 6d 65 6e 75 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 .in.the.active.menu...-.User.Opt
2f480 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 ion:.transient-show-common-comma
2f4a0 6e 64 73 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 nds.::....This.option.controls.w
2f4c0 68 65 74 68 65 72 20 73 68 61 72 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 hether.shared.suffix.commands.ar
2f4e0 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 0a 20 20 73 68 6f 77 6e 20 61 6c 6f 6e 67 73 69 64 65 20 e.permanently...shown.alongside.
2f500 74 68 65 20 6d 65 6e 75 2d 73 70 65 63 69 66 69 63 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 the.menu-specific.infix.and.suff
2f520 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 42 79 0a 20 20 64 65 66 61 75 6c 74 2c 20 74 68 65 20 ix.commands...By...default,.the.
2f540 73 68 61 72 65 64 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 74 20 70 65 72 6d 61 6e 65 6e shared.commands.are.not.permanen
2f560 74 6c 79 20 73 68 6f 77 6e 20 74 6f 20 61 76 6f 69 64 0a 20 20 77 61 73 74 69 6e 67 20 70 72 65 tly.shown.to.avoid...wasting.pre
2f580 63 69 6f 75 73 20 73 70 61 63 65 20 61 6e 64 20 6f 76 65 72 77 68 65 6c 6d 69 6e 67 20 74 68 65 cious.space.and.overwhelming.the
2f5a0 20 75 73 65 72 20 77 69 74 68 20 74 6f 6f 20 6d 61 6e 79 0a 20 20 63 68 6f 69 63 65 73 2e 0a 0a .user.with.too.many...choices...
2f5c0 20 20 49 66 20 79 6f 75 20 70 72 65 66 65 72 20 74 6f 20 61 6c 77 61 79 73 20 73 65 65 20 74 68 ..If.you.prefer.to.always.see.th
2f5e0 65 73 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 65 6e 20 73 65 74 20 74 68 69 73 20 6f 70 74 69 ese.commands,.then.set.this.opti
2f600 6f 6e 20 74 6f 0a 20 20 61 20 6e 6f 6e 2d 7e 6e 69 6c 7e 20 76 61 6c 75 65 2e 20 20 41 6c 74 65 on.to...a.non-~nil~.value...Alte
2f620 72 6e 61 74 69 76 65 6c 79 20 74 68 65 20 76 61 6c 75 65 20 63 61 6e 20 62 65 20 74 6f 67 67 6c rnatively.the.value.can.be.toggl
2f640 65 64 20 66 6f 72 20 74 68 65 0a 20 20 63 75 72 72 65 6e 74 20 45 6d 61 63 73 20 73 65 73 73 69 ed.for.the...current.Emacs.sessi
2f660 6f 6e 20 6f 6e 6c 79 2c 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 on.only,.using.~transient-toggle
2f680 2d 63 6f 6d 6d 6f 6e 7e 2c 20 64 65 73 63 72 69 62 65 64 0a 20 20 62 65 6c 6f 77 2e 0a 0a 2d 20 -common~,.described...below...-.
2f6a0 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f User.Option:.transient-common-co
2f6c0 6d 6d 61 6e 64 2d 70 72 65 66 69 78 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 mmand-prefix.::....This.option.s
2f6e0 70 65 63 69 66 69 65 73 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 20 69 6e 20 pecifies.the.prefix.key.used.in.
2f700 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 73 0a 20 20 74 6f 20 69 6e 76 6f 6b 65 20 all.transient.menus...to.invoke.
2f720 6d 6f 73 74 20 6f 66 20 74 68 65 20 73 68 61 72 65 64 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 most.of.the.shared.commands,.whi
2f740 63 68 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 0a 20 20 74 72 61 6e 73 69 ch.are.available.in.all...transi
2f760 65 6e 74 20 6d 65 6e 75 73 2e 20 20 42 79 20 64 65 66 61 75 6c 74 20 74 68 65 73 65 20 62 69 6e ent.menus...By.default.these.bin
2f780 64 69 6e 67 73 20 61 72 65 20 6f 6e 6c 79 20 73 68 6f 77 6e 20 61 66 74 65 72 0a 20 20 70 72 65 dings.are.only.shown.after...pre
2f7a0 73 73 69 6e 67 20 74 68 61 74 20 70 72 65 66 69 78 20 6b 65 79 20 61 6e 64 20 62 65 66 6f 72 65 ssing.that.prefix.key.and.before
2f7c0 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 61 74 20 75 70 20 77 69 74 68 20 61 20 76 61 6c 69 64 0a .following.that.up.with.a.valid.
2f7e0 20 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 28 62 75 74 20 73 65 65 20 74 68 65 20 70 72 65 76 69 ..key.binding.(but.see.the.previ
2f800 6f 75 73 20 6f 70 74 69 6f 6e 29 2e 0a 0a 20 20 46 6f 72 20 68 69 73 74 6f 72 69 63 20 72 65 61 ous.option).....For.historic.rea
2f820 73 6f 6e 73 20 7b 7b 7b 6b 62 64 28 43 2d 78 29 7d 7d 7d 20 69 73 20 75 73 65 64 20 62 79 20 64 sons.{{{kbd(C-x)}}}.is.used.by.d
2f840 65 66 61 75 6c 74 2c 20 62 75 74 20 75 73 65 72 73 20 61 72 65 0a 20 20 65 6e 63 6f 75 72 61 67 efault,.but.users.are...encourag
2f860 65 64 20 74 6f 20 70 69 63 6b 20 61 6e 6f 74 68 65 72 20 6b 65 79 2c 20 70 72 65 66 65 72 61 62 ed.to.pick.another.key,.preferab
2f880 6c 79 20 6f 6e 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 63 6f 6d 6d 6f 6e 6c 79 0a 20 20 75 73 ly.one.that.is.not.commonly...us
2f8a0 65 64 20 69 6e 20 45 6d 61 63 73 20 62 75 74 20 69 73 20 73 74 69 6c 6c 20 63 6f 6e 76 65 6e 69 ed.in.Emacs.but.is.still.conveni
2f8c0 65 6e 74 20 74 6f 20 74 68 65 6d 2e 0a 0a 20 20 55 73 75 61 6c 6c 79 2c 20 77 68 69 6c 65 20 61 ent.to.them.....Usually,.while.a
2f8e0 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 61 63 74 69 76 65 2c 20 74 68 65 20 75 .transient.menu.is.active,.the.u
2f900 73 65 72 20 63 61 6e 6e 6f 74 20 69 6e 76 6f 6b 65 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 ser.cannot.invoke...commands.tha
2f920 74 20 61 72 65 20 6e 6f 74 20 62 6f 75 6e 64 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 69 74 73 65 t.are.not.bound.in.the.menu.itse
2f940 6c 66 2e 20 20 46 6f 72 20 74 68 6f 73 65 20 6d 65 6e 75 73 20 69 74 0a 20 20 64 6f 65 73 20 6e lf...For.those.menus.it...does.n
2f960 6f 74 20 6d 61 74 74 65 72 2c 20 69 66 20 7b 7b 7b 6b 62 64 28 43 2d 78 29 7d 7d 7d 20 6f 72 20 ot.matter,.if.{{{kbd(C-x)}}}.or.
2f980 61 6e 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e 6c 79 20 75 73 65 64 20 70 72 65 66 69 78 20 6b 65 79 another.commonly.used.prefix.key
2f9a0 20 69 73 20 75 73 65 64 0a 20 20 66 6f 72 20 63 6f 6d 6d 6f 6e 20 6d 65 6e 75 20 63 6f 6d 6d 61 .is.used...for.common.menu.comma
2f9c0 6e 64 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 63 65 72 74 61 69 6e 20 6f 74 68 65 72 2c 20 6e 65 nds...However,.certain.other,.ne
2f9e0 77 65 72 20 6d 65 6e 75 73 20 64 6f 0a 20 20 6e 6f 74 20 73 75 70 70 72 65 73 73 20 6b 65 79 20 wer.menus.do...not.suppress.key.
2fa00 62 69 6e 64 69 6e 67 73 20 65 73 74 61 62 6c 69 73 68 65 64 20 6f 75 74 73 69 64 65 20 74 68 65 bindings.established.outside.the
2fa20 20 6d 65 6e 75 20 69 74 73 65 6c 66 2c 20 61 6e 64 0a 20 20 69 6e 20 74 68 6f 73 65 20 63 61 73 .menu.itself,.and...in.those.cas
2fa40 65 73 20 61 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 61 20 63 6f 6d 6d 6f 6e 20 6d 65 6e 75 20 63 es.a.binding.for.a.common.menu.c
2fa60 6f 6d 6d 61 6e 64 20 63 6f 75 6c 64 20 73 68 61 64 6f 77 20 61 6e 0a 20 20 65 78 74 65 72 6e 61 ommand.could.shadow.an...externa
2fa80 6c 20 62 69 6e 64 69 6e 67 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 7b 7b 7b 6b 62 64 28 l.binding...For.example,.{{{kbd(
2faa0 43 2d 78 20 43 2d 73 29 7d 7d 7d 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 75 73 65 64 20 74 6f C-x.C-s)}}}.could.not.be.used.to
2fac0 20 69 6e 76 6f 6b 65 0a 20 20 7e 73 61 76 65 2d 62 75 66 66 65 72 7e 2c 20 69 66 20 74 68 61 74 .invoke...~save-buffer~,.if.that
2fae0 20 62 69 6e 64 69 6e 67 20 69 73 20 73 68 61 64 6f 77 65 64 20 62 79 20 74 68 65 20 6d 65 6e 75 .binding.is.shadowed.by.the.menu
2fb00 20 62 69 6e 64 69 6e 67 20 66 6f 72 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 7e 2e .binding.for...~transient-save~.
2fb20 0a 0a 20 20 57 68 69 63 68 20 6b 65 79 20 69 73 20 6d 6f 73 74 20 73 75 69 74 61 62 6c 65 20 64 ....Which.key.is.most.suitable.d
2fb40 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 75 73 65 72 27 73 20 70 72 65 66 65 72 65 6e 63 65 73 epends.on.the.user's.preferences
2fb60 2c 20 62 75 74 0a 20 20 67 6f 6f 64 20 63 68 6f 69 63 65 73 20 6d 61 79 20 69 6e 63 6c 75 64 65 ,.but...good.choices.may.include
2fb80 20 66 75 6e 63 74 69 6f 6e 20 6b 65 79 73 20 61 6e 64 20 7b 7b 7b 6b 62 64 28 43 2d 7a 29 7d 7d .function.keys.and.{{{kbd(C-z)}}
2fba0 7d 20 28 66 6f 72 20 6d 61 6e 79 20 6b 65 79 62 6f 61 72 64 0a 20 20 6c 61 79 6f 75 74 73 20 7b }.(for.many.keyboard...layouts.{
2fbc0 7b 7b 6b 62 64 28 7a 29 7d 7d 7d 20 69 73 20 72 69 67 68 74 20 6e 65 78 74 20 74 6f 20 7b 7b 7b {{kbd(z)}}}.is.right.next.to.{{{
2fbe0 6b 62 64 28 78 29 7d 7d 7d 2c 20 61 6e 64 20 69 6e 76 6f 6b 69 6e 67 20 7e 73 75 73 70 65 6e 64 kbd(x)}}},.and.invoking.~suspend
2fc00 2d 66 72 61 6d 65 7e 2c 20 77 68 69 6c 65 20 61 0a 20 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e -frame~,.while.a...transient.men
2fc20 75 20 69 73 20 61 63 74 69 76 65 2c 20 77 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 20 67 6f 6f 64 u.is.active,.would.not.be.a.good
2fc40 20 69 64 65 61 20 61 6e 79 77 61 79 29 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 78 20 74 20 28 74 72 .idea.anyway)...-.Key:.C-x.t.(tr
2fc60 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 29 20 3a 3a 0a 0a 20 20 54 68 69 ansient-toggle-common).::....Thi
2fc80 73 20 63 6f 6d 6d 61 6e 64 20 74 6f 67 67 6c 65 73 20 77 68 65 74 68 65 72 20 74 68 65 20 67 65 s.command.toggles.whether.the.ge
2fca0 6e 65 72 69 63 20 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 61 74 20 61 72 65 20 63 6f 6d 6d 6f 6e 0a neric.commands,.that.are.common.
2fcc0 20 20 74 6f 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2c 20 61 72 65 20 70 65 72 6d 61 6e 65 ..to.all.transients,.are.permane
2fce0 6e 74 6c 79 20 64 69 73 70 6c 61 79 65 64 20 6f 72 20 6f 6e 6c 79 20 61 66 74 65 72 20 74 79 70 ntly.displayed.or.only.after.typ
2fd00 69 6e 67 0a 20 20 74 68 65 20 69 6e 63 6f 6d 70 6c 65 74 65 20 70 72 65 66 69 78 20 6b 65 79 20 ing...the.incomplete.prefix.key.
2fd20 73 65 71 75 65 6e 63 65 7b 7b 7b 6b 62 64 28 29 7d 7d 7d 2e 20 20 54 68 69 73 20 6f 6e 6c 79 20 sequence{{{kbd()}}}...This.only.
2fd40 61 66 66 65 63 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 45 6d 61 63 73 20 73 65 73 73 affects.the.current...Emacs.sess
2fd60 69 6f 6e 2e 0a 0a 54 68 65 20 6f 74 68 65 72 20 63 6f 6d 6d 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 ion...The.other.common.commands.
2fd80 61 72 65 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 65 69 74 68 65 72 20 74 68 65 20 70 72 65 76 are.described.in.either.the.prev
2fda0 69 6f 75 73 20 6f 72 20 69 6e 0a 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 ious.or.in.one.of.the.following.
2fdc0 73 65 63 74 69 6f 6e 73 2e 0a 0a 2a 2a 20 53 61 76 69 6e 67 20 56 61 6c 75 65 73 0a 23 2b 63 69 sections...**.Saving.Values.#+ci
2fde0 6e 64 65 78 3a 20 73 61 76 69 6e 67 20 76 61 6c 75 65 73 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 ndex:.saving.values.of.arguments
2fe00 0a 0a 41 66 74 65 72 20 73 65 74 74 69 6e 67 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 ..After.setting.the.infix.argume
2fe20 6e 74 73 20 69 6e 20 61 20 74 72 61 6e 73 69 65 6e 74 2c 20 74 68 65 20 75 73 65 72 20 63 61 6e nts.in.a.transient,.the.user.can
2fe40 20 73 61 76 65 0a 74 68 6f 73 65 20 61 72 67 75 6d 65 6e 74 73 20 66 6f 72 20 66 75 74 75 72 65 .save.those.arguments.for.future
2fe60 20 69 6e 76 6f 63 61 74 69 6f 6e 73 2e 0a 0a 4d 6f 73 74 20 74 72 61 6e 73 69 65 6e 74 73 20 77 .invocations...Most.transients.w
2fe80 69 6c 6c 20 73 74 61 72 74 20 6f 75 74 20 77 69 74 68 20 74 68 65 20 73 61 76 65 64 20 61 72 67 ill.start.out.with.the.saved.arg
2fea0 75 6d 65 6e 74 73 20 77 68 65 6e 20 74 68 65 79 20 61 72 65 0a 69 6e 76 6f 6b 65 64 2e 20 20 54 uments.when.they.are.invoked...T
2fec0 68 65 72 65 20 61 72 65 20 61 20 66 65 77 20 65 78 63 65 70 74 69 6f 6e 73 2c 20 74 68 6f 75 67 here.are.a.few.exceptions,.thoug
2fee0 68 2e 20 20 53 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 20 61 72 65 0a 64 65 73 69 67 6e 65 64 h...Some.transients.are.designed
2ff00 20 73 6f 20 74 68 61 74 20 74 68 65 20 76 61 6c 75 65 20 74 68 61 74 20 74 68 65 79 20 75 73 65 .so.that.the.value.that.they.use
2ff20 20 69 73 20 73 74 6f 72 65 64 20 65 78 74 65 72 6e 61 6c 6c 79 20 61 73 20 74 68 65 0a 62 75 66 .is.stored.externally.as.the.buf
2ff40 66 65 72 2d 6c 6f 63 61 6c 20 76 61 6c 75 65 20 6f 66 20 73 6f 6d 65 20 76 61 72 69 61 62 6c 65 fer-local.value.of.some.variable
2ff60 2e 20 20 49 6e 76 6f 6b 69 6e 67 20 73 75 63 68 20 61 20 74 72 61 6e 73 69 65 6e 74 20 61 67 61 ...Invoking.such.a.transient.aga
2ff80 69 6e 0a 75 73 65 73 20 74 68 65 20 62 75 66 66 65 72 2d 6c 6f 63 61 6c 20 76 61 6c 75 65 2e 20 in.uses.the.buffer-local.value..
2ffa0 5b 66 6e 3a 31 5d 0a 0a 49 66 20 74 68 65 20 75 73 65 72 20 64 6f 65 73 20 6e 6f 74 20 73 61 76 [fn:1]..If.the.user.does.not.sav
2ffc0 65 20 74 68 65 20 76 61 6c 75 65 20 61 6e 64 20 6a 75 73 74 20 65 78 69 74 73 20 75 73 69 6e 67 e.the.value.and.just.exits.using
2ffe0 20 61 20 72 65 67 75 6c 61 72 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 6e 20 .a.regular.suffix.command,.then.
30000 74 68 65 20 76 61 6c 75 65 20 69 73 20 6d 65 72 65 6c 79 20 73 61 76 65 64 20 74 6f 20 74 68 65 the.value.is.merely.saved.to.the
30020 20 74 72 61 6e 73 69 65 6e 74 27 73 0a 68 69 73 74 6f 72 79 2e 20 20 54 68 61 74 20 76 61 6c 75 .transient's.history...That.valu
30040 65 20 77 6f 6e 27 74 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 e.won't.be.used.when.the.transie
30060 6e 74 20 69 73 20 6e 65 78 74 20 69 6e 76 6f 6b 65 64 2c 0a 62 75 74 20 69 74 20 69 73 20 65 61 nt.is.next.invoked,.but.it.is.ea
30080 73 69 6c 79 20 61 63 63 65 73 73 69 62 6c 65 20 28 73 65 65 20 5b 5b 2a 55 73 69 6e 67 20 48 69 sily.accessible.(see.[[*Using.Hi
300a0 73 74 6f 72 79 5d 5d 29 2e 0a 0a 4f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d story]])...Option.~transient-com
300c0 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 7e 20 63 6f 6e 74 72 6f 6c 73 20 74 68 65 mon-command-prefix~.controls.the
300e0 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 0a 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e .prefix.key.used.in.the.followin
30100 67 20 62 69 6e 64 69 6e 67 73 2e 20 20 46 6f 72 20 73 69 6d 70 6c 69 63 69 74 79 27 73 20 73 61 g.bindings...For.simplicity's.sa
30120 6b 65 20 74 68 65 20 64 65 66 61 75 6c 74 2c 20 7b 7b 7b 6b 62 64 28 43 2d 78 29 7d 7d 7d 2c 0a ke.the.default,.{{{kbd(C-x)}}},.
30140 69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 78 20 73 20 28 74 is.shown.below...-.Key:.C-x.s.(t
30160 72 61 6e 73 69 65 6e 74 2d 73 65 74 29 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 ransient-set).::....This.command
30180 20 73 61 76 65 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 20 74 .saves.the.value.of.the.active.t
301a0 72 61 6e 73 69 65 6e 74 20 66 6f 72 20 74 68 69 73 20 45 6d 61 63 73 0a 20 20 73 65 73 73 69 6f ransient.for.this.Emacs...sessio
301c0 6e 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 78 20 43 2d 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 61 n...-.Key:.C-x.C-s.(transient-sa
301e0 76 65 29 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 73 61 76 65 73 20 74 68 65 ve).::....This.command.saves.the
30200 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 70 .value.of.the.active.transient.p
30220 65 72 73 69 73 74 65 6e 74 6c 79 0a 20 20 61 63 72 6f 73 73 20 45 6d 61 63 73 20 73 65 73 73 69 ersistently...across.Emacs.sessi
30240 6f 6e 73 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 78 20 43 2d 6b 20 28 74 72 61 6e 73 69 65 6e 74 2d ons...-.Key:.C-x.C-k.(transient-
30260 72 65 73 65 74 29 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 63 6c 65 61 72 73 reset).::....This.command.clears
30280 20 74 68 65 20 73 65 74 20 61 6e 64 20 73 61 76 65 64 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 .the.set.and.saved.values.of.the
302a0 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f .active.transient...-.User.Optio
302c0 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 73 2d 66 69 6c 65 20 3a 3a 0a 0a 20 20 54 n:.transient-values-file.::....T
302e0 68 69 73 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 73 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 69 his.option.names.the.file.that.i
30300 73 20 75 73 65 64 20 74 6f 20 70 65 72 73 69 73 74 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 0a s.used.to.persist.the.values.of.
30320 20 20 74 72 61 6e 73 69 65 6e 74 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 20 73 65 73 73 69 ..transients.between.Emacs.sessi
30340 6f 6e 73 2e 0a 0a 5b 66 6e 3a 31 5d 20 7e 6d 61 67 69 74 2d 64 69 66 66 7e 20 61 6e 64 20 7e 6d ons...[fn:1].~magit-diff~.and.~m
30360 61 67 69 74 2d 6c 6f 67 7e 20 61 72 65 20 74 77 6f 20 70 72 6f 6d 69 6e 65 6e 74 20 65 78 61 6d agit-log~.are.two.prominent.exam
30380 70 6c 65 73 2c 20 61 6e 64 20 74 68 65 69 72 0a 68 61 6e 64 6c 69 6e 67 20 6f 66 20 62 75 66 66 ples,.and.their.handling.of.buff
303a0 65 72 2d 6c 6f 63 61 6c 20 76 61 6c 75 65 73 20 69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 62 69 er-local.values.is.actually.a.bi
303c0 74 20 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 0a 74 68 61 6e 20 6f 75 74 6c 69 6e 65 64 t.more.complicated.than.outlined
303e0 20 61 62 6f 76 65 20 61 6e 64 20 65 76 65 6e 20 63 75 73 74 6f 6d 69 7a 61 62 6c 65 2e 0a 0a 2a .above.and.even.customizable...*
30400 2a 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 0a 23 2b 63 69 6e 64 65 78 3a 20 76 61 6c 75 65 20 *.Using.History.#+cindex:.value.
30420 68 69 73 74 6f 72 79 0a 0a 45 76 65 72 79 20 74 69 6d 65 20 74 68 65 20 75 73 65 72 20 69 6e 76 history..Every.time.the.user.inv
30440 6f 6b 65 73 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 65 20 74 72 61 6e 73 69 okes.a.suffix.command.the.transi
30460 65 6e 74 27 73 20 63 75 72 72 65 6e 74 0a 76 61 6c 75 65 20 69 73 20 73 61 76 65 64 20 74 6f 20 ent's.current.value.is.saved.to.
30480 69 74 73 20 68 69 73 74 6f 72 79 2e 20 20 54 68 65 73 65 20 76 61 6c 75 65 73 20 63 61 6e 20 62 its.history...These.values.can.b
304a0 65 20 63 79 63 6c 65 64 20 74 68 72 6f 75 67 68 2c 0a 74 68 65 20 73 61 6d 65 20 77 61 79 20 6f e.cycled.through,.the.same.way.o
304c0 6e 65 20 63 61 6e 20 63 79 63 6c 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 68 69 73 74 6f 72 79 ne.can.cycle.through.the.history
304e0 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 65 61 64 0a 75 73 65 72 2d 69 6e 70 75 .of.commands.that.read.user-inpu
30500 74 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 4f 70 74 69 6f 6e 20 7e 74 72 t.in.the.minibuffer...Option.~tr
30520 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 7e 20 63 ansient-common-command-prefix~.c
30540 6f 6e 74 72 6f 6c 73 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 0a 69 6e 20 74 ontrols.the.prefix.key.used.in.t
30560 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e 64 69 6e 67 73 2e 20 20 46 6f 72 20 73 69 6d 70 he.following.bindings...For.simp
30580 6c 69 63 69 74 79 27 73 20 73 61 6b 65 20 74 68 65 20 64 65 66 61 75 6c 74 2c 20 7b 7b 7b 6b 62 licity's.sake.the.default,.{{{kb
305a0 64 28 43 2d 78 29 7d 7d 7d 2c 0a 69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2e 0a 0a 23 2b 61 74 d(C-x)}}},.is.shown.below...#+at
305c0 74 72 5f 74 65 78 69 6e 66 6f 3a 20 3a 63 6f 6d 70 61 63 74 20 74 0a 2d 20 4b 65 79 3a 20 43 2d tr_texinfo:.:compact.t.-.Key:.C-
305e0 4d 2d 70 20 28 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 76 29 20 3a 3a 0a M-p.(transient-history-prev).::.
30600 2d 20 4b 65 79 3a 20 43 2d 78 20 70 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 -.Key:.C-x.p.::....This.command.
30620 73 77 69 74 63 68 65 73 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 20 75 switches.to.the.previous.value.u
30640 73 65 64 20 66 6f 72 20 74 68 65 20 61 63 74 69 76 65 0a 20 20 74 72 61 6e 73 69 65 6e 74 2e 0a sed.for.the.active...transient..
30660 0a 2d 20 4b 65 79 3a 20 43 2d 4d 2d 6e 20 28 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 .-.Key:.C-M-n.(transient-history
30680 2d 6e 65 78 74 29 20 3a 3a 0a 2d 20 4b 65 79 3a 20 43 2d 78 20 6e 20 3a 3a 0a 0a 20 20 54 68 69 -next).::.-.Key:.C-x.n.::....Thi
306a0 73 20 63 6f 6d 6d 61 6e 64 20 73 77 69 74 63 68 65 73 20 74 6f 20 74 68 65 20 6e 65 78 74 20 76 s.command.switches.to.the.next.v
306c0 61 6c 75 65 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 61 63 74 69 76 65 0a 20 20 74 72 61 6e 73 alue.used.for.the.active...trans
306e0 69 65 6e 74 2e 0a 0a 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 ient...In.addition.to.the.transi
30700 65 6e 74 2d 77 69 64 65 20 68 69 73 74 6f 72 79 2c 20 69 6e 66 69 78 65 73 20 63 61 6e 20 68 61 ent-wide.history,.infixes.can.ha
30720 76 65 20 74 68 65 69 72 20 6f 77 6e 0a 68 69 73 74 6f 72 79 2e 20 20 57 68 65 6e 20 61 6e 20 69 ve.their.own.history...When.an.i
30740 6e 66 69 78 20 72 65 61 64 73 20 75 73 65 72 2d 69 6e 70 75 74 20 75 73 69 6e 67 20 74 68 65 20 nfix.reads.user-input.using.the.
30760 6d 69 6e 69 62 75 66 66 65 72 2c 20 74 68 65 0a 75 73 65 72 20 63 61 6e 20 75 73 65 20 74 68 65 minibuffer,.the.user.can.use.the
30780 20 72 65 67 75 6c 61 72 20 6d 69 6e 69 62 75 66 66 65 72 20 68 69 73 74 6f 72 79 20 63 6f 6d 6d .regular.minibuffer.history.comm
307a0 61 6e 64 73 20 74 6f 20 63 79 63 6c 65 20 74 68 72 6f 75 67 68 0a 70 72 65 76 69 6f 75 73 6c 79 ands.to.cycle.through.previously
307c0 20 75 73 65 64 20 76 61 6c 75 65 73 2e 20 20 55 73 75 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 20 .used.values...Usually.the.same.
307e0 6b 65 79 73 20 61 73 20 74 68 6f 73 65 20 6d 65 6e 74 69 6f 6e 65 64 0a 61 62 6f 76 65 20 61 72 keys.as.those.mentioned.above.ar
30800 65 20 62 6f 75 6e 64 20 74 6f 20 74 68 6f 73 65 20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 41 75 74 68 e.bound.to.those.commands...Auth
30820 6f 72 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 73 68 6f 75 6c 64 20 61 72 72 61 6e 67 65 ors.of.transients.should.arrange
30840 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 .for.different.infix.commands.th
30860 61 74 0a 72 65 61 64 20 74 68 65 20 73 61 6d 65 20 6b 69 6e 64 20 6f 66 20 76 61 6c 75 65 20 74 at.read.the.same.kind.of.value.t
30880 6f 20 61 6c 73 6f 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 68 69 73 74 6f 72 79 20 6b 65 79 20 o.also.use.the.same.history.key.
308a0 28 73 65 65 0a 5b 5b 2a 53 75 66 66 69 78 20 53 6c 6f 74 73 5d 5d 29 2e 0a 0a 42 6f 74 68 20 6b (see.[[*Suffix.Slots]])...Both.k
308c0 69 6e 64 73 20 6f 66 20 68 69 73 74 6f 72 79 20 61 72 65 20 73 61 76 65 64 20 74 6f 20 61 20 66 inds.of.history.are.saved.to.a.f
308e0 69 6c 65 20 77 68 65 6e 20 45 6d 61 63 73 20 69 73 20 65 78 69 74 65 64 2e 0a 0a 2d 20 55 73 65 ile.when.Emacs.is.exited...-.Use
30900 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 r.Option:.transient-save-history
30920 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 .::....This.option.controls.whet
30940 68 65 72 20 74 68 65 20 68 69 73 74 6f 72 79 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d her.the.history.of.transient.com
30960 6d 61 6e 64 73 20 69 73 0a 20 20 73 61 76 65 64 20 77 68 65 6e 20 65 78 69 74 69 6e 67 20 45 6d mands.is...saved.when.exiting.Em
30980 61 63 73 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 68 acs...-.User.Option:.transient-h
309a0 69 73 74 6f 72 79 2d 66 69 6c 65 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6e 61 istory-file.::....This.option.na
309c0 6d 65 73 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 70 65 72 mes.the.file.that.is.used.to.per
309e0 73 69 73 74 20 74 68 65 20 68 69 73 74 6f 72 79 20 6f 66 0a 20 20 74 72 61 6e 73 69 65 6e 74 73 sist.the.history.of...transients
30a00 20 61 6e 64 20 74 68 65 69 72 20 69 6e 66 69 78 65 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 .and.their.infixes.between.Emacs
30a20 20 73 65 73 73 69 6f 6e 73 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 .sessions...-.User.Option:.trans
30a40 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 6c 69 6d 69 74 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 ient-history-limit.::....This.op
30a60 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 68 6f 77 20 6d 61 6e 79 20 68 69 73 74 6f 72 79 20 65 tion.controls.how.many.history.e
30a80 6c 65 6d 65 6e 74 73 20 61 72 65 20 6b 65 70 74 20 61 74 20 74 68 65 20 74 69 6d 65 0a 20 20 74 lements.are.kept.at.the.time...t
30aa0 68 65 20 68 69 73 74 6f 72 79 20 69 73 20 73 61 76 65 64 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e he.history.is.saved.in.~transien
30ac0 74 2d 68 69 73 74 6f 72 79 2d 66 69 6c 65 7e 2e 0a 0a 2a 2a 20 47 65 74 74 69 6e 67 20 48 65 6c t-history-file~...**.Getting.Hel
30ae0 70 20 66 6f 72 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 23 2b 63 69 6e 64 65 78 3a 20 p.for.Suffix.Commands.#+cindex:.
30b00 67 65 74 74 69 6e 67 20 68 65 6c 70 0a 0a 54 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 68 61 76 getting.help..Transients.can.hav
30b20 65 20 6d 61 6e 79 20 73 75 66 66 69 78 65 73 20 61 6e 64 20 69 6e 66 69 78 65 73 20 74 68 61 74 e.many.suffixes.and.infixes.that
30b40 20 74 68 65 20 75 73 65 72 20 6d 69 67 68 74 20 6e 6f 74 0a 62 65 20 66 61 6d 69 6c 69 61 72 20 .the.user.might.not.be.familiar.
30b60 77 69 74 68 2e 20 20 54 6f 20 6d 61 6b 65 20 69 74 20 74 72 69 76 69 61 6c 20 74 6f 20 67 65 74 with...To.make.it.trivial.to.get
30b80 20 68 65 6c 70 20 66 6f 72 20 74 68 65 73 65 2c 20 54 72 61 6e 73 69 65 6e 74 0a 70 72 6f 76 69 .help.for.these,.Transient.provi
30ba0 64 65 73 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 des.access.to.the.documentation.
30bc0 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 61 63 74 69 76 65 0a 74 72 61 6e 73 69 65 directly.from.the.active.transie
30be0 6e 74 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 68 20 28 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 29 nt...-.Key:.C-h.(transient-help)
30c00 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 65 6e 74 65 72 73 20 68 65 6c 70 20 .::....This.command.enters.help.
30c20 6d 6f 64 65 2e 20 20 57 68 65 6e 20 68 65 6c 70 20 6d 6f 64 65 20 69 73 20 61 63 74 69 76 65 2c mode...When.help.mode.is.active,
30c40 20 74 79 70 69 6e 67 20 61 0a 20 20 6b 65 79 20 73 68 6f 77 73 20 69 6e 66 6f 72 6d 61 74 69 6f .typing.a...key.shows.informatio
30c60 6e 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 n.about.the.suffix.command.that.
30c80 74 68 65 20 6b 65 79 20 6e 6f 72 6d 61 6c 6c 79 0a 20 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 28 the.key.normally...is.bound.to.(
30ca0 69 6e 73 74 65 61 64 20 6f 66 20 69 6e 76 6f 6b 69 6e 67 20 69 74 29 2e 20 20 50 72 65 73 73 69 instead.of.invoking.it)...Pressi
30cc0 6e 67 20 7b 7b 7b 6b 62 64 28 43 2d 68 29 7d 7d 7d 20 61 20 73 65 63 6f 6e 64 20 74 69 6d 65 0a ng.{{{kbd(C-h)}}}.a.second.time.
30ce0 20 20 73 68 6f 77 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 2f 70 ..shows.information.about.the./p
30d00 72 65 66 69 78 2f 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 41 66 74 65 72 20 74 79 70 69 6e 67 20 refix/.command.....After.typing.
30d20 61 20 6b 65 79 2c 20 74 68 65 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 20 73 74 a.key,.the.stack.of.transient.st
30d40 61 74 65 73 20 69 73 20 73 75 73 70 65 6e 64 65 64 20 61 6e 64 0a 20 20 69 6e 66 6f 72 6d 61 74 ates.is.suspended.and...informat
30d60 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 ion.about.the.suffix.command.is.
30d80 73 68 6f 77 6e 20 69 6e 73 74 65 61 64 2e 20 20 54 79 70 69 6e 67 20 7b 7b 7b 6b 62 64 28 71 29 shown.instead...Typing.{{{kbd(q)
30da0 7d 7d 7d 20 69 6e 0a 20 20 74 68 65 20 68 65 6c 70 20 62 75 66 66 65 72 20 62 75 72 69 65 73 20 }}}.in...the.help.buffer.buries.
30dc0 74 68 61 74 20 62 75 66 66 65 72 20 61 6e 64 20 72 65 73 75 6d 65 73 20 74 68 65 20 74 72 61 6e that.buffer.and.resumes.the.tran
30de0 73 69 65 6e 74 20 73 74 61 74 65 2e 0a 0a 57 68 61 74 20 73 6f 72 74 20 6f 66 20 64 6f 63 75 6d sient.state...What.sort.of.docum
30e00 65 6e 74 61 74 69 6f 6e 20 69 73 20 73 68 6f 77 6e 20 64 65 70 65 6e 64 73 20 6f 6e 20 68 6f 77 entation.is.shown.depends.on.how
30e20 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 61 73 0a 64 65 66 69 6e 65 64 2e 20 20 46 6f 72 .the.transient.was.defined...For
30e40 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 20 63 .infix.commands.that.represent.c
30e60 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 73 0a 74 68 69 73 20 69 64 65 61 6c ommand-line.arguments.this.ideal
30e80 6c 79 20 73 68 6f 77 73 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 6d 61 6e 70 61 67 65 ly.shows.the.appropriate.manpage
30ea0 2e 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 7e 20 74 68 65 6e 20 74 72 69 65 73 0a 74 ...~transient-help~.then.tries.t
30ec0 6f 20 6a 75 6d 70 20 74 6f 20 74 68 65 20 63 6f 72 72 65 63 74 20 6c 6f 63 61 74 69 6f 6e 20 77 o.jump.to.the.correct.location.w
30ee0 69 74 68 69 6e 20 74 68 61 74 2e 20 20 49 6e 66 6f 20 6d 61 6e 75 61 6c 73 20 61 72 65 20 61 6c ithin.that...Info.manuals.are.al
30f00 73 6f 0a 73 75 70 70 6f 72 74 65 64 2e 20 20 54 68 65 20 66 61 6c 6c 62 61 63 6b 20 69 73 20 74 so.supported...The.fallback.is.t
30f20 6f 20 73 68 6f 77 20 74 68 65 20 63 6f 6d 6d 61 6e 64 27 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 o.show.the.command's.documentati
30f40 6f 6e 0a 73 74 72 69 6e 67 2c 20 66 6f 72 20 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 on.string,.for.non-infix.suffixe
30f60 73 20 74 68 69 73 20 69 73 20 75 73 75 61 6c 6c 79 20 61 70 70 72 6f 70 72 69 61 74 65 2e 0a 0a s.this.is.usually.appropriate...
30f80 2a 2a 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 **.Enabling.and.Disabling.Suffix
30fa0 65 73 0a 23 2b 63 69 6e 64 65 78 3a 20 65 6e 61 62 6c 69 6e 67 20 73 75 66 66 69 78 65 73 0a 23 es.#+cindex:.enabling.suffixes.#
30fc0 2b 63 69 6e 64 65 78 3a 20 64 69 73 61 62 6c 69 6e 67 20 73 75 66 66 69 78 65 73 0a 0a 54 68 65 +cindex:.disabling.suffixes..The
30fe0 20 75 73 65 72 20 62 61 73 65 20 6f 66 20 61 20 70 61 63 6b 61 67 65 20 74 68 61 74 20 75 73 65 .user.base.of.a.package.that.use
31000 73 20 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 62 65 20 76 65 72 79 20 64 69 76 65 72 73 65 s.transients.can.be.very.diverse
31020 2e 0a 54 68 69 73 20 69 73 20 63 65 72 74 61 69 6e 6c 79 20 74 68 65 20 63 61 73 65 20 66 6f 72 ..This.is.certainly.the.case.for
31040 20 4d 61 67 69 74 3b 20 73 6f 6d 65 20 75 73 65 72 73 20 68 61 76 65 20 62 65 65 6e 20 75 73 69 .Magit;.some.users.have.been.usi
31060 6e 67 20 69 74 20 61 6e 64 0a 47 69 74 20 66 6f 72 20 61 20 64 65 63 61 64 65 2c 20 77 68 69 6c ng.it.and.Git.for.a.decade,.whil
31080 65 20 6f 74 68 65 72 73 20 61 72 65 20 6a 75 73 74 20 67 65 74 74 69 6e 67 20 73 74 61 72 74 65 e.others.are.just.getting.starte
310a0 64 20 6e 6f 77 2e 0a 0a 23 2b 63 69 6e 64 65 78 3a 20 6c 65 76 65 6c 73 0a 46 6f 72 20 74 68 61 d.now...#+cindex:.levels.For.tha
310c0 74 20 72 65 61 73 6f 6e 20 61 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 20 6e 65 65 64 65 64 20 74 t.reason.a.mechanism.is.needed.t
310e0 68 61 74 20 61 75 74 68 6f 72 73 20 63 61 6e 20 75 73 65 20 74 6f 20 63 6c 61 73 73 69 66 79 20 hat.authors.can.use.to.classify.
31100 61 0a 74 72 61 6e 73 69 65 6e 74 27 73 20 69 6e 66 69 78 65 73 20 61 6e 64 20 73 75 66 66 69 78 a.transient's.infixes.and.suffix
31120 65 73 20 61 6c 6f 6e 67 20 74 68 65 20 65 73 73 65 6e 74 69 61 6c 73 2e 2e 2e 65 76 65 72 79 74 es.along.the.essentials...everyt
31140 68 69 6e 67 0a 73 70 65 63 74 72 75 6d 2e 20 20 57 65 20 75 73 65 20 74 68 65 20 74 65 72 6d 20 hing.spectrum...We.use.the.term.
31160 7b 7b 7b 64 66 6e 28 6c 65 76 65 6c 73 29 7d 7d 7d 20 74 6f 20 64 65 73 63 72 69 62 65 20 74 68 {{{dfn(levels)}}}.to.describe.th
31180 61 74 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 0a 23 2b 63 69 6e 64 65 78 3a 20 74 72 61 6e 73 69 65 at.mechanism...#+cindex:.transie
311a0 6e 74 2d 6c 65 76 65 6c 0a 45 61 63 68 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 nt-level.Each.suffix.command.is.
311c0 70 6c 61 63 65 64 20 6f 6e 20 61 20 6c 65 76 65 6c 20 61 6e 64 20 65 61 63 68 20 74 72 61 6e 73 placed.on.a.level.and.each.trans
311e0 69 65 6e 74 20 68 61 73 20 61 0a 6c 65 76 65 6c 20 28 63 61 6c 6c 65 64 20 7b 7b 7b 64 66 6e 28 ient.has.a.level.(called.{{{dfn(
31200 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 29 7d 7d 7d 29 2c 20 77 68 69 63 68 20 63 6f 6e 74 transient-level)}}}),.which.cont
31220 72 6f 6c 73 20 77 68 69 63 68 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 61 72 65 20 61 rols.which.suffix.commands.are.a
31240 76 61 69 6c 61 62 6c 65 2e 20 20 49 6e 74 65 67 65 72 73 20 62 65 74 77 65 65 6e 20 31 20 61 6e vailable...Integers.between.1.an
31260 64 20 37 20 28 69 6e 63 6c 75 73 69 76 65 29 20 61 72 65 20 76 61 6c 69 64 20 6c 65 76 65 6c 73 d.7.(inclusive).are.valid.levels
31280 2e 0a 46 6f 72 20 73 75 66 66 69 78 65 73 2c 20 30 20 69 73 20 61 6c 73 6f 20 76 61 6c 69 64 3b ..For.suffixes,.0.is.also.valid;
312a0 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 73 75 66 66 69 78 20 69 73 20 6e 6f 74 .it.means.that.the.suffix.is.not
312c0 0a 64 69 73 70 6c 61 79 65 64 20 61 74 20 61 6e 79 20 6c 65 76 65 6c 2e 0a 0a 54 68 65 20 6c 65 .displayed.at.any.level...The.le
312e0 76 65 6c 73 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6e vels.of.individual.transients.an
31300 64 2f 6f 72 20 74 68 65 69 72 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 69 78 65 73 0a 63 d/or.their.individual.suffixes.c
31320 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 2c 20 62 79 20 an.be.changed.interactively,.by.
31340 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 20 65 6e 74 65 72 69 6e 67 20 69 invoking.the.menu.and.entering.i
31360 74 73 0a e2 80 9c 65 64 69 74 e2 80 9d 20 6d 6f 64 65 20 75 73 69 6e 67 20 74 68 65 20 63 6f 6d ts....edit....mode.using.the.com
31380 6d 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c 7e 2c 20 61 73 20 64 mand.~transient-set-level~,.as.d
313a0 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 6c 65 76 escribed.below...The.default.lev
313c0 65 6c 20 66 6f 72 20 62 6f 74 68 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 el.for.both.transients.and.their
313e0 20 73 75 66 66 69 78 65 73 20 69 73 20 34 2e 20 20 54 68 65 0a 7e 74 72 61 6e 73 69 65 6e 74 2d .suffixes.is.4...The.~transient-
31400 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 7e 20 6f 70 74 69 6f 6e 20 6f 6e 6c 79 20 63 6f 6e 74 72 default-level~.option.only.contr
31420 6f 6c 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72 0a 74 72 61 6e 73 69 65 6e 74 73 2e 20 ols.the.default.for.transients..
31440 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 75 66 66 69 78 20 6c 65 76 65 6c 20 69 73 20 61 6c 77 .The.default.suffix.level.is.alw
31460 61 79 73 20 34 2e 20 20 54 68 65 20 61 75 74 68 6f 72 73 20 6f 66 0a 74 72 61 6e 73 69 65 6e 74 ays.4...The.authors.of.transient
31480 73 20 73 68 6f 75 6c 64 20 70 6c 61 63 65 20 63 65 72 74 61 69 6e 20 73 75 66 66 69 78 65 73 20 s.should.place.certain.suffixes.
314a0 6f 6e 20 61 20 68 69 67 68 65 72 20 6c 65 76 65 6c 2c 20 69 66 20 74 68 65 79 0a 65 78 70 65 63 on.a.higher.level,.if.they.expec
314c0 74 20 74 68 61 74 20 69 74 20 77 6f 6e 27 74 20 62 65 20 6f 66 20 75 73 65 20 74 6f 20 6d 6f 73 t.that.it.won't.be.of.use.to.mos
314e0 74 20 75 73 65 72 73 2c 20 61 6e 64 20 74 68 65 79 20 73 68 6f 75 6c 64 20 70 6c 61 63 65 0a 76 t.users,.and.they.should.place.v
31500 65 72 79 20 69 6d 70 6f 72 74 61 6e 74 20 73 75 66 66 69 78 65 73 20 6f 6e 20 61 20 6c 6f 77 65 ery.important.suffixes.on.a.lowe
31520 72 20 6c 65 76 65 6c 2c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 72 65 6d 61 69 6e 0a 61 76 61 r.level,.so.that.they.remain.ava
31540 69 6c 61 62 6c 65 20 65 76 65 6e 20 69 66 20 74 68 65 20 75 73 65 72 20 6c 6f 77 65 72 73 20 74 ilable.even.if.the.user.lowers.t
31560 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6c 65 76 65 6c 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 he.transient.level...-.User.Opti
31580 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 3a 3a 0a 0a on:.transient-default-level.::..
315a0 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 69 63 68 20 73 75 66 ..This.option.controls.which.suf
315c0 66 69 78 20 6c 65 76 65 6c 73 20 61 72 65 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 fix.levels.are.made.available.by
315e0 0a 20 20 64 65 66 61 75 6c 74 2e 20 20 49 74 20 73 65 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 ...default...It.sets.the.transie
31600 6e 74 2d 6c 65 76 65 6c 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 73 20 66 6f 72 20 77 68 69 63 nt-level.for.transients.for.whic
31620 68 20 74 68 65 0a 20 20 75 73 65 72 20 68 61 73 20 6e 6f 74 20 73 65 74 20 74 68 61 74 20 69 6e h.the...user.has.not.set.that.in
31640 64 69 76 69 64 75 61 6c 6c 79 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e dividually...-.User.Option:.tran
31660 73 69 65 6e 74 2d 6c 65 76 65 6c 73 2d 66 69 6c 65 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 sient-levels-file.::....This.opt
31680 69 6f 6e 20 6e 61 6d 65 73 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 75 73 65 64 20 ion.names.the.file.that.is.used.
316a0 74 6f 20 70 65 72 73 69 73 74 20 74 68 65 20 6c 65 76 65 6c 73 20 6f 66 0a 20 20 74 72 61 6e 73 to.persist.the.levels.of...trans
316c0 69 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 73 75 66 66 69 78 65 73 20 62 65 74 77 65 65 6e ients.and.their.suffixes.between
316e0 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 2e 0a 0a 4f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 .Emacs.sessions...Option.~transi
31700 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 7e 20 63 6f 6e 74 72 ent-common-command-prefix~.contr
31720 6f 6c 73 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 0a 69 6e 20 74 68 65 20 66 ols.the.prefix.key.used.in.the.f
31740 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e 64 69 6e 67 73 2e 20 20 46 6f 72 20 73 69 6d 70 6c 69 63 69 ollowing.bindings...For.simplici
31760 74 79 27 73 20 73 61 6b 65 20 74 68 65 20 64 65 66 61 75 6c 74 2c 20 7b 7b 7b 6b 62 64 28 43 2d ty's.sake.the.default,.{{{kbd(C-
31780 78 29 7d 7d 7d 2c 0a 69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2e 0a 0a 2d 20 4b 65 79 3a 20 43 x)}}},.is.shown.below...-.Key:.C
317a0 2d 78 20 6c 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c 29 20 3a 3a 0a 0a 20 -x.l.(transient-set-level).::...
317c0 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 65 6e 74 65 72 73 20 65 64 69 74 20 6d 6f 64 65 2e 20 .This.command.enters.edit.mode..
317e0 20 57 68 65 6e 20 65 64 69 74 20 6d 6f 64 65 20 69 73 20 61 63 74 69 76 65 2c 20 74 68 65 6e 20 .When.edit.mode.is.active,.then.
31800 61 6c 6c 0a 20 20 69 6e 66 69 78 65 73 20 61 6e 64 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 all...infixes.and.suffixes.that.
31820 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 75 73 61 62 6c 65 20 61 72 65 20 64 69 73 70 6c 61 79 are.currently.usable.are.display
31840 65 64 20 61 6c 6f 6e 67 0a 20 20 77 69 74 68 20 74 68 65 69 72 20 6c 65 76 65 6c 73 2e 20 20 54 ed.along...with.their.levels...T
31860 68 65 20 63 6f 6c 6f 72 73 20 6f 66 20 74 68 65 20 6c 65 76 65 6c 73 20 69 6e 64 69 63 61 74 65 he.colors.of.the.levels.indicate
31880 20 77 68 65 74 68 65 72 20 74 68 65 79 0a 20 20 61 72 65 20 65 6e 61 62 6c 65 64 20 6f 72 20 6e .whether.they...are.enabled.or.n
318a0 6f 74 2e 20 20 54 68 65 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 ot...The.level.of.the.transient.
318c0 69 73 20 61 6c 73 6f 20 64 69 73 70 6c 61 79 65 64 0a 20 20 61 6c 6f 6e 67 20 77 69 74 68 20 73 is.also.displayed...along.with.s
318e0 6f 6d 65 20 75 73 61 67 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 49 6e 20 65 64 69 ome.usage.information.....In.edi
31900 74 20 6d 6f 64 65 2c 20 70 72 65 73 73 69 6e 67 20 74 68 65 20 6b 65 79 20 74 68 61 74 20 77 6f t.mode,.pressing.the.key.that.wo
31920 75 6c 64 20 75 73 75 61 6c 6c 79 20 69 6e 76 6f 6b 65 20 61 20 63 65 72 74 61 69 6e 0a 20 20 73 uld.usually.invoke.a.certain...s
31940 75 66 66 69 78 20 69 6e 73 74 65 61 64 20 70 72 6f 6d 70 74 73 20 74 68 65 20 75 73 65 72 20 66 uffix.instead.prompts.the.user.f
31960 6f 72 20 74 68 65 20 6c 65 76 65 6c 20 74 68 61 74 20 73 75 66 66 69 78 20 73 68 6f 75 6c 64 20 or.the.level.that.suffix.should.
31980 62 65 0a 20 20 70 6c 61 63 65 64 20 6f 6e 2e 0a 0a 20 20 48 65 6c 70 20 6d 6f 64 65 20 69 73 20 be...placed.on.....Help.mode.is.
319a0 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 65 64 69 74 20 6d 6f 64 65 2e 0a 0a 20 20 54 6f 20 63 68 available.in.edit.mode.....To.ch
319c0 61 6e 67 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6c 65 76 65 6c 20 70 72 65 73 73 20 7b ange.the.transient.level.press.{
319e0 7b 7b 6b 62 64 28 43 2d 78 20 6c 29 7d 7d 7d 20 61 67 61 69 6e 2e 0a 0a 20 20 54 6f 20 65 78 69 {{kbd(C-x.l)}}}.again.....To.exi
31a00 74 20 65 64 69 74 20 6d 6f 64 65 20 70 72 65 73 73 20 7b 7b 7b 6b 62 64 28 43 2d 67 29 7d 7d 7d t.edit.mode.press.{{{kbd(C-g)}}}
31a20 2e 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 20 65 64 69 74 20 6d 6f 64 65 20 64 6f 65 73 20 6e 6f .....Note.that.edit.mode.does.no
31a40 74 20 64 69 73 70 6c 61 79 20 61 6e 79 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 65 20 t.display.any.suffixes.that.are.
31a60 6e 6f 74 0a 20 20 63 75 72 72 65 6e 74 6c 79 20 75 73 61 62 6c 65 2e 20 20 7e 6d 61 67 69 74 2d not...currently.usable...~magit-
31a80 72 65 62 61 73 65 7e 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 73 20 64 69 66 66 rebase~,.for.example,.shows.diff
31aa0 65 72 65 6e 74 0a 20 20 73 75 66 66 69 78 65 73 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 erent...suffixes.depending.on.wh
31ac0 65 74 68 65 72 20 61 20 72 65 62 61 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 70 72 6f ether.a.rebase.is.already.in.pro
31ae0 67 72 65 73 73 20 6f 72 0a 20 20 6e 6f 74 2e 20 20 54 68 65 20 70 72 65 64 69 63 61 74 65 73 20 gress.or...not...The.predicates.
31b00 61 6c 73 6f 20 61 70 70 6c 79 20 69 6e 20 65 64 69 74 20 6d 6f 64 65 2e 0a 0a 20 20 54 68 65 72 also.apply.in.edit.mode.....Ther
31b20 65 66 6f 72 65 2c 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 77 68 69 63 68 20 73 75 66 66 69 78 65 73 efore,.to.control.which.suffixes
31b40 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 67 69 76 65 6e 20 61 20 63 65 72 74 61 69 6e 0a 20 .are.available.given.a.certain..
31b60 20 73 74 61 74 65 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 .state,.you.have.to.make.sure.th
31b80 61 74 20 74 68 61 74 20 73 74 61 74 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 at.that.state.is.currently.activ
31ba0 65 2e 0a 0a 2d 20 4b 65 79 3a 20 43 2d 78 20 61 20 28 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 e...-.Key:.C-x.a.(transient-togg
31bc0 6c 65 2d 6c 65 76 65 6c 2d 6c 69 6d 69 74 29 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 le-level-limit).::....This.comma
31be0 6e 64 20 74 6f 67 67 6c 65 20 77 68 65 74 68 65 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 nd.toggle.whether.suffixes.that.
31c00 61 72 65 20 6f 6e 20 6c 65 76 65 6c 73 20 68 69 67 68 65 72 20 74 68 61 6e 0a 20 20 74 68 65 20 are.on.levels.higher.than...the.
31c20 6c 65 76 65 6c 20 73 70 65 63 69 66 69 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 level.specified.by.~transient-de
31c40 66 61 75 6c 74 2d 6c 65 76 65 6c 7e 20 61 72 65 20 74 65 6d 70 6f 72 61 72 69 6c 79 0a 20 20 61 fault-level~.are.temporarily...a
31c60 76 61 69 6c 61 62 6c 65 20 61 6e 79 77 61 79 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 vailable.anyway...-.Function:.tr
31c80 61 6e 73 69 65 6e 74 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 73 75 66 66 69 78 ansient-set-default-level.suffix
31ca0 20 6c 65 76 65 6c 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 .level.::....This.function.sets.
31cc0 74 68 65 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 20 the.default.level.of.the.suffix.
31ce0 43 4f 4d 4d 41 4e 44 20 74 6f 20 4c 45 56 45 4c 2e 0a 0a 20 20 49 66 20 61 20 73 75 66 66 69 78 COMMAND.to.LEVEL.....If.a.suffix
31d00 20 63 6f 6d 6d 61 6e 64 20 61 70 70 65 61 72 73 20 69 6e 20 6d 75 6c 74 69 70 6c 65 20 6d 65 6e .command.appears.in.multiple.men
31d20 75 73 2c 20 69 74 20 6d 61 79 20 6d 61 6b 65 20 73 65 6e 73 65 20 74 6f 0a 20 20 63 6f 6e 73 69 us,.it.may.make.sense.to...consi
31d40 73 74 65 6e 74 6c 79 20 63 68 61 6e 67 65 20 69 74 73 20 6c 65 76 65 6c 20 69 6e 20 61 6c 6c 20 stently.change.its.level.in.all.
31d60 74 68 6f 73 65 20 6d 65 6e 75 73 20 61 74 20 6f 6e 63 65 2e 20 20 46 6f 72 0a 20 20 65 78 61 6d those.menus.at.once...For...exam
31d80 70 6c 65 2c 20 74 68 65 20 7e 2d 2d 67 70 67 2d 73 69 67 6e 7e 20 61 72 67 75 6d 65 6e 74 20 28 ple,.the.~--gpg-sign~.argument.(
31da0 77 68 69 63 68 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 75 73 69 6e 67 20 74 68 65 0a 20 which.is.implemented.using.the..
31dc0 20 63 6f 6d 6d 61 6e 64 20 7e 6d 61 67 69 74 3a 2d 2d 67 70 67 2d 73 69 67 6e 7e 29 2c 20 69 73 .command.~magit:--gpg-sign~),.is
31de0 20 62 6f 75 6e 64 20 69 6e 20 61 6c 6c 20 6f 66 20 4d 61 67 69 74 27 73 20 6d 65 6e 75 20 77 68 .bound.in.all.of.Magit's.menu.wh
31e00 69 63 68 0a 20 20 63 72 65 61 74 65 20 63 6f 6d 6d 69 74 73 2e 20 20 55 73 65 72 73 20 77 68 6f ich...create.commits...Users.who
31e20 20 73 6f 6d 65 74 69 6d 65 73 20 73 69 67 6e 20 74 68 65 69 72 20 63 6f 6d 6d 69 74 73 20 77 6f .sometimes.sign.their.commits.wo
31e40 75 6c 64 20 77 61 6e 74 0a 20 20 74 68 61 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 62 65 20 61 uld.want...that.argument.to.be.a
31e60 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 20 6f 66 20 74 68 65 73 65 20 6d 65 6e 75 73 2c 20 vailable.in.all.of.these.menus,.
31e80 77 68 69 6c 65 20 66 6f 72 20 75 73 65 72 73 0a 20 20 77 68 6f 20 6e 65 76 65 72 20 73 69 67 6e while.for.users...who.never.sign
31ea0 20 69 74 20 69 73 20 6a 75 73 74 20 75 6e 6e 65 63 65 73 73 61 72 79 20 6e 6f 69 73 65 20 69 6e .it.is.just.unnecessary.noise.in
31ec0 20 61 6e 79 20 6d 65 6e 75 73 2e 0a 0a 20 20 54 6f 20 61 6c 77 61 79 73 20 6d 61 6b 65 20 7e 2d .any.menus.....To.always.make.~-
31ee0 2d 67 70 67 2d 73 69 67 6e 7e 20 61 76 61 69 6c 61 62 6c 65 2c 20 75 73 65 3a 0a 0a 20 20 23 2b -gpg-sign~.available,.use:....#+
31f00 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 74 72 61 6e 73 69 begin_src.emacs-lisp.....(transi
31f20 65 6e 74 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 27 6d 61 67 69 74 3a 2d 2d 67 ent-set-default-level.'magit:--g
31f40 70 67 2d 73 69 67 6e 20 31 29 0a 20 20 23 2b 65 6e 64 5f 73 72 63 0a 0a 20 20 54 6f 20 6e 65 76 pg-sign.1)...#+end_src....To.nev
31f60 65 72 20 6d 61 6b 65 20 7e 2d 2d 67 70 67 2d 73 69 67 6e 7e 20 61 76 61 69 6c 61 62 6c 65 2c 20 er.make.~--gpg-sign~.available,.
31f80 75 73 65 3a 0a 0a 20 20 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 use:....#+begin_src.emacs-lisp..
31fa0 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 ...(transient-set-default-level.
31fc0 27 6d 61 67 69 74 3a 2d 2d 67 70 67 2d 73 69 67 6e 20 30 29 0a 20 20 23 2b 65 6e 64 5f 73 72 63 'magit:--gpg-sign.0)...#+end_src
31fe0 0a 0a 20 20 54 68 69 73 20 73 65 74 73 20 74 68 65 20 6c 65 76 65 6c 20 69 6e 20 74 68 65 20 73 ....This.sets.the.level.in.the.s
32000 75 66 66 69 78 20 70 72 6f 74 6f 74 79 70 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 69 73 20 uffix.prototype.object.for.this.
32020 63 6f 6d 6d 61 6e 64 2e 0a 20 20 43 6f 6d 6d 61 6e 64 73 20 6f 6e 6c 79 20 68 61 76 65 20 61 20 command....Commands.only.have.a.
32040 73 75 66 66 69 78 20 70 72 6f 74 6f 74 79 70 65 20 69 66 20 74 68 65 79 20 77 65 72 65 20 64 65 suffix.prototype.if.they.were.de
32060 66 69 6e 65 64 20 75 73 69 6e 67 20 6f 6e 65 0a 20 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d fined.using.one...of.~transient-
32080 64 65 66 69 6e 65 2d 61 72 67 75 6d 65 6e 74 7e 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 define-argument~,.~transient-def
320a0 69 6e 65 2d 69 6e 66 69 78 7e 20 61 6e 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 ine-infix~.and...~transient-defi
320c0 6e 65 2d 73 75 66 66 69 78 7e 2e 20 20 46 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 63 6f 6d 6d 61 ne-suffix~...For.all.other.comma
320e0 6e 64 73 20 74 68 69 73 20 77 6f 75 6c 64 20 73 69 67 6e 61 6c 0a 20 20 61 6e 20 65 72 72 6f 72 nds.this.would.signal...an.error
32100 2e 20 20 28 54 68 69 73 20 69 73 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65 61 73 6f 6e 73 20 77 ...(This.is.one.of.the.reasons.w
32120 68 79 20 70 61 63 6b 61 67 65 20 61 75 74 68 6f 72 73 20 73 68 6f 75 6c 64 0a 20 20 75 73 65 20 hy.package.authors.should...use.
32140 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 64 65 66 69 6e 65 one.of.these.functions.to.define
32160 20 73 68 61 72 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 0a 20 20 65 .shared.suffix.commands,.and...e
32180 73 70 65 63 69 61 6c 6c 79 20 73 68 61 72 65 64 20 61 72 67 75 6d 65 6e 74 73 2e 29 0a 0a 20 20 specially.shared.arguments.)....
321a0 49 66 20 74 68 65 20 75 73 65 72 20 63 68 61 6e 67 65 73 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 If.the.user.changes.the.level.of
321c0 20 61 20 73 75 66 66 69 78 20 69 6e 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 6d 65 6e 75 2c 0a .a.suffix.in.a.particular.menu,.
321e0 20 20 75 73 69 6e 67 20 7b 7b 7b 6b 62 64 28 43 2d 78 20 6c 29 7d 7d 7d 20 61 73 20 73 68 6f 77 ..using.{{{kbd(C-x.l)}}}.as.show
32200 6e 20 61 62 6f 76 65 2c 20 74 68 65 6e 20 74 68 61 74 20 6f 62 76 69 6f 75 73 6c 79 20 73 68 61 n.above,.then.that.obviously.sha
32220 64 6f 77 73 20 74 68 65 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 49 74 20 69 73 20 61 6c 73 6f 20 dows.the.default.....It.is.also.
32240 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 20 61 20 73 possible.to.set.the.level.of.a.s
32260 75 66 66 69 78 20 62 69 6e 64 69 6e 67 20 69 6e 20 61 0a 20 20 70 61 72 74 69 63 75 6c 61 72 20 uffix.binding.in.a...particular.
32280 6d 65 6e 75 2c 20 65 69 74 68 65 72 20 77 68 65 6e 20 64 65 66 69 6e 69 6e 67 20 74 68 65 20 6d menu,.either.when.defining.the.m
322a0 65 6e 75 20 75 73 69 6e 67 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 enu.using...~transient-define-pr
322c0 65 66 69 78 2c 7e 20 6f 72 20 6c 61 74 65 72 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 efix,~.or.later.using.~transient
322e0 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 7e 2e 20 20 49 66 0a 20 20 73 75 63 68 20 62 69 6e 64 -insert-suffix~...If...such.bind
32300 69 6e 67 73 20 73 70 65 63 69 66 79 20 61 20 6c 65 76 65 6c 2c 20 74 68 65 6e 20 74 68 61 74 20 ings.specify.a.level,.then.that.
32320 61 6c 73 6f 20 6f 76 65 72 72 69 64 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 2e 0a 20 20 28 50 also.overrides.the.default....(P
32340 65 72 2d 73 75 66 66 69 78 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 73 20 69 73 20 61 20 6e 65 er-suffix.default.levels.is.a.ne
32360 77 20 66 65 61 74 75 72 65 2c 20 73 6f 20 79 6f 75 20 6d 69 67 68 74 20 65 6e 63 6f 75 6e 74 65 w.feature,.so.you.might.encounte
32380 72 0a 20 20 74 68 69 73 20 71 75 69 74 65 20 6f 66 74 65 6e 2e 29 0a 0a 2a 2a 20 4f 74 68 65 72 r...this.quite.often.)..**.Other
323a0 20 43 6f 6d 6d 61 6e 64 73 0a 0a 57 68 65 6e 20 69 6e 76 6f 6b 69 6e 67 20 61 20 74 72 61 6e 73 .Commands..When.invoking.a.trans
323c0 69 65 6e 74 20 69 6e 20 61 20 73 6d 61 6c 6c 20 66 72 61 6d 65 2c 20 74 68 65 20 74 72 61 6e 73 ient.in.a.small.frame,.the.trans
323e0 69 65 6e 74 20 77 69 6e 64 6f 77 20 6d 61 79 0a 6e 6f 74 20 73 68 6f 77 20 74 68 65 20 63 6f 6d ient.window.may.not.show.the.com
32400 70 6c 65 74 65 20 62 75 66 66 65 72 2c 20 6d 61 6b 69 6e 67 20 69 74 20 6e 65 63 65 73 73 61 72 plete.buffer,.making.it.necessar
32420 79 20 74 6f 20 73 63 72 6f 6c 6c 2c 20 75 73 69 6e 67 20 74 68 65 0a 66 6f 6c 6c 6f 77 69 6e 67 y.to.scroll,.using.the.following
32440 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e .commands...These.commands.are.n
32460 65 76 65 72 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 77 69 6e 64 ever.shown.in.the.transient.wind
32480 6f 77 2c 20 61 6e 64 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 74 68 65 ow,.and.the.key.bindings.are.the
324a0 20 73 61 6d 65 20 61 73 20 66 6f 72 20 7e 73 63 72 6f 6c 6c 2d 75 70 2d 63 6f 6d 6d 61 6e 64 7e .same.as.for.~scroll-up-command~
324c0 20 61 6e 64 0a 7e 73 63 72 6f 6c 6c 2d 64 6f 77 6e 2d 63 6f 6d 6d 61 6e 64 7e 20 69 6e 20 6f 74 .and.~scroll-down-command~.in.ot
324e0 68 65 72 20 62 75 66 66 65 72 73 2e 0a 0a 2d 20 43 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 her.buffers...-.Command:.transie
32500 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 20 61 72 67 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d nt-scroll-up.arg.::....This.comm
32520 61 6e 64 20 73 63 72 6f 6c 6c 73 20 74 65 78 74 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 27 73 20 and.scrolls.text.of.transient's.
32540 6d 65 6e 75 20 77 69 6e 64 6f 77 20 75 70 77 61 72 64 20 7b 7b 7b 76 61 72 28 41 52 47 29 7d 7d menu.window.upward.{{{var(ARG)}}
32560 7d 0a 20 20 6c 69 6e 65 73 2e 20 20 49 66 20 7b 7b 7b 76 61 72 28 41 52 47 29 7d 7d 7d 20 69 73 }...lines...If.{{{var(ARG)}}}.is
32580 20 7e 6e 69 6c 7e 2c 20 74 68 65 6e 20 69 74 20 73 63 72 6f 6c 6c 73 20 6e 65 61 72 20 66 75 6c .~nil~,.then.it.scrolls.near.ful
325a0 6c 20 73 63 72 65 65 6e 2e 20 20 54 68 69 73 0a 20 20 69 73 20 61 20 77 72 61 70 70 65 72 20 61 l.screen...This...is.a.wrapper.a
325c0 72 6f 75 6e 64 20 7e 73 63 72 6f 6c 6c 2d 75 70 2d 63 6f 6d 6d 61 6e 64 7e 20 28 77 68 69 63 68 round.~scroll-up-command~.(which
325e0 20 73 65 65 29 2e 0a 0a 2d 20 43 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 .see)...-.Command:.transient-scr
32600 6f 6c 6c 2d 64 6f 77 6e 20 61 72 67 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 oll-down.arg.::....This.command.
32620 73 63 72 6f 6c 6c 73 20 74 65 78 74 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 scrolls.text.of.transient's.menu
32640 20 77 69 6e 64 6f 77 20 64 6f 77 6e 20 7b 7b 7b 76 61 72 28 41 52 47 29 7d 7d 7d 0a 20 20 6c 69 .window.down.{{{var(ARG)}}}...li
32660 6e 65 73 2e 20 20 49 66 20 7b 7b 7b 76 61 72 28 41 52 47 29 7d 7d 7d 20 69 73 20 7e 6e 69 6c 7e nes...If.{{{var(ARG)}}}.is.~nil~
32680 2c 20 74 68 65 6e 20 69 74 20 73 63 72 6f 6c 6c 73 20 6e 65 61 72 20 66 75 6c 6c 20 73 63 72 65 ,.then.it.scrolls.near.full.scre
326a0 65 6e 2e 20 20 54 68 69 73 0a 20 20 69 73 20 61 20 77 72 61 70 70 65 72 20 61 72 6f 75 6e 64 20 en...This...is.a.wrapper.around.
326c0 7e 73 63 72 6f 6c 6c 2d 64 6f 77 6e 2d 63 6f 6d 6d 61 6e 64 7e 20 28 77 68 69 63 68 20 73 65 65 ~scroll-down-command~.(which.see
326e0 29 2e 0a 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e )...The.following.commands.are.n
32700 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 49 66 20 79 6f 75 ot.available.by.default...If.you
32720 20 77 6f 75 6c 64 0a 6c 69 6b 65 20 74 6f 20 75 73 65 20 74 68 65 6d 20 66 6f 72 20 61 6c 6c 20 .would.like.to.use.them.for.all.
32740 6d 65 6e 75 73 2c 20 62 69 6e 64 20 74 68 65 6d 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6d menus,.bind.them.in.~transient-m
32760 61 70 7e 2e 0a 0a 2d 20 43 6f 6d 6d 61 6e 64 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 70 79 2d ap~...-.Command:.transient-copy-
32780 6d 65 6e 75 2d 74 65 78 74 20 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 63 6f 70 menu-text.::....This.command.cop
327a0 69 65 73 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 6d 65 6e 75 20 62 75 66 ies.the.contents.of.the.menu.buf
327c0 66 65 72 20 74 6f 20 74 68 65 20 6b 69 6c 6c 0a 20 20 72 69 6e 67 2e 0a 0a 2d 20 43 6f 6d 6d 61 fer.to.the.kill...ring...-.Comma
327e0 6e 64 3a 20 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 6f 63 73 74 72 69 6e 67 73 20 nd:.transient-toggle-docstrings.
32800 3a 3a 0a 0a 20 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 74 6f 67 67 6c 65 20 62 65 74 77 65 65 ::....This.command.toggle.betwee
32820 6e 20 73 68 6f 77 69 6e 67 20 73 75 66 66 69 78 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 69 6e n.showing.suffix.descriptions.in
32840 20 74 68 65 20 6d 65 6e 75 0a 20 20 28 61 73 20 75 73 75 61 6c 29 20 6f 72 20 73 68 6f 77 69 6e .the.menu...(as.usual).or.showin
32860 67 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 73 20 6f 66 20 74 68 65 20 72 65 73 70 65 63 74 g.the.first.lines.of.the.respect
32880 69 76 65 20 64 6f 63 73 74 72 69 6e 67 73 0a 20 20 69 6e 20 74 68 65 69 72 20 70 6c 61 63 65 2e ive.docstrings...in.their.place.
328a0 20 20 46 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 ..For.commands.that.do.not.have.
328c0 61 20 64 6f 63 73 74 72 69 6e 67 2c 20 61 6c 77 61 79 73 0a 20 20 64 69 73 70 6c 61 79 20 74 68 a.docstring,.always...display.th
328e0 65 20 73 75 66 66 69 78 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 20 20 42 65 63 61 75 73 65 20 74 e.suffix.description...Because.t
32900 68 65 72 65 20 6c 69 6b 65 6c 79 20 69 73 6e 27 74 20 65 6e 6f 75 67 68 0a 20 20 72 6f 6f 6d 20 here.likely.isn't.enough...room.
32920 74 6f 20 64 69 73 70 6c 61 79 20 6d 75 6c 74 69 70 6c 65 20 64 6f 63 73 74 72 69 6e 67 73 20 73 to.display.multiple.docstrings.s
32940 69 64 65 2d 62 79 2d 73 69 64 65 2c 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 0a 20 20 69 ide-by-side,.a.single.column...i
32960 73 20 75 73 65 64 20 77 68 65 6e 20 64 69 73 70 6c 61 79 69 6e 67 20 64 6f 63 73 74 72 69 6e 67 s.used.when.displaying.docstring
32980 73 2e 0a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 0a 4d 6f 72 65 20 6f 70 74 69 6f s...**.Configuration..More.optio
329a0 6e 73 20 61 72 65 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 5b 5b 2a 20 43 6f 6d 6d 6f 6e 20 53 ns.are.described.in.[[*.Common.S
329c0 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 5d 5d 2c 20 69 6e 20 5b 5b 2a 20 53 61 76 69 6e 67 0a uffix.Commands]],.in.[[*.Saving.
329e0 56 61 6c 75 65 73 5d 5d 2c 20 69 6e 20 5b 5b 2a 20 55 73 69 6e 67 20 48 69 73 74 6f 72 79 5d 5d Values]],.in.[[*.Using.History]]
32a00 20 61 6e 64 20 69 6e 20 5b 5b 2a 20 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 .and.in.[[*.Enabling.and.Disabli
32a20 6e 67 20 53 75 66 66 69 78 65 73 5d 5d 2e 0a 0a 2a 2a 2a 20 45 73 73 65 6e 74 69 61 6c 20 4f 70 ng.Suffixes]]...***.Essential.Op
32a40 74 69 6f 6e 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 tions.:PROPERTIES:.:UNNUMBERED:.
32a60 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 54 77 6f 20 6d 6f 72 65 20 65 73 73 65 6e 74 69 61 6c 20 notoc.:END:..Two.more.essential.
32a80 6f 70 74 69 6f 6e 73 20 61 72 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 5b 5b 2a 20 43 6f options.are.documented.in.[[*.Co
32aa0 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 5d 5d 2e 0a 0a 2d 20 55 73 65 72 20 mmon.Suffix.Commands]]...-.User.
32ac0 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 6f 70 75 70 20 3a 3a 0a Option:.transient-show-popup.::.
32ae0 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 ...This.option.controls.whether.
32b00 61 6e 64 20 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 and.when.transient's.menu.buffer
32b20 20 69 73 0a 20 20 73 68 6f 77 6e 2e 0a 0a 20 20 2d 20 49 66 20 7e 74 7e 20 28 74 68 65 20 64 65 .is...shown.....-.If.~t~.(the.de
32b40 66 61 75 6c 74 29 2c 20 74 68 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 69 73 20 73 68 6f 77 6e fault),.then.the.buffer.is.shown
32b60 20 61 73 20 73 6f 6f 6e 20 61 73 20 61 0a 20 20 20 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 .as.soon.as.a.....transient.pref
32b80 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2e 0a 0a 20 20 2d 20 49 66 20 7e ix.command.is.invoked.....-.If.~
32ba0 6e 69 6c 7e 2c 20 74 68 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 20 73 68 6f nil~,.then.the.buffer.is.not.sho
32bc0 77 6e 20 75 6e 6c 65 73 73 20 74 68 65 20 75 73 65 72 20 65 78 70 6c 69 63 69 74 6c 79 0a 20 20 wn.unless.the.user.explicitly...
32be0 20 20 72 65 71 75 65 73 74 73 20 69 74 2c 20 62 79 20 70 72 65 73 73 69 6e 67 20 61 6e 20 69 6e ..requests.it,.by.pressing.an.in
32c00 63 6f 6d 70 6c 65 74 65 20 70 72 65 66 69 78 20 6b 65 79 20 73 65 71 75 65 6e 63 65 2e 0a 0a 20 complete.prefix.key.sequence....
32c20 20 2d 20 49 66 20 61 20 6e 75 6d 62 65 72 2c 20 74 68 65 6e 20 74 68 65 20 61 20 62 72 69 65 66 .-.If.a.number,.then.the.a.brief
32c40 20 6f 6e 65 2d 6c 69 6e 65 20 73 75 6d 6d 61 72 79 20 69 73 20 73 68 6f 77 6e 20 69 6e 73 74 65 .one-line.summary.is.shown.inste
32c60 61 64 20 6f 66 0a 20 20 20 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 49 66 20 7a ad.of.....the.menu.buffer...If.z
32c80 65 72 6f 20 6f 72 20 6e 65 67 61 74 69 76 65 2c 20 74 68 65 6e 20 6e 6f 74 20 65 76 65 6e 20 74 ero.or.negative,.then.not.even.t
32ca0 68 61 74 20 73 75 6d 6d 61 72 79 0a 20 20 20 20 69 73 20 73 68 6f 77 6e 3b 20 6f 6e 6c 79 20 74 hat.summary.....is.shown;.only.t
32cc0 68 65 20 70 72 65 73 73 65 64 20 6b 65 79 20 69 74 73 65 6c 66 20 69 73 20 73 68 6f 77 6e 2e 0a he.pressed.key.itself.is.shown..
32ce0 0a 20 20 20 20 54 68 65 20 62 75 66 66 65 72 20 69 73 20 73 68 6f 77 6e 20 6f 6e 63 65 20 74 68 .....The.buffer.is.shown.once.th
32d00 65 20 75 73 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 72 65 71 75 65 73 74 73 20 69 74 20 62 79 e.user.explicitly.requests.it.by
32d20 0a 20 20 20 20 70 72 65 73 73 69 6e 67 20 61 6e 20 69 6e 63 6f 6d 70 6c 65 74 65 20 70 72 65 66 .....pressing.an.incomplete.pref
32d40 69 78 20 6b 65 79 20 73 65 71 75 65 6e 63 65 2e 20 20 55 6e 6c 65 73 73 20 74 68 69 73 20 69 73 ix.key.sequence...Unless.this.is
32d60 20 7a 65 72 6f 2c 0a 20 20 20 20 74 68 65 20 6d 65 6e 75 20 69 73 20 73 68 6f 77 6e 20 61 66 74 .zero,.....the.menu.is.shown.aft
32d80 65 72 20 74 68 61 74 20 6d 61 6e 79 20 73 65 63 6f 6e 64 73 20 6f 66 20 69 6e 61 63 74 69 76 69 er.that.many.seconds.of.inactivi
32da0 74 79 20 28 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75 65 ty.(using.the.....absolute.value
32dc0 29 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f )...-.User.Option:.transient-sho
32de0 77 2d 64 75 72 69 6e 67 2d 6d 69 6e 69 62 75 66 66 65 72 2d 72 65 61 64 20 3a 3a 0a 0a 20 20 54 w-during-minibuffer-read.::....T
32e00 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 68 65 20 his.option.controls.whether.the.
32e20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 63 6f 6e 74 69 6e 75 65 73 20 74 6f 20 62 65 0a 20 transient.menu.continues.to.be..
32e40 20 64 69 73 70 6c 61 79 65 64 20 77 68 69 6c 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 .displayed.while.the.minibuffer.
32e60 69 73 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 75 73 65 72 20 69 6e 70 75 74 2e 0a 0a 20 20 54 is.used.to.read.user.input.....T
32e80 68 69 73 20 69 73 20 6f 6e 6c 79 20 72 65 6c 65 76 61 6e 74 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 his.is.only.relevant.to.commands
32ea0 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 63 6c 6f 73 65 20 74 68 65 20 6d 65 6e 75 2c 20 73 75 63 .that.do.not.close.the.menu,.suc
32ec0 68 20 61 73 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 73 65 74 20 69 6e 66 69 78 20 61 h.as...commands.that.set.infix.a
32ee0 72 67 75 6d 65 6e 74 73 2e 20 20 49 66 20 61 20 63 6f 6d 6d 61 6e 64 20 65 78 69 74 73 20 74 68 rguments...If.a.command.exits.th
32f00 65 20 6d 65 6e 75 2c 20 61 6e 64 0a 20 20 75 73 65 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 e.menu,.and...uses.the.minibuffe
32f20 72 2c 20 74 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 69 73 20 61 6c 77 61 79 73 20 63 6c 6f 73 65 r,.then.the.menu.is.always.close
32f40 64 20 62 65 66 6f 72 65 20 74 68 65 0a 20 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 65 6e 74 d.before.the...minibuffer.is.ent
32f60 65 72 65 64 2c 20 69 72 72 65 73 70 65 63 74 69 76 65 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 ered,.irrespective.of.the.value.
32f80 6f 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 2e 0a 0a 20 20 57 68 65 6e 20 7e 6e 69 6c 7e 20 28 74 of.this.option.....When.~nil~.(t
32fa0 68 65 20 64 65 66 61 75 6c 74 29 2c 20 68 69 64 65 20 74 68 65 20 6d 65 6e 75 20 77 68 69 6c 65 he.default),.hide.the.menu.while
32fc0 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 69 6e 20 75 73 65 2e 0a 20 20 57 68 65 .the.minibuffer.is.in.use....Whe
32fe0 6e 20 7e 74 7e 2c 20 6b 65 65 70 20 73 68 6f 77 69 6e 67 20 74 68 65 20 6d 65 6e 75 2c 20 62 75 n.~t~,.keep.showing.the.menu,.bu
33000 74 20 61 6c 6c 6f 77 20 66 6f 72 20 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 74 6f 20 62 t.allow.for.the.menu.window.to.b
33020 65 0a 20 20 72 65 73 69 7a 65 64 2c 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 20 63 6f 6d 70 e...resized,.to.ensure.that.comp
33040 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 63 61 6e 20 62 65 20 64 69 73 70 6c 61 79 letion.candidates.can.be.display
33060 65 64 2e 0a 0a 20 20 57 68 65 6e 20 7e 66 69 78 65 64 7e 2c 20 6b 65 65 70 20 73 68 6f 77 69 6e ed.....When.~fixed~,.keep.showin
33080 67 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 20 70 72 65 76 65 6e 74 20 69 74 20 66 72 6f 6d 20 62 g.the.menu.and.prevent.it.from.b
330a0 65 69 6e 67 20 72 65 73 69 7a 65 64 2c 0a 20 20 77 68 69 63 68 20 6d 61 79 20 6d 61 6b 65 20 69 eing.resized,...which.may.make.i
330c0 74 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 63 6f 6d 70 t.impossible.to.display.the.comp
330e0 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 2e 20 20 49 66 0a 20 20 74 68 61 74 20 65 76 letion.candidates...If...that.ev
33100 65 72 20 68 61 70 70 65 6e 73 20 66 6f 72 20 79 6f 75 2c 20 63 6f 6e 73 69 64 65 72 20 75 73 69 er.happens.for.you,.consider.usi
33120 6e 67 20 7e 74 7e 20 6f 72 20 61 6e 20 69 6e 74 65 67 65 72 2c 20 61 73 20 64 65 73 63 72 69 62 ng.~t~.or.an.integer,.as.describ
33140 65 64 0a 20 20 62 65 6c 6f 77 2e 0a 0a 20 20 49 66 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 7e ed...below.....If.the.value.is.~
33160 66 69 78 65 64 7e 20 61 6e 64 20 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 75 73 65 73 20 fixed~.and.the.menu.window.uses.
33180 74 68 65 20 66 75 6c 6c 20 68 65 69 67 68 74 20 6f 66 20 69 74 73 0a 20 20 66 72 61 6d 65 2c 20 the.full.height.of.its...frame,.
331a0 74 68 65 6e 20 74 68 65 20 66 6f 72 6d 65 72 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 72 then.the.former.is.ignored.and.r
331c0 65 73 69 7a 69 6e 67 20 69 73 20 61 6c 6c 6f 77 65 64 20 61 6e 79 77 61 79 2e 20 20 54 68 69 73 esizing.is.allowed.anyway...This
331e0 0a 20 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 62 65 63 61 75 73 65 20 69 6e 64 69 76 69 64 75 ...is.necessary.because.individu
33200 61 6c 20 6d 65 6e 75 73 20 6d 61 79 20 75 73 65 20 75 6e 75 73 75 61 6c 20 64 69 73 70 6c 61 79 al.menus.may.use.unusual.display
33220 20 61 63 74 69 6f 6e 73 0a 20 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 7e .actions...different.from.what.~
33240 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 7e transient-display-buffer-action~
33260 20 73 70 65 63 69 66 69 65 73 20 28 6c 69 6b 65 6c 79 0a 20 20 74 6f 20 64 69 73 70 6c 61 79 20 .specifies.(likely...to.display.
33280 74 68 61 74 20 6d 65 6e 75 20 69 6e 20 61 20 73 69 64 65 2d 77 69 6e 64 6f 77 29 2e 0a 0a 20 20 that.menu.in.a.side-window).....
332a0 57 68 65 6e 20 75 73 69 6e 67 20 61 20 74 68 69 72 64 2d 70 61 72 74 79 20 6d 6f 64 65 2c 20 77 When.using.a.third-party.mode,.w
332c0 68 69 63 68 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 73 69 7a 65 73 20 77 69 6e 64 6f hich.automatically.resizes.windo
332e0 77 73 0a 20 20 28 65 2e 67 2e 2c 20 62 79 20 63 61 6c 6c 69 6e 67 20 7e 62 61 6c 61 6e 63 65 2d ws...(e.g.,.by.calling.~balance-
33300 77 69 6e 64 6f 77 73 7e 20 6f 6e 20 7e 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 7e 29 windows~.on.~post-command-hook~)
33320 2c 20 74 68 65 6e 0a 20 20 7e 66 69 78 65 64 7e 20 28 6f 72 20 7e 6e 69 6c 7e 29 20 69 73 20 6c ,.then...~fixed~.(or.~nil~).is.l
33340 69 6b 65 6c 79 20 61 20 62 65 74 74 65 72 20 63 68 6f 69 63 65 20 74 68 61 6e 20 7e 74 7e 2e 0a ikely.a.better.choice.than.~t~..
33360 0a 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 6e 20 69 6e 74 65 ...The.value.can.also.be.an.inte
33380 67 65 72 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 ger,.in.which.case.the.behavior.
333a0 64 65 70 65 6e 64 73 20 6f 6e 0a 20 20 77 68 65 74 68 65 72 20 61 74 20 6c 65 61 73 74 20 74 68 depends.on...whether.at.least.th
333c0 61 74 20 6d 61 6e 79 20 6c 69 6e 65 73 20 61 72 65 20 6c 65 66 74 20 74 6f 20 64 69 73 70 6c 61 at.many.lines.are.left.to.displa
333e0 79 20 77 69 6e 64 6f 77 73 20 6f 74 68 65 72 20 74 68 61 6e 0a 20 20 74 68 65 20 6d 65 6e 75 20 y.windows.other.than...the.menu.
33400 77 69 6e 64 6f 77 2e 20 20 49 66 20 74 68 61 74 20 69 73 20 74 68 65 20 63 61 73 65 2c 20 64 69 window...If.that.is.the.case,.di
33420 73 70 6c 61 79 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 20 70 72 65 73 65 72 76 65 20 74 68 65 0a splay.the.menu.and.preserve.the.
33440 20 20 73 69 7a 65 20 6f 66 20 74 68 61 74 20 77 69 6e 64 6f 77 2e 20 20 4f 74 68 65 72 77 69 73 ..size.of.that.window...Otherwis
33460 65 2c 20 61 6c 6c 6f 77 20 72 65 73 69 7a 69 6e 67 20 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f e,.allow.resizing.the.menu.windo
33480 77 20 69 66 20 74 68 65 0a 20 20 6e 75 6d 62 65 72 20 69 73 20 70 6f 73 69 74 69 76 65 2c 20 6f w.if.the...number.is.positive,.o
334a0 72 20 68 69 64 65 20 74 68 65 20 6d 65 6e 75 20 69 66 20 69 74 20 69 73 20 6e 65 67 61 74 69 76 r.hide.the.menu.if.it.is.negativ
334c0 65 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 e...-.User.Option:.transient-rea
334e0 64 2d 77 69 74 68 2d 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 3a 3a 0a 0a 20 20 54 68 69 73 20 d-with-initial-input.::....This.
33500 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 68 65 20 6c 61 73 74 option.controls.whether.the.last
33520 20 68 69 73 74 6f 72 79 20 65 6c 65 6d 65 6e 74 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 0a .history.element.is.used.as.the.
33540 20 20 69 6e 69 74 69 61 6c 20 6d 69 6e 69 62 75 66 66 65 72 20 69 6e 70 75 74 20 77 68 65 6e 20 ..initial.minibuffer.input.when.
33560 72 65 61 64 69 6e 67 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 20 61 72 reading.the.value.of.an.infix.ar
33580 67 75 6d 65 6e 74 0a 20 20 66 72 6f 6d 20 74 68 65 20 75 73 65 72 2e 20 20 49 66 20 7e 6e 69 6c gument...from.the.user...If.~nil
335a0 7e 2c 20 74 68 65 72 65 20 69 73 20 6e 6f 20 69 6e 69 74 69 61 6c 20 69 6e 70 75 74 20 61 6e 64 ~,.there.is.no.initial.input.and
335c0 20 74 68 65 20 66 69 72 73 74 0a 20 20 65 6c 65 6d 65 6e 74 20 68 61 73 20 74 6f 20 62 65 20 61 .the.first...element.has.to.be.a
335e0 63 63 65 73 73 65 64 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 6f 6c 64 65 ccessed.the.same.way.as.the.olde
33600 72 20 65 6c 65 6d 65 6e 74 73 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e r.elements...-.User.Option:.tran
33620 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 20 3a 3a sient-enable-popup-navigation.::
33640 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 ....This.option.controls.whether
33660 20 6e 61 76 69 67 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 6e 61 62 6c 65 64 .navigation.commands.are.enabled
33680 20 69 6e 0a 20 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 .in...transient's.menu.buffer...
336a0 49 66 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 7e 76 65 72 62 6f 73 65 7e 20 28 74 68 65 20 64 If.the.value.is.~verbose~.(the.d
336c0 65 66 61 75 6c 74 29 2c 0a 20 20 62 72 69 65 66 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 efault),...brief.documentation.a
336e0 62 6f 75 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 75 6e 64 65 72 20 70 6f 69 6e 74 20 69 73 20 bout.the.command.under.point.is.
33700 61 64 64 69 74 69 6f 6e 61 6c 6c 79 0a 20 20 73 68 6f 77 20 69 6e 20 74 68 65 20 65 63 68 6f 20 additionally...show.in.the.echo.
33720 61 72 65 61 2e 0a 0a 20 20 57 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 area.....While.a.transient.is.ac
33740 74 69 76 65 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 20 74 68 65 20 tive.the.menu.buffer.is.not.the.
33760 63 75 72 72 65 6e 74 0a 20 20 62 75 66 66 65 72 2c 20 6d 61 6b 69 6e 67 20 69 74 20 6e 65 63 65 current...buffer,.making.it.nece
33780 73 73 61 72 79 20 74 6f 20 75 73 65 20 64 65 64 69 63 61 74 65 64 20 63 6f 6d 6d 61 6e 64 73 20 ssary.to.use.dedicated.commands.
337a0 74 6f 20 61 63 74 20 6f 6e 20 74 68 61 74 0a 20 20 62 75 66 66 65 72 20 69 74 73 65 6c 66 2e 20 to.act.on.that...buffer.itself..
337c0 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 .If.this.option.is.non-~nil~,.th
337e0 65 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 66 65 61 74 75 72 65 73 20 61 72 65 20 en.the.following...features.are.
33800 61 76 61 69 6c 61 62 6c 65 3a 0a 0a 20 20 2d 20 7b 7b 7b 6b 62 64 28 55 50 29 7d 7d 7d 20 6d 6f available:....-.{{{kbd(UP)}}}.mo
33820 76 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 ves.the.cursor.to.the.previous.s
33840 75 66 66 69 78 2e 0a 20 20 2d 20 7b 7b 7b 6b 62 64 28 44 4f 57 4e 29 7d 7d 7d 20 6d 6f 76 65 73 uffix....-.{{{kbd(DOWN)}}}.moves
33860 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 73 75 66 66 69 78 2e 0a .the.cursor.to.the.next.suffix..
33880 20 20 2d 20 7b 7b 7b 6b 62 64 28 4d 2d 52 45 54 29 7d 7d 7d 20 69 6e 76 6f 6b 65 73 20 74 68 65 ..-.{{{kbd(M-RET)}}}.invokes.the
338a0 20 73 75 66 66 69 78 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 6f 6e 2e 0a 20 20 2d 20 7b 7b .suffix.the.cursor.is.on....-.{{
338c0 7b 6b 62 64 28 6d 6f 75 73 65 2d 31 29 7d 7d 7d 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 63 6c 69 {kbd(mouse-1)}}}.invokes.the.cli
338e0 63 6b 65 64 20 6f 6e 20 73 75 66 66 69 78 2e 0a 20 20 2d 20 7b 7b 7b 6b 62 64 28 43 2d 73 29 7d cked.on.suffix....-.{{{kbd(C-s)}
33900 7d 7d 20 61 6e 64 20 7b 7b 7b 6b 62 64 28 43 2d 72 29 7d 7d 7d 20 73 74 61 72 74 20 69 73 65 61 }}.and.{{{kbd(C-r)}}}.start.isea
33920 72 63 68 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 20 20 42 79 20 64 65 rch.in.the.menu.buffer.....By.de
33940 66 61 75 6c 74 20 7b 7b 7b 6b 62 64 28 4d 2d 52 45 54 29 7d 7d 7d 20 69 73 20 62 6f 75 6e 64 20 fault.{{{kbd(M-RET)}}}.is.bound.
33960 74 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 7e 2c 20 69 6e 73 74 to.~transient-push-button~,.inst
33980 65 61 64 20 6f 66 0a 20 20 7b 7b 7b 6b 62 64 28 52 45 54 29 7d 7d 7d 2c 20 62 65 63 61 75 73 65 ead.of...{{{kbd(RET)}}},.because
339a0 20 69 66 20 61 20 74 72 61 6e 73 69 65 6e 74 20 61 6c 6c 6f 77 73 20 74 68 65 20 69 6e 76 6f 63 .if.a.transient.allows.the.invoc
339c0 61 74 69 6f 6e 20 6f 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 2c 0a 20 20 74 68 65 6e 20 69 74 ation.of.non-suffixes,...then.it
339e0 20 69 73 20 6c 69 6b 65 6c 79 2c 20 74 68 61 74 20 79 6f 75 20 77 6f 75 6c 64 20 77 61 6e 74 20 .is.likely,.that.you.would.want.
33a00 7b 7b 7b 6b 62 64 28 52 45 54 29 7d 7d 7d 20 74 6f 20 64 6f 20 77 68 61 74 20 69 74 20 77 6f 75 {{{kbd(RET)}}}.to.do.what.it.wou
33a20 6c 64 20 64 6f 0a 20 20 69 66 20 6e 6f 20 74 72 61 6e 73 69 65 6e 74 20 77 65 72 65 20 61 63 74 ld.do...if.no.transient.were.act
33a40 69 76 65 2e 22 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d ive."..-.User.Option:.transient-
33a60 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 20 3a 3a 0a 0a 20 20 54 68 69 73 display-buffer-action.::....This
33a80 20 6f 70 74 69 6f 6e 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 61 63 74 69 6f 6e 20 75 73 65 .option.specifies.the.action.use
33aa0 64 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 0a 20 20 6d d.to.display.the.transient's...m
33ac0 65 6e 75 20 62 75 66 66 65 72 2e 20 20 54 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 enu.buffer...The.menu.buffer.is.
33ae0 64 69 73 70 6c 61 79 65 64 20 69 6e 20 61 20 77 69 6e 64 6f 77 20 75 73 69 6e 67 0a 20 20 7b 7b displayed.in.a.window.using...{{
33b00 7b 63 6f 64 65 76 61 72 28 28 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 20 42 55 46 46 45 52 20 {codevar((display-buffer.BUFFER.
33b20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 29 transient-display-buffer-action)
33b40 29 7d 7d 7d 2e 0a 0a 20 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 74 69 6f )}}}.....The.value.of.this.optio
33b60 6e 20 68 61 73 20 74 68 65 20 66 6f 72 6d 20 7b 7b 7b 63 6f 64 65 76 61 72 28 28 46 55 4e 43 54 n.has.the.form.{{{codevar((FUNCT
33b80 49 4f 4e 20 2e 20 41 4c 49 53 54 29 29 7d 7d 7d 2c 0a 20 20 77 68 65 72 65 20 7b 7b 7b 76 61 72 ION...ALIST))}}},...where.{{{var
33ba0 28 46 55 4e 43 54 49 4f 4e 29 7d 7d 7d 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 6f 72 20 61 (FUNCTION)}}}.is.a.function.or.a
33bc0 20 6c 69 73 74 20 6f 66 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 45 61 63 68 20 73 75 63 68 0a 20 .list.of.functions...Each.such..
33be0 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 63 63 65 70 74 20 74 77 6f 20 61 72 67 75 .function.should.accept.two.argu
33c00 6d 65 6e 74 73 3a 20 61 20 62 75 66 66 65 72 20 74 6f 20 64 69 73 70 6c 61 79 20 61 6e 64 20 61 ments:.a.buffer.to.display.and.a
33c20 6e 0a 20 20 61 6c 69 73 74 20 6f 66 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 7b 7b n...alist.of.the.same.form.as.{{
33c40 7b 76 61 72 28 41 4c 49 53 54 29 7d 7d 7d 2e 20 20 53 65 65 20 5b 5b 69 6e 66 6f 3a 65 6c 69 73 {var(ALIST)}}}...See.[[info:elis
33c60 70 23 43 68 6f 6f 73 69 6e 67 20 57 69 6e 64 6f 77 5d 5d 2c 0a 20 20 66 6f 72 20 64 65 74 61 69 p#Choosing.Window]],...for.detai
33c80 6c 73 2e 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 3a 0a 0a 20 20 23 2b 42 45 47 49 ls.....The.default.is:....#+BEGI
33ca0 4e 5f 53 52 43 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 64 69 73 70 6c 61 79 2d 62 75 N_SRC.emacs-lisp.....(display-bu
33cc0 66 66 65 72 2d 69 6e 2d 73 69 64 65 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 28 73 69 64 65 20 2e ffer-in-side-window......(side..
33ce0 20 62 6f 74 74 6f 6d 29 0a 20 20 20 20 20 28 64 65 64 69 63 61 74 65 64 20 2e 20 74 29 0a 20 20 .bottom)......(dedicated...t)...
33d00 20 20 20 28 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 20 2e 20 74 29 29 0a 20 20 ...(inhibit-same-window...t))...
33d20 23 2b 45 4e 44 5f 53 52 43 0a 0a 20 20 54 68 69 73 20 64 69 73 70 6c 61 79 73 20 74 68 65 20 77 #+END_SRC....This.displays.the.w
33d40 69 6e 64 6f 77 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 20 74 68 65 20 73 65 6c 65 63 indow.at.the.bottom.of.the.selec
33d60 74 65 64 20 66 72 61 6d 65 2e 0a 20 20 46 6f 72 20 61 6c 74 65 72 6e 61 74 69 76 65 73 20 73 65 ted.frame....For.alternatives.se
33d80 65 20 5b 5b 69 6e 66 6f 3a 65 6c 69 73 70 23 42 75 66 66 65 72 20 44 69 73 70 6c 61 79 20 41 63 e.[[info:elisp#Buffer.Display.Ac
33da0 74 69 6f 6e 20 46 75 6e 63 74 69 6f 6e 73 5d 5d 2c 0a 20 20 61 6e 64 20 5b 5b 69 6e 66 6f 3a 65 tion.Functions]],...and.[[info:e
33dc0 6c 69 73 70 23 42 75 66 66 65 72 20 44 69 73 70 6c 61 79 20 41 63 74 69 6f 6e 20 41 6c 69 73 74 lisp#Buffer.Display.Action.Alist
33de0 73 5d 5d 2e 0a 0a 20 20 57 68 65 6e 20 79 6f 75 20 73 77 69 74 63 68 20 74 6f 20 61 20 64 69 66 s]].....When.you.switch.to.a.dif
33e00 66 65 72 65 6e 74 20 41 43 54 49 4f 4e 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20 6b 65 65 70 20 74 ferent.ACTION,.you.should.keep.t
33e20 68 65 20 41 4c 49 53 54 0a 20 20 65 6e 74 72 69 65 73 20 66 6f 72 20 7e 64 65 64 69 63 61 74 65 he.ALIST...entries.for.~dedicate
33e40 64 7e 20 61 6e 64 20 7e 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 7e 20 69 6e 20 d~.and.~inhibit-same-window~.in.
33e60 6d 6f 73 74 20 63 61 73 65 73 2e 0a 20 20 44 6f 20 6e 6f 74 20 64 72 6f 70 20 74 68 65 6d 20 62 most.cases....Do.not.drop.them.b
33e80 65 63 61 75 73 65 20 79 6f 75 20 61 72 65 20 75 6e 73 75 72 65 20 77 68 65 74 68 65 72 20 74 68 ecause.you.are.unsure.whether.th
33ea0 65 79 20 61 72 65 20 6e 65 65 64 65 64 3b 0a 20 20 69 66 20 79 6f 75 20 61 72 65 20 75 6e 73 75 ey.are.needed;...if.you.are.unsu
33ec0 72 65 2c 20 74 68 65 6e 20 6b 65 65 70 20 74 68 65 6d 2e 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 re,.then.keep.them.....Note.that
33ee0 20 74 68 65 20 62 75 66 66 65 72 20 74 68 61 74 20 77 61 73 20 63 75 72 72 65 6e 74 20 62 65 66 .the.buffer.that.was.current.bef
33f00 6f 72 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 0a 20 20 69 73 20 73 68 ore.the.transient.buffer...is.sh
33f20 6f 77 6e 20 73 68 6f 75 6c 64 20 72 65 6d 61 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 own.should.remain.the.current.bu
33f40 66 66 65 72 2e 20 20 4d 61 6e 79 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 61 63 ffer...Many.suffix.commands...ac
33f60 74 20 6f 6e 20 74 68 65 20 74 68 69 6e 67 20 61 74 20 70 6f 69 6e 74 2c 20 69 66 20 61 70 70 72 t.on.the.thing.at.point,.if.appr
33f80 6f 70 72 69 61 74 65 2c 20 61 6e 64 20 69 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 opriate,.and.if.the.transient...
33fa0 62 75 66 66 65 72 20 62 65 63 61 6d 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 buffer.became.the.current.buffer
33fc0 2c 20 74 68 65 6e 20 74 68 61 74 20 77 6f 75 6c 64 20 63 68 61 6e 67 65 20 77 68 61 74 20 69 73 ,.then.that.would.change.what.is
33fe0 0a 20 20 61 74 20 70 6f 69 6e 74 2e 20 20 54 6f 20 74 68 61 74 20 65 66 66 65 63 74 20 7e 69 6e ...at.point...To.that.effect.~in
34000 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 7e 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 hibit-same-window~.ensures.that.
34020 74 68 65 0a 20 20 73 65 6c 65 63 74 65 64 20 77 69 6e 64 6f 77 20 69 73 20 6e 6f 74 20 75 73 65 the...selected.window.is.not.use
34040 64 20 74 6f 20 73 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 0a d.to.show.the.transient.buffer..
34060 0a 20 20 49 74 20 6d 61 79 20 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 69 73 70 6c 61 79 ...It.may.be.possible.to.display
34080 20 74 68 65 20 77 69 6e 64 6f 77 20 69 6e 20 61 6e 6f 74 68 65 72 20 66 72 61 6d 65 2c 20 62 75 .the.window.in.another.frame,.bu
340a0 74 0a 20 20 77 68 65 74 68 65 72 20 74 68 61 74 20 77 6f 72 6b 73 20 69 6e 20 70 72 61 63 74 69 t...whether.that.works.in.practi
340c0 63 65 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 77 69 6e 64 6f 77 2d 6d 61 6e 61 67 65 72 ce.depends.on.the.window-manager
340e0 2e 0a 20 20 49 66 20 74 68 65 20 77 69 6e 64 6f 77 20 6d 61 6e 61 67 65 72 20 73 65 6c 65 63 74 ....If.the.window.manager.select
34100 73 20 74 68 65 20 6e 65 77 20 77 69 6e 64 6f 77 20 28 45 6d 61 63 73 20 66 72 61 6d 65 29 2c 0a s.the.new.window.(Emacs.frame),.
34120 20 20 74 68 65 6e 20 74 68 61 74 20 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 63 68 61 6e 67 65 ..then.that.unfortunately.change
34140 73 20 77 68 69 63 68 20 62 75 66 66 65 72 20 69 73 20 63 75 72 72 65 6e 74 2e 0a 0a 20 20 49 66 s.which.buffer.is.current.....If
34160 20 79 6f 75 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 .you.change.the.value.of.this.op
34180 74 69 6f 6e 2c 20 74 68 65 6e 20 79 6f 75 20 6d 69 67 68 74 20 61 6c 73 6f 0a 20 20 77 61 6e 74 tion,.then.you.might.also...want
341a0 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 7e 74 72 61 6e 73 69 65 .to.change.the.value.of.~transie
341c0 6e 74 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 7e 2e 0a 0a 20 20 54 68 69 73 20 75 73 nt-mode-line-format~.....This.us
341e0 65 72 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 69 66 20 7e er.option.may.be.overridden.if.~
34200 3a 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 7e 20 69 73 20 70 61 73 73 65 64 0a 20 20 77 68 65 :display-action~.is.passed...whe
34220 6e 20 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 70 72 65 66 69 78 20 77 69 74 68 20 7e 74 72 n.creating.a.new.prefix.with.~tr
34240 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e 0a 0a 2a 2a 2a 20 41 63 63 ansient-define-prefix~...***.Acc
34260 65 73 73 69 62 69 6c 69 74 79 20 4f 70 74 69 6f 6e 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a essibility.Options.:PROPERTIES:.
34280 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 55 73 65 72 :UNNUMBERED:.notoc.:END:..-.User
342a0 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 73 69 6e 67 6c 65 2d .Option:.transient-force-single-
342c0 63 6f 6c 75 6d 6e 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c column.::....This.option.control
342e0 73 20 77 68 65 74 68 65 72 20 74 68 65 20 75 73 65 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 63 6f s.whether.the.use.of.a.single.co
34300 6c 75 6d 6e 20 74 6f 20 64 69 73 70 6c 61 79 0a 20 20 73 75 66 66 69 78 65 73 20 69 73 20 65 6e lumn.to.display...suffixes.is.en
34320 66 6f 72 63 65 64 2e 20 20 54 68 69 73 20 6d 69 67 68 74 20 62 65 20 75 73 65 66 75 6c 20 66 6f forced...This.might.be.useful.fo
34340 72 20 75 73 65 72 73 20 77 69 74 68 20 6c 6f 77 0a 20 20 76 69 73 69 6f 6e 20 77 68 6f 20 75 73 r.users.with.low...vision.who.us
34360 65 20 6c 61 72 67 65 20 74 65 78 74 20 61 6e 64 20 6d 69 67 68 74 20 6f 74 68 65 72 77 69 73 65 e.large.text.and.might.otherwise
34380 20 68 61 76 65 20 74 6f 20 73 63 72 6f 6c 6c 20 69 6e 20 74 77 6f 0a 20 20 64 69 6d 65 6e 73 69 .have.to.scroll.in.two...dimensi
343a0 6f 6e 73 2e 0a 0a 2a 2a 2a 20 41 75 78 69 6c 69 61 72 79 20 4f 70 74 69 6f 6e 73 0a 3a 50 52 4f ons...***.Auxiliary.Options.:PRO
343c0 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 PERTIES:.:UNNUMBERED:.notoc.:END
343e0 3a 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 6d 6f 64 65 :..-.User.Option:.transient-mode
34400 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 -line-format.::....This.option.c
34420 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 ontrols.whether.transient's.menu
34440 20 62 75 66 66 65 72 20 68 61 73 20 61 0a 20 20 6d 6f 64 65 2d 6c 69 6e 65 2c 20 73 65 70 61 72 .buffer.has.a...mode-line,.separ
34460 61 74 6f 72 20 6c 69 6e 65 2c 20 6f 72 20 6e 65 69 74 68 65 72 2e 0a 0a 20 20 49 66 20 7e 6e 69 ator.line,.or.neither.....If.~ni
34480 6c 7e 2c 20 74 68 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 68 61 73 20 6e 6f 20 6d 6f 64 65 2d l~,.then.the.buffer.has.no.mode-
344a0 6c 69 6e 65 2e 20 20 49 66 20 74 68 65 20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 0a 20 20 64 69 line...If.the.buffer.is.not...di
344c0 73 70 6c 61 79 65 64 20 72 69 67 68 74 20 61 62 6f 76 65 20 74 68 65 20 65 63 68 6f 20 61 72 65 splayed.right.above.the.echo.are
344e0 61 2c 20 74 68 65 6e 20 74 68 69 73 20 70 72 6f 62 61 62 6c 79 20 69 73 20 6e 6f 74 20 61 0a 20 a,.then.this.probably.is.not.a..
34500 20 67 6f 6f 64 20 76 61 6c 75 65 2e 0a 0a 20 20 49 66 20 7e 6c 69 6e 65 7e 20 28 74 68 65 20 64 .good.value.....If.~line~.(the.d
34520 65 66 61 75 6c 74 29 20 6f 72 20 61 20 6e 61 74 75 72 61 6c 20 6e 75 6d 62 65 72 2c 20 74 68 65 efault).or.a.natural.number,.the
34540 6e 20 74 68 65 20 62 75 66 66 65 72 20 68 61 73 20 6e 6f 0a 20 20 6d 6f 64 65 2d 6c 69 6e 65 2c n.the.buffer.has.no...mode-line,
34560 20 62 75 74 20 61 20 6c 69 6e 65 20 69 73 20 64 72 61 77 6e 20 69 6e 20 69 74 73 20 70 6c 61 63 .but.a.line.is.drawn.in.its.plac
34580 65 2e 20 20 49 66 20 61 20 6e 75 6d 62 65 72 20 69 73 20 75 73 65 64 2c 0a 20 20 74 68 61 74 20 e...If.a.number.is.used,...that.
345a0 73 70 65 63 69 66 69 65 73 20 74 68 65 20 74 68 69 63 6b 6e 65 73 73 20 6f 66 20 74 68 65 20 6c specifies.the.thickness.of.the.l
345c0 69 6e 65 2e 20 20 4f 6e 20 74 65 72 6d 63 61 70 20 66 72 61 6d 65 73 20 77 65 0a 20 20 63 61 6e ine...On.termcap.frames.we...can
345e0 6e 6f 74 20 64 72 61 77 20 6c 69 6e 65 73 2c 20 73 6f 20 74 68 65 72 65 20 7e 6c 69 6e 65 7e 20 not.draw.lines,.so.there.~line~.
34600 61 6e 64 20 6e 75 6d 62 65 72 73 20 61 72 65 20 73 79 6e 6f 6e 79 6d 73 20 66 6f 72 20 7e 6e 69 and.numbers.are.synonyms.for.~ni
34620 6c 7e 2e 0a 0a 20 20 54 68 65 20 63 6f 6c 6f 72 20 6f 66 20 74 68 65 20 6c 69 6e 65 20 69 73 20 l~.....The.color.of.the.line.is.
34640 75 73 65 64 20 74 6f 20 69 6e 64 69 63 61 74 65 20 69 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 used.to.indicate.if.non-suffixes
34660 20 61 72 65 0a 20 20 61 6c 6c 6f 77 65 64 20 61 6e 64 20 77 68 65 74 68 65 72 20 74 68 65 79 20 .are...allowed.and.whether.they.
34680 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 54 68 65 20 66 6f 72 65 67 72 6f exit.the.transient...The.foregro
346a0 75 6e 64 0a 20 20 63 6f 6c 6f 72 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f und...color.of.~transient-key-no
346c0 6f 70 7e 20 28 69 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 61 72 65 20 64 69 73 61 6c 6c 6f op~.(if.non-suffixes.are.disallo
346e0 77 65 64 29 2c 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 79 7e 20 28 69 66 wed),...~transient-key-stay~.(if
34700 20 61 6c 6c 6f 77 65 64 20 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 79 73 20 61 63 74 .allowed.and.transient.stays.act
34720 69 76 65 29 2c 20 6f 72 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 65 78 69 74 7e 20 ive),.or...~transient-key-exit~.
34740 28 69 66 20 61 6c 6c 6f 77 65 64 20 61 6e 64 20 74 68 65 79 20 65 78 69 74 20 74 68 65 20 74 72 (if.allowed.and.they.exit.the.tr
34760 61 6e 73 69 65 6e 74 29 20 69 73 0a 20 20 75 73 65 64 20 74 6f 20 64 72 61 77 20 74 68 65 20 6c ansient).is...used.to.draw.the.l
34780 69 6e 65 2e 0a 0a 20 20 54 68 69 73 20 75 73 65 72 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62 65 20 ine.....This.user.option.may.be.
347a0 6f 76 65 72 72 69 64 64 65 6e 20 69 66 20 7e 3a 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 overridden.if.~:mode-line-format
347c0 7e 20 69 73 20 70 61 73 73 65 64 0a 20 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 20 6e 65 ~.is.passed...when.creating.a.ne
347e0 77 20 70 72 65 66 69 78 20 77 69 74 68 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d w.prefix.with.~transient-define-
34800 70 72 65 66 69 78 7e 2e 0a 0a 20 20 4f 74 68 65 72 77 69 73 65 20 74 68 69 73 20 63 61 6e 20 62 prefix~.....Otherwise.this.can.b
34820 65 20 61 6e 79 20 6d 6f 64 65 2d 6c 69 6e 65 20 66 6f 72 6d 61 74 2e 20 20 53 65 65 20 5b 5b 69 e.any.mode-line.format...See.[[i
34840 6e 66 6f 3a 65 6c 69 73 70 23 4d 6f 64 65 0a 20 20 4c 69 6e 65 20 46 6f 72 6d 61 74 5d 5d 2c 20 nfo:elisp#Mode...Line.Format]],.
34860 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 for.details...-.User.Option:.tra
34880 6e 73 69 65 6e 74 2d 73 65 6d 61 6e 74 69 63 2d 63 6f 6c 6f 72 69 6e 67 20 3a 3a 0a 0a 20 20 54 nsient-semantic-coloring.::....T
348a0 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 63 6f 6c 6f his.option.controls.whether.colo
348c0 72 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 65 0a 20 20 74 72 rs.are.used.to.indicate.the...tr
348e0 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 ansient.behavior.of.commands....
34900 20 49 66 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 65 6e 20 74 68 65 20 6b 65 79 20 62 69 6e 64 .If.non-~nil~,.then.the.key.bind
34920 69 6e 67 20 6f 66 20 65 61 63 68 20 73 75 66 66 69 78 20 69 73 20 63 6f 6c 6f 72 69 7a 65 64 20 ing.of.each.suffix.is.colorized.
34940 74 6f 0a 20 20 69 6e 64 69 63 61 74 65 20 77 68 65 74 68 65 72 20 69 74 20 65 78 69 74 73 20 74 to...indicate.whether.it.exits.t
34960 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 6f 72 20 6e 6f 74 2e 20 20 54 68 65 20 he.transient.state.or.not...The.
34980 63 6f 6c 6f 72 20 6f 66 0a 20 20 74 68 65 20 70 72 65 66 69 78 20 69 73 20 69 6e 64 69 63 61 74 color.of...the.prefix.is.indicat
349a0 65 64 20 75 73 69 6e 67 20 74 68 65 20 6c 69 6e 65 20 74 68 61 74 20 69 73 20 64 72 61 77 6e 20 ed.using.the.line.that.is.drawn.
349c0 77 68 65 6e 20 74 68 65 20 76 61 6c 75 65 0a 20 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6d when.the.value...of.~transient-m
349e0 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 7e 20 69 73 20 7e 6c 69 6e 65 7e 2e 0a 0a 2d 20 55 ode-line-format~.is.~line~...-.U
34a00 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d ser.Option:.transient-highlight-
34a20 6d 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 73 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f mismatched-keys.::....This.optio
34a40 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 n.controls.whether.key.bindings.
34a60 6f 66 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 0a 20 20 6e 6f 74 20 of.infix.commands.that.do...not.
34a80 6d 61 74 63 68 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e match.the.respective.command-lin
34aa0 65 20 61 72 67 75 6d 65 6e 74 20 73 68 6f 75 6c 64 20 62 65 20 68 69 67 68 6c 69 67 68 74 65 64 e.argument.should.be.highlighted
34ac0 2e 0a 20 20 46 6f 72 20 6f 74 68 65 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 69 ....For.other.infix.commands.thi
34ae0 73 20 6f 70 74 69 6f 6e 20 68 61 73 20 6e 6f 20 65 66 66 65 63 74 2e 0a 0a 20 20 57 68 65 6e 20 s.option.has.no.effect.....When.
34b00 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 65 20 6b 65 this.option.is.non-~nil~,.the.ke
34b20 79 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 0a y.binding.for.an.infix.argument.
34b40 20 20 69 73 20 68 69 67 68 6c 69 67 68 74 65 64 20 77 68 65 6e 20 6f 6e 6c 79 20 61 20 6c 6f 6e ..is.highlighted.when.only.a.lon
34b60 67 20 61 72 67 75 6d 65 6e 74 20 28 65 2e 67 2e 2c 20 7e 2d 2d 76 65 72 62 6f 73 65 7e 29 20 69 g.argument.(e.g.,.~--verbose~).i
34b80 73 0a 20 20 73 70 65 63 69 66 69 65 64 20 62 75 74 20 6e 6f 20 73 68 6f 72 74 68 61 6e 64 20 28 s...specified.but.no.shorthand.(
34ba0 65 2e 67 2e 2c 20 7e 2d 76 7e 29 2e 20 20 49 6e 20 74 68 65 20 72 61 72 65 20 63 61 73 65 20 74 e.g.,.~-v~)...In.the.rare.case.t
34bc0 68 61 74 20 61 0a 20 20 73 68 6f 72 74 68 61 6e 64 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62 hat.a...shorthand.is.specified.b
34be0 75 74 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 ut.the.key.binding.does.not.matc
34c00 68 2c 20 74 68 65 6e 20 69 74 0a 20 20 69 73 20 68 69 67 68 6c 69 67 68 74 65 64 20 64 69 66 66 h,.then.it...is.highlighted.diff
34c20 65 72 65 6e 74 6c 79 2e 0a 0a 20 20 48 69 67 68 6c 69 67 68 74 69 6e 67 20 6d 69 73 6d 61 74 63 erently.....Highlighting.mismatc
34c40 68 65 64 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 hed.key.bindings.is.useful.when.
34c60 6c 65 61 72 6e 69 6e 67 20 74 68 65 0a 20 20 61 72 67 75 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 learning.the...arguments.of.the.
34c80 75 6e 64 65 72 6c 79 69 6e 67 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 74 6f 6f 6c 3b 20 79 6f underlying.command-line.tool;.yo
34ca0 75 20 77 6f 75 6c 64 6e 27 74 20 77 61 6e 74 20 74 6f 0a 20 20 6c 65 61 72 6e 20 61 6e 79 20 73 u.wouldn't.want.to...learn.any.s
34cc0 68 6f 72 74 2d 68 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 hort-hands.that.do.not.actually.
34ce0 65 78 69 73 74 2e 0a 0a 20 20 54 68 65 20 68 69 67 68 6c 69 67 68 74 69 6e 67 20 69 73 20 64 6f exist.....The.highlighting.is.do
34d00 6e 65 20 75 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 61 63 65 73 0a 20 20 7e 74 72 61 ne.using.one.of.the.faces...~tra
34d20 6e 73 69 65 6e 74 2d 6d 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 7e 20 61 6e 64 20 7e 74 72 61 6e nsient-mismatched-key~.and.~tran
34d40 73 69 65 6e 74 2d 6e 6f 6e 73 74 61 6e 64 61 72 64 2d 6b 65 79 7e 2e 0a 0a 2d 20 55 73 65 72 20 sient-nonstandard-key~...-.User.
34d60 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 Option:.transient-substitute-key
34d80 2d 66 75 6e 63 74 69 6f 6e 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 -function.::....This.function.is
34da0 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 20 20 49 .used.to.modify.key.bindings...I
34dc0 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 0a 20 20 6f 70 74 69 6f 6e 20 69 73 20 f.the.value.of.this...option.is.
34de0 7e 6e 69 6c 7e 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 20 74 68 65 6e 20 6e 6f 20 73 75 62 ~nil~.(the.default),.then.no.sub
34e00 73 74 69 74 75 74 69 6f 6e 20 69 73 20 70 65 72 66 6f 72 6d 65 64 2e 0a 0a 20 20 54 68 69 73 20 stitution.is.performed.....This.
34e20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 6f 6e 65 20 61 72 67 75 function.is.called.with.one.argu
34e40 6d 65 6e 74 2c 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 2c 20 61 6e 64 0a 20 20 6d ment,.the.prefix.object,.and...m
34e60 75 73 74 20 72 65 74 75 72 6e 20 61 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 64 65 73 63 72 69 70 ust.return.a.key.binding.descrip
34e80 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 74 68 65 20 65 78 69 73 74 69 6e 67 20 6b 65 79 0a 20 20 tion,.either.the.existing.key...
34ea0 64 65 73 63 72 69 70 74 69 6f 6e 20 69 74 20 66 69 6e 64 73 20 69 6e 20 74 68 65 20 7e 6b 65 79 description.it.finds.in.the.~key
34ec0 7e 20 73 6c 6f 74 2c 20 6f 72 20 74 68 65 20 6b 65 79 20 64 65 73 63 72 69 70 74 69 6f 6e 20 74 ~.slot,.or.the.key.description.t
34ee0 68 61 74 0a 20 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 2e 20 20 hat...replaces.the.prefix.key...
34f00 49 74 20 63 6f 75 6c 64 20 62 65 20 75 73 65 64 20 74 6f 20 6d 61 6b 65 20 6f 74 68 65 72 0a 20 It.could.be.used.to.make.other..
34f20 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73 2c 20 62 75 74 20 74 68 61 74 20 69 73 20 64 69 73 63 .substitutions,.but.that.is.disc
34f40 6f 75 72 61 67 65 64 2e 0a 0a 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 7b 7b 7b 6b 62 64 28 ouraged.....For.example,.{{{kbd(
34f60 3d 29 7d 7d 7d 20 69 73 20 68 61 72 64 20 74 6f 20 72 65 61 63 68 20 75 73 69 6e 67 20 6d 79 20 =)}}}.is.hard.to.reach.using.my.
34f80 63 75 73 74 6f 6d 20 6b 65 79 62 6f 61 72 64 20 6c 61 79 6f 75 74 2c 0a 20 20 73 6f 20 49 20 73 custom.keyboard.layout,...so.I.s
34fa0 75 62 73 74 69 74 75 74 65 20 7b 7b 7b 6b 62 64 28 28 29 7d 7d 7d 20 66 6f 72 20 74 68 61 74 2c ubstitute.{{{kbd(()}}}.for.that,
34fc0 20 77 68 69 63 68 20 69 73 20 65 61 73 79 20 74 6f 20 72 65 61 63 68 20 75 73 69 6e 67 20 61 20 .which.is.easy.to.reach.using.a.
34fe0 6c 61 79 6f 75 74 0a 20 20 6f 70 74 69 6d 69 7a 65 64 20 66 6f 72 20 6c 69 73 70 2e 0a 0a 20 20 layout...optimized.for.lisp.....
35000 23 2b 42 45 47 49 4e 5f 53 52 43 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 73 65 74 71 #+BEGIN_SRC.emacs-lisp.....(setq
35020 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 .transient-substitute-key-functi
35040 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 6f 62 6a 29 0a 20 20 20 20 20 on...........(lambda.(obj)......
35060 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 6f 72 65 66 20 6f 62 6a 20 6b 65 79 29 .......(let.((key.(oref.obj.key)
35080 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 73 74 72 69 6e 67 2d 6d 61 74 ))...............(if.(string-mat
350a0 63 68 20 22 5c 5c 60 5c 5c 28 3d 5c 5c 29 5b 61 2d 7a 41 2d 5a 5d 22 20 6b 65 79 29 0a 20 20 20 ch."\\`\\(=\\)[a-zA-Z]".key)....
350c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 70 6c 61 63 65 2d 6d 61 74 63 68 20 22 28 ...............(replace-match."(
350e0 22 20 74 20 74 20 6b 65 79 20 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6b 65 79 ".t.t.key.1).................key
35100 29 29 29 29 0a 20 20 23 2b 45 4e 44 5f 53 52 43 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a ))))...#+END_SRC..-.User.Option:
35120 20 74 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 .transient-align-variable-pitch.
35140 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 ::....This.option.controls.wheth
35160 65 72 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 61 6c 69 67 6e 65 64 20 70 69 78 65 6c 2d 77 69 73 er.columns.are.aligned.pixel-wis
35180 65 20 69 6e 20 74 68 65 0a 20 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 20 20 49 66 20 74 68 e.in.the...menu.buffer.....If.th
351a0 69 73 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 65 6e 20 63 6f 6c 75 6d 6e 73 20 61 72 is.is.non-~nil~,.then.columns.ar
351c0 65 20 61 6c 69 67 6e 65 64 20 70 69 78 65 6c 2d 77 69 73 65 20 74 6f 20 73 75 70 70 6f 72 74 0a e.aligned.pixel-wise.to.support.
351e0 20 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 66 6f 6e 74 73 2e 20 20 4b 65 79 73 20 61 72 ..variable-pitch.fonts...Keys.ar
35200 65 20 6e 6f 74 20 61 6c 69 67 6e 65 64 2c 20 73 6f 20 79 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 e.not.aligned,.so.you.should.use
35220 20 61 0a 20 20 66 69 78 65 64 2d 70 69 74 63 68 20 66 6f 6e 74 20 66 6f 72 20 74 68 65 20 7e 74 .a...fixed-pitch.font.for.the.~t
35240 72 61 6e 73 69 65 6e 74 2d 6b 65 79 7e 20 66 61 63 65 2e 20 20 4f 74 68 65 72 20 6b 65 79 20 66 ransient-key~.face...Other.key.f
35260 61 63 65 73 0a 20 20 69 6e 68 65 72 69 74 20 66 72 6f 6d 20 74 68 61 74 20 66 61 63 65 20 75 6e aces...inherit.from.that.face.un
35280 6c 65 73 73 20 61 20 74 68 65 6d 65 20 69 73 20 75 73 65 64 20 74 68 61 74 20 62 72 65 61 6b 73 less.a.theme.is.used.that.breaks
352a0 20 74 68 61 74 0a 20 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 2e 0a 0a 20 20 54 68 69 73 20 6f 70 .that...relationship.....This.op
352c0 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 72 73 20 77 68 6f 20 75 tion.is.intended.for.users.who.u
352e0 73 65 20 61 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 66 6f 6e 74 20 66 6f 72 0a 20 20 74 se.a.variable-pitch.font.for...t
35300 68 65 20 7e 64 65 66 61 75 6c 74 7e 20 66 61 63 65 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f he.~default~.face...-.User.Optio
35320 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 20 3a n:.transient-force-fixed-pitch.:
35340 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 :....This.option.controls.whethe
35360 72 20 74 6f 20 66 6f 72 63 65 20 74 68 65 20 75 73 65 20 6f 66 20 61 20 6d 6f 6e 6f 73 70 61 63 r.to.force.the.use.of.a.monospac
35380 65 64 20 66 6f 6e 74 0a 20 20 69 6e 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 45 76 65 6e 20 ed.font...in.menu.buffer...Even.
353a0 69 66 20 79 6f 75 20 75 73 65 20 61 20 70 72 6f 70 6f 72 74 69 6f 6e 61 6c 20 66 6f 6e 74 20 66 if.you.use.a.proportional.font.f
353c0 6f 72 20 74 68 65 20 7e 64 65 66 61 75 6c 74 7e 0a 20 20 66 61 63 65 2c 20 79 6f 75 20 6d 69 67 or.the.~default~...face,.you.mig
353e0 68 74 20 73 74 69 6c 6c 20 77 61 6e 74 20 74 6f 20 75 73 65 20 61 20 6d 6f 6e 6f 73 70 61 63 65 ht.still.want.to.use.a.monospace
35400 64 20 66 6f 6e 74 20 69 6e 20 74 68 65 20 6d 65 6e 75 0a 20 20 62 75 66 66 65 72 2e 20 20 53 65 d.font.in.the.menu...buffer...Se
35420 74 74 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 74 6f 20 7e 74 7e 20 63 61 75 73 65 73 20 tting.this.option.to.~t~.causes.
35440 7e 64 65 66 61 75 6c 74 7e 20 74 6f 20 62 65 20 72 65 6d 61 70 70 65 64 20 74 6f 0a 20 20 7e 66 ~default~.to.be.remapped.to...~f
35460 69 78 65 64 2d 70 69 74 63 68 7e 20 69 6e 20 74 68 61 74 20 62 75 66 66 65 72 2e 0a 0a 2a 2a 2a ixed-pitch~.in.that.buffer...***
35480 20 44 65 76 65 6c 6f 70 65 72 20 4f 70 74 69 6f 6e 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a .Developer.Options.:PROPERTIES:.
354a0 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 54 68 65 73 65 20 :UNNUMBERED:.notoc.:END:..These.
354c0 6f 70 74 69 6f 6e 73 20 61 72 65 20 6d 61 69 6e 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 options.are.mainly.intended.for.
354e0 64 65 76 65 6c 6f 70 65 72 73 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e developers...-.User.Option:.tran
35500 73 69 65 6e 74 2d 64 65 74 65 63 74 2d 6b 65 79 2d 63 6f 6e 66 6c 69 63 74 73 20 3a 3a 0a 0a 20 sient-detect-key-conflicts.::...
35520 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6b 65 .This.option.controls.whether.ke
35540 79 20 62 69 6e 64 69 6e 67 20 63 6f 6e 66 6c 69 63 74 73 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 y.binding.conflicts.should.be...
35560 64 65 74 65 63 74 65 64 20 61 74 20 74 68 65 20 74 69 6d 65 20 74 68 65 20 74 72 61 6e 73 69 65 detected.at.the.time.the.transie
35580 6e 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 49 66 20 73 6f 2c 20 74 68 69 73 20 72 65 73 75 nt.is.invoked...If.so,.this.resu
355a0 6c 74 73 0a 20 20 69 6e 20 61 6e 20 65 72 72 6f 72 2c 20 77 68 69 63 68 20 70 72 65 76 65 6e 74 lts...in.an.error,.which.prevent
355c0 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 62 65 69 6e 67 20 75 73 65 64 2e s.the.transient.from.being.used.
355e0 20 20 42 65 63 61 75 73 65 0a 20 20 6f 66 20 74 68 61 74 2c 20 63 6f 6e 66 6c 69 63 74 73 20 61 ..Because...of.that,.conflicts.a
35600 72 65 20 69 67 6e 6f 72 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 0a 0a 20 20 43 6f 6e 66 6c 69 re.ignored.by.default.....Confli
35620 63 74 73 20 63 61 6e 6e 6f 74 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64 20 65 61 72 6c 69 65 72 cts.cannot.be.determined.earlier
35640 2c 20 69 2e 65 2e 2c 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 0a 20 20 ,.i.e.,.when.the.transient.is...
35660 62 65 69 6e 67 20 64 65 66 69 6e 65 64 20 61 6e 64 20 77 68 65 6e 20 6e 65 77 20 73 75 66 66 69 being.defined.and.when.new.suffi
35680 78 65 73 20 61 72 65 20 62 65 69 6e 67 20 61 64 64 65 64 2c 20 62 65 63 61 75 73 65 20 61 74 20 xes.are.being.added,.because.at.
356a0 74 68 61 74 0a 20 20 74 69 6d 65 20 74 68 65 72 65 20 63 61 6e 20 62 65 20 66 61 6c 73 65 2d 70 that...time.there.can.be.false-p
356c0 6f 73 69 74 69 76 65 73 2e 20 20 49 74 20 69 73 20 61 63 74 75 61 6c 6c 79 20 76 61 6c 69 64 20 ositives...It.is.actually.valid.
356e0 66 6f 72 0a 20 20 6d 75 6c 74 69 70 6c 65 20 73 75 66 66 69 78 65 73 20 74 6f 20 73 68 61 72 65 for...multiple.suffixes.to.share
35700 20 61 20 63 6f 6d 6d 6f 6e 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 70 72 6f 76 69 64 65 64 20 .a.common.key.binding,.provided.
35720 74 68 65 0a 20 20 70 72 65 64 69 63 61 74 65 73 20 6f 66 20 74 68 6f 73 65 20 73 75 66 66 69 78 the...predicates.of.those.suffix
35740 65 73 20 70 72 65 76 65 6e 74 20 74 68 61 74 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 6f 66 es.prevent.that.more.than.one.of
35760 20 74 68 65 6d 20 69 73 0a 20 20 65 6e 61 62 6c 65 64 20 61 74 20 61 20 74 69 6d 65 2e 0a 0a 2d .them.is...enabled.at.a.time...-
35780 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 65 72 72 6f 72 2d 6f 6e .User.Option:.transient-error-on
357a0 2d 69 6e 73 65 72 74 2d 66 61 69 6c 75 72 65 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f -insert-failure.::....This.optio
357c0 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 6f 20 73 69 67 6e 61 6c 20 61 6e 20 n.controls.whether.to.signal.an.
357e0 65 72 72 6f 72 20 77 68 65 6e 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 error.when...~transient-insert-s
35800 75 66 66 69 78 7e 20 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 75 66 66 uffix~.or.~transient-append-suff
35820 69 78 7e 20 66 61 69 6c 65 64 20 74 6f 20 69 6e 73 65 72 74 0a 20 20 61 20 73 75 66 66 69 78 20 ix~.failed.to.insert...a.suffix.
35840 69 6e 74 6f 20 61 6e 20 65 78 69 73 74 69 6e 67 20 70 72 65 66 69 78 2e 20 20 42 79 20 64 65 66 into.an.existing.prefix...By.def
35860 61 75 6c 74 20 61 20 77 61 72 6e 69 6e 67 20 69 73 20 73 68 6f 77 6e 0a 20 20 69 6e 73 74 65 61 ault.a.warning.is.shown...instea
35880 64 2e 0a 0a 2d 20 55 73 65 72 20 4f 70 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 d...-.User.Option:.transient-hig
358a0 68 6c 69 67 68 74 2d 68 69 67 68 65 72 2d 6c 65 76 65 6c 73 20 3a 3a 0a 0a 20 20 54 68 69 73 20 hlight-higher-levels.::....This.
358c0 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 73 75 66 66 69 78 65 73 option.controls.whether.suffixes
358e0 20 74 68 61 74 20 77 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 0a .that.would.not.be.available.by.
35900 20 20 64 65 66 61 75 6c 74 20 61 72 65 20 68 69 67 68 6c 69 67 68 74 65 64 2e 0a 0a 20 20 57 68 ..default.are.highlighted.....Wh
35920 65 6e 20 6e 6f 6e 2d 7e 6e 69 6c 7e 20 74 68 65 6e 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f en.non-~nil~.then.the.descriptio
35940 6e 73 20 6f 66 20 73 75 66 66 69 78 65 73 20 61 72 65 20 68 69 67 68 6c 69 67 68 74 65 64 20 69 ns.of.suffixes.are.highlighted.i
35960 66 0a 20 20 74 68 65 69 72 20 6c 65 76 65 6c 20 69 73 20 61 62 6f 76 65 20 34 2c 20 74 68 65 20 f...their.level.is.above.4,.the.
35980 64 65 66 61 75 6c 74 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 6c 65 default.of.~transient-default-le
359a0 76 65 6c 7e 2e 0a 20 20 41 73 73 75 6d 69 6e 67 20 79 6f 75 20 68 61 76 65 20 73 65 74 20 74 68 vel~....Assuming.you.have.set.th
359c0 61 74 20 76 61 72 69 61 62 6c 65 20 74 6f 20 37 2c 20 74 68 69 73 20 68 69 67 68 6c 69 67 68 74 at.variable.to.7,.this.highlight
359e0 73 20 61 6c 6c 0a 20 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 77 6f 6e 27 74 20 62 65 20 61 s.all...suffixes.that.won't.be.a
35a00 76 61 69 6c 61 62 6c 65 20 74 6f 20 75 73 65 72 73 20 77 69 74 68 6f 75 74 20 74 68 65 6d 20 6d vailable.to.users.without.them.m
35a20 61 6b 69 6e 67 20 74 68 65 0a 20 20 73 61 6d 65 20 63 75 73 74 6f 6d 69 7a 61 74 69 6f 6e 2e 0a aking.the...same.customization..
35a40 0a 2a 2a 2a 20 48 6f 6f 6b 20 56 61 72 69 61 62 6c 65 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a .***.Hook.Variables.:PROPERTIES:
35a60 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 56 61 72 .:UNNUMBERED:.notoc.:END:..-.Var
35a80 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 65 78 69 74 2d 68 6f 6f 6b 20 3a 3a 0a 0a 20 iable:.transient-exit-hook.::...
35aa0 20 54 68 69 73 20 68 6f 6f 6b 20 69 73 20 72 75 6e 20 61 66 74 65 72 20 61 20 74 72 61 6e 73 69 .This.hook.is.run.after.a.transi
35ac0 65 6e 74 20 6d 65 6e 75 20 69 73 20 65 78 69 74 65 64 2c 20 65 76 65 6e 20 69 66 20 61 6e 6f 74 ent.menu.is.exited,.even.if.anot
35ae0 68 65 72 0a 20 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 62 65 63 6f 6d 65 73 20 61 63 74 her...transient.menu.becomes.act
35b00 69 76 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a 2d 20 56 61 72 69 61 62 6c ive.at.the.same.time...-.Variabl
35b20 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 70 6f 73 74 2d 65 78 69 74 2d 68 6f 6f 6b 20 3a 3a 0a 0a e:.transient-post-exit-hook.::..
35b40 20 20 54 68 69 73 20 68 6f 6f 6b 20 69 73 20 72 75 6e 20 61 66 74 65 72 20 61 20 74 72 61 6e 73 ..This.hook.is.run.after.a.trans
35b60 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 65 78 69 74 65 64 2c 20 70 72 6f 76 69 64 65 64 20 6e 6f ient.menu.is.exited,.provided.no
35b80 20 6f 74 68 65 72 0a 20 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 62 65 63 6f 6d 65 73 20 .other...transient.menu.becomes.
35ba0 61 63 74 69 76 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a 2d 20 56 61 72 69 active.at.the.same.time...-.Vari
35bc0 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 62 75 66 66 65 72 2d 68 6f 6f able:.transient-setup-buffer-hoo
35be0 6b 20 3a 3a 0a 0a 20 20 54 68 69 73 20 68 6f 6f 6b 20 69 73 20 72 75 6e 20 77 68 65 6e 20 74 68 k.::....This.hook.is.run.when.th
35c00 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 e.transient.buffer.is.being.setu
35c20 70 2e 0a 20 20 54 68 61 74 20 62 75 66 66 65 72 20 69 73 20 63 75 72 72 65 6e 74 20 61 6e 64 20 p....That.buffer.is.current.and.
35c40 65 6d 70 74 79 20 77 68 65 6e 20 74 68 69 73 20 68 6f 6f 6b 20 69 73 20 72 75 6e 73 2e 0a 0a 2a empty.when.this.hook.is.runs...*
35c60 20 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 0a 23 .Modifying.Existing.Transients.#
35c80 2b 63 69 6e 64 65 78 3a 20 6d 6f 64 69 66 79 69 6e 67 20 65 78 69 73 74 69 6e 67 20 74 72 61 6e +cindex:.modifying.existing.tran
35ca0 73 69 65 6e 74 73 0a 0a 54 6f 20 61 6e 20 65 78 74 65 6e 74 2c 20 74 72 61 6e 73 69 65 6e 74 73 sients..To.an.extent,.transients
35cc0 20 63 61 6e 20 62 65 20 63 75 73 74 6f 6d 69 7a 65 64 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 .can.be.customized.interactively
35ce0 2c 20 73 65 65 0a 5b 5b 2a 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 ,.see.[[*Enabling.and.Disabling.
35d00 53 75 66 66 69 78 65 73 5d 5d 2e 20 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 65 78 70 6c 61 69 Suffixes]]...This.section.explai
35d20 6e 73 20 68 6f 77 20 65 78 69 73 74 69 6e 67 0a 74 72 61 6e 73 69 65 6e 74 73 20 63 61 6e 20 62 ns.how.existing.transients.can.b
35d40 65 20 66 75 72 74 68 65 72 20 6d 6f 64 69 66 69 65 64 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 e.further.modified.non-interacti
35d60 76 65 6c 79 2e 20 20 4c 65 74 27 73 20 62 65 67 69 6e 0a 77 69 74 68 20 61 6e 20 65 78 61 6d 70 vely...Let's.begin.with.an.examp
35d80 6c 65 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 74 le:..#+begin_src.emacs-lisp...(t
35da0 72 61 6e 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 75 66 66 69 78 20 27 6d 61 67 69 74 2d 70 61 ransient-append-suffix.'magit-pa
35dc0 74 63 68 2d 61 70 70 6c 79 20 22 2d 33 22 0a 20 20 20 20 27 28 22 2d 52 22 20 22 41 70 70 6c 79 tch-apply."-3".....'("-R"."Apply
35de0 20 69 6e 20 72 65 76 65 72 73 65 22 20 22 2d 2d 72 65 76 65 72 73 65 22 29 29 0a 23 2b 65 6e 64 .in.reverse"."--reverse")).#+end
35e00 5f 73 72 63 0a 0a 54 68 69 73 20 69 6e 73 65 72 74 73 20 61 20 6e 65 77 20 69 6e 66 69 78 20 61 _src..This.inserts.a.new.infix.a
35e20 72 67 75 6d 65 6e 74 20 74 6f 20 74 6f 67 67 6c 65 20 74 68 65 20 7e 2d 2d 72 65 76 65 72 73 65 rgument.to.toggle.the.~--reverse
35e40 7e 20 61 72 67 75 6d 65 6e 74 0a 61 66 74 65 72 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d ~.argument.after.the.infix.argum
35e60 65 6e 74 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 7e 2d 33 7e 20 69 6e 20 7e 6d 61 ent.that.is.bound.to.~-3~.in.~ma
35e80 67 69 74 2d 70 61 74 63 68 2d 61 70 70 6c 79 7e 2e 0a 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 git-patch-apply~...The.following
35ea0 20 66 75 6e 63 74 69 6f 6e 73 20 73 68 61 72 65 20 61 20 66 65 77 20 61 72 67 75 6d 65 6e 74 73 .functions.share.a.few.arguments
35ec0 3a 0a 0a 2d 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 20 69 73 20 61 20 74 72 61 6e :..-.{{{var(PREFIX)}}}.is.a.tran
35ee0 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a sient.prefix.command,.a.symbol..
35f00 0a 20 20 50 52 45 46 49 58 20 6d 61 79 20 61 6c 73 6f 20 62 79 20 61 20 73 79 6d 62 6f 6c 20 69 ...PREFIX.may.also.by.a.symbol.i
35f20 64 65 6e 74 69 66 79 69 6e 67 20 61 20 73 65 70 61 72 61 74 65 6c 79 20 64 65 66 69 6e 65 64 20 dentifying.a.separately.defined.
35f40 67 72 6f 75 70 2c 0a 20 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 69 6e 63 6c 75 64 65 64 20 69 group,...which.can.be.included.i
35f60 6e 20 6d 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 65 73 2e 20 20 53 65 65 20 54 4f 44 4f 2e 0a n.multiple.prefixes...See.TODO..
35f80 0a 2d 20 7b 7b 7b 76 61 72 28 53 55 46 46 49 58 29 7d 7d 7d 20 69 73 20 61 20 74 72 61 6e 73 69 .-.{{{var(SUFFIX)}}}.is.a.transi
35fa0 65 6e 74 20 69 6e 66 69 78 20 6f 72 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f ent.infix.or.suffix.specificatio
35fc0 6e 20 69 6e 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 0a 20 20 61 73 20 65 78 70 65 63 74 65 64 n.in.the.same.form...as.expected
35fe0 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e 20 20 .by.~transient-define-prefix~...
36000 4e 6f 74 65 20 74 68 61 74 20 61 6e 20 69 6e 66 69 78 20 69 73 20 61 0a 20 20 73 70 65 63 69 61 Note.that.an.infix.is.a...specia
36020 6c 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 2e 20 20 44 65 70 65 6e 64 69 6e 67 20 6f 6e 20 l.kind.of.suffix...Depending.on.
36040 63 6f 6e 74 65 78 74 20 e2 80 9c 73 75 66 66 69 78 65 73 e2 80 9d 20 6d 65 61 6e 73 0a 20 20 e2 context....suffixes....means....
36060 80 9c 73 75 66 66 69 78 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 69 6e 66 69 78 65 73 29 e2 80 ..suffixes.(including.infixes)..
36080 9d 20 6f 72 20 e2 80 9c 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 e2 80 9d 2e 20 20 ..or....non-infix.suffixes......
360a0 48 65 72 65 20 69 74 0a 20 20 6d 65 61 6e 73 20 74 68 65 20 66 6f 72 6d 65 72 2e 20 20 53 65 65 Here.it...means.the.former...See
360c0 20 5b 5b 2a 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 5d 5d 2e 0a 0a 20 20 .[[*Suffix.Specifications]].....
360e0 7b 7b 7b 76 61 72 28 53 55 46 46 49 58 29 7d 7d 7d 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 {{{var(SUFFIX)}}}.may.also.be.a.
36100 67 72 6f 75 70 20 69 6e 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 65 78 70 65 63 74 group.in.the.same.form.as.expect
36120 65 64 20 62 79 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 ed.by...~transient-define-prefix
36140 7e 2e 20 20 53 65 65 20 5b 5b 2a 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 5d ~...See.[[*Group.Specifications]
36160 5d 2e 0a 0a 2d 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d 20 69 73 20 61 20 6b 65 79 20 64 65 ]...-.{{{var(LOC)}}}.is.a.key.de
36180 73 63 72 69 70 74 69 6f 6e 20 28 61 20 73 74 72 69 6e 67 20 61 73 20 72 65 74 75 72 6e 65 64 20 scription.(a.string.as.returned.
361a0 62 79 20 7e 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 7e 0a 20 20 61 6e 64 20 75 6e 64 65 72 by.~key-description~...and.under
361c0 73 74 6f 6f 64 20 62 79 20 7e 6b 62 64 7e 29 2c 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 stood.by.~kbd~),.a.command,.a.sy
361e0 6d 62 6f 6c 20 69 64 65 6e 74 69 66 79 69 6e 67 20 61 6e 20 69 6e 63 6c 75 64 65 64 0a 20 20 67 mbol.identifying.an.included...g
36200 72 6f 75 70 2c 20 6f 72 20 61 20 76 65 63 74 6f 72 20 73 70 65 63 69 66 79 69 6e 67 20 63 6f 6f roup,.or.a.vector.specifying.coo
36220 72 64 69 6e 61 74 65 73 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 7e 5b 31 20 30 20 2d 31 rdinates...For.example,.~[1.0.-1
36240 5d 7e 0a 20 20 69 64 65 6e 74 69 66 69 65 73 20 74 68 65 20 6c 61 73 74 20 73 75 66 66 69 78 20 ]~...identifies.the.last.suffix.
36260 28 7e 2d 31 7e 29 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 73 75 62 67 72 6f 75 70 20 28 7e 30 (~-1~).of.the.first.subgroup.(~0
36280 7e 29 20 6f 66 20 74 68 65 0a 20 20 73 65 63 6f 6e 64 20 67 72 6f 75 70 20 28 7e 31 7e 29 2e 0a ~).of.the...second.group.(~1~)..
362a0 0a 20 20 49 66 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d 20 69 73 20 61 20 76 65 63 74 6f 72 ...If.{{{var(LOC)}}}.is.a.vector
362c0 2c 20 74 68 65 6e 20 69 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 64 65 6e 74 69 66 ,.then.it.can.be.used.to.identif
362e0 79 20 61 20 67 72 6f 75 70 2c 20 6e 6f 74 0a 20 20 6a 75 73 74 20 61 6e 20 69 6e 64 69 76 69 64 y.a.group,.not...just.an.individ
36300 75 61 6c 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 65 20 6c 61 73 74 20 65 6c ual.suffix.command...The.last.el
36320 65 6d 65 6e 74 20 69 6e 20 61 20 76 65 63 74 6f 72 20 6d 61 79 0a 20 20 61 6c 73 6f 20 62 65 20 ement.in.a.vector.may...also.be.
36340 61 20 73 79 6d 62 6f 6c 20 6f 72 20 6b 65 79 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 a.symbol.or.key,.in.which.case.t
36360 68 65 20 70 72 65 63 65 64 69 6e 67 20 65 6c 65 6d 65 6e 74 73 20 6d 75 73 74 0a 20 20 6d 61 74 he.preceding.elements.must...mat
36380 63 68 20 61 20 67 72 6f 75 70 20 61 6e 64 20 74 68 65 20 6c 61 73 74 20 65 6c 65 6d 65 6e 74 20 ch.a.group.and.the.last.element.
363a0 69 73 20 6c 6f 6f 6b 65 64 20 75 70 20 77 69 74 68 69 6e 20 74 68 61 74 20 67 72 6f 75 70 2e 0a is.looked.up.within.that.group..
363c0 0a 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 73 ...The.function.~transient-get-s
363e0 75 66 66 69 78 7e 20 63 61 6e 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 64 65 74 65 72 6d 69 6e uffix~.can.be.useful.to.determin
36400 65 20 77 68 65 74 68 65 72 0a 20 20 61 20 63 65 72 74 61 69 6e 20 63 6f 6f 72 64 69 6e 61 74 65 e.whether...a.certain.coordinate
36420 20 76 65 63 74 6f 72 20 69 64 65 6e 74 69 66 69 65 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 .vector.identifies.the.suffix.or
36440 20 67 72 6f 75 70 20 74 68 61 74 20 79 6f 75 0a 20 20 65 78 70 65 63 74 20 69 74 20 74 6f 20 69 .group.that.you...expect.it.to.i
36460 64 65 6e 74 69 66 79 2e 20 20 49 6e 20 68 61 69 72 79 20 63 61 73 65 73 20 69 74 20 6d 61 79 20 dentify...In.hairy.cases.it.may.
36480 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6c 6f 6f 6b 0a 20 20 61 74 20 74 68 65 20 69 6e be.necessary.to.look...at.the.in
364a0 74 65 72 6e 61 6c 20 6c 61 79 6f 75 74 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2c 20 77 68 ternal.layout.representation,.wh
364c0 69 63 68 20 79 6f 75 20 63 61 6e 20 61 63 63 65 73 73 20 75 73 69 6e 67 0a 20 20 74 68 65 20 66 ich.you.can.access.using...the.f
364e0 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 6c 61 79 6f 75 74 7e 2e unction.~transient--get-layout~.
36500 0a 0a 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f 70 65 72 61 74 65 20 6f 6e 20 74 68 65 ..These.functions.operate.on.the
36520 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 7e 74 72 61 6e .information.stored.in.the.~tran
36540 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 7e 20 70 72 6f 70 65 72 74 79 20 6f 66 20 74 68 65 20 7b sient--layout~.property.of.the.{
36560 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 20 73 79 6d 62 6f 6c 2e 20 20 45 6c 65 6d 65 6e {{var(PREFIX)}}}.symbol...Elemen
36580 74 73 20 69 6e 20 74 68 61 74 0a 74 72 65 65 20 61 72 65 20 6e 6f 74 20 6f 62 6a 65 63 74 73 20 ts.in.that.tree.are.not.objects.
365a0 62 75 74 20 68 61 76 65 20 74 68 65 20 66 6f 72 6d 20 7b 7b 7b 63 6f 64 65 76 61 72 28 28 43 4c but.have.the.form.{{{codevar((CL
365c0 41 53 53 20 50 4c 49 53 54 29 20 66 6f 72 20 73 75 66 66 69 78 65 73 29 7d 7d 7d 20 61 6e 64 0a ASS.PLIST).for.suffixes)}}}.and.
365e0 5b 43 4c 41 53 53 20 50 4c 49 53 54 20 43 48 49 4c 44 52 45 4e 5d 20 66 6f 72 20 67 72 6f 75 70 [CLASS.PLIST.CHILDREN].for.group
36600 73 2e 20 20 41 74 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 74 68 65 20 74 72 65 65 20 69 73 20 61 s...At.the.root.of.the.tree.is.a
36620 6e 0a 65 6c 65 6d 65 6e 74 20 5b 4e 20 6e 69 6c 20 43 48 49 4c 44 52 45 4e 5d 2c 20 77 68 65 72 n.element.[N.nil.CHILDREN],.wher
36640 65 20 4e 20 69 73 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 6c 61 79 6f 75 74 e.N.is.the.version.of.the.layout
36660 20 66 6f 72 6d 61 74 2c 0a 63 75 72 72 65 6e 74 6c 79 20 61 6e 64 20 68 6f 70 65 66 75 6c 6c 79 .format,.currently.and.hopefully
36680 20 66 6f 72 20 61 20 6c 6f 6e 67 20 74 69 6d 65 20 32 2e 20 20 57 68 69 6c 65 20 74 68 61 74 20 .for.a.long.time.2...While.that.
366a0 65 6c 65 6d 65 6e 74 20 6c 6f 6f 6b 73 0a 6c 69 6b 65 20 61 20 67 72 6f 75 70 20 76 65 63 74 6f element.looks.like.a.group.vecto
366c0 72 2c 20 74 68 61 74 20 65 6c 65 6d 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20 63 6f 75 6e 74 20 77 r,.that.element.does.not.count.w
366e0 68 65 6e 20 69 64 65 6e 74 69 66 79 69 6e 67 20 61 0a 67 72 6f 75 70 20 75 73 69 6e 67 20 61 20 hen.identifying.a.group.using.a.
36700 63 6f 6f 72 64 69 6e 61 74 65 20 76 65 63 74 6f 72 2c 20 69 2e 65 2e 2c 20 5b 30 5d 20 69 73 20 coordinate.vector,.i.e.,.[0].is.
36720 69 74 73 20 66 69 72 73 74 20 63 68 69 6c 64 2c 20 6e 6f 74 20 74 68 65 0a 72 6f 6f 74 20 65 6c its.first.child,.not.the.root.el
36740 65 6d 65 6e 74 20 69 74 73 65 6c 66 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 ement.itself...-.Function:.trans
36760 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 ient-insert-suffix.prefix.loc.su
36780 66 66 69 78 20 26 6f 70 74 69 6f 6e 61 6c 20 6b 65 65 70 2d 6f 74 68 65 72 20 3a 3a 0a 2d 20 46 ffix.&optional.keep-other.::.-.F
367a0 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 75 66 66 69 78 unction:.transient-append-suffix
367c0 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 20 26 6f 70 74 69 6f 6e 61 6c 20 6b 65 65 .prefix.loc.suffix.&optional.kee
367e0 70 2d 6f 74 68 65 72 20 3a 3a 0a 0a 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e p-other.::....These.functions.in
36800 73 65 72 74 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 7b 7b 7b 76 61 72 28 sert.the.suffix.or.group.{{{var(
36820 53 55 46 46 49 58 29 7d 7d 7d 20 69 6e 74 6f 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d SUFFIX)}}}.into.{{{var(PREFIX)}}
36840 7d 20 62 65 66 6f 72 65 0a 20 20 6f 72 20 61 66 74 65 72 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d }.before...or.after.{{{var(LOC)}
36860 7d 7d 2e 0a 0a 20 20 43 6f 6e 63 65 70 74 75 61 6c 6c 79 20 61 64 64 69 6e 67 20 61 20 62 69 6e }}.....Conceptually.adding.a.bin
36880 64 69 6e 67 20 74 6f 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 69 73 20 73 69 ding.to.a.transient.prefix.is.si
368a0 6d 69 6c 61 72 20 74 6f 0a 20 20 61 64 64 69 6e 67 20 61 20 62 69 6e 64 69 6e 67 20 74 6f 20 61 milar.to...adding.a.binding.to.a
368c0 20 6b 65 79 6d 61 70 2c 20 62 75 74 20 74 68 69 73 20 69 73 20 63 6f 6d 70 6c 69 63 61 74 65 64 .keymap,.but.this.is.complicated
368e0 20 62 79 20 74 68 65 20 66 61 63 74 0a 20 20 74 68 61 74 20 6d 75 6c 74 69 70 6c 65 20 73 75 66 .by.the.fact...that.multiple.suf
36900 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 62 6f 75 6e 64 20 74 6f 20 74 68 65 fix.commands.can.be.bound.to.the
36920 20 73 61 6d 65 20 6b 65 79 2c 20 70 72 6f 76 69 64 65 64 0a 20 20 74 68 65 79 20 61 72 65 20 6e .same.key,.provided...they.are.n
36940 65 76 65 72 20 61 63 74 69 76 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2c 20 73 65 ever.active.at.the.same.time,.se
36960 65 20 5b 5b 2a 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 5d 5d 2e 0a 0a 20 20 55 6e 66 6f 72 e.[[*Predicate.Slots]].....Unfor
36980 74 75 6e 61 74 65 6c 79 20 62 6f 74 68 20 66 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 73 20 61 6e tunately.both.false-positives.an
369a0 64 20 66 61 6c 73 65 2d 6e 65 67 61 74 69 76 65 73 20 61 72 65 20 70 6f 73 73 69 62 6c 65 2e 0a d.false-negatives.are.possible..
369c0 20 20 54 6f 20 64 65 61 6c 20 77 69 74 68 20 74 68 65 20 66 6f 72 6d 65 72 2c 20 75 73 65 20 6e ..To.deal.with.the.former,.use.n
369e0 6f 6e 2d 7e 6e 69 6c 7e 20 7b 7b 7b 76 61 72 28 4b 45 45 50 2d 4f 54 48 45 52 2e 29 7d 7d 7d 20 on-~nil~.{{{var(KEEP-OTHER.)}}}.
36a00 20 54 68 65 20 73 79 6d 62 6f 6c 20 7e 61 6c 77 61 79 73 7e 0a 20 20 70 72 65 76 65 6e 74 73 20 .The.symbol.~always~...prevents.
36a20 74 68 65 20 72 65 6d 6f 76 61 6c 20 6f 66 20 61 20 66 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 2c the.removal.of.a.false-positive,
36a40 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 20 77 68 65 72 65 20 6f 74 68 65 72 0a 20 20 6e 6f 6e .in.some.cases.where.other...non
36a60 2d 7e 6e 69 6c 7e 20 76 61 6c 75 65 73 20 77 6f 75 6c 64 20 66 61 69 6c 2e 20 20 54 6f 20 64 65 -~nil~.values.would.fail...To.de
36a80 61 6c 20 77 69 74 68 20 66 61 6c 73 65 2d 6e 65 67 61 74 69 76 65 73 20 72 65 6d 6f 76 65 20 74 al.with.false-negatives.remove.t
36aa0 68 65 0a 20 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 62 69 6e 64 69 6e 67 20 73 65 70 61 72 61 74 he...conflicting.binding.separat
36ac0 65 6c 79 2c 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 6d 6f 76 65 2d 73 75 66 ely,.using.~transient-remove-suf
36ae0 66 69 78 7e 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 70 fix~...-.Function:.transient-rep
36b00 6c 61 63 65 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 20 3a 3a lace-suffix.prefix.loc.suffix.::
36b20 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 73 ....This.function.replaces.the.s
36b40 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 61 74 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d uffix.or.group.at.{{{var(LOC)}}}
36b60 20 69 6e 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 20 77 69 74 68 0a 20 20 73 75 66 .in.{{{var(PREFIX)}}}.with...suf
36b80 66 69 78 20 6f 72 20 67 72 6f 75 70 20 7b 7b 7b 76 61 72 28 53 55 46 46 49 58 29 7d 7d 7d 2e 0a fix.or.group.{{{var(SUFFIX)}}}..
36ba0 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 6d 6f 76 65 2d 73 75 .-.Function:.transient-remove-su
36bc0 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 ffix.prefix.loc.::....This.funct
36be0 69 6f 6e 20 72 65 6d 6f 76 65 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 ion.removes.the.suffix.or.group.
36c00 61 74 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d 20 69 6e 20 7b 7b 7b 76 61 72 28 50 52 45 46 at.{{{var(LOC)}}}.in.{{{var(PREF
36c20 49 58 29 7d 7d 7d 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 67 IX)}}}...-.Function:.transient-g
36c40 65 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 3a 3a 0a 0a 20 20 54 68 69 73 20 et-suffix.prefix.loc.::....This.
36c60 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 function.returns.the.suffix.or.g
36c80 72 6f 75 70 20 61 74 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d 20 69 6e 20 7b 7b 7b 76 61 72 roup.at.{{{var(LOC)}}}.in.{{{var
36ca0 28 50 52 45 46 49 58 29 7d 7d 7d 2e 20 20 54 68 65 0a 20 20 72 65 74 75 72 6e 65 64 20 76 61 6c (PREFIX)}}}...The...returned.val
36cc0 75 65 20 68 61 73 20 74 68 65 20 66 6f 72 6d 20 6d 65 6e 74 69 6f 6e 65 64 20 61 62 6f 76 65 2e ue.has.the.form.mentioned.above.
36ce0 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 70 ..-.Function:.transient-suffix-p
36d00 75 74 20 70 72 65 66 69 78 20 6c 6f 63 20 70 72 6f 70 20 76 61 6c 75 65 20 3a 3a 0a 0a 20 20 54 ut.prefix.loc.prop.value.::....T
36d20 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 65 64 69 74 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 his.function.edits.the.suffix.or
36d40 20 67 72 6f 75 70 20 61 74 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d 20 69 6e 20 7b 7b 7b 76 .group.at.{{{var(LOC)}}}.in.{{{v
36d60 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 2c 20 62 79 20 73 65 74 74 69 6e 67 0a 20 20 74 68 65 20 ar(PREFIX)}}},.by.setting...the.
36d80 7b 7b 7b 76 61 72 28 50 52 4f 50 29 7d 7d 7d 20 6f 66 20 69 74 73 20 70 6c 69 73 74 20 74 6f 20 {{{var(PROP)}}}.of.its.plist.to.
36da0 7b 7b 7b 76 61 72 28 56 41 4c 55 45 29 7d 7d 7d 2e 0a 0a 53 6f 6d 65 20 70 72 65 66 69 78 20 63 {{{var(VALUE)}}}...Some.prefix.c
36dc0 6f 6d 6d 61 6e 64 73 20 73 68 61 72 65 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 61 72 ommands.share.suffixes,.which.ar
36de0 65 20 73 65 70 61 72 61 74 65 6c 79 20 61 6e 64 20 74 68 65 6e 0a 69 6e 63 6c 75 64 65 64 20 69 e.separately.and.then.included.i
36e00 6e 20 65 61 63 68 20 70 72 65 66 69 78 20 77 68 65 6e 20 69 74 20 69 73 20 64 65 66 69 6e 65 64 n.each.prefix.when.it.is.defined
36e20 2e 20 20 54 68 65 20 69 6e 63 6c 75 73 69 6f 6e 20 69 73 20 64 6f 6e 65 20 62 79 0a 72 65 66 65 ...The.inclusion.is.done.by.refe
36e40 72 65 6e 63 65 2c 20 74 68 65 20 69 6e 63 6c 75 64 65 64 20 73 75 66 66 69 78 20 67 72 6f 75 70 rence,.the.included.suffix.group
36e60 73 20 61 72 65 20 6e 6f 74 20 69 6e 6c 69 6e 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 53 s.are.not.inlined.by.default...S
36e80 6f 0a 69 66 20 79 6f 75 20 63 68 61 6e 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 o.if.you.change,.for.example,.th
36ea0 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 69 6e e.key.binding.for.an.argument.in
36ec0 0a 7e 6d 61 67 69 74 2d 64 69 66 66 7e 20 28 7e 64 7e 29 20 74 68 65 20 73 61 6d 65 20 63 68 61 .~magit-diff~.(~d~).the.same.cha
36ee0 6e 67 65 20 61 6c 73 6f 20 61 70 70 6c 69 65 73 20 74 6f 20 7e 6d 61 67 69 74 2d 64 69 66 66 2d nge.also.applies.to.~magit-diff-
36f00 72 65 66 72 65 73 68 7e 20 28 7e 44 7e 29 2e 0a 49 6e 20 74 68 65 20 72 61 72 65 20 63 61 73 65 refresh~.(~D~)..In.the.rare.case
36f20 20 74 68 61 74 20 74 68 69 73 20 69 73 20 6e 6f 74 20 64 65 73 69 72 61 62 6c 65 20 75 73 65 20 .that.this.is.not.desirable.use.
36f40 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 6c 69 6e 65 2d 67 72 6f 75 70 7e 0a 62 65 66 6f 72 65 20 ~transient-inline-group~.before.
36f60 6d 61 6b 69 6e 67 20 63 68 61 6e 67 65 73 20 74 6f 20 69 6e 63 6c 75 64 65 64 20 73 75 66 66 69 making.changes.to.included.suffi
36f80 78 65 73 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 6c 69 xes...-.Function:.transient-inli
36fa0 6e 65 2d 67 72 6f 75 70 20 50 52 45 46 49 58 20 47 52 4f 55 50 20 3a 3a 0a 0a 20 20 54 68 69 73 ne-group.PREFIX.GROUP.::....This
36fc0 20 66 75 6e 63 74 69 6f 6e 20 69 6e 6c 69 6e 65 73 20 74 68 65 20 69 6e 63 6c 75 64 65 64 20 47 .function.inlines.the.included.G
36fe0 52 4f 55 50 20 69 6e 74 6f 20 50 52 45 46 49 58 2c 20 62 79 20 72 65 70 6c 61 63 69 6e 67 0a 20 ROUP.into.PREFIX,.by.replacing..
37000 20 74 68 65 20 73 79 6d 62 6f 6c 20 47 52 4f 55 50 20 77 69 74 68 20 69 74 73 20 65 78 70 61 6e .the.symbol.GROUP.with.its.expan
37020 64 65 64 20 6c 61 79 6f 75 74 20 69 6e 20 74 68 65 20 6c 61 79 6f 75 74 20 6f 66 20 50 52 45 46 ded.layout.in.the.layout.of.PREF
37040 49 58 2e 0a 0a 4d 6f 73 74 20 6f 66 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 64 6f 20 IX...Most.of.these.functions.do.
37060 6e 6f 74 20 73 69 67 6e 61 6c 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 68 65 79 20 63 61 6e 6e not.signal.an.error.if.they.cann
37080 6f 74 20 70 65 72 66 6f 72 6d 0a 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6d 6f 64 69 66 69 63 ot.perform.the.requested.modific
370a0 61 74 69 6f 6e 2e 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 69 6e 73 65 72 ation...The.functions.that.inser
370c0 74 20 6e 65 77 20 73 75 66 66 69 78 65 73 0a 73 68 6f 77 20 61 20 77 61 72 6e 69 6e 67 20 69 66 t.new.suffixes.show.a.warning.if
370e0 20 7b 7b 7b 76 61 72 28 4c 4f 43 29 7d 7d 7d 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 20 .{{{var(LOC)}}}.cannot.be.found.
37100 69 6e 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 2c 29 7d 7d 7d 20 77 69 74 68 6f 75 74 20 73 69 in.{{{var(PREFIX,)}}}.without.si
37120 67 6e 61 6c 69 6e 67 20 61 6e 0a 65 72 72 6f 72 2e 20 20 54 68 65 20 72 65 61 73 6f 6e 20 66 6f gnaling.an.error...The.reason.fo
37140 72 20 64 6f 69 6e 67 20 69 74 20 6c 69 6b 65 20 74 68 69 73 20 69 73 20 74 68 61 74 20 65 73 74 r.doing.it.like.this.is.that.est
37160 61 62 6c 69 73 68 69 6e 67 20 61 20 6b 65 79 0a 62 69 6e 64 69 6e 67 20 28 61 6e 64 20 74 68 61 ablishing.a.key.binding.(and.tha
37180 74 20 69 73 20 77 68 61 74 20 77 65 20 65 73 73 65 6e 74 69 61 6c 6c 79 20 61 72 65 20 74 72 79 t.is.what.we.essentially.are.try
371a0 69 6e 67 20 74 6f 20 64 6f 20 68 65 72 65 29 20 73 68 6f 75 6c 64 0a 6e 6f 74 20 70 72 65 76 65 ing.to.do.here).should.not.preve
371c0 6e 74 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e nt.the.rest.of.the.configuration
371e0 20 66 72 6f 6d 20 6c 6f 61 64 69 6e 67 2e 20 20 41 6d 6f 6e 67 20 74 68 65 73 65 0a 66 75 6e 63 .from.loading...Among.these.func
37200 74 69 6f 6e 73 20 6f 6e 6c 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 73 75 66 66 69 78 tions.only.~transient-get-suffix
37220 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 70 75 74 7e 20 73 69 67 ~.and.~transient-suffix-put~.sig
37240 6e 61 6c 0a 61 6e 20 65 72 72 6f 72 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 49 66 20 79 6f 75 nal.an.error.by.default...If.you
37260 20 72 65 61 6c 6c 79 20 77 61 6e 74 20 74 68 65 20 69 6e 73 65 72 74 20 66 75 6e 63 74 69 6f 6e .really.want.the.insert.function
37280 73 20 74 6f 20 61 6c 73 6f 0a 73 69 67 6e 61 6c 20 61 6e 20 65 72 72 6f 72 2c 20 73 65 74 20 7e s.to.also.signal.an.error,.set.~
372a0 74 72 61 6e 73 69 65 6e 74 2d 65 72 72 6f 72 2d 6f 6e 2d 69 6e 73 65 72 74 2d 66 61 69 6c 75 72 transient-error-on-insert-failur
372c0 65 7e 20 74 6f 20 7e 74 7e 2e 0a 0a 2a 20 44 65 66 69 6e 69 6e 67 20 4e 65 77 20 43 6f 6d 6d 61 e~.to.~t~...*.Defining.New.Comma
372e0 6e 64 73 0a 2a 2a 20 54 65 63 68 6e 69 63 61 6c 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 0a 0a 54 nds.**.Technical.Introduction..T
37300 61 6b 69 6e 67 20 69 6e 73 70 69 72 61 74 69 6f 6e 20 66 72 6f 6d 20 70 72 65 66 69 78 20 6b 65 aking.inspiration.from.prefix.ke
37320 79 73 20 61 6e 64 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2c 20 54 72 61 6e 73 69 65 ys.and.prefix.arguments,.Transie
37340 6e 74 0a 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 73 69 6d 69 6c 61 72 20 61 62 73 74 72 61 63 74 nt.implements.a.similar.abstract
37360 69 6f 6e 20 69 6e 76 6f 6c 76 69 6e 67 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 ion.involving.a.prefix.command,.
37380 69 6e 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 infix.arguments.and.suffix.comma
373a0 6e 64 73 2e 0a 0a 57 68 65 6e 20 74 68 65 20 75 73 65 72 20 63 61 6c 6c 73 20 61 20 74 72 61 6e nds...When.the.user.calls.a.tran
373c0 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 74 72 61 6e 73 69 65 6e sient.prefix.command,.a.transien
373e0 74 0a 28 74 65 6d 70 6f 72 61 72 79 29 20 6b 65 79 6d 61 70 20 69 73 20 61 63 74 69 76 61 74 65 t.(temporary).keymap.is.activate
37400 64 2c 20 77 68 69 63 68 20 62 69 6e 64 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 69 d,.which.binds.the.transient's.i
37420 6e 66 69 78 20 61 6e 64 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 66 75 nfix.and.suffix.commands,.and.fu
37440 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 63 6f 6e 74 72 6f 6c 20 74 68 65 20 74 72 61 6e 73 69 65 nctions.that.control.the.transie
37460 6e 74 20 73 74 61 74 65 20 61 72 65 0a 61 64 64 65 64 20 74 6f 20 7e 70 72 65 2d 63 6f 6d 6d 61 nt.state.are.added.to.~pre-comma
37480 6e 64 2d 68 6f 6f 6b 7e 20 61 6e 64 20 7e 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 7e nd-hook~.and.~post-command-hook~
374a0 2e 20 20 54 68 65 20 61 76 61 69 6c 61 62 6c 65 20 73 75 66 66 69 78 0a 61 6e 64 20 69 6e 66 69 ...The.available.suffix.and.infi
374c0 78 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65 69 72 20 73 74 61 74 65 20 61 72 65 20 73 x.commands.and.their.state.are.s
374e0 68 6f 77 6e 20 69 6e 20 61 20 6d 65 6e 75 20 62 75 66 66 65 72 20 75 6e 74 69 6c 0a 74 68 65 20 hown.in.a.menu.buffer.until.the.
37500 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 69 73 20 65 78 69 74 65 64 20 62 79 20 69 6e 76 transient.state.is.exited.by.inv
37520 6f 6b 69 6e 67 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 43 61 6c 6c 69 6e 67 oking.a.suffix.command...Calling
37540 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 75 73 65 73 20 69 74 73 20 76 61 6c .an.infix.command.causes.its.val
37560 75 65 20 74 6f 20 62 65 20 63 68 61 6e 67 65 64 2e 20 20 48 6f 77 20 74 68 61 74 20 69 73 0a 64 ue.to.be.changed...How.that.is.d
37580 6f 6e 65 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 69 one.depends.on.the.type.of.the.i
375a0 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 65 20 73 69 6d 70 6c 65 73 74 20 63 61 73 65 nfix.command...The.simplest.case
375c0 20 69 73 0a 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 72 65 70 72 65 73 .is.an.infix.command.that.repres
375e0 65 6e 74 73 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 20 74 68 61 ents.a.command-line.argument.tha
37600 74 20 64 6f 65 73 20 6e 6f 74 0a 74 61 6b 65 20 61 20 76 61 6c 75 65 2e 20 20 49 6e 76 6f 6b 69 t.does.not.take.a.value...Invoki
37620 6e 67 20 73 75 63 68 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 75 73 65 73 20 ng.such.an.infix.command.causes.
37640 74 68 65 20 73 77 69 74 63 68 20 74 6f 20 62 65 0a 74 6f 67 67 6c 65 64 20 6f 6e 20 6f 72 20 6f the.switch.to.be.toggled.on.or.o
37660 66 66 2e 20 20 4d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 ff...More.complex.infix.commands
37680 20 6d 61 79 20 72 65 61 64 20 61 20 76 61 6c 75 65 20 66 72 6f 6d 0a 74 68 65 20 75 73 65 72 2c .may.read.a.value.from.the.user,
376a0 20 75 73 69 6e 67 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 43 61 6c 6c 69 6e 67 20 .using.the.minibuffer...Calling.
376c0 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 75 73 75 61 6c 6c 79 20 63 61 75 73 65 73 20 a.suffix.command.usually.causes.
376e0 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 62 65 20 65 78 69 74 65 64 3b 0a 74 68 65 20 the.transient.to.be.exited;.the.
37700 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 73 20 61 6e 64 20 68 6f 6f 6b 20 66 75 6e 63 74 transient.keymaps.and.hook.funct
37720 69 6f 6e 73 20 61 72 65 20 72 65 6d 6f 76 65 64 2c 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 ions.are.removed,.the.menu.buffe
37740 72 0a 6e 6f 20 6c 6f 6e 67 65 72 20 73 68 6f 77 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 r.no.longer.shows.information.ab
37760 6f 75 74 20 74 68 65 20 28 6e 6f 20 6c 6f 6e 67 65 72 20 62 6f 75 6e 64 29 20 73 75 66 66 69 78 out.the.(no.longer.bound).suffix
37780 0a 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 6f 6d 65 20 70 75 .commands,.the.values.of.some.pu
377a0 62 6c 69 63 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 73 65 74 2c 20 77 blic.global.variables.are.set,.w
377c0 68 69 6c 65 0a 73 6f 6d 65 20 69 6e 74 65 72 6e 61 6c 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 hile.some.internal.global.variab
377e0 6c 65 73 20 61 72 65 20 75 6e 73 65 74 2c 20 61 6e 64 20 66 69 6e 61 6c 6c 79 20 74 68 65 20 63 les.are.unset,.and.finally.the.c
37800 6f 6d 6d 61 6e 64 20 69 73 0a 61 63 74 75 61 6c 6c 79 20 63 61 6c 6c 65 64 2e 20 20 53 75 66 66 ommand.is.actually.called...Suff
37820 69 78 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 63 6f 6e 66 69 67 75 72 ix.commands.can.also.be.configur
37840 65 64 20 74 6f 20 6e 6f 74 20 65 78 69 74 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 41 ed.to.not.exit.the.transient...A
37860 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f .suffix.command.can,.but.does.no
37880 74 20 68 61 76 65 20 74 6f 2c 20 75 73 65 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e t.have.to,.use.the.infix.argumen
378a0 74 73 20 69 6e 0a 6d 75 63 68 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 6e 79 20 63 6f 6d 6d ts.in.much.the.same.way.any.comm
378c0 61 6e 64 20 63 61 6e 20 63 68 6f 6f 73 65 20 74 6f 20 75 73 65 20 6f 72 20 69 67 6e 6f 72 65 20 and.can.choose.to.use.or.ignore.
378e0 74 68 65 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 73 2e 20 20 46 6f 72 20 61 20 73 75 66 the.prefix.arguments...For.a.suf
37900 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f fix.command.that.was.invoked.fro
37920 6d 20 61 20 74 72 61 6e 73 69 65 6e 74 2c 20 74 68 65 0a 76 61 72 69 61 62 6c 65 20 7e 74 72 61 m.a.transient,.the.variable.~tra
37940 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 7e 20 61 6e 64 20 74 68 65 nsient-current-suffixes~.and.the
37960 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 0a 73 65 72 76 65 .function.~transient-args~.serve
37980 20 61 62 6f 75 74 20 74 68 65 20 73 61 6d 65 20 70 75 72 70 6f 73 65 20 61 73 20 74 68 65 20 76 .about.the.same.purpose.as.the.v
379a0 61 72 69 61 62 6c 65 73 20 7e 70 72 65 66 69 78 2d 61 72 67 7e 20 61 6e 64 0a 7e 63 75 72 72 65 ariables.~prefix-arg~.and.~curre
379c0 6e 74 2d 70 72 65 66 69 78 2d 61 72 67 7e 20 64 6f 20 66 6f 72 20 61 6e 79 20 63 6f 6d 6d 61 6e nt-prefix-arg~.do.for.any.comman
379e0 64 20 74 68 61 74 20 77 61 73 20 63 61 6c 6c 65 64 20 61 66 74 65 72 20 74 68 65 20 70 72 65 66 d.that.was.called.after.the.pref
37a00 69 78 0a 61 72 67 75 6d 65 6e 74 73 20 68 61 76 65 20 62 65 65 6e 20 73 65 74 20 75 73 69 6e 67 ix.arguments.have.been.set.using
37a20 20 61 20 63 6f 6d 6d 61 6e 64 20 73 75 63 68 20 61 73 20 7e 75 6e 69 76 65 72 73 61 6c 2d 61 72 .a.command.such.as.~universal-ar
37a40 67 75 6d 65 6e 74 7e 2e 0a 0a 23 2b 63 69 6e 64 65 78 3a 20 63 6f 6d 6d 61 6e 64 20 64 69 73 70 gument~...#+cindex:.command.disp
37a60 61 74 63 68 65 72 73 0a 54 72 61 6e 73 69 65 6e 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f atchers.Transient.can.be.used.to
37a80 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 6d 70 6c 65 20 e2 80 9c 63 6f 6d 6d 61 6e 64 20 64 69 73 .implement.simple....command.dis
37aa0 70 61 74 63 68 65 72 73 e2 80 9d 2e 20 20 54 68 65 0a 6d 61 69 6e 20 62 65 6e 65 66 69 74 20 74 patchers......The.main.benefit.t
37ac0 68 65 6e 20 69 73 20 74 68 61 74 20 74 68 65 20 75 73 65 72 20 63 61 6e 20 73 65 65 20 61 6c 6c hen.is.that.the.user.can.see.all
37ae0 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 63 6f 6d 6d 61 6e 64 73 0a 69 6e 20 61 20 74 65 6d .the.available.commands.in.a.tem
37b00 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 6e 20 62 75 66 66 65 72 2c 20 77 68 69 63 68 20 63 61 6e porarily.shown.buffer,.which.can
37b20 20 62 65 20 74 68 6f 75 67 68 74 20 6f 66 20 61 73 20 61 20 e2 80 9c 6d 65 6e 75 e2 80 9d 2e 0a .be.thought.of.as.a....menu.....
37b40 54 68 61 74 20 69 73 20 75 73 65 66 75 6c 20 62 79 20 69 74 73 65 6c 66 20 62 65 63 61 75 73 65 That.is.useful.by.itself.because
37b60 20 69 74 20 66 72 65 65 73 20 74 68 65 20 75 73 65 72 20 66 72 6f 6d 20 68 61 76 69 6e 67 20 74 .it.frees.the.user.from.having.t
37b80 6f 0a 72 65 6d 65 6d 62 65 72 20 61 6c 6c 20 74 68 65 20 6b 65 79 73 20 74 68 61 74 20 61 72 65 o.remember.all.the.keys.that.are
37ba0 20 76 61 6c 69 64 20 61 66 74 65 72 20 61 20 63 65 72 74 61 69 6e 20 70 72 65 66 69 78 20 6b 65 .valid.after.a.certain.prefix.ke
37bc0 79 20 6f 72 0a 63 6f 6d 6d 61 6e 64 2e 20 20 4d 61 67 69 74 27 73 20 7e 6d 61 67 69 74 2d 64 69 y.or.command...Magit's.~magit-di
37be0 73 70 61 74 63 68 7e 20 28 6f 6e 20 7b 7b 7b 6b 62 64 28 43 2d 78 20 4d 2d 67 29 7d 7d 7d 29 20 spatch~.(on.{{{kbd(C-x.M-g)}}}).
37c00 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 6f 66 0a 75 73 69 6e 67 20 54 command.is.an.example.of.using.T
37c20 72 61 6e 73 69 65 6e 74 20 74 6f 20 6d 65 72 65 6c 79 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 63 ransient.to.merely.implement.a.c
37c40 6f 6d 6d 61 6e 64 20 64 69 73 70 61 74 63 68 65 72 2e 0a 0a 49 6e 20 61 64 64 69 74 69 6f 6e 20 ommand.dispatcher...In.addition.
37c60 74 6f 20 74 68 61 74 2c 20 54 72 61 6e 73 69 65 6e 74 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 75 to.that,.Transient.also.allows.u
37c80 73 65 72 73 20 74 6f 20 69 6e 74 65 72 61 63 74 69 76 65 6c 79 20 70 61 73 73 0a 61 72 67 75 6d sers.to.interactively.pass.argum
37ca0 65 6e 74 73 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 73 65 20 61 72 67 75 6d 65 6e ents.to.commands...These.argumen
37cc0 74 73 20 63 61 6e 20 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 74 68 61 6e ts.can.be.much.more.complex.than
37ce0 0a 77 68 61 74 20 69 73 20 72 65 61 73 6f 6e 61 62 6c 65 20 77 68 65 6e 20 75 73 69 6e 67 20 70 .what.is.reasonable.when.using.p
37d00 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 72 65 20 69 73 20 61 20 6c 69 6d refix.arguments...There.is.a.lim
37d20 69 74 20 74 6f 0a 68 6f 77 20 6d 61 6e 79 20 61 73 70 65 63 74 73 20 6f 66 20 61 20 63 6f 6d 6d it.to.how.many.aspects.of.a.comm
37d40 61 6e 64 20 63 61 6e 20 62 65 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 75 73 69 6e 67 20 70 72 65 66 and.can.be.controlled.using.pref
37d60 69 78 0a 61 72 67 75 6d 65 6e 74 73 2e 20 20 46 75 72 74 68 65 72 6d 6f 72 65 2c 20 77 68 61 74 ix.arguments...Furthermore,.what
37d80 20 61 20 63 65 72 74 61 69 6e 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 6d 65 61 6e 73 .a.certain.prefix.argument.means
37da0 20 66 6f 72 0a 64 69 66 66 65 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 63 .for.different.commands.can.be.c
37dc0 6f 6d 70 6c 65 74 65 6c 79 20 64 69 66 66 65 72 65 6e 74 2c 20 61 6e 64 20 75 73 65 72 73 20 68 ompletely.different,.and.users.h
37de0 61 76 65 20 74 6f 20 72 65 61 64 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 6c 65 61 ave.to.read.documentation.to.lea
37e00 72 6e 20 61 6e 64 20 74 68 65 6e 20 63 6f 6d 6d 69 74 20 74 6f 20 6d 65 6d 6f 72 79 20 77 68 61 rn.and.then.commit.to.memory.wha
37e20 74 20 61 20 63 65 72 74 61 69 6e 20 70 72 65 66 69 78 0a 61 72 67 75 6d 65 6e 74 20 6d 65 61 6e t.a.certain.prefix.argument.mean
37e40 73 20 74 6f 20 61 20 63 65 72 74 61 69 6e 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 54 72 61 6e 73 69 65 s.to.a.certain.command...Transie
37e60 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 nt.suffix.commands,.on.the.other
37e80 20 68 61 6e 64 2c 20 63 61 6e 20 61 63 63 65 70 74 20 64 6f 7a 65 6e 73 20 6f 66 0a 64 69 66 66 .hand,.can.accept.dozens.of.diff
37ea0 65 72 65 6e 74 20 61 72 67 75 6d 65 6e 74 73 20 77 69 74 68 6f 75 74 20 74 68 65 20 75 73 65 72 erent.arguments.without.the.user
37ec0 20 68 61 76 69 6e 67 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 61 6e 79 74 68 69 6e 67 2e 0a 57 68 .having.to.remember.anything..Wh
37ee0 65 6e 20 75 73 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 2c 20 6f 6e 65 20 63 61 6e 20 63 61 6c 6c en.using.Transient,.one.can.call
37f00 20 61 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 61 .a.command.with.arguments.that.a
37f20 72 65 0a 6a 75 73 74 20 61 73 20 63 6f 6d 70 6c 65 78 20 61 73 20 77 68 65 6e 20 63 61 6c 6c 69 re.just.as.complex.as.when.calli
37f40 6e 67 20 74 68 65 20 73 61 6d 65 20 66 75 6e 63 74 69 6f 6e 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 ng.the.same.function.non-interac
37f60 74 69 76 65 6c 79 0a 66 72 6f 6d 20 4c 69 73 70 2e 0a 0a 49 6e 76 6f 6b 69 6e 67 20 61 20 74 72 tively.from.Lisp...Invoking.a.tr
37f80 61 6e 73 69 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 72 67 75 ansient.suffix.command.with.argu
37fa0 6d 65 6e 74 73 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 0a 69 6e 76 6f 6b 69 6e 67 20 61 20 63 ments.is.similar.to.invoking.a.c
37fc0 6f 6d 6d 61 6e 64 20 69 6e 20 61 20 73 68 65 6c 6c 20 77 69 74 68 20 63 6f 6d 6d 61 6e 64 2d 6c ommand.in.a.shell.with.command-l
37fe0 69 6e 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 61 6e 64 20 68 69 73 74 6f 72 79 0a 65 6e 61 62 6c ine.completion.and.history.enabl
38000 65 64 2e 20 20 4f 6e 65 20 62 65 6e 65 66 69 74 20 6f 66 20 74 68 65 20 54 72 61 6e 73 69 65 6e ed...One.benefit.of.the.Transien
38020 74 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 74 68 61 74 20 69 74 20 72 65 6d 65 6d 62 65 72 73 t.interface.is.that.it.remembers
38040 0a 68 69 73 74 6f 72 79 20 6e 6f 74 20 6f 6e 6c 79 20 6f 6e 20 61 20 67 6c 6f 62 61 6c 20 6c 65 .history.not.only.on.a.global.le
38060 76 65 6c 20 28 e2 80 9c 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 vel.(...this.command.was.invoked
38080 20 75 73 69 6e 67 0a 74 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 70 72 65 76 .using.these.arguments,.and.prev
380a0 69 6f 75 73 6c 79 20 69 74 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 75 73 69 6e 67 20 74 68 6f 73 iously.it.was.invoked.using.thos
380c0 65 20 6f 74 68 65 72 0a 61 72 67 75 6d 65 6e 74 73 e2 80 9d 29 2c 20 62 75 74 20 61 6c 73 6f 20 e.other.arguments...),.but.also.
380e0 72 65 6d 65 6d 62 65 72 73 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 69 6e 64 69 76 69 64 75 remembers.the.values.of.individu
38100 61 6c 20 61 72 67 75 6d 65 6e 74 73 0a 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 2e 20 20 53 65 65 al.arguments.independently...See
38120 20 5b 5b 2a 55 73 69 6e 67 20 48 69 73 74 6f 72 79 5d 5d 2e 0a 0a 41 66 74 65 72 20 61 20 74 72 .[[*Using.History]]...After.a.tr
38140 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 ansient.prefix.command.is.invoke
38160 64 2c 20 7b 7b 7b 6b 62 64 76 61 72 28 43 2d 68 20 3c 4b 45 59 3e 29 7d 7d 7d 20 63 61 6e 20 62 d,.{{{kbdvar(C-h.<KEY>)}}}.can.b
38180 65 20 75 73 65 64 20 74 6f 0a 73 68 6f 77 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e e.used.to.show.the.documentation
381a0 20 66 6f 72 20 74 68 65 20 69 6e 66 69 78 20 6f 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 .for.the.infix.or.suffix.command
381c0 20 74 68 61 74 20 7b 7b 7b 6b 62 64 76 61 72 28 3c 4b 45 59 3e 29 7d 7d 7d 20 69 73 0a 62 6f 75 .that.{{{kbdvar(<KEY>)}}}.is.bou
381e0 6e 64 20 74 6f 20 28 73 65 65 20 5b 5b 2a 47 65 74 74 69 6e 67 20 48 65 6c 70 20 66 6f 72 20 53 nd.to.(see.[[*Getting.Help.for.S
38200 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 5d 5d 29 2c 20 61 6e 64 20 69 6e 66 69 78 65 73 20 61 uffix.Commands]]),.and.infixes.a
38220 6e 64 0a 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 nd.suffixes.can.be.removed.from.
38240 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 75 73 69 6e 67 20 7b 7b 7b 6b 62 64 76 61 72 28 43 2d the.transient.using.{{{kbdvar(C-
38260 78 20 6c 20 3c 4b 45 59 3e 29 7d 7d 7d 2e 20 20 49 6e 66 69 78 65 73 0a 61 6e 64 20 73 75 66 66 x.l.<KEY>)}}}...Infixes.and.suff
38280 69 78 65 73 20 74 68 61 74 20 61 72 65 20 64 69 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c ixes.that.are.disabled.by.defaul
382a0 74 20 63 61 6e 20 62 65 20 65 6e 61 62 6c 65 64 20 74 68 65 20 73 61 6d 65 20 77 61 79 2e 0a 53 t.can.be.enabled.the.same.way..S
382c0 65 65 20 5b 5b 2a 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 ee.[[*Enabling.and.Disabling.Suf
382e0 66 69 78 65 73 5d 5d 2e 0a 0a 54 72 61 6e 73 69 65 6e 74 20 73 68 69 70 73 20 77 69 74 68 20 73 fixes]]...Transient.ships.with.s
38300 75 70 70 6f 72 74 20 66 6f 72 20 61 20 66 65 77 20 64 69 66 66 65 72 65 6e 74 20 74 79 70 65 73 upport.for.a.few.different.types
38320 20 6f 66 20 73 70 65 63 69 61 6c 69 7a 65 64 0a 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 .of.specialized.infix.commands..
38340 20 41 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 73 65 74 73 20 61 20 63 6f 6d 6d 61 6e 64 20 6c .A.command.that.sets.a.command.l
38360 69 6e 65 20 6f 70 74 69 6f 6e 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 68 61 73 20 64 69 66 ine.option,.for.example,.has.dif
38380 66 65 72 65 6e 74 20 6e 65 65 64 73 20 74 68 61 6e 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 ferent.needs.than.a.command.that
383a0 20 6d 65 72 65 6c 79 20 74 6f 67 67 6c 65 73 20 61 20 62 6f 6f 6c 65 61 6e 20 66 6c 61 67 2e 0a .merely.toggles.a.boolean.flag..
383c0 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 54 72 61 6e 73 69 65 6e 74 20 70 72 6f 76 69 64 65 73 Additionally,.Transient.provides
383e0 20 61 62 73 74 72 61 63 74 69 6f 6e 73 20 66 6f 72 20 64 65 66 69 6e 69 6e 67 20 6e 65 77 20 74 .abstractions.for.defining.new.t
38400 79 70 65 73 2c 0a 77 68 69 63 68 20 74 68 65 20 61 75 74 68 6f 72 20 6f 66 20 54 72 61 6e 73 69 ypes,.which.the.author.of.Transi
38420 65 6e 74 20 64 69 64 20 6e 6f 74 20 61 6e 74 69 63 69 70 61 74 65 20 28 6f 72 20 64 69 64 6e 27 ent.did.not.anticipate.(or.didn'
38440 74 20 67 65 74 20 61 72 6f 75 6e 64 0a 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 79 65 74 t.get.around.to.implementing.yet
38460 29 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 6c )...Note.that.suffix.commands.al
38480 73 6f 20 73 75 70 70 6f 72 74 20 72 65 67 75 6c 61 72 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 so.support.regular.prefix.argume
384a0 6e 74 73 2e 20 20 41 0a 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6d 61 79 20 65 76 65 6e 20 nts...A.suffix.command.may.even.
384c0 62 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 62 6f 74 68 20 69 6e 66 69 78 20 61 6e 64 20 70 72 be.called.with.both.infix.and.pr
384e0 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 0a 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e efix.arguments.at.the.same.time.
38500 20 20 49 66 20 79 6f 75 20 69 6e 76 6f 6b 65 20 61 20 63 6f 6d 6d 61 6e 64 20 61 73 20 61 20 73 ..If.you.invoke.a.command.as.a.s
38520 75 66 66 69 78 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e 74 0a 70 72 65 66 69 78 20 63 6f 6d 6d uffix.of.a.transient.prefix.comm
38540 61 6e 64 2c 20 62 75 74 20 61 6c 73 6f 20 77 61 6e 74 20 74 6f 20 70 61 73 73 20 70 72 65 66 69 and,.but.also.want.to.pass.prefi
38560 78 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 69 74 2c 20 74 68 65 6e 0a 66 69 72 73 74 20 69 6e x.arguments.to.it,.then.first.in
38580 76 6f 6b 65 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 6f 6e 6c voke.the.prefix.command,.and.onl
385a0 79 20 61 66 74 65 72 20 64 6f 69 6e 67 20 74 68 61 74 20 69 6e 76 6f 6b 65 20 74 68 65 0a 70 72 y.after.doing.that.invoke.the.pr
385c0 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2c 20 62 65 66 6f 72 65 20 66 69 6e 61 6c 6c 79 20 69 efix.arguments,.before.finally.i
385e0 6e 76 6f 6b 69 6e 67 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 49 66 20 nvoking.the.suffix.command...If.
38600 79 6f 75 0a 69 6e 73 74 65 61 64 20 62 65 67 61 6e 20 62 79 20 70 72 6f 76 69 64 69 6e 67 20 74 you.instead.began.by.providing.t
38620 68 65 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2c 20 74 68 65 6e 20 74 68 6f 73 65 20 he.prefix.arguments,.then.those.
38640 77 6f 75 6c 64 0a 61 70 70 6c 79 20 74 6f 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e would.apply.to.the.prefix.comman
38660 64 2c 20 6e 6f 74 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 4c 69 6b 65 d,.not.the.suffix.command...Like
38680 77 69 73 65 2c 20 69 66 20 79 6f 75 0a 77 61 6e 74 20 74 6f 20 63 68 61 6e 67 65 20 69 6e 66 69 wise,.if.you.want.to.change.infi
386a0 78 20 61 72 67 75 6d 65 6e 74 73 20 62 65 66 6f 72 65 20 69 6e 76 6f 6b 69 6e 67 20 61 20 73 75 x.arguments.before.invoking.a.su
386c0 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 0a 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e ffix.command.with.prefix.argumen
386e0 74 73 2c 20 74 68 65 6e 20 63 68 61 6e 67 65 20 74 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 ts,.then.change.the.infix.argume
38700 6e 74 73 20 62 65 66 6f 72 65 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 0a 70 72 65 66 69 78 20 61 nts.before.invoking.the.prefix.a
38720 72 67 75 6d 65 6e 74 73 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 72 65 67 75 6c rguments...In.other.words,.regul
38740 61 72 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 61 6c 77 61 79 73 0a 61 70 70 6c 79 ar.prefix.arguments.always.apply
38760 20 74 6f 20 74 68 65 20 6e 65 78 74 20 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 73 69 6e 63 65 20 .to.the.next.command,.and.since.
38780 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 2c 20 69 6e 66 69 78 20 61 6e 64 0a 73 75 66 66 transient.prefix,.infix.and.suff
387a0 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6a 75 73 74 20 72 65 67 75 6c 61 72 20 63 6f 6d ix.commands.are.just.regular.com
387c0 6d 61 6e 64 73 2c 20 74 68 65 20 73 61 6d 65 20 61 70 70 6c 69 65 73 20 74 6f 20 74 68 65 6d 2e mands,.the.same.applies.to.them.
387e0 0a 28 52 65 67 75 6c 61 72 20 70 72 65 66 69 78 20 6b 65 79 73 20 62 65 68 61 76 65 20 64 69 66 .(Regular.prefix.keys.behave.dif
38800 66 65 72 65 6e 74 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 79 20 61 72 65 20 6e 6f 74 20 63 6f ferently.because.they.are.not.co
38820 6d 6d 61 6e 64 73 0a 61 74 20 61 6c 6c 2c 20 69 6e 73 74 65 61 64 20 74 68 65 79 20 61 72 65 20 mmands.at.all,.instead.they.are.
38840 6a 75 73 74 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 73 65 71 75 65 6e 63 65 73 2c 20 61 just.incomplete.key.sequences,.a
38860 6e 64 20 74 68 6f 73 65 0a 63 61 6e 6e 6f 74 20 62 65 20 69 6e 74 65 72 72 75 70 74 65 64 20 77 nd.those.cannot.be.interrupted.w
38880 69 74 68 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 29 0a 0a 2a 2a 20 44 65 66 69 6e 69 ith.prefix.commands.)..**.Defini
388a0 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 0a 0a 41 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6e 73 69 ng.Transients..A.transient.consi
388c0 73 74 73 20 6f 66 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 61 74 20 6c sts.of.a.prefix.command.and.at.l
388e0 65 61 73 74 20 6f 6e 65 20 73 75 66 66 69 78 0a 63 6f 6d 6d 61 6e 64 2c 20 74 68 6f 75 67 68 20 east.one.suffix.command,.though.
38900 75 73 75 61 6c 6c 79 20 61 20 74 72 61 6e 73 69 65 6e 74 20 68 61 73 20 73 65 76 65 72 61 6c 20 usually.a.transient.has.several.
38920 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 20 infix.and.suffix.commands...The.
38940 62 65 6c 6f 77 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e below.macro.defines.the.transien
38960 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 2a 61 6e 64 2a 0a 62 69 6e 64 73 20 74 68 65 t.prefix.command.*and*.binds.the
38980 20 74 72 61 6e 73 69 65 6e 74 27 73 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f .transient's.infix.and.suffix.co
389a0 6d 6d 61 6e 64 73 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 69 74 0a 64 65 66 69 mmands...In.other.words,.it.defi
389c0 6e 65 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 6e 6f 74 20 nes.the.complete.transient,.not.
389e0 6a 75 73 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e just.the.transient.prefix.comman
38a00 64 0a 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 61 74 20 74 72 d.that.is.used.to.invoke.that.tr
38a20 61 6e 73 69 65 6e 74 2e 0a 0a 2d 20 4d 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 ansient...-.Macro:.transient-def
38a40 69 6e 65 2d 70 72 65 66 69 78 20 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 5b 64 6f 63 73 74 72 69 ine-prefix.name.arglist.[docstri
38a60 6e 67 5d 20 5b 6b 65 79 77 6f 72 64 20 76 61 6c 75 65 5d 2e 2e 2e 20 67 72 6f 75 70 2e 2e 2e 20 ng].[keyword.value]....group....
38a80 5b 62 6f 64 79 2e 2e 2e 5d 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 6e [body...].::....This.macro.defin
38aa0 65 73 20 7b 7b 7b 76 61 72 28 4e 41 4d 45 29 7d 7d 7d 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e es.{{{var(NAME)}}}.as.a.transien
38ac0 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 62 69 6e 64 73 20 74 68 65 0a 20 t.prefix.command.and.binds.the..
38ae0 20 74 72 61 6e 73 69 65 6e 74 27 73 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f .transient's.infix.and.suffix.co
38b00 6d 6d 61 6e 64 73 2e 0a 0a 20 20 7b 7b 7b 76 61 72 28 41 52 47 4c 49 53 54 29 7d 7d 7d 20 61 72 mmands.....{{{var(ARGLIST)}}}.ar
38b20 65 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 74 68 65 20 70 72 65 66 69 78 20 e.the.arguments.that.the.prefix.
38b40 63 6f 6d 6d 61 6e 64 20 74 61 6b 65 73 2e 0a 20 20 7b 7b 7b 76 61 72 28 44 4f 43 53 54 52 49 4e command.takes....{{{var(DOCSTRIN
38b60 47 29 7d 7d 7d 20 69 73 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e G)}}}.is.the.documentation.strin
38b80 67 20 61 6e 64 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 0a 0a 20 20 54 68 65 73 65 20 61 72 67 75 g.and.is.optional.....These.argu
38ba0 6d 65 6e 74 73 20 63 61 6e 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 66 6f 6c 6c 6f 77 65 64 ments.can.optionally.be.followed
38bc0 20 62 79 20 6b 65 79 77 6f 72 64 2d 76 61 6c 75 65 20 70 61 69 72 73 2e 0a 20 20 45 61 63 68 20 .by.keyword-value.pairs....Each.
38be0 6b 65 79 20 68 61 73 20 74 6f 20 62 65 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 key.has.to.be.a.keyword.symbol,.
38c00 65 69 74 68 65 72 20 7e 3a 63 6c 61 73 73 7e 20 6f 72 20 61 20 6b 65 79 77 6f 72 64 0a 20 20 61 either.~:class~.or.a.keyword...a
38c20 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 63 6f 6e 73 74 72 75 rgument.supported.by.the.constru
38c40 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 20 20 54 68 65 0a 20 20 7e 74 72 61 6e ctor.of.that.class...The...~tran
38c60 73 69 65 6e 74 2d 70 72 65 66 69 78 7e 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 69 66 20 74 sient-prefix~.class.is.used.if.t
38c80 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 0a 20 20 65 78 70 6c he.class.is.not.specified...expl
38ca0 69 63 69 74 6c 79 2e 0a 0a 20 20 7b 7b 7b 76 61 72 28 47 52 4f 55 50 29 7d 7d 7d 73 20 61 64 64 icitly.....{{{var(GROUP)}}}s.add
38cc0 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 .key.bindings.for.infix.and.suff
38ce0 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 73 70 65 63 69 66 79 0a 20 20 68 6f 77 20 74 68 ix.commands.and.specify...how.th
38d00 65 73 65 20 62 69 6e 64 69 6e 67 73 20 61 72 65 20 70 72 65 73 65 6e 74 65 64 20 69 6e 20 74 68 ese.bindings.are.presented.in.th
38d20 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 0a 20 20 7b e.menu.buffer...At.least.one...{
38d40 7b 7b 76 61 72 28 47 52 4f 55 50 29 7d 7d 7d 20 68 61 73 20 74 6f 20 62 65 20 73 70 65 63 69 66 {{var(GROUP)}}}.has.to.be.specif
38d60 69 65 64 2e 20 20 53 65 65 20 5b 5b 2a 42 69 6e 64 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 ied...See.[[*Binding.Suffix.and.
38d80 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 5d 5d 2e 0a 0a 20 20 54 68 65 20 7b 7b 7b 76 61 72 28 Infix.Commands]].....The.{{{var(
38da0 42 4f 44 59 29 7d 7d 7d 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 49 66 20 69 74 20 69 73 20 BODY)}}}.is.optional...If.it.is.
38dc0 6f 6d 69 74 74 65 64 2c 20 74 68 65 6e 20 7b 7b 7b 76 61 72 28 41 52 47 4c 49 53 54 29 7d 7d 7d omitted,.then.{{{var(ARGLIST)}}}
38de0 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 0a 20 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 64 .is.ignored.and...the.function.d
38e00 65 66 69 6e 69 74 69 6f 6e 20 62 65 63 6f 6d 65 73 3a 0a 0a 20 20 23 2b 42 45 47 49 4e 5f 53 52 efinition.becomes:....#+BEGIN_SR
38e20 43 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 20 20 20 C.emacs-lisp.....(lambda.().....
38e40 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 ..(interactive).......(transient
38e60 2d 73 65 74 75 70 20 27 4e 41 4d 45 29 29 0a 20 20 23 2b 45 4e 44 5f 53 52 43 0a 0a 20 20 49 66 -setup.'NAME))...#+END_SRC....If
38e80 20 7b 7b 7b 76 61 72 28 42 4f 44 59 29 7d 7d 7d 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 74 .{{{var(BODY)}}}.is.specified,.t
38ea0 68 65 6e 20 69 74 20 6d 75 73 74 20 62 65 67 69 6e 20 77 69 74 68 20 61 6e 20 7e 69 6e 74 65 72 hen.it.must.begin.with.an.~inter
38ec0 61 63 74 69 76 65 7e 20 66 6f 72 6d 0a 20 20 74 68 61 74 20 6d 61 74 63 68 65 73 20 7b 7b 7b 76 active~.form...that.matches.{{{v
38ee0 61 72 28 41 52 47 4c 49 53 54 29 7d 7d 7d 2c 20 61 6e 64 20 69 74 20 6d 75 73 74 20 63 61 6c 6c ar(ARGLIST)}}},.and.it.must.call
38f00 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 7e 2e 20 20 49 74 20 6d 61 79 2c 0a 20 20 68 .~transient-setup~...It.may,...h
38f20 6f 77 65 76 65 72 2c 20 63 61 6c 6c 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 6c 79 20 owever,.call.that.function.only.
38f40 77 68 65 6e 20 73 6f 6d 65 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 20 73 61 74 69 73 66 69 65 64 when.some.condition.is.satisfied
38f60 2e 0a 0a 20 20 23 2b 63 69 6e 64 65 78 3a 20 73 63 6f 70 65 20 6f 66 20 61 20 74 72 61 6e 73 69 .....#+cindex:.scope.of.a.transi
38f80 65 6e 74 0a 20 20 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 68 61 76 65 20 61 20 28 70 6f 73 ent...All.transients.have.a.(pos
38fa0 73 69 62 6c 79 20 7e 6e 69 6c 7e 29 20 76 61 6c 75 65 2c 20 77 68 69 63 68 20 69 73 20 65 78 70 sibly.~nil~).value,.which.is.exp
38fc0 6f 72 74 65 64 20 77 68 65 6e 0a 20 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 orted.when...suffix.commands.are
38fe0 20 63 61 6c 6c 65 64 2c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 63 61 6e 20 63 6f 6e 73 75 6d .called,.so.that.they.can.consum
39000 65 20 74 68 61 74 20 76 61 6c 75 65 2e 0a 20 20 46 6f 72 20 73 6f 6d 65 20 74 72 61 6e 73 69 65 e.that.value....For.some.transie
39020 6e 74 73 20 69 74 20 6d 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 68 61 76 nts.it.might.be.necessary.to.hav
39040 65 20 61 20 73 6f 72 74 20 6f 66 0a 20 20 73 65 63 6f 6e 64 61 72 79 20 76 61 6c 75 65 2c 20 63 e.a.sort.of...secondary.value,.c
39060 61 6c 6c 65 64 20 61 20 e2 80 9c 73 63 6f 70 65 e2 80 9d 2e 20 20 53 75 63 68 20 61 20 73 63 6f alled.a....scope......Such.a.sco
39080 70 65 20 77 6f 75 6c 64 20 75 73 75 61 6c 6c 79 20 62 65 0a 20 20 73 65 74 20 69 6e 20 74 68 65 pe.would.usually.be...set.in.the
390a0 20 63 6f 6d 6d 61 6e 64 27 73 20 7e 69 6e 74 65 72 61 63 74 69 76 65 7e 20 66 6f 72 6d 20 61 6e .command's.~interactive~.form.an
390c0 64 20 68 61 73 20 74 6f 20 62 65 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 0a 20 20 73 65 74 75 d.has.to.be.passed.to.the...setu
390e0 70 20 66 75 6e 63 74 69 6f 6e 3a 0a 0a 20 20 23 2b 42 45 47 49 4e 5f 53 52 43 20 65 6d 61 63 73 p.function:....#+BEGIN_SRC.emacs
39100 2d 6c 69 73 70 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 20 27 4e 41 4d 45 -lisp.....(transient-setup.'NAME
39120 20 6e 69 6c 20 6e 69 6c 20 3a 73 63 6f 70 65 20 53 43 4f 50 45 29 0a 20 20 23 2b 45 4e 44 5f 53 .nil.nil.:scope.SCOPE)...#+END_S
39140 52 43 0a 0a 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 RC....For.example,.the.scope.of.
39160 74 68 65 20 7e 6d 61 67 69 74 2d 62 72 61 6e 63 68 2d 63 6f 6e 66 69 67 75 72 65 7e 20 74 72 61 the.~magit-branch-configure~.tra
39180 6e 73 69 65 6e 74 20 69 73 0a 20 20 74 68 65 20 62 72 61 6e 63 68 20 77 68 6f 73 65 20 76 61 72 nsient.is...the.branch.whose.var
391a0 69 61 62 6c 65 73 20 61 72 65 20 62 65 69 6e 67 20 63 6f 6e 66 69 67 75 72 65 64 2e 0a 0a 53 6f iables.are.being.configured...So
391c0 6d 65 74 69 6d 65 73 20 6d 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 metimes.multiple.prefix.commands
391e0 20 73 68 61 72 65 20 61 20 63 6f 6d 6d 6f 6e 20 73 65 74 20 6f 66 20 73 75 66 66 69 78 65 73 2e .share.a.common.set.of.suffixes.
39200 0a 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 69 6c 65 20 7e 6d 61 67 69 74 2d 64 69 66 66 7e .For.example,.while.~magit-diff~
39220 20 28 7e 64 7e 29 20 61 6e 64 20 7e 6d 61 67 69 74 2d 64 69 66 66 2d 72 65 66 72 65 73 68 7e 20 .(~d~).and.~magit-diff-refresh~.
39240 28 7e 44 7e 29 20 6f 66 66 65 72 0a 64 69 66 66 65 72 65 6e 74 20 73 75 66 66 69 78 65 73 20 74 (~D~).offer.different.suffixes.t
39260 6f 20 61 63 74 75 61 6c 6c 79 20 63 72 65 61 74 65 20 6f 72 20 75 70 64 61 74 65 20 61 20 64 69 o.actually.create.or.update.a.di
39280 66 66 2c 20 74 68 65 79 20 62 6f 74 68 0a 6f 66 66 65 72 20 74 68 65 20 73 61 6d 65 20 69 6e 66 ff,.they.both.offer.the.same.inf
392a0 69 78 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 68 61 74 ix.arguments.to.control.how.that
392c0 20 64 69 66 66 20 69 73 20 66 6f 72 6d 61 74 74 65 64 2e 0a 53 75 63 68 20 73 68 61 72 65 64 20 .diff.is.formatted..Such.shared.
392e0 67 72 6f 75 70 73 20 73 68 6f 75 6c 64 20 62 65 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 7e groups.should.be.defined.using.~
39300 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 7e 0a 61 6e 64 20 74 68 65 6e transient-define-group~.and.then
39320 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 6d 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 65 73 2c 20 .included.in.multiple.prefixes,.
39340 62 79 20 75 73 69 6e 67 20 74 68 65 20 73 79 6d 62 6f 6c 20 74 68 61 74 0a 69 64 65 6e 74 69 66 by.using.the.symbol.that.identif
39360 69 65 73 20 74 68 65 20 67 72 6f 75 70 20 69 6e 20 74 68 65 20 70 72 65 66 69 78 20 64 65 66 69 ies.the.group.in.the.prefix.defi
39380 6e 69 74 69 6f 6e 2c 20 69 6e 20 61 20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 0a 79 6f 75 20 nition,.in.a.location.where.you.
393a0 77 6f 75 6c 64 20 6f 74 68 65 72 77 69 73 65 20 75 73 65 20 61 20 67 72 6f 75 70 20 76 65 63 74 would.otherwise.use.a.group.vect
393c0 6f 72 2e 20 20 49 66 20 61 6e 20 69 6e 63 6c 75 64 65 64 20 67 72 6f 75 70 20 69 73 0a 70 6c 61 or...If.an.included.group.is.pla
393e0 63 65 64 20 61 74 20 74 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 6f 66 20 61 20 70 72 65 66 69 78 ced.at.the.top-level.of.a.prefix
39400 20 28 61 73 20 6f 70 70 6f 73 65 64 20 6f 66 20 69 6e 73 69 64 65 20 69 6e 73 69 64 65 0a 61 20 .(as.opposed.of.inside.inside.a.
39420 76 65 63 74 6f 72 20 61 73 20 61 20 63 68 69 6c 64 20 67 72 6f 75 70 29 2c 20 74 68 65 6e 20 74 vector.as.a.child.group),.then.t
39440 68 65 20 73 79 6d 62 6f 6c 20 73 68 6f 75 6c 64 20 62 65 20 71 75 6f 74 65 64 2e 0a 0a 2d 20 4d he.symbol.should.be.quoted...-.M
39460 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 20 6e 61 6d acro:.transient-define-group.nam
39480 65 20 67 72 6f 75 70 2e 2e 2e 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 e.group....::....This.macro.defi
394a0 6e 65 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 67 72 6f 75 70 73 20 61 6e 64 20 73 74 6f 72 65 73 ne.one.or.more.groups.and.stores
394c0 20 74 68 65 6d 20 69 6e 20 73 79 6d 62 6f 6c 20 4e 41 4d 45 2e 0a 20 20 47 52 4f 55 50 73 20 68 .them.in.symbol.NAME....GROUPs.h
394e0 61 76 65 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 66 6f 72 20 7e 74 72 61 6e 73 69 ave.the.same.form.as.for.~transi
39500 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e 0a 0a 2a 2a 20 42 69 6e 64 69 6e 67 20 ent-define-prefix~...**.Binding.
39520 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 0a 0a 54 68 65 20 6d Suffix.and.Infix.Commands..The.m
39540 61 63 72 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 20 69 acro.~transient-define-prefix~.i
39560 73 20 75 73 65 64 20 74 6f 20 64 65 66 69 6e 65 20 61 20 74 72 61 6e 73 69 65 6e 74 2e 0a 54 68 s.used.to.define.a.transient..Th
39580 69 73 20 64 65 66 69 6e 65 73 20 74 68 65 20 61 63 74 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 20 is.defines.the.actual.transient.
395a0 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 28 73 65 65 20 5b 5b 2a 44 65 66 69 6e 69 6e 67 0a prefix.command.(see.[[*Defining.
395c0 54 72 61 6e 73 69 65 6e 74 73 5d 5d 29 20 61 6e 64 20 61 64 64 73 20 74 68 65 20 74 72 61 6e 73 Transients]]).and.adds.the.trans
395e0 69 65 6e 74 27 73 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 62 69 6e 64 69 6e 67 73 ient's.infix.and.suffix.bindings
39600 2c 20 61 73 0a 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 0a 0a 55 73 65 72 73 20 61 6e 64 ,.as.described.below...Users.and
39620 20 74 68 69 72 64 2d 70 61 72 74 79 20 70 61 63 6b 61 67 65 73 20 63 61 6e 20 61 64 64 20 61 64 .third-party.packages.can.add.ad
39640 64 69 74 69 6f 6e 61 6c 20 62 69 6e 64 69 6e 67 73 20 75 73 69 6e 67 0a 66 75 6e 63 74 69 6f 6e ditional.bindings.using.function
39660 73 20 73 75 63 68 20 61 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 s.such.as.~transient-insert-suff
39680 69 78 7e 20 28 73 65 65 20 5b 5b 2a 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 0a 54 ix~.(see.[[*Modifying.Existing.T
396a0 72 61 6e 73 69 65 6e 74 73 5d 5d 29 2e 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 ransients]])...These.functions.t
396c0 61 6b 65 20 61 20 e2 80 9c 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e e2 80 9d ake.a....suffix.specification...
396e0 20 61 73 20 6f 6e 65 20 6f 66 0a 74 68 65 69 72 20 61 72 67 75 6d 65 6e 74 73 2c 20 77 68 69 63 .as.one.of.their.arguments,.whic
39700 68 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 74 68 65 20 73 70 65 63 69 h.has.the.same.form.as.the.speci
39720 66 69 63 61 74 69 6f 6e 73 20 75 73 65 64 20 69 6e 0a 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 fications.used.in.~transient-def
39740 69 6e 65 2d 70 72 65 66 69 78 7e 2e 0a 0a 2a 2a 2a 20 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 ine-prefix~...***.Group.Specific
39760 61 74 69 6f 6e 73 0a 23 2b 63 69 6e 64 65 78 3a 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 ations.#+cindex:.group.specifica
39780 74 69 6f 6e 73 0a 0a 54 68 65 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d tions..The.suffix.and.infix.comm
397a0 61 6e 64 73 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e 74 20 61 72 65 20 6f 72 67 61 6e 69 7a 65 ands.of.a.transient.are.organize
397c0 64 20 69 6e 20 67 72 6f 75 70 73 2e 0a 54 68 65 20 67 72 6f 75 70 69 6e 67 20 63 6f 6e 74 72 6f d.in.groups..The.grouping.contro
397e0 6c 73 20 68 6f 77 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 73 ls.how.the.descriptions.of.the.s
39800 75 66 66 69 78 65 73 20 61 72 65 0a 6f 75 74 6c 69 6e 65 64 20 76 69 73 75 61 6c 6c 79 20 62 75 uffixes.are.outlined.visually.bu
39820 74 20 61 6c 73 6f 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20 t.also.makes.it.possible.to.set.
39840 63 65 72 74 61 69 6e 20 70 72 6f 70 65 72 74 69 65 73 0a 66 6f 72 20 61 20 73 65 74 20 6f 66 20 certain.properties.for.a.set.of.
39860 73 75 66 66 69 78 65 73 2e 0a 0a 53 65 76 65 72 61 6c 20 67 72 6f 75 70 20 63 6c 61 73 73 65 73 suffixes...Several.group.classes
39880 20 65 78 69 73 74 2c 20 73 6f 6d 65 20 6f 66 20 77 68 69 63 68 20 6f 72 67 61 6e 69 7a 65 20 73 .exist,.some.of.which.organize.s
398a0 75 66 66 69 78 65 73 20 69 6e 0a 73 75 62 67 72 6f 75 70 73 2e 20 20 49 6e 20 6d 6f 73 74 20 63 uffixes.in.subgroups...In.most.c
398c0 61 73 65 73 20 74 68 65 20 63 6c 61 73 73 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 ases.the.class.does.not.have.to.
398e0 62 65 20 73 70 65 63 69 66 69 65 64 0a 65 78 70 6c 69 63 69 74 6c 79 2c 20 62 75 74 20 73 65 65 be.specified.explicitly,.but.see
39900 20 5b 5b 2a 47 72 6f 75 70 20 43 6c 61 73 73 65 73 5d 5d 2e 0a 0a 47 72 6f 75 70 73 20 61 72 65 .[[*Group.Classes]]...Groups.are
39920 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 7e 74 72 61 6e 73 .specified.in.the.call.to.~trans
39940 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2c 20 75 73 69 6e 67 0a 76 65 63 74 6f ient-define-prefix~,.using.vecto
39960 72 73 2e 20 20 42 65 63 61 75 73 65 20 67 72 6f 75 70 73 20 61 72 65 20 72 65 70 72 65 73 65 6e rs...Because.groups.are.represen
39980 74 65 64 20 75 73 69 6e 67 20 76 65 63 74 6f 72 73 2c 20 77 65 20 63 61 6e 6e 6f 74 20 75 73 65 ted.using.vectors,.we.cannot.use
399a0 0a 73 71 75 61 72 65 20 62 72 61 63 6b 65 74 73 20 74 6f 20 69 6e 64 69 63 61 74 65 20 61 6e 20 .square.brackets.to.indicate.an.
399c0 6f 70 74 69 6f 6e 61 6c 20 65 6c 65 6d 65 6e 74 20 61 6e 64 20 69 6e 73 74 65 61 64 20 75 73 65 optional.element.and.instead.use
399e0 20 63 75 72 6c 79 0a 62 72 61 63 6b 65 74 73 20 74 6f 20 64 6f 20 74 68 65 20 6c 61 74 74 65 72 .curly.brackets.to.do.the.latter
39a00 2e 0a 0a 47 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 20 74 68 65 6e 20 68 61 76 ...Group.specifications.then.hav
39a20 65 20 74 68 69 73 20 66 6f 72 6d 3a 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d e.this.form:..#+begin_src.emacs-
39a40 6c 69 73 70 0a 20 20 5b 7b 4c 45 56 45 4c 7d 20 7b 44 45 53 43 52 49 50 54 49 4f 4e 7d 20 7b 4b lisp...[{LEVEL}.{DESCRIPTION}.{K
39a60 45 59 57 4f 52 44 20 56 41 4c 55 45 7d 2e 2e 2e 20 45 4c 45 4d 45 4e 54 2e 2e 2e 5d 0a 23 2b 65 EYWORD.VALUE}....ELEMENT...].#+e
39a80 6e 64 5f 73 72 63 0a 0a 54 68 65 20 7b 7b 7b 76 61 72 28 4c 45 56 45 4c 29 7d 7d 7d 20 69 73 20 nd_src..The.{{{var(LEVEL)}}}.is.
39aa0 6f 70 74 69 6f 6e 61 6c 20 61 6e 64 20 64 65 66 61 75 6c 74 73 20 74 6f 20 34 2e 20 20 53 65 65 optional.and.defaults.to.4...See
39ac0 20 5b 5b 2a 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 0a 53 75 66 66 69 .[[*Enabling.and.Disabling.Suffi
39ae0 78 65 73 5d 5d 2e 0a 0a 54 68 65 20 7b 7b 7b 76 61 72 28 44 45 53 43 52 49 50 54 49 4f 4e 29 7d xes]]...The.{{{var(DESCRIPTION)}
39b00 7d 7d 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 49 66 20 70 72 65 73 65 6e 74 2c 20 69 74 20 }}.is.optional...If.present,.it.
39b20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 68 65 61 64 69 6e 67 20 6f 66 0a 74 68 65 20 67 72 is.used.as.the.heading.of.the.gr
39b40 6f 75 70 2e 0a 0a 54 68 65 20 7b 7b 7b 76 61 72 28 4b 45 59 57 4f 52 44 29 7d 7d 7d 2d 7b 7b 7b oup...The.{{{var(KEYWORD)}}}-{{{
39b60 76 61 72 28 56 41 4c 55 45 29 7d 7d 7d 20 70 61 69 72 73 20 61 72 65 20 6f 70 74 69 6f 6e 61 6c var(VALUE)}}}.pairs.are.optional
39b80 2e 20 20 45 61 63 68 20 6b 65 79 77 6f 72 64 20 68 61 73 20 74 6f 20 62 65 20 61 0a 6b 65 79 77 ...Each.keyword.has.to.be.a.keyw
39ba0 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 7e 3a 63 6c 61 73 73 7e 20 6f 72 20 61 ord.symbol,.either.~:class~.or.a
39bc0 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 .keyword.argument.supported.by.t
39be0 68 65 0a 63 6f 6e 73 74 72 75 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 0a 0a 2d he.constructor.of.that.class...-
39c00 20 4f 6e 65 20 6f 66 20 74 68 65 73 65 20 6b 65 79 77 6f 72 64 73 2c 20 7e 3a 64 65 73 63 72 69 .One.of.these.keywords,.~:descri
39c20 70 74 69 6f 6e 7e 2c 20 69 73 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 73 70 65 63 69 66 79 ption~,.is.equivalent.to.specify
39c40 69 6e 67 0a 20 20 7b 7b 7b 76 61 72 28 44 45 53 43 52 49 50 54 49 4f 4e 29 7d 7d 7d 20 61 74 20 ing...{{{var(DESCRIPTION)}}}.at.
39c60 74 68 65 20 76 65 72 79 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 76 65 63 74 6f 72 the.very.beginning.of.the.vector
39c80 2e 20 20 54 68 65 20 72 65 63 6f 6d 6d 65 6e 64 61 74 69 6f 6e 0a 20 20 69 73 20 74 6f 20 75 73 ...The.recommendation...is.to.us
39ca0 65 20 7e 3a 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 6b e.~:description~.if.some.other.k
39cc0 65 79 77 6f 72 64 20 69 73 20 61 6c 73 6f 20 75 73 65 64 2c 20 66 6f 72 0a 20 20 63 6f 6e 73 69 eyword.is.also.used,.for...consi
39ce0 73 74 65 6e 63 79 2c 20 6f 72 20 7b 7b 7b 76 61 72 28 44 45 53 43 52 49 50 54 49 4f 4e 29 7d 7d stency,.or.{{{var(DESCRIPTION)}}
39d00 7d 20 6f 74 68 65 72 77 69 73 65 2c 20 62 65 63 61 75 73 65 20 69 74 20 6c 6f 6f 6b 73 20 62 65 }.otherwise,.because.it.looks.be
39d20 74 74 65 72 2e 0a 0a 2d 20 4c 69 6b 65 77 69 73 65 20 7e 3a 6c 65 76 65 6c 7e 20 69 73 20 65 71 tter...-.Likewise.~:level~.is.eq
39d40 75 69 76 61 6c 65 6e 74 20 74 6f 20 7b 7b 7b 76 61 72 28 4c 45 56 45 4c 29 7d 7d 7d 2e 0a 0a 2d uivalent.to.{{{var(LEVEL)}}}...-
39d60 20 4f 74 68 65 72 20 69 6d 70 6f 72 74 61 6e 74 20 6b 65 79 77 6f 72 64 73 20 69 6e 63 6c 75 64 .Other.important.keywords.includ
39d80 65 20 74 68 65 20 7e 3a 69 66 2e 2e 2e 7e 20 61 6e 64 20 7e 3a 69 6e 61 70 74 2d 69 66 2e 2e 2e e.the.~:if...~.and.~:inapt-if...
39da0 7e 0a 20 20 6b 65 79 77 6f 72 64 73 2e 20 20 54 68 65 73 65 20 6b 65 79 77 6f 72 64 73 20 63 6f ~...keywords...These.keywords.co
39dc0 6e 74 72 6f 6c 20 77 68 65 74 68 65 72 20 74 68 65 20 67 72 6f 75 70 20 69 73 20 61 76 61 69 6c ntrol.whether.the.group.is.avail
39de0 61 62 6c 65 0a 20 20 69 6e 20 61 20 63 65 72 74 61 69 6e 20 73 69 74 75 61 74 69 6f 6e 2e 0a 0a able...in.a.certain.situation...
39e00 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 6f 6e 65 20 67 72 6f 75 70 20 6f 66 20 74 68 65 20 ..For.example,.one.group.of.the.
39e20 7e 6d 61 67 69 74 2d 72 65 62 61 73 65 7e 20 74 72 61 6e 73 69 65 6e 74 20 75 73 65 73 20 7e 3a ~magit-rebase~.transient.uses.~:
39e40 69 66 0a 20 20 6d 61 67 69 74 2d 72 65 62 61 73 65 2d 69 6e 2d 70 72 6f 67 72 65 73 73 2d 70 7e if...magit-rebase-in-progress-p~
39e60 2c 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 75 66 66 69 78 65 73 20 74 68 ,.which.contains.the.suffixes.th
39e80 61 74 20 61 72 65 0a 20 20 75 73 65 66 75 6c 20 77 68 69 6c 65 20 72 65 62 61 73 65 20 69 73 20 at.are...useful.while.rebase.is.
39ea0 61 6c 72 65 61 64 79 20 69 6e 20 70 72 6f 67 72 65 73 73 3b 20 61 6e 64 20 61 6e 6f 74 68 65 72 already.in.progress;.and.another
39ec0 20 74 68 61 74 20 75 73 65 73 0a 20 20 7e 3a 69 66 2d 6e 6f 74 20 6d 61 67 69 74 2d 72 65 62 61 .that.uses...~:if-not.magit-reba
39ee0 73 65 2d 69 6e 2d 70 72 6f 67 72 65 73 73 2d 70 7e 2c 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e se-in-progress-p~,.which.contain
39f00 73 20 74 68 65 20 73 75 66 66 69 78 65 73 20 74 68 61 74 0a 20 20 69 6e 69 74 69 61 74 65 20 61 s.the.suffixes.that...initiate.a
39f20 20 72 65 62 61 73 65 2e 0a 0a 20 20 54 68 65 73 65 20 70 72 65 64 69 63 61 74 65 73 20 63 61 6e .rebase.....These.predicates.can
39f40 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 6f 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 .also.be.used.on.individual.suff
39f60 69 78 65 73 20 61 6e 64 20 61 72 65 0a 20 20 6f 6e 6c 79 20 64 6f 63 75 6d 65 6e 74 65 64 20 6f ixes.and.are...only.documented.o
39f80 6e 63 65 2c 20 73 65 65 20 5b 5b 2a 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 5d 5d 2e 0a 0a nce,.see.[[*Predicate.Slots]]...
39fa0 2d 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 7e 3a 68 69 64 65 7e 2c 20 69 66 20 6e 6f 6e 2d 7e -.The.value.of.~:hide~,.if.non-~
39fc0 6e 69 6c 7e 2c 20 69 73 20 61 20 70 72 65 64 69 63 61 74 65 20 74 68 61 74 20 63 6f 6e 74 72 6f nil~,.is.a.predicate.that.contro
39fe0 6c 73 0a 20 20 77 68 65 74 68 65 72 20 74 68 65 20 67 72 6f 75 70 20 69 73 20 68 69 64 64 65 6e ls...whether.the.group.is.hidden
3a000 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 54 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 66 .by.default...The.key.bindings.f
3a020 6f 72 0a 20 20 73 75 66 66 69 78 65 73 20 6f 66 20 61 20 68 69 64 64 65 6e 20 67 72 6f 75 70 20 or...suffixes.of.a.hidden.group.
3a040 73 68 6f 75 6c 64 20 61 6c 6c 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 70 72 65 66 69 78 20 6b should.all.use.the.same.prefix.k
3a060 65 79 2e 0a 20 20 50 72 65 73 73 69 6e 67 20 74 68 61 74 20 70 72 65 66 69 78 20 6b 65 79 20 73 ey....Pressing.that.prefix.key.s
3a080 68 6f 75 6c 64 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 20 74 68 65 20 67 72 6f 75 70 hould.temporarily.show.the.group
3a0a0 20 61 6e 64 20 69 74 73 0a 20 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 61 73 73 75 6d .and.its...suffixes,.which.assum
3a0c0 65 73 20 74 68 61 74 20 61 20 70 72 65 64 69 63 61 74 65 20 6c 69 6b 65 20 74 68 69 73 20 69 73 es.that.a.predicate.like.this.is
3a0e0 20 75 73 65 64 3a 0a 0a 20 20 23 2b 42 45 47 49 4e 5f 53 52 43 20 65 6d 61 63 73 2d 6c 69 73 70 .used:....#+BEGIN_SRC.emacs-lisp
3a100 0a 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 20 20 20 20 20 28 65 71 20 28 63 61 72 20 74 .....(lambda.().......(eq.(car.t
3a120 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 ransient--redisplay-key)........
3a140 20 20 20 3f 5c 43 2d 63 29 29 20 3b 20 74 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 73 68 61 72 ...?\C-c)).;.the.prefix.key.shar
3a160 65 64 20 62 79 20 61 6c 6c 20 62 69 6e 64 69 6e 67 73 0a 20 20 23 2b 45 4e 44 5f 53 52 43 0a 0a ed.by.all.bindings...#+END_SRC..
3a180 2d 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 7e 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 7e -.The.value.of.~:setup-children~
3a1a0 2c 20 69 66 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 ,.if.non-~nil~,.is.a.function.th
3a1c0 61 74 20 74 61 6b 65 73 0a 20 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 2c 20 61 20 70 6f 74 65 6e at.takes...one.argument,.a.poten
3a1e0 74 69 61 6c 6c 79 20 6c 69 73 74 20 6f 66 20 63 68 69 6c 64 72 65 6e 2c 20 61 6e 64 20 6d 75 73 tially.list.of.children,.and.mus
3a200 74 20 72 65 74 75 72 6e 20 61 20 6c 69 73 74 0a 20 20 6f 66 20 63 68 69 6c 64 72 65 6e 20 6f 72 t.return.a.list...of.children.or
3a220 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 74 2e 20 20 54 68 69 73 20 63 61 6e 20 65 69 74 68 65 72 .an.empty.list...This.can.either
3a240 20 62 65 20 75 73 65 64 20 74 6f 20 73 6f 6d 65 68 6f 77 0a 20 20 74 72 61 6e 73 66 6f 72 6d 20 .be.used.to.somehow...transform.
3a260 74 68 65 20 67 72 6f 75 70 27 73 20 63 68 69 6c 64 72 65 6e 20 74 68 61 74 20 77 65 72 65 20 64 the.group's.children.that.were.d
3a280 65 66 69 6e 65 64 20 74 68 65 20 6e 6f 72 6d 61 6c 20 77 61 79 2c 20 6f 72 0a 20 20 74 6f 20 64 efined.the.normal.way,.or...to.d
3a2a0 79 6e 61 6d 69 63 61 6c 6c 79 20 63 72 65 61 74 65 20 74 68 65 20 63 68 69 6c 64 72 65 6e 20 66 ynamically.create.the.children.f
3a2c0 72 6f 6d 20 73 63 72 61 74 63 68 2e 0a 0a 20 20 54 68 65 20 72 65 74 75 72 6e 65 64 20 63 68 69 rom.scratch.....The.returned.chi
3a2e0 6c 64 72 65 6e 20 6d 75 73 74 20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 ldren.must.have.the.same.form.as
3a300 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 20 20 70 72 65 66 69 78 27 73 20 7e 74 72 61 6e 73 .stored.in.the...prefix's.~trans
3a320 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 7e 20 70 72 6f 70 65 72 74 79 2c 20 62 75 74 20 69 74 20 69 ient--layout~.property,.but.it.i
3a340 73 20 6f 66 74 65 6e 20 6d 6f 72 65 20 63 6f 6e 76 65 6e 69 65 6e 74 0a 20 20 74 6f 20 75 73 65 s.often.more.convenient...to.use
3a360 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 .the.same.form.as.understood.by.
3a380 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2c 0a 20 20 64 65 73 ~transient-define-prefix~,...des
3a3a0 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 20 20 49 66 20 79 6f 75 20 75 73 65 20 74 68 65 20 6c 61 cribed.below...If.you.use.the.la
3a3c0 74 74 65 72 20 61 70 70 72 6f 61 63 68 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65 0a 20 tter.approach,.you.can.use.the..
3a3e0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 65 73 7e 20 61 6e 64 20 .~transient-parse-suffixes~.and.
3a400 7e 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 7e 20 66 75 6e 63 74 69 6f ~transient-parse-suffix~.functio
3a420 6e 73 20 74 6f 0a 20 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 65 6d 20 66 72 6f 6d 20 74 68 65 20 ns.to...transform.them.from.the.
3a440 63 6f 6e 76 65 6e 69 65 6e 74 20 74 6f 20 74 68 65 20 65 78 70 65 63 74 65 64 20 66 6f 72 6d 2e convenient.to.the.expected.form.
3a460 20 20 44 65 70 65 6e 64 69 6e 67 0a 20 20 6f 6e 20 74 68 65 20 75 73 65 64 20 67 72 6f 75 70 20 ..Depending...on.the.used.group.
3a480 63 6c 61 73 73 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 65 73 class,.~transient-parse-suffixes
3a4a0 7e 27 73 20 53 55 46 46 49 58 45 53 20 6d 75 73 74 20 62 65 0a 20 20 61 20 6c 69 73 74 20 6f 66 ~'s.SUFFIXES.must.be...a.list.of
3a4c0 20 67 72 6f 75 70 20 76 65 63 74 6f 72 73 20 28 66 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 .group.vectors.(for.~transient-c
3a4e0 6f 6c 75 6d 6e 73 7e 29 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 73 75 66 66 69 78 0a 20 20 6c olumns~).or.a.list.of.suffix...l
3a500 69 73 74 73 20 28 66 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 67 72 6f 75 70 20 63 6c 61 73 73 65 ists.(for.all.other.group.classe
3a520 73 29 2e 0a 0a 20 20 49 66 20 79 6f 75 20 65 78 70 6c 69 63 69 74 6c 79 20 73 70 65 63 69 66 79 s).....If.you.explicitly.specify
3a540 20 63 68 69 6c 64 72 65 6e 20 61 6e 64 20 74 68 65 6e 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 65 .children.and.then.transform.the
3a560 6d 20 75 73 69 6e 67 0a 20 20 7e 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 7e 2c 20 74 68 65 m.using...~:setup-children~,.the
3a580 6e 20 74 68 65 20 63 6c 61 73 73 20 6f 66 20 74 68 65 20 67 72 6f 75 70 20 69 73 20 64 65 74 65 n.the.class.of.the.group.is.dete
3a5a0 72 6d 69 6e 65 64 20 61 73 20 75 73 75 61 6c 2c 0a 20 20 62 61 73 65 64 20 6f 6e 20 65 78 70 6c rmined.as.usual,...based.on.expl
3a5c0 69 63 69 74 6c 79 20 73 70 65 63 69 66 69 65 64 20 63 68 69 6c 64 72 65 6e 2e 0a 0a 20 20 49 66 icitly.specified.children.....If
3a5e0 20 79 6f 75 20 64 6f 20 6e 6f 74 20 65 78 70 6c 69 63 69 74 6c 79 20 73 70 65 63 69 66 79 20 63 .you.do.not.explicitly.specify.c
3a600 68 69 6c 64 72 65 6e 20 61 6e 64 20 74 68 75 73 20 72 65 6c 79 20 73 6f 6c 65 6c 79 20 6f 6e 0a hildren.and.thus.rely.solely.on.
3a620 20 20 7e 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 7e 2c 20 74 68 65 6e 20 79 6f 75 20 6d 75 ..~:setup-children~,.then.you.mu
3a640 73 74 20 73 70 65 63 69 66 79 20 74 68 65 20 63 6c 61 73 73 20 75 73 69 6e 67 20 7e 3a 63 6c 61 st.specify.the.class.using.~:cla
3a660 73 73 7e 2e 0a 20 20 46 6f 72 20 62 61 63 6b 77 61 72 64 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 ss~....For.backward.compatibilit
3a680 79 2c 20 69 66 20 79 6f 75 20 66 61 69 6c 20 74 6f 20 64 6f 20 73 6f 2c 20 7e 74 72 61 6e 73 69 y,.if.you.fail.to.do.so,.~transi
3a6a0 65 6e 74 2d 63 6f 6c 75 6d 6e 7e 0a 20 20 69 73 20 75 73 65 64 20 61 6e 64 20 61 20 77 61 72 6e ent-column~...is.used.and.a.warn
3a6c0 69 6e 67 20 69 73 20 64 69 73 70 6c 61 79 65 64 2e 20 20 54 68 69 73 20 77 61 72 6e 69 6e 67 20 ing.is.displayed...This.warning.
3a6e0 77 69 6c 6c 20 65 76 65 6e 74 75 61 6c 6c 79 0a 20 20 62 65 20 72 65 70 6c 61 63 65 64 20 77 69 will.eventually...be.replaced.wi
3a700 74 68 20 61 6e 20 65 72 72 6f 72 2e 0a 0a 20 20 23 2b 42 45 47 49 4e 5f 53 52 43 20 65 6d 61 63 th.an.error.....#+BEGIN_SRC.emac
3a720 73 2d 6c 69 73 70 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 s-lisp.....(transient-define-pre
3a740 66 69 78 20 6d 79 2d 66 69 6e 64 65 72 2d 62 79 2d 6b 65 79 77 6f 72 64 20 28 29 0a 20 20 20 20 fix.my-finder-by-keyword.().....
3a760 20 20 22 53 65 6c 65 63 74 20 61 20 6b 65 79 77 6f 72 64 20 61 6e 64 20 6c 69 73 74 20 6d 61 74 .."Select.a.keyword.and.list.mat
3a780 63 68 69 6e 67 20 70 61 63 6b 61 67 65 73 2e 22 0a 20 20 20 20 20 20 3b 3b 20 54 68 65 20 72 65 ching.packages.".......;;.The.re
3a7a0 61 6c 20 60 66 69 6e 64 65 72 2d 62 79 2d 6b 65 79 77 6f 72 64 27 20 69 73 20 6d 6f 72 65 20 63 al.`finder-by-keyword'.is.more.c
3a7c0 6f 6e 76 65 6e 69 65 6e 74 0a 20 20 20 20 20 20 3b 3b 20 6f 66 20 63 6f 75 72 73 65 2c 20 62 75 onvenient.......;;.of.course,.bu
3a7e0 74 20 74 68 61 74 20 69 73 20 6e 6f 74 20 74 68 65 20 70 6f 69 6e 74 20 68 65 72 65 2e 0a 20 20 t.that.is.not.the.point.here....
3a800 20 20 20 20 5b 3a 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 0a 20 20 ....[:class.transient-columns...
3a820 20 20 20 20 20 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 0a 20 20 20 20 20 20 20 28 6c 61 6d .....:setup-children........(lam
3a840 62 64 61 20 28 5f 29 0a 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 bda.(_)..........(transient-pars
3a860 65 2d 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 20 20 20 20 20 27 6d 79 2d 66 69 6e 64 65 72 2d e-suffixes...........'my-finder-
3a880 62 79 2d 6b 65 79 77 6f 72 64 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 63 68 61 72 by-keyword...........(let.((char
3a8a0 20 28 31 2d 20 3f 41 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 20 .(1-.?A))).............(mapcar..
3a8c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 20 61 20 6c 69 73 74 20 2e 2e 2e 0a 20 20 20 ................;.a.list........
3a8e0 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 70 61 72 74 69 74 69 6f 6e 29 0a 20 20 ..........(lambda.(partition)...
3a900 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 63 6f 6e 63 61 74 20 20 20 20 20 20 20 20 20 20 20 .............(vconcat...........
3a920 20 20 20 3b 20 6f 66 20 67 72 6f 75 70 20 76 65 63 74 6f 72 73 20 2e 2e 2e 0a 20 20 20 20 20 20 ...;.of.group.vectors...........
3a940 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 65 6c 74 29 0a ..........(mapcar.(lambda.(elt).
3a960 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 6c 65 74 20 28 ..........................(let.(
3a980 28 6b 65 79 77 6f 72 64 20 28 73 79 6d 62 6f 6c 2d 6e 61 6d 65 20 28 63 61 72 20 65 6c 74 29 29 (keyword.(symbol-name.(car.elt))
3a9a0 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 20 20 20 ))..............................
3a9c0 20 20 20 20 20 20 20 20 3b 20 2e 2e 2e 20 77 68 65 72 65 20 65 61 63 68 20 73 75 66 66 69 78 20 ........;.....where.each.suffix.
3a9e0 69 73 20 61 20 6c 69 73 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 is.a.list.......................
3aa00 20 20 20 20 20 20 28 6c 69 73 74 20 28 66 6f 72 6d 61 74 20 22 25 63 22 20 28 63 6c 2d 69 6e 63 ......(list.(format."%c".(cl-inc
3aa20 66 20 63 68 61 72 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 f.char))........................
3aa40 20 20 20 20 20 20 20 20 20 20 20 6b 65 79 77 6f 72 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...........keyword..............
3aa60 20 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 61 20 28 29 0a .....................(lambda.().
3aa80 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 ................................
3aaa0 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ....(interactive)...............
3aac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 69 6e 64 65 72 2d 6c 69 ......................(finder-li
3aae0 73 74 2d 6d 61 74 63 68 65 73 20 6b 65 79 77 6f 72 64 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 st-matches.keyword))))).........
3ab00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 61 72 74 69 74 69 6f 6e 29 29 29 0a 20 20 20 ................partition)))....
3ab20 20 20 20 20 20 20 20 20 20 20 28 73 65 71 2d 70 61 72 74 69 74 69 6f 6e 20 66 69 6e 64 65 72 2d ..........(seq-partition.finder-
3ab40 6b 6e 6f 77 6e 2d 6b 65 79 77 6f 72 64 73 20 37 29 29 29 29 29 5d 29 0a 20 20 23 2b 45 4e 44 5f known-keywords.7)))))])...#+END_
3ab60 53 52 43 0a 0a 2d 20 54 68 65 20 62 6f 6f 6c 65 61 6e 20 7e 3a 70 61 64 2d 6b 65 79 73 7e 20 61 SRC..-.The.boolean.~:pad-keys~.a
3ab80 72 67 75 6d 65 6e 74 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6b 65 79 73 20 6f 66 rgument.controls.whether.keys.of
3aba0 20 61 6c 6c 20 73 75 66 66 69 78 65 73 0a 20 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 61 20 67 .all.suffixes...contained.in.a.g
3abc0 72 6f 75 70 20 61 72 65 20 72 69 67 68 74 20 70 61 64 64 65 64 2c 20 65 66 66 65 63 74 69 76 65 roup.are.right.padded,.effective
3abe0 6c 79 20 61 6c 69 67 6e 69 6e 67 20 74 68 65 0a 20 20 64 65 73 63 72 69 70 74 69 6f 6e 73 2e 0a ly.aligning.the...descriptions..
3ac00 0a 2d 20 49 66 20 61 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 61 63 63 65 70 74 73 .-.If.a.keyword.argument.accepts
3ac20 20 61 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 76 61 6c 75 65 2c 20 79 6f 75 20 61 6e 20 75 73 65 .a.function.as.value,.you.an.use
3ac40 20 61 0a 20 20 7e 6c 61 6d 62 64 61 7e 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 41 73 20 61 20 .a...~lambda~.expression...As.a.
3ac60 73 70 65 63 69 61 6c 20 63 61 73 65 2c 20 74 68 65 20 7e 23 23 7e 20 6d 61 63 72 6f 20 28 77 68 special.case,.the.~##~.macro.(wh
3ac80 69 63 68 20 72 65 74 75 72 6e 73 20 61 0a 20 20 7e 6c 61 6d 62 64 61 7e 20 65 78 70 72 65 73 73 ich.returns.a...~lambda~.express
3aca0 69 6f 6e 20 61 6e 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 7e 6c ion.and.is.implemented.in.the.~l
3acc0 6c 61 6d 61 7e 20 70 61 63 6b 61 67 65 29 20 69 73 20 61 6c 73 6f 0a 20 20 73 75 70 70 6f 72 74 lama~.package).is.also...support
3ace0 65 64 2e 20 20 49 6e 73 69 64 65 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 ed...Inside.group.specifications
3ad00 2c 20 74 68 65 20 75 73 65 20 6f 66 20 7e 23 23 7e 20 69 73 20 6e 6f 74 0a 20 20 73 75 70 70 6f ,.the.use.of.~##~.is.not...suppo
3ad20 72 74 65 64 20 61 6e 79 77 68 65 72 65 20 62 75 74 20 64 69 72 65 63 74 6c 79 20 66 6f 6c 6c 6f rted.anywhere.but.directly.follo
3ad40 77 69 6e 67 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2e 0a 0a 54 68 65 20 7b 7b 7b 76 wing.a.keyword.symbol...The.{{{v
3ad60 61 72 28 45 4c 45 4d 45 4e 54 29 7d 7d 7d 73 20 61 72 65 20 65 69 74 68 65 72 20 61 6c 6c 20 73 ar(ELEMENT)}}}s.are.either.all.s
3ad80 75 62 67 72 6f 75 70 73 2c 20 6f 72 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 61 6e 64 20 73 74 ubgroups,.or.all.suffixes.and.st
3ada0 72 69 6e 67 73 2e 0a 28 41 74 20 6c 65 61 73 74 20 63 75 72 72 65 6e 74 6c 79 20 6e 6f 20 67 72 rings..(At.least.currently.no.gr
3adc0 6f 75 70 20 74 79 70 65 20 65 78 69 73 74 73 20 74 68 61 74 20 77 6f 75 6c 64 20 61 6c 6c 6f 77 oup.type.exists.that.would.allow
3ade0 20 6d 69 78 69 6e 67 0a 73 75 62 67 72 6f 75 70 73 20 77 69 74 68 20 63 6f 6d 6d 61 6e 64 73 20 .mixing.subgroups.with.commands.
3ae00 61 74 20 74 68 65 20 73 61 6d 65 20 6c 65 76 65 6c 2c 20 74 68 6f 75 67 68 20 69 6e 20 70 72 69 at.the.same.level,.though.in.pri
3ae20 6e 63 69 70 6c 65 20 74 68 65 72 65 0a 69 73 20 6e 6f 74 68 69 6e 67 20 74 68 61 74 20 70 72 65 nciple.there.is.nothing.that.pre
3ae40 76 65 6e 74 73 20 74 68 61 74 2e 29 0a 0a 49 66 20 74 68 65 20 7b 7b 7b 76 61 72 28 45 4c 45 4d vents.that.)..If.the.{{{var(ELEM
3ae60 45 4e 54 29 7d 7d 7d 73 20 61 72 65 20 6e 6f 74 20 73 75 62 67 72 6f 75 70 73 2c 20 74 68 65 6e ENT)}}}s.are.not.subgroups,.then
3ae80 20 74 68 65 79 20 63 61 6e 20 62 65 20 61 20 6d 69 78 74 75 72 65 20 6f 66 0a 6c 69 73 74 73 2c .they.can.be.a.mixture.of.lists,
3aea0 20 77 68 69 63 68 20 73 70 65 63 69 66 79 20 63 6f 6d 6d 61 6e 64 73 2c 20 61 6e 64 20 73 74 72 .which.specify.commands,.and.str
3aec0 69 6e 67 73 2e 20 20 53 74 72 69 6e 67 73 20 61 72 65 20 69 6e 73 65 72 74 65 64 0a 76 65 72 62 ings...Strings.are.inserted.verb
3aee0 61 74 69 6d 20 69 6e 74 6f 20 74 68 65 20 62 75 66 66 65 72 2e 20 20 54 68 65 20 65 6d 70 74 79 atim.into.the.buffer...The.empty
3af00 20 73 74 72 69 6e 67 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 6e 73 65 72 74 20 67 61 .string.can.be.used.to.insert.ga
3af20 70 73 0a 62 65 74 77 65 65 6e 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 69 73 20 70 61 ps.between.suffixes,.which.is.pa
3af40 72 74 69 63 75 6c 61 72 6c 79 20 75 73 65 66 75 6c 20 69 66 20 74 68 65 20 73 75 66 66 69 78 65 rticularly.useful.if.the.suffixe
3af60 73 20 61 72 65 0a 6f 75 74 6c 69 6e 65 64 20 61 73 20 61 20 74 61 62 6c 65 2e 0a 0a 49 6e 73 69 s.are.outlined.as.a.table...Insi
3af80 64 65 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2c 20 69 6e 63 6c 75 64 69 de.group.specifications,.includi
3afa0 6e 67 20 69 6e 73 69 64 65 20 63 6f 6e 74 61 69 6e 65 64 20 73 75 66 66 69 78 0a 73 70 65 63 69 ng.inside.contained.suffix.speci
3afc0 66 69 63 61 74 69 6f 6e 73 2c 20 6e 6f 74 68 69 6e 67 20 68 61 73 20 74 6f 20 62 65 20 71 75 6f fications,.nothing.has.to.be.quo
3afe0 74 65 64 20 61 6e 64 20 71 75 6f 74 69 6e 67 20 61 6e 79 77 61 79 20 69 73 0a 69 6e 76 61 6c 69 ted.and.quoting.anyway.is.invali
3b000 64 2e 20 20 54 68 65 20 76 61 6c 75 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 6b 65 79 77 6f 72 d...The.value.following.a.keywor
3b020 64 2c 20 63 61 6e 20 62 65 20 65 78 70 6c 69 63 69 74 6c 79 20 75 6e 71 75 6f 74 65 64 0a 75 73 d,.can.be.explicitly.unquoted.us
3b040 69 6e 67 20 7e 2c 7e 2e 20 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 73 20 65 78 70 65 72 69 ing.~,~...This.feature.is.experi
3b060 6d 65 6e 74 61 6c 20 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 61 76 6f 69 64 65 64 2e 0a 0a 54 mental.and.should.be.avoided...T
3b080 68 65 20 66 6f 72 6d 20 6f 66 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 he.form.of.suffix.specifications
3b0a0 20 69 73 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 6e 65 78 74 20 6e 6f 64 65 2e .is.documented.in.the.next.node.
3b0c0 0a 0a 2a 2a 2a 20 53 75 66 66 69 78 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 0a 23 2b 63 69 ..***.Suffix.Specifications.#+ci
3b0e0 6e 64 65 78 3a 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 0a 0a 41 20 74 ndex:.suffix.specifications..A.t
3b100 72 61 6e 73 69 65 6e 74 27 73 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d ransient's.suffix.and.infix.comm
3b120 61 6e 64 73 20 61 72 65 20 62 6f 75 6e 64 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e ands.are.bound.when.the.transien
3b140 74 0a 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 64 65 66 69 6e 65 64 20 75 73 69 6e t.prefix.command.is.defined.usin
3b160 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2c 20 73 65 65 g.~transient-define-prefix~,.see
3b180 0a 5b 5b 2a 44 65 66 69 6e 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 5d 5d 2e 20 20 54 68 65 20 .[[*Defining.Transients]]...The.
3b1a0 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6f 72 67 61 6e 69 7a 65 64 20 69 6e 74 6f 20 67 72 6f 75 commands.are.organized.into.grou
3b1c0 70 73 2c 20 73 65 65 0a 5b 5b 2a 47 72 6f 75 70 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e 73 5d ps,.see.[[*Group.Specifications]
3b1e0 5d 2e 20 20 48 65 72 65 20 77 65 20 64 65 73 63 72 69 62 65 20 74 68 65 20 66 6f 72 6d 20 75 73 ]...Here.we.describe.the.form.us
3b200 65 64 20 74 6f 20 62 69 6e 64 20 61 6e 0a 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 69 78 20 ed.to.bind.an.individual.suffix.
3b220 63 6f 6d 6d 61 6e 64 2e 0a 0a 54 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 69 73 20 61 6c 73 6f 20 command...The.same.form.is.also.
3b240 75 73 65 64 20 77 68 65 6e 20 6c 61 74 65 72 20 62 69 6e 64 69 6e 67 20 61 64 64 69 74 69 6f 6e used.when.later.binding.addition
3b260 61 6c 20 63 6f 6d 6d 61 6e 64 73 0a 75 73 69 6e 67 20 66 75 6e 63 74 69 6f 6e 73 20 73 75 63 68 al.commands.using.functions.such
3b280 20 61 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 7e 2c 20 73 .as.~transient-insert-suffix~,.s
3b2a0 65 65 20 5b 5b 2a 4d 6f 64 69 66 79 69 6e 67 0a 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 ee.[[*Modifying.Existing.Transie
3b2c0 6e 74 73 5d 5d 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 61 6e 20 69 6e 66 69 78 20 69 73 20 61 20 nts]]...Note.that.an.infix.is.a.
3b2e0 73 70 65 63 69 61 6c 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 2e 20 20 44 65 70 65 6e 64 69 special.kind.of.suffix...Dependi
3b300 6e 67 20 6f 6e 20 63 6f 6e 74 65 78 74 0a e2 80 9c 73 75 66 66 69 78 65 73 e2 80 9d 20 6d 65 61 ng.on.context....suffixes....mea
3b320 6e 73 20 e2 80 9c 73 75 66 66 69 78 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 69 6e 66 69 78 65 ns....suffixes.(including.infixe
3b340 73 29 e2 80 9d 20 6f 72 20 e2 80 9c 6e 6f 6e 2d 69 6e 66 69 78 0a 73 75 66 66 69 78 65 73 e2 80 s)....or....non-infix.suffixes..
3b360 9d 2e 20 20 48 65 72 65 20 69 74 20 6d 65 61 6e 73 20 74 68 65 20 66 6f 72 6d 65 72 2e 0a 0a 53 ....Here.it.means.the.former...S
3b380 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 20 68 61 76 65 20 74 68 69 73 20 66 uffix.specifications.have.this.f
3b3a0 6f 72 6d 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 orm:..#+begin_src.emacs-lisp...(
3b3c0 5b 4c 45 56 45 4c 5d 20 5b 4b 45 59 20 5b 44 45 53 43 52 49 50 54 49 4f 4e 5d 5d 20 43 4f 4d 4d [LEVEL].[KEY.[DESCRIPTION]].COMM
3b3e0 41 4e 44 7c 41 52 47 55 4d 45 4e 54 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 29 AND|ARGUMENT.[KEYWORD.VALUE]...)
3b400 0a 23 2b 65 6e 64 5f 73 72 63 0a 0a 7b 7b 7b 76 61 72 28 4c 45 56 45 4c 29 7d 7d 7d 2c 20 7b 7b .#+end_src..{{{var(LEVEL)}}},.{{
3b420 7b 76 61 72 28 4b 45 59 29 7d 7d 7d 20 61 6e 64 20 7b 7b 7b 76 61 72 28 44 45 53 43 52 49 50 54 {var(KEY)}}}.and.{{{var(DESCRIPT
3b440 49 4f 4e 29 7d 7d 7d 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 ION)}}}.can.also.be.specified.us
3b460 69 6e 67 20 74 68 65 20 7b 7b 7b 76 61 72 28 4b 45 59 57 4f 52 44 29 7d 7d 7d 73 0a 7e 3a 6c 65 ing.the.{{{var(KEYWORD)}}}s.~:le
3b480 76 65 6c 7e 2c 20 7e 3a 6b 65 79 7e 20 61 6e 64 20 7e 3a 64 65 73 63 72 69 70 74 69 6f 6e 7e 2e vel~,.~:key~.and.~:description~.
3b4a0 20 20 49 66 20 74 68 65 20 6f 62 6a 65 63 74 20 74 68 61 74 20 69 73 20 61 73 73 6f 63 69 61 74 ..If.the.object.that.is.associat
3b4c0 65 64 20 77 69 74 68 0a 7b 7b 7b 76 61 72 28 43 4f 4d 4d 41 4e 44 29 7d 7d 7d 20 73 65 74 73 20 ed.with.{{{var(COMMAND)}}}.sets.
3b4e0 74 68 65 73 65 20 70 72 6f 70 65 72 74 69 65 73 2c 20 74 68 65 6e 20 74 68 65 79 20 64 6f 20 6e these.properties,.then.they.do.n
3b500 6f 74 20 68 61 76 65 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 0a 68 65 72 65 2e 20 20 59 ot.have.to.be.specified.here...Y
3b520 6f 75 20 63 61 6e 20 68 6f 77 65 76 65 72 20 73 70 65 63 69 66 79 20 74 68 65 6d 20 68 65 72 65 ou.can.however.specify.them.here
3b540 20 61 6e 79 77 61 79 2c 20 70 6f 73 73 69 62 6c 79 20 6f 76 65 72 72 69 64 69 6e 67 0a 74 68 65 .anyway,.possibly.overriding.the
3b560 20 6f 62 6a 65 63 74 27 73 20 76 61 6c 75 65 73 20 6a 75 73 74 20 66 6f 72 20 74 68 65 20 62 69 .object's.values.just.for.the.bi
3b580 6e 64 69 6e 67 20 69 6e 73 69 64 65 20 74 68 69 73 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 2d 20 nding.inside.this.transient...-.
3b5a0 7b 7b 7b 76 61 72 28 4c 45 56 45 4c 29 7d 7d 7d 20 69 73 20 74 68 65 20 73 75 66 66 69 78 20 6c {{{var(LEVEL)}}}.is.the.suffix.l
3b5c0 65 76 65 6c 2c 20 61 6e 20 69 6e 74 65 67 65 72 20 62 65 74 77 65 65 6e 20 31 20 61 6e 64 20 37 evel,.an.integer.between.1.and.7
3b5e0 2e 20 20 53 65 65 0a 20 20 5b 5b 2a 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 ...See...[[*Enabling.and.Disabli
3b600 6e 67 20 53 75 66 66 69 78 65 73 5d 5d 2e 0a 0a 2d 20 4b 45 59 20 69 73 20 74 68 65 20 6b 65 79 ng.Suffixes]]...-.KEY.is.the.key
3b620 20 62 69 6e 64 69 6e 67 2c 20 61 20 73 74 72 69 6e 67 20 69 6e 20 74 68 65 20 66 6f 72 6d 61 74 .binding,.a.string.in.the.format
3b640 20 72 65 74 75 72 6e 65 64 20 62 79 0a 20 20 7e 64 65 73 63 72 69 62 65 2d 6b 65 79 7e 20 61 6e .returned.by...~describe-key~.an
3b660 64 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 7e 6b 62 64 7e 2e 0a 0a 20 20 54 68 61 74 20 66 d.understood.by.~kbd~.....That.f
3b680 6f 72 6d 61 74 20 69 73 20 6d 6f 72 65 20 70 65 72 6d 69 73 73 69 76 65 20 74 68 61 6e 20 74 68 ormat.is.more.permissive.than.th
3b6a0 65 20 6f 6e 65 20 61 63 63 65 70 74 65 64 20 62 79 20 7e 6b 65 79 2d 76 61 6c 69 64 2d 70 7e 2e e.one.accepted.by.~key-valid-p~.
3b6c0 0a 20 20 42 65 69 6e 67 20 6d 6f 72 65 20 70 65 72 6d 69 73 73 69 76 65 20 6d 61 6b 65 73 20 69 ...Being.more.permissive.makes.i
3b6e0 74 20 70 6f 73 73 69 62 6c 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 77 72 69 74 t.possible,.for.example,.to.writ
3b700 65 20 74 68 65 0a 20 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 77 68 69 63 68 20 74 6f 67 67 6c e.the...key.binding,.which.toggl
3b720 65 73 20 74 68 65 20 7e 2d 61 7e 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 72 67 75 6d 65 6e es.the.~-a~.command.line.argumen
3b740 74 2c 20 61 73 20 22 2d 61 22 2c 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 68 61 76 69 6e 67 20 t,.as."-a",...instead.of.having.
3b760 74 6f 20 77 72 69 74 65 20 22 2d 20 61 22 2e 20 20 4c 69 6b 65 77 69 73 65 20 61 64 64 69 74 69 to.write."-.a"...Likewise.additi
3b780 6f 6e 61 6c 20 73 70 61 63 65 73 20 63 61 6e 20 62 65 0a 20 20 61 64 64 65 64 2c 20 77 68 69 63 onal.spaces.can.be...added,.whic
3b7a0 68 20 69 73 20 6e 6f 74 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 20 64 69 73 70 6c 61 79 69 6e 67 h.is.not.removed.when.displaying
3b7c0 20 74 68 65 20 62 69 6e 64 69 6e 67 20 69 6e 20 74 68 65 20 6d 65 6e 75 2c 0a 20 20 77 68 69 63 .the.binding.in.the.menu,...whic
3b7e0 68 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 61 6c 69 67 6e 6d 65 6e 74 20 70 75 72 70 6f 73 h.is.useful.for.alignment.purpos
3b800 65 73 2e 0a 0a 2d 20 7b 7b 7b 76 61 72 28 44 45 53 43 52 49 50 54 49 4f 4e 29 7d 7d 7d 20 69 73 es...-.{{{var(DESCRIPTION)}}}.is
3b820 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 61 20 73 74 72 69 6e .the.description,.either.a.strin
3b840 67 20 6f 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 74 61 6b 65 73 20 7a 65 72 g.or.a.function.that...takes.zer
3b860 6f 20 6f 72 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 73 20 28 74 68 65 20 73 75 66 66 69 78 20 6f o.or.one.arguments.(the.suffix.o
3b880 62 6a 65 63 74 29 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 20 73 74 72 69 6e 67 2e 0a 20 20 54 bject).and.returns.a.string....T
3b8a0 68 65 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 61 20 6c 61 6d 62 64 61 20 65 he.function.should.be.a.lambda.e
3b8c0 78 70 72 65 73 73 69 6f 6e 20 74 6f 20 61 76 6f 69 64 20 61 6d 62 69 67 75 69 74 79 2e 20 20 49 xpression.to.avoid.ambiguity...I
3b8e0 6e 0a 20 20 73 6f 6d 65 20 63 61 73 65 73 20 61 20 73 79 6d 62 6f 6c 20 74 68 61 74 20 69 73 20 n...some.cases.a.symbol.that.is.
3b900 62 6f 75 6e 64 20 61 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 77 6f 75 6c 64 20 61 6c 73 6f 20 77 bound.as.a.function.would.also.w
3b920 6f 72 6b 20 62 75 74 0a 20 20 74 6f 20 62 65 20 73 61 66 65 20 79 6f 75 20 73 68 6f 75 6c 64 20 ork.but...to.be.safe.you.should.
3b940 75 73 65 20 7e 3a 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 69 6e 20 74 68 61 74 20 63 61 73 65 2e use.~:description~.in.that.case.
3b960 0a 0a 54 68 65 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74 20 69 73 20 65 69 74 68 65 72 20 61 20 63 ..The.next.element.is.either.a.c
3b980 6f 6d 6d 61 6e 64 20 6f 72 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 20 54 68 69 73 20 69 73 20 ommand.or.an.argument...This.is.
3b9a0 74 68 65 20 6f 6e 6c 79 0a 61 72 67 75 6d 65 6e 74 20 74 68 61 74 20 69 73 20 6d 61 6e 64 61 74 the.only.argument.that.is.mandat
3b9c0 6f 72 79 20 69 6e 20 61 6c 6c 20 63 61 73 65 73 2e 0a 0a 2d 20 7b 7b 7b 76 61 72 28 43 4f 4d 4d ory.in.all.cases...-.{{{var(COMM
3b9e0 41 4e 44 29 7d 7d 7d 20 73 68 6f 75 6c 64 20 62 65 20 61 20 73 79 6d 62 6f 6c 20 74 68 61 74 20 AND)}}}.should.be.a.symbol.that.
3ba00 69 73 20 62 6f 75 6e 64 20 61 73 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 68 61 is.bound.as.a.function,.which.ha
3ba20 73 0a 20 20 74 6f 20 62 65 20 64 65 66 69 6e 65 64 20 6f 72 20 61 74 20 6c 65 61 73 74 20 61 75 s...to.be.defined.or.at.least.au
3ba40 74 6f 6c 6f 61 64 65 64 20 61 73 20 61 20 63 6f 6d 6d 61 6e 64 20 62 79 20 74 68 65 20 74 69 6d toloaded.as.a.command.by.the.tim
3ba60 65 20 74 68 65 0a 20 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e e.the...containing.prefix.comman
3ba80 64 20 69 73 20 69 6e 76 6f 6b 65 64 2e 0a 0a 20 20 41 6e 79 20 63 6f 6d 6d 61 6e 64 20 77 69 6c d.is.invoked.....Any.command.wil
3baa0 6c 20 64 6f 3b 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 68 61 76 65 20 61 l.do;.it.does.not.need.to.have.a
3bac0 6e 20 6f 62 6a 65 63 74 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 77 69 74 68 20 69 74 20 28 61 n.object.associated...with.it.(a
3bae0 73 20 77 6f 75 6c 64 20 62 65 20 74 68 65 20 63 61 73 65 20 69 66 20 7e 74 72 61 6e 73 69 65 6e s.would.be.the.case.if.~transien
3bb00 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 7e 20 6f 72 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 t-define-suffix~.or...~transient
3bb20 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 7e 20 77 65 72 65 20 75 73 65 64 20 74 6f 20 64 65 66 69 -define-infix~.were.used.to.defi
3bb40 6e 65 20 69 74 29 2e 0a 0a 20 20 43 4f 4d 4d 41 4e 44 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 ne.it).....COMMAND.can.also.be.a
3bb60 20 7e 6c 61 6d 62 64 61 7e 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 0a 20 20 41 73 20 6d 65 6e 74 .~lambda~.expression.....As.ment
3bb80 69 6f 6e 65 64 20 61 62 6f 76 65 2c 20 74 68 65 20 6f 62 6a 65 63 74 20 74 68 61 74 20 69 73 20 ioned.above,.the.object.that.is.
3bba0 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 0a 20 20 associated.with.a.command.can...
3bbc0 62 65 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 63 be.used.to.set.the.default.for.c
3bbe0 65 72 74 61 69 6e 20 76 61 6c 75 65 73 20 74 68 61 74 20 6f 74 68 65 72 77 69 73 65 20 68 61 76 ertain.values.that.otherwise.hav
3bc00 65 20 74 6f 0a 20 20 62 65 20 73 65 74 20 69 6e 20 74 68 65 20 73 75 66 66 69 78 20 73 70 65 63 e.to...be.set.in.the.suffix.spec
3bc20 69 66 69 63 61 74 69 6f 6e 2e 20 20 54 68 65 72 65 66 6f 72 65 20 69 66 20 74 68 65 72 65 20 69 ification...Therefore.if.there.i
3bc40 73 20 6e 6f 20 6f 62 6a 65 63 74 2c 0a 20 20 74 68 65 6e 20 79 6f 75 20 68 61 76 65 20 74 6f 20 s.no.object,...then.you.have.to.
3bc60 6d 61 6b 65 20 73 75 72 65 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 7b 7b 7b 76 61 72 28 make.sure.to.specify.the.{{{var(
3bc80 4b 45 59 29 7d 7d 7d 20 61 6e 64 20 74 68 65 20 7b 7b 7b 76 61 72 28 44 45 53 43 52 49 50 54 49 KEY)}}}.and.the.{{{var(DESCRIPTI
3bca0 4f 4e 29 7d 7d 7d 2e 0a 0a 20 20 41 73 20 61 20 73 70 65 63 69 61 6c 20 63 61 73 65 2c 20 69 66 ON)}}}.....As.a.special.case,.if
3bcc0 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 61 64 64 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 .you.want.to.add.a.command.that.
3bce0 6d 69 67 68 74 20 62 65 20 6e 65 69 74 68 65 72 0a 20 20 64 65 66 69 6e 65 64 20 6e 6f 72 20 61 might.be.neither...defined.nor.a
3bd00 75 74 6f 6c 6f 61 64 65 64 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 61 20 77 6f 72 6b 61 72 6f utoloaded,.you.can.use.a.workaro
3bd20 75 6e 64 20 6c 69 6b 65 3a 0a 0a 20 20 23 2b 42 45 47 49 4e 5f 53 52 43 20 65 6d 61 63 73 2d 6c und.like:....#+BEGIN_SRC.emacs-l
3bd40 69 73 70 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 isp.....(transient-insert-suffix
3bd60 20 27 73 6f 6d 65 2d 70 72 65 66 69 78 20 22 6b 22 0a 20 20 20 20 20 20 27 28 22 21 22 20 22 43 .'some-prefix."k".......'("!"."C
3bd80 65 63 69 20 6e 27 65 73 74 20 70 61 73 20 75 6e 65 20 63 6f 6d 6d 61 6e 64 65 22 20 6e 6f 2d 63 eci.n'est.pas.une.commande".no-c
3bda0 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 3a 69 66 20 28 6c 61 6d 62 64 61 20 28 29 20 28 66 ommand.........:if.(lambda.().(f
3bdc0 65 61 74 75 72 65 70 20 27 6e 6f 2d 6c 69 62 72 61 72 79 29 29 29 29 0a 20 20 23 2b 45 4e 44 5f eaturep.'no-library))))...#+END_
3bde0 53 52 43 0a 0a 20 20 49 6e 73 74 65 61 64 20 6f 66 20 7e 66 65 61 74 75 72 65 70 7e 20 79 6f 75 SRC....Instead.of.~featurep~.you
3be00 20 63 6f 75 6c 64 20 61 6c 73 6f 20 75 73 65 20 7e 72 65 71 75 69 72 65 7e 20 77 69 74 68 20 61 .could.also.use.~require~.with.a
3be20 20 6e 6f 6e 2d 7e 6e 69 6c 7e 20 76 61 6c 75 65 0a 20 20 66 6f 72 20 7b 7b 7b 76 61 72 28 4e 4f .non-~nil~.value...for.{{{var(NO
3be40 45 52 52 4f 52 29 7d 7d 7d 2e 0a 0a 2d 20 54 68 65 20 6d 61 6e 64 61 74 6f 72 79 20 61 72 67 75 ERROR)}}}...-.The.mandatory.argu
3be60 6d 65 6e 74 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 ment.can.also.be.a.command-line.
3be80 61 72 67 75 6d 65 6e 74 2c 20 61 0a 20 20 73 74 72 69 6e 67 2e 20 20 49 6e 20 74 68 61 74 20 63 argument,.a...string...In.that.c
3bea0 61 73 65 20 61 6e 20 61 6e 6f 6e 79 6d 6f 75 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 64 65 66 69 ase.an.anonymous.command.is.defi
3bec0 6e 65 64 20 61 6e 64 20 62 6f 75 6e 64 2e 0a 0a 20 20 49 6e 73 74 65 61 64 20 6f 66 20 61 20 73 ned.and.bound.....Instead.of.a.s
3bee0 74 72 69 6e 67 2c 20 74 68 69 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 20 6c 69 73 74 20 6f tring,.this.can.also.be.a.list.o
3bf00 66 20 74 77 6f 20 73 74 72 69 6e 67 73 2c 20 69 6e 0a 20 20 77 68 69 63 68 20 63 61 73 65 20 74 f.two.strings,.in...which.case.t
3bf20 68 65 20 66 69 72 73 74 20 73 74 72 69 6e 67 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 73 he.first.string.is.used.as.the.s
3bf40 68 6f 72 74 20 61 72 67 75 6d 65 6e 74 20 28 77 68 69 63 68 20 63 61 6e 0a 20 20 61 6c 73 6f 20 hort.argument.(which.can...also.
3bf60 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 7e 3a 73 68 6f 72 74 61 72 67 7e 29 20 be.specified.using.~:shortarg~).
3bf80 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20 61 73 20 74 68 65 20 6c 6f 6e 67 20 61 72 67 75 6d and.the.second.as.the.long.argum
3bfa0 65 6e 74 0a 20 20 28 77 68 69 63 68 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 ent...(which.can.also.be.specifi
3bfc0 65 64 20 75 73 69 6e 67 20 7e 3a 61 72 67 75 6d 65 6e 74 7e 29 2e 0a 0a 20 20 4f 6e 6c 79 20 74 ed.using.~:argument~).....Only.t
3bfe0 68 65 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 69 6e he.long.argument.is.displayed.in
3c000 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 53 65 65 0a 20 20 7e 74 72 61 6e 73 69 .the.menu.buffer...See...~transi
3c020 65 6e 74 2d 64 65 74 65 63 74 2d 6b 65 79 2d 63 6f 6e 66 6c 69 63 74 73 7e 20 66 6f 72 20 68 6f ent-detect-key-conflicts~.for.ho
3c040 77 20 74 68 65 20 73 68 6f 72 74 20 61 72 67 75 6d 65 6e 74 20 6d 61 79 20 62 65 0a 20 20 75 73 w.the.short.argument.may.be...us
3c060 65 64 2e 0a 0a 20 20 55 6e 6c 65 73 73 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 73 70 65 63 69 ed.....Unless.the.class.is.speci
3c080 66 69 65 64 20 65 78 70 6c 69 63 69 74 6c 79 2c 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 fied.explicitly,.the.appropriate
3c0a0 20 63 6c 61 73 73 20 69 73 0a 20 20 67 75 65 73 73 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 65 .class.is...guessed.based.on.the
3c0c0 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 .long.argument...If.the.argument
3c0e0 20 65 6e 64 73 20 77 69 74 68 20 3d 3d 3d 0a 20 20 28 65 2e 67 2e 2c 20 3d 2d 2d 66 6f 72 6d 61 .ends.with.===...(e.g.,.=--forma
3c100 74 3d 3d 29 20 74 68 65 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e 7e 20 69 73 20 t==).then.~transient-option~.is.
3c120 75 73 65 64 2c 20 6f 74 68 65 72 77 69 73 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 used,.otherwise...~transient-swi
3c140 74 63 68 7e 2e 0a 0a 46 69 6e 61 6c 6c 79 2c 20 64 65 74 61 69 6c 73 20 63 61 6e 20 62 65 20 73 tch~...Finally,.details.can.be.s
3c160 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 6f 70 74 69 6f 6e 61 6c 20 7b 7b 7b 76 61 72 28 4b pecified.using.optional.{{{var(K
3c180 45 59 57 4f 52 44 29 7d 7d 7d 2d 7b 7b 7b 76 61 72 28 56 41 4c 55 45 29 7d 7d 7d 20 70 61 69 72 EYWORD)}}}-{{{var(VALUE)}}}.pair
3c1a0 73 2e 0a 45 61 63 68 20 6b 65 79 77 6f 72 64 20 68 61 73 20 74 6f 20 62 65 20 61 20 6b 65 79 77 s..Each.keyword.has.to.be.a.keyw
3c1c0 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 7e 3a 63 6c 61 73 73 7e 20 6f 72 20 61 ord.symbol,.either.~:class~.or.a
3c1e0 20 6b 65 79 77 6f 72 64 0a 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 .keyword.argument.supported.by.t
3c200 68 65 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 20 20 53 he.constructor.of.that.class...S
3c220 65 65 20 5b 5b 2a 53 75 66 66 69 78 0a 53 6c 6f 74 73 5d 5d 2e 0a 0a 49 66 20 61 20 6b 65 79 77 ee.[[*Suffix.Slots]]...If.a.keyw
3c240 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 61 63 63 65 70 74 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 ord.argument.accepts.a.function.
3c260 61 73 20 76 61 6c 75 65 2c 20 79 6f 75 20 61 6e 20 75 73 65 20 61 20 7e 6c 61 6d 62 64 61 7e 0a as.value,.you.an.use.a.~lambda~.
3c280 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 41 73 20 61 20 73 70 65 63 69 61 6c 20 63 61 73 65 2c 20 expression...As.a.special.case,.
3c2a0 74 68 65 20 7e 23 23 7e 20 6d 61 63 72 6f 20 28 77 68 69 63 68 20 72 65 74 75 72 6e 73 20 61 20 the.~##~.macro.(which.returns.a.
3c2c0 7e 6c 61 6d 62 64 61 7e 0a 65 78 70 72 65 73 73 69 6f 6e 20 61 6e 64 20 69 73 20 69 6d 70 6c 65 ~lambda~.expression.and.is.imple
3c2e0 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 7e 6c 6c 61 6d 61 7e 20 70 61 63 6b 61 67 65 29 20 69 mented.in.the.~llama~.package).i
3c300 73 20 61 6c 73 6f 20 73 75 70 70 6f 72 74 65 64 2e 0a 49 6e 73 69 64 65 20 73 75 66 66 69 78 20 s.also.supported..Inside.suffix.
3c320 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 20 75 73 65 20 6f 66 20 7e 23 23 7e 20 69 73 20 6e 6f 74 bindings,.the.use.of.~##~.is.not
3c340 20 73 75 70 70 6f 72 74 65 64 20 61 6e 79 77 68 65 72 65 20 62 75 74 0a 64 69 72 65 63 74 6c 79 .supported.anywhere.but.directly
3c360 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2e 0a 0a 2a 2a .following.a.keyword.symbol...**
3c380 20 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d 6d 61 .Defining.Suffix.and.Infix.Comma
3c3a0 6e 64 73 0a 23 2b 63 69 6e 64 65 78 3a 20 64 65 66 69 6e 69 6e 67 20 73 75 66 66 69 78 20 63 6f nds.#+cindex:.defining.suffix.co
3c3c0 6d 6d 61 6e 64 73 0a 23 2b 63 69 6e 64 65 78 3a 20 64 65 66 69 6e 69 6e 67 20 69 6e 66 69 78 20 mmands.#+cindex:.defining.infix.
3c3e0 63 6f 6d 6d 61 6e 64 73 0a 0a 4e 6f 74 65 20 74 68 61 74 20 61 6e 20 69 6e 66 69 78 20 69 73 20 commands..Note.that.an.infix.is.
3c400 61 20 73 70 65 63 69 61 6c 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 2e 20 20 44 65 70 65 6e a.special.kind.of.suffix...Depen
3c420 64 69 6e 67 20 6f 6e 20 63 6f 6e 74 65 78 74 0a e2 80 9c 73 75 66 66 69 78 65 73 e2 80 9d 20 6d ding.on.context....suffixes....m
3c440 65 61 6e 73 20 e2 80 9c 73 75 66 66 69 78 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 69 6e 66 69 eans....suffixes.(including.infi
3c460 78 65 73 29 e2 80 9d 20 6f 72 20 e2 80 9c 6e 6f 6e 2d 69 6e 66 69 78 0a 73 75 66 66 69 78 65 73 xes)....or....non-infix.suffixes
3c480 e2 80 9d 2e 0a 0a 2d 20 4d 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d ......-.Macro:.transient-define-
3c4a0 73 75 66 66 69 78 20 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 5b 64 6f 63 73 74 72 69 6e 67 5d 20 suffix.name.arglist.[docstring].
3c4c0 5b 6b 65 79 77 6f 72 64 20 76 61 6c 75 65 5d 2e 2e 2e 20 62 6f 64 79 2e 2e 2e 20 3a 3a 0a 0a 20 [keyword.value]....body....::...
3c4e0 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 20 7b 7b 7b 76 61 72 28 4e 41 4d 45 29 .This.macro.defines.{{{var(NAME)
3c500 7d 7d 7d 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e }}}.as.a.transient.suffix.comman
3c520 64 2e 0a 0a 20 20 7b 7b 7b 76 61 72 28 41 52 47 4c 49 53 54 29 7d 7d 7d 20 61 72 65 20 74 68 65 d.....{{{var(ARGLIST)}}}.are.the
3c540 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 74 61 6b 65 .arguments.that.the.command.take
3c560 73 2e 0a 20 20 7b 7b 7b 76 61 72 28 44 4f 43 53 54 52 49 4e 47 29 7d 7d 7d 20 69 73 20 74 68 65 s....{{{var(DOCSTRING)}}}.is.the
3c580 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 61 6e 64 20 69 73 20 6f 70 74 .documentation.string.and.is.opt
3c5a0 69 6f 6e 61 6c 2e 0a 0a 20 20 54 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 20 63 61 6e 20 6f 70 ional.....These.arguments.can.op
3c5c0 74 69 6f 6e 61 6c 6c 79 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6b 65 79 77 6f 72 64 2d tionally.be.followed.by.keyword-
3c5e0 76 61 6c 75 65 20 70 61 69 72 73 2e 0a 20 20 45 61 63 68 20 6b 65 79 77 6f 72 64 20 68 61 73 20 value.pairs....Each.keyword.has.
3c600 74 6f 20 62 65 20 61 20 6b 65 79 77 6f 72 64 20 73 79 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 7e to.be.a.keyword.symbol,.either.~
3c620 3a 63 6c 61 73 73 7e 20 6f 72 20 61 20 6b 65 79 77 6f 72 64 0a 20 20 61 72 67 75 6d 65 6e 74 20 :class~.or.a.keyword...argument.
3c640 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 6f 66 20 supported.by.the.constructor.of.
3c660 74 68 61 74 20 63 6c 61 73 73 2e 20 20 54 68 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 that.class...The...~transient-su
3c680 66 66 69 78 7e 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 69 66 20 74 68 65 20 63 6c 61 73 73 ffix~.class.is.used.if.the.class
3c6a0 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 0a 20 20 65 78 70 6c 69 63 69 74 6c 79 2e 0a .is.not.specified...explicitly..
3c6c0 0a 20 20 54 68 65 20 7b 7b 7b 76 61 72 28 42 4f 44 59 29 7d 7d 7d 20 6d 75 73 74 20 62 65 67 69 ...The.{{{var(BODY)}}}.must.begi
3c6e0 6e 20 77 69 74 68 20 61 6e 20 7e 69 6e 74 65 72 61 63 74 69 76 65 7e 20 66 6f 72 6d 20 74 68 61 n.with.an.~interactive~.form.tha
3c700 74 20 6d 61 74 63 68 65 73 20 7b 7b 7b 76 61 72 28 41 52 47 4c 49 53 54 29 7d 7d 7d 2e 0a 20 20 t.matches.{{{var(ARGLIST)}}}....
3c720 54 68 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 75 73 75 61 6c 6c 79 20 The.infix.arguments.are.usually.
3c740 61 63 63 65 73 73 65 64 20 62 79 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 accessed.by.using.~transient-arg
3c760 73 7e 0a 20 20 69 6e 73 69 64 65 20 7e 69 6e 74 65 72 61 63 74 69 76 65 7e 2e 0a 0a 2d 20 4d 61 s~...inside.~interactive~...-.Ma
3c780 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 20 6e 61 6d 65 cro:.transient-define-infix.name
3c7a0 20 61 72 67 6c 69 73 74 20 5b 64 6f 63 73 74 72 69 6e 67 5d 20 5b 6b 65 79 77 6f 72 64 20 76 61 .arglist.[docstring].[keyword.va
3c7c0 6c 75 65 5d 2e 2e 2e 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 lue]....::....This.macro.defines
3c7e0 20 7b 7b 7b 76 61 72 28 4e 41 4d 45 29 7d 7d 7d 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 .{{{var(NAME)}}}.as.a.transient.
3c800 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 7b 7b 7b 76 61 72 28 41 52 47 4c 49 53 54 infix.command.....{{{var(ARGLIST
3c820 29 7d 7d 7d 20 69 73 20 61 6c 77 61 79 73 20 69 67 6e 6f 72 65 64 20 28 62 75 74 20 6d 61 6e 64 )}}}.is.always.ignored.(but.mand
3c840 61 74 6f 72 79 20 6e 65 76 65 72 2d 74 68 65 2d 6c 65 73 73 29 20 61 6e 64 0a 20 20 72 65 73 65 atory.never-the-less).and...rese
3c860 72 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20 75 73 65 2e 20 20 7b 7b 7b 76 61 72 28 44 4f 43 rved.for.future.use...{{{var(DOC
3c880 53 54 52 49 4e 47 29 7d 7d 7d 20 69 73 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 STRING)}}}.is.the.documentation.
3c8a0 73 74 72 69 6e 67 20 61 6e 64 0a 20 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 0a 0a 20 20 41 74 20 string.and...is.optional.....At.
3c8c0 6c 65 61 73 74 20 6f 6e 65 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 69 72 20 69 73 20 72 65 71 75 least.one.key-value.pair.is.requ
3c8e0 69 72 65 64 2e 20 20 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 0a 20 20 63 6f 6d ired...All.transient.infix...com
3c900 6d 61 6e 64 73 20 61 72 65 20 7e 65 71 75 61 6c 7e 20 74 6f 20 65 61 63 68 20 6f 74 68 65 72 20 mands.are.~equal~.to.each.other.
3c920 28 62 75 74 20 6e 6f 74 20 7e 65 71 7e 29 2e 20 20 49 74 20 69 73 20 6d 65 61 6e 69 6e 67 6c 65 (but.not.~eq~)...It.is.meaningle
3c940 73 73 0a 20 20 74 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2c ss...to.define.an.infix.command,
3c960 20 77 69 74 68 6f 75 74 20 70 72 6f 76 69 64 69 6e 67 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 .without.providing.at.least.one.
3c980 6b 65 79 77 6f 72 64 0a 20 20 61 72 67 75 6d 65 6e 74 20 28 75 73 75 61 6c 6c 79 20 7e 3a 61 72 keyword...argument.(usually.~:ar
3c9a0 67 75 6d 65 6e 74 7e 20 6f 72 20 7e 3a 76 61 72 69 61 62 6c 65 7e 2c 20 64 65 70 65 6e 64 69 6e gument~.or.~:variable~,.dependin
3c9c0 67 20 6f 6e 20 74 68 65 20 63 6c 61 73 73 29 2e 0a 20 20 54 68 65 20 73 75 66 66 69 78 20 63 6c g.on.the.class)....The.suffix.cl
3c9e0 61 73 73 20 64 65 66 61 75 6c 74 73 20 74 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 ass.defaults.to.~transient-switc
3ca00 68 7e 20 61 6e 64 20 63 61 6e 20 62 65 20 73 65 74 20 75 73 69 6e 67 0a 20 20 74 68 65 20 7e 3a h~.and.can.be.set.using...the.~:
3ca20 63 6c 61 73 73 7e 20 6b 65 79 77 6f 72 64 2e 0a 0a 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 class~.keyword.....The.function.
3ca40 64 65 66 69 6e 69 74 69 6f 6e 20 69 73 20 61 6c 77 61 79 73 3a 0a 0a 20 20 23 2b 42 45 47 49 4e definition.is.always:....#+BEGIN
3ca60 5f 53 52 43 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 _SRC.emacs-lisp.....(lambda.()..
3ca80 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 6c 65 74 20 28 28 .....(interactive).......(let.((
3caa0 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a obj.(transient-suffix-object))).
3cac0 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a ........(transient-infix-set.obj
3cae0 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 6f 62 6a 29 29 29 0a 20 20 .(transient-infix-read.obj)))...
3cb00 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 20 20 23 2b 45 4e 44 5f 53 ....(transient--show))...#+END_S
3cb20 52 43 0a 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 7e 20 61 6e 64 RC....~transient-infix-read~.and
3cb40 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 7e 20 61 72 65 20 67 65 6e 65 72 .~transient-infix-set~.are.gener
3cb60 69 63 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 20 20 44 69 66 66 65 72 65 6e 74 20 69 6e 66 69 78 20 ic.functions....Different.infix.
3cb80 63 6f 6d 6d 61 6e 64 73 20 62 65 68 61 76 65 20 64 69 66 66 65 72 65 6e 74 6c 79 20 62 65 63 61 commands.behave.differently.beca
3cba0 75 73 65 20 74 68 65 20 63 6f 6e 63 72 65 74 65 0a 20 20 6d 65 74 68 6f 64 73 20 61 72 65 20 64 use.the.concrete...methods.are.d
3cbc0 69 66 66 65 72 65 6e 74 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d ifferent.for.different.infix.com
3cbe0 6d 61 6e 64 20 63 6c 61 73 73 65 73 2e 20 20 49 6e 20 72 61 72 65 0a 20 20 63 61 73 65 73 20 74 mand.classes...In.rare...cases.t
3cc00 68 65 20 61 62 6f 76 65 20 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f 6e 20 6d 69 67 68 74 20 he.above.command.function.might.
3cc20 6e 6f 74 20 62 65 20 73 75 69 74 61 62 6c 65 2c 20 65 76 65 6e 20 69 66 20 79 6f 75 0a 20 20 64 not.be.suitable,.even.if.you...d
3cc40 65 66 69 6e 65 20 79 6f 75 72 20 6f 77 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 6c 61 efine.your.own.infix.command.cla
3cc60 73 73 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 20 79 6f 75 20 68 61 76 65 20 74 6f 20 75 73 ss...In.that.case.you.have.to.us
3cc80 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 7e 20 74 6f e...~transient-define-suffix~.to
3cca0 20 64 65 66 69 6e 65 20 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 75 73 .define.the.infix.command.and.us
3ccc0 65 20 7e 74 7e 20 61 73 20 74 68 65 0a 20 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 7e 3a 74 72 e.~t~.as.the...value.of.the.~:tr
3cce0 61 6e 73 69 65 6e 74 7e 20 6b 65 79 77 6f 72 64 2e 0a 0a 2d 20 4d 61 63 72 6f 3a 20 74 72 61 6e ansient~.keyword...-.Macro:.tran
3cd00 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 61 72 67 75 6d 65 6e 74 20 6e 61 6d 65 20 61 72 67 6c 69 sient-define-argument.name.argli
3cd20 73 74 20 5b 64 6f 63 73 74 72 69 6e 67 5d 20 5b 6b 65 79 77 6f 72 64 20 76 61 6c 75 65 5d 2e 2e st.[docstring].[keyword.value]..
3cd40 2e 20 3a 3a 0a 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65 66 69 6e 65 73 20 7b 7b 7b 76 61 ..::....This.macro.defines.{{{va
3cd60 72 28 4e 41 4d 45 29 7d 7d 7d 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 20 r(NAME)}}}.as.a.transient.infix.
3cd80 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 54 68 69 73 20 69 73 20 61 6e 20 61 6c 69 61 73 20 66 6f 72 command.....This.is.an.alias.for
3cda0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 7e 2e 20 20 4f 6e 6c 79 .~transient-define-infix~...Only
3cdc0 20 75 73 65 20 74 68 69 73 20 61 6c 69 61 73 0a 20 20 74 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 .use.this.alias...to.define.an.i
3cde0 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 61 63 74 75 61 6c 6c 79 20 73 65 74 73 20 nfix.command.that.actually.sets.
3ce00 61 6e 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 2e 0a 20 20 54 6f 20 64 65 66 69 6e 65 20 61 an.infix.argument....To.define.a
3ce20 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 2c 20 66 6f 72 20 65 78 61 6d 70 6c n.infix.command.that,.for.exampl
3ce40 65 2c 20 73 65 74 73 20 61 20 76 61 72 69 61 62 6c 65 2c 20 75 73 65 0a 20 20 7e 74 72 61 6e 73 e,.sets.a.variable,.use...~trans
3ce60 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 7e 20 69 6e 73 74 65 61 64 2e 0a 0a 2a 2a 20 ient-define-infix~.instead...**.
3ce80 55 73 69 6e 67 20 49 6e 66 69 78 20 41 72 67 75 6d 65 6e 74 73 0a 0a 54 68 65 20 66 75 6e 63 74 Using.Infix.Arguments..The.funct
3cea0 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 76 61 72 69 61 62 6c 65 73 20 64 65 73 63 72 69 62 65 64 ions.and.the.variables.described
3cec0 20 62 65 6c 6f 77 20 61 6c 6c 6f 77 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 74 6f 20 .below.allow.suffix.commands.to.
3cee0 61 63 63 65 73 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e access.the.value.of.the.transien
3cf00 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 79 20 77 65 72 65 20 69 6e 76 6f 6b 65 64 3b 0a t.from.which.they.were.invoked;.
3cf20 77 68 69 63 68 20 69 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 69 74 73 20 69 6e 66 69 78 20 which.is.the.value.of.its.infix.
3cf40 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 73 65 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 arguments...These.variables.are.
3cf60 73 65 74 0a 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 69 6e 76 6f 6b 65 73 20 61 20 73 75 66 66 set.when.the.user.invokes.a.suff
3cf80 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 65 78 69 74 73 20 74 68 65 20 74 72 61 6e 73 69 ix.command.that.exits.the.transi
3cfa0 65 6e 74 2c 20 62 75 74 0a 62 65 66 6f 72 65 20 61 63 74 75 61 6c 6c 79 20 63 61 6c 6c 69 6e 67 ent,.but.before.actually.calling
3cfc0 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 57 68 65 6e 20 72 65 74 75 72 6e 69 6e 67 20 74 6f .the.command...When.returning.to
3cfe0 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 6f 6f 70 20 61 66 74 65 72 20 63 61 6c 6c 69 6e 67 20 .the.command-loop.after.calling.
3d000 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 0a 74 68 65 20 61 72 67 75 6d 65 6e 74 the.suffix.command,.the.argument
3d020 73 20 61 72 65 20 72 65 73 65 74 20 74 6f 20 7e 6e 69 6c 7e 20 28 77 68 69 63 68 20 63 61 75 73 s.are.reset.to.~nil~.(which.caus
3d040 65 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 72 65 74 75 72 6e 0a 7e 6e 69 6c 7e 20 es.the.function.to.return.~nil~.
3d060 74 6f 6f 29 2e 0a 0a 4c 69 6b 65 20 66 6f 72 20 45 6d 61 63 73 27 73 20 70 72 65 66 69 78 20 61 too)...Like.for.Emacs's.prefix.a
3d080 72 67 75 6d 65 6e 74 73 2c 20 69 74 20 69 73 20 61 64 76 69 73 61 62 6c 65 2c 20 62 75 74 20 6e rguments,.it.is.advisable,.but.n
3d0a0 6f 74 20 6d 61 6e 64 61 74 6f 72 79 2c 0a 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 69 6e 66 69 ot.mandatory,.to.access.the.infi
3d0c0 78 20 61 72 67 75 6d 65 6e 74 73 20 69 6e 73 69 64 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 27 73 x.arguments.inside.the.command's
3d0e0 20 7e 69 6e 74 65 72 61 63 74 69 76 65 7e 20 66 6f 72 6d 2e 0a 54 68 65 20 70 72 65 66 65 72 72 .~interactive~.form..The.preferr
3d100 65 64 20 77 61 79 20 6f 66 20 64 6f 69 6e 67 20 74 68 61 74 20 69 73 20 74 6f 20 63 61 6c 6c 20 ed.way.of.doing.that.is.to.call.
3d120 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 0a 66 75 6e 63 74 69 6f 6e 2c 20 77 the.~transient-args~.function,.w
3d140 68 69 63 68 20 66 6f 72 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 73 65 72 76 65 73 20 hich.for.infix.arguments.serves.
3d160 61 62 6f 75 74 20 74 68 65 20 73 61 6d 65 20 70 75 72 70 6f 73 65 20 61 73 0a 7e 70 72 65 66 69 about.the.same.purpose.as.~prefi
3d180 78 2d 61 72 67 7e 20 73 65 72 76 65 73 20 66 6f 72 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e x-arg~.serves.for.prefix.argumen
3d1a0 74 73 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 20 ts...-.Function:.transient-args.
3d1c0 70 72 65 66 69 78 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 prefix.::....This.function.retur
3d1e0 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 ns.the.value.of.the.transient.pr
3d200 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d efix.command...{{{var(PREFIX)}}}
3d220 2e 0a 0a 20 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 .....If.the.current.command.was.
3d240 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 invoked.from.the.transient.prefi
3d260 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 2c 20 74 x.command...{{{var(PREFIX)}}},.t
3d280 68 65 6e 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 61 63 74 69 76 65 20 69 6e 66 69 78 20 hen.it.returns.the.active.infix.
3d2a0 61 72 67 75 6d 65 6e 74 73 2e 20 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 63 6f 6d arguments...If.the.current...com
3d2c0 6d 61 6e 64 20 77 61 73 20 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 7b 7b 7b 76 61 72 mand.was.not.invoked.from.{{{var
3d2e0 28 50 52 45 46 49 58 29 7d 7d 7d 2c 20 74 68 65 6e 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 (PREFIX)}}},.then.it.returns.the
3d300 20 73 65 74 2c 20 73 61 76 65 64 0a 20 20 6f 72 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 66 .set,.saved...or.default.value.f
3d320 6f 72 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 2e 0a 0a 20 20 50 52 45 46 49 58 20 or.{{{var(PREFIX)}}}.....PREFIX.
3d340 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 6c 69 73 74 20 6f 66 20 70 72 65 66 69 78 65 73 2e 20 may.also.be.a.list.of.prefixes..
3d360 20 49 66 20 6e 6f 20 70 72 65 66 69 78 20 69 73 20 61 63 74 69 76 65 2c 20 74 68 65 0a 20 20 66 .If.no.prefix.is.active,.the...f
3d380 61 6c 6c 62 61 63 6b 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 66 20 74 68 allback.value.of.the.first.of.th
3d3a0 65 73 65 20 70 72 65 66 69 78 65 73 20 69 73 20 75 73 65 64 2e 0a 0a 20 20 54 68 65 20 67 65 6e ese.prefixes.is.used.....The.gen
3d3c0 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d eric.function.~transient-prefix-
3d3e0 76 61 6c 75 65 7e 20 69 73 20 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 0a value~.is.used.to.determine.the.
3d400 20 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75 65 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 ..returned.value.....This.functi
3d420 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 73 75 66 on.is.intended.to.be.used.by.suf
3d440 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 65 74 68 65 72 20 74 68 65 79 0a 20 20 61 72 65 fix.commands,.whether.they...are
3d460 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 61 20 6d 65 6e 75 20 6f 72 20 6e 6f 74 2e 20 20 49 74 .invoked.from.a.menu.or.not...It
3d480 20 69 73 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 77 68 65 6e .is.not.intended.to.be.used.when
3d4a0 0a 20 20 73 65 74 74 69 6e 67 20 75 70 20 61 20 6d 65 6e 75 20 61 6e 64 20 69 74 73 20 73 75 66 ...setting.up.a.menu.and.its.suf
3d4c0 66 69 78 65 73 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d fixes,.in.which.case.~transient-
3d4e0 67 65 74 2d 76 61 6c 75 65 7e 0a 20 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2e 0a 0a 2d 20 get-value~...should.be.used...-.
3d500 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 20 3a 3a Function:.transient-get-value.::
3d520 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 ....This.function.returns.the.va
3d540 6c 75 65 20 6f 66 20 74 68 65 20 65 72 61 6e 74 20 70 72 65 66 69 78 2e 0a 0a 20 20 54 68 69 73 lue.of.the.erant.prefix.....This
3d560 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 .function.is.intended.to.be.used
3d580 20 77 68 65 6e 20 73 65 74 74 69 6e 67 20 75 70 20 61 20 6d 65 6e 75 20 61 6e 64 20 69 74 73 0a .when.setting.up.a.menu.and.its.
3d5a0 20 20 73 75 66 66 69 78 65 73 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 20 ..suffixes...It.is.not.intended.
3d5c0 74 6f 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 to.be.used.when.a.suffix.command
3d5e0 20 69 73 0a 20 20 69 6e 76 6f 6b 65 64 2c 20 77 68 65 74 68 65 72 20 66 72 6f 6d 20 61 20 6d 65 .is...invoked,.whether.from.a.me
3d600 6e 75 20 6f 72 20 6e 6f 74 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 7e 74 72 61 6e 73 69 nu.or.not,.in.which.case.~transi
3d620 65 6e 74 2d 61 72 67 73 7e 0a 20 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2e 20 20 49 6e 20 ent-args~...should.be.used...In.
3d640 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 75 73 65 20 74 68 69 73 2c 20 65 2e 67 2e 2c 20 69 6e 20 other.words,.use.this,.e.g.,.in.
3d660 61 20 73 75 66 66 69 78 65 73 20 7e 3a 69 66 2a 7e 0a 20 20 6f 72 20 7e 3a 69 6e 61 70 74 2d 69 a.suffixes.~:if*~...or.~:inapt-i
3d680 66 2a 7e 20 70 72 65 64 69 63 61 74 65 20 61 6e 64 20 7e 3a 64 65 73 63 72 69 70 74 69 6f 6e 7e f*~.predicate.and.~:description~
3d6a0 20 66 75 6e 63 74 69 6f 6e 2c 20 62 75 74 20 6e 65 76 65 72 20 69 6e 20 69 74 73 0a 20 20 7e 69 .function,.but.never.in.its...~i
3d6c0 6e 74 65 72 61 63 74 69 76 65 7e 20 66 6f 72 6d 20 6f 72 20 66 75 6e 63 74 69 6f 6e 20 62 6f 64 nteractive~.form.or.function.bod
3d6e0 79 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 2d 76 61 y...-.Function:.transient-arg-va
3d700 6c 75 65 20 61 72 67 20 61 72 67 73 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e lue.arg.args.::....This.function
3d720 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 7b 7b 7b 76 61 72 28 41 52 47 .returns.the.value.of.{{{var(ARG
3d740 29 7d 7d 7d 20 61 73 20 69 74 20 61 70 70 65 61 72 73 20 69 6e 20 7b 7b 7b 76 61 72 28 41 52 47 )}}}.as.it.appears.in.{{{var(ARG
3d760 53 29 7d 7d 7d 2e 0a 0a 20 20 46 6f 72 20 61 20 73 77 69 74 63 68 20 61 20 62 6f 6f 6c 65 61 6e S)}}}.....For.a.switch.a.boolean
3d780 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 46 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 65 .is.returned...For.an.option.the
3d7a0 20 76 61 6c 75 65 20 69 73 0a 20 20 72 65 74 75 72 6e 65 64 20 61 73 20 61 20 73 74 72 69 6e 67 .value.is...returned.as.a.string
3d7c0 2c 20 75 73 69 6e 67 20 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 66 6f 72 20 74 68 65 ,.using.the.empty.string.for.the
3d7e0 20 65 6d 70 74 79 20 76 61 6c 75 65 2c 0a 20 20 6f 72 20 7e 6e 69 6c 7e 20 69 66 20 74 68 65 20 .empty.value,...or.~nil~.if.the.
3d800 6f 70 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 61 70 70 65 61 72 20 69 6e 20 7b 7b 7b 76 61 72 option.does.not.appear.in.{{{var
3d820 28 41 52 47 53 29 7d 7d 7d 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e (ARGS)}}}...-.Function:.transien
3d840 74 2d 73 75 66 66 69 78 65 73 20 70 72 65 66 69 78 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e t-suffixes.prefix.::....This.fun
3d860 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 74 68 ction.returns.the.suffixes.of.th
3d880 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 7b 7b 7b e.transient.prefix.command...{{{
3d8a0 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 2e 20 20 54 68 69 73 20 69 73 20 61 20 6c 69 73 74 20 var(PREFIX)}}}...This.is.a.list.
3d8c0 6f 66 20 6f 62 6a 65 63 74 73 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c of.objects...This.function.shoul
3d8e0 64 20 6f 6e 6c 79 20 62 65 0a 20 20 75 73 65 64 20 69 66 20 79 6f 75 20 6e 65 65 64 20 74 68 65 d.only.be...used.if.you.need.the
3d900 20 6f 62 6a 65 63 74 73 20 28 61 73 20 6f 70 70 6f 73 65 64 20 74 6f 20 6a 75 73 74 20 74 68 65 .objects.(as.opposed.to.just.the
3d920 69 72 20 76 61 6c 75 65 73 29 20 61 6e 64 0a 20 20 69 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 ir.values).and...if.the.current.
3d940 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 62 65 69 6e 67 20 69 6e 76 6f 6b 65 64 20 66 72 6f command.is.not.being.invoked.fro
3d960 6d 20 7b 7b 7b 76 61 72 28 50 52 45 46 49 58 29 7d 7d 7d 2e 0a 0a 2a 2a 20 55 73 69 6e 67 20 50 m.{{{var(PREFIX)}}}...**.Using.P
3d980 72 65 66 69 78 20 53 63 6f 70 65 0a 0a 53 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 20 68 61 76 refix.Scope..Some.transients.hav
3d9a0 65 20 61 20 73 6f 72 74 20 6f 66 20 73 65 63 6f 6e 64 61 72 79 20 76 61 6c 75 65 2c 20 63 61 6c e.a.sort.of.secondary.value,.cal
3d9c0 6c 65 64 20 61 20 73 63 6f 70 65 2e 20 20 41 0a 70 72 65 66 69 78 27 73 20 73 63 6f 70 65 20 63 led.a.scope...A.prefix's.scope.c
3d9e0 61 6e 20 62 65 20 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d an.be.accessed.using.~transient-
3da00 73 63 6f 70 65 7e 3b 20 73 69 6d 69 6c 61 72 20 74 6f 20 68 6f 77 0a 69 74 73 20 76 61 6c 75 65 scope~;.similar.to.how.its.value
3da20 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e .can.be.accessed.using.~transien
3da40 74 2d 61 72 67 73 7e 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d t-args~...-.Function:.transient-
3da60 73 63 6f 70 65 20 70 72 65 66 69 78 65 73 20 63 6c 61 73 73 65 73 20 3a 3a 0a 0a 20 20 54 68 69 scope.prefixes.classes.::....Thi
3da80 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 s.function.returns.the.scope.of.
3daa0 74 68 65 20 61 63 74 69 76 65 20 6f 72 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 0a the.active.or.current.transient.
3dac0 20 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 49 66 20 6f 70 74 69 6f 6e 61 6c ..prefix.command.....If.optional
3dae0 20 50 52 45 46 49 58 45 53 20 61 6e 64 20 43 4c 41 53 53 45 53 20 61 72 65 20 62 6f 74 68 20 6e .PREFIXES.and.CLASSES.are.both.n
3db00 69 6c 2c 20 72 65 74 75 72 6e 20 74 68 65 20 73 63 6f 70 65 20 6f 66 0a 20 20 74 68 65 20 70 72 il,.return.the.scope.of...the.pr
3db20 65 66 69 78 20 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 73 65 74 75 70 2c 20 6d 61 6b 69 efix.currently.being.setup,.maki
3db40 6e 67 20 74 68 69 73 20 76 61 72 69 61 74 69 6f 6e 20 75 73 65 66 75 6c 2c 20 65 2e 67 2e 2c 0a ng.this.variation.useful,.e.g.,.
3db60 20 20 69 6e 20 7e 3a 69 66 2a 7e 20 70 72 65 64 69 63 61 74 65 73 2e 20 20 49 66 20 6e 6f 20 70 ..in.~:if*~.predicates...If.no.p
3db80 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 2c 20 62 75 74 20 74 68 65 20 63 75 refix.is.being.setup,.but.the.cu
3dba0 72 72 65 6e 74 0a 20 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d rrent...command.was.invoked.from
3dbc0 20 73 6f 6d 65 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68 65 20 73 63 .some.prefix,.then.return.the.sc
3dbe0 6f 70 65 20 6f 66 20 74 68 61 74 2e 0a 0a 20 20 49 66 20 50 52 45 46 49 58 45 53 20 69 73 20 6e ope.of.that.....If.PREFIXES.is.n
3dc00 6f 6e 2d 6e 69 6c 2c 20 69 74 20 6d 75 73 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d on-nil,.it.must.be.a.prefix.comm
3dc20 61 6e 64 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 73 75 63 68 0a 20 20 63 6f 6d 6d 61 6e 64 73 and.or.a.list.of.such...commands
3dc40 2e 20 20 49 66 20 43 4c 41 53 53 45 53 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 69 74 20 6d 75 73 ...If.CLASSES.is.non-nil,.it.mus
3dc60 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6c 61 73 73 20 6f 72 20 61 20 6c 69 73 74 0a 20 20 t.be.a.prefix.class.or.a.list...
3dc80 6f 66 20 73 75 63 68 20 63 6c 61 73 73 65 73 2e 20 20 57 68 65 6e 20 74 68 69 73 20 66 75 6e 63 of.such.classes...When.this.func
3dca0 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20 62 6f 64 79 20 6f 72 20 tion.is.called.from.the.body.or.
3dcc0 74 68 65 0a 20 20 7e 69 6e 74 65 72 61 63 74 69 76 65 7e 20 66 6f 72 6d 20 6f 66 20 61 20 73 75 the...~interactive~.form.of.a.su
3dce0 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 50 52 45 46 49 58 45 53 20 61 6e 64 2f 6f 72 20 43 4c ffix.command,.PREFIXES.and/or.CL
3dd00 41 53 53 45 53 20 73 68 6f 75 6c 64 0a 20 20 62 65 20 6e 6f 6e 2d 6e 69 6c 2e 20 20 49 66 20 65 ASSES.should...be.non-nil...If.e
3dd20 69 74 68 65 72 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 72 79 20 74 68 65 20 66 6f 6c 6c 6f 77 ither.is.non-nil,.try.the.follow
3dd40 69 6e 67 20 69 6e 20 6f 72 64 65 72 3a 0a 0a 20 20 2d 20 49 66 20 74 68 65 20 63 75 72 72 65 6e ing.in.order:....-.If.the.curren
3dd60 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f t.suffix.command.was.invoked.fro
3dd80 6d 20 61 20 70 72 65 66 69 78 2c 20 77 68 69 63 68 0a 20 20 20 20 61 70 70 65 61 72 73 20 69 6e m.a.prefix,.which.....appears.in
3dda0 20 50 52 45 46 49 58 45 53 2c 20 72 65 74 75 72 6e 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 .PREFIXES,.return.the.scope.of.t
3ddc0 68 61 74 20 70 72 65 66 69 78 2e 0a 0a 20 20 2d 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 hat.prefix.....-.If.the.current.
3dde0 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 suffix.command.was.invoked.from.
3de00 61 20 70 72 65 66 69 78 2c 20 61 6e 64 20 69 74 73 0a 20 20 20 20 63 6c 61 73 73 20 64 65 72 69 a.prefix,.and.its.....class.deri
3de20 76 65 73 20 66 72 6f 6d 20 6f 6e 65 20 6f 66 20 74 68 65 20 43 4c 41 53 53 45 53 2c 20 72 65 74 ves.from.one.of.the.CLASSES,.ret
3de40 75 72 6e 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 61 74 0a 20 20 20 20 70 72 65 66 69 78 urn.the.scope.of.that.....prefix
3de60 2e 0a 0a 20 20 2d 20 49 66 20 61 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 .....-.If.a.prefix.is.being.setu
3de80 70 20 61 6e 64 20 69 74 20 61 70 70 65 61 72 73 20 69 6e 20 50 52 45 46 49 58 45 53 2c 20 72 65 p.and.it.appears.in.PREFIXES,.re
3dea0 74 75 72 6e 20 69 74 73 0a 20 20 20 20 73 63 6f 70 65 2e 0a 0a 20 20 2d 20 49 66 20 61 20 70 72 turn.its.....scope.....-.If.a.pr
3dec0 65 66 69 78 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 20 61 6e 64 20 69 74 73 20 63 6c 61 73 efix.is.being.setup.and.its.clas
3dee0 73 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 6f 6e 65 20 6f 66 20 74 68 65 0a 20 20 20 20 43 4c s.derives.from.one.of.the.....CL
3df00 41 53 53 45 53 2c 20 72 65 74 75 72 6e 20 69 74 73 20 73 63 6f 70 65 2e 0a 0a 20 20 2d 20 46 69 ASSES,.return.its.scope.....-.Fi
3df20 6e 61 6c 6c 79 20 74 72 79 20 74 6f 20 72 65 74 75 72 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 nally.try.to.return.the.default.
3df40 73 63 6f 70 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 63 6f 6d 6d 61 6e 64 20 69 6e 0a 20 20 scope.of.the.first.command.in...
3df60 20 20 50 52 45 46 49 58 45 53 2e 20 20 54 68 69 73 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 69 66 20 ..PREFIXES...This.only.works.if.
3df80 74 68 61 74 20 73 6c 6f 74 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 72 65 73 70 65 63 74 69 that.slot.is.set.in.the.respecti
3dfa0 76 65 0a 20 20 20 20 63 6c 61 73 73 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 72 20 75 73 69 6e 67 ve.....class.definition.or.using
3dfc0 20 69 74 73 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 27 20 6d 65 74 68 .its.`transient-init-scope'.meth
3dfe0 6f 64 2e 0a 0a 20 20 49 66 20 6e 6f 20 70 72 65 66 69 78 20 6d 61 74 63 68 65 73 2c 20 72 65 74 od.....If.no.prefix.matches,.ret
3e000 75 72 6e 20 6e 69 6c 2e 0a 0a 2a 2a 20 43 75 72 72 65 6e 74 20 53 75 66 66 69 78 20 43 6f 6d 6d urn.nil...**.Current.Suffix.Comm
3e020 61 6e 64 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 and..-.Function:.transient-suffi
3e040 78 2d 6f 62 6a 65 63 74 20 63 6f 6d 6d 61 6e 64 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 x-object.command.::....This.func
3e060 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 73 6f 63 69 61 74 tion.returns.the.object.associat
3e080 65 64 20 77 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 75 66 66 69 78 0a 20 20 63 6f 6d ed.with.the.current.suffix...com
3e0a0 6d 61 6e 64 2e 0a 0a 20 20 45 61 63 68 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 69 73 mand.....Each.suffix.commands.is
3e0c0 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 6e 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 .associated.with.an.object,.whic
3e0e0 68 20 68 6f 6c 64 73 0a 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e h.holds...additional.information
3e100 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 78 2c 20 73 75 63 68 20 61 73 20 69 74 73 20 76 .about.the.suffix,.such.as.its.v
3e120 61 6c 75 65 20 28 69 6e 0a 20 20 74 68 65 20 63 61 73 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 20 alue.(in...the.case.of.an.infix.
3e140 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 73 20 61 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 command,.which.is.a.kind.of.suff
3e160 69 78 20 63 6f 6d 6d 61 6e 64 29 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 ix.command).....This.function.is
3e180 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 62 79 20 69 6e 66 69 78 20 .intended.to.be.called.by.infix.
3e1a0 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 0a 20 20 61 72 65 20 75 73 75 61 6c 6c 79 20 61 6c commands,.which...are.usually.al
3e1c0 69 61 73 65 73 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 iases.of.~transient--default-inf
3e1e0 69 78 2d 63 6f 6d 6d 61 6e 64 7e 2c 20 77 68 69 63 68 0a 20 20 69 73 20 64 65 66 69 6e 65 64 20 ix-command~,.which...is.defined.
3e200 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 20 20 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d like.this:....#+begin_src.emacs-
3e220 6c 69 73 70 0a 20 20 20 20 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 lisp.....(defun.transient--defau
3e240 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 20 28 29 0a 20 20 20 20 20 20 28 69 6e 74 65 72 lt-infix-command.().......(inter
3e260 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 28 6c 65 74 20 28 28 6f 62 6a 20 28 74 72 61 6e 73 69 active).......(let.((obj.(transi
3e280 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 ent-suffix-object))).........(tr
3e2a0 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 ansient-infix-set.obj.(transient
3e2c0 2d 69 6e 66 69 78 2d 72 65 61 64 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 -infix-read.obj))).......(transi
3e2e0 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 20 20 23 2b 65 6e 64 5f 73 72 63 0a 0a 20 20 28 55 73 65 72 ent--show))...#+end_src....(User
3e300 20 69 6e 70 75 74 20 69 73 20 72 65 61 64 20 6f 75 74 73 69 64 65 20 6f 66 20 7e 69 6e 74 65 72 .input.is.read.outside.of.~inter
3e320 61 63 74 69 76 65 7e 20 74 6f 20 70 72 65 76 65 6e 74 20 74 68 65 0a 20 20 63 6f 6d 6d 61 6e 64 active~.to.prevent.the...command
3e340 20 66 72 6f 6d 20 62 65 69 6e 67 20 61 64 64 65 64 20 74 6f 20 7e 63 6f 6d 6d 61 6e 64 2d 68 69 .from.being.added.to.~command-hi
3e360 73 74 6f 72 79 7e 2e 29 0a 0a 20 20 53 75 63 68 20 63 6f 6d 6d 61 6e 64 73 20 6e 65 65 64 20 74 story~.)....Such.commands.need.t
3e380 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 69 72 20 61 73 73 6f 63 69 o.be.able.to.access.their.associ
3e3a0 61 74 65 64 20 6f 62 6a 65 63 74 0a 20 20 74 6f 20 67 75 69 64 65 20 68 6f 77 20 7e 74 72 61 6e ated.object...to.guide.how.~tran
3e3c0 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 7e 20 72 65 61 64 73 20 74 68 65 20 6e 65 77 20 sient-infix-read~.reads.the.new.
3e3e0 76 61 6c 75 65 20 61 6e 64 20 74 6f 0a 20 20 73 74 6f 72 65 20 74 68 65 20 72 65 61 64 20 76 61 value.and.to...store.the.read.va
3e400 6c 75 65 2e 20 20 4f 74 68 65 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 28 69 6e 63 lue...Other.suffix.commands.(inc
3e420 6c 75 64 69 6e 67 20 6e 6f 6e 2d 69 6e 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 73 29 20 6d 61 79 luding.non-infix...commands).may
3e440 20 61 6c 73 6f 20 6e 65 65 64 20 74 68 65 20 6f 62 6a 65 63 74 20 74 6f 20 67 75 69 64 65 20 74 .also.need.the.object.to.guide.t
3e460 68 65 69 72 20 62 65 68 61 76 69 6f 72 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 heir.behavior.....This.function.
3e480 61 74 74 65 6d 70 74 73 20 74 6f 20 72 65 74 75 72 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 attempts.to.return.the.object.as
3e4a0 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 0a 20 20 63 75 72 72 65 6e 74 20 73 75 66 66 sociated.with.the...current.suff
3e4c0 69 78 20 63 6f 6d 6d 61 6e 64 20 65 76 65 6e 20 69 66 20 74 68 65 20 73 75 66 66 69 78 20 63 6f ix.command.even.if.the.suffix.co
3e4e0 6d 6d 61 6e 64 20 77 61 73 20 6e 6f 74 20 69 6e 76 6f 6b 65 64 0a 20 20 66 72 6f 6d 20 61 20 74 mmand.was.not.invoked...from.a.t
3e500 72 61 6e 73 69 65 6e 74 2e 20 20 28 46 6f 72 20 73 6f 6d 65 20 73 75 66 66 69 78 20 63 6f 6d 6d ransient...(For.some.suffix.comm
3e520 61 6e 64 20 74 68 61 74 20 69 73 20 61 20 76 61 6c 69 64 20 74 68 69 6e 67 0a 20 20 74 6f 20 64 and.that.is.a.valid.thing...to.d
3e540 6f 2c 20 66 6f 72 20 6f 74 68 65 72 73 20 69 74 20 69 73 20 6e 6f 74 2e 29 20 20 49 6e 20 74 68 o,.for.others.it.is.not.)..In.th
3e560 61 74 20 63 61 73 65 20 7e 6e 69 6c 7e 20 6d 61 79 20 62 65 20 72 65 74 75 72 6e 65 64 2c 0a 20 at.case.~nil~.may.be.returned,..
3e580 20 69 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 .if.the.command.was.not.defined.
3e5a0 75 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 6d 61 63 72 6f 73 20 69 6e 74 65 6e 64 65 64 using.one.of.the.macros.intended
3e5c0 0a 20 20 74 6f 20 64 65 66 69 6e 65 20 73 75 63 68 20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 20 54 ...to.define.such.commands.....T
3e5e0 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 43 4f 4d 4d 41 4e 44 20 69 73 20 he.optional.argument.COMMAND.is.
3e600 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 2e 20 20 49 66 0a 20 intended.for.internal.use...If..
3e620 20 79 6f 75 20 61 72 65 20 63 6f 6e 74 65 6d 70 6c 61 74 69 6e 67 20 75 73 69 6e 67 20 69 74 20 .you.are.contemplating.using.it.
3e640 69 6e 20 79 6f 75 72 20 6f 77 6e 20 63 6f 64 65 2c 20 74 68 65 6e 20 79 6f 75 20 73 68 6f 75 6c in.your.own.code,.then.you.shoul
3e660 64 0a 20 20 70 72 6f 62 61 62 6c 79 20 75 73 65 20 74 68 69 73 20 69 6e 73 74 65 61 64 3a 0a 0a d...probably.use.this.instead:..
3e680 20 20 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 20 20 28 67 65 ..#+begin_src.emacs-lisp.....(ge
3e6a0 74 20 43 4f 4d 4d 41 4e 44 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 29 0a 20 20 t.COMMAND.'transient--suffix)...
3e6c0 23 2b 65 6e 64 5f 73 72 63 0a 0a 2d 20 56 61 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 #+end_src..-.Variable:.transient
3e6e0 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 20 3a 3a 0a 0a 20 20 54 68 65 20 73 75 66 66 -current-suffixes.::....The.suff
3e700 69 78 65 73 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 ixes.of.the.transient.from.which
3e720 20 74 68 69 73 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 0a 20 20 69 6e 76 6f 6b .this.suffix.command.was...invok
3e740 65 64 2e 20 20 54 68 69 73 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 6f 62 6a 65 63 74 73 2e 20 ed...This.is.a.list.of.objects..
3e760 20 55 73 75 61 6c 6c 79 20 69 74 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 74 6f 0a 20 20 69 .Usually.it.is.sufficient.to...i
3e780 6e 73 74 65 61 64 20 75 73 65 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 nstead.use.the.function.~transie
3e7a0 6e 74 2d 61 72 67 73 7e 2c 20 77 68 69 63 68 20 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f nt-args~,.which.returns.a.list.o
3e7c0 66 0a 20 20 76 61 6c 75 65 73 2e 20 20 49 6e 20 63 6f 6d 70 6c 65 78 20 63 61 73 65 73 20 69 74 f...values...In.complex.cases.it
3e7e0 20 6d 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 75 73 65 20 74 68 69 73 20 .might.be.necessary.to.use.this.
3e800 76 61 72 69 61 62 6c 65 0a 20 20 69 6e 73 74 65 61 64 2c 20 69 2e 65 2e 2c 20 69 66 20 79 6f 75 variable...instead,.i.e.,.if.you
3e820 20 6e 65 65 64 20 61 63 63 65 73 73 20 74 6f 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 62 65 73 69 .need.access.to.information.besi
3e840 64 65 20 74 68 65 20 76 61 6c 75 65 2e 0a 0a 2a 2a 20 43 75 72 72 65 6e 74 20 50 72 65 66 69 78 de.the.value...**.Current.Prefix
3e860 20 43 6f 6d 6d 61 6e 64 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d .Command..-.Function:.transient-
3e880 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f prefix-object.::....This.functio
3e8a0 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 65 66 69 78 20 61 73 20 n.returns.the.current.prefix.as.
3e8c0 61 6e 20 6f 62 6a 65 63 74 2e 0a 0a 20 20 57 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 an.object.....While.a.transient.
3e8e0 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 20 6f 72 20 72 65 66 72 65 73 68 65 64 20 28 77 68 69 is.being.setup.or.refreshed.(whi
3e900 63 68 20 69 6e 76 6f 6c 76 65 73 0a 20 20 70 72 65 70 61 72 69 6e 67 20 69 74 73 20 73 75 66 66 ch.involves...preparing.its.suff
3e920 69 78 65 73 29 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 ixes).the.variable.~transient--p
3e940 72 65 66 69 78 7e 20 63 61 6e 20 62 65 0a 20 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 refix~.can.be...used.to.access.t
3e960 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 2e 20 20 54 68 75 73 20 74 68 69 73 20 69 73 20 he.prefix.object...Thus.this.is.
3e980 77 68 61 74 20 68 61 73 20 74 6f 20 62 65 0a 20 20 75 73 65 64 20 69 6e 20 73 75 66 66 69 78 20 what.has.to.be...used.in.suffix.
3e9a0 6d 65 74 68 6f 64 73 20 73 75 63 68 20 61 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 methods.such.as.~transient-forma
3e9c0 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 7e 2c 0a 20 20 61 6e 64 20 69 6e 20 6f 62 6a 65 63 74 2d t-description~,...and.in.object-
3e9e0 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 61 72 65 20 73 74 6f 72 specific.functions.that.are.stor
3ea00 65 64 20 69 6e 20 73 75 66 66 69 78 20 73 6c 6f 74 73 0a 20 20 73 75 63 68 20 61 73 20 7e 64 65 ed.in.suffix.slots...such.as.~de
3ea20 73 63 72 69 70 74 69 6f 6e 7e 2e 0a 0a 20 20 57 68 65 6e 20 61 20 73 75 66 66 69 78 20 63 6f 6d scription~.....When.a.suffix.com
3ea40 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 28 69 2e 65 2e 2c 20 69 6e 20 69 74 73 20 7e 69 mand.is.invoked.(i.e.,.in.its.~i
3ea60 6e 74 65 72 61 63 74 69 76 65 7e 20 66 6f 72 6d 0a 20 20 61 6e 64 20 66 75 6e 63 74 69 6f 6e 20 nteractive~.form...and.function.
3ea80 62 6f 64 79 29 20 74 68 65 6e 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 7e 74 72 61 6e 73 69 65 body).then.the.variable.~transie
3eaa0 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 7e 0a 20 20 68 61 73 20 74 6f 20 62 65 20 75 nt-current-prefix~...has.to.be.u
3eac0 73 65 64 20 69 6e 73 74 65 61 64 2e 0a 0a 20 20 54 77 6f 20 64 69 73 74 69 6e 63 74 20 76 61 72 sed.instead.....Two.distinct.var
3eae0 69 61 62 6c 65 73 20 61 72 65 20 6e 65 65 64 65 64 2c 20 62 65 63 61 75 73 65 20 61 6e 79 20 70 iables.are.needed,.because.any.p
3eb00 72 65 66 69 78 20 6d 61 79 20 69 74 73 65 6c 66 0a 20 20 62 65 20 75 73 65 64 20 61 73 20 61 20 refix.may.itself...be.used.as.a.
3eb20 73 75 66 66 69 78 20 6f 66 20 61 6e 6f 74 68 65 72 20 70 72 65 66 69 78 2c 20 61 6e 64 20 73 75 suffix.of.another.prefix,.and.su
3eb40 63 68 20 73 75 62 2d 70 72 65 66 69 78 65 73 20 68 61 76 65 0a 20 20 74 6f 20 62 65 20 61 62 6c ch.sub-prefixes.have...to.be.abl
3eb60 65 20 74 6f 20 74 65 6c 6c 20 74 68 65 6d 73 65 6c 76 65 73 20 61 70 61 72 74 20 66 72 6f 6d 20 e.to.tell.themselves.apart.from.
3eb80 74 68 65 20 70 72 65 66 69 78 20 74 68 65 79 20 77 65 72 65 0a 20 20 69 6e 76 6f 6b 65 64 20 66 the.prefix.they.were...invoked.f
3eba0 72 6f 6d 2e 0a 0a 20 20 52 65 67 75 6c 61 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c rom.....Regular.suffix.commands,
3ebc0 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 20 70 72 65 66 69 78 65 73 2c 20 64 6f 20 6e 6f 74 20 .which.are.not.prefixes,.do.not.
3ebe0 68 61 76 65 20 74 6f 0a 20 20 63 6f 6e 63 65 72 6e 20 74 68 65 6d 73 65 6c 76 65 73 20 77 69 74 have.to...concern.themselves.wit
3ec00 68 20 74 68 69 73 20 64 69 73 74 69 6e 63 74 69 6f 6e 2c 20 73 6f 20 74 68 65 79 20 63 61 6e 20 h.this.distinction,.so.they.can.
3ec20 75 73 65 20 74 68 69 73 0a 20 20 66 75 6e 63 74 69 6f 6e 20 69 6e 73 74 65 61 64 2e 20 20 49 6e use.this...function.instead...In
3ec40 20 74 68 65 20 63 6f 6e 74 65 78 74 20 6f 66 20 61 20 70 6c 61 69 6e 20 73 75 66 66 69 78 2c 20 .the.context.of.a.plain.suffix,.
3ec60 69 74 20 61 6c 77 61 79 73 0a 20 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 it.always...returns.the.value.of
3ec80 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 76 61 72 69 61 62 6c 65 2e 0a 0a 2d 20 56 61 .the.appropriate.variable...-.Va
3eca0 72 69 61 62 6c 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 riable:.transient-current-prefix
3ecc0 20 3a 3a 0a 0a 20 20 54 68 65 20 74 72 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 .::....The.transient.from.which.
3ece0 74 68 69 73 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e this.suffix.command.was.invoked.
3ed00 20 20 54 68 65 20 76 61 6c 75 65 0a 20 20 69 73 20 61 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 ..The.value...is.a.~transient-pr
3ed20 65 66 69 78 7e 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 68 6f 6c 64 73 20 69 6e 66 6f 72 6d efix~.object,.which.holds.inform
3ed40 61 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 77 69 74 68 20 74 68 65 20 74 72 61 6e ation.associated...with.the.tran
3ed60 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 2d 20 56 61 72 69 61 62 6c sient.prefix.command...-.Variabl
3ed80 65 3a 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 20 3a 3a 0a e:.transient-current-command.::.
3eda0 0a 20 20 54 68 65 20 74 72 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 ...The.transient.from.which.this
3edc0 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e 20 20 54 68 .suffix.command.was.invoked...Th
3ede0 65 20 76 61 6c 75 65 0a 20 20 69 73 20 61 20 73 79 6d 62 6f 6c 2c 20 74 68 65 20 74 72 61 6e 73 e.value...is.a.symbol,.the.trans
3ee00 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e ient.prefix.command...-.Function
3ee20 3a 20 74 72 61 6e 73 69 65 6e 74 2d 61 63 74 69 76 65 2d 70 72 65 66 69 78 20 26 6f 70 74 69 6f :.transient-active-prefix.&optio
3ee40 6e 61 6c 20 70 72 65 66 69 78 65 73 20 3a 3a 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e nal.prefixes.::....This.function
3ee60 20 72 65 74 75 72 6e 73 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 6f 62 .returns.the.active.transient.ob
3ee80 6a 65 63 74 2e 20 20 49 74 20 72 65 74 75 72 6e 73 20 7e 6e 69 6c 7e 0a 20 20 69 66 20 74 68 65 ject...It.returns.~nil~...if.the
3eea0 72 65 20 69 73 20 6e 6f 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 69 66 20 74 68 re.is.no.active.transient,.if.th
3eec0 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 20 69 73 6e 27 74 0a 20 20 73 68 6f 77 6e e.transient.buffer.isn't...shown
3eee0 2c 20 61 6e 64 20 77 68 69 6c 65 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 ,.and.while.the.active.transient
3ef00 20 69 73 20 73 75 73 70 65 6e 64 65 64 20 28 65 2e 67 2e 2c 20 77 68 69 6c 65 20 74 68 65 0a 20 .is.suspended.(e.g.,.while.the..
3ef20 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 69 6e 20 75 73 65 29 2e 0a 0a 20 20 55 6e 6c 69 6b .minibuffer.is.in.use).....Unlik
3ef40 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 7e 2c 20 77 68 e.~transient-current-prefix~,.wh
3ef60 69 63 68 20 69 73 20 6f 6e 6c 79 20 65 76 65 72 20 6e 6f 6e 2d 7e 6e 69 6c 7e 20 69 6e 20 63 6f ich.is.only.ever.non-~nil~.in.co
3ef80 64 65 0a 20 20 74 68 61 74 20 69 73 20 72 75 6e 20 64 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 de...that.is.run.directly.by.a.c
3efa0 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 69 6c 65 20 61 20 74 ommand.that.is.invoked.while.a.t
3efc0 72 61 6e 73 69 65 6e 74 0a 20 20 69 73 20 63 75 72 72 65 6e 74 2c 20 74 68 69 73 20 66 75 6e 63 ransient...is.current,.this.func
3efe0 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 75 73 65 20 69 6e tion.is.also.suitable.for.use.in
3f000 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 0a 20 20 63 6f 64 65 2c 20 73 75 63 68 20 61 73 20 74 69 .asynchronous...code,.such.as.ti
3f020 6d 65 72 73 20 61 6e 64 20 63 61 6c 6c 62 61 63 6b 73 20 28 74 68 69 73 20 66 75 6e 63 74 69 6f mers.and.callbacks.(this.functio
3f040 6e 27 73 20 6d 61 69 6e 20 75 73 65 2d 63 61 73 65 29 2e 0a 0a 20 20 49 66 20 6f 70 74 69 6f 6e n's.main.use-case).....If.option
3f060 61 6c 20 50 52 45 46 49 58 45 53 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 69 74 20 6d 75 73 al.PREFIXES.is.non-~nil~,.it.mus
3f080 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 73 79 6d 62 6f 6c 0a 20 20 6f t.be.a.prefix.command.symbol...o
3f0a0 72 20 61 20 6c 69 73 74 20 6f 66 20 73 79 6d 62 6f 6c 73 2c 20 69 6e 20 77 68 69 63 68 20 63 61 r.a.list.of.symbols,.in.which.ca
3f0c0 73 65 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 6f 62 6a 65 63 74 20 69 se.the.active.transient.object.i
3f0e0 73 0a 20 20 6f 6e 6c 79 20 72 65 74 75 72 6e 65 64 20 69 66 20 69 74 20 6d 61 74 63 68 65 73 20 s...only.returned.if.it.matches.
3f100 6f 6e 65 20 6f 66 20 74 68 65 20 50 52 45 46 49 58 45 53 2e 0a 0a 2a 2a 20 54 72 61 6e 73 69 65 one.of.the.PREFIXES...**.Transie
3f120 6e 74 20 53 74 61 74 65 0a 23 2b 63 69 6e 64 65 78 3a 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 nt.State.#+cindex:.transient.sta
3f140 74 65 0a 0a 49 6e 76 6f 6b 69 6e 67 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 te..Invoking.a.transient.prefix.
3f160 63 6f 6d 6d 61 6e 64 20 e2 80 9c 61 63 74 69 76 61 74 65 73 e2 80 9d 20 74 68 65 20 72 65 73 70 command....activates....the.resp
3f180 65 63 74 69 76 65 0a 74 72 61 6e 73 69 65 6e 74 2c 20 69 2e 65 2e 2c 20 69 74 20 70 75 74 73 20 ective.transient,.i.e.,.it.puts.
3f1a0 61 20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 20 69 6e 74 6f 20 65 66 66 65 63 74 2c 20 a.transient.keymap.into.effect,.
3f1c0 77 68 69 63 68 20 62 69 6e 64 73 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 69 6e 66 69 which.binds.the.transient's.infi
3f1e0 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 0a 0a 54 68 65 20 64 65 66 61 x.and.suffix.commands...The.defa
3f200 75 6c 74 20 62 65 68 61 76 69 6f 72 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 ult.behavior.while.a.transient.i
3f220 73 20 61 63 74 69 76 65 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 2d 20 49 6e 76 6f 6b s.active.is.as.follows:..-.Invok
3f240 69 6e 67 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 61 66 ing.an.infix.command.does.not.af
3f260 66 65 63 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 3b 20 74 68 65 0a 20 20 fect.the.transient.state;.the...
3f280 74 72 61 6e 73 69 65 6e 74 20 72 65 6d 61 69 6e 73 20 61 63 74 69 76 65 2e 0a 0a 2d 20 49 6e 76 transient.remains.active...-.Inv
3f2a0 6f 6b 69 6e 67 20 61 20 28 6e 6f 6e 2d 69 6e 66 69 78 29 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 oking.a.(non-infix).suffix.comma
3f2c0 6e 64 20 e2 80 9c 64 65 61 63 74 69 76 61 74 65 73 e2 80 9d 20 74 68 65 20 74 72 61 6e 73 69 65 nd....deactivates....the.transie
3f2e0 6e 74 0a 20 20 73 74 61 74 65 20 62 79 20 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 74 72 61 6e 73 nt...state.by.removing.the.trans
3f300 69 65 6e 74 20 6b 65 79 6d 61 70 20 61 6e 64 20 70 65 72 66 6f 72 6d 69 6e 67 20 73 6f 6d 65 0a ient.keymap.and.performing.some.
3f320 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6c 65 61 6e 75 70 2e 0a 0a 2d 20 49 6e 76 6f 6b 69 6e ..additional.cleanup...-.Invokin
3f340 67 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 20 69 6e 20 61 20 6b g.a.command.that.is.bound.in.a.k
3f360 65 79 6d 61 70 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 65 0a 20 20 74 72 61 6e 73 69 65 6e 74 eymap.other.than.the...transient
3f380 20 6b 65 79 6d 61 70 20 69 73 20 64 69 73 61 6c 6c 6f 77 65 64 20 61 6e 64 20 74 72 79 69 6e 67 .keymap.is.disallowed.and.trying
3f3a0 20 74 6f 20 64 6f 20 73 6f 20 72 65 73 75 6c 74 73 20 69 6e 20 61 0a 20 20 77 61 72 6e 69 6e 67 .to.do.so.results.in.a...warning
3f3c0 2e 20 20 54 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 e2 80 9c 64 65 61 63 74 69 76 61 74 65 e2 80 ...This.does.not....deactivate..
3f3e0 9d 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 54 68 65 20 62 65 68 61 76 69 6f 72 20 63 ..the.transient...The.behavior.c
3f400 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 66 6f 72 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 6f an.be.changed.for.all.suffixes.o
3f420 66 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 70 72 65 66 69 78 0a 61 6e 64 2f 6f 72 20 66 6f 72 f.a.particular.prefix.and/or.for
3f440 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 69 78 65 73 2e 20 20 54 68 65 20 76 61 6c 75 65 .individual.suffixes...The.value
3f460 73 20 73 68 6f 75 6c 64 20 6e 65 61 72 6c 79 20 61 6c 77 61 79 73 20 62 65 0a 62 6f 6f 6c 65 61 s.should.nearly.always.be.boolea
3f480 6e 73 2c 20 62 75 74 20 63 65 72 74 61 69 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 63 61 6c 6c 65 ns,.but.certain.functions,.calle
3f4a0 64 20 e2 80 9c 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 e2 80 9d 2c 20 63 61 6e 20 61 6c 73 6f 20 62 d....pre-commands...,.can.also.b
3f4c0 65 0a 75 73 65 64 2e 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e 61 6d e.used...These.functions.are.nam
3f4e0 65 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 56 45 52 42 7e 2c 20 61 6e 64 20 74 68 65 ed.~transient--do-VERB~,.and.the
3f500 20 73 79 6d 62 6f 6c 0a 7e 56 45 52 42 7e 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73 20 61 20 .symbol.~VERB~.can.be.used.as.a.
3f520 73 68 6f 72 74 68 61 6e 64 2e 0a 0a 41 20 62 6f 6f 6c 65 61 6e 20 69 73 20 69 6e 74 65 72 70 72 shorthand...A.boolean.is.interpr
3f540 65 74 65 64 20 61 73 20 61 6e 73 77 65 72 69 6e 67 20 74 68 65 20 71 75 65 73 74 69 6f 6e 20 22 eted.as.answering.the.question."
3f560 64 6f 65 73 20 74 68 65 0a 74 72 61 6e 73 69 65 6e 74 20 73 74 61 79 20 61 63 74 69 76 65 2c 20 does.the.transient.stay.active,.
3f580 77 68 65 6e 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 3f 22 20 20 when.this.command.is.invoked?"..
3f5a0 7e 74 7e 20 6d 65 61 6e 73 20 74 68 61 74 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 ~t~.means.that.the.transient.sta
3f5c0 79 73 20 61 63 74 69 76 65 2c 20 77 68 69 6c 65 20 7e 6e 69 6c 7e 20 6d 65 61 6e 73 20 74 68 61 ys.active,.while.~nil~.means.tha
3f5e0 74 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64 0a 65 78 69 74 73 20 74 68 65 t.invoking.the.command.exits.the
3f600 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 77 68 65 6e 20 74 68 65 20 .transient...Note.that.when.the.
3f620 73 75 66 66 69 78 20 69 73 20 61 20 e2 80 9c 73 75 62 2d 70 72 65 66 69 78 e2 80 9d 2c 20 69 6e suffix.is.a....sub-prefix...,.in
3f640 76 6f 6b 69 6e 67 20 74 68 61 74 20 63 6f 6d 6d 61 6e 64 0a 61 6c 77 61 79 73 20 61 63 74 69 76 voking.that.command.always.activ
3f660 61 74 65 73 20 74 68 61 74 20 73 75 62 2d 70 72 65 66 69 78 2c 20 63 61 75 73 69 6e 67 20 74 68 ates.that.sub-prefix,.causing.th
3f680 65 20 6f 75 74 65 72 20 70 72 65 66 69 78 20 74 6f 20 6e 6f 0a 6c 6f 6e 67 65 72 20 62 65 20 61 e.outer.prefix.to.no.longer.be.a
3f6a0 63 74 69 76 65 20 61 6e 64 20 64 69 73 70 6c 61 79 65 64 2e 20 20 48 65 72 65 20 7e 74 7e 20 6d ctive.and.displayed...Here.~t~.m
3f6c0 65 61 6e 73 20 74 68 61 74 20 77 68 65 6e 20 79 6f 75 20 65 78 69 74 20 74 68 65 0a 69 6e 6e 65 eans.that.when.you.exit.the.inne
3f6e0 72 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 74 68 65 20 6f 75 74 65 72 20 70 72 65 66 69 78 20 r.prefix,.then.the.outer.prefix.
3f700 62 65 63 6f 6d 65 73 20 61 63 74 69 76 65 20 61 67 61 69 6e 2c 20 77 68 69 6c 65 20 7e 6e 69 6c becomes.active.again,.while.~nil
3f720 7e 0a 6d 65 61 6e 73 20 74 68 61 74 20 61 6c 6c 20 6f 75 74 65 72 20 70 72 65 66 69 78 65 73 20 ~.means.that.all.outer.prefixes.
3f740 61 72 65 20 65 78 69 74 65 64 20 61 74 20 6f 6e 63 65 2e 0a 0a 2d 20 54 68 65 20 62 65 68 61 76 are.exited.at.once...-.The.behav
3f760 69 6f 72 20 66 6f 72 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 73 65 74 20 ior.for.non-suffixes.can.be.set.
3f780 66 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 70 72 65 66 69 78 2c 0a 20 20 62 79 20 74 68 for.a.particular.prefix,...by.th
3f7a0 65 20 70 72 65 66 69 78 27 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 e.prefix's.~transient-non-suffix
3f7c0 7e 20 73 6c 6f 74 20 74 6f 20 61 20 62 6f 6f 6c 65 61 6e 2c 20 61 20 73 75 69 74 61 62 6c 65 0a ~.slot.to.a.boolean,.a.suitable.
3f7e0 20 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f 6e 2c 20 6f 72 20 61 20 73 68 6f ..pre-command.function,.or.a.sho
3f800 72 74 68 61 6e 64 20 66 6f 72 20 73 75 63 68 20 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 53 65 65 rthand.for.such.a.function...See
3f820 0a 20 20 5b 5b 2a 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 4e 6f 6e 2d 53 75 66 66 69 ...[[*Pre-commands.for.Non-Suffi
3f840 78 65 73 5d 5d 2e 0a 0a 2d 20 54 68 65 20 63 6f 6d 6d 6f 6e 20 62 65 68 61 76 69 6f 72 20 66 6f xes]]...-.The.common.behavior.fo
3f860 72 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 70 r.the.suffixes.of.a.particular.p
3f880 72 65 66 69 78 20 63 61 6e 20 62 65 0a 20 20 73 65 74 20 75 73 69 6e 67 20 74 68 65 20 70 72 65 refix.can.be...set.using.the.pre
3f8a0 66 69 78 27 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 65 73 7e 20 73 6c 6f 74 2e fix's.~transient-suffixes~.slot.
3f8c0 0a 0a 20 20 54 68 65 20 76 61 6c 75 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 69 73 20 ....The.value.specified.in.this.
3f8e0 73 6c 6f 74 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 61 66 66 65 63 74 20 69 6e 66 69 78 65 73 2e 20 slot.does.*not*.affect.infixes..
3f900 20 42 65 63 61 75 73 65 0a 20 20 69 74 20 61 66 66 65 63 74 73 20 62 6f 74 68 20 72 65 67 75 6c .Because...it.affects.both.regul
3f920 61 72 20 73 75 66 66 69 78 65 73 20 61 73 20 77 65 6c 6c 20 61 73 20 73 75 62 2d 70 72 65 66 69 ar.suffixes.as.well.as.sub-prefi
3f940 78 65 73 2c 20 77 68 69 63 68 0a 20 20 68 61 76 65 20 64 69 66 66 65 72 65 6e 74 20 6e 65 65 64 xes,.which...have.different.need
3f960 73 2c 20 69 74 20 69 73 20 62 65 73 74 20 74 6f 20 61 76 6f 69 64 20 65 78 70 6c 69 63 69 74 6c s,.it.is.best.to.avoid.explicitl
3f980 79 20 73 70 65 63 69 66 79 69 6e 67 20 61 0a 20 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 2d 20 54 68 y.specifying.a...function...-.Th
3f9a0 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 e.behavior.of.an.individual.suff
3f9c0 69 78 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 75 73 69 6e 67 20 69 74 73 0a 20 20 7e 74 ix.can.be.changed.using.its...~t
3f9e0 72 61 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 2e 20 20 57 68 69 6c 65 20 69 74 20 69 73 20 75 73 75 ransient~.slot...While.it.is.usu
3fa00 61 6c 6c 79 20 62 65 73 74 20 74 6f 20 75 73 65 20 61 20 62 6f 6f 6c 65 61 6e 2c 20 66 6f 72 20 ally.best.to.use.a.boolean,.for.
3fa20 74 68 69 73 0a 20 20 73 6c 6f 74 20 69 74 20 63 61 6e 20 6f 63 63 61 73 69 6f 6e 61 6c 6c 79 20 this...slot.it.can.occasionally.
3fa40 6d 61 6b 65 20 73 65 6e 73 65 20 74 6f 20 73 70 65 63 69 66 79 20 61 20 66 75 6e 63 74 69 6f 6e make.sense.to.specify.a.function
3fa60 20 65 78 70 6c 69 63 69 74 6c 79 2e 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 73 .explicitly.....Note.that.this.s
3fa80 6c 6f 74 20 63 61 6e 20 62 65 20 73 65 74 20 77 68 65 6e 20 64 65 66 69 6e 69 6e 67 20 61 20 73 lot.can.be.set.when.defining.a.s
3faa0 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 uffix.command.using...~transient
3fac0 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 7e 20 61 6e 64 2f 6f 72 20 69 6e 20 74 68 65 20 64 65 -define-suffix~.and/or.in.the.de
3fae0 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 2e 20 20 49 66 0a 20 20 73 65 finition.of.the.prefix...If...se
3fb00 74 20 69 6e 20 62 6f 74 68 20 70 6c 61 63 65 73 2c 20 74 68 65 6e 20 74 68 65 20 6c 61 74 74 65 t.in.both.places,.then.the.latte
3fb20 72 20 74 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 2c 20 61 73 20 75 73 75 61 6c 2e 0a 0a 54 r.takes.precedence,.as.usual...T
3fb40 68 65 20 61 76 61 69 6c 61 62 6c 65 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f he.available.pre-command.functio
3fb60 6e 73 20 61 72 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 ns.are.documented.in.the.followi
3fb80 6e 67 0a 73 75 62 2d 73 65 63 74 69 6f 6e 73 2e 20 20 54 68 65 79 20 61 72 65 20 63 61 6c 6c 65 ng.sub-sections...They.are.calle
3fba0 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 7e 2c 20 61 d.by.~transient--pre-command~,.a
3fbc0 20 66 75 6e 63 74 69 6f 6e 0a 6f 6e 20 7e 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 7e 2c .function.on.~pre-command-hook~,
3fbe0 20 61 6e 64 20 74 68 65 20 76 61 6c 75 65 20 74 68 61 74 20 74 68 65 79 20 72 65 74 75 72 6e 20 .and.the.value.that.they.return.
3fc00 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 72 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 determines.whether.the.transient
3fc20 20 69 73 20 65 78 69 74 65 64 2e 20 20 54 6f 20 64 6f 20 73 6f 20 74 68 65 20 76 61 6c 75 65 20 .is.exited...To.do.so.the.value.
3fc40 6f 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 63 6f 6e 73 74 61 6e 74 73 0a 7e 74 72 61 6e 73 69 65 of.one.of.the.constants.~transie
3fc60 6e 74 2d 2d 65 78 69 74 7e 20 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 7e 20 69 nt--exit~.or.~transient--stay~.i
3fc80 73 20 75 73 65 64 20 28 74 68 61 74 20 77 61 79 20 77 65 20 64 6f 6e 27 74 20 68 61 76 65 20 74 s.used.(that.way.we.don't.have.t
3fca0 6f 0a 72 65 6d 65 6d 62 65 72 20 69 66 20 7e 74 7e 20 6d 65 61 6e 73 20 e2 80 9c 65 78 69 74 e2 o.remember.if.~t~.means....exit.
3fcc0 80 9d 20 6f 72 20 e2 80 9c 73 74 61 79 e2 80 9d 29 2e 0a 0a 41 64 64 69 74 69 6f 6e 61 6c 6c 79 ...or....stay...)...Additionally
3fce0 2c 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 6d 61 79 20 63 68 61 6e 67 65 20 74 68 65 ,.these.functions.may.change.the
3fd00 20 76 61 6c 75 65 20 6f 66 20 7e 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 7e 0a 28 77 68 69 63 68 20 .value.of.~this-command~.(which.
3fd20 65 78 70 6c 61 69 6e 73 20 77 68 79 20 74 68 65 79 20 68 61 76 65 20 74 6f 20 62 65 20 63 61 6c explains.why.they.have.to.be.cal
3fd40 6c 65 64 20 75 73 69 6e 67 20 7e 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 7e 29 2c 0a 63 led.using.~pre-command-hook~),.c
3fd60 61 6c 6c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 65 78 70 6f 72 74 7e 2c 20 7e 74 72 61 6e 73 69 65 all.~transient-export~,.~transie
3fd80 6e 74 2d 2d 73 74 61 63 6b 2d 7a 61 70 7e 20 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 nt--stack-zap~.or.~transient--st
3fda0 61 63 6b 2d 70 75 73 68 7e 3b 0a 61 6e 64 20 73 65 74 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 ack-push~;.and.set.the.values.of
3fdc0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 7e 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d .~transient--exitp~,.~transient-
3fde0 2d 68 65 6c 70 70 7e 20 6f 72 0a 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 7e 2e 0a 0a -helpp~.or.~transient--editp~...
3fe00 46 6f 72 20 63 6f 6d 70 6c 65 74 65 6e 65 73 73 20 73 61 6b 65 2c 20 73 6f 6d 65 20 6e 6f 74 65 For.completeness.sake,.some.note
3fe20 73 20 61 62 6f 75 74 20 63 6f 6d 70 6c 69 63 61 74 69 6f 6e 73 3a 0a 0a 2d 20 54 68 65 20 74 72 s.about.complications:..-.The.tr
3fe40 61 6e 73 69 65 6e 74 2d 6e 65 73 73 20 6f 66 20 63 65 72 74 61 69 6e 20 62 75 69 6c 74 2d 69 6e ansient-ness.of.certain.built-in
3fe60 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 69 73 20 73 70 65 63 69 66 69 65 64 0a 20 20 .suffix.commands.is.specified...
3fe80 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 7e 2e using.~transient-predicate-map~.
3fea0 20 20 54 68 69 73 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 6b 65 79 6d 61 70 2c 20 77 68 69 63 ..This.is.a.special.keymap,.whic
3fec0 68 0a 20 20 62 69 6e 64 73 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 70 72 65 2d 63 6f 6d 6d 61 6e h...binds.commands.to.pre-comman
3fee0 64 73 20 28 61 73 20 6f 70 70 6f 73 65 64 20 74 6f 20 6b 65 79 73 20 74 6f 20 63 6f 6d 6d 61 6e ds.(as.opposed.to.keys.to.comman
3ff00 64 73 29 20 61 6e 64 0a 20 20 74 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 20 6f 76 65 72 20 ds).and...takes.precedence.over.
3ff20 74 68 65 20 70 72 65 66 69 78 27 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 the.prefix's.~transient-suffix~.
3ff40 73 6c 6f 74 2c 20 62 75 74 20 6e 6f 74 0a 20 20 74 68 65 20 73 75 66 66 69 78 27 73 20 7e 74 72 slot,.but.not...the.suffix's.~tr
3ff60 61 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 2e 0a 0a 2d 20 57 68 69 6c 65 20 61 20 73 75 62 2d 70 72 ansient~.slot...-.While.a.sub-pr
3ff80 65 66 69 78 20 69 73 20 61 63 74 69 76 65 20 77 65 20 6e 65 61 72 6c 79 20 61 6c 77 61 79 73 20 efix.is.active.we.nearly.always.
3ffa0 77 61 6e 74 20 7b 7b 7b 6b 62 64 28 43 2d 67 29 7d 7d 7d 20 74 6f 20 74 61 6b 65 20 74 68 65 0a want.{{{kbd(C-g)}}}.to.take.the.
3ffc0 20 20 75 73 65 72 20 62 61 63 6b 20 74 6f 20 74 68 65 20 e2 80 9c 73 75 70 65 72 2d 70 72 65 66 ..user.back.to.the....super-pref
3ffe0 69 78 e2 80 9d 2c 20 65 76 65 6e 20 77 68 65 6e 20 74 68 65 20 6f 74 68 65 72 20 73 75 66 66 69 ix...,.even.when.the.other.suffi
40000 78 65 73 20 64 6f 6e 27 74 0a 20 20 64 6f 20 74 68 61 74 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 xes.don't...do.that...However,.i
40020 6e 20 72 61 72 65 20 63 61 73 65 73 20 74 68 69 73 20 6d 61 79 20 6e 6f 74 20 62 65 20 64 65 73 n.rare.cases.this.may.not.be.des
40040 69 72 61 62 6c 65 2c 20 69 6e 20 77 68 69 63 68 0a 20 20 63 61 73 65 20 7e 72 65 70 6c 61 63 65 irable,.in.which...case.~replace
40060 7e 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 ~.can.be.used.as.the.value.of.th
40080 65 20 73 75 62 2d 70 72 65 66 69 78 27 73 20 7e 74 72 61 6e 73 69 65 6e 74 7e 0a 20 20 73 6c 6f e.sub-prefix's.~transient~...slo
400a0 74 2e 0a 0a 2a 2a 2a 20 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 49 6e 66 69 78 65 73 t...***.Pre-commands.for.Infixes
400c0 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 .:PROPERTIES:.:UNNUMBERED:.notoc
400e0 0a 3a 45 4e 44 3a 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 69 6e 66 69 78 65 73 20 .:END:..The.default.for.infixes.
40100 69 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 7e 2e 20 20 54 68 69 73 20 69 is.~transient--do-stay~...This.i
40120 73 20 61 6c 73 6f 20 74 68 65 20 6f 6e 6c 79 0a 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 6d 61 s.also.the.only.function.that.ma
40140 6b 65 73 20 73 65 6e 73 65 20 66 6f 72 20 69 6e 66 69 78 65 73 2c 20 77 68 69 63 68 20 69 73 20 kes.sense.for.infixes,.which.is.
40160 77 68 79 20 74 68 69 73 20 70 72 65 64 69 63 61 74 65 20 69 73 0a 75 73 65 64 20 65 76 65 6e 20 why.this.predicate.is.used.even.
40180 69 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 27 73 20 7e 74 72 if.the.value.of.the.prefix's.~tr
401a0 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 73 6c 6f 74 20 69 73 20 7e 74 7e 2e 20 20 49 6e ansient-suffix~.slot.is.~t~...In
401c0 0a 65 78 74 72 65 6d 65 6c 79 20 72 61 72 65 20 63 61 73 65 73 2c 20 6f 6e 65 20 6d 69 67 68 74 .extremely.rare.cases,.one.might
401e0 20 77 61 6e 74 20 74 6f 20 75 73 65 20 73 6f 6d 65 74 68 69 6e 67 20 65 6c 73 65 2c 20 77 68 69 .want.to.use.something.else,.whi
40200 63 68 20 63 61 6e 0a 62 65 20 64 6f 6e 65 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 69 6e ch.can.be.done.by.setting.the.in
40220 66 69 78 27 73 20 7e 74 72 61 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 20 64 69 72 65 63 74 6c 79 2e fix's.~transient~.slot.directly.
40240 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 ..-.Function:.transient--do-stay
40260 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 .::....Call.the.command.without.
40280 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 exporting.variables.and.stay.tra
402a0 6e 73 69 65 6e 74 2e 0a 0a 2a 2a 2a 20 50 72 65 2d 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 53 75 nsient...***.Pre-commands.for.Su
402c0 66 66 69 78 65 73 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a ffixes.:PROPERTIES:.:UNNUMBERED:
402e0 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 42 79 20 64 65 66 61 75 6c 74 2c 20 69 6e 76 6f 6b 69 .notoc.:END:..By.default,.invoki
40300 6e 67 20 61 20 73 75 66 66 69 78 20 63 61 75 73 65 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 ng.a.suffix.causes.the.transient
40320 20 74 6f 20 62 65 20 65 78 69 74 65 64 2e 0a 0a 54 68 65 20 62 65 68 61 76 69 6f 72 20 66 6f 72 .to.be.exited...The.behavior.for
40340 20 61 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 .an.individual.suffix.command.ca
40360 6e 20 62 65 20 63 68 61 6e 67 65 64 20 62 79 0a 73 65 74 74 69 6e 67 20 69 74 73 20 7e 74 72 61 n.be.changed.by.setting.its.~tra
40380 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 20 74 6f 20 61 20 62 6f 6f 6c 65 61 6e 20 28 77 68 69 63 68 nsient~.slot.to.a.boolean.(which
403a0 20 69 73 20 68 69 67 68 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 29 2c 0a 6f 72 20 74 6f 20 6f .is.highly.recommended),.or.to.o
403c0 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 ne.of.the.following.pre-commands
403e0 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 ...-.Function:.transient--do-exi
40400 74 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 t.::....Call.the.command.after.e
40420 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 65 78 69 74 20 74 68 65 20 xporting.variables.and.exit.the.
40440 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e transient...-.Function:.transien
40460 74 2d 2d 64 6f 2d 72 65 74 75 72 6e 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d t--do-return.::....Call.the.comm
40480 61 6e 64 20 61 66 74 65 72 20 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e and.after.exporting.variables.an
404a0 64 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 0a 20 20 70 72 65 66 69 78 2e d.return.to.the.parent...prefix.
404c0 20 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 2c 20 ..If.there.is.no.parent.prefix,.
404e0 74 68 65 6e 20 63 61 6c 6c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 7e 2e 0a then.call.~transient--do-exit~..
40500 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 20 .-.Function:.transient--do-call.
40520 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 78 70 ::....Call.the.command.after.exp
40540 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 orting.variables.and.stay.transi
40560 65 6e 74 2e 0a 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 ent...The.following.pre-commands
40580 20 61 72 65 20 6f 6e 6c 79 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 73 75 62 2d 70 72 65 66 69 .are.only.suitable.for.sub-prefi
405a0 78 65 73 2e 20 20 49 74 20 69 73 0a 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 65 78 70 xes...It.is.not.necessary.to.exp
405c0 6c 69 63 69 74 6c 79 20 75 73 65 20 74 68 65 73 65 20 70 72 65 64 69 63 61 74 65 73 20 62 65 63 licitly.use.these.predicates.bec
405e0 61 75 73 65 20 74 68 65 20 63 6f 72 72 65 63 74 0a 70 72 65 64 69 63 61 74 65 20 69 73 20 61 75 ause.the.correct.predicate.is.au
40600 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 69 63 6b 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 tomatically.picked.based.on.the.
40620 76 61 6c 75 65 20 6f 66 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 7e 0a 73 6c 6f 74 20 66 6f value.of.the.~transient~.slot.fo
40640 72 20 74 68 65 20 73 75 62 2d 70 72 65 66 69 78 20 69 74 73 65 6c 66 2e 0a 0a 2d 20 46 75 6e 63 r.the.sub-prefix.itself...-.Func
40660 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 65 20 3a 3a 0a 0a tion:.transient--do-recurse.::..
40680 20 20 43 61 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d ..Call.the.transient.prefix.comm
406a0 61 6e 64 2c 20 70 72 65 70 61 72 69 6e 67 20 66 6f 72 20 72 65 74 75 72 6e 20 74 6f 20 6f 75 74 and,.preparing.for.return.to.out
406c0 65 72 0a 20 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 57 68 65 74 68 65 72 20 77 65 20 61 63 er...transient.....Whether.we.ac
406e0 74 75 61 6c 6c 79 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 74 72 61 6e tually.return.to.the.parent.tran
40700 73 69 65 6e 74 20 69 73 20 75 6c 74 69 6d 61 74 65 6c 79 0a 20 20 75 6e 64 65 72 20 74 68 65 20 sient.is.ultimately...under.the.
40720 63 6f 6e 74 72 6f 6c 20 6f 66 20 65 61 63 68 20 69 6e 76 6f 6b 65 64 20 73 75 66 66 69 78 2e 20 control.of.each.invoked.suffix..
40740 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 0a 20 20 74 68 69 73 20 70 .The.difference.between...this.p
40760 72 65 2d 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 re-command.and.~transient--do-st
40780 61 63 6b 7e 20 69 73 20 74 68 61 74 20 69 74 20 63 68 61 6e 67 65 73 20 74 68 65 0a 20 20 76 61 ack~.is.that.it.changes.the...va
407a0 6c 75 65 20 6f 66 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 73 6c lue.of.the.~transient-suffix~.sl
407c0 6f 74 20 74 6f 20 7e 74 7e 2e 0a 0a 20 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 61 72 ot.to.~t~.....If.there.is.no.par
407e0 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 63 61 6c 6c 20 74 68 ent.transient,.then.only.call.th
40800 69 73 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 20 20 73 6b 69 70 20 74 68 65 20 73 65 63 6f 6e 64 is.command.and...skip.the.second
40820 20 73 74 65 70 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 .step...-.Function:.transient--d
40840 6f 2d 73 74 61 63 6b 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 o-stack.::....Call.the.transient
40860 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 73 74 61 63 6b 69 6e 67 20 74 68 65 20 61 63 .prefix.command,.stacking.the.ac
40880 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 20 20 50 75 73 68 20 74 68 65 20 61 63 74 69 76 tive.transient....Push.the.activ
408a0 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 e.transient.to.the.transient.sta
408c0 63 6b 2e 0a 0a 20 20 55 6e 6c 65 73 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 ck.....Unless.~transient--do-rec
408e0 75 72 73 65 7e 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 75 73 65 64 2c 20 74 68 69 73 20 70 urse~.is.explicitly.used,.this.p
40900 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 73 re-command...is.automatically.us
40920 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 72 65 20 70 72 65 66 69 78 65 ed.for.suffixes.that.are.prefixe
40940 73 20 74 68 65 6d 73 65 6c 76 65 73 2c 0a 20 20 69 2e 65 2e 2c 20 66 6f 72 20 73 75 62 2d 70 72 s.themselves,...i.e.,.for.sub-pr
40960 65 66 69 78 65 73 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d efixes...-.Function:.transient--
40980 64 6f 2d 72 65 70 6c 61 63 65 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 do-replace.::....Call.the.transi
409a0 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 72 65 70 6c 61 63 69 6e 67 20 74 68 ent.prefix.command,.replacing.th
409c0 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 20 20 44 6f 20 6e 6f 74 20 70 75 73 e.active.transient....Do.not.pus
409e0 68 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 74 68 65 20 74 72 h.the.active.transient.to.the.tr
40a00 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 0a 0a 20 20 55 6e 6c 65 73 73 20 7e 74 72 61 6e 73 69 ansient.stack.....Unless.~transi
40a20 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 65 7e 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 75 ent--do-recurse~.is.explicitly.u
40a40 73 65 64 2c 20 74 68 69 73 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 69 73 20 61 75 74 6f 6d sed,.this.pre-command...is.autom
40a60 61 74 69 63 61 6c 6c 79 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 atically.used.for.suffixes.that.
40a80 61 72 65 20 70 72 65 66 69 78 65 73 20 74 68 65 6d 73 65 6c 76 65 73 2c 0a 20 20 69 2e 65 2e 2c are.prefixes.themselves,...i.e.,
40aa0 20 66 6f 72 20 73 75 62 2d 70 72 65 66 69 78 65 73 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 .for.sub-prefixes...-.Function:.
40ac0 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 6e 64 20 3a 3a 0a 0a 20 20 53 75 73 70 transient--do-suspend.::....Susp
40ae0 65 6e 64 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 73 61 76 69 6e 67 end.the.active.transient,.saving
40b00 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 0a 0a 20 20 54 68 69 73 20 69 73 .the.transient.stack.....This.is
40b20 20 75 73 65 64 20 62 79 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d .used.by.the.command.~transient-
40b40 73 75 73 70 65 6e 64 7e 20 61 6e 64 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 61 6c 73 6f 20 62 79 0a suspend~.and.optionally.also.by.
40b60 20 20 e2 80 9c 65 78 74 65 72 6e 61 6c 20 65 76 65 6e 74 73 e2 80 9d 20 73 75 63 68 20 61 73 20 .....external.events....such.as.
40b80 7e 68 61 6e 64 6c 65 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 7e 2e 20 20 53 75 63 68 20 62 69 6e ~handle-switch-frame~...Such.bin
40ba0 64 69 6e 67 73 20 73 68 6f 75 6c 64 0a 20 20 62 65 20 61 64 64 65 64 20 74 6f 20 7e 74 72 61 6e dings.should...be.added.to.~tran
40bc0 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 7e 2e 0a 0a 2a 2a 2a 20 50 72 65 2d 63 sient-predicate-map~...***.Pre-c
40be0 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 4e 6f 6e 2d 53 75 66 66 69 78 65 73 0a 3a 50 52 4f 50 45 52 ommands.for.Non-Suffixes.:PROPER
40c00 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a TIES:.:UNNUMBERED:.notoc.:END:..
40c20 42 79 20 64 65 66 61 75 6c 74 2c 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 28 63 6f 6d 6d 61 6e By.default,.non-suffixes.(comman
40c40 64 73 20 74 68 61 74 20 61 72 65 20 62 6f 75 6e 64 20 69 6e 20 6f 74 68 65 72 20 6b 65 79 6d 61 ds.that.are.bound.in.other.keyma
40c60 70 73 0a 62 65 73 69 64 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6b 65 79 6d 61 70 29 20 ps.beside.the.transient.keymap).
40c80 63 61 6e 6e 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 2e 20 20 54 72 79 69 6e 67 20 74 6f 20 69 6e cannot.be.invoked...Trying.to.in
40ca0 76 6f 6b 65 0a 73 75 63 68 20 61 20 63 6f 6d 6d 61 6e 64 20 72 65 73 75 6c 74 73 20 69 6e 20 61 voke.such.a.command.results.in.a
40cc0 20 77 61 72 6e 69 6e 67 20 61 6e 64 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 79 73 .warning.and.the.transient.stays
40ce0 20 61 63 74 69 76 65 2e 0a 0a 49 66 20 79 6f 75 20 77 61 6e 74 20 61 20 64 69 66 66 65 72 65 6e .active...If.you.want.a.differen
40d00 74 20 62 65 68 61 76 69 6f 72 2c 20 74 68 65 6e 20 73 65 74 20 74 68 65 20 7e 74 72 61 6e 73 69 t.behavior,.then.set.the.~transi
40d20 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 7e 0a 73 6c 6f 74 20 6f 66 20 74 68 65 20 74 72 61 6e ent-non-suffix~.slot.of.the.tran
40d40 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 65 20 76 61 6c 75 65 sient.prefix.command...The.value
40d60 20 73 68 6f 75 6c 64 20 62 65 20 61 20 62 6f 6f 6c 65 61 6e 2c 0a 61 6e 73 77 65 72 69 6e 67 20 .should.be.a.boolean,.answering.
40d80 74 68 65 20 71 75 65 73 74 69 6f 6e 2c 20 22 69 73 20 69 74 20 61 6c 6c 6f 77 65 64 20 74 6f 20 the.question,."is.it.allowed.to.
40da0 69 6e 76 6f 6b 65 20 6e 6f 6e 2d 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 3f 2c 0a 61 20 70 invoke.non-suffix.commands?,.a.p
40dc0 72 65 2d 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f 6e 2c 20 6f 72 20 61 20 73 68 6f 72 74 68 re-command.function,.or.a.shorth
40de0 61 6e 64 20 66 6f 72 20 73 75 63 68 20 61 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 49 66 20 74 68 65 and.for.such.a.function...If.the
40e00 20 76 61 6c 75 65 20 69 73 20 7e 74 7e 2c 20 74 68 65 6e 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 .value.is.~t~,.then.non-suffixes
40e20 20 63 61 6e 20 62 65 20 69 6e 76 6f 6b 65 64 2c 20 77 68 65 6e 20 69 74 20 69 73 20 7e 6e 69 6c .can.be.invoked,.when.it.is.~nil
40e40 7e 0a 28 74 68 65 20 64 65 66 61 75 6c 74 29 20 74 68 65 6e 20 74 68 65 79 20 63 61 6e 6e 6f 74 ~.(the.default).then.they.cannot
40e60 20 62 65 20 69 6e 76 6f 6b 65 64 2e 0a 0a 54 68 65 20 6f 6e 6c 79 20 6f 74 68 65 72 20 72 65 63 .be.invoked...The.only.other.rec
40e80 6f 6d 6d 65 6e 64 65 64 20 76 61 6c 75 65 20 69 73 20 7e 6c 65 61 76 65 7e 2e 20 20 49 66 20 74 ommended.value.is.~leave~...If.t
40ea0 68 61 74 20 69 73 20 75 73 65 64 2c 20 74 68 65 6e 0a 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 63 hat.is.used,.then.non-suffixes.c
40ec0 61 6e 20 62 65 20 69 6e 76 6f 6b 65 64 2c 20 62 75 74 20 69 66 20 6f 6e 65 20 69 73 20 69 6e 76 an.be.invoked,.but.if.one.is.inv
40ee0 6f 6b 65 64 2c 20 74 68 65 6e 20 74 68 61 74 20 65 78 69 74 73 0a 74 68 65 20 74 72 61 6e 73 69 oked,.then.that.exits.the.transi
40f00 65 6e 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d ent...-.Function:.transient--do-
40f20 77 61 72 6e 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 warn.::....Call.~transient-undef
40f40 69 6e 65 64 7e 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 2d 20 46 75 6e ined~.and.stay.transient...-.Fun
40f60 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 20 3a 3a 0a 0a 20 20 ction:.transient--do-stay.::....
40f80 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 65 78 70 6f 72 74 69 Call.the.command.without.exporti
40fa0 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e ng.variables.and.stay.transient.
40fc0 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6c 65 61 76 ..-.Function:.transient--do-leav
40fe0 65 20 3a 3a 0a 0a 20 20 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 e.::....Call.the.command.without
41000 20 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 65 78 69 74 20 74 68 .exporting.variables.and.exit.th
41020 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 23 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6e 6f e.transient...#.transient--do-no
41040 6f 70 20 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 20 6c 65 66 74 20 75 6e 64 6f 63 75 6d 65 6e 74 op.intentionally.left.undocument
41060 65 64 2e 0a 0a 2a 2a 2a 20 53 70 65 63 69 61 6c 20 50 72 65 2d 43 6f 6d 6d 61 6e 64 73 0a 3a 50 ed...***.Special.Pre-Commands.:P
41080 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 ROPERTIES:.:UNNUMBERED:.notoc.:E
410a0 4e 44 3a 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 71 ND:..-.Function:.transient--do-q
410c0 75 69 74 2d 6f 6e 65 20 3a 3a 0a 0a 20 20 49 66 20 61 63 74 69 76 65 2c 20 71 75 69 74 20 68 65 uit-one.::....If.active,.quit.he
410e0 6c 70 20 6f 72 20 65 64 69 74 20 6d 6f 64 65 2c 20 65 6c 73 65 20 65 78 69 74 20 74 68 65 20 61 lp.or.edit.mode,.else.exit.the.a
41100 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e 0a 0a 20 20 54 68 69 73 20 69 73 20 75 73 65 64 ctive.transient.....This.is.used
41120 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 70 72 65 73 73 65 64 20 7b 7b 7b 6b 62 64 28 43 2d .when.the.user.pressed.{{{kbd(C-
41140 67 29 7d 7d 7d 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 g)}}}...-.Function:.transient--d
41160 6f 2d 71 75 69 74 2d 61 6c 6c 20 3a 3a 0a 0a 20 20 45 78 69 74 20 61 6c 6c 20 74 72 61 6e 73 69 o-quit-all.::....Exit.all.transi
41180 65 6e 74 73 20 77 69 74 68 6f 75 74 20 73 61 76 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 6e ents.without.saving.the.transien
411a0 74 20 73 74 61 63 6b 2e 0a 0a 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 t.stack.....This.is.used.when.th
411c0 65 20 75 73 65 72 20 70 72 65 73 73 65 64 20 7b 7b 7b 6b 62 64 28 43 2d 71 29 7d 7d 7d 2e 0a 0a e.user.pressed.{{{kbd(C-q)}}}...
411e0 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 6e -.Function:.transient--do-suspen
41200 64 20 3a 3a 0a 0a 20 20 53 75 73 70 65 6e 64 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 d.::....Suspend.the.active.trans
41220 69 65 6e 74 2c 20 73 61 76 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b ient,.saving.the.transient.stack
41240 2e 0a 0a 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 .....This.is.used.when.the.user.
41260 70 72 65 73 73 65 64 20 7b 7b 7b 6b 62 64 28 43 2d 7a 29 7d 7d 7d 2e 0a 0a 2a 20 43 6c 61 73 73 pressed.{{{kbd(C-z)}}}...*.Class
41280 65 73 20 61 6e 64 20 4d 65 74 68 6f 64 73 0a 23 2b 63 69 6e 64 65 78 3a 20 63 6c 61 73 73 65 73 es.and.Methods.#+cindex:.classes
412a0 20 61 6e 64 20 6d 65 74 68 6f 64 73 0a 0a 54 72 61 6e 73 69 65 6e 74 20 75 73 65 73 20 63 6c 61 .and.methods..Transient.uses.cla
412c0 73 73 65 73 20 61 6e 64 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 6d 61 sses.and.generic.functions.to.ma
412e0 6b 65 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 0a 64 65 66 69 6e 65 20 6e 65 77 20 74 79 70 ke.it.possible.to.define.new.typ
41300 65 73 20 6f 66 20 73 75 66 66 69 78 20 61 6e 64 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 es.of.suffix.and.prefix.commands
41320 2c 20 77 68 69 63 68 20 61 72 65 20 73 69 6d 69 6c 61 72 20 74 6f 0a 65 78 69 73 74 69 6e 67 20 ,.which.are.similar.to.existing.
41340 74 79 70 65 73 2c 20 62 75 74 20 62 65 68 61 76 65 20 64 69 66 66 65 72 65 6e 74 6c 79 20 69 6e types,.but.behave.differently.in
41360 20 73 6f 6d 65 20 72 65 73 70 65 63 74 73 2e 0a 0a 45 76 65 72 79 20 70 72 65 66 69 78 2c 20 69 .some.respects...Every.prefix,.i
41380 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 73 73 6f 63 nfix.and.suffix.command.is.assoc
413a0 69 61 74 65 64 20 77 69 74 68 20 61 6e 20 6f 62 6a 65 63 74 2c 0a 77 68 69 63 68 20 68 6f 6c 64 iated.with.an.object,.which.hold
413c0 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 77 68 69 63 68 20 63 6f 6e 74 72 6f 6c 73 20 63 65 s.information,.which.controls.ce
413e0 72 74 61 69 6e 20 61 73 70 65 63 74 73 20 6f 66 20 69 74 73 0a 62 65 68 61 76 69 6f 72 2e 20 20 rtain.aspects.of.its.behavior...
41400 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 6e 20 74 77 6f 20 77 61 79 73 2e 0a 0a 2d 20 41 73 73 This.happens.in.two.ways...-.Ass
41420 6f 63 69 61 74 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 20 63 65 72 74 61 69 ociating.a.command.with.a.certai
41440 6e 20 63 6c 61 73 73 20 67 69 76 65 73 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 20 74 79 70 65 n.class.gives.the.command.a.type
41460 2e 0a 20 20 54 68 69 73 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 75 73 ....This.makes.it.possible.to.us
41480 65 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 64 6f 20 63 65 72 74 61 69 e.generic.functions.to.do.certai
414a0 6e 20 74 68 69 6e 67 73 0a 20 20 74 68 61 74 20 68 61 76 65 20 74 6f 20 62 65 20 64 6f 6e 65 20 n.things...that.have.to.be.done.
414c0 64 69 66 66 65 72 65 6e 74 6c 79 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 61 74 20 74 79 differently.depending.on.what.ty
414e0 70 65 20 6f 66 20 63 6f 6d 6d 61 6e 64 0a 20 20 69 74 20 61 63 74 73 20 6f 6e 2e 0a 0a 20 20 54 pe.of.command...it.acts.on.....T
41500 68 61 74 20 69 6e 20 74 75 72 6e 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 66 6f hat.in.turn.makes.it.possible.fo
41520 72 20 74 68 69 72 64 2d 70 61 72 74 69 65 73 20 74 6f 20 61 64 64 20 6e 65 77 20 74 79 70 65 73 r.third-parties.to.add.new.types
41540 0a 20 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 63 6f 6e 76 69 6e 63 65 20 74 68 ...without.having.to.convince.th
41560 65 20 6d 61 69 6e 74 61 69 6e 65 72 20 6f 66 20 54 72 61 6e 73 69 65 6e 74 2c 20 74 68 61 74 20 e.maintainer.of.Transient,.that.
41580 74 68 61 74 0a 20 20 6e 65 77 20 74 79 70 65 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 65 6e 6f that...new.type.is.important.eno
415a0 75 67 68 20 74 6f 20 6a 75 73 74 69 66 79 20 61 64 64 69 6e 67 20 61 20 73 70 65 63 69 61 6c 20 ugh.to.justify.adding.a.special.
415c0 63 61 73 65 20 74 6f 20 61 0a 20 20 64 6f 7a 65 6e 20 6f 72 20 73 6f 20 66 75 6e 63 74 69 6f 6e case.to.a...dozen.or.so.function
415e0 73 2e 0a 0a 2d 20 41 73 73 6f 63 69 61 74 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 s...-.Associating.a.command.with
41600 20 61 6e 20 6f 62 6a 65 63 74 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 .an.object.makes.it.possible.to.
41620 65 61 73 69 6c 79 0a 20 20 73 74 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20 easily...store.information.that.
41640 69 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 74 68 61 74 20 70 61 72 74 69 63 75 6c 61 72 20 63 is.specific.to.that.particular.c
41660 6f 6d 6d 61 6e 64 2e 0a 0a 20 20 54 77 6f 20 63 6f 6d 6d 61 6e 64 73 20 6d 61 79 20 68 61 76 65 ommand.....Two.commands.may.have
41680 20 74 68 65 20 73 61 6d 65 20 74 79 70 65 2c 20 62 75 74 20 6f 62 76 69 6f 75 73 6c 79 20 74 68 .the.same.type,.but.obviously.th
416a0 65 69 72 20 6b 65 79 0a 20 20 62 69 6e 64 69 6e 67 73 20 61 6e 64 20 64 65 73 63 72 69 70 74 69 eir.key...bindings.and.descripti
416c0 6f 6e 73 20 73 74 69 6c 6c 20 68 61 76 65 20 74 6f 20 62 65 20 64 69 66 66 65 72 65 6e 74 2c 20 ons.still.have.to.be.different,.
416e0 66 6f 72 20 65 78 61 6d 70 6c 65 2e 0a 0a 20 20 54 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 6f for.example.....The.values.of.so
41700 6d 65 20 73 6c 6f 74 73 20 61 72 65 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20 7e 72 65 me.slots.are.functions...The.~re
41720 61 64 65 72 7e 20 73 6c 6f 74 20 66 6f 72 20 65 78 61 6d 70 6c 65 0a 20 20 68 6f 6c 64 73 20 61 ader~.slot.for.example...holds.a
41740 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 61 .function.that.is.used.to.read.a
41760 20 6e 65 77 20 76 61 6c 75 65 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 0a 20 20 63 6f 6d 6d 61 6e .new.value.for.an.infix...comman
41780 64 2e 20 20 54 68 65 20 76 61 6c 75 65 73 20 6f 66 20 73 75 63 68 20 73 6c 6f 74 73 20 61 72 65 d...The.values.of.such.slots.are
417a0 20 72 65 67 75 6c 61 72 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 0a 20 20 47 65 6e 65 72 69 63 20 66 .regular.functions.....Generic.f
417c0 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 77 68 65 6e 20 61 20 66 75 6e 63 74 69 6f unctions.are.used.when.a.functio
417e0 6e 20 73 68 6f 75 6c 64 20 64 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 64 69 66 66 65 72 65 6e n.should.do.something...differen
41800 74 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 t.based.on.the.type.of.the.comma
41820 6e 64 2c 20 69 2e 65 2e 2c 20 77 68 65 6e 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 6f 66 nd,.i.e.,.when.all.commands...of
41840 20 61 20 63 65 72 74 61 69 6e 20 74 79 70 65 20 73 68 6f 75 6c 64 20 62 65 68 61 76 65 20 74 68 .a.certain.type.should.behave.th
41860 65 20 73 61 6d 65 20 77 61 79 20 62 75 74 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 e.same.way.but.different.from.th
41880 65 0a 20 20 62 65 68 61 76 69 6f 72 20 66 6f 72 20 6f 74 68 65 72 20 74 79 70 65 73 2e 20 20 4f e...behavior.for.other.types...O
418a0 62 6a 65 63 74 20 73 6c 6f 74 73 20 74 68 61 74 20 68 6f 6c 64 20 61 20 72 65 67 75 6c 61 72 20 bject.slots.that.hold.a.regular.
418c0 66 75 6e 63 74 69 6f 6e 0a 20 20 61 73 20 76 61 6c 75 65 20 61 72 65 20 75 73 65 64 20 77 68 65 function...as.value.are.used.whe
418e0 6e 20 74 68 65 20 74 61 73 6b 20 74 68 61 74 20 74 68 65 79 20 70 65 72 66 6f 72 6d 20 69 73 20 n.the.task.that.they.perform.is.
41900 6c 69 6b 65 6c 79 20 74 6f 0a 20 20 64 69 66 66 65 72 20 65 76 65 6e 20 62 65 74 77 65 65 6e 20 likely.to...differ.even.between.
41920 64 69 66 66 65 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20 74 different.commands.of.the.same.t
41940 79 70 65 2e 0a 0a 2a 2a 20 47 72 6f 75 70 20 43 6c 61 73 73 65 73 0a 0a 54 68 65 20 74 79 70 65 ype...**.Group.Classes..The.type
41960 20 6f 66 20 61 20 67 72 6f 75 70 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20 75 73 69 .of.a.group.can.be.specified.usi
41980 6e 67 20 74 68 65 20 7e 3a 63 6c 61 73 73 7e 20 70 72 6f 70 65 72 74 79 20 61 74 20 74 68 65 0a ng.the.~:class~.property.at.the.
419a0 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 63 6c 61 73 73 20 73 70 65 63 69 66 69 63 61 beginning.of.the.class.specifica
419c0 74 69 6f 6e 2c 20 65 2e 67 2e 2c 20 7e 5b 3a 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 63 tion,.e.g.,.~[:class.transient-c
419e0 6f 6c 75 6d 6e 73 0a 2e 2e 2e 5d 7e 20 69 6e 20 61 20 63 61 6c 6c 20 74 6f 20 7e 74 72 61 6e 73 olumns....]~.in.a.call.to.~trans
41a00 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e 0a 0a 2d 20 54 68 65 20 61 62 73 74 ient-define-prefix~...-.The.abst
41a20 72 61 63 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 7e 20 63 6c 61 73 73 20 69 73 20 ract.~transient-child~.class.is.
41a40 74 68 65 20 62 61 73 65 20 63 6c 61 73 73 20 6f 66 20 62 6f 74 68 0a 20 20 7e 74 72 61 6e 73 69 the.base.class.of.both...~transi
41a60 65 6e 74 2d 67 72 6f 75 70 7e 20 28 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 61 6c 6c 20 67 72 ent-group~.(and.therefore.all.gr
41a80 6f 75 70 73 29 20 61 73 20 77 65 6c 6c 20 61 73 20 6f 66 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 oups).as.well.as.of...~transient
41aa0 2d 73 75 66 66 69 78 7e 20 28 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 61 6c 6c 20 73 75 66 66 -suffix~.(and.therefore.all.suff
41ac0 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 29 2e 0a 0a 20 20 54 68 69 73 20 ix.and.infix.commands).....This.
41ae0 63 6c 61 73 73 20 65 78 69 73 74 73 20 62 65 63 61 75 73 65 20 74 68 65 20 65 6c 65 6d 65 6e 74 class.exists.because.the.element
41b00 73 20 28 6f 72 20 e2 80 9c 63 68 69 6c 64 72 65 6e e2 80 9d 29 20 6f 66 20 63 65 72 74 61 69 6e s.(or....children...).of.certain
41b20 0a 20 20 67 72 6f 75 70 73 20 63 61 6e 20 62 65 20 6f 74 68 65 72 20 67 72 6f 75 70 73 20 69 6e ...groups.can.be.other.groups.in
41b40 73 74 65 61 64 20 6f 66 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e stead.of.suffix.and.infix.comman
41b60 64 73 2e 0a 0a 2d 20 54 68 65 20 61 62 73 74 72 61 63 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 67 ds...-.The.abstract.~transient-g
41b80 72 6f 75 70 7e 20 63 6c 61 73 73 20 69 73 20 74 68 65 20 73 75 70 65 72 63 6c 61 73 73 20 6f 66 roup~.class.is.the.superclass.of
41ba0 20 61 6c 6c 20 6f 74 68 65 72 0a 20 20 67 72 6f 75 70 20 63 6c 61 73 73 65 73 2e 0a 0a 2d 20 54 .all.other...group.classes...-.T
41bc0 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 7e 20 63 6c 61 73 73 20 69 73 20 74 he.~transient-column~.class.is.t
41be0 68 65 20 73 69 6d 70 6c 65 73 74 20 67 72 6f 75 70 2e 0a 0a 20 20 54 68 69 73 20 69 73 20 74 68 he.simplest.group.....This.is.th
41c00 65 20 64 65 66 61 75 6c 74 20 e2 80 9c 66 6c 61 74 e2 80 9d 20 67 72 6f 75 70 2e 20 20 49 66 20 e.default....flat....group...If.
41c20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 0a 20 20 65 78 70 the.class.is.not.specified...exp
41c40 6c 69 63 69 74 6c 79 20 61 6e 64 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 69 73 licitly.and.the.first.element.is
41c60 20 6e 6f 74 20 61 20 76 65 63 74 6f 72 20 28 69 2e 65 2e 2c 20 6e 6f 74 20 61 20 67 72 6f 75 70 .not.a.vector.(i.e.,.not.a.group
41c80 29 2c 0a 20 20 74 68 65 6e 20 74 68 69 73 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 2e 0a 0a 20 ),...then.this.class.is.used....
41ca0 20 54 68 69 73 20 63 6c 61 73 73 20 64 69 73 70 6c 61 79 73 20 65 61 63 68 20 65 6c 65 6d 65 6e .This.class.displays.each.elemen
41cc0 74 20 6f 6e 20 61 20 73 65 70 61 72 61 74 65 20 6c 69 6e 65 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 t.on.a.separate.line...-.The.~tr
41ce0 61 6e 73 69 65 6e 74 2d 72 6f 77 7e 20 63 6c 61 73 73 20 64 69 73 70 6c 61 79 73 20 61 6c 6c 20 ansient-row~.class.displays.all.
41d00 65 6c 65 6d 65 6e 74 73 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 6c 69 6e 65 2e 0a 0a 2d 20 54 68 elements.on.a.single.line...-.Th
41d20 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 7e 20 63 6c 61 73 73 20 64 69 73 70 e.~transient-columns~.class.disp
41d40 6c 61 79 73 20 63 6f 6d 6d 61 6e 64 73 20 6f 72 67 61 6e 69 7a 65 64 20 69 6e 20 63 6f 6c 75 6d lays.commands.organized.in.colum
41d60 6e 73 2e 0a 0a 20 20 44 69 72 65 63 74 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 ns.....Direct.elements.have.to.b
41d80 65 20 67 72 6f 75 70 73 20 77 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 e.groups.whose.elements.have.to.
41da0 62 65 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 6f 72 20 73 74 72 69 6e 67 73 2e 20 20 45 61 63 68 20 be.commands...or.strings...Each.
41dc0 73 75 62 67 72 6f 75 70 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 63 6f 6c 75 6d 6e 2e 20 20 54 subgroup.represents.a.column...T
41de0 68 69 73 20 63 6c 61 73 73 20 74 61 6b 65 73 0a 20 20 63 61 72 65 20 6f 66 20 69 6e 73 65 72 74 his.class.takes...care.of.insert
41e00 69 6e 67 20 74 68 65 20 73 75 62 67 72 6f 75 70 73 27 20 65 6c 65 6d 65 6e 74 73 2e 0a 0a 20 20 ing.the.subgroups'.elements.....
41e20 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 e2 80 9c 6e 65 73 74 65 64 e2 80 9d This.is.the.default....nested...
41e40 20 67 72 6f 75 70 2e 20 20 49 66 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 .group...If.the.class.is.not.spe
41e60 63 69 66 69 65 64 0a 20 20 65 78 70 6c 69 63 69 74 6c 79 20 61 6e 64 20 74 68 65 20 66 69 72 73 cified...explicitly.and.the.firs
41e80 74 20 65 6c 65 6d 65 6e 74 20 69 73 20 61 20 76 65 63 74 6f 72 20 28 69 2e 65 2e 2c 20 61 20 67 t.element.is.a.vector.(i.e.,.a.g
41ea0 72 6f 75 70 29 2c 20 74 68 65 6e 0a 20 20 74 68 69 73 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 roup),.then...this.class.is.used
41ec0 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 62 67 72 6f 75 70 73 7e 20 63 ...-.The.~transient-subgroups~.c
41ee0 6c 61 73 73 20 77 72 61 70 73 20 6f 74 68 65 72 20 67 72 6f 75 70 73 2e 0a 0a 20 20 44 69 72 65 lass.wraps.other.groups.....Dire
41f00 63 74 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 20 67 72 6f 75 70 73 20 77 68 ct.elements.have.to.be.groups.wh
41f20 6f 73 65 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 20 63 6f 6d 6d 61 6e 64 73 ose.elements.have.to.be.commands
41f40 0a 20 20 6f 72 20 73 74 72 69 6e 67 73 2e 20 20 54 68 69 73 20 67 72 6f 75 70 20 69 6e 73 65 72 ...or.strings...This.group.inser
41f60 74 73 20 61 6e 20 65 6d 70 74 79 20 6c 69 6e 65 20 62 65 74 77 65 65 6e 20 73 75 62 67 72 6f 75 ts.an.empty.line.between.subgrou
41f80 70 73 2e 0a 20 20 54 68 65 20 73 75 62 67 72 6f 75 70 73 20 74 68 65 6d 73 65 6c 76 65 73 20 61 ps....The.subgroups.themselves.a
41fa0 72 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 64 69 73 70 6c 61 79 69 6e 67 20 74 68 re.responsible.for.displaying.th
41fc0 65 69 72 0a 20 20 65 6c 65 6d 65 6e 74 73 2e 0a 0a 2a 2a 20 47 72 6f 75 70 20 4d 65 74 68 6f 64 eir...elements...**.Group.Method
41fe0 73 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 63 s..-.Function:.transient-setup-c
42000 68 69 6c 64 72 65 6e 20 67 72 6f 75 70 20 63 68 69 6c 64 72 65 6e 20 3a 3a 0a 0a 20 20 54 68 69 hildren.group.children.::....Thi
42020 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 s.generic.function.can.be.used.t
42040 6f 20 73 65 74 75 70 20 74 68 65 20 63 68 69 6c 64 72 65 6e 20 6f 72 20 61 20 67 72 6f 75 70 2e o.setup.the.children.or.a.group.
42060 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 75 ....The.default.implementation.u
42080 73 75 61 6c 6c 79 20 6a 75 73 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 63 68 69 6c 64 72 65 6e sually.just.returns.the.children
420a0 0a 20 20 75 6e 63 68 61 6e 67 65 64 2c 20 62 75 74 20 69 66 20 74 68 65 20 7e 73 65 74 75 70 2d ...unchanged,.but.if.the.~setup-
420c0 63 68 69 6c 64 72 65 6e 7e 20 73 6c 6f 74 20 6f 66 20 7b 7b 7b 76 61 72 28 47 52 4f 55 50 29 7d children~.slot.of.{{{var(GROUP)}
420e0 7d 7d 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 65 6e 0a 20 20 69 74 20 63 61 6c 6c 73 }}.is.non-~nil~,.then...it.calls
42100 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 7b 7b 7b 76 61 72 28 43 48 49 4c 44 .that.function.with.{{{var(CHILD
42120 52 45 4e 29 7d 7d 7d 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 REN)}}}.as.the.only.argument.and
42140 0a 20 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 2e 0a 0a 20 20 54 68 65 20 63 68 69 ...returns.the.value.....The.chi
42160 6c 64 72 65 6e 20 61 72 65 20 67 69 76 65 6e 20 61 73 20 61 20 28 70 6f 74 65 6e 74 69 61 6c 6c ldren.are.given.as.a.(potentiall
42180 79 20 65 6d 70 74 79 29 20 6c 69 73 74 20 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66 0a 20 20 65 69 y.empty).list.consisting.of...ei
421a0 74 68 65 72 20 67 72 6f 75 70 20 6f 72 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 ther.group.or.suffix.specificati
421c0 6f 6e 73 2e 20 20 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 6d 61 6b 65 0a 20 ons...These.functions.can.make..
421e0 20 61 72 62 69 74 72 61 72 79 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 63 68 69 6c 64 72 .arbitrary.changes.to.the.childr
42200 65 6e 20 69 6e 63 6c 75 64 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 69 6e 67 20 6e 65 77 0a 20 20 en.including.constructing.new...
42220 63 68 69 6c 64 72 65 6e 20 66 72 6f 6d 20 73 63 72 61 74 63 68 2e 0a 0a 2d 20 46 75 6e 63 74 69 children.from.scratch...-.Functi
42240 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 67 72 6f 75 on:.transient--insert-group.grou
42260 70 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 66 6f p.::....This.generic.function.fo
42280 72 6d 61 74 73 20 74 68 65 20 67 72 6f 75 70 20 61 6e 64 20 69 74 73 20 65 6c 65 6d 65 6e 74 73 rmats.the.group.and.its.elements
422a0 20 61 6e 64 20 69 6e 73 65 72 74 73 0a 20 20 74 68 65 20 72 65 73 75 6c 74 20 69 6e 74 6f 20 74 .and.inserts...the.result.into.t
422c0 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2c 20 77 68 69 63 68 20 69 73 20 61 20 74 65 he.current.buffer,.which.is.a.te
422e0 6d 70 6f 72 61 72 79 20 62 75 66 66 65 72 2e 0a 20 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f mporary.buffer....The.contents.o
42300 66 20 74 68 61 74 20 62 75 66 66 65 72 20 61 72 65 20 6c 61 74 65 72 20 69 6e 73 65 72 74 65 64 f.that.buffer.are.later.inserted
42320 20 69 6e 74 6f 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 20 20 46 75 6e 63 74 69 .into.the.menu.buffer.....Functi
42340 6f 6e 73 20 74 68 61 74 20 61 72 65 20 63 61 6c 6c 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 ons.that.are.called.by.this.func
42360 74 69 6f 6e 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 6f 70 65 72 61 74 65 20 69 6e 0a 20 20 74 68 tion.may.need.to.operate.in...th
42380 65 20 62 75 66 66 65 72 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 74 72 61 6e 73 69 65 6e e.buffer.from.which.the.transien
423a0 74 20 77 61 73 20 63 61 6c 6c 65 64 2e 20 20 54 6f 20 64 6f 20 73 6f 20 74 68 65 79 20 63 61 6e t.was.called...To.do.so.they.can
423c0 0a 20 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 6d 61 6b 65 20 74 68 65 20 7e 74 72 61 6e 73 69 65 ...temporarily.make.the.~transie
423e0 6e 74 2d 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 7e 20 74 68 65 20 63 75 72 72 65 6e 74 nt--shadowed-buffer~.the.current
42400 20 62 75 66 66 65 72 2e 0a 0a 2a 2a 20 50 72 65 66 69 78 20 43 6c 61 73 73 65 73 0a 0a 54 72 61 .buffer...**.Prefix.Classes..Tra
42420 6e 73 69 65 6e 74 20 69 74 73 65 6c 66 20 70 72 6f 76 69 64 65 73 20 61 20 73 69 6e 67 6c 65 20 nsient.itself.provides.a.single.
42440 63 6c 61 73 73 20 66 6f 72 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 0a 7e 74 72 61 6e class.for.prefix.commands,.~tran
42460 73 69 65 6e 74 2d 70 72 65 66 69 78 7e 2c 20 62 75 74 20 70 61 63 6b 61 67 65 20 61 75 74 68 6f sient-prefix~,.but.package.autho
42480 72 73 20 6d 61 79 20 77 69 73 68 20 74 6f 20 64 65 66 69 6e 65 20 73 70 65 63 69 61 6c 69 7a 65 rs.may.wish.to.define.specialize
424a0 64 0a 63 6c 61 73 73 65 73 2e 20 20 44 6f 69 6e 67 20 73 6f 20 6d 61 6b 65 73 20 69 74 20 70 6f d.classes...Doing.so.makes.it.po
424c0 73 73 69 62 6c 65 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 ssible.to.change.the.behavior.of
424e0 20 74 68 65 20 73 65 74 0a 6f 66 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 .the.set.of.prefix.commands.that
42500 20 75 73 65 20 74 68 61 74 20 63 6c 61 73 73 2c 20 62 79 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 .use.that.class,.by.implementing
42520 20 73 70 65 63 69 61 6c 69 7a 65 64 0a 6d 65 74 68 6f 64 73 20 66 6f 72 20 63 65 72 74 61 69 6e .specialized.methods.for.certain
42540 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 28 73 65 65 20 5b 5b 2a 20 50 72 65 66 .generic.functions.(see.[[*.Pref
42560 69 78 20 4d 65 74 68 6f 64 73 5d 5d 29 2e 0a 0a 41 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 ix.Methods]])...A.transient.pref
42580 69 78 20 63 6f 6d 6d 61 6e 64 27 73 20 6f 62 6a 65 63 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e ix.command's.object.is.stored.in
425a0 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 7e 0a 70 72 6f 70 65 72 74 .the.~transient--prefix~.propert
425c0 79 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 73 79 6d 62 6f 6c 2e 20 20 57 68 69 6c 65 20 y.of.the.command.symbol...While.
425e0 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 2c 20 61 20 63 6c 6f 6e 65 0a 6f a.transient.is.active,.a.clone.o
42600 66 20 74 68 61 74 20 6f 62 6a 65 63 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 76 f.that.object.is.stored.in.the.v
42620 61 72 69 61 62 6c 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 7e 2e 20 20 41 20 ariable.~transient--prefix~...A.
42640 63 6c 6f 6e 65 0a 69 73 20 75 73 65 64 20 62 65 63 61 75 73 65 20 73 6f 6d 65 20 63 68 61 6e 67 clone.is.used.because.some.chang
42660 65 73 20 74 68 61 74 20 61 72 65 20 6d 61 64 65 20 74 6f 20 74 68 65 20 61 63 74 69 76 65 20 74 es.that.are.made.to.the.active.t
42680 72 61 6e 73 69 65 6e 74 27 73 0a 6f 62 6a 65 63 74 20 73 68 6f 75 6c 64 20 6e 6f 74 20 61 66 66 ransient's.object.should.not.aff
426a0 65 63 74 20 6c 61 74 65 72 20 69 6e 76 6f 63 61 74 69 6f 6e 73 2e 0a 0a 2a 2a 20 53 75 66 66 69 ect.later.invocations...**.Suffi
426c0 78 20 43 6c 61 73 73 65 73 0a 0a 2d 20 41 6c 6c 20 73 75 66 66 69 78 20 61 6e 64 20 69 6e 66 69 x.Classes..-.All.suffix.and.infi
426e0 78 20 63 6c 61 73 73 65 73 20 64 65 72 69 76 65 20 66 72 6f 6d 20 7e 74 72 61 6e 73 69 65 6e 74 x.classes.derive.from.~transient
42700 2d 73 75 66 66 69 78 7e 2c 20 77 68 69 63 68 20 69 6e 0a 20 20 74 75 72 6e 20 64 65 72 69 76 65 -suffix~,.which.in...turn.derive
42720 73 20 66 72 6f 6d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 7e 2c 20 66 72 6f 6d 20 77 s.from.~transient-child~,.from.w
42740 68 69 63 68 20 7e 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 7e 20 61 6c 73 6f 0a 20 20 64 65 hich.~transient-group~.also...de
42760 72 69 76 65 73 20 28 73 65 65 20 5b 5b 2a 47 72 6f 75 70 20 43 6c 61 73 73 65 73 5d 5d 29 2e 0a rives.(see.[[*Group.Classes]])..
42780 0a 2d 20 41 6c 6c 20 69 6e 66 69 78 20 63 6c 61 73 73 65 73 20 64 65 72 69 76 65 20 66 72 6f 6d .-.All.infix.classes.derive.from
427a0 20 74 68 65 20 61 62 73 74 72 61 63 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 7e 20 .the.abstract.~transient-infix~.
427c0 63 6c 61 73 73 2c 0a 20 20 77 68 69 63 68 20 69 6e 20 74 75 72 6e 20 64 65 72 69 76 65 73 20 66 class,...which.in.turn.derives.f
427e0 72 6f 6d 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 63 6c 61 73 73 rom.the.~transient-suffix~.class
42800 2e 0a 0a 20 20 49 6e 66 69 78 65 73 20 61 72 65 20 61 20 73 70 65 63 69 61 6c 20 74 79 70 65 20 .....Infixes.are.a.special.type.
42820 6f 66 20 73 75 66 66 69 78 65 73 2e 20 20 54 68 65 20 70 72 69 6d 61 72 79 20 64 69 66 66 65 72 of.suffixes...The.primary.differ
42840 65 6e 63 65 20 69 73 0a 20 20 74 68 61 74 20 69 6e 66 69 78 65 73 20 61 6c 77 61 79 73 20 75 73 ence.is...that.infixes.always.us
42860 65 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 7e 20 70 72 65 2d 63 e.the.~transient--do-stay~.pre-c
42880 6f 6d 6d 61 6e 64 2c 20 77 68 69 6c 65 0a 20 20 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 ommand,.while...non-infix.suffix
428a0 65 73 20 75 73 65 20 61 20 76 61 72 69 65 74 79 20 6f 66 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 es.use.a.variety.of.pre-commands
428c0 20 28 73 65 65 20 5b 5b 2a 54 72 61 6e 73 69 65 6e 74 0a 20 20 53 74 61 74 65 5d 5d 29 2e 20 20 .(see.[[*Transient...State]])...
428e0 44 6f 69 6e 67 20 74 68 61 74 20 69 73 20 6d 6f 73 74 20 65 61 73 69 6c 79 20 61 63 68 69 65 76 Doing.that.is.most.easily.achiev
42900 65 64 20 62 79 20 75 73 69 6e 67 20 74 68 69 73 20 63 6c 61 73 73 2c 0a 20 20 74 68 6f 75 67 68 ed.by.using.this.class,...though
42920 20 74 68 65 6f 72 65 74 69 63 61 6c 6c 79 20 69 74 20 77 6f 75 6c 64 20 62 65 20 70 6f 73 73 69 .theoretically.it.would.be.possi
42940 62 6c 65 20 74 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 6e 66 69 78 20 63 6c 61 73 73 0a 20 20 74 ble.to.define.an.infix.class...t
42960 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 64 6f 20 73 6f 2e 20 20 49 66 20 79 6f 75 20 64 6f 20 74 hat.does.not.do.so...If.you.do.t
42980 68 61 74 20 74 68 65 6e 20 79 6f 75 20 67 65 74 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 6d 61 hat.then.you.get.to.implement.ma
429a0 6e 79 0a 20 20 6d 65 74 68 6f 64 73 2e 0a 0a 20 20 41 6c 73 6f 2c 20 69 6e 66 69 78 65 73 20 61 ny...methods.....Also,.infixes.a
429c0 6e 64 20 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 20 61 72 65 20 75 73 75 61 6c 6c nd.non-infix.suffixes.are.usuall
429e0 79 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 0a 20 20 64 69 66 66 65 72 65 6e 74 20 6d 61 63 72 y.defined.using...different.macr
42a00 6f 73 20 28 73 65 65 20 5b 5b 2a 44 65 66 69 6e 69 6e 67 20 53 75 66 66 69 78 20 61 6e 64 20 49 os.(see.[[*Defining.Suffix.and.I
42a20 6e 66 69 78 20 43 6f 6d 6d 61 6e 64 73 5d 5d 29 2e 0a 0a 2d 20 43 6c 61 73 73 65 73 20 75 73 65 nfix.Commands]])...-.Classes.use
42a40 64 20 66 6f 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 65 70 72 65 73 d.for.infix.commands.that.repres
42a60 65 6e 74 20 61 72 67 75 6d 65 6e 74 73 20 73 68 6f 75 6c 64 0a 20 20 62 65 20 64 65 72 69 76 65 ent.arguments.should...be.derive
42a80 64 20 66 72 6f 6d 20 74 68 65 20 61 62 73 74 72 61 63 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 d.from.the.abstract.~transient-a
42aa0 72 67 75 6d 65 6e 74 7e 20 63 6c 61 73 73 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e rgument~.class...-.The.~transien
42ac0 74 2d 73 77 69 74 63 68 7e 20 63 6c 61 73 73 20 28 6f 72 20 61 20 64 65 72 69 76 65 64 20 63 6c t-switch~.class.(or.a.derived.cl
42ae0 61 73 73 29 20 69 73 20 75 73 65 64 20 66 6f 72 20 69 6e 66 69 78 0a 20 20 61 72 67 75 6d 65 6e ass).is.used.for.infix...argumen
42b00 74 73 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 ts.that.represent.command-line.s
42b20 77 69 74 63 68 65 73 20 28 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 64 6f 0a 20 20 6e 6f 74 witches.(arguments.that.do...not
42b40 20 74 61 6b 65 20 61 20 76 61 6c 75 65 29 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e .take.a.value)...-.The.~transien
42b60 74 2d 6f 70 74 69 6f 6e 7e 20 63 6c 61 73 73 20 28 6f 72 20 61 20 64 65 72 69 76 65 64 20 63 6c t-option~.class.(or.a.derived.cl
42b80 61 73 73 29 20 69 73 20 75 73 65 64 20 66 6f 72 20 69 6e 66 69 78 0a 20 20 61 72 67 75 6d 65 6e ass).is.used.for.infix...argumen
42ba0 74 73 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f ts.that.represent.command-line.o
42bc0 70 74 69 6f 6e 73 20 28 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 64 6f 0a 20 20 74 61 6b 65 ptions.(arguments.that.do...take
42be0 20 61 20 76 61 6c 75 65 29 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 .a.value)...-.The.~transient-swi
42c00 74 63 68 65 73 7e 20 63 6c 61 73 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 61 20 73 tches~.class.can.be.used.for.a.s
42c20 65 74 20 6f 66 20 6d 75 74 75 61 6c 6c 79 0a 20 20 65 78 63 6c 75 73 69 76 65 20 63 6f 6d 6d 61 et.of.mutually...exclusive.comma
42c40 6e 64 2d 6c 69 6e 65 20 73 77 69 74 63 68 65 73 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 nd-line.switches...-.The.~transi
42c60 65 6e 74 2d 66 69 6c 65 73 7e 20 63 6c 61 73 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 ent-files~.class.can.be.used.for
42c80 20 61 20 3d 2d 2d 3d 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 0a 20 20 69 6e 64 69 63 61 74 65 .a.=--=.argument.that...indicate
42ca0 73 20 74 68 61 74 20 61 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 61 s.that.all.remaining.arguments.a
42cc0 72 65 20 66 69 6c 65 73 2e 0a 0a 2d 20 43 6c 61 73 73 65 73 20 75 73 65 64 20 66 6f 72 20 69 6e re.files...-.Classes.used.for.in
42ce0 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 20 76 61 72 69 fix.commands.that.represent.vari
42d00 61 62 6c 65 73 20 73 68 6f 75 6c 64 0a 20 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 74 68 65 20 ables.should...derived.from.the.
42d20 61 62 73 74 72 61 63 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 76 61 72 69 61 62 6c 65 7e 20 63 6c abstract.~transient-variable~.cl
42d40 61 73 73 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 ass...-.The.~transient-informati
42d60 6f 6e 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 2a 7e on~.and.~transient-information*~
42d80 20 63 6c 61 73 73 65 73 20 61 72 65 0a 20 20 73 70 65 63 69 61 6c 20 69 6e 20 74 68 61 74 20 73 .classes.are...special.in.that.s
42da0 75 66 66 69 78 65 73 20 74 68 61 74 20 75 73 65 20 74 68 65 73 65 20 63 6c 61 73 73 20 61 72 65 uffixes.that.use.these.class.are
42dc0 20 6e 6f 74 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 77 69 74 68 20 61 20 63 6f 6d 6d 61 6e 64 .not.associated...with.a.command
42de0 20 61 6e 64 20 74 68 75 73 20 61 6c 73 6f 20 6e 6f 74 20 77 69 74 68 20 61 6e 79 20 6b 65 79 20 .and.thus.also.not.with.any.key.
42e00 62 69 6e 64 69 6e 67 2e 20 20 53 75 63 68 0a 20 20 73 75 66 66 69 78 65 73 20 61 72 65 20 6f 6e binding...Such...suffixes.are.on
42e20 6c 79 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 61 72 62 69 74 72 61 72 79 20 69 6e 66 ly.used.to.display.arbitrary.inf
42e40 6f 72 6d 61 74 69 6f 6e 2c 20 61 6e 64 20 74 68 61 74 0a 20 20 61 6e 79 77 68 65 72 65 20 61 20 ormation,.and.that...anywhere.a.
42e60 73 75 66 66 69 78 20 63 61 6e 20 61 70 70 65 61 72 2e 20 20 44 69 73 70 6c 61 79 2d 6f 6e 6c 79 suffix.can.appear...Display-only
42e80 20 73 75 66 66 69 78 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 0a 20 20 74 61 6b 65 20 74 68 .suffix.specifications...take.th
42ea0 65 73 65 20 66 6f 72 6d 3a 0a 0a 20 20 23 2b 62 65 67 69 6e 5f 73 72 63 20 65 6d 61 63 73 2d 6c ese.form:....#+begin_src.emacs-l
42ec0 69 73 70 0a 20 20 20 20 28 3a 69 6e 66 6f 20 44 45 53 43 52 49 50 54 49 4f 4e 20 5b 4b 45 59 57 isp.....(:info.DESCRIPTION.[KEYW
42ee0 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 29 0a 20 20 20 20 28 3a 69 6e 66 6f 2a 20 44 45 53 43 52 ORD.VALUE]...).....(:info*.DESCR
42f00 49 50 54 49 4f 4e 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 29 0a 20 20 23 2b 65 IPTION.[KEYWORD.VALUE]...)...#+e
42f20 6e 64 5f 73 72 63 0a 0a 20 20 54 68 65 20 7e 3a 69 6e 66 6f 7e 20 61 6e 64 20 7e 3a 69 6e 66 6f nd_src....The.~:info~.and.~:info
42f40 2a 7e 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 73 20 72 65 70 6c 61 63 65 73 20 74 68 *~.keyword.arguments.replaces.th
42f60 65 20 7e 3a 64 65 73 63 72 69 70 74 69 6f 6e 7e 0a 20 20 6b 65 79 77 6f 72 64 20 75 73 65 64 20 e.~:description~...keyword.used.
42f80 66 6f 72 20 6f 74 68 65 72 20 73 75 66 66 69 78 20 63 6c 61 73 73 65 73 2e 20 20 4f 74 68 65 72 for.other.suffix.classes...Other
42fa0 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 0a 20 20 79 6f 75 20 6d 69 .keyword.arguments.that...you.mi
42fc0 67 68 74 20 77 61 6e 74 20 74 6f 20 73 65 74 2c 20 69 6e 63 6c 75 64 65 20 7e 3a 66 61 63 65 7e ght.want.to.set,.include.~:face~
42fe0 2c 20 70 72 65 64 69 63 61 74 65 20 6b 65 79 77 6f 72 64 73 20 28 73 75 63 68 20 61 73 0a 20 20 ,.predicate.keywords.(such.as...
43000 7e 3a 69 66 7e 20 61 6e 64 20 7e 3a 69 6e 61 70 74 2d 69 66 7e 29 2c 20 61 6e 64 20 7e 3a 66 6f ~:if~.and.~:inapt-if~),.and.~:fo
43020 72 6d 61 74 7e 2e 20 20 42 79 20 64 65 66 61 75 6c 74 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 rmat~...By.default.the.value.of.
43040 7e 3a 66 6f 72 6d 61 74 7e 0a 20 20 69 6e 63 6c 75 64 65 73 20 7e 25 6b 7e 2c 20 77 68 69 63 68 ~:format~...includes.~%k~,.which
43060 20 66 6f 72 20 74 68 69 73 20 63 6c 61 73 73 20 69 73 20 72 65 70 6c 61 63 65 64 20 77 69 74 68 .for.this.class.is.replaced.with
43080 20 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e 67 0a 20 20 6f 72 20 73 70 61 63 65 73 2c 20 69 .the.empty.string...or.spaces,.i
430a0 66 20 6b 65 79 73 20 61 72 65 20 62 65 69 6e 67 20 70 61 64 64 65 64 20 69 6e 20 74 68 65 20 63 f.keys.are.being.padded.in.the.c
430c0 6f 6e 74 61 69 6e 69 6e 67 20 67 72 6f 75 70 2e 0a 0a 20 20 54 68 65 20 6f 6e 6c 79 20 64 69 66 ontaining.group.....The.only.dif
430e0 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 6f 20 63 6c 61 73 73 65 ference.between.these.two.classe
43100 73 20 69 73 20 74 68 61 74 20 7e 3a 69 6e 66 6f 2a 7e 20 61 6c 69 67 6e 73 0a 20 20 69 74 73 20 s.is.that.~:info*~.aligns...its.
43120 64 65 73 63 72 69 70 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e description.with.the.description
43140 73 20 6f 66 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 6c 65 20 66 6f 72 0a s.of.suffix.commands,.while.for.
43160 20 20 7e 3a 69 6e 66 6f 7e 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 62 6c 65 65 64 73 ..~:info~.the.description.bleeds
43180 20 69 6e 74 6f 20 74 68 65 20 61 72 65 61 20 77 68 65 72 65 20 73 75 66 66 69 78 65 73 20 64 69 .into.the.area.where.suffixes.di
431a0 73 70 6c 61 79 0a 20 20 74 68 65 69 72 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2e 0a 0a 2d 20 54 splay...their.key.bindings...-.T
431c0 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 7e 20 63 6c 61 he.~transient-lisp-variable~.cla
431e0 73 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 68 6f 77 20 61 6e 64 20 63 68 61 6e 67 ss.can.be.used.to.show.and.chang
43200 65 20 74 68 65 0a 20 20 76 61 6c 75 65 20 6f 66 20 6c 69 73 70 20 76 61 72 69 61 62 6c 65 73 2e e.the...value.of.lisp.variables.
43220 20 20 54 68 69 73 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 66 75 6c 6c 79 20 66 65 61 74 75 72 ..This.class.is.not.fully.featur
43240 65 64 20 79 65 74 20 61 6e 64 0a 20 20 69 74 20 69 73 20 73 6f 6d 65 77 68 61 74 20 6c 69 6b 65 ed.yet.and...it.is.somewhat.like
43260 6c 79 20 74 68 61 74 20 66 75 74 75 72 65 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 6f 6e 27 ly.that.future.improvements.won'
43280 74 20 62 65 20 66 75 6c 6c 79 0a 20 20 62 61 63 6b 77 61 72 64 20 63 6f 6d 70 61 74 69 62 6c 65 t.be.fully...backward.compatible
432a0 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e 7e ...-.The.~transient-cons-option~
432c0 20 63 6c 61 73 73 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 73 69 74 75 61 74 69 6f 6e .class.is.intended.for.situation
432e0 73 20 77 68 65 72 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 20 73 68 6f 75 6c s.where...~transient-args~.shoul
43300 64 20 72 65 74 75 72 6e 20 61 6e 20 61 6c 69 73 74 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 61 20 d.return.an.alist,.instead.of.a.
43320 6c 69 73 74 20 6f 66 20 73 74 72 69 6e 67 73 0a 20 20 28 61 72 67 75 6d 65 6e 74 73 29 2e 20 20 list.of.strings...(arguments)...
43340 53 75 63 68 20 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20 69 Such.suffixes.can.be.specified.i
43360 6e 20 70 72 65 66 69 78 20 64 65 66 69 6e 69 74 69 6f 6e 73 0a 20 20 6c 69 6b 65 20 73 6f 3a 0a n.prefix.definitions...like.so:.
43380 0a 20 20 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 20 20 28 3a ...#+begin_src.emacs-lisp.....(:
433a0 63 6f 6e 73 20 4f 50 54 49 4f 4e 20 3a 6b 65 79 20 4b 45 59 20 5b 4b 45 59 57 4f 52 44 20 56 41 cons.OPTION.:key.KEY.[KEYWORD.VA
433c0 4c 55 45 5d 2e 2e 2e 29 0a 20 20 23 2b 65 6e 64 5f 73 72 63 0a 0a 20 20 4f 50 54 49 4f 4e 20 6d LUE]...)...#+end_src....OPTION.m
433e0 61 79 20 62 65 20 73 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 61 20 73 74 72 ay.be.something.other.than.a.str
43400 69 6e 67 2c 20 6c 69 6b 65 6c 79 20 61 20 6b 65 79 77 6f 72 64 20 6f 72 0a 20 20 73 6f 6d 65 20 ing,.likely.a.keyword.or...some.
43420 6f 74 68 65 72 20 73 79 6d 62 6f 6c 2c 20 69 74 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 other.symbol,.it.is.used.as.the.
43440 7e 63 61 72 7e 20 6f 66 20 74 68 65 20 63 6f 6e 73 2d 63 65 6c 6c 2e 20 20 57 68 65 6e 0a 20 20 ~car~.of.the.cons-cell...When...
43460 75 73 69 6e 67 20 73 75 63 68 20 61 6e 20 69 6e 6c 69 6e 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 using.such.an.inline.definition.
43480 7e 3a 6b 65 79 7e 20 68 61 73 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 2e 20 20 49 6e 20 ~:key~.has.to.be.specified...In.
434a0 6d 6f 73 74 0a 20 20 63 61 73 65 73 20 7e 3a 72 65 61 64 65 72 7e 20 73 68 6f 75 6c 64 20 61 6c most...cases.~:reader~.should.al
434c0 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 2e 20 20 57 68 65 6e 20 64 65 66 69 6e 69 6e 67 20 so.be.specified...When.defining.
434e0 73 75 63 68 20 61 20 73 75 66 66 69 78 0a 20 20 73 65 70 61 72 61 74 65 6c 79 2c 20 74 68 65 20 such.a.suffix...separately,.the.
43500 22 61 6c 69 73 74 20 6b 65 79 22 20 68 61 73 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 20 "alist.key".has.to.be.specified.
43520 75 73 69 6e 67 20 74 68 65 20 7e 3a 76 61 72 69 61 62 6c 65 7e 0a 20 20 6b 65 79 77 6f 72 64 20 using.the.~:variable~...keyword.
43540 61 72 67 75 6d 65 6e 74 2e 0a 0a 20 20 54 68 69 73 20 63 6c 61 73 73 20 69 73 20 73 74 69 6c 6c argument.....This.class.is.still
43560 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 69 74 20 69 73 20 73 6f 6d 65 77 68 61 74 20 6c 69 6b .experimental.it.is.somewhat.lik
43580 65 6c 79 20 74 68 61 74 20 66 75 74 75 72 65 0a 20 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 ely.that.future...improvements.w
435a0 6f 6e 27 74 20 62 65 20 66 75 6c 6c 79 20 62 61 63 6b 77 61 72 64 20 63 6f 6d 70 61 74 69 62 6c on't.be.fully.backward.compatibl
435c0 65 2e 0a 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 2d 74 61 e...-.The.~transient-describe-ta
435e0 72 67 65 74 7e 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 63 6f 6d 6d 61 rget~.class.is.used.by.the.comma
43600 6e 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 7e 2e 0a 0a 2d 20 54 68 nd...~transient-describe~...-.Th
43620 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 2d 70 72 65 73 65 74 7e 20 63 6c 61 73 73 e.~transient-value-preset~.class
43640 20 69 73 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 63 6f 6d 6d 61 6e .is.used.to.implement.the.comman
43660 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 73 65 74 7e 2c 20 77 68 69 63 68 20 61 63 d...~transient-preset~,.which.ac
43680 74 69 76 61 74 65 73 20 61 20 76 61 6c 75 65 20 70 72 65 73 65 74 2e 0a 0a 4d 61 67 69 74 20 64 tivates.a.value.preset...Magit.d
436a0 65 66 69 6e 65 73 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6c 61 73 73 65 73 2c 20 77 68 69 63 68 efines.additional.classes,.which
436c0 20 63 61 6e 20 73 65 72 76 65 20 61 73 20 65 78 61 6d 70 6c 65 73 20 66 6f 72 20 74 68 65 0a 66 .can.serve.as.examples.for.the.f
436e0 61 6e 63 79 20 74 68 69 6e 67 73 20 79 6f 75 20 63 61 6e 20 64 6f 20 77 69 74 68 6f 75 74 20 6d ancy.things.you.can.do.without.m
43700 6f 64 69 66 79 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 2e 20 20 53 6f 6d 65 20 6f 66 20 74 68 65 odifying.Transient...Some.of.the
43720 73 65 0a 63 6c 61 73 73 65 73 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20 67 65 74 20 67 65 6e 65 72 se.classes.will.likely.get.gener
43740 61 6c 69 7a 65 64 20 61 6e 64 20 61 64 64 65 64 20 74 6f 20 54 72 61 6e 73 69 65 6e 74 2e 20 20 alized.and.added.to.Transient...
43760 46 6f 72 20 6e 6f 77 0a 74 68 65 79 20 61 72 65 20 76 65 72 79 20 6d 75 63 68 20 73 75 62 6a 65 For.now.they.are.very.much.subje
43780 63 74 20 74 6f 20 63 68 61 6e 67 65 20 61 6e 64 20 6e 6f 74 20 64 6f 63 75 6d 65 6e 74 65 64 2e ct.to.change.and.not.documented.
437a0 0a 0a 2a 2a 20 50 72 65 66 69 78 20 4d 65 74 68 6f 64 73 0a 0a 54 6f 20 67 65 74 20 69 6e 66 6f ..**.Prefix.Methods..To.get.info
437c0 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 6d 65 74 68 6f 64 73 20 69 6d 70 6c 65 6d rmation.about.the.methods.implem
437e0 65 6e 74 69 6e 67 20 74 68 65 73 65 20 67 65 6e 65 72 69 63 0a 66 75 6e 63 74 69 6f 6e 73 20 75 enting.these.generic.functions.u
43800 73 65 20 7e 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 7e 2e 0a 0a 2d 20 46 75 6e 63 74 se.~describe-function~...-.Funct
43820 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 6f 62 6a 20 3a 3a ion:.transient-init-value.obj.::
43840 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 74 ....This.generic.function.sets.t
43860 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 20 7b he.initial.value.of.the.object.{
43880 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 20 20 4d 65 74 68 6f 64 73 20 65 78 69 73 74 20 66 {{var(OBJ)}}}....Methods.exist.f
438a0 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 or.both.prefix.and.suffix.object
438c0 73 2e 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 6d 65 74 68 6f 64 20 66 6f 72 20 70 72 65 s.....The.default.method.for.pre
438e0 66 69 78 20 6f 62 6a 65 63 74 73 20 73 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4f 42 fix.objects.sets.the.value.of.OB
43900 4a 27 73 20 7e 76 61 6c 75 65 7e 0a 20 20 73 6c 6f 74 20 74 6f 20 74 68 65 20 73 65 74 2c 20 73 J's.~value~...slot.to.the.set,.s
43920 61 76 65 64 20 6f 72 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 20 20 54 68 65 20 76 61 6c 75 aved.or.default.value...The.valu
43940 65 20 74 68 61 74 20 69 73 20 73 65 74 20 66 6f 72 0a 20 20 74 68 65 20 63 75 72 72 65 6e 74 20 e.that.is.set.for...the.current.
43960 73 65 73 73 69 6f 6e 20 69 73 20 70 72 65 66 65 72 72 65 64 20 6f 76 65 72 20 74 68 65 20 73 61 session.is.preferred.over.the.sa
43980 76 65 64 20 76 61 6c 75 65 2c 20 77 68 69 63 68 20 69 73 0a 20 20 70 72 65 66 65 72 72 65 64 20 ved.value,.which.is...preferred.
439a0 6f 76 65 72 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 0a 0a 20 20 54 68 65 20 64 over.the.default.value.....The.d
439c0 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 75 73 69 6e 67 efault.value.is.determined.using
439e0 20 74 68 65 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 0a 20 20 7e 74 72 61 6e 73 69 65 .the.generic.function...~transie
43a00 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 7e 2e 20 20 49 66 20 79 6f 75 20 6e 65 65 64 20 nt-default-value~...If.you.need.
43a20 74 6f 20 63 68 61 6e 67 65 20 68 6f 77 20 74 68 65 20 76 61 6c 75 65 20 66 6f 72 20 61 0a 20 20 to.change.how.the.value.for.a...
43a40 70 72 65 66 69 78 20 63 6c 61 73 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 2c 20 69 74 73 20 prefix.class.is.determined,.its.
43a60 75 73 75 61 6c 6c 79 20 73 75 66 66 69 63 69 65 6e 74 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 usually.sufficient.to.implement.
43a80 61 0a 20 20 6d 65 74 68 6f 64 20 66 6f 72 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 2d a...method.for.that.function...-
43aa0 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c .Function:.transient-default-val
43ac0 75 65 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 ue.obj.::....This.generic.functi
43ae0 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 on.returns.the.default.value.of.
43b00 74 68 65 20 6f 62 6a 65 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 20 20 4d 65 74 the.object.{{{var(OBJ)}}}....Met
43b20 68 6f 64 73 20 65 78 69 73 74 20 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 hods.exist.for.both.prefix.and.s
43b40 75 66 66 69 78 20 6f 62 6a 65 63 74 73 2e 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 6d 65 uffix.objects.....The.default.me
43b60 74 68 6f 64 20 66 6f 72 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 73 20 72 65 74 75 72 6e 73 20 thod.for.prefix.objects.returns.
43b80 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 0a 20 20 7e 64 65 66 61 75 6c 74 2d 76 61 6c 75 the.value.of.the...~default-valu
43ba0 65 7e 20 73 6c 6f 74 20 69 66 20 74 68 61 74 20 69 73 20 62 6f 75 6e 64 20 61 6e 64 20 6e 6f 74 e~.slot.if.that.is.bound.and.not
43bc0 20 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 66 20 69 74 20 69 73 20 61 0a 20 20 66 75 6e 63 74 .a.function...If.it.is.a...funct
43be0 69 6f 6e 2c 20 74 68 61 74 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 67 65 74 20 74 68 65 20 76 ion,.that.is.called.to.get.the.v
43c00 61 6c 75 65 2e 20 20 49 66 20 74 68 65 20 73 6c 6f 74 20 69 73 20 75 6e 62 6f 75 6e 64 2c 0a 20 alue...If.the.slot.is.unbound,..
43c20 20 7e 6e 69 6c 7e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a .~nil~.is.returned...-.Function:
43c40 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 65 20 6f 62 6a 20 3a 3a 0a 0a .transient-prefix-value.obj.::..
43c60 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 ..This.generic.function.returns.
43c80 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 20 7b the.value.of.the.prefix.object.{
43ca0 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 0a 20 20 4f 42 4a 20 69 73 20 61 20 70 72 6f 74 6f {{var(OBJ)}}}.....OBJ.is.a.proto
43cc0 74 79 70 65 20 6f 62 6a 65 63 74 20 61 6e 64 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f 20 type.object.and.is.only.used.to.
43ce0 73 65 6c 65 63 74 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 0a 20 20 6d 65 74 68 6f 64 20 select.the.appropriate...method.
43d00 6f 66 20 74 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 20 of.this.generic.function...This.
43d20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 74 68 65 0a 20 20 76 function.does.not.return.the...v
43d40 61 6c 75 65 20 6f 66 20 74 68 61 74 20 6f 62 6a 65 63 74 2e 20 20 49 6e 73 74 65 61 64 20 69 74 alue.of.that.object...Instead.it
43d60 20 65 78 74 72 61 63 74 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 72 65 73 70 65 63 .extracts.the.name.of.the.respec
43d80 74 69 76 65 0a 20 20 63 6f 6d 6d 61 6e 64 20 66 72 6f 6d 20 74 68 65 20 6f 62 6a 65 63 74 20 61 tive...command.from.the.object.a
43da0 6e 64 20 75 73 65 73 20 74 68 61 74 20 74 6f 20 63 6f 6c 6c 65 63 74 20 74 68 65 20 63 75 72 72 nd.uses.that.to.collect.the.curr
43dc0 65 6e 74 20 76 61 6c 75 65 73 0a 20 20 66 72 6f 6d 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f ent.values...from.the.suffixes.o
43de0 66 20 74 68 65 20 70 72 65 66 69 78 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 63 75 72 72 f.the.prefix.from.which.the.curr
43e00 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 0a 20 20 69 6e 76 6f 6b 65 64 2e 20 20 49 66 20 74 ent.command.was...invoked...If.t
43e20 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 6e 6f 74 20 69 6e 76 6f 6b he.current.command.was.not.invok
43e40 65 64 20 66 72 6f 6d 20 74 68 65 20 69 64 65 6e 74 69 66 69 65 64 0a 20 20 70 72 65 66 69 78 2c ed.from.the.identified...prefix,
43e60 20 74 68 65 6e 20 74 68 69 73 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 65 .then.this.method.returns.the.se
43e80 74 2c 20 73 61 76 65 20 6f 72 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2c 20 61 73 0a 20 20 64 t,.save.or.default.value,.as...d
43ea0 65 73 63 72 69 62 65 64 20 66 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 2e 0a 0a escribed.for.~transient-args~...
43ec0 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 69 6e 74 65 6e 64 65 64 ..This.function.is.only.intended
43ee0 20 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 2e .to.be.used.by.~transient-args~.
43f00 20 20 49 74 20 69 73 0a 20 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 61 73 20 61 6e 20 69 6e 74 65 ..It.is...not.defined.as.an.inte
43f20 72 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 62 65 63 61 75 73 65 20 74 68 69 72 64 2d 70 61 72 74 rnal.function.because.third-part
43f40 79 20 70 61 63 6b 61 67 65 73 20 6d 61 79 0a 20 20 64 65 66 69 6e 65 20 74 68 65 69 72 20 6f 77 y.packages.may...define.their.ow
43f60 6e 20 6d 65 74 68 6f 64 73 2e 20 20 54 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6d 65 61 6e 20 74 n.methods...That.does.not.mean.t
43f80 68 61 74 20 69 74 20 77 6f 75 6c 64 20 62 65 20 61 20 67 6f 6f 64 0a 20 20 69 64 65 61 20 74 6f hat.it.would.be.a.good...idea.to
43fa0 20 63 61 6c 6c 20 69 74 20 66 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 75 72 70 6f 73 65 2e 0a .call.it.for.any.other.purpose..
43fc0 0a 20 20 54 68 65 20 72 65 73 70 65 63 74 69 76 65 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 ...The.respective.generic.functi
43fe0 6f 6e 20 66 6f 72 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 20 on.for.infix.and.suffix.objects.
44000 69 73 0a 20 20 6e 61 6d 65 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 is...named.~transient-infix-valu
44020 65 7e 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d e~...-.Function:.transient-init-
44040 73 63 6f 70 65 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e scope.obj.::....This.generic.fun
44060 63 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 6f 62 6a 65 ction.sets.the.scope.of.the.obje
44080 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 20 20 4d 65 74 68 6f 64 73 0a 20 20 65 78 ct.{{{var(OBJ)}}}...Methods...ex
440a0 69 73 74 20 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 6f ist.for.both.prefix.and.suffix.o
440c0 62 6a 65 63 74 73 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c bjects.....This.function.is.call
440e0 65 64 20 66 6f 72 20 61 6c 6c 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d ed.for.all.prefix.and.suffix.com
44100 6d 61 6e 64 73 2c 20 62 75 74 0a 20 20 75 6e 6c 65 73 73 20 61 20 63 6f 6e 63 72 65 74 65 20 6d mands,.but...unless.a.concrete.m
44120 65 74 68 6f 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 74 68 69 73 20 66 61 6c 6c 73 20 ethod.is.implemented.this.falls.
44140 74 68 72 6f 75 67 68 20 74 6f 0a 20 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 through.to...the.default.impleme
44160 6e 74 61 74 69 6f 6e 2c 20 77 68 69 63 68 20 69 73 20 61 20 6e 6f 6f 70 2e 0a 0a 7e 74 72 61 6e ntation,.which.is.a.noop...~tran
44180 73 69 65 6e 74 2d 73 65 74 2d 76 61 6c 75 65 7e 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 sient-set-value~,.~transient-sav
441a0 65 2d 76 61 6c 75 65 7e 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 65 74 2d 76 61 6c 75 65 e-value~,.~transient-reset-value
441c0 7e 2c 0a 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 6b 65 79 7e 2c 20 7e 74 72 ~,.~transient--history-key~,.~tr
441e0 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 70 75 73 68 7e 20 61 6e 64 0a 7e 74 72 61 6e ansient--history-push~.and.~tran
44200 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 69 6e 69 74 7e 20 61 72 65 20 6f 74 68 65 72 20 67 sient--history-init~.are.other.g
44220 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 64 65 61 6c 69 6e 67 20 77 69 74 68 20 74 68 eneric.functions.dealing.with.th
44240 65 0a 76 61 6c 75 65 20 6f 66 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 73 2e 20 20 53 65 65 20 e.value.of.prefix.objects...See.
44260 74 68 65 69 72 20 64 6f 63 2d 73 74 72 69 6e 67 73 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 their.doc-strings.for.more.infor
44280 6d 61 74 69 6f 6e 2e 0a 0a 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 7e 20 69 mation...~transient-show-help~.i
442a0 73 20 61 6e 6f 74 68 65 72 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 69 6d 70 6c 65 s.another.generic.function.imple
442c0 6d 65 6e 74 65 64 20 66 6f 72 20 70 72 65 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 mented.for.prefix.commands...The
442e0 20 64 65 66 61 75 6c 74 20 6d 65 74 68 6f 64 20 65 66 66 65 63 74 69 76 65 6c 79 20 64 65 73 63 .default.method.effectively.desc
44300 72 69 62 65 73 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 0a 7e 64 65 73 63 72 69 62 ribes.the.command.using.~describ
44320 65 2d 66 75 6e 63 74 69 6f 6e 7e 2e 0a 0a 2a 2a 20 53 75 66 66 69 78 20 4d 65 74 68 6f 64 73 0a e-function~...**.Suffix.Methods.
44340 0a 54 6f 20 67 65 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 6d 65 .To.get.information.about.the.me
44360 74 68 6f 64 73 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 74 68 65 73 65 20 67 65 6e 65 72 69 63 thods.implementing.these.generic
44380 0a 66 75 6e 63 74 69 6f 6e 73 20 75 73 65 20 7e 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f .functions.use.~describe-functio
443a0 6e 7e 2e 0a 0a 2a 2a 2a 20 53 75 66 66 69 78 20 56 61 6c 75 65 20 4d 65 74 68 6f 64 73 0a 0a 2d n~...***.Suffix.Value.Methods..-
443c0 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 .Function:.transient-init-value.
443e0 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 obj.::....This.generic.function.
44400 73 65 74 73 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f 62 sets.the.initial.value.of.the.ob
44420 6a 65 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 20 20 4d 65 74 68 6f 64 73 20 65 ject.{{{var(OBJ)}}}....Methods.e
44440 78 69 73 74 20 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 xist.for.both.prefix.and.suffix.
44460 6f 62 6a 65 63 74 73 2e 0a 0a 20 20 46 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d objects.....For.~transient-argum
44480 65 6e 74 7e 20 6f 62 6a 65 63 74 73 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 68 61 6e 64 6c ent~.objects.this.function.handl
444a0 65 73 20 73 65 74 74 69 6e 67 20 74 68 65 0a 20 20 76 61 6c 75 65 20 62 79 20 69 74 73 65 6c 66 es.setting.the...value.by.itself
444c0 2e 0a 0a 20 20 46 6f 72 20 6f 74 68 65 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 .....For.other.~transient-suffix
444e0 7e 20 6f 62 6a 65 63 74 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d ~.objects.(including.~transient-
44500 69 6e 66 69 78 7e 0a 20 20 6f 62 6a 65 63 74 73 29 2c 20 74 68 69 73 20 63 61 6c 6c 73 20 7e 74 infix~...objects),.this.calls.~t
44520 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 7e 20 61 6e 64 20 75 73 65 73 ransient-default-value~.and.uses
44540 20 74 68 65 20 76 61 6c 75 65 0a 20 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 61 74 2c 20 75 .the.value...returned.by.that,.u
44560 6e 6c 65 73 73 20 69 74 20 69 73 20 74 68 65 20 73 70 65 63 69 61 6c 20 76 61 6c 75 65 20 7e 65 nless.it.is.the.special.value.~e
44580 69 65 69 6f 2d 2d 75 6e 62 6f 75 6e 64 7e 2c 0a 20 20 77 68 69 63 68 20 69 6e 64 69 63 61 74 65 ieio--unbound~,...which.indicate
445a0 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 s.that.there.is.no.default.value
445c0 2e 20 20 53 69 6e 63 65 20 74 68 61 74 20 69 73 20 77 68 61 74 0a 20 20 74 68 65 20 64 65 66 61 ...Since.that.is.what...the.defa
445e0 75 6c 74 20 6d 65 74 68 6f 64 20 66 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 ult.method.for.~transient-suffix
44600 7e 20 6f 62 6a 65 63 74 73 20 64 6f 65 73 2c 20 62 6f 74 68 20 6f 66 20 74 68 65 73 65 0a 20 20 ~.objects.does,.both.of.these...
44620 66 75 6e 63 74 69 6f 6e 73 20 65 66 66 65 63 74 69 76 65 6c 79 20 61 72 65 20 6e 6f 6f 70 73 20 functions.effectively.are.noops.
44640 66 6f 72 20 74 68 65 73 65 20 63 6c 61 73 73 65 73 2e 0a 0a 20 20 49 66 20 79 6f 75 20 69 6d 70 for.these.classes.....If.you.imp
44660 6c 65 6d 65 6e 74 20 61 20 63 6c 61 73 73 20 74 68 61 74 20 64 65 72 69 76 65 73 20 66 72 6f 6d lement.a.class.that.derives.from
44680 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 7e 20 64 69 72 65 63 74 6c 79 2c 0a 20 20 74 .~transient-infix~.directly,...t
446a0 68 65 6e 20 79 6f 75 20 6d 75 73 74 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 64 65 64 69 63 61 74 hen.you.must.implement.a.dedicat
446c0 65 64 20 6d 65 74 68 6f 64 20 66 6f 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 2f ed.method.for.this.function.and/
446e0 6f 72 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 7e 2e 0a or...~transient-default-value~..
44700 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 .-.Function:.transient-default-v
44720 61 6c 75 65 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 alue.obj.::....This.generic.func
44740 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f tion.returns.the.default.value.o
44760 66 20 74 68 65 20 6f 62 6a 65 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 20 20 4d f.the.object.{{{var(OBJ)}}}....M
44780 65 74 68 6f 64 73 20 65 78 69 73 74 20 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 ethods.exist.for.both.prefix.and
447a0 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 .suffix.objects...-.Function:.tr
447c0 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 ansient-infix-read.obj.::....Thi
447e0 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 64 65 74 65 72 6d 69 6e 65 73 20 74 68 s.generic.function.determines.th
44800 65 20 6e 65 77 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 0a e.new.value.of.the.infix.object.
44820 20 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 ..{{{var(OBJ)}}}.....This.functi
44840 6f 6e 20 6d 65 72 65 6c 79 20 64 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 76 61 6c 75 65 3b 20 on.merely.determines.the.value;.
44860 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 7e 20 69 73 0a 20 20 75 73 65 64 20 ~transient-infix-set~.is...used.
44880 74 6f 20 61 63 74 75 61 6c 6c 79 20 73 74 6f 72 65 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 to.actually.store.the.new.value.
448a0 69 6e 20 74 68 65 20 6f 62 6a 65 63 74 2e 0a 0a 20 20 46 6f 72 20 6d 6f 73 74 20 69 6e 66 69 78 in.the.object.....For.most.infix
448c0 20 63 6c 61 73 73 65 73 20 74 68 69 73 20 69 73 20 64 6f 6e 65 20 62 79 20 72 65 61 64 69 6e 67 .classes.this.is.done.by.reading
448e0 20 61 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 0a 20 20 75 73 65 72 20 75 73 69 6e 67 20 74 .a.value.from.the...user.using.t
44900 68 65 20 72 65 61 64 65 72 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 7e 72 65 61 64 he.reader.specified.by.the.~read
44920 65 72 7e 20 73 6c 6f 74 20 28 75 73 69 6e 67 20 74 68 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 er~.slot.(using.the...~transient
44940 2d 69 6e 66 69 78 2d 76 61 6c 75 65 7e 20 6d 65 74 68 6f 64 20 64 65 73 63 72 69 62 65 64 20 62 -infix-value~.method.described.b
44960 65 6c 6f 77 29 2e 0a 0a 20 20 46 6f 72 20 73 6f 6d 65 20 69 6e 66 69 78 20 63 6c 61 73 73 65 73 elow).....For.some.infix.classes
44980 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 63 68 61 6e 67 65 64 20 77 69 74 68 6f 75 74 20 72 65 .the.value.is.changed.without.re
449a0 61 64 69 6e 67 0a 20 20 61 6e 79 74 68 69 6e 67 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 ading...anything.in.the.minibuff
449c0 65 72 2c 20 69 2e 65 2e 2c 20 74 68 65 20 6d 65 72 65 20 61 63 74 20 6f 66 20 69 6e 76 6f 6b 69 er,.i.e.,.the.mere.act.of.invoki
449e0 6e 67 20 74 68 65 0a 20 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 64 65 74 65 72 6d 69 6e 65 ng.the...infix.command.determine
44a00 73 20 77 68 61 74 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 73 68 6f 75 6c 64 20 62 65 2c 20 s.what.the.new.value.should.be,.
44a20 62 61 73 65 64 0a 20 20 6f 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 2e 0a 0a based...on.the.previous.value...
44a40 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 6f 6d 70 74 20 6f 62 6a -.Function:.transient-prompt.obj
44a60 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 .::....This.generic.function.ret
44a80 75 72 6e 73 20 74 68 65 20 70 72 6f 6d 70 74 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 urns.the.prompt.to.be.used.to.re
44aa0 61 64 20 69 6e 66 69 78 0a 20 20 6f 62 6a 65 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d ad.infix...object.{{{var(OBJ)}}}
44ac0 27 73 20 76 61 6c 75 65 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 's.value...-.Function:.transient
44ae0 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 3a 3a 0a 0a 20 20 54 68 69 73 20 -infix-set.obj.value.::....This.
44b00 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 generic.function.sets.the.value.
44b20 6f 66 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 20 74 of.infix.object.{{{var(OBJ)}}}.t
44b40 6f 20 7b 7b 7b 76 61 72 28 56 41 4c 55 45 29 7d 7d 7d 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a o.{{{var(VALUE)}}}...-.Function:
44b60 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 6f 62 6a 20 3a 3a 0a 0a 20 .transient-infix-value.obj.::...
44b80 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 .This.generic.function.returns.t
44ba0 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 20 7b 7b he.value.of.the.suffix.object.{{
44bc0 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 {var(OBJ)}}}.....This.function.i
44be0 73 20 63 61 6c 6c 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 20 28 77 68 s.called.by.~transient-args~.(wh
44c00 69 63 68 20 73 65 65 29 2c 20 6d 65 61 6e 69 6e 67 20 74 68 69 73 0a 20 20 66 75 6e 63 74 69 6f ich.see),.meaning.this...functio
44c20 6e 20 69 73 20 68 6f 77 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e n.is.how.the.value.of.a.transien
44c40 74 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 0a 20 20 69 6e t.is.determined.so.that.the...in
44c60 76 6f 6b 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 75 73 65 20 69 74 2e voked.suffix.command.can.use.it.
44c80 0a 0a 20 20 43 75 72 72 65 6e 74 6c 79 20 6d 6f 73 74 20 76 61 6c 75 65 73 20 61 72 65 20 73 74 ....Currently.most.values.are.st
44ca0 72 69 6e 67 73 2c 20 62 75 74 20 74 68 61 74 20 69 73 20 6e 6f 74 20 73 65 74 20 69 6e 20 73 74 rings,.but.that.is.not.set.in.st
44cc0 6f 6e 65 2e 0a 20 20 7e 6e 69 6c 7e 20 69 73 20 6e 6f 74 20 61 20 76 61 6c 75 65 2c 20 69 74 20 one....~nil~.is.not.a.value,.it.
44ce0 6d 65 61 6e 73 20 e2 80 9c 6e 6f 20 76 61 6c 75 65 e2 80 9d 2e 0a 0a 20 20 55 73 75 61 6c 6c 79 means....no.value........Usually
44d00 20 6f 6e 6c 79 20 69 6e 66 69 78 65 73 20 68 61 76 65 20 61 20 76 61 6c 75 65 2c 20 62 75 74 20 .only.infixes.have.a.value,.but.
44d20 73 65 65 20 74 68 65 20 6d 65 74 68 6f 64 20 66 6f 72 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d see.the.method.for...~transient-
44d40 73 75 66 66 69 78 7e 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d suffix~...-.Function:.transient-
44d60 69 6e 69 74 2d 73 63 6f 70 65 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 init-scope.obj.::....This.generi
44d80 63 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 c.function.sets.the.scope.of.the
44da0 20 6f 62 6a 65 63 74 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 2e 20 20 4d 65 74 68 6f 64 73 .object.{{{var(OBJ)}}}...Methods
44dc0 0a 20 20 65 78 69 73 74 20 66 6f 72 20 62 6f 74 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 ...exist.for.both.prefix.and.suf
44de0 66 69 78 20 6f 62 6a 65 63 74 73 2e 0a 0a 20 20 54 68 65 20 73 63 6f 70 65 20 69 73 20 61 63 74 fix.objects.....The.scope.is.act
44e00 75 61 6c 6c 79 20 61 20 70 72 6f 70 65 72 74 79 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e ually.a.property.of.the.transien
44e20 74 20 70 72 65 66 69 78 2c 20 6e 6f 74 20 6f 66 0a 20 20 69 6e 64 69 76 69 64 75 61 6c 20 73 75 t.prefix,.not.of...individual.su
44e40 66 66 69 78 65 73 2e 20 20 48 6f 77 65 76 65 72 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 ffixes...However.it.is.possible.
44e60 74 6f 20 69 6e 76 6f 6b 65 20 61 20 73 75 66 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 20 64 69 72 to.invoke.a.suffix...command.dir
44e80 65 63 74 6c 79 20 69 6e 73 74 65 61 64 20 6f 66 20 66 72 6f 6d 20 61 20 74 72 61 6e 73 69 65 6e ectly.instead.of.from.a.transien
44ea0 74 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 69 66 0a 20 20 74 68 65 20 73 75 66 66 69 t...In.that.case,.if...the.suffi
44ec0 78 20 65 78 70 65 63 74 73 20 61 20 73 63 6f 70 65 2c 20 74 68 65 6e 20 69 74 20 68 61 73 20 74 x.expects.a.scope,.then.it.has.t
44ee0 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 61 74 20 69 74 73 65 6c 66 0a 20 20 61 6e 64 20 73 74 o.determine.that.itself...and.st
44f00 6f 72 65 20 69 74 20 69 6e 20 69 74 73 20 7e 73 63 6f 70 65 7e 20 73 6c 6f 74 2e 0a 0a 20 20 54 ore.it.in.its.~scope~.slot.....T
44f20 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 61 6c 6c 20 70 his.function.is.called.for.all.p
44f40 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 62 75 74 0a 20 refix.and.suffix.commands,.but..
44f60 20 75 6e 6c 65 73 73 20 61 20 63 6f 6e 63 72 65 74 65 20 6d 65 74 68 6f 64 20 69 73 20 69 6d 70 .unless.a.concrete.method.is.imp
44f80 6c 65 6d 65 6e 74 65 64 2c 20 74 68 69 73 20 66 61 6c 6c 73 20 74 68 72 6f 75 67 68 20 74 6f 0a lemented,.this.falls.through.to.
44fa0 20 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 77 68 ..the.default.implementation,.wh
44fc0 69 63 68 20 69 73 20 61 20 6e 6f 6f 70 2e 0a 0a 2a 2a 2a 20 53 75 66 66 69 78 20 46 6f 72 6d 61 ich.is.a.noop...***.Suffix.Forma
44fe0 74 20 4d 65 74 68 6f 64 73 0a 0a 23 20 4c 6f 77 2d 6c 65 76 65 6c 20 74 72 61 6e 73 69 65 6e 74 t.Methods..#.Low-level.transient
45000 2d 2d 69 6e 69 74 2d 73 75 66 66 69 78 2d 6b 65 79 20 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 20 --init-suffix-key.intentionally.
45020 6c 65 66 74 20 6f 75 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 left.out...-.Function:.transient
45040 2d 66 6f 72 6d 61 74 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 -format.obj.::....This.generic.f
45060 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 7b 7b 7b 76 unction.formats.and.returns.{{{v
45080 61 72 28 4f 42 4a 29 7d 7d 7d 20 66 6f 72 20 64 69 73 70 6c 61 79 2e 0a 0a 20 20 57 68 65 6e 20 ar(OBJ)}}}.for.display.....When.
450a0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 74 68 this.function.is.called,.then.th
450c0 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 20 69 73 20 73 6f 6d 65 0a 20 20 74 65 6d 70 6f e.current.buffer.is.some...tempo
450e0 72 61 72 79 20 62 75 66 66 65 72 2e 20 20 49 66 20 79 6f 75 20 6e 65 65 64 20 74 68 65 20 62 75 rary.buffer...If.you.need.the.bu
45100 66 66 65 72 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 70 72 65 66 69 78 0a 20 20 63 6f 6d ffer.from.which.the.prefix...com
45120 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 74 6f 20 62 65 20 63 75 72 72 65 6e 74 2c 20 mand.was.invoked.to.be.current,.
45140 74 68 65 6e 20 64 6f 20 73 6f 20 62 79 20 74 65 6d 70 6f 72 61 72 69 6c 79 0a 20 20 6d 61 6b 69 then.do.so.by.temporarily...maki
45160 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 73 6f 75 72 63 65 2d 62 75 66 66 65 72 7e 20 63 75 ng.~transient--source-buffer~.cu
45180 72 72 65 6e 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f rrent...-.Function:.transient-fo
451a0 72 6d 61 74 2d 6b 65 79 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 rmat-key.obj.::....This.generic.
451c0 66 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 27 function.formats.{{{var(OBJ)}}}'
451e0 73 20 7e 6b 65 79 7e 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 73 20 s.~key~.for.display.and.returns.
45200 74 68 65 0a 20 20 72 65 73 75 6c 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 the...result...-.Function:.trans
45220 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 62 6a 20 3a 3a 0a 0a ient-format-description.obj.::..
45240 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 ..This.generic.function.formats.
45260 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 27 73 20 7e 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 66 {{{var(OBJ)}}}'s.~description~.f
45280 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 0a 20 20 72 65 74 75 72 6e 73 20 74 68 65 20 72 65 73 or.display.and...returns.the.res
452a0 75 6c 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d ult...-.Function:.transient-form
452c0 61 74 2d 76 61 6c 75 65 20 6f 62 6a 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 20 at-value.obj.::....This.generic.
452e0 66 75 6e 63 74 69 6f 6e 20 66 6f 72 6d 61 74 73 20 7b 7b 7b 76 61 72 28 4f 42 4a 29 7d 7d 7d 27 function.formats.{{{var(OBJ)}}}'
45300 73 20 76 61 6c 75 65 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 73 0a s.value.for.display.and.returns.
45320 20 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 3a 20 74 72 61 6e 73 ..the.result...-.Function:.trans
45340 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 20 6f 62 6a 20 3a 3a 0a 0a 20 20 53 68 6f 77 20 68 65 ient-show-help.obj.::....Show.he
45360 6c 70 20 66 6f 72 20 74 68 65 20 70 72 65 66 69 78 2c 20 69 6e 66 69 78 20 6f 72 20 73 75 66 66 lp.for.the.prefix,.infix.or.suff
45380 69 78 20 63 6f 6d 6d 61 6e 64 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 0a 20 20 7b 7b 7b 76 ix.command.represented.by...{{{v
453a0 61 72 28 4f 42 4a 29 7d 7d 7d 2e 0a 0a 20 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 4f 42 4a ar(OBJ)}}}.....Regardless.of.OBJ
453c0 27 73 20 74 79 70 65 2c 20 69 66 20 69 74 73 20 7e 73 68 6f 77 2d 68 65 6c 70 7e 20 73 6c 6f 74 's.type,.if.its.~show-help~.slot
453e0 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 61 74 0a 20 20 6d 75 73 74 20 62 65 20 61 20 .is.non-~nil~,.that...must.be.a.
45400 66 75 6e 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 74 61 6b 65 73 20 4f 42 4a 20 69 73 20 69 74 73 function,.which.takes.OBJ.is.its
45420 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 74 20 6d 75 73 74 0a 20 20 70 72 65 70 61 .only.argument...It.must...prepa
45440 72 65 2c 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 62 75 66 66 65 72 2c re,.display.and.return.a.buffer,
45460 20 61 6e 64 20 73 65 6c 65 63 74 20 74 68 65 20 77 69 6e 64 6f 77 20 75 73 65 64 20 74 6f 0a 20 .and.select.the.window.used.to..
45480 20 64 69 73 70 6c 61 79 20 69 74 2e 20 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f .display.it...The.~transient-sho
454a0 77 2d 68 65 6c 70 2d 77 69 6e 64 6f 77 7e 20 6d 61 63 72 6f 20 69 73 20 69 6e 74 65 6e 64 65 64 w-help-window~.macro.is.intended
454c0 20 66 6f 72 0a 20 20 75 73 65 20 69 6e 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 0a 20 .for...use.in.such.functions....
454e0 20 46 6f 72 20 70 72 65 66 69 78 65 73 2c 20 73 68 6f 77 20 74 68 65 20 69 6e 66 6f 20 6d 61 6e .For.prefixes,.show.the.info.man
45500 75 61 6c 2c 20 69 66 20 74 68 61 74 20 69 73 20 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 ual,.if.that.is.specified.using.
45520 74 68 65 0a 20 20 7e 69 6e 66 6f 2d 6d 61 6e 75 61 6c 7e 20 73 6c 6f 74 2e 20 20 4f 74 68 65 72 the...~info-manual~.slot...Other
45540 77 69 73 65 2c 20 73 68 6f 77 20 74 68 65 20 6d 61 6e 70 61 67 65 20 69 66 20 74 68 61 74 20 69 wise,.show.the.manpage.if.that.i
45560 73 20 73 70 65 63 69 66 69 65 64 0a 20 20 75 73 69 6e 67 20 74 68 65 20 7e 6d 61 6e 2d 70 61 67 s.specified...using.the.~man-pag
45580 65 7e 20 73 6c 6f 74 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 73 68 6f 77 20 74 68 65 20 63 6f e~.slot...Otherwise,.show.the.co
455a0 6d 6d 61 6e 64 27 73 0a 20 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 2e 0a mmand's...documentation.string..
455c0 0a 20 20 46 6f 72 20 73 75 66 66 69 78 65 73 2c 20 73 68 6f 77 20 74 68 65 20 63 6f 6d 6d 61 6e ...For.suffixes,.show.the.comman
455e0 64 27 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 2e 0a 0a 20 20 46 6f 72 d's.documentation.string.....For
45600 20 69 6e 66 69 78 65 73 2c 20 73 68 6f 77 20 74 68 65 20 6d 61 6e 70 61 67 65 20 69 66 20 74 68 .infixes,.show.the.manpage.if.th
45620 61 74 20 69 73 20 73 70 65 63 69 66 69 65 64 2e 20 20 4f 74 68 65 72 77 69 73 65 20 73 68 6f 77 at.is.specified...Otherwise.show
45640 0a 20 20 74 68 65 20 63 6f 6d 6d 61 6e 64 27 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 ...the.command's.documentation.s
45660 74 72 69 6e 67 2e 0a 0a 2d 20 4d 61 63 72 6f 3a 20 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d tring...-.Macro:.transient-with-
45680 68 65 6c 70 2d 77 69 6e 64 6f 77 20 26 72 65 73 74 20 62 6f 64 79 20 3a 3a 0a 0a 20 20 45 76 61 help-window.&rest.body.::....Eva
456a0 6c 75 61 74 65 20 42 4f 44 59 2c 20 73 65 6e 64 20 6f 75 74 70 75 74 20 74 6f 20 7e 2a 48 65 6c luate.BODY,.send.output.to.~*Hel
456c0 70 2a 7e 20 62 75 66 66 65 72 2c 20 61 6e 64 20 64 69 73 70 6c 61 79 20 69 74 20 69 6e 20 61 0a p*~.buffer,.and.display.it.in.a.
456e0 20 20 77 69 6e 64 6f 77 2e 20 20 53 65 6c 65 63 74 20 74 68 65 20 68 65 6c 70 20 77 69 6e 64 6f ..window...Select.the.help.windo
45700 77 2c 20 61 6e 64 20 6d 61 6b 65 20 74 68 65 20 68 65 6c 70 20 62 75 66 66 65 72 20 63 75 72 72 w,.and.make.the.help.buffer.curr
45720 65 6e 74 0a 20 20 61 6e 64 20 72 65 74 75 72 6e 20 69 74 2e 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e ent...and.return.it...-.Function
45740 3a 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 72 79 20 6f 62 6a 20 26 6f 70 :.transient-show-summary.obj.&op
45760 74 69 6f 6e 61 6c 20 72 65 74 75 72 6e 20 3a 3a 0a 0a 20 20 54 68 69 73 20 67 65 6e 65 72 69 63 tional.return.::....This.generic
45780 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 77 73 20 6f 72 2c 20 69 66 20 6f 70 74 69 6f 6e 61 6c 20 .function.shows.or,.if.optional.
457a0 52 45 54 55 52 4e 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 0a 20 20 72 65 74 75 72 6e 73 20 61 RETURN.is.non-~nil~,...returns.a
457c0 20 62 72 69 65 66 20 73 75 6d 6d 61 72 79 20 61 62 6f 75 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 .brief.summary.about.the.command
457e0 20 61 74 20 70 6f 69 6e 74 20 6f 72 20 68 6f 76 65 72 65 64 20 77 69 74 68 0a 20 20 74 68 65 20 .at.point.or.hovered.with...the.
45800 6d 6f 75 73 65 2e 0a 0a 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 mouse.....This.function.is.calle
45820 64 20 77 68 65 6e 20 74 68 65 20 6d 6f 75 73 65 20 69 73 20 6d 6f 76 65 64 20 6f 76 65 72 20 61 d.when.the.mouse.is.moved.over.a
45840 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 20 20 28 69 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 .command.and...(if.the.value.of.
45860 7e 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 ~transient-enable-popup-navigati
45880 6f 6e 7e 20 69 73 20 7e 76 65 72 62 6f 73 65 7e 29 20 77 68 65 6e 0a 20 20 74 68 65 20 75 73 65 on~.is.~verbose~).when...the.use
458a0 72 20 6e 61 76 69 67 61 74 65 73 20 74 6f 20 61 20 63 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 20 74 r.navigates.to.a.command.using.t
458c0 68 65 20 6b 65 79 62 6f 61 72 64 2e 0a 0a 20 20 49 66 20 4f 42 4a 27 73 20 7e 73 75 6d 6d 61 72 he.keyboard.....If.OBJ's.~summar
458e0 79 7e 20 73 6c 6f 74 20 69 73 20 61 20 73 74 72 69 6e 67 2c 20 74 68 61 74 20 69 73 20 75 73 65 y~.slot.is.a.string,.that.is.use
45900 64 2e 20 20 49 66 20 7e 73 75 6d 6d 61 72 79 7e 20 69 73 20 61 0a 20 20 66 75 6e 63 74 69 6f 6e d...If.~summary~.is.a...function
45920 2c 20 74 68 61 74 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 4f 42 4a 20 61 73 20 74 68 65 ,.that.is.called.with.OBJ.as.the
45940 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 74 68 65 0a 20 20 72 65 74 75 72 6e 65 .only.argument.and.the...returne
45960 64 20 73 74 72 69 6e 67 20 69 73 20 75 73 65 64 2e 20 20 49 66 20 7e 73 75 6d 6d 61 72 79 7e 20 d.string.is.used...If.~summary~.
45980 69 73 20 6f 72 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 0a 20 20 is.or.returns.something.other...
459a0 74 68 61 6e 20 61 20 73 74 72 69 6e 67 20 6f 72 20 7e 6e 69 6c 7e 2c 20 6e 6f 20 73 75 6d 6d 61 than.a.string.or.~nil~,.no.summa
459c0 72 79 20 69 73 20 73 68 6f 77 6e 2e 20 20 49 66 20 7e 73 75 6d 6d 61 72 79 7e 20 69 73 20 6f 72 ry.is.shown...If.~summary~.is.or
459e0 20 72 65 74 75 72 6e 73 0a 20 20 7e 6e 69 6c 7e 2c 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 .returns...~nil~,.the.first.line
45a00 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 69 73 20 .of.the.documentation.string.is.
45a20 75 73 65 64 2c 20 69 66 20 61 6e 79 2e 0a 0a 20 20 49 66 20 52 45 54 55 52 4e 20 69 73 20 6e 6f used,.if.any.....If.RETURN.is.no
45a40 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 n-~nil~,.this.function.returns.t
45a60 68 65 20 73 75 6d 6d 61 72 79 20 69 6e 73 74 65 61 64 20 6f 66 0a 20 20 73 68 6f 77 69 6e 67 20 he.summary.instead.of...showing.
45a80 69 74 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 61 20 74 6f 6f 6c 74 69 70 it...This.is.used.when.a.tooltip
45aa0 20 69 73 20 6e 65 65 64 65 64 2e 0a 0a 2a 2a 20 50 72 65 66 69 78 20 53 6c 6f 74 73 0a 2a 2a 2a .is.needed...**.Prefix.Slots.***
45ac0 20 56 61 6c 75 65 20 61 6e 64 20 53 63 6f 70 65 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 .Value.and.Scope.:PROPERTIES:.:U
45ae0 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 7e 64 65 66 61 75 NNUMBERED:.notoc.:END:..-.~defau
45b00 6c 74 2d 76 61 6c 75 65 7e 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 74 lt-value~.The.default.value.of.t
45b20 68 65 20 70 72 65 66 69 78 2e 20 20 55 73 65 20 74 68 65 20 6b 65 79 77 6f 72 64 0a 20 20 61 72 he.prefix...Use.the.keyword...ar
45b40 67 75 6d 65 6e 74 20 7e 3a 76 61 6c 75 65 7e 20 28 73 69 63 29 20 74 6f 20 73 65 74 20 74 68 69 gument.~:value~.(sic).to.set.thi
45b60 73 20 73 6c 6f 74 20 69 6e 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 0a 20 20 s.slot.in.the.definition.of.a...
45b80 70 72 65 66 69 78 2e 0a 0a 2d 20 7e 69 6e 69 74 2d 76 61 6c 75 65 7e 20 41 20 66 75 6e 63 74 69 prefix...-.~init-value~.A.functi
45ba0 6f 6e 20 74 68 61 74 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 74 74 69 on.that.is.responsible.for.setti
45bc0 6e 67 20 74 68 65 20 6f 62 6a 65 63 74 27 73 0a 20 20 76 61 6c 75 65 2e 20 20 49 66 20 62 6f 75 ng.the.object's...value...If.bou
45be0 6e 64 2c 20 74 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 nd,.then.this.is.called.with.the
45c00 20 6f 62 6a 65 63 74 20 61 73 20 74 68 65 20 6f 6e 6c 79 0a 20 20 61 72 67 75 6d 65 6e 74 2e 20 .object.as.the.only...argument..
45c20 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73 20 6e 6f 74 20 62 6f 75 6e 64 2c 20 69 6e 20 77 .Usually.this.is.not.bound,.in.w
45c40 68 69 63 68 20 63 61 73 65 20 74 68 65 20 6f 62 6a 65 63 74 27 73 0a 20 20 70 72 69 6d 61 72 79 hich.case.the.object's...primary
45c60 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 7e 20 6d 65 74 68 6f 64 20 69 .~transient-init-value~.method.i
45c80 73 20 63 61 6c 6c 65 64 20 69 6e 73 74 65 61 64 2e 0a 0a 2d 20 7e 68 69 73 74 6f 72 79 2d 6b 65 s.called.instead...-.~history-ke
45ca0 79 7e 20 49 66 20 6d 75 6c 74 69 70 6c 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 73 y~.If.multiple.prefix.commands.s
45cc0 68 6f 75 6c 64 20 73 68 61 72 65 20 61 20 73 69 6e 67 6c 65 20 76 61 6c 75 65 2c 0a 20 20 74 68 hould.share.a.single.value,...th
45ce0 65 6e 20 74 68 69 73 20 73 6c 6f 74 20 68 61 73 20 74 6f 20 62 65 20 73 65 74 20 74 6f 20 74 68 en.this.slot.has.to.be.set.to.th
45d00 65 20 73 61 6d 65 20 76 61 6c 75 65 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 6d 2e 20 20 59 e.same.value.for.all.of.them...Y
45d20 6f 75 0a 20 20 70 72 6f 62 61 62 6c 79 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 68 61 74 2e 0a 0a ou...probably.don't.want.that...
45d40 2d 20 7e 72 65 6d 65 6d 62 65 72 2d 76 61 6c 75 65 7e 20 57 68 65 6e 20 61 20 73 75 66 66 69 78 -.~remember-value~.When.a.suffix
45d60 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 77 68 69 63 68 20 63 61 6e 20 63 .command.is.invoked,.which.can.c
45d80 6f 6e 73 75 6d 65 0a 20 20 74 68 65 20 70 72 65 66 69 78 27 73 20 76 61 6c 75 65 20 28 77 68 69 onsume...the.prefix's.value.(whi
45da0 63 68 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 73 75 66 66 69 78 20 73 6c 6f 74 20 7e 74 ch.depends.on.the.suffix.slot.~t
45dc0 72 61 6e 73 69 65 6e 74 7e 20 61 6e 64 0a 20 20 74 68 65 20 70 72 65 66 69 78 20 73 6c 6f 74 73 ransient~.and...the.prefix.slots
45de0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 .~transient-suffix~.and.~transie
45e00 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 7e 29 2c 20 74 68 65 6e 0a 20 20 74 68 65 20 76 61 6c 75 nt-non-suffix~),.then...the.valu
45e20 65 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 73 68 65 64 20 74 6f 20 74 68 65 e.is.automatically.pushed.to.the
45e40 20 70 72 65 66 69 78 27 73 20 76 61 6c 75 65 20 68 69 73 74 6f 72 79 2e 0a 0a 20 20 54 68 69 73 .prefix's.value.history.....This
45e60 20 73 6c 6f 74 20 61 6c 6c 6f 77 73 20 61 64 64 69 74 69 6f 6e 61 6c 6c 79 20 73 65 74 74 69 6e .slot.allows.additionally.settin
45e80 67 20 6f 72 20 65 76 65 6e 20 73 61 76 69 6e 67 20 74 68 65 20 76 61 6c 75 65 2c 20 73 6f 0a 20 g.or.even.saving.the.value,.so..
45ea0 20 74 68 61 74 20 69 74 20 62 65 63 6f 6d 65 73 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c .that.it.becomes.the.initial.val
45ec0 75 65 20 77 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 67 61 69 ue.when.the.menu.is.invoked.agai
45ee0 6e 2e 0a 0a 20 20 42 65 73 69 64 65 20 7e 6e 69 6c 7e 2c 20 74 68 65 20 76 61 6c 75 65 20 63 61 n.....Beside.~nil~,.the.value.ca
45f00 6e 20 62 65 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 73 79 6d 62 6f 6c 73 3a 0a 0a 20 20 2d 20 n.be.one.of.these.symbols:....-.
45f20 7e 65 78 70 6f 72 74 7e 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 77 68 65 6e 20 69 74 20 69 ~export~.Set.the.value.when.it.i
45f40 73 20 65 78 70 6f 72 74 65 64 2e 20 20 54 68 61 74 20 69 73 20 74 68 65 20 74 69 6d 65 20 77 68 s.exported...That.is.the.time.wh
45f60 65 6e 0a 20 20 20 20 74 68 65 20 76 61 6c 75 65 20 77 6f 75 6c 64 20 6f 72 64 69 6e 61 72 69 6c en.....the.value.would.ordinaril
45f80 79 20 6a 75 73 74 20 62 65 20 70 75 73 68 65 64 20 74 6f 20 74 68 65 20 68 69 73 74 6f 72 79 20 y.just.be.pushed.to.the.history.
45fa0 73 74 61 63 6b 2e 0a 0a 20 20 2d 20 7e 65 78 69 74 7e 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 stack.....-.~exit~.Set.the.value
45fc0 20 77 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 69 73 20 65 78 69 74 65 64 2c 20 65 78 63 65 70 74 .when.the.menu.is.exited,.except
45fe0 20 77 68 65 6e 20 74 68 61 74 20 69 73 0a 20 20 20 20 64 6f 6e 65 20 75 73 69 6e 67 20 61 20 63 .when.that.is.....done.using.a.c
46000 6f 6d 6d 61 6e 64 20 77 68 6f 73 65 20 73 6f 6c 65 20 70 75 72 70 6f 73 65 20 69 73 20 74 6f 20 ommand.whose.sole.purpose.is.to.
46020 71 75 69 74 20 74 68 65 20 6d 65 6e 75 2e 0a 0a 20 20 2d 20 7e 71 75 69 74 7e 20 53 65 74 20 74 quit.the.menu.....-.~quit~.Set.t
46040 68 65 20 76 61 6c 75 65 20 77 68 65 6e 20 74 68 65 20 6d 65 6e 75 20 69 73 20 71 75 69 74 2c 20 he.value.when.the.menu.is.quit,.
46060 75 73 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 77 68 6f 73 65 0a 20 20 20 20 73 6f 6c 65 20 70 using.a.command.whose.....sole.p
46080 75 72 70 6f 73 65 20 69 73 20 74 6f 20 64 6f 20 73 6f 2e 0a 0a 20 20 54 68 65 20 76 61 6c 75 65 urpose.is.to.do.so.....The.value
460a0 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 61 20 6c 69 73 74 20 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f .can.also.be.a.list.of.one.or.mo
460c0 72 65 20 6f 66 20 74 68 65 73 65 20 73 79 6d 62 6f 6c 73 20 61 6e 64 0a 20 20 6f 70 74 69 6f 6e re.of.these.symbols.and...option
460e0 61 6c 6c 79 20 61 6c 73 6f 20 74 68 65 20 73 79 6d 62 6f 6c 20 7e 73 61 76 65 7e 2e 0a 0a 20 20 ally.also.the.symbol.~save~.....
46100 2d 20 7e 73 61 76 65 7e 20 49 6e 73 74 65 61 64 20 6f 66 20 6d 65 72 65 6c 79 20 73 65 74 74 69 -.~save~.Instead.of.merely.setti
46120 6e 67 20 74 68 65 20 76 61 6c 75 65 2c 20 73 61 76 65 20 69 74 2c 20 73 6f 20 74 68 61 74 20 69 ng.the.value,.save.it,.so.that.i
46140 74 20 77 69 6c 6c 0a 20 20 20 20 62 65 20 75 73 65 64 20 69 6e 20 66 75 74 75 72 65 20 45 6d 61 t.will.....be.used.in.future.Ema
46160 63 73 20 73 65 73 73 69 6f 6e 73 2e 20 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 6f 74 68 65 72 cs.sessions...At.least.one.other
46180 20 73 79 6d 62 6f 6c 20 68 61 73 0a 20 20 20 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 67 65 74 .symbol.has.....to.be.used.toget
461a0 68 65 72 20 77 69 74 68 20 74 68 69 73 2e 0a 0a 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 her.with.this.....The.value.can.
461c0 61 6c 73 6f 20 62 65 20 61 20 28 71 75 6f 74 65 64 29 20 76 61 72 69 61 62 6c 65 2c 20 77 68 6f also.be.a.(quoted).variable,.who
461e0 73 65 20 76 61 6c 75 65 20 69 73 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 73 79 6d 62 6f 6c 73 20 se.value.is.a.list.of...symbols.
46200 61 73 20 64 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 2e 20 20 49 64 65 61 6c 6c 79 20 61 6e 20 as.described.above...Ideally.an.
46220 6f 70 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2c 20 73 69 6e 63 65 0a 20 20 6e option.should.be.used,.since...n
46240 6f 74 20 61 6c 6c 20 75 73 65 72 73 20 77 69 6c 6c 20 66 69 6e 64 20 74 68 65 20 61 75 74 6f 6d ot.all.users.will.find.the.autom
46260 61 74 69 63 20 73 61 76 69 6e 67 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 64 65 73 69 72 61 62 atic.saving.of.the.value.desirab
46280 6c 65 2e 0a 0a 2d 20 7e 69 6e 63 6f 6d 70 61 74 69 62 6c 65 7e 20 41 20 6c 69 73 74 20 6f 66 20 le...-.~incompatible~.A.list.of.
462a0 6c 69 73 74 73 2e 20 20 45 61 63 68 20 73 75 62 2d 6c 69 73 74 20 73 70 65 63 69 66 69 65 73 20 lists...Each.sub-list.specifies.
462c0 61 20 73 65 74 20 6f 66 0a 20 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 76 65 20 61 72 a.set.of...mutually.exclusive.ar
462e0 67 75 6d 65 6e 74 73 2e 20 20 45 6e 61 62 6c 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 guments...Enabling.one.of.these.
46300 61 72 67 75 6d 65 6e 74 73 0a 20 20 63 61 75 73 65 73 20 74 68 65 20 6f 74 68 65 72 73 20 74 6f arguments...causes.the.others.to
46320 20 62 65 20 64 69 73 61 62 6c 65 64 2e 20 20 41 6e 20 61 72 67 75 6d 65 6e 74 20 6d 61 79 20 61 .be.disabled...An.argument.may.a
46340 70 70 65 61 72 20 69 6e 0a 20 20 6d 75 6c 74 69 70 6c 65 20 73 75 62 2d 6c 69 73 74 73 2e 20 20 ppear.in...multiple.sub-lists...
46360 41 72 67 75 6d 65 6e 74 73 20 6d 75 73 74 20 6d 65 20 67 69 76 65 6e 20 69 6e 20 74 68 65 20 73 Arguments.must.me.given.in.the.s
46380 61 6d 65 20 66 6f 72 6d 20 61 73 0a 20 20 75 73 65 64 20 69 6e 20 74 68 65 20 7e 61 72 67 75 6d ame.form.as...used.in.the.~argum
463a0 65 6e 74 7e 20 6f 72 20 7e 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 7e 20 73 6c 6f 74 20 6f ent~.or.~argument-format~.slot.o
463c0 66 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 0a 20 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 f.the.respective...suffix.object
463e0 73 2c 20 75 73 75 61 6c 6c 79 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 7e 2d 2d 73 77 69 s,.usually.something.like.~--swi
46400 74 63 68 7e 20 6f 72 20 7e 2d 2d 6f 70 74 69 6f 6e 3d 25 73 7e 2e 20 20 46 6f 72 0a 20 20 6f 70 tch~.or.~--option=%s~...For...op
46420 74 69 6f 6e 73 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 7e 20 73 tions.and.~transient-switches~.s
46440 75 66 66 69 78 65 73 20 69 74 20 69 73 20 61 6c 73 6f 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6d uffixes.it.is.also.possible.to.m
46460 61 74 63 68 0a 20 20 61 67 61 69 6e 73 74 20 61 20 73 70 65 63 69 66 69 63 20 76 61 6c 75 65 2c atch...against.a.specific.value,
46480 20 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 .as.returned.by.~transient-infix
464a0 2d 76 61 6c 75 65 7e 2c 0a 20 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 7e 2d 2d 6f 70 74 69 6f -value~,...for.example,.~--optio
464c0 6e 3d 6f 6e 65 7e 2e 0a 0a 2d 20 7e 73 63 6f 70 65 7e 20 46 6f 72 20 73 6f 6d 65 20 74 72 61 6e n=one~...-.~scope~.For.some.tran
464e0 73 69 65 6e 74 73 20 69 74 20 6d 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 sients.it.might.be.necessary.to.
46500 68 61 76 65 20 61 20 73 6f 72 74 20 6f 66 0a 20 20 73 65 63 6f 6e 64 61 72 79 20 76 61 6c 75 65 have.a.sort.of...secondary.value
46520 2c 20 63 61 6c 6c 65 64 20 61 20 e2 80 9c 73 63 6f 70 65 e2 80 9d 2e 20 20 53 65 65 20 7e 74 72 ,.called.a....scope......See.~tr
46540 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e 0a 0a 2a 2a 2a 20 42 65 68 ansient-define-prefix~...***.Beh
46560 61 76 69 6f 72 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 avior.:PROPERTIES:.:UNNUMBERED:.
46580 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 notoc.:END:..-.~transient-suffix
465a0 7e 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 7e 20 61 6e 64 20 7e 74 ~,.~transient-non-suffix~.and.~t
465c0 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 7e 0a 20 20 70 6c 61 79 20 61 20 ransient-switch-frame~...play.a.
465e0 70 61 72 74 20 77 68 65 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 65 74 68 65 72 20 74 68 part.when.determining.whether.th
46600 65 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 70 e.currently.active.transient...p
46620 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 72 65 6d 61 69 6e 73 20 61 63 74 69 76 65 2f 74 72 61 refix.command.remains.active/tra
46640 6e 73 69 65 6e 74 20 77 68 65 6e 20 61 20 73 75 66 66 69 78 20 6f 72 20 61 72 62 69 74 72 61 72 nsient.when.a.suffix.or.arbitrar
46660 79 0a 20 20 6e 6f 6e 2d 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 y...non-suffix.command.is.invoke
46680 64 2e 20 20 53 65 65 20 5b 5b 2a 54 72 61 6e 73 69 65 6e 74 20 53 74 61 74 65 5d 5d 2e 0a 0a 2d d...See.[[*Transient.State]]...-
466a0 20 7e 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 7e 20 4e 6f 72 6d 61 6c 6c 79 20 73 75 66 .~refresh-suffixes~.Normally.suf
466c0 66 69 78 20 6f 62 6a 65 63 74 73 20 61 6e 64 20 6b 65 79 6d 61 70 73 20 61 72 65 20 6f 6e 6c 79 fix.objects.and.keymaps.are.only
466e0 20 73 65 74 75 70 0a 20 20 6f 6e 63 65 2c 20 77 68 65 6e 20 74 68 65 20 70 72 65 66 69 78 20 69 .setup...once,.when.the.prefix.i
46700 73 20 69 6e 76 6f 6b 65 64 2e 20 20 53 65 74 74 69 6e 67 20 74 68 69 73 20 74 6f 20 7e 74 7e 2c s.invoked...Setting.this.to.~t~,
46720 20 63 61 75 73 65 73 20 74 68 65 6d 20 74 6f 0a 20 20 62 65 20 72 65 63 72 65 61 74 65 64 20 61 .causes.them.to...be.recreated.a
46740 66 74 65 72 20 65 76 65 72 79 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 fter.every.command...This.is.use
46760 66 75 6c 20 77 68 65 6e 20 75 73 69 6e 67 20 7e 3a 69 66 2e 2e 2e 7e 0a 20 20 70 72 65 64 69 63 ful.when.using.~:if...~...predic
46780 61 74 65 73 2c 20 61 6e 64 20 74 68 6f 73 65 20 6e 65 65 64 20 74 6f 20 62 65 20 72 65 72 75 6e ates,.and.those.need.to.be.rerun
467a0 20 66 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2e 20 20 44 6f 69 6e 67 20 74 68 69 73 0a 20 20 .for.some.reason...Doing.this...
467c0 69 73 20 73 6f 6d 65 77 68 61 74 20 63 6f 73 74 6c 79 2c 20 61 6e 64 20 74 68 65 72 65 20 69 73 is.somewhat.costly,.and.there.is
467e0 20 61 20 72 69 73 6b 20 6f 66 20 6c 6f 73 69 6e 67 20 73 74 61 74 65 2c 20 73 6f 20 74 68 69 73 .a.risk.of.losing.state,.so.this
46800 20 69 73 0a 20 20 64 69 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 20 61 6e 64 20 73 74 .is...disabled.by.default.and.st
46820 69 6c 6c 20 63 6f 6e 73 69 64 65 72 65 64 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 2e 0a 0a 2d 20 ill.considered.experimental...-.
46840 7e 65 6e 76 69 72 6f 6e 6d 65 6e 74 7e 20 41 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f ~environment~.A.function.used.to
46860 20 65 73 74 61 62 6c 69 73 68 20 61 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 77 68 69 6c 65 0a .establish.an.environment.while.
46880 20 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 2c 20 72 65 66 72 65 73 68 69 6e 67 20 6f 72 20 72 65 ..initializing,.refreshing.or.re
468a0 64 69 73 70 6c 61 79 69 6e 67 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 6d 65 displaying.a.transient.prefix.me
468c0 6e 75 2e 0a 20 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 74 6f 20 65 73 74 61 62 6c 69 73 nu....This.is.useful.to.establis
468e0 68 20 61 20 63 61 63 68 65 2c 20 69 6e 20 63 61 73 65 20 6d 75 6c 74 69 70 6c 65 20 73 75 66 66 h.a.cache,.in.case.multiple.suff
46900 69 78 65 73 0a 20 20 72 65 71 75 69 72 65 20 74 68 65 20 73 61 6d 65 20 65 78 70 65 6e 73 69 76 ixes...require.the.same.expensiv
46920 65 20 77 6f 72 6b 2e 20 20 54 68 65 20 70 72 6f 76 69 64 65 64 20 66 75 6e 63 74 69 6f 6e 20 69 e.work...The.provided.function.i
46940 73 20 63 61 6c 6c 65 64 0a 20 20 77 69 74 68 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 61 72 67 s.called...with.at.least.one.arg
46960 75 6d 65 6e 74 2c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 77 68 69 63 68 20 69 74 ument,.the.function.for.which.it
46980 20 65 73 74 61 62 6c 69 73 68 65 73 0a 20 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 .establishes...the.environment..
469a0 20 49 74 20 6d 75 73 74 20 7e 66 75 6e 63 61 6c 6c 7e 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e .It.must.~funcall~.that.function
469c0 20 77 69 74 68 20 6e 6f 20 61 72 67 75 6d 65 6e 74 73 2e 0a 20 20 44 75 72 69 6e 67 20 69 6e 69 .with.no.arguments....During.ini
469e0 74 69 61 6c 69 7a 61 74 69 6f 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 tialization.the.second.argument.
46a00 69 73 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 0a 20 20 62 65 69 6e 67 20 69 6e 69 is.the.prefix.object...being.ini
46a20 74 69 61 6c 69 7a 65 64 2e 20 20 54 68 69 73 20 73 6c 6f 74 20 69 73 20 73 74 69 6c 6c 20 65 78 tialized...This.slot.is.still.ex
46a40 70 65 72 69 6d 65 6e 74 61 6c 2e 0a 0a 2a 2a 2a 20 41 70 70 65 61 72 61 6e 63 65 0a 3a 50 52 4f perimental...***.Appearance.:PRO
46a60 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 PERTIES:.:UNNUMBERED:.notoc.:END
46a80 3a 0a 0a 2d 20 7e 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 7e 20 64 65 74 65 72 6d 69 6e 65 73 :..-.~display-action~.determines
46aa0 20 68 6f 77 20 74 68 69 73 20 70 72 65 66 69 78 20 69 73 20 64 69 73 70 6c 61 79 65 64 2c 20 6f .how.this.prefix.is.displayed,.o
46ac0 76 65 72 72 69 64 69 6e 67 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 verriding...~transient-display-b
46ae0 75 66 66 65 72 2d 61 63 74 69 6f 6e 7e 2e 20 20 49 74 20 73 68 6f 75 6c 64 20 68 61 76 65 20 74 uffer-action~...It.should.have.t
46b00 68 65 20 73 61 6d 65 20 74 79 70 65 2e 0a 0a 2d 20 7e 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d he.same.type...-.~mode-line-form
46b20 61 74 7e 20 69 73 20 74 68 69 73 20 70 72 65 66 69 78 27 73 20 6d 6f 64 65 20 6c 69 6e 65 20 66 at~.is.this.prefix's.mode.line.f
46b40 6f 72 6d 61 74 2c 20 6f 76 65 72 72 69 64 69 6e 67 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6d ormat,.overriding...~transient-m
46b60 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 7e 2e 20 20 49 74 20 73 68 6f 75 6c 64 20 68 61 76 ode-line-format~...It.should.hav
46b80 65 20 74 68 65 20 73 61 6d 65 20 74 79 70 65 2e 0a 0a 2d 20 7e 63 6f 6c 75 6d 6e 2d 77 69 64 74 e.the.same.type...-.~column-widt
46ba0 68 73 7e 20 69 73 20 6f 6e 6c 79 20 72 65 73 70 65 63 74 65 64 20 69 6e 73 69 64 65 20 7e 74 72 hs~.is.only.respected.inside.~tr
46bc0 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 7e 20 67 72 6f 75 70 73 20 61 6e 64 0a 20 20 61 6c ansient-columns~.groups.and...al
46be0 6c 6f 77 73 20 61 6c 69 67 6e 69 6e 67 20 63 6f 6c 75 6d 6e 73 20 61 63 72 6f 73 73 20 73 65 70 lows.aligning.columns.across.sep
46c00 61 72 61 74 65 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 74 68 61 74 2e 20 20 41 20 6c 69 73 74 arate.instances.of.that...A.list
46c20 0a 20 20 6f 66 20 69 6e 74 65 67 65 72 73 2e 0a 0a 2d 20 7e 76 61 72 69 61 62 6c 65 2d 70 69 74 ...of.integers...-.~variable-pit
46c40 63 68 7e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 61 6c 69 67 6e 6d 65 6e 74 20 69 ch~.controls.whether.alignment.i
46c60 73 20 64 6f 6e 65 20 70 69 78 65 6c 2d 77 69 73 65 20 74 6f 0a 20 20 61 63 63 6f 75 6e 74 20 66 s.done.pixel-wise.to...account.f
46c80 6f 72 20 75 73 65 20 6f 66 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 63 68 61 72 61 63 74 or.use.of.variable-pitch.charact
46ca0 65 72 73 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 66 75 6c 2c 20 65 2e 67 2e 2c 0a 20 20 77 68 ers,.which.is.useful,.e.g.,...wh
46cc0 65 6e 20 75 73 69 6e 67 20 65 6d 6f 6a 69 2e 0a 0a 2a 2a 2a 20 44 6f 63 75 6d 65 6e 74 61 74 69 en.using.emoji...***.Documentati
46ce0 6f 6e 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 on.:PROPERTIES:.:UNNUMBERED:.not
46d00 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 7e 73 68 6f 77 2d 68 65 6c 70 7e 2c 20 7e 6d 61 6e 2d 70 61 oc.:END:..-.~show-help~,.~man-pa
46d20 67 65 7e 20 6f 72 20 7e 69 6e 66 6f 2d 6d 61 6e 75 61 6c 7e 20 63 61 6e 20 62 65 20 75 73 65 64 ge~.or.~info-manual~.can.be.used
46d40 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 0a 20 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 .to.specify.the...documentation.
46d60 66 6f 72 20 74 68 65 20 70 72 65 66 69 78 20 61 6e 64 20 69 74 73 20 73 75 66 66 69 78 65 73 2e for.the.prefix.and.its.suffixes.
46d80 20 20 54 68 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 7e ..The.command...~transient-help~
46da0 20 75 73 65 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 .uses.the.function.~transient-sh
46dc0 6f 77 2d 68 65 6c 70 7e 20 28 77 68 69 63 68 20 73 65 65 29 20 74 6f 0a 20 20 6c 6f 6f 6b 75 70 ow-help~.(which.see).to...lookup
46de0 20 61 6e 64 20 75 73 65 20 74 68 65 73 65 20 76 61 6c 75 65 73 2e 0a 0a 2d 20 7e 73 75 66 66 69 .and.use.these.values...-.~suffi
46e00 78 2d 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 70 x-description~.can.be.used.to.sp
46e20 65 63 69 66 79 20 61 20 66 75 6e 63 74 69 6f 6e 20 77 68 69 63 68 20 70 72 6f 76 69 64 65 73 0a ecify.a.function.which.provides.
46e40 20 20 66 61 6c 6c 62 61 63 6b 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 66 6f 72 20 73 75 66 66 ..fallback.descriptions.for.suff
46e60 69 78 65 73 20 74 68 61 74 20 6c 61 63 6b 20 61 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 20 20 54 ixes.that.lack.a.description...T
46e80 68 69 73 0a 20 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 74 65 6d 70 6f 72 61 72 his...is.intended.to.be.temporar
46ea0 69 6c 79 20 75 73 65 64 20 77 68 65 6e 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 6f 66 20 61 20 ily.used.when.implementing.of.a.
46ec0 6e 65 77 20 70 72 65 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 2c 20 61 74 20 77 68 69 63 68 20 74 new.prefix...command,.at.which.t
46ee0 69 6d 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 2d 73 75 6d 6d 61 72 79 2d 6f ime.~transient-command-summary-o
46f00 72 2d 6e 61 6d 65 7e 20 69 73 20 61 20 75 73 65 66 75 6c 0a 20 20 76 61 6c 75 65 2e 0a 0a 2a 2a r-name~.is.a.useful...value...**
46f20 2a 20 49 6e 74 65 72 6e 61 6c 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 *.Internal.:PROPERTIES:.:UNNUMBE
46f40 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 54 68 65 73 65 20 73 6c 6f 74 73 20 61 72 RED:.notoc.:END:..These.slots.ar
46f60 65 20 6d 6f 73 74 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20 75 e.mostly.intended.for.internal.u
46f80 73 65 2e 20 20 54 68 65 79 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 0a 73 65 74 20 69 6e 20 63 se...They.should.not.be.set.in.c
46fa0 61 6c 6c 73 20 74 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 alls.to.~transient-define-prefix
46fc0 7e 2e 0a 0a 2d 20 7e 70 72 6f 74 6f 74 79 70 65 7e 20 57 68 65 6e 20 61 20 74 72 61 6e 73 69 65 ~...-.~prototype~.When.a.transie
46fe0 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 nt.prefix.command.is.invoked,.th
47000 65 6e 20 61 20 63 6c 6f 6e 65 0a 20 20 6f 66 20 74 68 61 74 20 6f 62 6a 65 63 74 20 69 73 20 73 en.a.clone...of.that.object.is.s
47020 74 6f 72 65 64 20 69 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 7e 74 72 tored.in.the.global.variable.~tr
47040 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 7e 0a 20 20 61 6e 64 20 74 68 65 20 70 72 6f 74 6f ansient--prefix~...and.the.proto
47060 74 79 70 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 6e 65 27 73 20 7e 70 type.is.stored.in.the.clone's.~p
47080 72 6f 74 6f 74 79 70 65 7e 20 73 6c 6f 74 2e 0a 0a 2d 20 7e 63 6f 6d 6d 61 6e 64 7e 20 54 68 65 rototype~.slot...-.~command~.The
470a0 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 20 20 45 61 63 68 20 74 72 61 6e 73 69 .command,.a.symbol...Each.transi
470c0 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 63 6f 6e 73 69 73 74 73 20 6f 66 ent.prefix.command...consists.of
470e0 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 .a.command,.which.is.stored.in.a
47100 20 73 79 6d 62 6f 6c 27 73 20 66 75 6e 63 74 69 6f 6e 20 73 6c 6f 74 0a 20 20 61 6e 64 20 61 6e .symbol's.function.slot...and.an
47120 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 .object,.which.is.stored.in.the.
47140 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 7e 20 70 72 6f 70 65 72 74 79 0a 20 20 6f ~transient--prefix~.property...o
47160 66 20 74 68 65 20 73 61 6d 65 20 73 79 6d 62 6f 6c 2e 0a 0a 2d 20 7e 6c 65 76 65 6c 7e 20 54 68 f.the.same.symbol...-.~level~.Th
47180 65 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 e.level.of.the.prefix.commands..
471a0 20 54 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 77 68 6f 73 65 0a 20 20 6c 61 79 .The.suffix.commands.whose...lay
471c0 65 72 20 69 73 20 65 71 75 61 6c 20 6f 72 20 6c 6f 77 65 72 20 61 72 65 20 64 69 73 70 6c 61 79 er.is.equal.or.lower.are.display
471e0 65 64 2e 20 20 53 65 65 20 5b 5b 2a 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 ed...See.[[*Enabling.and.Disabli
47200 6e 67 0a 20 20 53 75 66 66 69 78 65 73 5d 5d 2e 0a 0a 2d 20 7e 76 61 6c 75 65 7e 20 54 68 65 20 ng...Suffixes]]...-.~value~.The.
47220 6c 69 6b 65 6c 79 20 6f 75 74 64 61 74 65 64 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 65 likely.outdated.value.of.the.pre
47240 66 69 78 2e 20 20 49 6e 73 74 65 61 64 20 6f 66 20 61 63 63 65 73 73 69 6e 67 0a 20 20 74 68 69 fix...Instead.of.accessing...thi
47260 73 20 73 6c 6f 74 20 64 69 72 65 63 74 6c 79 20 79 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 20 74 s.slot.directly.you.should.use.t
47280 68 65 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 he.function.~transient-get-value
472a0 7e 2c 0a 20 20 77 68 69 63 68 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20 72 65 74 75 ~,...which.is.guaranteed.to.retu
472c0 72 6e 20 74 68 65 20 75 70 2d 74 6f 2d 64 61 74 65 20 76 61 6c 75 65 2e 0a 0a 2d 20 7e 68 69 73 rn.the.up-to-date.value...-.~his
472e0 74 6f 72 79 7e 20 61 6e 64 20 7e 68 69 73 74 6f 72 79 2d 70 6f 73 7e 20 61 72 65 20 75 73 65 64 tory~.and.~history-pos~.are.used
47300 20 74 6f 20 6b 65 65 70 20 74 72 61 63 6b 20 6f 66 20 68 69 73 74 6f 72 69 63 20 76 61 6c 75 65 .to.keep.track.of.historic.value
47320 73 2e 0a 20 20 55 6e 6c 65 73 73 20 79 6f 75 20 69 6d 70 6c 65 6d 65 6e 74 20 79 6f 75 72 20 6f s....Unless.you.implement.your.o
47340 77 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 7e 20 6d 65 74 68 6f 64 wn.~transient-infix-read~.method
47360 20 79 6f 75 20 73 68 6f 75 6c 64 0a 20 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 64 65 61 6c 20 77 .you.should...not.have.to.deal.w
47380 69 74 68 20 74 68 65 73 65 20 73 6c 6f 74 73 2e 0a 0a 2d 20 7e 75 6e 77 69 6e 64 2d 73 75 66 66 ith.these.slots...-.~unwind-suff
473a0 69 78 7e 20 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f 20 65 6e 73 75 72 65 ix~.is.used.internally.to.ensure
473c0 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 69 73 0a 20 20 70 72 6f 70 65 72 6c 79 20 65 .transient.state.is...properly.e
473e0 78 69 74 65 64 2c 20 65 76 65 6e 20 69 6e 20 63 61 73 65 20 6f 66 20 61 6e 20 65 72 72 6f 72 2e xited,.even.in.case.of.an.error.
47400 0a 0a 2a 2a 20 53 75 66 66 69 78 20 53 6c 6f 74 73 0a 0a 48 65 72 65 20 77 65 20 64 6f 63 75 6d ..**.Suffix.Slots..Here.we.docum
47420 65 6e 74 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 73 6c 6f 74 73 20 74 68 61 74 20 61 72 65 20 6f ent.most.of.the.slots.that.are.o
47440 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 73 75 66 66 69 78 0a 6f 62 6a 65 63 74 73 nly.available.for.suffix.objects
47460 2e 20 20 53 6f 6d 65 20 73 6c 6f 74 73 20 61 72 65 20 73 68 61 72 65 64 20 62 79 20 73 75 66 66 ...Some.slots.are.shared.by.suff
47480 69 78 20 61 6e 64 20 67 72 6f 75 70 20 6f 62 6a 65 63 74 73 2c 20 74 68 65 79 20 61 72 65 0a 64 ix.and.group.objects,.they.are.d
474a0 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 5b 5b 2a 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 5d ocumented.in.[[*Predicate.Slots]
474c0 5d 2e 0a 0a 41 6c 73 6f 20 73 65 65 20 5b 5b 2a 53 75 66 66 69 78 20 43 6c 61 73 73 65 73 5d 5d ]...Also.see.[[*Suffix.Classes]]
474e0 2e 0a 0a 2a 2a 2a 20 53 6c 6f 74 73 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 ...***.Slots.of.~transient-child
47500 7e 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f ~.:PROPERTIES:.:UNNUMBERED:.noto
47520 63 0a 3a 45 4e 44 3a 0a 0a 54 68 69 73 20 69 73 20 74 68 65 20 61 62 73 74 72 61 63 74 20 73 75 c.:END:..This.is.the.abstract.su
47540 70 65 72 63 6c 61 73 73 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 61 perclass.of.~transient-suffix~.a
47560 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 7e 2e 0a 54 68 69 73 20 69 73 20 77 68 nd.~transient-group~..This.is.wh
47580 65 72 65 20 74 68 65 20 73 68 61 72 65 64 20 7e 69 66 2a 7e 20 61 6e 64 20 7e 69 6e 61 70 74 2d ere.the.shared.~if*~.and.~inapt-
475a0 69 66 2a 7e 20 73 6c 6f 74 73 20 28 73 65 65 20 5b 5b 2a 50 72 65 64 69 63 61 74 65 20 53 6c 6f if*~.slots.(see.[[*Predicate.Slo
475c0 74 73 5d 5d 29 2c 0a 74 68 65 20 7e 6c 65 76 65 6c 7e 20 73 6c 6f 74 20 28 73 65 65 20 5b 5b 2a ts]]),.the.~level~.slot.(see.[[*
475e0 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 5d Enabling.and.Disabling.Suffixes]
47600 5d 29 2c 20 61 6e 64 20 74 68 65 20 7e 61 64 76 69 63 65 7e 0a 61 6e 64 20 7e 61 64 76 69 63 65 ]),.and.the.~advice~.and.~advice
47620 2a 7e 20 73 6c 6f 74 73 20 28 73 65 65 20 5b 5b 2a 53 6c 6f 74 73 20 6f 66 20 7e 74 72 61 6e 73 *~.slots.(see.[[*Slots.of.~trans
47640 69 65 6e 74 2d 73 75 66 66 69 78 7e 5d 5d 29 20 61 72 65 20 64 65 66 69 6e 65 64 2e 0a 0a 2d 20 ient-suffix~]]).are.defined...-.
47660 7e 70 61 72 65 6e 74 7e 20 54 68 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 65 20 70 61 72 65 ~parent~.The.object.for.the.pare
47680 6e 74 20 67 72 6f 75 70 2e 0a 0a 2a 2a 2a 20 53 6c 6f 74 73 20 6f 66 20 7e 74 72 61 6e 73 69 65 nt.group...***.Slots.of.~transie
476a0 6e 74 2d 73 75 66 66 69 78 7e 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 nt-suffix~.:PROPERTIES:.:UNNUMBE
476c0 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 7e 6b 65 79 7e 20 69 73 20 74 68 65 RED:.notoc.:END:..-.~key~.is.the
476e0 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 61 20 73 74 72 69 6e 67 20 69 6e 20 74 68 65 20 66 6f .key.binding,.a.string.in.the.fo
47700 72 6d 61 74 20 72 65 74 75 72 6e 65 64 20 62 79 0a 20 20 7e 64 65 73 63 72 69 62 65 2d 6b 65 79 rmat.returned.by...~describe-key
47720 7e 20 61 6e 64 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 7e 6b 62 64 7e 2e 0a 0a 20 20 54 68 ~.and.understood.by.~kbd~.....Th
47740 61 74 20 66 6f 72 6d 61 74 20 69 73 20 6d 6f 72 65 20 70 65 72 6d 69 73 73 69 76 65 20 74 68 61 at.format.is.more.permissive.tha
47760 6e 20 74 68 65 20 6f 6e 65 20 61 63 63 65 70 74 65 64 20 62 79 20 7e 6b 65 79 2d 76 61 6c 69 64 n.the.one.accepted.by.~key-valid
47780 2d 70 7e 2e 0a 20 20 42 65 69 6e 67 20 6d 6f 72 65 20 70 65 72 6d 69 73 73 69 76 65 20 6d 61 6b -p~....Being.more.permissive.mak
477a0 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 es.it.possible,.for.example,.to.
477c0 77 72 69 74 65 20 74 68 65 0a 20 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 77 68 69 63 68 20 74 write.the...key.binding,.which.t
477e0 6f 67 67 6c 65 73 20 74 68 65 20 7e 2d 61 7e 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 72 67 oggles.the.~-a~.command.line.arg
47800 75 6d 65 6e 74 2c 20 61 73 20 22 2d 61 22 2c 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 68 61 76 ument,.as."-a",...instead.of.hav
47820 69 6e 67 20 74 6f 20 77 72 69 74 65 20 22 2d 20 61 22 2e 20 20 4c 69 6b 65 77 69 73 65 20 61 64 ing.to.write."-.a"...Likewise.ad
47840 64 69 74 69 6f 6e 61 6c 20 73 70 61 63 65 73 20 63 61 6e 20 62 65 0a 20 20 61 64 64 65 64 2c 20 ditional.spaces.can.be...added,.
47860 77 68 69 63 68 20 69 73 20 6e 6f 74 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 20 64 69 73 70 6c 61 which.is.not.removed.when.displa
47880 79 69 6e 67 20 74 68 65 20 62 69 6e 64 69 6e 67 20 69 6e 20 74 68 65 20 6d 65 6e 75 2c 0a 20 20 ying.the.binding.in.the.menu,...
478a0 77 68 69 63 68 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 61 6c 69 67 6e 6d 65 6e 74 20 70 75 which.is.useful.for.alignment.pu
478c0 72 70 6f 73 65 73 2e 0a 0a 2d 20 7e 63 6f 6d 6d 61 6e 64 7e 20 54 68 65 20 63 6f 6d 6d 61 6e 64 rposes...-.~command~.The.command
478e0 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 7e 20 57 68 65 74 68 ,.a.symbol...-.~transient~.Wheth
47900 65 72 20 74 6f 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 53 65 65 20 5b 5b 2a 54 72 er.to.stay.transient...See.[[*Tr
47920 61 6e 73 69 65 6e 74 20 53 74 61 74 65 5d 5d 2e 0a 0a 2d 20 7e 66 6f 72 6d 61 74 7e 20 54 68 65 ansient.State]]...-.~format~.The
47940 20 66 6f 72 6d 61 74 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 73 75 66 66 .format.used.to.display.the.suff
47960 69 78 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 20 20 49 74 20 6d 75 73 74 ix.in.the.menu.buffer....It.must
47980 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 25 2d 70 6c 61 63 65 68 6f .contain.the.following.%-placeho
479a0 6c 64 65 72 73 3a 0a 0a 20 20 2d 20 7e 25 6b 7e 20 46 6f 72 20 74 68 65 20 6b 65 79 2e 0a 20 20 lders:....-.~%k~.For.the.key....
479c0 2d 20 7e 25 64 7e 20 46 6f 72 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 0a 20 20 2d 20 -.~%d~.For.the.description....-.
479e0 7e 25 76 7e 20 46 6f 72 20 74 68 65 20 69 6e 66 69 78 20 76 61 6c 75 65 2e 20 20 4e 6f 6e 2d 69 ~%v~.For.the.infix.value...Non-i
47a00 6e 66 69 78 20 73 75 66 66 69 78 65 73 20 64 6f 6e 27 74 20 68 61 76 65 20 61 20 76 61 6c 75 65 nfix.suffixes.don't.have.a.value
47a20 2e 0a 0a 2d 20 7e 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 54 68 65 20 64 65 73 63 72 69 70 74 69 ...-.~description~.The.descripti
47a40 6f 6e 2c 20 65 69 74 68 65 72 20 61 20 73 74 72 69 6e 67 20 6f 72 20 61 20 66 75 6e 63 74 69 6f on,.either.a.string.or.a.functio
47a60 6e 2c 20 77 68 69 63 68 20 69 73 0a 20 20 63 61 6c 6c 65 64 20 77 69 74 68 20 7a 65 72 6f 20 6f n,.which.is...called.with.zero.o
47a80 72 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 20 28 74 68 65 20 73 75 66 66 69 78 20 6f 62 6a 65 63 r.one.argument.(the.suffix.objec
47aa0 74 29 2c 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 0a 20 20 73 74 72 69 6e 67 2e 0a 0a 2d 20 7e t),.and.returns.a...string...-.~
47ac0 66 61 63 65 7e 20 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 64 65 73 63 72 69 70 74 face~.Face.used.for.the.descript
47ae0 69 6f 6e 2e 20 20 49 6e 20 73 69 6d 70 6c 65 20 63 61 73 65 73 20 69 74 20 69 73 20 65 61 73 69 ion...In.simple.cases.it.is.easi
47b00 65 72 0a 20 20 74 6f 20 75 73 65 20 74 68 69 73 20 69 6e 73 74 65 61 64 20 6f 66 20 75 73 69 6e er...to.use.this.instead.of.usin
47b20 67 20 61 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 7e 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 61 6e g.a.function.as.~description~.an
47b40 64 20 61 64 64 69 6e 67 0a 20 20 74 68 65 20 73 74 79 6c 69 6e 67 20 74 68 65 72 65 2e 20 20 7e d.adding...the.styling.there...~
47b60 66 61 63 65 7e 20 69 73 20 61 70 70 65 6e 64 65 64 20 75 73 69 6e 67 20 7e 61 64 64 2d 66 61 63 face~.is.appended.using.~add-fac
47b80 65 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 7e 2e 0a 0a 2d 20 7e 73 68 6f 77 2d 68 65 6c 70 7e e-text-property~...-.~show-help~
47ba0 20 41 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 68 65 6c 70 .A.function.used.to.display.help
47bc0 20 66 6f 72 20 74 68 65 20 73 75 66 66 69 78 2e 20 20 49 66 0a 20 20 75 6e 73 70 65 63 69 66 69 .for.the.suffix...If...unspecifi
47be0 65 64 2c 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6e 74 72 6f 6c 73 20 68 6f 77 20 68 65 6c 70 ed,.the.prefix.controls.how.help
47c00 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 66 6f 72 20 69 74 73 0a 20 20 73 75 66 66 69 78 65 73 .is.displayed.for.its...suffixes
47c20 2e 20 20 53 65 65 20 61 6c 73 6f 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d ...See.also.function.~transient-
47c40 73 68 6f 77 2d 68 65 6c 70 7e 2e 0a 0a 2d 20 7e 73 75 6d 6d 61 72 79 7e 20 54 68 65 20 73 75 6d show-help~...-.~summary~.The.sum
47c60 6d 61 72 79 20 64 69 73 70 6c 61 79 65 64 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2c mary.displayed.in.the.echo.area,
47c80 20 6f 72 20 61 73 20 61 20 74 6f 6f 6c 74 69 70 2e 0a 20 20 49 66 20 74 68 69 73 20 69 73 20 7e .or.as.a.tooltip....If.this.is.~
47ca0 6e 69 6c 7e 2c 20 77 68 69 63 68 20 69 74 20 75 73 75 61 6c 6c 79 20 73 68 6f 75 6c 64 20 62 65 nil~,.which.it.usually.should.be
47cc0 2c 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 20 6f 66 20 74 68 65 0a 20 20 64 6f 63 75 6d 65 ,.the.first.line.of.the...docume
47ce0 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e 20 ntation.string.is.used.instead..
47d00 20 53 65 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 72 79 7e 0a 20 20 .See.~transient-show-summary~...
47d20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 0a 2d 20 7e 64 65 66 69 6e 69 74 69 6f 6e 7e 20 41 20 63 for.details...-.~definition~.A.c
47d40 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 64 20 69 66 20 74 68 65 20 62 6f 64 ommand,.which.is.used.if.the.bod
47d60 79 20 69 73 20 6f 6d 69 74 74 65 64 20 77 68 65 6e 0a 20 20 64 65 66 69 6e 69 6e 67 20 61 20 63 y.is.omitted.when...defining.a.c
47d80 6f 6d 6d 61 6e 64 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 ommand.using.~transient-define-s
47da0 75 66 66 69 78 7e 2e 0a 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 73 6c 6f 74 73 uffix~...The.following.two.slots
47dc0 20 61 72 65 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 2e 20 20 54 68 65 79 20 63 61 6e 20 61 6c 73 .are.experimental...They.can.als
47de0 6f 20 62 65 20 73 65 74 20 66 6f 72 20 61 0a 67 72 6f 75 70 2c 20 69 6e 20 77 68 69 63 68 20 63 o.be.set.for.a.group,.in.which.c
47e00 61 73 65 20 74 68 65 79 20 61 70 70 6c 79 20 74 6f 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 69 ase.they.apply.to.all.suffixes.i
47e20 6e 20 74 68 61 74 20 67 72 6f 75 70 2c 20 65 78 63 65 70 74 0a 66 6f 72 20 73 75 66 66 69 78 65 n.that.group,.except.for.suffixe
47e40 73 20 74 68 61 74 20 73 65 74 20 74 68 65 20 73 61 6d 65 20 73 6c 6f 74 20 74 6f 20 61 20 6e 6f s.that.set.the.same.slot.to.a.no
47e60 6e 2d 6e 69 6c 20 76 61 6c 75 65 2e 0a 0a 2d 20 7e 61 64 76 69 63 65 7e 20 41 20 66 75 6e 63 74 n-nil.value...-.~advice~.A.funct
47e80 69 6f 6e 20 75 73 65 64 20 74 6f 20 61 64 76 69 73 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 20 ion.used.to.advise.the.command..
47ea0 20 54 68 65 20 61 64 76 69 73 65 20 69 73 20 63 61 6c 6c 65 64 0a 20 20 75 73 69 6e 67 20 7e 28 .The.advise.is.called...using.~(
47ec0 61 70 70 6c 79 20 61 64 76 69 63 65 20 63 6f 6d 6d 61 6e 64 20 61 72 67 73 29 7e 2c 20 69 2e 65 apply.advice.command.args)~,.i.e
47ee0 2e 2c 20 69 74 20 62 65 68 61 76 65 73 20 6c 69 6b 65 20 61 6e 20 22 61 72 6f 75 6e 64 22 0a 20 .,.it.behaves.like.an."around"..
47f00 20 61 64 76 69 63 65 2e 0a 0a 2d 20 7e 61 64 76 69 63 65 2a 7e 20 41 20 66 75 6e 63 74 69 6f 6e .advice...-.~advice*~.A.function
47f20 20 75 73 65 64 20 74 6f 20 61 64 76 69 73 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 20 20 55 6e .used.to.advise.the.command...Un
47f40 6c 69 6b 65 20 7e 61 64 76 69 63 65 7e 2c 20 74 68 69 73 0a 20 20 61 64 76 69 73 65 73 20 6e 6f like.~advice~,.this...advises.no
47f60 74 20 6f 6e 6c 79 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 62 6f 64 79 20 62 75 74 20 61 6c 73 6f t.only.the.command.body.but.also
47f80 20 69 74 73 20 7e 69 6e 74 65 72 61 63 74 69 76 65 7e 20 73 70 65 63 2e 20 20 49 66 0a 20 20 62 .its.~interactive~.spec...If...b
47fa0 6f 74 68 20 73 6c 6f 74 73 20 61 72 65 20 6e 6f 6e 2d 6e 69 6c 2c 20 7e 61 64 76 69 63 65 7e 20 oth.slots.are.non-nil,.~advice~.
47fc0 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 62 6f 64 79 20 61 6e 64 20 7e 61 64 76 69 63 65 is.used.for.the.body.and.~advice
47fe0 2a 7e 20 69 73 0a 20 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 7e 69 6e 74 65 72 61 63 74 69 76 *~.is...used.for.the.~interactiv
48000 65 7e 20 66 6f 72 6d 2e 20 20 57 68 65 6e 20 61 64 76 69 73 69 6e 67 20 74 68 65 20 7e 69 6e 74 e~.form...When.advising.the.~int
48020 65 72 61 63 74 69 76 65 7e 20 73 70 65 63 2c 0a 20 20 63 61 6c 6c 65 64 20 75 73 69 6e 67 20 7e eractive~.spec,...called.using.~
48040 28 66 75 6e 63 61 6c 6c 20 61 64 76 69 63 65 20 23 27 61 64 76 69 63 65 2d 65 76 61 6c 2d 69 6e (funcall.advice.#'advice-eval-in
48060 74 65 72 61 63 74 69 76 65 2d 73 70 65 63 20 73 70 65 63 29 7e 2e 0a 0a 2a 2a 2a 20 53 6c 6f 74 teractive-spec.spec)~...***.Slot
48080 73 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 7e 0a 3a 50 52 4f 50 45 52 54 49 s.of.~transient-infix~.:PROPERTI
480a0 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 53 6f ES:.:UNNUMBERED:.notoc.:END:..So
480c0 6d 65 20 6f 66 20 74 68 65 73 65 20 73 6c 6f 74 73 20 61 72 65 20 6f 6e 6c 79 20 6d 65 61 6e 69 me.of.these.slots.are.only.meani
480e0 6e 67 66 75 6c 20 66 6f 72 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 73 75 62 63 6c 61 73 73 65 73 ngful.for.some.of.the.subclasses
48100 2e 0a 54 68 65 79 20 61 72 65 20 64 65 66 69 6e 65 64 20 68 65 72 65 20 61 6e 79 77 61 79 20 74 ..They.are.defined.here.anyway.t
48120 6f 20 61 6c 6c 6f 77 20 73 68 61 72 69 6e 67 20 63 65 72 74 61 69 6e 20 6d 65 74 68 6f 64 73 2e o.allow.sharing.certain.methods.
48140 0a 0a 2d 20 7e 61 72 67 75 6d 65 6e 74 7e 20 54 68 65 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 ..-.~argument~.The.long.argument
48160 2c 20 65 2e 67 2e 2c 20 7e 2d 2d 76 65 72 62 6f 73 65 7e 2e 0a 0a 2d 20 7e 73 68 6f 72 74 61 72 ,.e.g.,.~--verbose~...-.~shortar
48180 67 7e 20 54 68 65 20 73 68 6f 72 74 20 61 72 67 75 6d 65 6e 74 2c 20 65 2e 67 2e 2c 20 7e 2d 76 g~.The.short.argument,.e.g.,.~-v
481a0 7e 2e 0a 0a 2d 20 7e 76 61 6c 75 65 7e 20 54 68 65 20 76 61 6c 75 65 2e 20 20 53 68 6f 75 6c 64 ~...-.~value~.The.value...Should
481c0 20 6e 6f 74 20 62 65 20 61 63 63 65 73 73 65 64 20 64 69 72 65 63 74 6c 79 2e 0a 0a 2d 20 7e 69 .not.be.accessed.directly...-.~i
481e0 6e 69 74 2d 76 61 6c 75 65 7e 20 46 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 72 65 73 70 nit-value~.Function.that.is.resp
48200 6f 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 74 74 69 6e 67 20 74 68 65 20 6f 62 6a 65 63 74 27 73 onsible.for.setting.the.object's
48220 0a 20 20 76 61 6c 75 65 2e 20 20 49 66 20 62 6f 75 6e 64 2c 20 74 68 65 6e 20 74 68 69 73 20 69 ...value...If.bound,.then.this.i
48240 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 20 74 68 65 20 s.called.with.the.object.as.the.
48260 6f 6e 6c 79 0a 20 20 61 72 67 75 6d 65 6e 74 2e 20 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 only...argument...Usually.this.i
48280 73 20 6e 6f 74 20 62 6f 75 6e 64 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 6f s.not.bound,.in.which.case.the.o
482a0 62 6a 65 63 74 27 73 0a 20 20 70 72 69 6d 61 72 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 bject's...primary.~transient-ini
482c0 74 2d 76 61 6c 75 65 7e 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 73 74 65 61 t-value~.method.is.called.instea
482e0 64 2e 0a 0a 2d 20 7e 75 6e 73 61 76 61 62 6c 65 7e 20 57 68 65 74 68 65 72 20 74 68 65 20 76 61 d...-.~unsavable~.Whether.the.va
48300 6c 75 65 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 20 69 73 20 6e 6f 74 20 73 61 76 65 64 20 61 lue.of.the.suffix.is.not.saved.a
48320 73 20 70 61 72 74 20 6f 66 0a 20 20 74 68 65 20 70 72 65 66 69 78 65 73 2e 0a 0a 2d 20 7e 6d 75 s.part.of...the.prefixes...-.~mu
48340 6c 74 69 2d 76 61 6c 75 65 7e 20 46 6f 72 20 6f 70 74 69 6f 6e 73 2c 20 77 68 65 74 68 65 72 20 lti-value~.For.options,.whether.
48360 74 68 65 20 6f 70 74 69 6f 6e 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 70 6c 65 0a 20 20 76 the.option.can.have.multiple...v
48380 61 6c 75 65 73 2e 20 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2c 20 74 68 alues...If.this.is.non-~nil~,.th
483a0 65 6e 20 74 68 65 20 76 61 6c 75 65 73 20 61 72 65 20 72 65 61 64 20 75 73 69 6e 67 0a 20 20 7e en.the.values.are.read.using...~
483c0 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 2d 6d 75 6c 74 69 70 6c 65 7e 20 62 79 20 64 65 66 completing-read-multiple~.by.def
483e0 61 75 6c 74 20 61 6e 64 20 69 66 20 79 6f 75 20 73 70 65 63 69 66 79 20 79 6f 75 72 20 6f 77 6e ault.and.if.you.specify.your.own
48400 0a 20 20 72 65 61 64 65 72 2c 20 74 68 65 6e 20 69 74 20 73 68 6f 75 6c 64 20 72 65 61 64 20 74 ...reader,.then.it.should.read.t
48420 68 65 20 76 61 6c 75 65 73 20 75 73 69 6e 67 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 6f 72 he.values.using.that.function.or
48440 0a 20 20 73 69 6d 69 6c 61 72 2e 0a 0a 20 20 53 75 70 70 6f 72 74 65 64 20 6e 6f 6e 2d 7e 6e 69 ...similar.....Supported.non-~ni
48460 6c 7e 20 76 61 6c 75 65 73 20 61 72 65 3a 0a 0a 20 20 2d 20 55 73 65 20 7e 72 65 73 74 7e 20 66 l~.values.are:....-.Use.~rest~.f
48480 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 61 74 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 or.an.option.that.can.have.multi
484a0 70 6c 65 20 76 61 6c 75 65 73 2e 20 20 54 68 69 73 20 69 73 0a 20 20 20 20 75 73 65 66 75 6c 20 ple.values...This.is.....useful.
484c0 65 2e 67 2e 2c 20 66 6f 72 20 61 6e 20 7e 2d 2d 7e 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 20 e.g.,.for.an.~--~.argument.that.
484e0 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 61 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 0a 20 20 20 indicates.that.all.remaining....
48500 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 66 69 6c 65 73 20 28 73 75 63 68 20 61 73 20 7e 67 .arguments.are.files.(such.as.~g
48520 69 74 20 6c 6f 67 20 2d 2d 20 66 69 6c 65 31 20 66 69 6c 65 32 7e 29 2e 0a 0a 20 20 20 20 49 6e it.log.--.file1.file2~).......In
48540 20 74 68 65 20 6c 69 73 74 20 72 65 74 75 72 6e 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 .the.list.returned.by.~transient
48560 2d 61 72 67 73 7e 20 73 75 63 68 20 61 6e 20 6f 70 74 69 6f 6e 20 61 6e 64 20 69 74 73 0a 20 20 -args~.such.an.option.and.its...
48580 20 20 76 61 6c 75 65 73 20 61 72 65 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 20 61 20 73 69 ..values.are.represented.by.a.si
485a0 6e 67 6c 65 20 6c 69 73 74 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 7e 28 41 52 47 55 4d 45 4e 54 ngle.list.of.the.form.~(ARGUMENT
485c0 0a 20 20 20 20 2e 20 56 41 4c 55 45 53 29 7e 2e 0a 0a 20 20 2d 20 55 73 65 20 7e 72 65 70 65 61 .......VALUES)~.....-.Use.~repea
485e0 74 7e 20 66 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 61 74 20 63 61 6e 20 62 65 20 73 70 65 t~.for.an.option.that.can.be.spe
48600 63 69 66 69 65 64 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 2e 0a 0a 20 20 20 20 49 6e 20 74 cified.multiple.times.......In.t
48620 68 65 20 6c 69 73 74 20 72 65 74 75 72 6e 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 he.list.returned.by.~transient-a
48640 72 67 73 7e 20 65 61 63 68 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 6f 70 74 69 6f 6e rgs~.each.instance.of.the.option
48660 0a 20 20 20 20 61 6e 64 20 69 74 73 20 76 61 6c 75 65 20 61 70 70 65 61 72 73 20 73 65 70 61 72 .....and.its.value.appears.separ
48680 61 74 65 6c 79 20 69 6e 20 74 68 65 20 75 73 75 61 6c 20 66 72 6f 6d 2c 20 66 6f 72 20 65 78 61 ately.in.the.usual.from,.for.exa
486a0 6d 70 6c 65 3a 0a 20 20 20 20 7e 28 22 2d 2d 61 6e 6f 74 68 65 72 2d 61 72 67 75 6d 65 6e 74 22 mple:.....~("--another-argument"
486c0 20 22 2d 2d 6f 70 74 69 6f 6e 3d 66 69 72 73 74 22 20 22 2d 2d 6f 70 74 69 6f 6e 3d 73 65 63 6f ."--option=first"."--option=seco
486e0 6e 64 22 29 7e 2e 0a 0a 20 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73 20 74 68 65 20 6f 70 74 69 nd")~.....In.both.cases.the.opti
48700 6f 6e 27 73 20 76 61 6c 75 65 73 20 68 61 76 65 20 74 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 on's.values.have.to.be.specified
48720 20 69 6e 20 74 68 65 0a 20 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 61 20 70 72 65 .in.the...default.value.of.a.pre
48740 66 69 78 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 61 74 20 61 73 20 72 65 74 fix.using.the.same.format.as.ret
48760 75 72 6e 65 64 20 62 79 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 2c 20 65 2e 67 urned.by...~transient-args~,.e.g
48780 2e 2c 20 7e 28 22 2d 2d 6f 74 68 65 72 22 20 22 2d 2d 6f 3d 31 22 20 22 2d 2d 6f 3d 32 22 20 28 .,.~("--other"."--o=1"."--o=2".(
487a0 22 2d 2d 22 20 22 66 31 22 20 22 66 32 22 29 29 7e 2e 0a 0a 2d 20 7e 61 6c 77 61 79 73 2d 72 65 "--"."f1"."f2"))~...-.~always-re
487c0 61 64 7e 20 46 6f 72 20 6f 70 74 69 6f 6e 73 2c 20 77 68 65 74 68 65 72 20 74 6f 20 72 65 61 64 ad~.For.options,.whether.to.read
487e0 20 61 20 76 61 6c 75 65 20 6f 6e 20 65 76 65 72 79 20 69 6e 76 6f 63 61 74 69 6f 6e 2e 0a 20 20 .a.value.on.every.invocation....
48800 49 66 20 74 68 69 73 20 69 73 20 7e 6e 69 6c 7e 2c 20 74 68 65 6e 20 6f 70 74 69 6f 6e 73 20 74 If.this.is.~nil~,.then.options.t
48820 68 61 74 20 68 61 76 65 20 61 20 76 61 6c 75 65 20 61 72 65 20 73 69 6d 70 6c 79 20 75 6e 73 65 hat.have.a.value.are.simply.unse
48840 74 20 61 6e 64 0a 20 20 68 61 76 65 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 61 20 73 65 63 t.and...have.to.be.invoked.a.sec
48860 6f 6e 64 20 74 69 6d 65 20 74 6f 20 73 65 74 20 61 20 6e 65 77 20 76 61 6c 75 65 2e 0a 0a 2d 20 ond.time.to.set.a.new.value...-.
48880 7e 61 6c 6c 6f 77 2d 65 6d 70 74 79 7e 20 46 6f 72 20 6f 70 74 69 6f 6e 73 2c 20 77 68 65 74 68 ~allow-empty~.For.options,.wheth
488a0 65 72 20 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 69 73 20 61 20 76 61 6c 69 64 20 76 er.the.empty.string.is.a.valid.v
488c0 61 6c 75 65 2e 0a 0a 2d 20 7e 68 69 73 74 6f 72 79 2d 6b 65 79 7e 20 54 68 65 20 6b 65 79 20 75 alue...-.~history-key~.The.key.u
488e0 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 68 69 73 74 6f 72 79 2e 20 20 54 68 69 73 20 sed.to.store.the.history...This.
48900 64 65 66 61 75 6c 74 73 20 74 6f 20 74 68 65 0a 20 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d 65 2e 20 defaults.to.the...command.name..
48920 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 69 6e .This.is.useful.when.multiple.in
48940 66 69 78 65 73 20 73 68 6f 75 6c 64 20 73 68 61 72 65 20 74 68 65 0a 20 20 73 61 6d 65 20 68 69 fixes.should.share.the...same.hi
48960 73 74 6f 72 79 20 62 65 63 61 75 73 65 20 74 68 65 69 72 20 76 61 6c 75 65 73 20 61 72 65 20 6f story.because.their.values.are.o
48980 66 20 74 68 65 20 73 61 6d 65 20 6b 69 6e 64 2e 0a 0a 2d 20 7e 72 65 61 64 65 72 7e 20 54 68 65 f.the.same.kind...-.~reader~.The
489a0 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 74 68 65 20 76 61 6c 75 65 .function.used.to.read.the.value
489c0 20 6f 66 20 61 6e 20 69 6e 66 69 78 2e 20 20 4e 6f 74 20 75 73 65 64 0a 20 20 66 6f 72 20 73 77 .of.an.infix...Not.used...for.sw
489e0 69 74 63 68 65 73 2e 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 61 6b 65 73 20 74 68 72 65 itches...The.function.takes.thre
48a00 65 20 61 72 67 75 6d 65 6e 74 73 2c 20 7b 7b 7b 76 61 72 28 50 52 4f 4d 50 54 29 7d 7d 7d 2c 0a e.arguments,.{{{var(PROMPT)}}},.
48a20 20 20 7b 7b 7b 76 61 72 28 49 4e 49 54 49 41 4c 2d 49 4e 50 55 54 29 7d 7d 7d 20 61 6e 64 20 7b ..{{{var(INITIAL-INPUT)}}}.and.{
48a40 7b 7b 76 61 72 28 48 49 53 54 4f 52 59 29 7d 7d 7d 2c 20 61 6e 64 20 6d 75 73 74 20 72 65 74 75 {{var(HISTORY)}}},.and.must.retu
48a60 72 6e 20 61 20 73 74 72 69 6e 67 2e 0a 0a 2d 20 7e 70 72 6f 6d 70 74 7e 20 54 68 65 20 70 72 6f rn.a.string...-.~prompt~.The.pro
48a80 6d 70 74 20 75 73 65 64 20 77 68 65 6e 20 72 65 61 64 69 6e 67 20 74 68 65 20 76 61 6c 75 65 2c mpt.used.when.reading.the.value,
48aa0 20 65 69 74 68 65 72 20 61 20 73 74 72 69 6e 67 20 6f 72 20 61 0a 20 20 66 75 6e 63 74 69 6f 6e .either.a.string.or.a...function
48ac0 20 74 68 61 74 20 74 61 6b 65 73 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 20 74 68 65 20 6f 6e .that.takes.the.object.as.the.on
48ae0 6c 79 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 77 68 69 63 68 0a 20 20 72 65 74 75 72 6e 73 20 ly.argument.and.which...returns.
48b00 61 20 70 72 6f 6d 70 74 20 73 74 72 69 6e 67 2e 0a 0a 2d 20 7e 63 68 6f 69 63 65 73 7e 20 41 20 a.prompt.string...-.~choices~.A.
48b20 6c 69 73 74 20 6f 66 20 76 61 6c 69 64 20 76 61 6c 75 65 73 2c 20 6f 72 20 61 20 66 75 6e 63 74 list.of.valid.values,.or.a.funct
48b40 69 6f 6e 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 73 75 63 68 20 61 0a 20 20 6c 69 73 74 2e 20 ion.that.returns.such.a...list..
48b60 20 54 68 65 20 6c 61 74 74 65 72 20 69 73 20 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 66 .The.latter.is.not.implemented.f
48b80 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 7e 2c 20 62 65 63 61 75 73 65 or.~transient-switches~,.because
48ba0 0a 20 20 49 20 63 6f 75 6c 64 6e 27 74 20 74 68 69 6e 6b 20 6f 66 20 61 20 75 73 65 2d 63 61 73 ...I.couldn't.think.of.a.use-cas
48bc0 65 2e 20 20 48 6f 77 20 65 78 61 63 74 6c 79 20 74 68 65 20 63 68 6f 69 63 65 73 20 61 72 65 20 e...How.exactly.the.choices.are.
48be0 75 73 65 64 0a 20 20 76 61 72 69 65 73 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 63 used...varies.depending.on.the.c
48c00 6c 61 73 73 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 2e 0a 0a 2a 2a 2a 20 53 6c 6f 74 73 20 6f lass.of.the.suffix...***.Slots.o
48c20 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 76 61 72 69 61 62 6c 65 7e 0a 3a 50 52 4f 50 45 52 54 49 f.~transient-variable~.:PROPERTI
48c40 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 2d 20 ES:.:UNNUMBERED:.notoc.:END:..-.
48c60 7e 76 61 72 69 61 62 6c 65 7e 20 54 68 65 20 76 61 72 69 61 62 6c 65 2e 0a 0a 2a 2a 2a 20 53 6c ~variable~.The.variable...***.Sl
48c80 6f 74 73 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 7e 0a 3a 50 52 4f ots.of.~transient-switches~.:PRO
48ca0 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 PERTIES:.:UNNUMBERED:.notoc.:END
48cc0 3a 0a 0a 2d 20 7e 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 7e 20 54 68 65 20 64 69 73 70 6c :..-.~argument-format~.The.displ
48ce0 61 79 20 66 6f 72 6d 61 74 2e 20 20 4d 75 73 74 20 63 6f 6e 74 61 69 6e 20 7e 25 73 7e 2c 20 6f ay.format...Must.contain.~%s~,.o
48d00 6e 65 20 6f 66 20 74 68 65 0a 20 20 7e 63 68 6f 69 63 65 73 7e 20 69 73 20 73 75 62 73 74 69 74 ne.of.the...~choices~.is.substit
48d20 75 74 65 64 20 66 6f 72 20 74 68 61 74 2e 20 20 45 2e 67 2e 2c 20 7e 2d 2d 25 73 2d 6f 72 64 65 uted.for.that...E.g.,.~--%s-orde
48d40 72 7e 2e 0a 0a 2d 20 7e 61 72 67 75 6d 65 6e 74 2d 72 65 67 65 78 70 7e 20 54 68 65 20 72 65 67 r~...-.~argument-regexp~.The.reg
48d60 65 78 70 20 75 73 65 64 20 74 6f 20 6d 61 74 63 68 20 61 6e 79 20 6f 6e 65 20 6f 66 20 74 68 65 exp.used.to.match.any.one.of.the
48d80 20 73 77 69 74 63 68 65 73 2e 0a 20 20 45 2e 67 2e 2c 20 7e 5c 5c 28 2d 2d 5c 5c 28 74 6f 70 6f .switches....E.g.,.~\\(--\\(topo
48da0 5c 5c 7c 61 75 74 68 6f 72 2d 64 61 74 65 5c 5c 7c 64 61 74 65 5c 5c 29 2d 6f 72 64 65 72 5c 5c \\|author-date\\|date\\)-order\\
48dc0 29 7e 2e 0a 0a 2a 2a 20 50 72 65 64 69 63 61 74 65 20 53 6c 6f 74 73 0a 0a 53 75 66 66 69 78 20 )~...**.Predicate.Slots..Suffix.
48de0 61 6e 64 20 67 72 6f 75 70 20 6f 62 6a 65 63 74 73 20 73 68 61 72 65 20 74 77 6f 20 73 65 74 73 and.group.objects.share.two.sets
48e00 20 6f 66 20 70 72 65 64 69 63 61 74 65 20 73 6c 6f 74 73 20 74 68 61 74 0a 63 6f 6e 74 72 6f 6c .of.predicate.slots.that.control
48e20 20 77 68 65 74 68 65 72 20 61 20 67 72 6f 75 70 20 6f 72 20 73 75 66 66 69 78 20 73 68 6f 75 6c .whether.a.group.or.suffix.shoul
48e40 64 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 0a 73 6f 6d 65 d.be.available.depending.on.some
48e60 20 73 74 61 74 65 2e 20 20 4f 6e 6c 79 20 6f 6e 65 20 73 6c 6f 74 20 66 72 6f 6d 20 65 61 63 68 .state...Only.one.slot.from.each
48e80 20 73 65 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 74 20 74 68 65 20 73 61 6d 65 0a 74 69 6d .set.can.be.used.at.the.same.tim
48ea0 65 2e 20 20 49 74 20 69 73 20 75 6e 64 65 66 69 6e 65 64 20 77 68 69 63 68 20 73 6c 6f 74 20 69 e...It.is.undefined.which.slot.i
48ec0 73 20 68 6f 6e 6f 72 65 64 20 69 66 20 79 6f 75 20 75 73 65 20 6d 6f 72 65 20 74 68 61 6e 0a 6f s.honored.if.you.use.more.than.o
48ee0 6e 65 2e 0a 0a 50 72 65 64 69 63 61 74 65 73 20 66 72 6f 6d 20 74 68 65 20 66 69 72 73 74 20 67 ne...Predicates.from.the.first.g
48f00 72 6f 75 70 20 63 6f 6e 74 72 6f 6c 20 77 68 65 74 68 65 72 20 74 68 65 20 73 75 66 66 69 78 20 roup.control.whether.the.suffix.
48f20 69 73 20 70 72 65 73 65 6e 74 0a 69 6e 20 74 68 65 20 6d 65 6e 75 20 61 74 20 61 6c 6c 2e 0a 0a is.present.in.the.menu.at.all...
48f40 2d 20 7e 69 66 7e 20 45 6e 61 62 6c 65 20 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 -.~if~.Enable.if.predicate.retur
48f60 6e 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2e 0a 2d 20 7e 69 66 2d 6e 6f 74 7e 20 45 6e 61 62 6c 65 20 ns.non-~nil~..-.~if-not~.Enable.
48f80 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 7e 6e 69 6c 7e 2e 0a 2d 20 7e 69 if.predicate.returns.~nil~..-.~i
48fa0 66 2d 6e 6f 6e 2d 6e 69 6c 7e 20 45 6e 61 62 6c 65 20 69 66 20 76 61 72 69 61 62 6c 65 27 73 20 f-non-nil~.Enable.if.variable's.
48fc0 76 61 6c 75 65 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2e 0a 2d 20 7e 69 66 2d 6e 69 6c 7e 20 45 value.is.non-~nil~..-.~if-nil~.E
48fe0 6e 61 62 6c 65 20 69 66 20 76 61 72 69 61 62 6c 65 27 73 20 76 61 6c 75 65 20 69 73 20 7e 6e 69 nable.if.variable's.value.is.~ni
49000 6c 7e 2e 0a 2d 20 7e 69 66 2d 6d 6f 64 65 7e 20 45 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d l~..-.~if-mode~.Enable.if.major-
49020 6d 6f 64 65 20 6d 61 74 63 68 65 73 20 76 61 6c 75 65 2e 0a 2d 20 7e 69 66 2d 6e 6f 74 2d 6d 6f mode.matches.value..-.~if-not-mo
49040 64 65 7e 20 45 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f de~.Enable.if.major-mode.does.no
49060 74 20 6d 61 74 63 68 20 76 61 6c 75 65 2e 0a 2d 20 7e 69 66 2d 64 65 72 69 76 65 64 7e 20 45 6e t.match.value..-.~if-derived~.En
49080 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 able.if.major-mode.derives.from.
490a0 76 61 6c 75 65 2e 0a 2d 20 7e 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 7e 20 45 6e 61 62 6c 65 value..-.~if-not-derived~.Enable
490c0 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 64 65 72 69 76 65 20 66 .if.major-mode.does.not.derive.f
490e0 72 6f 6d 20 76 61 6c 75 65 2e 0a 0a 50 72 65 64 69 63 61 74 65 73 20 66 72 6f 6d 20 74 68 65 20 rom.value...Predicates.from.the.
49100 73 65 63 6f 6e 64 20 67 72 6f 75 70 20 63 6f 6e 74 72 6f 6c 20 77 68 65 74 68 65 72 20 74 68 65 second.group.control.whether.the
49120 20 73 75 66 66 69 78 20 63 61 6e 20 62 65 0a 69 6e 76 6f 6b 65 64 2e 20 20 54 68 65 20 73 75 66 .suffix.can.be.invoked...The.suf
49140 66 69 78 20 69 73 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 72 65 67 61 72 64 6c fix.is.shown.in.the.menu.regardl
49160 65 73 73 2c 20 62 75 74 20 77 68 65 6e 20 69 74 0a 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20 22 ess,.but.when.it.is.considered."
49180 69 6e 61 70 74 22 2c 20 74 68 65 6e 20 69 74 20 69 73 20 67 72 61 79 65 64 20 6f 75 74 20 74 6f inapt",.then.it.is.grayed.out.to
491a0 20 69 6e 64 69 63 61 74 65 64 20 74 68 61 74 20 69 74 0a 63 75 72 72 65 6e 74 6c 79 20 63 61 6e .indicated.that.it.currently.can
491c0 6e 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 2e 0a 0a 2d 20 7e 69 6e 61 70 74 2d 69 66 7e 20 49 6e not.be.invoked...-.~inapt-if~.In
491e0 61 70 74 20 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7e 6e 69 apt.if.predicate.returns.non-~ni
49200 6c 7e 2e 0a 2d 20 7e 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 7e 20 49 6e 61 70 74 20 69 66 20 70 72 l~..-.~inapt-if-not~.Inapt.if.pr
49220 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 7e 6e 69 6c 7e 2e 0a 2d 20 7e 69 6e 61 70 74 2d edicate.returns.~nil~..-.~inapt-
49240 69 66 2d 6e 6f 6e 2d 6e 69 6c 7e 20 49 6e 61 70 74 20 69 66 20 76 61 72 69 61 62 6c 65 27 73 20 if-non-nil~.Inapt.if.variable's.
49260 76 61 6c 75 65 20 69 73 20 6e 6f 6e 2d 7e 6e 69 6c 7e 2e 0a 2d 20 7e 69 6e 61 70 74 2d 69 66 2d value.is.non-~nil~..-.~inapt-if-
49280 6e 69 6c 7e 20 49 6e 61 70 74 20 69 66 20 76 61 72 69 61 62 6c 65 27 73 20 76 61 6c 75 65 20 69 nil~.Inapt.if.variable's.value.i
492a0 73 20 7e 6e 69 6c 7e 2e 0a 2d 20 7e 69 6e 61 70 74 2d 69 66 2d 6d 6f 64 65 7e 20 49 6e 61 70 74 s.~nil~..-.~inapt-if-mode~.Inapt
492c0 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 6d 61 74 63 68 65 73 20 76 61 6c 75 65 2e 0a 2d 20 .if.major-mode.matches.value..-.
492e0 7e 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 6d 6f 64 65 7e 20 49 6e 61 70 74 20 69 66 20 6d 61 6a ~inapt-if-not-mode~.Inapt.if.maj
49300 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 76 61 6c 75 65 2e 0a 2d 20 or-mode.does.not.match.value..-.
49320 7e 69 6e 61 70 74 2d 69 66 2d 64 65 72 69 76 65 64 7e 20 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f ~inapt-if-derived~.Inapt.if.majo
49340 72 2d 6d 6f 64 65 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 76 61 6c 75 65 2e 0a 2d 20 7e 69 6e r-mode.derives.from.value..-.~in
49360 61 70 74 2d 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 7e 20 49 6e 61 70 74 20 69 66 20 6d 61 6a apt-if-not-derived~.Inapt.if.maj
49380 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 64 65 72 69 76 65 20 66 72 6f 6d 20 76 61 6c or-mode.does.not.derive.from.val
493a0 75 65 2e 0a 0a 42 79 20 64 65 66 61 75 6c 74 20 74 68 65 73 65 20 70 72 65 64 69 63 61 74 65 73 ue...By.default.these.predicates
493c0 20 72 75 6e 20 77 68 65 6e 20 74 68 65 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 .run.when.the.prefix.command.is.
493e0 69 6e 76 6f 6b 65 64 2c 0a 62 75 74 20 74 68 69 73 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 73 invoked,.but.this.can.be.changes
49400 2c 20 75 73 69 6e 67 20 74 68 65 20 7e 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 7e 20 70 ,.using.the.~refresh-suffixes~.p
49420 72 65 66 69 78 20 73 6c 6f 74 2e 0a 53 65 65 20 5b 5b 2a 50 72 65 66 69 78 20 53 6c 6f 74 73 5d refix.slot..See.[[*Prefix.Slots]
49440 5d 2e 0a 0a 4f 6e 65 20 6d 6f 72 65 20 73 6c 6f 74 20 69 73 20 73 68 61 72 65 64 20 62 65 74 77 ]...One.more.slot.is.shared.betw
49460 65 65 6e 20 67 72 6f 75 70 20 61 6e 64 20 73 75 66 66 69 78 20 63 6c 61 73 73 65 73 2c 20 7e 6c een.group.and.suffix.classes,.~l
49480 65 76 65 6c 7e 2e 20 20 4c 69 6b 65 0a 74 68 65 20 73 6c 6f 74 73 20 64 6f 63 75 6d 65 6e 74 65 evel~...Like.the.slots.documente
494a0 64 20 61 62 6f 76 65 2c 20 69 74 20 69 73 20 61 20 70 72 65 64 69 63 61 74 65 2c 20 62 75 74 20 d.above,.it.is.a.predicate,.but.
494c0 69 74 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 0a 64 69 66 66 65 72 65 6e 74 20 70 75 72 70 6f it.is.used.for.a.different.purpo
494e0 73 65 2e 20 20 54 68 65 20 76 61 6c 75 65 20 68 61 73 20 74 6f 20 62 65 20 61 6e 20 69 6e 74 65 se...The.value.has.to.be.an.inte
49500 67 65 72 20 62 65 74 77 65 65 6e 20 31 0a 61 6e 64 20 37 2e 20 20 7e 6c 65 76 65 6c 7e 20 63 6f ger.between.1.and.7...~level~.co
49520 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 61 20 73 75 66 66 69 78 20 6f 72 20 61 20 67 72 6f ntrols.whether.a.suffix.or.a.gro
49540 75 70 20 73 68 6f 75 6c 64 20 62 65 0a 61 76 61 69 6c 61 62 6c 65 20 64 65 70 65 6e 64 69 6e 67 up.should.be.available.depending
49560 20 6f 6e 20 75 73 65 72 20 70 72 65 66 65 72 65 6e 63 65 2e 0a 53 65 65 20 5b 5b 2a 45 6e 61 62 .on.user.preference..See.[[*Enab
49580 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 5d 5d 2e 0a 0a ling.and.Disabling.Suffixes]]...
495a0 2a 20 46 41 51 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 41 50 50 45 4e 44 49 58 3a 20 20 20 *.FAQ.:PROPERTIES:.:APPENDIX:...
495c0 74 0a 3a 45 4e 44 3a 0a 0a 2a 2a 20 43 61 6e 20 49 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 68 t.:END:..**.Can.I.control.how.th
495e0 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 3f 0a 3a 50 52 4f e.menu.buffer.is.displayed?.:PRO
49600 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 PERTIES:.:UNNUMBERED:.notoc.:END
49620 3a 0a 0a 59 65 73 2c 20 73 65 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 :..Yes,.see.~transient-display-b
49640 75 66 66 65 72 2d 61 63 74 69 6f 6e 7e 20 69 6e 20 5b 5b 2a 43 6f 6e 66 69 67 75 72 61 74 69 6f uffer-action~.in.[[*Configuratio
49660 6e 5d 5d 2e 20 20 59 6f 75 20 63 61 6e 0a 61 6c 73 6f 20 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 74 n]]...You.can.also.control.how.t
49680 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 61 he.menu.buffer.is.displayed.on.a
496a0 20 63 61 73 65 2d 62 79 2d 63 61 73 65 20 62 61 73 69 73 0a 62 79 20 70 61 73 73 69 6e 67 20 7e .case-by-case.basis.by.passing.~
496c0 3a 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 7e 20 74 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 :display-action~.to.~transient-d
496e0 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e 0a 0a 2a 2a 20 48 6f 77 20 63 61 6e 20 49 20 63 6f 70 efine-prefix~...**.How.can.I.cop
49700 79 20 74 65 78 74 20 66 72 6f 6d 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 3f 0a 3a 50 52 y.text.from.the.menu.buffer?.:PR
49720 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e OPERTIES:.:UNNUMBERED:.notoc.:EN
49740 44 3a 0a 0a 54 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 6d 61 72 6b 20 74 65 78 74 20 69 6e 20 54 D:..To.be.able.to.mark.text.in.T
49760 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 20 75 73 69 6e 67 20 74 68 65 ransient's.menu.buffer.using.the
49780 20 6d 6f 75 73 65 2c 0a 79 6f 75 20 68 61 76 65 20 74 6f 20 61 64 64 20 74 68 65 20 62 65 6c 6f .mouse,.you.have.to.add.the.belo
497a0 77 20 62 69 6e 64 69 6e 67 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 66 6f 72 20 74 65 63 68 6e 69 w.binding...Note.that.for.techni
497c0 63 61 6c 20 72 65 61 73 6f 6e 73 2c 0a 74 68 65 20 72 65 67 69 6f 6e 20 77 6f 6e 27 74 20 62 65 cal.reasons,.the.region.won't.be
497e0 20 76 69 73 75 61 6c 69 7a 65 64 2c 20 77 68 69 6c 65 20 64 6f 69 6e 67 20 73 6f 2e 20 20 41 66 .visualized,.while.doing.so...Af
49800 74 65 72 20 79 6f 75 20 68 61 76 65 20 71 75 69 74 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 ter.you.have.quit.the.transient.
49820 6d 65 6e 75 2c 20 79 6f 75 20 77 69 6c 6c 20 62 65 20 61 62 6c 65 20 74 6f 20 79 61 6e 6b 20 69 menu,.you.will.be.able.to.yank.i
49840 74 20 69 6e 20 61 6e 6f 74 68 65 72 20 62 75 66 66 65 72 2e 0a 0a 23 2b 62 65 67 69 6e 5f 73 72 t.in.another.buffer...#+begin_sr
49860 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 74 72 61 6e 73 c.emacs-lisp...(keymap-set.trans
49880 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ient-predicate-map..............
498a0 20 22 3c 6d 6f 75 73 65 2d 73 65 74 2d 72 65 67 69 6f 6e 3e 22 0a 20 20 20 20 20 20 20 20 20 20 ."<mouse-set-region>"...........
498c0 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 29 0a 23 2b 65 6e 64 5f ....#'transient--do-stay).#+end_
498e0 73 72 63 0a 0a 43 6f 70 79 69 6e 67 20 74 68 65 20 72 65 67 69 6f 6e 20 77 68 69 6c 65 20 6e 6f src..Copying.the.region.while.no
49900 74 20 73 65 65 69 6e 67 20 74 68 65 20 72 65 67 69 6f 6e 20 69 73 20 61 20 62 69 74 20 66 69 64 t.seeing.the.region.is.a.bit.fid
49920 64 6c 79 2c 20 73 6f 20 61 0a 64 65 64 69 63 61 74 65 64 20 63 6f 6d 6d 61 6e 64 2c 20 7e 74 72 dly,.so.a.dedicated.command,.~tr
49940 61 6e 73 69 65 6e 74 2d 63 6f 70 79 2d 6d 65 6e 75 2d 74 65 78 74 7e 2c 20 77 61 73 20 61 64 64 ansient-copy-menu-text~,.was.add
49960 65 64 2e 20 20 59 6f 75 20 68 61 76 65 20 74 6f 0a 61 64 64 20 61 20 62 69 6e 64 69 6e 67 20 66 ed...You.have.to.add.a.binding.f
49980 6f 72 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6d 61 or.this.command.in.~transient-ma
499a0 70 7e 2e 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 6b p~...#+begin_src.emacs-lisp...(k
499c0 65 79 6d 61 70 2d 73 65 74 20 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 22 43 2d 63 20 43 2d 77 eymap-set.transient-map."C-c.C-w
499e0 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 70 79 2d 6d 65 6e 75 2d 74 65 78 74 29 0a 23 2b ".#'transient-copy-menu-text).#+
49a00 65 6e 64 5f 73 72 63 0a 0a 2a 2a 20 48 6f 77 20 63 61 6e 20 49 20 61 75 74 6f 6c 6f 61 64 20 70 end_src..**.How.can.I.autoload.p
49a20 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 3f 0a 3a 50 52 4f 50 refix.and.suffix.commands?.:PROP
49a40 45 52 54 49 45 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a ERTIES:.:UNNUMBERED:.notoc.:END:
49a60 0a 0a 49 66 20 79 6f 75 72 20 70 61 63 6b 61 67 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 73 20 ..If.your.package.only.supports.
49a80 45 6d 61 63 73 20 33 30 2c 20 6a 75 73 74 20 70 72 65 66 69 78 20 74 68 65 20 64 65 66 69 6e 69 Emacs.30,.just.prefix.the.defini
49aa0 74 69 6f 6e 0a 77 69 74 68 20 7e 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 7e 2e 20 20 49 66 20 tion.with.~;;;###autoload~...If.
49ac0 79 6f 75 72 20 70 61 63 6b 61 67 65 20 73 75 70 70 6f 72 74 73 20 72 65 6c 65 61 73 65 64 20 76 your.package.supports.released.v
49ae0 65 72 73 69 6f 6e 73 20 6f 66 0a 45 6d 61 63 73 2c 20 79 6f 75 20 75 6e 66 6f 72 74 75 6e 61 74 ersions.of.Emacs,.you.unfortunat
49b00 65 6c 79 20 68 61 76 65 20 74 6f 20 75 73 65 20 61 20 6c 6f 6e 67 20 66 6f 72 6d 20 61 75 74 6f ely.have.to.use.a.long.form.auto
49b20 6c 6f 61 64 20 63 6f 6d 6d 65 6e 74 0a 61 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 5b 5b 69 load.comment.as.described.in.[[i
49b40 6e 66 6f 3a 65 6c 69 73 70 23 41 75 74 6f 6c 6f 61 64 5d 5d 2e 0a 0a 23 2b 62 65 67 69 6e 5f 73 nfo:elisp#Autoload]]...#+begin_s
49b60 72 63 20 65 6d 61 63 73 2d 6c 69 73 70 0a 20 20 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 20 28 rc.emacs-lisp...;;;###autoload.(
49b80 61 75 74 6f 6c 6f 61 64 20 27 6d 61 67 69 74 2d 64 69 73 70 61 74 63 68 20 22 6d 61 67 69 74 22 autoload.'magit-dispatch."magit"
49ba0 20 6e 69 6c 20 74 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 .nil.t)...(transient-define-pref
49bc0 69 78 20 6d 61 67 69 74 2d 64 69 73 70 61 74 63 68 20 28 29 0a 20 20 20 20 2e 2e 2e 29 0a 23 2b ix.magit-dispatch.()........).#+
49be0 65 6e 64 5f 73 72 63 0a 0a 2a 2a 20 48 6f 77 20 64 6f 65 73 20 54 72 61 6e 73 69 65 6e 74 20 63 end_src..**.How.does.Transient.c
49c00 6f 6d 70 61 72 65 20 74 6f 20 70 72 65 66 69 78 20 6b 65 79 73 20 61 6e 64 20 75 6e 69 76 65 72 ompare.to.prefix.keys.and.univer
49c20 73 61 6c 20 61 72 67 75 6d 65 6e 74 73 3f 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e 4e sal.arguments?.:PROPERTIES:.:UNN
49c40 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 53 65 65 20 68 74 74 70 73 3a UMBERED:.notoc.:END:..See.https:
49c60 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 2f 77 69 6b //github.com/magit/transient/wik
49c80 69 2f 43 6f 6d 70 61 72 69 73 6f 6e 2d 77 69 74 68 2d 70 72 65 66 69 78 2d 6b 65 79 73 2d 61 6e i/Comparison-with-prefix-keys-an
49ca0 64 2d 75 6e 69 76 65 72 73 61 6c 2d 61 72 67 75 6d 65 6e 74 73 2e 0a 0a 2a 2a 20 48 6f 77 20 64 d-universal-arguments...**.How.d
49cc0 6f 65 73 20 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 70 61 72 65 20 74 6f 20 4d 61 67 69 74 2d 50 oes.Transient.compare.to.Magit-P
49ce0 6f 70 75 70 20 61 6e 64 20 48 79 64 72 61 3f 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 55 4e opup.and.Hydra?.:PROPERTIES:.:UN
49d00 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 53 65 65 20 68 74 74 70 73 NUMBERED:.notoc.:END:..See.https
49d20 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 2f 77 69 ://github.com/magit/transient/wi
49d40 6b 69 2f 43 6f 6d 70 61 72 69 73 6f 6e 2d 77 69 74 68 2d 6f 74 68 65 72 2d 70 61 63 6b 61 67 65 ki/Comparison-with-other-package
49d60 73 2e 0a 0a 2a 2a 20 57 68 79 20 64 6f 65 73 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 20 6e 6f 74 s...**.Why.does.{{{kbd(q)}}}.not
49d80 20 71 75 69 74 20 70 6f 70 75 70 73 20 61 6e 79 6d 6f 72 65 3f 0a 3a 50 52 4f 50 45 52 54 49 45 .quit.popups.anymore?.:PROPERTIE
49da0 53 3a 0a 3a 55 4e 4e 55 4d 42 45 52 45 44 3a 20 6e 6f 74 6f 63 0a 3a 45 4e 44 3a 0a 0a 49 20 61 S:.:UNNUMBERED:.notoc.:END:..I.a
49dc0 67 72 65 65 20 74 68 61 74 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 20 69 73 20 61 20 67 6f 6f 64 gree.that.{{{kbd(q)}}}.is.a.good
49de0 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 71 75 69 74 20 .binding.for.commands.that.quit.
49e00 73 6f 6d 65 74 68 69 6e 67 2e 0a 54 68 69 73 20 69 6e 63 6c 75 64 65 73 20 71 75 69 74 74 69 6e something..This.includes.quittin
49e20 67 20 77 68 61 74 65 76 65 72 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 63 75 72 72 65 6e 74 6c g.whatever.transient.is.currentl
49e40 79 20 61 63 74 69 76 65 2c 20 62 75 74 20 69 74 0a 61 6c 73 6f 20 69 6e 63 6c 75 64 65 73 20 71 y.active,.but.it.also.includes.q
49e60 75 69 74 74 69 6e 67 20 77 68 61 74 65 76 65 72 20 69 74 20 69 73 20 74 68 61 74 20 73 6f 6d 65 uitting.whatever.it.is.that.some
49e80 20 73 70 65 63 69 66 69 63 20 74 72 61 6e 73 69 65 6e 74 20 69 73 0a 63 6f 6e 74 72 6f 6c 6c 69 .specific.transient.is.controlli
49ea0 6e 67 2e 20 20 54 68 65 20 74 72 61 6e 73 69 65 6e 74 20 7e 6d 61 67 69 74 2d 62 6c 61 6d 65 7e ng...The.transient.~magit-blame~
49ec0 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 62 69 6e 64 73 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 20 .for.example.binds.{{{kbd(q)}}}.
49ee0 74 6f 20 74 68 65 0a 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 74 75 72 6e 73 20 7e 6d 61 67 69 74 to.the.command.that.turns.~magit
49f00 2d 62 6c 61 6d 65 2d 6d 6f 64 65 7e 20 6f 66 66 2e 0a 0a 53 6f 20 49 20 68 61 64 20 74 6f 20 64 -blame-mode~.off...So.I.had.to.d
49f20 65 63 69 64 65 20 69 66 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 20 73 68 6f 75 6c 64 20 71 75 69 ecide.if.{{{kbd(q)}}}.should.qui
49f40 74 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 28 6c 69 6b 65 0a 4d 61 67 t.the.active.transient.(like.Mag
49f60 69 74 2d 50 6f 70 75 70 20 75 73 65 64 20 74 6f 29 20 6f 72 20 77 68 65 74 68 65 72 20 7b 7b 7b it-Popup.used.to).or.whether.{{{
49f80 6b 62 64 28 43 2d 67 29 7d 7d 7d 20 73 68 6f 75 6c 64 20 64 6f 20 74 68 61 74 20 69 6e 73 74 65 kbd(C-g)}}}.should.do.that.inste
49fa0 61 64 2c 20 73 6f 20 74 68 61 74 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 0a 63 6f 75 6c 64 20 62 ad,.so.that.{{{kbd(q)}}}.could.b
49fc0 65 20 62 6f 75 6e 64 20 69 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 20 e.bound.in.individual.transient.
49fe0 74 6f 20 77 68 61 74 65 76 65 72 20 63 6f 6d 6d 61 6e 64 73 20 6d 61 6b 65 20 73 65 6e 73 65 0a to.whatever.commands.make.sense.
4a000 66 6f 72 20 74 68 65 6d 2e 20 20 42 65 63 61 75 73 65 20 61 6c 6c 20 6f 74 68 65 72 20 6c 65 74 for.them...Because.all.other.let
4a020 74 65 72 73 20 61 72 65 20 61 6c 72 65 61 64 79 20 72 65 73 65 72 76 65 64 20 66 6f 72 20 75 73 ters.are.already.reserved.for.us
4a040 65 20 62 79 0a 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 73 2c 20 49 20 68 61 e.by.individual.transients,.I.ha
4a060 76 65 20 64 65 63 69 64 65 64 20 74 6f 20 6e 6f 20 6c 6f 6e 67 65 72 20 6d 61 6b 65 20 61 6e 20 ve.decided.to.no.longer.make.an.
4a080 65 78 63 65 70 74 69 6f 6e 0a 66 6f 72 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 2e 0a 0a 49 66 20 exception.for.{{{kbd(q)}}}...If.
4a0a0 79 6f 75 20 77 61 6e 74 20 74 6f 20 67 65 74 20 7b 7b 7b 6b 62 64 28 71 29 7d 7d 7d 27 73 20 6f you.want.to.get.{{{kbd(q)}}}'s.o
4a0c0 6c 64 20 62 69 6e 64 69 6e 67 20 62 61 63 6b 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 64 6f 20 ld.binding.back.then.you.can.do.
4a0e0 73 6f 2e 20 20 44 6f 69 6e 67 0a 74 68 61 74 20 69 73 20 61 20 62 69 74 20 6d 6f 72 65 20 63 6f so...Doing.that.is.a.bit.more.co
4a100 6d 70 6c 69 63 61 74 65 64 20 74 68 61 6e 20 63 68 61 6e 67 69 6e 67 20 61 20 73 69 6e 67 6c 65 mplicated.than.changing.a.single
4a120 20 6b 65 79 20 62 69 6e 64 69 6e 67 2c 20 73 6f 0a 49 20 68 61 76 65 20 69 6d 70 6c 65 6d 65 6e .key.binding,.so.I.have.implemen
4a140 74 65 64 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d ted.a.function,.~transient-bind-
4a160 71 2d 74 6f 2d 71 75 69 74 7e 20 74 68 61 74 20 6d 61 6b 65 73 20 74 68 65 0a 6e 65 63 65 73 73 q-to-quit~.that.makes.the.necess
4a180 61 72 79 20 63 68 61 6e 67 65 73 2e 20 20 53 65 65 20 69 74 73 20 64 6f 63 75 6d 65 6e 74 61 74 ary.changes...See.its.documentat
4a1a0 69 6f 6e 20 73 74 72 69 6e 67 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e ion.string.for.more.information.
4a1c0 0a 0a 2a 20 4b 65 79 73 74 72 6f 6b 65 20 49 6e 64 65 78 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a ..*.Keystroke.Index.:PROPERTIES:
4a1e0 0a 3a 41 50 50 45 4e 44 49 58 3a 20 20 20 74 0a 3a 49 4e 44 45 58 3a 20 20 20 20 20 20 6b 79 0a .:APPENDIX:...t.:INDEX:......ky.
4a200 3a 43 4f 4f 4b 49 45 5f 44 41 54 41 3a 20 72 65 63 75 72 73 69 76 65 0a 3a 45 4e 44 3a 0a 2a 20 :COOKIE_DATA:.recursive.:END:.*.
4a220 43 6f 6d 6d 61 6e 64 20 61 6e 64 20 46 75 6e 63 74 69 6f 6e 20 49 6e 64 65 78 0a 3a 50 52 4f 50 Command.and.Function.Index.:PROP
4a240 45 52 54 49 45 53 3a 0a 3a 41 50 50 45 4e 44 49 58 3a 20 20 20 74 0a 3a 49 4e 44 45 58 3a 20 20 ERTIES:.:APPENDIX:...t.:INDEX:..
4a260 20 20 20 20 66 6e 0a 3a 45 4e 44 3a 0a 2a 20 56 61 72 69 61 62 6c 65 20 49 6e 64 65 78 0a 3a 50 ....fn.:END:.*.Variable.Index.:P
4a280 52 4f 50 45 52 54 49 45 53 3a 0a 3a 41 50 50 45 4e 44 49 58 3a 20 20 20 74 0a 3a 49 4e 44 45 58 ROPERTIES:.:APPENDIX:...t.:INDEX
4a2a0 3a 20 20 20 20 20 20 76 72 0a 3a 45 4e 44 3a 0a 2a 20 43 6f 6e 63 65 70 74 20 49 6e 64 65 78 0a :......vr.:END:.*.Concept.Index.
4a2c0 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 41 50 50 45 4e 44 49 58 3a 20 20 20 74 0a 3a 49 4e 44 :PROPERTIES:.:APPENDIX:...t.:IND
4a2e0 45 58 3a 20 20 20 20 20 20 63 70 0a 3a 45 4e 44 3a 0a 0a 2a 20 47 4e 55 20 47 65 6e 65 72 61 6c EX:......cp.:END:..*.GNU.General
4a300 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 0a 3a 50 52 4f 50 45 52 54 49 45 53 3a 0a 3a 41 50 .Public.License.:PROPERTIES:.:AP
4a320 50 45 4e 44 49 58 3a 20 20 20 74 0a 3a 45 4e 44 3a 0a 23 2b 74 65 78 69 6e 66 6f 3a 20 40 69 6e PENDIX:...t.:END:.#+texinfo:.@in
4a340 63 6c 75 64 65 20 67 70 6c 2e 74 65 78 69 0a 0a 2a 20 43 6f 70 79 69 6e 67 0a 3a 50 52 4f 50 45 clude.gpl.texi..*.Copying.:PROPE
4a360 52 54 49 45 53 3a 0a 3a 43 4f 50 59 49 4e 47 3a 20 20 20 20 74 0a 3a 45 4e 44 3a 0a 0a 23 2b 62 RTIES:.:COPYING:....t.:END:..#+b
4a380 65 67 69 6e 5f 71 75 6f 74 65 0a 43 6f 70 79 72 69 67 68 74 20 28 43 29 20 32 30 31 38 2d 2d 7b egin_quote.Copyright.(C).2018--{
4a3a0 7b 7b 79 65 61 72 7d 7d 7d 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 {{year}}}.Free.Software.Foundati
4a3c0 6f 6e 2c 20 49 6e 63 2e 0a 0a 59 6f 75 20 63 61 6e 20 72 65 64 69 73 74 72 69 62 75 74 65 20 74 on,.Inc...You.can.redistribute.t
4a3e0 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 61 6e 64 2f 6f 72 20 6d 6f 64 69 66 79 20 69 74 20 75 6e his.document.and/or.modify.it.un
4a400 64 65 72 20 74 68 65 20 74 65 72 6d 73 0a 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c der.the.terms.of.the.GNU.General
4a420 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 68 65 64 20 62 79 20 .Public.License.as.published.by.
4a440 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 0a 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 65 69 the.Free.Software.Foundation,.ei
4a460 74 68 65 72 20 76 65 72 73 69 6f 6e 20 33 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 65 2c 20 6f ther.version.3.of.the.License,.o
4a480 72 20 28 61 74 20 79 6f 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 0a 6c 61 74 65 72 20 76 65 72 r.(at.your.option).any.later.ver
4a4a0 73 69 6f 6e 2e 0a 0a 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 64 69 73 74 72 69 62 75 sion...This.document.is.distribu
4a4c0 74 65 64 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 ted.in.the.hope.that.it.will.be.
4a4e0 75 73 65 66 75 6c 2c 0a 62 75 74 20 57 49 54 48 4f 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 useful,.but.WITHOUT.ANY.WARRANTY
4a500 3b 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 ;.without.even.the.implied.warra
4a520 6e 74 79 20 6f 66 0a 4d 45 52 43 48 41 4e 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e 45 53 nty.of.MERCHANTABILITY.or.FITNES
4a540 53 20 46 4f 52 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53 65 65 S.FOR.A.PARTICULAR.PURPOSE...See
4a560 20 74 68 65 20 47 4e 55 0a 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 .the.GNU.General.Public.License.
4a580 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a 23 2b 65 6e 64 5f 71 75 6f 74 65 0a 0a 23 for.more.details..#+end_quote..#
4a5a0 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a 20 20 41 52 47 4c 49 53 54 20 41 52 47 53 20 43 4c 49 20 ..LocalWords:..ARGLIST.ARGS.CLI.
4a5c0 44 4f 43 53 54 52 49 4e 47 20 45 4c 45 4d 45 4e 54 73 20 45 56 41 4c 20 47 52 4f 55 50 73 20 49 DOCSTRING.ELEMENTs.EVAL.GROUPs.I
4a5e0 6e 66 69 78 65 73 0a 23 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a 20 20 49 6e 66 69 78 65 73 20 4b nfixes.#..LocalWords:..Infixes.K
4a600 45 59 57 4f 52 44 73 20 4c 4f 43 20 4c 6f 63 61 6c 57 6f 72 64 73 20 4d 45 52 43 48 41 4e 54 41 EYWORDs.LOC.LocalWords.MERCHANTA
4a620 42 49 4c 49 54 59 20 4d 61 67 69 74 0a 23 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a 20 20 4d 61 67 BILITY.Magit.#..LocalWords:..Mag
4a640 69 74 27 73 20 4d 61 6b 65 66 69 6c 65 20 4f 42 4a 20 4f 42 4a 27 73 20 50 72 65 20 61 6c 69 73 it's.Makefile.OBJ.OBJ's.Pre.alis
4a660 74 20 61 72 67 6c 69 73 74 0a 23 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a 20 20 61 72 67 73 20 61 t.arglist.#..LocalWords:..args.a
4a680 75 74 6f 6c 6f 61 64 65 64 20 62 6f 6f 6c 65 61 6e 20 62 6f 6f 6c 65 61 6e 73 20 63 75 73 74 6f utoloaded.boolean.booleans.custo
4a6a0 6d 69 7a 61 62 6c 65 20 64 6f 63 73 74 72 69 6e 67 0a 23 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a mizable.docstring.#..LocalWords:
4a6c0 20 20 65 76 61 6c 20 66 65 61 74 75 72 65 70 20 69 6e 66 69 78 65 73 20 69 6e 69 74 20 69 73 65 ..eval.featurep.infixes.init.ise
4a6e0 61 72 63 68 20 6b 65 79 6d 61 70 20 6b 65 79 6d 61 70 73 20 6c 6f 63 0a 23 20 20 4c 6f 63 61 6c arch.keymap.keymaps.loc.#..Local
4a700 57 6f 72 64 73 3a 20 20 6d 61 67 69 74 20 6d 61 6e 70 61 67 65 20 6d 69 6e 69 62 75 66 66 65 72 Words:..magit.manpage.minibuffer
4a720 20 6d 6f 6e 6f 73 70 61 63 65 64 20 6e 65 73 73 20 6e 69 6c 6c 79 20 6e 6f 6f 70 20 6e 6f 6f 70 .monospaced.ness.nilly.noop.noop
4a740 73 0a 23 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a 20 20 70 6c 69 73 74 20 70 72 65 20 70 72 65 76 s.#..LocalWords:..plist.pre.prev
4a760 20 72 65 62 61 73 65 20 72 65 64 69 73 70 6c 61 79 20 73 72 63 20 73 75 62 63 6c 61 73 73 20 73 .rebase.redisplay.src.subclass.s
4a780 75 62 63 6c 61 73 73 65 73 0a 23 20 20 4c 6f 63 61 6c 57 6f 72 64 73 3a 20 20 73 75 62 63 6f 6d ubclasses.#..LocalWords:..subcom
4a7a0 6d 61 6e 64 73 20 73 75 62 70 72 6f 63 65 73 73 20 73 75 70 65 72 63 6c 61 73 73 20 74 6f 6f 6c mands.subprocess.superclass.tool
4a7c0 74 69 70 20 74 65 72 6d 63 61 70 20 75 74 69 6c 73 0a 0a 23 20 49 4d 50 4f 52 54 41 4e 54 3a 20 tip.termcap.utils..#.IMPORTANT:.
4a7e0 41 6c 73 6f 20 75 70 64 61 74 65 20 4f 52 47 5f 41 52 47 53 20 61 6e 64 20 4f 52 47 5f 45 56 41 Also.update.ORG_ARGS.and.ORG_EVA
4a800 4c 20 69 6e 20 74 68 65 20 4d 61 6b 65 66 69 6c 65 2e 0a 23 20 4c 6f 63 61 6c 20 56 61 72 69 61 L.in.the.Makefile..#.Local.Varia
4a820 62 6c 65 73 3a 0a 23 20 69 6e 64 65 6e 74 2d 74 61 62 73 2d 6d 6f 64 65 3a 20 6e 69 6c 0a 23 20 bles:.#.indent-tabs-mode:.nil.#.
4a840 6f 72 67 2d 68 69 64 65 2d 6d 61 63 72 6f 2d 6d 61 72 6b 65 72 73 3a 20 74 0a 23 20 6f 72 67 2d org-hide-macro-markers:.t.#.org-
4a860 73 72 63 2d 70 72 65 73 65 72 76 65 2d 69 6e 64 65 6e 74 61 74 69 6f 6e 3a 20 6e 69 6c 0a 23 20 src-preserve-indentation:.nil.#.
4a880 45 6e 64 3a 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 End:............................
4a8a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a8c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a8e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a900 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a920 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a9a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a9c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4a9e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4aa00 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 74 72 61 6e 73 69 65 6e 74 2e 65 6c 00 00 00 transient-0.10.0/transient.el...
4aa20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4aa40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4aa60 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
4aa80 30 36 36 36 36 32 36 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 34 36 31 35 00 20 30 00 00 00 0666626.00000000000.014615..0...
4aaa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4aac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4aae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4ab00 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...................
4ab20 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...................
4ab40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4ab60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4ab80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4aba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4abc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4abe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
4ac00 3b 3b 3b 20 74 72 61 6e 73 69 65 6e 74 2e 65 6c 20 2d 2d 2d 20 54 72 61 6e 73 69 65 6e 74 20 63 ;;;.transient.el.---.Transient.c
4ac20 6f 6d 6d 61 6e 64 73 20 20 2d 2a 2d 20 6c 65 78 69 63 61 6c 2d 62 69 6e 64 69 6e 67 3a 74 20 2d ommands..-*-.lexical-binding:t.-
4ac40 2a 2d 0a 0a 3b 3b 20 43 6f 70 79 72 69 67 68 74 20 28 43 29 20 32 30 31 38 2d 32 30 32 35 20 46 *-..;;.Copyright.(C).2018-2025.F
4ac60 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e 63 2e 0a 0a 3b ree.Software.Foundation,.Inc...;
4ac80 3b 20 41 75 74 68 6f 72 3a 20 4a 6f 6e 61 73 20 42 65 72 6e 6f 75 6c 6c 69 20 3c 65 6d 61 63 73 ;.Author:.Jonas.Bernoulli.<emacs
4aca0 2e 74 72 61 6e 73 69 65 6e 74 40 6a 6f 6e 61 73 2e 62 65 72 6e 6f 75 6c 6c 69 2e 64 65 76 3e 0a .transient@jonas.bernoulli.dev>.
4acc0 3b 3b 20 48 6f 6d 65 70 61 67 65 3a 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f ;;.Homepage:.https://github.com/
4ace0 6d 61 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 0a 3b 3b 20 4b 65 79 77 6f 72 64 73 3a 20 65 78 74 magit/transient.;;.Keywords:.ext
4ad00 65 6e 73 69 6f 6e 73 0a 0a 3b 3b 20 50 61 63 6b 61 67 65 2d 56 65 72 73 69 6f 6e 3a 20 30 2e 31 ensions..;;.Package-Version:.0.1
4ad20 30 2e 30 0a 3b 3b 20 50 61 63 6b 61 67 65 2d 52 65 71 75 69 72 65 73 3a 20 28 0a 3b 3b 20 20 20 0.0.;;.Package-Requires:.(.;;...
4ad40 20 20 28 65 6d 61 63 73 20 20 22 32 36 2e 31 22 29 0a 3b 3b 20 20 20 20 20 28 63 6f 6d 70 61 74 ..(emacs.."26.1").;;.....(compat
4ad60 20 22 33 30 2e 31 22 29 0a 3b 3b 20 20 20 20 20 28 73 65 71 20 20 20 20 20 22 32 2e 32 34 22 29 ."30.1").;;.....(seq....."2.24")
4ad80 29 0a 0a 3b 3b 20 53 50 44 58 2d 4c 69 63 65 6e 73 65 2d 49 64 65 6e 74 69 66 69 65 72 3a 20 47 )..;;.SPDX-License-Identifier:.G
4ada0 50 4c 2d 33 2e 30 2d 6f 72 2d 6c 61 74 65 72 0a 0a 3b 3b 20 54 68 69 73 20 66 69 6c 65 20 69 73 PL-3.0-or-later..;;.This.file.is
4adc0 20 70 61 72 74 20 6f 66 20 47 4e 55 20 45 6d 61 63 73 2e 0a 0a 3b 3b 20 47 4e 55 20 45 6d 61 63 .part.of.GNU.Emacs...;;.GNU.Emac
4ade0 73 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 72 65 3a 20 79 6f 75 20 63 61 6e 20 72 65 64 69 s.is.free.software:.you.can.redi
4ae00 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 3b 20 69 74 20 stribute.it.and/or.modify.;;.it.
4ae20 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 47 65 6e 65 72 under.the.terms.of.the.GNU.Gener
4ae40 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 68 65 64 0a 3b al.Public.License.as.published.;
4ae60 3b 20 62 79 20 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f ;.by.the.Free.Software.Foundatio
4ae80 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 4c 69 63 65 6e n,.either.version.3.of.the.Licen
4aea0 73 65 2c 0a 3b 3b 20 6f 72 20 28 61 74 20 79 6f 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c se,.;;.or.(at.your.option).any.l
4aec0 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 3b 3b 0a 3b 3b 20 47 4e 55 20 45 6d 61 63 73 20 69 73 ater.version..;;.;;.GNU.Emacs.is
4aee0 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 68 61 74 20 69 74 .distributed.in.the.hope.that.it
4af00 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 54 48 4f 55 54 20 .will.be.useful,.;;.but.WITHOUT.
4af20 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 20 74 68 65 20 69 ANY.WARRANTY;.without.even.the.i
4af40 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 48 41 4e 54 41 42 mplied.warranty.of.;;.MERCHANTAB
4af60 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 54 49 43 55 4c 41 ILITY.or.FITNESS.FOR.A.PARTICULA
4af80 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 20 47 65 6e 65 72 R.PURPOSE...See.the.;;.GNU.Gener
4afa0 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 20 64 65 74 61 69 al.Public.License.for.more.detai
4afc0 6c 73 2e 0a 3b 3b 0a 3b 3b 20 59 6f 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65 63 65 69 76 ls..;;.;;.You.should.have.receiv
4afe0 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 20 50 75 62 ed.a.copy.of.the.GNU.General.Pub
4b000 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 69 73 20 70 lic.License.;;.along.with.this.p
4b020 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 2f 2f 77 77 rogram...If.not,.see.<https://ww
4b040 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 6f 6d 6d 65 w.gnu.org/licenses/>...;;;.Comme
4b060 6e 74 61 72 79 3a 0a 0a 3b 3b 20 54 72 61 6e 73 69 65 6e 74 20 69 73 20 74 68 65 20 6c 69 62 72 ntary:..;;.Transient.is.the.libr
4b080 61 72 79 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 6b 65 79 62 6f 61 ary.used.to.implement.the.keyboa
4b0a0 72 64 2d 64 72 69 76 65 6e 20 6d 65 6e 75 73 0a 3b 3b 20 69 6e 20 4d 61 67 69 74 2e 20 20 49 74 rd-driven.menus.;;.in.Magit...It
4b0c0 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 61 73 20 61 20 73 65 70 61 72 61 74 65 20 70 61 .is.distributed.as.a.separate.pa
4b0e0 63 6b 61 67 65 2c 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a 3b 3b 20 75 73 65 64 ckage,.so.that.it.can.be.;;.used
4b100 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 73 69 6d 69 6c 61 72 20 6d 65 6e 75 73 20 69 6e 20 6f .to.implement.similar.menus.in.o
4b120 74 68 65 72 20 70 61 63 6b 61 67 65 73 2e 0a 0a 3b 3b 3b 20 43 6f 64 65 3a 0a 0a 28 64 65 66 63 ther.packages...;;;.Code:..(defc
4b140 6f 6e 73 74 20 74 72 61 6e 73 69 65 6e 74 2d 76 65 72 73 69 6f 6e 20 22 30 2e 31 30 2e 30 22 29 onst.transient-version."0.10.0")
4b160 0a 0a 28 72 65 71 75 69 72 65 20 27 63 6c 2d 6c 69 62 29 0a 28 72 65 71 75 69 72 65 20 27 63 6f ..(require.'cl-lib).(require.'co
4b180 6d 70 61 74 29 0a 28 72 65 71 75 69 72 65 20 27 65 69 65 69 6f 29 0a 28 72 65 71 75 69 72 65 20 mpat).(require.'eieio).(require.
4b1a0 27 65 64 6d 61 63 72 6f 29 0a 28 72 65 71 75 69 72 65 20 27 66 6f 72 6d 61 74 2d 73 70 65 63 29 'edmacro).(require.'format-spec)
4b1c0 0a 28 72 65 71 75 69 72 65 20 27 70 63 61 73 65 29 0a 28 72 65 71 75 69 72 65 20 27 70 70 29 0a .(require.'pcase).(require.'pp).
4b1e0 0a 28 65 76 61 6c 2d 61 6e 64 2d 63 6f 6d 70 69 6c 65 0a 20 20 28 77 68 65 6e 20 28 61 6e 64 20 .(eval-and-compile...(when.(and.
4b200 28 66 65 61 74 75 72 65 70 20 27 73 65 71 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f (featurep.'seq)..............(no
4b220 74 20 28 66 62 6f 75 6e 64 70 20 27 73 65 71 2d 6b 65 65 70 29 29 29 0a 20 20 20 20 28 75 6e 6c t.(fboundp.'seq-keep))).....(unl
4b240 6f 61 64 2d 66 65 61 74 75 72 65 20 27 73 65 71 20 27 66 6f 72 63 65 29 29 29 0a 28 72 65 71 75 oad-feature.'seq.'force))).(requ
4b260 69 72 65 20 27 73 65 71 29 0a 28 75 6e 6c 65 73 73 20 28 66 62 6f 75 6e 64 70 20 27 73 65 71 2d ire.'seq).(unless.(fboundp.'seq-
4b280 6b 65 65 70 29 0a 20 20 28 64 69 73 70 6c 61 79 2d 77 61 72 6e 69 6e 67 20 27 74 72 61 6e 73 69 keep)...(display-warning.'transi
4b2a0 65 6e 74 20 28 73 75 62 73 74 69 74 75 74 65 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 20 22 5c 0a ent.(substitute-command-keys."\.
4b2c0 54 72 61 6e 73 69 65 6e 74 20 72 65 71 75 69 72 65 73 20 60 73 65 71 27 20 3e 3d 20 32 2e 32 34 Transient.requires.`seq'.>=.2.24
4b2e0 2c 0a 62 75 74 20 64 75 65 20 74 6f 20 62 61 64 20 64 65 66 61 75 6c 74 73 2c 20 45 6d 61 63 73 ,.but.due.to.bad.defaults,.Emacs
4b300 27 73 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 2c 20 72 65 66 75 73 65 73 20 74 6f 0a 75 's.package.manager,.refuses.to.u
4b320 70 67 72 61 64 65 20 74 68 69 73 20 61 6e 64 20 6f 74 68 65 72 20 62 75 69 6c 74 2d 69 6e 20 70 pgrade.this.and.other.built-in.p
4b340 61 63 6b 61 67 65 73 20 74 6f 20 68 69 67 68 65 72 20 72 65 6c 65 61 73 65 73 0a 66 72 6f 6d 20 ackages.to.higher.releases.from.
4b360 47 4e 55 20 45 6c 70 61 2c 20 77 68 65 6e 20 61 20 70 61 63 6b 61 67 65 20 73 70 65 63 69 66 69 GNU.Elpa,.when.a.package.specifi
4b380 65 73 20 74 68 61 74 20 74 68 69 73 20 69 73 20 6e 65 65 64 65 64 2e 0a 0a 54 6f 20 66 69 78 20 es.that.this.is.needed...To.fix.
4b3a0 74 68 69 73 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 61 64 64 20 74 68 69 73 20 74 6f 20 79 6f this,.you.have.to.add.this.to.yo
4b3c0 75 72 20 69 6e 69 74 20 66 69 6c 65 3a 0a 0a 20 20 28 73 65 74 71 20 70 61 63 6b 61 67 65 2d 69 ur.init.file:....(setq.package-i
4b3e0 6e 73 74 61 6c 6c 2d 75 70 67 72 61 64 65 2d 62 75 69 6c 74 2d 69 6e 20 74 29 0a 0a 54 68 65 6e nstall-upgrade-built-in.t)..Then
4b400 20 65 76 61 6c 75 61 74 65 20 74 68 61 74 20 65 78 70 72 65 73 73 69 6f 6e 20 62 79 20 70 6c 61 .evaluate.that.expression.by.pla
4b420 63 69 6e 67 20 74 68 65 20 63 75 72 73 6f 72 20 61 66 74 65 72 20 69 74 0a 61 6e 64 20 74 79 70 cing.the.cursor.after.it.and.typ
4b440 69 6e 67 20 5c 5c 5b 65 76 61 6c 2d 6c 61 73 74 2d 73 65 78 70 5d 2e 0a 0a 4f 6e 63 65 20 79 6f ing.\\[eval-last-sexp]...Once.yo
4b460 75 20 68 61 76 65 20 64 6f 6e 65 20 74 68 61 74 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 65 78 u.have.done.that,.you.have.to.ex
4b480 70 6c 69 63 69 74 6c 79 20 75 70 67 72 61 64 65 20 60 73 65 71 27 3a 0a 0a 20 20 5c 5c 5b 70 61 plicitly.upgrade.`seq':....\\[pa
4b4a0 63 6b 61 67 65 2d 75 70 67 72 61 64 65 5d 20 73 65 71 20 5c 5c 60 52 45 54 27 0a 0a 54 68 65 6e ckage-upgrade].seq.\\`RET'..Then
4b4c0 20 79 6f 75 20 61 6c 73 6f 20 6d 75 73 74 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 75 70 64 .you.also.must.make.sure.the.upd
4b4e0 61 74 65 64 20 76 65 72 73 69 6f 6e 20 69 73 20 6c 6f 61 64 65 64 2c 0a 62 79 20 65 76 61 6c 75 ated.version.is.loaded,.by.evalu
4b500 61 74 69 6e 67 20 74 68 69 73 20 66 6f 72 6d 3a 0a 0a 20 20 28 70 72 6f 67 6e 20 28 75 6e 6c 6f ating.this.form:....(progn.(unlo
4b520 61 64 2d 66 65 61 74 75 72 65 20 27 73 65 71 20 74 29 20 28 72 65 71 75 69 72 65 20 27 73 65 71 ad-feature.'seq.t).(require.'seq
4b540 29 29 0a 0a 55 6e 74 69 6c 20 79 6f 75 20 64 6f 20 74 68 69 73 2c 20 79 6f 75 20 77 69 6c 6c 20 ))..Until.you.do.this,.you.will.
4b560 67 65 74 20 72 61 6e 64 6f 6d 20 65 72 72 6f 72 73 20 61 62 6f 75 74 20 60 73 65 71 2d 6b 65 65 get.random.errors.about.`seq-kee
4b580 70 27 0a 62 65 69 6e 67 20 75 6e 64 65 66 69 6e 65 64 20 77 68 69 6c 65 20 75 73 69 6e 67 20 54 p'.being.undefined.while.using.T
4b5a0 72 61 6e 73 69 65 6e 74 2e 0a 0a 49 66 20 79 6f 75 20 64 6f 6e 27 74 20 75 73 65 20 74 68 65 20 ransient...If.you.don't.use.the.
4b5c0 60 70 61 63 6b 61 67 65 27 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 20 62 75 74 20 73 74 `package'.package.manager.but.st
4b5e0 69 6c 6c 20 67 65 74 0a 74 68 69 73 20 77 61 72 6e 69 6e 67 2c 20 74 68 65 6e 20 79 6f 75 72 20 ill.get.this.warning,.then.your.
4b600 63 68 6f 73 65 6e 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 20 6c 69 6b 65 6c 79 20 68 61 chosen.package.manager.likely.ha
4b620 73 20 61 0a 73 69 6d 69 6c 61 72 20 64 65 66 65 63 74 2e 22 29 20 3a 65 6d 65 72 67 65 6e 63 79 s.a.similar.defect.").:emergency
4b640 29 29 0a 0a 28 65 76 61 6c 2d 77 68 65 6e 2d 63 6f 6d 70 69 6c 65 20 28 72 65 71 75 69 72 65 20 ))..(eval-when-compile.(require.
4b660 27 73 75 62 72 2d 78 29 29 0a 0a 28 65 76 61 6c 2d 61 6e 64 2d 63 6f 6d 70 69 6c 65 0a 20 20 28 'subr-x))..(eval-and-compile...(
4b680 75 6e 6c 65 73 73 20 28 62 6f 75 6e 64 70 20 27 65 69 65 69 6f 2d 2d 75 6e 62 6f 75 6e 64 29 20 unless.(boundp.'eieio--unbound).
4b6a0 3b 20 4e 65 77 20 6e 61 6d 65 20 73 69 6e 63 65 20 45 6d 61 63 73 20 32 38 2e 31 2e 0a 20 20 20 ;.New.name.since.Emacs.28.1.....
4b6c0 20 28 64 65 66 76 61 72 61 6c 69 61 73 20 27 65 69 65 69 6f 2d 2d 75 6e 62 6f 75 6e 64 20 27 65 .(defvaralias.'eieio--unbound.'e
4b6e0 69 65 69 6f 2d 75 6e 62 6f 75 6e 64 20 6e 69 6c 29 29 29 0a 0a 28 64 65 63 6c 61 72 65 2d 66 75 ieio-unbound.nil)))..(declare-fu
4b700 6e 63 74 69 6f 6e 20 69 6e 66 6f 20 22 69 6e 66 6f 22 20 28 26 6f 70 74 69 6f 6e 61 6c 20 66 69 nction.info."info".(&optional.fi
4b720 6c 65 2d 6f 72 2d 6e 6f 64 65 20 62 75 66 66 65 72 29 29 0a 28 64 65 63 6c 61 72 65 2d 66 75 6e le-or-node.buffer)).(declare-fun
4b740 63 74 69 6f 6e 20 4d 61 6e 2d 66 69 6e 64 2d 73 65 63 74 69 6f 6e 20 22 6d 61 6e 22 20 28 73 65 ction.Man-find-section."man".(se
4b760 63 74 69 6f 6e 29 29 0a 28 64 65 63 6c 61 72 65 2d 66 75 6e 63 74 69 6f 6e 20 4d 61 6e 2d 6e 65 ction)).(declare-function.Man-ne
4b780 78 74 2d 73 65 63 74 69 6f 6e 20 22 6d 61 6e 22 20 28 6e 29 29 0a 28 64 65 63 6c 61 72 65 2d 66 xt-section."man".(n)).(declare-f
4b7a0 75 6e 63 74 69 6f 6e 20 4d 61 6e 2d 67 65 74 70 61 67 65 2d 69 6e 2d 62 61 63 6b 67 72 6f 75 6e unction.Man-getpage-in-backgroun
4b7c0 64 20 22 6d 61 6e 22 20 28 74 6f 70 69 63 29 29 0a 0a 28 64 65 66 76 61 72 20 4d 61 6e 2d 6e 6f d."man".(topic))..(defvar.Man-no
4b7e0 74 69 66 79 2d 6d 65 74 68 6f 64 29 0a 28 64 65 66 76 61 72 20 70 70 2d 64 65 66 61 75 6c 74 2d tify-method).(defvar.pp-default-
4b800 66 75 6e 63 74 69 6f 6e 29 20 3b 20 73 69 6e 63 65 20 45 6d 61 63 73 20 32 39 2e 31 0a 0a 28 65 function).;.since.Emacs.29.1..(e
4b820 76 61 6c 2d 61 6e 64 2d 63 6f 6d 70 69 6c 65 0a 20 20 28 77 68 65 6e 20 28 3c 20 65 6d 61 63 73 val-and-compile...(when.(<.emacs
4b840 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 32 38 29 0a 20 20 20 20 28 70 63 61 73 65 2d 64 65 -major-version.28).....(pcase-de
4b860 66 6d 61 63 72 6f 20 63 6c 2d 74 79 70 65 20 28 74 79 70 65 29 0a 20 20 20 20 20 20 22 50 63 61 fmacro.cl-type.(type)......."Pca
4b880 73 65 20 70 61 74 74 65 72 6e 20 74 68 61 74 20 6d 61 74 63 68 65 73 20 6f 62 6a 65 63 74 73 20 se.pattern.that.matches.objects.
4b8a0 6f 66 20 54 59 50 45 2e 0a 54 59 50 45 20 69 73 20 61 20 74 79 70 65 20 64 65 73 63 72 69 70 74 of.TYPE..TYPE.is.a.type.descript
4b8c0 6f 72 20 61 73 20 61 63 63 65 70 74 65 64 20 62 79 20 60 63 6c 2d 74 79 70 65 70 27 2c 20 77 68 or.as.accepted.by.`cl-typep',.wh
4b8e0 69 63 68 20 73 65 65 2e 22 0a 20 20 20 20 20 20 28 73 74 61 74 69 63 2d 69 66 20 28 3c 20 65 6d ich.see.".......(static-if.(<.em
4b900 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 33 30 29 0a 20 20 20 20 20 20 20 20 20 20 acs-major-version.30)...........
4b920 60 28 70 72 65 64 20 28 70 63 61 73 65 2d 2d 66 6c 69 70 20 63 6c 2d 74 79 70 65 70 20 27 2c 74 `(pred.(pcase--flip.cl-typep.',t
4b940 79 70 65 29 29 0a 20 20 20 20 20 20 20 20 60 28 70 72 65 64 20 28 63 6c 2d 74 79 70 65 70 20 5f ype)).........`(pred.(cl-typep._
4b960 20 27 2c 74 79 70 65 29 29 29 29 29 29 0a 0a 28 73 74 61 74 69 63 2d 69 66 20 28 3c 20 65 6d 61 .',type))))))..(static-if.(<.ema
4b980 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 33 30 29 0a 20 20 20 20 28 70 72 6f 67 6e 0a cs-major-version.30).....(progn.
4b9a0 20 20 20 20 20 20 28 64 65 66 75 6e 20 69 6e 74 65 72 6e 61 6c 2d 2d 62 75 69 6c 64 2d 62 69 6e ......(defun.internal--build-bin
4b9c0 64 69 6e 67 40 62 61 63 6b 70 6f 72 74 2d 65 36 38 30 38 32 37 65 38 31 34 20 28 66 6e 20 62 69 ding@backport-e680827e814.(fn.bi
4b9e0 6e 64 69 6e 67 20 70 72 65 76 2d 76 61 72 29 0a 20 20 20 20 20 20 20 20 22 42 61 63 6b 70 6f 72 nding.prev-var)........."Backpor
4ba00 74 20 6e 6f 74 20 77 61 72 6e 69 6e 67 20 61 62 6f 75 74 20 60 5f 27 20 6e 6f 74 20 62 65 69 6e t.not.warning.about.`_'.not.bein
4ba20 67 20 6c 65 66 74 20 75 6e 75 73 65 64 2e 0a 42 61 63 6b 70 6f 72 74 20 66 69 78 20 66 6f 72 20 g.left.unused..Backport.fix.for.
4ba40 68 74 74 70 73 3a 2f 2f 64 65 62 62 75 67 73 2e 67 6e 75 2e 6f 72 67 2f 63 67 69 2f 62 75 67 72 https://debbugs.gnu.org/cgi/bugr
4ba60 65 70 6f 72 74 2e 63 67 69 3f 62 75 67 3d 36 39 31 30 38 2c 0a 66 72 6f 6d 20 45 6d 61 63 73 20 eport.cgi?bug=69108,.from.Emacs.
4ba80 63 6f 6d 6d 69 74 20 65 36 38 30 38 32 37 65 38 31 34 65 31 35 35 63 66 37 39 31 37 35 64 38 37 commit.e680827e814e155cf79175d87
4baa0 66 66 37 63 36 65 65 33 61 30 38 62 36 39 61 2e 22 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 ff7c6ee3a08b69a.".........(let.(
4bac0 28 62 69 6e 64 69 6e 67 20 28 66 75 6e 63 61 6c 6c 20 66 6e 20 62 69 6e 64 69 6e 67 20 70 72 65 (binding.(funcall.fn.binding.pre
4bae0 76 2d 76 61 72 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 65 71 20 28 63 61 72 20 v-var)))...........(if.(eq.(car.
4bb00 62 69 6e 64 69 6e 67 29 20 27 5f 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 binding).'_)...............(cons
4bb20 20 28 6d 61 6b 65 2d 73 79 6d 62 6f 6c 20 22 73 22 29 20 28 63 64 72 20 62 69 6e 64 69 6e 67 29 .(make-symbol."s").(cdr.binding)
4bb40 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 69 6e 64 69 6e 67 29 29 29 0a 20 20 20 20 20 20 28 ).............binding))).......(
4bb60 61 64 76 69 63 65 2d 61 64 64 20 27 69 6e 74 65 72 6e 61 6c 2d 2d 62 75 69 6c 64 2d 62 69 6e 64 advice-add.'internal--build-bind
4bb80 69 6e 67 20 3a 61 72 6f 75 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 ing.:around...................#'
4bba0 69 6e 74 65 72 6e 61 6c 2d 2d 62 75 69 6c 64 2d 62 69 6e 64 69 6e 67 40 62 61 63 6b 70 6f 72 74 internal--build-binding@backport
4bbc0 2d 65 36 38 30 38 32 37 65 38 31 34 29 29 29 0a 0a 28 6d 61 6b 65 2d 6f 62 73 6f 6c 65 74 65 2d -e680827e814)))..(make-obsolete-
4bbe0 76 61 72 69 61 62 6c 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 68 69 64 65 2d 64 75 72 69 6e 67 2d variable.'transient-hide-during-
4bc00 6d 69 6e 69 62 75 66 66 65 72 2d 72 65 61 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 minibuffer-read.................
4bc20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 64 75 72 69 6e 67 2d 6d ........'transient-show-during-m
4bc40 69 6e 69 62 75 66 66 65 72 2d 72 65 61 64 20 22 30 2e 38 2e 30 22 29 0a 0a 28 64 65 66 76 61 72 inibuffer-read."0.8.0")..(defvar
4bc60 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 .transient-common-command-prefix
4bc80 29 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 65 6d 65 )..(defmacro.transient--with-eme
4bca0 72 67 65 6e 63 79 2d 65 78 69 74 20 28 69 64 20 26 72 65 73 74 20 62 6f 64 79 29 0a 20 20 28 64 rgency-exit.(id.&rest.body)...(d
4bcc0 65 63 6c 61 72 65 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 20 28 75 6e 6c 65 73 73 eclare.(indent.defun))...(unless
4bce0 20 28 6b 65 79 77 6f 72 64 70 20 69 64 29 0a 20 20 20 20 28 73 65 74 71 20 62 6f 64 79 20 28 63 .(keywordp.id).....(setq.body.(c
4bd00 6f 6e 73 20 69 64 20 62 6f 64 79 29 29 0a 20 20 20 20 28 73 65 74 71 20 69 64 20 6e 69 6c 29 29 ons.id.body)).....(setq.id.nil))
4bd20 0a 20 20 60 28 63 6f 6e 64 69 74 69 6f 6e 2d 63 61 73 65 20 65 72 72 0a 20 20 20 20 20 20 20 28 ...`(condition-case.err........(
4bd40 6c 65 74 20 28 28 64 65 62 75 67 67 65 72 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 let.((debugger.#'transient--exit
4bd60 2d 61 6e 64 2d 64 65 62 75 67 29 29 0a 20 20 20 20 20 20 20 20 20 2c 28 6d 61 63 72 6f 65 78 70 -and-debug))..........,(macroexp
4bd80 2d 70 72 6f 67 6e 20 62 6f 64 79 29 29 0a 20 20 20 20 20 28 28 64 65 62 75 67 20 65 72 72 6f 72 -progn.body))......((debug.error
4bda0 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 ).......(transient--emergency-ex
4bdc0 69 74 20 2c 69 64 29 0a 20 20 20 20 20 20 28 73 69 67 6e 61 6c 20 28 63 61 72 20 65 72 72 29 20 it.,id).......(signal.(car.err).
4bde0 28 63 64 72 20 65 72 72 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d (cdr.err)))))..(defun.transient-
4be00 2d 65 78 69 74 2d 61 6e 64 2d 64 65 62 75 67 20 28 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 28 -exit-and-debug.(&rest.args)...(
4be20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 64 65 62 75 67 transient--emergency-exit.:debug
4be40 67 65 72 29 0a 20 20 28 61 70 70 6c 79 20 23 27 64 65 62 75 67 20 61 72 67 73 29 29 0a 0a 3b 3b ger)...(apply.#'debug.args))..;;
4be60 3b 20 4f 70 74 69 6f 6e 73 0a 0a 28 64 65 66 67 72 6f 75 70 20 74 72 61 6e 73 69 65 6e 74 20 6e ;.Options..(defgroup.transient.n
4be80 69 6c 0a 20 20 22 54 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 2e 22 0a 20 20 3a 67 72 il..."Transient.commands."...:gr
4bea0 6f 75 70 20 27 65 78 74 65 6e 73 69 6f 6e 73 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 oup.'extensions)..(defcustom.tra
4bec0 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 6f 70 75 70 20 74 0a 20 20 22 57 68 65 74 68 65 72 20 61 nsient-show-popup.t..."Whether.a
4bee0 6e 64 20 77 68 65 6e 20 74 6f 20 73 68 6f 77 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 nd.when.to.show.transient's.menu
4bf00 20 69 6e 20 61 20 62 75 66 66 65 72 2e 0a 5c 5c 3c 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 3e 0a .in.a.buffer..\\<transient-map>.
4bf20 2d 20 49 66 20 74 2c 20 74 68 65 6e 20 73 68 6f 77 20 74 68 65 20 62 75 66 66 65 72 20 61 73 20 -.If.t,.then.show.the.buffer.as.
4bf40 73 6f 6f 6e 20 61 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 soon.as.a.transient.prefix.comma
4bf60 6e 64 0a 20 20 69 73 20 69 6e 76 6f 6b 65 64 2e 0a 0a 2d 20 49 66 20 6e 69 6c 2c 20 74 68 65 6e nd...is.invoked...-.If.nil,.then
4bf80 20 64 6f 20 6e 6f 74 20 73 68 6f 77 20 74 68 65 20 62 75 66 66 65 72 20 75 6e 6c 65 73 73 20 74 .do.not.show.the.buffer.unless.t
4bfa0 68 65 20 75 73 65 72 20 65 78 70 6c 69 63 69 74 6c 79 0a 20 20 72 65 71 75 65 73 74 73 20 69 74 he.user.explicitly...requests.it
4bfc0 2c 20 62 79 20 70 72 65 73 73 69 6e 67 20 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 5d ,.by.pressing.\\[transient-show]
4bfe0 20 6f 72 20 61 20 70 72 65 66 69 78 20 6b 65 79 2e 0a 0a 2d 20 49 66 20 61 20 6e 75 6d 62 65 72 .or.a.prefix.key...-.If.a.number
4c000 2c 20 74 68 65 6e 20 64 65 6c 61 79 20 64 69 73 70 6c 61 79 69 6e 67 20 74 68 65 20 62 75 66 66 ,.then.delay.displaying.the.buff
4c020 65 72 20 61 6e 64 20 69 6e 73 74 65 61 64 20 73 68 6f 77 0a 20 20 61 20 62 72 69 65 66 20 6f 6e er.and.instead.show...a.brief.on
4c040 65 2d 6c 69 6e 65 20 73 75 6d 6d 61 72 79 2e 20 20 49 66 20 7a 65 72 6f 20 6f 72 20 6e 65 67 61 e-line.summary...If.zero.or.nega
4c060 74 69 76 65 2c 20 74 68 65 6e 20 73 75 70 70 72 65 73 73 0a 20 20 65 76 65 6e 20 73 68 6f 77 69 tive,.then.suppress...even.showi
4c080 6e 67 20 74 68 61 74 20 73 75 6d 6d 61 72 79 20 61 6e 64 20 64 69 73 70 6c 61 79 20 74 68 65 20 ng.that.summary.and.display.the.
4c0a0 70 72 65 73 73 65 64 20 6b 65 79 20 6f 6e 6c 79 2e 0a 0a 20 20 53 68 6f 77 20 74 68 65 20 62 75 pressed.key.only.....Show.the.bu
4c0c0 66 66 65 72 20 6f 6e 63 65 20 74 68 65 20 75 73 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 72 65 ffer.once.the.user.explicitly.re
4c0e0 71 75 65 73 74 73 20 69 74 20 62 79 20 70 72 65 73 73 69 6e 67 0a 20 20 5c 5c 5b 74 72 61 6e 73 quests.it.by.pressing...\\[trans
4c100 69 65 6e 74 2d 73 68 6f 77 5d 20 6f 72 20 61 20 70 72 65 66 69 78 20 6b 65 79 2e 20 20 55 6e 6c ient-show].or.a.prefix.key...Unl
4c120 65 73 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 61 6c 73 6f 20 73 68 6f 77 20 74 68 65 20 62 75 66 ess.zero,.then.also.show.the.buf
4c140 66 65 72 0a 20 20 61 66 74 65 72 20 74 68 61 74 20 6d 61 6e 79 20 73 65 63 6f 6e 64 73 20 6f 66 fer...after.that.many.seconds.of
4c160 20 69 6e 61 63 74 69 76 69 74 79 20 28 75 73 69 6e 67 20 74 68 65 20 61 62 73 6f 6c 75 74 65 20 .inactivity.(using.the.absolute.
4c180 76 61 6c 75 65 29 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 value)."...:package-version.'(tr
4c1a0 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 ansient..."0.1.0")...:group.'tra
4c1c0 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 28 63 68 6f 69 63 65 20 28 63 6f 6e 73 74 20 20 nsient...:type.'(choice.(const..
4c1e0 3a 74 61 67 20 22 49 6e 73 74 61 6e 74 6c 79 22 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 :tag."Instantly".t).............
4c200 20 20 20 20 20 28 63 6f 6e 73 74 20 20 3a 74 61 67 20 22 4f 6e 20 64 65 6d 61 6e 64 22 20 6e 69 .....(const..:tag."On.demand".ni
4c220 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 20 3a 74 61 67 l)..................(const..:tag
4c240 20 22 4f 6e 20 64 65 6d 61 6e 64 20 28 6e 6f 20 73 75 6d 6d 61 72 79 29 22 20 30 29 0a 20 20 20 ."On.demand.(no.summary)".0)....
4c260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 75 6d 62 65 72 20 3a 74 61 67 20 22 41 66 74 65 ..............(number.:tag."Afte
4c280 72 20 64 65 6c 61 79 22 20 31 29 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 r.delay".1)))..(defcustom.transi
4c2a0 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 20 27 76 65 72 ent-enable-popup-navigation.'ver
4c2c0 62 6f 73 65 0a 20 20 22 57 68 65 74 68 65 72 20 6e 61 76 69 67 61 74 69 6f 6e 20 63 6f 6d 6d 61 bose..."Whether.navigation.comma
4c2e0 6e 64 73 20 61 72 65 20 65 6e 61 62 6c 65 64 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 nds.are.enabled.in.the.menu.buff
4c300 65 72 2e 0a 0a 49 66 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 60 76 65 72 62 6f 73 65 27 2c 20 er...If.the.value.is.`verbose',.
4c320 61 64 64 69 74 69 6f 6e 61 6c 6c 79 20 73 68 6f 77 20 62 72 69 65 66 20 64 6f 63 75 6d 65 6e 74 additionally.show.brief.document
4c340 61 74 69 6f 6e 0a 61 62 6f 75 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 75 6e 64 65 72 20 70 6f ation.about.the.command.under.po
4c360 69 6e 74 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2e 0a 0a 57 68 69 6c 65 20 61 20 74 int.in.the.echo.area...While.a.t
4c380 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d ransient.is.active.transient's.m
4c3a0 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 20 74 68 65 0a 63 75 72 72 65 6e 74 20 62 75 enu.buffer.is.not.the.current.bu
4c3c0 66 66 65 72 2c 20 6d 61 6b 69 6e 67 20 69 74 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 75 73 65 ffer,.making.it.necessary.to.use
4c3e0 20 64 65 64 69 63 61 74 65 64 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 0a 61 63 74 20 6f 6e 20 74 68 .dedicated.commands.to.act.on.th
4c400 61 74 20 62 75 66 66 65 72 20 69 74 73 65 6c 66 2e 20 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f at.buffer.itself...If.this.is.no
4c420 6e 2d 6e 69 6c 2c 20 74 68 65 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 62 69 6e 64 69 6e n-nil,.then.the.following.bindin
4c440 67 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 3a 0a 0a 5c 5c 3c 74 72 61 6e 73 69 65 6e 74 2d gs.are.available:..\\<transient-
4c460 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 2d 6d 61 70 3e 5c 0a 2d 20 5c 5c 5b 74 72 61 6e popup-navigation-map>\.-.\\[tran
4c480 73 69 65 6e 74 2d 62 61 63 6b 77 61 72 64 2d 62 75 74 74 6f 6e 5d 20 6d 6f 76 65 73 20 74 68 65 sient-backward-button].moves.the
4c4a0 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 75 66 66 69 78 2e 0a .cursor.to.the.previous.suffix..
4c4c0 2d 20 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 77 61 72 64 2d 62 75 74 74 6f 6e 5d 20 6d -.\\[transient-forward-button].m
4c4e0 6f 76 65 73 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 73 75 66 66 oves.the.cursor.to.the.next.suff
4c500 69 78 2e 0a 2d 20 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 5d 20 ix..-.\\[transient-push-button].
4c520 69 6e 76 6f 6b 65 73 20 74 68 65 20 73 75 66 66 69 78 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 invokes.the.suffix.the.cursor.is
4c540 20 6f 6e 2e 0a 5c 5c 3c 74 72 61 6e 73 69 65 6e 74 2d 62 75 74 74 6f 6e 2d 6d 61 70 3e 5c 0a 2d .on..\\<transient-button-map>\.-
4c560 20 5c 5c 60 3c 6d 6f 75 73 65 2d 31 3e 27 20 61 6e 64 20 5c 5c 60 3c 6d 6f 75 73 65 2d 32 3e 27 .\\`<mouse-1>'.and.\\`<mouse-2>'
4c580 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 6c 69 63 6b 65 64 20 6f 6e 20 73 75 66 66 69 78 2e 0a 5c .invoke.the.clicked.on.suffix..\
4c5a0 5c 3c 74 72 61 6e 73 69 65 6e 74 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 2d 6d 61 70 \<transient-popup-navigation-map
4c5c0 3e 5c 0a 2d 20 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 62 61 63 6b 77 61 >\.-.\\[transient-isearch-backwa
4c5e0 72 64 5d 5c 0a 20 61 6e 64 20 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 66 rd]\..and.\\[transient-isearch-f
4c600 6f 72 77 61 72 64 5d 20 73 74 61 72 74 20 69 73 65 61 72 63 68 20 69 6e 20 74 68 65 20 6d 65 6e orward].start.isearch.in.the.men
4c620 75 20 62 75 66 66 65 72 2e 0a 0a 5c 5c 60 3c 6d 6f 75 73 65 2d 31 3e 27 20 61 6e 64 20 5c 5c 60 u.buffer...\\`<mouse-1>'.and.\\`
4c640 3c 6d 6f 75 73 65 2d 32 3e 27 20 61 72 65 20 62 6f 75 6e 64 20 69 6e 20 60 74 72 61 6e 73 69 65 <mouse-2>'.are.bound.in.`transie
4c660 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 27 2e 0a 41 6c 6c 20 6f 74 68 65 72 20 62 69 6e 64 69 nt-push-button'..All.other.bindi
4c680 6e 67 73 20 61 72 65 20 69 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 6f 70 75 70 2d 6e 61 76 69 ngs.are.in.`transient-popup-navi
4c6a0 67 61 74 69 6f 6e 2d 6d 61 70 27 2e 0a 0a 42 79 20 64 65 66 61 75 6c 74 20 5c 5c 60 4d 2d 52 45 gation-map'...By.default.\\`M-RE
4c6c0 54 27 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 T'.is.bound.to.`transient-push-b
4c6e0 75 74 74 6f 6e 27 2c 20 69 6e 73 74 65 61 64 20 6f 66 0a 5c 5c 60 52 45 54 27 2c 20 62 65 63 61 utton',.instead.of.\\`RET',.beca
4c700 75 73 65 20 69 66 20 61 20 74 72 61 6e 73 69 65 6e 74 20 61 6c 6c 6f 77 73 20 74 68 65 20 69 6e use.if.a.transient.allows.the.in
4c720 76 6f 63 61 74 69 6f 6e 20 6f 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 2c 0a 74 68 65 6e 20 69 vocation.of.non-suffixes,.then.i
4c740 74 20 69 73 20 6c 69 6b 65 6c 79 2c 20 74 68 61 74 20 79 6f 75 20 77 6f 75 6c 64 20 77 61 6e 74 t.is.likely,.that.you.would.want
4c760 20 5c 5c 60 52 45 54 27 20 74 6f 20 64 6f 20 77 68 61 74 20 69 74 20 77 6f 75 6c 64 20 64 6f 0a .\\`RET'.to.do.what.it.would.do.
4c780 69 66 20 6e 6f 20 74 72 61 6e 73 69 65 6e 74 20 77 65 72 65 20 61 63 74 69 76 65 2e 22 0a 20 20 if.no.transient.were.active."...
4c7a0 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 :package-version.'(transient..."
4c7c0 30 2e 37 2e 38 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 0.7.8")...:group.'transient...:t
4c7e0 79 70 65 20 27 28 63 68 6f 69 63 65 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 45 6e 61 62 6c 65 ype.'(choice.(const.:tag."Enable
4c800 20 6e 61 76 69 67 61 74 69 6f 6e 20 61 6e 64 20 65 63 68 6f 20 73 75 6d 6d 61 72 79 22 20 76 65 .navigation.and.echo.summary".ve
4c820 72 62 6f 73 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 3a rbose)..................(const.:
4c840 74 61 67 20 22 45 6e 61 62 6c 65 20 6e 61 76 69 67 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 22 tag."Enable.navigation.commands"
4c860 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 3a 74 61 67 .t)..................(const.:tag
4c880 20 22 44 69 73 61 62 6c 65 20 6e 61 76 69 67 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 22 20 6e ."Disable.navigation.commands".n
4c8a0 69 6c 29 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 il)))..(defcustom.transient-disp
4c8c0 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 0a 20 20 27 28 64 69 73 70 6c 61 79 2d 62 75 lay-buffer-action...'(display-bu
4c8e0 66 66 65 72 2d 69 6e 2d 73 69 64 65 2d 77 69 6e 64 6f 77 0a 20 20 20 20 28 73 69 64 65 20 2e 20 ffer-in-side-window.....(side...
4c900 62 6f 74 74 6f 6d 29 0a 20 20 20 20 28 64 65 64 69 63 61 74 65 64 20 2e 20 74 29 0a 20 20 20 20 bottom).....(dedicated...t).....
4c920 28 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 20 2e 20 74 29 29 0a 20 20 22 54 68 (inhibit-same-window...t))..."Th
4c940 65 20 61 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 74 72 61 6e 73 69 65 e.action.used.to.display.transie
4c960 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 54 68 65 20 74 72 61 6e 73 69 65 6e 74 nt's.menu.buffer...The.transient
4c980 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 69 6e 20 61 20 77 .menu.buffer.is.displayed.in.a.w
4c9a0 69 6e 64 6f 77 20 75 73 69 6e 67 0a 0a 20 20 28 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 20 42 indow.using....(display-buffer.B
4c9c0 55 46 46 45 52 20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 UFFER.transient-display-buffer-a
4c9e0 63 74 69 6f 6e 29 0a 0a 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 74 69 6f 6e ction)..The.value.of.this.option
4ca00 20 68 61 73 20 74 68 65 20 66 6f 72 6d 20 28 46 55 4e 43 54 49 4f 4e 20 2e 20 41 4c 49 53 54 29 .has.the.form.(FUNCTION...ALIST)
4ca20 2c 0a 77 68 65 72 65 20 46 55 4e 43 54 49 4f 4e 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 6f ,.where.FUNCTION.is.a.function.o
4ca40 72 20 61 20 6c 69 73 74 20 6f 66 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 45 61 63 68 20 73 75 63 r.a.list.of.functions...Each.suc
4ca60 68 0a 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 63 63 65 70 74 20 74 77 6f 20 61 72 67 h.function.should.accept.two.arg
4ca80 75 6d 65 6e 74 73 3a 20 61 20 62 75 66 66 65 72 20 74 6f 20 64 69 73 70 6c 61 79 20 61 6e 64 20 uments:.a.buffer.to.display.and.
4caa0 61 6e 0a 61 6c 69 73 74 20 6f 66 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 20 61 73 20 41 4c 49 an.alist.of.the.same.form.as.ALI
4cac0 53 54 2e 20 20 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 65 6c 69 73 70 29 43 68 6f 6f 73 ST...See.info.node.`(elisp)Choos
4cae0 69 6e 67 0a 57 69 6e 64 6f 77 27 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 0a 54 68 65 20 64 65 ing.Window'.for.details...The.de
4cb00 66 61 75 6c 74 20 69 73 3a 0a 0a 20 20 28 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 69 6e 2d fault.is:....(display-buffer-in-
4cb20 73 69 64 65 2d 77 69 6e 64 6f 77 0a 20 20 20 20 28 73 69 64 65 20 2e 20 62 6f 74 74 6f 6d 29 0a side-window.....(side...bottom).
4cb40 20 20 20 20 28 64 65 64 69 63 61 74 65 64 20 2e 20 74 29 0a 20 20 20 20 28 69 6e 68 69 62 69 74 ....(dedicated...t).....(inhibit
4cb60 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 20 2e 20 74 29 29 0a 0a 54 68 69 73 20 64 69 73 70 6c 61 79 -same-window...t))..This.display
4cb80 73 20 74 68 65 20 77 69 6e 64 6f 77 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 20 74 68 s.the.window.at.the.bottom.of.th
4cba0 65 20 73 65 6c 65 63 74 65 64 20 66 72 61 6d 65 2e 0a 46 6f 72 20 61 6c 74 65 72 6e 61 74 69 76 e.selected.frame..For.alternativ
4cbc0 65 73 20 73 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 65 6c 69 73 70 29 44 69 73 70 6c 61 79 es.see.info.node.`(elisp)Display
4cbe0 20 41 63 74 69 6f 6e 20 46 75 6e 63 74 69 6f 6e 73 27 0a 61 6e 64 20 69 6e 66 6f 20 6e 6f 64 65 .Action.Functions'.and.info.node
4cc00 20 60 28 65 6c 69 73 70 29 42 75 66 66 65 72 20 44 69 73 70 6c 61 79 20 41 63 74 69 6f 6e 20 41 .`(elisp)Buffer.Display.Action.A
4cc20 6c 69 73 74 73 27 2e 0a 0a 57 68 65 6e 20 79 6f 75 20 73 77 69 74 63 68 20 74 6f 20 61 20 64 69 lists'...When.you.switch.to.a.di
4cc40 66 66 65 72 65 6e 74 20 41 43 54 49 4f 4e 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20 6b 65 65 70 20 fferent.ACTION,.you.should.keep.
4cc60 74 68 65 20 41 4c 49 53 54 0a 65 6e 74 72 69 65 73 20 66 6f 72 20 60 64 65 64 69 63 61 74 65 64 the.ALIST.entries.for.`dedicated
4cc80 27 20 61 6e 64 20 60 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 27 20 69 6e 20 6d '.and.`inhibit-same-window'.in.m
4cca0 6f 73 74 20 63 61 73 65 73 2e 0a 44 6f 20 6e 6f 74 20 64 72 6f 70 20 74 68 65 6d 20 62 65 63 61 ost.cases..Do.not.drop.them.beca
4ccc0 75 73 65 20 79 6f 75 20 61 72 65 20 75 6e 73 75 72 65 20 77 68 65 74 68 65 72 20 74 68 65 79 20 use.you.are.unsure.whether.they.
4cce0 61 72 65 20 6e 65 65 64 65 64 3b 0a 69 66 20 79 6f 75 20 61 72 65 20 75 6e 73 75 72 65 2c 20 74 are.needed;.if.you.are.unsure,.t
4cd00 68 65 6e 20 6b 65 65 70 20 74 68 65 6d 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 62 75 hen.keep.them...Note.that.the.bu
4cd20 66 66 65 72 20 74 68 61 74 20 77 61 73 20 63 75 72 72 65 6e 74 20 62 65 66 6f 72 65 20 74 68 65 ffer.that.was.current.before.the
4cd40 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 0a 69 73 20 73 68 6f 77 6e 20 73 68 6f 75 6c .transient.buffer.is.shown.shoul
4cd60 64 20 72 65 6d 61 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2e 20 20 4d 61 d.remain.the.current.buffer...Ma
4cd80 6e 79 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 61 63 74 20 6f 6e 20 74 68 65 20 74 68 ny.suffix.commands.act.on.the.th
4cda0 69 6e 67 20 61 74 20 70 6f 69 6e 74 2c 20 69 66 20 61 70 70 72 6f 70 72 69 61 74 65 2c 20 61 6e ing.at.point,.if.appropriate,.an
4cdc0 64 20 69 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 62 75 66 66 65 72 20 62 65 63 61 6d 65 d.if.the.transient.buffer.became
4cde0 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2c 20 74 68 65 6e 20 74 68 61 74 20 77 .the.current.buffer,.then.that.w
4ce00 6f 75 6c 64 20 63 68 61 6e 67 65 20 77 68 61 74 20 69 73 0a 61 74 20 70 6f 69 6e 74 2e 20 20 54 ould.change.what.is.at.point...T
4ce20 6f 20 74 68 61 74 20 65 66 66 65 63 74 20 60 69 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 o.that.effect.`inhibit-same-wind
4ce40 6f 77 27 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 74 68 65 0a 73 65 6c 65 63 74 65 64 20 77 69 ow'.ensures.that.the.selected.wi
4ce60 6e 64 6f 77 20 69 73 20 6e 6f 74 20 75 73 65 64 20 74 6f 20 73 68 6f 77 20 74 68 65 20 74 72 61 ndow.is.not.used.to.show.the.tra
4ce80 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 0a 0a 54 68 65 20 75 73 65 20 6f 66 20 61 20 68 6f 72 nsient.buffer...The.use.of.a.hor
4cea0 69 7a 6f 6e 74 61 6c 20 73 70 6c 69 74 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 6d 65 6e izontal.split.to.display.the.men
4cec0 75 20 77 69 6e 64 6f 77 20 63 61 6e 20 6c 65 61 64 0a 74 6f 20 69 6e 63 6f 6d 70 61 74 69 62 69 u.window.can.lead.to.incompatibi
4cee0 6c 69 74 69 65 73 20 61 6e 64 20 69 73 20 74 68 75 73 20 64 69 73 63 6f 75 72 61 67 65 64 2e 20 lities.and.is.thus.discouraged..
4cf00 20 54 72 61 6e 73 69 65 6e 74 20 74 72 69 65 73 20 74 6f 0a 6d 69 74 69 67 61 74 65 20 73 75 63 .Transient.tries.to.mitigate.suc
4cf20 68 20 69 73 73 75 65 20 62 75 74 20 63 61 6e 6e 6f 74 20 70 72 6f 61 63 74 69 76 65 6c 79 20 64 h.issue.but.cannot.proactively.d
4cf40 65 61 6c 20 77 69 74 68 20 61 6c 6c 20 70 6f 73 73 69 62 6c 65 0a 63 6f 6e 66 69 67 75 72 61 74 eal.with.all.possible.configurat
4cf60 69 6f 6e 73 20 61 6e 64 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 6f 66 20 74 68 69 72 64 2d 70 ions.and.combinations.of.third-p
4cf80 61 72 74 79 20 70 61 63 6b 61 67 65 73 2e 0a 0a 49 74 20 6d 61 79 20 62 65 20 70 6f 73 73 69 62 arty.packages...It.may.be.possib
4cfa0 6c 65 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 77 69 6e 64 6f 77 20 69 6e 20 61 6e 6f 74 le.to.display.the.window.in.anot
4cfc0 68 65 72 20 66 72 61 6d 65 2c 20 62 75 74 0a 77 68 65 74 68 65 72 20 74 68 61 74 20 77 6f 72 6b her.frame,.but.whether.that.work
4cfe0 73 20 69 6e 20 70 72 61 63 74 69 63 65 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 77 69 6e s.in.practice.depends.on.the.win
4d000 64 6f 77 2d 6d 61 6e 61 67 65 72 2e 0a 49 66 20 74 68 65 20 77 69 6e 64 6f 77 20 6d 61 6e 61 67 dow-manager..If.the.window.manag
4d020 65 72 20 73 65 6c 65 63 74 73 20 74 68 65 20 6e 65 77 20 77 69 6e 64 6f 77 20 28 45 6d 61 63 73 er.selects.the.new.window.(Emacs
4d040 20 66 72 61 6d 65 29 2c 0a 74 68 65 6e 20 74 68 61 74 20 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 .frame),.then.that.unfortunately
4d060 20 63 68 61 6e 67 65 73 20 77 68 69 63 68 20 62 75 66 66 65 72 20 69 73 20 63 75 72 72 65 6e 74 .changes.which.buffer.is.current
4d080 2e 0a 0a 49 66 20 79 6f 75 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 ...If.you.change.the.value.of.th
4d0a0 69 73 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 79 6f 75 20 6d 69 67 68 74 20 61 6c 73 6f 0a 77 is.option,.then.you.might.also.w
4d0c0 61 6e 74 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 60 74 72 61 6e ant.to.change.the.value.of.`tran
4d0e0 73 69 65 6e 74 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 27 2e 22 0a 20 20 3a 70 61 63 sient-mode-line-format'."...:pac
4d100 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 37 2e kage-version.'(transient..."0.7.
4d120 35 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 5")...:group.'transient...:type.
4d140 27 28 63 6f 6e 73 20 28 63 68 6f 69 63 65 20 66 75 6e 63 74 69 6f 6e 20 28 72 65 70 65 61 74 20 '(cons.(choice.function.(repeat.
4d160 3a 74 61 67 20 22 46 75 6e 63 74 69 6f 6e 73 22 20 66 75 6e 63 74 69 6f 6e 29 29 0a 20 20 20 20 :tag."Functions".function)).....
4d180 20 20 20 20 20 20 20 20 20 20 20 61 6c 69 73 74 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 ...........alist))..(defcustom.t
4d1a0 72 61 6e 73 69 65 6e 74 2d 6d 69 6e 69 6d 61 6c 2d 66 72 61 6d 65 2d 77 69 64 74 68 20 38 33 0a ransient-minimal-frame-width.83.
4d1c0 20 20 22 4d 69 6e 69 6d 61 6c 20 77 69 64 74 68 20 6f 66 20 64 65 64 69 63 61 74 65 64 20 66 72 .."Minimal.width.of.dedicated.fr
4d1e0 61 6d 65 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 ame.used.to.display.transient.me
4d200 6e 75 2e 0a 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 69 66 20 74 68 65 20 74 72 61 nu..This.is.only.used.if.the.tra
4d220 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 61 63 74 75 61 6c 6c 79 20 64 69 73 70 6c 61 79 65 nsient.menu.is.actually.displaye
4d240 64 20 69 6e 20 61 0a 64 65 64 69 63 61 74 65 64 20 66 72 61 6d 65 20 28 73 65 65 20 60 74 72 61 d.in.a.dedicated.frame.(see.`tra
4d260 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 27 29 2e 20 nsient-display-buffer-action')..
4d280 20 54 68 65 20 76 61 6c 75 65 0a 69 73 20 69 6e 20 63 68 61 72 61 63 74 65 72 73 2e 22 0a 20 20 .The.value.is.in.characters."...
4d2a0 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 :package-version.'(transient..."
4d2c0 30 2e 38 2e 31 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 0.8.1")...:group.'transient...:t
4d2e0 79 70 65 20 27 6e 61 74 6e 75 6d 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 ype.'natnum)..(defcustom.transie
4d300 6e 74 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 20 27 6c 69 6e 65 0a 20 20 22 54 68 65 nt-mode-line-format.'line..."The
4d320 20 6d 6f 64 65 2d 6c 69 6e 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 27 .mode-line.format.for.transient'
4d340 73 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 49 66 20 6e 69 6c 2c 20 74 68 65 6e 20 74 68 65 s.menu.buffer...If.nil,.then.the
4d360 20 62 75 66 66 65 72 20 68 61 73 20 6e 6f 20 6d 6f 64 65 2d 6c 69 6e 65 2e 20 20 49 66 20 74 68 .buffer.has.no.mode-line...If.th
4d380 65 20 62 75 66 66 65 72 20 69 73 20 6e 6f 74 0a 64 69 73 70 6c 61 79 65 64 20 72 69 67 68 74 20 e.buffer.is.not.displayed.right.
4d3a0 61 62 6f 76 65 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2c 20 74 68 65 6e 20 74 68 69 73 20 70 above.the.echo.area,.then.this.p
4d3c0 72 6f 62 61 62 6c 79 20 69 73 20 6e 6f 74 0a 61 20 67 6f 6f 64 20 76 61 6c 75 65 2e 0a 0a 49 66 robably.is.not.a.good.value...If
4d3e0 20 60 6c 69 6e 65 27 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 20 6f 72 20 61 20 6e 61 74 75 72 .`line'.(the.default).or.a.natur
4d400 61 6c 20 6e 75 6d 62 65 72 2c 20 74 68 65 6e 20 74 68 65 20 62 75 66 66 65 72 20 68 61 73 20 6e al.number,.then.the.buffer.has.n
4d420 6f 0a 6d 6f 64 65 2d 6c 69 6e 65 2c 20 62 75 74 20 61 20 6c 69 6e 65 20 69 73 20 64 72 61 77 6e o.mode-line,.but.a.line.is.drawn
4d440 20 69 6e 20 69 74 73 20 70 6c 61 63 65 2e 20 20 49 66 20 61 20 6e 75 6d 62 65 72 20 69 73 20 75 .in.its.place...If.a.number.is.u
4d460 73 65 64 2c 0a 74 68 61 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 74 68 69 63 6b 6e 65 73 sed,.that.specifies.the.thicknes
4d480 73 20 6f 66 20 74 68 65 20 6c 69 6e 65 2e 20 20 4f 6e 20 74 65 72 6d 63 61 70 20 66 72 61 6d 65 s.of.the.line...On.termcap.frame
4d4a0 73 20 77 65 0a 63 61 6e 6e 6f 74 20 64 72 61 77 20 6c 69 6e 65 73 2c 20 73 6f 20 74 68 65 72 65 s.we.cannot.draw.lines,.so.there
4d4c0 20 60 6c 69 6e 65 27 20 61 6e 64 20 6e 75 6d 62 65 72 73 20 61 72 65 20 73 79 6e 6f 6e 79 6d 73 .`line'.and.numbers.are.synonyms
4d4e0 20 66 6f 72 20 6e 69 6c 2e 0a 0a 54 68 65 20 63 6f 6c 6f 72 20 6f 66 20 74 68 65 20 6c 69 6e 65 .for.nil...The.color.of.the.line
4d500 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e 64 69 63 61 74 65 20 69 66 20 6e 6f 6e 2d 73 75 66 66 .is.used.to.indicate.if.non-suff
4d520 69 78 65 73 20 61 72 65 0a 61 6c 6c 6f 77 65 64 20 61 6e 64 20 77 68 65 74 68 65 72 20 74 68 65 ixes.are.allowed.and.whether.the
4d540 79 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 54 68 65 20 66 6f 72 65 67 y.exit.the.transient...The.foreg
4d560 72 6f 75 6e 64 0a 63 6f 6c 6f 72 20 6f 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f round.color.of.`transient-key-no
4d580 6f 70 27 20 28 69 66 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 61 72 65 20 64 69 73 61 6c 6c 6f op'.(if.non-suffixes.are.disallo
4d5a0 77 65 64 29 2c 0a 60 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 79 27 20 28 69 66 20 61 wed),.`transient-key-stay'.(if.a
4d5c0 6c 6c 6f 77 65 64 20 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 79 73 20 61 63 74 69 76 llowed.and.transient.stays.activ
4d5e0 65 29 2c 20 6f 72 0a 60 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 65 78 69 74 27 20 28 69 66 20 e),.or.`transient-key-exit'.(if.
4d600 61 6c 6c 6f 77 65 64 20 61 6e 64 20 74 68 65 79 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 allowed.and.they.exit.the.transi
4d620 65 6e 74 29 20 69 73 0a 75 73 65 64 20 74 6f 20 64 72 61 77 20 74 68 65 20 6c 69 6e 65 2e 0a 0a ent).is.used.to.draw.the.line...
4d640 4f 74 68 65 72 77 69 73 65 20 74 68 69 73 20 63 61 6e 20 62 65 20 61 6e 79 20 6d 6f 64 65 2d 6c Otherwise.this.can.be.any.mode-l
4d660 69 6e 65 20 66 6f 72 6d 61 74 2e 0a 53 65 65 20 60 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 ine.format..See.`mode-line-forma
4d680 74 27 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 t'.for.details."...:package-vers
4d6a0 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 32 2e 30 22 29 0a 20 20 3a 67 72 ion.'(transient..."0.2.0")...:gr
4d6c0 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 28 63 68 6f 69 63 65 20 oup.'transient...:type.'(choice.
4d6e0 28 63 6f 6e 73 74 20 20 3a 74 61 67 20 22 48 69 64 65 20 6d 6f 64 65 2d 6c 69 6e 65 22 20 6e 69 (const..:tag."Hide.mode-line".ni
4d700 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 20 3a 74 61 67 l)..................(const..:tag
4d720 20 22 53 75 62 73 74 69 74 75 74 65 20 74 68 69 6e 20 6c 69 6e 65 22 20 6c 69 6e 65 29 0a 20 20 ."Substitute.thin.line".line)...
4d740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 75 6d 62 65 72 20 3a 74 61 67 20 22 53 75 62 ...............(number.:tag."Sub
4d760 73 74 69 74 75 74 65 20 6c 69 6e 65 20 77 69 74 68 20 74 68 69 63 6b 6e 65 73 73 22 29 0a 20 20 stitute.line.with.thickness")...
4d780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 20 3a 74 61 67 20 22 4e 61 6d ...............(const..:tag."Nam
4d7a0 65 20 6f 66 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 22 0a 20 20 20 20 20 20 20 20 20 20 20 e.of.prefix.command"............
4d7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 22 25 65 22 20 6d 6f 64 65 2d 6c 69 6e 65 2d 66 72 ..............("%e".mode-line-fr
4d7e0 6f 6e 74 2d 73 70 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 ont-space.......................
4d800 20 20 20 20 6d 6f 64 65 2d 6c 69 6e 65 2d 62 75 66 66 65 72 2d 69 64 65 6e 74 69 66 69 63 61 74 ....mode-line-buffer-identificat
4d820 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 78 70 20 20 20 3a ion))..................(sexp...:
4d840 74 61 67 20 22 43 75 73 74 6f 6d 20 6d 6f 64 65 2d 6c 69 6e 65 20 66 6f 72 6d 61 74 22 29 29 29 tag."Custom.mode-line.format")))
4d860 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 63 6f 6d 6d ..(defcustom.transient-show-comm
4d880 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 70 65 on-commands.nil..."Whether.to.pe
4d8a0 72 6d 61 6e 65 6e 74 6c 79 20 73 68 6f 77 20 63 6f 6d 6d 6f 6e 20 73 75 66 66 69 78 20 63 6f 6d rmanently.show.common.suffix.com
4d8c0 6d 61 6e 64 73 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 73 2e 0a 0a 42 79 20 64 65 mands.in.transient.menus...By.de
4d8e0 66 61 75 6c 74 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6f 6e 6c 79 20 74 65 fault.these.commands.are.only.te
4d900 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 6e 20 61 66 74 65 72 20 74 79 70 69 6e 67 20 74 68 65 mporarily.shown.after.typing.the
4d920 69 72 0a 73 68 61 72 65 64 20 70 72 65 66 69 78 20 6b 65 79 20 5c 0a 5c 5c 3c 74 72 61 6e 73 69 ir.shared.prefix.key.\.\\<transi
4d940 65 6e 74 2d 2d 64 6f 63 73 74 72 2d 68 69 6e 74 2d 31 3e 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d ent--docstr-hint-1>\\[transient-
4d960 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 5d 2c 20 5c 0a 77 68 69 6c 65 20 common-command-prefix],.\.while.
4d980 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 61 63 74 69 76 65 2e 20 20 57 68 65 a.transient.menu.is.active...Whe
4d9a0 6e 20 74 68 65 20 76 61 6c 75 65 0a 6f 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f n.the.value.of.this.option.is.no
4d9c0 6e 2d 6e 69 6c 2c 20 74 68 65 6e 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 70 n-nil,.then.these.commands.are.p
4d9e0 65 72 6d 61 6e 65 6e 74 6c 79 20 73 68 6f 77 6e 2e 0a 54 6f 20 74 6f 67 67 6c 65 20 74 68 65 20 ermanently.shown..To.toggle.the.
4da00 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 45 6d 61 63 73 20 73 65 73 73 value.for.the.current.Emacs.sess
4da20 69 6f 6e 20 6f 6e 6c 79 20 74 79 70 65 20 5c 0a 5c 5c 3c 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f ion.only.type.\.\\<transient--do
4da40 63 73 74 72 2d 68 69 6e 74 2d 32 3e 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d cstr-hint-2>\\[transient-toggle-
4da60 63 6f 6d 6d 6f 6e 5d 20 77 68 69 6c 65 0a 61 6e 79 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 common].while.any.transient.menu
4da80 20 69 73 20 61 63 74 69 76 65 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 .is.active."...:package-version.
4daa0 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 '(transient..."0.1.0")...:group.
4dac0 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 'transient...:type.'boolean)..(d
4dae0 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 64 75 72 69 6e 67 2d 6d efcustom.transient-show-during-m
4db00 69 6e 69 62 75 66 66 65 72 2d 72 65 61 64 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f inibuffer-read.nil..."Whether.to
4db20 20 73 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 77 68 69 6c 65 20 72 .show.the.transient.menu.while.r
4db40 65 61 64 69 6e 67 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 0a 54 68 69 73 20 eading.in.the.minibuffer...This.
4db60 69 73 20 6f 6e 6c 79 20 72 65 6c 65 76 61 6e 74 20 74 6f 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 is.only.relevant.to.commands.tha
4db80 74 20 64 6f 20 6e 6f 74 20 63 6c 6f 73 65 20 74 68 65 20 6d 65 6e 75 2c 20 73 75 63 68 20 61 73 t.do.not.close.the.menu,.such.as
4dba0 0a 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 73 65 74 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e .commands.that.set.infix.argumen
4dbc0 74 73 2e 20 20 49 66 20 61 20 63 6f 6d 6d 61 6e 64 20 65 78 69 74 73 20 74 68 65 20 6d 65 6e 75 ts...If.a.command.exits.the.menu
4dbe0 2c 20 61 6e 64 0a 75 73 65 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 74 68 65 6e 20 ,.and.uses.the.minibuffer,.then.
4dc00 74 68 65 20 6d 65 6e 75 20 69 73 20 61 6c 77 61 79 73 20 63 6c 6f 73 65 64 20 62 65 66 6f 72 65 the.menu.is.always.closed.before
4dc20 20 74 68 65 0a 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 65 6e 74 65 72 65 64 2c 20 69 72 72 65 .the.minibuffer.is.entered,.irre
4dc40 73 70 65 63 74 69 76 65 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6f 70 spective.of.the.value.of.this.op
4dc60 74 69 6f 6e 2e 0a 0a 57 68 65 6e 20 6e 69 6c 20 28 74 68 65 20 64 65 66 61 75 6c 74 29 2c 20 68 tion...When.nil.(the.default),.h
4dc80 69 64 65 20 74 68 65 20 6d 65 6e 75 20 77 68 69 6c 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 ide.the.menu.while.the.minibuffe
4dca0 72 20 69 73 20 69 6e 20 75 73 65 2e 0a 57 68 65 6e 20 74 2c 20 6b 65 65 70 20 73 68 6f 77 69 6e r.is.in.use..When.t,.keep.showin
4dcc0 67 20 74 68 65 20 6d 65 6e 75 2c 20 62 75 74 20 61 6c 6c 6f 77 20 66 6f 72 20 74 68 65 20 6d 65 g.the.menu,.but.allow.for.the.me
4dce0 6e 75 20 77 69 6e 64 6f 77 20 74 6f 20 62 65 0a 72 65 73 69 7a 65 64 2c 20 74 6f 20 65 6e 73 75 nu.window.to.be.resized,.to.ensu
4dd00 72 65 20 74 68 61 74 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 73 20 63 61 re.that.completion.candidates.ca
4dd20 6e 20 62 65 20 64 69 73 70 6c 61 79 65 64 2e 0a 0a 57 68 65 6e 20 60 66 69 78 65 64 27 2c 20 6b n.be.displayed...When.`fixed',.k
4dd40 65 65 70 20 73 68 6f 77 69 6e 67 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 20 70 72 65 76 65 6e 74 eep.showing.the.menu.and.prevent
4dd60 20 69 74 20 66 72 6f 6d 20 62 65 69 6e 67 20 72 65 73 69 7a 65 64 2c 0a 77 68 69 63 68 20 6d 61 .it.from.being.resized,.which.ma
4dd80 79 20 6d 61 6b 65 20 69 74 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 69 73 70 6c 61 79 20 y.make.it.impossible.to.display.
4dda0 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 2e 20 20 49 66 0a 74 the.completion.candidates...If.t
4ddc0 68 61 74 20 65 76 65 72 20 68 61 70 70 65 6e 73 20 66 6f 72 20 79 6f 75 2c 20 63 6f 6e 73 69 64 hat.ever.happens.for.you,.consid
4dde0 65 72 20 75 73 69 6e 67 20 74 20 6f 72 20 61 6e 20 69 6e 74 65 67 65 72 2c 20 61 73 20 64 65 73 er.using.t.or.an.integer,.as.des
4de00 63 72 69 62 65 64 0a 62 65 6c 6f 77 2e 0a 0a 49 66 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 60 cribed.below...If.the.value.is.`
4de20 66 69 78 65 64 27 20 61 6e 64 20 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 75 73 65 73 20 fixed'.and.the.menu.window.uses.
4de40 74 68 65 20 66 75 6c 6c 20 68 65 69 67 68 74 20 6f 66 20 69 74 73 0a 66 72 61 6d 65 2c 20 74 68 the.full.height.of.its.frame,.th
4de60 65 6e 20 74 68 65 20 66 6f 72 6d 65 72 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 72 65 73 en.the.former.is.ignored.and.res
4de80 69 7a 69 6e 67 20 69 73 20 61 6c 6c 6f 77 65 64 20 61 6e 79 77 61 79 2e 20 20 54 68 69 73 0a 69 izing.is.allowed.anyway...This.i
4dea0 73 20 6e 65 63 65 73 73 61 72 79 20 62 65 63 61 75 73 65 20 69 6e 64 69 76 69 64 75 61 6c 20 6d s.necessary.because.individual.m
4dec0 65 6e 75 73 20 6d 61 79 20 75 73 65 20 75 6e 75 73 75 61 6c 20 64 69 73 70 6c 61 79 20 61 63 74 enus.may.use.unusual.display.act
4dee0 69 6f 6e 73 0a 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 60 74 72 61 6e 73 69 ions.different.from.what.`transi
4df00 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 27 20 73 70 65 63 69 ent-display-buffer-action'.speci
4df20 66 69 65 73 20 28 6c 69 6b 65 6c 79 0a 74 6f 20 64 69 73 70 6c 61 79 20 74 68 61 74 20 6d 65 6e fies.(likely.to.display.that.men
4df40 75 20 69 6e 20 61 20 73 69 64 65 2d 77 69 6e 64 6f 77 29 2e 0a 0a 57 68 65 6e 20 75 73 69 6e 67 u.in.a.side-window)...When.using
4df60 20 61 20 74 68 69 72 64 2d 70 61 72 74 79 20 6d 6f 64 65 2c 20 77 68 69 63 68 20 61 75 74 6f 6d .a.third-party.mode,.which.autom
4df80 61 74 69 63 61 6c 6c 79 20 72 65 73 69 7a 65 73 20 77 69 6e 64 6f 77 73 0a 5c 28 65 2e 67 2e 2c atically.resizes.windows.\(e.g.,
4dfa0 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 62 61 6c 61 6e 63 65 2d 77 69 6e 64 6f 77 73 27 20 6f 6e .by.calling.`balance-windows'.on
4dfc0 20 60 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 27 29 2c 20 74 68 65 6e 0a 60 66 69 78 .`post-command-hook'),.then.`fix
4dfe0 65 64 27 20 28 6f 72 20 6e 69 6c 29 20 69 73 20 6c 69 6b 65 6c 79 20 61 20 62 65 74 74 65 72 20 ed'.(or.nil).is.likely.a.better.
4e000 63 68 6f 69 63 65 20 74 68 61 6e 20 74 2e 0a 0a 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 61 6c choice.than.t...The.value.can.al
4e020 73 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 so.be.an.integer,.in.which.case.
4e040 74 68 65 20 62 65 68 61 76 69 6f 72 20 64 65 70 65 6e 64 73 20 6f 6e 0a 77 68 65 74 68 65 72 20 the.behavior.depends.on.whether.
4e060 61 74 20 6c 65 61 73 74 20 74 68 61 74 20 6d 61 6e 79 20 6c 69 6e 65 73 20 61 72 65 20 6c 65 66 at.least.that.many.lines.are.lef
4e080 74 20 74 6f 20 64 69 73 70 6c 61 79 20 77 69 6e 64 6f 77 73 20 6f 74 68 65 72 20 74 68 61 6e 0a t.to.display.windows.other.than.
4e0a0 74 68 65 20 6d 65 6e 75 20 77 69 6e 64 6f 77 2e 20 20 49 66 20 74 68 61 74 20 69 73 20 74 68 65 the.menu.window...If.that.is.the
4e0c0 20 63 61 73 65 2c 20 64 69 73 70 6c 61 79 20 74 68 65 20 6d 65 6e 75 20 61 6e 64 20 70 72 65 73 .case,.display.the.menu.and.pres
4e0e0 65 72 76 65 20 74 68 65 0a 73 69 7a 65 20 6f 66 20 74 68 61 74 20 77 69 6e 64 6f 77 2e 20 20 4f erve.the.size.of.that.window...O
4e100 74 68 65 72 77 69 73 65 2c 20 61 6c 6c 6f 77 20 72 65 73 69 7a 69 6e 67 20 74 68 65 20 6d 65 6e therwise,.allow.resizing.the.men
4e120 75 20 77 69 6e 64 6f 77 20 69 66 20 74 68 65 0a 6e 75 6d 62 65 72 20 69 73 20 70 6f 73 69 74 69 u.window.if.the.number.is.positi
4e140 76 65 2c 20 6f 72 20 68 69 64 65 20 74 68 65 20 6d 65 6e 75 20 69 66 20 69 74 20 69 73 20 6e 65 ve,.or.hide.the.menu.if.it.is.ne
4e160 67 61 74 69 76 65 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 gative."...:package-version.'(tr
4e180 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 38 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 ansient..."0.8.0")...:group.'tra
4e1a0 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 28 63 68 6f 69 63 65 0a 20 20 20 20 20 20 20 20 nsient...:type.'(choice.........
4e1c0 20 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 48 69 64 65 20 6d 65 6e 75 22 20 6e 69 6c 29 0a 20 ..(const.:tag."Hide.menu".nil)..
4e1e0 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 53 68 6f 77 20 6d 65 6e 75 20 .........(const.:tag."Show.menu.
4e200 61 6e 64 20 70 72 65 73 65 72 76 65 20 73 69 7a 65 22 20 66 69 78 65 64 29 0a 20 20 20 20 20 20 and.preserve.size".fixed).......
4e220 20 20 20 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 53 68 6f 77 20 6d 65 6e 75 20 61 6e 64 20 61 ....(const.:tag."Show.menu.and.a
4e240 6c 6c 6f 77 20 72 65 73 69 7a 69 6e 67 22 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 28 6e 61 74 llow.resizing".t)...........(nat
4e260 6e 75 6d 20 3a 74 61 67 20 22 53 68 6f 77 20 6d 65 6e 75 2c 20 61 6c 6c 6f 77 20 72 65 73 69 7a num.:tag."Show.menu,.allow.resiz
4e280 69 6e 67 20 69 66 20 6c 65 73 73 20 74 68 61 6e 20 4e 20 6c 69 6e 65 73 20 6c 65 66 74 22 0a 20 ing.if.less.than.N.lines.left"..
4e2a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 66 6f 72 6d 61 74 20 22 5c 6e 20 20 20 25 .................:format."\n...%
4e2c0 74 3a 20 25 76 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 76 61 6c 75 65 20 t:.%v"...................:value.
4e2e0 32 30 29 0a 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 65 67 65 72 20 3a 74 61 67 20 22 53 68 6f 20)...........(integer.:tag."Sho
4e300 77 20 6d 65 6e 75 2c 20 65 78 63 65 70 74 20 69 66 20 6c 65 73 73 20 74 68 61 6e 20 4e 20 6c 69 w.menu,.except.if.less.than.N.li
4e320 6e 65 73 20 6c 65 66 74 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 66 6f nes.left"....................:fo
4e340 72 6d 61 74 20 22 5c 6e 20 20 20 25 74 3a 20 25 76 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 rmat."\n...%t:.%v"..............
4e360 20 20 20 20 20 20 3a 76 61 6c 75 65 20 2d 32 30 29 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 ......:value.-20)))..(defcustom.
4e380 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 64 6f 63 73 74 72 69 6e 67 2d 66 6f 72 6d 61 74 20 transient-show-docstring-format.
4e3a0 22 25 73 22 0a 20 20 22 48 6f 77 20 74 6f 20 64 69 73 70 6c 61 79 20 73 75 66 66 69 78 20 64 6f "%s"..."How.to.display.suffix.do
4e3c0 63 73 74 72 69 6e 67 73 2e 0a 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 20 60 74 72 61 6e 73 69 65 6e cstrings...The.command.`transien
4e3e0 74 2d 74 6f 67 67 6c 65 2d 64 6f 63 73 74 72 69 6e 67 73 27 20 74 6f 67 67 6c 65 73 20 62 65 74 t-toggle-docstrings'.toggles.bet
4e400 77 65 65 6e 20 73 68 6f 77 69 6e 67 20 73 75 66 66 69 78 0a 64 65 73 63 72 69 70 74 69 6f 6e 73 ween.showing.suffix.descriptions
4e420 20 61 73 20 75 73 75 61 6c 2c 20 61 6e 64 20 69 6e 73 74 65 61 64 20 6f 72 20 61 64 64 69 74 69 .as.usual,.and.instead.or.additi
4e440 6f 6e 61 6c 6c 79 20 64 69 73 70 6c 61 79 69 6e 67 20 74 68 65 20 73 75 66 66 69 78 0a 64 6f 63 onally.displaying.the.suffix.doc
4e460 73 74 72 69 6e 67 73 2e 20 20 54 68 65 20 66 6f 72 6d 61 74 20 73 70 65 63 69 66 69 65 64 20 68 strings...The.format.specified.h
4e480 65 72 65 20 63 6f 6e 74 72 6f 6c 73 20 68 6f 77 20 74 68 61 74 20 69 73 20 64 6f 6e 65 2e 20 20 ere.controls.how.that.is.done...
4e4a0 25 63 20 69 73 0a 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 61 6e 64 20 25 73 20 69 73 20 %c.is.the.description.and.%s.is.
4e4c0 74 68 65 20 64 6f 63 73 74 72 69 6e 67 2e 20 20 55 73 65 20 5c 22 25 2d 31 34 63 20 25 73 5c 22 the.docstring...Use.\"%-14c.%s\"
4e4e0 20 6f 72 20 73 69 6d 69 6c 61 72 20 74 6f 0a 64 69 73 70 6c 61 79 20 62 6f 74 68 2e 0a 0a 54 68 .or.similar.to.display.both...Th
4e500 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 62 6f 75 6e 64 20 62 79 20 64 65 66 61 75 is.command.is.not.bound.by.defau
4e520 6c 74 2c 20 73 65 65 20 69 74 73 20 64 6f 63 73 74 72 69 6e 67 20 66 6f 72 20 69 6e 73 74 72 75 lt,.see.its.docstring.for.instru
4e540 63 74 69 6f 6e 73 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 ctions."...:package-version.'(tr
4e560 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 38 2e 34 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 ansient..."0.8.4")...:group.'tra
4e580 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 73 74 72 69 6e 67 29 0a 0a 28 64 65 66 63 75 73 nsient...:type.'string)..(defcus
4e5a0 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 77 69 74 68 2d 69 6e 69 74 69 61 6c 2d tom.transient-read-with-initial-
4e5c0 69 6e 70 75 74 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 75 73 65 20 74 68 65 20 input.nil..."Whether.to.use.the.
4e5e0 6c 61 73 74 20 68 69 73 74 6f 72 79 20 65 6c 65 6d 65 6e 74 20 61 73 20 69 6e 69 74 69 61 6c 20 last.history.element.as.initial.
4e600 6d 69 6e 69 62 75 66 66 65 72 20 69 6e 70 75 74 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 minibuffer.input."...:package-ve
4e620 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 32 2e 30 22 29 0a 20 20 3a rsion.'(transient..."0.2.0")...:
4e640 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 group.'transient...:type.'boolea
4e660 6e 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 n)..(defcustom.transient-highlig
4e680 68 74 2d 6d 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 73 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 ht-mismatched-keys.nil..."Whethe
4e6a0 72 20 74 6f 20 68 69 67 68 6c 69 67 68 74 20 6b 65 79 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 r.to.highlight.keys.that.do.not.
4e6c0 6d 61 74 63 68 20 74 68 65 69 72 20 61 72 67 75 6d 65 6e 74 2e 0a 0a 54 68 69 73 20 6f 6e 6c 79 match.their.argument...This.only
4e6e0 20 61 66 66 65 63 74 73 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 72 65 .affects.infix.arguments.that.re
4e700 70 72 65 73 65 6e 74 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 0a 61 72 67 75 6d 65 6e 74 73 2e 20 present.command-line.arguments..
4e720 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 .When.this.option.is.non-nil,.th
4e740 65 6e 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 0a 66 6f 72 20 69 6e 66 69 78 20 61 72 67 en.the.key.binding.for.infix.arg
4e760 75 6d 65 6e 74 20 61 72 65 20 68 69 67 68 6c 69 67 68 74 65 64 20 77 68 65 6e 20 6f 6e 6c 79 20 ument.are.highlighted.when.only.
4e780 61 20 6c 6f 6e 67 20 61 72 67 75 6d 65 6e 74 0a 5c 28 65 2e 67 2e 2c 20 5c 22 2d 2d 76 65 72 62 a.long.argument.\(e.g.,.\"--verb
4e7a0 6f 73 65 5c 22 29 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62 75 74 20 6e 6f 20 73 68 6f 72 74 ose\").is.specified.but.no.short
4e7c0 68 61 6e 64 20 28 65 2e 67 2e 2c 20 5c 22 2d 76 5c 22 29 2e 0a 49 6e 20 74 68 65 20 72 61 72 65 hand.(e.g.,.\"-v\")..In.the.rare
4e7e0 20 63 61 73 65 20 74 68 61 74 20 61 20 73 68 6f 72 74 2d 68 61 6e 64 20 69 73 20 73 70 65 63 69 .case.that.a.short-hand.is.speci
4e800 66 69 65 64 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 0a 6d 61 74 63 68 20 74 68 65 20 6b 65 79 20 fied.but.does.not.match.the.key.
4e820 62 69 6e 64 69 6e 67 2c 20 74 68 65 6e 20 69 74 20 69 73 20 68 69 67 68 6c 69 67 68 74 65 64 20 binding,.then.it.is.highlighted.
4e840 64 69 66 66 65 72 65 6e 74 6c 79 2e 0a 0a 54 68 65 20 68 69 67 68 6c 69 67 68 74 69 6e 67 20 69 differently...The.highlighting.i
4e860 73 20 64 6f 6e 65 20 75 73 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d 6d 69 73 6d 61 74 63 68 s.done.using.`transient-mismatch
4e880 65 64 2d 6b 65 79 27 0a 61 6e 64 20 60 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 73 74 61 6e 64 61 ed-key'.and.`transient-nonstanda
4e8a0 72 64 2d 6b 65 79 27 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 rd-key'."...:package-version.'(t
4e8c0 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 ransient..."0.1.0")...:group.'tr
4e8e0 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 65 66 63 ansient...:type.'boolean)..(defc
4e900 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 68 69 67 68 65 72 ustom.transient-highlight-higher
4e920 2d 6c 65 76 65 6c 73 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 68 69 67 68 6c 69 -levels.nil..."Whether.to.highli
4e940 67 68 74 20 73 75 66 66 69 78 65 73 20 6f 6e 20 68 69 67 68 65 72 20 6c 65 76 65 6c 73 2e 0a 0a ght.suffixes.on.higher.levels...
4e960 54 68 69 73 20 69 73 20 70 72 69 6d 61 72 69 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 70 This.is.primarily.intended.for.p
4e980 61 63 6b 61 67 65 20 61 75 74 68 6f 72 73 2e 0a 0a 57 68 65 6e 20 6e 6f 6e 2d 6e 69 6c 20 74 68 ackage.authors...When.non-nil.th
4e9a0 65 6e 20 68 69 67 68 6c 69 67 68 74 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 en.highlight.the.description.of.
4e9c0 73 75 66 66 69 78 65 73 20 77 68 6f 73 65 0a 6c 65 76 65 6c 20 69 73 20 61 62 6f 76 65 20 34 2c suffixes.whose.level.is.above.4,
4e9e0 20 74 68 65 20 64 65 66 61 75 6c 74 20 6f 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 .the.default.of.`transient-defau
4ea00 6c 74 2d 6c 65 76 65 6c 27 2e 0a 41 73 73 75 6d 69 6e 67 20 79 6f 75 20 68 61 76 65 20 73 65 74 lt-level'..Assuming.you.have.set
4ea20 20 74 68 61 74 20 76 61 72 69 61 62 6c 65 20 74 6f 20 37 2c 20 74 68 69 73 20 68 69 67 68 6c 69 .that.variable.to.7,.this.highli
4ea40 67 68 74 73 20 61 6c 6c 0a 73 75 66 66 69 78 65 73 20 74 68 61 74 20 77 6f 6e 27 74 20 62 65 20 ghts.all.suffixes.that.won't.be.
4ea60 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 75 73 65 72 73 20 77 69 74 68 6f 75 74 20 74 68 65 6d 20 available.to.users.without.them.
4ea80 6d 61 6b 69 6e 67 0a 74 68 65 20 73 61 6d 65 20 63 75 73 74 6f 6d 69 7a 61 74 69 6f 6e 2e 22 0a making.the.same.customization.".
4eaa0 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e ..:package-version.'(transient..
4eac0 20 22 30 2e 33 2e 36 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 ."0.3.6")...:group.'transient...
4eae0 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e :type.'boolean)..(defcustom.tran
4eb00 73 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 20 6e 69 sient-substitute-key-function.ni
4eb20 6c 0a 20 20 22 46 75 6e 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 6b 65 79 l..."Function.used.to.modify.key
4eb40 20 62 69 6e 64 69 6e 67 73 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c .bindings...This.function.is.cal
4eb60 6c 65 64 20 77 69 74 68 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74 2c 20 74 68 65 20 70 72 65 66 69 led.with.one.argument,.the.prefi
4eb80 78 20 6f 62 6a 65 63 74 2c 0a 61 6e 64 20 6d 75 73 74 20 72 65 74 75 72 6e 20 61 20 6b 65 79 20 x.object,.and.must.return.a.key.
4eba0 62 69 6e 64 69 6e 67 20 64 65 73 63 72 69 70 74 69 6f 6e 2c 20 65 69 74 68 65 72 20 74 68 65 20 binding.description,.either.the.
4ebc0 65 78 69 73 74 69 6e 67 0a 6b 65 79 20 64 65 73 63 72 69 70 74 69 6f 6e 20 69 74 20 66 69 6e 64 existing.key.description.it.find
4ebe0 73 20 69 6e 20 74 68 65 20 60 6b 65 79 27 20 73 6c 6f 74 2c 20 6f 72 20 61 20 73 75 62 73 74 69 s.in.the.`key'.slot,.or.a.substi
4ec00 74 75 74 69 6f 6e 2e 0a 0a 54 68 69 73 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 6c 65 74 tution...This.is.intended.to.let
4ec20 20 75 73 65 72 73 20 72 65 70 6c 61 63 65 20 63 65 72 74 61 69 6e 20 70 72 65 66 69 78 20 6b 65 .users.replace.certain.prefix.ke
4ec40 79 73 2e 20 20 49 74 0a 63 6f 75 6c 64 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 6f 20 6d 61 ys...It.could.also.be.used.to.ma
4ec60 6b 65 20 6f 74 68 65 72 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73 2c 20 62 75 74 20 74 68 61 74 ke.other.substitutions,.but.that
4ec80 20 69 73 0a 64 69 73 63 6f 75 72 61 67 65 64 2e 0a 0a 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 5c .is.discouraged...For.example,.\
4eca0 22 3d 5c 22 20 69 73 20 68 61 72 64 20 74 6f 20 72 65 61 63 68 20 75 73 69 6e 67 20 6d 79 20 63 "=\".is.hard.to.reach.using.my.c
4ecc0 75 73 74 6f 6d 20 6b 65 79 62 6f 61 72 64 0a 6c 61 79 6f 75 74 2c 20 73 6f 20 49 20 73 75 62 73 ustom.keyboard.layout,.so.I.subs
4ece0 74 69 74 75 74 65 20 5c 22 28 5c 22 20 66 6f 72 20 74 68 61 74 2c 20 77 68 69 63 68 20 69 73 20 titute.\"(\".for.that,.which.is.
4ed00 65 61 73 79 20 74 6f 20 72 65 61 63 68 0a 75 73 69 6e 67 20 61 20 6c 61 79 6f 75 74 20 6f 70 74 easy.to.reach.using.a.layout.opt
4ed20 69 6d 69 7a 65 64 20 66 6f 72 20 4c 69 73 70 2e 0a 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 imized.for.Lisp.....(setq.transi
4ed40 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 ent-substitute-key-function.....
4ed60 20 20 20 20 28 6c 61 6d 62 64 61 20 28 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 ....(lambda.(obj)...........(let
4ed80 20 28 28 6b 65 79 20 28 6f 72 65 66 20 6f 62 6a 20 6b 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 .((key.(oref.obj.key))).........
4eda0 20 20 20 20 28 69 66 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 5c 22 5c 5c 5c 5c 60 5c 5c 5c ....(if.(string-match.\"\\\\`\\\
4edc0 5c 28 3d 5c 5c 5c 5c 29 5b 61 2d 7a 41 2d 5a 5d 5c 22 20 6b 65 79 29 0a 20 20 20 20 20 20 20 20 \(=\\\\)[a-zA-Z]\".key).........
4ede0 20 20 20 20 20 20 20 20 28 72 65 70 6c 61 63 65 2d 6d 61 74 63 68 20 5c 22 28 5c 22 20 74 20 74 ........(replace-match.\"(\".t.t
4ee00 20 6b 65 79 20 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6b 65 79 29 29 29 29 29 22 0a .key.1)...............key)))))".
4ee20 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e ..:package-version.'(transient..
4ee40 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 ."0.1.0")...:group.'transient...
4ee60 3a 74 79 70 65 20 27 28 63 68 6f 69 63 65 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 54 72 61 6e :type.'(choice.(const.:tag."Tran
4ee80 73 66 6f 72 6d 20 6e 6f 20 6b 65 79 73 20 28 6e 69 6c 29 22 20 6e 69 6c 29 20 66 75 6e 63 74 69 sform.no.keys.(nil)".nil).functi
4eea0 6f 6e 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 6d 61 6e on))..(defcustom.transient-seman
4eec0 74 69 63 2d 63 6f 6c 6f 72 69 6e 67 20 74 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 75 73 65 tic-coloring.t..."Whether.to.use
4eee0 20 63 6f 6c 6f 72 73 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 72 61 6e 73 69 65 6e 74 20 62 65 .colors.to.indicate.transient.be
4ef00 68 61 76 69 6f 72 2e 0a 0a 49 66 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 65 6e 20 74 68 65 20 6b 65 havior...If.non-nil,.then.the.ke
4ef20 79 20 62 69 6e 64 69 6e 67 20 6f 66 20 65 61 63 68 20 73 75 66 66 69 78 20 69 73 20 63 6f 6c 6f y.binding.of.each.suffix.is.colo
4ef40 72 69 7a 65 64 20 74 6f 0a 69 6e 64 69 63 61 74 65 20 77 68 65 74 68 65 72 20 69 74 20 65 78 69 rized.to.indicate.whether.it.exi
4ef60 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 6f 72 20 6e 6f 74 2c 20 61 ts.the.transient.state.or.not,.a
4ef80 6e 64 20 74 68 65 0a 6c 69 6e 65 20 74 68 61 74 20 69 73 20 64 72 61 77 6e 20 62 65 6c 6f 77 20 nd.the.line.that.is.drawn.below.
4efa0 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 20 69 73 20 75 73 65 64 20 transient's.menu.buffer.is.used.
4efc0 74 6f 0a 69 6e 64 69 63 61 74 65 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 6e 6f 6e 2d to.indicate.the.behavior.of.non-
4efe0 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 suffix.commands."...:package-ver
4f000 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 35 2e 30 22 29 0a 20 20 3a 67 sion.'(transient..."0.5.0")...:g
4f020 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e roup.'transient...:type.'boolean
4f040 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 74 65 63 74 2d 6b )..(defcustom.transient-detect-k
4f060 65 79 2d 63 6f 6e 66 6c 69 63 74 73 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 64 ey-conflicts.nil..."Whether.to.d
4f080 65 74 65 63 74 20 6b 65 79 20 62 69 6e 64 69 6e 67 20 63 6f 6e 66 6c 69 63 74 73 2e 0a 0a 43 6f etect.key.binding.conflicts...Co
4f0a0 6e 66 6c 69 63 74 73 20 61 72 65 20 64 65 74 65 63 74 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e nflicts.are.detected.when.a.tran
4f0c0 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 0a sient.prefix.command.is.invoked.
4f0e0 61 6e 64 20 72 65 73 75 6c 74 73 20 69 6e 20 61 6e 20 65 72 72 6f 72 2c 20 77 68 69 63 68 20 70 and.results.in.an.error,.which.p
4f100 72 65 76 65 6e 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 62 65 69 6e 67 revents.the.transient.from.being
4f120 0a 75 73 65 64 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 .used."...:package-version.'(tra
4f140 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e nsient..."0.1.0")...:group.'tran
4f160 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 65 66 63 75 73 sient...:type.'boolean)..(defcus
4f180 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 65 72 72 6f 72 2d 6f 6e 2d 69 6e 73 65 72 74 2d 66 61 tom.transient-error-on-insert-fa
4f1a0 69 6c 75 72 65 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 73 69 67 6e 61 6c 20 61 ilure.nil..."Whether.to.signal.a
4f1c0 6e 20 65 72 72 6f 72 20 77 68 65 6e 20 66 61 69 6c 69 6e 67 20 74 6f 20 69 6e 73 65 72 74 20 61 n.error.when.failing.to.insert.a
4f1e0 20 73 75 66 66 69 78 2e 0a 0a 57 68 65 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 .suffix...When.`transient-insert
4f200 2d 73 75 66 66 69 78 27 20 61 6e 64 20 60 74 72 61 6e 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 -suffix'.and.`transient-append-s
4f220 75 66 66 69 78 27 20 66 61 69 6c 0a 74 6f 20 69 6e 73 65 72 74 20 61 20 73 75 66 66 69 78 20 69 uffix'.fail.to.insert.a.suffix.i
4f240 6e 74 6f 20 61 6e 20 65 78 69 73 74 69 6e 67 20 70 72 65 66 69 78 2c 20 74 68 65 79 20 75 73 75 nto.an.existing.prefix,.they.usu
4f260 61 6c 6c 79 20 6a 75 73 74 20 73 68 6f 77 0a 61 20 77 61 72 6e 69 6e 67 2e 20 20 49 66 20 74 68 ally.just.show.a.warning...If.th
4f280 69 73 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 65 79 20 73 69 67 6e 61 6c 20 61 6e 20 65 72 is.is.non-nil,.they.signal.an.er
4f2a0 72 6f 72 20 69 6e 73 74 65 61 64 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e ror.instead."...:package-version
4f2c0 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 38 2e 38 22 29 0a 20 20 3a 67 72 6f 75 70 .'(transient..."0.8.8")...:group
4f2e0 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 .'transient...:type.'boolean)..(
4f300 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d 76 61 72 69 61 62 defcustom.transient-align-variab
4f320 6c 65 2d 70 69 74 63 68 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 61 6c 69 67 6e le-pitch.nil..."Whether.to.align
4f340 20 63 6f 6c 75 6d 6e 73 20 70 69 78 65 6c 2d 77 69 73 65 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 .columns.pixel-wise.in.the.menu.
4f360 62 75 66 66 65 72 2e 0a 0a 49 66 20 74 68 69 73 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 65 buffer...If.this.is.non-nil,.the
4f380 6e 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 61 6c 69 67 6e 65 64 20 70 69 78 65 6c 2d 77 69 73 65 n.columns.are.aligned.pixel-wise
4f3a0 20 74 6f 0a 73 75 70 70 6f 72 74 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 66 6f 6e 74 73 .to.support.variable-pitch.fonts
4f3c0 2e 20 20 4b 65 79 73 20 61 72 65 20 6e 6f 74 20 61 6c 69 67 6e 65 64 2c 20 73 6f 20 79 6f 75 0a ...Keys.are.not.aligned,.so.you.
4f3e0 73 68 6f 75 6c 64 20 75 73 65 20 61 20 66 69 78 65 64 2d 70 69 74 63 68 20 66 6f 6e 74 20 66 6f should.use.a.fixed-pitch.font.fo
4f400 72 20 74 68 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 27 20 66 61 63 65 2e 0a 4f 74 68 65 r.the.`transient-key'.face..Othe
4f420 72 20 6b 65 79 20 66 61 63 65 73 20 69 6e 68 65 72 69 74 20 66 72 6f 6d 20 74 68 61 74 20 66 61 r.key.faces.inherit.from.that.fa
4f440 63 65 20 75 6e 6c 65 73 73 20 61 20 74 68 65 6d 65 20 69 73 0a 75 73 65 64 20 74 68 61 74 20 62 ce.unless.a.theme.is.used.that.b
4f460 72 65 61 6b 73 20 74 68 61 74 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 2e 0a 0a 54 68 69 73 20 6f reaks.that.relationship...This.o
4f480 70 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 72 73 20 77 68 6f 20 ption.is.intended.for.users.who.
4f4a0 75 73 65 20 61 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 0a 66 6f 6e 74 20 66 6f 72 20 74 68 use.a.variable-pitch.font.for.th
4f4c0 65 20 60 64 65 66 61 75 6c 74 27 20 66 61 63 65 2e 0a 0a 53 65 65 20 61 6c 73 6f 20 60 74 72 61 e.`default'.face...See.also.`tra
4f4e0 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 27 2e 22 0a 20 20 3a 70 nsient-force-fixed-pitch'."...:p
4f500 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e ackage-version.'(transient..."0.
4f520 34 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 4.0")...:group.'transient...:typ
4f540 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e e.'boolean)..(defcustom.transien
4f560 74 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 t-force-fixed-pitch.nil..."Wheth
4f580 65 72 20 74 6f 20 66 6f 72 63 65 20 75 73 65 20 6f 66 20 6d 6f 6e 6f 73 70 61 63 65 64 20 66 6f er.to.force.use.of.monospaced.fo
4f5a0 6e 74 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 0a 0a 45 76 65 6e 20 69 66 20 nt.in.the.menu.buffer...Even.if.
4f5c0 79 6f 75 20 75 73 65 20 61 20 70 72 6f 70 6f 72 74 69 6f 6e 61 6c 20 66 6f 6e 74 20 66 6f 72 20 you.use.a.proportional.font.for.
4f5e0 74 68 65 20 60 64 65 66 61 75 6c 74 27 20 66 61 63 65 2c 0a 79 6f 75 20 6d 69 67 68 74 20 73 74 the.`default'.face,.you.might.st
4f600 69 6c 6c 20 77 61 6e 74 20 74 6f 20 75 73 65 20 61 20 6d 6f 6e 6f 73 70 61 63 65 64 20 66 6f 6e ill.want.to.use.a.monospaced.fon
4f620 74 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 27 73 0a 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 53 t.in.transient's.menu.buffer...S
4f640 65 74 74 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 74 6f 20 74 20 63 61 75 73 65 73 20 60 etting.this.option.to.t.causes.`
4f660 64 65 66 61 75 6c 74 27 20 74 6f 0a 62 65 20 72 65 6d 61 70 70 65 64 20 74 6f 20 60 66 69 78 65 default'.to.be.remapped.to.`fixe
4f680 64 2d 70 69 74 63 68 27 20 69 6e 20 74 68 61 74 20 62 75 66 66 65 72 2e 0a 0a 53 65 65 20 61 6c d-pitch'.in.that.buffer...See.al
4f6a0 73 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d 76 61 72 69 61 62 6c 65 2d 70 69 74 so.`transient-align-variable-pit
4f6c0 63 68 27 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 ch'."...:package-version.'(trans
4f6e0 69 65 6e 74 20 2e 20 22 30 2e 32 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 ient..."0.2.0")...:group.'transi
4f700 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 65 66 63 75 73 74 6f ent...:type.'boolean)..(defcusto
4f720 6d 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 73 69 6e 67 6c 65 2d 63 6f 6c 75 6d 6e 20 m.transient-force-single-column.
4f740 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 66 6f 72 63 65 20 75 73 65 20 6f 66 20 61 nil..."Whether.to.force.use.of.a
4f760 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 20 74 6f 20 64 69 73 70 6c 61 79 20 73 75 66 66 69 78 .single.column.to.display.suffix
4f780 65 73 2e 0a 0a 54 68 69 73 20 6d 69 67 68 74 20 62 65 20 75 73 65 66 75 6c 20 66 6f 72 20 75 73 es...This.might.be.useful.for.us
4f7a0 65 72 73 20 77 69 74 68 20 6c 6f 77 20 76 69 73 69 6f 6e 20 77 68 6f 20 75 73 65 20 6c 61 72 67 ers.with.low.vision.who.use.larg
4f7c0 65 0a 74 65 78 74 20 61 6e 64 20 6d 69 67 68 74 20 6f 74 68 65 72 77 69 73 65 20 68 61 76 65 20 e.text.and.might.otherwise.have.
4f7e0 74 6f 20 73 63 72 6f 6c 6c 20 69 6e 20 74 77 6f 20 64 69 6d 65 6e 73 69 6f 6e 73 2e 22 0a 20 20 to.scroll.in.two.dimensions."...
4f800 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 :package-version.'(transient..."
4f820 30 2e 33 2e 36 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 0.3.6")...:group.'transient...:t
4f840 79 70 65 20 27 62 6f 6f 6c 65 61 6e 29 0a 0a 28 64 65 66 63 6f 6e 73 74 20 74 72 61 6e 73 69 65 ype.'boolean)..(defconst.transie
4f860 6e 74 2d 2d 6d 61 78 2d 6c 65 76 65 6c 20 37 29 0a 28 64 65 66 63 6f 6e 73 74 20 74 72 61 6e 73 nt--max-level.7).(defconst.trans
4f880 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 63 68 69 6c 64 2d 6c 65 76 65 6c 20 31 29 0a 28 64 65 ient--default-child-level.1).(de
4f8a0 66 63 6f 6e 73 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 70 72 65 66 69 78 fconst.transient--default-prefix
4f8c0 2d 6c 65 76 65 6c 20 34 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d -level.4)..(defcustom.transient-
4f8e0 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 default-level.transient--default
4f900 2d 70 72 65 66 69 78 2d 6c 65 76 65 6c 0a 20 20 22 43 6f 6e 74 72 6f 6c 20 77 68 61 74 20 73 75 -prefix-level..."Control.what.su
4f920 66 66 69 78 20 6c 65 76 65 6c 73 20 61 72 65 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65 20 62 ffix.levels.are.made.available.b
4f940 79 20 64 65 66 61 75 6c 74 2e 0a 0a 45 61 63 68 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 y.default...Each.suffix.command.
4f960 69 73 20 70 6c 61 63 65 64 20 6f 6e 20 61 20 6c 65 76 65 6c 20 61 6e 64 20 65 61 63 68 20 70 72 is.placed.on.a.level.and.each.pr
4f980 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 68 61 73 20 61 20 6c 65 76 65 6c 2c 20 77 68 69 63 68 20 efix.command.has.a.level,.which.
4f9a0 63 6f 6e 74 72 6f 6c 73 20 77 68 69 63 68 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 controls.which.suffix.commands.a
4f9c0 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 0a 49 6e 74 65 67 65 72 73 20 62 65 74 77 65 65 6e 20 31 re.available..Integers.between.1
4f9e0 20 61 6e 64 20 37 20 28 69 6e 63 6c 75 73 69 76 65 29 20 61 72 65 20 76 61 6c 69 64 20 6c 65 76 .and.7.(inclusive).are.valid.lev
4fa00 65 6c 73 2e 0a 0a 54 68 65 20 6c 65 76 65 6c 73 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c 20 74 els...The.levels.of.individual.t
4fa20 72 61 6e 73 69 65 6e 74 73 20 61 6e 64 2f 6f 72 20 74 68 65 69 72 20 69 6e 64 69 76 69 64 75 61 ransients.and/or.their.individua
4fa40 6c 0a 73 75 66 66 69 78 65 73 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 69 6e 64 69 76 69 l.suffixes.can.be.changed.indivi
4fa60 64 75 61 6c 6c 79 2c 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 70 72 65 66 69 78 20 61 dually,.by.invoking.the.prefix.a
4fa80 6e 64 0a 74 68 65 6e 20 70 72 65 73 73 69 6e 67 20 5c 5c 3c 74 72 61 6e 73 69 65 6e 74 2d 2d 64 nd.then.pressing.\\<transient--d
4faa0 6f 63 73 74 72 2d 68 69 6e 74 2d 32 3e 5c 5c 5b 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 ocstr-hint-2>\\[transient-set-le
4fac0 76 65 6c 5d 2e 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 20 66 6f 72 20 62 6f 74 vel]...The.default.level.for.bot
4fae0 68 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 73 75 66 66 69 78 65 73 20 h.transients.and.their.suffixes.
4fb00 69 73 20 34 2e 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6e 6c 79 20 63 6f 6e 74 72 6f 6c 73 20 is.4..This.option.only.controls.
4fb20 74 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 54 68 65 the.default.for.transients...The
4fb40 20 64 65 66 61 75 6c 74 0a 73 75 66 66 69 78 20 6c 65 76 65 6c 20 69 73 20 61 6c 77 61 79 73 20 .default.suffix.level.is.always.
4fb60 34 2e 20 20 54 68 65 20 61 75 74 68 6f 72 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e 74 20 73 68 4...The.author.of.a.transient.sh
4fb80 6f 75 6c 64 20 70 6c 61 63 65 0a 63 65 72 74 61 69 6e 20 73 75 66 66 69 78 65 73 20 6f 6e 20 61 ould.place.certain.suffixes.on.a
4fba0 20 68 69 67 68 65 72 20 6c 65 76 65 6c 20 69 66 20 74 68 65 79 20 65 78 70 65 63 74 20 74 68 61 .higher.level.if.they.expect.tha
4fbc0 74 20 69 74 20 77 6f 6e 27 74 20 62 65 0a 6f 66 20 75 73 65 20 74 6f 20 6d 6f 73 74 20 75 73 65 t.it.won't.be.of.use.to.most.use
4fbe0 72 73 2c 20 61 6e 64 20 74 68 65 79 20 73 68 6f 75 6c 64 20 70 6c 61 63 65 20 76 65 72 79 20 69 rs,.and.they.should.place.very.i
4fc00 6d 70 6f 72 74 61 6e 74 20 73 75 66 66 69 78 65 73 0a 6f 6e 20 61 20 6c 6f 77 65 72 20 6c 65 76 mportant.suffixes.on.a.lower.lev
4fc20 65 6c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 72 65 6d 61 69 6e 20 61 76 61 69 6c 61 62 6c 65 el.so.that.they.remain.available
4fc40 20 65 76 65 6e 20 69 66 20 74 68 65 20 75 73 65 72 0a 6c 6f 77 65 72 73 20 74 68 65 20 74 72 61 .even.if.the.user.lowers.the.tra
4fc60 6e 73 69 65 6e 74 20 6c 65 76 65 6c 2e 0a 0a 5c 28 4d 61 67 69 74 20 63 75 72 72 65 6e 74 6c 79 nsient.level...\(Magit.currently
4fc80 20 70 6c 61 63 65 73 20 6e 65 61 72 6c 79 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 6f 6e 20 6c .places.nearly.all.suffixes.on.l
4fca0 65 76 65 6c 20 34 20 61 6e 64 20 6c 6f 77 65 72 0a 6c 65 76 65 6c 73 20 61 72 65 20 6e 6f 74 20 evel.4.and.lower.levels.are.not.
4fcc0 75 73 65 64 20 61 74 20 61 6c 6c 20 79 65 74 2e 20 20 53 6f 20 66 6f 72 20 74 68 65 20 74 69 6d used.at.all.yet...So.for.the.tim
4fce0 65 20 62 65 69 6e 67 20 79 6f 75 20 73 68 6f 75 6c 64 0a 6e 6f 74 20 73 65 74 20 61 20 6c 6f 77 e.being.you.should.not.set.a.low
4fd00 65 72 20 6c 65 76 65 6c 20 68 65 72 65 20 61 6e 64 20 75 73 69 6e 67 20 61 20 68 69 67 68 65 72 er.level.here.and.using.a.higher
4fd20 20 6c 65 76 65 6c 20 6d 69 67 68 74 20 6e 6f 74 0a 67 69 76 65 20 79 6f 75 20 61 73 20 6d 61 6e .level.might.not.give.you.as.man
4fd40 79 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 75 66 66 69 78 65 73 20 61 73 20 79 6f 75 20 68 6f 70 y.additional.suffixes.as.you.hop
4fd60 65 64 2e 29 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 ed.)"...:package-version.'(trans
4fd80 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 ient..."0.1.0")...:group.'transi
4fda0 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 28 63 68 6f 69 63 65 20 28 63 6f 6e 73 74 20 3a 74 61 67 ent...:type.'(choice.(const.:tag
4fdc0 20 22 31 20 2d 20 66 65 77 65 73 74 20 73 75 66 66 69 78 65 73 22 20 31 29 0a 20 20 20 20 20 20 ."1.-.fewest.suffixes".1).......
4fde0 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 32 29 0a 20 20 20 20 20 20 20 20 20 20 20 ...........(const.2)............
4fe00 20 20 20 20 20 20 28 63 6f 6e 73 74 20 33 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ......(const.3).................
4fe20 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 34 20 2d 20 64 65 66 61 75 6c 74 22 20 34 29 0a 20 20 .(const.:tag."4.-.default".4)...
4fe40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 35 29 0a 20 20 20 20 20 20 20 ...............(const.5)........
4fe60 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 36 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ..........(const.6).............
4fe80 20 20 20 20 20 28 63 6f 6e 73 74 20 3a 74 61 67 20 22 37 20 2d 20 6d 6f 73 74 20 73 75 66 66 69 .....(const.:tag."7.-.most.suffi
4fea0 78 65 73 22 20 37 29 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d xes".7)))..(defcustom.transient-
4fec0 6c 65 76 65 6c 73 2d 66 69 6c 65 0a 20 20 28 6c 6f 63 61 74 65 2d 75 73 65 72 2d 65 6d 61 63 73 levels-file...(locate-user-emacs
4fee0 2d 66 69 6c 65 20 22 74 72 61 6e 73 69 65 6e 74 2f 6c 65 76 65 6c 73 2e 65 6c 22 29 0a 20 20 22 -file."transient/levels.el")..."
4ff00 46 69 6c 65 20 75 73 65 64 20 74 6f 20 73 61 76 65 20 6c 65 76 65 6c 73 20 6f 66 20 74 72 61 6e File.used.to.save.levels.of.tran
4ff20 73 69 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 73 75 66 66 69 78 65 73 2e 22 0a 20 20 3a 70 sients.and.their.suffixes."...:p
4ff40 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e ackage-version.'(transient..."0.
4ff60 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 1.0")...:group.'transient...:typ
4ff80 65 20 27 66 69 6c 65 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 76 e.'file)..(defcustom.transient-v
4ffa0 61 6c 75 65 73 2d 66 69 6c 65 0a 20 20 28 6c 6f 63 61 74 65 2d 75 73 65 72 2d 65 6d 61 63 73 2d alues-file...(locate-user-emacs-
4ffc0 66 69 6c 65 20 22 74 72 61 6e 73 69 65 6e 74 2f 76 61 6c 75 65 73 2e 65 6c 22 29 0a 20 20 22 46 file."transient/values.el")..."F
4ffe0 69 6c 65 20 75 73 65 64 20 74 6f 20 73 61 76 65 20 76 61 6c 75 65 73 20 6f 66 20 74 72 61 6e 73 ile.used.to.save.values.of.trans
50000 69 65 6e 74 73 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 ients."...:package-version.'(tra
50020 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e nsient..."0.1.0")...:group.'tran
50040 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 66 69 6c 65 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d sient...:type.'file)..(defcustom
50060 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 66 69 6c 65 0a 20 20 28 6c 6f 63 61 74 .transient-history-file...(locat
50080 65 2d 75 73 65 72 2d 65 6d 61 63 73 2d 66 69 6c 65 20 22 74 72 61 6e 73 69 65 6e 74 2f 68 69 73 e-user-emacs-file."transient/his
500a0 74 6f 72 79 2e 65 6c 22 29 0a 20 20 22 46 69 6c 65 20 75 73 65 64 20 74 6f 20 73 61 76 65 20 68 tory.el")..."File.used.to.save.h
500c0 69 73 74 6f 72 79 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 69 istory.of.transients.and.their.i
500e0 6e 66 69 78 65 73 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 nfixes."...:package-version.'(tr
50100 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 ansient..."0.1.0")...:group.'tra
50120 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 66 69 6c 65 29 0a 0a 28 64 65 66 63 75 73 74 6f nsient...:type.'file)..(defcusto
50140 6d 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 6c 69 6d 69 74 20 31 30 0a 20 20 22 m.transient-history-limit.10..."
50160 4e 75 6d 62 65 72 20 6f 66 20 68 69 73 74 6f 72 79 20 65 6c 65 6d 65 6e 74 73 20 74 6f 20 6b 65 Number.of.history.elements.to.ke
50180 65 70 20 77 68 65 6e 20 73 61 76 69 6e 67 20 74 6f 20 66 69 6c 65 2e 22 0a 20 20 3a 70 61 63 6b ep.when.saving.to.file."...:pack
501a0 61 67 65 2d 76 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 age-version.'(transient..."0.1.0
501c0 22 29 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 ")...:group.'transient...:type.'
501e0 69 6e 74 65 67 65 72 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 73 integer)..(defcustom.transient-s
50200 61 76 65 2d 68 69 73 74 6f 72 79 20 74 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 73 61 76 65 ave-history.t..."Whether.to.save
50220 20 68 69 73 74 6f 72 79 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 77 .history.of.transient.commands.w
50240 68 65 6e 20 65 78 69 74 69 6e 67 20 45 6d 61 63 73 2e 22 0a 20 20 3a 70 61 63 6b 61 67 65 2d 76 hen.exiting.Emacs."...:package-v
50260 65 72 73 69 6f 6e 20 27 28 74 72 61 6e 73 69 65 6e 74 20 2e 20 22 30 2e 31 2e 30 22 29 0a 20 20 ersion.'(transient..."0.1.0")...
50280 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 3a 74 79 70 65 20 27 62 6f 6f 6c 65 :group.'transient...:type.'boole
502a0 61 6e 29 0a 0a 3b 3b 3b 20 46 61 63 65 73 0a 0a 28 64 65 66 67 72 6f 75 70 20 74 72 61 6e 73 69 an)..;;;.Faces..(defgroup.transi
502c0 65 6e 74 2d 66 61 63 65 73 20 6e 69 6c 0a 20 20 22 46 61 63 65 73 20 75 73 65 64 20 62 79 20 54 ent-faces.nil..."Faces.used.by.T
502e0 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 29 0a ransient."...:group.'transient).
50300 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 68 65 61 64 69 6e 67 20 27 28 28 74 .(defface.transient-heading.'((t
50320 20 3a 69 6e 68 65 72 69 74 20 66 6f 6e 74 2d 6c 6f 63 6b 2d 6b 65 79 77 6f 72 64 2d 66 61 63 65 .:inherit.font-lock-keyword-face
50340 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 68 65 61 64 69 6e 67 73 2e 22 0a 20 ))..."Face.used.for.headings."..
50360 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 .:group.'transient-faces)..(deff
50380 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 20 27 28 28 74 20 3a 69 6e 68 ace.transient-argument.'((t.:inh
503a0 65 72 69 74 20 66 6f 6e 74 2d 6c 6f 63 6b 2d 73 74 72 69 6e 67 2d 66 61 63 65 20 3a 77 65 69 67 erit.font-lock-string-face.:weig
503c0 68 74 20 62 6f 6c 64 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 65 6e 61 62 6c ht.bold))..."Face.used.for.enabl
503e0 65 64 20 61 72 67 75 6d 65 6e 74 73 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 ed.arguments."...:group.'transie
50400 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e nt-faces)..(defface.transient-in
50420 61 63 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 73 68 active-argument.'((t.:inherit.sh
50440 61 64 6f 77 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 69 6e 61 63 74 69 76 65 adow))..."Face.used.for.inactive
50460 20 61 72 67 75 6d 65 6e 74 73 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 .arguments."...:group.'transient
50480 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 -faces)..(defface.transient-inap
504a0 74 2d 61 72 67 75 6d 65 6e 74 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 73 68 61 64 6f 77 20 t-argument.'((t.:inherit.shadow.
504c0 3a 77 65 69 67 68 74 20 62 6f 6c 64 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 :weight.bold))..."Face.used.for.
504e0 69 6e 61 70 74 20 61 72 67 75 6d 65 6e 74 73 20 77 69 74 68 20 61 20 28 63 75 72 72 65 6e 74 6c inapt.arguments.with.a.(currentl
50500 79 20 69 67 6e 6f 72 65 64 29 20 76 61 6c 75 65 2e 0a 44 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 y.ignored).value..Depending.on.t
50520 68 65 20 74 79 70 65 20 74 68 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 61 72 67 he.type.this.is.used.for.the.arg
50540 75 6d 65 6e 74 20 61 6e 64 2f 6f 72 20 76 61 6c 75 65 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 ument.and/or.value."...:group.'t
50560 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 ransient-faces)..(defface.transi
50580 65 6e 74 2d 76 61 6c 75 65 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 66 6f 6e 74 2d 6c 6f 63 ent-value.'((t.:inherit.font-loc
505a0 6b 2d 73 74 72 69 6e 67 2d 66 61 63 65 20 3a 77 65 69 67 68 74 20 62 6f 6c 64 29 29 0a 20 20 22 k-string-face.:weight.bold))..."
505c0 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 76 61 6c 75 65 73 2e 22 0a 20 20 3a 67 72 6f 75 70 20 Face.used.for.values."...:group.
505e0 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 'transient-faces)..(defface.tran
50600 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 76 61 6c 75 65 20 27 28 28 74 20 3a 69 6e 68 65 72 sient-inactive-value.'((t.:inher
50620 69 74 20 73 68 61 64 6f 77 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 69 6e 61 it.shadow))..."Face.used.for.ina
50640 63 74 69 76 65 20 76 61 6c 75 65 73 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 ctive.values."...:group.'transie
50660 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 75 6e nt-faces)..(defface.transient-un
50680 72 65 61 63 68 61 62 6c 65 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 73 68 61 64 6f 77 29 29 reachable.'((t.:inherit.shadow))
506a0 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 75 6e 72 65 61 ..."Face.used.for.suffixes.unrea
506c0 63 68 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 65 66 69 78 20 73 chable.from.the.current.prefix.s
506e0 65 71 75 65 6e 63 65 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 equence."...:group.'transient-fa
50700 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 2d 73 ces)..(defface.transient-inapt-s
50720 75 66 66 69 78 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 73 68 61 64 6f 77 20 3a 73 6c 61 6e uffix.'((t.:inherit.shadow.:slan
50740 74 20 69 74 61 6c 69 63 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 t.italic))..."Face.used.for.suff
50760 69 78 65 73 20 74 68 61 74 20 61 72 65 20 69 6e 61 70 74 20 61 74 20 74 68 69 73 20 74 69 6d 65 ixes.that.are.inapt.at.this.time
50780 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 ."...:group.'transient-faces)..(
507a0 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 61 63 74 69 76 65 2d 69 6e 66 69 78 20 27 defface.transient-active-infix.'
507c0 28 28 74 20 3a 69 6e 68 65 72 69 74 20 68 69 67 68 6c 69 67 68 74 29 29 0a 20 20 22 46 61 63 65 ((t.:inherit.highlight))..."Face
507e0 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 69 6e 66 69 78 20 66 6f 72 20 77 68 69 63 68 20 74 68 .used.for.the.infix.for.which.th
50800 65 20 76 61 6c 75 65 20 69 73 20 62 65 69 6e 67 20 72 65 61 64 2e 22 0a 20 20 3a 67 72 6f 75 70 e.value.is.being.read."...:group
50820 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 .'transient-faces)..(defface.tra
50840 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 64 2d 73 75 66 66 69 78 0a 20 20 27 28 28 74 20 3a 62 61 nsient-enabled-suffix...'((t.:ba
50860 63 6b 67 72 6f 75 6e 64 20 22 67 72 65 65 6e 22 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 22 62 6c ckground."green".:foreground."bl
50880 61 63 6b 22 20 3a 77 65 69 67 68 74 20 62 6f 6c 64 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 ack".:weight.bold))..."Face.used
508a0 20 66 6f 72 20 65 6e 61 62 6c 65 64 20 6c 65 76 65 6c 73 20 77 68 69 6c 65 20 65 64 69 74 69 6e .for.enabled.levels.while.editin
508c0 67 20 73 75 66 66 69 78 20 6c 65 76 65 6c 73 2e 0a 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 g.suffix.levels..See.info.node.`
508e0 28 74 72 61 6e 73 69 65 6e 74 29 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e (transient)Enabling.and.Disablin
50900 67 20 53 75 66 66 69 78 65 73 27 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e g.Suffixes'."...:group.'transien
50920 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 t-faces)..(defface.transient-dis
50940 61 62 6c 65 64 2d 73 75 66 66 69 78 0a 20 20 27 28 28 74 20 3a 62 61 63 6b 67 72 6f 75 6e 64 20 abled-suffix...'((t.:background.
50960 22 72 65 64 22 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 22 62 6c 61 63 6b 22 20 3a 77 65 69 67 68 "red".:foreground."black".:weigh
50980 74 20 62 6f 6c 64 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 64 69 73 61 62 6c t.bold))..."Face.used.for.disabl
509a0 65 64 20 6c 65 76 65 6c 73 20 77 68 69 6c 65 20 65 64 69 74 69 6e 67 20 73 75 66 66 69 78 20 6c ed.levels.while.editing.suffix.l
509c0 65 76 65 6c 73 2e 0a 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 evels..See.info.node.`(transient
509e0 29 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 53 75 66 66 69 78 65 73 )Enabling.and.Disabling.Suffixes
50a00 27 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a '."...:group.'transient-faces)..
50a20 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 65 72 2d 6c 65 76 65 6c 0a (defface.transient-higher-level.
50a40 20 20 60 28 28 74 20 3a 62 6f 78 20 28 20 3a 6c 69 6e 65 2d 77 69 64 74 68 20 2c 28 69 66 20 28 ..`((t.:box.(.:line-width.,(if.(
50a60 3e 3d 20 65 6d 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 32 38 29 20 28 63 6f 6e 73 >=.emacs-major-version.28).(cons
50a80 20 2d 31 20 2d 31 29 20 2d 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 63 6f 6c 6f 72 .-1.-1).-1)...............:color
50aa0 20 2c 28 6c 65 74 20 28 28 63 6f 6c 6f 72 20 28 66 61 63 65 2d 61 74 74 72 69 62 75 74 65 20 27 .,(let.((color.(face-attribute.'
50ac0 73 68 61 64 6f 77 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 74 20 74 29 29 29 0a 20 20 20 20 20 20 shadow.:foreground.t.t))).......
50ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 61 6e 64 20 28 6e 6f 74 20 ..................(or.(and.(not.
50b00 28 65 71 20 63 6f 6c 6f 72 20 27 75 6e 73 70 65 63 69 66 69 65 64 29 29 20 63 6f 6c 6f 72 29 0a (eq.color.'unspecified)).color).
50b20 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 22 67 72 65 ............................"gre
50b40 79 36 30 22 29 29 29 29 29 0a 20 20 22 46 61 63 65 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 75 73 65 y60")))))..."Face.optionally.use
50b60 64 20 74 6f 20 68 69 67 68 6c 69 67 68 74 20 73 75 66 66 69 78 65 73 20 6f 6e 20 68 69 67 68 65 d.to.highlight.suffixes.on.highe
50b80 72 20 6c 65 76 65 6c 73 2e 0a 53 65 65 20 61 6c 73 6f 20 6f 70 74 69 6f 6e 20 60 74 72 61 6e 73 r.levels..See.also.option.`trans
50ba0 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 68 69 67 68 65 72 2d 6c 65 76 65 6c 73 27 2e 22 0a ient-highlight-higher-levels'.".
50bc0 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 ..:group.'transient-faces)..(def
50be0 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 6c 69 6d 69 74 65 72 20 27 28 28 74 20 3a 69 face.transient-delimiter.'((t.:i
50c00 6e 68 65 72 69 74 20 73 68 61 64 6f 77 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 nherit.shadow))..."Face.used.for
50c20 20 64 65 6c 69 6d 69 74 65 72 73 20 61 6e 64 20 73 65 70 61 72 61 74 6f 72 73 2e 0a 54 68 69 73 .delimiters.and.separators..This
50c40 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 70 61 72 65 6e 74 68 65 73 65 73 20 61 72 6f 75 6e 64 .includes.the.parentheses.around
50c60 20 76 61 6c 75 65 73 20 61 6e 64 20 74 68 65 20 70 69 70 65 0a 63 68 61 72 61 63 74 65 72 20 75 .values.and.the.pipe.character.u
50c80 73 65 64 20 74 6f 20 73 65 70 61 72 61 74 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 sed.to.separate.possible.values.
50ca0 66 72 6f 6d 20 65 61 63 68 20 6f 74 68 65 72 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e from.each.other."...:group.'tran
50cc0 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 sient-faces)..(defface.transient
50ce0 2d 6b 65 79 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 66 6f 6e 74 2d 6c 6f 63 6b 2d 62 75 69 -key.'((t.:inherit.font-lock-bui
50d00 6c 74 69 6e 2d 66 61 63 65 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 6b 65 79 ltin-face))..."Face.used.for.key
50d20 73 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a s."...:group.'transient-faces)..
50d40 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 79 0a 20 20 60 28 (defface.transient-key-stay...`(
50d60 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 6c 69 67 68 (((class.color).(background.ligh
50d80 74 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a t))......:inherit.transient-key.
50da0 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 22 23 32 32 61 61 32 32 22 29 0a 20 20 20 20 .....:foreground."#22aa22").....
50dc0 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 64 61 72 6b (((class.color).(background.dark
50de0 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 ))......:inherit.transient-key..
50e00 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 22 23 64 64 66 66 64 64 22 29 29 0a 20 20 22 46 ....:foreground."#ddffdd"))..."F
50e20 61 63 65 20 75 73 65 64 20 66 6f 72 20 6b 65 79 73 20 6f 66 20 73 75 66 66 69 78 65 73 20 74 68 ace.used.for.keys.of.suffixes.th
50e40 61 74 20 64 6f 6e 27 74 20 65 78 69 74 20 74 68 65 20 6d 65 6e 75 2e 22 0a 20 20 3a 67 72 6f 75 at.don't.exit.the.menu."...:grou
50e60 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 p.'transient-faces)..(defface.tr
50e80 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f 6f 70 0a 20 20 60 28 28 28 28 63 6c 61 73 73 20 63 6f ansient-key-noop...`((((class.co
50ea0 6c 6f 72 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 6c 69 67 68 74 29 29 0a 20 20 20 20 20 3a 69 lor).(background.light))......:i
50ec0 6e 68 65 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 nherit.transient-key......:foreg
50ee0 72 6f 75 6e 64 20 22 67 72 65 79 38 30 22 29 0a 20 20 20 20 28 28 28 63 6c 61 73 73 20 63 6f 6c round."grey80").....(((class.col
50f00 6f 72 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 64 61 72 6b 29 29 0a 20 20 20 20 20 3a 69 6e 68 or).(background.dark))......:inh
50f20 65 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f erit.transient-key......:foregro
50f40 75 6e 64 20 22 67 72 65 79 33 30 22 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 und."grey30"))..."Face.used.for.
50f60 6b 65 79 73 20 6f 66 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 63 75 72 72 65 6e 74 6c 79 20 keys.of.suffixes.that.currently.
50f80 63 61 6e 6e 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 cannot.be.invoked."...:group.'tr
50fa0 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 ansient-faces)..(defface.transie
50fc0 6e 74 2d 6b 65 79 2d 72 65 74 75 72 6e 0a 20 20 60 28 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 nt-key-return...`((((class.color
50fe0 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 6c 69 67 68 74 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 ).(background.light))......:inhe
51000 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 rit.transient-key......:foregrou
51020 6e 64 20 22 23 61 61 61 61 31 31 22 29 0a 20 20 20 20 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 nd."#aaaa11").....(((class.color
51040 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 64 61 72 6b 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 ).(background.dark))......:inher
51060 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e it.transient-key......:foregroun
51080 64 20 22 23 66 66 66 66 63 63 22 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 6b d."#ffffcc"))..."Face.used.for.k
510a0 65 79 73 20 6f 66 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 72 65 74 75 72 6e 20 74 6f 20 74 eys.of.suffixes.that.return.to.t
510c0 68 65 20 70 61 72 65 6e 74 20 6d 65 6e 75 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 he.parent.menu."...:group.'trans
510e0 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d ient-faces)..(defface.transient-
51100 6b 65 79 2d 72 65 63 75 72 73 65 0a 20 20 60 28 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 29 20 key-recurse...`((((class.color).
51120 28 62 61 63 6b 67 72 6f 75 6e 64 20 6c 69 67 68 74 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 69 (background.light))......:inheri
51140 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e 64 t.transient-key......:foreground
51160 20 22 23 32 32 36 36 66 66 22 29 0a 20 20 20 20 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 29 20 ."#2266ff").....(((class.color).
51180 28 62 61 63 6b 67 72 6f 75 6e 64 20 64 61 72 6b 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 69 74 (background.dark))......:inherit
511a0 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 .transient-key......:foreground.
511c0 22 23 32 32 39 39 66 66 22 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 6b 65 79 "#2299ff"))..."Face.used.for.key
511e0 73 20 6f 66 20 73 75 62 2d 6d 65 6e 75 73 20 77 68 6f 73 65 20 73 75 66 66 69 78 65 73 20 72 65 s.of.sub-menus.whose.suffixes.re
51200 74 75 72 6e 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 6d 65 6e 75 2e 22 0a 20 20 3a 67 72 6f turn.to.the.parent.menu."...:gro
51220 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 up.'transient-faces)..(defface.t
51240 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 63 6b 0a 20 20 60 28 28 28 28 63 6c 61 73 73 20 ransient-key-stack...`((((class.
51260 63 6f 6c 6f 72 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 6c 69 67 68 74 29 29 0a 20 20 20 20 20 color).(background.light))......
51280 3a 69 6e 68 65 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 :inherit.transient-key......:for
512a0 65 67 72 6f 75 6e 64 20 22 23 64 64 34 34 38 38 22 29 0a 20 20 20 20 28 28 28 63 6c 61 73 73 20 eground."#dd4488").....(((class.
512c0 63 6f 6c 6f 72 29 20 28 62 61 63 6b 67 72 6f 75 6e 64 20 64 61 72 6b 29 29 0a 20 20 20 20 20 3a color).(background.dark))......:
512e0 69 6e 68 65 72 69 74 20 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 inherit.transient-key......:fore
51300 67 72 6f 75 6e 64 20 22 23 66 66 36 36 39 39 22 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 ground."#ff6699"))..."Face.used.
51320 66 6f 72 20 6b 65 79 73 20 6f 66 20 73 75 62 2d 6d 65 6e 75 73 20 74 68 61 74 20 65 78 69 74 20 for.keys.of.sub-menus.that.exit.
51340 74 68 65 20 70 61 72 65 6e 74 20 6d 65 6e 75 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e the.parent.menu."...:group.'tran
51360 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 sient-faces)..(defface.transient
51380 2d 6b 65 79 2d 65 78 69 74 0a 20 20 60 28 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 29 20 28 62 -key-exit...`((((class.color).(b
513a0 61 63 6b 67 72 6f 75 6e 64 20 6c 69 67 68 74 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 69 74 20 ackground.light))......:inherit.
513c0 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 22 transient-key......:foreground."
513e0 23 61 61 32 32 32 32 22 29 0a 20 20 20 20 28 28 28 63 6c 61 73 73 20 63 6f 6c 6f 72 29 20 28 62 #aa2222").....(((class.color).(b
51400 61 63 6b 67 72 6f 75 6e 64 20 64 61 72 6b 29 29 0a 20 20 20 20 20 3a 69 6e 68 65 72 69 74 20 74 ackground.dark))......:inherit.t
51420 72 61 6e 73 69 65 6e 74 2d 6b 65 79 0a 20 20 20 20 20 3a 66 6f 72 65 67 72 6f 75 6e 64 20 22 23 ransient-key......:foreground."#
51440 66 66 64 64 64 64 22 29 29 0a 20 20 22 46 61 63 65 20 75 73 65 64 20 66 6f 72 20 6b 65 79 73 20 ffdddd"))..."Face.used.for.keys.
51460 6f 66 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 65 78 69 74 20 74 68 65 20 6d 65 6e 75 2e 22 of.suffixes.that.exit.the.menu."
51480 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 ...:group.'transient-faces)..(de
514a0 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 75 6e 72 65 61 63 68 61 62 6c 65 2d 6b 65 79 0a fface.transient-unreachable-key.
514c0 20 20 27 28 28 74 20 3a 69 6e 68 65 72 69 74 20 28 73 68 61 64 6f 77 20 74 72 61 6e 73 69 65 6e ..'((t.:inherit.(shadow.transien
514e0 74 2d 6b 65 79 29 20 3a 77 65 69 67 68 74 20 6e 6f 72 6d 61 6c 29 29 0a 20 20 22 46 61 63 65 20 t-key).:weight.normal))..."Face.
51500 75 73 65 64 20 66 6f 72 20 6b 65 79 73 20 75 6e 72 65 61 63 68 61 62 6c 65 20 66 72 6f 6d 20 74 used.for.keys.unreachable.from.t
51520 68 65 20 63 75 72 72 65 6e 74 20 70 72 65 66 69 78 20 73 65 71 75 65 6e 63 65 2e 22 0a 20 20 3a he.current.prefix.sequence."...:
51540 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 28 64 65 66 66 61 63 group.'transient-faces)..(deffac
51560 65 20 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 73 74 61 6e 64 61 72 64 2d 6b 65 79 0a 20 20 60 28 e.transient-nonstandard-key...`(
51580 28 74 20 3a 62 6f 78 20 28 20 3a 6c 69 6e 65 2d 77 69 64 74 68 20 2c 28 69 66 20 28 3e 3d 20 65 (t.:box.(.:line-width.,(if.(>=.e
515a0 6d 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 32 38 29 20 28 63 6f 6e 73 20 2d 31 20 macs-major-version.28).(cons.-1.
515c0 2d 31 29 20 2d 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 63 6f 6c 6f 72 20 22 63 79 -1).-1)...............:color."cy
515e0 61 6e 22 29 29 29 0a 20 20 22 46 61 63 65 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 75 73 65 64 20 74 an")))..."Face.optionally.used.t
51600 6f 20 68 69 67 68 6c 69 67 68 74 20 6b 65 79 73 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 77 69 74 o.highlight.keys.conflicting.wit
51620 68 20 73 68 6f 72 74 2d 61 72 67 75 6d 65 6e 74 2e 0a 53 65 65 20 61 6c 73 6f 20 6f 70 74 69 6f h.short-argument..See.also.optio
51640 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 6d 69 73 6d 61 74 63 68 65 n.`transient-highlight-mismatche
51660 64 2d 6b 65 79 73 27 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 d-keys'."...:group.'transient-fa
51680 63 65 73 29 0a 0a 28 64 65 66 66 61 63 65 20 74 72 61 6e 73 69 65 6e 74 2d 6d 69 73 6d 61 74 63 ces)..(defface.transient-mismatc
516a0 68 65 64 2d 6b 65 79 0a 20 20 60 28 28 74 20 3a 62 6f 78 20 28 20 3a 6c 69 6e 65 2d 77 69 64 74 hed-key...`((t.:box.(.:line-widt
516c0 68 20 2c 28 69 66 20 28 3e 3d 20 65 6d 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 32 h.,(if.(>=.emacs-major-version.2
516e0 38 29 20 28 63 6f 6e 73 20 2d 31 20 2d 31 29 20 2d 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 8).(cons.-1.-1).-1).............
51700 20 20 3a 63 6f 6c 6f 72 20 22 6d 61 67 65 6e 74 61 22 29 29 29 0a 20 20 22 46 61 63 65 20 6f 70 ..:color."magenta")))..."Face.op
51720 74 69 6f 6e 61 6c 6c 79 20 75 73 65 64 20 74 6f 20 68 69 67 68 6c 69 67 68 74 20 6b 65 79 73 20 tionally.used.to.highlight.keys.
51740 77 69 74 68 6f 75 74 20 61 20 73 68 6f 72 74 2d 61 72 67 75 6d 65 6e 74 2e 0a 53 65 65 20 61 6c without.a.short-argument..See.al
51760 73 6f 20 6f 70 74 69 6f 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 6d so.option.`transient-highlight-m
51780 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 73 27 2e 22 0a 20 20 3a 67 72 6f 75 70 20 27 74 72 61 6e ismatched-keys'."...:group.'tran
517a0 73 69 65 6e 74 2d 66 61 63 65 73 29 0a 0a 3b 3b 3b 20 50 65 72 73 69 73 74 65 6e 63 65 0a 0a 28 sient-faces)..;;;.Persistence..(
517c0 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 61 64 2d 66 69 6c 65 2d 63 6f 6e 74 65 defun.transient--read-file-conte
517e0 6e 74 73 20 28 66 69 6c 65 29 0a 20 20 28 77 69 74 68 2d 64 65 6d 6f 74 65 64 2d 65 72 72 6f 72 nts.(file)...(with-demoted-error
51800 73 20 22 54 72 61 6e 73 69 65 6e 74 20 65 72 72 6f 72 3a 20 25 53 22 0a 20 20 20 20 28 61 6e 64 s."Transient.error:.%S".....(and
51820 20 28 66 69 6c 65 2d 65 78 69 73 74 73 2d 70 20 66 69 6c 65 29 0a 20 20 20 20 20 20 20 20 20 28 .(file-exists-p.file)..........(
51840 77 69 74 68 2d 74 65 6d 70 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 73 with-temp-buffer............(ins
51860 65 72 74 2d 66 69 6c 65 2d 63 6f 6e 74 65 6e 74 73 20 66 69 6c 65 29 0a 20 20 20 20 20 20 20 20 ert-file-contents.file).........
51880 20 20 20 28 72 65 61 64 20 28 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 29 29 29 29 0a 0a ...(read.(current-buffer))))))..
518a0 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 70 2d 74 6f 2d 66 69 6c 65 20 28 6c 69 (defun.transient--pp-to-file.(li
518c0 73 74 20 66 69 6c 65 29 0a 20 20 28 6d 61 6b 65 2d 64 69 72 65 63 74 6f 72 79 20 28 66 69 6c 65 st.file)...(make-directory.(file
518e0 2d 6e 61 6d 65 2d 64 69 72 65 63 74 6f 72 79 20 66 69 6c 65 29 20 74 29 0a 20 20 28 73 65 74 71 -name-directory.file).t)...(setq
51900 20 6c 69 73 74 20 28 63 6c 2d 73 6f 72 74 20 28 63 6f 70 79 2d 73 65 71 75 65 6e 63 65 20 6c 69 .list.(cl-sort.(copy-sequence.li
51920 73 74 29 20 23 27 73 74 72 69 6e 67 3c 20 3a 6b 65 79 20 23 27 63 61 72 29 29 0a 20 20 28 77 69 st).#'string<.:key.#'car))...(wi
51940 74 68 2d 74 65 6d 70 2d 66 69 6c 65 20 66 69 6c 65 0a 20 20 20 20 28 6c 65 74 20 28 28 70 72 69 th-temp-file.file.....(let.((pri
51960 6e 74 2d 6c 65 76 65 6c 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 20 28 70 72 69 6e 74 2d 6c nt-level.nil)...........(print-l
51980 65 6e 67 74 68 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 20 28 70 70 2d 64 65 66 61 75 6c 74 ength.nil)...........(pp-default
519a0 2d 66 75 6e 63 74 69 6f 6e 20 27 70 70 2d 32 38 29 0a 20 20 20 20 20 20 20 20 20 20 28 66 69 6c -function.'pp-28)...........(fil
519c0 6c 2d 63 6f 6c 75 6d 6e 20 39 39 39 29 29 0a 20 20 20 20 20 20 28 70 70 20 6c 69 73 74 20 28 63 l-column.999)).......(pp.list.(c
519e0 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 29 29 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e urrent-buffer)))))..(defvar.tran
51a00 73 69 65 6e 74 2d 76 61 6c 75 65 73 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 61 64 2d sient-values...(transient--read-
51a20 66 69 6c 65 2d 63 6f 6e 74 65 6e 74 73 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 73 2d 66 file-contents.transient-values-f
51a40 69 6c 65 29 0a 20 20 22 56 61 6c 75 65 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d ile)..."Values.of.transient.comm
51a60 61 6e 64 73 2e 0a 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 ands..The.value.of.this.variable
51a80 20 70 65 72 73 69 73 74 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 .persists.between.Emacs.sessions
51aa0 0a 61 6e 64 20 79 6f 75 20 75 73 75 61 6c 6c 79 20 73 68 6f 75 6c 64 20 6e 6f 74 20 63 68 61 6e .and.you.usually.should.not.chan
51ac0 67 65 20 69 74 20 6d 61 6e 75 61 6c 6c 79 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 ge.it.manually.")..(defun.transi
51ae0 65 6e 74 2d 73 61 76 65 2d 76 61 6c 75 65 73 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d ent-save-values.()...(transient-
51b00 2d 70 70 2d 74 6f 2d 66 69 6c 65 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 73 20 74 72 61 -pp-to-file.transient-values.tra
51b20 6e 73 69 65 6e 74 2d 76 61 6c 75 65 73 2d 66 69 6c 65 29 29 0a 0a 28 64 65 66 76 61 72 20 74 72 nsient-values-file))..(defvar.tr
51b40 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 61 ansient-levels...(transient--rea
51b60 64 2d 66 69 6c 65 2d 63 6f 6e 74 65 6e 74 73 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 d-file-contents.transient-levels
51b80 2d 66 69 6c 65 29 0a 20 20 22 4c 65 76 65 6c 73 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 20 63 6f -file)..."Levels.of.transient.co
51ba0 6d 6d 61 6e 64 73 2e 0a 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 76 61 72 69 61 62 mmands..The.value.of.this.variab
51bc0 6c 65 20 70 65 72 73 69 73 74 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 20 73 65 73 73 69 6f le.persists.between.Emacs.sessio
51be0 6e 73 0a 61 6e 64 20 79 6f 75 20 75 73 75 61 6c 6c 79 20 73 68 6f 75 6c 64 20 6e 6f 74 20 63 68 ns.and.you.usually.should.not.ch
51c00 61 6e 67 65 20 69 74 20 6d 61 6e 75 61 6c 6c 79 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e ange.it.manually.")..(defun.tran
51c20 73 69 65 6e 74 2d 73 61 76 65 2d 6c 65 76 65 6c 73 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e sient-save-levels.()...(transien
51c40 74 2d 2d 70 70 2d 74 6f 2d 66 69 6c 65 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 20 74 t--pp-to-file.transient-levels.t
51c60 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 2d 66 69 6c 65 29 29 0a 0a 28 64 65 66 76 61 72 20 ransient-levels-file))..(defvar.
51c80 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d transient-history...(transient--
51ca0 72 65 61 64 2d 66 69 6c 65 2d 63 6f 6e 74 65 6e 74 73 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 read-file-contents.transient-his
51cc0 74 6f 72 79 2d 66 69 6c 65 29 0a 20 20 22 48 69 73 74 6f 72 79 20 6f 66 20 74 72 61 6e 73 69 65 tory-file)..."History.of.transie
51ce0 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e nt.commands.and.infix.arguments.
51d00 0a 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 20 70 65 72 73 .The.value.of.this.variable.pers
51d20 69 73 74 73 20 62 65 74 77 65 65 6e 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 73 0a 5c 28 75 6e ists.between.Emacs.sessions.\(un
51d40 6c 65 73 73 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 27 20 69 73 less.`transient-save-history'.is
51d60 20 6e 69 6c 29 20 61 6e 64 20 79 6f 75 20 75 73 75 61 6c 6c 79 0a 73 68 6f 75 6c 64 20 6e 6f 74 .nil).and.you.usually.should.not
51d80 20 63 68 61 6e 67 65 20 69 74 20 6d 61 6e 75 61 6c 6c 79 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 .change.it.manually.")..(defun.t
51da0 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 20 28 29 0a 20 20 28 73 65 74 71 ransient-save-history.()...(setq
51dc0 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 0a 20 20 20 20 20 20 20 20 28 63 6c 2d 73 .transient-history.........(cl-s
51de0 6f 72 74 20 28 6d 61 70 63 61 72 20 28 70 63 61 73 65 2d 6c 61 6d 62 64 61 20 28 60 28 2c 6b 65 ort.(mapcar.(pcase-lambda.(`(,ke
51e00 79 20 2e 20 2c 76 61 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y...,val))......................
51e20 20 20 20 20 20 20 28 63 6f 6e 73 20 6b 65 79 20 28 73 65 71 2d 74 61 6b 65 20 28 64 65 6c 65 74 ......(cons.key.(seq-take.(delet
51e40 65 2d 64 75 70 73 20 76 61 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e-dups.val).....................
51e60 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 74 72 61 6e 73 ...........................trans
51e80 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 6c 69 6d 69 74 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 ient-history-limit)))...........
51ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 ...............transient-history
51ec0 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 73 74 72 69 6e 67 3c 20 3a 6b 65 )..................#'string<.:ke
51ee0 79 20 23 27 63 61 72 29 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 70 2d 74 6f 2d 66 69 y.#'car))...(transient--pp-to-fi
51f00 6c 65 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 20 74 72 61 6e 73 69 65 6e 74 2d 68 le.transient-history.transient-h
51f20 69 73 74 6f 72 79 2d 66 69 6c 65 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d istory-file))..(defun.transient-
51f40 6d 61 79 62 65 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 20 28 29 0a 20 20 22 53 61 76 65 20 74 68 maybe-save-history.()..."Save.th
51f60 65 20 76 61 6c 75 65 20 6f 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 27 2e 0a e.value.of.`transient-history'..
51f80 49 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 27 20 69 73 20 6e If.`transient-save-history'.is.n
51fa0 69 6c 2c 20 74 68 65 6e 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 22 0a 20 20 28 77 68 65 6e 20 74 72 il,.then.do.nothing."...(when.tr
51fc0 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 0a 20 20 20 20 28 77 69 74 68 2d 64 ansient-save-history.....(with-d
51fe0 65 6d 6f 74 65 64 2d 65 72 72 6f 72 73 20 22 45 72 72 6f 72 20 73 61 76 69 6e 67 20 74 72 61 6e emoted-errors."Error.saving.tran
52000 73 69 65 6e 74 20 68 69 73 74 6f 72 79 3a 20 25 53 22 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 sient.history:.%S".......(transi
52020 65 6e 74 2d 73 61 76 65 2d 68 69 73 74 6f 72 79 29 29 29 29 0a 0a 28 75 6e 6c 65 73 73 20 6e 6f ent-save-history))))..(unless.no
52040 6e 69 6e 74 65 72 61 63 74 69 76 65 0a 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 6b 69 6c 6c 2d 65 ninteractive...(add-hook.'kill-e
52060 6d 61 63 73 2d 68 6f 6f 6b 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 6d 61 79 62 65 2d 73 61 76 65 macs-hook.#'transient-maybe-save
52080 2d 68 69 73 74 6f 72 79 29 29 0a 0a 3b 3b 3b 20 43 6c 61 73 73 65 73 0a 3b 3b 3b 3b 20 50 72 65 -history))..;;;.Classes.;;;;.Pre
520a0 66 69 78 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 20 fix..(defclass.transient-prefix.
520c0 28 29 0a 20 20 28 28 70 72 6f 74 6f 74 79 70 65 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 70 72 6f ()...((prototype...:initarg.:pro
520e0 74 6f 74 79 70 65 29 0a 20 20 20 28 63 6f 6d 6d 61 6e 64 20 20 20 20 20 3a 69 6e 69 74 61 72 67 totype)....(command.....:initarg
52100 20 3a 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 28 6c 65 76 65 6c 20 20 20 20 20 20 20 3a 69 6e 69 74 .:command)....(level.......:init
52120 61 72 67 20 3a 6c 65 76 65 6c 29 0a 20 20 20 28 69 6e 69 74 2d 76 61 6c 75 65 20 20 3a 69 6e 69 arg.:level)....(init-value..:ini
52140 74 61 72 67 20 3a 69 6e 69 74 2d 76 61 6c 75 65 29 0a 20 20 20 28 76 61 6c 75 65 29 20 28 64 65 targ.:init-value)....(value).(de
52160 66 61 75 6c 74 2d 76 61 6c 75 65 20 3a 69 6e 69 74 61 72 67 20 3a 76 61 6c 75 65 29 0a 20 20 20 fault-value.:initarg.:value)....
52180 28 72 65 74 75 72 6e 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 72 65 74 75 72 6e 20 20 20 (return......:initarg.:return...
521a0 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 73 63 6f 70 65 20 20 20 20 20 ...:initform.nil)....(scope.....
521c0 20 20 3a 69 6e 69 74 61 72 67 20 3a 73 63 6f 70 65 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 ..:initarg.:scope.......:initfor
521e0 6d 20 6e 69 6c 29 0a 20 20 20 28 68 69 73 74 6f 72 79 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 m.nil)....(history.....:initarg.
52200 3a 68 69 73 74 6f 72 79 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 :history.....:initform.nil)....(
52220 68 69 73 74 6f 72 79 2d 70 6f 73 20 3a 69 6e 69 74 61 72 67 20 3a 68 69 73 74 6f 72 79 2d 70 6f history-pos.:initarg.:history-po
52240 73 20 3a 69 6e 69 74 66 6f 72 6d 20 30 29 0a 20 20 20 28 68 69 73 74 6f 72 79 2d 6b 65 79 20 3a s.:initform.0)....(history-key.:
52260 69 6e 69 74 61 72 67 20 3a 68 69 73 74 6f 72 79 2d 6b 65 79 20 3a 69 6e 69 74 66 6f 72 6d 20 6e initarg.:history-key.:initform.n
52280 69 6c 29 0a 20 20 20 28 73 68 6f 77 2d 68 65 6c 70 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 73 68 il)....(show-help...:initarg.:sh
522a0 6f 77 2d 68 65 6c 70 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 69 6e 66 ow-help...:initform.nil)....(inf
522c0 6f 2d 6d 61 6e 75 61 6c 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 66 6f 2d 6d 61 6e 75 61 6c 20 3a o-manual.:initarg.:info-manual.:
522e0 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 6d 61 6e 2d 70 61 67 65 20 20 20 20 3a 69 initform.nil)....(man-page....:i
52300 6e 69 74 61 72 67 20 3a 6d 61 6e 2d 70 61 67 65 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 nitarg.:man-page....:initform.ni
52320 6c 29 0a 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 20 20 20 20 20 3a 69 6e 69 l)....(transient-suffix.....:ini
52340 74 61 72 67 20 3a 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 20 20 20 20 20 3a 69 6e 69 74 targ.:transient-suffix.....:init
52360 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 form.nil)....(transient-non-suff
52380 69 78 20 3a 69 6e 69 74 61 72 67 20 3a 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 ix.:initarg.:transient-non-suffi
523a0 78 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 x.:initform.nil)....(transient-s
523c0 77 69 74 63 68 2d 66 72 61 6d 65 20 3a 69 6e 69 74 61 72 67 20 3a 74 72 61 6e 73 69 65 6e 74 2d witch-frame.:initarg.:transient-
523e0 73 77 69 74 63 68 2d 66 72 61 6d 65 29 0a 20 20 20 28 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 switch-frame)....(refresh-suffix
52400 65 73 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 es.....:initarg.:refresh-suffixe
52420 73 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 72 65 6d 65 6d 62 65 s.....:initform.nil)....(remembe
52440 72 2d 76 61 6c 75 65 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 72 65 6d 65 6d 62 65 72 r-value.......:initarg.:remember
52460 2d 76 61 6c 75 65 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 -value.......:initform.nil)....(
52480 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 65 environment..........:initarg.:e
524a0 6e 76 69 72 6f 6e 6d 65 6e 74 20 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 nvironment..........:initform.ni
524c0 6c 29 0a 20 20 20 28 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 20 20 20 20 20 20 20 20 3a 69 6e 69 l)....(incompatible.........:ini
524e0 74 61 72 67 20 3a 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 targ.:incompatible.........:init
52500 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 73 75 66 66 69 78 2d 64 65 73 63 72 69 70 74 69 6f 6e form.nil)....(suffix-description
52520 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 73 75 66 66 69 78 2d 64 65 73 63 72 69 70 74 69 6f 6e 29 ...:initarg.:suffix-description)
52540 0a 20 20 20 28 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 20 20 20 20 20 20 20 3a 69 6e 69 74 61 ....(display-action.......:inita
52560 72 67 20 3a 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f rg.:display-action.......:initfo
52580 72 6d 20 6e 69 6c 29 0a 20 20 20 28 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 20 20 20 20 rm.nil)....(mode-line-format....
525a0 20 3a 69 6e 69 74 61 72 67 20 3a 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 29 0a 20 20 20 .:initarg.:mode-line-format)....
525c0 28 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a (variable-pitch.......:initarg.:
525e0 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e variable-pitch.......:initform.n
52600 69 6c 29 0a 20 20 20 28 63 6f 6c 75 6d 6e 2d 77 69 64 74 68 73 20 20 20 20 20 20 20 20 3a 69 6e il)....(column-widths........:in
52620 69 74 61 72 67 20 3a 63 6f 6c 75 6d 6e 2d 77 69 64 74 68 73 20 20 20 20 20 20 20 20 3a 69 6e 69 itarg.:column-widths........:ini
52640 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 20 20 20 20 tform.nil)....(unwind-suffix....
52660 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 49 6e 74 65 72 6e 61 6c 20 75 73 65 ....:documentation."Internal.use
52680 2e 22 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 29 0a 20 20 22 54 72 61 6e 73 69 65 6e 74 20 .".:initform.nil))..."Transient.
526a0 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 45 61 63 68 20 74 72 61 6e 73 69 65 6e 74 20 prefix.command...Each.transient.
526c0 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 63 6f 6d prefix.command.consists.of.a.com
526e0 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 73 0a 73 74 6f 72 65 64 20 69 6e 20 61 20 73 79 6d 62 6f mand,.which.is.stored.in.a.symbo
52700 6c 27 73 20 66 75 6e 63 74 69 6f 6e 20 73 6c 6f 74 20 61 6e 64 20 61 6e 20 6f 62 6a 65 63 74 2c l's.function.slot.and.an.object,
52720 20 77 68 69 63 68 20 69 73 0a 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 60 74 72 61 6e 73 69 65 .which.is.stored.in.the.`transie
52740 6e 74 2d 2d 70 72 65 66 69 78 27 20 70 72 6f 70 65 72 74 79 20 6f 66 20 74 68 65 20 73 61 6d 65 nt--prefix'.property.of.the.same
52760 20 73 79 6d 62 6f 6c 2e 0a 0a 57 68 65 6e 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 .symbol...When.a.transient.prefi
52780 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 65 6e 20 61 20 63 6c 6f x.command.is.invoked,.then.a.clo
527a0 6e 65 20 6f 66 20 74 68 61 74 0a 6f 62 6a 65 63 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 ne.of.that.object.is.stored.in.t
527c0 68 65 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 70 he.global.variable.`transient--p
527e0 72 65 66 69 78 27 20 61 6e 64 0a 74 68 65 20 70 72 6f 74 6f 74 79 70 65 20 69 73 20 73 74 6f 72 refix'.and.the.prototype.is.stor
52800 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 6e 65 27 73 20 60 70 72 6f 74 6f 74 79 70 65 27 20 73 6c ed.in.the.clone's.`prototype'.sl
52820 6f 74 2e 22 29 0a 0a 3b 3b 3b 3b 20 53 75 66 66 69 78 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 ot.")..;;;;.Suffix..(defclass.tr
52840 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 20 28 29 0a 20 20 28 28 70 61 72 65 6e 74 0a 20 20 20 20 ansient-child.()...((parent.....
52860 3a 69 6e 69 74 61 72 67 20 3a 70 61 72 65 6e 74 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e :initarg.:parent.....:initform.n
52880 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 54 68 65 20 70 61 72 65 6e il.....:documentation."The.paren
528a0 74 20 67 72 6f 75 70 20 6f 62 6a 65 63 74 2e 22 29 0a 20 20 20 28 6c 65 76 65 6c 0a 20 20 20 20 t.group.object.")....(level.....
528c0 3a 69 6e 69 74 61 72 67 20 3a 6c 65 76 65 6c 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 :initarg.:level.....:initform.ni
528e0 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 l.....:documentation."Enable.if.
52900 6c 65 76 65 6c 20 6f 66 20 70 72 65 66 69 78 20 69 73 20 65 71 75 61 6c 20 6f 72 20 67 72 65 61 level.of.prefix.is.equal.or.grea
52920 74 65 72 2e 22 29 0a 20 20 20 28 69 6e 61 63 74 69 76 65 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 ter.")....(inactive.....:initfor
52940 6d 20 6e 69 6c 29 0a 20 20 20 28 69 66 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 66 0a 20 m.nil)....(if.....:initarg.:if..
52960 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 ...:initform.nil.....:documentat
52980 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 ion."Enable.if.predicate.returns
529a0 20 6e 6f 6e 2d 6e 69 6c 2e 22 29 0a 20 20 20 28 69 66 2d 6e 6f 74 0a 20 20 20 20 3a 69 6e 69 74 .non-nil.")....(if-not.....:init
529c0 61 72 67 20 3a 69 66 2d 6e 6f 74 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 arg.:if-not.....:initform.nil...
529e0 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 70 72 65 64 ..:documentation."Enable.if.pred
52a00 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 6e 69 6c 2e 22 29 0a 20 20 20 28 69 66 2d 6e 6f 6e 2d icate.returns.nil.")....(if-non-
52a20 6e 69 6c 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 66 2d 6e 6f 6e 2d 6e 69 6c 0a 20 20 20 nil.....:initarg.:if-non-nil....
52a40 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f .:initform.nil.....:documentatio
52a60 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 76 61 72 69 61 62 6c 65 27 73 20 76 61 6c 75 65 20 69 73 n."Enable.if.variable's.value.is
52a80 20 6e 6f 6e 2d 6e 69 6c 2e 22 29 0a 20 20 20 28 69 66 2d 6e 69 6c 0a 20 20 20 20 3a 69 6e 69 74 .non-nil.")....(if-nil.....:init
52aa0 61 72 67 20 3a 69 66 2d 6e 69 6c 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 arg.:if-nil.....:initform.nil...
52ac0 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 76 61 72 69 ..:documentation."Enable.if.vari
52ae0 61 62 6c 65 27 73 20 76 61 6c 75 65 20 69 73 20 6e 69 6c 2e 22 29 0a 20 20 20 28 69 66 2d 6d 6f able's.value.is.nil.")....(if-mo
52b00 64 65 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 66 2d 6d 6f 64 65 0a 20 20 20 20 3a 69 6e de.....:initarg.:if-mode.....:in
52b20 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 itform.nil.....:documentation."E
52b40 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 6d 61 74 63 68 65 73 20 76 61 6c 75 nable.if.major-mode.matches.valu
52b60 65 2e 22 29 0a 20 20 20 28 69 66 2d 6e 6f 74 2d 6d 6f 64 65 0a 20 20 20 20 3a 69 6e 69 74 61 72 e.")....(if-not-mode.....:initar
52b80 67 20 3a 69 66 2d 6e 6f 74 2d 6d 6f 64 65 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c g.:if-not-mode.....:initform.nil
52ba0 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 6d .....:documentation."Enable.if.m
52bc0 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 76 61 6c 75 65 2e 22 ajor-mode.does.not.match.value."
52be0 29 0a 20 20 20 28 69 66 2d 64 65 72 69 76 65 64 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 )....(if-derived.....:initarg.:i
52c00 66 2d 64 65 72 69 76 65 64 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 f-derived.....:initform.nil.....
52c20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 2d :documentation."Enable.if.major-
52c40 6d 6f 64 65 20 64 65 72 69 76 65 73 20 66 72 6f 6d 20 76 61 6c 75 65 2e 22 29 0a 20 20 20 28 69 mode.derives.from.value.")....(i
52c60 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 66 2d 6e f-not-derived.....:initarg.:if-n
52c80 6f 74 2d 64 65 72 69 76 65 64 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 ot-derived.....:initform.nil....
52ca0 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 45 6e 61 62 6c 65 20 69 66 20 6d 61 6a 6f 72 .:documentation."Enable.if.major
52cc0 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 64 65 72 69 76 65 20 66 72 6f 6d 20 76 61 6c 75 65 -mode.does.not.derive.from.value
52ce0 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 .")....(inapt.....:initform.nil)
52d00 0a 20 20 20 28 69 6e 61 70 74 2d 66 61 63 65 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e ....(inapt-face.....:initarg.:in
52d20 61 70 74 2d 66 61 63 65 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 27 74 72 61 6e 73 69 65 6e apt-face.....:initform.'transien
52d40 74 2d 69 6e 61 70 74 2d 73 75 66 66 69 78 29 0a 20 20 20 28 69 6e 61 70 74 2d 69 66 0a 20 20 20 t-inapt-suffix)....(inapt-if....
52d60 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 .:initarg.:inapt-if.....:initfor
52d80 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 49 6e 61 70 74 20 m.nil.....:documentation."Inapt.
52da0 69 66 20 70 72 65 64 69 63 61 74 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 6e 69 6c 2e 22 29 0a if.predicate.returns.non-nil.").
52dc0 20 20 20 28 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 ...(inapt-if-not.....:initarg.:i
52de0 6e 61 70 74 2d 69 66 2d 6e 6f 74 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 napt-if-not.....:initform.nil...
52e00 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 49 6e 61 70 74 20 69 66 20 70 72 65 64 69 ..:documentation."Inapt.if.predi
52e20 63 61 74 65 20 72 65 74 75 72 6e 73 20 6e 69 6c 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 2d 69 66 cate.returns.nil.")....(inapt-if
52e40 2d 6e 6f 6e 2d 6e 69 6c 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 2d -non-nil.....:initarg.:inapt-if-
52e60 6e 6f 6e 2d 6e 69 6c 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 non-nil.....:initform.nil.....:d
52e80 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 49 6e 61 70 74 20 69 66 20 76 61 72 69 61 62 6c 65 27 ocumentation."Inapt.if.variable'
52ea0 73 20 76 61 6c 75 65 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 2d s.value.is.non-nil.")....(inapt-
52ec0 69 66 2d 6e 69 6c 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 2d 6e 69 if-nil.....:initarg.:inapt-if-ni
52ee0 6c 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e l.....:initform.nil.....:documen
52f00 74 61 74 69 6f 6e 20 22 49 6e 61 70 74 20 69 66 20 76 61 72 69 61 62 6c 65 27 73 20 76 61 6c 75 tation."Inapt.if.variable's.valu
52f20 65 20 69 73 20 6e 69 6c 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 2d 69 66 2d 6d 6f 64 65 0a 20 20 e.is.nil.")....(inapt-if-mode...
52f40 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 2d 6d 6f 64 65 0a 20 20 20 20 3a 69 ..:initarg.:inapt-if-mode.....:i
52f60 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 nitform.nil.....:documentation."
52f80 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 6d 61 74 63 68 65 73 20 76 61 6c 75 Inapt.if.major-mode.matches.valu
52fa0 65 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 6d 6f 64 65 0a 20 20 20 20 3a e.")....(inapt-if-not-mode.....:
52fc0 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 6d 6f 64 65 0a 20 20 20 20 3a initarg.:inapt-if-not-mode.....:
52fe0 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 initform.nil.....:documentation.
53000 22 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 6d 61 "Inapt.if.major-mode.does.not.ma
53020 74 63 68 20 76 61 6c 75 65 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 2d 69 66 2d 64 65 72 69 76 65 tch.value.")....(inapt-if-derive
53040 64 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 2d 64 65 72 69 76 65 64 d.....:initarg.:inapt-if-derived
53060 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 .....:initform.nil.....:document
53080 61 74 69 6f 6e 20 22 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 64 65 72 69 76 ation."Inapt.if.major-mode.deriv
530a0 65 73 20 66 72 6f 6d 20 76 61 6c 75 65 2e 22 29 0a 20 20 20 28 69 6e 61 70 74 2d 69 66 2d 6e 6f es.from.value.")....(inapt-if-no
530c0 74 2d 64 65 72 69 76 65 64 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 61 70 74 2d 69 66 t-derived.....:initarg.:inapt-if
530e0 2d 6e 6f 74 2d 64 65 72 69 76 65 64 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 -not-derived.....:initform.nil..
53100 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 49 6e 61 70 74 20 69 66 20 6d 61 6a 6f ...:documentation."Inapt.if.majo
53120 72 2d 6d 6f 64 65 20 64 6f 65 73 20 6e 6f 74 20 64 65 72 69 76 65 20 66 72 6f 6d 20 76 61 6c 75 r-mode.does.not.derive.from.valu
53140 65 2e 22 29 0a 20 20 20 28 61 64 76 69 63 65 0a 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 61 64 e.")....(advice.....:initarg.:ad
53160 76 69 63 65 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 vice.....:initform.nil.....:docu
53180 6d 65 6e 74 61 74 69 6f 6e 20 22 41 64 76 69 73 65 20 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 mentation."Advise.applied.to.the
531a0 20 63 6f 6d 6d 61 6e 64 20 62 6f 64 79 2e 22 29 0a 20 20 20 28 61 64 76 69 63 65 2a 0a 20 20 20 .command.body.")....(advice*....
531c0 20 3a 69 6e 69 74 61 72 67 20 3a 61 64 76 69 63 65 2a 0a 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d .:initarg.:advice*.....:initform
531e0 20 6e 69 6c 0a 20 20 20 20 3a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 22 41 64 76 69 73 65 20 .nil.....:documentation."Advise.
53200 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 62 6f 64 79 20 61 6e 64 20 applied.to.the.command.body.and.
53220 69 6e 74 65 72 61 63 74 69 76 65 20 73 70 65 63 2e 22 29 29 0a 20 20 22 41 62 73 74 72 61 63 74 interactive.spec."))..."Abstract
53240 20 73 75 70 65 72 63 6c 61 73 73 20 66 6f 72 20 67 72 6f 75 70 20 61 6e 64 20 73 75 66 66 69 78 .superclass.for.group.and.suffix
53260 20 63 6c 61 73 73 65 73 2e 0a 0a 49 74 20 69 73 20 75 6e 64 65 66 69 6e 65 64 20 77 68 69 63 68 .classes...It.is.undefined.which
53280 20 70 72 65 64 69 63 61 74 65 73 20 61 72 65 20 75 73 65 64 20 69 66 20 6d 6f 72 65 20 74 68 61 .predicates.are.used.if.more.tha
532a0 6e 20 6f 6e 65 20 60 69 66 2a 27 0a 70 72 65 64 69 63 61 74 65 20 73 6c 6f 74 73 20 6f 72 20 6d n.one.`if*'.predicate.slots.or.m
532c0 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 60 69 6e 61 70 74 2d 69 66 2a 27 20 73 6c 6f 74 73 20 61 ore.than.one.`inapt-if*'.slots.a
532e0 72 65 20 6e 6f 6e 2d 6e 69 6c 2e 22 0a 20 20 3a 61 62 73 74 72 61 63 74 20 74 29 0a 0a 28 64 65 re.non-nil."...:abstract.t)..(de
53300 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 20 28 74 72 61 6e 73 69 65 fclass.transient-suffix.(transie
53320 6e 74 2d 63 68 69 6c 64 29 0a 20 20 28 28 64 65 66 69 6e 69 74 69 6f 6e 20 20 3a 61 6c 6c 6f 63 nt-child)...((definition..:alloc
53340 61 74 69 6f 6e 20 3a 63 6c 61 73 73 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 ation.:class....:initform.nil)..
53360 20 20 28 6b 65 79 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 6b 65 79 29 0a 20 20 ..(key.........:initarg.:key)...
53380 20 28 63 6f 6d 6d 61 6e 64 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 63 6f 6d 6d 61 6e 64 29 .(command.....:initarg.:command)
533a0 0a 20 20 20 28 74 72 61 6e 73 69 65 6e 74 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 74 72 61 6e 73 ....(transient...:initarg.:trans
533c0 69 65 6e 74 29 0a 20 20 20 28 66 6f 72 6d 61 74 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a ient)....(format......:initarg.:
533e0 66 6f 72 6d 61 74 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 22 20 25 6b 20 25 64 22 29 0a format......:initform.".%k.%d").
53400 20 20 20 28 64 65 73 63 72 69 70 74 69 6f 6e 20 3a 69 6e 69 74 61 72 67 20 3a 64 65 73 63 72 69 ...(description.:initarg.:descri
53420 70 74 69 6f 6e 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 66 61 63 65 20 20 20 ption.:initform.nil)....(face...
53440 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 66 61 63 65 20 20 20 20 20 20 20 20 3a 69 6e 69 74 .....:initarg.:face........:init
53460 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 73 68 6f 77 2d 68 65 6c 70 20 20 20 3a 69 6e 69 74 61 form.nil)....(show-help...:inita
53480 72 67 20 3a 73 68 6f 77 2d 68 65 6c 70 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 rg.:show-help...:initform.nil)..
534a0 20 20 28 73 75 6d 6d 61 72 79 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 73 75 6d 6d 61 72 79 ..(summary.....:initarg.:summary
534c0 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 29 0a 20 20 22 53 75 70 65 72 63 6c 61 .....:initform.nil))..."Supercla
534e0 73 73 20 66 6f 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 22 29 0a 0a 28 64 65 66 63 6c ss.for.suffix.command.")..(defcl
53500 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 28 74 72 61 6e 73 ass.transient-information.(trans
53520 69 65 6e 74 2d 73 75 66 66 69 78 29 0a 20 20 28 28 66 6f 72 6d 61 74 20 3a 69 6e 69 74 66 6f 72 ient-suffix)...((format.:initfor
53540 6d 20 22 20 25 6b 20 25 64 22 29 0a 20 20 20 28 6b 65 79 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d m.".%k.%d")....(key....:initform
53560 20 22 20 22 29 29 0a 20 20 22 44 69 73 70 6c 61 79 2d 6f 6e 6c 79 20 69 6e 66 6f 72 6d 61 74 69 ."."))..."Display-only.informati
53580 6f 6e 2c 20 61 6c 69 67 6e 65 64 20 77 69 74 68 20 73 75 66 66 69 78 20 6b 65 79 73 2e 0a 54 65 on,.aligned.with.suffix.keys..Te
535a0 63 68 6e 69 63 61 6c 6c 79 20 61 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 20 77 69 74 68 20 6e chnically.a.suffix.object.with.n
535c0 6f 20 61 73 73 6f 63 69 61 74 65 64 20 63 6f 6d 6d 61 6e 64 2e 22 29 0a 0a 28 64 65 66 63 6c 61 o.associated.command.")..(defcla
535e0 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 2a 20 28 74 72 61 6e 73 ss.transient-information*.(trans
53600 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 29 0a 20 20 28 28 66 6f 72 6d 61 74 20 3a 69 6e ient-information)...((format.:in
53620 69 74 66 6f 72 6d 20 22 20 25 64 22 29 29 0a 20 20 22 44 69 73 70 6c 61 79 2d 6f 6e 6c 79 20 69 itform.".%d"))..."Display-only.i
53640 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 61 6c 69 67 6e 65 64 20 77 69 74 68 20 73 75 66 66 69 78 20 nformation,.aligned.with.suffix.
53660 64 65 73 63 72 69 70 74 69 6f 6e 73 2e 0a 54 65 63 68 6e 69 63 61 6c 6c 79 20 61 20 73 75 66 66 descriptions..Technically.a.suff
53680 69 78 20 6f 62 6a 65 63 74 20 77 69 74 68 20 6e 6f 20 61 73 73 6f 63 69 61 74 65 64 20 63 6f 6d ix.object.with.no.associated.com
536a0 6d 61 6e 64 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 mand.")..(defclass.transient-inf
536c0 69 78 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 0a 20 20 28 28 74 72 61 6e 73 69 ix.(transient-suffix)...((transi
536e0 65 6e 74 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 3a 69 6e 69 ent.........................:ini
53700 74 66 6f 72 6d 20 74 29 0a 20 20 20 28 61 72 67 75 6d 65 6e 74 20 20 20 20 3a 69 6e 69 74 61 72 tform.t)....(argument....:initar
53720 67 20 3a 61 72 67 75 6d 65 6e 74 29 0a 20 20 20 28 73 68 6f 72 74 61 72 67 20 20 20 20 3a 69 6e g.:argument)....(shortarg....:in
53740 69 74 61 72 67 20 3a 73 68 6f 72 74 61 72 67 29 0a 20 20 20 28 76 61 6c 75 65 20 20 20 20 20 20 itarg.:shortarg)....(value......
53760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d .......................:initform
53780 20 6e 69 6c 29 0a 20 20 20 28 69 6e 69 74 2d 76 61 6c 75 65 20 20 3a 69 6e 69 74 61 72 67 20 3a .nil)....(init-value..:initarg.:
537a0 69 6e 69 74 2d 76 61 6c 75 65 29 0a 20 20 20 28 75 6e 73 61 76 61 62 6c 65 20 20 20 3a 69 6e 69 init-value)....(unsavable...:ini
537c0 74 61 72 67 20 3a 75 6e 73 61 76 61 62 6c 65 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 targ.:unsavable...:initform.nil)
537e0 0a 20 20 20 28 6d 75 6c 74 69 2d 76 61 6c 75 65 20 3a 69 6e 69 74 61 72 67 20 3a 6d 75 6c 74 69 ....(multi-value.:initarg.:multi
53800 2d 76 61 6c 75 65 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 61 6c 77 61 79 73 -value.:initform.nil)....(always
53820 2d 72 65 61 64 20 3a 69 6e 69 74 61 72 67 20 3a 61 6c 77 61 79 73 2d 72 65 61 64 20 3a 69 6e 69 -read.:initarg.:always-read.:ini
53840 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 61 6c 6c 6f 77 2d 65 6d 70 74 79 20 3a 69 6e 69 74 tform.nil)....(allow-empty.:init
53860 61 72 67 20 3a 61 6c 6c 6f 77 2d 65 6d 70 74 79 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a arg.:allow-empty.:initform.nil).
53880 20 20 20 28 68 69 73 74 6f 72 79 2d 6b 65 79 20 3a 69 6e 69 74 61 72 67 20 3a 68 69 73 74 6f 72 ...(history-key.:initarg.:histor
538a0 79 2d 6b 65 79 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 72 65 61 64 65 72 20 y-key.:initform.nil)....(reader.
538c0 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 72 65 61 64 65 72 20 20 20 20 20 20 3a 69 6e 69 74 .....:initarg.:reader......:init
538e0 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 70 72 6f 6d 70 74 20 20 20 20 20 20 3a 69 6e 69 74 61 form.nil)....(prompt......:inita
53900 72 67 20 3a 70 72 6f 6d 70 74 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 rg.:prompt......:initform.nil)..
53920 20 20 28 63 68 6f 69 63 65 73 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 63 68 6f 69 63 65 73 ..(choices.....:initarg.:choices
53940 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 66 6f 72 6d 61 74 20 20 .....:initform.nil)....(format..
53960 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 3a 69 6e 69 74 66 ..........................:initf
53980 6f 72 6d 20 22 20 25 6b 20 25 64 20 28 25 76 29 22 29 29 0a 20 20 22 54 72 61 6e 73 69 65 6e 74 orm.".%k.%d.(%v)"))..."Transient
539a0 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 22 0a 20 20 3a 61 62 73 74 72 61 63 74 20 74 29 0a .infix.command."...:abstract.t).
539c0 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 20 28 74 .(defclass.transient-argument.(t
539e0 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 20 28 29 0a 20 20 22 41 62 73 74 72 61 63 74 20 73 ransient-infix).()..."Abstract.s
53a00 75 70 65 72 63 6c 61 73 73 20 66 6f 72 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 2e 22 0a uperclass.for.infix.arguments.".
53a20 20 20 3a 61 62 73 74 72 61 63 74 20 74 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 ..:abstract.t)..(defclass.transi
53a40 65 6e 74 2d 73 77 69 74 63 68 20 28 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 20 ent-switch.(transient-argument).
53a60 28 29 0a 20 20 22 43 6c 61 73 73 20 75 73 65 64 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e ()..."Class.used.for.command-lin
53a80 65 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 20 63 61 6e 20 62 65 20 74 75 72 6e 65 64 20 6f 6e e.argument.that.can.be.turned.on
53aa0 20 61 6e 64 20 6f 66 66 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 .and.off.")..(defclass.transient
53ac0 2d 6f 70 74 69 6f 6e 20 28 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 20 28 29 0a -option.(transient-argument).().
53ae0 20 20 22 43 6c 61 73 73 20 75 73 65 64 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 61 .."Class.used.for.command-line.a
53b00 72 67 75 6d 65 6e 74 20 74 68 61 74 20 63 61 6e 20 74 61 6b 65 20 61 20 76 61 6c 75 65 2e 22 29 rgument.that.can.take.a.value.")
53b20 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 72 69 61 62 6c 65 20 28 ..(defclass.transient-variable.(
53b40 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 0a 20 20 28 28 76 61 72 69 61 62 6c 65 20 20 20 transient-infix)...((variable...
53b60 20 3a 69 6e 69 74 61 72 67 20 3a 76 61 72 69 61 62 6c 65 29 0a 20 20 20 28 66 6f 72 6d 61 74 20 .:initarg.:variable)....(format.
53b80 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 3a 69 6e 69 74 ...........................:init
53ba0 66 6f 72 6d 20 22 20 25 6b 20 25 64 20 25 76 22 29 29 0a 20 20 22 41 62 73 74 72 61 63 74 20 73 form.".%k.%d.%v"))..."Abstract.s
53bc0 75 70 65 72 63 6c 61 73 73 20 66 6f 72 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 uperclass.for.infix.commands.tha
53be0 74 20 73 65 74 20 61 20 76 61 72 69 61 62 6c 65 2e 22 0a 20 20 3a 61 62 73 74 72 61 63 74 20 74 t.set.a.variable."...:abstract.t
53c00 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 20 )..(defclass.transient-switches.
53c20 28 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 0a 20 20 28 28 61 72 67 75 6d 65 6e (transient-argument)...((argumen
53c40 74 2d 66 6f 72 6d 61 74 20 20 3a 69 6e 69 74 61 72 67 20 3a 61 72 67 75 6d 65 6e 74 2d 66 6f 72 t-format..:initarg.:argument-for
53c60 6d 61 74 29 0a 20 20 20 28 61 72 67 75 6d 65 6e 74 2d 72 65 67 65 78 70 20 20 3a 69 6e 69 74 61 mat)....(argument-regexp..:inita
53c80 72 67 20 3a 61 72 67 75 6d 65 6e 74 2d 72 65 67 65 78 70 29 29 0a 20 20 22 43 6c 61 73 73 20 75 rg.:argument-regexp))..."Class.u
53ca0 73 65 64 20 66 6f 72 20 73 65 74 73 20 6f 66 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 sed.for.sets.of.mutually.exclusi
53cc0 76 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 77 69 74 63 68 65 73 2e 22 29 0a 0a 28 64 65 ve.command-line.switches.")..(de
53ce0 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 66 69 6c 65 73 20 28 74 72 61 6e 73 69 65 6e fclass.transient-files.(transien
53d00 74 2d 6f 70 74 69 6f 6e 29 20 28 29 0a 20 20 28 28 6b 65 79 20 20 20 20 20 20 20 20 20 3a 69 6e t-option).()...((key.........:in
53d20 69 74 66 6f 72 6d 20 22 2d 2d 22 29 0a 20 20 20 28 61 72 67 75 6d 65 6e 74 20 20 20 20 3a 69 6e itform."--")....(argument....:in
53d40 69 74 66 6f 72 6d 20 22 2d 2d 22 29 0a 20 20 20 28 6d 75 6c 74 69 2d 76 61 6c 75 65 20 3a 69 6e itform."--")....(multi-value.:in
53d60 69 74 66 6f 72 6d 20 72 65 73 74 29 0a 20 20 20 28 72 65 61 64 65 72 20 20 20 20 20 20 3a 69 6e itform.rest)....(reader......:in
53d80 69 74 66 6f 72 6d 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 66 69 6c 65 73 29 29 0a 20 20 itform.transient-read-files))...
53da0 22 43 6c 61 73 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 5c 22 2d 2d 5c 22 20 61 72 67 75 6d "Class.used.for.the.\"--\".argum
53dc0 65 6e 74 20 6f 72 20 73 69 6d 69 6c 61 72 2e 0a 41 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 20 61 72 ent.or.similar..All.remaining.ar
53de0 67 75 6d 65 6e 74 73 20 61 72 65 20 74 72 65 61 74 65 64 20 61 73 20 66 69 6c 65 73 2e 0a 54 68 guments.are.treated.as.files..Th
53e00 65 79 20 62 65 63 6f 6d 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 61 72 67 75 ey.become.the.value.of.this.argu
53e20 6d 65 6e 74 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c ment.")..(defclass.transient-val
53e40 75 65 2d 70 72 65 73 65 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 0a 20 20 28 ue-preset.(transient-suffix)...(
53e60 28 74 72 61 6e 73 69 65 6e 74 20 3a 69 6e 69 74 66 6f 72 6d 20 74 29 0a 20 20 20 28 73 65 74 20 (transient.:initform.t)....(set.
53e80 3a 69 6e 69 74 61 72 67 20 3a 3d 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 29 0a 20 20 22 43 :initarg.:=.:initform.nil))..."C
53ea0 6c 61 73 73 20 75 73 65 64 20 62 79 20 74 68 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 73 lass.used.by.the.`transient-pres
53ec0 65 74 27 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 et'.suffix.command.")..(defclass
53ee0 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 2d 74 61 72 67 65 74 20 28 74 72 61 6e .transient-describe-target.(tran
53f00 73 69 65 6e 74 2d 73 75 66 66 69 78 29 0a 20 20 28 28 74 72 61 6e 73 69 65 6e 74 20 3a 69 6e 69 sient-suffix)...((transient.:ini
53f20 74 66 6f 72 6d 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 6e 64 29 0a 20 tform.#'transient--do-suspend)..
53f40 20 20 28 68 65 6c 70 65 72 20 3a 69 6e 69 74 61 72 67 20 3a 68 65 6c 70 65 72 20 3a 69 6e 69 74 ..(helper.:initarg.:helper.:init
53f60 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 74 61 72 67 65 74 20 3a 69 6e 69 74 61 72 67 20 3a 3d form.nil)....(target.:initarg.:=
53f80 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 29 0a 20 20 22 43 6c 61 73 73 20 75 73 65 64 20 62 .:initform.nil))..."Class.used.b
53fa0 79 20 74 68 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 27 20 73 75 66 66 69 y.the.`transient-describe'.suffi
53fc0 78 20 63 6f 6d 6d 61 6e 64 2e 22 29 0a 0a 3b 3b 3b 3b 20 47 72 6f 75 70 0a 0a 28 64 65 66 63 6c x.command.")..;;;;.Group..(defcl
53fe0 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 20 28 74 72 61 6e 73 69 65 6e 74 2d 63 ass.transient-group.(transient-c
54000 68 69 6c 64 29 0a 20 20 28 28 73 75 66 66 69 78 65 73 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 hild)...((suffixes.......:initar
54020 67 20 3a 73 75 66 66 69 78 65 73 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 g.:suffixes.......:initform.nil)
54040 0a 20 20 20 28 68 69 64 65 20 20 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 68 69 ....(hide...........:initarg.:hi
54060 64 65 20 20 20 20 20 20 20 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 de...........:initform.nil)....(
54080 64 65 73 63 72 69 70 74 69 6f 6e 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 64 65 73 63 72 69 70 description....:initarg.:descrip
540a0 74 69 6f 6e 20 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 70 61 64 2d 6b tion....:initform.nil)....(pad-k
540c0 65 79 73 20 20 20 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 70 61 64 2d 6b 65 79 73 20 20 20 20 eys.......:initarg.:pad-keys....
540e0 20 20 20 3a 69 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 69 6e 66 6f 2d 66 6f 72 6d 61 ...:initform.nil)....(info-forma
54100 74 20 20 20 20 3a 69 6e 69 74 61 72 67 20 3a 69 6e 66 6f 2d 66 6f 72 6d 61 74 20 20 20 20 3a 69 t....:initarg.:info-format....:i
54120 6e 69 74 66 6f 72 6d 20 6e 69 6c 29 0a 20 20 20 28 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 20 nitform.nil)....(setup-children.
54140 3a 69 6e 69 74 61 72 67 20 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 29 29 0a 20 20 22 41 62 :initarg.:setup-children))..."Ab
54160 73 74 72 61 63 74 20 73 75 70 65 72 63 6c 61 73 73 20 6f 66 20 61 6c 6c 20 67 72 6f 75 70 20 63 stract.superclass.of.all.group.c
54180 6c 61 73 73 65 73 2e 22 0a 20 20 3a 61 62 73 74 72 61 63 74 20 74 29 0a 0a 28 64 65 66 63 6c 61 lasses."...:abstract.t)..(defcla
541a0 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 20 28 74 72 61 6e 73 69 65 6e 74 2d 67 ss.transient-column.(transient-g
541c0 72 6f 75 70 29 20 28 29 0a 20 20 22 47 72 6f 75 70 20 63 6c 61 73 73 20 74 68 61 74 20 64 69 73 roup).()..."Group.class.that.dis
541e0 70 6c 61 79 73 20 65 61 63 68 20 65 6c 65 6d 65 6e 74 20 6f 6e 20 61 20 73 65 70 61 72 61 74 65 plays.each.element.on.a.separate
54200 20 6c 69 6e 65 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 72 6f .line.")..(defclass.transient-ro
54220 77 20 28 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 29 20 28 29 0a 20 20 22 47 72 6f 75 70 20 w.(transient-group).()..."Group.
54240 63 6c 61 73 73 20 74 68 61 74 20 64 69 73 70 6c 61 79 73 20 61 6c 6c 20 65 6c 65 6d 65 6e 74 73 class.that.displays.all.elements
54260 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 6c 69 6e 65 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 20 .on.a.single.line.")..(defclass.
54280 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f transient-columns.(transient-gro
542a0 75 70 29 20 28 29 0a 20 20 22 47 72 6f 75 70 20 63 6c 61 73 73 20 74 68 61 74 20 64 69 73 70 6c up).()..."Group.class.that.displ
542c0 61 79 73 20 65 6c 65 6d 65 6e 74 73 20 6f 72 67 61 6e 69 7a 65 64 20 69 6e 20 63 6f 6c 75 6d 6e ays.elements.organized.in.column
542e0 73 2e 0a 44 69 72 65 63 74 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 20 67 72 s..Direct.elements.have.to.be.gr
54300 6f 75 70 73 20 77 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 0a 63 oups.whose.elements.have.to.be.c
54320 6f 6d 6d 61 6e 64 73 20 6f 72 20 73 74 72 69 6e 67 73 2e 20 20 45 61 63 68 20 73 75 62 67 72 6f ommands.or.strings...Each.subgro
54340 75 70 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 63 6f 6c 75 6d 6e 2e 0a 54 68 69 73 20 63 6c 61 up.represents.a.column..This.cla
54360 73 73 20 74 61 6b 65 73 20 63 61 72 65 20 6f 66 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 20 73 ss.takes.care.of.inserting.the.s
54380 75 62 67 72 6f 75 70 73 27 20 65 6c 65 6d 65 6e 74 73 2e 22 29 0a 0a 28 64 65 66 63 6c 61 73 73 ubgroups'.elements.")..(defclass
543a0 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 62 67 72 6f 75 70 73 20 28 74 72 61 6e 73 69 65 6e 74 2d .transient-subgroups.(transient-
543c0 67 72 6f 75 70 29 20 28 29 0a 20 20 22 47 72 6f 75 70 20 63 6c 61 73 73 20 74 68 61 74 20 77 72 group).()..."Group.class.that.wr
543e0 61 70 73 20 6f 74 68 65 72 20 67 72 6f 75 70 73 2e 0a 0a 44 69 72 65 63 74 20 65 6c 65 6d 65 6e aps.other.groups...Direct.elemen
54400 74 73 20 68 61 76 65 20 74 6f 20 62 65 20 67 72 6f 75 70 73 20 77 68 6f 73 65 20 65 6c 65 6d 65 ts.have.to.be.groups.whose.eleme
54420 6e 74 73 20 68 61 76 65 20 74 6f 20 62 65 0a 63 6f 6d 6d 61 6e 64 73 20 6f 72 20 73 74 72 69 6e nts.have.to.be.commands.or.strin
54440 67 73 2e 20 20 54 68 69 73 20 67 72 6f 75 70 20 69 6e 73 65 72 74 73 20 61 6e 20 65 6d 70 74 79 gs...This.group.inserts.an.empty
54460 20 6c 69 6e 65 20 62 65 74 77 65 65 6e 0a 73 75 62 67 72 6f 75 70 73 2e 20 20 54 68 65 20 73 75 .line.between.subgroups...The.su
54480 62 67 72 6f 75 70 73 20 61 72 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 64 69 73 70 bgroups.are.responsible.for.disp
544a0 6c 61 79 69 6e 67 20 74 68 65 69 72 0a 65 6c 65 6d 65 6e 74 73 20 74 68 65 6d 73 65 6c 76 65 73 laying.their.elements.themselves
544c0 2e 22 29 0a 0a 3b 3b 3b 20 44 65 66 69 6e 65 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 .")..;;;.Define..(defmacro.trans
544e0 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 20 28 6e 61 6d 65 20 61 72 67 6c 69 73 74 ient-define-prefix.(name.arglist
54500 20 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 22 44 65 66 69 6e 65 20 4e 41 4d 45 20 61 73 20 61 .&rest.args)..."Define.NAME.as.a
54520 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 41 52 47 4c .transient.prefix.command...ARGL
54540 49 53 54 20 61 72 65 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 63 6f 6d 6d 61 IST.are.the.arguments.that.comma
54560 6e 64 20 74 61 6b 65 73 2e 0a 44 4f 43 53 54 52 49 4e 47 20 69 73 20 74 68 65 20 64 6f 63 75 6d nd.takes..DOCSTRING.is.the.docum
54580 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 61 6e 64 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e entation.string.and.is.optional.
545a0 0a 0a 54 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 20 63 61 6e 20 6f 70 74 69 6f 6e 61 6c 6c 79 ..These.arguments.can.optionally
545c0 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 69 72 73 2e .be.followed.by.key-value.pairs.
545e0 0a 45 61 63 68 20 6b 65 79 20 68 61 73 20 74 6f 20 62 65 20 61 20 6b 65 79 77 6f 72 64 20 73 79 .Each.key.has.to.be.a.keyword.sy
54600 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 60 3a 63 6c 61 73 73 27 20 6f 72 20 61 20 6b 65 79 77 6f mbol,.either.`:class'.or.a.keywo
54620 72 64 0a 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 63 6f 6e rd.argument.supported.by.the.con
54640 73 74 72 75 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 20 20 54 68 65 0a 60 74 72 structor.of.that.class...The.`tr
54660 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 27 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 20 69 66 ansient-prefix'.class.is.used.if
54680 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 0a 65 78 70 6c .the.class.is.not.specified.expl
546a0 69 63 69 74 6c 79 2e 0a 0a 47 52 4f 55 50 73 20 61 64 64 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 icitly...GROUPs.add.key.bindings
546c0 20 66 6f 72 20 69 6e 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 .for.infix.and.suffix.commands.a
546e0 6e 64 20 73 70 65 63 69 66 79 0a 68 6f 77 20 74 68 65 73 65 20 62 69 6e 64 69 6e 67 73 20 61 72 nd.specify.how.these.bindings.ar
54700 65 20 70 72 65 73 65 6e 74 65 64 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 e.presented.in.the.menu.buffer..
54720 20 41 74 20 6c 65 61 73 74 0a 6f 6e 65 20 47 52 4f 55 50 20 68 61 73 20 74 6f 20 62 65 20 73 70 .At.least.one.GROUP.has.to.be.sp
54740 65 63 69 66 69 65 64 2e 20 20 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 ecified...See.info.node.`(transi
54760 65 6e 74 29 42 69 6e 64 69 6e 67 0a 53 75 66 66 69 78 20 61 6e 64 20 49 6e 66 69 78 20 43 6f 6d ent)Binding.Suffix.and.Infix.Com
54780 6d 61 6e 64 73 27 2e 0a 0a 54 68 65 20 42 4f 44 59 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 mands'...The.BODY.is.optional...
547a0 49 66 20 69 74 20 69 73 20 6f 6d 69 74 74 65 64 2c 20 74 68 65 6e 20 41 52 47 4c 49 53 54 20 69 If.it.is.omitted,.then.ARGLIST.i
547c0 73 20 61 6c 73 6f 0a 69 67 6e 6f 72 65 64 20 61 6e 64 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 s.also.ignored.and.the.function.
547e0 64 65 66 69 6e 69 74 69 6f 6e 20 62 65 63 6f 6d 65 73 3a 0a 0a 20 20 28 6c 61 6d 62 64 61 20 28 definition.becomes:....(lambda.(
54800 29 0a 20 20 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 ).....(interactive).....(transie
54820 6e 74 2d 73 65 74 75 70 20 5c 5c 3d 27 4e 41 4d 45 29 29 0a 0a 49 66 20 42 4f 44 59 20 69 73 20 nt-setup.\\='NAME))..If.BODY.is.
54840 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 69 74 20 6d 75 73 74 20 62 65 67 69 6e 20 77 69 specified,.then.it.must.begin.wi
54860 74 68 20 61 6e 20 60 69 6e 74 65 72 61 63 74 69 76 65 27 0a 66 6f 72 6d 20 74 68 61 74 20 6d 61 th.an.`interactive'.form.that.ma
54880 74 63 68 65 73 20 41 52 47 4c 49 53 54 2c 20 61 6e 64 20 69 74 20 6d 75 73 74 20 63 61 6c 6c 20 tches.ARGLIST,.and.it.must.call.
548a0 60 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 27 2e 0a 49 74 20 6d 61 79 20 68 6f 77 65 76 65 `transient-setup'..It.may.howeve
548c0 72 20 63 61 6c 6c 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 6c 79 20 77 68 65 6e 20 73 r.call.that.function.only.when.s
548e0 6f 6d 65 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 0a 73 61 74 69 73 66 69 65 64 3b 20 74 68 61 74 ome.condition.is.satisfied;.that
54900 20 69 73 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65 61 73 6f 6e 20 77 68 79 20 79 6f 75 20 6d 69 .is.one.of.the.reason.why.you.mi
54920 67 68 74 20 77 61 6e 74 20 74 6f 20 75 73 65 0a 61 6e 20 65 78 70 6c 69 63 69 74 20 42 4f 44 59 ght.want.to.use.an.explicit.BODY
54940 2e 0a 0a 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 68 61 76 65 20 61 20 28 70 6f 73 73 69 62 ...All.transients.have.a.(possib
54960 6c 79 20 6e 69 6c 29 20 76 61 6c 75 65 2c 20 77 68 69 63 68 20 69 73 20 65 78 70 6f 72 74 65 64 ly.nil).value,.which.is.exported
54980 0a 77 68 65 6e 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 63 61 6c 6c 65 64 .when.suffix.commands.are.called
549a0 2c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 63 61 6e 20 63 6f 6e 73 75 6d 65 20 74 68 61 74 0a ,.so.that.they.can.consume.that.
549c0 76 61 6c 75 65 2e 20 20 46 6f 72 20 73 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 20 69 74 20 6d value...For.some.transients.it.m
549e0 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 68 61 76 65 20 61 20 73 6f 72 74 ight.be.necessary.to.have.a.sort
54a00 0a 6f 66 20 73 65 63 6f 6e 64 61 72 79 20 76 61 6c 75 65 2c 20 63 61 6c 6c 65 64 20 61 20 73 63 .of.secondary.value,.called.a.sc
54a20 6f 70 65 2e 20 20 53 75 63 68 20 61 20 73 63 6f 70 65 20 77 6f 75 6c 64 20 75 73 75 61 6c 6c 79 ope...Such.a.scope.would.usually
54a40 0a 62 65 20 73 65 74 20 69 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 73 20 60 69 6e 74 65 72 61 63 .be.set.in.the.commands.`interac
54a60 74 69 76 65 27 20 66 6f 72 6d 20 61 6e 64 20 68 61 73 20 74 6f 20 62 65 20 70 61 73 73 65 64 0a tive'.form.and.has.to.be.passed.
54a80 74 6f 20 74 68 65 20 73 65 74 75 70 20 66 75 6e 63 74 69 6f 6e 3a 0a 0a 20 20 28 74 72 61 6e 73 to.the.setup.function:....(trans
54aa0 69 65 6e 74 2d 73 65 74 75 70 20 5c 5c 3d 27 4e 41 4d 45 20 6e 69 6c 20 6e 69 6c 20 3a 73 63 6f ient-setup.\\='NAME.nil.nil.:sco
54ac0 70 65 20 53 43 4f 50 45 29 0a 0a 5c 28 66 6e 20 4e 41 4d 45 20 41 52 47 4c 49 53 54 20 5b 44 4f pe.SCOPE)..\(fn.NAME.ARGLIST.[DO
54ae0 43 53 54 52 49 4e 47 5d 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 20 47 52 4f 55 CSTRING].[KEYWORD.VALUE]....GROU
54b00 50 2e 2e 2e 20 5b 42 4f 44 59 2e 2e 2e 5d 29 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 64 65 62 P....[BODY...])"...(declare.(deb
54b20 75 67 20 28 20 26 64 65 66 69 6e 65 20 6e 61 6d 65 20 6c 61 6d 62 64 61 2d 6c 69 73 74 0a 20 20 ug.(.&define.name.lambda-list...
54b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b 26 6f 70 74 69 6f 6e 61 6c 20 6c 61 6d ..................[&optional.lam
54b60 62 64 61 2d 64 6f 63 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b 26 72 bda-doc].....................[&r
54b80 65 73 74 20 6b 65 79 77 6f 72 64 70 20 73 65 78 70 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 est.keywordp.sexp]..............
54ba0 20 20 20 20 20 20 20 5b 26 72 65 73 74 20 76 65 63 74 6f 72 70 5d 0a 20 20 20 20 20 20 20 20 20 .......[&rest.vectorp]..........
54bc0 20 20 20 20 20 20 20 20 20 20 20 5b 26 6f 70 74 69 6f 6e 61 6c 20 28 22 69 6e 74 65 72 61 63 74 ...........[&optional.("interact
54be0 69 76 65 22 20 69 6e 74 65 72 61 63 74 69 76 65 29 20 64 65 66 2d 62 6f 64 79 5d 29 29 0a 20 20 ive".interactive).def-body]))...
54c00 20 20 20 20 20 20 20 20 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 0a 20 20 20 20 20 20 20 20 .........(indent.defun).........
54c20 20 20 20 28 64 6f 63 2d 73 74 72 69 6e 67 20 33 29 29 0a 20 20 28 70 63 61 73 65 2d 6c 65 74 0a ...(doc-string.3))...(pcase-let.
54c40 20 20 20 20 20 20 28 28 60 28 2c 63 6c 61 73 73 20 2c 73 6c 6f 74 73 20 2c 67 72 6f 75 70 73 20 ......((`(,class.,slots.,groups.
54c60 2c 64 6f 63 73 74 72 20 2c 62 6f 64 79 20 2c 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 29 ,docstr.,body.,interactive-only)
54c80 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 61 6e 64 2d 64 65 66 69 .........(transient--expand-defi
54ca0 6e 65 2d 61 72 67 73 20 61 72 67 73 20 61 72 67 6c 69 73 74 20 27 74 72 61 6e 73 69 65 6e 74 2d ne-args.args.arglist.'transient-
54cc0 64 65 66 69 6e 65 2d 70 72 65 66 69 78 29 29 29 0a 20 20 20 20 60 28 70 72 6f 67 6e 0a 20 20 20 define-prefix))).....`(progn....
54ce0 20 20 20 20 28 64 65 66 61 6c 69 61 73 20 27 2c 6e 61 6d 65 0a 20 20 20 20 20 20 20 20 20 2c 28 ....(defalias.',name..........,(
54d00 69 66 20 62 6f 64 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 60 28 6c 61 6d 62 64 61 20 2c if.body...............`(lambda.,
54d20 61 72 67 6c 69 73 74 20 2c 40 62 6f 64 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 60 28 6c 61 arglist.,@body).............`(la
54d40 6d 62 64 61 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 65 72 61 63 74 mbda.()................(interact
54d60 69 76 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 ive)................(transient-s
54d80 65 74 75 70 20 27 2c 6e 61 6d 65 29 29 29 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 etup.',name))))........(put.',na
54da0 6d 65 20 27 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 2c 69 6e 74 65 72 61 63 74 69 76 me.'interactive-only.,interactiv
54dc0 65 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 66 75 6e 63 e-only)........(put.',name.'func
54de0 74 69 6f 6e 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 2c 64 6f 63 73 74 72 29 0a 20 20 20 20 tion-documentation.,docstr).....
54e00 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 ...(put.',name.'transient--prefi
54e20 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 2c 28 6f 72 20 63 6c 61 73 73 20 27 74 72 61 6e 73 x.............(,(or.class.'trans
54e40 69 65 6e 74 2d 70 72 65 66 69 78 29 20 3a 63 6f 6d 6d 61 6e 64 20 27 2c 6e 61 6d 65 20 2c 40 73 ient-prefix).:command.',name.,@s
54e60 6c 6f 74 73 29 29 0a 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 74 2d 6c 61 lots))........(transient--set-la
54e80 79 6f 75 74 0a 20 20 20 20 20 20 20 20 27 2c 6e 61 6d 65 0a 20 20 20 20 20 20 20 20 28 6c 69 73 yout.........',name.........(lis
54ea0 74 20 2c 40 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 64 61 20 28 73 29 20 28 74 72 61 6e 73 69 65 t.,@(mapcan.(lambda.(s).(transie
54ec0 6e 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 20 6e 61 6d 65 20 73 29 29 20 67 72 6f 75 70 73 29 nt--parse-child.name.s)).groups)
54ee0 29 29 29 29 29 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e )))))..(defmacro.transient-defin
54f00 65 2d 67 72 6f 75 70 20 28 6e 61 6d 65 20 26 72 65 73 74 20 67 72 6f 75 70 73 29 0a 20 20 22 44 e-group.(name.&rest.groups)..."D
54f20 65 66 69 6e 65 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 67 72 6f 75 70 73 20 61 6e 64 20 73 74 6f efine.one.or.more.groups.and.sto
54f40 72 65 20 74 68 65 6d 20 69 6e 20 73 79 6d 62 6f 6c 20 4e 41 4d 45 2e 0a 0a 47 72 6f 75 70 73 20 re.them.in.symbol.NAME...Groups.
54f60 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 74 68 69 73 20 6d 61 63 72 6f 2c 20 63 61 6e 20 62 65 defined.using.this.macro,.can.be
54f80 20 75 73 65 64 20 69 6e 73 69 64 65 20 74 68 65 0a 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 .used.inside.the.definition.of.t
54fa0 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 62 79 20 75 73 69 ransient.prefix.commands,.by.usi
54fc0 6e 67 20 74 68 65 20 73 79 6d 62 6f 6c 0a 4e 41 4d 45 20 77 68 65 72 65 20 61 20 67 72 6f 75 70 ng.the.symbol.NAME.where.a.group
54fe0 20 76 65 63 74 6f 72 20 69 73 20 65 78 70 65 63 74 65 64 2e 20 20 47 52 4f 55 50 53 20 68 61 73 .vector.is.expected...GROUPS.has
55000 20 74 68 65 20 73 61 6d 65 0a 66 6f 72 6d 20 61 73 20 66 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 .the.same.form.as.for.`transient
55020 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 27 2e 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 64 65 -define-prefix'."...(declare.(de
55040 62 75 67 20 28 26 64 65 66 69 6e 65 20 6e 61 6d 65 20 5b 26 72 65 73 74 20 76 65 63 74 6f 72 70 bug.(&define.name.[&rest.vectorp
55060 5d 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 ]))............(indent.defun))..
55080 20 60 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 74 2d 6c 61 79 6f 75 74 0a 20 20 20 20 27 2c 6e .`(transient--set-layout.....',n
550a0 61 6d 65 0a 20 20 20 20 28 6c 69 73 74 20 2c 40 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 64 61 20 ame.....(list.,@(mapcan.(lambda.
550c0 28 73 29 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 20 6e 61 6d 65 (s).(transient--parse-child.name
550e0 20 73 29 29 20 67 72 6f 75 70 73 29 29 29 29 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 .s)).groups))))..(defmacro.trans
55100 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 20 28 6e 61 6d 65 20 61 72 67 6c 69 73 74 ient-define-suffix.(name.arglist
55120 20 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 22 44 65 66 69 6e 65 20 4e 41 4d 45 20 61 73 20 61 .&rest.args)..."Define.NAME.as.a
55140 20 74 72 61 6e 73 69 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 41 52 47 4c .transient.suffix.command...ARGL
55160 49 53 54 20 61 72 65 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 74 68 65 20 63 IST.are.the.arguments.that.the.c
55180 6f 6d 6d 61 6e 64 20 74 61 6b 65 73 2e 0a 44 4f 43 53 54 52 49 4e 47 20 69 73 20 74 68 65 20 64 ommand.takes..DOCSTRING.is.the.d
551a0 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 61 6e 64 20 69 73 20 6f 70 74 69 6f ocumentation.string.and.is.optio
551c0 6e 61 6c 2e 0a 0a 54 68 65 73 65 20 61 72 67 75 6d 65 6e 74 73 20 63 61 6e 20 6f 70 74 69 6f 6e nal...These.arguments.can.option
551e0 61 6c 6c 79 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 ally.be.followed.by.key-value.pa
55200 69 72 73 2e 0a 45 61 63 68 20 6b 65 79 20 68 61 73 20 74 6f 20 62 65 20 61 20 6b 65 79 77 6f 72 irs..Each.key.has.to.be.a.keywor
55220 64 20 73 79 6d 62 6f 6c 2c 20 65 69 74 68 65 72 20 60 3a 63 6c 61 73 73 27 20 6f 72 20 61 0a 6b d.symbol,.either.`:class'.or.a.k
55240 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 eyword.argument.supported.by.the
55260 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 6f 66 20 74 68 61 74 20 63 6c 61 73 73 2e 0a 54 68 65 20 .constructor.of.that.class..The.
55280 60 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 27 20 63 6c 61 73 73 20 69 73 20 75 73 65 64 `transient-suffix'.class.is.used
552a0 20 69 66 20 74 68 65 20 63 6c 61 73 73 20 69 73 20 6e 6f 74 0a 73 70 65 63 69 66 69 65 64 20 65 .if.the.class.is.not.specified.e
552c0 78 70 6c 69 63 69 74 6c 79 2e 0a 0a 54 68 65 20 42 4f 44 59 20 6d 75 73 74 20 62 65 67 69 6e 20 xplicitly...The.BODY.must.begin.
552e0 77 69 74 68 20 61 6e 20 60 69 6e 74 65 72 61 63 74 69 76 65 27 20 66 6f 72 6d 20 74 68 61 74 20 with.an.`interactive'.form.that.
55300 6d 61 74 63 68 65 73 0a 41 52 47 4c 49 53 54 2e 20 20 54 68 65 20 69 6e 66 69 78 20 61 72 67 75 matches.ARGLIST...The.infix.argu
55320 6d 65 6e 74 73 20 61 72 65 20 75 73 75 61 6c 6c 79 20 61 63 63 65 73 73 65 64 20 62 79 20 75 73 ments.are.usually.accessed.by.us
55340 69 6e 67 0a 60 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 27 20 69 6e 73 69 64 65 20 60 69 6e 74 ing.`transient-args'.inside.`int
55360 65 72 61 63 74 69 76 65 27 2e 0a 0a 5c 28 66 6e 20 4e 41 4d 45 20 41 52 47 4c 49 53 54 20 5b 44 eractive'...\(fn.NAME.ARGLIST.[D
55380 4f 43 53 54 52 49 4e 47 5d 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 20 5b 42 4f OCSTRING].[KEYWORD.VALUE]....[BO
553a0 44 59 2e 2e 2e 5d 29 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 64 65 62 75 67 20 28 20 26 64 65 DY...])"...(declare.(debug.(.&de
553c0 66 69 6e 65 20 6e 61 6d 65 20 6c 61 6d 62 64 61 2d 6c 69 73 74 0a 20 20 20 20 20 20 20 20 20 20 fine.name.lambda-list...........
553e0 20 20 20 20 20 20 20 20 20 20 5b 26 6f 70 74 69 6f 6e 61 6c 20 6c 61 6d 62 64 61 2d 64 6f 63 5d ..........[&optional.lambda-doc]
55400 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b 26 72 65 73 74 20 6b 65 79 77 .....................[&rest.keyw
55420 6f 72 64 70 20 73 65 78 70 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b ordp.sexp].....................[
55440 26 6f 70 74 69 6f 6e 61 6c 20 28 22 69 6e 74 65 72 61 63 74 69 76 65 22 20 69 6e 74 65 72 61 63 &optional.("interactive".interac
55460 74 69 76 65 29 20 64 65 66 2d 62 6f 64 79 5d 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 6e tive).def-body]))............(in
55480 64 65 6e 74 20 64 65 66 75 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 64 6f 63 2d 73 74 72 69 dent.defun)............(doc-stri
554a0 6e 67 20 33 29 29 0a 20 20 28 70 63 61 73 65 2d 6c 65 74 0a 20 20 20 20 20 20 28 28 60 28 2c 63 ng.3))...(pcase-let.......((`(,c
554c0 6c 61 73 73 20 2c 73 6c 6f 74 73 20 2c 5f 20 2c 64 6f 63 73 74 72 20 2c 62 6f 64 79 20 2c 69 6e lass.,slots.,_.,docstr.,body.,in
554e0 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 teractive-only).........(transie
55500 6e 74 2d 2d 65 78 70 61 6e 64 2d 64 65 66 69 6e 65 2d 61 72 67 73 20 61 72 67 73 20 61 72 67 6c nt--expand-define-args.args.argl
55520 69 73 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 29 29 29 0a ist.'transient-define-suffix))).
55540 20 20 20 20 60 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 28 64 65 66 61 6c 69 61 73 20 27 2c 6e ....`(progn........(defalias.',n
55560 61 6d 65 0a 20 20 20 20 20 20 20 20 20 2c 28 69 66 20 28 61 6e 64 20 28 6e 6f 74 20 62 6f 64 79 ame..........,(if.(and.(not.body
55580 29 20 63 6c 61 73 73 20 28 6f 72 65 66 2d 64 65 66 61 75 6c 74 20 63 6c 61 73 73 20 64 65 66 69 ).class.(oref-default.class.defi
555a0 6e 69 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 60 28 6f 72 65 66 2d 64 65 nition))...............`(oref-de
555c0 66 61 75 6c 74 20 27 2c 63 6c 61 73 73 20 64 65 66 69 6e 69 74 69 6f 6e 29 0a 20 20 20 20 20 20 fault.',class.definition).......
555e0 20 20 20 20 20 20 60 28 6c 61 6d 62 64 61 20 2c 61 72 67 6c 69 73 74 20 2c 40 62 6f 64 79 29 29 ......`(lambda.,arglist.,@body))
55600 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 69 6e 74 65 72 61 63 74 69 76 )........(put.',name.'interactiv
55620 65 2d 6f 6e 6c 79 20 2c 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 e-only.,interactive-only).......
55640 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 66 75 6e 63 74 69 6f 6e 2d 64 6f 63 75 6d 65 6e 74 61 .(put.',name.'function-documenta
55660 74 69 6f 6e 20 2c 64 6f 63 73 74 72 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 tion.,docstr)........(put.',name
55680 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 .'transient--suffix.............
556a0 28 2c 28 6f 72 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 20 3a (,(or.class.'transient-suffix).:
556c0 63 6f 6d 6d 61 6e 64 20 27 2c 6e 61 6d 65 20 2c 40 73 6c 6f 74 73 29 29 29 29 29 0a 0a 28 64 65 command.',name.,@slots)))))..(de
556e0 66 6d 61 63 72 6f 20 74 72 61 6e 73 69 65 6e 74 2d 61 75 67 6d 65 6e 74 2d 73 75 66 66 69 78 20 fmacro.transient-augment-suffix.
55700 28 6e 61 6d 65 20 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 22 41 75 67 6d 65 6e 74 20 65 78 69 (name.&rest.args)..."Augment.exi
55720 73 74 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 4e 41 4d 45 20 77 69 74 68 20 61 20 6e 65 77 20 74 72 sting.command.NAME.with.a.new.tr
55740 61 6e 73 69 65 6e 74 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 2e 0a 53 69 6d 69 6c 61 72 20 74 ansient.suffix.object..Similar.t
55760 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 27 20 62 75 74 20 o.`transient-define-suffix'.but.
55780 64 65 66 69 6e 65 20 61 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 20 6f 6e 6c 79 2e 0a 5c 6e 5c define.a.suffix.object.only..\n\
557a0 28 66 6e 20 4e 41 4d 45 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 29 22 0a 20 20 (fn.NAME.[KEYWORD.VALUE]...)"...
557c0 28 64 65 63 6c 61 72 65 20 28 64 65 62 75 67 20 28 26 64 65 66 69 6e 65 20 6e 61 6d 65 20 5b 26 (declare.(debug.(&define.name.[&
557e0 72 65 73 74 20 6b 65 79 77 6f 72 64 70 20 73 65 78 70 5d 29 29 0a 20 20 20 20 20 20 20 20 20 20 rest.keywordp.sexp]))...........
55800 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 20 28 70 63 61 73 65 2d 6c 65 74 0a 20 20 .(indent.defun))...(pcase-let...
55820 20 20 20 20 28 28 60 28 2c 63 6c 61 73 73 20 2c 73 6c 6f 74 73 29 0a 20 20 20 20 20 20 20 20 28 ....((`(,class.,slots).........(
55840 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 61 6e 64 2d 64 65 66 69 6e 65 2d 61 72 67 73 20 61 72 transient--expand-define-args.ar
55860 67 73 20 6e 69 6c 20 27 74 72 61 6e 73 69 65 6e 74 2d 61 75 67 6d 65 6e 74 2d 73 75 66 66 69 78 gs.nil.'transient-augment-suffix
55880 20 74 29 29 29 0a 20 20 20 20 60 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 74 72 61 6e 73 69 65 6e .t))).....`(put.',name.'transien
558a0 74 2d 2d 73 75 66 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 28 2c 28 6f 72 20 63 6c 61 73 73 20 t--suffix...........(,(or.class.
558c0 27 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 20 3a 63 6f 6d 6d 61 6e 64 20 27 2c 6e 61 'transient-suffix).:command.',na
558e0 6d 65 20 2c 40 73 6c 6f 74 73 29 29 29 29 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 69 me.,@slots))))..(defmacro.transi
55900 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 20 28 6e 61 6d 65 20 61 72 67 6c 69 73 74 20 26 ent-define-infix.(name.arglist.&
55920 72 65 73 74 20 61 72 67 73 29 0a 20 20 22 44 65 66 69 6e 65 20 4e 41 4d 45 20 61 73 20 61 20 74 rest.args)..."Define.NAME.as.a.t
55940 72 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 41 52 47 4c 49 53 54 ransient.infix.command...ARGLIST
55960 20 69 73 20 61 6c 77 61 79 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 72 65 73 65 72 76 65 64 20 .is.always.ignored.and.reserved.
55980 66 6f 72 20 66 75 74 75 72 65 20 75 73 65 2e 0a 44 4f 43 53 54 52 49 4e 47 20 69 73 20 74 68 65 for.future.use..DOCSTRING.is.the
559a0 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 20 61 6e 64 20 69 73 20 6f 70 74 .documentation.string.and.is.opt
559c0 69 6f 6e 61 6c 2e 0a 0a 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 6b 65 79 2d 76 61 6c 75 65 20 70 ional...At.least.one.key-value.p
559e0 61 69 72 20 69 73 20 72 65 71 75 69 72 65 64 2e 20 20 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 air.is.required...All.transient.
55a00 69 6e 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 71 75 61 6c 20 74 6f 20 65 61 63 68 infix.commands.are.equal.to.each
55a20 20 6f 74 68 65 72 20 28 62 75 74 20 6e 6f 74 20 65 71 29 2e 20 20 49 74 20 69 73 20 6d 65 61 6e .other.(but.not.eq)...It.is.mean
55a40 69 6e 67 2d 0a 6c 65 73 73 20 74 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d ing-.less.to.define.an.infix.com
55a60 6d 61 6e 64 2c 20 77 69 74 68 6f 75 74 20 70 72 6f 76 69 64 69 6e 67 20 61 74 20 6c 65 61 73 74 mand,.without.providing.at.least
55a80 20 6f 6e 65 0a 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 6e 74 20 28 75 73 75 61 6c 6c 79 20 60 .one.keyword.argument.(usually.`
55aa0 3a 61 72 67 75 6d 65 6e 74 27 20 6f 72 20 60 3a 76 61 72 69 61 62 6c 65 27 2c 20 64 65 70 65 6e :argument'.or.`:variable',.depen
55ac0 64 69 6e 67 0a 6f 6e 20 74 68 65 20 63 6c 61 73 73 29 2e 20 20 54 68 65 20 73 75 66 66 69 78 20 ding.on.the.class)...The.suffix.
55ae0 63 6c 61 73 73 20 64 65 66 61 75 6c 74 73 20 74 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 class.defaults.to.`transient-swi
55b00 74 63 68 27 0a 61 6e 64 20 63 61 6e 20 62 65 20 73 65 74 20 75 73 69 6e 67 20 74 68 65 20 60 3a tch'.and.can.be.set.using.the.`:
55b20 63 6c 61 73 73 27 20 6b 65 79 77 6f 72 64 2e 0a 0a 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 64 65 class'.keyword...The.function.de
55b40 66 69 6e 69 74 69 6f 6e 73 20 69 73 20 61 6c 77 61 79 73 3a 0a 0a 20 20 28 6c 61 6d 62 64 61 20 finitions.is.always:....(lambda.
55b60 28 29 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.((
55b80 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a obj.(transient-suffix-object))).
55ba0 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 28 ......(transient-infix-set.obj.(
55bc0 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 6f 62 6a 29 29 29 0a 20 20 20 20 transient-infix-read.obj))).....
55be0 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 0a 60 74 72 61 6e 73 69 65 6e 74 2d 69 (transient--show))..`transient-i
55c00 6e 66 69 78 2d 72 65 61 64 27 20 61 6e 64 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d nfix-read'.and.`transient-infix-
55c20 73 65 74 27 20 61 72 65 20 67 65 6e 65 72 69 63 0a 66 75 6e 63 74 69 6f 6e 73 2e 20 20 44 69 66 set'.are.generic.functions...Dif
55c40 66 65 72 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 62 65 68 61 76 65 20 64 69 66 ferent.infix.commands.behave.dif
55c60 66 65 72 65 6e 74 6c 79 20 62 65 63 61 75 73 65 0a 74 68 65 20 63 6f 6e 63 72 65 74 65 20 6d 65 ferently.because.the.concrete.me
55c80 74 68 6f 64 73 20 61 72 65 20 64 69 66 66 65 72 65 6e 74 20 66 6f 72 20 64 69 66 66 65 72 65 6e thods.are.different.for.differen
55ca0 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 63 6c 61 73 73 65 73 2e 20 20 49 6e 20 72 61 72 t.infix.command.classes...In.rar
55cc0 65 20 63 61 73 65 20 74 68 65 20 61 62 6f 76 65 20 63 6f 6d 6d 61 6e 64 20 66 75 6e 63 74 69 6f e.case.the.above.command.functio
55ce0 6e 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 0a 73 75 69 74 61 62 6c 65 2c 20 65 76 65 6e 20 69 66 n.might.not.be.suitable,.even.if
55d00 20 79 6f 75 20 64 65 66 69 6e 65 20 79 6f 75 72 20 6f 77 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 .you.define.your.own.infix.comma
55d20 6e 64 20 63 6c 61 73 73 2e 20 20 49 6e 0a 74 68 61 74 20 63 61 73 65 20 79 6f 75 20 68 61 76 65 nd.class...In.that.case.you.have
55d40 20 74 6f 20 75 73 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 .to.use.`transient-define-suffix
55d60 27 20 74 6f 20 64 65 66 69 6e 65 0a 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 61 6e '.to.define.the.infix.command.an
55d80 64 20 75 73 65 20 74 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 60 3a 74 72 d.use.t.as.the.value.of.the.`:tr
55da0 61 6e 73 69 65 6e 74 27 0a 6b 65 79 77 6f 72 64 2e 0a 0a 5c 28 66 6e 20 4e 41 4d 45 20 41 52 47 ansient'.keyword...\(fn.NAME.ARG
55dc0 4c 49 53 54 20 5b 44 4f 43 53 54 52 49 4e 47 5d 20 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 20 5b LIST.[DOCSTRING].KEYWORD.VALUE.[
55de0 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d 2e 2e 2e 29 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 KEYWORD.VALUE]...)"...(declare.(
55e00 64 65 62 75 67 20 28 20 26 64 65 66 69 6e 65 20 6e 61 6d 65 20 6c 61 6d 62 64 61 2d 6c 69 73 74 debug.(.&define.name.lambda-list
55e20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b 26 6f 70 74 69 6f 6e 61 6c 20 .....................[&optional.
55e40 6c 61 6d 62 64 61 2d 64 6f 63 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 lambda-doc].....................
55e60 6b 65 79 77 6f 72 64 70 20 73 65 78 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 keywordp.sexp...................
55e80 20 20 5b 26 72 65 73 74 20 6b 65 79 77 6f 72 64 70 20 73 65 78 70 5d 29 29 0a 20 20 20 20 20 20 ..[&rest.keywordp.sexp])).......
55ea0 20 20 20 20 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 .....(indent.defun)............(
55ec0 64 6f 63 2d 73 74 72 69 6e 67 20 33 29 29 0a 20 20 28 70 63 61 73 65 2d 6c 65 74 0a 20 20 20 20 doc-string.3))...(pcase-let.....
55ee0 20 20 28 28 60 28 2c 63 6c 61 73 73 20 2c 73 6c 6f 74 73 20 2c 5f 20 2c 64 6f 63 73 74 72 20 2c ..((`(,class.,slots.,_.,docstr.,
55f00 5f 20 2c 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 20 28 74 72 _.,interactive-only).........(tr
55f20 61 6e 73 69 65 6e 74 2d 2d 65 78 70 61 6e 64 2d 64 65 66 69 6e 65 2d 61 72 67 73 20 61 72 67 73 ansient--expand-define-args.args
55f40 20 61 72 67 6c 69 73 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 .arglist.'transient-define-infix
55f60 20 74 29 29 29 0a 20 20 20 20 60 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 28 64 65 66 61 6c 69 .t))).....`(progn........(defali
55f80 61 73 20 27 2c 6e 61 6d 65 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 as.',name.#'transient--default-i
55fa0 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 nfix-command)........(put.',name
55fc0 20 27 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 2c 69 6e 74 65 72 61 63 74 69 76 65 2d .'interactive-only.,interactive-
55fe0 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 63 6f 6d 70 6c 65 only)........(put.',name.'comple
56000 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 65 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 tion-predicate.#'transient--suff
56020 69 78 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 66 75 6e ix-only)........(put.',name.'fun
56040 63 74 69 6f 6e 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 2c 64 6f 63 73 74 72 29 0a 20 20 20 ction-documentation.,docstr)....
56060 20 20 20 20 28 70 75 74 20 27 2c 6e 61 6d 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 ....(put.',name.'transient--suff
56080 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 2c 28 6f 72 20 63 6c 61 73 73 20 27 74 72 61 6e ix.............(,(or.class.'tran
560a0 73 69 65 6e 74 2d 73 77 69 74 63 68 29 20 3a 63 6f 6d 6d 61 6e 64 20 27 2c 6e 61 6d 65 20 2c 40 sient-switch).:command.',name.,@
560c0 73 6c 6f 74 73 29 29 29 29 29 0a 0a 28 64 65 66 61 6c 69 61 73 20 27 74 72 61 6e 73 69 65 6e 74 slots)))))..(defalias.'transient
560e0 2d 64 65 66 69 6e 65 2d 61 72 67 75 6d 65 6e 74 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 -define-argument.#'transient-def
56100 69 6e 65 2d 69 6e 66 69 78 0a 20 20 22 44 65 66 69 6e 65 20 4e 41 4d 45 20 61 73 20 61 20 74 72 ine-infix..."Define.NAME.as.a.tr
56120 61 6e 73 69 65 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 4f 6e 6c 79 20 75 73 65 ansient.infix.command...Only.use
56140 20 74 68 69 73 20 61 6c 69 61 73 20 74 6f 20 64 65 66 69 6e 65 20 61 6e 20 69 6e 66 69 78 20 63 .this.alias.to.define.an.infix.c
56160 6f 6d 6d 61 6e 64 20 74 68 61 74 20 61 63 74 75 61 6c 6c 79 0a 73 65 74 73 20 61 6e 20 69 6e 66 ommand.that.actually.sets.an.inf
56180 69 78 20 61 72 67 75 6d 65 6e 74 2e 20 20 54 6f 20 64 65 66 69 6e 65 20 61 20 69 6e 66 69 78 20 ix.argument...To.define.a.infix.
561a0 63 6f 6d 6d 61 6e 64 20 74 68 61 74 2c 20 66 6f 72 0a 65 78 61 6d 70 6c 65 2c 20 73 65 74 73 20 command.that,.for.example,.sets.
561c0 61 20 76 61 72 69 61 62 6c 65 2c 20 75 73 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e a.variable,.use.`transient-defin
561e0 65 2d 69 6e 66 69 78 27 20 69 6e 73 74 65 61 64 2e 0a 0a 5c 28 66 6e 20 4e 41 4d 45 20 41 52 47 e-infix'.instead...\(fn.NAME.ARG
56200 4c 49 53 54 20 5b 44 4f 43 53 54 52 49 4e 47 5d 20 5b 4b 45 59 57 4f 52 44 20 56 41 4c 55 45 5d LIST.[DOCSTRING].[KEYWORD.VALUE]
56220 2e 2e 2e 29 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c ...)")..(defun.transient--defaul
56240 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 20 28 29 0a 20 20 3b 3b 20 4d 6f 73 74 20 69 6e 66 t-infix-command.()...;;.Most.inf
56260 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 62 75 74 20 61 6e 20 61 6c 69 61 73 20 66 6f 72 ix.commands.are.but.an.alias.for
56280 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 2e 0a 20 20 22 43 61 6e 6e 6f 74 20 73 68 6f 77 20 61 6e .this.command...."Cannot.show.an
562a0 79 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 74 72 61 6e 73 69 65 y.documentation.for.this.transie
562c0 6e 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 57 68 65 6e 20 79 6f 75 20 72 65 71 75 nt.infix.command...When.you.requ
562e0 65 73 74 20 68 65 6c 70 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 75 73 est.help.for.an.infix.command.us
56300 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 27 2c 20 74 68 61 74 0a 75 73 75 61 6c ing.`transient-help',.that.usual
56320 6c 79 20 73 68 6f 77 73 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 6d 61 6e 2d 70 61 67 65 ly.shows.the.respective.man-page
56340 20 61 6e 64 20 74 72 69 65 73 20 74 6f 20 6a 75 6d 70 20 74 6f 20 74 68 65 20 6c 6f 63 61 74 69 .and.tries.to.jump.to.the.locati
56360 6f 6e 0a 77 68 65 72 65 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 61 72 67 75 6d 65 6e 74 on.where.the.respective.argument
56380 20 69 73 20 62 65 69 6e 67 20 64 65 73 63 72 69 62 65 64 2e 0a 0a 49 66 20 6e 6f 20 6d 61 6e 2d .is.being.described...If.no.man-
563a0 70 61 67 65 20 69 73 20 73 70 65 63 69 66 69 65 64 20 66 6f 72 20 74 68 65 20 63 6f 6e 74 61 69 page.is.specified.for.the.contai
563c0 6e 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 2c 20 74 68 65 6e 20 74 68 65 0a 64 6f ning.transient.menu,.then.the.do
563e0 63 73 74 72 69 6e 67 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 69 6e 73 74 65 61 64 2c 20 69 66 cstring.is.displayed.instead,.if
56400 20 61 6e 79 2e 0a 0a 49 66 20 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73 .any...If.the.infix.command.does
56420 6e 27 74 20 68 61 76 65 20 61 20 64 6f 63 73 74 72 69 6e 67 2c 20 61 73 20 69 73 20 74 68 65 20 n't.have.a.docstring,.as.is.the.
56440 63 61 73 65 20 68 65 72 65 2c 20 74 68 65 6e 0a 74 68 69 73 20 64 6f 63 73 74 72 69 6e 67 20 69 case.here,.then.this.docstring.i
56460 73 20 64 69 73 70 6c 61 79 65 64 20 69 6e 73 74 65 61 64 2c 20 62 65 63 61 75 73 65 20 74 65 63 s.displayed.instead,.because.tec
56480 68 6e 69 63 61 6c 6c 79 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 61 72 65 20 61 6c 69 61 hnically.infix.commands.are.alia
564a0 73 65 73 20 66 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 ses.for.`transient--default-infi
564c0 78 2d 63 6f 6d 6d 61 6e 64 27 2e 0a 0a 60 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 27 x-command'...`describe-function'
564e0 20 61 6c 73 6f 20 73 68 6f 77 73 20 74 68 65 20 64 6f 63 73 74 72 69 6e 67 20 6f 66 20 74 68 65 .also.shows.the.docstring.of.the
56500 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 0a 66 61 6c 6c 69 6e 67 20 62 61 63 6b 20 74 6f 20 .infix.command,.falling.back.to.
56520 74 68 61 74 20 6f 66 20 74 68 65 20 73 61 6d 65 20 61 6c 69 61 73 65 64 20 63 6f 6d 6d 61 6e 64 that.of.the.same.aliased.command
56540 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 6c 65 74 20 28 28 6f 62 6a 20 ."...(interactive)...(let.((obj.
56560 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a 20 20 20 20 (transient-suffix-object))).....
56580 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 28 74 72 61 6e 73 69 (transient-infix-set.obj.(transi
565a0 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 6f 62 6a 29 29 29 0a 20 20 28 74 72 61 6e 73 69 65 ent-infix-read.obj)))...(transie
565c0 6e 74 2d 2d 73 68 6f 77 29 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 nt--show)).(put.'transient--defa
565e0 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 20 27 69 6e 74 65 72 61 63 74 69 76 65 2d 6f ult-infix-command.'interactive-o
56600 6e 6c 79 20 74 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d nly.t).(put.'transient--default-
56620 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 20 27 63 6f 6d 70 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 infix-command.'completion-predic
56640 61 74 65 0a 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6f 6e 6c ate......#'transient--suffix-onl
56660 79 29 0a 0a 28 64 65 66 69 6e 65 2d 61 64 76 69 63 65 20 66 69 6e 64 2d 66 75 6e 63 74 69 6f 6e y)..(define-advice.find-function
56680 2d 61 64 76 69 73 65 64 2d 6f 72 69 67 69 6e 61 6c 0a 20 20 20 20 28 3a 61 72 6f 75 6e 64 20 28 -advised-original.....(:around.(
566a0 66 6e 20 66 75 6e 63 29 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 fn.func).transient-default-infix
566c0 29 0a 20 20 22 52 65 74 75 72 6e 20 6e 69 6c 20 69 6e 73 74 65 61 64 20 6f 66 20 60 74 72 61 6e )..."Return.nil.instead.of.`tran
566e0 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 27 2e 0a 57 sient--default-infix-command'..W
56700 68 65 6e 20 75 73 69 6e 67 20 60 66 69 6e 64 2d 66 75 6e 63 74 69 6f 6e 27 20 74 6f 20 6a 75 6d hen.using.`find-function'.to.jum
56720 70 20 74 6f 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 74 72 61 6e 73 69 65 p.to.the.definition.of.a.transie
56740 6e 74 0a 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2f 61 72 67 75 6d 65 6e 74 2c 20 74 68 65 6e 20 nt.infix.command/argument,.then.
56760 77 65 20 77 61 6e 74 20 74 6f 20 61 63 74 75 61 6c 6c 79 20 6a 75 6d 70 20 74 6f 20 74 68 61 74 we.want.to.actually.jump.to.that
56780 2c 20 6e 6f 74 20 74 6f 0a 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 60 74 72 61 6e ,.not.to.the.definition.of.`tran
567a0 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 27 2c 20 77 sient--default-infix-command',.w
567c0 68 69 63 68 20 61 6c 6c 20 69 6e 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 6c 69 61 hich.all.infix.commands.are.alia
567e0 73 65 73 20 66 6f 72 2e 22 0a 20 20 28 6c 65 74 20 28 28 76 61 6c 20 28 66 75 6e 63 61 6c 6c 20 ses.for."...(let.((val.(funcall.
56800 66 6e 20 66 75 6e 63 29 29 29 0a 20 20 20 20 28 61 6e 64 20 76 61 6c 20 28 6e 6f 74 20 28 65 71 fn.func))).....(and.val.(not.(eq
56820 20 76 61 6c 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 .val.'transient--default-infix-c
56840 6f 6d 6d 61 6e 64 29 29 20 76 61 6c 29 29 29 0a 0a 28 65 76 61 6c 2d 61 6e 64 2d 63 6f 6d 70 69 ommand)).val)))..(eval-and-compi
56860 6c 65 20 3b 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 61 6e 64 2d 64 65 66 69 6e 65 2d 61 72 67 le.;transient--expand-define-arg
56880 73 0a 20 20 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 61 6e 64 2d 64 65 66 s...(defun.transient--expand-def
568a0 69 6e 65 2d 61 72 67 73 20 28 61 72 67 73 20 26 6f 70 74 69 6f 6e 61 6c 20 61 72 67 6c 69 73 74 ine-args.(args.&optional.arglist
568c0 20 66 6f 72 6d 20 6e 6f 62 6f 64 79 29 0a 20 20 20 20 3b 3b 20 41 52 47 4c 49 53 54 20 61 6e 64 .form.nobody).....;;.ARGLIST.and
568e0 20 46 4f 52 4d 20 61 72 65 20 6f 6e 6c 79 20 6f 70 74 69 6f 6e 61 6c 20 66 6f 72 20 62 61 63 6b .FORM.are.only.optional.for.back
56900 77 61 72 64 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 2e 0a 20 20 20 20 3b 3b 20 54 68 69 73 20 ward.compatibility......;;.This.
56920 69 73 20 6e 65 63 65 73 73 61 72 79 20 62 65 63 61 75 73 65 20 22 65 6d 6f 6a 69 2e 65 6c 22 20 is.necessary.because."emoji.el".
56940 66 72 6f 6d 20 45 6d 61 63 73 20 32 39 20 63 61 6c 6c 73 20 74 68 69 73 0a 20 20 20 20 3b 3b 20 from.Emacs.29.calls.this.....;;.
56960 66 75 6e 63 74 69 6f 6e 20 64 69 72 65 63 74 6c 79 2c 20 77 69 74 68 20 6a 75 73 74 20 6f 6e 65 function.directly,.with.just.one
56980 20 61 72 67 75 6d 65 6e 74 2e 0a 20 20 20 20 28 64 65 63 6c 61 72 65 20 28 61 64 76 65 72 74 69 .argument......(declare.(adverti
569a0 73 65 64 2d 63 61 6c 6c 69 6e 67 2d 63 6f 6e 76 65 6e 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 sed-calling-convention..........
569c0 20 20 20 20 20 28 61 72 67 73 20 61 72 67 6c 69 73 74 20 66 6f 72 6d 20 26 6f 70 74 69 6f 6e 61 .....(args.arglist.form.&optiona
569e0 6c 20 6e 6f 62 6f 64 79 29 20 22 30 2e 37 2e 31 22 29 29 0a 20 20 20 20 28 75 6e 6c 65 73 73 20 l.nobody)."0.7.1")).....(unless.
56a00 28 6c 69 73 74 70 20 61 72 67 6c 69 73 74 29 0a 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 4d 61 (listp.arglist).......(error."Ma
56a20 6e 64 61 74 6f 72 79 20 41 52 47 4c 49 53 54 20 69 73 20 6d 69 73 73 69 6e 67 22 29 29 0a 20 20 ndatory.ARGLIST.is.missing"))...
56a40 20 20 28 6c 65 74 20 28 63 6c 61 73 73 20 6b 65 79 73 20 73 75 66 66 69 78 65 73 20 64 6f 63 73 ..(let.(class.keys.suffixes.docs
56a60 74 72 20 64 65 63 6c 61 72 65 20 28 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 74 29 29 tr.declare.(interactive-only.t))
56a80 0a 20 20 20 20 20 20 28 77 68 65 6e 20 28 73 74 72 69 6e 67 70 20 28 63 61 72 20 61 72 67 73 29 .......(when.(stringp.(car.args)
56aa0 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 64 6f 63 73 74 72 20 28 70 6f 70 20 61 72 67 73 ).........(setq.docstr.(pop.args
56ac0 29 29 29 0a 20 20 20 20 20 20 28 77 68 69 6c 65 20 28 6b 65 79 77 6f 72 64 70 20 28 63 61 72 20 ))).......(while.(keywordp.(car.
56ae0 61 72 67 73 29 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 20 28 70 6f 70 20 61 72 67 args)).........(let.((k.(pop.arg
56b00 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 20 28 70 6f 70 20 61 72 67 73 29 29 s))...............(v.(pop.args))
56b20 29 0a 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 65 71 20 6b 20 3a 63 6c 61 73 73 29 0a 20 20 )...........(if.(eq.k.:class)...
56b40 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 63 6c 61 73 73 20 76 29 0a 20 20 20 20 20 ............(setq.class.v)......
56b60 20 20 20 20 20 20 20 28 70 75 73 68 20 6b 20 6b 65 79 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 .......(push.k.keys)............
56b80 20 28 70 75 73 68 20 76 20 6b 65 79 73 29 29 29 29 0a 20 20 20 20 20 20 28 77 68 69 6c 65 2d 6c .(push.v.keys)))).......(while-l
56ba0 65 74 0a 20 20 20 20 20 20 20 20 20 20 28 28 61 72 67 20 28 63 61 72 20 61 72 67 73 29 29 0a 20 et...........((arg.(car.args))..
56bc0 20 20 20 20 20 20 20 20 20 20 28 61 72 67 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 ..........(arg.(cond............
56be0 20 20 20 20 20 20 3b 3b 20 49 6e 6c 69 6e 65 20 67 72 6f 75 70 20 64 65 66 69 6e 69 74 69 6f 6e ......;;.Inline.group.definition
56c00 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 76 65 63 74 6f 72 70 20 61 72 67 ...................((vectorp.arg
56c20 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 6f 70 20 61 72 67 73 29 29 0a )...................(pop.args)).
56c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 51 75 6f 74 65 64 20 69 6e 63 6c 75 .................;;.Quoted.inclu
56c60 64 65 2c 20 61 73 20 6f 6e 65 20 77 6f 75 6c 64 20 65 78 70 65 63 74 2e 0a 20 20 20 20 20 20 20 de,.as.one.would.expect.........
56c80 20 20 20 20 20 20 20 20 20 20 28 28 65 71 20 28 63 61 72 2d 73 61 66 65 20 61 72 67 29 20 27 71 ..........((eq.(car-safe.arg).'q
56ca0 75 6f 74 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 61 64 72 20 28 70 uote)...................(cadr.(p
56cc0 6f 70 20 61 72 67 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 55 op.args)))..................;;.U
56ce0 6e 71 75 6f 74 65 64 20 69 6e 63 6c 75 64 65 2c 20 66 6f 72 20 63 6f 6d 70 61 74 69 62 69 6c 69 nquoted.include,.for.compatibili
56d00 74 79 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 61 6e 64 20 61 72 67 20 28 ty...................((and.arg.(
56d20 73 79 6d 62 6f 6c 70 20 61 72 67 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 symbolp.arg))...................
56d40 28 70 6f 70 20 61 72 67 73 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 70 75 73 68 20 61 72 67 (pop.args))))).........(push.arg
56d60 20 73 75 66 66 69 78 65 73 29 29 0a 20 20 20 20 20 20 28 77 68 65 6e 20 28 65 71 20 28 63 61 72 .suffixes)).......(when.(eq.(car
56d80 2d 73 61 66 65 20 28 63 61 72 20 61 72 67 73 29 29 20 27 64 65 63 6c 61 72 65 29 0a 20 20 20 20 -safe.(car.args)).'declare).....
56da0 20 20 20 20 28 73 65 74 71 20 64 65 63 6c 61 72 65 20 28 63 61 72 20 61 72 67 73 29 29 0a 20 20 ....(setq.declare.(car.args))...
56dc0 20 20 20 20 20 20 28 73 65 74 71 20 61 72 67 73 20 28 63 64 72 20 61 72 67 73 29 29 0a 20 20 20 ......(setq.args.(cdr.args))....
56de0 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 69 6e 74 20 28 61 73 73 71 20 27 69 6e 74 65 .....(when-let.((int.(assq.'inte
56e00 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 64 65 63 6c 61 72 65 29 29 29 0a 20 20 20 20 20 20 20 20 ractive-only.declare))).........
56e20 20 20 28 73 65 74 71 20 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 28 63 61 64 72 20 69 ..(setq.interactive-only.(cadr.i
56e40 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 64 65 6c 71 20 69 6e 74 20 64 65 63 6c 61 72 65 nt))...........(delq.int.declare
56e60 29 29 0a 20 20 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 63 64 72 20 64 65 63 6c 61 72 65 29 )).........(unless.(cdr.declare)
56e80 0a 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 64 65 63 6c 61 72 65 20 6e 69 6c 29 29 29 0a ...........(setq.declare.nil))).
56ea0 20 20 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 28 28 6e 6f 74 20 61 72 67 73 29 29 0a ......(cond........((not.args)).
56ec0 20 20 20 20 20 20 20 28 6e 6f 62 6f 64 79 0a 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 25 .......(nobody.........(error."%
56ee0 73 3a 20 4e 6f 20 66 75 6e 63 74 69 6f 6e 20 62 6f 64 79 20 61 6c 6c 6f 77 65 64 22 20 66 6f 72 s:.No.function.body.allowed".for
56f00 6d 29 29 0a 20 20 20 20 20 20 20 28 28 6e 6f 74 20 28 65 71 20 28 63 61 72 2d 73 61 66 65 20 28 m))........((not.(eq.(car-safe.(
56f20 6e 74 68 20 28 69 66 20 64 65 63 6c 61 72 65 20 31 20 30 29 20 61 72 67 73 29 29 20 27 69 6e 74 nth.(if.declare.1.0).args)).'int
56f40 65 72 61 63 74 69 76 65 29 29 0a 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 25 73 3a 20 49 eractive)).........(error."%s:.I
56f60 6e 74 65 72 61 63 74 69 76 65 20 66 6f 72 6d 20 6d 69 73 73 69 6e 67 22 20 66 6f 72 6d 29 29 29 nteractive.form.missing".form)))
56f80 0a 20 20 20 20 20 20 28 6c 69 73 74 20 28 69 66 20 28 65 71 20 28 63 61 72 2d 73 61 66 65 20 63 .......(list.(if.(eq.(car-safe.c
56fa0 6c 61 73 73 29 20 27 71 75 6f 74 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 lass).'quote).................(c
56fc0 61 64 72 20 63 6c 61 73 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6c 61 73 73 29 0a adr.class)...............class).
56fe0 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 72 65 76 65 72 73 65 20 6b 65 79 73 29 0a 20 20 20 20 ............(nreverse.keys).....
57000 20 20 20 20 20 20 20 20 28 6e 72 65 76 65 72 73 65 20 73 75 66 66 69 78 65 73 29 0a 20 20 20 20 ........(nreverse.suffixes).....
57020 20 20 20 20 20 20 20 20 64 6f 63 73 74 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 64 ........docstr.............(if.d
57040 65 63 6c 61 72 65 20 28 63 6f 6e 73 20 64 65 63 6c 61 72 65 20 61 72 67 73 29 20 61 72 67 73 29 eclare.(cons.declare.args).args)
57060 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 29 29 29 .............interactive-only)))
57080 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 )..(defun.transient--parse-child
570a0 20 28 70 72 65 66 69 78 20 73 70 65 63 29 0a 20 20 28 63 6c 2d 74 79 70 65 63 61 73 65 20 73 70 .(prefix.spec)...(cl-typecase.sp
570c0 65 63 0a 20 20 20 20 28 6e 75 6c 6c 20 20 20 20 28 65 72 72 6f 72 20 22 49 6e 76 61 6c 69 64 20 ec.....(null....(error."Invalid.
570e0 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 20 73 70 65 63 3a 20 25 73 22 transient--parse-child.spec:.%s"
57100 20 73 70 65 63 29 29 0a 20 20 20 20 28 73 79 6d 62 6f 6c 20 20 28 6c 69 73 74 20 60 27 2c 73 70 .spec)).....(symbol..(list.`',sp
57120 65 63 29 29 0a 20 20 20 20 28 76 65 63 74 6f 72 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 63 20 ec)).....(vector..(and-let*.((c.
57140 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 67 72 6f 75 70 20 20 70 72 65 66 69 78 20 (transient--parse-group..prefix.
57160 73 70 65 63 29 29 29 20 28 6c 69 73 74 20 63 29 29 29 0a 20 20 20 20 28 6c 69 73 74 20 20 20 20 spec))).(list.c))).....(list....
57180 28 61 6e 64 2d 6c 65 74 2a 20 28 28 63 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d (and-let*.((c.(transient--parse-
571a0 73 75 66 66 69 78 20 70 72 65 66 69 78 20 73 70 65 63 29 29 29 20 28 6c 69 73 74 20 63 29 29 29 suffix.prefix.spec))).(list.c)))
571c0 0a 20 20 20 20 28 73 74 72 69 6e 67 20 20 28 6c 69 73 74 20 73 70 65 63 29 29 0a 20 20 20 20 28 .....(string..(list.spec)).....(
571e0 74 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 49 6e 76 61 6c 69 64 20 74 72 61 6e 73 69 65 6e t.......(error."Invalid.transien
57200 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 20 73 70 65 63 3a 20 25 73 22 20 73 70 65 63 29 29 29 t--parse-child.spec:.%s".spec)))
57220 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 67 72 6f 75 70 )..(defun.transient--parse-group
57240 20 28 70 72 65 66 69 78 20 73 70 65 63 29 0a 20 20 28 6c 65 74 20 28 63 6c 61 73 73 20 61 72 67 .(prefix.spec)...(let.(class.arg
57260 73 29 0a 20 20 20 20 28 73 65 74 71 20 73 70 65 63 20 28 61 70 70 65 6e 64 20 73 70 65 63 20 6e s).....(setq.spec.(append.spec.n
57280 69 6c 29 29 0a 20 20 20 20 28 77 68 65 6e 20 28 69 6e 74 65 67 65 72 70 20 28 63 61 72 20 73 70 il)).....(when.(integerp.(car.sp
572a0 65 63 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 61 72 67 73 20 28 70 6c 69 73 74 2d 70 75 74 ec)).......(setq.args.(plist-put
572c0 20 61 72 67 73 20 3a 6c 65 76 65 6c 20 28 70 6f 70 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 28 .args.:level.(pop.spec)))).....(
572e0 77 68 65 6e 20 28 73 74 72 69 6e 67 70 20 28 63 61 72 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 when.(stringp.(car.spec)).......
57300 28 73 65 74 71 20 61 72 67 73 20 28 70 6c 69 73 74 2d 70 75 74 20 61 72 67 73 20 3a 64 65 73 63 (setq.args.(plist-put.args.:desc
57320 72 69 70 74 69 6f 6e 20 28 70 6f 70 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 28 77 68 69 6c 65 ription.(pop.spec)))).....(while
57340 20 28 6b 65 79 77 6f 72 64 70 20 28 63 61 72 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 28 6c 65 .(keywordp.(car.spec)).......(le
57360 74 2a 20 28 28 6b 65 79 20 28 70 6f 70 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 t*.((key.(pop.spec))............
57380 20 20 28 76 61 6c 20 28 69 66 20 73 70 65 63 20 28 70 6f 70 20 73 70 65 63 29 20 28 65 72 72 6f ..(val.(if.spec.(pop.spec).(erro
573a0 72 20 22 4e 6f 20 76 61 6c 75 65 20 66 6f 72 20 60 25 73 27 22 20 6b 65 79 29 29 29 29 0a 20 20 r."No.value.for.`%s'".key))))...
573c0 20 20 20 20 20 20 28 63 6f 6e 64 20 28 28 65 71 20 6b 65 79 20 3a 63 6c 61 73 73 29 0a 20 20 20 ......(cond.((eq.key.:class)....
573e0 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 63 6c 61 73 73 20 76 61 6c 29 29 0a 20 20 ............(setq.class.val))...
57400 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6f 72 20 28 73 79 6d 62 6f 6c 70 20 76 61 6c 29 0a 20 ............((or.(symbolp.val)..
57420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6c 69 73 74 70 20 76 61 ..................(and.(listp.va
57440 6c 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 6e 6f 74 20 l).........................(not.
57460 28 6d 65 6d 71 20 28 63 61 72 20 76 61 6c 29 20 28 6c 69 73 74 20 27 6c 61 6d 62 64 61 20 28 69 (memq.(car.val).(list.'lambda.(i
57480 6e 74 65 72 6e 20 22 22 29 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 ntern.""))))))................(s
574a0 65 74 71 20 61 72 67 73 20 28 70 6c 69 73 74 2d 70 75 74 20 61 72 67 73 20 6b 65 79 20 28 6d 61 etq.args.(plist-put.args.key.(ma
574c0 63 72 6f 65 78 70 2d 71 75 6f 74 65 20 76 61 6c 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 croexp-quote.val))))............
574e0 20 20 20 28 28 73 65 74 71 20 61 72 67 73 20 28 70 6c 69 73 74 2d 70 75 74 20 61 72 67 73 20 6b ...((setq.args.(plist-put.args.k
57500 65 79 20 76 61 6c 29 29 29 29 29 29 0a 20 20 20 20 28 75 6e 6c 65 73 73 20 28 6f 72 20 73 70 65 ey.val)))))).....(unless.(or.spe
57520 63 20 63 6c 61 73 73 20 28 6e 6f 74 20 28 70 6c 69 73 74 2d 67 65 74 20 61 72 67 73 20 3a 73 65 c.class.(not.(plist-get.args.:se
57540 74 75 70 2d 63 68 69 6c 64 72 65 6e 29 29 29 0a 20 20 20 20 20 20 28 6d 65 73 73 61 67 65 20 22 tup-children))).......(message."
57560 57 41 52 4e 49 4e 47 3a 20 25 73 3a 20 57 68 65 6e 20 25 73 20 69 73 20 75 73 65 64 2c 20 25 73 WARNING:.%s:.When.%s.is.used,.%s
57580 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 22 0a 20 20 20 20 20 20 20 .must.also.be.specified"........
575a0 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 ........'transient-define-prefix
575c0 20 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 20 3a 63 6c 61 73 73 29 29 0a 20 20 20 20 28 6c .:setup-children.:class)).....(l
575e0 69 73 74 20 27 76 65 63 74 6f 72 0a 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 27 71 75 6f ist.'vector...........(list.'quo
57600 74 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 20 28 63 6c 61 73 73 29 te.................(cond.(class)
57620 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 .......................((cl-type
57640 70 20 28 63 61 72 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p.(car.spec)....................
57660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 28 6f 72 20 76 65 63 74 6f 72 20 28 61 6e 64 20 73 ..............'(or.vector.(and.s
57680 79 6d 62 6f 6c 20 28 6e 6f 74 20 6e 75 6c 6c 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ymbol.(not.null)))).............
576a0 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 29 0a 20 ...........'transient-columns)..
576c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 27 74 72 61 6e 73 69 65 6e 74 .....................('transient
576e0 2d 63 6f 6c 75 6d 6e 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 61 72 67 73 20 28 -column)))...........(and.args.(
57700 63 6f 6e 73 20 27 6c 69 73 74 20 61 72 67 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e cons.'list.args))...........(con
57720 73 20 27 6c 69 73 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 6e 20 s.'list.................(mapcan.
57740 28 6c 61 6d 62 64 61 20 28 73 29 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 63 68 (lambda.(s).(transient--parse-ch
57760 69 6c 64 20 70 72 65 66 69 78 20 73 29 29 20 73 70 65 63 29 29 29 29 29 0a 0a 28 64 65 66 75 6e ild.prefix.s)).spec)))))..(defun
57780 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 73 75 66 66 69 78 20 28 70 72 65 66 69 78 .transient--parse-suffix.(prefix
577a0 20 73 70 65 63 29 0a 20 20 28 6c 65 74 20 28 63 6c 61 73 73 20 61 72 67 73 29 0a 20 20 20 20 28 .spec)...(let.(class.args).....(
577c0 63 6c 2d 66 6c 65 74 20 28 28 75 73 65 20 28 70 72 6f 70 20 76 61 6c 75 65 29 0a 20 20 20 20 20 cl-flet.((use.(prop.value)......
577e0 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 61 72 67 73 20 28 70 6c 69 73 74 2d 70 75 74 ...........(setq.args.(plist-put
57800 20 61 72 67 73 20 70 72 6f 70 20 76 61 6c 75 65 29 29 29 29 0a 20 20 20 20 20 20 28 70 63 61 73 .args.prop.value)))).......(pcas
57820 65 20 28 63 61 72 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 20 69 e.(car.spec).........((cl-type.i
57840 6e 74 65 67 65 72 29 0a 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 6c 65 76 65 6c 20 28 70 6f nteger)..........(use.:level.(po
57860 70 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 20 20 28 70 63 61 73 65 20 28 63 61 72 20 73 70 65 p.spec)))).......(pcase.(car.spe
57880 63 29 0a 20 20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 20 28 6f 72 20 73 74 72 69 6e 67 20 c).........((cl-type.(or.string.
578a0 76 65 63 74 6f 72 29 29 0a 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 6b 65 79 20 28 70 6f 70 vector))..........(use.:key.(pop
578c0 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 20 20 28 70 63 61 73 65 20 28 63 61 72 20 73 70 65 63 .spec)))).......(pcase.(car.spec
578e0 29 0a 20 20 20 20 20 20 20 20 28 28 67 75 61 72 64 20 28 6f 72 20 28 73 74 72 69 6e 67 70 20 28 ).........((guard.(or.(stringp.(
57900 63 61 72 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 car.spec)).....................(
57920 61 6e 64 20 28 65 71 20 28 63 61 72 2d 73 61 66 65 20 28 63 61 72 20 73 70 65 63 29 29 20 27 6c and.(eq.(car-safe.(car.spec)).'l
57940 61 6d 62 64 61 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 ambda)..........................
57960 28 6e 6f 74 20 28 63 6f 6d 6d 61 6e 64 70 20 28 63 61 72 20 73 70 65 63 29 29 29 29 29 29 0a 20 (not.(commandp.(car.spec))))))..
57980 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 64 65 73 63 72 69 70 74 69 6f 6e 20 28 70 6f 70 20 73 ........(use.:description.(pop.s
579a0 70 65 63 29 29 29 0a 20 20 20 20 20 20 20 20 28 28 61 6e 64 20 28 63 6c 2d 74 79 70 65 20 28 61 pec))).........((and.(cl-type.(a
579c0 6e 64 20 73 79 6d 62 6f 6c 20 28 6e 6f 74 20 6b 65 79 77 6f 72 64 29 20 28 6e 6f 74 20 63 6f 6d nd.symbol.(not.keyword).(not.com
579e0 6d 61 6e 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 67 75 61 72 64 20 28 63 6f mand)))...............(guard.(co
57a00 6d 6d 61 6e 64 70 20 28 63 61 64 72 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 mmandp.(cadr.spec))))..........(
57a20 75 73 65 20 3a 64 65 73 63 72 69 70 74 69 6f 6e 20 28 6d 61 63 72 6f 65 78 70 2d 71 75 6f 74 65 use.:description.(macroexp-quote
57a40 20 28 70 6f 70 20 73 70 65 63 29 29 29 29 29 0a 20 20 20 20 20 20 28 70 63 61 73 65 20 28 63 61 .(pop.spec))))).......(pcase.(ca
57a60 72 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 28 28 6f 72 20 3a 69 6e 66 6f 20 3a 69 6e 66 6f r.spec).........((or.:info.:info
57a80 2a 20 3a 63 6f 6e 73 29 29 0a 20 20 20 20 20 20 20 20 28 28 61 6e 64 20 28 63 6c 2d 74 79 70 65 *.:cons)).........((and.(cl-type
57aa0 20 6b 65 79 77 6f 72 64 29 20 69 6e 76 61 6c 69 64 29 0a 20 20 20 20 20 20 20 20 20 28 65 72 72 .keyword).invalid)..........(err
57ac0 6f 72 20 22 4e 65 65 64 20 63 6f 6d 6d 61 6e 64 2c 20 61 72 67 75 6d 65 6e 74 2c 20 60 3a 69 6e or."Need.command,.argument,.`:in
57ae0 66 6f 27 2c 20 60 3a 69 6e 66 6f 2a 27 20 6f 72 20 60 3a 63 6f 6e 73 27 3b 20 67 6f 74 20 60 25 fo',.`:info*'.or.`:cons';.got.`%
57b00 73 27 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 76 61 6c 69 64 29 29 0a 20 20 s'".................invalid))...
57b20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 20 73 79 6d 62 6f 6c 29 0a 20 20 20 20 20 20 20 20 ......((cl-type.symbol).........
57b40 20 28 75 73 65 20 3a 63 6f 6d 6d 61 6e 64 20 28 6d 61 63 72 6f 65 78 70 2d 71 75 6f 74 65 20 28 .(use.:command.(macroexp-quote.(
57b60 70 6f 70 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 20 20 20 20 3b 3b 20 44 75 72 69 6e 67 20 6d pop.spec)))).........;;.During.m
57b80 61 63 72 6f 2d 65 78 70 61 6e 73 69 6f 6e 20 74 68 69 73 20 69 73 20 65 78 70 65 63 74 65 64 20 acro-expansion.this.is.expected.
57ba0 74 6f 20 62 65 20 61 20 60 6c 61 6d 62 64 61 27 0a 20 20 20 20 20 20 20 20 3b 3b 20 65 78 70 72 to.be.a.`lambda'.........;;.expr
57bc0 65 73 73 69 6f 6e 20 28 69 2e 65 2e 2c 20 73 6f 75 72 63 65 20 63 6f 64 65 29 2e 20 20 57 68 65 ession.(i.e.,.source.code)...Whe
57be0 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 61 0a 20 20 20 20 20 20 20 20 n.this.is.called.from.a.........
57c00 3b 3b 20 60 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 27 20 66 75 6e 63 74 69 6f 6e 2c 20 69 ;;.`:setup-children'.function,.i
57c20 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 66 75 6e 63 74 69 6f 6e 20 6f 62 6a 65 63 74 0a t.may.also.be.a.function.object.
57c40 20 20 20 20 20 20 20 20 3b 3b 20 28 61 2e 6b 2e 61 20 61 20 66 75 6e 63 74 69 6f 6e 20 76 61 6c ........;;.(a.k.a.a.function.val
57c60 75 65 29 2e 20 20 48 6f 77 65 76 65 72 2c 20 77 65 20 6e 65 76 65 72 20 74 72 65 61 74 20 61 20 ue)...However,.we.never.treat.a.
57c80 73 74 72 69 6e 67 0a 20 20 20 20 20 20 20 20 3b 3b 20 61 73 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 string.........;;.as.a.command,.
57ca0 73 6f 20 77 65 20 68 61 76 65 20 74 6f 20 63 68 65 63 6b 20 66 6f 72 20 74 68 61 74 20 65 78 70 so.we.have.to.check.for.that.exp
57cc0 6c 69 63 69 74 6c 79 2e 0a 20 20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 20 28 61 6e 64 20 licitly..........((cl-type.(and.
57ce0 63 6f 6d 6d 61 6e 64 20 28 6e 6f 74 20 73 74 72 69 6e 67 29 29 29 0a 20 20 20 20 20 20 20 20 20 command.(not.string)))..........
57d00 28 6c 65 74 20 28 28 63 6d 64 20 28 70 6f 70 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 (let.((cmd.(pop.spec))..........
57d20 20 20 20 20 20 20 28 73 79 6d 20 28 69 6e 74 65 72 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ......(sym.(intern..............
57d40 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ........(format.................
57d60 20 20 20 20 20 20 22 74 72 61 6e 73 69 65 6e 74 3a 25 73 3a 25 73 3a 25 64 22 20 70 72 65 66 69 ......"transient:%s:%s:%d".prefi
57d80 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 70 6c 61 63 65 x.......................(replace
57da0 2d 72 65 67 65 78 70 2d 69 6e 2d 73 74 72 69 6e 67 20 28 70 6c 69 73 74 2d 67 65 74 20 61 72 67 -regexp-in-string.(plist-get.arg
57dc0 73 20 3a 6b 65 79 29 20 22 20 22 20 22 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s.:key)."."."").................
57de0 20 20 20 20 20 20 28 70 72 6f 67 31 20 67 65 6e 73 79 6d 2d 63 6f 75 6e 74 65 72 20 28 63 6c 2d ......(prog1.gensym-counter.(cl-
57e00 69 6e 63 66 20 67 65 6e 73 79 6d 2d 63 6f 75 6e 74 65 72 29 29 29 29 29 29 0a 20 20 20 20 20 20 incf.gensym-counter)))))).......
57e20 20 20 20 20 20 28 75 73 65 20 3a 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .....(use.:command..............
57e40 20 20 20 60 28 70 72 6f 67 31 20 27 2c 73 79 6d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ...`(prog1.',sym................
57e60 20 20 20 20 28 70 75 74 20 27 2c 73 79 6d 20 27 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 ....(put.',sym.'interactive-only
57e80 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 73 79 .t)....................(put.',sy
57ea0 6d 20 27 63 6f 6d 70 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 65 20 23 27 74 72 61 6e 73 69 m.'completion-predicate.#'transi
57ec0 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ent--suffix-only)...............
57ee0 20 20 20 20 20 28 64 65 66 61 6c 69 61 73 20 27 2c 73 79 6d 20 2c 63 6d 64 29 29 29 29 29 0a 20 .....(defalias.',sym.,cmd)))))..
57f00 20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 20 28 6f 72 20 73 74 72 69 6e 67 20 28 61 6e 64 .......((cl-type.(or.string.(and
57f20 20 6c 69 73 74 20 28 6e 6f 74 20 6e 75 6c 6c 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 6c 65 .list.(not.null))))..........(le
57f40 74 20 28 28 61 72 67 20 28 70 6f 70 20 73 70 65 63 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 t.((arg.(pop.spec)))............
57f60 28 63 6c 2d 74 79 70 65 63 61 73 65 20 61 72 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c (cl-typecase.arg..............(l
57f80 69 73 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 73 68 6f 72 74 61 72 67 ist...............(use.:shortarg
57fa0 20 28 63 61 72 20 61 72 67 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a .(car.arg))...............(use.:
57fc0 61 72 67 75 6d 65 6e 74 20 28 63 61 64 72 20 61 72 67 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 argument.(cadr.arg))............
57fe0 20 20 20 28 73 65 74 71 20 61 72 67 20 28 63 61 64 72 20 61 72 67 29 29 29 0a 20 20 20 20 20 20 ...(setq.arg.(cadr.arg))).......
58000 20 20 20 20 20 20 20 28 73 74 72 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 .......(string...............(wh
58020 65 6e 2d 6c 65 74 20 28 28 73 68 6f 72 74 61 72 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 en-let.((shortarg.(transient--de
58040 72 69 76 65 2d 73 68 6f 72 74 61 72 67 20 61 72 67 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 rive-shortarg.arg)))............
58060 20 20 20 20 20 28 75 73 65 20 3a 73 68 6f 72 74 61 72 67 20 73 68 6f 72 74 61 72 67 29 29 0a 20 .....(use.:shortarg.shortarg))..
58080 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 61 72 67 75 6d 65 6e 74 20 61 72 67 29 .............(use.:argument.arg)
580a0 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 ))............(use.:command.....
580c0 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 73 79 6d 20 28 69 6e 74 65 72 6e 20 28 ............(let.((sym.(intern.(
580e0 66 6f 72 6d 61 74 20 22 74 72 61 6e 73 69 65 6e 74 3a 25 73 3a 25 73 22 20 70 72 65 66 69 78 20 format."transient:%s:%s".prefix.
58100 61 72 67 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 60 28 70 72 6f 67 arg))))...................`(prog
58120 31 20 27 2c 73 79 6d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 75 1.',sym......................(pu
58140 74 20 27 2c 73 79 6d 20 27 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 74 29 0a 20 20 20 t.',sym.'interactive-only.t)....
58160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 73 79 6d 20 27 63 6f ..................(put.',sym.'co
58180 6d 70 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 65 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d mpletion-predicate.#'transient--
581a0 73 75 66 66 69 78 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 suffix-only)....................
581c0 20 20 28 64 65 66 61 6c 69 61 73 20 27 2c 73 79 6d 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 ..(defalias.',sym.#'transient--d
581e0 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 0a 20 20 20 20 20 20 20 efault-infix-command))))........
58200 20 20 20 20 28 70 63 61 73 65 20 28 63 61 72 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 ....(pcase.(car.spec)...........
58220 20 20 20 28 28 63 6c 2d 74 79 70 65 20 28 61 6e 64 20 28 6e 6f 74 20 6e 75 6c 6c 29 20 28 6e 6f ...((cl-type.(and.(not.null).(no
58240 74 20 6b 65 79 77 6f 72 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 t.keyword)))...............(setq
58260 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e 29 0a 20 20 20 20 20 20 .class.'transient-option).......
58280 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 72 65 61 64 65 72 20 28 6d 61 63 72 6f 65 78 70 2d 71 ........(use.:reader.(macroexp-q
582a0 75 6f 74 65 20 28 70 6f 70 20 73 70 65 63 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 uote.(pop.spec))))..............
582c0 28 28 67 75 61 72 64 20 28 73 74 72 69 6e 67 2d 73 75 66 66 69 78 2d 70 20 22 3d 22 20 61 72 67 ((guard.(string-suffix-p."=".arg
582e0 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 63 6c 61 73 73 20 27 74 72 ))...............(setq.class.'tr
58300 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f ansient-option))..............(_
58320 20 28 73 65 74 71 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 29 29 .(setq.class.'transient-switch))
58340 29 29 29 0a 20 20 20 20 20 20 20 20 28 69 6e 76 61 6c 69 64 0a 20 20 20 20 20 20 20 20 20 28 65 ))).........(invalid..........(e
58360 72 72 6f 72 20 22 4e 65 65 64 20 63 6f 6d 6d 61 6e 64 2c 20 61 72 67 75 6d 65 6e 74 2c 20 60 3a rror."Need.command,.argument,.`:
58380 69 6e 66 6f 27 20 6f 72 20 60 3a 69 6e 66 6f 2a 27 3b 20 67 6f 74 20 25 73 22 20 69 6e 76 61 6c info'.or.`:info*';.got.%s".inval
583a0 69 64 29 29 29 0a 20 20 20 20 20 20 28 77 68 69 6c 65 20 28 6b 65 79 77 6f 72 64 70 20 28 63 61 id))).......(while.(keywordp.(ca
583c0 72 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 2a 20 28 28 6b 65 79 20 28 70 6f r.spec)).........(let*.((key.(po
583e0 70 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 61 6c 20 28 69 66 p.spec))................(val.(if
58400 20 73 70 65 63 20 28 70 6f 70 20 73 70 65 63 29 20 28 65 72 72 6f 72 20 22 4e 6f 20 76 61 6c 75 .spec.(pop.spec).(error."No.valu
58420 65 20 66 6f 72 20 60 25 73 27 22 20 6b 65 79 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 70 e.for.`%s'".key))))...........(p
58440 63 61 73 65 20 6b 65 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 3a 63 6c 61 73 73 20 28 73 65 case.key.............(:class.(se
58460 74 71 20 63 6c 61 73 73 20 76 61 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 3a 69 6e 66 tq.class.val)).............(:inf
58480 6f 20 20 28 73 65 74 71 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d o..(setq.class.'transient-inform
584a0 61 74 69 6f 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 ation).....................(use.
584c0 3a 64 65 73 63 72 69 70 74 69 6f 6e 20 76 61 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 :description.val)).............(
584e0 3a 69 6e 66 6f 2a 20 28 73 65 74 71 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e :info*.(setq.class.'transient-in
58500 66 6f 72 6d 61 74 69 6f 6e 2a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 formation*).....................
58520 28 75 73 65 20 3a 64 65 73 63 72 69 70 74 69 6f 6e 20 76 61 6c 29 29 0a 20 20 20 20 20 20 20 20 (use.:description.val)).........
58540 20 20 20 20 28 3a 63 6f 6e 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 63 6c ....(:cons..............(setq.cl
58560 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e 29 0a 20 20 20 20 ass.'transient-cons-option).....
58580 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 .........(use.:command..........
585a0 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 73 79 6d 20 28 69 6e 74 65 72 6e 20 28 66 6f 72 .........(let.((sym.(intern.(for
585c0 6d 61 74 20 22 74 72 61 6e 73 69 65 6e 74 3a 25 73 3a 25 73 22 20 70 72 65 66 69 78 20 76 61 6c mat."transient:%s:%s".prefix.val
585e0 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 60 28 70 72 6f 67 31 )))).....................`(prog1
58600 20 27 2c 73 79 6d 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 70 .',sym........................(p
58620 75 74 20 27 2c 73 79 6d 20 27 69 6e 74 65 72 61 63 74 69 76 65 2d 6f 6e 6c 79 20 74 29 0a 20 20 ut.',sym.'interactive-only.t)...
58640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 75 74 20 27 2c 73 79 6d 20 .....................(put.',sym.
58660 27 63 6f 6d 70 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 65 20 23 27 74 72 61 6e 73 69 65 6e 'completion-predicate.#'transien
58680 74 2d 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t--suffix-only).................
586a0 20 20 20 20 20 20 20 28 64 65 66 61 6c 69 61 73 20 27 2c 73 79 6d 20 23 27 74 72 61 6e 73 69 65 .......(defalias.',sym.#'transie
586c0 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 0a 20 20 nt--default-infix-command))))...
586e0 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 61 72 67 75 6d 65 6e 74 20 76 61 6c 29 29 0a ...........(use.:argument.val)).
58700 20 20 20 20 20 20 20 20 20 20 20 20 28 28 67 75 61 72 64 20 28 65 71 20 28 63 61 72 2d 73 61 66 ............((guard.(eq.(car-saf
58720 65 20 76 61 6c 29 20 27 5c 2c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 6b e.val).'\,))..............(use.k
58740 65 79 20 28 63 61 64 72 20 76 61 6c 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 28 67 75 ey.(cadr.val))).............((gu
58760 61 72 64 20 28 6f 72 20 28 73 79 6d 62 6f 6c 70 20 76 61 6c 29 0a 20 20 20 20 20 20 20 20 20 20 ard.(or.(symbolp.val)...........
58780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6c 69 73 74 70 20 76 61 6c 29 0a 20 ..............(and.(listp.val)..
587a0 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 6e 6f 74 ............................(not
587c0 20 28 6d 65 6d 71 20 28 63 61 72 20 76 61 6c 29 20 28 6c 69 73 74 20 27 6c 61 6d 62 64 61 20 28 .(memq.(car.val).(list.'lambda.(
587e0 69 6e 74 65 72 6e 20 22 22 29 29 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 intern."")))))))..............(u
58800 73 65 20 6b 65 79 20 28 6d 61 63 72 6f 65 78 70 2d 71 75 6f 74 65 20 76 61 6c 29 29 29 0a 20 20 se.key.(macroexp-quote.val)))...
58820 20 20 20 20 20 20 20 20 20 20 28 5f 20 28 75 73 65 20 6b 65 79 20 76 61 6c 29 29 29 29 29 0a 20 ..........(_.(use.key.val)))))..
58840 20 20 20 20 20 28 77 68 65 6e 20 73 70 65 63 0a 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 .....(when.spec.........(error."
58860 4e 65 65 64 20 6b 65 79 77 6f 72 64 2c 20 67 6f 74 20 25 53 22 20 28 63 61 72 20 73 70 65 63 29 Need.keyword,.got.%S".(car.spec)
58880 29 29 0a 20 20 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 6b 65 79 20 28 70 6c 69 73 74 2d 67 65 )).......(if-let.((key.(plist-ge
588a0 74 20 61 72 67 73 20 3a 6b 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 t.args.:key)))...........(when.(
588c0 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 5c 5c 60 5c 5c 28 7b 70 7d 5c 5c 29 22 20 6b 65 79 29 string-match."\\`\\({p}\\)".key)
588e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 6b 65 79 0a 20 20 20 20 20 20 20 20 20 .............(use.:key..........
58900 20 20 20 20 20 20 20 20 28 72 65 70 6c 61 63 65 2d 6d 61 74 63 68 20 74 72 61 6e 73 69 65 6e 74 ........(replace-match.transient
58920 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 20 74 20 74 20 6b 65 79 20 31 -common-command-prefix.t.t.key.1
58940 29 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 73 68 6f 72 74 61 72 67 ))).........(when-let.((shortarg
58960 20 28 70 6c 69 73 74 2d 67 65 74 20 61 72 67 73 20 3a 73 68 6f 72 74 61 72 67 29 29 29 0a 20 20 .(plist-get.args.:shortarg)))...
58980 20 20 20 20 20 20 20 20 28 75 73 65 20 3a 6b 65 79 20 73 68 6f 72 74 61 72 67 29 29 29 29 0a 20 ........(use.:key.shortarg))))..
589a0 20 20 20 28 6c 69 73 74 20 27 63 6f 6e 73 0a 20 20 20 20 20 20 20 20 20 20 28 6d 61 63 72 6f 65 ...(list.'cons...........(macroe
589c0 78 70 2d 71 75 6f 74 65 20 28 6f 72 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 75 xp-quote.(or.class.'transient-su
589e0 66 66 69 78 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 20 27 6c 69 73 74 20 61 72 67 ffix))...........(cons.'list.arg
58a00 73 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 72 69 76 65 2d s))))..(defun.transient--derive-
58a20 73 68 6f 72 74 61 72 67 20 28 61 72 67 29 0a 20 20 28 73 61 76 65 2d 6d 61 74 63 68 2d 64 61 74 shortarg.(arg)...(save-match-dat
58a40 61 0a 20 20 20 20 28 61 6e 64 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 5c 5c 60 5c 5c 28 a.....(and.(string-match."\\`\\(
58a60 2d 5b 61 2d 7a 41 2d 5a 5d 5c 5c 29 5c 5c 28 5c 5c 27 5c 5c 7c 3d 5c 5c 29 22 20 61 72 67 29 0a -[a-zA-Z]\\)\\(\\'\\|=\\)".arg).
58a80 20 20 20 20 20 20 20 20 20 28 6d 61 74 63 68 2d 73 74 72 69 6e 67 20 31 20 61 72 67 29 29 29 29 .........(match-string.1.arg))))
58aa0 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 2d 63 6f 6d 70 6c ..(defun.transient-command-compl
58ac0 65 74 69 6f 6e 2d 6e 6f 74 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 2d 70 20 28 73 79 6d 62 6f 6c 20 etion-not-suffix-only-p.(symbol.
58ae0 5f 62 75 66 66 65 72 29 0a 20 20 22 53 61 79 20 77 68 65 74 68 65 72 20 53 59 4d 42 4f 4c 20 73 _buffer)..."Say.whether.SYMBOL.s
58b00 68 6f 75 6c 64 20 62 65 20 6f 66 66 65 72 65 64 20 61 73 20 61 20 63 6f 6d 70 6c 65 74 69 6f 6e hould.be.offered.as.a.completion
58b20 2e 0a 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 53 59 4d 42 4f 4c 27 73 20 60 63 6f 6d 70 ..If.the.value.of.SYMBOL's.`comp
58b40 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 65 27 20 70 72 6f 70 65 72 74 79 20 69 73 0a 60 74 letion-predicate'.property.is.`t
58b60 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 27 2c 20 74 68 65 6e 20 72 65 74 ransient--suffix-only',.then.ret
58b80 75 72 6e 20 6e 69 6c 2c 20 6f 74 68 65 72 77 69 73 65 20 72 65 74 75 72 6e 20 74 2e 0a 54 68 69 urn.nil,.otherwise.return.t..Thi
58ba0 73 20 69 73 20 74 68 65 20 63 61 73 65 20 77 68 65 6e 20 61 20 63 6f 6d 6d 61 6e 64 20 73 68 6f s.is.the.case.when.a.command.sho
58bc0 75 6c 64 20 6f 6e 6c 79 20 65 76 65 72 20 62 65 20 75 73 65 64 20 61 73 20 61 0a 73 75 66 66 69 uld.only.ever.be.used.as.a.suffi
58be0 78 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 x.of.a.transient.prefix.command.
58c00 28 61 73 20 6f 70 70 6f 73 65 64 20 74 6f 20 62 69 6e 64 69 6e 67 73 0a 69 6e 20 72 65 67 75 6c (as.opposed.to.bindings.in.regul
58c20 61 72 20 6b 65 79 6d 61 70 73 20 6f 72 20 62 79 20 75 73 69 6e 67 20 60 65 78 65 63 75 74 65 2d ar.keymaps.or.by.using.`execute-
58c40 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 27 29 2e 22 0a 20 20 28 6e 6f 74 20 28 65 71 20 extended-command')."...(not.(eq.
58c60 28 67 65 74 20 73 79 6d 62 6f 6c 20 27 63 6f 6d 70 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 (get.symbol.'completion-predicat
58c80 65 29 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 29 29 29 0a 0a 28 e).'transient--suffix-only)))..(
58ca0 64 65 66 61 6c 69 61 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 defalias.'transient--suffix-only
58cc0 20 23 27 69 67 6e 6f 72 65 0a 20 20 22 49 67 6e 6f 72 65 20 41 52 47 55 4d 45 4e 54 53 2c 20 64 .#'ignore..."Ignore.ARGUMENTS,.d
58ce0 6f 20 6e 6f 74 68 69 6e 67 2c 20 61 6e 64 20 72 65 74 75 72 6e 20 6e 69 6c 2e 0a 53 65 65 20 61 o.nothing,.and.return.nil..See.a
58d00 6c 73 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 2d 63 6f 6d 70 6c 65 74 69 6f lso.`transient-command-completio
58d20 6e 2d 6e 6f 74 2d 73 75 66 66 69 78 2d 6f 6e 6c 79 2d 70 27 2e 0a 4f 6e 6c 79 20 75 73 65 20 74 n-not-suffix-only-p'..Only.use.t
58d40 68 69 73 20 61 6c 69 61 73 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 60 63 his.alias.as.the.value.of.the.`c
58d60 6f 6d 70 6c 65 74 69 6f 6e 2d 70 72 65 64 69 63 61 74 65 27 0a 73 79 6d 62 6f 6c 20 70 72 6f 70 ompletion-predicate'.symbol.prop
58d80 65 72 74 79 2e 22 29 0a 0a 28 77 68 65 6e 20 28 61 6e 64 20 28 62 6f 75 6e 64 70 20 27 72 65 61 erty.")..(when.(and.(boundp.'rea
58da0 64 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 64 69 63 61 74 65 29 20 3b 20 d-extended-command-predicate).;.
58dc0 73 69 6e 63 65 20 45 6d 61 63 73 20 32 38 2e 31 0a 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 since.Emacs.28.1............(not
58de0 20 72 65 61 64 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 64 69 63 61 74 65 .read-extended-command-predicate
58e00 29 29 0a 20 20 28 73 65 74 71 20 72 65 61 64 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 ))...(setq.read-extended-command
58e20 2d 70 72 65 64 69 63 61 74 65 0a 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 63 -predicate.........#'transient-c
58e40 6f 6d 6d 61 6e 64 2d 63 6f 6d 70 6c 65 74 69 6f 6e 2d 6e 6f 74 2d 73 75 66 66 69 78 2d 6f 6e 6c ommand-completion-not-suffix-onl
58e60 79 2d 70 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 74 2d 6c 61 79 y-p))..(defun.transient--set-lay
58e80 6f 75 74 20 28 70 72 65 66 69 78 20 6c 61 79 6f 75 74 29 0a 20 20 28 70 75 74 20 70 72 65 66 69 out.(prefix.layout)...(put.prefi
58ea0 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 20 28 76 65 63 74 6f 72 20 32 20 6e x.'transient--layout.(vector.2.n
58ec0 69 6c 20 6c 61 79 6f 75 74 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d il.layout)))..(defun.transient--
58ee0 67 65 74 2d 6c 61 79 6f 75 74 20 28 70 72 65 66 69 78 29 0a 20 20 28 69 66 2d 6c 65 74 2a 0a 20 get-layout.(prefix)...(if-let*..
58f00 20 20 20 20 20 28 28 6c 61 79 6f 75 74 0a 20 20 20 20 20 20 20 20 28 6f 72 20 28 67 65 74 20 70 .....((layout.........(or.(get.p
58f20 72 65 66 69 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 29 0a 20 20 20 20 20 20 refix.'transient--layout).......
58f40 20 20 20 20 20 20 3b 3b 20 4d 69 67 72 61 74 65 20 75 6e 70 61 72 73 65 64 20 6c 65 67 61 63 79 ......;;.Migrate.unparsed.legacy
58f60 20 67 72 6f 75 70 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 .group.definition..............(
58f80 63 6f 6e 64 69 74 69 6f 6e 2d 63 61 73 65 2d 75 6e 6c 65 73 73 2d 64 65 62 75 67 20 65 72 72 0a condition-case-unless-debug.err.
58fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 76 61 6c 75 ................(and-let*.((valu
58fc0 65 20 28 73 79 6d 62 6f 6c 2d 76 61 6c 75 65 20 70 72 65 66 69 78 29 29 29 0a 20 20 20 20 20 20 e.(symbol-value.prefix))).......
58fe0 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 74 2d 6c 61 79 6f ............(transient--set-layo
59000 75 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 65 66 69 78 0a 20 20 20 ut....................prefix....
59020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 61 6e 64 20 28 6c 69 73 74 70 20 ................(if.(and.(listp.
59040 76 61 6c 75 65 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 value)..........................
59060 20 20 20 28 6f 72 20 28 6c 69 73 74 70 20 28 63 61 72 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 ...(or.(listp.(car.value))......
59080 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 76 65 63 74 ...........................(vect
590a0 6f 72 70 20 28 63 61 72 20 76 61 6c 75 65 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 orp.(car.value))))..............
590c0 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 ..........(transient-parse-suffi
590e0 78 65 73 20 70 72 65 66 69 78 20 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 xes.prefix.value)...............
59100 20 20 20 20 20 20 20 28 6c 69 73 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 .......(list.(transient-parse-su
59120 66 66 69 78 20 70 72 65 66 69 78 20 76 61 6c 75 65 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 ffix.prefix.value)))))..........
59140 20 20 20 20 20 28 65 72 72 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 65 73 73 .....(error................(mess
59160 61 67 65 20 22 4e 6f 74 20 61 20 6c 65 67 61 63 79 20 67 72 6f 75 70 20 64 65 66 69 6e 69 74 69 age."Not.a.legacy.group.definiti
59180 6f 6e 3a 20 25 73 3a 20 25 53 22 20 70 72 65 66 69 78 20 65 72 72 29 0a 20 20 20 20 20 20 20 20 on:.%s:.%S".prefix.err).........
591a0 20 20 20 20 20 20 20 6e 69 6c 29 29 29 29 29 0a 20 20 20 20 20 20 28 69 66 20 28 76 65 63 74 6f .......nil))))).......(if.(vecto
591c0 72 70 20 6c 61 79 6f 75 74 29 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 76 65 72 73 rp.layout)...........(let.((vers
591e0 69 6f 6e 20 28 61 72 65 66 20 6c 61 79 6f 75 74 20 30 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 ion.(aref.layout.0)))...........
59200 20 20 28 69 66 20 28 3d 20 76 65 72 73 69 6f 6e 20 32 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ..(if.(=.version.2).............
59220 20 20 20 20 6c 61 79 6f 75 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 ....layout...............(error.
59240 22 55 6e 73 75 70 70 6f 72 74 65 64 20 6c 61 79 6f 75 74 20 76 65 72 73 69 6f 6e 20 25 73 20 66 "Unsupported.layout.version.%s.f
59260 6f 72 20 25 73 22 20 76 65 72 73 69 6f 6e 20 70 72 65 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 or.%s".version.prefix)))........
59280 20 3b 3b 20 55 70 67 72 61 64 65 20 66 72 6f 6d 20 76 65 72 73 69 6f 6e 20 31 2e 0a 20 20 20 20 .;;.Upgrade.from.version.1......
592a0 20 20 20 20 28 63 6c 2d 6c 61 62 65 6c 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 28 75 70 67 ....(cl-labels.............((upg
592c0 72 61 64 65 20 28 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 rade.(spec)................(cond
592e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 76 65 63 74 6f 72 70 20 73 70 65 63 29 .................((vectorp.spec)
59300 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 63 61 73 65 2d 6c 65 74 20 28 28 60 ..................(pcase-let.((`
59320 5b 2c 6c 65 76 65 6c 20 2c 63 6c 61 73 73 20 2c 61 72 67 73 20 2c 63 68 69 6c 64 72 65 6e 5d 20 [,level.,class.,args.,children].
59340 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 spec))....................(when.
59360 6c 65 76 65 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 level......................(setq
59380 20 61 72 67 73 20 28 70 6c 69 73 74 2d 70 75 74 20 61 72 67 73 20 3a 6c 65 76 65 6c 20 6c 65 76 .args.(plist-put.args.:level.lev
593a0 65 6c 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 65 63 74 6f 72 el)))....................(vector
593c0 20 63 6c 61 73 73 20 61 72 67 73 20 28 6d 61 70 63 61 72 20 23 27 75 70 67 72 61 64 65 20 63 68 .class.args.(mapcar.#'upgrade.ch
593e0 69 6c 64 72 65 6e 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 61 6e 64 ildren)))).................((and
59400 20 28 6c 69 73 74 70 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .(listp.spec)...................
59420 20 20 20 20 28 6c 65 6e 67 74 68 3d 20 73 70 65 63 20 33 29 0a 20 20 20 20 20 20 20 20 20 20 20 ....(length=.spec.3)............
59440 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6e 75 6c 6c 20 28 63 61 72 20 73 70 65 63 29 29 ...........(or.(null.(car.spec))
59460 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 6e 61 74 6e ...........................(natn
59480 75 6d 70 20 28 63 61 72 20 73 70 65 63 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ump.(car.spec)))................
594a0 20 20 20 20 20 20 20 28 73 79 6d 62 6f 6c 70 20 28 63 61 64 72 20 73 70 65 63 29 29 29 0a 20 20 .......(symbolp.(cadr.spec)))...
594c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 63 61 73 65 2d 6c 65 74 20 28 28 60 28 2c 6c ...............(pcase-let.((`(,l
594e0 65 76 65 6c 20 2c 63 6c 61 73 73 20 2c 61 72 67 73 29 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 evel.,class.,args).spec)).......
59500 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 6c 65 76 65 6c 0a 20 20 20 20 20 20 20 .............(when.level........
59520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 61 72 67 73 20 28 70 6c 69 73 74 2d ..............(setq.args.(plist-
59540 70 75 74 20 61 72 67 73 20 3a 6c 65 76 65 6c 20 6c 65 76 65 6c 29 29 29 0a 20 20 20 20 20 20 20 put.args.:level.level)))........
59560 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 20 63 6c 61 73 73 20 61 72 67 73 29 29 29 0a ............(cons.class.args))).
59580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6c 69 73 74 70 20 73 70 65 63 29 0a 20 20 ................((listp.spec)...
595a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 23 27 75 70 67 72 61 64 65 ...............(mapcar.#'upgrade
595c0 20 73 70 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 20 73 70 65 63 29 .spec)).................(t.spec)
595e0 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 74 2d 6c 61 )))...........(transient--set-la
59600 79 6f 75 74 20 70 72 65 66 69 78 20 28 75 70 67 72 61 64 65 20 6c 61 79 6f 75 74 29 29 29 29 0a yout.prefix.(upgrade.layout)))).
59620 20 20 20 20 28 65 72 72 6f 72 20 22 4e 6f 74 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 ....(error."Not.a.transient.pref
59640 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 67 72 6f 75 70 20 64 65 66 69 6e 69 74 69 6f 6e 3a 20 ix.command.or.group.definition:.
59660 25 73 22 20 70 72 65 66 69 78 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d %s".prefix)))..(defun.transient-
59680 2d 67 65 74 2d 63 68 69 6c 64 72 65 6e 20 28 70 72 65 66 69 78 29 0a 20 20 28 61 72 65 66 20 28 -get-children.(prefix)...(aref.(
596a0 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 6c 61 79 6f 75 74 20 70 72 65 66 69 78 29 20 32 29 transient--get-layout.prefix).2)
596c0 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 )..(defun.transient-parse-suffix
596e0 20 28 70 72 65 66 69 78 20 73 75 66 66 69 78 29 0a 20 20 22 50 61 72 73 65 20 53 55 46 46 49 58 .(prefix.suffix)..."Parse.SUFFIX
59700 2c 20 74 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20 50 52 45 46 49 58 2e 0a 50 52 45 46 49 58 20 ,.to.be.added.to.PREFIX..PREFIX.
59720 69 73 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 73 79 6d 62 6f 6c 20 6f 72 20 6f 62 is.a.prefix.command.symbol.or.ob
59740 6a 65 63 74 2e 0a 53 55 46 46 49 58 20 69 73 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 ject..SUFFIX.is.a.suffix.command
59760 20 6f 72 20 61 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 28 6f 66 0a 20 20 .or.a.group.specification.(of...
59780 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 73 20 61 73 20 65 78 70 65 63 74 65 64 20 62 79 20 60 74 the.same.forms.as.expected.by.`t
597a0 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 27 29 2e 0a 49 6e 74 65 6e 64 ransient-define-prefix')..Intend
597c0 65 64 20 66 6f 72 20 75 73 65 20 69 6e 20 61 20 67 72 6f 75 70 27 73 20 60 3a 73 65 74 75 70 2d ed.for.use.in.a.group's.`:setup-
597e0 63 68 69 6c 64 72 65 6e 27 20 66 75 6e 63 74 69 6f 6e 2e 22 0a 20 20 28 77 68 65 6e 20 28 63 6c children'.function."...(when.(cl
59800 2d 74 79 70 65 70 20 70 72 65 66 69 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 29 -typep.prefix.'transient-prefix)
59820 0a 20 20 20 20 28 73 65 74 71 20 70 72 65 66 69 78 20 28 6f 72 65 66 20 70 72 65 66 69 78 20 63 .....(setq.prefix.(oref.prefix.c
59840 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 28 65 76 61 6c 20 28 63 61 72 20 28 74 72 61 6e 73 69 65 6e ommand)))...(eval.(car.(transien
59860 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 20 70 72 65 66 69 78 20 73 75 66 66 69 78 29 29 20 74 t--parse-child.prefix.suffix)).t
59880 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 ))..(defun.transient-parse-suffi
598a0 78 65 73 20 28 70 72 65 66 69 78 20 73 75 66 66 69 78 65 73 29 0a 20 20 22 50 61 72 73 65 20 53 xes.(prefix.suffixes)..."Parse.S
598c0 55 46 46 49 58 45 53 2c 20 74 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20 50 52 45 46 49 58 2e 0a UFFIXES,.to.be.added.to.PREFIX..
598e0 50 52 45 46 49 58 20 69 73 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 73 79 6d 62 6f PREFIX.is.a.prefix.command.symbo
59900 6c 20 6f 72 20 6f 62 6a 65 63 74 2e 0a 53 55 46 46 49 58 45 53 20 69 73 20 61 20 6c 69 73 74 20 l.or.object..SUFFIXES.is.a.list.
59920 6f 66 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 67 72 6f 75 70 20 73 70 65 of.suffix.command.or.a.group.spe
59940 63 69 66 69 63 61 74 69 6f 6e 0a 20 20 28 6f 66 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 73 20 cification...(of.the.same.forms.
59960 61 73 20 65 78 70 65 63 74 65 64 20 62 79 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 as.expected.by.`transient-define
59980 2d 70 72 65 66 69 78 27 29 2e 0a 49 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 69 6e 20 61 -prefix')..Intended.for.use.in.a
599a0 20 67 72 6f 75 70 27 73 20 60 3a 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 27 20 66 75 6e 63 74 .group's.`:setup-children'.funct
599c0 69 6f 6e 2e 22 0a 20 20 28 77 68 65 6e 20 28 63 6c 2d 74 79 70 65 70 20 70 72 65 66 69 78 20 27 ion."...(when.(cl-typep.prefix.'
599e0 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 29 0a 20 20 20 20 28 73 65 74 71 20 70 72 65 66 transient-prefix).....(setq.pref
59a00 69 78 20 28 6f 72 65 66 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 28 6d 61 ix.(oref.prefix.command)))...(ma
59a20 70 63 61 72 20 28 61 70 70 6c 79 2d 70 61 72 74 69 61 6c 6c 79 20 23 27 74 72 61 6e 73 69 65 6e pcar.(apply-partially.#'transien
59a40 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 29 20 73 75 66 66 69 78 65 73 29 t-parse-suffix.prefix).suffixes)
59a60 29 0a 0a 3b 3b 3b 20 45 64 69 74 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 )..;;;.Edit..(defun.transient--i
59a80 6e 73 65 72 74 2d 73 75 66 66 69 78 20 28 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 20 nsert-suffix.(prefix.loc.suffix.
59aa0 61 63 74 69 6f 6e 20 26 6f 70 74 69 6f 6e 61 6c 20 6b 65 65 70 2d 6f 74 68 65 72 29 0a 20 20 28 action.&optional.keep-other)...(
59ac0 70 63 61 73 65 2d 6c 65 74 2a 20 28 28 73 75 66 20 28 63 6c 2d 65 74 79 70 65 63 61 73 65 20 73 pcase-let*.((suf.(cl-etypecase.s
59ae0 75 66 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 65 63 uffix.......................(vec
59b00 74 6f 72 20 28 65 76 61 6c 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 67 72 6f 75 tor.(eval.(transient--parse-grou
59b20 70 20 20 70 72 65 66 69 78 20 73 75 66 66 69 78 29 20 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 p..prefix.suffix).t))...........
59b40 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 20 20 28 65 76 61 6c 20 28 74 72 61 6e 73 ............(list...(eval.(trans
59b60 69 65 6e 74 2d 2d 70 61 72 73 65 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 73 75 66 66 69 78 ient--parse-suffix.prefix.suffix
59b80 29 20 74 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 28 73 74 72 ).t)).......................(str
59ba0 69 6e 67 20 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ing.suffix).....................
59bc0 20 20 28 73 79 6d 62 6f 6c 20 73 75 66 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ..(symbol.suffix))).............
59be0 20 20 20 28 60 28 2c 65 6c 74 20 2c 67 72 6f 75 70 29 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c ...(`(,elt.,group).(transient--l
59c00 6f 63 61 74 65 2d 63 68 69 6c 64 20 70 72 65 66 69 78 20 6c 6f 63 29 29 29 0a 20 20 20 20 28 63 ocate-child.prefix.loc))).....(c
59c20 6f 6e 64 0a 20 20 20 20 20 28 28 6e 6f 74 20 65 6c 74 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 ond......((not.elt).......(funca
59c40 6c 6c 20 28 69 66 20 74 72 61 6e 73 69 65 6e 74 2d 65 72 72 6f 72 2d 6f 6e 2d 69 6e 73 65 72 74 ll.(if.transient-error-on-insert
59c60 2d 66 61 69 6c 75 72 65 20 23 27 65 72 72 6f 72 20 23 27 6d 65 73 73 61 67 65 29 0a 20 20 20 20 -failure.#'error.#'message).....
59c80 20 20 20 20 20 20 20 20 20 20 20 22 43 61 6e 6e 6f 74 20 69 6e 73 65 72 74 20 25 53 20 69 6e 74 ..........."Cannot.insert.%S.int
59ca0 6f 20 25 73 3b 20 25 73 20 6e 6f 74 20 66 6f 75 6e 64 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 o.%s;.%s.not.found".............
59cc0 20 20 20 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 29 29 0a 20 20 20 20 20 28 28 6f 72 ...suffix.prefix.loc))......((or
59ce0 20 28 61 6e 64 20 28 76 65 63 74 6f 72 70 20 73 75 66 66 69 78 29 20 28 6e 6f 74 20 28 76 65 63 .(and.(vectorp.suffix).(not.(vec
59d00 74 6f 72 70 20 65 6c 74 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6c 69 73 74 torp.elt)))...........(and.(list
59d20 70 20 20 20 73 75 66 66 69 78 29 20 28 76 65 63 74 6f 72 70 20 65 6c 74 29 29 0a 20 20 20 20 20 p...suffix).(vectorp.elt))......
59d40 20 20 20 20 20 28 61 6e 64 20 28 73 74 72 69 6e 67 70 20 73 75 66 66 69 78 29 20 28 76 65 63 74 .....(and.(stringp.suffix).(vect
59d60 6f 72 70 20 65 6c 74 29 29 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 28 69 66 20 74 72 orp.elt))).......(funcall.(if.tr
59d80 61 6e 73 69 65 6e 74 2d 65 72 72 6f 72 2d 6f 6e 2d 69 6e 73 65 72 74 2d 66 61 69 6c 75 72 65 20 ansient-error-on-insert-failure.
59da0 23 27 65 72 72 6f 72 20 23 27 6d 65 73 73 61 67 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 #'error.#'message)..............
59dc0 20 20 22 43 61 6e 6e 6f 74 20 70 6c 61 63 65 20 25 53 20 69 6e 74 6f 20 25 73 20 61 74 20 25 73 .."Cannot.place.%S.into.%s.at.%s
59de0 3b 20 25 73 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 75 66 66 69 78 20 70 72 65 66 ;.%s"................suffix.pref
59e00 69 78 20 6c 6f 63 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 73 75 66 66 69 78 65 73 20 ix.loc................"suffixes.
59e20 61 6e 64 20 67 72 6f 75 70 73 20 63 61 6e 6e 6f 74 20 62 65 20 73 69 62 6c 69 6e 67 73 22 29 29 and.groups.cannot.be.siblings"))
59e40 0a 20 20 20 20 20 28 74 0a 20 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 28 6e 6f ......(t.......(when-let*.((_(no
59e60 74 20 28 65 71 20 6b 65 65 70 2d 6f 74 68 65 72 20 27 61 6c 77 61 79 73 29 29 29 0a 20 20 20 20 t.(eq.keep-other.'always))).....
59e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 62 69 6e 64 69 6e 67 70 20 28 6c 69 73 74 70 20 73 ..............(bindingp.(listp.s
59ea0 75 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6b 65 79 20 28 74 72 61 uf))...................(key.(tra
59ec0 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6b 65 79 20 73 75 66 29 29 0a 20 20 20 20 20 20 20 nsient--suffix-key.suf))........
59ee0 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 66 6c 69 63 74 20 28 63 61 72 20 28 74 72 61 6e 73 ...........(conflict.(car.(trans
59f00 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 20 70 72 65 66 69 78 20 6b 65 79 29 29 29 ient--locate-child.prefix.key)))
59f20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 66 6c 69 63 74 70 0a 20 20 ...................(conflictp...
59f40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 61 6e 64 20 .................(and.(not.(and.
59f60 28 65 71 20 61 63 74 69 6f 6e 20 27 72 65 70 6c 61 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 (eq.action.'replace)............
59f80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 20 63 6f 6e 66 6c .......................(eq.confl
59fa0 69 63 74 20 65 6c 74 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 ict.elt)))......................
59fc0 20 20 20 28 6f 72 20 28 6e 6f 74 20 6b 65 65 70 2d 6f 74 68 65 72 29 0a 20 20 20 20 20 20 20 20 ...(or.(not.keep-other).........
59fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 20 28 70 6c 69 73 74 2d 67 ....................(eq.(plist-g
5a000 65 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 73 75 66 29 et.(transient--suffix-props.suf)
5a020 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 20 20 ................................
5a040 20 20 20 20 20 20 20 20 20 20 20 20 3a 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 ............:command)...........
5a060 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 65 74 ......................(plist-get
5a080 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 63 6f 6e 66 6c 69 .(transient--suffix-props.confli
5a0a0 63 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 20 20 20 20 20 20 ct).............................
5a0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 20 20 20 ...............:command)))......
5a0e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 75 61 6c 20 28 74 72 61 6e 73 ...................(equal.(trans
5a100 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 65 64 69 63 61 74 65 20 73 75 66 29 0a 20 20 20 20 ient--suffix-predicate.suf).....
5a120 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 74 72 61 6e ...........................(tran
5a140 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 65 64 69 63 61 74 65 20 63 6f 6e 66 6c 69 63 74 sient--suffix-predicate.conflict
5a160 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 72 65 6d 6f 76 65 2d ))))).........(transient-remove-
5a180 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6b 65 79 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 suffix.prefix.key).........(let.
5a1a0 28 28 65 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 20 70 72 ((eg.(transient--locate-child.pr
5a1c0 65 66 69 78 20 6c 6f 63 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 65 6c 74 20 efix.loc)))...........(setq.elt.
5a1e0 28 63 61 72 20 65 67 29 20 67 72 6f 75 70 20 28 63 61 64 72 20 65 67 29 29 29 29 0a 20 20 20 20 (car.eg).group.(cadr.eg)))).....
5a200 20 20 28 6c 65 74 20 28 28 6d 65 6d 20 28 6d 65 6d 71 20 65 6c 74 20 28 61 72 65 66 20 67 72 6f ..(let.((mem.(memq.elt.(aref.gro
5a220 75 70 20 32 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 70 63 61 73 65 2d 65 78 68 61 75 73 74 69 up.2)))).........(pcase-exhausti
5a240 76 65 20 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 28 27 69 6e 73 65 72 74 20 20 28 73 ve.action...........('insert..(s
5a260 65 74 63 64 72 20 6d 65 6d 20 28 63 6f 6e 73 20 65 6c 74 20 28 63 64 72 20 6d 65 6d 29 29 29 0a etcdr.mem.(cons.elt.(cdr.mem))).
5a280 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 63 61 72 20 6d 65 6d 20 ....................(setcar.mem.
5a2a0 73 75 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 27 61 70 70 65 6e 64 20 20 28 73 65 74 63 64 suf))...........('append..(setcd
5a2c0 72 20 6d 65 6d 20 28 63 6f 6e 73 20 73 75 66 20 28 63 64 72 20 6d 65 6d 29 29 29 29 0a 20 20 20 r.mem.(cons.suf.(cdr.mem))))....
5a2e0 20 20 20 20 20 20 20 28 27 72 65 70 6c 61 63 65 20 28 73 65 74 63 61 72 20 6d 65 6d 20 73 75 66 .......('replace.(setcar.mem.suf
5a300 29 29 29 29 29 29 29 29 0a 0a 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 0a 28 64 65 66 75 6e 20 ))))))))..;;;###autoload.(defun.
5a320 74 72 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 20 28 70 72 65 66 69 78 20 transient-insert-suffix.(prefix.
5a340 6c 6f 63 20 73 75 66 66 69 78 20 26 6f 70 74 69 6f 6e 61 6c 20 6b 65 65 70 2d 6f 74 68 65 72 29 loc.suffix.&optional.keep-other)
5a360 0a 20 20 22 49 6e 73 65 72 74 20 61 20 53 55 46 46 49 58 20 69 6e 74 6f 20 50 52 45 46 49 58 20 ..."Insert.a.SUFFIX.into.PREFIX.
5a380 62 65 66 6f 72 65 20 4c 4f 43 2e 0a 50 52 45 46 49 58 20 69 73 20 61 20 70 72 65 66 69 78 20 63 before.LOC..PREFIX.is.a.prefix.c
5a3a0 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 53 55 46 46 49 58 20 69 73 20 61 20 73 75 ommand,.a.symbol..SUFFIX.is.a.su
5a3c0 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 ffix.command.or.a.group.specific
5a3e0 61 74 69 6f 6e 20 28 6f 66 0a 20 20 74 68 65 20 73 61 6d 65 20 66 6f 72 6d 73 20 61 73 20 65 78 ation.(of...the.same.forms.as.ex
5a400 70 65 63 74 65 64 20 62 79 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 pected.by.`transient-define-pref
5a420 69 78 27 29 2e 0a 4c 4f 43 20 69 73 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 6b 65 79 20 76 65 ix')..LOC.is.a.command,.a.key.ve
5a440 63 74 6f 72 2c 20 61 20 6b 65 79 20 64 65 73 63 72 69 70 74 69 6f 6e 20 28 61 20 73 74 72 69 6e ctor,.a.key.description.(a.strin
5a460 67 0a 20 20 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 60 6b 65 79 2d 64 65 73 63 72 69 70 74 g...as.returned.by.`key-descript
5a480 69 6f 6e 27 29 2c 20 6f 72 20 61 20 63 6f 6f 72 64 69 6e 61 74 69 6f 6e 20 6c 69 73 74 0a 20 20 ion'),.or.a.coordination.list...
5a4a0 28 77 68 6f 73 65 20 6c 61 73 74 20 65 6c 65 6d 65 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 (whose.last.element.may.also.be.
5a4c0 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 6b 65 79 29 2e 0a 52 65 6d 6f 76 65 20 61 20 63 6f 6e 66 a.command.or.key)..Remove.a.conf
5a4e0 6c 69 63 74 69 6e 67 20 62 69 6e 64 69 6e 67 20 75 6e 6c 65 73 73 20 6f 70 74 69 6f 6e 61 6c 20 licting.binding.unless.optional.
5a500 4b 45 45 50 2d 4f 54 48 45 52 20 69 73 0a 20 20 6e 6f 6e 2d 6e 69 6c 2e 20 20 57 68 65 6e 20 74 KEEP-OTHER.is...non-nil...When.t
5a520 68 65 20 63 6f 6e 66 6c 69 63 74 20 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 61 20 66 61 6c 73 he.conflict.appears.to.be.a.fals
5a540 65 2d 70 6f 73 69 74 69 76 65 2c 0a 20 20 6e 6f 6e 2d 6e 69 6c 20 4b 45 45 50 2d 4f 54 48 45 52 e-positive,...non-nil.KEEP-OTHER
5a560 20 6d 61 79 20 62 65 20 69 67 6e 6f 72 65 64 2c 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 70 72 .may.be.ignored,.which.can.be.pr
5a580 65 76 65 6e 74 65 64 0a 20 20 62 79 20 75 73 69 6e 67 20 60 61 6c 77 61 79 73 27 2e 0a 53 65 65 evented...by.using.`always'..See
5a5a0 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 29 4d 6f 64 69 66 79 69 6e 67 .info.node.`(transient)Modifying
5a5c0 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 27 2e 22 0a 20 20 28 64 65 63 6c 61 .Existing.Transients'."...(decla
5a5e0 72 65 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d re.(indent.defun))...(transient-
5a600 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 -insert-suffix.prefix.loc.suffix
5a620 20 27 69 6e 73 65 72 74 20 6b 65 65 70 2d 6f 74 68 65 72 29 29 0a 0a 3b 3b 3b 23 23 23 61 75 74 .'insert.keep-other))..;;;###aut
5a640 6f 6c 6f 61 64 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 75 oload.(defun.transient-append-su
5a660 66 66 69 78 20 28 70 72 65 66 69 78 20 6c 6f 63 20 73 75 66 66 69 78 20 26 6f 70 74 69 6f 6e 61 ffix.(prefix.loc.suffix.&optiona
5a680 6c 20 6b 65 65 70 2d 6f 74 68 65 72 29 0a 20 20 22 49 6e 73 65 72 74 20 61 20 53 55 46 46 49 58 l.keep-other)..."Insert.a.SUFFIX
5a6a0 20 69 6e 74 6f 20 50 52 45 46 49 58 20 61 66 74 65 72 20 4c 4f 43 2e 0a 50 52 45 46 49 58 20 69 .into.PREFIX.after.LOC..PREFIX.i
5a6c0 73 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 53 55 s.a.prefix.command,.a.symbol..SU
5a6e0 46 46 49 58 20 69 73 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 67 72 FFIX.is.a.suffix.command.or.a.gr
5a700 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 28 6f 66 0a 20 20 74 68 65 20 73 61 6d 65 oup.specification.(of...the.same
5a720 20 66 6f 72 6d 73 20 61 73 20 65 78 70 65 63 74 65 64 20 62 79 20 60 74 72 61 6e 73 69 65 6e 74 .forms.as.expected.by.`transient
5a740 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 27 29 2e 0a 4c 4f 43 20 69 73 20 61 20 63 6f 6d 6d 61 -define-prefix')..LOC.is.a.comma
5a760 6e 64 2c 20 61 20 6b 65 79 20 76 65 63 74 6f 72 2c 20 61 20 6b 65 79 20 64 65 73 63 72 69 70 74 nd,.a.key.vector,.a.key.descript
5a780 69 6f 6e 20 28 61 20 73 74 72 69 6e 67 0a 20 20 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 60 ion.(a.string...as.returned.by.`
5a7a0 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 29 2c 20 6f 72 20 61 20 63 6f 6f 72 64 69 6e 61 key-description'),.or.a.coordina
5a7c0 74 69 6f 6e 20 6c 69 73 74 0a 20 20 28 77 68 6f 73 65 20 6c 61 73 74 20 65 6c 65 6d 65 6e 74 20 tion.list...(whose.last.element.
5a7e0 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 6b 65 79 29 2e 0a 52 may.also.be.a.command.or.key)..R
5a800 65 6d 6f 76 65 20 61 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 62 69 6e 64 69 6e 67 20 75 6e 6c 65 emove.a.conflicting.binding.unle
5a820 73 73 20 6f 70 74 69 6f 6e 61 6c 20 4b 45 45 50 2d 4f 54 48 45 52 20 69 73 0a 20 20 6e 6f 6e 2d ss.optional.KEEP-OTHER.is...non-
5a840 6e 69 6c 2e 20 20 57 68 65 6e 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20 61 70 70 65 61 72 73 20 nil...When.the.conflict.appears.
5a860 74 6f 20 62 65 20 61 20 66 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 2c 0a 20 20 6e 6f 6e 2d 6e 69 to.be.a.false-positive,...non-ni
5a880 6c 20 4b 45 45 50 2d 4f 54 48 45 52 20 6d 61 79 20 62 65 20 69 67 6e 6f 72 65 64 2c 20 77 68 69 l.KEEP-OTHER.may.be.ignored,.whi
5a8a0 63 68 20 63 61 6e 20 62 65 20 70 72 65 76 65 6e 74 65 64 0a 20 20 62 79 20 75 73 69 6e 67 20 60 ch.can.be.prevented...by.using.`
5a8c0 61 6c 77 61 79 73 27 2e 0a 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 always'..See.info.node.`(transie
5a8e0 6e 74 29 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 nt)Modifying.Existing.Transients
5a900 27 2e 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 '."...(declare.(indent.defun))..
5a920 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 .(transient--insert-suffix.prefi
5a940 78 20 6c 6f 63 20 73 75 66 66 69 78 20 27 61 70 70 65 6e 64 20 6b 65 65 70 2d 6f 74 68 65 72 29 x.loc.suffix.'append.keep-other)
5a960 29 0a 0a 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 )..;;;###autoload.(defun.transie
5a980 6e 74 2d 72 65 70 6c 61 63 65 2d 73 75 66 66 69 78 20 28 70 72 65 66 69 78 20 6c 6f 63 20 73 75 nt-replace-suffix.(prefix.loc.su
5a9a0 66 66 69 78 29 0a 20 20 22 52 65 70 6c 61 63 65 20 74 68 65 20 73 75 66 66 69 78 20 61 74 20 4c ffix)..."Replace.the.suffix.at.L
5a9c0 4f 43 20 69 6e 20 50 52 45 46 49 58 20 77 69 74 68 20 53 55 46 46 49 58 2e 0a 50 52 45 46 49 58 OC.in.PREFIX.with.SUFFIX..PREFIX
5a9e0 20 69 73 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a .is.a.prefix.command,.a.symbol..
5aa00 53 55 46 46 49 58 20 69 73 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 SUFFIX.is.a.suffix.command.or.a.
5aa20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 28 6f 66 0a 20 20 74 68 65 20 73 61 group.specification.(of...the.sa
5aa40 6d 65 20 66 6f 72 6d 73 20 61 73 20 65 78 70 65 63 74 65 64 20 62 79 20 60 74 72 61 6e 73 69 65 me.forms.as.expected.by.`transie
5aa60 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 27 29 2e 0a 4c 4f 43 20 69 73 20 61 20 63 6f 6d nt-define-prefix')..LOC.is.a.com
5aa80 6d 61 6e 64 2c 20 61 20 6b 65 79 20 76 65 63 74 6f 72 2c 20 61 20 6b 65 79 20 64 65 73 63 72 69 mand,.a.key.vector,.a.key.descri
5aaa0 70 74 69 6f 6e 20 28 61 20 73 74 72 69 6e 67 0a 20 20 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 ption.(a.string...as.returned.by
5aac0 20 60 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 29 2c 20 6f 72 20 61 20 63 6f 6f 72 64 69 .`key-description'),.or.a.coordi
5aae0 6e 61 74 69 6f 6e 20 6c 69 73 74 0a 20 20 28 77 68 6f 73 65 20 6c 61 73 74 20 65 6c 65 6d 65 6e nation.list...(whose.last.elemen
5ab00 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 6b 65 79 29 2e t.may.also.be.a.command.or.key).
5ab20 0a 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 29 4d 6f 64 69 66 .See.info.node.`(transient)Modif
5ab40 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 27 2e 22 0a 20 20 28 64 ying.Existing.Transients'."...(d
5ab60 65 63 6c 61 72 65 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 20 28 74 72 61 6e 73 69 eclare.(indent.defun))...(transi
5ab80 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 20 70 72 65 66 69 78 20 6c 6f 63 20 73 75 ent--insert-suffix.prefix.loc.su
5aba0 66 66 69 78 20 27 72 65 70 6c 61 63 65 29 29 0a 0a 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 0a ffix.'replace))..;;;###autoload.
5abc0 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 6c 69 6e 65 2d 67 72 6f 75 70 20 28 70 (defun.transient-inline-group.(p
5abe0 72 65 66 69 78 20 67 72 6f 75 70 29 0a 20 20 22 49 6e 6c 69 6e 65 20 74 68 65 20 69 6e 63 6c 75 refix.group)..."Inline.the.inclu
5ac00 64 65 64 20 47 52 4f 55 50 20 69 6e 74 6f 20 50 52 45 46 49 58 2e 0a 52 65 70 6c 61 63 65 20 74 ded.GROUP.into.PREFIX..Replace.t
5ac20 68 65 20 73 79 6d 62 6f 6c 20 47 52 4f 55 50 20 77 69 74 68 20 69 74 73 20 65 78 70 61 6e 64 65 he.symbol.GROUP.with.its.expande
5ac40 64 20 6c 61 79 6f 75 74 20 69 6e 20 74 68 65 0a 6c 61 79 6f 75 74 20 6f 66 20 50 52 45 46 49 58 d.layout.in.the.layout.of.PREFIX
5ac60 2e 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 20 ."...(declare.(indent.defun))...
5ac80 28 63 6c 2d 61 73 73 65 72 74 20 28 73 79 6d 62 6f 6c 70 20 67 72 6f 75 70 29 29 0a 20 20 28 70 (cl-assert.(symbolp.group))...(p
5aca0 63 61 73 65 2d 6c 65 74 20 28 28 60 28 2c 73 75 66 66 69 78 20 2c 70 61 72 65 6e 74 29 20 28 74 case-let.((`(,suffix.,parent).(t
5acc0 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 20 70 72 65 66 69 78 20 67 72 ransient--locate-child.prefix.gr
5ace0 6f 75 70 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 73 75 66 66 69 78 0a 20 20 20 20 20 20 28 6c oup))).....(when.suffix.......(l
5ad00 65 74 2a 20 28 28 73 69 62 6c 69 6e 67 73 20 28 61 72 65 66 20 70 61 72 65 6e 74 20 32 29 29 0a et*.((siblings.(aref.parent.2)).
5ad20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 6f 73 20 28 63 6c 2d 70 6f 73 69 74 69 6f 6e 20 67 .............(pos.(cl-position.g
5ad40 72 6f 75 70 20 73 69 62 6c 69 6e 67 73 29 29 29 0a 20 20 20 20 20 20 20 20 28 61 73 65 74 20 70 roup.siblings))).........(aset.p
5ad60 61 72 65 6e 74 20 32 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 63 6f 6e 63 20 28 73 65 arent.2...............(nconc.(se
5ad80 71 2d 74 61 6b 65 20 73 69 62 6c 69 6e 67 73 20 70 6f 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 q-take.siblings.pos)............
5ada0 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 63 68 69 6c 64 72 ..........(transient--get-childr
5adc0 65 6e 20 67 72 6f 75 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 en.group)......................(
5ade0 73 65 71 2d 64 72 6f 70 20 73 69 62 6c 69 6e 67 73 20 28 31 2b 20 70 6f 73 29 29 29 29 29 29 29 seq-drop.siblings.(1+.pos)))))))
5ae00 29 0a 0a 3b 3b 3b 23 23 23 61 75 74 6f 6c 6f 61 64 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 )..;;;###autoload.(defun.transie
5ae20 6e 74 2d 72 65 6d 6f 76 65 2d 73 75 66 66 69 78 20 28 70 72 65 66 69 78 20 6c 6f 63 29 0a 20 20 nt-remove-suffix.(prefix.loc)...
5ae40 22 52 65 6d 6f 76 65 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 70 20 61 74 20 4c "Remove.the.suffix.or.group.at.L
5ae60 4f 43 20 69 6e 20 50 52 45 46 49 58 2e 0a 50 52 45 46 49 58 20 69 73 20 61 20 70 72 65 66 69 78 OC.in.PREFIX..PREFIX.is.a.prefix
5ae80 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 4c 4f 43 20 69 73 20 61 20 63 6f 6d .command,.a.symbol..LOC.is.a.com
5aea0 6d 61 6e 64 2c 20 61 20 6b 65 79 20 76 65 63 74 6f 72 2c 20 61 20 6b 65 79 20 64 65 73 63 72 69 mand,.a.key.vector,.a.key.descri
5aec0 70 74 69 6f 6e 20 28 61 20 73 74 72 69 6e 67 0a 20 20 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 ption.(a.string...as.returned.by
5aee0 20 60 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 29 2c 20 6f 72 20 61 20 63 6f 6f 72 64 69 .`key-description'),.or.a.coordi
5af00 6e 61 74 69 6f 6e 20 6c 69 73 74 0a 20 20 28 77 68 6f 73 65 20 6c 61 73 74 20 65 6c 65 6d 65 6e nation.list...(whose.last.elemen
5af20 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 6b 65 79 29 2e t.may.also.be.a.command.or.key).
5af40 0a 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 29 4d 6f 64 69 66 .See.info.node.`(transient)Modif
5af60 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 27 2e 22 0a 20 20 28 64 ying.Existing.Transients'."...(d
5af80 65 63 6c 61 72 65 20 28 69 6e 64 65 6e 74 20 64 65 66 75 6e 29 29 0a 20 20 28 70 63 61 73 65 2d eclare.(indent.defun))...(pcase-
5afa0 6c 65 74 20 28 28 60 28 2c 73 75 66 66 69 78 20 2c 67 72 6f 75 70 29 20 28 74 72 61 6e 73 69 65 let.((`(,suffix.,group).(transie
5afc0 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 20 70 72 65 66 69 78 20 6c 6f 63 29 29 29 0a 20 nt--locate-child.prefix.loc)))..
5afe0 20 20 20 28 77 68 65 6e 20 73 75 66 66 69 78 0a 20 20 20 20 20 20 28 61 73 65 74 20 67 72 6f 75 ...(when.suffix.......(aset.grou
5b000 70 20 32 20 28 64 65 6c 71 20 73 75 66 66 69 78 20 28 61 72 65 66 20 67 72 6f 75 70 20 32 29 29 p.2.(delq.suffix.(aref.group.2))
5b020 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 70 75 ))))..(defun.transient-suffix-pu
5b040 74 20 28 70 72 65 66 69 78 20 6c 6f 63 20 70 72 6f 70 20 76 61 6c 75 65 29 0a 20 20 22 45 64 69 t.(prefix.loc.prop.value)..."Edi
5b060 74 20 74 68 65 20 73 75 66 66 69 78 20 61 74 20 4c 4f 43 20 69 6e 20 50 52 45 46 49 58 2c 20 73 t.the.suffix.at.LOC.in.PREFIX,.s
5b080 65 74 74 69 6e 67 20 50 52 4f 50 20 74 6f 20 56 41 4c 55 45 2e 0a 50 52 45 46 49 58 20 69 73 20 etting.PROP.to.VALUE..PREFIX.is.
5b0a0 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 53 55 46 46 a.prefix.command,.a.symbol..SUFF
5b0c0 49 58 20 69 73 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 67 72 6f 75 IX.is.a.suffix.command.or.a.grou
5b0e0 70 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 28 6f 66 0a 20 20 74 68 65 20 73 61 6d 65 20 66 p.specification.(of...the.same.f
5b100 6f 72 6d 73 20 61 73 20 65 78 70 65 63 74 65 64 20 62 79 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 orms.as.expected.by.`transient-d
5b120 65 66 69 6e 65 2d 70 72 65 66 69 78 27 29 2e 0a 4c 4f 43 20 69 73 20 61 20 63 6f 6d 6d 61 6e 64 efine-prefix')..LOC.is.a.command
5b140 2c 20 61 20 6b 65 79 20 76 65 63 74 6f 72 2c 20 61 20 6b 65 79 20 64 65 73 63 72 69 70 74 69 6f ,.a.key.vector,.a.key.descriptio
5b160 6e 20 28 61 20 73 74 72 69 6e 67 0a 20 20 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 60 6b 65 n.(a.string...as.returned.by.`ke
5b180 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 29 2c 20 6f 72 20 61 20 63 6f 6f 72 64 69 6e 61 74 69 y-description'),.or.a.coordinati
5b1a0 6f 6e 20 6c 69 73 74 0a 20 20 28 77 68 6f 73 65 20 6c 61 73 74 20 65 6c 65 6d 65 6e 74 20 6d 61 on.list...(whose.last.element.ma
5b1c0 79 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 6b 65 79 29 2e 0a 53 65 65 y.also.be.a.command.or.key)..See
5b1e0 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 29 4d 6f 64 69 66 79 69 6e 67 .info.node.`(transient)Modifying
5b200 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 27 2e 22 0a 20 20 28 6c 65 74 20 28 .Existing.Transients'."...(let.(
5b220 28 63 68 69 6c 64 20 28 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 73 75 66 66 69 78 20 70 72 65 (child.(transient-get-suffix.pre
5b240 66 69 78 20 6c 6f 63 29 29 29 0a 20 20 20 20 28 69 66 20 28 76 65 63 74 6f 72 70 20 63 68 69 6c fix.loc))).....(if.(vectorp.chil
5b260 64 29 0a 20 20 20 20 20 20 20 20 28 61 73 65 74 20 63 68 69 6c 64 20 31 20 28 70 6c 69 73 74 2d d).........(aset.child.1.(plist-
5b280 70 75 74 20 28 61 72 65 66 20 63 68 69 6c 64 20 31 29 20 70 72 6f 70 20 76 61 6c 75 65 29 29 0a put.(aref.child.1).prop.value)).
5b2a0 20 20 20 20 20 20 28 73 65 74 63 64 72 20 63 68 69 6c 64 20 28 70 6c 69 73 74 2d 70 75 74 20 28 ......(setcdr.child.(plist-put.(
5b2c0 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 63 68 69 6c 64 29 20 70 transient--suffix-props.child).p
5b2e0 72 6f 70 20 76 61 6c 75 65 29 29 29 29 29 0a 0a 28 64 65 66 61 6c 69 61 73 20 27 74 72 61 6e 73 rop.value)))))..(defalias.'trans
5b300 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 23 27 63 64 72 29 0a 0a 28 64 65 66 75 ient--suffix-props.#'cdr)..(defu
5b320 6e 20 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 73 75 66 66 69 78 20 28 70 72 65 66 69 78 20 6c n.transient-get-suffix.(prefix.l
5b340 6f 63 29 0a 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 73 75 66 66 69 78 20 6f 72 20 67 72 6f 75 oc)..."Return.the.suffix.or.grou
5b360 70 20 61 74 20 4c 4f 43 20 69 6e 20 50 52 45 46 49 58 2e 0a 50 52 45 46 49 58 20 69 73 20 61 20 p.at.LOC.in.PREFIX..PREFIX.is.a.
5b380 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 73 79 6d 62 6f 6c 2e 0a 4c 4f 43 20 69 73 prefix.command,.a.symbol..LOC.is
5b3a0 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 61 20 6b 65 79 20 76 65 63 74 6f 72 2c 20 61 20 6b 65 79 20 .a.command,.a.key.vector,.a.key.
5b3c0 64 65 73 63 72 69 70 74 69 6f 6e 20 28 61 20 73 74 72 69 6e 67 0a 20 20 61 73 20 72 65 74 75 72 description.(a.string...as.retur
5b3e0 6e 65 64 20 62 79 20 60 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 29 2c 20 6f 72 20 61 20 ned.by.`key-description'),.or.a.
5b400 63 6f 6f 72 64 69 6e 61 74 69 6f 6e 20 6c 69 73 74 0a 20 20 28 77 68 6f 73 65 20 6c 61 73 74 20 coordination.list...(whose.last.
5b420 65 6c 65 6d 65 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 20 63 6f 6d 6d 61 6e 64 20 6f 72 element.may.also.be.a.command.or
5b440 20 6b 65 79 29 2e 0a 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 .key)..See.info.node.`(transient
5b460 29 4d 6f 64 69 66 79 69 6e 67 20 45 78 69 73 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 73 27 2e )Modifying.Existing.Transients'.
5b480 22 0a 20 20 28 6f 72 20 28 63 61 72 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d "...(or.(car.(transient--locate-
5b4a0 63 68 69 6c 64 20 70 72 65 66 69 78 20 6c 6f 63 29 29 0a 20 20 20 20 20 20 28 65 72 72 6f 72 20 child.prefix.loc)).......(error.
5b4c0 22 25 73 20 6e 6f 74 20 66 6f 75 6e 64 20 69 6e 20 25 73 22 20 6c 6f 63 20 70 72 65 66 69 78 29 "%s.not.found.in.%s".loc.prefix)
5b4e0 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 ))..(defun.transient--locate-chi
5b500 6c 64 20 28 67 72 6f 75 70 20 6c 6f 63 29 0a 20 20 28 77 68 65 6e 20 28 73 79 6d 62 6f 6c 70 20 ld.(group.loc)...(when.(symbolp.
5b520 67 72 6f 75 70 29 0a 20 20 20 20 28 73 65 74 71 20 67 72 6f 75 70 20 28 74 72 61 6e 73 69 65 6e group).....(setq.group.(transien
5b540 74 2d 2d 67 65 74 2d 6c 61 79 6f 75 74 20 67 72 6f 75 70 29 29 29 0a 20 20 28 77 68 65 6e 20 28 t--get-layout.group)))...(when.(
5b560 76 65 63 74 6f 72 70 20 6c 6f 63 29 0a 20 20 20 20 28 73 65 74 71 20 6c 6f 63 20 28 61 70 70 65 vectorp.loc).....(setq.loc.(appe
5b580 6e 64 20 6c 6f 63 20 6e 69 6c 29 29 29 0a 20 20 28 69 66 20 28 6c 69 73 74 70 20 6c 6f 63 29 0a nd.loc.nil)))...(if.(listp.loc).
5b5a0 20 20 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 6d 61 74 63 68 20 28 74 72 61 6e 73 69 65 ......(and-let*.((match.(transie
5b5c0 6e 74 2d 2d 6e 74 68 20 28 70 6f 70 20 6c 6f 63 29 20 28 61 72 65 66 20 67 72 6f 75 70 20 32 29 nt--nth.(pop.loc).(aref.group.2)
5b5e0 29 29 29 0a 20 20 20 20 20 20 20 20 28 69 66 20 6c 6f 63 0a 20 20 20 20 20 20 20 20 20 20 20 20 ))).........(if.loc.............
5b600 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 0a 20 20 20 20 20 20 20 (transient--locate-child........
5b620 20 20 20 20 20 20 6d 61 74 63 68 20 28 63 6f 6e 64 20 28 28 6f 72 20 28 73 74 72 69 6e 67 70 20 ......match.(cond.((or.(stringp.
5b640 28 63 61 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 20 (car.loc))......................
5b660 20 20 20 20 20 20 20 20 20 28 73 79 6d 62 6f 6c 70 20 28 63 61 72 20 6c 6f 63 29 29 29 0a 20 20 .........(symbolp.(car.loc)))...
5b680 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 63 61 72 20 6c 6f 63 ........................(car.loc
5b6a0 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 28 28 73 79 ))..........................((sy
5b6c0 6d 62 6f 6c 70 20 6d 61 74 63 68 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 mbolp.match)....................
5b6e0 20 20 20 20 20 20 20 28 76 63 6f 6e 63 61 74 20 28 63 6f 6e 73 20 30 20 6c 6f 63 29 29 29 0a 20 .......(vconcat.(cons.0.loc)))..
5b700 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 28 76 63 6f 6e 63 61 ........................((vconca
5b720 74 20 6c 6f 63 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 6d 61 74 63 68 20 t.loc))))...........(list.match.
5b740 67 72 6f 75 70 29 29 29 0a 20 20 20 20 28 73 65 71 2d 73 6f 6d 65 20 28 6c 61 6d 62 64 61 20 28 group))).....(seq-some.(lambda.(
5b760 63 68 69 6c 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e child).................(transien
5b780 74 2d 2d 6d 61 74 63 68 2d 63 68 69 6c 64 20 67 72 6f 75 70 20 6c 6f 63 20 63 68 69 6c 64 29 29 t--match-child.group.loc.child))
5b7a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 72 65 66 20 67 72 6f 75 70 20 32 29 29 29 29 ...............(aref.group.2))))
5b7c0 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 74 63 68 2d 63 68 69 6c 64 20 ..(defun.transient--match-child.
5b7e0 28 67 72 6f 75 70 20 6c 6f 63 20 63 68 69 6c 64 29 0a 20 20 28 63 6c 2d 65 74 79 70 65 63 61 73 (group.loc.child)...(cl-etypecas
5b800 65 20 63 68 69 6c 64 0a 20 20 20 20 28 73 74 72 69 6e 67 20 6e 69 6c 29 0a 20 20 20 20 28 73 79 e.child.....(string.nil).....(sy
5b820 6d 62 6f 6c 20 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 6c 6f 63 29 0a 20 20 20 20 20 20 20 20 20 mbol.(if.(symbolp.loc)..........
5b840 20 20 20 20 20 20 20 28 61 6e 64 20 28 65 71 20 63 68 69 6c 64 20 6c 6f 63 29 0a 20 20 20 20 20 .......(and.(eq.child.loc)......
5b860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 63 68 69 6c 64 20 67 72 6f 75 ................(list.child.grou
5b880 70 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 69 6e p))...............(and-let*.((in
5b8a0 63 6c 75 64 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 6c 61 79 6f 75 74 20 63 68 69 clude.(transient--get-layout.chi
5b8c0 6c 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 ld))).................(transient
5b8e0 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 20 69 6e 63 6c 75 64 65 20 6c 6f 63 29 29 29 29 0a 20 --locate-child.include.loc))))..
5b900 20 20 20 28 76 65 63 74 6f 72 20 28 73 65 71 2d 73 6f 6d 65 20 28 6c 61 6d 62 64 61 20 28 73 75 ...(vector.(seq-some.(lambda.(su
5b920 62 67 72 6f 75 70 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 bgroup).........................
5b940 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 63 61 74 65 2d 63 68 69 6c 64 20 73 75 62 67 72 6f 75 (transient--locate-child.subgrou
5b960 70 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 20 20 28 61 p.loc)).......................(a
5b980 72 65 66 20 67 72 6f 75 70 20 32 29 29 29 0a 20 20 20 20 28 6c 69 73 74 20 20 20 28 61 6e 64 20 ref.group.2))).....(list...(and.
5b9a0 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 6c 6f 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (if.(symbolp.loc)...............
5b9c0 20 20 20 20 20 20 20 28 65 71 20 28 70 6c 69 73 74 2d 67 65 74 20 28 74 72 61 6e 73 69 65 6e 74 .......(eq.(plist-get.(transient
5b9e0 2d 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 63 68 69 6c 64 29 20 3a 63 6f 6d 6d 61 6e 64 29 0a --suffix-props.child).:command).
5ba00 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 6c 6f 63 29 0a 20 20 .........................loc)...
5ba20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 75 61 6c 20 28 6b 62 64 20 28 74 72 .................(equal.(kbd.(tr
5ba40 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6b 65 79 20 63 68 69 6c 64 29 29 0a 20 20 20 20 ansient--suffix-key.child)).....
5ba60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6b 62 64 20 6c 6f 63 29 29 ......................(kbd.loc))
5ba80 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 63 68 69 6c 64 20 67 )..................(list.child.g
5baa0 72 6f 75 70 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6e 74 68 roup)))))..(defun.transient--nth
5bac0 20 28 6e 20 6c 69 73 74 29 0a 20 20 28 6e 74 68 20 28 69 66 20 28 3c 20 6e 20 30 29 20 28 2d 20 .(n.list)...(nth.(if.(<.n.0).(-.
5bae0 28 6c 65 6e 67 74 68 20 6c 69 73 74 29 20 28 61 62 73 20 6e 29 29 20 6e 29 20 6c 69 73 74 29 29 (length.list).(abs.n)).n).list))
5bb00 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 6b 65 79 20 28 ..(defun.transient--suffix-key.(
5bb20 73 70 65 63 29 0a 20 20 28 6c 65 74 20 28 28 70 72 6f 70 73 20 28 74 72 61 6e 73 69 65 6e 74 2d spec)...(let.((props.(transient-
5bb40 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 73 70 65 63 29 29 29 0a 20 20 20 20 28 6f 72 20 28 70 -suffix-props.spec))).....(or.(p
5bb60 6c 69 73 74 2d 67 65 74 20 70 72 6f 70 73 20 3a 6b 65 79 29 0a 20 20 20 20 20 20 20 20 28 74 72 list-get.props.:key).........(tr
5bb80 61 6e 73 69 65 6e 74 2d 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 0a 20 20 20 20 20 20 20 20 20 28 70 ansient--command-key..........(p
5bba0 6c 69 73 74 2d 67 65 74 20 70 72 6f 70 73 20 3a 63 6f 6d 6d 61 6e 64 29 29 29 29 29 0a 0a 28 64 list-get.props.:command)))))..(d
5bbc0 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 20 28 63 6d 64 efun.transient--command-key.(cmd
5bbe0 29 0a 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d )...(and-let*.((obj.(transient--
5bc00 73 75 66 66 69 78 2d 70 72 6f 74 6f 74 79 70 65 20 63 6d 64 29 29 29 0a 20 20 20 20 28 63 6f 6e suffix-prototype.cmd))).....(con
5bc20 64 20 28 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 6b 65 79 29 0a 20 20 20 20 20 20 d.((slot-boundp.obj.'key).......
5bc40 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 .....(oref.obj.key))...........(
5bc60 28 73 6c 6f 74 2d 65 78 69 73 74 73 2d 70 20 6f 62 6a 20 27 73 68 6f 72 74 61 72 67 29 0a 20 20 (slot-exists-p.obj.'shortarg)...
5bc80 20 20 20 20 20 20 20 20 20 28 69 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 73 .........(if.(slot-boundp.obj.'s
5bca0 68 6f 72 74 61 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 hortarg)................(oref.ob
5bcc0 6a 20 73 68 6f 72 74 61 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 j.shortarg)..............(transi
5bce0 65 6e 74 2d 2d 64 65 72 69 76 65 2d 73 68 6f 72 74 61 72 67 20 28 6f 72 65 66 20 6f 62 6a 20 61 ent--derive-shortarg.(oref.obj.a
5bd00 72 67 75 6d 65 6e 74 29 29 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 rgument)))))))..(defun.transient
5bd20 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d 6c 65 76 65 6c 20 28 63 6f 6d 6d 61 6e 64 20 6c 65 76 65 -set-default-level.(command.leve
5bd40 6c 29 0a 20 20 22 53 65 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 20 6f 66 20 73 l)..."Set.the.default.level.of.s
5bd60 75 66 66 69 78 20 43 4f 4d 4d 41 4e 44 20 74 6f 20 4c 45 56 45 4c 2e 0a 0a 54 68 65 20 64 65 66 uffix.COMMAND.to.LEVEL...The.def
5bd80 61 75 6c 74 20 6c 65 76 65 6c 20 69 73 20 73 68 61 64 6f 77 65 64 20 69 66 20 74 68 65 20 62 69 ault.level.is.shadowed.if.the.bi
5bda0 6e 64 69 6e 67 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 20 69 6e 20 61 0a 70 72 65 66 69 78 20 nding.of.the.suffix.in.a.prefix.
5bdc0 6d 65 6e 75 20 73 70 65 63 69 66 69 65 73 20 61 20 6c 65 76 65 6c 2c 20 61 6e 64 20 61 6c 73 6f menu.specifies.a.level,.and.also
5bde0 20 69 66 20 74 68 65 20 75 73 65 72 20 63 68 61 6e 67 65 73 20 74 68 65 0a 6c 65 76 65 6c 20 6f .if.the.user.changes.the.level.o
5be00 66 20 73 75 63 68 20 61 20 62 69 6e 64 69 6e 67 2e 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 6c f.such.a.binding...The.default.l
5be20 65 76 65 6c 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 73 65 74 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 evel.can.only.be.set.for.command
5be40 73 20 74 68 61 74 20 77 65 72 65 20 64 65 66 69 6e 65 64 0a 75 73 69 6e 67 20 60 74 72 61 6e 73 s.that.were.defined.using.`trans
5be60 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 27 2c 20 60 74 72 61 6e 73 69 65 6e 74 2d ient-define-suffix',.`transient-
5be80 64 65 66 69 6e 65 2d 69 6e 66 69 78 27 20 6f 72 0a 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 define-infix'.or.`transient-defi
5bea0 6e 65 2d 61 72 67 75 6d 65 6e 74 27 2e 22 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 70 72 6f 74 6f ne-argument'."...(if-let.((proto
5bec0 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 74 6f 74 79 70 65 20 63 6f .(transient--suffix-prototype.co
5bee0 6d 6d 61 6e 64 29 29 29 0a 20 20 20 20 20 20 28 6f 73 65 74 20 70 72 6f 74 6f 20 6c 65 76 65 6c mmand))).......(oset.proto.level
5bf00 20 6c 65 76 65 6c 29 0a 20 20 20 20 28 75 73 65 72 2d 65 72 72 6f 72 20 22 43 61 6e 6e 6f 74 20 .level).....(user-error."Cannot.
5bf20 73 65 74 20 6c 65 76 65 6c 20 66 6f 72 20 60 25 73 27 3b 20 6e 6f 20 70 72 6f 74 6f 74 79 70 65 set.level.for.`%s';.no.prototype
5bf40 20 6f 62 6a 65 63 74 20 65 78 69 73 74 73 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .object.exists".................
5bf60 63 6f 6d 6d 61 6e 64 29 29 29 0a 0a 3b 3b 3b 20 56 61 72 69 61 62 6c 65 73 0a 0a 28 64 65 66 76 command)))..;;;.Variables..(defv
5bf80 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 20 6e 69 6c 0a ar.transient-current-prefix.nil.
5bfa0 20 20 22 54 68 65 20 74 72 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 .."The.transient.from.which.this
5bfc0 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e 0a 54 68 69 .suffix.command.was.invoked..Thi
5bfe0 73 20 69 73 20 61 6e 20 6f 62 6a 65 63 74 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 61 74 s.is.an.object.representing.that
5c000 20 74 72 61 6e 73 69 65 6e 74 2c 20 75 73 65 0a 60 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 .transient,.use.`transient-curre
5c020 6e 74 2d 63 6f 6d 6d 61 6e 64 27 20 74 6f 20 67 65 74 20 74 68 65 20 72 65 73 70 65 63 74 69 76 nt-command'.to.get.the.respectiv
5c040 65 20 63 6f 6d 6d 61 6e 64 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d e.command.")..(defvar.transient-
5c060 63 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 20 6e 69 6c 0a 20 20 22 54 68 65 20 74 72 61 6e 73 current-command.nil..."The.trans
5c080 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 20 73 75 66 66 69 78 20 63 6f 6d 6d ient.from.which.this.suffix.comm
5c0a0 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e 0a 54 68 69 73 20 69 73 20 61 20 73 79 6d 62 6f and.was.invoked..This.is.a.symbo
5c0c0 6c 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 61 74 20 74 72 61 6e 73 69 65 6e 74 2c 20 75 l.representing.that.transient,.u
5c0e0 73 65 0a 60 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 27 20 74 6f se.`transient-current-prefix'.to
5c100 20 67 65 74 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 6f 62 6a 65 63 74 2e 22 29 0a 0a 28 .get.the.respective.object.")..(
5c120 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 defvar.transient-current-suffixe
5c140 73 20 6e 69 6c 0a 20 20 22 54 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 74 68 65 20 74 72 61 s.nil..."The.suffixes.of.the.tra
5c160 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 69 73 20 73 75 66 66 69 78 20 63 6f nsient.from.which.this.suffix.co
5c180 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e 0a 54 68 69 73 20 69 73 20 61 20 6c 69 73 mmand.was.invoked..This.is.a.lis
5c1a0 74 20 6f 66 20 6f 62 6a 65 63 74 73 2e 20 20 55 73 75 61 6c 6c 79 20 69 74 20 69 73 20 73 75 66 t.of.objects...Usually.it.is.suf
5c1c0 66 69 63 69 65 6e 74 20 74 6f 20 69 6e 73 74 65 61 64 0a 75 73 65 20 74 68 65 20 66 75 6e 63 74 ficient.to.instead.use.the.funct
5c1e0 69 6f 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 27 2c 20 77 68 69 63 68 20 72 65 74 75 ion.`transient-args',.which.retu
5c200 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 0a 76 61 6c 75 65 73 2e 20 20 49 6e 20 63 6f 6d 70 6c 65 rns.a.list.of.values...In.comple
5c220 78 20 63 61 73 65 73 20 69 74 20 6d 69 67 68 74 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f x.cases.it.might.be.necessary.to
5c240 20 75 73 65 20 74 68 69 73 0a 76 61 72 69 61 62 6c 65 20 69 6e 73 74 65 61 64 2e 22 29 0a 0a 28 .use.this.variable.instead.")..(
5c260 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 65 78 69 74 2d 68 6f 6f 6b 20 6e 69 6c 0a 20 defvar.transient-exit-hook.nil..
5c280 20 22 48 6f 6f 6b 20 72 75 6e 20 61 66 74 65 72 20 65 78 69 74 69 6e 67 20 61 20 74 72 61 6e 73 ."Hook.run.after.exiting.a.trans
5c2a0 69 65 6e 74 20 6d 65 6e 75 2e 0a 55 6e 6c 69 6b 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 6f 73 ient.menu..Unlike.`transient-pos
5c2c0 74 2d 65 78 69 74 2d 68 6f 6f 6b 27 2c 20 74 68 69 73 20 72 75 6e 73 20 65 76 65 6e 20 69 66 20 t-exit-hook',.this.runs.even.if.
5c2e0 61 6e 6f 74 68 65 72 20 74 72 61 6e 73 69 65 6e 74 0a 6d 65 6e 75 20 62 65 63 6f 6d 65 73 20 61 another.transient.menu.becomes.a
5c300 63 74 69 76 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 22 29 0a 0a 28 64 65 66 ctive.at.the.same.time..")..(def
5c320 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 70 6f 73 74 2d 65 78 69 74 2d 68 6f 6f 6b 20 6e 69 6c var.transient-post-exit-hook.nil
5c340 0a 20 20 22 48 6f 6f 6b 20 72 75 6e 20 61 66 74 65 72 20 65 78 69 74 69 6e 67 20 61 6c 6c 20 74 ..."Hook.run.after.exiting.all.t
5c360 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 73 2e 0a 55 6e 6c 69 6b 65 20 60 74 72 61 6e 73 69 65 6e ransient.menus..Unlike.`transien
5c380 74 2d 65 78 69 74 2d 68 6f 6f 6b 27 2c 20 74 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 72 75 6e 20 t-exit-hook',.this.does.not.run.
5c3a0 69 66 20 61 6e 6f 74 68 65 72 20 74 72 61 6e 73 69 65 6e 74 0a 6d 65 6e 75 20 62 65 63 6f 6d 65 if.another.transient.menu.become
5c3c0 73 20 61 63 74 69 76 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 22 29 0a 0a 28 64 s.active.at.the.same.time.")..(d
5c3e0 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 62 75 66 66 65 72 2d 68 6f 6f efvar.transient-setup-buffer-hoo
5c400 6b 20 6e 69 6c 0a 20 20 22 48 6f 6f 6b 20 72 75 6e 20 77 68 65 6e 20 73 65 74 74 69 6e 67 20 75 k.nil..."Hook.run.when.setting.u
5c420 70 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 0a 54 68 61 74 20 62 75 66 p.the.transient.buffer..That.buf
5c440 66 65 72 20 69 73 20 63 75 72 72 65 6e 74 20 61 6e 64 20 65 6d 70 74 79 20 77 68 65 6e 20 74 68 fer.is.current.and.empty.when.th
5c460 69 73 20 68 6f 6f 6b 20 72 75 6e 73 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 is.hook.runs.")..(defvar.transie
5c480 6e 74 2d 2d 70 72 65 66 69 78 20 6e 69 6c 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e nt--prefix.nil).(defvar.transien
5c4a0 74 2d 2d 6c 61 79 6f 75 74 20 6e 69 6c 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 t--layout.nil).(defvar.transient
5c4c0 2d 2d 73 75 66 66 69 78 65 73 20 6e 69 6c 29 0a 0a 28 64 65 66 63 6f 6e 73 74 20 74 72 61 6e 73 --suffixes.nil)..(defconst.trans
5c4e0 69 65 6e 74 2d 2d 73 74 61 79 20 74 20 20 20 22 44 6f 20 6e 6f 74 20 65 78 69 74 20 74 68 65 20 ient--stay.t..."Do.not.exit.the.
5c500 74 72 61 6e 73 69 65 6e 74 2e 22 29 0a 28 64 65 66 63 6f 6e 73 74 20 74 72 61 6e 73 69 65 6e 74 transient.").(defconst.transient
5c520 2d 2d 65 78 69 74 20 6e 69 6c 20 22 44 6f 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e --exit.nil."Do.exit.the.transien
5c540 74 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 6e t.")..(defvar.transient--exitp.n
5c560 69 6c 20 22 57 68 65 74 68 65 72 20 74 6f 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e il."Whether.to.exit.the.transien
5c580 74 2e 22 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 20 6e 69 t.").(defvar.transient--showp.ni
5c5a0 6c 20 22 57 68 65 74 68 65 72 20 74 6f 20 73 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 l."Whether.to.show.the.transient
5c5c0 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 22 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e .menu.buffer.").(defvar.transien
5c5e0 74 2d 2d 68 65 6c 70 70 20 6e 69 6c 20 22 57 68 65 74 68 65 72 20 68 65 6c 70 2d 6d 6f 64 65 20 t--helpp.nil."Whether.help-mode.
5c600 69 73 20 61 63 74 69 76 65 2e 22 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d is.active.").(defvar.transient--
5c620 64 6f 63 73 70 20 6e 69 6c 20 22 57 68 65 74 68 65 72 20 64 6f 63 73 74 72 69 6e 67 2d 6d 6f 64 docsp.nil."Whether.docstring-mod
5c640 65 20 69 73 20 61 63 74 69 76 65 2e 22 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 e.is.active.").(defvar.transient
5c660 2d 2d 65 64 69 74 70 20 6e 69 6c 20 22 57 68 65 74 68 65 72 20 65 64 69 74 2d 6d 6f 64 65 20 69 --editp.nil."Whether.edit-mode.i
5c680 73 20 61 63 74 69 76 65 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d s.active.")..(defvar.transient--
5c6a0 72 65 66 72 65 73 68 70 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 72 65 66 72 65 refreshp.nil..."Whether.to.refre
5c6c0 73 68 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d 70 6c 65 74 65 6c 79 2e 22 29 0a 0a sh.the.transient.completely.")..
5c6e0 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 20 (defvar.transient--all-levels-p.
5c700 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 65 6d 70 6f 72 61 72 79 20 64 69 73 70 6c 61 79 nil..."Whether.temporary.display
5c720 20 6f 66 20 73 75 66 66 69 78 65 73 20 6f 6e 20 61 6c 6c 20 6c 65 76 65 6c 73 20 69 73 20 61 63 .of.suffixes.on.all.levels.is.ac
5c740 74 69 76 65 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 tive.")..(defvar.transient--time
5c760 72 20 6e 69 6c 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b r.nil)..(defvar.transient--stack
5c780 20 6e 69 6c 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 69 6e 69 62 75 .nil)..(defvar.transient--minibu
5c7a0 66 66 65 72 2d 64 65 70 74 68 20 30 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 ffer-depth.0)..(defvar.transient
5c7c0 2d 2d 62 75 66 66 65 72 2d 6e 61 6d 65 20 22 20 2a 74 72 61 6e 73 69 65 6e 74 2a 22 0a 20 20 22 --buffer-name.".*transient*"..."
5c7e0 4e 61 6d 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 22 29 0a Name.of.the.transient.buffer.").
5c800 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 20 6e 69 6c 0a 20 .(defvar.transient--buffer.nil..
5c820 20 22 54 68 65 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 22 29 0a 0a ."The.transient.menu.buffer.")..
5c840 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 20 6e 69 6c 0a 20 20 (defvar.transient--window.nil...
5c860 22 54 68 65 20 77 69 6e 64 6f 77 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 74 72 61 6e "The.window.used.to.display.tran
5c880 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 sient's.menu.buffer.")..(defvar.
5c8a0 74 72 61 6e 73 69 65 6e 74 2d 2d 6f 72 69 67 69 6e 61 6c 2d 77 69 6e 64 6f 77 20 6e 69 6c 0a 20 transient--original-window.nil..
5c8c0 20 22 54 68 65 20 77 69 6e 64 6f 77 20 74 68 61 74 20 77 61 73 20 73 65 6c 65 63 74 65 64 20 62 ."The.window.that.was.selected.b
5c8e0 65 66 6f 72 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 61 73 20 69 6e 76 6f 6b 65 64 2e efore.the.transient.was.invoked.
5c900 0a 55 73 75 61 6c 6c 79 20 69 74 20 72 65 6d 61 69 6e 73 20 73 65 6c 65 63 74 65 64 20 77 68 69 .Usually.it.remains.selected.whi
5c920 6c 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 2e 22 29 0a 0a 28 le.the.transient.is.active.")..(
5c940 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6f 72 69 67 69 6e 61 6c 2d 62 75 66 66 65 defvar.transient--original-buffe
5c960 72 20 6e 69 6c 0a 20 20 22 54 68 65 20 62 75 66 66 65 72 20 74 68 61 74 20 77 61 73 20 63 75 72 r.nil..."The.buffer.that.was.cur
5c980 72 65 6e 74 20 62 65 66 6f 72 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 61 73 20 69 6e rent.before.the.transient.was.in
5c9a0 76 6f 6b 65 64 2e 0a 55 73 75 61 6c 6c 79 20 69 74 20 72 65 6d 61 69 6e 73 20 63 75 72 72 65 6e voked..Usually.it.remains.curren
5c9c0 74 20 77 68 69 6c 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 61 63 74 69 76 65 2e t.while.the.transient.is.active.
5c9e0 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 74 6f 72 65 2d 77 ")..(defvar.transient--restore-w
5ca00 69 6e 63 6f 6e 66 20 6e 69 6c 0a 20 20 22 57 69 6e 64 6f 77 20 63 6f 6e 66 69 67 75 72 61 74 69 inconf.nil..."Window.configurati
5ca20 6f 6e 20 74 6f 20 72 65 73 74 6f 72 65 20 61 66 74 65 72 20 65 78 69 74 69 6e 67 20 68 65 6c 70 on.to.restore.after.exiting.help
5ca40 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 61 64 6f 77 65 64 .")..(defvar.transient--shadowed
5ca60 2d 62 75 66 66 65 72 20 6e 69 6c 0a 20 20 22 54 68 65 20 62 75 66 66 65 72 20 74 68 61 74 20 69 -buffer.nil..."The.buffer.that.i
5ca80 73 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 61 64 6f 77 65 64 20 62 79 20 74 68 65 20 74 72 s.temporarily.shadowed.by.the.tr
5caa0 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 0a 54 68 69 73 20 69 73 20 62 6f 75 6e 64 20 77 68 ansient.buffer..This.is.bound.wh
5cac0 69 6c 65 20 74 68 65 20 73 75 66 66 69 78 20 70 72 65 64 69 63 61 74 65 20 69 73 20 62 65 69 6e ile.the.suffix.predicate.is.bein
5cae0 67 20 65 76 61 6c 75 61 74 65 64 20 61 6e 64 20 77 68 69 6c 65 0a 64 72 61 77 69 6e 67 20 69 6e g.evaluated.and.while.drawing.in
5cb00 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 22 29 0a 0a 28 64 65 66 76 61 .the.transient.buffer.")..(defva
5cb20 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 73 75 66 66 69 78 20 6e 69 6c 0a r.transient--pending-suffix.nil.
5cb40 20 20 22 54 68 65 20 73 75 66 66 69 78 20 74 68 61 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 .."The.suffix.that.is.currently.
5cb60 62 65 69 6e 67 20 70 72 6f 63 65 73 73 65 64 2e 0a 54 68 69 73 20 69 73 20 62 6f 75 6e 64 20 77 being.processed..This.is.bound.w
5cb80 68 69 6c 65 20 74 68 65 20 73 75 66 66 69 78 20 70 72 65 64 69 63 61 74 65 20 69 73 20 62 65 69 hile.the.suffix.predicate.is.bei
5cba0 6e 67 20 65 76 61 6c 75 61 74 65 64 2c 0a 61 6e 64 20 77 68 69 6c 65 20 66 75 6e 63 74 69 6f 6e ng.evaluated,.and.while.function
5cbc0 73 20 74 68 61 74 20 72 65 74 75 72 6e 20 66 61 63 65 73 20 61 72 65 20 62 65 69 6e 67 20 65 76 s.that.return.faces.are.being.ev
5cbe0 61 6c 75 61 74 65 64 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 63 aluated.")..(defvar.transient--c
5cc00 75 72 72 65 6e 74 2d 73 75 66 66 69 78 20 6e 69 6c 0a 20 20 22 54 68 65 20 73 75 66 66 69 78 20 urrent-suffix.nil..."The.suffix.
5cc20 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 69 6e 76 6f 6b 65 64 20 75 73 69 6e 67 20 61 20 currently.being.invoked.using.a.
5cc40 6d 6f 75 73 65 20 65 76 65 6e 74 2e 0a 44 6f 20 6e 6f 74 20 75 73 65 20 74 68 69 73 3b 20 69 6e mouse.event..Do.not.use.this;.in
5cc60 73 74 65 61 64 20 75 73 65 20 66 75 6e 63 74 69 6f 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 75 stead.use.function.`transient-su
5cc80 66 66 69 78 2d 6f 62 6a 65 63 74 27 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 ffix-object'.")..(defvar.transie
5cca0 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 67 72 6f 75 70 20 6e 69 6c 0a 20 20 22 54 68 65 20 67 72 6f nt--pending-group.nil..."The.gro
5ccc0 75 70 20 74 68 61 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 70 72 6f 63 65 up.that.is.currently.being.proce
5cce0 73 73 65 64 2e 0a 54 68 69 73 20 69 73 20 62 6f 75 6e 64 20 77 68 69 6c 65 20 74 68 65 20 73 75 ssed..This.is.bound.while.the.su
5cd00 66 66 69 78 65 73 20 61 72 65 20 64 72 61 77 6e 20 69 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e ffixes.are.drawn.in.the.transien
5cd20 74 20 62 75 66 66 65 72 2e 22 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d t.buffer.")..(defvar.transient--
5cd40 64 65 62 75 67 20 6e 69 6c 0a 20 20 22 57 68 65 74 68 65 72 20 74 6f 20 70 75 74 20 64 65 62 75 debug.nil..."Whether.to.put.debu
5cd60 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 74 6f 20 2a 4d 65 73 73 61 67 65 73 2a 2e 22 29 g.information.into.*Messages*.")
5cd80 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 20 6e 69 6c ..(defvar.transient--history.nil
5cda0 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 63 72 6f 6c 6c 2d 63 6f 6d )..(defvar.transient--scroll-com
5cdc0 6d 61 6e 64 73 0a 20 20 27 28 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 0a 20 20 mands...'(transient-scroll-up...
5cde0 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 64 6f 77 6e 0a 20 20 20 20 6d 77 68 65 ..transient-scroll-down.....mwhe
5ce00 65 6c 2d 73 63 72 6f 6c 6c 0a 20 20 20 20 73 63 72 6f 6c 6c 2d 62 61 72 2d 74 6f 6f 6c 6b 69 74 el-scroll.....scroll-bar-toolkit
5ce20 2d 73 63 72 6f 6c 6c 29 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 71 75 -scroll))..(defvar.transient--qu
5ce40 69 74 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 27 28 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f it-commands...'(transient-quit-o
5ce60 6e 65 0a 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 29 29 0a 0a 3b 3b 3b ne.....transient-quit-all))..;;;
5ce80 20 49 64 65 6e 74 69 74 69 65 73 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 61 63 .Identities..(defun.transient-ac
5cea0 74 69 76 65 2d 70 72 65 66 69 78 20 28 26 6f 70 74 69 6f 6e 61 6c 20 70 72 65 66 69 78 65 73 29 tive-prefix.(&optional.prefixes)
5cec0 0a 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 ..."Return.the.active.transient.
5cee0 6f 62 6a 65 63 74 2e 0a 0a 52 65 74 75 72 6e 20 6e 69 6c 20 69 66 20 74 68 65 72 65 20 69 73 20 object...Return.nil.if.there.is.
5cf00 6e 6f 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 69 66 20 74 68 65 20 74 72 61 6e no.active.transient,.if.the.tran
5cf20 73 69 65 6e 74 20 62 75 66 66 65 72 0a 69 73 6e 27 74 20 73 68 6f 77 6e 2c 20 61 6e 64 20 77 68 sient.buffer.isn't.shown,.and.wh
5cf40 69 6c 65 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 73 75 73 70 ile.the.active.transient.is.susp
5cf60 65 6e 64 65 64 20 28 65 2e 67 2e 2c 20 77 68 69 6c 65 0a 74 68 65 20 6d 69 6e 69 62 75 66 66 65 ended.(e.g.,.while.the.minibuffe
5cf80 72 20 69 73 20 69 6e 20 75 73 65 29 2e 0a 0a 55 6e 6c 69 6b 65 20 60 74 72 61 6e 73 69 65 6e 74 r.is.in.use)...Unlike.`transient
5cfa0 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 27 2c 20 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 20 -current-prefix',.which.is.only.
5cfc0 65 76 65 72 20 6e 6f 6e 2d 6e 69 6c 20 69 6e 20 63 6f 64 65 0a 74 68 61 74 20 69 73 20 72 75 6e ever.non-nil.in.code.that.is.run
5cfe0 20 64 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 20 69 .directly.by.a.command.that.is.i
5d000 6e 76 6f 6b 65 64 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 0a 69 73 20 63 75 72 72 nvoked.while.a.transient.is.curr
5d020 65 6e 74 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 73 75 69 74 61 ent,.this.function.is.also.suita
5d040 62 6c 65 20 66 6f 72 20 75 73 65 20 69 6e 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 0a 63 6f 64 65 ble.for.use.in.asynchronous.code
5d060 2c 20 73 75 63 68 20 61 73 20 74 69 6d 65 72 73 20 61 6e 64 20 63 61 6c 6c 62 61 63 6b 73 20 28 ,.such.as.timers.and.callbacks.(
5d080 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 27 73 20 6d 61 69 6e 20 75 73 65 2d 63 61 73 65 29 2e 0a this.function's.main.use-case)..
5d0a0 0a 49 66 20 6f 70 74 69 6f 6e 61 6c 20 50 52 45 46 49 58 45 53 20 69 73 20 6e 6f 6e 2d 6e 69 6c .If.optional.PREFIXES.is.non-nil
5d0c0 2c 20 69 74 20 6d 75 73 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 73 79 ,.it.must.be.a.prefix.command.sy
5d0e0 6d 62 6f 6c 0a 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 73 79 6d 62 6f 6c 73 2c 20 69 6e 20 77 68 mbol.or.a.list.of.symbols,.in.wh
5d100 69 63 68 20 63 61 73 65 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 6f 62 ich.case.the.active.transient.ob
5d120 6a 65 63 74 20 69 73 0a 6f 6e 6c 79 20 72 65 74 75 72 6e 65 64 20 69 66 20 69 74 20 6d 61 74 63 ject.is.only.returned.if.it.matc
5d140 68 65 73 20 6f 6e 65 20 6f 66 20 50 52 45 46 49 58 45 53 2e 22 0a 20 20 28 61 6e 64 20 74 72 61 hes.one.of.PREFIXES."...(and.tra
5d160 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 0a 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d nsient--showp........transient--
5d180 70 72 65 66 69 78 0a 20 20 20 20 20 20 20 28 6f 72 20 28 6e 6f 74 20 70 72 65 66 69 78 65 73 29 prefix........(or.(not.prefixes)
5d1a0 0a 20 20 20 20 20 20 20 20 20 20 20 28 6d 65 6d 71 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e ............(memq.(oref.transien
5d1c0 74 2d 2d 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 20 28 65 6e 73 75 72 65 2d 6c 69 73 74 20 t--prefix.command).(ensure-list.
5d1e0 70 72 65 66 69 78 65 73 29 29 29 0a 20 20 20 20 20 20 20 28 6f 72 20 28 6d 65 6d 71 20 27 74 72 prefixes)))........(or.(memq.'tr
5d200 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 ansient--pre-command.pre-command
5d220 2d 68 6f 6f 6b 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6d 65 6d 71 20 74 20 70 -hook)............(and.(memq.t.p
5d240 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 re-command-hook)................
5d260 20 28 6d 65 6d 71 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 .(memq.'transient--pre-command..
5d280 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 66 61 75 6c 74 2d 76 61 .....................(default-va
5d2a0 6c 75 65 20 27 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 29 29 29 29 0a 20 20 20 20 20 20 lue.'pre-command-hook)))).......
5d2c0 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 .transient--prefix))..(defun.tra
5d2e0 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 20 28 29 0a 20 20 22 52 65 74 75 72 nsient-prefix-object.()..."Retur
5d300 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 65 66 69 78 20 61 73 20 61 6e 20 6f 62 6a 65 63 n.the.current.prefix.as.an.objec
5d320 74 2e 0a 0a 57 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 62 65 69 6e 67 20 73 t...While.a.transient.is.being.s
5d340 65 74 75 70 20 6f 72 20 72 65 66 72 65 73 68 65 64 20 28 77 68 69 63 68 20 69 6e 76 6f 6c 76 65 etup.or.refreshed.(which.involve
5d360 73 0a 70 72 65 70 61 72 69 6e 67 20 69 74 73 20 73 75 66 66 69 78 65 73 29 20 74 68 65 20 76 61 s.preparing.its.suffixes).the.va
5d380 72 69 61 62 6c 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 27 20 63 61 6e 20 62 riable.`transient--prefix'.can.b
5d3a0 65 0a 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 e.used.to.access.the.prefix.obje
5d3c0 63 74 2e 20 20 54 68 75 73 20 74 68 69 73 20 69 73 20 77 68 61 74 20 68 61 73 20 74 6f 20 62 65 ct...Thus.this.is.what.has.to.be
5d3e0 0a 75 73 65 64 20 69 6e 20 73 75 66 66 69 78 20 6d 65 74 68 6f 64 73 20 73 75 63 68 20 61 73 20 .used.in.suffix.methods.such.as.
5d400 60 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 2c 0a `transient-format-description',.
5d420 61 6e 64 20 69 6e 20 6f 62 6a 65 63 74 2d 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 and.in.object-specific.functions
5d440 20 74 68 61 74 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 73 75 66 66 69 78 20 73 6c 6f 74 73 .that.are.stored.in.suffix.slots
5d460 0a 73 75 63 68 20 61 73 20 60 64 65 73 63 72 69 70 74 69 6f 6e 27 2e 0a 0a 57 68 65 6e 20 61 20 .such.as.`description'...When.a.
5d480 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 28 69 2e 65 2e 2c suffix.command.is.invoked.(i.e.,
5d4a0 20 69 6e 20 69 74 73 20 60 69 6e 74 65 72 61 63 74 69 76 65 27 20 66 6f 72 6d 0a 61 6e 64 20 66 .in.its.`interactive'.form.and.f
5d4c0 75 6e 63 74 69 6f 6e 20 62 6f 64 79 29 20 74 68 65 6e 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 unction.body).then.the.variable.
5d4e0 60 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 27 0a 68 61 73 20 74 `transient-current-prefix'.has.t
5d500 6f 20 62 65 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e 0a 0a 54 77 6f 20 64 69 73 74 69 6e 63 74 o.be.used.instead...Two.distinct
5d520 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 6e 65 65 64 65 64 2c 20 62 65 63 61 75 73 65 20 61 .variables.are.needed,.because.a
5d540 6e 79 20 70 72 65 66 69 78 20 6d 61 79 20 69 74 73 65 6c 66 0a 62 65 20 75 73 65 64 20 61 73 20 ny.prefix.may.itself.be.used.as.
5d560 61 20 73 75 66 66 69 78 20 6f 66 20 61 6e 6f 74 68 65 72 20 70 72 65 66 69 78 2c 20 61 6e 64 20 a.suffix.of.another.prefix,.and.
5d580 73 75 63 68 20 73 75 62 2d 70 72 65 66 69 78 65 73 20 68 61 76 65 0a 74 6f 20 62 65 20 61 62 6c such.sub-prefixes.have.to.be.abl
5d5a0 65 20 74 6f 20 74 65 6c 6c 20 74 68 65 6d 73 65 6c 76 65 73 20 61 70 61 72 74 20 66 72 6f 6d 20 e.to.tell.themselves.apart.from.
5d5c0 74 68 65 20 70 72 65 66 69 78 20 74 68 65 79 20 77 65 72 65 0a 69 6e 76 6f 6b 65 64 20 66 72 6f the.prefix.they.were.invoked.fro
5d5e0 6d 2e 0a 0a 52 65 67 75 6c 61 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 m...Regular.suffix.commands,.whi
5d600 63 68 20 61 72 65 20 6e 6f 74 20 70 72 65 66 69 78 65 73 2c 20 64 6f 20 6e 6f 74 20 68 61 76 65 ch.are.not.prefixes,.do.not.have
5d620 20 74 6f 0a 63 6f 6e 63 65 72 6e 20 74 68 65 6d 73 65 6c 76 65 73 20 77 69 74 68 20 74 68 69 73 .to.concern.themselves.with.this
5d640 20 64 69 73 74 69 6e 63 74 69 6f 6e 2c 20 73 6f 20 74 68 65 79 20 63 61 6e 20 75 73 65 20 74 68 .distinction,.so.they.can.use.th
5d660 69 73 0a 66 75 6e 63 74 69 6f 6e 20 69 6e 73 74 65 61 64 2e 20 20 49 6e 20 74 68 65 20 63 6f 6e is.function.instead...In.the.con
5d680 74 65 78 74 20 6f 66 20 61 20 70 6c 61 69 6e 20 73 75 66 66 69 78 2c 20 69 74 20 61 6c 77 61 79 text.of.a.plain.suffix,.it.alway
5d6a0 73 0a 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 70 70 72 6f s.returns.the.value.of.the.appro
5d6c0 70 72 69 61 74 65 20 76 61 72 69 61 62 6c 65 2e 22 0a 20 20 28 6f 72 20 74 72 61 6e 73 69 65 6e priate.variable."...(or.transien
5d6e0 74 2d 2d 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 t--prefix.transient-current-pref
5d700 69 78 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 ix))..(defun.transient-suffix-ob
5d720 6a 65 63 74 20 28 26 6f 70 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 22 52 65 74 75 ject.(&optional.command)..."Retu
5d740 72 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 rn.the.object.associated.with.th
5d760 65 20 63 75 72 72 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 45 61 63 68 20 e.current.suffix.command...Each.
5d780 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 suffix.commands.is.associated.wi
5d7a0 74 68 20 61 6e 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 68 6f 6c 64 73 0a 61 64 64 69 74 69 th.an.object,.which.holds.additi
5d7c0 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 73 75 66 66 69 onal.information.about.the.suffi
5d7e0 78 2c 20 73 75 63 68 20 61 73 20 69 74 73 20 76 61 6c 75 65 20 28 69 6e 0a 74 68 65 20 63 61 73 x,.such.as.its.value.(in.the.cas
5d800 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 69 63 68 20 69 73 20 e.of.an.infix.command,.which.is.
5d820 61 20 6b 69 6e 64 20 6f 66 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 29 2e 0a 0a 54 68 69 73 a.kind.of.suffix.command)...This
5d840 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 63 61 6c 6c .function.is.intended.to.be.call
5d860 65 64 20 62 79 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 0a 61 72 65 20 ed.by.infix.commands,.which.are.
5d880 75 73 75 61 6c 6c 79 20 61 6c 69 61 73 65 73 20 6f 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 64 usually.aliases.of.`transient--d
5d8a0 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 27 2c 20 77 68 69 63 68 0a 69 73 20 efault-infix-command',.which.is.
5d8c0 64 65 66 69 6e 65 64 20 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 20 20 28 64 65 66 75 6e 20 74 72 61 defined.like.this:....(defun.tra
5d8e0 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 20 28 29 nsient--default-infix-command.()
5d900 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 6f 62 .....(interactive).....(let.((ob
5d920 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a 20 20 j.(transient-suffix-object)))...
5d940 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 28 74 72 ....(transient-infix-set.obj.(tr
5d960 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 6f 62 6a 29 29 29 0a 20 20 20 20 28 74 ansient-infix-read.obj))).....(t
5d980 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 0a 5c 28 55 73 65 72 20 69 6e 70 75 74 20 69 ransient--show))..\(User.input.i
5d9a0 73 20 72 65 61 64 20 6f 75 74 73 69 64 65 20 6f 66 20 60 69 6e 74 65 72 61 63 74 69 76 65 27 20 s.read.outside.of.`interactive'.
5d9c0 74 6f 20 70 72 65 76 65 6e 74 20 74 68 65 0a 63 6f 6d 6d 61 6e 64 20 66 72 6f 6d 20 62 65 69 6e to.prevent.the.command.from.bein
5d9e0 67 20 61 64 64 65 64 20 74 6f 20 60 63 6f 6d 6d 61 6e 64 2d 68 69 73 74 6f 72 79 27 2e 20 20 53 g.added.to.`command-history'...S
5da00 65 65 20 23 32 33 2e 29 0a 0a 53 75 63 68 20 63 6f 6d 6d 61 6e 64 73 20 6e 65 65 64 20 74 6f 20 ee.#23.)..Such.commands.need.to.
5da20 62 65 20 61 62 6c 65 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 69 72 20 61 73 73 6f 63 69 61 74 be.able.to.access.their.associat
5da40 65 64 20 6f 62 6a 65 63 74 0a 74 6f 20 67 75 69 64 65 20 68 6f 77 20 60 74 72 61 6e 73 69 65 6e ed.object.to.guide.how.`transien
5da60 74 2d 69 6e 66 69 78 2d 72 65 61 64 27 20 72 65 61 64 73 20 74 68 65 20 6e 65 77 20 76 61 6c 75 t-infix-read'.reads.the.new.valu
5da80 65 20 61 6e 64 20 74 6f 0a 73 74 6f 72 65 20 74 68 65 20 72 65 61 64 20 76 61 6c 75 65 2e 20 20 e.and.to.store.the.read.value...
5daa0 4f 74 68 65 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 28 69 6e 63 6c 75 64 69 6e 67 Other.suffix.commands.(including
5dac0 20 6e 6f 6e 2d 69 6e 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 29 20 6d 61 79 20 61 6c 73 6f 20 6e 65 .non-infix.commands).may.also.ne
5dae0 65 64 20 74 68 65 20 6f 62 6a 65 63 74 20 74 6f 20 67 75 69 64 65 20 74 68 65 69 72 20 62 65 68 ed.the.object.to.guide.their.beh
5db00 61 76 69 6f 72 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 73 20 74 avior...This.function.attempts.t
5db20 6f 20 72 65 74 75 72 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 73 6f 63 69 61 74 65 64 20 77 o.return.the.object.associated.w
5db40 69 74 68 20 74 68 65 0a 63 75 72 72 65 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 65 ith.the.current.suffix.command.e
5db60 76 65 6e 20 69 66 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 6e 6f ven.if.the.suffix.command.was.no
5db80 74 20 69 6e 76 6f 6b 65 64 0a 66 72 6f 6d 20 61 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 28 46 6f t.invoked.from.a.transient...(Fo
5dba0 72 20 73 6f 6d 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 20 61 20 r.some.suffix.command.that.is.a.
5dbc0 76 61 6c 69 64 20 74 68 69 6e 67 0a 74 6f 20 64 6f 2c 20 66 6f 72 20 6f 74 68 65 72 73 20 69 74 valid.thing.to.do,.for.others.it
5dbe0 20 69 73 20 6e 6f 74 2e 29 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 20 6e 69 6c 20 6d 61 79 20 .is.not.)..In.that.case.nil.may.
5dc00 62 65 20 72 65 74 75 72 6e 65 64 2c 0a 69 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 be.returned,.if.the.command.was.
5dc20 6e 6f 74 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 6d 61 63 not.defined.using.one.of.the.mac
5dc40 72 6f 73 20 69 6e 74 65 6e 64 65 64 0a 74 6f 20 64 65 66 69 6e 65 20 73 75 63 68 20 63 6f 6d 6d ros.intended.to.define.such.comm
5dc60 61 6e 64 73 2e 0a 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 43 4f 4d ands...The.optional.argument.COM
5dc80 4d 41 4e 44 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20 75 73 MAND.is.intended.for.internal.us
5dca0 65 2e 20 20 49 66 0a 79 6f 75 20 61 72 65 20 63 6f 6e 74 65 6d 70 6c 61 74 69 6e 67 20 75 73 69 e...If.you.are.contemplating.usi
5dcc0 6e 67 20 69 74 20 69 6e 20 79 6f 75 72 20 6f 77 6e 20 63 6f 64 65 2c 20 74 68 65 6e 20 79 6f 75 ng.it.in.your.own.code,.then.you
5dce0 20 73 68 6f 75 6c 64 0a 70 72 6f 62 61 62 6c 79 20 75 73 65 20 74 68 69 73 20 69 6e 73 74 65 61 .should.probably.use.this.instea
5dd00 64 3a 0a 0a 20 20 28 67 65 74 20 43 4f 4d 4d 41 4e 44 20 5c 5c 3d 27 74 72 61 6e 73 69 65 6e 74 d:....(get.COMMAND.\\='transient
5dd20 2d 2d 73 75 66 66 69 78 29 22 0a 20 20 28 77 68 65 6e 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 28 --suffix)"...(when.command.....(
5dd40 63 6c 2d 63 68 65 63 6b 2d 74 79 70 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6d 6d 61 6e 64 29 29 0a cl-check-type.command.command)).
5dd60 20 20 28 63 6f 6e 64 0a 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 73 ..(cond....(transient--pending-s
5dd80 75 66 66 69 78 29 0a 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 63 75 72 72 65 6e 74 2d 73 75 uffix)....(transient--current-su
5dda0 66 66 69 78 29 0a 20 20 20 28 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 0a ffix)....((or.transient--prefix.
5ddc0 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 ........transient-current-prefix
5dde0 29 0a 20 20 20 20 28 6c 65 74 20 28 28 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 20 20 20 20 20 ).....(let.((suffixes...........
5de00 20 28 63 6c 2d 72 65 6d 6f 76 65 2d 69 66 2d 6e 6f 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 .(cl-remove-if-not.............(
5de20 6c 61 6d 62 64 61 20 28 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 20 28 lambda.(obj)...............(eq.(
5de40 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 oref.obj.command)...............
5de60 20 20 20 20 28 6f 72 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ....(or.command.................
5de80 20 20 20 20 20 20 28 69 66 20 28 65 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e ......(if.(eq.this-command.'tran
5dea0 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 sient-set-level)................
5dec0 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 54 68 69 73 20 69 73 20 68 6f 77 20 69 74 20 63 61 6e ...........;;.This.is.how.it.can
5dee0 20 6c 6f 6f 6b 20 75 70 20 66 6f 72 20 77 68 69 63 68 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .look.up.for.which..............
5df00 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 63 6f 6d 6d 61 6e 64 20 69 74 20 69 73 20 73 65 .............;;.command.it.is.se
5df20 74 74 69 6e 67 20 74 68 65 20 6c 65 76 65 6c 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 tting.the.level.................
5df40 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 ...........this-original-command
5df60 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 74 68 69 73 2d 63 6f .........................this-co
5df80 6d 6d 61 6e 64 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 74 72 61 6e 73 69 mmand)))).............(or.transi
5dfa0 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 ent--suffixes.................tr
5dfc0 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 29 29 29 29 0a 20 20 20 ansient-current-suffixes))))....
5dfe0 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 28 28 6c 65 6e 67 74 68 3d 20 73 75 66 66 69 78 ...(cond........((length=.suffix
5e000 65 73 20 31 29 0a 20 20 20 20 20 20 20 20 28 63 61 72 20 73 75 66 66 69 78 65 73 29 29 0a 20 20 es.1).........(car.suffixes))...
5e020 20 20 20 20 20 28 28 63 6c 2d 66 69 6e 64 2d 69 66 20 28 6c 61 6d 62 64 61 20 28 6f 62 6a 29 0a .....((cl-find-if.(lambda.(obj).
5e040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 75 61 6c 20 28 6c 69 ......................(equal.(li
5e060 73 74 69 66 79 2d 6b 65 79 2d 73 65 71 75 65 6e 63 65 20 28 6b 62 64 20 28 6f 72 65 66 20 6f 62 stify-key-sequence.(kbd.(oref.ob
5e080 6a 20 6b 65 79 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 j.key)))........................
5e0a0 20 20 20 20 20 20 28 6c 69 73 74 69 66 79 2d 6b 65 79 2d 73 65 71 75 65 6e 63 65 20 28 74 68 69 ......(listify-key-sequence.(thi
5e0c0 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 s-command-keys))))..............
5e0e0 20 20 20 20 20 20 20 73 75 66 66 69 78 65 73 29 29 0a 20 20 20 20 20 20 20 3b 3b 20 43 4f 4d 4d .......suffixes))........;;.COMM
5e100 41 4e 44 20 69 73 20 6f 6e 6c 79 20 70 72 6f 76 69 64 65 64 20 69 66 20 60 74 68 69 73 2d 63 6f AND.is.only.provided.if.`this-co
5e120 6d 6d 61 6e 64 27 20 69 73 20 6d 65 61 6e 69 6e 67 6c 65 73 73 2c 20 69 6e 0a 20 20 20 20 20 20 mmand'.is.meaningless,.in.......
5e140 20 3b 3b 20 77 68 69 63 68 20 63 61 73 65 20 60 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 .;;.which.case.`this-command-key
5e160 73 27 20 69 73 20 61 6c 73 6f 20 6d 65 61 6e 69 6e 67 6c 65 73 73 2c 20 6d 61 6b 69 6e 67 20 69 s'.is.also.meaningless,.making.i
5e180 74 0a 20 20 20 20 20 20 20 3b 3b 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 69 73 61 6d 62 t........;;.impossible.to.disamb
5e1a0 69 67 75 61 74 65 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 20 73 61 6d 65 20 63 6f 6d iguate.bindings.for.the.same.com
5e1c0 6d 61 6e 64 2e 0a 20 20 20 20 20 20 20 28 63 6f 6d 6d 61 6e 64 20 28 63 61 72 20 73 75 66 66 69 mand.........(command.(car.suffi
5e1e0 78 65 73 29 29 0a 20 20 20 20 20 20 20 3b 3b 20 49 66 20 43 4f 4d 4d 41 4e 44 20 69 73 20 6e 69 xes))........;;.If.COMMAND.is.ni
5e200 6c 2c 20 74 68 65 6e 20 66 61 69 6c 75 72 65 20 74 6f 20 64 69 73 61 6d 62 69 67 75 61 74 65 20 l,.then.failure.to.disambiguate.
5e220 6c 69 6b 65 6c 79 20 6d 65 61 6e 73 0a 20 20 20 20 20 20 20 3b 3b 20 74 68 61 74 20 74 68 65 72 likely.means........;;.that.ther
5e240 65 20 69 73 20 61 20 62 75 67 20 73 6f 6d 65 77 68 65 72 65 2e 0a 20 20 20 20 20 20 20 28 28 6c e.is.a.bug.somewhere.........((l
5e260 65 6e 67 74 68 3e 20 73 75 66 66 69 78 65 73 20 31 29 0a 20 20 20 20 20 20 20 20 28 65 72 72 6f ength>.suffixes.1).........(erro
5e280 72 20 22 42 55 47 3a 20 43 61 6e 6e 6f 74 20 75 6e 61 6d 62 69 67 75 6f 75 73 6c 79 20 64 65 74 r."BUG:.Cannot.unambiguously.det
5e2a0 65 72 6d 69 6e 65 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 22 29 29 0a 20 20 20 20 20 20 20 3b ermine.suffix.object"))........;
5e2c0 3b 20 49 74 20 69 73 20 6c 65 67 69 6d 61 74 65 20 74 6f 20 75 73 65 20 74 68 69 73 20 66 75 6e ;.It.is.legimate.to.use.this.fun
5e2e0 63 74 69 6f 6e 20 61 73 20 61 20 70 72 65 64 69 63 61 74 65 20 6f 66 20 73 6f 72 74 73 2e 0a 20 ction.as.a.predicate.of.sorts...
5e300 20 20 20 20 20 20 3b 3b 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 ......;;.`transient--pre-command
5e320 27 20 61 6e 64 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 27 20 61 72 65 20 65 78 61 6d 70 '.and.`transient-help'.are.examp
5e340 6c 65 73 2e 0a 20 20 20 20 20 20 20 28 74 20 6e 69 6c 29 29 29 29 0a 20 20 20 28 28 61 6e 64 2d les.........(t.nil))))....((and-
5e360 6c 65 74 2a 20 28 28 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 let*.((obj.(transient--suffix-pr
5e380 6f 74 6f 74 79 70 65 20 28 6f 72 20 63 6f 6d 6d 61 6e 64 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 ototype.(or.command.this-command
5e3a0 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 62 6a 20 28 63 6c 6f 6e 65 20 6f )))................(obj.(clone.o
5e3c0 62 6a 29 29 29 0a 20 20 20 20 20 20 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e bj))).......(progn.........(tran
5e3e0 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 28 74 sient-init-scope.obj).........(t
5e400 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 ransient-init-value.obj)........
5e420 20 6f 62 6a 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 .obj)))))..(defun.transient--suf
5e440 66 69 78 2d 70 72 6f 74 6f 74 79 70 65 20 28 63 6f 6d 6d 61 6e 64 29 0a 20 20 28 6f 72 20 28 67 fix-prototype.(command)...(or.(g
5e460 65 74 20 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 29 0a 20 et.command.'transient--suffix)..
5e480 20 20 20 20 20 28 73 65 71 2d 73 6f 6d 65 20 28 6c 61 6d 62 64 61 20 28 63 6d 64 29 20 28 67 65 .....(seq-some.(lambda.(cmd).(ge
5e4a0 74 20 63 6d 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 29 29 0a 20 20 20 20 20 t.cmd.'transient--suffix))......
5e4c0 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 74 69 6f 6e 2d 61 6c 69 61 73 2d 70 20 63 6f 6d ...........(function-alias-p.com
5e4e0 6d 61 6e 64 29 29 29 29 0a 0a 3b 3b 3b 20 4b 65 79 6d 61 70 73 0a 0a 28 64 65 66 76 61 72 2d 6b mand))))..;;;.Keymaps..(defvar-k
5e500 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 eymap.transient-base-map...:doc.
5e520 22 50 61 72 65 6e 74 20 6f 66 20 6f 74 68 65 72 20 6b 65 79 6d 61 70 73 20 75 73 65 64 20 62 79 "Parent.of.other.keymaps.used.by
5e540 20 54 72 61 6e 73 69 65 6e 74 2e 0a 0a 54 68 69 73 20 69 73 20 74 68 65 20 70 61 72 65 6e 74 20 .Transient...This.is.the.parent.
5e560 6b 65 79 6d 61 70 20 6f 66 20 61 6c 6c 20 74 68 65 20 6b 65 79 6d 61 70 73 20 74 68 61 74 20 61 keymap.of.all.the.keymaps.that.a
5e580 72 65 20 75 73 65 64 20 69 6e 0a 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 3a 20 60 74 72 61 6e re.used.in.all.transients:.`tran
5e5a0 73 69 65 6e 74 2d 6d 61 70 27 20 28 77 68 69 63 68 20 69 6e 20 74 75 72 6e 20 69 73 20 74 68 65 sient-map'.(which.in.turn.is.the
5e5c0 20 70 61 72 65 6e 74 0a 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2d 73 70 65 63 69 66 69 .parent.of.the.transient-specifi
5e5e0 63 20 6b 65 79 6d 61 70 73 29 2c 20 60 74 72 61 6e 73 69 65 6e 74 2d 65 64 69 74 2d 6d 61 70 27 c.keymaps),.`transient-edit-map'
5e600 20 61 6e 64 0a 60 74 72 61 6e 73 69 65 6e 74 2d 73 74 69 63 6b 79 2d 6d 61 70 27 2e 0a 0a 49 66 .and.`transient-sticky-map'...If
5e620 20 79 6f 75 20 63 68 61 6e 67 65 20 61 20 62 69 6e 64 69 6e 67 20 68 65 72 65 2c 20 74 68 65 6e .you.change.a.binding.here,.then
5e640 20 79 6f 75 20 6d 69 67 68 74 20 61 6c 73 6f 20 68 61 76 65 20 74 6f 20 65 64 69 74 0a 60 74 72 .you.might.also.have.to.edit.`tr
5e660 61 6e 73 69 65 6e 74 2d 73 74 69 63 6b 79 2d 6d 61 70 27 20 61 6e 64 20 60 74 72 61 6e 73 69 65 ansient-sticky-map'.and.`transie
5e680 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 27 2e 20 20 57 68 69 6c 65 0a 74 68 65 20 nt-common-commands'...While.the.
5e6a0 6c 61 74 74 65 72 20 69 73 6e 27 74 20 61 20 70 72 6f 70 65 72 20 74 72 61 6e 73 69 65 6e 74 20 latter.isn't.a.proper.transient.
5e6c0 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 69 74 20 63 61 6e 20 62 65 0a 65 64 69 74 65 64 prefix.command,.it.can.be.edited
5e6e0 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 73 20 75 73 65 .using.the.same.functions.as.use
5e700 64 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 73 2e 0a 0a 49 66 20 79 6f 75 20 61 64 64 20 61 20 d.for.transients...If.you.add.a.
5e720 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 68 65 72 65 2c 20 74 68 65 6e 20 79 6f 75 20 6d 75 73 74 20 new.command.here,.then.you.must.
5e740 61 6c 73 6f 20 61 64 64 20 61 20 62 69 6e 64 69 6e 67 0a 74 6f 20 60 74 72 61 6e 73 69 65 6e 74 also.add.a.binding.to.`transient
5e760 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 27 2e 22 0a 20 20 22 45 53 43 20 45 53 43 20 45 53 43 -predicate-map'."..."ESC.ESC.ESC
5e780 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 0a 20 20 22 43 2d 67 22 20 20 ".#'transient-quit-all..."C-g"..
5e7a0 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e 65 0a 20 20 22 43 2d 71 22 20 ...#'transient-quit-one..."C-q".
5e7c0 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 0a 20 20 22 43 2d 7a 22 ....#'transient-quit-all..."C-z"
5e7e0 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 75 73 70 65 6e 64 0a 20 20 22 43 2d 76 22 .....#'transient-suspend..."C-v"
5e800 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 0a 20 20 22 43 2d .....#'transient-scroll-up..."C-
5e820 4d 2d 76 22 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 64 6f 77 6e 0a 20 M-v"...#'transient-scroll-down..
5e840 20 22 3c 6e 65 78 74 3e 22 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 ."<next>"..#'transient-scroll-up
5e860 0a 20 20 22 3c 70 72 69 6f 72 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d ..."<prior>".#'transient-scroll-
5e880 64 6f 77 6e 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 0a 20 20 28 down)..(defvar.transient-map...(
5e8a0 6c 65 74 20 28 28 6d 61 70 20 28 6d 61 6b 65 2d 73 70 61 72 73 65 2d 6b 65 79 6d 61 70 29 29 29 let.((map.(make-sparse-keymap)))
5e8c0 0a 20 20 20 20 28 73 65 74 2d 6b 65 79 6d 61 70 2d 70 61 72 65 6e 74 20 6d 61 70 20 74 72 61 6e .....(set-keymap-parent.map.tran
5e8e0 73 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 29 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 sient-base-map).....(keymap-set.
5e900 6d 61 70 20 22 43 2d 75 22 20 20 20 23 27 75 6e 69 76 65 72 73 61 6c 2d 61 72 67 75 6d 65 6e 74 map."C-u"...#'universal-argument
5e920 29 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 43 2d 2d 22 20 20 20 23 27 ).....(keymap-set.map."C--"...#'
5e940 6e 65 67 61 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 29 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 negative-argument).....(keymap-s
5e960 65 74 20 6d 61 70 20 22 43 2d 74 22 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 29 et.map."C-t"...#'transient-show)
5e980 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 3f 22 20 20 20 20 20 23 27 74 .....(keymap-set.map."?".....#'t
5e9a0 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 29 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d ransient-help).....(keymap-set.m
5e9c0 61 70 20 22 43 2d 68 22 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 29 0a 20 20 20 ap."C-h"...#'transient-help)....
5e9e0 20 3b 3b 20 4e 65 78 74 20 74 77 6f 20 68 61 76 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 62 69 6e .;;.Next.two.have.additional.bin
5ea00 64 69 6e 67 73 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e dings.in.transient-common-comman
5ea20 64 73 2e 0a 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 43 2d 4d 2d 70 22 20 ds......(keymap-set.map."C-M-p".
5ea40 23 27 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 76 29 0a 20 20 20 20 28 6b #'transient-history-prev).....(k
5ea60 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 43 2d 4d 2d 6e 22 20 23 27 74 72 61 6e 73 69 65 6e eymap-set.map."C-M-n".#'transien
5ea80 74 2d 68 69 73 74 6f 72 79 2d 6e 65 78 74 29 0a 20 20 20 20 28 77 68 65 6e 20 28 66 62 6f 75 6e t-history-next).....(when.(fboun
5eaa0 64 70 20 27 6f 74 68 65 72 2d 66 72 61 6d 65 2d 70 72 65 66 69 78 29 20 3b 45 6d 61 63 73 20 3e dp.'other-frame-prefix).;Emacs.>
5eac0 3d 20 32 38 2e 31 0a 20 20 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 43 2d =.28.1.......(keymap-set.map."C-
5eae0 78 20 35 20 35 22 20 27 6f 74 68 65 72 2d 66 72 61 6d 65 2d 70 72 65 66 69 78 29 0a 20 20 20 20 x.5.5".'other-frame-prefix).....
5eb00 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 43 2d 78 20 34 20 34 22 20 27 6f 74 68 ..(keymap-set.map."C-x.4.4".'oth
5eb20 65 72 2d 77 69 6e 64 6f 77 2d 70 72 65 66 69 78 29 29 0a 20 20 20 20 6d 61 70 29 0a 20 20 22 54 er-window-prefix)).....map)..."T
5eb40 6f 70 2d 6c 65 76 65 6c 20 6b 65 79 6d 61 70 20 75 73 65 64 20 62 79 20 61 6c 6c 20 74 72 61 6e op-level.keymap.used.by.all.tran
5eb60 73 69 65 6e 74 73 2e 0a 0a 49 66 20 79 6f 75 20 61 64 64 20 61 20 6e 65 77 20 63 6f 6d 6d 61 6e sients...If.you.add.a.new.comman
5eb80 64 20 68 65 72 65 2c 20 74 68 65 6e 20 79 6f 75 20 6d 75 73 74 20 61 6c 73 6f 20 61 64 64 20 61 d.here,.then.you.must.also.add.a
5eba0 20 62 69 6e 64 69 6e 67 0a 74 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 .binding.to.`transient-predicate
5ebc0 2d 6d 61 70 27 2e 20 20 53 65 65 20 61 6c 73 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 62 61 73 65 -map'...See.also.`transient-base
5ebe0 2d 6d 61 70 27 2e 22 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 -map'.")..(defvar-keymap.transie
5ec00 6e 74 2d 65 64 69 74 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 4b 65 79 6d 61 70 20 74 68 61 74 20 nt-edit-map...:doc."Keymap.that.
5ec20 69 73 20 61 63 74 69 76 65 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 20 69 is.active.while.a.transient.in.i
5ec40 73 20 69 6e 20 5c 22 65 64 69 74 20 6d 6f 64 65 5c 22 2e 22 0a 20 20 3a 70 61 72 65 6e 74 20 74 s.in.\"edit.mode\"."...:parent.t
5ec60 72 61 6e 73 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 0a 20 20 22 3f 22 20 20 20 23 27 74 72 61 6e ransient-base-map..."?"...#'tran
5ec80 73 69 65 6e 74 2d 68 65 6c 70 0a 20 20 22 43 2d 68 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 68 sient-help..."C-h".#'transient-h
5eca0 65 6c 70 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 73 elp)..(defvar-keymap.transient-s
5ecc0 74 69 63 6b 79 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 4b 65 79 6d 61 70 20 74 68 61 74 20 69 73 ticky-map...:doc."Keymap.that.is
5ece0 20 61 63 74 69 76 65 20 77 68 69 6c 65 20 61 6e 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 .active.while.an.incomplete.key.
5ed00 73 65 71 75 65 6e 63 65 20 69 73 20 61 63 74 69 76 65 2e 22 0a 20 20 3a 70 61 72 65 6e 74 20 74 sequence.is.active."...:parent.t
5ed20 72 61 6e 73 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 0a 20 20 22 43 2d 67 22 20 23 27 74 72 61 6e ransient-base-map..."C-g".#'tran
5ed40 73 69 65 6e 74 2d 71 75 69 74 2d 73 65 71 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 sient-quit-seq)..(defvar.transie
5ed60 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 5b 3a 68 69 64 65 20 28 6c 61 6d nt-common-commands...[:hide.(lam
5ed80 62 64 61 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 bda.()............(defvar.transi
5eda0 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 ent--redisplay-key)............(
5edc0 61 6e 64 20 28 6e 6f 74 20 28 65 71 75 61 6c 20 28 76 63 6f 6e 63 61 74 20 74 72 61 6e 73 69 65 and.(not.(equal.(vconcat.transie
5ede0 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 nt--redisplay-key)..............
5ee00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 61 64 2d 6b 62 64 2d 6d 61 63 72 6f 20 74 ...............(read-kbd-macro.t
5ee20 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 29 29 ransient-common-command-prefix))
5ee40 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 ).................(not.transient
5ee60 2d 73 68 6f 77 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 29 29 29 0a 20 20 20 5b 22 56 61 -show-common-commands)))....["Va
5ee80 6c 75 65 20 63 6f 6d 6d 61 6e 64 73 22 0a 20 20 20 20 28 22 7b 70 7d 20 73 20 20 22 20 22 53 65 lue.commands".....("{p}.s.."."Se
5eea0 74 22 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 29 0a 20 20 20 t"............transient-set)....
5eec0 20 28 22 7b 70 7d 20 43 2d 73 22 20 22 53 61 76 65 22 20 20 20 20 20 20 20 20 20 20 20 74 72 61 .("{p}.C-s"."Save"...........tra
5eee0 6e 73 69 65 6e 74 2d 73 61 76 65 29 0a 20 20 20 20 28 22 7b 70 7d 20 43 2d 6b 22 20 22 52 65 73 nsient-save).....("{p}.C-k"."Res
5ef00 65 74 22 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 65 74 29 0a 20 20 et"..........transient-reset)...
5ef20 20 20 28 22 7b 70 7d 20 70 20 20 22 20 22 50 72 65 76 69 6f 75 73 20 76 61 6c 75 65 22 20 74 72 ..("{p}.p.."."Previous.value".tr
5ef40 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 76 29 0a 20 20 20 20 28 22 7b 70 7d 20 ansient-history-prev).....("{p}.
5ef60 6e 20 20 22 20 22 4e 65 78 74 20 76 61 6c 75 65 22 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d n.."."Next.value".....transient-
5ef80 68 69 73 74 6f 72 79 2d 6e 65 78 74 29 5d 0a 20 20 20 5b 22 53 74 69 63 6b 79 20 63 6f 6d 6d 61 history-next)]....["Sticky.comma
5efa0 6e 64 73 22 0a 20 20 20 20 3b 3b 20 4c 69 6b 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 74 69 63 nds".....;;.Like.`transient-stic
5efc0 6b 79 2d 6d 61 70 27 20 65 78 63 65 70 74 20 74 68 61 74 0a 20 20 20 20 3b 3b 20 22 43 2d 67 22 ky-map'.except.that.....;;."C-g"
5efe0 20 68 61 73 20 74 6f 20 62 65 20 62 6f 75 6e 64 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e 74 20 .has.to.be.bound.to.a.different.
5f000 63 6f 6d 6d 61 6e 64 2e 0a 20 20 20 20 28 22 43 2d 67 22 20 22 51 75 69 74 20 70 72 65 66 69 78 command......("C-g"."Quit.prefix
5f020 20 6f 72 20 74 72 61 6e 73 69 65 6e 74 22 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e .or.transient".transient-quit-on
5f040 65 29 0a 20 20 20 20 28 22 43 2d 71 22 20 22 51 75 69 74 20 74 72 61 6e 73 69 65 6e 74 20 73 74 e).....("C-q"."Quit.transient.st
5f060 61 63 6b 22 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 29 0a 20 20 20 ack".....transient-quit-all)....
5f080 20 28 22 43 2d 7a 22 20 22 53 75 73 70 65 6e 64 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b .("C-z"."Suspend.transient.stack
5f0a0 22 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 73 70 65 6e 64 29 5d 0a 20 20 20 5b 22 43 75 73 74 "..transient-suspend)]....["Cust
5f0c0 6f 6d 69 7a 65 22 0a 20 20 20 20 28 22 7b 70 7d 20 74 22 20 74 72 61 6e 73 69 65 6e 74 2d 74 6f omize".....("{p}.t".transient-to
5f0e0 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 29 0a 20 20 20 20 28 22 7b 70 7d 20 6c 22 20 22 53 68 6f 77 2f ggle-common).....("{p}.l"."Show/
5f100 68 69 64 65 20 73 75 66 66 69 78 65 73 22 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 hide.suffixes".transient-set-lev
5f120 65 6c 29 0a 20 20 20 20 28 22 7b 70 7d 20 61 22 20 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c el).....("{p}.a".transient-toggl
5f140 65 2d 6c 65 76 65 6c 2d 6c 69 6d 69 74 29 5d 5d 0a 20 20 22 43 6f 6d 6d 61 6e 64 73 20 61 76 61 e-level-limit)]]..."Commands.ava
5f160 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 73 2e 0a 0a ilable.in.all.transient.menus...
5f180 54 68 65 20 73 61 6d 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20 74 68 61 74 20 61 72 65 20 75 73 65 The.same.functions,.that.are.use
5f1a0 64 20 74 6f 20 63 68 61 6e 67 65 20 62 69 6e 64 69 6e 67 73 20 69 6e 20 74 72 61 6e 73 69 65 6e d.to.change.bindings.in.transien
5f1c0 74 20 70 72 65 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 20 t.prefix.commands.and.transient.
5f1e0 67 72 6f 75 70 73 20 28 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 groups.(defined.using.`transient
5f200 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 27 29 2c 0a 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 -define-group'),.should.be.used.
5f220 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 73 65 20 62 69 6e 64 69 6e 67 73 20 61 73 20 77 65 6c 6c to.modify.these.bindings.as.well
5f240 2e 20 20 54 68 65 20 61 63 74 75 61 6c 20 6c 61 79 6f 75 74 20 69 73 0a 73 74 6f 72 65 64 20 69 ...The.actual.layout.is.stored.i
5f260 6e 20 74 68 65 20 73 79 6d 62 6f 6c 27 73 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 n.the.symbol's.`transient--layou
5f280 74 27 20 70 72 6f 70 65 72 74 79 2e 20 20 54 68 65 20 76 61 72 69 61 62 6c 65 20 76 61 6c 75 65 t'.property...The.variable.value
5f2a0 0a 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 6e 20 63 75 73 74 6f 6d 69 7a 69 6e 67 20 60 .is.only.used.when.customizing.`
5f2c0 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 27 transient-common-command-prefix'
5f2e0 2c 20 77 68 69 63 68 0a 72 65 73 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 60 74 72 61 ,.which.resets.the.value.of.`tra
5f300 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 27 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 76 61 6c nsient--layout'.based.on.the.val
5f320 75 65 73 20 6f 66 20 74 68 61 74 0a 6f 70 74 69 6f 6e 20 61 6e 64 20 74 68 69 73 20 76 61 72 69 ues.of.that.option.and.this.vari
5f340 61 62 6c 65 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d able.")..(defun.transient--init-
5f360 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d common-commands.()...(transient-
5f380 2d 73 65 74 2d 6c 61 79 6f 75 74 0a 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e -set-layout....'transient-common
5f3a0 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 28 6c 69 73 74 20 28 65 76 61 6c 20 28 63 61 72 20 28 74 -commands....(list.(eval.(car.(t
5f3c0 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 63 68 69 6c 64 20 27 74 72 61 6e 73 69 65 6e 74 ransient--parse-child.'transient
5f3e0 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -common-commands................
5f400 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 74 72 61 .............................tra
5f420 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 29 29 0a 20 20 20 20 20 20 20 nsient-common-commands))........
5f440 20 20 20 20 20 20 20 20 74 29 29 29 0a 20 20 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 ........t)))...(defvar.transient
5f460 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 29 0a 20 20 28 64 65 66 76 61 -common-command-prefix)...(defva
5f480 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 74 72 2d 68 69 6e 74 2d 31 29 0a 20 20 28 64 r.transient--docstr-hint-1)...(d
5f4a0 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 74 72 2d 68 69 6e 74 2d 32 29 0a efvar.transient--docstr-hint-2).
5f4c0 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 74 72 2d 68 69 6e 74 2d 31 ..(setq.transient--docstr-hint-1
5f4e0 0a 20 20 20 20 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e .........(define-keymap.transien
5f500 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 0a 20 20 20 20 20 20 20 20 t-common-command-prefix.........
5f520 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 ..'transient-common-command-pref
5f540 69 78 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 74 72 2d 68 ix))...(setq.transient--docstr-h
5f560 69 6e 74 2d 32 0a 20 20 20 20 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 6d 61 70 20 28 63 6f int-2.........(define-keymap.(co
5f580 6e 63 61 74 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 ncat.transient-common-command-pr
5f5a0 65 66 69 78 20 22 20 74 22 29 0a 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d efix.".t")...........'transient-
5f5c0 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 29 29 29 0a 0a 28 64 65 66 63 75 73 74 6f 6d 20 74 72 61 toggle-common)))..(defcustom.tra
5f5e0 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 20 22 43 2d nsient-common-command-prefix."C-
5f600 78 22 0a 20 20 22 54 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 20 66 6f 72 20 6d 6f x"..."The.prefix.key.used.for.mo
5f620 73 74 20 63 6f 6d 6d 61 6e 64 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20 6d 65 6e 75 73 2e st.commands.common.to.all.menus.
5f640 0a 0a 53 6f 6d 65 20 73 68 61 72 65 64 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 76 61 69 6c ..Some.shared.commands.are.avail
5f660 61 62 6c 65 20 69 6e 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 73 2c 20 6d 6f 73 able.in.all.transient.menus,.mos
5f680 74 20 6f 66 0a 77 68 69 63 68 20 73 68 61 72 65 20 61 20 63 6f 6d 6d 6f 6e 20 70 72 65 66 69 78 t.of.which.share.a.common.prefix
5f6a0 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 69 73 20 6f 70 74 69 6f 6e 2e 20 20 42 79 20 64 .specified.by.this.option...By.d
5f6c0 65 66 61 75 6c 74 20 74 68 65 0a 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 73 65 20 73 68 efault.the.bindings.for.these.sh
5f6e0 61 72 65 64 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6f 6e 6c 79 20 73 68 6f 77 6e 20 61 66 74 ared.commands.are.only.shown.aft
5f700 65 72 20 70 72 65 73 73 69 6e 67 20 74 68 61 74 0a 70 72 65 66 69 78 20 6b 65 79 20 61 6e 64 20 er.pressing.that.prefix.key.and.
5f720 62 65 66 6f 72 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 61 74 20 75 70 20 77 69 74 68 20 61 20 before.following.that.up.with.a.
5f740 76 61 6c 69 64 20 6b 65 79 20 62 69 6e 64 69 6e 67 2e 0a 0a 46 6f 72 20 68 69 73 74 6f 72 69 63 valid.key.binding...For.historic
5f760 20 72 65 61 73 6f 6e 73 20 5c 5c 60 43 2d 78 27 20 69 73 20 75 73 65 64 20 62 79 20 64 65 66 61 .reasons.\\`C-x'.is.used.by.defa
5f780 75 6c 74 2c 20 62 75 74 20 75 73 65 72 73 20 61 72 65 0a 65 6e 63 6f 75 72 61 67 65 64 20 74 6f ult,.but.users.are.encouraged.to
5f7a0 20 70 69 63 6b 20 61 6e 6f 74 68 65 72 20 6b 65 79 2c 20 70 72 65 66 65 72 61 62 6c 79 20 6f 6e .pick.another.key,.preferably.on
5f7c0 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 63 6f 6d 6d 6f 6e 6c 79 20 75 73 65 64 0a 69 6e 20 45 e.that.is.not.commonly.used.in.E
5f7e0 6d 61 63 73 20 62 75 74 20 69 73 20 73 74 69 6c 6c 20 63 6f 6e 76 65 6e 69 65 6e 74 20 74 6f 20 macs.but.is.still.convenient.to.
5f800 74 68 65 6d 2e 20 20 53 65 65 20 69 6e 66 6f 20 6e 6f 64 65 20 60 28 74 72 61 6e 73 69 65 6e 74 them...See.info.node.`(transient
5f820 29 0a 43 6f 6d 6d 6f 6e 20 53 75 66 66 69 78 20 43 6f 6d 6d 61 6e 64 73 27 2e 22 0a 20 20 3a 74 ).Common.Suffix.Commands'."...:t
5f840 79 70 65 20 27 6b 65 79 0a 20 20 3a 69 6e 69 74 69 61 6c 69 7a 65 20 28 6c 61 6d 62 64 61 20 28 ype.'key...:initialize.(lambda.(
5f860 73 79 6d 62 6f 6c 20 65 78 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 75 73 symbol.exp).................(cus
5f880 74 6f 6d 2d 69 6e 69 74 69 61 6c 69 7a 65 2d 64 65 66 61 75 6c 74 20 73 79 6d 62 6f 6c 20 65 78 tom-initialize-default.symbol.ex
5f8a0 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 p).................(transient--i
5f8c0 6e 69 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 29 29 0a 20 20 3a 73 65 74 20 28 6c 61 nit-common-commands))...:set.(la
5f8e0 6d 62 64 61 20 28 73 79 6d 62 6f 6c 20 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 28 73 65 mbda.(symbol.value)..........(se
5f900 74 2d 64 65 66 61 75 6c 74 20 73 79 6d 62 6f 6c 20 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 t-default.symbol.value).........
5f920 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 .(transient--init-common-command
5f940 73 29 29 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 70 s)))..(defvar-keymap.transient-p
5f960 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 4f 6e 65 20 opup-navigation-map...:doc."One.
5f980 6f 66 20 74 68 65 20 6b 65 79 6d 61 70 73 20 75 73 65 64 20 77 68 65 6e 20 6d 65 6e 75 20 6e 61 of.the.keymaps.used.when.menu.na
5f9a0 76 69 67 61 74 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 2e 0a 53 65 65 20 60 74 72 61 6e 73 69 vigation.is.enabled..See.`transi
5f9c0 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 27 2e 22 0a 20 ent-enable-popup-navigation'."..
5f9e0 20 22 3c 64 6f 77 6e 2d 6d 6f 75 73 65 2d 31 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 6e 6f ."<down-mouse-1>".#'transient-no
5fa00 6f 70 0a 20 20 22 3c 75 70 3e 22 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 62 61 63 6b 77 61 op..."<up>"...#'transient-backwa
5fa20 72 64 2d 62 75 74 74 6f 6e 0a 20 20 22 3c 64 6f 77 6e 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 rd-button..."<down>".#'transient
5fa40 2d 66 6f 72 77 61 72 64 2d 62 75 74 74 6f 6e 0a 20 20 22 43 2d 72 22 20 20 20 20 23 27 74 72 61 -forward-button..."C-r"....#'tra
5fa60 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 62 61 63 6b 77 61 72 64 0a 20 20 22 43 2d 73 22 20 nsient-isearch-backward..."C-s".
5fa80 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 66 6f 72 77 61 72 64 0a 20 ...#'transient-isearch-forward..
5faa0 20 22 4d 2d 52 45 54 22 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f ."M-RET"..#'transient-push-butto
5fac0 6e 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 62 75 74 n)..(defvar-keymap.transient-but
5fae0 74 6f 6e 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 4f 6e 65 20 6f 66 20 74 68 65 20 6b 65 79 6d 61 ton-map...:doc."One.of.the.keyma
5fb00 70 73 20 75 73 65 64 20 77 68 65 6e 20 6d 65 6e 75 20 6e 61 76 69 67 61 74 69 6f 6e 20 69 73 20 ps.used.when.menu.navigation.is.
5fb20 65 6e 61 62 6c 65 64 2e 0a 53 65 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 enabled..See.`transient-enable-p
5fb40 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 27 2e 22 0a 20 20 22 3c 6d 6f 75 73 65 2d 31 3e 22 opup-navigation'."..."<mouse-1>"
5fb60 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 0a 20 20 22 3c 6d 6f 75 .#'transient-push-button..."<mou
5fb80 73 65 2d 32 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 29 0a se-2>".#'transient-push-button).
5fba0 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 .(defvar-keymap.transient-resume
5fbc0 2d 6d 6f 64 65 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 4b 65 79 6d 61 70 20 66 6f 72 20 60 74 72 -mode-map...:doc."Keymap.for.`tr
5fbe0 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 2d 6d 6f 64 65 27 2e 0a 0a 54 68 69 73 20 6b 65 79 6d ansient-resume-mode'...This.keym
5fc00 61 70 20 72 65 6d 61 70 73 20 65 76 65 72 79 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 77 6f 75 ap.remaps.every.command.that.wou
5fc20 6c 64 20 75 73 75 61 6c 6c 79 20 6a 75 73 74 20 71 75 69 74 20 74 68 65 0a 64 6f 63 75 6d 65 6e ld.usually.just.quit.the.documen
5fc40 74 61 74 69 6f 6e 20 62 75 66 66 65 72 20 74 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 tation.buffer.to.`transient-resu
5fc60 6d 65 27 2c 20 77 68 69 63 68 20 61 64 64 69 74 69 6f 6e 61 6c 6c 79 0a 72 65 73 75 6d 65 73 20 me',.which.additionally.resumes.
5fc80 74 68 65 20 73 75 73 70 65 6e 64 65 64 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 22 3c 72 65 the.suspended.transient."..."<re
5fca0 6d 61 70 3e 20 3c 4d 61 6e 2d 71 75 69 74 3e 22 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d map>.<Man-quit>"....#'transient-
5fcc0 72 65 73 75 6d 65 0a 20 20 22 3c 72 65 6d 61 70 3e 20 3c 49 6e 66 6f 2d 65 78 69 74 3e 22 20 20 resume..."<remap>.<Info-exit>"..
5fce0 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 0a 20 20 22 3c 72 65 6d 61 70 3e 20 3c .#'transient-resume..."<remap>.<
5fd00 71 75 69 74 2d 77 69 6e 64 6f 77 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 quit-window>".#'transient-resume
5fd20 29 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 )..(defvar-keymap.transient-pred
5fd40 69 63 61 74 65 2d 6d 61 70 0a 20 20 3a 64 6f 63 20 22 42 61 73 65 20 6b 65 79 6d 61 70 20 75 73 icate-map...:doc."Base.keymap.us
5fd60 65 64 20 74 6f 20 6d 61 70 20 63 6f 6d 6d 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 74 68 65 ed.to.map.common.commands.to.the
5fd80 69 72 20 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 2e 0a 0a 54 68 65 20 5c 22 74 72 ir.transient.behavior...The.\"tr
5fda0 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 5c 22 20 6f 66 20 61 20 63 6f 6d 6d 61 6e 64 20 ansient.behavior\".of.a.command.
5fdc0 63 6f 6e 74 72 6f 6c 73 2c 20 61 6d 6f 6e 67 20 6f 74 68 65 72 0a 74 68 69 6e 67 73 2c 20 77 68 controls,.among.other.things,.wh
5fde0 65 74 68 65 72 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 63 61 75 73 65 ether.invoking.the.command.cause
5fe00 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 62 65 0a 65 78 69 74 65 64 20 6f 72 20 s.the.transient.to.be.exited.or.
5fe20 6e 6f 74 2c 20 61 6e 64 20 77 68 65 74 68 65 72 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 not,.and.whether.infix.arguments
5fe40 20 61 72 65 20 65 78 70 6f 72 74 65 64 20 62 65 66 6f 72 65 0a 64 6f 69 6e 67 20 73 6f 2e 0a 0a .are.exported.before.doing.so...
5fe60 45 61 63 68 20 5c 22 6b 65 79 5c 22 20 69 73 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 Each.\"key\".is.a.command.that.i
5fe80 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6e 64 0a 74 s.common.to.all.transients.and.t
5fea0 68 61 74 20 69 73 20 62 6f 75 6e 64 20 69 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 27 2c hat.is.bound.in.`transient-map',
5fec0 20 60 74 72 61 6e 73 69 65 6e 74 2d 65 64 69 74 2d 6d 61 70 27 2c 0a 60 74 72 61 6e 73 69 65 6e .`transient-edit-map',.`transien
5fee0 74 2d 73 74 69 63 6b 79 2d 6d 61 70 27 20 61 6e 64 2f 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 2d t-sticky-map'.and/or.`transient-
5ff00 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 27 2e 0a 0a 45 61 63 68 20 62 69 6e 64 69 6e 67 20 69 common-command'...Each.binding.i
5ff20 73 20 61 20 5c 22 70 72 65 2d 63 6f 6d 6d 61 6e 64 5c 22 2c 20 61 20 66 75 6e 63 74 69 6f 6e 20 s.a.\"pre-command\",.a.function.
5ff40 74 68 61 74 20 63 6f 6e 74 72 6f 6c 73 20 74 68 65 0a 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 that.controls.the.transient.beha
5ff60 76 69 6f 72 20 6f 66 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 2e 0a vior.of.the.respective.command..
5ff80 0a 46 6f 72 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 72 65 .For.transient.commands.that.are
5ffa0 20 62 6f 75 6e 64 20 69 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 73 2c .bound.in.individual.transients,
5ffc0 0a 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 20 69 73 20 73 70 65 63 69 .the.transient.behavior.is.speci
5ffe0 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 20 60 3a 74 72 61 6e 73 69 65 6e 74 27 20 73 6c 6f 74 fied.using.the.`:transient'.slot
60000 0a 6f 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 6f 62 6a 65 63 74 2e 22 0a 20 .of.the.corresponding.object."..
60020 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 73 75 73 70 65 6e 64 3e 22 20 20 20 20 20 20 20 20 20 20 ."<transient-suspend>"..........
60040 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 6e 64 0a 20 20 22 3c 74 72 61 .#'transient--do-suspend..."<tra
60060 6e 73 69 65 6e 74 2d 68 65 6c 70 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 nsient-help>"..............#'tra
60080 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 73 65 nsient--do-stay..."<transient-se
600a0 74 2d 6c 65 76 65 6c 3e 22 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 t-level>".........#'transient--d
600c0 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 o-stay..."<transient-history-pre
600e0 76 3e 22 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 v>"......#'transient--do-stay...
60100 22 3c 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 6e 65 78 74 3e 22 20 20 20 20 20 20 "<transient-history-next>"......
60120 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 75 6e 69 76 65 72 73 #'transient--do-stay..."<univers
60140 61 6c 2d 61 72 67 75 6d 65 6e 74 3e 22 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 al-argument>"..........#'transie
60160 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 75 6e 69 76 65 72 73 61 6c 2d 61 72 67 75 6d 65 nt--do-stay..."<universal-argume
60180 6e 74 2d 6d 6f 72 65 3e 22 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 nt-more>".....#'transient--do-st
601a0 61 79 0a 20 20 22 3c 6e 65 67 61 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 3e 22 20 20 20 20 20 20 ay..."<negative-argument>"......
601c0 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d 69 6e 75 73 0a 20 20 22 3c 64 .....#'transient--do-minus..."<d
601e0 69 67 69 74 2d 61 72 67 75 6d 65 6e 74 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 igit-argument>"..............#'t
60200 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 6f 74 68 65 72 2d 66 72 61 6d ransient--do-stay..."<other-fram
60220 65 2d 70 72 65 66 69 78 3e 22 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d e-prefix>"..........#'transient-
60240 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 6f 74 68 65 72 2d 77 69 6e 64 6f 77 2d 70 72 65 66 69 78 -do-stay..."<other-window-prefix
60260 3e 22 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a >".........#'transient--do-stay.
60280 20 20 22 3c 74 6f 70 2d 6c 65 76 65 6c 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .."<top-level>".................
602a0 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 71 75 69 74 2d 61 6c 6c 0a 20 20 22 3c 74 ..#'transient--do-quit-all..."<t
602c0 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 3e 22 20 20 20 20 20 20 20 20 20 20 23 27 74 ransient-quit-all>"..........#'t
602e0 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 71 75 69 74 2d 61 6c 6c 0a 20 20 22 3c 74 72 61 6e 73 69 ransient--do-quit-all..."<transi
60300 65 6e 74 2d 71 75 69 74 2d 6f 6e 65 3e 22 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 ent-quit-one>"..........#'transi
60320 65 6e 74 2d 2d 64 6f 2d 71 75 69 74 2d 6f 6e 65 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 71 ent--do-quit-one..."<transient-q
60340 75 69 74 2d 73 65 71 3e 22 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d uit-seq>"..........#'transient--
60360 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 3e 22 20 20 20 20 do-stay..."<transient-show>"....
60380 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 ..........#'transient--do-stay..
603a0 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 75 70 64 61 74 65 3e 22 20 20 20 20 20 20 20 20 20 20 20 ."<transient-update>"...........
603c0 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 .#'transient--do-stay..."<transi
603e0 65 6e 74 2d 73 65 74 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 ent-set>"...............#'transi
60400 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 61 ent--do-call..."<transient-set-a
60420 6e 64 2d 65 78 69 74 3e 22 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 nd-exit>"......#'transient--do-e
60440 78 69 74 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 3e 22 20 20 20 20 20 20 20 20 xit..."<transient-save>"........
60460 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 0a 20 20 22 3c 74 ......#'transient--do-call..."<t
60480 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 61 6e 64 2d 65 78 69 74 3e 22 20 20 20 20 20 23 27 74 ransient-save-and-exit>".....#'t
604a0 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d ransient--do-exit..."<transient-
604c0 72 65 73 65 74 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d reset>".............#'transient-
604e0 2d 64 6f 2d 63 61 6c 6c 0a 20 20 22 3c 64 65 73 63 72 69 62 65 2d 6b 65 79 2d 62 72 69 65 66 6c -do-call..."<describe-key-briefl
60500 79 3e 22 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a y>"........#'transient--do-stay.
60520 20 20 22 3c 64 65 73 63 72 69 62 65 2d 6b 65 79 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .."<describe-key>"..............
60540 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 ..#'transient--do-stay..."<trans
60560 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 3e 22 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 ient-scroll-up>".........#'trans
60580 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f ient--do-stay..."<transient-scro
605a0 6c 6c 2d 64 6f 77 6e 3e 22 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d ll-down>".......#'transient--do-
605c0 73 74 61 79 0a 20 20 22 3c 6d 77 68 65 65 6c 2d 73 63 72 6f 6c 6c 3e 22 20 20 20 20 20 20 20 20 stay..."<mwheel-scroll>"........
605e0 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c .......#'transient--do-stay..."<
60600 73 63 72 6f 6c 6c 2d 62 61 72 2d 74 6f 6f 6c 6b 69 74 2d 73 63 72 6f 6c 6c 3e 22 20 20 20 23 27 scroll-bar-toolkit-scroll>"...#'
60620 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 transient--do-stay..."<transient
60640 2d 6e 6f 6f 70 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 -noop>"..............#'transient
60660 2d 2d 64 6f 2d 6e 6f 6f 70 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 6d 6f 75 73 65 2d 70 75 --do-noop..."<transient-mouse-pu
60680 73 68 2d 62 75 74 74 6f 6e 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d 6f 76 65 sh-button>".#'transient--do-move
606a0 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 3e 22 20 20 20 20 ..."<transient-push-button>"....
606c0 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 70 75 73 68 2d 62 75 74 74 6f 6e 0a 20 ...#'transient--do-push-button..
606e0 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 62 61 63 6b 77 61 72 64 2d 62 75 74 74 6f 6e 3e 22 20 20 ."<transient-backward-button>"..
60700 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d 6f 76 65 0a 20 20 22 3c 74 72 61 6e 73 69 .#'transient--do-move..."<transi
60720 65 6e 74 2d 66 6f 72 77 61 72 64 2d 62 75 74 74 6f 6e 3e 22 20 20 20 20 23 27 74 72 61 6e 73 69 ent-forward-button>"....#'transi
60740 65 6e 74 2d 2d 64 6f 2d 6d 6f 76 65 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 ent--do-move..."<transient-isear
60760 63 68 2d 62 61 63 6b 77 61 72 64 3e 22 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d ch-backward>"..#'transient--do-m
60780 6f 76 65 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 66 6f 72 77 61 72 ove..."<transient-isearch-forwar
607a0 64 3e 22 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d 6f 76 65 0a 20 20 22 3c 74 d>"...#'transient--do-move..."<t
607c0 72 61 6e 73 69 65 6e 74 2d 63 6f 70 79 2d 6d 65 6e 75 2d 74 65 78 74 3e 22 20 20 20 20 23 27 74 ransient-copy-menu-text>"....#'t
607e0 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 0a 20 20 22 3c 74 72 61 6e 73 69 65 6e 74 2d ransient--do-stay..."<transient-
60800 74 6f 67 67 6c 65 2d 64 6f 63 73 74 72 69 6e 67 73 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d toggle-docstrings>".#'transient-
60820 2d 64 6f 2d 73 74 61 79 0a 20 20 3b 3b 20 49 66 20 61 20 76 61 6c 69 64 20 62 75 74 20 69 6e 63 -do-stay...;;.If.a.valid.but.inc
60840 6f 6d 70 6c 65 74 65 20 70 72 65 66 69 78 20 73 65 71 75 65 6e 63 65 20 69 73 20 66 6f 6c 6c 6f omplete.prefix.sequence.is.follo
60860 77 65 64 20 62 79 0a 20 20 3b 3b 20 61 6e 20 75 6e 62 6f 75 6e 64 20 6b 65 79 2c 20 74 68 65 6e wed.by...;;.an.unbound.key,.then
60880 20 45 6d 61 63 73 20 63 61 6c 6c 73 20 74 68 65 20 60 75 6e 64 65 66 69 6e 65 64 27 20 63 6f 6d .Emacs.calls.the.`undefined'.com
608a0 6d 61 6e 64 0a 20 20 3b 3b 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 20 73 65 74 20 60 74 68 69 73 mand...;;.but.does.not.set.`this
608c0 2d 63 6f 6d 6d 61 6e 64 27 2c 20 60 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e -command',.`this-original-comman
608e0 64 27 0a 20 20 3b 3b 20 6f 72 20 60 72 65 61 6c 2d 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 27 20 61 d'...;;.or.`real-this-command'.a
60900 63 63 6f 72 64 69 6e 67 6c 79 2e 20 20 49 6e 73 74 65 61 64 20 74 68 65 79 20 61 72 65 20 6e 69 ccordingly...Instead.they.are.ni
60920 6c 2e 0a 20 20 22 3c 6e 69 6c 3e 22 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l...."<nil>"....................
60940 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 77 61 72 6e 0a 20 20 3b 3b 20 42 .....#'transient--do-warn...;;.B
60960 6f 75 6e 64 20 74 6f 20 74 68 65 20 60 6d 6f 75 73 65 2d 6d 6f 76 65 6d 65 6e 74 27 20 65 76 65 ound.to.the.`mouse-movement'.eve
60980 6e 74 2c 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 73 69 6d 69 6c 61 72 0a 20 20 3b 3b nt,.this.command.is.similar...;;
609a0 20 74 6f 20 60 69 67 6e 6f 72 65 27 2e 0a 20 20 22 3c 69 67 6e 6f 72 65 2d 70 72 65 73 65 72 76 .to.`ignore'...."<ignore-preserv
609c0 69 6e 67 2d 6b 69 6c 6c 2d 72 65 67 69 6f 6e 3e 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 ing-kill-region>".#'transient--d
609e0 6f 2d 6e 6f 6f 70 29 0a 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e o-noop)..(defvar.transient--tran
60a00 73 69 65 6e 74 2d 6d 61 70 20 6e 69 6c 29 0a 28 64 65 66 76 61 72 20 74 72 61 6e 73 69 65 6e 74 sient-map.nil).(defvar.transient
60a20 2d 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 20 6e 69 6c 29 0a 28 64 65 66 76 61 72 20 74 72 61 --predicate-map.nil).(defvar.tra
60a40 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 20 6e 69 6c 29 0a 28 64 65 66 76 nsient--redisplay-map.nil).(defv
60a60 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 20 6e 69 6c 29 ar.transient--redisplay-key.nil)
60a80 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 73 68 2d 6b 65 79 6d 61 70 20 ..(defun.transient--push-keymap.
60aa0 28 76 61 72 29 0a 20 20 28 6c 65 74 20 28 28 6d 61 70 20 28 73 79 6d 62 6f 6c 2d 76 61 6c 75 65 (var)...(let.((map.(symbol-value
60ac0 20 76 61 72 29 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 22 20 .var))).....(transient--debug.".
60ae0 20 20 20 20 70 75 73 68 20 25 73 25 73 22 20 76 61 72 20 28 69 66 20 6d 61 70 20 22 22 20 22 20 ....push.%s%s".var.(if.map."".".
60b00 56 4f 49 44 22 29 29 0a 20 20 20 20 28 77 68 65 6e 20 6d 61 70 0a 20 20 20 20 20 20 28 77 69 74 VOID")).....(when.map.......(wit
60b20 68 2d 64 65 6d 6f 74 65 64 2d 65 72 72 6f 72 73 20 22 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 73 h-demoted-errors."transient--pus
60b40 68 2d 6b 65 79 6d 61 70 3a 20 25 53 22 0a 20 20 20 20 20 20 20 20 28 69 6e 74 65 72 6e 61 6c 2d h-keymap:.%S".........(internal-
60b60 70 75 73 68 2d 6b 65 79 6d 61 70 20 6d 61 70 20 27 6f 76 65 72 72 69 64 69 6e 67 2d 74 65 72 6d push-keymap.map.'overriding-term
60b80 69 6e 61 6c 2d 6c 6f 63 61 6c 2d 6d 61 70 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e inal-local-map)))))..(defun.tran
60ba0 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 28 76 61 72 29 0a 20 20 28 6c 65 74 20 28 sient--pop-keymap.(var)...(let.(
60bc0 28 6d 61 70 20 28 73 79 6d 62 6f 6c 2d 76 61 6c 75 65 20 76 61 72 29 29 29 0a 20 20 20 20 28 77 (map.(symbol-value.var))).....(w
60be0 68 65 6e 20 6d 61 70 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 hen.map.......(transient--debug.
60c00 22 20 20 20 20 20 70 6f 70 20 20 25 73 22 20 76 61 72 29 0a 20 20 20 20 20 20 28 77 69 74 68 2d ".....pop..%s".var).......(with-
60c20 64 65 6d 6f 74 65 64 2d 65 72 72 6f 72 73 20 22 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b demoted-errors."transient--pop-k
60c40 65 79 6d 61 70 3a 20 25 53 22 0a 20 20 20 20 20 20 20 20 28 69 6e 74 65 72 6e 61 6c 2d 70 6f 70 eymap:.%S".........(internal-pop
60c60 2d 6b 65 79 6d 61 70 20 6d 61 70 20 27 6f 76 65 72 72 69 64 69 6e 67 2d 74 65 72 6d 69 6e 61 6c -keymap.map.'overriding-terminal
60c80 2d 6c 6f 63 61 6c 2d 6d 61 70 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e -local-map)))))..(defun.transien
60ca0 74 2d 2d 6d 61 6b 65 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 28 29 0a 20 20 28 6c 65 74 20 t--make-transient-map.()...(let.
60cc0 28 28 6d 61 70 20 28 6d 61 6b 65 2d 73 70 61 72 73 65 2d 6b 65 79 6d 61 70 29 29 29 0a 20 20 20 ((map.(make-sparse-keymap)))....
60ce0 20 28 63 6f 6e 64 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 0a 20 20 20 20 20 20 20 .(cond.(transient--editp........
60d00 20 20 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 28 63 6f 6e 63 61 74 20 74 72 61 6e ....(keymap-set.map.(concat.tran
60d20 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 20 22 20 6c 22 sient-common-command-prefix.".l"
60d40 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 23 27 74 72 61 6e 73 )........................#'trans
60d60 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 2d ient-set-level)............(set-
60d80 6b 65 79 6d 61 70 2d 70 61 72 65 6e 74 20 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 65 64 69 74 keymap-parent.map.transient-edit
60da0 2d 6d 61 70 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 73 65 74 2d 6b 65 79 6d 61 70 2d 70 61 -map))...........((set-keymap-pa
60dc0 72 65 6e 74 20 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 29 29 0a 20 20 20 20 28 64 rent.map.transient-map))).....(d
60de0 6f 6c 69 73 74 20 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 0a olist.(obj.transient--suffixes).
60e00 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 6f 72 65 66 20 6f 62 6a 20 6b 65 79 29 29 ......(let.((key.(oref.obj.key))
60e20 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 76 65 63 74 6f 72 70 20 6b 65 79 29 0a 20 20 ).........(when.(vectorp.key)...
60e40 20 20 20 20 20 20 20 20 28 73 65 74 71 20 6b 65 79 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 69 ........(setq.key.(key-descripti
60e60 6f 6e 20 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 6b 65 79 on.key))...........(oset.obj.key
60e80 20 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 .key)).........(when.transient-s
60ea0 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 ubstitute-key-function..........
60ec0 20 28 73 65 74 71 20 6b 65 79 20 28 73 61 76 65 2d 6d 61 74 63 68 2d 64 61 74 61 0a 20 20 20 20 .(setq.key.(save-match-data.....
60ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 74 72 61 6e 73 ..................(funcall.trans
60f00 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 20 6f 62 6a ient-substitute-key-function.obj
60f20 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 6b 65 79 20 6b 65 79 29 )))...........(oset.obj.key.key)
60f40 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 2a 20 28 28 6b 62 64 20 28 6b 62 64 20 6b 65 79 29 29 ).........(let*.((kbd.(kbd.key))
60f60 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6d 64 20 28 6f 72 65 66 20 6f 62 6a 20 63 ................(cmd.(oref.obj.c
60f80 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6c 74 20 28 74 72 ommand))................(alt.(tr
60fa0 61 6e 73 69 65 6e 74 2d 2d 6c 6f 6f 6b 75 70 2d 6b 65 79 20 6d 61 70 20 6b 62 64 29 29 29 0a 20 ansient--lookup-key.map.kbd)))..
60fc0 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 20 28 28 6e 6f 74 20 61 6c 74 29 0a 20 20 20 20 20 20 .........(cond.((not.alt).......
60fe0 20 20 20 20 20 20 20 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 20 6d 61 70 20 6b 62 64 20 63 ...........(define-key.map.kbd.c
61000 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 65 71 20 61 6c 74 20 63 6d md)).................((eq.alt.cm
61020 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6f 72 65 66 20 6f 62 6a 20 69 d)).................((oref.obj.i
61040 6e 61 63 74 69 76 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6f 72 65 66 nactive)).................((oref
61060 20 6f 62 6a 20 69 6e 61 70 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 61 .obj.inapt)).................((a
61080 6e 64 2d 6c 65 74 2a 20 28 28 61 6c 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d nd-let*.((alt.(transient-suffix-
610a0 6f 62 6a 65 63 74 20 61 6c 74 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 object.alt)))...................
610c0 20 28 6f 72 20 28 6f 72 65 66 20 61 6c 74 20 69 6e 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 20 .(or.(oref.alt.inactive)........
610e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 61 6c 74 20 69 6e 61 70 74 29 ................(oref.alt.inapt)
61100 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 20 ))..................(define-key.
61120 6d 61 70 20 6b 62 64 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 map.kbd.cmd)).................(t
61140 72 61 6e 73 69 65 6e 74 2d 64 65 74 65 63 74 2d 6b 65 79 2d 63 6f 6e 66 6c 69 63 74 73 0a 20 20 ransient-detect-key-conflicts...
61160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 43 61 6e 6e 6f 74 20 62 69 ...............(error."Cannot.bi
61180 6e 64 20 25 53 20 74 6f 20 25 73 20 61 6e 64 20 61 6c 73 6f 20 25 73 22 0a 20 20 20 20 20 20 20 nd.%S.to.%s.and.also.%s"........
611a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 74 72 69 6e 67 2d 74 72 69 6d 20 6b 65 .................(string-trim.ke
611c0 79 29 20 63 6d 64 20 61 6c 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 64 y).cmd.alt)).................((d
611e0 65 66 69 6e 65 2d 6b 65 79 20 6d 61 70 20 6b 62 64 20 63 6d 64 29 29 29 29 29 29 0a 20 20 20 20 efine-key.map.kbd.cmd)))))).....
61200 28 77 68 65 6e 2d 6c 65 74 20 28 28 62 20 28 6b 65 79 6d 61 70 2d 6c 6f 6f 6b 75 70 20 6d 61 70 (when-let.((b.(keymap-lookup.map
61220 20 22 2d 22 29 29 29 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 3c 6b 70 2d 73 75 62 ."-"))).(keymap-set.map."<kp-sub
61240 74 72 61 63 74 3e 22 20 62 29 29 0a 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 62 20 28 6b tract>".b)).....(when-let.((b.(k
61260 65 79 6d 61 70 2d 6c 6f 6f 6b 75 70 20 6d 61 70 20 22 3d 22 29 29 29 20 28 6b 65 79 6d 61 70 2d eymap-lookup.map."="))).(keymap-
61280 73 65 74 20 6d 61 70 20 22 3c 6b 70 2d 65 71 75 61 6c 3e 22 20 62 29 29 0a 20 20 20 20 28 77 68 set.map."<kp-equal>".b)).....(wh
612a0 65 6e 2d 6c 65 74 20 28 28 62 20 28 6b 65 79 6d 61 70 2d 6c 6f 6f 6b 75 70 20 6d 61 70 20 22 2b en-let.((b.(keymap-lookup.map."+
612c0 22 29 29 29 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 6d 61 70 20 22 3c 6b 70 2d 61 64 64 3e 22 20 "))).(keymap-set.map."<kp-add>".
612e0 62 29 29 0a 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 b)).....(when.transient-enable-p
61300 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 0a 20 20 20 20 20 20 3b 3b 20 60 74 72 61 6e 73 69 opup-navigation.......;;.`transi
61320 65 6e 74 2d 2d 6d 61 6b 65 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 27 20 6d 61 70 73 20 6f 6e ent--make-redisplay-map'.maps.on
61340 6c 79 20 6f 76 65 72 20 62 69 6e 64 69 6e 67 73 20 74 68 61 74 20 61 72 65 0a 20 20 20 20 20 20 ly.over.bindings.that.are.......
61360 3b 3b 20 64 69 72 65 63 74 6c 79 20 69 6e 20 74 68 65 20 62 61 73 65 20 6b 65 79 6d 61 70 2c 20 ;;.directly.in.the.base.keymap,.
61380 73 6f 20 74 68 61 74 20 63 61 6e 6e 6f 74 20 62 65 20 61 20 63 6f 6d 70 6f 73 65 64 20 6b 65 79 so.that.cannot.be.a.composed.key
613a0 6d 61 70 2e 0a 20 20 20 20 20 20 28 73 65 74 2d 6b 65 79 6d 61 70 2d 70 61 72 65 6e 74 0a 20 20 map........(set-keymap-parent...
613c0 20 20 20 20 20 6d 61 70 20 28 6d 61 6b 65 2d 63 6f 6d 70 6f 73 65 64 2d 6b 65 79 6d 61 70 0a 20 .....map.(make-composed-keymap..
613e0 20 20 20 20 20 20 20 20 20 20 20 28 6b 65 79 6d 61 70 2d 70 61 72 65 6e 74 20 6d 61 70 29 0a 20 ...........(keymap-parent.map)..
61400 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 70 6f 70 75 70 2d 6e 61 76 69 67 ...........transient-popup-navig
61420 61 74 69 6f 6e 2d 6d 61 70 29 29 29 0a 20 20 20 20 6d 61 70 29 29 0a 0a 28 64 65 66 75 6e 20 74 ation-map))).....map))..(defun.t
61440 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 6b 65 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 20 28 29 0a ransient--make-predicate-map.().
61460 20 20 28 6c 65 74 2a 20 28 28 64 65 66 61 75 6c 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 ..(let*.((default.(transient--re
61480 73 6f 6c 76 65 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 solve-pre-command...............
614a0 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 74 72 61 .....(oref.transient--prefix.tra
614c0 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 72 65 74 75 72 nsient-suffix)))..........(retur
614e0 6e 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 20 28 6f 72 65 66 20 74 72 n.(and.transient--stack.(oref.tr
61500 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 72 65 74 75 72 6e 29 29 29 0a 20 20 20 20 20 20 ansient--prefix.return))).......
61520 20 20 20 28 6d 61 70 20 28 6d 61 6b 65 2d 73 70 61 72 73 65 2d 6b 65 79 6d 61 70 29 29 29 0a 20 ...(map.(make-sparse-keymap)))..
61540 20 20 20 28 73 65 74 2d 6b 65 79 6d 61 70 2d 70 61 72 65 6e 74 20 6d 61 70 20 74 72 61 6e 73 69 ...(set-keymap-parent.map.transi
61560 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 29 0a 20 20 20 20 28 77 68 65 6e 20 28 6f 72 ent-predicate-map).....(when.(or
61580 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 .(and.(slot-boundp.transient--pr
615a0 65 66 69 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 29 0a 20 20 efix.'transient-switch-frame)...
615c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 .................(transient--res
615e0 6f 6c 76 65 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 olve-pre-command................
61600 20 20 20 20 20 28 6e 6f 74 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 .....(not.(oref.transient--prefi
61620 78 20 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 29 29 29 29 0a 20 20 20 x.transient-switch-frame))))....
61640 20 20 20 20 20 20 20 20 20 20 20 28 6d 65 6d 71 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 ...........(memq.(transient--res
61660 6f 6c 76 65 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 olve-pre-command................
61680 20 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 74 72 ......(oref.transient--prefix.tr
616a0 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 ansient-non-suffix))............
616c0 20 20 20 20 20 20 20 20 20 27 28 6e 69 6c 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 77 61 72 .........'(nil.transient--do-war
616e0 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6e 6f 6f 70 29 29 29 0a 20 20 20 20 20 20 28 64 n.transient--do-noop))).......(d
61700 65 66 69 6e 65 2d 6b 65 79 20 6d 61 70 20 5b 68 61 6e 64 6c 65 2d 73 77 69 74 63 68 2d 66 72 61 efine-key.map.[handle-switch-fra
61720 6d 65 5d 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 6e 64 29 29 0a 20 20 me].#'transient--do-suspend))...
61740 20 20 28 64 6f 6c 69 73 74 20 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 ..(dolist.(obj.transient--suffix
61760 65 73 29 0a 20 20 20 20 20 20 28 6c 65 74 2a 20 28 28 63 6d 64 20 28 6f 72 65 66 20 6f 62 6a 20 es).......(let*.((cmd.(oref.obj.
61780 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 64 20 28 76 65 63 74 command))..............(id.(vect
617a0 6f 72 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6b 69 6e 64 20 28 63 6f 6e or.cmd))..............(kind.(con
617c0 64 20 28 28 67 65 74 20 63 6d 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 20 d.((get.cmd.'transient--prefix).
617e0 20 20 20 27 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ...'prefix).....................
61800 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 70 20 6f 62 6a 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 .....((cl-typep.obj.'transient-i
61820 6e 66 69 78 29 20 27 69 6e 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nfix).'infix)...................
61840 20 20 20 20 20 20 20 28 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .......(t.......................
61860 20 20 20 20 20 20 20 20 27 73 75 66 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ........'suffix)))..............
61880 28 70 72 65 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 (pre.(cond....................((
618a0 6f 72 65 66 20 6f 62 6a 20 69 6e 61 63 74 69 76 65 29 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 oref.obj.inactive).nil).........
618c0 20 20 20 20 20 20 20 20 20 20 20 28 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 29 20 23 27 74 ...........((oref.obj.inapt).#'t
618e0 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 77 61 72 6e 2d 69 6e 61 70 74 29 0a 20 20 20 20 20 20 20 ransient--do-warn-inapt)........
61900 20 20 20 20 20 20 20 20 20 20 20 20 28 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 74 ............((slot-boundp.obj.'t
61920 72 61 6e 73 69 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 ransient).....................(p
61940 63 61 73 65 20 28 6c 69 73 74 20 6b 69 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 case.(list.kind.................
61960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 .................(transient--res
61980 6f 6c 76 65 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 olve-pre-command................
619a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 74 72 61 ...................(oref.obj.tra
619c0 6e 73 69 65 6e 74 29 20 6e 69 6c 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nsient).nil.t)..................
619e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 29 0a 20 20 20 20 20 20 20 20 ................return).........
61a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 70 72 65 66 69 78 20 20 20 74 20 20 2c 5f 29 ..............(`(prefix...t..,_)
61a20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 65 29 0a 20 20 20 20 20 20 .#'transient--do-recurse).......
61a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 70 72 65 66 69 78 20 6e 69 6c 20 20 2c ................(`(prefix.nil..,
61a60 5f 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 6b 29 0a 20 20 20 20 20 20 _).#'transient--do-stack).......
61a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 69 6e 66 69 78 20 20 20 20 74 20 20 2c ................(`(infix....t..,
61aa0 5f 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 29 0a 20 20 20 20 20 20 20 _).#'transient--do-stay)........
61ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 73 75 66 66 69 78 20 20 20 74 20 20 2c 5f ...............(`(suffix...t..,_
61ae0 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 29 0a 20 20 20 20 20 20 20 20 ).#'transient--do-call).........
61b00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 27 28 73 75 66 66 69 78 20 6e 69 6c 20 20 20 74 29 ..............('(suffix.nil...t)
61b20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 74 75 72 6e 29 0a 20 20 20 20 20 20 20 .#'transient--do-return)........
61b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 2c 5f 20 20 20 20 20 6e 69 6c 20 20 2c 5f ...............(`(,_.....nil..,_
61b60 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 ).#'transient--do-exit).........
61b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 2c 5f 20 20 20 20 20 2c 64 6f 20 20 2c 5f 29 ..............(`(,_.....,do..,_)
61ba0 20 64 6f 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6e 6f 74 20 .do)))....................((not.
61bc0 28 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d (lookup-key.transient-predicate-
61be0 6d 61 70 20 69 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 63 map.id)).....................(pc
61c00 61 73 65 20 28 6c 69 73 74 20 6b 69 6e 64 20 64 65 66 61 75 6c 74 20 72 65 74 75 72 6e 29 0a 20 ase.(list.kind.default.return)..
61c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 70 72 65 66 69 78 20 2c .....................(`(prefix.,
61c40 28 6f 72 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 20 27 74 72 61 6e 73 69 65 (or.'transient--do-stay.'transie
61c60 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 29 20 2c 5f 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nt--do-call).,_)................
61c80 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 65 29 ........#'transient--do-recurse)
61ca0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 70 72 65 66 69 78 .......................(`(prefix
61cc0 20 20 20 74 20 20 2c 5f 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 ...t..,_).#'transient--do-recurs
61ce0 65 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 60 28 70 72 65 66 e).......................(`(pref
61d00 69 78 20 20 2c 5f 20 20 2c 5f 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 ix..,_..,_).#'transient--do-stac
61d20 6b 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 60 28 69 6e 66 69 k).......................(`(infi
61d40 78 20 20 20 2c 5f 20 20 2c 5f 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 x...,_..,_).#'transient--do-stay
61d60 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 60 28 73 75 66 66 69 ).......................(`(suffi
61d80 78 20 20 20 74 20 20 2c 5f 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 29 x...t..,_).#'transient--do-call)
61da0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 27 28 73 75 66 66 69 78 .......................('(suffix
61dc0 20 6e 69 6c 20 20 20 74 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 74 75 72 6e .nil...t).#'transient--do-return
61de0 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 60 28 73 75 66 66 69 ).......................(`(suffi
61e00 78 20 6e 69 6c 20 6e 69 6c 29 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 29 x.nil.nil).#'transient--do-exit)
61e20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 60 28 73 75 66 66 69 78 .......................(`(suffix
61e40 20 2c 64 6f 20 20 2c 5f 29 20 64 6f 29 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e .,do..,_).do)))))).........(when
61e60 20 70 72 65 0a 20 20 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 61 6c 74 20 28 6c 6f .pre...........(if-let.((alt.(lo
61e80 6f 6b 75 70 2d 6b 65 79 20 6d 61 70 20 69 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 okup-key.map.id)))..............
61ea0 20 28 75 6e 6c 65 73 73 20 28 65 71 20 61 6c 74 20 70 72 65 29 0a 20 20 20 20 20 20 20 20 20 20 .(unless.(eq.alt.pre)...........
61ec0 20 20 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 20 6d 61 70 20 28 76 63 6f 6e 63 61 74 20 28 ......(define-key.map.(vconcat.(
61ee0 6f 72 65 66 20 6f 62 6a 20 6b 65 79 29 20 69 64 29 20 70 72 65 29 29 0a 20 20 20 20 20 20 20 20 oref.obj.key).id).pre)).........
61f00 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 20 6d 61 70 20 69 64 20 70 72 65 29 29 29 29 29 0a ....(define-key.map.id.pre))))).
61f20 20 20 20 20 6d 61 70 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 6b ....map))..(defun.transient--mak
61f40 65 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 20 28 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 e-redisplay-map.()...(setq.trans
61f60 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 0a 20 20 20 20 20 20 20 20 28 70 63 61 ient--redisplay-key.........(pca
61f80 73 65 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 28 27 74 72 61 6e se.this-command...........('tran
61fa0 73 69 65 6e 74 2d 75 70 64 61 74 65 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 sient-update............(setq.tr
61fc0 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 ansient--showp.t)............(le
61fe0 74 20 28 28 6b 65 79 73 20 28 6c 69 73 74 69 66 79 2d 6b 65 79 2d 73 65 71 75 65 6e 63 65 20 28 t.((keys.(listify-key-sequence.(
62000 74 68 69 73 2d 73 69 6e 67 6c 65 2d 63 6f 6d 6d 61 6e 64 2d 72 61 77 2d 6b 65 79 73 29 29 29 29 this-single-command-raw-keys))))
62020 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 75 6e 72 65 61 64 2d 63 6f 6d 6d 61 ..............(setq.unread-comma
62040 6e 64 2d 65 76 65 6e 74 73 20 28 6d 61 70 63 61 72 20 28 6c 61 6d 62 64 61 20 28 6b 65 79 29 20 nd-events.(mapcar.(lambda.(key).
62060 28 63 6f 6e 73 20 74 20 6b 65 79 29 29 20 6b 65 79 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 (cons.t.key)).keys))............
62080 20 20 6b 65 79 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 27 74 72 61 6e 73 69 65 6e 74 2d 71 ..keys))...........('transient-q
620a0 75 69 74 2d 73 65 71 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 75 6e 72 65 61 64 2d uit-seq............(setq.unread-
620c0 63 6f 6d 6d 61 6e 64 2d 65 76 65 6e 74 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 command-events..................
620e0 28 62 75 74 6c 61 73 74 20 28 6c 69 73 74 69 66 79 2d 6b 65 79 2d 73 65 71 75 65 6e 63 65 0a 20 (butlast.(listify-key-sequence..
62100 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 74 68 69 73 2d ..........................(this-
62120 73 69 6e 67 6c 65 2d 63 6f 6d 6d 61 6e 64 2d 72 61 77 2d 6b 65 79 73 29 29 0a 20 20 20 20 20 20 single-command-raw-keys)).......
62140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 32 29 29 0a 20 20 20 20 20 20 20 20 ....................2)).........
62160 20 20 20 28 62 75 74 6c 61 73 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 ...(butlast.transient--redisplay
62180 2d 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 5f 20 6e 69 6c 29 29 29 0a 20 20 28 6c 65 -key))...........(_.nil)))...(le
621a0 74 20 28 28 74 6f 70 6d 61 70 20 28 6d 61 6b 65 2d 73 70 61 72 73 65 2d 6b 65 79 6d 61 70 29 29 t.((topmap.(make-sparse-keymap))
621c0 0a 20 20 20 20 20 20 20 20 28 73 75 62 6d 61 70 20 28 6d 61 6b 65 2d 73 70 61 72 73 65 2d 6b 65 .........(submap.(make-sparse-ke
621e0 79 6d 61 70 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 ymap))).....(when.transient--red
62200 69 73 70 6c 61 79 2d 6b 65 79 0a 20 20 20 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 20 74 6f 70 isplay-key.......(define-key.top
62220 6d 61 70 20 28 76 63 6f 6e 63 61 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 map.(vconcat.transient--redispla
62240 79 2d 6b 65 79 29 20 73 75 62 6d 61 70 29 0a 20 20 20 20 20 20 28 73 65 74 2d 6b 65 79 6d 61 70 y-key).submap).......(set-keymap
62260 2d 70 61 72 65 6e 74 20 73 75 62 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 73 74 69 63 6b 79 2d -parent.submap.transient-sticky-
62280 6d 61 70 29 29 0a 20 20 20 20 28 6d 61 70 2d 6b 65 79 6d 61 70 2d 69 6e 74 65 72 6e 61 6c 0a 20 map)).....(map-keymap-internal..
622a0 20 20 20 20 28 6c 61 6d 62 64 61 20 28 6b 65 79 20 64 65 66 29 0a 20 20 20 20 20 20 20 28 77 68 ....(lambda.(key.def)........(wh
622c0 65 6e 20 28 61 6e 64 20 28 6e 6f 74 20 28 65 71 20 6b 65 79 20 3f 5c 65 29 29 0a 20 20 20 20 20 en.(and.(not.(eq.key.?\e))......
622e0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 70 20 64 65 66 29 0a 20 20 20 20 20 20 20 .............(listp.def)........
62300 20 20 20 20 20 20 20 20 20 20 20 28 6b 65 79 6d 61 70 70 20 64 65 66 29 29 0a 20 20 20 20 20 20 ...........(keymapp.def)).......
62320 20 20 20 28 64 65 66 69 6e 65 2d 6b 65 79 20 74 6f 70 6d 61 70 20 28 76 63 6f 6e 63 61 74 20 74 ...(define-key.topmap.(vconcat.t
62340 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 20 28 6c 69 73 74 20 6b 65 ransient--redisplay-key.(list.ke
62360 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 75 70 64 61 74 y))............#'transient-updat
62380 65 29 29 29 0a 20 20 20 20 20 28 69 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c e)))......(if.transient--redispl
623a0 61 79 2d 6b 65 79 0a 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 76 63 6f 6e ay-key..........(let.((key.(vcon
623c0 63 61 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 29 29 0a cat.transient--redisplay-key))).
623e0 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 ...........(or.(lookup-key.trans
62400 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 6b 65 79 29 0a 20 20 20 20 20 20 20 ient--transient-map.key)........
62420 20 20 20 20 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 72 65 67 75 6c 61 72 20 28 6c 6f 6f ........(and-let*.((regular.(loo
62440 6b 75 70 2d 6b 65 79 20 6c 6f 63 61 6c 2d 66 75 6e 63 74 69 6f 6e 2d 6b 65 79 2d 6d 61 70 20 6b kup-key.local-function-key-map.k
62460 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 6f 6f 6b 75 70 2d 6b ey)))..................(lookup-k
62480 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 28 76 63 6f ey.transient--transient-map.(vco
624a0 6e 63 61 74 20 72 65 67 75 6c 61 72 29 29 29 29 29 0a 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 ncat.regular)))))........transie
624c0 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 29 0a 20 20 20 20 74 6f 70 6d 61 70 29 29 nt--transient-map)).....topmap))
624e0 0a 0a 3b 3b 3b 20 53 65 74 75 70 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 ..;;;.Setup..(defun.transient-se
62500 74 75 70 20 28 26 6f 70 74 69 6f 6e 61 6c 20 6e 61 6d 65 20 6c 61 79 6f 75 74 20 65 64 69 74 20 tup.(&optional.name.layout.edit.
62520 26 72 65 73 74 20 70 61 72 61 6d 73 29 0a 20 20 22 53 65 74 75 70 20 74 68 65 20 74 72 61 6e 73 &rest.params)..."Setup.the.trans
62540 69 65 6e 74 20 73 70 65 63 69 66 69 65 64 20 62 79 20 4e 41 4d 45 2e 0a 0a 54 68 69 73 20 66 75 ient.specified.by.NAME...This.fu
62560 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 79 20 74 72 61 6e 73 69 65 6e 74 20 70 72 nction.is.called.by.transient.pr
62580 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 73 65 74 75 70 20 74 68 65 0a 74 72 61 6e 73 efix.commands.to.setup.the.trans
625a0 69 65 6e 74 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 20 4e 41 4d 45 20 69 73 20 6d 61 6e 64 ient...In.that.case.NAME.is.mand
625c0 61 74 6f 72 79 2c 20 4c 41 59 4f 55 54 20 61 6e 64 20 45 44 49 54 20 6d 75 73 74 0a 62 65 20 6e atory,.LAYOUT.and.EDIT.must.be.n
625e0 69 6c 20 61 6e 64 20 50 41 52 41 4d 53 20 6d 61 79 20 62 65 20 28 62 75 74 20 75 73 75 61 6c 6c il.and.PARAMS.may.be.(but.usuall
62600 79 20 69 73 20 6e 6f 74 29 20 75 73 65 64 20 74 6f 20 73 65 74 2c 20 65 2e 67 2e 2c 0a 74 68 65 y.is.not).used.to.set,.e.g.,.the
62620 20 5c 22 73 63 6f 70 65 5c 22 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 28 73 65 65 .\"scope\".of.the.transient.(see
62640 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 27 29 2e 0a 0a 54 68 .`transient-define-prefix')...Th
62660 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 69 6e 74 65 72 is.function.is.also.called.inter
62680 6e 61 6c 6c 79 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 4c 41 59 4f 55 54 20 61 6e 64 0a nally,.in.which.case.LAYOUT.and.
626a0 45 44 49 54 20 6d 61 79 20 62 65 20 6e 6f 6e 2d 6e 69 6c 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 EDIT.may.be.non-nil."...(transie
626c0 6e 74 2d 2d 64 65 62 75 67 20 27 73 65 74 75 70 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d nt--debug.'setup)...(transient--
626e0 77 69 74 68 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 73 65 74 75 70 0a 20 20 20 20 28 with-emergency-exit.:setup.....(
62700 63 6f 6e 64 0a 20 20 20 20 20 28 28 6e 6f 74 20 6e 61 6d 65 29 0a 20 20 20 20 20 20 3b 3b 20 53 cond......((not.name).......;;.S
62720 77 69 74 63 68 69 6e 67 20 62 65 74 77 65 65 6e 20 72 65 67 75 6c 61 72 20 61 6e 64 20 65 64 69 witching.between.regular.and.edi
62740 74 20 6d 6f 64 65 2e 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 t.mode........(transient--pop-ke
62760 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a ymap.'transient--transient-map).
62780 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 ......(transient--pop-keymap.'tr
627a0 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 29 0a 20 20 20 20 20 20 28 73 ansient--redisplay-map).......(s
627c0 65 74 71 20 6e 61 6d 65 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 etq.name.(oref.transient--prefix
627e0 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 70 61 72 61 6d 73 20 28 6c .command)).......(setq.params.(l
62800 69 73 74 20 3a 73 63 6f 70 65 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 ist.:scope.(oref.transient--pref
62820 69 78 20 73 63 6f 70 65 29 29 29 29 0a 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 ix.scope))))......(transient--pr
62840 65 66 69 78 0a 20 20 20 20 20 20 3b 3b 20 49 6e 76 6f 6b 65 64 20 61 73 20 61 20 22 3a 74 72 61 efix.......;;.Invoked.as.a.":tra
62860 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f nsient-non-suffix.'transient--do
62880 2d 7b 73 74 61 79 2c 63 61 6c 6c 7d 22 0a 20 20 20 20 20 20 3b 3b 20 6f 66 20 61 6e 20 6f 75 74 -{stay,call}".......;;.of.an.out
628a0 65 72 20 70 72 65 66 69 78 2e 20 20 55 6e 6c 69 6b 65 20 74 68 65 20 75 73 75 61 6c 20 60 74 72 er.prefix...Unlike.the.usual.`tr
628c0 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 6b 27 2c 0a 20 20 20 20 20 20 3b 3b 20 74 68 65 ansient--do-stack',.......;;.the
628e0 73 65 20 70 72 65 64 69 63 61 74 65 73 20 66 61 69 6c 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 61 se.predicates.fail.to.clean.up.a
62900 66 74 65 72 20 74 68 65 20 6f 75 74 65 72 20 70 72 65 66 69 78 2e 0a 20 20 20 20 20 20 28 74 72 fter.the.outer.prefix........(tr
62920 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d ansient--pop-keymap.'transient--
62940 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d transient-map).......(transient-
62960 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 -pop-keymap.'transient--redispla
62980 79 2d 6d 61 70 29 29 0a 20 20 20 20 20 28 28 6e 6f 74 20 28 6f 72 20 6c 61 79 6f 75 74 20 20 20 y-map))......((not.(or.layout...
629a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 20 72 65 73 75 6d 69 6e 67 20 70 61 ...................;.resuming.pa
629c0 72 65 6e 74 2f 73 75 73 70 65 6e 64 65 64 20 70 72 65 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 rent/suspended.prefix...........
629e0 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 29 29 .....transient-current-command))
62a00 20 3b 20 65 6e 74 65 72 69 6e 67 20 63 68 69 6c 64 20 70 72 65 66 69 78 0a 20 20 20 20 20 20 28 .;.entering.child.prefix.......(
62a20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 7a 61 70 29 29 20 20 20 20 20 20 20 20 20 20 transient--stack-zap))..........
62a40 20 20 20 20 3b 20 72 65 70 6c 61 63 65 20 73 75 73 70 65 6e 64 65 64 20 70 72 65 66 69 78 2c 20 ....;.replace.suspended.prefix,.
62a60 69 66 20 61 6e 79 0a 20 20 20 20 20 28 65 64 69 74 0a 20 20 20 20 20 20 3b 3b 20 52 65 74 75 72 if.any......(edit.......;;.Retur
62a80 6e 69 6e 67 20 66 72 6f 6d 20 68 65 6c 70 20 74 6f 20 65 64 69 74 2e 0a 20 20 20 20 20 20 28 73 ning.from.help.to.edit........(s
62aa0 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 20 74 29 29 29 0a 20 20 20 20 28 74 etq.transient--editp.t))).....(t
62ac0 72 61 6e 73 69 65 6e 74 2d 2d 65 6e 76 2d 61 70 70 6c 79 0a 20 20 20 20 20 28 6c 61 6d 62 64 61 ransient--env-apply......(lambda
62ae0 20 28 29 0a 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 74 72 61 6e .()........(transient--init-tran
62b00 73 69 65 6e 74 20 6e 61 6d 65 20 6c 61 79 6f 75 74 20 70 61 72 61 6d 73 29 0a 20 20 20 20 20 20 sient.name.layout.params).......
62b20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 69 6e 69 74 20 74 72 61 6e 73 69 .(transient--history-init.transi
62b40 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 ent--prefix)........(setq.transi
62b60 65 6e 74 2d 2d 6f 72 69 67 69 6e 61 6c 2d 77 69 6e 64 6f 77 20 28 73 65 6c 65 63 74 65 64 2d 77 ent--original-window.(selected-w
62b80 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d indow))........(setq.transient--
62ba0 6f 72 69 67 69 6e 61 6c 2d 62 75 66 66 65 72 20 28 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 original-buffer.(current-buffer)
62bc0 29 0a 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 69 6e 69 62 75 )........(setq.transient--minibu
62be0 66 66 65 72 2d 64 65 70 74 68 20 28 6d 69 6e 69 62 75 66 66 65 72 2d 64 65 70 74 68 29 29 0a 20 ffer-depth.(minibuffer-depth))..
62c00 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 29 29 0a 20 20 ......(transient--redisplay))...
62c20 20 20 20 28 67 65 74 20 6e 61 6d 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 ...(get.name.'transient--prefix)
62c40 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 74 65 78 74 2d 63 ).....(transient--suspend-text-c
62c60 6f 6e 76 65 72 73 69 6f 6e 2d 73 74 79 6c 65 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d onversion-style).....(transient-
62c80 2d 73 65 74 75 70 2d 74 72 61 6e 73 69 65 6e 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 -setup-transient).....(transient
62ca0 2d 2d 73 75 73 70 65 6e 64 2d 77 68 69 63 68 2d 6b 65 79 2d 6d 6f 64 65 29 29 29 0a 0a 28 63 6c --suspend-which-key-mode)))..(cl
62cc0 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 63 68 69 6c -defgeneric.transient-setup-chil
62ce0 64 72 65 6e 20 28 67 72 6f 75 70 20 63 68 69 6c 64 72 65 6e 29 0a 20 20 22 53 65 74 75 70 20 74 dren.(group.children)..."Setup.t
62d00 68 65 20 43 48 49 4c 44 52 45 4e 20 6f 66 20 47 52 4f 55 50 2e 0a 49 66 20 74 68 65 20 76 61 6c he.CHILDREN.of.GROUP..If.the.val
62d20 75 65 20 6f 66 20 74 68 65 20 60 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 27 20 73 6c 6f 74 20 ue.of.the.`setup-children'.slot.
62d40 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 65 6e 20 63 61 6c 6c 0a 74 68 61 74 20 66 75 6e 63 74 is.non-nil,.then.call.that.funct
62d60 69 6f 6e 20 77 69 74 68 20 43 48 49 4c 44 52 45 4e 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 72 ion.with.CHILDREN.as.the.only.ar
62d80 67 75 6d 65 6e 74 20 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 0a 76 61 6c 75 65 2e 20 20 4f 74 gument.and.return.the.value...Ot
62da0 68 65 72 77 69 73 65 20 72 65 74 75 72 6e 20 43 48 49 4c 44 52 45 4e 20 61 73 20 69 73 2e 22 29 herwise.return.CHILDREN.as.is.")
62dc0 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d ..(cl-defmethod.transient-setup-
62de0 63 68 69 6c 64 72 65 6e 20 28 28 67 72 6f 75 70 20 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 children.((group.transient-group
62e00 29 20 63 68 69 6c 64 72 65 6e 29 0a 20 20 28 69 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 67 ).children)...(if.(slot-boundp.g
62e20 72 6f 75 70 20 27 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 29 0a 20 20 20 20 20 20 28 66 75 6e roup.'setup-children).......(fun
62e40 63 61 6c 6c 20 28 6f 72 65 66 20 67 72 6f 75 70 20 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 29 call.(oref.group.setup-children)
62e60 20 63 68 69 6c 64 72 65 6e 29 0a 20 20 20 20 63 68 69 6c 64 72 65 6e 29 29 0a 0a 28 64 65 66 75 .children).....children))..(defu
62e80 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 6e 76 2d 61 70 70 6c 79 20 28 66 6e 20 26 6f 70 74 69 n.transient--env-apply.(fn.&opti
62ea0 6f 6e 61 6c 20 70 72 65 66 69 78 29 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 65 6e 76 20 28 6f 72 onal.prefix)...(if-let.((env.(or
62ec0 65 66 20 28 6f 72 20 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 ef.(or.prefix.transient--prefix)
62ee0 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 29 29 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 65 .environment))).......(funcall.e
62f00 6e 76 20 66 6e 29 0a 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 66 6e 29 29 29 0a 0a 28 64 65 66 75 nv.fn).....(funcall.fn)))..(defu
62f20 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 74 72 61 6e 73 69 65 6e 74 20 28 26 6f 70 n.transient--init-transient.(&op
62f40 74 69 6f 6e 61 6c 20 6e 61 6d 65 20 6c 61 79 6f 75 74 20 70 61 72 61 6d 73 29 0a 20 20 28 75 6e tional.name.layout.params)...(un
62f60 6c 65 73 73 20 6e 61 6d 65 0a 20 20 20 20 3b 3b 20 52 65 2d 69 6e 69 74 2e 0a 20 20 20 20 28 69 less.name.....;;.Re-init......(i
62f80 66 20 28 65 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 66 72 65 73 68 70 20 27 75 70 64 61 74 f.(eq.transient--refreshp.'updat
62fa0 65 64 2d 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 3b 3b 20 50 72 65 73 65 72 76 65 20 74 68 ed-value).........;;.Preserve.th
62fc0 65 20 70 72 65 66 69 78 20 76 61 6c 75 65 20 74 68 69 73 20 6f 6e 63 65 2c 20 62 65 63 61 75 73 e.prefix.value.this.once,.becaus
62fe0 65 20 74 68 65 0a 20 20 20 20 20 20 20 20 3b 3b 20 69 6e 76 6f 6b 65 64 20 73 75 66 66 69 78 20 e.the.........;;.invoked.suffix.
63000 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 69 74 20 68 61 73 20 75 70 64 61 74 65 64 20 74 68 indicates.that.it.has.updated.th
63020 61 74 2e 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 66 at..........(setq.transient--ref
63040 72 65 73 68 70 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 72 65 reshp.(oref.transient--prefix.re
63060 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 29 29 0a 20 20 20 20 20 20 3b 3b 20 4f 74 68 65 72 77 fresh-suffixes)).......;;.Otherw
63080 69 73 65 20 75 70 64 61 74 65 20 74 68 65 20 70 72 65 66 69 78 20 76 61 6c 75 65 20 66 72 6f 6d ise.update.the.prefix.value.from
630a0 20 73 75 66 66 69 78 20 76 61 6c 75 65 73 2e 0a 20 20 20 20 20 20 28 6f 73 65 74 20 74 72 61 6e .suffix.values........(oset.tran
630c0 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 76 61 6c 75 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d sient--prefix.value.(transient--
630e0 67 65 74 2d 65 78 74 65 6e 64 65 64 2d 76 61 6c 75 65 29 29 29 29 0a 20 20 28 74 72 61 6e 73 69 get-extended-value))))...(transi
63100 65 6e 74 2d 2d 69 6e 69 74 2d 6f 62 6a 65 63 74 73 20 6e 61 6d 65 20 6c 61 79 6f 75 74 20 70 61 ent--init-objects.name.layout.pa
63120 72 61 6d 73 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 6b 65 79 6d 61 70 73 rams)...(transient--init-keymaps
63140 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 6b 65 79 6d 61 ))..(defun.transient--init-keyma
63160 70 73 20 28 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 64 69 63 61 ps.()...(setq.transient--predica
63180 74 65 2d 6d 61 70 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 6b 65 2d 70 72 65 64 69 63 61 74 te-map.(transient--make-predicat
631a0 65 2d 6d 61 70 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 e-map))...(setq.transient--trans
631c0 69 65 6e 74 2d 6d 61 70 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 6b 65 2d 74 72 61 6e 73 69 ient-map.(transient--make-transi
631e0 65 6e 74 2d 6d 61 70 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 ent-map))...(setq.transient--red
63200 69 73 70 6c 61 79 2d 6d 61 70 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 6b 65 2d 72 65 64 69 isplay-map.(transient--make-redi
63220 73 70 6c 61 79 2d 6d 61 70 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d splay-map)))..(defun.transient--
63240 69 6e 69 74 2d 6f 62 6a 65 63 74 73 20 28 26 6f 70 74 69 6f 6e 61 6c 20 6e 61 6d 65 20 6c 61 79 init-objects.(&optional.name.lay
63260 6f 75 74 20 70 61 72 61 6d 73 29 0a 20 20 28 69 66 20 6e 61 6d 65 0a 20 20 20 20 20 20 28 73 65 out.params)...(if.name.......(se
63280 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 28 74 72 61 6e 73 69 65 6e 74 2d tq.transient--prefix.(transient-
632a0 2d 69 6e 69 74 2d 70 72 65 66 69 78 20 6e 61 6d 65 20 70 61 72 61 6d 73 29 29 0a 20 20 20 20 28 -init-prefix.name.params)).....(
632c0 73 65 74 71 20 6e 61 6d 65 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 setq.name.(oref.transient--prefi
632e0 78 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d x.command)))...(setq.transient--
63300 72 65 66 72 65 73 68 70 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 refreshp.(oref.transient--prefix
63320 20 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 29 29 0a 20 20 28 63 6f 6e 64 20 28 28 61 6e .refresh-suffixes))...(cond.((an
63340 64 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 66 72 65 73 68 70 29 20 6c 61 79 6f d.(not.transient--refreshp).layo
63360 75 74 29 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 ut)..........(setq.transient--la
63380 79 6f 75 74 20 6c 61 79 6f 75 74 29 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e yout.layout)..........(setq.tran
633a0 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 6c 61 74 sient--suffixes.(transient--flat
633c0 74 65 6e 2d 73 75 66 66 69 78 65 73 20 6c 61 79 6f 75 74 29 29 29 0a 20 20 20 20 20 20 20 20 28 ten-suffixes.layout))).........(
633e0 74 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 t..........(setq.transient--suff
63400 69 78 65 73 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 ixes.nil)..........(setq.transie
63420 6e 74 2d 2d 6c 61 79 6f 75 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 73 75 66 66 nt--layout.(transient--init-suff
63440 69 78 65 73 20 6e 61 6d 65 29 29 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 ixes.name))..........(setq.trans
63460 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 20 28 6e 72 65 76 65 72 73 65 20 74 72 61 6e 73 69 65 ient--suffixes.(nreverse.transie
63480 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 29 29 29 0a 20 20 28 73 6c 6f 74 2d 6d 61 6b 65 75 6e 62 nt--suffixes))))...(slot-makeunb
634a0 6f 75 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 27 76 61 6c 75 65 29 29 0a ound.transient--prefix.'value)).
634c0 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 70 72 65 66 69 78 20 28 .(defun.transient--init-prefix.(
634e0 6e 61 6d 65 20 26 6f 70 74 69 6f 6e 61 6c 20 70 61 72 61 6d 73 29 0a 20 20 28 6c 65 74 20 28 28 name.&optional.params)...(let.((
63500 6f 62 6a 20 28 6c 65 74 20 28 28 70 72 6f 74 6f 20 28 67 65 74 20 6e 61 6d 65 20 27 74 72 61 6e obj.(let.((proto.(get.name.'tran
63520 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 sient--prefix)))................
63540 28 61 70 70 6c 79 20 23 27 63 6c 6f 6e 65 20 70 72 6f 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 (apply.#'clone.proto............
63560 20 20 20 20 20 20 20 20 20 20 20 3a 70 72 6f 74 6f 74 79 70 65 20 70 72 6f 74 6f 0a 20 20 20 20 ...........:prototype.proto.....
63580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 6c 65 76 65 6c 20 28 6f 72 20 28 61 6c ..................:level.(or.(al
635a0 69 73 74 2d 67 65 74 20 74 20 28 61 6c 69 73 74 2d 67 65 74 20 6e 61 6d 65 20 74 72 61 6e 73 69 ist-get.t.(alist-get.name.transi
635c0 65 6e 74 2d 6c 65 76 65 6c 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ent-levels))....................
635e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d ..............transient-default-
63600 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 61 72 level).......................par
63620 61 6d 73 29 29 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 ams)))).....(transient-init-valu
63640 65 20 20 6f 62 6a 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 72 65 74 75 e..obj).....(transient-init-retu
63660 72 6e 20 6f 62 6a 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 rn.obj).....(transient-init-scop
63680 65 20 20 6f 62 6a 29 0a 20 20 20 20 6f 62 6a 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 e..obj).....obj))..(defun.transi
636a0 65 6e 74 2d 2d 69 6e 69 74 2d 73 75 66 66 69 78 65 73 20 28 6e 61 6d 65 29 0a 20 20 28 6c 65 74 ent--init-suffixes.(name)...(let
636c0 20 28 28 6c 65 76 65 6c 73 20 28 61 6c 69 73 74 2d 67 65 74 20 6e 61 6d 65 20 74 72 61 6e 73 69 .((levels.(alist-get.name.transi
636e0 65 6e 74 2d 6c 65 76 65 6c 73 29 29 29 0a 20 20 20 20 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 64 ent-levels))).....(mapcan.(lambd
63700 61 20 28 63 29 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 63 68 69 6c 64 20 6c 65 76 a.(c).(transient--init-child.lev
63720 65 6c 73 20 63 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 61 70 70 65 6e 64 20 els.c.nil)).............(append.
63740 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 63 68 69 6c 64 72 65 6e 20 6e 61 6d 65 29 0a 20 (transient--get-children.name)..
63760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 74 72 61 ...................(and.(not.tra
63780 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nsient--editp)..................
637a0 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 63 68 69 6c 64 72 65 6e ........(transient--get-children
637c0 20 27 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 29 29 29 29 29 .'transient-common-commands)))))
637e0 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 66 6c 61 74 74 65 6e 2d 73 75 66 )..(defun.transient--flatten-suf
63800 66 69 78 65 73 20 28 6c 61 79 6f 75 74 29 0a 20 20 28 63 6c 2d 6c 61 62 65 6c 73 20 28 28 73 20 fixes.(layout)...(cl-labels.((s.
63820 28 64 65 66 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 (def).................(cond.....
63840 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 73 74 72 69 6e 67 70 20 64 65 66 29 20 6e 69 6c 29 .............((stringp.def).nil)
63860 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 70 20 64 65 66 ..................((cl-typep.def
63880 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 29 20 6e 69 6c 29 0a 20 20 .'transient-information).nil)...
638a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6c 69 73 74 70 20 64 65 66 29 20 28 6d 61 70 ...............((listp.def).(map
638c0 63 61 6e 20 23 27 73 20 64 65 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 can.#'s.def))..................(
638e0 28 63 6c 2d 74 79 70 65 70 20 64 65 66 20 27 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 29 0a (cl-typep.def.'transient-group).
63900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 6e 20 23 27 73 20 28 6f ..................(mapcan.#'s.(o
63920 72 65 66 20 64 65 66 20 73 75 66 66 69 78 65 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ref.def.suffixes))).............
63940 20 20 20 20 20 28 28 63 6c 2d 74 79 70 65 70 20 64 65 66 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 .....((cl-typep.def.'transient-s
63960 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 64 uffix)...................(list.d
63980 65 66 29 29 29 29 29 0a 20 20 20 20 28 6d 61 70 63 61 6e 20 23 27 73 20 6c 61 79 6f 75 74 29 29 ef))))).....(mapcan.#'s.layout))
639a0 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 63 68 69 6c 64 20 )..(defun.transient--init-child.
639c0 28 6c 65 76 65 6c 73 20 73 70 65 63 20 70 61 72 65 6e 74 29 0a 20 20 28 63 6c 2d 65 74 79 70 65 (levels.spec.parent)...(cl-etype
639e0 63 61 73 65 20 73 70 65 63 0a 20 20 20 20 28 73 79 6d 62 6f 6c 20 28 6d 61 70 63 61 6e 20 28 6c case.spec.....(symbol.(mapcan.(l
63a00 61 6d 62 64 61 20 28 63 29 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 63 68 69 6c 64 ambda.(c).(transient--init-child
63a20 20 6c 65 76 65 6c 73 20 63 20 70 61 72 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .levels.c.parent))..............
63a40 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 63 68 69 6c 64 72 65 6e 20 .......(transient--get-children.
63a60 73 70 65 63 29 29 29 0a 20 20 20 20 28 76 65 63 74 6f 72 20 20 28 74 72 61 6e 73 69 65 6e 74 2d spec))).....(vector..(transient-
63a80 2d 69 6e 69 74 2d 67 72 6f 75 70 20 20 6c 65 76 65 6c 73 20 73 70 65 63 20 70 61 72 65 6e 74 29 -init-group..levels.spec.parent)
63aa0 29 0a 20 20 20 20 28 6c 69 73 74 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d ).....(list....(transient--init-
63ac0 73 75 66 66 69 78 20 6c 65 76 65 6c 73 20 73 70 65 63 20 70 61 72 65 6e 74 29 29 0a 20 20 20 20 suffix.levels.spec.parent)).....
63ae0 28 73 74 72 69 6e 67 20 20 28 6c 69 73 74 20 73 70 65 63 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 (string..(list.spec))))..(defun.
63b00 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 67 72 6f 75 70 20 28 6c 65 76 65 6c 73 20 73 70 transient--init-group.(levels.sp
63b20 65 63 20 70 61 72 65 6e 74 29 0a 20 20 28 70 63 61 73 65 2d 6c 65 74 2a 20 28 28 60 5b 2c 63 6c ec.parent)...(pcase-let*.((`[,cl
63b40 61 73 73 20 2c 61 72 67 73 20 2c 63 68 69 6c 64 72 65 6e 5d 20 73 70 65 63 29 0a 20 20 20 20 20 ass.,args.,children].spec)......
63b60 20 20 20 20 20 20 20 20 20 20 28 6c 65 76 65 6c 20 28 6f 72 20 28 70 6c 69 73 74 2d 67 65 74 20 ..........(level.(or.(plist-get.
63b80 61 72 67 73 20 3a 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 args.:level)....................
63ba0 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 63 68 69 6c 64 2d .......transient--default-child-
63bc0 6c 65 76 65 6c 29 29 29 0a 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 5f 28 74 72 61 6e 73 level))).....(and-let*.((_(trans
63be0 69 65 6e 74 2d 2d 75 73 65 2d 6c 65 76 65 6c 2d 70 20 6c 65 76 65 6c 29 29 0a 20 20 20 20 20 20 ient--use-level-p.level)).......
63c00 20 20 20 20 20 20 20 20 20 28 6f 62 6a 20 28 61 70 70 6c 79 20 63 6c 61 73 73 20 3a 70 61 72 65 .........(obj.(apply.class.:pare
63c20 6e 74 20 70 61 72 65 6e 74 20 3a 6c 65 76 65 6c 20 6c 65 76 65 6c 20 61 72 67 73 29 29 0a 20 20 nt.parent.:level.level.args))...
63c40 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 74 72 61 6e 73 69 65 6e 74 2d 2d 75 73 65 2d 73 .............(_(transient--use-s
63c60 75 66 66 69 78 2d 70 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 uffix-p.obj))................(_(
63c80 70 72 6f 67 31 20 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e prog1.t....................(when
63ca0 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 61 70 74 2d 73 75 66 66 69 78 2d 70 20 6f 62 6a 29 .(transient--inapt-suffix-p.obj)
63cc0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 ......................(oset.obj.
63ce0 69 6e 61 70 74 20 74 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 66 66 inapt.t))))................(suff
63d00 69 78 65 73 20 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 64 61 20 28 63 29 20 28 74 72 61 6e 73 69 ixes.(mapcan.(lambda.(c).(transi
63d20 65 6e 74 2d 2d 69 6e 69 74 2d 63 68 69 6c 64 20 6c 65 76 65 6c 73 20 63 20 6f 62 6a 29 29 0a 20 ent--init-child.levels.c.obj))..
63d40 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 ................................
63d60 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 63 68 69 6c 64 72 65 6e 20 6f 62 6a 20 63 68 (transient-setup-children.obj.ch
63d80 69 6c 64 72 65 6e 29 29 29 29 0a 20 20 20 20 20 20 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 20 ildren)))).......(progn.........
63da0 28 6f 73 65 74 20 6f 62 6a 20 73 75 66 66 69 78 65 73 20 73 75 66 66 69 78 65 73 29 0a 20 20 20 (oset.obj.suffixes.suffixes)....
63dc0 20 20 20 20 20 28 6c 69 73 74 20 6f 62 6a 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e .....(list.obj)))))..(defun.tran
63de0 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 73 75 66 66 69 78 20 28 6c 65 76 65 6c 73 20 73 70 65 63 20 sient--init-suffix.(levels.spec.
63e00 70 61 72 65 6e 74 29 0a 20 20 28 6c 65 74 2a 20 28 28 63 6c 61 73 73 20 20 28 63 61 72 20 73 70 parent)...(let*.((class..(car.sp
63e20 65 63 29 29 0a 20 20 20 20 20 20 20 20 20 28 61 72 67 73 20 20 20 28 63 64 72 20 73 70 65 63 29 ec))..........(args...(cdr.spec)
63e40 29 0a 20 20 20 20 20 20 20 20 20 28 63 6d 64 20 20 20 20 28 70 6c 69 73 74 2d 67 65 74 20 61 72 )..........(cmd....(plist-get.ar
63e60 67 73 20 3a 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 28 5f 20 20 20 20 20 20 28 gs.:command))..........(_......(
63e80 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 61 64 2d 63 6f 6d 6d 61 6e 64 2d 69 66 2d 61 75 74 6f 6c transient--load-command-if-autol
63ea0 6f 61 64 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 28 6b 65 79 20 20 20 20 28 70 6c 69 73 oad.cmd))..........(key....(plis
63ec0 74 2d 67 65 74 20 61 72 67 73 20 3a 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 20 28 6b 65 79 20 t-get.args.:key))..........(key.
63ee0 20 20 20 28 61 6e 64 20 6b 65 79 20 28 6b 62 64 20 6b 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 ...(and.key.(kbd.key))).........
63f00 20 28 70 72 6f 74 6f 20 20 28 61 6e 64 20 63 6d 64 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 .(proto..(and.cmd.(transient--su
63f20 66 66 69 78 2d 70 72 6f 74 6f 74 79 70 65 20 63 6d 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 ffix-prototype.cmd)))..........(
63f40 6c 65 76 65 6c 20 20 28 6f 72 20 28 61 6c 69 73 74 2d 67 65 74 20 28 63 6f 6e 73 20 63 6d 64 20 level..(or.(alist-get.(cons.cmd.
63f60 6b 65 79 29 20 6c 65 76 65 6c 73 20 6e 69 6c 20 6e 69 6c 20 23 27 65 71 75 61 6c 29 0a 20 20 20 key).levels.nil.nil.#'equal)....
63f80 20 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 74 20 63 6d 64 ..................(alist-get.cmd
63fa0 20 6c 65 76 65 6c 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 .levels)......................(p
63fc0 6c 69 73 74 2d 67 65 74 20 61 72 67 73 20 3a 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 list-get.args.:level)...........
63fe0 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 70 72 6f 74 6f 20 28 6f 72 65 66 20 70 72 6f 74 ...........(and.proto.(oref.prot
64000 6f 20 6c 65 76 65 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 o.level))......................t
64020 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 63 68 69 6c 64 2d 6c 65 76 65 6c 29 29 0a ransient--default-child-level)).
64040 20 20 20 20 20 20 20 20 20 28 61 72 67 73 20 20 20 28 70 6c 69 73 74 2d 70 75 74 20 28 63 6f 70 .........(args...(plist-put.(cop
64060 79 2d 73 65 71 75 65 6e 63 65 20 61 72 67 73 29 20 3a 6c 65 76 65 6c 20 6c 65 76 65 6c 29 29 0a y-sequence.args).:level.level)).
64080 20 20 20 20 20 20 20 20 20 28 6f 62 6a 20 20 20 20 28 69 66 20 28 63 68 69 6c 64 2d 6f 66 2d 63 .........(obj....(if.(child-of-c
640a0 6c 61 73 73 2d 70 20 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 lass-p.class.'transient-informat
640c0 69 6f 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 ion)......................(apply
640e0 20 63 6c 61 73 73 20 3a 70 61 72 65 6e 74 20 70 61 72 65 6e 74 20 61 72 67 73 29 0a 20 20 20 20 .class.:parent.parent.args).....
64100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 61 6e 64 20 63 6d 64 20 ...............(unless.(and.cmd.
64120 28 73 79 6d 62 6f 6c 70 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (symbolp.cmd))..................
64140 20 20 20 20 28 65 72 72 6f 72 20 22 42 55 47 3a 20 4e 6f 6e 2d 73 79 6d 62 6f 6c 69 63 20 73 75 ....(error."BUG:.Non-symbolic.su
64160 66 66 69 78 20 63 6f 6d 6d 61 6e 64 3a 20 25 73 22 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 ffix.command:.%s".cmd)).........
64180 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 70 72 6f 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 ...........(if.proto............
641a0 20 20 20 20 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 20 23 27 63 6c 6f 6e 65 20 70 72 6f 74 6f ............(apply.#'clone.proto
641c0 20 3a 70 61 72 65 6e 74 20 70 61 72 65 6e 74 20 61 72 67 73 29 0a 20 20 20 20 20 20 20 20 20 20 .:parent.parent.args)...........
641e0 20 20 20 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 20 63 6c 61 73 73 20 3a 63 6f 6d 6d 61 6e 64 ...........(apply.class.:command
64200 20 63 6d 64 20 3a 70 61 72 65 6e 74 20 70 61 72 65 6e 74 20 61 72 67 73 29 29 29 29 0a 20 20 20 .cmd.:parent.parent.args))))....
64220 20 20 20 20 20 20 28 61 63 74 69 76 65 20 28 61 6e 64 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 75 ......(active.(and.(transient--u
64240 73 65 2d 6c 65 76 65 6c 2d 70 20 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 se-level-p.level)...............
64260 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 75 73 65 2d 73 75 66 66 69 78 2d 70 ........(transient--use-suffix-p
64280 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 69 6e 61 70 74 20 20 28 61 6e 64 20 61 63 .obj)))..........(inapt..(and.ac
642a0 74 69 76 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 61 70 74 2d 73 75 66 66 69 78 2d 70 20 tive.(transient--inapt-suffix-p.
642c0 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 61 63 74 69 76 65 20 28 61 6e 64 20 61 63 74 obj)))..........(active.(and.act
642e0 69 76 65 20 28 6e 6f 74 20 69 6e 61 70 74 29 29 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 69 6e ive.(not.inapt)))).....(cond.(in
64300 61 70 74 0a 20 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 69 6e 61 70 74 20 74 apt............(oset.obj.inapt.t
64320 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 6e 6f 74 20 61 63 74 69 76 65 29 0a 20 20 20 20 20 ))...........((not.active)......
64340 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 69 6e 61 63 74 69 76 65 20 74 29 29 29 0a 20 20 ......(oset.obj.inactive.t)))...
64360 20 20 28 63 6f 6e 64 20 28 28 6e 6f 74 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 ..(cond.((not.cmd))...........((
64380 63 6f 6d 6d 61 6e 64 70 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 6f 72 20 28 63 commandp.cmd))...........((or.(c
643a0 6c 2d 74 79 70 65 70 20 6f 62 6a 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 29 0a 20 l-typep.obj.'transient-switch)..
643c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6c 2d 74 79 70 65 70 20 6f 62 6a 20 27 74 72 61 ..............(cl-typep.obj.'tra
643e0 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 41 73 nsient-option))............;;.As
64400 20 61 20 74 65 6d 70 6f 72 61 72 79 20 73 70 65 63 69 61 6c 20 63 61 73 65 2c 20 69 66 20 74 68 .a.temporary.special.case,.if.th
64420 65 20 70 61 63 6b 61 67 65 20 77 61 73 20 63 6f 6d 70 69 6c 65 64 0a 20 20 20 20 20 20 20 20 20 e.package.was.compiled..........
64440 20 20 3b 3b 20 77 69 74 68 20 61 6e 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 20 6f 66 20 54 72 ..;;.with.an.older.version.of.Tr
64460 61 6e 73 69 65 6e 74 2c 20 74 68 65 6e 20 77 65 20 6d 75 73 74 20 64 65 66 69 6e 65 0a 20 20 20 ansient,.then.we.must.define....
64480 20 20 20 20 20 20 20 20 3b 3b 20 22 61 6e 6f 6e 79 6d 6f 75 73 22 20 73 77 69 74 63 68 20 61 6e ........;;."anonymous".switch.an
644a0 64 20 6f 70 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 68 65 72 65 2e 0a 20 20 20 20 20 20 20 20 d.option.commands.here..........
644c0 20 20 20 28 64 65 66 61 6c 69 61 73 20 63 6d 64 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 ...(defalias.cmd.#'transient--de
644e0 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 fault-infix-command))...........
64500 28 61 63 74 69 76 65 0a 20 20 20 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 53 75 66 66 69 (active............(error."Suffi
64520 78 20 63 6f 6d 6d 61 6e 64 20 25 73 20 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 6f 72 20 61 x.command.%s.is.not.defined.or.a
64540 75 74 6f 6c 6f 61 64 65 64 22 20 63 6d 64 29 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 28 6e 6f utoloaded".cmd))).....(cond.((no
64560 74 20 28 63 6c 2d 74 79 70 65 70 20 6f 62 6a 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 t.(cl-typep.obj.'transient-infor
64580 6d 61 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d mation))............(transient--
645a0 69 6e 69 74 2d 73 75 66 66 69 78 2d 6b 65 79 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 init-suffix-key.obj)............
645c0 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 20 6f 62 6a 29 0a 20 20 20 20 20 (transient-init-scope.obj)......
645e0 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 6f 62 6a 29 ......(transient-init-value.obj)
64600 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 75 73 68 20 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d ............(push.obj.transient-
64620 2d 73 75 66 66 69 78 65 73 29 29 29 0a 20 20 20 20 28 6c 69 73 74 20 6f 62 6a 29 29 29 0a 0a 28 -suffixes))).....(list.obj)))..(
64640 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 73 75 66 cl-defmethod.transient--init-suf
64660 66 69 78 2d 6b 65 79 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 fix-key.((obj.transient-suffix))
64680 0a 20 20 28 75 6e 6c 65 73 73 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 6b 65 79 ...(unless.(slot-boundp.obj.'key
646a0 29 0a 20 20 20 20 28 65 72 72 6f 72 20 22 4e 6f 20 6b 65 79 20 66 6f 72 20 25 73 22 20 28 6f 72 ).....(error."No.key.for.%s".(or
646c0 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f ef.obj.command))))..(cl-defmetho
646e0 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 73 75 66 66 69 78 2d 6b 65 79 20 28 28 6f d.transient--init-suffix-key.((o
64700 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 28 69 66 20 28 74 bj.transient-argument))...(if.(t
64720 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 2d 2d 65 69 65 69 6f 2d 63 68 69 6c 64 70 20 ransient-switches--eieio-childp.
64740 6f 62 6a 29 0a 20 20 20 20 20 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 obj).......(cl-call-next-method.
64760 6f 62 6a 29 0a 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 28 6e 6f 74 20 28 73 6c 6f obj).....(when-let*.((_(not.(slo
64780 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 73 68 6f 72 74 61 72 67 29 29 29 0a 20 20 20 20 20 20 t-boundp.obj.'shortarg))).......
647a0 20 20 20 20 20 20 20 20 20 20 28 61 72 67 75 6d 65 6e 74 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 ..........(argument.(oref.obj.ar
647c0 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 73 74 72 69 gument)).................(_(stri
647e0 6e 67 70 20 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 ngp.argument)).................(
64800 73 68 6f 72 74 61 72 67 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 72 69 76 65 2d 73 68 6f 72 shortarg.(transient--derive-shor
64820 74 61 72 67 20 61 72 67 75 6d 65 6e 74 29 29 29 0a 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a targ.argument))).......(oset.obj
64840 20 73 68 6f 72 74 61 72 67 20 73 68 6f 72 74 61 72 67 29 29 0a 20 20 20 20 28 75 6e 6c 65 73 73 .shortarg.shortarg)).....(unless
64860 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 6b 65 79 29 0a 20 20 20 20 20 20 28 69 .(slot-boundp.obj.'key).......(i
64880 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 73 68 6f 72 74 61 72 67 29 0a 20 20 f.(slot-boundp.obj.'shortarg)...
648a0 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 6b 65 79 20 28 6f 72 65 66 20 6f 62 6a 20 ........(oset.obj.key.(oref.obj.
648c0 73 68 6f 72 74 61 72 67 29 29 0a 20 20 20 20 20 20 20 20 28 65 72 72 6f 72 20 22 4e 6f 20 6b 65 shortarg)).........(error."No.ke
648e0 79 20 66 6f 72 20 25 73 22 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 29 29 29 y.for.%s".(oref.obj.command)))))
64900 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 75 73 65 2d 6c 65 76 65 6c 2d 70 )..(defun.transient--use-level-p
64920 20 28 6c 65 76 65 6c 20 26 6f 70 74 69 6f 6e 61 6c 20 65 64 69 74 29 0a 20 20 28 6f 72 20 74 72 .(level.&optional.edit)...(or.tr
64940 61 6e 73 69 65 6e 74 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 0a 20 20 20 20 20 20 28 61 6e 64 ansient--all-levels-p.......(and
64960 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 20 28 6e 6f 74 20 65 64 69 74 29 29 0a 20 20 .transient--editp.(not.edit))...
64980 20 20 20 20 28 61 6e 64 20 28 3e 3d 20 6c 65 76 65 6c 20 31 29 0a 20 20 20 20 20 20 20 20 20 20 ....(and.(>=.level.1)...........
649a0 20 28 3c 3d 20 6c 65 76 65 6c 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 .(<=.level.(oref.transient--pref
649c0 69 78 20 6c 65 76 65 6c 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d ix.level)))))..(defun.transient-
649e0 2d 75 73 65 2d 73 75 66 66 69 78 2d 70 20 28 6f 62 6a 29 0a 20 20 28 6c 65 74 20 28 28 74 72 61 -use-suffix-p.(obj)...(let.((tra
64a00 6e 73 69 65 6e 74 2d 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 20 28 63 75 72 72 65 6e 74 nsient--shadowed-buffer.(current
64a20 2d 62 75 66 66 65 72 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 -buffer)).........(transient--pe
64a40 6e 64 69 6e 67 2d 73 75 66 66 69 78 20 6f 62 6a 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e nding-suffix.obj)).....(transien
64a60 74 2d 2d 64 6f 2d 73 75 66 66 69 78 2d 70 0a 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 66 t--do-suffix-p......(oref.obj.if
64a80 29 0a 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 66 2d 6e 6f 74 29 0a 20 20 20 20 20 28 6f )......(oref.obj.if-not)......(o
64aa0 72 65 66 20 6f 62 6a 20 69 66 2d 6e 69 6c 29 0a 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 ref.obj.if-nil)......(oref.obj.i
64ac0 66 2d 6e 6f 6e 2d 6e 69 6c 29 0a 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 66 2d 6d 6f 64 f-non-nil)......(oref.obj.if-mod
64ae0 65 29 0a 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 66 2d 6e 6f 74 2d 6d 6f 64 65 29 0a 20 e)......(oref.obj.if-not-mode)..
64b00 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 66 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 28 ....(oref.obj.if-derived)......(
64b20 6f 72 65 66 20 6f 62 6a 20 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 74 29 oref.obj.if-not-derived)......t)
64b40 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 61 70 74 2d 73 75 66 66 ))..(defun.transient--inapt-suff
64b60 69 78 2d 70 20 28 6f 62 6a 29 0a 20 20 28 6f 72 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 70 61 72 ix-p.(obj)...(or.(and-let*.((par
64b80 65 6e 74 20 28 6f 72 65 66 20 6f 62 6a 20 70 61 72 65 6e 74 29 29 29 0a 20 20 20 20 20 20 20 20 ent.(oref.obj.parent))).........
64ba0 28 6f 72 65 66 20 70 61 72 65 6e 74 20 69 6e 61 70 74 29 29 0a 20 20 20 20 20 20 28 6c 65 74 20 (oref.parent.inapt)).......(let.
64bc0 28 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 20 28 63 75 ((transient--shadowed-buffer.(cu
64be0 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e rrent-buffer)).............(tran
64c00 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 73 75 66 66 69 78 20 6f 62 6a 29 29 0a 20 20 20 20 sient--pending-suffix.obj)).....
64c20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 66 66 69 78 2d 70 0a 20 20 20 20 ....(transient--do-suffix-p.....
64c40 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 2d 69 66 29 0a 20 20 20 20 20 20 20 .....(oref.obj.inapt-if)........
64c60 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 29 0a 20 20 20 20 20 20 ..(oref.obj.inapt-if-not).......
64c80 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 2d 69 66 2d 6e 69 6c 29 0a 20 20 20 20 20 ...(oref.obj.inapt-if-nil)......
64ca0 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 2d 69 66 2d 6e 6f 6e 2d 6e 69 6c 29 0a ....(oref.obj.inapt-if-non-nil).
64cc0 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 2d 69 66 2d 6d 6f 64 65 .........(oref.obj.inapt-if-mode
64ce0 29 0a 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 2d 69 66 2d 6e 6f )..........(oref.obj.inapt-if-no
64d00 74 2d 6d 6f 64 65 29 0a 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 t-mode)..........(oref.obj.inapt
64d20 2d 69 66 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 -if-derived)..........(oref.obj.
64d40 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 20 20 20 20 6e inapt-if-not-derived)..........n
64d60 69 6c 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 66 il))))..(defun.transient--do-suf
64d80 66 69 78 2d 70 0a 20 20 20 20 28 69 66 20 69 66 2d 6e 6f 74 20 69 66 2d 6e 69 6c 20 69 66 2d 6e fix-p.....(if.if-not.if-nil.if-n
64da0 6f 6e 2d 6e 69 6c 20 69 66 2d 6d 6f 64 65 20 69 66 2d 6e 6f 74 2d 6d 6f 64 65 20 69 66 2d 64 65 on-nil.if-mode.if-not-mode.if-de
64dc0 72 69 76 65 64 20 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 0a 20 20 20 20 20 20 20 20 64 65 66 rived.if-not-derived.........def
64de0 61 75 6c 74 29 0a 20 20 28 63 6f 6e 64 0a 20 20 20 28 69 66 20 20 20 20 20 20 20 20 20 20 20 20 ault)...(cond....(if............
64e00 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 69 66 29 29 0a 20 20 20 28 69 66 2d 6e 6f 74 20 20 ......(funcall.if))....(if-not..
64e20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 66 75 6e 63 61 6c 6c 20 69 66 2d 6e 6f 74 29 29 29 0a 20 .......(not.(funcall.if-not)))..
64e40 20 20 28 69 66 2d 6e 6f 6e 2d 6e 69 6c 20 20 20 20 20 20 20 20 20 20 28 73 79 6d 62 6f 6c 2d 76 ..(if-non-nil..........(symbol-v
64e60 61 6c 75 65 20 69 66 2d 6e 6f 6e 2d 6e 69 6c 29 29 0a 20 20 20 28 69 66 2d 6e 69 6c 20 20 20 20 alue.if-non-nil))....(if-nil....
64e80 20 20 20 20 20 28 6e 6f 74 20 28 73 79 6d 62 6f 6c 2d 76 61 6c 75 65 20 69 66 2d 6e 69 6c 29 29 .....(not.(symbol-value.if-nil))
64ea0 29 0a 20 20 20 28 69 66 2d 6d 6f 64 65 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 61 )....(if-mode.............(if.(a
64ec0 74 6f 6d 20 69 66 2d 6d 6f 64 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 tom.if-mode)....................
64ee0 20 20 20 20 20 20 20 20 20 28 65 71 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 69 66 2d 6d 6f 64 65 29 .........(eq.major-mode.if-mode)
64f00 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 6d 65 6d 71 ...........................(memq
64f20 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 69 66 2d 6d 6f 64 65 29 29 29 0a 20 20 20 28 69 66 2d 6e 6f .major-mode.if-mode)))....(if-no
64f40 74 2d 6d 6f 64 65 20 20 20 20 28 6e 6f 74 20 28 69 66 20 28 61 74 6f 6d 20 69 66 2d 6e 6f 74 2d t-mode....(not.(if.(atom.if-not-
64f60 6d 6f 64 65 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 mode)...........................
64f80 20 20 28 65 71 20 6d 61 6a 6f 72 2d 6d 6f 64 65 20 69 66 2d 6e 6f 74 2d 6d 6f 64 65 29 0a 20 20 ..(eq.major-mode.if-not-mode)...
64fa0 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 6d 65 6d 71 20 6d 61 ........................(memq.ma
64fc0 6a 6f 72 2d 6d 6f 64 65 20 69 66 2d 6e 6f 74 2d 6d 6f 64 65 29 29 29 29 0a 20 20 20 28 69 66 2d jor-mode.if-not-mode))))....(if-
64fe0 64 65 72 69 76 65 64 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 6f 72 20 28 61 74 6f 6d 20 69 derived..........(if.(or.(atom.i
65000 66 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f-derived)......................
65020 20 20 20 20 20 20 20 20 20 20 20 28 3e 3d 20 65 6d 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 ...........(>=.emacs-major-versi
65040 6f 6e 20 33 30 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 on.30)).........................
65060 20 20 20 20 28 64 65 72 69 76 65 64 2d 6d 6f 64 65 2d 70 20 69 66 2d 64 65 72 69 76 65 64 29 0a ....(derived-mode-p.if-derived).
65080 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 61 70 70 6c 79 ..........................(apply
650a0 20 23 27 64 65 72 69 76 65 64 2d 6d 6f 64 65 2d 70 20 69 66 2d 64 65 72 69 76 65 64 29 29 29 0a .#'derived-mode-p.if-derived))).
650c0 20 20 20 28 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 20 28 6e 6f 74 20 28 69 66 20 28 6f 72 20 ...(if-not-derived.(not.(if.(or.
650e0 28 61 74 6f 6d 20 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 20 20 20 20 20 (atom.if-not-derived)...........
65100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 3e 3d 20 65 6d 61 63 73 2d ......................(>=.emacs-
65120 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 33 30 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 major-version.30))..............
65140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 72 69 76 65 64 2d 6d 6f 64 65 2d 70 20 69 ...............(derived-mode-p.i
65160 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f-not-derived)..................
65180 20 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 20 23 27 64 65 72 69 76 65 64 2d 6d 6f 64 65 2d 70 .........(apply.#'derived-mode-p
651a0 20 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 29 29 29 29 0a 20 20 20 28 64 65 66 61 75 6c 74 29 .if-not-derived))))....(default)
651c0 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 65 ))..(defun.transient--suffix-pre
651e0 64 69 63 61 74 65 20 28 73 70 65 63 29 0a 20 20 28 6c 65 74 20 28 28 70 72 6f 70 73 20 28 74 72 dicate.(spec)...(let.((props.(tr
65200 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 70 73 20 73 70 65 63 29 29 29 0a 20 20 ansient--suffix-props.spec)))...
65220 20 20 28 73 65 71 2d 73 6f 6d 65 20 28 6c 61 6d 62 64 61 20 28 70 72 6f 70 29 0a 20 20 20 20 20 ..(seq-some.(lambda.(prop)......
65240 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 70 72 65 64 20 28 70 6c 69 ...........(and-let*.((pred.(pli
65260 73 74 2d 67 65 74 20 70 72 6f 70 73 20 70 72 6f 70 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 st-get.props.prop)))............
65280 20 20 20 20 20 20 20 28 6c 69 73 74 20 70 72 6f 70 20 70 72 65 64 29 29 29 0a 20 20 20 20 20 20 .......(list.prop.pred))).......
652a0 20 20 20 20 20 20 20 20 27 28 20 3a 69 66 20 3a 69 66 2d 6e 6f 74 0a 20 20 20 20 20 20 20 20 20 ........'(.:if.:if-not..........
652c0 20 20 20 20 20 20 20 20 3a 69 66 2d 6e 69 6c 20 3a 69 66 2d 6e 6f 6e 2d 6e 69 6c 0a 20 20 20 20 ........:if-nil.:if-non-nil.....
652e0 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 69 66 2d 6d 6f 64 65 20 3a 69 66 2d 6e 6f 74 2d 6d 6f .............:if-mode.:if-not-mo
65300 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 69 66 2d 64 65 72 69 76 65 64 20 de..................:if-derived.
65320 3a 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 :if-not-derived.................
65340 20 3a 69 6e 61 70 74 2d 69 66 20 3a 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 0a 20 20 20 20 20 20 20 .:inapt-if.:inapt-if-not........
65360 20 20 20 20 20 20 20 20 20 20 3a 69 6e 61 70 74 2d 69 66 2d 6e 69 6c 20 3a 69 6e 61 70 74 2d 69 ..........:inapt-if-nil.:inapt-i
65380 66 2d 6e 6f 6e 2d 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 69 6e 61 70 f-non-nil..................:inap
653a0 74 2d 69 66 2d 6d 6f 64 65 20 3a 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 6d 6f 64 65 0a 20 20 20 t-if-mode.:inapt-if-not-mode....
653c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 69 6e 61 70 74 2d 69 66 2d 64 65 72 69 76 65 64 20 ..............:inapt-if-derived.
653e0 3a 69 6e 61 70 74 2d 69 66 2d 6e 6f 74 2d 64 65 72 69 76 65 64 29 29 29 29 0a 0a 28 64 65 66 75 :inapt-if-not-derived))))..(defu
65400 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 61 64 2d 63 6f 6d 6d 61 6e 64 2d 69 66 2d 61 75 74 n.transient--load-command-if-aut
65420 6f 6c 6f 61 64 20 28 63 6d 64 29 0a 20 20 28 77 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 28 73 79 6d oload.(cmd)...(when-let*.((_(sym
65440 62 6f 6c 70 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6e 20 28 73 79 bolp.cmd))...............(fn.(sy
65460 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 63 6d 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 mbol-function.cmd)).............
65480 20 20 28 5f 28 61 75 74 6f 6c 6f 61 64 70 20 66 6e 29 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 ..(_(autoloadp.fn))).....(transi
654a0 65 6e 74 2d 2d 64 65 62 75 67 20 22 20 20 20 61 75 74 6f 6c 6f 61 64 20 25 73 22 20 63 6d 64 29 ent--debug."...autoload.%s".cmd)
654c0 0a 20 20 20 20 28 61 75 74 6f 6c 6f 61 64 2d 64 6f 2d 6c 6f 61 64 20 66 6e 29 29 29 0a 0a 3b 3b .....(autoload-do-load.fn)))..;;
654e0 3b 20 46 6c 6f 77 2d 43 6f 6e 74 72 6f 6c 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 ;.Flow-Control..(defun.transient
65500 2d 2d 73 65 74 75 70 2d 74 72 61 6e 73 69 65 6e 74 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e --setup-transient.()...(transien
65520 74 2d 2d 64 65 62 75 67 20 27 73 65 74 75 70 2d 74 72 61 6e 73 69 65 6e 74 29 0a 20 20 28 74 72 t--debug.'setup-transient)...(tr
65540 61 6e 73 69 65 6e 74 2d 2d 70 75 73 68 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d ansient--push-keymap.'transient-
65560 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 -transient-map)...(transient--pu
65580 73 68 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d sh-keymap.'transient--redisplay-
655a0 6d 61 70 29 0a 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f map)...(add-hook.'pre-command-ho
655c0 6f 6b 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 39 39 29 ok..#'transient--pre-command.99)
655e0 0a 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 20 ...(add-hook.'post-command-hook.
65600 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 28 61 64 #'transient--post-command)...(ad
65620 76 69 63 65 2d 61 64 64 20 27 72 65 63 75 72 73 69 76 65 2d 65 64 69 74 20 3a 61 72 6f 75 6e 64 vice-add.'recursive-edit.:around
65640 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 63 75 72 73 69 76 65 2d 65 64 69 74 29 0a 20 20 .#'transient--recursive-edit)...
65660 28 74 72 61 6e 73 69 65 6e 74 2d 2d 71 75 69 74 2d 6b 6c 75 64 67 65 20 27 65 6e 61 62 6c 65 29 (transient--quit-kludge.'enable)
65680 0a 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 0a 20 20 20 20 3b 3b ...(when.transient--exitp.....;;
656a0 20 54 68 69 73 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 .This.prefix.command.was.invoked
656c0 20 61 73 20 74 68 65 20 73 75 66 66 69 78 20 6f 66 20 61 6e 6f 74 68 65 72 2e 0a 20 20 20 20 3b .as.the.suffix.of.another......;
656e0 3b 20 50 72 65 76 65 6e 74 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 63 6f 6d 6d 61 ;.Prevent.`transient--post-comma
65700 6e 64 27 20 66 72 6f 6d 20 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 68 6f 6f 6b 73 0a 20 20 20 20 nd'.from.removing.the.hooks.....
65720 3b 3b 20 74 68 61 74 20 77 65 20 6a 75 73 74 20 61 64 64 65 64 2e 0a 20 20 20 20 28 73 65 74 71 ;;.that.we.just.added......(setq
65740 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 27 72 65 70 6c 61 63 65 29 29 29 0a 0a 28 .transient--exitp.'replace)))..(
65760 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 66 72 65 73 68 2d 74 72 61 6e 73 69 65 defun.transient--refresh-transie
65780 6e 74 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 72 65 66 72 65 nt.()...(transient--debug.'refre
657a0 73 68 2d 74 72 61 6e 73 69 65 6e 74 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d sh-transient)...(transient--pop-
657c0 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 keymap.'transient--predicate-map
657e0 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e )...(transient--pop-keymap.'tran
65800 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a 20 20 28 74 72 61 6e 73 69 65 sient--transient-map)...(transie
65820 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 nt--pop-keymap.'transient--redis
65840 70 6c 61 79 2d 6d 61 70 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 74 72 61 play-map)...(transient--init-tra
65860 6e 73 69 65 6e 74 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 73 68 2d 6b 65 79 6d 61 nsient)...(transient--push-keyma
65880 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a 20 20 28 p.'transient--transient-map)...(
658a0 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 73 68 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e transient--push-keymap.'transien
658c0 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d t--redisplay-map)...(transient--
658e0 72 65 64 69 73 70 6c 61 79 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 redisplay))..(defun.transient--p
65900 72 65 2d 63 6f 6d 6d 61 6e 64 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 re-command.()...(transient--debu
65920 67 20 27 70 72 65 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 g.'pre-command)...(transient--wi
65940 74 68 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 th-emergency-exit.:pre-command..
65960 20 20 20 3b 3b 20 54 68 65 20 75 73 65 20 6f 66 20 60 6f 76 65 72 72 69 64 69 6e 67 2d 74 65 72 ...;;.The.use.of.`overriding-ter
65980 6d 69 6e 61 6c 2d 6c 6f 63 61 6c 2d 6d 61 70 27 20 64 6f 65 73 20 6e 6f 74 20 70 72 65 76 65 6e minal-local-map'.does.not.preven
659a0 74 20 74 68 65 0a 20 20 20 20 3b 3b 20 6c 6f 6f 6b 75 70 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 72 t.the.....;;.lookup.of.command.r
659c0 65 6d 61 70 70 69 6e 67 73 20 69 6e 20 74 68 65 20 6f 76 65 72 72 69 64 64 65 6e 20 6d 61 70 73 emappings.in.the.overridden.maps
659e0 2c 20 77 68 69 63 68 20 63 61 6e 0a 20 20 20 20 3b 3b 20 6c 65 61 64 20 74 6f 20 61 20 73 75 66 ,.which.can.....;;.lead.to.a.suf
65a00 66 69 78 20 62 65 69 6e 67 20 72 65 6d 61 70 70 65 64 20 74 6f 20 61 20 6e 6f 6e 2d 73 75 66 66 fix.being.remapped.to.a.non-suff
65a20 69 78 2e 20 20 57 65 20 68 61 76 65 20 74 6f 20 75 6e 64 6f 0a 20 20 20 20 3b 3b 20 74 68 65 20 ix...We.have.to.undo.....;;.the.
65a40 72 65 6d 61 70 70 69 6e 67 20 69 6e 20 74 68 61 74 20 63 61 73 65 2e 20 20 48 6f 77 65 76 65 72 remapping.in.that.case...However
65a60 2c 20 72 65 6d 61 70 70 69 6e 67 20 61 20 6e 6f 6e 2d 73 75 66 66 69 78 20 74 6f 0a 20 20 20 20 ,.remapping.a.non-suffix.to.....
65a80 3b 3b 20 61 6e 6f 74 68 65 72 20 73 68 6f 75 6c 64 20 72 65 6d 61 69 6e 20 70 6f 73 73 69 62 6c ;;.another.should.remain.possibl
65aa0 65 2e 0a 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 e......(when.(and.(transient--ge
65ac0 74 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d t-pre-command.this-original-comm
65ae0 61 6e 64 20 6e 69 6c 20 27 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 and.nil.'suffix)................
65b00 28 6e 6f 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 (not.(transient--get-pre-command
65b20 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 6e 69 6c 20 27 73 75 66 66 69 78 29 29 29 0a 20 20 20 .this-command.nil.'suffix)))....
65b40 20 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 74 68 69 73 2d 6f 72 69 67 69 ...(setq.this-command.this-origi
65b60 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 28 28 6d nal-command)).....(cond......((m
65b80 65 6d 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 28 74 72 61 6e 73 69 65 6e 74 2d 75 70 64 emq.this-command.'(transient-upd
65ba0 61 74 65 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 73 65 71 29 29 0a 20 20 20 20 20 20 28 ate.transient-quit-seq)).......(
65bc0 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 transient--pop-keymap.'transient
65be0 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 29 29 0a 20 20 20 20 20 28 28 61 6e 64 20 74 72 61 --redisplay-map))......((and.tra
65c00 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 0a 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 6d nsient--helpp............(not.(m
65c20 65 6d 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 71 75 69 74 emq.this-command.transient--quit
65c40 2d 63 6f 6d 6d 61 6e 64 73 29 29 29 0a 20 20 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 -commands))).......(cond........
65c60 28 28 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 ((transient-help).........(trans
65c80 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 6e 64 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 ient--do-suspend).........(setq.
65ca0 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 75 73 70 65 6e 64 29 this-command.'transient-suspend)
65cc0 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 65 78 69 74 29 29 0a .........(transient--pre-exit)).
65ce0 20 20 20 20 20 20 20 28 28 6e 6f 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 65 62 75 67 2d .......((not.(transient--edebug-
65d00 63 6f 6d 6d 61 6e 64 2d 70 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 command-p)).........(setq.this-c
65d20 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 29 29 29 29 0a ommand.'transient-undefined)))).
65d40 20 20 20 20 20 28 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 0a 20 20 20 20 .....((and.transient--editp.....
65d60 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 .......(transient-suffix-object)
65d80 0a 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 6d 65 6d 71 20 74 68 69 73 2d 63 6f 6d 6d ............(not.(memq.this-comm
65da0 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 20 and.......................(cons.
65dc0 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 71 75 69 74 2d 'transient-help.transient--quit-
65de0 63 6f 6d 6d 61 6e 64 73 29 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 6f commands)))).......(setq.this-co
65e00 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c 29 0a 20 20 20 20 mmand.'transient-set-level).....
65e20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 77 72 61 70 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 ..(transient--wrap-command))....
65e40 20 20 28 74 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 ..(t.......(setq.transient--exit
65e60 70 20 6e 69 6c 29 0a 20 20 20 20 20 20 28 6c 65 74 20 28 28 65 78 69 74 70 20 28 65 71 20 28 74 p.nil).......(let.((exitp.(eq.(t
65e80 72 61 6e 73 69 65 6e 74 2d 2d 63 61 6c 6c 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 29 20 74 72 61 6e ransient--call-pre-command).tran
65ea0 73 69 65 6e 74 2d 2d 65 78 69 74 29 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e sient--exit))).........(transien
65ec0 74 2d 2d 77 72 61 70 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 65 t--wrap-command).........(when.e
65ee0 78 69 74 70 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 62 65 xitp...........(transient--maybe
65f00 2d 73 65 74 2d 76 61 6c 75 65 20 27 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 -set-value.'exit)...........(tra
65f20 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 65 78 69 74 29 29 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 nsient--pre-exit)))))))..(defun.
65f40 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 65 78 69 74 20 28 29 0a 20 20 28 74 72 61 6e 73 69 transient--pre-exit.()...(transi
65f60 65 6e 74 2d 2d 64 65 62 75 67 20 27 70 72 65 2d 65 78 69 74 29 0a 20 20 28 74 72 61 6e 73 69 65 ent--debug.'pre-exit)...(transie
65f80 6e 74 2d 2d 64 65 6c 65 74 65 2d 77 69 6e 64 6f 77 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d nt--delete-window)...(transient-
65fa0 2d 74 69 6d 65 72 2d 63 61 6e 63 65 6c 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 -timer-cancel)...(transient--pop
65fc0 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 -keymap.'transient--transient-ma
65fe0 70 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 p)...(transient--pop-keymap.'tra
66000 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 29 0a 20 20 28 75 6e 6c 65 73 73 nsient--redisplay-map)...(unless
66020 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 0a 20 20 20 20 28 6c 65 74 20 28 28 6d 65 73 .transient--showp.....(let.((mes
66040 73 61 67 65 2d 6c 6f 67 2d 6d 61 78 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 28 6d 65 73 73 61 67 sage-log-max.nil)).......(messag
66060 65 20 22 22 29 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 e."")))...(setq.transient--trans
66080 69 65 6e 74 2d 6d 61 70 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d ient-map.nil)...(setq.transient-
660a0 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e -predicate-map.nil)...(setq.tran
660c0 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 20 6e 69 6c 29 0a 20 20 28 73 65 74 sient--redisplay-map.nil)...(set
660e0 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 20 6e 69 6c 29 0a q.transient--redisplay-key.nil).
66100 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 20 6e 69 6c 29 0a 20 20 ..(setq.transient--helpp.nil)...
66120 28 75 6e 6c 65 73 73 20 28 65 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 70 20 27 70 65 (unless.(eq.transient--docsp.'pe
66140 72 6d 61 6e 65 6e 74 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f rmanent).....(setq.transient--do
66160 63 73 70 20 6e 69 6c 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 csp.nil))...(setq.transient--edi
66180 74 70 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 tp.nil)...(setq.transient--prefi
661a0 78 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 x.nil)...(setq.transient--layout
661c0 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 .nil)...(setq.transient--suffixe
661e0 73 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6f 72 69 67 69 6e s.nil)...(setq.transient--origin
66200 61 6c 2d 77 69 6e 64 6f 77 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 al-window.nil)...(setq.transient
66220 2d 2d 6f 72 69 67 69 6e 61 6c 2d 62 75 66 66 65 72 20 6e 69 6c 29 0a 20 20 28 73 65 74 71 20 74 --original-buffer.nil)...(setq.t
66240 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 20 6e 69 6c 29 29 0a 0a 28 64 65 66 75 6e 20 74 ransient--window.nil))..(defun.t
66260 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 6f 72 74 20 28 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e ransient--export.()...(setq.tran
66280 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 2d sient-current-prefix.transient--
662a0 70 72 65 66 69 78 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e prefix)...(setq.transient-curren
662c0 74 2d 63 6f 6d 6d 61 6e 64 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 t-command.(oref.transient--prefi
662e0 78 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 x.command))...(setq.transient-cu
66300 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 rrent-suffixes.transient--suffix
66320 65 73 29 0a 20 20 28 75 6e 6c 65 73 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 62 65 2d es)...(unless.(transient--maybe-
66340 73 65 74 2d 76 61 6c 75 65 20 27 65 78 70 6f 72 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e set-value.'export).....(transien
66360 74 2d 2d 68 69 73 74 6f 72 79 2d 70 75 73 68 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 t--history-push.transient--prefi
66380 78 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d x)))..(defun.transient--suspend-
663a0 6f 76 65 72 72 69 64 65 20 28 26 6f 70 74 69 6f 6e 61 6c 20 6e 6f 68 69 64 65 29 0a 20 20 28 74 override.(&optional.nohide)...(t
663c0 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 73 75 73 70 65 6e 64 2d 6f 76 65 72 72 69 64 ransient--debug.'suspend-overrid
663e0 65 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 2d 63 61 6e 63 65 6c 29 0a 20 e)...(transient--timer-cancel)..
66400 20 28 6c 65 74 20 28 28 73 68 6f 77 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 73 65 72 76 .(let.((show.(transient--preserv
66420 65 2d 77 69 6e 64 6f 77 2d 70 20 6e 6f 68 69 64 65 29 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 e-window-p.nohide))).....(cond.(
66440 28 6e 6f 74 20 73 68 6f 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 (not.show)............(transient
66460 2d 2d 64 65 6c 65 74 65 2d 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 61 6e --delete-window))...........((an
66480 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 d.transient--prefix.transient--r
664a0 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 edisplay-key)............(setq.t
664c0 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 20 6e 69 6c 29 0a 20 20 20 ransient--redisplay-key.nil)....
664e0 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 0a 20 ........(when.transient--showp..
66500 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 77 69 6e 20 28 6d 69 6e 69 62 ............(if-let.((win.(minib
66520 75 66 66 65 72 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f 77 29 29 29 0a 20 20 20 20 20 20 20 uffer-selected-window)))........
66540 20 20 20 20 20 20 20 20 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f 77 20 ..........(with-selected-window.
66560 77 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e win....................(transien
66580 74 2d 2d 73 68 6f 77 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 t--show))................(transi
665a0 65 6e 74 2d 2d 73 68 6f 77 29 29 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 28 77 ent--show))))).....(when.(and.(w
665c0 69 6e 64 6f 77 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 0a indow-live-p.transient--window).
665e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 73 68 6f 77 0a 20 20 20 20 20 20 20 ...............(and.show........
66600 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6e 6f 74 20 28 65 71 20 73 68 6f 77 20 27 .............(or.(not.(eq.show.'
66620 66 69 78 65 64 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 fixed)).........................
66640 28 77 69 6e 64 6f 77 2d 66 75 6c 6c 2d 68 65 69 67 68 74 2d 70 20 74 72 61 6e 73 69 65 6e 74 2d (window-full-height-p.transient-
66660 2d 77 69 6e 64 6f 77 29 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 70 61 -window)))).......(set-window-pa
66680 72 61 6d 65 74 65 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 20 27 77 69 6e 64 6f rameter.transient--window.'windo
666a0 77 2d 70 72 65 73 65 72 76 65 64 2d 73 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 w-preserved-size................
666c0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 28 77 69 6e 64 6f 77 2d 62 75 66 66 65 .............(list.(window-buffe
666e0 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 20 6e 69 6c 20 6e 69 6c 29 29 29 29 r.transient--window).nil.nil))))
66700 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 ...(transient--pop-keymap.'trans
66720 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a 20 20 28 74 72 61 6e 73 69 65 6e ient--transient-map)...(transien
66740 74 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 t--pop-keymap.'transient--redisp
66760 6c 61 79 2d 6d 61 70 29 0a 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 27 70 72 65 2d 63 6f 6d lay-map)...(remove-hook.'pre-com
66780 6d 61 6e 64 2d 68 6f 6f 6b 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d 6d mand-hook..#'transient--pre-comm
667a0 61 6e 64 29 0a 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 27 70 6f 73 74 2d 63 6f 6d 6d 61 6e and)...(remove-hook.'post-comman
667c0 64 2d 68 6f 6f 6b 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 d-hook.#'transient--post-command
667e0 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 75 6d 65 2d 6f 76 65 ))..(defun.transient--resume-ove
66800 72 72 69 64 65 20 28 26 6f 70 74 69 6f 6e 61 6c 20 5f 69 67 6e 6f 72 65 29 0a 20 20 28 74 72 61 rride.(&optional._ignore)...(tra
66820 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 72 65 73 75 6d 65 2d 6f 76 65 72 72 69 64 65 29 0a nsient--debug.'resume-override).
66840 20 20 28 77 68 65 6e 20 28 77 69 6e 64 6f 77 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 69 65 6e 74 ..(when.(window-live-p.transient
66860 2d 2d 77 69 6e 64 6f 77 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 69 74 2d 77 69 --window).....(transient--fit-wi
66880 6e 64 6f 77 2d 74 6f 2d 62 75 66 66 65 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 ndow-to-buffer.transient--window
668a0 29 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 73 68 2d 6b 65 79 6d 61 70 20 27 74 72 ))...(transient--push-keymap.'tr
668c0 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 29 0a 20 20 28 74 72 61 6e 73 ansient--transient-map)...(trans
668e0 69 65 6e 74 2d 2d 70 75 73 68 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 ient--push-keymap.'transient--re
66900 64 69 73 70 6c 61 79 2d 6d 61 70 29 0a 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 70 72 65 2d 63 6f display-map)...(add-hook.'pre-co
66920 6d 6d 61 6e 64 2d 68 6f 6f 6b 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 63 6f 6d mmand-hook..#'transient--pre-com
66940 6d 61 6e 64 29 0a 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d mand)...(add-hook.'post-command-
66960 68 6f 6f 6b 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 29 29 hook.#'transient--post-command))
66980 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 63 75 72 73 69 76 65 2d 65 64 ..(defun.transient--recursive-ed
669a0 69 74 20 28 66 6e 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 72 65 63 it.(fn)...(transient--debug.'rec
669c0 75 72 73 69 76 65 2d 65 64 69 74 29 0a 20 20 28 69 66 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e ursive-edit)...(if.(not.transien
669e0 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 66 6e 29 0a 20 20 t--prefix).......(funcall.fn)...
66a00 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 6f 76 65 72 72 69 64 65 20 28 ..(transient--suspend-override.(
66a20 62 6f 75 6e 64 2d 61 6e 64 2d 74 72 75 65 2d 70 20 65 64 65 62 75 67 2d 61 63 74 69 76 65 29 29 bound-and-true-p.edebug-active))
66a40 0a 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 66 6e 29 20 3b 20 41 6c 72 65 61 64 79 20 75 6e 77 69 .....(funcall.fn).;.Already.unwi
66a60 6e 64 20 70 72 6f 74 65 63 74 65 64 2e 0a 20 20 20 20 28 63 6f 6e 64 20 28 28 6d 65 6d 71 20 74 nd.protected......(cond.((memq.t
66a80 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 28 74 6f 70 2d 6c 65 76 65 6c 20 61 62 6f 72 74 2d 72 65 his-command.'(top-level.abort-re
66aa0 63 75 72 73 69 76 65 2d 65 64 69 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 cursive-edit))............(setq.
66ac0 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 transient--exitp.t)............(
66ae0 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 65 78 69 74 20 74 68 69 73 2d 63 6f 6d 6d 61 6e transient--post-exit.this-comman
66b00 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 6c 65 74 65 d)............(transient--delete
66b20 2d 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d -window))...........(transient--
66b40 70 72 65 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 prefix............(transient--re
66b60 73 75 6d 65 2d 6f 76 65 72 72 69 64 65 29 29 29 29 29 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 sume-override)))))..(defmacro.tr
66b80 61 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 73 75 73 70 65 6e 64 65 64 2d 6f 76 65 72 72 69 64 65 ansient--with-suspended-override
66ba0 20 28 26 72 65 73 74 20 62 6f 64 79 29 0a 20 20 28 6c 65 74 20 28 28 64 65 70 74 68 20 28 6d 61 .(&rest.body)...(let.((depth.(ma
66bc0 6b 65 2d 73 79 6d 62 6f 6c 20 22 64 65 70 74 68 22 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 ke-symbol."depth")).........(set
66be0 75 70 20 28 6d 61 6b 65 2d 73 79 6d 62 6f 6c 20 22 73 65 74 75 70 22 29 29 0a 20 20 20 20 20 20 up.(make-symbol."setup")).......
66c00 20 20 28 65 78 69 74 20 20 28 6d 61 6b 65 2d 73 79 6d 62 6f 6c 20 22 65 78 69 74 22 29 29 29 0a ..(exit..(make-symbol."exit"))).
66c20 20 20 20 20 60 28 69 66 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 ....`(if.(and.transient--transie
66c40 6e 74 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 65 6d 71 20 74 72 61 6e 73 nt-map...............(memq.trans
66c60 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 ient--transient-map.............
66c80 20 20 20 20 20 20 20 20 6f 76 65 72 72 69 64 69 6e 67 2d 74 65 72 6d 69 6e 61 6c 2d 6c 6f 63 61 ........overriding-terminal-loca
66ca0 6c 2d 6d 61 70 29 29 0a 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 2c 64 65 70 74 68 20 28 l-map))..........(let.((,depth.(
66cc0 31 2b 20 28 6d 69 6e 69 62 75 66 66 65 72 2d 64 65 70 74 68 29 29 29 20 2c 73 65 74 75 70 20 2c 1+.(minibuffer-depth))).,setup.,
66ce0 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 2c 73 65 74 75 70 0a 20 20 exit)............(setq.,setup...
66d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 20 22 40 74 72 61 6e ...............(lambda.()."@tran
66d20 73 69 65 6e 74 2d 2d 77 69 74 68 2d 73 75 73 70 65 6e 64 65 64 2d 6f 76 65 72 72 69 64 65 22 0a sient--with-suspended-override".
66d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 ...................(transient--d
66d60 65 62 75 67 20 27 6d 69 6e 69 62 75 66 66 65 72 2d 73 65 74 75 70 29 0a 20 20 20 20 20 20 20 20 ebug.'minibuffer-setup).........
66d80 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 27 6d 69 6e 69 62 75 66 ...........(remove-hook.'minibuf
66da0 66 65 72 2d 73 65 74 75 70 2d 68 6f 6f 6b 20 2c 73 65 74 75 70 29 0a 20 20 20 20 20 20 20 20 20 fer-setup-hook.,setup)..........
66dc0 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 6f 76 ..........(transient--suspend-ov
66de0 65 72 72 69 64 65 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 2c 65 78 69 74 erride)))............(setq.,exit
66e00 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 29 20 22 40 74 ..................(lambda.()."@t
66e20 72 61 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 73 75 73 70 65 6e 64 65 64 2d 6f 76 65 72 72 69 64 ransient--with-suspended-overrid
66e40 65 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 e"....................(transient
66e60 2d 2d 64 65 62 75 67 20 27 6d 69 6e 69 62 75 66 66 65 72 2d 65 78 69 74 29 0a 20 20 20 20 20 20 --debug.'minibuffer-exit).......
66e80 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 3d 20 28 6d 69 6e 69 62 75 66 66 65 .............(when.(=.(minibuffe
66ea0 72 2d 64 65 70 74 68 29 20 2c 64 65 70 74 68 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r-depth).,depth)................
66ec0 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 75 6d 65 2d 6f 76 65 72 72 69 64 ......(transient--resume-overrid
66ee0 65 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 75 6e 77 69 6e 64 2d 70 72 6f 74 65 63 74 e))))............(unwind-protect
66f00 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 20 20 ................(progn..........
66f20 20 20 20 20 20 20 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 6d 69 6e 69 62 75 66 66 65 72 2d 73 65 ........(add-hook.'minibuffer-se
66f40 74 75 70 2d 68 6f 6f 6b 20 2c 73 65 74 75 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 tup-hook.,setup)................
66f60 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 6d 69 6e 69 62 75 66 66 65 72 2d 65 78 69 74 2d 68 6f 6f ..(add-hook.'minibuffer-exit-hoo
66f80 6b 20 2c 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2c 40 62 6f 64 79 k.,exit)..................,@body
66fa0 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 27 6d 69 6e )..............(remove-hook.'min
66fc0 69 62 75 66 66 65 72 2d 73 65 74 75 70 2d 68 6f 6f 6b 20 2c 73 65 74 75 70 29 0a 20 20 20 20 20 ibuffer-setup-hook.,setup)......
66fe0 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 27 6d 69 6e 69 62 75 66 66 65 72 ........(remove-hook.'minibuffer
67000 2d 65 78 69 74 2d 68 6f 6f 6b 20 2c 65 78 69 74 29 29 29 0a 20 20 20 20 20 20 20 2c 40 62 6f 64 -exit-hook.,exit)))........,@bod
67020 79 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 72 61 70 2d 63 6f 6d y)))..(defun.transient--wrap-com
67040 6d 61 6e 64 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 61 64 2d 63 6f 6d 6d 61 mand.()...(transient--load-comma
67060 6e 64 2d 69 66 2d 61 75 74 6f 6c 6f 61 64 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 28 nd-if-autoload.this-command)...(
67080 73 74 61 74 69 63 2d 69 66 20 28 3e 3d 20 65 6d 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f static-if.(>=.emacs-major-versio
670a0 6e 20 33 30 29 0a 20 20 20 20 20 20 28 6c 65 74 72 65 63 0a 20 20 20 20 20 20 20 20 20 20 28 28 n.30).......(letrec...........((
670c0 63 6f 6d 6d 61 6e 64 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 command.this-command)...........
670e0 20 28 73 75 66 66 69 78 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 .(suffix.(transient-suffix-objec
67100 74 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 72 65 t.this-command))............(pre
67120 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 fix.transient--prefix)..........
67140 20 20 28 61 64 76 69 63 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 66 ..(advice.............(lambda.(f
67160 6e 20 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 n.&rest.args)...............(int
67180 65 72 61 63 74 69 76 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 eractive................(lambda.
671a0 28 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 61 (spec)..................(let.((a
671c0 62 6f 72 74 20 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 6e 77 bort.t))....................(unw
671e0 69 6e 64 2d 70 72 6f 74 65 63 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ind-protect.....................
67200 20 20 20 28 70 72 6f 67 31 20 28 6c 65 74 20 28 28 64 65 62 75 67 67 65 72 20 23 27 74 72 61 6e ...(prog1.(let.((debugger.#'tran
67220 73 69 65 6e 74 2d 2d 65 78 69 74 2d 61 6e 64 2d 64 65 62 75 67 29 29 0a 20 20 20 20 20 20 20 20 sient--exit-and-debug)).........
67240 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 69 66 2d 6c 65 74 2a ........................(if-let*
67260 20 28 28 6f 62 6a 20 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .((obj.suffix)..................
67280 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 67 72 70 20 28 6f .........................(grp.(o
672a0 72 65 66 20 6f 62 6a 20 70 61 72 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ref.obj.parent))................
672c0 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 61 64 76 20 ...........................(adv.
672e0 28 6f 72 20 28 6f 72 65 66 20 6f 62 6a 20 61 64 76 69 63 65 2a 29 0a 20 20 20 20 20 20 20 20 20 (or.(oref.obj.advice*)..........
67300 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 ................................
67320 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 67 72 70 20 61 64 76 69 63 65 2a 29 29 29 29 0a ..........(oref.grp.advice*)))).
67340 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 ................................
67360 20 20 20 20 28 66 75 6e 63 61 6c 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ....(funcall....................
67380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 64 76 20 23 27 61 64 76 69 63 65 2d 65 ..................adv.#'advice-e
673a0 76 61 6c 2d 69 6e 74 65 72 61 63 74 69 76 65 2d 73 70 65 63 20 73 70 65 63 29 0a 20 20 20 20 20 val-interactive-spec.spec)......
673c0 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 61 64 .............................(ad
673e0 76 69 63 65 2d 65 76 61 6c 2d 69 6e 74 65 72 61 63 74 69 76 65 2d 73 70 65 63 20 73 70 65 63 29 vice-eval-interactive-spec.spec)
67400 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 28 73 65 74 ))..........................(set
67420 71 20 61 62 6f 72 74 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 q.abort.nil))...................
67440 20 20 20 28 77 68 65 6e 20 61 62 6f 72 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ...(when.abort..................
67460 20 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 75 6e 77 69 6e 64 20 28 6f 72 65 66 20 70 ......(when-let.((unwind.(oref.p
67480 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 20 refix.unwind-suffix)))..........
674a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 ................(transient--debu
674c0 67 20 27 75 6e 77 69 6e 64 2d 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 20 20 20 g.'unwind-interactive)..........
674e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 75 6e 77 69 6e 64 20 ................(funcall.unwind.
67500 63 6f 6d 6d 61 6e 64 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 command)).......................
67520 20 28 77 68 65 6e 20 28 73 79 6d 62 6f 6c 70 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 .(when.(symbolp.command)........
67540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 66 75 6e 63 74 69 ..................(remove-functi
67560 6f 6e 20 28 73 79 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 29 20 61 64 76 on.(symbol-function.command).adv
67580 69 63 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 28 6f 73 ice))........................(os
675a0 65 74 20 70 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 20 6e 69 6c 29 29 29 29 29 et.prefix.unwind-suffix.nil)))))
675c0 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 6e 77 69 6e 64 2d 70 72 6f 74 65 63 74 0a )...............(unwind-protect.
675e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 64 65 62 75 67 67 65 ..................(let.((debugge
67600 72 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 2d 61 6e 64 2d 64 65 62 75 67 29 29 0a r.#'transient--exit-and-debug)).
67620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 2a 20 28 28 6f ....................(if-let*.((o
67640 62 6a 20 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 bj.suffix)......................
67660 20 20 20 20 20 20 20 20 20 28 67 72 70 20 28 6f 72 65 66 20 6f 62 6a 20 70 61 72 65 6e 74 29 29 .........(grp.(oref.obj.parent))
67680 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 20 28 ...............................(
676a0 61 64 76 20 28 6f 72 20 28 6f 72 65 66 20 6f 62 6a 20 61 64 76 69 63 65 29 0a 20 20 20 20 20 20 adv.(or.(oref.obj.advice).......
676c0 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 ................................
676e0 20 28 6f 72 65 66 20 6f 62 6a 20 61 64 76 69 63 65 2a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 .(oref.obj.advice*).............
67700 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 6f 72 65 66 ...........................(oref
67720 20 67 72 70 20 61 64 76 69 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .grp.advice)....................
67740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 67 72 70 20 61 64 ....................(oref.grp.ad
67760 76 69 63 65 2a 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 vice*)))).......................
67780 20 20 28 61 70 70 6c 79 20 61 64 76 20 66 6e 20 61 72 67 73 29 0a 20 20 20 20 20 20 20 20 20 20 ..(apply.adv.fn.args)...........
677a0 20 20 20 20 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 20 66 6e 20 61 72 67 73 29 29 29 0a 20 20 ............(apply.fn.args)))...
677c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 75 6e 77 69 6e 64 ..............(when-let.((unwind
677e0 20 28 6f 72 65 66 20 70 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 29 29 29 0a 20 .(oref.prefix.unwind-suffix)))..
67800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 .................(transient--deb
67820 75 67 20 27 75 6e 77 69 6e 64 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ug.'unwind-command).............
67840 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 75 6e 77 69 6e 64 20 63 6f 6d 6d 61 6e 64 29 29 0a ......(funcall.unwind.command)).
67860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 73 79 6d 62 6f 6c 70 20 63 ................(when.(symbolp.c
67880 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 ommand)...................(remov
678a0 65 2d 66 75 6e 63 74 69 6f 6e 20 28 73 79 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 6d e-function.(symbol-function.comm
678c0 61 6e 64 29 20 61 64 76 69 63 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f and).advice)).................(o
678e0 73 65 74 20 70 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 20 6e 69 6c 29 29 29 29 set.prefix.unwind-suffix.nil))))
67900 29 0a 20 20 20 20 20 20 20 20 28 61 64 64 2d 66 75 6e 63 74 69 6f 6e 20 3a 61 72 6f 75 6e 64 20 ).........(add-function.:around.
67920 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 (if.(symbolp.this-command)......
67940 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 73 79 .............................(sy
67960 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 mbol-function.this-command).....
67980 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 74 68 69 73 ............................this
679a0 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -command).......................
679c0 61 64 76 69 63 65 20 27 28 28 64 65 70 74 68 20 2e 20 2d 39 39 29 29 29 0a 20 20 20 20 20 20 20 advice.'((depth...-99)))........
679e0 20 28 63 6c 2d 61 73 73 65 72 74 0a 20 20 20 20 20 20 20 20 20 28 3e 3d 20 65 6d 61 63 73 2d 6d .(cl-assert..........(>=.emacs-m
67a00 61 6a 6f 72 2d 76 65 72 73 69 6f 6e 20 33 30 29 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 22 45 ajor-version.30).nil.........."E
67a20 6d 61 63 73 20 77 61 73 20 64 6f 77 6e 67 72 61 64 65 64 2c 20 6d 61 6b 69 6e 67 20 69 74 20 6e macs.was.downgraded,.making.it.n
67a40 65 63 65 73 73 61 72 79 20 74 6f 20 72 65 63 6f 6d 70 69 6c 65 20 54 72 61 6e 73 69 65 6e 74 22 ecessary.to.recompile.Transient"
67a60 29 29 0a 20 20 20 20 3b 3b 20 28 3c 20 65 6d 61 63 73 2d 6d 61 6a 6f 72 2d 76 65 72 73 69 6f 6e )).....;;.(<.emacs-major-version
67a80 20 33 30 29 0a 20 20 20 20 28 6c 65 74 2a 20 28 28 63 6f 6d 6d 61 6e 64 20 74 68 69 73 2d 63 6f .30).....(let*.((command.this-co
67aa0 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 75 66 66 69 78 20 28 74 72 61 6e 73 mmand)............(suffix.(trans
67ac0 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 ient-suffix-object.this-command)
67ae0 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 2d )............(prefix.transient--
67b00 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 61 64 76 69 63 65 20 6e 69 6c 29 0a prefix)............(advice.nil).
67b20 20 20 20 20 20 20 20 20 20 20 20 28 61 64 76 69 63 65 2d 69 6e 74 65 72 61 63 74 69 76 65 0a 20 ...........(advice-interactive..
67b40 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 73 70 65 63 29 0a 20 20 20 20 20 20 ...........(lambda.(spec).......
67b60 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 61 62 6f 72 74 20 74 29 29 0a 20 20 20 20 20 20 20 ........(let.((abort.t))........
67b80 20 20 20 20 20 20 20 20 20 28 75 6e 77 69 6e 64 2d 70 72 6f 74 65 63 74 0a 20 20 20 20 20 20 20 .........(unwind-protect........
67ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 67 31 20 28 6c 65 74 20 28 28 64 65 62 75 67 .............(prog1.(let.((debug
67bc0 67 65 72 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 2d 61 6e 64 2d 64 65 62 75 67 29 ger.#'transient--exit-and-debug)
67be0 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 20 20 20 28 )..............................(
67c00 69 66 2d 6c 65 74 2a 20 28 28 6f 62 6a 20 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 if-let*.((obj.suffix)...........
67c20 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 67 72 .............................(gr
67c40 70 20 28 6f 72 65 66 20 6f 62 6a 20 70 61 72 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 p.(oref.obj.parent))............
67c60 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 61 64 76 ............................(adv
67c80 20 28 6f 72 20 28 6f 72 65 66 20 6f 62 6a 20 61 64 76 69 63 65 2a 29 0a 20 20 20 20 20 20 20 20 .(or.(oref.obj.advice*).........
67ca0 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 ................................
67cc0 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 67 72 70 20 61 64 76 69 63 65 2a 29 29 29 29 0a 20 20 ........(oref.grp.advice*))))...
67ce0 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 28 ...............................(
67d00 66 75 6e 63 61 6c 6c 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 funcall.........................
67d20 20 20 20 20 20 20 20 20 20 20 61 64 76 20 23 27 61 64 76 69 63 65 2d 65 76 61 6c 2d 69 6e 74 65 ..........adv.#'advice-eval-inte
67d40 72 61 63 74 69 76 65 2d 73 70 65 63 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ractive-spec.spec)..............
67d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 64 76 69 63 65 2d 65 76 61 6c 2d 69 ..................(advice-eval-i
67d80 6e 74 65 72 61 63 74 69 76 65 2d 73 70 65 63 20 73 70 65 63 29 29 29 0a 20 20 20 20 20 20 20 20 nteractive-spec.spec))).........
67da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 61 62 6f 72 74 20 6e 69 6c 29 29 0a ..............(setq.abort.nil)).
67dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 61 62 6f 72 74 0a 20 20 ..................(when.abort...
67de0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 75 6e ..................(when-let.((un
67e00 77 69 6e 64 20 28 6f 72 65 66 20 70 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 29 wind.(oref.prefix.unwind-suffix)
67e20 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 28 74 72 61 6e 73 69 )).......................(transi
67e40 65 6e 74 2d 2d 64 65 62 75 67 20 27 75 6e 77 69 6e 64 2d 69 6e 74 65 72 61 63 74 69 76 65 29 0a ent--debug.'unwind-interactive).
67e60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 75 ......................(funcall.u
67e80 6e 77 69 6e 64 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nwind.command)).................
67ea0 20 20 20 20 28 77 68 65 6e 20 28 73 79 6d 62 6f 6c 70 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 ....(when.(symbolp.command).....
67ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 66 75 6e 63 74 69 ..................(remove-functi
67ee0 6f 6e 20 28 73 79 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 29 20 61 64 76 on.(symbol-function.command).adv
67f00 69 63 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 ice)).....................(oset.
67f20 70 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 20 6e 69 6c 29 29 29 29 29 29 0a 20 prefix.unwind-suffix.nil))))))..
67f40 20 20 20 20 20 20 20 20 20 20 28 61 64 76 69 63 65 2d 62 6f 64 79 0a 20 20 20 20 20 20 20 20 20 ..........(advice-body..........
67f60 20 20 20 28 6c 61 6d 62 64 61 20 28 66 6e 20 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 20 20 20 ...(lambda.(fn.&rest.args)......
67f80 20 20 20 20 20 20 20 20 20 28 75 6e 77 69 6e 64 2d 70 72 6f 74 65 63 74 0a 20 20 20 20 20 20 20 .........(unwind-protect........
67fa0 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 64 65 62 75 67 67 65 72 20 23 27 74 72 61 ...........(let.((debugger.#'tra
67fc0 6e 73 69 65 6e 74 2d 2d 65 78 69 74 2d 61 6e 64 2d 64 65 62 75 67 29 29 0a 20 20 20 20 20 20 20 nsient--exit-and-debug))........
67fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 2a 20 28 28 6f 62 6a 20 73 75 66 66 .............(if-let*.((obj.suff
68000 69 78 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 20 20 ix).............................
68020 20 20 28 67 72 70 20 28 6f 72 65 66 20 6f 62 6a 20 70 61 72 65 6e 74 29 29 0a 20 20 20 20 20 20 ..(grp.(oref.obj.parent)).......
68040 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 61 64 76 20 28 6f 72 ........................(adv.(or
68060 20 28 6f 72 65 66 20 6f 62 6a 20 61 64 76 69 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .(oref.obj.advice)..............
68080 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 6f 72 65 66 20 ..........................(oref.
680a0 6f 62 6a 20 61 64 76 69 63 65 2a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 obj.advice*)....................
680c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 67 72 70 20 61 64 ....................(oref.grp.ad
680e0 76 69 63 65 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 vice)...........................
68100 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 67 72 70 20 61 64 76 69 63 65 2a 29 29 .............(oref.grp.advice*))
68120 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 61 70 70 6c )).........................(appl
68140 79 20 61 64 76 20 66 6e 20 61 72 67 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y.adv.fn.args)..................
68160 20 20 20 20 20 28 61 70 70 6c 79 20 66 6e 20 61 72 67 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 .....(apply.fn.args)))..........
68180 20 20 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 75 6e 77 69 6e 64 20 28 6f 72 65 66 20 .......(when-let.((unwind.(oref.
681a0 70 72 65 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 prefix.unwind-suffix))).........
681c0 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 75 6e 77 ..........(transient--debug.'unw
681e0 69 6e 64 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 ind-command)...................(
68200 66 75 6e 63 61 6c 6c 20 75 6e 77 69 6e 64 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 funcall.unwind.command))........
68220 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 73 79 6d 62 6f 6c 70 20 63 6f 6d 6d 61 6e 64 29 .........(when.(symbolp.command)
68240 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 66 75 6e 63 74 ...................(remove-funct
68260 69 6f 6e 20 28 73 79 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 29 20 61 64 ion.(symbol-function.command).ad
68280 76 69 63 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 70 72 65 vice)).................(oset.pre
682a0 66 69 78 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 20 6e 69 6c 29 29 29 29 29 0a 20 20 20 20 20 fix.unwind-suffix.nil)))))......
682c0 20 28 73 65 74 71 20 61 64 76 69 63 65 20 60 28 6c 61 6d 62 64 61 20 28 66 6e 20 26 72 65 73 74 .(setq.advice.`(lambda.(fn.&rest
682e0 20 61 72 67 73 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 .args).......................(in
68300 74 65 72 61 63 74 69 76 65 20 2c 61 64 76 69 63 65 2d 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 teractive.,advice-interactive)..
68320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 20 27 2c 61 64 .....................(apply.',ad
68340 76 69 63 65 2d 62 6f 64 79 20 66 6e 20 61 72 67 73 29 29 29 0a 20 20 20 20 20 20 28 61 64 64 2d vice-body.fn.args))).......(add-
68360 66 75 6e 63 74 69 6f 6e 20 3a 61 72 6f 75 6e 64 20 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 74 68 function.:around.(if.(symbolp.th
68380 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 is-command).....................
683a0 20 20 20 20 20 20 20 20 20 20 20 20 28 73 79 6d 62 6f 6c 2d 66 75 6e 63 74 69 6f 6e 20 74 68 69 ............(symbol-function.thi
683c0 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s-command)......................
683e0 20 20 20 20 20 20 20 20 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 .........this-command)..........
68400 20 20 20 20 20 20 20 20 20 20 20 61 64 76 69 63 65 20 27 28 28 64 65 70 74 68 20 2e 20 2d 39 39 ...........advice.'((depth...-99
68420 29 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 6d 61 74 ))))))..(defun.transient--premat
68440 75 72 65 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 20 28 29 0a 20 20 28 61 6e 64 20 28 65 71 75 61 ure-post-command.()...(and.(equa
68460 6c 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 2d 76 65 63 74 6f 72 29 20 5b 5d 29 l.(this-command-keys-vector).[])
68480 0a 20 20 20 20 20 20 20 28 3d 20 28 6d 69 6e 69 62 75 66 66 65 72 2d 64 65 70 74 68 29 0a 20 20 ........(=.(minibuffer-depth)...
684a0 20 20 20 20 20 20 20 20 28 31 2b 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 69 6e 69 62 75 66 66 65 ........(1+.transient--minibuffe
684c0 72 2d 64 65 70 74 68 29 29 0a 20 20 20 20 20 20 20 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 20 r-depth))........(progn.........
684e0 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 70 72 65 6d 61 74 75 72 65 2d 70 6f .(transient--debug.'premature-po
68500 73 74 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d st-command)..........(transient-
68520 2d 73 75 73 70 65 6e 64 2d 6f 76 65 72 72 69 64 65 29 0a 20 20 20 20 20 20 20 20 20 28 6f 73 65 -suspend-override)..........(ose
68540 74 20 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e t.(or.transient--prefix.transien
68560 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t-current-prefix)...............
68580 20 75 6e 77 69 6e 64 2d 73 75 66 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 .unwind-suffix................(i
685a0 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 f.transient--exitp..............
685c0 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 65 78 69 74 0a 20 20 20 ......#'transient--post-exit....
685e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 75 6d ..............#'transient--resum
68600 65 2d 6f 76 65 72 72 69 64 65 29 29 0a 20 20 20 20 20 20 20 20 20 74 29 29 29 0a 0a 28 64 65 66 e-override))..........t)))..(def
68620 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 20 28 29 0a 20 20 un.transient--post-command.()...
68640 28 75 6e 6c 65 73 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 6d 61 74 75 72 65 2d 70 6f (unless.(transient--premature-po
68660 73 74 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 st-command).....(transient--debu
68680 67 20 27 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d g.'post-command).....(transient-
686a0 2d 77 69 74 68 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 70 6f 73 74 2d 63 6f 6d 6d 61 -with-emergency-exit.:post-comma
686c0 6e 64 0a 20 20 20 20 20 20 28 63 6f 6e 64 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 nd.......(cond.(transient--exitp
686e0 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 65 78 69 74 29 29 0a 20 20 20 20 20 20 20 .(transient--post-exit))........
68700 20 20 20 20 20 3b 3b 20 49 66 20 60 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 27 20 69 73 20 74 68 65 .....;;.If.`this-command'.is.the
68720 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 .current.transient.prefix,.then.
68740 77 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 74 we.............;;.have.already.t
68760 61 6b 65 6e 20 63 61 72 65 20 6f 66 20 75 70 64 61 74 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 aken.care.of.updating.the.transi
68780 65 6e 74 20 62 75 66 66 65 72 2e 2e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 28 61 6e 64 20 ent.buffer................((and.
687a0 28 65 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 (eq.this-command.(oref.transient
687c0 2d 2d 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 --prefix.command))..............
687e0 20 20 20 20 20 3b 3b 20 2e 2e 2e 20 62 75 74 20 69 66 20 60 70 72 65 66 69 78 2d 61 72 67 27 20 .....;;.....but.if.`prefix-arg'.
68800 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 73 0a 20 20 20 20 is.non-nil,.then.the.values.....
68820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 6f 66 20 60 74 68 69 73 2d 63 6f 6d 6d 61 6e ..............;;.of.`this-comman
68840 64 27 20 61 6e 64 20 60 72 65 61 6c 2d 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 27 20 61 72 65 20 75 d'.and.`real-this-command'.are.u
68860 6e 74 72 75 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 62 65 63 61 75 ntrue...................;;.becau
68880 73 65 20 60 70 72 65 66 69 78 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 73 65 72 76 65 2d 73 74 61 74 se.`prefix-command-preserve-stat
688a0 65 27 20 63 68 61 6e 67 65 73 20 74 68 65 6d 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e'.changes.them.................
688c0 20 20 20 3b 3b 20 57 65 20 63 61 6e 6e 6f 74 20 75 73 65 20 60 63 75 72 72 65 6e 74 2d 70 72 65 ...;;.We.cannot.use.`current-pre
688e0 66 69 78 2d 61 72 67 27 20 62 65 63 61 75 73 65 20 69 74 20 69 73 20 73 65 74 0a 20 20 20 20 20 fix-arg'.because.it.is.set......
68900 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 74 6f 6f 20 6c 61 74 65 20 28 69 6e 20 60 63 6f .............;;.too.late.(in.`co
68920 6d 6d 61 6e 64 2d 65 78 65 63 75 74 65 27 29 2c 20 61 6e 64 20 69 66 20 69 74 20 77 65 72 65 20 mmand-execute'),.and.if.it.were.
68940 73 65 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 65 61 72 6c 69 65 72 set...................;;.earlier
68960 2c 20 74 68 65 6e 20 77 65 20 6c 69 6b 65 6c 79 20 73 74 69 6c 6c 20 77 6f 75 6c 64 20 6e 6f 74 ,.then.we.likely.still.would.not
68980 20 62 65 20 61 62 6c 65 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b .be.able.to...................;;
689a0 20 72 65 6c 79 20 6f 6e 20 69 74 2c 20 61 6e 64 20 60 70 72 65 66 69 78 2d 63 6f 6d 6d 61 6e 64 .rely.on.it,.and.`prefix-command
689c0 2d 70 72 65 73 65 72 76 65 2d 73 74 61 74 65 2d 68 6f 6f 6b 27 0a 20 20 20 20 20 20 20 20 20 20 -preserve-state-hook'...........
689e0 20 20 20 20 20 20 20 20 3b 3b 20 77 6f 75 6c 64 20 68 61 76 65 20 74 6f 20 62 65 20 75 73 65 64 ........;;.would.have.to.be.used
68a00 20 74 6f 20 72 65 63 6f 72 64 20 74 68 61 74 20 61 20 75 6e 69 76 65 72 73 61 6c 0a 20 20 20 20 .to.record.that.a.universal.....
68a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 61 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 20 ..............;;.argument.is.in.
68a40 65 66 66 65 63 74 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 70 effect....................(not.p
68a60 72 65 66 69 78 2d 61 72 67 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 refix-arg))).............(transi
68a80 65 6e 74 2d 2d 72 65 66 72 65 73 68 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e ent--refreshp..............(tran
68aa0 73 69 65 6e 74 2d 2d 65 6e 76 2d 61 70 70 6c 79 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 sient--env-apply.#'transient--re
68ac0 66 72 65 73 68 2d 74 72 61 6e 73 69 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 28 fresh-transient)).............((
68ae0 6c 65 74 20 28 28 6f 6c 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d let.((old.transient--redisplay-m
68b00 61 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 65 77 20 28 74 72 61 ap)....................(new.(tra
68b20 6e 73 69 65 6e 74 2d 2d 6d 61 6b 65 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 29 29 29 0a 20 20 nsient--make-redisplay-map)))...
68b40 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 65 71 75 61 6c 20 6f 6c 64 20 .............(unless.(equal.old.
68b60 6e 65 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 new)..................(transient
68b80 2d 2d 70 6f 70 2d 6b 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c --pop-keymap.'transient--redispl
68ba0 61 79 2d 6d 61 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 ay-map)..................(setq.t
68bc0 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 20 6e 65 77 29 0a 20 20 20 ransient--redisplay-map.new)....
68be0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 75 73 68 2d 6b ..............(transient--push-k
68c00 65 79 6d 61 70 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6d 61 70 29 eymap.'transient--redisplay-map)
68c20 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 6e 76 )................(transient--env
68c40 2d 61 70 70 6c 79 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 29 29 29 -apply.#'transient--redisplay)))
68c60 29 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 )).....(setq.transient-current-p
68c80 72 65 66 69 78 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 refix.nil).....(setq.transient-c
68ca0 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 urrent-command.nil).....(setq.tr
68cc0 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 20 6e 69 6c 29 0a 20 20 ansient-current-suffixes.nil)...
68ce0 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 ..(setq.transient--current-suffi
68d00 78 20 6e 69 6c 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 x.nil)))..(defun.transient--post
68d20 2d 65 78 69 74 20 28 26 6f 70 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 28 74 72 61 -exit.(&optional.command)...(tra
68d40 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 70 6f 73 74 2d 65 78 69 74 29 0a 20 20 28 75 6e 6c nsient--debug.'post-exit)...(unl
68d60 65 73 73 20 28 61 6e 64 20 28 65 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 27 72 ess.(and.(eq.transient--exitp.'r
68d80 65 70 6c 61 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 74 72 61 6e 73 eplace)................(or.trans
68da0 69 65 6e 74 2d 2d 70 72 65 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ient--prefix....................
68dc0 3b 3b 20 54 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 63 6f 75 6c 64 20 61 63 74 ;;.The.current.command.could.act
68de0 20 61 73 20 61 20 70 72 65 66 69 78 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .as.a.prefix,...................
68e00 20 3b 3b 20 62 75 74 20 64 65 63 69 64 65 64 20 6e 6f 74 20 74 6f 20 63 61 6c 6c 20 60 74 72 61 .;;.but.decided.not.to.call.`tra
68e20 6e 73 69 65 6e 74 2d 73 65 74 75 70 27 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nsient-setup',..................
68e40 20 20 3b 3b 20 6f 72 20 69 74 20 69 73 20 70 72 65 76 65 6e 74 65 64 20 66 72 6f 6d 20 64 6f 69 ..;;.or.it.is.prevented.from.doi
68e60 6e 67 20 73 6f 20 62 65 63 61 75 73 65 20 69 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ng.so.because.it................
68e80 20 20 20 20 3b 3b 20 75 73 65 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 61 6e 64 20 74 ....;;.uses.the.minibuffer.and.t
68ea0 68 65 20 75 73 65 72 20 61 62 6f 72 74 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 he.user.aborted.................
68ec0 20 20 20 3b 3b 20 74 68 61 74 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 ...;;.that.....................(
68ee0 70 72 6f 67 31 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 prog1.nil......................(
68f00 69 66 20 28 6c 65 74 20 28 28 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d if.(let.((obj.(transient-suffix-
68f20 6f 62 6a 65 63 74 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 object.command)))...............
68f40 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f .............(and.(slot-boundp.o
68f60 62 6a 20 27 74 72 61 6e 73 69 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 bj.'transient)..................
68f80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 74 72 61 6e 73 69 65 ...............(oref.obj.transie
68fa0 6e 74 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 20 20 3b nt)))..........................;
68fc0 3b 20 54 68 69 73 20 73 75 62 2d 70 72 65 66 69 78 20 69 73 20 61 20 74 72 61 6e 73 69 65 6e 74 ;.This.sub-prefix.is.a.transient
68fe0 20 73 75 66 66 69 78 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .suffix;........................
69000 20 20 3b 3b 20 67 6f 20 62 61 63 6b 20 74 6f 20 6f 75 74 65 72 20 70 72 65 66 69 78 2c 20 62 79 ..;;.go.back.to.outer.prefix,.by
69020 20 63 61 6c 6c 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .calling........................
69040 20 20 3b 3b 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 70 6f 70 27 20 66 75 72 74 ..;;.`transient--stack-pop'.furt
69060 68 65 72 20 64 6f 77 6e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 her.down........................
69080 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 6e 69 6c 29 0a 20 ...(setq.transient--exitp.nil)..
690a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 ......................(transient
690c0 2d 2d 73 74 61 63 6b 2d 7a 61 70 29 29 29 29 29 0a 20 20 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f --stack-zap))))).....(remove-hoo
690e0 6b 20 27 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 20 20 23 27 74 72 61 6e 73 69 65 6e 74 k.'pre-command-hook..#'transient
69100 2d 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 --pre-command).....(remove-hook.
69120 27 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 'post-command-hook.#'transient--
69140 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 28 61 64 76 69 63 65 2d 72 65 6d 6f 76 65 post-command).....(advice-remove
69160 20 27 72 65 63 75 72 73 69 76 65 2d 65 64 69 74 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 .'recursive-edit.#'transient--re
69180 63 75 72 73 69 76 65 2d 65 64 69 74 29 29 0a 20 20 28 6c 65 74 20 28 28 72 65 70 6c 61 63 65 20 cursive-edit))...(let.((replace.
691a0 28 65 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 27 72 65 70 6c 61 63 65 29 29 0a (eq.transient--exitp.'replace)).
691c0 20 20 20 20 20 20 20 20 28 72 65 73 75 6d 65 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d ........(resume.(and.transient--
691e0 73 74 61 63 6b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 stack......................(not.
69200 28 6d 65 6d 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 27 28 72 65 70 6c 61 63 65 (memq.transient--exitp.'(replace
69220 20 73 75 73 70 65 6e 64 29 29 29 29 29 29 0a 20 20 20 20 28 75 6e 6c 65 73 73 20 28 6f 72 20 72 .suspend)))))).....(unless.(or.r
69240 65 73 75 6d 65 20 72 65 70 6c 61 63 65 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 esume.replace).......(setq.trans
69260 69 65 6e 74 2d 2d 73 68 6f 77 70 20 6e 69 6c 29 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e ient--showp.nil)).....(setq.tran
69280 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e sient--exitp.nil).....(setq.tran
692a0 73 69 65 6e 74 2d 2d 68 65 6c 70 70 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e sient--helpp.nil).....(setq.tran
692c0 73 69 65 6e 74 2d 2d 65 64 69 74 70 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e sient--editp.nil).....(setq.tran
692e0 73 69 65 6e 74 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 sient--all-levels-p.nil).....(se
69300 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 69 6e 69 62 75 66 66 65 72 2d 64 65 70 74 68 20 30 tq.transient--minibuffer-depth.0
69320 29 0a 20 20 20 20 28 72 75 6e 2d 68 6f 6f 6b 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 78 69 74 ).....(run-hooks.'transient-exit
69340 2d 68 6f 6f 6b 29 0a 20 20 20 20 28 77 68 65 6e 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 28 -hook).....(when.command.......(
69360 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 20 6e 69 setq.transient-current-prefix.ni
69380 6c 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 l).......(setq.transient-current
693a0 2d 63 6f 6d 6d 61 6e 64 20 6e 69 6c 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 -command.nil).......(setq.transi
693c0 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 65 73 20 6e 69 6c 29 0a 20 20 20 20 20 20 ent-current-suffixes.nil).......
693e0 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 20 (setq.transient--current-suffix.
69400 6e 69 6c 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 72 65 73 75 6d 65 20 28 74 72 61 6e 73 69 65 nil)).....(cond.(resume.(transie
69420 6e 74 2d 2d 73 74 61 63 6b 2d 70 6f 70 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 6e 6f 74 20 nt--stack-pop))...........((not.
69440 72 65 70 6c 61 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d replace)............(transient--
69460 71 75 69 74 2d 6b 6c 75 64 67 65 20 27 64 69 73 61 62 6c 65 29 0a 20 20 20 20 20 20 20 20 20 20 quit-kludge.'disable)...........
69480 20 28 72 75 6e 2d 68 6f 6f 6b 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 70 6f 73 74 2d 65 78 69 74 .(run-hooks.'transient-post-exit
694a0 2d 68 6f 6f 6b 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 -hook)))))..(defun.transient--st
694c0 61 63 6b 2d 70 75 73 68 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 ack-push.()...(transient--debug.
694e0 27 73 74 61 63 6b 2d 70 75 73 68 29 0a 20 20 28 70 75 73 68 20 28 6c 69 73 74 20 28 6f 72 65 66 'stack-push)...(push.(list.(oref
69500 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 .transient--prefix.command).....
69520 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 61 79 6f 75 74 0a 20 20 20 20 ..........transient--layout.....
69540 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 0a 20 20 20 20 20 ..........transient--editp......
69560 20 20 20 20 20 20 20 20 20 3a 76 61 6c 75 65 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 .........:value..(transient--get
69580 2d 65 78 74 65 6e 64 65 64 2d 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a -extended-value)...............:
695a0 72 65 74 75 72 6e 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 72 return.(oref.transient--prefix.r
695c0 65 74 75 72 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 73 63 6f 70 65 20 20 28 6f 72 eturn)...............:scope..(or
695e0 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 73 63 6f 70 65 29 29 0a 20 20 20 ef.transient--prefix.scope))....
69600 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 29 29 0a 0a 28 64 65 66 75 6e 20 .....transient--stack))..(defun.
69620 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 70 6f 70 20 28 29 0a 20 20 28 74 72 61 6e 73 transient--stack-pop.()...(trans
69640 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 73 74 61 63 6b 2d 70 6f 70 29 0a 20 20 28 61 6e 64 20 74 ient--debug.'stack-pop)...(and.t
69660 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 0a 20 20 20 20 20 20 20 28 70 72 6f 67 31 20 74 20 ransient--stack........(prog1.t.
69680 28 61 70 70 6c 79 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 20 28 70 6f 70 20 74 72 (apply.#'transient-setup.(pop.tr
696a0 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e ansient--stack)))))..(defun.tran
696c0 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 7a 61 70 20 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 sient--stack-zap.()...(transient
696e0 2d 2d 64 65 62 75 67 20 27 73 74 61 63 6b 2d 7a 61 70 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e --debug.'stack-zap)...(setq.tran
69700 73 69 65 6e 74 2d 2d 73 74 61 63 6b 20 6e 69 6c 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 sient--stack.nil))..(defun.trans
69720 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 20 28 29 0a 20 20 28 69 66 20 28 6f 72 20 28 65 71 ient--redisplay.()...(if.(or.(eq
69740 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 6f 70 75 70 20 74 29 0a 20 20 20 20 20 20 20 .transient-show-popup.t)........
69760 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 29 0a 20 20 20 20 20 20 28 75 6e 6c 65 ...transient--showp).......(unle
69780 73 73 0a 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6d 65 6d 71 20 74 68 69 73 2d 63 6f 6d 6d ss...........(or.(memq.this-comm
697a0 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 63 72 6f 6c 6c 2d 63 6f 6d 6d 61 6e 64 73 29 0a and.transient--scroll-commands).
697c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6f 72 20 28 6d 65 6d 71 20 74 68 69 ..............(and.(or.(memq.thi
697e0 73 2d 63 6f 6d 6d 61 6e 64 20 27 28 6d 6f 75 73 65 2d 64 72 61 67 2d 72 65 67 69 6f 6e 0a 20 20 s-command.'(mouse-drag-region...
69800 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 ................................
69820 20 20 20 20 20 20 20 20 20 20 6d 6f 75 73 65 2d 73 65 74 2d 72 65 67 69 6f 6e 29 29 0a 20 20 20 ..........mouse-set-region))....
69840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 75 61 6c 20 28 6b 65 79 2d ....................(equal.(key-
69860 64 65 73 63 72 69 70 74 69 6f 6e 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 2d 76 description.(this-command-keys-v
69880 65 63 74 6f 72 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 ector)).........................
698a0 20 20 20 20 20 20 22 3c 6d 6f 75 73 65 2d 6d 6f 76 65 6d 65 6e 74 3e 22 29 29 0a 20 20 20 20 20 ......"<mouse-movement>"))......
698c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 65 71 20 28 63 75 72 72 65 6e 74 2d ..............(and.(eq.(current-
698e0 62 75 66 66 65 72 29 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 29 29 29 29 0a 20 20 buffer).transient--buffer))))...
69900 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 20 20 20 20 28 77 68 ......(transient--show)).....(wh
69920 65 6e 20 28 61 6e 64 20 28 6e 75 6d 62 65 72 70 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d en.(and.(numberp.transient-show-
69940 70 6f 70 75 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 7a 65 72 6f popup)................(not.(zero
69960 70 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 6f 70 75 70 29 29 0a 20 20 20 20 20 20 20 p.transient-show-popup))........
69980 20 20 20 20 20 20 20 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 29 29 0a ........(not.transient--timer)).
699a0 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 2d 73 74 61 72 74 29 29 0a ......(transient--timer-start)).
699c0 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 68 69 6e 74 29 29 29 0a 0a 28 64 ....(transient--show-hint)))..(d
699e0 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 2d 73 74 61 72 74 20 28 29 0a 20 efun.transient--timer-start.()..
69a00 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 0a 20 20 20 20 20 20 20 20 .(setq.transient--timer.........
69a20 28 72 75 6e 2d 61 74 2d 74 69 6d 65 20 28 61 62 73 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 (run-at-time.(abs.transient-show
69a40 2d 70 6f 70 75 70 29 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -popup).nil.....................
69a60 20 28 6c 61 6d 62 64 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 .(lambda.().....................
69a80 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 2d 63 61 6e 63 65 6c 29 0a 20 20 20 ...(transient--timer-cancel)....
69aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d ....................(transient--
69ac0 73 68 6f 77 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 28 6c 65 show)........................(le
69ae0 74 20 28 28 6d 65 73 73 61 67 65 2d 6c 6f 67 2d 6d 61 78 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 t.((message-log-max.nil)).......
69b00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 65 73 73 61 67 65 20 22 22 29 29 ...................(message.""))
69b20 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 2d 63 61 ))))..(defun.transient--timer-ca
69b40 6e 63 65 6c 20 28 29 0a 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 ncel.()...(when.transient--timer
69b60 0a 20 20 20 20 28 63 61 6e 63 65 6c 2d 74 69 6d 65 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 .....(cancel-timer.transient--ti
69b80 6d 65 72 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 20 mer).....(setq.transient--timer.
69ba0 6e 69 6c 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 nil)))..(defun.transient--debug.
69bc0 28 61 72 67 20 26 72 65 73 74 20 61 72 67 73 29 0a 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 (arg.&rest.args)...(when.transie
69be0 6e 74 2d 2d 64 65 62 75 67 0a 20 20 20 20 28 6c 65 74 20 28 28 69 6e 68 69 62 69 74 2d 6d 65 73 nt--debug.....(let.((inhibit-mes
69c00 73 61 67 65 20 28 6e 6f 74 20 28 65 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 sage.(not.(eq.transient--debug.'
69c20 6d 65 73 73 61 67 65 29 29 29 29 0a 20 20 20 20 20 20 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 61 message)))).......(if.(symbolp.a
69c40 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 28 6d 65 73 73 61 67 65 20 22 2d 2d 20 25 2d 32 32 73 rg)...........(message."--.%-22s
69c60 20 28 63 6d 64 3a 20 25 73 2c 20 65 76 65 6e 74 3a 20 25 53 2c 20 65 78 69 74 3a 20 25 73 25 73 .(cmd:.%s,.event:.%S,.exit:.%s%s
69c80 29 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 0a 20 20 20 20 20 20 )"....................arg.......
69ca0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 20 28 28 61 6e 64 20 28 73 79 6d 62 6f 6c .............(cond.((and.(symbol
69cc0 70 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 p.this-command).this-command))..
69ce0 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 28 66 62 6f 75 6e 64 ........................((fbound
69d00 70 20 27 68 65 6c 70 2d 66 6e 73 2d 66 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 29 0a 20 20 20 20 20 p.'help-fns-function-name)......
69d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 68 65 6c 70 2d 66 6e 73 2d 66 .....................(help-fns-f
69d40 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 unction-name.this-command)).....
69d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 62 79 74 65 2d 63 6f 64 65 .....................((byte-code
69d80 2d 66 75 6e 63 74 69 6f 6e 2d 70 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 -function-p.this-command).......
69da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 23 5b 2e 2e 2e 5d 22 29 0a 20 20 ...................."#[...]")...
69dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 68 69 73 2d 63 6f 6d .......................(this-com
69de0 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6b 65 79 2d 64 mand))....................(key-d
69e00 65 73 63 72 69 70 74 69 6f 6e 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 2d 76 65 escription.(this-command-keys-ve
69e20 63 74 6f 72 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 ctor))....................transi
69e40 65 6e 74 2d 2d 65 78 69 74 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 ent--exitp....................(c
69e60 6f 6e 64 20 28 28 6b 65 79 77 6f 72 64 70 20 28 63 61 72 20 61 72 67 73 29 29 0a 20 20 20 20 20 ond.((keywordp.(car.args))......
69e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 2c 20 .....................(format.",.
69ea0 66 72 6f 6d 3a 20 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 from:.%s".......................
69ec0 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 62 73 74 72 69 6e 67 20 28 73 79 6d 62 6f 6c 2d 6e ............(substring.(symbol-n
69ee0 61 6d 65 20 28 63 61 72 20 61 72 67 73 29 29 20 31 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 ame.(car.args)).1)))............
69f00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 73 74 72 69 6e 67 70 20 28 63 61 72 20 61 72 67 ..............((stringp.(car.arg
69f20 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 63 s))...........................(c
69f40 6f 6e 63 61 74 20 22 2c 20 22 20 28 61 70 70 6c 79 20 23 27 66 6f 72 6d 61 74 20 61 72 67 73 29 oncat.",.".(apply.#'format.args)
69f60 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 28 28 66 75 ))..........................((fu
69f80 6e 63 74 69 6f 6e 70 20 28 63 61 72 20 61 72 67 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 nctionp.(car.args)).............
69fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 63 61 74 20 22 2c 20 22 20 28 61 70 70 6c ..............(concat.",.".(appl
69fc0 79 20 28 63 61 72 20 61 72 67 73 29 20 28 63 64 72 20 61 72 67 73 29 29 29 29 0a 20 20 20 20 20 y.(car.args).(cdr.args))))......
69fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 22 22 29 29 29 0a 20 20 20 20 20 ....................("")))......
6a000 20 20 20 28 61 70 70 6c 79 20 23 27 6d 65 73 73 61 67 65 20 61 72 67 20 61 72 67 73 29 29 29 29 ...(apply.#'message.arg.args))))
6a020 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 6d 65 72 67 65 6e 63 79 2d 65 )..(defun.transient--emergency-e
6a040 78 69 74 20 28 26 6f 70 74 69 6f 6e 61 6c 20 69 64 29 0a 20 20 22 45 78 69 74 20 74 68 65 20 63 xit.(&optional.id)..."Exit.the.c
6a060 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 61 urrent.transient.command.after.a
6a080 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 0a 57 68 65 6e 20 6e 6f 20 74 72 61 6e 73 69 n.error.occurred..When.no.transi
6a0a0 65 6e 74 20 69 73 20 61 63 74 69 76 65 20 28 69 2e 65 2e 2c 20 77 68 65 6e 20 60 74 72 61 6e 73 ent.is.active.(i.e.,.when.`trans
6a0c0 69 65 6e 74 2d 2d 70 72 65 66 69 78 27 20 69 73 0a 6e 69 6c 29 20 74 68 65 6e 20 6f 6e 6c 79 20 ient--prefix'.is.nil).then.only.
6a0e0 72 65 73 65 74 20 60 69 6e 68 69 62 69 74 2d 71 75 69 74 27 2e 20 20 4f 70 74 69 6f 6e 61 6c 20 reset.`inhibit-quit'...Optional.
6a100 49 44 20 69 73 20 61 20 6b 65 79 77 6f 72 64 0a 69 64 65 6e 74 69 66 79 69 6e 67 20 74 68 65 20 ID.is.a.keyword.identifying.the.
6a120 65 78 69 74 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 27 65 6d 65 72 exit."...(transient--debug.'emer
6a140 67 65 6e 63 79 2d 65 78 69 74 20 69 64 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 71 75 69 gency-exit.id)...(transient--qui
6a160 74 2d 6b 6c 75 64 67 65 20 27 64 69 73 61 62 6c 65 29 0a 20 20 28 77 68 65 6e 20 74 72 61 6e 73 t-kludge.'disable)...(when.trans
6a180 69 65 6e 74 2d 2d 70 72 65 66 69 78 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 ient--prefix.....(setq.transient
6a1a0 2d 2d 73 74 61 63 6b 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 --stack.nil).....(setq.transient
6a1c0 2d 2d 65 78 69 74 70 20 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d 65 --exitp.t).....(transient--pre-e
6a1e0 78 69 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 65 78 69 74 20 74 xit).....(transient--post-exit.t
6a200 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 his-command)))..(defun.transient
6a220 2d 2d 71 75 69 74 2d 6b 6c 75 64 67 65 20 28 61 63 74 69 6f 6e 29 0a 20 20 28 73 74 61 74 69 63 --quit-kludge.(action)...(static
6a240 2d 69 66 20 28 62 6f 75 6e 64 70 20 27 72 65 64 69 73 70 6c 61 79 2d 63 61 6e 2d 71 75 69 74 29 -if.(boundp.'redisplay-can-quit)
6a260 20 3b 45 6d 61 63 73 20 33 31 0a 20 20 20 20 20 20 61 63 74 69 6f 6e 0a 20 20 20 20 28 70 63 61 .;Emacs.31.......action.....(pca
6a280 73 65 2d 65 78 68 61 75 73 74 69 76 65 20 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 28 27 65 6e 61 se-exhaustive.action.......('ena
6a2a0 62 6c 65 0a 20 20 20 20 20 20 20 28 61 64 64 2d 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 ble........(add-function........
6a2c0 20 3a 61 72 6f 75 6e 64 20 63 6f 6d 6d 61 6e 64 2d 65 72 72 6f 72 2d 66 75 6e 63 74 69 6f 6e 0a .:around.command-error-function.
6a2e0 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 75 6e 72 65 61 64 70 29 0a 20 20 20 20 20 20 20 20 20 ........(let.(unreadp)..........
6a300 20 28 6c 61 6d 62 64 61 20 28 6f 72 69 67 20 64 61 74 61 20 63 6f 6e 74 65 78 74 20 66 6e 29 0a .(lambda.(orig.data.context.fn).
6a320 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 20 28 28 6e 6f 74 20 28 65 71 20 28 63 61 72 ............(cond.((not.(eq.(car
6a340 20 64 61 74 61 29 20 27 71 75 69 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .data).'quit))..................
6a360 20 20 28 66 75 6e 63 61 6c 6c 20 6f 72 69 67 20 64 61 74 61 20 63 6f 6e 74 65 78 74 20 66 6e 29 ..(funcall.orig.data.context.fn)
6a380 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 75 6e 72 65 61 64 ....................(setq.unread
6a3a0 70 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 6e 72 65 61 p.nil))...................(unrea
6a3c0 64 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 66 75 dp....................(remove-fu
6a3e0 6e 63 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 2d 65 72 72 6f 72 2d 66 75 6e 63 74 69 6f 6e 20 22 69 nction.command-error-function."i
6a400 6e 68 69 62 69 74 2d 71 75 69 74 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nhibit-quit")...................
6a420 20 28 66 75 6e 63 61 6c 6c 20 6f 72 69 67 20 64 61 74 61 20 63 6f 6e 74 65 78 74 20 66 6e 29 29 .(funcall.orig.data.context.fn))
6a440 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 0a 20 20 20 20 20 20 20 20 20 20 ...................(t...........
6a460 20 20 20 20 20 20 20 20 20 28 70 75 73 68 20 3f 5c 43 2d 67 20 75 6e 72 65 61 64 2d 63 6f 6d 6d .........(push.?\C-g.unread-comm
6a480 61 6e 64 2d 65 76 65 6e 74 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 and-events)....................(
6a4a0 73 65 74 71 20 75 6e 72 65 61 64 70 20 74 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 27 28 28 6e setq.unreadp.t))))).........'((n
6a4c0 61 6d 65 20 2e 20 22 69 6e 68 69 62 69 74 2d 71 75 69 74 22 29 29 29 29 0a 20 20 20 20 20 20 28 ame..."inhibit-quit")))).......(
6a4e0 27 64 69 73 61 62 6c 65 0a 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 2d 66 75 6e 63 74 69 6f 6e 'disable........(remove-function
6a500 20 63 6f 6d 6d 61 6e 64 2d 65 72 72 6f 72 2d 66 75 6e 63 74 69 6f 6e 20 22 69 6e 68 69 62 69 74 .command-error-function."inhibit
6a520 2d 71 75 69 74 22 29 29 29 29 29 0a 0a 3b 3b 3b 20 50 72 65 2d 43 6f 6d 6d 61 6e 64 73 0a 0a 28 -quit")))))..;;;.Pre-Commands..(
6a540 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 63 61 6c 6c 2d 70 72 65 2d 63 6f 6d 6d 61 6e defun.transient--call-pre-comman
6a560 64 20 28 29 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 66 6e 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d d.()...(if-let.((fn.(transient--
6a580 67 65 74 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 0a 20 20 20 get-pre-command.this-command....
6a5a0 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 ................................
6a5c0 20 20 20 20 20 20 20 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 2d 76 65 63 74 6f ........(this-command-keys-vecto
6a5e0 72 29 29 29 29 0a 20 20 20 20 20 20 28 6c 65 74 20 28 28 61 63 74 69 6f 6e 20 28 66 75 6e 63 61 r)))).......(let.((action.(funca
6a600 6c 6c 20 66 6e 29 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 65 71 20 61 63 74 69 6f ll.fn))).........(when.(eq.actio
6a620 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 20 20 28 73 65 n.transient--exit)...........(se
6a640 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 28 6f 72 20 74 72 61 6e 73 69 65 6e tq.transient--exitp.(or.transien
6a660 74 2d 2d 65 78 69 74 70 20 74 29 29 29 0a 20 20 20 20 20 20 20 20 61 63 74 69 6f 6e 29 0a 20 20 t--exitp.t))).........action)...
6a680 20 20 28 69 66 20 28 6c 65 74 20 28 28 6b 65 79 73 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d ..(if.(let.((keys.(this-command-
6a6a0 6b 65 79 73 2d 76 65 63 74 6f 72 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 65 71 20 28 61 72 keys-vector)))...........(eq.(ar
6a6c0 65 66 20 6b 65 79 73 20 28 31 2d 20 28 6c 65 6e 67 74 68 20 6b 65 79 73 29 29 29 20 3f 5c 43 2d ef.keys.(1-.(length.keys))).?\C-
6a6e0 67 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 g)).........(setq.this-command.'
6a700 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6f 70 29 0a 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 74 transient-noop).......(unless.(t
6a720 72 61 6e 73 69 65 6e 74 2d 2d 65 64 65 62 75 67 2d 63 6f 6d 6d 61 6e 64 2d 70 29 0a 20 20 20 20 ransient--edebug-command-p).....
6a740 20 20 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e ....(setq.this-command.'transien
6a760 74 2d 75 6e 64 65 66 69 6e 65 64 29 29 29 0a 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 t-undefined))).....transient--st
6a780 61 79 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 70 72 65 2d ay))..(defun.transient--get-pre-
6a7a0 63 6f 6d 6d 61 6e 64 20 28 26 6f 70 74 69 6f 6e 61 6c 20 63 6d 64 20 6b 65 79 20 65 6e 66 6f 72 command.(&optional.cmd.key.enfor
6a7c0 63 65 2d 74 79 70 65 29 0a 20 20 28 6f 72 20 28 61 6e 64 20 28 6e 6f 74 20 28 65 71 20 65 6e 66 ce-type)...(or.(and.(not.(eq.enf
6a7e0 6f 72 63 65 2d 74 79 70 65 20 27 6e 6f 6e 2d 73 75 66 66 69 78 29 29 0a 20 20 20 20 20 20 20 20 orce-type.'non-suffix)).........
6a800 20 20 20 28 73 79 6d 62 6f 6c 70 20 63 6d 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 ...(symbolp.cmd)............(or.
6a820 28 61 6e 64 20 6b 65 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 (and.key.....................(le
6a840 74 20 28 28 64 65 66 20 28 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 t.((def.(lookup-key.transient--p
6a860 72 65 64 69 63 61 74 65 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 redicate-map....................
6a880 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 76 63 6f 6e 63 61 74 ........................(vconcat
6a8a0 20 6b 65 79 20 28 6c 69 73 74 20 63 6d 64 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 .key.(list.cmd))))).............
6a8c0 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 73 79 6d 62 6f 6c 70 20 64 65 66 29 20 64 65 66 ..........(and.(symbolp.def).def
6a8e0 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 )))................(lookup-key.t
6a900 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 20 28 76 65 63 74 6f 72 20 ransient--predicate-map.(vector.
6a920 63 6d 64 29 29 29 29 0a 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 65 71 20 65 6e 66 6f cmd)))).......(and.(not.(eq.enfo
6a940 72 63 65 2d 74 79 70 65 20 27 73 75 66 66 69 78 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 rce-type.'suffix))............(t
6a960 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 6f 6c 76 65 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 0a 20 20 ransient--resolve-pre-command...
6a980 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 ..........(oref.transient--prefi
6a9a0 78 20 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 x.transient-non-suffix).........
6a9c0 20 20 20 20 74 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 ....t))))..(defun.transient--res
6a9e0 6f 6c 76 65 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 28 70 72 65 20 26 6f 70 74 69 6f 6e 61 6c 20 olve-pre-command.(pre.&optional.
6aa00 72 65 73 6f 6c 76 65 2d 62 6f 6f 6c 65 61 6e 20 63 6f 72 72 65 63 74 29 0a 20 20 28 73 65 74 71 resolve-boolean.correct)...(setq
6aa20 20 70 72 65 20 28 63 6f 6e 64 20 28 28 62 6f 6f 6c 65 61 6e 70 20 70 72 65 29 0a 20 20 20 20 20 .pre.(cond.((booleanp.pre)......
6aa40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 72 65 73 6f 6c 76 65 2d 62 6f 6f 6c 65 61 ..............(if.resolve-boolea
6aa60 6e 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 69 66 20 70 72 65 n........................(if.pre
6aa80 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 20 23 27 74 72 61 6e 73 69 65 6e .#'transient--do-stay.#'transien
6aaa0 74 2d 2d 64 6f 2d 77 61 72 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t--do-warn).....................
6aac0 20 70 72 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 73 74 72 69 6e .pre))...................((strin
6aae0 67 2d 6d 61 74 63 68 2d 70 20 22 2d 2d 64 6f 2d 22 20 28 73 79 6d 62 6f 6c 2d 6e 61 6d 65 20 70 g-match-p."--do-".(symbol-name.p
6ab00 72 65 29 29 20 70 72 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6c 65 re)).pre)...................((le
6ab20 74 20 28 28 73 79 6d 20 28 69 6e 74 65 72 6e 20 28 66 6f 72 6d 61 74 20 22 74 72 61 6e 73 69 65 t.((sym.(intern.(format."transie
6ab40 6e 74 2d 2d 64 6f 2d 25 73 22 20 70 72 65 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 nt--do-%s".pre))))..............
6ab60 20 20 20 20 20 20 20 20 28 69 66 20 28 66 75 6e 63 74 69 6f 6e 70 20 73 79 6d 29 20 73 79 6d 20 ........(if.(functionp.sym).sym.
6ab80 70 72 65 29 29 29 29 29 0a 20 20 28 63 6f 6e 64 20 28 28 6e 6f 74 20 63 6f 72 72 65 63 74 29 20 pre)))))...(cond.((not.correct).
6aba0 70 72 65 29 0a 20 20 20 20 20 20 20 20 28 28 61 6e 64 20 28 65 71 20 70 72 65 20 27 74 72 61 6e pre).........((and.(eq.pre.'tran
6abc0 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 74 75 72 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 sient--do-return)...............
6abe0 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 29 29 0a 20 20 20 20 20 20 20 20 (not.transient--stack)).........
6ac00 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 28 70 .'transient--do-exit).........(p
6ac20 72 65 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 re)))..(defun.transient--do-stay
6ac40 20 28 29 0a 20 20 22 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 .()..."Call.the.command.without.
6ac60 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 exporting.variables.and.stay.tra
6ac80 6e 73 69 65 6e 74 2e 22 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 0a 0a 28 64 65 nsient."...transient--stay)..(de
6aca0 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6e 6f 6f 70 20 28 29 0a 20 20 22 43 61 6c fun.transient--do-noop.()..."Cal
6acc0 6c 20 60 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6f 70 27 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e l.`transient-noop'.and.stay.tran
6ace0 73 69 65 6e 74 2e 22 0a 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 sient."...(setq.this-command.'tr
6ad00 61 6e 73 69 65 6e 74 2d 6e 6f 6f 70 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 ansient-noop)...transient--stay)
6ad20 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 77 61 72 6e 20 28 29 0a 20 ..(defun.transient--do-warn.()..
6ad40 20 22 43 61 6c 6c 20 60 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 27 20 61 6e 64 ."Call.`transient-undefined'.and
6ad60 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 .stay.transient."...(setq.this-c
6ad80 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 29 0a 20 20 74 ommand.'transient-undefined)...t
6ada0 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e ransient--stay)..(defun.transien
6adc0 74 2d 2d 64 6f 2d 77 61 72 6e 2d 69 6e 61 70 74 20 28 29 0a 20 20 22 43 61 6c 6c 20 60 74 72 61 t--do-warn-inapt.()..."Call.`tra
6ade0 6e 73 69 65 6e 74 2d 69 6e 61 70 74 27 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 nsient-inapt'.and.stay.transient
6ae00 2e 22 0a 20 20 28 73 65 74 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 ."...(setq.this-command.'transie
6ae20 6e 74 2d 69 6e 61 70 74 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 0a 0a 28 64 nt-inapt)...transient--stay)..(d
6ae40 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 20 28 29 0a 20 20 22 43 61 efun.transient--do-call.()..."Ca
6ae60 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 78 70 6f 72 74 69 6e 67 20 76 ll.the.command.after.exporting.v
6ae80 61 72 69 61 62 6c 65 73 20 61 6e 64 20 73 74 61 79 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 ariables.and.stay.transient."...
6aea0 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 6f 72 74 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d (transient--export)...transient-
6aec0 2d 73 74 61 79 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 74 -stay)..(defun.transient--do-ret
6aee0 75 72 6e 20 28 29 0a 20 20 22 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 urn.()..."Call.the.command.after
6af00 20 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 72 65 74 75 72 6e 20 .exporting.variables.and.return.
6af20 74 6f 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 2e 0a 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f to.parent.prefix..If.there.is.no
6af40 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 62 65 68 61 76 65 20 6c 69 6b 65 .parent.prefix,.then.behave.like
6af60 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 27 2e 22 0a 20 20 28 69 66 20 28 6e .`transient--do-exit'."...(if.(n
6af80 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 29 0a 20 20 20 20 20 20 28 74 72 61 6e ot.transient--stack).......(tran
6afa0 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d sient--do-exit).....(transient--
6afc0 65 78 70 6f 72 74 29 0a 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 29 29 0a 0a 28 export).....transient--exit))..(
6afe0 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 20 28 29 0a 20 20 22 43 defun.transient--do-exit.()..."C
6b000 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 66 74 65 72 20 65 78 70 6f 72 74 69 6e 67 20 all.the.command.after.exporting.
6b020 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 65 78 69 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 variables.and.exit.the.transient
6b040 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 6f 72 74 29 0a 20 20 28 74 72 61 6e ."...(transient--export)...(tran
6b060 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 7a 61 70 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 sient--stack-zap)...transient--e
6b080 78 69 74 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6c 65 61 76 65 xit)..(defun.transient--do-leave
6b0a0 20 28 29 0a 20 20 22 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f 75 74 20 .()..."Call.the.command.without.
6b0c0 65 78 70 6f 72 74 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 65 78 69 74 20 74 68 65 exporting.variables.and.exit.the
6b0e0 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b .transient."...(transient--stack
6b100 2d 7a 61 70 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 29 0a 0a 28 64 65 66 75 6e -zap)...transient--exit)..(defun
6b120 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 70 75 73 68 2d 62 75 74 74 6f 6e 20 28 29 0a 20 20 .transient--do-push-button.()...
6b140 22 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 "Call.the.command.represented.by
6b160 20 74 68 65 20 61 63 74 69 76 61 74 65 64 20 62 75 74 74 6f 6e 2e 0a 55 73 65 20 74 68 61 74 20 .the.activated.button..Use.that.
6b180 63 6f 6d 6d 61 6e 64 27 73 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 74 6f 20 64 65 74 65 72 6d 69 command's.pre-command.to.determi
6b1a0 6e 65 20 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 2e 22 0a 20 20 28 69 66 20 28 61 ne.transient.behavior."...(if.(a
6b1c0 6e 64 20 28 6d 6f 75 73 65 2d 65 76 65 6e 74 2d 70 20 6c 61 73 74 2d 63 6f 6d 6d 61 6e 64 2d 65 nd.(mouse-event-p.last-command-e
6b1e0 76 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 65 71 20 28 70 6f 73 6e 2d vent)............(not.(eq.(posn-
6b200 77 69 6e 64 6f 77 20 28 65 76 65 6e 74 2d 73 74 61 72 74 20 6c 61 73 74 2d 63 6f 6d 6d 61 6e 64 window.(event-start.last-command
6b220 2d 65 76 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 -event)).....................tra
6b240 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 29 29 0a 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e nsient--window))).......transien
6b260 74 2d 2d 73 74 61 79 0a 20 20 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f t--stay.....(with-selected-windo
6b280 77 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 28 6c 65 74 20 28 w.transient--window.......(let.(
6b2a0 28 70 6f 73 20 28 69 66 20 28 6d 6f 75 73 65 2d 65 76 65 6e 74 2d 70 20 6c 61 73 74 2d 63 6f 6d (pos.(if.(mouse-event-p.last-com
6b2c0 6d 61 6e 64 2d 65 76 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 mand-event).....................
6b2e0 20 28 70 6f 73 6e 2d 70 6f 69 6e 74 20 28 65 76 65 6e 74 2d 73 74 61 72 74 20 6c 61 73 74 2d 63 .(posn-point.(event-start.last-c
6b300 6f 6d 6d 61 6e 64 2d 65 76 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ommand-event))..................
6b320 20 20 28 70 6f 69 6e 74 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 68 69 73 2d ..(point)))).........(setq.this-
6b340 63 6f 6d 6d 61 6e 64 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 70 6f 73 20 27 command.(get-text-property.pos.'
6b360 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e command)).........(setq.transien
6b380 74 2d 2d 63 75 72 72 65 6e 74 2d 73 75 66 66 69 78 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 t--current-suffix.(get-text-prop
6b3a0 65 72 74 79 20 70 6f 73 20 27 73 75 66 66 69 78 29 29 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 erty.pos.'suffix)))).....(transi
6b3c0 65 6e 74 2d 2d 63 61 6c 6c 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 29 29 29 0a 0a 28 64 65 66 75 6e ent--call-pre-command)))..(defun
6b3e0 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 65 20 28 29 0a 20 20 22 43 61 6c .transient--do-recurse.()..."Cal
6b400 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 l.the.transient.prefix.command,.
6b420 70 72 65 70 61 72 69 6e 67 20 66 6f 72 20 72 65 74 75 72 6e 20 74 6f 20 6f 75 74 65 72 20 74 72 preparing.for.return.to.outer.tr
6b440 61 6e 73 69 65 6e 74 2e 0a 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 61 72 65 6e 74 20 70 ansient..If.there.is.no.parent.p
6b460 72 65 66 69 78 2c 20 74 68 65 6e 20 6a 75 73 74 20 63 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e refix,.then.just.call.the.comman
6b480 64 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 6b 29 29 0a 0a 28 64 d."...(transient--do-stack))..(d
6b4a0 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 6b 20 28 29 0a 20 20 22 43 efun.transient--do-stack.()..."C
6b4c0 61 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 all.the.transient.prefix.command
6b4e0 2c 20 73 74 61 63 6b 69 6e 67 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e ,.stacking.the.active.transient.
6b500 0a 50 75 73 68 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 20 74 68 .Push.the.active.transient.to.th
6b520 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 e.transient.stack."...(transient
6b540 2d 2d 65 78 70 6f 72 74 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 70 75 --export)...(transient--stack-pu
6b560 73 68 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 70 20 27 72 65 sh)...(setq.transient--exitp.'re
6b580 70 6c 61 63 65 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 29 0a 0a 28 64 65 66 75 place)...transient--exit)..(defu
6b5a0 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 70 6c 61 63 65 20 28 29 0a 20 20 22 43 61 n.transient--do-replace.()..."Ca
6b5c0 6c 6c 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c ll.the.transient.prefix.command,
6b5e0 20 72 65 70 6c 61 63 69 6e 67 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 2e .replacing.the.active.transient.
6b600 0a 44 6f 20 6e 6f 74 20 70 75 73 68 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e .Do.not.push.the.active.transien
6b620 74 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 22 0a 20 20 28 74 72 t.to.the.transient.stack."...(tr
6b640 61 6e 73 69 65 6e 74 2d 2d 65 78 70 6f 72 74 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 ansient--export)...(setq.transie
6b660 6e 74 2d 2d 65 78 69 74 70 20 27 72 65 70 6c 61 63 65 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d nt--exitp.'replace)...transient-
6b680 2d 65 78 69 74 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 -exit)..(defun.transient--do-sus
6b6a0 70 65 6e 64 20 28 29 0a 20 20 22 53 75 73 70 65 6e 64 20 74 68 65 20 61 63 74 69 76 65 20 74 72 pend.()..."Suspend.the.active.tr
6b6c0 61 6e 73 69 65 6e 74 2c 20 73 61 76 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 ansient,.saving.the.transient.st
6b6e0 61 63 6b 2e 22 0a 20 20 3b 3b 20 45 78 70 6f 72 74 20 73 6f 20 74 68 61 74 20 60 74 72 61 6e 73 ack."...;;.Export.so.that.`trans
6b700 69 65 6e 74 2d 64 65 73 63 72 69 62 65 27 20 69 6e 73 74 61 6e 63 65 73 20 63 61 6e 20 75 73 65 ient-describe'.instances.can.use
6b720 0a 20 20 3b 3b 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 27 20 ...;;.`transient-suffix-object'.
6b740 74 6f 20 67 65 74 20 74 68 65 69 72 20 72 65 73 70 65 63 74 69 76 65 20 6f 62 6a 65 63 74 2e 0a to.get.their.respective.object..
6b760 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 70 6f 72 74 29 0a 20 20 28 74 72 61 6e 73 69 65 ..(transient--export)...(transie
6b780 6e 74 2d 2d 73 74 61 63 6b 2d 70 75 73 68 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e nt--stack-push)...(setq.transien
6b7a0 74 2d 2d 65 78 69 74 70 20 27 73 75 73 70 65 6e 64 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d t--exitp.'suspend)...transient--
6b7c0 65 78 69 74 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 71 75 69 74 exit)..(defun.transient--do-quit
6b7e0 2d 6f 6e 65 20 28 29 0a 20 20 22 49 66 20 61 63 74 69 76 65 2c 20 71 75 69 74 20 68 65 6c 70 20 -one.()..."If.active,.quit.help.
6b800 6f 72 20 65 64 69 74 20 6d 6f 64 65 2c 20 65 6c 73 65 20 65 78 69 74 20 74 68 65 20 61 63 74 69 or.edit.mode,.else.exit.the.acti
6b820 76 65 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 28 63 6f 6e 64 20 28 74 72 61 6e 73 69 65 6e ve.transient."...(cond.(transien
6b840 74 2d 2d 68 65 6c 70 70 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e t--helpp..........(setq.transien
6b860 74 2d 2d 68 65 6c 70 70 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 t--helpp.nil)..........transient
6b880 2d 2d 73 74 61 79 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 --stay).........(transient--edit
6b8a0 70 0a 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 p..........(setq.transient--edit
6b8c0 70 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 p.nil)..........(transient-setup
6b8e0 29 0a 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 0a 20 20 20 20 )..........transient--stay).....
6b900 20 20 20 20 28 70 72 65 66 69 78 2d 61 72 67 0a 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 ....(prefix-arg..........transie
6b920 6e 74 2d 2d 73 74 61 79 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 65 78 nt--stay).........(transient--ex
6b940 69 74 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 71 75 69 74 it)))..(defun.transient--do-quit
6b960 2d 61 6c 6c 20 28 29 0a 20 20 22 45 78 69 74 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 77 -all.()..."Exit.all.transients.w
6b980 69 74 68 6f 75 74 20 73 61 76 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 ithout.saving.the.transient.stac
6b9a0 6b 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 7a 61 70 29 0a 20 20 74 k."...(transient--stack-zap)...t
6b9c0 72 61 6e 73 69 65 6e 74 2d 2d 65 78 69 74 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e ransient--exit)..(defun.transien
6b9e0 74 2d 2d 64 6f 2d 6d 6f 76 65 20 28 29 0a 20 20 22 43 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e t--do-move.()..."Call.the.comman
6ba00 64 20 69 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 d.if.`transient-enable-popup-nav
6ba20 69 67 61 74 69 6f 6e 27 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2e 0a 49 6e 20 74 68 61 74 20 63 61 73 igation'.is.non-nil..In.that.cas
6ba40 65 20 62 65 68 61 76 65 20 6c 69 6b 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 e.behave.like.`transient--do-sta
6ba60 79 27 2c 20 6f 74 68 65 72 77 69 73 65 20 73 69 6d 69 6c 61 72 0a 74 6f 20 60 74 72 61 6e 73 69 y',.otherwise.similar.to.`transi
6ba80 65 6e 74 2d 2d 64 6f 2d 77 61 72 6e 27 2e 22 0a 20 20 28 75 6e 6c 65 73 73 20 74 72 61 6e 73 69 ent--do-warn'."...(unless.transi
6baa0 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 0a 20 20 20 20 ent-enable-popup-navigation.....
6bac0 28 73 65 74 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e (setq.this-command.'transient-in
6bae0 68 69 62 69 74 2d 6d 6f 76 65 29 29 0a 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 0a hibit-move))...transient--stay).
6bb00 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d 69 6e 75 73 20 28 29 0a 20 .(defun.transient--do-minus.()..
6bb20 20 22 43 61 6c 6c 20 60 6e 65 67 61 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 27 20 6f 72 20 70 69 ."Call.`negative-argument'.or.pi
6bb40 76 6f 74 20 74 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 75 70 64 61 74 65 27 2e 0a 49 66 20 60 6e vot.to.`transient-update'..If.`n
6bb60 65 67 61 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 27 20 69 73 20 69 6e 76 6f 6b 65 64 20 75 73 69 egative-argument'.is.invoked.usi
6bb80 6e 67 20 5c 22 2d 5c 22 20 74 68 65 6e 20 70 72 65 73 65 72 76 65 20 74 68 65 0a 70 72 65 66 69 ng.\"-\".then.preserve.the.prefi
6bba0 78 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 70 69 76 6f 74 20 74 6f 20 60 74 72 61 6e 73 69 65 x.argument.and.pivot.to.`transie
6bbc0 6e 74 2d 75 70 64 61 74 65 27 2e 22 0a 20 20 28 77 68 65 6e 20 28 65 71 75 61 6c 20 28 74 68 69 nt-update'."...(when.(equal.(thi
6bbe0 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 20 22 2d 22 29 0a 20 20 20 20 28 73 65 74 71 20 74 s-command-keys)."-").....(setq.t
6bc00 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 75 70 64 61 74 65 29 29 0a his-command.'transient-update)).
6bc20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 79 29 0a 0a 28 70 75 74 20 27 74 72 61 6e 73 69 ..transient--stay)..(put.'transi
6bc40 65 6e 74 2d 2d 64 6f 2d 73 74 61 79 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 ent--do-stay.......'transient-fa
6bc60 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 79 29 0a 28 70 75 74 20 27 74 72 ce.'transient-key-stay).(put.'tr
6bc80 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6e 6f 6f 70 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e ansient--do-noop.......'transien
6bca0 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f 6f 70 29 0a 28 70 75 74 t-face.'transient-key-noop).(put
6bcc0 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 77 61 72 6e 20 20 20 20 20 20 20 27 74 72 61 6e .'transient--do-warn.......'tran
6bce0 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f 6f 70 29 0a sient-face.'transient-key-noop).
6bd00 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 77 61 72 6e 2d 69 6e 61 70 74 20 27 (put.'transient--do-warn-inapt.'
6bd20 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f transient-face.'transient-key-no
6bd40 6f 70 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 63 61 6c 6c 20 20 20 20 op).(put.'transient--do-call....
6bd60 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 ...'transient-face.'transient-ke
6bd80 79 2d 73 74 61 79 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 74 75 y-stay).(put.'transient--do-retu
6bda0 72 6e 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e rn.....'transient-face.'transien
6bdc0 74 2d 6b 65 79 2d 72 65 74 75 72 6e 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 t-key-return).(put.'transient--d
6bde0 6f 2d 65 78 69 74 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 o-exit.......'transient-face.'tr
6be00 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 65 78 69 74 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e ansient-key-exit).(put.'transien
6be20 74 2d 2d 64 6f 2d 6c 65 61 76 65 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 t--do-leave......'transient-face
6be40 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 65 78 69 74 29 0a 0a 28 70 75 74 20 27 74 72 61 .'transient-key-exit)..(put.'tra
6be60 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 72 73 65 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 nsient--do-recurse....'transient
6be80 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 72 65 63 75 72 73 65 29 0a 28 70 -face.'transient-key-recurse).(p
6bea0 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 74 61 63 6b 20 20 20 20 20 20 27 74 72 ut.'transient--do-stack......'tr
6bec0 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 63 ansient-face.'transient-key-stac
6bee0 6b 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 70 6c 61 63 65 20 20 k).(put.'transient--do-replace..
6bf00 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 ..'transient-face.'transient-key
6bf20 2d 65 78 69 74 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 73 75 73 70 65 -exit).(put.'transient--do-suspe
6bf40 6e 64 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 nd....'transient-face.'transient
6bf60 2d 6b 65 79 2d 65 78 69 74 29 0a 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d -key-exit)..(put.'transient--do-
6bf80 71 75 69 74 2d 6f 6e 65 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e quit-one...'transient-face.'tran
6bfa0 73 69 65 6e 74 2d 6b 65 79 2d 72 65 74 75 72 6e 29 0a 28 70 75 74 20 27 74 72 61 6e 73 69 65 6e sient-key-return).(put.'transien
6bfc0 74 2d 2d 64 6f 2d 71 75 69 74 2d 61 6c 6c 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 61 63 65 t--do-quit-all...'transient-face
6bfe0 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 65 78 69 74 29 0a 28 70 75 74 20 27 74 72 61 6e .'transient-key-exit).(put.'tran
6c000 73 69 65 6e 74 2d 2d 64 6f 2d 6d 6f 76 65 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d sient--do-move.......'transient-
6c020 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 79 29 0a 28 70 75 74 20 27 face.'transient-key-stay).(put.'
6c040 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6d 69 6e 75 73 20 20 20 20 20 20 27 74 72 61 6e 73 69 transient--do-minus......'transi
6c060 65 6e 74 2d 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 79 29 0a 0a 3b ent-face.'transient-key-stay)..;
6c080 3b 3b 20 43 6f 6d 6d 61 6e 64 73 0a 3b 3b 3b 3b 20 4e 6f 6f 70 0a 0a 28 64 65 66 75 6e 20 74 72 ;;.Commands.;;;;.Noop..(defun.tr
6c0a0 61 6e 73 69 65 6e 74 2d 6e 6f 6f 70 20 28 29 0a 20 20 22 44 6f 20 6e 6f 74 68 69 6e 67 20 61 74 ansient-noop.()..."Do.nothing.at
6c0c0 20 61 6c 6c 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 29 0a 0a 28 64 65 66 75 6e 20 .all."...(interactive))..(defun.
6c0e0 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 20 28 29 0a 20 20 22 57 61 72 6e 20 74 transient-undefined.()..."Warn.t
6c100 68 65 20 75 73 65 72 20 74 68 61 74 20 74 68 65 20 70 72 65 73 73 65 64 20 6b 65 79 20 69 73 20 he.user.that.the.pressed.key.is.
6c120 6e 6f 74 20 62 6f 75 6e 64 20 74 6f 20 61 6e 79 20 73 75 66 66 69 78 2e 22 0a 20 20 28 69 6e 74 not.bound.to.any.suffix."...(int
6c140 65 72 61 63 74 69 76 65 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 76 61 6c 69 64 20 eractive)...(transient--invalid.
6c160 22 55 6e 62 6f 75 6e 64 20 73 75 66 66 69 78 22 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 "Unbound.suffix"))..(defun.trans
6c180 69 65 6e 74 2d 69 6e 61 70 74 20 28 29 0a 20 20 22 57 61 72 6e 20 74 68 65 20 75 73 65 72 20 74 ient-inapt.()..."Warn.the.user.t
6c1a0 68 61 74 20 74 68 65 20 69 6e 76 6f 6b 65 64 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 61 70 74 hat.the.invoked.command.is.inapt
6c1c0 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d ."...(interactive)...(transient-
6c1e0 2d 69 6e 76 61 6c 69 64 20 22 49 6e 61 70 74 20 63 6f 6d 6d 61 6e 64 22 29 29 0a 0a 28 64 65 66 -invalid."Inapt.command"))..(def
6c200 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 76 61 6c 69 64 20 28 6d 73 67 29 0a 20 20 28 64 un.transient--invalid.(msg)...(d
6c220 69 6e 67 29 0a 20 20 28 6d 65 73 73 61 67 65 20 22 25 73 3a 20 60 25 73 27 20 28 55 73 65 20 60 ing)...(message."%s:.`%s'.(Use.`
6c240 25 73 27 20 74 6f 20 61 62 6f 72 74 2c 20 60 25 73 27 20 66 6f 72 20 68 65 6c 70 29 25 73 22 0a %s'.to.abort,.`%s'.for.help)%s".
6c260 20 20 20 20 20 20 20 20 20 20 20 6d 73 67 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 ...........msg............(prope
6c280 72 74 69 7a 65 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 74 68 69 73 2d 73 69 6e rtize.(key-description.(this-sin
6c2a0 67 6c 65 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 gle-command-keys))..............
6c2c0 20 20 20 20 20 20 20 20 20 20 27 66 61 63 65 20 27 66 6f 6e 74 2d 6c 6f 63 6b 2d 77 61 72 6e 69 ..........'face.'font-lock-warni
6c2e0 6e 67 2d 66 61 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 ng-face)............(propertize.
6c300 22 43 2d 67 22 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 "C-g".'face.'transient-key).....
6c320 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 3f 22 20 20 20 27 66 61 63 65 20 27 .......(propertize."?"...'face.'
6c340 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 60 74 68 transient-key)............;;.`th
6c360 69 73 2d 63 6f 6d 6d 61 6e 64 27 20 69 73 20 60 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 is-command'.is.`transient-undefi
6c380 6e 65 64 27 20 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 27 2e 0a 20 20 20 20 20 ned'.or.`transient-inapt'.......
6c3a0 20 20 20 20 20 20 3b 3b 20 53 68 6f 77 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 28 60 74 68 69 73 ......;;.Show.the.command.(`this
6c3c0 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 27 29 20 74 68 65 20 75 73 65 72 20 61 63 74 -original-command').the.user.act
6c3e0 75 61 6c 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 74 72 69 65 64 20 74 6f 20 69 6e 76 ually............;;.tried.to.inv
6c400 6f 6b 65 2e 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 63 6d 64 20 28 6f oke.............(if-let.((cmd.(o
6c420 72 20 28 69 67 6e 6f 72 65 2d 65 72 72 6f 72 73 20 28 73 79 6d 62 6f 6c 2d 6e 61 6d 65 20 74 68 r.(ignore-errors.(symbol-name.th
6c440 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 is-original-command))...........
6c460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 67 6e 6f 72 65 2d 65 72 72 6f 72 ...................(ignore-error
6c480 73 20 28 73 79 6d 62 6f 6c 2d 6e 61 6d 65 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 29 s.(symbol-name.this-command)))))
6c4a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 20 5b 25 73 5d 22 20 ................(format.".[%s]".
6c4c0 28 70 72 6f 70 65 72 74 69 7a 65 20 63 6d 64 20 27 66 61 63 65 20 27 66 6f 6e 74 2d 6c 6f 63 6b (propertize.cmd.'face.'font-lock
6c4e0 2d 77 61 72 6e 69 6e 67 2d 66 61 63 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 22 22 29 -warning-face)).............."")
6c500 29 0a 20 20 28 75 6e 6c 65 73 73 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e )...(unless.(and.transient--tran
6c520 73 69 65 6e 74 2d 6d 61 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 65 6d 71 20 74 sient-map................(memq.t
6c540 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 6f 76 65 72 72 69 64 69 ransient--transient-map.overridi
6c560 6e 67 2d 74 65 72 6d 69 6e 61 6c 2d 6c 6f 63 61 6c 2d 6d 61 70 29 29 0a 20 20 20 20 28 6c 65 74 ng-terminal-local-map)).....(let
6c580 20 28 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 28 6f 72 20 74 72 61 6e 73 69 65 .((transient--prefix.(or.transie
6c5a0 6e 74 2d 2d 70 72 65 66 69 78 20 27 73 69 63 29 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 nt--prefix.'sic))).......(transi
6c5c0 65 6e 74 2d 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 29 29 0a 20 20 20 20 28 76 69 65 77 2d ent--emergency-exit)).....(view-
6c5e0 6c 6f 73 73 61 67 65 29 0a 20 20 20 20 28 6f 74 68 65 72 2d 77 69 6e 64 6f 77 20 31 29 0a 20 20 lossage).....(other-window.1)...
6c600 20 20 28 64 69 73 70 6c 61 79 2d 77 61 72 6e 69 6e 67 20 27 74 72 61 6e 73 69 65 6e 74 20 22 49 ..(display-warning.'transient."I
6c620 6e 63 6f 6e 73 69 73 74 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 74 65 20 64 65 74 65 nconsistent.transient.state.dete
6c640 63 74 65 64 2e 0a 54 68 69 73 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 68 61 70 70 65 6e 2e 0a cted..This.should.never.happen..
6c660 50 6c 65 61 73 65 20 6f 70 65 6e 20 61 6e 20 69 73 73 75 65 20 61 6e 64 20 70 6f 73 74 20 74 68 Please.open.an.issue.and.post.th
6c680 65 20 73 68 6f 77 6e 20 63 6f 6d 6d 61 6e 64 20 6c 6f 67 2e 22 20 3a 65 72 72 6f 72 29 29 29 0a e.shown.command.log.".:error))).
6c6a0 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 68 69 62 69 74 2d 6d 6f 76 65 20 28 .(defun.transient-inhibit-move.(
6c6c0 29 0a 20 20 22 57 61 72 6e 20 74 68 65 20 75 73 65 72 20 74 68 61 74 20 6d 65 6e 75 20 6e 61 76 )..."Warn.the.user.that.menu.nav
6c6e0 69 67 61 74 69 6f 6e 20 69 73 20 64 69 73 61 62 6c 65 64 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 igation.is.disabled."...(interac
6c700 74 69 76 65 29 0a 20 20 28 6d 65 73 73 61 67 65 20 22 54 6f 20 65 6e 61 62 6c 65 20 75 73 65 20 tive)...(message."To.enable.use.
6c720 6f 66 20 60 25 73 27 2c 20 70 6c 65 61 73 65 20 63 75 73 74 6f 6d 69 7a 65 20 60 25 73 27 22 0a of.`%s',.please.customize.`%s'".
6c740 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 ...........this-original-command
6c760 0a 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f ............'transient-enable-po
6c780 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 29 29 0a 0a 3b 3b 3b 3b 20 43 6f 72 65 0a 0a 28 64 65 pup-navigation))..;;;;.Core..(de
6c7a0 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 20 28 29 0a 20 20 22 45 78 69 fun.transient-quit-all.()..."Exi
6c7c0 74 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 77 69 74 68 6f 75 74 20 73 61 76 69 6e 67 20 t.all.transients.without.saving.
6c7e0 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 73 74 61 63 6b 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 the.transient.stack."...(interac
6c800 74 69 76 65 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e tive))..(defun.transient-quit-on
6c820 65 20 28 29 0a 20 20 22 45 78 69 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 e.()..."Exit.the.current.transie
6c840 6e 74 73 2c 20 72 65 74 75 72 6e 69 6e 67 20 74 6f 20 6f 75 74 65 72 20 74 72 61 6e 73 69 65 6e nts,.returning.to.outer.transien
6c860 74 2c 20 69 66 20 61 6e 79 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 29 0a 0a 28 64 t,.if.any."...(interactive))..(d
6c880 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 73 65 71 20 28 29 0a 20 20 22 41 62 efun.transient-quit-seq.()..."Ab
6c8a0 6f 72 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6e 63 6f 6d 70 6c 65 74 65 20 6b 65 79 20 73 ort.the.current.incomplete.key.s
6c8c0 65 71 75 65 6e 63 65 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 29 0a 0a 28 64 65 66 equence."...(interactive))..(def
6c8e0 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 75 70 64 61 74 65 20 28 29 0a 20 20 22 52 65 64 72 61 77 un.transient-update.()..."Redraw
6c900 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 73 74 61 74 65 20 69 6e 20 74 68 65 20 6d 65 .the.transient's.state.in.the.me
6c920 6e 75 20 62 75 66 66 65 72 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 73 nu.buffer."...(interactive)...(s
6c940 65 74 71 20 70 72 65 66 69 78 2d 61 72 67 20 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 2d 61 72 etq.prefix-arg.current-prefix-ar
6c960 67 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 20 28 29 0a 20 20 g))..(defun.transient-show.()...
6c980 22 53 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 73 74 61 74 65 20 69 6e 20 74 "Show.the.transient's.state.in.t
6c9a0 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 he.menu.buffer."...(interactive)
6c9c0 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 20 74 29 29 0a 0a 28 ...(setq.transient--showp.t))..(
6c9e0 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 70 75 73 68 2d 62 75 74 74 6f 6e 20 28 29 0a 20 defun.transient-push-button.()..
6ca00 20 22 49 6e 76 6f 6b 65 20 74 68 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 72 65 70 72 ."Invoke.the.suffix.command.repr
6ca20 65 73 65 6e 74 65 64 20 62 79 20 74 68 69 73 20 62 75 74 74 6f 6e 2e 22 0a 20 20 28 69 6e 74 65 esented.by.this.button."...(inte
6ca40 72 61 63 74 69 76 65 29 29 0a 0a 3b 3b 3b 3b 20 53 75 73 70 65 6e 64 0a 0a 28 64 65 66 75 6e 20 ractive))..;;;;.Suspend..(defun.
6ca60 74 72 61 6e 73 69 65 6e 74 2d 73 75 73 70 65 6e 64 20 28 29 0a 20 20 22 53 75 73 70 65 6e 64 20 transient-suspend.()..."Suspend.
6ca80 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 2e 0a 49 74 20 63 61 6e 20 6c 61 the.current.transient..It.can.la
6caa0 74 65 72 20 62 65 20 72 65 73 75 6d 65 64 20 75 73 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d ter.be.resumed.using.`transient-
6cac0 72 65 73 75 6d 65 27 2c 20 77 68 69 6c 65 20 6e 6f 20 6f 74 68 65 72 0a 74 72 61 6e 73 69 65 6e resume',.while.no.other.transien
6cae0 74 20 69 73 20 61 63 74 69 76 65 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 29 0a 0a t.is.active."...(interactive))..
6cb00 28 64 65 66 69 6e 65 2d 6d 69 6e 6f 72 2d 6d 6f 64 65 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 (define-minor-mode.transient-res
6cb20 75 6d 65 2d 6d 6f 64 65 0a 20 20 22 41 75 78 69 6c 69 61 72 79 20 6d 69 6e 6f 72 2d 6d 6f 64 65 ume-mode..."Auxiliary.minor-mode
6cb40 20 75 73 65 64 20 74 6f 20 72 65 73 75 6d 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 61 66 74 65 .used.to.resume.a.transient.afte
6cb60 72 20 76 69 65 77 69 6e 67 20 68 65 6c 70 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 r.viewing.help.")..(defun.transi
6cb80 65 6e 74 2d 72 65 73 75 6d 65 20 28 29 0a 20 20 22 52 65 73 75 6d 65 20 61 20 70 72 65 76 69 6f ent-resume.()..."Resume.a.previo
6cba0 75 73 6c 79 20 73 75 73 70 65 6e 64 65 64 20 73 74 61 63 6b 20 6f 66 20 74 72 61 6e 73 69 65 6e usly.suspended.stack.of.transien
6cbc0 74 73 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 63 6f 6e 64 20 28 74 72 ts."...(interactive)...(cond.(tr
6cbe0 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 0a 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 77 ansient--stack..........(let.((w
6cc00 69 6e 63 6f 6e 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 74 6f 72 65 2d 77 69 6e 63 6f 6e inconf.transient--restore-wincon
6cc20 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6b 69 6c 6c 2d 6c 6f 63 61 6c 2d 76 61 72 69 61 f))............(kill-local-varia
6cc40 62 6c 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 74 6f 72 65 2d 77 69 6e 63 6f 6e 66 29 ble.'transient--restore-winconf)
6cc60 0a 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 ............(when.transient-resu
6cc80 6d 65 2d 6d 6f 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d me-mode..............(transient-
6cca0 72 65 73 75 6d 65 2d 6d 6f 64 65 20 2d 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 71 75 resume-mode.-1)..............(qu
6ccc0 69 74 2d 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 77 69 6e it-window))............(when.win
6cce0 63 6f 6e 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 63 6f conf..............(set-window-co
6cd00 6e 66 69 67 75 72 61 74 69 6f 6e 20 77 69 6e 63 6f 6e 66 29 29 29 0a 20 20 20 20 20 20 20 20 20 nfiguration.winconf)))..........
6cd20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 2d 70 6f 70 29 29 0a 20 20 20 20 20 20 20 20 (transient--stack-pop)).........
6cd40 28 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 2d 6d 6f 64 65 0a 20 20 20 20 20 20 20 20 20 (transient-resume-mode..........
6cd60 28 6b 69 6c 6c 2d 6c 6f 63 61 6c 2d 76 61 72 69 61 62 6c 65 20 27 74 72 61 6e 73 69 65 6e 74 2d (kill-local-variable.'transient-
6cd80 2d 72 65 73 74 6f 72 65 2d 77 69 6e 63 6f 6e 66 29 0a 20 20 20 20 20 20 20 20 20 28 74 72 61 6e -restore-winconf)..........(tran
6cda0 73 69 65 6e 74 2d 72 65 73 75 6d 65 2d 6d 6f 64 65 20 2d 31 29 0a 20 20 20 20 20 20 20 20 20 28 sient-resume-mode.-1)..........(
6cdc0 71 75 69 74 2d 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 28 74 0a 20 20 20 20 20 20 20 quit-window)).........(t........
6cde0 20 20 28 6d 65 73 73 61 67 65 20 22 4e 6f 20 73 75 73 70 65 6e 64 65 64 20 74 72 61 6e 73 69 65 ..(message."No.suspended.transie
6ce00 6e 74 20 63 6f 6d 6d 61 6e 64 22 29 29 29 29 0a 0a 3b 3b 3b 3b 20 48 65 6c 70 0a 0a 28 64 65 66 nt.command"))))..;;;;.Help..(def
6ce20 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 20 28 26 6f 70 74 69 6f 6e 61 6c 20 69 6e 74 un.transient-help.(&optional.int
6ce40 65 72 61 63 74 69 76 65 29 0a 20 20 22 53 68 6f 77 20 68 65 6c 70 20 66 6f 72 20 74 68 65 20 61 eractive)..."Show.help.for.the.a
6ce60 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 6f 72 20 6f 6e 65 20 6f 66 20 69 74 73 20 73 75 ctive.transient.or.one.of.its.su
6ce80 66 66 69 78 65 73 2e 0a 5c 6e 28 66 6e 29 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 20 28 ffixes..\n(fn)"...(interactive.(
6cea0 6c 69 73 74 20 74 29 29 0a 20 20 28 69 66 20 69 6e 74 65 72 61 63 74 69 76 65 0a 20 20 20 20 20 list.t))...(if.interactive......
6cec0 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 20 74 29 0a 20 20 20 20 28 .(setq.transient--helpp.t).....(
6cee0 77 69 74 68 2d 64 65 6d 6f 74 65 64 2d 65 72 72 6f 72 73 20 22 74 72 61 6e 73 69 65 6e 74 2d 68 with-demoted-errors."transient-h
6cf00 65 6c 70 3a 20 25 53 22 0a 20 20 20 20 20 20 28 77 68 65 6e 20 28 6c 6f 6f 6b 75 70 2d 6b 65 79 elp:.%S".......(when.(lookup-key
6cf20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 0a 20 20 20 20 20 20 .transient--transient-map.......
6cf40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 68 69 73 2d 73 69 6e 67 6c 65 2d 63 ..................(this-single-c
6cf60 6f 6d 6d 61 6e 64 2d 72 61 77 2d 6b 65 79 73 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 ommand-raw-keys)).........(setq.
6cf80 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 28 74 transient--helpp.nil).........(t
6cfa0 72 61 6e 73 69 65 6e 74 2d 2d 64 69 73 70 6c 61 79 2d 68 65 6c 70 20 23 27 74 72 61 6e 73 69 65 ransient--display-help.#'transie
6cfc0 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nt-show-help....................
6cfe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 65 71 20 74 68 69 73 2d 6f 72 69 67 69 ..............(if.(eq.this-origi
6d000 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 29 0a 20 20 20 nal-command.'transient-help)....
6d020 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 ................................
6d040 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 ..transient--prefix.............
6d060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 74 72 61 6e .......................(or.(tran
6d080 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 sient-suffix-object)............
6d0a0 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 74 68 69 73 ............................this
6d0c0 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 29 29 29 0a 0a 28 74 72 61 6e 73 -original-command)))))))..(trans
6d0e0 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 ient-define-suffix.transient-des
6d100 63 72 69 62 65 20 28 29 0a 20 20 22 46 72 6f 6d 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e cribe.()..."From.a.transient.men
6d120 75 2c 20 64 65 73 63 72 69 62 65 20 73 6f 6d 65 74 68 69 6e 67 20 69 6e 20 61 6e 6f 74 68 65 72 u,.describe.something.in.another
6d140 20 62 75 66 66 65 72 2e 0a 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 65 20 62 6f .buffer...This.command.can.be.bo
6d160 75 6e 64 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 20 74 6f 20 64 65 73 63 72 69 62 65 20 64 und.multiple.times.to.describe.d
6d180 69 66 66 65 72 65 6e 74 20 74 61 72 67 65 74 73 2e 0a 45 61 63 68 20 62 69 6e 64 69 6e 67 20 6d ifferent.targets..Each.binding.m
6d1a0 75 73 74 20 73 70 65 63 69 66 79 20 74 68 65 20 74 68 69 6e 67 20 69 74 20 64 65 73 63 72 69 62 ust.specify.the.thing.it.describ
6d1c0 65 73 2c 20 62 65 20 73 65 74 74 69 6e 67 20 74 68 65 20 76 61 6c 75 65 0a 6f 66 20 69 74 73 20 es,.be.setting.the.value.of.its.
6d1e0 60 74 61 72 67 65 74 27 20 73 6c 6f 74 2c 20 75 73 69 6e 67 20 74 68 65 20 6b 65 79 77 6f 72 64 `target'.slot,.using.the.keyword
6d200 20 61 72 67 75 6d 65 6e 74 20 60 3a 3d 27 2e 0a 0a 54 68 65 20 60 68 65 6c 70 65 72 27 20 73 6c .argument.`:='...The.`helper'.sl
6d220 6f 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6c 6f 77 2d 6c 65 76 65 6c 20 66 75 6e 63 74 ot.specifies.the.low-level.funct
6d240 69 6f 6e 20 75 73 65 64 20 74 6f 20 64 65 73 63 72 69 62 65 20 74 68 65 0a 74 61 72 67 65 74 2c ion.used.to.describe.the.target,
6d260 20 61 6e 64 20 63 61 6e 20 62 65 20 6f 6d 69 74 74 65 64 2c 20 69 6e 20 77 68 69 63 68 20 63 61 .and.can.be.omitted,.in.which.ca
6d280 73 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e se.`transient--describe-function
6d2a0 27 0a 69 73 20 75 73 65 64 20 66 6f 72 20 61 20 73 79 6d 62 6f 6c 2c 20 60 74 72 61 6e 73 69 65 '.is.used.for.a.symbol,.`transie
6d2c0 6e 74 2d 2d 73 68 6f 77 2d 6d 61 6e 75 61 6c 27 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 20 73 nt--show-manual'.is.used.for.a.s
6d2e0 74 72 69 6e 67 0a 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 61 20 70 61 72 65 6e 74 68 65 73 tring.beginning.with.a.parenthes
6d300 69 73 2c 20 61 6e 64 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 6d 61 6e 70 61 67 65 is,.and.`transient--show-manpage
6d320 27 20 69 73 20 75 73 65 64 20 66 6f 72 0a 61 6e 79 20 6f 74 68 65 72 20 73 74 72 69 6e 67 2e 0a '.is.used.for.any.other.string..
6d340 0a 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 20 20 5b 28 5c 22 65 5c 22 20 5c 22 61 62 6f 75 74 20 .For.example:...[(\"e\".\"about.
6d360 65 6d 61 63 73 5c 22 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 20 3a 3d 20 5c 22 emacs\".transient-describe.:=.\"
6d380 28 65 6d 61 63 73 29 5c 22 29 0a 20 20 20 28 5c 22 67 5c 22 20 5c 22 61 62 6f 75 74 20 67 69 74 (emacs)\")....(\"g\".\"about.git
6d3a0 5c 22 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 62 65 20 3a 3d 20 5c 22 67 69 74 \"...transient-describe.:=.\"git
6d3c0 5c 22 29 5d 22 0a 20 20 3a 63 6c 61 73 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 65 73 63 72 69 \")]"...:class.'transient-descri
6d3e0 62 65 2d 74 61 72 67 65 74 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 77 69 74 be-target...(interactive)...(wit
6d400 68 2d 73 6c 6f 74 73 20 28 68 65 6c 70 65 72 20 74 61 72 67 65 74 29 20 28 74 72 61 6e 73 69 65 h-slots.(helper.target).(transie
6d420 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 nt-suffix-object).....(transient
6d440 2d 2d 64 69 73 70 6c 61 79 2d 68 65 6c 70 20 68 65 6c 70 65 72 20 74 61 72 67 65 74 29 29 29 0a --display-help.helper.target))).
6d460 0a 3b 3b 3b 3b 20 4c 65 76 65 6c 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 .;;;;.Level..(defun.transient-se
6d480 74 2d 6c 65 76 65 6c 20 28 26 6f 70 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 20 6c 65 76 65 6c t-level.(&optional.command.level
6d4a0 29 0a 20 20 22 53 65 74 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 )..."Set.the.level.of.the.transi
6d4c0 65 6e 74 20 6f 72 20 6f 6e 65 20 6f 66 20 69 74 73 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 ent.or.one.of.its.suffix.command
6d4e0 73 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 0a 20 20 20 28 6c 65 74 20 28 28 63 6f 6d s."...(interactive....(let.((com
6d500 6d 61 6e 64 20 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 mand.this-original-command).....
6d520 20 20 20 20 20 28 70 72 65 66 69 78 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 .....(prefix.(oref.transient--pr
6d540 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 20 20 20 28 61 6e 64 20 28 6f 72 20 28 6e efix.command)))......(and.(or.(n
6d560 6f 74 20 28 65 71 20 63 6f 6d 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 ot.(eq.command.'transient-set-le
6d580 76 65 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 74 72 61 6e 73 69 65 vel))...............(and.transie
6d5a0 6e 74 2d 2d 65 64 69 74 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 nt--editp....................(se
6d5c0 74 71 20 63 6f 6d 6d 61 6e 64 20 70 72 65 66 69 78 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 tq.command.prefix)))...........(
6d5e0 6c 69 73 74 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 list.command.................(le
6d600 74 20 28 28 6b 65 79 73 20 28 74 68 69 73 2d 73 69 6e 67 6c 65 2d 63 6f 6d 6d 61 6e 64 2d 72 61 t.((keys.(this-single-command-ra
6d620 77 2d 6b 65 79 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 w-keys)))...................(and
6d640 20 28 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 2d 74 72 61 6e 73 69 65 6e .(lookup-key.transient--transien
6d660 74 2d 6d 61 70 20 6b 65 79 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t-map.keys).....................
6d680 20 20 20 28 70 72 6f 67 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ...(progn.......................
6d6a0 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 ...(transient--show)............
6d6c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 74 72 69 6e 67 2d 74 6f 2d 6e 75 6d 62 65 72 0a ..............(string-to-number.
6d6e0 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 74 72 61 6e 73 ..........................(trans
6d700 69 65 6e 74 2d 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d 4e 0a 20 20 20 20 20 20 20 20 20 20 20 20 ient--read-number-N.............
6d720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 53 65 74 20 6c 65 76 65 ...............(format."Set.leve
6d740 6c 20 66 6f 72 20 60 25 73 27 3a 20 22 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 l.for.`%s':.".command)..........
6d760 20 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 28 6e 6f 74 20 28 ..................nil.nil.(not.(
6d780 65 71 20 63 6f 6d 6d 61 6e 64 20 70 72 65 66 69 78 29 29 29 29 29 29 29 29 29 29 29 0a 20 20 28 eq.command.prefix)))))))))))...(
6d7a0 63 6f 6e 64 0a 20 20 20 28 28 6e 6f 74 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 28 73 65 74 71 cond....((not.command).....(setq
6d7c0 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 20 74 29 0a 20 20 20 20 28 74 72 61 6e 73 69 .transient--editp.t).....(transi
6d7e0 65 6e 74 2d 73 65 74 75 70 29 29 0a 20 20 20 28 6c 65 76 65 6c 0a 20 20 20 20 28 6c 65 74 2a 20 ent-setup))....(level.....(let*.
6d800 28 28 70 72 65 66 69 78 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 ((prefix.(oref.transient--prefix
6d820 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 61 6c 69 73 74 20 28 61 6c .command))............(alist.(al
6d840 69 73 74 2d 67 65 74 20 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 29 ist-get.prefix.transient-levels)
6d860 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 61 6b 65 79 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 )............(akey.command))....
6d880 20 20 20 28 63 6f 6e 64 20 28 28 65 71 20 63 6f 6d 6d 61 6e 64 20 70 72 65 66 69 78 29 0a 20 20 ...(cond.((eq.command.prefix)...
6d8a0 20 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 ...........(oset.transient--pref
6d8c0 69 78 20 6c 65 76 65 6c 20 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 ix.level.level)..............(se
6d8e0 74 71 20 61 6b 65 79 20 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 74 0a 20 20 20 20 20 tq.akey.t)).............(t......
6d900 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d ........(oset.(transient-suffix-
6d920 6f 62 6a 65 63 74 20 63 6f 6d 6d 61 6e 64 29 20 6c 65 76 65 6c 20 6c 65 76 65 6c 29 0a 20 20 20 object.command).level.level)....
6d940 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 63 64 72 20 28 63 6c 2d 72 65 6d 6f 76 65 2d ..........(when.(cdr.(cl-remove-
6d960 69 66 2d 6e 6f 74 20 28 6c 61 6d 62 64 61 20 28 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 if-not.(lambda.(obj)............
6d980 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 ................................
6d9a0 20 28 65 71 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 20 63 6f 6d 6d 61 6e 64 29 .(eq.(oref.obj.command).command)
6d9c0 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 20 20 20 20 )...............................
6d9e0 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 ............transient--suffixes)
6da00 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 61 6b 65 79 20 28 63 6f 6e )................(setq.akey.(con
6da20 73 20 63 6f 6d 6d 61 6e 64 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 29 29 29 s.command.(this-command-keys))))
6da40 29 29 0a 20 20 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 61 6b 65 79 20 61 )).......(setf.(alist-get.akey.a
6da60 6c 69 73 74 29 20 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 74 2d list).level).......(setf.(alist-
6da80 67 65 74 20 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 6c 65 76 65 6c 73 29 20 61 6c 69 get.prefix.transient-levels).ali
6daa0 73 74 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 6c 65 76 65 6c 73 29 st)).....(transient-save-levels)
6dac0 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 29 0a 20 20 20 28 74 0a 20 20 .....(transient--show))....(t...
6dae0 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 29 29 29 29 0a 0a 28 74 72 61 ..(transient-undefined))))..(tra
6db00 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 74 nsient-define-suffix.transient-t
6db20 6f 67 67 6c 65 2d 6c 65 76 65 6c 2d 6c 69 6d 69 74 20 28 29 0a 20 20 22 54 6f 67 67 6c 65 20 77 oggle-level-limit.()..."Toggle.w
6db40 68 65 74 68 65 72 20 74 6f 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 64 69 73 70 6c 61 79 20 73 75 hether.to.temporarily.display.su
6db60 66 66 69 78 65 73 20 6f 6e 20 61 6c 6c 20 6c 65 76 65 6c 73 2e 22 0a 20 20 3a 64 65 73 63 72 69 ffixes.on.all.levels."...:descri
6db80 70 74 69 6f 6e 0a 20 20 28 6c 61 6d 62 64 61 20 28 29 0a 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 ption...(lambda.().....(cond....
6dba0 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 0a 20 20 20 20 20 ..(transient--all-levels-p......
6dbc0 20 28 66 6f 72 6d 61 74 20 22 48 69 64 65 20 73 75 66 66 69 78 20 25 73 22 0a 20 20 20 20 20 20 .(format."Hide.suffix.%s".......
6dbe0 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 ........(propertize.............
6dc00 20 20 20 28 66 6f 72 6d 61 74 20 22 6c 65 76 65 6c 73 20 3e 20 25 73 22 20 28 6f 72 65 66 20 28 ...(format."levels.>.%s".(oref.(
6dc20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 29 20 6c 65 76 65 6c 29 29 transient-prefix-object).level))
6dc40 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 ................'face.'transient
6dc60 2d 68 69 67 68 65 72 2d 6c 65 76 65 6c 29 29 29 0a 20 20 20 20 20 28 22 53 68 6f 77 20 61 6c 6c -higher-level)))......("Show.all
6dc80 20 73 75 66 66 69 78 20 6c 65 76 65 6c 73 22 29 29 29 0a 20 20 3a 74 72 61 6e 73 69 65 6e 74 20 .suffix.levels")))...:transient.
6dca0 74 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 t...(interactive)...(setq.transi
6dcc0 65 6e 74 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 ent--all-levels-p.(not.transient
6dce0 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 --all-levels-p))...(setq.transie
6dd00 6e 74 2d 2d 72 65 66 72 65 73 68 70 20 74 29 29 0a 0a 3b 3b 3b 3b 20 56 61 6c 75 65 0a 0a 28 64 nt--refreshp.t))..;;;;.Value..(d
6dd20 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 20 28 29 0a 20 20 22 53 65 74 20 61 63 74 efun.transient-set.()..."Set.act
6dd40 69 76 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 76 61 6c 75 65 20 66 6f 72 20 74 68 69 73 20 45 ive.transient's.value.for.this.E
6dd60 6d 61 63 73 20 73 65 73 73 69 6f 6e 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 macs.session."...(interactive)..
6dd80 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 76 61 6c 75 65 20 28 74 72 61 6e 73 69 65 6e 74 .(transient-set-value.(transient
6dda0 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a 0a 28 64 65 66 61 6c 69 61 73 20 27 74 72 -prefix-object)))..(defalias.'tr
6ddc0 61 6e 73 69 65 6e 74 2d 73 65 74 2d 61 6e 64 2d 65 78 69 74 20 23 27 74 72 61 6e 73 69 65 6e 74 ansient-set-and-exit.#'transient
6dde0 2d 73 65 74 0a 20 20 22 53 65 74 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 76 -set..."Set.active.transient's.v
6de00 61 6c 75 65 20 66 6f 72 20 74 68 69 73 20 45 6d 61 63 73 20 73 65 73 73 69 6f 6e 20 61 6e 64 20 alue.for.this.Emacs.session.and.
6de20 65 78 69 74 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 20 28 exit.")..(defun.transient-save.(
6de40 29 0a 20 20 22 53 61 76 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 76 61 6c )..."Save.active.transient's.val
6de60 75 65 20 66 6f 72 20 74 68 69 73 20 61 6e 64 20 66 75 74 75 72 65 20 45 6d 61 63 73 20 73 65 73 ue.for.this.and.future.Emacs.ses
6de80 73 69 6f 6e 73 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 74 72 61 6e 73 sions."...(interactive)...(trans
6dea0 69 65 6e 74 2d 73 61 76 65 2d 76 61 6c 75 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 ient-save-value.(transient-prefi
6dec0 78 2d 6f 62 6a 65 63 74 29 29 29 0a 0a 28 64 65 66 61 6c 69 61 73 20 27 74 72 61 6e 73 69 65 6e x-object)))..(defalias.'transien
6dee0 74 2d 73 61 76 65 2d 61 6e 64 2d 65 78 69 74 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 t-save-and-exit.#'transient-save
6df00 0a 20 20 22 53 61 76 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 76 61 6c 75 ..."Save.active.transient's.valu
6df20 65 20 66 6f 72 20 74 68 69 73 20 61 6e 64 20 66 75 74 75 72 65 20 45 6d 61 63 73 20 73 65 73 73 e.for.this.and.future.Emacs.sess
6df40 69 6f 6e 73 20 61 6e 64 20 65 78 69 74 2e 22 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 ions.and.exit.")..(defun.transie
6df60 6e 74 2d 72 65 73 65 74 20 28 29 0a 20 20 22 43 6c 65 61 72 20 74 68 65 20 73 65 74 20 61 6e 64 nt-reset.()..."Clear.the.set.and
6df80 20 73 61 76 65 64 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e .saved.values.of.the.active.tran
6dfa0 73 69 65 6e 74 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 74 72 61 6e 73 sient."...(interactive)...(trans
6dfc0 69 65 6e 74 2d 72 65 73 65 74 2d 76 61 6c 75 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 ient-reset-value.(transient-pref
6dfe0 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 68 ix-object)))..(defun.transient-h
6e000 69 73 74 6f 72 79 2d 6e 65 78 74 20 28 29 0a 20 20 22 53 77 69 74 63 68 20 74 6f 20 74 68 65 20 istory-next.()..."Switch.to.the.
6e020 6e 65 78 74 20 76 61 6c 75 65 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 61 63 74 69 76 65 20 74 next.value.used.for.the.active.t
6e040 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 6c 65 ransient."...(interactive)...(le
6e060 74 2a 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 t*.((obj.transient--prefix).....
6e080 20 20 20 20 20 28 70 6f 73 20 28 31 2d 20 28 6f 72 65 66 20 6f 62 6a 20 68 69 73 74 6f 72 79 2d .....(pos.(1-.(oref.obj.history-
6e0a0 70 6f 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 68 73 74 20 28 6f 72 65 66 20 6f 62 6a 20 68 pos)))..........(hst.(oref.obj.h
6e0c0 69 73 74 6f 72 79 29 29 29 0a 20 20 20 20 28 69 66 20 28 3c 20 70 6f 73 20 30 29 0a 20 20 20 20 istory))).....(if.(<.pos.0).....
6e0e0 20 20 20 20 28 75 73 65 72 2d 65 72 72 6f 72 20 22 45 6e 64 20 6f 66 20 68 69 73 74 6f 72 79 22 ....(user-error."End.of.history"
6e100 29 0a 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 68 69 73 74 6f 72 79 2d 70 6f 73 20 70 6f ).......(oset.obj.history-pos.po
6e120 73 29 0a 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 28 6e 74 68 20 70 6f s).......(oset.obj.value.(nth.po
6e140 73 20 68 73 74 29 29 0a 20 20 20 20 20 20 28 6d 61 70 63 20 23 27 74 72 61 6e 73 69 65 6e 74 2d s.hst)).......(mapc.#'transient-
6e160 69 6e 69 74 2d 76 61 6c 75 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 29 init-value.transient--suffixes))
6e180 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 ))..(defun.transient-history-pre
6e1a0 76 20 28 29 0a 20 20 22 53 77 69 74 63 68 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 v.()..."Switch.to.the.previous.v
6e1c0 61 6c 75 65 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 alue.used.for.the.active.transie
6e1e0 6e 74 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 6c 65 74 2a 20 28 28 6f nt."...(interactive)...(let*.((o
6e200 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 28 bj.transient--prefix)..........(
6e220 70 6f 73 20 28 31 2b 20 28 6f 72 65 66 20 6f 62 6a 20 68 69 73 74 6f 72 79 2d 70 6f 73 29 29 29 pos.(1+.(oref.obj.history-pos)))
6e240 0a 20 20 20 20 20 20 20 20 20 28 68 73 74 20 28 6f 72 65 66 20 6f 62 6a 20 68 69 73 74 6f 72 79 ..........(hst.(oref.obj.history
6e260 29 29 0a 20 20 20 20 20 20 20 20 20 28 6c 65 6e 20 28 6c 65 6e 67 74 68 20 68 73 74 29 29 29 0a ))..........(len.(length.hst))).
6e280 20 20 20 20 28 69 66 20 28 3e 20 70 6f 73 20 28 31 2d 20 6c 65 6e 29 29 0a 20 20 20 20 20 20 20 ....(if.(>.pos.(1-.len))........
6e2a0 20 28 75 73 65 72 2d 65 72 72 6f 72 20 22 45 6e 64 20 6f 66 20 68 69 73 74 6f 72 79 22 29 0a 20 .(user-error."End.of.history")..
6e2c0 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 68 69 73 74 6f 72 79 2d 70 6f 73 20 70 6f 73 29 0a .....(oset.obj.history-pos.pos).
6e2e0 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 28 6e 74 68 20 70 6f 73 20 68 ......(oset.obj.value.(nth.pos.h
6e300 73 74 29 29 0a 20 20 20 20 20 20 28 6d 61 70 63 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 st)).......(mapc.#'transient-ini
6e320 74 2d 76 61 6c 75 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 29 29 29 0a t-value.transient--suffixes)))).
6e340 0a 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 20 74 72 61 6e 73 69 .(transient-define-suffix.transi
6e360 65 6e 74 2d 70 72 65 73 65 74 20 28 29 0a 20 20 22 50 75 74 20 74 68 69 73 20 70 72 65 73 65 74 ent-preset.()..."Put.this.preset
6e380 20 69 6e 74 6f 20 61 63 74 69 6f 6e 2e 22 0a 20 20 3a 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e .into.action."...:class.transien
6e3a0 74 2d 76 61 6c 75 65 2d 70 72 65 73 65 74 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 t-value-preset...(interactive)..
6e3c0 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 73 65 74 20 28 6f 72 65 66 20 28 74 72 .(transient-prefix-set.(oref.(tr
6e3e0 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 29 20 73 65 74 29 29 29 0a 0a 3b ansient-suffix-object).set)))..;
6e400 3b 3b 3b 20 41 75 78 69 6c 69 61 72 79 0a 0a 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 ;;;.Auxiliary..(transient-define
6e420 2d 73 75 66 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 20 -suffix.transient-toggle-common.
6e440 28 29 0a 20 20 22 54 6f 67 67 6c 65 20 77 68 65 74 68 65 72 20 63 6f 6d 6d 6f 6e 20 63 6f 6d 6d ()..."Toggle.whether.common.comm
6e460 61 6e 64 73 20 61 72 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 73 68 6f 77 6e 2e 22 0a 20 20 3a ands.are.permanently.shown."...:
6e480 74 72 61 6e 73 69 65 6e 74 20 74 0a 20 20 3a 64 65 73 63 72 69 70 74 69 6f 6e 20 28 6c 61 6d 62 transient.t...:description.(lamb
6e4a0 64 61 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 74 72 61 6e 73 da.()..................(if.trans
6e4c0 69 65 6e 74 2d 73 68 6f 77 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 20 20 ient-show-common-commands.......
6e4e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 48 69 64 65 20 63 6f 6d 6d 6f 6e 20 63 6f 6d 6d ..............."Hide.common.comm
6e500 61 6e 64 73 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 53 68 6f 77 20 63 ands"...................."Show.c
6e520 6f 6d 6d 6f 6e 20 70 65 72 6d 61 6e 65 6e 74 6c 79 22 29 29 0a 20 20 28 69 6e 74 65 72 61 63 74 ommon.permanently"))...(interact
6e540 69 76 65 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 63 6f 6d 6d ive)...(setq.transient-show-comm
6e560 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d on-commands.(not.transient-show-
6e580 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 73 29 29 29 0a 0a 28 74 72 61 6e 73 69 65 6e 74 2d 64 common-commands)))..(transient-d
6e5a0 65 66 69 6e 65 2d 73 75 66 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 6f efine-suffix.transient-toggle-do
6e5c0 63 73 74 72 69 6e 67 73 20 28 26 6f 70 74 69 6f 6e 61 6c 20 70 65 72 6d 61 6e 65 6e 74 29 0a 20 cstrings.(&optional.permanent)..
6e5e0 20 22 54 6f 67 67 6c 65 20 77 68 65 74 68 65 72 20 74 6f 20 73 68 6f 77 20 64 6f 63 73 74 72 69 ."Toggle.whether.to.show.docstri
6e600 6e 67 73 20 69 6e 73 74 65 61 64 20 6f 66 20 73 75 66 66 69 78 20 64 65 73 63 72 69 70 74 69 6f ngs.instead.of.suffix.descriptio
6e620 6e 73 2e 0a 0a 42 79 20 64 65 66 61 75 6c 74 20 74 68 69 73 20 69 73 20 6f 6e 6c 79 20 65 6e 61 ns...By.default.this.is.only.ena
6e640 62 6c 65 64 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 bled.temporarily.for.the.current
6e660 20 74 72 61 6e 73 69 65 6e 74 0a 6d 65 6e 75 20 69 6e 76 6f 63 61 74 69 6f 6e 2e 20 20 57 69 74 .transient.menu.invocation...Wit
6e680 68 20 61 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 2c 20 65 6e 61 62 6c 65 20 74 68 69 73 h.a.prefix.argument,.enable.this
6e6a0 20 75 6e 74 69 6c 20 65 78 70 6c 69 63 69 74 6c 79 0a 64 69 73 61 62 6c 65 64 20 61 67 61 69 6e .until.explicitly.disabled.again
6e6c0 2e 0a 0a 49 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 6e 6f 74 20 61 66 66 65 63 ...Infix.arguments.are.not.affec
6e6e0 74 65 64 20 62 79 20 74 68 69 73 2c 20 62 65 63 61 75 73 65 20 6f 74 68 65 72 77 69 73 65 20 6d ted.by.this,.because.otherwise.m
6e700 61 6e 79 20 6d 65 6e 75 73 0a 77 6f 75 6c 64 20 6c 69 6b 65 6c 79 20 62 65 63 6f 6d 65 20 75 6e any.menus.would.likely.become.un
6e720 72 65 61 64 61 62 6c 65 2e 20 20 54 6f 20 6d 61 6b 65 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 readable...To.make.this.command.
6e740 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 6c 6c 0a 6d 65 6e 75 73 2c 20 62 69 6e 64 20 69 74 20 available.in.all.menus,.bind.it.
6e760 69 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 27 2e 20 20 60 74 72 61 6e 73 69 65 6e 74 2d in.`transient-map'...`transient-
6e780 73 68 6f 77 2d 64 6f 63 73 74 72 69 6e 67 2d 66 6f 72 6d 61 74 27 0a 63 6f 6e 74 72 6f 6c 73 20 show-docstring-format'.controls.
6e7a0 68 6f 77 20 74 68 65 20 64 6f 63 73 74 72 69 6e 67 73 20 61 72 65 20 64 69 73 70 6c 61 79 65 64 how.the.docstrings.are.displayed
6e7c0 20 61 6e 64 20 77 68 65 74 68 65 72 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 61 72 65 0a 61 6c .and.whether.descriptions.are.al
6e7e0 73 6f 20 64 69 73 70 6c 61 79 65 64 2e 22 0a 20 20 3a 74 72 61 6e 73 69 65 6e 74 20 74 0a 20 20 so.displayed."...:transient.t...
6e800 28 69 6e 74 65 72 61 63 74 69 76 65 20 28 6c 69 73 74 20 63 75 72 72 65 6e 74 2d 70 72 65 66 69 (interactive.(list.current-prefi
6e820 78 2d 61 72 67 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 70 x-arg))...(setq.transient--docsp
6e840 20 28 69 66 20 70 65 72 6d 61 6e 65 6e 74 20 27 70 65 72 6d 61 6e 65 6e 74 20 28 6e 6f 74 20 74 .(if.permanent.'permanent.(not.t
6e860 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 63 73 70 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e ransient--docsp))))..(defun.tran
6e880 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 65 62 75 67 20 28 29 0a 20 20 22 54 6f 67 67 6c 65 20 sient-toggle-debug.()..."Toggle.
6e8a0 64 65 62 75 67 67 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 73 20 66 6f 72 20 74 72 61 6e 73 69 65 debugging.statements.for.transie
6e8c0 6e 74 20 63 6f 6d 6d 61 6e 64 73 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 nt.commands."...(interactive)...
6e8e0 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 28 6e 6f 74 20 74 72 61 6e (setq.transient--debug.(not.tran
6e900 73 69 65 6e 74 2d 2d 64 65 62 75 67 29 29 0a 20 20 28 6d 65 73 73 61 67 65 20 22 44 65 62 75 67 sient--debug))...(message."Debug
6e920 67 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 20 25 73 22 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 ging.transient.%s"............(i
6e940 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 20 22 65 6e 61 62 6c 65 64 22 20 22 64 69 f.transient--debug."enabled"."di
6e960 73 61 62 6c 65 64 22 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 70 sabled")))..(defun.transient-cop
6e980 79 2d 6d 65 6e 75 2d 74 65 78 74 20 28 29 0a 20 20 22 43 6f 70 79 20 74 68 65 20 63 6f 6e 74 65 y-menu-text.()..."Copy.the.conte
6e9a0 6e 74 73 20 6f 66 20 74 68 65 20 6d 65 6e 75 20 62 75 66 66 65 72 20 74 6f 20 74 68 65 20 6b 69 nts.of.the.menu.buffer.to.the.ki
6e9c0 6c 6c 20 72 69 6e 67 2e 0a 54 6f 20 6d 61 6b 65 20 74 68 69 73 20 61 76 61 69 6c 61 62 6c 65 20 ll.ring..To.make.this.available.
6e9e0 69 6e 20 61 6c 6c 20 6d 65 6e 75 73 2c 20 62 69 6e 64 20 69 74 20 69 6e 20 60 74 72 61 6e 73 69 in.all.menus,.bind.it.in.`transi
6ea00 65 6e 74 2d 6d 61 70 27 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 74 72 61 ent-map'"...(interactive)...(tra
6ea20 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 0a 20 20 28 77 69 74 68 2d 63 75 72 72 65 6e 74 2d 62 75 nsient--show)...(with-current-bu
6ea40 66 66 65 72 20 28 67 65 74 2d 62 75 66 66 65 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 ffer.(get-buffer.transient--buff
6ea60 65 72 2d 6e 61 6d 65 29 0a 20 20 20 20 28 63 6f 70 79 2d 72 65 67 69 6f 6e 2d 61 73 2d 6b 69 6c er-name).....(copy-region-as-kil
6ea80 6c 20 28 70 6f 69 6e 74 2d 6d 69 6e 29 20 28 70 6f 69 6e 74 2d 6d 61 78 29 29 29 29 0a 0a 28 74 l.(point-min).(point-max))))..(t
6eaa0 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 20 74 72 61 6e 73 69 65 6e 74 ransient-define-suffix.transient
6eac0 2d 65 63 68 6f 2d 61 72 67 75 6d 65 6e 74 73 20 28 61 72 67 75 6d 65 6e 74 73 29 0a 20 20 22 53 -echo-arguments.(arguments)..."S
6eae0 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 61 63 74 69 76 65 20 41 52 47 55 4d how.the.transient's.active.ARGUM
6eb00 45 4e 54 53 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2e 0a 49 6e 74 65 6e 64 65 64 20 ENTS.in.the.echo.area..Intended.
6eb20 66 6f 72 20 75 73 65 20 69 6e 20 70 72 65 66 69 78 65 73 20 75 73 65 64 20 66 6f 72 20 64 65 6d for.use.in.prefixes.used.for.dem
6eb40 6f 6e 73 74 72 61 74 69 6f 6e 20 70 75 72 70 6f 73 65 73 2c 0a 73 75 63 68 20 61 73 20 77 68 65 onstration.purposes,.such.as.whe
6eb60 6e 20 73 75 67 67 65 73 74 69 6e 67 20 61 20 6e 65 77 20 66 65 61 74 75 72 65 20 6f 72 20 72 65 n.suggesting.a.new.feature.or.re
6eb80 70 6f 72 74 69 6e 67 20 61 6e 20 69 73 73 75 65 2e 22 0a 20 20 3a 74 72 61 6e 73 69 65 6e 74 20 porting.an.issue."...:transient.
6eba0 74 0a 20 20 3a 64 65 73 63 72 69 70 74 69 6f 6e 20 22 45 63 68 6f 20 61 72 67 75 6d 65 6e 74 73 t...:description."Echo.arguments
6ebc0 22 0a 20 20 3a 6b 65 79 20 22 78 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 20 28 6c 69 73 "...:key."x"...(interactive.(lis
6ebe0 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 t.(transient-args.transient-curr
6ec00 65 6e 74 2d 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 28 69 66 20 28 73 65 71 2d 65 76 65 72 79 2d ent-command)))...(if.(seq-every-
6ec20 70 20 23 27 73 74 72 69 6e 67 70 20 61 72 67 75 6d 65 6e 74 73 29 0a 20 20 20 20 20 20 28 6d 65 p.#'stringp.arguments).......(me
6ec40 73 73 61 67 65 20 22 25 73 3a 20 25 73 22 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 ssage."%s:.%s".(key-description.
6ec60 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 (this-command-keys))............
6ec80 20 20 20 20 28 6d 61 70 63 6f 6e 63 61 74 20 28 6c 61 6d 62 64 61 20 28 61 72 67 29 0a 20 20 20 ....(mapconcat.(lambda.(arg)....
6eca0 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 70 72 6f 70 65 72 .........................(proper
6ecc0 74 69 7a 65 20 28 69 66 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 2d 70 20 22 20 22 20 61 72 67 tize.(if.(string-match-p.".".arg
6ece0 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 20 20 20 20 )...............................
6ed00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 25 53 22 20 61 72 67 29 0a ..............(format."%S".arg).
6ed20 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 ................................
6ed40 20 20 20 20 20 20 20 20 20 20 61 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..........arg)..................
6ed60 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 74 72 .......................'face.'tr
6ed80 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ansient-argument))..............
6eda0 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 75 6d 65 6e 74 73 20 22 20 22 29 29 0a 20 20 20 .............arguments."."))....
6edc0 20 28 6d 65 73 73 61 67 65 20 22 25 73 3a 20 25 53 22 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 .(message."%s:.%S".(key-descript
6ede0 69 6f 6e 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 29 20 61 72 67 75 6d 65 6e ion.(this-command-keys)).argumen
6ee00 74 73 29 29 29 0a 0a 3b 3b 3b 20 56 61 6c 75 65 0a 3b 3b 3b 3b 20 49 6e 69 74 0a 0a 28 63 6c 2d ts)))..;;;.Value.;;;;.Init..(cl-
6ee20 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 defgeneric.transient-init-value.
6ee40 28 6f 62 6a 29 0a 20 20 22 53 65 74 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 6f (obj)..."Set.the.initial.value.o
6ee60 66 20 74 68 65 20 70 72 65 66 69 78 20 6f 72 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 f.the.prefix.or.suffix.object.OB
6ee80 4a 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 J...This.function.is.called.for.
6eea0 61 6c 6c 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 0a all.prefix.and.suffix.commands..
6eec0 0a 54 68 69 72 64 2d 70 61 72 74 79 20 73 75 62 63 6c 61 73 73 65 73 20 6f 66 20 60 74 72 61 6e .Third-party.subclasses.of.`tran
6eee0 73 69 65 6e 74 2d 69 6e 66 69 78 27 20 6d 75 73 74 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 70 72 sient-infix'.must.implement.a.pr
6ef00 69 6d 61 72 79 0a 6d 65 74 68 6f 64 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 imary.method.")..(cl-defmethod.t
6ef20 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 3a 61 72 6f 75 6e 64 20 28 28 6f 62 ransient-init-value.:around.((ob
6ef40 6a 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 29 29 0a 20 20 22 49 66 20 62 6f 75 6e 64 j.transient-prefix))..."If.bound
6ef60 2c 20 75 73 65 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 4f 42 4a 27 ,.use.the.value.returned.by.OBJ'
6ef80 20 60 69 6e 69 74 2d 76 61 6c 75 65 27 20 66 75 6e 63 74 69 6f 6e 2e 0a 49 66 20 74 68 65 20 76 .`init-value'.function..If.the.v
6efa0 61 6c 75 65 20 6f 66 20 4f 42 4a 27 73 20 60 69 6e 69 74 2d 76 61 6c 75 65 27 20 69 73 20 6e 6f alue.of.OBJ's.`init-value'.is.no
6efc0 6e 2d 6e 69 6c 2c 20 63 61 6c 6c 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 74 6f 0a 64 65 74 n-nil,.call.that.function.to.det
6efe0 65 72 6d 69 6e 65 20 74 68 65 20 76 61 6c 75 65 2e 20 20 4f 74 68 65 72 77 69 73 65 20 63 61 6c ermine.the.value...Otherwise.cal
6f000 6c 20 74 68 65 20 70 72 69 6d 61 72 79 20 6d 65 74 68 6f 64 20 61 63 63 6f 72 64 69 6e 67 20 74 l.the.primary.method.according.t
6f020 6f 0a 4f 42 4a 27 73 20 63 6c 61 73 73 2e 22 0a 20 20 28 69 66 20 28 73 6c 6f 74 2d 62 6f 75 6e o.OBJ's.class."...(if.(slot-boun
6f040 64 70 20 6f 62 6a 20 27 69 6e 69 74 2d 76 61 6c 75 65 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 dp.obj.'init-value).......(funca
6f060 6c 6c 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 69 74 2d 76 61 6c 75 65 29 20 6f 62 6a 29 0a 20 20 ll.(oref.obj.init-value).obj)...
6f080 20 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 6a 29 29 29 0a 0a 28 ..(cl-call-next-method.obj)))..(
6f0a0 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 cl-defmethod.transient-init-valu
6f0c0 65 20 3a 61 72 6f 75 6e 64 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 e.:around.((obj.transient-infix)
6f0e0 29 0a 20 20 22 49 66 20 62 6f 75 6e 64 2c 20 75 73 65 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 )..."If.bound,.use.the.value.ret
6f100 75 72 6e 65 64 20 62 79 20 4f 42 4a 27 73 20 60 69 6e 69 74 2d 76 61 6c 75 65 27 20 66 75 6e 63 urned.by.OBJ's.`init-value'.func
6f120 74 69 6f 6e 2e 0a 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4f 42 4a 27 73 20 60 69 6e 69 tion..If.the.value.of.OBJ's.`ini
6f140 74 2d 76 61 6c 75 65 27 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 63 61 6c 6c 20 74 68 61 74 20 66 t-value'.is.non-nil,.call.that.f
6f160 75 6e 63 74 69 6f 6e 20 74 6f 0a 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 76 61 6c 75 65 2e 20 unction.to.determine.the.value..
6f180 20 4f 74 68 65 72 77 69 73 65 20 63 61 6c 6c 20 74 68 65 20 70 72 69 6d 61 72 79 20 6d 65 74 68 .Otherwise.call.the.primary.meth
6f1a0 6f 64 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 0a 4f 42 4a 27 73 20 63 6c 61 73 73 2e 22 0a 20 20 od.according.to.OBJ's.class."...
6f1c0 28 69 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 69 6e 69 74 2d 76 61 6c 75 65 (if.(slot-boundp.obj.'init-value
6f1e0 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 69 74 2d ).......(funcall.(oref.obj.init-
6f200 76 61 6c 75 65 29 20 6f 62 6a 29 0a 20 20 20 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 value).obj).....(cl-call-next-me
6f220 74 68 6f 64 20 6f 62 6a 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 thod.obj)))..(cl-defmethod.trans
6f240 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d ient-init-value.((obj.transient-
6f260 70 72 65 66 69 78 29 29 0a 20 20 22 53 65 74 20 4f 42 4a 27 73 20 69 6e 69 74 69 61 6c 20 76 61 prefix))..."Set.OBJ's.initial.va
6f280 6c 75 65 20 74 6f 20 74 68 65 20 73 65 74 2c 20 73 61 76 65 64 20 6f 72 20 64 65 66 61 75 6c 74 lue.to.the.set,.saved.or.default
6f2a0 20 76 61 6c 75 65 2e 0a 55 73 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 .value..Use.`transient-default-v
6f2c0 61 6c 75 65 27 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 alue'.to.determine.the.default.v
6f2e0 61 6c 75 65 2e 22 0a 20 20 28 69 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 76 alue."...(if.(slot-boundp.obj.'v
6f300 61 6c 75 65 29 0a 20 20 20 20 20 20 3b 3b 20 41 6c 72 65 61 64 79 20 73 65 74 20 62 65 63 61 75 alue).......;;.Already.set.becau
6f320 73 65 20 74 68 65 20 6c 69 76 65 20 6f 62 6a 65 63 74 20 69 73 20 63 6c 6f 6e 65 64 20 66 72 6f se.the.live.object.is.cloned.fro
6f340 6d 0a 20 20 20 20 20 20 3b 3b 20 74 68 65 20 70 72 6f 74 6f 74 79 70 65 2c 20 77 65 72 65 20 74 m.......;;.the.prototype,.were.t
6f360 68 65 20 73 65 74 20 28 69 66 20 61 6e 79 29 20 76 61 6c 75 65 20 69 73 20 73 74 6f 72 65 64 2e he.set.(if.any).value.is.stored.
6f380 0a 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 6c 75 65 29 0a 20 20 20 20 28 6f 73 65 .......(oref.obj.value).....(ose
6f3a0 74 20 6f 62 6a 20 76 61 6c 75 65 0a 20 20 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 t.obj.value...........(if-let.((
6f3c0 73 61 76 65 64 20 28 61 73 73 71 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 20 74 saved.(assq.(oref.obj.command).t
6f3e0 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ransient-values)))..............
6f400 20 28 63 64 72 20 73 61 76 65 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 .(cdr.saved).............(transi
6f420 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 6f 62 6a 29 29 29 29 29 0a 0a 28 63 6c 2d ent-default-value.obj)))))..(cl-
6f440 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 28 defmethod.transient-init-value.(
6f460 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 4e 6f 6e 2d 69 (obj.transient-suffix))..."Non-i
6f480 6e 66 69 78 20 73 75 66 66 69 78 65 73 20 75 73 75 61 6c 6c 79 20 64 6f 6e 27 74 20 68 61 76 65 nfix.suffixes.usually.don't.have
6f4a0 20 61 20 76 61 6c 75 65 2e 0a 43 61 6c 6c 20 60 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c .a.value..Call.`transient-defaul
6f4c0 74 2d 76 61 6c 75 65 27 20 62 75 74 20 62 65 63 61 75 73 65 20 74 68 61 74 20 69 73 20 61 20 6e t-value'.but.because.that.is.a.n
6f4e0 6f 6f 70 20 66 6f 72 0a 60 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 27 2c 20 74 68 69 73 oop.for.`transient-suffix',.this
6f500 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 65 66 66 65 63 74 69 76 65 6c 79 20 61 6c 73 6f 20 61 20 .function.is.effectively.also.a.
6f520 6e 6f 6f 70 2e 22 0a 20 20 28 6c 65 74 20 28 28 76 61 6c 75 65 20 28 74 72 61 6e 73 69 65 6e 74 noop."...(let.((value.(transient
6f540 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 6f 62 6a 29 29 29 0a 20 20 20 20 28 75 6e 6c 65 73 -default-value.obj))).....(unles
6f560 73 20 28 65 71 20 76 61 6c 75 65 20 65 69 65 69 6f 2d 2d 75 6e 62 6f 75 6e 64 29 0a 20 20 20 20 s.(eq.value.eieio--unbound).....
6f580 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 76 61 6c 75 65 29 29 29 29 0a 0a 28 63 6c ..(oset.obj.value.value))))..(cl
6f5a0 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 -defmethod.transient-init-value.
6f5c0 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 22 45 78 ((obj.transient-argument))..."Ex
6f5e0 74 72 61 63 74 20 4f 42 4a 27 73 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 76 61 6c 75 65 tract.OBJ's.value.from.the.value
6f600 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 2e 22 0a 20 20 28 6f 73 65 74 20 .of.the.prefix.object."...(oset.
6f620 6f 62 6a 20 76 61 6c 75 65 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 76 61 6c 75 65 20 28 obj.value.........(let.((value.(
6f640 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 76 61 6c 75 65 29 29 0a 20 oref.transient--prefix.value))..
6f660 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 72 67 75 6d 65 6e 74 20 28 61 6e 64 20 28 73 6c 6f .............(argument.(and.(slo
6f680 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 61 72 67 75 6d 65 6e 74 29 0a 20 20 20 20 20 20 20 20 t-boundp.obj.'argument).........
6f6a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 61 .....................(oref.obj.a
6f6c0 72 67 75 6d 65 6e 74 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 75 6c 74 69 2d rgument)))...............(multi-
6f6e0 76 61 6c 75 65 20 28 6f 72 65 66 20 6f 62 6a 20 6d 75 6c 74 69 2d 76 61 6c 75 65 29 29 0a 20 20 value.(oref.obj.multi-value))...
6f700 20 20 20 20 20 20 20 20 20 20 20 20 28 63 61 73 65 2d 66 6f 6c 64 2d 73 65 61 72 63 68 20 6e 69 ............(case-fold-search.ni
6f720 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 67 65 78 70 20 28 69 66 20 28 73 6c l)...............(regexp.(if.(sl
6f740 6f 74 2d 65 78 69 73 74 73 2d 70 20 6f 62 6a 20 27 61 72 67 75 6d 65 6e 74 2d 72 65 67 65 78 70 ot-exists-p.obj.'argument-regexp
6f760 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 6f 72 65 )...........................(ore
6f780 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 2d 72 65 67 65 78 70 29 0a 20 20 20 20 20 20 20 20 20 f.obj.argument-regexp)..........
6f7a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 5c 5c 60 25 73 5c 5c 28 ...............(format."\\`%s\\(
6f7c0 2e 2a 5c 5c 29 22 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 29 29 29 29 0a 20 .*\\)".(oref.obj.argument)))))..
6f7e0 20 20 20 20 20 20 20 20 20 28 69 66 20 28 6d 65 6d 71 20 6d 75 6c 74 69 2d 76 61 6c 75 65 20 27 .........(if.(memq.multi-value.'
6f800 28 74 20 72 65 73 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 64 72 20 28 61 73 (t.rest))...............(cdr.(as
6f820 73 6f 63 20 61 72 67 75 6d 65 6e 74 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 soc.argument.value))............
6f840 20 28 6c 65 74 20 28 28 6d 61 74 63 68 20 28 6c 61 6d 62 64 61 20 28 76 29 0a 20 20 20 20 20 20 .(let.((match.(lambda.(v).......
6f860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 73 74 72 69 6e .....................(and.(strin
6f880 67 70 20 76 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 gp.v)...........................
6f8a0 20 20 20 20 20 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 72 65 67 65 78 70 20 76 29 0a 20 20 ......(string-match.regexp.v)...
6f8c0 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 28 6d ..............................(m
6f8e0 61 74 63 68 2d 73 74 72 69 6e 67 20 31 20 76 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 atch-string.1.v)))))............
6f900 20 20 20 28 69 66 20 6d 75 6c 74 69 2d 76 61 6c 75 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...(if.multi-value..............
6f920 20 20 20 20 20 28 64 65 6c 71 20 6e 69 6c 20 28 6d 61 70 63 61 72 20 6d 61 74 63 68 20 76 61 6c .....(delq.nil.(mapcar.match.val
6f940 75 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6c 2d 73 6f 6d 65 20 6d 61 ue)).................(cl-some.ma
6f960 74 63 68 20 76 61 6c 75 65 29 29 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 tch.value)))))))..(cl-defmethod.
6f980 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 transient-init-value.((obj.trans
6f9a0 69 65 6e 74 2d 73 77 69 74 63 68 29 29 0a 20 20 22 45 78 74 72 61 63 74 20 4f 42 4a 27 73 20 76 ient-switch))..."Extract.OBJ's.v
6f9c0 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 65 66 69 alue.from.the.value.of.the.prefi
6f9e0 78 20 6f 62 6a 65 63 74 2e 22 0a 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 0a 20 20 20 x.object."...(oset.obj.value....
6fa00 20 20 20 20 20 28 63 61 72 20 28 6d 65 6d 62 65 72 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 .....(car.(member.(oref.obj.argu
6fa20 6d 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 ment)......................(oref
6fa40 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 76 61 6c 75 65 29 29 29 29 29 0a 0a 3b .transient--prefix.value)))))..;
6fa60 3b 3b 3b 20 44 65 66 61 75 6c 74 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e ;;;.Default..(cl-defgeneric.tran
6fa80 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 28 6f 62 6a 29 0a 20 20 22 52 65 74 sient-default-value.(obj)..."Ret
6faa0 75 72 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 22 29 0a 0a 28 63 6c 2d 64 65 urn.the.default.value.")..(cl-de
6fac0 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 fmethod.transient-default-value.
6fae0 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 29 29 0a 20 20 22 52 65 74 75 ((obj.transient-prefix))..."Retu
6fb00 72 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 61 73 20 73 70 65 63 69 66 69 65 rn.the.default.value.as.specifie
6fb20 64 20 62 79 20 74 68 65 20 60 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 27 20 73 6c 6f 74 2e 0a 49 d.by.the.`default-value'.slot..I
6fb40 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 60 64 65 66 61 75 6c 74 2d 76 61 6c 75 f.the.value.of.the.`default-valu
6fb60 65 27 20 73 6c 6f 74 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 63 61 6c 6c 20 69 74 20 74 e'.slot.is.a.function,.call.it.t
6fb80 6f 0a 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 76 61 6c 75 65 2e 20 20 49 66 20 74 68 65 20 73 o.determine.the.value...If.the.s
6fba0 6c 6f 74 27 73 20 76 61 6c 75 65 20 69 73 6e 27 74 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 72 65 lot's.value.isn't.a.function,.re
6fbc0 74 75 72 6e 0a 74 68 61 74 2e 20 20 49 66 20 74 68 65 20 73 6c 6f 74 20 69 73 20 75 6e 62 6f 75 turn.that...If.the.slot.is.unbou
6fbe0 6e 64 2c 20 72 65 74 75 72 6e 20 6e 69 6c 2e 22 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 64 65 66 nd,.return.nil."...(if-let.((def
6fc00 61 75 6c 74 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 64 65 66 61 ault.(and.(slot-boundp.obj.'defa
6fc20 75 6c 74 2d 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ult-value)......................
6fc40 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 29 29 29 29 0a ....(oref.obj.default-value)))).
6fc60 20 20 20 20 20 20 28 69 66 20 28 66 75 6e 63 74 69 6f 6e 70 20 64 65 66 61 75 6c 74 29 0a 20 20 ......(if.(functionp.default)...
6fc80 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 64 65 66 61 75 6c 74 29 0a 20 20 20 20 20 20 ........(funcall.default).......
6fca0 20 20 64 65 66 61 75 6c 74 29 0a 20 20 20 20 6e 69 6c 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 ..default).....nil))..(cl-defmet
6fcc0 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 28 28 5f 20 hod.transient-default-value.((_.
6fce0 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 52 65 74 75 72 6e 20 60 ..transient-suffix))..."Return.`
6fd00 65 69 65 69 6f 2d 2d 75 6e 62 6f 75 6e 64 27 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 eieio--unbound'.to.indicate.that
6fd20 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 0a 44 6f 69 6e .there.is.no.default.value..Doin
6fd40 67 20 73 6f 20 63 61 75 73 65 73 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 g.so.causes.`transient-init-valu
6fd60 65 27 20 74 6f 20 73 6b 69 70 20 73 65 74 74 69 6e 67 20 74 68 65 20 60 76 61 6c 75 65 27 20 73 e'.to.skip.setting.the.`value'.s
6fd80 6c 6f 74 2e 22 0a 20 20 65 69 65 69 6f 2d 2d 75 6e 62 6f 75 6e 64 29 0a 0a 3b 3b 3b 3b 20 52 65 lot."...eieio--unbound)..;;;;.Re
6fda0 61 64 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 ad..(cl-defgeneric.transient-inf
6fdc0 69 78 2d 72 65 61 64 20 28 6f 62 6a 29 0a 20 20 22 44 65 74 65 72 6d 69 6e 65 20 74 68 65 20 6e ix-read.(obj)..."Determine.the.n
6fde0 65 77 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a ew.value.of.the.infix.object.OBJ
6fe00 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 65 72 65 6c 79 20 64 65 74 65 72 6d 69 6e ...This.function.merely.determin
6fe20 65 73 20 74 68 65 20 76 61 6c 75 65 3b 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 es.the.value;.`transient-infix-s
6fe40 65 74 27 0a 69 73 20 75 73 65 64 20 74 6f 20 61 63 74 75 61 6c 6c 79 20 73 74 6f 72 65 20 74 68 et'.is.used.to.actually.store.th
6fe60 65 20 6e 65 77 20 76 61 6c 75 65 20 69 6e 20 74 68 65 20 6f 62 6a 65 63 74 2e 0a 0a 46 6f 72 20 e.new.value.in.the.object...For.
6fe80 6d 6f 73 74 20 69 6e 66 69 78 20 63 6c 61 73 73 65 73 20 74 68 69 73 20 69 73 20 64 6f 6e 65 20 most.infix.classes.this.is.done.
6fea0 62 79 20 72 65 61 64 69 6e 67 20 61 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 0a 75 73 65 72 by.reading.a.value.from.the.user
6fec0 20 75 73 69 6e 67 20 74 68 65 20 72 65 61 64 65 72 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 .using.the.reader.specified.by.t
6fee0 68 65 20 60 72 65 61 64 65 72 27 20 73 6c 6f 74 20 28 75 73 69 6e 67 20 74 68 65 0a 6d 65 74 68 he.`reader'.slot.(using.the.meth
6ff00 6f 64 20 66 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 27 2c 20 64 65 73 63 72 69 od.for.`transient-infix',.descri
6ff20 62 65 64 20 62 65 6c 6f 77 29 2e 0a 0a 46 6f 72 20 73 6f 6d 65 20 69 6e 66 69 78 20 63 6c 61 73 bed.below)...For.some.infix.clas
6ff40 73 65 73 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 63 68 61 6e 67 65 64 20 77 69 74 68 6f 75 74 ses.the.value.is.changed.without
6ff60 20 72 65 61 64 69 6e 67 0a 61 6e 79 74 68 69 6e 67 20 69 6e 20 74 68 65 20 6d 69 6e 69 62 75 66 .reading.anything.in.the.minibuf
6ff80 66 65 72 2c 20 69 2e 65 2e 2c 20 74 68 65 20 6d 65 72 65 20 61 63 74 20 6f 66 20 69 6e 76 6f 6b fer,.i.e.,.the.mere.act.of.invok
6ffa0 69 6e 67 20 74 68 65 0a 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 64 65 74 65 72 6d 69 6e 65 73 ing.the.infix.command.determines
6ffc0 20 77 68 61 74 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 73 68 6f 75 6c 64 20 62 65 2c 20 62 .what.the.new.value.should.be,.b
6ffe0 61 73 65 64 0a 6f 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 2e 22 29 0a 0a 28 ased.on.the.previous.value.")..(
70000 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 cl-defmethod.transient-infix-rea
70020 64 20 3a 61 72 6f 75 6e 64 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 d.:around.((obj.transient-infix)
70040 29 0a 20 20 22 52 65 66 72 65 73 68 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 )..."Refresh.the.transient.buffe
70060 72 20 61 6e 64 20 63 61 6c 6c 20 74 68 65 20 6e 65 78 74 20 6d 65 74 68 6f 64 2e 0a 0a 41 6c 73 r.and.call.the.next.method...Als
70080 6f 20 77 72 61 70 20 60 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 27 20 77 69 74 o.wrap.`cl-call-next-method'.wit
700a0 68 20 74 77 6f 20 6d 61 63 72 6f 73 3a 0a 2d 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 74 68 h.two.macros:.-.`transient--with
700c0 2d 73 75 73 70 65 6e 64 65 64 2d 6f 76 65 72 72 69 64 65 27 20 61 6c 6c 6f 77 73 20 75 73 65 20 -suspended-override'.allows.use.
700e0 6f 66 20 6d 69 6e 69 62 75 66 66 65 72 2e 0a 2d 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 74 of.minibuffer..-.`transient--wit
70100 68 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 27 20 61 72 72 61 6e 67 65 73 20 66 6f 72 20 74 h-emergency-exit'.arranges.for.t
70120 68 65 20 74 72 61 6e 73 69 65 6e 74 20 74 6f 0a 20 20 62 65 20 65 78 69 74 65 64 20 69 6e 20 63 he.transient.to...be.exited.in.c
70140 61 73 65 20 6f 66 20 61 6e 20 65 72 72 6f 72 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d ase.of.an.error."...(transient--
70160 73 68 6f 77 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 65 6d 65 72 67 65 6e show)...(transient--with-emergen
70180 63 79 2d 65 78 69 74 20 3a 69 6e 66 69 78 2d 72 65 61 64 0a 20 20 20 20 28 74 72 61 6e 73 69 65 cy-exit.:infix-read.....(transie
701a0 6e 74 2d 2d 77 69 74 68 2d 73 75 73 70 65 6e 64 65 64 2d 6f 76 65 72 72 69 64 65 0a 20 20 20 20 nt--with-suspended-override.....
701c0 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 6a 29 29 29 29 0a 0a 28 .(cl-call-next-method.obj))))..(
701e0 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 cl-defmethod.transient-infix-rea
70200 64 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 29 0a 20 20 22 52 65 61 d.((obj.transient-infix))..."Rea
70220 64 20 61 20 76 61 6c 75 65 20 77 68 69 6c 65 20 74 61 6b 69 6e 67 20 63 61 72 65 20 6f 66 20 68 d.a.value.while.taking.care.of.h
70240 69 73 74 6f 72 79 2e 0a 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 73 75 69 74 61 62 6c 65 istory...This.method.is.suitable
70260 20 66 6f 72 20 61 20 77 69 64 65 20 76 61 72 69 65 74 79 20 6f 66 20 69 6e 66 69 78 20 63 6f 6d .for.a.wide.variety.of.infix.com
70280 6d 61 6e 64 73 2c 0a 69 6e 63 6c 75 64 69 6e 67 20 62 75 74 20 6e 6f 74 20 6c 69 6d 69 74 65 64 mands,.including.but.not.limited
702a0 20 74 6f 20 69 6e 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 20 76 61 72 69 61 62 6c .to.inline.arguments.and.variabl
702c0 65 73 2e 0a 0a 49 66 20 79 6f 75 20 64 6f 20 6e 6f 74 20 75 73 65 20 74 68 69 73 20 6d 65 74 68 es...If.you.do.not.use.this.meth
702e0 6f 64 20 66 6f 72 20 79 6f 75 72 20 6f 77 6e 20 69 6e 66 69 78 20 63 6c 61 73 73 2c 20 74 68 65 od.for.your.own.infix.class,.the
70300 6e 0a 79 6f 75 20 73 68 6f 75 6c 64 20 6c 69 6b 65 6c 79 20 72 65 70 6c 69 63 61 74 65 20 61 20 n.you.should.likely.replicate.a.
70320 6c 6f 74 20 6f 66 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 74 68 69 73 0a 6d 65 74 68 lot.of.the.behavior.of.this.meth
70340 6f 64 2e 20 20 49 66 20 79 6f 75 20 66 61 69 6c 20 74 6f 20 64 6f 20 73 6f 2c 20 74 68 65 6e 20 od...If.you.fail.to.do.so,.then.
70360 75 73 65 72 73 20 6d 69 67 68 74 20 6e 6f 74 20 61 70 70 72 65 63 69 61 74 65 0a 74 68 65 20 6c users.might.not.appreciate.the.l
70380 61 63 6b 20 6f 66 20 68 69 73 74 6f 72 79 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2e 0a 0a 4f 6e ack.of.history,.for.example...On
703a0 6c 79 20 66 6f 72 20 76 65 72 79 20 73 69 6d 70 6c 65 20 63 6c 61 73 73 65 73 20 74 68 61 74 20 ly.for.very.simple.classes.that.
703c0 74 6f 67 67 6c 65 20 6f 72 20 63 79 63 6c 65 20 74 68 72 6f 75 67 68 20 61 20 76 65 72 79 0a 6c toggle.or.cycle.through.a.very.l
703e0 69 6d 69 74 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 imited.number.of.possible.values
70400 20 73 68 6f 75 6c 64 20 79 6f 75 20 72 65 70 6c 61 63 65 20 74 68 69 73 20 77 69 74 68 20 61 0a .should.you.replace.this.with.a.
70420 73 69 6d 70 6c 65 20 6d 65 74 68 6f 64 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 68 61 6e 64 simple.method.that.does.not.hand
70440 6c 65 20 68 69 73 74 6f 72 79 2e 20 20 28 45 2e 67 2e 2c 20 66 6f 72 20 61 20 63 6f 6d 6d 61 6e le.history...(E.g.,.for.a.comman
70460 64 0a 6c 69 6e 65 20 73 77 69 74 63 68 20 74 68 65 20 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 d.line.switch.the.only.possible.
70480 76 61 6c 75 65 73 20 61 72 65 20 5c 22 75 73 65 20 69 74 5c 22 20 61 6e 64 20 5c 22 64 6f 6e 27 values.are.\"use.it\".and.\"don'
704a0 74 20 75 73 65 0a 69 74 5c 22 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 69 74 20 69 73 20 t.use.it\",.in.which.case.it.is.
704c0 70 6f 69 6e 74 6c 65 73 73 20 74 6f 20 70 72 65 73 65 72 76 65 20 68 69 73 74 6f 72 79 2e 29 22 pointless.to.preserve.history.)"
704e0 0a 20 20 28 77 69 74 68 2d 73 6c 6f 74 73 20 28 76 61 6c 75 65 20 6d 75 6c 74 69 2d 76 61 6c 75 ...(with-slots.(value.multi-valu
70500 65 20 61 6c 77 61 79 73 2d 72 65 61 64 20 61 6c 6c 6f 77 2d 65 6d 70 74 79 20 63 68 6f 69 63 65 e.always-read.allow-empty.choice
70520 73 29 20 6f 62 6a 0a 20 20 20 20 28 69 66 20 28 61 6e 64 20 76 61 6c 75 65 0a 20 20 20 20 20 20 s).obj.....(if.(and.value.......
70540 20 20 20 20 20 20 20 28 6e 6f 74 20 6d 75 6c 74 69 2d 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 .......(not.multi-value)........
70560 20 20 20 20 20 20 28 6e 6f 74 20 61 6c 77 61 79 73 2d 72 65 61 64 29 0a 20 20 20 20 20 20 20 20 ......(not.always-read).........
70580 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 .....transient--prefix).........
705a0 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 6e 69 6c 29 0a 20 20 20 20 20 20 28 6c 65 74 2a (oset.obj.value.nil).......(let*
705c0 20 28 28 65 6e 61 62 6c 65 2d 72 65 63 75 72 73 69 76 65 2d 6d 69 6e 69 62 75 66 66 65 72 73 20 .((enable-recursive-minibuffers.
705e0 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 61 64 65 72 20 28 6f 72 65 66 20 6f 62 t)..............(reader.(oref.ob
70600 6a 20 72 65 61 64 65 72 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 68 6f 69 63 65 73 j.reader))..............(choices
70620 20 28 69 66 20 28 66 75 6e 63 74 69 6f 6e 70 20 63 68 6f 69 63 65 73 29 20 28 66 75 6e 63 61 6c .(if.(functionp.choices).(funcal
70640 6c 20 63 68 6f 69 63 65 73 29 20 63 68 6f 69 63 65 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 l.choices).choices))............
70660 20 20 28 70 72 6f 6d 70 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 72 6f 6d 70 74 20 6f 62 6a 29 ..(prompt.(transient-prompt.obj)
70680 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 61 6c 75 65 20 28 69 66 20 6d 75 6c 74 69 2d )..............(value.(if.multi-
706a0 76 61 6c 75 65 20 28 73 74 72 69 6e 67 2d 6a 6f 69 6e 20 76 61 6c 75 65 20 22 2c 22 29 20 76 61 value.(string-join.value.",").va
706c0 6c 75 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 68 69 73 74 6f 72 79 2d 6b 65 79 20 lue))..............(history-key.
706e0 28 6f 72 20 28 6f 72 65 66 20 6f 62 6a 20 68 69 73 74 6f 72 79 2d 6b 65 79 29 0a 20 20 20 20 20 (or.(oref.obj.history-key)......
70700 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 6f 72 65 66 20 6f .........................(oref.o
70720 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e bj.command)))..............(tran
70740 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 20 28 61 6c 69 73 74 2d 67 65 74 20 68 69 73 74 6f 72 sient--history.(alist-get.histor
70760 79 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 29 29 0a 20 20 20 20 20 20 y-key.transient-history)).......
70780 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 20 28 69 66 20 28 .......(transient--history.(if.(
707a0 6f 72 20 28 6e 75 6c 6c 20 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 or.(null.value).................
707c0 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 65 71 20 76 61 6c .........................(eq.val
707e0 75 65 20 28 63 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 29 29 29 0a 20 20 ue.(car.transient--history)))...
70800 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 ................................
70820 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 0a 20 20 20 20 20 20 20 20 20 20 ...transient--history...........
70840 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 63 6f 6e 73 20 76 .........................(cons.v
70860 61 6c 75 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 29 29 29 0a 20 20 20 20 20 alue.transient--history)))......
70880 20 20 20 20 20 20 20 20 28 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 28 61 6e 64 20 74 72 61 6e ........(initial-input.(and.tran
708a0 73 69 65 6e 74 2d 72 65 61 64 2d 77 69 74 68 2d 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 0a 20 20 sient-read-with-initial-input...
708c0 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 28 ...............................(
708e0 63 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 29 29 29 0a 20 20 20 20 20 20 car.transient--history))).......
70900 20 20 20 20 20 20 20 28 68 69 73 74 6f 72 79 20 28 69 66 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 .......(history.(if.initial-inpu
70920 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 28 63 6f 6e t...........................(con
70940 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 20 31 29 0a 20 20 20 20 20 20 20 s.'transient--history.1)........
70960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 .................'transient--his
70980 74 6f 72 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 61 6c 75 65 0a 20 20 20 20 20 tory))..............(value......
709a0 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 .........(cond................(r
709c0 65 61 64 65 72 20 28 66 75 6e 63 61 6c 6c 20 72 65 61 64 65 72 20 70 72 6f 6d 70 74 20 69 6e 69 eader.(funcall.reader.prompt.ini
709e0 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 tial-input.history))............
70a00 20 20 20 20 28 6d 75 6c 74 69 2d 76 61 6c 75 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ....(multi-value................
70a20 20 28 63 6f 6d 70 6c 65 74 69 6e 67 2d 72 65 61 64 2d 6d 75 6c 74 69 70 6c 65 20 70 72 6f 6d 70 .(completing-read-multiple.promp
70a40 74 20 63 68 6f 69 63 65 73 20 6e 69 6c 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t.choices.nil.nil...............
70a60 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 69 6e 69 74 ............................init
70a80 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ial-input.history)).............
70aa0 20 20 20 28 63 68 6f 69 63 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6d ...(choices.................(com
70ac0 70 6c 65 74 69 6e 67 2d 72 65 61 64 20 70 72 6f 6d 70 74 20 63 68 6f 69 63 65 73 20 6e 69 6c 20 pleting-read.prompt.choices.nil.
70ae0 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 29 29 0a 20 20 20 20 20 20 t.initial-input.history)).......
70b00 20 20 20 20 20 20 20 20 20 28 28 72 65 61 64 2d 73 74 72 69 6e 67 20 70 72 6f 6d 70 74 20 69 6e .........((read-string.prompt.in
70b20 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 29 29 29 29 29 0a 20 20 20 20 20 20 20 itial-input.history)))))........
70b40 20 28 63 6f 6e 64 20 28 28 61 6e 64 20 28 65 71 75 61 6c 20 76 61 6c 75 65 20 22 22 29 20 28 6e .(cond.((and.(equal.value."").(n
70b60 6f 74 20 61 6c 6c 6f 77 2d 65 6d 70 74 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ot.allow-empty))................
70b80 28 73 65 74 71 20 76 61 6c 75 65 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (setq.value.nil))...............
70ba0 28 28 61 6e 64 20 28 65 71 75 61 6c 20 76 61 6c 75 65 20 22 5c 22 5c 22 22 29 20 61 6c 6c 6f 77 ((and.(equal.value."\"\"").allow
70bc0 2d 65 6d 70 74 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 76 61 6c -empty)................(setq.val
70be0 75 65 20 22 22 29 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 76 61 6c 75 65 0a 20 20 20 ue.""))).........(when.value....
70c00 20 20 20 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 28 62 6f 75 6e 64 2d 61 6e 64 2d 74 72 75 .......(when.(and.(bound-and-tru
70c20 65 2d 70 20 69 76 79 2d 6d 6f 64 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e-p.ivy-mode)...................
70c40 20 20 20 28 73 74 72 69 6e 67 70 20 28 63 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 ...(stringp.(car.transient--hist
70c60 6f 72 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 2d 74 65 78 74 2d 70 72 6f ory))).............(set-text-pro
70c80 70 65 72 74 69 65 73 20 30 20 28 6c 65 6e 67 74 68 20 28 63 61 72 20 74 72 61 6e 73 69 65 6e 74 perties.0.(length.(car.transient
70ca0 2d 2d 68 69 73 74 6f 72 79 29 29 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 --history)).nil.................
70cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 61 72 20 74 72 61 6e 73 69 65 6e 74 2d .................(car.transient-
70ce0 2d 68 69 73 74 6f 72 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 -history)))...........(setf.(ali
70d00 73 74 2d 67 65 74 20 68 69 73 74 6f 72 79 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 st-get.history-key.transient-his
70d20 74 6f 72 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 6c 65 74 65 2d 64 75 tory).................(delete-du
70d40 70 73 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 29 29 29 0a 20 20 20 20 20 20 20 ps.transient--history)))........
70d60 20 76 61 6c 75 65 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 .value))))..(cl-defmethod.transi
70d80 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 ent-infix-read.((obj.transient-s
70da0 77 69 74 63 68 29 29 0a 20 20 22 54 6f 67 67 6c 65 20 74 68 65 20 73 77 69 74 63 68 20 6f 6e 20 witch))..."Toggle.the.switch.on.
70dc0 6f 72 20 6f 66 66 2e 22 0a 20 20 28 69 66 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 6c 75 65 29 20 or.off."...(if.(oref.obj.value).
70de0 6e 69 6c 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 29 29 0a 0a 28 63 6c 2d 64 nil.(oref.obj.argument)))..(cl-d
70e00 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 20 28 28 efmethod.transient-infix-read.((
70e20 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 68 65 73 29 29 0a 20 20 22 43 79 63 6c obj.transient-switches))..."Cycl
70e40 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c 75 73 69 76 65 e.through.the.mutually.exclusive
70e60 20 73 77 69 74 63 68 65 73 2e 0a 54 68 65 20 6c 61 73 74 20 76 61 6c 75 65 20 69 73 20 5c 22 64 .switches..The.last.value.is.\"d
70e80 6f 6e 27 74 20 75 73 65 20 61 6e 79 20 6f 66 20 74 68 65 73 65 20 73 77 69 74 63 68 65 73 5c 22 on't.use.any.of.these.switches\"
70ea0 2e 22 0a 20 20 28 6c 65 74 20 28 28 63 68 6f 69 63 65 73 20 28 6d 61 70 63 61 72 20 28 61 70 70 ."...(let.((choices.(mapcar.(app
70ec0 6c 79 2d 70 61 72 74 69 61 6c 6c 79 20 23 27 66 6f 72 6d 61 74 20 28 6f 72 65 66 20 6f 62 6a 20 ly-partially.#'format.(oref.obj.
70ee0 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 argument-format))...............
70f00 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 63 68 6f 69 63 65 73 29 29 29 29 ...........(oref.obj.choices))))
70f20 0a 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 76 61 6c 75 65 20 28 6f 72 65 66 20 6f 62 6a 20 76 .....(if-let.((value.(oref.obj.v
70f40 61 6c 75 65 29 29 29 0a 20 20 20 20 20 20 20 20 28 63 61 64 72 20 28 6d 65 6d 62 65 72 20 76 61 alue))).........(cadr.(member.va
70f60 6c 75 65 20 63 68 6f 69 63 65 73 29 29 0a 20 20 20 20 20 20 28 63 61 72 20 63 68 6f 69 63 65 73 lue.choices)).......(car.choices
70f80 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e ))))..(cl-defmethod.transient-in
70fa0 66 69 78 2d 72 65 61 64 20 28 28 63 6f 6d 6d 61 6e 64 20 73 79 6d 62 6f 6c 29 29 0a 20 20 22 45 fix-read.((command.symbol))..."E
70fc0 6c 73 65 77 68 65 72 65 20 75 73 65 20 74 68 65 20 72 65 61 64 65 72 20 6f 66 20 74 68 65 20 69 lsewhere.use.the.reader.of.the.i
70fe0 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 43 4f 4d 4d 41 4e 44 2e 0a 55 73 65 20 74 68 69 73 20 69 nfix.command.COMMAND..Use.this.i
71000 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73 68 61 72 65 20 61 6e 20 69 6e 66 69 78 27 73 20 68 f.you.want.to.share.an.infix's.h
71020 69 73 74 6f 72 79 20 77 69 74 68 20 61 20 72 65 67 75 6c 61 72 0a 73 74 61 6e 64 2d 61 6c 6f 6e istory.with.a.regular.stand-alon
71040 65 20 63 6f 6d 6d 61 6e 64 2e 22 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 6f 62 6a 20 28 74 72 61 e.command."...(if-let.((obj.(tra
71060 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 70 72 6f 74 6f 74 79 70 65 20 63 6f 6d 6d 61 6e 64 nsient--suffix-prototype.command
71080 29 29 29 0a 20 20 20 20 20 20 28 63 6c 2d 6c 65 74 66 20 28 28 28 73 79 6d 62 6f 6c 2d 66 75 6e ))).......(cl-letf.(((symbol-fun
710a0 63 74 69 6f 6e 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 29 20 23 27 69 67 6e 6f 72 ction.#'transient--show).#'ignor
710c0 65 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 e)).........(transient-infix-rea
710e0 64 20 6f 62 6a 29 29 0a 20 20 20 20 28 65 72 72 6f 72 20 22 4e 6f 74 20 61 20 73 75 66 66 69 78 d.obj)).....(error."Not.a.suffix
71100 20 63 6f 6d 6d 61 6e 64 3a 20 60 25 73 27 22 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 0a 3b 3b 3b 3b .command:.`%s'".command)))..;;;;
71120 20 52 65 61 64 65 72 73 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d .Readers..(defun.transient-read-
71140 66 69 6c 65 20 28 70 72 6f 6d 70 74 20 5f 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 5f 68 69 73 file.(prompt._initial-input._his
71160 74 6f 72 79 29 0a 20 20 22 52 65 61 64 20 61 20 66 69 6c 65 2e 22 0a 20 20 28 66 69 6c 65 2d 6c tory)..."Read.a.file."...(file-l
71180 6f 63 61 6c 2d 6e 61 6d 65 20 28 65 78 70 61 6e 64 2d 66 69 6c 65 2d 6e 61 6d 65 20 28 72 65 61 ocal-name.(expand-file-name.(rea
711a0 64 2d 66 69 6c 65 2d 6e 61 6d 65 20 70 72 6f 6d 70 74 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 d-file-name.prompt))))..(defun.t
711c0 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 65 78 69 73 74 69 6e 67 2d 66 69 6c 65 20 28 70 72 6f ransient-read-existing-file.(pro
711e0 6d 70 74 20 5f 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 5f 68 69 73 74 6f 72 79 29 0a 20 20 22 mpt._initial-input._history)..."
71200 52 65 61 64 20 61 6e 20 65 78 69 73 74 69 6e 67 20 66 69 6c 65 2e 22 0a 20 20 28 66 69 6c 65 2d Read.an.existing.file."...(file-
71220 6c 6f 63 61 6c 2d 6e 61 6d 65 20 28 65 78 70 61 6e 64 2d 66 69 6c 65 2d 6e 61 6d 65 20 28 72 65 local-name.(expand-file-name.(re
71240 61 64 2d 66 69 6c 65 2d 6e 61 6d 65 20 70 72 6f 6d 70 74 20 6e 69 6c 20 6e 69 6c 20 74 29 29 29 ad-file-name.prompt.nil.nil.t)))
71260 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 64 69 72 65 63 74 6f )..(defun.transient-read-directo
71280 72 79 20 28 70 72 6f 6d 70 74 20 5f 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 5f 68 69 73 74 6f ry.(prompt._initial-input._histo
712a0 72 79 29 0a 20 20 22 52 65 61 64 20 61 20 64 69 72 65 63 74 6f 72 79 2e 22 0a 20 20 28 66 69 6c ry)..."Read.a.directory."...(fil
712c0 65 2d 6c 6f 63 61 6c 2d 6e 61 6d 65 20 28 65 78 70 61 6e 64 2d 66 69 6c 65 2d 6e 61 6d 65 20 28 e-local-name.(expand-file-name.(
712e0 72 65 61 64 2d 64 69 72 65 63 74 6f 72 79 2d 6e 61 6d 65 20 70 72 6f 6d 70 74 29 29 29 29 0a 0a read-directory-name.prompt))))..
71300 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 65 78 69 73 74 69 6e 67 2d 64 (defun.transient-read-existing-d
71320 69 72 65 63 74 6f 72 79 20 28 70 72 6f 6d 70 74 20 5f 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 irectory.(prompt._initial-input.
71340 5f 68 69 73 74 6f 72 79 29 0a 20 20 22 52 65 61 64 20 61 6e 20 65 78 69 73 74 69 6e 67 20 64 69 _history)..."Read.an.existing.di
71360 72 65 63 74 6f 72 79 2e 22 0a 20 20 28 66 69 6c 65 2d 6c 6f 63 61 6c 2d 6e 61 6d 65 20 28 65 78 rectory."...(file-local-name.(ex
71380 70 61 6e 64 2d 66 69 6c 65 2d 6e 61 6d 65 20 28 72 65 61 64 2d 64 69 72 65 63 74 6f 72 79 2d 6e pand-file-name.(read-directory-n
713a0 61 6d 65 20 70 72 6f 6d 70 74 20 6e 69 6c 20 6e 69 6c 20 74 29 29 29 29 0a 0a 28 64 65 66 75 6e ame.prompt.nil.nil.t))))..(defun
713c0 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d 4e 30 20 28 70 72 6f 6d 70 .transient-read-number-N0.(promp
713e0 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 29 0a 20 20 22 52 65 61 64 t.initial-input.history)..."Read
71400 20 61 20 6e 61 74 75 72 61 6c 20 6e 75 6d 62 65 72 20 28 69 6e 63 6c 75 64 69 6e 67 20 7a 65 72 .a.natural.number.(including.zer
71420 6f 29 20 61 6e 64 20 72 65 74 75 72 6e 20 69 74 20 61 73 20 61 20 73 74 72 69 6e 67 2e 22 0a 20 o).and.return.it.as.a.string."..
71440 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d 4e 20 70 72 6f 6d 70 .(transient--read-number-N.promp
71460 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 20 74 29 29 0a 0a 28 64 65 t.initial-input.history.t))..(de
71480 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d 4e 2b 20 28 70 72 fun.transient-read-number-N+.(pr
714a0 6f 6d 70 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 29 0a 20 20 22 52 ompt.initial-input.history)..."R
714c0 65 61 64 20 61 20 6e 61 74 75 72 61 6c 20 6e 75 6d 62 65 72 20 28 65 78 63 6c 75 64 69 6e 67 20 ead.a.natural.number.(excluding.
714e0 7a 65 72 6f 29 20 61 6e 64 20 72 65 74 75 72 6e 20 69 74 20 61 73 20 61 20 73 74 72 69 6e 67 2e zero).and.return.it.as.a.string.
71500 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d 4e 20 70 72 "...(transient--read-number-N.pr
71520 6f 6d 70 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 20 6e 69 6c 29 29 ompt.initial-input.history.nil))
71540 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d ..(defun.transient--read-number-
71560 4e 20 28 70 72 6f 6d 70 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 68 69 73 74 6f 72 79 20 N.(prompt.initial-input.history.
71580 69 6e 63 6c 75 64 65 2d 7a 65 72 6f 29 0a 20 20 28 73 61 76 65 2d 6d 61 74 63 68 2d 64 61 74 61 include-zero)...(save-match-data
715a0 0a 20 20 20 20 28 63 6c 2d 62 6c 6f 63 6b 20 6e 69 6c 0a 20 20 20 20 20 20 28 77 68 69 6c 65 20 .....(cl-block.nil.......(while.
715c0 74 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 73 74 72 20 28 72 65 61 64 2d 66 72 6f 6d 2d t.........(let.((str.(read-from-
715e0 6d 69 6e 69 62 75 66 66 65 72 20 70 72 6f 6d 70 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 20 minibuffer.prompt.initial-input.
71600 6e 69 6c 20 6e 69 6c 20 68 69 73 74 6f 72 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 77 68 nil.nil.history)))...........(wh
71620 65 6e 20 28 6f 72 20 28 73 74 72 69 6e 67 2d 65 71 75 61 6c 20 73 74 72 20 22 22 29 0a 20 20 20 en.(or.(string-equal.str."")....
71640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 2d 70 .................(string-match-p
71660 20 28 69 66 20 69 6e 63 6c 75 64 65 2d 7a 65 72 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .(if.include-zero...............
71680 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 22 5c 5c 60 5c 5c .........................."\\`\\
716a0 28 30 5c 5c 7c 5b 31 2d 39 5d 5b 30 2d 39 5d 2a 5c 5c 29 5c 5c 27 22 0a 20 20 20 20 20 20 20 20 (0\\|[1-9][0-9]*\\)\\'".........
716c0 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 22 5c .............................."\
716e0 5c 60 5b 31 2d 39 5d 5b 30 2d 39 5d 2a 5c 5c 27 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 \`[1-9][0-9]*\\'")..............
71700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 74 72 29 29 0a 20 20 20 .......................str))....
71720 20 20 20 20 20 20 20 20 20 28 63 6c 2d 72 65 74 75 72 6e 20 73 74 72 29 29 29 0a 20 20 20 20 20 .........(cl-return.str)))......
71740 20 20 20 28 6d 65 73 73 61 67 65 20 22 50 6c 65 61 73 65 20 65 6e 74 65 72 20 61 20 6e 61 74 75 ...(message."Please.enter.a.natu
71760 72 61 6c 20 6e 75 6d 62 65 72 20 28 25 73 20 7a 65 72 6f 29 2e 22 0a 20 20 20 20 20 20 20 20 20 ral.number.(%s.zero)."..........
71780 20 20 20 20 20 20 20 20 28 69 66 20 69 6e 63 6c 75 64 65 2d 7a 65 72 6f 20 22 69 6e 63 6c 75 64 ........(if.include-zero."includ
717a0 69 6e 67 22 20 22 65 78 63 6c 75 64 69 6e 67 22 29 29 0a 20 20 20 20 20 20 20 20 28 73 69 74 2d ing"."excluding")).........(sit-
717c0 66 6f 72 20 31 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 for.1)))))..(defun.transient-rea
717e0 64 2d 64 61 74 65 20 28 70 72 6f 6d 70 74 20 64 65 66 61 75 6c 74 2d 74 69 6d 65 20 5f 68 69 73 d-date.(prompt.default-time._his
71800 74 6f 72 79 29 0a 20 20 22 52 65 61 64 20 61 20 64 61 74 65 20 75 73 69 6e 67 20 60 6f 72 67 2d tory)..."Read.a.date.using.`org-
71820 72 65 61 64 2d 64 61 74 65 27 20 28 77 68 69 63 68 20 73 65 65 29 2e 22 0a 20 20 28 72 65 71 75 read-date'.(which.see)."...(requ
71840 69 72 65 20 27 6f 72 67 29 0a 20 20 28 77 68 65 6e 20 28 66 62 6f 75 6e 64 70 20 27 6f 72 67 2d ire.'org)...(when.(fboundp.'org-
71860 72 65 61 64 2d 64 61 74 65 29 0a 20 20 20 20 28 6f 72 67 2d 72 65 61 64 2d 64 61 74 65 20 27 77 read-date).....(org-read-date.'w
71880 69 74 68 2d 74 69 6d 65 20 6e 69 6c 20 6e 69 6c 20 70 72 6f 6d 70 74 20 64 65 66 61 75 6c 74 2d ith-time.nil.nil.prompt.default-
718a0 74 69 6d 65 29 29 29 0a 0a 3b 3b 3b 3b 20 50 72 6f 6d 70 74 0a 0a 28 63 6c 2d 64 65 66 67 65 6e time)))..;;;;.Prompt..(cl-defgen
718c0 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 6f 6d 70 74 20 28 6f 62 6a 29 0a 20 20 22 52 eric.transient-prompt.(obj)..."R
718e0 65 74 75 72 6e 20 74 68 65 20 70 72 6f 6d 70 74 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 eturn.the.prompt.to.be.used.to.r
71900 65 61 64 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a 27 73 20 76 61 6c 75 65 2e 22 29 0a ead.infix.object.OBJ's.value.").
71920 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 6f 6d 70 74 20 .(cl-defmethod.transient-prompt.
71940 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 29 0a 20 20 22 52 65 74 75 72 ((obj.transient-infix))..."Retur
71960 6e 20 74 68 65 20 70 72 6f 6d 70 74 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 n.the.prompt.to.be.used.to.read.
71980 69 6e 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a 27 73 20 76 61 6c 75 65 2e 0a 0a 54 68 69 73 20 infix.object.OBJ's.value...This.
719a0 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 73 75 69 74 61 62 6c implementation.should.be.suitabl
719c0 65 20 66 6f 72 20 61 6c 6d 6f 73 74 20 61 6c 6c 20 69 6e 66 69 78 0a 63 6f 6d 6d 61 6e 64 73 2e e.for.almost.all.infix.commands.
719e0 0a 0a 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4f 42 4a 27 73 20 60 70 72 6f 6d 70 74 27 ..If.the.value.of.OBJ's.`prompt'
71a00 20 73 6c 6f 74 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 68 65 6e 20 69 74 20 6d 75 73 74 20 62 .slot.is.non-nil,.then.it.must.b
71a20 65 0a 61 20 73 74 72 69 6e 67 20 6f 72 20 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 66 20 69 74 e.a.string.or.a.function...If.it
71a40 20 69 73 20 61 20 73 74 72 69 6e 67 2c 20 74 68 65 6e 20 75 73 65 20 74 68 61 74 2e 20 20 49 66 .is.a.string,.then.use.that...If
71a60 0a 69 74 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 74 68 65 6e 20 63 61 6c 6c 20 74 68 61 .it.is.a.function,.then.call.tha
71a80 74 20 77 69 74 68 20 4f 42 4a 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 2e t.with.OBJ.as.the.only.argument.
71aa0 0a 54 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 72 65 74 75 72 6e 20 61 20 73 74 72 .That.function.must.return.a.str
71ac0 69 6e 67 2c 20 77 68 69 63 68 20 69 73 20 74 68 65 6e 20 75 73 65 64 20 61 73 20 74 68 65 0a 70 ing,.which.is.then.used.as.the.p
71ae0 72 6f 6d 70 74 2e 0a 0a 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 68 65 20 76 61 6c 75 65 20 rompt...Otherwise,.if.the.value.
71b00 6f 66 20 65 69 74 68 65 72 20 74 68 65 20 60 61 72 67 75 6d 65 6e 74 27 20 6f 72 20 60 76 61 72 of.either.the.`argument'.or.`var
71b20 69 61 62 6c 65 27 0a 73 6c 6f 74 20 6f 66 20 4f 42 4a 20 69 73 20 61 20 73 74 72 69 6e 67 2c 20 iable'.slot.of.OBJ.is.a.string,.
71b40 74 68 65 6e 20 62 61 73 65 20 74 68 65 20 70 72 6f 6d 70 74 20 6f 6e 20 74 68 61 74 20 28 70 72 then.base.the.prompt.on.that.(pr
71b60 65 66 65 72 72 69 6e 67 0a 74 68 65 20 66 6f 72 6d 65 72 29 2c 20 61 70 70 65 6e 64 69 6e 67 20 eferring.the.former),.appending.
71b80 65 69 74 68 65 72 20 5c 22 3d 5c 22 20 28 69 66 20 69 74 20 61 70 70 65 61 72 73 20 74 6f 20 62 either.\"=\".(if.it.appears.to.b
71ba0 65 20 61 0a 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 29 20 6f 72 20 5c 22 3a 20 e.a.command-line.option).or.\":.
71bc0 5c 22 2e 0a 0a 46 69 6e 61 6c 6c 79 20 66 61 6c 6c 20 74 68 72 6f 75 67 68 20 74 6f 20 75 73 69 \"...Finally.fall.through.to.usi
71be0 6e 67 20 5c 22 28 42 55 47 3a 20 6e 6f 20 70 72 6f 6d 70 74 29 3a 20 5c 22 20 61 73 20 74 68 65 ng.\"(BUG:.no.prompt):.\".as.the
71c00 0a 70 72 6f 6d 70 74 2e 22 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 70 72 6f 6d 70 74 20 28 6f 72 .prompt."...(if-let.((prompt.(or
71c20 65 66 20 6f 62 6a 20 70 72 6f 6d 70 74 29 29 29 0a 20 20 20 20 20 20 28 6c 65 74 20 28 28 70 72 ef.obj.prompt))).......(let.((pr
71c40 6f 6d 70 74 20 28 69 66 20 28 66 75 6e 63 74 69 6f 6e 70 20 70 72 6f 6d 70 74 29 0a 20 20 20 20 ompt.(if.(functionp.prompt).....
71c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 70 72 6f ....................(funcall.pro
71c80 6d 70 74 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 mpt.obj).......................p
71ca0 72 6f 6d 70 74 29 29 29 0a 20 20 20 20 20 20 20 20 28 69 66 20 28 73 74 72 69 6e 67 70 20 70 72 rompt))).........(if.(stringp.pr
71cc0 6f 6d 70 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 6d 70 74 0a 20 20 20 20 20 20 20 ompt).............prompt........
71ce0 20 20 20 22 5b 42 55 47 3a 20 69 6e 76 61 6c 69 64 20 70 72 6f 6d 70 74 5d 3a 20 22 29 29 0a 20 ..."[BUG:.invalid.prompt]:."))..
71d00 20 20 20 28 69 66 2d 6c 65 74 2a 20 28 28 6e 61 6d 65 20 28 6f 72 20 28 61 6e 64 20 28 73 6c 6f ...(if-let*.((name.(or.(and.(slo
71d20 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 61 72 67 75 6d 65 6e 74 29 20 28 6f 72 65 66 20 6f 62 t-boundp.obj.'argument).(oref.ob
71d40 6a 20 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 j.argument))....................
71d60 20 20 20 20 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 76 61 72 69 .....(and.(slot-boundp.obj.'vari
71d80 61 62 6c 65 29 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 72 69 61 62 6c 65 29 29 29 29 29 0a 20 20 able).(oref.obj.variable)))))...
71da0 20 20 20 20 20 20 28 69 66 20 28 61 6e 64 20 28 73 74 72 69 6e 67 70 20 6e 61 6d 65 29 0a 20 20 ......(if.(and.(stringp.name)...
71dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 74 72 69 6e 67 2d 73 75 66 66 69 78 2d 70 20 ...............(string-suffix-p.
71de0 22 3d 22 20 6e 61 6d 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 6d 65 0a 20 20 20 20 "=".name)).............name.....
71e00 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 25 73 3a 20 22 20 6e 61 6d 65 29 29 0a 20 20 20 20 ......(format."%s:.".name)).....
71e20 20 20 22 5b 42 55 47 3a 20 6e 6f 20 70 72 6f 6d 70 74 5d 3a 20 22 29 29 29 0a 0a 3b 3b 3b 3b 20 .."[BUG:.no.prompt]:.")))..;;;;.
71e40 53 65 74 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e Set..(cl-defgeneric.transient-in
71e60 66 69 78 2d 73 65 74 20 28 6f 62 6a 20 76 61 6c 75 65 29 0a 20 20 22 53 65 74 20 74 68 65 20 76 fix-set.(obj.value)..."Set.the.v
71e80 61 6c 75 65 20 6f 66 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a 20 74 6f 20 56 41 4c 55 alue.of.infix.object.OBJ.to.VALU
71ea0 45 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e E.")..(cl-defmethod.transient-in
71ec0 66 69 78 2d 73 65 74 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 20 76 fix-set.((obj.transient-infix).v
71ee0 61 6c 75 65 29 0a 20 20 22 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 69 6e 66 69 78 20 alue)..."Set.the.value.of.infix.
71f00 6f 62 6a 65 63 74 20 4f 42 4a 20 74 6f 20 56 41 4c 55 45 2e 22 0a 20 20 28 6f 73 65 74 20 6f 62 object.OBJ.to.VALUE."...(oset.ob
71f20 6a 20 76 61 6c 75 65 20 76 61 6c 75 65 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 j.value.value))..(cl-defmethod.t
71f40 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 3a 61 66 74 65 72 20 28 28 6f 62 6a 20 ransient-infix-set.:after.((obj.
71f60 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 20 76 61 6c 75 65 29 0a 20 20 22 55 6e transient-argument).value)..."Un
71f80 73 65 74 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 set.incompatible.infix.arguments
71fa0 2e 22 0a 20 20 28 77 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 20 76 61 6c 75 65 29 0a 20 20 20 20 20 ."...(when-let*.((_.value)......
71fc0 20 20 20 20 20 20 20 20 20 28 76 61 6c 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 .........(val.(transient-infix-v
71fe0 61 6c 75 65 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 72 67 20 28 69 alue.obj))...............(arg.(i
72000 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 61 72 67 75 6d 65 6e 74 29 0a 20 20 f.(slot-boundp.obj.'argument)...
72020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 61 .....................(oref.obj.a
72040 72 67 75 6d 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f rgument)......................(o
72060 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 29 29 29 0a 20 20 20 20 20 ref.obj.argument-format)))......
72080 20 20 20 20 20 20 20 20 20 28 73 70 65 63 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d .........(spec.(oref.transient--
720a0 70 72 65 66 69 78 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 prefix.incompatible))...........
720c0 20 20 20 20 28 66 69 6c 74 65 72 20 28 6c 61 6d 62 64 61 20 28 78 20 72 75 6c 65 29 0a 20 20 20 ....(filter.(lambda.(x.rule)....
720e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6d 65 6d 62 65 .....................(and.(membe
72100 72 20 78 20 72 75 6c 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r.x.rule).......................
72120 20 20 20 20 20 20 20 28 72 65 6d 6f 76 65 20 78 20 72 75 6c 65 29 29 29 29 0a 20 20 20 20 20 20 .......(remove.x.rule)))).......
72140 20 20 20 20 20 20 20 20 28 69 6e 63 6f 6d 70 20 28 6e 63 6f 6e 63 0a 20 20 20 20 20 20 20 20 20 ........(incomp.(nconc..........
72160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 6e 20 28 61 70 70 6c 79 2d 70 61 72 ..............(mapcan.(apply-par
72180 74 69 61 6c 6c 79 20 66 69 6c 74 65 72 20 61 72 67 29 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 tially.filter.arg).spec)........
721a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 65 71 75 61 6c ................(and.(not.(equal
721c0 20 76 61 6c 20 61 72 67 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .val.arg))......................
721e0 20 20 20 20 20 20 20 28 6d 61 70 63 61 6e 20 28 61 70 70 6c 79 2d 70 61 72 74 69 61 6c 6c 79 20 .......(mapcan.(apply-partially.
72200 66 69 6c 74 65 72 20 76 61 6c 29 20 73 70 65 63 29 29 29 29 29 0a 20 20 20 20 28 64 6f 6c 69 73 filter.val).spec))))).....(dolis
72220 74 20 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 0a 20 20 20 20 t.(obj.transient--suffixes).....
72240 20 20 28 77 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 28 63 6c 2d 74 79 70 65 70 20 6f 62 6a 20 27 74 ..(when-let*.((_(cl-typep.obj.'t
72260 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ransient-argument)).............
72280 20 20 20 20 20 20 28 76 61 6c 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 ......(val.(transient-infix-valu
722a0 65 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 72 67 20 28 e.obj))...................(arg.(
722c0 69 66 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 61 72 67 75 6d 65 6e 74 29 0a 20 if.(slot-boundp.obj.'argument)..
722e0 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 6f 72 65 66 20 ..........................(oref.
72300 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 obj.argument)...................
72320 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 .......(oref.obj.argument-format
72340 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 69 66 20 28 65 71 75 )))...................(_(if.(equ
72360 61 6c 20 76 61 6c 20 61 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 al.val.arg).....................
72380 20 20 20 20 28 6d 65 6d 62 65 72 20 61 72 67 20 69 6e 63 6f 6d 70 29 0a 20 20 20 20 20 20 20 20 ....(member.arg.incomp).........
723a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6d 65 6d 62 65 72 20 76 61 6c 20 69 6e ..............(or.(member.val.in
723c0 63 6f 6d 70 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 comp)...........................
723e0 28 6d 65 6d 62 65 72 20 61 72 67 20 69 6e 63 6f 6d 70 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 (member.arg.incomp))))).........
72400 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 6f 62 6a 20 6e 69 6c 29 29 29 29 (transient-infix-set.obj.nil))))
72420 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 73 65 74 20 28 )..(defun.transient-prefix-set.(
72440 76 61 6c 75 65 29 0a 20 20 22 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 value)..."Set.the.value.of.the.a
72460 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 74 6f 20 56 41 4c 55 45 2e ctive.transient.prefix.to.VALUE.
72480 0a 49 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 62 79 20 74 72 61 6e 73 69 65 6e 74 20 73 .Intended.for.use.by.transient.s
724a0 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 22 0a 20 20 28 6f 73 65 74 20 74 72 61 6e 73 69 65 uffix.commands."...(oset.transie
724c0 6e 74 2d 2d 70 72 65 66 69 78 20 76 61 6c 75 65 20 76 61 6c 75 65 29 0a 20 20 28 73 65 74 71 20 nt--prefix.value.value)...(setq.
724e0 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 66 72 65 73 68 70 20 27 75 70 64 61 74 65 64 2d 76 61 6c transient--refreshp.'updated-val
72500 75 65 29 29 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 73 ue))..(cl-defgeneric.transient-s
72520 65 74 2d 76 61 6c 75 65 20 28 6f 62 6a 29 0a 20 20 22 50 65 72 73 69 73 74 20 74 68 65 20 76 61 et-value.(obj)..."Persist.the.va
72540 6c 75 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 4f 42 4a 2e lue.of.the.transient.prefix.OBJ.
72560 0a 4f 6e 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 62 79 20 60 74 72 61 6e 73 .Only.intended.for.use.by.`trans
72580 69 65 6e 74 2d 73 65 74 27 2e 0a 53 65 65 20 61 6c 73 6f 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 ient-set'..See.also.`transient-p
725a0 72 65 66 69 78 2d 73 65 74 27 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 refix-set'.")..(cl-defmethod.tra
725c0 6e 73 69 65 6e 74 2d 73 65 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 nsient-set-value.((obj.transient
725e0 2d 70 72 65 66 69 78 29 29 0a 20 20 28 6c 65 74 20 28 28 76 61 6c 75 65 20 28 74 72 61 6e 73 69 -prefix))...(let.((value.(transi
72600 65 6e 74 2d 2d 67 65 74 2d 73 61 76 61 62 6c 65 2d 76 61 6c 75 65 29 29 29 0a 20 20 20 20 28 6f ent--get-savable-value))).....(o
72620 73 65 74 20 28 6f 72 65 66 20 6f 62 6a 20 70 72 6f 74 6f 74 79 70 65 29 20 76 61 6c 75 65 20 76 set.(oref.obj.prototype).value.v
72640 61 6c 75 65 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 70 75 alue).....(transient--history-pu
72660 73 68 20 6f 62 6a 20 76 61 6c 75 65 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e sh.obj.value)))..(defun.transien
72680 74 2d 2d 6d 61 79 62 65 2d 73 65 74 2d 76 61 6c 75 65 20 28 65 76 65 6e 74 29 0a 20 20 22 4d 61 t--maybe-set-value.(event)..."Ma
726a0 79 62 65 20 73 65 74 20 74 68 65 20 76 61 6c 75 65 2c 20 73 75 62 6a 65 63 74 20 74 6f 20 45 56 ybe.set.the.value,.subject.to.EV
726c0 45 4e 54 20 61 6e 64 20 74 68 65 20 60 72 65 6d 65 6d 62 65 72 2d 76 61 6c 75 65 27 20 73 6c 6f ENT.and.the.`remember-value'.slo
726e0 74 2e 22 0a 20 20 28 6c 65 74 2a 20 28 28 65 76 65 6e 74 20 28 69 66 20 28 61 6e 64 20 28 65 71 t."...(let*.((event.(if.(and.(eq
72700 20 65 76 65 6e 74 20 27 65 78 69 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .event.'exit)...................
72720 20 20 20 20 20 20 20 28 6d 65 6d 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 74 72 61 6e 73 69 .......(memq.this-command.transi
72740 65 6e 74 2d 2d 71 75 69 74 2d 63 6f 6d 6d 61 6e 64 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 ent--quit-commands))............
72760 20 20 20 20 20 20 20 20 20 27 71 75 69 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .........'quit..................
72780 20 65 76 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 28 73 70 65 63 20 28 6f 72 65 66 20 74 72 .event))..........(spec.(oref.tr
727a0 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 72 65 6d 65 6d 62 65 72 2d 76 61 6c 75 65 29 29 ansient--prefix.remember-value))
727c0 0a 20 20 20 20 20 20 20 20 20 28 73 70 65 63 20 28 63 6f 6e 64 20 28 28 6c 69 73 74 70 20 73 70 ..........(spec.(cond.((listp.sp
727e0 65 63 29 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 ec).spec)......................(
72800 28 6d 65 6d 71 20 73 70 65 63 20 27 28 65 78 70 6f 72 74 20 65 78 69 74 20 71 75 69 74 29 29 0a (memq.spec.'(export.exit.quit)).
72820 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 73 74 20 73 70 65 63 ......................(list.spec
72840 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 62 6f 75 6e 64 70 ))......................((boundp
72860 20 73 70 65 63 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 73 79 .spec).......................(sy
72880 6d 62 6f 6c 2d 76 61 6c 75 65 20 73 70 65 63 29 29 29 29 29 0a 20 20 20 20 28 61 6e 64 20 28 6d mbol-value.spec))))).....(and.(m
728a0 65 6d 71 20 65 76 65 6e 74 20 73 70 65 63 29 0a 20 20 20 20 20 20 20 20 20 28 70 72 6f 67 31 20 emq.event.spec)..........(prog1.
728c0 74 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 6d 65 6d 71 20 27 73 61 76 65 20 73 70 65 t............(if.(memq.'save.spe
728e0 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 c)................(transient-sav
72900 65 2d 76 61 6c 75 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 e-value.transient--prefix)......
72920 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 76 61 6c 75 65 20 74 72 61 ........(transient-set-value.tra
72940 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 29 29 29 29 29 0a 0a 3b 3b 3b 3b 20 53 61 76 65 0a nsient--prefix))))))..;;;;.Save.
72960 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 76 .(cl-defgeneric.transient-save-v
72980 61 6c 75 65 20 28 6f 62 6a 29 0a 20 20 22 53 61 76 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 alue.(obj)..."Save.the.value.of.
729a0 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 4f 42 4a 2e 22 29 0a 0a 28 63 6c the.transient.prefix.OBJ.")..(cl
729c0 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 76 61 6c 75 65 20 -defmethod.transient-save-value.
729e0 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 29 29 0a 20 20 28 6c 65 74 20 ((obj.transient-prefix))...(let.
72a00 28 28 76 61 6c 75 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 73 61 76 61 62 6c 65 2d ((value.(transient--get-savable-
72a20 76 61 6c 75 65 29 29 29 0a 20 20 20 20 28 6f 73 65 74 20 28 6f 72 65 66 20 6f 62 6a 20 70 72 6f value))).....(oset.(oref.obj.pro
72a40 74 6f 74 79 70 65 29 20 76 61 6c 75 65 20 76 61 6c 75 65 29 0a 20 20 20 20 28 73 65 74 66 20 28 totype).value.value).....(setf.(
72a60 61 6c 69 73 74 2d 67 65 74 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 20 74 72 61 alist-get.(oref.obj.command).tra
72a80 6e 73 69 65 6e 74 2d 76 61 6c 75 65 73 29 20 76 61 6c 75 65 29 0a 20 20 20 20 28 74 72 61 6e 73 nsient-values).value).....(trans
72aa0 69 65 6e 74 2d 73 61 76 65 2d 76 61 6c 75 65 73 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 ient-save-values).....(transient
72ac0 2d 2d 68 69 73 74 6f 72 79 2d 70 75 73 68 20 6f 62 6a 20 76 61 6c 75 65 29 29 29 0a 0a 3b 3b 3b --history-push.obj.value)))..;;;
72ae0 3b 20 52 65 73 65 74 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e ;.Reset..(cl-defgeneric.transien
72b00 74 2d 72 65 73 65 74 2d 76 61 6c 75 65 20 28 6f 62 6a 29 0a 20 20 22 43 6c 65 61 72 20 74 68 65 t-reset-value.(obj)..."Clear.the
72b20 20 73 65 74 20 61 6e 64 20 73 61 76 65 64 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 74 72 61 .set.and.saved.values.of.the.tra
72b40 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 4f 42 4a 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 nsient.prefix.OBJ.")..(cl-defmet
72b60 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 65 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 hod.transient-reset-value.((obj.
72b80 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 29 29 0a 20 20 28 6c 65 74 20 28 28 76 61 6c 75 transient-prefix))...(let.((valu
72ba0 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 61 75 6c 74 2d 76 61 6c 75 65 20 6f 62 6a 29 29 e.(transient-default-value.obj))
72bc0 29 0a 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 76 61 6c 75 65 29 0a 20 20 20 ).....(oset.obj.value.value)....
72be0 20 28 6f 73 65 74 20 28 6f 72 65 66 20 6f 62 6a 20 70 72 6f 74 6f 74 79 70 65 29 20 76 61 6c 75 .(oset.(oref.obj.prototype).valu
72c00 65 20 76 61 6c 75 65 29 0a 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 28 6f e.value).....(setf.(alist-get.(o
72c20 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 ref.obj.command).transient-value
72c40 73 20 6e 69 6c 20 27 72 65 6d 6f 76 65 29 20 6e 69 6c 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 s.nil.'remove).nil).....(transie
72c60 6e 74 2d 73 61 76 65 2d 76 61 6c 75 65 73 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d nt-save-values).....(transient--
72c80 68 69 73 74 6f 72 79 2d 70 75 73 68 20 6f 62 6a 20 76 61 6c 75 65 29 29 0a 20 20 28 6d 61 70 63 history-push.obj.value))...(mapc
72ca0 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 20 74 72 61 6e 73 69 65 6e .#'transient-init-value.transien
72cc0 74 2d 2d 73 75 66 66 69 78 65 73 29 29 0a 0a 3b 3b 3b 3b 20 47 65 74 0a 0a 28 64 65 66 75 6e 20 t--suffixes))..;;;;.Get..(defun.
72ce0 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 20 28 70 72 65 66 69 78 29 0a 20 20 22 52 65 74 75 72 transient-args.(prefix)..."Retur
72d00 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 n.the.value.of.the.transient.pre
72d20 66 69 78 20 63 6f 6d 6d 61 6e 64 20 50 52 45 46 49 58 2e 0a 0a 49 66 20 74 68 65 20 63 75 72 72 fix.command.PREFIX...If.the.curr
72d40 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 74 68 65 ent.command.was.invoked.from.the
72d60 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 50 52 45 46 49 58 .transient.prefix.command.PREFIX
72d80 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68 65 20 61 63 74 69 76 65 20 69 6e 66 69 78 20 61 ,.then.return.the.active.infix.a
72da0 72 67 75 6d 65 6e 74 73 2e 20 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e rguments...If.the.current.comman
72dc0 64 0a 77 61 73 20 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 50 52 45 46 49 58 2c 20 74 d.was.not.invoked.from.PREFIX,.t
72de0 68 65 6e 20 72 65 74 75 72 6e 20 74 68 65 20 73 65 74 2c 20 73 61 76 65 64 20 6f 72 20 64 65 66 hen.return.the.set,.saved.or.def
72e00 61 75 6c 74 20 76 61 6c 75 65 0a 66 6f 72 20 50 52 45 46 49 58 2e 0a 0a 50 52 45 46 49 58 20 6d ault.value.for.PREFIX...PREFIX.m
72e20 61 79 20 61 6c 73 6f 20 62 65 20 61 20 6c 69 73 74 20 6f 66 20 70 72 65 66 69 78 65 73 2e 20 20 ay.also.be.a.list.of.prefixes...
72e40 49 66 20 6e 6f 20 70 72 65 66 69 78 20 69 73 20 61 63 74 69 76 65 2c 20 74 68 65 0a 66 61 6c 6c If.no.prefix.is.active,.the.fall
72e60 62 61 63 6b 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 66 20 74 68 65 73 65 back.value.of.the.first.of.these
72e80 20 70 72 65 66 69 78 65 73 20 69 73 20 75 73 65 64 2e 0a 0a 54 68 65 20 67 65 6e 65 72 69 63 20 .prefixes.is.used...The.generic.
72ea0 66 75 6e 63 74 69 6f 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 65 function.`transient-prefix-value
72ec0 27 20 69 73 20 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 0a 72 65 74 75 72 '.is.used.to.determine.the.retur
72ee0 6e 65 64 20 76 61 6c 75 65 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 ned.value...This.function.is.int
72f00 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 62 79 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 ended.to.be.used.by.suffix.comma
72f20 6e 64 73 2c 20 77 68 65 74 68 65 72 20 74 68 65 79 0a 61 72 65 20 69 6e 76 6f 6b 65 64 20 66 72 nds,.whether.they.are.invoked.fr
72f40 6f 6d 20 61 20 6d 65 6e 75 20 6f 72 20 6e 6f 74 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 69 6e 74 om.a.menu.or.not...It.is.not.int
72f60 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 77 68 65 6e 0a 73 65 74 74 69 6e 67 20 75 70 ended.to.be.used.when.setting.up
72f80 20 61 20 6d 65 6e 75 20 61 6e 64 20 69 74 73 20 73 75 66 66 69 78 65 73 2c 20 69 6e 20 77 68 69 .a.menu.and.its.suffixes,.in.whi
72fa0 63 68 20 63 61 73 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 27 0a 73 68 ch.case.`transient-get-value'.sh
72fc0 6f 75 6c 64 20 62 65 20 75 73 65 64 2e 22 0a 20 20 28 77 68 65 6e 20 28 6c 69 73 74 70 20 70 72 ould.be.used."...(when.(listp.pr
72fe0 65 66 69 78 29 0a 20 20 20 20 28 73 65 74 71 20 70 72 65 66 69 78 20 28 63 61 72 20 28 6f 72 20 efix).....(setq.prefix.(car.(or.
73000 28 6d 65 6d 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 20 (memq.transient-current-command.
73020 70 72 65 66 69 78 29 20 70 72 65 66 69 78 29 29 29 29 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 6f prefix).prefix))))...(if-let.((o
73040 62 6a 20 28 67 65 74 20 70 72 65 66 69 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 bj.(get.prefix.'transient--prefi
73060 78 29 29 29 0a 20 20 20 20 20 20 3b 3b 20 54 68 69 73 20 4f 42 4a 20 69 73 20 6f 6e 6c 79 20 75 x))).......;;.This.OBJ.is.only.u
73080 73 65 64 20 66 6f 72 20 64 69 73 70 61 74 63 68 20 70 75 72 70 6f 73 65 73 3b 20 73 65 65 20 62 sed.for.dispatch.purposes;.see.b
730a0 65 6c 6f 77 2e 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 elow........(transient-prefix-va
730c0 6c 75 65 20 6f 62 6a 29 0a 20 20 20 20 28 65 72 72 6f 72 20 22 4e 6f 74 20 61 20 74 72 61 6e 73 lue.obj).....(error."Not.a.trans
730e0 69 65 6e 74 20 70 72 65 66 69 78 3a 20 25 73 22 20 70 72 65 66 69 78 29 29 29 0a 0a 28 63 6c 2d ient.prefix:.%s".prefix)))..(cl-
73100 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 defgeneric.transient-prefix-valu
73120 65 20 28 6f 62 6a 29 0a 20 20 22 52 65 74 75 72 6e 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 20 e.(obj)..."Return.a.list.of.the.
73140 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 74 68 65 20 73 70 values.of.the.suffixes.of.the.sp
73160 65 63 69 66 69 65 64 20 70 72 65 66 69 78 2e 0a 0a 4f 42 4a 20 69 73 20 61 20 70 72 6f 74 6f 74 ecified.prefix...OBJ.is.a.protot
73180 79 70 65 20 6f 62 6a 65 63 74 20 61 6e 64 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f 20 73 ype.object.and.is.only.used.to.s
731a0 65 6c 65 63 74 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 0a 6d 65 74 68 6f 64 20 6f 66 20 elect.the.appropriate.method.of.
731c0 74 68 69 73 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 72 61 6e 73 69 65 6e this.generic.function...Transien
731e0 74 20 69 74 73 65 6c 66 20 6f 6e 6c 79 20 70 72 6f 76 69 64 65 73 20 6f 6e 65 0a 73 75 63 68 20 t.itself.only.provides.one.such.
73200 6d 65 74 68 6f 64 2c 20 77 68 69 63 68 20 73 68 6f 75 6c 64 20 62 65 20 73 75 69 74 61 62 6c 65 method,.which.should.be.suitable
73220 20 66 6f 72 20 6d 6f 73 74 20 70 72 65 66 69 78 65 73 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 .for.most.prefixes...This.functi
73240 6f 6e 20 69 73 20 6f 6e 6c 79 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 62 on.is.only.intended.to.be.used.b
73260 79 20 60 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 27 2e 20 20 49 74 20 69 73 0a 6e 6f 74 20 64 y.`transient-args'...It.is.not.d
73280 65 66 69 6e 65 64 20 61 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 62 efined.as.an.internal.function.b
732a0 65 63 61 75 73 65 20 74 68 69 72 64 2d 70 61 72 74 79 20 70 61 63 6b 61 67 65 73 20 6d 61 79 0a ecause.third-party.packages.may.
732c0 64 65 66 69 6e 65 20 74 68 65 69 72 20 6f 77 6e 20 6d 65 74 68 6f 64 73 2e 20 20 54 68 61 74 20 define.their.own.methods...That.
732e0 64 6f 65 73 20 6e 6f 74 20 6d 65 61 6e 20 74 68 61 74 20 69 74 20 77 6f 75 6c 64 20 62 65 20 61 does.not.mean.that.it.would.be.a
73300 20 67 6f 6f 64 0a 69 64 65 61 20 74 6f 20 63 61 6c 6c 20 69 74 20 66 6f 72 20 61 6e 79 20 6f 74 .good.idea.to.call.it.for.any.ot
73320 68 65 72 20 70 75 72 70 6f 73 65 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 her.purpose.")..(cl-defmethod.tr
73340 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 ansient-prefix-value.((obj.trans
73360 69 65 6e 74 2d 70 72 65 66 69 78 29 29 0a 20 20 22 52 65 74 75 72 6e 20 61 20 6c 69 73 74 20 6f ient-prefix))..."Return.a.list.o
73380 66 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 f.the.values.of.the.suffixes.of.
733a0 74 68 65 20 73 70 65 63 69 66 69 65 64 20 70 72 65 66 69 78 2e 0a 0a 4f 42 4a 20 69 73 20 61 20 the.specified.prefix...OBJ.is.a.
733c0 70 72 6f 74 6f 74 79 70 65 20 6f 62 6a 65 63 74 2e 20 20 54 68 69 73 20 6d 65 74 68 6f 64 20 64 prototype.object...This.method.d
733e0 6f 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 0a 74 68 61 74 oes.not.return.the.value.of.that
73400 20 6f 62 6a 65 63 74 2e 20 20 49 6e 73 74 65 61 64 20 69 74 20 65 78 74 72 61 63 74 73 20 74 68 .object...Instead.it.extracts.th
73420 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 e.name.of.the.respective.command
73440 0a 66 72 6f 6d 20 74 68 65 20 6f 62 6a 65 63 74 20 61 6e 64 20 75 73 65 73 20 74 68 61 74 20 74 .from.the.object.and.uses.that.t
73460 6f 20 63 6f 6c 6c 65 63 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 73 20 66 72 6f o.collect.the.current.values.fro
73480 6d 20 74 68 65 0a 73 75 66 66 69 78 65 73 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 20 66 72 6f m.the.suffixes.of.the.prefix.fro
734a0 6d 20 77 68 69 63 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 m.which.the.current.command.was.
734c0 69 6e 76 6f 6b 65 64 2e 0a 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 6d 61 6e 64 20 invoked..If.the.current.command.
734e0 77 61 73 20 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 74 68 65 20 69 64 65 6e 74 69 66 was.not.invoked.from.the.identif
73500 69 65 64 20 70 72 65 66 69 78 2c 0a 74 68 65 6e 20 74 68 69 73 20 6d 65 74 68 6f 64 20 72 65 74 ied.prefix,.then.this.method.ret
73520 75 72 6e 73 20 74 68 65 20 73 65 74 2c 20 73 61 76 65 20 6f 72 20 64 65 66 61 75 6c 74 20 76 61 urns.the.set,.save.or.default.va
73540 6c 75 65 2c 20 61 73 20 64 65 73 63 72 69 62 65 64 0a 66 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 lue,.as.described.for.`transient
73560 2d 61 72 67 73 27 2e 0a 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 75 73 65 73 20 60 74 72 61 6e 73 -args'...This.method.uses.`trans
73580 69 65 6e 74 2d 73 75 66 66 69 78 65 73 27 20 28 77 68 69 63 68 20 73 65 65 29 20 74 6f 20 64 65 ient-suffixes'.(which.see).to.de
735a0 74 65 72 6d 69 6e 65 20 74 68 65 0a 73 75 66 66 69 78 20 6f 62 6a 65 63 74 73 20 61 6e 64 20 74 termine.the.suffix.objects.and.t
735c0 68 65 6e 20 65 78 74 72 61 63 74 73 20 74 68 65 20 76 61 6c 75 65 28 73 29 20 66 72 6f 6d 20 74 hen.extracts.the.value(s).from.t
735e0 68 6f 73 65 20 6f 62 6a 65 63 74 73 2e 22 0a 20 20 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 64 61 hose.objects."...(mapcan.(lambda
73600 20 28 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 6f 72 .(obj).............(and.(not.(or
73620 65 66 20 6f 62 6a 20 69 6e 61 63 74 69 76 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ef.obj.inactive))...............
73640 20 20 20 28 6e 6f 74 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 29 29 0a 20 20 20 20 20 20 ...(not.(oref.obj.inapt)).......
73660 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 77 72 61 70 70 ...........(transient--get-wrapp
73680 65 64 2d 76 61 6c 75 65 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 ed-value.obj)))...........(trans
736a0 69 65 6e 74 2d 73 75 66 66 69 78 65 73 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 ient-suffixes.(oref.obj.command)
736c0 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 65 73 20 28 )))..(defun.transient-suffixes.(
736e0 70 72 65 66 69 78 29 0a 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 73 75 66 66 69 78 20 6f 62 6a prefix)..."Return.the.suffix.obj
73700 65 63 74 73 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d ects.of.the.transient.prefix.com
73720 6d 61 6e 64 20 50 52 45 46 49 58 2e 0a 0a 49 66 20 50 52 45 46 49 58 20 69 73 20 6e 6f 74 20 74 mand.PREFIX...If.PREFIX.is.not.t
73740 68 65 20 63 75 72 72 65 6e 74 20 70 72 65 66 69 78 2c 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 he.current.prefix,.initialize.th
73760 65 20 73 75 66 66 69 78 65 73 20 73 6f 20 74 68 61 74 0a 74 68 65 79 20 63 61 6e 20 62 65 20 72 e.suffixes.so.that.they.can.be.r
73780 65 74 75 72 6e 65 64 2e 20 20 54 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 63 61 75 73 65 20 74 68 eturned...That.does.not.cause.th
737a0 65 20 6d 65 6e 75 20 74 6f 20 62 65 20 64 69 73 70 6c 61 79 65 64 2e 22 0a 20 20 28 69 66 20 28 e.menu.to.be.displayed."...(if.(
737c0 65 71 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 63 6f 6d 6d 61 6e 64 20 70 72 65 eq.transient-current-command.pre
737e0 66 69 78 29 0a 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 73 75 66 fix).......transient-current-suf
73800 66 69 78 65 73 0a 20 20 20 20 28 6c 65 74 20 28 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 fixes.....(let.((transient--pref
73820 69 78 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d 70 72 65 66 69 78 20 70 72 65 66 69 ix.(transient--init-prefix.prefi
73840 78 29 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 6c 61 74 74 65 6e 2d 73 x))).......(transient--flatten-s
73860 75 66 66 69 78 65 73 0a 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 69 74 2d uffixes........(transient--init-
73880 73 75 66 66 69 78 65 73 20 70 72 65 66 69 78 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 suffixes.prefix)))))..(defun.tra
738a0 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 20 28 29 0a 20 20 22 52 65 74 75 72 6e 20 74 68 nsient-get-value.()..."Return.th
738c0 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 65 78 74 61 6e 74 20 70 72 65 66 69 78 2e 0a 0a 54 e.value.of.the.extant.prefix...T
738e0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 his.function.is.intended.to.be.u
73900 73 65 64 20 77 68 65 6e 20 73 65 74 74 69 6e 67 20 75 70 20 61 20 6d 65 6e 75 20 61 6e 64 20 69 sed.when.setting.up.a.menu.and.i
73920 74 73 0a 73 75 66 66 69 78 65 73 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 ts.suffixes...It.is.not.intended
73940 20 74 6f 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e .to.be.used.when.a.suffix.comman
73960 64 20 69 73 0a 69 6e 76 6f 6b 65 64 2c 20 77 68 65 74 68 65 72 20 66 72 6f 6d 20 61 20 6d 65 6e d.is.invoked,.whether.from.a.men
73980 75 20 6f 72 20 6e 6f 74 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 60 74 72 61 6e 73 69 65 u.or.not,.in.which.case.`transie
739a0 6e 74 2d 61 72 67 73 27 0a 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2e 22 0a 20 20 28 74 72 61 nt-args'.should.be.used."...(tra
739c0 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 67 65 74 nsient--with-emergency-exit.:get
739e0 2d 76 61 6c 75 65 0a 20 20 20 20 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 64 61 20 28 6f 62 6a 29 -value.....(mapcan.(lambda.(obj)
73a00 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 6f 72 65 66 20 6f ...............(and.(not.(oref.o
73a20 62 6a 20 69 6e 61 63 74 69 76 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 bj.inactive))...................
73a40 20 28 6e 6f 74 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 29 29 0a 20 20 20 20 20 20 20 20 .(not.(oref.obj.inapt)).........
73a60 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 77 72 61 70 70 ...........(transient--get-wrapp
73a80 65 64 2d 76 61 6c 75 65 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e ed-value.obj))).............tran
73aa0 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 sient--suffixes)))..(defun.trans
73ac0 69 65 6e 74 2d 2d 67 65 74 2d 65 78 74 65 6e 64 65 64 2d 76 61 6c 75 65 20 28 29 0a 20 20 22 52 ient--get-extended-value.()..."R
73ae0 65 74 75 72 6e 20 74 68 65 20 65 78 74 65 6e 64 65 64 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 eturn.the.extended.value.of.the.
73b00 65 78 74 61 6e 74 20 70 72 65 66 69 78 2e 0a 0a 55 6e 6c 69 6b 65 20 60 74 72 61 6e 73 69 65 6e extant.prefix...Unlike.`transien
73b20 74 2d 67 65 74 2d 76 61 6c 75 65 27 20 61 6c 73 6f 20 69 6e 63 6c 75 64 65 20 74 68 65 20 76 61 t-get-value'.also.include.the.va
73b40 6c 75 65 73 20 6f 66 20 69 6e 61 63 74 69 76 65 20 61 6e 64 0a 69 6e 61 70 74 20 61 72 67 75 6d lues.of.inactive.and.inapt.argum
73b60 65 6e 74 73 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6d 61 69 6e 6c 79 20 69 ents...This.function.is.mainly.i
73b80 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 2e 0a 49 74 20 69 73 20 ntended.for.internal.use..It.is.
73ba0 75 73 65 64 20 74 6f 20 70 72 65 73 65 72 76 65 20 74 68 65 20 66 75 6c 6c 20 76 61 6c 75 65 20 used.to.preserve.the.full.value.
73bc0 77 68 65 6e 20 61 20 6d 65 6e 75 20 69 73 20 62 65 69 6e 67 20 72 65 66 72 65 73 68 65 64 2c 0a when.a.menu.is.being.refreshed,.
73be0 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 70 72 65 73 65 6e 74 6c 79 20 69 6e 65 66 66 65 63 74 including.the.presently.ineffect
73c00 69 76 65 20 70 61 72 74 73 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 65 ive.parts."...(transient--with-e
73c20 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 67 65 74 2d 76 61 6c 75 65 0a 20 20 20 20 28 6d 61 mergency-exit.:get-value.....(ma
73c40 70 63 61 6e 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 77 72 61 70 70 65 64 2d 76 61 pcan.#'transient--get-wrapped-va
73c60 6c 75 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 29 29 0a 0a 28 64 65 66 lue.transient--suffixes)))..(def
73c80 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 73 61 76 61 62 6c 65 2d 76 61 6c 75 65 20 un.transient--get-savable-value.
73ca0 28 29 0a 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 65 78 ()..."Return.the.value.of.the.ex
73cc0 74 61 6e 74 20 70 72 65 66 69 78 2c 20 65 78 63 6c 75 64 69 6e 67 20 75 6e 73 61 76 61 62 6c 65 tant.prefix,.excluding.unsavable
73ce0 20 70 61 72 74 73 2e 0a 0a 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 69 .parts...This.function.is.only.i
73d00 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 2e 20 20 49 74 20 69 73 ntended.for.internal.use...It.is
73d20 20 75 73 65 64 20 74 6f 20 73 61 76 65 0a 74 68 65 20 76 61 6c 75 65 2e 22 0a 20 20 28 74 72 61 .used.to.save.the.value."...(tra
73d40 6e 73 69 65 6e 74 2d 2d 77 69 74 68 2d 65 6d 65 72 67 65 6e 63 79 2d 65 78 69 74 20 3a 67 65 74 nsient--with-emergency-exit.:get
73d60 2d 73 61 76 61 62 6c 65 2d 76 61 6c 75 65 0a 20 20 20 20 28 6d 61 70 63 61 6e 20 28 6c 61 6d 62 -savable-value.....(mapcan.(lamb
73d80 64 61 20 28 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 da.(obj)...............(and.(not
73da0 20 28 61 6e 64 20 28 73 6c 6f 74 2d 65 78 69 73 74 73 2d 70 20 6f 62 6a 20 27 75 6e 73 61 76 61 .(and.(slot-exists-p.obj.'unsava
73dc0 62 6c 65 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 20 ble)............................
73de0 20 20 28 6f 72 65 66 20 6f 62 6a 20 75 6e 73 61 76 61 62 6c 65 29 29 29 0a 20 20 20 20 20 20 20 ..(oref.obj.unsavable)))........
73e00 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 77 72 61 70 ............(transient--get-wrap
73e20 70 65 64 2d 76 61 6c 75 65 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 ped-value.obj))).............tra
73e40 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e nsient--suffixes)))..(defun.tran
73e60 73 69 65 6e 74 2d 2d 67 65 74 2d 77 72 61 70 70 65 64 2d 76 61 6c 75 65 20 28 6f 62 6a 29 0a 20 sient--get-wrapped-value.(obj)..
73e80 20 22 52 65 74 75 72 6e 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 20 76 61 6c 75 65 28 73 29 20 ."Return.a.list.of.the.value(s).
73ea0 6f 66 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a 2e 0a 0a 49 6e 74 65 72 6e 61 6c 6c of.suffix.object.OBJ...Internall
73ec0 79 20 61 20 73 75 66 66 69 78 20 6f 6e 6c 79 20 65 76 65 72 20 68 61 73 20 6f 6e 65 20 76 61 6c y.a.suffix.only.ever.has.one.val
73ee0 75 65 2c 20 73 74 6f 72 65 64 20 69 6e 20 69 74 73 20 60 76 61 6c 75 65 27 0a 73 6c 6f 74 2c 20 ue,.stored.in.its.`value'.slot,.
73f00 62 75 74 20 63 61 6c 6c 65 72 73 20 6f 66 20 60 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 27 20 but.callers.of.`transient-args'.
73f20 77 69 73 68 20 74 6f 20 74 72 65 61 74 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 0a 63 65 72 74 wish.to.treat.the.values.of.cert
73f40 61 69 6e 20 73 75 66 66 69 78 65 73 20 61 73 20 6d 75 6c 74 69 70 6c 65 20 76 61 6c 75 65 73 2e ain.suffixes.as.multiple.values.
73f60 20 20 54 68 61 74 20 74 72 61 6e 73 6c 61 74 69 6f 6e 20 69 73 20 68 61 6e 64 6c 65 64 0a 68 65 ..That.translation.is.handled.he
73f80 72 65 2e 20 20 54 68 65 20 6f 62 6a 65 63 74 27 73 20 60 6d 75 6c 74 69 2d 76 61 6c 75 65 27 20 re...The.object's.`multi-value'.
73fa0 73 6c 6f 74 20 73 70 65 63 69 66 69 65 73 20 77 68 65 74 68 65 72 20 61 6e 64 20 68 6f 77 0a 74 slot.specifies.whether.and.how.t
73fc0 6f 20 69 6e 74 65 72 70 72 65 74 20 74 68 65 20 60 76 61 6c 75 65 27 20 61 73 20 6d 75 6c 74 69 o.interpret.the.`value'.as.multi
73fe0 70 6c 65 20 76 61 6c 75 65 73 2e 22 0a 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 76 61 6c 75 65 ple.values."...(and-let*.((value
74000 20 28 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 6f 62 6a 29 29 29 0a 20 .(transient-infix-value.obj)))..
74020 20 20 20 28 70 63 61 73 65 2d 65 78 68 61 75 73 74 69 76 65 20 28 61 6e 64 20 28 73 6c 6f 74 2d ...(pcase-exhaustive.(and.(slot-
74040 65 78 69 73 74 73 2d 70 20 6f 62 6a 20 27 6d 75 6c 74 69 2d 76 61 6c 75 65 29 0a 20 20 20 20 20 exists-p.obj.'multi-value)......
74060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 ......................(oref.obj.
74080 6d 75 6c 74 69 2d 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 28 27 6e 69 6c 20 20 20 20 20 20 20 multi-value)).......('nil.......
740a0 20 20 20 28 6c 69 73 74 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 28 28 6f 72 20 27 74 20 27 ...(list.value)).......((or.'t.'
740c0 72 65 73 74 29 20 28 6c 69 73 74 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 28 27 72 65 70 65 rest).(list.value)).......('repe
740e0 61 74 20 20 20 20 20 20 20 76 61 6c 75 65 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 at.......value))))..(cl-defgener
74100 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 28 6f 62 6a 29 0a 20 ic.transient-infix-value.(obj)..
74120 20 22 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 ."Return.the.value.of.the.suffix
74140 20 6f 62 6a 65 63 74 20 4f 42 4a 2e 0a 0a 42 79 20 64 65 66 61 75 6c 74 20 74 68 69 73 20 66 75 .object.OBJ...By.default.this.fu
74160 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6c 76 65 64 20 77 68 65 6e 20 64 65 74 65 72 6d 69 6e nction.is.involved.when.determin
74180 69 6e 67 20 74 68 65 20 70 72 65 66 69 78 27 73 0a 6f 76 65 72 61 6c 6c 20 76 61 6c 75 65 2c 20 ing.the.prefix's.overall.value,.
741a0 72 65 74 75 72 6e 65 64 20 62 79 20 60 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 27 20 28 77 68 returned.by.`transient-args'.(wh
741c0 69 63 68 20 73 65 65 29 2c 20 20 73 6f 20 74 68 61 74 0a 74 68 65 20 69 6e 76 6f 6b 65 64 20 73 ich.see),..so.that.the.invoked.s
741e0 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 75 73 65 20 74 68 61 74 2e 0a 0a 43 75 72 uffix.command.can.use.that...Cur
74200 72 65 6e 74 6c 79 20 6d 6f 73 74 20 76 61 6c 75 65 73 20 61 72 65 20 73 74 72 69 6e 67 73 2c 20 rently.most.values.are.strings,.
74220 62 75 74 20 74 68 61 74 20 69 73 20 6e 6f 74 20 73 65 74 20 69 6e 20 73 74 6f 6e 65 2e 0a 4e 69 but.that.is.not.set.in.stone..Ni
74240 6c 20 69 73 20 6e 6f 74 20 61 20 76 61 6c 75 65 2c 20 69 74 20 6d 65 61 6e 73 20 5c 22 6e 6f 20 l.is.not.a.value,.it.means.\"no.
74260 76 61 6c 75 65 5c 22 2e 0a 0a 55 73 75 61 6c 6c 79 20 6f 6e 6c 79 20 69 6e 66 69 78 65 73 20 68 value\"...Usually.only.infixes.h
74280 61 76 65 20 61 20 76 61 6c 75 65 2c 20 62 75 74 20 73 65 65 20 74 68 65 20 6d 65 74 68 6f 64 20 ave.a.value,.but.see.the.method.
742a0 66 6f 72 0a 60 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 27 2e 22 29 0a 0a 28 63 6c 2d 64 for.`transient-suffix'.")..(cl-d
742c0 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 28 efmethod.transient-infix-value.(
742e0 28 5f 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 52 65 74 75 72 (_...transient-suffix))..."Retur
74300 6e 20 6e 69 6c 2c 20 77 68 69 63 68 20 6d 65 61 6e 73 20 5c 22 6e 6f 20 76 61 6c 75 65 5c 22 2e n.nil,.which.means.\"no.value\".
74320 0a 0a 49 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 63 6f 6e 74 72 69 62 75 74 65 20 74 68 65 ..Infix.arguments.contribute.the
74340 20 74 72 61 6e 73 69 65 6e 74 27 73 20 76 61 6c 75 65 20 77 68 69 6c 65 20 73 75 66 66 69 78 0a .transient's.value.while.suffix.
74360 63 6f 6d 6d 61 6e 64 73 20 63 6f 6e 73 75 6d 65 20 69 74 2e 20 20 54 68 69 73 20 66 75 6e 63 74 commands.consume.it...This.funct
74380 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 61 6e 79 77 61 ion.is.called.for.suffixes.anywa
743a0 79 0a 62 65 63 61 75 73 65 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 62 6f 74 68 20 63 6f y.because.a.command.that.both.co
743c0 6e 74 72 69 62 75 74 65 73 20 74 6f 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 27 73 20 76 61 6c ntributes.to.the.transient's.val
743e0 75 65 0a 61 6e 64 20 61 6c 73 6f 20 63 6f 6e 73 75 6d 65 73 20 69 74 20 69 73 20 6e 6f 74 20 63 ue.and.also.consumes.it.is.not.c
74400 6f 6d 70 6c 65 74 65 6c 79 20 75 6e 63 6f 6e 63 65 69 76 61 62 6c 65 2e 0a 0a 49 66 20 79 6f 75 ompletely.unconceivable...If.you
74420 20 64 65 66 69 6e 65 20 73 75 63 68 20 61 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 6e 20 79 6f 75 .define.such.a.command,.then.you
74440 20 6d 75 73 74 20 64 65 66 69 6e 65 20 61 20 64 65 72 69 76 65 64 0a 63 6c 61 73 73 20 61 6e 64 .must.define.a.derived.class.and
74460 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 62 65 63 61 75 73 65 .implement.this.function.because
74480 20 74 68 69 73 20 64 65 66 61 75 6c 74 20 6d 65 74 68 6f 64 0a 64 6f 65 73 20 6e 6f 74 68 69 6e .this.default.method.does.nothin
744a0 67 2e 22 20 6e 69 6c 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e g.".nil)..(cl-defmethod.transien
744c0 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e t-infix-value.((obj.transient-in
744e0 66 69 78 29 29 0a 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4f 42 4a fix))..."Return.the.value.of.OBJ
74500 27 73 20 60 76 61 6c 75 65 27 20 73 6c 6f 74 2e 22 0a 20 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 's.`value'.slot."...(oref.obj.va
74520 6c 75 65 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 lue))..(cl-defmethod.transient-i
74540 6e 66 69 78 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f nfix-value.((obj.transient-optio
74560 6e 29 29 0a 20 20 22 52 65 74 75 72 6e 20 41 52 47 55 4d 45 4e 54 20 61 6e 64 20 56 41 4c 55 45 n))..."Return.ARGUMENT.and.VALUE
74580 20 61 73 20 61 20 75 6e 69 74 20 6f 72 20 6e 69 6c 20 69 66 20 74 68 65 20 6c 61 74 74 65 72 20 .as.a.unit.or.nil.if.the.latter.
745a0 69 73 20 6e 69 6c 2e 22 0a 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 76 61 6c 75 65 20 28 6f 72 is.nil."...(and-let*.((value.(or
745c0 65 66 20 6f 62 6a 20 76 61 6c 75 65 29 29 29 0a 20 20 20 20 28 6c 65 74 20 28 28 61 72 67 20 28 ef.obj.value))).....(let.((arg.(
745e0 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 29 29 0a 20 20 20 20 20 20 28 70 63 61 73 oref.obj.argument))).......(pcas
74600 65 2d 65 78 68 61 75 73 74 69 76 65 20 28 6f 72 65 66 20 6f 62 6a 20 6d 75 6c 74 69 2d 76 61 6c e-exhaustive.(oref.obj.multi-val
74620 75 65 29 0a 20 20 20 20 20 20 20 20 28 27 6e 69 6c 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 63 ue).........('nil..........(conc
74640 61 74 20 61 72 67 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 20 20 28 28 6f 72 20 27 74 20 27 at.arg.value)).........((or.'t.'
74660 72 65 73 74 29 20 28 63 6f 6e 73 20 61 72 67 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 20 20 rest).(cons.arg.value)).........
74680 28 27 72 65 70 65 61 74 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 28 6c 61 6d 62 64 61 20 28 ('repeat.......(mapcar.(lambda.(
746a0 76 29 20 28 63 6f 6e 63 61 74 20 61 72 67 20 76 29 29 20 76 61 6c 75 65 29 29 29 29 29 29 0a 0a v).(concat.arg.v)).value))))))..
746c0 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 (cl-defmethod.transient-infix-va
746e0 6c 75 65 20 28 28 5f 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 76 61 72 69 61 62 6c 65 29 29 0a 20 lue.((_...transient-variable))..
74700 20 22 52 65 74 75 72 6e 20 6e 69 6c 2c 20 77 68 69 63 68 20 6d 65 61 6e 73 20 5c 22 6e 6f 20 76 ."Return.nil,.which.means.\"no.v
74720 61 6c 75 65 5c 22 2e 0a 0a 53 65 74 74 69 6e 67 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 alue\"...Setting.the.value.of.a.
74740 76 61 72 69 61 62 6c 65 20 69 73 20 64 6f 6e 65 20 62 79 2c 20 77 65 6c 6c 2c 20 73 65 74 74 69 variable.is.done.by,.well,.setti
74760 6e 67 20 74 68 65 0a 76 61 6c 75 65 20 6f 66 20 74 68 65 20 76 61 72 69 61 62 6c 65 2e 20 20 49 ng.the.value.of.the.variable...I
74780 2e 65 2e 2c 20 74 68 69 73 20 69 73 20 61 20 73 69 64 65 2d 65 66 66 65 63 74 20 61 6e 64 20 64 .e.,.this.is.a.side-effect.and.d
747a0 6f 65 73 0a 6e 6f 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 oes.not.contribute.to.the.value.
747c0 6f 66 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 6e 69 6c 29 0a 0a 3b 3b 3b 3b 20 of.the.transient."...nil)..;;;;.
747e0 55 74 69 6c 69 74 69 65 73 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 2d Utilities..(defun.transient-arg-
74800 76 61 6c 75 65 20 28 61 72 67 20 61 72 67 73 29 0a 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 76 value.(arg.args)..."Return.the.v
74820 61 6c 75 65 20 6f 66 20 41 52 47 20 61 73 20 69 74 20 61 70 70 65 61 72 73 20 69 6e 20 41 52 47 alue.of.ARG.as.it.appears.in.ARG
74840 53 2e 0a 0a 46 6f 72 20 61 20 73 77 69 74 63 68 20 72 65 74 75 72 6e 20 61 20 62 6f 6f 6c 65 61 S...For.a.switch.return.a.boolea
74860 6e 2e 20 20 46 6f 72 20 61 6e 20 6f 70 74 69 6f 6e 20 72 65 74 75 72 6e 20 74 68 65 20 76 61 6c n...For.an.option.return.the.val
74880 75 65 20 61 73 0a 61 20 73 74 72 69 6e 67 2c 20 75 73 69 6e 67 20 74 68 65 20 65 6d 70 74 79 20 ue.as.a.string,.using.the.empty.
748a0 73 74 72 69 6e 67 20 66 6f 72 20 74 68 65 20 65 6d 70 74 79 20 76 61 6c 75 65 2c 20 6f 72 20 6e string.for.the.empty.value,.or.n
748c0 69 6c 20 69 66 0a 74 68 65 20 6f 70 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 61 70 70 65 61 72 il.if.the.option.does.not.appear
748e0 20 69 6e 20 41 52 47 53 2e 0a 0a 41 70 70 65 6e 64 20 5c 22 3d 5c 20 74 6f 20 41 52 47 20 74 6f .in.ARGS...Append.\"=\.to.ARG.to
74900 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 69 74 20 69 73 20 61 6e 20 6f 70 74 69 6f 6e 2e 22 .indicate.that.it.is.an.option."
74920 0a 20 20 28 69 66 20 28 73 74 72 69 6e 67 2d 73 75 66 66 69 78 2d 70 20 22 3d 22 20 61 72 67 29 ...(if.(string-suffix-p."=".arg)
74940 0a 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.........
74960 28 61 6e 64 2d 6c 65 74 2a 20 28 28 6d 61 74 63 68 20 28 6c 65 74 20 28 28 63 61 73 65 2d 66 6f (and-let*.((match.(let.((case-fo
74980 6c 64 2d 73 65 61 72 63 68 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ld-search.nil)..................
749a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 20 28 66 6f 72 6d 61 74 20 22 5c 5c 60 25 ...............(re.(format."\\`%
749c0 73 5c 5c 28 3f 3a 3d 5c 5c 28 2e 2b 5c 5c 29 5c 5c 29 3f 5c 5c 27 22 0a 20 20 20 20 20 20 20 20 s\\(?:=\\(.+\\)\\)?\\'".........
749e0 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 ................................
74a00 20 20 20 20 28 73 75 62 73 74 72 69 6e 67 20 61 72 67 20 30 20 2d 31 29 29 29 29 0a 20 20 20 20 ....(substring.arg.0.-1)))).....
74a20 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 63 6c 2d 66 69 6e 64 ........................(cl-find
74a40 2d 69 66 20 28 6c 61 6d 62 64 61 20 28 61 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -if.(lambda.(a).................
74a60 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 61 6e 64 20 28 ..........................(and.(
74a80 73 74 72 69 6e 67 70 20 61 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 stringp.a)......................
74aa0 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 73 74 72 69 6e ..........................(strin
74ac0 67 2d 6d 61 74 63 68 20 72 65 20 61 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g-match.re.a))).................
74ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 73 29 29 29 29 ........................args))))
74b00 0a 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6d 61 74 63 68 2d 73 74 72 69 6e 67 20 31 20 6d ...........(or.(match-string.1.m
74b20 61 74 63 68 29 20 22 22 29 29 29 0a 20 20 20 20 28 61 6e 64 20 28 6d 65 6d 62 65 72 20 61 72 67 atch).""))).....(and.(member.arg
74b40 20 61 72 67 73 29 20 74 29 29 29 0a 0a 3b 3b 3b 20 52 65 74 75 72 6e 0a 0a 28 64 65 66 75 6e 20 .args).t)))..;;;.Return..(defun.
74b60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 72 65 74 75 72 6e 20 28 6f 62 6a 29 0a 20 20 28 77 transient-init-return.(obj)...(w
74b80 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 74 61 63 6b 29 0a 20 hen-let*.((_.transient--stack)..
74ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6d 6d 61 6e 64 20 28 6f 72 65 66 20 6f 62 6a 20 .............(command.(oref.obj.
74bc0 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 66 66 69 78 2d command))...............(suffix-
74be0 6f 62 6a 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 20 63 6f 6d obj.(transient-suffix-object.com
74c00 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 6d 65 6d 71 20 28 69 66 mand))...............(_(memq.(if
74c20 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 73 75 66 66 69 78 2d 6f 62 6a 20 27 74 72 61 6e 73 69 .(slot-boundp.suffix-obj.'transi
74c40 65 6e 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 20 20 20 20 28 ent)...........................(
74c60 6f 72 65 66 20 73 75 66 66 69 78 2d 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 29 0a 20 20 20 20 20 oref.suffix-obj.transient)......
74c80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 ...................(oref.transie
74ca0 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 nt-current-prefix.transient-suff
74cc0 69 78 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 28 6c 69 73 74 ix)).......................(list
74ce0 20 74 20 27 72 65 63 75 72 73 65 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 72 65 63 75 .t.'recurse.#'transient--do-recu
74d00 72 73 65 29 29 29 29 0a 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 72 65 74 75 72 6e 20 74 29 29 rse)))).....(oset.obj.return.t))
74d20 29 0a 0a 3b 3b 3b 20 53 63 6f 70 65 0a 3b 3b 3b 3b 20 49 6e 69 74 0a 0a 28 63 6c 2d 64 65 66 67 )..;;;.Scope.;;;;.Init..(cl-defg
74d40 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 20 28 6f 62 6a eneric.transient-init-scope.(obj
74d60 29 0a 20 20 22 53 65 74 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 70 72 65 66 69 78 )..."Set.the.scope.of.the.prefix
74d80 20 6f 72 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 20 4f 42 4a 2e 0a 0a 54 68 65 20 73 63 6f 70 .or.suffix.object.OBJ...The.scop
74da0 65 20 69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 70 72 6f 70 65 72 74 79 20 6f 66 20 74 68 65 20 e.is.actually.a.property.of.the.
74dc0 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 2c 20 6e 6f 74 20 6f 66 0a 69 6e 64 69 76 69 64 transient.prefix,.not.of.individ
74de0 75 61 6c 20 73 75 66 66 69 78 65 73 2e 20 20 48 6f 77 65 76 65 72 20 69 74 20 69 73 20 70 6f 73 ual.suffixes...However.it.is.pos
74e00 73 69 62 6c 65 20 74 6f 20 69 6e 76 6f 6b 65 20 61 20 73 75 66 66 69 78 0a 63 6f 6d 6d 61 6e 64 sible.to.invoke.a.suffix.command
74e20 20 64 69 72 65 63 74 6c 79 20 69 6e 73 74 65 61 64 20 6f 66 20 66 72 6f 6d 20 61 20 74 72 61 6e .directly.instead.of.from.a.tran
74e40 73 69 65 6e 74 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 69 66 0a 74 68 65 20 73 75 66 sient...In.that.case,.if.the.suf
74e60 66 69 78 20 65 78 70 65 63 74 73 20 61 20 73 63 6f 70 65 2c 20 74 68 65 6e 20 69 74 20 68 61 73 fix.expects.a.scope,.then.it.has
74e80 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 61 74 20 69 74 73 65 6c 66 0a 61 6e 64 20 73 74 .to.determine.that.itself.and.st
74ea0 6f 72 65 20 69 74 20 69 6e 20 69 74 73 20 60 73 63 6f 70 65 27 20 73 6c 6f 74 2e 0a 0a 54 68 69 ore.it.in.its.`scope'.slot...Thi
74ec0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 61 6c 6c 20 70 72 65 s.function.is.called.for.all.pre
74ee0 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 62 75 74 0a 75 6e 6c fix.and.suffix.commands,.but.unl
74f00 65 73 73 20 61 20 63 6f 6e 63 72 65 74 65 20 6d 65 74 68 6f 64 20 69 73 20 69 6d 70 6c 65 6d 65 ess.a.concrete.method.is.impleme
74f20 6e 74 65 64 2c 20 74 68 69 73 20 66 61 6c 6c 73 20 74 68 72 6f 75 67 68 20 74 6f 0a 61 20 64 65 nted,.this.falls.through.to.a.de
74f40 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 77 68 69 63 68 20 69 73 20 61 fault.implementation,.which.is.a
74f60 20 6e 6f 6f 70 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e .noop.")..(cl-defmethod.transien
74f80 74 2d 69 6e 69 74 2d 73 63 6f 70 65 20 28 28 5f 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 t-init-scope.((_...transient-pre
74fa0 66 69 78 29 29 0a 20 20 22 4e 6f 6f 70 2e 22 20 6e 69 6c 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 fix))..."Noop.".nil)..(cl-defmet
74fc0 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 63 6f 70 65 20 28 28 5f 20 20 20 74 hod.transient-init-scope.((_...t
74fe0 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 4e 6f 6f 70 2e 22 20 6e 69 6c 29 ransient-suffix))..."Noop.".nil)
75000 0a 0a 3b 3b 3b 3b 20 47 65 74 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 63 6f ..;;;;.Get..(defun.transient-sco
75020 70 65 20 28 26 6f 70 74 69 6f 6e 61 6c 20 70 72 65 66 69 78 65 73 20 63 6c 61 73 73 65 73 29 0a pe.(&optional.prefixes.classes).
75040 20 20 22 52 65 74 75 72 6e 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 61 63 74 69 76 .."Return.the.scope.of.the.activ
75060 65 20 6f 72 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f e.or.current.transient.prefix.co
75080 6d 6d 61 6e 64 2e 0a 0a 49 66 20 6f 70 74 69 6f 6e 61 6c 20 50 52 45 46 49 58 45 53 20 61 6e 64 mmand...If.optional.PREFIXES.and
750a0 20 43 4c 41 53 53 45 53 20 61 72 65 20 62 6f 74 68 20 6e 69 6c 2c 20 72 65 74 75 72 6e 20 74 68 .CLASSES.are.both.nil,.return.th
750c0 65 20 73 63 6f 70 65 20 6f 66 0a 74 68 65 20 70 72 65 66 69 78 20 63 75 72 72 65 6e 74 6c 79 20 e.scope.of.the.prefix.currently.
750e0 62 65 69 6e 67 20 73 65 74 75 70 2c 20 6d 61 6b 69 6e 67 20 74 68 69 73 20 76 61 72 69 61 74 69 being.setup,.making.this.variati
75100 6f 6e 20 75 73 65 66 75 6c 2c 20 65 2e 67 2e 2c 0a 69 6e 20 60 3a 69 66 2a 27 20 70 72 65 64 69 on.useful,.e.g.,.in.`:if*'.predi
75120 63 61 74 65 73 2e 20 20 49 66 20 6e 6f 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 20 73 65 cates...If.no.prefix.is.being.se
75140 74 75 70 2c 20 62 75 74 20 74 68 65 20 63 75 72 72 65 6e 74 0a 63 6f 6d 6d 61 6e 64 20 77 61 73 tup,.but.the.current.command.was
75160 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 73 6f 6d 65 20 70 72 65 66 69 78 2c 20 74 68 65 6e 20 .invoked.from.some.prefix,.then.
75180 72 65 74 75 72 6e 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 61 74 2e 0a 0a 49 66 20 50 52 return.the.scope.of.that...If.PR
751a0 45 46 49 58 45 53 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 69 74 20 6d 75 73 74 20 62 65 20 61 20 EFIXES.is.non-nil,.it.must.be.a.
751c0 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 73 75 63 68 prefix.command.or.a.list.of.such
751e0 0a 63 6f 6d 6d 61 6e 64 73 2e 20 20 49 66 20 43 4c 41 53 53 45 53 20 69 73 20 6e 6f 6e 2d 6e 69 .commands...If.CLASSES.is.non-ni
75200 6c 2c 20 69 74 20 6d 75 73 74 20 62 65 20 61 20 70 72 65 66 69 78 20 63 6c 61 73 73 20 6f 72 20 l,.it.must.be.a.prefix.class.or.
75220 61 20 6c 69 73 74 0a 6f 66 20 73 75 63 68 20 63 6c 61 73 73 65 73 2e 20 20 57 68 65 6e 20 74 68 a.list.of.such.classes...When.th
75240 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20 62 is.function.is.called.from.the.b
75260 6f 64 79 20 6f 72 20 74 68 65 0a 60 69 6e 74 65 72 61 63 74 69 76 65 27 20 66 6f 72 6d 20 6f 66 ody.or.the.`interactive'.form.of
75280 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 50 52 45 46 49 58 45 53 20 61 6e 64 2f .a.suffix.command,.PREFIXES.and/
752a0 6f 72 20 43 4c 41 53 53 45 53 20 73 68 6f 75 6c 64 0a 62 65 20 6e 6f 6e 2d 6e 69 6c 2e 20 20 49 or.CLASSES.should.be.non-nil...I
752c0 66 20 65 69 74 68 65 72 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 74 72 79 20 74 68 65 20 66 6f 6c f.either.is.non-nil,.try.the.fol
752e0 6c 6f 77 69 6e 67 20 69 6e 20 6f 72 64 65 72 3a 0a 0a 2d 20 49 66 20 74 68 65 20 63 75 72 72 65 lowing.in.order:..-.If.the.curre
75300 6e 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 nt.suffix.command.was.invoked.fr
75320 6f 6d 20 61 20 70 72 65 66 69 78 2c 20 77 68 69 63 68 0a 20 20 61 70 70 65 61 72 73 20 69 6e 20 om.a.prefix,.which...appears.in.
75340 50 52 45 46 49 58 45 53 2c 20 72 65 74 75 72 6e 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 PREFIXES,.return.the.scope.of.th
75360 61 74 20 70 72 65 66 69 78 2e 0a 0a 2d 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 75 66 at.prefix...-.If.the.current.suf
75380 66 69 78 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 61 20 70 fix.command.was.invoked.from.a.p
753a0 72 65 66 69 78 2c 20 61 6e 64 20 69 74 73 0a 20 20 63 6c 61 73 73 20 64 65 72 69 76 65 73 20 66 refix,.and.its...class.derives.f
753c0 72 6f 6d 20 6f 6e 65 20 6f 66 20 74 68 65 20 43 4c 41 53 53 45 53 2c 20 72 65 74 75 72 6e 20 74 rom.one.of.the.CLASSES,.return.t
753e0 68 65 20 73 63 6f 70 65 20 6f 66 20 74 68 61 74 0a 20 20 70 72 65 66 69 78 2e 0a 0a 2d 20 49 66 he.scope.of.that...prefix...-.If
75400 20 61 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 20 73 65 74 75 70 20 61 6e 64 20 69 74 20 .a.prefix.is.being.setup.and.it.
75420 61 70 70 65 61 72 73 20 69 6e 20 50 52 45 46 49 58 45 53 2c 20 72 65 74 75 72 6e 20 69 74 73 0a appears.in.PREFIXES,.return.its.
75440 20 20 73 63 6f 70 65 2e 0a 0a 2d 20 49 66 20 61 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 ..scope...-.If.a.prefix.is.being
75460 20 73 65 74 75 70 20 61 6e 64 20 69 74 73 20 63 6c 61 73 73 20 64 65 72 69 76 65 73 20 66 72 6f .setup.and.its.class.derives.fro
75480 6d 20 6f 6e 65 20 6f 66 20 74 68 65 0a 20 20 43 4c 41 53 53 45 53 2c 20 72 65 74 75 72 6e 20 69 m.one.of.the...CLASSES,.return.i
754a0 74 73 20 73 63 6f 70 65 2e 0a 0a 2d 20 46 69 6e 61 6c 6c 79 20 74 72 79 20 74 6f 20 72 65 74 75 ts.scope...-.Finally.try.to.retu
754c0 72 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 63 6f 70 65 20 6f 66 20 74 68 65 20 66 69 72 73 rn.the.default.scope.of.the.firs
754e0 74 20 63 6f 6d 6d 61 6e 64 20 69 6e 0a 20 20 50 52 45 46 49 58 45 53 2e 20 20 54 68 69 73 20 6f t.command.in...PREFIXES...This.o
75500 6e 6c 79 20 77 6f 72 6b 73 20 69 66 20 74 68 61 74 20 73 6c 6f 74 20 69 73 20 73 65 74 20 69 6e nly.works.if.that.slot.is.set.in
75520 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 0a 20 20 63 6c 61 73 73 20 64 65 66 69 6e 69 74 69 .the.respective...class.definiti
75540 6f 6e 20 6f 72 20 75 73 69 6e 67 20 69 74 73 20 60 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d on.or.using.its.`transient-init-
75560 73 63 6f 70 65 27 20 6d 65 74 68 6f 64 2e 0a 0a 49 66 20 6e 6f 20 70 72 65 66 69 78 20 6d 61 74 scope'.method...If.no.prefix.mat
75580 63 68 65 73 2c 20 72 65 74 75 72 6e 20 6e 69 6c 2e 22 0a 20 20 28 69 66 20 28 6f 72 20 70 72 65 ches,.return.nil."...(if.(or.pre
755a0 66 69 78 65 73 20 63 6c 61 73 73 65 73 29 0a 20 20 20 20 20 20 28 6c 65 74 20 28 28 70 72 65 66 fixes.classes).......(let.((pref
755c0 69 78 65 73 20 28 65 6e 73 75 72 65 2d 6c 69 73 74 20 70 72 65 66 69 78 65 73 29 29 0a 20 20 20 ixes.(ensure-list.prefixes))....
755e0 20 20 20 20 20 20 20 20 20 28 74 79 70 65 20 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 63 6c 61 73 .........(type.(if.(symbolp.clas
75600 73 65 73 29 20 63 6c 61 73 73 65 73 20 28 63 6f 6e 73 20 27 6f 72 20 63 6c 61 73 73 65 73 29 29 ses).classes.(cons.'or.classes))
75620 29 29 0a 20 20 20 20 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 6f 62 6a 20 28 63 6c 2d 66 6c 65 )).........(if-let.((obj.(cl-fle
75640 74 20 28 28 6d 61 74 63 68 20 28 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t.((match.(obj).................
75660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 6f 62 6a 0a 20 20 20 20 20 ..................(and.obj......
75680 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 ................................
756a0 20 20 28 6f 72 20 28 6d 65 6d 71 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 20 70 ..(or.(memq.(oref.obj.command).p
756c0 72 65 66 69 78 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 20 20 refixes)........................
756e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6c 2d 74 79 70 65 70 20 6f 62 ....................(cl-typep.ob
75700 6a 20 74 79 70 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 j.type))........................
75720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 62 6a 29 29 29 0a 20 20 20 20 20 20 20 20 20 ................obj)))..........
75740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 28 6d 61 74 63 68 20 74 72 61 6e 73 69 ...............(or.(match.transi
75760 65 6e 74 2d 63 75 72 72 65 6e 74 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ent-current-prefix).............
75780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 74 63 68 20 74 72 61 6e 73 69 65 6e 74 ................(match.transient
757a0 2d 2d 70 72 65 66 69 78 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 --prefix))))).............(oref.
757c0 6f 62 6a 20 73 63 6f 70 65 29 0a 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 67 65 74 20 28 obj.scope)...........(and.(get.(
757e0 63 61 72 20 70 72 65 66 69 78 65 73 29 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 car.prefixes).'transient--prefix
75800 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 28 74 72 61 6e 73 69 65 6e )................(oref.(transien
75820 74 2d 2d 69 6e 69 74 2d 70 72 65 66 69 78 20 28 63 61 72 20 70 72 65 66 69 78 65 73 29 29 20 73 t--init-prefix.(car.prefixes)).s
75840 63 6f 70 65 29 29 29 29 0a 20 20 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 6f 62 6a 20 28 74 72 cope)))).....(and-let*.((obj.(tr
75860 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 29 29 29 0a 20 20 20 20 20 20 28 ansient-prefix-object))).......(
75880 6f 72 65 66 20 6f 62 6a 20 73 63 6f 70 65 29 29 29 29 0a 0a 3b 3b 3b 20 48 69 73 74 6f 72 79 0a oref.obj.scope))))..;;;.History.
758a0 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f .(cl-defgeneric.transient--histo
758c0 72 79 2d 6b 65 79 20 28 6f 62 6a 29 0a 20 20 22 52 65 74 75 72 6e 20 4f 42 4a 27 73 20 68 69 73 ry-key.(obj)..."Return.OBJ's.his
758e0 74 6f 72 79 20 6b 65 79 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 tory.key.")..(cl-defmethod.trans
75900 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 6b 65 79 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e ient--history-key.((obj.transien
75920 74 2d 70 72 65 66 69 78 29 29 0a 20 20 22 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 t-prefix))..."If.the.value.of.th
75940 65 20 60 68 69 73 74 6f 72 79 2d 6b 65 79 27 20 73 6c 6f 74 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c e.`history-key'.slot.is.non-nil,
75960 20 72 65 74 75 72 6e 20 74 68 61 74 2e 0a 4f 74 68 65 72 77 69 73 65 20 72 65 74 75 72 6e 20 74 .return.that..Otherwise.return.t
75980 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 60 63 6f 6d 6d 61 6e 64 27 20 73 6c 6f 74 2e 22 he.value.of.the.`command'.slot."
759a0 0a 20 20 28 6f 72 20 28 6f 72 65 66 20 6f 62 6a 20 68 69 73 74 6f 72 79 2d 6b 65 79 29 0a 20 20 ...(or.(oref.obj.history-key)...
759c0 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 0a 28 63 6c 2d 64 65 ....(oref.obj.command)))..(cl-de
759e0 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 70 75 73 68 fgeneric.transient--history-push
75a00 20 28 6f 62 6a 20 76 61 6c 75 65 29 0a 20 20 22 50 75 73 68 20 56 41 4c 55 45 20 74 6f 20 4f 42 .(obj.value)..."Push.VALUE.to.OB
75a20 4a 27 73 20 65 6e 74 72 79 20 69 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 27 J's.entry.in.`transient-history'
75a40 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 .")..(cl-defmethod.transient--hi
75a60 73 74 6f 72 79 2d 70 75 73 68 0a 20 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 story-push...((obj.transient-pre
75a80 66 69 78 29 0a 20 20 20 26 6f 70 74 69 6f 6e 61 6c 20 28 76 61 6c 75 65 20 28 74 72 61 6e 73 69 fix)....&optional.(value.(transi
75aa0 65 6e 74 2d 2d 67 65 74 2d 73 61 76 61 62 6c 65 2d 76 61 6c 75 65 29 29 29 0a 20 20 28 6c 65 74 ent--get-savable-value)))...(let
75ac0 20 28 28 6b 65 79 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 6b 65 79 20 6f .((key.(transient--history-key.o
75ae0 62 6a 29 29 29 0a 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 6b 65 79 20 74 bj))).....(setf.(alist-get.key.t
75b00 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 29 0a 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e ransient-history)...........(con
75b20 73 20 76 61 6c 75 65 20 28 64 65 6c 65 74 65 20 76 61 6c 75 65 20 28 61 6c 69 73 74 2d 67 65 74 s.value.(delete.value.(alist-get
75b40 20 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 29 29 29 29 29 29 0a 0a 28 63 .key.transient-history))))))..(c
75b60 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d l-defgeneric.transient--history-
75b80 69 6e 69 74 20 28 6f 62 6a 29 0a 20 20 22 49 6e 69 74 69 61 6c 69 7a 65 20 4f 42 4a 27 73 20 60 init.(obj)..."Initialize.OBJ's.`
75ba0 68 69 73 74 6f 72 79 27 20 73 6c 6f 74 2e 0a 54 68 69 73 20 69 73 20 74 68 65 20 74 72 61 6e 73 history'.slot..This.is.the.trans
75bc0 69 65 6e 74 2d 77 69 64 65 20 68 69 73 74 6f 72 79 3b 20 6d 61 6e 79 20 69 6e 64 69 76 69 64 75 ient-wide.history;.many.individu
75be0 61 6c 20 69 6e 66 69 78 65 73 20 61 6c 73 6f 0a 68 61 76 65 20 61 20 68 69 73 74 6f 72 79 20 6f al.infixes.also.have.a.history.o
75c00 66 20 74 68 65 69 72 20 6f 77 6e 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 f.their.own.")..(cl-defmethod.tr
75c20 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 69 6e 69 74 20 28 28 6f 62 6a 20 74 72 61 6e ansient--history-init.((obj.tran
75c40 73 69 65 6e 74 2d 70 72 65 66 69 78 29 29 0a 20 20 22 49 6e 69 74 69 61 6c 69 7a 65 20 4f 42 4a sient-prefix))..."Initialize.OBJ
75c60 27 73 20 60 68 69 73 74 6f 72 79 27 20 73 6c 6f 74 20 66 72 6f 6d 20 74 68 65 20 76 61 72 69 61 's.`history'.slot.from.the.varia
75c80 62 6c 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 27 2e 22 0a 20 20 28 6f 73 65 ble.`transient-history'."...(ose
75ca0 74 20 6f 62 6a 20 68 69 73 74 6f 72 79 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 76 61 6c t.obj.history.........(let.((val
75cc0 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 65 78 74 65 6e 64 65 64 2d 76 61 6c 75 65 29 .(transient--get-extended-value)
75ce0 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 73 20 76 61 6c 20 28 64 65 6c 65 74 65 20 76 ))...........(cons.val.(delete.v
75d00 61 6c 20 28 61 6c 69 73 74 2d 67 65 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 al.(alist-get.(transient--histor
75d20 79 2d 6b 65 79 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y-key.obj)......................
75d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d ......................transient-
75d60 68 69 73 74 6f 72 79 29 29 29 29 29 29 0a 0a 3b 3b 3b 20 44 69 73 70 6c 61 79 0a 0a 28 64 65 66 history))))))..;;;.Display..(def
75d80 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 68 69 6e 74 20 28 29 0a 20 20 28 6c 65 un.transient--show-hint.()...(le
75da0 74 20 28 28 6d 65 73 73 61 67 65 2d 6c 6f 67 2d 6d 61 78 20 6e 69 6c 29 29 0a 20 20 20 20 28 6d t.((message-log-max.nil)).....(m
75dc0 65 73 73 61 67 65 20 22 25 73 22 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 6f 72 6d 61 74 2d 68 essage."%s".(transient--format-h
75de0 69 6e 74 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 20 int))))..(defun.transient--show.
75e00 28 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 74 69 6d 65 72 2d 63 61 6e 63 65 6c 29 0a 20 ()...(transient--timer-cancel)..
75e20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 70 20 74 29 0a 20 20 28 6c 65 .(setq.transient--showp.t)...(le
75e40 74 20 28 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 20 28 t.((transient--shadowed-buffer.(
75e60 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 75 70 20 current-buffer)).........(setup.
75e80 28 6e 6f 74 20 28 67 65 74 2d 62 75 66 66 65 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 (not.(get-buffer.transient--buff
75ea0 65 72 2d 6e 61 6d 65 29 29 29 0a 20 20 20 20 20 20 20 20 28 66 6f 63 75 73 20 6e 69 6c 29 29 0a er-name))).........(focus.nil)).
75ec0 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 20 28 67 65 74 ....(setq.transient--buffer.(get
75ee0 2d 62 75 66 66 65 72 2d 63 72 65 61 74 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 -buffer-create.transient--buffer
75f00 2d 6e 61 6d 65 29 29 0a 20 20 20 20 28 77 69 74 68 2d 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 -name)).....(with-current-buffer
75f20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 28 77 68 65 6e 20 74 .transient--buffer.......(when.t
75f40 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e ransient-enable-popup-navigation
75f60 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 66 6f 63 75 73 20 28 6f 72 20 28 62 75 74 74 6f 6e .........(setq.focus.(or.(button
75f80 2d 67 65 74 20 28 70 6f 69 6e 74 29 20 27 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 -get.(point).'command)..........
75fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 62 6f 62 70 29 29 ...............(and.(not.(bobp))
75fc0 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 28 62 ..............................(b
75fe0 75 74 74 6f 6e 2d 67 65 74 20 28 31 2d 20 28 70 6f 69 6e 74 29 29 20 27 63 6f 6d 6d 61 6e 64 29 utton-get.(1-.(point)).'command)
76000 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 74 72 61 6e 73 ).........................(trans
76020 69 65 6e 74 2d 2d 68 65 61 64 69 6e 67 2d 61 74 2d 70 6f 69 6e 74 29 29 29 29 0a 20 20 20 20 20 ient--heading-at-point))))......
76040 20 28 65 72 61 73 65 2d 62 75 66 66 65 72 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 .(erase-buffer).......(transient
76060 2d 2d 69 6e 73 65 72 74 2d 6d 65 6e 75 20 73 65 74 75 70 29 29 0a 20 20 20 20 28 75 6e 6c 65 73 --insert-menu.setup)).....(unles
76080 73 20 28 77 69 6e 64 6f 77 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 s.(window-live-p.transient--wind
760a0 6f 77 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f ow).......(setq.transient--windo
760c0 77 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 20 74 72 w.............(display-buffer.tr
760e0 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ansient--buffer.................
76100 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 69 73 70 6c 61 79 2d ............(transient--display-
76120 61 63 74 69 6f 6e 29 29 29 0a 20 20 20 20 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 action))).......(with-selected-w
76140 69 6e 64 6f 77 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 indow.transient--window.........
76160 28 73 65 74 2d 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 74 65 72 20 6e 69 6c 20 27 70 72 65 76 2d (set-window-parameter.nil.'prev-
76180 2d 6e 6f 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -no-other-window................
761a0 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 72 ...............(window-parameter
761c0 20 6e 69 6c 20 27 6e 6f 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 29 29 29 29 0a 20 20 20 20 28 77 .nil.'no-other-window)))).....(w
761e0 68 65 6e 20 28 77 69 6e 64 6f 77 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 hen.(window-live-p.transient--wi
76200 6e 64 6f 77 29 0a 20 20 20 20 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f ndow).......(with-selected-windo
76220 77 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 28 73 65 74 w.transient--window.........(set
76240 2d 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 74 65 72 20 6e 69 6c 20 27 6e 6f 2d 6f 74 68 65 72 2d -window-parameter.nil.'no-other-
76260 77 69 6e 64 6f 77 20 74 29 0a 20 20 20 20 20 20 20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 70 6f window.t).........(goto-char.(po
76280 69 6e 74 2d 6d 69 6e 29 29 0a 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e int-min)).........(when.transien
762a0 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 0a 20 20 20 20 20 20 t-enable-popup-navigation.......
762c0 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 6f 74 6f 2d 62 75 74 74 6f 6e 20 66 6f 63 75 ....(transient--goto-button.focu
762e0 73 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 69 74 2d 77 69 6e 64 s)).........(transient--fit-wind
76300 6f 77 2d 74 6f 2d 62 75 66 66 65 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 29 ow-to-buffer.transient--window))
76320 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 69 73 70 6c 61 79 2d 61 )))..(defun.transient--display-a
76340 63 74 69 6f 6e 20 28 29 0a 20 20 28 6c 65 74 20 28 28 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 ction.()...(let.((action........
76360 20 20 28 63 6f 6e 64 20 28 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 ..(cond.((oref.transient--prefix
76380 20 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .display-action))...............
763a0 20 28 28 6d 65 6d 71 20 27 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 66 75 6c 6c 2d 66 72 61 .((memq.'display-buffer-full-fra
763c0 6d 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 65 6e 73 75 72 65 me.......................(ensure
763e0 2d 6c 69 73 74 20 28 63 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 -list.(car.transient-display-buf
76400 66 65 72 2d 61 63 74 69 6f 6e 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 75 fer-action))).................(u
76420 73 65 72 2d 65 72 72 6f 72 20 22 25 73 20 64 69 73 61 6c 6c 6f 77 65 64 20 69 6e 20 25 73 22 0a ser-error."%s.disallowed.in.%s".
76440 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 27 64 69 73 ............................'dis
76460 70 6c 61 79 2d 62 75 66 66 65 72 2d 66 75 6c 6c 2d 66 72 61 6d 65 0a 20 20 20 20 20 20 20 20 20 play-buffer-full-frame..........
76480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 69 ...................'transient-di
764a0 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 splay-buffer-action))...........
764c0 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 .....(transient-display-buffer-a
764e0 63 74 69 6f 6e 29 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 28 61 73 73 71 20 27 ction)))).....(when.(and.(assq.'
76500 70 6f 70 2d 75 70 2d 66 72 61 6d 65 2d 70 61 72 61 6d 65 74 65 72 73 20 28 63 64 72 20 61 63 74 pop-up-frame-parameters.(cdr.act
76520 69 6f 6e 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 62 6f 75 6e 64 70 20 27 62 ion))................(fboundp.'b
76540 75 66 66 65 72 2d 6c 69 6e 65 2d 73 74 61 74 69 73 74 69 63 73 29 29 20 3b 20 45 6d 61 63 73 20 uffer-line-statistics)).;.Emacs.
76560 3e 3d 20 32 38 2e 31 0a 20 20 20 20 20 20 28 73 65 74 71 20 61 63 74 69 6f 6e 20 28 63 6f 70 79 >=.28.1.......(setq.action.(copy
76580 2d 74 72 65 65 20 61 63 74 69 6f 6e 29 29 0a 20 20 20 20 20 20 28 70 63 61 73 65 2d 6c 65 74 20 -tree.action)).......(pcase-let.
765a0 28 28 60 28 2c 68 65 69 67 68 74 20 2c 77 69 64 74 68 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ((`(,height.,width).............
765c0 20 20 20 20 20 20 20 28 62 75 66 66 65 72 2d 6c 69 6e 65 2d 73 74 61 74 69 73 74 69 63 73 20 74 .......(buffer-line-statistics.t
765e0 72 61 6e 73 69 65 6e 74 2d 2d 62 75 66 66 65 72 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ransient--buffer))..............
76600 20 20 20 20 20 28 70 61 72 61 6d 73 20 28 61 73 73 71 20 27 70 6f 70 2d 75 70 2d 66 72 61 6d 65 .....(params.(assq.'pop-up-frame
76620 2d 70 61 72 61 6d 65 74 65 72 73 20 28 63 64 72 20 61 63 74 69 6f 6e 29 29 29 29 0a 20 20 20 20 -parameters.(cdr.action)))).....
76640 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 74 2d 67 65 74 20 27 68 65 69 67 68 74 20 70 61 72 ....(setf.(alist-get.'height.par
76660 61 6d 73 29 20 68 65 69 67 68 74 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 66 20 28 61 6c 69 73 ams).height).........(setf.(alis
76680 74 2d 67 65 74 20 27 77 69 64 74 68 20 70 61 72 61 6d 73 29 0a 20 20 20 20 20 20 20 20 20 20 20 t-get.'width.params)............
766a0 20 20 20 28 6d 61 78 20 77 69 64 74 68 20 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 6d 69 6e 69 ...(max.width.(or.transient-mini
766c0 6d 61 6c 2d 66 72 61 6d 65 2d 77 69 64 74 68 20 30 29 29 29 29 29 0a 20 20 20 20 61 63 74 69 6f mal-frame-width.0))))).....actio
766e0 6e 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 66 69 74 2d 77 69 6e 64 6f n))..(defun.transient--fit-windo
76700 77 2d 74 6f 2d 62 75 66 66 65 72 20 28 77 69 6e 64 6f 77 29 0a 20 20 28 73 65 74 2d 77 69 6e 64 w-to-buffer.(window)...(set-wind
76720 6f 77 2d 70 61 72 61 6d 65 74 65 72 20 77 69 6e 64 6f 77 20 27 77 69 6e 64 6f 77 2d 70 72 65 73 ow-parameter.window.'window-pres
76740 65 72 76 65 64 2d 73 69 7a 65 20 6e 69 6c 29 0a 20 20 28 6c 65 74 20 28 28 66 69 74 2d 77 69 6e erved-size.nil)...(let.((fit-win
76760 64 6f 77 2d 74 6f 2d 62 75 66 66 65 72 2d 68 6f 72 69 7a 6f 6e 74 61 6c 6c 79 20 74 29 0a 20 20 dow-to-buffer-horizontally.t)...
76780 20 20 20 20 20 20 28 77 69 6e 64 6f 77 2d 72 65 73 69 7a 65 2d 70 69 78 65 6c 77 69 73 65 20 74 ......(window-resize-pixelwise.t
767a0 29 0a 20 20 20 20 20 20 20 20 28 77 69 6e 64 6f 77 2d 73 69 7a 65 2d 66 69 78 65 64 20 6e 69 6c ).........(window-size-fixed.nil
767c0 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 28 6e 6f 74 20 28 77 69 6e 64 6f 77 2d 70 61 72 65 6e )).....(cond.((not.(window-paren
767e0 74 20 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 66 69 74 2d 66 72 61 6d 65 t.window))............(fit-frame
76800 2d 74 6f 2d 62 75 66 66 65 72 20 28 77 69 6e 64 6f 77 2d 66 72 61 6d 65 20 77 69 6e 64 6f 77 29 -to-buffer.(window-frame.window)
76820 20 6e 69 6c 20 6e 69 6c 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .nil.nil.nil....................
76840 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 6d 69 6e 69 6d 61 6c 2d 66 .............transient-minimal-f
76860 72 61 6d 65 2d 77 69 64 74 68 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 65 71 20 28 63 61 72 rame-width))...........((eq.(car
76880 20 28 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 74 65 72 20 77 69 6e 64 6f 77 20 27 71 75 69 74 2d .(window-parameter.window.'quit-
768a0 72 65 73 74 6f 72 65 29 29 20 27 6f 74 68 65 72 29 0a 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 restore)).'other)............;;.
768c0 47 72 6f 77 20 62 75 74 20 6e 65 76 65 72 20 73 68 72 69 6e 6b 20 77 69 6e 64 6f 77 20 74 68 61 Grow.but.never.shrink.window.tha
768e0 74 20 70 72 65 76 69 6f 75 73 6c 79 20 64 69 73 70 6c 61 79 65 64 0a 20 20 20 20 20 20 20 20 20 t.previously.displayed..........
76900 20 20 3b 3b 20 61 6e 6f 74 68 65 72 20 62 75 66 66 65 72 20 61 6e 64 20 69 73 20 67 6f 69 6e 67 ..;;.another.buffer.and.is.going
76920 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 61 74 20 61 67 61 69 6e 2e 0a 20 20 20 20 20 20 20 20 .to.display.that.again..........
76940 20 20 20 28 66 69 74 2d 77 69 6e 64 6f 77 2d 74 6f 2d 62 75 66 66 65 72 20 77 69 6e 64 6f 77 20 ...(fit-window-to-buffer.window.
76960 6e 69 6c 20 28 77 69 6e 64 6f 77 2d 68 65 69 67 68 74 20 77 69 6e 64 6f 77 29 29 29 0a 20 20 20 nil.(window-height.window)))....
76980 20 20 20 20 20 20 20 28 28 66 69 74 2d 77 69 6e 64 6f 77 2d 74 6f 2d 62 75 66 66 65 72 20 77 69 .......((fit-window-to-buffer.wi
769a0 6e 64 6f 77 20 6e 69 6c 20 31 29 29 29 29 0a 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 70 61 72 ndow.nil.1))))...(set-window-par
769c0 61 6d 65 74 65 72 20 77 69 6e 64 6f 77 20 27 77 69 6e 64 6f 77 2d 70 72 65 73 65 72 76 65 64 2d ameter.window.'window-preserved-
769e0 73 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 20 20 28 6c 69 size.........................(li
76a00 73 74 20 28 77 69 6e 64 6f 77 2d 62 75 66 66 65 72 20 77 69 6e 64 6f 77 29 0a 20 20 20 20 20 20 st.(window-buffer.window).......
76a20 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 77 69 6e 64 6f 77 2d ........................(window-
76a40 62 6f 64 79 2d 77 69 64 74 68 20 77 69 6e 64 6f 77 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 body-width.window.t)............
76a60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 69 6e 64 6f 77 2d 62 6f 64 79 2d ...................(window-body-
76a80 68 65 69 67 68 74 20 77 69 6e 64 6f 77 20 74 29 29 29 29 0a 0a 3b 3b 3b 20 44 65 6c 65 74 65 0a height.window.t))))..;;;.Delete.
76aa0 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 6c 65 74 65 2d 77 69 6e 64 6f 77 .(defun.transient--delete-window
76ac0 20 28 29 0a 20 20 28 77 68 65 6e 20 28 77 69 6e 64 6f 77 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 .()...(when.(window-live-p.trans
76ae0 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 0a 20 20 20 20 28 6c 65 74 20 28 28 77 69 6e 20 74 72 61 ient--window).....(let.((win.tra
76b00 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 0a 20 20 20 20 20 20 20 20 20 20 28 72 65 6d 61 69 nsient--window)...........(remai
76b20 6e 2d 69 6e 2d 6d 69 6e 69 62 75 66 66 65 72 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 20 n-in-minibuffer-window..........
76b40 20 20 28 61 6e 64 20 28 6d 69 6e 69 62 75 66 66 65 72 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 ..(and.(minibuffer-selected-wind
76b60 6f 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 6c 65 63 74 65 64 2d 77 69 ow).................(selected-wi
76b80 6e 64 6f 77 29 29 29 29 0a 20 20 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 28 28 65 71 ndow)))).......(cond........((eq
76ba0 20 28 63 61 72 20 28 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 74 65 72 20 77 69 6e 20 27 71 75 69 .(car.(window-parameter.win.'qui
76bc0 74 2d 72 65 73 74 6f 72 65 29 29 20 27 6f 74 68 65 72 29 0a 20 20 20 20 20 20 20 20 3b 3b 20 57 t-restore)).'other).........;;.W
76be0 69 6e 64 6f 77 20 75 73 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 61 6e 6f 74 68 65 72 20 62 75 indow.used.to.display.another.bu
76c00 66 66 65 72 2e 0a 20 20 20 20 20 20 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 ffer..........(set-window-parame
76c20 74 65 72 20 77 69 6e 20 27 6e 6f 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 ter.win.'no-other-window........
76c40 20 20 20 20 20 20 20 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 .......................(window-p
76c60 61 72 61 6d 65 74 65 72 20 77 69 6e 20 27 70 72 65 76 2d 2d 6e 6f 2d 6f 74 68 65 72 2d 77 69 6e arameter.win.'prev--no-other-win
76c80 64 6f 77 29 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 70 61 72 61 6d 65 dow)).........(set-window-parame
76ca0 74 65 72 20 77 69 6e 20 27 70 72 65 76 2d 2d 6e 6f 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 20 6e ter.win.'prev--no-other-window.n
76cc0 69 6c 29 29 0a 20 20 20 20 20 20 20 28 28 77 69 74 68 2d 64 65 6d 6f 74 65 64 2d 65 72 72 6f 72 il))........((with-demoted-error
76ce0 73 20 22 45 72 72 6f 72 20 77 68 69 6c 65 20 65 78 69 74 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 s."Error.while.exiting.transient
76d00 3a 20 25 53 22 0a 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 77 69 6e 64 6f 77 2d 70 61 72 65 :.%S"...........(if.(window-pare
76d20 6e 74 20 77 69 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 6c 65 74 65 2d 77 69 nt.win)...............(delete-wi
76d40 6e 64 6f 77 20 77 69 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 6c 65 74 65 2d 66 72 ndow.win).............(delete-fr
76d60 61 6d 65 20 28 77 69 6e 64 6f 77 2d 66 72 61 6d 65 20 77 69 6e 29 20 74 29 29 29 29 29 0a 20 20 ame.(window-frame.win).t)))))...
76d80 20 20 20 20 28 77 68 65 6e 20 72 65 6d 61 69 6e 2d 69 6e 2d 6d 69 6e 69 62 75 66 66 65 72 2d 77 ....(when.remain-in-minibuffer-w
76da0 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 28 73 65 6c 65 63 74 2d 77 69 6e 64 6f 77 20 72 65 6d indow.........(select-window.rem
76dc0 61 69 6e 2d 69 6e 2d 6d 69 6e 69 62 75 66 66 65 72 2d 77 69 6e 64 6f 77 29 29 29 29 0a 20 20 28 ain-in-minibuffer-window))))...(
76de0 77 68 65 6e 20 28 62 75 66 66 65 72 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 when.(buffer-live-p.transient--b
76e00 75 66 66 65 72 29 0a 20 20 20 20 28 6b 69 6c 6c 2d 62 75 66 66 65 72 20 74 72 61 6e 73 69 65 6e uffer).....(kill-buffer.transien
76e20 74 2d 2d 62 75 66 66 65 72 29 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 2d 62 t--buffer))...(setq.transient--b
76e40 75 66 66 65 72 20 6e 69 6c 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 uffer.nil))..(defun.transient--p
76e60 72 65 73 65 72 76 65 2d 77 69 6e 64 6f 77 2d 70 20 28 26 6f 70 74 69 6f 6e 61 6c 20 6e 6f 68 69 reserve-window-p.(&optional.nohi
76e80 64 65 29 0a 20 20 28 6c 65 74 20 28 28 73 68 6f 77 20 28 69 66 20 6e 6f 68 69 64 65 20 27 66 69 de)...(let.((show.(if.nohide.'fi
76ea0 78 65 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 64 75 72 69 6e 67 2d 6d 69 6e 69 62 75 xed.transient-show-during-minibu
76ec0 66 66 65 72 2d 72 65 61 64 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 28 69 6e 74 ffer-read))).....(when.(and.(int
76ee0 65 67 65 72 70 20 73 68 6f 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 69 6e 64 egerp.show)................(wind
76f00 6f 77 2d 6c 69 76 65 2d 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 0a 20 20 20 ow-live-p.transient--window)....
76f20 20 20 20 20 20 20 20 20 20 20 20 20 28 3c 20 28 66 72 61 6d 65 2d 68 65 69 67 68 74 20 28 77 69 ............(<.(frame-height.(wi
76f40 6e 64 6f 77 2d 66 72 61 6d 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 29 0a 20 ndow-frame.transient--window))..
76f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 2b 20 28 61 62 73 20 73 68 6f 77 29 0a 20 .................(+.(abs.show)..
76f80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 69 6e 64 6f 77 2d 68 65 69 67 ....................(window-heig
76fa0 68 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 29 29 29 29 0a 20 20 20 20 20 20 28 ht.transient--window)))).......(
76fc0 73 65 74 71 20 73 68 6f 77 20 28 6e 61 74 6e 75 6d 70 20 73 68 6f 77 29 29 29 0a 20 20 20 20 73 setq.show.(natnump.show))).....s
76fe0 68 6f 77 29 29 0a 0a 3b 3b 3b 20 46 6f 72 6d 61 74 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 how))..;;;.Format..(defun.transi
77000 65 6e 74 2d 2d 66 6f 72 6d 61 74 2d 68 69 6e 74 20 28 29 0a 20 20 28 69 66 20 28 61 6e 64 20 74 ent--format-hint.()...(if.(and.t
77020 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 6f 70 75 70 20 28 3c 3d 20 74 72 61 6e 73 69 65 6e ransient-show-popup.(<=.transien
77040 74 2d 73 68 6f 77 2d 70 6f 70 75 70 20 30 29 29 0a 20 20 20 20 20 20 28 66 6f 72 6d 61 74 20 22 t-show-popup.0)).......(format."
77060 25 73 2d 22 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 74 68 69 73 2d 63 6f 6d 6d %s-".(key-description.(this-comm
77080 61 6e 64 2d 6b 65 79 73 29 29 29 0a 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 22 25 73 and-keys))).....(format......"%s
770a0 2d 20 5b 25 73 5d 20 25 73 22 0a 20 20 20 20 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e -.[%s].%s"......(key-description
770c0 20 28 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 29 29 0a 20 20 20 20 20 28 6f 72 65 66 .(this-command-keys))......(oref
770e0 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 .transient--prefix.command).....
77100 20 28 6d 61 70 63 6f 6e 63 61 74 0a 20 20 20 20 20 20 23 27 69 64 65 6e 74 69 74 79 0a 20 20 20 .(mapconcat.......#'identity....
77120 20 20 20 28 73 6f 72 74 0a 20 20 20 20 20 20 20 28 6d 61 70 63 61 6e 0a 20 20 20 20 20 20 20 20 ...(sort........(mapcan.........
77140 28 6c 61 6d 62 64 61 20 28 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 (lambda.(suffix)...........(let.
77160 28 28 6b 65 79 20 28 6b 62 64 20 28 6f 72 65 66 20 73 75 66 66 69 78 20 6b 65 79 29 29 29 29 0a ((key.(kbd.(oref.suffix.key)))).
77180 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 44 6f 6e 27 74 20 6c 69 73 74 20 61 6e 79 20 63 6f ............;;.Don't.list.any.co
771a0 6d 6d 6f 6e 20 63 6f 6d 6d 61 6e 64 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 mmon.commands..............(and.
771c0 28 6e 6f 74 20 28 6d 65 6d 71 20 28 6f 72 65 66 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 29 (not.(memq.(oref.suffix.command)
771e0 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 60 28 2c .............................`(,
77200 28 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 20 6b 65 79 29 0a 20 (lookup-key.transient-map.key)..
77220 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 2c 28 6c .............................,(l
77240 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 73 74 69 63 6b 79 2d 6d 61 70 20 6b ookup-key.transient-sticky-map.k
77260 65 79 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 20 20 ey).............................
77280 20 20 3b 3b 20 46 72 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 ..;;.From.transient-common-comma
772a0 6e 64 73 3a 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 nds:............................
772c0 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ...transient-set................
772e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 0a 20 20 ...............transient-save...
77300 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 74 72 61 6e ............................tran
77320 73 69 65 6e 74 2d 68 69 73 74 6f 72 79 2d 70 72 65 76 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 sient-history-prev..............
77340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 73 74 6f .................transient-histo
77360 72 79 2d 6e 65 78 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 ry-next.........................
77380 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e 65 0a 20 20 20 20 20 20 20 ......transient-quit-one........
773a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 .......................transient
773c0 2d 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -toggle-common..................
773e0 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 76 65 6c .............transient-set-level
77400 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 28 70 72 6f 70 )))..................(list.(prop
77420 65 72 74 69 7a 65 20 28 6f 72 65 66 20 73 75 66 66 69 78 20 6b 65 79 29 20 27 66 61 63 65 20 27 ertize.(oref.suffix.key).'face.'
77440 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 74 72 61 6e 73 transient-key))))).........trans
77460 69 65 6e 74 2d 2d 73 75 66 66 69 78 65 73 29 0a 20 20 20 20 20 20 20 23 27 73 74 72 69 6e 67 3c ient--suffixes)........#'string<
77480 29 0a 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 7c 22 20 27 66 61 63 65 20 27 74 ).......(propertize."|".'face.'t
774a0 72 61 6e 73 69 65 6e 74 2d 64 65 6c 69 6d 69 74 65 72 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 ransient-delimiter)))))..(defun.
774c0 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 6d 65 6e 75 20 28 73 65 74 75 70 29 0a 20 transient--insert-menu.(setup)..
774e0 20 28 77 68 65 6e 20 73 65 74 75 70 0a 20 20 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 .(when.setup.....(when.transient
77500 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 -force-fixed-pitch.......(transi
77520 65 6e 74 2d 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 29 29 0a 20 20 20 20 28 77 68 ent--force-fixed-pitch)).....(wh
77540 65 6e 20 28 62 6f 75 6e 64 2d 61 6e 64 2d 74 72 75 65 2d 70 20 74 61 62 2d 6c 69 6e 65 2d 66 6f en.(bound-and-true-p.tab-line-fo
77560 72 6d 61 74 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 74 61 62 2d 6c 69 6e 65 2d 66 6f 72 6d 61 rmat).......(setq.tab-line-forma
77580 74 20 6e 69 6c 29 29 0a 20 20 20 20 28 73 65 74 71 20 68 65 61 64 65 72 2d 6c 69 6e 65 2d 66 6f t.nil)).....(setq.header-line-fo
775a0 72 6d 61 74 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f rmat.nil).....(setq.mode-line-fo
775c0 72 6d 61 74 0a 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 66 6f 72 6d 61 74 20 28 74 72 rmat...........(let.((format.(tr
775e0 61 6e 73 69 65 6e 74 2d 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 29 29 29 0a 20 20 20 ansient--mode-line-format)))....
77600 20 20 20 20 20 20 20 20 20 28 69 66 20 28 6f 72 20 28 6e 61 74 6e 75 6d 70 20 66 6f 72 6d 61 74 .........(if.(or.(natnump.format
77620 29 20 28 65 71 20 66 6f 72 6d 61 74 20 27 6c 69 6e 65 29 29 20 6e 69 6c 20 66 6f 72 6d 61 74 29 ).(eq.format.'line)).nil.format)
77640 29 29 0a 20 20 20 20 28 73 65 74 71 20 6d 6f 64 65 2d 6c 69 6e 65 2d 62 75 66 66 65 72 2d 69 64 )).....(setq.mode-line-buffer-id
77660 65 6e 74 69 66 69 63 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 28 73 79 6d 62 6f 6c 2d 6e entification...........(symbol-n
77680 61 6d 65 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 63 6f 6d 6d ame.(oref.transient--prefix.comm
776a0 61 6e 64 29 29 29 0a 20 20 20 20 28 69 66 20 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d and))).....(if.transient-enable-
776c0 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 2d 6c popup-navigation.........(setq-l
776e0 6f 63 61 6c 20 63 75 72 73 6f 72 2d 69 6e 2d 6e 6f 6e 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 ocal.cursor-in-non-selected-wind
77700 6f 77 73 20 27 62 6f 78 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 63 75 72 73 6f 72 2d 74 79 70 ows.'box).......(setq.cursor-typ
77720 65 20 6e 69 6c 29 29 0a 20 20 20 20 28 73 65 74 71 20 64 69 73 70 6c 61 79 2d 6c 69 6e 65 2d 6e e.nil)).....(setq.display-line-n
77740 75 6d 62 65 72 73 20 6e 69 6c 29 0a 20 20 20 20 28 73 65 74 71 20 73 68 6f 77 2d 74 72 61 69 6c umbers.nil).....(setq.show-trail
77760 69 6e 67 2d 77 68 69 74 65 73 70 61 63 65 20 6e 69 6c 29 0a 20 20 20 20 28 72 75 6e 2d 68 6f 6f ing-whitespace.nil).....(run-hoo
77780 6b 73 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 62 75 66 66 65 72 2d 68 6f 6f 6b 29 ks.'transient-setup-buffer-hook)
777a0 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 73 29 0a 20 )...(transient--insert-groups)..
777c0 20 28 77 68 65 6e 20 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 20 74 72 61 6e .(when.(or.transient--helpp.tran
777e0 73 69 65 6e 74 2d 2d 65 64 69 74 70 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e sient--editp).....(transient--in
77800 73 65 72 74 2d 68 65 6c 70 29 29 0a 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 6c 69 6e 65 20 28 sert-help))...(when-let.((line.(
77820 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 70 61 72 61 74 6f 72 2d 6c 69 6e 65 29 29 29 0a 20 20 20 transient--separator-line)))....
77840 20 28 69 6e 73 65 72 74 20 6c 69 6e 65 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 .(insert.line)))..(defun.transie
77860 6e 74 2d 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 20 28 29 0a 20 20 28 69 66 20 28 73 nt--mode-line-format.()...(if.(s
77880 6c 6f 74 2d 62 6f 75 6e 64 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 27 6d 6f lot-boundp.transient--prefix.'mo
778a0 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 29 0a 20 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e de-line-format).......(oref.tran
778c0 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 29 0a sient--prefix.mode-line-format).
778e0 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 29 29 ....transient-mode-line-format))
77900 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 65 70 61 72 61 74 6f 72 2d 6c 69 ..(defun.transient--separator-li
77920 6e 65 20 28 29 0a 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 66 6f 72 6d 61 74 20 28 74 72 61 6e ne.()...(and-let*.((format.(tran
77940 73 69 65 6e 74 2d 2d 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 29 29 0a 20 20 20 20 20 20 sient--mode-line-format)).......
77960 20 20 20 20 20 20 20 28 68 65 69 67 68 74 20 28 63 6f 6e 64 20 28 28 6e 6f 74 20 77 69 6e 64 6f .......(height.(cond.((not.windo
77980 77 2d 73 79 73 74 65 6d 29 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 w-system).nil)..................
779a0 20 20 20 20 20 20 20 20 20 20 28 28 6e 61 74 6e 75 6d 70 20 66 6f 72 6d 61 74 29 20 66 6f 72 6d ..........((natnump.format).form
779c0 61 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 20 20 20 20 20 28 at)............................(
779e0 28 65 71 20 66 6f 72 6d 61 74 20 27 6c 69 6e 65 29 20 31 29 29 29 0a 20 20 20 20 20 20 20 20 20 (eq.format.'line).1)))..........
77a00 20 20 20 20 28 66 61 63 65 20 60 28 2c 40 28 61 6e 64 20 28 3e 3d 20 65 6d 61 63 73 2d 6d 61 6a ....(face.`(,@(and.(>=.emacs-maj
77a20 6f 72 2d 76 65 72 73 69 6f 6e 20 32 37 29 20 27 28 3a 65 78 74 65 6e 64 20 74 29 29 0a 20 20 20 or-version.27).'(:extend.t))....
77a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 62 61 63 6b 67 72 6f 75 6e 64 20 2c 28 ..................:background.,(
77a60 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 2d 63 6f 6c 6f 72 29 29 29 29 0a 20 20 20 20 transient--prefix-color)))).....
77a80 28 63 6f 6e 63 61 74 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 5f 5f 22 20 27 66 61 63 65 20 66 (concat.(propertize."__".'face.f
77aa0 61 63 65 20 27 64 69 73 70 6c 61 79 20 60 28 73 70 61 63 65 20 3a 68 65 69 67 68 74 20 28 2c 68 ace.'display.`(space.:height.(,h
77ac0 65 69 67 68 74 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 eight))).............(propertize
77ae0 20 22 5c 6e 22 20 27 66 61 63 65 20 66 61 63 65 20 27 6c 69 6e 65 2d 68 65 69 67 68 74 20 74 29 ."\n".'face.face.'line-height.t)
77b00 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 2d 63 6f )))..(defun.transient--prefix-co
77b20 6c 6f 72 20 28 29 0a 20 20 28 6f 72 20 28 66 61 63 65 2d 66 6f 72 65 67 72 6f 75 6e 64 20 28 74 lor.()...(or.(face-foreground.(t
77b40 72 61 6e 73 69 65 6e 74 2d 2d 6b 65 79 2d 66 61 63 65 20 6e 69 6c 20 6e 69 6c 20 27 6e 6f 6e 2d ransient--key-face.nil.nil.'non-
77b60 73 75 66 66 69 78 29 20 6e 69 6c 20 74 29 0a 20 20 20 20 20 20 22 23 67 72 61 79 36 30 22 29 29 suffix).nil.t)......."#gray60"))
77b80 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 73 68 61 64 6f ..(defmacro.transient-with-shado
77ba0 77 65 64 2d 62 75 66 66 65 72 20 28 26 72 65 73 74 20 62 6f 64 79 29 0a 20 20 22 57 68 69 6c 65 wed-buffer.(&rest.body)..."While
77bc0 20 69 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2c 20 74 65 6d 70 6f 72 .in.the.transient.buffer,.tempor
77be0 61 72 69 6c 79 20 6d 61 6b 65 20 74 68 65 20 73 68 61 64 6f 77 65 64 20 62 75 66 66 65 72 20 63 arily.make.the.shadowed.buffer.c
77c00 75 72 72 65 6e 74 2e 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 69 6e 64 65 6e 74 20 30 29 20 28 urrent."...(declare.(indent.0).(
77c20 64 65 62 75 67 20 74 29 29 0a 20 20 60 28 77 69 74 68 2d 63 75 72 72 65 6e 74 2d 62 75 66 66 65 debug.t))...`(with-current-buffe
77c40 72 20 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 r.(or.transient--shadowed-buffer
77c60 20 28 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 0a 20 20 20 20 20 2c 40 62 6f 64 79 29 29 .(current-buffer))......,@body))
77c80 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 ..(defun.transient--insert-group
77ca0 73 20 28 29 0a 20 20 28 6c 65 74 20 28 28 67 72 6f 75 70 73 20 28 6d 61 70 63 61 6e 20 28 6c 61 s.()...(let.((groups.(mapcan.(la
77cc0 6d 62 64 61 20 28 67 72 6f 75 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 mbda.(group)....................
77ce0 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 68 69 64 65 20 28 6f 72 65 66 20 67 72 6f 75 70 20 68 .......(let.((hide.(oref.group.h
77d00 69 64 65 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 20 20 ide)))..........................
77d20 20 20 20 28 61 6e 64 20 28 6e 6f 74 20 28 61 6e 64 20 28 66 75 6e 63 74 69 6f 6e 70 20 68 69 64 ...(and.(not.(and.(functionp.hid
77d40 65 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 20 20 20 e)..............................
77d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 73 68 ..............(transient-with-sh
77d80 61 64 6f 77 65 64 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 adowed-buffer...................
77da0 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 66 75 6e 63 ...........................(func
77dc0 61 6c 6c 20 68 69 64 65 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 all.hide))))....................
77de0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 67 72 6f 75 70 29 29 29 29 0a 20 20 ..............(list.group))))...
77e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d ......................transient-
77e20 2d 6c 61 79 6f 75 74 29 29 29 0a 20 20 20 20 28 77 68 69 6c 65 2d 6c 65 74 20 28 28 67 72 6f 75 -layout))).....(while-let.((grou
77e40 70 20 28 70 6f 70 20 67 72 6f 75 70 73 29 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e p.(pop.groups))).......(transien
77e60 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 67 72 6f 75 70 29 0a 20 20 20 20 20 20 28 77 68 t--insert-group.group).......(wh
77e80 65 6e 20 67 72 6f 75 70 73 0a 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 3f 5c 6e 29 29 29 en.groups.........(insert.?\n)))
77ea0 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 61 63 74 69 76 65 2d 73 75 66 ))..(defun.transient--active-suf
77ec0 66 69 78 65 73 20 28 67 72 6f 75 70 29 0a 20 20 28 73 65 71 2d 72 65 6d 6f 76 65 20 28 6c 61 6d fixes.(group)...(seq-remove.(lam
77ee0 62 64 61 20 28 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e bda.(suffix).................(an
77f00 64 20 28 63 6c 2d 74 79 70 65 70 20 73 75 66 66 69 78 20 27 74 72 61 6e 73 69 65 6e 74 2d 73 75 d.(cl-typep.suffix.'transient-su
77f20 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 ffix)......................(oref
77f40 20 73 75 66 66 69 78 20 69 6e 61 63 74 69 76 65 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 .suffix.inactive))).............
77f60 20 20 28 6f 72 65 66 20 67 72 6f 75 70 20 73 75 66 66 69 78 65 73 29 29 29 0a 0a 28 64 65 66 76 ..(oref.group.suffixes)))..(defv
77f80 61 72 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 78 2d 67 72 6f 75 70 2d 6c 65 76 65 6c 20 31 29 ar.transient--max-group-level.1)
77fa0 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 ..(cl-defgeneric.transient--inse
77fc0 72 74 2d 67 72 6f 75 70 20 28 67 72 6f 75 70 29 0a 20 20 22 46 6f 72 6d 61 74 20 47 52 4f 55 50 rt-group.(group)..."Format.GROUP
77fe0 20 61 6e 64 20 69 74 73 20 65 6c 65 6d 65 6e 74 73 20 61 6e 64 20 69 6e 73 65 72 74 20 74 68 65 .and.its.elements.and.insert.the
78000 20 72 65 73 75 6c 74 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 .result.")..(cl-defmethod.transi
78020 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 3a 61 72 6f 75 6e 64 20 28 28 67 72 6f 75 ent--insert-group.:around.((grou
78040 70 20 74 72 61 6e 73 69 65 6e 74 2d 67 72 6f 75 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 p.transient-group)..............
78060 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 ................................
78080 20 20 26 6f 70 74 69 6f 6e 61 6c 20 5f 29 0a 20 20 22 49 6e 73 65 72 74 20 47 52 4f 55 50 27 73 ..&optional._)..."Insert.GROUP's
780a0 20 64 65 73 63 72 69 70 74 69 6f 6e 2c 20 69 66 20 61 6e 79 2e 22 0a 20 20 28 77 68 65 6e 2d 6c .description,.if.any."...(when-l
780c0 65 74 20 28 28 64 65 73 63 20 28 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 73 68 61 64 6f 77 et.((desc.(transient-with-shadow
780e0 65 64 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 ed-buffer......................(
78100 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 67 72 6f transient-format-description.gro
78120 75 70 29 29 29 29 0a 20 20 20 20 28 69 6e 73 65 72 74 20 64 65 73 63 20 3f 5c 6e 29 29 0a 20 20 up)))).....(insert.desc.?\n))...
78140 28 6c 65 74 20 28 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 78 2d 67 72 6f 75 70 2d 6c 65 76 65 (let.((transient--max-group-leve
78160 6c 0a 20 20 20 20 20 20 20 20 20 28 6d 61 78 20 28 6f 72 65 66 20 67 72 6f 75 70 20 6c 65 76 65 l..........(max.(oref.group.leve
78180 6c 29 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 78 2d 67 72 6f 75 70 2d 6c 65 76 65 6c 29 29 0a l).transient--max-group-level)).
781a0 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 67 72 6f 75 ........(transient--pending-grou
781c0 70 20 67 72 6f 75 70 29 29 0a 20 20 20 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 p.group)).....(cl-call-next-meth
781e0 6f 64 20 67 72 6f 75 70 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 od.group)))..(cl-defmethod.trans
78200 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 28 28 67 72 6f 75 70 20 74 72 61 6e 73 ient--insert-group.((group.trans
78220 69 65 6e 74 2d 72 6f 77 29 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 62 65 2d 70 ient-row))...(transient--maybe-p
78240 61 64 2d 6b 65 79 73 20 67 72 6f 75 70 29 0a 20 20 28 64 6f 6c 69 73 74 20 28 73 75 66 66 69 78 ad-keys.group)...(dolist.(suffix
78260 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 63 74 69 76 65 2d 73 75 66 66 69 78 65 73 20 67 72 6f .(transient--active-suffixes.gro
78280 75 70 29 29 0a 20 20 20 20 28 69 6e 73 65 72 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 up)).....(insert.(transient-with
782a0 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 20 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d -shadowed-buffer.(transient-form
782c0 61 74 20 73 75 66 66 69 78 29 29 29 0a 20 20 20 20 28 69 6e 73 65 72 74 20 22 20 20 20 22 29 29 at.suffix))).....(insert."..."))
782e0 0a 20 20 28 69 6e 73 65 72 74 20 3f 5c 6e 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 ...(insert.?\n))..(cl-defmethod.
78300 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 28 28 67 72 6f 75 70 20 transient--insert-group.((group.
78320 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 transient-column)...............
78340 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 26 6f 70 74 69 6f 6e .........................&option
78360 61 6c 20 73 6b 69 70 2d 65 6d 70 74 79 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 al.skip-empty)...(transient--may
78380 62 65 2d 70 61 64 2d 6b 65 79 73 20 67 72 6f 75 70 29 0a 20 20 28 64 6f 6c 69 73 74 20 28 73 75 be-pad-keys.group)...(dolist.(su
783a0 66 66 69 78 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 63 74 69 76 65 2d 73 75 66 66 69 78 65 73 ffix.(transient--active-suffixes
783c0 20 67 72 6f 75 70 29 29 0a 20 20 20 20 28 6c 65 74 20 28 28 73 74 72 20 28 74 72 61 6e 73 69 65 .group)).....(let.((str.(transie
783e0 6e 74 2d 77 69 74 68 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 20 28 74 72 61 6e 73 69 65 nt-with-shadowed-buffer.(transie
78400 6e 74 2d 66 6f 72 6d 61 74 20 73 75 66 66 69 78 29 29 29 29 0a 20 20 20 20 20 20 28 75 6e 6c 65 nt-format.suffix)))).......(unle
78420 73 73 20 28 61 6e 64 20 28 6e 6f 74 20 73 6b 69 70 2d 65 6d 70 74 79 29 20 28 65 71 75 61 6c 20 ss.(and.(not.skip-empty).(equal.
78440 73 74 72 20 22 22 29 29 0a 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 73 74 72 29 0a 20 20 str."")).........(insert.str)...
78460 20 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 2d 70 20 22 2e ......(unless.(string-match-p.".
78480 5c 6e 5c 5c 27 22 20 73 74 72 29 0a 20 20 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 3f 5c \n\\'".str)...........(insert.?\
784a0 6e 29 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 n))))))..(cl-defmethod.transient
784c0 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 28 28 67 72 6f 75 70 20 74 72 61 6e 73 69 65 6e 74 --insert-group.((group.transient
784e0 2d 63 6f 6c 75 6d 6e 73 29 29 0a 20 20 28 69 66 20 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 66 -columns))...(if.(or.transient-f
78500 6f 72 63 65 2d 73 69 6e 67 6c 65 2d 63 6f 6c 75 6d 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f orce-single-column.transient--do
78520 63 73 70 29 0a 20 20 20 20 20 20 28 64 6f 6c 69 73 74 20 28 67 72 6f 75 70 20 28 6f 72 65 66 20 csp).......(dolist.(group.(oref.
78540 67 72 6f 75 70 20 73 75 66 66 69 78 65 73 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 group.suffixes)).........(transi
78560 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 67 72 6f 75 70 20 74 29 29 0a 20 20 20 20 ent--insert-group.group.t)).....
78580 28 6c 65 74 2a 20 28 28 63 6f 6c 75 6d 6e 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 (let*.((columns.............(map
785a0 63 61 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 63 6f 6c 75 6d 6e car..............(lambda.(column
785c0 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 )................(transient--may
785e0 62 65 2d 70 61 64 2d 6b 65 79 73 20 63 6f 6c 75 6d 6e 20 67 72 6f 75 70 29 0a 20 20 20 20 20 20 be-pad-keys.column.group).......
78600 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 73 68 61 64 6f 77 65 .........(transient-with-shadowe
78620 64 2d 62 75 66 66 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 60 28 2c 40 28 61 d-buffer..................`(,@(a
78640 6e 64 2d 6c 65 74 2a 20 28 28 64 65 73 63 20 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 nd-let*.((desc.(transient-format
78660 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 63 6f 6c 75 6d 6e 29 29 29 0a 20 20 20 20 20 20 20 20 20 -description.column)))..........
78680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 64 65 73 63 29 29 0a 20 20 20 20 20 ..............(list.desc))......
786a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2c 40 28 6c 65 74 20 28 28 74 72 61 6e 73 69 65 6e 74 ..............,@(let.((transient
786c0 2d 2d 70 65 6e 64 69 6e 67 2d 67 72 6f 75 70 20 63 6f 6c 75 6d 6e 29 29 0a 20 20 20 20 20 20 20 --pending-group.column))........
786e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 23 27 74 72 61 6e 73 69 ................(mapcar.#'transi
78700 65 6e 74 2d 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ent-format......................
78720 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 63 74 69 76 65 2d 73 75 66 ..........(transient--active-suf
78740 66 69 78 65 73 20 63 6f 6c 75 6d 6e 29 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 fixes.column))))))..............
78760 28 6f 72 65 66 20 67 72 6f 75 70 20 73 75 66 66 69 78 65 73 29 29 29 0a 20 20 20 20 20 20 20 20 (oref.group.suffixes))).........
78780 20 20 20 28 73 74 6f 70 73 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 63 6f 6c 75 6d 6e 2d 73 74 6f ...(stops.(transient--column-sto
787a0 70 73 20 63 6f 6c 75 6d 6e 73 29 29 29 0a 20 20 20 20 20 20 28 64 6f 6c 69 73 74 20 28 72 6f 77 ps.columns))).......(dolist.(row
787c0 20 28 61 70 70 6c 79 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 70 6e 20 23 27 6c 69 73 74 .(apply.#'transient--mapn.#'list
787e0 20 63 6f 6c 75 6d 6e 73 29 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 73 74 6f 70 73 20 .columns)).........(let.((stops.
78800 73 74 6f 70 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 64 6f 6c 69 73 74 20 28 63 65 6c 6c 20 stops))...........(dolist.(cell.
78820 72 6f 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 73 74 6f 70 20 28 70 6f row).............(let.((stop.(po
78840 70 20 73 74 6f 70 73 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 68 65 6e 20 63 p.stops)))...............(when.c
78860 65 6c 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d ell.................(transient--
78880 61 6c 69 67 6e 2d 74 6f 20 73 74 6f 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 align-to.stop).................(
788a0 69 6e 73 65 72 74 20 63 65 6c 6c 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 69 6e 73 65 72 74 insert.cell))))).........(insert
788c0 20 3f 5c 6e 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 .?\n)))))..(cl-defmethod.transie
788e0 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 28 28 67 72 6f 75 70 20 74 72 61 6e 73 69 65 nt--insert-group.((group.transie
78900 6e 74 2d 73 75 62 67 72 6f 75 70 73 29 29 0a 20 20 28 6c 65 74 20 28 28 73 75 62 67 72 6f 75 70 nt-subgroups))...(let.((subgroup
78920 73 20 28 6f 72 65 66 20 67 72 6f 75 70 20 73 75 66 66 69 78 65 73 29 29 29 0a 20 20 20 20 28 77 s.(oref.group.suffixes))).....(w
78940 68 69 6c 65 2d 6c 65 74 20 28 28 73 75 62 67 72 6f 75 70 20 28 70 6f 70 20 73 75 62 67 72 6f 75 hile-let.((subgroup.(pop.subgrou
78960 70 73 29 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 62 65 2d 70 61 ps))).......(transient--maybe-pa
78980 64 2d 6b 65 79 73 20 73 75 62 67 72 6f 75 70 20 67 72 6f 75 70 29 0a 20 20 20 20 20 20 28 74 72 d-keys.subgroup.group).......(tr
789a0 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 20 73 75 62 67 72 6f 75 70 29 0a ansient--insert-group.subgroup).
789c0 20 20 20 20 20 20 28 77 68 65 6e 20 73 75 62 67 72 6f 75 70 73 0a 20 20 20 20 20 20 20 20 28 69 ......(when.subgroups.........(i
789e0 6e 73 65 72 74 20 3f 5c 6e 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 nsert.?\n)))))..(cl-defgeneric.t
78a00 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 20 28 6f 62 6a 29 0a 20 20 22 46 6f 72 6d 61 74 20 ransient-format.(obj)..."Format.
78a20 61 6e 64 20 72 65 74 75 72 6e 20 4f 42 4a 20 66 6f 72 20 64 69 73 70 6c 61 79 2e 0a 0a 57 68 65 and.return.OBJ.for.display...Whe
78a40 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 n.this.function.is.called,.then.
78a60 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 20 69 73 20 73 6f 6d 65 0a 74 65 6d 70 6f the.current.buffer.is.some.tempo
78a80 72 61 72 79 20 62 75 66 66 65 72 2e 20 20 49 66 20 79 6f 75 20 6e 65 65 64 20 74 68 65 20 62 75 rary.buffer...If.you.need.the.bu
78aa0 66 66 65 72 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 70 72 65 66 69 78 0a 63 6f 6d 6d 61 ffer.from.which.the.prefix.comma
78ac0 6e 64 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 74 6f 20 62 65 20 63 75 72 72 65 6e 74 2c 20 74 68 nd.was.invoked.to.be.current,.th
78ae0 65 6e 20 64 6f 20 73 6f 20 62 79 20 74 65 6d 70 6f 72 61 72 69 6c 79 0a 6d 61 6b 69 6e 67 20 60 en.do.so.by.temporarily.making.`
78b00 74 72 61 6e 73 69 65 6e 74 2d 2d 6f 72 69 67 69 6e 61 6c 2d 62 75 66 66 65 72 27 20 63 75 72 72 transient--original-buffer'.curr
78b20 65 6e 74 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d ent.")..(cl-defmethod.transient-
78b40 66 6f 72 6d 61 74 20 28 28 61 72 67 20 73 74 72 69 6e 67 29 29 0a 20 20 22 52 65 74 75 72 6e 20 format.((arg.string))..."Return.
78b60 74 68 65 20 73 74 72 69 6e 67 20 41 52 47 20 61 66 74 65 72 20 61 70 70 6c 79 69 6e 67 20 74 68 the.string.ARG.after.applying.th
78b80 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 65 61 64 69 6e 67 27 20 66 61 63 65 2e 22 0a 20 20 28 e.`transient-heading'.face."...(
78ba0 70 72 6f 70 65 72 74 69 7a 65 20 61 72 67 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d propertize.arg.'face.'transient-
78bc0 68 65 61 64 69 6e 67 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 heading))..(cl-defmethod.transie
78be0 6e 74 2d 66 6f 72 6d 61 74 20 28 28 5f 20 20 20 6e 75 6c 6c 29 29 0a 20 20 22 52 65 74 75 72 6e nt-format.((_...null))..."Return
78c00 20 61 20 73 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6a 75 73 74 20 74 68 65 20 6e 65 .a.string.containing.just.the.ne
78c20 77 6c 69 6e 65 20 63 68 61 72 61 63 74 65 72 2e 22 0a 20 20 22 5c 6e 22 29 0a 0a 28 63 6c 2d 64 wline.character."..."\n")..(cl-d
78c40 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 20 28 28 61 72 67 20 efmethod.transient-format.((arg.
78c60 69 6e 74 65 67 65 72 29 29 0a 20 20 22 52 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 20 63 6f 6e integer))..."Return.a.string.con
78c80 74 61 69 6e 69 6e 67 20 6a 75 73 74 20 74 68 65 20 41 52 47 20 63 68 61 72 61 63 74 65 72 2e 22 taining.just.the.ARG.character."
78ca0 0a 20 20 28 63 68 61 72 2d 74 6f 2d 73 74 72 69 6e 67 20 61 72 67 29 29 0a 0a 28 63 6c 2d 64 65 ...(char-to-string.arg))..(cl-de
78cc0 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 20 3a 61 72 6f 75 6e 64 fmethod.transient-format.:around
78ce0 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 41 64 64 .((obj.transient-suffix))..."Add
78d00 20 61 64 64 69 74 69 6f 6e 61 6c 20 66 6f 72 6d 61 74 74 69 6e 67 20 69 66 20 61 70 70 72 6f 70 .additional.formatting.if.approp
78d20 72 69 61 74 65 2e 0a 57 68 65 6e 20 72 65 61 64 69 6e 67 20 75 73 65 72 20 69 6e 70 75 74 20 66 riate..When.reading.user.input.f
78d40 6f 72 20 74 68 69 73 20 69 6e 66 69 78 2c 20 74 68 65 6e 20 68 69 67 68 6c 69 67 68 74 20 69 74 or.this.infix,.then.highlight.it
78d60 2e 0a 57 68 65 6e 20 65 64 69 74 2d 6d 6f 64 65 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 ..When.edit-mode.is.enabled,.the
78d80 6e 20 70 72 65 70 65 6e 64 20 74 68 65 20 6c 65 76 65 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e n.prepend.the.level.information.
78da0 0a 57 68 65 6e 20 60 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 .When.`transient-enable-popup-na
78dc0 76 69 67 61 74 69 6f 6e 27 20 69 73 20 6e 6f 6e 2d 6e 69 6c 20 74 68 65 6e 20 66 6f 72 6d 61 74 vigation'.is.non-nil.then.format
78de0 0a 61 73 20 61 20 62 75 74 74 6f 6e 2e 22 0a 20 20 28 6c 65 74 20 28 28 73 74 72 20 28 63 6c 2d .as.a.button."...(let.((str.(cl-
78e00 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 6a 29 29 29 0a 20 20 20 20 28 77 68 65 call-next-method.obj))).....(whe
78e20 6e 20 28 61 6e 64 20 28 63 6c 2d 74 79 70 65 70 20 6f 62 6a 20 27 74 72 61 6e 73 69 65 6e 74 2d n.(and.(cl-typep.obj.'transient-
78e40 69 6e 66 69 78 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 20 28 6f 72 65 66 20 infix)................(eq.(oref.
78e60 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 20 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 obj.command).this-original-comma
78e80 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 63 74 69 76 65 2d 6d 69 6e 69 62 nd)................(active-minib
78ea0 75 66 66 65 72 2d 77 69 6e 64 6f 77 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 73 74 72 20 28 uffer-window)).......(setq.str.(
78ec0 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 65 20 73 74 72 20 27 74 72 61 6e 73 69 65 transient--add-face.str.'transie
78ee0 6e 74 2d 61 63 74 69 76 65 2d 69 6e 66 69 78 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 74 72 61 nt-active-infix))).....(when.tra
78f00 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 0a 20 20 20 20 20 20 28 73 65 74 71 20 73 74 72 20 28 63 nsient--editp.......(setq.str.(c
78f20 6f 6e 63 61 74 20 28 6c 65 74 20 28 28 6c 65 76 65 6c 20 28 6f 72 65 66 20 6f 62 6a 20 6c 65 76 oncat.(let.((level.(oref.obj.lev
78f40 65 6c 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 20 20 20 el)))...........................
78f60 28 70 72 6f 70 65 72 74 69 7a 65 20 28 66 6f 72 6d 61 74 20 22 20 25 73 20 22 20 6c 65 76 65 6c (propertize.(format.".%s.".level
78f80 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 20 20 20 20 )...............................
78fa0 20 20 20 20 20 20 20 20 27 66 61 63 65 20 28 69 66 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 75 73 ........'face.(if.(transient--us
78fc0 65 2d 6c 65 76 65 6c 2d 70 20 6c 65 76 65 6c 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 e-level-p.level.t)..............
78fe0 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 ................................
79000 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 64 2d 73 75 66 66 69 78 0a 20 20 20 ...'transient-enabled-suffix....
79020 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 ................................
79040 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 61 62 6c 65 64 2d 73 ...........'transient-disabled-s
79060 75 66 66 69 78 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 uffix)))........................
79080 20 73 74 72 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 .str))).....(when.(and.transient
790a0 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 -enable-popup-navigation........
790c0 20 20 20 20 20 20 20 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 63 6f 6d 6d 61 6e ........(slot-boundp.obj.'comman
790e0 64 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 73 74 72 20 28 6d 61 6b 65 2d 74 65 78 74 2d 62 d)).......(setq.str.(make-text-b
79100 75 74 74 6f 6e 20 73 74 72 20 6e 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 utton.str.nil...................
79120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 74 79 70 65 20 27 74 72 61 6e 73 69 65 6e 74 ................'type.'transient
79140 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 20 20 ................................
79160 20 20 20 27 73 75 66 66 69 78 20 6f 62 6a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ...'suffix.obj..................
79180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 63 6f 6d 6d 61 6e 64 20 28 6f 72 65 66 20 .................'command.(oref.
791a0 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 29 29 0a 20 20 20 20 73 74 72 29 29 0a 0a 28 63 6c 2d 64 obj.command)))).....str))..(cl-d
791c0 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 20 28 28 6f 62 6a 20 efmethod.transient-format.((obj.
791e0 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 29 0a 20 20 22 52 65 74 75 72 6e 20 61 20 73 74 transient-infix))..."Return.a.st
79200 72 69 6e 67 20 67 65 6e 65 72 61 74 65 64 20 75 73 69 6e 67 20 4f 42 4a 27 73 20 60 66 6f 72 6d ring.generated.using.OBJ's.`form
79220 61 74 27 2e 0a 25 6b 20 69 73 20 66 6f 72 6d 61 74 74 65 64 20 75 73 69 6e 67 20 60 74 72 61 6e at'..%k.is.formatted.using.`tran
79240 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 6b 65 79 27 2e 0a 25 64 20 69 73 20 66 6f 72 6d 61 74 74 sient-format-key'..%d.is.formatt
79260 65 64 20 75 73 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 ed.using.`transient-format-descr
79280 69 70 74 69 6f 6e 27 2e 0a 25 76 20 69 73 20 66 6f 72 6d 61 74 74 65 64 20 75 73 69 6e 67 20 60 iption'..%v.is.formatted.using.`
792a0 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 27 2e 22 0a 20 20 28 66 6f 72 transient-format-value'."...(for
792c0 6d 61 74 2d 73 70 65 63 20 28 6f 72 65 66 20 6f 62 6a 20 66 6f 72 6d 61 74 29 0a 20 20 20 20 20 mat-spec.(oref.obj.format)......
792e0 20 20 20 20 20 20 20 20 20 20 60 28 28 3f 6b 20 2e 20 2c 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f ..........`((?k...,(transient-fo
79300 72 6d 61 74 2d 6b 65 79 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rmat-key.obj))..................
79320 28 3f 64 20 2e 20 2c 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 (?d...,(transient-format-descrip
79340 74 69 6f 6e 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 3f 76 20 tion.obj))..................(?v.
79360 2e 20 2c 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 20 6f 62 6a 29 29 ..,(transient-format-value.obj))
79380 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 )))..(cl-defmethod.transient-for
793a0 6d 61 74 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 mat.((obj.transient-suffix))..."
793c0 52 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 20 67 65 6e 65 72 61 74 65 64 20 75 73 69 6e 67 20 Return.a.string.generated.using.
793e0 4f 42 4a 27 73 20 60 66 6f 72 6d 61 74 27 2e 0a 25 6b 20 69 73 20 66 6f 72 6d 61 74 74 65 64 20 OBJ's.`format'..%k.is.formatted.
79400 75 73 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 6b 65 79 27 2e 0a 25 64 using.`transient-format-key'..%d
79420 20 69 73 20 66 6f 72 6d 61 74 74 65 64 20 75 73 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d 66 .is.formatted.using.`transient-f
79440 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 27 2e 22 0a 20 20 28 66 6f 72 6d 61 74 2d 73 ormat-description'."...(format-s
79460 70 65 63 20 28 6f 72 65 66 20 6f 62 6a 20 66 6f 72 6d 61 74 29 0a 20 20 20 20 20 20 20 20 20 20 pec.(oref.obj.format)...........
79480 20 20 20 20 20 60 28 28 3f 6b 20 2e 20 2c 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d .....`((?k...,(transient-format-
794a0 6b 65 79 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 3f 64 20 2e key.obj))..................(?d..
794c0 20 2c 28 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 .,(transient-format-description.
794e0 6f 62 6a 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 obj)))))..(cl-defgeneric.transie
79500 6e 74 2d 66 6f 72 6d 61 74 2d 6b 65 79 20 28 6f 62 6a 29 0a 20 20 22 46 6f 72 6d 61 74 20 4f 42 nt-format-key.(obj)..."Format.OB
79520 4a 27 73 20 60 6b 65 79 27 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e J's.`key'.for.display.and.return
79540 20 74 68 65 20 72 65 73 75 6c 74 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 .the.result.")..(cl-defmethod.tr
79560 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 6b 65 79 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 ansient-format-key.((obj.transie
79580 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 46 6f 72 6d 61 74 20 4f 42 4a 27 73 20 60 6b 65 79 nt-suffix))..."Format.OBJ's.`key
795a0 27 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 72 65 73 '.for.display.and.return.the.res
795c0 75 6c 74 2e 22 0a 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 69 66 20 28 73 6c 6f 74 2d 62 6f 75 ult."...(let.((key.(if.(slot-bou
795e0 6e 64 70 20 6f 62 6a 20 27 6b 65 79 29 20 28 6f 72 65 66 20 6f 62 6a 20 6b 65 79 29 20 22 22 29 ndp.obj.'key).(oref.obj.key)."")
79600 29 0a 20 20 20 20 20 20 20 20 28 63 6d 64 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 ).........(cmd.(and.(slot-boundp
79620 20 6f 62 6a 20 27 63 6f 6d 6d 61 6e 64 29 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 .obj.'command).(oref.obj.command
79640 29 29 29 29 0a 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 77 69 64 74 68 20 28 6f 72 65 66 )))).....(when-let.((width.(oref
79660 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 67 72 6f 75 70 20 70 61 64 2d 6b 65 .transient--pending-group.pad-ke
79680 79 73 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 6b 65 79 20 28 74 72 75 6e 63 61 74 65 2d ys))).......(setq.key.(truncate-
796a0 73 74 72 69 6e 67 2d 74 6f 2d 77 69 64 74 68 20 6b 65 79 20 77 69 64 74 68 20 6e 69 6c 20 3f 5c string-to-width.key.width.nil.?\
796c0 73 29 29 29 0a 20 20 20 20 28 69 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 s))).....(if.transient--redispla
796e0 79 2d 6b 65 79 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6c 65 6e 20 28 6c 65 6e 67 74 68 y-key.........(let.((len.(length
79700 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 29 0a 20 20 20 20 .transient--redisplay-key)).....
79720 20 20 20 20 20 20 20 20 20 20 28 73 65 71 20 28 63 6c 2d 63 6f 65 72 63 65 20 28 65 64 6d 61 63 ..........(seq.(cl-coerce.(edmac
79740 72 6f 2d 70 61 72 73 65 2d 6b 65 79 73 20 6b 65 79 20 74 29 20 27 6c 69 73 74 29 29 29 0a 20 20 ro-parse-keys.key.t).'list)))...
79760 20 20 20 20 20 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 28 28 6d 65 6d 62 65 ........(cond............((membe
79780 72 20 28 73 65 71 2d 74 61 6b 65 20 73 65 71 20 6c 65 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 r.(seq-take.seq.len)............
797a0 20 20 20 20 20 20 20 20 20 28 6c 69 73 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 .........(list.transient--redisp
797c0 6c 61 79 2d 6b 65 79 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 lay-key.........................
797e0 20 20 28 74 68 72 65 61 64 2d 6c 61 73 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 ..(thread-last.transient--redisp
79800 6c 61 79 2d 6b 65 79 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 lay-key.........................
79820 20 20 20 20 28 63 6c 2d 73 75 62 73 74 69 74 75 74 65 20 3f 2d 20 27 6b 70 2d 73 75 62 74 72 61 ....(cl-substitute.?-.'kp-subtra
79840 63 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 20 20 20 20 20 20 ct).............................
79860 28 63 6c 2d 73 75 62 73 74 69 74 75 74 65 20 3f 3d 20 27 6b 70 2d 65 71 75 61 6c 29 0a 20 20 20 (cl-substitute.?=.'kp-equal)....
79880 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 63 6c 2d 73 75 62 .........................(cl-sub
798a0 73 74 69 74 75 74 65 20 3f 2b 20 27 6b 70 2d 61 64 64 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 stitute.?+.'kp-add))))..........
798c0 20 20 20 28 6c 65 74 20 28 28 70 72 65 20 28 6b 65 79 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 ...(let.((pre.(key-description.(
798e0 76 63 6f 6e 63 61 74 20 28 73 65 71 2d 74 61 6b 65 20 73 65 71 20 6c 65 6e 29 29 29 29 0a 20 20 vconcat.(seq-take.seq.len))))...
79900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 66 20 28 6b 65 79 2d 64 65 73 63 72 69 ................(suf.(key-descri
79920 70 74 69 6f 6e 20 28 76 63 6f 6e 63 61 74 20 28 73 65 71 2d 64 72 6f 70 20 73 65 71 20 6c 65 6e ption.(vconcat.(seq-drop.seq.len
79940 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 70 72 65 20 28 73 )))))...............(setq.pre.(s
79960 74 72 69 6e 67 2d 72 65 70 6c 61 63 65 20 22 52 45 54 22 20 22 43 2d 6d 22 20 70 72 65 29 29 0a tring-replace."RET"."C-m".pre)).
79980 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 70 72 65 20 28 73 74 72 69 6e 67 2d ..............(setq.pre.(string-
799a0 72 65 70 6c 61 63 65 20 22 54 41 42 22 20 22 43 2d 69 22 20 70 72 65 29 29 0a 20 20 20 20 20 20 replace."TAB"."C-i".pre)).......
799c0 20 20 20 20 20 20 20 20 28 73 65 74 71 20 73 75 66 20 28 73 74 72 69 6e 67 2d 72 65 70 6c 61 63 ........(setq.suf.(string-replac
799e0 65 20 22 52 45 54 22 20 22 43 2d 6d 22 20 73 75 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 e."RET"."C-m".suf)).............
79a00 20 20 28 73 65 74 71 20 73 75 66 20 28 73 74 72 69 6e 67 2d 72 65 70 6c 61 63 65 20 22 54 41 42 ..(setq.suf.(string-replace."TAB
79a20 22 20 22 43 2d 69 22 20 73 75 66 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 57 "."C-i".suf))...............;;.W
79a40 65 20 75 73 65 20 65 2e 67 2e 2c 20 22 2d 6b 22 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 e.use.e.g.,."-k".instead.of.the.
79a60 6d 6f 72 65 20 63 6f 72 72 65 63 74 20 22 2d 20 6b 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 more.correct."-.k",.............
79a80 20 20 3b 3b 20 62 65 63 61 75 73 65 20 74 68 65 20 66 6f 72 6d 65 72 20 69 73 20 70 72 65 74 74 ..;;.because.the.former.is.prett
79aa0 69 65 72 2e 20 20 49 66 20 77 65 20 64 69 64 20 74 68 61 74 20 69 6e 0a 20 20 20 20 20 20 20 20 ier...If.we.did.that.in.........
79ac0 20 20 20 20 20 20 3b 3b 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20 74 68 65 6e 20 77 65 ......;;.the.definition,.then.we
79ae0 20 77 61 6e 74 20 74 6f 20 64 72 6f 70 20 74 68 65 20 73 70 61 63 65 20 74 68 61 74 0a 20 20 20 .want.to.drop.the.space.that....
79b00 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 69 73 20 72 65 69 6e 73 65 72 74 65 64 20 61 62 6f 76 ...........;;.is.reinserted.abov
79b20 65 2e 20 20 46 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 73 20 61 72 65 20 70 6f 73 73 69 62 6c 65 e...False-positives.are.possible
79b40 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 66 6f 72 20 73 69 6c 6c 79 20 62 69 6e 64 ...............;;.for.silly.bind
79b60 69 6e 67 73 20 6c 69 6b 65 20 22 2d 43 2d 63 20 43 2d 63 22 2e 0a 20 20 20 20 20 20 20 20 20 20 ings.like."-C-c.C-c"............
79b80 20 20 20 20 28 75 6e 6c 65 73 73 20 28 73 74 72 69 6e 67 2d 73 65 61 72 63 68 20 22 20 22 20 6b ....(unless.(string-search.".".k
79ba0 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 70 72 65 20 28 73 ey).................(setq.pre.(s
79bc0 74 72 69 6e 67 2d 72 65 70 6c 61 63 65 20 22 20 22 20 22 22 20 70 72 65 29 29 0a 20 20 20 20 20 tring-replace."."."".pre))......
79be0 20 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 73 75 66 20 28 73 74 72 69 6e 67 2d 72 65 70 ...........(setq.suf.(string-rep
79c00 6c 61 63 65 20 22 20 22 20 22 22 20 73 75 66 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 lace."."."".suf)))..............
79c20 20 28 63 6f 6e 63 61 74 20 28 70 72 6f 70 65 72 74 69 7a 65 20 70 72 65 20 27 66 61 63 65 20 27 .(concat.(propertize.pre.'face.'
79c40 74 72 61 6e 73 69 65 6e 74 2d 75 6e 72 65 61 63 68 61 62 6c 65 2d 6b 65 79 29 0a 20 20 20 20 20 transient-unreachable-key)......
79c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 73 74 72 69 6e 67 2d 70 72 .................(and.(string-pr
79c80 65 66 69 78 2d 70 20 28 63 6f 6e 63 61 74 20 70 72 65 20 22 20 22 29 20 6b 65 79 29 20 22 20 22 efix-p.(concat.pre.".").key)."."
79ca0 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 70 72 6f 70 65 72 74 ).......................(propert
79cc0 69 7a 65 20 73 75 66 20 27 66 61 63 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6b 65 79 2d 66 61 ize.suf.'face.(transient--key-fa
79ce0 63 65 20 63 6d 64 20 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ce.cmd.key))....................
79d00 20 20 20 28 73 61 76 65 2d 65 78 63 75 72 73 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...(save-excursion..............
79d20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 20 ...........(and.(string-match.".
79d40 2b 5c 5c 27 22 20 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 +\\'".key)......................
79d60 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 6d 61 74 63 68 2d 73 74 72 69 6e ........(propertize.(match-strin
79d80 67 20 30 20 6b 65 79 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 g.0.key)........................
79da0 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 66 69 78 65 64 2d 70 ..................'face.'fixed-p
79dc0 69 74 63 68 29 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 28 74 72 61 6e 73 69 65 6e itch))))))............((transien
79de0 74 2d 2d 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 65 6e 74 2d 73 74 69 63 6b 79 2d 6d t--lookup-key.transient-sticky-m
79e00 61 70 20 28 6b 62 64 20 6b 65 79 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 ap.(kbd.key)).............(prope
79e20 72 74 69 7a 65 20 6b 65 79 20 27 66 61 63 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6b 65 79 2d rtize.key.'face.(transient--key-
79e40 66 61 63 65 20 63 6d 64 20 6b 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 74 0a 20 20 face.cmd.key)))............(t...
79e60 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 6b 65 79 20 27 66 61 63 65 20 ..........(propertize.key.'face.
79e80 27 74 72 61 6e 73 69 65 6e 74 2d 75 6e 72 65 61 63 68 61 62 6c 65 2d 6b 65 79 29 29 29 29 0a 20 'transient-unreachable-key))))..
79ea0 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 6b 65 79 20 27 66 61 63 65 20 28 74 72 61 6e .....(propertize.key.'face.(tran
79ec0 73 69 65 6e 74 2d 2d 6b 65 79 2d 66 61 63 65 20 63 6d 64 20 6b 65 79 29 29 29 29 29 0a 0a 28 63 sient--key-face.cmd.key)))))..(c
79ee0 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 6b 65 79 l-defmethod.transient-format-key
79f00 20 3a 61 72 6f 75 6e 64 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e .:around.((obj.transient-argumen
79f20 74 29 29 0a 20 20 22 48 61 6e 64 6c 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 t))..."Handle.`transient-highlig
79f40 68 74 2d 6d 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 73 27 2e 22 0a 20 20 28 6c 65 74 20 28 28 6b ht-mismatched-keys'."...(let.((k
79f60 65 79 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 6a 29 29 29 0a 20 ey.(cl-call-next-method.obj)))..
79f80 20 20 20 28 63 6f 6e 64 0a 20 20 20 20 20 28 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 ...(cond......((not.transient-hi
79fa0 67 68 6c 69 67 68 74 2d 6d 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 73 29 20 6b 65 79 29 0a 20 20 ghlight-mismatched-keys).key)...
79fc0 20 20 20 28 28 6e 6f 74 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 73 68 6f 72 74 ...((not.(slot-boundp.obj.'short
79fe0 61 72 67 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 65 arg)).......(transient--add-face
7a000 20 6b 65 79 20 27 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 73 74 61 6e 64 61 72 64 2d 6b 65 79 29 .key.'transient-nonstandard-key)
7a020 29 0a 20 20 20 20 20 28 28 6e 6f 74 20 28 73 74 72 69 6e 67 2d 65 71 75 61 6c 20 6b 65 79 20 28 )......((not.(string-equal.key.(
7a040 6f 72 65 66 20 6f 62 6a 20 73 68 6f 72 74 61 72 67 29 29 29 0a 20 20 20 20 20 20 28 74 72 61 6e oref.obj.shortarg))).......(tran
7a060 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 65 20 6b 65 79 20 27 74 72 61 6e 73 69 65 6e 74 2d 6d sient--add-face.key.'transient-m
7a080 69 73 6d 61 74 63 68 65 64 2d 6b 65 79 29 29 0a 20 20 20 20 20 28 6b 65 79 29 29 29 29 0a 0a 28 ismatched-key))......(key))))..(
7a0a0 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 cl-defgeneric.transient-format-d
7a0c0 65 73 63 72 69 70 74 69 6f 6e 20 28 6f 62 6a 29 0a 20 20 22 46 6f 72 6d 61 74 20 4f 42 4a 27 73 escription.(obj)..."Format.OBJ's
7a0e0 20 60 64 65 73 63 72 69 70 74 69 6f 6e 27 20 66 6f 72 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 .`description'.for.display.and.r
7a100 65 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 eturn.the.result.")..(cl-defmeth
7a120 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 od.transient-format-description.
7a140 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 22 54 68 65 20 ((obj.transient-suffix))..."The.
7a160 60 64 65 73 63 72 69 70 74 69 6f 6e 27 20 73 6c 6f 74 20 6d 61 79 20 62 65 20 61 20 66 75 6e 63 `description'.slot.may.be.a.func
7a180 74 69 6f 6e 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 61 74 20 69 73 0a 63 61 6c 6c tion,.in.which.case.that.is.call
7a1a0 65 64 20 69 6e 73 69 64 65 20 74 68 65 20 63 6f 72 72 65 63 74 20 62 75 66 66 65 72 20 28 73 65 ed.inside.the.correct.buffer.(se
7a1c0 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 27 29 0a 61 6e 64 e.`transient--insert-group').and
7a1e0 20 69 74 73 20 76 61 6c 75 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65 20 63 61 .its.value.is.returned.to.the.ca
7a200 6c 6c 65 72 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 64 65 73 63 72 69 70 ller."...(transient--get-descrip
7a220 74 69 6f 6e 20 6f 62 6a 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 tion.obj))..(cl-defmethod.transi
7a240 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 28 6f 62 6a 20 74 72 61 ent-format-description.((obj.tra
7a260 6e 73 69 65 6e 74 2d 76 61 6c 75 65 2d 70 72 65 73 65 74 29 29 0a 20 20 28 70 63 61 73 65 2d 6c nsient-value-preset))...(pcase-l
7a280 65 74 2a 20 28 28 28 65 69 65 69 6f 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6b 65 79 20 73 65 74 et*.(((eieio.description.key.set
7a2a0 29 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 65 69 65 69 6f 20 76 61 ).obj)................((eieio.va
7a2c0 6c 75 65 29 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 0a 20 20 20 20 20 20 20 20 lue).transient--prefix).........
7a2e0 20 20 20 20 20 20 20 28 61 63 74 69 76 65 20 28 73 65 71 2d 73 65 74 2d 65 71 75 61 6c 2d 70 20 .......(active.(seq-set-equal-p.
7a300 73 65 74 20 76 61 6c 75 65 29 29 29 0a 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 22 25 set.value))).....(format......"%
7a320 73 20 25 73 22 0a 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 6f 72 20 64 65 73 63 72 s.%s"......(propertize.(or.descr
7a340 69 70 74 69 6f 6e 20 28 66 6f 72 6d 61 74 20 22 50 72 65 73 65 74 20 25 73 22 20 6b 65 79 29 29 iption.(format."Preset.%s".key))
7a360 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 61 63 65 20 28 61 6e 64 20 61 63 74 ..................'face.(and.act
7a380 69 76 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 28 ive.'transient-argument))......(
7a3a0 66 6f 72 6d 61 74 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 28 25 73 29 22 20 27 66 61 63 65 20 format.(propertize."(%s)".'face.
7a3c0 27 74 72 61 6e 73 69 65 6e 74 2d 64 65 6c 69 6d 69 74 65 72 29 0a 20 20 20 20 20 20 20 20 20 20 'transient-delimiter)...........
7a3e0 20 20 20 28 6d 61 70 63 6f 6e 63 61 74 20 28 6c 61 6d 62 64 61 20 28 61 72 67 29 0a 20 20 20 20 ...(mapconcat.(lambda.(arg).....
7a400 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a ......................(propertiz
7a420 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 20 20 20 20 61 72 67 e............................arg
7a440 20 27 66 61 63 65 20 28 63 6f 6e 64 20 28 61 63 74 69 76 65 20 27 74 72 61 6e 73 69 65 6e 74 2d .'face.(cond.(active.'transient-
7a460 61 72 67 75 6d 65 6e 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 argument).......................
7a480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6d 65 6d 62 65 72 20 61 72 .....................((member.ar
7a4a0 67 20 76 61 6c 75 65 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 g.value)........................
7a4c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 28 28 3a 77 65 69 67 68 74 20 .....................'((:weight.
7a4e0 64 65 6d 69 62 6f 6c 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 demibold).......................
7a500 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e ........................transien
7a520 74 2d 69 6e 61 63 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 t-inactive-argument))...........
7a540 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 ................................
7a560 20 28 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 29 29 .('transient-inactive-argument))
7a580 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 73 65 74 20 22 )).........................set."
7a5a0 20 22 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 .")))))..(cl-defmethod.transient
7a5c0 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 -format-description.((obj.transi
7a5e0 65 6e 74 2d 67 72 6f 75 70 29 29 0a 20 20 22 46 6f 72 6d 61 74 20 74 68 65 20 64 65 73 63 72 69 ent-group))..."Format.the.descri
7a600 70 74 69 6f 6e 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 6e 65 78 74 20 6d 65 74 68 6f 64 ption.by.calling.the.next.method
7a620 2e 0a 49 66 20 74 68 65 20 72 65 73 75 6c 74 20 64 6f 65 73 6e 27 74 20 75 73 65 20 74 68 65 20 ..If.the.result.doesn't.use.the.
7a640 60 66 61 63 65 27 20 70 72 6f 70 65 72 74 79 20 61 74 20 61 6c 6c 2c 20 74 68 65 6e 20 61 70 70 `face'.property.at.all,.then.app
7a660 6c 79 20 74 68 65 0a 66 61 63 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 68 65 61 64 69 6e 67 27 20 ly.the.face.`transient-heading'.
7a680 74 6f 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 73 74 72 69 6e 67 2e 22 0a 20 20 28 61 6e 64 2d to.the.complete.string."...(and-
7a6a0 6c 65 74 2a 20 28 28 64 65 73 63 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 64 65 73 63 let*.((desc.(transient--get-desc
7a6c0 72 69 70 74 69 6f 6e 20 6f 62 6a 29 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 28 6f 72 65 66 20 ription.obj))).....(cond.((oref.
7a6e0 6f 62 6a 20 69 6e 61 70 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a obj.inapt)............(propertiz
7a700 65 20 64 65 73 63 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 2d 73 75 e.desc.'face.'transient-inapt-su
7a720 66 66 69 78 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 74 65 78 74 2d 70 72 6f 70 65 72 74 79 ffix))...........((text-property
7a740 2d 6e 6f 74 2d 61 6c 6c 20 30 20 28 6c 65 6e 67 74 68 20 64 65 73 63 29 20 27 66 61 63 65 20 6e -not-all.0.(length.desc).'face.n
7a760 69 6c 20 64 65 73 63 29 0a 20 20 20 20 20 20 20 20 20 20 20 64 65 73 63 29 0a 20 20 20 20 20 20 il.desc)............desc).......
7a780 20 20 20 20 28 28 70 72 6f 70 65 72 74 69 7a 65 20 64 65 73 63 20 27 66 61 63 65 20 27 74 72 61 ....((propertize.desc.'face.'tra
7a7a0 6e 73 69 65 6e 74 2d 68 65 61 64 69 6e 67 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 nsient-heading)))))..(cl-defmeth
7a7c0 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 od.transient-format-description.
7a7e0 3a 61 72 6f 75 6e 64 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 :around.((obj.transient-suffix))
7a800 0a 20 20 22 46 6f 72 6d 61 74 20 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 62 79 20 63 61 ..."Format.the.description.by.ca
7a820 6c 6c 69 6e 67 20 74 68 65 20 6e 65 78 74 20 6d 65 74 68 6f 64 2e 0a 49 66 20 74 68 65 20 72 65 lling.the.next.method..If.the.re
7a840 73 75 6c 74 20 69 73 20 6e 69 6c 2c 20 74 68 65 6e 20 75 73 65 20 5c 22 28 42 55 47 3a 20 6e 6f sult.is.nil,.then.use.\"(BUG:.no
7a860 20 64 65 73 63 72 69 70 74 69 6f 6e 29 5c 22 20 61 73 20 74 68 65 0a 64 65 73 63 72 69 70 74 69 .description)\".as.the.descripti
7a880 6f 6e 2e 20 20 49 66 20 74 68 65 20 4f 42 4a 27 73 20 60 6b 65 79 27 20 69 73 20 63 75 72 72 65 on...If.the.OBJ's.`key'.is.curre
7a8a0 6e 74 6c 79 20 75 6e 72 65 61 63 68 61 62 6c 65 2c 20 74 68 65 6e 0a 61 70 70 6c 79 20 74 68 65 ntly.unreachable,.then.apply.the
7a8c0 20 66 61 63 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 75 6e 72 65 61 63 68 61 62 6c 65 27 20 74 6f .face.`transient-unreachable'.to
7a8e0 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 73 74 72 69 6e 67 2e 22 0a 20 20 28 6c 65 74 20 28 28 .the.complete.string."...(let.((
7a900 64 65 73 63 20 28 6f 72 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 desc.(or.(cl-call-next-method.ob
7a920 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 28 73 6c 6f 74 2d j)...................(and.(slot-
7a940 62 6f 75 6e 64 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 27 73 75 66 66 69 78 boundp.transient--prefix.'suffix
7a960 2d 64 65 73 63 72 69 70 74 69 6f 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 -description)...................
7a980 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 .....(funcall.(oref.transient--p
7a9a0 72 65 66 69 78 20 73 75 66 66 69 78 2d 64 65 73 63 72 69 70 74 69 6f 6e 29 0a 20 20 20 20 20 20 refix.suffix-description).......
7a9c0 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 6f 62 6a 29 29 29 ..........................obj)))
7a9e0 29 29 0a 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 2a 20 28 28 5f 20 74 72 61 6e 73 69 65 6e 74 2d )).....(when-let*.((_.transient-
7aa00 2d 64 6f 63 73 70 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 73 6c 6f 74 2d -docsp).................(_(slot-
7aa20 62 6f 75 6e 64 70 20 6f 62 6a 20 27 63 6f 6d 6d 61 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 boundp.obj.'command))...........
7aa40 20 20 20 20 20 20 28 63 6d 64 20 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 0a 20 ......(cmd.(oref.obj.command))..
7aa60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 6e 6f 74 20 28 6d 65 6d 71 20 27 74 72 61 ...............(_(not.(memq.'tra
7aa80 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e 66 69 78 2d 63 6f 6d 6d 61 6e 64 0a 20 20 nsient--default-infix-command...
7aaa0 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 66 75 6e 63 ...........................(func
7aac0 74 69 6f 6e 2d 61 6c 69 61 73 2d 70 20 63 6d 64 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 tion-alias-p.cmd))))............
7aae0 20 20 20 20 20 28 64 6f 63 73 74 72 20 28 69 67 6e 6f 72 65 2d 65 72 72 6f 72 73 20 28 64 6f 63 .....(docstr.(ignore-errors.(doc
7ab00 75 6d 65 6e 74 61 74 69 6f 6e 20 63 6d 64 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 umentation.cmd)))...............
7ab20 20 20 28 64 6f 63 73 74 72 20 28 73 74 72 69 6e 67 2d 74 72 69 6d 0a 20 20 20 20 20 20 20 20 20 ..(docstr.(string-trim..........
7ab40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 62 73 74 72 69 6e 67 20 64 6f 63 73 74 ................(substring.docst
7ab60 72 20 30 20 28 73 74 72 69 6e 67 2d 6d 61 74 63 68 20 22 5c 5c 2e 3f 5c 6e 22 20 64 6f 63 73 74 r.0.(string-match."\\.?\n".docst
7ab80 72 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 5f 28 6e 6f 74 20 28 65 71 r)))).................(_(not.(eq
7aba0 75 61 6c 20 64 6f 63 73 74 72 20 22 22 29 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 64 65 ual.docstr."")))).......(setq.de
7abc0 73 63 20 28 66 6f 72 6d 61 74 2d 73 70 65 63 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 64 sc.(format-spec.transient-show-d
7abe0 6f 63 73 74 72 69 6e 67 2d 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ocstring-format.................
7ac00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 60 28 28 3f 63 20 2e 20 2c 64 65 73 63 29 0a 20 20 20 ..............`((?c...,desc)....
7ac20 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 3f 73 .............................(?s
7ac40 20 2e 20 2c 64 6f 63 73 74 72 29 29 29 29 29 0a 20 20 20 20 28 69 66 20 64 65 73 63 0a 20 20 20 ...,docstr))))).....(if.desc....
7ac60 20 20 20 20 20 28 77 68 65 6e 2d 6c 65 74 20 28 28 66 61 63 65 20 28 74 72 61 6e 73 69 65 6e 74 .....(when-let.((face.(transient
7ac80 2d 2d 67 65 74 2d 66 61 63 65 20 6f 62 6a 20 27 66 61 63 65 29 29 29 0a 20 20 20 20 20 20 20 20 --get-face.obj.'face))).........
7aca0 20 20 28 73 65 74 71 20 64 65 73 63 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 ..(setq.desc.(transient--add-fac
7acc0 65 20 64 65 73 63 20 66 61 63 65 20 74 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 64 65 73 e.desc.face.t))).......(setq.des
7ace0 63 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 28 42 55 47 3a 20 6e 6f 20 64 65 73 63 72 69 70 74 c.(propertize."(BUG:.no.descript
7ad00 69 6f 6e 29 22 20 27 66 61 63 65 20 27 65 72 72 6f 72 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 ion)".'face.'error))).....(when.
7ad20 28 69 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 61 6c 6c 2d 6c 65 76 65 6c 73 2d 70 0a 20 20 20 20 (if.transient--all-levels-p.....
7ad40 20 20 20 20 20 20 20 20 20 20 28 3e 20 28 6f 72 65 66 20 6f 62 6a 20 6c 65 76 65 6c 29 20 74 72 ..........(>.(oref.obj.level).tr
7ad60 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 70 72 65 66 69 78 2d 6c 65 76 65 6c 29 0a 20 ansient--default-prefix-level)..
7ad80 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 ...........(and.transient-highli
7ada0 67 68 74 2d 68 69 67 68 65 72 2d 6c 65 76 65 6c 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ght-higher-levels...............
7adc0 20 20 20 28 3e 20 28 6d 61 78 20 28 6f 72 65 66 20 6f 62 6a 20 6c 65 76 65 6c 29 20 74 72 61 6e ...(>.(max.(oref.obj.level).tran
7ade0 73 69 65 6e 74 2d 2d 6d 61 78 2d 67 72 6f 75 70 2d 6c 65 76 65 6c 29 0a 20 20 20 20 20 20 20 20 sient--max-group-level).........
7ae00 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 70 ............transient--default-p
7ae20 72 65 66 69 78 2d 6c 65 76 65 6c 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 64 65 73 63 20 refix-level))).......(setq.desc.
7ae40 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 65 20 64 65 73 63 20 27 74 72 61 6e 73 (transient--add-face.desc.'trans
7ae60 69 65 6e 74 2d 68 69 67 68 65 72 2d 6c 65 76 65 6c 29 29 29 0a 20 20 20 20 28 77 68 65 6e 2d 6c ient-higher-level))).....(when-l
7ae80 65 74 20 28 28 69 6e 61 70 74 2d 66 61 63 65 20 28 61 6e 64 20 28 6f 72 65 66 20 6f 62 6a 20 69 et.((inapt-face.(and.(oref.obj.i
7aea0 6e 61 70 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 20 20 20 20 napt)...........................
7aec0 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 66 61 63 65 20 6f 62 6a 20 27 ......(transient--get-face.obj.'
7aee0 69 6e 61 70 74 2d 66 61 63 65 29 29 29 29 0a 20 20 20 20 20 20 28 73 65 74 71 20 64 65 73 63 20 inapt-face)))).......(setq.desc.
7af00 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 65 20 64 65 73 63 20 69 6e 61 70 74 2d (transient--add-face.desc.inapt-
7af20 66 61 63 65 29 29 29 0a 20 20 20 20 28 77 68 65 6e 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 face))).....(when.(and.(slot-bou
7af40 6e 64 70 20 6f 62 6a 20 27 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 ndp.obj.'key)................(tr
7af60 61 6e 73 69 65 6e 74 2d 2d 6b 65 79 2d 75 6e 72 65 61 63 68 61 62 6c 65 2d 70 20 6f 62 6a 29 29 ansient--key-unreachable-p.obj))
7af80 0a 20 20 20 20 20 20 28 73 65 74 71 20 64 65 73 63 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 .......(setq.desc.(transient--ad
7afa0 64 2d 66 61 63 65 20 64 65 73 63 20 27 74 72 61 6e 73 69 65 6e 74 2d 75 6e 72 65 61 63 68 61 62 d-face.desc.'transient-unreachab
7afc0 6c 65 29 29 29 0a 20 20 20 20 64 65 73 63 29 29 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 le))).....desc))..(cl-defgeneric
7afe0 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 20 28 6f 62 6a 29 0a 20 20 .transient-format-value.(obj)...
7b000 22 46 6f 72 6d 61 74 20 4f 42 4a 27 73 20 76 61 6c 75 65 20 66 6f 72 20 64 69 73 70 6c 61 79 20 "Format.OBJ's.value.for.display.
7b020 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 22 29 0a 0a 28 63 6c 2d 64 65 and.return.the.result.")..(cl-de
7b040 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 20 28 fmethod.transient-format-value.(
7b060 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 29 0a 20 20 28 70 72 6f 70 65 (obj.transient-suffix))...(prope
7b080 72 74 69 7a 65 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 0a 20 20 20 20 20 20 rtize.(oref.obj.argument).......
7b0a0 20 20 20 20 20 20 20 20 27 66 61 63 65 20 28 69 66 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 6c 75 ........'face.(if.(oref.obj.valu
7b0c0 65 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 69 66 20 28 e).........................(if.(
7b0e0 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 oref.obj.inapt).................
7b100 20 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 2d 61 72 67 ............'transient-inapt-arg
7b120 75 6d 65 6e 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 ument...........................
7b140 27 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 'transient-argument)............
7b160 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 61 ...........'transient-inactive-a
7b180 72 67 75 6d 65 6e 74 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 rgument)))..(cl-defmethod.transi
7b1a0 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 ent-format-value.((obj.transient
7b1c0 2d 6f 70 74 69 6f 6e 29 29 0a 20 20 28 6c 65 74 20 28 28 61 72 67 75 6d 65 6e 74 20 28 70 72 69 -option))...(let.((argument.(pri
7b1e0 6e 31 2d 74 6f 2d 73 74 72 69 6e 67 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 n1-to-string.(oref.obj.argument)
7b200 20 74 29 29 29 0a 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 76 61 6c 75 65 20 28 6f 72 65 66 20 .t))).....(if-let.((value.(oref.
7b220 6f 62 6a 20 76 61 6c 75 65 29 29 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 2a 20 28 28 69 6e 61 obj.value))).........(let*.((ina
7b240 70 74 20 28 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 pt.(oref.obj.inapt))............
7b260 20 20 20 20 28 61 66 61 63 65 20 28 69 66 20 69 6e 61 70 74 20 27 74 72 61 6e 73 69 65 6e 74 2d ....(aface.(if.inapt.'transient-
7b280 69 6e 61 70 74 2d 61 72 67 75 6d 65 6e 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 inapt-argument.'transient-argume
7b2a0 6e 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 76 66 61 63 65 20 28 69 66 20 69 nt))................(vface.(if.i
7b2c0 6e 61 70 74 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 2d 61 72 67 75 6d 65 6e 74 20 27 napt.'transient-inapt-argument.'
7b2e0 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 70 63 transient-value)))...........(pc
7b300 61 73 65 2d 65 78 68 61 75 73 74 69 76 65 20 28 6f 72 65 66 20 6f 62 6a 20 6d 75 6c 74 69 2d 76 ase-exhaustive.(oref.obj.multi-v
7b320 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 27 6e 69 6c 0a 20 20 20 20 20 20 20 20 alue).............('nil.........
7b340 20 20 20 20 20 28 63 6f 6e 63 61 74 20 28 70 72 6f 70 65 72 74 69 7a 65 20 61 72 67 75 6d 65 6e .....(concat.(propertize.argumen
7b360 74 20 27 66 61 63 65 20 61 66 61 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t.'face.aface)..................
7b380 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 76 61 6c 75 65 20 20 20 20 27 66 61 63 65 20 76 ....(propertize.value....'face.v
7b3a0 66 61 63 65 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 28 6f 72 20 27 74 20 27 72 65 73 face))).............((or.'t.'res
7b3c0 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 63 61 74 20 28 70 72 6f 70 65 72 74 t)..............(concat.(propert
7b3e0 69 7a 65 20 28 69 66 20 28 73 74 72 69 6e 67 2d 73 75 66 66 69 78 2d 70 20 22 20 22 20 61 72 67 ize.(if.(string-suffix-p.".".arg
7b400 75 6d 65 6e 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 20 20 20 ument)..........................
7b420 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 75 6d 65 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 ............argument............
7b440 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 63 6f 6e 63 61 74 20 ........................(concat.
7b460 61 72 67 75 6d 65 6e 74 20 22 20 22 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 argument."."))..................
7b480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 61 63 65 20 61 66 61 63 65 29 0a 20 20 20 ................'face.aface)....
7b4a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 6d ..................(propertize.(m
7b4c0 61 70 63 6f 6e 63 61 74 20 23 27 70 72 69 6e 31 2d 74 6f 2d 73 74 72 69 6e 67 20 76 61 6c 75 65 apconcat.#'prin1-to-string.value
7b4e0 20 22 20 22 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 .".")...........................
7b500 20 20 20 20 20 20 20 27 66 61 63 65 20 76 66 61 63 65 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 .......'face.vface)))...........
7b520 20 20 28 27 72 65 70 65 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 6f 6e 63 ..('repeat..............(mapconc
7b540 61 74 20 28 6c 61 6d 62 64 61 20 28 76 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 at.(lambda.(value)..............
7b560 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 63 61 74 20 28 70 72 6f 70 65 72 74 69 7a 65 .............(concat.(propertize
7b580 20 61 72 67 75 6d 65 6e 74 20 27 66 61 63 65 20 61 66 61 63 65 29 0a 20 20 20 20 20 20 20 20 20 .argument.'face.aface)..........
7b5a0 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 70 72 6f 70 65 72 .........................(proper
7b5c0 74 69 7a 65 20 76 61 6c 75 65 20 20 20 20 27 66 61 63 65 20 76 66 61 63 65 29 29 29 0a 20 20 20 tize.value....'face.vface)))....
7b5e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 76 61 6c 75 65 20 22 20 22 29 29 .....................value."."))
7b600 29 29 0a 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 61 72 67 75 6d 65 6e 74 20 27 66 )).......(propertize.argument.'f
7b620 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 ace.'transient-inactive-argument
7b640 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f ))))..(cl-defmethod.transient-fo
7b660 72 6d 61 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 77 69 74 63 rmat-value.((obj.transient-switc
7b680 68 65 73 29 29 0a 20 20 28 77 69 74 68 2d 73 6c 6f 74 73 20 28 76 61 6c 75 65 20 61 72 67 75 6d hes))...(with-slots.(value.argum
7b6a0 65 6e 74 2d 66 6f 72 6d 61 74 20 63 68 6f 69 63 65 73 29 20 6f 62 6a 0a 20 20 20 20 28 66 6f 72 ent-format.choices).obj.....(for
7b6c0 6d 61 74 20 28 70 72 6f 70 65 72 74 69 7a 65 20 61 72 67 75 6d 65 6e 74 2d 66 6f 72 6d 61 74 0a mat.(propertize.argument-format.
7b6e0 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 61 63 65 20 28 69 ........................'face.(i
7b700 66 20 76 61 6c 75 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 20 f.value.........................
7b720 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 75 6d 65 6e 74 0a 20 20 ..........'transient-argument...
7b740 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 27 74 ..............................'t
7b760 72 61 6e 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 61 72 67 75 6d 65 6e 74 29 29 0a 20 20 20 ransient-inactive-argument))....
7b780 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 .........(format..............(p
7b7a0 72 6f 70 65 72 74 69 7a 65 20 22 5b 25 73 5d 22 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e ropertize."[%s]".'face.'transien
7b7c0 74 2d 64 65 6c 69 6d 69 74 65 72 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 6f t-delimiter)..............(mapco
7b7e0 6e 63 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 63 68 6f 69 ncat...............(lambda.(choi
7b800 63 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 ce).................(propertize.
7b820 63 68 6f 69 63 65 20 27 66 61 63 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 choice.'face....................
7b840 20 20 20 20 20 20 20 20 20 28 69 66 20 28 65 71 75 61 6c 20 28 66 6f 72 6d 61 74 20 61 72 67 75 .........(if.(equal.(format.argu
7b860 6d 65 6e 74 2d 66 6f 72 6d 61 74 20 63 68 6f 69 63 65 29 20 76 61 6c 75 65 29 0a 20 20 20 20 20 ment-format.choice).value)......
7b880 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 69 66 20 28 ...........................(if.(
7b8a0 6f 72 65 66 20 6f 62 6a 20 69 6e 61 70 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 oref.obj.inapt).................
7b8c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 ....................'transient-i
7b8e0 6e 61 70 74 2d 61 72 67 75 6d 65 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 napt-argument...................
7b900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 ................'transient-value
7b920 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 20 20 20 20 )...............................
7b940 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 76 61 6c 75 65 29 29 29 0a 20 20 20 'transient-inactive-value)))....
7b960 20 20 20 20 20 20 20 20 20 20 20 63 68 6f 69 63 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...........choices..............
7b980 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 7c 22 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e .(propertize."|".'face.'transien
7b9a0 74 2d 64 65 6c 69 6d 69 74 65 72 29 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 t-delimiter))))))..(cl-defmethod
7b9c0 20 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 28 6f 62 .transient--get-description.((ob
7b9e0 6a 20 74 72 61 6e 73 69 65 6e 74 2d 63 68 69 6c 64 29 29 0a 20 20 28 61 6e 64 2d 6c 65 74 2a 20 j.transient-child))...(and-let*.
7ba00 28 28 64 65 73 63 20 28 6f 72 65 66 20 6f 62 6a 20 64 65 73 63 72 69 70 74 69 6f 6e 29 29 29 0a ((desc.(oref.obj.description))).
7ba20 20 20 20 20 28 69 66 20 28 66 75 6e 63 74 69 6f 6e 70 20 64 65 73 63 29 0a 20 20 20 20 20 20 20 ....(if.(functionp.desc)........
7ba40 20 28 69 66 20 28 3d 20 28 63 61 72 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 75 6e 63 2d 61 72 .(if.(=.(car.(transient--func-ar
7ba60 69 74 79 20 64 65 73 63 29 29 20 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 ity.desc)).1).............(funca
7ba80 6c 6c 20 64 65 73 63 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 ll.desc.obj)...........(funcall.
7baa0 64 65 73 63 29 29 0a 20 20 20 20 20 20 64 65 73 63 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 desc)).......desc)))..(cl-defmet
7bac0 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 74 2d 66 61 63 65 20 28 28 6f 62 6a 20 74 72 hod.transient--get-face.((obj.tr
7bae0 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 29 20 73 6c 6f 74 29 0a 20 20 28 61 6e 64 2d 6c 65 74 ansient-suffix).slot)...(and-let
7bb00 2a 20 28 28 5f 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 73 6c 6f 74 29 29 0a 20 20 20 *.((_(slot-boundp.obj.slot))....
7bb20 20 20 20 20 20 20 20 20 20 20 28 66 61 63 65 20 28 73 6c 6f 74 2d 76 61 6c 75 65 20 6f 62 6a 20 ..........(face.(slot-value.obj.
7bb40 73 6c 6f 74 29 29 29 0a 20 20 20 20 28 69 66 20 28 61 6e 64 20 28 6e 6f 74 20 28 66 61 63 65 70 slot))).....(if.(and.(not.(facep
7bb60 20 66 61 63 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 74 69 6f 6e 70 20 .face))..............(functionp.
7bb80 66 61 63 65 29 29 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 74 72 61 6e 73 69 65 6e 74 2d face)).........(let.((transient-
7bba0 2d 70 65 6e 64 69 6e 67 2d 73 75 66 66 69 78 20 6f 62 6a 29 29 0a 20 20 20 20 20 20 20 20 20 20 -pending-suffix.obj))...........
7bbc0 28 69 66 20 28 3d 20 28 63 61 72 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 66 75 6e 63 2d 61 72 69 (if.(=.(car.(transient--func-ari
7bbe0 74 79 20 66 61 63 65 29 29 20 31 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 ty.face)).1)...............(func
7bc00 61 6c 6c 20 66 61 63 65 20 6f 62 6a 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 all.face.obj).............(funca
7bc20 6c 6c 20 66 61 63 65 29 29 29 0a 20 20 20 20 20 20 66 61 63 65 29 29 29 0a 0a 28 64 65 66 75 6e ll.face))).......face)))..(defun
7bc40 20 74 72 61 6e 73 69 65 6e 74 2d 2d 61 64 64 2d 66 61 63 65 20 28 73 74 72 69 6e 67 20 66 61 63 .transient--add-face.(string.fac
7bc60 65 20 26 6f 70 74 69 6f 6e 61 6c 20 61 70 70 65 6e 64 20 62 65 67 20 65 6e 64 29 0a 20 20 28 6c e.&optional.append.beg.end)...(l
7bc80 65 74 20 28 28 73 74 72 20 28 63 6f 70 79 2d 73 65 71 75 65 6e 63 65 20 73 74 72 69 6e 67 29 29 et.((str.(copy-sequence.string))
7bca0 29 0a 20 20 20 20 28 61 64 64 2d 66 61 63 65 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 28 6f ).....(add-face-text-property.(o
7bcc0 72 20 62 65 67 20 30 29 20 28 6f 72 20 65 6e 64 20 28 6c 65 6e 67 74 68 20 73 74 72 29 29 20 66 r.beg.0).(or.end.(length.str)).f
7bce0 61 63 65 20 61 70 70 65 6e 64 20 73 74 72 29 0a 20 20 20 20 73 74 72 29 29 0a 0a 28 64 65 66 75 ace.append.str).....str))..(defu
7bd00 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6b 65 79 2d 66 61 63 65 20 28 63 6d 64 20 6b 65 79 20 26 n.transient--key-face.(cmd.key.&
7bd20 6f 70 74 69 6f 6e 61 6c 20 65 6e 66 6f 72 63 65 2d 74 79 70 65 29 0a 20 20 28 6f 72 20 28 61 6e optional.enforce-type)...(or.(an
7bd40 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 6d 61 6e 74 69 63 2d 63 6f 6c 6f 72 69 6e 67 0a 20 20 d.transient-semantic-coloring...
7bd60 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 29 0a .........(not.transient--helpp).
7bd80 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 ...........(not.transient--editp
7bda0 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 67 65 74 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 65 )............(get.(transient--ge
7bdc0 74 2d 70 72 65 2d 63 6f 6d 6d 61 6e 64 20 63 6d 64 20 6b 65 79 20 65 6e 66 6f 72 63 65 2d 74 79 t-pre-command.cmd.key.enforce-ty
7bde0 70 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 66 pe).................'transient-f
7be00 61 63 65 29 29 0a 20 20 20 20 20 20 28 69 66 20 63 6d 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b ace)).......(if.cmd.'transient-k
7be20 65 79 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 6e 6f 6f 70 29 29 29 0a 0a 28 64 65 66 75 ey.'transient-key-noop)))..(defu
7be40 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6b 65 79 2d 75 6e 72 65 61 63 68 61 62 6c 65 2d 70 20 28 n.transient--key-unreachable-p.(
7be60 6f 62 6a 29 0a 20 20 28 61 6e 64 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 obj)...(and.transient--redisplay
7be80 2d 6b 65 79 0a 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 6f 72 65 66 20 6f 62 6a -key........(let.((key.(oref.obj
7bea0 20 6b 65 79 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 6f 72 20 28 65 71 75 61 6c .key)))..........(not.(or.(equal
7bec0 20 28 73 65 71 2d 74 61 6b 65 20 28 63 6c 2d 63 6f 65 72 63 65 20 28 65 64 6d 61 63 72 6f 2d 70 .(seq-take.(cl-coerce.(edmacro-p
7bee0 61 72 73 65 2d 6b 65 79 73 20 6b 65 79 20 74 29 20 27 6c 69 73 74 29 0a 20 20 20 20 20 20 20 20 arse-keys.key.t).'list).........
7bf00 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 6c 65 6e 67 ...........................(leng
7bf20 74 68 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 29 0a 20 20 th.transient--redisplay-key))...
7bf40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 69 65 6e 74 .......................transient
7bf60 2d 2d 72 65 64 69 73 70 6c 61 79 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 --redisplay-key)................
7bf80 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 6f 6b 75 70 2d 6b 65 79 20 74 72 61 6e 73 69 ...(transient--lookup-key.transi
7bfa0 65 6e 74 2d 73 74 69 63 6b 79 2d 6d 61 70 20 28 6b 62 64 20 6b 65 79 29 29 29 29 29 29 29 0a 0a ent-sticky-map.(kbd.key)))))))..
7bfc0 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6c 6f 6f 6b 75 70 2d 6b 65 79 20 28 6b 65 (defun.transient--lookup-key.(ke
7bfe0 79 6d 61 70 20 6b 65 79 29 0a 20 20 28 6c 65 74 20 28 28 76 61 6c 20 28 6c 6f 6f 6b 75 70 2d 6b ymap.key)...(let.((val.(lookup-k
7c000 65 79 20 6b 65 79 6d 61 70 20 6b 65 79 29 29 29 0a 20 20 20 20 28 61 6e 64 20 76 61 6c 20 28 6e ey.keymap.key))).....(and.val.(n
7c020 6f 74 20 28 69 6e 74 65 67 65 72 70 20 76 61 6c 29 29 20 76 61 6c 29 29 29 0a 0a 28 64 65 66 75 ot.(integerp.val)).val)))..(defu
7c040 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 79 62 65 2d 70 61 64 2d 6b 65 79 73 20 28 67 72 6f n.transient--maybe-pad-keys.(gro
7c060 75 70 20 26 6f 70 74 69 6f 6e 61 6c 20 70 61 72 65 6e 74 29 0a 20 20 28 77 68 65 6e 2d 6c 65 74 up.&optional.parent)...(when-let
7c080 20 28 28 70 61 64 20 28 6f 72 20 28 6f 72 65 66 20 67 72 6f 75 70 20 70 61 64 2d 6b 65 79 73 29 .((pad.(or.(oref.group.pad-keys)
7c0a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e 64 20 70 61 72 65 .......................(and.pare
7c0c0 6e 74 20 28 6f 72 65 66 20 70 61 72 65 6e 74 20 70 61 64 2d 6b 65 79 73 29 29 29 29 29 0a 20 20 nt.(oref.parent.pad-keys)))))...
7c0e0 20 20 28 6f 73 65 74 20 67 72 6f 75 70 20 70 61 64 2d 6b 65 79 73 0a 20 20 20 20 20 20 20 20 20 ..(oset.group.pad-keys..........
7c100 20 28 61 70 70 6c 79 20 23 27 6d 61 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 .(apply.#'max..................(
7c120 69 66 20 28 69 6e 74 65 67 65 72 70 20 70 61 64 29 20 70 61 64 20 30 29 0a 20 20 20 20 20 20 20 if.(integerp.pad).pad.0)........
7c140 20 20 20 20 20 20 20 20 20 20 28 73 65 71 2d 6b 65 65 70 20 28 6c 61 6d 62 64 61 20 28 73 75 66 ..........(seq-keep.(lambda.(suf
7c160 66 69 78 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 20 fix)............................
7c180 20 20 28 61 6e 64 20 28 65 69 65 69 6f 2d 6f 62 6a 65 63 74 2d 70 20 73 75 66 66 69 78 29 0a 20 ..(and.(eieio-object-p.suffix)..
7c1a0 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 ................................
7c1c0 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 73 75 66 66 69 78 20 27 6b 65 79 29 0a 20 20 20 20 20 .(slot-boundp.suffix.'key)......
7c1e0 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 6c 65 .............................(le
7c200 6e 67 74 68 20 28 6f 72 65 66 20 73 75 66 66 69 78 20 6b 65 79 29 29 29 29 0a 20 20 20 20 20 20 ngth.(oref.suffix.key)))).......
7c220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 67 72 6f 75 70 .....................(oref.group
7c240 20 73 75 66 66 69 78 65 73 29 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e .suffixes))))))..(defun.transien
7c260 74 2d 2d 70 69 78 65 6c 2d 77 69 64 74 68 20 28 73 74 72 69 6e 67 29 0a 20 20 28 73 61 76 65 2d t--pixel-width.(string)...(save-
7c280 77 69 6e 64 6f 77 2d 65 78 63 75 72 73 69 6f 6e 0a 20 20 20 20 28 77 69 74 68 2d 74 65 6d 70 2d window-excursion.....(with-temp-
7c2a0 62 75 66 66 65 72 0a 20 20 20 20 20 20 28 69 6e 73 65 72 74 20 73 74 72 69 6e 67 29 0a 20 20 20 buffer.......(insert.string)....
7c2c0 20 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 64 65 64 69 63 61 74 65 64 2d 70 20 6e 69 6c 20 6e ...(set-window-dedicated-p.nil.n
7c2e0 69 6c 29 0a 20 20 20 20 20 20 28 73 65 74 2d 77 69 6e 64 6f 77 2d 62 75 66 66 65 72 20 6e 69 6c il).......(set-window-buffer.nil
7c300 20 28 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 0a 20 20 20 20 20 20 28 63 61 72 20 28 77 .(current-buffer)).......(car.(w
7c320 69 6e 64 6f 77 2d 74 65 78 74 2d 70 69 78 65 6c 2d 73 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 indow-text-pixel-size...........
7c340 20 20 6e 69 6c 20 28 6c 69 6e 65 2d 62 65 67 69 6e 6e 69 6e 67 2d 70 6f 73 69 74 69 6f 6e 29 20 ..nil.(line-beginning-position).
7c360 28 70 6f 69 6e 74 29 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d (point))))))..(defun.transient--
7c380 63 6f 6c 75 6d 6e 2d 73 74 6f 70 73 20 28 63 6f 6c 75 6d 6e 73 29 0a 20 20 28 6c 65 74 2a 20 28 column-stops.(columns)...(let*.(
7c3a0 28 76 61 72 2d 70 69 74 63 68 20 28 6f 72 20 74 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d 76 (var-pitch.(or.transient-align-v
7c3c0 61 72 69 61 62 6c 65 2d 70 69 74 63 68 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ariable-pitch...................
7c3e0 20 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 76 61 ......(oref.transient--prefix.va
7c400 72 69 61 62 6c 65 2d 70 69 74 63 68 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 63 68 61 72 2d 77 riable-pitch)))..........(char-w
7c420 69 64 74 68 20 28 61 6e 64 20 76 61 72 2d 70 69 74 63 68 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d idth.(and.var-pitch.(transient--
7c440 70 69 78 65 6c 2d 77 69 64 74 68 20 22 20 22 29 29 29 29 0a 20 20 20 20 28 74 72 61 6e 73 69 65 pixel-width.".")))).....(transie
7c460 6e 74 2d 2d 73 65 71 2d 72 65 64 75 63 74 69 6f 6e 73 2d 66 72 6f 6d 0a 20 20 20 20 20 28 61 70 nt--seq-reductions-from......(ap
7c480 70 6c 79 2d 70 61 72 74 69 61 6c 6c 79 20 23 27 2b 20 28 2a 20 32 20 28 69 66 20 76 61 72 2d 70 ply-partially.#'+.(*.2.(if.var-p
7c4a0 69 74 63 68 20 63 68 61 72 2d 77 69 64 74 68 20 31 29 29 29 0a 20 20 20 20 20 28 74 72 61 6e 73 itch.char-width.1)))......(trans
7c4c0 69 65 6e 74 2d 2d 6d 61 70 6e 0a 20 20 20 20 20 20 28 6c 61 6d 62 64 61 20 28 63 65 6c 6c 73 20 ient--mapn.......(lambda.(cells.
7c4e0 6d 69 6e 29 0a 20 20 20 20 20 20 20 20 28 61 70 70 6c 79 20 23 27 6d 61 78 0a 20 20 20 20 20 20 min).........(apply.#'max.......
7c500 20 20 20 20 20 20 20 20 20 28 69 66 20 6d 69 6e 20 28 69 66 20 76 61 72 2d 70 69 74 63 68 20 28 .........(if.min.(if.var-pitch.(
7c520 2a 20 6d 69 6e 20 63 68 61 72 2d 77 69 64 74 68 29 20 6d 69 6e 29 20 30 29 0a 20 20 20 20 20 20 *.min.char-width).min).0).......
7c540 20 20 20 20 20 20 20 20 20 28 6d 61 70 63 61 72 20 28 69 66 20 76 61 72 2d 70 69 74 63 68 20 23 .........(mapcar.(if.var-pitch.#
7c560 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 69 78 65 6c 2d 77 69 64 74 68 20 23 27 6c 65 6e 67 74 68 'transient--pixel-width.#'length
7c580 29 20 63 65 6c 6c 73 29 29 29 0a 20 20 20 20 20 20 63 6f 6c 75 6d 6e 73 0a 20 20 20 20 20 20 28 ).cells))).......columns.......(
7c5a0 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 63 6f 6c 75 6d 6e 2d 77 69 oref.transient--prefix.column-wi
7c5c0 64 74 68 73 29 29 0a 20 20 20 20 20 30 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 dths))......0)))..(defun.transie
7c5e0 6e 74 2d 2d 61 6c 69 67 6e 2d 74 6f 20 28 73 74 6f 70 29 0a 20 20 28 75 6e 6c 65 73 73 20 28 7a nt--align-to.(stop)...(unless.(z
7c600 65 72 6f 70 20 73 74 6f 70 29 0a 20 20 20 20 28 69 6e 73 65 72 74 20 28 69 66 20 28 6f 72 20 74 erop.stop).....(insert.(if.(or.t
7c620 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 0a 20 20 ransient-align-variable-pitch...
7c640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e ..................(oref.transien
7c660 74 2d 2d 70 72 65 66 69 78 20 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 29 29 0a 20 20 20 20 20 t--prefix.variable-pitch))......
7c680 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 20 22 20 27 64 69 73 70 ...........(propertize.".".'disp
7c6a0 6c 61 79 20 60 28 73 70 61 63 65 20 3a 61 6c 69 67 6e 2d 74 6f 20 28 2c 73 74 6f 70 29 29 29 0a lay.`(space.:align-to.(,stop))).
7c6c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 61 6b 65 2d 73 74 72 69 6e 67 20 28 6d 61 78 20 ..............(make-string.(max.
7c6e0 30 20 28 2d 20 73 74 6f 70 20 28 63 75 72 72 65 6e 74 2d 63 6f 6c 75 6d 6e 29 29 29 20 3f 5c 73 0.(-.stop.(current-column))).?\s
7c700 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 2d )))))..(defun.transient-command-
7c720 73 75 6d 6d 61 72 79 2d 6f 72 2d 6e 61 6d 65 20 28 6f 62 6a 29 0a 20 20 22 52 65 74 75 72 6e 20 summary-or-name.(obj)..."Return.
7c740 74 68 65 20 73 75 6d 6d 61 72 79 20 6f 72 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 the.summary.or.name.of.the.comma
7c760 6e 64 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 20 4f 42 4a 2e 0a 0a 49 66 20 74 68 65 20 63 nd.represented.by.OBJ...If.the.c
7c780 6f 6d 6d 61 6e 64 20 68 61 73 20 61 20 64 6f 63 2d 73 74 72 69 6e 67 2c 20 74 68 65 6e 20 72 65 ommand.has.a.doc-string,.then.re
7c7a0 74 75 72 6e 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 20 6f 66 0a 74 68 61 74 2c 20 65 6c 73 turn.the.first.line.of.that,.els
7c7c0 65 20 69 74 73 20 6e 61 6d 65 2e 0a 0a 49 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 74 65 6d 70 e.its.name...Intended.to.be.temp
7c7e0 6f 72 61 72 69 6c 79 20 75 73 65 64 20 61 73 20 74 68 65 20 60 3a 73 75 66 66 69 78 2d 64 65 73 orarily.used.as.the.`:suffix-des
7c800 63 72 69 70 74 69 6f 6e 27 20 6f 66 0a 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 77 cription'.of.a.prefix.command,.w
7c820 68 69 6c 65 20 70 6f 72 74 69 6e 67 20 61 20 72 65 67 75 6c 61 72 20 6b 65 79 6d 61 70 20 74 6f hile.porting.a.regular.keymap.to
7c840 20 61 20 74 72 61 6e 73 69 65 6e 74 2e 22 0a 20 20 28 6c 65 74 20 28 28 63 6f 6d 6d 61 6e 64 20 .a.transient."...(let.((command.
7c860 28 6f 72 65 66 20 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 29 29 0a 20 20 20 20 28 69 66 2d 6c 65 74 (oref.obj.command))).....(if-let
7c880 20 28 28 64 6f 63 20 28 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 29 29 29 .((doc.(documentation.command)))
7c8a0 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 63 61 72 20 28 73 70 6c 69 74 .........(propertize.(car.(split
7c8c0 2d 73 74 72 69 6e 67 20 64 6f 63 20 22 5c 6e 22 29 29 20 27 66 61 63 65 20 27 66 6f 6e 74 2d 6c -string.doc."\n")).'face.'font-l
7c8e0 6f 63 6b 2d 64 6f 63 2d 66 61 63 65 29 0a 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 ock-doc-face).......(propertize.
7c900 28 73 79 6d 62 6f 6c 2d 6e 61 6d 65 20 63 6f 6d 6d 61 6e 64 29 20 27 66 61 63 65 20 27 66 6f 6e (symbol-name.command).'face.'fon
7c920 74 2d 6c 6f 63 6b 2d 66 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 2d 66 61 63 65 29 29 29 29 0a 0a 3b t-lock-function-name-face))))..;
7c940 3b 3b 20 48 65 6c 70 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e ;;.Help..(cl-defgeneric.transien
7c960 74 2d 73 68 6f 77 2d 68 65 6c 70 20 28 6f 62 6a 29 0a 20 20 22 53 68 6f 77 20 64 6f 63 75 6d 65 t-show-help.(obj)..."Show.docume
7c980 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 72 65 70 72 65 73 65 6e ntation.for.the.command.represen
7c9a0 74 65 64 20 62 79 20 4f 42 4a 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 ted.by.OBJ.")..(cl-defmethod.tra
7c9c0 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 nsient-show-help.((obj.transient
7c9e0 2d 70 72 65 66 69 78 29 29 0a 20 20 22 43 61 6c 6c 20 60 73 68 6f 77 2d 68 65 6c 70 27 20 69 66 -prefix))..."Call.`show-help'.if
7ca00 20 6e 6f 6e 2d 6e 69 6c 2c 20 65 6c 73 65 20 73 68 6f 77 20 60 69 6e 66 6f 2d 6d 61 6e 75 61 6c .non-nil,.else.show.`info-manual
7ca20 27 2c 0a 69 66 20 6e 6f 6e 2d 6e 69 6c 2c 20 65 6c 73 65 20 73 68 6f 77 20 74 68 65 20 60 6d 61 ',.if.non-nil,.else.show.the.`ma
7ca40 6e 2d 70 61 67 65 27 20 69 66 20 6e 6f 6e 2d 6e 69 6c 2c 20 65 6c 73 65 20 75 73 65 0a 60 64 65 n-page'.if.non-nil,.else.use.`de
7ca60 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 27 2e 22 0a 20 20 28 77 69 74 68 2d 73 6c 6f 74 73 scribe-function'."...(with-slots
7ca80 20 28 73 68 6f 77 2d 68 65 6c 70 20 69 6e 66 6f 2d 6d 61 6e 75 61 6c 20 6d 61 6e 2d 70 61 67 65 .(show-help.info-manual.man-page
7caa0 20 63 6f 6d 6d 61 6e 64 29 20 6f 62 6a 0a 20 20 20 20 28 63 6f 6e 64 20 28 73 68 6f 77 2d 68 65 .command).obj.....(cond.(show-he
7cac0 6c 70 20 28 66 75 6e 63 61 6c 6c 20 73 68 6f 77 2d 68 65 6c 70 20 6f 62 6a 29 29 0a 20 20 20 20 lp.(funcall.show-help.obj)).....
7cae0 20 20 20 20 20 20 28 69 6e 66 6f 2d 6d 61 6e 75 61 6c 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 ......(info-manual.(transient--s
7cb00 68 6f 77 2d 6d 61 6e 75 61 6c 20 69 6e 66 6f 2d 6d 61 6e 75 61 6c 29 29 0a 20 20 20 20 20 20 20 how-manual.info-manual))........
7cb20 20 20 20 28 6d 61 6e 2d 70 61 67 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 6d 61 ...(man-page.(transient--show-ma
7cb40 6e 70 61 67 65 20 6d 61 6e 2d 70 61 67 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 74 72 61 npage.man-page))...........((tra
7cb60 6e 73 69 65 6e 74 2d 2d 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 6d 61 6e nsient--describe-function.comman
7cb80 64 29 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d d)))))..(cl-defmethod.transient-
7cba0 73 68 6f 77 2d 68 65 6c 70 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 show-help.((obj.transient-suffix
7cbc0 29 29 0a 20 20 22 43 61 6c 6c 20 60 73 68 6f 77 2d 68 65 6c 70 27 20 69 66 20 6e 6f 6e 2d 6e 69 ))..."Call.`show-help'.if.non-ni
7cbe0 6c 2c 20 65 6c 73 65 20 75 73 65 20 60 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 27 2e l,.else.use.`describe-function'.
7cc00 0a 41 6c 73 6f 20 75 73 65 64 20 74 6f 20 64 69 73 70 61 74 63 68 20 73 68 6f 77 69 6e 67 20 64 .Also.used.to.dispatch.showing.d
7cc20 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 0a 70 72 65 ocumentation.for.the.current.pre
7cc40 66 69 78 2e 20 20 49 66 20 74 68 65 20 73 75 66 66 69 78 20 69 73 20 61 20 73 75 62 2d 70 72 65 fix...If.the.suffix.is.a.sub-pre
7cc60 66 69 78 2c 20 74 68 65 6e 20 61 6c 73 6f 20 63 61 6c 6c 20 74 68 65 0a 70 72 65 66 69 78 20 6d fix,.then.also.call.the.prefix.m
7cc80 65 74 68 6f 64 2e 22 0a 20 20 28 63 6f 6e 64 0a 20 20 20 28 28 65 71 20 74 68 69 73 2d 63 6f 6d ethod."...(cond....((eq.this-com
7cca0 6d 61 6e 64 20 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 6c 70 29 0a 20 20 20 20 28 74 72 61 6e 73 mand.'transient-help).....(trans
7ccc0 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 ient-show-help.transient--prefix
7cce0 29 29 0a 20 20 20 28 28 6c 65 74 20 28 28 70 72 65 66 69 78 20 28 67 65 74 20 28 6f 72 65 66 20 ))....((let.((prefix.(get.(oref.
7cd00 6f 62 6a 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 obj.command)....................
7cd20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 29 29 29 0a 20 20 20 20 20 20 ....'transient--prefix))).......
7cd40 28 61 6e 64 20 70 72 65 66 69 78 20 28 6e 6f 74 20 28 65 71 20 28 6f 72 65 66 20 74 72 61 6e 73 (and.prefix.(not.(eq.(oref.trans
7cd60 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 29 20 74 68 69 73 2d 63 6f 6d 6d 61 ient--prefix.command).this-comma
7cd80 6e 64 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 70 72 6f 67 31 20 74 20 28 74 72 61 6e 73 69 nd))............(prog1.t.(transi
7cda0 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 20 70 72 65 66 69 78 29 29 29 29 29 0a 20 20 20 28 28 69 ent-show-help.prefix)))))....((i
7cdc0 66 2d 6c 65 74 20 28 28 73 68 6f 77 2d 68 65 6c 70 20 28 6f 72 65 66 20 6f 62 6a 20 73 68 6f 77 f-let.((show-help.(oref.obj.show
7cde0 2d 68 65 6c 70 29 29 29 0a 20 20 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 73 68 6f 77 2d 68 -help))).........(funcall.show-h
7ce00 65 6c 70 20 6f 62 6a 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 73 63 72 elp.obj).......(transient--descr
7ce20 69 62 65 2d 66 75 6e 63 74 69 6f 6e 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 29 0a 0a ibe-function.this-command)))))..
7ce40 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c (cl-defmethod.transient-show-hel
7ce60 70 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 29 29 0a 20 20 22 43 61 6c p.((obj.transient-infix))..."Cal
7ce80 6c 20 60 73 68 6f 77 2d 68 65 6c 70 27 20 69 66 20 6e 6f 6e 2d 6e 69 6c 2c 20 65 6c 73 65 20 73 l.`show-help'.if.non-nil,.else.s
7cea0 68 6f 77 20 74 68 65 20 60 6d 61 6e 2d 70 61 67 65 27 0a 69 66 20 6e 6f 6e 2d 6e 69 6c 2c 20 65 how.the.`man-page'.if.non-nil,.e
7cec0 6c 73 65 20 75 73 65 20 60 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 27 2e 20 20 57 68 lse.use.`describe-function'...Wh
7cee0 65 6e 20 73 68 6f 77 69 6e 67 20 74 68 65 0a 6d 61 6e 70 61 67 65 2c 20 74 68 65 6e 20 74 72 79 en.showing.the.manpage,.then.try
7cf00 20 74 6f 20 6a 75 6d 70 20 74 6f 20 74 68 65 20 63 6f 72 72 65 63 74 20 6c 6f 63 61 74 69 6f 6e .to.jump.to.the.correct.location
7cf20 2e 22 0a 20 20 28 69 66 2d 6c 65 74 20 28 28 73 68 6f 77 2d 68 65 6c 70 20 28 6f 72 65 66 20 6f ."...(if-let.((show-help.(oref.o
7cf40 62 6a 20 73 68 6f 77 2d 68 65 6c 70 29 29 29 0a 20 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 73 bj.show-help))).......(funcall.s
7cf60 68 6f 77 2d 68 65 6c 70 20 6f 62 6a 29 0a 20 20 20 20 28 69 66 2d 6c 65 74 20 28 28 6d 61 6e 2d how-help.obj).....(if-let.((man-
7cf80 70 61 67 65 20 28 6f 72 65 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 20 6d 61 6e page.(oref.transient--prefix.man
7cfa0 2d 70 61 67 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 72 67 75 6d 65 6e 74 20 28 -page))..............(argument.(
7cfc0 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 61 72 67 75 6d 65 6e 74 29 0a and.(slot-boundp.obj.'argument).
7cfe0 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 6f 72 65 ............................(ore
7d000 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 29 29 29 0a 20 20 20 20 20 20 20 20 28 74 72 61 6e f.obj.argument)))).........(tran
7d020 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 6d 61 6e 70 61 67 65 20 6d 61 6e 2d 70 61 67 65 20 61 72 67 sient--show-manpage.man-page.arg
7d040 75 6d 65 6e 74 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 73 63 72 69 62 ument).......(transient--describ
7d060 65 2d 66 75 6e 63 74 69 6f 6e 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 0a 0a 3b 3b 20 e-function.this-command))))..;;.
7d080 60 63 6c 2d 67 65 6e 65 72 69 63 2d 67 65 6e 65 72 61 6c 69 7a 65 72 73 27 20 64 6f 65 73 6e 27 `cl-generic-generalizers'.doesn'
7d0a0 74 20 73 75 70 70 6f 72 74 20 60 63 6f 6d 6d 61 6e 64 27 20 65 74 20 61 6c 2e 0a 28 63 6c 2d 64 t.support.`command'.et.al..(cl-d
7d0c0 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 20 28 63 6d efmethod.transient-show-help.(cm
7d0e0 64 29 0a 20 20 22 53 68 6f 77 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 64 6f 63 2d 73 74 72 69 6e d)..."Show.the.command.doc-strin
7d100 67 2e 22 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 g."...(transient--describe-funct
7d120 69 6f 6e 20 63 6d 64 29 29 0a 0a 28 64 65 66 6d 61 63 72 6f 20 74 72 61 6e 73 69 65 6e 74 2d 77 ion.cmd))..(defmacro.transient-w
7d140 69 74 68 2d 68 65 6c 70 2d 77 69 6e 64 6f 77 20 28 26 72 65 73 74 20 62 6f 64 79 29 0a 20 20 22 ith-help-window.(&rest.body)..."
7d160 45 76 61 6c 75 61 74 65 20 42 4f 44 59 2c 20 73 65 6e 64 20 6f 75 74 70 75 74 20 74 6f 20 2a 48 Evaluate.BODY,.send.output.to.*H
7d180 65 6c 70 2a 20 62 75 66 66 65 72 2c 20 61 6e 64 20 64 69 73 70 6c 61 79 20 69 74 20 69 6e 20 61 elp*.buffer,.and.display.it.in.a
7d1a0 20 77 69 6e 64 6f 77 2e 0a 53 65 6c 65 63 74 20 74 68 65 20 68 65 6c 70 20 77 69 6e 64 6f 77 2c .window..Select.the.help.window,
7d1c0 20 61 6e 64 20 6d 61 6b 65 20 74 68 65 20 68 65 6c 70 20 62 75 66 66 65 72 20 63 75 72 72 65 6e .and.make.the.help.buffer.curren
7d1e0 74 20 61 6e 64 20 72 65 74 75 72 6e 20 69 74 2e 22 0a 20 20 28 64 65 63 6c 61 72 65 20 28 69 6e t.and.return.it."...(declare.(in
7d200 64 65 6e 74 20 30 29 29 0a 20 20 60 28 6c 65 74 20 28 28 62 75 66 66 65 72 20 6e 69 6c 29 0a 20 dent.0))...`(let.((buffer.nil)..
7d220 20 20 20 20 20 20 20 20 28 68 65 6c 70 2d 77 69 6e 64 6f 77 2d 73 65 6c 65 63 74 20 74 29 29 0a ........(help-window-select.t)).
7d240 20 20 20 20 20 28 77 69 74 68 2d 68 65 6c 70 2d 77 69 6e 64 6f 77 20 28 68 65 6c 70 2d 62 75 66 .....(with-help-window.(help-buf
7d260 66 65 72 29 0a 20 20 20 20 20 20 20 2c 40 62 6f 64 79 0a 20 20 20 20 20 20 20 28 73 65 74 71 20 fer)........,@body........(setq.
7d280 62 75 66 66 65 72 20 28 63 75 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 29 0a 20 20 20 20 20 28 buffer.(current-buffer)))......(
7d2a0 73 65 74 2d 62 75 66 66 65 72 20 62 75 66 66 65 72 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 set-buffer.buffer)))..(defun.tra
7d2c0 6e 73 69 65 6e 74 2d 2d 64 69 73 70 6c 61 79 2d 68 65 6c 70 20 28 68 65 6c 70 65 72 20 74 61 72 nsient--display-help.(helper.tar
7d2e0 67 65 74 29 0a 20 20 28 6c 65 74 20 28 28 77 69 6e 63 6f 6e 66 20 28 63 75 72 72 65 6e 74 2d 77 get)...(let.((winconf.(current-w
7d300 69 6e 64 6f 77 2d 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 29 29 29 0a 20 20 20 20 28 66 75 6e 63 indow-configuration))).....(func
7d320 61 6c 6c 20 28 63 6f 6e 64 20 28 68 65 6c 70 65 72 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 all.(cond.(helper)..............
7d340 20 20 20 20 20 20 28 28 73 79 6d 62 6f 6c 70 20 74 61 72 67 65 74 29 20 23 27 74 72 61 6e 73 69 ......((symbolp.target).#'transi
7d360 65 6e 74 2d 2d 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 29 0a 20 20 20 20 20 20 20 20 ent--describe-function).........
7d380 20 20 20 20 20 20 20 20 20 20 20 28 28 73 74 72 69 6e 67 70 20 74 61 72 67 65 74 29 0a 20 20 20 ...........((stringp.target)....
7d3a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 73 74 72 69 6e 67 2d 70 72 65 .................(if.(string-pre
7d3c0 66 69 78 2d 70 20 22 28 22 20 74 61 72 67 65 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 fix-p."(".target)...............
7d3e0 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 6d 61 6e 75 ..........#'transient--show-manu
7d400 61 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 al.......................#'trans
7d420 69 65 6e 74 2d 2d 73 68 6f 77 2d 6d 61 6e 70 61 67 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 ient--show-manpage))............
7d440 20 20 20 20 20 20 20 20 28 28 65 72 72 6f 72 20 22 55 6e 6b 6e 6f 77 6e 20 68 6f 77 20 74 6f 20 ........((error."Unknown.how.to.
7d460 73 68 6f 77 20 68 65 6c 70 20 66 6f 72 20 25 53 22 20 74 61 72 67 65 74 29 29 29 0a 20 20 20 20 show.help.for.%S".target))).....
7d480 20 20 20 20 20 20 20 20 20 74 61 72 67 65 74 29 0a 20 20 20 20 28 73 65 74 71 2d 6c 6f 63 61 6c .........target).....(setq-local
7d4a0 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 74 6f 72 65 2d 77 69 6e 63 6f 6e 66 20 77 69 6e 63 .transient--restore-winconf.winc
7d4c0 6f 6e 66 29 29 0a 20 20 28 66 69 74 2d 77 69 6e 64 6f 77 2d 74 6f 2d 62 75 66 66 65 72 20 6e 69 onf))...(fit-window-to-buffer.ni
7d4e0 6c 20 28 66 72 61 6d 65 2d 68 65 69 67 68 74 29 20 28 77 69 6e 64 6f 77 2d 68 65 69 67 68 74 29 l.(frame-height).(window-height)
7d500 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 75 6d 65 2d 6d 6f 64 65 29 0a 20 20 28 6d )...(transient-resume-mode)...(m
7d520 65 73 73 61 67 65 20 28 73 75 62 73 74 69 74 75 74 65 2d 63 6f 6d 6d 61 6e 64 2d 6b 65 79 73 20 essage.(substitute-command-keys.
7d540 22 54 79 70 65 20 5c 5c 60 71 27 20 74 6f 20 72 65 73 75 6d 65 20 74 72 61 6e 73 69 65 6e 74 20 "Type.\\`q'.to.resume.transient.
7d560 63 6f 6d 6d 61 6e 64 2e 22 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d command.")))..(defun.transient--
7d580 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 20 28 66 6e 29 0a 20 20 28 6c 65 74 2a 20 28 describe-function.(fn)...(let*.(
7d5a0 28 62 75 66 66 65 72 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 20 28 68 65 6c 70 2d 77 69 6e 64 (buffer.nil)..........(help-wind
7d5c0 6f 77 2d 73 65 6c 65 63 74 20 74 29 0a 20 20 20 20 20 20 20 20 20 28 74 65 6d 70 2d 62 75 66 66 ow-select.t)..........(temp-buff
7d5e0 65 72 2d 77 69 6e 64 6f 77 2d 73 65 74 75 70 2d 68 6f 6f 6b 0a 20 20 20 20 20 20 20 20 20 20 28 er-window-setup-hook...........(
7d600 63 6f 6e 73 20 28 6c 61 6d 62 64 61 20 28 29 20 28 73 65 74 71 20 62 75 66 66 65 72 20 28 63 75 cons.(lambda.().(setq.buffer.(cu
7d620 72 72 65 6e 74 2d 62 75 66 66 65 72 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rrent-buffer))).................
7d640 74 65 6d 70 2d 62 75 66 66 65 72 2d 77 69 6e 64 6f 77 2d 73 65 74 75 70 2d 68 6f 6f 6b 29 29 29 temp-buffer-window-setup-hook)))
7d660 0a 20 20 20 20 28 64 65 73 63 72 69 62 65 2d 66 75 6e 63 74 69 6f 6e 20 66 6e 29 0a 20 20 20 20 .....(describe-function.fn).....
7d680 28 73 65 74 2d 62 75 66 66 65 72 20 62 75 66 66 65 72 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 (set-buffer.buffer)))..(defun.tr
7d6a0 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 2d 6d 61 6e 75 61 6c 20 28 6d 61 6e 75 61 6c 29 0a 20 20 ansient--show-manual.(manual)...
7d6c0 28 69 6e 66 6f 20 6d 61 6e 75 61 6c 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 (info.manual))..(defun.transient
7d6e0 2d 2d 73 68 6f 77 2d 6d 61 6e 70 61 67 65 20 28 6d 61 6e 70 61 67 65 20 26 6f 70 74 69 6f 6e 61 --show-manpage.(manpage.&optiona
7d700 6c 20 61 72 67 75 6d 65 6e 74 29 0a 20 20 28 72 65 71 75 69 72 65 20 27 6d 61 6e 29 0a 20 20 28 l.argument)...(require.'man)...(
7d720 6c 65 74 2a 20 28 28 4d 61 6e 2d 6e 6f 74 69 66 79 2d 6d 65 74 68 6f 64 20 27 6d 65 65 6b 29 0a let*.((Man-notify-method.'meek).
7d740 20 20 20 20 20 20 20 20 20 28 62 75 66 20 28 4d 61 6e 2d 67 65 74 70 61 67 65 2d 69 6e 2d 62 61 .........(buf.(Man-getpage-in-ba
7d760 63 6b 67 72 6f 75 6e 64 20 6d 61 6e 70 61 67 65 29 29 0a 20 20 20 20 20 20 20 20 20 28 70 72 6f ckground.manpage))..........(pro
7d780 63 20 28 67 65 74 2d 62 75 66 66 65 72 2d 70 72 6f 63 65 73 73 20 62 75 66 29 29 29 0a 20 20 20 c.(get-buffer-process.buf)))....
7d7a0 20 28 77 68 69 6c 65 20 28 61 6e 64 20 70 72 6f 63 20 28 65 71 20 28 70 72 6f 63 65 73 73 2d 73 .(while.(and.proc.(eq.(process-s
7d7c0 74 61 74 75 73 20 70 72 6f 63 29 20 27 72 75 6e 29 29 0a 20 20 20 20 20 20 28 61 63 63 65 70 74 tatus.proc).'run)).......(accept
7d7e0 2d 70 72 6f 63 65 73 73 2d 6f 75 74 70 75 74 20 70 72 6f 63 29 29 0a 20 20 20 20 28 73 77 69 74 -process-output.proc)).....(swit
7d800 63 68 2d 74 6f 2d 62 75 66 66 65 72 20 62 75 66 29 0a 20 20 20 20 28 77 68 65 6e 20 61 72 67 75 ch-to-buffer.buf).....(when.argu
7d820 6d 65 6e 74 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 67 6f 74 6f 2d 61 72 67 75 ment.......(transient--goto-argu
7d840 6d 65 6e 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 61 72 67 75 6d 65 6e 74 29 29 29 29 0a 0a 28 ment-description.argument))))..(
7d860 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 67 6f 74 6f 2d 61 72 67 75 6d 65 6e 74 2d 64 defun.transient--goto-argument-d
7d880 65 73 63 72 69 70 74 69 6f 6e 20 28 61 72 67 29 0a 20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 70 escription.(arg)...(goto-char.(p
7d8a0 6f 69 6e 74 2d 6d 69 6e 29 29 0a 20 20 28 6c 65 74 20 28 28 63 61 73 65 2d 66 6f 6c 64 2d 73 65 oint-min))...(let.((case-fold-se
7d8c0 61 72 63 68 20 6e 69 6c 29 0a 20 20 20 20 20 20 20 20 3b 3b 20 54 68 69 73 20 6d 61 74 63 68 65 arch.nil).........;;.This.matche
7d8e0 73 20 70 72 65 63 65 64 69 6e 67 2f 70 72 6f 63 65 65 64 69 6e 67 20 6f 70 74 69 6f 6e 73 2e 20 s.preceding/proceeding.options..
7d900 20 4f 70 74 69 6f 6e 73 0a 20 20 20 20 20 20 20 20 3b 3b 20 73 75 63 68 20 61 73 20 22 2d 61 22 .Options.........;;.such.as."-a"
7d920 2c 20 22 2d 53 5b 3c 6b 65 79 69 64 3e 5d 22 2c 20 61 6e 64 20 22 2d 2d 67 72 65 70 3d 3c 70 61 ,."-S[<keyid>]",.and."--grep=<pa
7d940 74 74 65 72 6e 3e 22 0a 20 20 20 20 20 20 20 20 3b 3b 20 61 72 65 20 6d 61 74 63 68 65 64 20 62 ttern>".........;;.are.matched.b
7d960 79 20 74 68 69 73 20 72 65 67 65 78 20 77 69 74 68 6f 75 74 20 74 68 65 20 73 68 79 20 67 72 6f y.this.regex.without.the.shy.gro
7d980 75 70 2e 0a 20 20 20 20 20 20 20 20 3b 3b 20 54 68 65 20 22 2e 20 22 20 69 6e 20 74 68 65 20 73 up..........;;.The."..".in.the.s
7d9a0 68 79 20 67 72 6f 75 70 20 69 73 20 66 6f 72 20 6f 70 74 69 6f 6e 73 20 73 75 63 68 20 61 73 0a hy.group.is.for.options.such.as.
7d9c0 20 20 20 20 20 20 20 20 3b 3b 20 22 2d 6d 20 70 61 72 65 6e 74 2d 6e 75 6d 62 65 72 22 2c 20 61 ........;;."-m.parent-number",.a
7d9e0 6e 64 20 74 68 65 20 22 2d 5b 5e 5b 3a 73 70 61 63 65 3a 5d 5d 2b 20 22 20 69 73 0a 20 20 20 20 nd.the."-[^[:space:]]+.".is.....
7da00 20 20 20 20 3b 3b 20 66 6f 72 20 6f 70 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 22 2d 2d 6d 61 ....;;.for.options.such.as."--ma
7da20 69 6e 6c 69 6e 65 20 70 61 72 65 6e 74 2d 6e 75 6d 62 65 72 22 0a 20 20 20 20 20 20 20 20 28 6f inline.parent-number".........(o
7da40 74 68 65 72 73 20 22 2d 5c 5c 28 3f 3a 2e 20 5c 5c 7c 2d 5b 5e 5b 3a 73 70 61 63 65 3a 5d 5d 2b thers."-\\(?:..\\|-[^[:space:]]+
7da60 20 5c 5c 29 3f 5b 5e 5b 3a 73 70 61 63 65 3a 5d 5d 2b 22 29 29 0a 20 20 20 20 28 77 68 65 6e 20 .\\)?[^[:space:]]+")).....(when.
7da80 28 72 65 2d 73 65 61 72 63 68 2d 66 6f 72 77 61 72 64 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 (re-search-forward............(i
7daa0 66 20 28 65 71 75 61 6c 20 61 72 67 20 22 2d 2d 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 f.(equal.arg."--")..............
7dac0 20 20 3b 3b 20 53 70 65 63 69 61 6c 20 63 61 73 65 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ..;;.Special.case...............
7dae0 20 20 22 5e 5b 5c 74 5c 73 5d 2b 5c 5c 28 2d 2d 5c 5c 28 3f 3a 20 5c 5c 7c 24 5c 5c 29 5c 5c 7c .."^[\t\s]+\\(--\\(?:.\\|$\\)\\|
7db00 5c 5c 5b 2d 2d 5c 5c 5d 5c 5c 29 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 53 68 6f \\[--\\]\\)"..............;;.Sho
7db20 75 6c 64 20 73 74 61 72 74 20 77 69 74 68 20 77 68 69 74 65 73 70 61 63 65 20 61 6e 64 20 6d 61 uld.start.with.whitespace.and.ma
7db40 79 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 61 6e 79 20 6e 75 6d 62 65 y.have..............;;.any.numbe
7db60 72 20 6f 66 20 6f 70 74 69 6f 6e 73 20 62 65 66 6f 72 65 20 61 6e 64 2f 6f 72 20 61 66 74 65 72 r.of.options.before.and/or.after
7db80 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 20 ...............(format..........
7dba0 20 20 20 20 20 22 5e 5b 5c 74 5c 73 5d 2b 5c 5c 28 3f 3a 25 73 2c 20 5c 5c 29 2a 3f 5c 5c 28 3f ....."^[\t\s]+\\(?:%s,.\\)*?\\(?
7dbc0 31 3a 25 73 5c 5c 29 25 73 5c 5c 28 3f 3a 2c 20 25 73 5c 5c 29 2a 24 22 0a 20 20 20 20 20 20 20 1:%s\\)%s\\(?:,.%s\\)*$"........
7dbe0 20 20 20 20 20 20 20 6f 74 68 65 72 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 4f .......others...............;;.O
7dc00 70 74 69 6f 6e 73 20 64 6f 6e 27 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 65 6e 64 20 69 6e 20 ptions.don't.necessarily.end.in.
7dc20 61 6e 20 22 3d 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 28 65 2e 67 2e 2c 20 22 an."="...............;;.(e.g.,."
7dc40 2d 2d 67 70 67 2d 73 69 67 6e 5b 3d 3c 6b 65 79 69 64 3e 5d 22 29 0a 20 20 20 20 20 20 20 20 20 --gpg-sign[=<keyid>]")..........
7dc60 20 20 20 20 20 28 73 74 72 69 6e 67 2d 72 65 6d 6f 76 65 2d 73 75 66 66 69 78 20 22 3d 22 20 61 .....(string-remove-suffix."=".a
7dc80 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 53 69 6d 70 6c 65 20 6f 70 74 69 rg)...............;;.Simple.opti
7dca0 6f 6e 73 20 64 6f 6e 27 74 20 65 6e 64 20 69 6e 20 61 6e 20 22 3d 22 2e 20 20 53 70 6c 69 74 74 ons.don't.end.in.an."="...Splitt
7dcc0 69 6e 67 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 69 6e 74 6f 20 32 ing.this...............;;.into.2
7dce0 20 63 61 73 65 73 20 73 68 6f 75 6c 64 20 6d 61 6b 65 20 67 65 74 74 69 6e 67 20 66 61 6c 73 65 .cases.should.make.getting.false
7dd00 20 70 6f 73 69 74 69 76 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 6c 65 73 73 .positives...............;;.less
7dd20 20 6c 69 6b 65 6c 79 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 28 73 74 72 69 .likely................(if.(stri
7dd40 6e 67 2d 73 75 66 66 69 78 2d 70 20 22 3d 22 20 61 72 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 ng-suffix-p."=".arg)............
7dd60 20 20 20 20 20 20 20 3b 3b 20 22 5b 5e 5b 3a 73 70 61 63 65 3a 5d 5d 2a 5b 5e 2e 5b 3a 73 70 61 .......;;."[^[:space:]]*[^.[:spa
7dd80 63 65 3a 5d 5d 22 20 6d 61 74 63 68 65 73 20 74 68 65 20 6f 70 74 69 6f 6e 0a 20 20 20 20 20 20 ce:]]".matches.the.option.......
7dda0 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 76 61 6c 75 65 2c 20 77 68 69 63 68 20 69 73 20 75 ............;;.value,.which.is.u
7ddc0 73 75 61 6c 6c 79 20 61 66 74 65 72 20 74 68 65 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 0a 20 20 20 sually.after.the.option.name....
7dde0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 61 6e 64 20 65 69 74 68 65 72 20 27 3d 27 ...............;;.and.either.'='
7de00 20 6f 72 20 27 5b 3d 27 2e 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 27 74 20 65 6e 64 20 69 .or.'[='...The.value.can't.end.i
7de20 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 61 20 70 65 72 69 6f 64 2c n...................;;.a.period,
7de40 20 61 73 20 74 68 61 74 20 6d 65 61 6e 73 20 69 74 27 73 20 62 65 69 6e 67 20 75 73 65 64 20 61 .as.that.means.it's.being.used.a
7de60 74 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 65 6e 64 20 6f t.the...................;;.end.o
7de80 66 20 61 20 73 65 6e 74 65 6e 63 65 2e 20 20 54 68 65 20 73 70 61 63 65 20 69 73 20 66 6f 72 20 f.a.sentence...The.space.is.for.
7dea0 6f 70 74 69 6f 6e 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 73 75 63 options...................;;.suc
7dec0 68 20 61 73 20 27 2d 2d 6d 61 69 6e 6c 69 6e 65 20 70 61 72 65 6e 74 2d 6e 75 6d 62 65 72 27 2e h.as.'--mainline.parent-number'.
7dee0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 5c 5c 28 3f 3a 20 5c 5c 7c 5c 5c 5b ..................."\\(?:.\\|\\[
7df00 3f 3d 5c 5c 29 5b 5e 5b 3a 73 70 61 63 65 3a 5d 5d 2a 5b 5e 2e 5b 3a 73 70 61 63 65 3a 5d 5d 22 ?=\\)[^[:space:]]*[^.[:space:]]"
7df20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 45 69 74 68 65 72 20 74 68 69 73 20 .................;;.Either.this.
7df40 64 6f 65 73 6e 27 74 20 6d 61 74 63 68 20 61 6e 79 74 68 69 6e 67 20 28 65 2e 67 2e 2c 20 22 2d doesn't.match.anything.(e.g.,."-
7df60 61 22 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 6f 72 20 74 68 65 20 6f a"),.................;;.or.the.o
7df80 70 74 69 6f 6e 20 69 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 76 61 6c 75 65 20 64 65 6c ption.is.followed.by.a.value.del
7dfa0 69 6d 69 74 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 62 79 20 61 20 22 imited.................;;.by.a."
7dfc0 5b 22 2c 20 22 3c 22 2c 20 6f 72 20 22 3a 22 2e 20 20 41 20 73 70 61 63 65 20 6d 69 67 68 74 20 [",."<",.or.":"...A.space.might.
7dfe0 61 70 70 65 61 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 62 65 66 6f 72 65 appear.................;;.before
7e000 20 74 68 69 73 20 76 61 6c 75 65 2c 20 61 73 20 69 6e 20 22 2d 66 20 3c 66 69 6c 65 3e 22 2e 20 .this.value,.as.in."-f.<file>"..
7e020 20 54 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 73 70 61 63 65 20 61 6c .The.................;;.space.al
7e040 74 65 72 6e 61 74 69 76 65 20 69 73 20 66 6f 72 20 6f 70 74 69 6f 6e 73 20 73 75 63 68 20 61 73 ternative.is.for.options.such.as
7e060 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 3b 20 22 2d 6d 20 70 61 72 65 6e 74 2d 6e .................;;."-m.parent-n
7e080 75 6d 62 65 72 22 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 5c 5c 28 3f 3a 5c 5c umber".................."\\(?:\\
7e0a0 28 3f 3a 20 5c 5c 7c 20 3f 5b 5c 5c 5b 3c 3a 5d 5c 5c 29 5b 5e 5b 3a 73 70 61 63 65 3a 5d 5d 2a (?:.\\|.?[\\[<:]\\)[^[:space:]]*
7e0c0 5b 5e 2e 5b 3a 73 70 61 63 65 3a 5d 5d 5c 5c 29 3f 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 [^.[:space:]]\\)?").............
7e0e0 20 20 6f 74 68 65 72 73 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 6e 69 6c 20 74 29 0a 20 20 20 ..others))............nil.t)....
7e100 20 20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 6d 61 74 63 68 2d 62 65 67 69 6e 6e 69 6e 67 20 31 ...(goto-char.(match-beginning.1
7e120 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d )))))..(defun.transient--insert-
7e140 68 65 6c 70 20 28 29 0a 20 20 28 75 6e 6c 65 73 73 20 28 6c 6f 6f 6b 69 6e 67 2d 62 61 63 6b 20 help.()...(unless.(looking-back.
7e160 22 5c 6e 5c 6e 22 20 32 29 0a 20 20 20 20 28 69 6e 73 65 72 74 20 22 5c 6e 22 29 29 0a 20 20 28 "\n\n".2).....(insert."\n"))...(
7e180 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 0a 20 20 20 20 28 69 6e 73 65 72 when.transient--helpp.....(inser
7e1a0 74 0a 20 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 t......(format.......(propertize
7e1c0 20 22 5c 0a 54 79 70 65 20 61 20 25 73 20 74 6f 20 73 68 6f 77 20 68 65 6c 70 20 66 6f 72 20 74 ."\.Type.a.%s.to.show.help.for.t
7e1e0 68 61 74 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 6f 72 20 25 73 20 74 6f 20 73 68 6f hat.suffix.command,.or.%s.to.sho
7e200 77 20 6d 61 6e 75 61 6c 2e 0a 54 79 70 65 20 25 73 20 74 6f 20 65 78 69 74 20 68 65 6c 70 2e 5c w.manual..Type.%s.to.exit.help.\
7e220 6e 22 0a 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 74 72 61 6e n"...................'face.'tran
7e240 73 69 65 6e 74 2d 68 65 61 64 69 6e 67 29 0a 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 sient-heading).......(propertize
7e260 20 22 3c 4b 45 59 3e 22 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 ."<KEY>".'face.'transient-key)..
7e280 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 3f 22 20 20 20 20 20 27 66 61 63 65 20 27 .....(propertize."?".....'face.'
7e2a0 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 transient-key).......(propertize
7e2c0 20 22 43 2d 67 22 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 29 29 ."C-g"...'face.'transient-key)))
7e2e0 29 0a 20 20 28 77 68 65 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 69 74 70 0a 20 20 20 20 28 )...(when.transient--editp.....(
7e300 75 6e 6c 65 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 6c 70 70 0a 20 20 20 20 20 20 28 69 unless.transient--helpp.......(i
7e320 6e 73 65 72 74 0a 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 28 70 72 nsert........(format.........(pr
7e340 6f 70 65 72 74 69 7a 65 20 22 5c 0a 54 79 70 65 20 25 73 20 61 6e 64 20 74 68 65 6e 20 25 73 20 opertize."\.Type.%s.and.then.%s.
7e360 74 6f 20 70 75 74 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 73 75 66 66 69 78 20 63 6f 6d to.put.the.respective.suffix.com
7e380 6d 61 6e 64 20 6f 6e 20 6c 65 76 65 6c 20 25 73 2e 0a 54 79 70 65 20 25 73 20 61 6e 64 20 74 68 mand.on.level.%s..Type.%s.and.th
7e3a0 65 6e 20 25 73 20 74 6f 20 64 69 73 70 6c 61 79 20 73 75 66 66 69 78 65 73 20 75 70 20 74 6f 20 en.%s.to.display.suffixes.up.to.
7e3c0 6c 65 76 65 6c 20 25 73 20 69 6e 20 74 68 69 73 20 6d 65 6e 75 2e 0a 54 79 70 65 20 25 73 20 61 level.%s.in.this.menu..Type.%s.a
7e3e0 6e 64 20 74 68 65 6e 20 25 73 20 74 6f 20 64 65 73 63 72 69 62 65 20 74 68 65 20 72 65 73 70 65 nd.then.%s.to.describe.the.respe
7e400 63 74 69 76 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 5c 6e 22 0a 20 20 20 20 20 20 20 ctive.suffix.command.\n"........
7e420 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 .............'face.'transient-he
7e440 61 64 69 6e 67 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 3c 4b 45 59 ading).........(propertize."<KEY
7e460 3e 22 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 >".'face.'transient-key)........
7e480 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 3c 4e 3e 22 20 20 20 27 66 61 63 65 20 27 74 72 61 6e .(propertize."<N>"...'face.'tran
7e4a0 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 sient-key).........(propertize."
7e4c0 20 4e 20 22 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 64 2d .N."...'face.'transient-enabled-
7e4e0 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 63 6f 6e suffix).........(propertize.(con
7e500 63 61 74 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 cat.transient-common-command-pre
7e520 66 69 78 20 22 20 6c 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 66 fix.".l").....................'f
7e540 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f ace.'transient-key).........(pro
7e560 70 65 72 74 69 7a 65 20 22 3c 4e 3e 22 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 pertize."<N>"...'face.'transient
7e580 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 20 4e 20 22 20 -key).........(propertize.".N.".
7e5a0 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 64 2d 73 75 66 66 69 ..'face.'transient-enabled-suffi
7e5c0 78 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 43 2d 68 22 20 20 20 27 x).........(propertize."C-h"...'
7e5e0 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 29 0a 20 20 20 20 20 20 20 20 28 70 72 face.'transient-key).........(pr
7e600 6f 70 65 72 74 69 7a 65 20 22 3c 4b 45 59 3e 22 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e opertize."<KEY>".'face.'transien
7e620 74 2d 6b 65 79 29 29 29 29 0a 20 20 20 20 28 77 69 74 68 2d 73 6c 6f 74 73 20 28 6c 65 76 65 6c t-key)))).....(with-slots.(level
7e640 29 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 0a 20 20 20 20 20 20 28 69 6e 73 65 72 ).transient--prefix.......(inser
7e660 74 0a 20 20 20 20 20 20 20 28 66 6f 72 6d 61 74 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 t........(format.........(proper
7e680 74 69 7a 65 20 22 0a 54 68 65 20 63 75 72 72 65 6e 74 20 6c 65 76 65 6c 20 6f 66 20 74 68 69 73 tize.".The.current.level.of.this
7e6a0 20 6d 65 6e 75 20 69 73 20 25 73 2c 20 73 6f 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 6f 6e 20 6c 65 .menu.is.%s,.so...commands.on.le
7e6c0 76 65 6c 73 20 25 73 20 61 72 65 20 64 69 73 70 6c 61 79 65 64 2c 20 61 6e 64 0a 20 20 63 6f 6d vels.%s.are.displayed,.and...com
7e6e0 6d 61 6e 64 73 20 6f 6e 20 6c 65 76 65 6c 73 20 25 73 20 61 6e 64 20 25 73 20 61 72 65 20 6e 6f mands.on.levels.%s.and.%s.are.no
7e700 74 20 64 69 73 70 6c 61 79 65 64 2e 5c 6e 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t.displayed.\n".................
7e720 20 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 61 64 69 6e 67 29 0a 20 20 ....'face.'transient-heading)...
7e740 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 66 6f 72 6d 61 74 20 22 20 25 73 20 22 ......(propertize.(format.".%s."
7e760 20 6c 65 76 65 6c 29 20 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 .level)....'face.'transient-enab
7e780 6c 65 64 2d 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 led-suffix).........(propertize.
7e7a0 28 66 6f 72 6d 61 74 20 22 20 31 2e 2e 25 73 20 22 20 6c 65 76 65 6c 29 20 27 66 61 63 65 20 27 (format.".1..%s.".level).'face.'
7e7c0 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 64 2d 73 75 66 66 69 78 29 0a 20 20 20 20 20 20 transient-enabled-suffix).......
7e7e0 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 66 6f 72 6d 61 74 20 22 20 3e 3d 20 25 73 20 22 20 ..(propertize.(format.".>=.%s.".
7e800 28 31 2b 20 6c 65 76 65 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (1+.level)).....................
7e820 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 61 62 6c 65 64 2d 73 75 66 66 69 78 'face.'transient-disabled-suffix
7e840 29 0a 20 20 20 20 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 22 20 30 20 22 20 27 66 61 63 ).........(propertize.".0.".'fac
7e860 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 61 62 6c 65 64 2d 73 75 66 66 69 78 29 29 29 29 e.'transient-disabled-suffix))))
7e880 29 29 0a 0a 28 63 6c 2d 64 65 66 67 65 6e 65 72 69 63 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f ))..(cl-defgeneric.transient-sho
7e8a0 77 2d 73 75 6d 6d 61 72 79 20 28 6f 62 6a 20 26 6f 70 74 69 6f 6e 61 6c 20 72 65 74 75 72 6e 29 w-summary.(obj.&optional.return)
7e8c0 0a 20 20 22 53 68 6f 77 20 62 72 69 65 66 20 73 75 6d 6d 61 72 79 20 61 62 6f 75 74 20 74 68 65 ..."Show.brief.summary.about.the
7e8e0 20 63 6f 6d 6d 61 6e 64 20 61 74 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 65 63 68 6f 20 61 72 .command.at.point.in.the.echo.ar
7e900 65 61 2e 0a 0a 49 66 20 4f 42 4a 27 73 20 60 73 75 6d 6d 61 72 79 27 20 73 6c 6f 74 20 69 73 20 ea...If.OBJ's.`summary'.slot.is.
7e920 61 20 73 74 72 69 6e 67 2c 20 75 73 65 20 74 68 61 74 2e 20 20 49 66 20 69 74 20 69 73 20 61 20 a.string,.use.that...If.it.is.a.
7e940 66 75 6e 63 74 69 6f 6e 2c 0a 63 61 6c 6c 20 74 68 61 74 20 77 69 74 68 20 4f 42 4a 20 61 73 20 function,.call.that.with.OBJ.as.
7e960 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 75 73 65 20 74 68 65 20 72 65 the.only.argument.and.use.the.re
7e980 74 75 72 6e 65 64 20 73 74 72 69 6e 67 2e 0a 49 66 20 60 73 75 6d 6d 61 72 79 27 20 69 73 20 6f turned.string..If.`summary'.is.o
7e9a0 72 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 61 r.returns.something.other.than.a
7e9c0 20 73 74 72 69 6e 67 20 6f 72 20 6e 69 6c 2c 0a 73 68 6f 77 20 6e 6f 20 73 75 6d 6d 61 72 79 2e .string.or.nil,.show.no.summary.
7e9e0 20 20 49 66 20 60 73 75 6d 6d 61 72 79 27 20 69 73 20 6f 72 20 72 65 74 75 72 6e 73 20 6e 69 6c ..If.`summary'.is.or.returns.nil
7ea00 2c 20 75 73 65 20 74 68 65 20 66 69 72 73 74 20 6c 69 6e 65 0a 6f 66 20 74 68 65 20 64 6f 63 75 ,.use.the.first.line.of.the.docu
7ea20 6d 65 6e 74 61 74 69 6f 6e 20 73 74 72 69 6e 67 2c 20 69 66 20 61 6e 79 2e 0a 0a 49 66 20 52 45 mentation.string,.if.any...If.RE
7ea40 54 55 52 4e 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 20 72 65 74 75 72 6e 20 74 68 65 20 73 75 6d 6d TURN.is.non-nil,.return.the.summ
7ea60 61 72 79 20 69 6e 73 74 65 61 64 20 6f 66 20 73 68 6f 77 69 6e 67 20 69 74 2e 0a 54 68 69 73 20 ary.instead.of.showing.it..This.
7ea80 69 73 20 75 73 65 64 20 77 68 65 6e 20 61 20 74 6f 6f 6c 74 69 70 20 69 73 20 6e 65 65 64 65 64 is.used.when.a.tooltip.is.needed
7eaa0 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f .")..(cl-defmethod.transient-sho
7eac0 77 2d 73 75 6d 6d 61 72 79 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 w-summary.((obj.transient-suffix
7eae0 29 20 26 6f 70 74 69 6f 6e 61 6c 20 72 65 74 75 72 6e 29 0a 20 20 28 77 69 74 68 2d 73 6c 6f 74 ).&optional.return)...(with-slot
7eb00 73 20 28 63 6f 6d 6d 61 6e 64 20 73 75 6d 6d 61 72 79 29 20 6f 62 6a 0a 20 20 20 20 28 77 68 65 s.(command.summary).obj.....(whe
7eb20 6e 2d 6c 65 74 2a 0a 20 20 20 20 20 20 20 20 28 28 64 6f 63 20 28 63 6f 6e 64 20 28 28 66 75 6e n-let*.........((doc.(cond.((fun
7eb40 63 74 69 6f 6e 70 20 73 75 6d 6d 61 72 79 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ctionp.summary).................
7eb60 20 20 20 20 20 28 66 75 6e 63 61 6c 6c 20 73 75 6d 6d 61 72 79 20 6f 62 6a 29 29 0a 20 20 20 20 .....(funcall.summary.obj)).....
7eb80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 6d 6d 61 72 79 29 0a 20 20 20 20 20 20 ................(summary).......
7eba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 28 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 63 6f ..............((documentation.co
7ebc0 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 61 72 mmand)......................(car
7ebe0 20 28 73 70 6c 69 74 2d 73 74 72 69 6e 67 20 28 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 63 6f .(split-string.(documentation.co
7ec00 6d 6d 61 6e 64 29 20 22 5c 6e 22 29 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 5f 28 73 74 72 mmand)."\n")))))..........(_(str
7ec20 69 6e 67 70 20 64 6f 63 29 29 0a 20 20 20 20 20 20 20 20 20 28 5f 28 6e 6f 74 20 28 65 71 75 61 ingp.doc))..........(_(not.(equa
7ec40 6c 20 64 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 28 63 61 l.doc........................(ca
7ec60 72 20 28 73 70 6c 69 74 2d 73 74 72 69 6e 67 20 28 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0a 20 r.(split-string.(documentation..
7ec80 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 ................................
7eca0 20 20 20 20 20 20 20 20 20 20 27 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 66 61 75 6c 74 2d 69 6e ..........'transient--default-in
7ecc0 66 69 78 2d 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 fix-command)....................
7ece0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 5c 6e 22 29 29 29 29 29 ......................."\n")))))
7ed00 29 0a 20 20 20 20 20 20 28 77 68 65 6e 20 28 73 74 72 69 6e 67 2d 73 75 66 66 69 78 2d 70 20 22 ).......(when.(string-suffix-p."
7ed20 2e 22 20 64 6f 63 29 0a 20 20 20 20 20 20 20 20 28 73 65 74 71 20 64 6f 63 20 28 73 75 62 73 74 .".doc).........(setq.doc.(subst
7ed40 72 69 6e 67 20 64 6f 63 20 30 20 2d 31 29 29 29 0a 20 20 20 20 20 20 28 69 66 20 72 65 74 75 72 ring.doc.0.-1))).......(if.retur
7ed60 6e 0a 20 20 20 20 20 20 20 20 20 20 64 6f 63 0a 20 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 6d n...........doc.........(let.((m
7ed80 65 73 73 61 67 65 2d 6c 6f 67 2d 6d 61 78 20 6e 69 6c 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 essage-log-max.nil))...........(
7eda0 6d 65 73 73 61 67 65 20 22 25 73 22 20 64 6f 63 29 29 29 29 29 29 0a 0a 3b 3b 3b 20 4d 65 6e 75 message."%s".doc))))))..;;;.Menu
7edc0 20 4e 61 76 69 67 61 74 69 6f 6e 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 73 63 .Navigation..(defun.transient-sc
7ede0 72 6f 6c 6c 2d 75 70 20 28 26 6f 70 74 69 6f 6e 61 6c 20 61 72 67 29 0a 20 20 22 53 63 72 6f 6c roll-up.(&optional.arg)..."Scrol
7ee00 6c 20 74 65 78 74 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 77 69 6e 64 6f l.text.of.transient's.menu.windo
7ee20 77 20 75 70 77 61 72 64 20 41 52 47 20 6c 69 6e 65 73 2e 0a 49 66 20 41 52 47 20 69 73 20 6e 69 w.upward.ARG.lines..If.ARG.is.ni
7ee40 6c 20 73 63 72 6f 6c 6c 20 6e 65 61 72 20 66 75 6c 6c 20 73 63 72 65 65 6e 2e 20 20 54 68 69 73 l.scroll.near.full.screen...This
7ee60 20 69 73 20 61 20 77 72 61 70 70 65 72 0a 61 72 6f 75 6e 64 20 60 73 63 72 6f 6c 6c 2d 75 70 2d .is.a.wrapper.around.`scroll-up-
7ee80 63 6f 6d 6d 61 6e 64 27 20 28 77 68 69 63 68 20 73 65 65 29 2e 22 0a 20 20 28 69 6e 74 65 72 61 command'.(which.see)."...(intera
7eea0 63 74 69 76 65 20 22 5e 50 22 29 0a 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e ctive."^P")...(with-selected-win
7eec0 64 6f 77 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a 20 20 20 20 28 73 63 72 6f 6c dow.transient--window.....(scrol
7eee0 6c 2d 75 70 2d 63 6f 6d 6d 61 6e 64 20 61 72 67 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e l-up-command.arg)))..(defun.tran
7ef00 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 64 6f 77 6e 20 28 26 6f 70 74 69 6f 6e 61 6c 20 61 72 67 sient-scroll-down.(&optional.arg
7ef20 29 0a 20 20 22 53 63 72 6f 6c 6c 20 74 65 78 74 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 27 73 20 )..."Scroll.text.of.transient's.
7ef40 6d 65 6e 75 20 77 69 6e 64 6f 77 20 64 6f 77 6e 20 41 52 47 20 6c 69 6e 65 73 2e 0a 49 66 20 41 menu.window.down.ARG.lines..If.A
7ef60 52 47 20 69 73 20 6e 69 6c 20 73 63 72 6f 6c 6c 20 6e 65 61 72 20 66 75 6c 6c 20 73 63 72 65 65 RG.is.nil.scroll.near.full.scree
7ef80 6e 2e 20 20 54 68 69 73 20 69 73 20 61 20 77 72 61 70 70 65 72 0a 61 72 6f 75 6e 64 20 60 73 63 n...This.is.a.wrapper.around.`sc
7efa0 72 6f 6c 6c 2d 64 6f 77 6e 2d 63 6f 6d 6d 61 6e 64 27 20 28 77 68 69 63 68 20 73 65 65 29 2e 22 roll-down-command'.(which.see)."
7efc0 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 20 22 5e 50 22 29 0a 20 20 28 77 69 74 68 2d 73 65 ...(interactive."^P")...(with-se
7efe0 6c 65 63 74 65 64 2d 77 69 6e 64 6f 77 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a lected-window.transient--window.
7f000 20 20 20 20 28 73 63 72 6f 6c 6c 2d 64 6f 77 6e 2d 63 6f 6d 6d 61 6e 64 20 61 72 67 29 29 29 0a ....(scroll-down-command.arg))).
7f020 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 62 61 63 6b 77 61 72 64 2d 62 75 74 74 6f .(defun.transient-backward-butto
7f040 6e 20 28 6e 29 0a 20 20 22 4d 6f 76 65 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 62 75 n.(n)..."Move.to.the.previous.bu
7f060 74 74 6f 6e 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 66 65 72 2e tton.in.transient's.menu.buffer.
7f080 0a 53 65 65 20 60 62 61 63 6b 77 61 72 64 2d 62 75 74 74 6f 6e 27 20 66 6f 72 20 69 6e 66 6f 72 .See.`backward-button'.for.infor
7f0a0 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 4e 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 20 mation.about.N."...(interactive.
7f0c0 22 70 22 29 0a 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f 77 20 74 72 61 "p")...(with-selected-window.tra
7f0e0 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a 20 20 20 20 28 62 61 63 6b 77 61 72 64 2d 62 75 74 nsient--window.....(backward-but
7f100 74 6f 6e 20 6e 20 74 29 0a 20 20 20 20 28 77 68 65 6e 20 28 65 71 20 74 72 61 6e 73 69 65 6e 74 ton.n.t).....(when.(eq.transient
7f120 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 20 27 76 65 72 62 6f 73 -enable-popup-navigation.'verbos
7f140 65 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 72 79 e).......(transient-show-summary
7f160 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 28 70 6f 69 6e 74 29 20 27 73 75 66 .(get-text-property.(point).'suf
7f180 66 69 78 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 77 61 fix)))))..(defun.transient-forwa
7f1a0 72 64 2d 62 75 74 74 6f 6e 20 28 6e 29 0a 20 20 22 4d 6f 76 65 20 74 6f 20 74 68 65 20 6e 65 78 rd-button.(n)..."Move.to.the.nex
7f1c0 74 20 62 75 74 74 6f 6e 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 27 73 20 6d 65 6e 75 20 62 75 66 t.button.in.transient's.menu.buf
7f1e0 66 65 72 2e 0a 53 65 65 20 60 66 6f 72 77 61 72 64 2d 62 75 74 74 6f 6e 27 20 66 6f 72 20 69 6e fer..See.`forward-button'.for.in
7f200 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 4e 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 formation.about.N."...(interacti
7f220 76 65 20 22 70 22 29 0a 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f 77 20 ve."p")...(with-selected-window.
7f240 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f 77 0a 20 20 20 20 28 66 6f 72 77 61 72 64 2d 62 transient--window.....(forward-b
7f260 75 74 74 6f 6e 20 6e 20 74 29 0a 20 20 20 20 28 77 68 65 6e 20 28 65 71 20 74 72 61 6e 73 69 65 utton.n.t).....(when.(eq.transie
7f280 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 67 61 74 69 6f 6e 20 27 76 65 72 62 nt-enable-popup-navigation.'verb
7f2a0 6f 73 65 29 0a 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 ose).......(transient-show-summa
7f2c0 72 79 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 28 70 6f 69 6e 74 29 20 27 73 ry.(get-text-property.(point).'s
7f2e0 75 66 66 69 78 29 29 29 29 29 0a 0a 28 64 65 66 69 6e 65 2d 62 75 74 74 6f 6e 2d 74 79 70 65 20 uffix)))))..(define-button-type.
7f300 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 27 66 61 63 65 20 6e 69 6c 0a 20 20 27 6b 65 79 6d 61 70 'transient...'face.nil...'keymap
7f320 20 74 72 61 6e 73 69 65 6e 74 2d 62 75 74 74 6f 6e 2d 6d 61 70 0a 20 20 27 68 65 6c 70 2d 65 63 .transient-button-map...'help-ec
7f340 68 6f 20 28 6c 61 6d 62 64 61 20 28 77 69 6e 20 62 75 66 20 70 6f 73 29 0a 20 20 20 20 20 20 20 ho.(lambda.(win.buf.pos)........
7f360 20 20 20 20 20 20 20 20 28 77 69 74 68 2d 73 65 6c 65 63 74 65 64 2d 77 69 6e 64 6f 77 20 77 69 ........(with-selected-window.wi
7f380 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 69 74 68 2d 63 75 72 72 65 6e 74 n..................(with-current
7f3a0 2d 62 75 66 66 65 72 20 62 75 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 -buffer.buf....................(
7f3c0 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 73 75 6d 6d 61 72 79 0a 20 20 20 20 20 20 20 20 20 transient-show-summary..........
7f3e0 20 20 20 20 20 20 20 20 20 20 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 79 20 70 6f ...........(get-text-property.po
7f400 73 20 27 73 75 66 66 69 78 29 20 74 29 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 s.'suffix).t)))))..(defun.transi
7f420 65 6e 74 2d 2d 67 6f 74 6f 2d 62 75 74 74 6f 6e 20 28 63 6f 6d 6d 61 6e 64 29 0a 20 20 28 63 6f ent--goto-button.(command)...(co
7f440 6e 64 0a 20 20 20 28 28 73 74 72 69 6e 67 70 20 63 6f 6d 6d 61 6e 64 29 0a 20 20 20 20 28 77 68 nd....((stringp.command).....(wh
7f460 65 6e 20 28 72 65 2d 73 65 61 72 63 68 2d 66 6f 72 77 61 72 64 20 28 63 6f 6e 63 61 74 20 22 5e en.(re-search-forward.(concat."^
7f480 22 20 28 72 65 67 65 78 70 2d 71 75 6f 74 65 20 63 6f 6d 6d 61 6e 64 29 29 20 6e 69 6c 20 74 29 ".(regexp-quote.command)).nil.t)
7f4a0 0a 20 20 20 20 20 20 28 67 6f 74 6f 2d 63 68 61 72 20 28 6d 61 74 63 68 2d 62 65 67 69 6e 6e 69 .......(goto-char.(match-beginni
7f4c0 6e 67 20 30 29 29 29 29 0a 20 20 20 28 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 28 63 6c 2d 66 6c 65 ng.0))))....(command.....(cl-fle
7f4e0 74 20 28 28 66 6f 75 6e 64 20 28 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 61 6e t.((found.().................(an
7f500 64 2d 6c 65 74 2a 20 28 28 62 75 74 74 6f 6e 20 28 62 75 74 74 6f 6e 2d 61 74 20 28 70 6f 69 6e d-let*.((button.(button-at.(poin
7f520 74 29 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 71 20 28 62 75 74 t))))...................(eq.(but
7f540 74 6f 6e 2d 67 65 74 20 62 75 74 74 6f 6e 20 27 63 6f 6d 6d 61 6e 64 29 20 63 6f 6d 6d 61 6e 64 ton-get.button.'command).command
7f560 29 29 29 29 0a 20 20 20 20 20 20 28 77 68 69 6c 65 20 28 61 6e 64 20 28 69 67 6e 6f 72 65 2d 65 )))).......(while.(and.(ignore-e
7f580 72 72 6f 72 73 20 28 66 6f 72 77 61 72 64 2d 62 75 74 74 6f 6e 20 31 29 29 0a 20 20 20 20 20 20 rrors.(forward-button.1)).......
7f5a0 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 20 28 66 6f 75 6e 64 29 29 29 29 0a 20 20 20 20 ............(not.(found)))).....
7f5c0 20 20 28 75 6e 6c 65 73 73 20 28 66 6f 75 6e 64 29 0a 20 20 20 20 20 20 20 20 28 67 6f 74 6f 2d ..(unless.(found).........(goto-
7f5e0 63 68 61 72 20 28 70 6f 69 6e 74 2d 6d 69 6e 29 29 0a 20 20 20 20 20 20 20 20 28 69 67 6e 6f 72 char.(point-min)).........(ignor
7f600 65 2d 65 72 72 6f 72 73 20 28 66 6f 72 77 61 72 64 2d 62 75 74 74 6f 6e 20 31 29 29 0a 20 20 20 e-errors.(forward-button.1))....
7f620 20 20 20 20 20 28 75 6e 6c 65 73 73 20 28 66 6f 75 6e 64 29 0a 20 20 20 20 20 20 20 20 20 20 28 .....(unless.(found)...........(
7f640 67 6f 74 6f 2d 63 68 61 72 20 28 70 6f 69 6e 74 2d 6d 69 6e 29 29 29 29 29 29 29 29 0a 0a 28 64 goto-char.(point-min))))))))..(d
7f660 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 68 65 61 64 69 6e 67 2d 61 74 2d 70 6f 69 6e 74 efun.transient--heading-at-point
7f680 20 28 29 0a 20 20 28 61 6e 64 20 28 65 71 20 28 67 65 74 2d 74 65 78 74 2d 70 72 6f 70 65 72 74 .()...(and.(eq.(get-text-propert
7f6a0 79 20 28 70 6f 69 6e 74 29 20 27 66 61 63 65 29 20 27 74 72 61 6e 73 69 65 6e 74 2d 68 65 61 64 y.(point).'face).'transient-head
7f6c0 69 6e 67 29 0a 20 20 20 20 20 20 20 28 6c 65 74 20 28 28 62 65 67 20 28 6c 69 6e 65 2d 62 65 67 ing)........(let.((beg.(line-beg
7f6e0 69 6e 6e 69 6e 67 2d 70 6f 73 69 74 69 6f 6e 29 29 29 0a 20 20 20 20 20 20 20 20 20 28 62 75 66 inning-position)))..........(buf
7f700 66 65 72 2d 73 75 62 73 74 72 69 6e 67 2d 6e 6f 2d 70 72 6f 70 65 72 74 69 65 73 0a 20 20 20 20 fer-substring-no-properties.....
7f720 20 20 20 20 20 20 62 65 67 20 28 6e 65 78 74 2d 73 69 6e 67 6c 65 2d 70 72 6f 70 65 72 74 79 2d ......beg.(next-single-property-
7f740 63 68 61 6e 67 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 65 67 20 27 66 61 63 65 20 change................beg.'face.
7f760 6e 69 6c 20 28 6c 69 6e 65 2d 65 6e 64 2d 70 6f 73 69 74 69 6f 6e 29 29 29 29 29 29 0a 0a 3b 3b nil.(line-end-position))))))..;;
7f780 3b 20 43 6f 6d 70 61 74 69 62 69 6c 69 74 79 0a 3b 3b 3b 3b 20 4d 65 6e 75 20 49 73 65 61 72 63 ;.Compatibility.;;;;.Menu.Isearc
7f7a0 68 0a 0a 28 64 65 66 76 61 72 2d 6b 65 79 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 h..(defvar-keymap.transient--ise
7f7c0 61 72 63 68 2d 6d 6f 64 65 2d 6d 61 70 0a 20 20 3a 70 61 72 65 6e 74 20 69 73 65 61 72 63 68 2d arch-mode-map...:parent.isearch-
7f7e0 6d 6f 64 65 2d 6d 61 70 0a 20 20 22 3c 72 65 6d 61 70 3e 20 3c 69 73 65 61 72 63 68 2d 65 78 69 mode-map..."<remap>.<isearch-exi
7f800 74 3e 22 20 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 65 78 69 74 0a 20 t>"...#'transient-isearch-exit..
7f820 20 22 3c 72 65 6d 61 70 3e 20 3c 69 73 65 61 72 63 68 2d 63 61 6e 63 65 6c 3e 22 20 23 27 74 72 ."<remap>.<isearch-cancel>".#'tr
7f840 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 63 61 6e 63 65 6c 0a 20 20 22 3c 72 65 6d 61 70 ansient-isearch-cancel..."<remap
7f860 3e 20 3c 69 73 65 61 72 63 68 2d 61 62 6f 72 74 3e 22 20 20 23 27 74 72 61 6e 73 69 65 6e 74 2d >.<isearch-abort>"..#'transient-
7f880 69 73 65 61 72 63 68 2d 61 62 6f 72 74 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 isearch-abort)..(defun.transient
7f8a0 2d 69 73 65 61 72 63 68 2d 62 61 63 6b 77 61 72 64 20 28 26 6f 70 74 69 6f 6e 61 6c 20 72 65 67 -isearch-backward.(&optional.reg
7f8c0 65 78 70 2d 70 29 0a 20 20 22 44 6f 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 73 65 61 72 63 68 20 exp-p)..."Do.incremental.search.
7f8e0 62 61 63 6b 77 61 72 64 2e 0a 57 69 74 68 20 61 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 backward..With.a.prefix.argument
7f900 2c 20 64 6f 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 72 65 67 75 6c 61 72 20 65 78 70 72 ,.do.an.incremental.regular.expr
7f920 65 73 73 69 6f 6e 0a 73 65 61 72 63 68 20 69 6e 73 74 65 61 64 2e 22 0a 20 20 28 69 6e 74 65 72 ession.search.instead."...(inter
7f940 61 63 74 69 76 65 20 22 50 22 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 active."P")...(transient--isearc
7f960 68 2d 73 65 74 75 70 29 0a 20 20 28 6c 65 74 20 28 28 69 73 65 61 72 63 68 2d 6d 6f 64 65 2d 6d h-setup)...(let.((isearch-mode-m
7f980 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 68 2d 6d 6f 64 65 2d 6d 61 70 29 29 ap.transient--isearch-mode-map))
7f9a0 0a 20 20 20 20 28 69 73 65 61 72 63 68 2d 6d 6f 64 65 20 6e 69 6c 20 72 65 67 65 78 70 2d 70 29 .....(isearch-mode.nil.regexp-p)
7f9c0 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 66 6f 72 ))..(defun.transient-isearch-for
7f9e0 77 61 72 64 20 28 26 6f 70 74 69 6f 6e 61 6c 20 72 65 67 65 78 70 2d 70 29 0a 20 20 22 44 6f 20 ward.(&optional.regexp-p)..."Do.
7fa00 69 6e 63 72 65 6d 65 6e 74 61 6c 20 73 65 61 72 63 68 20 66 6f 72 77 61 72 64 2e 0a 57 69 74 68 incremental.search.forward..With
7fa20 20 61 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 2c 20 64 6f 20 61 6e 20 69 6e 63 72 65 6d .a.prefix.argument,.do.an.increm
7fa40 65 6e 74 61 6c 20 72 65 67 75 6c 61 72 20 65 78 70 72 65 73 73 69 6f 6e 0a 73 65 61 72 63 68 20 ental.regular.expression.search.
7fa60 69 6e 73 74 65 61 64 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 20 22 50 22 29 0a 20 20 instead."...(interactive."P")...
7fa80 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 68 2d 73 65 74 75 70 29 0a 20 20 28 6c 65 (transient--isearch-setup)...(le
7faa0 74 20 28 28 69 73 65 61 72 63 68 2d 6d 6f 64 65 2d 6d 61 70 20 74 72 61 6e 73 69 65 6e 74 2d 2d t.((isearch-mode-map.transient--
7fac0 69 73 65 61 72 63 68 2d 6d 6f 64 65 2d 6d 61 70 29 29 0a 20 20 20 20 28 69 73 65 61 72 63 68 2d isearch-mode-map)).....(isearch-
7fae0 6d 6f 64 65 20 74 20 72 65 67 65 78 70 2d 70 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 mode.t.regexp-p)))..(defun.trans
7fb00 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 65 78 69 74 20 28 29 0a 20 20 22 4c 69 6b 65 20 60 69 73 ient-isearch-exit.()..."Like.`is
7fb20 65 61 72 63 68 2d 65 78 69 74 27 20 62 75 74 20 61 64 61 70 74 65 64 20 66 6f 72 20 60 74 72 61 earch-exit'.but.adapted.for.`tra
7fb40 6e 73 69 65 6e 74 27 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 69 73 65 nsient'."...(interactive)...(ise
7fb60 61 72 63 68 2d 65 78 69 74 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 68 arch-exit)...(transient--isearch
7fb80 2d 65 78 69 74 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 -exit))..(defun.transient-isearc
7fba0 68 2d 63 61 6e 63 65 6c 20 28 29 0a 20 20 22 4c 69 6b 65 20 60 69 73 65 61 72 63 68 2d 63 61 6e h-cancel.()..."Like.`isearch-can
7fbc0 63 65 6c 27 20 62 75 74 20 61 64 61 70 74 65 64 20 66 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 27 cel'.but.adapted.for.`transient'
7fbe0 2e 22 0a 20 20 28 69 6e 74 65 72 61 63 74 69 76 65 29 0a 20 20 28 63 6f 6e 64 69 74 69 6f 6e 2d ."...(interactive)...(condition-
7fc00 63 61 73 65 20 6e 69 6c 20 28 69 73 65 61 72 63 68 2d 63 61 6e 63 65 6c 29 20 28 71 75 69 74 29 case.nil.(isearch-cancel).(quit)
7fc20 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 68 2d 65 78 69 74 29 29 0a 0a )...(transient--isearch-exit))..
7fc40 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 69 73 65 61 72 63 68 2d 61 62 6f 72 74 20 28 (defun.transient-isearch-abort.(
7fc60 29 0a 20 20 22 4c 69 6b 65 20 60 69 73 65 61 72 63 68 2d 61 62 6f 72 74 27 20 62 75 74 20 61 64 )..."Like.`isearch-abort'.but.ad
7fc80 61 70 74 65 64 20 66 6f 72 20 60 74 72 61 6e 73 69 65 6e 74 27 2e 22 0a 20 20 28 69 6e 74 65 72 apted.for.`transient'."...(inter
7fca0 61 63 74 69 76 65 29 0a 20 20 28 6c 65 74 20 28 28 61 72 6f 75 6e 64 20 28 6c 61 6d 62 64 61 20 active)...(let.((around.(lambda.
7fcc0 28 66 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e 64 69 74 69 6f (fn)...................(conditio
7fce0 6e 2d 63 61 73 65 20 6e 69 6c 20 28 66 75 6e 63 61 6c 6c 20 66 6e 29 20 28 71 75 69 74 29 29 0a n-case.nil.(funcall.fn).(quit)).
7fd00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 ..................(transient--is
7fd20 65 61 72 63 68 2d 65 78 69 74 29 29 29 29 0a 20 20 20 20 28 61 64 76 69 63 65 2d 61 64 64 20 27 earch-exit)))).....(advice-add.'
7fd40 69 73 65 61 72 63 68 2d 63 61 6e 63 65 6c 20 3a 61 72 6f 75 6e 64 20 61 72 6f 75 6e 64 29 0a 20 isearch-cancel.:around.around)..
7fd60 20 20 20 28 75 6e 77 69 6e 64 2d 70 72 6f 74 65 63 74 0a 20 20 20 20 20 20 20 20 28 69 73 65 61 ...(unwind-protect.........(isea
7fd80 72 63 68 2d 61 62 6f 72 74 29 0a 20 20 20 20 20 20 28 61 64 76 69 63 65 2d 72 65 6d 6f 76 65 20 rch-abort).......(advice-remove.
7fda0 27 69 73 65 61 72 63 68 2d 63 61 6e 63 65 6c 20 61 72 6f 75 6e 64 29 29 29 29 0a 0a 28 64 65 66 'isearch-cancel.around))))..(def
7fdc0 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 68 2d 73 65 74 75 70 20 28 29 0a 20 un.transient--isearch-setup.()..
7fde0 20 28 73 65 6c 65 63 74 2d 77 69 6e 64 6f 77 20 74 72 61 6e 73 69 65 6e 74 2d 2d 77 69 6e 64 6f .(select-window.transient--windo
7fe00 77 29 0a 20 20 28 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 6f 76 65 72 72 69 64 w)...(transient--suspend-overrid
7fe20 65 20 74 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 73 65 61 72 63 68 e.t))..(defun.transient--isearch
7fe40 2d 65 78 69 74 20 28 29 0a 20 20 28 73 65 6c 65 63 74 2d 77 69 6e 64 6f 77 20 74 72 61 6e 73 69 -exit.()...(select-window.transi
7fe60 65 6e 74 2d 2d 6f 72 69 67 69 6e 61 6c 2d 77 69 6e 64 6f 77 29 0a 20 20 28 74 72 61 6e 73 69 65 ent--original-window)...(transie
7fe80 6e 74 2d 2d 72 65 73 75 6d 65 2d 6f 76 65 72 72 69 64 65 29 29 0a 0a 3b 3b 3b 3b 20 45 64 65 62 nt--resume-override))..;;;;.Edeb
7fea0 75 67 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 65 64 65 62 75 67 2d 63 6f 6d ug..(defun.transient--edebug-com
7fec0 6d 61 6e 64 2d 70 20 28 29 0a 20 20 28 61 6e 64 20 28 62 6f 75 6e 64 2d 61 6e 64 2d 74 72 75 65 mand-p.()...(and.(bound-and-true
7fee0 2d 70 20 65 64 65 62 75 67 2d 61 63 74 69 76 65 29 0a 20 20 20 20 20 20 20 28 6f 72 20 28 6d 65 -p.edebug-active)........(or.(me
7ff00 6d 71 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 20 27 28 74 6f 70 2d 6c 65 76 65 6c 20 61 62 6f 72 mq.this-command.'(top-level.abor
7ff20 74 2d 72 65 63 75 72 73 69 76 65 2d 65 64 69 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 73 t-recursive-edit))............(s
7ff40 74 72 69 6e 67 2d 70 72 65 66 69 78 2d 70 20 22 65 64 65 62 75 67 22 20 28 73 79 6d 62 6f 6c 2d tring-prefix-p."edebug".(symbol-
7ff60 6e 61 6d 65 20 74 68 69 73 2d 63 6f 6d 6d 61 6e 64 29 29 29 29 29 0a 0a 3b 3b 3b 3b 20 4d 69 73 name.this-command)))))..;;;;.Mis
7ff80 63 65 6c 6c 61 6e 65 6f 75 73 0a 0a 28 63 6c 2d 70 75 73 68 6e 65 77 20 28 6c 69 73 74 20 6e 69 cellaneous..(cl-pushnew.(list.ni
7ffa0 6c 20 28 63 6f 6e 63 61 74 20 22 5e 5c 5c 73 2d 2a 28 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 l.(concat."^\\s-*(".............
7ffc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 76 61 6c 2d 77 68 65 6e 2d 63 6f 6d ..................(eval-when-com
7ffe0 70 69 6c 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 20 20 20 20 pile............................
80000 20 20 20 20 20 28 72 65 67 65 78 70 2d 6f 70 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .....(regexp-opt................
80020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 28 22 74 72 61 6e 73 69 65 6e 74 2d 64 ..................'("transient-d
80040 65 66 69 6e 65 2d 70 72 65 66 69 78 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 efine-prefix"...................
80060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 ................."transient-defi
80080 6e 65 2d 73 75 66 66 69 78 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ne-suffix"......................
800a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d .............."transient-define-
800c0 69 6e 66 69 78 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 20 20 infix"..........................
800e0 20 20 20 20 20 20 20 20 20 20 22 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 61 72 67 75 .........."transient-define-argu
80100 6d 65 6e 74 22 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 ment")..........................
80120 20 20 20 20 20 20 20 20 74 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ........t)).....................
80140 20 20 20 20 20 20 20 20 20 20 22 5c 5c 73 2d 2b 5c 5c 28 22 20 6c 69 73 70 2d 6d 6f 64 65 2d 73 .........."\\s-+\\(".lisp-mode-s
80160 79 6d 62 6f 6c 2d 72 65 67 65 78 70 20 22 5c 5c 29 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ymbol-regexp."\\)").............
80180 20 20 20 20 20 20 32 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 73 70 2d 69 6d 65 6e 75 2d ......2).............lisp-imenu-
801a0 67 65 6e 65 72 69 63 2d 65 78 70 72 65 73 73 69 6f 6e 20 3a 74 65 73 74 20 23 27 65 71 75 61 6c generic-expression.:test.#'equal
801c0 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 74 65 78 )..(defun.transient--suspend-tex
801e0 74 2d 63 6f 6e 76 65 72 73 69 6f 6e 2d 73 74 79 6c 65 20 28 29 0a 20 20 28 73 74 61 74 69 63 2d t-conversion-style.()...(static-
80200 69 66 20 28 62 6f 75 6e 64 70 20 27 6f 76 65 72 72 69 64 69 6e 67 2d 74 65 78 74 2d 63 6f 6e 76 if.(boundp.'overriding-text-conv
80220 65 72 73 69 6f 6e 2d 73 74 79 6c 65 29 20 3b 20 73 69 6e 63 65 20 45 6d 61 63 73 20 33 30 2e 31 ersion-style).;.since.Emacs.30.1
80240 0a 20 20 20 20 20 20 28 77 68 65 6e 20 74 65 78 74 2d 63 6f 6e 76 65 72 73 69 6f 6e 2d 73 74 79 .......(when.text-conversion-sty
80260 6c 65 0a 20 20 20 20 20 20 20 20 28 6c 65 74 72 65 63 20 28 28 73 75 73 70 65 6e 64 65 64 20 6f le.........(letrec.((suspended.o
80280 76 65 72 72 69 64 69 6e 67 2d 74 65 78 74 2d 63 6f 6e 76 65 72 73 69 6f 6e 2d 73 74 79 6c 65 29 verriding-text-conversion-style)
802a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 66 6e 20 28 6c 61 6d 62 64 61 20 28 29 ..................(fn.(lambda.()
802c0 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 73 65 74 71 20 6f 76 ........................(setq.ov
802e0 65 72 72 69 64 69 6e 67 2d 74 65 78 74 2d 63 6f 6e 76 65 72 73 69 6f 6e 2d 73 74 79 6c 65 20 6e erriding-text-conversion-style.n
80300 69 6c 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 28 72 65 6d 6f il)........................(remo
80320 76 65 2d 68 6f 6f 6b 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 78 69 74 2d 68 6f 6f 6b 20 66 6e 29 ve-hook.'transient-exit-hook.fn)
80340 29 29 29 0a 20 20 20 20 20 20 20 20 20 20 28 73 65 74 71 20 6f 76 65 72 72 69 64 69 6e 67 2d 74 )))...........(setq.overriding-t
80360 65 78 74 2d 63 6f 6e 76 65 72 73 69 6f 6e 2d 73 74 79 6c 65 20 73 75 73 70 65 6e 64 65 64 29 0a ext-conversion-style.suspended).
80380 20 20 20 20 20 20 20 20 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 ..........(add-hook.'transient-e
803a0 78 69 74 2d 68 6f 6f 6b 20 66 6e 29 29 29 29 29 0a 0a 28 64 65 63 6c 61 72 65 2d 66 75 6e 63 74 xit-hook.fn)))))..(declare-funct
803c0 69 6f 6e 20 77 68 69 63 68 2d 6b 65 79 2d 6d 6f 64 65 20 22 65 78 74 3a 77 68 69 63 68 2d 6b 65 ion.which-key-mode."ext:which-ke
803e0 79 22 20 28 26 6f 70 74 69 6f 6e 61 6c 20 61 72 67 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e y".(&optional.arg))..(defun.tran
80400 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 77 68 69 63 68 2d 6b 65 79 2d 6d 6f 64 65 20 28 29 sient--suspend-which-key-mode.()
80420 0a 20 20 28 77 68 65 6e 20 28 62 6f 75 6e 64 2d 61 6e 64 2d 74 72 75 65 2d 70 20 77 68 69 63 68 ...(when.(bound-and-true-p.which
80440 2d 6b 65 79 2d 6d 6f 64 65 29 0a 20 20 20 20 28 77 68 69 63 68 2d 6b 65 79 2d 6d 6f 64 65 20 2d -key-mode).....(which-key-mode.-
80460 31 29 0a 20 20 20 20 28 61 64 64 2d 68 6f 6f 6b 20 27 74 72 61 6e 73 69 65 6e 74 2d 65 78 69 74 1).....(add-hook.'transient-exit
80480 2d 68 6f 6f 6b 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 73 75 6d 65 2d 77 68 69 63 68 2d -hook.#'transient--resume-which-
804a0 6b 65 79 2d 6d 6f 64 65 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 key-mode)))..(defun.transient--r
804c0 65 73 75 6d 65 2d 77 68 69 63 68 2d 6b 65 79 2d 6d 6f 64 65 20 28 29 0a 20 20 28 75 6e 6c 65 73 esume-which-key-mode.()...(unles
804e0 73 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 0a 20 20 20 20 28 77 68 69 63 68 2d 6b s.transient--prefix.....(which-k
80500 65 79 2d 6d 6f 64 65 20 31 29 0a 20 20 20 20 28 72 65 6d 6f 76 65 2d 68 6f 6f 6b 20 27 74 72 61 ey-mode.1).....(remove-hook.'tra
80520 6e 73 69 65 6e 74 2d 65 78 69 74 2d 68 6f 6f 6b 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 nsient-exit-hook.#'transient--re
80540 73 75 6d 65 2d 77 68 69 63 68 2d 6b 65 79 2d 6d 6f 64 65 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 sume-which-key-mode)))..(defun.t
80560 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d 71 2d 74 6f 2d 71 75 69 74 20 28 29 0a 20 20 22 4d 6f ransient-bind-q-to-quit.()..."Mo
80580 64 69 66 79 20 73 6f 6d 65 20 6b 65 79 6d 61 70 73 20 74 6f 20 62 69 6e 64 20 5c 5c 60 71 27 20 dify.some.keymaps.to.bind.\\`q'.
805a0 74 6f 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 71 75 69 74 20 63 6f 6d 6d 61 6e 64 2e to.the.appropriate.quit.command.
805c0 0a 0a 5c 5c 60 43 2d 67 27 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 69 6e 64 69 6e 67 ..\\`C-g'.is.the.default.binding
805e0 20 66 6f 72 20 73 75 63 68 20 63 6f 6d 6d 61 6e 64 73 20 6e 6f 77 2c 20 62 75 74 20 54 72 61 6e .for.such.commands.now,.but.Tran
80600 73 69 65 6e 74 27 73 0a 70 72 65 64 65 63 65 73 73 6f 72 20 4d 61 67 69 74 2d 50 6f 70 75 70 20 sient's.predecessor.Magit-Popup.
80620 75 73 65 64 20 5c 5c 60 71 27 20 69 6e 73 74 65 61 64 2e 20 20 49 66 20 79 6f 75 20 77 6f 75 6c used.\\`q'.instead...If.you.woul
80640 64 20 6c 69 6b 65 20 74 6f 20 67 65 74 0a 74 68 61 74 20 62 69 6e 64 69 6e 67 20 62 61 63 6b 2c d.like.to.get.that.binding.back,
80660 20 74 68 65 6e 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 79 6f 75 72 .then.call.this.function.in.your
80680 20 69 6e 69 74 20 66 69 6c 65 20 6c 69 6b 65 20 73 6f 3a 0a 0a 20 20 28 77 69 74 68 2d 65 76 61 .init.file.like.so:....(with-eva
806a0 6c 2d 61 66 74 65 72 2d 6c 6f 61 64 20 5c 5c 3d 27 74 72 61 6e 73 69 65 6e 74 0a 20 20 20 20 28 l-after-load.\\='transient.....(
806c0 74 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d 71 2d 74 6f 2d 71 75 69 74 29 29 0a 0a 49 6e 64 69 transient-bind-q-to-quit))..Indi
806e0 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 73 20 6d 61 79 20 61 6c 72 65 61 64 79 20 62 69 vidual.transients.may.already.bi
80700 6e 64 20 5c 5c 60 71 27 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 20 65 6c 73 65 0a 61 6e 64 20 73 nd.\\`q'.to.something.else.and.s
80720 75 63 68 20 61 20 62 69 6e 64 69 6e 67 20 77 6f 75 6c 64 20 73 68 61 64 6f 77 20 74 68 65 20 71 uch.a.binding.would.shadow.the.q
80740 75 69 74 20 62 69 6e 64 69 6e 67 2e 20 20 49 66 20 74 68 61 74 20 69 73 20 74 68 65 0a 63 61 73 uit.binding...If.that.is.the.cas
80760 65 20 74 68 65 6e 20 5c 5c 60 51 27 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 77 68 61 74 65 76 65 e.then.\\`Q'.is.bound.to.whateve
80780 72 20 5c 5c 60 71 27 20 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 62 6f 75 6e 64 0a 74 6f r.\\`q'.would.have.been.bound.to
807a0 20 62 79 20 73 65 74 74 69 6e 67 20 60 74 72 61 6e 73 69 65 6e 74 2d 73 75 62 73 74 69 74 75 74 .by.setting.`transient-substitut
807c0 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 27 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 0a 74 68 e-key-function'.to.a.function.th
807e0 61 74 20 64 6f 65 73 20 74 68 61 74 2e 20 20 4f 66 20 63 6f 75 72 73 65 20 5c 5c 60 51 27 20 6d at.does.that...Of.course.\\`Q'.m
80800 61 79 20 61 6c 72 65 61 64 79 20 62 65 20 62 6f 75 6e 64 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 ay.already.be.bound.to.something
80820 0a 65 6c 73 65 2c 20 73 6f 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 62 69 6e 64 73 20 5c 5c .else,.so.that.function.binds.\\
80840 60 4d 2d 71 27 20 74 6f 20 74 68 61 74 20 63 6f 6d 6d 61 6e 64 20 69 6e 73 74 65 61 64 2e 0a 4f `M-q'.to.that.command.instead..O
80860 66 20 63 6f 75 72 73 65 20 5c 5c 60 4d 2d 71 27 20 6d 61 79 20 61 6c 72 65 61 64 79 20 62 65 20 f.course.\\`M-q'.may.already.be.
80880 62 6f 75 6e 64 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 20 65 6c 73 65 2c 20 62 75 74 0a 77 65 20 bound.to.something.else,.but.we.
808a0 73 74 6f 70 20 74 68 65 72 65 2e 22 0a 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 74 72 61 6e 73 stop.there."...(keymap-set.trans
808c0 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 20 20 20 22 71 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d ient-base-map..."q".#'transient-
808e0 71 75 69 74 2d 6f 6e 65 29 0a 20 20 28 6b 65 79 6d 61 70 2d 73 65 74 20 74 72 61 6e 73 69 65 6e quit-one)...(keymap-set.transien
80900 74 2d 73 74 69 63 6b 79 2d 6d 61 70 20 22 71 22 20 23 27 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 t-sticky-map."q".#'transient-qui
80920 74 2d 73 65 71 29 0a 20 20 28 73 65 74 71 20 74 72 61 6e 73 69 65 6e 74 2d 73 75 62 73 74 69 74 t-seq)...(setq.transient-substit
80940 75 74 65 2d 6b 65 79 2d 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 23 27 74 72 61 6e 73 ute-key-function.........#'trans
80960 69 65 6e 74 2d 72 65 62 69 6e 64 2d 71 75 69 74 2d 63 6f 6d 6d 61 6e 64 73 29 29 0a 0a 28 64 65 ient-rebind-quit-commands))..(de
80980 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 62 69 6e 64 2d 71 75 69 74 2d 63 6f 6d 6d 61 6e fun.transient-rebind-quit-comman
809a0 64 73 20 28 6f 62 6a 29 0a 20 20 22 53 65 65 20 60 74 72 61 6e 73 69 65 6e 74 2d 62 69 6e 64 2d ds.(obj)..."See.`transient-bind-
809c0 71 2d 74 6f 2d 71 75 69 74 27 2e 22 0a 20 20 28 6c 65 74 20 28 28 6b 65 79 20 28 6f 72 65 66 20 q-to-quit'."...(let.((key.(oref.
809e0 6f 62 6a 20 6b 65 79 29 29 29 0a 20 20 20 20 28 63 6f 6e 64 20 28 28 73 74 72 69 6e 67 2d 65 71 obj.key))).....(cond.((string-eq
80a00 75 61 6c 20 6b 65 79 20 22 71 22 29 20 22 51 22 29 0a 20 20 20 20 20 20 20 20 20 20 28 28 73 74 ual.key."q")."Q")...........((st
80a20 72 69 6e 67 2d 65 71 75 61 6c 20 6b 65 79 20 22 51 22 29 20 22 4d 2d 71 22 29 0a 20 20 20 20 20 ring-equal.key."Q")."M-q")......
80a40 20 20 20 20 20 28 6b 65 79 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d .....(key))))..(defun.transient-
80a60 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 20 28 29 0a 20 20 28 72 65 71 75 69 72 65 -force-fixed-pitch.()...(require
80a80 20 27 66 61 63 65 2d 72 65 6d 61 70 29 0a 20 20 28 66 61 63 65 2d 72 65 6d 61 70 2d 72 65 73 65 .'face-remap)...(face-remap-rese
80aa0 74 2d 62 61 73 65 20 27 64 65 66 61 75 6c 74 29 0a 20 20 28 66 61 63 65 2d 72 65 6d 61 70 2d 61 t-base.'default)...(face-remap-a
80ac0 64 64 2d 72 65 6c 61 74 69 76 65 20 27 64 65 66 61 75 6c 74 20 27 66 69 78 65 64 2d 70 69 74 63 dd-relative.'default.'fixed-pitc
80ae0 68 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 66 75 6e 63 2d 61 72 69 74 h))..(defun.transient--func-arit
80b00 79 20 28 66 6e 29 0a 20 20 28 66 75 6e 63 2d 61 72 69 74 79 20 28 61 64 76 69 63 65 2d 2d 63 64 y.(fn)...(func-arity.(advice--cd
80b20 2a 72 20 28 69 66 20 28 73 79 6d 62 6f 6c 70 20 66 6e 29 20 28 73 79 6d 62 6f 6c 2d 66 75 6e 63 *r.(if.(symbolp.fn).(symbol-func
80b40 74 69 6f 6e 20 66 6e 29 20 66 6e 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e tion.fn).fn))))..(defun.transien
80b60 74 2d 2d 73 65 71 2d 72 65 64 75 63 74 69 6f 6e 73 2d 66 72 6f 6d 20 28 66 75 6e 63 74 69 6f 6e t--seq-reductions-from.(function
80b80 20 73 65 71 75 65 6e 63 65 20 69 6e 69 74 69 61 6c 2d 76 61 6c 75 65 29 0a 20 20 28 6c 65 74 20 .sequence.initial-value)...(let.
80ba0 28 28 61 63 63 20 28 6c 69 73 74 20 69 6e 69 74 69 61 6c 2d 76 61 6c 75 65 29 29 29 0a 20 20 20 ((acc.(list.initial-value)))....
80bc0 20 28 73 65 71 2d 64 6f 73 65 71 20 28 65 6c 74 20 73 65 71 75 65 6e 63 65 29 0a 20 20 20 20 20 .(seq-doseq.(elt.sequence)......
80be0 20 28 70 75 73 68 20 28 66 75 6e 63 61 6c 6c 20 66 75 6e 63 74 69 6f 6e 20 28 63 61 72 20 61 63 .(push.(funcall.function.(car.ac
80c00 63 29 20 65 6c 74 29 20 61 63 63 29 29 0a 20 20 20 20 28 6e 72 65 76 65 72 73 65 20 61 63 63 29 c).elt).acc)).....(nreverse.acc)
80c20 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 61 70 6e 20 28 66 75 6e 63 ))..(defun.transient--mapn.(func
80c40 74 69 6f 6e 20 26 72 65 73 74 20 6c 69 73 74 73 29 0a 20 20 22 41 70 70 6c 79 20 46 55 4e 43 54 tion.&rest.lists)..."Apply.FUNCT
80c60 49 4f 4e 20 74 6f 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 4c 49 53 54 53 2e 0a 4c 69 6b 65 20 60 ION.to.elements.of.LISTS..Like.`
80c80 63 6c 2d 6d 61 70 63 61 72 27 20 62 75 74 20 77 68 69 6c 65 20 74 68 61 74 20 73 74 6f 70 73 20 cl-mapcar'.but.while.that.stops.
80ca0 77 68 65 6e 20 74 68 65 20 73 68 6f 72 74 65 73 74 20 6c 69 73 74 0a 69 73 20 65 78 68 61 75 73 when.the.shortest.list.is.exhaus
80cc0 74 65 64 2c 20 63 6f 6e 74 69 6e 75 65 20 75 6e 74 69 6c 20 74 68 65 20 6c 6f 6e 67 65 73 74 20 ted,.continue.until.the.longest.
80ce0 6c 69 73 74 20 69 73 2c 20 75 73 69 6e 67 20 6e 69 6c 0a 61 73 20 73 74 61 6e 64 2d 69 6e 20 66 list.is,.using.nil.as.stand-in.f
80d00 6f 72 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 65 78 68 61 75 73 74 65 64 20 6c 69 73 74 73 2e 22 or.elements.of.exhausted.lists."
80d20 0a 20 20 28 6c 65 74 20 28 72 65 73 75 6c 74 29 0a 20 20 20 20 28 77 68 69 6c 65 20 28 63 61 74 ...(let.(result).....(while.(cat
80d40 63 68 20 27 6d 6f 72 65 20 28 6d 61 70 63 20 28 6c 61 6d 62 64 61 20 28 6c 29 20 28 61 6e 64 20 ch.'more.(mapc.(lambda.(l).(and.
80d60 6c 20 28 74 68 72 6f 77 20 27 6d 6f 72 65 20 74 29 29 29 20 6c 69 73 74 73 29 20 6e 69 6c 29 0a l.(throw.'more.t))).lists).nil).
80d80 20 20 20 20 20 20 28 70 75 73 68 20 28 61 70 70 6c 79 20 66 75 6e 63 74 69 6f 6e 20 28 6d 61 70 ......(push.(apply.function.(map
80da0 63 61 72 20 23 27 63 61 72 2d 73 61 66 65 20 6c 69 73 74 73 29 29 20 72 65 73 75 6c 74 29 0a 20 car.#'car-safe.lists)).result)..
80dc0 20 20 20 20 20 28 73 65 74 71 20 6c 69 73 74 73 20 28 6d 61 70 63 61 72 20 23 27 63 64 72 20 6c .....(setq.lists.(mapcar.#'cdr.l
80de0 69 73 74 73 29 29 29 0a 20 20 20 20 28 6e 72 65 76 65 72 73 65 20 72 65 73 75 6c 74 29 29 29 0a ists))).....(nreverse.result))).
80e00 0a 3b 3b 3b 20 46 6f 6e 74 2d 4c 6f 63 6b 0a 0a 28 64 65 66 63 6f 6e 73 74 20 74 72 61 6e 73 69 .;;;.Font-Lock..(defconst.transi
80e20 65 6e 74 2d 66 6f 6e 74 2d 6c 6f 63 6b 2d 6b 65 79 77 6f 72 64 73 0a 20 20 28 65 76 61 6c 2d 77 ent-font-lock-keywords...(eval-w
80e40 68 65 6e 2d 63 6f 6d 70 69 6c 65 0a 20 20 20 20 60 28 28 2c 28 63 6f 6e 63 61 74 20 22 28 22 0a hen-compile.....`((,(concat."(".
80e60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 72 65 67 65 78 70 2d 6f 70 74 20 28 6c 69 73 ................(regexp-opt.(lis
80e80 74 20 22 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 22 0a 20 20 20 20 t."transient-define-prefix".....
80ea0 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 22 74 .............................."t
80ec0 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 22 0a 20 20 20 20 20 20 20 20 20 ransient-define-group"..........
80ee0 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 22 74 72 61 6e 73 69 ........................."transi
80f00 65 6e 74 2d 64 65 66 69 6e 65 2d 69 6e 66 69 78 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ent-define-infix"...............
80f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 74 72 61 6e 73 69 65 6e 74 2d 64 ...................."transient-d
80f40 65 66 69 6e 65 2d 61 72 67 75 6d 65 6e 74 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 efine-argument".................
80f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 .................."transient-def
80f80 69 6e 65 2d 73 75 66 66 69 78 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ine-suffix")....................
80fa0 20 20 20 20 20 20 20 20 20 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 5c 5c 5f .........t)................."\\_
80fc0 3e 5b 20 5c 74 27 28 5d 2a 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 5c 5c 28 5c >[.\t'(]*"................."\\(\
80fe0 5c 28 3f 3a 5c 5c 73 77 5c 5c 7c 5c 5c 73 5f 5c 5c 29 2b 5c 5c 29 3f 22 29 0a 20 20 20 20 20 20 \(?:\\sw\\|\\s_\\)+\\)?").......
81000 20 28 31 20 27 66 6f 6e 74 2d 6c 6f 63 6b 2d 6b 65 79 77 6f 72 64 2d 66 61 63 65 29 0a 20 20 20 .(1.'font-lock-keyword-face)....
81020 20 20 20 20 28 32 20 27 66 6f 6e 74 2d 6c 6f 63 6b 2d 66 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 2d ....(2.'font-lock-function-name-
81040 66 61 63 65 20 6e 69 6c 20 74 29 29 29 29 29 0a 0a 28 66 6f 6e 74 2d 6c 6f 63 6b 2d 61 64 64 2d face.nil.t)))))..(font-lock-add-
81060 6b 65 79 77 6f 72 64 73 20 27 65 6d 61 63 73 2d 6c 69 73 70 2d 6d 6f 64 65 20 74 72 61 6e 73 69 keywords.'emacs-lisp-mode.transi
81080 65 6e 74 2d 66 6f 6e 74 2d 6c 6f 63 6b 2d 6b 65 79 77 6f 72 64 73 29 0a 0a 3b 3b 3b 20 41 75 78 ent-font-lock-keywords)..;;;.Aux
810a0 69 6c 69 61 72 79 20 43 6c 61 73 73 65 73 0a 3b 3b 3b 3b 20 60 74 72 61 6e 73 69 65 6e 74 2d 6c iliary.Classes.;;;;.`transient-l
810c0 69 73 70 2d 76 61 72 69 61 62 6c 65 27 0a 0a 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 isp-variable'..(defclass.transie
810e0 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 20 28 74 72 61 6e 73 69 65 6e 74 2d 76 61 72 69 nt-lisp-variable.(transient-vari
81100 61 62 6c 65 29 0a 20 20 28 28 72 65 61 64 65 72 20 3a 69 6e 69 74 66 6f 72 6d 20 23 27 74 72 61 able)...((reader.:initform.#'tra
81120 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 2d 2d 72 65 61 64 65 72 29 0a 20 20 nsient-lisp-variable--reader)...
81140 20 28 61 6c 77 61 79 73 2d 72 65 61 64 20 3a 69 6e 69 74 66 6f 72 6d 20 74 29 0a 20 20 20 28 73 .(always-read.:initform.t)....(s
81160 65 74 2d 76 61 6c 75 65 20 3a 69 6e 69 74 61 72 67 20 3a 73 65 74 2d 76 61 6c 75 65 20 3a 69 6e et-value.:initarg.:set-value.:in
81180 69 74 66 6f 72 6d 20 23 27 73 65 74 29 29 0a 20 20 22 5b 45 78 70 65 72 69 6d 65 6e 74 61 6c 5d itform.#'set))..."[Experimental]
811a0 20 43 6c 61 73 73 20 75 73 65 64 20 66 6f 72 20 4c 69 73 70 20 76 61 72 69 61 62 6c 65 73 2e 22 .Class.used.for.Lisp.variables."
811c0 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d )..(cl-defmethod.transient-init-
811e0 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 value.((obj.transient-lisp-varia
81200 62 6c 65 29 29 0a 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 28 73 79 6d 62 6f 6c 2d ble))...(oset.obj.value.(symbol-
81220 76 61 6c 75 65 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 72 69 61 62 6c 65 29 29 29 29 0a 0a 28 63 value.(oref.obj.variable))))..(c
81240 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 20 l-defmethod.transient-infix-set.
81260 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 29 20 76 ((obj.transient-lisp-variable).v
81280 61 6c 75 65 29 0a 20 20 28 66 75 6e 63 61 6c 6c 20 28 6f 72 65 66 20 6f 62 6a 20 73 65 74 2d 76 alue)...(funcall.(oref.obj.set-v
812a0 61 6c 75 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 72 69 61 alue)............(oref.obj.varia
812c0 62 6c 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6f 73 65 74 20 6f 62 6a 20 76 61 6c 75 65 20 ble)............(oset.obj.value.
812e0 76 61 6c 75 65 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e value)))..(cl-defmethod.transien
81300 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 28 6f 62 6a 20 74 72 61 6e 73 t-format-description.((obj.trans
81320 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 29 29 0a 20 20 28 6f 72 20 28 63 6c 2d 63 ient-lisp-variable))...(or.(cl-c
81340 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 6a 29 0a 20 20 20 20 20 20 28 73 79 6d 62 all-next-method.obj).......(symb
81360 6f 6c 2d 6e 61 6d 65 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 72 69 61 62 6c 65 29 29 29 29 0a 0a ol-name.(oref.obj.variable))))..
81380 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 (cl-defmethod.transient-format-v
813a0 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 alue.((obj.transient-lisp-variab
813c0 6c 65 29 29 0a 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 70 72 69 6e 31 2d 74 6f 2d 73 74 72 le))...(propertize.(prin1-to-str
813e0 69 6e 67 20 28 6f 72 65 66 20 6f 62 6a 20 76 61 6c 75 65 29 29 0a 20 20 20 20 20 20 20 20 20 20 ing.(oref.obj.value))...........
81400 20 20 20 20 27 66 61 63 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 76 61 6c 75 65 29 29 0a 0a 28 63 ....'face.'transient-value))..(c
81420 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 6f 6d 70 74 20 28 28 6f l-defmethod.transient-prompt.((o
81440 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 29 29 0a 20 20 28 bj.transient-lisp-variable))...(
81460 69 66 20 28 61 6e 64 20 28 73 6c 6f 74 2d 62 6f 75 6e 64 70 20 6f 62 6a 20 27 70 72 6f 6d 70 74 if.(and.(slot-boundp.obj.'prompt
81480 29 0a 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 65 66 20 6f 62 6a 20 70 72 6f 6d 70 74 29 29 0a )............(oref.obj.prompt)).
814a0 20 20 20 20 20 20 28 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 20 6f 62 6a 29 0a ......(cl-call-next-method.obj).
814c0 20 20 20 20 28 66 6f 72 6d 61 74 20 22 53 65 74 20 25 73 3a 20 22 20 28 6f 72 65 66 20 6f 62 6a ....(format."Set.%s:.".(oref.obj
814e0 20 76 61 72 69 61 62 6c 65 29 29 29 29 0a 0a 28 64 65 66 75 6e 20 74 72 61 6e 73 69 65 6e 74 2d .variable))))..(defun.transient-
81500 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 2d 2d 72 65 61 64 65 72 20 28 70 72 6f 6d 70 74 20 69 6e lisp-variable--reader.(prompt.in
81520 69 74 69 61 6c 2d 69 6e 70 75 74 20 5f 68 69 73 74 6f 72 79 29 0a 20 20 28 72 65 61 64 2d 2d 65 itial-input._history)...(read--e
81540 78 70 72 65 73 73 69 6f 6e 20 70 72 6f 6d 70 74 20 69 6e 69 74 69 61 6c 2d 69 6e 70 75 74 29 29 xpression.prompt.initial-input))
81560 0a 0a 3b 3b 3b 3b 20 60 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e 27 0a 0a ..;;;;.`transient-cons-option'..
81580 28 64 65 66 63 6c 61 73 73 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e 20 (defclass.transient-cons-option.
815a0 28 74 72 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e 29 0a 20 20 28 28 66 6f 72 6d 61 74 20 3a 69 (transient-option)...((format.:i
815c0 6e 69 74 66 6f 72 6d 20 22 20 25 6b 20 25 64 3a 20 25 76 22 29 29 0a 20 20 22 5b 45 78 70 65 72 nitform.".%k.%d:.%v"))..."[Exper
815e0 69 6d 65 6e 74 61 6c 5d 20 43 6c 61 73 73 20 75 73 65 64 20 66 6f 72 20 75 6e 65 6e 63 6f 64 65 imental].Class.used.for.unencode
81600 64 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 69 72 73 2e 22 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 d.key-value.pairs.")..(cl-defmet
81620 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 hod.transient-infix-value.((obj.
81640 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e 29 29 0a 20 20 22 52 65 74 75 72 transient-cons-option))..."Retur
81660 6e 20 41 52 47 55 4d 45 4e 54 20 61 6e 64 20 56 41 4c 55 45 20 61 73 20 61 20 63 6f 6e 73 2d 63 n.ARGUMENT.and.VALUE.as.a.cons-c
81680 65 6c 6c 20 6f 72 20 6e 69 6c 20 69 66 20 74 68 65 20 6c 61 74 74 65 72 20 69 73 20 6e 69 6c 2e ell.or.nil.if.the.latter.is.nil.
816a0 22 0a 20 20 28 61 6e 64 2d 6c 65 74 2a 20 28 28 76 61 6c 75 65 20 28 6f 72 65 66 20 6f 62 6a 20 "...(and-let*.((value.(oref.obj.
816c0 76 61 6c 75 65 29 29 29 0a 20 20 20 20 28 63 6f 6e 73 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 value))).....(cons.(oref.obj.arg
816e0 75 6d 65 6e 74 29 20 76 61 6c 75 65 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 ument).value)))..(cl-defmethod.t
81700 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 20 28 28 6f 62 ransient-format-description.((ob
81720 6a 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6e 73 2d 6f 70 74 69 6f 6e 29 29 0a 20 20 28 6f 72 20 j.transient-cons-option))...(or.
81740 28 6f 72 65 66 20 6f 62 6a 20 64 65 73 63 72 69 70 74 69 6f 6e 29 0a 20 20 20 20 20 20 28 6c 65 (oref.obj.description).......(le
81760 74 20 28 28 64 65 73 63 72 69 70 74 69 6f 6e 20 28 70 72 69 6e 31 2d 74 6f 2d 73 74 72 69 6e 67 t.((description.(prin1-to-string
81780 20 28 6f 72 65 66 20 6f 62 6a 20 61 72 67 75 6d 65 6e 74 29 20 74 29 29 29 0a 20 20 20 20 20 20 .(oref.obj.argument).t))).......
817a0 20 20 28 69 66 20 28 73 74 72 69 6e 67 2d 70 72 65 66 69 78 2d 70 20 22 3a 22 20 64 65 73 63 72 ..(if.(string-prefix-p.":".descr
817c0 69 70 74 69 6f 6e 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 73 75 62 73 74 72 69 6e 67 20 64 iption).............(substring.d
817e0 65 73 63 72 69 70 74 69 6f 6e 20 31 29 0a 20 20 20 20 20 20 20 20 20 20 64 65 73 63 72 69 70 74 escription.1)...........descript
81800 69 6f 6e 29 29 29 29 0a 0a 28 63 6c 2d 64 65 66 6d 65 74 68 6f 64 20 74 72 61 6e 73 69 65 6e 74 ion))))..(cl-defmethod.transient
81820 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 20 28 28 6f 62 6a 20 74 72 61 6e 73 69 65 6e 74 2d 63 6f -format-value.((obj.transient-co
81840 6e 73 2d 6f 70 74 69 6f 6e 29 29 0a 20 20 28 6c 65 74 20 28 28 76 61 6c 75 65 20 28 6f 72 65 66 ns-option))...(let.((value.(oref
81860 20 6f 62 6a 20 76 61 6c 75 65 29 29 29 0a 20 20 20 20 28 70 72 6f 70 65 72 74 69 7a 65 20 28 70 .obj.value))).....(propertize.(p
81880 72 69 6e 31 2d 74 6f 2d 73 74 72 69 6e 67 20 76 61 6c 75 65 20 74 29 20 27 66 61 63 65 0a 20 20 rin1-to-string.value.t).'face...
818a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 69 66 20 76 61 6c 75 65 20 27 74 72 61 6e 73 69 65 ..............(if.value.'transie
818c0 6e 74 2d 76 61 6c 75 65 20 27 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 63 74 69 76 65 2d 76 61 6c nt-value.'transient-inactive-val
818e0 75 65 29 29 29 29 0a 0a 3b 3b 3b 20 5f 0a 28 70 72 6f 76 69 64 65 20 27 74 72 61 6e 73 69 65 6e ue))))..;;;._.(provide.'transien
81900 74 29 0a 3b 3b 20 4c 6f 63 61 6c 20 56 61 72 69 61 62 6c 65 73 3a 0a 3b 3b 20 69 6e 64 65 6e 74 t).;;.Local.Variables:.;;.indent
81920 2d 74 61 62 73 2d 6d 6f 64 65 3a 20 6e 69 6c 0a 3b 3b 20 63 68 65 63 6b 64 6f 63 2d 73 79 6d 62 -tabs-mode:.nil.;;.checkdoc-symb
81940 6f 6c 2d 77 6f 72 64 73 3a 20 28 22 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 22 20 22 65 64 69 74 2d ol-words:.("command-line"."edit-
81960 6d 6f 64 65 22 20 22 68 65 6c 70 2d 6d 6f 64 65 22 29 0a 3b 3b 20 45 6e 64 3a 0a 3b 3b 3b 20 74 mode"."help-mode").;;.End:.;;;.t
81980 72 61 6e 73 69 65 6e 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 ransient.el.ends.here...........
819a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
819c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
819e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81a00 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 64 69 72 00 00 00 00 00 00 00 00 00 00 00 00 transient-0.10.0/dir............
81a20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81a40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81a60 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
81a80 30 30 30 31 31 34 36 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 32 37 34 31 00 20 30 00 00 00 0001146.00000000000.012741..0...
81aa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81ac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81ae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81b00 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...................
81b20 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...................
81b40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81b60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81b80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81ba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81bc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81be0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81c00 54 68 69 73 20 69 73 20 74 68 65 20 66 69 6c 65 20 2e 2e 2e 2f 69 6e 66 6f 2f 64 69 72 2c 20 77 This.is.the.file..../info/dir,.w
81c20 68 69 63 68 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 0a 74 6f 70 6d 6f 73 74 20 6e 6f 64 65 20 6f hich.contains.the.topmost.node.o
81c40 66 20 74 68 65 20 49 6e 66 6f 20 68 69 65 72 61 72 63 68 79 2c 20 63 61 6c 6c 65 64 20 28 64 69 f.the.Info.hierarchy,.called.(di
81c60 72 29 54 6f 70 2e 0a 54 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 79 6f 75 20 69 6e 76 6f 6b 65 r)Top..The.first.time.you.invoke
81c80 20 49 6e 66 6f 20 79 6f 75 20 73 74 61 72 74 20 6f 66 66 20 6c 6f 6f 6b 69 6e 67 20 61 74 20 74 .Info.you.start.off.looking.at.t
81ca0 68 69 73 20 6e 6f 64 65 2e 0a 1f 0a 46 69 6c 65 3a 20 64 69 72 2c 09 4e 6f 64 65 3a 20 54 6f 70 his.node....File:.dir,.Node:.Top
81cc0 09 54 68 69 73 20 69 73 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 20 49 4e 46 4f 20 74 72 65 .This.is.the.top.of.the.INFO.tre
81ce0 65 0a 0a 20 20 54 68 69 73 20 28 74 68 65 20 44 69 72 65 63 74 6f 72 79 20 6e 6f 64 65 29 20 67 e....This.(the.Directory.node).g
81d00 69 76 65 73 20 61 20 6d 65 6e 75 20 6f 66 20 6d 61 6a 6f 72 20 74 6f 70 69 63 73 2e 0a 20 20 54 ives.a.menu.of.major.topics....T
81d20 79 70 69 6e 67 20 22 71 22 20 65 78 69 74 73 2c 20 22 48 22 20 6c 69 73 74 73 20 61 6c 6c 20 49 yping."q".exits,."H".lists.all.I
81d40 6e 66 6f 20 63 6f 6d 6d 61 6e 64 73 2c 20 22 64 22 20 72 65 74 75 72 6e 73 20 68 65 72 65 2c 0a nfo.commands,."d".returns.here,.
81d60 20 20 22 68 22 20 67 69 76 65 73 20 61 20 70 72 69 6d 65 72 20 66 6f 72 20 66 69 72 73 74 2d 74 .."h".gives.a.primer.for.first-t
81d80 69 6d 65 72 73 2c 0a 20 20 22 6d 45 6d 61 63 73 3c 52 65 74 75 72 6e 3e 22 20 76 69 73 69 74 73 imers,..."mEmacs<Return>".visits
81da0 20 74 68 65 20 45 6d 61 63 73 20 6d 61 6e 75 61 6c 2c 20 65 74 63 2e 0a 0a 20 20 49 6e 20 45 6d .the.Emacs.manual,.etc.....In.Em
81dc0 61 63 73 2c 20 79 6f 75 20 63 61 6e 20 63 6c 69 63 6b 20 6d 6f 75 73 65 20 62 75 74 74 6f 6e 20 acs,.you.can.click.mouse.button.
81de0 32 20 6f 6e 20 61 20 6d 65 6e 75 20 69 74 65 6d 20 6f 72 20 63 72 6f 73 73 20 72 65 66 65 72 65 2.on.a.menu.item.or.cross.refere
81e00 6e 63 65 0a 20 20 74 6f 20 73 65 6c 65 63 74 20 69 74 2e 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 45 6d nce...to.select.it...*.Menu:..Em
81e20 61 63 73 20 6d 69 73 63 20 66 65 61 74 75 72 65 73 0a 2a 20 54 72 61 6e 73 69 65 6e 74 3a 20 28 acs.misc.features.*.Transient:.(
81e40 74 72 61 6e 73 69 65 6e 74 29 2e 20 20 20 20 20 20 20 54 72 61 6e 73 69 65 6e 74 20 43 6f 6d 6d transient)........Transient.Comm
81e60 61 6e 64 73 2e 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ands............................
81e80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81ea0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81ec0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81ee0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81f00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81f20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81f40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81f60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81f80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81fa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81fc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
81fe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82000 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 74 72 61 6e 73 69 65 6e 74 2d 70 6b 67 2e 65 transient-0.10.0/transient-pkg.e
82020 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...............................
82040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82060 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
82080 30 30 30 30 37 30 31 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 35 33 34 34 00 20 30 00 00 00 0000701.00000000000.015344..0...
820a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
820c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
820e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82100 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...................
82120 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...................
82140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
821a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
821c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
821e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82200 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
82220 20 66 72 6f 6d 20 74 72 61 6e 73 69 65 6e 74 2e 65 6c 20 20 2d 2a 2d 20 6e 6f 2d 62 79 74 65 2d .from.transient.el..-*-.no-byte-
82240 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 61 67 65 20 22 compile:.t.-*-.(define-package."
82260 74 72 61 6e 73 69 65 6e 74 22 20 22 30 2e 31 30 2e 30 22 20 22 54 72 61 6e 73 69 65 6e 74 20 63 transient"."0.10.0"."Transient.c
82280 6f 6d 6d 61 6e 64 73 22 20 27 28 28 65 6d 61 63 73 20 22 32 36 2e 31 22 29 20 28 63 6f 6d 70 61 ommands".'((emacs."26.1").(compa
822a0 74 20 22 33 30 2e 31 22 29 20 28 73 65 71 20 22 32 2e 32 34 22 29 29 20 3a 63 6f 6d 6d 69 74 20 t."30.1").(seq."2.24")).:commit.
822c0 22 31 64 31 30 39 66 33 34 62 37 63 36 61 66 37 61 66 38 33 30 63 31 34 31 62 62 30 61 33 62 34 "1d109f34b7c6af7af830c141bb0a3b4
822e0 64 33 33 38 30 33 65 37 35 22 20 3a 61 75 74 68 6f 72 73 20 27 28 28 22 4a 6f 6e 61 73 20 42 65 d33803e75".:authors.'(("Jonas.Be
82300 72 6e 6f 75 6c 6c 69 22 20 2e 20 22 65 6d 61 63 73 2e 74 72 61 6e 73 69 65 6e 74 40 6a 6f 6e 61 rnoulli"..."emacs.transient@jona
82320 73 2e 62 65 72 6e 6f 75 6c 6c 69 2e 64 65 76 22 29 29 20 3a 6d 61 69 6e 74 61 69 6e 65 72 20 27 s.bernoulli.dev")).:maintainer.'
82340 28 22 4a 6f 6e 61 73 20 42 65 72 6e 6f 75 6c 6c 69 22 20 2e 20 22 65 6d 61 63 73 2e 74 72 61 6e ("Jonas.Bernoulli"..."emacs.tran
82360 73 69 65 6e 74 40 6a 6f 6e 61 73 2e 62 65 72 6e 6f 75 6c 6c 69 2e 64 65 76 22 29 20 3a 6b 65 79 sient@jonas.bernoulli.dev").:key
82380 77 6f 72 64 73 20 27 28 22 65 78 74 65 6e 73 69 6f 6e 73 22 29 20 3a 75 72 6c 20 22 68 74 74 70 words.'("extensions").:url."http
823a0 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 67 69 74 2f 74 72 61 6e 73 69 65 6e 74 22 29 s://github.com/magit/transient")
823c0 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
823e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82400 74 72 61 6e 73 69 65 6e 74 2d 30 2e 31 30 2e 30 2f 43 48 41 4e 47 45 4c 4f 47 00 00 00 00 00 00 transient-0.10.0/CHANGELOG......
82420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82460 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
82480 30 31 34 35 37 31 30 00 30 30 30 30 30 30 30 30 30 30 30 00 30 31 33 34 36 30 00 20 30 00 00 00 0145710.00000000000.013460..0...
824a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
824c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
824e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82500 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...................
82520 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...................
82540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
825a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
825c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
825e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
82600 23 20 2d 2a 2d 20 6d 6f 64 65 3a 20 6f 72 67 20 2d 2a 2d 0a 2a 20 76 30 2e 31 30 2e 30 20 20 20 #.-*-.mode:.org.-*-.*.v0.10.0...
82620 20 32 30 32 35 2d 30 39 2d 30 31 0a 0a 2d 20 41 64 64 65 64 20 6d 6f 72 65 20 63 6f 6e 74 65 78 .2025-09-01..-.Added.more.contex
82640 74 2d 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 67 65 74 74 69 6e 67 t-specific.functions.for.getting
82660 20 74 68 65 20 70 72 65 66 69 78 27 73 0a 20 20 76 61 6c 75 65 20 61 6e 64 20 69 6d 70 72 6f 76 .the.prefix's...value.and.improv
82680 65 64 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 65 78 70 6c 61 69 6e 69 6e 67 20 ed.the.documentation.explaining.
826a0 77 68 65 6e 20 74 6f 20 75 73 65 20 77 68 69 63 68 0a 20 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 when.to.use.which...function.and
826c0 20 77 68 79 2e 20 20 62 34 65 64 62 36 33 33 20 28 53 65 65 20 61 6c 73 6f 20 74 68 65 20 63 6f .why...b4edb633.(See.also.the.co
826e0 6d 6d 69 74 20 6d 65 73 73 61 67 65 2e 29 0a 0a 2d 20 57 68 65 6e 20 73 75 66 66 69 78 65 73 20 mmit.message.)..-.When.suffixes.
82700 61 72 65 20 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 6e 6f 20 6c 6f 6e 67 65 72 are.being.initialized,.no.longer
82720 20 64 72 6f 70 20 69 6e 61 63 74 69 76 65 0a 20 20 73 75 66 66 69 78 65 73 20 28 69 6e 61 70 20 .drop.inactive...suffixes.(inap.
82740 73 75 66 66 69 78 65 73 20 61 6e 64 20 74 68 6f 73 65 20 6f 6e 20 61 20 6c 65 76 65 6c 20 74 68 suffixes.and.those.on.a.level.th
82760 61 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 0a 20 20 6e 6f 74 20 62 65 69 6e 67 20 75 73 65 64 at.is.currently...not.being.used
82780 29 2e 20 20 49 66 2f 77 68 65 6e 20 73 75 63 68 20 61 20 73 75 66 66 69 78 20 6c 61 74 65 72 20 )...If/when.such.a.suffix.later.
827a0 62 65 63 6f 6d 65 73 20 61 63 74 69 76 65 2c 0a 20 20 69 74 20 6e 6f 77 20 75 73 65 73 20 69 74 becomes.active,...it.now.uses.it
827c0 73 20 73 65 74 20 6f 72 20 73 61 76 65 64 20 76 61 6c 75 65 3b 20 70 72 65 76 69 6f 75 73 6c 79 s.set.or.saved.value;.previously
827e0 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 0a 20 20 77 6f 75 6c 64 20 68 61 76 65 20 .the.default.value...would.have.
82800 62 65 65 6e 20 75 73 65 64 2e 20 20 23 33 31 36 2c 20 23 33 36 34 2c 20 23 34 30 37 0a 0a 2d 20 been.used...#316,.#364,.#407..-.
82820 54 68 65 20 76 61 6c 75 65 20 61 6e 64 20 73 63 6f 70 65 20 6f 66 20 69 6e 61 70 74 20 73 75 66 The.value.and.scope.of.inapt.suf
82840 66 69 78 65 73 20 61 72 65 20 6e 6f 77 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 77 68 65 6e 0a 20 fixes.are.now.initialized.when..
82860 20 74 68 65 20 70 72 65 66 69 78 20 69 73 20 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 .the.prefix.is.being.initialized
82880 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 66 75 6c 20 62 65 63 61 75 73 65 20 74 68 65 79 0a 20 ,.which.is.useful.because.they..
828a0 20 6d 61 79 20 6c 61 74 65 72 20 62 65 63 6f 6d 65 20 61 70 74 2e 20 20 23 34 30 37 0a 0a 2d 20 .may.later.become.apt...#407..-.
828c0 57 68 69 6c 65 20 73 65 74 74 69 6e 67 20 75 70 20 73 75 66 66 69 78 65 73 2c 20 74 68 65 20 73 While.setting.up.suffixes,.the.s
828e0 75 66 66 69 78 20 62 65 69 6e 67 20 73 65 74 75 70 20 63 61 6e 20 6e 6f 77 20 61 63 63 65 73 73 uffix.being.setup.can.now.access
82900 0a 20 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 ...suffixes.that.have.already.be
82920 65 6e 20 73 65 74 75 70 20 28 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 69 72 20 76 61 6c 75 65 73 en.setup.(including.their.values
82940 29 2e 0a 20 20 23 33 31 36 0a 0a 2d 20 41 66 74 65 72 20 73 75 66 66 69 78 65 73 20 68 61 76 65 )....#316..-.After.suffixes.have
82960 20 62 65 65 6e 20 73 65 74 75 70 2c 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 72 .been.setup,.the.value.of.the.pr
82980 65 66 69 78 27 73 20 7e 76 61 6c 75 65 7e 0a 20 20 73 6c 6f 74 20 69 73 20 6e 6f 77 20 6d 61 64 efix's.~value~...slot.is.now.mad
829a0 65 20 75 6e 62 6f 75 6e 64 2c 20 74 6f 20 70 72 65 76 65 6e 74 20 61 63 63 65 73 73 20 74 6f 20 e.unbound,.to.prevent.access.to.
829c0 74 68 69 73 20 70 6f 74 65 6e 74 69 61 6c 6c 79 0a 20 20 6f 75 74 64 61 74 65 64 20 76 61 6c 75 this.potentially...outdated.valu
829e0 65 2e 20 20 35 62 66 32 36 64 65 39 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 66 61 63 65 20 7e e...5bf26de9..-.Added.new.face.~
82a00 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 2d 61 72 67 75 6d 65 6e 74 7e 20 61 6e 64 20 75 73 transient-inapt-argument~.and.us
82a20 65 20 69 74 20 66 6f 72 20 61 72 67 75 6d 65 6e 74 73 0a 20 20 61 6e 64 20 76 61 6c 75 65 73 20 e.it.for.arguments...and.values.
82a40 74 68 61 74 20 61 72 65 20 73 65 74 20 62 75 74 20 61 72 65 6e 27 74 20 62 65 69 6e 67 20 75 73 that.are.set.but.aren't.being.us
82a60 65 64 20 62 65 63 61 75 73 65 20 74 68 65 20 73 75 66 66 69 78 0a 20 20 69 73 20 63 75 72 72 65 ed.because.the.suffix...is.curre
82a80 6e 74 6c 79 20 69 6e 61 70 74 2e 20 20 66 65 64 38 36 36 62 61 0a 0a 2d 20 41 64 64 65 64 20 6e ntly.inapt...fed866ba..-.Added.n
82aa0 65 77 20 70 72 65 66 69 78 20 73 6c 6f 74 20 7e 72 65 6d 65 6d 62 65 72 2d 76 61 6c 75 65 7e 2c ew.prefix.slot.~remember-value~,
82ac0 20 77 68 69 63 68 20 61 6c 6c 6f 77 73 20 73 70 65 63 69 66 69 6e 67 0a 20 20 76 61 72 69 6f 75 .which.allows.specifing...variou
82ae0 73 20 6d 6f 64 65 73 20 6f 66 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 61 76 69 6e 67 20 s.modes.of.automatically.saving.
82b00 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 2e 20 20 23 32 38 37 0a 0a 2a 20 76 30 2e 39 the.current.value...#287..*.v0.9
82b20 2e 34 20 20 20 20 32 30 32 35 2d 30 38 2d 30 31 0a 0a 2d 20 57 68 65 6e 20 75 73 69 6e 67 20 63 .4....2025-08-01..-.When.using.c
82b40 6f 6f 72 64 69 6e 61 74 65 73 2c 20 74 72 79 69 6e 67 20 74 6f 20 69 6e 73 65 72 74 20 74 68 65 oordinates,.trying.to.insert.the
82b60 20 73 61 6d 65 20 73 75 66 66 69 78 20 69 6e 74 6f 20 74 68 65 0a 20 20 73 61 6d 65 20 6d 65 6e .same.suffix.into.the...same.men
82b80 75 20 74 77 69 63 65 2c 20 63 61 75 73 65 64 20 69 74 20 74 6f 20 69 6e 73 74 65 61 64 20 62 65 u.twice,.caused.it.to.instead.be
82ba0 20 72 65 6d 6f 76 65 64 20 74 68 65 20 73 65 63 6f 6e 64 20 74 69 6d 65 2e 0a 20 20 23 34 30 30 .removed.the.second.time....#400
82bc0 0a 0a 2a 20 76 30 2e 39 2e 33 20 20 20 20 32 30 32 35 2d 30 37 2d 30 31 0a 0a 2d 20 49 6d 70 72 ..*.v0.9.3....2025-07-01..-.Impr
82be0 6f 76 65 64 20 6b 6c 75 64 67 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 61 20 62 75 67 oved.kludge.to.work.around.a.bug
82c00 20 69 6e 20 45 6d 61 63 73 2c 20 77 68 69 63 68 20 6d 61 79 20 63 61 75 73 65 0a 20 20 61 20 73 .in.Emacs,.which.may.cause...a.s
82c20 75 62 70 72 6f 63 65 73 73 20 74 6f 20 62 65 20 6b 69 6c 6c 65 64 2c 20 77 68 65 6e 20 74 68 65 ubprocess.to.be.killed,.when.the
82c40 20 75 73 65 72 20 74 79 70 65 73 20 7e 43 2d 67 7e 2c 20 65 78 70 65 63 74 69 6e 67 0a 20 20 74 .user.types.~C-g~,.expecting...t
82c60 68 61 74 20 74 6f 20 71 75 69 74 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 2e 20 20 23 hat.to.quit.a.transient.menu...#
82c80 33 38 38 0a 0a 2d 20 46 69 78 65 64 20 61 6e 20 65 64 67 65 2d 63 61 73 65 20 77 68 65 6e 20 74 388..-.Fixed.an.edge-case.when.t
82ca0 72 79 69 6e 67 20 74 6f 20 70 75 74 20 70 6f 69 6e 74 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 73 rying.to.put.point.on.the.same.s
82cc0 75 66 66 69 78 0a 20 20 61 66 74 65 72 20 72 65 66 72 65 73 68 69 6e 67 20 74 68 65 20 6d 65 6e uffix...after.refreshing.the.men
82ce0 75 2e 20 20 65 35 30 38 65 36 35 38 0a 0a 2d 20 52 65 6d 6f 76 65 64 20 61 6e 20 75 6e 6e 65 63 u...e508e658..-.Removed.an.unnec
82d00 65 73 73 61 72 79 20 72 65 64 72 61 77 2c 20 77 68 69 63 68 20 61 64 64 69 74 69 6f 6e 61 6c 6c essary.redraw,.which.additionall
82d20 79 20 68 61 70 70 65 6e 65 64 20 74 6f 6f 0a 20 20 65 61 72 6c 79 2c 20 62 65 66 6f 72 65 20 73 y.happened.too...early,.before.s
82d40 75 66 66 69 78 65 73 20 77 65 72 65 20 72 65 66 72 65 73 68 65 64 2e 20 20 23 33 39 37 0a 0a 2a uffixes.were.refreshed...#397..*
82d60 20 76 30 2e 39 2e 32 20 20 20 20 32 30 32 35 2d 30 36 2d 30 39 0a 0a 2d 20 46 69 78 65 64 20 61 .v0.9.2....2025-06-09..-.Fixed.a
82d80 20 72 65 67 72 65 73 73 69 6f 6e 20 69 6e 20 76 30 2e 39 2e 30 2c 20 77 68 69 63 68 20 6d 61 64 .regression.in.v0.9.0,.which.mad
82da0 65 20 69 74 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 0a 20 20 e.it.impossible.to.change.the...
82dc0 6c 65 76 65 6c 20 6f 66 20 61 20 73 75 66 66 69 78 2c 20 69 66 20 74 68 61 74 20 77 61 73 20 73 level.of.a.suffix,.if.that.was.s
82de0 65 74 20 69 6e 6c 69 6e 65 20 69 6e 20 74 68 65 20 70 72 65 66 69 78 20 64 65 66 69 6e 69 74 69 et.inline.in.the.prefix.definiti
82e00 6f 6e 2e 0a 0a 2a 20 76 30 2e 39 2e 31 20 20 20 20 32 30 32 35 2d 30 36 2d 30 33 0a 0a 2d 20 41 on...*.v0.9.1....2025-06-03..-.A
82e20 73 20 61 6e 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 61 66 65 74 79 20 6d 65 61 73 75 72 65 2c 20 s.an.additional.safety.measure,.
82e40 75 6e 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 72 65 73 65 74 20 7e 69 6e 68 69 62 69 74 2d 71 unconditionally.reset.~inhibit-q
82e60 75 69 74 7e 0a 20 20 77 68 65 6e 20 74 68 65 20 65 6d 65 72 67 65 6e 63 79 20 65 78 69 74 20 69 uit~...when.the.emergency.exit.i
82e80 73 20 74 61 6b 65 6e 2e 20 20 62 33 32 36 34 32 31 66 0a 0a 2d 20 49 6e 63 6c 75 64 69 6e 67 20 s.taken...b326421f..-.Including.
82ea0 67 72 6f 75 70 73 20 74 68 61 74 20 61 72 65 20 73 74 69 6c 6c 20 64 65 66 69 6e 65 64 20 61 73 groups.that.are.still.defined.as
82ec0 20 61 20 76 61 72 69 61 62 6c 65 2c 20 69 6e 73 74 65 61 64 20 6f 66 0a 20 20 75 73 69 6e 67 20 .a.variable,.instead.of...using.
82ee0 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 7e 20 28 61 64 64 65 64 20 ~transient-define-group~.(added.
82f00 69 6e 20 76 30 2e 39 2e 30 29 2c 20 66 61 69 6c 65 64 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 in.v0.9.0),.failed.in.some.cases
82f20 0a 20 20 61 6e 64 20 70 72 65 76 65 6e 74 65 64 20 74 68 65 20 6d 65 6e 75 20 66 72 6f 6d 20 62 ...and.prevented.the.menu.from.b
82f40 65 69 6e 67 20 64 69 73 70 6c 61 79 65 64 20 61 74 20 61 6c 6c 2e 20 20 23 33 38 39 0a 0a 2a 20 eing.displayed.at.all...#389..*.
82f60 76 30 2e 39 2e 30 20 20 20 20 32 30 32 35 2d 30 36 2d 30 31 0a 0a 2d 20 4b 65 79 20 64 65 73 63 v0.9.0....2025-06-01..-.Key.desc
82f80 72 69 70 74 69 6f 6e 73 20 28 61 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 7e 6b 65 79 2d 64 65 riptions.(as.returned.by.~key-de
82fa0 73 63 72 69 70 74 69 6f 6e 7e 20 61 6e 64 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 0a 20 20 7e scription~.and.understood.by...~
82fc0 6b 62 64 7e 29 20 61 72 65 20 6e 6f 77 20 74 68 65 20 6f 6e 6c 79 20 6b 65 79 20 62 69 6e 64 69 kbd~).are.now.the.only.key.bindi
82fe0 6e 67 20 66 6f 72 6d 61 74 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 54 72 61 6e 73 69 65 6e ng.format.understood.by.Transien
83000 74 2e 0a 20 20 56 65 63 74 6f 72 73 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 75 70 70 6f t....Vectors.are.no.longer.suppo
83020 72 74 65 64 2e 20 20 63 34 65 30 63 62 61 36 0a 0a 2d 20 56 65 63 74 6f 72 73 20 61 72 65 20 6e rted...c4e0cba6..-.Vectors.are.n
83040 6f 77 20 70 72 65 66 65 72 72 65 64 20 74 6f 20 69 64 65 6e 74 69 66 79 20 61 20 73 75 66 66 69 ow.preferred.to.identify.a.suffi
83060 78 20 6f 72 20 67 72 6f 75 70 20 69 6e 20 61 20 6d 65 6e 75 20 62 79 0a 20 20 63 6f 6f 72 64 69 x.or.group.in.a.menu.by...coordi
83080 6e 61 74 65 73 2e 20 20 49 74 20 69 73 20 73 74 69 6c 6c 20 70 6f 73 73 69 62 6c 65 2c 20 62 75 nates...It.is.still.possible,.bu
830a0 74 20 64 69 73 63 6f 75 72 61 67 65 64 2c 20 74 6f 20 75 73 65 20 61 20 6c 69 73 74 2e 0a 20 20 t.discouraged,.to.use.a.list....
830c0 31 39 33 33 64 64 61 39 0a 0a 2d 20 54 68 65 20 69 6e 74 65 72 6e 61 6c 20 66 6f 72 6d 61 74 20 1933dda9..-.The.internal.format.
830e0 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 6d 65 6e 75 20 6c 61 79 6f 75 74 73 20 68 61 73 20 62 used.to.store.menu.layouts.has.b
83100 65 65 6e 20 69 6d 70 72 6f 76 65 64 2e 0a 20 20 54 68 65 20 6f 6c 64 20 66 6f 72 6d 61 74 20 69 een.improved....The.old.format.i
83120 73 20 73 74 69 6c 6c 20 73 75 70 70 6f 72 74 65 64 20 61 6e 64 20 74 72 61 6e 73 6c 61 74 65 64 s.still.supported.and.translated
83140 20 6f 6e 20 74 68 65 20 66 6c 79 20 77 68 65 6e 0a 20 20 65 6e 63 6f 75 6e 74 65 72 65 64 2e 20 .on.the.fly.when...encountered..
83160 20 49 6e 73 74 65 61 64 20 6f 66 20 72 65 6c 79 20 6f 6e 20 74 68 61 74 20 74 72 61 6e 73 6c 61 .Instead.of.rely.on.that.transla
83180 74 69 6f 6e 2c 20 75 73 65 72 73 20 61 72 65 20 61 64 76 69 73 65 64 0a 20 20 74 6f 20 72 65 63 tion,.users.are.advised...to.rec
831a0 6f 6d 70 69 6c 65 20 64 65 70 65 6e 64 65 6e 74 20 70 61 63 6b 61 67 65 73 20 61 66 74 65 72 20 ompile.dependent.packages.after.
831c0 75 70 64 61 74 69 6e 67 20 54 72 61 6e 73 69 65 6e 74 20 74 6f 20 74 68 69 73 0a 20 20 72 65 6c updating.Transient.to.this...rel
831e0 65 61 73 65 2e 20 20 62 63 63 30 62 66 38 33 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 6d 61 63 ease...bcc0bf83..-.Added.new.mac
83200 72 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 67 72 6f 75 70 7e 2c 20 77 68 69 ro.~transient-define-group~,.whi
83220 63 68 20 64 65 66 69 6e 65 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 0a 20 20 67 72 6f 75 70 73 20 ch.defines.one.or.more...groups.
83240 6f 66 20 73 75 66 66 69 78 65 73 20 74 6f 20 62 65 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 6d 75 of.suffixes.to.be.included.in.mu
83260 6c 74 69 70 6c 65 20 6d 65 6e 75 73 2e 20 20 53 75 63 68 20 69 6e 63 6c 75 64 65 64 0a 20 20 67 ltiple.menus...Such.included...g
83280 72 6f 75 70 73 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 roups.are.no.longer.immediately.
832a0 69 6e 6c 69 6e 65 64 20 77 68 65 6e 20 72 65 66 65 72 65 6e 63 65 64 20 69 6e 20 61 20 6d 65 6e inlined.when.referenced.in.a.men
832c0 75 0a 20 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20 77 68 69 63 68 20 6d 61 6b 65 73 20 69 74 20 70 u...definition,.which.makes.it.p
832e0 6f 73 73 69 62 6c 65 20 66 6f 72 20 75 73 65 72 73 20 74 6f 20 6d 61 6b 65 20 63 68 61 6e 67 65 ossible.for.users.to.make.change
83300 73 20 74 6f 0a 20 20 69 6e 63 6c 75 64 65 64 20 67 72 6f 75 70 20 61 6e 64 20 68 61 76 65 20 74 s.to...included.group.and.have.t
83320 68 6f 73 65 20 63 68 61 6e 67 65 20 61 66 66 65 63 74 20 61 6c 6c 20 6d 65 6e 75 73 20 74 68 61 hose.change.affect.all.menus.tha
83340 74 20 69 6e 63 6c 75 64 65 0a 20 20 74 68 65 6d 2e 20 20 62 63 63 30 62 66 38 33 0a 0a 2d 20 41 t.include...them...bcc0bf83..-.A
83360 64 64 65 64 20 6e 65 77 20 6d 61 63 72 6f 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 6c 69 6e 65 dded.new.macro.~transient-inline
83380 2d 67 72 6f 75 70 7e 2c 20 77 68 69 63 68 20 69 6e 6c 69 6e 65 73 20 61 6e 20 69 6e 63 6c 75 64 -group~,.which.inlines.an.includ
833a0 65 64 0a 20 20 67 72 6f 75 70 20 69 6e 74 6f 20 61 20 73 70 65 63 69 66 69 63 20 6d 65 6e 75 2e ed...group.into.a.specific.menu.
833c0 20 20 62 63 63 30 62 66 38 33 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 2c 20 65 78 70 65 72 69 6d ..bcc0bf83..-.Added.new,.experim
833e0 65 6e 74 61 6c 20 73 75 66 66 69 78 20 63 6c 61 73 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f ental.suffix.class.~transient-co
83400 6e 73 2d 6f 70 74 69 6f 6e 7e 2c 20 77 68 69 63 68 20 69 73 0a 20 20 69 6e 74 65 6e 64 65 64 20 ns-option~,.which.is...intended.
83420 66 6f 72 20 73 69 74 75 61 74 69 6f 6e 73 20 77 68 65 72 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d for.situations.where.~transient-
83440 61 72 67 73 7e 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 61 6e 20 61 6c 69 73 74 2c 0a 20 20 args~.should.return.an.alist,...
83460 69 6e 73 74 65 61 64 20 6f 66 20 61 20 6c 69 73 74 20 6f 66 20 73 74 72 69 6e 67 73 20 28 61 72 instead.of.a.list.of.strings.(ar
83480 67 75 6d 65 6e 74 73 29 2e 20 20 38 31 37 32 37 62 61 63 2c 20 65 38 65 62 33 65 62 64 0a 0a 2d guments)...81727bac,.e8eb3ebd..-
834a0 20 57 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 69 73 20 61 63 74 69 76 .While.a.transient.menu.is.activ
834c0 65 2c 20 7e 69 6e 68 69 62 69 74 2d 71 75 69 74 7e 20 69 73 20 6e 6f 77 20 73 65 74 20 74 6f 20 e,.~inhibit-quit~.is.now.set.to.
834e0 74 2e 0a 20 20 23 33 38 38 0a 0a 2a 20 76 30 2e 38 2e 38 20 20 20 20 32 30 32 35 2d 30 35 2d 30 t....#388..*.v0.8.8....2025-05-0
83500 31 0a 0a 2d 20 41 64 64 65 64 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6d 1..-.Added.option.~transient-com
83520 6d 6f 6e 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 66 69 78 7e 20 74 6f 20 61 6c 6c 6f 77 20 75 73 69 mon-command-prefix~.to.allow.usi
83540 6e 67 20 61 20 6b 65 79 0a 20 20 6f 74 68 65 72 20 74 68 61 6e 20 7e 43 2d 78 7e 20 61 73 20 74 ng.a.key...other.than.~C-x~.as.t
83560 68 65 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 20 66 6f 72 20 6d 61 6e 79 20 63 6f 6d 6d he.prefix.key.used.for.many.comm
83580 61 6e 64 73 20 63 6f 6d 6d 6f 6e 20 74 6f 0a 20 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 6d ands.common.to...all.transient.m
835a0 65 6e 75 73 2e 20 20 42 65 63 61 75 73 65 20 74 68 65 20 75 73 65 20 6f 66 20 74 68 65 20 7e 43 enus...Because.the.use.of.the.~C
835c0 2d 78 7e 20 70 72 65 66 69 78 20 66 6f 72 20 74 68 65 73 65 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 -x~.prefix.for.these...commands.
835e0 63 61 75 73 65 73 20 6d 61 6e 79 20 67 6c 6f 62 61 6c 20 62 69 6e 64 69 6e 67 73 20 74 6f 20 62 causes.many.global.bindings.to.b
83600 65 20 73 68 61 64 6f 77 65 64 20 65 76 65 6e 20 66 6f 72 20 6d 65 6e 75 73 0a 20 20 74 68 61 74 e.shadowed.even.for.menus...that
83620 20 61 6c 6c 6f 77 20 69 6e 76 6f 6b 69 6e 67 20 6e 6f 6e 2d 73 75 66 66 69 78 20 63 6f 6d 6d 61 .allow.invoking.non-suffix.comma
83640 6e 64 73 2c 20 49 20 68 69 67 68 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 20 74 68 61 74 0a 20 20 75 nds,.I.highly.recommend.that...u
83660 73 65 72 73 20 63 75 73 74 6f 6d 69 7a 65 20 74 68 69 73 2e 20 20 37 64 30 38 30 33 39 63 0a 0a sers.customize.this...7d08039c..
83680 2d 20 41 64 64 65 64 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 65 72 72 6f 72 2d -.Added.option.~transient-error-
836a0 6f 6e 2d 69 6e 73 65 72 74 2d 66 61 69 6c 75 72 65 7e 2c 20 64 65 66 61 75 6c 74 69 6e 67 20 74 on-insert-failure~,.defaulting.t
836c0 6f 20 7e 6e 69 6c 7e 2e 0a 20 20 49 2e 65 2e 2c 20 67 6f 20 62 61 63 6b 20 74 6f 20 74 68 65 20 o.~nil~....I.e.,.go.back.to.the.
836e0 70 72 65 2d 76 30 2e 38 2e 37 20 62 65 68 61 76 69 6f 72 20 62 79 20 64 65 66 61 75 6c 74 20 62 pre-v0.8.7.behavior.by.default.b
83700 75 74 20 6c 65 74 20 75 73 65 72 73 0a 20 20 6f 70 74 2d 69 6e 20 74 6f 20 65 72 72 6f 72 73 20 ut.let.users...opt-in.to.errors.
83720 66 6f 72 20 63 65 72 74 61 69 6e 20 6d 69 6e 6f 72 20 69 73 73 75 65 73 2e 20 20 23 33 37 34 0a for.certain.minor.issues...#374.
83740 0a 2d 20 41 64 64 72 65 73 73 20 61 20 63 6f 6e 66 6c 69 63 74 20 77 69 74 68 20 74 68 65 20 6b .-.Address.a.conflict.with.the.k
83760 65 79 62 6f 61 72 64 20 75 73 65 64 20 62 79 20 74 68 65 20 41 6e 64 72 6f 69 64 20 70 6f 72 74 eyboard.used.by.the.Android.port
83780 2e 0a 20 20 23 33 37 36 2e 0a 0a 2a 20 76 30 2e 38 2e 37 20 20 20 20 32 30 32 35 2d 30 34 2d 30 ....#376...*.v0.8.7....2025-04-0
837a0 31 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 68 6f 6f 6b 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 1..-.Added.new.hook.~transient-p
837c0 6f 73 74 2d 65 78 69 74 2d 68 6f 6f 6b 7e 2e 20 20 35 35 30 35 30 62 36 30 0a 0a 2d 20 7e 74 72 ost-exit-hook~...55050b60..-.~tr
837e0 61 6e 73 69 65 6e 74 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 7e 20 61 6e 64 20 7e 74 72 61 6e ansient-insert-suffix~.and.~tran
83800 73 69 65 6e 74 2d 61 70 70 65 6e 64 2d 73 75 66 66 69 78 7e 20 6e 6f 77 20 73 69 67 6e 61 6c 0a sient-append-suffix~.now.signal.
83820 20 20 65 72 72 6f 72 20 69 66 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6c 6f 63 61 74 69 6f ..error.if.the.specified.locatio
83840 6e 20 69 73 20 69 6e 76 61 6c 69 64 2e 20 20 23 33 37 34 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a n.is.invalid...#374..Bug.fixes:.
83860 0a 2d 20 41 75 74 6f 6c 6f 61 64 65 64 20 63 6f 6d 6d 61 6e 64 73 20 77 65 72 65 20 6c 6f 61 64 .-.Autoloaded.commands.were.load
83880 65 64 20 74 6f 6f 20 6c 61 74 65 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 73 ed.too.late.in.~transient-init-s
838a0 75 66 66 69 78 7e 2c 0a 20 20 72 65 73 75 6c 74 69 6e 67 20 69 6e 20 74 68 65 20 73 75 66 66 69 uffix~,...resulting.in.the.suffi
838c0 78 20 70 72 6f 74 6f 74 79 70 65 20 6f 62 6a 65 63 74 20 6e 6f 74 20 62 65 69 6e 67 20 75 73 65 x.prototype.object.not.being.use
838e0 64 2e 20 20 30 30 31 31 32 63 31 31 0a 0a 2a 20 76 30 2e 38 2e 36 20 20 20 20 32 30 32 35 2d 30 d...00112c11..*.v0.8.6....2025-0
83900 33 2d 31 35 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 3-15..Bug.fixes:..-.~transient-s
83920 68 6f 77 2d 73 75 6d 6d 61 72 79 7e 20 65 72 72 6f 72 65 64 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 how-summary~.errored.for.command
83940 73 20 74 68 61 74 20 68 61 76 65 20 6e 65 69 74 68 65 72 20 61 0a 20 20 73 75 6d 6d 61 72 79 20 s.that.have.neither.a...summary.
83960 6e 6f 72 20 61 20 64 6f 63 73 74 72 69 6e 67 2e 20 20 30 38 38 36 36 35 31 64 0a 0a 2d 20 7e 74 nor.a.docstring...0886651d..-.~t
83980 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 65 72 72 ransient-format-description~.err
839a0 6f 72 65 64 20 66 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 7e ored.for.~transient-information~
839c0 0a 20 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 2a 7e 20 ...and.~transient-information*~.
839e0 73 75 66 66 69 78 65 73 2e 20 20 23 33 36 36 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 77 suffixes...#366..-.~transient--w
83a00 72 61 70 2d 63 6f 6d 6d 61 6e 64 7e 20 66 61 69 6c 65 64 20 74 6f 20 6c 6f 61 64 20 61 75 74 6f rap-command~.failed.to.load.auto
83a20 6c 6f 61 64 65 64 20 63 6f 6d 6d 61 6e 64 73 2e 0a 20 20 34 30 33 30 38 36 32 33 0a 0a 2d 20 7e loaded.commands....40308623..-.~
83a40 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 7e 20 65 72 72 6f 72 65 64 transient-suffix-object~.errored
83a60 20 69 66 20 61 20 63 6f 6d 6d 61 6e 64 20 69 73 20 62 6f 75 6e 64 20 6d 6f 72 65 20 74 68 61 6e .if.a.command.is.bound.more.than
83a80 0a 20 20 6f 6e 63 65 20 61 6e 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 75 73 69 6e 67 20 74 68 65 ...once.and.is.invoked.using.the
83aa0 20 6d 6f 75 73 65 20 6f 72 20 7e 52 45 54 7e 2e 20 20 66 36 39 65 31 32 38 36 0a 0a 2d 20 46 6f .mouse.or.~RET~...f69e1286..-.Fo
83ac0 72 20 73 6f 6d 65 20 72 65 6c 65 61 73 65 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 r.some.releases.~transient-suffi
83ae0 78 2d 6f 62 6a 65 63 74 7e 20 65 72 72 6f 72 65 64 20 69 66 20 69 74 20 63 6f 75 6c 64 20 6e 6f x-object~.errored.if.it.could.no
83b00 74 0a 20 20 69 64 65 6e 74 69 66 79 20 61 20 75 6e 69 71 75 65 20 73 75 66 66 69 78 2c 20 77 68 t...identify.a.unique.suffix,.wh
83b20 69 63 68 20 68 65 6c 70 65 64 20 65 73 74 61 62 6c 69 73 68 20 74 68 61 74 20 69 74 20 69 73 20 ich.helped.establish.that.it.is.
83b40 69 6e 20 66 61 63 74 0a 20 20 6c 65 67 69 74 69 6d 61 74 65 20 74 6f 20 75 73 65 20 74 68 69 73 in.fact...legitimate.to.use.this
83b60 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 61 20 70 72 65 64 69 63 61 74 65 2e 20 20 4e 6f 20 6c 6f .function.as.a.predicate...No.lo
83b80 6e 67 65 72 20 65 72 72 6f 72 20 69 66 0a 20 20 74 68 65 72 65 20 61 72 65 20 7a 65 72 6f 20 6d nger.error.if...there.are.zero.m
83ba0 61 74 63 68 65 73 2c 20 62 75 74 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 65 72 72 6f 72 20 69 66 atches,.but.continue.to.error.if
83bc0 20 74 68 65 69 72 20 61 72 65 20 6d 75 6c 74 69 70 6c 65 0a 20 20 6d 61 74 63 68 65 73 20 74 68 .their.are.multiple...matches.th
83be0 61 74 20 63 61 6e 6e 6f 74 20 62 65 20 64 69 73 61 6d 62 69 67 75 61 74 65 64 2e 20 20 34 61 30 at.cannot.be.disambiguated...4a0
83c00 36 61 65 62 30 0a 0a 2a 20 76 30 2e 38 2e 35 20 20 20 20 32 30 32 35 2d 30 33 2d 30 31 0a 0a 2d 6aeb0..*.v0.8.5....2025-03-01..-
83c20 20 41 64 64 65 64 20 6e 65 77 20 66 61 63 65 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d .Added.new.faces.~transient-key-
83c40 72 65 63 75 72 73 65 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6b 65 79 2d 73 74 61 63 recurse~.and.~transient-key-stac
83c60 6b 7e 2e 0a 20 20 35 38 65 32 32 35 35 34 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 7e 74 k~....58e22554..Bug.fixes:..-.~t
83c80 72 61 6e 73 69 65 6e 74 2d 2d 73 65 74 75 70 2d 72 65 63 75 72 73 69 6f 6e 7e 20 64 69 64 20 6e ransient--setup-recursion~.did.n
83ca0 6f 74 20 63 6f 6e 73 69 64 65 72 20 74 68 65 20 7e 72 65 63 75 72 73 65 7e 20 73 68 6f 72 74 68 ot.consider.the.~recurse~.shorth
83cc0 61 6e 64 2e 0a 20 20 33 32 61 37 65 32 35 36 0a 0a 2d 20 54 68 65 20 70 61 72 65 6e 74 20 67 72 and....32a7e256..-.The.parent.gr
83ce0 6f 75 70 20 77 61 73 20 6e 6f 74 20 61 6c 77 61 79 73 20 73 74 6f 72 65 64 20 69 6e 20 73 75 66 oup.was.not.always.stored.in.suf
83d00 66 69 78 20 6f 62 6a 65 63 74 73 2e 20 20 23 33 35 34 0a 0a 2d 20 49 6e 76 6f 6b 69 6e 67 20 61 fix.objects...#354..-.Invoking.a
83d20 20 73 75 66 66 69 78 20 6f 66 20 61 20 73 75 62 2d 70 72 65 66 69 78 20 28 77 68 69 63 68 20 69 .suffix.of.a.sub-prefix.(which.i
83d40 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74 6f 20 72 65 74 75 72 6e 20 74 6f 0a 20 20 74 68 65 20 s.configured.to.return.to...the.
83d60 6f 75 74 65 72 20 70 72 65 66 69 78 29 2c 20 64 69 64 20 65 78 69 74 20 69 6e 73 74 65 61 64 20 outer.prefix),.did.exit.instead.
83d80 6f 66 20 72 65 74 75 72 6e 69 6e 67 2c 20 69 66 20 74 68 65 20 73 75 66 66 69 78 27 73 0a 20 20 of.returning,.if.the.suffix's...
83da0 6f 77 6e 20 62 65 68 61 76 69 6f 72 20 77 61 73 20 6e 6f 74 20 65 78 70 6c 69 63 69 74 6c 79 20 own.behavior.was.not.explicitly.
83dc0 73 70 65 63 69 66 69 65 64 2e 20 20 23 33 35 32 0a 0a 2d 20 54 68 65 20 63 6f 6c 6f 72 20 6f 66 specified...#352..-.The.color.of
83de0 20 61 20 73 75 66 66 69 78 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 74 6f 20 74 68 65 20 6f 75 .a.suffix.that.returns.to.the.ou
83e00 74 65 72 20 70 72 65 66 69 78 2c 20 77 61 73 20 77 72 6f 6e 67 0a 20 20 77 68 65 6e 20 74 68 65 ter.prefix,.was.wrong...when.the
83e20 72 65 20 69 73 6e 27 74 20 61 63 74 75 61 6c 6c 79 20 61 6e 20 6f 75 74 65 72 20 70 72 65 66 69 re.isn't.actually.an.outer.prefi
83e40 78 2e 20 20 65 38 38 30 30 35 64 32 0a 0a 2d 20 57 68 65 6e 20 70 6f 74 65 6e 74 69 61 6c 6c 79 x...e88005d2..-.When.potentially
83e60 20 72 65 6d 6f 76 69 6e 67 20 6f 74 68 65 72 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 74 68 65 .removing.other.bindings.for.the
83e80 20 73 61 6d 65 20 63 6f 6d 6d 61 6e 64 0a 20 20 77 68 69 6c 65 20 61 64 64 69 6e 67 20 61 20 6e .same.command...while.adding.a.n
83ea0 65 77 20 62 69 6e 64 69 6e 67 2c 20 66 61 6c 73 65 2d 6e 65 67 61 74 69 76 65 20 61 76 6f 69 64 ew.binding,.false-negative.avoid
83ec0 61 6e 63 65 20 77 61 73 20 74 6f 6f 20 68 65 61 76 69 6c 79 0a 20 20 66 61 76 6f 72 65 64 20 6f ance.was.too.heavily...favored.o
83ee0 76 65 72 20 66 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 20 61 76 6f 69 64 61 6e 63 65 2e 20 20 23 ver.false-positive.avoidance...#
83f00 33 35 35 0a 0a 2d 20 44 65 66 69 6e 69 6e 67 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 68 355..-.Defining.the.~transient-h
83f20 69 67 68 65 72 2d 6c 65 76 65 6c 7e 20 66 61 63 65 20 69 6e 76 6f 6c 76 65 73 20 63 61 6c 6c 69 igher-level~.face.involves.calli
83f40 6e 67 0a 20 20 7e 66 61 63 65 2d 61 74 74 72 69 62 75 74 65 73 7e 20 6f 6e 20 61 6e 6f 74 68 65 ng...~face-attributes~.on.anothe
83f60 72 20 66 61 63 65 2e 20 20 54 68 61 74 20 63 61 6c 6c 20 72 65 71 75 65 73 74 65 64 20 74 68 65 r.face...That.call.requested.the
83f80 20 76 61 6c 75 65 0a 20 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 72 61 6d 65 20 28 .value...for.the.current.frame.(
83fa0 77 68 69 63 68 20 6d 61 79 20 6e 6f 74 20 65 78 69 73 74 20 79 65 74 29 20 69 6e 73 74 65 61 64 which.may.not.exist.yet).instead
83fc0 20 6f 66 20 75 73 69 6e 67 0a 20 20 74 68 65 20 64 65 66 61 75 6c 74 2e 20 20 23 33 35 39 0a 0a .of.using...the.default...#359..
83fe0 2d 20 57 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 69 6e 64 6f 77 20 69 73 20 68 -.When.the.transient.window.is.h
84000 69 64 64 65 6e 20 77 68 69 6c 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 75 73 idden.while.the.minibuffer.is.us
84020 65 64 2c 0a 20 20 74 68 65 6e 20 69 74 20 77 61 73 20 6e 6f 74 20 72 65 73 74 6f 72 65 64 20 69 ed,...then.it.was.not.restored.i
84040 66 20 75 73 69 6e 67 20 48 65 6c 6d 2e 20 20 23 33 36 31 0a 0a 2d 20 4e 6f 6e 2d 73 75 66 66 69 f.using.Helm...#361..-.Non-suffi
84060 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 61 72 65 6e 27 74 20 61 63 63 65 73 73 65 64 20 76 x.command.that.aren't.accessed.v
84080 69 61 20 61 20 73 79 6d 62 6f 6c 2c 20 77 65 72 65 20 6e 6f 74 0a 20 20 70 72 6f 70 65 72 6c 79 ia.a.symbol,.were.not...properly
840a0 20 77 72 61 70 70 65 64 20 74 6f 20 65 6e 73 75 72 65 20 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 20 .wrapped.to.ensure.post-command.
840c0 63 6c 65 61 6e 75 70 20 68 61 70 70 65 6e 73 20 65 76 65 6e 20 69 6e 0a 20 20 63 61 73 65 20 6f cleanup.happens.even.in...case.o
840e0 66 20 61 6e 20 65 72 72 6f 72 20 6f 72 20 69 66 20 74 68 65 20 75 73 65 72 20 61 62 6f 72 74 73 f.an.error.or.if.the.user.aborts
84100 20 61 20 6d 69 6e 69 62 75 66 66 65 72 20 75 73 65 2c 20 63 61 75 73 69 6e 67 0a 20 20 74 68 65 .a.minibuffer.use,.causing...the
84120 20 6d 65 6e 75 20 77 69 6e 64 6f 77 20 74 6f 20 67 65 74 20 73 74 75 63 6b 2e 20 20 30 38 32 30 .menu.window.to.get.stuck...0820
84140 31 66 30 36 0a 0a 2a 20 76 30 2e 38 2e 34 20 20 20 20 32 30 32 35 2d 30 32 2d 30 31 0a 0a 2d 20 1f06..*.v0.8.4....2025-02-01..-.
84160 41 64 64 65 64 20 6e 65 77 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 Added.new.option.~transient-show
84180 2d 64 6f 63 73 74 72 69 6e 67 2d 66 6f 72 6d 61 74 7e 2e 20 20 36 35 63 64 36 63 65 63 0a 0a 2d -docstring-format~...65cd6cec..-
841a0 20 55 6e 6c 65 73 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 61 20 70 72 65 66 69 78 20 61 72 67 .Unless.called.with.a.prefix.arg
841c0 75 6d 65 6e 74 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 6f 63 73 74 72 69 ument,.~transient-toggle-docstri
841e0 6e 67 73 7e 0a 20 20 6e 6f 77 20 6f 6e 6c 79 20 73 68 6f 77 73 20 64 6f 63 73 74 72 69 6e 67 73 ngs~...now.only.shows.docstrings
84200 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d 65 6e 75 20 69 6e 76 6f 63 61 74 69 6f 6e .for.the.current.menu.invocation
84220 2e 20 20 31 33 66 33 66 35 65 30 0a 0a 2d 20 54 68 65 20 7e 23 23 7e 20 6d 61 63 72 6f 20 66 72 ...13f3f5e0..-.The.~##~.macro.fr
84240 6f 6d 20 74 68 65 20 7e 6c 6c 61 6d 61 7e 20 70 61 63 6b 61 67 65 20 63 61 6e 20 6e 6f 77 20 62 om.the.~llama~.package.can.now.b
84260 65 20 75 73 65 64 20 61 66 74 65 72 20 6b 65 79 77 6f 72 64 73 0a 20 20 69 6e 20 67 72 6f 75 70 e.used.after.keywords...in.group
84280 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 73 75 66 66 69 .specifications.(including.suffi
842a0 78 20 62 69 6e 64 69 6e 67 73 29 2e 20 20 37 63 36 35 30 34 33 36 0a 0a 2d 20 53 75 66 66 69 78 x.bindings)...7c650436..-.Suffix
842c0 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 6e 6f 77 20 62 65 20 61 64 76 69 73 65 64 20 75 73 69 .commands.can.now.be.advised.usi
842e0 6e 67 20 74 68 65 20 6e 65 77 20 7e 61 64 76 69 63 65 7e 20 61 6e 64 20 7e 61 64 76 69 63 65 2a ng.the.new.~advice~.and.~advice*
84300 7e 0a 20 20 73 6c 6f 74 73 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 73 75 66 66 69 78 65 73 ~...slots.available.for.suffixes
84320 20 61 6e 64 20 67 72 6f 75 70 73 2e 20 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 73 20 73 74 .and.groups...This.feature.is.st
84340 69 6c 6c 0a 20 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 2e 20 20 23 33 34 30 0a 0a 2d 20 7e 74 72 ill...experimental...#340..-.~tr
84360 61 6e 73 69 65 6e 74 2d 73 63 6f 70 65 7e 20 63 61 6e 20 6e 6f 77 20 61 6c 73 6f 20 6d 61 74 63 ansient-scope~.can.now.also.matc
84380 68 20 61 67 61 69 6e 73 74 20 70 72 65 66 69 78 20 63 6c 61 73 73 65 73 2c 20 6e 6f 74 20 6a 75 h.against.prefix.classes,.not.ju
843a0 73 74 0a 20 20 73 70 65 63 69 66 69 63 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 st...specific.prefix.commands...
843c0 23 33 33 34 0a 0a 2d 20 54 68 65 20 64 65 66 61 75 6c 74 20 6c 65 76 65 6c 20 6f 66 20 61 20 73 #334..-.The.default.level.of.a.s
843e0 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 6e 6f 77 20 62 65 20 73 65 74 20 76 69 61 uffix.command.can.now.be.set.via
84400 20 69 74 73 0a 20 20 70 72 6f 74 6f 74 79 70 65 2c 20 75 73 69 6e 67 20 74 68 65 20 6e 65 77 20 .its...prototype,.using.the.new.
84420 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 64 65 66 61 75 6c 74 2d function.~transient-set-default-
84440 6c 65 76 65 6c 7e 2e 0a 20 20 66 36 63 32 34 39 63 37 0a 0a 2a 20 76 30 2e 38 2e 33 20 20 20 20 level~....f6c249c7..*.v0.8.3....
84460 32 30 32 35 2d 30 31 2d 30 33 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 63 6f 6e 73 74 61 6e 74 2025-01-03..-.Added.new.constant
84480 20 7e 74 72 61 6e 73 69 65 6e 74 2d 76 65 72 73 69 6f 6e 7e 2e 20 20 33 30 32 32 66 36 64 35 0a .~transient-version~...3022f6d5.
844a0 0a 2a 20 76 30 2e 38 2e 32 20 20 20 20 32 30 32 35 2d 30 31 2d 30 31 0a 0a 2d 20 41 64 64 65 64 .*.v0.8.2....2025-01-01..-.Added
844c0 20 73 75 70 70 6f 72 74 20 66 6f 72 20 64 69 73 70 6c 61 79 69 6e 67 20 74 68 65 20 74 72 61 6e .support.for.displaying.the.tran
844e0 73 69 65 6e 74 20 6d 65 6e 75 20 69 6e 20 61 20 64 65 64 69 63 61 74 65 64 0a 20 20 66 72 61 6d sient.menu.in.a.dedicated...fram
84500 65 2e 20 20 62 66 35 38 63 30 62 62 0a 0a 2d 20 57 68 65 6e 20 69 6e 63 6c 75 64 69 6e 67 20 61 e...bf58c0bb..-.When.including.a
84520 20 67 72 6f 75 70 20 76 69 61 20 61 20 76 61 72 69 61 62 6c 65 2c 20 74 68 65 20 69 6d 70 6f 72 .group.via.a.variable,.the.impor
84540 74 65 64 20 76 61 6c 75 65 20 63 61 6e 20 6e 6f 77 20 62 65 0a 20 20 61 20 74 6f 70 2d 6c 65 76 ted.value.can.now.be...a.top-lev
84560 65 6c 20 67 72 6f 75 70 2e 20 20 65 65 62 63 62 65 33 30 0a 0a 2d 20 54 68 65 20 74 72 61 6e 73 el.group...eebcbe30..-.The.trans
84580 69 65 6e 74 20 77 69 6e 64 6f 77 20 69 73 20 6e 6f 77 20 66 69 74 74 65 64 20 74 6f 20 69 74 73 ient.window.is.now.fitted.to.its
845a0 20 62 75 66 66 65 72 20 68 6f 72 69 7a 6f 6e 74 61 6c 6c 79 20 61 73 20 77 65 6c 6c 2e 0a 20 20 .buffer.horizontally.as.well....
845c0 66 64 39 38 31 31 65 61 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 7e 74 fd9811ea..-.Added.new.command.~t
845e0 72 61 6e 73 69 65 6e 74 2d 63 6f 70 79 2d 6d 65 6e 75 2d 74 65 78 74 7e 2e 20 20 30 34 32 66 33 ransient-copy-menu-text~...042f3
84600 37 61 61 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 7e 74 72 61 6e 73 69 7aa..-.Added.new.command.~transi
84620 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 6f 63 73 74 72 69 6e 67 73 7e 2e 20 20 35 32 36 37 39 66 39 ent-toggle-docstrings~...52679f9
84640 38 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 8..-.Added.new.command.~transien
84660 74 2d 64 65 73 63 72 69 62 65 7e 2c 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 62 6f 75 6e 64 20 t-describe~,.which.can.be.bound.
84680 61 73 20 6d 61 6e 79 20 74 69 6d 65 73 0a 20 20 61 73 20 6e 65 65 64 65 64 20 74 6f 20 73 68 6f as.many.times...as.needed.to.sho
846a0 77 20 68 65 6c 70 20 66 6f 72 20 61 72 62 69 74 72 61 72 79 20 74 68 69 6e 67 73 2e 20 20 35 61 w.help.for.arbitrary.things...5a
846c0 31 38 61 37 39 31 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 54 68 65 20 75 73 65 20 6f 66 18a791..Bug.fixes:..-.The.use.of
846e0 20 7e 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 66 75 6c 6c 2d 66 72 61 6d 65 7e 20 77 61 73 .~display-buffer-full-frame~.was
84700 20 70 72 65 76 65 6e 74 65 64 20 74 6f 6f 20 61 67 67 72 65 73 73 69 76 65 6c 79 2e 0a 20 20 35 .prevented.too.aggressively....5
84720 33 35 33 34 36 34 62 0a 0a 2d 20 46 69 78 65 64 20 72 65 6d 65 6d 62 65 72 69 6e 67 20 61 6e 64 353464b..-.Fixed.remembering.and
84740 20 72 65 73 74 6f 72 69 6e 67 20 74 68 65 20 6f 6c 64 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 .restoring.the.old.value.of.the.
84760 7e 6e 6f 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 7e 0a 20 20 77 69 6e 64 6f 77 20 70 61 72 61 6d ~no-other-window~...window.param
84780 65 74 65 72 2e 20 20 64 65 39 38 34 33 30 32 0a 0a 2d 20 57 68 65 6e 20 61 20 63 6f 6d 6d 61 6e eter...de984302..-.When.a.comman
847a0 64 20 69 73 20 62 6f 75 6e 64 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 20 61 6e 64 20 74 68 d.is.bound.multiple.times.and.th
847c0 65 20 69 6e 73 74 61 6e 63 65 73 20 75 73 65 20 64 69 66 66 65 72 65 6e 74 0a 20 20 74 72 61 6e e.instances.use.different...tran
847e0 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 2c 20 74 68 65 6e 20 74 68 65 20 62 65 68 61 76 69 6f sient.behavior,.then.the.behavio
84800 72 20 28 61 6e 64 20 63 6f 6c 6f 72 29 20 66 6f 72 20 74 68 65 20 6c 61 73 74 20 62 69 6e 64 69 r.(and.color).for.the.last.bindi
84820 6e 67 0a 20 20 77 61 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20 62 69 6e 64 69 6e 67 73 2e 20 ng...was.used.for.all.bindings..
84840 20 66 65 37 31 61 37 65 37 2c 20 61 39 39 64 63 64 61 39 0a 0a 2d 20 45 6e 61 62 6c 69 6e 67 20 .fe71a7e7,.a99dcda9..-.Enabling.
84860 7e 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 73 69 6e 67 6c 65 2d 63 6f 6c 75 6d 6e 7e 20 ~transient-force-single-column~.
84880 72 65 73 75 6c 74 65 64 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 32 38 33 34 37 65 35 39 resulted.in.an.error....28347e59
848a0 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 63 6f 6d 6d 6f 6e 7e 20 75 73 ..-.~transient-toggle-common~.us
848c0 65 64 20 74 6f 20 65 78 69 74 20 74 68 65 20 6d 65 6e 75 2e 20 20 39 38 63 30 31 62 38 34 0a 0a ed.to.exit.the.menu...98c01b84..
848e0 2a 20 76 30 2e 38 2e 31 20 20 20 20 32 30 32 34 2d 31 32 2d 30 38 0a 0a 42 75 67 20 66 69 78 65 *.v0.8.1....2024-12-08..Bug.fixe
84900 73 3a 0a 0a 2d 20 49 6e 74 65 72 61 63 74 69 76 65 6c 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 s:..-.Interactively.setting.the.
84920 6c 65 76 65 6c 20 6f 66 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 72 65 73 75 level.of.a.transient.prefix.resu
84940 6c 74 65 64 20 69 6e 0a 20 20 61 6e 20 65 72 72 6f 72 2e 20 20 23 33 33 37 2e 0a 0a 2a 20 76 30 lted.in...an.error...#337...*.v0
84960 2e 38 2e 30 20 20 20 20 32 30 32 34 2d 31 32 2d 30 36 0a 0a 2d 20 57 68 69 6c 65 20 74 68 65 20 .8.0....2024-12-06..-.While.the.
84980 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 69 6e 20 75 73 65 2c 20 74 68 65 20 6d 65 6e 75 20 77 minibuffer.is.in.use,.the.menu.w
849a0 69 6e 64 6f 77 20 69 73 20 6e 6f 77 20 68 69 64 64 65 6e 20 62 79 0a 20 20 64 65 66 61 75 6c 74 indow.is.now.hidden.by...default
849c0 2e 20 20 54 68 65 20 6e 65 77 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f ...The.new.option.~transient-sho
849e0 77 2d 64 75 72 69 6e 67 2d 6d 69 6e 69 62 75 66 66 65 72 2d 72 65 61 64 7e 20 6e 6f 74 0a 20 20 w-during-minibuffer-read~.not...
84a00 6f 6e 6c 79 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74 68 65 20 6d 65 6e 75 20 73 only.controls.whether.the.menu.s
84a20 74 61 79 73 20 76 69 73 69 62 6c 65 20 77 68 69 6c 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 tays.visible.while.the.minibuffe
84a40 72 0a 20 20 69 73 20 69 6e 20 75 73 65 2c 20 62 75 74 20 61 6c 73 6f 20 77 68 65 74 68 65 72 20 r...is.in.use,.but.also.whether.
84a60 69 74 20 6d 61 79 20 62 65 20 72 65 73 69 7a 65 64 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 20 it.may.be.resized.if.necessary..
84a80 20 54 68 69 73 0a 20 20 6e 65 77 20 6f 70 74 69 6f 6e 20 72 65 70 6c 61 63 65 73 20 7e 74 72 61 .This...new.option.replaces.~tra
84aa0 6e 73 69 65 6e 74 2d 68 69 64 65 2d 64 75 72 69 6e 67 2d 6d 69 6e 69 62 75 66 66 65 72 2d 72 65 nsient-hide-during-minibuffer-re
84ac0 61 64 7e 2e 20 20 23 33 33 30 0a 0a 2d 20 57 68 65 6e 20 72 65 74 75 72 6e 69 6e 67 20 74 6f 20 ad~...#330..-.When.returning.to.
84ae0 61 20 70 72 65 66 69 78 20 77 68 6f 73 65 20 7e 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 a.prefix.whose.~refresh-suffixes
84b00 7e 20 73 6c 6f 74 20 69 73 20 6e 6f 6e 2d 6e 69 6c 2c 0a 20 20 69 74 73 20 73 75 66 66 69 78 65 ~.slot.is.non-nil,...its.suffixe
84b20 73 20 61 72 65 20 6e 6f 77 20 72 65 2d 69 6e 69 74 69 61 6c 69 7a 65 64 2e 20 20 23 33 32 37 0a s.are.now.re-initialized...#327.
84b40 0a 2d 20 41 64 64 65 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 7e 69 6e 61 70 .-.Added.documentation.for.~inap
84b60 74 2d 69 66 2a 7e 20 73 6c 6f 74 73 20 74 6f 20 6d 61 6e 75 61 6c 2e 20 20 31 37 39 35 34 35 61 t-if*~.slots.to.manual...179545a
84b80 36 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 20 6e 6f 77 20 74 61 6b 65 73 20 6..-.~transient-args~.now.takes.
84ba0 61 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 70 72 a.prefix.command.or.a.list.of.pr
84bc0 65 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61 73 20 61 72 67 75 6d 65 6e 74 2e 0a 0a 2d 20 efix...commands.as.argument...-.
84be0 7e 74 72 61 6e 73 69 65 6e 74 2d 73 63 6f 70 65 7e 20 6e 6f 77 20 74 61 6b 65 73 20 61 20 70 72 ~transient-scope~.now.takes.a.pr
84c00 65 66 69 78 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 70 72 65 66 69 78 efix.command.or.a.list.of.prefix
84c20 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 2f 6f 72 20 61 20 70 72 65 66 69 78 20 63 6c 61 73 ...commands.and/or.a.prefix.clas
84c40 73 20 6f 72 20 6c 69 73 74 20 6f 66 20 70 72 65 66 69 78 20 63 6c 61 73 73 65 73 20 61 73 0a 20 s.or.list.of.prefix.classes.as..
84c60 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 49 74 20 63 61 6e 20 73 74 69 6c 6c 20 62 65 20 63 61 6c .arguments...It.can.still.be.cal
84c80 6c 65 64 20 77 69 74 68 6f 75 74 20 61 6e 79 20 61 72 67 75 6d 65 6e 74 2c 20 62 75 74 20 74 68 led.without.any.argument,.but.th
84ca0 61 74 0a 20 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 64 6f 6e 65 20 69 6e 20 66 75 6e 63 at...should.only.be.done.in.func
84cc0 74 69 6f 6e 73 20 74 68 61 74 20 74 61 6b 65 20 70 61 72 74 20 69 6e 20 73 65 74 74 69 6e 67 20 tions.that.take.part.in.setting.
84ce0 75 70 20 61 0a 20 20 6d 65 6e 75 2c 20 6e 6f 74 20 69 6e 20 61 20 73 75 66 66 69 78 20 63 6f 6d up.a...menu,.not.in.a.suffix.com
84d00 6d 61 6e 64 2e 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 mand...-.Added.new.generic.funct
84d20 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 76 61 6c 75 65 7e 2c 20 67 69 ion.~transient-prefix-value~,.gi
84d40 76 69 6e 67 20 66 69 6e 65 72 0a 20 20 63 6f 6e 74 72 6f 6c 20 6f 76 65 72 20 68 6f 77 20 74 68 ving.finer...control.over.how.th
84d60 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 e.value.returned.by.~transient-a
84d80 72 67 73 7e 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 2e 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 rgs~.is.determined...-.Added.sup
84da0 70 6f 72 74 20 66 6f 72 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 port.for.implementing.~transient
84dc0 2d 69 6e 69 74 2d 73 63 6f 70 65 7e 20 6d 65 74 68 6f 64 73 20 66 6f 72 0a 20 20 70 72 65 66 69 -init-scope~.methods.for...prefi
84de0 78 20 63 6c 61 73 73 65 73 2e 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 75 70 2d 62 x.classes...-.~transient-setup-b
84e00 75 66 66 65 72 2d 68 6f 6f 6b 7e 20 69 73 20 6e 6f 77 20 72 75 6e 20 6c 61 74 65 72 20 74 6f 20 uffer-hook~.is.now.run.later.to.
84e20 61 6c 6c 6f 77 20 6f 76 65 72 72 69 64 69 6e 67 0a 20 20 6d 6f 72 65 20 64 65 66 61 75 6c 74 20 allow.overriding...more.default.
84e40 73 65 74 74 69 6e 67 73 2e 0a 0a 2d 20 54 68 65 20 6e 65 77 20 70 72 65 66 69 78 20 73 6c 6f 74 settings...-.The.new.prefix.slot
84e60 73 20 7e 64 69 73 70 6c 61 79 2d 61 63 74 69 6f 6e 7e 20 61 6e 64 20 7e 6d 6f 64 65 2d 6c 69 6e s.~display-action~.and.~mode-lin
84e80 65 2d 66 6f 72 6d 61 74 7e 2c 20 63 61 6e 20 62 65 0a 20 20 75 73 65 64 20 74 6f 20 6f 76 65 72 e-format~,.can.be...used.to.over
84ea0 72 69 64 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 ride.~transient-display-buffer-a
84ec0 63 74 69 6f 6e 7e 20 61 6e 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6d 6f 64 65 2d 6c 69 6e ction~.and...~transient-mode-lin
84ee0 65 2d 66 6f 72 6d 61 74 7e 20 66 6f 72 20 69 6e 64 69 76 69 64 75 61 6c 20 70 72 65 66 69 78 20 e-format~.for.individual.prefix.
84f00 6d 65 6e 75 73 2e 20 20 23 33 33 32 0a 0a 2d 20 55 70 64 61 74 65 64 20 74 68 65 20 6d 61 6e 75 menus...#332..-.Updated.the.manu
84f20 61 6c 20 63 6f 6e 73 69 64 65 72 61 62 6c 79 2e 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 al.considerably...Bug.fixes:..-.
84f40 46 69 78 65 73 20 73 6f 6d 65 20 6d 65 6e 75 20 6e 61 76 69 67 61 74 69 6f 6e 20 65 64 67 65 2d Fixes.some.menu.navigation.edge-
84f60 63 61 73 65 73 2e 0a 0a 2a 20 76 30 2e 37 2e 39 20 20 20 20 32 30 32 34 2d 31 31 2d 30 34 0a 0a cases...*.v0.7.9....2024-11-04..
84f80 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 46 69 78 65 64 20 61 20 72 65 63 65 6e 74 20 72 65 67 Bug.fixes:..-.Fixed.a.recent.reg
84fa0 72 65 73 73 69 6f 6e 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a ression.in.~transient-suffix-obj
84fc0 65 63 74 7e 2e 20 20 23 33 32 35 0a 0a 2d 20 54 68 65 20 68 65 69 67 68 74 20 6f 66 20 74 68 65 ect~...#325..-.The.height.of.the
84fe0 20 74 72 61 6e 73 69 65 6e 74 20 77 69 6e 64 6f 77 20 77 61 73 20 66 69 78 65 64 20 65 76 65 6e .transient.window.was.fixed.even
85000 20 69 74 20 75 73 65 64 20 74 68 65 20 66 75 6c 6c 0a 20 20 66 72 61 6d 65 20 68 65 69 67 68 74 .it.used.the.full...frame.height
85020 2e 20 20 35 34 37 38 64 34 65 36 0a 0a 2a 20 76 30 2e 37 2e 38 20 20 20 20 32 30 32 34 2d 31 31 ...5478d4e6..*.v0.7.8....2024-11
85040 2d 30 32 0a 0a 2d 20 41 64 64 69 74 69 6f 6e 61 6c 20 70 6f 74 65 6e 74 69 61 6c 20 6d 69 73 74 -02..-.Additional.potential.mist
85060 61 6b 65 73 20 69 6e 20 6d 65 6e 75 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 72 65 20 6e 6f 77 akes.in.menu.definitions.are.now
85080 20 64 65 74 65 63 74 65 64 2e 0a 20 20 62 62 64 61 35 62 62 36 2c 20 38 38 37 33 63 33 30 30 0a .detected....bbda5bb6,.8873c300.
850a0 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 28 61 6e 64 20 73 74 69 6c 6c 20 65 78 70 65 72 69 6d 65 .-.Added.new.(and.still.experime
850c0 6e 74 61 6c 29 20 7e 65 6e 76 69 72 6f 6e 6d 65 6e 74 7e 20 70 72 65 66 69 78 20 73 6c 6f 74 2c ntal).~environment~.prefix.slot,
850e0 20 77 68 69 63 68 0a 20 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 2c 20 66 6f 72 20 65 78 61 .which...can.be.used.to,.for.exa
85100 6d 70 6c 65 2c 20 69 6d 70 6c 65 6d 65 6e 74 20 61 20 63 61 63 68 65 20 74 6f 20 62 65 20 75 73 mple,.implement.a.cache.to.be.us
85120 65 64 20 77 68 69 6c 65 0a 20 20 72 65 66 72 65 73 68 69 6e 67 20 74 68 65 20 6d 65 6e 75 2e 20 ed.while...refreshing.the.menu..
85140 20 30 35 63 30 31 31 62 38 0a 0a 2d 20 57 68 65 6e 20 6e 61 76 69 67 61 74 69 6e 67 20 74 68 72 .05c011b8..-.When.navigating.thr
85160 6f 75 67 68 20 74 68 65 20 6d 65 6e 75 20 75 73 69 6e 67 20 74 68 65 20 6b 65 79 62 6f 61 72 64 ough.the.menu.using.the.keyboard
85180 20 6f 72 20 68 6f 76 65 72 69 6e 67 20 61 0a 20 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 .or.hovering.a...suffix.command.
851a0 77 69 74 68 20 74 68 65 20 6d 6f 75 73 65 2c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 with.the.mouse,.information.abou
851c0 74 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 77 0a 20 20 73 68 6f 77 6e 20 69 6e 20 t.the.command.is.now...shown.in.
851e0 74 68 65 20 65 63 68 6f 20 61 72 65 61 20 6f 72 20 75 73 69 6e 67 20 61 20 74 6f 6f 6c 74 69 70 the.echo.area.or.using.a.tooltip
85200 2e 20 20 23 32 38 32 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 57 68 65 6e 20 74 68 65 20 ...#282..Bug.fixes:..-.When.the.
85220 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 65 78 69 74 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 75 command.that.exits.a.transient.u
85240 73 65 73 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 ses.the.minibuffer,...~transient
85260 2d 63 75 72 72 65 6e 74 2d 2a 7e 20 76 61 72 69 61 62 6c 65 73 20 77 65 72 65 20 6e 6f 74 20 69 -current-*~.variables.were.not.i
85280 6d 6d 65 64 69 61 74 65 6c 79 20 72 65 73 65 74 20 74 6f 0a 20 20 7e 6e 69 6c 7e 2e 20 23 33 32 mmediately.reset.to...~nil~..#32
852a0 33 0a 0a 2d 20 4b 65 79 20 73 65 71 75 65 6e 63 65 73 20 77 69 74 68 20 74 68 72 65 65 20 6f 72 3..-.Key.sequences.with.three.or
852c0 20 6d 6f 72 65 20 65 76 65 6e 74 73 20 62 72 6f 6b 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d .more.events.broke...~transient-
852e0 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 7e 2e 20 20 23 33 32 34 0a 0a 2a 20 76 30 2e 37 2e 37 20 suffix-object~...#324..*.v0.7.7.
85300 20 20 20 32 30 32 34 2d 31 30 2d 30 34 0a 0a 42 75 67 20 66 69 78 3a 0a 0a 2d 20 46 69 78 20 61 ...2024-10-04..Bug.fix:..-.Fix.a
85320 20 72 65 67 72 65 73 73 69 6f 6e 20 69 6e 74 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 70 72 .regression.introduced.by.the.pr
85340 65 76 69 6f 75 73 20 63 6f 6d 6d 69 74 2c 20 77 68 69 63 68 20 62 72 6f 6b 65 0a 20 20 64 79 6e evious.commit,.which.broke...dyn
85360 61 6d 69 63 20 70 72 65 66 69 78 65 73 20 74 68 61 74 20 75 73 65 20 61 20 7e 3a 73 65 74 75 70 amic.prefixes.that.use.a.~:setup
85380 2d 63 68 69 6c 64 72 65 6e 7e 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 70 72 65 70 61 72 65 0a 20 -children~.function.to.prepare..
853a0 20 74 68 65 69 72 20 73 75 66 66 69 78 65 73 2e 20 20 23 33 31 33 0a 0a 2a 20 76 30 2e 37 2e 36 .their.suffixes...#313..*.v0.7.6
853c0 20 20 20 20 32 30 32 34 2d 31 30 2d 30 31 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 63 74 ....2024-10-01..-.~transient-act
853e0 69 76 65 2d 70 72 65 66 69 78 7e 20 6e 6f 77 20 61 63 63 65 70 74 73 20 61 20 73 69 6e 67 6c 65 ive-prefix~.now.accepts.a.single
85400 20 70 72 65 66 69 78 20 73 79 6d 62 6f 6c 2c 20 69 6e 20 70 6c 61 63 65 0a 20 20 6f 66 20 61 20 .prefix.symbol,.in.place...of.a.
85420 6c 69 73 74 20 6f 66 20 73 75 63 68 20 73 79 6d 62 6f 6c 73 2e 20 20 23 33 30 37 0a 0a 2d 20 7e list.of.such.symbols...#307..-.~
85440 6f 74 68 65 72 2d 66 72 61 6d 65 2d 70 72 65 66 69 78 7e 20 61 6e 64 20 7e 6f 74 68 65 72 2d 77 other-frame-prefix~.and.~other-w
85460 69 6e 64 6f 77 2d 70 72 65 66 69 78 7e 20 63 61 6e 20 6e 6f 77 20 62 65 20 75 73 65 64 20 77 68 indow-prefix~.can.now.be.used.wh
85480 69 6c 65 20 61 0a 20 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 69 73 20 61 63 74 69 ile.a...transient.prefix.is.acti
854a0 76 65 2e 20 20 23 33 30 35 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 6d 61 63 72 6f 20 7e 74 72 ve...#305..-.Added.new.macro.~tr
854c0 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 68 65 6c 70 2d 77 69 6e 64 6f 77 7e 20 66 6f 72 20 75 73 ansient-with-help-window~.for.us
854e0 65 20 69 6e 20 7e 3a 73 68 6f 77 2d 68 65 6c 70 7e 0a 20 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 e.in.~:show-help~...functions...
85500 23 33 30 39 0a 0a 2a 20 76 30 2e 37 2e 35 20 20 20 20 32 30 32 34 2d 30 39 2d 30 31 0a 0a 2d 20 #309..*.v0.7.5....2024-09-01..-.
85520 55 70 64 61 74 65 64 20 74 6f 6f 6c 69 6e 67 2e 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 Updated.tooling...Bug.fixes:..-.
85540 7e 73 74 61 74 69 63 2d 69 66 7e 20 69 73 20 6e 6f 77 20 75 73 65 64 20 63 6f 72 72 65 63 74 6c ~static-if~.is.now.used.correctl
85560 79 2e 20 20 30 65 33 35 36 37 33 65 0a 0a 2d 20 57 68 65 6e 20 61 6e 20 65 78 69 73 74 69 6e 67 y...0e35673e..-.When.an.existing
85580 20 77 69 6e 64 6f 77 20 65 6e 64 73 20 75 70 20 62 65 69 6e 67 20 75 73 65 64 20 74 6f 20 64 69 .window.ends.up.being.used.to.di
855a0 73 70 6c 61 79 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 62 75 66 66 65 72 2c 20 74 68 splay.the.transient...buffer,.th
855c0 65 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 7e 6e 6f en.the.previous.value.of.the.~no
855e0 2d 6f 74 68 65 72 2d 77 69 6e 64 6f 77 7e 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a 20 20 6e 6f -other-window~.parameter.is...no
85600 77 20 72 65 73 74 6f 72 65 64 2c 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 69 w.restored,.when.the.transient.i
85620 73 20 65 78 69 74 65 64 2e 20 20 23 33 30 32 0a 0a 2d 20 54 68 65 20 6e 61 6d 65 73 20 61 73 73 s.exited...#302..-.The.names.ass
85640 69 67 6e 65 64 20 74 6f 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 61 72 65 20 64 65 66 igned.to.suffixes,.which.are.def
85660 69 6e 65 64 20 75 73 69 6e 67 20 6c 61 6d 62 64 61 73 20 69 6e 0a 20 20 74 68 65 20 70 72 65 66 ined.using.lambdas.in...the.pref
85680 69 78 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20 61 72 65 20 6e 6f 77 20 67 75 61 72 61 6e 74 65 65 ix.definition,.are.now.guarantee
856a0 64 20 74 6f 20 62 65 20 75 6e 69 71 75 65 2e 20 20 23 33 30 34 0a 0a 2a 20 76 30 2e 37 2e 34 20 d.to.be.unique...#304..*.v0.7.4.
856c0 20 20 20 32 30 32 34 2d 30 38 2d 30 35 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 66 75 6e 63 74 ...2024-08-05..-.Added.new.funct
856e0 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 63 74 69 76 65 2d 70 72 65 66 69 78 7e 2e 0a 0a ion.~transient-active-prefix~...
85700 2a 20 76 30 2e 37 2e 33 20 20 20 20 32 30 32 34 2d 30 37 2d 31 33 0a 0a 2d 20 52 65 66 61 63 74 *.v0.7.3....2024-07-13..-.Refact
85720 6f 72 65 64 20 63 6f 64 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 69 6e 73 65 72 74 ored.code.responsible.for.insert
85740 69 6e 67 20 63 6f 6c 75 6d 6e 73 2e 0a 0a 42 75 67 20 66 69 78 3a 0a 0a 2d 20 54 68 65 20 7e 74 ing.columns...Bug.fix:..-.The.~t
85760 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 6e 74 2d 2a 7e 20 76 61 72 69 61 62 6c 65 73 20 61 72 ransient-current-*~.variables.ar
85780 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 62 79 0a 20 20 e.intended.to.only.be.used.by...
857a0 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 65 6e 20 74 68 65 79 20 61 72 65 20 69 suffix.commands,.when.they.are.i
857c0 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 61 20 70 72 65 66 69 78 2e 20 20 50 72 65 76 69 6f 75 73 6c nvoked.from.a.prefix...Previousl
857e0 79 0a 20 20 74 68 65 79 20 77 65 72 65 20 6f 6e 6c 79 20 63 6c 65 61 72 65 64 20 77 68 65 6e 20 y...they.were.only.cleared.when.
85800 74 68 65 20 70 72 65 66 69 78 20 69 73 20 75 6c 74 69 6d 61 74 65 6c 79 20 65 78 69 74 65 64 2c the.prefix.is.ultimately.exited,
85820 20 77 68 69 63 68 0a 20 20 6d 65 61 6e 74 20 74 68 61 74 20 74 68 65 79 20 75 6e 69 6e 74 65 6e .which...meant.that.they.uninten
85840 74 69 6f 6e 61 6c 6c 79 20 77 65 72 65 20 61 63 63 65 73 73 69 62 6c 65 20 69 6e 20 74 69 6d 65 tionally.were.accessible.in.time
85860 72 73 2e 20 20 4e 6f 77 20 74 68 65 0a 20 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 73 65 20 76 rs...Now.the...values.of.these.v
85880 61 72 69 61 62 6c 65 73 20 61 72 65 20 6e 69 6c 20 77 68 65 6e 20 75 73 65 64 20 6f 75 74 73 69 ariables.are.nil.when.used.outsi
858a0 64 65 20 74 68 65 69 72 20 69 6e 74 65 6e 64 65 64 0a 20 20 73 63 6f 70 65 2e 20 20 30 65 30 65 de.their.intended...scope...0e0e
858c0 63 65 33 32 2c 20 66 32 63 62 32 38 61 35 0a 0a 2a 20 76 30 2e 37 2e 32 20 20 20 20 32 30 32 34 ce32,.f2cb28a5..*.v0.7.2....2024
858e0 2d 30 36 2d 32 34 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 61 64 64 69 -06-24..-.Added.support.for.addi
85900 6e 67 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 61 63 74 69 76 61 74 65 20 76 61 6c 75 65 20 ng.suffixes.that.activate.value.
85920 70 72 65 73 65 74 73 2e 20 20 23 31 38 33 0a 0a 42 75 67 20 66 69 78 3a 0a 0a 2d 20 52 65 73 74 presets...#183..Bug.fix:..-.Rest
85940 6f 72 65 64 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 69 6e 64 69 76 69 64 75 61 6c 6c 79 ored.the.ability.to.individually
85960 20 73 65 74 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 69 66 20 74 68 65 0a 20 20 70 72 .set.infix.arguments.if.the...pr
85980 65 66 69 78 27 73 20 7e 72 65 66 72 65 73 68 2d 73 75 66 66 69 78 65 73 7e 20 73 6c 6f 74 20 69 efix's.~refresh-suffixes~.slot.i
859a0 73 20 6e 6f 6e 2d 6e 69 6c 2e 20 20 38 64 62 35 66 30 66 64 0a 0a 2a 20 76 30 2e 37 2e 31 20 20 s.non-nil...8db5f0fd..*.v0.7.1..
859c0 20 20 32 30 32 34 2d 30 36 2d 31 39 0a 0a 2d 20 41 64 64 65 64 20 61 20 77 6f 72 6b 61 72 6f 75 ..2024-06-19..-.Added.a.workarou
859e0 6e 64 20 66 6f 72 20 7e 65 6d 6f 6a 69 2e 65 6c 7e 20 66 72 6f 6d 20 45 6d 61 63 73 20 32 39 2e nd.for.~emoji.el~.from.Emacs.29.
85a00 31 20 63 61 6c 6c 69 6e 67 20 61 6e 20 69 6e 74 65 72 6e 61 6c 0a 20 20 66 75 6e 63 74 69 6f 6e 1.calling.an.internal...function
85a20 20 75 73 69 6e 67 20 61 6e 20 6f 75 74 64 61 74 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 .using.an.outdated.number.of.arg
85a40 75 6d 65 6e 74 73 2e 20 20 23 32 38 38 0a 0a 2a 20 76 30 2e 37 2e 30 20 20 20 20 32 30 32 34 2d uments...#288..*.v0.7.0....2024-
85a60 30 36 2d 31 38 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 6d 61 63 72 6f 20 7e 74 72 61 6e 73 69 06-18..-.Added.new.macro.~transi
85a80 65 6e 74 2d 61 75 67 6d 65 6e 74 2d 73 75 66 66 69 78 7e 2c 20 77 68 69 63 68 20 63 61 6e 20 62 ent-augment-suffix~,.which.can.b
85aa0 65 20 75 73 65 64 20 74 6f 0a 20 20 73 70 65 63 69 66 79 20 74 68 65 20 73 75 66 66 69 78 20 62 e.used.to...specify.the.suffix.b
85ac0 65 68 61 76 69 6f 72 20 6f 66 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 77 61 73 20 70 72 ehavior.of.a.command.that.was.pr
85ae0 65 76 69 6f 75 73 6c 79 20 64 65 66 69 6e 65 64 0a 20 20 61 73 20 61 20 70 72 65 66 69 78 2c 20 eviously.defined...as.a.prefix,.
85b00 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e 2e using.~transient-define-prefix~.
85b20 20 20 32 66 64 33 65 61 31 34 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e ..2fd3ea14..-.Added.new.function
85b40 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 63 6f 70 65 7e 2c 20 77 68 69 63 68 20 69 73 20 6a 75 73 .~transient-scope~,.which.is.jus
85b60 74 20 61 20 63 6f 6e 76 65 6e 69 65 6e 74 20 77 61 79 0a 20 20 74 6f 20 67 65 74 20 74 68 65 20 t.a.convenient.way...to.get.the.
85b80 76 61 6c 75 65 20 6f 66 20 74 68 65 20 7e 73 63 6f 70 65 7e 20 73 6c 6f 74 20 6f 66 20 74 68 65 value.of.the.~scope~.slot.of.the
85ba0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 7e 2e 0a 20 20 37 66 .~transient-prefix-object~....7f
85bc0 36 63 33 39 63 35 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 68 6f 6f 6b 20 7e 74 72 61 6e 73 69 6c39c5..-.Added.new.hook.~transi
85be0 65 6e 74 2d 73 65 74 75 70 2d 62 75 66 66 65 72 2d 68 6f 6f 6b 7e 2c 20 77 68 69 63 68 20 69 73 ent-setup-buffer-hook~,.which.is
85c00 20 72 75 6e 20 65 61 72 6c 79 20 77 68 65 6e 0a 20 20 73 65 74 74 69 6e 67 20 74 68 65 20 74 72 .run.early.when...setting.the.tr
85c20 61 6e 73 69 65 6e 74 20 6d 65 6e 75 20 62 75 66 66 65 72 2e 20 20 23 32 38 33 0a 0a 2d 20 41 64 ansient.menu.buffer...#283..-.Ad
85c40 64 65 64 20 6e 65 77 20 63 6c 61 73 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 ded.new.class.~transient-informa
85c60 74 69 6f 6e 2a 7e 2c 20 61 20 76 61 72 69 61 6e 74 20 6f 66 20 72 65 63 65 6e 74 6c 79 20 61 64 tion*~,.a.variant.of.recently.ad
85c80 64 65 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 6f 72 6d 61 74 69 6f 6e 7e 20 63 6c ded...~transient-information~.cl
85ca0 61 73 73 2e 20 20 38 61 38 30 65 39 35 32 0a 0a 2d 20 42 79 20 64 65 66 61 75 6c 74 20 6f 75 72 ass...8a80e952..-.By.default.our
85cc0 20 6d 61 63 72 6f 73 20 74 68 61 74 20 64 65 66 69 6e 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 6d 61 .macros.that.define.commands,.ma
85ce0 72 6b 20 74 68 6f 73 65 20 61 73 20 66 6f 72 0a 20 20 69 6e 74 65 72 61 63 74 69 76 65 20 75 73 rk.those.as.for...interactive.us
85d00 65 20 6f 6e 6c 79 2e 20 20 7e 28 64 65 63 6c 61 72 65 20 28 69 6e 74 65 72 61 63 74 69 76 65 2d e.only...~(declare.(interactive-
85d20 6f 6e 6c 79 20 6e 69 6c 29 29 7e 20 63 61 6e 20 6e 6f 77 20 62 65 0a 20 20 75 73 65 64 20 74 6f only.nil))~.can.now.be...used.to
85d40 20 6f 76 65 72 77 72 69 74 65 20 74 68 61 74 2e 20 20 66 63 63 36 30 65 32 37 0a 0a 2d 20 47 72 .overwrite.that...fcc60e27..-.Gr
85d60 6f 75 70 73 20 6e 6f 77 20 61 6c 73 6f 20 61 63 63 65 70 74 20 7e 3a 69 6e 61 70 74 2a 7e 20 70 oups.now.also.accept.~:inapt*~.p
85d80 72 65 64 69 63 61 74 65 73 2e 20 20 33 64 33 39 35 64 36 34 0a 0a 2d 20 53 70 61 63 65 73 20 62 redicates...3d395d64..-.Spaces.b
85da0 65 74 77 65 65 6e 20 63 6f 6c 75 6d 6e 73 20 69 73 20 72 65 64 75 63 65 64 20 66 72 6f 6d 20 74 etween.columns.is.reduced.from.t
85dc0 68 72 65 65 20 74 6f 20 74 77 6f 2e 20 20 64 64 39 33 30 30 31 65 0a 0a 2d 20 52 65 6d 6f 76 65 hree.to.two...dd93001e..-.Remove
85de0 64 20 75 6e 75 73 65 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 6c 69 73 74 2d 74 6f 2d 61 6c 69 d.unused.~transient-plist-to-ali
85e00 73 74 7e 20 66 75 6e 63 74 69 6f 6e 2e 20 20 31 32 35 31 66 61 66 30 0a 0a 42 75 67 20 66 69 78 st~.function...1251faf0..Bug.fix
85e20 65 73 3a 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 es:..-.~transient--force-fixed-p
85e40 69 74 63 68 7e 20 77 61 73 20 72 75 6e 20 74 6f 20 6c 61 74 65 20 74 6f 20 61 6c 77 61 79 73 20 itch~.was.run.to.late.to.always.
85e60 73 75 63 63 65 65 64 2e 20 20 23 32 38 33 0a 0a 2d 20 4b 65 79 20 62 69 6e 64 69 6e 67 20 63 6f succeed...#283..-.Key.binding.co
85e80 6e 66 6c 69 63 74 20 64 65 74 65 63 74 69 6f 6e 20 77 61 73 20 74 6f 6f 20 73 74 72 69 63 74 2c nflict.detection.was.too.strict,
85ea0 20 74 61 6b 69 6e 67 20 68 79 70 6f 74 68 65 74 69 63 61 6c 0a 20 20 62 69 6e 64 69 6e 67 73 20 .taking.hypothetical...bindings.
85ec0 66 6f 72 20 69 6e 61 70 74 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 74 6f 20 61 63 63 6f 75 6e 74 2e for.inapt.commands.into.account.
85ee0 20 20 63 33 35 36 64 31 62 63 0a 0a 2d 20 4b 65 79 20 62 69 6e 64 69 6e 67 20 63 6f 6e 66 6c 69 ..c356d1bc..-.Key.binding.confli
85f00 63 74 20 64 65 74 65 63 74 69 6f 6e 20 64 69 64 20 6e 6f 74 20 63 6f 6e 73 69 64 65 72 20 62 69 ct.detection.did.not.consider.bi
85f20 6e 64 69 6e 67 73 20 69 6e 20 72 65 67 75 6c 61 72 0a 20 20 6b 65 79 6d 61 70 73 2c 20 73 75 63 ndings.in.regular...keymaps,.suc
85f40 68 20 61 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 7e 2e 20 20 32 36 39 38 h.as.~transient-base-map~...2698
85f60 64 36 32 64 0a 0a 2d 20 7e 66 75 6e 63 2d 61 72 69 74 79 7e 20 67 65 74 73 20 63 6f 6e 66 75 73 d62d..-.~func-arity~.gets.confus
85f80 65 64 20 77 68 65 6e 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 64 76 69 73 65 64 2c 20 73 ed.when.a.function.is.advised,.s
85fa0 6f 20 77 65 20 68 61 64 20 74 6f 0a 20 20 61 64 64 20 61 20 77 72 61 70 70 65 72 20 66 75 6e 63 o.we.had.to...add.a.wrapper.func
85fc0 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 66 75 6e 63 2d 61 72 69 74 79 7e 2e 20 20 39 tion.~transient--func-arity~...9
85fe0 31 64 64 37 62 62 33 0a 0a 2d 20 53 6f 6d 65 20 6d 69 73 74 61 6b 65 73 2c 20 74 68 61 74 20 63 1dd7bb3..-.Some.mistakes,.that.c
86000 61 6e 20 62 65 20 65 78 70 65 63 74 65 64 20 74 6f 20 6f 63 63 75 72 20 77 68 65 6e 20 64 65 66 an.be.expected.to.occur.when.def
86020 69 6e 69 6e 67 20 73 75 66 66 69 78 20 61 6e 64 0a 20 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e ining.suffix.and...prefix.comman
86040 64 73 2c 20 77 65 72 65 20 6e 6f 74 20 64 65 74 65 63 74 65 64 2e 20 20 37 65 38 32 37 63 33 31 ds,.were.not.detected...7e827c31
86060 0a 0a 2a 20 76 30 2e 36 2e 30 20 20 20 20 32 30 32 34 2d 30 33 2d 32 31 0a 0a 2d 20 4f 6e 20 45 ..*.v0.6.0....2024-03-21..-.On.E
86080 6d 61 63 73 20 32 38 2e 31 20 61 6e 64 20 6c 61 74 65 72 2c 20 61 6c 6c 20 69 6e 66 69 78 20 63 macs.28.1.and.later,.all.infix.c
860a0 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 0a 20 20 74 68 ommands.and.suffix.commands...th
860c0 61 74 20 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e 6c 69 6e 65 20 28 69 2e 65 2e 2c 20 75 73 69 at.are.defined.inline.(i.e.,.usi
860e0 6e 67 20 61 20 6c 61 6d 62 64 61 20 77 68 65 6e 20 64 65 66 69 6e 69 6e 67 20 61 20 70 72 65 66 ng.a.lambda.when.defining.a.pref
86100 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 29 2c 20 61 72 65 20 6e 6f 77 20 68 69 64 64 65 6e 20 66 72 ix...command),.are.now.hidden.fr
86120 6f 6d 20 7e 65 78 65 63 75 74 65 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 7e 20 28 61 om.~execute-extended-command~.(a
86140 6b 61 20 7e 4d 2d 78 7e 29 20 2f 62 79 0a 20 20 64 65 66 61 75 6c 74 2f 2e 20 20 49 74 20 77 61 ka.~M-x~)./by...default/...It.wa
86160 73 20 61 6c 72 65 61 64 79 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 68 69 64 65 20 74 68 65 73 65 s.already.possible.to.hide.these
86180 20 63 6f 6d 6d 61 6e 64 73 2c 20 62 75 74 20 75 73 65 72 73 0a 20 20 68 61 64 20 74 6f 20 6f 70 .commands,.but.users...had.to.op
861a0 74 2d 69 6e 20 65 78 70 6c 69 63 69 74 6c 79 2e 20 20 41 66 74 65 72 20 72 65 66 61 63 74 6f 72 t-in.explicitly...After.refactor
861c0 69 6e 67 20 68 6f 77 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 0a 20 20 64 65 63 ing.how.these.commands.are...dec
861e0 6c 61 72 65 64 20 74 6f 20 62 65 20 75 6e 73 75 69 74 61 62 6c 65 20 66 6f 72 20 7e 4d 2d 78 7e lared.to.be.unsuitable.for.~M-x~
86200 2c 20 69 74 20 69 73 20 6e 6f 77 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 68 69 64 65 20 74 68 65 ,.it.is.now.possible.to.hide.the
86220 6d 0a 20 20 2f 77 69 74 68 6f 75 74 2f 20 61 6c 73 6f 20 68 69 64 69 6e 67 20 6f 74 68 65 72 2c m.../without/.also.hiding.other,
86240 20 75 6e 72 65 6c 61 74 65 64 20 6b 69 6e 64 73 20 6f 66 20 75 6e 73 75 69 74 61 62 6c 65 20 63 .unrelated.kinds.of.unsuitable.c
86260 6f 6d 6d 61 6e 64 73 2e 0a 0a 20 20 49 20 72 65 63 6f 6d 6d 65 6e 64 20 74 68 61 74 20 79 6f 75 ommands.....I.recommend.that.you
86280 20 69 6e 73 74 72 75 63 74 20 7e 4d 2d 78 7e 20 74 6f 20 68 69 64 65 20 2f 61 6c 6c 2f 20 75 6e .instruct.~M-x~.to.hide./all/.un
862a0 73 75 69 74 61 62 6c 65 20 63 6f 6d 6d 61 6e 64 2e 0a 20 20 54 68 69 73 20 72 65 71 75 69 72 65 suitable.command....This.require
862c0 73 20 74 68 61 74 20 79 6f 75 20 63 75 73 74 6f 6d 69 7a 69 6e 67 20 7e 72 65 61 64 2d 65 78 74 s.that.you.customizing.~read-ext
862e0 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 64 69 63 61 74 65 7e 2c 0a 20 20 62 65 63 61 ended-command-predicate~,...beca
86300 75 73 65 20 74 68 65 20 45 6d 61 63 73 20 61 75 74 68 6f 72 73 20 68 61 76 65 20 64 65 63 69 64 use.the.Emacs.authors.have.decid
86320 65 64 20 74 68 61 74 20 74 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20 61 6e 20 6f 70 74 2d 69 6e ed.that.this.should.be.an.opt-in
86340 0a 20 20 66 65 61 74 75 72 65 2e 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 68 61 ...feature.....Note.that.this.ha
86360 73 20 6e 6f 20 65 66 66 65 63 74 20 6f 6e 20 45 6d 61 63 73 20 72 65 6c 65 61 73 65 73 20 62 65 s.no.effect.on.Emacs.releases.be
86380 66 6f 72 65 20 32 38 2e 31 2e 0a 0a 2d 20 41 64 64 65 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f fore.28.1...-.Added.documentatio
863a0 6e 20 73 74 61 74 69 6e 67 20 74 68 61 74 20 7e 3a 63 6c 61 73 73 7e 20 68 61 73 20 74 6f 20 62 n.stating.that.~:class~.has.to.b
863c0 65 20 73 70 65 63 69 66 69 65 64 20 77 68 65 6e 0a 20 20 75 73 69 6e 67 20 7e 3a 73 65 74 75 70 e.specified.when...using.~:setup
863e0 2d 63 68 69 6c 64 72 65 6e 7e 2e 20 20 62 65 65 63 64 63 38 35 0a 0a 2d 20 41 64 64 65 64 20 61 -children~...beecdc85..-.Added.a
86400 20 6e 65 77 20 70 72 65 66 69 78 20 73 6c 6f 74 20 7e 63 6f 6c 75 6d 6e 2d 77 69 64 74 68 73 7e .new.prefix.slot.~column-widths~
86420 2c 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 0a 20 ,.which.can.be.used.to.specify..
86440 20 74 68 65 20 6d 69 6e 69 6d 61 6c 20 77 69 64 74 68 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d .the.minimal.width.of.each.colum
86460 6e 20 69 6e 20 61 6c 6c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 7e 20 67 72 6f n.in.all.~transient-columns~.gro
86480 75 70 73 20 6f 66 0a 20 20 74 68 61 74 20 70 72 65 66 69 78 2e 20 20 39 32 65 38 39 35 32 65 0a ups.of...that.prefix...92e8952e.
864a0 0a 2d 20 57 68 65 6e 20 61 73 73 69 67 6e 69 6e 67 20 61 20 6e 61 6d 65 20 74 6f 20 61 20 73 75 .-.When.assigning.a.name.to.a.su
864c0 66 66 69 78 20 74 68 61 74 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e 6c 69 6e 65 2c 20 77 65 20 ffix.that.is.defined.inline,.we.
864e0 6e 6f 0a 20 20 6c 6f 6e 67 65 72 20 75 73 65 20 74 68 65 20 73 75 66 66 69 78 20 64 65 73 63 72 no...longer.use.the.suffix.descr
86500 69 70 74 69 6f 6e 2c 20 69 66 66 20 74 68 61 74 20 77 6f 75 6c 64 20 72 65 73 75 6c 74 20 69 6e iption,.iff.that.would.result.in
86520 20 61 6e 0a 20 20 6f 76 65 72 6c 79 20 6c 6f 6e 67 20 6e 61 6d 65 2e 20 20 38 31 61 31 30 38 62 .an...overly.long.name...81a108b
86540 61 0a 0a 2d 20 46 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 61 73 20 74 68 65 20 76 61 6c 75 65 a..-.Functions.used.as.the.value
86560 20 6f 66 20 66 61 63 65 20 73 6c 6f 74 73 20 63 61 6e 20 6e 6f 77 20 74 61 6b 65 20 6f 6e 65 0a .of.face.slots.can.now.take.one.
86580 20 20 61 72 67 75 6d 65 6e 74 2c 20 74 68 65 20 73 75 66 66 69 78 20 6f 62 6a 65 63 74 2e 20 20 ..argument,.the.suffix.object...
865a0 46 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 74 61 6b 65 20 7a 65 72 6f 20 61 72 67 75 6d 65 6e Functions.that.take.zero.argumen
865c0 74 73 0a 20 20 61 72 65 20 73 74 69 6c 6c 20 73 75 70 70 6f 72 74 65 64 2e 20 20 41 64 64 69 74 ts...are.still.supported...Addit
865e0 69 6f 6e 61 6c 6c 79 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 73 75 66 ionally,.~transient--pending-suf
86600 66 69 78 7e 20 69 73 0a 20 20 62 6f 75 6e 64 20 61 72 6f 75 6e 64 20 63 61 6c 6c 73 20 74 6f 20 fix~.is...bound.around.calls.to.
86620 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20 62 75 74 20 69 74 20 69 73 20 62 65 74 74 65 these.functions,.but.it.is.bette
86640 72 20 74 6f 20 70 61 73 73 0a 20 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 20 61 6e 20 61 72 67 r.to.pass...the.object.as.an.arg
86660 75 6d 65 6e 74 2e 20 20 66 35 38 32 61 39 62 63 0a 0a 2d 20 54 68 65 20 6e 65 77 20 7e 64 65 66 ument...f582a9bc..-.The.new.~def
86680 69 6e 69 74 69 6f 6e 7e 20 73 75 66 66 69 78 20 73 6c 6f 74 20 63 61 6e 20 62 65 20 75 73 65 64 inition~.suffix.slot.can.be.used
866a0 20 74 6f 20 73 70 65 63 69 66 79 20 61 20 64 65 66 61 75 6c 74 0a 20 20 66 75 6e 63 74 69 6f 6e .to.specify.a.default...function
866c0 20 64 65 66 69 6e 69 74 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73 65 64 20 69 66 20 6e 6f 20 66 .definition.that.is.used.if.no.f
866e0 75 6e 63 74 69 6f 6e 20 62 6f 64 79 20 69 73 20 70 72 6f 76 69 64 65 64 0a 20 20 75 73 69 6e 67 unction.body.is.provided...using
86700 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 73 75 66 66 69 78 7e 2e 20 20 35 62 33 .~transient-define-suffix~...5b3
86720 33 34 61 35 31 0a 0a 2d 20 54 61 75 67 68 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 34a51..-.Taught.~transient-suffi
86740 78 2d 6f 62 6a 65 63 74 7e 20 61 62 6f 75 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 x-object~.about.~transient--pend
86760 69 6e 67 2d 73 75 66 66 69 78 7e 2e 0a 20 20 32 30 61 33 37 37 30 64 0a 0a 42 75 67 20 66 69 78 ing-suffix~....20a3770d..Bug.fix
86780 65 73 3a 0a 0a 2d 20 49 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 es:..-.If.~transient-parse-suffi
867a0 78 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 61 72 73 65 2d 73 75 66 66 69 78 65 73 x~.and.~transient-parse-suffixes
867c0 7e 20 61 72 65 20 63 61 6c 6c 65 64 0a 20 20 77 69 74 68 20 61 6e 20 69 6e 76 61 6c 69 64 20 76 ~.are.called...with.an.invalid.v
867e0 61 6c 75 65 20 66 6f 72 20 74 68 65 69 72 20 7e 70 72 65 66 69 78 7e 20 61 72 67 75 6d 65 6e 74 alue.for.their.~prefix~.argument
86800 2c 20 74 68 65 79 20 66 61 69 6c 65 64 20 74 6f 0a 20 20 64 65 74 65 63 74 20 74 68 61 74 2e 20 ,.they.failed.to...detect.that..
86820 20 30 33 65 37 35 32 64 39 0a 0a 2d 20 49 66 20 7e 6e 69 6c 7e 20 69 73 20 65 6e 63 6f 75 6e 74 .03e752d9..-.If.~nil~.is.encount
86840 65 72 65 64 20 69 6e 73 69 64 65 20 61 20 67 72 6f 75 70 20 73 70 65 63 69 66 69 63 61 74 69 6f ered.inside.a.group.specificatio
86860 6e 2c 20 74 68 61 74 20 77 61 73 0a 20 20 73 69 6c 65 6e 74 6c 79 20 69 67 6e 6f 72 65 64 2e 20 n,.that.was...silently.ignored..
86880 20 4e 6f 77 20 61 6e 20 65 72 72 6f 72 20 69 73 20 73 69 67 6e 61 6c 65 64 2e 20 20 38 63 30 31 .Now.an.error.is.signaled...8c01
868a0 61 31 65 62 0a 0a 2d 20 7e 66 69 6e 64 2d 66 75 6e 63 74 69 6f 6e 7e 20 77 61 73 6e 27 74 20 61 a1eb..-.~find-function~.wasn't.a
868c0 62 6c 65 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 6f 66 ble.to.locate.the.definitions.of
868e0 20 69 6e 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 79 6d 6f 72 65 2e 20 20 61 33 30 64 .infix...commands.anymore...a30d
86900 66 36 37 62 0a 0a 2d 20 54 68 65 72 65 20 77 61 73 20 6e 6f 20 62 69 6e 64 69 6e 67 20 66 6f 72 f67b..-.There.was.no.binding.for
86920 20 7e 69 67 6e 6f 72 65 2d 70 72 65 73 65 72 76 69 6e 67 2d 6b 69 6c 6c 2d 72 65 67 69 6f 6e 7e .~ignore-preserving-kill-region~
86940 20 69 6e 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d 6d 61 70 7e 2e .in...~transient-predicate-map~.
86960 20 20 30 66 63 38 37 30 30 32 0a 0a 2d 20 49 6e 76 6f 6b 69 6e 67 20 61 20 6e 6f 6e 2d 73 79 6d ..0fc87002..-.Invoking.a.non-sym
86980 62 6f 6c 69 63 20 6e 6f 6e 2d 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2c 20 63 61 75 73 65 64 bolic.non-suffix.command,.caused
869a0 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 62 64 32 61 35 65 61 30 0a 0a 2d 20 57 68 65 6e 20 61 20 .an.error....bd2a5ea0..-.When.a.
869c0 67 72 6f 75 70 20 62 65 67 69 6e 73 20 77 69 74 68 20 61 6e 20 69 6e 63 6c 75 64 65 64 20 73 75 group.begins.with.an.included.su
869e0 62 67 72 6f 75 70 2c 20 74 68 61 74 20 61 66 66 65 63 74 65 64 20 77 68 61 74 0a 20 20 67 72 6f bgroup,.that.affected.what...gro
86a00 75 70 20 63 6c 61 73 73 20 77 61 73 20 61 73 73 75 6d 65 64 2c 20 69 6e 20 74 68 65 20 61 62 73 up.class.was.assumed,.in.the.abs
86a20 65 6e 63 65 20 6f 66 20 61 6e 20 65 78 70 6c 69 63 69 74 20 73 70 65 63 69 66 69 63 61 74 69 6f ence.of.an.explicit.specificatio
86a40 6e 2e 0a 20 20 64 66 33 36 62 63 38 37 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 n....df36bc87..-.~transient--sus
86a60 70 65 6e 64 2d 6f 76 65 72 72 69 64 65 7e 20 66 61 69 6c 65 64 20 74 6f 20 6d 6f 76 65 20 6f 75 pend-override~.failed.to.move.ou
86a80 74 20 6f 66 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 0a 20 20 62 65 66 6f 72 65 20 72 65 66 t.of.the.minibuffer...before.ref
86aa0 72 65 73 68 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 20 20 38 reshing.the.transient.buffer...8
86ac0 33 33 31 34 33 62 61 0a 0a 2d 20 57 68 65 6e 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 33143ba..-.When.a.suffix.command
86ae0 20 73 69 67 6e 61 6c 65 64 20 61 6e 20 65 72 72 6f 72 20 64 75 72 69 6e 67 20 61 20 74 72 69 76 .signaled.an.error.during.a.triv
86b00 69 61 6c 20 70 68 61 73 65 0a 20 20 28 77 68 69 63 68 20 64 6f 65 73 20 6e 6f 74 20 69 6e 76 6f ial.phase...(which.does.not.invo
86b20 6c 76 65 2c 20 65 2e 67 2e 2c 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 29 2c 20 74 68 65 6e lve,.e.g.,.the.minibuffer),.then
86b40 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 77 69 6e 64 6f 77 20 77 61 73 20 6e 6f 74 20 .the.transient...window.was.not.
86b60 64 65 6c 65 74 65 64 20 77 68 65 6e 20 74 68 65 20 64 65 62 75 67 67 65 72 20 77 61 73 20 65 6e deleted.when.the.debugger.was.en
86b80 74 65 72 65 64 2e 20 20 39 64 38 66 33 36 31 66 0a 0a 2d 20 57 68 65 6e 20 61 20 70 72 65 66 69 tered...9d8f361f..-.When.a.prefi
86ba0 78 20 77 61 73 20 72 65 66 72 65 73 68 65 64 2c 20 74 68 65 20 77 72 6f 6e 67 20 63 6f 6c 6f 72 x.was.refreshed,.the.wrong.color
86bc0 20 77 61 73 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 .was.used.for.suffix...commands.
86be0 74 68 61 74 20 65 78 69 74 20 74 68 65 20 70 72 65 66 69 78 2c 20 69 6e 64 69 63 61 74 69 6e 67 that.exit.the.prefix,.indicating
86c00 20 74 68 61 74 20 77 6f 75 6c 64 20 63 61 75 73 65 20 61 20 72 65 74 75 72 6e 0a 20 20 74 6f 20 .that.would.cause.a.return...to.
86c20 74 68 65 20 6f 75 74 65 72 20 70 72 65 66 69 78 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 20 74 68 the.outer.prefix,.even.though.th
86c40 65 72 65 20 69 73 20 6e 6f 6e 65 2e 20 20 66 35 31 63 31 34 34 61 0a 0a 2d 20 43 61 6c 6c 69 6e ere.is.none...f51c144a..-.Callin
86c60 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 7e 20 77 69 74 68 20 61 6e g.~transient-infix-read~.with.an
86c80 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 2c 20 72 65 73 75 6c 74 65 64 20 69 6e 0a 20 20 61 20 .invalid.value,.resulted.in...a.
86ca0 63 6f 6e 66 75 73 69 6e 67 20 65 72 72 6f 72 2e 20 20 4e 6f 77 20 61 6e 20 61 70 70 72 6f 70 72 confusing.error...Now.an.appropr
86cc0 69 61 74 65 20 65 72 72 6f 72 20 69 73 20 75 73 65 64 2e 20 20 33 65 62 62 36 61 63 66 0a 0a 2d iate.error.is.used...3ebb6acf..-
86ce0 20 57 68 65 6e 20 74 68 69 72 64 2d 70 61 72 74 79 20 63 6f 64 65 20 6f 72 20 75 73 65 72 20 63 .When.third-party.code.or.user.c
86d00 75 73 74 6f 6d 69 7a 61 74 69 6f 6e 20 6d 61 6e 61 67 65 64 20 74 6f 20 64 69 73 70 6c 61 79 0a ustomization.managed.to.display.
86d20 20 20 61 6e 6f 74 68 65 72 20 62 75 66 66 65 72 20 69 6e 20 6f 75 72 20 64 65 64 69 63 61 74 65 ..another.buffer.in.our.dedicate
86d40 64 20 77 69 6e 64 6f 77 2c 20 74 68 65 6e 20 74 68 61 74 20 62 75 66 66 65 72 20 67 6f 74 0a 20 d.window,.then.that.buffer.got..
86d60 20 6b 69 6c 6c 65 64 20 77 68 65 6e 20 77 65 20 74 72 69 65 64 20 74 6f 20 6b 69 6c 6c 20 74 68 .killed.when.we.tried.to.kill.th
86d80 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 2e 20 20 23 32 37 31 0a 0a 2a 20 76 30 2e e.transient.buffer...#271..*.v0.
86da0 35 2e 33 20 20 20 20 32 30 32 33 2d 31 32 2d 31 36 0a 0a 2d 20 46 69 78 65 64 20 72 65 67 72 65 5.3....2023-12-16..-.Fixed.regre
86dc0 73 73 69 6f 6e 20 77 68 65 6e 20 73 65 74 74 69 6e 67 20 7e 3a 70 61 64 2d 6b 65 79 73 7e 20 66 ssion.when.setting.~:pad-keys~.f
86de0 6f 72 20 61 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 6f 6c 75 6d 6e 73 7e 0a 20 20 67 72 6f 75 70 or.a.~transient-columns~...group
86e00 2e 20 20 23 32 36 39 0a 0a 2a 20 76 30 2e 35 2e 32 20 20 20 20 32 30 32 33 2d 31 32 2d 30 35 0a ...#269..*.v0.5.2....2023-12-05.
86e20 0a 2d 20 46 69 78 65 64 20 66 6f 72 6d 61 74 74 69 6e 67 20 69 73 73 75 65 73 20 69 6e 20 74 68 .-.Fixed.formatting.issues.in.th
86e40 65 20 6d 61 6e 75 61 6c 2e 0a 0a 2a 20 76 30 2e 35 2e 31 20 20 20 20 32 30 32 33 2d 31 32 2d 30 e.manual...*.v0.5.1....2023-12-0
86e60 35 0a 0a 2d 20 41 64 64 65 64 20 61 20 6e 65 77 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 62 79 5..-.Added.a.new.introduction.by
86e80 20 4a 44 20 53 6d 69 74 68 20 28 40 6a 64 74 73 6d 69 74 68 29 2e 0a 0a 42 75 67 20 66 69 78 65 .JD.Smith.(@jdtsmith)...Bug.fixe
86ea0 73 3a 0a 0a 2d 20 46 61 63 65 73 20 74 68 61 74 20 75 73 65 20 61 20 62 6f 78 20 61 72 65 20 6e s:..-.Faces.that.use.a.box.are.n
86ec0 6f 77 20 64 65 66 69 6e 65 64 20 6d 6f 72 65 20 64 65 66 65 6e 73 69 76 65 6c 79 20 74 6f 20 70 ow.defined.more.defensively.to.p
86ee0 72 6f 74 65 63 74 0a 20 20 61 67 61 69 6e 73 74 20 75 6e 65 78 70 65 63 74 65 64 20 76 61 6c 75 rotect...against.unexpected.valu
86f00 65 73 20 61 6e 64 20 70 72 6f 76 69 64 65 20 72 65 61 73 6f 6e 61 62 6c 65 20 66 61 6c 6c 62 61 es.and.provide.reasonable.fallba
86f20 63 6b 20 63 6f 6c 6f 72 73 2e 0a 20 20 34 31 33 33 31 30 63 64 2c 20 62 38 61 65 66 63 65 33 0a ck.colors....413310cd,.b8aefce3.
86f40 0a 2d 20 4f 6e 6c 79 20 70 72 65 70 61 72 65 20 74 6f 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 .-.Only.prepare.to.return.to.the
86f60 20 70 61 72 65 6e 74 20 74 72 61 6e 73 69 65 6e 74 20 69 66 20 74 68 65 72 65 20 61 63 74 75 61 .parent.transient.if.there.actua
86f80 6c 6c 79 20 69 73 0a 20 20 61 20 70 61 72 65 6e 74 2e 20 20 54 68 65 20 6f 6e 6c 79 20 6e 65 67 lly.is...a.parent...The.only.neg
86fa0 61 74 69 76 65 20 65 66 66 65 63 74 20 6f 66 20 66 61 69 6c 69 6e 67 20 74 6f 20 64 6f 20 74 68 ative.effect.of.failing.to.do.th
86fc0 69 73 20 77 61 73 20 74 68 61 74 0a 20 20 74 68 65 20 73 75 66 66 69 78 20 77 61 73 20 63 6f 6c is.was.that...the.suffix.was.col
86fe0 6f 72 65 64 20 77 72 6f 6e 67 2c 20 73 69 6e 63 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f ored.wrong,.since.~transient--do
87000 2d 72 65 74 75 72 6e 7e 20 66 61 6c 6c 73 20 62 61 63 6b 0a 20 20 74 6f 20 62 65 68 61 76 65 20 -return~.falls.back...to.behave.
87020 6c 69 6b 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 7e 2e 20 20 35 66 32 63 like.~transient--do-exit~...5f2c
87040 66 63 39 66 0a 0a 2a 20 76 30 2e 35 2e 30 20 20 20 20 32 30 32 33 2d 31 31 2d 32 38 0a 0a 2d 20 fc9f..*.v0.5.0....2023-11-28..-.
87060 53 6f 6d 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 65 78 69 74 20 74 68 65 20 74 72 Some.suffix.commands.exit.the.tr
87080 61 6e 73 69 65 6e 74 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 79 20 77 65 72 65 0a 20 20 69 ansient.from.which.they.were...i
870a0 6e 76 6f 6b 65 64 2c 20 77 68 69 6c 65 20 6f 74 68 65 72 73 20 64 6f 6e 27 74 20 28 61 6c 6c 6f nvoked,.while.others.don't.(allo
870c0 77 69 6e 67 20 74 68 65 20 75 73 65 72 20 74 6f 20 69 6e 76 6f 6b 65 20 61 6e 6f 74 68 65 72 0a wing.the.user.to.invoke.another.
870e0 20 20 73 75 66 66 69 78 20 77 69 74 68 6f 75 74 20 66 69 72 73 74 20 68 61 76 69 6e 67 20 74 6f ..suffix.without.first.having.to
87100 20 65 6e 74 65 72 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 61 67 61 69 6e 29 2e 0a 0a 20 20 .enter.the.transient.again).....
87120 55 6e 74 69 6c 20 6e 6f 77 20 69 74 20 77 61 73 6e 27 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 Until.now.it.wasn't.possible.to.
87140 74 65 6c 6c 20 77 68 69 63 68 20 63 61 74 65 67 6f 72 79 20 61 6e 79 20 67 69 76 65 6e 20 73 75 tell.which.category.any.given.su
87160 66 66 69 78 0a 20 20 66 61 6c 6c 73 20 69 6e 74 6f 2c 20 61 74 20 6c 65 61 73 74 20 6e 6f 74 20 ffix...falls.into,.at.least.not.
87180 62 79 20 64 65 66 61 75 6c 74 2e 20 20 4e 6f 77 20 74 68 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 by.default...Now.the.key.binding
871a0 20 6f 66 20 65 61 63 68 0a 20 20 73 75 66 66 69 78 20 69 73 20 63 6f 6c 6f 72 69 7a 65 64 20 74 .of.each...suffix.is.colorized.t
871c0 6f 20 69 6e 64 69 63 61 74 65 20 69 74 73 20 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f o.indicate.its.transient.behavio
871e0 72 2e 20 20 52 65 64 20 6d 65 61 6e 73 0a 20 20 74 68 61 74 20 74 68 65 20 73 75 66 66 69 78 20 r...Red.means...that.the.suffix.
87200 65 78 69 74 73 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2c 20 61 6e 64 20 62 6c 75 65 20 6d 65 exits.the.transient,.and.blue.me
87220 61 6e 73 20 74 68 61 74 20 69 74 20 64 6f 65 73 0a 20 20 6e 6f 74 2e 20 20 4b 65 79 73 20 66 6f ans.that.it.does...not...Keys.fo
87240 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 63 75 72 72 65 6e 74 6c 79 20 63 61 6e 6e 6f 74 r.suffixes.that.currently.cannot
87260 20 62 65 20 69 6e 76 6f 6b 65 64 20 61 72 65 20 67 72 61 79 2e 0a 0a 20 20 4c 69 6b 65 77 69 73 .be.invoked.are.gray.....Likewis
87280 65 2c 20 74 68 65 20 74 68 69 6e 20 6c 69 6e 65 2c 20 74 68 61 74 20 69 73 20 64 72 61 77 6e 20 e,.the.thin.line,.that.is.drawn.
872a0 62 65 74 77 65 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 6f 70 75 70 0a 20 20 62 75 between.the.transient.popup...bu
872c0 66 66 65 72 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 2c 20 69 73 20 75 73 65 64 ffer.and.the.minibuffer,.is.used
872e0 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 68 61 74 20 68 61 70 70 65 6e 73 2c 20 69 66 20 79 6f .to.indicate.what.happens,.if.yo
87300 75 0a 20 20 69 6e 76 6f 6b 65 20 61 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 20 6e 6f 74 u...invoke.a.command.that.is.not
87320 20 61 20 73 75 66 66 69 78 2e 20 20 4d 6f 73 74 20 70 72 65 66 69 78 65 73 20 64 6f 20 6e 6f 74 .a.suffix...Most.prefixes.do.not
87340 20 61 6c 6c 6f 77 0a 20 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 20 74 6f 20 62 65 20 69 6e 76 6f .allow...non-suffixes.to.be.invo
87360 6b 65 64 2c 20 73 6f 20 74 68 69 73 20 6c 69 6e 65 20 75 73 75 61 6c 6c 79 20 69 73 20 67 72 61 ked,.so.this.line.usually.is.gra
87380 79 2e 20 20 63 38 61 39 61 63 35 31 0a 0a 2d 20 4d 61 6e 79 20 66 61 63 65 73 20 68 61 76 65 20 y...c8a9ac51..-.Many.faces.have.
873a0 61 6c 73 6f 20 62 65 65 6e 20 69 6d 70 72 6f 76 65 64 2e 20 20 54 68 69 73 20 69 6e 76 6f 6c 76 also.been.improved...This.involv
873c0 65 73 20 63 68 61 6e 67 69 6e 67 20 77 68 69 63 68 0a 20 20 62 75 69 6c 74 2d 69 6e 20 66 61 63 es.changing.which...built-in.fac
873e0 65 73 20 74 68 65 79 20 69 6e 68 65 72 69 74 20 66 72 6f 6d 2c 20 73 6f 6d 65 20 65 78 70 6c 69 es.they.inherit.from,.some.expli
87400 63 69 74 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 69 72 0a 20 20 61 70 70 65 61 72 61 6e 63 cit.changes.to.their...appearanc
87420 65 2c 20 61 6e 64 20 73 65 6d 61 6e 74 69 63 20 63 6c 61 72 69 66 69 63 61 74 69 6f 6e 73 2e 20 e,.and.semantic.clarifications..
87440 20 4f 66 20 63 6f 75 72 73 65 20 79 6f 75 72 20 6d 69 6c 65 61 67 65 20 6d 61 79 0a 20 20 76 61 .Of.course.your.mileage.may...va
87460 72 79 20 e2 80 94 20 69 74 27 73 20 70 6f 73 73 69 62 6c 65 20 74 68 61 74 20 73 6f 6d 65 20 66 ry.....it's.possible.that.some.f
87480 61 63 65 20 6a 75 73 74 20 68 61 70 70 65 6e 65 64 20 74 6f 20 6c 6f 6f 6b 20 72 69 67 68 74 20 ace.just.happened.to.look.right.
874a0 77 69 74 68 0a 20 20 79 6f 75 72 20 63 68 6f 73 65 6e 20 74 68 65 6d 65 2c 20 62 75 74 20 6e 6f with...your.chosen.theme,.but.no
874c0 77 20 69 74 20 68 61 73 20 74 6f 20 62 65 20 74 68 65 6d 65 64 20 74 6f 20 61 63 68 69 65 76 65 w.it.has.to.be.themed.to.achieve
874e0 20 74 68 61 74 0a 20 20 61 67 61 69 6e 2e 20 20 34 37 64 33 66 30 31 64 20 37 31 64 31 36 64 38 .that...again...47d3f01d.71d16d8
87500 36 20 65 74 20 61 6c 2e 0a 0a 2d 20 41 64 64 65 64 20 61 20 6e 65 77 20 66 61 63 65 2c 20 7e 74 6.et.al...-.Added.a.new.face,.~t
87520 72 61 6e 73 69 65 6e 74 2d 64 65 6c 69 6d 69 74 65 72 7e 2c 20 77 68 69 63 68 20 69 73 20 75 73 ransient-delimiter~,.which.is.us
87540 65 64 20 66 6f 72 20 70 61 72 65 6e 74 68 65 73 65 73 0a 20 20 61 72 6f 75 6e 64 20 76 61 6c 75 ed.for.parentheses...around.valu
87560 65 73 20 61 6e 64 20 74 68 65 20 70 69 70 65 20 63 68 61 72 61 63 74 65 72 20 75 73 65 64 20 74 es.and.the.pipe.character.used.t
87580 6f 20 73 65 70 61 72 61 74 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 0a 20 20 66 72 6f o.separate.possible.values...fro
875a0 6d 20 65 61 63 68 20 6f 74 68 65 72 2e 20 20 35 36 37 62 35 64 35 34 0a 0a 2d 20 41 64 64 65 64 m.each.other...567b5d54..-.Added
875c0 20 61 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 .a.new.command.~transient-toggle
875e0 2d 6c 65 76 65 6c 2d 6c 69 6d 69 74 7e 2c 20 62 6f 75 6e 64 20 74 6f 20 7e 43 2d 78 20 61 7e 2c -level-limit~,.bound.to.~C-x.a~,
87600 0a 20 20 77 68 69 63 68 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 73 68 6f 77 73 20 61 6c 6c 20 73 ...which.temporarily.shows.all.s
87620 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 20 74 72 61 6e 73 69 65 6e 74 20 68 61 73 20 74 uffix.commands.a.transient.has.t
87640 6f 0a 20 20 6f 66 66 65 72 2e 20 20 54 68 69 73 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 o...offer...This.makes.it.possib
87660 6c 65 20 74 6f 20 6f 63 63 61 73 69 6f 6e 61 6c 6c 79 20 75 73 65 20 6d 6f 72 65 20 6f 62 73 63 le.to.occasionally.use.more.obsc
87680 75 72 65 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 73 2c 20 77 69 ure...commands.and.arguments,.wi
876a0 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 61 6c 77 61 79 73 20 64 69 73 70 6c 61 79 20 74 thout.having.to.always.display.t
876c0 68 65 6d 2e 0a 20 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 hem....For.more.information.see.
876e0 5b 5b 68 74 74 70 73 3a 2f 2f 6d 61 67 69 74 2e 76 63 2f 6d 61 6e 75 61 6c 2f 74 72 61 6e 73 69 [[https://magit.vc/manual/transi
87700 65 6e 74 2f 45 6e 61 62 6c 69 6e 67 2d 61 6e 64 2d 44 69 73 61 62 6c 69 6e 67 2d 53 75 66 66 69 ent/Enabling-and-Disabling-Suffi
87720 78 65 73 2e 68 74 6d 6c 5d 5b 45 6e 61 62 6c 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 xes.html][Enabling.and.Disabling
87740 20 53 75 66 66 69 78 65 73 5d 5d 2e 20 20 23 32 34 33 0a 0a 54 68 65 20 63 68 61 6e 67 65 73 20 .Suffixes]]...#243..The.changes.
87760 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2c 20 6f 6e 6c 79 20 64 69 72 65 63 74 6c 79 20 61 described.below,.only.directly.a
87780 66 66 65 63 74 20 70 61 63 6b 61 67 65 20 61 75 74 68 6f 72 73 20 61 6e 64 0a 75 73 65 72 73 20 ffect.package.authors.and.users.
877a0 77 68 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 69 72 20 6f 77 6e 20 74 72 61 6e 73 69 65 6e who.implement.their.own.transien
877c0 74 73 2e 20 20 49 66 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 64 65 73 63 72 69 62 65 0a 79 ts...If.that.does.not.describe.y
877e0 6f 75 2c 20 74 68 65 6e 20 61 6c 6c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 6b 6e 6f 77 20 69 73 ou,.then.all.you.have.to.know.is
87800 20 74 68 61 74 20 6d 61 6e 79 20 66 65 61 74 75 72 65 73 20 77 65 72 65 20 66 69 6e 65 2d 74 75 .that.many.features.were.fine-tu
87820 6e 65 64 0a 61 6e 64 20 6f 74 68 65 72 77 69 73 65 20 69 6d 70 72 6f 76 65 64 2c 20 6f 70 65 6e ned.and.otherwise.improved,.open
87840 69 6e 67 20 75 70 20 73 6f 6d 65 20 6e 65 77 20 75 73 65 2d 63 61 73 65 73 20 61 6e 64 20 6d 61 ing.up.some.new.use-cases.and.ma
87860 6b 69 6e 67 20 73 6f 6d 65 0a 74 68 69 6e 67 73 20 65 61 73 69 65 72 20 74 6f 20 69 6d 70 6c 65 king.some.things.easier.to.imple
87880 6d 65 6e 74 2e 20 20 54 68 69 73 20 77 69 6c 6c 20 68 6f 70 65 66 75 6c 6c 79 20 6c 65 61 64 20 ment...This.will.hopefully.lead.
878a0 74 6f 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 0a 69 6e 20 79 6f 75 72 20 66 61 76 6f 72 69 74 65 to.improvements.in.your.favorite
878c0 20 74 72 61 6e 73 69 65 6e 74 2d 75 73 69 6e 67 20 70 61 63 6b 61 67 65 73 20 69 6e 20 74 68 65 .transient-using.packages.in.the
878e0 20 63 6f 6d 69 6e 67 20 6d 6f 6e 74 68 73 2e 0a 0a 2d 20 49 74 20 73 6f 6d 65 74 69 6d 65 73 20 .coming.months...-.It.sometimes.
87900 6d 61 6b 65 73 20 73 65 6e 73 65 20 74 6f 20 62 69 6e 64 20 6d 75 6c 74 69 70 6c 65 20 6b 65 79 makes.sense.to.bind.multiple.key
87920 73 20 74 6f 20 74 68 65 20 73 61 6d 65 20 73 75 66 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 2c 20 s.to.the.same.suffix...command,.
87940 65 2e 67 2e 2c 20 62 65 63 61 75 73 65 20 74 68 65 79 20 62 65 68 61 76 65 20 64 69 66 66 65 72 e.g.,.because.they.behave.differ
87960 65 6e 74 6c 79 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 73 75 66 66 69 78 0a 20 20 64 65 73 63 ently.based.on.the.suffix...desc
87980 72 69 70 74 69 6f 6e 2c 20 6f 72 20 73 6f 6d 65 20 6f 74 68 65 72 20 73 6c 6f 74 20 74 68 61 74 ription,.or.some.other.slot.that
879a0 20 63 61 6e 20 62 65 20 73 65 74 20 70 65 72 20 62 69 6e 64 69 6e 67 2e 0a 20 20 50 72 65 76 69 .can.be.set.per.binding....Previ
879c0 6f 75 73 6c 79 20 74 68 65 73 65 20 62 69 6e 64 69 6e 67 73 20 73 68 61 72 65 64 20 61 20 76 69 ously.these.bindings.shared.a.vi
879e0 73 69 62 69 6c 69 74 79 20 6c 65 76 65 6c 3b 20 68 6f 77 20 74 68 69 73 20 63 61 6e 0a 20 20 62 sibility.level;.how.this.can...b
87a00 65 20 73 65 74 20 69 6e 64 69 76 69 64 75 61 6c 6c 79 2e 20 20 23 31 35 33 0a 0a 2d 20 57 68 69 e.set.individually...#153..-.Whi
87a20 6c 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 72 75 6e 2c 20 77 68 69 63 68 20 66 6f 72 6d le.functions.are.run,.which.form
87a40 61 74 20 73 74 72 69 6e 67 73 20 74 6f 20 62 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 74 at.strings.to.be.inserted.into.t
87a60 68 65 0a 20 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 20 6f 72 20 74 6f 20 64 65 74 65 he...transient.buffer.or.to.dete
87a80 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f 74 68 65 72 20 61 73 70 65 63 74 73 20 6f 66 20 61 rmine.whether.other.aspects.of.a
87aa0 20 73 75 66 66 69 78 2c 0a 20 20 74 68 61 74 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 .suffix,...that.transient.buffer
87ac0 20 6e 6f 20 6c 6f 6e 67 65 72 20 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 .no.longer.is.the.current.buffer
87ae0 2e 20 20 49 6e 73 74 65 61 64 20 74 68 65 0a 20 20 62 75 66 66 65 72 20 69 6e 20 77 68 69 63 68 ...Instead.the...buffer.in.which
87b00 20 74 68 65 20 70 72 65 66 69 78 20 61 6e 64 20 69 74 73 20 73 75 66 66 69 78 65 73 20 6f 70 65 .the.prefix.and.its.suffixes.ope
87b20 72 61 74 65 2c 20 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 62 75 66 66 65 72 2e 20 20 rate,.is.the.current...buffer...
87b40 54 68 69 73 20 61 66 66 65 63 74 73 20 66 75 6e 63 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 7e This.affects.functions.such.as.~
87b60 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 7e 0a 20 20 transient-format-description~...
87b80 61 6e 64 20 74 68 6f 73 65 20 66 6f 75 6e 64 20 69 6e 20 70 72 65 64 69 63 61 74 65 20 73 6c 6f and.those.found.in.predicate.slo
87ba0 74 73 20 73 75 63 68 20 61 73 20 7e 69 66 7e 2e 20 20 49 6e 20 63 6f 6e 74 65 78 74 73 20 77 68 ts.such.as.~if~...In.contexts.wh
87bc0 65 72 65 0a 20 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 72 20 69 73 20 6e 65 ere...the.transient.buffer.is.ne
87be0 65 64 65 64 20 62 75 74 20 74 68 65 20 6f 74 68 65 72 20 62 75 66 66 65 72 20 68 61 70 70 65 6e eded.but.the.other.buffer.happen
87c00 73 20 74 6f 20 62 65 0a 20 20 63 75 72 72 65 6e 74 2c 20 74 68 65 20 6e 65 77 20 6d 61 63 72 6f s.to.be...current,.the.new.macro
87c20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 77 69 74 68 2d 73 68 61 64 6f 77 65 64 2d 62 75 66 66 65 72 .~transient-with-shadowed-buffer
87c40 7e 20 63 61 6e 20 62 65 20 75 73 65 64 0a 20 20 74 6f 20 74 65 6d 70 6f 72 61 72 69 6c 79 20 63 ~.can.be.used...to.temporarily.c
87c60 68 61 6e 67 65 20 74 68 61 74 2e 0a 0a 2d 20 54 68 65 20 6e 65 77 20 73 75 66 66 69 78 20 73 6c hange.that...-.The.new.suffix.sl
87c80 6f 74 73 20 7e 66 61 63 65 7e 20 61 6e 64 20 7e 69 6e 61 70 74 2d 66 61 63 65 7e 20 63 61 6e 20 ots.~face~.and.~inapt-face~.can.
87ca0 62 65 20 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 68 6f 77 0a 20 20 61 20 73 75 66 66 69 be.used.to.specify.how...a.suffi
87cc0 78 20 6c 6f 6f 6b 73 2c 20 77 68 69 63 68 20 69 6e 20 73 69 6d 70 6c 65 20 63 61 73 65 73 20 69 x.looks,.which.in.simple.cases.i
87ce0 73 20 6d 6f 72 65 20 63 6f 6e 76 65 6e 69 65 6e 74 20 74 68 61 6e 20 75 73 69 6e 67 0a 20 20 61 s.more.convenient.than.using...a
87d00 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 7e 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 61 6e 64 20 61 .function.as.~description~.and.a
87d20 64 64 69 6e 67 20 74 68 65 20 66 61 63 65 20 74 68 65 72 65 2e 20 20 54 68 65 20 76 61 6c 75 65 dding.the.face.there...The.value
87d40 73 20 6f 66 0a 20 20 74 68 65 73 65 20 73 6c 6f 74 73 20 73 68 6f 75 6c 64 20 62 65 20 66 61 63 s.of...these.slots.should.be.fac
87d60 65 73 20 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 61 20 66 es.or.functions.that.returns.a.f
87d80 61 63 65 2e 20 20 54 68 65 0a 20 20 64 65 66 61 75 6c 74 20 66 6f 72 20 7e 69 6e 61 70 74 2d 66 ace...The...default.for.~inapt-f
87da0 61 63 65 7e 20 69 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 61 70 74 2d 73 75 66 66 69 78 7e ace~.is.~transient-inapt-suffix~
87dc0 2c 20 62 75 74 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 0a 20 20 69 74 20 69 73 20 75 6e 64 65 ,.but.in.some.cases...it.is.unde
87de0 73 69 72 61 62 6c 65 20 74 6f 20 61 70 70 6c 79 20 74 68 69 73 20 66 61 63 65 20 74 6f 20 74 68 sirable.to.apply.this.face.to.th
87e00 65 20 77 68 6f 6c 65 20 64 65 73 63 72 69 70 74 69 6f 6e 2c 20 73 6f 0a 20 20 74 68 69 73 20 63 e.whole.description,.so...this.c
87e20 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 69 73 an.be.overridden.by.setting.this
87e40 20 73 6c 6f 74 20 74 6f 20 7e 6e 69 6c 7e 20 66 6f 72 20 69 6e 64 69 76 69 64 75 61 6c 0a 20 20 .slot.to.~nil~.for.individual...
87e60 73 75 66 66 69 78 65 73 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 7e 66 61 63 65 suffixes...The.default.for.~face
87e80 7e 20 69 73 20 7e 6e 69 6c 7e 2e 20 20 63 32 61 37 35 38 38 30 20 38 65 31 35 61 32 39 62 20 37 ~.is.~nil~...c2a75880.8e15a29b.7
87ea0 31 33 39 39 64 32 31 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 76 61 72 69 61 62 6c 65 73 20 7e 1399d21..-.Added.new.variables.~
87ec0 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 73 75 66 66 69 78 7e 20 61 6e 64 0a 20 transient--pending-suffix~.and..
87ee0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 65 6e 64 69 6e 67 2d 67 72 6f 75 70 7e 2c 20 77 68 69 .~transient--pending-group~,.whi
87f00 63 68 20 61 72 65 20 62 6f 75 6e 64 20 77 68 69 6c 65 20 61 20 73 75 66 66 69 78 2f 67 72 6f 75 ch.are.bound.while.a.suffix/grou
87f20 70 20 69 73 0a 20 20 62 65 69 6e 67 20 69 6e 73 65 72 74 65 64 2e 20 20 54 68 65 73 65 20 61 72 p.is...being.inserted...These.ar
87f40 65 20 6d 6f 73 74 6c 79 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20 70 e.mostly.intended.for.internal.p
87f60 75 72 70 6f 73 65 73 2c 0a 20 20 62 75 74 20 69 6e 20 73 6f 6d 65 20 72 61 72 65 20 63 6f 6d 70 urposes,...but.in.some.rare.comp
87f80 6c 65 78 20 63 61 73 65 73 20 70 61 63 6b 61 67 65 20 61 75 74 68 6f 72 73 20 6d 69 67 68 74 20 lex.cases.package.authors.might.
87fa0 6e 65 65 64 20 74 68 65 6d 20 74 6f 6f 2e 0a 20 20 30 37 31 37 35 38 39 61 20 37 30 65 38 64 63 need.them.too....0717589a.70e8dc
87fc0 38 30 0a 0a 2d 20 53 6f 6d 65 74 69 6d 65 73 20 69 74 20 69 73 20 75 73 65 66 75 6c 20 74 6f 20 80..-.Sometimes.it.is.useful.to.
87fe0 64 69 73 70 6c 61 79 20 73 6f 6d 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 display.some.information.in.the.
88000 74 72 61 6e 73 69 65 6e 74 0a 20 20 62 75 66 66 65 72 2c 20 77 68 69 63 68 20 69 73 20 6e 6f 74 transient...buffer,.which.is.not
88020 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e .associated.with.a.suffix.comman
88040 64 2e 20 20 54 68 65 20 6e 65 77 0a 20 20 63 6c 61 73 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 d...The.new...class.~transient-i
88060 6e 66 6f 72 6d 61 74 69 6f 6e 7e 20 63 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 74 68 61 74 nformation~.can.be.used.for.that
88080 20 70 75 72 70 6f 73 65 2e 20 20 43 68 69 6c 64 72 65 6e 0a 20 20 74 68 61 74 20 75 73 65 20 74 .purpose...Children...that.use.t
880a0 68 69 73 20 63 6c 61 73 73 20 61 72 65 20 76 65 72 79 20 73 69 6d 69 6c 61 72 20 74 6f 20 72 65 his.class.are.very.similar.to.re
880c0 67 75 6c 61 72 20 73 75 66 66 69 78 65 73 2c 20 74 68 65 20 6c 61 63 6b 0a 20 20 6f 66 20 61 20 gular.suffixes,.the.lack...of.a.
880e0 63 6f 6d 6d 61 6e 64 20 62 69 6e 64 69 6e 67 20 62 65 69 6e 67 20 6e 65 61 72 6c 79 20 74 68 65 command.binding.being.nearly.the
88100 20 6f 6e 6c 79 20 64 69 66 66 65 72 65 6e 63 65 2e 20 20 23 32 32 36 0a 0a 2d 20 49 6e 73 74 65 .only.difference...#226..-.Inste
88120 61 64 20 6f 66 20 61 20 6c 69 73 74 20 6f 66 20 63 68 6f 69 63 65 73 2c 20 74 68 65 20 76 61 6c ad.of.a.list.of.choices,.the.val
88140 75 65 20 6f 66 20 61 20 73 75 66 66 69 78 27 73 20 7e 63 68 6f 69 63 65 73 7e 20 73 6c 6f 74 0a ue.of.a.suffix's.~choices~.slot.
88160 20 20 63 61 6e 20 6e 6f 77 20 62 65 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 72 65 74 ..can.now.be.a.function.that.ret
88180 75 72 6e 73 20 73 75 63 68 20 61 20 6c 69 73 74 2e 20 20 23 32 31 32 0a 0a 2d 20 50 65 72 2d 73 urns.such.a.list...#212..-.Per-s
881a0 75 66 66 69 78 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 66 6f 72 6d 61 74 20 69 74 73 20 uffix.functions.that.format.its.
881c0 64 65 73 63 72 69 70 74 69 6f 6e 20 28 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 description.(specified.using.the
881e0 0a 20 20 7e 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 73 6c 6f 74 29 20 63 61 6e 20 6e 6f 77 20 6f ...~description~.slot).can.now.o
88200 70 74 69 6f 6e 61 6c 6c 79 20 74 61 6b 65 20 6f 6e 65 20 69 6e 73 74 65 61 64 20 6f 66 20 7a 65 ptionally.take.one.instead.of.ze
88220 72 6f 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 74 68 65 20 72 65 73 70 65 63 74 69 76 65 20 73 75 ro.argument,...the.respective.su
88240 66 66 69 78 20 6f 62 6a 65 63 74 2e 20 20 30 39 62 65 33 36 37 62 0a 0a 2d 20 41 64 64 65 64 20 ffix.object...09be367b..-.Added.
88260 61 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 65 63 68 6f 2d 61 72 a.new.command.~transient-echo-ar
88280 67 75 6d 65 6e 74 73 7e 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20 69 6e 0a 20 20 65 guments~.intended.for.use.in...e
882a0 78 61 6d 70 6c 65 73 20 61 6e 64 20 62 75 67 20 72 65 70 6f 72 74 73 2c 20 77 68 65 6e 20 61 20 xamples.and.bug.reports,.when.a.
882c0 70 72 65 66 69 78 20 6d 75 73 74 20 62 69 6e 64 20 73 6f 6d 65 20 63 6f 6d 6d 61 6e 64 2c 20 62 prefix.must.bind.some.command,.b
882e0 75 74 20 69 74 0a 20 20 64 6f 65 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 6d 61 74 74 65 72 20 77 ut.it...does.not.really.matter.w
88300 68 69 63 68 2e 20 20 55 73 69 6e 67 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6c 65 73 hich...Using.this.command.is.les
88320 73 20 76 65 72 62 6f 73 65 20 74 68 61 6e 0a 20 20 68 61 76 69 6e 67 20 74 6f 20 69 6d 70 6c 65 s.verbose.than...having.to.imple
88340 6d 65 6e 74 20 61 20 64 75 6d 6d 79 20 65 76 65 72 79 20 74 69 6d 65 2c 20 61 6e 64 20 69 74 20 ment.a.dummy.every.time,.and.it.
88360 63 6f 6d 65 73 20 77 69 74 68 20 73 6f 6d 65 20 67 6f 6f 64 69 65 73 2e 0a 20 20 49 2e 65 2e 2c comes.with.some.goodies....I.e.,
88380 20 69 74 20 72 65 70 6f 72 74 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 .it.reports.information.about.th
883a0 65 20 70 72 65 66 69 78 20 66 72 6f 6d 20 77 68 69 63 68 20 69 74 20 77 61 73 20 69 6e 76 6f 6b e.prefix.from.which.it.was.invok
883c0 65 64 2e 0a 20 20 66 61 61 33 64 30 39 64 0a 0a 2d 20 57 68 65 6e 20 61 20 63 6f 6d 6d 61 6e 64 ed....faa3d09d..-.When.a.command
883e0 20 77 61 73 20 64 65 66 69 6e 65 64 20 75 73 69 6e 67 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 .was.defined.using.~transient-de
88400 66 69 6e 65 2d 73 75 66 66 69 78 7e 20 61 6e 64 20 61 6e 20 61 6c 69 61 73 0a 20 20 66 6f 72 20 fine-suffix~.and.an.alias...for.
88420 74 68 61 74 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 7e that.command.was.created.using.~
88440 64 65 66 61 6c 69 61 73 7e 2c 20 74 68 65 6e 20 74 68 65 20 61 6c 69 61 73 20 68 61 64 20 6e 6f defalias~,.then.the.alias.had.no
88460 0a 20 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 73 75 66 66 ...access.to.the.associated.suff
88480 69 78 20 6f 62 6a 65 63 74 2e 20 20 4e 6f 77 20 69 74 20 64 6f 65 73 2c 20 77 68 69 63 68 20 6d ix.object...Now.it.does,.which.m
884a0 61 6b 65 73 20 69 74 0a 20 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 62 69 6e 64 20 74 68 65 20 73 akes.it...possible.to.bind.the.s
884c0 61 6d 65 20 63 6f 6d 6d 61 6e 64 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 20 69 6e 20 61 20 ame.command.multiple.times.in.a.
884e0 70 72 65 66 69 78 2c 20 61 6e 64 20 6d 61 6b 65 0a 20 20 69 74 20 62 65 68 61 76 65 20 64 69 66 prefix,.and.make...it.behave.dif
88500 66 65 72 65 6e 74 6c 79 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 79 6d 62 6f 6c ferently.depending.on.the.symbol
88520 2d 6e 61 6d 65 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20 74 6f 0a 20 20 69 6e 76 6f 6b 65 20 -name.that.was.used.to...invoke.
88540 69 74 2e 20 20 66 34 33 61 65 65 31 61 0a 0a 2d 20 54 68 65 20 76 61 6c 75 65 73 20 6f 66 20 61 it...f43aee1a..-.The.values.of.a
88560 20 70 72 65 66 69 78 27 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 20 61 6e 64 .prefix's.~transient-suffix~.and
88580 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 7e 0a 20 20 73 6c 6f 74 73 20 .~transient-non-suffix~...slots.
885a0 73 68 6f 75 6c 64 20 6e 6f 77 20 62 65 20 61 20 62 6f 6f 6c 65 61 6e 2e 20 20 54 68 65 20 76 61 should.now.be.a.boolean...The.va
885c0 6c 75 65 20 6f 66 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 0a 20 20 lue.of.the.~transient-suffix~...
885e0 73 6c 6f 74 20 68 61 73 20 74 6f 20 62 65 20 68 61 6e 64 6c 65 64 20 64 69 66 66 65 72 65 6e 74 slot.has.to.be.handled.different
88600 6c 79 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 74 79 70 65 73 20 6f 66 20 73 75 66 66 69 78 ly.for.different.types.of.suffix
88620 65 73 2e 0a 20 20 49 2e 65 2e 2c 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 6d 75 73 74 es....I.e.,.infix.arguments.must
88640 20 69 67 6e 6f 72 65 20 69 74 2c 20 61 6e 64 20 73 75 62 2d 70 72 65 66 69 78 65 73 20 6d 75 73 .ignore.it,.and.sub-prefixes.mus
88660 74 20 68 6f 6e 6f 72 0a 20 20 69 74 20 62 75 74 20 74 6f 20 64 6f 20 73 6f 20 74 68 65 79 20 6d t.honor...it.but.to.do.so.they.m
88680 75 73 74 20 75 73 65 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 2e ust.use.a.different.pre-command.
886a0 20 20 50 72 65 76 69 6f 75 73 6c 79 0a 20 20 62 6f 6f 6c 65 61 6e 73 20 77 65 72 65 20 6e 6f 74 ..Previously...booleans.were.not
886c0 20 73 75 70 70 6f 72 74 65 64 20 61 6e 64 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 65 .supported.and.the.previously.re
886e0 63 6f 6d 6d 65 6e 64 65 64 20 76 61 6c 75 65 73 2c 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d commended.values,...~transient--
88700 64 6f 2d 73 74 61 79 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 65 78 69 74 do-stay~.and.~transient--do-exit
88720 7e 20 61 72 65 20 73 74 69 6c 6c 20 73 75 70 70 6f 72 74 65 64 20 28 62 75 74 0a 20 20 74 68 65 ~.are.still.supported.(but...the
88740 79 20 61 72 65 20 22 63 6f 72 72 65 63 74 65 64 22 20 66 6f 72 20 73 75 62 2d 70 72 65 66 69 78 y.are."corrected".for.sub-prefix
88760 65 73 29 2e 20 20 46 6f 72 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 20 74 es)...For.the.~transient~.slot.t
88780 68 65 0a 20 20 75 73 65 20 6f 66 20 62 6f 6f 6c 65 61 6e 73 20 77 61 73 20 61 6c 77 61 79 73 20 he...use.of.booleans.was.always.
887a0 61 6c 6c 6f 77 65 64 20 61 6e 64 20 72 65 63 6f 6d 6d 65 6e 64 65 64 2e 20 20 38 30 39 38 64 31 allowed.and.recommended...8098d1
887c0 37 35 0a 0a 2d 20 46 6f 72 20 73 75 62 2d 70 72 65 66 69 78 65 73 20 61 20 76 61 6c 75 65 20 6f 75..-.For.sub-prefixes.a.value.o
887e0 66 20 7e 74 7e 20 66 6f 72 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e f.~t~.for.the.~transient-suffix~
88800 20 73 6c 6f 74 20 6f 66 20 74 68 65 0a 20 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 20 6e 6f 77 .slot.of.the...parent.prefix.now
88820 20 6d 65 61 6e 73 20 74 68 61 74 20 73 75 66 66 69 78 65 73 2c 20 77 68 69 63 68 20 65 78 69 74 .means.that.suffixes,.which.exit
88840 20 74 68 65 20 73 75 62 2d 70 72 65 66 69 78 2c 0a 20 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 .the.sub-prefix,...return.to.the
88860 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 65 78 69 74 69 .parent.prefix,.instead.of.exiti
88880 6e 67 20 74 68 61 74 20 61 73 20 77 65 6c 6c 2e 0a 20 20 37 38 34 38 38 37 62 37 20 35 61 64 35 ng.that.as.well....784887b7.5ad5
888a0 62 36 32 37 0a 0a 2d 20 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 62 6f 6f 6c 65 61 6e 73 20 b627..-.In.addition.to.booleans.
888c0 61 6e 64 20 70 72 65 2d 63 6f 6d 6d 61 6e 64 73 2c 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 and.pre-commands,.the.values.of.
888e0 74 68 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 7e 2c 20 7e 74 72 61 6e 73 the...~transient-suffix~,.~trans
88900 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 7e ient-non-suffix~.and.~transient~
88920 20 73 6c 6f 74 73 0a 20 20 6d 61 79 20 6e 6f 77 20 61 6c 73 6f 20 62 65 20 70 72 65 2d 63 6f 6d .slots...may.now.also.be.pre-com
88940 6d 61 6e 64 20 22 73 68 6f 72 74 68 61 6e 64 73 22 2c 20 65 2e 67 2e 2c 20 75 73 65 20 7e 6c 65 mand."shorthands",.e.g.,.use.~le
88960 61 76 65 7e 20 69 6e 73 74 65 61 64 0a 20 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f ave~.instead...of.~transient--do
88980 2d 6c 65 61 76 65 7e 20 28 77 68 69 63 68 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 20 69 73 20 -leave~.(which.in.some.cases.is.
889a0 61 20 67 6f 6f 64 20 76 61 6c 75 65 20 66 6f 72 0a 20 20 60 74 72 61 6e 73 69 65 6e 74 2d 6e 6f a.good.value.for...`transient-no
889c0 6e 2d 73 75 66 66 69 78 60 29 2e 20 39 36 31 37 62 36 63 37 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 n-suffix`)..9617b6c7..-.~transie
889e0 6e 74 2d 2d 64 6f 2d 72 65 70 6c 61 63 65 7e 20 6e 6f 77 20 62 65 68 61 76 65 73 20 61 73 20 64 nt--do-replace~.now.behaves.as.d
88a00 6f 63 75 6d 65 6e 74 65 64 20 61 6e 64 20 69 6d 70 6c 69 65 64 20 62 79 20 69 74 73 0a 20 20 6e ocumented.and.implied.by.its...n
88a20 61 6d 65 2e 20 20 55 73 65 20 74 68 65 20 6e 65 77 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f ame...Use.the.new.~transient--do
88a40 2d 73 74 61 63 6b 7e 20 69 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 72 65 74 75 72 6e 20 74 6f -stack~.if.you.want.to.return.to
88a60 20 74 68 65 0a 20 20 6f 75 74 65 72 20 70 72 65 66 69 78 2e 20 20 39 34 36 36 31 65 30 63 0a 0a .the...outer.prefix...94661e0c..
88a80 2d 20 41 64 64 65 64 20 61 20 6e 65 77 20 70 72 65 66 69 78 20 73 6c 6f 74 20 7e 74 72 61 6e 73 -.Added.a.new.prefix.slot.~trans
88aa0 69 65 6e 74 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 7e 2c 20 77 68 69 63 68 20 61 6c 6c 6f 77 73 ient-switch-frame~,.which.allows
88ac0 0a 20 20 73 70 65 63 69 66 79 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 65 68 61 ...specifying.the.transient.beha
88ae0 76 69 6f 72 20 6f 66 20 7e 73 77 69 74 63 68 2d 66 72 61 6d 65 7e 20 70 65 72 20 70 72 65 66 69 vior.of.~switch-frame~.per.prefi
88b00 78 20 61 6e 64 0a 20 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 68 65 20 74 72 61 x.and...independently.of.the.tra
88b20 6e 73 69 65 6e 74 20 62 65 68 61 76 69 6f 72 20 6f 66 20 6f 74 68 65 72 20 6e 6f 6e 2d 73 75 66 nsient.behavior.of.other.non-suf
88b40 66 69 78 65 73 0a 20 20 28 73 70 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 74 68 65 20 7e 74 72 fixes...(specified.using.the.~tr
88b60 61 6e 73 69 65 6e 74 2d 6e 6f 6e 2d 73 75 66 66 69 78 7e 20 73 6c 6f 74 29 2e 20 20 36 30 39 64 ansient-non-suffix~.slot)...609d
88b80 61 62 66 64 0a 0a 2d 20 41 64 64 65 64 20 61 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 abfd..-.Added.a.new.function.~tr
88ba0 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 2d 6f 62 6a 65 63 74 7e 20 74 6f 20 61 6c 6c 6f 77 20 ansient-prefix-object~.to.allow.
88bc0 70 61 63 6b 61 67 65 0a 20 20 61 75 74 68 6f 72 73 20 74 6f 20 61 76 6f 69 64 20 74 68 65 20 66 package...authors.to.avoid.the.f
88be0 6f 6c 6c 6f 77 69 6e 67 20 75 6e 66 6f 72 74 75 6e 61 74 65 20 63 6f 6d 70 6c 69 63 61 74 69 6f ollowing.unfortunate.complicatio
88c00 6e 2e 0a 0a 20 20 57 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 20 62 65 69 6e 67 n.....While.a.transient.is.being
88c20 20 73 65 74 75 70 20 6f 72 20 72 65 66 72 65 73 68 65 64 20 28 77 68 69 63 68 20 69 6e 76 6f 6c .setup.or.refreshed.(which.invol
88c40 76 65 73 0a 20 20 70 72 65 70 61 72 69 6e 67 20 69 74 73 20 73 75 66 66 69 78 65 73 29 20 74 68 ves...preparing.its.suffixes).th
88c60 65 20 76 61 72 69 61 62 6c 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 66 69 78 7e 20 63 e.variable.~transient--prefix~.c
88c80 61 6e 20 62 65 0a 20 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 70 72 65 66 69 an.be...used.to.access.the.prefi
88ca0 78 20 6f 62 6a 65 63 74 2e 20 20 54 68 75 73 20 74 68 69 73 20 69 73 20 77 68 61 74 20 68 61 73 x.object...Thus.this.is.what.has
88cc0 20 74 6f 20 62 65 0a 20 20 75 73 65 64 20 69 6e 20 73 75 66 66 69 78 20 6d 65 74 68 6f 64 73 20 .to.be...used.in.suffix.methods.
88ce0 73 75 63 68 20 61 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 such.as.~transient-format-descri
88d00 70 74 69 6f 6e 7e 2c 0a 20 20 61 6e 64 20 69 6e 20 6f 62 6a 65 63 74 2d 73 70 65 63 69 66 69 63 ption~,...and.in.object-specific
88d20 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 73 75 .functions.that.are.stored.in.su
88d40 66 66 69 78 20 73 6c 6f 74 73 0a 20 20 73 75 63 68 20 61 73 20 7e 64 65 73 63 72 69 70 74 69 6f ffix.slots...such.as.~descriptio
88d60 6e 7e 2e 20 20 57 68 65 6e 20 61 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e n~...When.a.suffix.command.is.in
88d80 76 6f 6b 65 64 20 28 69 2e 65 2e 2c 0a 20 20 69 6e 20 69 74 73 20 7e 69 6e 74 65 72 61 63 74 69 voked.(i.e.,...in.its.~interacti
88da0 76 65 7e 20 66 6f 72 6d 20 61 6e 64 20 66 75 6e 63 74 69 6f 6e 20 62 6f 64 79 29 20 74 68 65 6e ve~.form.and.function.body).then
88dc0 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 63 75 72 72 65 .the.variable...~transient-curre
88de0 6e 74 2d 70 72 65 66 69 78 7e 20 68 61 73 20 74 6f 20 62 65 20 75 73 65 64 20 69 6e 73 74 65 61 nt-prefix~.has.to.be.used.instea
88e00 64 2e 0a 0a 20 20 54 77 6f 20 64 69 73 74 69 6e 63 74 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 d.....Two.distinct.variables.are
88e20 20 6e 65 65 64 65 64 2c 20 62 65 63 61 75 73 65 20 61 6e 79 20 70 72 65 66 69 78 20 6d 61 79 20 .needed,.because.any.prefix.may.
88e40 69 74 73 65 6c 66 0a 20 20 62 65 20 75 73 65 64 20 61 73 20 61 20 73 75 66 66 69 78 20 6f 66 20 itself...be.used.as.a.suffix.of.
88e60 61 6e 6f 74 68 65 72 20 70 72 65 66 69 78 2c 20 61 6e 64 20 73 75 63 68 20 73 75 62 2d 70 72 65 another.prefix,.and.such.sub-pre
88e80 66 69 78 65 73 20 68 61 76 65 0a 20 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 74 65 6c 6c 20 fixes.have...to.be.able.to.tell.
88ea0 74 68 65 6d 73 65 6c 76 65 73 20 61 70 61 72 74 20 66 72 6f 6d 20 74 68 65 20 70 72 65 66 69 78 themselves.apart.from.the.prefix
88ec0 20 74 68 65 79 20 77 65 72 65 0a 20 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 2e 20 20 52 65 67 75 .they.were...invoked.from...Regu
88ee0 6c 61 72 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 20 61 72 65 20 6e lar.suffix.commands,.which.are.n
88f00 6f 74 20 70 72 65 66 69 78 65 73 2c 20 64 6f 0a 20 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 63 6f ot.prefixes,.do...not.have.to.co
88f20 6e 63 65 72 6e 20 74 68 65 6d 73 65 6c 76 65 73 20 77 69 74 68 20 74 68 69 73 20 64 69 73 74 69 ncern.themselves.with.this.disti
88f40 6e 63 74 69 6f 6e 2c 20 73 6f 20 74 68 65 79 20 63 61 6e 0a 20 20 75 73 65 20 74 68 69 73 20 66 nction,.so.they.can...use.this.f
88f60 75 6e 63 74 69 6f 6e 20 69 6e 73 74 65 61 64 2e 20 20 49 6e 20 74 68 65 20 63 6f 6e 74 65 78 74 unction.instead...In.the.context
88f80 20 6f 66 20 61 20 70 6c 61 69 6e 20 73 75 66 66 69 78 2c 20 69 74 0a 20 20 61 6c 77 61 79 73 20 .of.a.plain.suffix,.it...always.
88fa0 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 70 70 72 6f 70 72 returns.the.value.of.the.appropr
88fc0 69 61 74 65 20 76 61 72 69 61 62 6c 65 2e 0a 20 20 33 37 33 30 37 63 31 62 0a 0a 42 75 67 20 66 iate.variable....37307c1b..Bug.f
88fe0 69 78 65 73 3a 0a 0a 2d 20 63 63 30 66 61 38 30 35 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 ixes:..-.cc0fa805.transient--pos
89000 74 2d 63 6f 6d 6d 61 6e 64 3a 20 52 65 64 69 73 70 6c 61 79 20 61 66 74 65 72 20 75 6e 69 76 65 t-command:.Redisplay.after.unive
89020 72 73 61 6c 20 61 72 67 75 6d 65 6e 74 0a 2d 20 64 64 39 37 30 63 64 34 20 43 6f 6d 70 69 6c 65 rsal.argument.-.dd970cd4.Compile
89040 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 72 65 20 64 65 66 69 6e 65 .suffix.commands.that.are.define
89060 64 20 69 6e 73 69 64 65 20 70 72 65 66 69 78 20 64 65 66 69 6e 69 74 69 6f 6e 73 0a 2d 20 62 31 d.inside.prefix.definitions.-.b1
89080 35 30 62 34 38 62 20 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 6f 6e 65 3a 20 43 61 6e 63 65 50b48b.transient-quit-one:.Cance
890a0 6c 20 70 72 65 66 69 78 2d 61 72 67 20 69 6e 73 74 65 61 64 20 6f 66 20 65 78 69 74 69 6e 67 20 l.prefix-arg.instead.of.exiting.
890c0 74 72 61 6e 73 69 65 6e 74 0a 2d 20 37 63 30 38 62 65 62 38 20 52 65 76 65 72 74 20 22 74 72 61 transient.-.7c08beb8.Revert."tra
890e0 6e 73 69 65 6e 74 2d 7b 73 65 74 2c 73 61 76 65 2c 72 65 73 65 74 7d 3a 20 53 74 61 79 20 74 72 nsient-{set,save,reset}:.Stay.tr
89100 61 6e 73 69 65 6e 74 22 0a 2d 20 66 38 32 30 39 63 63 38 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d ansient".-.f8209cc8.transient--m
89120 61 79 62 65 2d 70 61 64 2d 6b 65 79 73 3a 20 49 67 6e 6f 72 65 20 72 61 77 20 73 74 72 69 6e 67 aybe-pad-keys:.Ignore.raw.string
89140 73 0a 2d 20 30 61 30 62 61 31 61 61 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 6f 2d 6c 65 61 76 65 s.-.0a0ba1aa.transient--do-leave
89160 3a 20 41 63 74 75 61 6c 6c 79 20 62 65 68 61 76 65 20 61 73 20 64 6f 63 75 6d 65 6e 74 65 64 0a :.Actually.behave.as.documented.
89180 2d 20 65 64 35 62 64 36 66 64 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 28 61 -.ed5bd6fd.transient-infix-set(a
891a0 72 67 75 6d 65 6e 74 29 3a 20 46 69 78 20 64 69 73 61 62 6c 69 6e 67 20 69 6e 63 6f 6d 70 61 74 rgument):.Fix.disabling.incompat
891c0 69 62 6c 65 20 6f 70 74 69 6f 6e 73 0a 2d 20 33 61 32 62 39 33 36 61 20 46 69 78 20 68 69 67 68 ible.options.-.3a2b936a.Fix.high
891e0 6c 69 67 68 74 69 6e 67 20 69 6e 66 69 78 20 66 6f 72 20 77 68 69 63 68 20 75 73 65 72 20 69 6e lighting.infix.for.which.user.in
89200 70 75 74 20 69 73 20 62 65 69 6e 67 20 72 65 61 64 0a 2d 20 64 38 33 34 66 37 36 34 20 74 72 61 put.is.being.read.-.d834f764.tra
89220 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 28 61 72 6f 75 6e 64 3a 73 75 66 66 69 78 29 3a 20 44 6f nsient-format(around:suffix):.Do
89240 6e 27 74 20 61 74 74 65 6d 70 74 20 74 6f 20 68 69 67 68 6c 69 67 68 74 20 66 75 6c 6c 20 6c 69 n't.attempt.to.highlight.full.li
89260 6e 65 0a 2d 20 61 66 36 65 62 33 31 30 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 3a 20 ne.-.af6eb310.transient-format:.
89280 4f 6e 6c 79 20 68 69 67 68 6c 69 67 68 74 20 69 6e 66 69 78 20 69 66 20 6d 69 6e 69 62 75 66 66 Only.highlight.infix.if.minibuff
892a0 65 72 20 69 73 20 75 73 65 64 0a 2d 20 62 31 64 31 63 33 36 39 20 50 72 65 76 65 6e 74 20 74 65 er.is.used.-.b1d1c369.Prevent.te
892c0 6d 70 6f 72 61 72 79 20 66 61 63 65 73 20 66 72 6f 6d 20 6c 65 61 6b 69 6e 67 20 62 61 63 6b 20 mporary.faces.from.leaking.back.
892e0 69 6e 74 6f 20 6f 62 6a 65 63 74 73 0a 2d 20 33 30 37 36 39 35 64 32 20 74 72 61 6e 73 69 65 6e into.objects.-.307695d2.transien
89300 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f 6e 28 61 72 6f 75 6e 64 3a 73 75 66 66 t-format-description(around:suff
89320 69 78 29 3a 20 43 6f 6d 62 69 6e 65 20 66 61 63 65 73 0a 2d 20 37 66 30 32 31 35 63 34 20 74 72 ix):.Combine.faces.-.7f0215c4.tr
89340 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 28 6f 70 74 69 6f 6e 2c 76 61 6c 75 ansient-format-value(option,valu
89360 65 29 3a 20 55 73 65 20 61 72 67 75 6d 65 6e 74 20 66 61 63 65 73 0a 0a 41 6c 73 6f 20 63 6f 6e e):.Use.argument.faces..Also.con
89380 74 61 69 6e 73 20 76 61 72 69 6f 75 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 75 70 64 61 tains.various.documentation.upda
893a0 74 65 73 20 61 6e 64 20 61 20 6c 6f 74 20 6f 66 20 63 6f 64 65 20 63 6c 65 61 6e 2d 75 70 73 2e tes.and.a.lot.of.code.clean-ups.
893c0 0a 0a 54 68 69 73 20 72 65 6c 65 61 73 65 20 64 72 6f 70 73 20 73 75 70 70 6f 72 74 20 66 6f 72 ..This.release.drops.support.for
893e0 20 45 6d 61 63 73 20 32 35 2e 20 20 54 68 65 20 6c 61 73 74 20 45 6d 61 63 73 20 32 35 20 72 65 .Emacs.25...The.last.Emacs.25.re
89400 6c 65 61 73 65 0a 28 32 35 2e 33 29 20 77 61 73 20 72 65 6c 65 61 73 65 64 20 69 6e 20 32 30 31 lease.(25.3).was.released.in.201
89420 37 3b 20 6f 76 65 72 20 73 69 78 20 79 65 61 72 73 20 61 67 6f 2e 20 20 54 68 65 20 63 75 72 72 7;.over.six.years.ago...The.curr
89440 65 6e 74 20 45 6d 61 63 73 0a 76 65 72 73 69 6f 6e 20 69 73 20 32 39 2e 31 3b 20 74 68 61 74 27 ent.Emacs.version.is.29.1;.that'
89460 73 20 66 6f 75 72 20 6d 61 6a 6f 72 20 72 65 6c 65 61 73 65 73 20 73 69 6e 63 65 20 32 35 2e 31 s.four.major.releases.since.25.1
89480 2e 0a 0a 2a 20 76 30 2e 34 2e 33 20 20 20 20 32 30 32 33 2d 30 38 2d 32 35 0a 0a 2d 20 41 64 64 ...*.v0.4.3....2023-08-25..-.Add
894a0 65 64 20 61 20 73 65 63 6f 6e 64 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 7e 74 ed.a.second.implementation.of.~t
894c0 72 61 6e 73 69 65 6e 74 2d 2d 77 72 61 70 2d 63 6f 6d 6d 61 6e 64 7e 2c 20 74 61 6b 69 6e 67 0a ransient--wrap-command~,.taking.
894e0 20 20 61 64 76 61 6e 74 61 67 65 20 6f 66 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 69 6e 20 45 ..advantage.of.improvements.in.E
89500 6d 61 63 73 20 33 30 2e 0a 0a 2a 20 76 30 2e 34 2e 32 20 20 20 20 32 30 32 33 2d 30 38 2d 32 35 macs.30...*.v0.4.2....2023-08-25
89520 0a 0a 2d 20 49 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6f 6e 6c 79 20 75 73 65 66 ..-.Infix.commands.are.only.usef
89540 75 6c 20 77 68 65 6e 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 61 20 74 72 61 6e 73 69 65 6e 74 ul.when.invoked.from.a.transient
89560 20 70 72 65 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 7e 65 78 65 63 75 74 65 2d 65 .prefix...command.and.~execute-e
89580 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 7e 20 73 68 6f 75 6c 64 20 6e 6f 74 20 6f 66 66 65 xtended-command~.should.not.offe
895a0 72 20 74 68 65 6d 20 61 73 0a 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 61 74 65 r.them.as...completion.candidate
895c0 73 2e 20 20 49 6e 20 74 68 65 20 70 61 73 74 20 77 65 20 75 73 65 64 20 61 20 77 65 69 72 64 20 s...In.the.past.we.used.a.weird.
895e0 6b 6c 75 64 67 65 20 74 6f 0a 20 20 61 63 63 6f 6d 70 6c 69 73 68 20 74 68 61 74 2c 20 62 75 74 kludge.to...accomplish.that,.but
89600 20 6e 6f 77 20 77 65 20 72 65 6c 79 20 6f 6e 20 7e 72 65 61 64 2d 65 78 74 65 6e 64 65 64 2d 63 .now.we.rely.on.~read-extended-c
89620 6f 6d 6d 61 6e 64 2d 70 72 65 64 69 63 61 74 65 7e 2e 0a 20 20 54 68 61 74 20 61 6c 6c 6f 77 65 ommand-predicate~....That.allowe
89640 64 20 74 68 65 20 72 65 6d 6f 76 61 6c 20 6f 66 20 73 6f 6d 65 20 63 6f 6d 70 6c 69 63 61 74 69 d.the.removal.of.some.complicati
89660 6f 6e 73 20 61 6e 64 20 6d 61 64 65 20 69 74 20 70 6f 73 73 69 62 6c 65 0a 20 20 74 6f 20 66 69 ons.and.made.it.possible...to.fi
89680 78 20 61 20 62 75 67 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 77 72 61 70 2d 63 6f 6d 6d x.a.bug.in.~transient--wrap-comm
896a0 61 6e 64 7e 2e 0a 0a 20 20 54 6f 20 68 69 64 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2c and~.....To.hide.infix.commands,
896c0 20 75 73 65 72 73 20 6e 6f 77 20 68 61 76 65 20 74 6f 20 75 70 64 61 74 65 20 74 6f 20 45 6d 61 .users.now.have.to.update.to.Ema
896e0 63 73 20 32 38 2c 20 6f 72 0a 20 20 6c 61 74 65 72 2c 20 61 6e 64 20 63 75 73 74 6f 6d 69 7a 65 cs.28,.or...later,.and.customize
89700 20 7e 72 65 61 64 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 2d 70 72 65 64 69 63 61 74 .~read-extended-command-predicat
89720 65 7e 2e 0a 0a 20 20 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 e~.....#+begin_src.emacs-lisp...
89740 20 20 28 73 65 74 71 20 72 65 61 64 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 2d 70 72 ..(setq.read-extended-command-pr
89760 65 64 69 63 61 74 65 0a 20 20 20 20 20 20 20 20 20 20 27 63 6f 6d 6d 61 6e 64 2d 63 6f 6d 70 6c edicate...........'command-compl
89780 65 74 69 6f 6e 2d 64 65 66 61 75 6c 74 2d 69 6e 63 6c 75 64 65 2d 70 29 0a 20 20 23 2b 65 6e 64 etion-default-include-p)...#+end
897a0 5f 73 72 63 0a 0a 2d 20 44 75 65 20 74 6f 20 63 68 61 6e 67 65 73 20 69 6e 20 45 6d 61 63 73 20 _src..-.Due.to.changes.in.Emacs.
897c0 32 39 2e 31 2c 20 70 72 65 74 74 79 2d 70 72 69 6e 74 69 6e 67 20 69 73 6e 27 74 20 63 6f 6e 73 29.1,.pretty-printing.isn't.cons
897e0 69 73 74 65 6e 74 0a 20 20 61 63 72 6f 73 73 20 45 6d 61 63 73 20 72 65 6c 65 61 73 65 73 20 61 istent...across.Emacs.releases.a
89800 6e 79 6d 6f 72 65 20 62 79 20 64 65 66 61 75 6c 74 2c 20 77 68 69 63 68 20 69 73 20 75 6e 66 6f nymore.by.default,.which.is.unfo
89820 72 74 75 6e 61 74 65 0a 20 20 69 6e 20 6f 75 72 20 63 61 73 65 20 62 65 63 61 75 73 65 20 77 65 rtunate...in.our.case.because.we
89840 20 75 73 65 20 69 74 20 74 6f 20 77 72 69 74 65 20 74 6f 20 66 69 6c 65 73 20 74 68 61 74 20 61 .use.it.to.write.to.files.that.a
89860 72 65 20 6c 69 6b 65 6c 79 0a 20 20 74 6f 20 62 65 20 63 68 65 63 6b 65 64 20 69 6e 74 6f 20 76 re.likely...to.be.checked.into.v
89880 65 72 73 69 6f 6e 20 63 6f 6e 74 72 6f 6c 2e 20 20 57 65 20 6e 6f 77 20 66 6f 72 63 65 20 74 68 ersion.control...We.now.force.th
898a0 65 20 75 73 65 20 6f 66 20 74 68 65 0a 20 20 6f 6c 64 20 73 74 79 6c 65 20 61 63 72 6f 73 73 20 e.use.of.the...old.style.across.
898c0 72 65 6c 65 61 73 65 73 2e 0a 0a 2a 20 76 30 2e 34 2e 31 20 20 20 20 32 30 32 33 2d 30 36 2d 30 releases...*.v0.4.1....2023-06-0
898e0 32 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 30 37 30 64 34 37 62 30 20 53 75 70 70 6f 72 2..Bug.fixes:..-.070d47b0.Suppor
89900 74 20 73 65 61 72 63 68 65 73 20 74 68 61 74 20 65 6e 64 20 72 69 67 68 74 20 61 66 74 65 72 20 t.searches.that.end.right.after.
89920 73 75 66 66 69 78 0a 2d 20 61 62 38 33 31 38 32 38 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 suffix.-.ab831828.transient--ins
89940 65 72 74 2d 67 72 6f 75 70 28 63 6f 6c 75 6d 6e 73 29 3a 20 44 72 6f 70 20 73 65 70 61 72 61 74 ert-group(columns):.Drop.separat
89960 6f 72 20 62 65 66 6f 72 65 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e 0a 2d 20 36 32 65 64 65 66 66 or.before.first.column.-.62edeff
89980 64 20 23 32 34 37 20 46 69 78 20 62 75 67 20 75 73 69 6e 67 20 3a 69 6e 63 6f 6d 70 61 74 69 62 d.#247.Fix.bug.using.:incompatib
899a0 6c 65 20 75 73 69 6e 67 20 73 75 66 66 69 78 65 73 20 62 65 66 6f 72 65 20 69 6e 66 69 78 65 73 le.using.suffixes.before.infixes
899c0 0a 2d 20 36 65 66 61 39 66 61 64 20 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 63 61 74 65 2d .-.6efa9fad.transient-predicate-
899e0 6d 61 70 3a 20 42 69 6e 64 20 75 6e 69 76 65 72 61 6c 2d 61 72 67 75 6d 65 6e 74 2d 6d 6f 72 65 map:.Bind.univeral-argument-more
89a00 0a 0a 2a 20 76 30 2e 34 2e 30 20 20 20 20 32 30 32 33 2d 30 35 2d 31 30 0a 0a 2d 20 54 72 61 6e ..*.v0.4.0....2023-05-10..-.Tran
89a20 73 69 65 6e 74 20 68 61 73 20 74 6f 20 75 70 64 61 74 65 20 73 74 61 74 65 20 61 66 74 65 72 20 sient.has.to.update.state.after.
89a40 65 76 65 72 79 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 2e 20 20 49 66 20 74 68 61 74 0a 20 every.suffix.command...If.that..
89a60 20 66 61 69 6c 73 20 66 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c 20 74 68 65 6e 20 45 6d 61 .fails.for.some.reason,.then.Ema
89a80 63 73 20 65 6e 64 73 20 75 70 20 69 6e 20 61 6e 20 62 61 64 6c 79 20 62 72 6f 6b 65 6e 20 73 74 cs.ends.up.in.an.badly.broken.st
89aa0 61 74 65 2e 0a 20 20 49 74 20 77 61 73 20 72 61 72 65 2c 20 62 75 74 20 69 6e 20 74 68 65 20 77 ate....It.was.rare,.but.in.the.w
89ac0 6f 72 73 74 20 63 61 73 65 20 73 63 65 6e 61 72 69 6f 2c 20 74 68 61 74 20 6d 65 61 6e 74 20 74 orst.case.scenario,.that.meant.t
89ae0 68 61 74 20 45 6d 61 63 73 0a 20 20 72 65 66 75 73 65 64 20 74 6f 20 63 61 6c 6c 20 61 6e 79 20 hat.Emacs...refused.to.call.any.
89b00 6d 6f 72 65 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 68 61 64 20 74 6f 20 62 65 20 6b 69 6c 6c more.commands.and.had.to.be.kill
89b20 65 64 2e 0a 0a 20 20 4e 61 74 75 72 61 6c 6c 79 20 7e 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 ed.....Naturally.~post-command-h
89b40 6f 6f 6b 7e 20 69 73 20 74 68 65 20 66 69 72 73 74 20 63 68 6f 69 63 65 20 74 6f 20 72 75 6e 20 ook~.is.the.first.choice.to.run.
89b60 73 6f 6d 65 74 68 69 6e 67 0a 20 20 61 66 74 65 72 20 63 6f 6d 6d 61 6e 64 73 2c 20 62 75 74 20 something...after.commands,.but.
89b80 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 74 68 61 74 20 68 6f 6f 6b 20 69 73 20 6e 6f 74 20 67 unfortunately.that.hook.is.not.g
89ba0 75 61 72 61 6e 74 65 65 64 20 74 6f 20 72 75 6e 0a 20 20 6f 6e 6c 79 20 6f 6e 63 65 2c 20 61 6e uaranteed.to.run...only.once,.an
89bc0 64 20 77 6f 72 73 65 20 69 74 20 69 73 20 6e 6f 74 20 67 75 61 72 61 6e 74 65 65 64 20 72 75 6e d.worse.it.is.not.guaranteed.run
89be0 20 2f 61 66 74 65 72 2f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 0a 20 20 57 6f 72 6b 69 6e 67 20 ./after/.the.command....Working.
89c00 61 72 6f 75 6e 64 20 74 68 69 73 20 6c 69 6d 69 74 61 74 69 6f 6e 20 6d 61 64 65 20 61 6e 20 65 around.this.limitation.made.an.e
89c20 73 73 65 6e 74 69 61 6c 20 70 61 72 74 20 6f 66 20 54 72 61 6e 73 69 65 6e 74 0a 20 20 6d 75 63 ssential.part.of.Transient...muc
89c40 68 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 61 6e 64 20 66 72 61 67 69 6c 65 2e 20 20 41 73 20 h.more.complex.and.fragile...As.
89c60 6e 65 77 20 65 64 67 65 2d 63 61 73 65 73 20 77 65 72 65 20 64 69 73 63 6f 76 65 72 65 64 2c 0a new.edge-cases.were.discovered,.
89c80 20 20 6e 65 77 20 61 6e 64 20 69 6e 63 72 65 61 73 69 6e 67 6c 79 20 64 65 73 70 65 72 61 74 65 ..new.and.increasingly.desperate
89ca0 20 68 65 75 72 69 73 74 69 63 73 20 68 61 64 20 74 6f 20 62 65 20 61 64 64 65 64 2c 20 75 6e 74 .heuristics.had.to.be.added,.unt
89cc0 69 6c 20 49 0a 20 20 66 69 6e 61 6c 6c 79 20 64 65 63 69 64 65 64 20 74 68 61 74 20 72 65 6c 79 il.I...finally.decided.that.rely
89ce0 69 6e 67 20 73 6f 6c 65 6c 79 20 6f 6e 20 68 6f 6f 6b 73 20 77 61 73 20 6a 75 73 74 20 6e 6f 74 ing.solely.on.hooks.was.just.not
89d00 20 66 65 61 73 69 62 6c 65 2e 0a 0a 20 20 4e 6f 77 20 7e 70 72 65 2d 63 6f 6d 6d 61 6e 64 2d 68 .feasible.....Now.~pre-command-h
89d20 6f 6f 6b 7e 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 76 69 63 65 20 7e 74 68 69 73 2d 63 6f 6d ook~.is.used.to.advice.~this-com
89d40 6d 61 6e 64 7e 2c 20 74 6f 20 61 64 64 20 61 6e 0a 20 20 61 72 6f 75 6e 64 20 61 64 76 69 63 65 mand~,.to.add.an...around.advice
89d60 2c 20 77 68 69 63 68 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 74 68 65 20 73 74 61 74 65 20 75 ,.which.ensures.that.the.state.u
89d80 70 64 61 74 65 20 74 61 6b 65 73 20 70 6c 61 63 65 2c 20 65 76 65 6e 0a 20 20 77 68 65 6e 20 7e pdate.takes.place,.even...when.~
89da0 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 2d 68 6f 6f 6b 7e 20 69 73 20 72 75 6e 20 70 72 65 6d 61 74 post-command-hook~.is.run.premat
89dc0 75 72 65 6c 79 2e 20 20 54 68 65 20 61 64 76 69 63 65 20 77 72 61 70 73 20 62 6f 74 68 0a 20 20 urely...The.advice.wraps.both...
89de0 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 62 6f 64 79 20 61 6e 64 20 74 68 65 20 69 6e 74 65 72 61 the.function.body.and.the.intera
89e00 63 74 69 76 65 20 73 70 65 63 20 77 69 74 68 20 7e 75 6e 77 69 6e 64 2d 70 72 6f 74 65 63 74 7e ctive.spec.with.~unwind-protect~
89e20 2c 20 73 6f 0a 20 20 77 65 20 63 61 6e 20 66 69 6e 61 6c 6c 79 20 62 65 20 73 75 72 65 20 74 68 ,.so...we.can.finally.be.sure.th
89e40 61 74 20 74 68 65 20 73 74 61 74 65 20 63 68 61 6e 67 65 20 69 73 20 61 6c 77 61 79 73 20 70 65 at.the.state.change.is.always.pe
89e60 72 66 6f 72 6d 65 64 2c 0a 20 20 61 6e 64 20 74 68 61 74 20 74 68 65 20 61 64 76 69 63 65 20 69 rformed,...and.that.the.advice.i
89e80 73 20 72 65 6d 6f 76 65 64 20 61 67 61 69 6e 2e 0a 0a 20 20 49 74 20 68 61 73 20 62 65 65 6e 20 s.removed.again.....It.has.been.
89ea0 61 6e 20 69 6e 74 65 72 65 73 74 69 6e 67 20 6a 6f 75 72 6e 65 79 2c 20 61 6e 64 20 49 20 68 61 an.interesting.journey,.and.I.ha
89ec0 76 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 74 20 69 6e 20 6c 6f 6e 67 0a 20 20 63 6f 6d 6d 69 ve.documented.it.in.long...commi
89ee0 74 20 6d 65 73 73 61 67 65 73 2e 20 20 49 66 20 79 6f 75 20 61 72 65 20 69 6e 74 65 72 65 73 74 t.messages...If.you.are.interest
89f00 65 64 20 69 6e 20 74 68 65 20 64 65 74 61 69 6c 73 2c 20 73 65 65 20 37 62 38 61 37 64 37 31 0a ed.in.the.details,.see.7b8a7d71.
89f20 20 20 28 77 68 69 63 68 20 73 74 69 6c 6c 20 74 72 69 65 73 20 74 6f 20 61 76 6f 69 64 20 75 73 ..(which.still.tries.to.avoid.us
89f40 69 6e 67 20 61 6e 79 20 61 64 76 69 63 65 29 2c 20 35 31 63 36 38 63 38 37 2c 20 35 32 63 61 63 ing.any.advice),.51c68c87,.52cac
89f60 39 63 30 2c 0a 20 20 62 75 67 23 36 31 31 37 39 20 61 6e 64 20 62 75 67 23 36 31 31 37 36 2e 0a 9c0,...bug#61179.and.bug#61176..
89f80 0a 2d 20 54 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 64 65 66 69 6e 65 2d 70 72 65 66 69 78 7e .-.The.~transient-define-prefix~
89fa0 20 6e 6f 77 20 65 78 70 61 6e 64 73 20 74 6f 20 63 6f 64 65 20 69 6e 73 74 65 61 64 20 6f 66 20 .now.expands.to.code.instead.of.
89fc0 64 61 74 61 2c 0a 20 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 6c 61 6d 62 64 61 20 65 78 70 72 data,...meaning.that.lambda.expr
89fe0 65 73 73 69 6f 6e 73 20 61 72 65 20 66 69 6e 61 6c 6c 79 20 70 72 6f 70 65 72 6c 79 20 65 76 61 essions.are.finally.properly.eva
8a000 6c 75 61 74 65 64 20 61 6e 64 0a 20 20 62 79 74 65 2d 63 6f 6d 70 69 6c 65 64 2e 20 20 65 61 38 luated.and...byte-compiled...ea8
8a020 35 31 66 33 62 20 65 38 38 66 35 31 64 36 20 32 37 37 65 35 66 32 64 20 61 31 37 37 34 31 38 32 51f3b.e88f51d6.277e5f2d.a1774182
8a040 0a 0a 2d 20 50 6f 70 75 70 20 6e 61 76 69 67 61 74 69 6f 6e 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 ..-.Popup.navigation.is.no.longe
8a060 72 20 63 6f 6e 73 69 64 65 72 65 64 20 61 20 73 65 63 6f 6e 64 2d 63 6c 61 73 73 20 66 65 61 74 r.considered.a.second-class.feat
8a080 75 72 65 20 61 6e 64 0a 20 20 69 73 20 65 6e 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e ure.and...is.enabled.by.default.
8a0a0 20 20 53 6f 6d 65 20 74 72 61 6e 73 69 65 6e 74 73 20 61 6c 6c 6f 77 20 61 72 62 69 74 72 61 72 ..Some.transients.allow.arbitrar
8a0c0 79 20 6e 6f 6e 2d 73 75 66 66 69 78 65 73 0a 20 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 2c 20 y.non-suffixes...to.be.invoked,.
8a0e0 73 6f 20 73 6f 6d 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 2c 20 77 68 69 63 68 20 77 65 72 65 so.some.key.bindings,.which.were
8a100 20 70 72 65 76 69 6f 75 73 6c 79 20 75 73 65 64 20 66 6f 72 0a 20 20 70 6f 70 75 70 20 6e 61 76 .previously.used.for...popup.nav
8a120 69 67 61 74 69 6f 6e 2c 20 68 61 64 20 74 6f 20 62 65 20 72 65 6d 6f 76 65 64 2c 20 74 6f 20 61 igation,.had.to.be.removed,.to.a
8a140 76 6f 69 64 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20 39 38 64 35 30 32 30 32 20 66 66 0a 0a 2d 20 void.conflicts...98d50202.ff..-.
8a160 45 61 63 68 20 70 72 65 66 69 78 20 61 6e 64 20 73 75 66 66 69 78 20 63 61 6e 20 6e 6f 77 20 68 Each.prefix.and.suffix.can.now.h
8a180 61 76 65 20 69 74 73 20 6f 77 6e 20 68 65 6c 70 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 ave.its.own.help.function...This
8a1a0 20 69 73 0a 20 20 63 6f 6e 66 69 67 75 72 65 64 20 75 73 69 6e 67 20 74 68 65 20 6e 65 77 20 7e .is...configured.using.the.new.~
8a1c0 73 68 6f 77 2d 68 65 6c 70 7e 20 73 6c 6f 74 2e 20 20 65 61 35 61 63 39 39 66 0a 0a 2d 20 54 68 show-help~.slot...ea5ac99f..-.Th
8a1e0 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 6f 70 74 69 6f 6e 73 7e 20 63 6c 61 73 73 20 6e 6f 77 20 e.~transient-options~.class.now.
8a200 73 75 70 70 6f 72 74 73 20 74 77 6f 20 74 79 70 65 73 20 6f 66 20 6f 70 74 69 6f 6e 73 20 74 68 supports.two.types.of.options.th
8a220 61 74 0a 20 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 70 6c 65 20 76 61 6c 75 65 73 3a 20 72 at...can.have.multiple.values:.r
8a240 65 70 65 61 74 65 64 20 6f 70 74 69 6f 6e 2d 76 61 6c 75 65 20 70 61 69 72 73 20 61 6e 64 20 61 epeated.option-value.pairs.and.a
8a260 20 66 69 6e 61 6c 0a 20 20 6f 70 74 69 6f 6e 20 74 68 61 74 20 74 61 6b 65 73 20 61 6c 6c 20 72 .final...option.that.takes.all.r
8a280 65 6d 61 69 6e 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 61 73 20 76 61 6c 75 65 2e 20 20 23 31 emaining.arguments.as.value...#1
8a2a0 35 34 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 20 75 73 65 20 54..-.Added.support.for.the.use.
8a2c0 6f 66 20 6e 6f 6e 2d 70 72 6f 70 6f 72 74 69 6f 6e 61 6c 20 74 65 78 74 20 69 6e 20 74 68 65 20 of.non-proportional.text.in.the.
8a2e0 74 72 61 6e 73 69 65 6e 74 0a 20 20 70 6f 70 75 70 2e 20 20 37 66 35 35 32 30 62 33 0a 0a 2d 20 transient...popup...7f5520b3..-.
8a300 49 6d 65 6e 75 20 77 61 73 20 74 61 75 67 68 74 20 61 62 6f 75 74 20 54 72 61 6e 73 69 65 6e 74 Imenu.was.taught.about.Transient
8a320 27 73 20 64 65 66 69 6e 69 74 69 6f 6e 20 6d 61 63 72 6f 73 2e 20 20 23 31 37 38 0a 0a 2d 20 49 's.definition.macros...#178..-.I
8a340 74 20 69 73 20 6e 6f 77 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 72 65 74 75 72 6e 20 74 6f 20 74 t.is.now.possible.to.return.to.t
8a360 68 65 20 70 61 72 65 6e 74 20 70 72 65 66 69 78 20 66 72 6f 6d 20 61 20 73 75 62 2d 70 72 65 66 he.parent.prefix.from.a.sub-pref
8a380 69 78 2e 0a 20 20 65 39 30 66 37 61 31 36 0a 0a 2d 20 42 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 73 ix....e90f7a16..-.Boolean.values
8a3a0 20 6f 66 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 20 6f 66 20 73 75 62 2d .of.the.~transient~.slot.of.sub-
8a3c0 70 72 65 66 69 78 65 73 20 61 72 65 20 6e 6f 77 0a 20 20 69 6e 74 65 72 70 72 65 74 65 64 20 63 prefixes.are.now...interpreted.c
8a3e0 6f 72 72 65 63 74 6c 79 2e 20 20 34 61 33 36 62 31 64 39 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 orrectly...4a36b1d9..-.Added.new
8a400 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 68 69 64 65 2d 64 75 72 69 6e 67 2d 6d .option.~transient-hide-during-m
8a420 69 6e 69 62 75 66 66 65 72 2d 72 65 61 64 7e 2e 20 20 35 37 36 32 62 64 39 61 0a 0a 2d 20 41 64 inibuffer-read~...5762bd9a..-.Ad
8a440 64 65 64 20 6e 65 77 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 6c 69 67 6e 2d ded.new.option.~transient-align-
8a460 76 61 72 69 61 62 6c 65 2d 70 69 74 63 68 7e 2e 20 20 63 64 61 36 61 31 32 30 0a 0a 2d 20 41 64 variable-pitch~...cda6a120..-.Ad
8a480 64 65 64 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 73 65 74 ded.new.command.~transient-reset
8a4a0 7e 2c 20 77 68 69 63 68 20 63 6c 65 61 72 73 20 74 68 65 20 73 65 74 20 61 6e 64 20 73 61 76 65 ~,.which.clears.the.set.and.save
8a4c0 64 0a 20 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 69 65 6e d...value.of.the.active.transien
8a4e0 74 2e 20 20 35 31 35 38 35 62 38 64 0a 0a 2d 20 57 68 65 6e 20 75 73 69 6e 67 20 45 6d 61 63 73 t...51585b8d..-.When.using.Emacs
8a500 20 32 38 2c 20 7e 65 78 65 63 75 74 65 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 7e 20 .28,.~execute-extended-command~.
8a520 63 61 6e 20 62 65 20 74 6f 6c 64 20 74 6f 20 69 67 6e 6f 72 65 0a 20 20 74 72 61 6e 73 69 65 6e can.be.told.to.ignore...transien
8a540 74 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 45 76 65 6e 20 77 68 65 6e 20 75 73 69 t.infix.commands...Even.when.usi
8a560 6e 67 20 74 68 61 74 20 45 6d 61 63 73 20 76 65 72 73 69 6f 6e 2c 20 74 68 61 74 0a 20 20 63 6f ng.that.Emacs.version,.that...co
8a580 6d 6d 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 69 67 6e 6f 72 65 20 61 6e 79 20 63 6f 6d 6d 61 6e mmand.does.not.ignore.any.comman
8a5a0 64 73 20 62 79 20 64 65 66 61 75 6c 74 2c 20 62 75 74 20 74 68 69 73 20 62 65 68 61 76 69 6f 72 ds.by.default,.but.this.behavior
8a5c0 0a 20 20 63 61 6e 20 62 65 20 65 61 73 69 6c 79 20 62 65 20 65 6e 61 62 6c 65 64 20 75 73 69 6e ...can.be.easily.be.enabled.usin
8a5e0 67 3a 0a 0a 20 20 20 20 28 73 65 74 71 20 72 65 61 64 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d g:......(setq.read-extended-comm
8a600 61 6e 64 2d 70 72 65 64 69 63 61 74 65 0a 20 20 20 20 20 20 20 20 20 20 27 63 6f 6d 6d 61 6e 64 and-predicate...........'command
8a620 2d 63 6f 6d 70 6c 65 74 69 6f 6e 2d 64 65 66 61 75 6c 74 2d 69 6e 63 6c 75 64 65 2d 70 29 0a 0a -completion-default-include-p)..
8a640 20 20 49 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 65 ..Infix.arguments.are.implemente
8a660 64 20 61 73 20 63 6f 6d 6d 61 6e 64 73 2c 20 73 6f 20 74 68 65 79 20 62 79 20 64 65 66 61 75 6c d.as.commands,.so.they.by.defaul
8a680 74 20 73 68 6f 77 0a 20 20 75 70 20 61 73 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 63 61 6e 64 69 64 t.show...up.as.completion.candid
8a6a0 61 74 65 73 20 6f 66 20 7e 65 78 65 63 75 74 65 2d 65 78 74 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e ates.of.~execute-extended-comman
8a6c0 64 7e 2c 20 77 68 69 63 68 20 69 73 0a 20 20 75 73 65 6c 65 73 73 20 62 65 63 61 75 73 65 20 74 d~,.which.is...useless.because.t
8a6e0 68 65 79 20 61 72 65 20 6f 6e 6c 79 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 69 6e 76 6f hey.are.only.intended.to.be.invo
8a700 6b 65 64 20 66 72 6f 6d 20 74 72 61 6e 73 69 65 6e 74 0a 20 20 70 72 65 66 69 78 20 63 6f 6d 6d ked.from.transient...prefix.comm
8a720 61 6e 64 73 2e 20 20 45 6e 61 62 6c 65 20 74 68 69 73 20 66 65 61 74 75 72 65 20 74 6f 20 70 72 ands...Enable.this.feature.to.pr
8a740 65 76 65 6e 74 20 74 68 61 74 2e 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 event.that...-.Added.new.command
8a760 20 7e 74 72 61 6e 73 69 65 6e 74 2d 74 6f 67 67 6c 65 2d 64 65 62 75 67 7e 2e 20 20 62 34 36 36 .~transient-toggle-debug~...b466
8a780 63 64 39 61 0a 0a 2d 20 44 65 70 65 6e 64 20 6f 6e 20 74 68 65 20 43 6f 6d 70 61 74 20 70 61 63 cd9a..-.Depend.on.the.Compat.pac
8a7a0 6b 61 67 65 2c 20 61 6c 6c 6f 77 69 6e 67 20 6d 65 20 74 6f 20 75 73 65 20 63 6f 6e 76 65 6e 69 kage,.allowing.me.to.use.conveni
8a7c0 65 6e 74 20 66 65 61 74 75 72 65 73 0a 20 20 74 68 61 74 20 77 65 72 65 20 61 64 64 65 64 20 74 ent.features...that.were.added.t
8a7e0 6f 20 45 6d 61 63 73 20 6f 76 65 72 20 74 68 65 20 6c 61 73 74 20 66 65 77 20 79 65 61 72 73 2c o.Emacs.over.the.last.few.years,
8a800 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 0a 20 20 77 61 69 74 20 61 6e 6f 74 68 65 .without.having.to...wait.anothe
8a820 72 20 66 65 77 20 79 65 61 72 73 20 75 6e 74 69 6c 20 65 76 65 72 79 62 6f 64 79 20 68 61 73 20 r.few.years.until.everybody.has.
8a840 75 70 64 61 74 65 64 20 74 6f 20 61 20 72 65 61 73 6f 6e 61 62 6c 79 0a 20 20 72 65 63 65 6e 74 updated.to.a.reasonably...recent
8a860 20 45 6d 61 63 73 20 72 65 6c 65 61 73 65 2e 20 20 35 61 65 33 63 34 30 31 0a 0a 2d 20 41 64 64 .Emacs.release...5ae3c401..-.Add
8a880 65 64 20 62 61 73 69 63 20 73 75 70 70 6f 72 74 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 ed.basic.support.for.suffixes.th
8a8a0 61 74 20 73 70 61 6e 20 6d 75 6c 74 69 70 6c 65 20 6c 69 6e 65 73 20 28 6d 75 6c 74 69 2d 72 6f at.span.multiple.lines.(multi-ro
8a8c0 77 0a 20 20 63 65 6c 6c 73 29 2e 20 20 23 31 39 33 0a 0a 2d 20 49 6e 66 69 78 20 61 72 67 75 6d w...cells)...#193..-.Infix.argum
8a8e0 65 6e 74 73 20 63 61 6e 20 6e 6f 77 20 62 65 20 69 6e 76 6f 6b 65 64 20 66 6f 6c 6c 6f 77 69 6e ents.can.now.be.invoked.followin
8a900 67 20 61 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 2e 20 20 54 6f 0a 20 20 75 73 65 20 61 g.a.prefix.argument...To...use.a
8a920 20 6e 65 67 61 74 69 76 65 20 70 72 65 66 69 78 20 61 72 67 75 6d 65 6e 74 20 75 73 65 20 22 43 .negative.prefix.argument.use."C
8a940 2d 2d 22 2e 20 20 22 2d 22 20 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 20 61 6e 79 6d 6f 72 65 --"..."-".cannot.be.used.anymore
8a960 0a 20 20 62 65 63 61 75 73 65 20 69 74 20 63 6f 6e 66 6c 69 63 74 73 20 77 69 74 68 20 74 68 65 ...because.it.conflicts.with.the
8a980 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 70 72 65 66 69 78 20 6b 65 79 20 75 73 65 64 20 66 6f 72 .most.common.prefix.key.used.for
8a9a0 20 69 6e 66 69 78 0a 20 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 65 64 32 66 65 62 64 30 0a 0a 2d .infix...arguments...ed2febd0..-
8a9c0 20 52 65 6d 6f 76 65 64 20 6f 62 73 6f 6c 65 74 65 20 61 6c 69 61 73 65 73 20 66 6f 72 20 66 75 .Removed.obsolete.aliases.for.fu
8a9e0 6e 63 74 69 6f 6e 73 20 64 65 70 72 65 63 61 74 65 64 20 69 6e 20 76 30 2e 33 2e 30 2e 20 20 23 nctions.deprecated.in.v0.3.0...#
8aa00 31 39 32 0a 0a 2d 20 44 75 70 6c 69 63 61 74 65 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 192..-.Duplicated.suffix.command
8aa20 73 20 61 72 65 20 6e 6f 77 20 64 69 73 61 6d 62 69 67 75 61 74 65 64 2c 20 6d 61 6b 69 6e 67 20 s.are.now.disambiguated,.making.
8aa40 69 74 20 70 6f 73 73 69 62 6c 65 0a 20 20 74 6f 20 62 69 6e 64 20 61 20 63 6f 6d 6d 61 6e 64 20 it.possible...to.bind.a.command.
8aa60 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 20 61 73 20 61 20 73 75 66 66 69 78 20 6f 66 20 61 20 multiple.times.as.a.suffix.of.a.
8aa80 74 72 61 6e 73 69 65 6e 74 20 63 6f 6d 6d 61 6e 64 2c 0a 20 20 62 75 74 20 73 74 69 6c 6c 20 68 transient.command,...but.still.h
8aaa0 61 76 65 20 69 74 20 64 6f 20 64 69 66 66 65 72 65 6e 74 20 74 68 69 6e 67 73 20 64 65 70 65 6e ave.it.do.different.things.depen
8aac0 64 69 6e 67 20 6f 6e 20 77 68 61 74 20 62 69 6e 64 69 6e 67 20 69 73 0a 20 20 75 73 65 64 2c 20 ding.on.what.binding.is...used,.
8aae0 62 61 73 65 64 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 73 6f 6d 65 20 73 6c 6f 74 20 based.on.the.value.of.some.slot.
8ab00 6f 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 73 75 66 66 69 78 0a 20 20 6f 62 of.the.corresponding.suffix...ob
8ab20 6a 65 63 74 2c 20 73 69 6d 69 6c 61 72 20 74 6f 20 68 6f 77 20 7e 73 65 6c 66 2d 69 6e 73 65 72 ject,.similar.to.how.~self-inser
8ab40 74 2d 63 6f 6d 6d 61 6e 64 7e 20 69 6e 73 65 72 74 73 20 74 68 65 20 70 72 65 73 73 65 64 20 6b t-command~.inserts.the.pressed.k
8ab60 65 79 2e 0a 20 20 66 32 37 63 38 34 30 61 0a 0a 2d 20 7e 72 65 63 75 72 73 69 76 65 2d 65 64 69 ey....f27c840a..-.~recursive-edi
8ab80 74 7e 20 61 6e 64 20 7e 74 6f 70 2d 6c 65 76 65 6c 7e 20 63 61 6e 20 6e 6f 77 20 62 65 20 75 73 t~.and.~top-level~.can.now.be.us
8aba0 65 64 20 77 68 69 6c 65 20 61 20 74 72 61 6e 73 69 65 6e 74 20 69 73 0a 20 20 61 63 74 69 76 65 ed.while.a.transient.is...active
8abc0 2e 20 20 66 63 64 65 61 64 63 31 20 35 61 31 62 32 62 61 63 0a 0a 2d 20 53 77 69 74 63 68 65 64 ...fcdeadc1.5a1b2bac..-.Switched
8abe0 20 74 6f 20 45 6d 61 63 73 20 32 39 27 73 20 6e 65 77 20 6b 65 79 6d 61 70 20 66 75 6e 63 74 69 .to.Emacs.29's.new.keymap.functi
8ac00 6f 6e 73 2c 20 77 68 69 63 68 20 61 72 65 20 61 6c 73 6f 20 73 75 70 70 6f 72 74 65 64 0a 20 20 ons,.which.are.also.supported...
8ac20 69 6e 20 6e 65 77 65 72 20 72 65 6c 65 61 73 65 73 2c 20 74 68 61 6e 6b 73 20 74 6f 20 74 68 65 in.newer.releases,.thanks.to.the
8ac40 20 43 6f 6d 70 61 74 20 70 61 63 6b 61 67 65 2e 20 20 38 37 66 37 30 61 66 35 20 35 61 39 36 36 .Compat.package...87f70af5.5a966
8ac60 61 61 38 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 39 33 38 62 30 35 39 31 20 23 31 37 33 aa8..Bug.fixes:..-.938b0591.#173
8ac80 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 3a 20 53 65 74 20 70 6f 69 6e 74 20 61 66 74 65 .transient--show:.Set.point.afte
8aca0 72 20 64 69 73 70 6c 61 79 69 6e 67 20 77 69 6e 64 6f 77 20 61 67 61 69 6e 0a 2d 20 32 30 32 32 r.displaying.window.again.-.2022
8acc0 37 31 66 37 20 52 65 73 75 72 72 65 63 74 20 74 72 61 6e 73 69 65 6e 74 2d 66 69 6c 65 73 20 63 71f7.Resurrect.transient-files.c
8ace0 6c 61 73 73 0a 2d 20 63 32 36 63 62 61 63 35 20 23 31 38 31 20 74 72 61 6e 73 69 65 6e 74 2d 7b lass.-.c26cbac5.#181.transient-{
8ad00 69 6e 69 74 2c 73 65 74 7d 2d 76 61 6c 75 65 3a 20 55 73 65 20 63 61 73 65 2d 73 65 6e 73 69 74 init,set}-value:.Use.case-sensit
8ad20 69 76 65 20 6d 61 74 63 68 69 6e 67 0a 2d 20 32 38 34 39 31 65 31 66 20 50 72 6f 70 65 72 6c 79 ive.matching.-.28491e1f.Properly
8ad40 20 64 65 61 6c 20 77 69 74 68 20 73 74 65 61 6c 74 68 20 75 6e 64 65 66 69 6e 65 64 20 63 6f 6d .deal.with.stealth.undefined.com
8ad60 6d 61 6e 64 0a 2d 20 31 34 33 61 31 33 39 33 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d mand.-.143a1393.transient-infix-
8ad80 72 65 61 64 3a 20 41 6c 77 61 79 73 20 65 6e 61 62 6c 65 2d 72 65 63 75 72 73 69 76 65 2d 6d 69 read:.Always.enable-recursive-mi
8ada0 6e 69 62 75 66 66 65 72 73 0a 2d 20 37 36 62 37 37 65 30 31 20 6d 61 67 69 74 2d 2d 7b 70 72 65 nibuffers.-.76b77e01.magit--{pre
8adc0 2c 70 6f 73 74 7d 2d 63 6f 6d 6d 61 6e 64 3a 20 41 64 64 20 65 6d 65 72 67 65 6e 63 79 20 65 78 ,post}-command:.Add.emergency.ex
8ade0 69 74 73 0a 2d 20 30 39 62 34 33 36 66 61 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 62 75 67 3a its.-.09b436fa.transient--debug:
8ae00 20 49 67 6e 6f 72 65 20 65 72 72 6f 72 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 .Ignore.error.in.transient--suff
8ae20 69 78 2d 73 79 6d 62 6f 6c 0a 2d 20 66 32 65 30 64 66 63 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d ix-symbol.-.f2e0dfcc.transient--
8ae40 67 65 74 2d 70 72 65 64 69 63 61 74 65 2d 66 6f 72 3a 20 49 67 6e 6f 72 65 20 65 72 72 6f 72 20 get-predicate-for:.Ignore.error.
8ae60 69 6e 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 66 66 69 78 2d 73 79 6d 62 6f 6c 0a 2d 20 62 66 in.transient--suffix-symbol.-.bf
8ae80 32 39 37 33 31 61 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 3a 20 29731a.transient--post-command:.
8aea0 44 6f 6e 27 74 20 70 6f 70 20 61 6e 64 20 70 75 73 68 20 65 71 75 61 6c 20 72 65 64 69 73 70 6c Don't.pop.and.push.equal.redispl
8aec0 61 79 20 6d 61 70 73 0a 2d 20 33 63 37 38 62 31 30 66 20 74 72 61 6e 73 69 65 6e 74 2d 2d 72 65 ay.maps.-.3c78b10f.transient--re
8aee0 64 69 73 70 6c 61 79 3a 20 44 6f 6e 27 74 20 72 65 64 69 73 70 6c 61 79 20 64 75 72 69 6e 67 20 display:.Don't.redisplay.during.
8af00 6d 6f 75 73 65 2d 64 72 61 67 2d 72 65 67 69 6f 6e 0a 2d 20 37 31 34 65 33 34 38 32 20 4e 6f 20 mouse-drag-region.-.714e3482.No.
8af20 6c 6f 6e 67 65 72 20 61 6c 77 61 79 73 20 73 75 73 70 65 6e 64 20 77 68 65 6e 20 68 61 6e 64 6c longer.always.suspend.when.handl
8af40 65 2d 73 77 69 74 63 68 2d 66 72 61 6d 65 20 69 73 20 63 61 6c 6c 65 64 0a 2d 20 65 63 62 38 31 e-switch-frame.is.called.-.ecb81
8af60 35 62 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 61 62 6f 72 74 2d 63 6f 6d 6d 61 6e 64 73 3a 20 41 5bc.transient--abort-commands:.A
8af80 64 64 20 6b 65 79 62 6f 61 72 64 2d 65 73 63 61 70 65 2d 71 75 69 74 0a 2d 20 38 62 31 66 38 64 dd.keyboard-escape-quit.-.8b1f8d
8afa0 63 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 6d 69 6e 69 62 75 66 66 65 72 2d 64 65 70 74 68 3a 20 cc.transient--minibuffer-depth:.
8afc0 4d 75 73 74 20 61 6c 77 61 79 73 20 62 65 20 61 20 6e 75 6d 62 65 72 0a 2d 20 36 38 36 62 37 65 Must.always.be.a.number.-.686b7e
8afe0 62 63 20 46 69 78 20 68 61 6e 64 6c 69 6e 67 20 6f 66 20 73 75 62 2d 70 72 65 66 69 78 20 63 6f bc.Fix.handling.of.sub-prefix.co
8b000 6d 6d 61 6e 64 20 74 68 61 74 20 75 73 65 20 74 68 65 20 6d 69 6e 69 62 75 66 66 65 72 0a 2d 20 mmand.that.use.the.minibuffer.-.
8b020 61 31 39 66 61 61 31 63 20 52 65 74 75 72 6e 20 74 6f 20 6f 75 74 65 72 20 70 72 65 66 69 78 20 a19faa1c.Return.to.outer.prefix.
8b040 77 68 65 6e 20 6d 69 6e 69 62 75 66 66 65 72 20 69 73 20 61 62 6f 72 74 65 64 20 66 6f 72 20 73 when.minibuffer.is.aborted.for.s
8b060 75 62 2d 70 72 65 66 69 78 0a 2d 20 34 34 37 37 35 35 35 62 20 74 72 61 6e 73 69 65 6e 74 2d 2d ub-prefix.-.4477555b.transient--
8b080 70 6f 73 74 2d 65 78 69 74 3a 20 44 65 61 6c 20 77 69 74 68 20 75 6e 62 6f 75 6e 64 20 74 72 61 post-exit:.Deal.with.unbound.tra
8b0a0 6e 73 69 65 6e 74 20 73 6c 6f 74 20 70 72 6f 70 65 72 6c 79 0a 2d 20 30 66 33 39 61 66 30 65 20 nsient.slot.properly.-.0f39af0e.
8b0c0 23 31 38 38 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 72 69 70 74 69 6f #188.transient-format-descriptio
8b0e0 6e 3a 20 55 73 65 20 63 6c 2d 63 61 6c 6c 2d 6e 65 78 74 2d 6d 65 74 68 6f 64 0a 2d 20 31 66 64 n:.Use.cl-call-next-method.-.1fd
8b100 31 63 66 35 31 20 57 68 65 6e 20 68 69 67 68 6c 69 67 68 74 69 6e 67 20 73 75 66 66 69 78 65 73 1cf51.When.highlighting.suffixes
8b120 20 6e 6f 74 20 6e 6f 72 6d 61 6c 6c 79 20 64 69 73 70 6c 61 79 65 64 20 63 6f 6e 73 69 64 65 72 .not.normally.displayed.consider
8b140 20 67 72 6f 75 70 20 6c 65 76 65 6c 0a 2d 20 37 63 37 37 31 63 39 34 20 44 6f 20 6e 6f 74 20 6c .group.level.-.7c771c94.Do.not.l
8b160 65 74 2d 62 69 6e 64 20 6f 76 65 72 72 69 64 69 6e 67 2d 74 65 72 6d 69 6e 61 6c 2d 6c 6f 63 61 et-bind.overriding-terminal-loca
8b180 6c 2d 6d 61 70 20 74 6f 20 6e 69 6c 0a 2d 20 33 31 64 33 35 35 62 35 20 74 72 61 6e 73 69 65 6e l-map.to.nil.-.31d355b5.transien
8b1a0 74 2d 73 65 74 2d 6c 65 76 65 6c 3a 20 52 65 66 72 65 73 68 20 73 68 6f 77 6e 20 6c 65 76 65 6c t-set-level:.Refresh.shown.level
8b1c0 73 20 61 66 74 65 72 20 73 65 74 74 69 6e 67 20 6f 6e 65 0a 2d 20 62 62 30 35 36 65 37 31 20 49 s.after.setting.one.-.bb056e71.I
8b1e0 6e 76 6f 6b 65 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 64 69 72 65 63 74 6c 79 20 77 nvoke.suffix.commands.directly.w
8b200 68 65 6e 20 61 20 62 75 74 74 6f 6e 20 69 73 20 70 75 73 68 65 64 0a 2d 20 32 37 30 65 66 66 31 hen.a.button.is.pushed.-.270eff1
8b220 63 20 46 69 78 20 72 65 64 69 73 70 6c 61 79 20 77 68 65 6e 20 70 6f 70 75 70 20 6e 61 76 69 67 c.Fix.redisplay.when.popup.navig
8b240 61 74 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 0a 2d 20 38 31 62 32 62 39 31 32 20 55 73 65 20 ation.is.enabled.-.81b2b912.Use.
8b260 74 68 69 73 2d 6f 72 69 67 69 6e 61 6c 2d 63 6f 6d 6d 61 6e 64 20 61 67 61 69 6e 0a 2d 20 64 34 this-original-command.again.-.d4
8b280 66 62 38 35 33 64 20 23 31 39 38 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 68 6f 77 3a 20 41 6c 73 fb853d.#198.transient--show:.Als
8b2a0 6f 20 68 69 64 65 20 74 68 65 20 68 65 61 64 65 72 2d 6c 69 6e 65 0a 2d 20 37 34 36 37 61 37 39 o.hide.the.header-line.-.7467a79
8b2c0 63 20 74 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 6f 76 65 72 72 69 64 65 3a 20 43 c.transient--suspend-override:.C
8b2e0 61 6e 63 65 6c 20 64 69 73 70 6c 61 79 20 74 69 6d 65 72 0a 2d 20 35 36 38 36 61 37 39 32 20 74 ancel.display.timer.-.5686a792.t
8b300 72 61 6e 73 69 65 6e 74 2d 2d 73 75 73 70 65 6e 64 2d 6f 76 65 72 72 69 64 65 3a 20 43 61 6e 63 ransient--suspend-override:.Canc
8b320 65 6c 20 70 72 65 66 69 78 20 6b 65 79 20 64 69 73 70 6c 61 79 0a 2d 20 31 63 38 34 64 37 61 64 el.prefix.key.display.-.1c84d7ad
8b340 20 52 65 6d 61 70 20 6b 70 2d 73 75 62 74 72 61 63 74 2c 20 6b 70 2d 65 71 75 61 6c 20 61 6e 64 .Remap.kp-subtract,.kp-equal.and
8b360 20 6b 70 2d 61 64 64 0a 2d 20 35 33 30 32 64 62 31 38 20 4f 6e 63 65 20 70 6f 70 75 70 20 69 73 .kp-add.-.5302db18.Once.popup.is
8b380 20 73 68 6f 77 69 6e 67 20 6b 65 65 70 20 64 6f 69 6e 67 20 73 6f 20 75 6e 74 69 6c 20 66 75 6c .showing.keep.doing.so.until.ful
8b3a0 6c 20 65 78 69 74 0a 2d 20 63 63 38 38 37 65 62 65 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 6c l.exit.-.cc887ebe.transient--del
8b3c0 61 79 2d 70 6f 73 74 2d 63 6f 6d 6d 61 6e 64 3a 20 46 69 78 20 65 78 65 63 75 74 65 2d 65 78 74 ay-post-command:.Fix.execute-ext
8b3e0 65 6e 64 65 64 2d 63 6f 6d 6d 61 6e 64 20 68 61 6e 64 6c 69 6e 67 0a 2d 20 33 62 32 36 37 34 32 ended-command.handling.-.3b26742
8b400 35 20 74 72 61 6e 73 69 65 6e 74 2d 2d 66 69 74 2d 77 69 6e 64 6f 77 2d 74 6f 2d 62 75 66 66 65 5.transient--fit-window-to-buffe
8b420 72 3a 20 55 73 65 20 63 6f 72 72 65 63 74 20 70 61 63 6b 61 67 65 20 70 72 65 66 69 78 0a 2d 20 r:.Use.correct.package.prefix.-.
8b440 39 64 34 66 61 62 63 33 20 23 32 30 38 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 73 63 72 69 62 9d4fabc3.#208.transient--describ
8b460 65 2d 66 75 6e 63 74 69 6f 6e 3a 20 48 61 6e 64 6c 65 20 72 65 6e 61 6d 65 64 20 68 65 6c 70 20 e-function:.Handle.renamed.help.
8b480 62 75 66 66 65 72 0a 2d 20 35 35 35 37 39 32 66 37 20 23 32 30 39 20 46 69 78 20 73 65 74 74 69 buffer.-.555792f7.#209.Fix.setti
8b4a0 6e 67 20 6c 65 76 65 6c 20 6f 66 20 61 6e 6f 6e 79 6d 6f 75 73 20 69 6e 66 69 78 65 73 0a 2d 20 ng.level.of.anonymous.infixes.-.
8b4c0 30 61 33 62 32 32 66 31 20 23 32 31 35 20 74 72 61 6e 73 69 65 6e 74 2d 2d 64 65 6c 61 79 2d 70 0a3b22f1.#215.transient--delay-p
8b4e0 6f 73 74 2d 63 6f 6d 6d 61 6e 64 3a 20 41 63 63 6f 75 6e 74 20 66 6f 72 20 65 76 65 6e 74 73 20 ost-command:.Account.for.events.
8b500 72 65 74 75 72 6e 65 64 20 61 73 20 76 65 63 74 6f 72 0a 2d 20 61 64 39 35 33 63 63 33 20 23 32 returned.as.vector.-.ad953cc3.#2
8b520 30 34 20 74 72 61 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 67 72 6f 75 70 3a 20 41 64 64 20 04.transient--insert-group:.Add.
8b540 66 61 6c 6c 62 61 63 6b 20 66 6f 72 20 66 61 69 6c 65 64 20 61 6c 69 67 6e 6d 65 6e 74 20 63 61 fallback.for.failed.alignment.ca
8b560 6c 63 75 6c 61 74 69 6f 6e 0a 2d 20 35 33 33 37 65 35 65 62 20 23 32 33 30 20 74 72 61 6e 73 69 lculation.-.5337e5eb.#230.transi
8b580 65 6e 74 2d 64 65 66 69 6e 65 2d 7b 2a 7d 3a 20 45 72 72 6f 72 20 69 66 20 41 52 47 4c 49 53 54 ent-define-{*}:.Error.if.ARGLIST
8b5a0 20 69 73 20 6d 69 73 73 69 6e 67 0a 2d 20 64 38 30 30 63 65 30 31 20 55 73 65 20 65 71 75 61 6c .is.missing.-.d800ce01.Use.equal
8b5c0 20 74 6f 20 63 6f 6d 70 61 72 65 20 77 69 74 68 20 65 6d 70 74 79 20 76 65 63 74 6f 72 0a 2d 20 .to.compare.with.empty.vector.-.
8b5e0 33 36 35 37 31 31 37 62 20 23 32 33 34 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 73 3657117b.#234.transient--parse-s
8b600 75 66 66 69 78 3a 20 44 65 74 65 63 74 20 77 68 65 6e 20 6d 61 6e 64 61 74 6f 72 79 20 63 6f 6d uffix:.Detect.when.mandatory.com
8b620 6d 61 6e 64 20 69 73 20 6d 69 73 73 69 6e 67 0a 2d 20 66 38 38 63 62 62 63 35 20 23 32 33 34 20 mand.is.missing.-.f88cbbc5.#234.
8b640 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 73 75 66 66 69 78 3a 20 44 69 66 66 65 72 65 transient--parse-suffix:.Differe
8b660 6e 74 69 61 74 65 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 64 65 73 63 20 6c 61 6d 62 64 61 0a 2d ntiate.command.and.desc.lambda.-
8b680 20 30 32 30 34 61 32 34 33 20 23 32 33 34 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d .0204a243.#234.transient--parse-
8b6a0 73 75 66 66 69 78 3a 20 44 65 66 69 6e 65 20 73 75 66 66 69 78 20 61 6c 69 61 73 65 73 20 61 74 suffix:.Define.suffix.aliases.at
8b6c0 20 6c 6f 61 64 2d 74 69 6d 65 0a 2d 20 30 61 65 30 64 65 34 33 20 23 32 34 31 20 74 72 61 6e 73 .load-time.-.0ae0de43.#241.trans
8b6e0 69 65 6e 74 2d 2d 69 6e 76 61 6c 69 64 3a 20 41 64 64 20 73 70 65 63 69 61 6c 2d 63 61 73 65 20 ient--invalid:.Add.special-case.
8b700 66 6f 72 20 61 6e 6f 6e 79 6d 6f 75 73 20 69 6e 61 70 74 20 63 6f 6d 6d 61 6e 64 73 0a 2d 20 61 for.anonymous.inapt.commands.-.a
8b720 66 37 66 65 34 32 62 20 23 32 34 34 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 65 2d 73 75 f7fe42b.#244.transient--parse-su
8b740 66 66 69 78 3a 20 44 6f 6e 27 74 20 74 72 79 20 74 6f 20 65 76 61 6c 75 61 74 65 20 63 6c 6f 73 ffix:.Don't.try.to.evaluate.clos
8b760 75 72 65 73 20 61 67 61 69 6e 0a 2d 20 36 66 66 35 63 35 31 66 20 74 72 61 6e 73 69 65 6e 74 2d ures.again.-.6ff5c51f.transient-
8b780 69 73 65 61 72 63 68 2d 61 62 6f 72 74 3a 20 46 69 78 20 70 61 72 74 69 61 6c 20 6d 61 74 63 68 isearch-abort:.Fix.partial.match
8b7a0 20 63 61 73 65 0a 0a 41 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 20 76 61 72 69 6f 75 73 20 64 6f 63 .case..Also.contains.various.doc
8b7c0 75 6d 65 6e 74 61 74 69 6f 6e 20 75 70 64 61 74 65 73 2c 20 63 6f 64 65 20 63 6c 65 61 6e 2d 75 umentation.updates,.code.clean-u
8b7e0 70 73 20 61 6e 64 0a 62 75 69 6c 64 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 2e 0a 0a 2a 20 76 30 ps.and.build.improvements...*.v0
8b800 2e 33 2e 37 20 20 20 20 32 30 32 31 2d 31 30 2d 32 35 0a 0a 2d 20 41 64 64 65 64 20 61 6e 20 61 .3.7....2021-10-25..-.Added.an.a
8b820 64 64 69 74 69 6f 6e 61 6c 20 73 61 66 65 74 79 20 68 61 74 63 68 20 74 6f 20 70 72 65 76 65 6e dditional.safety.hatch.to.preven
8b840 74 20 45 6d 61 63 73 20 66 72 6f 6d 20 65 6e 74 65 72 69 6e 67 20 61 6e 0a 20 20 69 6e 63 6f 6e t.Emacs.from.entering.an...incon
8b860 73 69 73 74 65 6e 74 20 73 74 61 74 65 20 77 68 65 6e 20 61 6e 20 75 6e 65 78 70 65 63 74 65 64 sistent.state.when.an.unexpected
8b880 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 20 20 39 39 65 34 38 33 36 39 0a 0a 2d 20 41 64 64 65 .error.occurs...99e48369..-.Adde
8b8a0 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 73 65 63 74 69 d.support.for.implementing.secti
8b8c0 6f 6e 20 6d 6f 76 65 6d 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 0a 20 20 74 68 69 72 64 2d on.movement.commands.in...third-
8b8e0 70 61 72 74 79 20 70 61 63 6b 61 67 65 73 2e 20 20 54 68 69 73 20 77 61 73 20 72 65 71 75 65 73 party.packages...This.was.reques
8b900 74 65 64 20 62 79 20 74 68 65 20 6d 61 69 6e 74 61 69 6e 65 72 20 6f 66 0a 20 20 45 6d 61 63 73 ted.by.the.maintainer.of...Emacs
8b920 70 65 61 6b 2e 20 20 42 65 63 61 75 73 65 20 74 68 65 79 20 77 6f 75 6c 64 20 62 65 20 6f 66 20 peak...Because.they.would.be.of.
8b940 76 65 72 79 20 6c 69 6d 69 74 65 64 20 75 73 65 20 74 6f 20 73 69 67 68 74 65 64 0a 20 20 75 73 very.limited.use.to.sighted...us
8b960 65 72 73 20 6e 6f 20 73 75 63 68 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 64 64 65 64 20 74 ers.no.such.commands.are.added.t
8b980 6f 20 54 72 61 6e 73 69 65 6e 74 20 69 74 73 65 6c 66 2e 20 20 37 36 39 32 31 39 62 35 0a 0a 2d o.Transient.itself...769219b5..-
8b9a0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 6e 75 6d 62 65 72 2d 7b 4e 30 2c 4e 2b 2c 4e .~transient-read-number-{N0,N+,N
8b9c0 7d 7e 20 6e 6f 77 20 73 75 70 70 6f 72 74 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 74 }~.now.support.infix.arguments.t
8b9e0 68 61 74 0a 20 20 68 61 76 65 20 74 68 72 65 65 20 64 69 66 66 65 72 65 6e 74 20 73 74 61 74 65 hat...have.three.different.state
8ba00 73 3a 20 64 69 73 61 62 6c 65 64 2c 20 65 6e 61 62 6c 65 64 20 77 69 74 68 6f 75 74 20 61 6e 20 s:.disabled,.enabled.without.an.
8ba20 65 6d 70 74 79 0a 20 20 76 61 6c 75 65 2c 20 61 6e 64 20 65 6e 61 62 6c 65 64 20 77 69 74 68 20 empty...value,.and.enabled.with.
8ba40 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 76 61 6c 75 65 2e 20 20 36 32 36 64 31 30 35 65 0a 0a 2d 20 a.non-empty.value...626d105e..-.
8ba60 49 66 20 61 20 63 6f 6d 6d 61 6e 64 20 69 73 20 63 61 6c 6c 65 64 20 61 73 20 61 20 73 75 66 66 If.a.command.is.called.as.a.suff
8ba80 69 78 20 6f 66 20 69 74 73 65 6c 66 2c 20 74 68 65 6e 20 74 68 65 20 68 65 6c 70 20 63 6f 6d 6d ix.of.itself,.then.the.help.comm
8baa0 61 6e 64 0a 20 20 73 68 6f 77 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 and...shows.the.function.definit
8bac0 69 6f 6e 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 6d 61 6e 2d 70 61 67 65 20 61 73 20 69 ion.instead.of.the.man-page.as.i
8bae0 74 20 75 73 75 61 6c 6c 79 0a 20 20 64 6f 65 73 20 66 6f 72 20 70 72 65 66 69 78 65 73 2e 20 20 t.usually...does.for.prefixes...
8bb00 65 31 37 65 32 62 32 66 0a 0a 2d 20 47 69 76 65 20 75 73 65 72 73 20 6d 6f 72 65 20 63 6f 6e 74 e17e2b2f..-.Give.users.more.cont
8bb20 72 6f 6c 20 6f 76 65 72 20 68 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 62 75 66 66 65 rol.over.how.the.transient.buffe
8bb40 72 20 69 73 20 64 69 73 70 6c 61 79 65 64 2e 0a 20 20 56 61 72 69 6f 75 73 20 61 73 70 65 63 74 r.is.displayed....Various.aspect
8bb60 73 20 74 68 61 74 20 77 65 72 65 20 70 72 65 76 69 6f 75 73 6c 79 20 68 61 72 64 63 6f 64 65 64 s.that.were.previously.hardcoded
8bb80 20 63 61 6e 20 6e 6f 77 20 62 65 20 63 68 61 6e 67 65 64 0a 20 20 75 73 69 6e 67 20 74 68 65 20 .can.now.be.changed...using.the.
8bba0 7e 74 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e ~transient-display-buffer-action
8bbc0 7e 20 6f 70 74 69 6f 6e 2e 20 20 37 63 36 37 37 37 33 37 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 ~.option...7c677737..-.Added.sup
8bbe0 70 6f 72 74 20 66 6f 72 20 61 64 64 69 6e 67 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 6d 69 port.for.adding.suffixes.that.mi
8bc00 67 68 74 20 62 65 20 6e 65 69 74 68 65 72 20 64 65 66 69 6e 65 64 20 6e 6f 72 0a 20 20 61 75 74 ght.be.neither.defined.nor...aut
8bc20 6f 6c 6f 61 64 65 64 20 77 68 65 6e 20 74 68 65 20 70 72 65 66 69 78 20 69 73 20 69 6e 76 6f 6b oloaded.when.the.prefix.is.invok
8bc40 65 64 2e 20 20 54 68 69 73 20 75 73 75 61 6c 6c 79 20 72 65 73 75 6c 74 73 20 69 6e 20 61 6e 0a ed...This.usually.results.in.an.
8bc60 20 20 65 72 72 6f 72 20 61 6e 64 20 77 68 69 6c 65 20 69 74 20 69 73 20 6e 6f 77 20 70 6f 73 73 ..error.and.while.it.is.now.poss
8bc80 69 62 6c 65 20 74 6f 20 6f 76 65 72 72 69 64 65 20 74 68 61 74 20 75 73 69 6e 67 20 61 6e 20 65 ible.to.override.that.using.an.e
8bca0 78 74 72 61 0a 20 20 73 74 65 70 2c 20 69 74 20 69 73 20 73 74 69 6c 6c 20 64 69 73 63 6f 75 72 xtra...step,.it.is.still.discour
8bcc0 61 67 65 64 2e 20 20 36 38 34 32 33 30 35 65 0a 0a 42 75 67 20 66 69 78 65 73 3a 0a 0a 2d 20 31 aged...6842305e..Bug.fixes:..-.1
8bce0 65 37 34 30 36 30 38 20 74 72 61 6e 73 69 65 6e 74 2d 6d 61 70 3a 20 42 69 6e 64 20 43 2d 75 20 e740608.transient-map:.Bind.C-u.
8bd00 74 6f 20 75 6e 69 76 65 72 73 61 6c 2d 61 72 67 75 6d 65 6e 74 0a 2d 20 65 39 30 34 38 31 30 30 to.universal-argument.-.e9048100
8bd20 20 45 78 70 6c 69 63 69 74 6c 79 20 63 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 72 65 2d .Explicitly.call.transient--pre-
8bd40 63 6f 6d 6d 61 6e 64 20 69 6e 20 62 75 74 74 6f 6e 20 61 63 74 69 6f 6e 0a 2d 20 62 65 31 31 39 command.in.button.action.-.be119
8bd60 65 65 34 20 45 78 70 6f 72 74 20 76 61 72 69 61 62 6c 65 73 20 66 6f 72 20 74 72 61 6e 73 69 65 ee4.Export.variables.for.transie
8bd80 6e 74 20 6e 6f 6e 2d 69 6e 66 69 78 20 73 75 66 66 69 78 65 73 0a 2d 20 62 35 32 36 62 39 63 37 nt.non-infix.suffixes.-.b526b9c7
8bda0 20 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 73 65 74 3a 20 43 6f 6e 73 69 64 65 72 20 61 .transient-infix-set:.Consider.a
8bdc0 6c 6c 20 69 6e 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 72 75 6c 65 73 0a 2d 20 37 31 32 36 64 ll.incompatibility.rules.-.7126d
8bde0 36 61 61 20 46 69 78 20 68 79 64 72 61 2d 69 6e 73 70 69 72 65 64 20 63 6f 6c 6f 72 73 0a 2d 20 6aa.Fix.hydra-inspired.colors.-.
8be00 30 63 32 32 35 35 61 32 20 74 72 61 6e 73 69 65 6e 74 2d 67 65 74 2d 76 61 6c 75 65 3a 20 41 64 0c2255a2.transient-get-value:.Ad
8be20 64 20 61 6e 20 65 6d 65 72 67 65 6e 63 79 20 65 78 69 74 0a 0a 41 6c 73 6f 20 63 6f 6e 74 61 69 d.an.emergency.exit..Also.contai
8be40 6e 73 20 76 61 72 69 6f 75 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 75 70 64 61 74 65 73 ns.various.documentation.updates
8be60 20 61 6e 64 20 63 6f 64 65 20 63 6c 65 61 6e 2d 75 70 73 2e 0a 0a 2a 20 76 30 2e 33 2e 36 20 20 .and.code.clean-ups...*.v0.3.6..
8be80 20 20 32 30 32 31 2d 30 37 2d 30 31 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 6f 70 74 69 6f 6e ..2021-07-01..-.Added.new.option
8bea0 20 7e 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 73 69 6e 67 6c 65 2d 63 6f 6c 75 6d 6e 7e .~transient-force-single-column~
8bec0 2c 20 77 68 69 63 68 20 6d 61 79 20 62 65 20 75 73 65 66 75 6c 0a 20 20 66 6f 72 20 6c 6f 77 20 ,.which.may.be.useful...for.low.
8bee0 76 69 73 69 6f 6e 2e 20 20 23 31 32 32 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 6f 70 74 69 6f vision...#122..-.Added.new.optio
8bf00 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 68 69 67 68 6c 69 67 68 74 2d 68 69 67 68 65 72 2d 6c 65 n.~transient-highlight-higher-le
8bf20 76 65 6c 73 7e 2c 20 77 68 69 63 68 20 69 73 0a 20 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 70 vels~,.which.is...intended.for.p
8bf40 61 63 6b 61 67 65 20 61 75 74 68 6f 72 73 2e 20 20 39 30 61 30 35 36 32 32 0a 0a 2a 20 76 30 2e ackage.authors...90a05622..*.v0.
8bf60 33 2e 35 20 20 20 20 32 30 32 31 2d 30 36 2d 31 36 0a 0a 2d 20 41 64 64 65 64 20 61 20 6b 6c 75 3.5....2021-06-16..-.Added.a.klu
8bf80 64 67 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 73 6f 6d 65 20 75 6e 65 78 70 65 63 74 dge.to.work.around.some.unexpect
8bfa0 65 64 20 45 6d 61 63 73 20 62 65 68 61 76 69 6f 72 2e 0a 20 20 65 66 39 32 31 64 33 30 0a 0a 2d ed.Emacs.behavior....ef921d30..-
8bfc0 20 57 68 65 6e 20 73 68 6f 77 69 6e 67 20 68 65 6c 70 20 66 6f 72 20 61 20 73 75 66 66 69 78 20 .When.showing.help.for.a.suffix.
8bfe0 74 68 61 74 20 69 73 20 61 6c 73 6f 20 61 20 73 75 62 70 72 65 66 69 78 2c 20 74 68 65 6e 20 61 that.is.also.a.subprefix,.then.a
8c000 6c 73 6f 0a 20 20 63 6f 6e 73 69 64 65 72 20 74 68 65 20 6d 61 6e 70 61 67 65 20 74 68 61 74 20 lso...consider.the.manpage.that.
8c020 69 73 20 73 65 74 20 66 6f 72 20 74 68 65 20 70 72 65 66 69 78 2c 20 69 66 20 61 6e 79 2e 20 20 is.set.for.the.prefix,.if.any...
8c040 61 39 62 64 64 30 31 33 0a 0a 2a 20 76 30 2e 33 2e 34 20 20 20 20 32 30 32 31 2d 30 35 2d 32 35 a9bdd013..*.v0.3.4....2021-05-25
8c060 0a 0a 2d 20 56 65 72 79 20 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73 2e 0a 0a 2a 20 76 30 2e 33 2e ..-.Very.minor.changes...*.v0.3.
8c080 33 20 20 20 20 32 30 32 31 2d 30 35 2d 32 34 0a 0a 2d 20 41 64 64 65 64 20 53 50 44 58 2d 4c 69 3....2021-05-24..-.Added.SPDX-Li
8c0a0 63 65 6e 73 65 2d 49 64 65 6e 74 69 66 69 65 72 20 6c 69 62 72 61 72 79 20 68 65 61 64 65 72 2e cense-Identifier.library.header.
8c0c0 20 20 37 64 33 64 38 64 37 39 0a 0a 2a 20 76 30 2e 33 2e 32 20 20 20 20 32 30 32 31 2d 30 34 2d ..7d3d8d79..*.v0.3.2....2021-04-
8c0e0 32 30 0a 0a 2d 20 46 69 78 65 64 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 20 20 63 20..-.Fixed.an.error.message...c
8c100 31 34 35 32 32 39 61 0a 0a 2a 20 76 30 2e 33 2e 31 20 20 20 20 32 30 32 31 2d 30 34 2d 31 39 0a 145229a..*.v0.3.1....2021-04-19.
8c120 0a 2d 20 43 68 61 6e 67 65 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 66 69 78 7e 27 73 20 .-.Changed.~transient-prefix~'s.
8c140 7e 73 75 66 66 69 78 2d 64 65 73 63 72 69 70 74 69 6f 6e 7e 20 73 6c 6f 74 20 74 6f 20 62 65 20 ~suffix-description~.slot.to.be.
8c160 69 6e 69 74 69 61 6c 6c 79 0a 20 20 75 6e 62 6f 75 6e 64 2c 20 61 73 20 77 61 73 20 61 6c 77 61 initially...unbound,.as.was.alwa
8c180 79 73 20 69 6e 74 65 6e 64 65 64 2e 20 20 63 32 38 62 38 61 34 0a 0a 2d 20 41 64 64 65 64 20 6e ys.intended...c28b8a4..-.Added.n
8c1a0 65 77 20 66 75 6e 63 74 69 6f 6e 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 66 69 6c ew.functions.~transient-read-fil
8c1c0 65 7e 20 61 6e 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 65 78 69 73 74 69 6e e~.and...~transient-read-existin
8c1e0 67 2d 66 69 6c 65 7e 2e 20 20 61 33 62 34 34 32 32 34 0a 0a 2a 20 76 30 2e 33 2e 30 20 20 20 20 g-file~...a3b44224..*.v0.3.0....
8c200 32 30 32 31 2d 30 32 2d 32 31 0a 0a 2d 20 41 64 64 65 64 20 61 20 74 65 6d 70 6f 72 61 72 79 20 2021-02-21..-.Added.a.temporary.
8c220 6b 6c 75 64 67 65 20 74 6f 20 70 72 65 76 65 6e 74 20 61 20 74 72 61 6e 73 69 65 6e 74 20 66 72 kludge.to.prevent.a.transient.fr
8c240 6f 6d 20 62 65 69 6e 67 20 69 6e 76 6f 6b 65 64 0a 20 20 77 68 69 6c 65 20 74 68 65 20 6d 69 6e om.being.invoked...while.the.min
8c260 69 62 75 66 66 65 72 20 69 73 20 61 63 74 69 76 65 2e 20 20 41 20 66 75 74 75 72 65 20 72 65 6c ibuffer.is.active...A.future.rel
8c280 65 61 73 65 20 77 69 6c 6c 20 65 6e 61 62 6c 65 0a 20 20 74 68 69 73 20 61 67 61 69 6e 2c 20 6f ease.will.enable...this.again,.o
8c2a0 6e 63 65 20 77 65 20 61 72 65 20 73 75 72 65 20 74 68 61 74 20 63 61 6e 6e 6f 74 20 63 61 75 73 nce.we.are.sure.that.cannot.caus
8c2c0 65 20 45 6d 61 63 73 20 74 6f 20 65 6e 74 65 72 20 61 6e 0a 20 20 69 6e 63 6f 6e 73 69 73 74 65 e.Emacs.to.enter.an...inconsiste
8c2e0 6e 74 20 73 74 61 74 65 2c 20 74 68 61 74 20 63 61 75 73 65 73 20 6d 6f 73 74 20 65 76 65 6e 74 nt.state,.that.causes.most.event
8c300 73 20 74 6f 20 62 65 20 69 67 6e 6f 72 65 64 2e 20 20 23 31 31 32 0a 0a 2d 20 49 6d 70 72 6f 76 s.to.be.ignored...#112..-.Improv
8c320 65 64 20 74 68 65 20 62 61 63 6b 74 72 61 63 65 20 74 68 61 74 20 69 73 20 73 68 6f 77 6e 20 77 ed.the.backtrace.that.is.shown.w
8c340 68 65 6e 20 61 20 66 61 74 61 6c 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 20 69 6e 20 61 0a hen.a.fatal.error.occurred.in.a.
8c360 20 20 63 72 69 74 69 63 61 6c 20 63 6f 6e 74 65 78 74 2e 20 20 54 68 69 73 20 69 6e 76 6f 6c 76 ..critical.context...This.involv
8c380 65 64 20 73 6f 6d 65 20 62 61 63 6b 20 61 6e 64 20 66 6f 72 74 68 2e 20 20 53 65 65 20 63 6f 6d ed.some.back.and.forth...See.com
8c3a0 6d 69 74 73 0a 20 20 6d 65 6e 74 69 6f 6e 69 6e 67 20 74 68 65 20 22 65 6d 65 72 67 65 6e 63 79 mits...mentioning.the."emergency
8c3c0 20 65 78 69 74 22 2e 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 64 65 66 .exit"...-.Added.support.for.def
8c3e0 69 6e 69 6e 67 20 61 20 70 65 72 2d 70 72 65 66 69 78 20 66 61 6c 6c 62 61 63 6b 20 73 75 66 66 ining.a.per-prefix.fallback.suff
8c400 69 78 20 64 65 73 63 72 69 70 74 69 6f 6e 0a 20 20 66 75 6e 63 74 69 6f 6e 2c 20 77 68 69 63 68 ix.description...function,.which
8c420 20 69 73 20 75 73 65 64 20 66 6f 72 20 73 75 66 66 69 78 65 73 20 74 68 61 74 20 64 6f 20 6e 6f .is.used.for.suffixes.that.do.no
8c440 74 20 65 78 70 6c 69 63 69 74 6c 79 20 70 72 6f 76 69 64 65 0a 20 20 61 20 64 65 73 63 72 69 70 t.explicitly.provide...a.descrip
8c460 74 69 6f 6e 2e 20 20 54 68 65 20 6e 65 77 20 7e 73 75 66 66 69 78 2d 64 65 73 63 72 69 70 74 69 tion...The.new.~suffix-descripti
8c480 6f 6e 7e 20 73 6c 6f 74 20 69 73 20 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 0a 20 20 74 68 on~.slot.is.used.to.specify...th
8c4a0 61 74 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 6e 65 77 20 7e 74 72 61 6e 73 69 65 6e 74 at.function...The.new.~transient
8c4c0 2d 63 6f 6d 6d 61 6e 64 2d 73 75 6d 6d 61 72 79 2d 6f 72 2d 6e 61 6d 65 7e 20 66 75 6e 63 74 69 -command-summary-or-name~.functi
8c4e0 6f 6e 0a 20 20 69 73 20 75 73 65 66 75 6c 2c 20 6e 6f 74 20 6a 75 73 74 20 61 73 20 61 6e 20 65 on...is.useful,.not.just.as.an.e
8c500 78 61 6d 70 6c 65 2e 20 20 38 62 32 32 62 35 32 62 0a 0a 2d 20 41 64 64 65 64 20 7e 74 72 61 6e xample...8b22b52b..-.Added.~tran
8c520 73 69 65 6e 74 2d 61 72 67 2d 76 61 6c 75 65 7e 2c 20 77 68 69 63 68 20 63 61 6e 20 62 65 20 75 sient-arg-value~,.which.can.be.u
8c540 73 65 64 20 74 6f 20 65 78 74 72 61 63 74 20 74 68 65 20 76 61 6c 75 65 73 0a 20 20 6f 66 20 69 sed.to.extract.the.values...of.i
8c560 6e 64 69 76 69 64 75 61 6c 20 61 72 67 75 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 6f 75 74 70 75 ndividual.arguments.in.the.outpu
8c580 74 20 6f 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 2e 20 20 64 37 36 66 37 33 66 38 t.of.~transient-args~...d76f73f8
8c5a0 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 75 73 69 6e 67 20 76 61 72 69 ..-.Added.support.for.using.vari
8c5c0 61 62 6c 65 73 20 69 6e 20 67 72 6f 75 70 20 61 6e 64 20 73 75 66 66 69 78 20 64 65 66 69 6e 69 ables.in.group.and.suffix.defini
8c5e0 74 69 6f 6e 73 0a 20 20 6f 66 20 61 20 70 72 65 66 69 78 2e 20 20 53 75 63 68 20 69 6e 64 69 72 tions...of.a.prefix...Such.indir
8c600 65 63 74 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 73 20 61 72 65 20 72 65 73 6f 6c 76 65 64 20 ect.specifications.are.resolved.
8c620 77 68 65 6e 20 74 68 65 0a 20 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 69 73 20 62 when.the...transient.prefix.is.b
8c640 65 69 6e 67 20 64 65 66 69 6e 65 64 2e 20 20 23 31 30 31 0a 0a 2d 20 4e 6f 20 6c 6f 6e 67 65 72 eing.defined...#101..-.No.longer
8c660 20 62 69 6e 64 20 7e 4d 2d 3c 6b 65 79 3e 7e 20 74 6f 20 61 6e 79 20 63 6f 6d 6d 6f 6e 20 73 75 .bind.~M-<key>~.to.any.common.su
8c680 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 3b 20 66 72 65 65 69 6e 67 20 74 68 69 73 0a 20 20 6e 61 ffix.commands;.freeing.this...na
8c6a0 6d 65 73 70 61 63 65 20 66 6f 72 20 61 20 76 61 72 69 65 74 79 20 6f 66 20 75 73 65 73 20 69 6e mespace.for.a.variety.of.uses.in
8c6c0 20 69 6e 64 69 76 69 64 75 61 6c 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 41 20 66 65 77 0a 20 20 .individual.transient...A.few...
8c6e0 65 78 69 73 74 69 6e 67 20 62 69 6e 64 69 6e 67 73 20 68 61 64 20 74 6f 20 62 65 20 63 68 61 6e existing.bindings.had.to.be.chan
8c700 67 65 64 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 69 73 2e 20 20 39 39 30 65 62 30 61 32 0a 0a ged.because.of.this...990eb0a2..
8c720 2d 20 41 64 64 65 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 65 73 7e 20 66 75 6e -.Added.~transient-suffixes~.fun
8c740 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 0a 20 20 7e 74 ction,.which.is.useful.when...~t
8c760 72 61 6e 73 69 65 6e 74 2d 61 72 67 73 7e 20 69 73 20 6e 6f 74 20 73 75 66 66 69 63 69 65 6e 74 ransient-args~.is.not.sufficient
8c780 20 62 65 63 61 75 73 65 20 6f 6e 65 20 6e 65 65 64 73 20 74 68 65 20 73 75 66 66 69 78 0a 20 20 .because.one.needs.the.suffix...
8c7a0 6f 62 6a 65 63 74 73 2c 20 6e 6f 74 20 6a 75 73 74 20 74 68 65 69 72 20 76 61 6c 75 65 73 2e 20 objects,.not.just.their.values..
8c7c0 20 23 39 38 0a 0a 2d 20 41 64 64 65 64 20 7e 69 6e 69 74 2d 76 61 6c 75 65 7e 20 73 6c 6f 74 20 .#98..-.Added.~init-value~.slot.
8c7e0 66 6f 72 20 69 6e 66 69 78 20 61 6e 64 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 73 2e 20 20 49 for.infix.and.prefix.objects...I
8c800 66 20 74 68 69 73 20 76 61 6c 75 65 0a 20 20 62 6f 75 6e 64 20 74 68 65 6e 20 69 74 20 69 73 20 f.this.value...bound.then.it.is.
8c820 63 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 6f 62 6a 65 63 74 20 61 73 20 6f 6e 6c 79 20 61 called.with.the.object.as.only.a
8c840 72 67 75 6d 65 6e 74 20 69 6e 73 74 65 61 64 20 6f 66 0a 20 20 74 68 65 20 70 72 69 6d 61 72 79 rgument.instead.of...the.primary
8c860 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 69 74 2d 76 61 6c 75 65 7e 20 6d 65 74 68 6f 64 20 6f .~transient-init-value~.method.o
8c880 66 20 74 68 65 20 6f 62 6a 65 63 74 20 63 6c 61 73 73 2e 20 20 23 39 36 2c 0a 20 20 33 32 38 34 f.the.object.class...#96,...3284
8c8a0 66 36 61 30 0a 0a 2d 20 41 64 64 65 64 20 7e 75 6e 73 61 76 61 62 6c 65 7e 20 73 6c 6f 74 20 66 f6a0..-.Added.~unsavable~.slot.f
8c8c0 6f 72 20 69 6e 66 69 78 20 6f 62 6a 65 63 74 73 2e 20 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f or.infix.objects...If.this.is.no
8c8e0 6e 2d 6e 69 6c 2c 20 74 68 65 6e 0a 20 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 69 n-nil,.then...the.value.of.the.i
8c900 6e 66 69 78 20 69 73 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 70 72 65 66 69 78 20 nfix.is.removed.from.the.prefix.
8c920 76 61 6c 75 65 20 62 65 66 6f 72 65 0a 20 20 73 61 76 69 6e 67 2c 20 73 65 74 74 69 6e 67 20 61 value.before...saving,.setting.a
8c940 6e 64 20 61 64 64 69 6e 67 20 74 6f 20 68 69 73 74 6f 72 79 2e 20 20 23 39 36 0a 0a 2d 20 41 64 nd.adding.to.history...#96..-.Ad
8c960 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 72 69 67 68 74 20 70 61 64 64 69 6e 67 20 74 68 ded.support.for.right.padding.th
8c980 65 20 6b 65 79 73 20 6f 66 20 61 6c 6c 20 73 75 66 66 69 78 65 73 20 69 6e 20 61 20 67 72 6f 75 e.keys.of.all.suffixes.in.a.grou
8c9a0 70 2e 0a 20 20 54 68 69 73 20 69 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 75 73 69 6e 67 20 74 68 p....This.is.controlled.using.th
8c9c0 65 20 6e 65 77 20 7e 70 61 64 2d 6b 65 79 73 7e 20 73 6c 6f 74 20 6f 66 20 67 72 6f 75 70 20 6f e.new.~pad-keys~.slot.of.group.o
8c9e0 62 6a 65 63 74 73 2e 0a 20 20 37 35 30 32 33 39 30 62 2c 20 32 39 33 61 34 33 37 64 0a 0a 2d 20 bjects....7502390b,.293a437d..-.
8ca00 41 64 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 64 65 6c 61 79 69 6e 67 20 73 65 74 75 70 Added.support.for.delaying.setup
8ca20 20 6f 66 20 74 68 65 20 73 75 66 66 69 78 65 73 20 6f 66 20 61 20 70 72 65 66 69 78 20 75 6e 74 .of.the.suffixes.of.a.prefix.unt
8ca40 69 6c 0a 20 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 41 6c 73 6f 20 61 64 64 65 il...that.is.invoked...Also.adde
8ca60 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 75 73 69 6e 67 20 75 6e 6e 61 6d 65 64 20 66 75 6e 63 d.support.for.using.unnamed.func
8ca80 74 69 6f 6e 73 20 61 73 0a 20 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 61 6b tions.as...suffix.commands...Tak
8caa0 65 6e 20 74 6f 67 65 74 68 65 72 20 74 68 65 73 65 20 63 68 61 6e 67 65 73 20 6d 61 6b 65 20 69 en.together.these.changes.make.i
8cac0 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 0a 20 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 63 72 65 61 t.possible.to...dynamically.crea
8cae0 74 65 20 74 68 65 20 6c 69 73 74 20 6f 66 20 73 75 66 66 69 78 65 64 2e 20 20 53 65 65 20 74 68 te.the.list.of.suffixed...See.th
8cb00 65 20 7e 6e 6f 74 6d 75 63 68 2d 74 72 61 6e 73 69 65 6e 74 7e 0a 20 20 70 61 63 6b 61 67 65 20 e.~notmuch-transient~...package.
8cb20 66 6f 72 20 74 77 6f 20 65 78 61 6d 70 6c 65 73 3a 20 7e 6e 6f 74 6d 75 63 68 2d 73 65 61 72 63 for.two.examples:.~notmuch-searc
8cb40 68 2d 74 72 61 6e 73 69 65 6e 74 7e 20 61 6e 64 0a 20 20 7e 6e 6f 74 6d 75 63 68 2d 74 61 67 2d h-transient~.and...~notmuch-tag-
8cb60 74 72 61 6e 73 69 65 6e 74 7e 2e 20 20 66 32 32 35 32 64 35 33 2c 20 61 33 65 35 33 36 33 33 0a transient~...f2252d53,.a3e53633.
8cb80 0a 2d 20 41 64 64 65 64 20 74 68 65 20 69 6e 66 69 78 20 63 6c 61 73 73 20 7e 74 72 61 6e 73 69 .-.Added.the.infix.class.~transi
8cba0 65 6e 74 2d 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 7e 2e 20 20 32 64 38 63 65 66 66 34 0a 0a 2d ent-lisp-variable~...2d8ceff4..-
8cbc0 20 41 64 64 65 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 7e 2c 20 77 .Added.~transient-infix-read~,.w
8cbe0 68 69 63 68 20 61 6c 6c 6f 77 73 20 61 72 62 69 74 72 61 72 79 20 63 6f 6d 6d 61 6e 64 73 20 74 hich.allows.arbitrary.commands.t
8cc00 6f 20 72 65 61 64 0a 20 20 61 20 76 61 6c 75 65 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 o.read...a.value.the.same.way.as
8cc20 20 77 6f 75 6c 64 20 74 68 65 20 69 6e 66 69 78 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 69 73 .would.the.infix.command.that.is
8cc40 20 70 72 6f 76 69 64 65 64 20 61 73 0a 20 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 .provided.as...an.argument.to.th
8cc60 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 20 37 33 36 39 34 62 65 34 0a 0a 2d 20 41 64 64 65 64 20 is.function...73694be4..-.Added.
8cc80 73 75 70 70 6f 72 74 20 66 6f 72 20 63 6f 6c 6f 72 69 6e 67 20 73 75 66 66 69 78 65 73 20 69 6e support.for.coloring.suffixes.in
8cca0 20 61 20 48 79 64 72 61 2d 6c 69 6b 65 20 66 61 73 68 69 6f 6e 2e 0a 20 20 54 6f 20 65 6e 61 62 .a.Hydra-like.fashion....To.enab
8ccc0 6c 65 20 74 68 69 73 2c 20 63 75 73 74 6f 6d 69 7a 65 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 le.this,.customize.option.~trans
8cce0 69 65 6e 74 2d 73 65 6d 61 6e 74 69 63 2d 63 6f 6c 6f 72 69 6e 67 7e 2e 0a 20 20 32 34 38 38 36 ient-semantic-coloring~....24886
8cd00 32 63 35 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 64 69 73 61 62 6c 69 2c5..-.Added.support.for.disabli
8cd20 6e 67 20 61 6e 64 20 64 69 6d 6d 69 6e 67 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 ng.and.dimming.suffix.commands.t
8cd40 68 61 74 20 61 72 65 0a 20 20 63 75 72 72 65 6e 74 6c 79 20 6e 6f 74 20 73 75 69 74 61 62 6c 65 hat.are...currently.not.suitable
8cd60 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 63 6f 6d 70 6c 65 74 65 6c 79 20 68 69 64 69 6e 67 20 74 ,.instead.of.completely.hiding.t
8cd80 68 65 6d 2e 20 20 23 38 30 0a 0a 2d 20 41 75 74 6f 6c 6f 61 64 20 66 75 6e 63 74 69 6f 6e 73 20 hem...#80..-.Autoload.functions.
8cda0 74 68 61 74 20 73 65 72 76 65 20 61 20 70 75 72 70 6f 73 65 20 73 69 6d 69 6c 61 72 20 74 6f 20 that.serve.a.purpose.similar.to.
8cdc0 74 68 61 74 20 6f 66 0a 20 20 7e 64 65 66 69 6e 65 2d 6b 65 79 7e 2e 20 23 38 35 0a 0a 2d 20 43 that.of...~define-key~..#85..-.C
8cde0 6f 6e 73 69 73 74 65 6e 74 6c 79 20 75 73 65 20 7e 74 72 61 6e 73 69 65 6e 74 2d 7e 20 61 73 20 onsistently.use.~transient-~.as.
8ce00 74 68 65 20 70 72 65 66 69 78 20 6f 66 20 61 6c 6c 20 73 79 6d 62 6f 6c 73 2e 0a 20 20 54 68 65 the.prefix.of.all.symbols....The
8ce20 20 6f 6c 64 20 6e 61 6d 65 73 20 72 65 6d 61 69 6e 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 6f .old.names.remain.available.as.o
8ce40 62 73 6f 6c 65 74 65 20 61 6c 69 61 73 65 73 2e 20 20 64 64 30 63 34 34 63 62 0a 0a 2d 20 41 64 bsolete.aliases...dd0c44cb..-.Ad
8ce60 64 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 73 63 72 6f 6c 6c 69 6e 67 20 74 68 65 20 74 72 ded.support.for.scrolling.the.tr
8ce80 61 6e 73 69 65 6e 74 20 70 6f 70 75 70 20 62 75 66 66 65 72 20 75 73 69 6e 67 20 74 68 65 0a 20 ansient.popup.buffer.using.the..
8cea0 20 73 63 72 6f 6c 6c 20 62 61 72 2e 20 20 23 38 34 0a 0a 2d 20 56 61 72 69 6f 75 73 20 62 75 67 .scroll.bar...#84..-.Various.bug
8cec0 20 66 69 78 65 73 2e 0a 20 20 34 38 32 33 38 62 66 35 20 41 6c 6c 6f 77 20 69 6e 76 6f 6b 69 6e .fixes....48238bf5.Allow.invokin
8cee0 67 20 61 72 62 69 74 72 61 72 79 20 70 72 65 66 69 78 65 73 20 61 73 20 6e 6f 6e 2d 73 75 66 66 g.arbitrary.prefixes.as.non-suff
8cf00 69 78 65 73 0a 20 20 64 38 35 65 62 37 39 30 20 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 64 ixes...d85eb790.transient-read-d
8cf20 69 72 65 63 74 6f 72 79 3a 20 50 61 73 73 20 72 65 61 64 20 76 61 6c 75 65 20 74 68 72 6f 75 67 irectory:.Pass.read.value.throug
8cf40 68 20 66 69 6c 65 2d 6c 6f 63 61 6c 2d 6e 61 6d 65 0a 20 20 66 30 38 36 63 62 36 32 20 74 72 61 h.file-local-name...f086cb62.tra
8cf60 6e 73 69 65 6e 74 2d 2d 69 6e 73 65 72 74 2d 73 75 66 66 69 78 3a 20 41 6c 6c 6f 77 20 73 61 6d nsient--insert-suffix:.Allow.sam
8cf80 65 20 6b 65 79 20 77 69 74 68 20 64 69 66 66 65 72 65 6e 74 20 70 72 65 64 69 63 61 74 65 73 0a e.key.with.different.predicates.
8cfa0 20 20 64 35 35 35 64 32 36 30 20 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 64 65 73 63 ..d555d260.transient-format-desc
8cfc0 72 69 70 74 69 6f 6e 28 6c 69 73 70 2d 76 61 72 69 61 62 6c 65 29 3a 20 52 65 74 75 72 6e 20 73 ription(lisp-variable):.Return.s
8cfe0 74 72 69 6e 67 0a 20 20 30 64 37 39 63 63 66 61 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 61 72 73 tring...0d79ccfa.transient--pars
8d000 65 2d 73 75 66 66 69 78 3a 20 44 6f 6e 27 74 20 66 61 6c 6c 62 61 63 6b 20 74 6f 20 72 65 61 64 e-suffix:.Don't.fallback.to.read
8d020 2d 73 74 72 69 6e 67 20 66 6f 72 20 6f 70 74 69 6f 6e 73 0a 20 20 66 38 38 64 62 63 34 33 20 74 -string.for.options...f88dbc43.t
8d040 72 61 6e 73 69 65 6e 74 2d 73 75 66 66 69 78 2d 6f 62 6a 65 63 74 3a 20 53 75 70 70 6f 72 74 20 ransient-suffix-object:.Support.
8d060 61 6c 6c 20 73 75 66 66 69 78 65 73 0a 20 20 62 33 34 33 65 32 61 33 20 74 72 61 6e 73 69 65 6e all.suffixes...b343e2a3.transien
8d080 74 2d 69 6e 66 69 78 2d 72 65 61 64 3a 20 46 69 78 20 69 76 79 20 73 70 65 63 69 66 69 63 20 6b t-infix-read:.Fix.ivy.specific.k
8d0a0 6c 75 64 67 65 0a 20 20 35 35 62 61 64 31 39 35 20 74 72 61 6e 73 69 65 6e 74 2d 2d 70 70 2d 74 ludge...55bad195.transient--pp-t
8d0c0 6f 2d 66 69 6c 65 3a 20 42 75 67 66 69 78 0a 20 20 63 31 64 66 33 62 32 31 20 45 6e 73 75 72 65 o-file:.Bugfix...c1df3b21.Ensure
8d0e0 20 77 65 20 75 73 65 20 73 79 6d 62 6f 6c 73 20 69 6e 20 61 20 66 65 77 20 6d 6f 72 65 20 70 6c .we.use.symbols.in.a.few.more.pl
8d100 61 63 65 73 0a 20 20 37 36 39 66 61 34 33 38 20 74 72 61 6e 73 69 65 6e 74 2d 73 65 74 2d 6c 65 aces...769fa438.transient-set-le
8d120 76 65 6c 3a 20 46 69 78 20 65 64 67 65 2d 63 61 73 65 0a 20 20 38 38 64 39 33 35 63 37 20 74 72 vel:.Fix.edge-case...88d935c7.tr
8d140 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 3a 20 69 ansient-display-buffer-action:.i
8d160 6e 68 69 62 69 74 2d 73 61 6d 65 2d 77 69 6e 64 6f 77 20 62 79 20 64 65 66 61 75 6c 74 0a 0a 2a nhibit-same-window.by.default..*
8d180 20 76 30 2e 32 2e 30 20 20 20 20 32 30 32 30 2d 30 32 2d 32 36 0a 0a 2d 20 7e 74 72 61 6e 73 69 .v0.2.0....2020-02-26..-.~transi
8d1a0 65 6e 74 2d 61 72 67 73 7e 20 6d 75 73 74 20 6e 6f 77 20 62 65 20 63 61 6c 6c 65 64 20 77 69 74 ent-args~.must.now.be.called.wit
8d1c0 68 20 61 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e 64 0a 20 20 61 h.a.transient.prefix.command...a
8d1e0 73 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 74 20 69 73 20 6e 6f 77 20 74 68 65 20 6f 6e 6c 79 20 s.argument...It.is.now.the.only.
8d200 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 69 74 73 20 76 61 6c 75 65 20 6d 75 73 74 20 62 65 20 61 argument.and.its.value.must.be.a
8d220 0a 20 20 73 79 6d 62 6f 6c 20 6e 6f 77 2c 20 61 6e 20 6f 62 6a 65 63 74 20 69 73 20 6e 6f 20 6c ...symbol.now,.an.object.is.no.l
8d240 6f 6e 67 65 72 20 73 75 70 70 6f 72 74 65 64 2e 20 20 57 68 65 6e 20 74 68 69 73 20 63 6f 6d 6d onger.supported...When.this.comm
8d260 61 6e 64 0a 20 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 7e 63 75 72 72 65 6e 74 2d 74 72 and...does.not.match.~current-tr
8d280 61 6e 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 7e 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 ansient-command~,.then.this.func
8d2a0 74 69 6f 6e 20 6e 6f 77 0a 20 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 65 74 2c 20 73 61 76 65 tion.now...returns.the.set,.save
8d2c0 64 20 6f 72 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 20 20 30 33 31 32 62 39 33 2c 20 37 64 d.or.default.value...0312b93,.7d
8d2e0 30 64 62 32 38 2c 0a 20 20 64 33 33 66 65 35 61 2c 20 61 36 63 65 31 39 35 0a 0a 2d 20 4e 6f 20 0db28,...d33fe5a,.a6ce195..-.No.
8d300 6c 6f 6e 67 65 72 20 75 73 65 20 74 68 65 20 6c 61 73 74 20 68 69 73 74 6f 72 79 20 65 6c 65 6d longer.use.the.last.history.elem
8d320 65 6e 74 20 61 73 20 69 6e 69 74 69 61 6c 20 6d 69 6e 69 62 75 66 66 65 72 20 69 6e 70 75 74 0a ent.as.initial.minibuffer.input.
8d340 20 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41 64 64 65 64 20 6e 65 77 20 6f 70 74 69 6f 6e 20 ..by.default...Added.new.option.
8d360 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 77 69 74 68 2d 69 6e 69 74 69 61 6c 2d 69 6e 70 ~transient-read-with-initial-inp
8d380 75 74 7e 20 74 6f 0a 20 20 61 6c 6c 6f 77 20 75 73 65 72 73 20 74 6f 20 72 65 73 74 6f 72 65 20 ut~.to...allow.users.to.restore.
8d3a0 74 68 65 20 6f 6c 64 20 64 65 66 61 75 6c 74 2e 20 64 63 66 37 61 34 64 2c 20 35 64 65 63 63 36 the.old.default..dcf7a4d,.5decc6
8d3c0 65 0a 0a 2d 20 54 68 65 20 73 65 74 20 61 6e 64 20 73 61 76 65 64 20 76 61 6c 75 65 73 20 77 65 e..-.The.set.and.saved.values.we
8d3e0 72 65 20 6e 6f 74 20 61 6c 77 61 79 73 20 75 73 65 64 2e 20 20 23 36 38 0a 0a 2d 20 41 64 64 65 re.not.always.used...#68..-.Adde
8d400 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 69 6e 73 65 72 74 69 6e 67 20 61 6e 64 20 72 65 6d 6f d.support.for.inserting.and.remo
8d420 76 69 6e 67 20 67 72 6f 75 70 73 2e 20 20 23 33 36 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f ving.groups...#36..-.Added.suppo
8d440 72 74 20 66 6f 72 20 73 70 65 63 69 66 79 69 6e 67 20 77 68 65 72 65 20 74 6f 20 69 6e 73 65 72 rt.for.specifying.where.to.inser
8d460 74 20 65 6c 65 6d 65 6e 74 73 20 61 6e 64 20 67 72 6f 75 70 73 0a 20 20 75 73 69 6e 67 20 63 6f t.elements.and.groups...using.co
8d480 6f 72 64 69 6e 61 74 65 73 2e 20 20 23 32 36 0a 0a 2d 20 41 64 64 65 64 20 73 75 70 70 6f 72 74 ordinates...#26..-.Added.support
8d4a0 20 66 6f 72 20 6d 6f 76 69 6e 67 20 74 68 65 20 63 75 72 73 6f 72 20 69 6e 73 69 64 65 20 74 68 .for.moving.the.cursor.inside.th
8d4c0 65 20 74 72 61 6e 73 69 65 6e 74 20 70 6f 70 75 70 0a 20 20 62 75 66 66 65 72 20 75 73 69 6e 67 e.transient.popup...buffer.using
8d4e0 20 74 68 65 20 61 72 72 6f 77 20 6b 65 79 73 20 6f 72 20 49 73 65 61 72 63 68 2c 20 61 6e 64 20 .the.arrow.keys.or.Isearch,.and.
8d500 66 6f 72 20 69 6e 76 6f 6b 65 20 73 75 66 66 69 78 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 75 73 69 for.invoke.suffix...commands.usi
8d520 6e 67 20 52 45 54 20 6f 72 20 6d 6f 75 73 65 20 63 6c 69 63 6b 73 2e 20 20 55 6e 6c 69 6b 65 20 ng.RET.or.mouse.clicks...Unlike.
8d540 4d 61 67 69 74 2d 50 6f 70 75 70 2c 20 54 72 61 6e 73 69 65 6e 74 0a 20 20 64 6f 65 73 6e 27 74 Magit-Popup,.Transient...doesn't
8d560 20 6d 61 6b 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 6f 70 75 70 20 62 75 66 66 65 72 .make.the.transient.popup.buffer
8d580 20 74 68 65 20 63 75 72 72 65 6e 74 20 62 75 66 66 65 72 2e 20 20 54 68 69 73 0a 20 20 69 73 20 .the.current.buffer...This...is.
8d5a0 69 6d 70 6f 72 74 61 6e 74 20 77 68 65 6e 20 69 6e 76 6f 6b 69 6e 67 20 73 75 66 66 69 78 20 63 important.when.invoking.suffix.c
8d5c0 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 74 61 6b 65 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 ommands.that.take.the.current...
8d5e0 70 6f 73 69 74 69 6f 6e 20 69 6e 74 6f 20 61 63 63 6f 75 6e 74 2c 20 62 75 74 20 69 74 20 68 61 position.into.account,.but.it.ha
8d600 73 20 74 68 65 20 64 72 61 77 62 61 63 6b 20 74 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 20 67 65 s.the.drawback.that.we.do.not.ge
8d620 74 0a 20 20 74 68 65 73 65 20 66 65 61 74 75 72 65 73 20 66 6f 72 20 66 72 65 65 2e 20 20 42 65 t...these.features.for.free...Be
8d640 63 61 75 73 65 20 49 20 61 6c 73 6f 20 63 6f 6e 73 69 64 65 72 20 74 68 65 6d 20 75 6e 6e 65 63 cause.I.also.consider.them.unnec
8d660 65 73 73 61 72 79 0a 20 20 49 20 64 69 64 20 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 essary...I.did.not.implement.the
8d680 6d 20 69 6e 69 74 69 61 6c 6c 79 2e 20 20 54 75 72 6e 73 20 6f 75 74 20 71 75 69 74 65 20 61 20 m.initially...Turns.out.quite.a.
8d6a0 66 65 77 20 75 73 65 72 73 0a 20 20 73 74 72 6f 6e 67 6c 79 20 64 69 73 61 67 72 65 65 2e 20 20 few.users...strongly.disagree...
8d6c0 53 65 74 20 7e 74 72 61 6e 73 69 65 6e 74 2d 65 6e 61 62 6c 65 2d 70 6f 70 75 70 2d 6e 61 76 69 Set.~transient-enable-popup-navi
8d6e0 67 61 74 69 6f 6e 7e 20 74 6f 20 7e 74 7e 20 74 6f 0a 20 20 65 6e 61 62 6c 65 20 74 68 65 73 65 gation~.to.~t~.to...enable.these
8d700 20 66 65 61 74 75 72 65 73 2e 20 20 23 34 32 0a 0a 2d 20 45 78 70 6c 69 63 69 74 6c 79 20 73 75 .features...#42..-.Explicitly.su
8d720 70 70 6f 72 74 20 45 64 65 62 75 67 2e 20 20 50 72 65 76 69 6f 75 73 6c 79 20 77 68 65 6e 20 45 pport.Edebug...Previously.when.E
8d740 64 65 62 75 67 20 77 61 73 20 74 72 69 67 67 65 72 65 64 0a 20 20 77 68 69 6c 65 20 61 20 74 72 debug.was.triggered...while.a.tr
8d760 61 6e 73 69 65 6e 74 20 77 61 73 20 61 63 74 69 76 65 2c 20 74 68 65 6e 20 45 6d 61 63 73 20 65 ansient.was.active,.then.Emacs.e
8d780 6e 74 65 72 65 64 20 61 6e 20 75 6e 72 65 63 6f 76 65 72 61 62 6c 65 0a 20 20 73 74 61 74 65 2e ntered.an.unrecoverable...state.
8d7a0 20 20 23 31 39 0a 0a 2d 20 4e 6f 20 6c 6f 6e 67 65 72 20 61 74 74 65 6d 70 74 20 74 6f 20 64 69 ..#19..-.No.longer.attempt.to.di
8d7c0 73 70 6c 61 79 20 61 20 74 68 69 6e 20 6c 69 6e 65 20 69 6e 20 74 65 72 6d 63 61 70 20 66 72 61 splay.a.thin.line.in.termcap.fra
8d7e0 6d 65 73 2e 20 20 30 61 39 36 61 35 37 0a 0a 2d 20 57 6f 72 6b 20 61 72 6f 75 6e 64 20 73 6f 6d mes...0a96a57..-.Work.around.som
8d800 65 20 49 76 79 20 62 75 67 73 2f 69 6e 63 6f 6d 70 61 74 69 62 69 6c 69 74 69 65 73 2e 20 20 61 e.Ivy.bugs/incompatibilities...a
8d820 66 32 34 33 64 35 2c 20 66 65 64 37 61 62 31 0a 0a 2d 20 54 68 65 20 6e 65 77 20 6f 70 74 69 6f f243d5,.fed7ab1..-.The.new.optio
8d840 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 63 65 2d 66 69 78 65 64 2d 70 69 74 63 68 7e 20 n.~transient-force-fixed-pitch~.
8d860 61 6c 6c 6f 77 73 20 75 73 65 72 73 20 74 6f 20 75 73 65 20 61 0a 20 20 6d 6f 6e 6f 73 70 61 63 allows.users.to.use.a...monospac
8d880 65 64 20 66 6f 6e 74 20 69 6e 20 74 72 61 6e 73 69 65 6e 74 27 73 20 70 6f 70 75 70 20 62 75 66 ed.font.in.transient's.popup.buf
8d8a0 66 65 72 20 65 76 65 6e 20 69 66 20 74 68 65 79 20 75 73 65 20 61 0a 20 20 70 72 6f 70 6f 72 74 fer.even.if.they.use.a...proport
8d8c0 69 6f 6e 61 6c 20 66 6f 6e 74 20 66 6f 72 20 74 68 65 20 72 65 73 74 20 6f 66 20 45 6d 61 63 73 ional.font.for.the.rest.of.Emacs
8d8e0 2e 20 20 23 32 35 2c 20 23 36 37 0a 0a 2d 20 41 64 61 70 74 65 64 20 74 6f 20 62 61 63 6b 77 61 ...#25,.#67..-.Adapted.to.backwa
8d900 72 64 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 63 68 61 6e 67 65 73 20 69 6e 20 45 6d 61 63 73 rd.incompatible.changes.in.Emacs
8d920 20 32 37 20 74 68 61 74 20 70 72 65 76 65 6e 74 65 64 0a 20 20 66 61 63 65 73 20 66 72 6f 6d 20 .27.that.prevented...faces.from.
8d940 65 78 74 65 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 65 64 67 65 20 6f 66 20 74 68 65 20 77 69 6e extending.to.the.edge.of.the.win
8d960 64 6f 77 20 61 73 20 65 78 70 65 63 74 65 64 2e 20 20 63 31 61 65 31 65 65 0a 0a 2d 20 4e 6f 20 dow.as.expected...c1ae1ee..-.No.
8d980 6c 6f 6e 67 65 72 20 64 65 70 65 6e 64 20 6f 6e 20 64 61 73 68 20 28 6f 72 20 61 6e 79 20 6f 74 longer.depend.on.dash.(or.any.ot
8d9a0 68 65 72 20 74 68 69 72 64 2d 70 61 72 74 79 20 70 61 63 6b 61 67 65 29 2e 20 20 23 36 36 0a 0a her.third-party.package)...#66..
8d9c0 2d 20 57 68 65 6e 20 61 20 74 72 61 6e 73 69 65 6e 74 20 68 61 73 20 63 6f 6e 66 6c 69 63 74 69 -.When.a.transient.has.conflicti
8d9e0 6e 67 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 61 6e 64 20 54 72 61 6e 73 69 65 6e 74 20 69 73 ng.key.bindings.and.Transient.is
8da00 0a 20 20 63 6f 6e 66 69 67 75 72 65 20 74 6f 20 77 61 72 6e 20 61 62 6f 75 74 20 74 68 61 74 2c ...configure.to.warn.about.that,
8da20 20 74 68 65 6e 20 45 6d 61 63 73 20 65 6e 74 65 72 65 64 20 61 6e 20 75 6e 72 65 63 6f 76 65 72 .then.Emacs.entered.an.unrecover
8da40 61 62 6c 65 0a 20 20 73 74 61 74 65 20 69 6e 73 74 65 61 64 2e 20 20 37 35 64 65 31 66 30 0a 0a able...state.instead...75de1f0..
8da60 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 66 6f 72 6d 61 74 2d 76 61 6c 75 65 7e 20 6e 6f 77 20 73 -.~transient-format-value~.now.s
8da80 75 70 70 6f 72 74 73 20 6f 70 74 69 6f 6e 73 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65 20 76 61 upports.options.with.multiple.va
8daa0 6c 75 65 73 2e 0a 20 20 23 36 35 0a 0a 2d 20 52 65 6d 6f 76 69 6e 67 20 61 20 73 75 66 66 69 78 lues....#65..-.Removing.a.suffix
8dac0 20 62 61 73 65 64 20 6f 6e 20 69 74 73 20 70 6f 73 69 74 69 6f 6e 20 77 61 73 20 62 72 6f 6b 65 .based.on.its.position.was.broke
8dae0 6e 2e 20 20 34 31 63 62 66 34 39 0a 0a 2d 20 49 6e 20 6f 75 72 20 70 6f 70 75 70 20 62 75 66 66 n...41cbf49..-.In.our.popup.buff
8db00 65 72 73 20 64 69 73 61 62 6c 65 20 74 68 65 20 74 61 62 20 66 65 61 74 75 72 65 20 74 68 61 74 ers.disable.the.tab.feature.that
8db20 20 45 6d 61 63 73 20 32 37 0a 20 20 69 6e 74 72 6f 64 75 63 65 73 2e 20 20 23 36 32 0a 0a 2d 20 .Emacs.27...introduces...#62..-.
8db40 49 6e 73 65 72 74 69 6e 67 20 61 20 6e 65 77 20 73 75 66 66 69 78 20 6e 65 78 74 20 74 6f 20 61 Inserting.a.new.suffix.next.to.a
8db60 6e 6f 74 68 65 72 20 65 6e 64 65 64 20 75 70 20 72 65 70 6c 61 63 69 6e 67 20 74 68 65 20 6c 61 nother.ended.up.replacing.the.la
8db80 74 74 65 72 0a 20 20 69 6e 73 74 65 61 64 20 69 66 20 69 74 73 20 6b 65 79 20 62 69 6e 64 69 6e tter...instead.if.its.key.bindin
8dba0 67 20 77 61 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 73 75 66 66 69 78 20 6f 62 6a 65 g.was.defined.in.the.suffix.obje
8dbc0 63 74 2e 20 20 23 35 38 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 75 6e 64 65 66 69 6e 65 64 ct...#58..-.~transient-undefined
8dbe0 7e 20 6c 65 61 72 6e 65 64 20 74 6f 20 6d 61 6b 65 20 73 6f 6d 65 20 6e 6f 69 73 65 2e 20 20 23 ~.learned.to.make.some.noise...#
8dc00 35 37 0a 0a 2d 20 46 69 78 20 72 65 70 6c 61 63 69 6e 67 20 61 20 73 75 66 66 69 78 20 77 69 74 57..-.Fix.replacing.a.suffix.wit
8dc20 68 20 61 6e 6f 74 68 65 72 20 73 75 66 66 69 78 20 62 6f 75 6e 64 20 74 6f 20 74 68 65 20 73 61 h.another.suffix.bound.to.the.sa
8dc40 6d 65 20 6b 65 79 2e 0a 20 20 35 61 33 36 30 62 62 2c 20 34 63 65 31 38 36 38 0a 0a 2d 20 43 68 me.key....5a360bb,.4ce1868..-.Ch
8dc60 61 72 61 63 74 65 72 73 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 61 6c 6c 6f 77 65 64 20 61 aracters.are.no.longer.allowed.a
8dc80 73 20 70 73 65 75 64 6f 20 73 75 66 66 69 78 65 73 2e 20 20 54 6f 20 69 6e 73 65 72 74 20 61 0a s.pseudo.suffixes...To.insert.a.
8dca0 20 20 61 6e 20 65 6d 70 74 79 20 63 65 6c 6c 20 69 6e 74 6f 20 61 20 74 61 62 6c 65 20 75 73 65 ..an.empty.cell.into.a.table.use
8dcc0 20 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 69 6e 73 74 65 61 64 2e 20 20 37 31 36 38 .the.empty.string.instead...7168
8dce0 37 62 61 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 76 61 72 69 61 62 6c 65 20 7e 74 72 61 6e 73 7ba..-.Added.new.variable.~trans
8dd00 69 65 6e 74 2d 2d 62 75 66 66 65 72 2d 6e 61 6d 65 7e 2e 20 20 23 34 35 0a 0a 2d 20 53 6f 6d 65 ient--buffer-name~...#45..-.Some
8dd20 20 6d 69 73 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 61 74 20 61 66 66 65 63 74 73 20 68 .misconfiguration.that.affects.h
8dd40 6f 77 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 70 6f 70 75 70 20 62 75 66 66 65 72 0a 20 20 ow.the.transient.popup.buffer...
8dd60 69 73 20 64 69 73 70 6c 61 79 65 64 20 63 6f 75 6c 64 20 6c 65 61 64 20 74 6f 20 45 6d 61 63 73 is.displayed.could.lead.to.Emacs
8dd80 20 65 6e 74 65 72 69 6e 67 20 61 6e 20 75 6e 72 65 63 6f 76 65 72 61 62 6c 65 20 73 74 61 74 65 .entering.an.unrecoverable.state
8dda0 2e 0a 20 20 23 33 34 2c 20 23 34 34 0a 0a 2d 20 54 68 65 20 65 63 68 6f 20 61 72 65 61 20 69 73 ....#34,.#44..-.The.echo.area.is
8ddc0 20 6e 6f 77 20 63 6c 65 61 72 65 64 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 .now.cleared.when.the.transient.
8dde0 70 6f 70 75 70 20 62 75 66 66 65 72 20 69 73 0a 20 20 73 68 6f 77 6e 2e 20 20 61 66 64 66 31 66 popup.buffer.is...shown...afdf1f
8de00 30 0a 0a 2d 20 49 66 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 2d 70 6f 70 75 70 7e 20 69 0..-.If.~transient-show-popup~.i
8de20 73 20 30 20 6f 72 20 61 20 6e 65 67 61 74 69 76 65 20 6e 75 6d 62 65 72 2c 20 74 68 65 6e 20 6e s.0.or.a.negative.number,.then.n
8de40 6f 74 20 65 76 65 6e 0a 20 20 61 20 6f 6e 65 2d 6c 69 6e 65 20 73 75 6d 6d 61 72 79 20 69 73 20 ot.even...a.one-line.summary.is.
8de60 73 68 6f 77 6e 20 69 6e 69 74 69 61 6c 6c 79 2e 20 20 23 34 31 0a 0a 2d 20 41 64 64 65 64 20 6e shown.initially...#41..-.Added.n
8de80 65 77 20 66 75 6e 63 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 72 65 61 64 2d 64 69 72 65 ew.function.~transient-read-dire
8dea0 63 74 6f 72 79 7e 2e 20 20 61 38 37 63 62 32 63 0a 0a 2d 20 7e 64 65 66 69 6e 65 2d 74 72 61 6e ctory~...a87cb2c..-.~define-tran
8dec0 73 69 65 6e 74 2d 63 6f 6d 6d 61 6e 64 7e 20 6e 6f 77 20 73 75 70 70 6f 72 74 73 20 73 70 65 63 sient-command~.now.supports.spec
8dee0 69 66 79 69 6e 67 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 20 61 0a 20 20 73 75 66 66 69 78 20 75 ifying.the.level.of.a...suffix.u
8df00 73 69 6e 67 20 74 68 65 20 7e 3a 6c 65 76 65 6c 7e 20 6b 65 79 77 6f 72 64 20 61 72 67 75 6d 65 sing.the.~:level~.keyword.argume
8df20 6e 74 2e 20 20 36 35 30 36 63 66 64 0a 0a 2d 20 54 68 65 20 6d 6f 64 65 2d 72 65 6c 61 74 65 64 nt...6506cfd..-.The.mode-related
8df40 20 73 75 66 66 69 78 20 70 72 65 64 69 63 61 74 65 73 20 6e 6f 77 20 61 6c 73 6f 20 73 75 70 70 .suffix.predicates.now.also.supp
8df60 6f 72 74 20 61 20 6c 69 73 74 20 6f 66 20 6d 6f 64 65 73 0a 20 20 61 73 20 61 72 67 75 6d 65 6e ort.a.list.of.modes...as.argumen
8df80 74 20 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 6d 6f 64 65 20 61 t.in.addition.to.a.single.mode.a
8dfa0 73 20 62 65 66 6f 72 65 2e 20 20 31 63 36 61 66 62 38 0a 0a 2d 20 54 68 65 20 6e 65 77 20 7e 69 s.before...1c6afb8..-.The.new.~i
8dfc0 6e 63 6f 6d 70 61 74 69 62 6c 65 7e 20 73 6c 6f 74 20 6f 66 20 70 72 65 66 69 78 20 6f 62 6a 65 ncompatible~.slot.of.prefix.obje
8dfe0 63 74 73 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 0a 20 20 73 70 65 63 69 cts.makes.it.possible.to...speci
8e000 66 79 20 77 68 69 63 68 20 61 72 67 75 6d 65 6e 74 73 20 73 68 6f 75 6c 64 20 62 65 20 61 75 74 fy.which.arguments.should.be.aut
8e020 6f 61 74 69 63 61 6c 6c 79 20 64 69 73 61 62 6c 65 64 20 77 68 65 6e 20 74 68 65 0a 20 20 75 73 oatically.disabled.when.the...us
8e040 65 72 20 65 6e 61 62 6c 65 73 20 63 65 72 74 61 69 6e 20 6f 74 68 65 72 20 61 72 67 75 6d 65 6e er.enables.certain.other.argumen
8e060 74 73 2e 20 20 35 34 34 62 33 62 62 0a 0a 2d 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 68 69 73 74 ts...544b3bb..-.~transient--hist
8e080 6f 72 79 2d 70 75 73 68 7e 20 69 73 20 6e 6f 77 20 64 65 66 69 6e 65 64 20 61 73 20 67 65 6e 65 ory-push~.is.now.defined.as.gene
8e0a0 72 69 63 20 66 75 6e 63 74 69 6f 6e 2e 20 20 34 37 62 37 39 37 35 0a 0a 2d 20 54 68 65 20 61 20 ric.function...47b7975..-.The.a.
8e0c0 6e 65 77 20 7e 68 69 73 74 6f 72 79 2d 6b 65 79 7e 20 73 6c 6f 74 20 61 6e 64 20 7e 74 72 61 6e new.~history-key~.slot.and.~tran
8e0e0 73 69 65 6e 74 2d 2d 68 69 73 74 6f 72 79 2d 6b 65 79 7e 20 67 65 6e 65 72 69 63 0a 20 20 66 75 sient--history-key~.generic...fu
8e100 6e 63 74 69 6f 6e 20 66 6f 72 20 70 72 65 66 69 78 20 6f 62 6a 65 63 74 73 2e 20 20 33 36 36 38 nction.for.prefix.objects...3668
8e120 61 65 62 2c 20 65 36 32 37 64 34 35 0a 0a 2d 20 44 69 73 61 6c 6c 6f 77 20 73 65 74 74 69 6e 67 aeb,.e627d45..-.Disallow.setting
8e140 20 74 68 65 20 6c 65 76 65 6c 20 6f 66 20 65 73 73 65 6e 74 69 61 6c 20 73 75 66 66 69 78 65 73 .the.level.of.essential.suffixes
8e160 20 74 68 61 74 20 61 72 65 20 73 68 61 72 65 64 0a 20 20 62 65 74 77 65 65 6e 20 61 6c 6c 20 74 .that.are.shared...between.all.t
8e180 72 61 6e 73 69 65 6e 74 73 2e 20 20 23 32 39 0a 0a 2d 20 54 68 65 20 61 63 74 69 76 65 20 69 6e ransients...#29..-.The.active.in
8e1a0 66 69 78 20 69 73 20 6e 6f 77 20 68 69 67 68 6c 69 67 68 74 20 77 68 69 6c 65 20 72 65 61 64 69 fix.is.now.highlight.while.readi
8e1c0 6e 67 20 69 74 73 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 0a 20 20 75 73 65 72 2e 20 20 23 ng.its.value.from.the...user...#
8e1e0 33 30 0a 0a 2d 20 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 65 30..-.The.commands.~transient-se
8e200 74 7e 20 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 7e 20 63 61 6e 20 6e 6f 77 t~..and.~transient-save~.can.now
8e220 20 62 65 20 63 6f 6e 66 69 67 75 72 65 64 0a 20 20 74 6f 20 65 78 69 74 20 74 68 65 20 74 72 61 .be.configured...to.exit.the.tra
8e240 6e 73 69 65 6e 74 2c 20 74 68 6f 75 67 68 20 62 79 20 64 65 66 61 75 6c 74 20 74 68 65 79 20 73 nsient,.though.by.default.they.s
8e260 74 69 6c 6c 20 64 6f 6e 27 74 2e 20 20 61 34 37 61 65 39 34 0a 0a 2d 20 41 6c 77 61 79 73 20 72 till.don't...a47ae94..-.Always.r
8e280 65 73 70 65 63 74 20 74 68 65 20 7e 74 72 61 6e 73 69 65 6e 74 7e 20 73 6c 6f 74 20 6f 66 20 61 espect.the.~transient~.slot.of.a
8e2a0 20 73 75 66 66 69 78 2c 20 65 76 65 6e 20 69 66 20 74 68 61 74 20 73 75 66 66 69 78 0a 20 20 68 .suffix,.even.if.that.suffix...h
8e2c0 61 73 20 61 20 62 69 6e 64 69 6e 67 20 69 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 70 72 65 64 69 as.a.binding.in.~transient-predi
8e2e0 63 61 74 65 2d 6d 61 70 7e 2e 20 20 39 31 39 66 63 36 36 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 cate-map~...919fc66..-.Added.new
8e300 20 67 65 6e 65 72 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 65 .generic.functions.~transient-se
8e320 74 2d 76 61 6c 75 65 7e 20 61 6e 64 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 61 76 65 2d 76 t-value~.and...~transient-save-v
8e340 61 6c 75 65 7e 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 70 72 65 66 69 78 20 63 6f 6d 6d 61 6e alue~.intended.for.prefix.comman
8e360 64 73 2e 20 20 65 62 65 39 64 39 64 0a 0a 2d 20 49 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 ds...ebe9d9d..-.It.is.no.longer.
8e380 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 65 74 20 61 20 70 72 65 66 69 78 20 6c 65 76 65 6c 20 74 possible.to.set.a.prefix.level.t
8e3a0 6f 20 30 2c 20 77 68 69 63 68 20 69 73 20 61 6e 0a 20 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 o.0,.which.is.an...invalid.value
8e3c0 2e 20 20 23 32 38 0a 0a 2d 20 41 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 70 72 65 66 69 78 20 61 ...#28..-.All.transient.prefix.a
8e3e0 6e 64 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 77 20 61 75 74 6f 6d nd.suffix.commands.are.now.autom
8e400 61 74 69 63 61 6c 6c 79 0a 20 20 64 65 63 6c 61 72 65 64 20 74 6f 20 62 65 20 66 6f 72 20 69 6e atically...declared.to.be.for.in
8e420 74 65 72 61 63 74 69 76 65 20 75 73 65 20 6f 6e 6c 79 2e 20 20 61 36 32 39 35 66 61 0a 0a 2d 20 teractive.use.only...a6295fa..-.
8e440 49 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 61 64 Infix.arguments.are.no.longer.ad
8e460 64 65 64 20 74 6f 20 7e 63 6f 6d 6d 61 6e 64 2d 68 69 73 74 6f 72 79 7e 20 62 65 63 61 75 73 65 ded.to.~command-history~.because
8e480 0a 20 20 74 68 65 73 65 20 65 6e 74 72 69 65 73 20 77 65 72 65 20 62 6f 74 68 20 75 73 65 6c 65 ...these.entries.were.both.usele
8e4a0 73 73 20 61 6e 64 20 65 78 74 72 65 6d 65 6c 79 20 6e 6f 69 73 79 2e 20 20 23 32 33 0a 0a 2d 20 ss.and.extremely.noisy...#23..-.
8e4c0 7e 64 69 67 69 74 2d 61 72 67 75 6d 65 6e 74 7e 20 6e 6f 20 6c 6f 6e 67 65 72 20 65 78 69 74 73 ~digit-argument~.no.longer.exits
8e4e0 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 35 66 30 65 63 37 64 0a 0a 2d 20 41 20 6e 65 .the.transient...5f0ec7d..-.A.ne
8e500 77 20 6b 65 79 6d 61 70 2c 20 7e 74 72 61 6e 73 69 65 6e 74 2d 62 61 73 65 2d 6d 61 70 7e 20 77 w.keymap,.~transient-base-map~.w
8e520 61 73 20 61 64 64 65 64 20 74 6f 20 6d 61 6b 65 20 69 74 20 65 61 73 69 65 72 20 74 6f 0a 20 20 as.added.to.make.it.easier.to...
8e540 63 68 61 6e 67 65 20 6b 65 79 20 62 69 6e 64 69 6e 67 73 20 74 68 61 74 20 61 72 65 20 73 68 61 change.key.bindings.that.are.sha
8e560 72 65 64 20 62 65 74 77 65 65 6e 20 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 73 2e 20 20 54 68 69 red.between.all.transients...Thi
8e580 73 0a 20 20 6e 65 77 20 6b 65 79 6d 61 70 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 70 61 s...new.keymap.is.used.as.the.pa
8e5a0 72 65 6e 74 20 6f 66 20 61 6c 6c 20 74 68 65 20 6f 74 68 65 72 20 6b 65 79 6d 61 70 73 20 74 68 rent.of.all.the.other.keymaps.th
8e5c0 61 74 20 61 72 65 0a 20 20 73 68 61 72 65 64 20 62 65 74 77 65 65 6e 20 61 6c 6c 20 74 72 61 6e at.are...shared.between.all.tran
8e5e0 73 69 65 6e 74 73 2e 0a 0a 2d 20 41 64 64 65 64 20 6e 65 77 20 63 6f 6d 6d 61 6e 64 73 20 7e 74 sients...-.Added.new.commands.~t
8e600 72 61 6e 73 69 65 6e 74 2d 73 63 72 6f 6c 6c 2d 75 70 7e 20 61 6e 64 20 7e 74 72 61 6e 73 69 65 ransient-scroll-up~.and.~transie
8e620 6e 74 2d 73 63 72 6f 6c 6c 2d 64 6f 77 6e 7e 2c 0a 20 20 77 68 69 63 68 20 73 63 72 6f 6c 6c 20 nt-scroll-down~,...which.scroll.
8e640 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 69 6e 64 6f 77 2e 20 20 7e 43 2d 76 7e 20 61 6e 64 the.transient.window...~C-v~.and
8e660 20 7e 4d 2d 76 7e 20 28 61 6e 64 20 7e 3c 6e 65 78 74 3e 7e 20 61 6e 64 0a 20 20 7e 3c 70 72 69 .~M-v~.(and.~<next>~.and...~<pri
8e680 6f 72 3e 7e 29 20 61 72 65 20 62 6f 75 6e 64 20 74 6f 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 or>~).are.bound.to.these.command
8e6a0 73 2e 20 20 54 68 65 73 65 20 6b 65 79 73 20 77 65 72 65 20 63 68 6f 73 65 6e 20 74 68 65 79 0a s...These.keys.were.chosen.they.
8e6c0 20 20 61 72 65 20 62 6f 75 6e 64 20 74 6f 20 73 63 72 6f 6c 6c 69 6e 67 20 63 6f 6d 6d 61 6e 64 ..are.bound.to.scrolling.command
8e6e0 73 20 69 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 61 70 20 74 6f 6f 2e 20 20 54 68 69 73 20 6d s.in.the.global.map.too...This.m
8e700 61 64 65 0a 20 20 69 74 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 66 69 6e 64 20 61 20 6e 65 77 ade...it.necessary.to.find.a.new
8e720 20 62 69 6e 64 69 6e 67 20 66 6f 72 20 7e 74 72 61 6e 73 69 65 6e 74 2d 73 68 6f 77 7e 2c 20 77 .binding.for.~transient-show~,.w
8e740 68 69 63 68 20 7e 43 2d 74 7e 20 69 73 0a 20 20 62 6f 75 6e 64 20 74 6f 20 6e 6f 77 2e 20 20 23 hich.~C-t~.is...bound.to.now...#
8e760 31 37 0a 0a 2d 20 54 68 65 20 6e 65 77 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 65 6e 74 2d 17..-.The.new.option.~transient-
8e780 6d 6f 64 65 2d 6c 69 6e 65 2d 66 6f 72 6d 61 74 7e 20 61 6c 6c 6f 77 73 20 75 73 65 72 73 20 74 mode-line-format~.allows.users.t
8e7a0 6f 20 75 73 65 0a 20 20 61 20 6d 6f 64 65 2d 6c 69 6e 65 20 66 6f 72 20 74 68 65 20 74 72 61 6e o.use...a.mode-line.for.the.tran
8e7c0 73 69 65 6e 74 20 70 6f 70 75 70 20 62 75 66 66 65 72 20 69 6e 73 74 65 61 64 20 6f 66 20 6a 75 sient.popup.buffer.instead.of.ju
8e7e0 73 74 20 61 0a 20 20 74 68 69 6e 20 6c 69 6e 65 20 74 68 61 74 20 73 65 70 61 72 61 74 65 73 20 st.a...thin.line.that.separates.
8e800 69 74 20 66 72 6f 6d 20 74 68 65 20 65 63 68 6f 20 61 72 65 61 2e 20 20 57 68 65 6e 20 75 73 69 it.from.the.echo.area...When.usi
8e820 6e 67 20 61 0a 20 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 64 20 76 61 6c 75 65 20 66 6f 72 20 7e 74 ng.a...non-standard.value.for.~t
8e840 72 61 6e 73 69 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 7e 20 ransient-display-buffer-action~.
8e860 69 74 20 6d 61 79 0a 20 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 64 6f 20 74 68 61 74 it.may...be.necessary.to.do.that
8e880 2e 20 20 23 31 37 0a 0a 2d 20 54 68 65 20 6e 65 77 20 6f 70 74 69 6f 6e 20 7e 74 72 61 6e 73 69 ...#17..-.The.new.option.~transi
8e8a0 65 6e 74 2d 64 69 73 70 6c 61 79 2d 62 75 66 66 65 72 2d 61 63 74 69 6f 6e 7e 20 61 6c 6c 6f 77 ent-display-buffer-action~.allow
8e8c0 73 20 75 73 65 72 73 20 74 6f 0a 20 20 73 70 65 63 69 66 79 20 68 6f 77 20 61 20 77 69 6e 64 6f s.users.to...specify.how.a.windo
8e8e0 77 20 69 73 20 73 65 6c 65 63 74 65 64 20 74 6f 20 64 69 73 70 6c 61 79 20 74 68 65 20 74 72 61 w.is.selected.to.display.the.tra
8e900 6e 73 69 65 6e 74 20 70 6f 70 75 70 0a 20 20 62 75 66 66 65 72 2e 20 20 54 68 65 20 7e 6c 76 7e nsient.popup...buffer...The.~lv~
8e920 20 6c 69 62 72 61 72 79 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 73 65 64 2e 20 20 23 31 37 .library.is.no.longer.used...#17
8e940 0a 0a 2d 20 54 68 65 20 77 69 6e 64 6f 77 20 74 68 61 74 20 77 61 73 20 73 65 6c 65 63 74 65 64 ..-.The.window.that.was.selected
8e960 20 62 65 66 6f 72 65 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 77 69 6e 64 6f 77 20 77 61 73 .before.the.transient.window.was
8e980 20 73 68 6f 77 6e 0a 20 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 72 65 2d 73 65 6c 65 63 74 65 .shown...is.no.longer.re-selecte
8e9a0 64 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 61 20 73 75 66 66 69 78 20 74 68 61 74 20 65 d.before.calling.a.suffix.that.e
8e9c0 78 69 74 73 20 74 68 65 0a 20 20 74 72 61 6e 73 69 65 6e 74 2e 20 20 49 66 20 61 20 73 75 66 66 xits.the...transient...If.a.suff
8e9e0 69 78 20 63 68 61 6e 67 65 73 20 74 68 65 20 73 65 6c 65 63 74 65 64 20 77 69 6e 64 6f 77 20 75 ix.changes.the.selected.window.u
8ea00 6e 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 2c 0a 20 20 74 68 65 6e 20 74 68 61 74 20 69 73 20 61 nintentionally,...then.that.is.a
8ea20 20 62 75 67 2e 20 20 54 68 69 73 20 6d 61 6b 65 73 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f .bug...This.makes.it.possible.to
8ea40 20 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 20 63 68 61 6e 67 65 0a 20 20 74 68 65 20 77 69 6e 64 .intentionally.change...the.wind
8ea60 6f 77 20 6c 61 79 6f 75 74 20 75 73 69 6e 67 20 74 72 61 6e 73 69 65 6e 74 73 2e 0a 0a 2d 20 41 ow.layout.using.transients...-.A
8ea80 6e 20 69 6e 66 69 78 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 6b 69 6e 64 20 6f 66 20 73 75 66 n.infix.is.a.special.kind.of.suf
8eaa0 66 69 78 2e 20 20 44 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f 6e 74 65 78 74 0a 20 20 22 73 75 fix...Depending.on.context..."su
8eac0 66 66 69 78 65 73 22 20 6d 65 61 6e 73 20 22 73 75 66 66 69 78 65 73 20 28 69 6e 63 6c 75 64 69 ffixes".means."suffixes.(includi
8eae0 6e 67 20 69 6e 66 69 78 65 73 29 22 20 6f 72 20 22 6e 6f 6e 2d 69 6e 66 69 78 0a 20 20 73 75 66 ng.infixes)".or."non-infix...suf
8eb00 66 69 78 65 73 22 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 77 20 6d 65 6e 74 69 6f 6e 20 69 6e 20 fixes"...This.is.now.mention.in.
8eb20 61 20 66 65 77 20 70 6c 61 63 65 73 20 77 68 65 72 65 20 75 73 65 72 73 20 6d 69 67 68 74 0a 20 a.few.places.where.users.might..
8eb40 20 6f 74 68 65 72 77 69 73 65 20 67 65 74 20 63 6f 6e 66 75 73 65 64 2e 0a 0a 2d 20 53 74 6f 70 .otherwise.get.confused...-.Stop
8eb60 70 65 64 20 63 6c 61 69 6d 69 6e 67 20 74 68 61 74 20 74 68 65 20 74 72 61 6e 73 69 65 6e 74 20 ped.claiming.that.the.transient.
8eb80 69 73 20 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 22 65 63 68 6f 20 61 72 65 61 22 2c 0a 20 20 62 is.shown.in.the."echo.area",...b
8eba0 65 63 61 75 73 65 20 74 65 63 68 6e 69 63 61 6c 6c 79 20 74 68 61 74 20 69 73 20 6e 6f 74 20 63 ecause.technically.that.is.not.c
8ebc0 6f 72 72 65 63 74 2e 20 20 49 6e 73 74 65 61 64 20 74 61 6c 6b 20 61 62 6f 75 74 20 74 68 65 0a orrect...Instead.talk.about.the.
8ebe0 20 20 22 70 6f 70 75 70 20 62 75 66 66 65 72 22 2e 0a 0a 2d 20 46 69 78 65 64 20 68 61 6e 64 6c .."popup.buffer"...-.Fixed.handl
8ec00 69 6e 67 20 6f 66 20 73 75 66 66 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 61 72 65 20 ing.of.suffix.commands.that.are.
8ec20 75 6e 64 65 66 69 6e 65 64 20 61 74 20 74 68 65 20 74 69 6d 65 20 74 68 65 0a 20 20 70 72 65 66 undefined.at.the.time.the...pref
8ec40 69 78 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 54 68 69 73 20 69 73 20 73 74 69 6c 6c 20 61 6e ix.is.invoked...This.is.still.an
8ec60 20 65 72 72 6f 72 2c 20 62 75 74 20 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 0a 20 20 .error,.but.the.error.message...
8ec80 6e 6f 77 20 65 78 70 6c 61 69 6e 73 20 77 68 61 74 20 69 73 20 77 72 6f 6e 67 2e 20 20 61 37 32 now.explains.what.is.wrong...a72
8eca0 39 62 62 62 0a 0a 2d 20 46 69 78 65 64 20 73 61 76 69 6e 67 20 76 61 6c 75 65 73 2f 68 69 73 74 9bbb..-.Fixed.saving.values/hist
8ecc0 6f 72 79 2f 6c 65 76 65 6c 73 2c 20 6d 61 6b 69 6e 67 20 73 75 72 65 20 74 68 61 74 20 74 68 65 ory/levels,.making.sure.that.the
8ece0 20 70 72 69 6e 74 65 64 0a 20 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 6e 65 76 65 72 20 61 .printed...expression.is.never.a
8ed00 62 62 72 65 76 69 61 74 65 64 2e 20 20 23 31 35 0a 0a 2d 20 46 69 78 65 64 20 6a 75 6d 70 69 6e bbreviated...#15..-.Fixed.jumpin
8ed20 67 20 74 6f 20 74 68 65 20 63 6f 72 72 65 63 74 20 70 6c 61 63 65 20 69 6e 20 61 20 6d 61 6e 70 g.to.the.correct.place.in.a.manp
8ed40 61 67 65 20 77 68 65 6e 20 73 68 6f 77 69 6e 67 20 74 68 65 0a 20 20 64 6f 63 75 6d 65 6e 74 61 age.when.showing.the...documenta
8ed60 74 69 6f 6e 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 20 61 72 67 75 6d 65 6e 74 2e 20 20 63 34 62 tion.for.an.infix.argument...c4b
8ed80 66 34 61 66 0a 0a 2d 20 42 6f 75 6e 64 20 7e 45 53 43 20 45 53 43 20 45 53 43 7e 20 74 6f 20 7e f4af..-.Bound.~ESC.ESC.ESC~.to.~
8eda0 74 72 61 6e 73 69 65 6e 74 2d 71 75 69 74 2d 61 6c 6c 7e 20 62 65 63 61 75 73 65 20 74 68 65 20 transient-quit-all~.because.the.
8edc0 63 6f 6e 76 65 6e 74 69 6f 6e 20 69 73 0a 20 20 74 68 61 74 20 69 74 20 73 68 6f 75 6c 64 20 62 convention.is...that.it.should.b
8ede0 65 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 65 78 69 74 20 61 6e 79 20 74 65 6d 70 6f 72 61 72 79 e.possible.to.exit.any.temporary
8ee00 20 73 74 61 74 65 20 75 73 69 6e 67 20 74 68 69 73 0a 20 20 62 69 6e 64 69 6e 67 2e 20 20 23 31 .state.using.this...binding...#1
8ee20 32 0a 0a 2d 20 46 69 78 65 64 20 72 65 66 65 72 65 6e 63 69 6e 67 20 73 75 66 66 69 78 20 62 69 2..-.Fixed.referencing.suffix.bi
8ee40 6e 64 69 6e 67 73 20 62 79 20 74 68 65 69 72 20 6b 65 79 20 77 68 65 6e 20 74 68 65 20 6b 65 79 ndings.by.their.key.when.the.key
8ee60 20 62 69 6e 64 69 6e 67 0a 20 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 73 75 66 .binding...is.defined.in.the.suf
8ee80 66 69 78 20 6f 62 6a 65 63 74 20 69 6e 73 74 65 61 64 20 6f 66 20 69 6e 20 74 68 65 20 73 75 66 fix.object.instead.of.in.the.suf
8eea0 66 69 78 20 73 70 65 63 2e 0a 20 20 65 34 66 66 62 39 37 0a 0a 2d 20 52 65 6d 6f 76 65 20 74 72 fix.spec....e4ffb97..-.Remove.tr
8eec0 61 69 6c 69 6e 67 20 77 68 69 74 65 73 70 61 63 65 20 66 72 6f 6d 20 70 6f 70 75 70 20 74 65 78 ailing.whitespace.from.popup.tex
8eee0 74 20 66 6f 72 20 74 68 65 20 62 65 6e 65 66 69 74 20 6f 66 20 75 73 65 72 73 0a 20 20 77 68 6f t.for.the.benefit.of.users...who
8ef00 20 68 61 76 65 20 73 65 74 20 65 6e 61 62 6c 65 64 20 7e 73 68 6f 77 2d 74 72 61 69 6c 69 6e 67 .have.set.enabled.~show-trailing
8ef20 2d 77 68 69 74 65 73 70 61 63 65 7e 20 67 6c 6f 62 61 6c 6c 79 2e 20 20 30 37 35 38 65 66 61 0a -whitespace~.globally...0758efa.
8ef40 0a 2d 20 46 69 78 65 64 20 73 68 6f 77 69 6e 67 20 61 76 61 69 6c 61 62 6c 65 20 62 69 6e 64 69 .-.Fixed.showing.available.bindi
8ef60 6e 67 73 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 6c 69 6e 65 20 69 6e 73 74 65 61 64 20 6f 66 20 ngs.on.a.single.line.instead.of.
8ef80 75 73 69 6e 67 0a 20 20 74 68 65 20 75 73 75 61 6c 20 70 6f 70 75 70 20 62 75 66 66 65 72 2e 20 using...the.usual.popup.buffer..
8efa0 20 32 66 30 31 31 63 39 2c 20 39 39 64 33 62 66 36 0a 0a 2d 20 41 64 64 65 64 20 61 20 6c 69 6e .2f011c9,.99d3bf6..-.Added.a.lin
8efc0 65 20 62 65 74 77 65 65 6e 20 74 68 65 20 7e 6c 76 7e 20 77 69 6e 64 6f 77 20 61 6e 64 20 74 68 e.between.the.~lv~.window.and.th
8efe0 65 20 65 63 68 6f 20 61 72 65 61 2e 20 20 63 61 31 38 62 62 36 0a 0a 2d 20 46 69 78 65 64 20 61 e.echo.area...ca18bb6..-.Fixed.a
8f000 64 64 69 6e 67 20 61 20 6e 65 77 20 73 75 66 66 69 78 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 dding.a.new.suffix.at.the.end.of
8f020 20 61 20 67 72 6f 75 70 20 61 6e 64 20 72 65 6d 6f 76 69 6e 67 20 61 0a 20 20 67 72 6f 75 70 27 .a.group.and.removing.a...group'
8f040 73 20 6c 61 73 74 20 73 75 66 66 69 78 2e 20 20 23 32 30 2c 20 23 36 0a 0a 2d 20 4e 6f 20 6c 6f s.last.suffix...#20,.#6..-.No.lo
8f060 6e 67 65 72 20 75 73 65 20 7e 63 6c 2d 74 79 70 65 70 7e 2c 20 77 68 69 63 68 20 61 70 70 65 61 nger.use.~cl-typep~,.which.appea
8f080 72 73 20 74 6f 20 68 61 76 65 20 61 20 62 75 67 20 6f 6e 20 45 6d 61 63 73 20 32 35 2e 0a 20 20 rs.to.have.a.bug.on.Emacs.25....
8f0a0 39 31 38 33 66 65 31 0a 0a 2d 20 46 69 78 65 64 20 7e 6c 69 73 70 7e 20 6d 61 6b 65 20 74 61 72 9183fe1..-.Fixed.~lisp~.make.tar
8f0c0 67 65 74 2e 20 20 31 37 30 61 33 66 64 0a 0a 2d 20 46 69 78 65 64 20 72 65 61 64 69 6e 67 20 61 get...170a3fd..-.Fixed.reading.a
8f0e0 20 6e 75 6d 62 65 72 20 61 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 6e 20 69 6e 66 69 78 .number.as.the.value.of.an.infix
8f100 2e 20 20 38 32 31 39 63 30 62 0a 0a 2d 20 56 61 72 69 6f 75 73 20 62 75 67 20 66 69 78 65 73 20 ...8219c0b..-.Various.bug.fixes.
8f120 74 6f 0a 20 20 7e 74 72 61 6e 73 69 65 6e 74 2d 2d 67 6f 74 6f 2d 61 72 67 75 6d 65 6e 74 2d 64 to...~transient--goto-argument-d
8f140 65 73 63 72 69 70 74 69 6f 6e 7e 20 28 34 66 38 30 61 38 39 29 2c 0a 20 20 7e 74 72 61 6e 73 69 escription~.(4f80a89),...~transi
8f160 65 6e 74 2d 73 68 6f 77 2d 68 65 6c 70 7e 20 28 63 63 61 63 39 35 65 29 2c 0a 20 20 7e 74 72 61 ent-show-help~.(ccac95e),...~tra
8f180 6e 73 69 65 6e 74 2d 69 6e 66 69 78 2d 72 65 61 64 7e 20 28 37 62 66 39 37 35 39 29 2e 0a 0a 2a nsient-infix-read~.(7bf9759)...*
8f1a0 20 76 30 2e 31 2e 30 20 20 20 20 32 30 31 39 2d 30 31 2d 31 34 0a 0a 2d 20 46 69 72 73 74 20 72 .v0.1.0....2019-01-14..-.First.r
8f1c0 65 6c 65 61 73 65 2e 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 elease..........................
8f1e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f260 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f280 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f2a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f2c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f2e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f300 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f320 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f3a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f3c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f3e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f400 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f460 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f480 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f4a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f4c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f4e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f500 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f520 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f5a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f5c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f5e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f600 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f620 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f660 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f680 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f6a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f6c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f6e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f700 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f720 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f7a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f7c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f7e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f800 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f840 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f860 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f880 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f8a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f8c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f8e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f900 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f920 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f9a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f9c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8f9e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fa00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fa20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fa40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fa60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fa80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8faa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fb00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fb20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fb40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fb60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fb80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fbc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fbe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fc00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fc20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fc40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fc60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fc80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fcc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fd00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fd20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fd40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fd60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fd80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fda0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fdc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fde0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fe00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fe20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fe40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fe60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fe80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fea0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fec0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8fee0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ff00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ff20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ff40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ff60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ff80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ffa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ffc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
8ffe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
900a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
900c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
900e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
901a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
901c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
901e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90260 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90280 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
902a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
902c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
902e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90300 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90320 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90340 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90360 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90380 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
903a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
903c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
903e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90400 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90420 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90440 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90460 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90480 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
904a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
904c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
904e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90500 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90520 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90540 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90560 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90580 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
905a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
905c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
905e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90600 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90620 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90640 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90660 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90680 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
906a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
906c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
906e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90700 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90720 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90740 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90760 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90780 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
907a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
907c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
907e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90800 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90820 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90840 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90860 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90880 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
908a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
908c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
908e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90900 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90920 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90940 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90960 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90980 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
909a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
909c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
909e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90a00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90a20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90a40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90a60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90a80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90aa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ac0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ae0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90b00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90b20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90b40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90b60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90b80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ba0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90bc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90be0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90c00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90c20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90c40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90c60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90c80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ca0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90cc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ce0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90d00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90d20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90d40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90d60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90d80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90da0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90dc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90de0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90e00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90e20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90e40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90e60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90e80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ea0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ec0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90ee0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90f00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90f20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90f40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90f60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90f80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90fa0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90fc0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................
90fe0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................................