Ticket #1462: 23_man.patch

File 23_man.patch, 49.8 KB (added by narcan, 15 years ago)
  • doc/man/mc.1.in

    Fix hyphen-used-as-minus-sign and manpage-has-errors-from-man
    old new  
    11.\"TOPICS "Topics:" 
    2 .TH MC 1 "August 2009" "MC Version 4.7.0-pre1" "GNU Midnight Commander" 
     2.TH MC 1 "August 2009" "MC Version 4.7.0\-pre1" "GNU Midnight Commander" 
    33.\"SKIP_SECTION" 
    44.SH "NAME" 
    5 mc \- Visual shell for Unix-like systems. 
     5mc \- Visual shell for Unix\-like systems. 
    66.\"SKIP_SECTION" 
    77.SH "USAGE" 
    88.B mc 
    9 [\-abcCdfhPstuUVx] [\-l log] [dir1 [dir2]] [-e [file]] [-v file] 
     9[\-abcCdfhPstuUVx] [\-l log] [dir1 [dir2]] [\-e [file]] [\-v file] 
    1010.\"NODE "DESCRIPTION" 
    1111.SH "DESCRIPTION" 
    1212GNU Midnight Commander is a directory browser/file manager for 
    13 Unix-like operating systems. 
     13Unix\-like operating systems. 
    1414.\"NODE "OPTIONS" 
    1515.\".\"DONT_SPLIT" 
    1616.SH "OPTIONS" 
     
    4545.BR "mcedit (1)" . 
    4646.TP 
    4747.I \-f, \-\-datadir 
    48 Display the compiled-in search paths for Midnight Commander files. 
     48Display the compiled\-in search paths for Midnight Commander files. 
    4949.TP 
    5050.I \-k, \-\-resetsoft 
    5151Reset softkeys to their default from the termcap/terminfo 
     
    9595Display the version of the program. 
    9696.TP 
    9797.I \-x, \-\-xterm 
    98 Force xterm mode.  Used when running on xterm-capable terminals (two 
     98Force xterm mode.  Used when running on xterm\-capable terminals (two 
    9999screen modes, and able to send mouse escape sequences). 
    100100.PP 
    101101If specified, the first path name is the directory to show in the 
     
    160160selected; if you click with the right button, the file is marked (or 
    161161unmarked, depending on the previous state). 
    162162.PP 
    163 Double-clicking on a file will try to execute the command if it is 
     163Double\-clicking on a file will try to execute the command if it is 
    164164an executable program; and if the 
    165165.\"LINK2" 
    166166extension file 
     
    205205(sometimes labeled ALT or even Compose) keys. In this manual we will 
    206206use the following abbreviations: 
    207207.TP 
    208 .B C-<chr> 
     208.B C\-<chr> 
    209209means hold the Control key while typing the character <chr>. 
    210 Thus C-f would be: hold the Control key and type f. 
     210Thus C\-f would be: hold the Control key and type f. 
    211211.TP 
    212 .B Alt-<chr> 
     212.B Alt\-<chr> 
    213213means hold the Meta or Alt key down while typing <chr>. 
    214214If there is no Meta or Alt key, type 
    215215.IR ESC ,  
    216216release it, then type the character <chr>. 
    217217.TP 
    218 .B S-<chr> 
     218.B S\-<chr> 
    219219means hold the Shift key down while typing <chr>. 
    220220.PP 
    221221All input lines in the Midnight Commander use an approximation to 
     
    274274.\"Extension File Edit" 
    275275then the corresponding command is executed. 
    276276.TP 
    277 .B C-l 
     277.B C\-l 
    278278repaint all the information in the Midnight Commander. 
    279279.TP 
    280 .B C-x c 
     280.B C\-x c 
    281281run the 
    282282.\"LINK2" 
    283283Chmod 
    284284.\"Chmod" 
    285285command on a file or on the tagged files. 
    286286.TP  
    287 .B C-x o 
     287.B C\-x o 
    288288run the 
    289289.\"LINK2" 
    290290Chown 
    291291.\"Chown" 
    292292command on the current file or on the tagged files. 
    293293.TP 
    294 .B C-x l 
     294.B C\-x l 
    295295run the link command. 
    296296.TP 
    297 .B C-x s 
     297.B C\-x s 
    298298run the symbolic link command. 
    299299.TP 
    300 .B C-x i 
     300.B C\-x i 
    301301set the other panel display mode to information. 
    302302.TP 
    303 .B C-x q 
     303.B C\-x q 
    304304set the other panel display mode to quick view. 
    305305.TP 
    306 .B C-x ! 
     306.B C\-x ! 
    307307execute the 
    308308.\"LINK2" 
    309309External panelize 
    310310.\"External panelize" 
    311311command. 
    312312.TP 
    313 .B C-x h 
     313.B C\-x h 
    314314run the 
    315315.\"LINK2" 
    316316add directory to hotlist 
    317317.\"Hotlist" 
    318318command. 
    319319.TP 
    320 .B Alt-! 
     320.B Alt\-! 
    321321executes the Filtered view command, described in the 
    322322.\"LINK2" 
    323323view command\&. 
    324324.\"Internal File Viewer" 
    325325.TP 
    326 .B Alt-? 
     326.B Alt\-? 
    327327executes the 
    328328.\"LINK2" 
    329329Find file 
    330330.\"Find File" 
    331331command. 
    332332.TP 
    333 .B Alt-c 
     333.B Alt\-c 
    334334pops up the 
    335335.\"LINK2" 
    336336quick cd 
    337337.\"Quick cd" 
    338338dialog. 
    339339.TP 
    340 .B C-o 
     340.B C\-o 
    341341when the program is being run in the Linux or FreeBSD console or under 
    342342an xterm, it will show you the output of the previous command.  When ran 
    343343on the Linux console, the Midnight Commander uses an external program 
    344344(cons.saver) to handle saving and restoring of information on the 
    345345screen. 
    346346.PP 
    347 When the subshell support is compiled in, you can type C-o at any time 
     347When the subshell support is compiled in, you can type C\-o at any time 
    348348and you will be taken back to the Midnight Commander main screen, to 
    349 return to your application just type C-o.  If you have an application 
     349return to your application just type C\-o.  If you have an application 
    350350suspended by using this trick, you won't be able to execute other 
    351351programs from the Midnight Commander until you terminate the suspended 
    352352application. 
     
    359359Left and Right Menus\&. 
    360360.\"Left and Right Menus" 
    361361.TP 
    362 .B Tab, C-i 
     362.B Tab, C\-i 
    363363change the current panel. The old other panel becomes the new current 
    364364panel and the old current panel becomes the new other panel. The 
    365365selection bar moves from the old current panel to the new current 
     
    369369to tag files you may use the Insert key (the kich1 terminfo sequence).  
    370370To untag files, just retag a tagged file. 
    371371.TP 
    372 .B C-t 
    373 to change charset of panel you may use C-t (Control-t). 
     372.B C\-t 
     373to change charset of panel you may use C\-t (Control\-t). 
    374374Recoding is made from selected codepage into system codepage. To 
    375375cancel the recoding you may select "directory up" (..) in active panel. 
    376376To cancel the charsets in all directories, select "No translation " in  
    377377the dialog of encodings. 
    378378.TP 
    379 .B Alt-g, Alt-r, Alt-j 
     379.B Alt\-g, Alt\-r, Alt\-j 
    380380used to select the top file in a panel, the middle file and the bottom one, 
    381381respectively. 
    382382.TP 
    383 .B C-s, Alt-s 
     383.B C\-s, Alt\-s 
    384384start a filename search in the directory listing. When the search is 
    385385active, the user input will be added to the search string instead of 
    386386the command line. If the 
    387 .I Show mini-status 
    388 option is enabled the search string is shown on the mini-status 
     387.I Show mini\-status 
     388option is enabled the search string is shown on the mini\-status 
    389389line. When typing, the selection bar will move to the next file 
    390390starting with the typed letters. The 
    391391.I backspace 
    392392or 
    393393.I DEL 
    394 keys can be used to correct typing mistakes. If C-s is pressed 
     394keys can be used to correct typing mistakes. If C\-s is pressed 
    395395again, the next match is searched for. 
    396396.TP 
    397 .B Alt-t 
     397.B Alt\-t 
    398398toggle the current display listing to show the next display listing 
    399399mode. 
    400400With this it is possible to quickly switch to brief listing, long 
    401401listing, user defined listing mode, and back to the default. 
    402402.TP 
    403 .B C-\\\\ (control-backslash) 
     403.B C\-\\\\ (control\-backslash) 
    404404show the 
    405405.\"LINK2" 
    406406directory hotlist 
     
    432432use the "\\" key to unselect a group of files. This is the opposite of 
    433433the Plus key. 
    434434.TP 
    435 .B up-key, C-p 
     435.B up\-key, C\-p 
    436436move the selection bar to the previous entry in the panel. 
    437437.TP 
    438 .B down-key, C-n 
     438.B down\-key, C\-n 
    439439move the selection bar to the next entry in the panel. 
    440440.TP 
    441 .B home, a1, Alt-< 
     441.B home, a1, Alt\-< 
    442442move the selection bar to the first entry in the panel. 
    443443.TP 
    444 .B end, c1, Alt-> 
     444.B end, c1, Alt\-> 
    445445move the selection bar to the last entry in the panel. 
    446446.TP 
    447 .B next-page, C-v 
     447.B next\-page, C\-v 
    448448move the selection bar one page down. 
    449449.TP 
    450 .B prev-page, Alt-v 
     450.B prev\-page, Alt\-v 
    451451move the selection bar one page up. 
    452452.TP 
    453 .B Alt-o 
     453.B Alt\-o 
    454454If the currently selected file is a directory, load that directory on 
    455455the other panel and moves the selection to the next file. 
    456456.TP 
    457 .B Alt-i 
     457.B Alt\-i 
    458458make the current directory of the current panel also the current 
    459459directory of the other panel.  Put the other panel to the listing mode 
    460460if needed.  If the current panel is panelized, the other panel doesn't 
    461461become panelized. 
    462462.TP 
    463 .B C-PageUp, C-PageDown 
     463.B C\-PageUp, C\-PageDown 
    464464only when supported by the terminal: change to ".." and to the currently 
    465465selected directory respectively. 
    466466.TP 
    467 .B Alt-y 
     467.B Alt\-y 
    468468moves to the previous directory in the history, equivalent to clicking 
    469469the 
    470470.I < 
    471471with the mouse. 
    472472.TP 
    473 .B Alt-u 
     473.B Alt\-u 
    474474moves to the next directory in the history, equivalent to clicking the 
    475475.I > 
    476476with the mouse. 
    477477.TP 
    478 .B Alt-Shift-h, Alt-H 
     478.B Alt\-Shift\-h, Alt\-H 
    479479displays the directory history, equivalent to depressing the 'v' with 
    480480the mouse. 
    481481.\"NODE "  Shell Command Line" 
     
    483483This section lists keys which are useful to avoid excessive typing when 
    484484entering shell commands. 
    485485.TP 
    486 .B Alt-Enter 
     486.B Alt\-Enter 
    487487copy the currently selected file name to the command line. 
    488488.TP 
    489 .B C-Enter 
    490 same a Alt-Enter.  May not work on remote systems and some terminals. 
     489.B C\-Enter 
     490same a Alt\-Enter.  May not work on remote systems and some terminals. 
    491491.TP 
    492 .B C-Shift-Enter 
     492.B C\-Shift\-Enter 
    493493copy the full path name of the currently selected file to the command 
    494494line.  May not work on remote systems and some terminals. 
    495495.TP 
    496 .B Alt-Tab 
     496.B Alt\-Tab 
    497497does the filename, command, variable, username and hostname 
    498498.\"LINK2" 
    499499completion 
    500500.\"Completion" 
    501501for you. 
    502502.TP 
    503 .B C-x t, C-x C-t 
     503.B C\-x t, C\-x C\-t 
    504504copy the tagged files (or if there are no tagged files, the selected 
    505 file) of the current panel (C-x t) or of the other panel (C-x C-t) to 
     505file) of the current panel (C\-x t) or of the other panel (C\-x C\-t) to 
    506506the command line. 
    507507.TP 
    508 .B C-x p, C-x C-p 
     508.B C\-x p, C\-x C\-p 
    509509the first key sequence copies the current path name to the command 
    510510line, and the second one copies the unselected panel's path name to 
    511511the command line. 
    512512.TP 
    513 .B C-q 
     513.B C\-q 
    514514the quote command can be used to insert characters that are otherwise 
    515515interpreted by the Midnight Commander (like the '+' symbol) 
    516516.TP 
    517 .B Alt-p, Alt-n 
    518 use these keys to browse through the command history. Alt-p takes you 
    519 to the last entry, Alt-n takes you to the next one. 
     517.B Alt\-p, Alt\-n 
     518use these keys to browse through the command history. Alt\-p takes you 
     519to the last entry, Alt\-n takes you to the next one. 
    520520.TP 
    521 .B Alt-h 
     521.B Alt\-h 
    522522displays the history for the current input line. 
    523523.\"NODE "  General Movement Keys" 
    524524.SH "  General Movement Keys" 
     
    529529Other parts of the Midnight Commander use some of the same movement 
    530530keys, so this section may be of use for those parts too. 
    531531.TP 
    532 .B Up, C-p 
     532.B Up, C\-p 
    533533moves one line backward. 
    534534.TP 
    535 .B Down, C-n 
     535.B Down, C\-n 
    536536moves one line forward. 
    537537.TP 
    538 .B Prev Page, Page Up, Alt-v 
     538.B Prev Page, Page Up, Alt\-v 
    539539moves one page up. 
    540540.TP 
    541 .B Next Page, Page Down, C-v 
     541.B Next Page, Page Down, C\-v 
    542542moves one page down. 
    543543.TP 
    544544.B Home, A1 
     
    550550The help viewer and the file viewer accept the following keys in 
    551551addition the to ones mentioned above: 
    552552.TP 
    553 .B b, C-b, C-h, Backspace, Delete 
     553.B b, C\-b, C\-h, Backspace, Delete 
    554554moves one page up. 
    555555.TP 
    556556.B Space bar 
     
    569569.\"Shell Command Line" 
    570570and for the query dialogs in the program) accept these keys: 
    571571.TP 
    572 .B C-a 
     572.B C\-a 
    573573puts the cursor at the beginning of line. 
    574574.TP 
    575 .B C-e 
     575.B C\-e 
    576576puts the cursor at the end of the line. 
    577577.TP 
    578 .B C-b, move-left 
     578.B C\-b, move\-left 
    579579move the cursor one position left. 
    580580.TP 
    581 .B C-f, move-right 
     581.B C\-f, move\-right 
    582582move the cursor one position right. 
    583583.TP 
    584 .B Alt-f 
     584.B Alt\-f 
    585585moves one word forward. 
    586586.TP 
    587 .B Alt-b 
     587.B Alt\-b 
    588588moves one word backward. 
    589589.TP 
    590 .B C-h, backspace 
     590.B C\-h, backspace 
    591591delete the previous character. 
    592592.TP 
    593 .B C-d, Delete 
     593.B C\-d, Delete 
    594594delete the character in the point (over the cursor). 
    595595.TP 
    596 .B C-@ 
     596.B C\-@ 
    597597sets the mark for cutting. 
    598598.TP 
    599 .B C-w 
     599.B C\-w 
    600600copies the text between the cursor and the mark to a kill buffer and 
    601601removes the text from the input line. 
    602602.TP 
    603 .B Alt-w 
     603.B Alt\-w 
    604604copies the text between the cursor and the mark to a kill buffer. 
    605605.TP 
    606 .B C-y 
     606.B C\-y 
    607607yanks back the contents of the kill buffer. 
    608608.TP 
    609 .B C-k 
     609.B C\-k 
    610610kills the text from the cursor to the end of the line. 
    611611.TP 
    612 .B Alt-p, Alt-n 
    613 Use these keys to browse through the command history. Alt-p takes you 
    614 to the last entry, Alt-n takes you to the next one. 
     612.B Alt\-p, Alt\-n 
     613Use these keys to browse through the command history. Alt\-p takes you 
     614to the last entry, Alt\-n takes you to the next one. 
    615615.TP 
    616 .B Alt-C-h, Alt-Backspace 
     616.B Alt\-C\-h, Alt\-Backspace 
    617617delete one word backward. 
    618618.TP 
    619 .B Alt-Tab 
     619.B Alt\-Tab 
    620620does the filename, command, variable, username and hostname 
    621621.\"LINK2" 
    622622completion 
     
    685685The brief view shows only the file name and it has two columns 
    686686(therefore showing twice as many files as other views). The long view 
    687687is similar to the output of 
    688 .B "ls -l" 
     688.B "ls \-l" 
    689689command. The long view takes the whole screen width. 
    690690.PP 
    691691If you choose the "User" display format, then you have to specify 
     
    712712is an alternative form of the 
    713713.B size 
    714714format. It displays the size of the files and for directories it just 
    715 shows SUB-DIR or UP--DIR. 
     715shows SUB\-DIR or UP\-\-DIR. 
    716716.TP 
    717717.B type 
    718718displays a one character wide type field.  This character is similar to 
    719 what is displayed by ls with the -F flag - 
     719what is displayed by ls with the \-F flag \- 
    720720.B * 
    721721for executable files, 
    722722.B / 
     
    725725for links, 
    726726.B = 
    727727for sockets, 
    728 .B - 
     728.B \- 
    729729for character devices, 
    730730.B + 
    731731for block devices, 
     
    785785followed by the number of characters you want the field to have.  If the 
    786786number is followed by the symbol 
    787787.BR + , 
    788 then the size specifies the minimal field size - if the program finds 
     788then the size specifies the minimal field size \- if the program finds 
    789789out that there is more space on the screen, it will then expand that 
    790790field. 
    791791.PP 
     
    862862for more information). 
    863863.\"NODE "  File Menu" 
    864864.SH "  File Menu" 
    865 The Midnight Commander uses the F1 - F10 keys as keyboard shortcuts 
     865The Midnight Commander uses the F1 \- F10 keys as keyboard shortcuts 
    866866for commands appearing in the file menu.  The escape sequences for the 
    867867function keys are terminfo capabilities kf1 trough kf10.  On terminals 
    868868without function key support, you can achieve the same functionality by 
     
    873873.PP 
    874874.B Help (F1) 
    875875.PP 
    876 Invokes the built-in hypertext help viewer. Inside the 
     876Invokes the built\-in hypertext help viewer. Inside the 
    877877.\"LINK2" 
    878878help viewer\&, 
    879879.\"Contents" 
     
    891891The user menu provides an easy way to provide users with a menu and 
    892892add extra features to the Midnight Commander. 
    893893.PP 
    894 .B View (F3, Shift-F3) 
     894.B View (F3, Shift\-F3) 
    895895.PP 
    896896View the currently selected file. By default this invokes the 
    897897.\"LINK2" 
     
    906906.B PAGER 
    907907environment variable is tried.  If 
    908908.B PAGER 
    909 is also undefined, the "view" command is invoked.  If you use Shift-F3 
     909is also undefined, the "view" command is invoked.  If you use Shift\-F3 
    910910instead, the viewer will be invoked without doing any formatting or 
    911911preprocessing to the file. 
    912912.PP 
    913 .B Filtered View (Alt-!) 
     913.B Filtered View (Alt\-!) 
    914914.PP 
    915915This command prompts for a command 
    916916and its arguments (the argument defaults to the currently selected 
     
    919919.PP 
    920920.B Edit (F4, F14) 
    921921.PP 
    922 Press F4 to edit the highlighted file.  Press F14 (usually Shift-F4) 
     922Press F4 to edit the highlighted file.  Press F14 (usually Shift\-F4) 
    923923to start the editor with a new, empty file. 
    924924Currently they invoke the 
    925925.B vi 
     
    936936Press F5 to pop up an input dialog to copy the currently selected file (or 
    937937the tagged files, if there is at least one file tagged) to the 
    938938directory/filename you specify in the input dialog.  The destination  
    939 defaults to the directory in the non-selected panel. During this 
    940 process, you can press C-c or ESC to abort the operation. For details 
     939defaults to the directory in the non\-selected panel. During this 
     940process, you can press C\-c or ESC to abort the operation. For details 
    941941about source mask (which will be usually either * or ^\\(.*\\)$ depending 
    942942on setting of Use shell patterns) and possible wildcards in the destination 
    943943see 
     
    945945Mask copy/rename\&. 
    946946.\"Mask Copy/Rename" 
    947947.PP 
    948 F15 (usually Shift-F5) is similar, but defaults to the directory in the 
     948F15 (usually Shift\-F5) is similar, but defaults to the directory in the 
    949949selected panel. It always operates on the selected file, regardless of 
    950950any tagged files. 
    951951.PP 
    952952On some systems, it is possible to do the copy in the background by 
    953 clicking on the background button (or pressing Alt-b in the dialog 
     953clicking on the background button (or pressing Alt\-b in the dialog 
    954954box).  The 
    955955.\"LINK2" 
    956956Background Jobs 
    957957.\"Background jobs" 
    958958is used to control the background process. 
    959959.PP 
    960 .B Link (C-x l) 
     960.B Link (C\-x l) 
    961961.PP 
    962962Create a hard link to the current file. 
    963963.PP 
    964 .B SymLink (C-x s) 
     964.B SymLink (C\-x s) 
    965965.PP 
    966966Create a symbolic link to the current file. To those of you who don't 
    967967know what links are: creating a link to a file is a bit like copying 
     
    979979A symbolic link is a reference to the name of the original file. If 
    980980the original file is deleted the symbolic link is useless. It is quite 
    981981easy to notice that the files represent the same image. The Midnight 
    982 Commander shows an "@"-sign in front of the file name if it is a 
     982Commander shows an "@"\-sign in front of the file name if it is a 
    983983symbolic link to somewhere (except to directory, where it shows a tilde (~)). 
    984 The original file which the link points to is shown on mini-status line if the 
    985 .I "Show mini-status" 
     984The original file which the link points to is shown on mini\-status line if the 
     985.I "Show mini\-status" 
    986986option is enabled. Use symbolic links when you want to avoid the 
    987987confusion that can be caused by hard links. 
    988988.PP 
     
    991991Press F6 to pop up an input dialog to copy the currently selected file (or 
    992992the tagged files, if there is at least one file tagged) to the 
    993993directory/filename you specify in the input dialog.  The destination  
    994 defaults to the directory in the non-selected panel. For more details 
     994defaults to the directory in the non\-selected panel. For more details 
    995995look at Copy (F5) operation above, most of the things are quite similar. 
    996996.PP 
    997 F16 (usually Shift-F6) is similar, but defaults to the directory in the 
     997F16 (usually Shift\-F6) is similar, but defaults to the directory in the 
    998998selected panel. It always operates on the selected file, regardless of 
    999999any tagged files. 
    10001000.PP 
    10011001On some systems, it is possible to do the copy in the background by 
    1002 clicking on the background button (or pressing Alt-b in the dialog 
     1002clicking on the background button (or pressing Alt\-b in the dialog 
    10031003box).  The 
    10041004.\"LINK2" 
    10051005Background Jobs 
     
    10131013.B Delete (F8) 
    10141014.PP 
    10151015Delete the currently selected file or the tagged files in the 
    1016 currently selected panel. During the process, you can press C-c or 
     1016currently selected panel. During the process, you can press C\-c or 
    10171017ESC to abort the operation. 
    10181018.PP 
    1019 .B Quick cd (Alt-c) 
     1019.B Quick cd (Alt\-c) 
    10201020Use the 
    10211021.\"LINK2" 
    10221022quick cd 
     
    10511051.I "Select group" 
    10521052command. 
    10531053.PP 
    1054 .B Quit (F10, Shift-F10) 
     1054.B Quit (F10, Shift\-F10) 
    10551055.PP 
    1056 Terminate the Midnight Commander.  Shift-F10 is used when you want to 
    1057 quit and you are using the shell wrapper.  Shift-F10 will not take you 
     1056Terminate the Midnight Commander.  Shift\-F10 is used when you want to 
     1057quit and you are using the shell wrapper.  Shift\-F10 will not take you 
    10581058to the last directory you visited with the Midnight Commander, instead 
    10591059it will stay at the directory where you started the Midnight Commander. 
    10601060.\"NODE "    Quick cd" 
     
    10901090The "Panels on/off" command shows the output of the last shell command. 
    10911091This works only on xterm and on Linux and FreeBSD console. 
    10921092.PP 
    1093 The Compare directories (C-x d) command compares the directory 
     1093The Compare directories (C\-x d) command compares the directory 
    10941094panels with each other. You can then use the Copy (F5) command to make 
    10951095the panels identical. There are three compare methods. The quick method 
    10961096compares only file size and file date. The thorough method makes a 
    1097 full byte-by-byte compare. The thorough method is not available if the 
    1098 machine does not support the mmap(2) system call.  The size-only 
     1097full byte\-by\-byte compare. The thorough method is not available if the 
     1098machine does not support the mmap(2) system call.  The size\-only 
    10991099compare method just compares the file sizes and does not check the 
    11001100contents or the date times, it just checks the file size. 
    11011101.PP 
    11021102The Command history command shows a list of typed commands. The 
    11031103selected command is copied to the command line. The command history 
    1104 can also be accessed by typing Alt-p or Alt-n. 
     1104can also be accessed by typing Alt\-p or Alt\-n. 
    11051105.PP 
    11061106The 
    11071107.\"LINK2" 
    1108 Directory hotlist (C-\\) 
     1108Directory hotlist (C\-\\) 
    11091109.\"Hotlist" 
    11101110command makes changing of the current directory to often used directories 
    11111111faster. 
     
    11411141To get rid of long delays the Midnight Commander creates the tree 
    11421142figure by scanning only a small subset of all the directories. If the 
    11431143directory which you want to see is missing, move to its parent 
    1144 directory and press C-r (or F2). 
     1144directory and press C\-r (or F2). 
    11451145.PP 
    11461146You can use the following keys: 
    11471147.PP 
     
    11561156directory in the other panel and stays in tree view mode in the 
    11571157current panel. 
    11581158.PP 
    1159 .B C-r, F2 (Rescan). 
     1159.B C\-r, F2 (Rescan). 
    11601160Rescan this directory. Use this when the tree figure is out of date: 
    11611161it is missing subdirectories or shows some subdirectories which don't 
    11621162exist any more. 
     
    11911191.B F8 (Delete). 
    11921192Delete this directory from the file system. 
    11931193.PP 
    1194 .B C-s, Alt-s. 
     1194.B C\-s, Alt\-s. 
    11951195Search the next directory matching the search string. If there is 
    11961196no such directory these keys will move one line down. 
    11971197.PP 
    1198 .B C-h, Backspace. 
     1198.B C\-h, Backspace. 
    11991199Delete the last character of the search string. 
    12001200.PP 
    12011201.B Any other character. 
    12021202Add the character to the search string and move to the next directory 
    12031203which starts with these characters. In the tree view you must first 
    1204 activate the search mode by pressing C-s. The search string is shown 
     1204activate the search mode by pressing C\-s. The search string is shown 
    12051205in the mini status line. 
    12061206.PP 
    12071207The following actions are available only in the directory tree. They 
     
    12131213.B Esc, F10. 
    12141214Exit the directory tree. Do not change the directory. 
    12151215.PP 
    1216 The mouse is supported. A double-click behaves like Enter. See 
     1216The mouse is supported. A double\-click behaves like Enter. See 
    12171217also the section on 
    12181218.\"LINK2" 
    12191219mouse support\&. 
     
    12431243search. The Quit button quits the search operation. The Panelize 
    12441244button will place the found files to the current directory panel so 
    12451245that you can do additional operations on them (view, copy, move, 
    1246 delete and so on). After panelizing you can press C-r to return to the 
     1246delete and so on). After panelizing you can press C\-r to return to the 
    12471247normal file listing. 
    12481248.PP 
    12491249It is possible to have a list of directories that the Find File command 
    12501250should skip during the search (for example, you may want to avoid 
    1251 searches on a CD-ROM or on a NFS directory that is mounted across a slow 
     1251searches on a CD\-ROM or on a NFS directory that is mounted across a slow 
    12521252link). 
    12531253.PP 
    12541254Directories to be skipped should be set on the variable 
     
    12821282panelization to run the following command: 
    12831283.PP 
    12841284.nf 
    1285 find . -type l -print 
     1285find . \-type l \-print 
    12861286.fi 
    12871287.PP 
    12881288Upon command completion, the directory contents of the panel will no 
     
    13091309directory corresponding to the selected label.  From the hotlist dialog, 
    13101310you can remove already created label/directory pairs and add new ones. 
    13111311To add new directories quickly, you can use the Add to hotlist command 
    1312 (C-x h), which adds the current directory into the directory hotlist, 
     1312(C\-x h), which adds the current directory into the directory hotlist, 
    13131313asking just for the label for the directory. 
    13141314.PP 
    13151315This makes cd to often used directories faster. You may consider using the 
     
    13901390.I Include 
    13911391(to add rules from the common section). 
    13921392.I command 
    1393 is any one-line shell command, with the simple 
     1393is any one\-line shell command, with the simple 
    13941394.\"LINK2" 
    13951395macro substitution\&. 
    13961396.\"Macro Substitution" 
     
    14131413The user menu is a menu of useful actions that can be customized by 
    14141414the user. When you access the user menu, the 
    14151415file .mc.menu from the current directory is used if it exists, 
    1416 but only if it is owned by user or root and is not world-writable. 
     1416but only if it is owned by user or root and is not world\-writable. 
    14171417If no such file found, ~/.mc/menu is tried in the same way, 
    1418 and otherwise mc uses the default system-wide menu 
     1418and otherwise mc uses the default system\-wide menu 
    14191419@prefix@/share/mc/mc.menu. 
    14201420.PP 
    14211421The format of the menu file is very simple. Lines that start with 
     
    14371437.PP 
    14381438.nf 
    14391439A       Dump the currently selected file 
    1440         od -c %f 
     1440        od \-c %f 
    14411441 
    14421442B       Edit a bug report and send it to root 
    1443         I=`mktemp ${MC_TMPDIR:-/tmp}/mail.XXXXXX` || exit 1 
     1443        I=`mktemp ${MC_TMPDIR:\-/tmp}/mail.XXXXXX` || exit 1 
    14441444        vi $I 
    1445         mail -s "Midnight Commander bug" root < $I 
    1446         rm -f $I 
     1445        mail \-s "Midnight Commander bug" root < $I 
     1446        rm \-f $I 
    14471447 
    14481448M       Read mail 
    1449         emacs -f rmail 
     1449        emacs \-f rmail 
    14501450 
    14511451N       Read Usenet news 
    1452         emacs -f gnus 
     1452        emacs \-f gnus 
    14531453 
    14541454H       Call the info hypertext browser 
    14551455        info 
    14561456 
    14571457J       Copy current directory to other panel recursively 
    1458         tar cf - . | (cd %D && tar xvpf -) 
     1458        tar cf \- . | (cd %D && tar xvpf \-) 
    14591459 
    14601460K       Make a release of the current subdirectory 
    1461         echo -n "Name of distribution file: " 
     1461        echo \-n "Name of distribution file: " 
    14621462        read tar 
    1463         ln -s %d `dirname %d`/$tar 
     1463        ln \-s %d `dirname %d`/$tar 
    14641464        cd .. 
    14651465        tar cvhf ${tar}.tar $tar 
    14661466 
     
    14761476true, the menu entry will be the default entry. 
    14771477.PP 
    14781478.nf 
    1479 Condition syntax:       = <sub-cond> 
    1480   or:                   = <sub-cond> | <sub-cond> ... 
    1481   or:                   = <sub-cond> & <sub-cond> ... 
     1479Condition syntax:       = <sub\-cond> 
     1480  or:                   = <sub\-cond> | <sub\-cond> ... 
     1481  or:                   = <sub\-cond> & <sub\-cond> ... 
    14821482 
    1483 Sub-condition is one of following: 
     1483Sub\-condition is one of following: 
    14841484 
    14851485  y <pattern>           syntax of current file matching pattern? 
    14861486                        (for edit menu only) 
     
    14911491  t <type>              current file of type? 
    14921492  T <type>              other file of type? 
    14931493  x <filename>          is it executable filename? 
    1494   ! <sub-cond>          negate the result of sub-condition 
     1494  ! <sub\-cond>         negate the result of sub\-condition 
    14951495.fi 
    14961496.PP 
    14971497Pattern is a normal shell pattern or a regular expression, according 
     
    15351535.PP 
    15361536.nf 
    15371537= f *.tar.gz | f *.tgz & t n 
    1538 L       List the contents of a compressed tar-archive 
    1539         gzip -cd %f | tar xvf - 
     1538L       List the contents of a compressed tar\-archive 
     1539        gzip \-cd %f | tar xvf \- 
    15401540.fi 
    15411541.PP 
    15421542.B Addition Conditions 
     
    16161616.PP 
    16171617.I Show Backup Files. 
    16181618If enabled, the Midnight Commander will show files ending with a tilde. 
    1619 Otherwise, they won't be shown (like GNU's ls option -B). 
     1619Otherwise, they won't be shown (like GNU's ls option \-B). 
    16201620.PP 
    16211621.I Show Hidden Files. 
    16221622If enabled, the Midnight Commander will show all files that start with 
    1623 a dot (like ls -a). 
     1623a dot (like ls \-a). 
    16241624.PP 
    16251625.I Mark moves down. 
    16261626If enabled, the selection bar will move down when you mark a file (with 
     
    16421642.I Fast directory reload. 
    16431643If this option is enabled, the Midnight Commander will use a trick to 
    16441644determine if the directory contents have changed.  The trick is to reload 
    1645 the directory only if the i-node of the directory has changed; this means 
     1645the directory only if the i\-node of the directory has changed; this means 
    16461646that reloads only happen when files are created or deleted.  If what 
    1647 changes is the i-node for a file in the directory (file size changes, 
     1647changes is the i\-node for a file in the directory (file size changes, 
    16481648mode or owner changes, etc) the display is not updated.  In these cases, 
    16491649if you have the option on, you have to rescan the directory manually 
    1650 (with C-r). 
     1650(with C\-r). 
    16511651.PP 
    16521652.B Pause after run 
    16531653.PP 
     
    16581658.I Never. 
    16591659Means that you do not want to see the output of your command.  If you 
    16601660are using the Linux or FreeBSD console or an xterm, you will be able to 
    1661 see the output of the command by typing C-o. 
     1661see the output of the command by typing C\-o. 
    16621662.PP 
    16631663.I On dumb terminals. 
    16641664You will get the pause message on terminals that are not capable of 
     
    16871687is disabled. 
    16881688.PP 
    16891689.I Shell Patterns. 
    1690 By default the Select, Unselect and Filter commands will use shell-like 
     1690By default the Select, Unselect and Filter commands will use shell\-like 
    16911691regular expressions. The following conversions are performed to achieve 
    16921692this: the '*' is replaced by '.*' (zero or more characters); the '?' 
    16931693is replaced by '.' (exactly one character) and '.' by the literal 
     
    17011701.PP 
    17021702.I Auto menus. 
    17031703If this option is enabled, the user menu will be invoked at startup. 
    1704 Useful for building menus for non-unixers. 
     1704Useful for building menus for non\-unixers. 
    17051705.PP 
    17061706.I Use internal editor. 
    1707 If this option is enabled, the built-in file editor is used to edit 
     1707If this option is enabled, the built\-in file editor is used to edit 
    17081708files. If the option is disabled, the editor specified in the 
    17091709.B EDITOR 
    17101710environment variable is used. 
     
    17161716.\"Internal File Editor" 
    17171717.PP 
    17181718.I Use internal viewer. 
    1719 If this option is enabled, the built-in file viewer is used to view 
     1719If this option is enabled, the built\-in file viewer is used to view 
    17201720files. If the option is disabled, the pager specified in the 
    17211721.B PAGER 
    17221722environment variable is used. 
     
    17331733completions 
    17341734.\"Completion" 
    17351735if the completion is ambiguous only when you press 
    1736 .B Alt-Tab 
     1736.B Alt\-Tab 
    17371737for the second time.  For the first time, it just completes as much as 
    17381738possible and beeps in the case of ambiguity.  Enable this option if you 
    17391739want to see all possible completions even after pressing 
    1740 .B Alt-Tab 
     1740.B Alt\-Tab 
    17411741the first time. 
    17421742.PP 
    17431743.I Rotating dash. 
     
    17451745Midnight Commander shows a rotating dash in the upper right corner 
    17461746as a work in progress indicator. 
    17471747.PP 
    1748 .I Lynx-like motion. 
     1748.I Lynx\-like motion. 
    17491749If this option is enabled, 
    17501750you may use the arrows keys to automatically chdir if the 
    17511751current selection is a subdirectory and the shell command 
     
    18001800and so on). 
    18011801.PP 
    18021802If the 
    1803 .I Show Mini-Status 
     1803.I Show Mini\-Status 
    18041804option is enabled, one line of status information about the currently 
    18051805selected item is shown at the bottom of the panels. 
    18061806.PP 
     
    18181818.\"NODE "    Display bits" 
    18191819.SH "    Display bits" 
    18201820This is used to configure the range of visible characters on the 
    1821 screen.  This setting may be 7-bits if your terminal/curses supports 
    1822 only seven output bits, ISO-8859-1 displays all the characters in the 
    1823 ISO-8859-1 map and full 8 bits is for those terminals that can display 
     1821screen.  This setting may be 7\-bits if your terminal/curses supports 
     1822only seven output bits, ISO\-8859\-1 displays all the characters in the 
     1823ISO\-8859\-1 map and full 8 bits is for those terminals that can display 
    18241824full 8 bit characters. 
    18251825.\"NODE "    Learn keys" 
    18261826.SH "    Learn keys" 
     
    18811881regular tar file. 
    18821882.PP 
    18831883Now, since we all love to browse files and tar files all over the disk, 
    1884 it's common that you will leave a tar file and the re-enter it later. 
     1884it's common that you will leave a tar file and the re\-enter it later. 
    18851885Since decompression is slow, the Midnight Commander will cache the 
    18861886information in memory for a limited time.  When the timeout expires, all 
    18871887the resources associated with the file system are released.  The default 
     
    18961896.PP 
    18971897.I ftp anonymous password 
    18981898is the password used when you login as "anonymous".  Some sites require 
    1899 a valid e-mail address.  On the other hand, you probably don't want to 
    1900 give your real e-mail address to untrusted sites, especially if you are 
     1899a valid e\-mail address.  On the other hand, you probably don't want to 
     1900give your real e\-mail address to untrusted sites, especially if you are 
    19011901not using spam filtering. 
    19021902.PP 
    19031903ftpfs keeps the directory listing it fetches from a FTP server in a cache.  
     
    19421942.SH "    Save Setup" 
    19431943At startup the Midnight Commander will try to load initialization 
    19441944information from the ~/.mc/ini file. If this file doesn't exist, it will 
    1945 load the information from the system-wide configuration file, located in 
    1946 @prefix@/share/mc/mc.ini. If the system-wide configuration file doesn't 
     1945load the information from the system\-wide configuration file, located in 
     1946@prefix@/share/mc/mc.ini. If the system\-wide configuration file doesn't 
    19471947exist, MC uses the default settings. 
    19481948.PP 
    19491949The 
     
    20082008.PP 
    20092009.I Previous directory. 
    20102010You can jump to the directory you were previously by using the special 
    2011 directory name '-' like this: 
    2012 .B cd - 
     2011directory name '\-' like this: 
     2012.B cd \- 
    20132013.PP 
    20142014.I CDPATH directories. 
    20152015If the directory specified to the 
     
    21552155users may specify startup commands in the ~/.mc/tcshrc file. 
    21562156.PP 
    21572157When the subshell code is used, you can suspend applications at any 
    2158 time with the sequence C-o and jump back to the Midnight Commander, if 
     2158time with the sequence C\-o and jump back to the Midnight Commander, if 
    21592159you interrupt an application, you will not be able to run other 
    21602160external commands until you quit the application you interrupted. 
    21612161.PP 
     
    21712171.\"NODE "Chmod" 
    21722172.SH "Chmod" 
    21732173The Chmod window is used to change the attribute bits in a group of 
    2174 files and directories.  It can be invoked with the C-x c key combination. 
     2174files and directories.  It can be invoked with the C\-x c key combination. 
    21752175.PP 
    2176 The Chmod window has two parts - 
     2176The Chmod window has two parts \- 
    21772177.I Permissions 
    21782178and 
    21792179.IR File . 
     
    22242224.\"NODE "Chown" 
    22252225.SH "Chown" 
    22262226The Chown command is used to change the owner/group of a file. The hot 
    2227 key for this command is C-x o. 
     2227key for this command is C\-x o. 
    22282228.\"NODE "Advanced Chown" 
    22292229.SH "Advanced Chown" 
    22302230The Advanced Chown command is the 
     
    22722272The recursive delete dialog is shown when you try to delete a directory 
    22732273which is not empty.  Press the Yes button to delete the directory 
    22742274recursively, the No button to skip the directory, the All button to 
    2275 delete all the directories and the None button to skip all the non-empty 
     2275delete all the directories and the None button to skip all the non\-empty 
    22762276directories.  You can abort the whole operation by pressing the Abort 
    22772277button.  If you selected the Yes or All button you will be asked for a 
    22782278confirmation.  Type "yes" only if you are really sure you want to do the 
     
    24332433with constants like this: 
    24342434.PP 
    24352435.nf 
    2436 "String" -1 0xBB 012 "more text" 
     2436"String" \-1 0xBB 012 "more text" 
    24372437.fi 
    24382438.PP 
    2439 Note that 012 is an octal number.  -1 is converted to 0xFF. 
     2439Note that 012 is an octal number.  \-1 is converted to 0xFF. 
    24402440.PP 
    24412441Here is a listing of the actions associated with each key that the 
    24422442Midnight Commander handles in the internal file viewer. 
    24432443.PP 
    24442444.B F1 
    2445 Invoke the built-in hypertext help viewer. 
     2445Invoke the built\-in hypertext help viewer. 
    24462446.PP 
    24472447.B F2 
    24482448Toggle the wrap mode. 
     
    24632463.B F7 
    24642464Normal search / hex mode search. 
    24652465.PP 
    2466 .B C-s, F17, n. 
     2466.B C\-s, F17, n. 
    24672467Start normal search if there was no previous search expression else 
    24682468find next match. 
    24692469.PP 
    2470 .B C-r. 
     2470.B C\-r. 
    24712471Start reverse search if there was no previous search expression else 
    24722472find next match. 
    24732473.PP 
     
    24862486.B F10, Esc. 
    24872487Exit the internal file viewer. 
    24882488.PP 
    2489 .B next-page, space, C-v. 
     2489.B next\-page, space, C\-v. 
    24902490Scroll one page forward. 
    24912491.PP 
    2492 .B prev-page, Alt-v, C-b, backspace. 
     2492.B prev\-page, Alt\-v, C\-b, backspace. 
    24932493Scroll one page backward. 
    24942494.PP 
    2495 .B down-key 
     2495.B down\-key 
    24962496Scroll one line forward. 
    24972497.PP 
    2498 .B up-key 
     2498.B up\-key 
    24992499Scroll one line backward. 
    25002500.PP 
    2501 .B C-l 
     2501.B C\-l 
    25022502Refresh the screen. 
    25032503.PP 
    2504 .B C-o 
     2504.B C\-o 
    25052505Switch to the subshell and show the command screen. 
    25062506.PP 
    25072507.B ! 
    2508 Like C-o, but run a new shell if the subshell is not running. 
     2508Like C\-o, but run a new shell if the subshell is not running. 
    25092509.PP 
    25102510.B "[n] m" 
    25112511Set the mark n. 
     
    25132513.B "[n] r" 
    25142514Jump to the mark n. 
    25152515.PP 
    2516 .B C-f 
     2516.B C\-f 
    25172517Jump to the next file. 
    25182518.PP 
    2519 .B C-b 
     2519.B C\-b 
    25202520Jump to the previous file. 
    25212521.PP 
    2522 .B Alt-r 
     2522.B Alt\-r 
    25232523Toggle the ruler. 
    25242524.PP 
    25252525It's possible to instruct the file viewer how to display a file, look 
     
    25292529.\"Extension File Edit" 
    25302530.\"NODE "Internal File Editor" 
    25312531.SH "Internal File Editor" 
    2532 The internal file editor is a full-featured full screen editor.  It can 
     2532The internal file editor is a full\-featured full screen editor.  It can 
    25332533edit files up to 64 megabytes.  It is possible to edit binary files.  
    25342534The internal file editor is invoked using 
    25352535.B F4 
     
    25382538option is set in the initialization file. 
    25392539.PP 
    25402540The features it presently supports are: block copy, move, delete, cut, 
    2541 paste; key for key undo; pull-down menus; file insertion; macro 
    2542 commands; regular expression search and replace; shift-arrow text highlighting 
    2543 (if supported by the terminal); insert-overwrite toggle; word wrap; 
     2541paste; key for key undo; pull\-down menus; file insertion; macro 
     2542commands; regular expression search and replace; shift\-arrow text highlighting 
     2543(if supported by the terminal); insert\-overwrite toggle; word wrap; 
    25442544autoindent; tunable tab size; syntax highlighting for various file 
    25452545types; and an option to pipe text blocks through shell commands like 
    25462546indent and ispell. 
    25472547.PP 
    25482548The editor is very easy to use and requires no tutoring. To see what 
    2549 keys do what, just consult the appropriate pull-down menu. Other keys 
     2549keys do what, just consult the appropriate pull\-down menu. Other keys 
    25502550are: Shift movement keys do text highlighting. 
    2551 .B Ctrl-Ins 
     2551.B Ctrl\-Ins 
    25522552copies to the file 
    25532553.B cooledit.clip 
    25542554and 
    2555 .B Shift-Ins 
     2555.B Shift\-Ins 
    25562556pastes from cooledit.clip. 
    2557 .B Shift-Del 
     2557.B Shift\-Del 
    25582558cuts to 
    25592559.BR cooledit.clip , 
    25602560and 
    2561 .B Ctrl-Del 
     2561.B Ctrl\-Del 
    25622562deletes highlighted text. Mouse highlighting also works, and you 
    25632563can override the mouse as usual by holding down the shift key 
    25642564while dragging the mouse to let normal terminal mouse highlighting 
    25652565work. 
    25662566.PP 
    25672567To define a macro, press 
    2568 .B Ctrl-R 
     2568.B Ctrl\-R 
    25692569and then type out the key 
    25702570strokes you want to be executed. Press 
    2571 .B Ctrl-R 
     2571.B Ctrl\-R 
    25722572again when finished. You can then assign the macro to any key you 
    25732573like by pressing that key. The macro is executed when you press 
    2574 .B Ctrl-A 
     2574.B Ctrl\-A 
    25752575and then the assigned key. The macro is also executed if 
    25762576you press Meta, Ctrl, or Esc and the assigned key, provided that the 
    25772577key is not used for any other function. Once defined, the macro 
     
    25922592.B .mc/cedit/edit.indent.rc 
    25932593in your home directory the first time you use it. 
    25942594.PP 
    2595 The editor also displays non-us characters (160+). When editing 
     2595The editor also displays non\-us characters (160+). When editing 
    25962596binary files, you should set 
    25972597.B display bits 
    25982598to 7 bits in the options menu to keep the spacing clean. 
     
    26102610.BR @ ) 
    26112611or command (if you are on the command line in the position where you 
    26122612might type a command, possible completions then include shell reserved 
    2613 words and shell built-in commands as well) in turn.  If none of these 
     2613words and shell built\-in commands as well) in turn.  If none of these 
    26142614matches, filename completion is attempted. 
    26152615.PP 
    26162616Filename, username, variable and hostname completion works on all input 
     
    26282628the correct entry.  You can also type the first letters in which the 
    26292629possibilities differ to move to a subset of all possibilities and 
    26302630complete as much as possible.  If you press 
    2631 .B Alt-Tab 
     2631.B Alt\-Tab 
    26322632again, only the subset will be shown in the listbox, otherwise the first 
    26332633item which matches all the previous characters will be highlighted.  As 
    26342634soon as there is no ambiguity, dialog disappears, but you can hide it by 
     
    26402640Complete: show all 
    26412641.\"Configuration" 
    26422642is disabled, the dialog pops up only if you press 
    2643 .B Alt-Tab 
     2643.B Alt\-Tab 
    26442644for the second time, for the first time MC just beeps. 
    26452645.\"NODE "Virtual File System" 
    26462646.SH "Virtual File System" 
     
    26872687.I cd 
    26882688command to a path name that looks like this: 
    26892689.PP 
    2690 .I /#ftp:[!][user[:pass]@]machine[:port][remote-dir] 
     2690.I /#ftp:[!][user[:pass]@]machine[:port][remote\-dir] 
    26912691.PP 
    26922692The 
    26932693.IR user , 
    26942694.I port 
    26952695and 
    2696 .I remote-dir 
     2696.I remote\-dir 
    26972697elements are optional.  If you specify the 
    26982698.I user 
    26992699element, the Midnight Commander will login to the remote machine as that 
     
    27132713.PP 
    27142714.nf 
    27152715    /#ftp:ftp.nuclecu.unam.mx/linux/local 
    2716     /#ftp:tsx-11.mit.edu/pub/linux/packages 
     2716    /#ftp:tsx\-11.mit.edu/pub/linux/packages 
    27172717    /#ftp:!behind.firewall.edu/pub 
    2718     /#ftp:guest@remote-host.com:40/pub 
     2718    /#ftp:guest@remote\-host.com:40/pub 
    27192719    /#ftp:miguel:xxx@server/pub 
    27202720.fi 
    27212721.PP 
     
    27262726dialog box for ftpfs options. 
    27272727.\"NODE "  Tar File System" 
    27282728.SH "  Tar File System" 
    2729 The tar file system provides you with read-only access to your tar 
     2729The tar file system provides you with read\-only access to your tar 
    27302730files and compressed tar files by using the chdir command.  To change 
    27312731your directory to a tar file, you change your current directory to the 
    27322732tar file by using the following syntax: 
    27332733.PP 
    2734 .I /filename.tar#utar/[dir-inside-tar] 
     2734.I /filename.tar#utar/[dir\-inside\-tar] 
    27352735.PP 
    27362736The mc.ext file already provides a shortcut for tar files, this means 
    27372737that usually you just point to a tar file and press return to enter 
     
    27442744Examples: 
    27452745.PP 
    27462746.nf 
    2747     mc-3.0.tar.gz#utar/mc-3.0/vfs 
    2748     /ftp/GCC/gcc-2.7.0.tar#utar 
     2747    mc\-3.0.tar.gz#utar/mc\-3.0/vfs 
     2748    /ftp/GCC/gcc\-2.7.0.tar#utar 
    27492749.fi 
    27502750.PP 
    27512751The latter specifies the full path of the tar archive. 
     
    27542754The fish file system is a network based file system that allows you to 
    27552755manipulate the files in a remote machine as if they were local. To use 
    27562756this, the other side has to either run fish server, or has to have 
    2757 bash-compatible shell. 
     2757bash\-compatible shell. 
    27582758.PP 
    27592759To connect to a remote machine, you just need to chdir 
    27602760into a special directory which name is in the following 
    27612761format: 
    27622762.PP 
    2763 .I /#sh:[user@]machine[:options]/[remote-dir] 
     2763.I /#sh:[user@]machine[:options]/[remote\-dir] 
    27642764.PP 
    27652765The 
    27662766.I user, 
    27672767.I options 
    27682768and 
    2769 .I remote-dir 
     2769.I remote\-dir 
    27702770elements are optional.  If you specify the 
    27712771.I user 
    27722772element, the Midnight Commander will try to login on the remote 
     
    27742774.PP 
    27752775The 
    27762776.I options 
    2777 are 'C' - use compression and 'rsh' use rsh instead of ssh.  If the 
    2778 .I remote-dir 
     2777are 'C' \- use compression and 'rsh' use rsh instead of ssh.  If the 
     2778.I remote\-dir 
    27792779element is present, your current directory on the remote machine will be 
    27802780set to this one. 
    27812781.PP 
     
    27962796To connect to a remote machine, you just need to chdir into a special 
    27972797directory which name is in the following format: 
    27982798.PP 
    2799 .I /#mc:[user@]machine[:port][remote-dir] 
     2799.I /#mc:[user@]machine[:port][remote\-dir] 
    28002800.PP 
    28012801The 
    28022802.I user, port 
    28032803and 
    2804 .I remote-dir 
     2804.I remote\-dir 
    28052805elements are optional.  If you specify the 
    28062806.I user 
    28072807element then the Midnight Commander will try to logon on the remote 
     
    28122812element is used when the remote server is running on a special port 
    28132813(see the mcserv(8) manual page for more information about ports); 
    28142814finally, if the 
    2815 .I remote-dir 
     2815.I remote\-dir 
    28162816element is present, your current directory on the remote machine will 
    28172817be set to this one. 
    28182818.PP 
     
    28532853(accessible from the menubar) or you may directly change your current 
    28542854directory to it using the cd command to a path name that looks like this: 
    28552855.PP 
    2856 .I /#smb:[user@]machine[/service][/remote-dir] 
     2856.I /#smb:[user@]machine[/service][/remote\-dir] 
    28572857.PP 
    28582858The 
    28592859.IR user , 
    28602860.I service 
    28612861and 
    2862 .I remote-dir 
     2862.I remote\-dir 
    28632863elements are optional. 
    28642864The 
    28652865.IR user , 
     
    28832883.PP 
    28842884Extfs filesystems can be divided into two categories: 
    28852885.PP 
    2886 1. Stand-alone filesystems, which are not associated with any existing 
    2887 file.  They represent certain system-wide data as a directory tree. 
     28861. Stand\-alone filesystems, which are not associated with any existing 
     2887file.  They represent certain system\-wide data as a directory tree. 
    28882888You can invoke them by typing 
    28892889.RI ' "cd #fsname" ' 
    28902890where fsname is an extfs short name (see below).  Examples of such 
    28912891filesystems include audio (list audio tracks on the CD) or apt (list of 
    28922892all Debian packages in the system). 
    28932893.PP 
    2894 For example, to list CD-Audio tracks on your CD-ROM drive, type 
     2894For example, to list CD\-Audio tracks on your CD\-ROM drive, type 
    28952895.PP 
    28962896.nf 
    28972897  cd #audio 
     
    29152915In many aspects, you could treat extfs like any other directory.  For 
    29162916instance, you can add it to the hotlist or change to it from directory 
    29172917history.  An important limitation is that you cannot invoke shell 
    2918 commands inside extfs, just like any other non-local VFS. 
     2918commands inside extfs, just like any other non\-local VFS. 
    29192919.PP 
    29202920Common extfs scripts included with Midnight Commander are: 
    29212921.TP 
     
    29542954.RI ( "cd filename#lslR" ). 
    29552955.TP 
    29562956.B mailfs 
    2957 mbox-style mailbox files support 
     2957mbox\-style mailbox files support 
    29582958.RI ( "cd mailbox#mailfs" ). 
    29592959.TP 
    29602960.B patchfs 
     
    29952995The Midnight Commander will try to detect if your terminal supports 
    29962996color using the terminal database and your terminal name.  Sometimes 
    29972997it gets confused, so you may force color mode or disable color mode 
    2998 using the -c and -b flag respectively. 
     2998using the \-c and \-b flag respectively. 
    29992999.PP 
    30003000If the program is compiled with the Slang screen manager instead of 
    30013001ncurses, it will also check the variable 
    30023002.B COLORTERM, 
    3003 if it is set, it has the same effect as the -c flag. 
     3003if it is set, it has the same effect as the \-c flag. 
    30043004.PP 
    30053005You may specify terminals that always force color mode 
    30063006by adding the 
     
    30123012.nf 
    30133013[Colors] 
    30143014color_terminals=linux,xterm 
    3015 color_terminals=terminal-name1,terminal-name2... 
     3015color_terminals=terminal\-name1,terminal\-name2... 
    30163016.fi 
    30173017.PP 
    30183018The program can be compiled with both ncurses and slang, ncurses does 
     
    30993099.I stalelink 
    31003100is used for stale symbolic links; 
    31013101.I device 
    3102 - character and block devices; 
     3102\- character and block devices; 
    31033103.I special 
    31043104is used for special files, such as pipes and sockets; 
    31053105.I core 
     
    31653165arrived, then the ESC key is interpreted as a cancel key (ESC ESC). 
    31663166.TP 
    31673167.I only_leading_plus_minus 
    3168 Allow special treatment for '+', '-', '*' in the command line (select, 
     3168Allow special treatment for '+', '\-', '*' in the command line (select, 
    31693169unselect, reverse selection) only if the command line is empty.  You 
    31703170don't need to quote those characters in the middle of the command line. 
    31713171On the other hand, you cannot use them to change selection when the 
     
    31783178.TP 
    31793179.I show_output_starts_shell 
    31803180This variable only works if you are not using the subshell support. 
    3181 When you use the C-o keystroke to go back to the user screen, if this 
     3181When you use the C\-o keystroke to go back to the user screen, if this 
    31823182one is set, you will get a fresh shell.  Otherwise, pressing any key 
    31833183will bring you back to the Midnight Commander. 
    31843184.TP 
     
    32173217database without requiring root privileges.  The Midnight Commander 
    32183218searches in the system initialization file (the mc.lib file located in 
    32193219the Midnight Commander library directory) and in the ~/.mc/ini file for 
    3220 the section "terminal:your-terminal-name" and then for the section 
     3220the section "terminal:your\-terminal\-name" and then for the section 
    32213221"terminal:general", each line of the section contains a key symbol that 
    32223222you want to define, followed by an equal sign and the definition for the 
    32233223key.  You can use the special \\e form to represent the escape character 
    3224 and the ^x to represent the control-x character. 
     3224and the ^x to represent the control\-x character. 
    32253225.PP 
    32263226The possible key symbols are: 
    32273227.PP 
    32283228.nf 
    3229 f0 to f20     Function keys f0-f20 
     3229f0 to f20     Function keys f0\-f20 
    32303230bs            backspace 
    32313231home          home key 
    32323232end           end key 
     
    32603260 
    32613261.PP 
    32623262This means that ctrl+alt+left send \\e[[1;6D esc sequence 
    3263 and mc interprets "\\e[[1;6D" as C-A-Left. 
     3263and mc interprets "\\e[[1;6D" as C\-A\-Left. 
    32643264 
    32653265.PP 
    32663266The 
    32673267.I complete 
    32683268key symbol represents the escape sequences used to invoke the completion 
    3269 process, this is invoked with Alt-tab, but you can define other keys to do 
     3269process, this is invoked with Alt\-tab, but you can define other keys to do 
    32703270the same work (on those keyboard with tons of nice and unused keys 
    32713271everywhere). 
    32723272.SH "" 
     
    32823282.PP 
    32833283.I @prefix@/share/mc/mc.ext 
    32843284.IP 
    3285 The default system-wide extensions file. 
     3285The default system\-wide extensions file. 
    32863286.PP 
    32873287.I ~/.mc/bindings 
    32883288.IP 
     
    32913291.PP 
    32923292.I @prefix@/share/mc/mc.ini 
    32933293.IP 
    3294 The default system-wide setup for the Midnight Commander, used only if 
     3294The default system\-wide setup for the Midnight Commander, used only if 
    32953295the user doesn't have his own ~/.mc/ini file. 
    32963296.PP 
    32973297.I @prefix@/share/mc/mc.lib 
     
    33063306.I ~/.mc/ini 
    33073307.IP 
    33083308User's own setup. If this file is present then the setup is loaded 
    3309 from here instead of the system-wide startup file. 
     3309from here instead of the system\-wide startup file. 
    33103310.PP 
    33113311.I @prefix@/share/mc/mc.hint 
    33123312.IP 
     
    33143314.PP 
    33153315.I @prefix@/share/mc/mc.menu 
    33163316.IP 
    3317 This file contains the default system-wide applications menu. 
     3317This file contains the default system\-wide applications menu. 
    33183318.PP 
    33193319.I ~/.mc/menu 
    33203320.IP 
    33213321User's own application menu. If this file is present it is used instead 
    3322 of the system-wide applications menu. 
     3322of the system\-wide applications menu. 
    33233323.PP 
    33243324.I ~/.mc/Tree 
    33253325.IP 
     
    33273327.PP 
    33283328.I ./.mc.menu 
    33293329.IP 
    3330 Local user-defined menu. If this file is present, it is used instead of 
    3331 the home or system-wide applications menu. 
     3330Local user\-defined menu. If this file is present, it is used instead of 
     3331the home or system\-wide applications menu. 
    33323332.\"SKIP_SECTION" 
    33333333.SH "LICENSE" 
    33343334This program is distributed under the terms of the GNU General Public 
    3335 License as published by the Free Software Foundation. See the built-in 
     3335License as published by the Free Software Foundation. See the built\-in 
    33363336help for details on the License and the lack of warranty. 
    33373337.\"NODE "AVAILABILITY" 
    33383338.SH "AVAILABILITY" 
     
    33453345.PP 
    33463346.nf 
    33473347The Midnight Commander page on the World Wide Web: 
    3348         http://www.midnight-commander.org/ 
     3348        http://www.midnight\-commander.org/ 
    33493349.fi 
    33503350.\"NODE "AUTHORS" 
    33513351.SH "AUTHORS" 
     
    33573357be done. 
    33583358.PP 
    33593359If you want to report a problem with the program, please send mail to 
    3360 this address: mc-devel@gnome.org. 
     3360this address: mc\-devel@gnome.org. 
    33613361.PP 
    33623362Provide a detailed description of the bug, the version of the program 
    33633363you are running 
    3364 .RI ( "mc -V" 
     3364.RI ( "mc \-V" 
    33653365displays this information), the operating system you are running the 
    33663366program on.  If the program crashes, we would appreciate a stack trace.