ADD: configxml.html: 'DefaultDropEffect'.

ADD: help.html: 'Pack files': The 'Configure' button.
ADD: variables.html: %A, %a.
CHG: configuration.html: Date and time format: 'z' and 'zzz' in Unix-like OS.
Other small fixes/changes.

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, shortcuts.html: Use up/down arrowa to rename next/previous file.
alpha: ADD: help.html: 'Calculate check sum': XXH128.
alpha: ADD: help.html: Create directory: Option to disable auto-completion.
alpha: ADD: lua.html: DC.ExpandVar, DC.GetPluginField, DC.GoToFile, SysUtils.ExpandEnv, SysUtils.FileSetTime, SysUtils.GetFileProperty, SysUtils.RemoveDirectory.
alpha: ADD: multiarc.html: 'AskHistoryN', 'FallBackArchivers' and 'IgnoreStringN' (to the 'Additional settings' subsection); 'Show as normal files'.
alpha: UPD: configuration.html, multiarc.html: The 'c' expression now works.
alpha: UPD: copymove.html: Support verify after copy in macOS (experimentally).
UPD: Screenshots.

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

@@ -524,15 +524,14 @@ <h2><a name="settings">2. Configuration</a></h2>
           <tr><td class="varcell"><div class="firstcolumnaleft">nn</div></td><td class="hintcell">minute (leading zero)</td><td class="hintcell">06</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">s</div></td><td class="hintcell">second</td><td class="hintcell">2</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">ss</div></td><td class="hintcell">second (leading zero)</td><td class="hintcell">02</td></tr>
-          <tr><td class="varcell"><div class="firstcolumnaleft">z</div></td><td class="hintcell">milliseconds *</td><td class="hintcell">1</td></tr>
-          <tr><td class="varcell"><div class="firstcolumnaleft">zzz</div></td><td class="hintcell">milliseconds (leading zero) *</td><td class="hintcell">001</td></tr>
+          <tr><td class="varcell"><div class="firstcolumnaleft">z</div></td><td class="hintcell">milliseconds</td><td class="hintcell">1</td></tr>
+          <tr><td class="varcell"><div class="firstcolumnaleft">zzz</div></td><td class="hintcell">milliseconds (leading zero)</td><td class="hintcell">001</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">t</div></td><td class="hintcell">short time format</td><td class="hintcell">9:06</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">tt</div></td><td class="hintcell">long time format</td><td class="hintcell">9:06:02</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">am/pm</div></td><td class="hintcell">use 12 hour clock and display am and pm accordingly (also <tt>AM/PM</tt>, <tt>a/m</tt> or <tt>A/M</tt>); for example, <code>t&nbsp;AM/PM</code></td><td class="hintcell">9:06 am</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">/</div></td><td class="hintcell">insert date separator</td><td class="hintcell">/</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">:</div></td><td class="hintcell">insert time separator</td><td class="hintcell">:</td></tr>
           <tr><td class="varcell"><div class="firstcolumnaleft">"text"</div></td><td class="hintcell">literal text; for example, <code>yyyy "AD"</code></td><td class="hintcell">2021 AD</td></tr>
-          <tr><td class="hintcell" colspan="3">* Windows only</td></tr>
         </table>
 
         <p>The next parameters sets the file size format:</p>
@@ -637,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>
@@ -869,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>
@@ -1073,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

@@ -159,6 +159,11 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
             </td>
           </tr>
 
+          <tr>
+            <td class="cmdcell"><div class="firstcolumnaleft">&lt;DefaultDropEffect&gt;<br><small>from &lt;FileOperations&gt;</small></div></td>
+            <td class="hintcell">The default action when <a href="help.html#draganddrop">drag &amp; drop files</a> with the mouse: copying (<code>True</code>) or moving (<code>False</code>) files. <code>True</code> by default.</td>
+          </tr>
+
           <tr>
             <td class="cmdcell"><div class="firstcolumnaleft">&lt;LongNameAlert&gt;<br><small>from &lt;FileOperations&gt;</small></div></td>
             <td class="hintcell">Warn if target path is longer than maximum length for a path (some programs will not be able to access a file/directory with such a long name). In Windows this value (MAX_PATH) is defined as 260 characters. <code>True</code> by default.</td>
@@ -189,6 +194,28 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
             </td>
           </tr>
 
+          <tr>
+            <td class="cmdcell"><div class="firstcolumnaleft">&lt;Sounds&gt;<span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;FileOperations&gt;</small></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 class="cmdcell"><div class="firstcolumnaleft">&lt;CopyAttributes&gt;<br><small>from &lt;FileOperations&gt;&lt;Options&gt;</small></div></td>
             <td class="hintcell">
@@ -337,12 +364,16 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
             <td colspan="2"></td>
           </tr>
 
+          <tr>
+            <td class="cmdcell"><div class="firstcolumnaleft">Attribute <i>MaxStringItems</i><br><small>from &lt;History&gt;</small></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">Attribute <i>Count</i><br><small>from &lt;History&gt;&lt;DirHistory&gt;</small></div></td>
             <td class="hintcell">
-              The <code>Count</code> attribute allows to specify the number of entries from the list of visited directories that will be displayed in the popup menu (the <a href="cmds.html#cm_DirHistory">cm_DirHistory</a> command).
-              When using the Tree View Menu, the attribute value will be ignored.<br>
-              Default value is 30.
+              The <code>Count</code> attribute allows to specify the number of entries from the list of visited directories that will be displayed in the popup menu (the <a href="cmds.html#cm_DirHistory">cm_DirHistory</a> command). Default value is 30.<br>
+              When using the Tree View Menu, the attribute value will be ignored.
             </td>
           </tr>
 
@@ -487,7 +518,7 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
             <td class="cmdcell"><div class="firstcolumnaleft">Attribute <i>Save</i><br><small>from &lt;SyncDirs&gt;&lt;FileMask&gt;</small></div></td>
             <td class="hintcell">
               Synchronize directories: by default, Double Commander saves the last used file mask as the mask for the next run of the synchronization tool (if it is not a search template),
-              to disable this behavior, we can replace <code>True</code> with <code>False</code> (<code>&lt;FileMask Save="False"&gt;</code>) and specify our own <code>&lt;FileMask&gt;</code> value ("*" by default, i.e. all files).
+              to disable this behavior, we can replace <code>True</code> with <code>False</code> (<code>&lt;FileMask Save="False"&gt;</code>) and specify the preferred file mask or "*" (i.e. all files) in the <code>&lt;FileMask&gt;</code> value.
             </td>
           </tr>
 

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>