summary refs log tree commit diff stats
path: root/ranger/help/movement.py
diff options
context:
space:
mode:
Diffstat (limited to 'ranger/help/movement.py')
-rw-r--r--ranger/help/movement.py110
1 files changed, 73 insertions, 37 deletions
diff --git a/ranger/help/movement.py b/ranger/help/movement.py
index 52561359..2efbfdaa 100644
--- a/ranger/help/movement.py
+++ b/ranger/help/movement.py
@@ -1,64 +1,100 @@
 """
-1. Basic Movement With Ranger
+1. Basic movement and browsing
 
+1.1. Move around
+1.2. Browser control
+1.3. Searching
+1.4. Cycling
+
+==============================================================================
 1.1. Ranger has similar movement keys as vim:
 
-	k       move up
-	j       move down
-	h       move left (in browser: move one directory up)
-	l       move right (in browser: enter this directory, or run this file)
+	k	move up
+	j	move down
+	h	move left (in browser: move one directory up)
+	l	move right (in browser: enter this directory, or run this file)
 
-	K       move half the screen up
-	J       move half the screen down
-	H       in browser: move back in history
-	L       in browser: move forward in history
+	K	move half the screen up
+	J	move half the screen down
+	H	in browser: move back in history
+	L	in browser: move forward in history
 
-	gg      move to the top
-	G       move to the bottom
+	gg	move to the top
+	G	move to the bottom
+	%	move to the middle
 
 By prefixing a number, you can give more precise commands, eg:
 
-	2J      move 2 pages down
-	5gg     move to the 5th line
-	3h      move 3 characters to the left, or move 3 directories up
+	2J	move 2 pages down
+	5gg	move to the 5th line
+	3h	move 3 characters to the left, or move 3 directories up
+	30%	move to 30% of the screen
 
 Using arrow keys is equivalent of using h/j/k/l in most cases.
 An exception to this is the console, where you can move around with
 arrow keys and pressing letters will insert the letter into the console.
-----------------------------------------
-
-1.2. Special Keys
 
 Special keys like Home, Page Up,.. work as expected.
-The Enter key is equivalent to l except that files will be opened
-in "mode 1" instead of the default mode 0. (5?)
 
-These keys give you more movement control: (^X = Ctrl X)
+These keys work like in vim:
 
-	K, ^D   move half the screen up
-	J, ^U   move half the screen down
+	^D      move half the screen up
+	^U      move half the screen down
 	^B      move up by one screen
 	^F      move down by one screen
-----------------------------------------
 
-1.3. Cycling
+==============================================================================
+1.2. Browser control
+
+	?	view the help screen
+	^R	clear the cache and reload the view
+	^L	redraw the window
+	:	open the console |3?|
+
+	i	inspect the content of the file
+	E	edit the file
+	s	open a shell, starting in the current directory
+
+Marking files allows you to use operations on multiple files at once.
+If there are any marked files in this directory, "yy" will copy them instead
+of the file you're pointing at.
+
+	<Space> mark a file
+	v	toggle all marks
+	V	remove all marks
+
+By "tagging" files, you can highlight them and mark them to be
+special in whatever context you want.
+
+	b	tag/untag a file
+	B	untag a file
+
+==============================================================================
+1.3. Searching
 
-You can't only move up and down through the list, but also cycle through
-the items in different logical orders.
+Use "/" to open the search console. Enter a string and press <Enter> to
+search for it in all currently visible files. Pressing "n" will move you
+to the next occurance, "N" to the previous one.
 
-	/       open the "search console" and cycle through matches (3?)
-	TAB     cycle through tagged items
-	cc      cycle by ctime (last modification)
-	cm      cycle by mime type, connecting similar files
-	cs      cycle by size, large items first
+You can search for more than just strings:
+	TAB	search tagged files
+	cc	cycle through all files by their ctime (last modification)
+	cm	cycle by mime type, connecting similar files
+	cs	cycle by size, large items first
 
-	n       move to the next item
-	N       move to the previous item
+==============================================================================
+1.4. Sorting
 
-	See also: sorting (4?)
+To sort files, type "o" suffixed with a key that stands for a certain
+sorting mode. By typing any of those keys in upper case, the order will
+be reversed.
 
-Example:
+	os	sort by size
+	ob, on	sort by basename
+	om	sort by mtime (last modification)
+	ot	sort by mime type
+	or	reverse order
 
-	csnn    move to the third largest item
-----------------------------------------
+==============================================================================
 """
+# vim:tw=78:sw=4:sts=8:ts=8:ft=help