summaryrefslogtreecommitdiffstats
path: root/doc/FAQ
blob: 47450f6298846369062f9cd4fbad4782e621483b (plain)
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
GNU Midnight Commander
Frequently Asked Questions

   The newest version of this document is available at
   https://www.midnight-commander.org/browser/doc/FAQ

     * 1 Getting started
          + 1.1 What is Midnight Commander?
          + 1.2 Does it run on my machine?
          + 1.3 Does it work with my terminal?
          + 1.4 What else do I need to run MC?
          + 1.5 Is GNU Midnight Commander Public Domain?  Copyrighted?
          + 1.6 Where can I get GNU Midnight Commander?
          + 1.7 I cannot compile MC.  What should I do?

     * 2 Keyboard
          + 2.1 What does documentation mean with the C-?, M-? and F?
            keys?
          + 2.2 Why don't function keys (or some other key) work?
          + 2.3 How do I use function keys F11 to F20?
          + 2.4 Why does the ESC key behave funny?
          + 2.5 How can I add the plus sign (+) on the command line?
          + 2.6 C-o doesn't work!
          + 2.7 What 'keys' are the "a1" and "c1" keys mentioned in the
            manual?
          + 2.8 How do I change the key bindings?

     * 3 Mouse
          + 3.1 How do I enable mouse support?
          + 3.2 How do I cut and paste text with mouse?
          + 3.3 How do I get the extension dependent pop-up menu to
            pop up?

     * 4 Display
          + 4.1 Why do I keep getting "Terminal not powerful enough for
            SLang" or "Terminal not powerful enough for SLsmg"?
          + 4.2 Why don't line drawing characters work?
          + 4.3 Can one use latin-1 characters without losing the lines?
          + 4.4 I have problems with entering/viewing national
            characters!
          + 4.5 How can I get colors?
          + 4.6 My color_xterm goes completely (or partially) black!
          + 4.7 Where can I get xterm or rxvt?
          + 4.8 I got colors working with MC but the other programs
            don't work at all anymore!
          + 4.9 Why are there both terminfo and termcap?  Wouldn't one
            database be enough?

     * 5 Graphical user interface
          + 5.1 Xview, Tk and Gnome editions?
          + 5.2 Why is MC linked with X libraries?

     * 6 Command line problems
          + 6.1 How do I stay in the last directory when I exit Midnight
            Commander?
          + 6.2 How can I access command line history?
          + 6.3 How can I complete commands, file names, variable names
            and so on?
          + 6.4 I am using ksh.  Can I use functions defined in the
            .kshrc within MC?
          + 6.5 Is there any way to include additional options or hot
            keys to MC?
          + 6.6 When I use Ctrl-O I don't get a subshell.  How do I fix
            this?
          + 6.7 Ctrl-O doesn't work at all.  What happens?

     * 7 Virtual file systems
          + 7.1 How can I see the contents of a tar archive?
          + 7.2 How do I get out of a tar archive?
          + 7.3 How do I do anonymous ftp with MC?
          + 7.4 How do I do non-anonymous ftp with MC?
          + 7.5 How do I close an ftp connection?
          + 7.6 Why aren't the contents of ftp panel updated?
          + 7.7 What kind of proxy server works with Midnight Commander?

     * 8 Internal editor
          + 8.1 When I try pasting to the internal editor, it indents
            the amount of indenting increases with each line!
          + 8.2 Is it possible to use Colorer for syntax highlighting?

     * 9 Other common problems
          + 9.1 Is there any way to 'bookmark' favorite ftp-fs links?
          + 9.2 When I start Midnight Commander, nothing happens!

     * 10 Development
          + 10.1 Who has written Midnight Commander?
          + 10.2 Do I dare to use a development version?
          + 10.3 How can I report a bug/request for a feature?
          + 10.4 How can I join the development?

     * 11 More information
          + 11.1 This document didn't answer my question.  Where else
            can I look for an answer?
          + 11.2 What mailing lists are there for Midnight Commander?
          + 11.3 Where should I look on the World Wide Web for MC stuff?
          + 11.4 Are the mailing lists archived anywhere?

     * 12 Legal issues
          + 12.1 Authorship
          + 12.2 Feedback is invited
          + 12.3 Disclaimer and copyright


1 Getting started

1.1 What is Midnight Commander?

   GNU Midnight Commander is a user-friendly yet powerful file manager
   and visual shell, useful to novice and guru alike.  It provides a
   clear, user-friendly, and somewhat protected interface to a Unix
   system while making many frequent file operations more efficient and
   preserving the full power of the command prompt.  After some
   practice, you will wonder how you could ever live without it.

1.2 Does it run on my machine?

   GNU Midnight Commander runs on POSIX (Unix-like) operating systems,
   such as GNU/Linux, FreeBSD, Mac OS X, Solaris, HP-UX and others.  It
   can also be compiled under Cygwin on Windows.

   GNU Midnight Commander uses GNU Autoconf which should automatically
   configure it for every Unix clone.  Following configurations have
   been tested in the past (this list is very old):

     * i386-*-linux1.x, 2.x
     * alpha-linux-linux2
     * sparc-linux-linux2.x
     * sparc64-linux-linux2.1
     * mips-sgi-irix5.x, 6.x
     * sparc-sun-sunos4.1
     * sparc-sun-solaris2.3, 2.4, 2.5
     * sparc-sun-netbsd1.0
     * hppa-hp-hpux9
     * hppa-hp-hpux7
     * m68k-apple-aux
     * unixware
     * mc88110-aviion-dgux5.4R2.01
     * i386-*-sco3.2v4.2
     * i386-*-sco3.2v5

1.3 Does it work with my terminal?

   Yes, it does.

   Because GNU Midnight Commander is a full screen program it doesn't
   run on dummy terminals but anything more advanced will do (like
   vt100).  If your terminal works with vi, emacs, elm or pine it will
   work with GNU Midnight Commander.

1.4 What else do I need to run MC?

   You need a POSIX (Unix compatible) operating system.  If you are
   running Windows, use Cygwin.

   To compile any edition you need to have glib >= 2.30  installed.
   It's available at https://download.gnome.org/sources/glib/.

   If you want to use mouse on the Linux console you need the gpm daemon
   from https://www.nico.schottelius.org/software/gpm/.  You need nothing
   extra to use mouse on xterm.

   If you do not want to use the S-Lang library you could try using
   ncurses version 4.1 and above.

1.5 Is GNU Midnight Commander Public Domain? Copyrighted?

   Midnight Commander is under GNU Public License which basically means
   that you may freely copy, change and distribute it, but that you may
   not impose any restrictions on further distribution, and that you
   must make the source code available.  This is not the same as Public
   Domain.  For details, the GNU license is included in GNU Midnight
   Commander source distribution (the COPYING file).

   Midnight Commander is now officially a part of the GNU project.
   All the authors of GNU Midnight Commander have given all their rights
   on the program to the Free Software Foundation.

1.6 Where can I get GNU Midnight Commander?

   The main site is https://www.midnight-commander.org

1.7 I cannot compile MC.  What should I do?

   Make sure you have read the INSTALL file in the sources.  Report the
   error messages exactly as they appear, mention the versions of your
   OS, your compiler and whatever else software you think is relevant.
   If you have compile problems in the VFS code, try disabling it by
   using "--disable-vfs" option.

f2 Keyboard

2.1 What does documentation mean with the C-?, M-? and F? keys?

   GNU Midnight Commander documentation uses emacs style names for
   keyboard keys.

   C stands for the Ctrl key.  For example, C-f means that you should
   hold down the Ctrl key and press the f key.

   M stands for the Meta key.  Your terminal might call it Alt or
   Compose instead of Meta.  For example, M-f means that you should hold
   down the Meta/Alt/Compose key and press the f key.  If your terminal
   doesn't have Meta, Alt or Compose or they don't work you can use Esc.
   For M-f press the Esc key and then press the f key.

   Sometimes Ctrl and Alt are used instead of C and M for simplicity.
   Keep in mind that Alt can actually be Meta on some keyboards.

   F? stands for a function key.  If your terminal doesn't have function
   keys or they don't work you can use Esc.  For example, for F3 press
   the Esc key and then press the 3 key.

2.2 Why don't function keys (or some other key) work?

   Your terminfo or termcap database has missing or incorrect
   definitions for function keys.  Type "mc -V" to see what terminal
   database is being used.  If the result is "using the S-Lang library
   with terminfo database" and you are using a very old terminfo
   database, consider installing one of the enhanced terminfo files
   included in GNU Midnight Commander source distribution.  For example,
   if you are using xterm type "tic xterm.ti".

   If the result is "using the S-Lang library with termcap database" you
   should fix your /etc/termcap database.

   Up-to-date termcap and terminfo databases are available here:

     http://www.catb.org/~esr/terminfo/
     ftp://ftp.gnu.org/pub/gnu/ncurses/

   If you don't have permissions to edit terminal databases you can use
   Learn keys feature of Midnight Commander instead.  Press Esc 9 o k
   and follow instructions.

   If all else fails you can emulate function keys by first pressing the
   ESC key and then one of the number keys.  For example, if you want to
   produce F9, press ESC, then 9.  If you don't have a ESC key on your
   keyboard you can try alt-9 or meta-9.

2.3 How do I use function keys F11 to F20?

   These are normally mapped to function keys F1 to F10 with Shift held,
   e.g. function key F13 can be activated by pressing Shift-F3.  You can
   define the keys this way in the Options->Learn Keys dialog.  The
   convention for PC keyboards is that F11-20 always means Shift with
   F1-10.

   You may find that on the Linux console with some keyboard layouts
   Shift-Fn is interpreted as F(n+12), not as F(n+10).  This is a result
   of non-uniformity of keyboard layouts.  This is not an intended
   behavior and it may be fixed some day.  In the meantime, use "Learn
   Keys" to remedy this inconvenience.

2.4 Why does the ESC key behave funny?

   Midnight Commander uses the ESC key as a prefix for simulating the
   Meta and Alt keys (for terminals which don't have Meta or Alt, see
   the three previous questions).  For example, pressing ESC-a is the
   same as pressing Meta-a.  In addition most terminals use ESC for
   internal representation of arrow keys, function keys and other
   enhanced keys.  If you want to use ESC to cancel things you have to
   press it twice i.e. ESC-ESC.  If you find this cumbersome you can
   generally use F10 to cancel.  Alternatively turn on the old_esc_mode
   setting in the ~/.config/mc/ini file.  The
   old_esc_mode setting makes ESC work as a prefix only if another key
   is pressed within 0.5 seconds. After 0.5 seconds the ESC key cancels.
   There is no way to make ESC cancel immediately (if we want to be able
   to use arrows keys and function keys).

2.5 How can I add the plus sign (+) on the command line?

   Press C-q first, then press the + sign.

   The plus key is the hotkey for the select files command.  If you want
   to add a literal plus on to the command line you must quote it by
   pressing C-q first.

   Another common key which needs the C-q prefix is backslash "\".

2.6 C-o doesn't work!

   Maybe C-o is a stty control character on your terminal.  See man stty
   for details on how to list and change stty control characters.

2.7 What 'keys' are the "a1" and "c1" keys mentioned in the manual?

   The "a1" key is the key which has the "a1" caption on it.

   The "c1" key is the key which has the "c1" caption on it.

   If you have to ask what these two keys are your keyboard hasn't
   probably got them.  Actually, I have never seen a keyboard which has
   got them.

2.8 How do I change the key bindings?

   Key binding con be reconfigure via keymap files: /etc/mc/mc.keymap
   and ~/.config/mc/mc.keymap.

   You can use the "Learn Keys" dialog to assign keys to some actions
   listed in that dialog.


3 Mouse

3.1 How do I enable mouse support?

   Invoke mc like this (without quotes): "mc -x".  If this doesn't work
   upgrade to a terminal which compatible with the Xterm mouse
   sequences.

   Alternatively, on Linux console you can use gpm.

3.2 How do I cut and paste text with mouse?

   Hold down shift key while using mouse to cut and paste.


4 Display

4.1 Why do I keep getting "Terminal not powerful enough for SLang" or
    "Terminal not powerful enough for SLsmg"?

   This means that your terminfo databases do not contain the correct
   definitions for your terminal.

   You could try using a different terminal setting.  If you use csh or
   tcsh:

     setenv TERM vt100

   or if you use sh, bash, ksh or zsh:

     export TERM=vt100

4.2 Why don't line drawing characters work?

   Since version 4.0.13 there's the command line option -a to force use
   of charaters +, |, - for line drawing.  Use the -a option if any
   of the suggestions below doesn't help.

   In general, there are three cases:
     * Lines are shown as ASCII characters like this

      +---------+
      |         |
      +---------+

       This also happens when you use the -a option.  Other than that
       possible reason is 1 or 2 (see below).

     * Lines are shown as lower case characters like this

      lqqqqqqqqqk
      x         x
      mqqqqqqqqqj

       Possible reason is 1 or 2 (see below).

     * Lines are shown as blanks or missing characters.  Possible reason
       is 2 or 3 (see below).

   The reason for the problem is one of following:

    1. Your terminal might not support line drawing characters.  VT100
       compatible terminals, rxvt and xterm and color_xterm do support
       them.
    2. Your terminfo or termcap database might have missing or incorrect
       definitions for line drawing characters.  Set the acsc variable
       in the terminfo database like this:
       acsc=a\376k\277l\332m\300j\331n\305w\302v\301u\264t\303q\304x
       \263h\2600\333
       Don't forget issue 'tic' command.  This supposes you are using PC
       character set.  The octal values might be different for other
       character sets.  If you are using termcap instead of terminfo,
       you should modify above solution appropriately.
    3. Your terminal font might not support line drawing characters.
       Try changing the font.

   Here is Miguel's answer to Torben on this subject.

   Torben:

     When I load consolefonts/iso01.f16, I get perfectly right national
     characters, but the line drawing characters in mc get wrong.  Is it
     a mc problem, or is it a problem with the font? (I guess it is).

     Is there a trick?

   Miguel:

     First of all, we should determine whether the font has line drawing
     characters or not.

     If it has line drawing characters, then a new terminfo entry should
     be written for this specific case.  Let's call this linux-iso01.
     The acsc variable should be modified to reflect which characters
     are used to do the line drawing.

     If it does not have line drawing characters, then we should get rid
     of the switch to acsc sequences and make the acsc sequence be just
     a mapping to the ugly +, -, |, - characters.

     You can get your terminfo definition by running the infocmp
     program, making the proper changes and running the tic program to
     compile your new terminfo database.

4.3 Can one use latin-1 characters without losing the lines?

   Yes, you need a correct font and a correct termcap/terminfo database.

   For font, if you use xterm try "xterm -fn fixed".

   For termcap/terminfo database, change the acsc capability in the
   database.

4.4 I have problems with entering/viewing national characters!

   From the Options - Display Bits dialog select Full 8 bits or ISO
   8859-1.  In addition, select 8 bit input from the same dialog.

4.5 How can I get colors?

   Invoke mc like this (without quotes): "mc -c".

   If you get colors, be happy.

   If your terminal stays black and white, your terminal doesn't support
   color.  You might want to upgrade to a terminal which compatible with
   the ANSI color sequences.

   If your terminal goes completely black, see the next question.

   More detailed answer:

   Check that your terminal supports color.  color_xterm, rxvt and Linux
   console do support, most other terminals don't.  You can test color
   support with following simple C program:

    #include <stdio.h>

    int main (void){
        printf ("\033[32m Hello world! \033[m\n");
        return 0;
    }

   Compile and run it.  If you see "Hello world!" text in green your
   terminal supports color, otherwise not (however, for color_xterm see
   also the next question).

   Check whether you are using Ncurses or the S-Lang library (type
   "mc -V" to find out).

   With S-Lang library you can force color support by setting the
   environment variable COLORTERM to any value.

   If you use ncurses library, check that your terminfo database
   supports color.  If not, you should install one of the enhanced
   terminfo databases included in GNU Midnight Commander source
   distribution.

   You might want to set the TERM environment variable so that you are
   using the correct terminfo database or termcap entry.

   If you use color_xterm (or rxvt) the correct value might be
   xterm-color, xtermc or simply xterm.

   If you use Linux console the correct value for TERM is linux or
   console.

4.6 My color_xterm goes completely (or partially) black!

   Some color_xterm terminals define all colors as black instead of the
   standard ANSI colors.  This makes them go completely black when you
   try to use Midnight Commander with colors.

   You will have to override the defaults.  Create a file
   "color.defaults" which has the following contents:

    color_xterm*color0:           Black
    color_xterm*color1:           Red
    color_xterm*color2:           Green
    color_xterm*color3:           Yellow
    color_xterm*color4:           Blue
    color_xterm*color5:           Magenta
    color_xterm*color6:           Cyan
    color_xterm*color7:           White
    color_xterm*background:       White
    color_xterm*foreground:       Black

   (replace color_xterm with the name of your color_xterm, color_xterm
   mentions its name in its title bar)

   Now type:

    xrdb -merge color.defaults

   Alternatively you can add the suggested contents of the
   color.defaults file to your .Xdefaults or .Xresources file (or what
   ever the name of your X configuration file is).  Or you can replace
   your non-ANSI color_xterm with an ANSI color_xterm.

4.7 Where can I get xterm or rxvt?

   xterm is included with the X Window System, so you probably already
   have it if you have X.  This version is not actively maintained, but
   Thomas Dickey maintains his more advanced version of xterm at
   ftp://dickey.his.com/xterm/

   rxvt has its own site http://www.rxvt.net/ - get the latest version
   there.

4.8 I got colors working with MC but the other programs don't work at
all anymore!

   Midnight Commander uses terminfo database (if available) but many
   other programs use termcap database.  If you set the TERM environment
   variable to a value which has no corresponding entry in termcap
   database those programs stop working.  You should add the new value
   of TERM to the termcap database.

   Example: If you have set TERM to xterm-color locate from /etc/termcap
   the line which starts:

    xterm|vs100|xterm terminal emulator

   Change it to start:

    xterm|xterm-color|vs100|xterm terminal emulator

5 Graphical user interface

5.1 Xview, Tk and Gnome editions?

   Xview and Tk and GNOME editions have been removed from the sources.

5.2 Why is MC linked with X libraries?

   GNU Midnight Commander is linked with X libraries to read key
   modifiers from the X Server.  It may be helpful to distinguish
   between keys that the terminal emulator reports in the same way, e.g.
   PgUp and Ctrl-PgUp.  Versions of GNU Midnight Commander after 4.6.0
   will load X libraries dynamically on the systems that support it.


6 Command line problems

6.1 How do I stay in the last directory when I exit Midnight Commander?

   See the description of the -P option in the Options section of the
   manual.

6.2 How can I access command line history?

   Meta-h shows the last commands you executed from the command line.
   Duplicates are suppressed from the history.  Commands executed from
   the subshell prompt are not shown.

   You can put previous commands to the command line with Meta-p.  Meta-n
   moves you forward in history.

   Since version 4.1.15 all the input widgets have permanent history.
   You can summon the history listbox by pressing M-h.

6.3 How can I complete commands, file names, variable names and so on?

   Just press M-Tab.  Press M-Tab again to get a listbox if there are
   multiple possible completions.

6.4 I am using ksh.  Can I use functions defined in the .kshrc within
MC?

   Sorry, MC only supports bash, tcsh and zsh functions.  Ksh functions
   are not supported because ksh lacks the necessary hooks needed for
   subshell integration.

   Switch to bash or zsh.  They are both quite compatible with ksh. 
   Your ksh functions should work as such or after minimal changes.

6.5 Is there any way to include additional options or hot keys to MC?

   Yes, F2 invokes an user menu,  which is fully configurable.  You can
   add any shell commands to the user menu.  See the mc(1) man page for
   more info.

   Another way to add functionality is the external panelize feature.
   See the mc(1) man page for more info.

   And finally, you can code any feature you want yourself.  MC source
   code is free which means you can change it anyway you want.  There
   are some limitations to make sure MC stays free.  See GNU General
   Public License for details.

6.6 When I use Ctrl-O I don't get a subshell.  How do I fix this?

   Only bash, tcsh and zsh can be used as subshell.  Use one of those
   shells as your default shell, and it will be used as subshell in GNU
   Midnight Commander.

6.7 Ctrl-O doesn't work at all.  What happens?

   Ctrl-O works if either the subshell is used or the terminal can save
   the output of the commands so it can be restored.  If neither is
   true, there is absolutely nothing interesting behind the panels!

   Only few terminals support screen saving.  It's xterm, rxvt and other
   xterm-like terminals and virtual terminals on Linux and FreeBSD.

6.8 Why I see lot of strange 'cd "printf ' lines into my .history file?

  Add

    export HISTCONTROL="ignoreboth"

  into your ~/.profile file (.bash_profile) for avoid this.

6.9 I have a problem with Screen which makes using Midnight Commander
problematic. I use Ctrl-O to disable panels. Output of previous commands,
just a clear, screen is blanked.

  Update GNU Screen to the last version. This bug was fixed in

   commit ad56f746c6243d45124485d198d577bdbb78071c
   Author: Sadrul Habib Chowdhury <sadrul@users.sourceforge.net>
   Date:   Sun Nov 29 23:34:25 2009 -0500

       Fix using alternate screen buffers in some cases.

       Screen would reset the 'main' screen buffer if an app tries to
       switch to an alternate buffer while it is already using one (in
       other words, sends multiple 'smcup' without an 'rmcup'). This should
       fix debian #558724

  (see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=558724)

  or do not rewrite TERM (mustbe TERM=screen) andrun mc as follow:

   echo -e '\e[?1000h' && mc -x

7 Virtual file systems

7.1 How can I see the contents of a tar archive?

   If you use keyboard just move the selection bar on the tar file and
   press enter.  If you use mouse just double-click on the tar file.

   The recognized suffixes for tar archives are .tar, .tar.gz and .tgz.
   You can also enter a tar archive by typing "cd filename/utar://" where
   filename is the name of the archive.  In this case, the suffix is not
   important.

7.2 How do I get out of a tar archive?

   Just press enter on the toplevel ".." file or change to a non-tar
   directory.  Just typing "cd" with no parameters is enough (it will
   take you to your home directory).

7.3 How do I do anonymous ftp with MC?

   Just type "cd ftp://hostname" where hostname is the name of the host
   you want to connect.  Alternatively, select FTP link from the Left or
   Right menu and type the name of the host you want to connect.

7.4 How do I do non-anonymous ftp with MC?

   Non-anonymous ftp works just like the anonymous ftp but you give the
   login name with the host name.  For example, type "cd
   ftp://username@hostname".

7.5 How do I close an ftp connection?

   Just change to a non-ftp directory.  Simply typing "cd" with no
   parameters is enough (it will take you to your home directory).

   GNU Midnight Commander closes ftp connection automatically after a
   timeout or on exit.  It's possible to force disconnect by selecting
   "Command" -> "Active VFS List" in the menu and using the "Free VFSs
   Now" button.

7.6 Why aren't the contents of ftp panel updated?

   Update is skipped because there would be a serious performance
   penalty.  Constantly updating directory panels through a ftp
   connection would take too much time.

   You can use C-r to force an update.

7.7 What kind of proxy server works with Midnight Commander?

   There are two kinds of ftp proxies: proxies for ftp clients and
   proxies for web browsers.

   Midnight Commander only supports ftp proxies which are meant for ftp
   clients.  Common WWW proxies (like Squid) are not supported.  A rule
   of thumb is that if a ftp proxy requires a web browser, it won't work
   with Midnight Commander.


8 Other common problems

8.1 When I try pasting to the internal editor, it indents the amount of
indenting increases with each line!

   Either turn off 'Return does autoindent' in the editor options or
   update GNU Midnight Commander to version 4.6.0 or above - it doesn't
   autoindent when you are holding Shift.

8.2 Is it possible to use Colorer for syntax highlighting?

   Yes if you submit the patch.  There are no legal problems with it
   because it's licensed under GPL now.  The homepage of Colorer is
   http://colorer.sourceforge.net/


9 Other common problems

9.1 Is there any way to 'bookmark' favorite ftp-fs links?

   Use the directory hotlist.  Just press control-backslash.  If your
   national keyboard layout doesn't have backslash key, just press the
   control key with the key which is the backslash key in the English
   keyboard layout.

9.2 When I start Midnight Commander, nothing happens!

   First, invoke MC without subshell support: "mc -u".  If this helps
   check the shell you are using.  Subshell support works best with
   bash, although tcsh and zsh are also supported.  You might want to
   upgrade your shell to a newer version.  If you use something else
   than bash, tcsh or zsh, subshell support is disabled automatically.

   Another reason is problems with gpm.  Try using "--nomouse" option to
   see if it makes any difference.  Restarting gpm can help.  Sometimes
   it's enough to move the mouse.

   Also, if you have the DISPLAY environment variable set, but the X
   server is unreachable (e.g. it's firewalled), this can also cause a
   delay at startup.  Unset DISPLAY to see if that's the case.


10 Development

10.1 Who has written Midnight Commander?

   Midnight Commander was started by Miguel de Icaza and he is the
   maintainer of the package.  Other authors have joined the project
   later:
     * Mauricio Plaza (early releases)
     * Janne Kukonlehto (joined Sep 27 1994)
     * Radek Doulik (joined Oct 30 1994)
     * Fred Leeflang (joined Nov 2 1994)
     * Dugan Porter (joined Dec 1 1994)
     * Jakub Jelinek (joined Feb 8 1995)
     * Ching Hui (joined Jun 27 1995)
     * Andrej Borsenkow (joined Jul 1996)
     * Paul Sheer (joined Nov 1 1996)
     * Norbert Warmuth
     * Alex I. Tkachenko


   Alessandro Rubini has been specially helpful with debugging and
   enhancing of the mouse support.  John E. Davis has made his S-Lang
   library available to us and answered many questions about it.

   Many people have contributed bug reports, feature suggestions and
   small code bits (alphabetical order):
     * Thomasz Cholewo
     * Juan Jose Ciarlante
     * Alexander Dong (OS/2 port, NT port updates)
     * Erwin van Eijk
     * Torben Fjerdingstad
     * Massimo Fontanelli
     * Juan Grigera (NT port)
     * Gerd Knorr
     * Sergey Ya. Korshunoff
     * Jean-Daniel Luiset
     * Wim Osterholt
     * Antonio Palama (old DOS port)
     * Thomas Pundt
     * Marcelo Roccasalva
     * Ilya Rybkin
     * Vadim Sinolits
     * Jon Stevens
     * Adam Tla/lka

   Current list of active developers can be found here:
   https://www.midnight-commander.org/wiki/McDevelopers

   This page lists everbody who has provided a patch or
   has written code for the Midnight Commander in the past:
   https://www.midnight-commander.org/wiki/McContributors

10.2 Do I dare to use a development version?

   Yes, of course. Feel free to test:
   https://www.midnight-commander.org/wiki#Download
   As we do our development in git, please do a git checkout
   of the master branch and build it

   But always remember: development versions may have nasty bugs
   at some points of time.  It's up to you to judge whether the new
   features and fixes for the bugs you know outweigh the risk of unknown
   bugs.

10.3 How can I report a bug/request for a feature?

   You might first want to get the newest development version to see if
   the bug is fixed or the feature is added already.

   If this is not the case, feel free to add a ticket in our ticket system,
   which is located here: https://www.midnight-commander.org/newticket

   If you want to send an email instead write your report to
   mc-devel@lists.midnight-commander.org or mc@lists.midnight-commander.org.

   These mailing lists are the most certain way to contact the
   developers.  Remember to mention if you are not on the mailing list
   to make sure that you will receive a copy of replies.

   Give as much details as possible.  A too long message is a lot better
   than a too short message.

   For segmentation faults a stack backtrace is appreciated.  You can
   produce stack backtrace as follows:
     * If segmentation fault produced a core file:
         1. Load the core file by typing "gdb mc core" or "dbx mc core".
         2. Type "where".
         3. Cut and paste the results to your message.
     * If segmentation fault didn't produce a core file:
         1. Load mc by typing "gdb mc" or "dbx mc".
         2. Start mc by typing "run".
         3. Try to reproduce the segmentation fault by doing whatever
            you did last time when the segmentation fault occurred.
         4. Type "where".
         5. Cut and paste the results to your message.
         6. For the future you might want to check out what is the
            command in your shell to allow producing of the core files.
            Usually it is "limit coredumpsize unlimited" or "ulimit
            coredumpsize" or "ulimit -c unlimited".

10.4 How can I join the development?

   To join the development just code the feature you want to add and
   send your patch for inclusion.  Email address is mc-devel@lists.midnight-commander.org.
   Before you start coding check the latest development version.  It
   might be that your feature has already been implemented.

   Note that the authors of GNU Midnight Commander have given all their
   rights on the program to the Free Software Foundation.  You will have
   to do the same if you contribute non-trivial patches.  Otherwise we
   have to reject your patches in order to avoid copyright problems.


11 More information

11.1 This document didn't answer my question.  Where else can I look for
an answer?

   Read messages from the Discussion (mailing list archive) or read the
   Manual.

   Upgrade to a newer version of Midnight Commander.  Many problems are
   fixed in the new versions.

   If you still can't find an answer, post your question to the Midnight
   Commander mailing list.  Its address is mc@lists.midnight-commander.org.

11.2 What mailing lists are there for Midnight Commander?

   Following mailing lists discuss about Midnight Commander:

   mc@lists.midnight-commander.org
          General discussion of GNU Midnight Commander
          To subscribe visit
          https://lists.midnight-commander.org/mailman/listinfo/mc/

   mc-devel@lists.midnight-commander.org
          Technical development discussion
          To subscribe visit
          https://lists.midnight-commander.org/mailman/listinfo/mc-devel/

   mc-commits@googlegroups.com
          mailing list only for applyed commits into master/stable branches
          To subscribe visit
          http://groups.google.com/group/mc-commits/subscribe

   mc-bugs@googlegroups.com
          Mailing list only for tickets and comments (use it as RSS :) )
          To subscribe visit
          http://groups.google.com/group/mc-bugs/subscribe

11.3 Where should I look on the World Wide Web for MC stuff?

   There is a WWW page for Midnight Commander.  The URL is:

     https://www.midnight-commander.org/

11.4 Are the mailing lists archived anywhere?

   The mc and mc-devel lists are archived on the World Wide Web.  There
   are links to the archives on the mailing list pages (see 10.2).


12 Legal issues

12.1 Authorship

   Questions and Answers was written by Janne Kukonlehto.  Parts of it
   originate from Ian Jackson, Miguel de Icaza, Dugan Porter, Norbert
   Warmuth and Paul Sheer.

12.2 Feedback is invited

   Send your comments about this document and GNU Midnight Commander to
   mc@lists.midnight-commander.org

12.3 Disclaimer and copyright

   Note that this document is provided as is.  The information in it is
   not warranted to be correct; you use it at your own risk.

   You can use Questions and Answers according to GNU General Public
   License (see the COPYING file in GNU Midnight Commander source
   distribution).  Questions and Answers is not public domain.