alpha: ADD: cmds.html, faq.html, shortcuts.html: 'cm_MapNetworkDrive'…

… and some related changes/updates.

alpha: ADD: configxml.html: 'MaxStringItems', 'Sounds'.
alpha: ADD: help.html: 'Create directory': Option to disable auto-completion.
alpha: ADD: help.html: 'Calculate check sum': Create separate checksum file for each directory.
alpha: ADD: help.html: 'Calculate check sum': XXH128.
alpha: ADD: help.html, shortcuts.html: Use up/down arrowa to rename next/previous file.
alpha: ADD: lua.html: DC.ExpandVar, DC.GetPluginField, DC.GoToFile, SysUtils.ExpandEnv, SysUtils.FileSetTime, SysUtils.GetFileProperty, SysUtils.RemoveDirectory.
alpha: ADD: multiarc.html: 'AskHistoryN', 'FallBackArchivers', 'IgnoreStringN' and 'SizeStripChars' ('Additional settings' subsection); 'Show as normal files'.
alpha: ADD: viewer.html: Shows the general information about the folder.
alpha: UPD: configuration.html, multiarc.html: The 'c' expression now works.
alpha: UPD: copymove.html: Support verify after copy in macOS (experimentally).
UPD: Screenshots.
Other small fixes/changes.

doc/en/cmds.html

@@ -1110,6 +1110,18 @@ <h2><a name="catnetwork">2.6. Network</a></h2>
               <div class="cmdname"><a name="cm_CopyNetNamesToClip">cm_CopyNetNamesToClip</a></div></td>
             <td class="cmdhintcell">Windows only: copy names with UNC path.</td>
           </tr>
+         <tr>
+            <td class="cmdcell"><img class="IntCmdImage" title="cm_MapNetworkDrive" alt="cm_MapNetworkDrive" src="../../pixmaps/dctheme/32x32/actions/cm_mapnetworkdrive.png">
+              <div class="cmdname"><a name="cm_MapNetworkDrive">cm_MapNetworkDrive</a><span class="versionref"><sup>(Alpha version)</sup></span></div>
+              <div class="shrtctkey">Ctrl+K</div></td>
+            <td class="cmdhintcell">This command allows to connect network devices, the behavior depends on the operating system:
+              <ul>
+                <li>Windows: will call the Windows system dialog to connect network drives.</li>
+                <li>macOS: similar to the "Connect to Server" command in Finder.</li>
+                <li>Linux and other Unix-like systems: Double Commander will prompt to specify the path, you can use GVfs paths (see <a href="faq.html#gvfs">FAQ</a> for more details) or specify a local directory. Thus, the result of this command is similar to the <a href="#cm_EditPath">cm_EditPath</a> command.</li>
+              </ul>
+            </td>
+          </tr>
         </table>
         <p class="navback"><a href="#topofpage">(back to top)</a></p>
       </div>

doc/en/configuration.html

@@ -636,7 +636,7 @@ <h2><a name="settings">2. Configuration</a></h2>
           <li><p><tt>GETFILEOWNER</tt>&nbsp;&ndash; displays the owner of the file.</p></li>
           <li><p><tt>GETFILELINKTO</tt>&nbsp;&ndash; displays the path and file, that is, what is linked with this symlink.</p></li>
           <li><p><tt>GETFILETYPE</tt>&nbsp;&ndash; file type (as in Windows Explorer or MIME-type).</p></li>
-          <li><p><tt>GETFILECOMMENT</tt>&nbsp;&ndash; file or directory description (comment) from <tt>descript.ion</tt> (see details <a href="help.html#cm_EditComment">here</a>).</p></li>
+          <li><p><tt>GETFILECOMMENT</tt>&nbsp;&ndash; file or directory description (comment) from <tt>descript.ion</tt> (see details <a href="help.html#cm_EditComment">here</a>). This field can also be used inside archives (if the archive format supports saving file descriptions and the corresponding <a href="multiarc.html#archivers">external archiver</a> is configured to receive them).</p></li>
           <li><p><tt>GETFILECOMPRESSEDSIZE</tt>&nbsp;&ndash; compressed file size (real size if using NTFS compression).</p></li>
         </ul>
         <p><span class="italic">Move</span>&nbsp;&ndash; allows to move lines (which equates to reordering the columns). Click twice in the Move box and you will see a type of spinner appear, clicking on the upper part moves the line up (column moves left).</p>
@@ -868,8 +868,8 @@ <h2><a name="settings">2. Configuration</a></h2>
           <li><p><span class="italic">Command line history</span>&nbsp;&ndash; Commands that were used at the <a href="help.html#iface_path">command line</a>.</p></li>
           <li><p><span class="italic">File mask history</span>&nbsp;&ndash; Double Commander saves a general history of used file masks for several tools: find files, filters in <a href="syncdirs.html">directory synchronization</a> and <a href="help.html#cm_ExtractFiles">archive unpacking</a>, commands for <a href="help.html#cm_MarkPlus">selecting and deselecting a group of files</a>.</p></li>
         </ul>
-        <p>The maximum number of entries in history is limited to 50.</p>
-        <p>Note about the history of visited directories: During the session, Double Commander stores up to 255 visited directories in memory (however, when the program is closed, only the last 50 entries will be saved). You can change the number of history entries in the popup menu when calling the <a href="cmds.html#cm_DirHistory">cm_DirHistory</a> command (default value is 30, see the <code>Count</code> attribute in the <a href="configxml.html">&lt;DirHistory&gt;</a> tag), but when using the <a href="#ConfigTreeMenu">Tree View Menu</a>, all available history will be shown.</p>
+        <p>The maximum number of entries in history is limited to 50 by default (see the <code>MaxStringItems</code> attribute in the <a href="configxml.html">&lt;History&gt;</a> tag).</p>
+        <p>Note about the history of visited directories: During the session, Double Commander stores up to 255 visited directories in memory, however, when the program is closed, the number of saved entries will be limited to the <code>MaxStringItems</code> value. You can change the number of history entries in the popup menu when calling the <a href="cmds.html#cm_DirHistory">cm_DirHistory</a> command (default value is 30, see the <code>Count</code> attribute in the <a href="configxml.html">&lt;DirHistory&gt;</a> tag), but when using the <a href="#ConfigTreeMenu">Tree View Menu</a>, all available history will be shown.</p>
         <p>Note: Search templates are not related to the history and are saved separately (in the <tt>doublecmd.xml</tt> configuration file). To manage the list of templates, you can use the <a href="findfiles.html#templates">file search</a> tool.</p>
         <p>You can choose how the list of settings sections will look:</p>
         <ul>
@@ -1072,7 +1072,7 @@ <h2><a name="settings">2. Configuration</a></h2>
         </ul>
         <p>"View" actions with the <tt>{!DC-VIEWER}</tt> macro will be taken into account for <a href="viewer.html#quick">quick viewing</a>, other macros and commands will be ignored.</p>
         <p><tt>{!TERMSTAYOPEN}</tt> and <tt>{!TERMANDCLOSE}</tt> have been added for unification and the ability to use the variables <a href="variables.html#executeterm">%t0 and %t1</a>, <tt>{!SHELL}</tt> has been kept for backwards compatibility.</p>
-        <p>As a command, you can use the <a href="cmds.html">internal commands</a> of Double Commander. The parameters of the internal commands are specified one per line, so you can specify only one here. Also, using the internal command <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a>, you can run <a href="lua.html">Lua scripts</a>, in this case you can get the names of the selected files using <a href="cmds.html#cm_CopyFullNamesToClip">cm_CopyFullNamesToClip</a> or <a href="cmds.html#cm_SaveSelectionToFile">cm_SaveSelectionToFile</a>.</p>
+        <p>As a command, you can use the <a href="cmds.html">internal commands</a> of Double Commander. The parameters of the internal commands are specified one per line, so you can specify only one here. Also, using the internal command <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a>, you can run <a href="lua.html">Lua scripts</a>, in this case you can get the names of the selected files using internal commands (<a href="cmds.html#cm_CopyFullNamesToClip">cm_CopyFullNamesToClip</a> or <a href="cmds.html#cm_SaveSelectionToFile">cm_SaveSelectionToFile</a>) or the <a href="lua.html#dc_expandvar">DC.ExpandVar</a><span class="versionref"><sup>(Alpha version)</sup></span> function.</p>
         <p><span class="italic">Parameters</span>&nbsp;&ndash; command parameters including variables:</p>
         <ul>
           <li><p>any variable from <a href="variables.html">"percent" variables</a>.</p></li>

doc/en/configxml.html

@@ -199,6 +199,28 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
             </td>
           </tr>
 
+          <tr>
+            <td class="cmdcell"><div class="firstcolumnaleft"><a name="Sounds">&lt;Sounds&gt;</a><span class="versionref"><sup>(Alpha version)</sup></span></div></td>
+            <td class="hintcell">
+              Enables sound notifications when file operations are finished. Possible contents of the <code>&lt;Sounds&gt;</code> tag in full:<br>
+            <pre>
+&lt;Sounds Duration="10"&gt;
+  &lt;Copy&gt;C:\Windows\Media\Alarm01.wav&lt;/Copy&gt;
+  &lt;Move&gt;C:\Windows\Media\Alarm01.wav&lt;/Move&gt;
+  &lt;Wipe&gt;C:\Windows\Media\Alarm01.wav&lt;/Wipe&gt;
+  &lt;Delete&gt;C:\Windows\Media\Alarm01.wav&lt;/Delete&gt;
+  &lt;Split&gt;C:\Windows\Media\Alarm01.wav&lt;/Split&gt;
+  &lt;Combine&gt;C:\Windows\Media\Alarm01.wav&lt;/Combine&gt;
+&lt;/Sounds&gt;</pre>
+              <code>Duration</code> is the minimum time (in seconds) that a file operation should last (0&nbsp;&ndash; always on, -1 disables sound notifications).<br>
+              File operations: copy, move, wipe, delete files, split file and combine files. If a sound notification is not needed for some operation, just remove (or do not add) the corresponding line. <a href="variables.html#envvariables">Environment variables are supported</a>.<br>
+              Supported audio formats:<br>
+              - Windows (the <tt>sndPlaySoundW</tt> function from the Windows API): .wav.<br>
+              - macOS (the Core Audio API): .aac, .adts, .ac3, .caf, .mp3, .m4a and .mp4 (with AAC or ALAC), .wav.<br>
+              - Linux and other Unix-like systems: Double Commander can use the GStreamer library (primarily, <tt>libgstreamer-1.0.so.0</tt>) or the SDL2 library (<tt>libSDL2-2.0.so.0</tt>). GStreamer supports most popular audio formats, with SDL2 we can use only .wav. In Haiku, only SDL2 can be used.
+            </td>
+          </tr>
+
           <tr>
             <td colspan="2" class="subsection"><div class="subsection">from &lt;FileOperations&gt;&lt;Options&gt;:</div></td>
           </tr>
@@ -356,6 +378,11 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
             <td colspan="2" class="subsection"><div class="subsection">from &lt;History&gt;:</div></td>
           </tr>
 
+          <tr>
+            <td class="cmdcell"><div class="firstcolumnaleft"><a name="MaxStringItems">Attribute <i>MaxStringItems</i><span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;History&gt;</small></a></div></td>
+            <td class="hintcell">The <code>MaxStringItems</code> attribute allows to specify the maximum number of entries in the <a href="configuration.html#ConfigDC">saved history</a>. Default value is 50.</td>
+          </tr>
+
           <tr>
             <td class="cmdcell"><div class="firstcolumnaleft"><a name="Count">Attribute <i>Count</i><br><small>from &lt;History&gt;&lt;DirHistory&gt;</small></a></div></td>
             <td class="hintcell">
@@ -615,6 +642,7 @@ <h2><a name="index">4. Index</a></h2>
             <td class="indexcell">
               <p>
                 <a href="#Count">Attribute <i>Count</i> (&lt;DirHistory&gt;)</a><br>
+                <a href="#MaxStringItems">Attribute <i>MaxStringItems</i> (&lt;History&gt;)</a><br>
                 <a href="#SaveAsymmetric">Attribute <i>Save</i> (&lt;Asymmetric&gt;)</a><br>
                 <a href="#SaveFileMask">Attribute <i>Save</i> (&lt;FileMask&gt;)</a><br><br>
                 <a href="#ActiveRight">ActiveRight</a><br>
@@ -644,18 +672,19 @@ <h2><a name="index">4. Index</a></h2>
                 <a href="#JpegQuality">JpegQuality</a><br>
                 <a href="#LeftMargin">LeftMargin</a><br>
                 <a href="#LongInStatus">LongInStatus</a><br>
-                <a href="#LongNameAlert">LongNameAlert</a>
+                <a href="#LongNameAlert">LongNameAlert</a><br>
+                <a href="#MaxCodeSize">MaxCodeSize</a>
               </p>
             </td>
             <td class="indexcell">
               <p>
-                <a href="#MaxCodeSize">MaxCodeSize</a><br>
                 <a href="#MaxTextWidth">MaxTextWidth</a><br>
                 <a href="#Mode">Mode</a><br>
                 <a href="#NtfsHourTimeDelay">NtfsHourTimeDelay</a><br>
                 <a href="#Quality">Quality</a><br>
                 <a href="#RenameConfirmMouse">RenameConfirmMouse</a><br>
                 <a href="#ShowColonAfterDrive">ShowColonAfterDrive</a><br>
+                <a href="#Sounds">Sounds</a><br>
                 <a href="#SynEditMask">SynEditMask</a><br>
                 <a href="#SystemItemProperties">SystemItemProperties</a><br>
                 <a href="#TabSpaces">TabSpaces</a><br>

doc/en/copymove.html

@@ -57,7 +57,7 @@ <h2><a name="confirmation">1. Copy/move dialog window</a></h2>
         </ul>
         <p>The list of the following parameters will vary depending on the type of file operation and operating system family.</p>
         <ul>
-          <li><p><span class="italic">Verify</span>&nbsp;&ndash; If enabled, Double Commander will compare the source file and the copied file in the target directory: a byte-by-byte comparison (Windows) or BLAKE2 checksums (Linux and others). Double Commander will try to minimize the disk cache effects (if the file system does not support direct input/output, the program will report the verification failure). Keep in mind, this function significantly reduces the speed of the operation. Not available in macOS.</p></li>
+          <li><p><span class="italic">Verify</span>&nbsp;&ndash; If enabled, Double Commander will compare the source file and the copied file in the target directory: a byte-by-byte comparison (Windows) or BLAKE2 checksums (Linux and others). Double Commander will try to minimize the disk cache effects (if the file system does not support direct input/output, the program will report the verification failure). Keep in mind, this function significantly reduces the speed of the operation. In macOS, this feature is available experimentally.<span class="versionref"><sup>(Alpha version)</sup></span></p></li>
           <li><p><span class="italic">Check free space</span>&nbsp;&ndash; Before copying the file, Double Commander will check if there is enough free disk space in the target directory.</p></li>
           <li><p><span class="italic">Reserve space</span>&nbsp;&ndash; If enabled, Double Commander will use pre-allocation of disk space, this will reduce the chances of file fragmentation. Also this is a faster way to create files. In Windows, Double Commander always reserves space. Does not work in Linux on partitions with FAT32 file system.</p></li>
           <li><p><span class="italic">Follow links</span>&nbsp;&ndash; If enabled, Double Commander will consider symbolic links to folders as regular folders and copy their contents; instead of file links, the target  files of this links will be copied. The indeterminate checkbox state (three-state): the program will ask each time what it should do.</p></li>

doc/en/faq.html

@@ -177,7 +177,7 @@ <h2>2. Issues related to GNU/Linux</h2>
         <p>First, packages <tt>gvfs</tt>, <tt>gvfs-backends</tt> and <tt>gvfs-fuse</tt> should be installed.
           Keep in mind that some distributions have not packages <tt>gvfs-backends</tt> and <tt>gvfs-fuse</tt>,
           because they are part of package <tt>gvfs</tt>, or it can be several packages with names <tt>gvfs-backends-*</tt> or <tt>gvfs-*</tt>.</p>
-        <p>Now insert GVfs path in the address bar: click by right mouse button at address bar to edit it (or call internal command <tt>cm_EditPath</tt>).</p>
+        <p>Now insert GVfs path in the address bar: click by right mouse button at address bar to edit it (or call internal command <tt>cm_EditPath</tt>). Alternatively, you can use the internal command <a href="cmds.html#cm_MapNetworkDrive">cm_MapNetworkDrive</a>.<span class="versionref"><sup>(Alpha version)</sup></span></p>
         <p>For example, access to</p>
         <ul>
           <li>FTP: <code>ftp://ftpuser@ftpserver</code></li>