doc/FAQ

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