Skip to content

Commit 2b6ae92

Browse files
authored
ADD: configxml.html: 'Count' attribute in 'DirHistory'. (#65)
ADD: help.html: Subsection 'Renaming files' ('in place' renaming). ADD: lua.html: Anchors and 'Index' subsection. ADD: syncdirs.html: 'Unknown' filter. UPD: Screenshots. UPD: configuration.html: 'Auto refresh' section: Note about result. UPD: copymove.html: In Linux, 'Reserve space' does not work on FAT32. UPD: faq.html: 6.5. UPD: shortcuts.html: Arrows, Enter and other small fixes/chenges. CHG/FIX: configxml.html, syncdirs.html: Using file masks in the directory synchronization tool. Other small fixes/changes.
1 parent f8e340c commit 2b6ae92

26 files changed

+441
-209
lines changed

doc/en/configuration.html

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -374,7 +374,7 @@ <h2><a name="settings">2. Configuration</a></h2>
374374
<p><span class="bold"><a name="ConfigKeys">2.6. Keys</a></span></p>
375375
<p class="figure"><img class="largeimage" title="Keys" alt="Keys" src="images/imgDC/pic60.png" width="578" height="168"></p>
376376
<p>Here you can set the action on pressing some keys in the active file panel: <span class="italic">Letters</span>, <span class="italic">Alt+Letters</span>, <span class="italic">Ctrl+Alt+Letters</span>. You can choose one of the following actions: do nothing, set focus to command line and enter command, run <p><a href="help.html#cm_QuickSearch">quick search or quick filter</a>.</p>
377-
<p><span class="italic">Left, Right arrows change directory (Lynx-like movement)</span>&nbsp;&ndash; <kbd>right arrow</kbd> opens directory or runs a program under cursor, <kbd>left arrow</kbd> opens parent directory.</p>
377+
<p><span class="italic">Left, Right arrows change directory (Lynx-like movement)</span>&nbsp;&ndash; <kbd>right arrow</kbd> opens directory or runs a program under cursor, <kbd>left arrow</kbd> opens parent directory (only in the <a href="help.html#iface_files">full mode</a>).</p>
378378
<br>
379379

380380
<p><span class="bold"><a name="ConfigHotKeys">2.6.1. Keys&nbsp;&gt; Hot Keys</a></span></p>
@@ -419,7 +419,7 @@ <h2><a name="settings">2. Configuration</a></h2>
419419
<p>A window for adding hotkeys:</p>
420420
<p class="figure"><img class="largeimage" title="Add new hotkey" alt="Add new hotkey" src="images/imgDC/pic33.png" width="418" height="440"></p>
421421
<p><span class="italic">Shortcuts</span>&nbsp;&ndash; new shortcut displays here. Click in the box and press combination on keyboard to enter new hot key. If the new combination is already being used for another command, Double Commander will show a warning.</p>
422-
<p><span class="italic">Parameters (each in a separate line):</span>&nbsp;&ndash; allows to set some parameters for the command. Most parameters must be added as <span class="italic">parameter=value</span> (unless otherwise stated) and each in a separate line, without quotes and other ways of escaping special characters and spaces.</p>
422+
<p><span class="italic">Parameters (each in a separate line):</span>&nbsp;&ndash; allows to set some parameters for the command. Most parameters must be added as <span class="italic">parameter=value</span> (unless otherwise stated), each must be in a separate line, without quotes and other ways of escaping special characters and spaces.</p>
423423
<p><span class="italic">Only for these controls</span>&nbsp;&ndash; The hotkey will only work if the selected interface element(s) has focus: command line, files or quick search panel.</p>
424424
<p>The following buttons are located on the right side of the window:</p>
425425
<ul>
@@ -633,7 +633,7 @@ <h2><a name="settings">2. Configuration</a></h2>
633633
<li><p><tt>GETFILECHANGETIME</tt>&nbsp;&ndash; file or directory status change date.</p></li>
634634
<li><p><tt>GETFILEATTR</tt>&nbsp;&ndash; file or directory attributes. You can choose a string or numeric (octal) value. In Windows, an octal value can be used if Unix attributes are displayed in the file panel (for example, with the FTP plugin). For a detailed description of the string value, see <a href="#ConfigColorFiles">here</a>.</p></li>
635635
<li><p><tt>GETFILEPATH</tt>&nbsp;&ndash; path to the current item. Uses: usually, for search results.</p></li>
636-
<li><p><tt>GETFILEGROUP</tt>&nbsp;&ndash; displays the group of the file.</p></li>
636+
<li><p><tt>GETFILEGROUP</tt>&nbsp;&ndash; displays the group of the file owner.</p></li>
637637
<li><p><tt>GETFILEOWNER</tt>&nbsp;&ndash; displays the owner of the file.</p></li>
638638
<li><p><tt>GETFILELINKTO</tt>&nbsp;&ndash; displays the path and file, that is, what is linked with this symlink.</p></li>
639639
<li><p><tt>GETFILETYPE</tt>&nbsp;&ndash; file type (as in Windows Explorer or MIME-type).</p></li>
@@ -865,11 +865,12 @@ <h2><a name="settings">2. Configuration</a></h2>
865865
<li><p><span class="italic">Main window state</span>&nbsp;&ndash; Size and position of the application window.</p></li>
866866
<li><p><span class="italic">Folder tabs</span>&nbsp;&ndash; List of tabs that are open in the left and right panels.</p></li>
867867
<li><p><span class="italic">Search/Replace history</span>&nbsp;&ndash; <a href="findfiles.html">File search</a> history (except for file name masks, see below), history of masks in the <a href="multirename.html">Multi-Rename Tool</a> and history of searching and replacing text: search by file contents, viewer, built-in editor and built-in differ, search and replace in directory hotlist and toolbar settings. The state of the text search options (<span class="italic">Case sensitive</span>, <span class="italic">Regular expressions</span> and <span class="italic">Hexadecimal</span>) for each entry is also saved.</p></li>
868-
<li><p><span class="italic">Directory history</span>&nbsp;&ndash; List of all visited directories.</p></li>
868+
<li><p><span class="italic">Directory history</span>&nbsp;&ndash; List of all visited directories (see note below).</p></li>
869869
<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>
870870
<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>
871871
</ul>
872872
<p>The maximum number of entries in history is limited to 50.</p>
873+
<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>
873874
<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>
874875
<p>You can choose how the list of settings sections will look:</p>
875876
<ul>
@@ -929,6 +930,7 @@ <h2><a name="settings">2. Configuration</a></h2>
929930
<p>Note: This function may not work inside mounted network directories.</p>
930931
<p>If both options are disabled, Double Commander will not watch changes made by third-party applications, and after changes made in the program in the file system, it will reread the entire list of files.</p>
931932
<p>In virtual file systems (WFX plugins, GVfs), Double Commander rereads the entire list of files when you create, delete, or rename a file.</p>
933+
<p>Note: Keep in mind that the final result may depend on the value of the <span class="italic">Insert new files</span> and <span class="italic">Move updated files</span> parameters in the <a href="#ConfigView">Files views</a> settings section.</p>
932934
<p>Also you can disable auto-refresh:</p>
933935
<ul>
934936
<li><p>When Double Commander window is in the background or minimized.</p></li>

doc/en/configxml.html

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -240,9 +240,9 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
240240
<tr>
241241
<td class="cmdcell"><div class="firstcolumnaleft">&lt;RenameConfirmMouse&gt;<br><small>from &lt;FilesViews&gt;</small></div></td>
242242
<td class="hintcell">
243-
This option changes the mouse click action when renaming a file under the cursor: if <code>True</code>, the mouse click outside the name input field will confirm renaming the file (as in Windows Explorer), otherwise, the mouse click will work the same as the <kbd>Esc</kbd> key.<br>
243+
This option changes the mouse click action when renaming a file under the cursor: if <code>True</code>, the mouse click outside the name edit field will confirm renaming the file (as in Windows Explorer), otherwise, the mouse click will work the same as the <kbd>Esc</kbd> key.<br>
244244
<code>False</code> by default.<br>
245-
In both cases, we can still use the button to the right of the input field to confirm the operation.
245+
In both cases, we can still use the button to the right of the edit field to confirm the operation.
246246
</td>
247247
</tr>
248248

@@ -337,6 +337,19 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
337337
<td colspan="2"></td>
338338
</tr>
339339

340+
<tr>
341+
<td class="cmdcell"><div class="firstcolumnaleft">Attribute <i>Count</i><br><small>from &lt;History&gt;&lt;DirHistory&gt;</small></div></td>
342+
<td class="hintcell">
343+
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).
344+
When using the Tree View Menu, the attribute value will be ignored.<br>
345+
Default value is 30.
346+
</td>
347+
</tr>
348+
349+
<tr>
350+
<td colspan="2"></td>
351+
</tr>
352+
340353
<tr>
341354
<td class="cmdcell"><div class="firstcolumnaleft">&lt;CustomIcons&gt;<br><small>from &lt;Icons&gt;</small></div></td>
342355
<td class="hintcell">
@@ -473,10 +486,8 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
473486
<tr>
474487
<td class="cmdcell"><div class="firstcolumnaleft">Attribute <i>Save</i><br><small>from &lt;SyncDirs&gt;&lt;FileMask&gt;</small></div></td>
475488
<td class="hintcell">
476-
Synchronize directories: by default, the program saves the last used file mask as the default mask for the next run of the synchronization tool (if it is not a search template),
477-
to disable this behavior, we can replace <code>True</code> with <code>False</code><br>
478-
<code>&lt;FileMask Save="False"&gt;</code><br>
479-
and DC will suggest the value of &lt;FileMask&gt; every time by default ("*" by default, i.e. all files).
489+
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),
490+
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).
480491
</td>
481492
</tr>
482493

doc/en/copymove.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,9 +57,9 @@ <h2><a name="confirmation">1. Copy/move dialog window</a></h2>
5757
</ul>
5858
<p>The list of the following parameters will vary depending on the type of file operation and operating system family.</p>
5959
<ul>
60-
<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>
60+
<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>
6161
<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>
62-
<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>
62+
<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>
6363
<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>
6464
<li><p><span class="italic">Correct links</span>&nbsp;&ndash; If enabled, Double Commander will check the links and, if necessary, correct their target path based on the target directory. If a relative path is specified, then the corrected path will also be written as relative.</p></li>
6565
<li><p><span class="italic">Copy attributes</span>&nbsp;&ndash; If enabled, the attributes of the source file will be copied, otherwise, the default values for the current user will be used, usually 664 (files) or 775 (folders). Also see description of <a href="configxml.html">&lt;CopyXattributes&gt;</a>. For Windows: see description of <a href="configxml.html">&lt;CopyAttributes&gt;</a>.</p></li>

doc/en/doublecmd.css

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,9 @@ span.uline { text-decoration: underline; }
6565
table { font-size: inherit; border: 1px #b0b0b0 solid; border-collapse: collapse; width: 885px; margin-left: 5px; }
6666
table.innercmddesc { border: 1px #c0c0c0 solid; border-collapse: collapse; width: 99%}
6767

68+
table.index { font-size: inherit; border: none; border-collapse: collapse; }
69+
td.indexcell { vertical-align: top; }
70+
6871
tr.rowsubtitle { background-color: #ffffc0; color: #000000; }
6972
tr.rowcategorytitle { background-color: #ffd0d0; color: #000000; }
7073
tr.rowinnerdesc { background-color: #ffffc0; color: #000000; }

doc/en/faq.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -435,7 +435,7 @@ <h2>6. Issues related to the file panels</h2>
435435
<br>
436436

437437
<p class="bold"><a name="parent">Q: How to hide the ".." item for the parent directory in the file list?</a></p>
438-
<p><span class="bold">A:</span> Use the <a href="configuration.html#ConfigIgnore">Ignore list</a> in the program settings.</p>
438+
<p><span class="bold">A:</span> Use the <a href="configuration.html#ConfigIgnore">Ignore list</a> in the program settings (a less global way is also possible, for example, <code>///Search result/..</code> will hide this item only in search results).</p>
439439
<p class="navback"><a href="#topofpage">(back to top)</a></p>
440440
</div>
441441

doc/en/help.html

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,7 @@ <h2>Content</h2>
6060
<dt>&#8226; <a href="#draganddrop">Drag &amp; drop</a></dt>
6161
<dt>&#8226; <a href="#cm_ContextMenu">Context menu</a></dt>
6262
<dt>&#8226; <a href="#cm_QuickSearch">Quick search/filter</a></dt>
63+
<dt>&#8226; <a href="#rename_files">Renaming files</a></dt>
6364
</dl>
6465
</dd>
6566
<dt>2.9. <a href="#iface_status">Status bar</a></dt>
@@ -341,7 +342,7 @@ <h2><a name="mnu_fav">2.1.6. "Favorites"</a></h2>
341342
<p><span class="bold">Resave on the last Favorite Tabs loaded</span> (internal command <tt>cm_ResaveFavoriteTabs</tt>)&nbsp;&ndash; will resave the current tabs configuration over the last loaded Favorites Tabs entry.</p>
342343
<p><span class="bold">Reload the last Favorite Tabs loaded</span> (internal command <tt>cm_ReloadFavoriteTabs</tt>)&nbsp;&ndash; reload again the last Favorite Tabs setup that was loaded, i.e. this command is used to restore a saved set "as is".</p>
343344
<p>The next item <span class="bold">Configuration of Favorite Tabs</span> is for quick jump to the <a href="configuration.html#ConfigFavoriteTabs">Favorite Tabs</a> settings section.</p>
344-
<p>To unload the last loaded Favorite Tabs, use the <a href="cmds.html#cm_LoadFavoriteTabs">cm_LoadFavoriteTabs</a> command with <code>setup=""</code> (add a button to the toolbar or a hotkey). The currently open tabs will not be affected, this command will just unload the name of the used set of Favorite Tabs from memory and Double Commander will continue to work as usual.</p>
345+
<p>To unload the last loaded Favorite Tabs, use the <a href="cmds.html#cm_LoadFavoriteTabs">cm_LoadFavoriteTabs</a> command with <code>setup=</code> (add a button to the toolbar or a hotkey). The currently open tabs will not be affected, this command will just unload the name of the used set of Favorite Tabs from memory and Double Commander will continue to work as usual.</p>
345346
<p class="navback"><a href="#topofpage">(back to top)</a></p>
346347
</div>
347348

@@ -572,6 +573,13 @@ <h2><a name="iface_files">2.8. File Panels</a></h2>
572573
<p>Double Commander supports pinyin (the <tt>pinyin.tbl</tt> file in the program directory will be used).</p>
573574
<p>You can set the way of call the quick search/filter panel in the <a href="configuration.html#ConfigKeys">Keys</a> settings section, or use the <a href="cmds.html#cm_QuickSearch">cm_QuickSearch</a> and <a href="cmds.html#cm_QuickFilter">cm_QuickFilter</a> commands.</p>
574575
<p>All parameters that have been changed in the quick search panel will be kept for the next quick search/filter call (before closing the program), you can change it and the default values in the <a href="configuration.html#ConfigQuick">Quick search/filter</a> settings section.</p>
576+
<br>
577+
578+
<p><a name="rename_files"><span class="bold">Renaming files</span></a></p>
579+
<p>Double Commander allows to rename files directly in the file panel. There are several ways to call this operation: the internal command <tt>cm_RenameOnly</tt> (<kbd>F2</kbd> or <kbd>Shift+F6</kbd> by default), the <a href="configuration.html#ConfigViewEx">left mouse click</a> or the corresponding item in the right mouse button menu.</p>
580+
<p>By default, Double Commander will select the file name completely, but you can <a href="configuration.html#ConfigOperations">enable</a> file name selecting without an extension. Also, repeated hotkey presses allow to select the file name in parts, the following characters are used as a separator: space, hyphen underscore and period. Folder names are always selected completely.</p>
581+
<p>To confirm the change in the name, use the <kbd>Enter</kbd> key or the rename confirmation button to the right of the edit field. To cancel unconfirmed changes (to exit editing mode), use the <kbd>Esc</kbd> key or the mouse click outside the edit field. You can use a mouse click outside the edit field to confirm the renaming (as in Windows Explorer), see the description of <a href="configxml.html">RenameConfirmMouse</a>.</p>
582+
<p>For group renaming files, the <a href="multirename.html">appropriate tool</a> is available.</p>
575583
<p class="navback"><a href="#topofpage">(back to top)</a></p>
576584
</div>
577585

doc/en/images/imgDC/syncdirs.png

126 Bytes
Loading

doc/en/images/imgDC/syncdirscomp.png

132 Bytes
Loading

0 commit comments

Comments
 (0)