@@ -34,6 +34,10 @@ The commit to start from. Defaults to HEAD.
3434The path to the file you want to examine. The file must be tracked by Git.
3535.RE
3636.SH "COMMANDS"
37+ .SS "Navigating around the file"
38+ .PP
39+ Most navigation commands can be prefixed with the number of times they should
40+ be executed, for example "3j" moves down by three lines.
3741.PP
3842RETURN or DOWN or j or e
3943.RS 4
@@ -72,5 +76,70 @@ Move to the bottom of the file.
7276.PP
7377HOME or G or <
7478.RS 4
75- move to the top of the file.
79+ Move to the top of the file.
80+ .RE
81+ .PP
82+ <n> RETURN
83+ .RS 4
84+ Jumps to line <n>, for example pressing "4" and then "RETURN" jumps to line
85+ 4 of the file.
86+ .RE
87+
88+ .SS "Navigating Git history"
89+ .PP
90+ Git navigation commands can be prefixed with the number of times they should
91+ be executed, for example "3]" moves forward by three commits.
92+ .PP
93+ When moving through history the selected line will be preserved, even if
94+ lines are added or removed before it.
95+ .PP
96+ [
97+ .RS 4
98+ Move to the previous commit that changed the selected file.
99+ .RE
100+ .PP
101+ ]
102+ .RS 4
103+ Move to the next commit that changed the selected file.
104+ .RE
105+
106+ .SS "Searching"
107+ .PP
108+ /string
109+ .RS 4
110+ Search forwards through the file for the next line containing the string. All
111+ matches will be highlighted, and the selection will jump to the next line
112+ containing a match.
113+ .RE
114+ .PP
115+ ?string
116+ .RS 4
117+ Search backwards through the file for the next line containing the string. All
118+ matches will be highlighted, and the selection will jump to the next line
119+ containing a match.
120+ .RE
121+ .PP
122+ n
123+ .RS 4
124+ Jump to the next match for the latest search. The direction of the search is
125+ respected; if you searched using / the next match means moving down the file,
126+ but if you searched using ? the next match means moving up the file.
127+ .RE
128+ .PP
129+ N
130+ .RS 4
131+ Jump to the previous match for the latest search. As with the "n" command,
132+ the direction of the search is respected.
133+ .RE
134+
135+ .SS "Quitting"
136+ .PP
137+ q or Q
138+ .RS 4
139+ Quit.
140+ .RE
141+ .PP
142+ s
143+ .RS 4
144+ Quit, and run \fB git-show \fR (1) for the currently selected commit.
76145.RE
0 commit comments