Skip to content

Commit

Permalink
ADD: configxml.html: 'Count' attribute in 'DirHistory'. (doublecmd#65)
Browse files Browse the repository at this point in the history
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.
  • Loading branch information
Skif-off authored Sep 22, 2024
1 parent f8e340c commit 2b6ae92
Show file tree
Hide file tree
Showing 26 changed files with 441 additions and 209 deletions.
10 changes: 6 additions & 4 deletions doc/en/configuration.html
Original file line number Diff line number Diff line change
Expand Up @@ -374,7 +374,7 @@ <h2><a name="settings">2. Configuration</a></h2>
<p><span class="bold"><a name="ConfigKeys">2.6. Keys</a></span></p>
<p class="figure"><img class="largeimage" title="Keys" alt="Keys" src="images/imgDC/pic60.png" width="578" height="168"></p>
<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>
<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>
<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>
<br>

<p><span class="bold"><a name="ConfigHotKeys">2.6.1. Keys&nbsp;&gt; Hot Keys</a></span></p>
Expand Down Expand Up @@ -419,7 +419,7 @@ <h2><a name="settings">2. Configuration</a></h2>
<p>A window for adding hotkeys:</p>
<p class="figure"><img class="largeimage" title="Add new hotkey" alt="Add new hotkey" src="images/imgDC/pic33.png" width="418" height="440"></p>
<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>
<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>
<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>
<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>
<p>The following buttons are located on the right side of the window:</p>
<ul>
Expand Down Expand Up @@ -633,7 +633,7 @@ <h2><a name="settings">2. Configuration</a></h2>
<li><p><tt>GETFILECHANGETIME</tt>&nbsp;&ndash; file or directory status change date.</p></li>
<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>
<li><p><tt>GETFILEPATH</tt>&nbsp;&ndash; path to the current item. Uses: usually, for search results.</p></li>
<li><p><tt>GETFILEGROUP</tt>&nbsp;&ndash; displays the group of the file.</p></li>
<li><p><tt>GETFILEGROUP</tt>&nbsp;&ndash; displays the group of the file owner.</p></li>
<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>
Expand Down Expand Up @@ -865,11 +865,12 @@ <h2><a name="settings">2. Configuration</a></h2>
<li><p><span class="italic">Main window state</span>&nbsp;&ndash; Size and position of the application window.</p></li>
<li><p><span class="italic">Folder tabs</span>&nbsp;&ndash; List of tabs that are open in the left and right panels.</p></li>
<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>
<li><p><span class="italic">Directory history</span>&nbsp;&ndash; List of all visited directories.</p></li>
<li><p><span class="italic">Directory history</span>&nbsp;&ndash; List of all visited directories (see note below).</p></li>
<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>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>
Expand Down Expand Up @@ -929,6 +930,7 @@ <h2><a name="settings">2. Configuration</a></h2>
<p>Note: This function may not work inside mounted network directories.</p>
<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>
<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>
<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>
<p>Also you can disable auto-refresh:</p>
<ul>
<li><p>When Double Commander window is in the background or minimized.</p></li>
Expand Down
23 changes: 17 additions & 6 deletions doc/en/configxml.html
Original file line number Diff line number Diff line change
Expand Up @@ -240,9 +240,9 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;RenameConfirmMouse&gt;<br><small>from &lt;FilesViews&gt;</small></div></td>
<td class="hintcell">
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>
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>
<code>False</code> by default.<br>
In both cases, we can still use the button to the right of the input field to confirm the operation.
In both cases, we can still use the button to the right of the edit field to confirm the operation.
</td>
</tr>

Expand Down Expand Up @@ -337,6 +337,19 @@ <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>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.
</td>
</tr>

<tr>
<td colspan="2"></td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;CustomIcons&gt;<br><small>from &lt;Icons&gt;</small></div></td>
<td class="hintcell">
Expand Down Expand Up @@ -473,10 +486,8 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
<tr>
<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, 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),
to disable this behavior, we can replace <code>True</code> with <code>False</code><br>
<code>&lt;FileMask Save="False"&gt;</code><br>
and DC will suggest the value of &lt;FileMask&gt; every time by default ("*" by default, i.e. all files).
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).
</td>
</tr>

Expand Down
4 changes: 2 additions & 2 deletions doc/en/copymove.html
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,9 @@ <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.</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. 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">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>
<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>
<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>
Expand Down
3 changes: 3 additions & 0 deletions doc/en/doublecmd.css
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,9 @@ span.uline { text-decoration: underline; }
table { font-size: inherit; border: 1px #b0b0b0 solid; border-collapse: collapse; width: 885px; margin-left: 5px; }
table.innercmddesc { border: 1px #c0c0c0 solid; border-collapse: collapse; width: 99%}

table.index { font-size: inherit; border: none; border-collapse: collapse; }
td.indexcell { vertical-align: top; }

tr.rowsubtitle { background-color: #ffffc0; color: #000000; }
tr.rowcategorytitle { background-color: #ffd0d0; color: #000000; }
tr.rowinnerdesc { background-color: #ffffc0; color: #000000; }
Expand Down
2 changes: 1 addition & 1 deletion doc/en/faq.html
Original file line number Diff line number Diff line change
Expand Up @@ -435,7 +435,7 @@ <h2>6. Issues related to the file panels</h2>
<br>

<p class="bold"><a name="parent">Q: How to hide the ".." item for the parent directory in the file list?</a></p>
<p><span class="bold">A:</span> Use the <a href="configuration.html#ConfigIgnore">Ignore list</a> in the program settings.</p>
<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>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>

Expand Down
10 changes: 9 additions & 1 deletion doc/en/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,7 @@ <h2>Content</h2>
<dt>&#8226; <a href="#draganddrop">Drag &amp; drop</a></dt>
<dt>&#8226; <a href="#cm_ContextMenu">Context menu</a></dt>
<dt>&#8226; <a href="#cm_QuickSearch">Quick search/filter</a></dt>
<dt>&#8226; <a href="#rename_files">Renaming files</a></dt>
</dl>
</dd>
<dt>2.9. <a href="#iface_status">Status bar</a></dt>
Expand Down Expand Up @@ -341,7 +342,7 @@ <h2><a name="mnu_fav">2.1.6. "Favorites"</a></h2>
<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>
<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>
<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>
<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>
<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>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>

Expand Down Expand Up @@ -572,6 +573,13 @@ <h2><a name="iface_files">2.8. File Panels</a></h2>
<p>Double Commander supports pinyin (the <tt>pinyin.tbl</tt> file in the program directory will be used).</p>
<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>
<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>
<br>

<p><a name="rename_files"><span class="bold">Renaming files</span></a></p>
<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>
<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>
<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>
<p>For group renaming files, the <a href="multirename.html">appropriate tool</a> is available.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>

Expand Down
Binary file modified doc/en/images/imgDC/syncdirs.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/syncdirscomp.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 2b6ae92

Please sign in to comment.