Merge commit 'origin/mc-4.6'
[midnight-commander.git] / FAQ
blob6c894edeb5c68f209e5e2699e8b8d76af0220ac5
1 GNU Midnight Commander
2 Frequently Asked Questions
4    The newest version of this document is available at
5    http://www.midnight-commander.org/browser/FAQ
7      * 1 Getting started
8           + 1.1 What is Midnight Commander?
9           + 1.2 Does it run on my machine?
10           + 1.3 Does it work with my terminal?
11           + 1.4 What else do I need to run MC?
12           + 1.5 Is GNU Midnight Commander Public Domain?  Copyrighted?
13           + 1.6 Where can I get GNU Midnight Commander?
14           + 1.7 I don't have FTP access.  Where can I get MC?
15           + 1.8 I cannot compile MC.  What should I do?
17      * 2 Keyboard
18           + 2.1 What does documentation mean with the C-?, M-? and F?
19             keys?
20           + 2.2 Why don't function keys (or some other key) work?
21           + 2.3 How do I use function keys F11 to F20?
22           + 2.4 Why does the ESC key behave funny?
23           + 2.5 How can I add the plus sign (+) on the command line?
24           + 2.6 C-o doesn't work!
25           + 2.7 What 'keys' are the "a1" and "c1" keys mentioned in the
26             manual?
27           + 2.8 How do I change the key bindings?
29      * 3 Mouse
30           + 3.1 How do I enable mouse support?
31           + 3.2 How do I cut and paste text with mouse?
32           + 3.3 How do I get the extension dependent pop-up menu to
33             pop up?
35      * 4 Display
36           + 4.1 Why do I keep getting "Terminal not powerful enough for
37             SLang" or "Terminal not powerful enough for SLsmg"?
38           + 4.2 Why don't line drawing characters work?
39           + 4.3 Can one use latin-1 characters without losing the lines?
40           + 4.4 I have problems with entering/viewing national
41             characters!
42           + 4.5 How can I get colors?
43           + 4.6 My color_xterm goes completely (or partially) black!
44           + 4.7 Where can I get xterm or rxvt?
45           + 4.8 I got colors working with MC but the other programs
46             don't work at all anymore!
47           + 4.9 Why are there both terminfo and termcap?  Wouldn't one
48             database be enough?
50      * 5 Graphical user interface
51           + 5.1 Xview, Tk and Gnome editions?
52           + 5.2 Why is MC linked with X libraries?
54      * 6 Command line problems
55           + 6.1 How do I stay in the last directory when I exit Midnight
56             Commander?
57           + 6.2 How can I access command line history?
58           + 6.3 How can I complete commands, file names, variable names
59             and so on?
60           + 6.4 I am using ksh.  Can I use functions defined in the
61             .kshrc within MC?
62           + 6.5 Is there any way to include additional options or hot
63             keys to MC?
64           + 6.6 When I use Ctrl-O I don't get a subshell.  How do I fix
65             this?
66           + 6.7 Ctrl-O doesn't work at all.  What happens?
68      * 7 Virtual file systems
69           + 7.1 How can I see the contents of a tar archive?
70           + 7.2 How do I get out of a tar archive?
71           + 7.3 How do I do anonymous ftp with MC?
72           + 7.4 How do I do non-anonymous ftp with MC?
73           + 7.5 How do I close an ftp connection?
74           + 7.6 Why aren't the contents of ftp panel updated?
75           + 7.7 What kind of proxy server works with Midnight Commander?
77      * 8 Internal editor
78           + 8.1 When I try pasting to the internal editor, it indents
79             the amount of indenting increases with each line!
80           + 8.2 Is it possible to use Colorer for syntax highlighting?
82      * 9 Other common problems
83           + 9.1 Is there any way to 'bookmark' favorite ftp-fs links?
84           + 9.2 When I start Midnight Commander, nothing happens!
86      * 10 Development
87           + 10.1 Who has written Midnight Commander?
88           + 10.2 Do I dare to use a development version?
89           + 10.3 How can I report a bug/request for a feature?
90           + 10.4 How can I join the development?
92      * 11 More information
93           + 11.1 This document didn't answer my question.  Where else
94             can I look for an answer?
95           + 11.2 What mailing lists are there for Midnight Commander?
96           + 11.3 Where should I look on the World Wide Web for MC stuff?
97           + 11.4 Are the mailing lists archived anywhere?
99      * 12 Legal issues
100           + 12.1 Authorship
101           + 12.2 Feedback is invited
102           + 12.3 Disclaimer and copyright
105 1 Getting started
107 1.1 What is Midnight Commander?
109    GNU Midnight Commander is a user-friendly yet powerful file manager
110    and visual shell, useful to novice and guru alike.  It provides a
111    clear, user-friendly, and somewhat protected interface to a Unix
112    system while making many frequent file operations more efficient and
113    preserving the full power of the command prompt.  After some
114    practice, you will wonder how you could ever live without it.
116 1.2 Does it run on my machine?
118    GNU Midnight Commander runs on POSIX (Unix-like) operating systems,
119    such as GNU/Linux, FreeBSD, Mac OS X, Solaris, HP-UX and others.  It
120    can also be compiled under Cygwin on Windows.
122    GNU Midnight Commander uses GNU Autoconf which should automatically
123    configure it for every Unix clone.  Following configurations have
124    been tested in the past (this list is very old):
126      * i386-*-linux1.x, 2.x
127      * alpha-linux-linux2
128      * sparc-linux-linux2.x
129      * sparc64-linux-linux2.1
130      * mips-sgi-irix5.x, 6.x
131      * mips-dec-ultrix4.3
132      * rs6000-ibm-aix3.2.5
133      * sparc-sun-sunos4.1
134      * sparc-sun-solaris2.3, 2.4, 2.5
135      * sparc-sun-netbsd1.0
136      * hppa-hp-hpux9
137      * hppa-hp-hpux7
138      * m68k-apple-aux
139      * unixware
140      * mc88110-aviion-dgux5.4R2.01
141      * i386-*-sco3.2v4.2
142      * i386-*-sco3.2v5
144 1.3 Does it work with my terminal?
146    Yes, it does.
148    Because GNU Midnight Commander is a full screen program it doesn't
149    run on dummy terminals but anything more advanced will do (like
150    vt100).  If your terminal works with vi, emacs, elm or pine it will
151    work with GNU Midnight Commander.
153 1.4 What else do I need to run MC?
155    You need a POSIX (Unix compatible) operating system.  If you are
156    running Windows, use Cygwin.
158    To compile any edition you need to have glib 1.2.x or newer
159    installed.  It's available at ftp://ftp.gtk.org/pub/gtk/.  If you
160    don't have glib installed already, please note that glib 2.x is much
161    harder to compile, so your first choice should be glib 1.2.10.
163    If you want to use mouse on the Linux console you need the gpm daemon
164    from ftp://ftp.systemy.it/pub/develop/.  You need nothing extra to
165    use mouse on xterm.
167    If you do not want to use the S-Lang library you could try using
168    ncurses version 4.1 and above.
170 1.5 Is GNU Midnight Commander Public Domain? Copyrighted?
172    Midnight Commander is under GNU Public License which basically means
173    that you may freely copy, change and distribute it, but that you may
174    not impose any restrictions on further distribution, and that you
175    must make the source code available.  This is not the same as Public
176    Domain.  For details, the GNU license is included in GNU Midnight
177    Commander source distribution (the COPYING file).
179    Midnight Commander is now officially a part of the GNU project.
180    All the authors of GNU Midnight Commander have given all their rights
181    on the program to the Free Software Foundation.
183 1.6 Where can I get GNU Midnight Commander?
185    The main site is ftp://ftp.gnome.org/pub/GNOME/stable/sources/mc/
187 1.7 I don't have FTP access.  Where can I get MC?
189    Most GNU/Linux distributions include GNU Midnight Commander.  For
190    example, Debian, Mandrake, Red Hat, Slackware and SuSE.
192 1.8 I cannot compile MC.  What should I do?
194    Make sure you have read the INSTALL file in the sources.  Report the
195    error messages exactly as they appear, mention the versions of your
196    OS, your compiler and whatever else software you think is relevant.
197    If you have compile problems in the VFS code, try disabling it by
198    using "--without-vfs" switch.  As the last resort, you can use
199    precompiled binaries from the GNU Midnight Commander website.
202 2 Keyboard
204 2.1 What does documentation mean with the C-?, M-? and F? keys?
206    GNU Midnight Commander documentation uses emacs style names for
207    keyboard keys.
209    C stands for the Ctrl key.  For example, C-f means that you should
210    hold down the Ctrl key and press the f key.
212    M stands for the Meta key.  Your terminal might call it Alt or
213    Compose instead of Meta.  For example, M-f means that you should hold
214    down the Meta/Alt/Compose key and press the f key.  If your terminal
215    doesn't have Meta, Alt or Compose or they don't work you can use Esc.
216    For M-f press the Esc key and then press the f key.
218    Sometimes Ctrl and Alt are used instead of C and M for simplicity.
219    Keep in mind that Alt can actually be Meta on some keyboards.
221    F? stands for a function key.  If your terminal doesn't have function
222    keys or they don't work you can use Esc.  For example, for F3 press
223    the Esc key and then press the 3 key.
225 2.2 Why don't function keys (or some other key) work?
227    Your terminfo or termcap database has missing or incorrect
228    definitions for function keys.  Type "mc -V" to see what terminal
229    database is being used.  If the result is "using the S-Lang library
230    with terminfo database" and you are using a very old terminfo
231    database, consider installing one of the enhanced terminfo files
232    included in GNU Midnight Commander source distribution.  For example,
233    if you are using xterm type "tic xterm.ti".
235    If the result is "using the S-Lang library with termcap database" you
236    should fix your /etc/termcap database.
238    Up-to-date termcap and terminfo databases are available here:
240      http://www.tuxedo.org/~esr/terminfo/
241      ftp://dickey.his.com/ncurses/
243    You can force Midnight Commander to use the termcap database by
244    giving --with-termcap option to the configure script.  The default
245    is to use terminfo.
247    If you don't have permissions to edit terminal databases you can use
248    Learn keys feature of Midnight Commander instead.  Press Esc 9 o k
249    and follow instructions.
251    If all else fails you can emulate function keys by first pressing the
252    ESC key and then one of the number keys.  For example, if you want to
253    produce F9, press ESC, then 9.  If you don't have a ESC key on your
254    keyboard you can try alt-9 or meta-9.
256 2.3 How do I use function keys F11 to F20?
258    These are normally mapped to function keys F1 to F10 with Shift held,
259    e.g. function key F13 can be activated by pressing Shift-F3.  You can
260    define the keys this way in the Options->Learn Keys dialog.  The
261    convention for PC keyboards is that F11-20 always means Shift with
262    F1-10.
264    You may find that on the Linux console with some keyboard layouts
265    Shift-Fn is interpreted as F(n+12), not as F(n+10).  This is a result
266    of non-uniformity of keyboard layouts.  This is not an intended
267    behavior and it may be fixed some day.  In the meantime, use "Learn
268    Keys" to remedy this inconvenience.
270 2.4 Why does the ESC key behave funny?
272    Midnight Commander uses the ESC key as a prefix for simulating the
273    Meta and Alt keys (for terminals which don't have Meta or Alt, see
274    the three previous questions).  For example, pressing ESC-a is the
275    same as pressing Meta-a.  In addition most terminals use ESC for
276    internal representation of arrow keys, function keys and other
277    enhanced keys.  If you want to use ESC to cancel things you have to
278    press it twice i.e. ESC-ESC.  If you find this cumbersome you can
279    generally use F10 to cancel.  Alternatively turn on the old_esc_mode
280    setting in the ~/.mc/ini file.  The old_esc_mode setting makes ESC
281    work as a prefix only if another key is pressed within 0.5 seconds.
282    After 0.5 seconds the ESC key cancels.  There is no way to make ESC
283    cancel immediately (if we want to be able to use arrows keys and
284    function keys).
286 2.5 How can I add the plus sign (+) on the command line?
288    Press C-q first, then press the + sign.
290    The plus key is the hotkey for the select files command.  If you want
291    to add a literal plus on to the command line you must quote it by
292    pressing C-q first.
294    Another common key which needs the C-q prefix is backslash "\".
296 2.6 C-o doesn't work!
298    Maybe C-o is a stty control character on your terminal.  See man stty
299    for details on how to list and change stty control characters.
301 2.7 What 'keys' are the "a1" and "c1" keys mentioned in the manual?
303    The "a1" key is the key which has the "a1" caption on it.
305    The "c1" key is the key which has the "c1" caption on it.
307    If you have to ask what these two keys are your keyboard hasn't
308    probably got them.  Actually, I have never seen a keyboard which has
309    got them.
311 2.8 How do I change the key bindings?
313    There is no generic way to reconfigure the key bindings.  You can use
314    the "Learn Keys" dialog to assign keys to some actions listed in that
315    dialog.  However, most actions cannot be redefined to use different
316    keys.
319 3 Mouse
321 3.1 How do I enable mouse support?
323    Invoke mc like this (without quotes): "mc -x".  If this doesn't work
324    upgrade to a terminal which compatible with the Xterm mouse
325    sequences.
327    Alternatively, on Linux console you can use gpm.
329 3.2 How do I cut and paste text with mouse?
331    Hold down shift key while using mouse to cut and paste.
333 3.3 How do I get the extension dependent pop-up menu to pop up?
335    It was developed for the GNOME edition.  The text-mode edition
336    doesn't support this feature yet.
339 4 Display
341 4.1 Why do I keep getting "Terminal not powerful enough for SLang" or
342     "Terminal not powerful enough for SLsmg"?
344    This means that your terminfo databases do not contain the correct
345    definitions for your terminal.
347    You could try using a different terminal setting.  If you use csh or
348    tcsh:
350      setenv TERM vt100
352    or if you use sh, bash, ksh or zsh:
354      export TERM=vt100
356    If this doesn't help you can recompile MC to use termcap instead of
357    terminfo:
359      ./configure --with-termcap
360      make
362 4.2 Why don't line drawing characters work?
364    Since version 4.0.13 there's the command line option -a to force use
365    of charaters +, |, - for line drawing (only available when compiled
366    with S-Lang).  Use the -a option if any of the suggestions below
367    doesn't help.
369    In general, there are three cases:
370      * Lines are shown as ASCII characters like this
372       +---------+
373       |         |
374       +---------+
376        This also happens when you use the -a option.  Other than that
377        possible reason is 1 or 2 (see below).
379      * Lines are shown as lower case characters like this
381       lqqqqqqqqqk
382       x         x
383       mqqqqqqqqqj
385        Possible reason is 1 or 2 (see below).
387      * Lines are shown as blanks or missing characters.  Possible reason
388        is 2 or 3 (see below).
390    The reason for the problem is one of following:
392     1. Your terminal might not support line drawing characters.  VT100
393        compatible terminals, rxvt and xterm and color_xterm do support
394        them.
395     2. Your terminfo or termcap database might have missing or incorrect
396        definitions for line drawing characters.  Set the acsc variable
397        in the terminfo database like this:
398        acsc=a\376k\277l\332m\300j\331n\305w\302v\301u\264t\303q\304x
399        \263h\2600\333
400        Don't forget issue 'tic' command.  This supposes you are using PC
401        character set.  The octal values might be different for other
402        character sets.  If you are using termcap instead of terminfo,
403        you should modify above solution appropriately.
404     3. Your terminal font might not support line drawing characters.
405        Try changing the font.
407    Here is Miguel's answer to Torben on this subject.
409    Torben:
411      When I load consolefonts/iso01.f16, I get perfectly right national
412      characters, but the line drawing characters in mc get wrong.  Is it
413      a mc problem, or is it a problem with the font? (I guess it is).
415      Is there a trick?
417    Miguel:
419      First of all, we should determine whether the font has line drawing
420      characters or not.
422      If it has line drawing characters, then a new terminfo entry should
423      be written for this specific case.  Let's call this linux-iso01.
424      The acsc variable should be modified to reflect which characters
425      are used to do the line drawing.
427      If it does not have line drawing characters, then we should get rid
428      of the switch to acsc sequences and make the acsc sequence be just
429      a mapping to the ugly +, -, |, - characters.
431      You can get your terminfo definition by running the infocmp
432      program, making the proper changes and running the tic program to
433      compile your new terminfo database.
435 4.3 Can one use latin-1 characters without losing the lines?
437    Yes, you need a correct font and a correct termcap/terminfo database.
439    For font, if you use xterm try "xterm -fn fixed".
441    For termcap/terminfo database, change the acsc capability in the
442    database.
444 4.4 I have problems with entering/viewing national characters!
446    Upgrade to version 4.0.12 or newer.
448    From the Options - Display Bits dialog select Full 8 bits or ISO
449    8859-1.  In addition, select 8 bit input from the same dialog.
451 4.5 How can I get colors?
453    Invoke mc like this (without quotes): "mc -c".
455    If you get colors, be happy.
457    If your terminal stays black and white, your terminal doesn't support
458    color.  You might want to upgrade to a terminal which compatible with
459    the ANSI color sequences.
461    If your terminal goes completely black, see the next question.
463    More detailed answer:
465    Check that your terminal supports color.  color_xterm, rxvt and Linux
466    console do support, most other terminals don't.  You can test color
467    support with following simple C program:
469     #include <stdio.h>
471     int main (void){
472         printf ("\033[32m Hello world! \033[m\n");
473         return 0;
474     }
476    Compile and run it.  If you see "Hello world!" text in green your
477    terminal supports color, otherwise not (however, for color_xterm see
478    also the next question).
480    Check whether you are using Ncurses or the S-Lang library (type
481    "mc -V" to find out).
483    With S-Lang library you can force color support by setting the
484    environment variable COLORTERM to any value.
486    If you use ncurses library, check that your terminfo database
487    supports color.  If not, you should install one of the enhanced
488    terminfo databases included in GNU Midnight Commander source
489    distribution.
491    You might want to set the TERM environment variable so that you are
492    using the correct terminfo database or termcap entry.
494    If you use color_xterm (or rxvt) the correct value might be
495    xterm-color, xtermc or simply xterm.
497    If you use Linux console the correct value for TERM is linux or
498    console.
500 4.6 My color_xterm goes completely (or partially) black!
502    Some color_xterm terminals define all colors as black instead of the
503    standard ANSI colors.  This makes them go completely black when you
504    try to use Midnight Commander with colors.
506    You will have to override the defaults.  Create a file
507    "color.defaults" which has the following contents:
509     color_xterm*color0:           Black
510     color_xterm*color1:           Red
511     color_xterm*color2:           Green
512     color_xterm*color3:           Yellow
513     color_xterm*color4:           Blue
514     color_xterm*color5:           Magenta
515     color_xterm*color6:           Cyan
516     color_xterm*color7:           White
517     color_xterm*background:       White
518     color_xterm*foreground:       Black
520    (replace color_xterm with the name of your color_xterm, color_xterm
521    mentions its name in its title bar)
523    Now type:
525     xrdb -merge color.defaults
527    Alternatively you can add the suggested contents of the
528    color.defaults file to your .Xdefaults or .Xresources file (or what
529    ever the name of your X configuration file is).  Or you can replace
530    your non-ANSI color_xterm with an ANSI color_xterm.
532 4.7 Where can I get xterm or rxvt?
534    xterm is included with the X Window System, so you probably already
535    have it if you have X.  This version is not actively maintained, but
536    Thomas Dickey maintains his more advanced version of xterm at
537    ftp://dickey.his.com/xterm/
539    rxvt has its own site http://www.rxvt.org/ - get the latest version
540    there.
542 4.8 I got colors working with MC but the other programs don't work at
543 all anymore!
545    Midnight Commander uses terminfo database (if available) but many
546    other programs use termcap database.  If you set the TERM environment
547    variable to a value which has no corresponding entry in termcap
548    database those programs stop working.  You should add the new value
549    of TERM to the termcap database.
551    Example: If you have set TERM to xterm-color locate from /etc/termcap
552    the line which starts:
554     xterm|vs100|xterm terminal emulator
556    Change it to start:
558     xterm|xterm-color|vs100|xterm terminal emulator
560 4.9 Why are there both terminfo and termcap? Wouldn't one database be
561 enough?
563    You might want to read the Unix-Haters Handbook at
564    http://catalog.com/hopkins/unix-haters/handbook.html.  It lists many
565    more reasons why Unix sucks.
567    You can configure which terminal database you want to use with the
568    "--with-termcap" and "--with-terminfo" flags of configure.  If you
569    don't specify them, the configure script will try to use terminfo if
570    available otherwise it will use termcap.
573 5 Graphical user interface
575 5.1 Xview, Tk and Gnome editions?
577    Xview and Tk and GNOME editions have been removed from the sources.
579 5.2 Why is MC linked with X libraries?
581    GNU Midnight Commander is linked with X libraries to read key
582    modifiers from the X Server.  It may be helpful to distinguish
583    between keys that the terminal emulator reports in the same way, e.g.
584    PgUp and Ctrl-PgUp.  Versions of GNU Midnight Commander after 4.6.0
585    will load X libraries dynamically on the systems that support it.
588 6 Command line problems
590 6.1 How do I stay in the last directory when I exit Midnight Commander?
592    See the description of the -P option in the Options section of the
593    manual.
595 6.2 How can I access command line history?
597    Alt-h shows the last commands you executed from the command line.
598    Duplicates are suppressed from the history.  Commands executed from
599    the subshell prompt are not shown.
601    You can put previous commands to the command line with Alt-p.  Alt-n
602    moves you forward in history.
604    Since version 4.1.15 all the input widgets have permanent history.
605    You can summon the history listbox by pressing M-h.
607 6.3 How can I complete commands, file names, variable names and so on?
609    Just press M-Tab.  Press M-Tab again to get a listbox if there are
610    multiple possible completions.
612 6.4 I am using ksh.  Can I use functions defined in the .kshrc within
615    Sorry, MC only supports bash, tcsh and zsh functions.  Ksh functions
616    are not supported because ksh lacks the necessary hooks needed for
617    subshell integration.
619    Switch to bash or zsh.  They are both quite compatible with ksh. 
620    Your ksh functions should work as such or after minimal changes.
622 6.5 Is there any way to include additional options or hot keys to MC?
624    Yes, F2 invokes an user menu,  which is fully configurable.  You can
625    add any shell commands to the user menu.  See the mc(1) man page for
626    more info.
628    Another way to add functionality is the external panelize feature.
629    See the mc(1) man page for more info.
631    And finally, you can code any feature you want yourself.  MC source
632    code is free which means you can change it anyway you want.  There
633    are some limitations to make sure MC stays free.  See GNU General
634    Public License for details.
636 6.6 When I use Ctrl-O I don't get a subshell.  How do I fix this?
638    Only bash, tcsh and zsh can be used as subshell.  Use one of those
639    shells as your default shell, and it will be used as subshell in GNU
640    Midnight Commander.
642 6.7 Ctrl-O doesn't work at all.  What happens?
644    Ctrl-O works if either the subshell is used or the terminal can save
645    the output of the commands so it can be restored.  If neither is
646    true, there is absolutely nothing interesting behind the panels!
648    Only few terminals support screen saving.  It's xterm, rxvt and other
649    xterm-like terminals and virtual terminals on Linux and FreeBSD.
652 7 Virtual file systems
654 7.1 How can I see the contents of a tar archive?
656    If you use keyboard just move the selection bar on the tar file and
657    press enter.  If you use mouse just double-click on the tar file.
659    The recognized suffixes for tar archives are .tar, .tar.gz and .tgz.
660    You can also enter a tar archive by typing "cd filename#utar" where
661    filename is the name of the archive.  In this case, the suffix is not
662    important.
664 7.2 How do I get out of a tar archive?
666    Just press enter on the toplevel ".." file or change to a non-tar
667    directory.  Just typing "cd" with no parameters is enough (it will
668    take you to your home directory).
670 7.3 How do I do anonymous ftp with MC?
672    Just type "cd ftp://hostname" where hostname is the name of the host
673    you want to connect.  Alternatively, select FTP link from the Left or
674    Right menu and type the name of the host you want to connect.
676 7.4 How do I do non-anonymous ftp with MC?
678    Non-anonymous ftp works just like the anonymous ftp but you give the
679    login name with the host name.  For example, type "cd
680    ftp://username@hostname".
682 7.5 How do I close an ftp connection?
684    Just change to a non-ftp directory.  Simply typing "cd" with no
685    parameters is enough (it will take you to your home directory).
687    GNU Midnight Commander closes ftp connection automatically after a
688    timeout or on exit.  It's possible to force disconnect by selecting
689    "Command" -> "Active VFS List" in the menu and using the "Free VFSs
690    Now" button.
692 7.6 Why aren't the contents of ftp panel updated?
694    Update is skipped because there would be a serious performance
695    penalty.  Constantly updating directory panels through a ftp
696    connection would take too much time.
698    You can use C-r to force an update.
700 7.7 What kind of proxy server works with Midnight Commander?
702    There are two kinds of ftp proxies: proxies for ftp clients and
703    proxies for web browsers.
705    Midnight Commander only supports ftp proxies which are meant for ftp
706    clients.  Common WWW proxies (like Squid) are not supported.  A rule
707    of thumb is that if a ftp proxy requires a web browser, it won't work
708    with Midnight Commander.
711 8 Other common problems
713 8.1 When I try pasting to the internal editor, it indents the amount of
714 indenting increases with each line!
716    Either turn off 'Return does autoindent' in the editor options or
717    update GNU Midnight Commander to version 4.6.0 or above - it doesn't
718    autoindent when you are holding Shift.
720 8.2 Is it possible to use Colorer for syntax highlighting?
722    Yes if you submit the patch.  There are no legal problems with it
723    because it's licensed under GPL now.  The homepage of Colorer is
724    http://colorer.sourceforge.net/
727 9 Other common problems
729 9.1 Is there any way to 'bookmark' favorite ftp-fs links?
731    Use the directory hotlist.  Just press control-backslash.  If your
732    national keyboard layout doesn't have backslash key, just press the
733    control key with the key which is the backslash key in the English
734    keyboard layout.
736 9.2 When I start Midnight Commander, nothing happens!
738    When MC is compiled with Samba support, have a look at the
739    "interfaces = ..." line in your smb.conf file. MC uses pretty old
740    Samba code that only expects IP addresses and host names there,
741    but not network interface names (like eth0). MC interprets these
742    names as host names and tries to resolve them using a DNS server.
743    To fix this, ask your system administrator to change the interface
744    names to their assigned IP addresses, or (untried) add the interface
745    names and their IP addresses to the /etc/hosts file.
747    First, invoke MC without subshell support: "mc -u".  If this helps
748    check the shell you are using.  Subshell support works best with
749    bash, although tcsh and zsh are also supported.  You might want to
750    upgrade your shell to a newer version.  If you use something else
751    than bash, tcsh or zsh, subshell support is disabled automatically.
753    If disabling subshell doesn't help, try to reconfigure MC with
754    "--with-included-slang" and "--with-termcap" options and recompile.
755    If this helps, something is wrong with your terminfo database or
756    shared S-Lang library.  For better terminfo databases see chapter 4
757    of this FAQ.  For a better S-Lang library, upgrade to a newer version
758    or keep using the "--with-included-slang" option.
760    Another reason is problems with gpm.  Try using "--nomouse" option to
761    see if it makes any difference.  Restarting gpm can help.  Sometimes
762    it's enough to move the mouse.
764    Also, if you have the DISPLAY environment variable set, but the X
765    server is unreachable (e.g. it's firewalled), this can also cause a
766    delay at startup.  Unset DISPLAY to see if that's the case.
769 10 Development
771 10.1 Who has written Midnight Commander?
773    Midnight Commander was started by Miguel de Icaza and he is the
774    maintainer of the package.  Other authors have joined the project
775    later:
776      * Mauricio Plaza (early releases)
777      * Janne Kukonlehto (joined Sep 27 1994)
778      * Radek Doulik (joined Oct 30 1994)
779      * Fred Leeflang (joined Nov 2 1994)
780      * Dugan Porter (joined Dec 1 1994)
781      * Jakub Jelinek (joined Feb 8 1995)
782      * Ching Hui (joined Jun 27 1995)
783      * Andrej Borsenkow (joined Jul 1996)
784      * Paul Sheer (joined Nov 1 1996)
785      * Norbert Warmuth
786      * Alex I. Tkachenko
788    Alessandro Rubini has been specially helpful with debugging and
789    enhancing of the mouse support.  John E. Davis has made his S-Lang
790    library available to us and answered many questions about it.
792    Many people have contributed bug reports, feature suggestions and
793    small code bits (alphabetical order):
794      * Thomasz Cholewo
795      * Juan Jose Ciarlante
796      * Alexander Dong (OS/2 port, NT port updates)
797      * Erwin van Eijk
798      * Torben Fjerdingstad
799      * Massimo Fontanelli
800      * Juan Grigera (NT port)
801      * Gerd Knorr
802      * Sergey Ya. Korshunoff
803      * Jean-Daniel Luiset
804      * Wim Osterholt
805      * Antonio Palama (old DOS port)
806      * Thomas Pundt
807      * Marcelo Roccasalva
808      * Ilya Rybkin
809      * Vadim Sinolits
810      * Jon Stevens
811      * Adam Tla/lka
813 10.2 Do I dare to use a development version?
815    That's up to you to decide.  Development versions may have nasty bugs
816    at some points of time.  It's up to you to judge whether the new
817    features and fixes for the bugs you know outweigh the risk of unknown
818    bugs.
820 10.3 How can I report a bug/request for a feature?
822    You might first want to get the newest development version to see if
823    the bug is fixed or the feature is added already.
825    Send your report/request to mc-devel@gnome.org or mc@gnome.org. 
826    These mailing lists are the most certain way to contact the
827    developers.  Remember to mention if you are not on the mailing list
828    to make sure that you will receive a copy of replies.
830    Give as much details as possible.  A too long message is a lot better
831    than a too short message.
833    For segmentation faults a stack backtrace is appreciated.  You can
834    produce stack backtrace as follows:
835      * If segmentation fault produced a core file:
836          1. Load the core file by typing "gdb mc core" or "dbx mc core".
837          2. Type "where".
838          3. Cut and paste the results to your message.
839      * If segmentation fault didn't produce a core file:
840          1. Load mc by typing "gdb mc" or "dbx mc".
841          2. Start mc by typing "run".
842          3. Try to reproduce the segmentation fault by doing whatever
843             you did last time when the segmentation fault occurred.
844          4. Type "where".
845          5. Cut and paste the results to your message.
846          6. For the future you might want to check out what is the
847             command in your shell to allow producing of the core files.
848             Usually it is "limit coredumpsize unlimited" or "ulimit
849             coredumpsize" or "ulimit -c unlimited".
851 10.4 How can I join the development?
853    To join the development just code the feature you want to add and
854    send your patch for inclusion.  Email address is mc-devel@gnome.org.
855    Before you start coding check the latest development version.  It
856    might be that your feature has already been implemented.
858    Note that the authors of GNU Midnight Commander have given all their
859    rights on the program to the Free Software Foundation.  You will have
860    to do the same if you contribute non-trivial patches.  Otherwise we
861    have to reject your patches in order to avoid copyright problems.
864 11 More information
866 11.1 This document didn't answer my question.  Where else can I look for
867 an answer?
869    Read messages from the Discussion (mailing list archive) or read the
870    Manual.
872    Upgrade to a newer version of Midnight Commander.  Many problems are
873    fixed in the new versions.
875    If you still can't find an answer, post your question to the Midnight
876    Commander mailing list.  Its address is mc@gnome.org.
878 11.2 What mailing lists are there for Midnight Commander?
880    Following mailing lists discuss about Midnight Commander:
882    mc@gnome.org
883           General discussion of GNU Midnight Commander
884           To subscribe visit
885           http://mail.gnome.org/mailman/listinfo/mc/
887    mc-devel@gnome.org
888           Technical development discussion
889           To subscribe visit
890           http://mail.gnome.org/mailman/listinfo/mc-devel/
892 11.3 Where should I look on the World Wide Web for MC stuff?
894    There is a WWW page for Midnight Commander.  The URL is:
896      http://www.midnight-commander.org/
898 11.4 Are the mailing lists archived anywhere?
900    The mc and mc-devel lists are archived on the World Wide Web.  There
901    are links to the archives on the mailing list pages (see 10.2).
904 12 Legal issues
906 12.1 Authorship
908    Questions and Answers was written by Janne Kukonlehto.  Parts of it
909    originate from Ian Jackson, Miguel de Icaza, Dugan Porter, Norbert
910    Warmuth and Paul Sheer.
912 12.2 Feedback is invited
914    Send your comments about this document and GNU Midnight Commander to
915    mc@gnome.org
917 12.3 Disclaimer and copyright
919    Note that this document is provided as is.  The information in it is
920    not warranted to be correct; you use it at your own risk.
922    You can use Questions and Answers according to GNU General Public
923    License (see the COPYING file in GNU Midnight Commander source
924    distribution).  Questions and Answers is not public domain.