Blob


1 .TH ROVER 1 rover\-0.0.0
2 .SH NAME
3 rover \- file browser for the terminal
4 .SH SYNOPSIS
5 .B rover
6 [\fI\,DIRECTORY \/\fR[\fI\,DIRECTORY \/\fR[\fI\,DIRECTORY \/\fR[...]]]]
7 .br
8 .B rover
9 [\fI\,OPTION\/\fR]
10 .SH DESCRIPTION
11 Browse current working directory or the ones specified.
12 .SH OPTIONS
13 .TP
14 \fB\-h\fR, \fB\-\-help\fR
15 print help message and exit
16 .TP
17 \fB\-v\fR, \fB\-\-version\fR
18 print program version and exit
19 .SH ENVIRONMENT VARIABLES
20 .TP
21 .B HOME
22 Full path of the home directory.
23 .TP
24 .B PATH
25 Colon\-separated path list for program directories.
26 .TP
27 .B SHELL
28 Name of shell program (e.g. \fI\,/bin/sh\/\fP).
29 .TP
30 .B PAGER
31 Name of pager program (e.g. \fI\,less\/\fP).
32 .TP
33 .B EDITOR
34 Name of editor program (e.g. \fI\,vim\/\fP or \fI\,emacs\/\fP).
35 .SH EXAMPLES
36 .TP
37 Open current working directory on all tabs:
38 rover
39 .TP
40 Open a tab for directory \fI\,foo\/\fP and another for \fI\,bar\/\fP:
41 rover foo bar
42 .TP
43 Open one tab for each directory inside \fI\,/usr/\/\fP:
44 rover /usr/*/
45 .SH COMMANDS
46 .TP
47 .B q
48 Quit rover.
49 .TP
50 .B j/k
51 Move cursor down/up.
52 .TP
53 .B J/K
54 Move cursor down/up 10 lines.
55 .TP
56 .B l
57 Enter selected directory.
58 .TP
59 .B h
60 Go to parent directory.
61 .TP
62 .B H
63 Go to \fB$HOME\fR directory.
64 .TP
65 .B <RETURN>
66 Open \fB$SHELL\fR on the current directory.
67 .TP
68 .B <SPACE>
69 Open \fB$PAGER\fR with the selected file.
70 .TP
71 .B e
72 Open \fB$EDITOR\fR with the selected file.
73 .TP
74 .B /
75 Start incremental search (\fB<RETURN>\fR to finish).
76 .TP
77 .B f/d/s
78 Toggle file/directory/hidden listing.
79 .TP
80 .B n/N
81 Create new file/directory.
82 .TP
83 .B r
84 Rename selected file or directory.
85 .TP
86 .B m
87 Toggle mark on the selected entry.
88 .TP
89 .B M
90 Toggle mark on all visible entries.
91 .TP
92 .B a
93 Mark all visible entries.
94 .TP
95 .B X/C/V
96 Delete/copy/move all marked entries.
97 .TP
98 .B 0-9
99 Change tab.
100 .SH NOTES
101 .PP
102 \fBImportant\fR: Currently, Rover never asks for confirmation before overwriting
103 existing files while copying/moving marked entries. Please be careful to not
104 accidentally lose your data.
105 .PP
106 There are always exactly 10 tabs open, numbered from 0 to 9. The tab number 0
107 always start at $HOME. If more than nine directories are specified, only the
108 first nine are used for tabs 1\-9 and the rest is ignored. Tabs for which an
109 invalid path were assigned will also start at $HOME. Remaining tabs not
110 specified on the command line start at the current working directory.
111 .PP
112 Rover homepage: <https://github.com/lecram/rover>.