#acupoftea - accounting.gulfstore-gcc.com

System	:	Linux server1.ontime-gulf.com 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Wed Jun 5 09:12:13 EDT 2024 x86_64
Software	:	Apache
Server	:	162.0.230.206
Domains	:	40 Domain
Permission	:	[ drwxr-xr-x ]
	:	/ usr / share / vim / vim80 / doc /

216.73.216.5

Home

File usr_32.txt

*usr_32.txt*	For Vim version 8.0.  Last change: 2010 Jul 20

VIM USER MANUAL - by Bram Moolenaar

The undo tree

Vim provides multi-level undo.  If you undo a few changes and then make a new
change you create a branch in the undo tree.  This text is about moving
through the branches.

|32.1|	Undo up to a file write
|32.2|	Numbering changes
|32.3|	Jumping around the tree
|32.4|	Time travelling

==============================================================================
*32.1*	Undo up to a file write

Sometimes you make several changes, and then discover you want to go back to
when you have last written the file.  You can do that with this command: >

:earlier 1f

The "f" stands for "file" here.

You can repeat this command to go further back in the past.  Or use a count
different from 1 to go back faster.

If you go back too far, go forward again with: >

:later 1f

Note that these commands really work in time sequence.  This matters if you
made changes after undoing some changes.  It's explained in the next section.

Also note that we are talking about text writes here.  For writing the undo
information in a file see |undo-persistence|.

==============================================================================
*32.2*	Numbering changes

In section |02.5| we only discussed one line of undo/redo.  But it is also
possible to branch off.  This happens when you undo a few changes and then
make a new change.  The new changes become a branch in the undo tree.

Let's start with the text "one".  The first change to make is to append
" too".  And then move to the first 'o' and change it into 'w'.  We then have
two changes, numbered 1 and 2, and three states of the text:

one ~
		 |
	      change 1
		 |
	      one too ~
		 |
	      change 2
		 |
	      one two ~

If we now undo one change, back to "one too", and change "one" to "me" we
create a branch in the undo tree:

one ~
		 |
	      change 1
		 |
	      one too ~
	      /     \
	 change 2  change 3
	    |	      |
	 one two    me too ~

What matters here is the order in which the changes are made.  Undo and redo
are not considered changes in this context.  After each change you have a new
state of the text.

Note that only the changes are numbered, the text shown in the tree above has
no identifier.  They are mostly referred to by the number of the change above
it.  But sometimes by the number of one of the changes below it, especially
when moving up in the tree, so that you know which change was just undone.

==============================================================================
*32.3*	Jumping around the tree

So how do you get to "one two" now?  You can use this command: >

:undo 2

The text is now "one two", you are below change 2.  You can use the |:undo|
command to jump to below any change in the tree.

Now make another change: change "one" to "not":

Now you change your mind and want to go back to "me too".  Use the |g-|
command.  This moves back in time.  Thus it doesn't walk the tree upwards or
downwards, but goes to the change made before.

You can repeat |g-| and you will see the text change:
	me too ~
	one two ~
	one too ~
	one ~

Use |g+| to move forward in time:
	one ~
	one too ~
	one two ~
	me too ~
	not two ~

Using |:undo| is useful if you know what change you want to jump to.  |g-| and
|g+| are useful if you don't know exactly what the change number is.

You can type a count before |g-| and |g+| to repeat them.

==============================================================================
*32.4*	Time travelling

When you have been working on text for a while the tree grows to become big.
Then you may want to go to the text of some minutes ago.

To see what branches there are in the undo tree use this command: >

:undolist
<	number changes  time ~
	     3       2  16 seconds ago
	     4       3  5 seconds ago

Here you can see the number of the leaves in each branch and when the change
was made.  Assuming we are below change 4, at "not two", you can go back ten
seconds with this command: >

:earlier 10s

Depending on how much time you took for the changes you end up at a certain
position in the tree.  The |:earlier| command argument can be "m" for minutes,
"h" for hours and "d" for days.  To go all the way back use a big number: >

:earlier 100d

To travel forward in time again use the |:later| command: >

:later 1m

The arguments are "s", "m" and "h", just like with |:earlier|.

If you want even more details, or want to manipulate the information, you can
use the |undotree()| function.  To see what it returns: >

:echo undotree()

==============================================================================

Next chapter: |usr_40.txt|  Make new commands

Name	Type	Size	Permission	Last Modified	Actions
.	DIR	-	drwxr-xr-x	2025-10-13 10:57:17
..	DIR	-	drwxr-xr-x	2025-10-13 10:57:17
arabic.txt	text/plain	11.66 KB	-rw-r--r--	2025-10-12 12:23:12
autocmd.txt	text/plain	63.87 KB	-rw-r--r--	2025-10-12 12:23:12
change.txt	text/plain	73.12 KB	-rw-r--r--	2025-10-12 12:23:12
channel.txt	text/plain	30.1 KB	-rw-r--r--	2025-10-12 12:23:12
cmdline.txt	text/plain	46.17 KB	-rw-r--r--	2025-10-12 12:23:12
debug.txt	text/plain	7.01 KB	-rw-r--r--	2025-10-12 12:23:12
debugger.txt	text/plain	5.61 KB	-rw-r--r--	2025-10-12 12:23:12
develop.txt	text/plain	21.82 KB	-rw-r--r--	2025-10-12 12:23:12
diff.txt	text/plain	16.14 KB	-rw-r--r--	2025-10-12 12:23:12
digraph.txt	text/plain	60.67 KB	-rw-r--r--	2025-10-12 12:23:12
editing.txt	text/plain	71.46 KB	-rw-r--r--	2025-10-12 12:23:12
eval.txt	text/plain	434.04 KB	-rw-r--r--	2025-10-12 12:23:12
farsi.txt	text/plain	9.48 KB	-rw-r--r--	2025-10-12 12:23:12
filetype.txt	text/plain	25.33 KB	-rw-r--r--	2025-10-12 12:23:12
fold.txt	text/plain	23.14 KB	-rw-r--r--	2025-10-12 12:23:12
ft_ada.txt	text/plain	17.82 KB	-rw-r--r--	2025-10-12 12:23:12
ft_rust.txt	text/plain	9.3 KB	-rw-r--r--	2025-10-12 12:23:12
ft_sql.txt	text/plain	29.97 KB	-rw-r--r--	2025-10-12 12:23:12
gui.txt	text/plain	44.52 KB	-rw-r--r--	2025-10-12 12:23:12
gui_w32.txt	text/plain	18.47 KB	-rw-r--r--	2025-10-12 12:23:12
gui_x11.txt	text/plain	28.79 KB	-rw-r--r--	2025-10-12 12:23:12
hangulin.txt	text/plain	3.21 KB	-rw-r--r--	2025-10-12 12:23:12
hebrew.txt	text/plain	5.58 KB	-rw-r--r--	2025-10-12 12:23:12
help.txt	text/plain	8.38 KB	-rw-r--r--	2025-10-12 12:23:12
helphelp.txt	text/plain	14 KB	-rw-r--r--	2025-10-12 12:23:12
howto.txt	text/plain	2.84 KB	-rw-r--r--	2025-10-12 12:23:12
if_cscop.txt	text/plain	18.91 KB	-rw-r--r--	2025-10-12 12:23:12
if_lua.txt	text/plain	14.3 KB	-rw-r--r--	2025-10-12 12:23:12
if_mzsch.txt	text/plain	11.55 KB	-rw-r--r--	2025-10-12 12:23:12
if_ole.txt	text/plain	7.23 KB	-rw-r--r--	2025-10-12 12:23:12
if_perl.txt	text/plain	10.89 KB	-rw-r--r--	2025-10-12 12:23:12
if_pyth.txt	text/x-script.python	37.05 KB	-rw-r--r--	2025-10-12 12:23:12
if_ruby.txt	text/x-ruby	7.83 KB	-rw-r--r--	2025-10-12 12:23:12
if_sniff.txt	text/plain	266 B	-rw-r--r--	2025-10-12 12:23:12
if_tcl.txt	text/plain	22.49 KB	-rw-r--r--	2025-10-12 12:23:12
indent.txt	text/plain	38.5 KB	-rw-r--r--	2025-10-12 12:23:12
index.txt	text/plain	74.65 KB	-rw-r--r--	2025-10-12 12:23:12
insert.txt	text/plain	81.21 KB	-rw-r--r--	2025-10-12 12:23:12
intro.txt	text/plain	38.31 KB	-rw-r--r--	2025-10-12 12:23:12
map.txt	text/plain	63.15 KB	-rw-r--r--	2025-10-12 12:23:12
mbyte.txt	text/plain	57.92 KB	-rw-r--r--	2025-10-12 12:23:12
message.txt	text/plain	30.5 KB	-rw-r--r--	2025-10-12 12:23:12
mlang.txt	text/plain	7.67 KB	-rw-r--r--	2025-10-12 12:23:12
motion.txt	text/plain	50.39 KB	-rw-r--r--	2025-10-12 12:23:12
netbeans.txt	text/plain	36.13 KB	-rw-r--r--	2025-10-12 12:23:12
options.txt	text/plain	378.02 KB	-rw-r--r--	2025-10-12 12:23:12
os_390.txt	text/plain	4.64 KB	-rw-r--r--	2025-10-12 12:23:12
os_amiga.txt	text/plain	5.33 KB	-rw-r--r--	2025-10-12 12:23:12
os_beos.txt	text/plain	10.73 KB	-rw-r--r--	2025-10-12 12:23:12
os_dos.txt	text/plain	11.74 KB	-rw-r--r--	2025-10-12 12:23:12
os_mac.txt	text/plain	6.69 KB	-rw-r--r--	2025-10-12 12:23:12
os_mint.txt	text/plain	1.37 KB	-rw-r--r--	2025-10-12 12:23:12
os_msdos.txt	text/plain	518 B	-rw-r--r--	2025-10-12 12:23:12
os_os2.txt	text/plain	294 B	-rw-r--r--	2025-10-12 12:23:12
os_qnx.txt	text/plain	3.98 KB	-rw-r--r--	2025-10-12 12:23:12
os_risc.txt	text/plain	323 B	-rw-r--r--	2025-10-12 12:23:12
os_unix.txt	text/plain	2.53 KB	-rw-r--r--	2025-10-12 12:23:12
os_vms.txt	text/plain	31.35 KB	-rw-r--r--	2025-10-12 12:23:12
os_win32.txt	text/plain	13.04 KB	-rw-r--r--	2025-10-12 12:23:12
pattern.txt	text/plain	57.93 KB	-rw-r--r--	2025-10-12 12:23:12
pi_getscript.txt	text/plain	20.58 KB	-rw-r--r--	2025-10-12 12:23:12
pi_gzip.txt	text/plain	1.29 KB	-rw-r--r--	2025-10-12 12:23:12
pi_logipat.txt	text/plain	4.09 KB	-rw-r--r--	2025-10-12 12:23:12
pi_netrw.txt	text/plain	171.44 KB	-rw-r--r--	2025-10-12 12:23:12
pi_paren.txt	text/plain	2.22 KB	-rw-r--r--	2025-10-12 12:23:12
pi_spec.txt	text/plain	4.03 KB	-rw-r--r--	2025-10-12 12:23:12
pi_tar.txt	text/plain	6.08 KB	-rw-r--r--	2025-10-12 12:23:12
pi_vimball.txt	text/plain	11.58 KB	-rw-r--r--	2025-10-12 12:23:12
pi_zip.txt	text/plain	6.87 KB	-rw-r--r--	2025-10-12 12:23:12
print.txt	text/plain	30.43 KB	-rw-r--r--	2025-10-12 12:23:12
quickfix.txt	text/plain	67.4 KB	-rw-r--r--	2025-10-12 12:23:12
quickref.txt	text/plain	69.59 KB	-rw-r--r--	2025-10-12 12:23:12
quotes.txt	text/plain	12.44 KB	-rw-r--r--	2025-10-12 12:23:12
recover.txt	text/plain	10.44 KB	-rw-r--r--	2025-10-12 12:23:12
remote.txt	text/plain	8.22 KB	-rw-r--r--	2025-10-12 12:23:12
repeat.txt	text/plain	38.65 KB	-rw-r--r--	2025-10-12 12:23:12
rileft.txt	text/plain	4.86 KB	-rw-r--r--	2025-10-12 12:23:12
russian.txt	text/plain	3.02 KB	-rw-r--r--	2025-10-12 12:23:12
scroll.txt	text/plain	13.74 KB	-rw-r--r--	2025-10-12 12:23:12
sign.txt	text/plain	6.73 KB	-rw-r--r--	2025-10-12 12:23:12
spell.txt	text/plain	61.31 KB	-rw-r--r--	2025-10-12 12:23:12
sponsor.txt	text/plain	7.03 KB	-rw-r--r--	2025-10-12 12:23:12
starting.txt	text/plain	71.9 KB	-rw-r--r--	2025-10-12 12:23:12
syntax.txt	text/plain	212.37 KB	-rw-r--r--	2025-10-12 12:23:12
tabpage.txt	text/plain	16.33 KB	-rw-r--r--	2025-10-12 12:23:12
tags	text/plain	320.95 KB	-rw-r--r--	2025-10-12 12:23:12
tagsrch.txt	text/plain	35.78 KB	-rw-r--r--	2025-10-12 12:23:12
term.txt	text/plain	44.35 KB	-rw-r--r--	2025-10-12 12:23:12
terminal.txt	text/plain	32.78 KB	-rw-r--r--	2025-10-12 12:23:12
tips.txt	text/plain	20.07 KB	-rw-r--r--	2025-10-12 12:23:12
todo.txt	text/plain	289.32 KB	-rw-r--r--	2025-10-12 12:23:12
uganda.txt	text/plain	13.7 KB	-rw-r--r--	2025-10-12 12:23:12
undo.txt	text/plain	16.15 KB	-rw-r--r--	2025-10-12 12:23:12
usr_01.txt	text/plain	6.92 KB	-rw-r--r--	2025-10-12 12:23:12
usr_02.txt	text/plain	23.77 KB	-rw-r--r--	2025-10-12 12:23:12
usr_03.txt	text/plain	23.05 KB	-rw-r--r--	2025-10-12 12:23:12
usr_04.txt	text/plain	18.63 KB	-rw-r--r--	2025-10-12 12:23:12
usr_05.txt	text/plain	23.27 KB	-rw-r--r--	2025-10-12 12:23:12
usr_06.txt	text/plain	9.36 KB	-rw-r--r--	2025-10-12 12:23:12
usr_07.txt	text/plain	15.61 KB	-rw-r--r--	2025-10-12 12:23:12
usr_08.txt	text/plain	18.92 KB	-rw-r--r--	2025-10-12 12:23:12
usr_09.txt	text/plain	11.18 KB	-rw-r--r--	2025-10-12 12:23:12
usr_10.txt	text/plain	28.5 KB	-rw-r--r--	2025-10-12 12:23:12
usr_11.txt	text/plain	12.32 KB	-rw-r--r--	2025-10-12 12:23:12
usr_12.txt	text/plain	13.11 KB	-rw-r--r--	2025-10-12 12:23:12
usr_20.txt	text/plain	13.38 KB	-rw-r--r--	2025-10-12 12:23:12
usr_21.txt	text/plain	17.94 KB	-rw-r--r--	2025-10-12 12:23:12
usr_22.txt	text/plain	13.96 KB	-rw-r--r--	2025-10-12 12:23:12
usr_23.txt	text/plain	12.29 KB	-rw-r--r--	2025-10-12 12:23:12
usr_24.txt	text/plain	20.38 KB	-rw-r--r--	2025-10-12 12:23:12
usr_25.txt	text/plain	18.67 KB	-rw-r--r--	2025-10-12 12:23:12
usr_26.txt	text/plain	8.06 KB	-rw-r--r--	2025-10-12 12:23:12
usr_27.txt	text/plain	17.31 KB	-rw-r--r--	2025-10-12 12:23:12
usr_28.txt	text/plain	15.64 KB	-rw-r--r--	2025-10-12 12:23:12
usr_29.txt	text/plain	19.64 KB	-rw-r--r--	2025-10-12 12:23:12
usr_30.txt	text/x-c	22.13 KB	-rw-r--r--	2025-10-12 12:23:12
usr_31.txt	text/plain	10.15 KB	-rw-r--r--	2025-10-12 12:23:12
usr_32.txt	text/plain	5.25 KB	-rw-r--r--	2025-10-12 12:23:12
usr_40.txt	text/plain	22.64 KB	-rw-r--r--	2025-10-12 12:23:12
usr_41.txt	text/plain	87.21 KB	-rw-r--r--	2025-10-12 12:23:12
usr_42.txt	text/plain	13.47 KB	-rw-r--r--	2025-10-12 12:23:12
usr_43.txt	text/plain	7.23 KB	-rw-r--r--	2025-10-12 12:23:12
usr_44.txt	text/plain	28.53 KB	-rw-r--r--	2025-10-12 12:23:12
usr_45.txt	text/plain	17.49 KB	-rw-r--r--	2025-10-12 12:23:12
usr_90.txt	text/plain	17.25 KB	-rw-r--r--	2025-10-12 12:23:12
usr_toc.txt	text/plain	9 KB	-rw-r--r--	2025-10-12 12:23:12
various.txt	text/plain	28.18 KB	-rw-r--r--	2025-10-12 12:23:12
version4.txt	text/plain	13.58 KB	-rw-r--r--	2025-10-12 12:23:12
version5.txt	text/plain	301.31 KB	-rw-r--r--	2025-10-12 12:23:12
version6.txt	text/plain	563.53 KB	-rw-r--r--	2025-10-12 12:23:12
version7.txt	text/plain	658.95 KB	-rw-r--r--	2025-10-12 12:23:12
version8.txt	text/plain	668.21 KB	-rw-r--r--	2025-10-12 12:23:12
vi_diff.txt	text/plain	41.81 KB	-rw-r--r--	2025-10-12 12:23:12
visual.txt	text/plain	21.33 KB	-rw-r--r--	2025-10-12 12:23:12
windows.txt	text/plain	51.79 KB	-rw-r--r--	2025-10-12 12:23:12
workshop.txt	text/plain	4.52 KB	-rw-r--r--	2025-10-12 12:23:12

~ ACUPOFTEA - accounting.gulfstore-gcc.com