diff --git a/doc/en/READ_ME.txt b/doc/en/READ_ME.txt
index efb7c55c..b730bdf0 100644
--- a/doc/en/READ_ME.txt
+++ b/doc/en/READ_ME.txt
@@ -1,4 +1,4 @@
-General instructions and convention about HTML help file of DC
+General instructions and conventions about HTML help file of DC
==============================================================
- When using a link to something external to Double Commander help, set the target to be a new window using target="_blank" like in this example:
@@ -6,6 +6,7 @@ General instructions and convention about HTML help file of DC
- To be more friendly with the user, to make us as the same level as the user, let's talk using "WE" instead of "YOU".
The user will feel that we're working together.
+(By tradition, for all sections except "2.1. Basic Help", "2.2. Configuration" and "2.3. Keyboard layout".)
- DO NOT USE POINT NUMBER IN HTML FILENAME.
Just name the file based on what it describes and assume we will not rename it.
@@ -17,8 +18,10 @@ Keep the section numbers for the text inside page and NEVER INSIDE A LINK.
- If you want to add a link to the FAQ, do not use the question number, because it may be changed in the future.
-- If you want to add a description of a feature that is currently only available in the alpha version (development version), then add a special label:
+- If you want to add a description of a feature that is currently only available in the alpha version (development version) or in the beta version (usually the first versions of the new major release), then add a special label:
(Alpha version)
+or
+ (Beta version)
Don't forget to delete after release.
diff --git a/doc/en/cmds.html b/doc/en/cmds.html
index d79bf521..99d446b5 100644
--- a/doc/en/cmds.html
+++ b/doc/en/cmds.html
@@ -1134,7 +1134,7 @@
|
- Load list of files/folders from the specified text file.
+ | Load list of files/folders from the specified text file (plain text file containing full file names, one per line).
diff --git a/doc/en/configuration.html b/doc/en/configuration.html
index fce9685e..90886731 100644
--- a/doc/en/configuration.html
+++ b/doc/en/configuration.html
@@ -304,9 +304,37 @@
In line Category attributes you can put file attributes, and DC will match any files which have matching attributes (not available if using a search template). File attributes are specified by the following templates:
Windows: [d or l]rahs[c or e]tp
- Linux: [b, c, d, f, l, r or s]rwxrwxrwx
+ Unix/Linux: [b, c, d, f, l or s]rwxrwxrwx
- See the description of this values here. If attribute should not be set, it must be replaced with the "-" symbol, unnecessary attributes should be hidden: symbol "*" means match any number of characters, symbol "?" means any one character. For example, ?r* (Windows) or ?r-* (Linux) will find all read-only files and folders.
+ i.e. the template must match the attribute text string in the file list. Description of values:
+
+ | Attributes in Windows |
+ | Attribute letter | What it stands for |
+ a | archive |
+ c | compressed (NTFS compression) |
+ d | directory |
+ e | encrypted (EFS encryption) |
+ h | hidden |
+ l | symlink |
+ p | sparse |
+ r | read only |
+ s | system |
+ t | temporary |
+
+
+
+ | Attributes in Unix/Linux (File Types) |
+ | File Types letters | What it stands for |
+ b | block |
+ c | character |
+ d | directory |
+ f | fifo |
+ l | symlink |
+ s | socket |
+
+
+ The second part of the Unix/Linux template displays permissions: read (r), write (w), execute (x). The values are grouped in groups of three in the following order: user (owner), user's group, all others.
+ If attribute should not be set, it must be replaced with the "-" symbol, unnecessary attributes should be hidden: symbol "*" means match any number of characters, symbol "?" means any one character. For example, ?r* (Windows) or ?r-* (Linux) will find all read-only files and folders.
You can use a color from the list or specify yours using the ">>" button.
Do not forget to click "Apply" button after customization.
Rules are applied strictly in reverse order: a rule higher in the list will overlap any rule below.
@@ -568,7 +596,7 @@
GETFILECREATIONTIME – file or directory creation date (does not work in Linux/BSD, POSIX limitation).
GETFILELASTACCESSTIME – file or directory last access date.
GETFILECHANGETIME – file or directory status change date.
- GETFILEATTR – 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).
+ GETFILEATTR – 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 here.
GETFILEPATH – path to the current item. Uses: usually, for search results.
GETFILEGROUP – displays the group of the file.
GETFILEOWNER – displays the owner of the file.
diff --git a/doc/en/configxml.html b/doc/en/configxml.html
index b2eb1681..7e883ba2 100644
--- a/doc/en/configxml.html
+++ b/doc/en/configxml.html
@@ -133,7 +133,7 @@
<gBorderFrameWidth> from <Colors> |
We may configure DC so it will draw a rectangle around the active entry as we we cycle through them in a panel.
- This <gBorderFrameWidth> setting allows us to configure the width of the lines used to draw a rectangle around the current active entry.
+ <gBorderFrameWidth> allows us to configure the width of the lines used to draw a rectangle around the current active entry.
To view that rectangle, we should go in Configuration > Options... > Colors > File panels and check the option Use frame cursor.
Example: <gBorderFrameWidth>1</gBorderFrameWidth>
|
diff --git a/doc/en/copymove.html b/doc/en/copymove.html
index a6dfd395..5c49b0c1 100644
--- a/doc/en/copymove.html
+++ b/doc/en/copymove.html
@@ -23,9 +23,10 @@ 2.4. Copying/moving files
Content
- 1. Copy/move dialog window
- - 2. Operation progress dialog
- - 3. Name collisions
- - 4. Additional settings
+ - 2. Using the clipboard
+ - 3. Operation progress dialog
+ - 4. Name collisions
+ - 5. Additional settings
@@ -56,8 +57,8 @@
The list of the following parameters will vary depending on the type of file operation and operating system family.
- Verify – 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. Not available in macOS(*).
- Check free space – Double Commander calculates the size of the selected files, so it can check if there is enough free space in the target directory.
+ Verify – 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(*).
+ Check free space – Before copying the file, Double Commander will check if there is enough free disk space in the target directory.
Reserve space – 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.
Follow links – 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.
Correct links – 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.
@@ -74,7 +75,15 @@
-
+
+ An additional way to copy or move files: we can use the Copy and Paste or Cut and Paste commands using the keyboard (Ctrl+C/Ctrl+V or Ctrl+X/Ctrl+V by default) or the corresponding items in the context menu.
+ In this case, the operation will start without a confirmation dialog. Double Commander will use the operation settings saved as the default settings, except for the Verify parameter (see description above).
+ If a file is copied and pasted into the active panel (in the same directory), duplicate files will be created with automatic renaming using the template from the file operations settings.
+ (back to top)
+
+
+
+
This dialog box shows the details of the progress of the operation: two progress bars (for the currently processed file and the general), progress in percentage (in the title), the total number of files and the number of processed files, the full name of the current file and the name in the target directory, size, speed and remaining time.
Buttons:
-
+
If a file with the name of the file being copied already exists in the target directory, Double Commander will provide several actions. The choice of the action to be used automatically (without user involvement) will not be saved for subsequent calls of the copy/move operation.
If there is a folder with the same name:
-
+
Additional options related to copy/move operations are presented on the File operations settings page.
(back to top)
diff --git a/doc/en/help.html b/doc/en/help.html
index 93431255..c9bd5d8f 100644
--- a/doc/en/help.html
+++ b/doc/en/help.html
@@ -202,9 +202,9 @@
If you use the Number of parts parameter, the size of the parts is always displayed in bytes.
If Require a CRC32 verification file is enabled, Double Commander will create a text file with the name of the source file and the extension ".crc", which contains the name of the source file, its size and checksum (the CRC32 algorithm is used). This is an easy way to check that the file is combined correctly and its parts have not been changed during the move. If this file is not available, Double Commander will show a warning, but this will not prevent you from getting the original file (however, in this case, the program will not be able to add the original file extension).
- On click OK button you get several files in the target directory. As a file extension, Double Commander uses sequential numbering of three or more (if it is needed) digits. To combine the file again, select all parts and click Combine files (cm_FileLinker). You also need to specify the order of split parts to combine.
+ On click OK button you get several files in the target directory. As a file extension, Double Commander uses sequential numbering of three or more (if it is needed) digits. To combine the file again, select the first part and click Combine files (cm_FileLinker). Or select all parts, you can also specify the order of split parts to combine.

- This function is very useful, if you have small drives and large files. It is possible to move the file parts. Keep in mind, this tool does not create any specific container or archive, but simply splits the file, so parts of the file can be safely glued together in other ways.
+ This function is very useful, if you have small drives and large files. It is possible to move the file parts. Keep in mind, this tool does not create any specific container or archive, but just splits or glues the file, so parts of the file can be obtained and safely glued together by other programs.
Item Calculate check sum... (internal command cm_CheckSumCalc) is used to calculate the checksum to check files integrity. The following checksums are available:
BLAKE2 (BLAKE2s, BLAKE2sp, BLAKE2b, BLAKE2bp), BLAKE3, CRC32, HAVAL, MD4, MD5, RIPEMD128, RIPEMD160, SFV, SHA,
@@ -321,11 +321,13 @@
- This menu contains a list of your saved Favorite Tabs and some commands for working with them.
+ This menu contains a list of your saved Favorite Tabs and some commands for working with them.
+ Favorite Tabs are saved sets of tabs that grouped according to criteria convenient for you (work, projects, hobbies, and so on), they allow to open all the necessary directories in tabs at once.
Save current tabs to a New Favorite Tabs (internal command cm_SaveFavoriteTabs) – will save in the set of Favorite Tabs the current opened tabs.
Resave on the last Favorite Tabs loaded (internal command cm_ResaveFavoriteTabs) – will resave the current tabs configuration over the last loaded Favorites Tabs entry.
Reload the last Favorite Tabs loaded (internal command cm_ReloadFavoriteTabs) – reload again the last Favorite Tabs setup that was loaded, i.e. this command is used to restore a saved set "as is".
- The next item Configuration of Favorite Tabs is for quick jump to the Favorite Tabs settings section.
+ The next item Configuration of Favorite Tabs is for quick jump to the Favorite Tabs settings section.
+ To unload the last loaded Favorite Tabs, use the cm_LoadFavoriteTabs command with setup="" (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.
(back to top)
@@ -388,7 +390,8 @@

- The Drives button bar helps you to change the drive quickly with one mouse click. Right click shows the context menu that contains operations such as mount/unmount, format, etc. (depends on the OS and drive type).
+ The Drives button bar helps you to change the drive quickly with one mouse click. Middle mouse (mouse wheel) click will open the disk in a new tab in the active panel.
+ Right click shows the context menu that contains operations such as mount/unmount, format, etc. (depends on the OS and drive type).
The last button is Open VFS list.
(back to top)
@@ -508,7 +511,6 @@
The Actions submenu – contains all the actions added to the file association for files with the file extension under the cursor. Also you can add a few additional actions.
The Open with submenu – contains a list of applications suitable for opening a file. To get the list in macOS(*), Double Commander uses the Launch Services API, in other systems the program follows the Desktop Menu specification.
The additional item Other... (not available in macOS(*)) will open the application selection window: you can choose an application from a list of all available applications or manually specify the command line to open the file. Also here you can save an additional system association for the file type, add a new one or change the default application (Double Commander will use the ~/.config/mimeapps.list file (see Association between MIME types and applications).
-
Services – system services (macOS(*) only).
Pack here... – calls the command to pack the selected file(s), the current directory will be used as the target directory.
Extract here... – calls the command to unpack the selected file, the current directory will be used as the target directory. This item will be added only if the file extension is specified in the settings of archiver plugins or external archivers.
diff --git a/doc/en/index.html b/doc/en/index.html
index dbf8c475..361f996e 100644
--- a/doc/en/index.html
+++ b/doc/en/index.html
@@ -57,6 +57,8 @@ Content
diff --git a/doc/en/multiarc.html b/doc/en/multiarc.html
index 6a7dd446..6d78c09a 100644
--- a/doc/en/multiarc.html
+++ b/doc/en/multiarc.html
@@ -50,6 +50,7 @@ Content
- 4.10. Configuring the "Extract without path" action
- 4.11. Configuring the "Create self extracting archive" action
- 4.12. Configuring the "ID's"
+ - 4.13. Menu of the "Other" button
- 5. Opening an archive file in an associated application
@@ -206,6 +207,7 @@
So all this is to invoke the external archiver with proper parameters.
This will be use when we use the internal command cm_OpenArchive.
+ A few words about the "Use archive name without extension as list" option: This option is intended for archives that can contain only one file and the filename is equal to the archive name without extension (Bzip2, XZ and others). Such compressed files usually do not contain the name of the original file.
(back to top)
@@ -490,12 +492,25 @@
(back to top)
+
+
+ This menu contains several additional functions:
+
+ Auto Configure – Double Commander will check all executable files of archivers: if a file is found, the program will automatically add its full path and enable the archiver, otherwise the archiver will be disabled.
+ Discard modifications – resets all unsaved settings changes.
+ Sort archivers – sorts the list of archivers alphabetically.
+ Disable all and Enable all – enable or disable all archivers.
+ Export... and Import... – allow us to export and import archiver settings (all archivers or part of them).
+
+ (back to top)
+
+
By default, files whose extensions are specified in the settings of WCX plugins and external archivers are opened as folders. To open them in an associated application, we can use the "Open" item in the context menu of the file, but in this case only system file associations will be used.
To use the Enter key or double-click, we have to change the settings.
- If a WCX plugin is used, then we must open the plugin settings, select the extension and enable the "Show as normal files (hide packer icon)" flag.
- If an external archiver is used to unpack files, then we must specify a non-existent file extension and fill in the fields for using ID. For example, CHM documents: "chm2" instead of "chm", signature "49 54 53 46" and offset 0.
+ If a WCX plugin is used, then we can open the plugin settings, select the extension and enable the "Show as normal files (hide packer icon)" flag.
+ If an external archiver is used to unpack files, then we can specify a non-existent file extension and fill in the fields for using ID. For example, CHM documents: "chm2" instead of "chm", signature "49 54 53 46" and offset 0.
Now, if necessary, we can use cm_OpenArchive and cm_ExtractFiles.
For such files, Double Commander will use the associated icon instead of the generic archive icon.
(back to top)
diff --git a/doc/en/multirename.html b/doc/en/multirename.html
index ed070a9d..43f8966a 100644
--- a/doc/en/multirename.html
+++ b/doc/en/multirename.html
@@ -351,7 +351,7 @@
When we have defined all the New File Names we want with the above mentioned methods, we're ready to launch the actual Rename action.

- If duplicate names are discovered, Double Commander will offer to abort the operation or use automatic renaming ("name (1).ext", "name (2).ext" etc).
+ If duplicate names are discovered, Double Commander will offer to abort the operation or use auto-renaming with adding a number: "name (1).ext", "name (2).ext", etc. Keep in mind, in the second case, the automatic addition of a number will not be shown in the "New File Name" column.
After the rename process, the application will rescan the files and refill again the above table.
The Old File Name column will normally show the result of our renaming process.
The New File Name one will be refreshed as well by re-applying the same placeholders/lists/modifiers still defined.
diff --git a/doc/en/shortcuts.html b/doc/en/shortcuts.html
index f4271574..38df622f 100644
--- a/doc/en/shortcuts.html
+++ b/doc/en/shortcuts.html
@@ -219,14 +219,6 @@
Ctrl+Alt+Enter |
Will invoke a program for the selected file from the system file associations |
-
- Ctrl+Alt+C |
- Copy paths of selected items to clipboard |
-
-
- Ctrl+Alt+X |
- Copy names of selected items to clipboard |
-
Ctrl+Tab |
Goto next tab in the active panel |
@@ -358,11 +350,11 @@
Ctrl+Shift+C |
- Copy item full names to clipboard |
+ Copy full names of selected items to clipboard |
Ctrl+Shift+X |
- Copy item names to clipboard |
+ Copy names of selected items to clipboard |
Ctrl+Shift+D |
diff --git a/doc/en/viewer.html b/doc/en/viewer.html
index cc8de127..d95fba67 100644
--- a/doc/en/viewer.html
+++ b/doc/en/viewer.html
@@ -56,7 +56,7 @@
Double Commander supports the TurboJPEG library, it is a JPEG codec that uses SIMD instructions to accelerate the decoding and encoding of images: libturbojpeg.dll (Windows), libturbojpeg.so.0 (Linux and other Unix-like systems) or libturbojpeg.dylib (macOS(*)).
Note: In Windows, libraries must be located near the Double Commander executable file or in the PATH.
- Double Commander supports Windows Imaging Component (Windows Vista and newer)(Beta version): 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.
+ Double Commander supports Windows Imaging Component (Windows Vista and newer)(Beta version): 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.
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 <JpegQuality>), 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).
Note: When modifying an image, we must save all changes with the Save or Save As 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.
We can assign or change hotkeys for commands available in the viewer in the Keys > Hot Keys settings section (switch to the Viewer category). Hotkeys can be set separately for text mode and image viewing mode.
diff --git a/doc/ru/READ_ME.txt b/doc/ru/READ_ME.txt
index 8df0b43a..501e4a72 100644
--- a/doc/ru/READ_ME.txt
+++ b/doc/ru/READ_ME.txt
@@ -6,6 +6,7 @@
- Чтобы быть более дружественным к пользователям, сделать нас на равных с пользователем, давайте использовать "МЫ" вместо "ВЫ".
Пользователь будет чувствовать, что мы работаем вместе.
+(По традиции, для всех разделов, кроме "2.1. Общий раздел", "2.2. Настройки" и "2.3. Клавиатурные сочетания".)
- НЕ ИСПОЛЬЗУЙТЕ НОМЕР РАЗДЕЛА В ИМЕНИ HTML-ФАЙЛА.
Просто назовите файл на основе того, что он описывает, предполагается, что мы не будем его переименовывать.
@@ -17,8 +18,10 @@
- Если вы хотите добавить ссылку на FAQ, не используйте номер вопроса, потому что он может быть изменён в будущем.
-- Если вы хотите добавить описание возможности, которая пока доступна только в альфа-версии (разрабатываемая версия), то добавьте специальный маркер:
+- Если вы хотите добавить описание возможности, которая пока доступна только в альфа-версии (разрабатываемая версия) или бета-версии (обычно первые версии нового крупного релиза), то добавьте специальный маркер:
(Альфа-версия)
+или
+ (Бета-версия)
Не забудьте удалить после релиза.
diff --git a/doc/ru/cmds.html b/doc/ru/cmds.html
index feee08db..684ec8ad 100644
--- a/doc/ru/cmds.html
+++ b/doc/ru/cmds.html
@@ -1133,7 +1133,7 @@
|
- Загрузить список файлов/папок из указанного текстового файла.
+ | Загрузить список файлов/папок из указанного текстового файла (обычный текстовый файл, содержащий полные имена файлов, по одному на строку).
| |