forked from MidnightCommander/mc
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmc.1.in
4406 lines (4362 loc) · 130 KB
/
mc.1.in
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
.\" -*- mode: troff; coding: UTF-8 -*-
.\"TOPICS "Topics:"
.TH MC 1 "%DATE_OF_MAN_PAGE%" "MC Version %DISTR_VERSION%" "GNU Midnight Commander"
.\"SKIP_SECTION"
.SH "NAME"
mc \- Visual shell for Unix\-like systems.
.\"SKIP_SECTION"
.SH "SYNOPSIS"
.B mc
[\-abcCdfhPstuUVx] [\-l log] [dir1 [dir2]] [\-e [file] ...] [\-v file]
.\"NODE "DESCRIPTION"
.SH "DESCRIPTION"
GNU Midnight Commander is a directory browser/file manager for
Unix\-like operating systems.
.\"NODE "OPTIONS"
.\"DONT_SPLIT"
.SH "OPTIONS"
.TP
.I \-a, \-\-stickchars
Disable usage of graphic characters for line drawing.
.TP
.I \-b, \-\-nocolor
Force black and white display.
.TP
.I \-c, \-\-color
Force color mode, please check the section
.\"LINK2"
Colors
.\"Colors"
for more information.
.TP
.I \-C arg, \-\-colors=arg
Specify a different color set in the command line. The format of arg is
documented in the
.\"LINK2"
Colors
.\"Colors"
section.
.TP
.I \-\-configure\-options
Display configure options.
.TP
.I \-d, \-\-nomouse
Disable mouse support.
.TP
.I \-D N, \-\-debuglevel=N
Save the debug level for SMB VFS. N is in 0\-10 range.
.TP
.I \-e [file], \-\-edit[=file]
Start the internal editor. If the file is specified, open it on
startup. See also
.BR "mcedit (1)" .
.TP
.I \-f, \-\-datadir
Display the compiled\-in search paths for Midnight Commander files.
.TP
.I \-F, \-\-datadir\-info
Display extended info about compiled\-in paths for
Midnight Commander.
.TP
.I \-g, \-\-oldmouse
Force a "normal tracking" mouse mode. Used when running on
xterm\-capable terminals (tmux/screen).
.TP
.I \-k, \-\-resetsoft
Reset softkeys to their default from the termcap/terminfo
database. Only useful on HP terminals when the function keys don't work.
.TP
.I \-K file, \-\-keymap=file
Specify a name of keymap file in the command line.
.TP
.I \-l file, \-\-ftplog=file
Save the ftpfs dialog with the server in file.
.TP
.I \-\-nokeymap
Don't load key bindings from any file, use default hardcoded keys.
.TP
.I \-P file, \-\-printwd=file
Print the last working directory to the specified file. This option is
not meant to be used directly. Instead, it's used from a special shell
script that automatically changes the current directory of the shell to
the last directory Midnight Commander was in. Source the file
.B %libexecdir%/mc/mc.sh
(bash and zsh users) or
.B %libexecdir%/mc.csh
(tcsh users) respectively to define
.B mc
as an alias to the appropriate shell script.
.TP
.I \-s, \-\-slow
Turn on the slow terminal mode, in this mode the program will not draw
expensive line drawing characters and will toggle verbose mode off.
.TP
.I \-S arg, \-\-skin=arg
Specify a name of skin in the command line. Technology of skins is
documented in the
.\"LINK2"
Skins
.\"Skins"
section.
.TP
.I \-t, \-\-termcap
Used only if the code was compiled with S\-Lang and terminfo: it makes
Midnight Commander use the value of the
.B TERMCAP
variable for the terminal information instead of the information on
the system wide terminal database
.TP
.I \-u, \-\-nosubshell
Disable use of the concurrent shell (only makes sense if Midnight
Commander has been built with concurrent shell support).
.TP
.I \-U, \-\-subshell
Enable use of the concurrent shell support (only makes sense if the
Midnight Commander was built with the subshell support set as an
optional feature).
.TP
.I \-v file, \-\-view=file
Start the internal viewer to view the specified file. See also
.BR "mcview (1)" .
.TP
.I \-V, \-\-version
Display the version of the program.
.TP
.I \-x, \-\-xterm
Force xterm mode. Used when running on xterm\-capable terminals (two
screen modes, and able to send mouse escape sequences).
.TP
.I \-X, \-\-no\-x11
Do not use X11 to get the state of modifiers Alt, Ctrl, Shift
.PP
If both paths are specified, the first path name is the directory to show
in the active panel; the second path name is the directory to be shown in
the other panel.
.PP
If one path is specified, the path name is the directory to show
in the active panel; value of "other_dir" from panels.ini is the directory
to be shown in the passive panel.
.PP
If no paths are specified, current directory is shown in the active panel;
value of "other_dir" from panels.ini is the directory to be shown in
the passive panel.
.\"NODE "Overview"
.SH "Overview"
The screen of Midnight Commander is divided into four parts.
Almost all of the screen space is taken up by two directory panels.
By default, the second line from the bottom of the screen is the
shell command line, and the bottom line shows the function key labels.
The topmost line is the
.\"LINK2"
menu bar line\&.
.\"Menu Bar"
The menu bar line may not be visible, but appears if you click the
topmost line with the mouse or press the F9 key.
.PP
Midnight Commander provides a view of two directories at the same
time. One of the panels is the current panel (a selection bar is in
the current panel). Almost all operations take place on the current
panel. Some file operations like Rename and Copy by default use the
directory of the unselected panel as a destination (don't worry, they
always ask you for confirmation first). For more information, see the
sections on the
.\"LINK2"
Directory Panels\&,
.\"Directory Panels"
the
.\"LINK2"
Left and Right Menus
.\"Left and Right Menus"
and the
.\"LINK2"
File Menu\&.
.\"File Menu"
.PP
You can execute system commands from Midnight Commander by simply
typing them. Everything you type will appear on the shell command line,
and when you press Enter, Midnight Commander will execute the
command line you typed; read the
.\"LINK2"
Shell Command Line
.\"Shell Command Line"
and
.\"LINK2"
Input Line Keys
.\"Input Line Keys"
sections to learn more about the command line.
.\"NODE "Mouse Support"
.SH "Mouse Support"
Midnight Commander comes with mouse support. It is activated
whenever you are running on an
.B xterm(1)
terminal (it even works if you take a telnet, ssh or rlogin connection to
another machine from the xterm) or if you are running on a Linux
console and have the
.B gpm
mouse server running.
.PP
When you left click on a file in the directory panels, that file is
selected; if you click with the right button, the file is marked (or
unmarked, depending on the previous state).
.PP
Double\-clicking on a file will try to execute the command if it is
an executable program; and if the
.\"LINK2"
extension file
.\"Edit Extension File"
has a program specified for the file's extension, the specified
program is executed.
.PP
Also, it is possible to execute the commands assigned to the function
key labels by clicking on them.
.PP
The default auto repeat rate for the mouse buttons is 400
milliseconds. This may be changed to other values by editing the
.\"LINK2"
\&~/.config/mc/ini
.\"Save Setup"
file and changing the
.I mouse_repeat_rate
parameter.
.PP
If you are running Midnight Commander with the mouse support, you
can get the default mouse behavior (cutting and pasting text) by holding
down the Shift key.
.SH ""
.\"NODE "Keys"
.SH "Keys"
Some commands in Midnight Commander involve the use of the
.I Control
(sometimes labeled CTRL or CTL) and the
.I Meta
(sometimes labeled ALT or even Compose) keys. In this manual we will
use the following abbreviations:
.TP
.B C\-<chr>
means hold the Control key while typing the character <chr>.
Thus C\-f would be: hold the Control key and type f.
.TP
.B Alt\-<chr>
means hold the Meta or Alt key down while typing <chr>.
If there is no Meta or Alt key, type
.IR Esc ,
release it, then type the character <chr>.
.TP
.B S\-<chr>
means hold the Shift key down while typing <chr>.
.PP
All input lines in Midnight Commander use an approximation to
the GNU Emacs editor's key bindings (default).
.PP
You may redefine key bindings. See
.\"LINK2"
.I redefine hotkey bindings
.\"Keys_redefine"
.PP
for more info. All other key bindings (described in this manual) are relative
to default behavior.
.PP
There are many sections which tell about the keys. The following are
the most important.
.PP
The
.\"LINK2"
File Menu
.\"File Menu"
section documents the keyboard shortcuts for the commands appearing in
the File menu. This section includes the function keys. Most of these
commands perform some action, usually on the selected file or the
tagged files.
.PP
The
.\"LINK2"
Directory Panels
.\"Directory Panels"
section documents the keys which select a file or tag files as a
target for a later action (the action is usually one from the file
menu).
.PP
The
.\"LINK2"
Shell Command Line
.\"Shell Command Line"
section list the keys which are used for entering and editing command
lines. Most of these copy file names and such from the directory
panels to the command line (to avoid excessive typing) or access the
command line history.
.PP
.\"LINK2"
Input Line Keys
.\"Input Line Keys"
are used for editing input lines. This means both the command line and
the input lines in the query dialogs.
.\"NODE " Keys_redefine"
.SH " Redefine hotkey bindings"
Hotkey bindings may be read from external file (keymap\-file).
Initially, Midnight Commander creates key bindings using keymap defined
in the source code. Then, two files
.B %prefix%/share/mc/mc.keymap
and
.B %sysconfdir%/mc/mc.keymap
are loaded always, sequentially reassigned key bindings defined earlier.
User\-defined keymap\-file is searched on the following algorithm (to the first one found):
.IP
.br
1) command line option
.B \-K <keymap>
or
.B \-\-keymap=<keymap>
.br
2) Environment variable
.B MC_KEYMAP
.br
3) Parameter
.B keymap
in section
.B [Midnight\-Commander]
of config file.
.br
4) File
.B ~/.config/mc/mc.keymap
.br
.PP
Command line option, environment variable and parameter in config file may
contain the absolute path to the keymap\-file (with the extension \.keymap
or without it). Search of keymap\-file will occur in (to the first one found):
.IP
.br
1)
.B ~/.config/mc
.br
2)
.B %sysconfdir%/mc/
.br
3)
.B %prefix%/share/mc/
.\"NODE " Miscellaneous Keys"
.SH " Miscellaneous Keys"
Here are some keys which don't fall into any of the other categories:
.TP
.B Enter
if there is some text in the command line (the one at the bottom of
the panels), then that command is executed. If there is no text in the
command line then if the selection bar is over a directory the
Midnight Commander does a
.B chdir(2)
to the selected directory and reloads the information on the panel;
if the selection is an executable file then it is executed. Finally,
if the extension of the selected file name matches one of the
extensions in the
.\"LINK2"
extensions file
.\"Edit Extension File"
then the corresponding command is executed.
.TP
.B C\-l
repaint all the information in Midnight Commander.
.TP
.B C\-x c
run the
.\"LINK2"
Chmod
.\"Chmod"
command on a file or on the tagged files.
.TP
.B C\-x o
run the
.\"LINK2"
Chown
.\"Chown"
command on the current file or on the tagged files.
.TP
.B C\-x l
run the hard link command.
.TP
.B C\-x s
run the absolute symbolic link command.
.TP
.B C\-x v
run the relative symbolic link command. See the
.\"LINK2"
File Menu
.\"File Menu"
section for more information about symbolic links.
.TP
.B C\-x i
set the other panel display mode to information.
.TP
.B C\-x q
set the other panel display mode to quick view.
.TP
.B C\-x !
execute the
.\"LINK2"
External panelize
.\"External panelize"
command.
.TP
.B C\-x h
run the
.\"LINK2"
add directory to hotlist
.\"Hotlist"
command.
.TP
.B Alt\-!
executes the Filtered view command, described in the
.\"LINK2"
view command\&.
.\"Internal File Viewer"
.TP
.B Alt\-?
executes the
.\"LINK2"
Find file
.\"Find File"
command.
.TP
.B Alt\-c
pops up the
.\"LINK2"
quick cd
.\"Quick cd"
dialog.
.TP
.B C\-o
when the program is being run in the Linux or FreeBSD console or under
an xterm, it will show you the output of the previous command. When ran
on the Linux console, Midnight Commander uses an external program
(cons.saver) to handle saving and restoring of information on the
screen.
.PP
When the subshell support is compiled in, you can type C\-o at any time
and you will be taken back to Midnight Commander's main screen, to
return to your application just type C\-o. If you have an application
suspended by using this trick, you won't be able to execute other
programs from Midnight Commander until you terminate the suspended
application.
.\"NODE " Directory Panels"
.SH " Directory Panels"
This section lists the keys which operate on the directory panels. If
you want to know how to change the appearance of the panels take a
look at the section on
.\"LINK2"
Left and Right Menus\&.
.\"Left and Right Menus"
.TP
.B Tab, C\-i
change the current panel. The old other panel becomes the new current
panel and the old current panel becomes the new other panel. The
selection bar moves from the old current panel to the new current
panel.
.TP
.B Insert, C\-t
to tag files you may use the Insert key (the kich1 terminfo sequence).
To untag files, just retag a tagged file.
.TP
.B Alt\-e
to change charset of panel you may use Alt\-e (M\-e).
Recoding is made from selected codepage into system codepage. To
cancel the recoding, select "No translation" in the dialog of encodings.
.TP
.B Alt\-g, Alt\-r, Alt\-j
used to select the top file in a panel, the middle file and the bottom one,
respectively.
.TP
.B Alt\-t
toggle the current display listing to show the next display listing
format.
With this it is possible to quickly switch to brief listing, long
listing, user defined listing format, and back to the default.
.TP
.B C\-\\\\ (control\-backslash)
show the
.\"LINK2"
directory hotlist
.\"Hotlist"
and change to the selected directory.
.TP
.B + \ (plus)
this is used to select (tag) a group of files. Midnight Commander
will prompt for a selection options. When
.I Files only
checkbox is on, only files will be selected. If
.I Files only
is off, as files as directories will be selected.
When
.I Shell Patterns
checkbox is on, the regular expression is much like the filename globbing
in the shell (* standing for zero or more characters and ? standing
for one character). If
.I Shell Patterns
is off, then the tagging of files is done with normal regular
expressions (see ed (1)). When
.I Case sensitive
checkbox is on, the selection will be case sensitive characters.
If
.I Case sensitive
is off, the case will be ignored.
.TP
.B \\\\ (backslash)
use the "\\" key to unselect a group of files. This is the opposite of
the Plus key.
.TP
.B up\-key, C\-p
move the selection bar to the previous entry in the panel.
.TP
.B down\-key, C\-n
move the selection bar to the next entry in the panel.
.TP
.B home, a1, Alt\-<
move the selection bar to the first entry in the panel.
.TP
.B end, c1, Alt\->
move the selection bar to the last entry in the panel.
.TP
.B next\-page, C\-v
move the selection bar one page down.
.TP
.B prev\-page, Alt\-v
move the selection bar one page up.
.TP
.B Alt\-o
If the currently selected file is a directory, load that directory on
the other panel and moves the selection to the next file. If the
currently selected file is not a directory, load the parent directory
on the other panel and moves the selection to the next file.
.TP
.B Alt\-i
make the current directory of the current panel also the current
directory of the other panel. Put the other panel to the listing mode
if needed. If the current panel is panelized, the other panel doesn't
become panelized.
.TP
.B C\-PageUp, C\-PageDown
only when supported by the terminal: change to ".." and to the currently
selected directory respectively.
.TP
.B Alt\-y
moves to the previous directory in the history, equivalent to clicking
the
.I <
with the mouse.
.TP
.B Alt\-u
moves to the next directory in the history, equivalent to clicking the
.I >
with the mouse.
.TP
.B Alt\-S\-h, Alt\-H
displays the directory history, equivalent to depressing the 'v' with
the mouse.
.\"NODE " Quick search"
.SH " Quick search"
The Quick search mode allows you to perform fast file search in file panel.
Press
.I C\-s
or
.I Alt\-s
to start a filename search in the directory listing.
.P
When the search is active, the user input will be added to the search string
instead of the command line. If the
.I Show mini\-status
option is enabled the search string is shown on the mini\-status
line. When typing, the selection bar will move to the next file
starting with the typed letters. The
.I Backspace
or
.I DEL
keys can be used to correct typing mistakes. If C\-s is pressed
again, the next match is searched for.
.P
If quick search is started with double pressing of C\-s, the previous quick
search pattern will be used for current search.
.P
Besides the filename characters, you can also use wildcard
characters '*' and '?'.
.\"NODE " Shell Command Line"
.SH " Shell Command Line"
This section lists keys which are useful to avoid excessive typing when
entering shell commands.
.TP
.B Alt\-Enter
copy the currently selected file name to the command line.
.TP
.B C\-Enter
same a Alt\-Enter. May not work on remote systems and some terminals.
.TP
.B C\-S\-Enter
copy the full path name of the currently selected file to the command
line. May not work on remote systems and some terminals.
.TP
.B Alt\-Tab
does the filename, command, variable, username and hostname
.\"LINK2"
completion
.\"Completion"
for you.
.TP
.B C\-x t, C\-x C\-t
copy the tagged files (or if there are no tagged files, the selected
file) of the current panel (C\-x t) or of the other panel (C\-x C\-t) to
the command line.
.TP
.B C\-x p, C\-x C\-p
the first key sequence copies the current path name to the command
line, and the second one copies the unselected panel's path name to
the command line.
.TP
.B C\-q
the quote command can be used to insert characters that are otherwise
interpreted by Midnight Commander (like the '+' symbol)
.TP
.B Alt\-p, Alt\-n
use these keys to browse through the command history. Alt\-p takes you
to the last entry, Alt\-n takes you to the next one.
.TP
.B Alt\-h
displays the history for the current input line.
.\"NODE " General Movement Keys"
.SH " General Movement Keys"
The help viewer, the file viewer and the directory tree use common
code to handle moving. Therefore they accept exactly the same
keys. Each of them also accepts some keys of its own.
.PP
Other parts of Midnight Commander use some of the same movement
keys, so this section may be of use for those parts too.
.TP
.B Up, C\-p
moves one line backward.
.TP
.B Down, C\-n
moves one line forward.
.TP
.B Prev Page, Page Up, Alt\-v
moves one page up.
.TP
.B Next Page, Page Down, C\-v
moves one page down.
.TP
.B Home, A1
moves to the beginning.
.TP
.B End, C1
move to the end.
.PP
The help viewer and the file viewer accept the following keys in
addition the to ones mentioned above:
.TP
.B b, C\-b, C\-h, Backspace, Delete
moves one page up.
.TP
.B Space bar
moves one page down.
.TP
.B u, d
moves one half of a page up or down.
.TP
.B g, G
moves to the beginning or to the end.
.\"NODE " Input Line Keys"
.SH " Input Line Keys"
The input lines (they are used for the
.\"LINK2"
command line
.\"Shell Command Line"
and for the query dialogs in the program) accept these keys:
.TP
.B C\-a
puts the cursor at the beginning of line.
.TP
.B C\-e
puts the cursor at the end of the line.
.TP
.B C\-b, move\-left
move the cursor one position left.
.TP
.B C\-f, move\-right
move the cursor one position right.
.TP
.B Alt\-f
moves one word forward.
.TP
.B Alt\-b
moves one word backward.
.TP
.B C\-h, Backspace
delete the previous character.
.TP
.B C\-d, Delete
delete the character in the point (over the cursor).
.TP
.B C\-@
sets the mark for cutting.
.TP
.B C\-w
copies the text between the cursor and the mark to a kill buffer and
removes the text from the input line.
.TP
.B Alt\-w
copies the text between the cursor and the mark to a kill buffer.
.TP
.B C\-y
yanks back the contents of the kill buffer.
.TP
.B C\-k
kills the text from the cursor to the end of the line.
.TP
.B Alt\-p, Alt\-n
Use these keys to browse through the command history. Alt\-p takes you
to the last entry, Alt\-n takes you to the next one.
.TP
.B Alt\-C\-h, Alt\-Backspace
delete one word backward.
.TP
.B Alt\-Tab
does the filename, command, variable, username and hostname
.\"LINK2"
completion
.\"Completion"
for you.
.SH ""
.\"NODE "Menu Bar"
.SH "Menu Bar"
The menu bar pops up when you press F9 or click the mouse on the top
row of the screen. The menu bar has five menus: "Left", "File",
"Command", "Options" and "Right".
.PP
The
.\"LINK2"
Left and Right Menus
.\"Left and Right Menus"
allow you to modify the appearance of the left and right directory
panels.
.PP
The
.\"LINK2"
File Menu
.\"File Menu"
lists the actions you can perform on the currently selected file or
the tagged files.
.PP
The
.\"LINK2"
Command Menu
.\"Command Menu"
lists the actions which are more general and bear no relation to the
currently selected file or the tagged files.
.PP
The
.\"LINK2"
Options Menu
.\"Options Menu"
lists the actions which allow you to customize Midnight Commander.
.\"NODE " Left and Right Menus"
.SH " Left and Right (Above and Below) Menus"
The outlook of the directory panels can be changed from the
.B Left
and
.B Right
menus (they are named
.B Above
and
.B Below
when the horizontal panel split is chosen from the
.\"LINK2"
Layout
.\"Layout"
options dialog).
.\"NODE " Listing Format..."
.SH " Listing Format..."
The listing mode view is used to display a listing of files, there are
four different listing formats available:
.BR Full ,
.BR Brief ,
.B Long
and
.BR User .
The full directory view shows the file name, the size of the file and
the modification time.
.PP
The brief view shows only the file name and it has from 1 up to 9 columns
(therefore showing more files unlike other views). The long view
is similar to the output of
.B "ls \-l"
command. The long view takes the whole screen width.
.PP
If you choose the "User" display format, then you have to specify
the display format.
.PP
The user display format must start with a panel size specifier. This
may be "half" or "full", and they specify a half screen panel and a
full screen panel respectively.
.PP
After the panel size, you may specify how many listings to fit in the
panel, side\-by\-side (in other words: how many times to repeat the
fields horizontally). This defaults to 1. You may change this by adding a
number from 1 to 9 to the format string.
.PP
After this you add the name of the fields with an optional size
specifier. This are the available fields you may display:
.TP
.B name
displays the file name.
.TP
.B size
displays the file size.
.TP
.B bsize
is an alternative form of the
.B size
format. It displays the size of the files and for directories it just
shows SUB\-DIR or UP\-\-DIR.
.TP
.B type
displays a one character wide type field. This character is similar to
what is displayed by ls with the \-F flag \-
.B *
for executable files,
.B /
for directories,
.B @
for links,
.B =
for sockets,
.B \-
for character devices,
.B +
for block devices,
.B |
for pipes,
.B ~
for symbolic links to directories and
.B !
for stale symlinks (links that point nowhere).
.TP
.B mark
an asterisk if the file is tagged, a space if it's not.
.TP
.B mtime
file's last modification time.
.TP
.B atime
file's last access time.
.TP
.B ctime
file's status change time.
.TP
.B perm
a string representing the current permission bits of the file.
.TP
.B mode
an octal value with the current permission bits of the file.
.TP
.B nlink
the number of links to the file.
.TP
.B ngid
the GID (numeric).
.TP
.B nuid
the UID (numeric).
.TP
.B owner
the owner of the file.
.TP
.B group
the group of the file.
.TP
.B inode
the inode of the file.
.PP
Also you can use following keywords to define the panel layout:
.TP
.B space
a space in the display format.
.TP
.B |
add a vertical line to the display format.
.PP
To force one field to a fixed size (a size specifier), you just add
.B :
followed by the number of characters you want the field to have. If the
number is followed by the symbol
.BR + ,
then the size specifies the minimal field size \- if the program finds
out that there is more space on the screen, it will then expand that
field.
.PP
For example, the
.B Full
display corresponds to this format:
.PP
half type name | size | mtime
.PP
And the
.B Long
display corresponds to this format:
.PP
full perm space nlink space owner space group space size space mtime
space name
.PP
This is a nice user display format:
.PP
half name | size:7 | type mode:3
.PP
Panels may also be set to the following modes:
.TP
.B "Info"
The info view display information related to the currently
selected file and if possible information about the current file
system.
.TP
.B "Tree"
The tree view is quite similar to the
.\"LINK2"
directory tree
.\"Directory Tree"
feature. See the section about it for more information.
.TP
.B "Quick View"
In this mode, the panel will switch to a reduced
.\"LINK2"
viewer
.\"Internal File Viewer"
that displays the contents of the currently selected file, if you
select the panel (with the tab key or the mouse), you will have access
to the usual viewer commands.
.\"NODE " Sort Order..."
.SH " Sort Order..."
The eight sort orders are by name, by extension, by modification time,
by access time, and by inode information modification time, by size,
by inode and unsorted. In the Sort order dialog box you can choose
the sort order and you may also specify if you want to sort in reverse
order by checking the reverse box.
.PP
By default directories are sorted before files but this can be changed
from the
.\"LINK2"
Panel options
.\"Panel options"
menu (option
.BR "Mix all files" ).
.\"NODE " Filter..."
.SH " Filter..."
The filter command allows you to specify a shell pattern (for example
.BR "*.tar.gz" )
which the files must match to be shown. Regardless
of the filter pattern, the directories and the links to directories
are always shown in the directory panel.
.\"NODE " Reread"
.SH " Reread"
The reread command reload the list of files in the directory. It is
useful if other processes have created or removed files.
.\"NODE " File Menu"
.SH " File Menu"
Midnight Commander uses the F1 \- F10 keys as keyboard shortcuts
for commands appearing in the file menu. The escape sequences for the
function keys are terminfo capabilities kf1 trough kf10. On terminals
without function key support, you can achieve the same functionality by
pressing the Esc key and then a number in the range 1 through 9 and 0
(corresponding to F1 to F9 and F10 respectively).
.PP
The File menu has the following commands (keyboard shortcuts in parentheses):
.PP
.B Help (F1)
.PP
Invokes the built\-in hypertext help viewer. Inside the
.\"LINK2"
help viewer\&,
.\"Contents"
you can use the Tab key to select the next link and the Enter key to
follow that link. The keys Space and Backspace are used to move
forward and backward in a help page. Press F1 again to get the full
list of accepted keys.
.PP
.B Menu (F2)
.PP
Invoke the
.\"LINK2"
user menu\&.
.\"Edit Menu File"
The user menu provides an easy way to provide users with a menu and
add extra features to Midnight Commander.
.PP
.B View (F3, F13)
.PP
View the currently selected file. By default this invokes the
.\"LINK2"
Internal File Viewer
.\"Internal File Viewer"
but if the option "Use internal view" is off, it invokes an external
file viewer specified by the
.B VIEWER
environment variable. If
.B VIEWER
is undefined, the