ADD: faq.html: 2.6.

ADD: viewer.html: 'plugins\dll' subdirectory (Windows only).
ADD: viewer.html: Built-in HEIC decoder (Windows 11 24H2+).
Other small fixes/changes.

Author: Skif-off

doc/en/faq.html

@@ -40,6 +40,7 @@ <h2>Content</h2>
               <dt>2.3. <a href="#plugs">Plugins from Total Commander do not work?!</a></dt>
               <dt>2.4. <a href="#gvfs">Can I get access to network resources like in Nautilus or Thunar?</a></dt>
               <dt>2.5. <a href="#tray">Clicking on the tray icon displays a menu with "Restore" and "Exit" items instead of restoring the window (GTK2 only).</a></dt>
+              <dt>2.6. <a href="#systheme">Why does the program's appearance not change or change only partially when switching the system theme? I have to close the program and open it again.</a></dt>
             </dl>
           </dd>
           <dt><a name="interface">3. Interface configuration</a></dt>
@@ -190,6 +191,10 @@ <h2>2. Issues related to GNU/Linux</h2>
 
         <p class="bold"><a name="tray">Q: Clicking on the tray icon displays a menu with "Restore" and "Exit" items instead of restoring the window (GTK2 only).</a></p>
         <p><span class="bold">A:</span> Add a library of general system tray support: for example, package <tt>libappindicator1</tt> in Debian/Ubuntu or <tt>libappindicator-gtk2</tt> in Arch Linux.</p>
+        <br>
+
+        <p class="bold"><a name="systheme">Q: Why does the program's appearance not change or change only partially when switching the system theme? I have to close the program and open it again.</a></p>
+        <p><span class="bold">A:</span> GTK2 version? This is a feature of Lazarus, in this case, it does not update controls colors under GTK2.</p>
         <p class="navback"><a href="#topofpage">(back to top)</a></p>
       </div>
 
@@ -362,8 +367,8 @@ <h2>5. Issues related to the built-in viewer (<kbd>F3</kbd>) and editor (<kbd>F4
         <p class="bold"><a name="f34_regutf8">Q: How can I use regular expressions to search in UTF-8?</a></p>
         <p><span class="bold">A:</span> This feature has been added to version 1.0.0. Needs PCRE2 library with support 8-bit code units and Unicode support enabled (usually enabled by default):</p>
         <ul>
-          <li><p>Linux: needs <tt>libpcre2-8.so.0</tt>. For example, package <tt>libpcre2-8-0</tt> in Debian/Ubuntu or <tt>pcre2</tt> in Arch Linux.</p></li>
           <li><p>Windows: needs <tt>libpcre2-8.dll</tt> (by default, the Double Commander distribution contains this DLL).</p></li>
+          <li><p>Linux: needs <tt>libpcre2-8.so.0</tt>. For example, package <tt>libpcre2-8-0</tt> in Debian/Ubuntu or <tt>pcre2</tt> in Arch Linux.</p></li>
           <li><p>macOS: needs <tt>libpcre2-8.dylib</tt>.</p></li>
         </ul>
         <br>
@@ -455,11 +460,11 @@ <h2>7. Plugins</h2>
         <br>
 
         <p class="bold"><a name="ftps_reuse">Q: ftp.wfx: I try to use FTPS (FTP+SSL), but I get "522 SSL connection failed: session reuse required".</a></p>
-        <p><span class="bold">A:</span> This server requires session reuse support and the FTP plugin supports it, but requires a library that supports SSL and TLS protocols (see the <a href="plugins.html#ftp.wfx">description</a> of the plugin). Put the libraries near <tt>doublecmd.exe</tt> or in the PATH (Windows) or install the appropriate package (Linux and other Unix-like systems).</p>
+        <p><span class="bold">A:</span> This server requires session reuse support and the FTP plugin supports it, but requires a library that supports SSL and TLS protocols (see the <a href="plugins.html#ftp.wfx">description</a> of the plugin).</p>
         <br>
 
         <p class="bold"><a name="ftp_openssl">Q: ftp.wfx: Does not work with some servers! After connecting, I get errors: "104,Connection reset by peer" and "CSOCK ERROR Connection reset by peer" or "10060,Connection timed out" and "CSOCK ERROR Connection timed out".</a></p>
-        <p><span class="bold">A:</span> Requires a library that supports SSL and TLS protocols (see the <a href="plugins.html#ftp.wfx">description</a> of the plugin). Put the libraries near <tt>doublecmd.exe</tt> or in the PATH (Windows) or install the appropriate package (Linux and other Unix-like systems).</p>
+        <p><span class="bold">A:</span> Requires a library that supports SSL and TLS protocols (see the <a href="plugins.html#ftp.wfx">description</a> of the plugin).</p>
         <p class="navback"><a href="#topofpage">(back to top)</a></p>
         <br>
       </div>

doc/en/help.html

@@ -283,8 +283,8 @@ <h2><a name="mnu_commands">2.1.3. "Commands"</a></h2>
         <ul>
           <li><p><tt>Computer</tt>&nbsp;&ndash; contains a list of normal disks with a drive letter and devices that do not have a drive letter (for example, USB devices that are connected via the MTP protocol, i.e. smartphones, tablets or players). Windows only.</p></li>
           <li><p><tt>Linux</tt>&nbsp;&ndash; list of all Linux distributions that you added to WSL and their root file systems (Windows 10 and newer).</p></li>
-          <li><p><tt>Network</tt>&nbsp;&ndash; used to access shared network resources (Windows) or network resources using Gio (Linux).</p></li>
-          <li><p><tt>Recycle Bin</tt>&nbsp;&ndash; used to access files deleted to trash.</p></li>
+          <li><p><tt>Network</tt>&nbsp;&ndash; access to shared network resources (Windows) or to network resources using Gio (Linux).</p></li>
+          <li><p><tt>Recycle Bin</tt>&nbsp;&ndash; access to files deleted to the trash.</p></li>
         </ul>
         <p>(The list is sorted alphabetically and depends on the language settings of the system and the program.)</p>
         <p><span class="bold"><a name="cm_Exchange">Swap Panels</a></span> (internal command <tt>cm_Exchange</tt>) swaps left and right file panels with all opened tabs.</p>

doc/en/lua.html

@@ -122,11 +122,9 @@ <h2><a name="preface">1. Introduction</a></h2>
       <div>
         <h2><a name="dllrequired">2. DLL required</a></h2>
         <p>In order to interpret Lua script file, we need to have a Lua DLL file, Double Commander supports versions 5.1 - 5.4.</p>
-        <p>By default DC looks for a file with name <tt>lua5.1.dll</tt> (Windows), <tt>liblua5.1.so.0</tt> (Unix or GNU/Linux) or <tt>liblua5.1.dylib</tt> (macOS) in its directory and in the system directory. We can change the file name (and path) in the <a href="configuration.html#luapathtolibrary">Lua library file to use</a> parameter.</p>
-        <p>We can use DLL file from <a href="https://luajit.org/" target="_blank">LuaJIT project</a>.
-           LuaJIT combines a high-speed interpreter, written in assembler, with a state-of-the-art JIT compiler. Also we get FFI library, which allows calling external C functions and using C data structures from pure Lua code.</p>
+        <p>We can use DLL file from <a href="https://luajit.org/" target="_blank">LuaJIT project</a>. LuaJIT combines a high-speed interpreter, written in assembler, with a state-of-the-art JIT compiler. Also we get FFI library, which allows calling external C functions and using C data structures from pure Lua code.</p>
         <p>DC distributives for Windows have Lua DLL by default (in DC 0.9.7 and newer from LuaJIT project), in other cases we may find and install it through our packages manager or compile it. If we're using a 64-bits version of DC, the DLL must be the 64-bits version as well.</p>
-        <p>The library name must be specified in the value of the <a href="configuration.html#ConfigPlugins">Lua library file to use</a> option.</p>
+        <p>By default DC looks for a file with name <tt>lua5.1.dll</tt> (Windows), <tt>liblua5.1.so.0</tt> (Unix or GNU/Linux) or <tt>liblua5.1.dylib</tt> (macOS) in its directory and in the system directory. We can change the file name (and path) in the <a href="configuration.html#luapathtolibrary">Lua library file to use</a> parameter.</p>
         <p class="navback"><a href="#topofpage">(back to top)</a></p>
       </div>
 

doc/en/plugins.html

@@ -157,11 +157,15 @@ <h2><a name="wfx">3. File system plugins (WFX)</a></h2>
         <p>This is a file system plugin for working with the following network protocols: FTP, FTPS, FTPES, SFTP and SSH+SCP. The plugin also supports working with proxy servers (HTTP, SOCKS 4 or SOCKS 5).</p>
         <p>Requires additional libraries:</p>
         <p>1) SSL and TLS protocols</p>
+        <p>The <a href="https://www.openssl.org/" target="_blank">OpenSSL</a> cryptographic library (3.1, 3.0, 1.1.1, 1.1.0, 1.0.2, 1.0.1):</p>
         <ul>
-          <li><p>The <a href="https://www.openssl.org/" target="_blank">OpenSSL</a> cryptographic library (3.1, 3.0, 1.1.1, 1.1.0, 1.0.2, 1.0.1): the FTP plugin will use <tt>ssleay32.dll</tt> and <tt>libeay32.dll</tt> (Windows), <tt>libssl.dylib</tt> and <tt>libcrypto.dylib</tt> (macOS) or <tt>libssl.so</tt> and <tt>libcrypto.so</tt> (Linux and other Unix-like OS), where "N" is a version number. Library names often include a version number, the plugin contains a list of common names, and the required file will be found in the system automatically.<br>
-            Compiled OpenSSL binaries for Windows can be found <a href="https://wiki.openssl.org/index.php/Binaries" target="_blank">here</a>, in other cases, we can use the operating system's package manager (for example, package <tt>libssl3</tt> or <tt>libssl1.1</tt> in Debian/Ubuntu, <tt>openssl</tt> in Arch Linux, <tt>openssl</tt> in macOS (Homebrew)).</p></li>
-          <li><p>Alternatively, in Linux, the plugin can use the <a href="https://www.gnutls.org/" target="_blank">GnuTLS</a> library (<tt>libgnutls.so.N</tt>, where "N" is a version number).</p></li>
+          <li>Windows: plugin contains a list of common names, and the required files will be found automatically.</li>
+          <li>macOS: <tt>libssl.dylib</tt> and <tt>libcrypto.dylib</tt>.</li>
+          <li>Linux and other Unix-like OS: <tt>libssl.so.N</tt> and <tt>libcrypto.so.N</tt>, where "N" is a version number.</li>
         </ul>
+        <p>Compiled OpenSSL binaries for Windows can be found <a href="https://wiki.openssl.org/index.php/Binaries" target="_blank">here</a>, in other cases, we can use the operating system's package manager (for example, package <tt>libssl3</tt> or <tt>libssl1.1</tt> in Debian/Ubuntu, <tt>openssl</tt> in Arch Linux, <tt>openssl</tt> in macOS (Homebrew)).</p>
+        <p>Note: In Windows, libraries must be located near the Double Commander executable file or in the Windows system directory.</p>
+        <p>Alternatively, in Linux, the plugin can use the <a href="https://www.gnutls.org/" target="_blank">GnuTLS</a> library (<tt>libgnutls.so.N</tt>, where "N" is a version number).</p>
         <p>2) SSH protocol</p>
         <p>The <a href="https://libssh2.org/" target="_blank">libssh</a> library: the FTP plugin will use <tt>libssh2.dll</tt> (Windows), <tt>libssh2.dylib</tt> (macOS) or <tt>libssh2.so.1</tt> (Linux and other Unix-like OS).</p>
         <p>The distributions of Double Commander for Windows contain this library, in other cases, we can use the usual ways to get libraries in the operating system (for example, package <tt>libssh2-1</tt> in Debian/Ubuntu, <tt>libssh2</tt> in Arch Linux, <tt>libssh2</tt> in macOS (Homebrew)).</p>

doc/en/variables.html

@@ -308,6 +308,7 @@ <h2><a name="trailingdelim">8. Trailing path delimited or not</a></h2>
             <td class="hintcell">"C:\Users\UserName\Desktop"</td>
           </tr>
         </table>
+        <p>This variable can be useful when composing a name from several variables. For example, in Windows, <code>%Dt\%f0</code> (with a manually added directory separator) instead of <code>%/1%Dt%f0</code> will work correctly inside directories, but if the root of a drive is open in the inactive panel, Double Commander will return the incorrect path with two directory separators after the drive letter.</p>
         <p class="navback"><a href="#topofpage">(back to top)</a></p>
       </div>
 

doc/en/viewer.html

@@ -53,12 +53,13 @@ <h2><a name="intro">1. Introduction</a></h2>
         <p>Supported image formats: BMP, CUR, GIF, ICNS, ICO, JPEG, PNG, PNM (PBM, PGM and PPM), PSD, SVG/SVGZ, TIFF, XPM. In addition, if the required libraries are available:</p>
         <ul>
           <li><p>HEIF/HEIC and AVIF: <tt>libheif.dll</tt> (Windows) or <tt>libheif.so.1</tt> (Linux and other Unix-like systems).</p></li>
-          <li><p>WebP: <tt>libwebp.so.n</tt>, where "n" is 7, 6 or 5 (Linux and other Unix-like systems).</p></li>
           <li><p>SVG/SVGZ: <tt>librsvg-2-2.dll</tt>, <tt>libcairo-2.dll</tt> and <tt>libgobject-2.0-0.dll</tt> (Windows) or <tt>librsvg-2.so.2</tt>, <tt>libcairo.so.2</tt> and <tt>libgobject-2.0.so.0</tt> (Linux and other Unix-like systems). If these files are available, Double Commander will use the librsvg library instead of the built-in Image32 graphics library.</p></li>
+          <li><p>WebP: <tt>libwebp.so.N</tt>, where "N" is 7, 6 or 5 (Linux and other Unix-like systems).</p></li>
           <li><p>Double Commander supports the TurboJPEG library, it is a JPEG codec that uses SIMD instructions to accelerate the decoding and encoding of images: <tt>libturbojpeg.dll</tt> (Windows), <tt>libturbojpeg.so.0</tt> (Linux and other Unix-like systems) or <tt>libturbojpeg.dylib</tt> (macOS).</p></li>
         </ul>
-        <p>Note: In Windows, libraries must be located near the Double Commander executable file or in the PATH.</p>
+        <p>Note: In Windows, libraries must be located near the Double Commander executable file, in the <tt>plugins\dll</tt> subdirectory near the executable file or in the Windows system directory.</p>
         <p>Double Commander supports Windows Imaging Component (Windows Vista and newer): the Windows Imaging Component (WIC) provides an extensible framework for working with images. WIC includes several built-in codecs (BMP, DDS, GIF, ICO, JPEG, JPEG XR, PNG and TIFF), additionally available external codecs for free and proprietary RAW image formats, HEIF/HEIC, WebP. Double Commander will skip codecs for BMP, GIF, ICO, JPEG, PNG and TIFF, because these formats are already supported.</p>
+        <p>In Windows, Double Commander can use the built-in HEIC decoder (Windows 11 24H2 and newer).</p>
         <p>The built-in viewer supports saving to the following image formats: BMP, ICO, JPEG (we can choose the quality from 1 to 100; 80 by default, see <a href="configxml.html">&lt;JpegQuality&gt;</a>), PNG (Double Commander will use the same color depth as in the original image) and PNM (Double Commander will use binary formats, the color depth will be set automatically: 1, 8 or 24 bits per pixel).</p>
         <p>Note: When modifying an image, we must save all changes with the <span class="italic">Save</span> or <span class="italic">Save As</span> commands: Double Commander does not check the status of the file (changed or not) when closing the viewer window or when switching to another file.</p>
         <p>We can assign or change hotkeys for commands available in the viewer in the <a href="configuration.html#ConfigHotKeys">Keys&nbsp;&gt; Hot Keys</a> settings section (switch to the <span class="italic">Viewer</span> category). Hotkeys can be set separately for text mode and image viewing mode.</p>