Merge branch '2409_gmodule_cflags'
[midnight-commander.git] / doc / man / mcview.1.in
blob13a34f1d0a590ef4dc5e194317f66588d1585563
1 .TH MCVIEW 1 "@DATE_OF_MAN_PAGE@" "MC Version @DISTR_VERSION@" "GNU Midnight Commander"
2 .SH NAME
3 mcview \- Internal file viewer of GNU Midnight Commander.
4 .SH USAGE
5 .B mcview
6 [\-bcCdfhstVx?] file
7 .SH DESCRIPTION
8 .LP
9 mcview is a link to
10 .BR mc ,
11 the main GNU Midnight Commander executable.  Executing GNU Midnight
12 Commander under this name requests staring the internal viewer and
13 opening the
14 .I file
15 specified on the command line.
16 .SH OPTIONS
17 .TP
18 .I "\-b"
19 Force black and white display.
20 .TP
21 .I "\-c"
22 Force color mode on terminals where
23 .B mcview
24 defaults to black and white.
25 .TP
26 .I "\-C <keyword>=<FGcolor>,<BGcolor>:<keyword>= ..."
27 Specify a different color set.  See the
28 .B Colors
29 section in mc(1) for more information.
30 .TP
31 .I "\-d"
32 Disable mouse support.
33 .TP
34 .I "\-f"
35 Display the compiled\-in search paths for Midnight Commander files.
36 .TP
37 .I "\-t"
38 Used only if the code was compiled with S\-Lang and terminfo: it makes
39 the Midnight Commander use the value of the
40 .B TERMCAP
41 variable for the terminal information instead of the information on
42 the system wide terminal database
43 .TP
44 .I "\-V"
45 Displays the version of the program.
46 .TP
47 .I "\-x"
48 Forces xterm mode.  Used when running on xterm\-capable terminals (two
49 screen modes, and able to send mouse escape sequences).
50 .PP
51 .SH COLORS
52 The default colors may be changed by appending to the
53 .B MC_COLOR_TABLE
54 environment variable.  Foreground and background colors pairs may be
55 specified for example with:
56 .PP
57 .nf
58 MC_COLOR_TABLE="$MC_COLOR_TABLE:\\
59 normal=lightgray,black:\\
60 selected=black,green"
61 .fi
62 .PP
63 .SH FILES
64 .I @prefix@/share/mc/mc.hlp
65 .IP
66 The help file for the program.
67 .PP
68 .I @prefix@/share/mc/mc.ini
69 .IP
70 The default system\-wide setup for GNU Midnight Commander, used only if
71 the user's own ~/.mc/ini file is missing.
72 .PP
73 .I @prefix@/share/mc/mc.lib
74 .IP
75 Global settings for the Midnight Commander.  Settings in this file
76 affect all users, whether they have ~/.mc/ini or not.
77 .PP
78 .I $HOME/.mc/ini
79 .IP
80 User's own setup.  If this file is present, the setup is loaded from
81 here instead of the system\-wide startup file.
82 .PP
83 .SH LICENSE
84 This program is distributed under the terms of the GNU General Public
85 License as published by the Free Software Foundation.  See the built\-in
86 help of the Midnight Commander for details on the License and the lack
87 of warranty.
88 .SH AVAILABILITY
89 The latest version of this program can be found at
90 ftp://ftp.gnu.org/gnu/mc/.
91 .SH SEE ALSO
92 mc(1), mcedit(1)
93 .PP
94 .SH BUGS
95 Bugs should be reported to mc\-devel@gnome.org