source: general/sysutils/mc.xml@ b1532549

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b1532549 was b1532549, checked in by Pierre Labastie <pieere@…>, 20 months ago

Format sysutils

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22859 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY mc-download-http "http://ftp.midnight-commander.org/mc-&mc-version;.tar.xz">
8 <!ENTITY mc-download-ftp "ftp://ftp.osuosl.org/pub/midnightcommander/mc-&mc-version;.tar.xz">
9 <!ENTITY mc-md5sum "3a11df2dd379dd67c497c8d2c344715c">
10 <!ENTITY mc-size "2.3 MB">
11 <!ENTITY mc-buildsize "209 MB (with tests)">
12 <!ENTITY mc-time "0.6 SBU (using parallelism=4; with tests)">
13]>
14
15<sect1 id="mc" xreflabel="MC-&mc-version;">
16 <?dbhtml filename="mc.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>MC-&mc-version;</title>
24
25 <indexterm zone="mc">
26 <primary sortas="a-MC">MC</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to MC</title>
31
32 <para>
33 <application>MC</application> (Midnight Commander) is a text-mode
34 full-screen file manager and visual shell. It provides a clear,
35 user-friendly, and somewhat protected interface to a Unix system while
36 making many frequent file operations more efficient and preserving the
37 full power of the command prompt.
38 </para>
39
40 &lfs91_checked;
41
42 <!--<note>
43 <para>
44 The download site uses a self-signed security certificate.
45 You will need to accept it as valid to get the source code.
46 </para>
47 </note>-->
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>
53 Download (HTTP): <ulink url="&mc-download-http;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download (FTP): <ulink url="&mc-download-ftp;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download MD5 sum: &mc-md5sum;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Download size: &mc-size;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated disk space required: &mc-buildsize;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated build time: &mc-time;
79 </para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">MC Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="glib2"/> and
88 <xref linkend="pcre"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="slang"/>
94 </para>
95
96 <bridgehead renderas="sect4">Optional</bridgehead>
97 <para role="optional">
98 <xref linkend="doxygen"/>,
99 <xref linkend="gpm"/>,
100 <xref linkend="samba"/>,
101 <xref linkend="unzip"/>,
102 <xref linkend="x-window-system"/>, and
103 <xref linkend="zip"/>
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/MC"/></para>
108
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of MC</title>
113
114 <para>
115 Install <application>MC</application> by
116 running the following commands:
117 </para>
118
119<screen><userinput>./configure --prefix=/usr \
120 --sysconfdir=/etc \
121 --enable-charset &amp;&amp;
122make</userinput></screen>
123
124 <para>
125 To test the results, issue: <command>make check</command>.
126 One test concerning rpm files fails.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make install &amp;&amp;
134cp -v doc/keybind-migration.txt /usr/share/mc</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <para>
142 <parameter>--sysconfdir=/etc</parameter>: This switch places the
143 global configureation directory in <filename
144 class="directory">/etc</filename>.
145 </para>
146
147 <para>
148 <parameter>--enable-charset</parameter>: This switch adds support
149 to <command>mcedit</command> for editing files in encodings different
150 from the one implied by the current locale.
151 </para>
152<!-- currently broken
153 <para>
154 <parameter>- -with-screen=ncurses</parameter>: This switch
155 selects the screen library used by <application>MC</application>. It is
156 only required if the optional <xref linkend="slang"/> package is not
157 installed which is the default if found.
158 </para>
159-->
160 </sect2>
161
162 <sect2 role="configuration">
163 <title>Configuring MC</title>
164
165 <sect3 id="mc-config">
166 <title>Config Files</title>
167
168 <para>
169 <filename>~/.config/mc/*</filename>
170 </para>
171
172 <indexterm zone="mc mc-config">
173 <primary sortas="e-AA.config/.mc/*">~/.config/.mc/*</primary>
174 </indexterm>
175
176 </sect3>
177
178 <sect3>
179 <title>Configuration Information</title>
180
181 <para>
182 The <filename class="directory">~/.config/mc</filename> directory and
183 its contents are created when you start <command>mc</command> for the
184 first time. Then you can edit the main <filename>~/.config/mc/ini
185 </filename> configuration file manually or through the <application>
186 MC</application> shell. Consult the mc(1) man page for details.
187 </para>
188
189 <note>
190 <para>
191 On 8.x versions of <application>mc</application>,
192 keybind names used in mc.keymap.* files are changed. This is
193 described in <filename>keybind-migration.txt</filename>.
194 </para>
195 </note>
196
197 </sect3>
198
199 </sect2>
200
201 <sect2 role="content">
202 <title>Contents</title>
203
204 <segmentedlist>
205 <segtitle>Installed Programs</segtitle>
206 <segtitle>Installed Libraries</segtitle>
207 <segtitle>Installed Directories</segtitle>
208
209 <seglistitem>
210 <seg>mc and the symlinks mcdiff, mcedit and mcview</seg>
211 <seg>None</seg>
212 <seg>/etc/mc and /usr/{libexec,share}/mc</seg>
213 </seglistitem>
214 </segmentedlist>
215
216 <variablelist>
217 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
218 <?dbfo list-presentation="list"?>
219 <?dbhtml list-presentation="table"?>
220
221 <varlistentry id="conssaver">
222 <term><command>cons.saver</command></term>
223 <listitem>
224 <para>
225 is used internally by <command>mc</command> for saving and
226 restoring the text behind the panels on Linux text console.
227 </para>
228 <indexterm zone="mc conssaver">
229 <primary sortas="b-conssaver">cons.saver</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="mc-prog">
235 <term><command>mc</command></term>
236 <listitem>
237 <para>
238 is a visual shell.
239 </para>
240 <indexterm zone="mc mc-prog">
241 <primary sortas="b-mc">mc</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="mcdiff">
247 <term><command>mcdiff</command></term>
248 <listitem>
249 <para>
250 is an internal visual diff tool.
251 </para>
252 <indexterm zone="mc mcdiff">
253 <primary sortas="b-mcdiff">mcdiff</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="mcedit">
259 <term><command>mcedit</command></term>
260 <listitem>
261 <para>
262 is an internal file editor.
263 </para>
264 <indexterm zone="mc mcedit">
265 <primary sortas="b-mcedit">mcedit</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="mcview">
271 <term><command>mcview</command></term>
272 <listitem>
273 <para>
274 is an internal file viewer.
275 </para>
276 <indexterm zone="mc mcview">
277 <primary sortas="b-mcview">mcview</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 </variablelist>
283
284 </sect2>
285
286</sect1>
Note: See TracBrowser for help on using the repository browser.