Blame


1 bd6a7481 2021-11-26 op .Dd $Mdocdate: November 26 2021$
2 bd6a7481 2021-11-26 op .Dt FM 1
3 bd6a7481 2021-11-26 op .Os
4 bd6a7481 2021-11-26 op .Sh NAME
5 bd6a7481 2021-11-26 op .Nm fm
6 bd6a7481 2021-11-26 op .Nd file manager
7 bd6a7481 2021-11-26 op .Sh SYNOPSIS
8 bd6a7481 2021-11-26 op .Nm
9 bd6a7481 2021-11-26 op .Bk -words
10 bd6a7481 2021-11-26 op .Op Fl hv
11 bd6a7481 2021-11-26 op .Op Fl d Ar file
12 bd6a7481 2021-11-26 op .Op Fl m Ar file
13 bd6a7481 2021-11-26 op .Op Ar directories...
14 bd6a7481 2021-11-26 op .Ek
15 bd6a7481 2021-11-26 op .Sh DESCRIPTION
16 bd6a7481 2021-11-26 op .Nm
17 bd6a7481 2021-11-26 op is an utility designed to browse the filesystem via a tabbed interface.
18 bd6a7481 2021-11-26 op .Pp
19 bd6a7481 2021-11-26 op The arguments are as follows:
20 bd6a7481 2021-11-26 op .Bl -tag -width 14m
21 bd6a7481 2021-11-26 op .It Fl d Ar file
22 bd6a7481 2021-11-26 op Write the last visited path to
23 bd6a7481 2021-11-26 op .Ar file
24 bd6a7481 2021-11-26 op before exiting.
25 bd6a7481 2021-11-26 op .It Fl h , Fl -help
26 bd6a7481 2021-11-26 op Print help message and exit.
27 bd6a7481 2021-11-26 op .It Fl m Ar file
28 bd6a7481 2021-11-26 op Write the path of all the marked entries to
29 bd6a7481 2021-11-26 op .Ar file
30 bd6a7481 2021-11-26 op upon exiting.
31 bd6a7481 2021-11-26 op .It Fl v , Fl -version
32 bd6a7481 2021-11-26 op Print program version and exit.
33 bd6a7481 2021-11-26 op .El
34 bd6a7481 2021-11-26 op .Pp
35 bd6a7481 2021-11-26 op In its most basic usage,
36 bd6a7481 2021-11-26 op .Nm
37 bd6a7481 2021-11-26 op will gather a list of directory entries and present it on the screen.
38 bd6a7481 2021-11-26 op There is always one
39 bd6a7481 2021-11-26 op .Pq and only one
40 bd6a7481 2021-11-26 op highlighted entry visible.
41 bd6a7481 2021-11-26 op This is both the cursor location and the current selection.
42 bd6a7481 2021-11-26 op .Pp
43 bd6a7481 2021-11-26 op It's also possible to select all the entries to be processed and apply
44 bd6a7481 2021-11-26 op the same command to all of them: this is called the mark.
45 bd6a7481 2021-11-26 op Unlike simple selection, the effect of marks is not constrained by
46 bd6a7481 2021-11-26 op visibility: marks are shared across all the tabs.
47 bd6a7481 2021-11-26 op For such purpose,
48 b86032aa 2021-11-26 op .Nm
49 bd6a7481 2021-11-26 op allows an arbitrary number fo entries to be marked, with the only
50 bd6a7481 2021-11-26 op limitation that they must be all in the same directory.
51 bd6a7481 2021-11-26 op .Pp
52 bd6a7481 2021-11-26 op There are ten tabs in total, numbered from 0 to 9, but only one tab is
53 bd6a7481 2021-11-26 op visible on the screen at any given moment.
54 bd6a7481 2021-11-26 op The number associated with the current tab is visible on the right corner
55 bd6a7481 2021-11-26 op of the screen.
56 bd6a7481 2021-11-26 op It's possible to set the current working directory for the tabs at start
57 bd6a7481 2021-11-26 op up by passing the desired paths as extra command-line arguments.
58 bd6a7481 2021-11-26 op The tab at index 0 always starts at
59 bd6a7481 2021-11-26 op .Ev $HOME .
60 bd6a7481 2021-11-26 op If more than nine directories are specified, the extra ones will be
61 bd6a7481 2021-11-26 op silently discarded.
62 bd6a7481 2021-11-26 op Tabs for wich an invalid path was assigned will also start at
63 bd6a7481 2021-11-26 op .Ev $HOME .
64 bd6a7481 2021-11-26 op By default tabs starts at the current working directory.
65 bd6a7481 2021-11-26 op .Sh SEE ALSO
66 bd6a7481 2021-11-26 op .Xr mc 1 ,
67 bd6a7481 2021-11-26 op .Xr nnn 1 ,
68 bd6a7481 2021-11-26 op .Xr noice 1 ,
69 bd6a7481 2021-11-26 op .Xr ranger 1 ,
70 bd6a7481 2021-11-26 op .Xr rover 1 ,
71 b86032aa 2021-11-26 op .Xr vifm 1
72 bd6a7481 2021-11-26 op .Sh HISTORY
73 bd6a7481 2021-11-26 op .Nm
74 bd6a7481 2021-11-26 op was forked from
75 bd6a7481 2021-11-26 op .Xr rover 1 .
76 bd6a7481 2021-11-26 op .Sh CAVEATS
77 bd6a7481 2021-11-26 op .Nm
78 bd6a7481 2021-11-26 op never asks for confirmation before overwriting existing files.
79 bd6a7481 2021-11-26 op Please be careful.