X-Git-Url: https://git.phdru.name/?p=extfs.d.git;a=blobdiff_plain;f=INSTALL.txt;h=ed65443323b36b1a77d240dcd71a383995f879f7;hp=66dcf7e4e1d209bea6b88d0ae45cbc20a0dd5f41;hb=refs%2Fheads%2Fmaster;hpb=b824a8179b59e84f96919f7c9a0deb51d298dbca

diff --git a/INSTALL.txt b/INSTALL.txt
index 66dcf7e..7c0ce8a 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -1,64 +1,52 @@
 How to install an external VFS script
 =====================================
 
-Related to extfs installation there are two major versions of Midnight
-Commander. Older versions before 4.7.something use extfs.ini
+Related to extfs installation there are two major versions of ``Midnight
+Commander``. Older versions before 4.7.something use ``extfs.ini``
 configuration file. Newer versions simply allow to drop a VFS script to
-~/.mc/extfs.d directory. One can distinguish these versions by looking
-up the file extfs.ini; run the following command from the command line:
+``$HOME/.mc/extfs.d`` directory. One can distinguish these versions by
+looking up the file ``extfs.ini``; run the following command from the
+command line::
 
-locate -b \\extfs.ini
+  locate -b \\extfs.ini
 
 (I use GNU locate conventions; adapt the command line to your system;
-the simplest variant is just "locate extfs.ini".)
+the simplest variant is just ``locate extfs.ini``.)
 
-Usual places for extfs.ini are /etc/mc/extfs/extfs.ini,
-/usr/lib/mc/extfs/extfs.ini, /usr/share/mc/extfs/extfs.ini or
-/usr/local/share/mc/extfs/extfs.ini.
+Usual places for ``extfs.ini`` are ``/etc/mc/extfs/extfs.ini``,
+``/usr/lib/mc/extfs/extfs.ini``, ``/usr/share/mc/extfs/extfs.ini`` or
+``/usr/local/share/mc/extfs/extfs.ini``.
+
+Newer versions - \$HOME/.mc/extfs.d
+-----------------------------------
+
+For newer versions just drop a VFS script to ``$HOME/.mc/extfs.d`` or
+``$HOME/.local/share/mc/extfs.d/`` directory (verify directory by running
+``mc -F``). Make the script executable. Edit ``mc.ext``. Enable file types
+guessing (see above).
+
+See my https://phdru.name/Software/dotfiles/mc/mc.ext.html for examples.
 
 Older versions - extfs.ini
 --------------------------
 
 On the system where there is a file extfs.ini a VFS script has to be
 installed the following way. Put the script into the system extfs
-directory - /usr/share/mc/extfs/ or /usr/local/share/mc/extfs/. Edit
-extfs.ini - add a line naming the script; for example, if one's
-installing xml VFS one has to do something like
-
-cd /etc/mc/extfs
-echo xml >>extfs.ini
-
-To use the installed VFS one also has to edit ~/.mc/mc.ext to assign the
-VFS to file extension(s) or type(s). For example to assign xml VFS to
-*.xml files (ignore case) and to XML file type add the following to
-mc.ext:
+directory - ``/usr/share/mc/extfs/`` or ``/usr/local/share/mc/extfs/``.
+Make the script executable. Edit ``extfs.ini`` - add a line naming the
+script; for example, if one's installing xml VFS one has to do something
+like::
 
-regex/\.([xX][mM][lL])$
-    Open=%cd %p#xml
+  cd /etc/mc/extfs
+  echo xml >>extfs.ini
 
-type/^XML *(1\.0 *)?document text
-    Open=%cd %p#xml
+To use the installed VFS one also has to edit ``$HOME/.mc/mc.ext`` to assign
+the VFS to file extension(s) or type(s).
 
 To enable file types add or change the following configuration option in
-ini file:
+ini file in section ``[Midnight-Commander]``::
 
-use_file_to_guess_type=1
+  use_file_to_guess_type=1
 
-This has to be done using text editor - mc doesn't allow editing the
+This has to be done using text editor - ``mc`` doesn't allow editing the
 option in its configuration editor.
-
-Newer versions ~/.mc/extfs.d
-----------------------------
-
-For newer versions just drop a VFS script to ~/.mc/extfs.d or
-~/.local/share/mc/extfs.d/ directory (verify directory by running "mc -F").
-Edit mc.ext; the syntax is slightly different:
-
-regex/\.([xX][mM][lL])$
-    Include=xml
-
-type/^XML *(1\.0 *)?document text
-    Include=xml
-
-include/xml
-    Open=%cd %p/xml://