Skip to content

Commit

Permalink
See the 'small-upd' branch
Browse files Browse the repository at this point in the history
  • Loading branch information
@Skif-off
Skif-off committed Apr 8, 2024
1 parent 05b8a85 commit 2d7e527
Show file tree
Hide file tree
Showing 115 changed files with 969 additions and 675 deletions.
2 changes: 1 addition & 1 deletion doc/en/cm_options.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ <h1>Parameters of internal command <a href="cmds.html#cm_Options">cm_Options</a>
<td class="hintcell">Colors</td>
</tr>
<tr>
<td class="varcell"><div class="firstcolumnaleft">TfrmOptionsColors<span class="versionref"><sup>(Beta version)</sup></span></div></td>
<td class="varcell"><div class="firstcolumnaleft">TfrmOptionsColors</div></td>
<td class="hintcell">Colors (Windows 10 1809 and newer)</td>
</tr>
<tr>
Expand Down
136 changes: 116 additions & 20 deletions doc/en/cmds.html
View file

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions doc/en/commandline.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,8 @@ <h2><a name="presenta">1. Presentation</a></h2>
<br>
<p>An alternative form is also possible like this one:</p>
<p><code>doublecmd.exe [-C] [-T] [-P L|R] [-L path1\subpath1] [-R path2\subpath2]</code></p>
<br>
<p>Note: macOS command line has a some specificity, use the <code>open</code> command with the full application name ("Double Commander" with <code>-a</code>) and <code>--args</code> to pass parameters. For the second and subsequent instances, add <code>-n</code>.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>

Expand Down
132 changes: 90 additions & 42 deletions doc/en/configuration.html
View file

Large diffs are not rendered by default.

156 changes: 38 additions & 118 deletions doc/en/configxml.html
View file

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion doc/en/copymove.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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 access to the file (for example, tmpfs), the program will report the verification failure. Keep in mind, this function significantly reduces the speed of the operation. Not available in macOS<sup>(<a title="Note about macOS support" href="https://github.com/doublecmd/doublecmd/wiki/Supported-platforms#macos" target="_blank">*</a>)</sup>.</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 access to the file (for example, tmpfs), 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">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.</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>
Expand Down
51 changes: 13 additions & 38 deletions doc/en/faq.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,6 @@ <h2>Content</h2>
<dt>1.3. <a href="#linux">Is it a Total Commander for Linux?</a></dt>
<dt>1.4. <a href="#wincmd">What is the difference between this program and my favorite file manager (Total Commander)?</a></dt>
<dt>1.5. <a href="#link">How can I contact the developers of Double Commander?</a></dt>
<dt>1.6. <a href="#pupd">How to update the portable version without losing settings?</a></dt>
</dl>
</dd>
<dt><a name="tux">2. Issues related to GNU/Linux</a></dt>
Expand Down Expand Up @@ -77,19 +76,17 @@ <h2>Content</h2>
<dt>5.3. <a href="#f3_jpg">Viewer does not work with a few images, but works with most.</a></dt>
<dt>5.4. <a href="#f3_hscroll">On some text files lines go beyond the window's edge.</a></dt>
<dt>5.5. <a href="#f4_colmode">Can you add column editing feature (like in Notepad++, UltraEdit etc)?</a></dt>
<dt>5.6. <a href="#f3_svg">Is it possible to add SVG support in the viewer?</a></dt>
<dt>5.7. <a href="#f34_regutf8">How can I use regular expressions to search in UTF-8?</a></dt>
<dt>5.8. <a href="#f4_syntax">How to change the syntax highlighting scheme in the internal editor or add new ones?</a></dt>
<dt>5.6. <a href="#f34_regutf8">How can I use regular expressions to search in UTF-8?</a></dt>
<dt>5.7. <a href="#f4_syntax">How to change the syntax highlighting scheme in the internal editor or add new ones?</a></dt>
</dl>
</dd>
<dt><a name="fv">6. Issues related to the file panels</a></dt>
<dd>
<dl>
<dt>6.1. <a href="#fv_datetime">I didn't find a suitable date format for file panels in the list! How to add my own?</a></dt>
<dt>6.2. <a href="#fv_svg">Is it possible to add SVG thumbnails support in thumbnails view?</a></dt>
<dt>6.3. <a href="#fn_ext">I want to see the filenames in the "Name" column with extensions, can I do it?</a></dt>
<dt>6.4. <a href="#folder_sort">Is it possible to sort folders by clicking on column header ("Date", "Size" and so on)?</a></dt>
<dt>6.5. <a href="#slinkt">How to see the target objects of symbolic links?</a></dt>
<dt>6.2. <a href="#fn_ext">I want to see the filenames in the "Name" column with extensions, can I do it?</a></dt>
<dt>6.3. <a href="#folder_sort">Is it possible to sort folders by clicking on column header ("Date", "Size" and so on)?</a></dt>
<dt>6.4. <a href="#slinkt">How to see the target objects of symbolic links?</a></dt>
</dl>
</dd>
<dt><a name="plugins">7. Plugins</a></dt>
Expand All @@ -115,7 +112,7 @@ <h2>1. Common questions</h2>
<br>

<p class="bold"><a name="linux">Q: Is it a Total Commander for Linux?</a></p>
<p><span class="bold">A:</span> No, this is another program from other developers. It now supports Windows, GNU/Linux operating systems with toolkits GTK and Qt (depends on Lazarus, so at the moment, GTK2 and Qt5) and macOS<sup>(<a title="Note about macOS support" href="https://github.com/doublecmd/doublecmd/wiki/Supported-platforms#macos" target="_blank">*</a>)</sup>, also Double Commander is available in the FreeBSD Ports collection.</p>
<p><span class="bold">A:</span> No, this is another program from other developers. It now supports Windows, GNU/Linux operating systems with toolkits GTK and Qt (depends on Lazarus, so at the moment, GTK2 and Qt5) and macOS, also Double Commander is available in the FreeBSD Ports collection.</p>
<br>

<p class="bold"><a name="wincmd">Q: What is the difference between this program and my favorite file manager (Total Commander)?</a></p>
Expand All @@ -127,22 +124,13 @@ <h2>1. Common questions</h2>
<p><span class="bold">A:</span> The project's <a href="https://doublecmd.h1n.ru/" target="_blank">official forum</a> or <a href="https://github.com/doublecmd/doublecmd" target="_blank">GitHub</a>.<br>
Make sure you are using the latest version of the program and it's a good idea to check the development (alpha) version before reporting a bug or requesting a new feature.
Also see <a title="Creating a new issue" href="https://github.com/doublecmd/doublecmd/issues/117" target="_blank">#117</a>.</p>
<br>

<p class="bold"><a name="pupd">Q: How to update the portable version without losing settings?</a></p>
<p><span class="bold">A:</span> Upgrading is done by simply unpacking and replacing files, but you should pay attention to the following files:</p>
<ul>
<li><tt>multiarc.ini</tt>&nbsp;&ndash; see <a href="multiarc.html">external archivers</a>;</li>
<li><tt>pixmaps.txt</tt>&nbsp;&ndash; see <a href="configuration.html#ConfigIcons">Configuration&nbsp;&gt; Options...&nbsp;&gt; Icons&nbsp;&gt; Only standard icons</a>.</li>
</ul>
<p>If you did not change these settings, then just agree with the replacement of files. Otherwise, compare with yours and copy the changes.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>

<div>
<h2>2. Issues related to GNU/Linux</h2>
<p class="bold"><a name="version">Q: Which version do I download?</a></p>
<p><span class="bold">A:</span> If you have KDE or LXQt&nbsp;&ndash; download a Qt-build; in other cases (Cinnamon, GNOME, LXDE, MATE or Xfce) a build for GTK toolkit. But this is not strict rule.</p>
<p><span class="bold">A:</span> If you have KDE, LXQt or Fly&nbsp;&ndash; download a Qt-build; in other cases (Cinnamon, GNOME, LXDE, MATE or Xfce) a build for GTK toolkit. But this is not strict rule.</p>
<br>

<p class="bold"><a name="repo">Q: Where is the project repository?</a></p>
Expand Down Expand Up @@ -340,35 +328,26 @@ <h2>5. Issues related to the built-in viewer (<kbd>F3</kbd>) and editor (<kbd>F4
<br>

<p class="bold"><a name="f3_hscroll">Q: On some text files lines go beyond the window's edge.</a></p>
<p><span class="bold">A:</span> Use "Show as Wrap text" option in the viewer (in the "View" menu). Internal editor does not support wrap lines.</p>
<p><span class="bold">A:</span> Enable "Wrap text" option in the viewer (in the "View" menu). Internal editor does not support wrap lines.</p>
<br>

<p class="bold"><a name="f4_colmode">Q: Can you add column editing feature (like in Notepad++, UltraEdit etc)?</a></p>
<p><span class="bold">A:</span> Internal editor supports column and line selection modes and multi-carets, see keyboard shortcuts <a href="shortcuts.html#editor">here</a>.</p>
<br>

<p class="bold"><a name="f3_svg">Q: Is it possible to add SVG support in the viewer?</a></p>
<p><span class="bold">A:</span> Supported via librsvg:</p>
<ul>
<li><p>Linux: install package <tt>librsvg</tt>.</p></li>
<li><p>Windows: needs <tt>libcairo-2.dll</tt>, <tt>librsvg-2-2.dll</tt> and <tt>libgobject-2.0-0.dll</tt> (+ all dependencies), for example, you can take DLLs from GIMP. You should copy this DLLs to Double Commander folder or in PATH.</p></li>
</ul>
<br>

<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>macOS<sup>(<a title="Note about macOS support" href="https://github.com/doublecmd/doublecmd/wiki/Supported-platforms#macos" target="_blank">*</a>)</sup>: needs <tt>libpcre2-8.dylib</tt>.</p></li>
<li><p>macOS: needs <tt>libpcre2-8.dylib</tt>.</p></li>
</ul>
<br>

<p class="bold"><a name="f4_syntax">Q: How to change the syntax highlighting scheme in the internal editor or add new ones?</a></p>
<p><span class="bold">A:</span> DC uses two components:</p>
<p>1. <i>SynEdit</i> with built-in syntax highlighters. If you want to change any highlighter, you should change the DC or Lazarus source code.
But you can easily change the colors used and the file extension lists: go to "Configuration" in the main menu&nbsp;&gt; Options...&nbsp;&gt; Tools&nbsp;&gt; Editor&nbsp;&gt; Highlighters. Do not forget to save customizations for each file type.<br>
All settings are saved in the <tt>highlighters.xml</tt> file.</p>
But you can easily change the colors used and the file extension lists: go to "Configuration" in the main menu&nbsp;&gt; Options...&nbsp;&gt; Tools&nbsp;&gt; Editor&nbsp;&gt; Highlighters. Do not forget to save customizations for each file type.</p>
<p>2. <i>SynUniHighlighter</i> for custom syntax highlighting schemes (.hgl) and you can try to find or create this files yourself (see below).</p>
<p>This files are usual XML-based files, you can open them in a text editor and read/change. In the beginning of this files is the <code>&lt;General&gt;</code> tag (inside <code>&lt;Info&gt;</code>):</p>
<p>1) Old format: <code>&lt;General&gt;</code> has tags<br>
Expand All @@ -381,7 +360,7 @@ <h2>5. Issues related to the built-in viewer (<kbd>F3</kbd>) and editor (<kbd>F4
<p><span class="uline"><i>How to create or edit:</i></span></p>
<p>Use UniHighlighter Editor or HglEditor (<a href="https://sourceforge.net/projects/doublecmd/files/Double%20Commander%20Addons/" target="_blank">download</a>). Both programs were written for Windows, but you can use Wine. HglEditor will save HGL-file in the new format.<br>
Two packs of various highlighters are also available.<br>
In the <a href="configuration.html#ConfigToolsEditorHL">Tools&nbsp;&gt; Editor&nbsp;&gt; Highlighters</a> section, you can change the text and background colors and font style.<span class="versionref"><sup>(Beta version)</sup></span></p>
In the <a href="configuration.html#ConfigToolsEditorHL">Tools&nbsp;&gt; Editor&nbsp;&gt; Highlighters</a> section, you can change the text and background colors and font style.</p>
<p><span class="uline"><i>How to add:</i></span></p>
<p>1) Portable version<br>
Copy (or move) your HGL-file(s) to the "highlighters" folder near <tt>doublecmd.exe</tt> and restart DC.</p>
Expand Down Expand Up @@ -412,10 +391,6 @@ <h2>6. Issues related to the file panels</h2>
<p><span class="bold">A:</span> Date and time format is easy configurable: go to Configurations&nbsp;&gt; Options &nbsp;&gt; Files views&nbsp;&gt; Formatting&nbsp;&gt; Date and time format and use <a href="configuration.html#dt_format">this table</a>.</p>
<br>

<p class="bold"><a name="fv_svg">Q: Is it possible to add SVG thumbnails support in thumbnails view?</a></p>
<p><span class="bold">A:</span> It's already supported, see <a href="faq.html#f3_svg">Is it possible to add SVG support in the viewer?</a></p>
<br>

<p class="bold"><a name="fn_ext">Q: I want to see the filenames in the "Name" column with extensions, can I do it?</a></p>
<p><span class="bold">A:</span> Yes, it's possible. Go to "Configuration" in the main menu&nbsp;&gt; Options...&nbsp;&gt; Files views&nbsp;&gt; Columns&nbsp;&gt; Custom columns,
now create a new column set or change existing default set: by default, DC uses <code>GETFILENAMENOEXT</code> field for name, use <code>GETFILENAME</code> instead.</p>
Expand Down Expand Up @@ -448,11 +423,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 the OpenSSL libraries are needed: put <tt>libeay32.dll</tt> and <tt>ssleay32.dll</tt> near <tt>doublecmd.exe</tt> or in the PATH.</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>
<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> OpenSSL libraries required: put <tt>libeay32.dll</tt> and <tt>ssleay32.dll</tt> near <tt>doublecmd.exe</tt> or in the PATH.</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 class="navback"><a href="#topofpage">(back to top)</a></p>
<br>
</div>
Expand Down
Loading

0 comments on commit 2d7e527

Please sign in to comment.