Skip to content

Commit 4a6c4f4

Browse files
committed
doc
1 parent 25ea03f commit 4a6c4f4

File tree

6 files changed

+37
-5
lines changed

6 files changed

+37
-5
lines changed

application/application.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ def respond_to_query(self,interface,query_description,secondary=False):
107107
if not secondary:
108108
update_origin(self.state,"origin",selection,mode)
109109
self.state["mode"] = "multiple" if mode else "single"
110-
if self.state["initial_count"]<view_information["change_count"] or s.initial_origin_force_update and not secondary:
110+
if (self.state["initial_count"]<view_information["change_count"] or s.initial_origin_force_update) and not secondary:
111111
self.state["initial_mode"] = "multiple" if mode else "single"
112112
self.state["initial_count"] = view_information["change_count"]
113113
update_origin(self.state,"initial_origin",selection,mode)

doc/Operations.md

Lines changed: 36 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -145,15 +145,15 @@ With
145145
![](./gif/op32.gif)
146146

147147

148-
As you can see, we can actually use non-plugging commands that move the cursor in between them and there's still no problem. The whole succession think breaks and the initial origin is reset only when there is change introduced.
148+
As you can see, we can actually use non-plugging commands that move the cursor in between them and there's still no problem. The whole succession thing breaks and the initial origin is reset only when there is change introduced.
149149

150150

151-
But it is very important to note that the initial origin does not automatically reset when there is change. It with only set off the next selection query. This is very important because it allows you to actually process text at some location you've jumped into and yet retain your point of origin to return to!
151+
But it is very important to note that the initial origin does not automatically reset when there is change. It will only reset after the next selection query. This is very important because it allows you to actually process text at some location you've jumped into and yet retain your point of origin to return to!
152152

153153

154154
![](./gif/op33.gif)
155155

156-
This is something that would become very important when we discuss prefix operations!
156+
This is something that will become very important when we discuss prefix operations!
157157

158158

159159

@@ -692,17 +692,49 @@ When we talked earlier about prefix operations, it was briefly mentioned that th
692692

693693
To illustrate this using the `edit` operation
694694

695-
![](./gif/op29.gif)
695+
![](./gif/op30.gif)
696+
697+
but I do emphasize on the `end of the day` ! All these are double queries consist of
698+
699+
* a selection query
700+
701+
* an operation command
702+
703+
and while one of those double commands is running, there exists a temporary state which
704+
705+
* the first selection query can modify as if everything was normal
706+
707+
* is passed to the operation command to work with
708+
709+
* is discarded later to maintain silence
696710

711+
If these sounds confusing, fear not! This is to ensure that the actions taken, whether selecting or inserting or removing text, do not differ from the two-step approach. Compare
697712

713+
![](./gif/op34.gif)
698714

715+
with
699716

717+
![](./gif/op35.gif)
700718

701719

720+
as you can see the actual actions taken are identical with either approach. What changes is with a one-step approach we still maintain our old initial origin to return back to! To convince you even further
702721

722+
![](./gif/op36.gif)
703723

704724

705725

726+
These of course does give us some extra flexibility and can power trickier workflows
727+
728+
![](./gif/op37.gif)
729+
730+
731+
and why not
732+
733+
![](./gif/op29.gif)
734+
735+
736+
or even the simple
706737

738+
![](./gif/op38.gif)
707739

708740

doc/gif/op34.gif

180 KB
Loading

doc/gif/op35.gif

138 KB
Loading

doc/gif/op36.gif

191 KB
Loading

doc/gif/op38.gif

115 KB
Loading

0 commit comments

Comments
 (0)